@dtsx/dtsx 0.0.0-stage → 0.11.38

package/dist/src/plugins/tsup.d.ts

@@ -0,0 +1,53 @@
+import type { DtsGenerationConfig, GenerationStats } from '../types.js';
+/**
+ * Create a tsup plugin for dtsx
+ *
+ * @example
+ * ```ts
+ * // tsup.config.ts
+ * import { dtsxPlugin } from '@dtsx/dtsx/plugins/tsup'
+ * import { defineConfig } from 'tsup'
+ *
+ * export default defineConfig({
+ *   entry: ['./src/index.ts'],
+ *   outDir: './dist',
+ *   plugins: [
+ *     dtsxPlugin({
+ *       root: './src',
+ *       outdir: './dist',
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export declare function dtsxPlugin(options?: TsupPluginOptions): TsupPlugin;
+/**
+ * Alias for dtsxPlugin
+ */
+export declare const tsupDts: typeof dtsxPlugin;
+/**
+ * Alias matching common naming convention
+ */
+export declare const dts: typeof dtsxPlugin;
+/**
+ * tsup plugin options
+ */
+export declare interface TsupPluginOptions extends Partial<DtsGenerationConfig> {
+  onBuildStart?: boolean
+  onBuildEnd?: boolean
+  onGenerated?: (stats: GenerationStats) => void
+  onError?: (error: Error) => void
+}
+/**
+ * tsup plugin interface
+ */
+declare interface TsupPlugin {
+  name: string
+  buildStart?: () => void | Promise<void>
+  buildEnd?: (ctx: { writtenFiles: Array<{ name: string, size: number }> }) => void | Promise<void>
+  esbuildOptions?: (options: Record<string, unknown>) => void
+}
+/**
+ * Default export
+ */
+export default dtsxPlugin;

package/dist/src/plugins/tsup.js

@@ -0,0 +1,2 @@
+// @bun
+import{le,ha,Yn,ya}from"../../chunk-9menejdz.js";import"../../chunk-0zfzhn19.js";import"../../chunk-rbx6q1r0.js";import"../../chunk-0k0fhq13.js";import"../../chunk-hzn9kmq7.js";import"../../chunk-y1g6v96c.js";import"../../chunk-zk3w5sqv.js";import"../../chunk-vkahj2ab.js";import"../../chunk-tka2m4af.js";import"../../chunk-kfk554fj.js";import"../../chunk-mkakbjvs.js";import"../../chunk-7tremqhs.js";import"../../chunk-danfamyx.js";import"../../chunk-wnqg6hem.js";import"../../chunk-0yg5mcrf.js";import"../../chunk-p023fhce.js";import"../../chunk-6yvk3q1e.js";import"../../chunk-ghfd34r7.js";import"../../chunk-bxc2herz.js";import"../../chunk-davy89dj.js";import"../../chunk-g2120ysy.js";import"../../chunk-4fygcxtb.js";import"../../chunk-ebjafajx.js";import"../../chunk-p9vfxn8g.js";import"../../chunk-qzjzw9p2.js";import"../../chunk-cpmqa8kd.js";import"../../chunk-73dzve1s.js";import"../../chunk-yay68832.js";import"../../chunk-jcckwgb9.js";import"../../chunk-189nn4fc.js";import"../../chunk-83qnrx0m.js";import"../../chunk-sd8bywh9.js";import"../../chunk-3fbt79hx.js";import"../../chunk-pga5m4wm.js";import"../../chunk-v6fwy63g.js";import"../../chunk-yx1jy7fx.js";import"../../chunk-cyr45de1.js";import"../../chunk-xfjfhe9d.js";import"../../chunk-xa6rsd4b.js";import"../../chunk-ft2zk7jx.js";import"../../chunk-vf3ybe5r.js";import"../../chunk-3t57mzvf.js";import"../../chunk-ag1b6d30.js";import"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-42j9cfte.js";import"../../chunk-1qtghb2x.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{ya as default,Yn as dts,le as dtsxPlugin,ha as tsupDts};

package/dist/src/plugins/vite.d.ts

@@ -0,0 +1,49 @@
+import type { DtsGenerationConfig, GenerationStats } from '../types.js';
+/**
+ * Create a Vite plugin for dtsx
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { dts } from '@dtsx/dtsx/plugins/vite'
+ *
+ * export default {
+ *   plugins: [
+ *     dts({
+ *       root: './src',
+ *       outdir: './dist',
+ *     }),
+ *   ],
+ * }
+ * ```
+ */
+export declare function dts(options?: VitePluginOptions): VitePlugin;
+/**
+ * Alias for dts
+ */
+export declare const viteDts: typeof dts;
+/**
+ * Vite plugin options
+ */
+export declare interface VitePluginOptions extends Partial<DtsGenerationConfig> {
+  buildStart?: boolean
+  buildEnd?: boolean
+  writeBundle?: boolean
+  modes?: string[]
+  onGenerated?: (stats: GenerationStats) => void
+  onError?: (error: Error) => void
+}
+/**
+ * Vite plugin interface (minimal type for compatibility)
+ */
+declare interface VitePlugin {
+  name: string
+  apply?: 'build' | 'serve' | ((_config: { mode: string }) => boolean)
+  buildStart?: () => Promise<void> | void
+  buildEnd?: () => Promise<void> | void
+  writeBundle?: () => Promise<void> | void
+}
+/**
+ * Default export
+ */
+export default dts;

package/dist/src/plugins/vite.js

@@ -0,0 +1,2 @@
+// @bun
+import{Ie,fa,da}from"../../chunk-mwyjxjqa.js";import"../../chunk-0zfzhn19.js";import"../../chunk-rbx6q1r0.js";import"../../chunk-0k0fhq13.js";import"../../chunk-hzn9kmq7.js";import"../../chunk-y1g6v96c.js";import"../../chunk-zk3w5sqv.js";import"../../chunk-vkahj2ab.js";import"../../chunk-tka2m4af.js";import"../../chunk-kfk554fj.js";import"../../chunk-mkakbjvs.js";import"../../chunk-7tremqhs.js";import"../../chunk-danfamyx.js";import"../../chunk-wnqg6hem.js";import"../../chunk-0yg5mcrf.js";import"../../chunk-p023fhce.js";import"../../chunk-6yvk3q1e.js";import"../../chunk-ghfd34r7.js";import"../../chunk-bxc2herz.js";import"../../chunk-davy89dj.js";import"../../chunk-g2120ysy.js";import"../../chunk-4fygcxtb.js";import"../../chunk-ebjafajx.js";import"../../chunk-p9vfxn8g.js";import"../../chunk-qzjzw9p2.js";import"../../chunk-cpmqa8kd.js";import"../../chunk-73dzve1s.js";import"../../chunk-yay68832.js";import"../../chunk-jcckwgb9.js";import"../../chunk-189nn4fc.js";import"../../chunk-83qnrx0m.js";import"../../chunk-sd8bywh9.js";import"../../chunk-3fbt79hx.js";import"../../chunk-pga5m4wm.js";import"../../chunk-v6fwy63g.js";import"../../chunk-yx1jy7fx.js";import"../../chunk-cyr45de1.js";import"../../chunk-xfjfhe9d.js";import"../../chunk-xa6rsd4b.js";import"../../chunk-ft2zk7jx.js";import"../../chunk-vf3ybe5r.js";import"../../chunk-3t57mzvf.js";import"../../chunk-ag1b6d30.js";import"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-42j9cfte.js";import"../../chunk-1qtghb2x.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{da as default,Ie as dts,fa as viteDts};

package/dist/src/plugins/webpack.d.ts

@@ -0,0 +1,69 @@
+import type { DtsGenerationConfig, GenerationStats } from '../types.js';
+/**
+ * Factory function for creating webpack plugin
+ */
+export declare function dtsxWebpack(options?: WebpackPluginOptions): DtsxWebpackPlugin;
+/**
+ * Alias matching common naming convention
+ */
+export declare const dts: typeof dtsxWebpack;
+/**
+ * webpack plugin options
+ */
+export declare interface WebpackPluginOptions extends Partial<DtsGenerationConfig> {
+  onCompile?: boolean
+  afterEmit?: boolean
+  onWatchRun?: boolean
+  onGenerated?: (stats: GenerationStats) => void
+  onError?: (error: Error) => void
+}
+/**
+ * webpack compiler interface (minimal type)
+ */
+declare interface WebpackCompiler {
+  hooks: {
+    compile: { tap: (name: string, callback: () => void) => void }
+    afterEmit: { tapAsync: (name: string, callback: (compilation: unknown, done: () => void) => void) => void }
+    watchRun: { tapAsync: (name: string, callback: (compiler: unknown, done: () => void) => void) => void }
+  }
+  options: {
+    entry?: unknown
+    output?: {
+      path?: string
+    }
+    context?: string
+  }
+}
+/**
+ * webpack plugin for dtsx
+ *
+ * @example
+ * ```ts
+ * // webpack.config.js
+ * const { DtsxWebpackPlugin } = require('@dtsx/dtsx/plugins/webpack')
+ *
+ * module.exports = {
+ *   entry: './src/index.ts',
+ *   output: {
+ *     path: path.resolve(__dirname, 'dist'),
+ *   },
+ *   plugins: [
+ *     new DtsxWebpackPlugin({
+ *       root: './src',
+ *       outdir: './dist',
+ *     }),
+ *   ],
+ * }
+ * ```
+ */
+export declare class DtsxWebpackPlugin {
+  private options;
+  private generateOptions;
+  constructor(options?: WebpackPluginOptions);
+  apply(compiler: WebpackCompiler): void;
+  private runGenerate;
+}
+/**
+ * Default export
+ */
+export default DtsxWebpackPlugin;

package/dist/src/plugins/webpack.js

@@ -0,0 +1,2 @@
+// @bun
+import{Le,It,Xn,ba}from"../../chunk-v93389xm.js";import"../../chunk-0zfzhn19.js";import"../../chunk-rbx6q1r0.js";import"../../chunk-0k0fhq13.js";import"../../chunk-hzn9kmq7.js";import"../../chunk-y1g6v96c.js";import"../../chunk-zk3w5sqv.js";import"../../chunk-vkahj2ab.js";import"../../chunk-tka2m4af.js";import"../../chunk-kfk554fj.js";import"../../chunk-mkakbjvs.js";import"../../chunk-7tremqhs.js";import"../../chunk-danfamyx.js";import"../../chunk-wnqg6hem.js";import"../../chunk-0yg5mcrf.js";import"../../chunk-p023fhce.js";import"../../chunk-6yvk3q1e.js";import"../../chunk-ghfd34r7.js";import"../../chunk-bxc2herz.js";import"../../chunk-davy89dj.js";import"../../chunk-g2120ysy.js";import"../../chunk-4fygcxtb.js";import"../../chunk-ebjafajx.js";import"../../chunk-p9vfxn8g.js";import"../../chunk-qzjzw9p2.js";import"../../chunk-cpmqa8kd.js";import"../../chunk-73dzve1s.js";import"../../chunk-yay68832.js";import"../../chunk-jcckwgb9.js";import"../../chunk-189nn4fc.js";import"../../chunk-83qnrx0m.js";import"../../chunk-sd8bywh9.js";import"../../chunk-3fbt79hx.js";import"../../chunk-pga5m4wm.js";import"../../chunk-v6fwy63g.js";import"../../chunk-yx1jy7fx.js";import"../../chunk-cyr45de1.js";import"../../chunk-xfjfhe9d.js";import"../../chunk-xa6rsd4b.js";import"../../chunk-ft2zk7jx.js";import"../../chunk-vf3ybe5r.js";import"../../chunk-3t57mzvf.js";import"../../chunk-ag1b6d30.js";import"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-42j9cfte.js";import"../../chunk-1qtghb2x.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{Le as DtsxWebpackPlugin,ba as default,Xn as dts,It as dtsxWebpack};

package/dist/src/plugins.d.ts

@@ -0,0 +1,88 @@
+import type { Declaration, DtsGenerationConfig, GenerationStats } from './types.js';
+/**
+ * Helper to create a plugin
+ */
+export declare function definePlugin(plugin: Plugin): Plugin;
+/**
+ * Built-in plugin: Add banner comment
+ * Adds a banner comment to the top of generated files
+ */
+export declare function createBannerPlugin(banner: string): Plugin;
+/**
+ * Built-in plugin: Filter exports
+ * Only include declarations matching the filter
+ */
+export declare function createFilterPlugin(filter: (name: string) => boolean): Plugin;
+/**
+ * Global plugin manager instance
+ */
+export declare const pluginManager: PluginManager;
+/**
+ * Built-in plugin: Strip internal declarations
+ * Removes declarations marked with @internal in JSDoc
+ */
+export declare const stripInternalPlugin: Plugin;
+/**
+ * Context passed to plugin hooks
+ */
+export declare interface PluginContext {
+  filePath: string
+  sourceCode: string
+  config: DtsGenerationConfig
+  log: {
+    debug: (message: string) => void
+    info: (message: string) => void
+    warn: (message: string) => void
+    error: (message: string) => void
+  }
+}
+/**
+ * Transform context with mutable content
+ */
+export declare interface TransformContext extends PluginContext {
+  content: string
+}
+/**
+ * Declaration context for declaration hooks
+ */
+export declare interface DeclarationContext extends PluginContext {
+  declarations: Declaration[]
+}
+/**
+ * Plugin hook definitions
+ */
+export declare interface PluginHooks {
+  onStart?: (config: DtsGenerationConfig) => DtsGenerationConfig | void | Promise<DtsGenerationConfig | void>
+  onBeforeFile?: (ctx: TransformContext) => string | void | Promise<string | void>
+  onDeclarations?: (ctx: DeclarationContext) => Declaration[] | void | Promise<Declaration[] | void>
+  onAfterFile?: (ctx: TransformContext) => string | void | Promise<string | void>
+  onEnd?: (stats: GenerationStats) => void | Promise<void>
+  onError?: (error: Error, ctx: PluginContext) => void | Promise<void>
+}
+/**
+ * Plugin definition
+ */
+export declare interface Plugin extends PluginHooks {
+  name: string
+  version?: string
+  cacheKey?: string
+  description?: string
+}
+/**
+ * Plugin manager for handling multiple plugins
+ */
+export declare class PluginManager {
+  private plugins;
+  private config;
+  register(plugin: Plugin): void;
+  hasDeclarationHooks(): boolean;
+  unregister(name: string): boolean;
+  getPlugins(): readonly Plugin[];
+  private createLogger;
+  runOnStart(config: DtsGenerationConfig): Promise<DtsGenerationConfig>;
+  runOnBeforeFile(filePath: string, sourceCode: string): Promise<string>;
+  runOnDeclarations(filePath: string, sourceCode: string, declarations: Declaration[]): Promise<Declaration[]>;
+  runOnAfterFile(filePath: string, sourceCode: string, dtsContent: string): Promise<string>;
+  runOnEnd(stats: GenerationStats): Promise<void>;
+  runOnError(error: Error, filePath: string, sourceCode: string): Promise<void>;
+}

package/dist/src/plugins.js

@@ -0,0 +1,2 @@
+// @bun
+import{he,Wo,q,jo,_o,Go}from"../chunk-bxc2herz.js";export{he as PluginManager,_o as createBannerPlugin,Go as createFilterPlugin,q as definePlugin,Wo as pluginManager,jo as stripInternalPlugin};

package/dist/src/process-source.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Emit through the native engine when it can produce this output: the engine
+ * is loaded and the import order is the default one it implements. Returns
+ * null otherwise, or when the native emitter rejects the input, and the
+ * TypeScript engine runs instead.
+ */
+export declare function emitNatively(sourceCode: string, filename: string, keepComments: boolean, importOrder: readonly string[], isolatedDeclarations: boolean): string | null;
+/**
+ * Process TypeScript source code from a string (for stdin support)
+ * This is a lightweight module that avoids pulling in heavy dependencies
+ * like bun Glob, fs/promises, bundler, cache, config, etc.
+ */
+export declare function processSource(sourceCode: string, filename?: string, keepComments?: boolean, importOrder?: string[], isolatedDeclarations?: boolean): string;
+/** Generate declarations through the annotation-first isolated fast path. */
+export declare function processSourceIsolated(sourceCode: string, filename?: string, keepComments?: boolean, importOrder?: string[]): string;
+/** Generate declarations through the value-aware semantic inference path. */
+export declare function processSourceSemantic(sourceCode: string, filename?: string, keepComments?: boolean, importOrder?: string[]): string;
+export declare function clearResultCache(): void;
+/**
+ * Fast path for project mode — skips cache lookup/store.
+ * Use when processing many files once (no cache benefit).
+ */
+export declare function processSourceDirect(sourceCode: string, filename?: string, keepComments?: boolean, importOrder?: string[], isolatedDeclarations?: boolean): string;
+/**
+ * Emit through the TypeScript engine only, without the native engine or the
+ * result cache: the reference the native engine is held to.
+ */
+export declare function processSourceWithTypeScriptEngine(sourceCode: string, filename?: string, keepComments?: boolean, importOrder?: string[], isolatedDeclarations?: boolean): string;

package/dist/src/process-source.js

@@ -0,0 +1,2 @@
+// @bun
+import{je,dt,Kr,qr,Jr,Ca,fn}from"../chunk-hzn9kmq7.js";import"../chunk-y1g6v96c.js";import"../chunk-zk3w5sqv.js";import"../chunk-mkakbjvs.js";import"../chunk-4fygcxtb.js";import"../chunk-189nn4fc.js";import"../chunk-83qnrx0m.js";import"../chunk-sd8bywh9.js";import"../chunk-v6fwy63g.js";import"../chunk-yx1jy7fx.js";import"../chunk-cyr45de1.js";import"../chunk-xfjfhe9d.js";import"../chunk-xa6rsd4b.js";import"../chunk-ft2zk7jx.js";import"../chunk-vf3ybe5r.js";import"../chunk-3t57mzvf.js";import"../chunk-ag1b6d30.js";import"../chunk-8d3sdkv4.js";import"../chunk-cv29b4zb.js";import"../chunk-32qexm3w.js";import"../chunk-0rmbc5zp.js";import"../chunk-42j9cfte.js";import"../chunk-1qtghb2x.js";import"../chunk-1j6092xz.js";import"../chunk-zq93f8ca.js";export{Jr as clearResultCache,je as emitNatively,dt as processSource,Ca as processSourceDirect,Kr as processSourceIsolated,qr as processSourceSemantic,fn as processSourceWithTypeScriptEngine};

package/dist/src/processor/cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Get or create a cached RegExp for word boundary matching.
+ * Promotes the entry on a hit so the FIFO eviction approximates LRU.
+ */
+export declare function getCachedRegex(pattern: string): RegExp;
+/**
+ * Get cached import items or null if not cached.
+ * Promotes on hit for LRU-like semantics.
+ */
+export declare function getImportItemsFromCache(importText: string): string[] | null;
+/**
+ * Store import items in cache with eviction
+ */
+export declare function setImportItemsCache(importText: string, items: string[]): void;
+/**
+ * Clear processor caches (useful for testing or memory management)
+ */
+export declare function clearProcessorCaches(): void;

package/dist/src/processor/cache.js

@@ -0,0 +1,2 @@
+// @bun
+import{ka,Nn,Bn,Wn}from"../../chunk-3t57mzvf.js";export{Wn as clearProcessorCaches,ka as getCachedRegex,Nn as getImportItemsFromCache,Bn as setImportItemsCache};

package/dist/src/processor/comments.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Comment formatting utilities for DTS output
+ */
+/**
+ * Format comments for DTS output
+ */
+export declare function formatComments(comments: string[] | undefined, keepComments?: boolean): string;
+/** Keep data embedded in generated JSDoc from ending the comment. */
+export declare function escapeJsdocContent(value: string): string;

package/dist/src/processor/comments.js

@@ -0,0 +1,2 @@
+// @bun
+import{f,Pe}from"../../chunk-cv29b4zb.js";export{Pe as escapeJsdocContent,f as formatComments};

package/dist/src/processor/declarations.d.ts

@@ -0,0 +1,37 @@
+import type { Declaration } from '../types.js';
+/**
+ * Process function declaration to DTS format
+ */
+export declare function processFunctionDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process variable declaration to DTS format
+ */
+export declare function processVariableDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process interface declaration to DTS format
+ */
+export declare function processInterfaceDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process type alias declaration to DTS format
+ */
+export declare function processTypeDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process class declaration to DTS format
+ */
+export declare function processClassDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process enum declaration to DTS format
+ */
+export declare function processEnumDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process import statement
+ */
+export declare function processImportDeclaration(decl: Declaration): string;
+/**
+ * Process export statement
+ */
+export declare function processExportDeclaration(decl: Declaration, keepComments?: boolean): string;
+/**
+ * Process module/namespace declaration to DTS format
+ */
+export declare function processModuleDeclaration(decl: Declaration, keepComments?: boolean): string;

package/dist/src/processor/declarations.js

@@ -0,0 +1,2 @@
+// @bun
+import{ee,h,te,ne,re,ie,On,In,se}from"../../chunk-xa6rsd4b.js";import"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{re as processClassDeclaration,ie as processEnumDeclaration,In as processExportDeclaration,ee as processFunctionDeclaration,On as processImportDeclaration,te as processInterfaceDeclaration,se as processModuleDeclaration,ne as processTypeDeclaration,h as processVariableDeclaration};

package/dist/src/processor/import-usage.d.ts

@@ -0,0 +1,6 @@
+import type { Declaration } from '../types.js';
+/** The same declaration reference analysis serves import pruning and graph planning. */
+export declare function analyzeDeclarationImportUsage(declarations: readonly Declaration[]): {
+  usedItems: Set<string>
+  referenceText: string
+};

package/dist/src/processor/import-usage.js

@@ -0,0 +1,2 @@
+// @bun
+import{xe}from"../../chunk-4fygcxtb.js";import"../../chunk-xa6rsd4b.js";import"../../chunk-vf3ybe5r.js";import"../../chunk-3t57mzvf.js";import"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{xe as analyzeDeclarationImportUsage};

package/dist/src/processor/imports.d.ts

@@ -0,0 +1,68 @@
+/** Canonically quote the decoded value of a grammatical module literal. */
+export declare function getImportSourceLiteral(importText: string): string | undefined;
+/**
+ * Parse an import statement into its components using string operations
+ * Avoids regex backtracking issues
+ */
+export declare function parseImportStatement(importText: string): {
+  defaultName: string | null
+  namedItems: string[]
+  source: string
+  isTypeOnly: boolean
+  isNamespace: boolean
+  namespaceName?: string | null
+  isImportEquals?: boolean
+} | null;
+/** Imported local names, sharing the same binding grammar as emission. */
+export declare function extractAllImportedItems(importText: string): string[];
+/**
+ * Parse an import statement with detailed type-only information for each item
+ * Handles: import type { X }, import { type X, Y }, import * as X, etc.
+ */
+export declare function parseImportDetailed(importText: string): ParsedImport | null;
+/**
+ * Parse an export statement with detailed type-only information
+ * Handles: export type { X }, export { type X, Y }, export * from, etc.
+ */
+export declare function parseExportDetailed(exportText: string): {
+  namedItems: ImportItem[]
+  source: string | null
+  isTypeOnly: boolean
+  isNamespace: boolean
+  isDefault: boolean
+} | null;
+/**
+ * Check if an import item is type-only
+ */
+export declare function isTypeOnlyImportItem(itemText: string): boolean;
+/**
+ * Convert import items to type-only format
+ * E.g., "{ X, Y }" becomes "{ type X, type Y }"
+ */
+export declare function convertToTypeOnlyImport(importText: string): string;
+/**
+ * Merge value and type imports from the same module
+ * Combines separate import statements into one where possible
+ */
+export declare function mergeImports(imports: string[]): string[];
+/**
+ * Represents a single imported item with its type-only status
+ */
+export declare interface ImportItem {
+  name: string
+  originalName: string
+  isTypeOnly: boolean
+  isDefault: boolean
+}
+/**
+ * Detailed import statement parse result
+ */
+export declare interface ParsedImport {
+  defaultName: string | null
+  namedItems: ImportItem[]
+  source: string
+  isTypeOnly: boolean
+  isNamespace: boolean
+  namespaceName: string | null
+  isImportEquals?: boolean
+}

package/dist/src/processor/imports.js

@@ -0,0 +1,2 @@
+// @bun
+import{Ee,Ln,y,b,Sa,wi,$a,Ea}from"../../chunk-vf3ybe5r.js";import"../../chunk-3t57mzvf.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{$a as convertToTypeOnlyImport,y as extractAllImportedItems,Ee as getImportSourceLiteral,wi as isTypeOnlyImportItem,Ea as mergeImports,Sa as parseExportDetailed,b as parseImportDetailed,Ln as parseImportStatement};

package/dist/src/processor/index.d.ts

@@ -0,0 +1,33 @@
+import { formatComments } from './comments.js';
+import { processClassDeclaration, processEnumDeclaration, processFunctionDeclaration, processInterfaceDeclaration, processModuleDeclaration, processTypeDeclaration, processVariableDeclaration } from './declarations.js';
+import type { Declaration, ProcessingContext } from '../types.js';
+/**
+ * Process declarations and convert them to narrow DTS format
+ */
+export declare function processDeclarations(declarations: Declaration[], context: ProcessingContext, keepComments?: boolean, importOrder?: string[]): string;
+// Re-export all public APIs
+export { clearProcessorCaches } from './cache.js';
+export { formatComments } from './comments.js';
+export {
+  processClassDeclaration,
+  processEnumDeclaration,
+  processExportDeclaration,
+  processFunctionDeclaration,
+  processImportDeclaration,
+  processInterfaceDeclaration,
+  processModuleDeclaration,
+  processTypeDeclaration,
+  processVariableDeclaration,
+} from './declarations.js';
+export { extractAllImportedItems, parseImportStatement } from './imports.js';
+export {
+  extractSatisfiesType,
+  findMatchingBracket,
+  inferArrayType,
+  inferFunctionType,
+  inferNarrowType,
+  inferNarrowTypeInUnion,
+  inferObjectType,
+  isGenericType,
+  parseArrayElements,
+} from './type-inference.js';

package/dist/src/processor/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{l}from"../../chunk-y1g6v96c.js";import"../../chunk-zk3w5sqv.js";import"../../chunk-4fygcxtb.js";import{ee,h,te,ne,re,ie,On,In,se}from"../../chunk-xa6rsd4b.js";import{Ln,y}from"../../chunk-vf3ybe5r.js";import{Wn}from"../../chunk-3t57mzvf.js";import"../../chunk-ag1b6d30.js";import{n,Ot,ke,oe,et,o,tt,Ae,j}from"../../chunk-8d3sdkv4.js";import{f}from"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-42j9cfte.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{Wn as clearProcessorCaches,y as extractAllImportedItems,j as extractSatisfiesType,o as findMatchingBracket,f as formatComments,ke as inferArrayType,tt as inferFunctionType,n as inferNarrowType,Ot as inferNarrowTypeInUnion,et as inferObjectType,Ae as isGenericType,oe as parseArrayElements,Ln as parseImportStatement,re as processClassDeclaration,l as processDeclarations,ie as processEnumDeclaration,In as processExportDeclaration,ee as processFunctionDeclaration,On as processImportDeclaration,te as processInterfaceDeclaration,se as processModuleDeclaration,ne as processTypeDeclaration,h as processVariableDeclaration};

package/dist/src/processor/type-inference.d.ts

@@ -0,0 +1,116 @@
+import type { KeyConstants } from '../computed-keys.js';
+/**
+ * Enable clean default collection for the next type inference pass.
+ * Must be called before inferNarrowType when you need a @defaultValue.
+ */
+export declare function enableCleanDefaultCollection(): void;
+/**
+ * Consume the computed clean default (also disables collection).
+ * Returns null if no clean default was computed.
+ */
+export declare function consumeCleanDefault(): string | null;
+/**
+ * Infer and narrow types from values
+ * @param inUnion - When true, widens number/boolean literals to their base types (used in array union contexts)
+ * @param _depth - Internal recursion depth counter (do not set manually)
+ */
+export declare function inferNarrowType(value: unknown, isConst?: boolean, inUnion?: boolean, _depth?: number, keyConstants?: KeyConstants): string;
+/**
+ * Infer and narrow types from values in union context (for arrays)
+ * Widens number/boolean literals to base types unless const
+ */
+export declare function inferNarrowTypeInUnion(value: unknown, isConst?: boolean, _depth?: number, keyConstants?: KeyConstants): string;
+/**
+ * Infer the public return type of a function body without building a TypeScript AST.
+ *
+ * This is intentionally used only by the semantic generation path. Isolated
+ * declarations remain annotation-first and never scan implementation bodies.
+ */
+export declare function inferFunctionBodyReturnType(body: string, isAsync?: boolean, parameters?: string, classExpression?: (value: string) => string | undefined, assertedType?: (type: string, position: number) => string): string;
+/**
+ * Infer array type from array literal
+ */
+export declare function inferArrayType(value: string, isConst: boolean, _depth?: number, keyConstants?: KeyConstants): string;
+/**
+ * Parse array elements handling nested structures
+ */
+export declare function parseArrayElements(content: string): string[];
+/**
+ * Infer object type from object literal
+ */
+export declare function inferObjectType(value: string, isConst: boolean, _depth?: number, keyConstants?: KeyConstants, resolve?: (value: string) => string): string;
+/** Infer calls whose callee can be referenced safely from declaration syntax. */
+export declare function inferCallType(value: string): string | null;
+/**
+ * Clean parameter defaults from function parameters
+ */
+export declare function cleanParameterDefaults(params: string): string;
+/**
+ * Find matching bracket for nested structures
+ */
+export declare function findMatchingBracket(str: string, start: number, openChar: string, closeChar: string): number;
+/**
+ * Infer function type from function expression
+ */
+export declare function inferFunctionType(value: string, inUnion?: boolean, _depth?: number, isConst?: boolean): string;
+/**
+ * Check if a type annotation is a generic/broad type that should be replaced with narrow inference
+ */
+export declare function isGenericType(typeAnnotation: string): boolean;
+/**
+ * Extract type from 'satisfies' operator
+ * e.g., "{ port: 3000 } satisfies { port: number }" returns "{ port: number }"
+ */
+export declare function extractSatisfiesType(value: string): string | null;
+/**
+ * Infer mapped type from type expression
+ * Handles patterns like { [K in keyof T]: V }
+ */
+export declare function inferMappedType(typeStr: string): string | null;
+/**
+ * Infer conditional type from type expression
+ * Handles patterns like T extends U ? X : Y
+ */
+export declare function inferConditionalType(typeStr: string): string | null;
+/**
+ * Infer template literal type from type expression
+ * Handles patterns like `${string}-${number}`
+ */
+export declare function inferTemplateLiteralTypeAdvanced(typeStr: string): string | null;
+/**
+ * Infer infer keyword usage in conditional types
+ * Handles patterns like T extends (infer U)[] ? U : never
+ */
+export declare function extractInferTypes(typeStr: string): string[];
+/**
+ * Check if a type uses advanced TypeScript features
+ */
+export declare function isComplexType(_typeStr: string): boolean;
+/**
+ * Simplify complex type for declaration output
+ * Returns simplified version if too complex
+ */
+export declare function simplifyComplexType(typeStr: string, maxDepth?: number): string;
+/**
+ * Parse utility type and extract its parameters
+ * Handles Partial<T>, Required<T>, Pick<T, K>, Omit<T, K>, etc.
+ */
+export declare function parseUtilityType(typeStr: string): { name: string, params: string[] } | null;
+/**
+ * Parse type parameters from a comma-separated string
+ * Handles nested types properly
+ */
+export declare function parseTypeParameters(paramsStr: string): string[];
+/**
+ * Infer keyof type
+ */
+export declare function inferKeyofType(typeStr: string): string | null;
+/**
+ * Infer typeof type
+ */
+export declare function inferTypeofType(typeStr: string): string | null;
+/**
+ * Check if type is an indexed access type
+ * e.g., T[K], Person['name']
+ */
+export declare function isIndexedAccessType(typeStr: string): boolean;

package/dist/src/processor/type-inference.js

@@ -0,0 +1,2 @@
+// @bun
+import{Rt,Mt,n,Ot,I,ke,oe,et,Te,ae,o,tt,Ae,j,Ta,Aa,Pa,Da,Ra,Ma,Oa,ca,Ia,Fa,La}from"../../chunk-8d3sdkv4.js";import"../../chunk-cv29b4zb.js";import"../../chunk-32qexm3w.js";import"../../chunk-0rmbc5zp.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{ae as cleanParameterDefaults,Mt as consumeCleanDefault,Rt as enableCleanDefaultCollection,Da as extractInferTypes,j as extractSatisfiesType,o as findMatchingBracket,ke as inferArrayType,Te as inferCallType,Aa as inferConditionalType,I as inferFunctionBodyReturnType,tt as inferFunctionType,Ia as inferKeyofType,Ta as inferMappedType,n as inferNarrowType,Ot as inferNarrowTypeInUnion,et as inferObjectType,Pa as inferTemplateLiteralTypeAdvanced,Fa as inferTypeofType,Ra as isComplexType,Ae as isGenericType,La as isIndexedAccessType,oe as parseArrayElements,ca as parseTypeParameters,Oa as parseUtilityType,Ma as simplifyComplexType};

package/dist/src/processor.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Processor module - re-exports from modular structure
+ * @deprecated Import from './processor/index' directly for better tree-shaking
+ */
+export * from './processor/index.js';