@dsai-io/tools 1.2.5 → 1.3.1

package/README.md

@@ -85,6 +85,10 @@ dsai config
 
 # Generate icon components from SVGs
 dsai icons build --format react
+
+# Show full tool inventory (for humans and AI agents)
+dsai info
+dsai info --json    # Structured JSON for agent consumption
 ```
 
 ## Configuration

package/dist/cli/index.cjs

@@ -4594,13 +4594,98 @@ var init_groups = __esm({
     ];
   }
 });
+
+// src/tokens/style-dictionary/preprocessors/fix-references.ts
+function fixValue(value, mappings) {
+  if (typeof value !== "string" || !value.startsWith("{")) {
+    return value;
+  }
+  let result = value;
+  for (const mapping of mappings) {
+    result = result.split(mapping[0]).join(mapping[1]);
+  }
+  return result;
+}
+function processTokens(obj, mappings) {
+  for (const key of Object.keys(obj)) {
+    const value = obj[key];
+    if (value && typeof value === "object") {
+      const typedValue = value;
+      if ("$value" in typedValue) {
+        typedValue["$value"] = fixValue(typedValue["$value"], mappings);
+      } else if ("value" in typedValue) {
+        typedValue["value"] = fixValue(typedValue["value"], mappings);
+      } else {
+        processTokens(typedValue, mappings);
+      }
+    }
+  }
+}
+function createFixReferencesPreprocessor(mappings) {
+  return {
+    name: "fix-references-custom",
+    preprocessor: (dictionary) => {
+      processTokens(dictionary, mappings);
+      return dictionary;
+    }
+  };
+}
+var DEFAULT_PATH_MAPPINGS, fixReferences;
+var init_fix_references = __esm({
+  "src/tokens/style-dictionary/preprocessors/fix-references.ts"() {
+    DEFAULT_PATH_MAPPINGS = [
+      ["{colors.brand.", "{color."],
+      ["{colors.neutral.", "{neutral."],
+      ["{borders.width.", "{border.width."]
+    ];
+    fixReferences = {
+      name: "fix-references",
+      preprocessor: (dictionary) => {
+        processTokens(dictionary, DEFAULT_PATH_MAPPINGS);
+        return dictionary;
+      }
+    };
+  }
+});
+
+// src/tokens/style-dictionary/preprocessors/index.ts
+var preprocessors_exports = {};
+__export(preprocessors_exports, {
+  builtInPreprocessors: () => builtInPreprocessors,
+  createFixReferencesPreprocessor: () => createFixReferencesPreprocessor,
+  fixReferences: () => fixReferences,
+  registerPreprocessors: () => registerPreprocessors
+});
+function registerPreprocessors(sd, customPreprocessors = []) {
+  const allPreprocessors = [...builtInPreprocessors, ...customPreprocessors];
+  for (const preprocessor of allPreprocessors) {
+    sd.registerPreprocessor({
+      name: preprocessor.name,
+      preprocessor: preprocessor.preprocessor
+    });
+  }
+}
+var builtInPreprocessors;
+var init_preprocessors = __esm({
+  "src/tokens/style-dictionary/preprocessors/index.ts"() {
+    init_fix_references();
+    init_fix_references();
+    builtInPreprocessors = [fixReferences];
+  }
+});
 function generateThemeBuildConfig(options) {
   const { themeDefinition, files, outputDir, config } = options;
   const isDefault = themeDefinition.isDefault;
   const platformsMap = /* @__PURE__ */ new Map();
   const enabledFormats = config.formats;
   for (const format of enabledFormats) {
-    const platformConfig = generatePlatformConfig(format, themeDefinition, outputDir, isDefault);
+    const platformConfig = generatePlatformConfig(
+      format,
+      themeDefinition,
+      outputDir,
+      isDefault,
+      config.prefix
+    );
     if (platformConfig) {
       platformsMap.set(format, platformConfig);
     }
@@ -4609,6 +4694,7 @@ function generateThemeBuildConfig(options) {
   return {
     source: files,
     platforms,
+    preprocessors: ["fix-references"],
     // Enable DTCG format support (tokens with $value, $type, etc.)
     usesDtcg: true,
     // Configure logging to not throw on broken references (they'll be logged but build continues)
@@ -4621,7 +4707,7 @@ function generateThemeBuildConfig(options) {
     }
   };
 }
-function generatePlatformConfig(format, themeDefinition, outputDir, isDefault) {
+function generatePlatformConfig(format, themeDefinition, outputDir, isDefault, prefix) {
   const formatConfig = FORMAT_MAPPING.get(format);
   if (!formatConfig) {
     console.warn(`Unknown format: ${format}`);
@@ -4636,8 +4722,15 @@ function generatePlatformConfig(format, themeDefinition, outputDir, isDefault) {
     destination: outputFile,
     format: sdFormat
   };
+  if (prefix && (format === "css" || format === "scss")) {
+    fileConfig.options = {
+      ...fileConfig.options,
+      prefix
+    };
+  }
   if (format === "css" && !isDefault) {
     fileConfig.options = {
+      ...fileConfig.options,
       selector: themeDefinition.selector
     };
   }
@@ -4750,6 +4843,8 @@ async function runStyleDictionaryBuild(sdConfig, options) {
   registerCustomTransforms(StyleDictionary);
   const { registerTransformGroups: registerTransformGroups2 } = await Promise.resolve().then(() => (init_groups(), groups_exports));
   registerTransformGroups2(StyleDictionary);
+  const { registerPreprocessors: registerPreprocessors2 } = await Promise.resolve().then(() => (init_preprocessors(), preprocessors_exports));
+  registerPreprocessors2(StyleDictionary);
   if (options.verbose) {
     console.warn(`   \u{1F527} Style Dictionary platforms:`);
     for (const [platform, config] of Object.entries(sdConfig.platforms)) {
@@ -4943,7 +5038,7 @@ var init_theme_builder = __esm({
       ["ios", { default: "ios/macros", themed: "ios/macros" }]
     ]);
     TRANSFORM_GROUPS = /* @__PURE__ */ new Map([
-      ["css", "css"],
+      ["css", "custom/css"],
       ["scss", "scss"],
       ["js", "js-custom"],
       // Use custom transform group for valid JS identifiers
@@ -5182,7 +5277,7 @@ function getPipelinePaths(customPaths) {
     ...customPaths
   };
 }
-function createStepFromName(stepName, tokensPackageDir, figmaExportsDir, tokensDir, paths, sdConfigFile, strict, snapshotService, themesConfig, outputDir, formats = ["css", "scss", "json"], cssOutputDir, postprocessConfig) {
+function createStepFromName(stepName, tokensPackageDir, figmaExportsDir, tokensDir, paths, sdConfigFile, strict, snapshotService, themesConfig, outputDir, formats = ["css", "scss", "json"], cssOutputDir, postprocessConfig, prefix) {
   const displayName = STEP_DISPLAY_NAMES.get(stepName) ?? `Unknown: ${stepName}`;
   switch (stepName) {
     case "validate":
@@ -5387,6 +5482,7 @@ function createStepFromName(stepName, tokensPackageDir, figmaExportsDir, tokensD
             const result = await buildAllThemes({
               config: {
                 formats,
+                prefix,
                 themes: {
                   definitions: themeDefinitions
                 }
@@ -5502,7 +5598,8 @@ function createBuildSteps(tokensDir, _toolsDir, options, pipeline) {
       options.outputDir,
       formats,
       options.cssOutputDir,
-      options.postprocessConfig
+      options.postprocessConfig,
+      options.prefix
     );
     if (stepName === "validate" && skipValidate) {
       step.skip = true;
@@ -6887,78 +6984,6 @@ var init_types2 = __esm({
   }
 });
 
-// src/tokens/style-dictionary/preprocessors/fix-references.ts
-function fixValue(value, mappings) {
-  if (typeof value !== "string" || !value.startsWith("{")) {
-    return value;
-  }
-  let result = value;
-  for (const mapping of mappings) {
-    result = result.split(mapping[0]).join(mapping[1]);
-  }
-  return result;
-}
-function processTokens(obj, mappings) {
-  for (const key of Object.keys(obj)) {
-    const value = obj[key];
-    if (value && typeof value === "object") {
-      const typedValue = value;
-      if ("$value" in typedValue) {
-        typedValue["$value"] = fixValue(typedValue["$value"], mappings);
-      } else if ("value" in typedValue) {
-        typedValue["value"] = fixValue(typedValue["value"], mappings);
-      } else {
-        processTokens(typedValue, mappings);
-      }
-    }
-  }
-}
-function createFixReferencesPreprocessor(mappings) {
-  return {
-    name: "fix-references-custom",
-    preprocessor: (dictionary) => {
-      processTokens(dictionary, mappings);
-      return dictionary;
-    }
-  };
-}
-var DEFAULT_PATH_MAPPINGS, fixReferences;
-var init_fix_references = __esm({
-  "src/tokens/style-dictionary/preprocessors/fix-references.ts"() {
-    DEFAULT_PATH_MAPPINGS = [
-      ["{colors.brand.", "{color."],
-      ["{colors.neutral.", "{neutral."],
-      ["{borders.width.", "{border.width."]
-    ];
-    fixReferences = {
-      name: "fix-references",
-      preprocessor: (dictionary) => {
-        processTokens(dictionary, DEFAULT_PATH_MAPPINGS);
-        return dictionary;
-      }
-    };
-  }
-});
-
-// src/tokens/style-dictionary/preprocessors/index.ts
-function registerPreprocessors(sd, customPreprocessors = []) {
-  const allPreprocessors = [...builtInPreprocessors, ...customPreprocessors];
-  for (const preprocessor of allPreprocessors) {
-    sd.registerPreprocessor({
-      name: preprocessor.name,
-      preprocessor: preprocessor.preprocessor
-    });
-  }
-}
-var builtInPreprocessors;
-var init_preprocessors = __esm({
-  "src/tokens/style-dictionary/preprocessors/index.ts"() {
-    init_fix_references();
-    init_fix_references();
-    builtInPreprocessors = [fixReferences];
-  }
-});
-
 // src/tokens/style-dictionary/config.ts
 function createStyleDictionaryConfig(dsaiConfig, options = {}) {
   const {
@@ -8340,7 +8365,7 @@ function transformImports(content, options) {
   const { aliases } = options;
   let result = content;
   result = result.replace(
-    /(from\s+['"])(?:\.\.\/)+types(?:\/([^'"]+))?(['"])/g,
+    /(from\s+['"])\.\.\/\.\.\/types(?:\/([^'"]+))?(['"])/g,
     (_match, prefix, subpath, suffix) => {
       if (subpath) {
         return `${prefix}${aliases.importAlias}${aliases.components}/types/${subpath}${suffix}`;
@@ -8348,6 +8373,18 @@ function transformImports(content, options) {
       return `${prefix}${aliases.importAlias}${aliases.components}/types${suffix}`;
     }
   );
+  result = result.replace(
+    /(from\s+['"])\.\.\/\.\.\/hooks\/(\w+)(['"])/g,
+    `$1${aliases.importAlias}${aliases.hooks}/$2$3`
+  );
+  result = result.replace(
+    /(from\s+['"])\.\.\/\.\.\/utils\/(\w+(?:\/\w+)?)(['"])/g,
+    `$1${aliases.importAlias}${aliases.utils}/$2$3`
+  );
+  result = result.replace(
+    /(from\s+['"])\.\.\/\.\.\/utils(['"])/g,
+    `$1${aliases.importAlias}${aliases.utils}$2`
+  );
   result = result.replace(
     /(from\s+['"])\.\.\/(([A-Z]\w+)(\/[^'"]+)?)(['"])/g,
     (_match, prefix, _fullPath, dirName, subPath, suffix) => {
@@ -8358,18 +8395,6 @@ function transformImports(content, options) {
       return `${prefix}${aliases.importAlias}${aliases.ui}/${kebab}${suffix}`;
     }
   );
-  result = result.replace(
-    /(from\s+['"])(?:\.\.\/)+hooks\/(\w+)(['"])/g,
-    `$1${aliases.importAlias}${aliases.hooks}/$2$3`
-  );
-  result = result.replace(
-    /(from\s+['"])(?:\.\.\/)+utils\/(\w+(?:\/\w+)?)(['"])/g,
-    `$1${aliases.importAlias}${aliases.utils}/$2$3`
-  );
-  result = result.replace(
-    /(from\s+['"])(?:\.\.\/)+utils(['"])/g,
-    `$1${aliases.importAlias}${aliases.utils}$2`
-  );
   return result;
 }
 function normalizeExtensions(content, tsx) {
@@ -8425,16 +8450,17 @@ function writeRegistryItems(tree, options) {
   for (const item of tree.items) {
     const targetBaseDir = getTargetDir(item.type, aliases);
     for (const file of item.files) {
-      const fileName = path4.basename(file.path);
       let targetPath;
       if (file.target) {
         targetPath = path4.join(projectDir, file.target);
       } else if (item.type === "registry:ui" || item.type === "registry:component") {
-        targetPath = path4.join(projectDir, targetBaseDir, item.name, fileName);
-      } else if (item.type === "registry:type") {
+        targetPath = path4.join(projectDir, targetBaseDir, item.name, path4.basename(file.path));
+      } else if (item.type === "registry:hook") {
+        targetPath = path4.join(projectDir, targetBaseDir, item.name, path4.basename(file.path));
+      } else if (file.path.includes("/")) {
         targetPath = path4.join(projectDir, targetBaseDir, file.path);
       } else {
-        targetPath = path4.join(projectDir, targetBaseDir, fileName);
+        targetPath = path4.join(projectDir, targetBaseDir, path4.basename(file.path));
       }
       if (fs3.existsSync(targetPath) && !shouldOverwrite) {
         if (log) log(`  Skipped (exists): ${targetPath}`);
@@ -8736,9 +8762,9 @@ function formatCount(count, singular, plural) {
 }
 
 // src/cli/commands/add.ts
-var VALID_TYPES = ["ui", "hook", "util", "lib", "type", "style"];
+var VALID_TYPES = ["ui", "hook", "util", "lib", "type"];
 function createAddCommand() {
-  const cmd = new commander.Command("add").description("Add DSAi items (components, hooks, utils) to your project").argument("[items...]", "Item names to add (e.g., button use-focus-trap cn)").option("--all", "Add all items of the specified type (default: ui)", false).option("--type <type>", "Filter by type: ui, hook, util, lib, type").option("--overwrite", "Overwrite existing files", false).option("--dry-run", "Preview changes without writing files", false).option("--registry <path>", "Path to local registry directory").option("--list", "List all available items", false).action(async (items, opts, cmdObj) => {
+  const cmd = new commander.Command("add").description("Add DSAi items (components, hooks, utils) to your project").argument("[items...]", "Item names to add (e.g., button use-focus-trap cn)").option("--all", "Add all items of the specified type (default: ui)", false).option("--type <type>", "Filter by type: ui, hook, util, type").option("--overwrite", "Overwrite existing files", false).option("--dry-run", "Preview changes without writing files", false).option("--registry <path>", "Path to local registry directory").option("--list", "List all available items", false).action(async (items, opts, cmdObj) => {
     const parentOpts = cmdObj.parent?.opts() ?? {};
     const allOpts = {
       ...parentOpts,
@@ -8788,7 +8814,7 @@ ${colors.bold("Available items:")}
           if (!grouped[type]) grouped[type] = [];
           grouped[type].push(item);
         }
-        const displayOrder = ["ui", "hook", "util", "lib", "type", "style"];
+        const displayOrder = ["ui", "hook", "util", "lib", "type"];
         for (const type of displayOrder) {
           const typeItems = grouped[type];
           if (!typeItems || typeItems.length === 0) continue;
@@ -9392,6 +9418,8 @@ async function runTokensBuild(options) {
       pipeline: config.tokens.pipeline,
       // Pass formats from config (default: css, scss, json)
       formats: config.tokens.formats,
+      // Pass CSS custom property prefix from config
+      prefix: config.tokens.prefix,
       // Pass output directory from config
       outputDir: config.tokens.outputDir ? path4.resolve(configDir, config.tokens.outputDir) : path4.resolve(configDir, "dist"),
       // Pass themes config for multi-theme builds
@@ -14087,7 +14115,7 @@ function analyzeImports(files, knownNpmDeps) {
     importPattern.lastIndex = 0;
     while ((m2 = importPattern.exec(file.content)) !== null) {
       const specifier = m2[1] ?? "";
-      const typesPattern = /\.\.\/(?:\.\.\/)?types(?:\/.*)?$/;
+      const typesPattern = /^\.\.\/\.\.\/types(?:\/.*)?$/;
       if (typesPattern.test(specifier)) {
         registryDeps.add("dsai-types");
         continue;
@@ -14107,6 +14135,16 @@ function analyzeImports(files, knownNpmDeps) {
         if (regName) registryDeps.add(regName);
         continue;
       }
+      const siblingUtilPattern = /^\.\.\/([a-z][\w-]*)(?:\/.*)?$/;
+      const siblingUtilMatch = siblingUtilPattern.exec(specifier);
+      if (siblingUtilMatch && siblingUtilMatch[1]) {
+        const siblingDir = siblingUtilMatch[1];
+        const regName = UTIL_SUBPATH_TO_REGISTRY[siblingDir];
+        if (regName) {
+          registryDeps.add(regName);
+          continue;
+        }
+      }
       const compPattern = /^\.\.\/(\.\.\/)?(?:components\/)?([A-Z]\w+)(?:\/.*)?$/;
       const compMatch = compPattern.exec(specifier);
       if (compMatch && compMatch[2]) {
@@ -14250,6 +14288,8 @@ function buildTypesItem(reactSrcDir, log) {
   const files = sourceFiles.map((f) => {
     let content = f.content;
     content = content.replace(/export \{[^}]*\} from ['"]\.\.\/utils\/[^'"]+['"];?\n?/g, "");
+    content = content.replace(/export\s+(?!type)\{[^}]*\}\s+from\s+['"]\.\/[^'"]+['"];?\n?/g, "");
+    content = content.replace(/\/\*\*\s*\n\s*\*\s*@deprecated[^*]*\*\/\s*\n/g, "");
     return {
       path: `types/${f.path}`,
       type: "registry:type",
@@ -14392,9 +14432,135 @@ function createRegistryCommand() {
 }
 
 // src/version.ts
-var version = "0.0.1";
-
-// src/cli/create-program.ts
+var version = "1.3.0";
+
+// src/cli/commands/info.ts
+var registry = {
+  package: "@dsai-io/tools",
+  version,
+  description: "Design System AI Toolkit \u2014 build, validate, and manage design tokens and icons.",
+  documentation: "https://github.com/michelve/dsai",
+  cli: {
+    binary: "dsai",
+    globalOptions: [
+      { flag: "-c, --config <path>", description: "Path to config file" },
+      { flag: "--cwd <dir>", description: "Working directory" },
+      { flag: "--debug", description: "Enable debug mode" },
+      { flag: "-q, --quiet", description: "Quiet mode \u2014 minimal output" },
+      { flag: "--dry-run", description: "Dry run \u2014 don't write files" },
+      { flag: "-v, --version", description: "Show version number" },
+      { flag: "-h, --help", description: "Show help" }
+    ],
+    commands: [
+      {
+        name: "add [items...]",
+        description: "Add DSAi items (components, hooks, utils) to your project",
+        options: ["--all", "--type <type>", "--overwrite", "--dry-run", "--list"]
+      },
+      {
+        name: "tokens build",
+        description: "Build design tokens from source collections",
+        options: ["--platforms <list>", "--watch", "--clean", "--theme <name>", "--list-themes"]
+      },
+      {
+        name: "tokens validate",
+        description: "Validate design token files",
+        options: ["--fix", "--strict"]
+      },
+      {
+        name: "tokens transform",
+        description: "Transform Figma exports to Style Dictionary format",
+        options: ["--dry-run", "--default-mode <mode>", "--ignore-modes <list>"]
+      },
+      {
+        name: "tokens sync",
+        description: "Sync tokens flat file",
+        options: ["--format <format>"]
+      },
+      {
+        name: "tokens postprocess",
+        description: "Post-process CSS theme files",
+        options: []
+      },
+      {
+        name: "tokens snapshots list",
+        description: "List all token collection snapshots",
+        options: []
+      },
+      {
+        name: "tokens snapshots info <id>",
+        description: "Show snapshot details",
+        options: []
+      },
+      {
+        name: "tokens snapshots rollback <id>",
+        description: "Rollback to a snapshot",
+        options: ["--dry-run"]
+      },
+      {
+        name: "icons build",
+        description: "Generate icon components from SVG files",
+        options: ["--format <format>", "--no-optimize", "--dry-run"]
+      },
+      {
+        name: "init",
+        description: "Initialize DSAi configuration with interactive prompts",
+        options: ["--yes", "--template <template>", "--force"]
+      },
+      {
+        name: "config",
+        description: "Display resolved configuration",
+        options: ["--json"]
+      },
+      {
+        name: "registry build",
+        description: "Build component registry JSON from source",
+        options: ["--src <path>", "--out <path>", "--verbose"]
+      },
+      {
+        name: "info",
+        description: "Show tool inventory and capabilities",
+        options: ["--json"]
+      }
+    ]
+  }
+};
+function printInfo() {
+  const log = (msg) => {
+    console.log(msg);
+  };
+  log("");
+  log(colors.bold(`${registry.package} v${registry.version}`));
+  log(colors.muted(registry.description));
+  log(colors.muted("\u2500".repeat(60)));
+  log("");
+  log(colors.bold("CLI Commands"));
+  log("");
+  for (const cmd of registry.cli.commands) {
+    const opts = cmd.options.length > 0 ? colors.muted(` [${cmd.options.join(", ")}]`) : "";
+    log(`  ${colors.command(`dsai ${cmd.name}`)}${opts}`);
+    log(`    ${colors.muted(cmd.description)}`);
+  }
+  log("");
+  log(colors.bold("Global Options"));
+  log("");
+  for (const opt of registry.cli.globalOptions) {
+    log(`  ${colors.cyan(opt.flag)}  ${colors.muted(opt.description)}`);
+  }
+  log("");
+  log(colors.bold("Documentation"));
+  log(`  ${colors.path(registry.documentation)}`);
+  log("");
+}
+function createInfoCommand() {
+  return new commander.Command("info").description("Show tool inventory and capabilities").option("--json", "Output as JSON for agent consumption", false).action((options) => {
+    if (options.json) {
+      console.log(JSON.stringify(registry, null, 2));
+    } else {
+      printInfo();
+    }
+  });
+}
 function createProgram() {
   const program2 = new commander.Command().name("dsai").description(
     `${colors.bold("DSAI Tools")} - Design System AI Toolkit
@@ -14461,6 +14627,7 @@ async function run(args = process.argv) {
   program.addCommand(createInitCommand());
   program.addCommand(createConfigCommand());
   program.addCommand(createRegistryCommand());
+  program.addCommand(createInfoCommand());
   setupErrorHandling(program);
   await program.parseAsync(args);
 }