@iconix/icons 0.0.0-stage → 1.0.0

package/dist/index.cjs

@@ -0,0 +1,116 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_OPTIONS: () => import_core.DEFAULT_OPTIONS,
+  OPTION_KEYS: () => import_core.OPTION_KEYS,
+  buildIconTree: () => import_core.buildIconTree,
+  categories: () => import_registry.categories,
+  createElement: () => createElement,
+  escapeHtml: () => import_core.escapeHtml,
+  getDefaults: () => import_core.getDefaults,
+  getIcon: () => getIcon,
+  getIconsByCategory: () => getIconsByCategory,
+  hasIcon: () => hasIcon,
+  iconNames: () => import_registry.iconNames,
+  icons: () => import_registry.icons,
+  isIcon: () => import_core.isIcon,
+  replace: () => replace,
+  resetDefaults: () => import_core.resetDefaults,
+  resolveOptions: () => import_core.resolveOptions,
+  searchIcons: () => searchIcons,
+  setDefaults: () => import_core.setDefaults,
+  suggestIcons: () => suggestIcons,
+  toDataUri: () => toDataUri,
+  toSprite: () => toSprite,
+  toSvg: () => toSvg,
+  treeToElement: () => import_core.treeToElement,
+  treeToString: () => import_core.treeToString
+});
+module.exports = __toCommonJS(index_exports);
+var core = __toESM(require("./core.cjs"));
+var import_registry = require("./generated/registry.cjs");
+__reExport(index_exports, require("./generated/data.cjs"), module.exports);
+var import_core = require("./core.cjs");
+const registry = import_registry.icons;
+function getIcon(name) {
+  if (core.isIcon(name)) return name;
+  if (typeof name !== "string") return void 0;
+  return Object.prototype.hasOwnProperty.call(registry, name) ? registry[name] : void 0;
+}
+function hasIcon(name) {
+  return getIcon(name) !== void 0;
+}
+function suggestIcons(name, limit = 3) {
+  const q = String(name).toLowerCase();
+  return import_registry.iconNames.map((n) => [n, core.levenshtein(q, n) - (n.includes(q) || q.includes(n) ? 2 : 0)]).sort((a, b) => a[1] - b[1] || a[0].localeCompare(b[0])).slice(0, limit).map(([n]) => n);
+}
+function resolveIcon(nameOrIcon) {
+  const icon = getIcon(nameOrIcon);
+  if (!icon) {
+    const hint = typeof nameOrIcon === "string" ? ` Did you mean: ${suggestIcons(nameOrIcon).join(", ")}?` : "";
+    throw new Error(`[iconix] unknown icon ${JSON.stringify(nameOrIcon)}.${hint}`);
+  }
+  return icon;
+}
+function toSvg(icon, options) {
+  return core.toSvg(resolveIcon(icon), options);
+}
+function toDataUri(icon, options) {
+  return core.toDataUri(resolveIcon(icon), options);
+}
+function createElement(icon, options, doc) {
+  return core.createElement(resolveIcon(icon), options, doc);
+}
+function toSprite(list, options) {
+  const items = list === void 0 ? Object.values(registry) : (Array.isArray(list) ? list : [list]).map(resolveIcon);
+  return core.toSprite(items, options);
+}
+function replace(options) {
+  return core.replaceElements((name) => getIcon(name), options);
+}
+function getIconsByCategory(category) {
+  return Object.values(import_registry.icons).filter((icon) => icon.category === category);
+}
+function searchIcons(query, { limit = 50, category } = {}) {
+  const q = String(query || "").trim().toLowerCase();
+  const results = [];
+  for (const icon of Object.values(import_registry.icons)) {
+    if (category && icon.category !== category) continue;
+    let score = -1;
+    if (!q) score = 0;
+    else if (icon.name === q) score = 100;
+    else if (icon.name.startsWith(q)) score = 80;
+    else if (icon.name.split("-").includes(q)) score = 70;
+    else if (icon.name.includes(q)) score = 50;
+    else if (icon.category.includes(q)) score = 20;
+    if (score >= 0) results.push([score, icon]);
+  }
+  return results.sort((a, b) => b[0] - a[0] || a[1].name.localeCompare(b[1].name)).slice(0, limit).map(([, icon]) => icon);
+}

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import { icons, categories, iconNames } from './generated/registry.cjs';
+import type { IconCategory, IconData, IconLike, IconName, IconOptions, ReplaceOptions, SpriteOptions } from './types.cjs';
+export * from './generated/data.cjs';
+export type * from './types.cjs';
+export { icons, categories, iconNames };
+export { DEFAULT_OPTIONS, OPTION_KEYS, setDefaults, getDefaults, resetDefaults, resolveOptions, buildIconTree, treeToString, treeToElement, isIcon, escapeHtml, } from './core.cjs';
+/** A built-in icon name or any icon object. */
+export type IconInput = IconName | IconLike;
+/** Returns an icon object by name (or undefined). */
+export declare function getIcon<N extends IconName>(name: N | IconData<N>): IconData<N>;
+export declare function getIcon(name: unknown): IconLike | undefined;
+export declare function hasIcon(name: string): name is IconName;
+/** Suggests the closest icon names (e.g. for a typo). */
+export declare function suggestIcons(name: string, limit?: number): IconName[];
+/** Returns SVG markup as a string. */
+export declare function toSvg(icon: IconInput, options?: IconOptions): string;
+/** Returns a data URI for <img src> or CSS background-image. */
+export declare function toDataUri(icon: IconInput, options?: IconOptions): string;
+/** Creates an <svg> DOM element. */
+export declare function createElement(icon: IconInput, options?: IconOptions, doc?: Document): SVGSVGElement;
+/** Returns an SVG sprite of the given icons (names or objects); without a list – all icons. */
+export declare function toSprite(list?: IconInput | IconInput[], options?: SpriteOptions): string;
+/** Replaces <i data-icon="name" data-size="32"> with <svg>. Returns the number of replacements. */
+export declare function replace(options?: ReplaceOptions): number;
+/** Icons in the given category. */
+export declare function getIconsByCategory(category: IconCategory): IconData[];
+export interface SearchOptions {
+    limit?: number;
+    category?: IconCategory;
+}
+/** Searches icons by name and category. */
+export declare function searchIcons(query: string, { limit, category }?: SearchOptions): IconData[];

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { icons, categories, iconNames } from './generated/registry.js';
+import type { IconCategory, IconData, IconLike, IconName, IconOptions, ReplaceOptions, SpriteOptions } from './types.js';
+export * from './generated/data.js';
+export type * from './types.js';
+export { icons, categories, iconNames };
+export { DEFAULT_OPTIONS, OPTION_KEYS, setDefaults, getDefaults, resetDefaults, resolveOptions, buildIconTree, treeToString, treeToElement, isIcon, escapeHtml, } from './core.js';
+/** A built-in icon name or any icon object. */
+export type IconInput = IconName | IconLike;
+/** Returns an icon object by name (or undefined). */
+export declare function getIcon<N extends IconName>(name: N | IconData<N>): IconData<N>;
+export declare function getIcon(name: unknown): IconLike | undefined;
+export declare function hasIcon(name: string): name is IconName;
+/** Suggests the closest icon names (e.g. for a typo). */
+export declare function suggestIcons(name: string, limit?: number): IconName[];
+/** Returns SVG markup as a string. */
+export declare function toSvg(icon: IconInput, options?: IconOptions): string;
+/** Returns a data URI for <img src> or CSS background-image. */
+export declare function toDataUri(icon: IconInput, options?: IconOptions): string;
+/** Creates an <svg> DOM element. */
+export declare function createElement(icon: IconInput, options?: IconOptions, doc?: Document): SVGSVGElement;
+/** Returns an SVG sprite of the given icons (names or objects); without a list – all icons. */
+export declare function toSprite(list?: IconInput | IconInput[], options?: SpriteOptions): string;
+/** Replaces <i data-icon="name" data-size="32"> with <svg>. Returns the number of replacements. */
+export declare function replace(options?: ReplaceOptions): number;
+/** Icons in the given category. */
+export declare function getIconsByCategory(category: IconCategory): IconData[];
+export interface SearchOptions {
+    limit?: number;
+    category?: IconCategory;
+}
+/** Searches icons by name and category. */
+export declare function searchIcons(query: string, { limit, category }?: SearchOptions): IconData[];

package/dist/index.js

@@ -0,0 +1,98 @@
+import * as core from "./core.js";
+import { icons, categories, iconNames } from "./generated/registry.js";
+export * from "./generated/data.js";
+import {
+  DEFAULT_OPTIONS,
+  OPTION_KEYS,
+  setDefaults,
+  getDefaults,
+  resetDefaults,
+  resolveOptions,
+  buildIconTree,
+  treeToString,
+  treeToElement,
+  isIcon,
+  escapeHtml
+} from "./core.js";
+const registry = icons;
+function getIcon(name) {
+  if (core.isIcon(name)) return name;
+  if (typeof name !== "string") return void 0;
+  return Object.prototype.hasOwnProperty.call(registry, name) ? registry[name] : void 0;
+}
+function hasIcon(name) {
+  return getIcon(name) !== void 0;
+}
+function suggestIcons(name, limit = 3) {
+  const q = String(name).toLowerCase();
+  return iconNames.map((n) => [n, core.levenshtein(q, n) - (n.includes(q) || q.includes(n) ? 2 : 0)]).sort((a, b) => a[1] - b[1] || a[0].localeCompare(b[0])).slice(0, limit).map(([n]) => n);
+}
+function resolveIcon(nameOrIcon) {
+  const icon = getIcon(nameOrIcon);
+  if (!icon) {
+    const hint = typeof nameOrIcon === "string" ? ` Did you mean: ${suggestIcons(nameOrIcon).join(", ")}?` : "";
+    throw new Error(`[iconix] unknown icon ${JSON.stringify(nameOrIcon)}.${hint}`);
+  }
+  return icon;
+}
+function toSvg(icon, options) {
+  return core.toSvg(resolveIcon(icon), options);
+}
+function toDataUri(icon, options) {
+  return core.toDataUri(resolveIcon(icon), options);
+}
+function createElement(icon, options, doc) {
+  return core.createElement(resolveIcon(icon), options, doc);
+}
+function toSprite(list, options) {
+  const items = list === void 0 ? Object.values(registry) : (Array.isArray(list) ? list : [list]).map(resolveIcon);
+  return core.toSprite(items, options);
+}
+function replace(options) {
+  return core.replaceElements((name) => getIcon(name), options);
+}
+function getIconsByCategory(category) {
+  return Object.values(icons).filter((icon) => icon.category === category);
+}
+function searchIcons(query, { limit = 50, category } = {}) {
+  const q = String(query || "").trim().toLowerCase();
+  const results = [];
+  for (const icon of Object.values(icons)) {
+    if (category && icon.category !== category) continue;
+    let score = -1;
+    if (!q) score = 0;
+    else if (icon.name === q) score = 100;
+    else if (icon.name.startsWith(q)) score = 80;
+    else if (icon.name.split("-").includes(q)) score = 70;
+    else if (icon.name.includes(q)) score = 50;
+    else if (icon.category.includes(q)) score = 20;
+    if (score >= 0) results.push([score, icon]);
+  }
+  return results.sort((a, b) => b[0] - a[0] || a[1].name.localeCompare(b[1].name)).slice(0, limit).map(([, icon]) => icon);
+}
+export {
+  DEFAULT_OPTIONS,
+  OPTION_KEYS,
+  buildIconTree,
+  categories,
+  createElement,
+  escapeHtml,
+  getDefaults,
+  getIcon,
+  getIconsByCategory,
+  hasIcon,
+  iconNames,
+  icons,
+  isIcon,
+  replace,
+  resetDefaults,
+  resolveOptions,
+  searchIcons,
+  setDefaults,
+  suggestIcons,
+  toDataUri,
+  toSprite,
+  toSvg,
+  treeToElement,
+  treeToString
+};

package/dist/lite.cjs

@@ -0,0 +1,40 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var lite_exports = {};
+__export(lite_exports, {
+  DEFAULT_OPTIONS: () => import_core.DEFAULT_OPTIONS,
+  OPTION_KEYS: () => import_core.OPTION_KEYS,
+  buildIconTree: () => import_core.buildIconTree,
+  createElement: () => import_core.createElement,
+  escapeHtml: () => import_core.escapeHtml,
+  getDefaults: () => import_core.getDefaults,
+  isIcon: () => import_core.isIcon,
+  replaceElements: () => import_core.replaceElements,
+  resetDefaults: () => import_core.resetDefaults,
+  resolveOptions: () => import_core.resolveOptions,
+  setDefaults: () => import_core.setDefaults,
+  toDataUri: () => import_core.toDataUri,
+  toSprite: () => import_core.toSprite,
+  toSvg: () => import_core.toSvg,
+  treeToElement: () => import_core.treeToElement,
+  treeToString: () => import_core.treeToString
+});
+module.exports = __toCommonJS(lite_exports);
+__reExport(lite_exports, require("./generated/data.cjs"), module.exports);
+var import_core = require("./core.cjs");

package/dist/lite.d.cts

@@ -0,0 +1,3 @@
+export * from './generated/data.cjs';
+export type * from './types.cjs';
+export { DEFAULT_OPTIONS, OPTION_KEYS, setDefaults, getDefaults, resetDefaults, resolveOptions, buildIconTree, treeToString, treeToElement, isIcon, escapeHtml, toSvg, toDataUri, toSprite, createElement, replaceElements, } from './core.cjs';

package/dist/lite.d.ts

@@ -0,0 +1,3 @@
+export * from './generated/data.js';
+export type * from './types.js';
+export { DEFAULT_OPTIONS, OPTION_KEYS, setDefaults, getDefaults, resetDefaults, resolveOptions, buildIconTree, treeToString, treeToElement, isIcon, escapeHtml, toSvg, toDataUri, toSprite, createElement, replaceElements, } from './core.js';

package/dist/lite.js

@@ -0,0 +1,37 @@
+export * from "./generated/data.js";
+import {
+  DEFAULT_OPTIONS,
+  OPTION_KEYS,
+  setDefaults,
+  getDefaults,
+  resetDefaults,
+  resolveOptions,
+  buildIconTree,
+  treeToString,
+  treeToElement,
+  isIcon,
+  escapeHtml,
+  toSvg,
+  toDataUri,
+  toSprite,
+  createElement,
+  replaceElements
+} from "./core.js";
+export {
+  DEFAULT_OPTIONS,
+  OPTION_KEYS,
+  buildIconTree,
+  createElement,
+  escapeHtml,
+  getDefaults,
+  isIcon,
+  replaceElements,
+  resetDefaults,
+  resolveOptions,
+  setDefaults,
+  toDataUri,
+  toSprite,
+  toSvg,
+  treeToElement,
+  treeToString
+};

package/dist/react-core.cjs

@@ -0,0 +1,133 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var react_core_exports = {};
+__export(react_core_exports, {
+  Icon: () => Icon,
+  IconProvider: () => IconProvider,
+  createIconComponent: () => createIconComponent,
+  useIconDefaults: () => useIconDefaults
+});
+module.exports = __toCommonJS(react_core_exports);
+var React = __toESM(require("react"));
+var import_core = require("./core.cjs");
+var import_registry = require("./generated/registry.cjs");
+function createIconContext() {
+  return typeof React.createContext === "function" ? React.createContext({}) : null;
+}
+const IconContext = /* @__PURE__ */ createIconContext();
+function useDefaults() {
+  return IconContext && typeof React.useContext === "function" ? React.useContext(IconContext) : {};
+}
+const OPTION_SET = new Set(import_core.OPTION_KEYS);
+function splitProps(props) {
+  const options = {};
+  const rest = {};
+  for (const [key, value] of Object.entries(props)) {
+    if (OPTION_SET.has(key)) {
+      if (value !== void 0) options[key] = value;
+    } else {
+      rest[key] = value;
+    }
+  }
+  return { options, rest };
+}
+function IconProvider(props) {
+  if (!IconContext) {
+    throw new Error('[iconix] IconProvider must be rendered in a client component. Add "use client" at the top of the file that renders it.');
+  }
+  const { children, ...defaults } = props;
+  const parent = useDefaults();
+  const { options } = splitProps(defaults);
+  return React.createElement(IconContext.Provider, { value: { ...parent, ...options } }, children);
+}
+function useIconDefaults() {
+  return useDefaults();
+}
+function reactAttrName(key) {
+  if (key === "class") return "className";
+  if (key.startsWith("aria-") || key.startsWith("data-")) return key;
+  return key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function reactAttrs(attrs) {
+  const out = {};
+  for (const [k, v] of Object.entries(attrs)) out[reactAttrName(k)] = v;
+  return out;
+}
+function parseStyle(style) {
+  if (!style) return void 0;
+  if (typeof style !== "string") return style;
+  const out = {};
+  for (const decl of style.split(";")) {
+    const idx = decl.indexOf(":");
+    if (idx < 0) continue;
+    const prop = decl.slice(0, idx).trim();
+    const value = decl.slice(idx + 1).trim();
+    if (!prop) continue;
+    out[prop.startsWith("--") ? prop : prop.replace(/-([a-z])/g, (_, c) => c.toUpperCase())] = value;
+  }
+  return out;
+}
+function renderNodes(nodes) {
+  return nodes.map(([tag, attrs, children], i) => React.createElement(
+    tag,
+    { key: i, ...reactAttrs(attrs) },
+    ...children ? renderNodes(children) : []
+  ));
+}
+function renderTree(tree, extraProps) {
+  const props = { ...reactAttrs(tree.attrs), ...extraProps };
+  const style = parseStyle(tree.style);
+  if (style) props.style = style;
+  const children = renderNodes(tree.children);
+  if (tree.title) children.unshift(React.createElement("title", { key: "title" }, tree.title));
+  return React.createElement("svg", props, ...children);
+}
+function renderIcon(icon, props, ref, ctx) {
+  const { options, rest } = splitProps(props);
+  const tree = (0, import_core.buildIconTree)(icon, { ...ctx, ...options });
+  return renderTree(tree, ref ? { ...rest, ref } : rest);
+}
+function createIconComponent(icon) {
+  if (!(0, import_core.isIcon)(icon)) throw new TypeError("[iconix] createIconComponent() expects an icon object");
+  const Component = React.forwardRef(function IconixIcon(props, ref) {
+    return renderIcon(icon, props, ref, useDefaults());
+  });
+  Component.displayName = `Icon${(0, import_core.toPascalCase)(icon.name)}`;
+  return Object.assign(Component, { icon });
+}
+const registry = import_registry.icons;
+function createNamedIcon() {
+  return React.forwardRef(function Icon2(props, ref) {
+    const { name, ...rest } = props;
+    const ctx = useDefaults();
+    const icon = (0, import_core.isIcon)(name) ? name : registry[name];
+    if (!icon) throw new Error(`[iconix] unknown icon ${JSON.stringify(name)}`);
+    return renderIcon(icon, rest, ref, ctx);
+  });
+}
+const Icon = /* @__PURE__ */ createNamedIcon();

package/dist/react-core.d.cts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { IconLike, IconName, IconOptions } from './types.cjs';
+/** Icon component props: iconix options + all <svg> props. */
+export type IconProps = Omit<React.SVGProps<SVGSVGElement>, keyof IconOptions | 'ref'> & Omit<IconOptions, 'attrs' | 'style'> & {
+    style?: React.CSSProperties | string;
+};
+export type IconixIcon = React.ForwardRefExoticComponent<IconProps & React.RefAttributes<SVGSVGElement>> & {
+    icon: IconLike;
+};
+export type NamedIconProps = Omit<IconProps, 'name'> & {
+    name: IconName | IconLike;
+};
+export type IconProviderProps = Omit<IconOptions, 'attrs'> & {
+    children?: React.ReactNode;
+};
+/** Sets default options for all icons inside. Nested providers merge their values. */
+export declare function IconProvider(props: IconProviderProps): React.ReactElement;
+export declare function useIconDefaults(): IconOptions;
+/** Creates a React component for any icon object. */
+export declare function createIconComponent(icon: IconLike): IconixIcon;
+/** <Icon name="home" /> – icon by name (bundles all icons). */
+export declare const Icon: React.ForwardRefExoticComponent<NamedIconProps & React.RefAttributes<SVGSVGElement>>;

package/dist/react-core.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { IconLike, IconName, IconOptions } from './types.js';
+/** Icon component props: iconix options + all <svg> props. */
+export type IconProps = Omit<React.SVGProps<SVGSVGElement>, keyof IconOptions | 'ref'> & Omit<IconOptions, 'attrs' | 'style'> & {
+    style?: React.CSSProperties | string;
+};
+export type IconixIcon = React.ForwardRefExoticComponent<IconProps & React.RefAttributes<SVGSVGElement>> & {
+    icon: IconLike;
+};
+export type NamedIconProps = Omit<IconProps, 'name'> & {
+    name: IconName | IconLike;
+};
+export type IconProviderProps = Omit<IconOptions, 'attrs'> & {
+    children?: React.ReactNode;
+};
+/** Sets default options for all icons inside. Nested providers merge their values. */
+export declare function IconProvider(props: IconProviderProps): React.ReactElement;
+export declare function useIconDefaults(): IconOptions;
+/** Creates a React component for any icon object. */
+export declare function createIconComponent(icon: IconLike): IconixIcon;
+/** <Icon name="home" /> – icon by name (bundles all icons). */
+export declare const Icon: React.ForwardRefExoticComponent<NamedIconProps & React.RefAttributes<SVGSVGElement>>;

package/dist/react-core.js

@@ -0,0 +1,104 @@
+import * as React from "react";
+import { buildIconTree, OPTION_KEYS, isIcon, toPascalCase } from "./core.js";
+import { icons } from "./generated/registry.js";
+function createIconContext() {
+  return typeof React.createContext === "function" ? React.createContext({}) : null;
+}
+const IconContext = /* @__PURE__ */ createIconContext();
+function useDefaults() {
+  return IconContext && typeof React.useContext === "function" ? React.useContext(IconContext) : {};
+}
+const OPTION_SET = new Set(OPTION_KEYS);
+function splitProps(props) {
+  const options = {};
+  const rest = {};
+  for (const [key, value] of Object.entries(props)) {
+    if (OPTION_SET.has(key)) {
+      if (value !== void 0) options[key] = value;
+    } else {
+      rest[key] = value;
+    }
+  }
+  return { options, rest };
+}
+function IconProvider(props) {
+  if (!IconContext) {
+    throw new Error('[iconix] IconProvider must be rendered in a client component. Add "use client" at the top of the file that renders it.');
+  }
+  const { children, ...defaults } = props;
+  const parent = useDefaults();
+  const { options } = splitProps(defaults);
+  return React.createElement(IconContext.Provider, { value: { ...parent, ...options } }, children);
+}
+function useIconDefaults() {
+  return useDefaults();
+}
+function reactAttrName(key) {
+  if (key === "class") return "className";
+  if (key.startsWith("aria-") || key.startsWith("data-")) return key;
+  return key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function reactAttrs(attrs) {
+  const out = {};
+  for (const [k, v] of Object.entries(attrs)) out[reactAttrName(k)] = v;
+  return out;
+}
+function parseStyle(style) {
+  if (!style) return void 0;
+  if (typeof style !== "string") return style;
+  const out = {};
+  for (const decl of style.split(";")) {
+    const idx = decl.indexOf(":");
+    if (idx < 0) continue;
+    const prop = decl.slice(0, idx).trim();
+    const value = decl.slice(idx + 1).trim();
+    if (!prop) continue;
+    out[prop.startsWith("--") ? prop : prop.replace(/-([a-z])/g, (_, c) => c.toUpperCase())] = value;
+  }
+  return out;
+}
+function renderNodes(nodes) {
+  return nodes.map(([tag, attrs, children], i) => React.createElement(
+    tag,
+    { key: i, ...reactAttrs(attrs) },
+    ...children ? renderNodes(children) : []
+  ));
+}
+function renderTree(tree, extraProps) {
+  const props = { ...reactAttrs(tree.attrs), ...extraProps };
+  const style = parseStyle(tree.style);
+  if (style) props.style = style;
+  const children = renderNodes(tree.children);
+  if (tree.title) children.unshift(React.createElement("title", { key: "title" }, tree.title));
+  return React.createElement("svg", props, ...children);
+}
+function renderIcon(icon, props, ref, ctx) {
+  const { options, rest } = splitProps(props);
+  const tree = buildIconTree(icon, { ...ctx, ...options });
+  return renderTree(tree, ref ? { ...rest, ref } : rest);
+}
+function createIconComponent(icon) {
+  if (!isIcon(icon)) throw new TypeError("[iconix] createIconComponent() expects an icon object");
+  const Component = React.forwardRef(function IconixIcon(props, ref) {
+    return renderIcon(icon, props, ref, useDefaults());
+  });
+  Component.displayName = `Icon${toPascalCase(icon.name)}`;
+  return Object.assign(Component, { icon });
+}
+const registry = icons;
+function createNamedIcon() {
+  return React.forwardRef(function Icon2(props, ref) {
+    const { name, ...rest } = props;
+    const ctx = useDefaults();
+    const icon = isIcon(name) ? name : registry[name];
+    if (!icon) throw new Error(`[iconix] unknown icon ${JSON.stringify(name)}`);
+    return renderIcon(icon, rest, ref, ctx);
+  });
+}
+const Icon = /* @__PURE__ */ createNamedIcon();
+export {
+  Icon,
+  IconProvider,
+  createIconComponent,
+  useIconDefaults
+};