tailwind-styled-v4 5.1.21 → 5.1.23

package/dist/compiler.d.mts

@@ -1,3 +1,5 @@
+import { Plugin } from 'esbuild';
+
 /**
  * Native Bridge Wrapper Functions - Part of NativeBridge exports
  *
@@ -2938,6 +2940,198 @@ declare function buildRouteClassBuckets(root: string, srcDir: string, files: Sca
 /** Slugify route path jadi nama file CSS yang aman. "/" -> "root", "/blog/[slug]" -> "blog__slug_". */
 declare function routeToCssFilename(route: string): string;
 
+/**
+ * Semantic Component Analyzer
+ *
+ * Build-time analyzer untuk extract component metadata (@semantic, @aria, @state)
+ * dari component config dan determine semantic intent.
+ */
+/**
+ * Semantic intent type - represents semantic meaning ng component
+ */
+type SemanticIntent = 'button' | 'link' | 'navigation' | 'heading' | 'paragraph' | 'list' | 'input' | 'form' | 'dialog' | 'alert' | 'tab' | 'checkbox' | 'radio' | 'select' | 'custom';
+/**
+ * Semantic metadata annotations
+ */
+interface SemanticMetadata {
+    /**
+     * Semantic intent ng component (e.g., "button", "link")
+     * Guides ARIA role assignment at build-time
+     */
+    '@semantic'?: SemanticIntent;
+    /**
+     * Explicit ARIA attributes to inject
+     */
+    '@aria'?: Record<string, string>;
+    /**
+     * State-to-ARIA property mappings
+     * e.g., { checked: "aria-checked", disabled: "aria-disabled" }
+     */
+    '@state'?: Record<string, string>;
+    /**
+     * Custom semantic mappings
+     */
+    [key: string]: unknown;
+}
+/**
+ * Component config type - basic shape
+ */
+interface ComponentConfig {
+    tag?: string;
+    variants?: Record<string, unknown>;
+    defaultVariants?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Analysis result from semantic analyzer
+ */
+interface SemanticAnalysisResult {
+    componentName: string;
+    tag: string;
+    semantic: SemanticIntent;
+    metadata: SemanticMetadata;
+    ariaRole?: string;
+    stateProperties: Map<string, string>;
+}
+/**
+ * Extract semantic metadata from component config
+ * Looks for @semantic, @aria, @state annotations
+ */
+declare function extractSemanticMetadata(config: ComponentConfig): SemanticMetadata;
+/**
+ * Analyze component config untuk determine semantic intent
+ * Priority: explicit @semantic > tag-based inference
+ */
+declare function analyzeComponentSemantics(componentName: string, config: ComponentConfig): SemanticAnalysisResult;
+/**
+ * Get ARIA role from semantic intent
+ * Used by ARIA injection plugin at build-time
+ */
+declare function getAriaRoleForSemantic(semantic: SemanticIntent): string | undefined;
+/**
+ * Batch analyze multiple components
+ * Returns map of componentName → SemanticAnalysisResult
+ */
+declare function analyzeComponentBatch(components: Map<string, ComponentConfig>): Map<string, SemanticAnalysisResult>;
+/**
+ * Validate semantic metadata untuk consistency
+ * Returns array of validation issues (empty = valid)
+ */
+declare function validateSemanticMetadata(metadata: SemanticMetadata): string[];
+
+/**
+ * Type Stub Generator
+ *
+ * Build-time generator untuk create TypeScript .d.ts files dari semantic metadata.
+ * Generates type stubs dengan semantic information untuk better IDE intellisense.
+ */
+
+/**
+ * TypeScript interface definition untuk generated type
+ */
+interface GeneratedTypeDefinition {
+    interfaceName: string;
+    extendsFrom: string;
+    properties: Map<string, TypeProperty>;
+    jsDocComment?: string;
+}
+/**
+ * Individual property definition
+ */
+interface TypeProperty {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+}
+/**
+ * Generate .d.ts interface definition
+ */
+declare function generateTypeDefinition(analysis: SemanticAnalysisResult, componentName: string): GeneratedTypeDefinition;
+/**
+ * Render TypeScript interface code
+ */
+declare function renderTypeDefinition(def: GeneratedTypeDefinition): string;
+/**
+ * Generate complete .d.ts file content
+ * Includes imports, interfaces, exports
+ */
+declare function generateTypeStubFile(analyses: Map<string, SemanticAnalysisResult>, packageName?: string): string;
+/**
+ * Write type stub file ke disk
+ * Handles both ESM dan CJS output paths
+ */
+interface TypeStubOutput {
+    filePath: string;
+    content: string;
+    format: 'esm' | 'cjs' | 'dts';
+}
+/**
+ * Generate output paths untuk type stubs
+ */
+declare function generateTypeStubOutputPaths(outputDir: string, packageName: string): TypeStubOutput[];
+/**
+ * Batch generate type definitions dari multiple analyses
+ */
+declare function generateTypeDefinitionsBatch(analyses: Map<string, SemanticAnalysisResult>): Map<string, string>;
+/**
+ * Combine multiple type definitions into single file
+ */
+declare function combineTypeDefinitions(definitions: Map<string, string>, packageName?: string): string;
+
+/**
+ * Type Generation Plugin untuk tsup/build pipeline
+ *
+ * Integration point untuk run semantic analyzer + type generator
+ * sebagai part dari build process.
+ *
+ * Usage di tsup.config.ts:
+ * ```
+ * import { createTypeGenerationPlugin } from './src/typeGenerationPlugin'
+ *
+ * export default defineConfig({
+ *   plugins: [createTypeGenerationPlugin()],
+ *   ...
+ * })
+ * ```
+ */
+
+/**
+ * Options untuk type generation plugin
+ */
+interface TypeGenerationPluginOptions {
+    /**
+     * Directory dimana akan output .d.ts files
+     * Default: './dist/types'
+     */
+    outputDir?: string;
+    /**
+     * Package name untuk generated header
+     * Default: 'tailwind-styled'
+     */
+    packageName?: string;
+    /**
+     * Enable logging
+     * Default: false
+     */
+    verbose?: boolean;
+    /**
+     * Source file path untuk component registry
+     * Jika tidak provided, akan skip type generation
+     */
+    componentRegistryPath?: string;
+}
+/**
+ * Create tsup plugin untuk type generation
+ * Runs at build-time to generate .d.ts files dari semantic metadata
+ */
+declare function createTypeGenerationPlugin(options?: TypeGenerationPluginOptions): Plugin;
+/**
+ * Standalone function untuk generate types from components
+ * Useful untuk scripts atau CLI
+ */
+declare function generateTypesFromComponents(components: Map<string, ComponentConfig>, outputPath: string, packageName?: string): Promise<void>;
+
 /**
  * tailwind-styled-v5 — Compiler Main Entry Point
  *
@@ -3079,4 +3273,4 @@ declare const extractTwStateConfigs: (source: string, filename: string) => TwSta
 declare const generateStaticStateCss: (entries: TwStateConfigEntry[], resolvedCssOrThemeConfig?: string | Record<string, unknown>) => GeneratedStateRule[];
 declare const extractAndGenerateStateCss: (source: string, filename: string) => GeneratedStateRule[];
 
-export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MemoryRecommendations, type MemoryStats, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type OptimalCacheConfigAnalysis, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type ResolverPoolStatsResult, type RouteClassBuckets, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type ScannedFileInput, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, type Week6FeaturesStatus, adaptNativeResult, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeFile, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildRouteClassBuckets, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearResolverPool, clearThemeCache, collectFiles, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTableNative, computeIncrementalDiff, createFingerprint, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, estimateOptimalCacheConfigNative, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCss, generateCssBatch, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, getAllRegisteredClasses, getAllRoutes, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getMemoryRecommendationsNative, getMemoryStatsNative, getNativeBridge, getPluginHooks, getResolverPoolStats, getRouteClasses, getWatchStats, getWeek6FeaturesStatus, hasTwUsage, hashContent, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCssNative, parseAtomicClass, parseClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, resetBucketEngine, resetCacheStats, resetCompilationMetrics, resetIncrementalEngine, resetMemoryStats, resetNativeBridgeCache, resetResolverPoolStats, resetRouteClassRegistry, resolveCascade, resolveClassNames, resolveColorCached, resolveConflictGroup, resolveFontSizeCached, resolveSimpleVariants, resolveSpacingCached, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, routeToCssFilename, runCssPipeline, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };
+export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentConfig, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type GeneratedTypeDefinition, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MemoryRecommendations, type MemoryStats, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type OptimalCacheConfigAnalysis, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type ResolverPoolStatsResult, type RouteClassBuckets, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type ScannedFileInput, type SemanticAnalysisResult, type SemanticIntent, type SemanticMetadata, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type TypeGenerationPluginOptions, type TypeProperty, type TypeStubOutput, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, type Week6FeaturesStatus, adaptNativeResult, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeComponentBatch, analyzeComponentSemantics, analyzeFile, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildRouteClassBuckets, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearResolverPool, clearThemeCache, collectFiles, combineTypeDefinitions, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTableNative, computeIncrementalDiff, createFingerprint, createTypeGenerationPlugin, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, estimateOptimalCacheConfigNative, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractSemanticMetadata, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCss, generateCssBatch, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, generateTypeDefinition, generateTypeDefinitionsBatch, generateTypeStubFile, generateTypeStubOutputPaths, generateTypesFromComponents, getAllRegisteredClasses, getAllRoutes, getAriaRoleForSemantic, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getMemoryRecommendationsNative, getMemoryStatsNative, getNativeBridge, getPluginHooks, getResolverPoolStats, getRouteClasses, getWatchStats, getWeek6FeaturesStatus, hasTwUsage, hashContent, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCssNative, parseAtomicClass, parseClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, renderTypeDefinition, resetBucketEngine, resetCacheStats, resetCompilationMetrics, resetIncrementalEngine, resetMemoryStats, resetNativeBridgeCache, resetResolverPoolStats, resetRouteClassRegistry, resolveCascade, resolveClassNames, resolveColorCached, resolveConflictGroup, resolveFontSizeCached, resolveSimpleVariants, resolveSpacingCached, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, routeToCssFilename, runCssPipeline, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateSemanticMetadata, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };

package/dist/compiler.d.ts

@@ -1,3 +1,5 @@
+import { Plugin } from 'esbuild';
+
 /**
  * Native Bridge Wrapper Functions - Part of NativeBridge exports
  *
@@ -2938,6 +2940,198 @@ declare function buildRouteClassBuckets(root: string, srcDir: string, files: Sca
 /** Slugify route path jadi nama file CSS yang aman. "/" -> "root", "/blog/[slug]" -> "blog__slug_". */
 declare function routeToCssFilename(route: string): string;
 
+/**
+ * Semantic Component Analyzer
+ *
+ * Build-time analyzer untuk extract component metadata (@semantic, @aria, @state)
+ * dari component config dan determine semantic intent.
+ */
+/**
+ * Semantic intent type - represents semantic meaning ng component
+ */
+type SemanticIntent = 'button' | 'link' | 'navigation' | 'heading' | 'paragraph' | 'list' | 'input' | 'form' | 'dialog' | 'alert' | 'tab' | 'checkbox' | 'radio' | 'select' | 'custom';
+/**
+ * Semantic metadata annotations
+ */
+interface SemanticMetadata {
+    /**
+     * Semantic intent ng component (e.g., "button", "link")
+     * Guides ARIA role assignment at build-time
+     */
+    '@semantic'?: SemanticIntent;
+    /**
+     * Explicit ARIA attributes to inject
+     */
+    '@aria'?: Record<string, string>;
+    /**
+     * State-to-ARIA property mappings
+     * e.g., { checked: "aria-checked", disabled: "aria-disabled" }
+     */
+    '@state'?: Record<string, string>;
+    /**
+     * Custom semantic mappings
+     */
+    [key: string]: unknown;
+}
+/**
+ * Component config type - basic shape
+ */
+interface ComponentConfig {
+    tag?: string;
+    variants?: Record<string, unknown>;
+    defaultVariants?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Analysis result from semantic analyzer
+ */
+interface SemanticAnalysisResult {
+    componentName: string;
+    tag: string;
+    semantic: SemanticIntent;
+    metadata: SemanticMetadata;
+    ariaRole?: string;
+    stateProperties: Map<string, string>;
+}
+/**
+ * Extract semantic metadata from component config
+ * Looks for @semantic, @aria, @state annotations
+ */
+declare function extractSemanticMetadata(config: ComponentConfig): SemanticMetadata;
+/**
+ * Analyze component config untuk determine semantic intent
+ * Priority: explicit @semantic > tag-based inference
+ */
+declare function analyzeComponentSemantics(componentName: string, config: ComponentConfig): SemanticAnalysisResult;
+/**
+ * Get ARIA role from semantic intent
+ * Used by ARIA injection plugin at build-time
+ */
+declare function getAriaRoleForSemantic(semantic: SemanticIntent): string | undefined;
+/**
+ * Batch analyze multiple components
+ * Returns map of componentName → SemanticAnalysisResult
+ */
+declare function analyzeComponentBatch(components: Map<string, ComponentConfig>): Map<string, SemanticAnalysisResult>;
+/**
+ * Validate semantic metadata untuk consistency
+ * Returns array of validation issues (empty = valid)
+ */
+declare function validateSemanticMetadata(metadata: SemanticMetadata): string[];
+
+/**
+ * Type Stub Generator
+ *
+ * Build-time generator untuk create TypeScript .d.ts files dari semantic metadata.
+ * Generates type stubs dengan semantic information untuk better IDE intellisense.
+ */
+
+/**
+ * TypeScript interface definition untuk generated type
+ */
+interface GeneratedTypeDefinition {
+    interfaceName: string;
+    extendsFrom: string;
+    properties: Map<string, TypeProperty>;
+    jsDocComment?: string;
+}
+/**
+ * Individual property definition
+ */
+interface TypeProperty {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+}
+/**
+ * Generate .d.ts interface definition
+ */
+declare function generateTypeDefinition(analysis: SemanticAnalysisResult, componentName: string): GeneratedTypeDefinition;
+/**
+ * Render TypeScript interface code
+ */
+declare function renderTypeDefinition(def: GeneratedTypeDefinition): string;
+/**
+ * Generate complete .d.ts file content
+ * Includes imports, interfaces, exports
+ */
+declare function generateTypeStubFile(analyses: Map<string, SemanticAnalysisResult>, packageName?: string): string;
+/**
+ * Write type stub file ke disk
+ * Handles both ESM dan CJS output paths
+ */
+interface TypeStubOutput {
+    filePath: string;
+    content: string;
+    format: 'esm' | 'cjs' | 'dts';
+}
+/**
+ * Generate output paths untuk type stubs
+ */
+declare function generateTypeStubOutputPaths(outputDir: string, packageName: string): TypeStubOutput[];
+/**
+ * Batch generate type definitions dari multiple analyses
+ */
+declare function generateTypeDefinitionsBatch(analyses: Map<string, SemanticAnalysisResult>): Map<string, string>;
+/**
+ * Combine multiple type definitions into single file
+ */
+declare function combineTypeDefinitions(definitions: Map<string, string>, packageName?: string): string;
+
+/**
+ * Type Generation Plugin untuk tsup/build pipeline
+ *
+ * Integration point untuk run semantic analyzer + type generator
+ * sebagai part dari build process.
+ *
+ * Usage di tsup.config.ts:
+ * ```
+ * import { createTypeGenerationPlugin } from './src/typeGenerationPlugin'
+ *
+ * export default defineConfig({
+ *   plugins: [createTypeGenerationPlugin()],
+ *   ...
+ * })
+ * ```
+ */
+
+/**
+ * Options untuk type generation plugin
+ */
+interface TypeGenerationPluginOptions {
+    /**
+     * Directory dimana akan output .d.ts files
+     * Default: './dist/types'
+     */
+    outputDir?: string;
+    /**
+     * Package name untuk generated header
+     * Default: 'tailwind-styled'
+     */
+    packageName?: string;
+    /**
+     * Enable logging
+     * Default: false
+     */
+    verbose?: boolean;
+    /**
+     * Source file path untuk component registry
+     * Jika tidak provided, akan skip type generation
+     */
+    componentRegistryPath?: string;
+}
+/**
+ * Create tsup plugin untuk type generation
+ * Runs at build-time to generate .d.ts files dari semantic metadata
+ */
+declare function createTypeGenerationPlugin(options?: TypeGenerationPluginOptions): Plugin;
+/**
+ * Standalone function untuk generate types from components
+ * Useful untuk scripts atau CLI
+ */
+declare function generateTypesFromComponents(components: Map<string, ComponentConfig>, outputPath: string, packageName?: string): Promise<void>;
+
 /**
  * tailwind-styled-v5 — Compiler Main Entry Point
  *
@@ -3079,4 +3273,4 @@ declare const extractTwStateConfigs: (source: string, filename: string) => TwSta
 declare const generateStaticStateCss: (entries: TwStateConfigEntry[], resolvedCssOrThemeConfig?: string | Record<string, unknown>) => GeneratedStateRule[];
 declare const extractAndGenerateStateCss: (source: string, filename: string) => GeneratedStateRule[];
 
-export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MemoryRecommendations, type MemoryStats, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type OptimalCacheConfigAnalysis, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type ResolverPoolStatsResult, type RouteClassBuckets, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type ScannedFileInput, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, type Week6FeaturesStatus, adaptNativeResult, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeFile, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildRouteClassBuckets, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearResolverPool, clearThemeCache, collectFiles, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTableNative, computeIncrementalDiff, createFingerprint, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, estimateOptimalCacheConfigNative, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCss, generateCssBatch, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, getAllRegisteredClasses, getAllRoutes, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getMemoryRecommendationsNative, getMemoryStatsNative, getNativeBridge, getPluginHooks, getResolverPoolStats, getRouteClasses, getWatchStats, getWeek6FeaturesStatus, hasTwUsage, hashContent, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCssNative, parseAtomicClass, parseClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, resetBucketEngine, resetCacheStats, resetCompilationMetrics, resetIncrementalEngine, resetMemoryStats, resetNativeBridgeCache, resetResolverPoolStats, resetRouteClassRegistry, resolveCascade, resolveClassNames, resolveColorCached, resolveConflictGroup, resolveFontSizeCached, resolveSimpleVariants, resolveSpacingCached, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, routeToCssFilename, runCssPipeline, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };
+export { type BatchExtractResult, BucketEngine, type CacheOptimizationHints, type CacheStatistics, type ClassExtractResult, type ClassUsageItem, type ClassifyResult, type CompiledAnimation, type CompiledCssRule, type CompiledTheme, type ComponentConfig, type ComponentMetadata, type ConflictGroupInfo, type ContainerConfig, type CssCompileResult, type DeadCodeResult, type FileChangeEvent, type FileDiff, type FileFingerprint, type GeneratedStateCss, type GeneratedStateRule, type GeneratedTypeDefinition, type HoistResult, type IncrementalDiffResult, IncrementalEngine, type KeyExpiration, type LoaderOutput, type MemoryRecommendations, type MemoryStats, type MergeResult, type NativeBridge, type NativeRscResult, type NativeTransformResult, type OptimalCacheConfig, type OptimalCacheConfigAnalysis, type PoolInfo, type PrefilterFileResult, type ProcessedCssResult, type ProcessedFileChange, type PruneResult, type PubSubMessage, type RebuildWorkspaceResult, type RedisCacheConfig, type RedisClusterNode, type RedisClusterStatus, type RedisPoolStats, type RegistrySnapshot, type ResolvedClassName, type ResolvedVariantConfig, type ResolverPoolStatsResult, type RouteClassBuckets, type SafelistCheckResult, type ScanFileResult, type ScanWorkspaceResult, type ScannedFileInput, type SemanticAnalysisResult, type SemanticIntent, type SemanticMetadata, type StateCssConfig, type StateInjectionResult, type StaticStateCssInput, type ThemeCascadeResult, type ThemeValidationResult, type TwMergeOptions, type TwStateConfigEntry, type TypeGenerationPluginOptions, type TypeProperty, type TypeStubOutput, type VariantTableResult, type WatchEvent, type WatchHandle, type WatchStats, type Week6FeaturesStatus, adaptNativeResult, analyzeClassUsageNative, analyzeClasses, analyzeClassesNative, analyzeComponentBatch, analyzeComponentSemantics, analyzeFile, analyzeRscNative, analyzeVariantUsage, astExtractClasses, atomicRegistrySize, batchExtractClasses, batchExtractClassesNative, bucketSort, buildRouteClassBuckets, buildStyleTag, cachePriority, cacheRead, cacheWrite, checkAgainstSafelist, checkAgainstSafelistNative, classifyAndSortClassesNative, classifyNode, clearAllCaches, clearAtomicRegistry, clearCompileCache, clearCssGenCache, clearParseCache, clearResolveCache, clearResolverPool, clearThemeCache, collectFiles, combineTypeDefinitions, compileAnimation, compileClass, compileClasses, compileCssFromClasses, compileCssLightning, compileCssNative2, compileKeyframes, compileTheme, compileToCss, compileToCssBatch, compileVariantTableNative, computeIncrementalDiff, createFingerprint, createTypeGenerationPlugin, detectConflicts, detectDeadCode, diffClassLists, eliminateDeadCss, eliminateDeadCssNative, emitPluginHook, estimateOptimalCacheConfig, estimateOptimalCacheConfigNative, extractAllClasses, extractAndGenerateStateCss, extractAndGenerateStateCssNative, extractClassesFromSource, extractClassesFromSourceNative, extractComponentUsage, extractContainerCssFromSource, extractSemanticMetadata, extractTwContainerConfigs, extractTwStateConfigs, extractTwStateConfigsNative, fileToRoute, findDeadVariants, generateAtomicCss, generateCss, generateCssBatch, generateCssForClasses, generateCssNative, generateSafelist, generateStaticStateCss, generateStaticStateCssNative, generateSubComponentTypes, generateTypeDefinition, generateTypeDefinitionsBatch, generateTypeStubFile, generateTypeStubOutputPaths, generateTypesFromComponents, getAllRegisteredClasses, getAllRoutes, getAriaRoleForSemantic, getBucketEngine, getCacheOptimizationHints, getCacheStatistics, getCacheStats, getCompilationMetrics, getCompilerDiagnostics, getContentPaths, getIncrementalEngine, getMemoryRecommendationsNative, getMemoryStatsNative, getNativeBridge, getPluginHooks, getResolverPoolStats, getRouteClasses, getWatchStats, getWeek6FeaturesStatus, hasTwUsage, hashContent, hoistComponentsNative, idRegistryActiveCount, idRegistryCreate, idRegistryDestroy, idRegistryExport, idRegistryGenerate, idRegistryImport, idRegistryLookup, idRegistryNext, idRegistryReset, idRegistrySnapshot, injectClientDirective, injectServerOnlyComment, injectStateHash, isAlreadyTransformed, isWatchRunning, layoutClassesToCss, loadSafelist, loadTailwindConfig, mergeClassesStatic, mergeCssDeclarationsNative, minifyCss, normalizeAndDedupClasses, normalizeClasses, optimizeCssNative, parseAtomicClass, parseClass, parseClasses, pollWatchEvents, processFileChange, processTailwindCssLightning, propertyIdToString, pruneStaleCacheEntries, rebuildWorkspaceResult, redisCacheClear, redisCacheHitRate, redisCacheKeyCount, redisCacheSize, redisCacheSync, redisClusterStatus, redisDelete, redisDiagnose, redisDisableCacheWarming, redisDisableCluster, redisDisablePersistence, redisEnableCacheWarming, redisEnableCluster, redisEnablePersistence, redisExists, redisExpirationGet, redisExpirationSet, redisFlushAll, redisFlushDb, redisGet, redisGetEvictionPolicy, redisInfo, redisMemoryStats, redisMget, redisMonitor, redisMset, redisOptimizeMemory, redisPing, redisPoolConnect, redisPoolReconnect, redisPoolStats, redisPublish, redisReplicate, redisReplicationStatus, redisSet, redisSetEvictionPolicy, redisSnapshot, redisSubscribe, registerFileClasses, registerGlobalClasses, registerPluginHook, registerPropertyName, registerValueName, renderTypeDefinition, resetBucketEngine, resetCacheStats, resetCompilationMetrics, resetIncrementalEngine, resetMemoryStats, resetNativeBridgeCache, resetResolverPoolStats, resetRouteClassRegistry, resolveCascade, resolveClassNames, resolveColorCached, resolveConflictGroup, resolveFontSizeCached, resolveSimpleVariants, resolveSpacingCached, resolveThemeValue, resolveVariants, reverseLookupProperty, reverseLookupValue, routeToCssFilename, runCssPipeline, runElimination, runLoaderTransform, scanCacheOptimizations, scanFile, scanFileNative, scanFilesBatchNative, scanProjectUsage, scanWorkspace, shouldProcess, shouldSkipFile, startWatch, stopWatch, toAtomicClasses, transformSource, twMerge, twMergeMany, twMergeManyWithSeparator, twMergeRaw, twMergeWithSeparator, unregisterPluginHook, validateCssOutput, validateSemanticMetadata, validateThemeConfig, valueIdToString, walkAndPrefilterSourceFiles, watchAddPattern, watchClearAll, watchEventTypeToString, watchGetActiveHandles, watchPause, watchRemovePattern, watchResume };