@caretcms/caretize 0.1.0

package/dist/prop-hoist.js

@@ -0,0 +1,232 @@
+/**
+ * Tier-4 prop hoisting — a guarded REWRITE (not pure insertion).
+ *
+ * The most common pattern caretize couldn't touch is a static string passed to a
+ * shared component as a prop:
+ *
+ *   <PageHero title="ABOUT US" description="Since 2010 …" />
+ *
+ * The text never appears as a tag-able text leaf (it's an attribute on a
+ * component), and `data-caret` can't ride a component boundary. The fix is to
+ * hoist each literal into an `editable()` frontmatter const and reference it:
+ *
+ *   const pageHeroTitle = await editable("pages::about::title", "ABOUT US");
+ *   …
+ *   <PageHero title={pageHeroTitle} description={pageHeroDesc} />
+ *
+ * Unlike the other tiers this DELETES bytes (the attribute literal), so it can't
+ * use the subsequence gate. Instead it is verified by an INVERSE check: undo
+ * every edit (swap the reference back to the literal, strip the const lines) and
+ * assert the result is byte-identical to the input — proving the only changes
+ * were the intended hoists. A hand-off is rewritten only on positive proof the
+ * child renders the prop as text (reusing the Tier-2 cross-file verifier), and
+ * only when the exact `prop="value"` token occurs exactly once (unambiguous).
+ */
+import { parseAstro, walkTags } from "./parse.js";
+import { deriveScope, isValidField, slugifyText } from "./name.js";
+import { resolveComponentImport } from "./resolve.js";
+import { propLocalName } from "./props.js";
+import { classifyConstUsage, rendersOutsideHead } from "./usage.js";
+import { frontmatterRange } from "./frontmatter.js";
+import { IMPORT_LINE, IMPORT_RE } from "./wrap.js";
+const RICH_RE = (local) => new RegExp(`set:html\\s*=\\s*\\{[^}]*\\b${local}\\b[^}]*\\}`);
+function ucFirst(s) {
+    return s ? s[0].toUpperCase() + s.slice(1) : s;
+}
+/** camelCase identifier from parts, e.g. ["PageHero","title"] → "pageHeroTitle". */
+function camelIdent(parts) {
+    const words = parts.flatMap((p) => p.split(/[^A-Za-z0-9]+/)).filter(Boolean);
+    if (words.length === 0)
+        return "field";
+    return words
+        .map((w, i) => (i === 0 ? w[0].toLowerCase() + w.slice(1) : ucFirst(w)))
+        .join("");
+}
+function uniquify(base, used) {
+    let name = base;
+    let n = 2;
+    while (used.has(name))
+        name = `${base}_${n++}`;
+    used.add(name);
+    return name;
+}
+/** Existing frontmatter binding names, so hoisted consts never shadow one. */
+function declaredNames(fmText) {
+    const set = new Set();
+    const re = /\b(?:const|let|var|import)\s+([A-Za-z_$][\w$]*)/g;
+    let m;
+    while ((m = re.exec(fmText)))
+        set.add(m[1]);
+    return set;
+}
+/** Existing data-caret field segments in the file, so keys stay unique. */
+function usedFields(source) {
+    const set = new Set();
+    const re = /data-caret(?:-rich)?="[^"]*::([A-Za-z0-9_]+)"/g;
+    let m;
+    while ((m = re.exec(source)))
+        set.add(m[1]);
+    return set;
+}
+/** The exact `name="value"` (or single-quoted) token, if it occurs exactly once. */
+function uniqueAttrToken(source, name, value) {
+    for (const q of ['"', "'"]) {
+        if (value.includes(q))
+            continue;
+        const tok = `${name}=${q}${value}${q}`;
+        const first = source.indexOf(tok);
+        if (first >= 0 && source.indexOf(tok, first + tok.length) < 0)
+            return tok;
+    }
+    return null;
+}
+/**
+ * Detect prop-hoist targets: component invocations with static string props
+ * whose child provably renders them as text. `readFile` resolves sibling files.
+ */
+export async function detectPropHoistTargets(source, relPath, readFile, root) {
+    const scoped = deriveScope(relPath);
+    if ("skip" in scoped)
+        return [];
+    const { collection, id } = scoped.scope;
+    const fm = frontmatterRange(source);
+    if (!fm)
+        return [];
+    const fmText = source.slice(fm.start, fm.end);
+    const ast = root ?? (await parseAstro(source));
+    const usedConsts = declaredNames(fmText);
+    const fields = usedFields(source);
+    // Cache child source + its parsed AST across repeated component uses.
+    const childCache = new Map();
+    const readChild = async (rel) => {
+        if (!childCache.has(rel)) {
+            const src = readFile(rel);
+            childCache.set(rel, src === null ? null : { src, ast: await parseAstro(src) });
+        }
+        return childCache.get(rel) ?? null;
+    };
+    /** Does the child render `prop` purely as text (incl. set:html), no re-handoff,
+     *  AND in a body-reachable position the editor can actually click? */
+    const childTextSafe = (child, prop) => {
+        const local = propLocalName(child.src, prop);
+        if (!local)
+            return false;
+        const verdict = classifyConstUsage(child.ast, local, {
+            componentHandoffUnsafe: true,
+            htmlDirectivesSafe: true,
+        });
+        // Safe (never a corrupting attribute) AND has at least one body sink — a
+        // prop rendered only into <head> (e.g. a layout's <title>) is editable in
+        // name only, so don't hoist it.
+        return verdict.safe && rendersOutsideHead(child.ast, [local]);
+    };
+    const targets = [];
+    const componentNodes = [];
+    walkTags(ast, (node) => {
+        if (node.type === "component")
+            componentNodes.push(node);
+    });
+    for (const node of componentNodes) {
+        const childRel = resolveComponentImport(source, node.name, relPath);
+        const child = childRel ? await readChild(childRel) : null;
+        if (!child)
+            continue;
+        const props = [];
+        for (const attr of node.attributes) {
+            if (attr.kind !== "quoted")
+                continue;
+            const value = attr.value ?? "";
+            if (value.trim() === "")
+                continue;
+            if (!isValidField(attr.name) && !slugifyText(attr.name))
+                continue;
+            // Positive proof: the child renders this prop as text (no native-attr, no
+            // re-handoff). set:html counts as text (stega-safe content sink).
+            if (!childTextSafe(child, attr.name))
+                continue;
+            // Locate an unambiguous source token; skip if absent/duplicated.
+            const attrBefore = uniqueAttrToken(source, attr.name, value);
+            if (!attrBefore)
+                continue;
+            const local = propLocalName(child.src, attr.name);
+            const isRich = local ? RICH_RE(local).test(child.src) : false;
+            const baseField = (isValidField(attr.name) ? attr.name : slugifyText(attr.name));
+            const field = uniquify(baseField, fields);
+            const constName = uniquify(camelIdent([node.name, attr.name]), usedConsts);
+            const key = `${collection}::${id}::${field}`;
+            const constInsert = `\nconst ${constName} = await editable(${JSON.stringify(key)}, ${JSON.stringify(value)});`;
+            props.push({
+                propName: attr.name,
+                literalValue: value,
+                key,
+                constName,
+                isRich,
+                attrBefore,
+                attrAfter: `${attr.name}={${constName}}`,
+                constInsert,
+            });
+        }
+        if (props.length)
+            targets.push({ componentName: node.name, props });
+    }
+    return targets;
+}
+/** Apply the hoist rewrite. Self-locating: finds each `attrBefore` token by content. */
+export function hoistPropLiterals(source, targets) {
+    const base = {
+        output: source, ok: true, propsRewritten: 0, constsDeclared: [], addedImport: false,
+    };
+    const flat = targets.flatMap((t) => t.props);
+    if (flat.length === 0)
+        return base;
+    let output = source;
+    // 1. Rewrite each attribute literal → expression reference (template region).
+    for (const p of flat) {
+        if (!output.includes(p.attrBefore)) {
+            return { ...base, ok: false, reason: `attr token not found: ${p.attrBefore}` };
+        }
+        output = output.replace(p.attrBefore, p.attrAfter);
+    }
+    // 2. Insert the editable() consts at the end of the frontmatter, and the
+    //    import at the top (once). Recompute the range on the rewritten source.
+    const fm = frontmatterRange(output);
+    if (!fm)
+        return { ...base, ok: false, reason: "no frontmatter block" };
+    const addedImport = !IMPORT_RE.test(output);
+    const constBlock = flat.map((p) => p.constInsert).join("");
+    output =
+        output.slice(0, fm.start) +
+            (addedImport ? `${IMPORT_LINE}\n` : "") +
+            output.slice(fm.start, fm.end) +
+            constBlock +
+            output.slice(fm.end);
+    return {
+        output,
+        ok: true,
+        propsRewritten: flat.length,
+        constsDeclared: flat.map((p) => p.constName),
+        addedImport,
+    };
+}
+/**
+ * Inverse gate: undo every hoist edit on `output` and assert the result is
+ * byte-identical to `intermediate` (the source the hoist was applied to). This
+ * proves the ONLY changes were the intended hoists — no collateral edits.
+ */
+export function verifyHoistResult(intermediate, output, targets, addedImport) {
+    let restored = output;
+    if (addedImport)
+        restored = restored.replace(`${IMPORT_LINE}\n`, "");
+    for (const p of targets.flatMap((t) => t.props)) {
+        if (!restored.includes(p.constInsert))
+            return false;
+        restored = restored.replace(p.constInsert, "");
+        if (!restored.includes(p.attrAfter))
+            return false;
+        // Function replacement: `attrBefore` is a verbatim source token and may hold
+        // `$&`/`$$`/etc., which string-replacement would interpret as patterns.
+        restored = restored.replace(p.attrAfter, () => p.attrBefore);
+    }
+    return restored === intermediate;
+}
+//# sourceMappingURL=prop-hoist.js.map

package/dist/prop-hoist.js.map

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

package/dist/props.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tier-2 cross-file prop wrapping — detection only.
+ *
+ * Finds frontmatter array/object literals that a page passes straight into a
+ * component as a prop (`<Features items={features} />`), follows the import into
+ * that child, and confirms — strictly — that every field of the value renders
+ * there as visible TEXT and never as a native-element attribute. Only then is the
+ * parent const a safe `editable()` wrap target. The wrap itself stays in the
+ * parent file (the same pure-insertion `wrapConst` Tier-1 uses); no child file is
+ * ever modified.
+ *
+ * Conservative by construction — a hand-off is wrapped only on positive proof:
+ *   - import not a resolvable relative `.astro`  → skip
+ *   - child file unreadable                       → skip
+ *   - prop not a simple `Astro.props` destructure → skip
+ *   - child re-passes the prop to a component      → skip (grandchild unverified)
+ *   - any field used in a native attribute (here or in the child) → skip
+ */
+import { type AstroNode } from "./parse.js";
+import type { WrapTarget } from "./wrap.js";
+/** Reads a project-root-relative path, or returns null if it doesn't exist. */
+export type FileReader = (relPath: string) => string | null;
+/**
+ * The local identifier a child binds `prop` to via `const { … } = Astro.props`.
+ * Returns the destructured name (or its `prop: alias` rename), or null when the
+ * child doesn't destructure props simply — in which case we can't trace usage
+ * and the caller skips.
+ */
+export declare function propLocalName(childSource: string, prop: string): string | null;
+/** Verify a child renders `prop`'s fields as text only (strict: no re-handoff). */
+export declare function childRendersPropAsText(childSource: string, prop: string): Promise<boolean>;
+/**
+ * Detect Tier-2 wrap targets: literal consts handed to a component as a prop
+ * whose child provably renders them as text. `readFile` resolves sibling files
+ * (injected so this stays testable without a real filesystem).
+ */
+export declare function detectPropWrapTargets(source: string, relPath: string, readFile: FileReader, root?: AstroNode): Promise<WrapTarget[]>;
+//# sourceMappingURL=props.d.ts.map

package/dist/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../src/props.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAMxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmB9E;AAED,mFAAmF;AACnF,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAgDvB"}

package/dist/props.js

@@ -0,0 +1,116 @@
+/**
+ * Tier-2 cross-file prop wrapping — detection only.
+ *
+ * Finds frontmatter array/object literals that a page passes straight into a
+ * component as a prop (`<Features items={features} />`), follows the import into
+ * that child, and confirms — strictly — that every field of the value renders
+ * there as visible TEXT and never as a native-element attribute. Only then is the
+ * parent const a safe `editable()` wrap target. The wrap itself stays in the
+ * parent file (the same pure-insertion `wrapConst` Tier-1 uses); no child file is
+ * ever modified.
+ *
+ * Conservative by construction — a hand-off is wrapped only on positive proof:
+ *   - import not a resolvable relative `.astro`  → skip
+ *   - child file unreadable                       → skip
+ *   - prop not a simple `Astro.props` destructure → skip
+ *   - child re-passes the prop to a component      → skip (grandchild unverified)
+ *   - any field used in a native attribute (here or in the child) → skip
+ */
+import { parseAstro } from "./parse.js";
+import { deriveScope, isValidField, slugifyText } from "./name.js";
+import { classifyConstUsage } from "./usage.js";
+import { resolveComponentImport } from "./resolve.js";
+import { frontmatterRange, literalConstNames } from "./frontmatter.js";
+import { IDENT } from "./identifiers.js";
+/**
+ * The local identifier a child binds `prop` to via `const { … } = Astro.props`.
+ * Returns the destructured name (or its `prop: alias` rename), or null when the
+ * child doesn't destructure props simply — in which case we can't trace usage
+ * and the caller skips.
+ */
+export function propLocalName(childSource, prop) {
+    const re = /const\s*\{([^}]*)\}\s*=\s*Astro\.props/g;
+    let m;
+    while ((m = re.exec(childSource))) {
+        for (const part of m[1].split(",")) {
+            const seg = part.trim();
+            if (!seg || seg.startsWith("..."))
+                continue;
+            // `prop`, `prop: alias`, or `prop = default` (strip the default).
+            const key = seg.split(/[:=]/)[0].trim();
+            if (key !== prop)
+                continue;
+            const colon = seg.indexOf(":");
+            if (colon >= 0) {
+                const alias = seg.slice(colon + 1).split("=")[0].trim();
+                return IDENT.test(alias) ? alias : null;
+            }
+            return IDENT.test(key) ? key : null;
+        }
+    }
+    return null;
+}
+/** Verify a child renders `prop`'s fields as text only (strict: no re-handoff). */
+export async function childRendersPropAsText(childSource, prop) {
+    const local = propLocalName(childSource, prop);
+    if (!local)
+        return false;
+    const root = await parseAstro(childSource);
+    return classifyConstUsage(root, local, { componentHandoffUnsafe: true }).safe;
+}
+/**
+ * Detect Tier-2 wrap targets: literal consts handed to a component as a prop
+ * whose child provably renders them as text. `readFile` resolves sibling files
+ * (injected so this stays testable without a real filesystem).
+ */
+export async function detectPropWrapTargets(source, relPath, readFile, root) {
+    const scoped = deriveScope(relPath);
+    if ("skip" in scoped)
+        return [];
+    const { collection, id } = scoped.scope;
+    const fm = frontmatterRange(source);
+    if (!fm)
+        return [];
+    const literals = literalConstNames(source.slice(fm.start, fm.end));
+    if (literals.size === 0)
+        return [];
+    const ast = root ?? (await parseAstro(source));
+    const targets = [];
+    for (const varName of literals) {
+        // Local usage: gather this const's component hand-offs, and bail if a field
+        // already lands in a native-element attribute in THIS file.
+        const local = classifyConstUsage(ast, varName); // lenient: collect handoffs
+        if (!local.safe)
+            continue;
+        // Only consts actually passed to a component as a prop are Tier-2's business;
+        // pure local-loop consts are Tier-1's. Dedup hand-offs by component+prop.
+        const seen = new Set();
+        const handoffs = local.handoffs.filter((h) => {
+            const k = `${h.component}::${h.prop}`;
+            if (seen.has(k))
+                return false;
+            seen.add(k);
+            return true;
+        });
+        if (handoffs.length === 0)
+            continue;
+        // Every hand-off must resolve to a child that renders the prop as text.
+        let allSafe = true;
+        for (const h of handoffs) {
+            const childRel = resolveComponentImport(source, h.component, relPath);
+            const childSrc = childRel ? readFile(childRel) : null;
+            if (!childSrc || !(await childRendersPropAsText(childSrc, h.prop))) {
+                allSafe = false;
+                break;
+            }
+        }
+        if (!allSafe)
+            continue;
+        const field = isValidField(varName) ? varName : slugifyText(varName);
+        if (!field)
+            continue;
+        targets.push({ varName, key: `${collection}::${id}::${field}`, origin: "prop" });
+    }
+    return targets;
+}
+//# sourceMappingURL=props.js.map

package/dist/props.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Machine-readable report (for --report) and the human summary counts. Pure
+ * functions over plans + the prepared results so they're easy to test.
+ */
+import type { FilePlan } from "./plan.js";
+import type { PreparedFile } from "./run.js";
+export interface CaretizeReport {
+    version: 1;
+    scope: {
+        collection: string;
+        id: string;
+    } | null;
+    files: Array<{
+        path: string;
+        scope: {
+            collection: string;
+            id: string;
+        } | null;
+        scopeSkip?: string;
+        tags: Array<{
+            binding: string;
+            tag: string;
+            confidence: string;
+            text: string;
+        }>;
+        skipped: Array<{
+            tag: string;
+            reason: string;
+        }>;
+        flags: Array<{
+            method: string;
+        }>;
+    }>;
+    totals: {
+        tagged: number;
+        skipped: number;
+        flagged: number;
+        filesModified: number;
+    };
+}
+export declare function buildReport(plans: FilePlan[], prepared?: PreparedFile[]): CaretizeReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACjD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChF,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChD,KAAK,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,EAAE,EACjB,QAAQ,GAAE,YAAY,EAAO,GAC5B,cAAc,CAgChB"}

package/dist/report.js

@@ -0,0 +1,35 @@
+/**
+ * Machine-readable report (for --report) and the human summary counts. Pure
+ * functions over plans + the prepared results so they're easy to test.
+ */
+export function buildReport(plans, prepared = []) {
+    const modified = new Set(prepared.filter((p) => p.tagCount > 0).map((p) => p.relPath));
+    let tagged = 0;
+    let skipped = 0;
+    let flagged = 0;
+    const files = plans.map((plan) => {
+        tagged += plan.tags.length;
+        skipped += plan.skipped.length;
+        flagged += plan.flags.length;
+        return {
+            path: plan.relPath,
+            scope: plan.scope ?? null,
+            ...(plan.scopeSkip ? { scopeSkip: plan.scopeSkip } : {}),
+            tags: plan.tags.map((t) => ({
+                binding: t.binding,
+                tag: t.candidate.tag,
+                confidence: t.confidence,
+                text: t.candidate.text,
+            })),
+            skipped: plan.skipped.map((s) => ({ tag: s.tag, reason: s.reason })),
+            flags: plan.flags.map((f) => ({ method: f.method })),
+        };
+    });
+    return {
+        version: 1,
+        scope: plans.find((p) => p.scope)?.scope ?? null,
+        files,
+        totals: { tagged, skipped, flagged, filesModified: modified.size },
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,UAAU,WAAW,CACzB,KAAiB,EACjB,WAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvF,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/B,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG;gBACpB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI;aACvB,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI;QAChD,KAAK;QACL,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;KACnE,CAAC;AACJ,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Minimal component-import resolution for the cross-file prop pass.
+ *
+ * Given an importer's source and a component name, find its `import … from`
+ * specifier and resolve it to a project-root-relative `.astro` path. Only RELATIVE
+ * specifiers are resolved: bare/`npm` packages and tsconfig path aliases
+ * (`~/…`, `@/…`) need build config we don't read, so they return null and the
+ * caller conservatively skips that hand-off rather than guess.
+ */
+/**
+ * Resolve `componentName`'s source path relative to the project root, or null
+ * when the import is absent or not a resolvable relative `.astro` specifier.
+ */
+export declare function resolveComponentImport(importerSource: string, componentName: string, importerRelPath: string): string | null;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAoBf"}

package/dist/resolve.js

@@ -0,0 +1,35 @@
+/**
+ * Minimal component-import resolution for the cross-file prop pass.
+ *
+ * Given an importer's source and a component name, find its `import … from`
+ * specifier and resolve it to a project-root-relative `.astro` path. Only RELATIVE
+ * specifiers are resolved: bare/`npm` packages and tsconfig path aliases
+ * (`~/…`, `@/…`) need build config we don't read, so they return null and the
+ * caller conservatively skips that hand-off rather than guess.
+ */
+import { posix } from "node:path";
+import { escapeRe } from "./identifiers.js";
+/**
+ * Resolve `componentName`'s source path relative to the project root, or null
+ * when the import is absent or not a resolvable relative `.astro` specifier.
+ */
+export function resolveComponentImport(importerSource, componentName, importerRelPath) {
+    // Default import of the component, tolerating a trailing named group:
+    // `import Name from '…'` and `import Name, { X } from '…'`. The `(?![\w$])`
+    // bounds the name so `Card` doesn't match `CardList`.
+    const re = new RegExp(`import\\s+${escapeRe(componentName)}(?![\\w$])[^'"\\n]*?from\\s*['"]([^'"]+)['"]`);
+    const m = re.exec(importerSource);
+    if (!m)
+        return null;
+    let spec = m[1];
+    if (!spec.startsWith("./") && !spec.startsWith("../"))
+        return null; // alias/bare → unresolvable here
+    if (!spec.endsWith(".astro")) {
+        if (/\.\w+$/.test(spec))
+            return null; // a non-.astro file (e.g. .tsx) — out of scope for v1
+        spec += ".astro";
+    }
+    const dir = posix.dirname(importerRelPath.replace(/\\/g, "/"));
+    return posix.normalize(posix.join(dir, spec));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EACtB,aAAqB,EACrB,eAAuB;IAEvB,sEAAsE;IACtE,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,EAAE,GAAG,IAAI,MAAM,CACnB,aAAa,QAAQ,CAAC,aAAa,CAAC,8CAA8C,CACnF,CAAC;IACF,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;IAErG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,sDAAsD;QAC5F,IAAI,IAAI,QAAQ,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Run orchestration. The atomicity model is "validate everything in memory,
+ * then write": every file's tagged output is computed and verified (re-parses +
+ * is pure-insertion-reversible) BEFORE a single byte hits disk. If any file
+ * fails verification, the run aborts having written nothing. During the write
+ * phase, backups are taken per file; if a write throws, everything written so
+ * far is restored from those backups.
+ */
+import { type TagInsertion } from "./write.js";
+import { type WrapTarget } from "./wrap.js";
+import { type PropHoistTarget } from "./prop-hoist.js";
+export interface PreparedFile {
+    relPath: string;
+    source: string;
+    output: string;
+    inserted: string[];
+    tagCount: number;
+    ok: boolean;
+    reason?: string;
+}
+/** Compute and verify a single file's tagged output. No disk access. */
+export declare function prepareFile(relPath: string, source: string, items: TagInsertion[]): Promise<PreparedFile>;
+export type { WrapTarget };
+/**
+ * Compute and verify a single file's editable()-wrapped output (Tier-1). Same
+ * atomicity contract as prepareFile, so the result feeds commitRun unchanged.
+ *
+ * Gate 2 here is a SUBSEQUENCE check rather than strip-by-string: the inserted
+ * `await editable(…, ` / `)` spans contain characters (`)`, commas) that also
+ * occur elsewhere, so verifying "original is a subsequence of output" is the
+ * robust way to prove pure insertion (no original char deleted or reordered).
+ */
+export declare function prepareWrapFile(relPath: string, source: string, targets: WrapTarget[]): Promise<PreparedFile>;
+/**
+ * Compute and verify a file's output with BOTH passes: attribute tags and
+ * editable() wraps. Tags are applied first (offset-based, in the template), then
+ * wraps (content-scan, in the frontmatter) — so the frontmatter insertions never
+ * shift the template tag offsets. Same atomicity gates; one PreparedFile out.
+ */
+export declare function prepareFileFull(relPath: string, source: string, items: TagInsertion[], targets: WrapTarget[], hoistTargets?: PropHoistTarget[]): Promise<PreparedFile>;
+export interface CommitResult {
+    written: string[];
+    backups: string[];
+}
+/**
+ * Write verified files to disk with backups. Throws (after rolling back) if any
+ * prepared file failed verification or any write fails.
+ */
+export declare function commitRun(rootDir: string, prepared: PreparedFile[], stamp: string): CommitResult;
+/** Convenience: read a file from disk for preparation. */
+export declare function readSource(rootDir: string, relPath: string): string;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAU7F,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EAAE,GACpB,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC;AAW3B;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,EAAE,GACpB,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,YAAY,GAAE,eAAe,EAAO,GACnC,OAAO,CAAC,YAAY,CAAC,CAqEvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ,YAAY,CA4Bd;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE"}