jskelet 0.5.4 → 0.6.0

package/src/migrate/classify.mjs

@@ -0,0 +1,155 @@
+/**
+ * Bir kaynak dosyasını page / layout / client / server-component olarak sınıflandırır.
+ */
+import path from "node:path";
+import { t } from "./babel.mjs";
+import { parseSource } from "./parse.mjs";
+
+/**
+ * @typedef {'page' | 'layout' | 'client' | 'server-component' | 'unknown'} FileKind
+ * @typedef {{
+ *   kind: FileKind,
+ *   isClient: boolean,
+ *   hasHooks: boolean,
+ *   hasServerAction: boolean,
+ *   hasSuspense: boolean,
+ *   revalidate: number | null,
+ *   hasGenerateMetadata: boolean,
+ *   hasGenerateStaticParams: boolean,
+ *   reasons: string[],
+ * }} Classification
+ */
+
+/**
+ * @param {string} code
+ * @param {string} filename
+ * @returns {Classification}
+ */
+export function classifySource(code, filename) {
+  const base = path.basename(filename);
+  /** @type {Classification} */
+  const out = {
+    kind: "unknown",
+    isClient: false,
+    hasHooks: false,
+    hasServerAction: false,
+    hasSuspense: false,
+    revalidate: null,
+    hasGenerateMetadata: false,
+    hasGenerateStaticParams: false,
+    reasons: [],
+  };
+
+  if (/^["']use client["'];?/.test(code.trim()) || /\n["']use client["'];?/.test(code)) {
+    out.isClient = true;
+  }
+  if (code.includes('"use server"') || code.includes("'use server'")) {
+    out.hasServerAction = true;
+    out.reasons.push("contains \"use server\"");
+  }
+
+  let ast;
+  try {
+    ast = parseSource(code, filename);
+  } catch (error) {
+    out.reasons.push(
+      `parse error: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    if (out.isClient) out.kind = "client";
+    else if (/^page\./.test(base)) out.kind = "page";
+    else if (/^layout\./.test(base)) out.kind = "layout";
+    return out;
+  }
+
+  for (const node of ast.program.directives ?? []) {
+    if (node.value?.value === "use client") out.isClient = true;
+    if (node.value?.value === "use server") {
+      out.hasServerAction = true;
+      out.reasons.push("directive \"use server\"");
+    }
+  }
+
+  for (const node of ast.program.body) {
+    if (t.isImportDeclaration(node)) {
+      const src = node.source.value;
+      if (src === "react" || src === "react/jsx-runtime") {
+        for (const spec of node.specifiers) {
+          const name =
+            (t.isImportSpecifier(spec) && t.isIdentifier(spec.imported)
+              ? spec.imported.name
+              : null) ||
+            (t.isImportDefaultSpecifier(spec) ? "default" : null);
+          if (name === "Suspense") out.hasSuspense = true;
+          if (
+            name &&
+            /^(use[A-Z]|useState|useEffect|useMemo|useCallback|useRef|useContext|useReducer|useLayoutEffect|useId|useTransition|useDeferredValue|useSyncExternalStore)/.test(
+              name,
+            )
+          ) {
+            out.hasHooks = true;
+          }
+        }
+      }
+    }
+
+    if (
+      t.isExportNamedDeclaration(node) &&
+      node.declaration &&
+      t.isVariableDeclaration(node.declaration)
+    ) {
+      for (const decl of node.declaration.declarations) {
+        if (t.isIdentifier(decl.id) && decl.id.name === "revalidate") {
+          if (t.isNumericLiteral(decl.init)) out.revalidate = decl.init.value;
+          else if (t.isLiteral(decl.init) && typeof decl.init.value === "number") {
+            out.revalidate = /** @type {number} */ (decl.init.value);
+          }
+        }
+      }
+    }
+
+    if (t.isExportNamedDeclaration(node)) {
+      const id = namedExportName(node);
+      if (id === "generateMetadata") out.hasGenerateMetadata = true;
+      if (id === "generateStaticParams") out.hasGenerateStaticParams = true;
+    }
+  }
+
+  // Hook çağrıları (import alias olmadan da)
+  if (/\buse(State|Effect|Memo|Callback|Ref|Context|Reducer)\s*\(/.test(code)) {
+    out.hasHooks = true;
+  }
+
+  if (out.isClient || out.hasHooks) {
+    out.kind = "client";
+  } else if (/^page\./.test(base)) {
+    out.kind = "page";
+  } else if (/^layout\./.test(base)) {
+    out.kind = "layout";
+  } else {
+    out.kind = "server-component";
+  }
+
+  return out;
+}
+
+/**
+ * @param {import('@babel/types').ExportNamedDeclaration} node
+ * @returns {string | null}
+ */
+function namedExportName(node) {
+  if (node.declaration) {
+    if (t.isFunctionDeclaration(node.declaration) && node.declaration.id) {
+      return node.declaration.id.name;
+    }
+    if (t.isVariableDeclaration(node.declaration)) {
+      const id = node.declaration.declarations[0]?.id;
+      if (t.isIdentifier(id)) return id.name;
+    }
+  }
+  for (const spec of node.specifiers) {
+    if (t.isExportSpecifier(spec) && t.isIdentifier(spec.exported)) {
+      return spec.exported.name;
+    }
+  }
+  return null;
+}

package/src/migrate/config.mjs

@@ -0,0 +1,126 @@
+/**
+ * next.config → jskelet.config.mjs taslağı.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { findNextConfig, findClientEnvKeys } from "./fs-walk.mjs";
+
+/**
+ * @param {string} root
+ * @returns {Promise<{ status: 'ok' | 'partial' | 'skipped', notes: string[], code: string | null }>}
+ */
+export async function draftConfig(root) {
+  /** @type {string[]} */
+  const notes = [];
+  const configPath = findNextConfig(root);
+  const clientEnv = findClientEnvKeys(root);
+
+  /** @type {Record<string, unknown>} */
+  let next = {};
+
+  if (!configPath) {
+    notes.push("no next.config.* — emitting minimal jskelet.config.mjs");
+  } else if (configPath.endsWith(".ts")) {
+    notes.push("next.config.ts cannot be imported — copy headers/redirects/rewrites manually");
+  } else {
+    try {
+      const mod = await import(pathToFileURL(configPath).href);
+      next = mod.default ?? mod;
+      if (typeof next === "function") {
+        next = await next({ default: {} });
+      }
+    } catch (error) {
+      notes.push(
+        `could not load next.config: ${error instanceof Error ? error.message : String(error)}`,
+      );
+    }
+  }
+
+  const trailingSlash = Boolean(next.trailingSlash);
+  const deviceSizes =
+    next.images && typeof next.images === "object" && Array.isArray(next.images.deviceSizes)
+      ? next.images.deviceSizes
+      : null;
+
+  if (next.experimental) {
+    notes.push("experimental.* has no JSkelet equivalent — ignored");
+  }
+  if (fs.existsSync(path.join(root, "middleware.ts")) || fs.existsSync(path.join(root, "middleware.js"))) {
+    notes.push("middleware.ts/js → port to Express middleware manually");
+  }
+
+  const headersSrc = fnSource(next.headers, "headers", notes);
+  const redirectsSrc = fnSource(next.redirects, "redirects", notes);
+  const rewritesSrc = fnSource(next.rewrites, "rewrites", notes);
+
+  const clientEnvList =
+    clientEnv.length > 0
+      ? clientEnv.map((k) => JSON.stringify(k)).join(", ")
+      : "";
+
+  const imagesBlock = deviceSizes
+    ? `\n  images: {\n    widths: ${JSON.stringify(deviceSizes)},\n  },\n`
+    : "";
+
+  const code =
+    `/**\n` +
+    ` * Drafted by \`jskelet migrate config\` from ${configPath ? path.basename(configPath) : "defaults"}.\n` +
+    ` * Review before use — complex path-to-regexp patterns are not supported.\n` +
+    ` */\n` +
+    `export default {\n` +
+    `  brand: { lang: "en" },\n` +
+    (trailingSlash ? `  trailingSlash: true,\n` : "") +
+    (clientEnvList ? `  clientEnv: [${clientEnvList}],\n` : "") +
+    imagesBlock +
+    (headersSrc ? `\n  async headers() {\n${headersSrc}\n  },\n` : "") +
+    (redirectsSrc ? `\n  async redirects() {\n${redirectsSrc}\n  },\n` : "") +
+    (rewritesSrc ? `\n  async rewrites() {\n${rewritesSrc}\n  },\n` : "") +
+    `\n  hooks: {\n` +
+    `    metadata() {\n` +
+    `      return {\n` +
+    `        titleTemplate: "%s | Site",\n` +
+    `        description: "",\n` +
+    `      };\n` +
+    `    },\n` +
+    `    layoutContext() {\n` +
+    `      return { bodyClass: "min-h-full" };\n` +
+    `    },\n` +
+    `    notFound() {\n` +
+    `      return {\n` +
+    `        view: "pages/not-found",\n` +
+    `        metadata: { title: "Page not found", robots: { index: false } },\n` +
+    `      };\n` +
+    `    },\n` +
+    `  },\n` +
+    `};\n`;
+
+  return {
+    status: notes.length ? "partial" : "ok",
+    notes,
+    code,
+  };
+}
+
+/**
+ * @param {unknown} value
+ * @param {string} name
+ * @param {string[]} notes
+ * @returns {string | null}
+ */
+function fnSource(value, name, notes) {
+  if (typeof value !== "function") return null;
+  try {
+    const src = Function.prototype.toString.call(value);
+    // "async headers() { ... }" or "headers() { ... }" or arrow
+    const bodyMatch = src.match(/^[^{]*\{([\s\S]*)\}$/);
+    if (!bodyMatch) {
+      notes.push(`${name}() could not be inlined — copy manually`);
+      return `    // TODO[jskelet-migrate]: paste ${name}() from next.config\n    return [];`;
+    }
+    return bodyMatch[1].replace(/^\n/, "").replace(/\n$/, "");
+  } catch {
+    notes.push(`${name}() could not be serialized`);
+    return `    // TODO[jskelet-migrate]: paste ${name}() from next.config\n    return [];`;
+  }
+}

package/src/migrate/fs-walk.mjs

@@ -0,0 +1,191 @@
+/**
+ * Next App Router ağacında dosya keşfi ve path → URL eşlemesi.
+ */
+import fs from "node:fs";
+import path from "node:path";
+
+const PAGE_RE = /^page\.(jsx?|tsx?|mjs|cjs)$/;
+const LAYOUT_RE = /^layout\.(jsx?|tsx?|mjs|cjs)$/;
+const SOURCE_RE = /\.(jsx?|tsx?|mjs|cjs)$/;
+
+/**
+ * @param {string} root
+ * @returns {string | null}
+ */
+export function findAppDir(root) {
+  for (const candidate of ["app", "src/app"]) {
+    const abs = path.join(root, candidate);
+    if (fs.existsSync(abs) && fs.statSync(abs).isDirectory()) return abs;
+  }
+  return null;
+}
+
+/**
+ * @param {string} root
+ * @returns {string | null}
+ */
+export function findNextConfig(root) {
+  for (const name of [
+    "next.config.mjs",
+    "next.config.js",
+    "next.config.cjs",
+    "next.config.ts",
+  ]) {
+    const abs = path.join(root, name);
+    if (fs.existsSync(abs)) return abs;
+  }
+  return null;
+}
+
+/**
+ * @param {string} dir
+ * @param {(rel: string, abs: string) => void} visit
+ * @param {string} [base]
+ */
+export function walkFiles(dir, visit, base = dir) {
+  if (!fs.existsSync(dir)) return;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+    const abs = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      walkFiles(abs, visit, base);
+      continue;
+    }
+    visit(path.relative(base, abs).replace(/\\/g, "/"), abs);
+  }
+}
+
+/**
+ * App Router segment yolunu Express path'ine çevirir.
+ * `news/[slug]` → `/news/:slug`, `docs/[...slug]` → `/docs/:slug*`
+ *
+ * @param {string} relativeDir app/ altındaki dizin (posix, trailing slash yok)
+ * @returns {string}
+ */
+export function segmentToExpressPath(relativeDir) {
+  if (!relativeDir || relativeDir === ".") return "/";
+  const parts = relativeDir.split("/").filter(Boolean);
+  const out = [];
+  for (const part of parts) {
+    if (part.startsWith("(") && part.endsWith(")")) continue; // route groups
+    if (part.startsWith("@")) continue; // parallel routes
+    const catchAll = part.match(/^\[\.\.\.(.+)\]$/);
+    if (catchAll) {
+      out.push(`:${catchAll[1]}*`);
+      continue;
+    }
+    const optional = part.match(/^\[\[\.\.\.(.+)\]\]$/);
+    if (optional) {
+      out.push(`:${optional[1]}*`);
+      continue;
+    }
+    const dyn = part.match(/^\[(.+)\]$/);
+    if (dyn) {
+      out.push(`:${dyn[1]}`);
+      continue;
+    }
+    out.push(part);
+  }
+  return "/" + out.join("/");
+}
+
+/**
+ * Feature adı: ilk anlamlı segment veya `home`.
+ *
+ * @param {string} relativeDir
+ * @returns {string}
+ */
+export function featureNameFromDir(relativeDir) {
+  const parts = relativeDir
+    .split("/")
+    .filter(Boolean)
+    .filter((p) => !(p.startsWith("(") && p.endsWith(")")))
+    .filter((p) => !p.startsWith("@"))
+    .filter((p) => !p.startsWith("["));
+  if (parts.length === 0) return "home";
+  return parts[0].replace(/[^a-zA-Z0-9_-]/g, "-") || "home";
+}
+
+/**
+ * Sayfa dosya gövde adı.
+ *
+ * @param {string} relativeDir
+ * @returns {string}
+ */
+export function pageNameFromDir(relativeDir) {
+  const parts = relativeDir
+    .split("/")
+    .filter(Boolean)
+    .filter((p) => !(p.startsWith("(") && p.endsWith(")")))
+    .filter((p) => !p.startsWith("@"));
+  if (parts.length === 0) return "home";
+  const last = parts[parts.length - 1];
+  if (last.startsWith("[")) {
+    return parts.length > 1 ? parts[parts.length - 2] : "detail";
+  }
+  return last.replace(/[^a-zA-Z0-9_-]/g, "-") || "page";
+}
+
+/**
+ * @param {string} appDir
+ * @returns {{ pages: Array<{ abs: string, rel: string, dir: string, url: string, feature: string, page: string }>, layouts: Array<{ abs: string, rel: string, dir: string, depth: number }>, sources: Array<{ abs: string, rel: string }> }}
+ */
+export function inventoryApp(appDir) {
+  /** @type {Array<{ abs: string, rel: string, dir: string, url: string, feature: string, page: string }>} */
+  const pages = [];
+  /** @type {Array<{ abs: string, rel: string, dir: string, depth: number }>} */
+  const layouts = [];
+  /** @type {Array<{ abs: string, rel: string }>} */
+  const sources = [];
+
+  walkFiles(appDir, (rel, abs) => {
+    const base = path.basename(rel);
+    const dir = path.posix.dirname(rel);
+    const dirKey = dir === "." ? "" : dir;
+
+    if (PAGE_RE.test(base)) {
+      pages.push({
+        abs,
+        rel,
+        dir: dirKey,
+        url: segmentToExpressPath(dirKey),
+        feature: featureNameFromDir(dirKey),
+        page: pageNameFromDir(dirKey),
+      });
+      return;
+    }
+    if (LAYOUT_RE.test(base)) {
+      const depth = dirKey ? dirKey.split("/").length : 0;
+      layouts.push({ abs, rel, dir: dirKey, depth });
+      return;
+    }
+    if (SOURCE_RE.test(base)) {
+      sources.push({ abs, rel });
+    }
+  });
+
+  layouts.sort((a, b) => a.depth - b.depth);
+  pages.sort((a, b) => a.url.localeCompare(b.url));
+  return { pages, layouts, sources };
+}
+
+/**
+ * @param {string} root
+ * @returns {string[]}
+ */
+export function findClientEnvKeys(root) {
+  /** @type {Set<string>} */
+  const keys = new Set();
+  for (const name of [".env", ".env.local", ".env.production", ".env.development"]) {
+    const abs = path.join(root, name);
+    if (!fs.existsSync(abs)) continue;
+    const text = fs.readFileSync(abs, "utf8");
+    for (const line of text.split(/\r?\n/)) {
+      const m = line.match(/^\s*NEXT_PUBLIC_([A-Za-z0-9_]+)\s*=/);
+      if (m) keys.add(m[1]);
+    }
+  }
+  return [...keys].sort();
+}
+
+export { PAGE_RE, LAYOUT_RE, SOURCE_RE };

package/src/migrate/parse.mjs

@@ -0,0 +1,26 @@
+/**
+ * Next.js / React kaynak dosyalarını Babel ile parse eder (JSX + TS).
+ *
+ * `@babel/parser` opsiyonel peerdır; yoksa `getBabel()` kurulum mesajı fırlatır.
+ */
+import { getBabel } from "./babel.mjs";
+
+/**
+ * @param {string} code
+ * @param {string} [filename]
+ * @returns {import('@babel/types').File}
+ */
+export function parseSource(code, filename = "file.tsx") {
+  const { parse } = getBabel();
+  return parse(code, {
+    sourceType: "module",
+    sourceFilename: filename,
+    plugins: [
+      "jsx",
+      "typescript",
+      "importAttributes",
+      "topLevelAwait",
+    ],
+    errorRecovery: false,
+  });
+}

package/src/migrate/scan.mjs

@@ -0,0 +1,177 @@
+/**
+ * Next App Router envanteri + engel listesi.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import {
+  findAppDir,
+  findNextConfig,
+  inventoryApp,
+  findClientEnvKeys,
+  walkFiles,
+} from "./fs-walk.mjs";
+import { ensureBabel } from "./babel.mjs";
+import { classifySource } from "./classify.mjs";
+
+/**
+ * @param {string} root
+ * @returns {object}
+ */
+export function scanProject(root) {
+  // Babel yoksa yüzlerce "parse error" yerine tek net kurulum mesajı.
+  ensureBabel(root);
+
+  const appDir = findAppDir(root);
+  const nextConfig = findNextConfig(root);
+  const clientEnv = findClientEnvKeys(root);
+
+  if (!appDir) {
+    return {
+      root,
+      appDir: null,
+      nextConfig,
+      clientEnv,
+      pages: [],
+      layouts: [],
+      clients: [],
+      components: [],
+      blockers: [
+        {
+          kind: "no-app-dir",
+          message: "No app/ or src/app/ directory found (App Router required).",
+        },
+      ],
+      pagesRouter: fs.existsSync(path.join(root, "pages")),
+    };
+  }
+
+  const inv = inventoryApp(appDir);
+  /** @type {object[]} */
+  const pages = [];
+  /** @type {object[]} */
+  const clients = [];
+  /** @type {object[]} */
+  const components = [];
+  /** @type {object[]} */
+  const blockers = [];
+
+  if (fs.existsSync(path.join(root, "pages"))) {
+    blockers.push({
+      kind: "pages-router",
+      message: "pages/ directory present — Pages Router is out of scope for this codemod.",
+    });
+  }
+
+  const nestedLayouts = inv.layouts.filter((l) => l.depth > 0);
+  if (nestedLayouts.length) {
+    blockers.push({
+      kind: "nested-layouts",
+      message: `${nestedLayouts.length} nested layout(s); JSkelet has a single layout — flatten manually.`,
+      files: nestedLayouts.map((l) => l.rel),
+    });
+  }
+
+  for (const page of inv.pages) {
+    const code = fs.readFileSync(page.abs, "utf8");
+    const classification = classifySource(code, page.rel);
+    pages.push({ ...page, classification });
+    if (classification.hasServerAction) {
+      blockers.push({
+        kind: "server-action",
+        file: page.rel,
+        message: "Server Actions have no equivalent — use app.post handlers.",
+      });
+    }
+    if (classification.hasSuspense) {
+      blockers.push({
+        kind: "suspense",
+        file: page.rel,
+        message: "Suspense / streaming is not supported — use fragment endpoints.",
+      });
+    }
+  }
+
+  for (const layout of inv.layouts) {
+    const code = fs.readFileSync(layout.abs, "utf8");
+    layout.classification = classifySource(code, layout.rel);
+  }
+
+  for (const src of inv.sources) {
+    const code = fs.readFileSync(src.abs, "utf8");
+    const classification = classifySource(code, src.rel);
+    if (classification.kind === "client" || classification.isClient) {
+      clients.push({ ...src, classification });
+    } else if (classification.kind === "server-component") {
+      components.push({ ...src, classification });
+    }
+  }
+
+  for (const dir of ["components", "src/components", "lib/components"]) {
+    const abs = path.join(root, dir);
+    if (!fs.existsSync(abs)) continue;
+    walkFiles(abs, (_rel, fileAbs) => {
+      if (!/\.(jsx?|tsx?)$/.test(fileAbs)) return;
+      const fromRoot = path.relative(root, fileAbs).replace(/\\/g, "/");
+      const code = fs.readFileSync(fileAbs, "utf8");
+      const classification = classifySource(code, fromRoot);
+      if (classification.kind === "client" || classification.isClient) {
+        clients.push({ abs: fileAbs, rel: fromRoot, classification });
+      } else if (classification.kind === "server-component") {
+        components.push({ abs: fileAbs, rel: fromRoot, classification });
+      }
+    });
+  }
+
+  return {
+    root,
+    appDir: path.relative(root, appDir).replace(/\\/g, "/"),
+    nextConfig: nextConfig ? path.relative(root, nextConfig).replace(/\\/g, "/") : null,
+    clientEnv,
+    pages,
+    layouts: inv.layouts,
+    clients,
+    components,
+    blockers,
+    pagesRouter: fs.existsSync(path.join(root, "pages")),
+  };
+}
+
+/**
+ * İnsan-okur özet.
+ * @param {ReturnType<typeof scanProject>} report
+ * @returns {string}
+ */
+export function formatScanReport(report) {
+  const lines = [];
+  lines.push(`Next.js → JSkelet scan`);
+  lines.push(`  app: ${report.appDir ?? "(missing)"}`);
+  lines.push(`  config: ${report.nextConfig ?? "(none)"}`);
+  lines.push(`  pages: ${report.pages.length}`);
+  lines.push(`  layouts: ${report.layouts.length}`);
+  lines.push(`  client modules: ${report.clients.length}`);
+  lines.push(`  server components: ${report.components.length}`);
+  if (report.clientEnv.length) {
+    lines.push(`  NEXT_PUBLIC_* → clientEnv candidates: ${report.clientEnv.join(", ")}`);
+  }
+  if (report.pages.length) {
+    lines.push("");
+    lines.push("Pages:");
+    for (const p of report.pages) {
+      const flags = [];
+      if (p.classification?.revalidate != null) flags.push(`revalidate=${p.classification.revalidate}`);
+      if (p.classification?.hasGenerateMetadata) flags.push("metadata");
+      if (p.classification?.hasGenerateStaticParams) flags.push("staticParams");
+      lines.push(`  ${p.url}  ←  ${p.rel}${flags.length ? `  (${flags.join(", ")})` : ""}`);
+    }
+  }
+  if (report.blockers.length) {
+    lines.push("");
+    lines.push("Blockers:");
+    for (const b of report.blockers) {
+      lines.push(`  ⚠ ${b.message}${b.file ? ` [${b.file}]` : ""}`);
+    }
+  }
+  lines.push("");
+  lines.push("Next: jskelet migrate apply [--write]  |  jskelet migrate config [--write]");
+  return lines.join("\n");
+}