@bettercms-ai/convert 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -283,9 +283,15 @@ interface DynamicBinding {
  * later reason may name the wrong cause. `TSCONFIG_UNREADABLE` is the first — a project config this
  * package could not parse declares no `paths` aliases as far as it is concerned, so every aliased
  * import resolves to nothing and the component behind it reads as one the page does not import.
+ *
+ * `PRIMITIVE_LIST` is the second, and it is about a CONVERSION rather than a silence: an array of
+ * primitives or tuples renders exactly the paths the codemod wrote into it, so every row's text is
+ * editable and the NUMBER of rows is still the template's — a row added in the CMS does not appear
+ * and a deleted one falls back to the template's own copy. The paths are `rewritten` and true; what
+ * the note adds is that ceiling. @see bindLists
  */
 interface ReceiptNote {
-    code: "TSCONFIG_UNREADABLE";
+    code: "TSCONFIG_UNREADABLE" | "TSCONFIG_EXTENDS_ONLY" | "PRIMITIVE_LIST";
     file: string;
     message: string;
 }
@@ -716,7 +722,7 @@ declare function attrsFor(path: string, kind: string, props?: AttrBinding[], sco
 declare function propsAttribute(props: AttrBinding[]): string;
 
 /** Bumped whenever the emitted source changes. `isKnownHelper` upgrades anything older. */
-declare const HELPER_VERSION = 5;
+declare const HELPER_VERSION = 6;
 /** Where each dialect's helper lives. Null = this dialect reads nothing at build time. */
 declare const HELPER_PATH: Record<Dialect, string | null>;
 /** The directory the snapshots live in, at the repository root. */
@@ -794,18 +800,41 @@ interface DataSplice {
     end: number;
     text: string;
 }
+/** What one drill did, or why it could not. @see drillProp, which is the implementation. */
+type DrillOutcome = {
+    ok: true;
+    edits: {
+        file: string;
+        splices: DataSplice[];
+    }[];
+} | {
+    ok: false;
+    reason: PendingReason;
+};
 interface DataContext {
     content: string;
     parsed: ParsedFile;
     dialect: Dialect;
     /** The name `bcmsRowsAs` is imported under here. @see scope.ts */
     rowsAs: string;
+    /** The names `bcmsList` and `bcmsTuples` are imported under here. @see bindLists */
+    list: string;
+    tuples: string;
     /** The name `bcms` is imported under here — the scalar lane's read. @see scope.ts */
     read: string;
     /** The identifier a page's snapshot is imported under in this file. @see scope.ts */
     snapshotName: (slug: string) => string;
     /** How this file reads its route parameter, on a dynamic route. Null off one. */
     slug: string | null;
+    /**
+     * Follow one prop from a call site in THIS file into the component that renders it.
+     *
+     * Handed in rather than imported: the drill needs every source file, the alias table and the set
+     * of files this conversion already rewrites, and none of that is one file's business. Absent on
+     * a caller that cannot drill (the tests of this lane alone), which makes a row leaf passed as a
+     * prop the refusal it was before. @see index.ts
+     */
+    drill?: (component: string, prop: string, kind: string) => Promise<DrillOutcome>;
 }
 interface DataResult {
     splices: DataSplice[];
@@ -813,6 +842,16 @@ interface DataResult {
     usesRead: boolean;
     /** Did anything here write a `bcmsRowsAs(…)` read? */
     usesRows: boolean;
+    /** Did anything here write a `bcmsList(…)` / `bcmsTuples(…)` read? @see bindLists */
+    usesList: boolean;
+    usesTuples: boolean;
+    /**
+     * One sentence per list this lane bound, for the receipt's `PRIMITIVE_LIST` notes.
+     *
+     * The FILE is the caller's to add: this lane is handed one file's bytes and does not know its
+     * name, exactly as `findSites` does not. @see ReceiptNote
+     */
+    notes: string[];
     /** The page slugs whose snapshot this lane now reads, so the file imports them. */
     slugs: string[];
     /** Target keys this plan bound. */
@@ -827,6 +866,24 @@ interface DataResult {
         key: string;
         reason: PendingReason;
     }[];
+    /** Edits to the COMPONENT files this lane drilled a row leaf into. @see DataContext.drill */
+    componentEdits: {
+        file: string;
+        splices: DataSplice[];
+    }[];
+    /**
+     * One drilled row leaf: the component file that now declares it, and the call site's own entry.
+     *
+     * The receipt records both halves of a prop conversion — the element is in another file and the
+     * path it reads is at the call site — and a reader cannot verify either half from the other
+     * alone. @see DynamicBinding
+     */
+    props: {
+        file: string;
+        prop: string;
+        path: string;
+        literal: string;
+    }[];
 }
 /**
  * Bind every repeater group whose copy lives in a data literal in this same file.
@@ -835,7 +892,7 @@ interface DataResult {
  * account for are returned in `refused` with the reason, and are never partially written — a group
  * half bound is a row whose second field silently stops reflecting.
  */
-declare function bindDataLiterals(ctx: DataContext, members: DataMember[]): DataResult;
+declare function bindDataLiterals(ctx: DataContext, members: DataMember[]): Promise<DataResult>;
 
 /**
  * An image whose `original` is a BUILT url, and the import the template actually renders.
@@ -986,6 +1043,17 @@ declare function aliasesFrom(sources: SourceFile[]): Map<string, string[]>;
  * The note says which file to look at. @see ConversionReceipt.notes
  */
 declare function unreadableConfigs(sources: SourceFile[]): string[];
+/**
+ * Project configs whose aliases are NOT in them — they `extends` another file.
+ *
+ * 🔴 AN ABSENT ALIAS TABLE LOOKS EXACTLY LIKE A PROJECT THAT HAS NONE, and the two have opposite
+ * consequences: the second converts relative imports and is complete, the first refuses every
+ * component reached through `@components/*` with the file sitting right there. `extends` chains
+ * are not followed — the base may be a published package (`@tsconfig/strict`) rather than a file
+ * in the tree — so the honest answer is to say so in the receipt rather than to resolve nothing
+ * silently. @see aliasesFrom
+ */
+declare function extendedConfigs(sources: SourceFile[]): string[];
 /** The repository path a specifier names, or null when it is not among the files we were given. */
 declare function resolveSpecifier(fromFile: string, specifier: string, files: Set<string>, aliases: Map<string, string[]>): string | null;
 /** What one local name was imported from, and WHICH export of it. */
@@ -1470,4 +1538,4 @@ declare function convertSources(briefIn: Brief, sources: SourceFile[], options?:
     receipt: ConversionReceipt;
 }>;
 
-export { ASTRO_LANE_PENDING, type AstNode, type AttrBinding, type Brief, type BriefPage, type BriefPath, COMPONENT_DIR, CONTENT_DIR, type CanvasResult, type CanvasSource, type Carried, type ComponentizeOptions, type ComponentizePlan, type ComponentizePlanComponent, type ComponentizePlanField, type ComponentizePlanPage, type ComponentizePlanSection, type ComponentizeReceipt, type ConversionReceipt, ConvertError, type ConvertErrorCode, type ConvertOptions, DIALECT_RULES, type DataMember, type DataResult, type DeclaredPath, type Dialect, type DynamicBinding, type FileDeclaration, type FindSitesResult, HELPER_PATH, HELPER_VERSION, type ImageResult, type ImageTarget, type ImportedFrom, type LlmFallback, type LocatedPath, type Node, PARSE_FILE, type ParsedFile, type ParserError, type PathLocator, type PendingPath, type PendingReason, type PendingSection, type PlanFile, REGISTRY_MARKER, type ReceiptFile, ReceiptInvariantError, type ReceiptNote, type Rewrite, SECTIONS_LIB, SECTION_MARKER, SKIP_DIRS, SKIP_FILES, SOURCE_EXTENSIONS, SSR_DRAFT_RECIPE, STUB_CONTENT, SectionInvariantError, type SectionPendingReason, type SectionsReceipt, type Site, type SiteWhere, type SourceFile, type Splice, type TargetIdentity, type UnlocatedPath, type ValidationCode, ValidationError, aliasesFrom, assertReceipt, assertSections, assetCandidates, assetImport, attrsFor, bindDataLiterals, bindImages, briefDigest, canvasBridge, carryFor, componentizeSources, convertSources, convertedHere, coverageOf, declaringElements, dialectOf, exportedFunction, findSites, findSitesTolerant, flat, helperSource, importsIn, isDynamicRoute, isKnownHelper, isSourceCandidate, locate, overlapping, pageFilesFor, parseFile, propsAttribute, readBrief, readComponentizePlan, readDeclarations, readExpr, readPlan, relativeImport, resolveSpecifier, rewriteFile, routeOfFile, stripTags, unreadableConfigs, walkAst };
+export { ASTRO_LANE_PENDING, type AstNode, type AttrBinding, type Brief, type BriefPage, type BriefPath, COMPONENT_DIR, CONTENT_DIR, type CanvasResult, type CanvasSource, type Carried, type ComponentizeOptions, type ComponentizePlan, type ComponentizePlanComponent, type ComponentizePlanField, type ComponentizePlanPage, type ComponentizePlanSection, type ComponentizeReceipt, type ConversionReceipt, ConvertError, type ConvertErrorCode, type ConvertOptions, DIALECT_RULES, type DataMember, type DataResult, type DeclaredPath, type Dialect, type DynamicBinding, type FileDeclaration, type FindSitesResult, HELPER_PATH, HELPER_VERSION, type ImageResult, type ImageTarget, type ImportedFrom, type LlmFallback, type LocatedPath, type Node, PARSE_FILE, type ParsedFile, type ParserError, type PathLocator, type PendingPath, type PendingReason, type PendingSection, type PlanFile, REGISTRY_MARKER, type ReceiptFile, ReceiptInvariantError, type ReceiptNote, type Rewrite, SECTIONS_LIB, SECTION_MARKER, SKIP_DIRS, SKIP_FILES, SOURCE_EXTENSIONS, SSR_DRAFT_RECIPE, STUB_CONTENT, SectionInvariantError, type SectionPendingReason, type SectionsReceipt, type Site, type SiteWhere, type SourceFile, type Splice, type TargetIdentity, type UnlocatedPath, type ValidationCode, ValidationError, aliasesFrom, assertReceipt, assertSections, assetCandidates, assetImport, attrsFor, bindDataLiterals, bindImages, briefDigest, canvasBridge, carryFor, componentizeSources, convertSources, convertedHere, coverageOf, declaringElements, dialectOf, exportedFunction, extendedConfigs, findSites, findSitesTolerant, flat, helperSource, importsIn, isDynamicRoute, isKnownHelper, isSourceCandidate, locate, overlapping, pageFilesFor, parseFile, propsAttribute, readBrief, readComponentizePlan, readDeclarations, readExpr, readPlan, relativeImport, resolveSpecifier, rewriteFile, routeOfFile, stripTags, unreadableConfigs, walkAst };