@kubb/fabric-core 0.0.0-canary-20260111130736 → 0.0.0-canary-20260113205926

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils/createJSDoc.ts","../src/utils/FileCollector.ts"],"sourcesContent":["/**\n * Create JSDoc comment block from comments array\n */\nexport function createJSDoc({ comments }: { comments: string[] }): string {\n  if (!comments || comments.length === 0) return ''\n\n  const lines = comments\n    .flatMap((c) => String(c ?? '').split(/\\r?\\n/))\n    .map((l) => l.replace(/\\*\\//g, '*\\\\/').replace(/\\r/g, ''))\n    .filter((l) => l.trim().length > 0)\n\n  if (lines.length === 0) return ''\n\n  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\\n')\n}\n","import type * as KubbFile from '../KubbFile.ts'\n\n/**\n * FileCollector is used to collect files from components via context\n * instead of walking the DOM tree.\n */\nexport class FileCollector {\n  #files: Array<KubbFile.File> = []\n\n  /**\n   * Add a file to the collector\n   */\n  add(file: KubbFile.File): void {\n    this.#files.push(file)\n  }\n\n  /**\n   * Get all collected files\n   */\n  get files(): Array<KubbFile.File> {\n    return [...this.#files]\n  }\n\n  /**\n   * Clear all collected files\n   */\n  clear(): void {\n    this.#files = []\n  }\n}\n"],"mappings":";;;;;;AAGA,SAAgB,YAAY,EAAE,YAA4C;AACxE,KAAI,CAAC,YAAY,SAAS,WAAW,EAAG,QAAO;CAE/C,MAAM,QAAQ,SACX,SAAS,MAAM,OAAO,iCAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,CAC9C,KAAK,MAAM,EAAE,QAAQ,SAAS,OAAO,CAAC,QAAQ,OAAO,GAAG,CAAC,CACzD,QAAQ,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;AAErC,KAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAO;EAAC;EAAO,GAAG,MAAM,KAAK,MAAM,MAAM,IAAI;EAAE;EAAM,CAAC,KAAK,KAAK;;;;;;;;;;ACPlE,IAAa,gBAAb,MAA2B;;2CACM,EAAE;;;;;CAKjC,IAAI,MAA2B;AAC7B,sCAAW,CAAC,KAAK,KAAK;;;;;CAMxB,IAAI,QAA8B;AAChC,SAAO,CAAC,kCAAG,KAAW,CAAC;;;;;CAMzB,QAAc;AACZ,uCAAc,EAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/fabric-core",
-  "version": "0.0.0-canary-20260111130736",
+  "version": "0.0.0-canary-20260113205926",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -42,6 +42,10 @@
       "require": "./dist/types.cjs",
       "import": "./dist/types.js"
     },
+    "./utils": {
+      "require": "./dist/utils.cjs",
+      "import": "./dist/utils.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",
@@ -58,6 +62,9 @@
       "plugins": [
         "./dist/plugins.d.ts"
       ],
+      "utils": [
+        "./dist/utils.d.ts"
+      ],
       "types": [
         "./dist/types.d.ts"
       ]

package/src/composables/useApp.ts

@@ -0,0 +1,15 @@
+import { inject } from '../context.ts'
+import { AppContext, type AppContextProps } from '../contexts/AppContext.ts'
+
+/**
+ * `useApp` will return the current App with meta and exit function.
+ */
+export function useApp<TMeta = unknown>(): AppContextProps<TMeta> {
+  const app = inject(AppContext, undefined)
+
+  if (!app) {
+    throw new Error('App context should be provided')
+  }
+
+  return app as AppContextProps<TMeta>
+}

package/src/composables/useContext.ts

@@ -0,0 +1,16 @@
+import type { Context } from '../context.ts'
+import { inject } from '../context.ts'
+
+/**
+ * React-style alias for inject
+ *
+ * @example
+ * ```ts
+ * const theme = useContext(ThemeContext) // type is inferred from ThemeContext
+ * ```
+ */
+export function useContext<T>(key: Context<T>): T
+export function useContext<T>(key: Context<T>, defaultValue: T): T
+export function useContext<T>(key: Context<T>, defaultValue?: T): T {
+  return inject(key, defaultValue)
+}

package/src/composables/useFile.ts

@@ -0,0 +1,16 @@
+import { inject } from '../context.ts'
+import { FileCollectorContext } from '../contexts/FileCollectorContext.ts'
+import type { FileCollector } from '../utils/FileCollector.ts'
+
+/**
+ * `useFile` will return the current FileCollector for registering files.
+ */
+export function useFile(): FileCollector {
+  const collector = inject(FileCollectorContext, null)
+
+  if (!collector) {
+    throw new Error('No FileCollector found in context. Make sure you are using a Fabric that provides a FileCollector.')
+  }
+
+  return collector
+}

package/src/composables/useLifecycle.ts

@@ -0,0 +1,13 @@
+import { inject } from '../context.ts'
+import { RootContext } from '../contexts/RootContext.ts'
+
+/**
+ * `useLifecycle` will return some helpers to exit/restart the generation.
+ */
+export function useLifecycle() {
+  const { exit } = inject(RootContext, { exit: () => {} })
+
+  return {
+    exit,
+  }
+}

package/src/context.ts

@@ -0,0 +1,82 @@
+/**
+ * Context type that carries type information about its value
+ * This is a branded symbol type that enables type-safe context usage
+ */
+export type Context<T> = symbol & { readonly __type: T }
+
+/**
+ * Context stack for tracking the current context values
+ *
+ * Note: This uses a global Map for simplicity in code generation scenarios.
+ * For concurrent runtime execution, consider using AsyncLocalStorage or
+ * instance-based context management.
+ */
+const contextStack = new Map<symbol, unknown[]>()
+const contextDefaults = new Map<symbol, unknown>()
+
+/**
+ * Provides a value to descendant components (Vue 3 style)
+ *
+ * @example
+ * ```ts
+ * const ThemeKey = Symbol('theme')
+ * provide(ThemeKey, { color: 'blue' })
+ * ```
+ */
+export function provide<T>(key: symbol | Context<T>, value: T): void {
+  if (!contextStack.has(key)) {
+    contextStack.set(key, [])
+  }
+  contextStack.get(key)!.push(value)
+}
+
+/**
+ * Injects a value provided by an ancestor component (Vue 3 style)
+ *
+ * @example
+ * ```ts
+ * const theme = inject(ThemeKey, { color: 'default' })
+ * ```
+ */
+export function inject<T>(key: symbol | Context<T>, defaultValue?: T): T {
+  const stack = contextStack.get(key)
+  if (!stack || stack.length === 0) {
+    if (defaultValue !== undefined) {
+      return defaultValue
+    }
+    const storedDefault = contextDefaults.get(key)
+    if (storedDefault !== undefined) {
+      return storedDefault as T
+    }
+    throw new Error(`No value provided for key: ${key.toString()}`)
+  }
+  return stack[stack.length - 1] as T
+}
+
+/**
+ * Unprovides a value (for cleanup)
+ * @internal
+ */
+export function unprovide<T>(key: symbol | Context<T>): void {
+  const stack = contextStack.get(key)
+  if (stack && stack.length > 0) {
+    stack.pop()
+  }
+}
+
+/**
+ * Creates a context key with a default value (React-style compatibility)
+ *
+ * @example
+ * ```ts
+ * const ThemeContext = createContext({ color: 'blue' })
+ * // ThemeContext is now typed as Context<{ color: string }>
+ * const theme = useContext(ThemeContext) // theme is { color: string }
+ * ```
+ */
+export function createContext<T>(defaultValue: T): Context<T> {
+  const key = Symbol('context') as Context<T>
+  contextDefaults.set(key, defaultValue)
+
+  return key
+}

package/src/contexts/AppContext.ts

@@ -0,0 +1,11 @@
+import { createContext } from '../context.ts'
+
+export type AppContextProps<TMeta = unknown> = {
+  /**
+   * Exit (unmount)
+   */
+  readonly exit: (error?: Error) => void
+  readonly meta: TMeta
+}
+
+export const AppContext = createContext<AppContextProps | undefined>(undefined)

package/src/contexts/FileCollectorContext.ts

@@ -0,0 +1,18 @@
+import { createContext } from '../context.ts'
+import type * as KubbFile from '../KubbFile.ts'
+import type { FileCollector } from '../utils/FileCollector.ts'
+
+/**
+ * Context for collecting files - provided by createFsxFabric
+ */
+export const FileCollectorContext = createContext<FileCollector | null>(null)
+
+/**
+ * Context for the current file being processed
+ */
+type CurrentFileContext = {
+  sources: KubbFile.Source[]
+  imports: KubbFile.Import[]
+  exports: KubbFile.Export[]
+}
+export const CurrentFileContext = createContext<CurrentFileContext | null>(null)

package/src/contexts/RootContext.ts

@@ -0,0 +1,12 @@
+import { createContext } from '../context.ts'
+
+export type RootContextProps = {
+  /**
+   * Exit (unmount) the whole app.
+   */
+  readonly exit: (error?: Error) => void
+}
+
+export const RootContext = createContext<RootContextProps>({
+  exit: () => {},
+})

package/src/index.ts

@@ -1,3 +1,13 @@
+export { useApp } from './composables/useApp.ts'
+export { useContext } from './composables/useContext.ts'
+export { useFile } from './composables/useFile.ts'
+export { useLifecycle } from './composables/useLifecycle.ts'
+// context api
+export type { Context } from './context.ts'
+export { createContext, inject, provide, unprovide } from './context.ts'
+export { AppContext } from './contexts/AppContext.ts'
+export { FileCollectorContext } from './contexts/FileCollectorContext.ts'
+export { RootContext } from './contexts/RootContext.ts'
 export { createFabric } from './createFabric.ts'
 export { createFile } from './createFile.ts'
 // we need this to override the globals of `fabric.use`

package/src/utils/FileCollector.ts

@@ -0,0 +1,30 @@
+import type * as KubbFile from '../KubbFile.ts'
+
+/**
+ * FileCollector is used to collect files from components via context
+ * instead of walking the DOM tree.
+ */
+export class FileCollector {
+  #files: Array<KubbFile.File> = []
+
+  /**
+   * Add a file to the collector
+   */
+  add(file: KubbFile.File): void {
+    this.#files.push(file)
+  }
+
+  /**
+   * Get all collected files
+   */
+  get files(): Array<KubbFile.File> {
+    return [...this.#files]
+  }
+
+  /**
+   * Clear all collected files
+   */
+  clear(): void {
+    this.#files = []
+  }
+}

package/src/utils/createJSDoc.ts

@@ -0,0 +1,15 @@
+/**
+ * Create JSDoc comment block from comments array
+ */
+export function createJSDoc({ comments }: { comments: string[] }): string {
+  if (!comments || comments.length === 0) return ''
+
+  const lines = comments
+    .flatMap((c) => String(c ?? '').split(/\r?\n/))
+    .map((l) => l.replace(/\*\//g, '*\\/').replace(/\r/g, ''))
+    .filter((l) => l.trim().length > 0)
+
+  if (lines.length === 0) return ''
+
+  return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\n')
+}

package/src/utils/index.ts

@@ -0,0 +1,2 @@
+export { createJSDoc } from './createJSDoc.ts'
+export { FileCollector } from './FileCollector.ts'