@elytracms/studio 0.0.94 → 0.0.95

package/dist/components/assets/asset-metadata.js

@@ -1,4 +1,4 @@
-import { liftLegacyAlt } from '@elytracms/core/persistence';
+import { liftLegacyAlt, metaPatchBetween } from '@elytracms/core/persistence';
 /**
  * Asset metadata editing (EC-152). A patch is applied through the
  * {@link AssetRepository} interface — in the studio that is the EC-141
@@ -44,12 +44,96 @@ export function formatBytes(byteSize) {
     return `${(byteSize / (1024 * 1024)).toFixed(1)} MB`;
 }
 /**
- * The meta bag an editor starts from (EC-587): the stored `meta` with a legacy `alt`
- * column lifted in (core `liftLegacyAlt`), so a not-yet-migrated asset shows the alt
- * every reader shows — and the save writes it to `meta`, its home.
+ * The draft an editor opens (EC-587 + EC-632): the stored bags, with a legacy `alt` column
+ * lifted into the shared one (core `liftLegacyAlt`), so a not-yet-migrated asset shows the
+ * alt every reader shows — and its first save moves it home.
  */
-export function assetMetaSeed(record) {
-    return liftLegacyAlt(record)?.meta ?? { ...(record.meta ?? {}) };
+export function assetMetaDraft(record) {
+    const localizedMeta = {};
+    for (const [locale, bucket] of Object.entries(record.localizedMeta ?? {}))
+        localizedMeta[locale] = { ...bucket };
+    return { meta: liftLegacyAlt(record)?.meta ?? { ...(record.meta ?? {}) }, localizedMeta };
+}
+const hasOwn = (bag, key) => bag !== undefined && Object.prototype.hasOwnProperty.call(bag, key);
+/**
+ * What the form shows for one field (EC-632): a `localized: true` field the editor's
+ * locale's own value (an untranslated locale shows empty — it falls back to the default
+ * locale on delivery); the default locale also shows a value written before the field was
+ * localized (the shared bag — delivery's last-resort fallback, so it IS that locale's
+ * value). Any other field the shared value. Without a locale config, the shared value.
+ */
+export function assetMetaFieldValue(draft, field, at) {
+    if (field.localized === true && at !== null) {
+        const bucket = draft.localizedMeta[at.locale];
+        if (hasOwn(bucket, field.name))
+            return bucket[field.name];
+        return at.locale === at.default ? draft.meta[field.name] : undefined;
+    }
+    return draft.meta[field.name];
+}
+/**
+ * Write one field of the draft (EC-632) — `undefined` removes the value:
+ * - a `localized: true` field goes into the editor's locale's bucket; in the DEFAULT
+ *   locale a value written before the field was localized leaves the shared bag — the
+ *   default bucket is its home now, so a clear there really clears it;
+ * - any other field goes into the shared bag, and a value a former localization left in a
+ *   bucket is removed (one home per key — a stale bucket would shadow the shared value);
+ * - without a locale config (`at` null) a localized field writes the shared bag and leaves
+ *   its translations alone.
+ */
+export function setAssetMetaField(draft, field, at, value) {
+    const name = field.name;
+    const withValue = (bag) => {
+        const next = { ...(bag ?? {}) };
+        if (value === undefined)
+            delete next[name];
+        else
+            next[name] = value;
+        return next;
+    };
+    const without = (bag) => {
+        const next = { ...bag };
+        delete next[name];
+        return next;
+    };
+    if (field.localized === true) {
+        // No locale config installed yet: the shared bag, and the translations left untouched.
+        if (at === null)
+            return { meta: withValue(draft.meta), localizedMeta: draft.localizedMeta };
+        const bucket = withValue(draft.localizedMeta[at.locale]);
+        const localizedMeta = { ...draft.localizedMeta, [at.locale]: bucket };
+        const meta = at.locale === at.default && hasOwn(draft.meta, name) ? without(draft.meta) : draft.meta;
+        return { meta, localizedMeta };
+    }
+    const localizedMeta = {};
+    for (const [locale, bucket] of Object.entries(draft.localizedMeta)) {
+        localizedMeta[locale] = hasOwn(bucket, name) ? without(bucket) : bucket;
+    }
+    return { meta: withValue(draft.meta), localizedMeta };
+}
+/**
+ * The per-key, per-locale patch of a metadata edit (EC-634 × EC-632): what changed between
+ * the draft the editor OPENED ({@link assetMetaDraft} at open, or the draft of its last
+ * successful save) and the draft it holds — `undefined` values pruned, a removed key
+ * `null`, a locale it did not touch absent. Every asset metadata editor (the image options
+ * dialog, the asset library's detail, the assets rail) sends this instead of its buffer.
+ */
+export function assetMetaDraftPatch(opened, edited) {
+    const metaPatch = metaPatchBetween(pruneMeta({ ...opened.meta }), pruneMeta({ ...edited.meta }));
+    const localizedMetaPatch = {};
+    for (const locale of new Set([...Object.keys(opened.localizedMeta), ...Object.keys(edited.localizedMeta)])) {
+        const patch = metaPatchBetween(pruneMeta({ ...(opened.localizedMeta[locale] ?? {}) }), pruneMeta({ ...(edited.localizedMeta[locale] ?? {}) }));
+        if (Object.keys(patch).length > 0)
+            localizedMetaPatch[locale] = patch;
+    }
+    return {
+        ...(Object.keys(metaPatch).length > 0 ? { metaPatch } : {}),
+        ...(Object.keys(localizedMetaPatch).length > 0 ? { localizedMetaPatch } : {}),
+    };
+}
+/** The form's flat view of a draft in one locale — `{ [field]: value }` for the given fields. */
+export function assetMetaFormValues(draft, fields, at) {
+    return Object.fromEntries(fields.map((field) => [field.name, assetMetaFieldValue(draft, field, at)]));
 }
 /** A text column's write: a trimmed value sets, `null`/empty clears. */
 function textWrite(value) {
@@ -63,17 +147,21 @@ function textWrite(value) {
  * overwrite a preview backfill that finished while the dialog was open, and a
  * clear expressed as an omitted key is exactly what never persisted on Convex.
  *
- * EC-587: a `meta` write also clears the legacy `alt` column. The bag was seeded with
- * that column lifted in ({@link assetMetaSeed}), so the alt the editor saw is in the bag
- * (or was deliberately cleared): the column has nothing left to say, and leaving it
- * would re-surface a cleared alt through the read fallback (ASSETS D21).
+ * EC-634: `meta` travels as the per-key `metaPatch` — never the whole bag, which would
+ * carry a stale copy of every key the editor did not change. An empty patch is not sent.
+ * The legacy `alt` column (EC-587) is lifted into the stored bag and cleared by the write
+ * rule itself, in the same transaction, whenever a patch is applied — so an alt the editor
+ * did not touch survives, and one the editor cleared stays cleared (ASSETS D21).
  */
 export function assetMetadataWrite(assetId, patch) {
+    const metaPatch = patch.metaPatch;
+    const localizedMetaPatch = patch.localizedMetaPatch;
     return {
         id: assetId,
         ...(patch.title !== undefined ? { title: textWrite(patch.title) } : {}),
         ...(patch.focalPoint !== undefined ? { focalPoint: patch.focalPoint } : {}),
-        ...(patch.meta !== undefined ? { meta: patch.meta, alt: null } : {}),
+        ...(metaPatch !== undefined && Object.keys(metaPatch).length > 0 ? { metaPatch } : {}),
+        ...(localizedMetaPatch !== undefined && Object.keys(localizedMetaPatch).length > 0 ? { localizedMetaPatch } : {}),
     };
 }
 /**

package/dist/components/assets/asset-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-metadata.js","sourceRoot":"","sources":["../../../src/components/assets/asset-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport { liftLegacyAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord, AssetRepository, AssetWriteInput } from '@elytracms/core/persistence'\n\n/**\n * Asset metadata editing (EC-152). A patch is applied through the\n * {@link AssetRepository} interface — in the studio that is the EC-141\n * operations facade, so every edit runs the `assets.upsert` command\n * (validate → authorize → mutate → event). Pure orchestration; injectable\n * for tests.\n */\n\n/**\n * System columns the upload pipeline owns — never editable metadata, so they're\n * excluded from the asset collection's schema-driven forms: the image field's\n * options dialog (EC-301, `field-control.tsx`) and the assets rail's detail\n * surface (EC-319, `asset-detail.tsx`) share this ONE reserved set so neither\n * drifts from the other. Everything else a project declares on the `kind:'asset'`\n * collection round-trips through the record's open `meta` bag.\n */\nexport const SYSTEM_ASSET_FIELDS: ReadonlySet<string> = new Set([\n  'filename',\n  'url',\n  'contentType',\n  'byteSize',\n  'width',\n  'height',\n  'storageKey',\n  'title',\n])\n\n/**\n * The asset collection's EDITABLE metadata fields — declared fields minus the\n * system columns above and anything explicitly `readOnly` (EC-301/EC-319).\n */\nexport function assetMetaFieldsOf(collection: CollectionDef): FieldDef[] {\n  return collection.fields.filter((f) => !SYSTEM_ASSET_FIELDS.has(f.name) && !f.form?.readOnly)\n}\n\n/** Drop `undefined` values so a persisted meta bag stays JSON/Convex-clean. */\nexport function pruneMeta(meta: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(meta).filter(([, v]) => v !== undefined))\n}\n\n/** Human-readable byte size (`1536` → `1.5 KB`). Shared by the asset grid + detail. */\nexport function formatBytes(byteSize: number): string {\n  if (byteSize < 1024) return `${byteSize} B`\n  if (byteSize < 1024 * 1024) return `${(byteSize / 1024).toFixed(1)} KB`\n  return `${(byteSize / (1024 * 1024)).toFixed(1)} MB`\n}\n\n/**\n * An editor's metadata change, in the EC-577 write rule: an ABSENT key leaves the\n * stored value untouched, `null` clears it, a value sets it.\n */\nexport interface AssetMetadataPatch {\n  /** New display title: a value sets (trimmed), `null` or a trimmed-empty string clears. */\n  title?: string | null\n  /**\n   * New focal point (EC-248), the normalized 0–1 hotspot threaded to delivery's\n   * `object-position` (EC-230). `{x,y}` sets it, `null` clears it (\"Reset to\n   * centre\").\n   */\n  focalPoint?: { x: number; y: number } | null\n  /**\n   * Schema-driven asset metadata bag (EC-301): alt, copyright, credit, … keyed by\n   * the asset collection's `fields`. An object **replaces** the whole bag (the\n   * image options dialog holds the complete edited meta, seeded through\n   * {@link assetMetaSeed}); `null` clears it. `meta.alt` is the asset's ONE alt\n   * (EC-587) — there is no separate alt key.\n   */\n  meta?: Record<string, unknown> | null\n}\n\n/**\n * The meta bag an editor starts from (EC-587): the stored `meta` with a legacy `alt`\n * column lifted in (core `liftLegacyAlt`), so a not-yet-migrated asset shows the alt\n * every reader shows — and the save writes it to `meta`, its home.\n */\nexport function assetMetaSeed(record: Pick<AssetRecord, 'alt' | 'meta'>): Record<string, unknown> {\n  return liftLegacyAlt(record)?.meta ?? { ...(record.meta ?? {}) }\n}\n\n/** A text column's write: a trimmed value sets, `null`/empty clears. */\nfunction textWrite(value: string | null): string | null {\n  const trimmed = value?.trim() ?? ''\n  return trimmed.length > 0 ? trimmed : null\n}\n\n/**\n * The asset write for a metadata edit (EC-577): ONLY the keys the editor changed,\n * with `null` for a clear. It deliberately restates nothing else — not the\n * upload-owned columns, and never `thumb`/`lqip`: a stale copy of those would\n * overwrite a preview backfill that finished while the dialog was open, and a\n * clear expressed as an omitted key is exactly what never persisted on Convex.\n *\n * EC-587: a `meta` write also clears the legacy `alt` column. The bag was seeded with\n * that column lifted in ({@link assetMetaSeed}), so the alt the editor saw is in the bag\n * (or was deliberately cleared): the column has nothing left to say, and leaving it\n * would re-surface a cleared alt through the read fallback (ASSETS D21).\n */\nexport function assetMetadataWrite(assetId: string, patch: AssetMetadataPatch): AssetWriteInput {\n  return {\n    id: assetId,\n    ...(patch.title !== undefined ? { title: textWrite(patch.title) } : {}),\n    ...(patch.focalPoint !== undefined ? { focalPoint: patch.focalPoint } : {}),\n    ...(patch.meta !== undefined ? { meta: patch.meta, alt: null } : {}),\n  }\n}\n\nexport type UpdateAssetMetadataResult =\n  | { ok: true; asset: AssetRecord }\n  | { ok: false; message: string }\n\n/**\n * Persist a metadata edit via the repository (the operations facade in the\n * studio). No read first: the write carries only the change, and the adapter\n * resolves it against the stored record inside its own transaction (EC-577). An\n * asset that no longer exists is refused there (a metadata write cannot create\n * one). Failures come back as a structured result — never a throw the UI has to\n * guess about.\n */\nexport async function updateAssetMetadata(\n  deps: { assets: AssetRepository },\n  projectId: string,\n  assetId: string,\n  patch: AssetMetadataPatch,\n): Promise<UpdateAssetMetadataResult> {\n  try {\n    const asset = await deps.assets.upsertAsset(projectId, assetMetadataWrite(assetId, patch))\n    return { ok: true, asset }\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) }\n  }\n}\n"]}
+{"version":3,"file":"asset-metadata.js","sourceRoot":"","sources":["../../../src/components/assets/asset-metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAG7E;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,UAAU;IACV,KAAK;IACL,aAAa;IACb,UAAU;IACV,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,OAAO;CACR,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB;IACzD,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC/F,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,SAAS,CAAC,IAA6B;IACrD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAA;AACpF,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,IAAI,QAAQ,GAAG,IAAI;QAAE,OAAO,GAAG,QAAQ,IAAI,CAAA;IAC3C,IAAI,QAAQ,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IACvE,OAAO,GAAG,CAAC,QAAQ,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;AACtD,CAAC;AAkDD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2D;IACxF,MAAM,aAAa,GAA4C,EAAE,CAAA;IACjE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QAAE,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAChH,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,CAAA;AAC3F,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,GAAkD,EAAE,GAAW,EAAW,EAAE,CAC1F,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAqB,EAAE,KAAgB,EAAE,EAA0B;IACrG,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;QAC7C,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,MAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1D,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACtE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,KAAgB,EAChB,EAA0B,EAC1B,KAAc;IAEd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACvB,MAAM,SAAS,GAAG,CAAC,GAAkD,EAA2B,EAAE;QAChG,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAA;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;;YACrC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,CAAC,GAAsC,EAA2B,EAAE;QAClF,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC7B,uFAAuF;QACvF,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAA;QAC3F,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QACxD,MAAM,aAAa,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACrE,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;QACpG,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;IAChC,CAAC;IACD,MAAM,aAAa,GAAsD,EAAE,CAAA;IAC3E,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QACnE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACzE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,MAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAChG,MAAM,kBAAkB,GAA4C,EAAE,CAAA;IACtE,KAAK,MAAM,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,MAAM,KAAK,GAAG,gBAAgB,CAC5B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EACtD,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CACvD,CAAA;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;IACvE,CAAC;IACD,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAA;AACH,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,MAA4B,EAC5B,EAA0B;IAE1B,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC;AAED,wEAAwE;AACxE,SAAS,SAAS,CAAC,KAAoB;IACrC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACnC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAyB;IAC3E,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IACjC,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAA;IACnD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClH,CAAA;AACH,CAAC;AAMD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAiC,EACjC,SAAiB,EACjB,OAAe,EACf,KAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;QAC1F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;IACvF,CAAC;AACH,CAAC","sourcesContent":["import type { CollectionDef, FieldDef } from '@elytracms/core/cms-core'\nimport { liftLegacyAlt, metaPatchBetween } from '@elytracms/core/persistence'\nimport type { AssetReadLocale, AssetRecord, AssetRepository, AssetWriteInput } from '@elytracms/core/persistence'\n\n/**\n * Asset metadata editing (EC-152). A patch is applied through the\n * {@link AssetRepository} interface — in the studio that is the EC-141\n * operations facade, so every edit runs the `assets.upsert` command\n * (validate → authorize → mutate → event). Pure orchestration; injectable\n * for tests.\n */\n\n/**\n * System columns the upload pipeline owns — never editable metadata, so they're\n * excluded from the asset collection's schema-driven forms: the image field's\n * options dialog (EC-301, `field-control.tsx`) and the assets rail's detail\n * surface (EC-319, `asset-detail.tsx`) share this ONE reserved set so neither\n * drifts from the other. Everything else a project declares on the `kind:'asset'`\n * collection round-trips through the record's open `meta` bag.\n */\nexport const SYSTEM_ASSET_FIELDS: ReadonlySet<string> = new Set([\n  'filename',\n  'url',\n  'contentType',\n  'byteSize',\n  'width',\n  'height',\n  'storageKey',\n  'title',\n])\n\n/**\n * The asset collection's EDITABLE metadata fields — declared fields minus the\n * system columns above and anything explicitly `readOnly` (EC-301/EC-319).\n */\nexport function assetMetaFieldsOf(collection: CollectionDef): FieldDef[] {\n  return collection.fields.filter((f) => !SYSTEM_ASSET_FIELDS.has(f.name) && !f.form?.readOnly)\n}\n\n/** Drop `undefined` values so a persisted meta bag stays JSON/Convex-clean. */\nexport function pruneMeta(meta: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(meta).filter(([, v]) => v !== undefined))\n}\n\n/** Human-readable byte size (`1536` → `1.5 KB`). Shared by the asset grid + detail. */\nexport function formatBytes(byteSize: number): string {\n  if (byteSize < 1024) return `${byteSize} B`\n  if (byteSize < 1024 * 1024) return `${(byteSize / 1024).toFixed(1)} KB`\n  return `${(byteSize / (1024 * 1024)).toFixed(1)} MB`\n}\n\n/**\n * An editor's metadata change, in the EC-577 write rule: an ABSENT key leaves the\n * stored value untouched, `null` clears it, a value sets it.\n */\nexport interface AssetMetadataPatch {\n  /** New display title: a value sets (trimmed), `null` or a trimmed-empty string clears. */\n  title?: string | null\n  /**\n   * New focal point (EC-248), the normalized 0–1 hotspot threaded to delivery's\n   * `object-position` (EC-230). `{x,y}` sets it, `null` clears it (\"Reset to\n   * centre\").\n   */\n  focalPoint?: { x: number; y: number } | null\n  /**\n   * A per-key change to the schema-driven metadata bag (EC-301 → EC-634): alt,\n   * copyright, credit, … keyed by the asset collection's `fields`. A key with a value\n   * sets it, `null` removes it, a key the patch does not name keeps its STORED value —\n   * applied to the bag as stored, inside the write (core `resolveAssetWrite`), so an\n   * editor never writes back a stale copy of a key another session changed. Build it\n   * with {@link assetMetaDraftPatch} from the draft the editor opened and the one it holds.\n   * `meta.alt` is the asset's ONE shared alt (EC-587) — there is no separate alt key. There\n   * is no whole-bag form here: every studio editor of an asset's metadata patches per key.\n   */\n  metaPatch?: Record<string, unknown>\n  /**\n   * EC-632 — the same per-key change to the per-locale buckets of the asset collection's\n   * `localized: true` fields: `{ [locale]: { [field]: value | null } }`, applied per locale\n   * and key to the stored buckets inside the write.\n   */\n  localizedMetaPatch?: Record<string, Record<string, unknown>>\n}\n\n/**\n * An asset's metadata as an editor holds it (EC-632) — the DOCUMENT shape, so editing it\n * is the mechanism documents use: the shared bag (a document's `values`) and the\n * per-locale buckets of the `localized: true` fields (its `localized`). The form reads and\n * writes one field in one locale ({@link assetMetaFieldValue} / {@link setAssetMetaField});\n * the save is a structural diff of the whole draft ({@link assetMetaDraftPatch}), so it\n * needs no config and never writes a key or a locale the editor did not change.\n */\nexport interface AssetMetaDraft {\n  readonly meta: Readonly<Record<string, unknown>>\n  readonly localizedMeta: Readonly<Record<string, Readonly<Record<string, unknown>>>>\n}\n\n/** The fields of the asset collection an editor edits by — only the name and the locale flag matter here. */\ntype MetaField = Pick<FieldDef, 'name' | 'localized'>\n\n/**\n * The draft an editor opens (EC-587 + EC-632): the stored bags, with a legacy `alt` column\n * lifted into the shared one (core `liftLegacyAlt`), so a not-yet-migrated asset shows the\n * alt every reader shows — and its first save moves it home.\n */\nexport function assetMetaDraft(record: Pick<AssetRecord, 'alt' | 'meta' | 'localizedMeta'>): AssetMetaDraft {\n  const localizedMeta: Record<string, Record<string, unknown>> = {}\n  for (const [locale, bucket] of Object.entries(record.localizedMeta ?? {})) localizedMeta[locale] = { ...bucket }\n  return { meta: liftLegacyAlt(record)?.meta ?? { ...(record.meta ?? {}) }, localizedMeta }\n}\n\nconst hasOwn = (bag: Readonly<Record<string, unknown>> | undefined, key: string): boolean =>\n  bag !== undefined && Object.prototype.hasOwnProperty.call(bag, key)\n\n/**\n * What the form shows for one field (EC-632): a `localized: true` field the editor's\n * locale's own value (an untranslated locale shows empty — it falls back to the default\n * locale on delivery); the default locale also shows a value written before the field was\n * localized (the shared bag — delivery's last-resort fallback, so it IS that locale's\n * value). Any other field the shared value. Without a locale config, the shared value.\n */\nexport function assetMetaFieldValue(draft: AssetMetaDraft, field: MetaField, at: AssetReadLocale | null): unknown {\n  if (field.localized === true && at !== null) {\n    const bucket = draft.localizedMeta[at.locale]\n    if (hasOwn(bucket, field.name)) return bucket![field.name]\n    return at.locale === at.default ? draft.meta[field.name] : undefined\n  }\n  return draft.meta[field.name]\n}\n\n/**\n * Write one field of the draft (EC-632) — `undefined` removes the value:\n * - a `localized: true` field goes into the editor's locale's bucket; in the DEFAULT\n *   locale a value written before the field was localized leaves the shared bag — the\n *   default bucket is its home now, so a clear there really clears it;\n * - any other field goes into the shared bag, and a value a former localization left in a\n *   bucket is removed (one home per key — a stale bucket would shadow the shared value);\n * - without a locale config (`at` null) a localized field writes the shared bag and leaves\n *   its translations alone.\n */\nexport function setAssetMetaField(\n  draft: AssetMetaDraft,\n  field: MetaField,\n  at: AssetReadLocale | null,\n  value: unknown,\n): AssetMetaDraft {\n  const name = field.name\n  const withValue = (bag: Readonly<Record<string, unknown>> | undefined): Record<string, unknown> => {\n    const next = { ...(bag ?? {}) }\n    if (value === undefined) delete next[name]\n    else next[name] = value\n    return next\n  }\n  const without = (bag: Readonly<Record<string, unknown>>): Record<string, unknown> => {\n    const next = { ...bag }\n    delete next[name]\n    return next\n  }\n  if (field.localized === true) {\n    // No locale config installed yet: the shared bag, and the translations left untouched.\n    if (at === null) return { meta: withValue(draft.meta), localizedMeta: draft.localizedMeta }\n    const bucket = withValue(draft.localizedMeta[at.locale])\n    const localizedMeta = { ...draft.localizedMeta, [at.locale]: bucket }\n    const meta = at.locale === at.default && hasOwn(draft.meta, name) ? without(draft.meta) : draft.meta\n    return { meta, localizedMeta }\n  }\n  const localizedMeta: Record<string, Readonly<Record<string, unknown>>> = {}\n  for (const [locale, bucket] of Object.entries(draft.localizedMeta)) {\n    localizedMeta[locale] = hasOwn(bucket, name) ? without(bucket) : bucket\n  }\n  return { meta: withValue(draft.meta), localizedMeta }\n}\n\n/**\n * The per-key, per-locale patch of a metadata edit (EC-634 × EC-632): what changed between\n * the draft the editor OPENED ({@link assetMetaDraft} at open, or the draft of its last\n * successful save) and the draft it holds — `undefined` values pruned, a removed key\n * `null`, a locale it did not touch absent. Every asset metadata editor (the image options\n * dialog, the asset library's detail, the assets rail) sends this instead of its buffer.\n */\nexport function assetMetaDraftPatch(\n  opened: AssetMetaDraft,\n  edited: AssetMetaDraft,\n): Pick<AssetMetadataPatch, 'metaPatch' | 'localizedMetaPatch'> {\n  const metaPatch = metaPatchBetween(pruneMeta({ ...opened.meta }), pruneMeta({ ...edited.meta }))\n  const localizedMetaPatch: Record<string, Record<string, unknown>> = {}\n  for (const locale of new Set([...Object.keys(opened.localizedMeta), ...Object.keys(edited.localizedMeta)])) {\n    const patch = metaPatchBetween(\n      pruneMeta({ ...(opened.localizedMeta[locale] ?? {}) }),\n      pruneMeta({ ...(edited.localizedMeta[locale] ?? {}) }),\n    )\n    if (Object.keys(patch).length > 0) localizedMetaPatch[locale] = patch\n  }\n  return {\n    ...(Object.keys(metaPatch).length > 0 ? { metaPatch } : {}),\n    ...(Object.keys(localizedMetaPatch).length > 0 ? { localizedMetaPatch } : {}),\n  }\n}\n\n/** The form's flat view of a draft in one locale — `{ [field]: value }` for the given fields. */\nexport function assetMetaFormValues(\n  draft: AssetMetaDraft,\n  fields: readonly MetaField[],\n  at: AssetReadLocale | null,\n): Record<string, unknown> {\n  return Object.fromEntries(fields.map((field) => [field.name, assetMetaFieldValue(draft, field, at)]))\n}\n\n/** A text column's write: a trimmed value sets, `null`/empty clears. */\nfunction textWrite(value: string | null): string | null {\n  const trimmed = value?.trim() ?? ''\n  return trimmed.length > 0 ? trimmed : null\n}\n\n/**\n * The asset write for a metadata edit (EC-577): ONLY the keys the editor changed,\n * with `null` for a clear. It deliberately restates nothing else — not the\n * upload-owned columns, and never `thumb`/`lqip`: a stale copy of those would\n * overwrite a preview backfill that finished while the dialog was open, and a\n * clear expressed as an omitted key is exactly what never persisted on Convex.\n *\n * EC-634: `meta` travels as the per-key `metaPatch` — never the whole bag, which would\n * carry a stale copy of every key the editor did not change. An empty patch is not sent.\n * The legacy `alt` column (EC-587) is lifted into the stored bag and cleared by the write\n * rule itself, in the same transaction, whenever a patch is applied — so an alt the editor\n * did not touch survives, and one the editor cleared stays cleared (ASSETS D21).\n */\nexport function assetMetadataWrite(assetId: string, patch: AssetMetadataPatch): AssetWriteInput {\n  const metaPatch = patch.metaPatch\n  const localizedMetaPatch = patch.localizedMetaPatch\n  return {\n    id: assetId,\n    ...(patch.title !== undefined ? { title: textWrite(patch.title) } : {}),\n    ...(patch.focalPoint !== undefined ? { focalPoint: patch.focalPoint } : {}),\n    ...(metaPatch !== undefined && Object.keys(metaPatch).length > 0 ? { metaPatch } : {}),\n    ...(localizedMetaPatch !== undefined && Object.keys(localizedMetaPatch).length > 0 ? { localizedMetaPatch } : {}),\n  }\n}\n\nexport type UpdateAssetMetadataResult =\n  | { ok: true; asset: AssetRecord }\n  | { ok: false; message: string }\n\n/**\n * Persist a metadata edit via the repository (the operations facade in the\n * studio). No read first: the write carries only the change, and the adapter\n * resolves it against the stored record inside its own transaction (EC-577). An\n * asset that no longer exists is refused there (a metadata write cannot create\n * one). Failures come back as a structured result — never a throw the UI has to\n * guess about.\n */\nexport async function updateAssetMetadata(\n  deps: { assets: AssetRepository },\n  projectId: string,\n  assetId: string,\n  patch: AssetMetadataPatch,\n): Promise<UpdateAssetMetadataResult> {\n  try {\n    const asset = await deps.assets.upsertAsset(projectId, assetMetadataWrite(assetId, patch))\n    return { ok: true, asset }\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) }\n  }\n}\n"]}

package/dist/components/assets/asset-search.js

@@ -9,7 +9,13 @@ export function filterAssets(assets, query) {
     if (q.length === 0)
         return [...assets];
     return assets.filter((asset) => 
-    // EC-587 (ASSETS D20): the asset's alt through THE reader (`meta.alt`, its home).
-    [asset.filename, assetAlt(asset), asset.title].some((value) => value != null && value.toLowerCase().includes(q)));
+    // EC-587 (ASSETS D20): the asset's alt through THE reader (`meta.alt`, its home) —
+    // EC-632: in every locale it is translated into, so a search finds it from any tab.
+    [asset.filename, ...searchableAlts(asset), asset.title].some((value) => value != null && value.toLowerCase().includes(q)));
+}
+/** An asset's alt in the shared bag and in each locale it holds a bucket for (EC-632), through THE reader. */
+function searchableAlts(asset) {
+    const locales = Object.keys(asset.localizedMeta ?? {});
+    return [assetAlt(asset, null), ...locales.map((locale) => assetAlt(asset, { locale, default: locale }))];
 }
 //# sourceMappingURL=asset-search.js.map

package/dist/components/assets/asset-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-search.js","sourceRoot":"","sources":["../../../src/components/assets/asset-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAGtD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B,EAAE,KAAa;IACxE,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7B,kFAAkF;IAClF,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC5D,CACF,CAAA;AACH,CAAC","sourcesContent":["import { assetAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord } from '@elytracms/core/persistence'\n\n/**\n * Client-side asset search (EC-152): case-insensitive substring match over\n * filename, alt text, and title. Pure and deterministic — input order is\n * preserved; an empty/whitespace query matches everything.\n */\nexport function filterAssets(assets: readonly AssetRecord[], query: string): AssetRecord[] {\n  const q = query.trim().toLowerCase()\n  if (q.length === 0) return [...assets]\n  return assets.filter((asset) =>\n    // EC-587 (ASSETS D20): the asset's alt through THE reader (`meta.alt`, its home).\n    [asset.filename, assetAlt(asset), asset.title].some(\n      (value) => value != null && value.toLowerCase().includes(q),\n    ),\n  )\n}\n"]}
+{"version":3,"file":"asset-search.js","sourceRoot":"","sources":["../../../src/components/assets/asset-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAGtD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B,EAAE,KAAa;IACxE,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7B,mFAAmF;IACnF,oFAAoF;IACpF,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAC1D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC5D,CACF,CAAA;AACH,CAAC;AAED,8GAA8G;AAC9G,SAAS,cAAc,CAAC,KAAkB;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAA;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AAC1G,CAAC","sourcesContent":["import { assetAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord } from '@elytracms/core/persistence'\n\n/**\n * Client-side asset search (EC-152): case-insensitive substring match over\n * filename, alt text, and title. Pure and deterministic — input order is\n * preserved; an empty/whitespace query matches everything.\n */\nexport function filterAssets(assets: readonly AssetRecord[], query: string): AssetRecord[] {\n  const q = query.trim().toLowerCase()\n  if (q.length === 0) return [...assets]\n  return assets.filter((asset) =>\n    // EC-587 (ASSETS D20): the asset's alt through THE reader (`meta.alt`, its home) —\n    // EC-632: in every locale it is translated into, so a search finds it from any tab.\n    [asset.filename, ...searchableAlts(asset), asset.title].some(\n      (value) => value != null && value.toLowerCase().includes(q),\n    ),\n  )\n}\n\n/** An asset's alt in the shared bag and in each locale it holds a bucket for (EC-632), through THE reader. */\nfunction searchableAlts(asset: AssetRecord): (string | null)[] {\n  const locales = Object.keys(asset.localizedMeta ?? {})\n  return [assetAlt(asset, null), ...locales.map((locale) => assetAlt(asset, { locale, default: locale }))]\n}\n"]}

package/dist/components/assets/asset-thumb.js

@@ -6,6 +6,7 @@ import { Text } from '@elytracms/studio/ui';
 import { translate } from '../../lib/i18n/index.js';
 import { cn } from '../../lib/utils.js';
 import { useOptionalAssets } from './assets-store.js';
+import { useAssetReadLocale } from './asset-locale.js';
 import { isDisplayableAssetUrl } from '../../lib/assets/index.js';
 import { CENTER_FOCAL_POINT, focalPointFromPoint, focalPointObjectPosition, } from './focal-point.js';
 /** Resolve an asset record by id from the ambient library, if one is mounted. */
@@ -53,8 +54,10 @@ function thumbnailSrc(record) {
  */
 export function AssetThumb({ record, className, alt, }) {
     const src = thumbnailSrc(record);
+    // EC-632: the alt in the studio's locale (a localized alt shows the open locale's).
+    const at = useAssetReadLocale();
     if (record && src) {
-        return (_jsx("img", { src: src, alt: alt ?? assetAlt(record) ?? record.title ?? record.filename, loading: "lazy", style: { objectPosition: focalPointObjectPosition(record.focalPoint) }, className: cn('rounded border border-border bg-muted object-cover', className) }));
+        return (_jsx("img", { src: src, alt: alt ?? assetAlt(record, at) ?? record.title ?? record.filename, loading: "lazy", style: { objectPosition: focalPointObjectPosition(record.focalPoint) }, className: cn('rounded border border-border bg-muted object-cover', className) }));
     }
     return (_jsx("div", { className: cn('flex items-center justify-center rounded border border-border bg-muted text-muted-foreground', className), children: _jsx(Image, { className: "size-4", "aria-hidden": true }) }));
 }
@@ -70,6 +73,7 @@ export function FocalPointPicker({ record, point, onChange, onPreview, disabled,
     const marker = point ?? CENTER_FOCAL_POINT;
     const dragging = useRef(false);
     const [loaded, setLoaded] = useState(false);
+    const at = useAssetReadLocale(); // EC-632: the alt in the studio's locale
     if (!isResolvableImage(record)) {
         return (_jsx(Text, { size: "xs", tone: "subtle", children: translate('assets.focalPoint.noPreview') }));
     }
@@ -93,7 +97,7 @@ export function FocalPointPicker({ record, point, onChange, onPreview, disabled,
         e.currentTarget.releasePointerCapture(e.pointerId);
         onChange(pointFrom(e)); // commit on release only
     }
-    return (_jsxs("button", { type: "button", "aria-label": translate('assets.focalPoint.setLabel'), disabled: disabled, onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, className: cn('relative block w-full touch-none select-none overflow-hidden rounded border border-border bg-muted', 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40', disabled ? 'cursor-default opacity-60' : 'cursor-crosshair'), children: [_jsx("img", { src: record.url, alt: assetAlt(record) ?? record.filename, draggable: false, onLoad: () => setLoaded(true), className: cn('block h-auto w-full select-none transition-opacity', loaded ? 'opacity-100' : 'opacity-0') }), !loaded ? (_jsx("span", { className: "absolute inset-0 grid aspect-video place-items-center bg-muted", children: _jsx(Image, { className: "size-6 animate-pulse text-muted-foreground", "aria-hidden": true }) })) : (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute size-4 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-white shadow-[0_0_0_1.5px_rgba(0,0,0,0.55)] ring-1 ring-black/40", style: { left: `${marker.x * 100}%`, top: `${marker.y * 100}%` } }))] }));
+    return (_jsxs("button", { type: "button", "aria-label": translate('assets.focalPoint.setLabel'), disabled: disabled, onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, className: cn('relative block w-full touch-none select-none overflow-hidden rounded border border-border bg-muted', 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40', disabled ? 'cursor-default opacity-60' : 'cursor-crosshair'), children: [_jsx("img", { src: record.url, alt: assetAlt(record, at) ?? record.filename, draggable: false, onLoad: () => setLoaded(true), className: cn('block h-auto w-full select-none transition-opacity', loaded ? 'opacity-100' : 'opacity-0') }), !loaded ? (_jsx("span", { className: "absolute inset-0 grid aspect-video place-items-center bg-muted", children: _jsx(Image, { className: "size-6 animate-pulse text-muted-foreground", "aria-hidden": true }) })) : (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute size-4 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-white shadow-[0_0_0_1.5px_rgba(0,0,0,0.55)] ring-1 ring-black/40", style: { left: `${marker.x * 100}%`, top: `${marker.y * 100}%` } }))] }));
 }
 /** Common crop aspect ratios shown as focal-aware previews (EC-301). */
 const FOCAL_CROP_RATIOS = [

package/dist/components/assets/asset-thumb.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-thumb.js","sourceRoot":"","sources":["../../../src/components/assets/asset-thumb.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useRef, useState } from 'react'\nimport { Image } from 'lucide-react'\nimport { assetAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport { Text } from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { cn } from '../../lib/utils'\nimport { useOptionalAssets } from './assets-store'\nimport { isDisplayableAssetUrl } from '../../lib/assets'\nimport {\n  CENTER_FOCAL_POINT,\n  focalPointFromPoint,\n  focalPointObjectPosition,\n} from './focal-point'\nimport type { FocalPoint } from './focal-point'\n\n/** Resolve an asset record by id from the ambient library, if one is mounted. */\nexport function useAssetRecord(assetId: string | null | undefined): AssetRecord | undefined {\n  const store = useOptionalAssets()\n  return useMemo(() => {\n    if (!assetId || !store || store.status !== 'ready') return undefined\n    return store.assets.find((a) => a.id === assetId)\n  }, [assetId, store])\n}\n\n/** True when the record is an image with a browser-displayable URL (EC-212, EC-459). */\nfunction isResolvableImage(record: AssetRecord | undefined): record is AssetRecord & { url: string } {\n  return (\n    record !== undefined &&\n    record.contentType.startsWith('image/') &&\n    isDisplayableAssetUrl(record.url)\n  )\n}\n\n/**\n * The best studio thumbnail src for an image record (EC-400): prefer the stored\n * downscaled `thumb` variant when it is browser-displayable, else fall back to\n * the full original `url` (EC-459: `http(s)`, `blob:`, and `data:` all qualify —\n * an opaque backend locator like `memory://` does not). A missing/broken thumb\n * therefore degrades to the original — never a broken tile (scope §4). Non-image\n * / unresolvable records yield `undefined` (the icon placeholder). Focal-point\n * editing + the canvas keep the original elsewhere (delivery fidelity) — this\n * preference is thumbnail-only.\n */\nfunction thumbnailSrc(record: AssetRecord | undefined): string | undefined {\n  if (!record || !record.contentType.startsWith('image/')) return undefined\n  const thumbUrl = record.thumb?.url\n  if (isDisplayableAssetUrl(thumbUrl)) return thumbUrl\n  if (isDisplayableAssetUrl(record.url)) return record.url\n  return undefined\n}\n\n/**\n * A read-only image thumbnail honouring the asset's focal point (EC-248): the\n * preview crops with the same `object-position` delivery uses (EC-230), so the\n * editor sees exactly what a focal-point change does. Prefers the EC-400\n * downscaled `thumb` variant (light egress) and falls back to the original.\n * Non-image / unresolvable assets fall back to the labelled icon, matching the\n * table cell's preview.\n */\nexport function AssetThumb({\n  record,\n  className,\n  alt,\n}: {\n  record: AssetRecord | undefined\n  className?: string\n  alt?: string\n}) {\n  const src = thumbnailSrc(record)\n  if (record && src) {\n    return (\n      <img\n        src={src}\n        alt={alt ?? assetAlt(record) ?? record.title ?? record.filename}\n        loading=\"lazy\"\n        style={{ objectPosition: focalPointObjectPosition(record.focalPoint) }}\n        className={cn('rounded border border-border bg-muted object-cover', className)}\n      />\n    )\n  }\n  return (\n    <div\n      className={cn(\n        'flex items-center justify-center rounded border border-border bg-muted text-muted-foreground',\n        className,\n      )}\n    >\n      <Image className=\"size-4\" aria-hidden />\n    </div>\n  )\n}\n\n/**\n * The focal-point picker (EC-248/EC-301): click or **drag** anywhere on the image\n * to place the normalized 0–1 hotspot delivery threads to `object-position`\n * (EC-230). The marker follows the pointer live while dragging and only commits on\n * release (`onPreview` updates the marker, `onChange` commits). `onChange(null)`\n * resets to centre. Shows a placeholder until the image loads; renders a muted note\n * when the asset has no resolvable image.\n */\nexport function FocalPointPicker({\n  record,\n  point,\n  onChange,\n  onPreview,\n  disabled,\n}: {\n  record: AssetRecord | undefined\n  point: FocalPoint | undefined\n  onChange: (point: FocalPoint | null) => void\n  /** Called continuously while dragging to move the marker without committing. */\n  onPreview?: (point: FocalPoint) => void\n  disabled?: boolean\n}) {\n  const marker = point ?? CENTER_FOCAL_POINT\n  const dragging = useRef(false)\n  const [loaded, setLoaded] = useState(false)\n\n  if (!isResolvableImage(record)) {\n    return (\n      <Text size=\"xs\" tone=\"subtle\">\n        {translate('assets.focalPoint.noPreview')}\n      </Text>\n    )\n  }\n\n  const pointFrom = (e: React.PointerEvent<HTMLElement>): FocalPoint =>\n    focalPointFromPoint(e.currentTarget.getBoundingClientRect(), e.clientX, e.clientY)\n\n  function onPointerDown(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled) return\n    dragging.current = true\n    e.currentTarget.setPointerCapture(e.pointerId)\n    ;(onPreview ?? onChange)(pointFrom(e))\n  }\n  function onPointerMove(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled || !dragging.current) return\n    ;(onPreview ?? onChange)(pointFrom(e))\n  }\n  function onPointerUp(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled || !dragging.current) return\n    dragging.current = false\n    e.currentTarget.releasePointerCapture(e.pointerId)\n    onChange(pointFrom(e)) // commit on release only\n  }\n\n  return (\n    <button\n      type=\"button\"\n      aria-label={translate('assets.focalPoint.setLabel')}\n      disabled={disabled}\n      onPointerDown={onPointerDown}\n      onPointerMove={onPointerMove}\n      onPointerUp={onPointerUp}\n      className={cn(\n        'relative block w-full touch-none select-none overflow-hidden rounded border border-border bg-muted',\n        'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40',\n        disabled ? 'cursor-default opacity-60' : 'cursor-crosshair',\n      )}\n    >\n      {/* Width-constrained, natural aspect (no object-fit), so the button wraps\n          the image tightly and the bounding rect equals the image box — the\n          normalized pointer coordinates are then exact, with no letterbox offset. */}\n      <img\n        src={record.url}\n        alt={assetAlt(record) ?? record.filename}\n        draggable={false}\n        onLoad={() => setLoaded(true)}\n        className={cn('block h-auto w-full select-none transition-opacity', loaded ? 'opacity-100' : 'opacity-0')}\n      />\n      {!loaded ? (\n        <span className=\"absolute inset-0 grid aspect-video place-items-center bg-muted\">\n          <Image className=\"size-6 animate-pulse text-muted-foreground\" aria-hidden />\n        </span>\n      ) : (\n        <span\n          aria-hidden\n          className=\"pointer-events-none absolute size-4 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-white shadow-[0_0_0_1.5px_rgba(0,0,0,0.55)] ring-1 ring-black/40\"\n          style={{ left: `${marker.x * 100}%`, top: `${marker.y * 100}%` }}\n        />\n      )}\n    </button>\n  )\n}\n\n/** Common crop aspect ratios shown as focal-aware previews (EC-301). */\nconst FOCAL_CROP_RATIOS = [\n  { label: '9:16', className: 'aspect-[9/16]' },\n  { label: '3:4', className: 'aspect-[3/4]' },\n  { label: '1:1', className: 'aspect-square' },\n  { label: '4:3', className: 'aspect-[4/3]' },\n  { label: '16:9', className: 'aspect-video' },\n] as const\n\n/**\n * A row of common-ratio crop previews (EC-301), each cropping the image with the\n * same `object-position` delivery uses — so the editor sees how the focal point\n * holds the subject across portrait/square/landscape crops. Updates live as the\n * point is dragged.\n */\nexport function FocalCropPreviews({\n  record,\n  point,\n}: {\n  record: AssetRecord | undefined\n  point: FocalPoint | undefined\n}) {\n  if (!isResolvableImage(record)) return null\n  const objectPosition = focalPointObjectPosition(point)\n  return (\n    <div className=\"flex items-end gap-2\">\n      {FOCAL_CROP_RATIOS.map((ratio) => (\n        <div key={ratio.label} className=\"flex min-w-0 flex-col items-center gap-1\">\n          <div className={cn('h-14 overflow-hidden rounded border border-border bg-muted', ratio.className)}>\n            <img\n              src={record.url}\n              alt=\"\"\n              draggable={false}\n              style={{ objectPosition }}\n              className=\"h-full w-full object-cover\"\n            />\n          </div>\n          <Text size=\"xs\" tone=\"subtle\">\n            {ratio.label}\n          </Text>\n        </div>\n      ))}\n    </div>\n  )\n}\n"]}
+{"version":3,"file":"asset-thumb.js","sourceRoot":"","sources":["../../../src/components/assets/asset-thumb.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useRef, useState } from 'react'\nimport { Image } from 'lucide-react'\nimport { assetAlt } from '@elytracms/core/persistence'\nimport type { AssetRecord } from '@elytracms/core/persistence'\nimport { Text } from '@elytracms/studio/ui'\nimport { translate } from '../../lib/i18n'\nimport { cn } from '../../lib/utils'\nimport { useOptionalAssets } from './assets-store'\nimport { useAssetReadLocale } from './asset-locale'\nimport { isDisplayableAssetUrl } from '../../lib/assets'\nimport {\n  CENTER_FOCAL_POINT,\n  focalPointFromPoint,\n  focalPointObjectPosition,\n} from './focal-point'\nimport type { FocalPoint } from './focal-point'\n\n/** Resolve an asset record by id from the ambient library, if one is mounted. */\nexport function useAssetRecord(assetId: string | null | undefined): AssetRecord | undefined {\n  const store = useOptionalAssets()\n  return useMemo(() => {\n    if (!assetId || !store || store.status !== 'ready') return undefined\n    return store.assets.find((a) => a.id === assetId)\n  }, [assetId, store])\n}\n\n/** True when the record is an image with a browser-displayable URL (EC-212, EC-459). */\nfunction isResolvableImage(record: AssetRecord | undefined): record is AssetRecord & { url: string } {\n  return (\n    record !== undefined &&\n    record.contentType.startsWith('image/') &&\n    isDisplayableAssetUrl(record.url)\n  )\n}\n\n/**\n * The best studio thumbnail src for an image record (EC-400): prefer the stored\n * downscaled `thumb` variant when it is browser-displayable, else fall back to\n * the full original `url` (EC-459: `http(s)`, `blob:`, and `data:` all qualify —\n * an opaque backend locator like `memory://` does not). A missing/broken thumb\n * therefore degrades to the original — never a broken tile (scope §4). Non-image\n * / unresolvable records yield `undefined` (the icon placeholder). Focal-point\n * editing + the canvas keep the original elsewhere (delivery fidelity) — this\n * preference is thumbnail-only.\n */\nfunction thumbnailSrc(record: AssetRecord | undefined): string | undefined {\n  if (!record || !record.contentType.startsWith('image/')) return undefined\n  const thumbUrl = record.thumb?.url\n  if (isDisplayableAssetUrl(thumbUrl)) return thumbUrl\n  if (isDisplayableAssetUrl(record.url)) return record.url\n  return undefined\n}\n\n/**\n * A read-only image thumbnail honouring the asset's focal point (EC-248): the\n * preview crops with the same `object-position` delivery uses (EC-230), so the\n * editor sees exactly what a focal-point change does. Prefers the EC-400\n * downscaled `thumb` variant (light egress) and falls back to the original.\n * Non-image / unresolvable assets fall back to the labelled icon, matching the\n * table cell's preview.\n */\nexport function AssetThumb({\n  record,\n  className,\n  alt,\n}: {\n  record: AssetRecord | undefined\n  className?: string\n  alt?: string\n}) {\n  const src = thumbnailSrc(record)\n  // EC-632: the alt in the studio's locale (a localized alt shows the open locale's).\n  const at = useAssetReadLocale()\n  if (record && src) {\n    return (\n      <img\n        src={src}\n        alt={alt ?? assetAlt(record, at) ?? record.title ?? record.filename}\n        loading=\"lazy\"\n        style={{ objectPosition: focalPointObjectPosition(record.focalPoint) }}\n        className={cn('rounded border border-border bg-muted object-cover', className)}\n      />\n    )\n  }\n  return (\n    <div\n      className={cn(\n        'flex items-center justify-center rounded border border-border bg-muted text-muted-foreground',\n        className,\n      )}\n    >\n      <Image className=\"size-4\" aria-hidden />\n    </div>\n  )\n}\n\n/**\n * The focal-point picker (EC-248/EC-301): click or **drag** anywhere on the image\n * to place the normalized 0–1 hotspot delivery threads to `object-position`\n * (EC-230). The marker follows the pointer live while dragging and only commits on\n * release (`onPreview` updates the marker, `onChange` commits). `onChange(null)`\n * resets to centre. Shows a placeholder until the image loads; renders a muted note\n * when the asset has no resolvable image.\n */\nexport function FocalPointPicker({\n  record,\n  point,\n  onChange,\n  onPreview,\n  disabled,\n}: {\n  record: AssetRecord | undefined\n  point: FocalPoint | undefined\n  onChange: (point: FocalPoint | null) => void\n  /** Called continuously while dragging to move the marker without committing. */\n  onPreview?: (point: FocalPoint) => void\n  disabled?: boolean\n}) {\n  const marker = point ?? CENTER_FOCAL_POINT\n  const dragging = useRef(false)\n  const [loaded, setLoaded] = useState(false)\n  const at = useAssetReadLocale() // EC-632: the alt in the studio's locale\n\n  if (!isResolvableImage(record)) {\n    return (\n      <Text size=\"xs\" tone=\"subtle\">\n        {translate('assets.focalPoint.noPreview')}\n      </Text>\n    )\n  }\n\n  const pointFrom = (e: React.PointerEvent<HTMLElement>): FocalPoint =>\n    focalPointFromPoint(e.currentTarget.getBoundingClientRect(), e.clientX, e.clientY)\n\n  function onPointerDown(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled) return\n    dragging.current = true\n    e.currentTarget.setPointerCapture(e.pointerId)\n    ;(onPreview ?? onChange)(pointFrom(e))\n  }\n  function onPointerMove(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled || !dragging.current) return\n    ;(onPreview ?? onChange)(pointFrom(e))\n  }\n  function onPointerUp(e: React.PointerEvent<HTMLButtonElement>) {\n    if (disabled || !dragging.current) return\n    dragging.current = false\n    e.currentTarget.releasePointerCapture(e.pointerId)\n    onChange(pointFrom(e)) // commit on release only\n  }\n\n  return (\n    <button\n      type=\"button\"\n      aria-label={translate('assets.focalPoint.setLabel')}\n      disabled={disabled}\n      onPointerDown={onPointerDown}\n      onPointerMove={onPointerMove}\n      onPointerUp={onPointerUp}\n      className={cn(\n        'relative block w-full touch-none select-none overflow-hidden rounded border border-border bg-muted',\n        'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/40',\n        disabled ? 'cursor-default opacity-60' : 'cursor-crosshair',\n      )}\n    >\n      {/* Width-constrained, natural aspect (no object-fit), so the button wraps\n          the image tightly and the bounding rect equals the image box — the\n          normalized pointer coordinates are then exact, with no letterbox offset. */}\n      <img\n        src={record.url}\n        alt={assetAlt(record, at) ?? record.filename}\n        draggable={false}\n        onLoad={() => setLoaded(true)}\n        className={cn('block h-auto w-full select-none transition-opacity', loaded ? 'opacity-100' : 'opacity-0')}\n      />\n      {!loaded ? (\n        <span className=\"absolute inset-0 grid aspect-video place-items-center bg-muted\">\n          <Image className=\"size-6 animate-pulse text-muted-foreground\" aria-hidden />\n        </span>\n      ) : (\n        <span\n          aria-hidden\n          className=\"pointer-events-none absolute size-4 -translate-x-1/2 -translate-y-1/2 rounded-full border-2 border-white shadow-[0_0_0_1.5px_rgba(0,0,0,0.55)] ring-1 ring-black/40\"\n          style={{ left: `${marker.x * 100}%`, top: `${marker.y * 100}%` }}\n        />\n      )}\n    </button>\n  )\n}\n\n/** Common crop aspect ratios shown as focal-aware previews (EC-301). */\nconst FOCAL_CROP_RATIOS = [\n  { label: '9:16', className: 'aspect-[9/16]' },\n  { label: '3:4', className: 'aspect-[3/4]' },\n  { label: '1:1', className: 'aspect-square' },\n  { label: '4:3', className: 'aspect-[4/3]' },\n  { label: '16:9', className: 'aspect-video' },\n] as const\n\n/**\n * A row of common-ratio crop previews (EC-301), each cropping the image with the\n * same `object-position` delivery uses — so the editor sees how the focal point\n * holds the subject across portrait/square/landscape crops. Updates live as the\n * point is dragged.\n */\nexport function FocalCropPreviews({\n  record,\n  point,\n}: {\n  record: AssetRecord | undefined\n  point: FocalPoint | undefined\n}) {\n  if (!isResolvableImage(record)) return null\n  const objectPosition = focalPointObjectPosition(point)\n  return (\n    <div className=\"flex items-end gap-2\">\n      {FOCAL_CROP_RATIOS.map((ratio) => (\n        <div key={ratio.label} className=\"flex min-w-0 flex-col items-center gap-1\">\n          <div className={cn('h-14 overflow-hidden rounded border border-border bg-muted', ratio.className)}>\n            <img\n              src={record.url}\n              alt=\"\"\n              draggable={false}\n              style={{ objectPosition }}\n              className=\"h-full w-full object-cover\"\n            />\n          </div>\n          <Text size=\"xs\" tone=\"subtle\">\n            {ratio.label}\n          </Text>\n        </div>\n      ))}\n    </div>\n  )\n}\n"]}

package/dist/components/assets/assets-collection-view-source.d.ts

@@ -1,8 +1,9 @@
 import type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/core/cms-core';
-import type { AssetRecord, ReferenceTarget } from '@elytracms/core/persistence';
+import type { AssetReadLocale, AssetRecord, ReferenceTarget } from '@elytracms/core/persistence';
 import type { OperationError } from '@elytracms/core/operations';
 import type { DeleteAssetResult } from '../../lib/assets/index.js';
 import type { CollectionViewSource, CollectionViewCapabilities } from '../../lib/collection-view/collection-view-source.js';
+import type { AssetMetadataPatch } from './asset-metadata.js';
 /**
  * The capability profile of the assets rail (EC-319, EC-433). Hoisted to a
  * module-level constant (no prop/state dependency) so it's both the value the
@@ -32,18 +33,31 @@ export declare const ASSET_COLLECTION_CAPABILITIES: CollectionViewCapabilities;
  * 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.
+ *
+ * EC-632: the values are the metadata's view in `at` (the studio's locale) — a
+ * `localized: true` field shows that locale's value, with delivery's fallback, held in
+ * the lens's one locale bucket (`localized[at.locale]`, the rail's locale), so the table
+ * reads it as that locale's value rather than as a fallback.
  */
-export declare function assetToDocument(collection: CollectionDef, record: AssetRecord): CmsDocument;
+export declare function assetToDocument(collection: CollectionDef, record: AssetRecord, at: AssetReadLocale | null): CmsDocument;
 /**
- * The inverse of {@link assetToDocument}: the meta bag a save writes back — every
+ * The inverse of {@link assetToDocument}: the meta bag a lens document holds — every
  * value outside the system set (EC-301/EC-311), declared or not, through the ONE
- * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d).
- * `meta` is written whole (it replaces the stored bag), so a key the lens never
- * declared must be in it: the schema-driven projection this replaced dropped them
- * on every rail save (D22), while the options dialog and asset detail kept them.
- * System columns are upload-managed and never written here.
+ * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d). A key
+ * the lens never declared is in it (the schema-driven projection this replaced dropped
+ * them, D22). System columns are upload-managed and never written here.
+ */
+export declare function documentToAssetMeta(doc: CmsDocument): Record<string, unknown>;
+/**
+ * The rail save's metadata write (EC-634 × EC-632): only the keys whose value differs
+ * between the document as the editor OPENED it (`base`, forwarded by the edit shell —
+ * EC-616) and the one it saves, each written where its field lives — a `localized: true`
+ * field into `at`'s bucket, any other into the shared bag (`setAssetMetaField`, the
+ * editors' one rule) — as the per-key, per-locale patch against the record as stored. A
+ * key this editor did not change is never written. Without a base every key of the saved
+ * bag is set and none is removed.
  */
-export declare function documentToAssetMetaPatch(doc: CmsDocument): Record<string, unknown>;
+export declare function assetRailMetaPatch(collection: CollectionDef, record: AssetRecord, at: AssetReadLocale | null, doc: CmsDocument, base?: CmsDocument): Pick<AssetMetadataPatch, 'metaPatch' | 'localizedMetaPatch'>;
 /** Assets' `remove()` returns an `outcome`-discriminated {@link DeleteAssetResult}
  *  (not the `{ ok }` shape users/redirects use, EC-327). `'error'` surfaces as-is;
  *  `'blocked'` (the unconfirmed usage gate fired — nothing was removed) surfaces

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

@@ -1,17 +1,23 @@
 import { useCallback, useMemo } from 'react';
-import { createCollectionRegistry, validateDocument } from '@elytracms/core/cms-core';
-import { assetAlt } from '@elytracms/core/persistence';
+import { createCollectionRegistry, semanticValueEqual, validateDocument } from '@elytracms/core/cms-core';
+import { assetAlt, assetMetaView } 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';
+import { SYSTEM_ASSET_FIELDS, assetMetaDraft, assetMetaDraftPatch, pruneMeta, setAssetMetaField } from './asset-metadata.js';
+import { useAssetReadLocale } from './asset-locale.js';
 import { metaBagProjection, normalizeOkResult, useRailViewSource } from '../rail-view-source.js';
 import { parseLocaleConfig } from '@elytracms/core/cms-core';
-/** The assets rail is not localized in v1 (EC-301: asset metadata is non-localized). */
+/**
+ * The assets rail has no locale switcher of its own (capability `locales: false`): it
+ * reads in ONE locale — the studio's (EC-632), a localized field's value in that locale —
+ * so its lens is a one-locale document in that locale. Before a project's locales are
+ * installed, the engine's neutral `en` (shared metadata only: nothing is localized then).
+ */
 const ASSETS_LOCALE = 'en';
-const ASSETS_LOCALE_CONFIG = parseLocaleConfig({
-    default: ASSETS_LOCALE,
-    locales: [ASSETS_LOCALE],
-});
+function railLocaleConfig(at) {
+    const locale = at?.locale ?? ASSETS_LOCALE;
+    return parseLocaleConfig({ default: locale, locales: [locale] });
+}
 /**
  * The capability profile of the assets rail (EC-319, EC-433). Hoisted to a
  * module-level constant (no prop/state dependency) so it's both the value the
@@ -77,12 +83,17 @@ function systemFieldValue(record, name) {
  * 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.
+ *
+ * EC-632: the values are the metadata's view in `at` (the studio's locale) — a
+ * `localized: true` field shows that locale's value, with delivery's fallback, held in
+ * the lens's one locale bucket (`localized[at.locale]`, the rail's locale), so the table
+ * reads it as that locale's value rather than as a fallback.
  */
-export function assetToDocument(collection, record) {
-    const values = { ...(record.meta ?? {}) };
+export function assetToDocument(collection, record, at) {
+    const values = assetMetaView(record, at);
     for (const field of collection.fields) {
         if (field.name === 'alt') {
-            const alt = assetAlt(record);
+            const alt = assetAlt(record, at);
             if (alt !== null)
                 values.alt = alt;
             else
@@ -92,19 +103,52 @@ export function assetToDocument(collection, record) {
             values[field.name] = systemFieldValue(record, field.name);
         }
     }
-    return { collection: collection.id, id: record.id, values };
+    if (at === null)
+        return { collection: collection.id, id: record.id, values };
+    const bucket = {};
+    for (const field of collection.fields) {
+        if (field.localized !== true || !Object.prototype.hasOwnProperty.call(values, field.name))
+            continue;
+        bucket[field.name] = values[field.name];
+        delete values[field.name];
+    }
+    return Object.keys(bucket).length > 0
+        ? { collection: collection.id, id: record.id, values, localized: { [at.locale]: bucket } }
+        : { collection: collection.id, id: record.id, values };
 }
 /**
- * The inverse of {@link assetToDocument}: the meta bag a save writes back — every
+ * The inverse of {@link assetToDocument}: the meta bag a lens document holds — every
  * value outside the system set (EC-301/EC-311), declared or not, through the ONE
- * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d).
- * `meta` is written whole (it replaces the stored bag), so a key the lens never
- * declared must be in it: the schema-driven projection this replaced dropped them
- * on every rail save (D22), while the options dialog and asset detail kept them.
- * System columns are upload-managed and never written here.
+ * value-keyed projection the users/redirects rails share (EC-577, RESIDUE-3d). A key
+ * the lens never declared is in it (the schema-driven projection this replaced dropped
+ * them, D22). System columns are upload-managed and never written here.
  */
-export function documentToAssetMetaPatch(doc) {
-    return pruneMeta(metaBagProjection(doc.values ?? {}, SYSTEM_ASSET_FIELDS));
+export function documentToAssetMeta(doc) {
+    // EC-632: the lens's one locale bucket (a localized field's value) reads beside `values`.
+    const localized = Object.values(doc.localized ?? {}).reduce((all, bag) => ({ ...all, ...bag }), {});
+    return pruneMeta(metaBagProjection({ ...(doc.values ?? {}), ...localized }, SYSTEM_ASSET_FIELDS));
+}
+/**
+ * The rail save's metadata write (EC-634 × EC-632): only the keys whose value differs
+ * between the document as the editor OPENED it (`base`, forwarded by the edit shell —
+ * EC-616) and the one it saves, each written where its field lives — a `localized: true`
+ * field into `at`'s bucket, any other into the shared bag (`setAssetMetaField`, the
+ * editors' one rule) — as the per-key, per-locale patch against the record as stored. A
+ * key this editor did not change is never written. Without a base every key of the saved
+ * bag is set and none is removed.
+ */
+export function assetRailMetaPatch(collection, record, at, doc, base) {
+    const before = base ? documentToAssetMeta(base) : {};
+    const after = documentToAssetMeta(doc);
+    const opened = assetMetaDraft(record);
+    let edited = opened;
+    for (const name of new Set([...Object.keys(before), ...Object.keys(after)])) {
+        if (semanticValueEqual(before[name], after[name]))
+            continue;
+        const field = collection.fields.find((f) => f.name === name) ?? { name };
+        edited = setAssetMetaField(edited, field, at, after[name]);
+    }
+    return assetMetaDraftPatch(opened, edited);
 }
 /** `create` when `capabilities.create === false` — never reached from the UI
  *  (list/detail never call it); an explicit throw rather than a silent no-op. */
@@ -159,17 +203,25 @@ export function assetReferenceTarget(ref) {
 export function useAssetsCollectionViewSource(projectId, schema) {
     const store = useAssets();
     const registry = useMemo(() => createCollectionRegistry([schema]), [schema]);
-    const documents = useCallback(() => store.assets.map((record) => assetToDocument(schema, record)), [store.assets, schema]);
+    // EC-632: the rail reads (and a save writes) a localized field in the studio's locale.
+    const at = useAssetReadLocale();
+    const documents = useCallback(() => store.assets.map((record) => assetToDocument(schema, record, at)), [store.assets, schema, at]);
     const get = useCallback((ref) => {
         const record = store.assets.find((a) => a.id === ref.id);
-        return record ? assetToDocument(schema, record) : undefined;
-    }, [store.assets, schema]);
+        return record ? assetToDocument(schema, record, at) : undefined;
+    }, [store.assets, schema, at]);
     const titleOf = useCallback((ref) => {
         const record = store.assets.find((a) => a.id === ref.id);
         return record?.title ?? record?.filename ?? ref.id;
     }, [store.assets]);
-    const validate = useCallback((doc) => validateDocument(registry, doc, { localeConfig: ASSETS_LOCALE_CONFIG }), [registry]);
-    const save = useCallback((doc) => store.updateMetadata(doc.id, { meta: documentToAssetMetaPatch(doc) }), [store]);
+    const localeConfig = useMemo(() => railLocaleConfig(at), [at]);
+    const validate = useCallback((doc) => validateDocument(registry, doc, { localeConfig }), [registry, localeConfig]);
+    const save = useCallback(async (doc, base) => {
+        const record = store.assets.find((a) => a.id === doc.id);
+        if (!record)
+            return { ok: false, message: `No asset “${doc.id}” is loaded.` };
+        return store.updateMetadata(doc.id, assetRailMetaPatch(schema, record, at, doc, base));
+    }, [store, schema, at]);
     // The unconfirmed delete (the store's usage gate still applies — a referenced
     // asset comes back `blocked`, surfaced via `lastError`). The UI's delete paths
     // never land here: row/bulk deletes confirm through the reference dialog and
@@ -184,7 +236,7 @@ export function useAssetsCollectionViewSource(projectId, schema) {
         projectId,
         schema,
         capabilities: ASSET_COLLECTION_CAPABILITIES,
-        localeConfig: ASSETS_LOCALE_CONFIG,
+        localeConfig,
         documents,
         get,
         titleOf,