@sigx/lynx-icons-lucide 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,68 @@
+# @sigx/lynx-icons-lucide
+
+[Lucide](https://lucide.dev/) adapter for [`@sigx/lynx-icons`](../lynx-icons). Reads icon data from the official `lucide` package and renders each glyph as a stroked SVG with the wrapper attributes (`fill="none"`, `stroke="currentColor"`, `stroke-width="2"`, rounded caps/joins) that match the Lucide design.
+
+SVG-mode only — Lucide isn't distributed as a font.
+
+## Install
+
+```bash
+pnpm add @sigx/lynx-icons @sigx/lynx-icons-lucide lucide
+```
+
+```ts
+// signalx.config.ts
+import { defineLynxConfig } from '@sigx/lynx-cli/config';
+
+export default defineLynxConfig({
+    iconSets: [
+        { id: 'lucide', source: '@sigx/lynx-icons-lucide' },
+    ],
+});
+```
+
+## Usage
+
+```tsx
+import { Icon } from '@sigx/lynx-icons';
+
+<Icon set="lucide" name="search" />
+<Icon set="lucide" name="chevron-right" size={20} color="#0D9488" />
+<Icon set="lucide" name="bell" size={24} />
+```
+
+Glyph names are kebab-case (`chevron-right`, not `ChevronRight`); the adapter converts to lucide's `ChevronRight` export internally.
+
+## Notes
+
+- Lucide icons are **stroked**, not filled. `color` is substituted into the `stroke` attribute, so passing dark/light colors works the same as it does for filled FA icons.
+- The full Lucide catalog is reachable — every PascalCase export is mapped from a kebab-case name. If a name fails to resolve, check the [Lucide icon library](https://lucide.dev/icons/) for the canonical spelling.
+- `mode: 'font'` is rejected at config-validation time when v1.1 ships — Lucide has no source TTF.
+
+## Dynamic / JSON-driven icons
+
+If the icon `name` comes from data the build-time scanner can't see, set `include: ['*']` on the iconSet to ship the entire Lucide catalog:
+
+```ts
+iconSets: [
+    { id: 'lucide', source: '@sigx/lynx-icons-lucide', include: ['*'] },
+],
+```
+
+This bundles all ~1 500 Lucide glyphs into the JS bundle. Use it per-set, only when needed.
+
+## API
+
+```ts
+import lucideAdapter from '@sigx/lynx-icons-lucide';
+
+lucideAdapter.styles;                       // ['']  (single empty-string style)
+lucideAdapter.getGlyph('', 'user');         // { svg: '<svg viewBox="0 0 24 24" fill="none" stroke="__COLOR__"…>' }
+lucideAdapter.getFontPath('');              // null (always)
+```
+
+The adapter is normally consumed by `@sigx/lynx-plugin`'s icons slice — these direct exports are useful for tests and custom tooling.
+
+## Reference app
+
+`examples/showcase/src/screens/Settings.tsx` renders `<Icon set="lucide" name="search" />` and `<Icon set="lucide" name="bell" />` alongside FA glyphs in a card.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { IconAdapter } from '@sigx/lynx-icons';
+declare const adapter: IconAdapter;
+export default adapter;

package/dist/index.js

@@ -0,0 +1,59 @@
+import { createRequire as e } from "node:module";
+//#region src/index.ts
+var t = e(import.meta.url), n;
+function r() {
+	if (n !== void 0) return n;
+	try {
+		n = t("lucide");
+	} catch {
+		n = null;
+	}
+	return n;
+}
+function i(e) {
+	return e.split("-").map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("");
+}
+function a(e) {
+	if (e.length === 0) return "";
+	let t = e.charAt(0).toLowerCase();
+	for (let n = 1; n < e.length; n++) {
+		let r = e.charAt(n);
+		r >= "A" && r <= "Z" ? t += "-" + r.toLowerCase() : t += r;
+	}
+	return t;
+}
+function o(e) {
+	return String(e).replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+function s(e) {
+	let [t, n] = e, r = [];
+	for (let [e, t] of Object.entries(n)) r.push(`${e}="${o(t)}"`);
+	return `<${t} ${r.join(" ")}/>`;
+}
+var c = {
+	styles: [""],
+	getGlyph(e, t) {
+		let n = r();
+		if (!n) return null;
+		let a = n[i(t)];
+		return Array.isArray(a) ? { svg: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="__COLOR__" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${a.map(s).join("")}</svg>` } : null;
+	},
+	getFontPath() {
+		return null;
+	},
+	listGlyphs(e) {
+		let t = r();
+		if (!t) return [];
+		let n = [];
+		for (let [e, r] of Object.entries(t)) {
+			if (!Array.isArray(r)) continue;
+			let t = e.charAt(0);
+			t < "A" || t > "Z" || n.push(a(e));
+		}
+		return n;
+	}
+};
+//#endregion
+export { c as default };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport type { GlyphData, IconAdapter } from '@sigx/lynx-icons';\n\nconst require = createRequire(import.meta.url);\n\ntype LucideAttrs = Record<string, string | number>;\ntype LucideElement = [string, LucideAttrs];\ntype LucideIcon = LucideElement[];\n\nlet lucideModule: Record<string, LucideIcon> | null | undefined;\n\nfunction loadLucide(): Record<string, LucideIcon> | null {\n    if (lucideModule !== undefined) return lucideModule;\n    try {\n        lucideModule = require('lucide') as Record<string, LucideIcon>;\n    } catch {\n        lucideModule = null;\n    }\n    return lucideModule;\n}\n\n/** Convert kebab-case → PascalCase (lucide's export naming). `a-arrow-down` → `AArrowDown`. */\nfunction exportNameFor(name: string): string {\n    return name.split('-').map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1)).join('');\n}\n\n/**\n * Inverse of `exportNameFor`: insert `-` before every uppercase letter that\n * isn't the first character, then lowercase. Mirrors the way `exportNameFor`\n * builds names from kebab segments.\n *\n * - `User` → `user`\n * - `ChevronRight` → `chevron-right`\n * - `AArrowDown` → `a-arrow-down` (lucide really has names like this)\n */\nfunction kebabFromPascal(exportName: string): string {\n    if (exportName.length === 0) return '';\n    let out = exportName.charAt(0).toLowerCase();\n    for (let i = 1; i < exportName.length; i++) {\n        const ch = exportName.charAt(i);\n        if (ch >= 'A' && ch <= 'Z') {\n            out += '-' + ch.toLowerCase();\n        } else {\n            out += ch;\n        }\n    }\n    return out;\n}\n\nfunction escapeAttr(value: string | number): string {\n    return String(value).replace(/&/g, '&amp;').replace(/\"/g, '&quot;');\n}\n\nfunction renderElement(el: LucideElement): string {\n    const [tag, attrs] = el;\n    const parts: string[] = [];\n    for (const [k, v] of Object.entries(attrs)) {\n        parts.push(`${k}=\"${escapeAttr(v)}\"`);\n    }\n    return `<${tag} ${parts.join(' ')}/>`;\n}\n\nconst adapter: IconAdapter = {\n    /** Lucide is a single-style set; we still expose one entry so iteration works. */\n    styles: [''],\n\n    getGlyph(_style: string, name: string): GlyphData | null {\n        const lucide = loadLucide();\n        if (!lucide) return null;\n        const icon = lucide[exportNameFor(name)];\n        if (!Array.isArray(icon)) return null;\n        const inner = icon.map(renderElement).join('');\n        const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"__COLOR__\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">${inner}</svg>`;\n        return { svg };\n    },\n\n    /** Lucide has no font distribution. Always null → forces SVG mode. */\n    getFontPath(): string | null {\n        return null;\n    },\n\n    listGlyphs(_style: string): string[] {\n        const lucide = loadLucide();\n        if (!lucide) return [];\n        const out: string[] = [];\n        for (const [key, value] of Object.entries(lucide)) {\n            if (!Array.isArray(value)) continue;\n            // Lucide also exports a `createLucideIcon` helper etc. — skip\n            // anything that doesn't start with an uppercase letter (icon\n            // names are PascalCase).\n            const first = key.charAt(0);\n            if (first < 'A' || first > 'Z') continue;\n            out.push(kebabFromPascal(key));\n        }\n        return out;\n    },\n};\n\nexport default adapter;\n"],"mappings":";;AAGA,IAAM,IAAU,EAAc,OAAO,KAAK,IAAI,EAM1C;AAEJ,SAAS,IAAgD;CACrD,IAAI,MAAiB,KAAA,GAAW,OAAO;CACvC,IAAI;EACA,IAAe,EAAQ,SAAS;SAC5B;EACJ,IAAe;;CAEnB,OAAO;;AAIX,SAAS,EAAc,GAAsB;CACzC,OAAO,EAAK,MAAM,IAAI,CAAC,KAAK,MAAQ,EAAI,OAAO,EAAE,CAAC,aAAa,GAAG,EAAI,MAAM,EAAE,CAAC,CAAC,KAAK,GAAG;;AAY5F,SAAS,EAAgB,GAA4B;CACjD,IAAI,EAAW,WAAW,GAAG,OAAO;CACpC,IAAI,IAAM,EAAW,OAAO,EAAE,CAAC,aAAa;CAC5C,KAAK,IAAI,IAAI,GAAG,IAAI,EAAW,QAAQ,KAAK;EACxC,IAAM,IAAK,EAAW,OAAO,EAAE;EAC/B,AAAI,KAAM,OAAO,KAAM,MACnB,KAAO,MAAM,EAAG,aAAa,GAE7B,KAAO;;CAGf,OAAO;;AAGX,SAAS,EAAW,GAAgC;CAChD,OAAO,OAAO,EAAM,CAAC,QAAQ,MAAM,QAAQ,CAAC,QAAQ,MAAM,SAAS;;AAGvE,SAAS,EAAc,GAA2B;CAC9C,IAAM,CAAC,GAAK,KAAS,GACf,IAAkB,EAAE;CAC1B,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAM,EACtC,EAAM,KAAK,GAAG,EAAE,IAAI,EAAW,EAAE,CAAC,GAAG;CAEzC,OAAO,IAAI,EAAI,GAAG,EAAM,KAAK,IAAI,CAAC;;AAGtC,IAAM,IAAuB;CAEzB,QAAQ,CAAC,GAAG;CAEZ,SAAS,GAAgB,GAAgC;EACrD,IAAM,IAAS,GAAY;EAC3B,IAAI,CAAC,GAAQ,OAAO;EACpB,IAAM,IAAO,EAAO,EAAc,EAAK;EAIvC,OAHK,MAAM,QAAQ,EAAK,GAGjB,EAAE,KAAA,8JAFK,EAAK,IAAI,EAAc,CAAC,KAAK,GAC+H,CAAM,SAClK,GAHmB;;CAOrC,cAA6B;EACzB,OAAO;;CAGX,WAAW,GAA0B;EACjC,IAAM,IAAS,GAAY;EAC3B,IAAI,CAAC,GAAQ,OAAO,EAAE;EACtB,IAAM,IAAgB,EAAE;EACxB,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,EAAO,EAAE;GAC/C,IAAI,CAAC,MAAM,QAAQ,EAAM,EAAE;GAI3B,IAAM,IAAQ,EAAI,OAAO,EAAE;GACvB,IAAQ,OAAO,IAAQ,OAC3B,EAAI,KAAK,EAAgB,EAAI,CAAC;;EAElC,OAAO;;CAEd"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@sigx/lynx-icons-lucide",
+  "version": "0.4.0",
+  "description": "Lucide adapter for @sigx/lynx-icons. SVG-mode only — lucide is not distributed as a font.",
+  "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"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "lucide": "^1.0.0",
+    "@sigx/lynx-icons": "^0.4.0"
+  },
+  "devDependencies": {
+    "@sigx/vite": "^0.4.3",
+    "@types/node": "^25.7.0",
+    "lucide": "^1.16.0",
+    "typescript": "^6.0.3",
+    "@sigx/lynx-icons": "^0.4.0"
+  },
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/signalxjs/lynx.git",
+    "directory": "packages/lynx-icons-lucide"
+  },
+  "homepage": "https://github.com/signalxjs/lynx/tree/main/packages/lynx-icons-lucide",
+  "bugs": {
+    "url": "https://github.com/signalxjs/lynx/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "signalx",
+    "sigx",
+    "lynx",
+    "icon",
+    "lucide"
+  ],
+  "scripts": {
+    "build": "vite build && tsgo --emitDeclarationOnly",
+    "dev": "vite build --watch"
+  }
+}