@cruxkit/icon 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Maysara Elshewehy (https://github.com/maysara-elshewehy)
+
+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,185 @@
+<!-- ╔══════════════════════════════ BEG ══════════════════════════════╗ -->
+
+<br>
+<div align="center">
+    <p>
+        <img src="./assets/img/logo.png" alt="logo" style="" height="60" />
+    </p>
+</div>
+
+<div align="center">
+    <img src="https://img.shields.io/badge/v-0.0.1-black"/>
+    <a href="https://github.com/cruxkit-org"><img src="https://img.shields.io/badge/🔥-@cruxkit-black"/></a>
+    <br>
+    <img src="https://img.shields.io/badge/coverage-99%25-brightgreen" alt="Test Coverage" />
+    <img src="https://img.shields.io/github/issues/cruxkit-orgx/icon?style=flat" alt="Github Repo Issues" />
+    <img src="https://img.shields.io/github/stars/cruxkit-orgx/icon?style=social" alt="GitHub Repo stars" />
+</div>
+<br>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔══════════════════════════════ DOC ══════════════════════════════╗ -->
+
+- ## Overview 👀
+    - #### Why ?
+        > A lightweight, type-safe icon library offering full TypeScript support and effortless customization.
+
+    - #### When ?
+        > Whenever you need crisp, scalable SVG icons inside CruxJS (or any JSX) projects without pulling in thousands of unused glyphs or heavy CSS frameworks.
+
+    <br>
+    <br>
+
+- ## Quick Start 🔥
+
+    > install [`hmm`](https://github.com/minejs-org/hmm) first.
+
+    ```bash
+    # in your terminal
+    hmm i @cruxkit/icon
+    ```
+
+    ```ts
+    // in your ts files
+    import { ... } from `@cruxkit/icon`;
+    ```
+
+    <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
+    <br>
+
+
+    - ### Basic usage
+
+        ```typescript
+        import { Icon } from '@cruxkit/icon';
+
+        const ChevronDown = Icon('chevron-down');
+        ```
+
+    - ### With options
+
+        ```typescript
+        import { Icon } from '@cruxkit/icon';
+
+        const LargePrimaryChevron = Icon({
+            name    : 'chevron-down',
+            size    : 'xl',
+            color   : '#111827',
+        });
+        ```
+
+    - ### Custom SVG
+
+        ```typescript
+        import { Icon } from '@cruxkit/icon';
+
+        const CustomCircle = Icon({
+            svg     : `<circle cx="12" cy="12" r="10" />`,
+            viewBox : '0 0 24 24',
+            size    : 24,
+            color   : '#16a34a',
+        });
+        ```
+
+    <br>
+    <br>
+
+- ## Documentation 📑
+
+
+    - ### API ⛓️
+
+        - #### Functions
+
+            ```typescript
+            /**
+            * Icon Component
+            * Renders inline SVG icons with various options
+            *
+            * @example
+            * Icon('check')
+            * Icon({ name: 'spinner', spin: true, size: 'lg' })
+            */
+            export function Icon(props: IconProps) : JSXElement | null
+            ```
+
+        - #### Types
+
+            ```typescript
+            export type IconSize        = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | number;
+
+            export type IconData        = Record<string, unknown>;
+            export { iconCatalog };
+            export type IconName        = CatalogIconName;
+
+            interface IconConfigBase {
+                size?                   : IconSize
+                color?                  : string
+                spin?                   : boolean
+                pulse?                  : boolean
+                rotate?                 : 0 | 90 | 180 | 270
+                flip?                   : 'horizontal' | 'vertical' | 'both'
+                [key: string]           : unknown
+            }
+
+            export interface NamedIconConfig extends IconConfigBase {
+                name                    : IconName
+                svg?                    : never
+                viewBox?                : never
+            }
+
+            export interface CustomIconConfig extends IconConfigBase {
+                name?                   : string
+                svg                     : string
+                viewBox?                : string
+            }
+
+            export type IconConfig      = NamedIconConfig | CustomIconConfig;
+
+            export type IconProps       = IconConfig | IconName;
+            ```
+
+        - #### Constants
+
+            ```typescript
+            export const sizeMap: Record<string, string> = {
+                xs                      : '0.75rem',
+                sm                      : '1rem',
+                md                      : '1.25rem',
+                lg                      : '1.5rem',
+                xl                      : '2rem',
+                xxl                     : '2.5rem'
+            };
+            ```
+
+        <div align="center"> <img src="./assets/img/line.png" alt="line" style="display: block; margin-top:20px;margin-bottom:20px;width:500px;"/> </div>
+        <br>
+
+    - ### Related 🔗
+
+        - ##### [@minejs/jsx](https://github.com/minejs-org/jsx)
+
+        - ##### [@mineui/utils](https://github.com/mineui-org/utils)
+
+        - ##### [@cruxkit/..](https://github.com/cruxkit-org)
+
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->
+
+
+
+<!-- ╔══════════════════════════════ END ══════════════════════════════╗ -->
+
+<br>
+<br>
+
+---
+
+<div align="center">
+    <a href="https://github.com/maysara-elshewehy"><img src="https://img.shields.io/badge/by-Maysara-black"/></a>
+</div>
+
+<!-- ╚═════════════════════════════════════════════════════════════════╝ -->

package/dist/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var jsxRuntime=require('@minejs/jsx/jsx-runtime');var a={"chevron-down":{category:"chevron",viewBox:"0 0 24 24",svg:'<path d="M6 9L12 15L18 9" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'}};var e={...a},i={chevron:["chevron-down"]};var g={xs:"0.75rem",sm:"1rem",md:"1.25rem",lg:"1.5rem",xl:"2rem",xxl:"2.5rem"};function d(n){let o=typeof n=="string"?{name:n}:n,t=null;if(o.name&&o.name in e?t=e[o.name]:o.svg&&(t={viewBox:o.viewBox||"0 0 24 24",svg:o.svg}),!t)return o.name?console.warn(`Icon "${o.name}" not found in catalog`):console.warn("Icon configuration is invalid"),null;let r=o.size,s=typeof r=="number"?`${r}px`:g[r||"md"],c={width:s,height:s,display:"inline-block",verticalAlign:"middle",lineHeight:"1",flexShrink:"0"};return o.color&&(c.color=o.color),jsxRuntime.jsx("svg",{style:c,viewBox:t.viewBox,fill:"currentColor",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",role:"img",dangerouslySetInnerHTML:{__html:t.svg}})}function w(n){return n in e}function h(){return Object.keys(e)}function N(n){return i[n]||[]}function k(){return Object.keys(i)}
+exports.Icon=d;exports.getIconCategories=k;exports.getIconNames=h;exports.getIconsByCategory=N;exports.iconCatalog=e;exports.iconExists=w;exports.sizeMap=g;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kit/categories/chevron.ts","../src/kit/categories/index.ts","../src/kit/icon.tsx"],"names":["chevronIcons","iconCatalog","iconsByCategory","sizeMap","Icon","props","cfg","iconData","sizeValue","size","style","jsx","iconExists","name","getIconNames","getIconsByCategory","category","getIconCategories"],"mappings":"+DAAO,IAAMA,CAAAA,CAAe,CAC1B,cAAA,CAAgB,CACd,SAAU,SAAA,CACV,OAAA,CAAS,YACT,GAAA,CAAK,8GACP,CACF,CAAA,CCJO,IAAMC,EAAc,CACzB,GAAGD,CACL,CAAA,CAIaE,CAAAA,CAAkB,CAC7B,OAAA,CAAW,CAAC,cAAc,CAC5B,MCQiBC,CAAAA,CAAkC,CAC3C,GAAU,SAAA,CACV,EAAA,CAAU,OACV,EAAA,CAAU,SAAA,CACV,GAAU,QAAA,CACV,EAAA,CAAU,OACV,GAAA,CAAU,QACd,EAgBO,SAASC,CAAAA,CAAKC,CAAAA,CAAsC,CAWvD,IAAMC,CAAAA,CADS,OAAOD,CAAAA,EAAU,QAAA,CAAW,CAAE,IAAA,CAAMA,CAAM,EAAIA,CAAAA,CAGzDE,CAAAA,CAAoD,KAWxD,GATID,CAAAA,CAAI,MAAQA,CAAAA,CAAI,IAAA,IAAQL,EACxBM,CAAAA,CAAWN,CAAAA,CAAYK,CAAAA,CAAI,IAAgB,CAAA,CACpCA,CAAAA,CAAI,MACXC,CAAAA,CAAW,CACP,QAAUD,CAAAA,CAAI,OAAA,EAAW,YACzB,GAAA,CAAUA,CAAAA,CAAI,GAClB,CAAA,CAAA,CAGA,CAACC,EACD,OAAID,CAAAA,CAAI,KACJ,OAAA,CAAQ,IAAA,CAAK,SAASA,CAAAA,CAAI,IAAI,CAAA,sBAAA,CAAwB,CAAA,CAEtD,OAAA,CAAQ,IAAA,CAAK,+BAA+B,CAAA,CAEzC,IAAA,CAGX,IAAME,CAAAA,CAAYF,CAAAA,CAAI,KAEhBG,CAAAA,CAAO,OAAOD,GAAc,QAAA,CAC5B,CAAA,EAAGA,CAAS,CAAA,EAAA,CAAA,CACZL,CAAAA,CAAQK,GAAa,IAAI,CAAA,CAEzBE,EAAgC,CAClC,KAAA,CAA0BD,CAAAA,CAC1B,MAAA,CAA0BA,CAAAA,CAC1B,OAAA,CAA0B,eAC1B,aAAA,CAA0B,QAAA,CAC1B,WAA0B,GAAA,CAC1B,UAAA,CAA0B,GAC9B,CAAA,CAEA,OAAIH,EAAI,KAAA,GAAOI,CAAAA,CAAM,MAAQJ,CAAAA,CAAI,KAAA,CAAA,CAG7BK,eAAC,KAAA,CAAA,CACG,KAAA,CAAuBD,EACvB,OAAA,CAAuBH,CAAAA,CAAS,OAAA,CAChC,IAAA,CAAsB,cAAA,CACtB,KAAA,CAAsB,6BACtB,aAAA,CAAsB,MAAA,CACtB,KAAsB,KAAA,CACtB,uBAAA,CAA2B,CACvB,MAAA,CAAkBA,CAAAA,CAAS,GAC/B,CAAA,CACJ,CAER,CAKO,SAASK,CAAAA,CAAWC,EAAgC,CACvD,OAAOA,KAAQZ,CACnB,CAKO,SAASa,CAAAA,EAA2B,CACvC,OAAO,OAAO,IAAA,CAAKb,CAAW,CAClC,CAKO,SAASc,EAAmBC,CAAAA,CAA8B,CAC7D,OAAQd,CAAAA,CAAgBc,CAAwC,GAAK,EACzE,CAKO,SAASC,CAAAA,EAA8B,CAC1C,OAAO,MAAA,CAAO,IAAA,CAAKf,CAAe,CACtC","file":"index.cjs","sourcesContent":["export const chevronIcons = {\n  'chevron-down': {\n    category: 'chevron',\n    viewBox: '0 0 24 24',\n    svg: `<path d=\"M6 9L12 15L18 9\" stroke=\"#000000\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>`,\n  },\n} as const;\n\nexport type ChevronIconName = keyof typeof chevronIcons;\n","import { chevronIcons } from './chevron';\n\nexport const iconCatalog = {\n  ...chevronIcons,\n} as const;\n\nexport type IconName = keyof typeof iconCatalog;\n\nexport const iconsByCategory = {\n  'chevron': ['chevron-down'],\n} as const;\n","// src/kit/icon.tsx\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { JSXElement }                               from '@minejs/jsx';\r\n    import { IconProps, iconCatalog, type IconName }    from '../types';\r\n    import { iconsByCategory }                          from './categories';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ INIT ════════════════════════════════════════╗\r\n\r\n    export const sizeMap: Record<string, string> = {\r\n        xs      : '0.75rem',\r\n        sm      : '1rem',\r\n        md      : '1.25rem',\r\n        lg      : '1.5rem',\r\n        xl      : '2rem',\r\n        'xxl'   : '2.5rem'\r\n    };\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    /**\r\n     * Icon Component\r\n     * Renders inline SVG icons with various options\r\n     *\r\n     * @example\r\n     * Icon('check')\r\n     * Icon({ name: 'spinner', spin: true, size: 'lg' })\r\n     */\r\n    export function Icon(props: IconProps) : JSXElement | null {\r\n\r\n        interface IconLikeConfig {\r\n            name?       : string\r\n            size?       : number | string\r\n            color?      : string\r\n            svg?        : string\r\n            viewBox?    : string\r\n        }\r\n\r\n        const config = typeof props === 'string' ? { name: props } : props;\r\n        const cfg    = config as IconLikeConfig;\r\n\r\n        let iconData: { viewBox: string; svg: string } | null = null;\r\n\r\n        if (cfg.name && cfg.name in iconCatalog) {\r\n            iconData = iconCatalog[cfg.name as IconName] as { viewBox: string; svg: string };\r\n        } else if (cfg.svg) {\r\n            iconData = {\r\n                viewBox : cfg.viewBox || '0 0 24 24',\r\n                svg     : cfg.svg\r\n            };\r\n        }\r\n\r\n        if (!iconData) {\r\n            if (cfg.name) {\r\n                console.warn(`Icon \"${cfg.name}\" not found in catalog`);\r\n            } else {\r\n                console.warn('Icon configuration is invalid');\r\n            }\r\n            return null;\r\n        }\r\n\r\n        const sizeValue = cfg.size;\r\n\r\n        const size = typeof sizeValue === 'number'\r\n            ? `${sizeValue}px`\r\n            : sizeMap[sizeValue || 'md'];\r\n\r\n        const style: Record<string, string> = {\r\n            width                   : size,\r\n            height                  : size,\r\n            display                 : 'inline-block',\r\n            verticalAlign           : 'middle',\r\n            lineHeight              : '1',\r\n            flexShrink              : '0'\r\n        };\r\n\r\n        if (cfg.color) style.color = cfg.color;\r\n\r\n        return (\r\n            <svg\r\n                style               = {style}\r\n                viewBox             = {iconData.viewBox}\r\n                fill                = \"currentColor\"\r\n                xmlns               = \"http://www.w3.org/2000/svg\"\r\n                aria-hidden         = \"true\"\r\n                role                = \"img\"\r\n                dangerouslySetInnerHTML = {{\r\n                    __html          : iconData.svg\r\n                }}\r\n            />\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Utility function to check if an icon exists\r\n     */\r\n    export function iconExists(name: string): name is IconName {\r\n        return name in iconCatalog;\r\n    }\r\n\r\n    /**\r\n     * Get all available icon names\r\n     */\r\n    export function getIconNames(): IconName[] {\r\n        return Object.keys(iconCatalog) as IconName[];\r\n    }\r\n\r\n    /**\r\n     * Get icons by category\r\n     */\r\n    export function getIconsByCategory(category: string): IconName[] {\r\n        return (iconsByCategory[category as keyof typeof iconsByCategory] || []) as unknown as IconName[];\r\n    }\r\n\r\n    /**\r\n     * Get all available categories\r\n     */\r\n    export function getIconCategories(): string[] {\r\n        return Object.keys(iconsByCategory);\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+import { JSXElement } from '@minejs/jsx';
+
+declare const iconCatalog: {
+    readonly 'chevron-down': {
+        readonly category: "chevron";
+        readonly viewBox: "0 0 24 24";
+        readonly svg: "<path d=\"M6 9L12 15L18 9\" stroke=\"#000000\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>";
+    };
+};
+type IconName$1 = keyof typeof iconCatalog;
+
+type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | number;
+type IconData = Record<string, unknown>;
+
+type IconName = IconName$1;
+interface IconConfigBase {
+    size?: IconSize;
+    color?: string;
+    spin?: boolean;
+    pulse?: boolean;
+    rotate?: 0 | 90 | 180 | 270;
+    flip?: 'horizontal' | 'vertical' | 'both';
+    [key: string]: unknown;
+}
+interface NamedIconConfig extends IconConfigBase {
+    name: IconName;
+    svg?: never;
+    viewBox?: never;
+}
+interface CustomIconConfig extends IconConfigBase {
+    name?: string;
+    svg: string;
+    viewBox?: string;
+}
+type IconConfig = NamedIconConfig | CustomIconConfig;
+type IconProps = IconConfig | IconName;
+
+declare const sizeMap: Record<string, string>;
+/**
+ * Icon Component
+ * Renders inline SVG icons with various options
+ *
+ * @example
+ * Icon('check')
+ * Icon({ name: 'spinner', spin: true, size: 'lg' })
+ */
+declare function Icon(props: IconProps): JSXElement | null;
+/**
+ * Utility function to check if an icon exists
+ */
+declare function iconExists(name: string): name is IconName;
+/**
+ * Get all available icon names
+ */
+declare function getIconNames(): IconName[];
+/**
+ * Get icons by category
+ */
+declare function getIconsByCategory(category: string): IconName[];
+/**
+ * Get all available categories
+ */
+declare function getIconCategories(): string[];
+
+export { type CustomIconConfig, Icon, type IconConfig, type IconData, type IconName, type IconProps, type IconSize, type NamedIconConfig, getIconCategories, getIconNames, getIconsByCategory, iconCatalog, iconExists, sizeMap };

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { JSXElement } from '@minejs/jsx';
+
+declare const iconCatalog: {
+    readonly 'chevron-down': {
+        readonly category: "chevron";
+        readonly viewBox: "0 0 24 24";
+        readonly svg: "<path d=\"M6 9L12 15L18 9\" stroke=\"#000000\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>";
+    };
+};
+type IconName$1 = keyof typeof iconCatalog;
+
+type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl' | number;
+type IconData = Record<string, unknown>;
+
+type IconName = IconName$1;
+interface IconConfigBase {
+    size?: IconSize;
+    color?: string;
+    spin?: boolean;
+    pulse?: boolean;
+    rotate?: 0 | 90 | 180 | 270;
+    flip?: 'horizontal' | 'vertical' | 'both';
+    [key: string]: unknown;
+}
+interface NamedIconConfig extends IconConfigBase {
+    name: IconName;
+    svg?: never;
+    viewBox?: never;
+}
+interface CustomIconConfig extends IconConfigBase {
+    name?: string;
+    svg: string;
+    viewBox?: string;
+}
+type IconConfig = NamedIconConfig | CustomIconConfig;
+type IconProps = IconConfig | IconName;
+
+declare const sizeMap: Record<string, string>;
+/**
+ * Icon Component
+ * Renders inline SVG icons with various options
+ *
+ * @example
+ * Icon('check')
+ * Icon({ name: 'spinner', spin: true, size: 'lg' })
+ */
+declare function Icon(props: IconProps): JSXElement | null;
+/**
+ * Utility function to check if an icon exists
+ */
+declare function iconExists(name: string): name is IconName;
+/**
+ * Get all available icon names
+ */
+declare function getIconNames(): IconName[];
+/**
+ * Get icons by category
+ */
+declare function getIconsByCategory(category: string): IconName[];
+/**
+ * Get all available categories
+ */
+declare function getIconCategories(): string[];
+
+export { type CustomIconConfig, Icon, type IconConfig, type IconData, type IconName, type IconProps, type IconSize, type NamedIconConfig, getIconCategories, getIconNames, getIconsByCategory, iconCatalog, iconExists, sizeMap };

package/dist/index.js

@@ -0,0 +1,3 @@
+import {jsx}from'@minejs/jsx/jsx-runtime';var a={"chevron-down":{category:"chevron",viewBox:"0 0 24 24",svg:'<path d="M6 9L12 15L18 9" stroke="#000000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'}};var e={...a},i={chevron:["chevron-down"]};var g={xs:"0.75rem",sm:"1rem",md:"1.25rem",lg:"1.5rem",xl:"2rem",xxl:"2.5rem"};function d(n){let o=typeof n=="string"?{name:n}:n,t=null;if(o.name&&o.name in e?t=e[o.name]:o.svg&&(t={viewBox:o.viewBox||"0 0 24 24",svg:o.svg}),!t)return o.name?console.warn(`Icon "${o.name}" not found in catalog`):console.warn("Icon configuration is invalid"),null;let r=o.size,s=typeof r=="number"?`${r}px`:g[r||"md"],c={width:s,height:s,display:"inline-block",verticalAlign:"middle",lineHeight:"1",flexShrink:"0"};return o.color&&(c.color=o.color),jsx("svg",{style:c,viewBox:t.viewBox,fill:"currentColor",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",role:"img",dangerouslySetInnerHTML:{__html:t.svg}})}function w(n){return n in e}function h(){return Object.keys(e)}function N(n){return i[n]||[]}function k(){return Object.keys(i)}
+export{d as Icon,k as getIconCategories,h as getIconNames,N as getIconsByCategory,e as iconCatalog,w as iconExists,g as sizeMap};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/kit/categories/chevron.ts","../src/kit/categories/index.ts","../src/kit/icon.tsx"],"names":["chevronIcons","iconCatalog","iconsByCategory","sizeMap","Icon","props","cfg","iconData","sizeValue","size","style","jsx","iconExists","name","getIconNames","getIconsByCategory","category","getIconCategories"],"mappings":"0CAAO,IAAMA,CAAAA,CAAe,CAC1B,cAAA,CAAgB,CACd,SAAU,SAAA,CACV,OAAA,CAAS,YACT,GAAA,CAAK,8GACP,CACF,CAAA,CCJO,IAAMC,EAAc,CACzB,GAAGD,CACL,CAAA,CAIaE,CAAAA,CAAkB,CAC7B,OAAA,CAAW,CAAC,cAAc,CAC5B,MCQiBC,CAAAA,CAAkC,CAC3C,GAAU,SAAA,CACV,EAAA,CAAU,OACV,EAAA,CAAU,SAAA,CACV,GAAU,QAAA,CACV,EAAA,CAAU,OACV,GAAA,CAAU,QACd,EAgBO,SAASC,CAAAA,CAAKC,CAAAA,CAAsC,CAWvD,IAAMC,CAAAA,CADS,OAAOD,CAAAA,EAAU,QAAA,CAAW,CAAE,IAAA,CAAMA,CAAM,EAAIA,CAAAA,CAGzDE,CAAAA,CAAoD,KAWxD,GATID,CAAAA,CAAI,MAAQA,CAAAA,CAAI,IAAA,IAAQL,EACxBM,CAAAA,CAAWN,CAAAA,CAAYK,CAAAA,CAAI,IAAgB,CAAA,CACpCA,CAAAA,CAAI,MACXC,CAAAA,CAAW,CACP,QAAUD,CAAAA,CAAI,OAAA,EAAW,YACzB,GAAA,CAAUA,CAAAA,CAAI,GAClB,CAAA,CAAA,CAGA,CAACC,EACD,OAAID,CAAAA,CAAI,KACJ,OAAA,CAAQ,IAAA,CAAK,SAASA,CAAAA,CAAI,IAAI,CAAA,sBAAA,CAAwB,CAAA,CAEtD,OAAA,CAAQ,IAAA,CAAK,+BAA+B,CAAA,CAEzC,IAAA,CAGX,IAAME,CAAAA,CAAYF,CAAAA,CAAI,KAEhBG,CAAAA,CAAO,OAAOD,GAAc,QAAA,CAC5B,CAAA,EAAGA,CAAS,CAAA,EAAA,CAAA,CACZL,CAAAA,CAAQK,GAAa,IAAI,CAAA,CAEzBE,EAAgC,CAClC,KAAA,CAA0BD,CAAAA,CAC1B,MAAA,CAA0BA,CAAAA,CAC1B,OAAA,CAA0B,eAC1B,aAAA,CAA0B,QAAA,CAC1B,WAA0B,GAAA,CAC1B,UAAA,CAA0B,GAC9B,CAAA,CAEA,OAAIH,EAAI,KAAA,GAAOI,CAAAA,CAAM,MAAQJ,CAAAA,CAAI,KAAA,CAAA,CAG7BK,IAAC,KAAA,CAAA,CACG,KAAA,CAAuBD,EACvB,OAAA,CAAuBH,CAAAA,CAAS,OAAA,CAChC,IAAA,CAAsB,cAAA,CACtB,KAAA,CAAsB,6BACtB,aAAA,CAAsB,MAAA,CACtB,KAAsB,KAAA,CACtB,uBAAA,CAA2B,CACvB,MAAA,CAAkBA,CAAAA,CAAS,GAC/B,CAAA,CACJ,CAER,CAKO,SAASK,CAAAA,CAAWC,EAAgC,CACvD,OAAOA,KAAQZ,CACnB,CAKO,SAASa,CAAAA,EAA2B,CACvC,OAAO,OAAO,IAAA,CAAKb,CAAW,CAClC,CAKO,SAASc,EAAmBC,CAAAA,CAA8B,CAC7D,OAAQd,CAAAA,CAAgBc,CAAwC,GAAK,EACzE,CAKO,SAASC,CAAAA,EAA8B,CAC1C,OAAO,MAAA,CAAO,IAAA,CAAKf,CAAe,CACtC","file":"index.js","sourcesContent":["export const chevronIcons = {\n  'chevron-down': {\n    category: 'chevron',\n    viewBox: '0 0 24 24',\n    svg: `<path d=\"M6 9L12 15L18 9\" stroke=\"#000000\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>`,\n  },\n} as const;\n\nexport type ChevronIconName = keyof typeof chevronIcons;\n","import { chevronIcons } from './chevron';\n\nexport const iconCatalog = {\n  ...chevronIcons,\n} as const;\n\nexport type IconName = keyof typeof iconCatalog;\n\nexport const iconsByCategory = {\n  'chevron': ['chevron-down'],\n} as const;\n","// src/kit/icon.tsx\r\n//\r\n// Made with ❤️ by Maysara.\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ PACK ════════════════════════════════════════╗\r\n\r\n    import { JSXElement }                               from '@minejs/jsx';\r\n    import { IconProps, iconCatalog, type IconName }    from '../types';\r\n    import { iconsByCategory }                          from './categories';\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ INIT ════════════════════════════════════════╗\r\n\r\n    export const sizeMap: Record<string, string> = {\r\n        xs      : '0.75rem',\r\n        sm      : '1rem',\r\n        md      : '1.25rem',\r\n        lg      : '1.5rem',\r\n        xl      : '2rem',\r\n        'xxl'   : '2.5rem'\r\n    };\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n\r\n\r\n\r\n// ╔════════════════════════════════════════ CORE ════════════════════════════════════════╗\r\n\r\n    /**\r\n     * Icon Component\r\n     * Renders inline SVG icons with various options\r\n     *\r\n     * @example\r\n     * Icon('check')\r\n     * Icon({ name: 'spinner', spin: true, size: 'lg' })\r\n     */\r\n    export function Icon(props: IconProps) : JSXElement | null {\r\n\r\n        interface IconLikeConfig {\r\n            name?       : string\r\n            size?       : number | string\r\n            color?      : string\r\n            svg?        : string\r\n            viewBox?    : string\r\n        }\r\n\r\n        const config = typeof props === 'string' ? { name: props } : props;\r\n        const cfg    = config as IconLikeConfig;\r\n\r\n        let iconData: { viewBox: string; svg: string } | null = null;\r\n\r\n        if (cfg.name && cfg.name in iconCatalog) {\r\n            iconData = iconCatalog[cfg.name as IconName] as { viewBox: string; svg: string };\r\n        } else if (cfg.svg) {\r\n            iconData = {\r\n                viewBox : cfg.viewBox || '0 0 24 24',\r\n                svg     : cfg.svg\r\n            };\r\n        }\r\n\r\n        if (!iconData) {\r\n            if (cfg.name) {\r\n                console.warn(`Icon \"${cfg.name}\" not found in catalog`);\r\n            } else {\r\n                console.warn('Icon configuration is invalid');\r\n            }\r\n            return null;\r\n        }\r\n\r\n        const sizeValue = cfg.size;\r\n\r\n        const size = typeof sizeValue === 'number'\r\n            ? `${sizeValue}px`\r\n            : sizeMap[sizeValue || 'md'];\r\n\r\n        const style: Record<string, string> = {\r\n            width                   : size,\r\n            height                  : size,\r\n            display                 : 'inline-block',\r\n            verticalAlign           : 'middle',\r\n            lineHeight              : '1',\r\n            flexShrink              : '0'\r\n        };\r\n\r\n        if (cfg.color) style.color = cfg.color;\r\n\r\n        return (\r\n            <svg\r\n                style               = {style}\r\n                viewBox             = {iconData.viewBox}\r\n                fill                = \"currentColor\"\r\n                xmlns               = \"http://www.w3.org/2000/svg\"\r\n                aria-hidden         = \"true\"\r\n                role                = \"img\"\r\n                dangerouslySetInnerHTML = {{\r\n                    __html          : iconData.svg\r\n                }}\r\n            />\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Utility function to check if an icon exists\r\n     */\r\n    export function iconExists(name: string): name is IconName {\r\n        return name in iconCatalog;\r\n    }\r\n\r\n    /**\r\n     * Get all available icon names\r\n     */\r\n    export function getIconNames(): IconName[] {\r\n        return Object.keys(iconCatalog) as IconName[];\r\n    }\r\n\r\n    /**\r\n     * Get icons by category\r\n     */\r\n    export function getIconsByCategory(category: string): IconName[] {\r\n        return (iconsByCategory[category as keyof typeof iconsByCategory] || []) as unknown as IconName[];\r\n    }\r\n\r\n    /**\r\n     * Get all available categories\r\n     */\r\n    export function getIconCategories(): string[] {\r\n        return Object.keys(iconsByCategory);\r\n    }\r\n\r\n// ╚══════════════════════════════════════════════════════════════════════════════════════╝\r\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@cruxkit/icon",
+	"version": "0.0.1",
+	"description": "A lightweight, type-safe icon library offering full TypeScript support and effortless customization.",
+	"keywords": ["crux", "kit", "icon"],
+	"license": "MIT",
+	"homepage": "https://github.com/cruxkit-org/icon#readme",
+	"bugs": {
+		"url": "https://github.com/cruxkit-org/icon/issues"
+	},
+	"author": {
+		"name": "Maysara",
+		"email": "maysara.elshewehy@gmail.com",
+		"url": "https://github.com/maysara-elshewehy"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/cruxkit-org/icon.git"
+	},
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": ["dist"],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "bun builder/builder.ts && tsup",
+		"lint": "eslint src --ext .ts",
+		"test": "bun test"
+	},
+	"engines": {
+		"bun": ">=1.3.3"
+	},
+	"peerDependencies": {
+		"bun": "^1.3.3"
+	},
+	"dependencies": {
+		"@minejs/jsx": "^0.1.3"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.39.2",
+		"@stylistic/eslint-plugin": "^5.6.1",
+		"@types/bun": "^1.3.5",
+		"@types/node": "^20.19.27",
+		"@types/react": "^19.2.8",
+		"bun-plugin-dts": "^0.3.0",
+		"bun-types": "^1.3.5",
+		"ts-node": "^10.9.2",
+		"tsup": "^8.5.1",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.51.0"
+	}
+}