@caretcms/caretize 0.1.0 → 0.1.2

package/dist/frontmatter.d.ts

@@ -3,7 +3,10 @@
  * 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. */
+/** Inner content range of the frontmatter fence, or null if there is none.
+ *  Tolerates a leading UTF-8 BOM — the compiler does too, and a bare
+ *  startsWith("---") used to silently disable every frontmatter tier for
+ *  BOM-prefixed files. */
 export declare function frontmatterRange(source: string): {
     start: number;
     end: number;
@@ -15,12 +18,46 @@ 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}`.
+ * imports (`import * as`), `import type`, and bare/package specifiers are excluded,
+ * because their value shape can't be assumed safe to stega-encode. Relative/aliased
+ * extensionless paths (`../data/site`) ARE included — see {@link classifyDataSpecifier}.
+ * `import faqs from "./data/faqs.json"` → `faqs → {json}`.
  */
 export declare function importBindingNames(fmText: string): Map<string, {
     specifier: string;
     importKind: ImportKind;
 }>;
+/**
+ * NAMED-import bindings whose data could be wrapped with `editable()`, mapped to
+ * their specifier + kind. The named counterpart to {@link importBindingNames}:
+ * `import { services } from "../data/site.ts"` → `services → {module}`.
+ *
+ * Same specifier filter (relative `.json`/JS-TS module only). Handles multiple
+ * bindings per statement (`import { a, b }`), an inline `type` specifier
+ * (`import { type T, a }` → only `a`), and a leading default binding
+ * (`import def, { a }` → the named half). Namespace imports and `import type {…}`
+ * are excluded.
+ *
+ * IMPORTANT — pre-aliased bindings are SKIPPED. A binding already written as
+ * `X as Y` was renamed deliberately, and the named-import wrapper renames by
+ * inserting ` as <raw>` after the local name; doing that to an aliased binding
+ * would emit `{ X as Y as Yraw }` (invalid JS). So `import { data as items }`
+ * yields nothing here.
+ */
+export declare function namedImportBindingNames(fmText: string): Map<string, {
+    specifier: string;
+    importKind: ImportKind;
+}>;
+/**
+ * Local names that `astro:assets` `Image`/`Picture` are imported under, e.g.
+ * `import { Image, Picture as Pic } from "astro:assets"` → `{"Image","Pic"}`.
+ *
+ * Used by `detect.ts` to recognize these components (which render to a native
+ * `<img>` Astro forwards `data-caret` to) instead of skipping them as opaque
+ * components. The specifier must be exactly `"astro:assets"`, so a user's own
+ * `import { Image } from "./my-image"` is NOT matched. Unlike data-import
+ * wrapping, aliasing is fine here — we only need the local name to match against,
+ * nothing is renamed.
+ */
+export declare function imageComponentNames(fmText: string): Set<string>;
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;0BAG0B;AAC1B,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQtF;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;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC,CAW5D;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAC,CAmB5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAoB/D"}

package/dist/frontmatter.js

@@ -3,9 +3,13 @@
  * 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. */
+/** Inner content range of the frontmatter fence, or null if there is none.
+ *  Tolerates a leading UTF-8 BOM — the compiler does too, and a bare
+ *  startsWith("---") used to silently disable every frontmatter tier for
+ *  BOM-prefixed files. */
 export function frontmatterRange(source) {
-    if (!source.startsWith("---"))
+    const fenceAt = source.charCodeAt(0) === 0xfeff ? 1 : 0;
+    if (!source.startsWith("---", fenceAt))
         return null;
     const firstNL = source.indexOf("\n");
     if (firstNL < 0)
@@ -28,9 +32,10 @@ export function literalConstNames(fmText) {
  * 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}`.
+ * imports (`import * as`), `import type`, and bare/package specifiers are excluded,
+ * because their value shape can't be assumed safe to stega-encode. Relative/aliased
+ * extensionless paths (`../data/site`) ARE included — see {@link classifyDataSpecifier}.
+ * `import faqs from "./data/faqs.json"` → `faqs → {json}`.
  */
 export function importBindingNames(fmText) {
     const out = new Map();
@@ -38,15 +43,120 @@ export function importBindingNames(fmText) {
     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
+        const importKind = classifyDataSpecifier(spec);
+        if (!importKind)
+            continue; // bare/package or extensionless — shape unknown
         out.set(name, { specifier: spec, importKind });
     }
     return out;
 }
+/**
+ * Shared specifier filter → the data kind, or null when the shape can't be assumed.
+ * A `.json` file is `json`; a JS/TS module file is `module`; a relative or aliased
+ * EXTENSIONLESS path (the user's own `../data/site`, `@/data/site`) is treated as a
+ * `module` too — the most common way data files are actually imported. Bare package
+ * specifiers (`react`, `@scope/pkg`) and non-data extensions (`.astro`, `.css`,
+ * `.png`) stay null. The real wrap safety is enforced downstream by
+ * `classifyConstUsage` on the AST, not by this specifier shape.
+ */
+function classifyDataSpecifier(spec) {
+    if (/\.json$/.test(spec))
+        return "json";
+    if (/\.(?:js|ts|mjs|cjs|mts|cts)$/.test(spec))
+        return "module";
+    if (isExtensionlessLocalPath(spec))
+        return "module";
+    return null;
+}
+/**
+ * A relative (`./`, `../`) or common-alias (`~/`, `@/`) path whose last segment has
+ * no file extension — i.e. a local JS/TS module imported by its extensionless path
+ * (`../data/site`). Excludes bare packages and any path ending in `.ext` (those are
+ * handled by the explicit extension checks above, or intentionally left out).
+ */
+function isExtensionlessLocalPath(spec) {
+    const isLocal = spec.startsWith("./") ||
+        spec.startsWith("../") ||
+        spec.startsWith("~/") ||
+        spec.startsWith("@/");
+    if (!isLocal)
+        return false;
+    const lastSegment = spec.slice(spec.lastIndexOf("/") + 1);
+    return lastSegment.length > 0 && !lastSegment.includes(".");
+}
+/**
+ * NAMED-import bindings whose data could be wrapped with `editable()`, mapped to
+ * their specifier + kind. The named counterpart to {@link importBindingNames}:
+ * `import { services } from "../data/site.ts"` → `services → {module}`.
+ *
+ * Same specifier filter (relative `.json`/JS-TS module only). Handles multiple
+ * bindings per statement (`import { a, b }`), an inline `type` specifier
+ * (`import { type T, a }` → only `a`), and a leading default binding
+ * (`import def, { a }` → the named half). Namespace imports and `import type {…}`
+ * are excluded.
+ *
+ * IMPORTANT — pre-aliased bindings are SKIPPED. A binding already written as
+ * `X as Y` was renamed deliberately, and the named-import wrapper renames by
+ * inserting ` as <raw>` after the local name; doing that to an aliased binding
+ * would emit `{ X as Y as Yraw }` (invalid JS). So `import { data as items }`
+ * yields nothing here.
+ */
+export function namedImportBindingNames(fmText) {
+    const out = new Map();
+    // Optional leading default binding (`def,`) then the `{ … }` named group.
+    const re = /\bimport\s+(?!type\b)(?:[A-Za-z_$][\w$]*\s*,\s*)?\{([^}]+)\}\s+from\s*['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = re.exec(fmText))) {
+        const importKind = classifyDataSpecifier(m[2]);
+        if (!importKind)
+            continue;
+        for (const raw of m[1].split(",")) {
+            const token = raw.trim();
+            if (!token)
+                continue;
+            if (/\bas\b/.test(token))
+                continue; // pre-aliased — skip (see doc above)
+            if (/^type\b/.test(token))
+                continue; // inline `type` specifier
+            if (!/^[A-Za-z_$][\w$]*$/.test(token))
+                continue;
+            out.set(token, { specifier: m[2], importKind });
+        }
+    }
+    return out;
+}
+/**
+ * Local names that `astro:assets` `Image`/`Picture` are imported under, e.g.
+ * `import { Image, Picture as Pic } from "astro:assets"` → `{"Image","Pic"}`.
+ *
+ * Used by `detect.ts` to recognize these components (which render to a native
+ * `<img>` Astro forwards `data-caret` to) instead of skipping them as opaque
+ * components. The specifier must be exactly `"astro:assets"`, so a user's own
+ * `import { Image } from "./my-image"` is NOT matched. Unlike data-import
+ * wrapping, aliasing is fine here — we only need the local name to match against,
+ * nothing is renamed.
+ */
+export function imageComponentNames(fmText) {
+    const out = new Set();
+    let m;
+    // Named (incl. a leading default binding): import [Def,] { Image, … } from "astro:assets"
+    const named = /\bimport\s+(?!type\b)(?:[A-Za-z_$][\w$]*\s*,\s*)?\{([^}]+)\}\s+from\s*['"]astro:assets['"]/g;
+    while ((m = named.exec(fmText))) {
+        for (const raw of m[1].split(",")) {
+            const token = raw.trim();
+            if (!token || /^type\b/.test(token))
+                continue;
+            // `Image as Img` → local name is the alias; plain `Image` → itself.
+            const aliased = /^[A-Za-z_$][\w$]*\s+as\s+([A-Za-z_$][\w$]*)$/.exec(token);
+            const local = aliased ? aliased[1] : token;
+            if (/^[A-Za-z_$][\w$]*$/.test(local))
+                out.add(local);
+        }
+    }
+    // Default (rare/legacy): import Image from "astro:assets"
+    const def = /\bimport\s+(?!type\b)([A-Za-z_$][\w$]*)\s+from\s*['"]astro:assets['"]/g;
+    while ((m = def.exec(fmText)))
+        out.add(m[1]);
+    return out;
+}
 //# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/import-wrap.d.ts

@@ -41,16 +41,46 @@ export interface ImportWrapCandidate {
  * suffix and a new const line is inserted; nothing is deleted.
  */
 export declare function wrapImport(source: string, varName: string, key: string): WrapResult;
+/**
+ * Rebind a NAMED imported `varName` to `await editable("<key>", <varName>Raw)`,
+ * renaming the binding inside the destructure to the raw name. Pure insertion:
+ * the destructure gains ` as <raw>` after the local name and a new const line
+ * follows the statement; nothing is deleted.
+ *
+ *   import { services } from "../data/site.ts";
+ *     →  import { services as servicesRaw } from "../data/site.ts";
+ *        const services = await editable("…", servicesRaw);
+ *
+ * Multi-binding-safe: called once per binding, threading the mutated source
+ * forward. After `services` is renamed, the statement reads
+ * `{ services as servicesRaw, team }`; the next call locates `team` by
+ * whole-identifier match, never inside `servicesRaw`.
+ */
+export declare function wrapNamedImport(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[];
+/**
+ * Tier-3 named variant: NAMED imports (`import { services } from "./data.ts"`)
+ * `.map()`'d in the template. Same scope/key/idempotency logic as the default
+ * detector — only the binding resolver differs ({@link namedImportBindingNames}).
+ */
+export declare function detectNamedImportWrapCandidates(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[]>;
+/**
+ * Safety-checked Tier-3 named-import detection: the named counterpart to
+ * {@link detectImportWrapTargetsSafe}. Same `classifyConstUsage` gate — a named
+ * import whose fields flow into a native-element attribute stays UNSAFE and
+ * unwrapped. Targets carry `origin: "named-import"` so `run.ts` routes them to
+ * {@link wrapNamedImport}.
+ */
+export declare function detectNamedImportWrapTargetsSafe(source: string, relPath: string, root?: AstroNode): Promise<WrapTarget[]>;
 //# sourceMappingURL=import-wrap.d.ts.map

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

@@ -1 +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"}
+{"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,EAIL,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;AAYD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAuDnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CA8DxF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,mBAAmB,EAAE,CAEvB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,mBAAmB,EAAE,CAEvB;AAgDD;;;;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;AAED;;;;;;GAMG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAOvB"}

package/dist/import-wrap.js

@@ -24,14 +24,15 @@
 import { deriveScope, isValidField, slugifyText } from "./name.js";
 import { parseAstro } from "./parse.js";
 import { classifyConstUsage } from "./usage.js";
-import { frontmatterRange, importBindingNames, } from "./frontmatter.js";
-import { isIdentifier } from "./identifiers.js";
+import { frontmatterRange, importBindingNames, namedImportBindingNames, } from "./frontmatter.js";
+import { escapeRe, identRefRe, isIdentifier } from "./identifiers.js";
 import { IMPORT_LINE, IMPORT_RE } from "./wrap.js";
 /** Pick a non-colliding suffixed name for the raw (pre-editable) import binding. */
 function rawNameFor(source, varName) {
     for (const suffix of ["Raw", "Source", "Data"]) {
         const candidate = `${varName}${suffix}`;
-        if (!new RegExp(`\\b${candidate}\\b`).test(source))
+        // identRefRe: $-aware boundaries + escaping (`\b$faqsRaw\b` never matches).
+        if (!identRefRe(candidate).test(source))
             return candidate;
     }
     return null;
@@ -50,10 +51,10 @@ export function wrapImport(source, varName, key) {
         return { output: source, ok: false, reason: "no frontmatter block" };
     const fmText = source.slice(fm.start, fm.end);
     // Idempotent: bail if this binding is already an editable() rebind.
-    if (new RegExp(`\\bconst\\s+${varName}\\s*=\\s*await\\s+editable\\s*\\(`).test(fmText)) {
+    if (new RegExp(`\\bconst\\s+${escapeRe(varName)}\\s*=\\s*await\\s+editable\\s*\\(`).test(fmText)) {
         return { output: source, ok: true, alreadyWrapped: true };
     }
-    const importRe = new RegExp(`\\bimport\\s+(?!type\\b)(${varName})\\s+from\\s*['"][^'"]+['"]`);
+    const importRe = new RegExp(`\\bimport\\s+(?!type\\b)(${escapeRe(varName)})\\s+from\\s*['"][^'"]+['"]`);
     const m = importRe.exec(fmText);
     if (!m) {
         return { output: source, ok: false, reason: `default import of ${varName} not found` };
@@ -85,18 +86,95 @@ export function wrapImport(source, varName, key) {
     }
     return { output, ok: true };
 }
+/**
+ * Rebind a NAMED imported `varName` to `await editable("<key>", <varName>Raw)`,
+ * renaming the binding inside the destructure to the raw name. Pure insertion:
+ * the destructure gains ` as <raw>` after the local name and a new const line
+ * follows the statement; nothing is deleted.
+ *
+ *   import { services } from "../data/site.ts";
+ *     →  import { services as servicesRaw } from "../data/site.ts";
+ *        const services = await editable("…", servicesRaw);
+ *
+ * Multi-binding-safe: called once per binding, threading the mutated source
+ * forward. After `services` is renamed, the statement reads
+ * `{ services as servicesRaw, team }`; the next call locates `team` by
+ * whole-identifier match, never inside `servicesRaw`.
+ */
+export function wrapNamedImport(source, varName, key) {
+    if (!isIdentifier(varName)) {
+        return { output: source, ok: false, reason: `invalid identifier: ${varName}` };
+    }
+    const fm = frontmatterRange(source);
+    if (!fm)
+        return { output: source, ok: false, reason: "no frontmatter block" };
+    const fmText = source.slice(fm.start, fm.end);
+    // Idempotent: bail if this binding is already an editable() rebind.
+    if (new RegExp(`\\bconst\\s+${escapeRe(varName)}\\s*=\\s*await\\s+editable\\s*\\(`).test(fmText)) {
+        return { output: source, ok: true, alreadyWrapped: true };
+    }
+    // Locate the named-import statement that contains `varName` as a whole
+    // identifier inside its `{ … }` (lookbehind/ahead keep it off `varNameRaw`).
+    const stmtRe = new RegExp(`\\bimport\\s+(?!type\\b)(?:[A-Za-z_$][\\w$]*\\s*,\\s*)?` +
+        `\\{[^}]*(?<![\\w$])${escapeRe(varName)}(?![\\w$])[^}]*\\}\\s+from\\s*['"][^'"]+['"]`);
+    const m = stmtRe.exec(fmText);
+    if (!m) {
+        return { output: source, ok: false, reason: `named import of ${varName} not found` };
+    }
+    // Position of the binding within the matched statement (first whole-word hit;
+    // the `{ … }` precedes the specifier, so this lands inside the destructure).
+    const inner = identRefRe(varName).exec(m[0]);
+    if (!inner) {
+        return { output: source, ok: false, reason: `could not locate ${varName} in import` };
+    }
+    const rawName = rawNameFor(source, varName);
+    if (!rawName) {
+        return { output: source, ok: false, reason: `could not pick a free name for ${varName}` };
+    }
+    const identEndRel = m.index + inner.index + varName.length;
+    let stmtEndRel = m.index + m[0].length;
+    if (fmText[stmtEndRel] === ";")
+        stmtEndRel++;
+    const identEndAbs = fm.start + identEndRel;
+    const stmtEndAbs = fm.start + stmtEndRel;
+    const aliasSuffix = ` as ${rawName}`;
+    const constLine = `\nconst ${varName} = await editable(${JSON.stringify(key)}, ${rawName});`;
+    // Two pure insertions: the destructure binding gains ` as <raw>`, and a new
+    // const line follows the import statement.
+    let output = source.slice(0, identEndAbs) +
+        aliasSuffix +
+        source.slice(identEndAbs, stmtEndAbs) +
+        constLine +
+        source.slice(stmtEndAbs);
+    if (!IMPORT_RE.test(source)) {
+        output = output.slice(0, fm.start) + IMPORT_LINE + "\n" + output.slice(fm.start);
+    }
+    return { output, ok: true };
+}
 /**
  * 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 function detectImportWrapCandidates(source, relPath) {
+    return detectMappedImportCandidates(source, relPath, importBindingNames);
+}
+/**
+ * Tier-3 named variant: NAMED imports (`import { services } from "./data.ts"`)
+ * `.map()`'d in the template. Same scope/key/idempotency logic as the default
+ * detector — only the binding resolver differs ({@link namedImportBindingNames}).
+ */
+export function detectNamedImportWrapCandidates(source, relPath) {
+    return detectMappedImportCandidates(source, relPath, namedImportBindingNames);
+}
+/** Shared core: resolve import bindings via `resolve`, keep the `.map()`'d ones. */
+function detectMappedImportCandidates(source, relPath, resolve) {
     const fm = frontmatterRange(source);
     if (!fm)
         return [];
     const fmText = source.slice(fm.start, fm.end);
     const template = source.slice(fm.end);
-    const imports = importBindingNames(fmText);
+    const imports = resolve(fmText);
     if (imports.size === 0)
         return [];
     // Of the imported bindings, the ones actually iterated in the template.
@@ -116,7 +194,7 @@ export function detectImportWrapCandidates(source, relPath) {
     const candidates = [];
     for (const varName of mapped) {
         // Already rebound on a prior run → not a candidate.
-        if (new RegExp(`\\bconst\\s+${varName}\\s*=\\s*await\\s+editable\\s*\\(`).test(fmText)) {
+        if (new RegExp(`\\bconst\\s+${escapeRe(varName)}\\s*=\\s*await\\s+editable\\s*\\(`).test(fmText)) {
             continue;
         }
         const field = isValidField(varName) ? varName : slugifyText(varName);
@@ -146,4 +224,20 @@ export async function detectImportWrapTargetsSafe(source, relPath, root) {
         .filter((c) => classifyConstUsage(ast, c.varName).safe)
         .map((c) => ({ varName: c.varName, key: c.key, origin: "import" }));
 }
+/**
+ * Safety-checked Tier-3 named-import detection: the named counterpart to
+ * {@link detectImportWrapTargetsSafe}. Same `classifyConstUsage` gate — a named
+ * import whose fields flow into a native-element attribute stays UNSAFE and
+ * unwrapped. Targets carry `origin: "named-import"` so `run.ts` routes them to
+ * {@link wrapNamedImport}.
+ */
+export async function detectNamedImportWrapTargetsSafe(source, relPath, root) {
+    const candidates = detectNamedImportWrapCandidates(source, relPath);
+    if (candidates.length === 0)
+        return [];
+    const ast = root ?? (await parseAstro(source));
+    return candidates
+        .filter((c) => classifyConstUsage(ast, c.varName).safe)
+        .map((c) => ({ varName: c.varName, key: c.key, origin: "named-import" }));
+}
 //# sourceMappingURL=import-wrap.js.map

package/dist/import-wrap.js.map

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

package/dist/init.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Pure helpers for `caretize init` — the one command that wires CaretCMS into an
+ * Astro project so tagging actually makes content editable (the gap preflight
+ * only *warns* about today). Kept process-free and side-effect-free so the
+ * load-bearing logic — editing an existing astro.config, scaffolding .env — is
+ * unit-testable; cli.ts owns the readline I/O, the npm install, and disk writes.
+ *
+ * Config editing mirrors caretize's write contract: every edit is a PURE
+ * INSERTION of the original bytes (verified by a subsequence check), so an edit
+ * can add to a config but never delete or reorder what's there. When the config
+ * shape isn't one we can touch confidently, planConfigWiring returns ok:false
+ * and the caller falls back to printing a snippet to paste — never a silent
+ * corruption.
+ */
+export type InitMode = "static" | "server";
+/** A complete, minimal embedded-mode config — written verbatim when a project
+ *  has no astro.config at all, and shown as the paste-me snippet when an
+ *  existing config is too complex to edit safely. */
+export declare function freshConfig(mode?: InitMode): string;
+/** What's missing from the config and therefore needs wiring in. Computed by the
+ *  caller from preflight + a scan for an existing `adapter:` key. */
+export interface WiringNeeds {
+    /** caret() not referenced — add the import + an integrations entry. */
+    caret: boolean;
+    /** No `adapter:` configured and server mode was selected — add @astrojs/node. */
+    adapter: boolean;
+    /** output isn't "server" and server mode was selected — add output: 'server'. */
+    output: boolean;
+    /** Static sites use caret({ delivery: "static" }) rather than SSR wiring. */
+    staticDelivery: boolean;
+}
+export interface WiringResult {
+    /** The edited config (=== source when nothing could be inserted). */
+    output: string;
+    /** Human-readable list of what was inserted, for the closing summary. */
+    inserted: string[];
+    /** Things we deliberately did NOT auto-apply (would require a replacement,
+     *  not an insertion) — surfaced so the user fixes them by hand. */
+    manual: string[];
+    /** false → the config shape wasn't recognized; caller should fall back to the
+     *  paste-me snippet rather than write a half-edited file. */
+    ok: boolean;
+}
+/** Index of the `{` that opens the config object — defineConfig({…}) preferred,
+ *  bare `export default {…}` accepted. null when neither shape is present. */
+export declare function findConfigObjectBrace(source: string): number | null;
+/**
+ * Plan the edits that wire caret() / the adapter / output into an EXISTING
+ * config. Returns the edited text plus what was inserted vs. what needs manual
+ * attention. All edits are pure insertions; the result is subsequence-verified
+ * against the source, and any failure (unrecognized shape, verification miss)
+ * yields ok:false so the caller prints a snippet instead.
+ */
+export declare function planConfigWiring(source: string, needs: WiringNeeds): WiringResult;
+/**
+ * Plan additions to a project's .env. Generates nothing itself — the caller
+ * passes a freshly-generated `secret` (mirrors backup.ts injecting its
+ * timestamp), keeping this deterministic and testable. Existing keys (commented
+ * or not) are never touched, so re-running init is idempotent.
+ *
+ * CARET_SESSION_SECRET is a machine secret → generated outright. The edit
+ * password is left as a COMMENTED placeholder so dev keeps printing a temp
+ * password (an empty value would suppress that), while still reminding the user
+ * to set one before deploying.
+ */
+export declare function renderEnvAdditions(existing: string, secret: string): {
+    append: string;
+    added: string[];
+};
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAM3C;;qDAEqD;AACrD,wBAAgB,WAAW,CAAC,IAAI,GAAE,QAAmB,GAAG,MAAM,CAuB7D;AAED;qEACqE;AACrE,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;uEACmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;iEAC6D;IAC7D,EAAE,EAAE,OAAO,CAAC;CACb;AAED;8EAC8E;AAC9E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMnE;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAyFjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBrC"}