@fusion.dev/helix-docs 0.99.0 → 0.100.0

package/content/iconography.mdx

@@ -119,7 +119,41 @@ consumer's 15 kB to about 90.
 Only the default weight carries that index, so `name` draws bold. A consumer who
 wants the set in another weight imports the values and hands them over.
 
-## Adding one
+## A set of your own
+
+The generator that builds this set is the package's own command, so you are not
+waiting on us to carry a glyph:
+
+```sh
+npx helix-icons build --source ./brand-icons --out src/icons.ts
+```
+
+```tsx
+import { peak } from './icons'
+
+<helix-icon icon={peak} />
+```
+
+It reads a directory of SVG files and writes the module the element draws from,
+which is the same job whether the drawings are yours, another library's, or the
+1,404 Phosphor glyphs this set does not carry:
+
+```sh
+npx helix-icons build \
+  --source node_modules/@phosphor-icons/core/assets/regular \
+  --list mine.txt --out src/icons.ts
+```
+
+`--suffix` is for a set that spells the weight into the file name, Phosphor's
+bold being `caret-down-bold.svg`. `--index` also writes the record `name` reads,
+which you want if your own elements take a name in markup and do not want
+otherwise, since it is the part nothing can drop.
+
+**A name in two sources is refused rather than decided.** A precedence decides
+silently, and the glyph on the page would be whichever directory sat higher with
+nothing looking wrong afterwards.
+
+## Adding one to this set
 
 Add the name to `helix/icons/icons.txt` and run `turbo run icons`. Phosphor names
 resolve from `@phosphor-icons/core` at build time, so adding a glyph is adding a

package/content/metrics.mdx

@@ -396,7 +396,7 @@ column is what was removed rather than part of what remains.
 |---|---|---|---|---|
 | `@fusion.dev/helix-core` | 984,477 | 153 | 222,482 | `@floating-ui/dom`, `@fusion.dev/helix-icons` |
 | `@fusion.dev/helix-headless` | 11,366,181 | 464 | 836,952 | `@fusion.dev/helix-core`, `@fusion.dev/helix-icons`, `uqr` |
-| `@fusion.dev/helix-icons` | 121,091 | 17 | 37,263 | none |
+| `@fusion.dev/helix-icons` | 131,512 | 21 | 44,809 | `svgo` |
 | `@fusion.dev/helix-styles` | 101,139 | 6 | 0 | none |
 | `@fusion.dev/helix-theme` | 465,413 | 8 | 4,703 | none |
 | `@fusion.dev/helix` | 12,499,093 | 796 | 333,986 | `@fusion.dev/helix-core`, `@fusion.dev/helix-headless`, `@fusion.dev/helix-styles` |

package/dist/sources.generated.js

@@ -1570,7 +1570,41 @@ consumer's 15 kB to about 90.
 Only the default weight carries that index, so \`name\` draws bold. A consumer who
 wants the set in another weight imports the values and hands them over.
 
-## Adding one
+## A set of your own
+
+The generator that builds this set is the package's own command, so you are not
+waiting on us to carry a glyph:
+
+\`\`\`sh
+npx helix-icons build --source ./brand-icons --out src/icons.ts
+\`\`\`
+
+\`\`\`tsx
+import { peak } from './icons'
+
+<helix-icon icon={peak} />
+\`\`\`
+
+It reads a directory of SVG files and writes the module the element draws from,
+which is the same job whether the drawings are yours, another library's, or the
+1,404 Phosphor glyphs this set does not carry:
+
+\`\`\`sh
+npx helix-icons build \\
+  --source node_modules/@phosphor-icons/core/assets/regular \\
+  --list mine.txt --out src/icons.ts
+\`\`\`
+
+\`--suffix\` is for a set that spells the weight into the file name, Phosphor's
+bold being \`caret-down-bold.svg\`. \`--index\` also writes the record \`name\` reads,
+which you want if your own elements take a name in markup and do not want
+otherwise, since it is the part nothing can drop.
+
+**A name in two sources is refused rather than decided.** A precedence decides
+silently, and the glyph on the page would be whichever directory sat higher with
+nothing looking wrong afterwards.
+
+## Adding one to this set
 
 Add the name to \`helix/icons/icons.txt\` and run \`turbo run icons\`. Phosphor names
 resolve from \`@phosphor-icons/core\` at build time, so adding a glyph is adding a
@@ -2428,7 +2462,7 @@ column is what was removed rather than part of what remains.
 |---|---|---|---|---|
 | \`@fusion.dev/helix-core\` | 984,477 | 153 | 222,482 | \`@floating-ui/dom\`, \`@fusion.dev/helix-icons\` |
 | \`@fusion.dev/helix-headless\` | 11,366,181 | 464 | 836,952 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-icons\`, \`uqr\` |
-| \`@fusion.dev/helix-icons\` | 121,091 | 17 | 37,263 | none |
+| \`@fusion.dev/helix-icons\` | 131,512 | 21 | 44,809 | \`svgo\` |
 | \`@fusion.dev/helix-styles\` | 101,139 | 6 | 0 | none |
 | \`@fusion.dev/helix-theme\` | 465,413 | 8 | 4,703 | none |
 | \`@fusion.dev/helix\` | 12,499,093 | 796 | 333,986 | \`@fusion.dev/helix-core\`, \`@fusion.dev/helix-headless\`, \`@fusion.dev/helix-styles\` |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-docs",
   "description": "Versioned documentation content and registry for Helix.",
-  "version": "0.99.0",
+  "version": "0.100.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -36,8 +36,8 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.99.0",
-    "@fusion.dev/helix-testing": "0.99.0",
+    "@fusion.dev/helix-cem": "0.100.0",
+    "@fusion.dev/helix-testing": "0.100.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "lit": "^3.2.1",
     "playwright": "^1.62.1"