@pantoken/rust 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @pantoken/rust
+
+Emit Instructure design tokens as Rust constants for the two mainstream native Rust GUIs. Colours
+become the framework's colour type; dimensions become `f32` (px). Icons and non-colour/dimension
+tokens are skipped.
+
+| Format | Type      | Framework                             |
+| ------ | --------- | ------------------------------------- |
+| `egui` | `Color32` | [egui](https://github.com/emilk/egui) |
+| `iced` | `Color`   | [iced](https://iced.rs)               |
+
+## Install
+
+```sh
+npm i @pantoken/rust
+```
+
+## Usage
+
+```ts
+import { writeFileSync } from "node:fs";
+import { generateRust } from "@pantoken/rust";
+
+writeFileSync("tokens.rs", generateRust({ format: "egui", theme: "rebrand" }));
+```
+
+Or via the CLI:
+
+```sh
+pantoken generate rust --format egui --out tokens.rs
+pantoken generate rust --format iced --out src/tokens.rs
+```
+
+## Output
+
+A single Rust module of `pub const`s — one per colour and dimension token, `SCREAMING_SNAKE_CASE`,
+prefixed with `use egui::Color32;` or `use iced::Color;` to match the chosen format. Web-rendered
+Rust UIs (Tauri, Dioxus-web, Leptos, Yew) render to HTML/CSS — use `@pantoken/css` there, not this
+package.
+
+## API
+
+- **`generateRust(options?): string`** — emit Rust for a named theme (from the vendored
+  `@pantoken/tokens` IR). Returns the source string.
+- **`toRust(tokens, options?): string`** — same, but for an explicit token IR.
+- **`RustFormat`** — `"egui" | "iced"`.
+- **`RustOptions`** — the `format` and `mode` options (`generateRust` also takes `theme`).
+
+## Related
+
+- Uses `@pantoken/tokens` for the vendored token IR and `@pantoken/core` for the flattened Style
+  Dictionary values.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,55 @@
+import { Mode } from "@pantoken/core";
+import { Theme, Token } from "@pantoken/model";
+
+//#region src/index.d.ts
+/** The Rust GUI framework to target. */
+type RustFormat = "egui" | "iced";
+/** Options for {@link toRust} / {@link generateRust}. */
+interface RustOptions {
+  /** The Rust GUI to target (default `"egui"`). */
+  format?: RustFormat;
+  /** Which `light-dark()` mode to resolve (default `"light"`). */
+  mode?: Mode;
+}
+/**
+ * Emit Rust constants for an explicit token IR.
+ *
+ * @param tokens - The IR.
+ * @param options - {@link RustOptions}.
+ * @returns The Rust source (a module of `pub const`s).
+ *
+ * @example egui (Color32), the default format
+ * ```ts
+ * import { toRust } from "@pantoken/rust";
+ * import { byTheme } from "@pantoken/tokens";
+ *
+ * const source = toRust(byTheme("rebrand"));
+ * // "use egui::Color32;\npub const COLOR_BACKGROUND_BRAND: Color32 = Color32::from_rgb(…);"
+ * ```
+ *
+ * @example iced (Color), dark mode
+ * ```ts
+ * import { toRust } from "@pantoken/rust";
+ * import { byTheme } from "@pantoken/tokens";
+ *
+ * const source = toRust(byTheme("rebrand"), { format: "iced", mode: "dark" });
+ * // "use iced::Color;\npub const COLOR_BACKGROUND_BRAND: Color = Color { r: …, g: …, b: …, a: … };"
+ * ```
+ */
+declare function toRust(tokens: readonly Token[], options?: RustOptions): string;
+/**
+ * Emit Rust constants for a named theme (using the vendored `@pantoken/tokens` IR).
+ *
+ * @example
+ * ```ts
+ * import { writeFileSync } from "node:fs";
+ * import { generateRust } from "@pantoken/rust";
+ *
+ * writeFileSync("tokens.rs", generateRust({ format: "egui", theme: "rebrand" }));
+ * ```
+ */
+declare function generateRust(options?: RustOptions & {
+  theme?: Theme;
+}): string;
+//#endregion
+export { RustFormat, RustOptions, generateRust as default, generateRust, toRust };

package/dist/index.mjs

@@ -0,0 +1,110 @@
+import { toStyleDictionary } from "@pantoken/core";
+import { byTheme } from "@pantoken/tokens";
+import { parseHexColor } from "@pantoken/utils";
+//#region src/index.ts
+/**
+* `@pantoken/rust` — emit Instructure design tokens as Rust constants for the two mainstream native
+* Rust GUIs: **egui** (`Color32`) and **iced** (`Color`). Colours become the framework's colour
+* type; dimensions become `f32` (px). Web-rendered Rust UIs (Tauri, Dioxus-web, Leptos, Yew) should
+* use `@pantoken/css` instead.
+*
+* @module
+* @experimental
+*/
+function hexToRgb(hex) {
+	const c = parseHexColor(hex);
+	return c ? {
+		r: c.r,
+		g: c.g,
+		b: c.b,
+		a: Math.round(c.a * 255)
+	} : void 0;
+}
+function constName(tokenName) {
+	return tokenName.replace(/^--instui-/, "").replace(/-/g, "_").toUpperCase();
+}
+function dimension(value) {
+	const m = /^(-?\d*\.?\d+)(px|rem|em)?$/.exec(value.trim());
+	if (!m) return void 0;
+	return Number(m[1]) * (m[2] === "rem" || m[2] === "em" ? 16 : 1);
+}
+/** Format a number as a Rust `f32` literal (always with a decimal, so `1` → `1.0`). */
+function f32lit(n) {
+	return Number.isInteger(n) ? `${n}.0` : `${n}`;
+}
+function colorLiteral(format, rgb) {
+	if (format === "egui") return {
+		ty: "Color32",
+		expr: rgb.a === 255 ? `Color32::from_rgb(${rgb.r}, ${rgb.g}, ${rgb.b})` : `Color32::from_rgba_unmultiplied(${rgb.r}, ${rgb.g}, ${rgb.b}, ${rgb.a})`
+	};
+	const c = (n) => f32lit(n / 255);
+	return {
+		ty: "Color",
+		expr: `Color { r: ${c(rgb.r)}, g: ${c(rgb.g)}, b: ${c(rgb.b)}, a: ${c(rgb.a)} }`
+	};
+}
+/**
+* Emit Rust constants for an explicit token IR.
+*
+* @param tokens - The IR.
+* @param options - {@link RustOptions}.
+* @returns The Rust source (a module of `pub const`s).
+*
+* @example egui (Color32), the default format
+* ```ts
+* import { toRust } from "@pantoken/rust";
+* import { byTheme } from "@pantoken/tokens";
+*
+* const source = toRust(byTheme("rebrand"));
+* // "use egui::Color32;\npub const COLOR_BACKGROUND_BRAND: Color32 = Color32::from_rgb(…);"
+* ```
+*
+* @example iced (Color), dark mode
+* ```ts
+* import { toRust } from "@pantoken/rust";
+* import { byTheme } from "@pantoken/tokens";
+*
+* const source = toRust(byTheme("rebrand"), { format: "iced", mode: "dark" });
+* // "use iced::Color;\npub const COLOR_BACKGROUND_BRAND: Color = Color { r: …, g: …, b: …, a: … };"
+* ```
+*/
+function toRust(tokens, options = {}) {
+	const format = options.format ?? "egui";
+	const dictionary = toStyleDictionary(tokens, options.mode ?? "light");
+	const lines = [
+		"// GENERATED by @pantoken/rust — do not edit by hand.",
+		"#![allow(dead_code)]",
+		format === "egui" ? "use egui::Color32;" : "use iced::Color;",
+		""
+	];
+	for (const [name, leaf] of Object.entries(dictionary)) {
+		const constant = constName(`--${name}`);
+		if (leaf.type === "color") {
+			const rgb = hexToRgb(leaf.value);
+			if (!rgb) continue;
+			const { ty, expr } = colorLiteral(format, rgb);
+			lines.push(`pub const ${constant}: ${ty} = ${expr};`);
+		} else if (leaf.type === "dimension" || leaf.type === "number") {
+			const n = dimension(leaf.value);
+			if (n === void 0) continue;
+			lines.push(`pub const ${constant}: f32 = ${f32lit(n)};`);
+		}
+	}
+	return `${lines.join("\n")}\n`;
+}
+/**
+* Emit Rust constants for a named theme (using the vendored `@pantoken/tokens` IR).
+*
+* @example
+* ```ts
+* import { writeFileSync } from "node:fs";
+* import { generateRust } from "@pantoken/rust";
+*
+* writeFileSync("tokens.rs", generateRust({ format: "egui", theme: "rebrand" }));
+* ```
+*/
+function generateRust(options = {}) {
+	return toRust(byTheme(options.theme ?? "rebrand"), options);
+}
+//#endregion
+export { generateRust as default, generateRust, toRust };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@pantoken/rust",
+  "version": "0.1.0",
+  "description": "Emit Instructure design tokens as Rust constants for egui (Color32) or iced (Color).",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pantoken/core": "0.1.0",
+    "@pantoken/model": "0.1.0",
+    "@pantoken/tokens": "0.1.0",
+    "@pantoken/utils": "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"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}