@primeicons/react 8.0.0-alpha.4 → 8.0.0-alpha.5

package/README.md

@@ -143,6 +143,59 @@ Each icon automatically includes these CSS classes:
 }
 ```
 
+## Metadata & Icon Lookup
+
+Icon metadata is managed by the `@primeicons/metadata` package and re-exported here for convenience:
+
+```tsx
+import { ICON_MAP, ICON_MAP_BY_NAME, findIcons } from '@primeicons/metadata/react';
+
+// Find icon by name (kebab-case)
+const iconData = ICON_MAP_BY_NAME['check-circle'];
+const CheckCircle = iconData.component; // Already lazy-loaded component
+<CheckCircle size={24} />;
+
+// Search and use
+const results = findIcons('arrow');
+results.forEach((icon) => {
+    const Component = icon.component;
+    <Component size={24} />;
+});
+```
+
+Alternatively, import directly from the metadata package:
+
+```tsx
+import { ICON_MAP, findIcons } from '@primeicons/metadata/react';
+```
+
+### Metadata API
+
+| Variable                | Type                                | Description                |
+| ----------------------- | ----------------------------------- | -------------------------- |
+| `ICON_MAP`              | `IconMetadataEntry[]`               | All icons as array         |
+| `ICON_MAP_BY_NAME`      | `Record<string, IconMetadataEntry>` | Indexed by kebab-case name |
+| `ICON_MAP_BY_COMPONENT` | `Record<string, IconMetadataEntry>` | Indexed by component name  |
+| `ICON_MAP_BY_CAMEL`     | `Record<string, IconMetadataEntry>` | Indexed by camelCase name  |
+| `TOTAL_ICONS`           | `number`                            | Total icon count           |
+| `PACKAGE_INFO`          | `object`                            | Package metadata           |
+
+| Function              | Returns               | Description                   |
+| --------------------- | --------------------- | ----------------------------- |
+| `getIconNames()`      | `string[]`            | All kebab-case icon names     |
+| `getComponentNames()` | `string[]`            | All component names           |
+| `findIcons(query)`    | `IconMetadataEntry[]` | Search icons by partial match |
+
+### JSON Metadata
+
+Access the raw JSON metadata directly:
+
+```typescript
+import metadata from '@primeicons/metadata/react.json';
+
+console.log(manifest.icons[0]); // { name: 'address-book', component: 'AddressBook', ... }
+```
+
 ## Icon List
 
 The library includes 300+ icons including:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primeicons/react",
-  "version": "8.0.0-alpha.4",
+  "version": "8.0.0-alpha.5",
   "author": "PrimeTek Informatics",
   "homepage": "https://primeicons.org/",
   "description": "PrimeIcons for React - 300+ customizable SVG icons as React components",
@@ -56,7 +56,7 @@
   ],
   "dependencies": {
     "@primeuix/utils": "^0.6.4",
-    "@primeicons/core": "8.0.0-alpha.4"
+    "@primeicons/core": "8.0.0-alpha.5"
   },
   "peerDependencies": {
     "react": ">=17"