@bettercms-ai/kit 2.0.0 → 2.0.1

package/dist/schema/types.d.ts

@@ -10,6 +10,7 @@
  *  - Every field has the same chrome: label · help · required · validation · counter · ⋯ menu · presence · comments.
  *  - Blocks can contain blocks (slots) → complex layouts (tabs, columns, bento, mega menus, carousels).
  */
+import type { RichTextFeature } from "@bettercms-ai/types";
 import type { Cap } from "./sources";
 import type { TableFieldOptions } from "./table";
 export type PrimitiveType = "string" | "text" | "richtext" | "number" | "boolean" | "slug" | "url" | "email" | "date" | "datetime" | "color" | "select" | "multiselect" | "tags" | "image" | "file" | "video" | "icon" | "link" | "button" | "reference" | "code" | "json" | "geopoint" | "rating" | "table";
@@ -105,6 +106,8 @@ export interface FieldSchema {
     reference?: {
         to: string[];
         filter?: string;
+        noun?: string;
+        excludeId?: string;
     };
     numeric?: {
         unit?: string;
@@ -156,6 +159,20 @@ export interface FieldSchema {
     /** code: the field's own language and the only languages its picker offers (prod config.language / languages). */
     language?: string;
     languages?: string[];
+    /**
+     * richtext / document: the blocks and marks the field offers, from types RICHTEXT_FEATURES (prod config.features).
+     * Absent = all of them, as V2's rich text offers (normV2 folds the full set to absent). A schema read from JSON may
+     * hold an alias (`headings`) or an unknown name: the adapter expands the one and names the other.
+     */
+    features?: RichTextFeature[];
+    /**
+     * richtext / document: the content models its related posts and author bios draw from (prod config.references,
+     * plan RT8), by id. posts absent: the entry's own collection; authors absent: no author bio is offered.
+     */
+    references?: {
+        posts?: string;
+        authors?: string;
+    };
 }
 /** D58: the caps that let someone see / change one field. */
 export interface FieldAccess {

package/dist/schema/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/schema/types.ts"],"sourcesContent":["/**\n * BETTERCMS SCHEMA — the long-term contract for every editable thing (blocks, pages, entries, globals).\n * One schema language → one form engine (`@/components/kit`) → used by BOTH the Visuals inspector and the\n * Content document editor. Modelled on Sanity's schema (types, fieldsets, groups, previews, validation,\n * conditional fields) plus BetterCMS's block slots for nested layouts.\n *\n * Design principles (CPO D8):\n *  - Scales to deep nesting without inline-accordion soup: arrays render compact preview rows; opening an item\n *    DRILLS IN (panel slides, breadcrumb grows). Small objects may render inline; lightweight settings open in a POPOVER.\n *  - Every field has the same chrome: label · help · required · validation · counter · ⋯ menu · presence · comments.\n *  - Blocks can contain blocks (slots) → complex layouts (tabs, columns, bento, mega menus, carousels).\n */\n\nimport type { Cap } from \"./sources\";\nimport type { TableFieldOptions } from \"./table\";\n\nexport type PrimitiveType =\n  | \"string\" // single line\n  | \"text\" // multi line, auto-grow\n  | \"richtext\" // portable-text style rich text\n  | \"number\"\n  | \"boolean\"\n  | \"slug\"\n  | \"url\"\n  | \"email\"\n  | \"date\"\n  | \"datetime\"\n  | \"color\"\n  | \"select\" // options: single\n  | \"multiselect\"\n  | \"tags\"\n  | \"image\"\n  | \"file\"\n  | \"video\"\n  | \"icon\" // icon picker (Tabler name)\n  | \"link\" // url | page ref + target + rel  (one unit)\n  | \"button\" // label + link + style  (one unit — founder rule)\n  | \"reference\" // to a collection entry / page / form\n  | \"code\"\n  | \"json\"\n  | \"geopoint\"\n  | \"rating\"\n  | \"table\"; // typed columns × keyed rows (CPO D42) — value: TableValue (src/schema/table.ts)\n\nexport type CompoundType =\n  | \"object\" // nested fields\n  | \"array\" // list of `of` (objects, primitives or references)\n  | \"slot\"; // list of nested BLOCKS (block-in-block layouts)\n\nexport type SchemaType = PrimitiveType | CompoundType;\n\nexport interface Option {\n  value: string;\n  label: string;\n  icon?: string;\n  description?: string;\n}\n\nexport interface Validation {\n  required?: boolean;\n  min?: number; // chars for strings, items for arrays, value for numbers\n  max?: number;\n  /** soft limit: warning (amber) instead of error — e.g. SEO title 60 */\n  recommendedMax?: number;\n  pattern?: string;\n  patternMessage?: string;\n  unique?: boolean;\n}\n\n/** How a compound field is edited when opened. */\nexport type OpenMode =\n  | \"inline\" // render fields in place (small objects, ≤3 primitives)\n  | \"drill\" // slide the panel to a child view; breadcrumb grows (default for array items & objects)\n  | \"popover\" // anchored popover (link settings, image crop/alt, small option sets)\n  | \"dialog\"; // centered modal for heavy editors (rich text full screen, code, table)\n\nexport interface PreviewConfig {\n  /** dotted paths into the item value */\n  title?: string;\n  subtitle?: string;\n  media?: string;\n  /** Fallback label, e.g. \"Untitled question\" */\n  fallback?: string;\n  /** Tabler icon name (kebab-case, e.g. \"help-circle\") shown when there is no media. */\n  icon?: string;\n}\n\n/** A condition's operator. Absent: `equals` reads as is / is one of, `notEmpty` as has a value. */\nexport type ConditionOp = \"is\" | \"isNot\" | \"in\" | \"notIn\" | \"empty\" | \"notEmpty\" | \"gt\" | \"lt\";\n\n/**\n * \"Show only when\" (V2 types.ts). The field shows only while the rule holds:\n *  - `field` names a key beside it (default), in the object that holds those fields (`scope: \"parent\"`) or at the top of\n *    the component or CMS item (`scope: \"root\"`). `_variant` is the component's variant (its first variant when unset).\n *  - `op` + `value` (is · is not · is one of · is not one of · is empty · has a value · more than · less than). The legacy\n *    `equals` / `notEmpty` forms still read the same.\n *  - `also`: more rules, combined by `match` (\"all\", the default, or \"any\").\n */\nexport interface Condition {\n  field: string;\n  equals?: unknown | unknown[];\n  notEmpty?: boolean;\n  op?: ConditionOp;\n  value?: unknown;\n  scope?: \"parent\" | \"root\";\n  also?: Condition[];\n  match?: \"all\" | \"any\";\n}\n\nexport interface FieldSchema {\n  name: string; // key in the value object\n  title: string; // label (sentence case)\n  type: SchemaType;\n  /** Help text under the label (CPO D39). Unset → a house convention from `@/schema/help` may apply; \"\" = none. */\n  description?: string;\n  /** Longer explanation behind the ⓘ next to the label (tooltip). Use when one line can't carry it. */\n  helpMore?: string;\n  placeholder?: string;\n  initialValue?: unknown;\n  validation?: Validation;\n  options?: Option[]; // select / multiselect / radio-like\n  layout?: \"dropdown\" | \"radio\" | \"segmented\" | \"cards\" | \"switch\" | \"checkbox\" | \"slider\" | \"grid\" | \"list\";\n  /** compound */\n  fields?: FieldSchema[]; // object\n  of?: FieldSchema[] | { type: \"block\"; allow?: string[] }; // array items / slot allowed block types\n  openMode?: OpenMode;\n  preview?: PreviewConfig;\n  /** organisation */\n  fieldset?: string; // groups fields into a collapsible fieldset\n  group?: string; // which tab (Content / Media / Settings / SEO…)\n  /** behaviour */\n  hidden?: Condition | boolean;\n  /** true = never editable in the form (computed or system values). Who may see or change a field is `access`. */\n  readOnly?: boolean;\n  /** Archived (V2 types.ts): kept in the schema and its values stay stored, but no form renders it. Schema editors show it. */\n  archived?: boolean;\n  /**\n   * D58 field-level access. `view` missing → everyone who can open the form sees it; `edit` missing → the form's own\n   * rule (the host's content.edit). A field the lens can't `view` is not rendered; one it can't `edit` renders as plain\n   * text. Fields in the `seo` group default to `{ edit: \"seo.edit\" }`.\n   */\n  access?: FieldAccess;\n  localized?: boolean;\n  advanced?: boolean; // tucked into the \"Advanced\" fieldset by default (calm UX)\n  ai?: boolean; // show the AI assist sparkle\n  reference?: { to: string[]; filter?: string }; // reference targets (collection ids, \"page\", \"form\")\n  numeric?: { unit?: string; step?: number; min?: number; max?: number }; // number / slider\n  /** number: a developer-controlled SCALE (tokens or a stepped range) with an optional custom escape hatch (CPO D41).\n   *  Value shape → `ScaleValue`. Takes precedence over `layout: \"slider\"` + `numeric` (which still work, fixed-only). */\n  scale?: ScaleSchema;\n  /** table: column types allowed, developer-locked columns, row limits, caption rule, JSON-LD offered (CPO D42). */\n  table?: TableFieldOptions;\n\n  /* ── additive (Block Kit v1) ─────────────────────────────────────────── */\n  /** Tabler icon name (kebab-case) used on rows, crumbs and the block picker. */\n  icon?: string;\n  /** text: minimum visible rows. */\n  rows?: number;\n  /** Value is synced from a global block (\"Navigation\") — edits apply everywhere it is used. */\n  synced?: { from: string };\n  /** slot: per-child layout settings stored on each child under `_settings` (e.g. bento span). */\n  slotSettings?: FieldSchema[];\n  /** array: singular noun for \"Add {noun}\" and empty states (\"question\"). Defaults from the item title. */\n  itemNoun?: string;\n  /** array: how rows render. \"grid\" = tiles (good for images / logos). */\n  arrayLayout?: \"list\" | \"grid\";\n  /** Help line shown under a field the lens can see but not change (\"Set by the developer in code.\"). Never a key or a lock. */\n  lockReason?: string;\n  /**\n   * Host-only, never persisted: the list's ORDER is set by the site's code (identity rule 36). The rows stay editable;\n   * drag and Move up / down are off and the grip slot shows a lock (V2 content/editor/page-sections.tsx:31,155).\n   */\n  orderLocked?: boolean;\n  /** link / image / button: store a plain string (href or URL) instead of the object — for legacy data. */\n  valueShape?: \"string\" | \"object\";\n  /** image: an inline-SVG icon, which takes SVG files only (prod `config.media: \"icon\"`). */\n  svgOnly?: boolean;\n  /**\n   * A link LABEL's href: the sibling it links with (prod `config.linkHref`), as the owner answered the editable plan's\n   * `link-pair` question where the names do not say (`title` + `to`). Read first by `linkLabelHref`.\n   */\n  linkHref?: string;\n  /**\n   * date / datetime: time zone handling (CPO D43). true = the editor picks a zone (defaults to the site's) · \"site\" = always\n   * the site's zone · \"fixed:<IANA>\" = always that zone · false = no zone. Default: true for datetime, false for date.\n   * Zoned values store ISO with offset + the IANA zone: \"2026-10-14T09:00:00+05:30[Asia/Kolkata]\" (RFC 9557).\n   */\n  timezone?: boolean | \"site\" | `fixed:${string}`;\n  /** code: the field's own language and the only languages its picker offers (prod config.language / languages). */\n  language?: string;\n  languages?: string[];\n}\n\n/** D58: the caps that let someone see / change one field. */\nexport interface FieldAccess {\n  view?: Cap;\n  edit?: Cap;\n}\n/** Developer-owned values (anchors, custom CSS, ids): only people who can change the schema edit them. */\nexport const DEV_FIELD: FieldAccess = { edit: \"schema.manage\" };\n/** Developer-only settings: hidden unless you can see the schema. */\nexport const DEV_ONLY_FIELD: FieldAccess = { view: \"schema.view\", edit: \"schema.manage\" };\n\n/* ── Scales (CPO D41) ─────────────────────────────────────────────────── */\nexport type ScaleUnit = \"px\" | \"%\" | \"rem\" | \"em\" | \"vw\" | \"vh\";\n\n/** One allowed value of a token scale. `value` is what is stored; `label` is the short readout (\"XL\"). */\nexport interface ScaleStep {\n  value: string;\n  label: string;\n  /** Long name for screen readers and tooltips (\"Extra large\"). Defaults to `label`. */\n  title?: string;\n  /** Resolved size in px, shown as \"XL · 48px\" and used to place custom values on the track. */\n  px?: number;\n  /** Resolved CSS when it isn't px (e.g. \"100vh\", \"var(--space-xl)\"). */\n  css?: string;\n}\n\n/** A stepped numeric range (continuous with snapping). The stored value is a bare number in `defaultUnit`. */\nexport interface ScaleRange {\n  min: number;\n  max: number;\n  step?: number;\n}\n\n/** Bounds for the custom escape hatch. min / max may be one number or per unit ({ px: 0, \"%\": 0 }). */\nexport interface ScaleCustom {\n  min?: number | Partial<Record<ScaleUnit, number>>;\n  max?: number | Partial<Record<ScaleUnit, number>>;\n  /** Units the editor may type. Defaults to the scale's `units`. */\n  units?: ScaleUnit[];\n  /** Arrow-key nudge (Shift ×10, Alt ×0.1). Default 1. */\n  step?: number;\n}\n\nexport interface ScaleSchema {\n  /** Token steps (S M L XL 2XL) or a numeric range ({ min, max, step }). */\n  steps: ScaleStep[] | ScaleRange;\n  /** Units of the scale; the first is the default. A range with no units is unitless. */\n  units?: ScaleUnit[];\n  defaultUnit?: ScaleUnit;\n  /** false (default) = fixed only: the editor can pick only the allowed values. true / object = fixed + custom. */\n  allowCustom?: boolean | ScaleCustom;\n  /** Quick picks in the unit menu when custom is allowed (\"50%\", \"100vh\"). */\n  presets?: { label?: string; value: ScaleValue }[];\n}\n\n/**\n * How a scale value is STORED — three shapes, told apart by `typeof`, so tokens and custom values never collide and\n * older data (bare token strings, bare numbers) is already valid:\n *  - token  → the step's value string   (\"xl\")\n *  - range  → a bare number in the default unit (15 → 15%)\n *  - custom → an object                 ({ value: 200, unit: \"px\" })\n */\nexport type ScaleValue = string | number | ScaleCustomValue;\nexport interface ScaleCustomValue {\n  value: number;\n  unit: ScaleUnit;\n}\n\nexport interface Fieldset {\n  name: string;\n  title: string;\n  description?: string;\n  collapsed?: boolean; // collapsed by default\n  columns?: 1 | 2; // short fields side by side\n  /** CPO D45: the header toggles the section (default true). false = a static heading for 2–3 fields that are always needed. */\n  collapsible?: boolean;\n  /**\n   * CPO D45: \"breakpoints\" = the members are objects, one per screen size (desktop · tablet · phone), shown as ONE group with a\n   * segmented switcher instead of three stacked groups. Sibling objects named desktop / laptop / tablet / mobile / phone get\n   * this automatically.\n   */\n  layout?: \"stack\" | \"breakpoints\";\n}\n\nexport interface FieldGroup {\n  name: string;\n  title: string;\n  icon?: string;\n  default?: boolean;\n}\n\n/** A developer-defined layout of a block (swap without losing content). */\nexport interface BlockVariant {\n  id: string;\n  name: string;\n  description?: string;\n}\n\n/** A document/block type. */\nexport interface TypeSchema {\n  name: string; // e.g. \"hero\", \"journalStory\"\n  title: string;\n  kind: \"block\" | \"page\" | \"entry\" | \"global\" | \"object\";\n  icon?: string;\n  description?: string;\n  fields: FieldSchema[];\n  fieldsets?: Fieldset[];\n  groups?: FieldGroup[];\n  preview?: PreviewConfig;\n  /* ── additive (Block Kit v1) ── */\n  /** Block variants (layouts) — shown as a chip on slot rows and a switcher in the block frame. */\n  variants?: BlockVariant[];\n  /** Block picker category (\"Layout\", \"Content\", \"Media\"…). */\n  category?: string;\n  /**\n   * kind \"block\" only (CPO D55): where the block fits. \"inline\" = it fits a text column, so a rich-text body lists it in\n   * the Insert menu's Article group. \"section\" (default) = page-width, reachable in a body only through More components.\n   * \"page\" = a whole page or a feed of other content; never inside a body.\n   */\n  placement?: \"inline\" | \"section\" | \"page\";\n  /** Starting value for a new instance (block added to a slot, new document). */\n  initialValue?: Record<string, unknown>;\n}\n\n/** Every array item / slot child carries a stable key. Slot children also carry their block type. */\nexport interface KeyedItem {\n  _key?: string;\n  /** item type name (arrays with several `of` types) or block type (slots) */\n  _type?: string;\n}\n/** A block inside a slot: its own props at the root, plus variant and per-slot layout settings. */\nexport interface SlotChild extends KeyedItem {\n  _type: string;\n  _variant?: string;\n  _settings?: Record<string, unknown>;\n  [prop: string]: unknown;\n}\n\n/** Path from the root document/block to the field being edited, e.g. [\"items\", 1, \"answer\"] */\nexport type FieldPath = (string | number)[];\n\n/** One crumb in the inspector/editor breadcrumb (drill-in navigation stack). */\nexport interface Crumb {\n  path: FieldPath;\n  title: string;\n  icon?: string;\n  /** tableGroup / tableRow / tableColumn: a table field's rows and columns drill like array items (D50) */\n  kind: \"root\" | \"object\" | \"item\" | \"block\" | \"button\" | \"history\" | \"tableGroup\" | \"tableRow\" | \"tableColumn\";\n}\n\n/** Reserved path segment: the field's version history as a stacked panel, e.g. [\"title\", \"@history\"]. */\nexport const HISTORY_SEGMENT = \"@history\";\n"],"mappings":";;AAuMA,IAAa,YAAyB,EAAE,MAAM,gBAAgB;;AAE9D,IAAa,iBAA8B;CAAE,MAAM;CAAe,MAAM;AAAgB;;AA8IxF,IAAa,kBAAkB"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/schema/types.ts"],"sourcesContent":["/**\n * BETTERCMS SCHEMA — the long-term contract for every editable thing (blocks, pages, entries, globals).\n * One schema language → one form engine (`@/components/kit`) → used by BOTH the Visuals inspector and the\n * Content document editor. Modelled on Sanity's schema (types, fieldsets, groups, previews, validation,\n * conditional fields) plus BetterCMS's block slots for nested layouts.\n *\n * Design principles (CPO D8):\n *  - Scales to deep nesting without inline-accordion soup: arrays render compact preview rows; opening an item\n *    DRILLS IN (panel slides, breadcrumb grows). Small objects may render inline; lightweight settings open in a POPOVER.\n *  - Every field has the same chrome: label · help · required · validation · counter · ⋯ menu · presence · comments.\n *  - Blocks can contain blocks (slots) → complex layouts (tabs, columns, bento, mega menus, carousels).\n */\n\nimport type { RichTextFeature } from \"@bettercms-ai/types\";\nimport type { Cap } from \"./sources\";\nimport type { TableFieldOptions } from \"./table\";\n\nexport type PrimitiveType =\n  | \"string\" // single line\n  | \"text\" // multi line, auto-grow\n  | \"richtext\" // portable-text style rich text\n  | \"number\"\n  | \"boolean\"\n  | \"slug\"\n  | \"url\"\n  | \"email\"\n  | \"date\"\n  | \"datetime\"\n  | \"color\"\n  | \"select\" // options: single\n  | \"multiselect\"\n  | \"tags\"\n  | \"image\"\n  | \"file\"\n  | \"video\"\n  | \"icon\" // icon picker (Tabler name)\n  | \"link\" // url | page ref + target + rel  (one unit)\n  | \"button\" // label + link + style  (one unit — founder rule)\n  | \"reference\" // to a collection entry / page / form\n  | \"code\"\n  | \"json\"\n  | \"geopoint\"\n  | \"rating\"\n  | \"table\"; // typed columns × keyed rows (CPO D42) — value: TableValue (src/schema/table.ts)\n\nexport type CompoundType =\n  | \"object\" // nested fields\n  | \"array\" // list of `of` (objects, primitives or references)\n  | \"slot\"; // list of nested BLOCKS (block-in-block layouts)\n\nexport type SchemaType = PrimitiveType | CompoundType;\n\nexport interface Option {\n  value: string;\n  label: string;\n  icon?: string;\n  description?: string;\n}\n\nexport interface Validation {\n  required?: boolean;\n  min?: number; // chars for strings, items for arrays, value for numbers\n  max?: number;\n  /** soft limit: warning (amber) instead of error — e.g. SEO title 60 */\n  recommendedMax?: number;\n  pattern?: string;\n  patternMessage?: string;\n  unique?: boolean;\n}\n\n/** How a compound field is edited when opened. */\nexport type OpenMode =\n  | \"inline\" // render fields in place (small objects, ≤3 primitives)\n  | \"drill\" // slide the panel to a child view; breadcrumb grows (default for array items & objects)\n  | \"popover\" // anchored popover (link settings, image crop/alt, small option sets)\n  | \"dialog\"; // centered modal for heavy editors (rich text full screen, code, table)\n\nexport interface PreviewConfig {\n  /** dotted paths into the item value */\n  title?: string;\n  subtitle?: string;\n  media?: string;\n  /** Fallback label, e.g. \"Untitled question\" */\n  fallback?: string;\n  /** Tabler icon name (kebab-case, e.g. \"help-circle\") shown when there is no media. */\n  icon?: string;\n}\n\n/** A condition's operator. Absent: `equals` reads as is / is one of, `notEmpty` as has a value. */\nexport type ConditionOp = \"is\" | \"isNot\" | \"in\" | \"notIn\" | \"empty\" | \"notEmpty\" | \"gt\" | \"lt\";\n\n/**\n * \"Show only when\" (V2 types.ts). The field shows only while the rule holds:\n *  - `field` names a key beside it (default), in the object that holds those fields (`scope: \"parent\"`) or at the top of\n *    the component or CMS item (`scope: \"root\"`). `_variant` is the component's variant (its first variant when unset).\n *  - `op` + `value` (is · is not · is one of · is not one of · is empty · has a value · more than · less than). The legacy\n *    `equals` / `notEmpty` forms still read the same.\n *  - `also`: more rules, combined by `match` (\"all\", the default, or \"any\").\n */\nexport interface Condition {\n  field: string;\n  equals?: unknown | unknown[];\n  notEmpty?: boolean;\n  op?: ConditionOp;\n  value?: unknown;\n  scope?: \"parent\" | \"root\";\n  also?: Condition[];\n  match?: \"all\" | \"any\";\n}\n\nexport interface FieldSchema {\n  name: string; // key in the value object\n  title: string; // label (sentence case)\n  type: SchemaType;\n  /** Help text under the label (CPO D39). Unset → a house convention from `@/schema/help` may apply; \"\" = none. */\n  description?: string;\n  /** Longer explanation behind the ⓘ next to the label (tooltip). Use when one line can't carry it. */\n  helpMore?: string;\n  placeholder?: string;\n  initialValue?: unknown;\n  validation?: Validation;\n  options?: Option[]; // select / multiselect / radio-like\n  layout?: \"dropdown\" | \"radio\" | \"segmented\" | \"cards\" | \"switch\" | \"checkbox\" | \"slider\" | \"grid\" | \"list\";\n  /** compound */\n  fields?: FieldSchema[]; // object\n  of?: FieldSchema[] | { type: \"block\"; allow?: string[] }; // array items / slot allowed block types\n  openMode?: OpenMode;\n  preview?: PreviewConfig;\n  /** organisation */\n  fieldset?: string; // groups fields into a collapsible fieldset\n  group?: string; // which tab (Content / Media / Settings / SEO…)\n  /** behaviour */\n  hidden?: Condition | boolean;\n  /** true = never editable in the form (computed or system values). Who may see or change a field is `access`. */\n  readOnly?: boolean;\n  /** Archived (V2 types.ts): kept in the schema and its values stay stored, but no form renders it. Schema editors show it. */\n  archived?: boolean;\n  /**\n   * D58 field-level access. `view` missing → everyone who can open the form sees it; `edit` missing → the form's own\n   * rule (the host's content.edit). A field the lens can't `view` is not rendered; one it can't `edit` renders as plain\n   * text. Fields in the `seo` group default to `{ edit: \"seo.edit\" }`.\n   */\n  access?: FieldAccess;\n  localized?: boolean;\n  advanced?: boolean; // tucked into the \"Advanced\" fieldset by default (calm UX)\n  ai?: boolean; // show the AI assist sparkle\n  // reference targets (collection ids, \"page\", \"form\"); `noun`: what the picker calls one (\"author\": \"Select an author\",\n  // \"Create new author\"), else the target's (\"CMS item\", \"page\", …)\n  // `excludeId`: a record this picker never lists (the entry a rich-text island sits in, which its own form cannot see)\n  reference?: { to: string[]; filter?: string; noun?: string; excludeId?: string };\n  numeric?: { unit?: string; step?: number; min?: number; max?: number }; // number / slider\n  /** number: a developer-controlled SCALE (tokens or a stepped range) with an optional custom escape hatch (CPO D41).\n   *  Value shape → `ScaleValue`. Takes precedence over `layout: \"slider\"` + `numeric` (which still work, fixed-only). */\n  scale?: ScaleSchema;\n  /** table: column types allowed, developer-locked columns, row limits, caption rule, JSON-LD offered (CPO D42). */\n  table?: TableFieldOptions;\n\n  /* ── additive (Block Kit v1) ─────────────────────────────────────────── */\n  /** Tabler icon name (kebab-case) used on rows, crumbs and the block picker. */\n  icon?: string;\n  /** text: minimum visible rows. */\n  rows?: number;\n  /** Value is synced from a global block (\"Navigation\") — edits apply everywhere it is used. */\n  synced?: { from: string };\n  /** slot: per-child layout settings stored on each child under `_settings` (e.g. bento span). */\n  slotSettings?: FieldSchema[];\n  /** array: singular noun for \"Add {noun}\" and empty states (\"question\"). Defaults from the item title. */\n  itemNoun?: string;\n  /** array: how rows render. \"grid\" = tiles (good for images / logos). */\n  arrayLayout?: \"list\" | \"grid\";\n  /** Help line shown under a field the lens can see but not change (\"Set by the developer in code.\"). Never a key or a lock. */\n  lockReason?: string;\n  /**\n   * Host-only, never persisted: the list's ORDER is set by the site's code (identity rule 36). The rows stay editable;\n   * drag and Move up / down are off and the grip slot shows a lock (V2 content/editor/page-sections.tsx:31,155).\n   */\n  orderLocked?: boolean;\n  /** link / image / button: store a plain string (href or URL) instead of the object — for legacy data. */\n  valueShape?: \"string\" | \"object\";\n  /** image: an inline-SVG icon, which takes SVG files only (prod `config.media: \"icon\"`). */\n  svgOnly?: boolean;\n  /**\n   * A link LABEL's href: the sibling it links with (prod `config.linkHref`), as the owner answered the editable plan's\n   * `link-pair` question where the names do not say (`title` + `to`). Read first by `linkLabelHref`.\n   */\n  linkHref?: string;\n  /**\n   * date / datetime: time zone handling (CPO D43). true = the editor picks a zone (defaults to the site's) · \"site\" = always\n   * the site's zone · \"fixed:<IANA>\" = always that zone · false = no zone. Default: true for datetime, false for date.\n   * Zoned values store ISO with offset + the IANA zone: \"2026-10-14T09:00:00+05:30[Asia/Kolkata]\" (RFC 9557).\n   */\n  timezone?: boolean | \"site\" | `fixed:${string}`;\n  /** code: the field's own language and the only languages its picker offers (prod config.language / languages). */\n  language?: string;\n  languages?: string[];\n  /**\n   * richtext / document: the blocks and marks the field offers, from types RICHTEXT_FEATURES (prod config.features).\n   * Absent = all of them, as V2's rich text offers (normV2 folds the full set to absent). A schema read from JSON may\n   * hold an alias (`headings`) or an unknown name: the adapter expands the one and names the other.\n   */\n  features?: RichTextFeature[];\n  /**\n   * richtext / document: the content models its related posts and author bios draw from (prod config.references,\n   * plan RT8), by id. posts absent: the entry's own collection; authors absent: no author bio is offered.\n   */\n  references?: { posts?: string; authors?: string };\n}\n\n/** D58: the caps that let someone see / change one field. */\nexport interface FieldAccess {\n  view?: Cap;\n  edit?: Cap;\n}\n/** Developer-owned values (anchors, custom CSS, ids): only people who can change the schema edit them. */\nexport const DEV_FIELD: FieldAccess = { edit: \"schema.manage\" };\n/** Developer-only settings: hidden unless you can see the schema. */\nexport const DEV_ONLY_FIELD: FieldAccess = { view: \"schema.view\", edit: \"schema.manage\" };\n\n/* ── Scales (CPO D41) ─────────────────────────────────────────────────── */\nexport type ScaleUnit = \"px\" | \"%\" | \"rem\" | \"em\" | \"vw\" | \"vh\";\n\n/** One allowed value of a token scale. `value` is what is stored; `label` is the short readout (\"XL\"). */\nexport interface ScaleStep {\n  value: string;\n  label: string;\n  /** Long name for screen readers and tooltips (\"Extra large\"). Defaults to `label`. */\n  title?: string;\n  /** Resolved size in px, shown as \"XL · 48px\" and used to place custom values on the track. */\n  px?: number;\n  /** Resolved CSS when it isn't px (e.g. \"100vh\", \"var(--space-xl)\"). */\n  css?: string;\n}\n\n/** A stepped numeric range (continuous with snapping). The stored value is a bare number in `defaultUnit`. */\nexport interface ScaleRange {\n  min: number;\n  max: number;\n  step?: number;\n}\n\n/** Bounds for the custom escape hatch. min / max may be one number or per unit ({ px: 0, \"%\": 0 }). */\nexport interface ScaleCustom {\n  min?: number | Partial<Record<ScaleUnit, number>>;\n  max?: number | Partial<Record<ScaleUnit, number>>;\n  /** Units the editor may type. Defaults to the scale's `units`. */\n  units?: ScaleUnit[];\n  /** Arrow-key nudge (Shift ×10, Alt ×0.1). Default 1. */\n  step?: number;\n}\n\nexport interface ScaleSchema {\n  /** Token steps (S M L XL 2XL) or a numeric range ({ min, max, step }). */\n  steps: ScaleStep[] | ScaleRange;\n  /** Units of the scale; the first is the default. A range with no units is unitless. */\n  units?: ScaleUnit[];\n  defaultUnit?: ScaleUnit;\n  /** false (default) = fixed only: the editor can pick only the allowed values. true / object = fixed + custom. */\n  allowCustom?: boolean | ScaleCustom;\n  /** Quick picks in the unit menu when custom is allowed (\"50%\", \"100vh\"). */\n  presets?: { label?: string; value: ScaleValue }[];\n}\n\n/**\n * How a scale value is STORED — three shapes, told apart by `typeof`, so tokens and custom values never collide and\n * older data (bare token strings, bare numbers) is already valid:\n *  - token  → the step's value string   (\"xl\")\n *  - range  → a bare number in the default unit (15 → 15%)\n *  - custom → an object                 ({ value: 200, unit: \"px\" })\n */\nexport type ScaleValue = string | number | ScaleCustomValue;\nexport interface ScaleCustomValue {\n  value: number;\n  unit: ScaleUnit;\n}\n\nexport interface Fieldset {\n  name: string;\n  title: string;\n  description?: string;\n  collapsed?: boolean; // collapsed by default\n  columns?: 1 | 2; // short fields side by side\n  /** CPO D45: the header toggles the section (default true). false = a static heading for 2–3 fields that are always needed. */\n  collapsible?: boolean;\n  /**\n   * CPO D45: \"breakpoints\" = the members are objects, one per screen size (desktop · tablet · phone), shown as ONE group with a\n   * segmented switcher instead of three stacked groups. Sibling objects named desktop / laptop / tablet / mobile / phone get\n   * this automatically.\n   */\n  layout?: \"stack\" | \"breakpoints\";\n}\n\nexport interface FieldGroup {\n  name: string;\n  title: string;\n  icon?: string;\n  default?: boolean;\n}\n\n/** A developer-defined layout of a block (swap without losing content). */\nexport interface BlockVariant {\n  id: string;\n  name: string;\n  description?: string;\n}\n\n/** A document/block type. */\nexport interface TypeSchema {\n  name: string; // e.g. \"hero\", \"journalStory\"\n  title: string;\n  kind: \"block\" | \"page\" | \"entry\" | \"global\" | \"object\";\n  icon?: string;\n  description?: string;\n  fields: FieldSchema[];\n  fieldsets?: Fieldset[];\n  groups?: FieldGroup[];\n  preview?: PreviewConfig;\n  /* ── additive (Block Kit v1) ── */\n  /** Block variants (layouts) — shown as a chip on slot rows and a switcher in the block frame. */\n  variants?: BlockVariant[];\n  /** Block picker category (\"Layout\", \"Content\", \"Media\"…). */\n  category?: string;\n  /**\n   * kind \"block\" only (CPO D55): where the block fits. \"inline\" = it fits a text column, so a rich-text body lists it in\n   * the Insert menu's Article group. \"section\" (default) = page-width, reachable in a body only through More components.\n   * \"page\" = a whole page or a feed of other content; never inside a body.\n   */\n  placement?: \"inline\" | \"section\" | \"page\";\n  /** Starting value for a new instance (block added to a slot, new document). */\n  initialValue?: Record<string, unknown>;\n}\n\n/** Every array item / slot child carries a stable key. Slot children also carry their block type. */\nexport interface KeyedItem {\n  _key?: string;\n  /** item type name (arrays with several `of` types) or block type (slots) */\n  _type?: string;\n}\n/** A block inside a slot: its own props at the root, plus variant and per-slot layout settings. */\nexport interface SlotChild extends KeyedItem {\n  _type: string;\n  _variant?: string;\n  _settings?: Record<string, unknown>;\n  [prop: string]: unknown;\n}\n\n/** Path from the root document/block to the field being edited, e.g. [\"items\", 1, \"answer\"] */\nexport type FieldPath = (string | number)[];\n\n/** One crumb in the inspector/editor breadcrumb (drill-in navigation stack). */\nexport interface Crumb {\n  path: FieldPath;\n  title: string;\n  icon?: string;\n  /** tableGroup / tableRow / tableColumn: a table field's rows and columns drill like array items (D50) */\n  kind: \"root\" | \"object\" | \"item\" | \"block\" | \"button\" | \"history\" | \"tableGroup\" | \"tableRow\" | \"tableColumn\";\n}\n\n/** Reserved path segment: the field's version history as a stacked panel, e.g. [\"title\", \"@history\"]. */\nexport const HISTORY_SEGMENT = \"@history\";\n"],"mappings":";;AAsNA,IAAa,YAAyB,EAAE,MAAM,gBAAgB;;AAE9D,IAAa,iBAA8B;CAAE,MAAM;CAAe,MAAM;AAAgB;;AA8IxF,IAAa,kBAAkB"}