@dtsx/dtsx 0.0.0-stage → 0.11.37

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,ma,Yn,ga}from"../../chunk-sq34kkhy.js";import"../../chunk-0azm93j9.js";import"../../chunk-psrgw9f8.js";import"../../chunk-nn9tpxx3.js";import"../../chunk-acyj1dev.js";import"../../chunk-wzcwctba.js";import"../../chunk-p2qz2nk2.js";import"../../chunk-bqabznps.js";import"../../chunk-s0mvstt0.js";import"../../chunk-79nv7twc.js";import"../../chunk-n37yj3xv.js";import"../../chunk-aw48mk3t.js";import"../../chunk-853ftm92.js";import"../../chunk-xb92nrsm.js";import"../../chunk-v44crx69.js";import"../../chunk-n94729d9.js";import"../../chunk-w9av39jy.js";import"../../chunk-vae5wxar.js";import"../../chunk-t1jtn2r0.js";import"../../chunk-60ssvwc8.js";import"../../chunk-vtskg4r2.js";import"../../chunk-qnf4byak.js";import"../../chunk-1pz7zxhc.js";import"../../chunk-pga5m4wm.js";import"../../chunk-25vyhfzh.js";import"../../chunk-mt9219xc.js";import"../../chunk-ezbp8tss.js";import"../../chunk-v6fwy63g.js";import"../../chunk-cs4gwz1k.js";import"../../chunk-ttc5pr8y.js";import"../../chunk-xr1h3tv2.js";import"../../chunk-gsb3ty07.js";import"../../chunk-s6c98nad.js";import"../../chunk-z4mvkazp.js";import"../../chunk-g9d5r6a8.js";import"../../chunk-wnk9yjw2.js";import"../../chunk-gpq2kggq.js";import"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-j6pfxvy8.js";import"../../chunk-2kwjbk55.js";import"../../chunk-69dbf6de.js";import"../../chunk-cen2t56g.js";import"../../chunk-d43bpfk6.js";import"../../chunk-rmdwvzgn.js";import"../../chunk-pzedkn7z.js";import"../../chunk-km8t8gqg.js";import"../../chunk-dfye109x.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{ga as default,Yn as dts,le as dtsxPlugin,ma 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,da,pa}from"../../chunk-xsf941gw.js";import"../../chunk-0azm93j9.js";import"../../chunk-psrgw9f8.js";import"../../chunk-nn9tpxx3.js";import"../../chunk-acyj1dev.js";import"../../chunk-wzcwctba.js";import"../../chunk-p2qz2nk2.js";import"../../chunk-bqabznps.js";import"../../chunk-s0mvstt0.js";import"../../chunk-79nv7twc.js";import"../../chunk-n37yj3xv.js";import"../../chunk-aw48mk3t.js";import"../../chunk-853ftm92.js";import"../../chunk-xb92nrsm.js";import"../../chunk-v44crx69.js";import"../../chunk-n94729d9.js";import"../../chunk-w9av39jy.js";import"../../chunk-vae5wxar.js";import"../../chunk-t1jtn2r0.js";import"../../chunk-60ssvwc8.js";import"../../chunk-vtskg4r2.js";import"../../chunk-qnf4byak.js";import"../../chunk-1pz7zxhc.js";import"../../chunk-pga5m4wm.js";import"../../chunk-25vyhfzh.js";import"../../chunk-mt9219xc.js";import"../../chunk-ezbp8tss.js";import"../../chunk-v6fwy63g.js";import"../../chunk-cs4gwz1k.js";import"../../chunk-ttc5pr8y.js";import"../../chunk-xr1h3tv2.js";import"../../chunk-gsb3ty07.js";import"../../chunk-s6c98nad.js";import"../../chunk-z4mvkazp.js";import"../../chunk-g9d5r6a8.js";import"../../chunk-wnk9yjw2.js";import"../../chunk-gpq2kggq.js";import"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-j6pfxvy8.js";import"../../chunk-2kwjbk55.js";import"../../chunk-69dbf6de.js";import"../../chunk-cen2t56g.js";import"../../chunk-d43bpfk6.js";import"../../chunk-rmdwvzgn.js";import"../../chunk-pzedkn7z.js";import"../../chunk-km8t8gqg.js";import"../../chunk-dfye109x.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{pa as default,Ie as dts,da 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-7610h2tf.js";import"../../chunk-0azm93j9.js";import"../../chunk-psrgw9f8.js";import"../../chunk-nn9tpxx3.js";import"../../chunk-acyj1dev.js";import"../../chunk-wzcwctba.js";import"../../chunk-p2qz2nk2.js";import"../../chunk-bqabznps.js";import"../../chunk-s0mvstt0.js";import"../../chunk-79nv7twc.js";import"../../chunk-n37yj3xv.js";import"../../chunk-aw48mk3t.js";import"../../chunk-853ftm92.js";import"../../chunk-xb92nrsm.js";import"../../chunk-v44crx69.js";import"../../chunk-n94729d9.js";import"../../chunk-w9av39jy.js";import"../../chunk-vae5wxar.js";import"../../chunk-t1jtn2r0.js";import"../../chunk-60ssvwc8.js";import"../../chunk-vtskg4r2.js";import"../../chunk-qnf4byak.js";import"../../chunk-1pz7zxhc.js";import"../../chunk-pga5m4wm.js";import"../../chunk-25vyhfzh.js";import"../../chunk-mt9219xc.js";import"../../chunk-ezbp8tss.js";import"../../chunk-v6fwy63g.js";import"../../chunk-cs4gwz1k.js";import"../../chunk-ttc5pr8y.js";import"../../chunk-xr1h3tv2.js";import"../../chunk-gsb3ty07.js";import"../../chunk-s6c98nad.js";import"../../chunk-z4mvkazp.js";import"../../chunk-g9d5r6a8.js";import"../../chunk-wnk9yjw2.js";import"../../chunk-gpq2kggq.js";import"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-j6pfxvy8.js";import"../../chunk-2kwjbk55.js";import"../../chunk-69dbf6de.js";import"../../chunk-cen2t56g.js";import"../../chunk-d43bpfk6.js";import"../../chunk-rmdwvzgn.js";import"../../chunk-pzedkn7z.js";import"../../chunk-km8t8gqg.js";import"../../chunk-dfye109x.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{de,xo,H,Co,vo,So}from"../chunk-wzcwctba.js";export{de as PluginManager,vo as createBannerPlugin,So as createFilterPlugin,H as definePlugin,xo as pluginManager,Co 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{Ue,bt,oi,ai,ci,Ca,gn}from"../chunk-n94729d9.js";import"../chunk-w9av39jy.js";import"../chunk-t1jtn2r0.js";import"../chunk-60ssvwc8.js";import"../chunk-vtskg4r2.js";import"../chunk-25vyhfzh.js";import"../chunk-mt9219xc.js";import"../chunk-v6fwy63g.js";import"../chunk-ttc5pr8y.js";import"../chunk-xr1h3tv2.js";import"../chunk-gsb3ty07.js";import"../chunk-s6c98nad.js";import"../chunk-z4mvkazp.js";import"../chunk-g9d5r6a8.js";import"../chunk-wnk9yjw2.js";import"../chunk-gpq2kggq.js";import"../chunk-90aptjh6.js";import"../chunk-rdzfdjkb.js";import"../chunk-n2nyd0ck.js";import"../chunk-j6pfxvy8.js";import"../chunk-2kwjbk55.js";import"../chunk-69dbf6de.js";import"../chunk-cen2t56g.js";import"../chunk-1j6092xz.js";import"../chunk-zq93f8ca.js";export{ci as clearResultCache,Ue as emitNatively,bt as processSource,Ca as processSourceDirect,oi as processSourceIsolated,ai as processSourceSemantic,gn 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,Ln,Nn,Bn}from"../../chunk-gpq2kggq.js";export{Bn as clearProcessorCaches,ka as getCachedRegex,Ln as getImportItemsFromCache,Nn 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{u,Te}from"../../chunk-rdzfdjkb.js";export{Te as escapeJsdocContent,u 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{X,g,Z,Q,ee,te,Dn,Rn,ne}from"../../chunk-s6c98nad.js";import"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-69dbf6de.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{ee as processClassDeclaration,te as processEnumDeclaration,Rn as processExportDeclaration,X as processFunctionDeclaration,Dn as processImportDeclaration,Z as processInterfaceDeclaration,ne as processModuleDeclaration,Q as processTypeDeclaration,g 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{we}from"../../chunk-vtskg4r2.js";import"../../chunk-s6c98nad.js";import"../../chunk-wnk9yjw2.js";import"../../chunk-gpq2kggq.js";import"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-69dbf6de.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{we 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{Se,Fn,h,y,Sa,xi,$a,Ea}from"../../chunk-wnk9yjw2.js";import"../../chunk-gpq2kggq.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{$a as convertToTypeOnlyImport,h as extractAllImportedItems,Se as getImportSourceLiteral,xi as isTypeOnlyImportItem,Ea as mergeImports,Sa as parseExportDetailed,y as parseImportDetailed,Fn 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-t1jtn2r0.js";import"../../chunk-60ssvwc8.js";import"../../chunk-vtskg4r2.js";import{X,g,Z,Q,ee,te,Dn,Rn,ne}from"../../chunk-s6c98nad.js";import{Fn,h}from"../../chunk-wnk9yjw2.js";import{Bn}from"../../chunk-gpq2kggq.js";import{n,Rt,$e,re,Ze,o,Qe,ke,W}from"../../chunk-90aptjh6.js";import{u}from"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-j6pfxvy8.js";import"../../chunk-2kwjbk55.js";import"../../chunk-69dbf6de.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{Bn as clearProcessorCaches,h as extractAllImportedItems,W as extractSatisfiesType,o as findMatchingBracket,u as formatComments,$e as inferArrayType,Qe as inferFunctionType,n as inferNarrowType,Rt as inferNarrowTypeInUnion,Ze as inferObjectType,ke as isGenericType,re as parseArrayElements,Fn as parseImportStatement,ee as processClassDeclaration,l as processDeclarations,te as processEnumDeclaration,Rn as processExportDeclaration,X as processFunctionDeclaration,Dn as processImportDeclaration,Z as processInterfaceDeclaration,ne as processModuleDeclaration,Q as processTypeDeclaration,g 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{Pt,Dt,n,Rt,O,$e,re,Ze,Ee,ie,o,Qe,ke,W,Ta,Aa,Pa,Da,Ra,Ma,Oa,ea,Ia,Fa,La}from"../../chunk-90aptjh6.js";import"../../chunk-rdzfdjkb.js";import"../../chunk-n2nyd0ck.js";import"../../chunk-69dbf6de.js";import"../../chunk-1j6092xz.js";import"../../chunk-zq93f8ca.js";export{ie as cleanParameterDefaults,Dt as consumeCleanDefault,Pt as enableCleanDefaultCollection,Da as extractInferTypes,W as extractSatisfiesType,o as findMatchingBracket,$e as inferArrayType,Ee as inferCallType,Aa as inferConditionalType,O as inferFunctionBodyReturnType,Qe as inferFunctionType,Ia as inferKeyofType,Ta as inferMappedType,n as inferNarrowType,Rt as inferNarrowTypeInUnion,Ze as inferObjectType,Pa as inferTemplateLiteralTypeAdvanced,Fa as inferTypeofType,Ra as isComplexType,ke as isGenericType,La as isIndexedAccessType,re as parseArrayElements,ea 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';