@fumadocs/cli 1.5.0 → 1.6.1

package/dist/features-CXFCgOWD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features-CXFCgOWD.js","names":[],"sources":["../src/features/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { x } from 'tinyexec';\nimport type { RegistryConnector } from 'fuma-cli/registry/connector';\nimport type { Project } from '@/project';\nimport { createSourceFile, type SourceFile } from '@/codemod';\nimport { FumadocsComponentInstaller } from '@/registry/installer';\nimport { exists } from '@/utils/fs';\n\nexport interface SelectOption<T> {\n  message: string;\n  choices: { value: T; label: string; hint?: string }[];\n}\n\nexport interface ConfirmOption {\n  message: string;\n  initialValue?: boolean;\n}\n\nexport type FeatureOption<T> = [T] extends [boolean] ? ConfirmOption : SelectOption<T>;\n\nexport interface Feature<Options extends object = Record<never, never>> {\n  id: string;\n  title: string;\n  description: string;\n  options?: { [K in keyof Options]: FeatureOption<Options[K]> };\n  /** features that must be applied first */\n  requires?: AnyFeature[];\n  /** whether the feature is already applied to the project */\n  detect?: (project: Project) => Promise<boolean>;\n  /** @returns `true` if supported, otherwise the reason */\n  supports?: (project: Project) => true | string;\n  apply(ctx: FeatureContext, options: Options): Promise<void>;\n}\n\nexport type AnyFeature = Omit<Feature<Record<string, unknown>>, 'options'> & {\n  options?: Record<string, SelectOption<unknown> | ConfirmOption>;\n};\n\nexport interface PackageJson {\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n}\n\nexport interface FeatureContext {\n  project: Project;\n  /** write a file (relative to project root), asks before overwriting */\n  write: (file: string, content: string) => Promise<void>;\n  /** edit a file with codemods, `false` if the file doesn't exist */\n  source: (file: string, edit: (file: SourceFile) => void) => Promise<boolean>;\n  /** append lines to a text file, skip lines already present */\n  append: (file: string, lines: string[]) => Promise<void>;\n  remove: (file: string) => Promise<void>;\n  packageJson: (edit: (data: PackageJson) => void) => Promise<void>;\n  /** install a registry component */\n  install: (name: string, subRegistry?: string) => Promise<void>;\n  /** `null` to install the latest version */\n  addDependencies: (deps: Record<string, string | null>, dev?: boolean) => void;\n  env: (key: string, value: string) => void;\n  /** instructions to show after the feature is applied */\n  note: (text: string) => void;\n  log: (message: string) => void;\n}\n\nexport interface FeatureIO {\n  log: (message: string) => void;\n  confirmOverwrite: (file: string) => Promise<boolean>;\n  /** run package manager to install dependencies, otherwise only write them into `package.json` */\n  installDependencies: boolean;\n}\n\nexport interface RunOptions {\n  project: Project;\n  connector: RegistryConnector;\n  io: FeatureIO;\n  /** preferred versions of dependencies, when a feature doesn't specify one */\n  versions?: Record<string, string>;\n}\n\nexport async function runFeature<O extends object>(\n  feature: Omit<Feature<O>, 'options'>,\n  options: O,\n  { project, connector, io, versions }: RunOptions,\n): Promise<{ notes: string[] }> {\n  for (const dep of feature.requires ?? []) {\n    if (dep.detect && !(await dep.detect(project)))\n      throw new Error(\n        `\"${feature.id}\" requires \"${dep.id}\", run \\`fumadocs feature ${dep.id}\\` first.`,\n      );\n  }\n  const supported = feature.supports?.(project) ?? true;\n  if (supported !== true) throw new Error(`\"${feature.id}\" is unavailable: ${supported}`);\n\n  const { cwd } = project;\n  const deps: Record<string, string | null> = {};\n  const devDeps: Record<string, string | null> = {};\n  const env: string[] = [];\n  const notes: string[] = [];\n  const installer = new FumadocsComponentInstaller(connector, project.config, cwd, {\n    onWarn: io.log,\n    confirmFileOverride: ({ path: file }) => io.confirmOverwrite(path.relative(cwd, file)),\n    onFileDownloaded: ({ path: file }) => io.log(`installed ${path.relative(cwd, file)}`),\n  });\n\n  const ctx: FeatureContext = {\n    project,\n    log: io.log,\n    note: (text) => notes.push(text),\n    env: (key, value) => env.push(`${key}=${value}`),\n    addDependencies(input, dev) {\n      Object.assign(dev ? devDeps : deps, input);\n    },\n    async write(file, content) {\n      const target = path.join(cwd, file);\n      const current = await fs.readFile(target, 'utf-8').catch(() => null);\n      if (current !== null) {\n        if (current.trim() === content.trim()) return;\n        if (!(await io.confirmOverwrite(file))) return;\n      }\n      await fs.mkdir(path.dirname(target), { recursive: true });\n      await fs.writeFile(target, content);\n      io.log(`${current === null ? 'created' : 'updated'} ${file}`);\n    },\n    async source(file, edit) {\n      const target = path.join(cwd, file);\n      if (!(await exists(target))) return false;\n      const source = await createSourceFile(target);\n      edit(source);\n      if (source.s.hasChanged()) {\n        await source.save();\n        io.log(`updated ${file}`);\n      }\n      return true;\n    },\n    async append(file, lines) {\n      const target = path.join(cwd, file);\n      const current = await fs.readFile(target, 'utf-8').catch(() => '');\n      const missing = lines.filter((line) => !current.includes(line));\n      if (missing.length === 0) return;\n      const separator = current.length === 0 || current.endsWith('\\n') ? '' : '\\n';\n      await fs.mkdir(path.dirname(target), { recursive: true });\n      await fs.writeFile(target, `${current}${separator}${missing.join('\\n')}\\n`);\n      io.log(`updated ${file}`);\n    },\n    async remove(file) {\n      await fs.rm(path.join(cwd, file), { force: true });\n      io.log(`removed ${file}`);\n    },\n    async packageJson(edit) {\n      const target = path.join(cwd, 'package.json');\n      const data = JSON.parse(await fs.readFile(target, 'utf-8'));\n      edit(data);\n      await fs.writeFile(target, `${JSON.stringify(data, null, 2)}\\n`);\n      io.log('updated package.json');\n    },\n    async install(name, subRegistry) {\n      const result = await installer.install(name, subRegistry);\n      const manager = await result.deps();\n      // encoded as `name` or `name@version`\n      const decode = (target: Record<string, string | null>, dep: string) => {\n        const at = dep.indexOf('@', 1);\n        if (at === -1) target[dep] = null;\n        else target[dep.slice(0, at)] = dep.slice(at + 1);\n      };\n      for (const dep of manager.dependencies) decode(deps, dep);\n      for (const dep of manager.devDependencies) decode(devDeps, dep);\n    },\n  };\n\n  await feature.apply(ctx, options);\n\n  if (env.length > 0) await ctx.append('.env.local', env);\n  await installDependencies(project, deps, devDeps, io, versions);\n  return { notes };\n}\n\nasync function installDependencies(\n  project: Project,\n  deps: Record<string, string | null>,\n  devDeps: Record<string, string | null>,\n  io: FeatureIO,\n  versions: Record<string, string> = {},\n) {\n  const { dependencies = {}, devDependencies = {} } = project.packageJson;\n  const filter = (input: Record<string, string | null>) =>\n    Object.entries(input).filter(([name]) => !(name in dependencies) && !(name in devDependencies));\n  const missing = filter(deps);\n  const missingDev = filter(devDeps);\n  if (missing.length === 0 && missingDev.length === 0) return;\n\n  if (io.installDependencies) {\n    const pm = project.packageManager;\n    const run = async (flags: string[], entries: [string, string | null][]) => {\n      if (entries.length === 0) return;\n      const args = [\n        'add',\n        ...flags,\n        ...entries.map(([name, version]) => (version ? `${name}@${version}` : name)),\n      ];\n      io.log(`${pm} ${args.join(' ')}`);\n      await x(pm, args, {\n        nodeOptions: { cwd: project.cwd, stdio: 'inherit' },\n        throwOnError: true,\n      });\n    };\n    await run([], missing);\n    await run(['-D'], missingDev);\n    return;\n  }\n\n  const file = path.join(project.cwd, 'package.json');\n  const json = JSON.parse(await fs.readFile(file, 'utf-8'));\n  const write = (field: string, entries: [string, string | null][]) => {\n    if (entries.length === 0) return;\n    const target = (json[field] ??= {});\n    for (const [name, version] of entries) target[name] = version ?? versions[name] ?? 'latest';\n  };\n  write('dependencies', missing);\n  write('devDependencies', missingDev);\n  await fs.writeFile(file, `${JSON.stringify(json, null, 2)}\\n`);\n  io.log('updated package.json');\n}\n"],"mappings":";;;;;;;AAgFA,eAAsB,WACpB,SACA,SACA,EAAE,SAAS,WAAW,IAAI,YACI;CAC9B,KAAK,MAAM,OAAO,QAAQ,YAAY,CAAC,GACrC,IAAI,IAAI,UAAU,CAAE,MAAM,IAAI,OAAO,OAAO,GAC1C,MAAM,IAAI,MACR,IAAI,QAAQ,GAAG,cAAc,IAAI,GAAG,4BAA4B,IAAI,GAAG,UACzE;CAEJ,MAAM,YAAY,QAAQ,WAAW,OAAO,KAAK;CACjD,IAAI,cAAc,MAAM,MAAM,IAAI,MAAM,IAAI,QAAQ,GAAG,oBAAoB,WAAW;CAEtF,MAAM,EAAE,QAAQ;CAChB,MAAM,OAAsC,CAAC;CAC7C,MAAM,UAAyC,CAAC;CAChD,MAAM,MAAgB,CAAC;CACvB,MAAM,QAAkB,CAAC;CACzB,MAAM,YAAY,IAAI,2BAA2B,WAAW,QAAQ,QAAQ,KAAK;EAC/E,QAAQ,GAAG;EACX,sBAAsB,EAAE,MAAM,WAAW,GAAG,iBAAiB,KAAK,SAAS,KAAK,IAAI,CAAC;EACrF,mBAAmB,EAAE,MAAM,WAAW,GAAG,IAAI,aAAa,KAAK,SAAS,KAAK,IAAI,GAAG;CACtF,CAAC;CAED,MAAM,MAAsB;EAC1B;EACA,KAAK,GAAG;EACR,OAAO,SAAS,MAAM,KAAK,IAAI;EAC/B,MAAM,KAAK,UAAU,IAAI,KAAK,GAAG,IAAI,GAAG,OAAO;EAC/C,gBAAgB,OAAO,KAAK;GAC1B,OAAO,OAAO,MAAM,UAAU,MAAM,KAAK;EAC3C;EACA,MAAM,MAAM,MAAM,SAAS;GACzB,MAAM,SAAS,KAAK,KAAK,KAAK,IAAI;GAClC,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,OAAO,CAAC,CAAC,YAAY,IAAI;GACnE,IAAI,YAAY,MAAM;IACpB,IAAI,QAAQ,KAAK,MAAM,QAAQ,KAAK,GAAG;IACvC,IAAI,CAAE,MAAM,GAAG,iBAAiB,IAAI,GAAI;GAC1C;GACA,MAAM,GAAG,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;GACxD,MAAM,GAAG,UAAU,QAAQ,OAAO;GAClC,GAAG,IAAI,GAAG,YAAY,OAAO,YAAY,UAAU,GAAG,MAAM;EAC9D;EACA,MAAM,OAAO,MAAM,MAAM;GACvB,MAAM,SAAS,KAAK,KAAK,KAAK,IAAI;GAClC,IAAI,CAAE,MAAM,OAAO,MAAM,GAAI,OAAO;GACpC,MAAM,SAAS,MAAM,iBAAiB,MAAM;GAC5C,KAAK,MAAM;GACX,IAAI,OAAO,EAAE,WAAW,GAAG;IACzB,MAAM,OAAO,KAAK;IAClB,GAAG,IAAI,WAAW,MAAM;GAC1B;GACA,OAAO;EACT;EACA,MAAM,OAAO,MAAM,OAAO;GACxB,MAAM,SAAS,KAAK,KAAK,KAAK,IAAI;GAClC,MAAM,UAAU,MAAM,GAAG,SAAS,QAAQ,OAAO,CAAC,CAAC,YAAY,EAAE;GACjE,MAAM,UAAU,MAAM,QAAQ,SAAS,CAAC,QAAQ,SAAS,IAAI,CAAC;GAC9D,IAAI,QAAQ,WAAW,GAAG;GAC1B,MAAM,YAAY,QAAQ,WAAW,KAAK,QAAQ,SAAS,IAAI,IAAI,KAAK;GACxE,MAAM,GAAG,MAAM,KAAK,QAAQ,MAAM,GAAG,EAAE,WAAW,KAAK,CAAC;GACxD,MAAM,GAAG,UAAU,QAAQ,GAAG,UAAU,YAAY,QAAQ,KAAK,IAAI,EAAE,GAAG;GAC1E,GAAG,IAAI,WAAW,MAAM;EAC1B;EACA,MAAM,OAAO,MAAM;GACjB,MAAM,GAAG,GAAG,KAAK,KAAK,KAAK,IAAI,GAAG,EAAE,OAAO,KAAK,CAAC;GACjD,GAAG,IAAI,WAAW,MAAM;EAC1B;EACA,MAAM,YAAY,MAAM;GACtB,MAAM,SAAS,KAAK,KAAK,KAAK,cAAc;GAC5C,MAAM,OAAO,KAAK,MAAM,MAAM,GAAG,SAAS,QAAQ,OAAO,CAAC;GAC1D,KAAK,IAAI;GACT,MAAM,GAAG,UAAU,QAAQ,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,EAAE,GAAG;GAC/D,GAAG,IAAI,sBAAsB;EAC/B;EACA,MAAM,QAAQ,MAAM,aAAa;GAE/B,MAAM,UAAU,OAAM,MADD,UAAU,QAAQ,MAAM,WAAW,EAAA,CAC3B,KAAK;GAElC,MAAM,UAAU,QAAuC,QAAgB;IACrE,MAAM,KAAK,IAAI,QAAQ,KAAK,CAAC;IAC7B,IAAI,OAAO,IAAI,OAAO,OAAO;SACxB,OAAO,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI,MAAM,KAAK,CAAC;GAClD;GACA,KAAK,MAAM,OAAO,QAAQ,cAAc,OAAO,MAAM,GAAG;GACxD,KAAK,MAAM,OAAO,QAAQ,iBAAiB,OAAO,SAAS,GAAG;EAChE;CACF;CAEA,MAAM,QAAQ,MAAM,KAAK,OAAO;CAEhC,IAAI,IAAI,SAAS,GAAG,MAAM,IAAI,OAAO,cAAc,GAAG;CACtD,MAAM,oBAAoB,SAAS,MAAM,SAAS,IAAI,QAAQ;CAC9D,OAAO,EAAE,MAAM;AACjB;AAEA,eAAe,oBACb,SACA,MACA,SACA,IACA,WAAmC,CAAC,GACpC;CACA,MAAM,EAAE,eAAe,CAAC,GAAG,kBAAkB,CAAC,MAAM,QAAQ;CAC5D,MAAM,UAAU,UACd,OAAO,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,iBAAiB,EAAE,QAAQ,gBAAgB;CAChG,MAAM,UAAU,OAAO,IAAI;CAC3B,MAAM,aAAa,OAAO,OAAO;CACjC,IAAI,QAAQ,WAAW,KAAK,WAAW,WAAW,GAAG;CAErD,IAAI,GAAG,qBAAqB;EAC1B,MAAM,KAAK,QAAQ;EACnB,MAAM,MAAM,OAAO,OAAiB,YAAuC;GACzE,IAAI,QAAQ,WAAW,GAAG;GAC1B,MAAM,OAAO;IACX;IACA,GAAG;IACH,GAAG,QAAQ,KAAK,CAAC,MAAM,aAAc,UAAU,GAAG,KAAK,GAAG,YAAY,IAAK;GAC7E;GACA,GAAG,IAAI,GAAG,GAAG,GAAG,KAAK,KAAK,GAAG,GAAG;GAChC,MAAM,EAAE,IAAI,MAAM;IAChB,aAAa;KAAE,KAAK,QAAQ;KAAK,OAAO;IAAU;IAClD,cAAc;GAChB,CAAC;EACH;EACA,MAAM,IAAI,CAAC,GAAG,OAAO;EACrB,MAAM,IAAI,CAAC,IAAI,GAAG,UAAU;EAC5B;CACF;CAEA,MAAM,OAAO,KAAK,KAAK,QAAQ,KAAK,cAAc;CAClD,MAAM,OAAO,KAAK,MAAM,MAAM,GAAG,SAAS,MAAM,OAAO,CAAC;CACxD,MAAM,SAAS,OAAe,YAAuC;EACnE,IAAI,QAAQ,WAAW,GAAG;EAC1B,MAAM,SAAU,KAAK,WAAW,CAAC;EACjC,KAAK,MAAM,CAAC,MAAM,YAAY,SAAS,OAAO,QAAQ,WAAW,SAAS,SAAS;CACrF;CACA,MAAM,gBAAgB,OAAO;CAC7B,MAAM,mBAAmB,UAAU;CACnC,MAAM,GAAG,UAAU,MAAM,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,EAAE,GAAG;CAC7D,GAAG,IAAI,sBAAsB;AAC/B"}

package/dist/feedback-Brj092vC.js

@@ -0,0 +1,37 @@
+import { b as findJsxElement, h as appendJsxChildren, p as addImport } from "./codemod-auol-p4R.js";
+import { t as docs } from "./docs--WqEHTyl.js";
+import { r as findSource } from "./utils-DbMe7h6c.js";
+import path from "node:path";
+//#region src/features/feedback.ts
+const feedback = {
+	id: "feedback",
+	title: "Feedback",
+	description: "let readers rate docs pages, with a component to send feedback",
+	requires: [docs],
+	async apply(ctx) {
+		const { cwd, baseDir, info, framework, static: isStatic } = ctx.project;
+		await ctx.install("feedback");
+		const serverAction = framework === "next" || framework === "waku";
+		const page = await findSource(cwd, path.join(baseDir, info.routesDir), "<DocsPage");
+		if (!(page !== void 0 && !(serverAction && isStatic) && await ctx.source(page, (file) => {
+			if (file.code.includes("<Feedback")) return;
+			const element = findJsxElement(file, "DocsPage");
+			if (!element) return;
+			appendJsxChildren(file, element, `<Feedback
+  onSendAction={async (feedback) => {${serverAction ? "\n    'use server';\n" : ""}
+    console.log(feedback);
+    return {};
+  }}
+/>`);
+			addImport(file, {
+				from: "@/components/feedback/client",
+				named: ["Feedback"]
+			});
+		}))) ctx.note(serverAction && isStatic ? "Static export has no server actions, render `<Feedback />` from `@/components/feedback/client` in a client component and send the feedback to your API in `onSendAction`." : "Add `<Feedback />` from `@/components/feedback/client` to the bottom of your docs page.");
+		ctx.note("Handle the feedback in `onSendAction`, e.g. report it to GitHub Discussions: https://fumadocs.dev/docs/integrations/feedback.");
+	}
+};
+//#endregion
+export { feedback as t };
+
+//# sourceMappingURL=feedback-Brj092vC.js.map

package/dist/feedback-Brj092vC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-Brj092vC.js","names":[],"sources":["../src/features/feedback.ts"],"sourcesContent":["import path from 'node:path';\nimport type { Feature } from '@/features';\nimport { addImport, appendJsxChildren, findJsxElement } from '@/codemod';\nimport { docs } from './docs';\nimport { findSource } from './utils';\n\nexport const feedback: Feature = {\n  id: 'feedback',\n  title: 'Feedback',\n  description: 'let readers rate docs pages, with a component to send feedback',\n  requires: [docs],\n  async apply(ctx) {\n    const { cwd, baseDir, info, framework, static: isStatic } = ctx.project;\n    await ctx.install('feedback');\n\n    // server actions are only available on RSC frameworks, static export has none\n    const serverAction = framework === 'next' || framework === 'waku';\n    const page = await findSource(cwd, path.join(baseDir, info.routesDir), '<DocsPage');\n    const edited =\n      page !== undefined &&\n      !(serverAction && isStatic) &&\n      (await ctx.source(page, (file) => {\n        if (file.code.includes('<Feedback')) return;\n        const element = findJsxElement(file, 'DocsPage');\n        if (!element) return;\n\n        appendJsxChildren(\n          file,\n          element,\n          `<Feedback\n  onSendAction={async (feedback) => {${serverAction ? \"\\n    'use server';\\n\" : ''}\n    console.log(feedback);\n    return {};\n  }}\n/>`,\n        );\n        addImport(file, { from: '@/components/feedback/client', named: ['Feedback'] });\n      }));\n\n    if (!edited) {\n      ctx.note(\n        serverAction && isStatic\n          ? 'Static export has no server actions, render `<Feedback />` from `@/components/feedback/client` in a client component and send the feedback to your API in `onSendAction`.'\n          : 'Add `<Feedback />` from `@/components/feedback/client` to the bottom of your docs page.',\n      );\n    }\n    ctx.note(\n      'Handle the feedback in `onSendAction`, e.g. report it to GitHub Discussions: https://fumadocs.dev/docs/integrations/feedback.',\n    );\n  },\n};\n"],"mappings":";;;;;AAMA,MAAa,WAAoB;CAC/B,IAAI;CACJ,OAAO;CACP,aAAa;CACb,UAAU,CAAC,IAAI;CACf,MAAM,MAAM,KAAK;EACf,MAAM,EAAE,KAAK,SAAS,MAAM,WAAW,QAAQ,aAAa,IAAI;EAChE,MAAM,IAAI,QAAQ,UAAU;EAG5B,MAAM,eAAe,cAAc,UAAU,cAAc;EAC3D,MAAM,OAAO,MAAM,WAAW,KAAK,KAAK,KAAK,SAAS,KAAK,SAAS,GAAG,WAAW;EAsBlF,IAAI,EApBF,SAAS,KAAA,KACT,EAAE,gBAAgB,aACjB,MAAM,IAAI,OAAO,OAAO,SAAS;GAChC,IAAI,KAAK,KAAK,SAAS,WAAW,GAAG;GACrC,MAAM,UAAU,eAAe,MAAM,UAAU;GAC/C,IAAI,CAAC,SAAS;GAEd,kBACE,MACA,SACA;uCAC6B,eAAe,0BAA0B,GAAG;;;;GAK3E;GACA,UAAU,MAAM;IAAE,MAAM;IAAgC,OAAO,CAAC,UAAU;GAAE,CAAC;EAC/E,CAAC,IAGD,IAAI,KACF,gBAAgB,WACZ,8KACA,yFACN;EAEF,IAAI,KACF,+HACF;CACF;AACF"}

package/dist/fs-D6J9dOEx.js

@@ -0,0 +1,14 @@
+import fs from "node:fs/promises";
+//#region src/utils/fs.ts
+async function exists(pathLike) {
+	try {
+		await fs.access(pathLike);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { exists as t };
+
+//# sourceMappingURL=fs-D6J9dOEx.js.map

package/dist/fs-D6J9dOEx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-D6J9dOEx.js","names":[],"sources":["../src/utils/fs.ts"],"sourcesContent":["import fs from 'node:fs/promises';\n\nexport async function exists(pathLike: string): Promise<boolean> {\n  try {\n    await fs.access(pathLike);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;AAEA,eAAsB,OAAO,UAAoC;CAC/D,IAAI;EACF,MAAM,GAAG,OAAO,QAAQ;EACxB,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/index-Ck0EPdgu.d.ts

@@ -0,0 +1,126 @@
+import { ArrayExpression, ExportDefaultDeclaration, JSXElement, JSXOpeningElement, Node, ObjectExpression, ObjectProperty, Program } from "oxc-parser";
+import MagicString from "magic-string";
+//#region src/codemod/shared.d.ts
+type NodeOfType<T extends Node['type']> = Extract<Node, {
+  type: T;
+}>;
+interface SourceFile {
+  path: string;
+  /** the original content */
+  code: string;
+  program: Program;
+  /** the edited content */
+  s: MagicString;
+  save(): Promise<void>;
+}
+declare function parseSourceFile(path: string, code: string): SourceFile;
+declare function createSourceFile(path: string): Promise<SourceFile>;
+/** the value of a string literal, or a template literal without expressions */
+declare function getStringValue(node: Node): string | undefined;
+declare function descendants(node: Node): Generator<Node>;
+declare function find<T extends Node['type']>(node: Node, type: T, predicate?: (node: NodeOfType<T>) => boolean): NodeOfType<T> | undefined;
+declare function getDefaultExport(file: SourceFile): ExportDefaultDeclaration | undefined;
+declare function findJsxElement(file: SourceFile, tagName: string): JSXElement | undefined;
+declare function addJsxAttribute(file: SourceFile, element: JSXOpeningElement, attribute: string): void;
+/**
+ * Insert JSX before the children of the element, re-indenting the children
+ */
+declare function prependJsxChildren(file: SourceFile, element: JSXElement, jsx: string): void;
+/**
+ * Insert JSX after the children of the element
+ */
+declare function appendJsxChildren(file: SourceFile, element: JSXElement, jsx: string): void;
+declare function getProperty(object: ObjectExpression, name: string): ObjectProperty | undefined;
+/** indentation of the line containing `index` */
+declare function lineIndent(code: string, index: number): string;
+declare function addImport(file: SourceFile, declaration: {
+  from: string;
+  default?: string;
+  named?: string[];
+}): void;
+type Container = ArrayExpression | ObjectExpression;
+type ElementOf<C extends Container> = C extends ArrayExpression ? NonNullable<ArrayExpression['elements'][number]> : ObjectExpression['properties'][number];
+/**
+ * Append items to an array or object literal, following its formatting
+ */
+declare function addElements(file: SourceFile, container: Container, items: string[]): void;
+/**
+ * Remove the items of an array or object literal that don't pass the filter
+ */
+declare function filterElements<C extends Container>(file: SourceFile, container: C, keep: (element: ElementOf<C>) => boolean): void;
+//#endregion
+//#region src/codemod/config.d.ts
+/**
+ * The options object of a config file, e.g. the argument of `defineConfig({ ... })`, or the object in `export default { ... }`
+ */
+declare function getConfigObject(file: SourceFile): ObjectExpression | undefined;
+/**
+ * Add a plugin call to the `plugins` array of a Vite config, skip if the same plugin is already added.
+ *
+ * @param path - property path to the plugins array, e.g. `['vite', 'plugins']` for Waku
+ */
+declare function addVitePlugin(file: SourceFile, plugin: {
+  name: string;
+  from: string;
+  call?: string;
+}, path?: string[]): boolean;
+/**
+ * Wrap the default export of `next.config.*` with `createMDX()`
+ */
+declare function wrapNextConfig(file: SourceFile): boolean;
+/**
+ * Add rewrites to a Next.js config, skip if `rewrites` is already defined
+ */
+declare function addNextRewrites(file: SourceFile, rewrites: {
+  source: string;
+  destination: string;
+}[]): boolean;
+//#endregion
+//#region src/codemod/react-router.d.ts
+/**
+ * filter items in a specific array initializer in the prerender function
+ */
+declare function filterReactRouterPrerenderArray(file: SourceFile, array: 'paths' | 'excluded', filter: (item: string) => boolean): void;
+/**
+ * add items to a specific array initializer in the prerender function, skip existing ones
+ */
+declare function addReactRouterPrerenderArray(file: SourceFile, array: 'paths' | 'excluded', items: string[]): void;
+/**
+ * Add new routes to route config, an item can be raw code (e.g. `layout(...)`)
+ */
+declare function addReactRouterRoute(file: SourceFile, routes: ({
+  path: string;
+  entry: string;
+} | string)[]): boolean;
+/**
+ * Remove routes from route config (root level only)
+ */
+declare function filterReactRouterRoute(file: SourceFile, filter: (item: {
+  path: string;
+  entry: string;
+}) => boolean): void;
+//#endregion
+//#region src/codemod/tanstack-start.d.ts
+/**
+ * Add path to the `pages` array in tanstack start vite config.
+ *
+ * If the `pages` property doesn't exist, create one.
+ */
+declare function addTanstackPrerender(file: SourceFile, paths: string[]): void;
+//#endregion
+//#region src/codemod/source.d.ts
+/**
+ * Enable `includeProcessedMarkdown` on the `defineDocs()` call
+ *
+ * @returns `false` if the call cannot be found
+ */
+declare function enableProcessedMarkdown(file: SourceFile): boolean;
+//#endregion
+//#region src/codemod/next-proxy.d.ts
+/**
+ * Add patterns to the `matcher` of `export const config` in a Next.js proxy (middleware) file
+ */
+declare function addProxyMatcher(file: SourceFile, patterns: string[]): boolean;
+//#endregion
+export { getDefaultExport as C, parseSourceFile as D, lineIndent as E, prependJsxChildren as O, findJsxElement as S, getStringValue as T, appendJsxChildren as _, addReactRouterRoute as a, filterElements as b, addNextRewrites as c, wrapNextConfig as d, NodeOfType as f, addJsxAttribute as g, addImport as h, addReactRouterPrerenderArray as i, addVitePlugin as l, addElements as m, enableProcessedMarkdown as n, filterReactRouterPrerenderArray as o, SourceFile as p, addTanstackPrerender as r, filterReactRouterRoute as s, addProxyMatcher as t, getConfigObject as u, createSourceFile as v, getProperty as w, find as x, descendants as y };
+//# sourceMappingURL=index-Ck0EPdgu.d.ts.map

package/dist/index-Ck0EPdgu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Ck0EPdgu.d.ts","names":[],"sources":["../src/codemod/shared.ts","../src/codemod/config.ts","../src/codemod/react-router.ts","../src/codemod/tanstack-start.ts","../src/codemod/source.ts","../src/codemod/next-proxy.ts"],"mappings":";;;KAgBY,WAAW,UAAU,gBAAgB,QAAQ;EAAQ,MAAM;;UAEtD;EACf;;EAEA;EACA,SAAS;;EAET,GAAG;EACH,QAAQ;;iBAGM,gBAAgB,cAAc,eAAe;iBAcvC,iBAAiB,eAAe,QAAQ;;iBAK9C,eAAe,MAAM;iBAMpB,YAAY,MAAM,OAAO,UAAU;iBAapC,KAAK,UAAU,cAC7B,MAAM,MACN,MAAM,GACN,aAAa,MAAM,WAAW,iBAC7B,WAAW;iBAOE,iBAAiB,MAAM,aAAa;iBAIpC,eAAe,MAAM,YAAY,kBAAkB;iBAMnD,gBAAgB,MAAM,YAAY,SAAS,mBAAmB;;;;iBAa9D,mBAAmB,MAAM,YAAY,SAAS,YAAY;;;;iBAa1D,kBAAkB,MAAM,YAAY,SAAS,YAAY;iBAyBzD,YAAY,QAAQ,kBAAkB,eAAe;;iBAYrD,WAAW,cAAc;iBAKzB,UACd,MAAM,YACN;EAAe;EAAc;EAAkB;;KAkC5C,YAAY,kBAAkB;KAC9B,UAAU,UAAU,aAAa,UAAU,kBAC5C,YAAY,uCACZ;;;;iBAUY,YAAY,MAAM,YAAY,WAAW,WAAW;;;;iBA4BpD,eAAe,UAAU,WACvC,MAAM,YACN,WAAW,GACX,OAAO,SAAS,UAAU;;;;;;iBC9NZ,gBAAgB,MAAM,aAAa;;;;;;iBAiCnC,cACd,MAAM,YACN;EAAU;EAAc;EAAc;GACtC;;;;iBAqCc,eAAe,MAAM;;;;iBAkBrB,gBACd,MAAM,YACN;EAAY;EAAgB;;;;;;;iBC5Fd,gCACd,MAAM,YACN,6BACA,SAAS;;;;iBAcK,6BACd,MAAM,YACN,6BACA;;;;iBAgCc,oBACd,MAAM,YACN;EAAW;EAAc;;;;;iBAgBX,uBACd,MAAM,YACN,SAAS;EAAQ;EAAc;;;;;;;;;iBCvEjB,qBAAqB,MAAM,YAAY;;;;;;;;iBCRvC,wBAAwB,MAAM;;;;;;iBCF9B,gBAAgB,MAAM,YAAY"}

package/dist/index-Cs7hw2un.d.ts

@@ -0,0 +1,76 @@
+import { p as SourceFile } from "./index-Ck0EPdgu.js";
+import { a as Project } from "./index-DI66DoV8.js";
+import { RegistryConnector } from "fuma-cli/registry/connector";
+//#region src/features/index.d.ts
+interface SelectOption<T> {
+  message: string;
+  choices: {
+    value: T;
+    label: string;
+    hint?: string;
+  }[];
+}
+interface ConfirmOption {
+  message: string;
+  initialValue?: boolean;
+}
+type FeatureOption<T> = [T] extends [boolean] ? ConfirmOption : SelectOption<T>;
+interface Feature<Options extends object = Record<never, never>> {
+  id: string;
+  title: string;
+  description: string;
+  options?: { [K in keyof Options]: FeatureOption<Options[K]>; };
+  /** features that must be applied first */
+  requires?: AnyFeature[];
+  /** whether the feature is already applied to the project */
+  detect?: (project: Project) => Promise<boolean>;
+  /** @returns `true` if supported, otherwise the reason */
+  supports?: (project: Project) => true | string;
+  apply(ctx: FeatureContext, options: Options): Promise<void>;
+}
+type AnyFeature = Omit<Feature<Record<string, unknown>>, 'options'> & {
+  options?: Record<string, SelectOption<unknown> | ConfirmOption>;
+};
+interface PackageJson {
+  scripts?: Record<string, string>;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+}
+interface FeatureContext {
+  project: Project;
+  /** write a file (relative to project root), asks before overwriting */
+  write: (file: string, content: string) => Promise<void>;
+  /** edit a file with codemods, `false` if the file doesn't exist */
+  source: (file: string, edit: (file: SourceFile) => void) => Promise<boolean>;
+  /** append lines to a text file, skip lines already present */
+  append: (file: string, lines: string[]) => Promise<void>;
+  remove: (file: string) => Promise<void>;
+  packageJson: (edit: (data: PackageJson) => void) => Promise<void>;
+  /** install a registry component */
+  install: (name: string, subRegistry?: string) => Promise<void>;
+  /** `null` to install the latest version */
+  addDependencies: (deps: Record<string, string | null>, dev?: boolean) => void;
+  env: (key: string, value: string) => void;
+  /** instructions to show after the feature is applied */
+  note: (text: string) => void;
+  log: (message: string) => void;
+}
+interface FeatureIO {
+  log: (message: string) => void;
+  confirmOverwrite: (file: string) => Promise<boolean>;
+  /** run package manager to install dependencies, otherwise only write them into `package.json` */
+  installDependencies: boolean;
+}
+interface RunOptions {
+  project: Project;
+  connector: RegistryConnector;
+  io: FeatureIO;
+  /** preferred versions of dependencies, when a feature doesn't specify one */
+  versions?: Record<string, string>;
+}
+declare function runFeature<O extends object>(feature: Omit<Feature<O>, 'options'>, options: O, { project, connector, io, versions }: RunOptions): Promise<{
+  notes: string[];
+}>;
+//#endregion
+export { FeatureIO as a, RunOptions as c, FeatureContext as i, SelectOption as l, ConfirmOption as n, FeatureOption as o, Feature as r, PackageJson as s, AnyFeature as t, runFeature as u };
+//# sourceMappingURL=index-Cs7hw2un.d.ts.map

package/dist/index-Cs7hw2un.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Cs7hw2un.d.ts","names":[],"sources":["../src/features/index.ts"],"mappings":";;;;UASiB,aAAa;EAC5B;EACA;IAAW,OAAO;IAAG;IAAe;;;UAGrB;EACf;EACA;;KAGU,cAAc,MAAM,uBAAuB,gBAAgB,aAAa;UAEnE,QAAQ,yBAAyB;EAChD;EACA;EACA;EACA,aAAa,WAAW,UAAU,cAAc,QAAQ;;EAExD,WAAW;;EAEX,UAAU,SAAS,YAAY;;EAE/B,YAAY,SAAS;EACrB,MAAM,KAAK,gBAAgB,SAAS,UAAU;;KAGpC,aAAa,KAAK,QAAQ;EACpC,UAAU,eAAe,wBAAwB;;UAGlC;EACf,UAAU;EACV,eAAe;EACf,kBAAkB;;UAGH;EACf,SAAS;;EAET,QAAQ,cAAc,oBAAoB;;EAE1C,SAAS,cAAc,OAAO,MAAM,wBAAwB;;EAE5D,SAAS,cAAc,oBAAoB;EAC3C,SAAS,iBAAiB;EAC1B,cAAc,OAAO,MAAM,yBAAyB;;EAEpD,UAAU,cAAc,yBAAyB;;EAEjD,kBAAkB,MAAM,+BAA+B;EACvD,MAAM,aAAa;;EAEnB,OAAO;EACP,MAAM;;UAGS;EACf,MAAM;EACN,mBAAmB,iBAAiB;;EAEpC;;UAGe;EACf,SAAS;EACT,WAAW;EACX,IAAI;;EAEJ,WAAW;;iBAGS,WAAW,kBAC/B,SAAS,KAAK,QAAQ,gBACtB,SAAS,KACP,SAAS,WAAW,IAAI,YAAY,aACrC;EAAU"}

package/dist/index-DI66DoV8.d.ts

@@ -0,0 +1,64 @@
+import { r as LoadedConfig } from "./config-Bfg4yG8S.js";
+import { detectFramework as detectFramework$1, detectPackageManager } from "fuma-cli/detect";
+//#region src/project/index.d.ts
+type PackageManager = NonNullable<Awaited<ReturnType<typeof detectPackageManager>>>['name'];
+type Framework = 'next' | 'react-router' | 'tanstack-start' | 'waku' | 'astro';
+/** frameworks supported by features that generate routes */
+type ReactFramework = Exclude<Framework, 'astro'>;
+interface FrameworkInfo {
+  /** import specifier of `RootProvider` */
+  provider: string;
+  /** root file that imports the global CSS, relative to base dir */
+  rootFile: string;
+  /** routes directory, relative to base dir */
+  routesDir: string;
+  /** config file candidates (relative to cwd) that register bundler plugins */
+  configFiles: string[];
+  /** how to detect `static` mode from the config file */
+  isStatic?: (config: string) => boolean;
+}
+declare const frameworks: Record<Framework, FrameworkInfo>;
+/** how docs content is loaded, detected from `lib/source.ts` */
+interface SourceInfo {
+  /** `lib/source.ts` exports a `source` loader */
+  loader: boolean;
+  /** `lib/source.ts` exports `getSource()`, a runtime content source resolved on demand */
+  dynamic: boolean;
+  /** file defining the Fumadocs MDX collections, relative to cwd: `lib/source.ts` (macro) or `source.config.ts`; `null` for other content sources */
+  collections: string | null;
+  /** collections are loaded lazily, `structuredData` is a function */
+  async: boolean;
+  /** base URL of docs pages */
+  baseUrl: string;
+  /** content directory */
+  dir: string;
+}
+interface I18nInfo {
+  /** the default locale is hidden from URLs (`hideLocale: 'default-locale'`) */
+  optionalLocale: boolean;
+}
+interface Project {
+  cwd: string;
+  framework: Framework;
+  info: FrameworkInfo;
+  /** prerendered to static HTML, no server at runtime */
+  static: boolean;
+  /** `lib/i18n.ts` exists */
+  i18n: I18nInfo | null;
+  source: SourceInfo;
+  packageManager: PackageManager;
+  /** directory of app code, relative to `cwd` */
+  baseDir: string;
+  config: LoadedConfig;
+  /** config file that registers bundler plugins, relative to `cwd` */
+  configFile?: string;
+  packageJson: {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+  };
+}
+declare function isSupportedFramework(v: string): v is Framework;
+declare function loadProject(config: LoadedConfig, cwd?: string, framework?: Framework): Promise<Project>;
+//#endregion
+export { Project as a, detectFramework$1 as c, loadProject as d, PackageManager as i, frameworks as l, FrameworkInfo as n, ReactFramework as o, I18nInfo as r, SourceInfo as s, Framework as t, isSupportedFramework as u };
+//# sourceMappingURL=index-DI66DoV8.d.ts.map

package/dist/index-DI66DoV8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DI66DoV8.d.ts","names":[],"sources":["../src/project/index.ts"],"mappings":";;;KAMY,iBAAiB,YAAY,QAAQ,kBAAkB;KAEvD;;KAEA,iBAAiB,QAAQ;UAEpB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,YAAY;;cAGD,YAAY,OAAO,WAAW;;UAoC1B;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;UAGe;;EAEf;;UAGe;EACf;EACA,WAAW;EACX,MAAM;;EAEN;;EAEA,MAAM;EACN,QAAQ;EACR,gBAAgB;;EAEhB;EACA,QAAQ;;EAER;EACA;IACE,eAAe;IACf,kBAAkB;;;iBAIN,qBAAqB,YAAY,KAAK;iBAIhC,YACpB,QAAQ,cACR,cACA,YAAW,YACV,QAAQ"}