@fumadocs/cli 1.2.5 → 1.3.0

package/dist/registry/installer/index.d.ts

@@ -0,0 +1,106 @@
+import { i as Component, o as File } from "../../schema-CKNbRBjk.js";
+import { RegistryClient } from "../client.js";
+import { ParseResult } from "oxc-parser";
+import { AgentName } from "package-manager-detector";
+import MagicString from "magic-string";
+
+//#region src/utils/get-package-manager.d.ts
+type PackageManager = AgentName;
+//#endregion
+//#region src/registry/installer/dep-manager.d.ts
+declare class DependencyManager {
+  private readonly cwd;
+  private installedDeps;
+  dependencies: string[];
+  devDependencies: string[];
+  packageManager: PackageManager;
+  constructor(cwd: string);
+  init(deps: Record<string, string | null>, devDeps: Record<string, string | null>): Promise<void>;
+  private resolveRequiredDependencies;
+  hasRequired(): boolean;
+  writeRequired(): Promise<false | undefined>;
+  installRequired(): Promise<void>;
+}
+//#endregion
+//#region src/registry/installer/index.d.ts
+interface PluginContext {
+  installer: ComponentInstaller;
+}
+interface TransformContext extends PluginContext, InstallContext {
+  s: MagicString;
+  parsed: ParseResult;
+  file: File;
+  component: DownloadedComponent;
+}
+interface InstallContext {
+  pathToFile: Map<string, File>;
+  io: IOInterface;
+  /** full variables of the current component. */
+  $variables: Record<string, unknown>;
+  /** the last item is always the current component. */
+  stack: DownloadedComponent[];
+}
+interface DownloadedComponent extends Component {
+  $subComponents: DownloadedComponent[];
+  $registry: RegistryClient;
+}
+type Awaitable<T> = T | Promise<T>;
+interface ComponentInstallerPlugin {
+  /**
+   * transform file before writing (before default transformation)
+   */
+  beforeTransform?: (context: TransformContext) => Awaitable<void>;
+  /**
+   * transform file before writing (after default transformation)
+   */
+  afterTransform?: (context: TransformContext) => Awaitable<void>;
+  /**
+   * transform component before install
+   */
+  beforeInstall?: (comp: DownloadedComponent, context: InstallContext & PluginContext) => Awaitable<DownloadedComponent | undefined>;
+  beforeDownload?: (context: PluginContext & {
+    name: string;
+  }) => void | Promise<void>;
+  afterDownload?: (context: PluginContext & {
+    name: string;
+    result: DownloadedComponent;
+  }) => void | Promise<void>;
+}
+interface IOInterface {
+  onWarn: (message: string) => void;
+  confirmFileOverride: (options: {
+    path: string;
+  }) => Promise<boolean>;
+  onFileDownloaded: (options: {
+    path: string;
+    file: File;
+    component: Component;
+  }) => void;
+}
+interface ComponentInstallerOptions {
+  plugins?: ComponentInstallerPlugin[];
+  cwd?: string;
+}
+declare class ComponentInstaller {
+  private readonly rootClient;
+  private readonly installedFiles;
+  private readonly downloadCache;
+  private readonly cwd;
+  private readonly plugins;
+  readonly dependencies: Record<string, string | null>;
+  readonly devDependencies: Record<string, string | null>;
+  constructor(rootClient: RegistryClient, options?: ComponentInstallerOptions);
+  private installComponent;
+  install(name: string, io: IOInterface): Promise<void>;
+  deps(): Promise<DependencyManager>;
+  onEnd(): Promise<void>;
+  /**
+   * download component & its sub components
+   */
+  private download;
+  private transform;
+  private resolveOutputPath;
+}
+//#endregion
+export { ComponentInstaller, ComponentInstallerOptions, ComponentInstallerPlugin, IOInterface };
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/installer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/utils/get-package-manager.ts","../../../src/registry/installer/dep-manager.ts","../../../src/registry/installer/index.ts"],"mappings":";;;;;;;KAEY,cAAA,GAAiB,SAAA;;;cCQhB,iBAAA;EAAA,iBAMkB,GAAA;EAAA,QALrB,aAAA;EACR,YAAA;EACA,eAAA;EACA,cAAA,EAAgB,cAAA;cAEa,GAAA;EAEvB,IAAA,CAAK,IAAA,EAAM,MAAA,yBAA+B,OAAA,EAAS,MAAA,0BAA6B,OAAA;EAAA,QAyB9E,2BAAA;EAMR,WAAA,CAAA;EAIM,aAAA,CAAA,GAAa,OAAA;EAuBb,eAAA,CAAA,GAAe,OAAA;AAAA;;;UChEb,aAAA;EACR,SAAA,EAAW,kBAAA;AAAA;AAAA,UAGH,gBAAA,SAAyB,aAAA,EAAe,cAAA;EAChD,CAAA,EAAG,WAAA;EACH,MAAA,EAAQ,WAAA;EACR,IAAA,EAAM,IAAA;EACN,SAAA,EAAW,mBAAA;AAAA;AAAA,UAGH,cAAA;EACR,UAAA,EAAY,GAAA,SAAY,IAAA;EACxB,EAAA,EAAI,WAAA;EDfwB;ECiB5B,UAAA,EAAY,MAAA;EDbI;ECehB,KAAA,EAAO,mBAAA;AAAA;AAAA,UAGC,mBAAA,SAA4B,SAAA;EACpC,cAAA,EAAgB,mBAAA;EAChB,SAAA,EAAW,cAAA;AAAA;AAAA,KAGR,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA;AAAA,UAEf,wBAAA;ED5BP;;;ECgCR,eAAA,IAAmB,OAAA,EAAS,gBAAA,KAAqB,SAAA;ED7BjC;;;ECkChB,cAAA,IAAkB,OAAA,EAAS,gBAAA,KAAqB,SAAA;ED9B/B;;;ECmCjB,aAAA,IACE,IAAA,EAAM,mBAAA,EACN,OAAA,EAAS,cAAA,GAAiB,aAAA,KACvB,SAAA,CAAU,mBAAA;EAEf,cAAA,IACE,OAAA,EAAS,aAAA;IACP,IAAA;EAAA,aAEQ,OAAA;EAEZ,aAAA,IACE,OAAA,EAAS,aAAA;IACP,IAAA;IACA,MAAA,EAAQ,mBAAA;EAAA,aAEA,OAAA;AAAA;AAAA,UAGG,WAAA;EACf,MAAA,GAAS,OAAA;EACT,mBAAA,GAAsB,OAAA;IAAW,IAAA;EAAA,MAAmB,OAAA;EACpD,gBAAA,GAAmB,OAAA;IAAW,IAAA;IAAc,IAAA,EAAM,IAAA;IAAM,SAAA,EAAW,SAAA;EAAA;AAAA;AAAA,UAGpD,yBAAA;EACf,OAAA,GAAU,wBAAA;EACV,GAAA;AAAA;AAAA,cAGW,kBAAA;EAAA,iBASQ,UAAA;EAAA,iBARF,cAAA;EAAA,iBACA,aAAA;EAAA,iBACA,GAAA;EAAA,iBACA,OAAA;EAAA,SACR,YAAA,EAAc,MAAA;EAAA,SACd,eAAA,EAAiB,MAAA;cAGP,UAAA,EAAY,cAAA,EAC7B,OAAA,GAAS,yBAAA;EAAA,QAMG,gBAAA;EAsDR,OAAA,CAAQ,IAAA,UAAc,EAAA,EAAI,WAAA,GAAW,OAAA;EAuCrC,IAAA,CAAA,GAAI,OAAA,CAAA,iBAAA;EAMJ,KAAA,CAAA,GAAK,OAAA;EAlLX;;;EAAA,QA4Lc,QAAA;EAAA,QAoDA,SAAA;EAAA,QA2CN,iBAAA;AAAA"}

package/dist/registry/installer/index.js

@@ -0,0 +1,4 @@
+import "../../ast-BRNdmLn5.js";
+import "../../client-YTcWP1iz.js";
+import { t as ComponentInstaller } from "../../installer-BS70ExnQ.js";
+export { ComponentInstaller };

package/dist/registry/schema.d.ts

@@ -0,0 +1,2 @@
+import { a as DownloadedRegistryInfo, c as componentSchema, d as indexSchema, f as namespaces, i as Component, l as fileSchema, n as CompiledFile, o as File, p as registryInfoSchema, r as CompiledRegistryInfo, s as NamespaceType, t as CompiledComponent, u as httpSubComponent } from "../schema-CKNbRBjk.js";
+export { CompiledComponent, CompiledFile, CompiledRegistryInfo, Component, DownloadedRegistryInfo, File, NamespaceType, componentSchema, fileSchema, httpSubComponent, indexSchema, namespaces, registryInfoSchema };

package/dist/registry/schema.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+//#region src/registry/schema.ts
+const namespaces = [
+	"components",
+	"lib",
+	"css",
+	"route",
+	"ui",
+	"block"
+];
+const indexSchema = z.object({
+	name: z.string(),
+	title: z.string().optional(),
+	description: z.string().optional()
+});
+const fileSchema = z.object({
+	type: z.literal(namespaces),
+	path: z.string(),
+	target: z.string().optional(),
+	content: z.string()
+});
+const httpSubComponent = z.object({
+	type: z.literal("http"),
+	baseUrl: z.string(),
+	component: z.string()
+});
+const componentSchema = z.object({
+	name: z.string(),
+	title: z.string().optional(),
+	description: z.string().optional(),
+	files: z.array(fileSchema),
+	dependencies: z.record(z.string(), z.string().or(z.null())),
+	devDependencies: z.record(z.string(), z.string().or(z.null())),
+	subComponents: z.array(z.string().or(httpSubComponent)).default([]),
+	variables: z.record(z.string(), z.unknown()).optional()
+});
+const registryInfoSchema = z.object({
+	variables: z.record(z.string(), z.object({ description: z.string().optional() })).optional(),
+	env: z.record(z.string(), z.unknown()).optional(),
+	indexes: z.array(indexSchema).default([]),
+	registries: z.array(z.string()).optional()
+});
+//#endregion
+export { componentSchema, fileSchema, httpSubComponent, indexSchema, namespaces, registryInfoSchema };
+
+//# sourceMappingURL=schema.js.map

package/dist/registry/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/registry/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport type NamespaceType = (typeof namespaces)[number];\nexport type CompiledFile = z.input<typeof fileSchema>;\nexport type CompiledComponent = z.input<typeof componentSchema>;\nexport type CompiledRegistryInfo = z.input<typeof registryInfoSchema>;\nexport type DownloadedRegistryInfo = z.output<typeof registryInfoSchema>;\nexport type File = z.output<typeof fileSchema>;\nexport type Component = z.output<typeof componentSchema>;\n\nexport const namespaces = ['components', 'lib', 'css', 'route', 'ui', 'block'] as const;\n\nexport const indexSchema = z.object({\n  name: z.string(),\n  title: z.string().optional(),\n  description: z.string().optional(),\n});\n\nexport const fileSchema = z.object({\n  type: z.literal(namespaces),\n  path: z.string(),\n  target: z.string().optional(),\n  content: z.string(),\n});\n\nexport const httpSubComponent = z.object({\n  type: z.literal('http'),\n  baseUrl: z.string(),\n  component: z.string(),\n});\n\nexport const componentSchema = z.object({\n  name: z.string(),\n  title: z.string().optional(),\n  description: z.string().optional(),\n  files: z.array(fileSchema),\n  dependencies: z.record(z.string(), z.string().or(z.null())),\n  devDependencies: z.record(z.string(), z.string().or(z.null())),\n  /**\n   * list of sub components, either local (component name) or remote (registry info & component name)\n   */\n  subComponents: z.array(z.string().or(httpSubComponent)).default([]),\n\n  /**\n   * override variables for the current component & its sub components.\n   *\n   * this is powerful to customise how sub components are installed vs. installing them directly.\n   */\n  variables: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const registryInfoSchema = z.object({\n  /**\n   * define metadata for variables, variables can be referenced in the target path of component files, or in plugins.\n   */\n  variables: z\n    .record(\n      z.string(),\n      z.object({\n        description: z.string().optional(),\n      }),\n    )\n    .optional(),\n  /**\n   * override variables for all components.\n   */\n  env: z.record(z.string(), z.unknown()).optional(),\n  indexes: z.array(indexSchema).default([]),\n\n  registries: z.array(z.string()).optional(),\n});\n"],"mappings":";;AAUA,MAAa,aAAa;CAAC;CAAc;CAAO;CAAO;CAAS;CAAM;CAAQ;AAE9E,MAAa,cAAc,EAAE,OAAO;CAClC,MAAM,EAAE,QAAQ;CAChB,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC5B,aAAa,EAAE,QAAQ,CAAC,UAAU;CACnC,CAAC;AAEF,MAAa,aAAa,EAAE,OAAO;CACjC,MAAM,EAAE,QAAQ,WAAW;CAC3B,MAAM,EAAE,QAAQ;CAChB,QAAQ,EAAE,QAAQ,CAAC,UAAU;CAC7B,SAAS,EAAE,QAAQ;CACpB,CAAC;AAEF,MAAa,mBAAmB,EAAE,OAAO;CACvC,MAAM,EAAE,QAAQ,OAAO;CACvB,SAAS,EAAE,QAAQ;CACnB,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,MAAa,kBAAkB,EAAE,OAAO;CACtC,MAAM,EAAE,QAAQ;CAChB,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC5B,aAAa,EAAE,QAAQ,CAAC,UAAU;CAClC,OAAO,EAAE,MAAM,WAAW;CAC1B,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;CAC3D,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;CAI9D,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC;CAOnE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;CACxD,CAAC;AAEF,MAAa,qBAAqB,EAAE,OAAO;CAIzC,WAAW,EACR,OACC,EAAE,QAAQ,EACV,EAAE,OAAO,EACP,aAAa,EAAE,QAAQ,CAAC,UAAU,EACnC,CAAC,CACH,CACA,UAAU;CAIb,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC,UAAU;CACjD,SAAS,EAAE,MAAM,YAAY,CAAC,QAAQ,EAAE,CAAC;CAEzC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAC3C,CAAC"}

package/dist/schema-CKNbRBjk.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+
+//#region src/registry/schema.d.ts
+type NamespaceType = (typeof namespaces)[number];
+type CompiledFile = z.input<typeof fileSchema>;
+type CompiledComponent = z.input<typeof componentSchema>;
+type CompiledRegistryInfo = z.input<typeof registryInfoSchema>;
+type DownloadedRegistryInfo = z.output<typeof registryInfoSchema>;
+type File = z.output<typeof fileSchema>;
+type Component = z.output<typeof componentSchema>;
+declare const namespaces: readonly ["components", "lib", "css", "route", "ui", "block"];
+declare const indexSchema: z.ZodObject<{
+  name: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const fileSchema: z.ZodObject<{
+  type: z.ZodLiteral<"components" | "lib" | "css" | "route" | "ui" | "block">;
+  path: z.ZodString;
+  target: z.ZodOptional<z.ZodString>;
+  content: z.ZodString;
+}, z.core.$strip>;
+declare const httpSubComponent: z.ZodObject<{
+  type: z.ZodLiteral<"http">;
+  baseUrl: z.ZodString;
+  component: z.ZodString;
+}, z.core.$strip>;
+declare const componentSchema: z.ZodObject<{
+  name: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  files: z.ZodArray<z.ZodObject<{
+    type: z.ZodLiteral<"components" | "lib" | "css" | "route" | "ui" | "block">;
+    path: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+  }, z.core.$strip>>;
+  dependencies: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+  devDependencies: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+  subComponents: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    type: z.ZodLiteral<"http">;
+    baseUrl: z.ZodString;
+    component: z.ZodString;
+  }, z.core.$strip>]>>>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const registryInfoSchema: z.ZodObject<{
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  indexes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  registries: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+//#endregion
+export { DownloadedRegistryInfo as a, componentSchema as c, indexSchema as d, namespaces as f, Component as i, fileSchema as l, CompiledFile as n, File as o, registryInfoSchema as p, CompiledRegistryInfo as r, NamespaceType as s, CompiledComponent as t, httpSubComponent as u };
+//# sourceMappingURL=schema-CKNbRBjk.d.ts.map

package/dist/schema-CKNbRBjk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-CKNbRBjk.d.ts","names":[],"sources":["../src/registry/schema.ts"],"mappings":";;;KAEY,aAAA,WAAwB,UAAA;AAAA,KACxB,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,UAAA;AAAA,KAC9B,iBAAA,GAAoB,CAAA,CAAE,KAAA,QAAa,eAAA;AAAA,KACnC,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,kBAAA;AAAA,KACtC,sBAAA,GAAyB,CAAA,CAAE,MAAA,QAAc,kBAAA;AAAA,KACzC,IAAA,GAAO,CAAA,CAAE,MAAA,QAAc,UAAA;AAAA,KACvB,SAAA,GAAY,CAAA,CAAE,MAAA,QAAc,eAAA;AAAA,cAE3B,UAAA;AAAA,cAEA,WAAA,EAAW,CAAA,CAAA,SAAA;;;;;cAMX,UAAA,EAAU,CAAA,CAAA,SAAA;;;;;;cAOV,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;cAMhB,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;cAoBf,kBAAA,EAAkB,CAAA,CAAA,SAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fumadocs/cli",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "The CLI tool for Fumadocs",
   "keywords": [
     "Docs",
@@ -17,32 +17,33 @@
     "dist/*"
   ],
   "type": "module",
-  "main": "./dist/index.js",
   "exports": {
-    "./build": {
-      "types": "./dist/build/index.d.ts",
-      "import": "./dist/build/index.js"
-    }
+    "./build": "./dist/build/index.js",
+    "./config": "./dist/config.js",
+    "./registry/client": "./dist/registry/client.js",
+    "./registry/installer": "./dist/registry/installer/index.js",
+    "./registry/schema": "./dist/registry/schema.js",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@clack/prompts": "^1.0.1",
+    "@clack/prompts": "^1.1.0",
     "commander": "^14.0.3",
     "magic-string": "^0.30.21",
-    "oxc-parser": "^0.115.0",
+    "oxc-parser": "^0.121.0",
     "oxc-resolver": "^11.19.1",
     "package-manager-detector": "^1.6.0",
     "picocolors": "^1.1.1",
-    "tinyexec": "^1.0.2",
+    "tinyexec": "^1.0.4",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@oxc-project/types": "^0.114.0",
-    "@types/node": "25.3.3",
-    "shadcn": "3.8.5",
-    "tsdown": "0.20.3",
+    "@oxc-project/types": "^0.121.0",
+    "@types/node": "25.5.0",
+    "shadcn": "4.0.8",
+    "tsdown": "0.21.4",
     "eslint-config-custom": "0.0.0",
     "tsconfig": "0.0.0"
   },