@localess/schema 4.0.3-dev.20261004111503 → 4.0.3-dev.20261004121049

package/SKILL.md

@@ -111,16 +111,15 @@ in `schemas`. Both are normalized to string ids at runtime by `defineSchema`,
 matching the wire format exactly — but the *type* keeps the literal id, so
 `InferContent` resolves `OPTION` fields to the referenced enum's literal
 value union instead of plain `string`, and `SCHEMA`/`SCHEMAS` fields to the
-allowed schemas' content types (or every `NODE` schema in the config when the
-`schemas` list is omitted).
+allowed schemas' content types.
 
 Fallbacks when a reference can't be resolved against the config:
 
 - `OPTION`/`OPTIONS` whose `source` id is not in the config → `string` (or
   `string[]`), mirroring the CLI's `type generate` behavior.
 - `InferEnum` of an enum with no `values` → `string`.
-- Unrestricted `SCHEMA`/`SCHEMAS` (no `schemas` list) in a config with no
-  `NODE` schemas → `{ _id: string; _schema: string }` (or an array of it).
+- `SCHEMA`/`SCHEMAS` with an empty `schemas` list (a `validate()` error) →
+  `{ _id: string; _schema: string }` (or an array of it).
 - `InferContentData` of a config with no `ROOT` schema → `never`.
 
 ## Field kinds
@@ -142,7 +141,7 @@ everything else is optional.
 | `LINK` | — | `ContentLink` |
 | `REFERENCE` / `REFERENCES` | `path?` | `ContentReference` / `ContentReference[]` |
 | `ASSET` / `ASSETS` | `fileTypes?: AssetFileType[]`, `fileType?: AssetFileType` | `ContentAsset` / `ContentAsset[]` |
-| `SCHEMA` / `SCHEMAS` | `schemas?` (allowed ids or `defineSchema` results; unrestricted when absent) | allowed schemas' content type / array of it |
+| `SCHEMA` / `SCHEMAS` | `schemas` (required: allowed `NODE` ids or `defineSchema` results — the editor offers exactly these) | allowed schemas' content type / array of it |
 
 `AssetFileType` is `'ANY' | 'IMAGE' | 'VIDEO' | 'TEXT' | 'AUDIO' | 'APPLICATION'`.
 
@@ -175,7 +174,9 @@ schema in the config is checked, not just the first. Rules and their `code`:
 | `field/unresolved-source` | `OPTION`/`OPTIONS` `source` must be the id of a schema in the config. |
 | `field/source-not-enum` | ...and that schema must be an `ENUM`. |
 | `field/unresolved-schema-ref` | Every `SCHEMA`/`SCHEMAS` `schemas` entry must be the id of a schema in the config. |
-| `field/schema-ref-is-enum` | ...and that schema must be `ROOT` or `NODE`, not `ENUM`. |
+| `field/schema-ref-is-enum` | ...and that schema must be `NODE`, not `ENUM`. |
+| `field/schema-ref-is-root` | ...nor `ROOT` — the Studio editor only offers `NODE` schemas. |
+| `field/missing-schemas` | A `SCHEMA`/`SCHEMAS` field must list at least one schema in `schemas`; with none the editor can add no block. |
 
 `validate` does not check for stray properties from the wrong field kind —
 use `defineField` for that (above). Duplicate field names and duplicate

package/dist/define.d.ts

@@ -27,7 +27,7 @@ type FieldInputOf<F> = F extends {
 } : F extends {
     kind: 'SCHEMA' | 'SCHEMAS';
 } ? Omit<DeepReadonly<F>, 'schemas'> & {
-    readonly schemas?: readonly (string | ComponentDefinition)[];
+    readonly schemas: readonly (string | ComponentDefinition)[];
 } : DeepReadonly<F>;
 /**
  * A field as authored: OPTION/OPTIONS source and SCHEMA/SCHEMAS schemas accept by-value refs.
@@ -141,8 +141,8 @@ export declare function defineEnum<const TId extends string, const TValues exten
  * - `OPTIONS` — `source` (required, same as `OPTION`), `minValues?`, `maxValues?`
  * - `REFERENCE` / `REFERENCES` — `path?`
  * - `ASSET` / `ASSETS` — `fileTypes?`, `fileType?`
- * - `SCHEMA` / `SCHEMAS` — `schemas?` (allowed definitions from `defineSchema`, or their ids;
- *   every `NODE` schema in the config is allowed when omitted)
+ * - `SCHEMA` / `SCHEMAS` — `schemas` (required: the allowed `NODE` definitions from `defineSchema`,
+ *   or their ids — the Studio editor offers exactly these, so an empty list leaves the field unusable)
  *
  * Full field-kind reference, including the type each kind infers to: `docs/schema.md`.
  *

package/dist/index.js

@@ -44,8 +44,8 @@ function defineEnum(definition) {
 * - `OPTIONS` — `source` (required, same as `OPTION`), `minValues?`, `maxValues?`
 * - `REFERENCE` / `REFERENCES` — `path?`
 * - `ASSET` / `ASSETS` — `fileTypes?`, `fileType?`
-* - `SCHEMA` / `SCHEMAS` — `schemas?` (allowed definitions from `defineSchema`, or their ids;
-*   every `NODE` schema in the config is allowed when omitted)
+* - `SCHEMA` / `SCHEMAS` — `schemas` (required: the allowed `NODE` definitions from `defineSchema`,
+*   or their ids — the Studio editor offers exactly these, so an empty list leaves the field unusable)
 *
 * Full field-kind reference, including the type each kind infers to: `docs/schema.md`.
 *
@@ -193,10 +193,14 @@ function validate(config) {
 				if (!source) error("field/unresolved-source", fieldPath, `source '${field.source}' does not resolve to a schema in the config`);
 				else if (source.type !== "ENUM") error("field/source-not-enum", fieldPath, `source '${field.source}' must be an ENUM schema`);
 			}
-			if (field.kind === "SCHEMA" || field.kind === "SCHEMAS") for (const ref of field.schemas ?? []) {
-				const target = byId.get(ref);
-				if (!target) error("field/unresolved-schema-ref", fieldPath, `schemas ref '${ref}' does not resolve to a schema in the config`);
-				else if (target.type === "ENUM") error("field/schema-ref-is-enum", fieldPath, `schemas ref '${ref}' must be a ROOT or NODE schema, not an ENUM`);
+			if (field.kind === "SCHEMA" || field.kind === "SCHEMAS") {
+				if (!field.schemas || field.schemas.length === 0) error("field/missing-schemas", fieldPath, `${field.kind} field must list at least one NODE schema in 'schemas'`);
+				for (const ref of field.schemas ?? []) {
+					const target = byId.get(ref);
+					if (!target) error("field/unresolved-schema-ref", fieldPath, `schemas ref '${ref}' does not resolve to a schema in the config`);
+					else if (target.type === "ENUM") error("field/schema-ref-is-enum", fieldPath, `schemas ref '${ref}' must be a NODE schema, not an ENUM`);
+					else if (target.type === "ROOT") error("field/schema-ref-is-root", fieldPath, `schemas ref '${ref}' must be a NODE schema; the editor never offers a ROOT schema`);
+				}
 			}
 		}
 	}

package/dist/index.mjs

@@ -43,8 +43,8 @@ function defineEnum(definition) {
 * - `OPTIONS` — `source` (required, same as `OPTION`), `minValues?`, `maxValues?`
 * - `REFERENCE` / `REFERENCES` — `path?`
 * - `ASSET` / `ASSETS` — `fileTypes?`, `fileType?`
-* - `SCHEMA` / `SCHEMAS` — `schemas?` (allowed definitions from `defineSchema`, or their ids;
-*   every `NODE` schema in the config is allowed when omitted)
+* - `SCHEMA` / `SCHEMAS` — `schemas` (required: the allowed `NODE` definitions from `defineSchema`,
+*   or their ids — the Studio editor offers exactly these, so an empty list leaves the field unusable)
 *
 * Full field-kind reference, including the type each kind infers to: `docs/schema.md`.
 *
@@ -192,10 +192,14 @@ function validate(config) {
 				if (!source) error("field/unresolved-source", fieldPath, `source '${field.source}' does not resolve to a schema in the config`);
 				else if (source.type !== "ENUM") error("field/source-not-enum", fieldPath, `source '${field.source}' must be an ENUM schema`);
 			}
-			if (field.kind === "SCHEMA" || field.kind === "SCHEMAS") for (const ref of field.schemas ?? []) {
-				const target = byId.get(ref);
-				if (!target) error("field/unresolved-schema-ref", fieldPath, `schemas ref '${ref}' does not resolve to a schema in the config`);
-				else if (target.type === "ENUM") error("field/schema-ref-is-enum", fieldPath, `schemas ref '${ref}' must be a ROOT or NODE schema, not an ENUM`);
+			if (field.kind === "SCHEMA" || field.kind === "SCHEMAS") {
+				if (!field.schemas || field.schemas.length === 0) error("field/missing-schemas", fieldPath, `${field.kind} field must list at least one NODE schema in 'schemas'`);
+				for (const ref of field.schemas ?? []) {
+					const target = byId.get(ref);
+					if (!target) error("field/unresolved-schema-ref", fieldPath, `schemas ref '${ref}' does not resolve to a schema in the config`);
+					else if (target.type === "ENUM") error("field/schema-ref-is-enum", fieldPath, `schemas ref '${ref}' must be a NODE schema, not an ENUM`);
+					else if (target.type === "ROOT") error("field/schema-ref-is-root", fieldPath, `schemas ref '${ref}' must be a NODE schema; the editor never offers a ROOT schema`);
+				}
 			}
 		}
 	}

package/dist/infer.d.ts

@@ -9,13 +9,6 @@ type SchemasOf<C> = C extends {
 type FindById<C, Id> = Extract<SchemasOf<C>, {
     id: Id;
 }>;
-type NodeIds<C> = [Extract<SchemasOf<C>, {
-    type: 'NODE';
-}>] extends [never] ? never : Extract<SchemasOf<C>, {
-    type: 'NODE';
-}> extends {
-    id: infer Id extends string;
-} ? Id : never;
 type EnumValuesUnion<E> = E extends {
     values: readonly SchemaEnumValue[];
 } ? E extends {
@@ -26,13 +19,13 @@ type EnumValuesUnion<E> = E extends {
 /** Literal union of an ENUM definition's values (falls back to `string` when values are absent). */
 export type InferEnum<E> = EnumValuesUnion<E>;
 type ResolveEnum<Id extends string, C> = [FindById<C, Id>] extends [never] ? string : EnumValuesUnion<FindById<C, Id>>;
-type AllowedIds<F, C> = F extends {
+type AllowedIds<F> = F extends {
     schemas: readonly (infer Id extends string)[];
-} ? Id : NodeIds<C>;
-type ResolveSchemaContent<F, C> = [AllowedIds<F, C>] extends [never] ? {
+} ? Id : never;
+type ResolveSchemaContent<F, C> = [AllowedIds<F>] extends [never] ? {
     _id: string;
     _schema: string;
-} : ContentByIds<AllowedIds<F, C>, C>;
+} : ContentByIds<AllowedIds<F>, C>;
 type ContentByIds<Id extends string, C> = Id extends unknown ? InferContent<FindById<C, Id>, C> : never;
 type FieldValue<F, C> = F extends {
     kind: 'TEXT' | 'TEXTAREA' | 'MARKDOWN' | 'COLOR' | 'DATE' | 'DATETIME';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/schema",
-  "version": "4.0.3-dev.20261004111503",
+  "version": "4.0.3-dev.20261004121049",
   "description": "Programmatic schema definitions for Localess with TypeScript content type inference.",
   "keywords": [
     "localess",
@@ -43,7 +43,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@localess/model": "4.0.3-dev.20261004111503"
+    "@localess/model": "4.0.3-dev.20261004121049"
   },
   "devDependencies": {
     "@types/node": "^24",