Put the config step before the command it is required by
`vibe3d add @medieval-kit` resolves the namespace through `models.json` and
stops dead without it:
Registry @medieval-kit is not configured in models.json
The registry README printed the two install commands FIRST and the
`models.json` entry underneath, introduced with the word "first". A reader
copies the top block, runs it, gets that error, and leaves. `vibe3d init`
seeds only `@scifi-kit`, so this is every new reader, not an edge case.
Config block first now, commands after it.
The cover card said `bunx vibe3d add @medieval-kit/wooden-chest`. Both address
forms are valid, but the bare namespace resolves through the registry's
`defaultItem` and installs the whole kit, which is what someone looking at a
card of the whole kit is being offered. A card has room for a command and not
for the `models.json` entry that command needs, so the shorter promise is the
honest one — and naming one arbitrary model implied a precision the card cannot
deliver.
Verified against the CLI rather than inferred from it:
add @medieval-kit/registry -> Registry @medieval-kit has no item named registry
add @medieval-kit -> Would install @medieval-kit · 46 files
add @medieval-kit/grindstone -> Would install @medieval-kit/grindstone · 10 files
This commit is contained in:
parent
b29762a540
commit
a038f622dd
3 changed files with 19 additions and 6 deletions
BIN
media/cover.png
BIN
media/cover.png
Binary file not shown.
|
Before Width: | Height: | Size: 166 KiB After Width: | Height: | Size: 164 KiB |
|
|
@ -8,12 +8,11 @@ own tree, not an opaque package boundary.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
```sh
|
## Install
|
||||||
bunx vibe3d add @medieval-kit/wooden-barrel
|
|
||||||
bunx vibe3d add @medieval-kit
|
|
||||||
```
|
|
||||||
|
|
||||||
Configure `models.json` first so the namespace resolves:
|
Point `models.json` at the registry. This step is not optional and it is not
|
||||||
|
last: `vibe3d add` resolves `@medieval-kit` through this map and stops with
|
||||||
|
`Registry @medieval-kit is not configured in models.json` if it is missing.
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
|
|
@ -26,6 +25,13 @@ Configure `models.json` first so the namespace resolves:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Then take one model, or the lot:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
bunx vibe3d add @medieval-kit/wooden-barrel
|
||||||
|
bunx vibe3d add @medieval-kit
|
||||||
|
```
|
||||||
|
|
||||||
## Models
|
## Models
|
||||||
|
|
||||||
37 models and one shared lib. Addresses are `@medieval-kit/<id>`. This table is
|
37 models and one shared lib. Addresses are `@medieval-kit/<id>`. This table is
|
||||||
|
|
|
||||||
|
|
@ -100,8 +100,15 @@ fillText(card, mono, 'Procedural lowpoly props for three.js. Install the source,
|
||||||
|
|
||||||
// The install line is the whole point of a source registry, so it is set as
|
// The install line is the whole point of a source registry, so it is set as
|
||||||
// something you could type rather than as one more sentence about it.
|
// something you could type rather than as one more sentence about it.
|
||||||
|
//
|
||||||
|
// The bare namespace and not `@medieval-kit/<some-model>`. Both are valid
|
||||||
|
// addresses, but this one resolves through the registry's `defaultItem` and
|
||||||
|
// installs the whole kit, which is what someone reading a card of the whole
|
||||||
|
// kit is being offered. It is also the shorter promise: a card has room for a
|
||||||
|
// command but not for the `models.json` entry the command needs first, and
|
||||||
|
// naming one arbitrary model implies a precision the card cannot deliver.
|
||||||
const prompt = fillText(card, mono, '$ ', { x: left, y: 118, size: 16, colour: AMBER })
|
const prompt = fillText(card, mono, '$ ', { x: left, y: 118, size: 16, colour: AMBER })
|
||||||
fillText(card, mono, `bunx vibe3d add @medieval-kit/${ids[0]}`, { x: prompt, y: 118, size: 16, colour: TEXT })
|
fillText(card, mono, 'bunx vibe3d add @medieval-kit', { x: prompt, y: 118, size: 16, colour: TEXT })
|
||||||
|
|
||||||
// Counted, never typed.
|
// Counted, never typed.
|
||||||
const count = `${ids.length} models`
|
const count = `${ids.length} models`
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue