@kubb/fabric-core 0.2.0 → 0.2.2

package/README.md

@@ -28,6 +28,7 @@ It offers a lightweight layer for file generation while orchestrating the overal
 > [!WARNING]
 > Fabric is under active development. Until a stable 1.0 release, minor versions may occasionally include breaking changes. Please check release notes and PR titles for breaking changes.
 
+
 # Features
 
 - 🎨 Declarative file generation — Create files effortlessly using JSX or JavaScript syntax.
@@ -37,16 +38,16 @@ It offers a lightweight layer for file generation while orchestrating the overal
 
 ## Write a TypeScript file
 
-Below is a minimal example showing how `createApp` works together with plugins and parsers via `app.use`.
+Below is a minimal example showing how `createFabric` works together with plugins and parsers via `fabric.use`.
 
 ```ts
-import { createApp } from '@kubb/fabric-core'
+import { createFabric } from '@kubb/fabric-core'
 import { fsPlugin } from '@kubb/fabric-core/plugins'
 import { typescriptParser, createParser } from '@kubb/fabric-core/parsers'
 
-const app = createApp()
+const fabric = createFabric()
 
-app.use(fsPlugin, {
+fabric.use(fsPlugin, {
   dryRun: false,
   onBeforeWrite: (path, data) => {
     console.log('About to write:', path)
@@ -54,9 +55,9 @@ app.use(fsPlugin, {
   clean: { path: './generated' },
 })
 
-app.use(typescriptParser)
+fabric.use(typescriptParser)
 
-await app.addFile({
+await fabric.addFile({
   baseName: 'index.ts',
   path: './generated/index.ts',
   sources: [
@@ -64,27 +65,27 @@ await app.addFile({
   ],
 })
 
-await app.write()
+await fabric.write()
 
 ```
 
 # API Reference
 
 ## Core
-### `createApp(options?): App`
-Returns an app instance with:
-- `app.use(pluginOrParser, ...options) => App` — register plugins and parsers.
-- `app.addFile(...files)` — queue in-memory files to generate.
-- `app.files` — getter with all queued files.
-- `app.context` — internal context holding events, options, FileManager, installed plugins/parsers.
+### `createFabric(options?): Fabric`
+Returns a Fabric instance with:
+- `fabric.use(pluginOrParser, ...options) => Fabric` — register plugins and parsers.
+- `fabric.addFile(...files)` — queue in-memory files to generate.
+- `fabric.files` — getter with all queued files.
+- `fabric.context` — internal context holding events, options, FileManager, installed plugins/parsers.
 
-### `defineApp(instance?): () => App`
-Factory to create your own `createApp` with an optional bootstrap `instance(app)` called on creation.
+### `defineFabric(instance?): () => Fabric`
+Factory to create your own `createFabric` with an optional bootstrap `instance(fabric)` called on creation.
 
-### App events (emitted by the core during processing)
+### Events (emitted by the core during processing)
 - `start`
 - `end`
-- `render { app }`
+- `render { fabric }`
 - `file:add { files }`
 - `write:start { files }`
 - `write:end { files }`
@@ -109,7 +110,7 @@ import { fsPlugin } from '@kubb/fabric-core/plugins'
 | onBeforeWrite | `(path: string, data: string \| undefined) => void \| Promise<void>` | — | Called right before each file write on `process:progress`.            |
 | clean | `{ path: string }`                                                   | — | If provided, removes the directory at `path` before writing any files. |
 
-Injected `app.write` options (via `fsPlugin`):
+Injected `fabric.write` options (via `fsPlugin`):
 
 | Option | Type                             | Default | Description |
 |---|----------------------------------|---|---|
@@ -128,7 +129,7 @@ import { barrelPlugin } from '@kubb/fabric-core/plugins'
 | mode | `'all' \| 'named' \| 'propagate' \| false` | — | Controls how exports are generated: all exports, only named exports, propagate (skip barrels), or disabled. |
 | dryRun | `boolean`                                  | `false` | If true, computes barrels but skips writing. |
 
-Injected `app.writeEntry` parameters (via `barrelPlugin`):
+Injected `fabric.writeEntry` parameters (via `barrelPlugin`):
 
 | Param | Type                                       | Description |
 |---|--------------------------------------------|---|
@@ -184,28 +185,28 @@ Injected methods (via `reactPlugin`):
 
 #### `createPlugin`
 
-Factory to declare a plugin that can be registered via `app.use`.
+Factory to declare a plugin that can be registered via `fabric.use`.
 
-| Field | Required | Description                                                                                                               |
-|---|---|---------------------------------------------------------------------------------------------------------------------------|
-| `name` | Yes | String identifier of your plugin.                                                                                         |
-| `install(app, options)` | Yes | Called when the plugin is registered. You can subscribe to core events and perform side effects here.                     |
-| `inject?(app, options)` | No | Return synchronously the runtime methods/properties to merge into `app` (e.g. `write`, `render`). This must not be async. |
+| Field                      | Required | Description                                                                                                                  |
+|----------------------------|---|------------------------------------------------------------------------------------------------------------------------------|
+| `name`                     | Yes | String identifier of your plugin.                                                                                            |
+| `install(fabric, options)` | Yes | Called when the plugin is registered. You can subscribe to core events and perform side effects here.                        |
+| `inject?(fabric, options)` | No | Return synchronously the runtime methods/properties to merge into `fabric` (e.g. `write`, `render`). This must not be async. |
 
 Example:
 
 ```ts
-import { createApp } from '@kubb/fabric-core'
+import { createFabric } from '@kubb/fabric-core'
 import { createPlugin } from '@kubb/fabric-core/plugins'
 
 const helloPlugin = createPlugin<{ name?: string }, { sayHello: (msg?: string) => void }>({
   name: 'helloPlugin',
-  install(app, options) {
-    app.context.events.on('start', () => {
-      console.log('App started')
+  install(fabric, options) {
+    fabric.context.events.on('start', () => {
+      console.log('Fabric started')
     })
   },
-  inject(app, options) {
+  inject(fabric, options) {
     return {
       sayHello(msg = options?.name ?? 'world') {
         console.log(`Hello ${msg}!`)
@@ -214,9 +215,9 @@ const helloPlugin = createPlugin<{ name?: string }, { sayHello: (msg?: string) =
   },
 })
 
-const app = createApp()
-await app.use(helloPlugin, { name: 'Fabric' })
-app.sayHello() // -> Hello Fabric!
+const fabric = createFabric()
+await fabric.use(helloPlugin, { name: 'Fabric' })
+fabric.sayHello() // -> Hello Fabric!
 ```
 
 ## Parsers
@@ -248,7 +249,7 @@ import { tsxParser } from '@kubb/fabric-core/parsers'
 
 #### `defaultParser`
 
-Fallback parser used when no extension mapping is provided to `app.write`.
+Fallback parser used when no extension mapping is provided to `fabric.write`.
 
 ```
 import { defaultParser } @kubb/fabric-core/parsers`
@@ -259,25 +260,25 @@ import { defaultParser } @kubb/fabric-core/parsers`
 | file | `KubbFile.File` | -| File that will be used to be parsed.                                                        |
 
 #### `createParser`
-Factory to declare a parser that can be registered via `app.use` and selected by `extNames` during `app.write`.
+Factory to declare a parser that can be registered via `fabric.use` and selected by `extNames` during `fabirc.write`.
 
-| Field | Required | Description                                                                                                     |
-|---|---|-----------------------------------------------------------------------------------------------------------------|
-| `name` | Yes | String identifier of your parser.                                                                               |
-| `extNames` | Yes | List of file extensions this parser can handle (e.g. ['.ts']). Use `undefined` for the default parser fallback. |
-| `install(app, options)` | No | Optional setup when the parser is registered (subscribe to events, set state, etc.).                            |
+| Field                      | Required | Description                                                                                                     |
+|----------------------------|---|-----------------------------------------------------------------------------------------------------------------|
+| `name`                     | Yes | String identifier of your parser.                                                                               |
+| `extNames`                 | Yes | List of file extensions this parser can handle (e.g. ['.ts']). Use `undefined` for the default parser fallback. |
+| `install(fabric, options)` | No | Optional setup when the parser is registered (subscribe to events, set state, etc.).                            |
 | `parse(file, { extname })` | Yes | Must return the final string that will be written for the given file.                                           |
 
 Example:
 
 ```ts
-import { createApp } from '@kubb/fabric-core'
+import { createFabric } from '@kubb/fabric-core'
 import { createParser } from '@kubb/fabric-core/parsers'
 
 const vueParser = createParser<{ banner?: string }>({
   name: 'vueParser',
   extNames: ['.vue'],
-  async install(app, options) {
+  async install(fabric, options) {
     // Optional setup
   },
   async parse(file, { extname }) {
@@ -287,43 +288,13 @@ const vueParser = createParser<{ banner?: string }>({
   },
 })
 
-const app = createApp()
-app.use(vueParser)
-app.use(fsPlugin); // make it possible to write to the filesystem
+const fabric = createFabric()
+fabric.use(vueParser)
+fabric.use(fsPlugin); // make it possible to write to the filesystem
 
-app.write({ extension: { '.vue': '.ts' } })
+fabric.write({ extension: { '.vue': '.ts' } })
 ```
 
 > [!NOTE]
-> - `app.use` accepts both plugins and parsers. The `fsPlugin` handles I/O and adds `app.write`. Parsers decide how files are converted to strings for specific extensions.
-> - When extension mapping is provided to `app.write`, Fabric picks a parser whose `extNames` include the file’s extension. Otherwise, the default parser is used.
-
-## Supporting Kubb
-
-Kubb uses an MIT-licensed open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
-
-- [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
-
-<p align="center">
-  <a href="https://github.com/sponsors/stijnvanhulle">
-    <img src="https://raw.githubusercontent.com/stijnvanhulle/sponsors/main/sponsors.svg" alt="My sponsors" />
-  </a>
-</p>
-
-
-<!-- Badges -->
-
-[npm-version-src]: https://img.shields.io/npm/v/@kubb/fabric-core?flat&colorA=18181B&colorB=f58517
-[npm-version-href]: https://npmjs.com/package/@kubb/fabric-core
-[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/fabric-core?flat&colorA=18181B&colorB=f58517
-[npm-downloads-href]: https://npmjs.com/package/@kubb/fabric-core
-[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
-[license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
-[build-src]: https://img.shields.io/github/actions/workflow/status/kubb-labs/kubb/ci.yaml?style=flat&colorA=18181B&colorB=f58517
-[build-href]: https://www.npmjs.com/package/@kubb/fabric-core
-[minified-src]: https://img.shields.io/bundlephobia/min/@kubb/fabric-core?style=flat&colorA=18181B&colorB=f58517
-[minified-href]: https://www.npmjs.com/package/@kubb/fabric-core
-[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
-[coverage-href]: https://www.npmjs.com/package/@kubb/fabric-core
-[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
-[sponsors-href]: https://github.com/sponsors/stijnvanhulle/
+> - `fabric.use` accepts both plugins and parsers. The `fsPlugin` handles I/O and adds `fabric.write`. Parsers decide how files are converted to strings for specific extensions.
+> - When extension mapping is provided to `fabric.write`, Fabric picks a parser whose `extNames` include the file’s extension. Otherwise, the default parser is used.

package/dist/{App-ztRQpZS9.d.ts → Fabric-CCPgegwe.d.cts}

@@ -77,7 +77,7 @@ type BaseName = `${string}.${string}`;
 type Path = string;
 type AdvancedPath<T extends BaseName = BaseName> = `${BasePath}${T}`;
 type OptionalPath = Path | undefined | null;
-type File<TMeta$1 extends object = object> = {
+type File<TMeta extends object = object> = {
   /**
    * Name to be used to create the path
    * Based on UNIX basename, `${name}.extname`
@@ -94,13 +94,13 @@ type File<TMeta$1 extends object = object> = {
   /**
    * Use extra meta, this is getting used to generate the barrel/index files.
    */
-  meta?: TMeta$1;
+  meta?: TMeta;
   banner?: string;
   footer?: string;
 };
 type ResolvedImport = Import;
 type ResolvedExport = Export;
-type ResolvedFile<TMeta$1 extends object = object> = File<TMeta$1> & {
+type ResolvedFile<TMeta extends object = object> = File<TMeta> & {
   /**
    * @default hash
    */
@@ -116,7 +116,7 @@ type ResolvedFile<TMeta$1 extends object = object> = File<TMeta$1> & {
 };
 //#endregion
 //#region src/plugins/types.d.ts
-type Plugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = {
+type Plugin<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = {
   name: string;
   type: 'plugin';
   install: Install<TOptions>;
@@ -125,15 +125,15 @@ type Plugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}
    * Merged into the app instance after install.
    * This cannot be async
    */
-  inject?: Inject<TOptions, TAppExtension$1>;
+  inject?: Inject<TOptions, TAppExtension>;
 };
-type UserPlugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = Omit<Plugin<TOptions, TAppExtension$1>, 'type'>;
+type UserPlugin<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = Omit<Plugin<TOptions, TAppExtension>, 'type'>;
 //#endregion
 //#region src/parsers/types.d.ts
 type PrintOptions = {
   extname?: Extname;
 };
-type Parser<TOptions = unknown, TMeta$1 extends object = any> = {
+type Parser<TOptions = unknown, TMeta extends object = any> = {
   name: string;
   type: 'parser';
   /**
@@ -144,9 +144,9 @@ type Parser<TOptions = unknown, TMeta$1 extends object = any> = {
   /**
    * Convert a file to string
    */
-  parse(file: ResolvedFile<TMeta$1>, options: PrintOptions): Promise<string>;
+  parse(file: ResolvedFile<TMeta>, options: PrintOptions): Promise<string>;
 };
-type UserParser<TOptions = unknown, TMeta$1 extends object = any> = Omit<Parser<TOptions, TMeta$1>, 'type'>;
+type UserParser<TOptions = unknown, TMeta extends object = any> = Omit<Parser<TOptions, TMeta>, 'type'>;
 //#endregion
 //#region src/utils/AsyncEventEmitter.d.ts
 declare class AsyncEventEmitter<TEvents extends Record<string, any>> {
@@ -167,18 +167,18 @@ type ProcessFilesProps = {
   /**
    * @default 'sequential'
    */
-  mode?: AppMode;
+  mode?: FabricMode;
 };
 type GetParseOptions = {
   parsers?: Set<Parser>;
   extension?: Record<Extname, Extname | ''>;
 };
 type Options$1 = {
-  events?: AsyncEventEmitter<AppEvents>;
+  events?: AsyncEventEmitter<FabricEvents>;
 };
 declare class FileProcessor {
   #private;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   constructor({
     events
   }?: Options$1);
@@ -196,11 +196,11 @@ declare class FileProcessor {
 //#endregion
 //#region src/FileManager.d.ts
 type Options = {
-  events?: AsyncEventEmitter<AppEvents>;
+  events?: AsyncEventEmitter<FabricEvents>;
 };
 declare class FileManager {
   #private;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   processor: FileProcessor;
   constructor({
     events
@@ -214,19 +214,19 @@ declare class FileManager {
   write(options: ProcessFilesProps): Promise<ResolvedFile[]>;
 }
 //#endregion
-//#region src/App.d.ts
+//#region src/Fabric.d.ts
 declare global {
   namespace Kubb {
-    interface App {}
+    interface Fabric {}
   }
 }
-type AppOptions = {
+type FabricOptions = {
   /**
    * @default 'sequential'
    */
-  mode?: AppMode;
+  mode?: FabricMode;
 };
-type AppEvents = {
+type FabricEvents = {
   /**
    * Called in the beginning of the app lifecycle.
    */
@@ -239,7 +239,7 @@ type AppEvents = {
    * Called when being rendered
    */
   render: [{
-    app: App;
+    fabric: Fabric;
   }];
   /**
    * Called once before processing any files.
@@ -293,23 +293,23 @@ type AppEvents = {
     files: ResolvedFile[];
   }];
 };
-type AppContext<TOptions extends AppOptions> = {
+type FabricContext<TOptions extends FabricOptions> = {
   options?: TOptions;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   fileManager: FileManager;
   installedPlugins: Set<Plugin>;
   installedParsers: Set<Parser>;
 };
-type AppMode = 'sequential' | 'parallel';
+type FabricMode = 'sequential' | 'parallel';
 type AllOptional<T> = {} extends T ? true : false;
-type Install<TOptions = unknown> = TOptions extends any[] ? (app: App, ...options: TOptions) => void | Promise<void> : AllOptional<TOptions> extends true ? (app: App, options: TOptions | undefined) => void | Promise<void> : (app: App, options: TOptions) => void | Promise<void>;
-type Inject<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = TOptions extends any[] ? (app: App, ...options: TOptions) => Partial<TAppExtension$1> : AllOptional<TOptions> extends true ? (app: App, options: TOptions | undefined) => Partial<TAppExtension$1> : (app: App, options: TOptions) => Partial<TAppExtension$1>;
-interface App<TOptions extends AppOptions = AppOptions> extends Kubb.App {
-  context: AppContext<TOptions>;
+type Install<TOptions = unknown> = TOptions extends any[] ? (app: Fabric, ...options: TOptions) => void | Promise<void> : AllOptional<TOptions> extends true ? (app: Fabric, options: TOptions | undefined) => void | Promise<void> : (app: Fabric, options: TOptions) => void | Promise<void>;
+type Inject<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = TOptions extends any[] ? (app: Fabric, ...options: TOptions) => Partial<TAppExtension> : AllOptional<TOptions> extends true ? (app: Fabric, options: TOptions | undefined) => Partial<TAppExtension> : (app: Fabric, options: TOptions) => Partial<TAppExtension>;
+interface Fabric<TOptions extends FabricOptions = FabricOptions> extends Kubb.Fabric {
+  context: FabricContext<TOptions>;
   files: Array<ResolvedFile>;
   use<TPluginOptions = unknown, TMeta extends object = object, TAppExtension extends Record<string, any> = {}>(pluginOrParser: Plugin<TPluginOptions, TAppExtension> | Parser<TPluginOptions, TMeta>, ...options: TPluginOptions extends any[] ? NoInfer<TPluginOptions> : AllOptional<TPluginOptions> extends true ? [NoInfer<TPluginOptions>?] : [NoInfer<TPluginOptions>]): (this & TAppExtension) | Promise<this & TAppExtension>;
   addFile(...files: Array<File>): Promise<void>;
 }
 //#endregion
-export { FileProcessor as a, Plugin as c, File as d, KubbFile_d_exports as f, FileManager as i, UserPlugin as l, AppContext as n, Parser as o, ResolvedFile as p, AppOptions as r, UserParser as s, App as t, Extname as u };
-//# sourceMappingURL=App-ztRQpZS9.d.ts.map
+export { FileManager as a, UserParser as c, Extname as d, File as f, FabricOptions as i, Plugin as l, ResolvedFile as m, FabricContext as n, FileProcessor as o, KubbFile_d_exports as p, FabricMode as r, Parser as s, Fabric as t, UserPlugin as u };
+//# sourceMappingURL=Fabric-CCPgegwe.d.cts.map

package/dist/{App-Cjd-lGfW.d.cts → Fabric-Cu_YHe4S.d.ts}

@@ -77,7 +77,7 @@ type BaseName = `${string}.${string}`;
 type Path = string;
 type AdvancedPath<T extends BaseName = BaseName> = `${BasePath}${T}`;
 type OptionalPath = Path | undefined | null;
-type File<TMeta$1 extends object = object> = {
+type File<TMeta extends object = object> = {
   /**
    * Name to be used to create the path
    * Based on UNIX basename, `${name}.extname`
@@ -94,13 +94,13 @@ type File<TMeta$1 extends object = object> = {
   /**
    * Use extra meta, this is getting used to generate the barrel/index files.
    */
-  meta?: TMeta$1;
+  meta?: TMeta;
   banner?: string;
   footer?: string;
 };
 type ResolvedImport = Import;
 type ResolvedExport = Export;
-type ResolvedFile<TMeta$1 extends object = object> = File<TMeta$1> & {
+type ResolvedFile<TMeta extends object = object> = File<TMeta> & {
   /**
    * @default hash
    */
@@ -116,7 +116,7 @@ type ResolvedFile<TMeta$1 extends object = object> = File<TMeta$1> & {
 };
 //#endregion
 //#region src/plugins/types.d.ts
-type Plugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = {
+type Plugin<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = {
   name: string;
   type: 'plugin';
   install: Install<TOptions>;
@@ -125,15 +125,15 @@ type Plugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}
    * Merged into the app instance after install.
    * This cannot be async
    */
-  inject?: Inject<TOptions, TAppExtension$1>;
+  inject?: Inject<TOptions, TAppExtension>;
 };
-type UserPlugin<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = Omit<Plugin<TOptions, TAppExtension$1>, 'type'>;
+type UserPlugin<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = Omit<Plugin<TOptions, TAppExtension>, 'type'>;
 //#endregion
 //#region src/parsers/types.d.ts
 type PrintOptions = {
   extname?: Extname;
 };
-type Parser<TOptions = unknown, TMeta$1 extends object = any> = {
+type Parser<TOptions = unknown, TMeta extends object = any> = {
   name: string;
   type: 'parser';
   /**
@@ -144,9 +144,9 @@ type Parser<TOptions = unknown, TMeta$1 extends object = any> = {
   /**
    * Convert a file to string
    */
-  parse(file: ResolvedFile<TMeta$1>, options: PrintOptions): Promise<string>;
+  parse(file: ResolvedFile<TMeta>, options: PrintOptions): Promise<string>;
 };
-type UserParser<TOptions = unknown, TMeta$1 extends object = any> = Omit<Parser<TOptions, TMeta$1>, 'type'>;
+type UserParser<TOptions = unknown, TMeta extends object = any> = Omit<Parser<TOptions, TMeta>, 'type'>;
 //#endregion
 //#region src/utils/AsyncEventEmitter.d.ts
 declare class AsyncEventEmitter<TEvents extends Record<string, any>> {
@@ -167,18 +167,18 @@ type ProcessFilesProps = {
   /**
    * @default 'sequential'
    */
-  mode?: AppMode;
+  mode?: FabricMode;
 };
 type GetParseOptions = {
   parsers?: Set<Parser>;
   extension?: Record<Extname, Extname | ''>;
 };
 type Options$1 = {
-  events?: AsyncEventEmitter<AppEvents>;
+  events?: AsyncEventEmitter<FabricEvents>;
 };
 declare class FileProcessor {
   #private;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   constructor({
     events
   }?: Options$1);
@@ -196,11 +196,11 @@ declare class FileProcessor {
 //#endregion
 //#region src/FileManager.d.ts
 type Options = {
-  events?: AsyncEventEmitter<AppEvents>;
+  events?: AsyncEventEmitter<FabricEvents>;
 };
 declare class FileManager {
   #private;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   processor: FileProcessor;
   constructor({
     events
@@ -214,19 +214,19 @@ declare class FileManager {
   write(options: ProcessFilesProps): Promise<ResolvedFile[]>;
 }
 //#endregion
-//#region src/App.d.ts
+//#region src/Fabric.d.ts
 declare global {
   namespace Kubb {
-    interface App {}
+    interface Fabric {}
   }
 }
-type AppOptions = {
+type FabricOptions = {
   /**
    * @default 'sequential'
    */
-  mode?: AppMode;
+  mode?: FabricMode;
 };
-type AppEvents = {
+type FabricEvents = {
   /**
    * Called in the beginning of the app lifecycle.
    */
@@ -239,7 +239,7 @@ type AppEvents = {
    * Called when being rendered
    */
   render: [{
-    app: App;
+    fabric: Fabric;
   }];
   /**
    * Called once before processing any files.
@@ -293,23 +293,23 @@ type AppEvents = {
     files: ResolvedFile[];
   }];
 };
-type AppContext<TOptions extends AppOptions> = {
+type FabricContext<TOptions extends FabricOptions> = {
   options?: TOptions;
-  events: AsyncEventEmitter<AppEvents>;
+  events: AsyncEventEmitter<FabricEvents>;
   fileManager: FileManager;
   installedPlugins: Set<Plugin>;
   installedParsers: Set<Parser>;
 };
-type AppMode = 'sequential' | 'parallel';
+type FabricMode = 'sequential' | 'parallel';
 type AllOptional<T> = {} extends T ? true : false;
-type Install<TOptions = unknown> = TOptions extends any[] ? (app: App, ...options: TOptions) => void | Promise<void> : AllOptional<TOptions> extends true ? (app: App, options: TOptions | undefined) => void | Promise<void> : (app: App, options: TOptions) => void | Promise<void>;
-type Inject<TOptions = unknown, TAppExtension$1 extends Record<string, any> = {}> = TOptions extends any[] ? (app: App, ...options: TOptions) => Partial<TAppExtension$1> : AllOptional<TOptions> extends true ? (app: App, options: TOptions | undefined) => Partial<TAppExtension$1> : (app: App, options: TOptions) => Partial<TAppExtension$1>;
-interface App<TOptions extends AppOptions = AppOptions> extends Kubb.App {
-  context: AppContext<TOptions>;
+type Install<TOptions = unknown> = TOptions extends any[] ? (app: Fabric, ...options: TOptions) => void | Promise<void> : AllOptional<TOptions> extends true ? (app: Fabric, options: TOptions | undefined) => void | Promise<void> : (app: Fabric, options: TOptions) => void | Promise<void>;
+type Inject<TOptions = unknown, TAppExtension extends Record<string, any> = {}> = TOptions extends any[] ? (app: Fabric, ...options: TOptions) => Partial<TAppExtension> : AllOptional<TOptions> extends true ? (app: Fabric, options: TOptions | undefined) => Partial<TAppExtension> : (app: Fabric, options: TOptions) => Partial<TAppExtension>;
+interface Fabric<TOptions extends FabricOptions = FabricOptions> extends Kubb.Fabric {
+  context: FabricContext<TOptions>;
   files: Array<ResolvedFile>;
   use<TPluginOptions = unknown, TMeta extends object = object, TAppExtension extends Record<string, any> = {}>(pluginOrParser: Plugin<TPluginOptions, TAppExtension> | Parser<TPluginOptions, TMeta>, ...options: TPluginOptions extends any[] ? NoInfer<TPluginOptions> : AllOptional<TPluginOptions> extends true ? [NoInfer<TPluginOptions>?] : [NoInfer<TPluginOptions>]): (this & TAppExtension) | Promise<this & TAppExtension>;
   addFile(...files: Array<File>): Promise<void>;
 }
 //#endregion
-export { FileProcessor as a, Plugin as c, File as d, KubbFile_d_exports as f, FileManager as i, UserPlugin as l, AppContext as n, Parser as o, ResolvedFile as p, AppOptions as r, UserParser as s, App as t, Extname as u };
-//# sourceMappingURL=App-Cjd-lGfW.d.cts.map
+export { FileManager as a, UserParser as c, Extname as d, File as f, FabricOptions as i, Plugin as l, ResolvedFile as m, FabricContext as n, FileProcessor as o, KubbFile_d_exports as p, FabricMode as r, Parser as s, Fabric as t, UserPlugin as u };
+//# sourceMappingURL=Fabric-Cu_YHe4S.d.ts.map

package/dist/index-BUculP1D.d.cts

@@ -0,0 +1,18 @@
+import { f as File, i as FabricOptions, m as ResolvedFile, t as Fabric } from "./Fabric-CCPgegwe.cjs";
+
+//#region src/defineFabric.d.ts
+type RootRenderFunction<TOptions extends FabricOptions> = (fabric: Fabric<TOptions>) => void | Promise<void>;
+type DefineFabric<TOptions> = (options?: TOptions) => Fabric;
+declare function defineFabric<TOptions extends FabricOptions>(instance?: RootRenderFunction<TOptions>): DefineFabric<TOptions>;
+//#endregion
+//#region src/createFabric.d.ts
+declare const createFabric: DefineFabric<FabricOptions>;
+//#endregion
+//#region src/createFile.d.ts
+/**
+ * Helper to create a file with name and id set
+ */
+declare function createFile<TMeta extends object = object>(file: File<TMeta>): ResolvedFile<TMeta>;
+//#endregion
+export { defineFabric as i, createFabric as n, DefineFabric as r, createFile as t };
+//# sourceMappingURL=index-BUculP1D.d.cts.map

package/dist/index-CvkyZHXK.d.ts

@@ -0,0 +1,18 @@
+import { f as File, i as FabricOptions, m as ResolvedFile, t as Fabric } from "./Fabric-Cu_YHe4S.js";
+
+//#region src/defineFabric.d.ts
+type RootRenderFunction<TOptions extends FabricOptions> = (fabric: Fabric<TOptions>) => void | Promise<void>;
+type DefineFabric<TOptions> = (options?: TOptions) => Fabric;
+declare function defineFabric<TOptions extends FabricOptions>(instance?: RootRenderFunction<TOptions>): DefineFabric<TOptions>;
+//#endregion
+//#region src/createFabric.d.ts
+declare const createFabric: DefineFabric<FabricOptions>;
+//#endregion
+//#region src/createFile.d.ts
+/**
+ * Helper to create a file with name and id set
+ */
+declare function createFile<TMeta extends object = object>(file: File<TMeta>): ResolvedFile<TMeta>;
+//#endregion
+export { defineFabric as i, createFabric as n, DefineFabric as r, createFile as t };
+//# sourceMappingURL=index-CvkyZHXK.d.ts.map