@pantoken/icons 0.1.9 → 0.2.1

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { IconResolver } from "@pantoken/model";
+import { IconResolver, PantokenPlugin } from "@pantoken/model";
 //#region src/index.d.ts
 /** A pantoken icon, derived from an `<image>` token. */
-interface PantokenIcon {
+export interface PantokenIcon {
   /** The icon name, without the `--instui-icon-` prefix (e.g. `arrow-left`). */
   name: string;
   /** The `url('data:image/svg+xml;utf8,…')` value, as stored in the IR. */
@@ -30,7 +30,7 @@ interface PantokenIcon {
  * icons.filter((i) => i.source === "lucide"); // just the Lucide glyphs
  * ```
  */
-declare const icons: PantokenIcon[];
+export declare const icons: PantokenIcon[];
 /**
  * Every pantoken icon, keyed by name.
  *
@@ -41,7 +41,7 @@ declare const icons: PantokenIcon[];
  * iconsByName.get("arrow-left")?.svg; // inline SVG markup
  * ```
  */
-declare const iconsByName: Map<string, PantokenIcon>;
+export declare const iconsByName: Map<string, PantokenIcon>;
 /**
  * Look up an icon by name.
  *
@@ -53,7 +53,7 @@ declare const iconsByName: Map<string, PantokenIcon>;
  * icon?.viewBox; // "0 0 24 24"
  * ```
  */
-declare function getIcon(name: string): PantokenIcon | undefined;
+export declare function getIcon(name: string): PantokenIcon | undefined;
 /**
  * An {@link IconResolver} backed by the pantoken icon set (for the plugin/rehype stages).
  *
@@ -64,6 +64,26 @@ declare function getIcon(name: string): PantokenIcon | undefined;
  * resolve("arrow-left"); // { name, svg, viewBox, source } | undefined
  * ```
  */
-declare const resolve: IconResolver;
-//#endregion
-export { PantokenIcon, getIcon, icons, iconsByName, resolve };
+export declare const resolve: IconResolver;
+/** Options shared by the icon-resolving renderers ({@link buildIconResolverChain}). */
+export interface IconResolverChainOptions {
+  /** An explicit resolver, tried before the built-in pantoken icon set. */
+  resolve?: IconResolver;
+  /** Plugins whose `rehype` hooks contribute resolvers (tried first). */
+  plugins?: readonly PantokenPlugin[];
+}
+/**
+ * Build the shared icon-resolver chain: plugin `rehype` resolvers first, then an explicit
+ * `resolve`, then the built-in pantoken icon set. Used by `@pantoken/rehype` and
+ * `@pantoken/markdown-it` so the resolution order stays identical across renderers.
+ *
+ * @example
+ * ```ts
+ * import { buildIconResolverChain } from "@pantoken/icons";
+ *
+ * const resolveIcon = buildIconResolverChain({ plugins: [myBrandIconsPlugin] });
+ * resolveIcon("arrow-left"); // { name, svg, viewBox, source } | undefined
+ * ```
+ */
+export declare function buildIconResolverChain(options: IconResolverChainOptions): IconResolver;
+//#endregion

package/dist/index.mjs

@@ -84,5 +84,33 @@ const resolve = (code) => {
 		source: icon.source
 	} : void 0;
 };
+/**
+* Build the shared icon-resolver chain: plugin `rehype` resolvers first, then an explicit
+* `resolve`, then the built-in pantoken icon set. Used by `@pantoken/rehype` and
+* `@pantoken/markdown-it` so the resolution order stays identical across renderers.
+*
+* @example
+* ```ts
+* import { buildIconResolverChain } from "@pantoken/icons";
+*
+* const resolveIcon = buildIconResolverChain({ plugins: [myBrandIconsPlugin] });
+* resolveIcon("arrow-left"); // { name, svg, viewBox, source } | undefined
+* ```
+*/
+function buildIconResolverChain(options) {
+	const resolvers = [];
+	for (const plugin of options.plugins ?? []) {
+		const contributed = plugin.rehype?.({ resolve });
+		if (contributed?.resolve) resolvers.push(contributed.resolve);
+	}
+	if (options.resolve) resolvers.push(options.resolve);
+	resolvers.push(resolve);
+	return (code) => {
+		for (const resolver of resolvers) {
+			const hit = resolver(code);
+			if (hit) return hit;
+		}
+	};
+}
 //#endregion
-export { getIcon, icons, iconsByName, resolve };
+export { buildIconResolverChain, getIcon, icons, iconsByName, resolve };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@pantoken/icons",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "An ergonomic view over the pantoken IR's <image> tokens: decoded SVGs and per-icon metadata.",
-  "homepage": "https://pantoken.iywahl.com",
+  "homepage": "https://pantoken.app",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
   "license": "MIT",
   "repository": {
@@ -24,15 +24,15 @@
     "provenance": true
   },
   "dependencies": {
-    "@pantoken/model": "0.3.0",
-    "@pantoken/tokens": "0.2.4",
-    "@pantoken/utils": "1.0.0"
+    "@pantoken/model": "0.3.2",
+    "@pantoken/tokens": "0.3.1",
+    "@pantoken/utils": "1.0.2"
   },
   "devDependencies": {
-    "@types/node": "^24.13.3",
+    "@types/node": "^26.5.0",
     "typescript": "^7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.9",
-    "vite-plus": "0.2.9"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
+    "vite-plus": "0.3.1"
   },
   "engines": {
     "node": ">=22.18.0"