@aphexcms/cms-core 9.2.0 → 9.2.1

package/dist/lib/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/client/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,oEAAoE;AAEpE,gDAAgD;AAChD,cAAc,gBAAgB,CAAC;AAG/B,4CAA4C;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAE1C,+DAA+D;AAC/D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,uDAAuD;AACvD,OAAO,EACN,qBAAqB,EACrB,cAAc,EAEd,MAAM,+BAA+B,CAAC;AAEvC,8CAA8C;AAC9C,cAAc,uBAAuB,CAAC;AAEtC,qDAAqD;AACrD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEzE,gBAAgB;AAChB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE1F,mBAAmB;AACnB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAE7F,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAG7B,uEAAuE;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,2DAA2D;AAC3D,OAAO,EACN,aAAa,EAEb,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,6DAA6D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/client/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,oEAAoE;AAEpE,gDAAgD;AAChD,cAAc,gBAAgB,CAAC;AAG/B,4CAA4C;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAE1C,+DAA+D;AAC/D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,uDAAuD;AACvD,OAAO,EACN,qBAAqB,EACrB,cAAc,EAEd,MAAM,+BAA+B,CAAC;AAEvC,8CAA8C;AAC9C,cAAc,uBAAuB,CAAC;AAEtC,qDAAqD;AACrD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAEzE,gBAAgB;AAChB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE1F,mBAAmB;AACnB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAE7F,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,cAAc,CAAC;AAG7B,uEAAuE;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,2DAA2D;AAC3D,OAAO,EACN,aAAa,EAEb,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAE3G,yFAAyF;AACzF,0FAA0F;AAC1F,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/components/admin/fields/richtext/svelte-node-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svelte-node-view.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/svelte-node-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAK,IAAI,EACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,IAEvB,OAAO,qBAAqB,KAAG,mBAAmB,CA8D1D"}
+{"version":3,"file":"svelte-node-view.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/svelte-node-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAK,IAAI,EACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,IAEvB,OAAO,qBAAqB,KAAG,mBAAmB,CAyE1D"}

package/dist/lib/components/admin/fields/richtext/svelte-node-view.js

@@ -38,7 +38,18 @@ export function SvelteNodeViewRenderer(onEdit, onDelete) {
             update(node) {
                 if (node.type.name !== 'portableTextObject')
                     return false;
+                const prevType = nodeAttrs._type;
+                const prevRef = nodeAttrs.data?.asset?._ref;
                 nodeAttrs = node.attrs;
+                const nextType = nodeAttrs._type;
+                const nextRef = nodeAttrs.data?.asset?._ref;
+                // Image views re-fetch their asset on mount, so a blind remount makes the
+                // thumbnail flash (or briefly disappear) on every keystroke/selection. Skip
+                // the remount when the image is visually unchanged — alt edits don't touch the
+                // thumbnail. Other block types still remount so their content stays in sync.
+                if (prevType === 'image' && nextType === 'image' && prevRef === nextRef) {
+                    return true;
+                }
                 unmount(currentComponent);
                 currentComponent = mountView();
                 return true;

package/dist/lib/components/admin/fields/richtext/svelte-node-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"svelte-node-view.js","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/svelte-node-view.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,sBAAsB,MAAM,iCAAiC,CAAC;AACrE,OAAO,qBAAqB,MAAM,gCAAgC,CAAC;AAEnE,MAAM,UAAU,sBAAsB,CACrC,MAAuF,EACvF,QAA+B;IAE/B,OAAO,CAAC,KAA4B,EAAuB,EAAE;QAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,YAAY,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,YAAY,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC;QAElC,IAAI,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAEjC,SAAS,gBAAgB;YACxB,OAAO,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACrF,CAAC;QAED,SAAS,SAAS;YACjB,OAAO,KAAK,CAAC,gBAAgB,EAAE,EAAE;gBAChC,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE;oBACN,IAAI,EAAE,SAAS,CAAC,KAAK;oBACrB,OAAO,EAAE,SAAS,CAAC,IAAI;oBACvB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,GAAG,EAAE;wBACZ,MAAM,CAAC;4BACN,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,IAAI,EAAE,SAAS,CAAC,IAAI;yBACpB,CAAC,CAAC;oBACJ,CAAC;oBACD,QAAQ,EAAE,GAAG,EAAE;wBACd,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBAC1B,CAAC;iBACD;aACD,CAAC,CAAC;QACJ,CAAC;QAED,IAAI,gBAAgB,GAAG,SAAS,EAAE,CAAC;QAEnC,OAAO;YACN,GAAG,EAAE,OAAO;YACZ,MAAM,CAAC,IAAI;gBACV,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,oBAAoB;oBAAE,OAAO,KAAK,CAAC;gBAC1D,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;gBACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBAC1B,gBAAgB,GAAG,SAAS,EAAE,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACb,CAAC;YACD,UAAU;gBACT,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACnD,CAAC;YACD,YAAY;gBACX,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;YACtD,CAAC;YACD,OAAO;gBACN,OAAO,CAAC,gBAAgB,CAAC,CAAC;YAC3B,CAAC;YACD,SAAS;gBACR,OAAO,IAAI,CAAC;YACb,CAAC;YACD,cAAc;gBACb,OAAO,IAAI,CAAC;YACb,CAAC;SACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"svelte-node-view.js","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/svelte-node-view.ts"],"names":[],"mappings":"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"}

package/dist/lib/preview/assets.d.ts

@@ -0,0 +1,19 @@
+/** A resolved asset's renderable data. */
+export interface ResolvedAsset {
+    url: string;
+    alt?: string;
+}
+/**
+ * Collect every asset `_ref` reachable in a value. Image and file fields, and
+ * portable-text image blocks, all carry `{ asset: { _ref } }`, so one generic walk
+ * covers them — callers never enumerate field paths by hand.
+ */
+export declare function collectAssetRefs(value: unknown, acc?: Set<string>): Set<string>;
+/**
+ * Inject resolved `{ url, alt }` onto every `{ asset: { _ref } }` in a value, in place.
+ * After this, `image.asset.url` / `image.asset.alt` are populated so the frontend reads
+ * them directly. Mutates the value — pass a clone (e.g. `$state.snapshot`) if the input
+ * must be preserved. Refs absent from `resolved` are left untouched.
+ */
+export declare function injectAssetData(value: unknown, resolved: ReadonlyMap<string, ResolvedAsset>): void;
+//# sourceMappingURL=assets.d.ts.map

package/dist/lib/preview/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/lib/preview/assets.ts"],"names":[],"mappings":"AAYA,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAW1F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAC1C,IAAI,CAgBN"}

package/dist/lib/preview/assets.js

@@ -0,0 +1,60 @@
+// Asset URL injection — the single source of truth for "make a document's images
+// renderable". Aphex asset URLs aren't derivable from the `_ref` alone, so before a
+// document can be rendered (server-side on a public route, or client-side in the live
+// preview) each `{ asset: { _ref } }` has to be resolved to its URL/alt and have those
+// woven back into the document.
+//
+// This module owns the *walk* (collect refs / inject results). The *resolution* of a
+// ref → { url, alt } differs by environment — the server uses `AssetService`, the editor
+// uses the assets API client — so it's supplied by the caller. Keeping the walk in one
+// place means SSR and live preview produce documents of the exact same shape:
+// `image.asset.url` is always populated, and the frontend never needs a side-channel map.
+/**
+ * Collect every asset `_ref` reachable in a value. Image and file fields, and
+ * portable-text image blocks, all carry `{ asset: { _ref } }`, so one generic walk
+ * covers them — callers never enumerate field paths by hand.
+ */
+export function collectAssetRefs(value, acc = new Set()) {
+    if (!value || typeof value !== 'object')
+        return acc;
+    if (Array.isArray(value)) {
+        for (const v of value)
+            collectAssetRefs(v, acc);
+        return acc;
+    }
+    const obj = value;
+    const ref = obj.asset?._ref;
+    if (typeof ref === 'string')
+        acc.add(ref);
+    for (const key in obj)
+        collectAssetRefs(obj[key], acc);
+    return acc;
+}
+/**
+ * Inject resolved `{ url, alt }` onto every `{ asset: { _ref } }` in a value, in place.
+ * After this, `image.asset.url` / `image.asset.alt` are populated so the frontend reads
+ * them directly. Mutates the value — pass a clone (e.g. `$state.snapshot`) if the input
+ * must be preserved. Refs absent from `resolved` are left untouched.
+ */
+export function injectAssetData(value, resolved) {
+    if (!value || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        for (const v of value)
+            injectAssetData(v, resolved);
+        return;
+    }
+    const obj = value;
+    const asset = obj.asset;
+    if (asset && typeof asset === 'object' && typeof asset._ref === 'string') {
+        const hit = resolved.get(asset._ref);
+        if (hit) {
+            asset.url = hit.url;
+            if (hit.alt != null)
+                asset.alt = hit.alt;
+        }
+    }
+    for (const key in obj)
+        injectAssetData(obj[key], resolved);
+}
+//# sourceMappingURL=assets.js.map

package/dist/lib/preview/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/lib/preview/assets.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oFAAoF;AACpF,sFAAsF;AACtF,uFAAuF;AACvF,gCAAgC;AAChC,EAAE;AACF,qFAAqF;AACrF,yFAAyF;AACzF,uFAAuF;AACvF,8EAA8E;AAC9E,0FAA0F;AAQ1F;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,MAAmB,IAAI,GAAG,EAAE;IAC5E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,gBAAgB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,GAAG,GAAI,GAAG,CAAC,KAAwC,EAAE,IAAI,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,GAAG;QAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,KAAc,EACd,QAA4C;IAE5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,eAAe,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO;IACR,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAmE,CAAC;IACtF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACT,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;YACpB,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI;gBAAE,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QAC1C,CAAC;IACF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,GAAG;QAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC"}

package/dist/lib/preview/perspective.d.ts

@@ -0,0 +1,20 @@
+import type { Auth } from '../types/auth.js';
+export type PreviewPerspective = 'draft' | 'published';
+/**
+ * Resolve the content perspective for a SvelteKit load function.
+ *
+ * Returns `'draft'` only when the `?aphex-preview` query param is present
+ * AND the request carries a valid authenticated session — so unauthenticated
+ * visitors who manually append the param always get published content.
+ *
+ * @example
+ * // +page.server.ts
+ * import { getPreviewPerspective } from '@aphexcms/cms-core/server';
+ *
+ * export const load = async ({ locals, url }) => {
+ *   const perspective = getPreviewPerspective(locals.auth, url);
+ *   const post = await api.findOne({ perspective });
+ * };
+ */
+export declare function getPreviewPerspective(auth: Auth | undefined, url: URL): PreviewPerspective;
+//# sourceMappingURL=perspective.d.ts.map

package/dist/lib/preview/perspective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perspective.d.ts","sourceRoot":"","sources":["../../../src/lib/preview/perspective.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,WAAW,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAG1F"}

package/dist/lib/preview/perspective.js

@@ -0,0 +1,21 @@
+/**
+ * Resolve the content perspective for a SvelteKit load function.
+ *
+ * Returns `'draft'` only when the `?aphex-preview` query param is present
+ * AND the request carries a valid authenticated session — so unauthenticated
+ * visitors who manually append the param always get published content.
+ *
+ * @example
+ * // +page.server.ts
+ * import { getPreviewPerspective } from '@aphexcms/cms-core/server';
+ *
+ * export const load = async ({ locals, url }) => {
+ *   const perspective = getPreviewPerspective(locals.auth, url);
+ *   const post = await api.findOne({ perspective });
+ * };
+ */
+export function getPreviewPerspective(auth, url) {
+    const isAuthenticated = auth?.type === 'session';
+    return url.searchParams.has('aphex-preview') && isAuthenticated ? 'draft' : 'published';
+}
+//# sourceMappingURL=perspective.js.map

package/dist/lib/preview/perspective.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perspective.js","sourceRoot":"","sources":["../../../src/lib/preview/perspective.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAsB,EAAE,GAAQ;IACrE,MAAM,eAAe,GAAG,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC;IACjD,OAAO,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;AACzF,CAAC"}

package/dist/lib/preview/stega.d.ts

@@ -0,0 +1,25 @@
+import type { Field } from '../types/schemas.js';
+/**
+ * Remove all stega-encoded data from a string or deep JSON structure.
+ * Use in <svelte:head> (title, meta), alt text, aria-labels — anywhere the raw
+ * string is needed without invisible characters.
+ */
+export declare function stegaClean<T>(value: T): T;
+/** Decode the stega payload from a string. Returns null if not encoded. */
+export declare function stegaDecode(value: string): {
+    field: string;
+    blockIndex?: number;
+    blockKey?: string;
+    arrayIndex?: number;
+    objectPath?: string;
+} | null;
+/**
+ * Recursively encode all string-bearing fields in a document with their top-level
+ * field name. Handles: string/text/url, string arrays, object subfields, and
+ * portable text blocks (including custom block types like callout, codeBlock).
+ *
+ * Every nested string always encodes the *top-level* field name so that clicking
+ * in the preview navigates to the correct editor field.
+ */
+export declare function stegaEncodeDocument(data: Record<string, unknown>, fields: Field[]): Record<string, unknown>;
+//# sourceMappingURL=stega.d.ts.map

package/dist/lib/preview/stega.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stega.d.ts","sourceRoot":"","sources":["../../../src/lib/preview/stega.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzC;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAUP;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,KAAK,EAAE,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/dist/lib/preview/stega.js

@@ -0,0 +1,168 @@
+import { vercelStegaCombine, vercelStegaClean, vercelStegaDecode } from '@vercel/stega';
+/**
+ * Remove all stega-encoded data from a string or deep JSON structure.
+ * Use in <svelte:head> (title, meta), alt text, aria-labels — anywhere the raw
+ * string is needed without invisible characters.
+ */
+export function stegaClean(value) {
+    return vercelStegaClean(value);
+}
+/** Decode the stega payload from a string. Returns null if not encoded. */
+export function stegaDecode(value) {
+    return (vercelStegaDecode(value) ?? null);
+}
+/**
+ * Recursively encode all string-bearing fields in a document with their top-level
+ * field name. Handles: string/text/url, string arrays, object subfields, and
+ * portable text blocks (including custom block types like callout, codeBlock).
+ *
+ * Every nested string always encodes the *top-level* field name so that clicking
+ * in the preview navigates to the correct editor field.
+ */
+export function stegaEncodeDocument(data, fields) {
+    const result = { ...data };
+    for (const field of fields) {
+        const val = result[field.name];
+        if (val == null)
+            continue;
+        // objectPath is undefined at root — each field IS the top-level, no sub-path needed
+        result[field.name] = encodeFieldValue(val, field, field.name, undefined);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers — topLevel is always the document root field name so the
+// editor knows which field to scroll to; objectPath carries the dotted sub-path
+// so the editor can drill into nested inputs.
+// ---------------------------------------------------------------------------
+function encodeFieldValue(val, field, topLevel, objectPath) {
+    if (val == null)
+        return val;
+    const path = objectPath ? `${objectPath}.${field.name}` : field.name;
+    switch (field.type) {
+        case 'string':
+        case 'text':
+        case 'url':
+            if (typeof val === 'string' && val) {
+                const payload = { field: topLevel };
+                // Only include objectPath for nested fields (not the top-level field itself)
+                if (objectPath)
+                    payload.objectPath = path;
+                return vercelStegaCombine(val, payload);
+            }
+            return val;
+        case 'array':
+            if (!Array.isArray(val))
+                return val;
+            // Only forward objectPath when truly nested (inside an object); top-level
+            // arrays must NOT get an objectPath or the arrayIndex navigation branch is skipped.
+            return encodeArray(val, field.of, topLevel, objectPath ? path : undefined);
+        case 'object':
+            if (typeof val !== 'object' || !field.fields)
+                return val;
+            return encodeObject(val, field.fields, topLevel, path);
+        // image, file, reference, slug, number, boolean, date, datetime — not text, skip.
+        // Image click-to-edit is handled at render time (the frontend stega-encodes the
+        // *effective* alt — override or asset default — so every image is clickable, not
+        // just ones with a per-placement override).
+        default:
+            return val;
+    }
+}
+function encodeArray(items, of, topLevel, objectPath) {
+    const hasBlock = of.some((t) => t.type === 'block');
+    const firstType = of[0]?.type;
+    if (hasBlock) {
+        // Portable text — encode spans within blocks and string fields in custom block types
+        return encodePortableText(items, of, topLevel);
+    }
+    if (firstType === 'string' || firstType === 'text') {
+        // Primitive string array (e.g. tags) — include the item's array index
+        return items.map((item, arrayIndex) => {
+            if (typeof item !== 'string' || !item)
+                return item;
+            const payload = { field: topLevel, arrayIndex };
+            if (objectPath)
+                payload.objectPath = objectPath;
+            return vercelStegaCombine(item, payload);
+        });
+    }
+    // Array of inline objects — encode each item's string fields
+    if (of[0]?.fields) {
+        return items.map((item, arrayIndex) => {
+            if (!item || typeof item !== 'object')
+                return item;
+            const obj = item;
+            const typeRef = of.find((t) => t.name === obj._type || t.type === obj._type) ?? of[0];
+            if (!typeRef?.fields)
+                return item;
+            const itemPath = objectPath ? `${objectPath}[${arrayIndex}]` : `[${arrayIndex}]`;
+            return encodeObject(obj, typeRef.fields, topLevel, itemPath);
+        });
+    }
+    return items;
+}
+function encodeObject(obj, fields, topLevel, objectPath) {
+    const result = { ...obj };
+    for (const field of fields) {
+        const val = result[field.name];
+        if (val == null)
+            continue;
+        result[field.name] = encodeFieldValue(val, field, topLevel, objectPath);
+    }
+    return result;
+}
+/** Encode portable text: spans in standard blocks + string fields in custom block types. */
+function encodePortableText(blocks, of, topLevel) {
+    return blocks.map((block, blockIndex) => {
+        if (!block || typeof block !== 'object')
+            return block;
+        const b = block;
+        if (b._type === 'block' && Array.isArray(b.children)) {
+            // Standard text block — encode each span's text with its block index so the
+            // editor can position the cursor at the exact block when clicked.
+            return {
+                ...b,
+                children: b.children.map((child) => {
+                    if (!child || typeof child !== 'object')
+                        return child;
+                    const span = child;
+                    if (span._type === 'span' && typeof span.text === 'string' && span.text) {
+                        return {
+                            ...span,
+                            text: vercelStegaCombine(span.text, { field: topLevel, blockIndex })
+                        };
+                    }
+                    return child;
+                })
+            };
+        }
+        // Built-in image block — click-to-edit is stamped at render time (the frontend
+        // stega-encodes the effective alt with this block's _key), so no encoding here.
+        if (b._type === 'image')
+            return block;
+        // Custom block type (callout, codeBlock, etc.) — encode string fields, carrying
+        // blockIndex so clicking them opens the block's edit modal in the editor.
+        const typeRef = of.find((t) => t.name === b._type || t.type === b._type);
+        if (typeRef?.fields) {
+            return encodeCustomBlock(b, typeRef.fields, topLevel, blockIndex);
+        }
+        return block;
+    });
+}
+/** Encode string fields of a custom block with { field, blockIndex, blockKey } so the editor can open the modal. */
+function encodeCustomBlock(obj, fields, topLevel, blockIndex) {
+    const result = { ...obj };
+    const blockKey = typeof obj._key === 'string' ? obj._key : undefined;
+    for (const field of fields) {
+        const val = result[field.name];
+        if (!val)
+            continue;
+        if ((field.type === 'string' || field.type === 'text' || field.type === 'url') &&
+            typeof val === 'string') {
+            result[field.name] = vercelStegaCombine(val, { field: topLevel, blockIndex, blockKey });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=stega.js.map

package/dist/lib/preview/stega.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stega.js","sourceRoot":"","sources":["../../../src/lib/preview/stega.ts"],"names":[],"mappings":"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"}

package/dist/lib/richtext-context.svelte.d.ts

@@ -0,0 +1,18 @@
+import type { Editor } from '@tiptap/core';
+/**
+ * A registered richtext editor plus the imperative hooks DocumentEditor needs for
+ * click-to-edit — e.g. opening the link popover after dropping the caret in a link,
+ * rather than relying on the editor's transaction heuristic to notice the selection move.
+ */
+export interface RichtextEditorHandle {
+    editor: Editor;
+    /** Open the link action popover for the link at the current selection. */
+    openLinkPopover: () => void;
+}
+type EditorRegistry = Map<string, RichtextEditorHandle>;
+/** Call once in DocumentEditor to create the registry. */
+export declare function setRichtextEditorRegistry(): EditorRegistry;
+/** Call in RichtextField to register/unregister the editor handle. */
+export declare function getRichtextEditorRegistry(): EditorRegistry | null;
+export {};
+//# sourceMappingURL=richtext-context.svelte.d.ts.map

package/dist/lib/richtext-context.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext-context.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/richtext-context.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,eAAe,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAExD,0DAA0D;AAC1D,wBAAgB,yBAAyB,IAAI,cAAc,CAI1D;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,IAAI,cAAc,GAAG,IAAI,CAEjE"}

package/dist/lib/richtext-context.svelte.js

@@ -0,0 +1,13 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('aphex:richtext-editors');
+/** Call once in DocumentEditor to create the registry. */
+export function setRichtextEditorRegistry() {
+    const registry = new Map();
+    setContext(KEY, registry);
+    return registry;
+}
+/** Call in RichtextField to register/unregister the editor handle. */
+export function getRichtextEditorRegistry() {
+    return getContext(KEY) ?? null;
+}
+//# sourceMappingURL=richtext-context.svelte.js.map

package/dist/lib/richtext-context.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext-context.svelte.js","sourceRoot":"","sources":["../../src/lib/richtext-context.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGhD,MAAM,GAAG,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAe7C,0DAA0D;AAC1D,MAAM,UAAU,yBAAyB;IACxC,MAAM,QAAQ,GAAmB,IAAI,GAAG,EAAE,CAAC;IAC3C,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,yBAAyB;IACxC,OAAO,UAAU,CAAiB,GAAG,CAAC,IAAI,IAAI,CAAC;AAChD,CAAC"}

package/dist/lib/server/index.d.ts

@@ -18,6 +18,7 @@ export { GET as serveAssetCDN } from '../routes/assets-cdn.js';
 export { createAphexApi, mountAphexBuiltins, toHonoHandler, type AphexEnv } from './api/index.js';
 export * from '../schema-utils/index.js';
 export { createHashForPublishing } from '../utils/content-hash.js';
+export { getPreviewPerspective, type PreviewPerspective } from '../preview/perspective.js';
 export { createGraphQLHandler, type GraphQLConfig, type GraphQLSettings, type GraphQLHandlerResult } from '../graphql/index.js';
 export { LocalAPI, createLocalAPI, getLocalAPI, CollectionAPI, SingletonOperationError, PermissionChecker, PermissionError, type Collections, type SingletonCollection, type LocalAPIContext, type CreateOptions, type UpdateOptions } from '../local-api/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxF,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG/F,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EACN,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/server/index.ts"],"names":[],"mappings":"AAIA,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxF,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG/F,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGxF,OAAO,EACN,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,oBAAoB,CAAC"}

package/dist/lib/server/index.js

@@ -36,6 +36,8 @@ export { createAphexApi, mountAphexBuiltins, toHonoHandler } from './api/index.j
 export * from '../schema-utils/index.js';
 // Content hash utilities (server-side)
 export { createHashForPublishing } from '../utils/content-hash.js';
+// Preview utilities
+export { getPreviewPerspective } from '../preview/perspective.js';
 // GraphQL (built-in, enabled by default)
 export { createGraphQLHandler } from '../graphql/index.js';
 // Local API (unified operations layer)

package/dist/lib/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/server/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,+DAA+D;AAE/D,sDAAsD;AACtD,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAE/B,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAEpE,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAEpE,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAqB,MAAM,UAAU,CAAC;AAExF,qFAAqF;AACrF,cAAc,wBAAwB,CAAC;AAEvC,kCAAkC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAE7C,iDAAiD;AACjD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,4EAA4E;AAC5E,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5D,0EAA0E;AAC1E,gDAAgD;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAE/F,mBAAmB;AACnB,cAAc,uBAAuB,CAAC;AAEtC,uCAAuC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,yCAAyC;AACzC,OAAO,EACN,oBAAoB,EAIpB,MAAM,kBAAkB,CAAC;AAE1B,uCAAuC;AACvC,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EAMf,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/server/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,+DAA+D;AAE/D,sDAAsD;AACtD,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,gBAAgB,CAAC;AAE/B,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAsB,MAAM,qBAAqB,CAAC;AAEpE,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAEpE,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,6CAA6C;AAC7C,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAqB,MAAM,UAAU,CAAC;AAExF,qFAAqF;AACrF,cAAc,wBAAwB,CAAC;AAEvC,kCAAkC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAE7C,iDAAiD;AACjD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,4EAA4E;AAC5E,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EAAE,GAAG,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE5D,0EAA0E;AAC1E,gDAAgD;AAChD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAE/F,mBAAmB;AACnB,cAAc,uBAAuB,CAAC;AAEtC,uCAAuC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAA2B,MAAM,wBAAwB,CAAC;AAExF,yCAAyC;AACzC,OAAO,EACN,oBAAoB,EAIpB,MAAM,kBAAkB,CAAC;AAE1B,uCAAuC;AACvC,OAAO,EACN,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EAMf,MAAM,oBAAoB,CAAC"}

package/dist/lib/services/asset-service.d.ts

@@ -40,6 +40,18 @@ export declare class AssetService {
      * Find asset by ID
      */
     findAssetById(organizationId: string, id: string): Promise<Asset | null>;
+    /**
+     * Hydrate one or more documents in place so their images are renderable: every
+     * `{ asset: { _ref } }` reachable in the docs gets its `url` (and default `alt`)
+     * injected. This is what a public route's `load` calls before returning a document —
+     * the frontend then reads `image.asset.url` directly, with no side-channel map. The
+     * live editor preview performs the identical injection client-side, so SSR and preview
+     * documents share one shape.
+     *
+     * Mutates the passed documents (they're request-scoped query results). Refs are
+     * resolved once and de-duped across all docs in a single batch.
+     */
+    injectAssetUrls(organizationId: string, ...docs: unknown[]): Promise<void>;
     /**
      * Find asset by ID globally (bypasses organization filter for public asset access)
      * Only available on PostgreSQL adapter with RLS bypass

package/dist/lib/services/asset-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/asset-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,CAAC;CACF;AAED,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe;IAGlC;;OAEG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAsFhF;;OAEG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI9E;;;OAGG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAmB5D;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItF;;;;;OAKG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BvE;;OAEG;IACG,mBAAmB,CACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,GACC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIxB;;OAEG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;IAeF;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAChC,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;KAClB,CAAC;CAWF"}
+{"version":3,"file":"asset-service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/asset-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,CAAC;CACF;AAED,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe;IAGlC;;OAEG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAsFhF;;OAEG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAI9E;;;;;;;;;;OAUG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhF;;;OAGG;IACG,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAmB5D;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAItF;;;;;OAKG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BvE;;OAEG;IACG,mBAAmB,CACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB,GACC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAIxB;;OAEG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;IAeF;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAChC,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;KAClB,CAAC;CAWF"}

package/dist/lib/services/asset-service.js

@@ -1,6 +1,7 @@
 // Asset service - orchestrates storage and database operations
 import sharp from 'sharp';
 import { cmsLogger } from '../utils/logger.js';
+import { collectAssetRefs, injectAssetData } from '../preview/assets.js';
 /**
  * Asset service - coordinates storage and database operations
  * Maintains separation of concerns while providing unified asset management
@@ -99,6 +100,37 @@ export class AssetService {
     async findAssetById(organizationId, id) {
         return await this.database.findAssetById(organizationId, id);
     }
+    /**
+     * Hydrate one or more documents in place so their images are renderable: every
+     * `{ asset: { _ref } }` reachable in the docs gets its `url` (and default `alt`)
+     * injected. This is what a public route's `load` calls before returning a document —
+     * the frontend then reads `image.asset.url` directly, with no side-channel map. The
+     * live editor preview performs the identical injection client-side, so SSR and preview
+     * documents share one shape.
+     *
+     * Mutates the passed documents (they're request-scoped query results). Refs are
+     * resolved once and de-duped across all docs in a single batch.
+     */
+    async injectAssetUrls(organizationId, ...docs) {
+        const refs = new Set();
+        for (const doc of docs)
+            collectAssetRefs(doc, refs);
+        if (refs.size === 0)
+            return;
+        const resolved = new Map();
+        await Promise.all([...refs].map(async (ref) => {
+            try {
+                const asset = await this.findAssetById(organizationId, ref);
+                if (asset?.url)
+                    resolved.set(ref, { url: asset.url, alt: asset.alt ?? undefined });
+            }
+            catch {
+                // Missing/erroring asset — leave it unresolved; the image simply won't render.
+            }
+        }));
+        for (const doc of docs)
+            injectAssetData(doc, resolved);
+    }
     /**
      * Find asset by ID globally (bypasses organization filter for public asset access)
      * Only available on PostgreSQL adapter with RLS bypass

package/dist/lib/services/asset-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-service.js","sourceRoot":"","sources":["../../../src/lib/services/asset-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"asset-service.js","sourceRoot":"","sources":["../../../src/lib/services/asset-service.ts"],"names":[],"mappings":"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"}

package/dist/lib/types/asset.d.ts

@@ -50,6 +50,15 @@ export interface NewAsset {
 export interface ImageAsset {
     _type: 'reference';
     _ref: string;
+    /**
+     * Resolved public URL. NOT part of stored data — it's injected at render time
+     * (by `AssetService.injectAssetUrls` server-side, and by the editor's live preview
+     * client-side) so the frontend can read `image.asset.url` directly. Absent until then.
+     */
+    url?: string;
+    /** The asset's default alt text, injected alongside `url`. Per-placement overrides live
+     *  on `ImageValue.alt`; render precedence is `value.alt || asset.alt`. */
+    alt?: string;
 }
 export interface ImageCrop {
     top: number;
@@ -68,6 +77,12 @@ export interface ImageValue {
     asset: ImageAsset;
     crop?: ImageCrop;
     hotspot?: ImageHotspot;
+    /**
+     * Per-placement alt text — the single source of truth for this image's
+     * description. Edited on the image field (not the asset), and the string that
+     * carries visual-editing stega so the rendered <img alt> becomes click-to-edit.
+     */
+    alt?: string;
     [key: string]: any;
 }
 export interface FileAsset {