@sigx/lynx-icons 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andreas Ekdahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,132 @@
+# @sigx/lynx-icons
+
+`<Icon set name />` for sigx-lynx, with build-time tree-shaking so only the glyphs you actually render ship in the bundle. Pairs with adapter packages — [`@sigx/lynx-icons-fa-free`](../lynx-icons-fa-free) for Font Awesome Free, [`@sigx/lynx-icons-lucide`](../lynx-icons-lucide) for Lucide — and is wired by [`@sigx/lynx-plugin`](../lynx-plugin)'s icons slice.
+
+## Install
+
+```bash
+pnpm add @sigx/lynx-icons @sigx/lynx-icons-fa-free
+pnpm add @fortawesome/fontawesome-free @fortawesome/free-solid-svg-icons
+```
+
+```ts
+// signalx.config.ts
+import { defineLynxConfig } from '@sigx/lynx-cli/config';
+
+export default defineLynxConfig({
+    iconSets: [
+        { id: 'fa', source: '@sigx/lynx-icons-fa-free', styles: ['solid'] },
+    ],
+});
+```
+
+`pnpm dev` / `sigx build` does the rest — `@sigx/lynx-plugin` scans your `.tsx` for `<Icon set= name=>` usages, asks the adapter for each glyph, and writes generated codepoint / SVG maps into `node_modules/.cache/sigx-lynx-icons/`. Unreferenced glyphs are never imported.
+
+## Usage
+
+```tsx
+import { Icon } from '@sigx/lynx-icons';
+
+<Icon set="fa" name="user" />
+<Icon set="fa" name="house" size={20} color="#0D9488" />
+<Icon set="lucide" name="search" size={16} />
+```
+
+| Prop | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `set` | `string` | — | Must match an `iconSets[].id` in `signalx.config.ts` (or a `defineIconSet({ id, … })` call at runtime). |
+| `name` | `string` | — | Glyph name in the set's canonical kebab-case (`chevron-right`, not `chevronRight` / `ChevronRight`). |
+| `size` | `number` | `16` | Both width and height, in CSS px. |
+| `color` | `string` | `'currentColor'` | Substituted into the SVG template at render time (data: URIs don't reliably inherit `currentColor`). |
+| `class` | `string` | — | Forwarded to the host element (`<text>` for font mode, `<image>` for SVG mode, `<view>` for missing glyphs). |
+
+The component renders `<text style={{ fontFamily: setId, … }}>{codepoint}</text>` when a codepoint is available (font mode), or an `<image>` wrapping an SVG data URI otherwise (SVG mode). When neither is registered, an empty `<view>` of the same size renders so layout doesn't jump.
+
+## Dynamic names
+
+The build-time scanner only sees literal `name="…"` strings. Computed names — `<Icon name={state.icon} />` — fall through to the missing-glyph placeholder unless you tell the plugin which glyphs to include.
+
+**Known list — enumerate the names**:
+
+```ts
+iconSets: [
+    {
+        id: 'fa',
+        source: '@sigx/lynx-icons-fa-free',
+        styles: ['solid'],
+        include: ['user', 'house', 'gear'], // force-include for dynamic <Icon name={…}>
+    },
+],
+```
+
+**Unknown list (JSON-driven UIs, server-driven content, etc.) — `include: ['*']`**:
+
+```ts
+iconSets: [
+    {
+        id: 'fa',
+        source: '@sigx/lynx-icons-fa-free',
+        styles: ['solid'],
+        include: ['*'], // ship the full FA-solid catalog
+    },
+],
+```
+
+Trade-off: shipping a full set noticeably grows the bundle (the showcase goes from ~336 kB → ~2.65 MB when FA solid's ~1 900 glyphs are bundled). Build output prints the exact glyph count so you can audit it:
+
+```
+[@sigx/lynx-plugin] icons: fa bundling 1956 glyphs (include: ['*'])
+```
+
+Use it only on the sets that genuinely need dynamic names — mix per set with the tree-shaken default for everything else. Coming in v1.1: font mode swaps the SVG-per-glyph payload for a single subsetted TTF, which is dramatically smaller for full-catalog scenarios.
+
+## Custom sets
+
+For one-off in-app icons that don't warrant a full adapter package, use `defineIconSet`:
+
+```ts
+import { defineIconSet } from '@sigx/lynx-icons';
+
+defineIconSet({
+    id: 'brand',
+    glyphs: {
+        logo: { svg: { svg: '<svg viewBox="0 0 24 24" fill="__COLOR__"><path d="M3 12L12 3l9 9-9 9z"/></svg>' } },
+    },
+});
+
+// Anywhere:
+<Icon set="brand" name="logo" />
+```
+
+`__COLOR__` placeholders in the SVG string get replaced with the user-supplied `color` (or `currentColor`) at render time.
+
+## Writing your own adapter
+
+Adapter packages are plain Node modules with a default export matching this contract:
+
+```ts
+import type { IconAdapter } from '@sigx/lynx-icons';
+
+const adapter: IconAdapter = {
+    styles: ['solid'],
+    getGlyph(style, name) {
+        // Return { codepoint?, svg } or null
+    },
+    getFontPath(style) {
+        // Absolute path to a TTF for font-mode subsetting, or null.
+    },
+};
+export default adapter;
+```
+
+The plugin dynamically `import()`s the adapter from the consumer's `node_modules` at build start, then calls `getGlyph` for every scanned `<Icon set= name=>` usage. `getFontPath` is reserved for the v1.1 font-subsetting pipeline and can return `null` for SVG-only sets.
+
+## v1 limitations
+
+- **Font mode** (build-time TTF subsetting + base64-inlined `@font-face`) ships in v1.1. v1 renders every glyph as an inline SVG `<image>`. The plumbing for `mode: 'font'` is in the schema but currently no-ops.
+- **HMR** for newly-added icon names requires a `pnpm dev` restart. The v1 scanner is a one-shot regex pass at plugin start; v1.1 replaces it with a real SWC-AST Rspack loader.
+- **FA Pro** and **Iconify** adapters are v1.1 follow-ups.
+
+## Reference app
+
+`examples/showcase/src/screens/Settings.tsx` shows fa-solid, fa-brands, and lucide icons rendered side by side. The generated cache lives at `examples/showcase/node_modules/.cache/sigx-lynx-icons/` after `pnpm build`.

package/dist/Icon.d.ts

@@ -0,0 +1,29 @@
+import { type Define } from '@sigx/lynx';
+import '@sigx/lynx-icons/__font-face.css';
+export type IconProps = Define.Prop<'set', string, true> & Define.Prop<'name', string, true> & Define.Prop<'size', number, false> & Define.Prop<'color', string, false> & Define.Prop<'class', string, false>;
+export declare function sanitizeColor(color: string): string;
+export declare function inlineSvg(template: string, color: string): string;
+/**
+ * Render a glyph from a registered icon set.
+ *
+ * Sets are declared in `signalx.config.ts` via `iconSets: [...]` (build-time,
+ * tree-shaken) or via `defineIconSet({ id, glyphs })` (runtime, ad-hoc).
+ *
+ * Resolution order: **SVG first**, then codepoint, then missing placeholder.
+ *
+ * - SVG-mode sets render with Lynx's native `<svg content={...}>` element
+ *   (the engine parses the inline XML; no JSX children, no data: URIs).
+ * - Font-mode sets fall back to a single character inside a `<text>` element
+ *   with a matching `font-family`. The plugin only emits codepoints when the
+ *   matching `@font-face` has also been registered (v1.1+); v1 always hits
+ *   the SVG branch.
+ * - Missing glyphs render an empty `<view>` of the same size so layout
+ *   doesn't jump.
+ *
+ * @example
+ * ```tsx
+ * <Icon set="fa" name="user" size={20} color="#333" />
+ * <Icon set="lucide" name="search" size={16} />
+ * ```
+ */
+export declare const Icon: import("@sigx/runtime-core").ComponentFactory<IconProps, void, {}>;

package/dist/defineIconSet-BIFjZq08.js

@@ -0,0 +1,28 @@
+//#region src/registry.ts
+var e = {}, t = {};
+function n(n) {
+	let r = {}, i = {};
+	for (let [e, t] of Object.entries(n.glyphs)) t.codepoint !== void 0 && (r[e] = t.codepoint), t.svg && (i[e] = t.svg);
+	Object.keys(r).length > 0 && (e[n.id] = r), Object.keys(i).length > 0 && (t[n.id] = i);
+}
+function r(t, n, r) {
+	return t[n]?.[r] ?? e[n]?.[r];
+}
+function i(e, n, r) {
+	return e[n]?.[r] ?? t[n]?.[r];
+}
+function a(e, t, n, a) {
+	let o = i(t, n, a);
+	if (o) return { svg: o };
+	let s = r(e, n, a);
+	if (s !== void 0) return { codepoint: s };
+}
+//#endregion
+//#region src/defineIconSet.ts
+function o(e) {
+	return n(e), e;
+}
+//#endregion
+export { a as n, o as t };
+
+//# sourceMappingURL=defineIconSet-BIFjZq08.js.map

package/dist/defineIconSet-BIFjZq08.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineIconSet-BIFjZq08.js","names":[],"sources":["../src/registry.ts","../src/defineIconSet.ts"],"sourcesContent":["import type { CodepointMap, GlyphSvg, IconSetDef, SvgMap } from './types';\n\nconst runtimeCodepoints: CodepointMap = {};\nconst runtimeSvgs: SvgMap = {};\n\nexport function registerIconSet(def: IconSetDef): void {\n    const codepoints: Record<string, number> = {};\n    const svgs: Record<string, GlyphSvg> = {};\n    for (const [name, g] of Object.entries(def.glyphs)) {\n        if (g.codepoint !== undefined) codepoints[name] = g.codepoint;\n        if (g.svg) svgs[name] = g.svg;\n    }\n    if (Object.keys(codepoints).length > 0) runtimeCodepoints[def.id] = codepoints;\n    if (Object.keys(svgs).length > 0) runtimeSvgs[def.id] = svgs;\n}\n\nexport function lookupCodepoint(\n    buildTime: CodepointMap,\n    set: string,\n    name: string,\n): number | undefined {\n    return buildTime[set]?.[name] ?? runtimeCodepoints[set]?.[name];\n}\n\nexport function lookupSvg(\n    buildTime: SvgMap,\n    set: string,\n    name: string,\n): GlyphSvg | undefined {\n    return buildTime[set]?.[name] ?? runtimeSvgs[set]?.[name];\n}\n\nexport function lookupGlyph(\n    buildTimeCodepoints: CodepointMap,\n    buildTimeSvgs: SvgMap,\n    set: string,\n    name: string,\n): { codepoint?: number; svg?: GlyphSvg } | undefined {\n    const svg = lookupSvg(buildTimeSvgs, set, name);\n    if (svg) return { svg };\n\n    const codepoint = lookupCodepoint(buildTimeCodepoints, set, name);\n    if (codepoint !== undefined) return { codepoint };\n\n    return undefined;\n}\n","import { registerIconSet } from './registry';\nimport type { IconSetDef } from './types';\n\n/**\n * Register a custom icon set at module load time.\n *\n * Build-time sets declared in `signalx.config.ts` are auto-detected and\n * tree-shaken; `defineIconSet` is the escape hatch for ad-hoc sets defined\n * directly in app code (e.g. a small private set used in one screen).\n *\n * @example\n * ```ts\n * defineIconSet({\n *   id: 'brand',\n *   glyphs: {\n *     logo: {\n *       svg: {\n *         svg: '<svg viewBox=\"0 0 24 24\" fill=\"__COLOR__\"><path d=\"M3 12L12 3l9 9-9 9z\"/></svg>',\n *       },\n *     },\n *   },\n * });\n * ```\n *\n * The inner `svg` value is raw SVG markup. `__COLOR__` placeholders in that\n * markup get substituted with the user's `color` prop at render time.\n */\nexport function defineIconSet(def: IconSetDef): IconSetDef {\n    registerIconSet(def);\n    return def;\n}\n\nexport type { IconSetDef } from './types';\n"],"mappings":";AAEA,IAAM,IAAkC,EAAE,EACpC,IAAsB,EAAE;AAE9B,SAAgB,EAAgB,GAAuB;CACnD,IAAM,IAAqC,EAAE,EACvC,IAAiC,EAAE;CACzC,KAAK,IAAM,CAAC,GAAM,MAAM,OAAO,QAAQ,EAAI,OAAO,EAE9C,AADI,EAAE,cAAc,KAAA,MAAW,EAAW,KAAQ,EAAE,YAChD,EAAE,QAAK,EAAK,KAAQ,EAAE;CAG9B,AADI,OAAO,KAAK,EAAW,CAAC,SAAS,MAAG,EAAkB,EAAI,MAAM,IAChE,OAAO,KAAK,EAAK,CAAC,SAAS,MAAG,EAAY,EAAI,MAAM;;AAG5D,SAAgB,EACZ,GACA,GACA,GACkB;CAClB,OAAO,EAAU,KAAO,MAAS,EAAkB,KAAO;;AAG9D,SAAgB,EACZ,GACA,GACA,GACoB;CACpB,OAAO,EAAU,KAAO,MAAS,EAAY,KAAO;;AAGxD,SAAgB,EACZ,GACA,GACA,GACA,GACkD;CAClD,IAAM,IAAM,EAAU,GAAe,GAAK,EAAK;CAC/C,IAAI,GAAK,OAAO,EAAE,QAAK;CAEvB,IAAM,IAAY,EAAgB,GAAqB,GAAK,EAAK;CACjE,IAAI,MAAc,KAAA,GAAW,OAAO,EAAE,cAAW;;;;ACfrD,SAAgB,EAAc,GAA6B;CAEvD,OADA,EAAgB,EAAI,EACb"}

package/dist/defineIconSet.d.ts

@@ -0,0 +1,27 @@
+import type { IconSetDef } from './types';
+/**
+ * Register a custom icon set at module load time.
+ *
+ * Build-time sets declared in `signalx.config.ts` are auto-detected and
+ * tree-shaken; `defineIconSet` is the escape hatch for ad-hoc sets defined
+ * directly in app code (e.g. a small private set used in one screen).
+ *
+ * @example
+ * ```ts
+ * defineIconSet({
+ *   id: 'brand',
+ *   glyphs: {
+ *     logo: {
+ *       svg: {
+ *         svg: '<svg viewBox="0 0 24 24" fill="__COLOR__"><path d="M3 12L12 3l9 9-9 9z"/></svg>',
+ *       },
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * The inner `svg` value is raw SVG markup. `__COLOR__` placeholders in that
+ * markup get substituted with the user's `color` prop at render time.
+ */
+export declare function defineIconSet(def: IconSetDef): IconSetDef;
+export type { IconSetDef } from './types';

package/dist/defineIconSet.js

@@ -0,0 +1,2 @@
+import { t as e } from "./defineIconSet-BIFjZq08.js";
+export { e as defineIconSet };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Icon } from './Icon';
+export type { IconProps } from './Icon';
+export { defineIconSet } from './defineIconSet';
+export type { GlyphData, GlyphSvg, IconAdapter, IconSetDef } from './types';

package/dist/index.js

@@ -0,0 +1,50 @@
+import { n as e, t } from "./defineIconSet-BIFjZq08.js";
+import { component as n } from "@sigx/lynx";
+import { codepoints as r } from "@sigx/lynx-icons/__codepoints";
+import { svgs as i } from "@sigx/lynx-icons/__svgs";
+import "@sigx/lynx-icons/__font-face.css";
+import { jsx as a } from "@sigx/lynx/jsx-runtime";
+//#region src/Icon.tsx
+var o = /^(?:currentColor|[a-zA-Z]+|#[0-9a-fA-F]{3,8}|(?:rgb|rgba|hsl|hsla)\(\s*[\d.,%\s]+\))$/;
+function s(e) {
+	return o.test(e) ? e : "currentColor";
+}
+function c(e, t) {
+	return e.replace(/__COLOR__/g, s(t));
+}
+var l = n(({ props: t }) => () => {
+	let n = t.size ?? 16, o = t.set, s = t.name, l = {
+		width: n,
+		height: n
+	}, u = e(r, i, o, s);
+	if (u?.svg) {
+		let e = t.color ?? "currentColor";
+		return /* @__PURE__ */ a("svg", {
+			content: c(u.svg.svg, e),
+			class: t.class,
+			style: l
+		});
+	}
+	if (u?.codepoint !== void 0) {
+		let e = {
+			fontFamily: o,
+			fontSize: n,
+			lineHeight: `${n}px`,
+			width: n,
+			height: n
+		};
+		return t.color && (e.color = t.color), /* @__PURE__ */ a("text", {
+			class: t.class,
+			style: e,
+			children: String.fromCodePoint(u.codepoint)
+		});
+	}
+	return /* @__PURE__ */ a("view", {
+		class: t.class,
+		style: l
+	});
+});
+//#endregion
+export { l as Icon, t as defineIconSet };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/Icon.tsx"],"sourcesContent":["import { component, type Define } from '@sigx/lynx';\nimport { codepoints } from '@sigx/lynx-icons/__codepoints';\nimport { svgs } from '@sigx/lynx-icons/__svgs';\nimport '@sigx/lynx-icons/__font-face.css';\nimport { lookupGlyph } from './registry';\n\nexport type IconProps =\n    & Define.Prop<'set', string, true>\n    & Define.Prop<'name', string, true>\n    & Define.Prop<'size', number, false>\n    & Define.Prop<'color', string, false>\n    & Define.Prop<'class', string, false>;\n\n/**\n * Match a conservative subset of valid CSS color formats:\n * - `currentColor` and named colors (`red`, `dodgerblue`, `transparent` …)\n * - `#rgb` / `#rgba` / `#rrggbb` / `#rrggbbaa`\n * - `rgb(...)` / `rgba(...)` / `hsl(...)` / `hsla(...)` with digits, dots,\n *   commas, percent signs, and whitespace inside the parens\n *\n * Anything else (quotes, angle brackets, ampersands, arbitrary HTML) falls\n * back to `currentColor`. The `color` prop ends up substituted directly into\n * the SVG markup that we hand to Lynx's `<svg content={…}>` parser, so a\n * value like `red\" stroke=\"…` would break out of the `fill=\"\"` attribute.\n * Allow-list, not escape-list — keeps the surface area provably small.\n */\nconst SAFE_COLOR_RE =\n    /^(?:currentColor|[a-zA-Z]+|#[0-9a-fA-F]{3,8}|(?:rgb|rgba|hsl|hsla)\\(\\s*[\\d.,%\\s]+\\))$/;\n\nexport function sanitizeColor(color: string): string {\n    return SAFE_COLOR_RE.test(color) ? color : 'currentColor';\n}\n\nexport function inlineSvg(template: string, color: string): string {\n    return template.replace(/__COLOR__/g, sanitizeColor(color));\n}\n\n/**\n * Render a glyph from a registered icon set.\n *\n * Sets are declared in `signalx.config.ts` via `iconSets: [...]` (build-time,\n * tree-shaken) or via `defineIconSet({ id, glyphs })` (runtime, ad-hoc).\n *\n * Resolution order: **SVG first**, then codepoint, then missing placeholder.\n *\n * - SVG-mode sets render with Lynx's native `<svg content={...}>` element\n *   (the engine parses the inline XML; no JSX children, no data: URIs).\n * - Font-mode sets fall back to a single character inside a `<text>` element\n *   with a matching `font-family`. The plugin only emits codepoints when the\n *   matching `@font-face` has also been registered (v1.1+); v1 always hits\n *   the SVG branch.\n * - Missing glyphs render an empty `<view>` of the same size so layout\n *   doesn't jump.\n *\n * @example\n * ```tsx\n * <Icon set=\"fa\" name=\"user\" size={20} color=\"#333\" />\n * <Icon set=\"lucide\" name=\"search\" size={16} />\n * ```\n */\nexport const Icon = component<IconProps>(({ props }) => {\n    return () => {\n        const size = props.size ?? 16;\n        const set = props.set;\n        const name = props.name;\n        const sizeStyle = { width: size, height: size } as const;\n\n        const glyph = lookupGlyph(codepoints, svgs, set, name);\n        if (glyph?.svg) {\n            const color = props.color ?? 'currentColor';\n            return (\n                <svg\n                    content={inlineSvg(glyph.svg.svg, color)}\n                    class={props.class}\n                    style={sizeStyle}\n                />\n            );\n        }\n\n        if (glyph?.codepoint !== undefined) {\n            const textStyle: Record<string, string | number> = {\n                fontFamily: set,\n                fontSize: size,\n                lineHeight: `${size}px`,\n                width: size,\n                height: size,\n            };\n            if (props.color) textStyle.color = props.color;\n            return (\n                <text class={props.class} style={textStyle}>\n                    {String.fromCodePoint(glyph.codepoint)}\n                </text>\n            );\n        }\n\n        return <view class={props.class} style={sizeStyle} />;\n    };\n});\n"],"mappings":";;;;;;;AA0BA,IAAM,IACF;AAEJ,SAAgB,EAAc,GAAuB;CACjD,OAAO,EAAc,KAAK,EAAM,GAAG,IAAQ;;AAG/C,SAAgB,EAAU,GAAkB,GAAuB;CAC/D,OAAO,EAAS,QAAQ,cAAc,EAAc,EAAM,CAAC;;AA0B/D,IAAa,IAAO,GAAsB,EAAE,qBAC3B;CACT,IAAM,IAAO,EAAM,QAAQ,IACrB,IAAM,EAAM,KACZ,IAAO,EAAM,MACb,IAAY;EAAE,OAAO;EAAM,QAAQ;EAAM,EAEzC,IAAQ,EAAY,GAAY,GAAM,GAAK,EAAK;CACtD,IAAI,GAAO,KAAK;EACZ,IAAM,IAAQ,EAAM,SAAS;EAC7B,OACI,kBAAC,OAAD;GACI,SAAS,EAAU,EAAM,IAAI,KAAK,EAAM;GACxC,OAAO,EAAM;GACb,OAAO;GACT,CAAA;;CAIV,IAAI,GAAO,cAAc,KAAA,GAAW;EAChC,IAAM,IAA6C;GAC/C,YAAY;GACZ,UAAU;GACV,YAAY,GAAG,EAAK;GACpB,OAAO;GACP,QAAQ;GACX;EAED,OADI,EAAM,UAAO,EAAU,QAAQ,EAAM,QAErC,kBAAC,QAAD;GAAM,OAAO,EAAM;GAAO,OAAO;aAC5B,OAAO,cAAc,EAAM,UAAU;GACnC,CAAA;;CAIf,OAAO,kBAAC,QAAD;EAAM,OAAO,EAAM;EAAO,OAAO;EAAa,CAAA;EAE3D"}

package/dist/registry.d.ts

@@ -0,0 +1,8 @@
+import type { CodepointMap, GlyphSvg, IconSetDef, SvgMap } from './types';
+export declare function registerIconSet(def: IconSetDef): void;
+export declare function lookupCodepoint(buildTime: CodepointMap, set: string, name: string): number | undefined;
+export declare function lookupSvg(buildTime: SvgMap, set: string, name: string): GlyphSvg | undefined;
+export declare function lookupGlyph(buildTimeCodepoints: CodepointMap, buildTimeSvgs: SvgMap, set: string, name: string): {
+    codepoint?: number;
+    svg?: GlyphSvg;
+} | undefined;

package/dist/stubs/codepoints.d.ts

@@ -0,0 +1,9 @@
+import type { CodepointMap } from '../types';
+/**
+ * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an
+ * Rspack alias at build time, populating it with the codepoints used by the
+ * app's `<Icon>` calls. Without the plugin, no built-in sets are registered
+ * and all icons fall back to `defineIconSet`-registered sets (if any) or the
+ * missing-glyph placeholder.
+ */
+export declare const codepoints: CodepointMap;

package/dist/stubs/codepoints.js

@@ -0,0 +1,6 @@
+//#region src/stubs/codepoints.ts
+var e = {};
+//#endregion
+export { e as codepoints };
+
+//# sourceMappingURL=codepoints.js.map

package/dist/stubs/codepoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codepoints.js","names":[],"sources":["../../src/stubs/codepoints.ts"],"sourcesContent":["import type { CodepointMap } from '../types';\n\n/**\n * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an\n * Rspack alias at build time, populating it with the codepoints used by the\n * app's `<Icon>` calls. Without the plugin, no built-in sets are registered\n * and all icons fall back to `defineIconSet`-registered sets (if any) or the\n * missing-glyph placeholder.\n */\nexport const codepoints: CodepointMap = {};\n"],"mappings":";AASA,IAAa,IAA2B,EAAE"}

package/dist/stubs/codepoints.ts

@@ -0,0 +1,10 @@
+import type { CodepointMap } from '../types';
+
+/**
+ * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an
+ * Rspack alias at build time, populating it with the codepoints used by the
+ * app's `<Icon>` calls. Without the plugin, no built-in sets are registered
+ * and all icons fall back to `defineIconSet`-registered sets (if any) or the
+ * missing-glyph placeholder.
+ */
+export const codepoints: CodepointMap = {};

package/dist/stubs/font-face.css

@@ -0,0 +1,6 @@
+/*
+ * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an
+ * Rspack alias at build time, replacing it with @font-face declarations
+ * (base64-inlined subset TTFs) for every icon set in `signalx.config.ts`
+ * that uses font mode.
+ */

package/dist/stubs/font-face.css.d.ts

@@ -0,0 +1,7 @@
+// Type stub for the side-effect CSS import:
+//
+//     import '@sigx/lynx-icons/__font-face.css';
+//
+// The actual CSS is replaced by @sigx/lynx-plugin's icons slice at build
+// time with @font-face declarations for every font-mode icon set.
+export {};

package/dist/stubs/svgs.d.ts

@@ -0,0 +1,7 @@
+import type { SvgMap } from '../types';
+/**
+ * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an
+ * Rspack alias at build time, populating it with the SVG path data for the
+ * icons used by the app's `<Icon>` calls.
+ */
+export declare const svgs: SvgMap;

package/dist/stubs/svgs.js

@@ -0,0 +1,6 @@
+//#region src/stubs/svgs.ts
+var e = {};
+//#endregion
+export { e as svgs };
+
+//# sourceMappingURL=svgs.js.map

package/dist/stubs/svgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svgs.js","names":[],"sources":["../../src/stubs/svgs.ts"],"sourcesContent":["import type { SvgMap } from '../types';\n\n/**\n * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an\n * Rspack alias at build time, populating it with the SVG path data for the\n * icons used by the app's `<Icon>` calls.\n */\nexport const svgs: SvgMap = {};\n"],"mappings":";AAOA,IAAa,IAAe,EAAE"}

package/dist/stubs/svgs.ts

@@ -0,0 +1,8 @@
+import type { SvgMap } from '../types';
+
+/**
+ * Empty stub. The @sigx/lynx-plugin icons slice replaces this module via an
+ * Rspack alias at build time, populating it with the SVG path data for the
+ * icons used by the app's `<Icon>` calls.
+ */
+export const svgs: SvgMap = {};

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Per-glyph vector data. Used by SVG-mode rendering.
+ *
+ * `svg` is a complete `<svg …>…</svg>` string with `__COLOR__` placeholders
+ * wherever the user-supplied `color` should be substituted. This lets each
+ * adapter ship the native shape of its icons (FA = filled paths, lucide =
+ * stroked paths) without the core component needing to know per-adapter
+ * styling.
+ *
+ * @example FA solid: `<svg viewBox="0 0 448 512" fill="__COLOR__"><path d="..."/></svg>`
+ * @example lucide:   `<svg viewBox="0 0 24 24" fill="none" stroke="__COLOR__" stroke-width="2" ...><path .../><circle .../></svg>`
+ */
+export interface GlyphSvg {
+    svg: string;
+}
+/**
+ * Build-time virtual module shape: glyph name → unicode codepoint, keyed by set id.
+ * Populated by the @sigx/lynx-plugin icons slice; the stub ships an empty record
+ * so the core package builds standalone.
+ */
+export type CodepointMap = Record<string, Record<string, number>>;
+/**
+ * Build-time virtual module shape: glyph name → SVG data, keyed by set id.
+ * Populated by the @sigx/lynx-plugin icons slice.
+ */
+export type SvgMap = Record<string, Record<string, GlyphSvg>>;
+/**
+ * Runtime-registered icon set, for ad-hoc / app-local sets created via
+ * `defineIconSet`. Build-time sets bypass this and live in the virtual modules.
+ */
+export interface IconSetDef {
+    id: string;
+    glyphs: Record<string, {
+        codepoint?: number;
+        svg?: GlyphSvg;
+    }>;
+    fontFamily?: string;
+}
+/**
+ * Glyph data exposed by an adapter package at build time.
+ * `codepoint` enables font-mode subsetting; `svg` enables SVG-mode rendering.
+ * Adapters should populate both when possible (FA does), or only `svg` for
+ * SVG-only sets (e.g. lucide).
+ *
+ * `svg` is a complete `<svg>…</svg>` string with `__COLOR__` placeholders
+ * for the user's color; see {@link GlyphSvg} for the rendering contract.
+ */
+export interface GlyphData {
+    codepoint?: number;
+    svg: string;
+}
+/**
+ * Build-time adapter contract. Implemented by packages like
+ * `@sigx/lynx-icons-fa-free` and consumed by `@sigx/lynx-plugin`'s icons slice
+ * to resolve glyph data for every `<Icon set="..." name="..." />` usage.
+ *
+ * Adapters should expose a default export of this shape from their main entry.
+ */
+export interface IconAdapter {
+    /** Style variants the adapter supports. e.g. ['solid', 'regular', 'brands'] for FA, [''] (single empty style) for lucide. */
+    styles: string[];
+    /** Resolve a glyph by style + name. Return `null` when the glyph is unknown. */
+    getGlyph(style: string, name: string): GlyphData | null;
+    /**
+     * Absolute filesystem path to the source TTF for `style`, or null when the
+     * adapter only supports SVG mode. The plugin reads this file and runs it
+     * through `subset-font` to produce per-app subsets.
+     */
+    getFontPath(style: string): string | null;
+    /**
+     * Enumerate every glyph name the adapter can resolve for `style`, in
+     * the same kebab-case form `getGlyph` accepts. Used by the plugin when
+     * a project sets `iconSets[].include: ['*']` (e.g. JSON-driven UIs where
+     * the names aren't known at build time) — the plugin pulls the full
+     * catalog into the bundle instead of relying on the JSX scanner.
+     */
+    listGlyphs(style: string): string[];
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@sigx/lynx-icons",
+  "version": "0.4.0",
+  "description": "Icon component and registry for sigx-lynx — works with adapter packages like @sigx/lynx-icons-fa-free and @sigx/lynx-icons-lucide.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./__codepoints": {
+      "types": "./dist/stubs/codepoints.d.ts",
+      "import": "./dist/stubs/codepoints.js",
+      "default": "./dist/stubs/codepoints.js"
+    },
+    "./__svgs": {
+      "types": "./dist/stubs/svgs.d.ts",
+      "import": "./dist/stubs/svgs.js",
+      "default": "./dist/stubs/svgs.js"
+    },
+    "./__font-face.css": {
+      "types": "./dist/stubs/font-face.css.d.ts",
+      "default": "./dist/stubs/font-face.css"
+    },
+    "./signalx-module.json": "./signalx-module.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "signalx-module.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@sigx/lynx": "^0.4.0"
+  },
+  "devDependencies": {
+    "@sigx/vite": "^0.4.3",
+    "typescript": "^6.0.3",
+    "@sigx/lynx": "^0.4.0"
+  },
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/lynx.git",
+    "directory": "packages/lynx-icons"
+  },
+  "homepage": "https://github.com/signalxjs/lynx/tree/main/packages/lynx-icons",
+  "bugs": {
+    "url": "https://github.com/signalxjs/lynx/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "signalx",
+    "sigx",
+    "lynx",
+    "icon",
+    "icons",
+    "font-awesome",
+    "lucide"
+  ],
+  "scripts": {
+    "build": "vite build && tsgo --emitDeclarationOnly && node ../../scripts/copy-assets.mjs src/stubs dist/stubs",
+    "dev": "vite build --watch"
+  }
+}

package/signalx-module.json

@@ -0,0 +1,14 @@
+{
+    "name": "Icons",
+    "package": "@sigx/lynx-icons",
+    "description": "Registers Lynx's <svg> element (via XElement/SVG + ServalSVG) so <Icon> can render in SVG mode.",
+    "platforms": ["android", "ios"],
+    "android": {
+        "dependencies": ["org.lynxsdk.lynx:xelement-svg:3.7.0"]
+    },
+    "ios": {
+        "pods": {
+            "XElement/SVG": "3.7.0"
+        }
+    }
+}