@kolkrabbi/kol-icons 0.31.0 → 0.32.0

package/bin/kol-icons.mjs

@@ -3,7 +3,7 @@
  * kol-icons CLI — `npx kol-icons audit`
  *
  * Scans the current repo's `<Icon name>` / `iconLeft` / `icon:` usage and classifies
- * each name against the shipped sets: in kol-icon-set-v1 (curated ✓), legacy-only
+ * each name against the shipped sets: in kol-icon-set-interface (curated ✓), legacy-only
  * (breaks when legacy is dropped — migrate or registerIcons), or not-in-package
  * (a locally-registered icon, or a typo). Dependency-free.
  */
@@ -12,7 +12,7 @@ import { join, dirname, extname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 if (process.argv[2] !== 'audit') {
-  console.log('kol-icons — usage:\n  npx kol-icons audit    scan this repo for icon usage vs kol-icon-set-v1\n')
+  console.log('kol-icons — usage:\n  npx kol-icons audit    scan this repo for icon usage vs kol-icon-set-interface\n')
   process.exit(0)
 }
 
@@ -32,7 +32,7 @@ const svgNames = (rel) => {
   walk(join(PKG, 'src', rel))
   return out
 }
-const v1 = svgNames('kol-icon-set-v1')
+const v1 = svgNames('kol-icon-set-interface')
 const legacy = new Set([...svgNames('stroke'), ...svgNames('solid'), ...svgNames('svg'), ...svgNames('svg-web')])
 
 // scan the consumer repo (cwd) for icon usage

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kolkrabbi/kol-icons",
-  "version": "0.31.0",
-  "description": "KOL icons — <Icon/>, the curated kol-icon-set-v1 + registerIcons (bring-your-own), and the legacy inventory. Vite-only (import.meta.glob).",
+  "version": "0.32.0",
+  "description": "The icon loader and icon sets",
   "license": "MIT",
   "type": "module",
   "main": "./src/index.js",

package/src/Icon.jsx

@@ -1,7 +1,7 @@
 /**
  * Icon Component
  *
- * Dynamically loads and renders SVG icons from kol-icon-set-v1 and
+ * Dynamically loads and renders SVG icons from kol-icon-set-interface and
  * kol-icon-set-signal (or consumer-registered sets)
  *
  * @param {Object} props
@@ -13,7 +13,7 @@
  */
 import { useEffect, useState } from 'react'
 
-/* ONE icon home: kol-icon-set-v1. Legacy sets removed 0.8.0 (2026-07-28) —
+/* ONE icon home: kol-icon-set-interface. Legacy sets removed 0.8.0 (2026-07-28) —
  * a name either resolves from v1 or from consumer-registered SVGs, nothing else.
  *
  * The raw SVG strings live in ./iconData.js and are pulled in via a single
@@ -75,7 +75,7 @@ export const registerIcons = (globMap) => {
   }
 }
 
-/* Resolution order: consumer-registered → kol-icon-set-v1 → kol-icon-set-signal.
+/* Resolution order: consumer-registered → kol-icon-set-interface → kol-icon-set-signal.
  * That's the whole chain — a miss is a real miss.
  *
  * v1 BEFORE signal, and it decides the twelve names both sets drew (2026-08-28):

package/src/iconData.js

@@ -1,5 +1,5 @@
 /**
- * iconData — the raw SVG maps behind <Icon>: kol-icon-set-v1 and
+ * iconData — the raw SVG maps behind <Icon>: kol-icon-set-interface and
  * kol-icon-set-signal.
  *
  * The SVGs are eager-inlined here as raw strings, but this module is only
@@ -11,7 +11,7 @@
  * v1-only by user ruling. Consumers needing a dead name registerIcons() their
  * own SVG or promote a glyph into v1 here.
  */
-const v1Modules = import.meta.glob('./kol-icon-set-v1/**/*.svg', { eager: true, query: '?raw', import: 'default' })
+const v1Modules = import.meta.glob('./kol-icon-set-interface/**/*.svg', { eager: true, query: '?raw', import: 'default' })
 /* kol-icon-set-signal (2026-08-28) — the signal-flow set: waveforms, filters,
  * logic gates, dither patterns, shapers, transport, cables. Drawn for the
  * instrument surfaces (kol-mirror's rack, kol-fxr's labs) rather than for app

package/src/index.js

@@ -4,7 +4,8 @@
  * Export Icon component and icon registry.
  * Usage: <Icon name="arrow-up" size={16} />
  *
- * TWO SETS (2026-08-28). `kol-icon-set-v1` is the general set — app chrome,
+ * TWO SETS (2026-08-28). `kol-icon-set-interface` (named `kol-icon-set-v1` until 2026-09-30 — user:
+ * "icons v1 is a terrible icon set name") is the general set — app chrome,
  * navigation, files, media. `kol-icon-set-signal` is the signal-flow set:
  * waveforms, filters, logic gates, dither patterns, shapers, ramps, transport,
  * cables, color harmony — drawn for instrument surfaces (kol-mirror's rack,
@@ -23,11 +24,11 @@
 export { default as Icon, registerIcons } from './Icon.jsx';
 import CUTS from './cuts.json';
 
-/* kol-icon-set-v1 — the curated set, grouped by folder (keys-only, no SVG
- * content): `{ group: names[] }`. KOL_ICON_SET_V1_NAMES is the flat sorted list. */
-export const KOL_ICON_SET_V1 = (() => {
+/* kol-icon-set-interface — the curated set, grouped by folder (keys-only, no SVG
+ * content): `{ group: names[] }`. KOL_ICON_SET_INTERFACE_NAMES is the flat sorted list. */
+export const KOL_ICON_SET_INTERFACE = (() => {
   const idx = {}
-  for (const p of Object.keys(import.meta.glob('./kol-icon-set-v1/**/*.svg'))) {
+  for (const p of Object.keys(import.meta.glob('./kol-icon-set-interface/**/*.svg'))) {
     const parts = p.split('/')
     const name = (parts.pop() || '').replace('.svg', '')
     const group = parts.pop() || 'misc'
@@ -37,7 +38,7 @@ export const KOL_ICON_SET_V1 = (() => {
   return idx
 })()
 
-export const KOL_ICON_SET_V1_NAMES = Object.values(KOL_ICON_SET_V1).flat().sort()
+export const KOL_ICON_SET_INTERFACE_NAMES = Object.values(KOL_ICON_SET_INTERFACE).flat().sort()
 
 /* kol-icon-set-signal — same shape, same rules, its own folder. */
 export const KOL_ICON_SET_SIGNAL = (() => {
@@ -62,18 +63,25 @@ export const KOL_ICON_SET_SIGNAL_NAMES = Object.values(KOL_ICON_SET_SIGNAL).flat
 const metaOf = (index, set) => Object.fromEntries(
   Object.entries(index).flatMap(([group, names]) => names.map((name) => [name, { group, set, cut: CUTS[name] ?? 'stroke' }])),
 )
-export const KOL_ICON_SET_V1_META = metaOf(KOL_ICON_SET_V1, 'v1')
+export const KOL_ICON_SET_INTERFACE_META = metaOf(KOL_ICON_SET_INTERFACE, 'interface')
 export const KOL_ICON_SET_SIGNAL_META = metaOf(KOL_ICON_SET_SIGNAL, 'signal')
 /* every glyph the package ships, either set — `{ name: { group, set, cut } }` */
-export const KOL_ICON_META = { ...KOL_ICON_SET_SIGNAL_META, ...KOL_ICON_SET_V1_META }
+export const KOL_ICON_META = { ...KOL_ICON_SET_SIGNAL_META, ...KOL_ICON_SET_INTERFACE_META }
 export const getCut = (name) => KOL_ICON_META[name]?.cut ?? null
 export const getSet = (name) => KOL_ICON_META[name]?.set ?? null
 
-/* Canonical grouped registry — alias of the v1 index (legacy inventories
+/* Canonical grouped registry — alias of the interface index (legacy inventories
  * ICON_ENTRIES / SOLID_ICON_ENTRIES / ICON_INDEX died with the legacy sets). */
-export const ICONS = KOL_ICON_SET_V1;
+export const ICONS = KOL_ICON_SET_INTERFACE;
 // Flat array of all icon names — BOTH sets, since <Icon> resolves either.
-export const ALL_ICONS = [...new Set([...KOL_ICON_SET_V1_NAMES, ...KOL_ICON_SET_SIGNAL_NAMES])].sort();
+export const ALL_ICONS = [...new Set([...KOL_ICON_SET_INTERFACE_NAMES, ...KOL_ICON_SET_SIGNAL_NAMES])].sort();
+
+/** @deprecated 2026-09-30 → KOL_ICON_SET_INTERFACE — the set was renamed; the icon names did not change */
+export const KOL_ICON_SET_V1 = KOL_ICON_SET_INTERFACE
+/** @deprecated 2026-09-30 → KOL_ICON_SET_INTERFACE_NAMES */
+export const KOL_ICON_SET_V1_NAMES = KOL_ICON_SET_INTERFACE_NAMES
+/** @deprecated 2026-09-30 → KOL_ICON_SET_INTERFACE_META */
+export const KOL_ICON_SET_V1_META = KOL_ICON_SET_INTERFACE_META
 
 // Helper to check if an icon exists
 export const hasIcon = (name) => ALL_ICONS.includes(name);