@svgicons-com/cli 0.1.0-alpha.4 → 0.1.0-alpha.5

package/README.md

@@ -8,7 +8,7 @@ Public icon search works without changing the default endpoint. Pro workflows re
 
 The scanner is read-only by default. It never edits project files unless a future command explicitly adds that behavior.
 
-Current package version: `0.1.0-alpha.3`.
+Current package version: `0.1.0-alpha.5`.
 
 ## Requirements
 
@@ -70,8 +70,15 @@ svgicons collection add "Dashboard icons" 33716 240297
 svgicons collection remove "Dashboard icons" 33716-arrow-circle-up-fill
 svgicons collection delete "Dashboard icons" --yes
 svgicons collection export "Dashboard icons" --formats react-ts,vue --color-policy currentColor --output ./exports
+svgicons collection export "Dashboard icons" --formats svelte --output ./exports
+svgicons collection export "Dashboard icons" --formats solid --output ./exports
+svgicons collection export "Dashboard icons" --formats blade --output ./exports
+svgicons collection export "Dashboard icons" --formats storybook --output ./exports
+svgicons collection export "Dashboard icons" --formats npm-package --package-name svgicons-dashboard-icons --output ./exports
 svgicons collection export "Dashboard icons" --formats png-pack --png-sizes 24,48,512 --output ./exports
+svgicons collection export "Dashboard icons" --formats iconify-json --output ./exports
 svgicons collection export "Dashboard icons" --formats react-ts --no-size-props --no-typescript --output ./exports
+svgicons collection export "Dashboard icons" --formats react-ts,solid --default-size 20 --component-suffix Glyph --no-decorative --output ./exports
 svgicons export status 55 --collection "Dashboard icons"
 svgicons export download 55 --collection "Dashboard icons" --output ./exports
 svgicons init --collection "Dashboard icons" --output ./src/icons
@@ -186,11 +193,17 @@ The command polls every 2 seconds for up to 180 seconds by default. Use `--timeo
 Supported export flags:
 
 ```bash
---formats react-ts,vue,png-pack
+--formats react-ts,vue,svelte,solid,blade,storybook,npm-package,png-pack,iconify-json
 --color-policy currentColor|preserve|strip
 --naming-policy kebab|pascal|camel
 --size-props / --no-size-props
 --typescript / --no-typescript
+--default-size 24
+--title-prop / --no-title-prop
+--decorative / --no-decorative
+--component-suffix Icon
+--package-name svgicons-dashboard-icons
+--package-version 0.1.0
 --png-sizes 24,48,512
 --png-densities 1,2
 --png-background transparent|solid
@@ -200,7 +213,7 @@ Supported export flags:
 --png-padding 48
 ```
 
-Use `--formats png` as a shorthand for `--formats png-pack`. PNG pack exports are generated by the server queue worker and downloaded as part of the collection ZIP.
+Use `--formats png` as a shorthand for `--formats png-pack`. PNG pack exports are generated by the server queue worker and downloaded as part of the collection ZIP. Use `--formats svelte` to include Svelte components, `--formats solid` to include Solid components, `--formats blade` to include Laravel Blade components, `--formats storybook` to include a React Storybook gallery, `--formats npm-package` to include a React TypeScript package scaffold, or `--formats iconify-json` to include an Iconify-compatible `iconify.json` file in the collection ZIP.
 
 Collection commands accept a numeric ID, exact slug, or exact case-insensitive collection name. The legacy `kit` alias remains available for old scripts.
 

package/RELEASE_NOTES.md

@@ -1,4 +1,27 @@
-# Svg/icons CLI 0.1.0-alpha.3
+# Svg/icons CLI 0.1.0-alpha.5
+
+This alpha refresh keeps the npm alpha channel aligned with the current Svg/icons Pro export workflow.
+
+## New in 0.1.0-alpha.5
+
+- Version bump for npm alpha publication after `0.1.0-alpha.4`.
+- No runtime command changes from `0.1.0-alpha.4`.
+- Keeps the package README and release notes aligned with the current CLI export surface.
+
+## 0.1.0-alpha.4
+
+This alpha brought the CLI up to date with the current Svg/icons Pro export workflow.
+
+- Added single-icon PNG export with `svgicons icon png`, including PNG and ZIP variant downloads.
+- Added collection PNG pack export with size, density, background, color, padding, and fit options.
+- Added collection export format support for `svelte`, `solid`, `blade`, `storybook`, `npm-package`, and `iconify-json`.
+- Added `png` as a shorthand for the `png-pack` collection export format.
+- Added safe framework export options: `--default-size`, `--component-suffix`, `--title-prop`, `--no-title-prop`, `--decorative`, and `--no-decorative`.
+- Added npm package export metadata options: `--package-name` and `--package-version`.
+- Added `svgicons export download <export-id> --collection <collection>` for downloading queued collection export ZIPs.
+- Updated CLI docs and tests for the newer Pro API export formats.
+
+## 0.1.0-alpha.3
 
 This alpha refresh improves token setup safety. `login` now rejects obviously truncated numeric tokens, which commonly happens when a shell command is run without quoting a Sanctum-style token containing `|`.
 
@@ -44,6 +67,7 @@ Before publishing, run:
 
 ```bash
 npm --prefix cli test
+cd cli
 npm pack --dry-run
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svgicons-com/cli",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "description": "Svg/icons CLI alpha for icon search, Pro collections, exports, project scanning, and license workflows.",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
     "RELEASE_NOTES.md"
   ],
   "scripts": {
-    "test": "node --test tests"
+    "test": "node --test"
   },
   "engines": {
     "node": ">=18.18"

package/src/cli.js

@@ -57,7 +57,21 @@ const KNOWN_SCOPES = [
   'exports:create',
   'mcp:use',
 ];
-const EXPORT_FORMATS = ['svg-folder', 'svg-sprite', 'json-manifest', 'license-manifest', 'react-ts', 'vue', 'png-pack'];
+const EXPORT_FORMATS = [
+  'svg-folder',
+  'svg-sprite',
+  'json-manifest',
+  'license-manifest',
+  'react-ts',
+  'vue',
+  'svelte',
+  'solid',
+  'blade',
+  'storybook',
+  'npm-package',
+  'png-pack',
+  'iconify-json',
+];
 const FRAMEWORKS = ['svg', 'react-ts', 'vue', 'sprite'];
 const COLOR_POLICIES = ['currentColor', 'preserve', 'strip'];
 const NAMING_POLICIES = ['kebab', 'pascal', 'camel'];
@@ -1218,7 +1232,7 @@ async function buildProject(args) {
   const format = options.format || manifest.format || 'svg';
 
   if (format !== 'svg') {
-    throw usageError('Local build currently supports format svg. Use collection export for React TypeScript or Vue component ZIPs.');
+    throw usageError('Local build currently supports format svg. Use collection export for React TypeScript, Vue, Svelte, or Solid component ZIPs.');
   }
 
   const outputDir = resolve(String(options.output || options.o || manifest.output));
@@ -1889,6 +1903,12 @@ function buildExportOptions(options) {
       namingPolicy: enumOption(options['naming-policy'], 'naming policy', NAMING_POLICIES),
       sizeProps: booleanFlagPair(options, 'size-props', 'no-size-props'),
       typescript: booleanFlagPair(options, 'typescript', 'no-typescript'),
+      defaultSize: boundedIntegerOption(options['default-size'], 'default component size', 1, 1024),
+      titleProp: booleanFlagPair(options, 'title-prop', 'no-title-prop'),
+      decorative: booleanFlagPair(options, 'decorative', 'no-decorative'),
+      componentSuffix: identifierOption(options['component-suffix'], 'component suffix'),
+      packageName: packageNameOption(options['package-name']),
+      packageVersion: packageVersionOption(options['package-version']),
       png: includesPng ? png : undefined,
     },
   };
@@ -1969,6 +1989,59 @@ function integerOption(value, label) {
   return parsed;
 }
 
+function boundedIntegerOption(value, label, min, max) {
+  const parsed = integerOption(value, label);
+
+  if (parsed === undefined) {
+    return undefined;
+  }
+
+  if (parsed < min || parsed > max) {
+    throw usageError(`Invalid ${label}: ${value}. Allowed range: ${min}-${max}.`);
+  }
+
+  return parsed;
+}
+
+function identifierOption(value, label) {
+  if (value === undefined || value === true || value === '') {
+    return undefined;
+  }
+
+  const parsed = String(value);
+  if (!/^[A-Za-z][A-Za-z0-9]{0,31}$/.test(parsed)) {
+    throw usageError(`Invalid ${label}: ${value}. Use 1-32 letters or numbers, starting with a letter.`);
+  }
+
+  return parsed;
+}
+
+function packageNameOption(value) {
+  if (value === undefined || value === true || value === '') {
+    return undefined;
+  }
+
+  const parsed = String(value);
+  if (parsed.length > 214 || parsed.toLowerCase() !== parsed || !/^(?:@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*|[a-z0-9][a-z0-9._-]*)$/.test(parsed)) {
+    throw usageError(`Invalid npm package name: ${value}. Use a lowercase npm package name such as svgicons-dashboard or @svgicons-com/dashboard.`);
+  }
+
+  return parsed;
+}
+
+function packageVersionOption(value) {
+  if (value === undefined || value === true || value === '') {
+    return undefined;
+  }
+
+  const parsed = String(value);
+  if (parsed.length > 64 || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(parsed)) {
+    throw usageError(`Invalid npm package version: ${value}. Use a semver-like version such as 1.0.0 or 1.0.0-beta.1.`);
+  }
+
+  return parsed;
+}
+
 function stripUndefined(value) {
   return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
 }
@@ -2035,7 +2108,7 @@ Usage:
   svgicons collection add <collection-id-or-name> <icon-id...>
   svgicons collection remove <collection-id-or-name> <icon-id...>
   svgicons collection delete <collection-id-or-name> [--yes]
-  svgicons collection export <collection-id-or-name> [--formats react-ts,vue,png-pack] [--png-sizes 24,48,512] [--no-size-props] [--no-typescript] [--output ./exports]
+  svgicons collection export <collection-id-or-name> [--formats react-ts,vue,svelte,solid,blade,storybook,npm-package,png-pack,iconify-json] [--default-size 24] [--component-suffix Icon] [--package-name svgicons-dashboard] [--package-version 0.1.0] [--title-prop|--no-title-prop] [--decorative|--no-decorative] [--no-size-props] [--no-typescript] [--output ./exports]
   svgicons export status <export-id> --collection <collection-id-or-name>
   svgicons export download <export-id> --collection <collection-id-or-name> [--output ./exports]
   svgicons init [--collection <collection-id-or-name>] [--output svgicons-icons]