@almadar/ui 5.0.0 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,12 +1,15 @@
1
1
  /**
2
2
  * Icon Atom Component
3
3
  *
4
- * A wrapper component for Lucide icons with consistent sizing and styling.
5
- * Uses theme-aware CSS variables for stroke width and color.
4
+ * Renders an icon from the active icon family (Layer 1 Iconography axis —
5
+ * see lib/iconFamily.ts). Canonical names are lucide kebab-case; the resolver
6
+ * dispatches to phosphor / tabler / fa-solid when `--icon-family` selects them,
7
+ * re-rendering automatically on theme switch.
6
8
  *
7
9
  * Supports two APIs:
8
- * - `icon` prop: Pass a LucideIcon component directly
9
- * - `name` prop: Pass a string icon name (resolved from iconMap)
10
+ * - `icon` prop: Pass a LucideIcon component directly (bypasses family resolver
11
+ * used for direct lucide component refs, stays in lucide regardless of theme)
12
+ * - `name` prop: Pass a canonical kebab-case name (family-aware, swaps on theme)
10
13
  */
11
14
  import React from 'react';
12
15
  import type { LucideIcon } from 'lucide-react';