@kubb/react-fabric 0.4.1 → 0.5.0

package/README.md

@@ -139,16 +139,20 @@ Injected `fabric.writeEntry` parameters (via `barrelPlugin`):
 | root | `string`                                   | Root directory where the entry `index.ts` should be created. |
 | mode | `'all' \| 'named' \| 'propagate' \| false` | Controls which export style to use for the entry barrel. |
 
-#### `progressPlugin`
-Shows a CLI progress bar by listening to core events.
+#### `loggerPlugin`
+Streams Fabric lifecycle activity as colourful consola logs, optional progress bars, and websocket messages that you can consume from custom tooling.
 
 ```
-import { progressPlugin } from '@kubb/fabric-core/plugins'
+import { loggerPlugin } from '@kubb/fabric-core/plugins'
 ```
 
-| Option | Type | Default | Description                                                                             |
-|---|---|---|-----------------------------------------------------------------------------------------|
-| — | — | — | This plugin has no options, it displays a CLI progress bar by listening to core events. |
+| Option | Type | Default | Description |
+|---|---|---|---|
+| level | `import('consola').LogLevel` | — | Optional explicit log level passed to `createConsola`. |
+| progress | `boolean` | `true` | Enable/disable the integrated CLI progress bar. |
+| websocket | `boolean \| { host?: string; port?: number }` | `true` | Toggle or configure the websocket server that broadcasts Fabric events for future GUIs. |
+
+By default the plugin displays a progress bar, starts a websocket server on an ephemeral port, and announces the URL. Every key lifecycle hook (`start`, `process:*`, `file:*`, `write:*`, `end`) is logged with a `Fabric` tag, animated in the progress bar, and broadcast to connected clients—perfect for building dashboards on top of Fabric.
 
 
 #### `graphPlugin`

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { a as FabricOptions, b as Source, c as FileManager, f as BaseName, g as Import, h as File$1, i as FabricMode, l as FileProcessor, n as FabricConfig, p as Export, t as Fabric, v as Path, y as ResolvedFile } from "./Fabric-DECM64S6.cjs";
 import { a as JSDoc, d as KubbNode, g as FunctionParams, o as Key, y as createFunctionParams } from "./types-C2T-S5lY.cjs";
 import { t as Options$1 } from "./reactPlugin-DkhxnXP_.cjs";
-import * as react6 from "react";
+import * as react0 from "react";
 import React, { ReactNode } from "react";
 
 //#region ../fabric-core/src/defineFabric.d.ts
@@ -50,9 +50,9 @@ type Props$4<TMeta = unknown> = {
 declare function App<TMeta = unknown>({
   meta,
   children
-}: Props$4<TMeta>): react6.JSX.Element;
+}: Props$4<TMeta>): react0.JSX.Element;
 declare namespace App {
-  var Context: react6.Context<AppContextProps<unknown> | undefined>;
+  var Context: react0.Context<AppContextProps<unknown> | undefined>;
   var displayName: string;
 }
 //#endregion
@@ -88,7 +88,7 @@ declare function Const({
   JSDoc,
   asConst,
   children
-}: Props$3): react6.JSX.Element;
+}: Props$3): react0.JSX.Element;
 declare namespace Const {
   var displayName: string;
 }
@@ -137,13 +137,13 @@ type Props$2<TMeta> = BaseProps & {
 declare function File<TMeta extends object = object>({
   children,
   ...rest
-}: Props$2<TMeta>): react6.JSX.Element;
+}: Props$2<TMeta>): react0.JSX.Element;
 declare namespace File {
   var displayName: string;
   var Export: typeof FileExport;
   var Import: typeof FileImport;
   var Source: typeof FileSource;
-  var Context: react6.Context<FileContextProps<object>>;
+  var Context: react0.Context<FileContextProps<object>>;
 }
 type FileSourceProps = Omit<Source, 'value'> & {
   key?: Key;
@@ -155,7 +155,7 @@ declare function FileSource({
   isExportable,
   isIndexable,
   children
-}: FileSourceProps): react6.JSX.Element;
+}: FileSourceProps): react0.JSX.Element;
 declare namespace FileSource {
   var displayName: string;
 }
@@ -167,7 +167,7 @@ declare function FileExport({
   path,
   isTypeOnly,
   asAlias
-}: FileExportProps): react6.JSX.Element;
+}: FileExportProps): react0.JSX.Element;
 declare namespace FileExport {
   var displayName: string;
 }
@@ -180,7 +180,7 @@ declare function FileImport({
   path,
   isTypeOnly,
   isNameSpace
-}: FileImportProps): react6.JSX.Element;
+}: FileImportProps): react0.JSX.Element;
 declare namespace FileImport {
   var displayName: string;
 }
@@ -233,7 +233,7 @@ declare function Function({
   returnType,
   JSDoc,
   children
-}: Props$1): react6.JSX.Element;
+}: Props$1): react0.JSX.Element;
 declare namespace Function {
   var displayName: string;
   var Arrow: typeof ArrowFunction;
@@ -255,7 +255,7 @@ declare function ArrowFunction({
   JSDoc,
   singleLine,
   children
-}: ArrowFunctionProps): react6.JSX.Element;
+}: ArrowFunctionProps): react0.JSX.Element;
 declare namespace ArrowFunction {
   var displayName: string;
 }
@@ -296,7 +296,7 @@ declare function Type({
   export: canExport,
   JSDoc,
   children
-}: Props): react6.JSX.Element;
+}: Props): react0.JSX.Element;
 declare namespace Type {
   var displayName: string;
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { a as FabricOptions, b as Source, c as FileManager, f as BaseName, g as Import, h as File$1, i as FabricMode, l as FileProcessor, n as FabricConfig, p as Export, t as Fabric, v as Path, y as ResolvedFile } from "./Fabric-DGhsnD3H.js";
 import { a as JSDoc, d as KubbNode, g as FunctionParams, o as Key, y as createFunctionParams } from "./types-rKVyNQC0.js";
 import { t as Options$1 } from "./reactPlugin-DAOLEVg9.js";
-import * as react0 from "react";
+import * as react1 from "react";
 import React, { ReactNode } from "react";
 
 //#region ../fabric-core/src/defineFabric.d.ts
@@ -50,9 +50,9 @@ type Props$4<TMeta = unknown> = {
 declare function App<TMeta = unknown>({
   meta,
   children
-}: Props$4<TMeta>): react0.JSX.Element;
+}: Props$4<TMeta>): react1.JSX.Element;
 declare namespace App {
-  var Context: react0.Context<AppContextProps<unknown> | undefined>;
+  var Context: react1.Context<AppContextProps<unknown> | undefined>;
   var displayName: string;
 }
 //#endregion
@@ -88,7 +88,7 @@ declare function Const({
   JSDoc,
   asConst,
   children
-}: Props$3): react0.JSX.Element;
+}: Props$3): react1.JSX.Element;
 declare namespace Const {
   var displayName: string;
 }
@@ -137,13 +137,13 @@ type Props$2<TMeta> = BaseProps & {
 declare function File<TMeta extends object = object>({
   children,
   ...rest
-}: Props$2<TMeta>): react0.JSX.Element;
+}: Props$2<TMeta>): react1.JSX.Element;
 declare namespace File {
   var displayName: string;
   var Export: typeof FileExport;
   var Import: typeof FileImport;
   var Source: typeof FileSource;
-  var Context: react0.Context<FileContextProps<object>>;
+  var Context: react1.Context<FileContextProps<object>>;
 }
 type FileSourceProps = Omit<Source, 'value'> & {
   key?: Key;
@@ -155,7 +155,7 @@ declare function FileSource({
   isExportable,
   isIndexable,
   children
-}: FileSourceProps): react0.JSX.Element;
+}: FileSourceProps): react1.JSX.Element;
 declare namespace FileSource {
   var displayName: string;
 }
@@ -167,7 +167,7 @@ declare function FileExport({
   path,
   isTypeOnly,
   asAlias
-}: FileExportProps): react0.JSX.Element;
+}: FileExportProps): react1.JSX.Element;
 declare namespace FileExport {
   var displayName: string;
 }
@@ -180,7 +180,7 @@ declare function FileImport({
   path,
   isTypeOnly,
   isNameSpace
-}: FileImportProps): react0.JSX.Element;
+}: FileImportProps): react1.JSX.Element;
 declare namespace FileImport {
   var displayName: string;
 }
@@ -233,7 +233,7 @@ declare function Function({
   returnType,
   JSDoc,
   children
-}: Props$1): react0.JSX.Element;
+}: Props$1): react1.JSX.Element;
 declare namespace Function {
   var displayName: string;
   var Arrow: typeof ArrowFunction;
@@ -255,7 +255,7 @@ declare function ArrowFunction({
   JSDoc,
   singleLine,
   children
-}: ArrowFunctionProps): react0.JSX.Element;
+}: ArrowFunctionProps): react1.JSX.Element;
 declare namespace ArrowFunction {
   var displayName: string;
 }
@@ -296,7 +296,7 @@ declare function Type({
   export: canExport,
   JSDoc,
   children
-}: Props): react0.JSX.Element;
+}: Props): react1.JSX.Element;
 declare namespace Type {
   var displayName: string;
 }

package/dist/plugins.d.cts

@@ -1,9 +1,10 @@
 import { m as Extname, o as Plugin, s as UserPlugin } from "./Fabric-DECM64S6.cjs";
 import { n as reactPlugin } from "./reactPlugin-DkhxnXP_.cjs";
+import { LogLevel } from "consola";
 
 //#region ../fabric-core/src/plugins/barrelPlugin.d.ts
 type Mode = 'all' | 'named' | 'propagate' | false;
-type Options$2 = {
+type Options$3 = {
   root: string;
   mode: Mode;
   dryRun?: boolean;
@@ -28,16 +29,16 @@ declare global {
     }
   }
 }
-declare const barrelPlugin: Plugin<Options$2, ExtendOptions$1>;
+declare const barrelPlugin: Plugin<Options$3, ExtendOptions$1>;
 //#endregion
 //#region ../fabric-core/src/plugins/createPlugin.d.ts
-declare function createPlugin<Options$3 = unknown, TAppExtension extends Record<string, any> = {}>(plugin: UserPlugin<Options$3, TAppExtension>): Plugin<Options$3, TAppExtension>;
+declare function createPlugin<Options$4 = unknown, TAppExtension extends Record<string, any> = {}>(plugin: UserPlugin<Options$4, TAppExtension>): Plugin<Options$4, TAppExtension>;
 //#endregion
 //#region ../fabric-core/src/plugins/fsPlugin.d.ts
 type WriteOptions = {
   extension?: Record<Extname, Extname | ''>;
 };
-type Options$1 = {
+type Options$2 = {
   dryRun?: boolean;
   /**
    * Optional callback that is invoked whenever a file is written by the plugin.
@@ -58,20 +59,51 @@ declare global {
     }
   }
 }
-declare const fsPlugin: Plugin<Options$1, ExtendOptions>;
+declare const fsPlugin: Plugin<Options$2, ExtendOptions>;
 //#endregion
 //#region ../fabric-core/src/plugins/graphPlugin.d.ts
-type Options = {
+type Options$1 = {
   root: string;
   /**
    * @default false
    */
   open?: boolean;
 };
-declare const graphPlugin: Plugin<Options, {}>;
+declare const graphPlugin: Plugin<Options$1, {}>;
 //#endregion
-//#region ../fabric-core/src/plugins/progressPlugin.d.ts
-declare const progressPlugin: Plugin<[], {}>;
+//#region ../fabric-core/src/plugins/loggerPlugin.d.ts
+type WebSocketOptions = {
+  /**
+   * Hostname to bind the websocket server to.
+   * @default '127.0.0.1'
+   */
+  host?: string;
+  /**
+   * Port to bind the websocket server to.
+   * @default 0 (random available port)
+   */
+  port?: number;
+};
+type Options = {
+  /**
+   * Explicit consola log level.
+   */
+  level?: LogLevel;
+  /**
+   * Toggle progress bar output.
+   * @default true
+   */
+  progress?: boolean;
+  /**
+   * Toggle or configure the websocket broadcast server.
+   * When `true`, a websocket server is started on an ephemeral port.
+   * When `false`, websocket support is disabled.
+   * When providing an object, the server uses the supplied host and port.
+   * @default true
+   */
+  websocket?: boolean | WebSocketOptions;
+};
+declare const loggerPlugin: Plugin<Options, {}>;
 //#endregion
-export { barrelPlugin, createPlugin, fsPlugin, graphPlugin, progressPlugin, reactPlugin };
+export { barrelPlugin, createPlugin, fsPlugin, graphPlugin, loggerPlugin, reactPlugin };
 //# sourceMappingURL=plugins.d.cts.map

package/dist/plugins.d.ts

@@ -1,9 +1,10 @@
 import { m as Extname, o as Plugin, s as UserPlugin } from "./Fabric-DGhsnD3H.js";
 import { n as reactPlugin } from "./reactPlugin-DAOLEVg9.js";
+import { LogLevel } from "consola";
 
 //#region ../fabric-core/src/plugins/barrelPlugin.d.ts
 type Mode = 'all' | 'named' | 'propagate' | false;
-type Options$2 = {
+type Options$3 = {
   root: string;
   mode: Mode;
   dryRun?: boolean;
@@ -28,16 +29,16 @@ declare global {
     }
   }
 }
-declare const barrelPlugin: Plugin<Options$2, ExtendOptions$1>;
+declare const barrelPlugin: Plugin<Options$3, ExtendOptions$1>;
 //#endregion
 //#region ../fabric-core/src/plugins/createPlugin.d.ts
-declare function createPlugin<Options$3 = unknown, TAppExtension extends Record<string, any> = {}>(plugin: UserPlugin<Options$3, TAppExtension>): Plugin<Options$3, TAppExtension>;
+declare function createPlugin<Options$4 = unknown, TAppExtension extends Record<string, any> = {}>(plugin: UserPlugin<Options$4, TAppExtension>): Plugin<Options$4, TAppExtension>;
 //#endregion
 //#region ../fabric-core/src/plugins/fsPlugin.d.ts
 type WriteOptions = {
   extension?: Record<Extname, Extname | ''>;
 };
-type Options$1 = {
+type Options$2 = {
   dryRun?: boolean;
   /**
    * Optional callback that is invoked whenever a file is written by the plugin.
@@ -58,20 +59,51 @@ declare global {
     }
   }
 }
-declare const fsPlugin: Plugin<Options$1, ExtendOptions>;
+declare const fsPlugin: Plugin<Options$2, ExtendOptions>;
 //#endregion
 //#region ../fabric-core/src/plugins/graphPlugin.d.ts
-type Options = {
+type Options$1 = {
   root: string;
   /**
    * @default false
    */
   open?: boolean;
 };
-declare const graphPlugin: Plugin<Options, {}>;
+declare const graphPlugin: Plugin<Options$1, {}>;
 //#endregion
-//#region ../fabric-core/src/plugins/progressPlugin.d.ts
-declare const progressPlugin: Plugin<[], {}>;
+//#region ../fabric-core/src/plugins/loggerPlugin.d.ts
+type WebSocketOptions = {
+  /**
+   * Hostname to bind the websocket server to.
+   * @default '127.0.0.1'
+   */
+  host?: string;
+  /**
+   * Port to bind the websocket server to.
+   * @default 0 (random available port)
+   */
+  port?: number;
+};
+type Options = {
+  /**
+   * Explicit consola log level.
+   */
+  level?: LogLevel;
+  /**
+   * Toggle progress bar output.
+   * @default true
+   */
+  progress?: boolean;
+  /**
+   * Toggle or configure the websocket broadcast server.
+   * When `true`, a websocket server is started on an ephemeral port.
+   * When `false`, websocket support is disabled.
+   * When providing an object, the server uses the supplied host and port.
+   * @default true
+   */
+  websocket?: boolean | WebSocketOptions;
+};
+declare const loggerPlugin: Plugin<Options, {}>;
 //#endregion
-export { barrelPlugin, createPlugin, fsPlugin, graphPlugin, progressPlugin, reactPlugin };
+export { barrelPlugin, createPlugin, fsPlugin, graphPlugin, loggerPlugin, reactPlugin };
 //# sourceMappingURL=plugins.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/react-fabric",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "React integration for Kubb, providing JSX runtime support and React component generation capabilities for code generation plugins.",
   "keywords": [
     "react",
@@ -111,7 +111,7 @@
     "react-devtools-core": "6.1.2",
     "signal-exit": "^4.1.0",
     "ws": "8.18.0",
-    "@kubb/fabric-core": "0.4.1"
+    "@kubb/fabric-core": "0.5.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.6",