@elytracms/studio 0.0.91 → 0.0.93

package/dist/components/cms/duplicate-document.js

@@ -1,3 +1,4 @@
+import { slugFieldOf } from '@elytracms/core/cms-core';
 /**
  * EC-442 — the duplicate-document derivation (pure core) + the source-composed
  * dispatch behind the list row `⋮` menu's and the detail-editor header's
@@ -24,22 +25,13 @@
  *   derivation never blocks a create.
  * - Composition (`blocks`) field values copy VERBATIM (deep clone): node ids
  *   only need uniqueness within one composition value (`validateCompositionValue`
- *   checks duplicates per value; the builder's fresh-id counter re-derives from
- *   the open value via `maxNodeIdSeq`), so identical node ids across two
- *   documents collide nowhere.
+ *   checks duplicates per value; the builder mints fresh ids from the injected
+ *   UUID factory, EC-578), so identical node ids across two documents collide
+ *   nowhere.
  * - References/relations copy as-is (the duplicate points at the same targets);
  *   the EC-277 in-transaction reference derivation indexes the new document on
  *   its first persisted write because it catches every writer.
  */
-/** The conventional slug field name (mirrors `field-control`'s slug auto-upgrade). */
-const SLUG_FIELD_NAME = 'slug';
-/** The built-in control name that opts any `text` field into slug behaviour (EC-315). */
-const SLUG_CONTROL = 'slug';
-/** The EC-315 slug-field convention: a `text` field named `slug`, or any `text`
- *  field with `form.control: 'slug'` (same predicate as the studio slug control). */
-function isSlugField(field) {
-    return (field.type === 'text' && (field.form?.control === SLUG_CONTROL || field.name === SLUG_FIELD_NAME));
-}
 /**
  * Every slug string the collection already holds for `fieldName` — the base
  * `values` slot AND every per-locale slot of every sibling (the original
@@ -103,39 +95,39 @@ export function deriveDuplicateDocument({ original, newId, schema, siblings, })
         ...(original.localized !== undefined ? { localized: structuredClone(original.localized) } : {}),
         // `alias` deliberately dropped (unique slot handle — see module doc).
     };
-    for (const field of schema.fields) {
-        if (!isSlugField(field))
-            continue;
-        const pool = slugPool(field.name, siblings);
-        uniquifySlot(duplicate.values, field.name, pool);
+    // EC-590: the collection's SLUG ROLE (`slugField`, default a text field named `slug`)
+    // — the one field routing reads, so the one a duplicate must make unique.
+    const slugField = slugFieldOf(schema)?.name;
+    if (slugField !== undefined) {
+        const pool = slugPool(slugField, siblings);
+        uniquifySlot(duplicate.values, slugField, pool);
         for (const localeValues of Object.values(duplicate.localized ?? {})) {
-            uniquifySlot(localeValues, field.name, pool);
+            uniquifySlot(localeValues, slugField, pool);
         }
     }
     return duplicate;
 }
 /**
  * Duplicate `original` through a {@link CollectionViewSource} — the ONE dispatch
- * both surfaces (list row menu, detail-editor header) share. Composes the seam's
- * EXISTING write paths, never a parallel one (AD-17):
+ * both surfaces (list row menu, detail-editor header) share (EC-595 A2):
  *
- * 1. `source.create()` mints the fresh id + inserts the rail's blank record
- *    (the same collision-free mint the New button uses);
- * 2. `source.save(derived)` lands the copied values under that id (the CMS
- *    save is a replace-or-append upsert; a rail save persists its draft).
+ * 1. a fresh id from the session's injected factory (`writes.newId`, EC-578 — UUIDs, so
+ *    two sessions duplicating at once can never mint the same id);
+ * 2. ONE whole-document create — insert-if-absent (`writes.insert` →
+ *    `documents.replace` `{ ifAbsent: true }`), never an overwrite. (It used to be a
+ *    blank `create()` followed by a whole-document save — two writes.)
  *
- * The session store applies both optimistically, so the new row is visible
- * without a reload, and the persister mirrors them onto the operations facade
- * with the user's session — no new trust boundary. Callers gate on the
- * explicit `capabilities.duplicate` flag (the row-menu vocabulary / the header
- * gate) before dispatching — CMS collections only (owner call 2026-07-17;
- * every primitive rail declares `duplicate: false`).
+ * The session shows the new row at once (the persister's optimistic view). Callers
+ * gate on the explicit `capabilities.duplicate` flag (the row-menu vocabulary / the
+ * header gate) before dispatching — CMS collections only (owner call 2026-07-17; every
+ * primitive rail declares `duplicate: false` and writes records, so `undefined`).
  */
 export function duplicateFromSource(source, original) {
-    // Snapshot the slug pool BEFORE create() inserts the blank record.
+    if (source.writes.kind !== 'document')
+        return undefined;
     const siblings = source.documents();
-    const ref = source.create();
-    source.save(deriveDuplicateDocument({ original, newId: ref.id, schema: source.schema, siblings }));
-    return ref;
+    const id = source.writes.newId();
+    source.writes.insert(deriveDuplicateDocument({ original, newId: id, schema: source.schema, siblings }));
+    return { collection: source.collectionId, id };
 }
 //# sourceMappingURL=duplicate-document.js.map

package/dist/components/cms/duplicate-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"duplicate-document.js","sourceRoot":"","sources":["../../../src/components/cms/duplicate-document.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CmsDocument, CollectionDef, DocumentRef, FieldDef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\n\n/**\n * EC-442 — the duplicate-document derivation (pure core) + the source-composed\n * dispatch behind the list row `⋮` menu's and the detail-editor header's\n * **Duplicate** action.\n *\n * Semantics (ratified 2026-07-17):\n * - The duplicate copies the current DRAFT field values — `values` plus\n *   `localized` across ALL locales — into a fresh document id (EC-580 deleted the\n *   per-document `defaultLocale` this used to copy). It is created as a **draft, never auto-published** (\"live is\n *   published-only\"): published-ness is the version pointer (EC-224), and\n *   nothing here touches it.\n * - `alias` is deliberately NOT copied: an alias is a unique-within-collection\n *   slot handle (EC-284) — code addresses THE document holding it, and a copied\n *   alias would immediately surface as uniqueness drift. The duplicate is new\n *   content, not the slot holder.\n * - **Slug strategy: uniquify, never clear.** Every slug field (a `text` field\n *   named `slug` or opted in via `form.control: 'slug'` — the EC-315\n *   convention) gets a deterministic `-copy` / `-copy-2` / … suffix walked past\n *   every slug string the collection already holds (base values AND every\n *   locale variant of every sibling). Rationale: a cleared slug lands the new\n *   draft in an error-looking validation state, while a uniquified one reads as\n *   what it is (\"about-copy\") and keeps the draft one review away from\n *   publishable. A missing/duplicate slug stays publish-gating only — this\n *   derivation never blocks a create.\n * - Composition (`blocks`) field values copy VERBATIM (deep clone): node ids\n *   only need uniqueness within one composition value (`validateCompositionValue`\n *   checks duplicates per value; the builder's fresh-id counter re-derives from\n *   the open value via `maxNodeIdSeq`), so identical node ids across two\n *   documents collide nowhere.\n * - References/relations copy as-is (the duplicate points at the same targets);\n *   the EC-277 in-transaction reference derivation indexes the new document on\n *   its first persisted write because it catches every writer.\n */\n\n/** The conventional slug field name (mirrors `field-control`'s slug auto-upgrade). */\nconst SLUG_FIELD_NAME = 'slug'\n/** The built-in control name that opts any `text` field into slug behaviour (EC-315). */\nconst SLUG_CONTROL = 'slug'\n\n/** The EC-315 slug-field convention: a `text` field named `slug`, or any `text`\n *  field with `form.control: 'slug'` (same predicate as the studio slug control). */\nfunction isSlugField(field: FieldDef): boolean {\n  return (\n    field.type === 'text' && (field.form?.control === SLUG_CONTROL || field.name === SLUG_FIELD_NAME)\n  )\n}\n\n/**\n * Every slug string the collection already holds for `fieldName` — the base\n * `values` slot AND every per-locale slot of every sibling (the original\n * included). A union pool across locales is deliberately conservative: a\n * candidate free in the pool can never collide with any sibling in any locale,\n * including through the EC-018 base-value fallback.\n */\nfunction slugPool(fieldName: string, siblings: readonly CmsDocument[]): Set<string> {\n  const pool = new Set<string>()\n  const add = (value: unknown) => {\n    if (typeof value === 'string' && value.trim() !== '') pool.add(value.trim())\n  }\n  for (const doc of siblings) {\n    add(doc.values?.[fieldName])\n    for (const localeValues of Object.values(doc.localized ?? {})) add(localeValues[fieldName])\n  }\n  return pool\n}\n\n/**\n * The deterministic duplicate slug: `<slug>-copy`, then `<slug>-copy-2`,\n * `<slug>-copy-3`, … — the first candidate not in `taken`. Pure function of\n * `(slug, taken)`, so the SAME original string in the base slot and a locale\n * slot maps to the SAME uniquified string (the duplicate keeps the original's\n * internal base/locale relationship).\n */\nexport function uniquifySlug(slug: string, taken: ReadonlySet<string>): string {\n  const base = `${slug}-copy`\n  if (!taken.has(base)) return base\n  let n = 2\n  while (taken.has(`${base}-${n}`)) n += 1\n  return `${base}-${n}`\n}\n\n/** Uniquify one stored slug slot in place; empty/non-string slots stay untouched\n *  (a missing slug remains a publish-gating issue, never a create blocker). */\nfunction uniquifySlot(\n  values: Record<string, unknown> | undefined,\n  fieldName: string,\n  pool: ReadonlySet<string>,\n): void {\n  if (!values) return\n  const raw = values[fieldName]\n  if (typeof raw !== 'string' || raw.trim() === '') return\n  values[fieldName] = uniquifySlug(raw.trim(), pool)\n}\n\nexport interface DeriveDuplicateInput {\n  /** The document being duplicated — the CURRENT draft values (list row / editor buffer). */\n  original: CmsDocument\n  /** The freshly minted id for the duplicate (source-owned, via `source.create()`). */\n  newId: string\n  /** The collection schema — identifies the slug fields to uniquify. */\n  schema: CollectionDef\n  /** The collection's current rows (the original included) — the slug pool. */\n  siblings: readonly CmsDocument[]\n}\n\n/**\n * Derive the duplicate document (pure): deep-copied `values` + `localized` (all\n * locales) under the fresh id, `alias` dropped, every slug field's stored slots\n * uniquified against the collection's slug pool. (EC-580: there is no per-document\n * `defaultLocale` to copy — the project's config is the only default.) See the\n * module doc for the ratified semantics each rule pins.\n */\nexport function deriveDuplicateDocument({\n  original,\n  newId,\n  schema,\n  siblings,\n}: DeriveDuplicateInput): CmsDocument {\n  const duplicate: CmsDocument = {\n    collection: original.collection,\n    id: newId,\n    // Deep clones: composition trees, rich text, nested objects/arrays must be\n    // independent of the original (editing one must never mutate the other).\n    values: structuredClone(original.values ?? {}),\n    ...(original.localized !== undefined ? { localized: structuredClone(original.localized) } : {}),\n    // `alias` deliberately dropped (unique slot handle — see module doc).\n  }\n  for (const field of schema.fields) {\n    if (!isSlugField(field)) continue\n    const pool = slugPool(field.name, siblings)\n    uniquifySlot(duplicate.values, field.name, pool)\n    for (const localeValues of Object.values(duplicate.localized ?? {})) {\n      uniquifySlot(localeValues, field.name, pool)\n    }\n  }\n  return duplicate\n}\n\n/**\n * Duplicate `original` through a {@link CollectionViewSource} — the ONE dispatch\n * both surfaces (list row menu, detail-editor header) share. Composes the seam's\n * EXISTING write paths, never a parallel one (AD-17):\n *\n * 1. `source.create()` mints the fresh id + inserts the rail's blank record\n *    (the same collision-free mint the New button uses);\n * 2. `source.save(derived)` lands the copied values under that id (the CMS\n *    save is a replace-or-append upsert; a rail save persists its draft).\n *\n * The session store applies both optimistically, so the new row is visible\n * without a reload, and the persister mirrors them onto the operations facade\n * with the user's session — no new trust boundary. Callers gate on the\n * explicit `capabilities.duplicate` flag (the row-menu vocabulary / the header\n * gate) before dispatching — CMS collections only (owner call 2026-07-17;\n * every primitive rail declares `duplicate: false`).\n */\nexport function duplicateFromSource(\n  source: CollectionViewSource,\n  original: CmsDocument,\n): DocumentRef {\n  // Snapshot the slug pool BEFORE create() inserts the blank record.\n  const siblings = source.documents()\n  const ref = source.create()\n  source.save(deriveDuplicateDocument({ original, newId: ref.id, schema: source.schema, siblings }))\n  return ref\n}\n"]}
+{"version":3,"file":"duplicate-document.js","sourceRoot":"","sources":["../../../src/components/cms/duplicate-document.ts"],"names":[],"mappings":"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","sourcesContent":["import { slugFieldOf } from '@elytracms/core/cms-core'\nimport type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core'\nimport type { CollectionViewSource } from '@elytracms/studio/lib/collection-view/collection-view-source'\n\n/**\n * EC-442 — the duplicate-document derivation (pure core) + the source-composed\n * dispatch behind the list row `⋮` menu's and the detail-editor header's\n * **Duplicate** action.\n *\n * Semantics (ratified 2026-07-17):\n * - The duplicate copies the current DRAFT field values — `values` plus\n *   `localized` across ALL locales — into a fresh document id (EC-580 deleted the\n *   per-document `defaultLocale` this used to copy). It is created as a **draft, never auto-published** (\"live is\n *   published-only\"): published-ness is the version pointer (EC-224), and\n *   nothing here touches it.\n * - `alias` is deliberately NOT copied: an alias is a unique-within-collection\n *   slot handle (EC-284) — code addresses THE document holding it, and a copied\n *   alias would immediately surface as uniqueness drift. The duplicate is new\n *   content, not the slot holder.\n * - **Slug strategy: uniquify, never clear.** Every slug field (a `text` field\n *   named `slug` or opted in via `form.control: 'slug'` — the EC-315\n *   convention) gets a deterministic `-copy` / `-copy-2` / … suffix walked past\n *   every slug string the collection already holds (base values AND every\n *   locale variant of every sibling). Rationale: a cleared slug lands the new\n *   draft in an error-looking validation state, while a uniquified one reads as\n *   what it is (\"about-copy\") and keeps the draft one review away from\n *   publishable. A missing/duplicate slug stays publish-gating only — this\n *   derivation never blocks a create.\n * - Composition (`blocks`) field values copy VERBATIM (deep clone): node ids\n *   only need uniqueness within one composition value (`validateCompositionValue`\n *   checks duplicates per value; the builder mints fresh ids from the injected\n *   UUID factory, EC-578), so identical node ids across two documents collide\n *   nowhere.\n * - References/relations copy as-is (the duplicate points at the same targets);\n *   the EC-277 in-transaction reference derivation indexes the new document on\n *   its first persisted write because it catches every writer.\n */\n\n\n/**\n * Every slug string the collection already holds for `fieldName` — the base\n * `values` slot AND every per-locale slot of every sibling (the original\n * included). A union pool across locales is deliberately conservative: a\n * candidate free in the pool can never collide with any sibling in any locale,\n * including through the EC-018 base-value fallback.\n */\nfunction slugPool(fieldName: string, siblings: readonly CmsDocument[]): Set<string> {\n  const pool = new Set<string>()\n  const add = (value: unknown) => {\n    if (typeof value === 'string' && value.trim() !== '') pool.add(value.trim())\n  }\n  for (const doc of siblings) {\n    add(doc.values?.[fieldName])\n    for (const localeValues of Object.values(doc.localized ?? {})) add(localeValues[fieldName])\n  }\n  return pool\n}\n\n/**\n * The deterministic duplicate slug: `<slug>-copy`, then `<slug>-copy-2`,\n * `<slug>-copy-3`, … — the first candidate not in `taken`. Pure function of\n * `(slug, taken)`, so the SAME original string in the base slot and a locale\n * slot maps to the SAME uniquified string (the duplicate keeps the original's\n * internal base/locale relationship).\n */\nexport function uniquifySlug(slug: string, taken: ReadonlySet<string>): string {\n  const base = `${slug}-copy`\n  if (!taken.has(base)) return base\n  let n = 2\n  while (taken.has(`${base}-${n}`)) n += 1\n  return `${base}-${n}`\n}\n\n/** Uniquify one stored slug slot in place; empty/non-string slots stay untouched\n *  (a missing slug remains a publish-gating issue, never a create blocker). */\nfunction uniquifySlot(\n  values: Record<string, unknown> | undefined,\n  fieldName: string,\n  pool: ReadonlySet<string>,\n): void {\n  if (!values) return\n  const raw = values[fieldName]\n  if (typeof raw !== 'string' || raw.trim() === '') return\n  values[fieldName] = uniquifySlug(raw.trim(), pool)\n}\n\nexport interface DeriveDuplicateInput {\n  /** The document being duplicated — the CURRENT draft values (list row / editor buffer). */\n  original: CmsDocument\n  /** The freshly minted id for the duplicate (source-owned, via `source.create()`). */\n  newId: string\n  /** The collection schema — identifies the slug fields to uniquify. */\n  schema: CollectionDef\n  /** The collection's current rows (the original included) — the slug pool. */\n  siblings: readonly CmsDocument[]\n}\n\n/**\n * Derive the duplicate document (pure): deep-copied `values` + `localized` (all\n * locales) under the fresh id, `alias` dropped, every slug field's stored slots\n * uniquified against the collection's slug pool. (EC-580: there is no per-document\n * `defaultLocale` to copy — the project's config is the only default.) See the\n * module doc for the ratified semantics each rule pins.\n */\nexport function deriveDuplicateDocument({\n  original,\n  newId,\n  schema,\n  siblings,\n}: DeriveDuplicateInput): CmsDocument {\n  const duplicate: CmsDocument = {\n    collection: original.collection,\n    id: newId,\n    // Deep clones: composition trees, rich text, nested objects/arrays must be\n    // independent of the original (editing one must never mutate the other).\n    values: structuredClone(original.values ?? {}),\n    ...(original.localized !== undefined ? { localized: structuredClone(original.localized) } : {}),\n    // `alias` deliberately dropped (unique slot handle — see module doc).\n  }\n  // EC-590: the collection's SLUG ROLE (`slugField`, default a text field named `slug`)\n  // — the one field routing reads, so the one a duplicate must make unique.\n  const slugField = slugFieldOf(schema)?.name\n  if (slugField !== undefined) {\n    const pool = slugPool(slugField, siblings)\n    uniquifySlot(duplicate.values, slugField, pool)\n    for (const localeValues of Object.values(duplicate.localized ?? {})) {\n      uniquifySlot(localeValues, slugField, pool)\n    }\n  }\n  return duplicate\n}\n\n/**\n * Duplicate `original` through a {@link CollectionViewSource} — the ONE dispatch\n * both surfaces (list row menu, detail-editor header) share (EC-595 A2):\n *\n * 1. a fresh id from the session's injected factory (`writes.newId`, EC-578 — UUIDs, so\n *    two sessions duplicating at once can never mint the same id);\n * 2. ONE whole-document create — insert-if-absent (`writes.insert` →\n *    `documents.replace` `{ ifAbsent: true }`), never an overwrite. (It used to be a\n *    blank `create()` followed by a whole-document save — two writes.)\n *\n * The session shows the new row at once (the persister's optimistic view). Callers\n * gate on the explicit `capabilities.duplicate` flag (the row-menu vocabulary / the\n * header gate) before dispatching — CMS collections only (owner call 2026-07-17; every\n * primitive rail declares `duplicate: false` and writes records, so `undefined`).\n */\nexport function duplicateFromSource(\n  source: CollectionViewSource,\n  original: CmsDocument,\n): DocumentRef | undefined {\n  if (source.writes.kind !== 'document') return undefined\n  const siblings = source.documents()\n  const id = source.writes.newId()\n  source.writes.insert(deriveDuplicateDocument({ original, newId: id, schema: source.schema, siblings }))\n  return { collection: source.collectionId, id }\n}\n"]}

package/dist/components/cms/field-anchors.d.ts

@@ -59,9 +59,12 @@ export declare function isPathWithin(itemPath: string, focusPath: string): boole
 /**
  * Walk a parsed field path down the schema and return the DEEPEST resolvable
  * field def: numeric tokens step into an array item (same def), name tokens
- * descend into an `object` field's subfields. An unknown token stops the walk
- * at the last resolved def (label degradation mirrors anchor degradation);
- * an unknown top-level field is `null`. Rich-text node paths therefore resolve
- * to the rich-text field itself.
+ * descend into a sub-field — of an `object` (one item or a repeater's) or of an
+ * `asset` placement (EC-582 / EC-572 #1: an asset sub-field issue now anchors at the
+ * sub-field's input, not the asset field). The step is cms-core's ONE definition
+ * descent (`descendFieldDefinition`, the value-position grammar's continuation) — no
+ * second schema walk here. An unknown token stops the walk at the last resolved def
+ * (label degradation mirrors anchor degradation); an unknown top-level field is
+ * `null`. Rich-text node paths therefore resolve to the rich-text field itself.
  */
 export declare function resolveFieldDefAtPath(collection: CollectionDef, field: string, rest: readonly string[]): FieldDef | null;

package/dist/components/cms/field-anchors.js

@@ -1,4 +1,5 @@
 import { createContext, useContext } from 'react';
+import { descendFieldDefinition } from '@elytracms/core/cms-core';
 import { FIELD_PATH_ATTR } from '@elytracms/studio/ui';
 /**
  * EC-443 — the pure core of path-aware jump-to-field.
@@ -67,10 +68,13 @@ export function isPathWithin(itemPath, focusPath) {
 /**
  * Walk a parsed field path down the schema and return the DEEPEST resolvable
  * field def: numeric tokens step into an array item (same def), name tokens
- * descend into an `object` field's subfields. An unknown token stops the walk
- * at the last resolved def (label degradation mirrors anchor degradation);
- * an unknown top-level field is `null`. Rich-text node paths therefore resolve
- * to the rich-text field itself.
+ * descend into a sub-field — of an `object` (one item or a repeater's) or of an
+ * `asset` placement (EC-582 / EC-572 #1: an asset sub-field issue now anchors at the
+ * sub-field's input, not the asset field). The step is cms-core's ONE definition
+ * descent (`descendFieldDefinition`, the value-position grammar's continuation) — no
+ * second schema walk here. An unknown token stops the walk at the last resolved def
+ * (label degradation mirrors anchor degradation); an unknown top-level field is
+ * `null`. Rich-text node paths therefore resolve to the rich-text field itself.
  */
 export function resolveFieldDefAtPath(collection, field, rest) {
     let current = collection.fields.find((f) => f.name === field);
@@ -79,9 +83,7 @@ export function resolveFieldDefAtPath(collection, field, rest) {
     for (const token of rest) {
         if (/^\d+$/.test(token))
             continue;
-        if (current.type !== 'object')
-            break;
-        const sub = current.fields.find((f) => f.name === token);
+        const sub = descendFieldDefinition(current, [token]);
         if (sub === undefined)
             break;
         current = sub;

package/dist/components/cms/field-anchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-anchors.js","sourceRoot":"","sources":["../../../src/components/cms/field-anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iFAAiF;AAEjF,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAA;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAkB,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;AAY7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAA6B,EAAE,CACjE,UAAU,CAAC,wBAAwB,CAAC,CAAA;AAEtC,iFAAiF;AAEjF,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,eAAe,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAuB;IACrE,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA6B,EAC7B,MAAiC;IAEjC,KAAK,MAAM,SAAS,IAAI,UAAU;QAAE,IAAI,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAC3E,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAiB;IAC9D,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAyB,EACzB,KAAa,EACb,IAAuB;IAEvB,IAAI,OAAO,GAAyB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;IACnF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACjC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAK;QACpC,MAAM,GAAG,GAAyB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;QAC9E,IAAI,GAAG,KAAK,SAAS;YAAE,MAAK;QAC5B,OAAO,GAAG,GAAG,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import { createContext, useContext } from 'react'\nimport type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport { FIELD_PATH_ATTR } from '@elytracms/studio/ui'\n\n/**\n * EC-443 — the pure core of path-aware jump-to-field.\n *\n * The anchor convention itself (`data-ec-field-path=\"<field>(/<token>)*\"`) is\n * defined ONCE, on {@link FIELD_PATH_ATTR} in `ui/field.tsx` — read its doc\n * comment before touching anything here. This module carries the shared\n * plumbing around it:\n *\n * - {@link FieldPathContext}: the current anchor-path prefix, threaded through\n *   the recursive object/repeater controls so each nested row knows its own\n *   full path without prop-drilling. `null` outside a stamped surface (e.g.\n *   the canvas prop inspector), where no anchors are stamped.\n * - {@link FieldFocusRequestContext}: the active focus request (set by\n *   `useFieldFocus`), which drives BOTH collapsed-array auto-expansion en\n *   route and the ring highlight on the exact nested control.\n * - The pure focus-plan decisions (`anchorCandidates`,\n *   `deepestExistingAnchor`, `isPathWithin`, `resolveFieldDefAtPath`) — no\n *   DOM, directly pinned in `use-field-focus.test.ts`.\n */\n\n// --- Contexts -----------------------------------------------------------------\n\n/** The anchor-path prefix for the controls below this point (see module doc). */\nexport const FieldPathContext = createContext<string | null>(null)\nexport const useFieldPath = (): string | null => useContext(FieldPathContext)\n\n/**\n * The in-flight jump-to-field request. `path` is a full anchor path\n * (`links/3/badge/text`); `nonce` distinguishes back-to-back jumps to the same\n * path (a re-click must re-expand a manually collapsed item). Cleared when the\n * highlight window ends.\n */\nexport interface FieldFocusRequest {\n  path: string\n  nonce: number\n}\nexport const FieldFocusRequestContext = createContext<FieldFocusRequest | null>(null)\nexport const useFieldFocusRequest = (): FieldFocusRequest | null =>\n  useContext(FieldFocusRequestContext)\n\n// --- Pure focus-plan decisions ------------------------------------------------\n\n/** CSS selector for one stamped anchor path. */\nexport function fieldAnchorSelector(path: string): string {\n  return `[${FIELD_PATH_ATTR}=\"${path.replace(/\"/g, '\\\\\"')}\"]`\n}\n\n/**\n * The anchor lookup order for a parsed field path: every prefix, deepest\n * first, down to the top-level field itself — the graceful-degradation ladder\n * (`links/3/badge/text` → `links/3/badge` → `links/3` → `links`). The\n * top-level field is additionally always reachable via its `#f-<name>`\n * control id, which is the ultimate floor.\n */\nexport function anchorCandidates(field: string, rest: readonly string[]): string[] {\n  const out: string[] = []\n  for (let depth = rest.length; depth >= 0; depth--) {\n    out.push([field, ...rest.slice(0, depth)].join('/'))\n  }\n  return out\n}\n\n/**\n * The deepest candidate that exists right now (`exists` = a DOM probe in\n * production, a fake in tests), or `null` when none does. Combined with\n * {@link anchorCandidates} this IS the degradation decision: deepest existing\n * anchor wins, the top-level field is the floor, never a no-op.\n */\nexport function deepestExistingAnchor(\n  candidates: readonly string[],\n  exists: (path: string) => boolean,\n): string | null {\n  for (const candidate of candidates) if (exists(candidate)) return candidate\n  return null\n}\n\n/**\n * Is `focusPath` at or below `itemPath`? Token-prefix semantics (`links/3`\n * contains `links/3/badge/text` but NOT `links/31`) — the expansion decision a\n * collapsed array item uses to auto-open on the way to a nested target.\n */\nexport function isPathWithin(itemPath: string, focusPath: string): boolean {\n  return focusPath === itemPath || focusPath.startsWith(`${itemPath}/`)\n}\n\n/**\n * Walk a parsed field path down the schema and return the DEEPEST resolvable\n * field def: numeric tokens step into an array item (same def), name tokens\n * descend into an `object` field's subfields. An unknown token stops the walk\n * at the last resolved def (label degradation mirrors anchor degradation);\n * an unknown top-level field is `null`. Rich-text node paths therefore resolve\n * to the rich-text field itself.\n */\nexport function resolveFieldDefAtPath(\n  collection: CollectionDef,\n  field: string,\n  rest: readonly string[],\n): FieldDef | null {\n  let current: FieldDef | undefined = collection.fields.find((f) => f.name === field)\n  if (current === undefined) return null\n  for (const token of rest) {\n    if (/^\\d+$/.test(token)) continue\n    if (current.type !== 'object') break\n    const sub: FieldDef | undefined = current.fields.find((f) => f.name === token)\n    if (sub === undefined) break\n    current = sub\n  }\n  return current\n}\n"]}
+{"version":3,"file":"field-anchors.js","sourceRoot":"","sources":["../../../src/components/cms/field-anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iFAAiF;AAEjF,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAA;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAkB,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAA;AAY7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAA6B,EAAE,CACjE,UAAU,CAAC,wBAAwB,CAAC,CAAA;AAEtC,iFAAiF;AAEjF,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,eAAe,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAuB;IACrE,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAA6B,EAC7B,MAAiC;IAEjC,KAAK,MAAM,SAAS,IAAI,UAAU;QAAE,IAAI,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAC3E,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAiB;IAC9D,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAyB,EACzB,KAAa,EACb,IAAuB;IAEvB,IAAI,OAAO,GAAyB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;IACnF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACjC,MAAM,GAAG,GAAyB,sBAAsB,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1E,IAAI,GAAG,KAAK,SAAS;YAAE,MAAK;QAC5B,OAAO,GAAG,GAAG,CAAA;IACf,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import { createContext, useContext } from 'react'\nimport { descendFieldDefinition } from '@elytracms/core/cms-core'\nimport type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport { FIELD_PATH_ATTR } from '@elytracms/studio/ui'\n\n/**\n * EC-443 — the pure core of path-aware jump-to-field.\n *\n * The anchor convention itself (`data-ec-field-path=\"<field>(/<token>)*\"`) is\n * defined ONCE, on {@link FIELD_PATH_ATTR} in `ui/field.tsx` — read its doc\n * comment before touching anything here. This module carries the shared\n * plumbing around it:\n *\n * - {@link FieldPathContext}: the current anchor-path prefix, threaded through\n *   the recursive object/repeater controls so each nested row knows its own\n *   full path without prop-drilling. `null` outside a stamped surface (e.g.\n *   the canvas prop inspector), where no anchors are stamped.\n * - {@link FieldFocusRequestContext}: the active focus request (set by\n *   `useFieldFocus`), which drives BOTH collapsed-array auto-expansion en\n *   route and the ring highlight on the exact nested control.\n * - The pure focus-plan decisions (`anchorCandidates`,\n *   `deepestExistingAnchor`, `isPathWithin`, `resolveFieldDefAtPath`) — no\n *   DOM, directly pinned in `use-field-focus.test.ts`.\n */\n\n// --- Contexts -----------------------------------------------------------------\n\n/** The anchor-path prefix for the controls below this point (see module doc). */\nexport const FieldPathContext = createContext<string | null>(null)\nexport const useFieldPath = (): string | null => useContext(FieldPathContext)\n\n/**\n * The in-flight jump-to-field request. `path` is a full anchor path\n * (`links/3/badge/text`); `nonce` distinguishes back-to-back jumps to the same\n * path (a re-click must re-expand a manually collapsed item). Cleared when the\n * highlight window ends.\n */\nexport interface FieldFocusRequest {\n  path: string\n  nonce: number\n}\nexport const FieldFocusRequestContext = createContext<FieldFocusRequest | null>(null)\nexport const useFieldFocusRequest = (): FieldFocusRequest | null =>\n  useContext(FieldFocusRequestContext)\n\n// --- Pure focus-plan decisions ------------------------------------------------\n\n/** CSS selector for one stamped anchor path. */\nexport function fieldAnchorSelector(path: string): string {\n  return `[${FIELD_PATH_ATTR}=\"${path.replace(/\"/g, '\\\\\"')}\"]`\n}\n\n/**\n * The anchor lookup order for a parsed field path: every prefix, deepest\n * first, down to the top-level field itself — the graceful-degradation ladder\n * (`links/3/badge/text` → `links/3/badge` → `links/3` → `links`). The\n * top-level field is additionally always reachable via its `#f-<name>`\n * control id, which is the ultimate floor.\n */\nexport function anchorCandidates(field: string, rest: readonly string[]): string[] {\n  const out: string[] = []\n  for (let depth = rest.length; depth >= 0; depth--) {\n    out.push([field, ...rest.slice(0, depth)].join('/'))\n  }\n  return out\n}\n\n/**\n * The deepest candidate that exists right now (`exists` = a DOM probe in\n * production, a fake in tests), or `null` when none does. Combined with\n * {@link anchorCandidates} this IS the degradation decision: deepest existing\n * anchor wins, the top-level field is the floor, never a no-op.\n */\nexport function deepestExistingAnchor(\n  candidates: readonly string[],\n  exists: (path: string) => boolean,\n): string | null {\n  for (const candidate of candidates) if (exists(candidate)) return candidate\n  return null\n}\n\n/**\n * Is `focusPath` at or below `itemPath`? Token-prefix semantics (`links/3`\n * contains `links/3/badge/text` but NOT `links/31`) — the expansion decision a\n * collapsed array item uses to auto-open on the way to a nested target.\n */\nexport function isPathWithin(itemPath: string, focusPath: string): boolean {\n  return focusPath === itemPath || focusPath.startsWith(`${itemPath}/`)\n}\n\n/**\n * Walk a parsed field path down the schema and return the DEEPEST resolvable\n * field def: numeric tokens step into an array item (same def), name tokens\n * descend into a sub-field — of an `object` (one item or a repeater's) or of an\n * `asset` placement (EC-582 / EC-572 #1: an asset sub-field issue now anchors at the\n * sub-field's input, not the asset field). The step is cms-core's ONE definition\n * descent (`descendFieldDefinition`, the value-position grammar's continuation) — no\n * second schema walk here. An unknown token stops the walk at the last resolved def\n * (label degradation mirrors anchor degradation); an unknown top-level field is\n * `null`. Rich-text node paths therefore resolve to the rich-text field itself.\n */\nexport function resolveFieldDefAtPath(\n  collection: CollectionDef,\n  field: string,\n  rest: readonly string[],\n): FieldDef | null {\n  let current: FieldDef | undefined = collection.fields.find((f) => f.name === field)\n  if (current === undefined) return null\n  for (const token of rest) {\n    if (/^\\d+$/.test(token)) continue\n    const sub: FieldDef | undefined = descendFieldDefinition(current, [token])\n    if (sub === undefined) break\n    current = sub\n  }\n  return current\n}\n"]}

package/dist/components/cms/field-collaboration.d.ts

@@ -0,0 +1,47 @@
+import type { ReactNode } from 'react';
+import type { ValuePath } from '@elytracms/core/cms-core';
+import type { PresenceEntry } from '@elytracms/core/persistence';
+import type { DocumentConflict } from '@elytracms/studio/lib/operations';
+/**
+ * EC-595 A2 — the field's collaboration chrome: the commit boundary (focus / blur /
+ * Enter → the commit policy, presence), the per-field conflict ("changed by X — take
+ * theirs / keep mine"), and the thin presence note ("X is in this field").
+ */
+/**
+ * The commit boundary around one field's control: focus entering it, focus LEAVING it
+ * (to anywhere outside — a picker's portal inside the control counts as inside only
+ * while its DOM is), and Enter in a single-line input are the triggers the field's
+ * commit policy reads (`commit-policy.ts`). A wrapper, so every control — built-in or a
+ * project renderer — is covered without knowing about commits.
+ */
+export declare function FieldCommitBoundary({ onFocusField, onBlurField, onEnter, children, }: {
+    onFocusField: () => void;
+    onBlurField: () => void;
+    onEnter: () => void;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Whether a position belongs to a field row (the field, any of its locale buckets / sub-positions). */
+export declare function pathInField(path: ValuePath, field: string, locale: string | undefined): boolean;
+/** The display name of a conflict's actor: a present colleague's name, "you (another tab)", or someone. */
+export declare function conflictActorName(conflict: DocumentConflict, presence: readonly PresenceEntry[], selfActor: string | undefined): string;
+/** A short, plain rendering of "theirs" for the notice (scalars verbatim, structures summarised). */
+export declare function conflictValuePreview(value: unknown): string;
+/**
+ * The per-field conflict (EC-595 binding point 5): a path this session changed was
+ * changed by someone else first, and the store refused it — the rest of the edit applied.
+ * The field keeps showing MINE until the user decides: take theirs (adopt the server
+ * value) or keep mine (re-send it at the current revision — a visible, second write).
+ * Never a whole-document dialog.
+ */
+export declare function FieldConflictNotice({ conflict, actorName, onTakeTheirs, onKeepMine, }: {
+    conflict: DocumentConflict;
+    actorName: string;
+    onTakeTheirs: () => void;
+    onKeepMine: () => void;
+}): import("react").JSX.Element;
+/** The OTHER sessions whose focused field is this one. */
+export declare function presentInField(presence: readonly PresenceEntry[], path: ValuePath): PresenceEntry[];
+/** "X is in this field" — the signal that keeps two editors out of one field (thin presence). */
+export declare function FieldPresenceNote({ entries }: {
+    entries: readonly PresenceEntry[];
+}): import("react").JSX.Element | null;

package/dist/components/cms/field-collaboration.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertTriangle, Users } from 'lucide-react';
+import { valuePathsOverlap } from '@elytracms/core/cms-core';
+import { Button, Row, Stack, Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+/**
+ * EC-595 A2 — the field's collaboration chrome: the commit boundary (focus / blur /
+ * Enter → the commit policy, presence), the per-field conflict ("changed by X — take
+ * theirs / keep mine"), and the thin presence note ("X is in this field").
+ */
+/**
+ * The commit boundary around one field's control: focus entering it, focus LEAVING it
+ * (to anywhere outside — a picker's portal inside the control counts as inside only
+ * while its DOM is), and Enter in a single-line input are the triggers the field's
+ * commit policy reads (`commit-policy.ts`). A wrapper, so every control — built-in or a
+ * project renderer — is covered without knowing about commits.
+ */
+export function FieldCommitBoundary({ onFocusField, onBlurField, onEnter, children, }) {
+    return (_jsx("div", { "data-commit-boundary": "", onFocus: (event) => {
+            if (!event.currentTarget.contains(event.relatedTarget))
+                onFocusField();
+        }, onBlur: (event) => {
+            if (!event.currentTarget.contains(event.relatedTarget))
+                onBlurField();
+        }, onKeyDown: (event) => {
+            if (event.key === 'Enter' && event.target instanceof HTMLInputElement)
+                onEnter();
+        }, children: children }));
+}
+/** Whether a position belongs to a field row (the field, any of its locale buckets / sub-positions). */
+export function pathInField(path, field, locale) {
+    const head = path[0];
+    if (!head || head.kind !== 'field' || head.name !== field)
+        return false;
+    const bucket = path[1];
+    if (bucket?.kind === 'locale' && locale !== undefined)
+        return bucket.locale === locale;
+    return true;
+}
+/** The display name of a conflict's actor: a present colleague's name, "you (another tab)", or someone. */
+export function conflictActorName(conflict, presence, selfActor) {
+    if (conflict.actor !== undefined) {
+        const named = presence.find((entry) => entry.actor === conflict.actor && entry.actorName);
+        if (named?.actorName)
+            return named.actorName;
+        if (selfActor !== undefined && conflict.actor === selfActor)
+            return translate('cms.conflict.youInAnotherTab');
+    }
+    return translate('cms.conflict.someoneElse');
+}
+/** A short, plain rendering of "theirs" for the notice (scalars verbatim, structures summarised). */
+export function conflictValuePreview(value) {
+    if (value === undefined || value === null || value === '')
+        return translate('cms.conflict.empty');
+    if (typeof value === 'string')
+        return value.length > 80 ? `${value.slice(0, 79)}…` : value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return translate('cms.conflict.structured');
+}
+/**
+ * The per-field conflict (EC-595 binding point 5): a path this session changed was
+ * changed by someone else first, and the store refused it — the rest of the edit applied.
+ * The field keeps showing MINE until the user decides: take theirs (adopt the server
+ * value) or keep mine (re-send it at the current revision — a visible, second write).
+ * Never a whole-document dialog.
+ */
+export function FieldConflictNotice({ conflict, actorName, onTakeTheirs, onKeepMine, }) {
+    const gone = conflict.reason === 'invalid' || (conflict.theirs === undefined && conflict.patch.op !== 'unset');
+    return (_jsxs(Stack, { gap: "1", className: "rounded-md border border-warning/40 bg-warning/10 p-2", "data-testid": "field-conflict", role: "alert", children: [_jsxs(Row, { gap: "2", align: "start", children: [_jsx(AlertTriangle, { "aria-hidden": true, className: "mt-0.5 size-3.5 shrink-0 text-warning" }), _jsx(Text, { size: "xs", children: gone
+                            ? translate('cms.conflict.removedBy', { name: actorName })
+                            : translate('cms.conflict.changedBy', { name: actorName }) })] }), gone ? null : (_jsx(Text, { size: "xs", tone: "muted", className: "pl-5", "data-testid": "field-conflict-theirs", children: translate('cms.conflict.theirs', { value: conflictValuePreview(conflict.theirs) }) })), _jsxs(Row, { gap: "2", className: "pl-5", children: [_jsx(Button, { size: "sm", variant: "outline", onClick: onTakeTheirs, "data-testid": "field-conflict-theirs-button", children: translate('cms.conflict.takeTheirs') }), _jsx(Button, { size: "sm", variant: "ghost", onClick: onKeepMine, "data-testid": "field-conflict-mine-button", children: translate('cms.conflict.keepMine') })] })] }));
+}
+/** The OTHER sessions whose focused field is this one. */
+export function presentInField(presence, path) {
+    return presence.filter((entry) => entry.path !== undefined && valuePathsOverlap(entry.path, path));
+}
+/** "X is in this field" — the signal that keeps two editors out of one field (thin presence). */
+export function FieldPresenceNote({ entries }) {
+    if (entries.length === 0)
+        return null;
+    const names = [...new Set(entries.map((entry) => entry.actorName ?? translate('cms.presence.someone')))];
+    return (_jsxs(Row, { gap: "1", align: "center", className: "text-info", "data-testid": "field-presence", children: [_jsx(Users, { "aria-hidden": true, className: "size-3" }), _jsx(Text, { size: "xs", className: "text-info", children: names.length === 1
+                    ? translate('cms.presence.inField', { name: names[0] })
+                    : translate('cms.presence.inFieldMany', { names: names.join(', ') }) })] }));
+}
+//# sourceMappingURL=field-collaboration.js.map

package/dist/components/cms/field-collaboration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-collaboration.js","sourceRoot":"","sources":["../../../src/components/cms/field-collaboration.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { FocusEvent, KeyboardEvent, ReactNode } from 'react'\nimport { AlertTriangle, Users } from 'lucide-react'\nimport { valuePathsOverlap } from '@elytracms/core/cms-core'\nimport type { ValuePath } from '@elytracms/core/cms-core'\nimport type { PresenceEntry } from '@elytracms/core/persistence'\nimport { Button, Row, Stack, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport type { DocumentConflict } from '@elytracms/studio/lib/operations'\n\n/**\n * EC-595 A2 — the field's collaboration chrome: the commit boundary (focus / blur /\n * Enter → the commit policy, presence), the per-field conflict (\"changed by X — take\n * theirs / keep mine\"), and the thin presence note (\"X is in this field\").\n */\n\n/**\n * The commit boundary around one field's control: focus entering it, focus LEAVING it\n * (to anywhere outside — a picker's portal inside the control counts as inside only\n * while its DOM is), and Enter in a single-line input are the triggers the field's\n * commit policy reads (`commit-policy.ts`). A wrapper, so every control — built-in or a\n * project renderer — is covered without knowing about commits.\n */\nexport function FieldCommitBoundary({\n  onFocusField,\n  onBlurField,\n  onEnter,\n  children,\n}: {\n  onFocusField: () => void\n  onBlurField: () => void\n  onEnter: () => void\n  children: ReactNode\n}) {\n  return (\n    <div\n      data-commit-boundary=\"\"\n      onFocus={(event: FocusEvent<HTMLDivElement>) => {\n        if (!event.currentTarget.contains(event.relatedTarget as Node | null)) onFocusField()\n      }}\n      onBlur={(event: FocusEvent<HTMLDivElement>) => {\n        if (!event.currentTarget.contains(event.relatedTarget as Node | null)) onBlurField()\n      }}\n      onKeyDown={(event: KeyboardEvent<HTMLDivElement>) => {\n        if (event.key === 'Enter' && event.target instanceof HTMLInputElement) onEnter()\n      }}\n    >\n      {children}\n    </div>\n  )\n}\n\n/** Whether a position belongs to a field row (the field, any of its locale buckets / sub-positions). */\nexport function pathInField(path: ValuePath, field: string, locale: string | undefined): boolean {\n  const head = path[0]\n  if (!head || head.kind !== 'field' || head.name !== field) return false\n  const bucket = path[1]\n  if (bucket?.kind === 'locale' && locale !== undefined) return bucket.locale === locale\n  return true\n}\n\n/** The display name of a conflict's actor: a present colleague's name, \"you (another tab)\", or someone. */\nexport function conflictActorName(\n  conflict: DocumentConflict,\n  presence: readonly PresenceEntry[],\n  selfActor: string | undefined,\n): string {\n  if (conflict.actor !== undefined) {\n    const named = presence.find((entry) => entry.actor === conflict.actor && entry.actorName)\n    if (named?.actorName) return named.actorName\n    if (selfActor !== undefined && conflict.actor === selfActor) return translate('cms.conflict.youInAnotherTab')\n  }\n  return translate('cms.conflict.someoneElse')\n}\n\n/** A short, plain rendering of \"theirs\" for the notice (scalars verbatim, structures summarised). */\nexport function conflictValuePreview(value: unknown): string {\n  if (value === undefined || value === null || value === '') return translate('cms.conflict.empty')\n  if (typeof value === 'string') return value.length > 80 ? `${value.slice(0, 79)}…` : value\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  return translate('cms.conflict.structured')\n}\n\n/**\n * The per-field conflict (EC-595 binding point 5): a path this session changed was\n * changed by someone else first, and the store refused it — the rest of the edit applied.\n * The field keeps showing MINE until the user decides: take theirs (adopt the server\n * value) or keep mine (re-send it at the current revision — a visible, second write).\n * Never a whole-document dialog.\n */\nexport function FieldConflictNotice({\n  conflict,\n  actorName,\n  onTakeTheirs,\n  onKeepMine,\n}: {\n  conflict: DocumentConflict\n  actorName: string\n  onTakeTheirs: () => void\n  onKeepMine: () => void\n}) {\n  const gone = conflict.reason === 'invalid' || (conflict.theirs === undefined && conflict.patch.op !== 'unset')\n  return (\n    <Stack\n      gap=\"1\"\n      className=\"rounded-md border border-warning/40 bg-warning/10 p-2\"\n      data-testid=\"field-conflict\"\n      role=\"alert\"\n    >\n      <Row gap=\"2\" align=\"start\">\n        <AlertTriangle aria-hidden className=\"mt-0.5 size-3.5 shrink-0 text-warning\" />\n        <Text size=\"xs\">\n          {gone\n            ? translate('cms.conflict.removedBy', { name: actorName })\n            : translate('cms.conflict.changedBy', { name: actorName })}\n        </Text>\n      </Row>\n      {gone ? null : (\n        <Text size=\"xs\" tone=\"muted\" className=\"pl-5\" data-testid=\"field-conflict-theirs\">\n          {translate('cms.conflict.theirs', { value: conflictValuePreview(conflict.theirs) })}\n        </Text>\n      )}\n      <Row gap=\"2\" className=\"pl-5\">\n        <Button size=\"sm\" variant=\"outline\" onClick={onTakeTheirs} data-testid=\"field-conflict-theirs-button\">\n          {translate('cms.conflict.takeTheirs')}\n        </Button>\n        <Button size=\"sm\" variant=\"ghost\" onClick={onKeepMine} data-testid=\"field-conflict-mine-button\">\n          {translate('cms.conflict.keepMine')}\n        </Button>\n      </Row>\n    </Stack>\n  )\n}\n\n/** The OTHER sessions whose focused field is this one. */\nexport function presentInField(\n  presence: readonly PresenceEntry[],\n  path: ValuePath,\n): PresenceEntry[] {\n  return presence.filter((entry) => entry.path !== undefined && valuePathsOverlap(entry.path, path))\n}\n\n/** \"X is in this field\" — the signal that keeps two editors out of one field (thin presence). */\nexport function FieldPresenceNote({ entries }: { entries: readonly PresenceEntry[] }) {\n  if (entries.length === 0) return null\n  const names = [...new Set(entries.map((entry) => entry.actorName ?? translate('cms.presence.someone')))]\n  return (\n    <Row gap=\"1\" align=\"center\" className=\"text-info\" data-testid=\"field-presence\">\n      <Users aria-hidden className=\"size-3\" />\n      <Text size=\"xs\" className=\"text-info\">\n        {names.length === 1\n          ? translate('cms.presence.inField', { name: names[0]! })\n          : translate('cms.presence.inFieldMany', { names: names.join(', ') })}\n      </Text>\n    </Row>\n  )\n}\n"]}

package/dist/components/cms/field-control-lib.d.ts

@@ -1,4 +1,4 @@
-import type { ObjectFieldDef, SelectFieldDef } from '@elytracms/core/cms-core';
+import type { DocumentRef, FieldDef, ObjectFieldDef, SelectFieldDef } from '@elytracms/core/cms-core';
 /**
  * Pure companions of the document-editor field controls (EC-330, split from
  * `field-control.tsx`): the repeater reorder/summary/shape decisions and the
@@ -21,6 +21,13 @@ import type { ObjectFieldDef, SelectFieldDef } from '@elytracms/core/cms-core';
  * on the next click (measured, round2-B §Q8 1(c)).
  */
 export declare function selectedOptions(field: SelectFieldDef, value: unknown): string[];
+/**
+ * The value a relation pick writes (EC-589 / EC-586): the typed reference envelope — a
+ * list for a `multiple` relation, one envelope (or nothing) for a single one. A
+ * reference is an envelope from the first write, so the unsaved draft never holds a
+ * bare `{ collection, id }` (round3-D §5 (i): the picker used to write one).
+ */
+export declare function relationPickValue(multiple: boolean, next: readonly DocumentRef[]): unknown;
 /** Toggle one option of a multi-select; the next value (an emptied list is absent). */
 export declare function toggleSelectOption(field: SelectFieldDef, value: unknown, option: string): string[] | undefined;
 export declare function reorder<T>(list: readonly T[], from: number, to: number): T[];
@@ -35,6 +42,20 @@ export declare function objectItemSummary(fields: readonly {
 }[], item: Record<string, unknown>, index: number): string;
 export declare const depthRail: (d: number) => string;
 export declare const depthTint: (d: number) => string;
+/**
+ * The table's columns: the sub-fields an item SHOWS. A statically hidden sub-field
+ * (`form.hidden: true`) is hidden in every row, so it is no column — exactly as the card
+ * layout omits it and the validator skips it (EC-582, RULES D7: the table rendered an
+ * editable column for it).
+ */
+export declare function tableColumnsOf(field: ObjectFieldDef): FieldDef[];
+/**
+ * Whether a sub-field's control is locked: its container is, or its own declaration says
+ * so — the rule a top-level field (`isFieldReadOnly`) and a prop (`spec.form.readOnly`)
+ * already follow, at every sub-field position (EC-582, RULES U9: an object or asset
+ * placement sub-field's own `form.readOnly` was ignored — only the parent flag reached it).
+ */
+export declare function isSubFieldReadOnly(containerReadOnly: boolean, sub: FieldDef): boolean;
 export declare function isTabularObjectType(field: ObjectFieldDef): boolean;
 /**
  * EC-295: the `options` control — a `select` shown as inline segmented buttons

package/dist/components/cms/field-control-lib.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { selfTypeFieldValue } from '@elytracms/core/cms-core';
+import { referenceNode, selfTypeFieldValue } from '@elytracms/core/cms-core';
 import { Button, Row } from '@elytracms/studio/ui';
 import { localizedLabel } from '@elytracms/studio/lib/i18n';
 import { fieldLabel } from './cms-labels.js';
@@ -28,6 +28,16 @@ export function selectedOptions(field, value) {
     const canonical = selfTypeFieldValue(field, value);
     return Array.isArray(canonical) ? canonical.filter((v) => typeof v === 'string') : [];
 }
+/**
+ * The value a relation pick writes (EC-589 / EC-586): the typed reference envelope — a
+ * list for a `multiple` relation, one envelope (or nothing) for a single one. A
+ * reference is an envelope from the first write, so the unsaved draft never holds a
+ * bare `{ collection, id }` (round3-D §5 (i): the picker used to write one).
+ */
+export function relationPickValue(multiple, next) {
+    const refs = next.map(referenceNode);
+    return multiple ? refs : (refs[0] ?? undefined);
+}
 /** Toggle one option of a multi-select; the next value (an emptied list is absent). */
 export function toggleSelectOption(field, value, option) {
     const selected = selectedOptions(field, value);
@@ -95,10 +105,29 @@ export const depthTint = (d) => DEPTH_TINT[d % DEPTH_TINT.length];
 // card path — a table has no place to show/hide a column per row.
 const TABULAR_FIELD_TYPES = new Set(['text', 'number', 'boolean', 'select', 'date']);
 const MAX_TABLE_COLUMNS = 4;
+/**
+ * The table's columns: the sub-fields an item SHOWS. A statically hidden sub-field
+ * (`form.hidden: true`) is hidden in every row, so it is no column — exactly as the card
+ * layout omits it and the validator skips it (EC-582, RULES D7: the table rendered an
+ * editable column for it).
+ */
+export function tableColumnsOf(field) {
+    return field.fields.filter((f) => f.form?.hidden !== true);
+}
+/**
+ * Whether a sub-field's control is locked: its container is, or its own declaration says
+ * so — the rule a top-level field (`isFieldReadOnly`) and a prop (`spec.form.readOnly`)
+ * already follow, at every sub-field position (EC-582, RULES U9: an object or asset
+ * placement sub-field's own `form.readOnly` was ignored — only the parent flag reached it).
+ */
+export function isSubFieldReadOnly(containerReadOnly, sub) {
+    return containerReadOnly || sub.form?.readOnly === true;
+}
 export function isTabularObjectType(field) {
-    return (field.fields.length > 0 &&
-        field.fields.length <= MAX_TABLE_COLUMNS &&
-        field.fields.every((f) => TABULAR_FIELD_TYPES.has(f.type) && typeof f.form?.hidden !== 'function'));
+    const columns = tableColumnsOf(field);
+    return (columns.length > 0 &&
+        columns.length <= MAX_TABLE_COLUMNS &&
+        columns.every((f) => TABULAR_FIELD_TYPES.has(f.type) && typeof f.form?.hidden !== 'function'));
 }
 /**
  * EC-295: the `options` control — a `select` shown as inline segmented buttons

package/dist/components/cms/field-control-lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-control-lib.js","sourceRoot":"","sources":["../../../src/components/cms/field-control-lib.tsx"],"names":[],"mappings":"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","sourcesContent":["import { selfTypeFieldValue } from '@elytracms/core/cms-core'\nimport type { ObjectFieldDef, SelectFieldDef } from '@elytracms/core/cms-core'\nimport { Button, Row } from '@elytracms/studio/ui'\nimport { localizedLabel } from '@elytracms/studio/lib/i18n'\nimport { fieldLabel } from './cms-labels'\n\n/**\n * Pure companions of the document-editor field controls (EC-330, split from\n * `field-control.tsx`): the repeater reorder/summary/shape decisions and the\n * depth-encoding palette the object-array editors render from, plus the\n * `options` segmented control. Small and dependency-light so the behavioural\n * pins in `field-control.test.ts` reach them without pulling the whole\n * field-control dispatcher.\n */\n\n/**\n * Move `from` → `to`, returning a NEW array (all elements preserved). The repeater\n * applies the same `(from, to)` to its value array AND its parallel stable-key array,\n * so the two stay aligned through a reorder — a row's child/DOM state (an open\n * relation/asset picker, focus) never mis-associates (EC-253 C2, EC-294).\n */\n/**\n * The options a multi-select currently holds, read through THE write canonicaliser\n * (EC-586) — so a legacy scalar (`'news'`, written by the old bulk \"set field\") shows\n * as checked instead of nothing, and the next toggle keeps it. The form used to read\n * `Array.isArray(value) ? value : []`, which showed the scalar unchecked and DROPPED it\n * on the next click (measured, round2-B §Q8 1(c)).\n */\nexport function selectedOptions(field: SelectFieldDef, value: unknown): string[] {\n  const canonical = selfTypeFieldValue(field, value)\n  return Array.isArray(canonical) ? canonical.filter((v): v is string => typeof v === 'string') : []\n}\n\n/** Toggle one option of a multi-select; the next value (an emptied list is absent). */\nexport function toggleSelectOption(field: SelectFieldDef, value: unknown, option: string): string[] | undefined {\n  const selected = selectedOptions(field, value)\n  const next = selected.includes(option)\n    ? selected.filter((v) => v !== option)\n    : [...selected, option]\n  return next.length === 0 ? undefined : next\n}\n\nexport function reorder<T>(list: readonly T[], from: number, to: number): T[] {\n  const next = list.slice()\n  const [moved] = next.splice(from, 1)\n  if (moved !== undefined) next.splice(to, 0, moved)\n  return next\n}\n\nconst SUMMARY_PREFERRED_FIELDS = ['title', 'label', 'name', 'heading', 'text', 'linkType']\n\n/**\n * A scannable one-line summary for a collapsed repeater item (EC-294): the first\n * meaningful scalar subfield value — preferring title-ish field names — else `#n`.\n * Pure (no store): summarises from the item's own scalar values, so it works for\n * any object shape without resolving relations/assets.\n */\nexport function objectItemSummary(\n  fields: readonly { name: string }[],\n  item: Record<string, unknown>,\n  index: number,\n): string {\n  const scalar = (name: string): string | null => {\n    const v = item[name]\n    if (typeof v === 'string' && v.trim()) return v.trim()\n    if (typeof v === 'number' || typeof v === 'boolean') return String(v)\n    return null\n  }\n  const names = fields.map((f) => f.name)\n  for (const name of SUMMARY_PREFERRED_FIELDS) {\n    if (names.includes(name)) {\n      const s = scalar(name)\n      if (s) return truncateSummary(s)\n    }\n  }\n  for (const name of names) {\n    const s = scalar(name)\n    if (s) return truncateSummary(s)\n  }\n  return `#${index + 1}`\n}\n\nfunction truncateSummary(s: string, max = 60): string {\n  return s.length > max ? `${s.slice(0, max - 1)}…` : s\n}\n\n// (B) Depth-keyed visuals: a coloured left rail + a matching faint tint, DISTINCT\n// per level so nesting reads at a glance. The outermost array (depth 0) starts at\n// the brand primary — no more neutral, un-encoded first level — then a fixed\n// high-contrast rotation whose adjacent hues never collide (primary→amber→green→red;\n// note `info` is a near-primary blue, so it is deliberately NOT adjacent to primary).\n// It cycles (mod) so pathological depth still renders. Literal classes so Tailwind emits them.\nconst DEPTH_RAIL = ['border-l-primary', 'border-l-warning', 'border-l-success', 'border-l-destructive']\nconst DEPTH_TINT = ['bg-primary/5', 'bg-warning/5', 'bg-success/5', 'bg-destructive/5']\n// `d` is always ≥ 0, so `d % length` is in-bounds — the assertion is sound and gives\n// callers a definite `string` (cn tolerates undefined, but tests read the value).\nexport const depthRail = (d: number) => DEPTH_RAIL[d % DEPTH_RAIL.length]!\nexport const depthTint = (d: number) => DEPTH_TINT[d % DEPTH_TINT.length]!\n\n// (C) An object array renders as a compact TABLE when every subfield is a scalar (a\n// flat row) and there are few enough columns to read; richer/nested object types stay\n// as cards with depth encoding (B). Conditional (function-hidden) subfields force the\n// card path — a table has no place to show/hide a column per row.\nconst TABULAR_FIELD_TYPES = new Set(['text', 'number', 'boolean', 'select', 'date'])\nconst MAX_TABLE_COLUMNS = 4\nexport function isTabularObjectType(field: ObjectFieldDef): boolean {\n  return (\n    field.fields.length > 0 &&\n    field.fields.length <= MAX_TABLE_COLUMNS &&\n    field.fields.every(\n      (f) => TABULAR_FIELD_TYPES.has(f.type) && typeof f.form?.hidden !== 'function',\n    )\n  )\n}\n\n/**\n * EC-295: the `options` control — a `select` shown as inline segmented buttons\n * (`[[Page]] [URL] [File]`) instead of a dropdown. Engine built-in (no consumer\n * registration); single-select only. Each option shows `label ?? value` and a\n * `title` tooltip from the option's `description`; the field `default` + `readOnly`\n * flow through the shared form. Picks one — to allow an empty/unset value use the\n * default dropdown control.\n */\nexport function SegmentedOptions({\n  field,\n  value,\n  onChange,\n  readOnly,\n  id,\n}: {\n  field: SelectFieldDef\n  value: unknown\n  onChange: (value: unknown) => void\n  readOnly: boolean\n  id: string\n}) {\n  const current = typeof value === 'string' ? value : ''\n  return (\n    <Row gap=\"1\" wrap role=\"radiogroup\" id={id} aria-label={fieldLabel(field)}>\n      {field.options.map((opt) => {\n        const active = current === opt.value\n        return (\n          <Button\n            key={opt.value}\n            type=\"button\"\n            variant={active ? 'default' : 'outline'}\n            size=\"sm\"\n            role=\"radio\"\n            aria-checked={active}\n            title={localizedLabel(opt.description) || undefined}\n            disabled={readOnly}\n            onClick={() => onChange(opt.value)}\n          >\n            {localizedLabel(opt.label, opt.value)}\n          </Button>\n        )\n      })}\n    </Row>\n  )\n}\n"]}
+{"version":3,"file":"field-control-lib.js","sourceRoot":"","sources":["../../../src/components/cms/field-control-lib.tsx"],"names":[],"mappings":"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","sourcesContent":["import { referenceNode, selfTypeFieldValue } from '@elytracms/core/cms-core'\nimport type { DocumentRef, FieldDef, ObjectFieldDef, SelectFieldDef } from '@elytracms/core/cms-core'\nimport { Button, Row } from '@elytracms/studio/ui'\nimport { localizedLabel } from '@elytracms/studio/lib/i18n'\nimport { fieldLabel } from './cms-labels'\n\n/**\n * Pure companions of the document-editor field controls (EC-330, split from\n * `field-control.tsx`): the repeater reorder/summary/shape decisions and the\n * depth-encoding palette the object-array editors render from, plus the\n * `options` segmented control. Small and dependency-light so the behavioural\n * pins in `field-control.test.ts` reach them without pulling the whole\n * field-control dispatcher.\n */\n\n/**\n * Move `from` → `to`, returning a NEW array (all elements preserved). The repeater\n * applies the same `(from, to)` to its value array AND its parallel stable-key array,\n * so the two stay aligned through a reorder — a row's child/DOM state (an open\n * relation/asset picker, focus) never mis-associates (EC-253 C2, EC-294).\n */\n/**\n * The options a multi-select currently holds, read through THE write canonicaliser\n * (EC-586) — so a legacy scalar (`'news'`, written by the old bulk \"set field\") shows\n * as checked instead of nothing, and the next toggle keeps it. The form used to read\n * `Array.isArray(value) ? value : []`, which showed the scalar unchecked and DROPPED it\n * on the next click (measured, round2-B §Q8 1(c)).\n */\nexport function selectedOptions(field: SelectFieldDef, value: unknown): string[] {\n  const canonical = selfTypeFieldValue(field, value)\n  return Array.isArray(canonical) ? canonical.filter((v): v is string => typeof v === 'string') : []\n}\n\n/**\n * The value a relation pick writes (EC-589 / EC-586): the typed reference envelope — a\n * list for a `multiple` relation, one envelope (or nothing) for a single one. A\n * reference is an envelope from the first write, so the unsaved draft never holds a\n * bare `{ collection, id }` (round3-D §5 (i): the picker used to write one).\n */\nexport function relationPickValue(multiple: boolean, next: readonly DocumentRef[]): unknown {\n  const refs = next.map(referenceNode)\n  return multiple ? refs : (refs[0] ?? undefined)\n}\n\n/** Toggle one option of a multi-select; the next value (an emptied list is absent). */\nexport function toggleSelectOption(field: SelectFieldDef, value: unknown, option: string): string[] | undefined {\n  const selected = selectedOptions(field, value)\n  const next = selected.includes(option)\n    ? selected.filter((v) => v !== option)\n    : [...selected, option]\n  return next.length === 0 ? undefined : next\n}\n\nexport function reorder<T>(list: readonly T[], from: number, to: number): T[] {\n  const next = list.slice()\n  const [moved] = next.splice(from, 1)\n  if (moved !== undefined) next.splice(to, 0, moved)\n  return next\n}\n\nconst SUMMARY_PREFERRED_FIELDS = ['title', 'label', 'name', 'heading', 'text', 'linkType']\n\n/**\n * A scannable one-line summary for a collapsed repeater item (EC-294): the first\n * meaningful scalar subfield value — preferring title-ish field names — else `#n`.\n * Pure (no store): summarises from the item's own scalar values, so it works for\n * any object shape without resolving relations/assets.\n */\nexport function objectItemSummary(\n  fields: readonly { name: string }[],\n  item: Record<string, unknown>,\n  index: number,\n): string {\n  const scalar = (name: string): string | null => {\n    const v = item[name]\n    if (typeof v === 'string' && v.trim()) return v.trim()\n    if (typeof v === 'number' || typeof v === 'boolean') return String(v)\n    return null\n  }\n  const names = fields.map((f) => f.name)\n  for (const name of SUMMARY_PREFERRED_FIELDS) {\n    if (names.includes(name)) {\n      const s = scalar(name)\n      if (s) return truncateSummary(s)\n    }\n  }\n  for (const name of names) {\n    const s = scalar(name)\n    if (s) return truncateSummary(s)\n  }\n  return `#${index + 1}`\n}\n\nfunction truncateSummary(s: string, max = 60): string {\n  return s.length > max ? `${s.slice(0, max - 1)}…` : s\n}\n\n// (B) Depth-keyed visuals: a coloured left rail + a matching faint tint, DISTINCT\n// per level so nesting reads at a glance. The outermost array (depth 0) starts at\n// the brand primary — no more neutral, un-encoded first level — then a fixed\n// high-contrast rotation whose adjacent hues never collide (primary→amber→green→red;\n// note `info` is a near-primary blue, so it is deliberately NOT adjacent to primary).\n// It cycles (mod) so pathological depth still renders. Literal classes so Tailwind emits them.\nconst DEPTH_RAIL = ['border-l-primary', 'border-l-warning', 'border-l-success', 'border-l-destructive']\nconst DEPTH_TINT = ['bg-primary/5', 'bg-warning/5', 'bg-success/5', 'bg-destructive/5']\n// `d` is always ≥ 0, so `d % length` is in-bounds — the assertion is sound and gives\n// callers a definite `string` (cn tolerates undefined, but tests read the value).\nexport const depthRail = (d: number) => DEPTH_RAIL[d % DEPTH_RAIL.length]!\nexport const depthTint = (d: number) => DEPTH_TINT[d % DEPTH_TINT.length]!\n\n// (C) An object array renders as a compact TABLE when every subfield is a scalar (a\n// flat row) and there are few enough columns to read; richer/nested object types stay\n// as cards with depth encoding (B). Conditional (function-hidden) subfields force the\n// card path — a table has no place to show/hide a column per row.\nconst TABULAR_FIELD_TYPES = new Set(['text', 'number', 'boolean', 'select', 'date'])\nconst MAX_TABLE_COLUMNS = 4\n\n/**\n * The table's columns: the sub-fields an item SHOWS. A statically hidden sub-field\n * (`form.hidden: true`) is hidden in every row, so it is no column — exactly as the card\n * layout omits it and the validator skips it (EC-582, RULES D7: the table rendered an\n * editable column for it).\n */\nexport function tableColumnsOf(field: ObjectFieldDef): FieldDef[] {\n  return field.fields.filter((f) => f.form?.hidden !== true)\n}\n\n/**\n * Whether a sub-field's control is locked: its container is, or its own declaration says\n * so — the rule a top-level field (`isFieldReadOnly`) and a prop (`spec.form.readOnly`)\n * already follow, at every sub-field position (EC-582, RULES U9: an object or asset\n * placement sub-field's own `form.readOnly` was ignored — only the parent flag reached it).\n */\nexport function isSubFieldReadOnly(containerReadOnly: boolean, sub: FieldDef): boolean {\n  return containerReadOnly || sub.form?.readOnly === true\n}\n\nexport function isTabularObjectType(field: ObjectFieldDef): boolean {\n  const columns = tableColumnsOf(field)\n  return (\n    columns.length > 0 &&\n    columns.length <= MAX_TABLE_COLUMNS &&\n    columns.every((f) => TABULAR_FIELD_TYPES.has(f.type) && typeof f.form?.hidden !== 'function')\n  )\n}\n\n/**\n * EC-295: the `options` control — a `select` shown as inline segmented buttons\n * (`[[Page]] [URL] [File]`) instead of a dropdown. Engine built-in (no consumer\n * registration); single-select only. Each option shows `label ?? value` and a\n * `title` tooltip from the option's `description`; the field `default` + `readOnly`\n * flow through the shared form. Picks one — to allow an empty/unset value use the\n * default dropdown control.\n */\nexport function SegmentedOptions({\n  field,\n  value,\n  onChange,\n  readOnly,\n  id,\n}: {\n  field: SelectFieldDef\n  value: unknown\n  onChange: (value: unknown) => void\n  readOnly: boolean\n  id: string\n}) {\n  const current = typeof value === 'string' ? value : ''\n  return (\n    <Row gap=\"1\" wrap role=\"radiogroup\" id={id} aria-label={fieldLabel(field)}>\n      {field.options.map((opt) => {\n        const active = current === opt.value\n        return (\n          <Button\n            key={opt.value}\n            type=\"button\"\n            variant={active ? 'default' : 'outline'}\n            size=\"sm\"\n            role=\"radio\"\n            aria-checked={active}\n            title={localizedLabel(opt.description) || undefined}\n            disabled={readOnly}\n            onClick={() => onChange(opt.value)}\n          >\n            {localizedLabel(opt.label, opt.value)}\n          </Button>\n        )\n      })}\n    </Row>\n  )\n}\n"]}