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

package/SKILL.md

@@ -126,6 +126,8 @@ Fallbacks when a reference can't be resolved against the config:
 
 Every field carries `name`, `kind`, and the base optional properties
 (`displayName`, `required`, `description`, `defaultValue`, `translatable`).
+`translatable` is rejected on `REFERENCE`/`REFERENCES`/`SCHEMA`/`SCHEMAS` — at compile time and by
+`validate()` — since the Studio editor never translates those kinds.
 `required: true` fields are non-optional keys on the inferred content type;
 everything else is optional.
 
@@ -176,6 +178,7 @@ schema in the config is checked, not just the first. Rules and their `code`:
 | `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 `NODE`, not `ENUM`. |
 | `field/schema-ref-is-root` | ...nor `ROOT` — the Studio editor only offers `NODE` schemas. |
+| `field/translatable-unsupported` | `translatable` must not be set on `REFERENCE`/`REFERENCES`/`SCHEMA`/`SCHEMAS`; the Studio editor never translates them. |
 | `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 —

package/dist/define.d.ts

@@ -26,8 +26,13 @@ type FieldInputOf<F> = F extends {
     readonly source: string | EnumDefinition;
 } : F extends {
     kind: 'SCHEMA' | 'SCHEMAS';
-} ? Omit<DeepReadonly<F>, 'schemas'> & {
+} ? Omit<DeepReadonly<F>, 'schemas' | 'translatable'> & {
     readonly schemas: readonly (string | ComponentDefinition)[];
+    readonly translatable?: never;
+} : F extends {
+    kind: 'REFERENCE' | 'REFERENCES';
+} ? Omit<DeepReadonly<F>, 'translatable'> & {
+    readonly translatable?: never;
 } : DeepReadonly<F>;
 /**
  * A field as authored: OPTION/OPTIONS source and SCHEMA/SCHEMAS schemas accept by-value refs.
@@ -133,7 +138,8 @@ export declare function defineEnum<const TId extends string, const TValues exten
  * of a field's origin. See `docs/decisions/008-schema-package.md`.
  *
  * Every `kind` accepts `name` (required), plus `displayName?`, `required?`, `description?`,
- * `defaultValue?`, `translatable?`. Kind-specific extras:
+ * `defaultValue?`, and — except on `REFERENCE` / `REFERENCES` / `SCHEMA` / `SCHEMAS`, which the
+ * Studio editor never translates — `translatable?`. Kind-specific extras:
  * - `TEXT` / `TEXTAREA` / `RICH_TEXT` / `MARKDOWN` — `minLength?`, `maxLength?`
  * - `NUMBER` — `minValue?`, `maxValue?`
  * - `COLOR` / `DATE` / `DATETIME` / `BOOLEAN` / `LINK` — no extras

package/dist/index.js

@@ -36,7 +36,8 @@ function defineEnum(definition) {
 * of a field's origin. See `docs/decisions/008-schema-package.md`.
 *
 * Every `kind` accepts `name` (required), plus `displayName?`, `required?`, `description?`,
-* `defaultValue?`, `translatable?`. Kind-specific extras:
+* `defaultValue?`, and — except on `REFERENCE` / `REFERENCES` / `SCHEMA` / `SCHEMAS`, which the
+* Studio editor never translates — `translatable?`. Kind-specific extras:
 * - `TEXT` / `TEXTAREA` / `RICH_TEXT` / `MARKDOWN` — `minLength?`, `maxLength?`
 * - `NUMBER` — `minValue?`, `maxValue?`
 * - `COLOR` / `DATE` / `DATETIME` / `BOOLEAN` / `LINK` — no extras
@@ -150,6 +151,12 @@ var RESERVED_SCHEMA_IDS = [
 	"Content"
 ];
 var RESERVED_FIELD_NAMES = ["_id", "_schema"];
+var UNTRANSLATABLE_FIELD_KINDS = [
+	"REFERENCE",
+	"REFERENCES",
+	"SCHEMA",
+	"SCHEMAS"
+];
 /**
 * Validate a schema config against the Localess authoring rules (ID/name patterns, reserved
 * names, length limits, reference resolution). Non-throwing; `ok` is false only when at least
@@ -188,6 +195,7 @@ function validate(config) {
 			if (field.displayName && field.displayName.length > 30) error("field/display-name-too-long", fieldPath, "Field displayName exceeds 30 characters");
 			if (field.description && field.description.length > 250) error("field/description-too-long", fieldPath, "Field description exceeds 250 characters");
 			if (field.defaultValue && field.defaultValue.length > 250) error("field/default-value-too-long", fieldPath, "Field defaultValue exceeds 250 characters");
+			if (field.translatable && UNTRANSLATABLE_FIELD_KINDS.includes(field.kind)) error("field/translatable-unsupported", fieldPath, `${field.kind} fields cannot be translatable; the Studio editor never translates them`);
 			if (field.kind === "OPTION" || field.kind === "OPTIONS") {
 				const source = byId.get(field.source);
 				if (!source) error("field/unresolved-source", fieldPath, `source '${field.source}' does not resolve to a schema in the config`);

package/dist/index.mjs

@@ -35,7 +35,8 @@ function defineEnum(definition) {
 * of a field's origin. See `docs/decisions/008-schema-package.md`.
 *
 * Every `kind` accepts `name` (required), plus `displayName?`, `required?`, `description?`,
-* `defaultValue?`, `translatable?`. Kind-specific extras:
+* `defaultValue?`, and — except on `REFERENCE` / `REFERENCES` / `SCHEMA` / `SCHEMAS`, which the
+* Studio editor never translates — `translatable?`. Kind-specific extras:
 * - `TEXT` / `TEXTAREA` / `RICH_TEXT` / `MARKDOWN` — `minLength?`, `maxLength?`
 * - `NUMBER` — `minValue?`, `maxValue?`
 * - `COLOR` / `DATE` / `DATETIME` / `BOOLEAN` / `LINK` — no extras
@@ -149,6 +150,12 @@ var RESERVED_SCHEMA_IDS = [
 	"Content"
 ];
 var RESERVED_FIELD_NAMES = ["_id", "_schema"];
+var UNTRANSLATABLE_FIELD_KINDS = [
+	"REFERENCE",
+	"REFERENCES",
+	"SCHEMA",
+	"SCHEMAS"
+];
 /**
 * Validate a schema config against the Localess authoring rules (ID/name patterns, reserved
 * names, length limits, reference resolution). Non-throwing; `ok` is false only when at least
@@ -187,6 +194,7 @@ function validate(config) {
 			if (field.displayName && field.displayName.length > 30) error("field/display-name-too-long", fieldPath, "Field displayName exceeds 30 characters");
 			if (field.description && field.description.length > 250) error("field/description-too-long", fieldPath, "Field description exceeds 250 characters");
 			if (field.defaultValue && field.defaultValue.length > 250) error("field/default-value-too-long", fieldPath, "Field defaultValue exceeds 250 characters");
+			if (field.translatable && UNTRANSLATABLE_FIELD_KINDS.includes(field.kind)) error("field/translatable-unsupported", fieldPath, `${field.kind} fields cannot be translatable; the Studio editor never translates them`);
 			if (field.kind === "OPTION" || field.kind === "OPTIONS") {
 				const source = byId.get(field.source);
 				if (!source) error("field/unresolved-source", fieldPath, `source '${field.source}' does not resolve to a schema in the config`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/schema",
-  "version": "4.0.3-dev.20261004121049",
+  "version": "4.0.3-dev.20261004130007",
   "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.20261004121049"
+    "@localess/model": "4.0.3-dev.20261004130007"
   },
   "devDependencies": {
     "@types/node": "^24",