@caretcms/caretize 0.1.0

package/dist/detect.js

@@ -0,0 +1,237 @@
+/**
+ * Detection: decide which tag nodes are edit candidates.
+ *
+ * The guiding rule — proven necessary by real-world fixtures — is that the
+ * candidate set must equal *what the CaretCMS rewrite engine can actually
+ * round-trip*. The engine only swaps the text content of a pure text-leaf
+ * element (no child markup, unless `data-caret-rich`) and the `src` of an
+ * `<img>`. So we tag exactly those and nothing else; anything we can't faithfully
+ * edit is skipped (with a reason) rather than tagged into an inert binding.
+ */
+import { isTagNode } from "./parse.js";
+// Content tags we'll tag, with their confidence tier. Anything not listed is
+// treated as non-content and skipped (whitelist, not blacklist).
+//
+// The key set MUST equal core's REWRITABLE_TEXT_TAGS (runtime/rewrite.ts):
+// the rewrite engine only injects stored values into those tags, so tagging
+// anything else mints a binding that saves through the editor but never
+// renders to visitors. Held in lockstep by tests/unit/contracts-parity.test.ts.
+export const CONFIDENCE = {
+    h1: "high", h2: "high", h3: "high", h4: "high", h5: "high", h6: "high",
+    p: "high", blockquote: "high",
+    li: "medium", a: "medium", button: "medium", figcaption: "medium",
+    summary: "medium", caption: "medium", dt: "medium", dd: "medium",
+    th: "medium", td: "medium", label: "medium", legend: "medium",
+    span: "low", strong: "low", em: "low", small: "low",
+};
+/** Can the rewrite engine swap this tag's text content? Gate for every tier
+ *  that emits a text binding (tag pass via CONFIDENCE, bind tiers directly). */
+export function isRewritableTextTag(tag) {
+    return tag.toLowerCase() in CONFIDENCE;
+}
+// Always requires the method call (`.map(`); also captures the immediate
+// receiver identifier when it's a plain variable (group 1), so callers can tell
+// whether the loop iterates a name a wrap tier already made editable. Receiver
+// is optional in the capture so chained/expression receivers (`foo().map(`)
+// still flag — they just carry no receiver to match against. Group 2 = method.
+const ITERATOR_RE = /(?:([A-Za-z_$][\w$]*)\s*)?\.\s*(map|filter|forEach|flatMap|reduce)\s*\(/;
+// Inline formatting tags the rich-text sanitizer keeps. MUST match
+// RICH_ALLOWED_TAGS in core's runtime/rich-allowlist.ts (and the hand-mirrored
+// static/cms/editor/sanitize.js) — anything outside this set is unwrapped on
+// save, so promoting it would not round-trip. Held in lockstep by
+// tests/unit/contracts-parity.test.ts.
+export const RICH_INLINE_TAGS = new Set([
+    "b", "strong", "i", "em", "u", "s", "a", "br", "sub", "sup",
+]);
+// Attributes the sanitizer keeps. Everything else (notably `class`) is stripped
+// on save unless blessed via the runtime `allowedClasses` option — which the
+// CLI can't see — so caretize stays conservative and treats any attribute here
+// other than these as lossy. MUST match core's RICH_ALLOWED_ATTRS/SAFE_HREF_RE
+// (same parity test).
+export const RICH_SAFE_ATTRS = {
+    a: new Set(["href", "target", "rel"]),
+};
+export const SAFE_HREF_RE = /^(?:https?:|mailto:|tel:|\/)/i;
+/** Are this element's own attributes within the sanitizer's keep set? */
+function inlineAttrsSafe(node) {
+    const allowed = RICH_SAFE_ATTRS[node.name.toLowerCase()];
+    for (const a of node.attributes ?? []) {
+        if (!allowed || !allowed.has(a.name))
+            return false;
+        if (a.name === "href" && !SAFE_HREF_RE.test(a.value ?? ""))
+            return false;
+    }
+    return true;
+}
+/**
+ * Classify a mixed-content element's subtree for rich promotion. Walks every
+ * descendant: a non-inline tag / component / expression makes it "not-inline";
+ * an inline tag carrying a stripped attribute makes it "rich-unsafe-attrs";
+ * otherwise "rich-safe". `attrsClean` threads the downgrade through recursion.
+ */
+function classifyRichShape(node) {
+    let attrsClean = true;
+    const visit = (n) => {
+        for (const child of n.children ?? []) {
+            if (child.type === "text")
+                continue;
+            if (child.type === "expression")
+                return "not-inline";
+            if (isTagNode(child)) {
+                if (child.type !== "element")
+                    return "not-inline"; // component/fragment
+                if (!RICH_INLINE_TAGS.has(child.name.toLowerCase()))
+                    return "not-inline";
+                if (!inlineAttrsSafe(child))
+                    attrsClean = false;
+                const nested = visit(child);
+                if (nested === "not-inline")
+                    return "not-inline";
+            }
+            // comments/doctype are inert — ignore
+        }
+        return null;
+    };
+    if (visit(node) === "not-inline")
+        return "not-inline";
+    return attrsClean ? "rich-safe" : "rich-unsafe-attrs";
+}
+function attr(node, name) {
+    return node.attributes.find((a) => a.name === name)?.value;
+}
+function hasCaretAttr(node) {
+    return node.attributes.some((a) => a.name === "data-caret" || a.name === "data-caret-scope");
+}
+/** Direct text content of an element (concatenated text-node children). */
+function directText(node) {
+    const parts = [];
+    for (const child of node.children ?? []) {
+        if (child.type === "text")
+            parts.push(child.value ?? "");
+    }
+    return parts.join("");
+}
+/** Classify the children of a (non-image) element. */
+function childShape(node) {
+    let sawText = false;
+    for (const child of node.children ?? []) {
+        if (child.type === "text") {
+            if ((child.value ?? "").trim() !== "")
+                sawText = true;
+            continue;
+        }
+        if (child.type === "expression")
+            return "has-expression";
+        if (isTagNode(child))
+            return "has-element";
+        // comments/doctype/etc. are inert — ignore
+    }
+    return sawText ? "pure-text" : "empty";
+}
+function nearestExpressionAncestor(ancestors) {
+    for (let i = ancestors.length - 1; i >= 0; i--) {
+        if (ancestors[i].type === "expression")
+            return ancestors[i];
+    }
+    return undefined;
+}
+/** Concatenated text of an expression node's direct text children (the JS). */
+function expressionText(expr) {
+    const parts = [];
+    for (const child of expr.children ?? []) {
+        if (child.type === "text")
+            parts.push(child.value ?? "");
+    }
+    return parts.join("");
+}
+/**
+ * Walk a parsed root and classify every tag node.
+ *
+ * `walk` is injected (the caller passes `walkTags`) so this module stays a pure
+ * classifier with no parse dependency beyond the node shape.
+ */
+export function detect(root, walk, options = {}) {
+    const candidates = [];
+    const skipped = [];
+    const flagsByOffset = new Map();
+    // Nodes promoted to data-caret-rich. Their descendants must NOT be tagged
+    // separately (the rich field owns the whole subtree); walkTags is preorder,
+    // so a host is recorded before its descendants are visited.
+    const richHosts = new Set();
+    walk(root, (node, ancestors) => {
+        const tag = node.name;
+        const startOffset = node.position?.start.offset ?? -1;
+        const skip = (reason) => {
+            skipped.push({ decision: "skip", node, tag, startOffset, reason });
+        };
+        if (hasCaretAttr(node))
+            return skip("already-tagged");
+        // Inside a node we already promoted to rich → the rich field owns it.
+        if (ancestors.some((a) => richHosts.has(a)))
+            return skip("inside-rich");
+        if (node.type !== "element")
+            return skip("component"); // component/custom-element/fragment
+        // Dynamic context: inside any {expression}. Record an iterator flag if the
+        // enclosing expression looks like a .map()/.filter() loop.
+        const expr = nearestExpressionAncestor(ancestors);
+        if (expr) {
+            const text = expressionText(expr);
+            const m = ITERATOR_RE.exec(text);
+            const exprOffset = expr.position?.start.offset ?? startOffset;
+            if (m && !flagsByOffset.has(exprOffset)) {
+                flagsByOffset.set(exprOffset, {
+                    startOffset: exprOffset, method: m[2], receiver: m[1],
+                });
+            }
+            return skip(m ? "inside-iterator" : "inside-expression");
+        }
+        if (tag === "img") {
+            const src = attr(node, "src");
+            if (src === undefined || src.trim() === "")
+                return skip("empty");
+            candidates.push({
+                decision: "tag", kind: "image", node, tag, startOffset,
+                confidence: "high", text: src,
+            });
+            return;
+        }
+        if (!(tag in CONFIDENCE))
+            return skip("not-content");
+        const shape = childShape(node);
+        if (shape === "has-expression")
+            return skip("dynamic-content");
+        if (shape === "empty")
+            return skip("empty");
+        if (shape === "has-element") {
+            // Mixed content: a block/component child can't round-trip as a field, but
+            // a subtree of only sanitizer-safe inline markup can — as a rich field.
+            // Only promote genuine content hosts (block text / links), not the
+            // low-confidence generic inline containers (span/div/strong/em/…).
+            const richShape = classifyRichShape(node);
+            const promotable = CONFIDENCE[tag] !== "low";
+            if (richShape === "not-inline" || !promotable)
+                return skip("mixed-children");
+            if (richShape === "rich-unsafe-attrs")
+                return skip("rich-unsafe-attrs");
+            // rich-safe: promote only when opted in; otherwise report it as eligible.
+            if (!options.rich)
+                return skip("rich-eligible");
+            richHosts.add(node);
+            candidates.push({
+                decision: "tag", kind: "text", node, tag, startOffset,
+                confidence: "medium", text: directText(node).trim(), rich: true,
+            });
+            return;
+        }
+        candidates.push({
+            decision: "tag", kind: "text", node, tag, startOffset,
+            confidence: CONFIDENCE[tag], text: directText(node).trim(),
+        });
+    });
+    return {
+        candidates,
+        skipped,
+        flags: [...flagsByOffset.values()].sort((a, b) => a.startOffset - b.startOffset),
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/discover.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Discovery: find the `.astro` files to consider, relative to the project root.
+ *
+ * Never descends into build/vendor/output dirs, and never touches symlinks that
+ * escape the project root (a safety invariant — caretize only edits files
+ * inside the project it was pointed at).
+ */
+/**
+ * Walk `target` (a file or directory) under `rootDir`, returning project-root-
+ * relative POSIX-ish paths of `.astro` files, sorted for deterministic order.
+ */
+export declare function discoverAstroFiles(rootDir: string, target?: string): string[];
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA8C7E"}

package/dist/discover.js

@@ -0,0 +1,84 @@
+/**
+ * Discovery: find the `.astro` files to consider, relative to the project root.
+ *
+ * Never descends into build/vendor/output dirs, and never touches symlinks that
+ * escape the project root (a safety invariant — caretize only edits files
+ * inside the project it was pointed at).
+ */
+import { readdirSync, statSync, lstatSync, realpathSync } from "node:fs";
+import { join, relative, resolve, sep } from "node:path";
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".astro",
+    ".caret",
+    ".git",
+    "dist",
+    ".vercel",
+    ".netlify",
+    ".output",
+]);
+function isSkippedFile(name) {
+    if (!name.endsWith(".astro"))
+        return true;
+    return /\.(test|spec)\.astro$/.test(name);
+}
+/** True if `child` resolves to a path inside `root` (no symlink escape). */
+function isInside(root, child) {
+    const rel = relative(root, child);
+    return rel === "" || (!rel.startsWith("..") && !resolve(rel).startsWith(".."));
+}
+/**
+ * Walk `target` (a file or directory) under `rootDir`, returning project-root-
+ * relative POSIX-ish paths of `.astro` files, sorted for deterministic order.
+ */
+export function discoverAstroFiles(rootDir, target) {
+    const root = resolve(rootDir);
+    const start = resolve(root, target ?? "src");
+    const found = [];
+    const visit = (abs) => {
+        let st;
+        try {
+            st = lstatSync(abs);
+        }
+        catch {
+            return;
+        }
+        // Reject symlinks that point outside the project root.
+        if (st.isSymbolicLink()) {
+            let realPath;
+            try {
+                realPath = realpathSync(abs);
+            }
+            catch {
+                return;
+            }
+            if (!isInside(root, realPath))
+                return;
+            st = statSync(abs);
+        }
+        if (st.isDirectory()) {
+            const base = abs.split(sep).pop() ?? "";
+            if (SKIP_DIRS.has(base))
+                return;
+            let entries;
+            try {
+                entries = readdirSync(abs);
+            }
+            catch {
+                return;
+            }
+            for (const name of entries.sort())
+                visit(join(abs, name));
+            return;
+        }
+        if (st.isFile()) {
+            const base = abs.split(sep).pop() ?? "";
+            if (isSkippedFile(base))
+                return;
+            found.push(relative(root, abs).split(sep).join("/"));
+        }
+    };
+    visit(start);
+    return found;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

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

package/dist/frontmatter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Frontmatter parsing primitives shared by the wrap tiers (`wrap.ts`'s same-file
+ * loop detection and `props.ts`'s cross-file prop detection). Kept neutral so
+ * those two passes are siblings rather than one depending on the other.
+ */
+/** Inner content range of the frontmatter fence, or null if there is none. */
+export declare function frontmatterRange(source: string): {
+    start: number;
+    end: number;
+} | null;
+/** Names of frontmatter consts whose initializer is an array/object literal. */
+export declare function literalConstNames(fmText: string): Set<string>;
+export type ImportKind = "json" | "module";
+/**
+ * Default-import bindings whose data could be wrapped with `editable()`, mapped
+ * to their specifier + kind. Only DEFAULT imports of a `.json` data file or a
+ * `.js`/`.ts` module are returned — named imports (`import { x }`), namespace
+ * imports (`import * as`), `import type`, and bare/package or extensionless
+ * specifiers are excluded, because their value shape can't be assumed safe to
+ * stega-encode. `import faqs from "./data/faqs.json"` → `faqs → {json}`.
+ */
+export declare function importBindingNames(fmText: string): Map<string, {
+    specifier: string;
+    importKind: ImportKind;
+}>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOtF;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAM7D;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC,CAa5D"}

package/dist/frontmatter.js

@@ -0,0 +1,52 @@
+/**
+ * Frontmatter parsing primitives shared by the wrap tiers (`wrap.ts`'s same-file
+ * loop detection and `props.ts`'s cross-file prop detection). Kept neutral so
+ * those two passes are siblings rather than one depending on the other.
+ */
+/** Inner content range of the frontmatter fence, or null if there is none. */
+export function frontmatterRange(source) {
+    if (!source.startsWith("---"))
+        return null;
+    const firstNL = source.indexOf("\n");
+    if (firstNL < 0)
+        return null;
+    const close = source.indexOf("\n---", firstNL);
+    if (close < 0)
+        return null;
+    return { start: firstNL + 1, end: close };
+}
+/** Names of frontmatter consts whose initializer is an array/object literal. */
+export function literalConstNames(fmText) {
+    const set = new Set();
+    const re = /\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*([[{])/g;
+    let m;
+    while ((m = re.exec(fmText)))
+        set.add(m[1]);
+    return set;
+}
+/**
+ * Default-import bindings whose data could be wrapped with `editable()`, mapped
+ * to their specifier + kind. Only DEFAULT imports of a `.json` data file or a
+ * `.js`/`.ts` module are returned — named imports (`import { x }`), namespace
+ * imports (`import * as`), `import type`, and bare/package or extensionless
+ * specifiers are excluded, because their value shape can't be assumed safe to
+ * stega-encode. `import faqs from "./data/faqs.json"` → `faqs → {json}`.
+ */
+export function importBindingNames(fmText) {
+    const out = new Map();
+    const re = /\bimport\s+(?!type\b)([A-Za-z_$][\w$]*)\s+from\s*['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = re.exec(fmText))) {
+        const [, name, spec] = m;
+        let importKind;
+        if (/\.json$/.test(spec))
+            importKind = "json";
+        else if (/\.(?:js|ts|mjs|cjs|mts|cts)$/.test(spec))
+            importKind = "module";
+        else
+            continue; // bare/package or extensionless — shape unknown, leave alone
+        out.set(name, { specifier: spec, importKind });
+    }
+    return out;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,EAAE,GAAG,wDAAwD,CAAC;IACpE,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC;AACb,CAAC;AAID;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC7E,MAAM,EAAE,GAAG,oEAAoE,CAAC;IAChF,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,UAAsB,CAAC;QAC3B,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,UAAU,GAAG,MAAM,CAAC;aACzC,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,UAAU,GAAG,QAAQ,CAAC;;YACrE,SAAS,CAAC,6DAA6D;QAC5E,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/identifiers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared JS-identifier primitives used across the wrap/usage/resolve passes.
+ *
+ * Centralised so "what is an identifier" and "how do we match a reference to
+ * one" have a single definition — the matcher in particular is safety-relevant
+ * (a missed reference can let `editable()` encode into an attribute), so it must
+ * not drift between callers.
+ */
+/** A valid JS identifier (ASCII letters/digits plus `_` and `$`). */
+export declare const IDENT: RegExp;
+export declare function isIdentifier(s: string): boolean;
+/** Escape a string for safe literal use inside a `RegExp`. */
+export declare function escapeRe(s: string): string;
+/**
+ * A regex matching a whole-identifier reference to `name` in JS source.
+ *
+ * Uses `$`/`_`-aware lookaround boundaries rather than `\b`: `\b` sits between a
+ * word and a non-word char, so `\b$item\b` does NOT match `$item` (the `$` is a
+ * non-word char with no word char before it). Lookaround treats `$` and `_` as
+ * identifier characters, so `$item` and `item$` are bounded correctly while a
+ * substring like `item` inside `items` is still rejected.
+ */
+export declare function identRefRe(name: string, flags?: string): RegExp;
+/** True when `js` references any of the given identifiers as a whole word. */
+export declare function referencesIdent(js: string, names: readonly string[]): boolean;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,eAAO,MAAM,KAAK,QAAuB,CAAC;AAE1C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAE3D;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE7E"}

package/dist/identifiers.js

@@ -0,0 +1,34 @@
+/**
+ * Shared JS-identifier primitives used across the wrap/usage/resolve passes.
+ *
+ * Centralised so "what is an identifier" and "how do we match a reference to
+ * one" have a single definition — the matcher in particular is safety-relevant
+ * (a missed reference can let `editable()` encode into an attribute), so it must
+ * not drift between callers.
+ */
+/** A valid JS identifier (ASCII letters/digits plus `_` and `$`). */
+export const IDENT = /^[A-Za-z_$][\w$]*$/;
+export function isIdentifier(s) {
+    return IDENT.test(s);
+}
+/** Escape a string for safe literal use inside a `RegExp`. */
+export function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * A regex matching a whole-identifier reference to `name` in JS source.
+ *
+ * Uses `$`/`_`-aware lookaround boundaries rather than `\b`: `\b` sits between a
+ * word and a non-word char, so `\b$item\b` does NOT match `$item` (the `$` is a
+ * non-word char with no word char before it). Lookaround treats `$` and `_` as
+ * identifier characters, so `$item` and `item$` are bounded correctly while a
+ * substring like `item` inside `items` is still rejected.
+ */
+export function identRefRe(name, flags = "") {
+    return new RegExp(`(?<![\\w$])${escapeRe(name)}(?![\\w$])`, flags);
+}
+/** True when `js` references any of the given identifiers as a whole word. */
+export function referencesIdent(js, names) {
+    return names.some((n) => identRefRe(n).test(js));
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC;AAE1C,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAK,GAAG,EAAE;IACjD,OAAO,IAAI,MAAM,CAAC,cAAc,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,KAAwB;IAClE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/import-wrap.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tier-3 editable() wrapping for IMPORTED data — PURE INSERTION.
+ *
+ * A very common Astro pattern keeps list content in a data file and renders it
+ * with `.map()`:
+ *
+ *   import faqs from "./data/faqs.json";
+ *   …
+ *   {faqs.map((f) => <details>{f.question}…</details>)}
+ *
+ * caretize's Tier-1 wrap only sees inline-literal consts (`const x = [...]`), so
+ * this content was previously left un-editable. Tier-3 makes it editable WITHOUT
+ * moving any code: it suffixes the import binding and rebinds the original name
+ * to an `editable()` wrap of it —
+ *
+ *   import faqsRaw from "./data/faqs.json";
+ *   const faqs = await editable("pages::home::faqs", faqsRaw);
+ *
+ * Every original character survives in order (the import binding only GAINS a
+ * suffix; a new const line is inserted), so the result is a provable pure
+ * insertion — the same subsequence safety contract as Tier-1. The `.map()`
+ * consumer is untouched and now reads the stega-encoded, click-to-edit value.
+ */
+import { type AstroNode } from "./parse.js";
+import { type ImportKind } from "./frontmatter.js";
+import { type WrapResult, type WrapTarget } from "./wrap.js";
+/** An import binding the wrapper could target, before safety is verified. */
+export interface ImportWrapCandidate {
+    /** The original local binding, e.g. `faqs`. */
+    varName: string;
+    /** Binding key, e.g. `pages::home::faqs`. */
+    key: string;
+    /** The import specifier, e.g. `./data/faqs.json` (for display). */
+    specifier: string;
+    /** Whether the source is a `.json` data file or a `.js`/`.ts` module. */
+    importKind: ImportKind;
+}
+/**
+ * Rebind an imported `varName` to `await editable("<key>", <varName>Raw)` and
+ * ensure the import is present. Pure insertion: the import binding gains a
+ * suffix and a new const line is inserted; nothing is deleted.
+ */
+export declare function wrapImport(source: string, varName: string, key: string): WrapResult;
+/**
+ * Detect Tier-3 candidates: DEFAULT imports of a `.json`/module data file that
+ * are `.map()`/`.flatMap()`'d in the template. Key is derived from the file's
+ * scope (`collection::id`) plus the binding name as the field.
+ */
+export declare function detectImportWrapCandidates(source: string, relPath: string): ImportWrapCandidate[];
+/**
+ * Safety-checked Tier-3 detection: import-backed candidates minus any whose
+ * mapped fields flow into a native-element attribute (where `editable()`'s stega
+ * encoding would corrupt an href/src/class/…). Mirrors `detectWrapTargetsSafe`.
+ */
+export declare function detectImportWrapTargetsSafe(source: string, relPath: string, root?: AstroNode): Promise<WrapTarget[]>;
+//# sourceMappingURL=import-wrap.d.ts.map

package/dist/import-wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-wrap.d.ts","sourceRoot":"","sources":["../src/import-wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAA0B,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAErF,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,UAAU,EAAE,UAAU,CAAC;CACxB;AAWD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAuDnF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,mBAAmB,EAAE,CAuCvB;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAOvB"}