@dsai-io/tools 1.2.5 → 1.3.0

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

@@ -8340,7 +8340,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 +8348,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 +8370,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 +8425,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 +8737,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 +8789,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;
@@ -14087,7 +14088,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 +14108,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 +14261,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 +14405,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 +14600,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);
 }