@kubb/core 3.0.0-alpha.17 → 3.0.0-alpha.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "3.0.0-alpha.17",
+  "version": "3.0.0-alpha.19",
   "description": "Generator core",
   "keywords": [
     "typescript",
@@ -80,17 +80,15 @@
     "natural-orderby": "^3.0.2",
     "object-hash": "^3.0.0",
     "p-queue": "^8.0.1",
-    "remeda": "^2.12.0",
+    "remeda": "^2.12.1",
     "seedrandom": "^3.0.5",
     "semver": "^7.6.3",
-    "unraw": "^3.0.0",
-    "@kubb/fs": "3.0.0-alpha.17",
-    "@kubb/parser-ts": "3.0.0-alpha.17",
-    "@kubb/types": "3.0.0-alpha.17"
+    "@kubb/fs": "3.0.0-alpha.19",
+    "@kubb/parser-ts": "3.0.0-alpha.19",
+    "@kubb/types": "3.0.0-alpha.19"
   },
   "devDependencies": {
     "@types/object-hash": "^3.0.6",
-    "@types/react": "^18.3.5",
     "@types/seedrandom": "^3.0.8",
     "@types/semver": "^7.5.8",
     "consola": "^3.2.3",
@@ -98,9 +96,8 @@
     "tinyrainbow": "^1.2.0",
     "tsup": "^8.2.4",
     "typescript": "^5.6.2",
-    "@kubb/config-biome": "3.0.0-alpha.17",
-    "@kubb/config-ts": "3.0.0-alpha.17",
-    "@kubb/config-tsup": "3.0.0-alpha.17"
+    "@kubb/config-ts": "3.0.0-alpha.19",
+    "@kubb/config-tsup": "3.0.0-alpha.19"
   },
   "engines": {
     "node": ">=20"

package/src/BarrelManager.ts

@@ -7,7 +7,7 @@ import type * as KubbFile from '@kubb/fs/types'
 import type { FileMetaBase } from './FileManager.ts'
 import type { Logger } from './logger.ts'
 
-export type BarrelManagerOptions = {
+type BarrelManagerOptions = {
   logger?: Logger
 }
 

package/src/FileManager.ts

@@ -204,7 +204,7 @@ export async function getSource<TMeta extends FileMetaBase = FileMetaBase>(file:
   return parser.format(source)
 }
 
-export function mergeFile<TMeta extends FileMetaBase = FileMetaBase>(a: KubbFile.File<TMeta>, b: KubbFile.File<TMeta>): KubbFile.File<TMeta> {
+function mergeFile<TMeta extends FileMetaBase = FileMetaBase>(a: KubbFile.File<TMeta>, b: KubbFile.File<TMeta>): KubbFile.File<TMeta> {
   return {
     ...a,
     sources: [...(a.sources || []), ...(b.sources || [])],
@@ -216,7 +216,7 @@ export function mergeFile<TMeta extends FileMetaBase = FileMetaBase>(a: KubbFile
 export function combineSources(sources: Array<KubbFile.Source>): Array<KubbFile.Source> {
   return sources.reduce(
     (prev, curr) => {
-      const prevByName = prev.findLast((imp) => imp.name === curr.name)
+      const prevByName = prev.findLast((imp) => imp.name && imp.name === curr.name)
       const prevByPathAndIsExportable = prev.findLast((imp) => imp.name === curr.name && imp.isExportable)
 
       if (prevByPathAndIsExportable) {

package/src/PromiseManager.ts

@@ -42,7 +42,7 @@ export function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {
   return !!result && typeof (result as Promise<unknown>)?.then === 'function'
 }
 
-export function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {
+function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {
   return result.status === 'fulfilled'
 }
 

package/src/transformers/escape.ts

@@ -29,13 +29,3 @@ export function jsStringEscape(input: any): string {
     }
   })
 }
-
-export function escapeStringRegexp(string: string) {
-  if (typeof string !== 'string') {
-    throw new TypeError('Expected a string')
-  }
-
-  // Escape characters with special meaning either inside or outside character sets.
-  // Use a simple backslash escape when it’s always valid, and a `\xnn` escape when the simpler form would be disallowed by Unicode patterns’ stricter grammar.
-  return string.replace(/[|\\{}()[\]^$+*?.]/g, '\\$&').replace(/-/g, '\\x2d')
-}

package/src/types.ts

@@ -144,6 +144,7 @@ export type UserPlugin<TOptions extends PluginFactoryOptions = PluginFactoryOpti
    * @example @kubb/typescript
    */
   name: TOptions['name']
+  output?: Output
   /**
    * Options set for a specific plugin(see kubb.config.js), passthrough of options.
    */
@@ -180,21 +181,7 @@ export type Plugin<TOptions extends PluginFactoryOptions = PluginFactoryOptions>
    * @private
    */
   key: TOptions['key']
-  output?: {
-    /**
-     * Output to save the clients.
-     */
-    path: string
-    /**
-     * Add an extension to the generated imports and exports, default it will not use an extension
-     */
-    extName?: KubbFile.Extname
-    /**
-     * Define what needs to exported, here you can also disable the export of barrel files
-     * @default `'barrelNamed'`
-     */
-    exportType?: 'barrel' | 'barrelNamed' | false
-  }
+  output?: Output
   /**
    * Specifies the preceding plugins for the current plugin. You can pass an array of preceding plugin names, and the current plugin will be executed after these plugins.
    * Can be used to validate dependent plugins.
@@ -292,3 +279,31 @@ export type PluginContext<TOptions extends PluginFactoryOptions = PluginFactoryO
    */
   plugin: Plugin<TOptions>
 }
+
+export type Output = {
+  /**
+   * Output to save the generated files.
+   */
+  path: string
+  /**
+   * Name to be used for the `export * as {{exportAs}} from './'`
+   */
+  exportAs?: string
+  /**
+   * Add an extension to the generated imports and exports, default it will not use an extension
+   */
+  extName?: KubbFile.Extname
+  /**
+   * Define what needs to exported, here you can also disable the export of barrel files
+   * @default `'barrelNamed'`
+   */
+  exportType?: 'barrel' | 'barrelNamed' | false
+  /**
+   * Add a footer text in the beginning of every file
+   */
+  footer?: string
+  /**
+   * Add a banner text in the beginning of every file
+   */
+  banner?: string
+}

package/src/utils/executeStrategies.ts

@@ -1,8 +1,8 @@
 type PromiseFunc<T = unknown, T2 = never> = (state?: T) => T2 extends never ? Promise<T> : Promise<T> | T2
 
-export type ValueOfPromiseFuncArray<TInput extends Array<unknown>> = TInput extends Array<PromiseFunc<infer X, infer Y>> ? X | Y : never
+type ValueOfPromiseFuncArray<TInput extends Array<unknown>> = TInput extends Array<PromiseFunc<infer X, infer Y>> ? X | Y : never
 
-export function noReturn(): void {}
+function noReturn(): void {}
 
 type SeqOutput<TInput extends Array<PromiseFunc<TValue, null>>, TValue> = Promise<Array<Awaited<ValueOfPromiseFuncArray<TInput>>>>
 

package/src/utils/parser.ts

@@ -36,7 +36,7 @@ export function createFile<TMeta extends object = object>(file: KubbFile.File<TM
 /**
  * Helper to create a fileImport with extName set
  */
-export function createFileSource(source: KubbFile.Source): KubbFile.Source {
+function createFileSource(source: KubbFile.Source): KubbFile.Source {
   return source
 }
 
@@ -121,7 +121,7 @@ const typeScriptParser = createFileParser({
       })
       .filter(Boolean)
 
-    return [module.print([...importNodes, ...exportNodes]), source].join('\n')
+    return [file.banner, module.print([...importNodes, ...exportNodes]), source, file.footer].join('\n')
   },
 })
 
@@ -159,7 +159,7 @@ export async function getFileParser<TMeta extends object = object>(extName: Kubb
   return parser || defaultParser
 }
 
-export function trimExtName(text: string): string {
+function trimExtName(text: string): string {
   const extName = text.split('.').pop()
 
   return text.replace(`.${extName}`, '')