jskelet 0.6.1 → 0.6.3

package/src/migrate/transform/expr-source.mjs

@@ -1,168 +1,168 @@
-/**
- * Babel ifade → kaynak metin + JSK parseExpr doğrulaması.
- * `@babel/generator` yok; JSX attr / {{ }} için yeterli alt küme basılır.
- */
-import { t } from "../babel.mjs";
-import { parseExpr } from "../../compile/expr.js";
-
-/**
- * @param {import('@babel/types').Node} node
- * @returns {string}
- */
-export function exprToSource(node) {
-  if (t.isTSAsExpression(node) || t.isTSTypeAssertion(node) || t.isTSNonNullExpression(node)) {
-    return exprToSource(/** @type {{ expression: import('@babel/types').Expression }} */ (node).expression);
-  }
-  if (t.isParenthesizedExpression(node)) {
-    return `(${exprToSource(node.expression)})`;
-  }
-  if (t.isIdentifier(node)) return node.name;
-  if (t.isStringLiteral(node)) return JSON.stringify(node.value);
-  if (t.isNumericLiteral(node)) return String(node.value);
-  if (t.isBooleanLiteral(node)) return node.value ? "true" : "false";
-  if (t.isNullLiteral(node)) return "null";
-  if (t.isBigIntLiteral(node)) return node.value + "n";
-
-  if (t.isMemberExpression(node) || t.isOptionalMemberExpression(node)) {
-    const obj = exprToSource(node.object);
-    const opt = "optional" in node && node.optional ? "?." : ".";
-    if (node.computed) {
-      return `${obj}${opt === "?." ? "?." : ""}[${exprToSource(/** @type {import('@babel/types').Expression} */ (node.property))}]`;
-    }
-    if (t.isIdentifier(node.property)) {
-      return `${obj}${opt}${node.property.name}`;
-    }
-    return `${obj}.${exprToSource(node.property)}`;
-  }
-
-  if (t.isUnaryExpression(node)) {
-    return `${node.operator}${exprToSource(node.argument)}`;
-  }
-
-  if (t.isBinaryExpression(node) || t.isLogicalExpression(node)) {
-    return `${exprToSource(/** @type {import('@babel/types').Expression} */ (node.left))} ${node.operator} ${exprToSource(node.right)}`;
-  }
-
-  if (t.isConditionalExpression(node)) {
-    return `${exprToSource(node.test)} ? ${exprToSource(node.consequent)} : ${exprToSource(node.alternate)}`;
-  }
-
-  if (t.isTemplateLiteral(node)) {
-    let out = "`";
-    for (let i = 0; i < node.quasis.length; i++) {
-      out += node.quasis[i].value.cooked ?? node.quasis[i].value.raw;
-      if (i < node.expressions.length) {
-        out += "${" + exprToSource(node.expressions[i]) + "}";
-      }
-    }
-    return out + "`";
-  }
-
-  if (t.isArrayExpression(node)) {
-    return `[${node.elements.map((el) => (el ? exprToSource(el) : "")).join(", ")}]`;
-  }
-
-  if (t.isObjectExpression(node)) {
-    const props = node.properties.map((p) => {
-      if (t.isSpreadElement(p)) return `...${exprToSource(p.argument)}`;
-      if (t.isObjectMethod(p)) return `/* method */`;
-      if (t.isObjectProperty(p)) {
-        const key = t.isIdentifier(p.key) && !p.computed ? p.key.name : exprToSource(p.key);
-        return `${key}: ${exprToSource(/** @type {import('@babel/types').Expression} */ (p.value))}`;
-      }
-      return "";
-    });
-    return `{ ${props.join(", ")} }`;
-  }
-
-  if (t.isCallExpression(node)) {
-    const callee = exprToSource(node.callee);
-    const args = node.arguments.map((a) => exprToSource(/** @type {import('@babel/types').Node} */ (a))).join(", ");
-    return `${callee}(${args})`;
-  }
-
-  if (t.isAwaitExpression(node)) {
-    return `await ${exprToSource(node.argument)}`;
-  }
-
-  if (t.isArrowFunctionExpression(node) || t.isFunctionExpression(node)) {
-    return `/* function */`;
-  }
-
-  if (t.isThisExpression(node)) return "this";
-
-  return `/* unsupported:${node.type} */`;
-}
-
-/**
- * @param {string} source
- * @returns {boolean}
- */
-export function isJskExpr(source) {
-  if (!source || source.includes("/* unsupported")) return false;
-  try {
-    parseExpr(source);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * @param {import('@babel/types').Expression} expr
- * @returns {{ ok: true, source: string } | { ok: false, reason: string }}
- */
-export function tryJskExpr(expr) {
-  if (t.isStringLiteral(expr)) {
-    return { ok: true, source: JSON.stringify(expr.value) };
-  }
-  if (t.isNumericLiteral(expr)) {
-    return { ok: true, source: String(expr.value) };
-  }
-  if (t.isBooleanLiteral(expr)) {
-    return { ok: true, source: expr.value ? "true" : "false" };
-  }
-  if (t.isNullLiteral(expr)) {
-    return { ok: true, source: "null" };
-  }
-
-  const source = exprToSource(expr);
-  if (isJskExpr(source)) return { ok: true, source };
-  return { ok: false, reason: `expression not valid in .jsk: ${source}` };
-}
-
-/**
- * @param {import('@babel/types').Expression} expr
- * @param {Set<string>} out
- */
-export function collectRootIdents(expr, out) {
-  if (t.isIdentifier(expr)) {
-    out.add(expr.name);
-    return;
-  }
-  if (t.isMemberExpression(expr) || t.isOptionalMemberExpression(expr)) {
-    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.object), out);
-    return;
-  }
-  if (t.isConditionalExpression(expr)) {
-    collectRootIdents(expr.test, out);
-    collectRootIdents(expr.consequent, out);
-    collectRootIdents(expr.alternate, out);
-    return;
-  }
-  if (t.isLogicalExpression(expr) || t.isBinaryExpression(expr)) {
-    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.left), out);
-    collectRootIdents(expr.right, out);
-    return;
-  }
-  if (t.isUnaryExpression(expr)) {
-    collectRootIdents(expr.argument, out);
-    return;
-  }
-  if (t.isCallExpression(expr)) {
-    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.callee), out);
-    for (const arg of expr.arguments) {
-      if (t.isExpression(arg)) collectRootIdents(arg, out);
-    }
-  }
-}
+/**
+ * Babel ifade → kaynak metin + JSK parseExpr doğrulaması.
+ * `@babel/generator` yok; JSX attr / {{ }} için yeterli alt küme basılır.
+ */
+import { t } from "../babel.mjs";
+import { parseExpr } from "../../compile/expr.js";
+
+/**
+ * @param {import('@babel/types').Node} node
+ * @returns {string}
+ */
+export function exprToSource(node) {
+  if (t.isTSAsExpression(node) || t.isTSTypeAssertion(node) || t.isTSNonNullExpression(node)) {
+    return exprToSource(/** @type {{ expression: import('@babel/types').Expression }} */ (node).expression);
+  }
+  if (t.isParenthesizedExpression(node)) {
+    return `(${exprToSource(node.expression)})`;
+  }
+  if (t.isIdentifier(node)) return node.name;
+  if (t.isStringLiteral(node)) return JSON.stringify(node.value);
+  if (t.isNumericLiteral(node)) return String(node.value);
+  if (t.isBooleanLiteral(node)) return node.value ? "true" : "false";
+  if (t.isNullLiteral(node)) return "null";
+  if (t.isBigIntLiteral(node)) return node.value + "n";
+
+  if (t.isMemberExpression(node) || t.isOptionalMemberExpression(node)) {
+    const obj = exprToSource(node.object);
+    const opt = "optional" in node && node.optional ? "?." : ".";
+    if (node.computed) {
+      return `${obj}${opt === "?." ? "?." : ""}[${exprToSource(/** @type {import('@babel/types').Expression} */ (node.property))}]`;
+    }
+    if (t.isIdentifier(node.property)) {
+      return `${obj}${opt}${node.property.name}`;
+    }
+    return `${obj}.${exprToSource(node.property)}`;
+  }
+
+  if (t.isUnaryExpression(node)) {
+    return `${node.operator}${exprToSource(node.argument)}`;
+  }
+
+  if (t.isBinaryExpression(node) || t.isLogicalExpression(node)) {
+    return `${exprToSource(/** @type {import('@babel/types').Expression} */ (node.left))} ${node.operator} ${exprToSource(node.right)}`;
+  }
+
+  if (t.isConditionalExpression(node)) {
+    return `${exprToSource(node.test)} ? ${exprToSource(node.consequent)} : ${exprToSource(node.alternate)}`;
+  }
+
+  if (t.isTemplateLiteral(node)) {
+    let out = "`";
+    for (let i = 0; i < node.quasis.length; i++) {
+      out += node.quasis[i].value.cooked ?? node.quasis[i].value.raw;
+      if (i < node.expressions.length) {
+        out += "${" + exprToSource(node.expressions[i]) + "}";
+      }
+    }
+    return out + "`";
+  }
+
+  if (t.isArrayExpression(node)) {
+    return `[${node.elements.map((el) => (el ? exprToSource(el) : "")).join(", ")}]`;
+  }
+
+  if (t.isObjectExpression(node)) {
+    const props = node.properties.map((p) => {
+      if (t.isSpreadElement(p)) return `...${exprToSource(p.argument)}`;
+      if (t.isObjectMethod(p)) return `/* method */`;
+      if (t.isObjectProperty(p)) {
+        const key = t.isIdentifier(p.key) && !p.computed ? p.key.name : exprToSource(p.key);
+        return `${key}: ${exprToSource(/** @type {import('@babel/types').Expression} */ (p.value))}`;
+      }
+      return "";
+    });
+    return `{ ${props.join(", ")} }`;
+  }
+
+  if (t.isCallExpression(node)) {
+    const callee = exprToSource(node.callee);
+    const args = node.arguments.map((a) => exprToSource(/** @type {import('@babel/types').Node} */ (a))).join(", ");
+    return `${callee}(${args})`;
+  }
+
+  if (t.isAwaitExpression(node)) {
+    return `await ${exprToSource(node.argument)}`;
+  }
+
+  if (t.isArrowFunctionExpression(node) || t.isFunctionExpression(node)) {
+    return `/* function */`;
+  }
+
+  if (t.isThisExpression(node)) return "this";
+
+  return `/* unsupported:${node.type} */`;
+}
+
+/**
+ * @param {string} source
+ * @returns {boolean}
+ */
+export function isJskExpr(source) {
+  if (!source || source.includes("/* unsupported")) return false;
+  try {
+    parseExpr(source);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * @param {import('@babel/types').Expression} expr
+ * @returns {{ ok: true, source: string } | { ok: false, reason: string }}
+ */
+export function tryJskExpr(expr) {
+  if (t.isStringLiteral(expr)) {
+    return { ok: true, source: JSON.stringify(expr.value) };
+  }
+  if (t.isNumericLiteral(expr)) {
+    return { ok: true, source: String(expr.value) };
+  }
+  if (t.isBooleanLiteral(expr)) {
+    return { ok: true, source: expr.value ? "true" : "false" };
+  }
+  if (t.isNullLiteral(expr)) {
+    return { ok: true, source: "null" };
+  }
+
+  const source = exprToSource(expr);
+  if (isJskExpr(source)) return { ok: true, source };
+  return { ok: false, reason: `expression not valid in .jsk: ${source}` };
+}
+
+/**
+ * @param {import('@babel/types').Expression} expr
+ * @param {Set<string>} out
+ */
+export function collectRootIdents(expr, out) {
+  if (t.isIdentifier(expr)) {
+    out.add(expr.name);
+    return;
+  }
+  if (t.isMemberExpression(expr) || t.isOptionalMemberExpression(expr)) {
+    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.object), out);
+    return;
+  }
+  if (t.isConditionalExpression(expr)) {
+    collectRootIdents(expr.test, out);
+    collectRootIdents(expr.consequent, out);
+    collectRootIdents(expr.alternate, out);
+    return;
+  }
+  if (t.isLogicalExpression(expr) || t.isBinaryExpression(expr)) {
+    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.left), out);
+    collectRootIdents(expr.right, out);
+    return;
+  }
+  if (t.isUnaryExpression(expr)) {
+    collectRootIdents(expr.argument, out);
+    return;
+  }
+  if (t.isCallExpression(expr)) {
+    collectRootIdents(/** @type {import('@babel/types').Expression} */ (expr.callee), out);
+    for (const arg of expr.arguments) {
+      if (t.isExpression(arg)) collectRootIdents(arg, out);
+    }
+  }
+}

package/src/migrate/transform/island.mjs

@@ -1,67 +1,67 @@
-/**
- * `"use client"` → island `mount()` iskeleti.
- */
-import path from "node:path";
-
-/**
- * @typedef {{ status: 'ok' | 'partial' | 'skipped', notes: string[], code: string | null, islandName: string }} IslandResult
- */
-
-/**
- * @param {string} code
- * @param {string} filename
- * @param {{ name?: string }} [options]
- * @returns {IslandResult}
- */
-export function transformIsland(code, filename, options = {}) {
-  const base = path.basename(filename).replace(/\.(jsx?|tsx?|mjs|cjs)$/, "");
-  const islandName = options.name ?? camel(base);
-  /** @type {IslandResult} */
-  const result = {
-    status: "partial",
-    notes: [],
-    code: null,
-    islandName,
-  };
-
-  const hasHooks = /\buse(State|Effect|Memo|Callback|Ref|Context|Reducer)\s*\(/.test(code);
-  if (hasHooks) {
-    result.notes.push("hooks require a manual port into mount()");
-  }
-  if (!/["']use client["']/.test(code) && !hasHooks) {
-    result.notes.push("no \"use client\" directive — treating as island candidate anyway");
-  }
-
-  result.code =
-    `/**\n` +
-    ` * Island migrated from ${filename.replace(/\\/g, "/")}\n` +
-    ` * Register: registerAll({ ${islandName}: () => import("./${islandName}.js") })\n` +
-    ` * Markup: <div data-island="${islandName}" data-island-props='{}'></div>\n` +
-    ` */\n` +
-    `/**\n` +
-    ` * @param {HTMLElement} el\n` +
-    ` * @param {Record<string, unknown>} [props]\n` +
-    ` */\n` +
-    `export function mount(el, props = {}) {\n` +
-    `  // TODO[jskelet-migrate]: port client logic from ${path.basename(filename)}\n` +
-    (hasHooks
-      ? `  // Original file used React hooks — rewrite with plain DOM + events.\n`
-      : "") +
-    `  el.textContent = "";\n` +
-    `  void props;\n` +
-    `}\n`;
-
-  return result;
-}
-
-/**
- * @param {string} name
- * @returns {string}
- */
-function camel(name) {
-  return name
-    .split(/[-_/]+/)
-    .filter(Boolean)
-    .map((p, i) => (i === 0 ? p.toLowerCase() : p.charAt(0).toUpperCase() + p.slice(1)))
-    .join("");
-}
+/**
+ * `"use client"` → island `mount()` iskeleti.
+ */
+import path from "node:path";
+
+/**
+ * @typedef {{ status: 'ok' | 'partial' | 'skipped', notes: string[], code: string | null, islandName: string }} IslandResult
+ */
+
+/**
+ * @param {string} code
+ * @param {string} filename
+ * @param {{ name?: string }} [options]
+ * @returns {IslandResult}
+ */
+export function transformIsland(code, filename, options = {}) {
+  const base = path.basename(filename).replace(/\.(jsx?|tsx?|mjs|cjs)$/, "");
+  const islandName = options.name ?? camel(base);
+  /** @type {IslandResult} */
+  const result = {
+    status: "partial",
+    notes: [],
+    code: null,
+    islandName,
+  };
+
+  const hasHooks = /\buse(State|Effect|Memo|Callback|Ref|Context|Reducer)\s*\(/.test(code);
+  if (hasHooks) {
+    result.notes.push("hooks require a manual port into mount()");
+  }
+  if (!/["']use client["']/.test(code) && !hasHooks) {
+    result.notes.push("no \"use client\" directive — treating as island candidate anyway");
+  }
+
+  result.code =
+    `/**\n` +
+    ` * Island migrated from ${filename.replace(/\\/g, "/")}\n` +
+    ` * Register: registerAll({ ${islandName}: () => import("./${islandName}.js") })\n` +
+    ` * Markup: <div data-island="${islandName}" data-island-props='{}'></div>\n` +
+    ` */\n` +
+    `/**\n` +
+    ` * @param {HTMLElement} el\n` +
+    ` * @param {Record<string, unknown>} [props]\n` +
+    ` */\n` +
+    `export function mount(el, props = {}) {\n` +
+    `  // TODO[jskelet-migrate]: port client logic from ${path.basename(filename)}\n` +
+    (hasHooks
+      ? `  // Original file used React hooks — rewrite with plain DOM + events.\n`
+      : "") +
+    `  el.textContent = "";\n` +
+    `  void props;\n` +
+    `}\n`;
+
+  return result;
+}
+
+/**
+ * @param {string} name
+ * @returns {string}
+ */
+function camel(name) {
+  return name
+    .split(/[-_/]+/)
+    .filter(Boolean)
+    .map((p, i) => (i === 0 ? p.toLowerCase() : p.charAt(0).toUpperCase() + p.slice(1)))
+    .join("");
+}