@caretcms/caretize 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @caretcms/caretize
+
+Make an existing Astro site editable with [CaretCMS](https://github.com/web-stacked/caretcms): `caretize` scans your `.astro` templates and interactively inserts `data-caret` attributes (plus `editable()` wraps for data arrays), turning static markup into inline-editable content — no schema or config rewrite required.
+
+The static HTML you already have *is* the seed content: CaretCMS renders the original text until an editor saves an override, so caretize only has to mark what's editable.
+
+```sh
+# in your Astro project root — preview first, write nothing
+npx @caretcms/caretize --dry-run
+
+# then run the interactive review
+npx @caretcms/caretize
+```
+
+## What it does
+
+For every candidate it finds, caretize shows the element and proposed binding and asks:
+
+```
+src/pages/index.astro
+  <h1> "Launch faster with Acme"
+  + data-caret="pages::home::launch_faster_with_acme"  (high)
+  [a]ccept [s]kip [e]dit [A]ll [S]kip-file [q]uit >
+```
+
+- **Tags** pure-text leaf elements (`h1`–`h6`, `p`, `li`, `a`, `button`, …) and `<img>` `src` — exactly the set the CaretCMS rewrite engine can render, nothing more.
+- **Names fields from content** (`"Our Programs 🎨"` → `our_programs`); prose tags keep role names. Names are deterministic and never collide with existing bindings, so re-runs are idempotent.
+- **Wraps data arrays** (`const faqs = [...]` → `editable("pages::home::faqs", [...])`) so list content is editable too.
+- **Flags what it can't tag** (loops, expressions, mixed markup) and tells you which flag unlocks each.
+
+## Safety model
+
+- **Nothing is written until the review ends.** Every output is verified in memory first: it must re-parse as valid Astro and be a pure insertion of the original (your bytes survive untouched, in order).
+- **All-or-nothing:** if any file fails verification, the run aborts having written nothing.
+- **Backups:** every written file is first copied to `.caret/.caretize-bak/`; `caretize --restore` reverts the most recent run. Git is the real undo — caretize warns when your tree is dirty.
+- Multibyte-safe: offsets are computed and spliced on UTF-8 buffers (emoji/em-dashes can't corrupt a tag).
+
+## Options
+
+```
+caretize [path] [options]
+
+  path                     file or directory to scan (default: src/)
+  --dry-run                print the plan, write nothing
+  -y, --yes                auto-accept all suggestions at/above min-confidence
+  --min-confidence <lvl>   high (default) | medium | low
+  --no-images              skip <img> elements
+  --no-props               skip hoisting static component-prop strings to editable()
+  --bind-collections       bind getCollection().map() loops in place — a leaf
+                           element rendering {item.data.field} gets a per-row
+                           data-caret (direct-render only; props stay flagged)
+  --bind-routes            bind a dynamic collection-detail route ([slug].astro)
+                           to its current entry via getStaticPaths props
+  --rich                   also tag mixed-content blocks whose markup is
+                           sanitizer-safe inline formatting (data-caret-rich)
+  --scope <collection::id> override the inferred scope (validated against the
+                           runtime grammar: ^[a-z][a-z0-9_-]*$ :: ^[a-z0-9][a-z0-9_-]*$)
+  --report <file>          write a JSON report
+  --restore                restore the most recent backup, then exit
+```
+
+## After caretize
+
+1. `npm run dev`
+2. Sign in at `/admin` — with no `CARET_EDIT_PASSWORD` set, a temporary dev password is printed in your terminal
+3. Click any tagged element to edit it in place; the Studio lives at `/admin/cms`
+
+Requires [`@caretcms/core`](https://www.npmjs.com/package/@caretcms/core) wired into `astro.config.mjs` (caretize's preflight checks this and tells you if it isn't).
+
+MIT © CaretCMS contributors

package/dist/backup.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Backups + restore. Before any file is modified, its current bytes are copied
+ * to `.caret/.caretize-bak/<relpath>.<timestamp>.bak`. `--restore` rolls the
+ * most recent run back.
+ *
+ * The timestamp is injected (not read from the clock here) so a single run uses
+ * one consistent stamp across all files and the logic stays deterministic/
+ * testable.
+ */
+/** Copy the current file to its timestamped backup, creating dirs as needed. */
+export declare function writeBackup(rootDir: string, relPath: string, stamp: string): string;
+interface BackupEntry {
+    relPath: string;
+    stamp: string;
+    backupAbs: string;
+}
+/** All backups under the backup root, parsed into {relPath, stamp}. */
+export declare function listBackups(rootDir: string): BackupEntry[];
+/** Restore an explicit set of backups (the files one run actually wrote).
+ *  Used for failure rollback: restoring "the latest stamp" instead could
+ *  resurrect a PREVIOUS run's backups over files the user has since edited,
+ *  when the failing run dies before writing its own first backup. */
+export declare function restoreBackups(rootDir: string, entries: ReadonlyArray<{
+    relPath: string;
+    backupAbs: string;
+}>): string[];
+/** Restore every file captured under the most recent run. Returns restored paths. */
+export declare function restoreLatest(rootDir: string): string[];
+export {};
+//# sourceMappingURL=backup.d.ts.map

package/dist/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../src/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnF;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAoB1D;AASD;;;qEAGqE;AACrE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7D,MAAM,EAAE,CAQV;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWvD"}

package/dist/backup.js

@@ -0,0 +1,89 @@
+/**
+ * Backups + restore. Before any file is modified, its current bytes are copied
+ * to `.caret/.caretize-bak/<relpath>.<timestamp>.bak`. `--restore` rolls the
+ * most recent run back.
+ *
+ * The timestamp is injected (not read from the clock here) so a single run uses
+ * one consistent stamp across all files and the logic stays deterministic/
+ * testable.
+ */
+import { mkdirSync, copyFileSync, readdirSync, statSync, existsSync, copyFileSync as cp, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+const BAK_DIR = join(".caret", ".caretize-bak");
+function backupRoot(rootDir) {
+    return resolve(rootDir, BAK_DIR);
+}
+/** Absolute backup path for a project-relative file at a given timestamp. */
+function backupPathFor(rootDir, relPath, stamp) {
+    return join(backupRoot(rootDir), `${relPath}.${stamp}.bak`);
+}
+/** Copy the current file to its timestamped backup, creating dirs as needed. */
+export function writeBackup(rootDir, relPath, stamp) {
+    const src = resolve(rootDir, relPath);
+    const dest = backupPathFor(rootDir, relPath, stamp);
+    mkdirSync(dirname(dest), { recursive: true });
+    copyFileSync(src, dest);
+    return dest;
+}
+const BAK_RE = /^(.*)\.([0-9TZ:.\-]+)\.bak$/;
+/** All backups under the backup root, parsed into {relPath, stamp}. */
+export function listBackups(rootDir) {
+    const root = backupRoot(rootDir);
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const walk = (dir) => {
+        for (const name of readdirSync(dir)) {
+            const abs = join(dir, name);
+            if (statSync(abs).isDirectory()) {
+                walk(abs);
+                continue;
+            }
+            const m = BAK_RE.exec(name);
+            if (!m)
+                continue;
+            const relFromRoot = abs.slice(root.length + 1);
+            const relPath = relFromRoot.slice(0, relFromRoot.length - name.length) + m[1];
+            out.push({ relPath: relPath.split("\\").join("/"), stamp: m[2], backupAbs: abs });
+        }
+    };
+    walk(root);
+    return out;
+}
+/** The most recent timestamp present in the backup dir, or null. */
+function latestStamp(rootDir) {
+    const stamps = listBackups(rootDir).map((b) => b.stamp);
+    if (stamps.length === 0)
+        return null;
+    return stamps.sort().at(-1) ?? null;
+}
+/** Restore an explicit set of backups (the files one run actually wrote).
+ *  Used for failure rollback: restoring "the latest stamp" instead could
+ *  resurrect a PREVIOUS run's backups over files the user has since edited,
+ *  when the failing run dies before writing its own first backup. */
+export function restoreBackups(rootDir, entries) {
+    const restored = [];
+    for (const entry of entries) {
+        if (!existsSync(entry.backupAbs))
+            continue;
+        cp(entry.backupAbs, resolve(rootDir, entry.relPath));
+        restored.push(entry.relPath);
+    }
+    return restored;
+}
+/** Restore every file captured under the most recent run. Returns restored paths. */
+export function restoreLatest(rootDir) {
+    const stamp = latestStamp(rootDir);
+    if (!stamp)
+        return [];
+    const restored = [];
+    for (const entry of listBackups(rootDir)) {
+        if (entry.stamp !== stamp)
+            continue;
+        const dest = resolve(rootDir, entry.relPath);
+        cp(entry.backupAbs, dest);
+        restored.push(entry.relPath);
+    }
+    return restored;
+}
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

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

package/dist/bind-collection.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tier-5 (--bind-collections): make `getCollection().map(...)` loops editable.
+ *
+ * Where the other tiers flag a fetched-data loop as "consider a dynamic
+ * collection", this binds the DIRECT-RENDER case in place: a leaf element whose
+ * only dynamic content is `{item.data.field}` gets a dynamic data-caret:
+ *
+ *     <h2>{post.data.title}</h2>
+ *  →  <h2 data-caret={`blog::${post.id}::title`}>{post.data.title}</h2>
+ *
+ * Astro renders the template literal to the concrete `blog::<id>::title` per
+ * iteration, so the inline editor binds each row to its own entry. This is a
+ * PURE attribute insertion (the same splice + re-parse gate as the data-caret
+ * tag pass) — no rewrite of the map callback, nothing deleted, fully invertible.
+ *
+ * Scope (v1): only leaf elements rendering exactly one `item.data.X` and nothing
+ * else. The component-prop case (`<Card title={post.data.title}/>`) needs
+ * cross-file resolution and stays a flag.
+ */
+import { type AstroNode, type TagNode } from "./parse.js";
+export interface CollectionBindTarget {
+    /** Element opening-tag start offset — where the data-caret attribute splices in. */
+    startOffset: number;
+    /** Attribute text to insert, e.g. ``data-caret={`blog::${post.id}::title`}``. */
+    attribute: string;
+    collection: string;
+    field: string;
+    tag: string;
+    /** The loop variable (`posts` in `posts.map(...)`) — lets the CLI suppress the
+     *  "consider a dynamic collection" flag for a loop this tier just covered. */
+    receiver: string;
+    /** `"loop"` for a getCollection().map() row (--bind-collections); `"route"` for
+     *  the current entry of a dynamic detail page (--bind-routes). Only affects how
+     *  the dry-run plan labels the bind. */
+    kind: "loop" | "route";
+}
+export declare const GET_COLLECTION_RE: RegExp;
+/** Concatenated JS text of an expression node's direct text children. */
+export declare function expressionJs(node: AstroNode): string;
+export declare function hasCaretAttr(node: TagNode): boolean;
+/** Does this expression introduce an iterator-callback param named `name`?
+ *  `team.map((post) => …)` rebinds `post` for its subtree — elements inside
+ *  render the iterated row, not whatever outer binding shares the name, so a
+ *  binder holding `name` must treat the subtree as out of scope. */
+export declare function iteratorParamShadows(js: string, name: string): boolean;
+/** If `el` is a leaf element whose only dynamic content is `{<param>.data.<field>}`
+ *  (no literal text, no child elements, exactly one expression), return the field.
+ *  Shared with the route binder (`--bind-routes`), which resolves the same
+ *  single-entry leaf shape from a dynamic detail page's entry variable. */
+export declare function soleDataField(el: TagNode, param: string): string | null;
+/**
+ * Detect direct-render collection-loop bindings. Returns one target per leaf
+ * element rendering `item.data.field` inside a `getCollection(...).map(...)`.
+ */
+export declare function detectCollectionBindTargets(source: string, ast: AstroNode): CollectionBindTarget[];
+//# sourceMappingURL=bind-collection.d.ts.map

package/dist/bind-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-collection.d.ts","sourceRoot":"","sources":["../src/bind-collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAKrE,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;kFAC8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB;;4CAEwC;IACxC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAWD,eAAO,MAAM,iBAAiB,QAC2F,CAAC;AAK1H,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAMpD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAInD;AAED;;;oEAGoE;AACpE,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAItE;AAED;;;2EAG2E;AAC3E,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBvE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,oBAAoB,EAAE,CA2DlG"}

package/dist/bind-collection.js

@@ -0,0 +1,140 @@
+/**
+ * Tier-5 (--bind-collections): make `getCollection().map(...)` loops editable.
+ *
+ * Where the other tiers flag a fetched-data loop as "consider a dynamic
+ * collection", this binds the DIRECT-RENDER case in place: a leaf element whose
+ * only dynamic content is `{item.data.field}` gets a dynamic data-caret:
+ *
+ *     <h2>{post.data.title}</h2>
+ *  →  <h2 data-caret={`blog::${post.id}::title`}>{post.data.title}</h2>
+ *
+ * Astro renders the template literal to the concrete `blog::<id>::title` per
+ * iteration, so the inline editor binds each row to its own entry. This is a
+ * PURE attribute insertion (the same splice + re-parse gate as the data-caret
+ * tag pass) — no rewrite of the map callback, nothing deleted, fully invertible.
+ *
+ * Scope (v1): only leaf elements rendering exactly one `item.data.X` and nothing
+ * else. The component-prop case (`<Card title={post.data.title}/>`) needs
+ * cross-file resolution and stays a flag.
+ */
+import { isTagNode } from "./parse.js";
+import { frontmatterRange } from "./frontmatter.js";
+import { isRewritableTextTag } from "./detect.js";
+import { escapeRe } from "./identifiers.js";
+// `const posts = await getCollection('releases')`, including a chained
+// initializer like `(await getCollection('x')).sort(...)`. The receiver must be
+// the declaration the call actually initializes: an earlier unbounded-lazy form
+// (`=\s*…[\s\S]*?getCollection`) let a PRECEDING declaration steal the capture,
+// binding the wrong variable to the collection — a corrupt permanent storage
+// key. So the initializer must START with the (optionally parenthesized,
+// optionally awaited) call. Indirect shapes (`sortBy(await getCollection(…))`)
+// now yield no binding — a silent miss is safe, a wrong receiver is not.
+// Shared with the route binder (`--bind-routes`).
+export const GET_COLLECTION_RE = /(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*(?:await\s+)?\(?\s*(?:await\s+)?getCollection\(\s*['"]([^'"]+)['"]\s*\)/g;
+// `posts.map((post) => ...` — receiver + the iteration parameter.
+const MAP_RE = /([A-Za-z_$][\w$]*)\s*\.\s*map\s*\(\s*\(?\s*([A-Za-z_$][\w$]*)/;
+/** Concatenated JS text of an expression node's direct text children. */
+export function expressionJs(node) {
+    let out = "";
+    for (const child of node.children ?? []) {
+        if (child.type === "text")
+            out += child.value ?? "";
+    }
+    return out;
+}
+export function hasCaretAttr(node) {
+    return node.attributes?.some((a) => a.name === "data-caret" || a.name === "data-caret-rich") ?? false;
+}
+/** Does this expression introduce an iterator-callback param named `name`?
+ *  `team.map((post) => …)` rebinds `post` for its subtree — elements inside
+ *  render the iterated row, not whatever outer binding shares the name, so a
+ *  binder holding `name` must treat the subtree as out of scope. */
+export function iteratorParamShadows(js, name) {
+    return new RegExp(`\\.\\s*(?:map|filter|forEach|flatMap|reduce)\\s*\\(\\s*\\(?\\s*${escapeRe(name)}(?![\\w$])`).test(js);
+}
+/** If `el` is a leaf element whose only dynamic content is `{<param>.data.<field>}`
+ *  (no literal text, no child elements, exactly one expression), return the field.
+ *  Shared with the route binder (`--bind-routes`), which resolves the same
+ *  single-entry leaf shape from a dynamic detail page's entry variable. */
+export function soleDataField(el, param) {
+    let field = null;
+    for (const child of el.children ?? []) {
+        if (child.type === "text") {
+            if (child.value?.trim())
+                return null; // mixed literal text
+            continue;
+        }
+        if (child.type === "expression") {
+            if (field)
+                return null; // more than one expression
+            const m = new RegExp(`^${param}\\.data\\.([A-Za-z_$][\\w$]*)$`).exec(expressionJs(child).trim());
+            if (!m)
+                return null;
+            field = m[1];
+            continue;
+        }
+        return null; // a nested element/component — not a leaf text element
+    }
+    return field;
+}
+/**
+ * Detect direct-render collection-loop bindings. Returns one target per leaf
+ * element rendering `item.data.field` inside a `getCollection(...).map(...)`.
+ */
+export function detectCollectionBindTargets(source, ast) {
+    const fm = frontmatterRange(source);
+    if (!fm)
+        return [];
+    const collections = new Map(); // receiver var -> collection name
+    const fmText = source.slice(fm.start, fm.end);
+    GET_COLLECTION_RE.lastIndex = 0;
+    let gm;
+    while ((gm = GET_COLLECTION_RE.exec(fmText)))
+        collections.set(gm[1], gm[2]);
+    if (collections.size === 0)
+        return [];
+    const targets = [];
+    const visit = (node, ctx) => {
+        let nextCtx = ctx;
+        if (node.type === "expression") {
+            const js = expressionJs(node);
+            const mm = MAP_RE.exec(js);
+            const collection = mm && collections.get(mm[1]);
+            if (collection && mm) {
+                nextCtx = { collection, param: mm[2], receiver: mm[1] };
+            }
+            else if (ctx && iteratorParamShadows(js, ctx.param)) {
+                // A nested non-collection loop reuses the active param name
+                // (`team.map((post) => …)` inside a `posts.map((post) => …)`): inside
+                // it, `post` is a team row. Binding there would write to the wrong
+                // collection — drop the context for this subtree.
+                nextCtx = null;
+            }
+        }
+        if (nextCtx &&
+            isTagNode(node) &&
+            node.type === "element" &&
+            !hasCaretAttr(node) &&
+            isRewritableTextTag(node.name)) {
+            const field = soleDataField(node, nextCtx.param);
+            const startOffset = node.position?.start.offset ?? -1;
+            if (field && startOffset >= 0) {
+                const value = "`" + nextCtx.collection + "::${" + nextCtx.param + ".id}::" + field + "`";
+                targets.push({
+                    startOffset,
+                    attribute: "data-caret={" + value + "}",
+                    collection: nextCtx.collection,
+                    field,
+                    tag: node.name,
+                    receiver: nextCtx.receiver,
+                    kind: "loop",
+                });
+            }
+        }
+        for (const child of node.children ?? [])
+            visit(child, nextCtx);
+    };
+    visit(ast, null);
+    return targets;
+}
+//# sourceMappingURL=bind-collection.js.map

package/dist/bind-collection.js.map

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

package/dist/bind-route.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Tier-6 (--bind-routes): make a collection DETAIL page (dynamic route) editable.
+ *
+ * A dynamic route like `src/pages/blog/[slug].astro` renders ONE entry, sourced
+ * from `getStaticPaths` props. `deriveScope` skips it ("dynamic-route" — a
+ * template has no single static identity), so the tag pass never touches the
+ * per-entry fields that are the whole point of the page. This binds each leaf
+ * `{entry.data.field}` to the CURRENT entry with a dynamic data-caret — the same
+ * per-iteration template-literal trick as `--bind-collections`, but resolved
+ * through the `getStaticPaths → props → Astro.props` chain instead of a `.map()`
+ * callback:
+ *
+ *   export async function getStaticPaths() {
+ *     const posts = await getCollection('blog');
+ *     return posts.map((post) => ({ params: { slug: post.id }, props: { post } }));
+ *   }
+ *   const { post } = Astro.props;
+ *   ...
+ *   <h1>{post.data.title}</h1>
+ *  → <h1 data-caret={`blog::${post.id}::title`}>{post.data.title}</h1>
+ *
+ * Astro renders the template literal to the concrete `blog::<id>::title` for the
+ * page being built, so each detail page binds to its own entry. PURE attribute
+ * insertion — same splice + re-parse gate as the tag pass, nothing deleted.
+ *
+ * Scope (v1): the single-collection `getStaticPaths`-props shape, leaf elements
+ * rendering exactly one `entry.data.field`. Anything we can't resolve
+ * unambiguously (multiple collections in one `getStaticPaths`, an entry fetched
+ * via `getEntry()` / `Astro.params`, a component-prop field) yields no binding —
+ * never guess at a permanent storage key.
+ */
+import { type AstroNode } from "./parse.js";
+import { type CollectionBindTarget } from "./bind-collection.js";
+/**
+ * Detect current-entry bindings on a dynamic collection-detail route. Returns one
+ * target per leaf element rendering `entry.data.field`, or `[]` when the route's
+ * entry source can't be resolved unambiguously.
+ */
+export declare function detectRouteBindTargets(source: string, ast: AstroNode): CollectionBindTarget[];
+//# sourceMappingURL=bind-route.d.ts.map

package/dist/bind-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind-route.d.ts","sourceRoot":"","sources":["../src/bind-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,EACL,KAAK,oBAAoB,EAM1B,MAAM,sBAAsB,CAAC;AAmE9B;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,SAAS,GACb,oBAAoB,EAAE,CA6CxB"}

package/dist/bind-route.js

@@ -0,0 +1,150 @@
+/**
+ * Tier-6 (--bind-routes): make a collection DETAIL page (dynamic route) editable.
+ *
+ * A dynamic route like `src/pages/blog/[slug].astro` renders ONE entry, sourced
+ * from `getStaticPaths` props. `deriveScope` skips it ("dynamic-route" — a
+ * template has no single static identity), so the tag pass never touches the
+ * per-entry fields that are the whole point of the page. This binds each leaf
+ * `{entry.data.field}` to the CURRENT entry with a dynamic data-caret — the same
+ * per-iteration template-literal trick as `--bind-collections`, but resolved
+ * through the `getStaticPaths → props → Astro.props` chain instead of a `.map()`
+ * callback:
+ *
+ *   export async function getStaticPaths() {
+ *     const posts = await getCollection('blog');
+ *     return posts.map((post) => ({ params: { slug: post.id }, props: { post } }));
+ *   }
+ *   const { post } = Astro.props;
+ *   ...
+ *   <h1>{post.data.title}</h1>
+ *  → <h1 data-caret={`blog::${post.id}::title`}>{post.data.title}</h1>
+ *
+ * Astro renders the template literal to the concrete `blog::<id>::title` for the
+ * page being built, so each detail page binds to its own entry. PURE attribute
+ * insertion — same splice + re-parse gate as the tag pass, nothing deleted.
+ *
+ * Scope (v1): the single-collection `getStaticPaths`-props shape, leaf elements
+ * rendering exactly one `entry.data.field`. Anything we can't resolve
+ * unambiguously (multiple collections in one `getStaticPaths`, an entry fetched
+ * via `getEntry()` / `Astro.params`, a component-prop field) yields no binding —
+ * never guess at a permanent storage key.
+ */
+import { isTagNode } from "./parse.js";
+import { frontmatterRange } from "./frontmatter.js";
+import { GET_COLLECTION_RE, expressionJs, hasCaretAttr, iteratorParamShadows, soleDataField, } from "./bind-collection.js";
+import { isRewritableTextTag } from "./detect.js";
+// `posts.map((post) => ...` — receiver + the iteration parameter.
+const MAP_PARAM_RE = /([A-Za-z_$][\w$]*)\s*\.\s*map\s*\(\s*\(?\s*([A-Za-z_$][\w$]*)/g;
+/** A standalone identifier inside an object/destructure body (shorthand key). */
+function shorthand(name) {
+    return new RegExp(`(?:^|[{,\\s])${name}(?:\\s*[,}]|\\s*$)`);
+}
+/**
+ * Resolve the template's current-entry variable and its collection from the
+ * frontmatter, or null when the shape isn't the supported single-entry route.
+ */
+function resolveEntryBinding(fmText) {
+    // 1. collections declared anywhere in the frontmatter (getStaticPaths included).
+    const collections = new Map(); // receiver var -> collection name
+    GET_COLLECTION_RE.lastIndex = 0;
+    let gm;
+    while ((gm = GET_COLLECTION_RE.exec(fmText)))
+        collections.set(gm[1], gm[2]);
+    if (collections.size === 0)
+        return null;
+    // 2. the map parameter tied to a collection receiver: posts.map((post) => ...).
+    //    Bail on any ambiguity (two collections mapped) — never guess.
+    let collection = null;
+    let param = null;
+    MAP_PARAM_RE.lastIndex = 0;
+    let mm;
+    while ((mm = MAP_PARAM_RE.exec(fmText))) {
+        const col = collections.get(mm[1]);
+        if (!col)
+            continue;
+        if (collection && (collection !== col || param !== mm[2]))
+            return null;
+        collection = col;
+        param = mm[2];
+    }
+    if (!collection || !param)
+        return null;
+    // 3. which prop key carries the entry? props: { entry: post } | props: { post }.
+    const propsObj = /\bprops\s*:\s*\{([^}]*)\}/.exec(fmText);
+    if (!propsObj)
+        return null;
+    const propsInner = propsObj[1];
+    const explicit = new RegExp(`([A-Za-z_$][\\w$]*)\\s*:\\s*${param}\\b`).exec(propsInner);
+    const propKey = explicit
+        ? explicit[1]
+        : shorthand(param).test(propsInner)
+            ? param
+            : null;
+    if (!propKey)
+        return null;
+    // 4. the template variable: const { <propKey> } = Astro.props (rename allowed).
+    const destruct = /\bconst\s*\{([^}]*)\}\s*=\s*Astro\.props/.exec(fmText);
+    if (!destruct)
+        return null;
+    const dInner = destruct[1];
+    const rename = new RegExp(`\\b${propKey}\\s*:\\s*([A-Za-z_$][\\w$]*)`).exec(dInner);
+    const entryVar = rename
+        ? rename[1]
+        : shorthand(propKey).test(dInner)
+            ? propKey
+            : null;
+    if (!entryVar)
+        return null;
+    return { collection, entryVar };
+}
+/**
+ * Detect current-entry bindings on a dynamic collection-detail route. Returns one
+ * target per leaf element rendering `entry.data.field`, or `[]` when the route's
+ * entry source can't be resolved unambiguously.
+ */
+export function detectRouteBindTargets(source, ast) {
+    const fm = frontmatterRange(source);
+    if (!fm)
+        return [];
+    const resolved = resolveEntryBinding(source.slice(fm.start, fm.end));
+    if (!resolved)
+        return [];
+    const { collection, entryVar } = resolved;
+    const targets = [];
+    const visit = (node, shadowed) => {
+        let nextShadowed = shadowed;
+        // A template loop whose callback param reuses the entry variable's name
+        // (`{team.map((post) => <li>{post.data.name}</li>)}` on a page whose entry
+        // var is `post`) shadows it: inside, `post` is the iterated row. Binding
+        // there would write to the wrong collection — skip the whole subtree.
+        if (!nextShadowed && node.type === "expression" &&
+            iteratorParamShadows(expressionJs(node), entryVar)) {
+            nextShadowed = true;
+        }
+        if (!nextShadowed &&
+            isTagNode(node) &&
+            node.type === "element" &&
+            !hasCaretAttr(node) &&
+            isRewritableTextTag(node.name)) {
+            const field = soleDataField(node, entryVar);
+            const startOffset = node.position?.start.offset ?? -1;
+            if (field && startOffset >= 0) {
+                const value = "`" + collection + "::${" + entryVar + ".id}::" + field + "`";
+                targets.push({
+                    startOffset,
+                    attribute: "data-caret={" + value + "}",
+                    collection,
+                    field,
+                    tag: node.name,
+                    receiver: entryVar,
+                    kind: "route",
+                });
+            }
+        }
+        for (const child of node.children ?? [])
+            visit(child, nextShadowed);
+    };
+    visit(ast, false);
+    return targets;
+}
+//# sourceMappingURL=bind-route.js.map

package/dist/bind-route.js.map

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

package/dist/cli-args.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Argument parsing + help text for the caretize CLI. Pure and process-free: on a
+ * bad flag it throws `CliUsageError` rather than calling process.exit, so the
+ * parser is unit-testable and cli.ts owns the actual exit. Keeping this out of
+ * cli.ts also keeps that file a thin orchestration shell.
+ */
+import type { Confidence } from "./detect.js";
+import { type Scope } from "./name.js";
+export interface Args {
+    target?: string;
+    dryRun: boolean;
+    yes: boolean;
+    minConfidence: Confidence;
+    noImages: boolean;
+    rich: boolean;
+    noProps: boolean;
+    bindCollections: boolean;
+    bindRoutes: boolean;
+    scope?: Scope;
+    report?: string;
+    restore: boolean;
+    help: boolean;
+    version: boolean;
+}
+/** Thrown on an invalid invocation; cli.ts maps it to a stderr message + exit 2. */
+export declare class CliUsageError extends Error {
+}
+export declare const HELP = "caretize \u00B7 make an Astro project editable (data-caret + editable())\n\nUsage: caretize [path] [options]\n\n  path                     file or directory to scan (default: src/)\n  --dry-run                print the plan, write nothing\n  -y, --yes                auto-accept all suggestions at/above min-confidence\n  --min-confidence <lvl>   high (default) | medium | low\n  --no-images              skip <img> elements\n  --no-props               skip hoisting static component-prop strings to editable()\n  --bind-collections       bind getCollection().map() loops in place \u2014 a leaf\n                           element rendering {item.data.field} gets a per-row\n                           data-caret (direct-render only; props stay flagged)\n  --bind-routes            bind a dynamic collection-detail route to the current\n                           entry \u2014 a leaf rendering {entry.data.field} (entry from\n                           getStaticPaths props) gets a data-caret instead of the\n                           page being skipped as a dynamic route\n  --rich                   also tag mixed-content blocks whose markup is\n                           sanitizer-safe inline formatting (data-caret-rich)\n  --scope <collection::id> override the inferred scope\n  --report <file>          write a JSON report\n  --restore                restore the most recent backup, then exit\n  -h, --help               show this help\n  -v, --version            print version\n";
+export declare function parseArgs(argv: string[]): Args;
+//# sourceMappingURL=cli-args.d.ts.map