@elytracms/studio 0.0.92 → 0.0.93

package/dist/lib/assets/asset-placements.d.ts

@@ -1,28 +0,0 @@
-/** The ids the field should hold next. The shape follows the field's cardinality. */
-export type AssetPlacementTarget = {
-    multiple: false;
-    id: string | null;
-} | {
-    multiple: true;
-    ids: readonly string[];
-};
-/**
- * Return the field's next value with every placement's per-use sub-fields kept.
- *
- * - **Single field.** The placement's sub-fields carry over to whatever id now fills
- *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,
- *   and `null` clears the field (`undefined`).
- * - **Multiple field.** An id the value already held keeps its entry verbatim, with
- *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,
- *   so an image placed twice keeps both placements. An id the value did not hold
- *   becomes a new envelope. A held entry whose id is not in `ids` is removed, and an
- *   emptied list is ABSENT (`undefined`, EC-586), never `[]`.
- *
- * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`
- * reads. That includes keys the config no longer declares (AD-14: the schema is a
- * lens, so a writer never deletes what the lens does not show).
- *
- * When nothing changes it returns `current` itself (the same reference), so a caller
- * can skip the write.
- */
-export declare function carryAssetPlacements(current: unknown, next: AssetPlacementTarget): unknown;

package/dist/lib/assets/asset-placements.js

@@ -1,83 +0,0 @@
-/**
- * The per-use sub-field carry rule for an asset field's value (EC-558).
- *
- * An asset field that declares per-use sub-fields (EC-301) stores envelopes such as
- * `{ type: 'asset', id, caption }`. Those sub-fields are PLACEMENT data: they
- * describe this use of the image, not the image itself (owner ruling 2026-09-26;
- * data that describes the image belongs on the asset record's `meta`). A writer
- * that changes which image a placement shows must therefore keep the placement's
- * sub-fields. Before EC-558 only the detail editor did that. The table cell and AI
- * `updateFields` rebuilt the value from bare ids and lost them.
- *
- * {@link carryAssetPlacements} is the one declaration of that rule. Two operations
- * go through it:
- *  - **append / pick**: the table cell and the detail editor
- *    (`applyAssetSelection` / `appendAssetSelections` in
- *    `components/assets/asset-selection.ts`). The next list is the held list plus
- *    the picked ids, and a single field swaps its one placement's image.
- *  - **replace-with-list**: AI `updateFields` (`lib/ai/update-fields.ts`). The next
- *    list is the list the model sent.
- *
- * It lives in `lib/` because `lib/ai` may not import from `components/`, and both
- * sides need it. Its only dependency is `@elytracms/core/cms-core`, so the AI host
- * route pulls in nothing from the browser. Its natural home is next to `assetNode`
- * in `core/cms-core/envelopes.ts`. Move it there if a writer outside the studio
- * (import, CLI, MCP) appears.
- */
-import { assetNode, assetSubfieldsOf, readAssetId } from '@elytracms/core/cms-core';
-/**
- * A BRAND-NEW placement, which has no sub-fields yet: always the canonical envelope
- * (EC-586, ratified 2c — an asset value is `{ type: 'asset', id, … }`). There used to be
- * a second, bare spelling (`'bare'`, a plain id string) for fields without sub-fields;
- * the write lens wrapped it on save, so the in-session draft held a shape the stored one
- * did not, and a def-less "has unpublished changes" verdict read the two as different.
- */
-function newPlacement(id) {
-    return assetNode(id);
-}
-/**
- * Return the field's next value with every placement's per-use sub-fields kept.
- *
- * - **Single field.** The placement's sub-fields carry over to whatever id now fills
- *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,
- *   and `null` clears the field (`undefined`).
- * - **Multiple field.** An id the value already held keeps its entry verbatim, with
- *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,
- *   so an image placed twice keeps both placements. An id the value did not hold
- *   becomes a new envelope. A held entry whose id is not in `ids` is removed, and an
- *   emptied list is ABSENT (`undefined`, EC-586), never `[]`.
- *
- * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`
- * reads. That includes keys the config no longer declares (AD-14: the schema is a
- * lens, so a writer never deletes what the lens does not show).
- *
- * When nothing changes it returns `current` itself (the same reference), so a caller
- * can skip the write.
- */
-export function carryAssetPlacements(current, next) {
-    if (!next.multiple) {
-        if (next.id === null)
-            return undefined;
-        // `singleAssetIdOf` tolerates a legacy one-item array on a single field, so read
-        // its placement the same way.
-        const held = Array.isArray(current) ? current[0] : current;
-        if (readAssetId(held) === next.id)
-            return current;
-        const subfields = assetSubfieldsOf(held);
-        return Object.keys(subfields).length > 0 ? assetNode(next.id, subfields) : newPlacement(next.id);
-    }
-    const held = Array.isArray(current) ? current : [];
-    const used = new Set();
-    const out = next.ids.map((id) => {
-        const index = held.findIndex((entry, i) => !used.has(i) && readAssetId(entry) === id);
-        if (index < 0)
-            return newPlacement(id);
-        used.add(index);
-        return held[index];
-    });
-    const unchanged = out.length === held.length && out.every((entry, i) => entry === held[i]);
-    if (unchanged && Array.isArray(current))
-        return current;
-    return out.length === 0 ? undefined : out;
-}
-//# sourceMappingURL=asset-placements.js.map

package/dist/lib/assets/asset-placements.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset-placements.js","sourceRoot":"","sources":["../../../src/lib/assets/asset-placements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAOnF;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,EAAU;IAC9B,OAAO,SAAS,CAAC,EAAE,CAAC,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,IAA0B;IAC/E,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;QACtC,iFAAiF;QACjF,8BAA8B;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1D,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE;YAAE,OAAO,OAAO,CAAA;QACjD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,OAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACrF,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC,EAAE,CAAC,CAAA;QACtC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,IAAI,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACvD,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA;AAC3C,CAAC","sourcesContent":["/**\n * The per-use sub-field carry rule for an asset field's value (EC-558).\n *\n * An asset field that declares per-use sub-fields (EC-301) stores envelopes such as\n * `{ type: 'asset', id, caption }`. Those sub-fields are PLACEMENT data: they\n * describe this use of the image, not the image itself (owner ruling 2026-09-26;\n * data that describes the image belongs on the asset record's `meta`). A writer\n * that changes which image a placement shows must therefore keep the placement's\n * sub-fields. Before EC-558 only the detail editor did that. The table cell and AI\n * `updateFields` rebuilt the value from bare ids and lost them.\n *\n * {@link carryAssetPlacements} is the one declaration of that rule. Two operations\n * go through it:\n *  - **append / pick**: the table cell and the detail editor\n *    (`applyAssetSelection` / `appendAssetSelections` in\n *    `components/assets/asset-selection.ts`). The next list is the held list plus\n *    the picked ids, and a single field swaps its one placement's image.\n *  - **replace-with-list**: AI `updateFields` (`lib/ai/update-fields.ts`). The next\n *    list is the list the model sent.\n *\n * It lives in `lib/` because `lib/ai` may not import from `components/`, and both\n * sides need it. Its only dependency is `@elytracms/core/cms-core`, so the AI host\n * route pulls in nothing from the browser. Its natural home is next to `assetNode`\n * in `core/cms-core/envelopes.ts`. Move it there if a writer outside the studio\n * (import, CLI, MCP) appears.\n */\nimport { assetNode, assetSubfieldsOf, readAssetId } from '@elytracms/core/cms-core'\n\n/** The ids the field should hold next. The shape follows the field's cardinality. */\nexport type AssetPlacementTarget =\n  | { multiple: false; id: string | null }\n  | { multiple: true; ids: readonly string[] }\n\n/**\n * A BRAND-NEW placement, which has no sub-fields yet: always the canonical envelope\n * (EC-586, ratified 2c — an asset value is `{ type: 'asset', id, … }`). There used to be\n * a second, bare spelling (`'bare'`, a plain id string) for fields without sub-fields;\n * the write lens wrapped it on save, so the in-session draft held a shape the stored one\n * did not, and a def-less \"has unpublished changes\" verdict read the two as different.\n */\nfunction newPlacement(id: string): unknown {\n  return assetNode(id)\n}\n\n/**\n * Return the field's next value with every placement's per-use sub-fields kept.\n *\n * - **Single field.** The placement's sub-fields carry over to whatever id now fills\n *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,\n *   and `null` clears the field (`undefined`).\n * - **Multiple field.** An id the value already held keeps its entry verbatim, with\n *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,\n *   so an image placed twice keeps both placements. An id the value did not hold\n *   becomes a new envelope. A held entry whose id is not in `ids` is removed, and an\n *   emptied list is ABSENT (`undefined`, EC-586), never `[]`.\n *\n * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`\n * reads. That includes keys the config no longer declares (AD-14: the schema is a\n * lens, so a writer never deletes what the lens does not show).\n *\n * When nothing changes it returns `current` itself (the same reference), so a caller\n * can skip the write.\n */\nexport function carryAssetPlacements(current: unknown, next: AssetPlacementTarget): unknown {\n  if (!next.multiple) {\n    if (next.id === null) return undefined\n    // `singleAssetIdOf` tolerates a legacy one-item array on a single field, so read\n    // its placement the same way.\n    const held = Array.isArray(current) ? current[0] : current\n    if (readAssetId(held) === next.id) return current\n    const subfields = assetSubfieldsOf(held)\n    return Object.keys(subfields).length > 0 ? assetNode(next.id, subfields) : newPlacement(next.id)\n  }\n\n  const held = Array.isArray(current) ? (current as unknown[]) : []\n  const used = new Set<number>()\n  const out = next.ids.map((id) => {\n    const index = held.findIndex((entry, i) => !used.has(i) && readAssetId(entry) === id)\n    if (index < 0) return newPlacement(id)\n    used.add(index)\n    return held[index]\n  })\n  const unchanged = out.length === held.length && out.every((entry, i) => entry === held[i])\n  if (unchanged && Array.isArray(current)) return current\n  return out.length === 0 ? undefined : out\n}\n"]}