@pantoken/icons 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @pantoken/icons
+
+An ergonomic view over the pantoken IR's `<image>` tokens. It filters the canonical IR from
+`@pantoken/tokens` to the icon tokens and decodes each data-URI back to inline SVG — it's not a
+second source of truth.
+
+## Install
+
+```sh
+npm i @pantoken/icons
+```
+
+Also available as `pantoken/icons`.
+
+## Usage
+
+```ts
+import { icons, getIcon, resolve } from "@pantoken/icons";
+
+getIcon("arrow-left"); // { name, dataUri, svg, viewBox, bidirectional, source }
+icons.length; // the full set
+
+resolve("arrow-left"); // IconResolver — for the plugin / rehype stages
+```
+
+Each icon carries `bidirectional` (RTL flipping) and `source` (`custom` or `lucide`) metadata,
+plus the decoded `svg` and the original `dataUri`.
+
+## API
+
+- **`icons: PantokenIcon[]`** — every pantoken icon, sorted by name.
+- **`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
+  stages.
+- **`PantokenIcon`** — a decoded icon: `name`, `dataUri`, `svg`, `viewBox`, `bidirectional`, and
+  `source`.
+
+## Related
+
+- Reads the IR from `@pantoken/tokens`.
+- For an installable font of the same glyphs, see `@pantoken/icon-font`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,66 @@
+import { IconResolver } from "@pantoken/model";
+
+//#region src/index.d.ts
+/** A pantoken icon, derived from an `<image>` token. */
+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. */
+  dataUri: string;
+  /** The decoded inline SVG markup. */
+  svg: string;
+  /** The SVG `viewBox`, when known. */
+  viewBox?: string;
+  /** Whether the icon flips horizontally in right-to-left contexts. */
+  bidirectional: boolean;
+  /** The glyph origin. */
+  source?: "custom" | "lucide";
+}
+/**
+ * Every pantoken icon, sorted by name.
+ *
+ * @example
+ * ```ts
+ * import { icons } from "@pantoken/icons";
+ *
+ * icons.length; // the full set
+ * icons.filter((i) => i.source === "lucide"); // just the Lucide glyphs
+ * ```
+ */
+declare const icons: PantokenIcon[];
+/**
+ * Every pantoken icon, keyed by name.
+ *
+ * @example
+ * ```ts
+ * import { iconsByName } from "@pantoken/icons";
+ *
+ * iconsByName.get("arrow-left")?.svg; // inline SVG markup
+ * ```
+ */
+declare const iconsByName: Map<string, PantokenIcon>;
+/**
+ * Look up an icon by name.
+ *
+ * @example
+ * ```ts
+ * import { getIcon } from "@pantoken/icons";
+ *
+ * const icon = getIcon("arrow-left");
+ * icon?.viewBox; // "0 0 24 24"
+ * ```
+ */
+declare function getIcon(name: string): PantokenIcon | undefined;
+/**
+ * An {@link IconResolver} backed by the pantoken icon set (for the plugin/rehype stages).
+ *
+ * @example
+ * ```ts
+ * import { resolve } from "@pantoken/icons";
+ *
+ * resolve("arrow-left"); // { name, svg, viewBox, source } | undefined
+ * ```
+ */
+declare const resolve: IconResolver;
+//#endregion
+export { PantokenIcon, getIcon, icons, iconsByName, resolve };

package/dist/index.mjs

@@ -0,0 +1,87 @@
+import { tokens } from "@pantoken/tokens";
+//#region src/index.ts
+/**
+* `@pantoken/icons` — an ergonomic view over the IR's `<image>` tokens.
+*
+* This is not a second source; it filters the canonical IR from `@pantoken/tokens` to the icon
+* tokens and decodes each data-URI back to inline SVG, exposing a shape close to the
+* `SimpleIconTokenData` that markdown/rehype consumers already use.
+*
+* @module
+* @beta
+*/
+const DATA_PREFIX = "data:image/svg+xml;utf8,";
+function decode(dataUri) {
+	const inner = /^url\(\s*'?(.*?)'?\s*\)$/.exec(dataUri.trim())?.[1] ?? dataUri;
+	if (!inner.startsWith(DATA_PREFIX)) return "";
+	try {
+		return decodeURIComponent(inner.slice(24));
+	} catch {
+		return "";
+	}
+}
+/**
+* Every pantoken icon, sorted by name.
+*
+* @example
+* ```ts
+* import { icons } from "@pantoken/icons";
+*
+* icons.length; // the full set
+* icons.filter((i) => i.source === "lucide"); // just the Lucide glyphs
+* ```
+*/
+const icons = tokens.filter((t) => t.meta?.kind === "icon").map((t) => ({
+	name: t.name.slice(14),
+	dataUri: t.value,
+	svg: decode(t.value),
+	viewBox: t.meta?.viewBox,
+	bidirectional: Boolean(t.meta?.bidirectional),
+	source: t.meta?.source
+}));
+/**
+* Every pantoken icon, keyed by name.
+*
+* @example
+* ```ts
+* import { iconsByName } from "@pantoken/icons";
+*
+* iconsByName.get("arrow-left")?.svg; // inline SVG markup
+* ```
+*/
+const iconsByName = new Map(icons.map((i) => [i.name, i]));
+/**
+* Look up an icon by name.
+*
+* @example
+* ```ts
+* import { getIcon } from "@pantoken/icons";
+*
+* const icon = getIcon("arrow-left");
+* icon?.viewBox; // "0 0 24 24"
+* ```
+*/
+function getIcon(name) {
+	return iconsByName.get(name);
+}
+/**
+* An {@link IconResolver} backed by the pantoken icon set (for the plugin/rehype stages).
+*
+* @example
+* ```ts
+* import { resolve } from "@pantoken/icons";
+*
+* resolve("arrow-left"); // { name, svg, viewBox, source } | undefined
+* ```
+*/
+const resolve = (code) => {
+	const icon = iconsByName.get(code);
+	return icon ? {
+		name: icon.name,
+		svg: icon.svg,
+		viewBox: icon.viewBox,
+		source: icon.source
+	} : void 0;
+};
+//#endregion
+export { getIcon, icons, iconsByName, resolve };

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@pantoken/icons",
+  "version": "0.1.0",
+  "description": "An ergonomic view over the pantoken IR's <image> tokens: decoded SVGs and per-icon metadata.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pantoken/model": "0.1.0",
+    "@pantoken/tokens": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^6.0.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.4",
+    "vite-plus": "0.2.4"
+  },
+  "pantoken": {
+    "key": "icons",
+    "kind": "namespace"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}