@pantoken/icons 0.2.4 → 0.3.0

package/README.md

@@ -15,10 +15,12 @@ Also available as `pantoken/icons`.
 ## Usage
 
 ```ts
-import { icons, getIcon, resolve } from "@pantoken/icons";
+import { customIcons, getIcon, icons, lucideIcons, resolve } from "@pantoken/icons";
 
 getIcon("arrow-left"); // { name, dataUri, svg, viewBox, bidirectional, source }
 icons.length; // the full set
+lucideIcons.length; // canonical Lucide icons
+customIcons.length; // Instructure-authored icons
 
 resolve("arrow-left"); // IconResolver — for the plugin / rehype stages
 ```
@@ -29,6 +31,8 @@ plus the decoded `svg` and the original `dataUri`.
 ## API
 
 - **`icons: PantokenIcon[]`** — every pantoken icon, sorted by name.
+- **`lucideIcons: PantokenIcon[]`** — canonical Lucide icons.
+- **`customIcons: PantokenIcon[]`** — Instructure-authored custom icons.
 - **`iconsByName: Map<string, PantokenIcon>`** — every icon, keyed by name.
 - **`getIcon(name): PantokenIcon | undefined`** — look up one icon by name.
 - **`resolve: IconResolver`** — an `IconResolver` backed by the icon set, for the plugin and rehype

package/dist/index.d.mts

@@ -31,6 +31,10 @@ export interface PantokenIcon {
  * ```
  */
 export declare const icons: PantokenIcon[];
+/** Every canonical Lucide icon. */
+export declare const lucideIcons: PantokenIcon[];
+/** Every Instructure-authored custom icon. */
+export declare const customIcons: PantokenIcon[];
 /**
  * Every pantoken icon, keyed by name.
  *
@@ -69,12 +73,13 @@ export declare const resolve: IconResolver;
 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 whose `rehype` hooks contribute resolvers (tried last, after the built-in set). */
   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
+ * Build the shared icon-resolver chain: an explicit `resolve` first, then the built-in pantoken
+ * icon set, then plugin `rehype` resolvers (so a plugin can add codes the built-in set doesn't
+ * know, but never shadow a built-in icon name). Used by `@pantoken/rehype` and
  * `@pantoken/markdown-it` so the resolution order stays identical across renderers.
  *
  * @example

package/dist/index.mjs

@@ -40,6 +40,10 @@ const icons = tokens.filter((t) => t.meta?.kind === "icon").map((t) => ({
 	bidirectional: Boolean(t.meta?.bidirectional),
 	source: t.meta?.source
 }));
+/** Every canonical Lucide icon. */
+const lucideIcons = icons.filter((icon) => icon.source === "lucide");
+/** Every Instructure-authored custom icon. */
+const customIcons = icons.filter((icon) => icon.source === "custom");
 /**
 * Every pantoken icon, keyed by name.
 *
@@ -85,8 +89,9 @@ const resolve = (code) => {
 	} : 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
+* Build the shared icon-resolver chain: an explicit `resolve` first, then the built-in pantoken
+* icon set, then plugin `rehype` resolvers (so a plugin can add codes the built-in set doesn't
+* know, but never shadow a built-in icon name). Used by `@pantoken/rehype` and
 * `@pantoken/markdown-it` so the resolution order stays identical across renderers.
 *
 * @example
@@ -99,12 +104,12 @@ const resolve = (code) => {
 */
 function buildIconResolverChain(options) {
 	const resolvers = [];
+	if (options.resolve) resolvers.push(options.resolve);
+	resolvers.push(resolve);
 	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);
@@ -113,4 +118,4 @@ function buildIconResolverChain(options) {
 	};
 }
 //#endregion
-export { buildIconResolverChain, getIcon, icons, iconsByName, resolve };
+export { buildIconResolverChain, customIcons, getIcon, icons, iconsByName, lucideIcons, resolve };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantoken/icons",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "An ergonomic view over the pantoken IR's <image> tokens: decoded SVGs and per-icon metadata.",
   "homepage": "https://pantoken.app",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
@@ -25,14 +25,14 @@
   },
   "dependencies": {
     "@pantoken/model": "0.4.0",
-    "@pantoken/tokens": "0.5.0",
-    "@pantoken/utils": "1.0.3"
+    "@pantoken/tokens": "0.6.0",
+    "@pantoken/utils": "1.1.0"
   },
   "devDependencies": {
-    "@types/node": "^26.5.1",
+    "@types/node": "^26.6.2",
     "typescript": "^7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.2",
-    "vite-plus": "0.3.2"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0-rc.0",
+    "vite-plus": "1.0.0-rc.0"
   },
   "engines": {
     "node": ">=22.18.0"