@elytracms/studio 0.0.92 → 0.0.94

package/dist/components/redirects/redirects-collection-view-source.js

@@ -1,146 +0,0 @@
-import { useCallback, useMemo } from 'react';
-import { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core';
-import { studioPath } from '@elytracms/studio/router';
-import { useRedirects } from './redirects-store.js';
-import { redirectsCollectionDef } from './redirects-schema.js';
-import { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source.js';
-import { parseLocaleConfig } from '@elytracms/core/cms-core';
-/** The redirects rail is not localized — one implicit locale keeps the lens honest. */
-const REDIRECTS_LOCALE = 'en';
-const REDIRECTS_LOCALE_CONFIG = parseLocaleConfig({
-    default: REDIRECTS_LOCALE,
-    locales: [REDIRECTS_LOCALE],
-});
-/**
- * The capability profile of the redirects rail (EC-303): content-gated, create
- * + remove, no publish/versions/locales — redirects are CONTENT (an editor
- * owns them), so unlike the users rail this source allows `create`, is NOT
- * admin-only, and needs no principal field-access policy. Hoisted to a
- * module-level constant (EC-327), mirroring `ASSET_COLLECTION_CAPABILITIES`.
- */
-export const REDIRECT_COLLECTION_CAPABILITIES = {
-    publish: false,
-    versions: false,
-    locales: false,
-    inlineEdit: false,
-    create: true, // editors create redirects
-    duplicate: false, // EC-442 owner call: no rail Duplicate for now (redirects deferred)
-    remove: true,
-    bulk: true, // EC-433: bulk delete = the same per-id remove, honestly reported
-    liveUrl: false,
-    hierarchy: false,
-    importExport: false,
-    adminOnly: false, // content, not administration
-};
-/**
- * The canonical redirect fields — the storage/delivery contract of the primitive
- * rail. Anything a mount adds via *additive* `nav.redirects({ fields })` (EC-311
- * Tier 2) is by definition NOT one of these, so its value round-trips through the
- * record's open `meta` bag. Derived from the built-in def so the two never drift.
- */
-const CANONICAL_REDIRECT_FIELDS = new Set(redirectsCollectionDef.fields.map((f) => f.name));
-/**
- * Project a stored redirect into the lens's `values` shape. EC-311 Tier 2:
- * additive schema fields round-trip through the open meta bag, spread FIRST so a
- * canonical column always wins over a same-named meta key (RESIDUE-3c, EC-577):
- * spread last, a stored `meta.to` displayed as the redirect's target and a
- * re-save wrote it into the canonical `to`. The record schema now refuses such a
- * key on write; this order keeps a row stored before that harmless.
- */
-export function redirectToDocument(entry) {
-    return {
-        collection: redirectsCollectionDef.id,
-        id: entry.id,
-        values: {
-            ...(entry.meta ?? {}),
-            from: entry.from,
-            to: entry.to,
-            permanent: entry.permanent,
-            enabled: entry.enabled,
-        },
-    };
-}
-/**
- * Map an edited lens document back to the redirect write (EC-577). A column the
- * document does not carry is left out of the write, so the stored value is kept:
- * `permanent`/`enabled` get their defaults only when the save CREATES the
- * redirect, applied once inside the adapter's transaction — this lens no longer
- * restates them (`?? true` here was the third copy of the default, RESIDUE-3b).
- * `from`/`to` are always sent: the editor owns them, and an empty one is refused
- * visibly by the write's validation rather than kept silently.
- */
-export function documentToSaveRedirect(doc) {
-    const values = doc.values ?? {};
-    // EC-311 Tier 2: any value keyed outside the canonical set comes from a mount's
-    // additive `nav.redirects({ fields })` override — persist it in the meta bag. The
-    // editor holds the complete additive set, so this is the whole bag (replace, not
-    // merge). Omit `meta` entirely for the default rail so its saves are unchanged.
-    const meta = metaBagProjection(values, CANONICAL_REDIRECT_FIELDS);
-    return {
-        id: doc.id,
-        from: typeof values.from === 'string' ? values.from : '',
-        to: typeof values.to === 'string' ? values.to : '',
-        ...(typeof values.permanent === 'boolean' ? { permanent: values.permanent } : {}),
-        ...(typeof values.enabled === 'boolean' ? { enabled: values.enabled } : {}),
-        ...(Object.keys(meta).length > 0 ? { meta } : {}),
-    };
-}
-/**
- * Assemble a {@link CollectionViewSource} for the **redirects rail** (EC-303) —
- * the portable list/edit surfaces over the editorial redirects store instead of
- * the CMS store. Redirects are CONTENT (an editor owns them), so unlike the users
- * rail this source allows `create`, is NOT admin-only, and needs no principal
- * field-access policy. No publish/versions/locales/inline/import — a redirect
- * is a small record saved explicitly (a saved+enabled one is live); bulk
- * delete rides the shared rail runner (EC-433).
- *
- * Must be mounted under a `RedirectsProvider` (for {@link useRedirects}).
- *
- * `schema` defaults to the engine-owned {@link redirectsCollectionDef}; a mount may
- * pass a customized def (EC-311 — built-in fields overridden by equal name via
- * `nav.redirects({ fields })`). The canonical `from`/`to`/`permanent`/`enabled`
- * names+types are contract-locked, so the projection helpers still read the same
- * canonical values; a mount's *additive* fields (Tier 2) round-trip through the
- * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).
- *
- * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`
- * plumbing and the assembled source; this hook supplies only the redirects-store
- * reads/writes, the capability profile, and the registry-driven `validate`.
- */
-export function useRedirectsCollectionViewSource(projectId, schema = redirectsCollectionDef) {
-    const store = useRedirects();
-    // EC-311: run the (possibly customized) schema's validation — required/pattern and
-    // custom `validate` fns on an overridden field must actually fire in the editor.
-    const registry = useMemo(() => createCollectionRegistry([schema]), [schema]);
-    const documents = useCallback(() => store.redirects.map(redirectToDocument), [store.redirects]);
-    const get = useCallback((ref) => {
-        const record = store.get(ref.id);
-        return record ? redirectToDocument(record) : undefined;
-    }, [store]);
-    const titleOf = useCallback((ref) => store.get(ref.id)?.from || '(new redirect)', [store]);
-    const validate = useCallback((doc) => validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }), [registry]);
-    const create = useCallback(() => ({ collection: redirectsCollectionDef.id, id: store.createDraft() }), [store]);
-    const save = useCallback((doc) => store.save(documentToSaveRedirect(doc)), [store]);
-    const remove = useCallback((ref) => store.remove(ref.id), [store]);
-    return useRailViewSource({
-        projectId,
-        schema,
-        capabilities: REDIRECT_COLLECTION_CAPABILITIES,
-        localeConfig: REDIRECTS_LOCALE_CONFIG,
-        documents,
-        get,
-        titleOf,
-        // No `referenceCandidates`/`collections` override: redirects carry no
-        // relation/asset fields, so nothing cross-collection to resolve (the
-        // factory's `() => []` / `[schema]` defaults apply).
-        detailPath: (id) => studioPath.redirect(id),
-        listPath: studioPath.redirects(),
-        validate,
-        create,
-        save,
-        remove,
-        normalizeSaveResult: normalizeOkResult,
-        normalizeRemoveResult: normalizeOkResult,
-    });
-}
-//# sourceMappingURL=redirects-collection-view-source.js.map

package/dist/components/redirects/redirects-collection-view-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"redirects-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-collection-view-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo } from 'react'\nimport type { CmsDocument, CollectionDef, DocumentRef, Locale, LocaleConfig } from '@elytracms/core/cms-core'\nimport { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { studioPath } from '@elytracms/studio/router'\nimport type {\n  CollectionViewCapabilities,\n  CollectionViewSource,\n} from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useRedirects } from './redirects-store'\nimport { redirectsCollectionDef } from './redirects-schema'\nimport { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source'\nimport { parseLocaleConfig } from '@elytracms/core/cms-core'\n\n/** The redirects rail is not localized — one implicit locale keeps the lens honest. */\nconst REDIRECTS_LOCALE: Locale = 'en'\nconst REDIRECTS_LOCALE_CONFIG: LocaleConfig = parseLocaleConfig({\n  default: REDIRECTS_LOCALE,\n  locales: [REDIRECTS_LOCALE],\n})\n\n/**\n * The capability profile of the redirects rail (EC-303): content-gated, create\n * + remove, no publish/versions/locales — redirects are CONTENT (an editor\n * owns them), so unlike the users rail this source allows `create`, is NOT\n * admin-only, and needs no principal field-access policy. Hoisted to a\n * module-level constant (EC-327), mirroring `ASSET_COLLECTION_CAPABILITIES`.\n */\nexport const REDIRECT_COLLECTION_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: true, // editors create redirects\n  duplicate: false, // EC-442 owner call: no rail Duplicate for now (redirects deferred)\n  remove: true,\n  bulk: true, // EC-433: bulk delete = the same per-id remove, honestly reported\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false,\n  adminOnly: false, // content, not administration\n}\n\n/**\n * The canonical redirect fields — the storage/delivery contract of the primitive\n * rail. Anything a mount adds via *additive* `nav.redirects({ fields })` (EC-311\n * Tier 2) is by definition NOT one of these, so its value round-trips through the\n * record's open `meta` bag. Derived from the built-in def so the two never drift.\n */\nconst CANONICAL_REDIRECT_FIELDS = new Set(redirectsCollectionDef.fields.map((f) => f.name))\n\n/**\n * Project a stored redirect into the lens's `values` shape. EC-311 Tier 2:\n * additive schema fields round-trip through the open meta bag, spread FIRST so a\n * canonical column always wins over a same-named meta key (RESIDUE-3c, EC-577):\n * spread last, a stored `meta.to` displayed as the redirect's target and a\n * re-save wrote it into the canonical `to`. The record schema now refuses such a\n * key on write; this order keeps a row stored before that harmless.\n */\nexport function redirectToDocument(entry: RedirectEntry): CmsDocument {\n  return {\n    collection: redirectsCollectionDef.id,\n    id: entry.id,\n    values: {\n      ...(entry.meta ?? {}),\n      from: entry.from,\n      to: entry.to,\n      permanent: entry.permanent,\n      enabled: entry.enabled,\n    },\n  }\n}\n\n/**\n * Map an edited lens document back to the redirect write (EC-577). A column the\n * document does not carry is left out of the write, so the stored value is kept:\n * `permanent`/`enabled` get their defaults only when the save CREATES the\n * redirect, applied once inside the adapter's transaction — this lens no longer\n * restates them (`?? true` here was the third copy of the default, RESIDUE-3b).\n * `from`/`to` are always sent: the editor owns them, and an empty one is refused\n * visibly by the write's validation rather than kept silently.\n */\nexport function documentToSaveRedirect(doc: CmsDocument): SaveRedirectInput {\n  const values = doc.values ?? {}\n  // EC-311 Tier 2: any value keyed outside the canonical set comes from a mount's\n  // additive `nav.redirects({ fields })` override — persist it in the meta bag. The\n  // editor holds the complete additive set, so this is the whole bag (replace, not\n  // merge). Omit `meta` entirely for the default rail so its saves are unchanged.\n  const meta = metaBagProjection(values, CANONICAL_REDIRECT_FIELDS)\n  return {\n    id: doc.id,\n    from: typeof values.from === 'string' ? values.from : '',\n    to: typeof values.to === 'string' ? values.to : '',\n    ...(typeof values.permanent === 'boolean' ? { permanent: values.permanent } : {}),\n    ...(typeof values.enabled === 'boolean' ? { enabled: values.enabled } : {}),\n    ...(Object.keys(meta).length > 0 ? { meta } : {}),\n  }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **redirects rail** (EC-303) —\n * the portable list/edit surfaces over the editorial redirects store instead of\n * the CMS store. Redirects are CONTENT (an editor owns them), so unlike the users\n * rail this source allows `create`, is NOT admin-only, and needs no principal\n * field-access policy. No publish/versions/locales/inline/import — a redirect\n * is a small record saved explicitly (a saved+enabled one is live); bulk\n * delete rides the shared rail runner (EC-433).\n *\n * Must be mounted under a `RedirectsProvider` (for {@link useRedirects}).\n *\n * `schema` defaults to the engine-owned {@link redirectsCollectionDef}; a mount may\n * pass a customized def (EC-311 — built-in fields overridden by equal name via\n * `nav.redirects({ fields })`). The canonical `from`/`to`/`permanent`/`enabled`\n * names+types are contract-locked, so the projection helpers still read the same\n * canonical values; a mount's *additive* fields (Tier 2) round-trip through the\n * record's open `meta` bag ({@link documentToSaveRedirect}/{@link redirectToDocument}).\n *\n * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`\n * plumbing and the assembled source; this hook supplies only the redirects-store\n * reads/writes, the capability profile, and the registry-driven `validate`.\n */\nexport function useRedirectsCollectionViewSource(\n  projectId: string,\n  schema: CollectionDef = redirectsCollectionDef,\n): CollectionViewSource {\n  const store = useRedirects()\n  // EC-311: run the (possibly customized) schema's validation — required/pattern and\n  // custom `validate` fns on an overridden field must actually fire in the editor.\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n\n  const documents = useCallback(() => store.redirects.map(redirectToDocument), [store.redirects])\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.get(ref.id)\n      return record ? redirectToDocument(record) : undefined\n    },\n    [store],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => store.get(ref.id)?.from || '(new redirect)',\n    [store],\n  )\n  const validate = useCallback(\n    (doc: CmsDocument) => validateDocument(registry, doc, { localeConfig: REDIRECTS_LOCALE_CONFIG }),\n    [registry],\n  )\n  const create = useCallback(\n    (): DocumentRef => ({ collection: redirectsCollectionDef.id, id: store.createDraft() }),\n    [store],\n  )\n  const save = useCallback((doc: CmsDocument) => store.save(documentToSaveRedirect(doc)), [store])\n  const remove = useCallback((ref: DocumentRef) => store.remove(ref.id), [store])\n\n  return useRailViewSource({\n    projectId,\n    schema,\n    capabilities: REDIRECT_COLLECTION_CAPABILITIES,\n    localeConfig: REDIRECTS_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    // No `referenceCandidates`/`collections` override: redirects carry no\n    // relation/asset fields, so nothing cross-collection to resolve (the\n    // factory's `() => []` / `[schema]` defaults apply).\n    detailPath: (id: string) => studioPath.redirect(id),\n    listPath: studioPath.redirects(),\n    validate,\n    create,\n    save,\n    remove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeOkResult,\n  })\n}\n"]}

package/dist/components/redirects/redirects-module.d.ts

@@ -1,21 +0,0 @@
-import type { CollectionDef } from '@elytracms/core/cms-core';
-/**
- * The studio Redirects module (EC-303). Editorial redirects as data — the reuse
- * proof (with the users rail) that the portable interaction surfaces serve any
- * rail: it renders the SAME `LoadedCollectionTable` for the list and the SAME
- * `DetailEditor` body (via {@link PortableDetailEditor}) for one redirect, over a
- * redirects {@link useRedirectsCollectionViewSource}. The redirects capability
- * profile (content-gated, create + remove, no publish/versions/locales) drives
- * which regions appear; the edit shell's explicit-save path (no publish) makes a
- * saved+enabled redirect live.
- *
- * `redirectId === null` is the list; a `redirectId` opens that redirect's detail
- * (routed via `studioPath.redirect`). No admin gate — redirects are content, so
- * viewers read and editors write (enforced at the chokepoint + Convex boundary).
- */
-export declare function RedirectsModule({ projectId, redirectId, schema, }: {
-    projectId: string;
-    redirectId?: string | null;
-    /** EC-311: a mount-customized redirects def (built-in fields overridden by name). */
-    schema?: CollectionDef;
-}): import("react").JSX.Element;

package/dist/components/redirects/redirects-module.js

@@ -1,40 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { translate } from '@elytracms/studio/lib/i18n';
-import { RedirectsProvider, useRedirects } from './redirects-store.js';
-import { useRedirectsCollectionViewSource } from './redirects-collection-view-source.js';
-import { CollectionViewProvider } from '../collection-view/collection-view-context.js';
-import { RailStoreStatus } from '../rail-store-status.js';
-import { LoadedCollectionTable } from '../cms/collection-table.js';
-import { PortableDetailEditor } from '../cms/detail-editor.js';
-/**
- * The studio Redirects module (EC-303). Editorial redirects as data — the reuse
- * proof (with the users rail) that the portable interaction surfaces serve any
- * rail: it renders the SAME `LoadedCollectionTable` for the list and the SAME
- * `DetailEditor` body (via {@link PortableDetailEditor}) for one redirect, over a
- * redirects {@link useRedirectsCollectionViewSource}. The redirects capability
- * profile (content-gated, create + remove, no publish/versions/locales) drives
- * which regions appear; the edit shell's explicit-save path (no publish) makes a
- * saved+enabled redirect live.
- *
- * `redirectId === null` is the list; a `redirectId` opens that redirect's detail
- * (routed via `studioPath.redirect`). No admin gate — redirects are content, so
- * viewers read and editors write (enforced at the chokepoint + Convex boundary).
- */
-export function RedirectsModule({ projectId, redirectId = null, schema, }) {
-    return (_jsx(RedirectsProvider, { projectId: projectId, children: _jsx(RedirectsSurface, { projectId: projectId, redirectId: redirectId, schema: schema }) }));
-}
-/** The loaded surface: the portable list (or one redirect's detail) over the source. */
-function RedirectsSurface({ projectId, redirectId, schema, }) {
-    const store = useRedirects();
-    const source = useRedirectsCollectionViewSource(projectId, schema);
-    if (store.status !== 'ready') {
-        return (_jsx(RailStoreStatus, { store: store, errorLabel: translate('redirects.loadFailed'), loadingLabel: translate('redirects.loading'), errorTestId: "redirects-error" }));
-    }
-    // One redirect's detail opens in the portable edit shell (AD-19); the list otherwise.
-    // The shell mounts its own CollectionViewProvider, so only the list wraps here.
-    if (redirectId !== null) {
-        return _jsx(PortableDetailEditor, { source: source, projectId: projectId, documentId: redirectId });
-    }
-    return (_jsx(CollectionViewProvider, { source: source, children: _jsx(LoadedCollectionTable, { projectId: projectId }) }));
-}
-//# sourceMappingURL=redirects-module.js.map

package/dist/components/redirects/redirects-module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"redirects-module.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-module.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAA;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,SAAS,EACT,UAAU,GAAG,IAAI,EACjB,MAAM,GAMP;IACC,OAAO,CACL,KAAC,iBAAiB,IAAC,SAAS,EAAE,SAAS,YACrC,KAAC,gBAAgB,IAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAI,GAChE,CACrB,CAAA;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,gBAAgB,CAAC,EACxB,SAAS,EACT,UAAU,EACV,MAAM,GAKP;IACC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,gCAAgC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAElE,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,CACL,KAAC,eAAe,IACd,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,SAAS,CAAC,sBAAsB,CAAC,EAC7C,YAAY,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAC5C,WAAW,EAAC,iBAAiB,GAC7B,CACH,CAAA;IACH,CAAC;IAED,sFAAsF;IACtF,gFAAgF;IAChF,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,KAAC,oBAAoB,IAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,GAAI,CAAA;IAC/F,CAAC;IAED,OAAO,CACL,KAAC,sBAAsB,IAAC,MAAM,EAAE,MAAM,YACpC,KAAC,qBAAqB,IAAC,SAAS,EAAE,SAAS,GAAI,GACxB,CAC1B,CAAA;AACH,CAAC","sourcesContent":["import type { CollectionDef } from '@elytracms/core/cms-core'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { RedirectsProvider, useRedirects } from './redirects-store'\nimport { useRedirectsCollectionViewSource } from './redirects-collection-view-source'\nimport { CollectionViewProvider } from '../collection-view/collection-view-context'\nimport { RailStoreStatus } from '../rail-store-status'\nimport { LoadedCollectionTable } from '../cms/collection-table'\nimport { PortableDetailEditor } from '../cms/detail-editor'\n\n/**\n * The studio Redirects module (EC-303). Editorial redirects as data — the reuse\n * proof (with the users rail) that the portable interaction surfaces serve any\n * rail: it renders the SAME `LoadedCollectionTable` for the list and the SAME\n * `DetailEditor` body (via {@link PortableDetailEditor}) for one redirect, over a\n * redirects {@link useRedirectsCollectionViewSource}. The redirects capability\n * profile (content-gated, create + remove, no publish/versions/locales) drives\n * which regions appear; the edit shell's explicit-save path (no publish) makes a\n * saved+enabled redirect live.\n *\n * `redirectId === null` is the list; a `redirectId` opens that redirect's detail\n * (routed via `studioPath.redirect`). No admin gate — redirects are content, so\n * viewers read and editors write (enforced at the chokepoint + Convex boundary).\n */\nexport function RedirectsModule({\n  projectId,\n  redirectId = null,\n  schema,\n}: {\n  projectId: string\n  redirectId?: string | null\n  /** EC-311: a mount-customized redirects def (built-in fields overridden by name). */\n  schema?: CollectionDef\n}) {\n  return (\n    <RedirectsProvider projectId={projectId}>\n      <RedirectsSurface projectId={projectId} redirectId={redirectId} schema={schema} />\n    </RedirectsProvider>\n  )\n}\n\n/** The loaded surface: the portable list (or one redirect's detail) over the source. */\nfunction RedirectsSurface({\n  projectId,\n  redirectId,\n  schema,\n}: {\n  projectId: string\n  redirectId: string | null\n  schema?: CollectionDef\n}) {\n  const store = useRedirects()\n  const source = useRedirectsCollectionViewSource(projectId, schema)\n\n  if (store.status !== 'ready') {\n    return (\n      <RailStoreStatus\n        store={store}\n        errorLabel={translate('redirects.loadFailed')}\n        loadingLabel={translate('redirects.loading')}\n        errorTestId=\"redirects-error\"\n      />\n    )\n  }\n\n  // One redirect's detail opens in the portable edit shell (AD-19); the list otherwise.\n  // The shell mounts its own CollectionViewProvider, so only the list wraps here.\n  if (redirectId !== null) {\n    return <PortableDetailEditor source={source} projectId={projectId} documentId={redirectId} />\n  }\n\n  return (\n    <CollectionViewProvider source={source}>\n      <LoadedCollectionTable projectId={projectId} />\n    </CollectionViewProvider>\n  )\n}\n"]}

package/dist/components/redirects/redirects-store.d.ts

@@ -1,68 +0,0 @@
-import type { ReactNode } from 'react';
-import type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence';
-/**
- * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302
- * forwards — read + written through the shared operations client (`redirects.*`),
- * the same seam the users/assets stores use. Content-gated (a viewer reads, an
- * editor writes); no draft/published split — a saved+enabled redirect is live.
- *
- * The "New" flow keeps an unsaved redirect as a LOCAL draft (memory only) until
- * the first explicit save persists it — so an abandoned "New" never writes a stub
- * to the backend and never shows in the list. Drafts are reachable via {@link
- * RedirectsStore.get} (the detail editor loads one), never listed.
- */
-export interface RedirectsStore {
-    projectId: string;
-    status: 'loading' | 'ready' | 'error';
-    errorMessage?: string;
-    /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */
-    redirects: readonly RedirectEntry[];
-    /** One redirect: a local unsaved draft if present, else a persisted record. */
-    get(id: string): RedirectEntry | undefined;
-    /** Mint a blank in-memory draft and return its id (the "New" navigation target). */
-    createDraft(): string;
-    /** Persist a create/modify; drops the matching draft on success. */
-    save(input: SaveRedirectInput): Promise<{
-        ok: true;
-        redirect: RedirectEntry;
-    } | {
-        ok: false;
-        message: string;
-    }>;
-    /** Delete a persisted redirect, or silently discard an unsaved draft. */
-    remove(id: string): Promise<{
-        ok: true;
-    } | {
-        ok: false;
-        message: string;
-    }>;
-    /** Re-list from the backend. */
-    refresh(): Promise<void>;
-}
-declare const useRedirects: () => RedirectsStore;
-/**
- * The project's redirects, read through the shared operations cache — the ONE query
- * this rail uses, without needing {@link RedirectsProvider}.
- *
- * Extracted (EC-469) so the section rail's URL-map validation can read redirects from
- * outside the redirects module while sharing this exact query key. One key, one cache
- * entry (AD-17): the rail's foot and the rail itself are the same query, so opening
- * Redirects hits a warm cache, and `save`/`remove`'s `cache.patch` below updates both
- * at once — a fixed loop stops being reported the moment it is fixed.
- */
-export declare function useRedirectList(projectId: string): import("@tanstack/react-query").UseQueryResult<{
-    createdAt: string;
-    updatedAt: string;
-    id: string;
-    projectId: string;
-    from: string;
-    to: string;
-    permanent: boolean;
-    enabled: boolean;
-    meta?: Record<string, unknown> | undefined;
-}[]>;
-export declare function RedirectsProvider({ projectId, children, }: {
-    projectId: string;
-    children: ReactNode;
-}): import("react").JSX.Element;
-export { useRedirects };

package/dist/components/redirects/redirects-store.js

@@ -1,132 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useMemo, useState } from 'react';
-import { getStudioOperations } from '@elytracms/studio/lib/operations';
-import { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query';
-import { createRequiredContext } from '@elytracms/studio/lib/required-context';
-const { Context: RedirectsContext, useRequired: useRedirects } = createRequiredContext('Redirects');
-const EMPTY_REDIRECTS = [];
-let draftCounter = 0;
-/** A collision-resistant client id for a new redirect (used as its real id on save). */
-function newDraftId() {
-    draftCounter += 1;
-    return `redirect_${Date.now().toString(36)}_${draftCounter}`;
-}
-function redirectsQueryKey(projectId) {
-    return ['redirects', projectId];
-}
-async function loadRedirects(operations, projectId) {
-    const result = await operations.redirects.list({ projectId });
-    if (!result.ok)
-        throw new Error(result.error.message);
-    return [...result.value];
-}
-/**
- * The project's redirects, read through the shared operations cache — the ONE query
- * this rail uses, without needing {@link RedirectsProvider}.
- *
- * Extracted (EC-469) so the section rail's URL-map validation can read redirects from
- * outside the redirects module while sharing this exact query key. One key, one cache
- * entry (AD-17): the rail's foot and the rail itself are the same query, so opening
- * Redirects hits a warm cache, and `save`/`remove`'s `cache.patch` below updates both
- * at once — a fixed loop stops being reported the moment it is fixed.
- */
-export function useRedirectList(projectId) {
-    return useOperationQuery({
-        queryKey: redirectsQueryKey(projectId),
-        loader: (operations) => loadRedirects(operations, projectId),
-    });
-}
-function byFrom(a, b) {
-    return a.from < b.from ? -1 : a.from > b.from ? 1 : 0;
-}
-export function RedirectsProvider({ projectId, children, }) {
-    const query = useRedirectList(projectId);
-    const cache = useOperationCache();
-    const refetch = query.refetch;
-    const persisted = query.data ?? EMPTY_REDIRECTS;
-    const { status, errorMessage } = listStoreState(query);
-    // In-memory unsaved "New" drafts, keyed by id. Not listed; only get()-able.
-    const [drafts, setDrafts] = useState({});
-    const refresh = useCallback(async () => {
-        await refetch();
-    }, [refetch]);
-    const get = useCallback((id) => drafts[id] ?? persisted.find((r) => r.id === id), [drafts, persisted]);
-    const createDraft = useCallback(() => {
-        const id = newDraftId();
-        const now = new Date().toISOString();
-        const draft = {
-            id,
-            projectId,
-            from: '',
-            to: '',
-            permanent: true,
-            // New redirects default to enabled — the reason you create one is for it to
-            // work; `enabled` is really the switch for *pausing* an existing redirect. A
-            // half-filled draft can't go live anyway (save requires from/to).
-            enabled: true,
-            createdAt: now,
-            updatedAt: now,
-        };
-        setDrafts((prev) => ({ ...prev, [id]: draft }));
-        return id;
-    }, [projectId]);
-    const save = useCallback(async (input) => {
-        const { operations } = await getStudioOperations();
-        const result = await operations.redirects.save({
-            projectId,
-            ...(input.id !== undefined ? { id: input.id } : {}),
-            from: input.from,
-            to: input.to,
-            ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),
-            ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
-            ...(input.meta !== undefined ? { meta: input.meta } : {}),
-        });
-        if (!result.ok)
-            return { ok: false, message: result.error.message };
-        const saved = result.value;
-        cache.patch(redirectsQueryKey(projectId), (prev) => {
-            const rest = (prev ?? []).filter((r) => r.id !== saved.id);
-            return [...rest, saved].sort(byFrom);
-        });
-        // The record is now persisted — drop any matching draft.
-        setDrafts((prev) => {
-            if (!(saved.id in prev))
-                return prev;
-            const next = { ...prev };
-            delete next[saved.id];
-            return next;
-        });
-        return { ok: true, redirect: saved };
-    }, [projectId, cache]);
-    const remove = useCallback(async (id) => {
-        // An unsaved draft was never persisted — discard it locally, no backend call.
-        if (drafts[id]) {
-            setDrafts((prev) => {
-                const next = { ...prev };
-                delete next[id];
-                return next;
-            });
-            return { ok: true };
-        }
-        const { operations } = await getStudioOperations();
-        const result = await operations.redirects.remove({ projectId, id });
-        if (!result.ok)
-            return { ok: false, message: result.error.message };
-        cache.patch(redirectsQueryKey(projectId), (prev) => (prev ?? []).filter((r) => r.id !== id));
-        return { ok: true };
-    }, [projectId, cache, drafts]);
-    const store = useMemo(() => ({
-        projectId,
-        status,
-        ...(errorMessage !== undefined ? { errorMessage } : {}),
-        redirects: persisted,
-        get,
-        createDraft,
-        save,
-        remove,
-        refresh,
-    }), [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh]);
-    return _jsx(RedirectsContext.Provider, { value: store, children: children });
-}
-export { useRedirects };
-//# sourceMappingURL=redirects-store.js.map

package/dist/components/redirects/redirects-store.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"redirects-store.js","sourceRoot":"","sources":["../../../src/components/redirects/redirects-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { RedirectEntry, SaveRedirectInput } from '@elytracms/core/persistence'\nimport { getStudioOperations } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\n\n/**\n * Editorial redirects store (EC-303). The redirects rail — data-backed 301/302\n * forwards — read + written through the shared operations client (`redirects.*`),\n * the same seam the users/assets stores use. Content-gated (a viewer reads, an\n * editor writes); no draft/published split — a saved+enabled redirect is live.\n *\n * The \"New\" flow keeps an unsaved redirect as a LOCAL draft (memory only) until\n * the first explicit save persists it — so an abandoned \"New\" never writes a stub\n * to the backend and never shows in the list. Drafts are reachable via {@link\n * RedirectsStore.get} (the detail editor loads one), never listed.\n */\n\nexport interface RedirectsStore {\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  /** The persisted redirects, ordered by source path. Unsaved drafts are excluded. */\n  redirects: readonly RedirectEntry[]\n  /** One redirect: a local unsaved draft if present, else a persisted record. */\n  get(id: string): RedirectEntry | undefined\n  /** Mint a blank in-memory draft and return its id (the \"New\" navigation target). */\n  createDraft(): string\n  /** Persist a create/modify; drops the matching draft on success. */\n  save(\n    input: SaveRedirectInput,\n  ): Promise<{ ok: true; redirect: RedirectEntry } | { ok: false; message: string }>\n  /** Delete a persisted redirect, or silently discard an unsaved draft. */\n  remove(id: string): Promise<{ ok: true } | { ok: false; message: string }>\n  /** Re-list from the backend. */\n  refresh(): Promise<void>\n}\n\nconst { Context: RedirectsContext, useRequired: useRedirects } =\n  createRequiredContext<RedirectsStore>('Redirects')\n\nconst EMPTY_REDIRECTS: readonly RedirectEntry[] = []\n\nlet draftCounter = 0\n/** A collision-resistant client id for a new redirect (used as its real id on save). */\nfunction newDraftId(): string {\n  draftCounter += 1\n  return `redirect_${Date.now().toString(36)}_${draftCounter}`\n}\n\nfunction redirectsQueryKey(projectId: string): readonly [string, string] {\n  return ['redirects', projectId]\n}\n\nasync function loadRedirects(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<RedirectEntry[]> {\n  const result = await operations.redirects.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\n/**\n * The project's redirects, read through the shared operations cache — the ONE query\n * this rail uses, without needing {@link RedirectsProvider}.\n *\n * Extracted (EC-469) so the section rail's URL-map validation can read redirects from\n * outside the redirects module while sharing this exact query key. One key, one cache\n * entry (AD-17): the rail's foot and the rail itself are the same query, so opening\n * Redirects hits a warm cache, and `save`/`remove`'s `cache.patch` below updates both\n * at once — a fixed loop stops being reported the moment it is fixed.\n */\nexport function useRedirectList(projectId: string) {\n  return useOperationQuery<RedirectEntry[]>({\n    queryKey: redirectsQueryKey(projectId),\n    loader: (operations) => loadRedirects(operations, projectId),\n  })\n}\n\nfunction byFrom(a: RedirectEntry, b: RedirectEntry): number {\n  return a.from < b.from ? -1 : a.from > b.from ? 1 : 0\n}\n\nexport function RedirectsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const query = useRedirectList(projectId)\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const persisted = query.data ?? EMPTY_REDIRECTS\n  const { status, errorMessage } = listStoreState(query)\n\n  // In-memory unsaved \"New\" drafts, keyed by id. Not listed; only get()-able.\n  const [drafts, setDrafts] = useState<Record<string, RedirectEntry>>({})\n\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const get = useCallback<RedirectsStore['get']>(\n    (id) => drafts[id] ?? persisted.find((r) => r.id === id),\n    [drafts, persisted],\n  )\n\n  const createDraft = useCallback<RedirectsStore['createDraft']>(() => {\n    const id = newDraftId()\n    const now = new Date().toISOString()\n    const draft: RedirectEntry = {\n      id,\n      projectId,\n      from: '',\n      to: '',\n      permanent: true,\n      // New redirects default to enabled — the reason you create one is for it to\n      // work; `enabled` is really the switch for *pausing* an existing redirect. A\n      // half-filled draft can't go live anyway (save requires from/to).\n      enabled: true,\n      createdAt: now,\n      updatedAt: now,\n    }\n    setDrafts((prev) => ({ ...prev, [id]: draft }))\n    return id\n  }, [projectId])\n\n  const save = useCallback<RedirectsStore['save']>(\n    async (input) => {\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.save({\n        projectId,\n        ...(input.id !== undefined ? { id: input.id } : {}),\n        from: input.from,\n        to: input.to,\n        ...(input.permanent !== undefined ? { permanent: input.permanent } : {}),\n        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),\n        ...(input.meta !== undefined ? { meta: input.meta } : {}),\n      })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      const saved = result.value\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) => {\n        const rest = (prev ?? []).filter((r) => r.id !== saved.id)\n        return [...rest, saved].sort(byFrom)\n      })\n      // The record is now persisted — drop any matching draft.\n      setDrafts((prev) => {\n        if (!(saved.id in prev)) return prev\n        const next = { ...prev }\n        delete next[saved.id]\n        return next\n      })\n      return { ok: true, redirect: saved }\n    },\n    [projectId, cache],\n  )\n\n  const remove = useCallback<RedirectsStore['remove']>(\n    async (id) => {\n      // An unsaved draft was never persisted — discard it locally, no backend call.\n      if (drafts[id]) {\n        setDrafts((prev) => {\n          const next = { ...prev }\n          delete next[id]\n          return next\n        })\n        return { ok: true }\n      }\n      const { operations } = await getStudioOperations()\n      const result = await operations.redirects.remove({ projectId, id })\n      if (!result.ok) return { ok: false, message: result.error.message }\n      cache.patch<RedirectEntry[]>(redirectsQueryKey(projectId), (prev) =>\n        (prev ?? []).filter((r) => r.id !== id),\n      )\n      return { ok: true }\n    },\n    [projectId, cache, drafts],\n  )\n\n  const store = useMemo<RedirectsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      redirects: persisted,\n      get,\n      createDraft,\n      save,\n      remove,\n      refresh,\n    }),\n    [projectId, status, errorMessage, persisted, get, createDraft, save, remove, refresh],\n  )\n\n  return <RedirectsContext.Provider value={store}>{children}</RedirectsContext.Provider>\n}\n\nexport { useRedirects }\n"]}

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"]}