auto-server-split 0.0.0-stage → 1.0.0

package/dist/eslint/index.js

@@ -0,0 +1,176 @@
+import {
+  analyzeFile,
+  checkAnalyzed,
+  createRunContext,
+  ensureLoaded,
+  findConfigFile,
+  loadConfigFileSync,
+  measureAnalyzed,
+  resolveConfig,
+  setSourceText
+} from "../chunk-6OAWHATP.js";
+import {
+  BundleMeasurer
+} from "../chunk-YQKO5FJM.js";
+import "../chunk-YCSBOPV3.js";
+
+// src/eslint/rules/prefer-server-split.ts
+import path2 from "path";
+
+// src/eslint/engine.ts
+import { existsSync, realpathSync } from "fs";
+import path from "path";
+var DEFAULT_MIN_STATIC_RATIO = 0.5;
+var runs = /* @__PURE__ */ new Map();
+var configs = /* @__PURE__ */ new Map();
+function findTsconfig(file) {
+  let dir = path.dirname(file);
+  for (; ; ) {
+    for (const name of ["tsconfig.json", "jsconfig.json"]) {
+      const candidate = path.join(dir, name);
+      if (existsSync(candidate)) return candidate;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function projectConfig(root) {
+  if (!configs.has(root)) {
+    const file = findConfigFile(root);
+    configs.set(root, file ? loadConfigFileSync(file) : void 0);
+  }
+  return configs.get(root);
+}
+function importerClosure(run, file) {
+  const out = /* @__PURE__ */ new Set();
+  const queue = [file];
+  while (queue.length > 0) {
+    const target = queue.shift();
+    for (const edge of run.graph.importersOf(target)) {
+      if (edge.kind === "type" || out.has(edge.from)) continue;
+      out.add(edge.from);
+      if (edge.kind === "reexport") queue.push(edge.from);
+    }
+  }
+  return [...out];
+}
+function analyzeForLint(args) {
+  const found = args.tsconfig ?? findTsconfig(args.file);
+  if (!found || !existsSync(found)) return void 0;
+  const tsconfig = realpathSync(found);
+  const file = realpathSync(args.file);
+  const root = path.dirname(tsconfig);
+  const fileConfig = projectConfig(root);
+  const minStaticRatio = Math.max(
+    args.options.minStaticRatio ?? DEFAULT_MIN_STATIC_RATIO,
+    resolveConfig(fileConfig).minStaticRatio
+  );
+  const key = `${args.typed ? "typed" : "lazy"}\0${tsconfig}\0${minStaticRatio}`;
+  let run = runs.get(key);
+  if (!run) {
+    const config = resolveConfig(fileConfig, { minStaticRatio, prettier: false });
+    run = createRunContext(root, config, { lazy: !args.typed, tsconfig });
+    runs.set(key, run);
+  }
+  const node = run.graph.nodes.get(file);
+  if (!node?.inProgram) return void 0;
+  if (!args.typed) ensureLoaded(run.loaded, [file, ...importerClosure(run, file)]);
+  const sf = run.loaded.project.getSourceFile(file);
+  if (!sf) return void 0;
+  if (sf.getFullText() !== args.text) setSourceText(sf, args.text);
+  const analyzed = analyzeFile(run, file);
+  if (!analyzed.ok) return analyzed;
+  if (args.options.selfCheck !== false) {
+    const checked = checkAnalyzed(run, analyzed.value);
+    if (!checked.ok) return checked;
+  }
+  if (args.options.measure !== false) {
+    run.measurer ??= new BundleMeasurer(root, run.graph, run.loaded.configFile);
+    const saving = measureAnalyzed(run, analyzed.value);
+    if (!saving.ok) return saving;
+  }
+  return analyzed;
+}
+
+// src/eslint/rules/prefer-server-split.ts
+var preferServerSplit = {
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: 'Suggest splitting partly-interactive "use client" components into a Server Component plus client islands'
+    },
+    schema: [
+      {
+        type: "object",
+        properties: {
+          minStaticRatio: { type: "number", minimum: 0, maximum: 1 },
+          selfCheck: { type: "boolean" },
+          measure: { type: "boolean" }
+        },
+        additionalProperties: false
+      }
+    ],
+    messages: {
+      preferSplit: "{{component}} is {{ratio}}% static with {{count}} interactive island{{plural}} ({{tags}}). Run: npx auto-server-split {{file}} --write"
+    }
+  },
+  create(context) {
+    const [options = {}] = context.options;
+    return {
+      Program(program) {
+        const directive = program.body.find(
+          (statement) => statement.type === "ExpressionStatement" && "directive" in statement && statement.directive === "use client"
+        );
+        if (!directive) return;
+        const file = context.physicalFilename;
+        if (!/\.(tsx|jsx|ts|js|mts|mjs)$/.test(file) || !path2.isAbsolute(file)) return;
+        const services = context.sourceCode.parserServices;
+        const tsProgram = services?.program ?? void 0;
+        const configFilePath = tsProgram?.getCompilerOptions().configFilePath;
+        const result = analyzeForLint({
+          file,
+          text: context.sourceCode.text,
+          typed: tsProgram !== void 0,
+          tsconfig: typeof configFilePath === "string" ? configFilePath : void 0,
+          options
+        });
+        if (!result?.ok) return;
+        const { islands, staticRatio, componentName } = result.value;
+        const tags = [...new Set(islands.map((i) => `<${i.rootTag}>`))].join(", ");
+        context.report({
+          node: directive,
+          messageId: "preferSplit",
+          data: {
+            component: componentName,
+            ratio: String(Math.round(staticRatio * 100)),
+            count: String(islands.length),
+            plural: islands.length === 1 ? "" : "s",
+            tags,
+            file: path2.relative(context.cwd, file).split(path2.sep).join("/")
+          }
+        });
+      }
+    };
+  }
+};
+
+// src/eslint/index.ts
+var plugin = {
+  meta: {
+    name: "auto-server-split",
+    version: true ? "1.0.0" : "0.0.0-dev"
+  },
+  rules: { "prefer-server-split": preferServerSplit },
+  configs: {}
+};
+plugin.configs.recommended = {
+  name: "auto-server-split/recommended",
+  plugins: { "auto-server-split": plugin },
+  rules: { "auto-server-split/prefer-server-split": ["warn", { minStaticRatio: 0.5 }] }
+};
+var eslint_default = plugin;
+export {
+  eslint_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/eslint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/eslint/rules/prefer-server-split.ts","../../src/eslint/engine.ts","../../src/eslint/index.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { Rule } from \"eslint\";\nimport { analyzeForLint } from \"../engine.js\";\n\ntype Options = [{ minStaticRatio?: number; selfCheck?: boolean; measure?: boolean }?];\n\ntype ParserServicesWithProgram = {\n  program?: { getCompilerOptions(): { configFilePath?: unknown } } | null;\n};\n\n/**\n * Reports `\"use client\"` files that `auto-server-split` can split. Report only: a split creates a\n * new file, which an ESLint fix can't do, so the CLI is the fixer (see docs/decisions.md).\n */\nexport const preferServerSplit: Rule.RuleModule = {\n  meta: {\n    type: \"suggestion\",\n    docs: {\n      description:\n        'Suggest splitting partly-interactive \"use client\" components into a Server Component plus client islands',\n    },\n    schema: [\n      {\n        type: \"object\",\n        properties: {\n          minStaticRatio: { type: \"number\", minimum: 0, maximum: 1 },\n          selfCheck: { type: \"boolean\" },\n          measure: { type: \"boolean\" },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      preferSplit:\n        \"{{component}} is {{ratio}}% static with {{count}} interactive island{{plural}} ({{tags}}). Run: npx auto-server-split {{file}} --write\",\n    },\n  },\n\n  create(context) {\n    const [options = {}] = context.options as Options;\n    return {\n      Program(program) {\n        const directive = program.body.find(\n          (statement) =>\n            statement.type === \"ExpressionStatement\" &&\n            \"directive\" in statement &&\n            statement.directive === \"use client\",\n        );\n        if (!directive) return;\n        const file = context.physicalFilename;\n        if (!/\\.(tsx|jsx|ts|js|mts|mjs)$/.test(file) || !path.isAbsolute(file)) return;\n\n        const services = context.sourceCode.parserServices as ParserServicesWithProgram | undefined;\n        const tsProgram = services?.program ?? undefined;\n        const configFilePath = tsProgram?.getCompilerOptions().configFilePath;\n        const result = analyzeForLint({\n          file,\n          text: context.sourceCode.text,\n          typed: tsProgram !== undefined,\n          tsconfig: typeof configFilePath === \"string\" ? configFilePath : undefined,\n          options,\n        });\n        if (!result?.ok) return;\n        const { islands, staticRatio, componentName } = result.value;\n        const tags = [...new Set(islands.map((i) => `<${i.rootTag}>`))].join(\", \");\n        context.report({\n          node: directive,\n          messageId: \"preferSplit\",\n          data: {\n            component: componentName,\n            ratio: String(Math.round(staticRatio * 100)),\n            count: String(islands.length),\n            plural: islands.length === 1 ? \"\" : \"s\",\n            tags,\n            file: path.relative(context.cwd, file).split(path.sep).join(\"/\"),\n          },\n        });\n      },\n    };\n  },\n};\n","import { existsSync, realpathSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { Outcome } from \"../analysis/skip.js\";\nimport { findConfigFile, loadConfigFileSync, resolveConfig } from \"../config/config.js\";\nimport { BundleMeasurer } from \"../measure/bundleSize.js\";\nimport { ensureLoaded, setSourceText } from \"../project/loadProject.js\";\nimport type { Analyzed, RunContext } from \"../split.js\";\nimport { analyzeFile, checkAnalyzed, createRunContext, measureAnalyzed } from \"../split.js\";\nimport type { UserConfig } from \"../types.js\";\n\ntype LintOptions = {\n  /** Report only when at least this share of the JSX stays on the server (default 0.5). */\n  minStaticRatio?: number;\n  /** Run the in-memory self-check before reporting (default true). */\n  selfCheck?: boolean;\n  /** Measure the saving with esbuild and apply `minBytesSaved` (default true). */\n  measure?: boolean;\n};\n\n/** The rule's own default: lint reports clear wins only. The config's threshold always applies too. */\nconst DEFAULT_MIN_STATIC_RATIO = 0.5;\n\n/** One cached run per tsconfig, mode and threshold, for the lifetime of the lint process. */\nconst runs = new Map<string, RunContext>();\n/** The project's auto-split config, read once per project root. */\nconst configs = new Map<string, UserConfig | undefined>();\n\nfunction findTsconfig(file: string): string | undefined {\n  let dir = path.dirname(file);\n  for (;;) {\n    for (const name of [\"tsconfig.json\", \"jsconfig.json\"]) {\n      const candidate = path.join(dir, name);\n      if (existsSync(candidate)) return candidate;\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir) return undefined;\n    dir = parent;\n  }\n}\n\n/** The config file the CLI would load for this root, any format (invalid configs throw). */\nfunction projectConfig(root: string): UserConfig | undefined {\n  if (!configs.has(root)) {\n    const file = findConfigFile(root);\n    configs.set(root, file ? loadConfigFileSync(file) : undefined);\n  }\n  return configs.get(root);\n}\n\nfunction importerClosure(run: RunContext, file: string): string[] {\n  const out = new Set<string>();\n  const queue = [file];\n  while (queue.length > 0) {\n    const target = queue.shift() as string;\n    for (const edge of run.graph.importersOf(target)) {\n      if (edge.kind === \"type\" || out.has(edge.from)) continue;\n      out.add(edge.from);\n      if (edge.kind === \"reexport\") queue.push(edge.from);\n    }\n  }\n  return [...out];\n}\n\n/**\n * Runs the core engine for one linted file. `typed` (parserServices.program present) loads the\n * whole project; otherwise a lazy project loads only this file, what it imports, and its importers.\n * Applies the same config, self-check and size threshold as the CLI, so it only reports files the\n * CLI would split. Returns undefined when the file can't be analysed or verified.\n */\nexport function analyzeForLint(args: {\n  file: string;\n  text: string;\n  typed: boolean;\n  tsconfig: string | undefined;\n  options: LintOptions;\n}): Outcome<Analyzed> | undefined {\n  const found = args.tsconfig ?? findTsconfig(args.file);\n  if (!found || !existsSync(found)) return undefined;\n  const tsconfig = realpathSync(found);\n  const file = realpathSync(args.file);\n  const root = path.dirname(tsconfig);\n  const fileConfig = projectConfig(root);\n  // The rule option can raise the bar, never lower it below what the CLI applies.\n  const minStaticRatio = Math.max(\n    args.options.minStaticRatio ?? DEFAULT_MIN_STATIC_RATIO,\n    resolveConfig(fileConfig).minStaticRatio,\n  );\n  const key = `${args.typed ? \"typed\" : \"lazy\"}\\0${tsconfig}\\0${minStaticRatio}`;\n  let run = runs.get(key);\n  if (!run) {\n    const config = resolveConfig(fileConfig, { minStaticRatio, prettier: false });\n    run = createRunContext(root, config, { lazy: !args.typed, tsconfig });\n    runs.set(key, run);\n  }\n  const node = run.graph.nodes.get(file);\n  if (!node?.inProgram) return undefined; // not covered by the tsconfig: importers can't be verified\n\n  if (!args.typed) ensureLoaded(run.loaded, [file, ...importerClosure(run, file)]);\n  const sf = run.loaded.project.getSourceFile(file);\n  if (!sf) return undefined;\n  // Analyse what the editor/CLI is linting, not what's on disk.\n  if (sf.getFullText() !== args.text) setSourceText(sf, args.text);\n\n  const analyzed = analyzeFile(run, file);\n  if (!analyzed.ok) return analyzed;\n  if (args.options.selfCheck !== false) {\n    const checked = checkAnalyzed(run, analyzed.value);\n    if (!checked.ok) return checked;\n  }\n  if (args.options.measure !== false) {\n    run.measurer ??= new BundleMeasurer(root, run.graph, run.loaded.configFile);\n    const saving = measureAnalyzed(run, analyzed.value);\n    if (!saving.ok) return saving;\n  }\n  return analyzed;\n}\n\n/** For tests: forget cached projects and configs. */\nexport function clearLintCache(): void {\n  runs.clear();\n  configs.clear();\n}\n","import type { ESLint, Linter } from \"eslint\";\nimport { preferServerSplit } from \"./rules/prefer-server-split.js\";\n\ndeclare const __VERSION__: string;\n\nconst plugin = {\n  meta: {\n    name: \"auto-server-split\",\n    version: typeof __VERSION__ === \"string\" ? __VERSION__ : \"0.0.0-dev\",\n  },\n  rules: { \"prefer-server-split\": preferServerSplit },\n  configs: {} as { recommended: Linter.Config },\n} satisfies ESLint.Plugin;\n\nplugin.configs.recommended = {\n  name: \"auto-server-split/recommended\",\n  plugins: { \"auto-server-split\": plugin },\n  rules: { \"auto-server-split/prefer-server-split\": [\"warn\", { minStaticRatio: 0.5 }] },\n};\n\nexport default plugin;\n"],"mappings":"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","names":["path","path"]}

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Every reason the tool can decline to split a file. Codes are stable: they appear in
+ * JSON output, CI logs and docs/skip-reasons.md, so never rename one.
+ */
+declare const SKIP_CODES: readonly ["imported-by-client", "exports-non-components", "state-spans-component", "context-provider", "css-in-js-runtime", "non-serializable-prop", "untyped-boundary", "spread-props", "conditional-hooks-or-returns", "class-component", "dynamic-import", "render-prop", "hoc", "server-env-difference", "no-islands", "fully-interactive", "below-threshold", "measure-failed", "output-exists", "would-create-route", "unsupported-pattern", "self-check-failed", "parse-error", "internal-error"];
+type SkipCode = (typeof SKIP_CODES)[number];
+type SourceLocation = {
+    line: number;
+    column: number;
+};
+type Skip = {
+    code: SkipCode;
+    message: string;
+    location?: SourceLocation;
+};
+/** Short, human-readable titles used when grouping skips in the CLI summary. */
+declare const SKIP_TITLES: Record<SkipCode, string>;
+
+type IslandInfo = {
+    name: string;
+    rootTag: string;
+    props: string[];
+    line: number;
+    /** True for a whole helper component moved into the island file (not a generated island). */
+    moved?: boolean;
+};
+type FileResult = {
+    file: string;
+    status: "split" | "skipped" | "unchanged";
+    skipped?: Skip;
+    islands: IslandInfo[];
+    /** Share of JSX nodes that end up outside islands, 0..1. */
+    staticRatio: number;
+    /** Gzip bytes saved; `conservative` is the headline "estimated" number. */
+    bytesSaved?: {
+        isolated: number;
+        conservative: number;
+    };
+    /**
+     * Why `bytesSaved` is missing although measurement was on (esbuild couldn't bundle a file). Only
+     * splits with `minBytesSaved: 0` get here; otherwise the file is skipped as `measure-failed`.
+     */
+    measureError?: string;
+    /** Unified diff covering all touched/created files. */
+    diff: string;
+    /** Project-relative path -> new content, for every touched or created file. */
+    outputs: Record<string, string>;
+};
+type SplitResult = {
+    files: FileResult[];
+};
+type UserConfig = {
+    include?: string[];
+    exclude?: string[];
+    clientOnlyPackages?: string[];
+    serverSafeHooks?: string[];
+    clientFileSuffix?: string;
+    islandsDir?: string;
+    minBytesSaved?: number;
+    minStaticRatio?: number;
+    prettier?: "auto" | false;
+    mongoose?: {
+        autoSerialize?: boolean;
+    };
+};
+type ResolvedConfig = {
+    include: string[];
+    exclude: string[];
+    clientOnlyPackages: string[];
+    serverSafeHooks: string[];
+    clientFileSuffix: string;
+    islandsDir: string | undefined;
+    minBytesSaved: number;
+    minStaticRatio: number;
+    prettier: "auto" | false;
+    mongoose: {
+        autoSerialize: boolean;
+    };
+};
+type SplitOptions = {
+    /** Project root (where tsconfig.json lives). Defaults to process.cwd(). */
+    root?: string;
+    /** Files or directories to consider, relative to root. Defaults to the config `include`. */
+    paths?: string[];
+    /** Write the outputs to disk. Default false. */
+    write?: boolean;
+    /** Overrides for the config file. */
+    config?: UserConfig;
+    /** Explicit config file path (relative to root). */
+    configFile?: string;
+    /** Skip loading a config file from disk. */
+    noConfigFile?: boolean;
+    /** Skip the esbuild size measurement (faster; bytesSaved is omitted and minBytesSaved is not applied). */
+    measure?: boolean;
+    /** Called with each file result as soon as it is ready. */
+    onFile?: (result: FileResult) => void;
+};
+
+/** Identity helper that gives `auto-split.config.ts` type checking. */
+declare function defineConfig(config: UserConfig): UserConfig;
+/**
+ * Finds partly-interactive "use client" components and splits them into a Server Component plus
+ * generated client islands. Nothing is written unless `write: true`.
+ */
+declare function split(options?: SplitOptions): Promise<SplitResult>;
+
+export { SKIP_CODES, SKIP_TITLES, defineConfig, split };
+export type { FileResult, IslandInfo, ResolvedConfig, Skip, SkipCode, SourceLocation, SplitOptions, SplitResult, UserConfig };

package/dist/index.js

@@ -0,0 +1,22 @@
+import {
+  SKIP_CODES,
+  SKIP_TITLES,
+  runSplit
+} from "./chunk-6OAWHATP.js";
+import "./chunk-YCSBOPV3.js";
+
+// src/index.ts
+function defineConfig(config) {
+  return config;
+}
+async function split(options = {}) {
+  const { files } = await runSplit(options);
+  return { files };
+}
+export {
+  SKIP_CODES,
+  SKIP_TITLES,
+  defineConfig,
+  split
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { runSplit } from \"./split.js\";\nimport type { SplitOptions, SplitResult, UserConfig } from \"./types.js\";\n\nexport type * from \"./types.js\";\nexport { SKIP_CODES, SKIP_TITLES } from \"./analysis/skip.js\";\n\n/** Identity helper that gives `auto-split.config.ts` type checking. */\nexport function defineConfig(config: UserConfig): UserConfig {\n  return config;\n}\n\n/**\n * Finds partly-interactive \"use client\" components and splits them into a Server Component plus\n * generated client islands. Nothing is written unless `write: true`.\n */\nexport async function split(options: SplitOptions = {}): Promise<SplitResult> {\n  const { files } = await runSplit(options);\n  return { files };\n}\n"],"mappings":";;;;;;;;AAOO,SAAS,aAAa,QAAgC;AAC3D,SAAO;AACT;AAMA,eAAsB,MAAM,UAAwB,CAAC,GAAyB;AAC5E,QAAM,EAAE,MAAM,IAAI,MAAM,SAAS,OAAO;AACxC,SAAO,EAAE,MAAM;AACjB;","names":[]}

package/dist/interactive-JF66CJGV.js

@@ -0,0 +1,66 @@
+// src/interactive.ts
+import { createInterface } from "readline/promises";
+import pc from "picocolors";
+async function reviewInteractively(files, rerun, io) {
+  const rl = createInterface({ input: io.input, output: io.output, terminal: false });
+  const lines = rl[Symbol.asyncIterator]();
+  const ask = async (question) => {
+    io.output.write(question);
+    const next = await lines.next();
+    return next.done ? void 0 : String(next.value).trim();
+  };
+  const print = (text = "") => io.output.write(`${text}
+`);
+  const accepted = [];
+  try {
+    review: for (const original of files.filter((f) => f.status === "split")) {
+      let current = original;
+      const defaults = original.islands.map((i) => i.name);
+      const renames = {};
+      print();
+      print(io.describe(current));
+      for (; ; ) {
+        const answer = (await ask(
+          `Apply this split? ${pc.bold("[y]")}es / ${pc.bold("[n]")}o / ${pc.bold("[r]")}ename islands / ${pc.bold("[d]")}iff / ${pc.bold("[q]")}uit: `
+        ))?.toLowerCase();
+        if (answer === void 0 || answer === "q") break review;
+        if (answer === "y") {
+          accepted.push(current);
+          break;
+        }
+        if (answer === "n") break;
+        if (answer === "d") {
+          print(io.colorDiff(current.diff));
+          continue;
+        }
+        if (answer === "r") {
+          const proposed = { ...renames };
+          for (const [i, island] of current.islands.entries()) {
+            if (island.moved) continue;
+            const name = await ask(`  Rename ${island.name} to (enter to keep): `);
+            if (name === void 0) break review;
+            const original2 = defaults[i];
+            if (name && original2) proposed[original2] = name;
+          }
+          const result = await rerun(current.file, proposed);
+          if (result.status === "split") {
+            Object.assign(renames, proposed);
+            current = result;
+            print(io.describe(current));
+          } else {
+            print(pc.yellow(`  Rename rejected: ${result.skipped?.message ?? "unknown reason"}`));
+          }
+          continue;
+        }
+        print("  Please answer y, n, r, d or q.");
+      }
+    }
+  } finally {
+    rl.close();
+  }
+  return accepted;
+}
+export {
+  reviewInteractively
+};
+//# sourceMappingURL=interactive-JF66CJGV.js.map

package/dist/interactive-JF66CJGV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interactive.ts"],"sourcesContent":["import { createInterface } from \"node:readline/promises\";\nimport type { Readable, Writable } from \"node:stream\";\nimport pc from \"picocolors\";\nimport type { FileResult } from \"./types.js\";\n\ntype Rerun = (relFile: string, renames: Readonly<Record<string, string>>) => Promise<FileResult>;\n\ntype Io = {\n  input: Readable;\n  output: Writable;\n  colorDiff: (diff: string) => string;\n  describe: (file: FileResult) => string;\n};\n\n/**\n * Walks through each proposed split: [y]es / [n]o / [r]ename islands / [d]iff / [q]uit.\n * Renames go back through the engine (and its self-check), so a bad name can't produce bad code.\n * Returns the accepted results, with renames applied.\n */\nexport async function reviewInteractively(\n  files: FileResult[],\n  rerun: Rerun,\n  io: Io,\n): Promise<FileResult[]> {\n  const rl = createInterface({ input: io.input, output: io.output, terminal: false });\n  const lines = rl[Symbol.asyncIterator]();\n  const ask = async (question: string): Promise<string | undefined> => {\n    io.output.write(question);\n    const next = await lines.next();\n    return next.done ? undefined : String(next.value).trim();\n  };\n  const print = (text = \"\") => io.output.write(`${text}\\n`);\n  const accepted: FileResult[] = [];\n\n  try {\n    review: for (const original of files.filter((f) => f.status === \"split\")) {\n      let current = original;\n      const defaults = original.islands.map((i) => i.name);\n      const renames: Record<string, string> = {};\n      print();\n      print(io.describe(current));\n      for (;;) {\n        const answer = (\n          await ask(\n            `Apply this split? ${pc.bold(\"[y]\")}es / ${pc.bold(\"[n]\")}o / ${pc.bold(\"[r]\")}ename islands / ${pc.bold(\"[d]\")}iff / ${pc.bold(\"[q]\")}uit: `,\n          )\n        )?.toLowerCase();\n        if (answer === undefined || answer === \"q\") break review;\n        if (answer === \"y\") {\n          accepted.push(current);\n          break;\n        }\n        if (answer === \"n\") break;\n        if (answer === \"d\") {\n          print(io.colorDiff(current.diff));\n          continue;\n        }\n        if (answer === \"r\") {\n          const proposed = { ...renames };\n          for (const [i, island] of current.islands.entries()) {\n            if (island.moved) continue;\n            const name = await ask(`  Rename ${island.name} to (enter to keep): `);\n            if (name === undefined) break review;\n            const original = defaults[i];\n            if (name && original) proposed[original] = name;\n          }\n          const result = await rerun(current.file, proposed);\n          if (result.status === \"split\") {\n            Object.assign(renames, proposed);\n            current = result;\n            print(io.describe(current));\n          } else {\n            print(pc.yellow(`  Rename rejected: ${result.skipped?.message ?? \"unknown reason\"}`));\n          }\n          continue;\n        }\n        print(\"  Please answer y, n, r, d or q.\");\n      }\n    }\n  } finally {\n    rl.close();\n  }\n  return accepted;\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAEhC,OAAO,QAAQ;AAiBf,eAAsB,oBACpB,OACA,OACA,IACuB;AACvB,QAAM,KAAK,gBAAgB,EAAE,OAAO,GAAG,OAAO,QAAQ,GAAG,QAAQ,UAAU,MAAM,CAAC;AAClF,QAAM,QAAQ,GAAG,OAAO,aAAa,EAAE;AACvC,QAAM,MAAM,OAAO,aAAkD;AACnE,OAAG,OAAO,MAAM,QAAQ;AACxB,UAAM,OAAO,MAAM,MAAM,KAAK;AAC9B,WAAO,KAAK,OAAO,SAAY,OAAO,KAAK,KAAK,EAAE,KAAK;AAAA,EACzD;AACA,QAAM,QAAQ,CAAC,OAAO,OAAO,GAAG,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AACxD,QAAM,WAAyB,CAAC;AAEhC,MAAI;AACF,WAAQ,YAAW,YAAY,MAAM,OAAO,CAAC,MAAM,EAAE,WAAW,OAAO,GAAG;AACxE,UAAI,UAAU;AACd,YAAM,WAAW,SAAS,QAAQ,IAAI,CAAC,MAAM,EAAE,IAAI;AACnD,YAAM,UAAkC,CAAC;AACzC,YAAM;AACN,YAAM,GAAG,SAAS,OAAO,CAAC;AAC1B,iBAAS;AACP,cAAM,UACJ,MAAM;AAAA,UACJ,qBAAqB,GAAG,KAAK,KAAK,CAAC,QAAQ,GAAG,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,KAAK,CAAC,mBAAmB,GAAG,KAAK,KAAK,CAAC,SAAS,GAAG,KAAK,KAAK,CAAC;AAAA,QACxI,IACC,YAAY;AACf,YAAI,WAAW,UAAa,WAAW,IAAK,OAAM;AAClD,YAAI,WAAW,KAAK;AAClB,mBAAS,KAAK,OAAO;AACrB;AAAA,QACF;AACA,YAAI,WAAW,IAAK;AACpB,YAAI,WAAW,KAAK;AAClB,gBAAM,GAAG,UAAU,QAAQ,IAAI,CAAC;AAChC;AAAA,QACF;AACA,YAAI,WAAW,KAAK;AAClB,gBAAM,WAAW,EAAE,GAAG,QAAQ;AAC9B,qBAAW,CAAC,GAAG,MAAM,KAAK,QAAQ,QAAQ,QAAQ,GAAG;AACnD,gBAAI,OAAO,MAAO;AAClB,kBAAM,OAAO,MAAM,IAAI,YAAY,OAAO,IAAI,uBAAuB;AACrE,gBAAI,SAAS,OAAW,OAAM;AAC9B,kBAAMA,YAAW,SAAS,CAAC;AAC3B,gBAAI,QAAQA,UAAU,UAASA,SAAQ,IAAI;AAAA,UAC7C;AACA,gBAAM,SAAS,MAAM,MAAM,QAAQ,MAAM,QAAQ;AACjD,cAAI,OAAO,WAAW,SAAS;AAC7B,mBAAO,OAAO,SAAS,QAAQ;AAC/B,sBAAU;AACV,kBAAM,GAAG,SAAS,OAAO,CAAC;AAAA,UAC5B,OAAO;AACL,kBAAM,GAAG,OAAO,sBAAsB,OAAO,SAAS,WAAW,gBAAgB,EAAE,CAAC;AAAA,UACtF;AACA;AAAA,QACF;AACA,cAAM,kCAAkC;AAAA,MAC1C;AAAA,IACF;AAAA,EACF,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AACA,SAAO;AACT;","names":["original"]}

package/package.json

@@ -1,6 +1,114 @@
 {
   "name": "auto-server-split",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Split partly-interactive \"use client\" components into server components plus small generated client islands.",
+  "keywords": [
+    "nextjs",
+    "react-server-components",
+    "rsc",
+    "use client",
+    "codemod",
+    "eslint-plugin"
+  ],
+  "license": "MIT",
+  "author": "Himesh Gunathilake",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HimeshGunathilaka/auto-server-split.git"
+  },
+  "homepage": "https://github.com/HimeshGunathilaka/auto-server-split#readme",
+  "bugs": {
+    "url": "https://github.com/HimeshGunathilaka/auto-server-split/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "auto-server-split": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint/index.d.ts",
+      "import": "./dist/eslint/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@10.33.3",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "pretest": "tsup --silent",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "node e2e/run.mjs",
+    "prepublishOnly": "pnpm lint && pnpm typecheck && pnpm test"
+  },
+  "dependencies": {
+    "citty": "0.2.2",
+    "diff": "9.0.0",
+    "esbuild": "0.28.2",
+    "fast-glob": "3.3.3",
+    "magic-string": "1.4.3",
+    "picocolors": "1.1.1",
+    "ts-morph": "28.0.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9",
+    "prettier": ">=3",
+    "typescript": ">=5.4"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "1.64.1",
+    "@types/node": "^22.20.5",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "date-fns": "4.4.0",
+    "eslint": "10.13.0",
+    "framer-motion": "^12.43.0",
+    "globals": "^17.13.0",
+    "marked": "18.1.1",
+    "mongoose": "9.11.2",
+    "next": "16.4.2",
+    "prettier": "3.9.10",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "styled-components": "6.6.0",
+    "tsup": "9.0.0",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.71.2",
+    "vitest": "5.0.5"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}