@solar-icons/cli 2.5.0 → 2.6.1

package/README.md

@@ -21,4 +21,4 @@ solar-icons styles [--json]
 
 All `--json` outputs are machine-readable (for agents / MCP).
 
-Framework snippet examples: `react` → `import { HomeBoldIcon } from "@solar-icons/react/bold/home"`, `vue`, `svelte`, `solid`, `angular` (`SolarHomeBold`), `react-native`, `nuxt`, `static`, `js`, `blade` (`<x-solar-bold-home />`).
+Framework snippet examples: `react` → `import { HomeBoldIcon } from "@solar-icons/react/bold/home"`, `vue`, `svelte`, `solid`, `angular` (`SolarHomeBold`), `react-native`, `nuxt`, `static`, `js`, `blade` (`<x-solar-bold-home />`), `flutter` (`HomeBoldIcon()`).

package/dist/catalog.d.mts

@@ -14,9 +14,14 @@ export type IconDescription = {
 };
 export declare const STYLES: readonly ['bold', 'bold-duotone', 'broken', 'linear', 'line-duotone', 'outline'];
 export type Style = (typeof STYLES)[number];
-export declare const FRAMEWORKS: readonly ['react', 'vue', 'svelte', 'solid', 'angular', 'react-native', 'nuxt', 'static', 'js', 'blade'];
+export declare const FRAMEWORKS: readonly ['react', 'vue', 'svelte', 'solid', 'angular', 'react-native', 'nuxt', 'static', 'js', 'blade', 'flutter'];
 export type Framework = (typeof FRAMEWORKS)[number];
 export declare function styleToPascal(style: Style): string;
+/**
+ * Flutter style directory and file stem (e.g. line-duotone/arrow-up →
+ * line_duotone/arrow_up). Mirrors lib/<style>/<icon>.dart.
+ */
+export declare function toDartPath(style: Style, kebabName: string): string;
 export declare function toPascalKebab(kebab: string): string;
 /**
  * Resolve a requested name to its catalog entry. Exact canonical names win;
@@ -48,6 +53,7 @@ export declare function componentName(kebabName: string, style: Style, framework
  *   solid:  import { HeartIcon } from '@solar-icons/solid/bold/heart'
  *   angular:import { SolarHeartBold } from '@solar-icons/angular' (style in name, root)
  *   blade:  <x-solar-bold-heart /> (Blade component, style in name)
+ *   flutter: HeartBoldIcon() (static widget, style in name; dynamic: HomeIcon(style: ...))
  */
 export declare function importSnippet(name: string, style: Style, framework: Framework): string;
 export declare function rootImportSnippet(name: string, style: Style, framework: Framework): string;

package/dist/catalog.mjs

@@ -1,3 +1,3 @@
-import{createRequire as e}from"node:module";import{existsSync as t,readFileSync as n,readdirSync as r}from"node:fs";import{dirname as i,join as a,resolve as o}from"node:path";import{fileURLToPath as s}from"node:url";const c=[`bold`,`bold-duotone`,`broken`,`linear`,`line-duotone`,`outline`],l=[`react`,`vue`,`svelte`,`solid`,`angular`,`react-native`,`nuxt`,`static`,`js`,`blade`],u={bold:`Bold`,"bold-duotone":`BoldDuotone`,broken:`Broken`,linear:`Linear`,"line-duotone":`LineDuotone`,outline:`Outline`};function d(e){return u[e]}function f(e){return e.split(`-`).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``)}function p(e,t){let n=e.find(e=>e.name===t);if(n)return{entry:n};for(let n of e){let e=n.deprecatedAliases?.find(e=>e.name===t);if(e)return{entry:n,alias:e}}throw Error(`icon '${t}' not found.`)}function m(e){return`${f(e)}Icon`}function h(e,t,n){let r=f(e),i=d(t);return n===`angular`?`Solar${r}${i}`:`${r}${i}Icon`}function g(e,t,n){return h(e,t,n)}function _(e,t,n){let r=e,i=m(e),a=h(e,t,n);switch(n){case`react`:return`import { ${i} } from "@solar-icons/react/${t}/${r}";`;case`vue`:return`import { ${i} } from "@solar-icons/vue/${t}/${r}";`;case`svelte`:return`import ${i} from "@solar-icons/svelte/${t}/${r}";`;case`solid`:return`import { ${i} } from "@solar-icons/solid/${t}/${r}";`;case`angular`:return`import { ${a} } from "@solar-icons/angular"; // usage: <svg ${a.charAt(0).toLowerCase()+a.slice(1)}></svg> (directive)`;case`react-native`:return`import { ${i} } from "@solar-icons/react-native/${t}/${r}";`;case`nuxt`:return`// nuxt.config: modules: ["@solar-icons/nuxt"] → auto-import <${a} />`;case`static`:return`import url from "@solar-icons/static/${t}/${r}.svg"; // <img src={url} alt="${r}" />`;case`js`:return`import { createIcons, icons } from "@solar-icons/js"; // icons["${r}-${t}"]`;case`blade`:return`<x-solar-${t}-${r} />`;default:return`import { ${i} } from "@solar-icons/${n}/${t}/${r}";`}}function v(e,t,n){let r=h(e,t,n);switch(n){case`svelte`:return`import { ${r} } from "@solar-icons/svelte";`;case`angular`:return`import { ${r} } from "@solar-icons/angular";`;case`static`:case`js`:case`nuxt`:case`blade`:return _(e,t,n);default:return`import { ${r} } from "@solar-icons/${n}";`}}function y(e){if(!t(e))return null;try{return JSON.parse(n(e,`utf8`))}catch{return null}}let b=null,x=null;function S(){if(b)return b;let t=[];try{let n=e(import.meta.url).resolve(`@solar-icons/static/package.json`),r=i(n);t.push(a(r,`dist`,`metadata-descriptions.json`)),t.push(a(r,`metadata-descriptions.json`))}catch{}try{let e=i(s(import.meta.url));t.push(o(e,`../../static/dist/metadata-descriptions.json`)),t.push(o(e,`../../../packages/static/dist/metadata-descriptions.json`)),t.push(o(e,`../../core/src/metadata-descriptions.json`)),t.push(o(e,`../../../packages/core/src/metadata-descriptions.json`))}catch{}for(let e of t){let t=y(e);if(Array.isArray(t)&&t.length>0)return b=t,b}throw Error(`Could not locate Solar Icons metadata. Ensure @solar-icons/static is installed or run inside the solar-icons monorepo. Tried:
+import{createRequire as e}from"node:module";import{existsSync as t,readFileSync as n,readdirSync as r}from"node:fs";import{dirname as i,join as a,resolve as o}from"node:path";import{fileURLToPath as s}from"node:url";const c=[`bold`,`bold-duotone`,`broken`,`linear`,`line-duotone`,`outline`],l=[`react`,`vue`,`svelte`,`solid`,`angular`,`react-native`,`nuxt`,`static`,`js`,`blade`,`flutter`],u={bold:`Bold`,"bold-duotone":`BoldDuotone`,broken:`Broken`,linear:`Linear`,"line-duotone":`LineDuotone`,outline:`Outline`};function d(e){return u[e]}function f(e,t){return`${e.replaceAll(`-`,`_`)}/${t.replaceAll(`-`,`_`)}`}function p(e){return e.split(`-`).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``)}function m(e,t){let n=e.find(e=>e.name===t);if(n)return{entry:n};for(let n of e){let e=n.deprecatedAliases?.find(e=>e.name===t);if(e)return{entry:n,alias:e}}throw Error(`icon '${t}' not found.`)}function h(e){return`${p(e)}Icon`}function g(e,t,n){let r=p(e),i=d(t);return n===`angular`?`Solar${r}${i}`:`${r}${i}Icon`}function _(e,t,n){return g(e,t,n)}function v(e,t,n){let r=e,i=h(e),a=g(e,t,n);switch(n){case`react`:return`import { ${i} } from "@solar-icons/react/${t}/${r}";`;case`vue`:return`import { ${i} } from "@solar-icons/vue/${t}/${r}";`;case`svelte`:return`import ${i} from "@solar-icons/svelte/${t}/${r}";`;case`solid`:return`import { ${i} } from "@solar-icons/solid/${t}/${r}";`;case`angular`:return`import { ${a} } from "@solar-icons/angular"; // usage: <svg ${a.charAt(0).toLowerCase()+a.slice(1)}></svg> (directive)`;case`react-native`:return`import { ${i} } from "@solar-icons/react-native/${t}/${r}";`;case`nuxt`:return`// nuxt.config: modules: ["@solar-icons/nuxt"] → auto-import <${a} />`;case`static`:return`import url from "@solar-icons/static/${t}/${r}.svg"; // <img src={url} alt="${r}" />`;case`js`:return`import { createIcons, icons } from "@solar-icons/js"; // icons["${r}-${t}"]`;case`blade`:return`<x-solar-${t}-${r} />`;case`flutter`:return`import 'package:flutter_solar_icons/${f(t,r)}.dart';\n${a}()`;default:return`import { ${i} } from "@solar-icons/${n}/${t}/${r}";`}}function y(e,t,n){let r=g(e,t,n);switch(n){case`svelte`:return`import { ${r} } from "@solar-icons/svelte";`;case`angular`:return`import { ${r} } from "@solar-icons/angular";`;case`static`:case`js`:case`nuxt`:case`blade`:return v(e,t,n);case`flutter`:return`import 'package:flutter_solar_icons/flutter_solar_icons.dart';\n${r}()`;default:return`import { ${r} } from "@solar-icons/${n}";`}}function b(e){if(!t(e))return null;try{return JSON.parse(n(e,`utf8`))}catch{return null}}let x=null,S=null;function C(){if(x)return x;let t=[];try{let n=e(import.meta.url).resolve(`@solar-icons/static/package.json`),r=i(n);t.push(a(r,`dist`,`metadata-descriptions.json`)),t.push(a(r,`metadata-descriptions.json`))}catch{}try{let e=i(s(import.meta.url));t.push(o(e,`../../static/dist/metadata-descriptions.json`)),t.push(o(e,`../../../packages/static/dist/metadata-descriptions.json`)),t.push(o(e,`../../core/src/metadata-descriptions.json`)),t.push(o(e,`../../../packages/core/src/metadata-descriptions.json`))}catch{}for(let e of t){let t=b(e);if(Array.isArray(t)&&t.length>0)return x=t,x}throw Error(`Could not locate Solar Icons metadata. Ensure @solar-icons/static is installed or run inside the solar-icons monorepo. Tried:
 `+t.join(`
-`))}function C(){if(x)return x;let e=S(),t=/* @__PURE__ */ new Set;for(let n of e)t.add(n.category);return x=[...t].sort(),x}function w(){let e=S(),t=new Set(e.map(e=>e.category));return{icons:e.length,categories:t.size,styles:c.length,variations:e.length*c.length}}function T(n,r){let c=[];try{let t=e(import.meta.url).resolve(`@solar-icons/static/package.json`),o=i(t);c.push(a(o,`dist`,`icons`,r,`${n}.svg`))}catch{}try{let e=i(s(import.meta.url));c.push(o(e,`../../static/dist/icons`,r,`${n}.svg`)),c.push(o(e,`../../../packages/static/dist/icons`,r,`${n}.svg`))}catch{}for(let e of c)if(t(e))return e;return null}function E(e,t,n=`latest`){return`https://cdn.jsdelivr.net/npm/@solar-icons/static@${n}/dist/icons/${t}/${e}.svg`}const D=`https://www.figma.com/community/plugin/1664759238792120976/solar-icons`,O=`https://solar-icons.vercel.app/`,k=`https://solar-icons.vercel.app/icons`;function A(){let t=[];try{let n=e(import.meta.url).resolve(`@solar-icons/cli/package.json`),r=y(n);if(r?.version)return r.version;t.push(n)}catch{}try{let e=i(s(import.meta.url));t.push(o(e,`../../package.json`)),t.push(o(e,`../../../packages/cli/package.json`)),t.push(o(e,`../package.json`))}catch{}for(let e of t){let t=y(e);if(t?.version)return t.version}return`unknown`}function j(){let e=[];try{let t=i(s(import.meta.url));e.push(o(t,`../../..`,`packages`)),e.push(o(t,`../../../packages`)),e.push(o(t,`../../packages`)),e.push(o(t,`..`,`..`,`packages`)),e.push(o(t,`../packages`))}catch{}try{e.push(o(process.cwd(),`packages`))}catch{}for(let n of e)if(t(n))try{let e=r(n,{withFileTypes:!0}),i=[];for(let r of e){if(!r.isDirectory())continue;let e=a(n,r.name,`package.json`);if(!t(e))continue;let o=y(e);o?.name?.startsWith(`@solar-icons/`)&&(o.private||i.push({name:o.name,version:o.version??`unknown`,description:o.description??``,directory:`packages/${r.name}`}))}if(i.length>0)return i.sort((e,t)=>e.name.localeCompare(t.name)),i}catch{}return[]}function M(){return{catalog:w(),packages:j(),cliVersion:A(),figma:D,docs:O,iconsExplorer:k}}export{O as DOCS_URL,D as FIGMA_URL,l as FRAMEWORKS,k as ICONS_URL,c as STYLES,w as catalogStats,E as cdnSvgUrl,g as componentName,M as getOverview,_ as importSnippet,C as listCategories,S as loadDescriptions,m as perFileComponentName,p as resolveIconName,T as resolveSvgPath,h as rootComponentName,v as rootImportSnippet,d as styleToPascal,f as toPascalKebab};
+`))}function w(){if(S)return S;let e=C(),t=/* @__PURE__ */ new Set;for(let n of e)t.add(n.category);return S=[...t].sort(),S}function T(){let e=C(),t=new Set(e.map(e=>e.category));return{icons:e.length,categories:t.size,styles:c.length,variations:e.length*c.length}}function E(n,r){let c=[];try{let t=e(import.meta.url).resolve(`@solar-icons/static/package.json`),o=i(t);c.push(a(o,`dist`,`icons`,r,`${n}.svg`))}catch{}try{let e=i(s(import.meta.url));c.push(o(e,`../../static/dist/icons`,r,`${n}.svg`)),c.push(o(e,`../../../packages/static/dist/icons`,r,`${n}.svg`))}catch{}for(let e of c)if(t(e))return e;return null}function D(e,t,n=`latest`){return`https://cdn.jsdelivr.net/npm/@solar-icons/static@${n}/dist/icons/${t}/${e}.svg`}const O=`https://www.figma.com/community/plugin/1664759238792120976/solar-icons`,k=`https://solar-icons.vercel.app/`,A=`https://solar-icons.vercel.app/icons`;function j(){let t=[];try{let n=e(import.meta.url).resolve(`@solar-icons/cli/package.json`),r=b(n);if(r?.version)return r.version;t.push(n)}catch{}try{let e=i(s(import.meta.url));t.push(o(e,`../../package.json`)),t.push(o(e,`../../../packages/cli/package.json`)),t.push(o(e,`../package.json`))}catch{}for(let e of t){let t=b(e);if(t?.version)return t.version}return`unknown`}function M(){let e=[];try{let t=i(s(import.meta.url));e.push(o(t,`../../..`,`packages`)),e.push(o(t,`../../../packages`)),e.push(o(t,`../../packages`)),e.push(o(t,`..`,`..`,`packages`)),e.push(o(t,`../packages`))}catch{}try{e.push(o(process.cwd(),`packages`))}catch{}for(let n of e)if(t(n))try{let e=r(n,{withFileTypes:!0}),i=[];for(let r of e){if(!r.isDirectory())continue;let e=a(n,r.name,`package.json`);if(!t(e))continue;let o=b(e);o?.name?.startsWith(`@solar-icons/`)&&(o.private||i.push({name:o.name,version:o.version??`unknown`,description:o.description??``,directory:`packages/${r.name}`}))}if(i.length>0)return i.sort((e,t)=>e.name.localeCompare(t.name)),i}catch{}return[]}function N(){return{catalog:T(),packages:M(),cliVersion:j(),figma:O,docs:k,iconsExplorer:A}}export{k as DOCS_URL,O as FIGMA_URL,l as FRAMEWORKS,A as ICONS_URL,c as STYLES,T as catalogStats,D as cdnSvgUrl,_ as componentName,N as getOverview,v as importSnippet,w as listCategories,C as loadDescriptions,h as perFileComponentName,m as resolveIconName,E as resolveSvgPath,g as rootComponentName,y as rootImportSnippet,d as styleToPascal,f as toDartPath,p as toPascalKebab};

package/dist/cli.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import{STYLES as e,getOverview as t,listCategories as n}from"./catalog.mjs";import{runSearch as r}from"./commands/search.mjs";import{runGet as i}from"./commands/get.mjs";import{runList as a}from"./commands/list.mjs";import{runInfo as o}from"./commands/info.mjs";import{createRequire as s}from"node:module";import{readFileSync as c,realpathSync as l}from"node:fs";import{fileURLToPath as u,pathToFileURL as d}from"node:url";import f from"picocolors";import{Command as p}from"commander";let m=`0.0.0`;try{m=s(import.meta.url)(`@solar-icons/cli/package.json`).version??`0.0.0`}catch{}if(m===`0.0.0`)try{let e=new URL(`../package.json`,import.meta.url);m=JSON.parse(c(u(e),`utf8`)).version??`0.0.0`}catch{}const h=new p().name(`solar-icons`).description(`Solar Icons CLI — search, get and list 1,451 icons × 6 styles.`).version(m,`-v, --version`).showHelpAfterError().showSuggestionAfterError().configureHelp({sortSubcommands:!0,styleTitle:e=>f.bold(f.cyan(e)),styleCommandText:e=>f.cyan(e),styleCommandDescription:e=>f.dim(e),styleOptionText:e=>f.green(e),styleArgumentText:e=>f.yellow(e),styleDescriptionText:e=>f.dim(e),styleOptionTerm:e=>f.green(e)});h.addHelpText(`after`,`\n${f.bold(`Examples:`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`search`)} ${f.yellow(`"home"`)} ${f.dim(`--limit 10 --framework react`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`get`)} ${f.yellow(`arrow-up`)} ${f.dim(`--style linear --framework vue`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`overview`)} ${f.dim(`--json`)}  ${f.dim(`# for agents / CI`)}\n`),h.command(`search`).argument(`<query>`,`search query, e.g. "home" or "shopping cart"`).option(`-l, --limit <n>`,`max results (1..200, default 20)`,`20`).option(`--style <style>`,`restrict import hint to one style: ${e.join(`|`)}`).option(`--category <category>`,`restrict to category (see: solar-icons categories)`).option(`--framework <framework>`,`emit import snippet for framework (react|vue|svelte|solid|angular|react-native|nuxt|static|js|blade)`).option(`--json`,`machine-readable JSON output (for agents/MCP)`).description(`Search icons by name/tags/category`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons search`)} ${f.yellow(`"shopping cart"`)} ${f.dim(`--framework react`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons search`)} ${f.yellow(`arrow`)} ${f.dim(`--category arrows --json`)}\n  `).action((e,t)=>{try{r(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`get`).argument(`<name>`,`kebab icon name, e.g. home`).option(`--style <style>`,`style`,`linear`).option(`--framework <framework>`,`framework for snippet`,`react`).option(`--out <file>`,`copy SVG to file`).option(`--json`,`JSON output`).description(`Get import snippet and SVG for an icon`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons get`)} ${f.yellow(`home`)} ${f.dim(`--style bold --framework svelte`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons get`)} ${f.yellow(`arrow-up`)} ${f.dim(`--out ./arrow.svg`)}\n  `).action((e,t)=>{try{i(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`list`).option(`--category <category>`,`filter by category`).option(`--style <style>`,`hint style: ${e.join(`|`)}`).option(`-l, --limit <n>`,`max results (1..2000, default 50)`,`50`).option(`--json`,`JSON output`).description(`List icons`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons list`)} ${f.dim(`--category home --limit 20`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons list`)} ${f.dim(`--json | jq .[].name`)}\n  `).action(e=>{try{a(e)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`info`).argument(`<name>`,`icon name`).option(`--json`,`JSON output`).description(`Show metadata and all import paths for an icon`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons info`)} ${f.yellow(`arrow-up`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons info`)} ${f.yellow(`heart`)} ${f.dim(`--json`)}\n  `).action((e,t)=>{try{o(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`categories`).option(`--json`,`JSON output`).description(`List all categories`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons categories`)} ${f.dim(`--json`)}\n  `).action(e=>{let t=n();if(e.json)console.log(JSON.stringify(t,null,2));else for(let e of t)console.log(e)}),h.command(`styles`).option(`--json`,`JSON output`).description(`List all styles and provider tokens`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons styles`)}\n  `).action(t=>{if(t.json)console.log(JSON.stringify(e,null,2));else{for(let t of e)console.log(t);console.log(f.dim(`
+import{STYLES as e,getOverview as t,listCategories as n}from"./catalog.mjs";import{runSearch as r}from"./commands/search.mjs";import{runGet as i}from"./commands/get.mjs";import{runList as a}from"./commands/list.mjs";import{runInfo as o}from"./commands/info.mjs";import{createRequire as s}from"node:module";import{readFileSync as c,realpathSync as l}from"node:fs";import{fileURLToPath as u,pathToFileURL as d}from"node:url";import f from"picocolors";import{Command as p}from"commander";let m=`0.0.0`;try{m=s(import.meta.url)(`@solar-icons/cli/package.json`).version??`0.0.0`}catch{}if(m===`0.0.0`)try{let e=new URL(`../package.json`,import.meta.url);m=JSON.parse(c(u(e),`utf8`)).version??`0.0.0`}catch{}const h=new p().name(`solar-icons`).description(`Solar Icons CLI — search, get and list 1,451 icons × 6 styles.`).version(m,`-v, --version`).showHelpAfterError().showSuggestionAfterError().configureHelp({sortSubcommands:!0,styleTitle:e=>f.bold(f.cyan(e)),styleCommandText:e=>f.cyan(e),styleCommandDescription:e=>f.dim(e),styleOptionText:e=>f.green(e),styleArgumentText:e=>f.yellow(e),styleDescriptionText:e=>f.dim(e),styleOptionTerm:e=>f.green(e)});h.addHelpText(`after`,`\n${f.bold(`Examples:`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`search`)} ${f.yellow(`"home"`)} ${f.dim(`--limit 10 --framework react`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`get`)} ${f.yellow(`arrow-up`)} ${f.dim(`--style linear --framework vue`)}\n  ${f.dim(`$`)} ${f.cyan(`solar-icons`)} ${f.green(`overview`)} ${f.dim(`--json`)}  ${f.dim(`# for agents / CI`)}\n`),h.command(`search`).argument(`<query>`,`search query, e.g. "home" or "shopping cart"`).option(`-l, --limit <n>`,`max results (1..200, default 20)`,`20`).option(`--style <style>`,`restrict import hint to one style: ${e.join(`|`)}`).option(`--category <category>`,`restrict to category (see: solar-icons categories)`).option(`--framework <framework>`,`emit import snippet for framework (react|vue|svelte|solid|angular|react-native|nuxt|static|js|blade|flutter)`).option(`--json`,`machine-readable JSON output (for agents/MCP)`).description(`Search icons by name/tags/category`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons search`)} ${f.yellow(`"shopping cart"`)} ${f.dim(`--framework react`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons search`)} ${f.yellow(`arrow`)} ${f.dim(`--category arrows --json`)}\n  `).action((e,t)=>{try{r(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`get`).argument(`<name>`,`kebab icon name, e.g. home`).option(`--style <style>`,`style`,`linear`).option(`--framework <framework>`,`framework for snippet`,`react`).option(`--out <file>`,`copy SVG to file`).option(`--json`,`JSON output`).description(`Get import snippet and SVG for an icon`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons get`)} ${f.yellow(`home`)} ${f.dim(`--style bold --framework svelte`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons get`)} ${f.yellow(`arrow-up`)} ${f.dim(`--out ./arrow.svg`)}\n  `).action((e,t)=>{try{i(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`list`).option(`--category <category>`,`filter by category`).option(`--style <style>`,`hint style: ${e.join(`|`)}`).option(`-l, --limit <n>`,`max results (1..2000, default 50)`,`50`).option(`--json`,`JSON output`).description(`List icons`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons list`)} ${f.dim(`--category home --limit 20`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons list`)} ${f.dim(`--json | jq .[].name`)}\n  `).action(e=>{try{a(e)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`info`).argument(`<name>`,`icon name`).option(`--json`,`JSON output`).description(`Show metadata and all import paths for an icon`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons info`)} ${f.yellow(`arrow-up`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons info`)} ${f.yellow(`heart`)} ${f.dim(`--json`)}\n  `).action((e,t)=>{try{o(e,t)}catch(e){console.error(f.red(`error: ${e.message}`)),process.exit(2)}}),h.command(`categories`).option(`--json`,`JSON output`).description(`List all categories`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons categories`)} ${f.dim(`--json`)}\n  `).action(e=>{let t=n();if(e.json)console.log(JSON.stringify(t,null,2));else for(let e of t)console.log(e)}),h.command(`styles`).option(`--json`,`JSON output`).description(`List all styles and provider tokens`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons styles`)}\n  `).action(t=>{if(t.json)console.log(JSON.stringify(e,null,2));else{for(let t of e)console.log(t);console.log(f.dim(`
 Provider tokens: --solar-color, --solar-size, --solar-stroke-width, --solar-secondary-color, --solar-secondary-opacity`))}}),h.command(`overview`).option(`--json`,`JSON output`).description(`Show global overview — catalog, packages, Figma plugin and docs`).addHelpText(`after`,`  ${f.bold(`Examples:`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons overview`)}\n    ${f.dim(`$`)} ${f.cyan(`solar-icons overview`)} ${f.dim(`--json`)}\n  `).action(e=>{let n=t();if(e.json){console.log(JSON.stringify(n,null,2));return}if(console.log(`${f.bgCyan(f.black(` Solar Icons `))} ${f.dim(`v${n.cliVersion}`)}`),console.log(``),console.log(`${f.bold(f.cyan(String(n.catalog.icons)))} ${f.dim(`icons`)} ${f.dim(`×`)} ${f.bold(String(n.catalog.styles))} ${f.dim(`styles`)} ${f.dim(`=`)} ${f.bold(f.cyan(String(n.catalog.variations)))} ${f.dim(`variations`)}  ${f.dim(`—`)}  ${f.bold(String(n.catalog.categories))} ${f.dim(`categories`)}`),console.log(f.dim(`─`.repeat(56))),n.packages.length>0){console.log(f.bold(`\nPackages (${n.packages.length})`));let e=Math.max(...n.packages.map(e=>e.name.length));for(let t of n.packages){let n=f.cyan(t.name.padEnd(e)),r=f.dim(`v${t.version}`.padEnd(8)),i=f.dim(t.description.length>58?`${t.description.slice(0,55)}…`:t.description);console.log(`  ${f.dim(`›`)} ${n}  ${r}  ${i}`)}}else console.log(f.dim(`
 Packages: (run inside monorepo to list versions)`));console.log(``),console.log(`${f.bold(`Figma`)}  ${f.underline(f.cyan(n.figma))}`),console.log(`${f.bold(`Docs `)}  ${f.underline(f.cyan(n.docs))}`),console.log(`${f.bold(`Icons`)}  ${f.underline(f.cyan(n.iconsExplorer))}`)});async function g(){await h.parseAsync(process.argv)}const _=process.argv[1]?l(process.argv[1]):void 0;_&&import.meta.url===d(_).href&&g();export{};

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { DOCS_URL, DeprecatedAlias, FIGMA_URL, FRAMEWORKS, Framework, ICONS_URL, IconDescription, Overview, PackageInfo, STYLES, Style, catalogStats, cdnSvgUrl, componentName, getOverview, importSnippet, listCategories, loadDescriptions, perFileComponentName, resolveIconName, resolveSvgPath, rootComponentName, rootImportSnippet, styleToPascal, toPascalKebab } from "./catalog.mjs";
+import { DOCS_URL, DeprecatedAlias, FIGMA_URL, FRAMEWORKS, Framework, ICONS_URL, IconDescription, Overview, PackageInfo, STYLES, Style, catalogStats, cdnSvgUrl, componentName, getOverview, importSnippet, listCategories, loadDescriptions, perFileComponentName, resolveIconName, resolveSvgPath, rootComponentName, rootImportSnippet, styleToPascal, toDartPath, toPascalKebab } from "./catalog.mjs";
 import { SearchOptions, SearchResult, searchCatalog } from "./search.mjs";
 import { runSearch } from "./commands/search.mjs";
 import { runGet } from "./commands/get.mjs";
 import { runList } from "./commands/list.mjs";
 import { runInfo } from "./commands/info.mjs";
-export { DOCS_URL, DeprecatedAlias, FIGMA_URL, FRAMEWORKS, Framework, ICONS_URL, IconDescription, Overview, PackageInfo, STYLES, SearchOptions, SearchResult, Style, catalogStats, cdnSvgUrl, componentName, getOverview, importSnippet, listCategories, loadDescriptions, perFileComponentName, resolveIconName, resolveSvgPath, rootComponentName, rootImportSnippet, runGet, runInfo, runList, runSearch, searchCatalog, styleToPascal, toPascalKebab };
+export { DOCS_URL, DeprecatedAlias, FIGMA_URL, FRAMEWORKS, Framework, ICONS_URL, IconDescription, Overview, PackageInfo, STYLES, SearchOptions, SearchResult, Style, catalogStats, cdnSvgUrl, componentName, getOverview, importSnippet, listCategories, loadDescriptions, perFileComponentName, resolveIconName, resolveSvgPath, rootComponentName, rootImportSnippet, runGet, runInfo, runList, runSearch, searchCatalog, styleToPascal, toDartPath, toPascalKebab };

package/dist/index.mjs

@@ -1 +1 @@
-import{DOCS_URL as e,FIGMA_URL as t,FRAMEWORKS as n,ICONS_URL as r,STYLES as i,catalogStats as a,cdnSvgUrl as o,componentName as s,getOverview as c,importSnippet as l,listCategories as u,loadDescriptions as d,perFileComponentName as f,resolveIconName as p,resolveSvgPath as m,rootComponentName as h,rootImportSnippet as g,styleToPascal as _,toPascalKebab as v}from"./catalog.mjs";import{searchCatalog as y}from"./search.mjs";import{runSearch as b}from"./commands/search.mjs";import{runGet as x}from"./commands/get.mjs";import{runList as S}from"./commands/list.mjs";import{runInfo as C}from"./commands/info.mjs";export{e as DOCS_URL,t as FIGMA_URL,n as FRAMEWORKS,r as ICONS_URL,i as STYLES,a as catalogStats,o as cdnSvgUrl,s as componentName,c as getOverview,l as importSnippet,u as listCategories,d as loadDescriptions,f as perFileComponentName,p as resolveIconName,m as resolveSvgPath,h as rootComponentName,g as rootImportSnippet,x as runGet,C as runInfo,S as runList,b as runSearch,y as searchCatalog,_ as styleToPascal,v as toPascalKebab};
+import{DOCS_URL as e,FIGMA_URL as t,FRAMEWORKS as n,ICONS_URL as r,STYLES as i,catalogStats as a,cdnSvgUrl as o,componentName as s,getOverview as c,importSnippet as l,listCategories as u,loadDescriptions as d,perFileComponentName as f,resolveIconName as p,resolveSvgPath as m,rootComponentName as h,rootImportSnippet as g,styleToPascal as _,toDartPath as v,toPascalKebab as y}from"./catalog.mjs";import{searchCatalog as b}from"./search.mjs";import{runSearch as x}from"./commands/search.mjs";import{runGet as S}from"./commands/get.mjs";import{runList as C}from"./commands/list.mjs";import{runInfo as w}from"./commands/info.mjs";export{e as DOCS_URL,t as FIGMA_URL,n as FRAMEWORKS,r as ICONS_URL,i as STYLES,a as catalogStats,o as cdnSvgUrl,s as componentName,c as getOverview,l as importSnippet,u as listCategories,d as loadDescriptions,f as perFileComponentName,p as resolveIconName,m as resolveSvgPath,h as rootComponentName,g as rootImportSnippet,S as runGet,w as runInfo,C as runList,x as runSearch,b as searchCatalog,_ as styleToPascal,v as toDartPath,y as toPascalKebab};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solar-icons/cli",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "private": false,
   "description": "CLI for Solar Icons — search, get and list 1,380 icons × 6 styles. Base for skills and MCP.",
   "keywords": [
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@solar-icons/static": "2.3.2",
+    "@solar-icons/static": "2.3.3",
     "commander": "^15.0.0",
     "picocolors": "^1.1.1"
   },