feat: add icon lib description for lucide-react

package.json

@@ -24,20 +24,24 @@
   "author": "Dazl",
   "license": "MIT",
   "devDependencies": {
+    "@file-services/node": "^10.0.1",
     "@playwright/browser-chromium": "^1.54.1",
     "@playwright/test": "^1.54.1",
     "@types/chai": "^5.2.2",
     "@types/node": "^24.0.15",
     "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "chai": "^5.2.1",
     "eslint": "^9.31.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-no-only-tests": "^3.3.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
+    "lucide-react": "^0.525.0",
     "prettier": "^3.6.2",
     "promise-assist": "^2.0.1",
     "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0"

packages/lucide-react/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 Dazl
+
+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
+(including the next paragraph) 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.

packages/lucide-react/README.md

@@ -0,0 +1,31 @@
+# @dazl-libs/lucide-react
+
+**dazl-lucide-react** is a utility library for working with the [Lucide](https://lucide.dev/) icon set in React projects. It provides utilities to list all available icons and access prerendered SVGs programmatically, making it easy to integrate Lucide icons into your workflows or build tools.
+
+## Features
+
+- Retrieve a full list of Lucide icon names
+- Access prerendered SVGs as data or files
+- Utility functions for searching and filtering icons
+- Works with the official Lucide icon set
+
+## Installation
+
+```bash
+npm install @dazl-libs/lucide-react
+```
+
+## Usage
+
+```js
+import iconList from '@dazl-libs/lucide-react';
+import PrerenderdCameraSVG from '@dazl-libs/lucide-react/camera.svg';
+
+## Prerendered SVGs
+
+All icons are available as prerendered SVG strings or files, suitable for direct embedding or further processing.
+
+## License
+
+[MIT](./LICENSE)
+```

packages/lucide-react/build.tsx

@@ -0,0 +1,110 @@
+import React from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import { nodeFs } from '@file-services/node';
+import * as lucideReact from 'lucide-react';
+
+interface IconData {
+    name: string;
+    aliases: string[];
+    svgString: string;
+}
+
+interface IconTypeAugmentation {
+    name: string;
+    aliases: string[];
+    file: string;
+}
+
+interface TypeAugmentationFile {
+    icons: IconTypeAugmentation[];
+}
+
+function buildIcons(): void {
+    const distDir = nodeFs.join(import.meta.dirname, 'dist');
+    const svgDir = nodeFs.join(distDir, 'svg');
+
+    nodeFs.ensureDirectorySync(distDir);
+    nodeFs.ensureDirectorySync(svgDir);
+
+    const svgsByContent = new Map<string, IconData>();
+
+    for (const [exportName, IconComponent] of Object.entries(lucideReact)) {
+        // Skip non-component exports
+        if (typeof IconComponent !== 'function' && typeof IconComponent !== 'object') {
+            continue;
+        }
+
+        if (!IconComponent) {
+            continue;
+        }
+
+        // Skip known utility functions
+        if (exportName === 'createLucideIcon' || exportName === 'Icon') {
+            continue;
+        }
+
+        // Icon components have uppercase first letter
+        if (exportName[0] !== exportName[0]?.toUpperCase()) {
+            continue;
+        }
+
+        try {
+            const svgString = renderToStaticMarkup(
+                React.createElement(IconComponent as React.ComponentType<{ size: number; strokeWidth: number }>, {
+                    size: 24,
+                    strokeWidth: 2,
+                }),
+            );
+
+            // Check if we've seen this SVG content before
+            if (svgsByContent.has(svgString)) {
+                const existing = svgsByContent.get(svgString)!;
+                // Keep the shortest name
+                if (exportName.length < existing.name.length) {
+                    existing.aliases.push(existing.name);
+                    existing.name = exportName;
+                } else {
+                    existing.aliases.push(exportName);
+                }
+            } else {
+                svgsByContent.set(svgString, {
+                    name: exportName,
+                    aliases: [exportName],
+                    svgString,
+                });
+            }
+        } catch {
+            // Skip icons that fail to render
+            continue;
+        }
+    }
+
+    const iconsTypeAugmentation: IconTypeAugmentation[] = [];
+
+    // Save unique SVGs and build icons list
+    for (const { name, aliases, svgString } of svgsByContent.values()) {
+        const filename = `${name.toLowerCase()}.svg`;
+        const filepath = nodeFs.join(svgDir, filename);
+
+        // Save SVG file
+        nodeFs.writeFileSync(filepath, svgString);
+
+        // Add to icons list (use relative path from dist folder)
+        const iconEntry = {
+            name: name,
+            aliases: aliases,
+            file: `svg/${filename}`,
+        };
+
+        iconsTypeAugmentation.push(iconEntry);
+    }
+
+    // Save type augmentation file
+    const typeAugmentationFile: TypeAugmentationFile = {
+        icons: iconsTypeAugmentation,
+    };
+    const typeAugmentationPath = nodeFs.join(distDir, 'types-augmentation.json');
+    nodeFs.writeFileSync(typeAugmentationPath, JSON.stringify(typeAugmentationFile, null, 2));
+}
+
+export default buildIcons;

packages/lucide-react/do-build.ts

@@ -0,0 +1,3 @@
+import buildIcons from './build.tsx';
+
+buildIcons();

packages/lucide-react/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@dazl-libs/lucide-react",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "import": "./dist/types-augmentation.json",
+      "require": "./dist/types-augmentation.json"
+    },
+    "./*.svg": {
+      "import": "./dist/svg/*.svg",
+      "require": "./dist/svg/*.svg"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "node do-build.ts",
+    "prepack": "npm run build"
+  }
+}

packages/lucide-react/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "jsx": "react-jsx"
+  }
+}

tsconfig.base.json

@@ -13,6 +13,8 @@
     /* Language and Environment */
     "target": "es2023",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
     "lib": ["es2023","dom"],                                   /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    "jsx": "react-jsx",
+
     // "jsx": "preserve",                                /* Specify what JSX code is generated. */
     // "libReplacement": true,                           /* Enable lib replacement. */
     // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */