@decocms/start 0.31.1 → 0.32.1

package/scripts/migrate/phase-verify.ts

@@ -0,0 +1,308 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { MigrationContext } from "./types.ts";
+import { logPhase } from "./types.ts";
+
+interface Check {
+  name: string;
+  fn: (ctx: MigrationContext) => boolean;
+  severity: "error" | "warning";
+}
+
+const REQUIRED_FILES = [
+  "package.json",
+  "tsconfig.json",
+  "vite.config.ts",
+  "wrangler.jsonc",
+  "knip.config.ts",
+  ".prettierrc",
+  "src/server.ts",
+  "src/worker-entry.ts",
+  "src/router.tsx",
+  "src/runtime.ts",
+  "src/context.ts",
+  "src/setup.ts",
+  "src/styles/app.css",
+  "src/apps/site.ts",
+  "src/routes/__root.tsx",
+  "src/routes/index.tsx",
+  "src/routes/$.tsx",
+  "src/routes/deco/meta.ts",
+  "src/routes/deco/invoke.$.ts",
+  "src/routes/deco/render.ts",
+];
+
+const MUST_NOT_EXIST = [
+  "deno.json",
+  "fresh.gen.ts",
+  "manifest.gen.ts",
+  "dev.ts",
+  "main.ts",
+  "islands/BlogFeed.tsx",
+  "routes/_app.tsx",
+];
+
+const checks: Check[] = [
+  {
+    name: "All scaffolded files exist",
+    severity: "error",
+    fn: (ctx) => {
+      const missing = REQUIRED_FILES.filter(
+        (f) => !fs.existsSync(path.join(ctx.sourceDir, f)),
+      );
+      if (missing.length > 0) {
+        console.log(`    Missing: ${missing.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "Old artifacts removed",
+    severity: "error",
+    fn: (ctx) => {
+      const remaining = MUST_NOT_EXIST.filter(
+        (f) => fs.existsSync(path.join(ctx.sourceDir, f)),
+      );
+      if (remaining.length > 0) {
+        console.log(`    Still exists: ${remaining.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No preact imports in src/",
+    severity: "error",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /from\s+["']preact/);
+      if (bad.length > 0) {
+        console.log(`    Still has preact imports: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No $fresh imports in src/",
+    severity: "error",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /from\s+["']\$fresh/);
+      if (bad.length > 0) {
+        console.log(`    Still has $fresh imports: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No deno-lint-ignore in src/",
+    severity: "warning",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /deno-lint-ignore/);
+      if (bad.length > 0) {
+        console.log(`    Still has deno-lint-ignore: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: 'No class= in JSX (should be className=)',
+    severity: "warning",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /<[a-zA-Z][^>]*\sclass\s*=/);
+      if (bad.length > 0) {
+        console.log(`    Still has class= in JSX: ${bad.slice(0, 5).join(", ")}${bad.length > 5 ? ` (+${bad.length - 5} more)` : ""}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "public/ has static assets",
+    severity: "warning",
+    fn: (ctx) => {
+      const publicDir = path.join(ctx.sourceDir, "public");
+      if (!fs.existsSync(publicDir)) {
+        console.log("    public/ directory missing");
+        return false;
+      }
+      const hasSprites = fs.existsSync(
+        path.join(publicDir, "sprites.svg"),
+      );
+      const hasFavicon = fs.existsSync(
+        path.join(publicDir, "favicon.ico"),
+      );
+      if (!hasSprites) console.log("    Missing: public/sprites.svg");
+      if (!hasFavicon) console.log("    Missing: public/favicon.ico");
+      return hasSprites && hasFavicon;
+    },
+  },
+  {
+    name: "package.json has correct dependencies",
+    severity: "error",
+    fn: (ctx) => {
+      const pkgPath = path.join(ctx.sourceDir, "package.json");
+      if (!fs.existsSync(pkgPath)) return false;
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      const required = [
+        "@decocms/start",
+        "@decocms/apps",
+        "react",
+        "react-dom",
+        "@tanstack/react-start",
+        "vite",
+        "knip",
+      ];
+      const missing = required.filter((d) => !deps[d]);
+      if (missing.length > 0) {
+        console.log(`    Missing deps: ${missing.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No site/ imports (should be ~/)",
+    severity: "warning",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /from\s+["']site\//);
+      if (bad.length > 0) {
+        console.log(`    Still has site/ imports: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No .ts/.tsx extensions in relative import paths",
+    severity: "warning",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      // Match relative imports with .ts/.tsx extensions
+      const bad = findFilesWithPattern(srcDir, /from\s+["'](?:\.\.?\/|~\/)[^"']*\.tsx?["']/);
+      if (bad.length > 0) {
+        console.log(`    Still has .ts/.tsx extensions in imports: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No for= in JSX (should be htmlFor=)",
+    severity: "warning",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /<label[^>]*\sfor\s*=/);
+      if (bad.length > 0) {
+        console.log(`    Still has for= in JSX: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No relative imports to deleted SDK files",
+    severity: "error",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      // Only match relative imports (../ or ./) to deleted SDK files, not @decocms/* package imports
+      const bad = findFilesWithPattern(srcDir, /from\s+["'](?:\.\.?\/)[^"']*\/sdk\/(?:clx|useId|useOffer|useVariantPossiblities|usePlatform)["']/);
+      if (bad.length > 0) {
+        console.log(`    Still has relative imports to deleted SDK files: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+  {
+    name: "No imports to deleted static files",
+    severity: "error",
+    fn: (ctx) => {
+      const srcDir = path.join(ctx.sourceDir, "src");
+      if (!fs.existsSync(srcDir)) return true;
+      const bad = findFilesWithPattern(srcDir, /from\s+["'][^"']*static\/adminIcons/);
+      if (bad.length > 0) {
+        console.log(`    Still has imports to static/adminIcons: ${bad.join(", ")}`);
+        return false;
+      }
+      return true;
+    },
+  },
+];
+
+function findFilesWithPattern(
+  dir: string,
+  pattern: RegExp,
+  results: string[] = [],
+  baseDir?: string,
+): string[] {
+  const root = baseDir ?? dir;
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git" || entry.name === "server") continue;
+      findFilesWithPattern(fullPath, pattern, results, root);
+    } else if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) {
+      const content = fs.readFileSync(fullPath, "utf-8");
+      if (pattern.test(content)) {
+        results.push(path.basename(fullPath));
+      }
+    }
+  }
+  return results;
+}
+
+export function verify(ctx: MigrationContext): boolean {
+  logPhase("Verify (Smoke Test)");
+
+  if (ctx.dryRun) {
+    console.log("  Skipping verify in dry-run mode\n");
+    return true;
+  }
+
+  let errors = 0;
+  let warnings = 0;
+
+  for (const check of checks) {
+    const pass = check.fn(ctx);
+    const icon = pass ? "\x1b[32m✓\x1b[0m" : check.severity === "error" ? "\x1b[31m✗\x1b[0m" : "\x1b[33m⚠\x1b[0m";
+    console.log(`  ${icon} ${check.name}`);
+    if (!pass) {
+      if (check.severity === "error") errors++;
+      else warnings++;
+    }
+  }
+
+  console.log(
+    `\n  Result: ${checks.length - errors - warnings} passed, ${errors} errors, ${warnings} warnings`,
+  );
+
+  if (errors > 0) {
+    console.log("  \x1b[31mVerification FAILED — migration has issues that must be fixed\x1b[0m");
+    return false;
+  }
+  if (warnings > 0) {
+    console.log("  \x1b[33mVerification passed with warnings\x1b[0m");
+  } else {
+    console.log("  \x1b[32mVerification PASSED\x1b[0m");
+  }
+
+  return true;
+}

package/scripts/migrate/templates/knip-config.ts

@@ -0,0 +1,27 @@
+export function generateKnipConfig(): string {
+  return `import type { KnipConfig } from "knip";
+
+const config: KnipConfig = {
+  entry: [
+    "src/routes/**/*.{ts,tsx}",
+    "src/setup.ts",
+    "src/runtime.ts",
+    "src/sections/**/*.{ts,tsx}",
+    "vite.config.ts",
+  ],
+  project: ["src/**/*.{ts,tsx}"],
+  ignore: [
+    "src/server/invoke.gen.ts",
+    "src/server/cms/blocks.gen.ts",
+    "src/routeTree.gen.ts",
+  ],
+  ignoreDependencies: [
+    "babel-plugin-react-compiler",
+    "@vitejs/plugin-react",
+    "wrangler",
+  ],
+};
+
+export default config;
+`;
+}

package/scripts/migrate/templates/package-json.ts

@@ -0,0 +1,98 @@
+import type { MigrationContext } from "../types.ts";
+
+/**
+ * Extract npm dependencies from deno.json import map.
+ * Entries like `"fuse.js": "npm:fuse.js@7.0.0"` become `"fuse.js": "^7.0.0"`.
+ */
+function extractNpmDeps(importMap: Record<string, string>): Record<string, string> {
+  const deps: Record<string, string> = {};
+  for (const [key, value] of Object.entries(importMap)) {
+    if (!value.startsWith("npm:")) continue;
+    // Skip preact, deco, and other framework deps we handle ourselves
+    if (key.startsWith("preact") || key.startsWith("@preact/")) continue;
+    if (key.startsWith("@deco/")) continue;
+    if (key === "daisyui") continue; // we pin our own version
+
+    const raw = value.slice(4); // remove "npm:"
+    const atIdx = raw.lastIndexOf("@");
+    if (atIdx <= 0) {
+      deps[raw] = "*";
+    } else {
+      const name = raw.slice(0, atIdx);
+      const version = raw.slice(atIdx + 1);
+      deps[name] = `^${version}`;
+    }
+  }
+  return deps;
+}
+
+export function generatePackageJson(ctx: MigrationContext): string {
+  const siteDeps = {
+    ...extractNpmDeps(ctx.importMap),
+    ...ctx.discoveredNpmDeps,
+  };
+
+  const pkg = {
+    name: ctx.siteName,
+    version: "0.1.0",
+    type: "module",
+    description: `${ctx.siteName} storefront powered by TanStack Start`,
+    scripts: {
+      dev: "vite dev",
+      "generate:blocks":
+        "tsx node_modules/@decocms/start/scripts/generate-blocks.ts",
+      "generate:routes": "tsr generate",
+      "generate:schema": `tsx node_modules/@decocms/start/scripts/generate-schema.ts --site ${ctx.siteName}`,
+      build:
+        "npm run generate:blocks && npm run generate:schema && tsr generate && vite build",
+      preview: "vite preview",
+      deploy: "npm run build && wrangler deploy",
+      types: "wrangler types",
+      typecheck: "tsc --noEmit",
+      format: 'prettier --write "src/**/*.{ts,tsx}"',
+      "format:check": 'prettier --check "src/**/*.{ts,tsx}"',
+      knip: "knip",
+      clean:
+        "rm -rf node_modules .cache dist .wrangler/state node_modules/.vite && npm install",
+      "tailwind:lint":
+        "tsx node_modules/@decocms/start/scripts/tailwind-lint.ts",
+      "tailwind:fix":
+        "tsx node_modules/@decocms/start/scripts/tailwind-lint.ts --fix",
+    },
+    author: "deco.cx",
+    license: "MIT",
+    dependencies: {
+      "@decocms/apps": "^0.25.2",
+      "@decocms/start": "^0.32.0",
+      "@tanstack/react-query": "5.90.21",
+      "@tanstack/react-router": "1.166.7",
+      "@tanstack/react-start": "1.166.8",
+      "@tanstack/react-store": "0.9.2",
+      "@tanstack/store": "0.9.2",
+      "colorjs.io": "^0.6.1",
+      react: "^19.2.4",
+      "react-dom": "^19.2.4",
+      ...siteDeps,
+    },
+    devDependencies: {
+      "@cloudflare/vite-plugin": "^1.27.0",
+      "@tailwindcss/vite": "^4.2.1",
+      "@tanstack/router-cli": "1.166.7",
+      "@types/react": "^19.2.14",
+      "@types/react-dom": "^19.2.3",
+      "@vitejs/plugin-react": "^5.1.4",
+      "babel-plugin-react-compiler": "^1.0.0",
+      "daisyui": "^5.5.19",
+      knip: "^5.61.2",
+      prettier: "^3.5.3",
+      tailwindcss: "^4.2.1",
+      "ts-morph": "^27.0.2",
+      tsx: "^4.19.4",
+      typescript: "^5.9.3",
+      vite: "^7.3.1",
+      wrangler: "^4.72.0",
+    },
+  };
+
+  return JSON.stringify(pkg, null, 2) + "\n";
+}