Open surface
Every field in the Schema closure typed string, any, unknown, Record<…>, an index signature, or an array of those — the schema alone does not close what these fields can hold. "What closes it" is copied verbatim from the field's own doc comment on the Rust struct; not stated means the schema carries no written constraint at that field, whatever a caller enforces elsewhere.
32 open-ended fields (type string, any, unknown, Record<…>, an index signature, or an array of those) in the persisted-document closure. 0 carry no class word on their own field doc comment.
| field | type | class | what closes it |
|---|---|---|---|
ModelJson.title | string | intent | intent — content name printed on the artifact, verbatim text (a human types it; nothing evaluates it). Fails validate when empty or over EXPR_MAX_LENGTH characters (validate::model::push_title). |
ModelJson.description | string | intent | intent — what this definition is, verbatim text beside title (a human types it; nothing evaluates it): allowlisted HTML or plain text, read by the catalogue, the configurator and the quote, never by evaluation. On the definition, so no placement overrides it (SketchUp ComponentDefinition#description, AutoCAD block Comments). |
BehaviorNode.method | string | intent | intent — the catalog behaviors-context method this act invokes. |
ComponentNode.key | string | identity | identity — unique in the document's one key namespace, every lane; placeComponent.component names it. |
ComponentNode.label | string | intent | intent — editor-chrome display name, printed verbatim; absent falls back to key (RecordView.ts: "header = label (or key)"). |
LayerNode.key | string | identity | identity — unique in the document's one key namespace, every lane. |
LayerNode.label | string | intent | intent — editor-chrome display name, printed verbatim; absent falls back to key (RecordView.ts: "header = label (or key)"). |
MaterialNode.key | string | identity | identity — unique in the document's one key namespace, every lane. |
MaterialNode.label | string | intent | intent — editor-chrome display name, printed verbatim; absent falls back to key (RecordView.ts: "header = label (or key)"). |
ObjectNode.key | string | identity | identity — unique in the document's one key namespace, every lane, nested children included. |
ObjectNode.label | string | intent | intent — editor-chrome display text, printed verbatim; absent falls back to key. |
ParameterNode.key | string | identity | identity — unique in the document's one key namespace, every lane. |
ParameterNode.label | string | intent | intent — editor-chrome display text, printed verbatim; absent falls back to key. |
PatternNode.key | string | identity | identity — unique in the document's one key namespace, every lane. |
PatternNode.label | string | intent | intent — editor-chrome display name, printed verbatim; absent falls back to key (RecordView.ts: "header = label (or key)"). |
ViewNode.key | string | identity | identity — unique in the document's one key namespace, every lane. |
ViewNode.label | string | intent | intent — editor chrome, printed VERBATIM (not an expression); absent falls back to key (SceneMenu.ts: view.label ?? view.key). |
Argument.key | string | identity | identity — the arg's name; meant unique among its owning node's args, but nothing rejects a duplicate — node_args::node_arg_input/ set_node_arg read and write only the FIRST match, silently ignoring any later one. |
Argument.input | string | intent | intent — an expression string, authored and underivable; may be empty (an unselected file parameter authors nothing, so this arg's min/max/options do not apply). |
Argument.min | string | intent | intent — expression → number, inclusive lower bound. |
Argument.max | string | intent | intent — expression → number, inclusive upper bound. |
Argument.options | string | intent | intent — expression → non-empty array, the arg's whole domain. |
Argument.keyframes | string | intent | intent — expression → [{ time, value }], explicit key pairs on the document's one timeline (USD timeSamples, Blender keyframe_points). Legal ONLY on the value arg of a length/number/angle/integer PARAMETER — the parameter is the clip; any other arg fails loud. The host plays it (engine_animation_set); the engine never samples it. |
Argument.visible | string | intent | intent — expression → boolean: whether the configurator shows this parameter to the buyer (true = shown, absent = shown; a parameter hidden this way still evaluates and still feeds every expression that reads it). Legal ONLY on the value arg of a PARAMETER — any other arg fails loud. It may read any parameter of the scope, so a parameter can be conditional on another. |
PropertyNode.method | string | intent | intent — the registry-checked property method. |
Environment.skyColor | string | intent | intent — the sky-fill color; absent = the resolver's default. |
Environment.groundColor | string | intent | intent — the ground-fill color; absent = the resolver's default. |
StepNode.label | string | intent | intent — editor-chrome display text for this step, printed verbatim; absent falls back to the registry's friendly name for method. |
StepNode.method | string | intent | intent — the catalog method this step invokes. |
PatternStepNode.label | string | intent | intent — editor-chrome display text, printed verbatim; absent falls back to the registry's friendly name for method (StepView.ts's renderStep, shared by every step-shaped row, this one included). |
EnvironmentHdri.parameter | string | intent | intent — the KEY of a url-method parameter (checked at validate). |
EnvironmentHdri.url | string | intent | intent — a direct https:/data: address. |
📖 4 min read