vadivam 0.0.63 → 0.0.65

package/README.md

@@ -8,7 +8,7 @@ Tree-shakeable 24px outline SVG icons for JavaScript, with raw assets and metada
 [![downloads](https://img.shields.io/npm/dw/vadivam?style=flat-square&color=666)](https://www.npmjs.com/package/vadivam)
 [![license](https://img.shields.io/npm/l/vadivam?style=flat-square&color=111)](https://github.com/praveenjuge/vadivam/blob/main/LICENSE)
 
-![All Vadivam icons](https://raw.githubusercontent.com/praveenjuge/vadivam/main/apps/docs/public/preview.png?v=0.0.63)
+![All Vadivam icons](https://raw.githubusercontent.com/praveenjuge/vadivam/main/apps/docs/public/preview.png?v=0.0.65)
 
 ```sh
 npm install vadivam
@@ -38,6 +38,7 @@ createIcons({ icons });
 - Per-icon SVG strings, a complete SVG sprite, and an optional WOFF2 icon font
 - DOM replacement with configurable attributes, roots, and templates
 - Complete icon metadata from `vadivam/manifest`
+- A codemod that moves a Lucide project to Vadivam: `npx vadivam migrate-lucide --write` ([guide](https://vadivam.praveenjuge.com/docs/migrate-from-lucide))
 
 Package family: [React](https://www.npmjs.com/package/vadivam-react) · [React Native](https://www.npmjs.com/package/vadivam-react-native) · [Vue](https://www.npmjs.com/package/vadivam-vue) · [Svelte](https://www.npmjs.com/package/vadivam-svelte) · [Solid](https://www.npmjs.com/package/vadivam-solid) · [Angular](https://www.npmjs.com/package/vadivam-angular) · [Astro](https://www.npmjs.com/package/vadivam-astro) · [Preact](https://www.npmjs.com/package/vadivam-preact) · [MCP server](https://www.npmjs.com/package/vadivam-mcp)
 

package/dist/cli.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { guideUrl, migrateLucide } from "./migrate-lucide.js";
+
+const { version } = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8"));
+const [command, ...rest] = process.argv.slice(2);
+const usage = `vadivam ${version}
+
+Usage:
+  npx vadivam migrate-lucide [paths...] [--write]
+
+Rewrites Lucide imports, identifiers, dependencies, data-lucide attributes, and
+.lucide CSS classes to Vadivam. Without --write it only lists what would change.
+Paths default to the current directory.
+
+Guide: ${guideUrl}`;
+
+if (command === "--version" || command === "-v") {
+  console.log(version);
+} else if (command !== "migrate-lucide" || rest.includes("--help") || rest.includes("-h")) {
+  console.log(usage);
+  // An unknown command is an error; asking for help is not.
+  if (command && command !== "migrate-lucide" && command !== "--help" && command !== "-h") process.exitCode = 1;
+} else {
+  const write = rest.includes("--write");
+  const targets = rest.filter((arg) => !arg.startsWith("-"));
+  const files = await migrateLucide(targets.length > 0 ? targets : ["."], { write, version });
+  const changed = files.filter((entry) => entry.changes > 0);
+  for (const { file, changes, warnings } of files) {
+    const relative = path.relative(process.cwd(), file) || file;
+    if (changes > 0) console.log(`${write ? "updated" : "would update"} ${relative} (${changes} change${changes === 1 ? "" : "s"})`);
+    for (const warning of warnings) console.log(`  check ${relative}: ${warning}`);
+  }
+  const warningCount = files.reduce((total, entry) => total + entry.warnings.length, 0);
+  if (files.length === 0) {
+    console.log("No Lucide usage found.");
+  } else {
+    console.log(
+      `\n${changed.length} file${changed.length === 1 ? "" : "s"} ${write ? "updated" : "to update"}, ${warningCount} item${warningCount === 1 ? "" : "s"} to check by hand.`,
+    );
+    console.log(write ? "Reinstall dependencies with your package manager to update the lockfile." : "Run again with --write to apply.");
+  }
+}

package/dist/lucide-aliases.js

@@ -0,0 +1,2 @@
+// Deprecated Lucide names and the canonical icon each one now points to.
+export const lucideAliases = {"activity-square":"square-activity","alarm-check":"alarm-clock-check","alarm-minus":"alarm-clock-minus","alarm-plus":"alarm-clock-plus","album":"square-bookmark","alert-circle":"circle-alert","alert-octagon":"octagon-alert","alert-triangle":"triangle-alert","align-center":"text-align-center","align-justify":"text-align-justify","align-left":"text-align-start","align-right":"text-align-end","angry":"face-angry","annoyed":"face-expressionless","area-chart":"chart-area","arrow-down-01":"arrow-down-0-1","arrow-down-10":"arrow-down-1-0","arrow-down-az":"arrow-down-a-z","arrow-down-circle":"circle-arrow-down","arrow-down-left-from-circle":"circle-arrow-out-down-left","arrow-down-left-from-square":"square-arrow-out-down-left","arrow-down-left-square":"square-arrow-down-left","arrow-down-right-from-circle":"circle-arrow-out-down-right","arrow-down-right-from-square":"square-arrow-out-down-right","arrow-down-right-square":"square-arrow-down-right","arrow-down-square":"square-arrow-down","arrow-down-za":"arrow-down-z-a","arrow-left-circle":"circle-arrow-left","arrow-left-square":"square-arrow-left","arrow-right-circle":"circle-arrow-right","arrow-right-square":"square-arrow-right","arrow-up-01":"arrow-up-0-1","arrow-up-10":"arrow-up-1-0","arrow-up-az":"arrow-up-a-z","arrow-up-circle":"circle-arrow-up","arrow-up-left-from-circle":"circle-arrow-out-up-left","arrow-up-left-from-square":"square-arrow-out-up-left","arrow-up-left-square":"square-arrow-up-left","arrow-up-right-from-circle":"circle-arrow-out-up-right","arrow-up-right-from-square":"square-arrow-out-up-right","arrow-up-right-square":"square-arrow-up-right","arrow-up-square":"square-arrow-up","arrow-up-za":"arrow-up-z-a","asterisk-square":"square-asterisk","axis-3-d":"axis-3d","badge-help":"badge-question-mark","bar-chart":"chart-no-axes-column-increasing","bar-chart-2":"chart-no-axes-column","bar-chart-3":"chart-column","bar-chart-4":"chart-column-increasing","bar-chart-big":"chart-column-big","bar-chart-horizontal":"chart-bar","bar-chart-horizontal-big":"chart-bar-big","between-horizonal-end":"between-horizontal-end","between-horizonal-start":"between-horizontal-start","book-marked":"book-bookmark","book-template":"book-dashed","box-select":"square-dashed","building-2":"building-complex","candlestick-chart":"chart-candlestick","check-circle":"circle-check-big","check-circle-2":"circle-check","check-square":"square-check-big","check-square-2":"square-check","chevron-down-circle":"circle-chevron-down","chevron-down-square":"square-chevron-down","chevron-left-circle":"circle-chevron-left","chevron-left-square":"square-chevron-left","chevron-right-circle":"circle-chevron-right","chevron-right-square":"square-chevron-right","chevron-up-circle":"circle-chevron-up","chevron-up-square":"square-chevron-up","circle-euro-sign":"circle-euro","circle-help":"circle-question-mark","circle-slashed":"circle-slash-2","clipboard-edit":"clipboard-pen","clipboard-signature":"clipboard-pen-line","code-2":"code-xml","code-square":"square-code","columns":"columns-2","columns-settings":"columns-3-cog","contact-2":"contact-round","curly-braces":"braces","divide-circle":"circle-divide","divide-square":"square-divide","dot-square":"square-dot","download-cloud":"cloud-download","edit":"square-pen","edit-2":"pen","edit-3":"pen-line","equal-square":"square-equal","file-audio":"file-headphone","file-audio-2":"file-headphone","file-axis-3-d":"file-axis-3d","file-badge-2":"file-badge","file-bar-chart":"file-chart-column-increasing","file-bar-chart-2":"file-chart-column","file-check-2":"file-check-corner","file-code-2":"file-code-corner","file-cog-2":"file-cog","file-edit":"file-pen","file-json":"file-braces","file-json-2":"file-braces-corner","file-key-2":"file-key","file-line-chart":"file-chart-line","file-lock-2":"file-lock","file-minus-2":"file-minus-corner","file-pie-chart":"file-chart-pie","file-plus-2":"file-plus-corner","file-question":"file-question-mark","file-search-2":"file-search-corner","file-signature":"file-pen-line","file-type-2":"file-type-corner","file-video":"file-play","file-video-2":"file-video-camera","file-volume-2":"file-signal","file-warning":"file-exclamation-point","file-x-2":"file-x-corner","filter":"funnel","filter-x":"funnel-x","fingerprint":"fingerprint-pattern","flip-horizontal":"square-centerline-dashed-horizontal","flip-horizontal-2":"triangles-centerline-dashed-horizontal","flip-vertical":"square-centerline-dashed-vertical","flip-vertical-2":"triangles-centerline-dashed-vertical","folder-cog-2":"folder-cog","folder-edit":"folder-pen","fork-knife":"utensils","fork-knife-crossed":"utensils-crossed","form-input":"rectangle-ellipsis","frown":"face-slightly-frowning","function-square":"square-function","gantt-chart":"chart-no-axes-gantt","gantt-chart-square":"square-chart-gantt","gauge-circle":"circle-gauge","git-commit":"git-commit-horizontal","globe-2":"earth","grab":"hand-grab","grid":"grid-3x3","grid-2-x-2":"grid-2x2","grid-2-x-2-check":"grid-2x2-check","grid-2-x-2-plus":"grid-2x2-plus","grid-2-x-2-x":"grid-2x2-x","grid-3-x-3":"grid-3x3","help-circle":"circle-question-mark","helping-hand":"hand-helping","history":"rotate-ccw-clock","home":"house","ice-cream":"ice-cream-cone","ice-cream-2":"ice-cream-bowl","indent":"list-indent-increase","indent-decrease":"list-indent-decrease","indent-increase":"list-indent-increase","inspect":"square-mouse-pointer","kanban-square":"square-kanban","kanban-square-dashed":"square-dashed-kanban","laptop-2":"laptop-minimal","laugh":"face-grinning","layers-3":"layers","layout":"panels-top-left","letter-text":"text-initial","library-square":"square-library","line-chart":"chart-line","loader-2":"loader-circle","location-edit":"map-pin-pen","m-square":"square-m","mail-question":"mail-question-mark","meh":"face-neutral","menu-square":"square-menu","message-circle-question":"message-circle-question-mark","mic-2":"mic-vocal","minus-circle":"circle-minus","minus-square":"square-minus","more-horizontal":"ellipsis","more-vertical":"ellipsis-vertical","mouse-pointer-square-dashed":"square-dashed-mouse-pointer","move-3-d":"move-3d","music":"eighth-notes","music-2":"eighth-note","music-3":"half-note","music-4":"sixteenth-notes","outdent":"list-indent-decrease","paintbrush-2":"paintbrush-vertical","palmtree":"tree-palm","panel-bottom-inactive":"panel-bottom-dashed","panel-left-inactive":"panel-left-dashed","panel-right-inactive":"panel-right-dashed","panel-top-inactive":"panel-top-dashed","panels-left-right":"columns-3","panels-top-bottom":"rows-3","parking-circle":"circle-parking","parking-circle-off":"circle-parking-off","parking-square":"square-parking","parking-square-off":"square-parking-off","pause-circle":"circle-pause","pause-octagon":"octagon-pause","pen-box":"square-pen","pen-square":"square-pen","percent-circle":"circle-percent","percent-diamond":"diamond-percent","percent-square":"square-percent","pi-square":"square-pi","pie-chart":"chart-pie","pilcrow-square":"square-pilcrow","play-circle":"circle-play","play-square":"square-play","plug-zap-2":"plug-zap","plus-circle":"circle-plus","plus-square":"square-plus","podcast":"mic-signal","power-circle":"circle-power","power-square":"square-power","rotate-3-d":"rotate-3d","rows":"rows-2","scale-3-d":"scale-3d","scatter-chart":"chart-scatter","school-2":"university","scissors-square":"square-scissors","scissors-square-dashed-bottom":"square-bottom-dashed-scissors","send-horizonal":"send-horizontal","shield-close":"shield-x","shield-question":"shield-question-mark","sidebar":"panel-left","sidebar-close":"panel-left-close","sidebar-open":"panel-left-open","sigma-square":"square-sigma","slash-square":"square-slash","sliders":"sliders-vertical","smile":"face-slightly-smiling","smile-plus":"face-slightly-smiling-plus","sort-asc":"arrow-up-narrow-wide","sort-desc":"arrow-down-wide-narrow","split-square-horizontal":"square-split-horizontal","split-square-vertical":"square-split-vertical","square-gantt-chart":"square-chart-gantt","stars":"sparkles","stop-circle":"circle-stop","subtitles":"captions","table-config":"columns-3-cog","terminal-square":"square-terminal","test-tube-2":"test-tube-diagonal","text":"text-align-start","text-select":"square-dashed-text","text-selection":"square-dashed-text","train":"tram-front","trash-2":"trash","tv-2":"tv-minimal","unlock":"lock-open","unlock-keyhole":"lock-keyhole-open","upload-cloud":"cloud-upload","user-2":"user-round","user-check-2":"user-round-check","user-circle":"circle-user","user-circle-2":"circle-user-round","user-cog-2":"user-round-cog","user-minus-2":"user-round-minus","user-plus-2":"user-round-plus","user-square":"square-user","user-square-2":"square-user-round","user-x-2":"user-round-x","users-2":"users-round","verified":"badge-check","wallet-2":"wallet-minimal","wand-2":"wand-sparkles","waves":"waves-horizontal","wrap-text":"text-wrap","x-circle":"circle-x","x-octagon":"octagon-x","x-square":"square-x"};

package/dist/migrate-lucide.js

@@ -0,0 +1,279 @@
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { lucideAliases } from "./lucide-aliases.js";
+import { icons } from "./manifest.js";
+
+// Every Vadivam icon keeps its Lucide name, and each framework package mirrors
+// the matching Lucide package's API with Lucide renamed to Vadivam. So moving
+// over is a package rename plus `Lucide` -> `Vadivam` in imported identifiers.
+export const packageMap = {
+  lucide: "vadivam",
+  "lucide-react": "vadivam-react",
+  "lucide-react-native": "vadivam-react-native",
+  "lucide-vue-next": "vadivam-vue",
+  "@lucide/vue": "vadivam-vue",
+  "lucide-svelte": "vadivam-svelte",
+  "@lucide/svelte": "vadivam-svelte",
+  "lucide-solid": "vadivam-solid",
+  "lucide-preact": "vadivam-preact",
+  "@lucide/astro": "vadivam-astro",
+};
+
+// Packages whose API differs enough that they need a hand migration.
+const manualPackages = {
+  "lucide-angular": "vadivam-angular uses one standalone directive per icon",
+  "@lucide/angular": "vadivam-angular uses one standalone directive per icon",
+  "lucide-static": "use vadivam/icons/<name>.svg, vadivam/strings/<name>, the sprite, or the font",
+  "lucide-vue": "Vue 2 is not supported; vadivam-vue targets Vue 3",
+};
+
+export const guideUrl = "https://vadivam.praveenjuge.com/docs/migrate-from-lucide";
+
+const sourceExtensions = new Set([
+  ".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".mts", ".cts",
+  ".vue", ".svelte", ".astro", ".mdx", ".html",
+]);
+const styleExtensions = new Set([".css", ".scss", ".sass", ".less"]);
+const skippedDirectories = new Set([
+  "node_modules", ".git", "dist", "build", "out", "coverage",
+  ".next", ".nuxt", ".output", ".svelte-kit", ".astro", ".turbo", ".vercel", ".expo",
+]);
+const dependencyFields = ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"];
+
+const iconNames = new Set(icons.map((icon) => icon.name));
+const componentNames = new Map(icons.map((icon) => [icon.name, icon.componentName]));
+// Deprecated Lucide component names (AlertCircle) and the canonical ones (CircleAlert).
+const pascalCase = (name) => name.split("-").map((part) => part[0].toUpperCase() + part.slice(1)).join("");
+const componentAliases = new Map(
+  Object.entries(lucideAliases).map(([alias, name]) => [pascalCase(alias), componentNames.get(name)]),
+);
+const iconExports = new Set(
+  icons.flatMap(({ componentName }) => [componentName, `${componentName}Icon`, `Vadivam${componentName}`]),
+);
+// The non-icon exports across the core and framework packages.
+const apiExports = new Set([
+  "Icon", "createIcon", "createVadivamIcon", "icons", "iconNames", "dynamicIconImports", "DynamicIcon",
+  "VadivamProvider", "useVadivamContext", "provideVadivam", "VadivamContext", "VADIVAM_CONTEXT",
+  "getVadivamContext", "setVadivamProps", "createElement", "createIcons", "manifest", "iconsByName",
+  "categories", "IconName", "IconNode", "Icons", "SVGElementType", "SVGAttributes", "SVGProps",
+  "VadivamProps", "VadivamIcon", "IconDefinition", "CreateIconsOptions", "IconCategoryId",
+  "VadivamIconCategory", "VadivamIconMetadata", "default",
+]);
+
+const specifierPattern = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\.mock\s*\(\s*)(["'])([^"'\n]+)\2/g;
+// Named bindings taken from a Vadivam package: imports, re-exports, and
+// destructured require() calls. `separator` joins a name to its local name.
+const bindingLists = [
+  { kind: "import", separator: " as ", pattern: /\bimport\s+(?:type\s+)?(?:[\w$]+\s*,\s*)?\{([^}]*)\}\s*from\s*["'](vadivam(?:-[a-z-]+)?)(?:\/dynamic)?["']/g },
+  { kind: "export", separator: " as ", pattern: /\bexport\s+(?:type\s+)?\{([^}]*)\}\s*from\s*["'](vadivam(?:-[a-z-]+)?)(?:\/dynamic)?["']/g },
+  { kind: "require", separator: ": ", pattern: /\b(?:const|let|var)\s*\{([^}]*)\}\s*=\s*require\s*\(\s*["'](vadivam(?:-[a-z-]+)?)(?:\/dynamic)?["']\s*\)/g },
+];
+const bindingEntry = /((?:type\s+)?)([\w$]+)(?:\s*(?:\bas\b|:)\s*([\w$]+))?/g;
+
+function splitSpecifier(specifier) {
+  const parts = specifier.split("/");
+  const length = specifier.startsWith("@") ? 2 : 1;
+  return { name: parts.slice(0, length).join("/"), subpath: parts.slice(length).join("/") };
+}
+
+/** The Vadivam specifier for a Lucide one, or a reason it cannot be mapped. */
+export function mapSpecifier(specifier) {
+  const { name, subpath } = splitSpecifier(specifier);
+  if (manualPackages[name]) return { manual: `${name}: ${manualPackages[name]}` };
+  const target = packageMap[name];
+  if (!target) return null;
+  if (subpath === "") return { specifier: target };
+  if (target !== "vadivam" && (subpath === "dynamic" || subpath === "dynamicIconImports")) {
+    return { specifier: `${target}/${subpath}` };
+  }
+  const iconPath = subpath.match(/^(?:dist\/esm\/)?icons\/([a-z0-9-]+?)(?:\.m?js)?$/)?.[1];
+  const icon = lucideAliases[iconPath] ?? iconPath;
+  if (icon) {
+    if (!iconNames.has(icon)) return { manual: `${specifier}: Vadivam has no "${icon}" icon` };
+    return { specifier: `${target}/icons/${icon}` };
+  }
+  return { manual: `${specifier}: no Vadivam equivalent for this subpath` };
+}
+
+/** The canonical export for a deprecated Lucide one: AlertCircleIcon -> CircleAlertIcon. */
+function canonicalExport(name) {
+  const [, prefix, base, suffix] = name.match(/^(Vadivam)?(\w+?)(Icon)?$/) ?? [];
+  const canonical = base && componentAliases.get(base);
+  return canonical ? `${prefix ?? ""}${canonical}${suffix ?? ""}` : name;
+}
+
+const renameIdentifier = (identifier) =>
+  identifier !== "Lucide" && identifier !== "LUCIDE" && /Lucide|LUCIDE/.test(identifier)
+    ? identifier.replace(/Lucide/g, "Vadivam").replace(/LUCIDE/g, "VADIVAM")
+    : identifier;
+
+/**
+ * Rewrite one source file. Returns the new text, how many edits it made, and
+ * warnings for anything left to migrate by hand.
+ */
+export function migrateSource(text, { styles = false } = {}) {
+  const warnings = [];
+  let changes = 0;
+  // Lucide renders `lucide lucide-<name>` classes; Vadivam renders `vadivam vadivam-<name>`.
+  const migrateCss = (css) =>
+    css.replace(/\.lucide(?=[\s.,:#[>+~{)-]|$)/g, () => {
+      changes += 1;
+      return ".vadivam";
+    });
+  if (styles) return { text: migrateCss(text), changes, warnings };
+  let migrated = false;
+  // Vue, Svelte, Astro, and HTML files carry their own <style> blocks.
+  let output = text.replace(/(<style\b[^>]*>)([\s\S]*?)(<\/style>)/gi, (match, open, css, close) => `${open}${migrateCss(css)}${close}`);
+  output = output.replace(specifierPattern, (match, prefix, quote, specifier) => {
+    const mapped = mapSpecifier(specifier);
+    if (!mapped) return match;
+    if (mapped.manual) {
+      warnings.push(mapped.manual);
+      return match;
+    }
+    migrated = true;
+    changes += 1;
+    return `${prefix}${quote}${mapped.specifier}${quote}`;
+  });
+  if (migrated) {
+    // Only names taken from Lucide are renamed. An imported `LucideBell` becomes
+    // `VadivamBell` here and in the file's uses; a deprecated name imports the
+    // canonical icon under the old local name (`House as Home`) so the file's
+    // strings and JSX text stay as written. A re-export keeps its public name
+    // (`VadivamBell as LucideBell`) so the module's importers keep working.
+    const renames = new Map();
+    for (const { kind, separator, pattern } of bindingLists) {
+      output = output.replace(pattern, (statement, names) =>
+        statement.replace(names, (list) =>
+          list.replace(bindingEntry, (entry, type, imported, local) => {
+            const binding = local ?? (kind === "export" ? imported : renameIdentifier(imported));
+            const exported = canonicalExport(renameIdentifier(imported));
+            if (!local && binding !== imported) renames.set(imported, binding);
+            const next = `${type}${exported}${binding === exported ? "" : `${separator}${binding}`}`;
+            if (next !== entry) changes += 1;
+            return next;
+          }),
+        ),
+      );
+    }
+    if (renames.size > 0) {
+      // Rewritten import and export statements, quoted strings, and object or
+      // destructuring keys (`{ LucideBell: x }`) stay as they are. A local
+      // `export { LucideBell }` keeps its public name (`VadivamBell as
+      // LucideBell`); other identifier uses, but not property reads, take the
+      // new name.
+      output = output.replace(
+        /\bimport\s+(?:type\s+)?(?:[\w$]+\s*,?\s*)?(?:\*\s+as\s+[\w$]+|\{[^}]*\})?\s*from\s*["'][^"']*["']|\bexport\s+(?:type\s+)?(?:\*(?:\s+as\s+[\w$]+)?|\{[^}]*\})\s*from\s*["'][^"']*["']|\bexport\s*(?:type\s*)?\{([^}]*)\}|"(?:[^"\\\n]|\\.)*"|'(?:[^'\\\n]|\\.)*'|(?<=[{,]\s*)[A-Za-z_$][\w$]*(?=\s*:(?!:))|(?<![\w$.])([A-Za-z_$][\w$]*)/g,
+        (match, exportList, identifier) => {
+          if (exportList !== undefined) {
+            return match.replace(exportList, (list) =>
+              list.replace(/([\w$]+)(\s+as\s+[\w$]+)?/g, (entry, name, alias) => {
+                const renamed = renames.get(name);
+                if (!renamed) return entry;
+                changes += 1;
+                return `${renamed}${alias ?? ` as ${name}`}`;
+              }),
+            );
+          }
+          const renamed = identifier && renames.get(identifier);
+          if (!renamed) return match;
+          changes += 1;
+          return renamed;
+        },
+      );
+    }
+    // A mock factory lists the module's export names, which this can't safely rewrite.
+    if (/\.mock\s*\(\s*["']vadivam[^"']*["']\s*,/.test(output)) {
+      warnings.push("a test mock factory for a Vadivam package: check that its keys use Vadivam export names");
+    }
+  }
+  // The core package's createIcons() reads data-vadivam instead of data-lucide,
+  // and only knows current names (`home` is `house`).
+  output = output.replace(/\bdata-lucide=(?:(["'])([a-z0-9-]+)\1)?/g, (match, quote, name) => {
+    changes += 1;
+    return name ? `data-vadivam=${quote}${lucideAliases[name] ?? name}${quote}` : "data-vadivam=";
+  });
+  for (const { pattern } of bindingLists) {
+    for (const [, names, packageName] of output.matchAll(pattern)) {
+      if (packageName === "vadivam-angular") continue;
+      for (const [, , imported] of names.matchAll(bindingEntry)) {
+        if (iconExports.has(imported) || apiExports.has(imported)) continue;
+        warnings.push(`${imported} from ${packageName}: not a Vadivam export; search https://vadivam.praveenjuge.com/?q=${encodeURIComponent(imported)}`);
+      }
+    }
+  }
+  return { text: output, changes, warnings };
+}
+
+/** Rename Lucide dependencies in a package.json, keeping key order and formatting. */
+export function migratePackageJson(text, version) {
+  let manifest;
+  try {
+    manifest = JSON.parse(text);
+  } catch (error) {
+    return { text, changes: 0, warnings: [`not valid JSON, skipped: ${error.message}`] };
+  }
+  const warnings = [];
+  let changes = 0;
+  for (const field of dependencyFields) {
+    const dependencies = manifest[field];
+    if (!dependencies || typeof dependencies !== "object") continue;
+    const entries = [];
+    for (const [name, range] of Object.entries(dependencies)) {
+      if (manualPackages[name]) warnings.push(`${field}.${name}: ${manualPackages[name]}`);
+      const target = packageMap[name];
+      if (!target) {
+        entries.push([name, range]);
+        continue;
+      }
+      changes += 1;
+      if (!(target in dependencies) && !entries.some(([existing]) => existing === target)) {
+        entries.push([target, `^${version}`]);
+      }
+    }
+    manifest[field] = Object.fromEntries(entries);
+  }
+  if (changes === 0) return { text, changes, warnings };
+  const indent = text.match(/^[ \t]+(?=")/m)?.[0] ?? "  ";
+  return { text: `${JSON.stringify(manifest, null, indent)}${text.endsWith("\n") ? "\n" : ""}`, changes, warnings };
+}
+
+async function* walk(target) {
+  const entries = await readdir(target, { withFileTypes: true }).catch((error) => {
+    if (error.code === "ENOTDIR") return null;
+    throw error;
+  });
+  if (!entries) {
+    yield target;
+    return;
+  }
+  for (const entry of entries) {
+    const entryPath = path.join(target, entry.name);
+    if (entry.isDirectory()) {
+      if (!skippedDirectories.has(entry.name)) yield* walk(entryPath);
+    } else if (entry.isFile()) {
+      yield entryPath;
+    }
+  }
+}
+
+/** Migrate every supported file under `targets`. Writes only when `write` is true. */
+export async function migrateLucide(targets, { write = false, version }) {
+  const files = [];
+  for (const target of targets) {
+    for await (const file of walk(target)) {
+      const extension = path.extname(file);
+      const isManifest = path.basename(file) === "package.json";
+      if (!isManifest && !sourceExtensions.has(extension) && !styleExtensions.has(extension)) continue;
+      const text = await readFile(file, "utf8");
+      if (!/lucide/i.test(text)) continue;
+      const result = isManifest
+        ? migratePackageJson(text, version)
+        : migrateSource(text, { styles: styleExtensions.has(extension) });
+      if (result.changes === 0 && result.warnings.length === 0) continue;
+      if (write && result.changes > 0) await writeFile(file, result.text);
+      files.push({ file, changes: result.changes, warnings: result.warnings });
+    }
+  }
+  return files;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vadivam",
-  "version": "0.0.63",
+  "version": "0.0.65",
   "description": "Pixel-perfect 24px outline SVG icons with tree-shakeable ESM imports and metadata.",
   "license": "MIT",
   "author": "Praveen Juge",
@@ -26,6 +26,9 @@
     "javascript"
   ],
   "type": "module",
+  "bin": {
+    "vadivam": "dist/cli.js"
+  },
   "sideEffects": [
     "./dist/font/vadivam.css"
   ],

package/skills/vadivam-icons/SKILL.md

@@ -44,7 +44,7 @@ Peer ranges: React 18 or newer; React Native 0.71+ with React 18–19 and `react
 
 Never guess an icon name. Names follow Lucide (`trash`, `arrow-right`, `circle-check`), and every icon carries Lucide's search `tags` (synonyms) and `categories`.
 
-- With the MCP server connected, call `search_icons` with a few words (`{ "query": "delete" }`, optionally `"category": "arrows"`), then `get_icon` with the chosen name and a `format` such as `react` or `svg`. `list_categories` lists category ids.
+- With the MCP server connected, call `search_icons` with a few words (`{ "query": "delete" }`, optionally `"category": "arrows"`), then `get_icon` with the chosen name and a `format` such as `react` or `svg`. `list_categories` lists category ids. To pick icons for a whole screen, call `suggest_icons` with a short description such as `"settings sidebar with search, profile, and logout"`.
 - Without it, search the manifest:
 
   ```ts
@@ -60,7 +60,7 @@ Never guess an icon name. Names follow Lucide (`trash`, `arrow-right`, `circle-c
 
 ### Connect the MCP server
 
-The MCP server exposes `search_icons`, `get_icon`, `list_categories`, and `get_usage`. Use the hosted endpoint, or run the `vadivam-mcp` package over stdio (it bundles the icon data and works offline):
+The MCP server exposes `search_icons`, `suggest_icons`, `get_icon`, `list_categories`, and `get_usage`. Use the hosted endpoint, or run the `vadivam-mcp` package over stdio (it bundles the icon data and works offline):
 
 ```sh
 claude mcp add --transport http vadivam https://vadivam.praveenjuge.com/mcp
@@ -145,7 +145,7 @@ Replace `activity` with any icon name. Prefer the `vadivam-react` package when t
 - Icon-only button: name the button, `<button aria-label="Search"><Search aria-hidden="true" /></button>`.
 - React Native: `<Activity accessibilityLabel="Service is active" accessible />`.
 
-See [Usage](https://vadivam.praveenjuge.com/docs/usage.md#accessibility).
+See [Accessibility](https://vadivam.praveenjuge.com/docs/accessibility.md).
 
 ## Gotchas
 
@@ -163,7 +163,9 @@ See [Usage](https://vadivam.praveenjuge.com/docs/usage.md#accessibility).
 - [Icon catalog](https://vadivam.praveenjuge.com/): browse every icon; each is also served at `https://vadivam.praveenjuge.com/icons/<kebab-name>.svg`.
 - [shadcn/ui](https://vadivam.praveenjuge.com/docs/shadcn.md): `npx shadcn@latest add https://vadivam.praveenjuge.com/r/<kebab-name>.json` copies a self-contained React icon component into the project.
 - [AI agents](https://vadivam.praveenjuge.com/docs/ai-agents.md): how agents should consume Vadivam.
+- [Categories and naming](https://vadivam.praveenjuge.com/docs/categories.md): name forms per package, tags, and every category with its icon count.
 - [Design guide](https://vadivam.praveenjuge.com/docs/design-guide.md): the drawing rules every icon follows.
+- [How icons are built](https://vadivam.praveenjuge.com/docs/how-icons-are-built.md): the icon pipeline and every rule an SVG must pass.
 - [MCP server](https://vadivam.praveenjuge.com/docs/mcp.md): tools, hosted endpoint, and local setup.
 - [Contributing](https://vadivam.praveenjuge.com/docs/contributing.md): add icons or change packages.
 - [Changelog](https://vadivam.praveenjuge.com/changelog.md): release notes, newest first.