@kimesh/auto-import 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,417 @@
+import MagicString from "magic-string";
+import { Plugin, PluginOption } from "vite";
+import { ComponentResolver } from "unplugin-vue-components";
+
+//#region src/types.d.ts
+/**
+ * @kimesh/auto-import - Type Definitions
+ */
+/**
+ * Import entry in the registry
+ */
+interface ImportEntry {
+  /** Export name (e.g., 'Button', 'useAuth') */
+  name: string;
+  /** Optional alias (import { x as alias }) */
+  as?: string;
+  /** Import source path */
+  from: string;
+  /** Import type */
+  type: 'component' | 'composable' | 'utility' | 'preset' | 'store';
+  /** Layer name or 'app' */
+  layer: string;
+  /** Priority (lower = higher priority) */
+  priority: number;
+  /** Is default export? */
+  isDefault: boolean;
+  /** Is type-only import? */
+  isType: boolean;
+}
+/**
+ * Conflict information
+ */
+interface ConflictReport {
+  /** Conflicting name */
+  name: string;
+  /** Winning import entry */
+  winner: ImportEntry;
+  /** Losing import entries */
+  losers: ImportEntry[];
+  /** Suggestion for resolution */
+  suggestion?: string;
+}
+/**
+ * Export information from scanned file
+ */
+interface ExportInfo {
+  /** Export name */
+  name: string;
+  /** Is default export? */
+  isDefault: boolean;
+  /** Is type-only export? */
+  isType: boolean;
+  /** Start position in source */
+  start: number;
+  /** End position in source */
+  end: number;
+}
+/**
+ * Scan result for a single file
+ */
+interface ScanResult {
+  /** File path */
+  filePath: string;
+  /** Content hash for cache invalidation */
+  fileHash: string;
+  /** Extracted exports */
+  exports: ExportInfo[];
+  /** Parse time in ms */
+  parseTime: number;
+}
+/**
+ * Import preset definition
+ */
+interface ImportPreset {
+  /** Preset name */
+  name: string;
+  /** Import source */
+  from: string;
+  /** Imports to include */
+  imports: Array<string | {
+    name: string;
+    type?: boolean;
+    as?: string;
+  }>;
+}
+/**
+ * Auto-import configuration
+ */
+interface AutoImportConfig {
+  /** Component directories to scan */
+  components?: {
+    dirs?: string[];
+    prefix?: string | false;
+    extensions?: string[];
+  };
+  /** Composable directories to scan */
+  composables?: {
+    dirs?: string[];
+    extensions?: string[];
+  };
+  /** Utility directories to scan */
+  utils?: {
+    dirs?: string[];
+    extensions?: string[];
+  };
+  /** Store directories to scan */
+  stores?: {
+    dirs?: string[];
+  };
+  /** Presets to enable */
+  presets?: Array<'vue' | 'vue-router' | 'tanstack-query' | 'pinia' | 'kimesh' | ImportPreset>;
+  /** Additional imports */
+  imports?: Array<{
+    from: string;
+    imports: string[];
+  }>;
+  /** Output directory for generated types */
+  dts?: string | false;
+}
+/**
+ * Layer auto-import source
+ */
+interface LayerAutoImportSource {
+  /** Layer name */
+  layer: string;
+  /** Layer priority */
+  priority: number;
+  /** Layer root path */
+  layerPath: string;
+  /** Config for this layer */
+  config: AutoImportConfig;
+}
+/**
+ * Import registry
+ */
+interface ImportRegistry {
+  /** All resolved imports */
+  imports: Map<string, ImportEntry>;
+  /** Components map (for Vue template auto-import) */
+  components: Map<string, ImportEntry>;
+  /** Conflicts detected */
+  conflicts: ConflictReport[];
+  /** Stats */
+  stats: {
+    totalScanned: number;
+    componentsCount: number;
+    composablesCount: number;
+    utilitiesCount: number;
+    presetsCount: number;
+    conflictsCount: number;
+    scanTimeMs: number;
+  };
+}
+/**
+ * Unresolved reference in source code
+ */
+interface UnresolvedReference {
+  /** Identifier name */
+  name: string;
+  /** Position in source */
+  start: number;
+  /** End position */
+  end: number;
+  /** Is it used as a type? */
+  isType: boolean;
+}
+/**
+ * Transform result
+ */
+interface TransformResult {
+  /** Transformed code */
+  code: string;
+  /** Source map */
+  map?: any;
+  /** Injected imports */
+  injectedImports: Array<{
+    name: string;
+    from: string;
+  }>;
+}
+/**
+ * Resolved layer info for generating .d.ts files
+ */
+interface ResolvedLayerInfo {
+  /** Layer name */
+  name: string;
+  /** Layer root path */
+  path: string;
+  /** Is this the host app? */
+  isApp: boolean;
+}
+/**
+ * Vite plugin options
+ */
+interface AutoImportPluginOptions {
+  /** Layer sources to scan (static) */
+  sources?: LayerAutoImportSource[];
+  /** Layer sources getter (lazy evaluation for async resolution) */
+  getSources?: () => LayerAutoImportSource[];
+  /** Resolved layers to generate .d.ts files into their .kimesh directories (static) */
+  layers?: ResolvedLayerInfo[];
+  /** Resolved layers getter (lazy evaluation for async resolution) */
+  getLayers?: () => ResolvedLayerInfo[];
+  /** Include patterns */
+  include?: string[];
+  /** Exclude patterns */
+  exclude?: string[];
+  /** Output directory for .d.ts files */
+  dts?: string | false;
+  /** Enable debug logging */
+  debug?: boolean;
+}
+//#endregion
+//#region src/scanner/oxc-scanner.d.ts
+declare class OxcExportScanner {
+  private cache;
+  scanFile(filePath: string): Promise<ScanResult>;
+  scanFiles(filePaths: string[]): Promise<ScanResult[]>;
+  private scanTsFile;
+  private scanVueFile;
+  private extractExports;
+  private extractNamedExports;
+  private extractDefaultExport;
+  private extractDeclarationNames;
+  private extractDefineExposeExports;
+  private walkAST;
+  private componentNameFromPath;
+  private hashContent;
+  invalidate(filePath: string): void;
+  clearCache(): void;
+  getCacheStats(): {
+    size: number;
+    version: string;
+  };
+}
+//#endregion
+//#region src/scanner/reference-detector.d.ts
+/**
+ * Reference detector using scope analysis
+ */
+declare class ReferenceDetector {
+  /**
+       * Detect unresolved references in TypeScript/JavaScript code
+       */
+  detectInScript(code: string, filePath: string): UnresolvedReference[];
+  /**
+       * Detect unresolved references in Vue SFC
+       */
+  detectInVue(code: string, filePath: string): UnresolvedReference[];
+  /**
+       * Detect unresolved references in parsed AST
+       */
+  private detectInAST;
+  /**
+       * Collect all declared identifiers in the scope
+       */
+  private collectDeclarations;
+  /**
+       * Collect names from binding patterns
+       */
+  private collectPatternNames;
+  /**
+       * Find references to undeclared identifiers
+       */
+  private findUnresolvedReferences;
+  /**
+       * Check if identifier is a property access (obj.prop)
+       */
+  private isPropertyAccess;
+  /**
+       * Check if identifier is a property key ({ key: value })
+       */
+  private isPropertyKey;
+  /**
+       * Check if identifier is a label reference
+       */
+  private isLabelReference;
+  /**
+       * Check if identifier is in type context
+       */
+  private isTypeContext;
+  /**
+       * Properties to skip when recursing
+       */
+  private shouldSkipProperty;
+}
+//#endregion
+//#region src/registry/builder.d.ts
+declare class RegistryBuilder {
+  private scanner;
+  private resolver;
+  build(sources: LayerAutoImportSource[]): Promise<ImportRegistry>;
+  private extractComponents;
+  private calculateStats;
+  private logBuildResults;
+  private processLayerSource;
+  private processPresets;
+  private processComponents;
+  private resolveComponentName;
+  private processDirectories;
+  private processAdditionalImports;
+  private scanDirectory;
+  private scanDirectoryRecursive;
+  invalidate(filePath: string): void;
+  clearCache(): void;
+}
+//#endregion
+//#region src/registry/conflict-resolver.d.ts
+declare class ConflictResolver {
+  private imports;
+  private resolved;
+  private conflicts;
+  addImport(entry: ImportEntry): void;
+  resolve(): {
+    resolved: Map<string, ImportEntry>;
+    conflicts: ConflictReport[];
+  };
+  private generateSuggestion;
+  getConflicts(): ConflictReport[];
+  hasConflict(name: string): boolean;
+  getConflict(name: string): ConflictReport | undefined;
+  clear(): void;
+}
+//#endregion
+//#region src/script/injector.d.ts
+interface InjectionResult {
+  code: string;
+  map: ReturnType<MagicString["generateMap"]>;
+  count: number;
+}
+declare class ImportInjector {
+  inject(code: string, imports: ImportEntry[], isVue: boolean): InjectionResult | null;
+  generateImportStatements(imports: ImportEntry[]): string;
+  private groupImportsBySource;
+  private categorizeImports;
+  findImportInsertionPoint(code: string, isVue: boolean): number;
+  private findVueScriptInsertionPoint;
+  private findJsInsertionPoint;
+  extractExistingImports(code: string, isVue: boolean): Set<string>;
+  private extractVueScriptContent;
+}
+//#endregion
+//#region src/script/plugin.d.ts
+interface ScriptPluginOptions extends AutoImportPluginOptions {
+  onRegistryUpdate?: (registry: ImportRegistry) => void;
+}
+declare function createScriptPlugin(options: ScriptPluginOptions): Plugin;
+//#endregion
+//#region src/template/resolver.d.ts
+interface KimeshResolverOptions {
+  getRegistry: () => ImportRegistry | null;
+  debug?: boolean;
+}
+declare function createKimeshResolver(options: KimeshResolverOptions): ComponentResolver;
+//#endregion
+//#region src/template/plugin.d.ts
+interface TemplatePluginOptions {
+  getRegistry: () => ImportRegistry | null;
+  dts?: string | false;
+  debug?: boolean;
+}
+declare function createTemplatePlugin(options: TemplatePluginOptions): Plugin;
+//#endregion
+//#region src/presets/index.d.ts
+/**
+ * Vue core preset
+ */
+declare const vuePreset: ImportPreset;
+/**
+ * Vue Router preset
+ */
+declare const vueRouterPreset: ImportPreset;
+/**
+ * TanStack Vue Query preset
+ */
+declare const tanstackQueryPreset: ImportPreset;
+/**
+ * Pinia preset
+ */
+declare const piniaPreset: ImportPreset;
+/**
+ * Kimesh runtime preset
+ */
+declare const kimeshPreset: ImportPreset;
+/**
+ * All built-in presets
+ */
+declare const builtinPresets: Record<string, ImportPreset>;
+/**
+ * Normalize preset configuration to ImportPreset
+ */
+declare function normalizePreset(preset: string | ImportPreset): ImportPreset | null;
+/**
+ * Get all enabled presets from configuration
+ */
+declare function resolvePresets(presets: Array<string | ImportPreset> | undefined): ImportPreset[];
+//#endregion
+//#region src/types/generator.d.ts
+declare function generateDtsFiles(registry: ImportRegistry, outputDir: string): Promise<void>;
+declare function generateSourceDts(source: string, entries: ImportEntry[]): string;
+//#endregion
+//#region src/vite/plugin.d.ts
+declare function autoImportPlugin(options: AutoImportPluginOptions): PluginOption[];
+declare const kimeshAutoImport: typeof autoImportPlugin;
+//#endregion
+//#region src/index.d.ts
+/**
+ * Build import registry from sources (convenience function)
+ */
+declare function buildImportRegistry(sources: LayerAutoImportSource[]): Promise<ImportRegistry>;
+/**
+ * Scan exports from a file (convenience function)
+ */
+declare function scanExports(filePath: string): Promise<ScanResult>;
+//#endregion
+export { type AutoImportConfig, type AutoImportPluginOptions, type ConflictReport, ConflictResolver, type ExportInfo, type ImportEntry, ImportInjector, type ImportPreset, type ImportRegistry, type InjectionResult, type KimeshResolverOptions, type LayerAutoImportSource, OxcExportScanner, ReferenceDetector, RegistryBuilder, type ResolvedLayerInfo, type ScanResult, type ScriptPluginOptions, type TemplatePluginOptions, type TransformResult, type UnresolvedReference, autoImportPlugin, autoImportPlugin as default, buildImportRegistry, builtinPresets, createTemplatePlugin as createComponentsPlugin, createTemplatePlugin, createKimeshResolver, createScriptPlugin, generateDtsFiles as generateDts, generateDtsFiles, generateSourceDts, kimeshAutoImport, kimeshPreset, normalizePreset, piniaPreset, resolvePresets, scanExports, tanstackQueryPreset, vuePreset, vueRouterPreset };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/scanner/oxc-scanner.ts","../src/scanner/reference-detector.ts","../src/registry/builder.ts","../src/registry/conflict-resolver.ts","../src/script/injector.ts","../src/script/plugin.ts","../src/template/resolver.ts","../src/template/plugin.ts","../src/presets/index.ts","../src/types/generator.ts","../src/vite/plugin.ts","../src/index.ts"],"mappings":"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"}