@dogsbay/icons 0.2.0-beta.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { IconRegistry, createIconRegistry } from "./registry.js";
+export type { IconResolver } from "./registry.js";

package/dist/index.js

@@ -0,0 +1 @@
+export { IconRegistry, createIconRegistry } from "./registry.js";

package/dist/registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * IconRegistry — resolves icon shortcodes to SVG strings.
+ *
+ * Supports multiple icon libraries via a pluggable resolver system.
+ * Built-in support for @iconify/json (material, fontawesome, octicons, simple)
+ * and gemoji-style emoji shortcodes (→ native Unicode).
+ */
+export interface IconResolver {
+    /** Resolve an icon name to an SVG string, or null if not found. */
+    resolve(name: string, variant?: string, size?: string): string | null;
+}
+export declare class IconRegistry {
+    private resolvers;
+    private emojiMap;
+    private iconifyCache;
+    /**
+     * Register a custom icon resolver for a library.
+     */
+    register(library: string, resolver: IconResolver): void;
+    /**
+     * Register custom emoji shortcodes.
+     */
+    registerEmoji(map: Record<string, string>): void;
+    /**
+     * Resolve a shortcode to an SVG string or Unicode emoji.
+     * Returns null if the icon is not found.
+     */
+    resolve(library: string, name: string, variant?: string, size?: string): string | null;
+    /**
+     * Resolve via @iconify/json icon data.
+     */
+    private resolveIconify;
+    /**
+     * Map our library/variant to @iconify/json prefix.
+     */
+    private getIconifyPrefix;
+    /**
+     * Load and cache an @iconify/json icon set.
+     * Returns a map of icon name → SVG body string.
+     */
+    private loadIconifySet;
+}
+/**
+ * Create a pre-configured registry with all built-in icon libraries.
+ */
+export declare function createIconRegistry(): IconRegistry;

package/dist/registry.js

@@ -0,0 +1,158 @@
+/**
+ * IconRegistry — resolves icon shortcodes to SVG strings.
+ *
+ * Supports multiple icon libraries via a pluggable resolver system.
+ * Built-in support for @iconify/json (material, fontawesome, octicons, simple)
+ * and gemoji-style emoji shortcodes (→ native Unicode).
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+/**
+ * Map of known emoji shortcodes → Unicode characters.
+ * This is a subset of gemoji covering the most common shortcodes.
+ * Apps can extend via registry.registerEmoji().
+ */
+const EMOJI_MAP = {
+    // Smileys
+    smile: "😄", grinning: "😀", laughing: "😆", rofl: "🤣",
+    joy: "😂", wink: "😉", blush: "😊", thinking: "🤔",
+    // Gestures
+    thumbsup: "👍", "+1": "👍", thumbsdown: "👎", "-1": "👎",
+    clap: "👏", wave: "👋", pray: "🙏", handshake: "🤝",
+    // Objects
+    rocket: "🚀", star: "⭐", fire: "🔥", sparkles: "✨",
+    bulb: "💡", wrench: "🔧", hammer: "🔨", gear: "⚙️",
+    lock: "🔒", key: "🔑", link: "🔗", paperclip: "📎",
+    bookmark: "🔖", pushpin: "📌", clipboard: "📋",
+    // Symbols
+    warning: "⚠️", x: "❌", white_check_mark: "✅",
+    heavy_check_mark: "✔️", question: "❓", exclamation: "❗",
+    heart: "❤️", broken_heart: "💔",
+    // Nature
+    sun: "☀️", moon: "🌙", cloud: "☁️", zap: "⚡",
+    snowflake: "❄️", rainbow: "🌈",
+    // Arrows
+    arrow_right: "➡️", arrow_left: "⬅️", arrow_up: "⬆️", arrow_down: "⬇️",
+    // Tech
+    computer: "💻", iphone: "📱", email: "📧", globe: "🌐",
+    // Misc
+    eyes: "👀", memo: "📝", books: "📚", package: "📦",
+    tada: "🎉", trophy: "🏆", medal: "🏅", crown: "👑",
+    image: "🖼️",
+};
+export class IconRegistry {
+    resolvers = new Map();
+    emojiMap = new Map(Object.entries(EMOJI_MAP));
+    iconifyCache = new Map();
+    /**
+     * Register a custom icon resolver for a library.
+     */
+    register(library, resolver) {
+        this.resolvers.set(library, resolver);
+    }
+    /**
+     * Register custom emoji shortcodes.
+     */
+    registerEmoji(map) {
+        for (const [k, v] of Object.entries(map)) {
+            this.emojiMap.set(k, v);
+        }
+    }
+    /**
+     * Resolve a shortcode to an SVG string or Unicode emoji.
+     * Returns null if the icon is not found.
+     */
+    resolve(library, name, variant, size) {
+        // Emoji shortcodes → Unicode character
+        if (library === "emoji") {
+            return this.emojiMap.get(name) || null;
+        }
+        // Check custom resolvers first
+        const customResolver = this.resolvers.get(library);
+        if (customResolver) {
+            return customResolver.resolve(name, variant, size);
+        }
+        // Fall back to @iconify/json
+        return this.resolveIconify(library, name, variant, size);
+    }
+    /**
+     * Resolve via @iconify/json icon data.
+     */
+    resolveIconify(library, name, variant, _size) {
+        const prefix = this.getIconifyPrefix(library, variant);
+        if (!prefix)
+            return null;
+        const icons = this.loadIconifySet(prefix);
+        if (!icons)
+            return null;
+        // Direct lookup
+        let svg = icons[name];
+        if (svg)
+            return svg;
+        // Octicons: iconify includes the size suffix in the name (e.g. "heart-fill-24")
+        if (library === "octicons" && _size) {
+            svg = icons[`${name}-${_size}`];
+            if (svg)
+                return svg;
+        }
+        // Try with common default sizes
+        if (library === "octicons") {
+            svg = icons[`${name}-16`] || icons[`${name}-24`];
+            if (svg)
+                return svg;
+        }
+        return null;
+    }
+    /**
+     * Map our library/variant to @iconify/json prefix.
+     */
+    getIconifyPrefix(library, variant) {
+        switch (library) {
+            case "material": return "mdi";
+            case "fontawesome":
+                switch (variant) {
+                    case "brands": return "fa6-brands";
+                    case "regular": return "fa6-regular";
+                    case "solid":
+                    default: return "fa6-solid";
+                }
+            case "octicons": return "octicon";
+            case "simple": return "simple-icons";
+            default: return null;
+        }
+    }
+    /**
+     * Load and cache an @iconify/json icon set.
+     * Returns a map of icon name → SVG body string.
+     */
+    loadIconifySet(prefix) {
+        if (this.iconifyCache.has(prefix)) {
+            return this.iconifyCache.get(prefix);
+        }
+        try {
+            // Dynamic require to load icon data
+            const { icons, width, height } = require(`@iconify/json/json/${prefix}.json`);
+            const w = width || 24;
+            const h = height || 24;
+            const result = {};
+            for (const [iconName, iconData] of Object.entries(icons)) {
+                const data = iconData;
+                const iw = data.width || w;
+                const ih = data.height || h;
+                result[iconName] = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${iw} ${ih}" width="1em" height="1em" fill="currentColor">${data.body}</svg>`;
+            }
+            this.iconifyCache.set(prefix, result);
+            return result;
+        }
+        catch {
+            this.iconifyCache.set(prefix, {});
+            return null;
+        }
+    }
+}
+/**
+ * Create a pre-configured registry with all built-in icon libraries.
+ */
+export function createIconRegistry() {
+    return new IconRegistry();
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@dogsbay/icons",
+  "version": "0.2.0-beta.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./registry": "./dist/registry.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@iconify/json": "^2.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogsbay/dogsbay.git",
+    "directory": "packages/icons"
+  },
+  "homepage": "https://github.com/dogsbay/dogsbay/tree/main/packages/icons",
+  "bugs": {
+    "url": "https://github.com/dogsbay/dogsbay/issues"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}