@elytracms/studio 0.0.92 → 0.0.93

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

@@ -1,5 +1,6 @@
 import { useCallback, useMemo } from 'react';
 import { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core';
+import { assetAlt } from '@elytracms/core/persistence';
 import { studioPath } from '@elytracms/studio/router';
 import { useAssets } from './assets-store.js';
 import { SYSTEM_ASSET_FIELDS, pruneMeta } from './asset-metadata.js';
@@ -73,16 +74,19 @@ function systemFieldValue(record, name) {
  * schema or not, so a save hands the bag back whole (D22). Declared fields then
  * take their canonical reading on top — a column never loses to a same-named meta
  * key: a system column (`filename`, `url`, dimensions, …) reads straight off the
- * record, and `alt`, schema-driven but ALSO a legacy record column, reads the meta
- * value falling back to the column (matches delivery's `meta.alt ?? record.alt`
- * read and the image field's options dialog).
+ * record, and `alt` reads through THE reader (`assetAlt`, EC-587 — `meta.alt`, with a
+ * not-yet-migrated legacy column lifted in), exactly what delivery and the image
+ * field's options dialog show.
  */
 export function assetToDocument(collection, record) {
     const values = { ...(record.meta ?? {}) };
     for (const field of collection.fields) {
         if (field.name === 'alt') {
-            const metaAlt = typeof record.meta?.alt === 'string' ? record.meta.alt : undefined;
-            values.alt = metaAlt ?? record.alt;
+            const alt = assetAlt(record);
+            if (alt !== null)
+                values.alt = alt;
+            else
+                delete values.alt;
         }
         else if (SYSTEM_ASSET_FIELDS.has(field.name)) {
             values[field.name] = systemFieldValue(record, field.name);

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

@@ -1 +1 @@
-{"version":3,"file":"assets-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/assets/assets-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 { AssetRecord, ReferenceTarget } from '@elytracms/core/persistence'\nimport type { OperationError } from '@elytracms/core/operations'\nimport { studioPath } from '@elytracms/studio/router'\nimport type { DeleteAssetResult } from '@elytracms/studio/lib/assets'\nimport type { CollectionViewSource, CollectionViewCapabilities } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useAssets } from './assets-store'\nimport { SYSTEM_ASSET_FIELDS, pruneMeta } from './asset-metadata'\nimport { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source'\nimport { parseLocaleConfig } from '@elytracms/core/cms-core'\n\n/** The assets rail is not localized in v1 (EC-301: asset metadata is non-localized). */\nconst ASSETS_LOCALE: Locale = 'en'\nconst ASSETS_LOCALE_CONFIG: LocaleConfig = parseLocaleConfig({\n  default: ASSETS_LOCALE,\n  locales: [ASSETS_LOCALE],\n})\n\n/**\n * The capability profile of the assets rail (EC-319, EC-433). Hoisted to a\n * module-level constant (no prop/state dependency) so it's both the value the\n * hook returns AND independently unit-testable.\n *\n * `create` is off — a new asset comes from an upload, never a blank draft.\n * `remove` + `bulk` are ON since EC-433: the list's row/bulk delete used to be\n * off deliberately because the generic `ReferenceConfirmDialog` enumerated\n * inbound references as `{ type: 'document' }` targets — the wrong index shape\n * for an asset — which would have shown \"not referenced\" for an asset that IS\n * referenced. That pre-flight now queries the shape THIS source declares via\n * {@link assetReferenceTarget} (`{ type: 'asset' }`, the same lookup the\n * detail surface runs), and the confirmed delete dispatches the SAME checked\n * store delete the detail surface uses (`deleteAsset`: original + EC-400 thumb\n * blobs, then the record — EC-420 lqips ride on the record). Nothing else\n * applies to assets: no publish/versions/locales/inline-edit/live-URL/\n * hierarchy/import-export.\n */\nexport const ASSET_COLLECTION_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: false,\n  duplicate: false, // EC-442: blob duplication is a different feature, out of scope\n  remove: true,\n  bulk: true,\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false,\n  adminOnly: false,\n}\n\n/** Read one of the record's fixed, upload-managed columns by field name. */\nfunction systemFieldValue(record: AssetRecord, name: string): unknown {\n  switch (name) {\n    case 'filename':\n      return record.filename\n    case 'url':\n      return record.url\n    case 'contentType':\n      return record.contentType\n    case 'byteSize':\n      return record.byteSize\n    case 'width':\n      return record.width\n    case 'height':\n      return record.height\n    case 'storageKey':\n      return record.storageKey\n    case 'title':\n      return record.title\n    default:\n      return undefined\n  }\n}\n\n/**\n * Project a stored asset record into the lens's `values` shape (EC-319) — the\n * value-keyed projection the redirects/users rails use (EC-577, RESIDUE-3d): EVERY\n * key of the record's open `meta` bag (EC-301) rides in `values`, declared by the\n * schema or not, so a save hands the bag back whole (D22). Declared fields then\n * take their canonical reading on top — a column never loses to a same-named meta\n * key: a system column (`filename`, `url`, dimensions, …) reads straight off the\n * record, and `alt`, schema-driven but ALSO a legacy record column, reads the meta\n * value falling back to the column (matches delivery's `meta.alt ?? record.alt`\n * read and the image field's options dialog).\n */\nexport function assetToDocument(collection: CollectionDef, record: AssetRecord): CmsDocument {\n  const values: Record<string, unknown> = { ...(record.meta ?? {}) }\n  for (const field of collection.fields) {\n    if (field.name === 'alt') {\n      const metaAlt = typeof record.meta?.alt === 'string' ? record.meta.alt : undefined\n      values.alt = metaAlt ?? record.alt\n    } else if (SYSTEM_ASSET_FIELDS.has(field.name)) {\n      values[field.name] = systemFieldValue(record, field.name)\n    }\n  }\n  return { collection: collection.id, id: record.id, values }\n}\n\n/**\n * The inverse of {@link assetToDocument}: the meta bag a save writes back — every\n * value outside the system set (EC-301/EC-311), declared or not, through the ONE\n * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d).\n * `meta` is written whole (it replaces the stored bag), so a key the lens never\n * declared must be in it: the schema-driven projection this replaced dropped them\n * on every rail save (D22), while the options dialog and asset detail kept them.\n * System columns are upload-managed and never written here.\n */\nexport function documentToAssetMetaPatch(doc: CmsDocument): Record<string, unknown> {\n  return pruneMeta(metaBagProjection(doc.values ?? {}, SYSTEM_ASSET_FIELDS))\n}\n\n/** `create` when `capabilities.create === false` — never reached from the UI\n *  (list/detail never call it); an explicit throw rather than a silent no-op. */\nfunction createUnsupported(): DocumentRef {\n  throw new Error('assets are created by upload, not the assets rail')\n}\n\n/** Assets' `remove()` returns an `outcome`-discriminated {@link DeleteAssetResult}\n *  (not the `{ ok }` shape users/redirects use, EC-327). `'error'` surfaces as-is;\n *  `'blocked'` (the unconfirmed usage gate fired — nothing was removed) surfaces\n *  as an explicit failure too (EC-433): a delete that left the asset in place\n *  must NEVER look like success. It is unreachable from this rail's UI — every\n *  delete path confirms through the reference dialog and dispatches with\n *  `confirmInUse` — but stays honest for any direct caller. `'not-found'` maps\n *  to success (idempotent delete: the desired end state — gone — holds). */\nexport function normalizeAssetRemoveResult(result: DeleteAssetResult): OperationError | null {\n  if (result.outcome === 'error') return { code: 'unknown', message: result.message }\n  if (result.outcome === 'blocked') {\n    return {\n      code: 'unknown',\n      message: `Asset is referenced in ${result.usageCount} ${result.usageCount === 1 ? 'place' : 'places'} and was not deleted.`,\n    }\n  }\n  return null\n}\n\n/**\n * How an asset row is addressed in the EC-155 reference index (EC-433):\n * `{ type: 'asset' }`, never the document shape — so the delete confirmation's\n * inbound pre-flight counts the SAME references `loadInboundAssetReferenceViews`\n * (the detail surface's check) does.\n */\nexport function assetReferenceTarget(ref: DocumentRef): ReferenceTarget {\n  return { type: 'asset', id: ref.id }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **assets rail** (EC-319) — the\n * portable list surface over the existing asset library store instead of a\n * bespoke listing. `schema` is the DEPLOYMENT-resolved `kind:'asset'` collection\n * (EC-311: a project's own declared fields, or a mount's `nav.assets({ fields })`\n * override merged over it — see `resolveAssetsSchema` in `app-views/default-modules.tsx`),\n * never a hardcoded engine default — so a project's `copyright`/`credit`/… fields\n * (and any EC-311 override) drive the list's columns/filters exactly as they\n * drive the image field's options dialog.\n *\n * Must be mounted under an `<AssetsProvider>` (for {@link useAssets}) — already\n * ambient at the project level (EC-195), so callers rarely mount their own.\n *\n * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`\n * plumbing and the assembled source; this hook supplies only the asset-store\n * reads/writes, the capability profile, and the projections above.\n */\nexport function useAssetsCollectionViewSource(\n  projectId: string,\n  schema: CollectionDef,\n): CollectionViewSource {\n  const store = useAssets()\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n\n  const documents = useCallback(\n    () => store.assets.map((record) => assetToDocument(schema, record)),\n    [store.assets, schema],\n  )\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.assets.find((a) => a.id === ref.id)\n      return record ? assetToDocument(schema, record) : undefined\n    },\n    [store.assets, schema],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => {\n      const record = store.assets.find((a) => a.id === ref.id)\n      return record?.title ?? record?.filename ?? ref.id\n    },\n    [store.assets],\n  )\n  const validate = useCallback(\n    (doc: CmsDocument) => validateDocument(registry, doc, { localeConfig: ASSETS_LOCALE_CONFIG }),\n    [registry],\n  )\n  const save = useCallback(\n    (doc: CmsDocument) => store.updateMetadata(doc.id, { meta: documentToAssetMetaPatch(doc) }),\n    [store],\n  )\n  // The unconfirmed delete (the store's usage gate still applies — a referenced\n  // asset comes back `blocked`, surfaced via `lastError`). The UI's delete paths\n  // never land here: row/bulk deletes confirm through the reference dialog and\n  // dispatch `bulkRemove` below.\n  const remove = useCallback((ref: DocumentRef) => store.remove(ref.id), [store])\n  // The CONFIRMED delete the bulk/row path dispatches (EC-433): the reference\n  // dialog has already enumerated inbound usages (asset-shaped, see\n  // `assetReferenceTarget`), so this passes `confirmInUse` exactly like the\n  // detail surface's confirmed delete — same blob + thumb + cache handling.\n  const bulkRemove = useCallback(\n    (ref: DocumentRef) => store.remove(ref.id, { confirmInUse: true }),\n    [store],\n  )\n\n  return useRailViewSource({\n    projectId,\n    schema,\n    capabilities: ASSET_COLLECTION_CAPABILITIES,\n    localeConfig: ASSETS_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    // No `referenceCandidates`/`collections`/`isFieldReadOnly` override: assets carry\n    // no relation/asset fields of their own (v1) — nothing cross-collection to\n    // resolve — and read-only follows the factory's default `form.readOnly` check.\n    detailPath: (id: string) => studioPath.asset(id),\n    listPath: studioPath.assets(),\n    // EC-433: the delete confirmation must enumerate ASSET-shaped inbound\n    // references — the document-shaped default would report \"not referenced\"\n    // for a referenced asset.\n    referenceTarget: assetReferenceTarget,\n    validate,\n    create: createUnsupported,\n    save,\n    remove,\n    bulkRemove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeAssetRemoveResult,\n  })\n}\n"]}
+{"version":3,"file":"assets-collection-view-source.js","sourceRoot":"","sources":["../../../src/components/assets/assets-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 { assetAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord, ReferenceTarget } from '@elytracms/core/persistence'\nimport type { OperationError } from '@elytracms/core/operations'\nimport { studioPath } from '@elytracms/studio/router'\nimport type { DeleteAssetResult } from '@elytracms/studio/lib/assets'\nimport type { CollectionViewSource, CollectionViewCapabilities } from '@elytracms/studio/lib/collection-view/collection-view-source'\nimport { useAssets } from './assets-store'\nimport { SYSTEM_ASSET_FIELDS, pruneMeta } from './asset-metadata'\nimport { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source'\nimport { parseLocaleConfig } from '@elytracms/core/cms-core'\n\n/** The assets rail is not localized in v1 (EC-301: asset metadata is non-localized). */\nconst ASSETS_LOCALE: Locale = 'en'\nconst ASSETS_LOCALE_CONFIG: LocaleConfig = parseLocaleConfig({\n  default: ASSETS_LOCALE,\n  locales: [ASSETS_LOCALE],\n})\n\n/**\n * The capability profile of the assets rail (EC-319, EC-433). Hoisted to a\n * module-level constant (no prop/state dependency) so it's both the value the\n * hook returns AND independently unit-testable.\n *\n * `create` is off — a new asset comes from an upload, never a blank draft.\n * `remove` + `bulk` are ON since EC-433: the list's row/bulk delete used to be\n * off deliberately because the generic `ReferenceConfirmDialog` enumerated\n * inbound references as `{ type: 'document' }` targets — the wrong index shape\n * for an asset — which would have shown \"not referenced\" for an asset that IS\n * referenced. That pre-flight now queries the shape THIS source declares via\n * {@link assetReferenceTarget} (`{ type: 'asset' }`, the same lookup the\n * detail surface runs), and the confirmed delete dispatches the SAME checked\n * store delete the detail surface uses (`deleteAsset`: original + EC-400 thumb\n * blobs, then the record — EC-420 lqips ride on the record). Nothing else\n * applies to assets: no publish/versions/locales/inline-edit/live-URL/\n * hierarchy/import-export.\n */\nexport const ASSET_COLLECTION_CAPABILITIES: CollectionViewCapabilities = {\n  publish: false,\n  versions: false,\n  locales: false,\n  inlineEdit: false,\n  create: false,\n  duplicate: false, // EC-442: blob duplication is a different feature, out of scope\n  remove: true,\n  bulk: true,\n  liveUrl: false,\n  hierarchy: false,\n  importExport: false,\n  adminOnly: false,\n}\n\n/** Read one of the record's fixed, upload-managed columns by field name. */\nfunction systemFieldValue(record: AssetRecord, name: string): unknown {\n  switch (name) {\n    case 'filename':\n      return record.filename\n    case 'url':\n      return record.url\n    case 'contentType':\n      return record.contentType\n    case 'byteSize':\n      return record.byteSize\n    case 'width':\n      return record.width\n    case 'height':\n      return record.height\n    case 'storageKey':\n      return record.storageKey\n    case 'title':\n      return record.title\n    default:\n      return undefined\n  }\n}\n\n/**\n * Project a stored asset record into the lens's `values` shape (EC-319) — the\n * value-keyed projection the redirects/users rails use (EC-577, RESIDUE-3d): EVERY\n * key of the record's open `meta` bag (EC-301) rides in `values`, declared by the\n * schema or not, so a save hands the bag back whole (D22). Declared fields then\n * take their canonical reading on top — a column never loses to a same-named meta\n * key: a system column (`filename`, `url`, dimensions, …) reads straight off the\n * record, and `alt` reads through THE reader (`assetAlt`, EC-587 — `meta.alt`, with a\n * not-yet-migrated legacy column lifted in), exactly what delivery and the image\n * field's options dialog show.\n */\nexport function assetToDocument(collection: CollectionDef, record: AssetRecord): CmsDocument {\n  const values: Record<string, unknown> = { ...(record.meta ?? {}) }\n  for (const field of collection.fields) {\n    if (field.name === 'alt') {\n      const alt = assetAlt(record)\n      if (alt !== null) values.alt = alt\n      else delete values.alt\n    } else if (SYSTEM_ASSET_FIELDS.has(field.name)) {\n      values[field.name] = systemFieldValue(record, field.name)\n    }\n  }\n  return { collection: collection.id, id: record.id, values }\n}\n\n/**\n * The inverse of {@link assetToDocument}: the meta bag a save writes back — every\n * value outside the system set (EC-301/EC-311), declared or not, through the ONE\n * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d).\n * `meta` is written whole (it replaces the stored bag), so a key the lens never\n * declared must be in it: the schema-driven projection this replaced dropped them\n * on every rail save (D22), while the options dialog and asset detail kept them.\n * System columns are upload-managed and never written here.\n */\nexport function documentToAssetMetaPatch(doc: CmsDocument): Record<string, unknown> {\n  return pruneMeta(metaBagProjection(doc.values ?? {}, SYSTEM_ASSET_FIELDS))\n}\n\n/** `create` when `capabilities.create === false` — never reached from the UI\n *  (list/detail never call it); an explicit throw rather than a silent no-op. */\nfunction createUnsupported(): DocumentRef {\n  throw new Error('assets are created by upload, not the assets rail')\n}\n\n/** Assets' `remove()` returns an `outcome`-discriminated {@link DeleteAssetResult}\n *  (not the `{ ok }` shape users/redirects use, EC-327). `'error'` surfaces as-is;\n *  `'blocked'` (the unconfirmed usage gate fired — nothing was removed) surfaces\n *  as an explicit failure too (EC-433): a delete that left the asset in place\n *  must NEVER look like success. It is unreachable from this rail's UI — every\n *  delete path confirms through the reference dialog and dispatches with\n *  `confirmInUse` — but stays honest for any direct caller. `'not-found'` maps\n *  to success (idempotent delete: the desired end state — gone — holds). */\nexport function normalizeAssetRemoveResult(result: DeleteAssetResult): OperationError | null {\n  if (result.outcome === 'error') return { code: 'unknown', message: result.message }\n  if (result.outcome === 'blocked') {\n    return {\n      code: 'unknown',\n      message: `Asset is referenced in ${result.usageCount} ${result.usageCount === 1 ? 'place' : 'places'} and was not deleted.`,\n    }\n  }\n  return null\n}\n\n/**\n * How an asset row is addressed in the EC-155 reference index (EC-433):\n * `{ type: 'asset' }`, never the document shape — so the delete confirmation's\n * inbound pre-flight counts the SAME references `loadInboundAssetReferenceViews`\n * (the detail surface's check) does.\n */\nexport function assetReferenceTarget(ref: DocumentRef): ReferenceTarget {\n  return { type: 'asset', id: ref.id }\n}\n\n/**\n * Assemble a {@link CollectionViewSource} for the **assets rail** (EC-319) — the\n * portable list surface over the existing asset library store instead of a\n * bespoke listing. `schema` is the DEPLOYMENT-resolved `kind:'asset'` collection\n * (EC-311: a project's own declared fields, or a mount's `nav.assets({ fields })`\n * override merged over it — see `resolveAssetsSchema` in `app-views/default-modules.tsx`),\n * never a hardcoded engine default — so a project's `copyright`/`credit`/… fields\n * (and any EC-311 override) drive the list's columns/filters exactly as they\n * drive the image field's options dialog.\n *\n * Must be mounted under an `<AssetsProvider>` (for {@link useAssets}) — already\n * ambient at the project level (EC-195), so callers rarely mount their own.\n *\n * The shared scaffold (`useRailViewSource`, EC-327) owns `viewState`/`lastError`\n * plumbing and the assembled source; this hook supplies only the asset-store\n * reads/writes, the capability profile, and the projections above.\n */\nexport function useAssetsCollectionViewSource(\n  projectId: string,\n  schema: CollectionDef,\n): CollectionViewSource {\n  const store = useAssets()\n  const registry = useMemo(() => createCollectionRegistry([schema]), [schema])\n\n  const documents = useCallback(\n    () => store.assets.map((record) => assetToDocument(schema, record)),\n    [store.assets, schema],\n  )\n  const get = useCallback(\n    (ref: DocumentRef): CmsDocument | undefined => {\n      const record = store.assets.find((a) => a.id === ref.id)\n      return record ? assetToDocument(schema, record) : undefined\n    },\n    [store.assets, schema],\n  )\n  const titleOf = useCallback(\n    (ref: DocumentRef): string => {\n      const record = store.assets.find((a) => a.id === ref.id)\n      return record?.title ?? record?.filename ?? ref.id\n    },\n    [store.assets],\n  )\n  const validate = useCallback(\n    (doc: CmsDocument) => validateDocument(registry, doc, { localeConfig: ASSETS_LOCALE_CONFIG }),\n    [registry],\n  )\n  const save = useCallback(\n    (doc: CmsDocument) => store.updateMetadata(doc.id, { meta: documentToAssetMetaPatch(doc) }),\n    [store],\n  )\n  // The unconfirmed delete (the store's usage gate still applies — a referenced\n  // asset comes back `blocked`, surfaced via `lastError`). The UI's delete paths\n  // never land here: row/bulk deletes confirm through the reference dialog and\n  // dispatch `bulkRemove` below.\n  const remove = useCallback((ref: DocumentRef) => store.remove(ref.id), [store])\n  // The CONFIRMED delete the bulk/row path dispatches (EC-433): the reference\n  // dialog has already enumerated inbound usages (asset-shaped, see\n  // `assetReferenceTarget`), so this passes `confirmInUse` exactly like the\n  // detail surface's confirmed delete — same blob + thumb + cache handling.\n  const bulkRemove = useCallback(\n    (ref: DocumentRef) => store.remove(ref.id, { confirmInUse: true }),\n    [store],\n  )\n\n  return useRailViewSource({\n    projectId,\n    schema,\n    capabilities: ASSET_COLLECTION_CAPABILITIES,\n    localeConfig: ASSETS_LOCALE_CONFIG,\n    documents,\n    get,\n    titleOf,\n    // No `referenceCandidates`/`collections`/`isFieldReadOnly` override: assets carry\n    // no relation/asset fields of their own (v1) — nothing cross-collection to\n    // resolve — and read-only follows the factory's default `form.readOnly` check.\n    detailPath: (id: string) => studioPath.asset(id),\n    listPath: studioPath.assets(),\n    // EC-433: the delete confirmation must enumerate ASSET-shaped inbound\n    // references — the document-shaped default would report \"not referenced\"\n    // for a referenced asset.\n    referenceTarget: assetReferenceTarget,\n    validate,\n    create: createUnsupported,\n    save,\n    remove,\n    bulkRemove,\n    normalizeSaveResult: normalizeOkResult,\n    normalizeRemoveResult: normalizeAssetRemoveResult,\n  })\n}\n"]}

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

@@ -46,6 +46,12 @@ export interface AssetsStore {
     }): Promise<DeleteAssetResult>;
     /** Edit alt/title (EC-152); persists through the operations asset facade. */
     updateMetadata(assetId: string, patch: AssetMetadataPatch): Promise<UpdateAssetMetadataResult>;
+    /**
+     * EC-568 — replace the file inside an asset: the same id, the new bytes, everything
+     * derived regenerated through THE upload path, the file's embedded metadata over
+     * `meta` per key (else kept), the focal point kept.
+     */
+    replaceFile(assetId: string, file: UploadableFile): Promise<ReplaceFileResult>;
     /**
      * Backfill downscaled previews onto existing images (EC-400 AD-1). Sequential,
      * idempotent, cancellable; each patch flows through the operations facade and
@@ -58,6 +64,14 @@ export interface AssetsStore {
     }): Promise<BackfillProgress>;
     refresh(): Promise<void>;
 }
+/** The outcome of {@link AssetsStore.replaceFile}. */
+export type ReplaceFileResult = {
+    ok: true;
+    asset: AssetRecord;
+} | {
+    ok: false;
+    message: string;
+};
 declare const useAssets: () => AssetsStore;
 export declare function AssetsProvider({ projectId, children, }: {
     projectId: string;

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

@@ -3,6 +3,7 @@ import { useCallback, useContext, useMemo, useRef, useState } from 'react';
 import { deleteAsset, runVariantBackfill, runUpload, xhrUploadTransport } from '@elytracms/studio/lib/assets';
 import { loadInboundAssetReferenceViews } from '@elytracms/studio/lib/references';
 import { getStudioOperations, operationsAssetRepository } from '@elytracms/studio/lib/operations';
+import { projectCollections } from '@elytracms/studio/lib/operations/project-runtime-config';
 import { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query';
 import { createRequiredContext } from '@elytracms/studio/lib/required-context';
 import { updateAssetMetadata } from './asset-metadata.js';
@@ -27,6 +28,9 @@ export function AssetsProvider({ projectId, children, }) {
     const landedRef = useRef(new Map());
     const uploadSeq = useRef(0);
     const [uploads, setUploads] = useState([]);
+    // EC-568: the asset collection's fields — their `source` declarations map a file's
+    // embedded IPTC facts onto `meta` on every upload and replace. Config, read once.
+    const assetFields = useMemo(() => projectCollections(projectId).find((collection) => collection.kind === 'asset')?.fields, [projectId]);
     /** The shared studio operations bundle + the metadata-write facade over it. */
     const studio = useCallback(async () => {
         const bundle = await getStudioOperations();
@@ -58,6 +62,7 @@ export function AssetsProvider({ projectId, children, }) {
             // confirmed through the `assets.upsert` operation command.
             blobs: adapter.blobs,
             assets: assetRepo,
+            ...(assetFields ? { assetFields } : {}),
             ...(typeof XMLHttpRequest !== 'undefined' ? { transport: xhrUploadTransport } : {}),
         }, {
             projectId,
@@ -71,7 +76,7 @@ export function AssetsProvider({ projectId, children, }) {
             setUploads((prev) => prev.filter((u) => u.id !== uploadId));
             await refresh();
         }
-    }, [studio, projectId, refresh, setUploadState]);
+    }, [studio, projectId, refresh, setUploadState, assetFields]);
     const upload = useCallback((files) => {
         const ids = [];
         for (const file of files) {
@@ -132,6 +137,21 @@ export function AssetsProvider({ projectId, children, }) {
         }
         return result;
     }, [studio, projectId, cache]);
+    const replaceFile = useCallback(async (assetId, file) => {
+        const { adapter, assetRepo } = await studio();
+        // EC-568: THE upload path, in replace mode — not a second uploader.
+        const result = await runUpload({
+            blobs: adapter.blobs,
+            assets: assetRepo,
+            ...(assetFields ? { assetFields } : {}),
+            ...(typeof XMLHttpRequest !== 'undefined' ? { transport: xhrUploadTransport } : {}),
+        }, { projectId, file, replace: { assetId } });
+        if (!result.ok)
+            return { ok: false, message: result.failure.message };
+        const updated = result.asset;
+        cache.patch(assetsQueryKey(projectId), (prev) => (prev ?? []).map((a) => (a.id === assetId ? updated : a)));
+        return { ok: true, asset: updated };
+    }, [studio, projectId, cache, assetFields]);
     const generatePreviews = useCallback(async (handlers) => {
         const { adapter, assetRepo } = await studio();
         // Reads (list) + the variant patch (upsert) go through the operations facade;
@@ -160,6 +180,7 @@ export function AssetsProvider({ projectId, children, }) {
         usagesOf,
         remove,
         updateMetadata,
+        replaceFile,
         generatePreviews,
         refresh,
     }), [
@@ -175,6 +196,7 @@ export function AssetsProvider({ projectId, children, }) {
         usagesOf,
         remove,
         updateMetadata,
+        replaceFile,
         generatePreviews,
         refresh,
     ]);

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

@@ -1 +1 @@
-{"version":3,"file":"assets-store.js","sourceRoot":"","sources":["../../../src/components/assets/assets-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { AssetRecord, AssetRepository } from '@elytracms/core/persistence'\nimport { deleteAsset, runVariantBackfill, runUpload, xhrUploadTransport } from '@elytracms/studio/lib/assets'\nimport type {\n  BackfillProgress,\n  BackfillSignal,\n  DeleteAssetResult,\n  UploadState,\n  UploadableFile,\n} from '@elytracms/studio/lib/assets'\nimport { loadInboundAssetReferenceViews } from '@elytracms/studio/lib/references'\nimport type { ReferenceEntryView } from '@elytracms/studio/lib/references'\nimport { getStudioOperations, operationsAssetRepository } from '@elytracms/studio/lib/operations'\nimport type { OperationsClient, StudioOperations } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\nimport { updateAssetMetadata } from './asset-metadata'\nimport type { AssetMetadataPatch, UpdateAssetMetadataResult } from './asset-metadata'\n\n/**\n * Asset library store (EC-151, EC-141). Asset *metadata* mutations go through\n * the shared operations client (`assets.*` commands — validate → authorize →\n * mutate → event); blob *bytes* ride on `adapter.blobs`, which is transport,\n * not domain. The UI works identically against the in-memory seed and a live\n * Convex deployment.\n */\n\nexport interface UploadEntry {\n  id: string\n  filename: string\n  state: UploadState\n}\n\nexport interface AssetsStore {\n  /** The active project (e.g. for reference deep links, EC-202). */\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  assets: readonly AssetRecord[]\n  uploads: readonly UploadEntry[]\n  /**\n   * Queue files for upload. Returns the upload-queue id of each file, in order, so a\n   * caller can follow exactly ITS uploads (EC-588 A7) — see {@link landedAssetId}.\n   */\n  upload(files: Iterable<UploadableFile>): readonly string[]\n  /**\n   * The asset id an upload landed as, once its record is confirmed (EC-588 A7);\n   * `undefined` while it runs, after it failed, or for an id this store never issued.\n   * A completed upload leaves the queue, so this is where its outcome stays readable.\n   */\n  landedAssetId(uploadId: string): string | undefined\n  retryUpload(uploadId: string): void\n  dismissUpload(uploadId: string): void\n  /**\n   * Index-accurate inbound references of an asset (EC-202): the \"used by\"\n   * pre-flight of the block-or-confirm delete dialog, read from the EC-155\n   * reference index (not the retired string scan).\n   */\n  usagesOf(assetId: string): Promise<ReferenceEntryView[]>\n  remove(assetId: string, options?: { confirmInUse?: boolean }): Promise<DeleteAssetResult>\n  /** Edit alt/title (EC-152); persists through the operations asset facade. */\n  updateMetadata(assetId: string, patch: AssetMetadataPatch): Promise<UpdateAssetMetadataResult>\n  /**\n   * Backfill downscaled previews onto existing images (EC-400 AD-1). Sequential,\n   * idempotent, cancellable; each patch flows through the operations facade and\n   * the shared query cache (AD-5/AD-17). Reports progress via `handlers.onProgress`\n   * and stops when `handlers.signal.cancelled` flips.\n   */\n  generatePreviews(handlers?: {\n    onProgress?: (progress: BackfillProgress) => void\n    signal?: BackfillSignal\n  }): Promise<BackfillProgress>\n  refresh(): Promise<void>\n}\n\nconst { Context: AssetsContext, useRequired: useAssets } = createRequiredContext<AssetsStore>(\n  'Assets',\n  { article: 'an' },\n)\n\nconst EMPTY_ASSETS: readonly AssetRecord[] = []\n\n/** Cache key for a project's asset library (shared by the query and its patches). */\nfunction assetsQueryKey(projectId: string): readonly [string, string] {\n  return ['assets', projectId]\n}\n\n/** Load a project's asset library (pure over the operations client). A list\n *  failure throws so the query surfaces it as an error status. */\nasync function loadAssets(operations: OperationsClient, projectId: string): Promise<AssetRecord[]> {\n  const result = await operations.assets.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\nexport function AssetsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const uploadFilesRef = useRef(new Map<string, UploadableFile>())\n  // EC-588 A7: upload id → the asset id it landed as. Written BEFORE the entry leaves\n  // the queue, so a reader never sees an upload that is neither running nor landed.\n  const landedRef = useRef(new Map<string, string>())\n  const uploadSeq = useRef(0)\n  const [uploads, setUploads] = useState<readonly UploadEntry[]>([])\n\n  /** The shared studio operations bundle + the metadata-write facade over it. */\n  const studio = useCallback(async (): Promise<\n    StudioOperations & { assetRepo: AssetRepository }\n  > => {\n    const bundle = await getStudioOperations()\n    return { ...bundle, assetRepo: operationsAssetRepository(bundle.operations) }\n  }, [])\n\n  // The library list, read through the one operations-backed query cache\n  // (EC-308/AD-17). No `invalidateOn`: this provider is the sole writer of its\n  // project's assets, so its own mutations patch the cache in place (the EC-301\n  // rule — a metadata or focal-point edit must never trigger a full re-list).\n  const query = useOperationQuery<AssetRecord[]>({\n    queryKey: assetsQueryKey(projectId),\n    loader: (operations) => loadAssets(operations, projectId),\n  })\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const assets = query.data ?? EMPTY_ASSETS\n  const { status, errorMessage } = listStoreState(query)\n\n  /** Re-list from the backend (the public escape hatch + post-upload reconcile). */\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const setUploadState = useCallback((uploadId: string, state: UploadState) => {\n    setUploads((prev) => prev.map((u) => (u.id === uploadId ? { ...u, state } : u)))\n  }, [])\n\n  const runEntry = useCallback(\n    async (uploadId: string, file: UploadableFile, previous?: UploadState) => {\n      const { adapter, assetRepo } = await studio()\n      const result = await runUpload(\n        {\n          // Bytes ride on blob storage (transport); the metadata record is\n          // confirmed through the `assets.upsert` operation command.\n          blobs: adapter.blobs,\n          assets: assetRepo,\n          ...(typeof XMLHttpRequest !== 'undefined' ? { transport: xhrUploadTransport } : {}),\n        },\n        {\n          projectId,\n          file,\n          onState: (state) => setUploadState(uploadId, state),\n        },\n        previous,\n      )\n      if (result.ok) {\n        // Completed uploads leave the queue; the asset appears in the library.\n        landedRef.current.set(uploadId, result.asset.id)\n        uploadFilesRef.current.delete(uploadId)\n        setUploads((prev) => prev.filter((u) => u.id !== uploadId))\n        await refresh()\n      }\n    },\n    [studio, projectId, refresh, setUploadState],\n  )\n\n  const upload = useCallback(\n    (files: Iterable<UploadableFile>): readonly string[] => {\n      const ids: string[] = []\n      for (const file of files) {\n        uploadSeq.current += 1\n        const uploadId = `upload-${uploadSeq.current}`\n        ids.push(uploadId)\n        uploadFilesRef.current.set(uploadId, file)\n        setUploads((prev) => [\n          ...prev,\n          { id: uploadId, filename: file.name, state: { phase: 'idle', progress: 0, attempt: 0 } },\n        ])\n        void runEntry(uploadId, file)\n      }\n      return ids\n    },\n    [runEntry],\n  )\n\n  const landedAssetId = useCallback((uploadId: string) => landedRef.current.get(uploadId), [])\n\n  const retryUpload = useCallback(\n    (uploadId: string) => {\n      const file = uploadFilesRef.current.get(uploadId)\n      const entry = uploads.find((u) => u.id === uploadId)\n      if (!file || !entry || entry.state.phase !== 'failed') return\n      void runEntry(uploadId, file, entry.state)\n    },\n    [runEntry, uploads],\n  )\n\n  const dismissUpload = useCallback((uploadId: string) => {\n    uploadFilesRef.current.delete(uploadId)\n    setUploads((prev) => prev.filter((u) => u.id !== uploadId))\n  }, [])\n\n  const usagesOf = useCallback(\n    // Index-accurate (EC-202): inbound references from the EC-155 index via the\n    // operations queries — the same machinery the References panel uses.\n    async (assetId: string) => loadInboundAssetReferenceViews(projectId, assetId),\n    [projectId],\n  )\n\n  const remove = useCallback(\n    async (assetId: string, options?: { confirmInUse?: boolean }) => {\n      const { adapter, assetRepo } = await studio()\n      // Metadata removal goes through the `assets.remove` command (via the\n      // facade); blob byte deletion stays on the adapter; the usage gate reads\n      // the EC-155 reference index (`adapter.references`, EC-202).\n      const result = await deleteAsset(\n        { assets: assetRepo, blobs: adapter.blobs, references: adapter.references },\n        projectId,\n        assetId,\n        options,\n      )\n      // Drop the one removed record from the cache rather than re-listing the whole\n      // library (EC-301 perf, mirrors updateMetadata) — a delete must not trigger a full\n      // `assets.list` round-trip on top of the deletion itself.\n      if (result.outcome === 'deleted' || result.outcome === 'not-found') {\n        cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n          (prev ?? []).filter((a) => a.id !== assetId),\n        )\n      }\n      return result\n    },\n    [studio, projectId, cache],\n  )\n\n  const updateMetadata = useCallback(\n    async (assetId: string, patch: AssetMetadataPatch) => {\n      // Metadata writes go through the `assets.upsert` command via the\n      // operations facade (EC-141) — never straight at a repository.\n      const { assetRepo } = await studio()\n      const result = await updateAssetMetadata({ assets: assetRepo }, projectId, assetId, patch)\n      if (result.ok) {\n        // Patch the one updated record into the cache rather than re-listing the\n        // whole library (EC-301). A focal-point or alt edit must not trigger a full\n        // `assets.list` round-trip — that re-list (plus the marker only moving once\n        // it returned) was the focal-point picker's lag and query storm.\n        const updated = result.asset\n        cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n          (prev ?? []).map((a) => (a.id === assetId ? updated : a)),\n        )\n      }\n      return result\n    },\n    [studio, projectId, cache],\n  )\n\n  const generatePreviews = useCallback(\n    async (handlers?: {\n      onProgress?: (progress: BackfillProgress) => void\n      signal?: BackfillSignal\n    }) => {\n      const { adapter, assetRepo } = await studio()\n      // Reads (list) + the variant patch (upsert) go through the operations facade;\n      // bytes ride on `adapter.blobs`. The backfill is per-variant (EC-420 AD-4):\n      // one fetch of each original fills whichever of thumb/lqip is missing. Each\n      // generated record is patched into the shared cache in place (EC-301 perf,\n      // AD-17) so the grid updates live without a full re-list.\n      return runVariantBackfill(\n        {\n          assets: assetRepo,\n          blobs: adapter.blobs,\n          onGenerated: (updated) =>\n            cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n              (prev ?? []).map((a) => (a.id === updated.id ? updated : a)),\n            ),\n          ...(handlers?.onProgress ? { onProgress: handlers.onProgress } : {}),\n          ...(handlers?.signal ? { signal: handlers.signal } : {}),\n        },\n        projectId,\n      )\n    },\n    [studio, projectId, cache],\n  )\n\n  const store = useMemo<AssetsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      assets,\n      uploads,\n      upload,\n      landedAssetId,\n      retryUpload,\n      dismissUpload,\n      usagesOf,\n      remove,\n      updateMetadata,\n      generatePreviews,\n      refresh,\n    }),\n    [\n      projectId,\n      status,\n      errorMessage,\n      assets,\n      uploads,\n      upload,\n      landedAssetId,\n      retryUpload,\n      dismissUpload,\n      usagesOf,\n      remove,\n      updateMetadata,\n      generatePreviews,\n      refresh,\n    ],\n  )\n\n  return <AssetsContext.Provider value={store}>{children}</AssetsContext.Provider>\n}\n\nexport { useAssets }\n\n/**\n * The assets store when an `<AssetsProvider>` is mounted above, else `null`.\n * Lets surfaces outside the Assets section (the CMS asset picker, EC-152)\n * reuse an ambient provider or mount their own.\n */\nexport function useOptionalAssets(): AssetsStore | null {\n  return useContext(AssetsContext)\n}\n"]}
+{"version":3,"file":"assets-store.js","sourceRoot":"","sources":["../../../src/components/assets/assets-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useContext, useMemo, useRef, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport type { AssetRecord, AssetRepository } from '@elytracms/core/persistence'\nimport { deleteAsset, runVariantBackfill, runUpload, xhrUploadTransport } from '@elytracms/studio/lib/assets'\nimport type {\n  BackfillProgress,\n  BackfillSignal,\n  DeleteAssetResult,\n  UploadState,\n  UploadableFile,\n} from '@elytracms/studio/lib/assets'\nimport { loadInboundAssetReferenceViews } from '@elytracms/studio/lib/references'\nimport type { ReferenceEntryView } from '@elytracms/studio/lib/references'\nimport { getStudioOperations, operationsAssetRepository } from '@elytracms/studio/lib/operations'\nimport { projectCollections } from '@elytracms/studio/lib/operations/project-runtime-config'\nimport type { OperationsClient, StudioOperations } from '@elytracms/studio/lib/operations'\nimport { listStoreState, useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\nimport { updateAssetMetadata } from './asset-metadata'\nimport type { AssetMetadataPatch, UpdateAssetMetadataResult } from './asset-metadata'\n\n/**\n * Asset library store (EC-151, EC-141). Asset *metadata* mutations go through\n * the shared operations client (`assets.*` commands — validate → authorize →\n * mutate → event); blob *bytes* ride on `adapter.blobs`, which is transport,\n * not domain. The UI works identically against the in-memory seed and a live\n * Convex deployment.\n */\n\nexport interface UploadEntry {\n  id: string\n  filename: string\n  state: UploadState\n}\n\nexport interface AssetsStore {\n  /** The active project (e.g. for reference deep links, EC-202). */\n  projectId: string\n  status: 'loading' | 'ready' | 'error'\n  errorMessage?: string\n  assets: readonly AssetRecord[]\n  uploads: readonly UploadEntry[]\n  /**\n   * Queue files for upload. Returns the upload-queue id of each file, in order, so a\n   * caller can follow exactly ITS uploads (EC-588 A7) — see {@link landedAssetId}.\n   */\n  upload(files: Iterable<UploadableFile>): readonly string[]\n  /**\n   * The asset id an upload landed as, once its record is confirmed (EC-588 A7);\n   * `undefined` while it runs, after it failed, or for an id this store never issued.\n   * A completed upload leaves the queue, so this is where its outcome stays readable.\n   */\n  landedAssetId(uploadId: string): string | undefined\n  retryUpload(uploadId: string): void\n  dismissUpload(uploadId: string): void\n  /**\n   * Index-accurate inbound references of an asset (EC-202): the \"used by\"\n   * pre-flight of the block-or-confirm delete dialog, read from the EC-155\n   * reference index (not the retired string scan).\n   */\n  usagesOf(assetId: string): Promise<ReferenceEntryView[]>\n  remove(assetId: string, options?: { confirmInUse?: boolean }): Promise<DeleteAssetResult>\n  /** Edit alt/title (EC-152); persists through the operations asset facade. */\n  updateMetadata(assetId: string, patch: AssetMetadataPatch): Promise<UpdateAssetMetadataResult>\n  /**\n   * EC-568 — replace the file inside an asset: the same id, the new bytes, everything\n   * derived regenerated through THE upload path, the file's embedded metadata over\n   * `meta` per key (else kept), the focal point kept.\n   */\n  replaceFile(assetId: string, file: UploadableFile): Promise<ReplaceFileResult>\n  /**\n   * Backfill downscaled previews onto existing images (EC-400 AD-1). Sequential,\n   * idempotent, cancellable; each patch flows through the operations facade and\n   * the shared query cache (AD-5/AD-17). Reports progress via `handlers.onProgress`\n   * and stops when `handlers.signal.cancelled` flips.\n   */\n  generatePreviews(handlers?: {\n    onProgress?: (progress: BackfillProgress) => void\n    signal?: BackfillSignal\n  }): Promise<BackfillProgress>\n  refresh(): Promise<void>\n}\n\n/** The outcome of {@link AssetsStore.replaceFile}. */\nexport type ReplaceFileResult = { ok: true; asset: AssetRecord } | { ok: false; message: string }\n\nconst { Context: AssetsContext, useRequired: useAssets } = createRequiredContext<AssetsStore>(\n  'Assets',\n  { article: 'an' },\n)\n\nconst EMPTY_ASSETS: readonly AssetRecord[] = []\n\n/** Cache key for a project's asset library (shared by the query and its patches). */\nfunction assetsQueryKey(projectId: string): readonly [string, string] {\n  return ['assets', projectId]\n}\n\n/** Load a project's asset library (pure over the operations client). A list\n *  failure throws so the query surfaces it as an error status. */\nasync function loadAssets(operations: OperationsClient, projectId: string): Promise<AssetRecord[]> {\n  const result = await operations.assets.list({ projectId })\n  if (!result.ok) throw new Error(result.error.message)\n  return [...result.value]\n}\n\nexport function AssetsProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const uploadFilesRef = useRef(new Map<string, UploadableFile>())\n  // EC-588 A7: upload id → the asset id it landed as. Written BEFORE the entry leaves\n  // the queue, so a reader never sees an upload that is neither running nor landed.\n  const landedRef = useRef(new Map<string, string>())\n  const uploadSeq = useRef(0)\n  const [uploads, setUploads] = useState<readonly UploadEntry[]>([])\n\n  // EC-568: the asset collection's fields — their `source` declarations map a file's\n  // embedded IPTC facts onto `meta` on every upload and replace. Config, read once.\n  const assetFields = useMemo(\n    () => projectCollections(projectId).find((collection) => collection.kind === 'asset')?.fields,\n    [projectId],\n  )\n\n  /** The shared studio operations bundle + the metadata-write facade over it. */\n  const studio = useCallback(async (): Promise<\n    StudioOperations & { assetRepo: AssetRepository }\n  > => {\n    const bundle = await getStudioOperations()\n    return { ...bundle, assetRepo: operationsAssetRepository(bundle.operations) }\n  }, [])\n\n  // The library list, read through the one operations-backed query cache\n  // (EC-308/AD-17). No `invalidateOn`: this provider is the sole writer of its\n  // project's assets, so its own mutations patch the cache in place (the EC-301\n  // rule — a metadata or focal-point edit must never trigger a full re-list).\n  const query = useOperationQuery<AssetRecord[]>({\n    queryKey: assetsQueryKey(projectId),\n    loader: (operations) => loadAssets(operations, projectId),\n  })\n  const cache = useOperationCache()\n  const refetch = query.refetch\n  const assets = query.data ?? EMPTY_ASSETS\n  const { status, errorMessage } = listStoreState(query)\n\n  /** Re-list from the backend (the public escape hatch + post-upload reconcile). */\n  const refresh = useCallback(async () => {\n    await refetch()\n  }, [refetch])\n\n  const setUploadState = useCallback((uploadId: string, state: UploadState) => {\n    setUploads((prev) => prev.map((u) => (u.id === uploadId ? { ...u, state } : u)))\n  }, [])\n\n  const runEntry = useCallback(\n    async (uploadId: string, file: UploadableFile, previous?: UploadState) => {\n      const { adapter, assetRepo } = await studio()\n      const result = await runUpload(\n        {\n          // Bytes ride on blob storage (transport); the metadata record is\n          // confirmed through the `assets.upsert` operation command.\n          blobs: adapter.blobs,\n          assets: assetRepo,\n          ...(assetFields ? { assetFields } : {}),\n          ...(typeof XMLHttpRequest !== 'undefined' ? { transport: xhrUploadTransport } : {}),\n        },\n        {\n          projectId,\n          file,\n          onState: (state) => setUploadState(uploadId, state),\n        },\n        previous,\n      )\n      if (result.ok) {\n        // Completed uploads leave the queue; the asset appears in the library.\n        landedRef.current.set(uploadId, result.asset.id)\n        uploadFilesRef.current.delete(uploadId)\n        setUploads((prev) => prev.filter((u) => u.id !== uploadId))\n        await refresh()\n      }\n    },\n    [studio, projectId, refresh, setUploadState, assetFields],\n  )\n\n  const upload = useCallback(\n    (files: Iterable<UploadableFile>): readonly string[] => {\n      const ids: string[] = []\n      for (const file of files) {\n        uploadSeq.current += 1\n        const uploadId = `upload-${uploadSeq.current}`\n        ids.push(uploadId)\n        uploadFilesRef.current.set(uploadId, file)\n        setUploads((prev) => [\n          ...prev,\n          { id: uploadId, filename: file.name, state: { phase: 'idle', progress: 0, attempt: 0 } },\n        ])\n        void runEntry(uploadId, file)\n      }\n      return ids\n    },\n    [runEntry],\n  )\n\n  const landedAssetId = useCallback((uploadId: string) => landedRef.current.get(uploadId), [])\n\n  const retryUpload = useCallback(\n    (uploadId: string) => {\n      const file = uploadFilesRef.current.get(uploadId)\n      const entry = uploads.find((u) => u.id === uploadId)\n      if (!file || !entry || entry.state.phase !== 'failed') return\n      void runEntry(uploadId, file, entry.state)\n    },\n    [runEntry, uploads],\n  )\n\n  const dismissUpload = useCallback((uploadId: string) => {\n    uploadFilesRef.current.delete(uploadId)\n    setUploads((prev) => prev.filter((u) => u.id !== uploadId))\n  }, [])\n\n  const usagesOf = useCallback(\n    // Index-accurate (EC-202): inbound references from the EC-155 index via the\n    // operations queries — the same machinery the References panel uses.\n    async (assetId: string) => loadInboundAssetReferenceViews(projectId, assetId),\n    [projectId],\n  )\n\n  const remove = useCallback(\n    async (assetId: string, options?: { confirmInUse?: boolean }) => {\n      const { adapter, assetRepo } = await studio()\n      // Metadata removal goes through the `assets.remove` command (via the\n      // facade); blob byte deletion stays on the adapter; the usage gate reads\n      // the EC-155 reference index (`adapter.references`, EC-202).\n      const result = await deleteAsset(\n        { assets: assetRepo, blobs: adapter.blobs, references: adapter.references },\n        projectId,\n        assetId,\n        options,\n      )\n      // Drop the one removed record from the cache rather than re-listing the whole\n      // library (EC-301 perf, mirrors updateMetadata) — a delete must not trigger a full\n      // `assets.list` round-trip on top of the deletion itself.\n      if (result.outcome === 'deleted' || result.outcome === 'not-found') {\n        cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n          (prev ?? []).filter((a) => a.id !== assetId),\n        )\n      }\n      return result\n    },\n    [studio, projectId, cache],\n  )\n\n  const updateMetadata = useCallback(\n    async (assetId: string, patch: AssetMetadataPatch) => {\n      // Metadata writes go through the `assets.upsert` command via the\n      // operations facade (EC-141) — never straight at a repository.\n      const { assetRepo } = await studio()\n      const result = await updateAssetMetadata({ assets: assetRepo }, projectId, assetId, patch)\n      if (result.ok) {\n        // Patch the one updated record into the cache rather than re-listing the\n        // whole library (EC-301). A focal-point or alt edit must not trigger a full\n        // `assets.list` round-trip — that re-list (plus the marker only moving once\n        // it returned) was the focal-point picker's lag and query storm.\n        const updated = result.asset\n        cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n          (prev ?? []).map((a) => (a.id === assetId ? updated : a)),\n        )\n      }\n      return result\n    },\n    [studio, projectId, cache],\n  )\n\n  const replaceFile = useCallback(\n    async (assetId: string, file: UploadableFile): Promise<ReplaceFileResult> => {\n      const { adapter, assetRepo } = await studio()\n      // EC-568: THE upload path, in replace mode — not a second uploader.\n      const result = await runUpload(\n        {\n          blobs: adapter.blobs,\n          assets: assetRepo,\n          ...(assetFields ? { assetFields } : {}),\n          ...(typeof XMLHttpRequest !== 'undefined' ? { transport: xhrUploadTransport } : {}),\n        },\n        { projectId, file, replace: { assetId } },\n      )\n      if (!result.ok) return { ok: false, message: result.failure.message }\n      const updated = result.asset\n      cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n        (prev ?? []).map((a) => (a.id === assetId ? updated : a)),\n      )\n      return { ok: true, asset: updated }\n    },\n    [studio, projectId, cache, assetFields],\n  )\n\n  const generatePreviews = useCallback(\n    async (handlers?: {\n      onProgress?: (progress: BackfillProgress) => void\n      signal?: BackfillSignal\n    }) => {\n      const { adapter, assetRepo } = await studio()\n      // Reads (list) + the variant patch (upsert) go through the operations facade;\n      // bytes ride on `adapter.blobs`. The backfill is per-variant (EC-420 AD-4):\n      // one fetch of each original fills whichever of thumb/lqip is missing. Each\n      // generated record is patched into the shared cache in place (EC-301 perf,\n      // AD-17) so the grid updates live without a full re-list.\n      return runVariantBackfill(\n        {\n          assets: assetRepo,\n          blobs: adapter.blobs,\n          onGenerated: (updated) =>\n            cache.patch<AssetRecord[]>(assetsQueryKey(projectId), (prev) =>\n              (prev ?? []).map((a) => (a.id === updated.id ? updated : a)),\n            ),\n          ...(handlers?.onProgress ? { onProgress: handlers.onProgress } : {}),\n          ...(handlers?.signal ? { signal: handlers.signal } : {}),\n        },\n        projectId,\n      )\n    },\n    [studio, projectId, cache],\n  )\n\n  const store = useMemo<AssetsStore>(\n    () => ({\n      projectId,\n      status,\n      ...(errorMessage !== undefined ? { errorMessage } : {}),\n      assets,\n      uploads,\n      upload,\n      landedAssetId,\n      retryUpload,\n      dismissUpload,\n      usagesOf,\n      remove,\n      updateMetadata,\n      replaceFile,\n      generatePreviews,\n      refresh,\n    }),\n    [\n      projectId,\n      status,\n      errorMessage,\n      assets,\n      uploads,\n      upload,\n      landedAssetId,\n      retryUpload,\n      dismissUpload,\n      usagesOf,\n      remove,\n      updateMetadata,\n      replaceFile,\n      generatePreviews,\n      refresh,\n    ],\n  )\n\n  return <AssetsContext.Provider value={store}>{children}</AssetsContext.Provider>\n}\n\nexport { useAssets }\n\n/**\n * The assets store when an `<AssetsProvider>` is mounted above, else `null`.\n * Lets surfaces outside the Assets section (the CMS asset picker, EC-152)\n * reuse an ambient provider or mount their own.\n */\nexport function useOptionalAssets(): AssetsStore | null {\n  return useContext(AssetsContext)\n}\n"]}

package/dist/components/assets/replace-file.d.ts

@@ -0,0 +1,22 @@
+import type { AssetRecord } from '@elytracms/core/persistence';
+/**
+ * What a file REPLACE accepts (EC-568): a file of the same kind as the current one — an
+ * image stays an image (every field that holds it accepted an image), a video a video.
+ * Any other kind is unrestricted. Pure, for the test.
+ */
+export declare function replaceAccept(record: Pick<AssetRecord, 'contentType'>): readonly string[] | undefined;
+/**
+ * "Replace file" (EC-568 A): new bytes inside the SAME asset — every placement that
+ * points at it shows the new file. Runs THE upload path with `replace` (the store's
+ * `replaceFile`), so the derived data is regenerated and the file's embedded metadata
+ * overrides `meta` per key. Used by the asset library's detail surface and the image
+ * options dialog. `beforeReplace` lets a caller flush an edit buffer first, so a stale
+ * buffer can never overwrite what the new file brought.
+ */
+export declare function ReplaceFileButton({ record, disabled, disabledHint, beforeReplace, onReplaced, }: {
+    record: AssetRecord;
+    disabled?: boolean;
+    disabledHint?: string;
+    beforeReplace?: () => Promise<void>;
+    onReplaced?: (asset: AssetRecord) => void;
+}): import("react").JSX.Element | null;

package/dist/components/assets/replace-file.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { RefreshCw } from 'lucide-react';
+import { useRef, useState } from 'react';
+import { assetAcceptAttr } from '@elytracms/core/cms-core';
+import { Button, Text } from '@elytracms/studio/ui';
+import { translate } from '@elytracms/studio/lib/i18n';
+import { splitByAccept } from '../cms/asset-picker-core.js';
+import { useOptionalAssets } from './assets-store.js';
+/**
+ * What a file REPLACE accepts (EC-568): a file of the same kind as the current one — an
+ * image stays an image (every field that holds it accepted an image), a video a video.
+ * Any other kind is unrestricted. Pure, for the test.
+ */
+export function replaceAccept(record) {
+    const kind = record.contentType.split('/')[0];
+    return kind === 'image' || kind === 'video' || kind === 'audio' ? [kind] : undefined;
+}
+/**
+ * "Replace file" (EC-568 A): new bytes inside the SAME asset — every placement that
+ * points at it shows the new file. Runs THE upload path with `replace` (the store's
+ * `replaceFile`), so the derived data is regenerated and the file's embedded metadata
+ * overrides `meta` per key. Used by the asset library's detail surface and the image
+ * options dialog. `beforeReplace` lets a caller flush an edit buffer first, so a stale
+ * buffer can never overwrite what the new file brought.
+ */
+export function ReplaceFileButton({ record, disabled, disabledHint, beforeReplace, onReplaced, }) {
+    const assets = useOptionalAssets();
+    const input = useRef(null);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    const accept = replaceAccept(record);
+    if (!assets)
+        return null;
+    async function replace(files) {
+        if (!assets || files.length === 0)
+            return;
+        const { accepted, rejected } = splitByAccept(files.slice(0, 1), accept);
+        const next = accepted[0];
+        if (!next) {
+            setError(translate('cms.asset.replaceWrongKind', { name: rejected[0] ?? '', types: (accept ?? []).join(', ') }));
+            return;
+        }
+        setBusy(true);
+        setError(null);
+        await beforeReplace?.();
+        const result = await assets.replaceFile(record.id, next);
+        setBusy(false);
+        if (result.ok)
+            onReplaced?.(result.asset);
+        else
+            setError(result.message);
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs(Button, { variant: "outline", size: "sm", disabled: disabled || busy, title: disabled ? disabledHint : undefined, onClick: () => input.current?.click(), "data-testid": "asset-replace-file", children: [_jsx(RefreshCw, {}), " ", busy ? translate('cms.asset.replacing') : translate('cms.asset.replaceFile')] }), _jsx("input", { ref: input, type: "file", className: "hidden", ...(accept ? { accept: assetAcceptAttr(accept) } : {}), onChange: (e) => {
+                    const files = Array.from(e.target.files ?? []);
+                    e.target.value = '';
+                    void replace(files);
+                } }), error ? (_jsx(Text, { size: "xs", className: "text-destructive", role: "alert", children: error })) : null] }));
+}
+//# sourceMappingURL=replace-file.js.map

package/dist/components/assets/replace-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-file.js","sourceRoot":"","sources":["../../../src/components/assets/replace-file.tsx"],"names":[],"mappings":"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","sourcesContent":["import { RefreshCw } from 'lucide-react'\nimport { useRef, useState } from 'react'\nimport { assetAcceptAttr } from '@elytracms/core/cms-core'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport { Button, Text } from '@elytracms/studio/ui'\nimport { translate } from '@elytracms/studio/lib/i18n'\nimport { splitByAccept } from '../cms/asset-picker-core'\nimport { useOptionalAssets } from './assets-store'\n\n/**\n * What a file REPLACE accepts (EC-568): a file of the same kind as the current one — an\n * image stays an image (every field that holds it accepted an image), a video a video.\n * Any other kind is unrestricted. Pure, for the test.\n */\nexport function replaceAccept(record: Pick<AssetRecord, 'contentType'>): readonly string[] | undefined {\n  const kind = record.contentType.split('/')[0]\n  return kind === 'image' || kind === 'video' || kind === 'audio' ? [kind] : undefined\n}\n\n/**\n * \"Replace file\" (EC-568 A): new bytes inside the SAME asset — every placement that\n * points at it shows the new file. Runs THE upload path with `replace` (the store's\n * `replaceFile`), so the derived data is regenerated and the file's embedded metadata\n * overrides `meta` per key. Used by the asset library's detail surface and the image\n * options dialog. `beforeReplace` lets a caller flush an edit buffer first, so a stale\n * buffer can never overwrite what the new file brought.\n */\nexport function ReplaceFileButton({\n  record,\n  disabled,\n  disabledHint,\n  beforeReplace,\n  onReplaced,\n}: {\n  record: AssetRecord\n  disabled?: boolean\n  disabledHint?: string\n  beforeReplace?: () => Promise<void>\n  onReplaced?: (asset: AssetRecord) => void\n}) {\n  const assets = useOptionalAssets()\n  const input = useRef<HTMLInputElement>(null)\n  const [busy, setBusy] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n  const accept = replaceAccept(record)\n  if (!assets) return null\n\n  async function replace(files: File[]) {\n    if (!assets || files.length === 0) return\n    const { accepted, rejected } = splitByAccept(files.slice(0, 1), accept)\n    const next = accepted[0]\n    if (!next) {\n      setError(translate('cms.asset.replaceWrongKind', { name: rejected[0] ?? '', types: (accept ?? []).join(', ') }))\n      return\n    }\n    setBusy(true)\n    setError(null)\n    await beforeReplace?.()\n    const result = await assets.replaceFile(record.id, next)\n    setBusy(false)\n    if (result.ok) onReplaced?.(result.asset)\n    else setError(result.message)\n  }\n\n  return (\n    <>\n      <Button\n        variant=\"outline\"\n        size=\"sm\"\n        disabled={disabled || busy}\n        title={disabled ? disabledHint : undefined}\n        onClick={() => input.current?.click()}\n        data-testid=\"asset-replace-file\"\n      >\n        <RefreshCw /> {busy ? translate('cms.asset.replacing') : translate('cms.asset.replaceFile')}\n      </Button>\n      <input\n        ref={input}\n        type=\"file\"\n        className=\"hidden\"\n        {...(accept ? { accept: assetAcceptAttr(accept) } : {})}\n        onChange={(e) => {\n          const files = Array.from(e.target.files ?? [])\n          e.target.value = ''\n          void replace(files)\n        }}\n      />\n      {error ? (\n        <Text size=\"xs\" className=\"text-destructive\" role=\"alert\">\n          {error}\n        </Text>\n      ) : null}\n    </>\n  )\n}\n"]}

package/dist/components/builder/blocks-model.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentNode } from '@elytracms/core/project-graph';
+import type { AllowList, ComponentNode } from '@elytracms/core/project-graph';
 import type { ComponentFixture, ComponentManifest } from '@elytracms/core/component-registry';
 import type { StudioRegistry } from '@elytracms/studio/lib/registry';
 /**
@@ -90,22 +90,12 @@ export interface BlockGroup {
 export interface BlockFilter {
     /** Case-insensitive match over id, title, description, category, and fixture names. */
     query?: string;
-    /** When set, only these component ids may be inserted (slot.allow). */
-    slotAllow?: string[];
+    /**
+     * The insertion position's effective vocabulary (EC-584 — `allowAt`: the field's at
+     * the composition root, the slot's below). Omitted → any component.
+     */
+    allow?: AllowList;
 }
-/**
- * Intersect two component-id allow-lists. `undefined` means "no constraint from
- * this source", so the result is the other list (copied); two present lists yield
- * their set intersection, preserving the first list's order. This layers a
- * composition field's top-level `allow` vocabulary over a slot's positional
- * `allow` at the canvas root (EC-188): a component must satisfy BOTH leashes to be
- * offered. A present list is a closed set (EC-544): the intersection of two
- * disjoint lists is `[]`, which every reader treats as "allow nothing" — there is
- * no coalescing hatch anywhere, and a *declared* `[]` is rejected at the
- * declaration site (config resolve / the `empty-allow` registry issue), so an
- * empty result here is always computed, never authored.
- */
-export declare function intersectAllow(slotAllow: readonly string[] | undefined, fieldAllow: readonly string[] | undefined): string[] | undefined;
 /**
  * Build the configured subtree a fixture describes: the fixture's props (EC-591/2f:
  * never the manifest defaults — an unset prop stays absent), plus one bare child
@@ -143,16 +133,14 @@ export declare function tileMonogram(title: string): string;
  */
 export declare function blockGroups(studio: StudioRegistry, filter?: BlockFilter, generatedPreview?: GeneratedPreviewLookup): BlockGroup[];
 /**
- * Whether ANY component could be inserted under a slot allow-list (EC-405) — the
- * cheap existence check behind the canvas insertion affordances: a "+" only shows
- * at a position where the blocks panel would offer at least one tile. Mirrors the
- * exact filter {@link blockGroups} applies (canvas-eligible AND, when an allow-list
- * is present, on that list), short-circuiting on the first match instead of
- * building tiles; falls back to the layout-helper presets (which are also
- * insertable there). `undefined`/absent `slotAllow` means "allow any" → true when
- * the registry has any canvas-eligible component.
+ * Whether ANY component could be inserted at a position whose vocabulary is `allow`
+ * (EC-405) — the cheap existence check behind the canvas insertion affordances: a
+ * "+" only shows at a position where the blocks panel would offer at least one tile.
+ * The exact filter {@link blockGroups} applies (the placement judge), short-circuiting
+ * on the first match instead of building tiles; falls back to the layout-helper
+ * presets (which are also insertable there). Omitted `allow` → any component.
  */
-export declare function hasInsertableComponent(studio: StudioRegistry, slotAllow?: string[]): boolean;
+export declare function hasInsertableComponent(studio: StudioRegistry, allow?: AllowList): boolean;
 /**
  * Layout helper presets (EC-067) as panel tiles — already one tile per preset.
  * A preset has a single implicit variant and never a preview image, so its
@@ -160,4 +148,4 @@ export declare function hasInsertableComponent(studio: StudioRegistry, slotAllow
  * supports ({@link layoutPresets} — built from the layout and text roles), never
  * hardcoded engine ids.
  */
-export declare function presetTiles(studio: StudioRegistry, slotAllow?: string[]): BlockTile[];
+export declare function presetTiles(studio: StudioRegistry, allow?: AllowList): BlockTile[];