@caretcms/core 0.1.0

package/dist/runtime/mutations/engine.js

@@ -0,0 +1,255 @@
+import { setNestedValue } from "../utils.js";
+import { parseMutationCommand, isRecord, } from "./contracts.js";
+/**
+ * Per-key chained-promise serializer. Used so an entire
+ * `getRevision → writeEntry → bumpRevision` sequence runs atomically
+ * for a given entry — without this, two concurrent writes against the
+ * same `expectedRevision` can both pass the conflict check and silently
+ * overwrite each other.
+ */
+const mutationLocks = new Map();
+function withLock(key, task) {
+    const previous = mutationLocks.get(key) ?? Promise.resolve();
+    const next = previous.then(task, task);
+    mutationLocks.set(key, next.finally(() => {
+        if (mutationLocks.get(key) === next) {
+            mutationLocks.delete(key);
+        }
+    }));
+    return next;
+}
+/**
+ * Acquire multiple keys' locks before running task. Keys are deduped + sorted
+ * so two callers asking for overlapping sets always queue in the same order,
+ * avoiding AB-BA deadlocks. Used by multi-entry mutations (reorder) so they
+ * compose with single-entry mutations on the same entries.
+ */
+function withLocks(keys, task) {
+    const sorted = [...new Set(keys)].sort();
+    const acquire = (idx) => {
+        if (idx === sorted.length)
+            return task();
+        return withLock(sorted[idx], () => acquire(idx + 1));
+    };
+    return acquire(0);
+}
+const entryKey = (collection, id) => `entry::${collection}::${id}`;
+const collectionKey = (collection) => `collection::${collection}`;
+function fail(status, error, extra) {
+    return {
+        ok: false,
+        status,
+        body: {
+            error,
+            ...extra,
+        },
+    };
+}
+async function ensureExpectedRevisionMatches(adapter, collection, id, expectedRevision) {
+    const currentRevision = await adapter.getRevision(collection, id);
+    if (expectedRevision !== undefined && expectedRevision !== currentRevision) {
+        return {
+            ok: false,
+            result: fail(409, "Revision conflict", { currentRevision }),
+        };
+    }
+    return { ok: true, currentRevision };
+}
+async function applySaveField(adapter, command) {
+    const { collection, id, field, value, expectedRevision } = command;
+    return withLock(entryKey(collection, id), async () => {
+        const revision = await ensureExpectedRevisionMatches(adapter, collection, id, expectedRevision);
+        if (!revision.ok)
+            return revision.result;
+        const before = (await adapter.getEntry(collection, id))?.data ?? {};
+        const current = { ...before };
+        await adapter.appendHistory(collection, id, {
+            ts: Date.now(),
+            action: "save",
+            data: before,
+        });
+        try {
+            setNestedValue(current, field, value);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Set failed";
+            return fail(400, message);
+        }
+        await adapter.writeEntry(collection, id, current);
+        const nextRevision = await adapter.bumpRevision(collection, id);
+        return { ok: true, body: { ok: true, revision: nextRevision } };
+    });
+}
+async function applyPutEntry(adapter, command) {
+    const { collection, id, data, expectedRevision } = command;
+    return withLock(entryKey(collection, id), async () => {
+        const revision = await ensureExpectedRevisionMatches(adapter, collection, id, expectedRevision);
+        if (!revision.ok)
+            return revision.result;
+        const before = (await adapter.getEntry(collection, id))?.data ?? null;
+        if (before !== null) {
+            await adapter.appendHistory(collection, id, {
+                ts: Date.now(),
+                action: "put",
+                data: before,
+            });
+        }
+        await adapter.writeEntry(collection, id, data);
+        const nextRevision = await adapter.bumpRevision(collection, id);
+        return { ok: true, body: { ok: true, revision: nextRevision } };
+    });
+}
+async function applyDeleteEntry(adapter, command) {
+    const { collection, id, expectedRevision } = command;
+    return withLock(entryKey(collection, id), async () => {
+        const revision = await ensureExpectedRevisionMatches(adapter, collection, id, expectedRevision);
+        if (!revision.ok)
+            return revision.result;
+        const before = (await adapter.getEntry(collection, id))?.data ?? null;
+        if (before !== null) {
+            await adapter.appendHistory(collection, id, {
+                ts: Date.now(),
+                action: "delete",
+                data: before,
+            });
+        }
+        await adapter.deleteEntry(collection, id);
+        const nextRevision = await adapter.bumpRevision(collection, id);
+        return { ok: true, body: { ok: true, revision: nextRevision } };
+    });
+}
+async function applyReorderEntries(adapter, command) {
+    const { collection, items } = command;
+    // Hold the per-entry locks for every participating entry, plus a
+    // collection-level lock that serializes reorder against itself. Without the
+    // per-entry locks, a concurrent save_field on one of these entries can
+    // interleave a revision bump between two of ours and tear the revision map.
+    const keys = [collectionKey(collection), ...items.map((item) => entryKey(collection, item.id))];
+    return withLocks(keys, async () => {
+        const currentById = new Map();
+        for (const item of items) {
+            const entry = await adapter.getEntry(collection, item.id);
+            if (!entry)
+                return fail(404, "Entry not found", { conflictId: item.id });
+            const revision = await adapter.getRevision(collection, item.id);
+            if (item.expectedRevision !== undefined && item.expectedRevision !== revision) {
+                return fail(409, "Revision conflict", {
+                    conflictId: item.id,
+                    currentRevision: revision,
+                });
+            }
+            currentById.set(item.id, { data: entry.data, revision });
+        }
+        const revisions = {};
+        for (const item of items) {
+            const current = currentById.get(item.id);
+            if (!current)
+                return fail(500, "Failed to load reorder item");
+            await adapter.appendHistory(collection, item.id, {
+                ts: Date.now(),
+                action: "reorder",
+                data: current.data,
+            });
+            const nextData = { ...current.data, order: item.order };
+            await adapter.writeEntry(collection, item.id, nextData);
+            revisions[item.id] = await adapter.bumpRevision(collection, item.id);
+        }
+        return { ok: true, body: { ok: true, revisions } };
+    });
+}
+async function applyUpdatePageLayout(adapter, command) {
+    const { collection, id, sections, expectedRevision } = command;
+    return withLock(entryKey(collection, id), async () => {
+        const revision = await ensureExpectedRevisionMatches(adapter, collection, id, expectedRevision);
+        if (!revision.ok)
+            return revision.result;
+        const current = (await adapter.getEntry(collection, id))?.data ?? {};
+        await adapter.appendHistory(collection, id, {
+            ts: Date.now(),
+            action: "put",
+            data: current,
+        });
+        const layout = current.layout && isRecord(current.layout)
+            ? { ...current.layout }
+            : {};
+        layout.sections = sections.map((section) => ({
+            id: section.id,
+            key: section.key,
+            enabled: section.enabled,
+            spacing_y: section.spacing_y,
+        }));
+        current.layout = layout;
+        await adapter.writeEntry(collection, id, current);
+        const nextRevision = await adapter.bumpRevision(collection, id);
+        return { ok: true, body: { ok: true, revision: nextRevision } };
+    });
+}
+async function applyCreateCollection(adapter, command) {
+    const { id, label, description, icon, creatable, orderable, schema } = command;
+    // Check if collection already exists
+    const exists = await adapter.isKnownCollection(id);
+    if (exists) {
+        return fail(409, `Collection "${id}" already exists`);
+    }
+    const metadata = {
+        id,
+        label,
+        description,
+        icon,
+        creatable: creatable ?? true,
+        orderable: orderable ?? false,
+        schema,
+        created_at: Date.now(),
+        updated_at: Date.now(),
+    };
+    try {
+        await adapter.createCollection(metadata);
+        return { ok: true, body: { ok: true } };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to create collection";
+        return fail(500, message);
+    }
+}
+async function applyDeleteCollection(adapter, command) {
+    const { id } = command;
+    // Check if collection exists
+    const exists = await adapter.isKnownCollection(id);
+    if (!exists) {
+        return fail(404, `Collection "${id}" not found`);
+    }
+    try {
+        await adapter.deleteCollection(id);
+        return { ok: true, body: { ok: true } };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to delete collection";
+        return fail(500, message);
+    }
+}
+export async function executeMutation(adapter, input) {
+    const parsed = await parseMutationCommand(adapter, input);
+    if (!parsed.ok) {
+        return fail(400, "Invalid mutation command", { issues: parsed.issues });
+    }
+    const command = parsed.command;
+    switch (command.type) {
+        case "save_field":
+            return applySaveField(adapter, command);
+        case "put_entry":
+            return applyPutEntry(adapter, command);
+        case "delete_entry":
+            return applyDeleteEntry(adapter, command);
+        case "reorder_entries":
+            return applyReorderEntries(adapter, command);
+        case "update_page_layout":
+            return applyUpdatePageLayout(adapter, command);
+        case "create_collection":
+            return applyCreateCollection(adapter, command);
+        case "delete_collection":
+            return applyDeleteCollection(adapter, command);
+        default:
+            return fail(400, "Unsupported mutation type");
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/runtime/mutations/engine.js.map

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

package/dist/runtime/providers.d.ts

@@ -0,0 +1,9 @@
+import type { StorageAdapter, UploadHandler } from "../types.js";
+type RuntimeServices = {
+    adapter: StorageAdapter;
+    uploadHandler: UploadHandler;
+};
+export declare function getRuntimeServices(): Promise<RuntimeServices>;
+export declare function __setRuntimeServicesForTests(services: Partial<RuntimeServices> | null): void;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/runtime/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/runtime/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjE,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAoCF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAiBnE;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,GACxC,IAAI,CAGN"}

package/dist/runtime/providers.js

@@ -0,0 +1,44 @@
+import * as runtimeProviders from "virtual:caretcms/providers";
+let runtimeServicesPromise = null;
+let testServicesOverride = null;
+const providerModule = runtimeProviders;
+async function createAdapter() {
+    if (testServicesOverride?.adapter) {
+        return testServicesOverride.adapter;
+    }
+    const configuredAdapter = await providerModule?.loadConfiguredStorage?.();
+    if (configuredAdapter) {
+        return configuredAdapter;
+    }
+    throw new Error("[caretcms] No storage provider was configured for the active runtime mode.");
+}
+async function createUploadHandler() {
+    if (testServicesOverride?.uploadHandler) {
+        return testServicesOverride.uploadHandler;
+    }
+    const configuredUploadHandler = await providerModule?.loadConfiguredUploadHandler?.();
+    if (configuredUploadHandler) {
+        return configuredUploadHandler;
+    }
+    throw new Error("[caretcms] No upload provider was configured for the active runtime mode.");
+}
+export async function getRuntimeServices() {
+    if (!runtimeServicesPromise) {
+        const inflight = Promise.all([createAdapter(), createUploadHandler()]).then(([adapter, uploadHandler]) => ({
+            adapter,
+            uploadHandler,
+        }));
+        inflight.catch(() => {
+            if (runtimeServicesPromise === inflight) {
+                runtimeServicesPromise = null;
+            }
+        });
+        runtimeServicesPromise = inflight;
+    }
+    return runtimeServicesPromise;
+}
+export function __setRuntimeServicesForTests(services) {
+    testServicesOverride = services;
+    runtimeServicesPromise = null;
+}
+//# sourceMappingURL=providers.js.map

package/dist/runtime/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/runtime/providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAY/D,IAAI,sBAAsB,GAAoC,IAAI,CAAC;AACnE,IAAI,oBAAoB,GAAoC,IAAI,CAAC;AACjE,MAAM,cAAc,GAAG,gBAAkC,CAAC;AAE1D,KAAK,UAAU,aAAa;IAC1B,IAAI,oBAAoB,EAAE,OAAO,EAAE,CAAC;QAClC,OAAO,oBAAoB,CAAC,OAAO,CAAC;IACtC,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAM,cAAc,EAAE,qBAAqB,EAAE,EAAE,CAAC;IAC1E,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,IAAI,oBAAoB,EAAE,aAAa,EAAE,CAAC;QACxC,OAAO,oBAAoB,CAAC,aAAa,CAAC;IAC5C,CAAC;IAED,MAAM,uBAAuB,GAAG,MAAM,cAAc,EAAE,2BAA2B,EAAE,EAAE,CAAC;IACtF,IAAI,uBAAuB,EAAE,CAAC;QAC5B,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,OAAO;YACP,aAAa;SACd,CAAC,CACH,CAAC;QACF,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE;YAClB,IAAI,sBAAsB,KAAK,QAAQ,EAAE,CAAC;gBACxC,sBAAsB,GAAG,IAAI,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,sBAAsB,GAAG,QAAQ,CAAC;IACpC,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAyC;IAEzC,oBAAoB,GAAG,QAAQ,CAAC;IAChC,sBAAsB,GAAG,IAAI,CAAC;AAChC,CAAC"}

package/dist/runtime/request-context.d.ts

@@ -0,0 +1,11 @@
+import type { StorageAdapter, UploadHandler } from "../types.js";
+export interface CaretRequestContext {
+    adapter: StorageAdapter;
+    uploadHandler: UploadHandler;
+    sessionId: string | null;
+    demoMode: boolean;
+}
+export declare function runWithRequestContext<T>(context: CaretRequestContext, fn: () => Promise<T>): Promise<T>;
+export declare function getRequestContext(): CaretRequestContext | undefined;
+export declare function requireRequestContext(): CaretRequestContext;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/runtime/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/runtime/request-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,SAAS,CAEnE;AAED,wBAAgB,qBAAqB,IAAI,mBAAmB,CAQ3D"}

package/dist/runtime/request-context.js

@@ -0,0 +1,16 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const storage = new AsyncLocalStorage();
+export function runWithRequestContext(context, fn) {
+    return storage.run(context, fn);
+}
+export function getRequestContext() {
+    return storage.getStore();
+}
+export function requireRequestContext() {
+    const ctx = storage.getStore();
+    if (!ctx) {
+        throw new Error("[caretcms] No live request context found. Ensure the CMS middleware runs before page rendering (it registers with order: 'pre').");
+    }
+    return ctx;
+}
+//# sourceMappingURL=request-context.js.map

package/dist/runtime/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/runtime/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAuB,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CACnC,OAA4B,EAC5B,EAAoB;IAEpB,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,kIAAkI,CACnI,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/runtime/rewrite.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Response-rewriting engine for attribute-first CMS (ADR-005).
+ *
+ * Scans rendered HTML for data-caret and data-caret-scope attributes,
+ * batch-loads stored overrides from the StorageAdapter, and replaces
+ * element content (text) or src (images) with stored values.
+ *
+ * v1 scope: text-only leaf nodes + <img> src swaps.
+ * Elements with nested child markup are skipped (editor warns at runtime).
+ */
+import type { StorageAdapter } from "../types.js";
+export declare function rewriteCaretAttributes(html: string, adapter: StorageAdapter): Promise<string>;
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/runtime/rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../src/runtime/rewrite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,aAAa,CAAC;AAyL7D,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAyHjB"}

package/dist/runtime/rewrite.js

@@ -0,0 +1,253 @@
+/**
+ * Response-rewriting engine for attribute-first CMS (ADR-005).
+ *
+ * Scans rendered HTML for data-caret and data-caret-scope attributes,
+ * batch-loads stored overrides from the StorageAdapter, and replaces
+ * element content (text) or src (images) with stored values.
+ *
+ * v1 scope: text-only leaf nodes + <img> src swaps.
+ * Elements with nested child markup are skipped (editor warns at runtime).
+ */
+import { sanitizeHtml } from "./sanitize-html.js";
+// --- Patterns ---
+// Matches any element with data-caret attribute.
+// Captures: tag name, full opening tag, data-caret value, content between tags, closing tag
+//
+// Stateful (g flag) regexes are constructed per-call inside rewriteCaretAttributes
+// to avoid cross-request lastIndex contamination if the loop ever yields.
+// Text-content elements: always emitted with an explicit closing tag, so we
+// capture the inner content. <img> is handled separately by IMG_ELEMENT_PATTERN
+// because it is a void element with no closing tag and (in standard HTML5
+// output) no self-closing slash — it would never match this pattern.
+const CARET_ELEMENT_PATTERN = /<(h[1-6]|p|span|small|strong|em|a|li|td|th|label|button|figcaption|blockquote|dt|dd|summary|caption|legend)\b([^>]*?\bdata-caret\s*=\s*"([^"]*)"[^>]*?)(?:\/>|>([\s\S]*?)<\/\1>)/;
+// Void <img> with a data-caret binding. Closes on a bare `>` or a self-closing
+// `/>` — never on a closing tag. Captures: 1 = attribute string, 2 = data-caret value.
+const IMG_ELEMENT_PATTERN = /<img\b([^>]*?\bdata-caret\s*=\s*"([^"]*)"[^>]*?)\/?>/;
+const TAG_PATTERN = /<\/?([a-zA-Z][\w:-]*)\b[^>]*>/;
+const SCOPE_ATTR_RE = /\bdata-caret-scope\s*=\s*"([^"]+)"/i;
+const RICH_ATTR_RE = /\bdata-caret-rich\b/i;
+// Matches <img ... data-caret="..." ... src="..." ...> (self-closing or not)
+// We need to find and replace the src attribute within the img tag
+const IMG_SRC_RE = /\bsrc\s*=\s*"([^"]*)"/;
+const VOID_TAGS = new Set([
+    "area",
+    "base",
+    "br",
+    "col",
+    "embed",
+    "hr",
+    "img",
+    "input",
+    "link",
+    "meta",
+    "param",
+    "source",
+    "track",
+    "wbr",
+]);
+function parseScope(tagHtml) {
+    const match = SCOPE_ATTR_RE.exec(tagHtml);
+    if (!match)
+        return null;
+    const parts = match[1].split("::");
+    if (parts.length !== 2)
+        return null;
+    return { collection: parts[0], id: parts[1] };
+}
+function popFrame(stack, tagName) {
+    for (let i = stack.length - 1; i >= 0; i -= 1) {
+        if (stack[i].tagName === tagName) {
+            stack.splice(i, 1);
+            return;
+        }
+    }
+}
+function advanceScopeStack(html, untilIndex, state, tagRe) {
+    tagRe.lastIndex = state.cursor;
+    let match;
+    while ((match = tagRe.exec(html)) !== null) {
+        if (match.index >= untilIndex)
+            break;
+        const tagHtml = match[0];
+        const tagName = match[1].toLowerCase();
+        const isClosing = tagHtml.startsWith("</");
+        const isSelfClosing = !isClosing && (tagHtml.endsWith("/>") || VOID_TAGS.has(tagName));
+        if (isClosing) {
+            popFrame(state.stack, tagName);
+            state.cursor = tagRe.lastIndex;
+            continue;
+        }
+        if (!isSelfClosing) {
+            state.stack.push({
+                tagName,
+                scope: parseScope(tagHtml),
+            });
+        }
+        state.cursor = tagRe.lastIndex;
+    }
+}
+function findNearestScope(stack) {
+    for (let i = stack.length - 1; i >= 0; i -= 1) {
+        if (stack[i].scope)
+            return stack[i].scope;
+    }
+    return null;
+}
+function resolveBinding(caretValue, scope) {
+    const parts = caretValue.split("::");
+    if (parts.length === 3) {
+        return { collection: parts[0], id: parts[1], field: parts[2] };
+    }
+    if (parts.length === 1 && !caretValue.includes("::")) {
+        // Field-only — resolve from nearest scope
+        if (!scope)
+            return null;
+        return { collection: scope.collection, id: scope.id, field: caretValue };
+    }
+    return null;
+}
+// --- Content detection ---
+function hasChildMarkup(content) {
+    // If content contains any HTML tags, it has child markup
+    return /<[a-zA-Z]/.test(content);
+}
+// --- Entry cache ---
+async function batchLoadEntries(adapter, keys) {
+    const entries = new Map();
+    const promises = [...keys].map(async (key) => {
+        const [collection, id] = key.split("::");
+        const entry = await adapter.getEntry(collection, id);
+        if (entry)
+            entries.set(key, entry);
+    });
+    await Promise.all(promises);
+    return entries;
+}
+function getNestedValue(data, path) {
+    const keys = path.split(".");
+    let current = data;
+    for (const key of keys) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof current !== "object")
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === "string" ? current : undefined;
+}
+// --- Main rewrite ---
+export async function rewriteCaretAttributes(html, adapter) {
+    // 1. Find all data-caret bindings and collect unique entry keys
+    const bindings = [];
+    const entryKeys = new Set();
+    const addBinding = (caretValue, attrs, content, isImg, scope, fullMatch, index) => {
+        const resolved = resolveBinding(caretValue, scope);
+        if (!resolved)
+            return;
+        entryKeys.add(`${resolved.collection}::${resolved.id}`);
+        bindings.push({
+            ...resolved,
+            fullMatch,
+            contentStart: index,
+            contentEnd: index + fullMatch.length,
+            isImg,
+            isRich: !isImg && RICH_ATTR_RE.test(attrs),
+            hasChildMarkup: !isImg && hasChildMarkup(content),
+        });
+    };
+    // Each pass walks the document independently with its own scope stack, since
+    // void <img> and text elements are matched by separate patterns. Discovery
+    // order does not matter: replacements are applied in reverse index order below.
+    const discover = (pattern, onMatch) => {
+        const re = new RegExp(pattern.source, "gi");
+        const tagRe = new RegExp(TAG_PATTERN.source, "g");
+        const scopeState = { stack: [], cursor: 0 };
+        let match;
+        while ((match = re.exec(html)) !== null) {
+            advanceScopeStack(html, match.index, scopeState, tagRe);
+            onMatch(match, findNearestScope(scopeState.stack));
+        }
+    };
+    // Text-content elements: 1 = tag, 2 = attrs, 3 = data-caret value, 4 = content.
+    discover(CARET_ELEMENT_PATTERN, (match, scope) => {
+        addBinding(match[3], match[2], match[4] ?? "", false, scope, match[0], match.index);
+    });
+    // Void <img>: 1 = attrs, 2 = data-caret value (no content).
+    discover(IMG_ELEMENT_PATTERN, (match, scope) => {
+        addBinding(match[2], match[1], "", true, scope, match[0], match.index);
+    });
+    if (bindings.length === 0)
+        return html;
+    // 2. Batch-load entries
+    const entries = await batchLoadEntries(adapter, entryKeys);
+    if (entries.size === 0)
+        return html;
+    // 3. Apply replacements (reverse order to preserve indices)
+    let result = html;
+    const sorted = [...bindings].sort((a, b) => b.contentStart - a.contentStart);
+    for (const binding of sorted) {
+        // Skip elements with nested child markup (unless rich text, which expects HTML content)
+        if (binding.hasChildMarkup && !binding.isRich)
+            continue;
+        const entryKey = `${binding.collection}::${binding.id}`;
+        const entry = entries.get(entryKey);
+        if (!entry)
+            continue;
+        const storedValue = getNestedValue(entry.data, binding.field);
+        if (storedValue === undefined)
+            continue;
+        if (binding.isImg) {
+            // Replace src attribute value in the img tag
+            const imgTag = binding.fullMatch;
+            const srcMatch = IMG_SRC_RE.exec(imgTag);
+            if (srcMatch) {
+                // Function replacement (not a string) so `$`-sequences in the stored
+                // value — `$&`, `$1`, `` $` `` — are inserted literally instead of being
+                // interpreted as String.prototype.replace substitution patterns.
+                const newImgTag = imgTag.replace(srcMatch[0], () => `src="${escapeAttr(storedValue)}"`);
+                result =
+                    result.slice(0, binding.contentStart) +
+                        newImgTag +
+                        result.slice(binding.contentEnd);
+            }
+        }
+        else {
+            // Replace text content between tags
+            // Find the opening tag end and closing tag start within the full match
+            const openTagEnd = binding.fullMatch.indexOf(">") + 1;
+            const closeTagStart = binding.fullMatch.lastIndexOf("</");
+            // `>=` so an empty bound element (`<h1 data-caret="x"></h1>`) — a valid
+            // placeholder awaiting its first override — is filled too. When content
+            // is empty the two indices are equal and the slices still reconstruct
+            // `<tag …>` + value + `</tag>` correctly.
+            if (openTagEnd > 0 && closeTagStart >= openTagEnd) {
+                const before = binding.fullMatch.slice(0, openTagEnd);
+                const after = binding.fullMatch.slice(closeTagStart);
+                const injected = binding.isRich
+                    ? sanitizeHtml(storedValue)
+                    : escapeHtml(storedValue);
+                const newMatch = before + injected + after;
+                result =
+                    result.slice(0, binding.contentStart) +
+                        newMatch +
+                        result.slice(binding.contentEnd);
+            }
+        }
+    }
+    return result;
+}
+// --- Escaping ---
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function escapeAttr(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/"/g, "&quot;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=rewrite.js.map