@common-origin/design-system 3.2.0 → 3.3.0

package/dist/styles/iconSet.json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconSet.json.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/types/iconSet.d.mts

@@ -0,0 +1,6 @@
+import type { IconSet } from './icons.mjs';
+/**
+ * Every icon `Icon` draws, keyed by `IconName`, with its metadata, its source and its shapes
+ * (decision 0058). Read it to list icons or to draw one outside `Icon`.
+ */
+export declare const iconSet: IconSet;

package/dist/types/iconSet.d.ts

@@ -0,0 +1,6 @@
+import type { IconSet } from './icons';
+/**
+ * Every icon `Icon` draws, keyed by `IconName`, with its metadata, its source and its shapes
+ * (decision 0058). Read it to list icons or to draw one outside `Icon`.
+ */
+export declare const iconSet: IconSet;

package/dist/types/iconSet.mjs

@@ -0,0 +1,12 @@
+import iconSetJson from '../styles/iconSet.json.mjs';
+
+/**
+ * Every icon `Icon` draws, keyed by `IconName`, with its metadata, its source and its shapes
+ * (decision 0058). Read it to list icons or to draw one outside `Icon`.
+ */
+// Cast through unknown: JSON imports infer arrays, not the element tuples. iconSet.test.ts checks
+// the data really has this shape. Typed so emitted .d.ts files don't import JSON.
+var iconSet = iconSetJson;
+
+export { iconSet };
+//# sourceMappingURL=iconSet.mjs.map

package/dist/types/iconSet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconSet.mjs","sources":["../../src/types/iconSet.ts"],"sourcesContent":["import iconSetJson from '../styles/iconSet.json'\nimport type { IconSet } from './icons'\n\n/**\n * Every icon `Icon` draws, keyed by `IconName`, with its metadata, its source and its shapes\n * (decision 0058). Read it to list icons or to draw one outside `Icon`.\n */\n// Cast through unknown: JSON imports infer arrays, not the element tuples. iconSet.test.ts checks\n// the data really has this shape. Typed so emitted .d.ts files don't import JSON.\nexport const iconSet = iconSetJson as unknown as IconSet\n"],"names":["iconSet","iconSetJson"],"mappings":";;AAGA;;;AAGG;AACH;AACA;AACO,IAAMA,OAAO,GAAGC;;;;"}

package/dist/types/icons.d.mts

@@ -1,10 +1,12 @@
-export type IconName = 'add' | 'ai' | 'addRing' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp' | 'back' | 'bell' | 'cancel' | 'caret' | 'caretDown' | 'caretUp' | 'check' | 'checkRing' | 'close' | 'copy' | 'creditCard' | 'crossCircle' | 'directionRight' | 'directionUp' | 'edit' | 'export' | 'fileDocSearch' | 'filter' | 'home' | 'info' | 'kebab' | 'lamp' | 'lineOut' | 'link' | 'meatballs' | 'menu' | 'message' | 'move' | 'mic' | 'order' | 'paper' | 'pause' | 'play' | 'playBack' | 'refresh' | 'remove' | 'search' | 'sidebar' | 'star' | 'starFilled' | 'statusCancelled' | 'statusError' | 'statusInProgress' | 'statusInfo' | 'statusNotStarted' | 'statusPending' | 'statusScheduled' | 'statusSerious' | 'statusSuccess' | 'statusWarning' | 'stop' | 'table' | 'trash' | 'userBox' | 'view' | 'viewHide' | 'wallet';
+/**
+ * Every icon `Icon` can draw: the keys of `iconSet` (decision 0058). Generated by
+ * `npm run icon:add` from `iconSet.json`; don't edit it by hand.
+ */
+export type IconName = 'add' | 'addRing' | 'ai' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp' | 'back' | 'bell' | 'cancel' | 'caret' | 'caretDown' | 'caretUp' | 'check' | 'checkRing' | 'close' | 'copy' | 'creditCard' | 'crossCircle' | 'directionRight' | 'directionUp' | 'edit' | 'export' | 'fileDocSearch' | 'filter' | 'home' | 'info' | 'kebab' | 'lamp' | 'lineOut' | 'link' | 'meatballs' | 'menu' | 'message' | 'mic' | 'move' | 'order' | 'paper' | 'pause' | 'play' | 'playBack' | 'refresh' | 'remove' | 'search' | 'sidebar' | 'star' | 'starFilled' | 'statusCancelled' | 'statusError' | 'statusInProgress' | 'statusInfo' | 'statusNotStarted' | 'statusPending' | 'statusScheduled' | 'statusSerious' | 'statusSuccess' | 'statusWarning' | 'stop' | 'table' | 'trash' | 'userBox' | 'view' | 'viewHide' | 'wallet';
 /** Semantic category for grouping icons by purpose */
 export type IconCategory = 'action' | 'communication' | 'content' | 'feedback' | 'media' | 'navigation' | 'object' | 'status' | 'user';
-/** Enriched metadata for each icon entry in icons.json */
-export interface IconMetadata {
-    /** SVG path data */
-    path: string;
+/** Metadata every icon carries, whatever its format */
+export interface IconDescription {
     /** Display name of the icon */
     name: string;
     /** What the icon visually depicts */
@@ -20,6 +22,56 @@ export interface IconMetadata {
     /** Suggested accessible label when the icon conveys meaning */
     ariaLabelDefault: string;
 }
-/** The full icon registry keyed by IconName */
+/** The SVG shapes an icon is drawn from */
+export type IconElementTag = 'path' | 'circle' | 'ellipse' | 'rect' | 'line' | 'polyline' | 'polygon';
+/**
+ * One shape of an icon: its tag and its geometry attributes (`d`, `cx`, `points`…), on a 24px
+ * grid, plus `fill: 'currentColor'` for a filled dot. Lucide's own format, so icons copy across
+ * unchanged.
+ */
+export type IconElement = [tag: IconElementTag, attributes: Record<string, string>];
+/**
+ * How an icon is painted, always in `currentColor`:
+ * - `stroke`: 2px lines with round caps and joins, no fill (Lucide icons)
+ * - `fill`: solid shapes, no line
+ * - `both`: lines and a fill, such as a filled star
+ */
+export type IconPaint = 'stroke' | 'fill' | 'both';
+/**
+ * Where an icon comes from (decision 0058): copied from Lucide, with its Lucide name, or
+ * maintained in this repository. Icons carried over from 3.2.0 are `common-origin` until they move
+ * to Lucide.
+ */
+export type IconSource = {
+    library: 'lucide';
+    name: string;
+} | {
+    library: 'common-origin';
+};
+/** An icon in `iconSet`: its metadata, where it comes from, and how to draw it */
+export interface IconDefinition extends IconDescription {
+    source: IconSource;
+    paint: IconPaint;
+    elements: IconElement[];
+}
+/** The icon set keyed by IconName */
+export type IconSet = Record<IconName, IconDefinition>;
+/**
+ * An entry in the frozen `iconsData`: one filled path and its metadata.
+ * @deprecated Use `IconDefinition` and `iconSet`. Removed in 4.0 (decision 0058).
+ */
+export interface IconMetadata extends IconDescription {
+    /** SVG path data */
+    path: string;
+}
+/**
+ * The type of the frozen `iconsData`.
+ * @deprecated Use `IconSet` and `iconSet`. Removed in 4.0 (decision 0058).
+ */
 export type IconRegistry = Record<IconName, IconMetadata>;
+/**
+ * The 64 icons as they were in 3.2.0, each one filled path. Frozen: icons added since have no
+ * entry here, and `Icon` no longer reads it.
+ * @deprecated Use `iconSet`, which holds every icon `Icon` draws. Removed in 4.0 (decision 0058).
+ */
 export declare const iconsData: IconRegistry;

package/dist/types/icons.d.ts

@@ -1,10 +1,12 @@
-export type IconName = 'add' | 'ai' | 'addRing' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp' | 'back' | 'bell' | 'cancel' | 'caret' | 'caretDown' | 'caretUp' | 'check' | 'checkRing' | 'close' | 'copy' | 'creditCard' | 'crossCircle' | 'directionRight' | 'directionUp' | 'edit' | 'export' | 'fileDocSearch' | 'filter' | 'home' | 'info' | 'kebab' | 'lamp' | 'lineOut' | 'link' | 'meatballs' | 'menu' | 'message' | 'move' | 'mic' | 'order' | 'paper' | 'pause' | 'play' | 'playBack' | 'refresh' | 'remove' | 'search' | 'sidebar' | 'star' | 'starFilled' | 'statusCancelled' | 'statusError' | 'statusInProgress' | 'statusInfo' | 'statusNotStarted' | 'statusPending' | 'statusScheduled' | 'statusSerious' | 'statusSuccess' | 'statusWarning' | 'stop' | 'table' | 'trash' | 'userBox' | 'view' | 'viewHide' | 'wallet';
+/**
+ * Every icon `Icon` can draw: the keys of `iconSet` (decision 0058). Generated by
+ * `npm run icon:add` from `iconSet.json`; don't edit it by hand.
+ */
+export type IconName = 'add' | 'addRing' | 'ai' | 'arrowDown' | 'arrowLeft' | 'arrowRight' | 'arrowUp' | 'back' | 'bell' | 'cancel' | 'caret' | 'caretDown' | 'caretUp' | 'check' | 'checkRing' | 'close' | 'copy' | 'creditCard' | 'crossCircle' | 'directionRight' | 'directionUp' | 'edit' | 'export' | 'fileDocSearch' | 'filter' | 'home' | 'info' | 'kebab' | 'lamp' | 'lineOut' | 'link' | 'meatballs' | 'menu' | 'message' | 'mic' | 'move' | 'order' | 'paper' | 'pause' | 'play' | 'playBack' | 'refresh' | 'remove' | 'search' | 'sidebar' | 'star' | 'starFilled' | 'statusCancelled' | 'statusError' | 'statusInProgress' | 'statusInfo' | 'statusNotStarted' | 'statusPending' | 'statusScheduled' | 'statusSerious' | 'statusSuccess' | 'statusWarning' | 'stop' | 'table' | 'trash' | 'userBox' | 'view' | 'viewHide' | 'wallet';
 /** Semantic category for grouping icons by purpose */
 export type IconCategory = 'action' | 'communication' | 'content' | 'feedback' | 'media' | 'navigation' | 'object' | 'status' | 'user';
-/** Enriched metadata for each icon entry in icons.json */
-export interface IconMetadata {
-    /** SVG path data */
-    path: string;
+/** Metadata every icon carries, whatever its format */
+export interface IconDescription {
     /** Display name of the icon */
     name: string;
     /** What the icon visually depicts */
@@ -20,6 +22,56 @@ export interface IconMetadata {
     /** Suggested accessible label when the icon conveys meaning */
     ariaLabelDefault: string;
 }
-/** The full icon registry keyed by IconName */
+/** The SVG shapes an icon is drawn from */
+export type IconElementTag = 'path' | 'circle' | 'ellipse' | 'rect' | 'line' | 'polyline' | 'polygon';
+/**
+ * One shape of an icon: its tag and its geometry attributes (`d`, `cx`, `points`…), on a 24px
+ * grid, plus `fill: 'currentColor'` for a filled dot. Lucide's own format, so icons copy across
+ * unchanged.
+ */
+export type IconElement = [tag: IconElementTag, attributes: Record<string, string>];
+/**
+ * How an icon is painted, always in `currentColor`:
+ * - `stroke`: 2px lines with round caps and joins, no fill (Lucide icons)
+ * - `fill`: solid shapes, no line
+ * - `both`: lines and a fill, such as a filled star
+ */
+export type IconPaint = 'stroke' | 'fill' | 'both';
+/**
+ * Where an icon comes from (decision 0058): copied from Lucide, with its Lucide name, or
+ * maintained in this repository. Icons carried over from 3.2.0 are `common-origin` until they move
+ * to Lucide.
+ */
+export type IconSource = {
+    library: 'lucide';
+    name: string;
+} | {
+    library: 'common-origin';
+};
+/** An icon in `iconSet`: its metadata, where it comes from, and how to draw it */
+export interface IconDefinition extends IconDescription {
+    source: IconSource;
+    paint: IconPaint;
+    elements: IconElement[];
+}
+/** The icon set keyed by IconName */
+export type IconSet = Record<IconName, IconDefinition>;
+/**
+ * An entry in the frozen `iconsData`: one filled path and its metadata.
+ * @deprecated Use `IconDefinition` and `iconSet`. Removed in 4.0 (decision 0058).
+ */
+export interface IconMetadata extends IconDescription {
+    /** SVG path data */
+    path: string;
+}
+/**
+ * The type of the frozen `iconsData`.
+ * @deprecated Use `IconSet` and `iconSet`. Removed in 4.0 (decision 0058).
+ */
 export type IconRegistry = Record<IconName, IconMetadata>;
+/**
+ * The 64 icons as they were in 3.2.0, each one filled path. Frozen: icons added since have no
+ * entry here, and `Icon` no longer reads it.
+ * @deprecated Use `iconSet`, which holds every icon `Icon` draws. Removed in 4.0 (decision 0058).
+ */
 export declare const iconsData: IconRegistry;

package/dist/types/icons.mjs

@@ -3,6 +3,11 @@ import iconsJson from '../styles/icons.json.mjs';
 // Icon type definitions for external consumption
 // This is a self-contained type that doesn't depend on JSON imports
 // to ensure it works correctly in consuming projects
+/**
+ * The 64 icons as they were in 3.2.0, each one filled path. Frozen: icons added since have no
+ * entry here, and `Icon` no longer reads it.
+ * @deprecated Use `iconSet`, which holds every icon `Icon` draws. Removed in 4.0 (decision 0058).
+ */
 // Typed as IconRegistry so emitted .d.ts files don't import JSON (needs `resolveJsonModule` in consumers).
 var iconsData = iconsJson;
 

package/dist/types/icons.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"icons.mjs","sources":["../../src/types/icons.ts"],"sourcesContent":["// Icon type definitions for external consumption\n// This is a self-contained type that doesn't depend on JSON imports\n// to ensure it works correctly in consuming projects\n\nimport iconsJson from '../styles/icons.json'\n\nexport type IconName =\n  | 'add'\n  | 'ai'\n  | 'addRing'\n  | 'arrowDown'\n  | 'arrowLeft'\n  | 'arrowRight'\n  | 'arrowUp'\n  | 'back'\n  | 'bell'\n  | 'cancel'\n  | 'caret'\n  | 'caretDown'\n  | 'caretUp'\n  | 'check'\n  | 'checkRing'\n  | 'close'\n  | 'copy'\n  | 'creditCard'\n  | 'crossCircle'\n  | 'directionRight'\n  | 'directionUp'\n  | 'edit'\n  | 'export'\n  | 'fileDocSearch'\n  | 'filter'\n  | 'home'\n  | 'info'\n  | 'kebab'\n  | 'lamp'\n  | 'lineOut'\n  | 'link'\n  | 'meatballs'\n  | 'menu'\n  | 'message'\n  | 'move'\n  | 'mic'\n  | 'order'\n  | 'paper'\n  | 'pause'\n  | 'play'\n  | 'playBack'\n  | 'refresh'\n  | 'remove'\n  | 'search'\n  | 'sidebar'\n  | 'star'\n  | 'starFilled'\n  | 'statusCancelled'\n  | 'statusError'\n  | 'statusInProgress'\n  | 'statusInfo'\n  | 'statusNotStarted'\n  | 'statusPending'\n  | 'statusScheduled'\n  | 'statusSerious'\n  | 'statusSuccess'\n  | 'statusWarning'\n  | 'stop'\n  | 'table'\n  | 'trash'\n  | 'userBox'\n  | 'view'\n  | 'viewHide'\n  | 'wallet'\n\n/** Semantic category for grouping icons by purpose */\nexport type IconCategory =\n  | 'action'\n  | 'communication'\n  | 'content'\n  | 'feedback'\n  | 'media'\n  | 'navigation'\n  | 'object'\n  | 'status'\n  | 'user'\n\n/** Enriched metadata for each icon entry in icons.json */\nexport interface IconMetadata {\n  /** SVG path data */\n  path: string\n  /** Display name of the icon */\n  name: string\n  /** What the icon visually depicts */\n  description: string\n  /** Semantic category for grouping */\n  category: IconCategory\n  /** Alternative names and search terms */\n  aliases: string[]\n  /** When and why to use this icon */\n  intent: string\n  /** Whether the icon is typically decorative (true) or informative (false) */\n  decorativeDefault: boolean\n  /** Suggested accessible label when the icon conveys meaning */\n  ariaLabelDefault: string\n}\n\n/** The full icon registry keyed by IconName */\nexport type IconRegistry = Record<IconName, IconMetadata>\n\n// Typed as IconRegistry so emitted .d.ts files don't import JSON (needs `resolveJsonModule` in consumers).\nexport const iconsData = iconsJson as IconRegistry\n"],"names":["iconsData","iconsJson"],"mappings":";;AAAA;AACA;AACA;AAyGA;AACO,IAAMA,SAAS,GAAGC;;;;"}
+{"version":3,"file":"icons.mjs","sources":["../../src/types/icons.ts"],"sourcesContent":["// Icon type definitions for external consumption\n// This is a self-contained type that doesn't depend on JSON imports\n// to ensure it works correctly in consuming projects\n\nimport iconsJson from '../styles/icons.json'\n\n/**\n * Every icon `Icon` can draw: the keys of `iconSet` (decision 0058). Generated by\n * `npm run icon:add` from `iconSet.json`; don't edit it by hand.\n */\nexport type IconName =\n  | 'add'\n  | 'addRing'\n  | 'ai'\n  | 'arrowDown'\n  | 'arrowLeft'\n  | 'arrowRight'\n  | 'arrowUp'\n  | 'back'\n  | 'bell'\n  | 'cancel'\n  | 'caret'\n  | 'caretDown'\n  | 'caretUp'\n  | 'check'\n  | 'checkRing'\n  | 'close'\n  | 'copy'\n  | 'creditCard'\n  | 'crossCircle'\n  | 'directionRight'\n  | 'directionUp'\n  | 'edit'\n  | 'export'\n  | 'fileDocSearch'\n  | 'filter'\n  | 'home'\n  | 'info'\n  | 'kebab'\n  | 'lamp'\n  | 'lineOut'\n  | 'link'\n  | 'meatballs'\n  | 'menu'\n  | 'message'\n  | 'mic'\n  | 'move'\n  | 'order'\n  | 'paper'\n  | 'pause'\n  | 'play'\n  | 'playBack'\n  | 'refresh'\n  | 'remove'\n  | 'search'\n  | 'sidebar'\n  | 'star'\n  | 'starFilled'\n  | 'statusCancelled'\n  | 'statusError'\n  | 'statusInProgress'\n  | 'statusInfo'\n  | 'statusNotStarted'\n  | 'statusPending'\n  | 'statusScheduled'\n  | 'statusSerious'\n  | 'statusSuccess'\n  | 'statusWarning'\n  | 'stop'\n  | 'table'\n  | 'trash'\n  | 'userBox'\n  | 'view'\n  | 'viewHide'\n  | 'wallet'\n\n/** Semantic category for grouping icons by purpose */\nexport type IconCategory =\n  | 'action'\n  | 'communication'\n  | 'content'\n  | 'feedback'\n  | 'media'\n  | 'navigation'\n  | 'object'\n  | 'status'\n  | 'user'\n\n/** Metadata every icon carries, whatever its format */\nexport interface IconDescription {\n  /** Display name of the icon */\n  name: string\n  /** What the icon visually depicts */\n  description: string\n  /** Semantic category for grouping */\n  category: IconCategory\n  /** Alternative names and search terms */\n  aliases: string[]\n  /** When and why to use this icon */\n  intent: string\n  /** Whether the icon is typically decorative (true) or informative (false) */\n  decorativeDefault: boolean\n  /** Suggested accessible label when the icon conveys meaning */\n  ariaLabelDefault: string\n}\n\n/** The SVG shapes an icon is drawn from */\nexport type IconElementTag = 'path' | 'circle' | 'ellipse' | 'rect' | 'line' | 'polyline' | 'polygon'\n\n/**\n * One shape of an icon: its tag and its geometry attributes (`d`, `cx`, `points`…), on a 24px\n * grid, plus `fill: 'currentColor'` for a filled dot. Lucide's own format, so icons copy across\n * unchanged.\n */\nexport type IconElement = [tag: IconElementTag, attributes: Record<string, string>]\n\n/**\n * How an icon is painted, always in `currentColor`:\n * - `stroke`: 2px lines with round caps and joins, no fill (Lucide icons)\n * - `fill`: solid shapes, no line\n * - `both`: lines and a fill, such as a filled star\n */\nexport type IconPaint = 'stroke' | 'fill' | 'both'\n\n/**\n * Where an icon comes from (decision 0058): copied from Lucide, with its Lucide name, or\n * maintained in this repository. Icons carried over from 3.2.0 are `common-origin` until they move\n * to Lucide.\n */\nexport type IconSource = { library: 'lucide'; name: string } | { library: 'common-origin' }\n\n/** An icon in `iconSet`: its metadata, where it comes from, and how to draw it */\nexport interface IconDefinition extends IconDescription {\n  source: IconSource\n  paint: IconPaint\n  elements: IconElement[]\n}\n\n/** The icon set keyed by IconName */\nexport type IconSet = Record<IconName, IconDefinition>\n\n/**\n * An entry in the frozen `iconsData`: one filled path and its metadata.\n * @deprecated Use `IconDefinition` and `iconSet`. Removed in 4.0 (decision 0058).\n */\nexport interface IconMetadata extends IconDescription {\n  /** SVG path data */\n  path: string\n}\n\n/**\n * The type of the frozen `iconsData`.\n * @deprecated Use `IconSet` and `iconSet`. Removed in 4.0 (decision 0058).\n */\nexport type IconRegistry = Record<IconName, IconMetadata>\n\n/**\n * The 64 icons as they were in 3.2.0, each one filled path. Frozen: icons added since have no\n * entry here, and `Icon` no longer reads it.\n * @deprecated Use `iconSet`, which holds every icon `Icon` draws. Removed in 4.0 (decision 0058).\n */\n// Typed as IconRegistry so emitted .d.ts files don't import JSON (needs `resolveJsonModule` in consumers).\nexport const iconsData = iconsJson as IconRegistry\n"],"names":["iconsData","iconsJson"],"mappings":";;AAAA;AACA;AACA;AA0JA;;;;AAIG;AACH;AACO,IAAMA,SAAS,GAAGC;;;;"}

package/dist/types/index.d.mts

@@ -1 +1,2 @@
 export * from './icons.mjs';
+export * from './iconSet.mjs';

package/dist/types/index.d.ts

@@ -1 +1,2 @@
 export * from './icons';
+export * from './iconSet';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@common-origin/design-system",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Common Origin Design System - Framework-agnostic atomic design components with comprehensive WCAG 2.2 AA testing",
   "private": false,
   "main": "dist/index.js",
@@ -65,7 +65,7 @@
     "test:coverage": "jest --coverage",
     "test:e2e": "playwright test",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint . --max-warnings 157",
+    "lint": "eslint . --max-warnings 156",
     "docs:dev": "npm run build:tokens && npm run dev",
     "verify:types": "node scripts/verify-types.cjs",
     "verify:no-nextjs": "node scripts/verify-no-nextjs-deps.cjs",
@@ -81,7 +81,8 @@
     "release:tag": "./scripts/release.sh tag",
     "tokens:golden": "node scripts/tokens-golden.cjs",
     "tokens:palette": "node scripts/generate-palette.mjs && npm run build:tokens",
-    "verify:size": "node scripts/verify-size.mjs"
+    "verify:size": "node scripts/verify-size.mjs",
+    "icon:add": "node scripts/icon-add.mjs"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -127,6 +128,7 @@
     "jest": "^30.0.2",
     "jest-axe": "^9.0.0",
     "jest-environment-jsdom": "^30.0.2",
+    "lucide-static": "1.66.0",
     "next": "^16.3.6",
     "publint": "^0.3.24",
     "react": "^19.2.0",