@idealyst/tooling 1.2.23 → 1.2.25

package/dist/analyzer/index.d.ts

@@ -0,0 +1,65 @@
+import { b as ComponentAnalyzerOptions, C as ComponentRegistry, T as ThemeValues } from '../types-CrlxbLFJ.js';
+export { d as ComponentCategory, a as ComponentDefinition, c as ControlledState, I as IdealystDocsPluginOptions, P as PropDefinition, S as SampleProps } from '../types-CrlxbLFJ.js';
+
+/**
+ * Component Analyzer - Extracts component prop definitions using TypeScript Compiler API.
+ *
+ * Analyzes:
+ * - types.ts files for prop interfaces
+ * - JSDoc comments for descriptions
+ * - Static .description properties on components
+ * - Theme-derived types (Intent, Size) resolved to actual values
+ */
+
+/**
+ * Analyze components and generate a registry.
+ */
+declare function analyzeComponents(options: ComponentAnalyzerOptions): ComponentRegistry;
+
+/**
+ * Theme Analyzer - Extracts theme keys by statically analyzing theme files.
+ *
+ * Uses TypeScript Compiler API to trace the declarative builder API:
+ * - createTheme() / fromTheme(base)
+ * - .addIntent('name', {...})
+ * - .addRadius('name', value)
+ * - .addShadow('name', {...})
+ * - .setSizes({ button: { xs: {}, sm: {}, ... }, ... })
+ * - .build()
+ */
+
+/**
+ * Extract theme values from a theme file.
+ */
+declare function analyzeTheme(themePath: string, verbose?: boolean): ThemeValues;
+/**
+ * Theme keys format expected by the Babel plugin.
+ * This is a subset of ThemeValues for backwards compatibility.
+ */
+interface BabelThemeKeys {
+    intents: string[];
+    sizes: Record<string, string[]>;
+    radii: string[];
+    shadows: string[];
+}
+/**
+ * Load theme keys for the Babel plugin.
+ * This is a compatibility wrapper around analyzeTheme() that:
+ * - Provides caching (only parses once per build)
+ * - Returns the subset of keys needed by the Babel plugin
+ * - Handles path resolution based on babel opts
+ *
+ * @param opts - Babel plugin options (requires themePath)
+ * @param rootDir - Root directory for path resolution
+ * @param _babelTypes - Unused (kept for backwards compatibility)
+ * @param verboseMode - Enable verbose logging
+ */
+declare function loadThemeKeys(opts: {
+    themePath?: string;
+}, rootDir: string, _babelTypes?: unknown, verboseMode?: boolean): BabelThemeKeys;
+/**
+ * Reset the theme cache. Useful for testing or hot reload.
+ */
+declare function resetThemeCache(): void;
+
+export { type BabelThemeKeys, ComponentAnalyzerOptions, ComponentRegistry, ThemeValues, analyzeComponents, analyzeTheme, loadThemeKeys, resetThemeCache };