@dogsbay/icons 0.2.0-beta.4 → 0.2.0-beta.40

package/dist/index.d.ts

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

package/dist/index.js

@@ -1 +1,2 @@
 export { IconRegistry, createIconRegistry } from "./registry.js";
+export { resolveIcon, defaultRegistry } from "./resolve.js";

package/dist/registry.js

@@ -118,6 +118,10 @@ export class IconRegistry {
                 }
             case "octicons": return "octicon";
             case "simple": return "simple-icons";
+            // Lucide is the platform default — used for `{icon=...}` props
+            // on cards, the inline `icon` TreeNode, and any `name="rocket"`
+            // (no namespace prefix) call. Iconify prefix is "lucide".
+            case "lucide": return "lucide";
             default: return null;
         }
     }

package/dist/resolve.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Convenience resolver for the platform-wide icon shorthand.
+ *
+ * Components and serializers across the platform use a single
+ * shorthand for icon names — `{icon="rocket"}` on cards, the
+ * inline `:icon[rocket]` directive, etc. This module gives them
+ * one entry point that:
+ *
+ *   - Defaults to Lucide when no `pack:` prefix is supplied
+ *     (so `rocket` → `lucide:rocket`).
+ *   - Accepts the `pack:name` shape (`mdi:home`,
+ *     `simple-icons:github`, `lucide:book-open`) and routes to
+ *     the right Iconify set.
+ *   - Returns `null` when the icon doesn't exist — callers
+ *     decide whether to fall back to text or omit the slot.
+ *
+ * Built on top of the IconRegistry so emoji shortcodes (`rocket`,
+ * `tada`, etc.) and custom resolvers still work alongside the
+ * Iconify lookup. The default precedence: emoji map → custom
+ * resolver → Iconify pack.
+ */
+import { IconRegistry } from "./registry.js";
+export declare function defaultRegistry(): IconRegistry;
+/**
+ * Resolve a platform icon shorthand to an SVG string (or
+ * Unicode emoji, when the shorthand matches an emoji entry).
+ *
+ * Examples:
+ *   - resolveIcon("rocket")              → emoji 🚀 (emoji map wins)
+ *   - resolveIcon("lucide:rocket")       → Lucide rocket SVG
+ *   - resolveIcon("book-open")           → Lucide book-open SVG (no emoji entry)
+ *   - resolveIcon("mdi:home")            → Material Design Icons home SVG
+ *   - resolveIcon("simple-icons:github") → simple-icons GitHub SVG
+ *   - resolveIcon("nonexistent")         → null
+ *
+ * @param shorthand   The icon name. Either bare (`rocket`) or
+ *                    namespaced (`pack:name`).
+ * @param registry    Optional registry override. Defaults to the
+ *                    process-wide shared instance.
+ */
+export declare function resolveIcon(shorthand: string, registry?: IconRegistry): string | null;

package/dist/resolve.js

@@ -0,0 +1,71 @@
+/**
+ * Convenience resolver for the platform-wide icon shorthand.
+ *
+ * Components and serializers across the platform use a single
+ * shorthand for icon names — `{icon="rocket"}` on cards, the
+ * inline `:icon[rocket]` directive, etc. This module gives them
+ * one entry point that:
+ *
+ *   - Defaults to Lucide when no `pack:` prefix is supplied
+ *     (so `rocket` → `lucide:rocket`).
+ *   - Accepts the `pack:name` shape (`mdi:home`,
+ *     `simple-icons:github`, `lucide:book-open`) and routes to
+ *     the right Iconify set.
+ *   - Returns `null` when the icon doesn't exist — callers
+ *     decide whether to fall back to text or omit the slot.
+ *
+ * Built on top of the IconRegistry so emoji shortcodes (`rocket`,
+ * `tada`, etc.) and custom resolvers still work alongside the
+ * Iconify lookup. The default precedence: emoji map → custom
+ * resolver → Iconify pack.
+ */
+import { createIconRegistry } from "./registry.js";
+/**
+ * Lazily-instantiated registry shared by every consumer that
+ * doesn't bring its own. The first `resolveIcon` call constructs
+ * it; subsequent calls reuse the cached Iconify packs inside.
+ */
+let _defaultRegistry = null;
+export function defaultRegistry() {
+    if (_defaultRegistry === null) {
+        _defaultRegistry = createIconRegistry();
+    }
+    return _defaultRegistry;
+}
+/**
+ * Resolve a platform icon shorthand to an SVG string (or
+ * Unicode emoji, when the shorthand matches an emoji entry).
+ *
+ * Examples:
+ *   - resolveIcon("rocket")              → emoji 🚀 (emoji map wins)
+ *   - resolveIcon("lucide:rocket")       → Lucide rocket SVG
+ *   - resolveIcon("book-open")           → Lucide book-open SVG (no emoji entry)
+ *   - resolveIcon("mdi:home")            → Material Design Icons home SVG
+ *   - resolveIcon("simple-icons:github") → simple-icons GitHub SVG
+ *   - resolveIcon("nonexistent")         → null
+ *
+ * @param shorthand   The icon name. Either bare (`rocket`) or
+ *                    namespaced (`pack:name`).
+ * @param registry    Optional registry override. Defaults to the
+ *                    process-wide shared instance.
+ */
+export function resolveIcon(shorthand, registry) {
+    const reg = registry ?? defaultRegistry();
+    const trimmed = shorthand.trim();
+    if (trimmed.length === 0)
+        return null;
+    const colonIdx = trimmed.indexOf(":");
+    if (colonIdx > 0) {
+        const pack = trimmed.slice(0, colonIdx);
+        const name = trimmed.slice(colonIdx + 1);
+        return reg.resolve(pack, name);
+    }
+    // Bare name. Try the emoji map first (so `rocket` → 🚀
+    // matches existing behaviour). Fall through to Lucide so SVG
+    // names without an emoji equivalent (`book-open`, `settings`)
+    // still resolve.
+    const emoji = reg.resolve("emoji", trimmed);
+    if (emoji !== null)
+        return emoji;
+    return reg.resolve("lucide", trimmed);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/icons",
-  "version": "0.2.0-beta.4",
+  "version": "0.2.0-beta.40",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",