@bettercms-ai/convert 0.24.0 → 0.25.0

package/dist/index.d.ts

@@ -955,7 +955,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 = 12;
+declare const HELPER_VERSION = 13;
 /** 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. */
@@ -1853,6 +1853,36 @@ declare function readBrief(value: unknown): Brief;
  */
 declare function readPlan(value: unknown): ComponentizePlan;
 
+/**
+ * `build:bcms` — the build BetterCMS runs instead of `build`, when a repository declares one.
+ *
+ * The builder runs `build:bcms` in place of `build` (as Vercel runs `vercel-build`), and never edits
+ * a project's build script itself. A converted repository's `build` usually chains the checks its
+ * own CI wants in front of the build — `astro check && astro build` — and every BetterCMS deploy
+ * paid for them: the type check alone was 8–10 s of a warm ScrewFast build. This writes the same
+ * build without those checks, once, beside the script it came from. `build` is left exactly as it
+ * was, so the project's own CI still checks everything.
+ *
+ * Only a script it can read with certainty: steps joined by `&&` and nothing else. A `;`, `||`,
+ * pipe, background `&` or substitution means the steps do not simply run in order, and that script
+ * is left alone. `prebuild` and `postbuild` are folded in (minus their own checks), because a run
+ * of `build:bcms` triggers `prebuild:bcms`, not `prebuild` — dropping them would lose a step the
+ * build needs (ScrewFast splits its content snapshot in `prebuild`).
+ */
+interface BcmsBuild {
+    /** The new package.json, formatted as the original was. */
+    content: string;
+    /** The `build:bcms` it adds. */
+    script: string;
+    /** The steps of `build` (and its pre/post hooks) left out of it. */
+    dropped: string[];
+}
+/**
+ * The package.json with a `build:bcms` added, or null when there is nothing to add: one already
+ * exists, no `build` chains a check, or a script is not one it can read with certainty.
+ */
+declare function bcmsBuildScript(packageJson: string): BcmsBuild | null;
+
 /** The plan's own file shape, restated rather than imported to keep `index.ts` acyclic. */
 interface UpgradeFile {
     path: string;
@@ -1965,4 +1995,4 @@ declare function convertSources(briefIn: Brief, sources: SourceFile[], options?:
     receipt: ConversionReceipt;
 }>;
 
-export { ASTRO_LANE_PENDING, type AstNode, type AttrBinding, type Brief, type BriefForm, 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, FORM_SCRIPT, type FileDeclaration, type FindSitesResult, type FixAction, FormInvariantError, type FormPendingReason, type FormsReceipt, HELPER_PATH, HELPER_VERSION, type HelperUpgrade, type ImageResult, type ImageTarget, type ImportedFrom, type LlmFallback, type LocatedPath, type Node, PARSE_FILE, type ParsedFile, type ParserError, type PathLocator, type PendingFix, type PendingForm, 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 SectionUpgradeReceipt, type SectionsReceipt, type Site, type SiteWhere, type SkippedRoot, type SourceFile, type Splice, type TargetIdentity, type UnlocatedPath, UpgradeError, type UpgradeOptions, type UpgradeRootRef, type UpgradeSkipReason, type UpgradedRoot, type ValidationCode, ValidationError, type Xray, type XrayBucket, aliasesFrom, assertForms, assertReceipt, assertSections, assetCandidates, assetImport, attrsFor, bindDataLiterals, bindImages, briefDigest, canvasBridge, carryFor, componentizeSources, convertSources, convertedHere, coverageOf, declaringElements, dialectOf, exportedFunction, extendedConfigs, findLiteral, findSites, findSitesTolerant, fixFor, flat, helperSource, helperUpgrades, importsIn, isDecorativeGlyph, isDynamicRoute, isKnownHelper, isSourceCandidate, locate, measureUnaddressable, overlapping, pageFilesFor, parseFile, propsAttribute, readBrief, readComponentizePlan, readDeclarations, readExpr, readPlan, relativeImport, resolveSpecifier, rewriteFile, routeCounts, routeOfFile, stripTags, unreadableConfigs, upgradeSections, walkAst, wireForms };
+export { ASTRO_LANE_PENDING, type AstNode, type AttrBinding, type BcmsBuild, type Brief, type BriefForm, 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, FORM_SCRIPT, type FileDeclaration, type FindSitesResult, type FixAction, FormInvariantError, type FormPendingReason, type FormsReceipt, HELPER_PATH, HELPER_VERSION, type HelperUpgrade, type ImageResult, type ImageTarget, type ImportedFrom, type LlmFallback, type LocatedPath, type Node, PARSE_FILE, type ParsedFile, type ParserError, type PathLocator, type PendingFix, type PendingForm, 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 SectionUpgradeReceipt, type SectionsReceipt, type Site, type SiteWhere, type SkippedRoot, type SourceFile, type Splice, type TargetIdentity, type UnlocatedPath, UpgradeError, type UpgradeOptions, type UpgradeRootRef, type UpgradeSkipReason, type UpgradedRoot, type ValidationCode, ValidationError, type Xray, type XrayBucket, aliasesFrom, assertForms, assertReceipt, assertSections, assetCandidates, assetImport, attrsFor, bcmsBuildScript, bindDataLiterals, bindImages, briefDigest, canvasBridge, carryFor, componentizeSources, convertSources, convertedHere, coverageOf, declaringElements, dialectOf, exportedFunction, extendedConfigs, findLiteral, findSites, findSitesTolerant, fixFor, flat, helperSource, helperUpgrades, importsIn, isDecorativeGlyph, isDynamicRoute, isKnownHelper, isSourceCandidate, locate, measureUnaddressable, overlapping, pageFilesFor, parseFile, propsAttribute, readBrief, readComponentizePlan, readDeclarations, readExpr, readPlan, relativeImport, resolveSpecifier, rewriteFile, routeCounts, routeOfFile, stripTags, unreadableConfigs, upgradeSections, walkAst, wireForms };

package/dist/index.js

@@ -4187,7 +4187,7 @@ async function bindImages(ctx, targets) {
 
 // src/helper.ts
 import { createHash as createHash2 } from "crypto";
-var HELPER_VERSION = 12;
+var HELPER_VERSION = 13;
 var HEADER = "// @bettercms-ai/convert helper v";
 var HELPER_PATH = Object.fromEntries(
   Object.keys(DIALECT_RULES).map((d) => [d, DIALECT_RULES[d].helper])
@@ -4233,9 +4233,16 @@ function readPath(root: unknown, path: string): unknown {
   return cursor;
 }
 
+/**
+ * A repository image path \u2014 \`@/images/x.avif\`, \`~/assets/x.png\`, \`../assets/x.jpg\`, \`/src/x.png\`.
+ * The bundler resolves one at build and nothing else can, so as a value it is never rendered: the
+ * template's own fallback (the picture the build already imported) shows instead of a broken image.
+ */
+const REPO_IMAGE_PATH = /^(?:@[\\w-]*|~|\\.{1,2}|\\/?src)\\/[^\\s?#"'<>]*\\.(?:avif|png|jpe?g|webp|gif|svg|bmp|ico|tiff?|jxl|heic)(?:[?#]\\S*)?$/i;
+
 /** A stored value as a template renders it: richtext is its html, an image is its url. */
 function render(value: unknown): string | undefined {
-  if (typeof value === "string") return value;
+  if (typeof value === "string") return REPO_IMAGE_PATH.test(value.trim()) ? undefined : value;
   if (typeof value === "number" || typeof value === "boolean") return String(value);
   if (isRecord(value)) {
     if (typeof value.html === "string") return value.html;
@@ -4729,7 +4736,8 @@ var HISTORICAL = {
     8: "484e72852d2b496e016a1f2a2b1a77bb993f8a163b290781522d6114b6519bb9",
     9: "d6441db2ff4578c3c5d4b7d461f3374b89247ef6ba9e0d535791e840d803e4f3",
     10: "ffcb59862972b15a67c5951e9f3b94ce5b8b50345e6aac2bfa5789cfc3136910",
-    11: "ceb2a932d4c2761a5045ff35032e0b45130a0b5034547ff37579c72c9ce3594e"
+    11: "ceb2a932d4c2761a5045ff35032e0b45130a0b5034547ff37579c72c9ce3594e",
+    12: "10f71724484c84af12aa3eb90db44bf6acbf71fcf8ddff5b6361c1190ba16528"
   },
   "src/lib/bcms-content.ts": {
     1: "ae72ae14d706943d481c880d70da5789b4816ba1ba319a10fbc63ded4d0b42f2",
@@ -4742,7 +4750,8 @@ var HISTORICAL = {
     8: "1a6f669d76d42effe77f082436e9d21c0efa6fc499e919e3d116bc3a27a7f3d5",
     9: "eee9fb1635ae7d6f8f33676a1f390600ca24a62ee992775252273c73a011c494",
     10: "35bb7c0e30f5c41fe68e52259ec4764de6de2734064fa0e1521f3338eef0a09e",
-    11: "818784f2088150d64d91b42eac944dc9503f104d32a0e7a18c753d2982a5adc0"
+    11: "818784f2088150d64d91b42eac944dc9503f104d32a0e7a18c753d2982a5adc0",
+    12: "79dafc525a541feae55ada5dbe2ea966cac82acd741a4b41d61fe9e0cdfaa208"
   },
   "composables/bcms-content.ts": {
     1: "c272412532efed7db64b6cf313b2bed4291f9951430412289c8a588b7f565407",
@@ -4755,7 +4764,8 @@ var HISTORICAL = {
     8: "484e72852d2b496e016a1f2a2b1a77bb993f8a163b290781522d6114b6519bb9",
     9: "d6441db2ff4578c3c5d4b7d461f3374b89247ef6ba9e0d535791e840d803e4f3",
     10: "ffcb59862972b15a67c5951e9f3b94ce5b8b50345e6aac2bfa5789cfc3136910",
-    11: "ceb2a932d4c2761a5045ff35032e0b45130a0b5034547ff37579c72c9ce3594e"
+    11: "ceb2a932d4c2761a5045ff35032e0b45130a0b5034547ff37579c72c9ce3594e",
+    12: "10f71724484c84af12aa3eb90db44bf6acbf71fcf8ddff5b6361c1190ba16528"
   }
 };
 var sha256 = (value) => createHash2("sha256").update(value, "utf8").digest("hex");
@@ -7680,6 +7690,54 @@ function moduleScope(parsed, content) {
   return out;
 }
 
+// src/build-script.ts
+var CHECK = /^(?:npx\s+|pnpm\s+(?:exec\s+)?|yarn\s+|bunx\s+)?(?:astro\s+check|svelte-check|vue-tsc|tsc(?:\s|$)|eslint|next\s+lint|biome\s+(?:check|lint|ci)|prettier\s+(?:--check|-c)\b|stylelint|oxlint)/;
+var RUN_CHECK = /^(?:npm\s+run|pnpm(?:\s+run)?|yarn(?:\s+run)?|bun\s+run)\s+(?:lint|typecheck|type-check|check|check:types|types|format:check|test)(?::[\w-]+)?\s*$/;
+var UNSAFE = /;|\|\||\||(?:^|[^&])&(?:[^&]|$)|\$\(|`|\n/;
+var isCheck = (step) => CHECK.test(step) || RUN_CHECK.test(step);
+function steps(script) {
+  if (UNSAFE.test(script)) return null;
+  const out = script.split("&&").map((s) => s.trim());
+  return out.some((s) => s === "") ? null : out;
+}
+function bcmsBuildScript(packageJson) {
+  let pkg;
+  try {
+    pkg = JSON.parse(packageJson);
+  } catch {
+    return null;
+  }
+  const scripts = pkg?.scripts;
+  if (!scripts || typeof scripts !== "object" || "build:bcms" in scripts) return null;
+  const build = scripts.build;
+  if (typeof build !== "string") return null;
+  const parts = [];
+  for (const name of ["prebuild", "build", "postbuild"]) {
+    const value = scripts[name];
+    if (value === void 0) continue;
+    if (typeof value !== "string") return null;
+    const s = steps(value);
+    if (!s) return null;
+    parts.push(s);
+  }
+  const all = parts.flat();
+  const dropped = all.filter(isCheck);
+  const kept = all.filter((s) => !isCheck(s));
+  if (dropped.length === 0 || kept.length === 0) return null;
+  const script = kept.join(" && ");
+  const next = {};
+  for (const [key, value] of Object.entries(scripts)) {
+    next[key] = value;
+    if (key === "build") next["build:bcms"] = script;
+  }
+  const indent = /^[ \t]+(?=")/m.exec(packageJson)?.[0] ?? "  ";
+  const eol = packageJson.includes("\r\n") ? "\r\n" : "\n";
+  let content = JSON.stringify({ ...pkg, scripts: next }, null, indent);
+  if (eol !== "\n") content = content.replace(/\n/g, eol);
+  if (/\r?\n$/.test(packageJson)) content += eol;
+  return { content, script, dropped };
+}
+
 // src/componentize.ts
 import MagicString5 from "magic-string";
 var SectionInvariantError = class extends Error {
@@ -10778,6 +10836,7 @@ export {
   assetCandidates,
   assetImport,
   attrsFor,
+  bcmsBuildScript,
   bindDataLiterals,
   bindImages,
   briefDigest,