@localess/schema 4.0.3-dev.20261004124605 → 4.0.3-dev.20261004140136

package/SKILL.md

@@ -81,7 +81,7 @@ Everything below is `export type` — importable with `import type { ... } from
 | Authoring (from `define.ts`) | `EnumDefinition` (result of `defineEnum`), `ComponentDefinition` (result of `defineSchema`), `SchemaDefinition` (`ComponentDefinition \| EnumDefinition`), `LocalessSchemaConfig` (`{ schemas: readonly SchemaDefinition[] }` — what `validate`/`toSchemaExport` accept), `SchemaFieldInput` (a field as authored: `source`/`schemas` accept by-value refs), `EnumDefinitionInput`, `ComponentDefinitionInput` |
 | Inference (from `infer.ts`) | `InferContentData`, `InferContent`, `InferEnum` |
 | Validation (from `validate.ts`) | `ValidationIssue` (`{ severity: 'error' \| 'warning'; code; path; message }`), `ValidationResult` (`{ ok; issues }`) |
-| Wire model (re-exported from `@localess/model`) | `SchemaType`, `SchemaFieldKind`, `AssetFileType`, `SchemaEnumValue`, `SchemaFieldBase`, `SchemaField`, the 18 per-kind interfaces (`SchemaFieldText`, `SchemaFieldTextarea`, `SchemaFieldRichText`, `SchemaFieldMarkdown`, `SchemaFieldNumber`, `SchemaFieldColor`, `SchemaFieldDate`, `SchemaFieldDateTime`, `SchemaFieldBoolean`, `SchemaFieldOption`, `SchemaFieldOptions`, `SchemaFieldLink`, `SchemaFieldReference`, `SchemaFieldReferences`, `SchemaFieldAsset`, `SchemaFieldAssets`, `SchemaFieldSchema`, `SchemaFieldSchemas`), `SchemaComponentExport`, `SchemaEnumExport`, `SchemaExport` |
+| Wire model (re-exported from `@localess/model`) | `SchemaType`, `SchemaFieldKind`, `AssetFileType`, `SchemaEnumValue`, `SchemaFieldBase`, `SchemaFieldTranslatable`, `TranslatableSchemaFieldKind`, `SchemaField`, the 18 per-kind interfaces (`SchemaFieldText`, `SchemaFieldTextarea`, `SchemaFieldRichText`, `SchemaFieldMarkdown`, `SchemaFieldNumber`, `SchemaFieldColor`, `SchemaFieldDate`, `SchemaFieldDateTime`, `SchemaFieldBoolean`, `SchemaFieldOption`, `SchemaFieldOptions`, `SchemaFieldLink`, `SchemaFieldReference`, `SchemaFieldReferences`, `SchemaFieldAsset`, `SchemaFieldAssets`, `SchemaFieldSchema`, `SchemaFieldSchemas`), `SchemaComponentExport`, `SchemaEnumExport`, `SchemaExport` |
 | Content values (re-exported from `@localess/model`) | `ContentAsset`, `ContentLink`, `ContentReference`, `ContentRichText` — plus every other `@localess/model` type (`Content`, `Locale`, `Space`, `Translations`, …), since `src/index.ts` ends with `export * from '@localess/model'` |
 
 ## `defineField`
@@ -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

@@ -28,6 +28,11 @@ type FieldInputOf<F> = F extends {
     kind: 'SCHEMA' | 'SCHEMAS';
 } ? Omit<DeepReadonly<F>, 'schemas'> & {
     readonly schemas: readonly (string | ComponentDefinition)[];
+    readonly translatable?: never;
+} : F extends {
+    kind: 'REFERENCE' | 'REFERENCES';
+} ? DeepReadonly<F> & {
+    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,22 @@ var RESERVED_SCHEMA_IDS = [
 	"Content"
 ];
 var RESERVED_FIELD_NAMES = ["_id", "_schema"];
+var TRANSLATABLE_FIELD_KINDS = {
+	TEXT: true,
+	TEXTAREA: true,
+	RICH_TEXT: true,
+	MARKDOWN: true,
+	NUMBER: true,
+	COLOR: true,
+	DATE: true,
+	DATETIME: true,
+	BOOLEAN: true,
+	OPTION: true,
+	OPTIONS: true,
+	LINK: true,
+	ASSET: true,
+	ASSETS: true
+};
 /**
 * 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 +205,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 ("translatable" in field && field.translatable && !(field.kind in TRANSLATABLE_FIELD_KINDS)) 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,22 @@ var RESERVED_SCHEMA_IDS = [
 	"Content"
 ];
 var RESERVED_FIELD_NAMES = ["_id", "_schema"];
+var TRANSLATABLE_FIELD_KINDS = {
+	TEXT: true,
+	TEXTAREA: true,
+	RICH_TEXT: true,
+	MARKDOWN: true,
+	NUMBER: true,
+	COLOR: true,
+	DATE: true,
+	DATETIME: true,
+	BOOLEAN: true,
+	OPTION: true,
+	OPTIONS: true,
+	LINK: true,
+	ASSET: true,
+	ASSETS: true
+};
 /**
 * 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 +204,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 ("translatable" in field && field.translatable && !(field.kind in TRANSLATABLE_FIELD_KINDS)) 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.20261004124605",
+  "version": "4.0.3-dev.20261004140136",
   "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.20261004124605"
+    "@localess/model": "4.0.3-dev.20261004140136"
   },
   "devDependencies": {
     "@types/node": "^24",