@decocms/blocks-cli 8.0.0 → 8.1.0-next.0

package/scripts/migrate/phase-analyze.ts

@@ -11,6 +11,14 @@ import { extractSectionMetadata } from "./analyzers/section-metadata";
 import { classifyIslands } from "./analyzers/island-classifier";
 import { inventoryLoaders } from "./analyzers/loader-inventory";
 import { extractTailwindConfig } from "./analyzers/tailwind-config";
+import {
+  COMPONENT_DELETE,
+  GENERATED_FILES,
+  LOADER_DELETE,
+  ROOT_DELETE,
+  SDK_DELETE,
+  STATIC_DELETE,
+} from "./delete-sets";
 
 const PATTERN_DETECTORS: Array<[DetectedPattern, RegExp]> = [
   ["preact-hooks", /from\s+["']preact\/hooks["']/],
@@ -33,7 +41,7 @@ const PATTERN_DETECTORS: Array<[DetectedPattern, RegExp]> = [
   ["head-component", /<Head[\s>]/],
   ["define-app", /defineApp\(/],
   ["invoke-proxy", /proxy<Manifest/],
-  // Bagaggio-style HTMX dynamic-section loader. Both the source file and
+  // legacy HTMX-style dynamic-section loader. Both the source file and
   // every call site need manual conversion to React state / createServerFn.
   ["sections-component-loader", /sections\/Component\.tsx?$/m],
   ["use-component", /import\s*\{[^}]*\buseComponent\b[^}]*\}\s*from\s*["'][^"']*sections\/Component(?:\.tsx?)?["']/],
@@ -78,61 +86,6 @@ const SKIP_FILES = new Set([
   "bun.lockb",
 ]);
 
-/** Files that are generated and should be deleted */
-const GENERATED_FILES = new Set([
-  "fresh.gen.ts",
-  "manifest.gen.ts",
-  "fresh.config.ts",
-]);
-
-/** SDK files that have framework equivalents or are scaffolded fresh */
-const SDK_DELETE = new Set([
-  "sdk/clx.ts",
-  "sdk/useId.ts",
-  // sdk/useOffer.ts — kept: sites often customize offer logic
-  // sdk/useVariantPossiblities.ts — kept: sites often customize variant logic
-  "sdk/usePlatform.tsx",
-  "sdk/signal.ts",
-  "sdk/format.ts",
-]);
-
-/** Component files that are scaffolded fresh (old versions must not overwrite) */
-const COMPONENT_DELETE = new Set([
-  "components/ui/Image.tsx",
-  "components/ui/Picture.tsx",
-  "components/ui/Video.tsx",
-]);
-
-/** Loaders that depend on deleted admin tooling */
-const LOADER_DELETE = new Set([
-  "loaders/availableIcons.ts",
-  "loaders/icons.ts",
-]);
-
-/** Root config/infra files to delete */
-const ROOT_DELETE = new Set([
-  "main.ts",
-  "dev.ts",
-  "deno.json",
-  "deno.lock",
-  "tailwind.css",
-  "tailwind.config.ts",
-  "runtime.ts",
-  "constants.ts",
-  "fresh.gen.ts",
-  "manifest.gen.ts",
-  "fresh.config.ts",
-  "browserslist",
-  "bw_stats.json",
-  "islands.ts",
-]);
-
-/** Static files that are code/tooling, not assets — should be deleted */
-const STATIC_DELETE = new Set([
-  "static/adminIcons.ts",
-  "static/generate-icons.ts",
-  "static/tailwind.css",
-]);
 
 /**
  * Scan file content for inline npm: imports and return { name: version } pairs.
@@ -317,7 +270,7 @@ function decideAction(
     };
   }
 
-  // Bagaggio-style HTMX dynamic-section loader → delete and flag.
+  // legacy HTMX-style dynamic-section loader → delete and flag.
   // The file uses Deno-only APIs (`toFileUrl(Deno.cwd())`, `import.meta.resolve`)
   // and the `useComponent(component, props)` HTMX render-and-swap pattern, none
   // of which work on TanStack Start / Cloudflare Workers. The site author must
@@ -418,6 +371,50 @@ function scanDir(
   }
 }
 
+export function extractGoogleFonts(
+  sourceDir: string,
+): { preconnects: string[]; stylesheets: string[] } {
+  const preconnects: string[] = [];
+  const stylesheets: string[] = [];
+  const seen = new Set<string>();
+
+  const hrefRe = /href=["'](https:\/\/fonts\.(?:googleapis|gstatic)\.com[^"']*)["']/g;
+
+  // Read _app.tsx and _layout.tsx for <link> declarations
+  for (const candidate of ["routes/_app.tsx", "routes/_layout.tsx"]) {
+    const fp = path.join(sourceDir, candidate);
+    if (!fs.existsSync(fp)) continue;
+    const content = fs.readFileSync(fp, "utf-8");
+    for (const m of content.matchAll(hrefRe)) {
+      const href = m[1];
+      if (seen.has(href)) continue;
+      seen.add(href);
+      if (href.includes("/css")) {
+        stylesheets.push(href);
+      } else {
+        preconnects.push(href);
+      }
+    }
+  }
+
+  // Also check tailwind.css for @import url(https://fonts.googleapis.com/...)
+  for (const cssCandidate of ["tailwind.css", "styles/app.css", "styles/global.css"]) {
+    const fp = path.join(sourceDir, cssCandidate);
+    if (!fs.existsSync(fp)) continue;
+    const content = fs.readFileSync(fp, "utf-8");
+    const importRe = /@import\s+url\(['"]?(https:\/\/fonts\.googleapis\.com[^'")\s]+)/g;
+    for (const m of content.matchAll(importRe)) {
+      const href = m[1];
+      if (!seen.has(href)) {
+        seen.add(href);
+        stylesheets.push(href);
+      }
+    }
+  }
+
+  return { preconnects, stylesheets };
+}
+
 function extractGtmId(sourceDir: string): string | null {
   const appPath = path.join(sourceDir, "routes", "_app.tsx");
   if (!fs.existsSync(appPath)) return null;
@@ -433,7 +430,7 @@ function extractVtexAccount(sourceDir: string): string | null {
     const fp = path.join(sourceDir, candidate);
     if (!fs.existsSync(fp)) continue;
     const content = fs.readFileSync(fp, "utf-8");
-    // Match patterns like: casaevideo: "casaevideonewio"
+    // Match patterns like: acme: "acmenewio"
     const match = content.match(/vtexAn|VTEX_AN/i);
     if (match) {
       const dictMatch = content.match(/["'](\w+)["']\s*:\s*["'](\w+myvtex|\w+newio|\w+)["']/);
@@ -627,6 +624,20 @@ export function analyze(ctx: MigrationContext): void {
   ctx.platform = extractPlatform(ctx.sourceDir);
   ctx.vtexAccount = ctx.platform === "vtex" ? extractVtexAccount(ctx.sourceDir) : null;
   ctx.gtmId = extractGtmId(ctx.sourceDir);
+  ctx.googleFonts = extractGoogleFonts(ctx.sourceDir);
+  // If no font URLs were extracted but the file mentions googleapis (likely a
+  // JSX expression like href={URL_CONST}), flag it for manual review.
+  if (ctx.googleFonts.preconnects.length === 0 && ctx.googleFonts.stylesheets.length === 0) {
+    const appPath = path.join(ctx.sourceDir, "routes", "_app.tsx");
+    if (fs.existsSync(appPath) && fs.readFileSync(appPath, "utf-8").includes("fonts.googleapis")) {
+      ctx.manualReviewItems.push({
+        file: "routes/_app.tsx",
+        reason:
+          "Google Fonts reference found but could not be extracted automatically (may use a JSX expression or variable). Add the font preconnect and stylesheet links manually to src/routes/__root.tsx.",
+        severity: "warning",
+      });
+    }
+  }
 
   // Extract theme colors and font from CMS
   const theme = extractThemeFromCms(ctx.sourceDir);
@@ -655,8 +666,16 @@ export function analyze(ctx: MigrationContext): void {
     console.log(`  Font: ${ctx.fontFamily}`);
   }
 
-  // Scan all files
+  // Scan all files. The root scan skips `src/` (SKIP_DIRS) — for a MODERN
+  // layout the code lives there, so scan `src/` separately with baseDir=src so
+  // its files categorize as if they were at root (`src/sections/X` → `sections/X`
+  // → section → targetPath `src/sections/X`). The root scan still handles config
+  // + static/ at the repo root.
   scanDir(ctx.sourceDir, ctx.sourceDir, ctx.files);
+  if (ctx.layout === "modern") {
+    const srcDir = path.join(ctx.sourceDir, "src");
+    if (fs.existsSync(srcDir)) scanDir(srcDir, srcDir, ctx.files);
+  }
 
   // Summary
   const byAction = { transform: 0, delete: 0, move: 0, scaffold: 0, "manual-review": 0 };
@@ -699,7 +718,7 @@ export function analyze(ctx: MigrationContext): void {
       f.path === "sections/Component.ts",
   );
   if (componentLoaderFile || useComponentSites.length > 0) {
-    console.log("\n  ⚠ HTMX dynamic-section loader detected (Bagaggio-style)");
+    console.log("\n  ⚠ HTMX dynamic-section loader detected (legacy HTMX-style)");
     if (componentLoaderFile) {
       console.log(`    • ${componentLoaderFile.path} (will be deleted)`);
     }

package/scripts/migrate/phase-cleanup.test.ts

@@ -20,7 +20,9 @@ function makeCtx(sourceDir: string, dryRun = false): MigrationContext {
     importMap: {},
     discoveredNpmDeps: {},
     themeColors: {},
-  tailwindConfig: { colors: {}, fontFamily: {}, screens: {}, safelist: [], safelistPatterns: [], plugins: [], reviewItems: [] },
+  tailwindConfig: { colors: {}, fontFamily: {}, screens: {}, animations: {}, keyframes: {}, safelist: [], safelistPatterns: [], plugins: [], reviewItems: [] },
+  layout: "classic",
+  googleFonts: { preconnects: [], stylesheets: [] },
     fontFamily: null,
     files: [],
     sectionMetas: [],

package/scripts/migrate/phase-cleanup.ts

@@ -627,7 +627,7 @@ function guardUndeclaredVariables(src: string, onFix: (msg: string) => void): st
 /**
  * Migrate account.json → src/constants/account.ts and rewrite imports.
  *
- * Old stack: root-level `account.json` containing e.g. `"casaevideo"`
+ * Old stack: root-level `account.json` containing e.g. `"acme"`
  * New stack: `src/constants/account.ts` exporting `accountName`
  *
  * Also rewrites every file that imports from `account.json` (via

package/scripts/migrate/phase-compile.test.ts

@@ -16,7 +16,9 @@ function makeCtx(sourceDir: string, dryRun = false): MigrationContext {
 		importMap: {},
 		discoveredNpmDeps: {},
 		themeColors: {},
-	tailwindConfig: { colors: {}, fontFamily: {}, screens: {}, safelist: [], safelistPatterns: [], plugins: [], reviewItems: [] },
+	tailwindConfig: { colors: {}, fontFamily: {}, screens: {}, animations: {}, keyframes: {}, safelist: [], safelistPatterns: [], plugins: [], reviewItems: [] },
+	layout: "classic",
+	googleFonts: { preconnects: [], stylesheets: [] },
 		fontFamily: null,
 		files: [],
 		sectionMetas: [],

package/scripts/migrate/phase-report.test.ts

@@ -22,6 +22,8 @@ describe("report — CSS Migration section", () => {
       colors: { perola: "#F5F0E8", "brand-500": "#B10200" },
       fontFamily: { "bebas-neue": "Bebas Neue, sans-serif" },
       screens: {},
+      animations: {},
+      keyframes: {},
       safelist: ["bg-red-500"],
       safelistPatterns: [],
       plugins: [],

package/scripts/migrate/phase-report.ts

@@ -199,7 +199,7 @@ export function report(ctx: MigrationContext): void {
   lines.push("- [ ] `src/hooks/useCart.ts` — wire to actual server functions for your platform");
   lines.push("- [ ] `src/worker-entry.ts` — verify CSP, proxy, and segment builder");
   lines.push("- [ ] See the **CSS Migration** section above for DaisyUI v4→v5 / Tailwind v3→v4 findings specific to this site");
-  lines.push("- [ ] Run `npm run generate:blocks` and `npm run generate:schema` after migration");
+  lines.push("- [ ] Run `npm run generate` (unified: blocks, sections, loaders, schema) after migration");
   lines.push("");
 
   // Known Issues
@@ -250,9 +250,8 @@ export function report(ctx: MigrationContext): void {
   lines.push("# 1. Install dependencies (bun is the canonical PM)");
   lines.push("bun install");
   lines.push("");
-  lines.push("# 2. Generate CMS blocks and schema");
-  lines.push("bun run generate:blocks");
-  lines.push("bun run generate:schema");
+  lines.push("# 2. Generate CMS artifacts (blocks, sections, loaders, schema)");
+  lines.push("bun run generate");
   lines.push("");
   lines.push("# 3. Generate routes");
   lines.push("bunx tsr generate");

package/scripts/migrate/phase-scaffold.ts

@@ -1,29 +1,40 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import type { MigrationContext } from "./types";
-import { log, logPhase } from "./types";
-import { CANONICAL_BUN_VERSION, generatePackageJson } from "./templates/package-json";
-import { generateLockfileCheckYml } from "./templates/lockfile-check-yml";
-import { generateTsconfig } from "./templates/tsconfig";
-import { generateViteConfig } from "./templates/vite-config";
+// `lib-utils` is imported lazily — see end of phase-cleanup. Eager
+// generation of all 11 shims left every site with dead code that had
+// to be cleaned up by hand.
+import { extractTheme } from "./analyzers/theme-extractor";
+import { generateAppCss } from "./templates/app-css";
+import { generateCacheConfig } from "./templates/cache-config";
+import { generateCiFiles } from "./templates/ci-yml";
+import { generateCommerceInit } from "./templates/commerce-init";
+import { generateCommerceLoaders } from "./templates/commerce-loaders";
+import { generateSyncBlocksBotYml } from "./templates/sync-blocks-bot-yml";
+import { generateMigrationPolicyPointerRule } from "./templates/cursor-rules";
+import { generateHooks } from "./templates/hooks";
 import { generateKnipConfig } from "./templates/knip-config";
+import { generateLockfileCheckYml } from "./templates/lockfile-check-yml";
+import { generateMainPushGuardYml } from "./templates/main-push-guard-yml";
+import {
+  CANONICAL_BUN_VERSION,
+  CANONICAL_NODE_VERSION,
+  generatePackageJson,
+} from "./templates/package-json";
+import { generateParityYml } from "./templates/parity-yml";
+import { generatePerfFiles } from "./templates/perf-yml";
+import { generatePlaywrightFiles } from "./templates/playwright-yml";
+import { generateReactDoctorYml } from "./templates/react-doctor-yml";
 import { generateRoutes } from "./templates/routes";
-import { generateSetup } from "./templates/setup";
+import { generateSdkFiles } from "./templates/sdk-gen";
+import { generateSectionLoaders } from "./templates/section-loaders";
 import { generateServerEntry } from "./templates/server-entry";
-import { generateAppCss } from "./templates/app-css";
+import { generateSetup } from "./templates/setup";
+import { generateTsconfig } from "./templates/tsconfig";
 import { generateTypeFiles } from "./templates/types-gen";
 import { generateUiComponents } from "./templates/ui-components";
-import { generateHooks } from "./templates/hooks";
-import { generateCommerceInit } from "./templates/commerce-init";
-import { generateCommerceLoaders } from "./templates/commerce-loaders";
-import { generateSectionLoaders } from "./templates/section-loaders";
-import { generateCacheConfig } from "./templates/cache-config";
-import { generateSdkFiles } from "./templates/sdk-gen";
-import { generateMigrationPolicyPointerRule } from "./templates/cursor-rules";
-// `lib-utils` is imported lazily — see end of phase-cleanup. Eager
-// generation of all 11 shims left every site with dead code that had
-// to be cleaned up by hand.
-import { extractTheme } from "./analyzers/theme-extractor";
+import { generateViteConfig } from "./templates/vite-config";
+import type { MigrationContext } from "./types";
+import { log, logPhase } from "./types";
 
 function writeFile(ctx: MigrationContext, relPath: string, content: string) {
   const fullPath = path.join(ctx.sourceDir, relPath);
@@ -69,13 +80,21 @@ export function scaffold(ctx: MigrationContext): void {
   // does NOT scaffold deploy/preview/sync-secrets workflows in the site
   // repo; the operator wires the repo<->worker connection in the CF
   // dashboard once after the first push.
-  writeFile(ctx, ".prettierrc", JSON.stringify({
-    semi: true,
-    singleQuote: false,
-    trailingComma: "all" as const,
-    printWidth: 100,
-    tabWidth: 2,
-  }, null, 2) + "\n");
+  writeFile(
+    ctx,
+    ".prettierrc",
+    JSON.stringify(
+      {
+        semi: true,
+        singleQuote: false,
+        trailingComma: "all" as const,
+        printWidth: 100,
+        tabWidth: 2,
+      },
+      null,
+      2,
+    ) + "\n",
+  );
 
   // PR-time lockfile guardrail. Lives in the site repo (per-site, not
   // a centralised reusable workflow) because per D6.3 we are not
@@ -87,6 +106,40 @@ export function scaffold(ctx: MigrationContext): void {
     generateLockfileCheckYml(CANONICAL_BUN_VERSION),
   );
 
+  // Advisory per-PR performance workflow: detects which sections changed,
+  // maps them to CMS page paths, runs Lighthouse against the CF preview URL
+  // (PR vs main), and posts a comparison comment. Gate = CLS + TBT only.
+  writeMultiFile(ctx, generatePerfFiles(ctx.siteName));
+
+  // Per-PR quality pipeline (ci.yml) + its no-suppressions gate. BLOCKS on
+  // generate + build; the migration-cleanliness gates (no-suppressions,
+  // typecheck, format, knip) ship advisory so day-one CI is green. Node pinned
+  // in lockstep with the perf/playwright workflows.
+  writeMultiFile(ctx, generateCiFiles(CANONICAL_NODE_VERSION, CANONICAL_BUN_VERSION));
+
+  // Branch-protection surrogate: fails visibly if a commit reaches main
+  // without a PR (never blocks the push itself).
+  writeFile(ctx, ".github/workflows/main-push-guard.yml", generateMainPushGuardYml());
+
+  // Functional E2E harness (chromium + webkit) + self-contained config/smoke.
+  writeMultiFile(ctx, generatePlaywrightFiles(CANONICAL_BUN_VERSION));
+
+  // Advisory React lint (react-doctor): comments on PRs, never fails.
+  writeFile(ctx, ".github/workflows/react-doctor.yml", generateReactDoctorYml());
+
+  // Advisory parity validation: compares each PR preview against the original
+  // live storefront (@decocms/parity). Inert until PARITY_PROD_URL is set.
+  writeFile(ctx, ".github/workflows/parity.yml", generateParityYml(ctx.siteName));
+
+  // Daily content pull from the still-live storefront (`<origin>/.decofile` ->
+  // `.deco/blocks` -> PR). Replaces the legacy cross-repo-PAT push sync; inert
+  // until the operator sets the repo variable SYNC_BLOCKS_ORIGIN.
+  writeFile(
+    ctx,
+    ".github/workflows/sync-blocks-bot.yml",
+    generateSyncBlocksBotYml(CANONICAL_BUN_VERSION),
+  );
+
   // Server entry files (server.ts, worker-entry.ts, router.tsx, runtime.ts, context.ts)
   writeMultiFile(ctx, generateServerEntry(ctx));
 
@@ -224,18 +277,48 @@ export { type Font as SiteThemeFont };
 `;
 }
 
-function generateWranglerConfig(ctx: MigrationContext): string {
-  return JSON.stringify(
-    {
-      name: ctx.siteName,
-      main: "src/worker-entry.ts",
-      compatibility_date: "2025-05-01",
-      compatibility_flags: ["nodejs_compat", "no_handle_cross_request_promise_resolution"],
-      kv_namespaces: [{ binding: "SITES_KV", id: "dev-sites-kv" }],
-    },
-    null,
-    2,
-  ) + "\n";
+export function generateWranglerConfig(ctx: MigrationContext): string {
+  // Emitted as real JSONC (not JSON.stringify) so the comments survive — every
+  // field below is load-bearing and the next person to edit this file needs to
+  // know why. The ids are placeholders: the control-plane owns them (it
+  // provisions the site's OWN namespaces and overrides these at build time),
+  // so a wrong id here can never reach production.
+  return `{
+  "name": "${ctx.siteName}",
+  "main": "src/worker-entry.ts",
+  "compatibility_date": "2025-05-01",
+  // no_handle_cross_request_promise_resolution: the framework's SWR/dedup
+  // caches hold in-flight promises across requests; without this flag the
+  // worker hangs.
+  "compatibility_flags": ["nodejs_compat", "no_handle_cross_request_promise_resolution"],
+  // Workers Cache — tiered cache IN FRONT of the worker. On a hit the worker
+  // never runs. Per-response cacheability is still driven by Cache-Control.
+  "cache": { "enabled": true },
+  // Surfaces the build sha as service.version on every span and log line.
+  "version_metadata": { "binding": "CF_VERSION_METADATA" },
+  // Tail worker. The ONLY channel that can see exceededMemory / exceededCpu:
+  // Cloudflare kills the isolate before any in-worker code could report them.
+  // Without this a memory incident is invisible — see docs/runbooks/.
+  "tail_consumers": [{ "service": "deco-otel-tail" }],
+  "kv_namespaces": [
+    // Fast Deploy content store. Holds decofile:<deployment-id> + the revision
+    // index, so a CMS publish goes live without a code deploy. The id is
+    // written by the control-plane at site creation and re-forced from
+    // CF_KV_NAMESPACE_ID on every build (per-site KV isolation).
+    { "binding": "DECO_KV", "id": "" }
+    // No SITES_KV: withABTesting (server-entry) passes through when it is
+    // unbound, and nothing provisions it — an empty id would fail deploy.
+    // Add it with the shared namespace's real id when starting an A/B test.
+  ],
+  "vars": {
+    "DECO_SITE_NAME": "${ctx.siteName}",
+    "DECO_ENV_NAME": "production",
+    // Fast Deploy opt-in. Requires BOTH this flag AND the DECO_KV binding
+    // above; inert if either is missing. Set to "0" to disable.
+    "DECO_FAST_DEPLOY": "1"
+  }
+}
+`;
 }
 
 function generateGitignore(): string {
@@ -340,8 +423,13 @@ export default debounce;
 }
 
 function generateSignalShim(): string {
-  return `import { useState, useRef, useEffect, useMemo, useCallback } from "react";
-export { signal, type ReactiveSignal } from "@decocms/blocks/sdk/signal";
+  return `import { useState, useRef, useEffect, useMemo, useCallback, useSyncExternalStore } from "react";
+// Import locally (so \`ReactiveSignal\` is in scope for useSignalValue below) AND
+// re-export for consumers. A bare \`export { … } from\` re-export does NOT bind the
+// name locally — using it as a type then fails with "Cannot find name".
+import { signal, type ReactiveSignal } from "@decocms/blocks/sdk/signal";
+export { signal };
+export type { ReactiveSignal };
 
 /** Run a function immediately. Kept for legacy module-level side effects. */
 export function effect(fn: () => void | (() => void)): () => void {
@@ -386,6 +474,24 @@ export function useComputed<T>(compute: () => T): { readonly value: T } {
 export function useSignalEffect(cb: () => void | (() => void)): void {
   useEffect(cb);
 }
+
+/**
+ * Subscribe to a ReactiveSignal and re-render when it changes.
+ * Required for signals from useUI() (displayCart, displayMenu, etc.) —
+ * reading .value directly in render is a dead read in React and freezes the UI.
+ *
+ * @example
+ *   const { displayCart } = useUI();
+ *   const open = useSignalValue(displayCart);
+ *   return <Drawer open={open} />;
+ */
+export function useSignalValue<T>(sig: ReactiveSignal<T>): T {
+  return useSyncExternalStore(
+    (cb) => sig.subscribe(cb),
+    () => sig.value,
+    () => sig.value,
+  );
+}
 `;
 }
 
@@ -531,10 +637,7 @@ ${entries.join("\n")}
 }
 
 function hasLocationMatcher(ctx: MigrationContext): boolean {
-  const dirs = [
-    path.join(ctx.sourceDir, "matchers"),
-    path.join(ctx.sourceDir, "src", "matchers"),
-  ];
+  const dirs = [path.join(ctx.sourceDir, "matchers"), path.join(ctx.sourceDir, "src", "matchers")];
   for (const dir of dirs) {
     if (fs.existsSync(dir)) {
       const files = fs.readdirSync(dir);
@@ -549,7 +652,9 @@ function hasLocationMatcher(ctx: MigrationContext): boolean {
       try {
         const content = fs.readFileSync(path.join(blocksDir, file), "utf-8");
         if (content.includes("website/matchers/location")) return true;
-      } catch { /* skip */ }
+      } catch {
+        /* skip */
+      }
     }
   }
   return false;