@kubb/core 5.0.0-alpha.8 → 5.0.0-beta.1

package/package.json

@@ -1,50 +1,29 @@
 {
   "name": "@kubb/core",
-  "version": "5.0.0-alpha.8",
+  "version": "5.0.0-beta.1",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
-    "typescript",
-    "plugins",
-    "plugin-system",
-    "plugin-framework",
+    "ast",
     "code-generator",
     "codegen",
-    "ast",
+    "core-library",
     "file-system",
+    "kubb",
+    "oas",
     "openapi",
+    "plugin-framework",
+    "plugin-system",
+    "plugins",
     "swagger",
-    "oas",
-    "core-library",
-    "kubb"
+    "typescript"
   ],
+  "license": "MIT",
+  "author": "stijnvanhulle",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kubb-labs/kubb.git",
     "directory": "packages/core"
   },
-  "license": "MIT",
-  "author": "stijnvanhulle",
-  "sideEffects": false,
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./hooks": {
-      "import": "./dist/hooks.js",
-      "require": "./dist/hooks.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "types": "./dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "hooks": [
-        "./dist/hooks.d.ts"
-      ]
-    }
-  },
   "files": [
     "src",
     "schemas",
@@ -56,41 +35,56 @@
     "!/**/__tests__/**",
     "!/**/__snapshots__/**"
   ],
-  "size-limit": [
-    {
-      "path": "./dist/*.js",
-      "limit": "510 KiB",
-      "gzip": true
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "mocks": [
+        "./dist/mocks.d.ts"
+      ]
     }
-  ],
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./mocks": {
+      "import": "./dist/mocks.js",
+      "require": "./dist/mocks.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "dependencies": {
-    "@kubb/fabric-core": "0.14.0",
-    "@kubb/react-fabric": "0.14.0",
-    "empathic": "^2.0.0",
     "fflate": "^0.8.2",
-    "remeda": "^2.33.6",
-    "semver": "^7.7.4",
-    "tinyexec": "^1.0.4",
-    "@kubb/ast": "5.0.0-alpha.8"
+    "tinyexec": "^1.1.2",
+    "@kubb/ast": "5.0.0-beta.1"
   },
   "devDependencies": {
-    "@types/semver": "^7.7.1",
     "p-limit": "^7.3.0",
-    "@internals/utils": "0.0.0"
+    "@internals/utils": "0.0.0",
+    "@kubb/renderer-jsx": "5.0.0-beta.1"
   },
   "peerDependencies": {
-    "@kubb/fabric-core": "0.14.0",
-    "@kubb/react-fabric": "0.14.0"
+    "@kubb/renderer-jsx": "5.0.0-beta.1"
   },
+  "size-limit": [
+    {
+      "path": "./dist/*.js",
+      "limit": "510 KiB",
+      "gzip": true
+    }
+  ],
   "engines": {
     "node": ">=22"
   },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
   "inlinedDependencies": {
     "p-limit": "7.3.0",
     "yocto-queue": "1.2.2"
@@ -98,8 +92,8 @@
   "scripts": {
     "build": "tsdown && size-limit",
     "clean": "npx rimraf ./dist",
-    "lint": "bun biome lint .",
-    "lint:fix": "bun biome lint --fix --unsafe .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
     "start": "tsdown --watch",

package/src/FileManager.ts

@@ -0,0 +1,115 @@
+import type { FileNode } from '@kubb/ast'
+import { createFile } from '@kubb/ast'
+
+function mergeFile<TMeta extends object = object>(a: FileNode<TMeta>, b: FileNode<TMeta>): FileNode<TMeta> {
+  return {
+    ...a,
+    // Incoming file (b) takes precedence for banner/footer so that barrel files,
+    // which never carry a banner, can clear banners set by plugin-generated files
+    // at the same path.
+    banner: b.banner,
+    footer: b.footer,
+    sources: [...(a.sources || []), ...(b.sources || [])],
+    imports: [...(a.imports || []), ...(b.imports || [])],
+    exports: [...(a.exports || []), ...(b.exports || [])],
+  }
+}
+
+/**
+ * Collapses a list of files so that duplicates sharing the same `path` are merged
+ * in arrival order. Keeps the original order of first occurrence.
+ */
+function mergeFilesByPath(files: ReadonlyArray<FileNode>): Map<string, FileNode> {
+  const merged = new Map<string, FileNode>()
+  for (const file of files) {
+    const existing = merged.get(file.path)
+    merged.set(file.path, existing ? mergeFile(existing, file) : file)
+  }
+  return merged
+}
+
+/**
+ * In-memory file store for generated files.
+ *
+ * Files with the same `path` are merged — sources, imports, and exports are concatenated.
+ * The `files` getter returns all stored files sorted by path length (shortest first).
+ *
+ * @example
+ * ```ts
+ * import { FileManager } from '@kubb/core'
+ *
+ * const manager = new FileManager()
+ * manager.upsert(myFile)
+ * console.log(manager.files) // all stored files
+ * ```
+ */
+export class FileManager {
+  readonly #cache = new Map<string, FileNode>()
+  #filesCache: Array<FileNode> | null = null
+
+  /**
+   * Adds one or more files. Incoming files with the same path are merged
+   * (sources/imports/exports concatenated), but existing cache entries are
+   * replaced — use {@link upsert} when you want to merge into the cache too.
+   */
+  add(...files: Array<FileNode>): Array<FileNode> {
+    return this.#store(files, false)
+  }
+
+  /**
+   * Adds or merges one or more files.
+   * If a file with the same path already exists in the cache, its
+   * sources/imports/exports are merged into the incoming file.
+   */
+  upsert(...files: Array<FileNode>): Array<FileNode> {
+    return this.#store(files, true)
+  }
+
+  #store(files: ReadonlyArray<FileNode>, mergeExisting: boolean): Array<FileNode> {
+    const resolvedFiles: Array<FileNode> = []
+    for (const file of mergeFilesByPath(files).values()) {
+      const existing = mergeExisting ? this.#cache.get(file.path) : undefined
+      const resolvedFile = createFile(existing ? mergeFile(existing, file) : file)
+      this.#cache.set(resolvedFile.path, resolvedFile)
+      resolvedFiles.push(resolvedFile)
+    }
+    this.#filesCache = null
+    return resolvedFiles
+  }
+
+  getByPath(path: string): FileNode | null {
+    return this.#cache.get(path) ?? null
+  }
+
+  deleteByPath(path: string): void {
+    this.#cache.delete(path)
+    this.#filesCache = null
+  }
+
+  clear(): void {
+    this.#cache.clear()
+    this.#filesCache = null
+  }
+
+  /**
+   * All stored files, sorted by path length (shorter paths first).
+   */
+  get files(): Array<FileNode> {
+    if (this.#filesCache) {
+      return this.#filesCache
+    }
+
+    this.#filesCache = [...this.#cache.values()].sort((a, b) => {
+      const lenDiff = a.path.length - b.path.length
+      if (lenDiff !== 0) return lenDiff
+      // Within the same length bucket, index.ts barrel files go last so other
+      // files are always processed before their barrel file.
+      const aIsIndex = a.path.endsWith('/index.ts') || a.path === 'index.ts'
+      const bIsIndex = b.path.endsWith('/index.ts') || b.path === 'index.ts'
+      if (aIsIndex && !bIsIndex) return 1
+      if (!aIsIndex && bIsIndex) return -1
+      return 0
+    })
+    return this.#filesCache
+  }
+}

package/src/FileProcessor.ts

@@ -0,0 +1,86 @@
+import type { CodeNode, FileNode } from '@kubb/ast'
+import { extractStringsFromNodes } from '@kubb/ast'
+import pLimit from 'p-limit'
+import { PARALLEL_CONCURRENCY_LIMIT } from './constants.ts'
+import type { Parser } from './defineParser.ts'
+
+type ParseOptions = {
+  parsers?: Map<FileNode['extname'], Parser>
+  extension?: Record<FileNode['extname'], FileNode['extname'] | ''>
+}
+
+type RunOptions = ParseOptions & {
+  /**
+   * @default 'sequential'
+   */
+  mode?: 'sequential' | 'parallel'
+  onStart?: (files: Array<FileNode>) => Promise<void> | void
+  onEnd?: (files: Array<FileNode>) => Promise<void> | void
+  onUpdate?: (params: { file: FileNode; source?: string; processed: number; total: number; percentage: number }) => Promise<void> | void
+}
+
+function joinSources(file: FileNode): string {
+  return file.sources
+    .map((item) => extractStringsFromNodes(item.nodes as Array<CodeNode>))
+    .filter(Boolean)
+    .join('\n\n')
+}
+
+/**
+ * Converts a single file to a string using the registered parsers.
+ * Falls back to joining source values when no matching parser is found.
+ *
+ * @internal
+ */
+export class FileProcessor {
+  readonly #limit = pLimit(PARALLEL_CONCURRENCY_LIMIT)
+
+  async parse(file: FileNode, { parsers, extension }: ParseOptions = {}): Promise<string> {
+    const parseExtName = extension?.[file.extname] || undefined
+
+    if (!parsers || !file.extname) {
+      return joinSources(file)
+    }
+
+    const parser = parsers.get(file.extname)
+
+    if (!parser) {
+      return joinSources(file)
+    }
+
+    return parser.parse(file, { extname: parseExtName })
+  }
+
+  async run(files: Array<FileNode>, { parsers, mode = 'sequential', extension, onStart, onEnd, onUpdate }: RunOptions = {}): Promise<Array<FileNode>> {
+    await onStart?.(files)
+
+    const total = files.length
+    let processed = 0
+
+    const processOne = async (file: FileNode) => {
+      const source = await this.parse(file, { extension, parsers })
+      const currentProcessed = ++processed
+      const percentage = (currentProcessed / total) * 100
+
+      await onUpdate?.({
+        file,
+        source,
+        processed: currentProcessed,
+        percentage,
+        total,
+      })
+    }
+
+    if (mode === 'sequential') {
+      for (const file of files) {
+        await processOne(file)
+      }
+    } else {
+      await Promise.all(files.map((file) => this.#limit(() => processOne(file))))
+    }
+
+    await onEnd?.(files)
+
+    return files
+  }
+}