@dsai-io/tools 1.0.7 → 1.1.0

package/dist/index.d.cts

@@ -1,14 +1,223 @@
-export { B as BuildSummary, m as CustomFilter, k as CustomFormat, l as CustomPreprocessor, C as CustomTransform, q as Dictionary, D as DsaiConfig, r as FileConfig, p as FormatArgs, d as FrameworkMappingConfig, e as FrameworkMappingPattern, F as FrameworkTarget, G as GlobalConfig, u as IconFramework, I as IconsConfig, L as LoadConfigOptions, s as LoadConfigResult, t as LogLevel, O as OutputFormat, P as Platform, R as ResolvedConfig, f as ResolvedGlobalConfig, h as ResolvedIconsConfig, j as ResolvedThemeDefinition, i as ResolvedThemesConfig, g as ResolvedTokensConfig, S as ScssOutputConfig, b as ThemeDefinition, c as ThemeSelectorPattern, a as ThemesConfig, n as TokenData, T as TokensConfig, o as TransformOptions } from './types-DabOzcsj.cjs';
-export { CONFIG_FILE_NAMES, ConfigFormat, DEFAULT_COLLECTIONS_DIR, DEFAULT_ICONS_OUTPUT_DIR, DEFAULT_ICONS_SOURCE_DIR, DEFAULT_LOG_LEVEL, DEFAULT_OUTPUT_DIR, DEFAULT_PREFIX, DEFAULT_SOURCE_DIR, DsaiConfigFromSchema, EnvParseOptions, FrameworkFromSchema, GlobalConfigFromSchema, IconsConfigFromSchema, LogLevelFromSchema, MigrationCheck, OutputFormatFromSchema, ResolveOptions, ThemesConfigFromSchema, TokensConfigFromSchema, ValidationError, ValidationResult, buildConfigSchema, checkDeprecatedOptions, checkMigrationNeeded, clearConfigCache, createResolvedConfig, customFormatSchema, customTransformSchema, defaultConfig, defaultFormats, defaultGlobalConfig, defaultIconFramework, defaultIconsConfig, defaultOutputFileNames, defaultSelectorPattern, defaultSourcePatterns, defaultThemesConfig, defaultTokensConfig, defineConfig, defineConfigAsync, dsaiConfigSchema, envArrayKeys, envBooleanKeys, envMappings, envNumberKeys, filePathSchema, formatErrorMessage, formatValidationErrors, frameworkSchema, generateMigrationScript, getConfigFromEnv, getDefaultExtension, getDefaultOutputDir, getEnvOverrides, getLogLevelFromEnv, getOutputFileName, globPatternSchema, globalConfigSchema, hashTypeSchema, iconOptimizationSchema, iconSpriteSchema, iconsConfigSchema, isCI, loadConfig, loadConfigSync, logLevelSchema, mergeConfigs, migrateConfig, migrateLegacyTokensConfig, outputFormatSchema, resolveConfig, searchConfigFile, shouldDisableColors, themeDefinitionSchema, themeSelectorPatternSchema, themesConfigSchema, tokenBuildConfigSchema, tokenCacheConfigSchema, tokenWatchConfigSchema, tokensConfigSchema, tokensHooksSchema, validateConfig, validateConfigOrThrow, validateConfigSection, versionSchema } from './config/index.cjs';
+import { R as ResolvedAliasesConfig, a as ResolvedComponentsConfig } from './types-CtE9f0G0.cjs';
+export { A as AliasesConfig, B as BuildSummary, C as ComponentsConfig, b as CustomFilter, c as CustomFormat, d as CustomPreprocessor, e as CustomTransform, D as Dictionary, f as DsaiConfig, F as FileConfig, g as FormatArgs, h as FrameworkMappingConfig, i as FrameworkMappingPattern, j as FrameworkTarget, G as GlobalConfig, I as IconFramework, k as IconsConfig, L as LoadConfigOptions, l as LoadConfigResult, m as LogLevel, O as OutputFormat, P as Platform, n as ResolvedConfig, o as ResolvedGlobalConfig, p as ResolvedIconsConfig, q as ResolvedThemeDefinition, r as ResolvedThemesConfig, s as ResolvedTokensConfig, S as ScssOutputConfig, T as ThemeDefinition, t as ThemeSelectorPattern, u as ThemesConfig, v as TokenData, w as TokensConfig, x as TransformOptions } from './types-CtE9f0G0.cjs';
+export { AliasesConfigFromSchema, CONFIG_FILE_NAMES, ComponentsConfigFromSchema, ConfigFormat, DEFAULT_COLLECTIONS_DIR, DEFAULT_ICONS_OUTPUT_DIR, DEFAULT_ICONS_SOURCE_DIR, DEFAULT_LOG_LEVEL, DEFAULT_OUTPUT_DIR, DEFAULT_PREFIX, DEFAULT_SOURCE_DIR, DsaiConfigFromSchema, EnvParseOptions, FrameworkFromSchema, GlobalConfigFromSchema, IconsConfigFromSchema, LogLevelFromSchema, MigrationCheck, OutputFormatFromSchema, ResolveOptions, ThemesConfigFromSchema, TokensConfigFromSchema, ValidationError, ValidationResult, aliasesConfigSchema, buildConfigSchema, checkDeprecatedOptions, checkMigrationNeeded, clearConfigCache, componentsConfigSchema, createResolvedConfig, customFormatSchema, customTransformSchema, defaultAliasesConfig, defaultComponentsConfig, defaultConfig, defaultFormats, defaultGlobalConfig, defaultIconFramework, defaultIconsConfig, defaultOutputFileNames, defaultSelectorPattern, defaultSourcePatterns, defaultThemesConfig, defaultTokensConfig, defineConfig, defineConfigAsync, dsaiConfigSchema, envArrayKeys, envBooleanKeys, envMappings, envNumberKeys, filePathSchema, formatErrorMessage, formatValidationErrors, frameworkSchema, generateMigrationScript, getConfigFromEnv, getDefaultExtension, getDefaultOutputDir, getEnvOverrides, getLogLevelFromEnv, getOutputFileName, globPatternSchema, globalConfigSchema, hashTypeSchema, iconOptimizationSchema, iconSpriteSchema, iconsConfigSchema, isCI, loadConfig, loadConfigSync, logLevelSchema, mergeConfigs, migrateConfig, migrateLegacyTokensConfig, outputFormatSchema, resolveConfig, searchConfigFile, shouldDisableColors, themeDefinitionSchema, themeSelectorPatternSchema, themesConfigSchema, tokenBuildConfigSchema, tokenCacheConfigSchema, tokenWatchConfigSchema, tokensConfigSchema, tokensHooksSchema, validateConfig, validateConfigOrThrow, validateConfigSection, versionSchema } from './config/index.cjs';
 export { BOOTSTRAP_MAPPINGS, BOOTSTRAP_PATTERNS, BuildOptions, BuildResult, BuildStep, BundleConfig, BundleResult, ChangelogOptions, ChangelogResult, CleanOptions, CleanResult, CleanedDirectory, CreateSDConfigOptions, DEFAULT_CLEAN_DIRECTORIES, DEFAULT_FILE_NAMES, DTCGFile, DTCGToken, DTCGTokenCollection, DiscoveryOptions, DiscoveryResult, FigmaCollection, FigmaExport, FigmaExportWithMetadata, FigmaVariablesResponse, FilePreprocessingResult, FormatDefinition, FrameworkMapper, FrameworkMapperWithConfig, LegacyToken, MergeConfig, MergeContent, MergeOptions, MergeResult, ModeExtractionOptions, ModeExtractionResult, MultiThemeBuildOptions, MultiThemeBuildResult, OutputConfig, PlaceholderValues, PostprocessOptions, PostprocessResult, PreprocessingResult, PreprocessorConfig, PreprocessorDefinition, ReplacementRule, SDConfig, SDDictionary, SDFile, SDFormatArgs, SDLogConfig, SDPlatform, SDPlatformType, SDToken, SDTransformOptions, SHADCN_MAPPINGS, SchemaValidationError, SchemaValidationOptions, SchemaValidationResult, StyleDictionaryFileConfig, StyleDictionaryInstance, StyleDictionaryPlatformConfig, StyleMergeResult, StyleScannedFile, StyleScannerOptions, StyleScannerResult, SyncOptions, SyncResult, ThemeBuildConfig, ThemeBuildOptions, ThemeBuildResult, ThemeFilesResult, ThemeStyleDictionaryConfig, Token, TokenChange, TokenChangeType, TokenCollection, TokenDiff, TokenTransformOptions, TokenTransformResult, TokenType, TokenValidationResult, TokenValueChange, TransformDefinition, TransformGroupDefinition, TransformType, VALID_TOKEN_TYPES, ValidateOptions, ValidationIssue, ValidationSeverity, addScssImportHeader, applyNameMapping, autoDetectThemes, bootstrapMapper, buildAllThemes, buildTheme, buildTokens, buildTokensCLI, builtInFormats, builtInPreprocessors, builtInTransforms, cleanTokenOutputs, cleanTokensCLI, createBundle, createBundleFromFiles, createBundles, createFixReferencesPreprocessor, createFrameworkMapper, createOutputConfig, createStyleDictionaryConfig, cssTransformGroup, cssVariablesWithComments, detectFigmaModes, detectModes, detectTransformModes, diffTokens, dimensionRem, discoverThemeFiles, dtcgFileSchema, dtcgTokenCollectionSchema, dtcgTokenSchema, ensureOutputDirs, extractMode, extractModes, figmaExportSchema, figmaExportWithMetadataSchema, figmaVariablesResponseSchema, filterDiff, filterFiles, fixReferences, flattenModeStructure, fontWeightUnitless, generateAndWriteChangelog, generateChangelog, generateChangelogCLI, generateThemeBuildConfig, getBreakingChanges, getCssFormat, getDefaultCssDir, getDefaultFiles, getDefaultIgnorePatterns, getDefaultSyncPaths, getDefaultTransformations, getFrameworkMapper, getPreprocessedFilesForMode, getSDTokenType, getSDTokenValue, getThemeFiles, getThemeSelector, getTokenDescription, getTokenType, getTokenValue, hasDTCGValue, isDTCGToken, isLegacyToken, isSDToken, isToken, isTokenReference, isValidTokenType, jsTransformGroup, lineHeightUnitless, loadContent, mapToBootstrapName, mapToShadcnName, mergeCollections, mergeCollectionsCLI, mergeContent, nameKebab, parseTokenReference, postprocessCLI, postprocessCss, postprocessCssFiles, preprocessFile, preprocessTokenFiles, processScssImportHeader, registerAll, registerFormats, registerPreprocessors, registerTransformGroups, registerTransforms, replacePlaceholders, resolveAllOutputPaths, resolveOutputPath, runBuildCLI, scanDirectories, scssTransformGroup, setupStyleDictionary, shadcnMapper, sortFiles, styleDictionaryInputSchema, styleDictionaryTokenSchema, summarizeDiff, syncTokens, syncTokensCLI, toDTCGToken, transformGroups, transformToken, transformTokenTree, transformTokens, transformTokensCLI, transformType, transformValue, typescriptDeclarations, validateDTCGFile, validateDTCGTokens, validateFigmaCLI, validateFigmaExport, validateFigmaExportWithMetadata, validateFigmaExports, validateFigmaFile, validateFigmaVariablesResponse, validateOutputPaths, validateStyleDictionaryInput, validateStyleDictionaryTokens, validateThemeDefinitions, validateTokens, validateTokensCLI, writeChangelog } from './tokens/index.cjs';
 export { GeneratedIcon, GeneratorOptions, IconBuildOptions, IconBuildResult, IconError, IconErrorCode, IconFormat, IconTemplate, IconWarning, IndexTemplate, OptimizedSVG, ParsedSVG, RawSVGData, SVGOConfig, SVGOPlugin, ScannerOptions, TypesTemplate, buildIcons, cleanSVGForReact, defaultReactIndexTemplate, defaultReactTemplate, defaultReactTypesTemplate, defaultSVGOConfig, extractViewBox, generateReactIcons, generateSVGSprite, isValidIconName, normalizeIconName, optimizeSVG, optimizeSVGFiles, parseSVG, parseSVGFiles, readSVGFile, scanSVGFiles, skipOptimization, toComponentName, toIconName } from './icons/index.cjs';
-import 'zod';
+import { z } from 'zod';
 
 /**
  * Package version
  */
 declare const version = "0.0.1";
 
+/**
+ * Registry type definitions for DSAi component distribution.
+ * @module @dsai-io/tools/registry/types
+ */
+type RegistryItemType = 'registry:ui' | 'registry:hook' | 'registry:util' | 'registry:lib' | 'registry:component' | 'registry:style' | 'registry:type';
+interface RegistryFile {
+    path: string;
+    type: RegistryItemType;
+    content: string;
+    target?: string;
+}
+interface RegistryItem {
+    name: string;
+    type: RegistryItemType;
+    title: string;
+    description: string;
+    dependencies: string[];
+    devDependencies: string[];
+    registryDependencies: string[];
+    files: RegistryFile[];
+    cssVars?: {
+        light?: Record<string, string>;
+        dark?: Record<string, string>;
+    };
+    categories?: string[];
+}
+interface RegistryIndex {
+    version: string;
+    count: number;
+    items: RegistryIndexEntry[];
+}
+interface RegistryIndexEntry {
+    name: string;
+    type: RegistryItemType;
+    title: string;
+    description: string;
+    dependencies: string[];
+    registryDependencies: string[];
+    categories?: string[];
+}
+interface ResolvedTree {
+    items: RegistryItem[];
+    dependencies: string[];
+    devDependencies: string[];
+    cssVars: {
+        light: Record<string, string>;
+        dark: Record<string, string>;
+    };
+}
+
+/**
+ * Zod schemas for registry validation.
+ * @module @dsai-io/tools/registry/schema
+ */
+
+declare const registryItemTypeSchema: z.ZodEnum<{
+    "registry:ui": "registry:ui";
+    "registry:hook": "registry:hook";
+    "registry:util": "registry:util";
+    "registry:lib": "registry:lib";
+    "registry:component": "registry:component";
+    "registry:style": "registry:style";
+    "registry:type": "registry:type";
+}>;
+declare const registryFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    content: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const registryItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    devDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodEnum<{
+            "registry:ui": "registry:ui";
+            "registry:hook": "registry:hook";
+            "registry:util": "registry:util";
+            "registry:lib": "registry:lib";
+            "registry:component": "registry:component";
+            "registry:style": "registry:style";
+            "registry:type": "registry:type";
+        }>;
+        content: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cssVars: z.ZodOptional<z.ZodObject<{
+        light: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        dark: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const registryIndexEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString>;
+    registryDependencies: z.ZodArray<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const registryIndexSchema: z.ZodObject<{
+    version: z.ZodString;
+    count: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            "registry:ui": "registry:ui";
+            "registry:hook": "registry:hook";
+            "registry:util": "registry:util";
+            "registry:lib": "registry:lib";
+            "registry:component": "registry:component";
+            "registry:style": "registry:style";
+            "registry:type": "registry:type";
+        }>;
+        title: z.ZodString;
+        description: z.ZodString;
+        dependencies: z.ZodArray<z.ZodString>;
+        registryDependencies: z.ZodArray<z.ZodString>;
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+/**
+ * Registry builder — scans @dsai-io/react source, analyzes imports,
+ * inlines file content, and writes registry JSON files.
+ * @module @dsai-io/tools/registry/builder
+ */
+
+interface BuildRegistryOptions {
+    /** Absolute path to the @dsai-io/react src directory. */
+    reactSrcDir: string;
+    /** Absolute path to the output directory for registry JSON files. */
+    outputDir: string;
+    /** Enable verbose logging. */
+    verbose?: boolean;
+}
+declare function buildRegistry(options: BuildRegistryOptions): RegistryIndex;
+
+/**
+ * Registry dependency resolver.
+ * @module @dsai-io/tools/registry/resolver
+ */
+
+declare function resolveTree(names: string[], registryDir: string): ResolvedTree;
+
+/**
+ * Import path transformer for registry files.
+ * @module @dsai-io/tools/registry/transformer
+ */
+
+interface TransformOptions {
+    aliases: ResolvedAliasesConfig;
+    tsx: boolean;
+}
+declare function transformImports(content: string, options: TransformOptions): string;
+declare function normalizeExtensions(content: string, tsx: boolean): string;
+
+/**
+ * Registry file writer.
+ * @module @dsai-io/tools/registry/writer
+ */
+
+interface WriteOptions {
+    projectDir: string;
+    aliases: ResolvedAliasesConfig;
+    components: ResolvedComponentsConfig;
+    overwrite?: boolean;
+    dryRun?: boolean;
+    log?: (message: string) => void;
+}
+interface WriteResult {
+    written: string[];
+    skipped: string[];
+    installedDeps: string[];
+}
+declare function writeRegistryItems(tree: ResolvedTree, options: WriteOptions): WriteResult;
+
 /**
  * Utility functions for @dsai-io/tools
  *
@@ -96,4 +305,4 @@ declare function formatDuration(ms: number): string;
  */
 declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
 
-export { deepMerge, fileExists, findPackageJson, formatDuration, getPackageRoot, isDirectory, isFile, logger, resolvePath, version };
+export { type BuildRegistryOptions, type RegistryFile, type RegistryIndex, type RegistryIndexEntry, type RegistryItem, type RegistryItemType, type TransformOptions as RegistryTransformOptions, ResolvedAliasesConfig, ResolvedComponentsConfig, type ResolvedTree, type WriteOptions, type WriteResult, buildRegistry, deepMerge, fileExists, findPackageJson, formatDuration, getPackageRoot, isDirectory, isFile, logger, normalizeExtensions, registryFileSchema, registryIndexEntrySchema, registryIndexSchema, registryItemSchema, registryItemTypeSchema, resolvePath, resolveTree, transformImports, version, writeRegistryItems };

package/dist/index.d.ts

@@ -1,14 +1,223 @@
-export { B as BuildSummary, m as CustomFilter, k as CustomFormat, l as CustomPreprocessor, C as CustomTransform, q as Dictionary, D as DsaiConfig, r as FileConfig, p as FormatArgs, d as FrameworkMappingConfig, e as FrameworkMappingPattern, F as FrameworkTarget, G as GlobalConfig, u as IconFramework, I as IconsConfig, L as LoadConfigOptions, s as LoadConfigResult, t as LogLevel, O as OutputFormat, P as Platform, R as ResolvedConfig, f as ResolvedGlobalConfig, h as ResolvedIconsConfig, j as ResolvedThemeDefinition, i as ResolvedThemesConfig, g as ResolvedTokensConfig, S as ScssOutputConfig, b as ThemeDefinition, c as ThemeSelectorPattern, a as ThemesConfig, n as TokenData, T as TokensConfig, o as TransformOptions } from './types-DabOzcsj.js';
-export { CONFIG_FILE_NAMES, ConfigFormat, DEFAULT_COLLECTIONS_DIR, DEFAULT_ICONS_OUTPUT_DIR, DEFAULT_ICONS_SOURCE_DIR, DEFAULT_LOG_LEVEL, DEFAULT_OUTPUT_DIR, DEFAULT_PREFIX, DEFAULT_SOURCE_DIR, DsaiConfigFromSchema, EnvParseOptions, FrameworkFromSchema, GlobalConfigFromSchema, IconsConfigFromSchema, LogLevelFromSchema, MigrationCheck, OutputFormatFromSchema, ResolveOptions, ThemesConfigFromSchema, TokensConfigFromSchema, ValidationError, ValidationResult, buildConfigSchema, checkDeprecatedOptions, checkMigrationNeeded, clearConfigCache, createResolvedConfig, customFormatSchema, customTransformSchema, defaultConfig, defaultFormats, defaultGlobalConfig, defaultIconFramework, defaultIconsConfig, defaultOutputFileNames, defaultSelectorPattern, defaultSourcePatterns, defaultThemesConfig, defaultTokensConfig, defineConfig, defineConfigAsync, dsaiConfigSchema, envArrayKeys, envBooleanKeys, envMappings, envNumberKeys, filePathSchema, formatErrorMessage, formatValidationErrors, frameworkSchema, generateMigrationScript, getConfigFromEnv, getDefaultExtension, getDefaultOutputDir, getEnvOverrides, getLogLevelFromEnv, getOutputFileName, globPatternSchema, globalConfigSchema, hashTypeSchema, iconOptimizationSchema, iconSpriteSchema, iconsConfigSchema, isCI, loadConfig, loadConfigSync, logLevelSchema, mergeConfigs, migrateConfig, migrateLegacyTokensConfig, outputFormatSchema, resolveConfig, searchConfigFile, shouldDisableColors, themeDefinitionSchema, themeSelectorPatternSchema, themesConfigSchema, tokenBuildConfigSchema, tokenCacheConfigSchema, tokenWatchConfigSchema, tokensConfigSchema, tokensHooksSchema, validateConfig, validateConfigOrThrow, validateConfigSection, versionSchema } from './config/index.js';
+import { R as ResolvedAliasesConfig, a as ResolvedComponentsConfig } from './types-CtE9f0G0.js';
+export { A as AliasesConfig, B as BuildSummary, C as ComponentsConfig, b as CustomFilter, c as CustomFormat, d as CustomPreprocessor, e as CustomTransform, D as Dictionary, f as DsaiConfig, F as FileConfig, g as FormatArgs, h as FrameworkMappingConfig, i as FrameworkMappingPattern, j as FrameworkTarget, G as GlobalConfig, I as IconFramework, k as IconsConfig, L as LoadConfigOptions, l as LoadConfigResult, m as LogLevel, O as OutputFormat, P as Platform, n as ResolvedConfig, o as ResolvedGlobalConfig, p as ResolvedIconsConfig, q as ResolvedThemeDefinition, r as ResolvedThemesConfig, s as ResolvedTokensConfig, S as ScssOutputConfig, T as ThemeDefinition, t as ThemeSelectorPattern, u as ThemesConfig, v as TokenData, w as TokensConfig, x as TransformOptions } from './types-CtE9f0G0.js';
+export { AliasesConfigFromSchema, CONFIG_FILE_NAMES, ComponentsConfigFromSchema, ConfigFormat, DEFAULT_COLLECTIONS_DIR, DEFAULT_ICONS_OUTPUT_DIR, DEFAULT_ICONS_SOURCE_DIR, DEFAULT_LOG_LEVEL, DEFAULT_OUTPUT_DIR, DEFAULT_PREFIX, DEFAULT_SOURCE_DIR, DsaiConfigFromSchema, EnvParseOptions, FrameworkFromSchema, GlobalConfigFromSchema, IconsConfigFromSchema, LogLevelFromSchema, MigrationCheck, OutputFormatFromSchema, ResolveOptions, ThemesConfigFromSchema, TokensConfigFromSchema, ValidationError, ValidationResult, aliasesConfigSchema, buildConfigSchema, checkDeprecatedOptions, checkMigrationNeeded, clearConfigCache, componentsConfigSchema, createResolvedConfig, customFormatSchema, customTransformSchema, defaultAliasesConfig, defaultComponentsConfig, defaultConfig, defaultFormats, defaultGlobalConfig, defaultIconFramework, defaultIconsConfig, defaultOutputFileNames, defaultSelectorPattern, defaultSourcePatterns, defaultThemesConfig, defaultTokensConfig, defineConfig, defineConfigAsync, dsaiConfigSchema, envArrayKeys, envBooleanKeys, envMappings, envNumberKeys, filePathSchema, formatErrorMessage, formatValidationErrors, frameworkSchema, generateMigrationScript, getConfigFromEnv, getDefaultExtension, getDefaultOutputDir, getEnvOverrides, getLogLevelFromEnv, getOutputFileName, globPatternSchema, globalConfigSchema, hashTypeSchema, iconOptimizationSchema, iconSpriteSchema, iconsConfigSchema, isCI, loadConfig, loadConfigSync, logLevelSchema, mergeConfigs, migrateConfig, migrateLegacyTokensConfig, outputFormatSchema, resolveConfig, searchConfigFile, shouldDisableColors, themeDefinitionSchema, themeSelectorPatternSchema, themesConfigSchema, tokenBuildConfigSchema, tokenCacheConfigSchema, tokenWatchConfigSchema, tokensConfigSchema, tokensHooksSchema, validateConfig, validateConfigOrThrow, validateConfigSection, versionSchema } from './config/index.js';
 export { BOOTSTRAP_MAPPINGS, BOOTSTRAP_PATTERNS, BuildOptions, BuildResult, BuildStep, BundleConfig, BundleResult, ChangelogOptions, ChangelogResult, CleanOptions, CleanResult, CleanedDirectory, CreateSDConfigOptions, DEFAULT_CLEAN_DIRECTORIES, DEFAULT_FILE_NAMES, DTCGFile, DTCGToken, DTCGTokenCollection, DiscoveryOptions, DiscoveryResult, FigmaCollection, FigmaExport, FigmaExportWithMetadata, FigmaVariablesResponse, FilePreprocessingResult, FormatDefinition, FrameworkMapper, FrameworkMapperWithConfig, LegacyToken, MergeConfig, MergeContent, MergeOptions, MergeResult, ModeExtractionOptions, ModeExtractionResult, MultiThemeBuildOptions, MultiThemeBuildResult, OutputConfig, PlaceholderValues, PostprocessOptions, PostprocessResult, PreprocessingResult, PreprocessorConfig, PreprocessorDefinition, ReplacementRule, SDConfig, SDDictionary, SDFile, SDFormatArgs, SDLogConfig, SDPlatform, SDPlatformType, SDToken, SDTransformOptions, SHADCN_MAPPINGS, SchemaValidationError, SchemaValidationOptions, SchemaValidationResult, StyleDictionaryFileConfig, StyleDictionaryInstance, StyleDictionaryPlatformConfig, StyleMergeResult, StyleScannedFile, StyleScannerOptions, StyleScannerResult, SyncOptions, SyncResult, ThemeBuildConfig, ThemeBuildOptions, ThemeBuildResult, ThemeFilesResult, ThemeStyleDictionaryConfig, Token, TokenChange, TokenChangeType, TokenCollection, TokenDiff, TokenTransformOptions, TokenTransformResult, TokenType, TokenValidationResult, TokenValueChange, TransformDefinition, TransformGroupDefinition, TransformType, VALID_TOKEN_TYPES, ValidateOptions, ValidationIssue, ValidationSeverity, addScssImportHeader, applyNameMapping, autoDetectThemes, bootstrapMapper, buildAllThemes, buildTheme, buildTokens, buildTokensCLI, builtInFormats, builtInPreprocessors, builtInTransforms, cleanTokenOutputs, cleanTokensCLI, createBundle, createBundleFromFiles, createBundles, createFixReferencesPreprocessor, createFrameworkMapper, createOutputConfig, createStyleDictionaryConfig, cssTransformGroup, cssVariablesWithComments, detectFigmaModes, detectModes, detectTransformModes, diffTokens, dimensionRem, discoverThemeFiles, dtcgFileSchema, dtcgTokenCollectionSchema, dtcgTokenSchema, ensureOutputDirs, extractMode, extractModes, figmaExportSchema, figmaExportWithMetadataSchema, figmaVariablesResponseSchema, filterDiff, filterFiles, fixReferences, flattenModeStructure, fontWeightUnitless, generateAndWriteChangelog, generateChangelog, generateChangelogCLI, generateThemeBuildConfig, getBreakingChanges, getCssFormat, getDefaultCssDir, getDefaultFiles, getDefaultIgnorePatterns, getDefaultSyncPaths, getDefaultTransformations, getFrameworkMapper, getPreprocessedFilesForMode, getSDTokenType, getSDTokenValue, getThemeFiles, getThemeSelector, getTokenDescription, getTokenType, getTokenValue, hasDTCGValue, isDTCGToken, isLegacyToken, isSDToken, isToken, isTokenReference, isValidTokenType, jsTransformGroup, lineHeightUnitless, loadContent, mapToBootstrapName, mapToShadcnName, mergeCollections, mergeCollectionsCLI, mergeContent, nameKebab, parseTokenReference, postprocessCLI, postprocessCss, postprocessCssFiles, preprocessFile, preprocessTokenFiles, processScssImportHeader, registerAll, registerFormats, registerPreprocessors, registerTransformGroups, registerTransforms, replacePlaceholders, resolveAllOutputPaths, resolveOutputPath, runBuildCLI, scanDirectories, scssTransformGroup, setupStyleDictionary, shadcnMapper, sortFiles, styleDictionaryInputSchema, styleDictionaryTokenSchema, summarizeDiff, syncTokens, syncTokensCLI, toDTCGToken, transformGroups, transformToken, transformTokenTree, transformTokens, transformTokensCLI, transformType, transformValue, typescriptDeclarations, validateDTCGFile, validateDTCGTokens, validateFigmaCLI, validateFigmaExport, validateFigmaExportWithMetadata, validateFigmaExports, validateFigmaFile, validateFigmaVariablesResponse, validateOutputPaths, validateStyleDictionaryInput, validateStyleDictionaryTokens, validateThemeDefinitions, validateTokens, validateTokensCLI, writeChangelog } from './tokens/index.js';
 export { GeneratedIcon, GeneratorOptions, IconBuildOptions, IconBuildResult, IconError, IconErrorCode, IconFormat, IconTemplate, IconWarning, IndexTemplate, OptimizedSVG, ParsedSVG, RawSVGData, SVGOConfig, SVGOPlugin, ScannerOptions, TypesTemplate, buildIcons, cleanSVGForReact, defaultReactIndexTemplate, defaultReactTemplate, defaultReactTypesTemplate, defaultSVGOConfig, extractViewBox, generateReactIcons, generateSVGSprite, isValidIconName, normalizeIconName, optimizeSVG, optimizeSVGFiles, parseSVG, parseSVGFiles, readSVGFile, scanSVGFiles, skipOptimization, toComponentName, toIconName } from './icons/index.js';
-import 'zod';
+import { z } from 'zod';
 
 /**
  * Package version
  */
 declare const version = "0.0.1";
 
+/**
+ * Registry type definitions for DSAi component distribution.
+ * @module @dsai-io/tools/registry/types
+ */
+type RegistryItemType = 'registry:ui' | 'registry:hook' | 'registry:util' | 'registry:lib' | 'registry:component' | 'registry:style' | 'registry:type';
+interface RegistryFile {
+    path: string;
+    type: RegistryItemType;
+    content: string;
+    target?: string;
+}
+interface RegistryItem {
+    name: string;
+    type: RegistryItemType;
+    title: string;
+    description: string;
+    dependencies: string[];
+    devDependencies: string[];
+    registryDependencies: string[];
+    files: RegistryFile[];
+    cssVars?: {
+        light?: Record<string, string>;
+        dark?: Record<string, string>;
+    };
+    categories?: string[];
+}
+interface RegistryIndex {
+    version: string;
+    count: number;
+    items: RegistryIndexEntry[];
+}
+interface RegistryIndexEntry {
+    name: string;
+    type: RegistryItemType;
+    title: string;
+    description: string;
+    dependencies: string[];
+    registryDependencies: string[];
+    categories?: string[];
+}
+interface ResolvedTree {
+    items: RegistryItem[];
+    dependencies: string[];
+    devDependencies: string[];
+    cssVars: {
+        light: Record<string, string>;
+        dark: Record<string, string>;
+    };
+}
+
+/**
+ * Zod schemas for registry validation.
+ * @module @dsai-io/tools/registry/schema
+ */
+
+declare const registryItemTypeSchema: z.ZodEnum<{
+    "registry:ui": "registry:ui";
+    "registry:hook": "registry:hook";
+    "registry:util": "registry:util";
+    "registry:lib": "registry:lib";
+    "registry:component": "registry:component";
+    "registry:style": "registry:style";
+    "registry:type": "registry:type";
+}>;
+declare const registryFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    content: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const registryItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    devDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodEnum<{
+            "registry:ui": "registry:ui";
+            "registry:hook": "registry:hook";
+            "registry:util": "registry:util";
+            "registry:lib": "registry:lib";
+            "registry:component": "registry:component";
+            "registry:style": "registry:style";
+            "registry:type": "registry:type";
+        }>;
+        content: z.ZodString;
+        target: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cssVars: z.ZodOptional<z.ZodObject<{
+        light: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        dark: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const registryIndexEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "registry:ui": "registry:ui";
+        "registry:hook": "registry:hook";
+        "registry:util": "registry:util";
+        "registry:lib": "registry:lib";
+        "registry:component": "registry:component";
+        "registry:style": "registry:style";
+        "registry:type": "registry:type";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    dependencies: z.ZodArray<z.ZodString>;
+    registryDependencies: z.ZodArray<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const registryIndexSchema: z.ZodObject<{
+    version: z.ZodString;
+    count: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            "registry:ui": "registry:ui";
+            "registry:hook": "registry:hook";
+            "registry:util": "registry:util";
+            "registry:lib": "registry:lib";
+            "registry:component": "registry:component";
+            "registry:style": "registry:style";
+            "registry:type": "registry:type";
+        }>;
+        title: z.ZodString;
+        description: z.ZodString;
+        dependencies: z.ZodArray<z.ZodString>;
+        registryDependencies: z.ZodArray<z.ZodString>;
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+/**
+ * Registry builder — scans @dsai-io/react source, analyzes imports,
+ * inlines file content, and writes registry JSON files.
+ * @module @dsai-io/tools/registry/builder
+ */
+
+interface BuildRegistryOptions {
+    /** Absolute path to the @dsai-io/react src directory. */
+    reactSrcDir: string;
+    /** Absolute path to the output directory for registry JSON files. */
+    outputDir: string;
+    /** Enable verbose logging. */
+    verbose?: boolean;
+}
+declare function buildRegistry(options: BuildRegistryOptions): RegistryIndex;
+
+/**
+ * Registry dependency resolver.
+ * @module @dsai-io/tools/registry/resolver
+ */
+
+declare function resolveTree(names: string[], registryDir: string): ResolvedTree;
+
+/**
+ * Import path transformer for registry files.
+ * @module @dsai-io/tools/registry/transformer
+ */
+
+interface TransformOptions {
+    aliases: ResolvedAliasesConfig;
+    tsx: boolean;
+}
+declare function transformImports(content: string, options: TransformOptions): string;
+declare function normalizeExtensions(content: string, tsx: boolean): string;
+
+/**
+ * Registry file writer.
+ * @module @dsai-io/tools/registry/writer
+ */
+
+interface WriteOptions {
+    projectDir: string;
+    aliases: ResolvedAliasesConfig;
+    components: ResolvedComponentsConfig;
+    overwrite?: boolean;
+    dryRun?: boolean;
+    log?: (message: string) => void;
+}
+interface WriteResult {
+    written: string[];
+    skipped: string[];
+    installedDeps: string[];
+}
+declare function writeRegistryItems(tree: ResolvedTree, options: WriteOptions): WriteResult;
+
 /**
  * Utility functions for @dsai-io/tools
  *
@@ -96,4 +305,4 @@ declare function formatDuration(ms: number): string;
  */
 declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
 
-export { deepMerge, fileExists, findPackageJson, formatDuration, getPackageRoot, isDirectory, isFile, logger, resolvePath, version };
+export { type BuildRegistryOptions, type RegistryFile, type RegistryIndex, type RegistryIndexEntry, type RegistryItem, type RegistryItemType, type TransformOptions as RegistryTransformOptions, ResolvedAliasesConfig, ResolvedComponentsConfig, type ResolvedTree, type WriteOptions, type WriteResult, buildRegistry, deepMerge, fileExists, findPackageJson, formatDuration, getPackageRoot, isDirectory, isFile, logger, normalizeExtensions, registryFileSchema, registryIndexEntrySchema, registryIndexSchema, registryItemSchema, registryItemTypeSchema, resolvePath, resolveTree, transformImports, version, writeRegistryItems };