tauri-plugin-system-symbols 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 insd47
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# tauri-plugin-system-symbols
+
+Resolve platform system symbols into SVG path data from a Tauri app.
+
+This plugin is designed for apps that want native-looking symbols without
+bundling icon fonts or SVG assets.
+
+## Packages
+
+- Rust crate: [`tauri-plugin-system-symbols`](https://github.com/insd47/tauri-plugin-system-symbols)
+- JavaScript package: [`tauri-plugin-system-symbols`](https://github.com/insd47/tauri-plugin-system-symbols)
+- React package: [`tauri-plugin-system-symbols-react`](https://github.com/insd47/tauri-plugin-system-symbols-react)
+
+## Status
+
+- Windows: `Segoe Fluent Icons` is resolved first, with `Segoe MDL2 Assets` as the fallback.
+- macOS: `SF Symbols` command/API boundaries are in place, but vector extraction is still pending.
+- Other platforms: unsupported.
+
+Calling a platform-specific API on the wrong platform rejects with a Rust backend error.
+
+## Install
+
+Install the Rust plugin in your Tauri app:
+
+```toml
+# src-tauri/Cargo.toml
+[dependencies]
+tauri-plugin-system-symbols = "0.1"
+```
+
+Install the JavaScript package:
+
+```sh
+pnpm add tauri-plugin-system-symbols
+```
+
+Register the plugin:
+
+```rust
+tauri::Builder::default()
+    .plugin(tauri_plugin_system_symbols::init());
+```
+
+Add the default permission to your capability file:
+
+```json
+{
+  "permissions": ["system-symbols:default"]
+}
+```
+
+## JavaScript API
+
+```ts
+import {
+  getCachedFluentIcon,
+  getCachedSfSymbol,
+  getFluentIcon,
+  getSfSymbol,
+  preloadFluentIcons,
+  preloadSfSymbols,
+} from 'tauri-plugin-system-symbols'
+
+await preloadFluentIcons('\uE8BB', '\uE921')
+await preloadSfSymbols('square.and.arrow.up')
+
+const close = getCachedFluentIcon('\uE8BB') ?? await getFluentIcon('\uE8BB')
+const share = getCachedSfSymbol('square.and.arrow.up') ?? await getSfSymbol('square.and.arrow.up')
+```
+
+Tauri IPC is asynchronous, so first-time symbol resolution returns a `Promise<Symbol>`.
+Use `preloadFluentIcons(...icons)` and `preloadSfSymbols(...symbols)` to warm the cache before rendering.
+
+## Types
+
+```ts
+interface Symbol {
+  viewBox: string
+  paths: Path[]
+}
+
+interface Path {
+  d: string
+  fillRule?: 'nonzero' | 'evenodd'
+  opacity?: number
+}
+```
+
+## React
+
+React components are provided by
+[`tauri-plugin-system-symbols-react`](https://github.com/insd47/tauri-plugin-system-symbols-react).
+
+```sh
+pnpm add tauri-plugin-system-symbols-react @tauri-apps/plugin-os
+```
+
+## Development
+
+```sh
+pnpm install
+pnpm run check
+pnpm run build
+cargo check
+cargo test
+```
+
+## License
+
+MIT

package/dist-js/api.d.ts

@@ -0,0 +1,58 @@
+import type { FluentIconOptions, SfSymbolOptions, SvgSymbol } from './types';
+/**
+ * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.
+ *
+ * `Segoe Fluent Icons` is preferred by the Rust backend, with
+ * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows
+ * platform rejects with the backend platform error.
+ *
+ * @param icon Glyph text or codepoint, for example `"\uE8BB"` or `"U+E8BB"`.
+ * @param options Reserved for future Fluent icon rendering options.
+ * @returns SVG path data and viewBox metadata for the icon.
+ */
+export declare function getFluentIcon(icon: string, options?: FluentIconOptions): Promise<SvgSymbol>;
+/**
+ * Returns a previously resolved Windows Fluent icon without starting IPC.
+ *
+ * @param icon Glyph text or codepoint used to resolve the icon.
+ * @param options Options used when the icon was resolved.
+ * @returns Cached SVG data, or `undefined` when the icon has not been loaded.
+ */
+export declare function getCachedFluentIcon(icon: string, options?: FluentIconOptions): SvgSymbol | undefined;
+/**
+ * Preloads Windows Fluent icons in one backend request.
+ *
+ * @param icons Glyph texts or codepoints to preload.
+ */
+export declare function preloadFluentIcons(...icons: string[]): Promise<void>;
+/**
+ * Resolves a macOS SF Symbol name to SVG path data.
+ *
+ * Calling this on a non-macOS platform rejects with the backend platform error.
+ *
+ * @param symbol SF Symbols name, for example `"square.and.arrow.up"`.
+ * @param options Reserved for future SF Symbols rendering options.
+ * @returns SVG path data and viewBox metadata for the symbol.
+ */
+export declare function getSfSymbol(symbol: string, options?: SfSymbolOptions): Promise<SvgSymbol>;
+/**
+ * Returns a previously resolved SF Symbol without starting IPC.
+ *
+ * @param symbol SF Symbols name used to resolve the symbol.
+ * @param options Options used when the symbol was resolved.
+ * @returns Cached SVG data, or `undefined` when the symbol has not been loaded.
+ */
+export declare function getCachedSfSymbol(symbol: string, options?: SfSymbolOptions): SvgSymbol | undefined;
+/**
+ * Preloads macOS SF Symbols in one backend request.
+ *
+ * @param symbols SF Symbols names to preload.
+ */
+export declare function preloadSfSymbols(...symbols: string[]): Promise<void>;
+/**
+ * Clears the in-memory JavaScript symbol cache.
+ *
+ * This only affects frontend-side caching. The Rust backend keeps its own
+ * process-local cache.
+ */
+export declare function clearSymbolCache(): void;

package/dist-js/api.js

@@ -0,0 +1,102 @@
+import { clear, get, load, save } from './cache.js';
+import { fluent as fluent$1, sf as sf$1 } from './commands.js';
+import { fluent, sf } from './key.js';
+import { assert, unique } from './text.js';
+
+/**
+ * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.
+ *
+ * `Segoe Fluent Icons` is preferred by the Rust backend, with
+ * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows
+ * platform rejects with the backend platform error.
+ *
+ * @param icon Glyph text or codepoint, for example `"\uE8BB"` or `"U+E8BB"`.
+ * @param options Reserved for future Fluent icon rendering options.
+ * @returns SVG path data and viewBox metadata for the icon.
+ */
+function getFluentIcon(icon, options) {
+    assert(icon, 'icon');
+    return load(fluent(icon, options), async () => {
+        const [symbol] = await fluent$1([icon], options);
+        return symbol;
+    });
+}
+/**
+ * Returns a previously resolved Windows Fluent icon without starting IPC.
+ *
+ * @param icon Glyph text or codepoint used to resolve the icon.
+ * @param options Options used when the icon was resolved.
+ * @returns Cached SVG data, or `undefined` when the icon has not been loaded.
+ */
+function getCachedFluentIcon(icon, options) {
+    assert(icon, 'icon');
+    return get(fluent(icon, options));
+}
+/**
+ * Preloads Windows Fluent icons in one backend request.
+ *
+ * @param icons Glyph texts or codepoints to preload.
+ */
+async function preloadFluentIcons(...icons) {
+    const unique$1 = unique(icons);
+    unique$1.forEach((icon) => assert(icon, 'icon'));
+    const missing = unique$1.filter((icon) => !get(fluent(icon)));
+    if (missing.length === 0) {
+        return;
+    }
+    const symbols = await fluent$1(missing);
+    save(symbols, missing.map((icon) => fluent(icon)));
+}
+/**
+ * Resolves a macOS SF Symbol name to SVG path data.
+ *
+ * Calling this on a non-macOS platform rejects with the backend platform error.
+ *
+ * @param symbol SF Symbols name, for example `"square.and.arrow.up"`.
+ * @param options Reserved for future SF Symbols rendering options.
+ * @returns SVG path data and viewBox metadata for the symbol.
+ */
+function getSfSymbol(symbol, options) {
+    assert(symbol, 'symbol');
+    return load(sf(symbol, options), async () => {
+        const [icon] = await sf$1([symbol], options);
+        return icon;
+    });
+}
+/**
+ * Returns a previously resolved SF Symbol without starting IPC.
+ *
+ * @param symbol SF Symbols name used to resolve the symbol.
+ * @param options Options used when the symbol was resolved.
+ * @returns Cached SVG data, or `undefined` when the symbol has not been loaded.
+ */
+function getCachedSfSymbol(symbol, options) {
+    assert(symbol, 'symbol');
+    return get(sf(symbol, options));
+}
+/**
+ * Preloads macOS SF Symbols in one backend request.
+ *
+ * @param symbols SF Symbols names to preload.
+ */
+async function preloadSfSymbols(...symbols) {
+    const unique$1 = unique(symbols);
+    unique$1.forEach((symbol) => assert(symbol, 'symbol'));
+    const missing = unique$1.filter((symbol) => !get(sf(symbol)));
+    if (missing.length === 0) {
+        return;
+    }
+    const icons = await sf$1(missing);
+    save(icons, missing.map((symbol) => sf(symbol)));
+}
+/**
+ * Clears the in-memory JavaScript symbol cache.
+ *
+ * This only affects frontend-side caching. The Rust backend keeps its own
+ * process-local cache.
+ */
+function clearSymbolCache() {
+    clear();
+}
+
+export { clearSymbolCache, getCachedFluentIcon, getCachedSfSymbol, getFluentIcon, getSfSymbol, preloadFluentIcons, preloadSfSymbols };

package/dist-js/cache.d.ts

@@ -0,0 +1,5 @@
+import type { Symbol } from './types';
+export declare function get(key: string): Symbol | undefined;
+export declare function load(key: string, create: () => Promise<Symbol>): Promise<Symbol>;
+export declare function save(symbols: Symbol[], keys: string[]): void;
+export declare function clear(): void;

package/dist-js/cache.js

@@ -0,0 +1,36 @@
+const resolved = new Map();
+const pending = new Map();
+function get(key) {
+    return resolved.get(key);
+}
+function load(key, create) {
+    const cached = resolved.get(key);
+    if (cached) {
+        return Promise.resolve(cached);
+    }
+    const inflight = pending.get(key);
+    if (inflight) {
+        return inflight;
+    }
+    const request = create().then((symbol) => {
+        pending.delete(key);
+        resolved.set(key, symbol);
+        return symbol;
+    }, (error) => {
+        pending.delete(key);
+        throw error;
+    });
+    pending.set(key, request);
+    return request;
+}
+function save(symbols, keys) {
+    symbols.forEach((symbol, index) => {
+        resolved.set(keys[index], symbol);
+    });
+}
+function clear() {
+    resolved.clear();
+    pending.clear();
+}
+
+export { clear, get, load, save };

package/dist-js/commands.d.ts

@@ -0,0 +1,3 @@
+import type { Symbol } from './types';
+export declare function fluent(icons: string[]): Promise<Symbol[]>;
+export declare function sf(symbols: string[]): Promise<Symbol[]>;

package/dist-js/commands.js

@@ -0,0 +1,15 @@
+import { invoke } from '@tauri-apps/api/core';
+
+const COMMAND_PREFIX = 'plugin:system-symbols|';
+function fluent(icons) {
+    return invoke(`${COMMAND_PREFIX}get_fluent_icons`, {
+        icons
+    });
+}
+function sf(symbols) {
+    return invoke(`${COMMAND_PREFIX}get_sf_symbols`, {
+        symbols
+    });
+}
+
+export { fluent, sf };

package/dist-js/index.cjs

@@ -0,0 +1,166 @@
+'use strict';
+
+var core = require('@tauri-apps/api/core');
+
+const resolved = new Map();
+const pending = new Map();
+function get(key) {
+    return resolved.get(key);
+}
+function load(key, create) {
+    const cached = resolved.get(key);
+    if (cached) {
+        return Promise.resolve(cached);
+    }
+    const inflight = pending.get(key);
+    if (inflight) {
+        return inflight;
+    }
+    const request = create().then((symbol) => {
+        pending.delete(key);
+        resolved.set(key, symbol);
+        return symbol;
+    }, (error) => {
+        pending.delete(key);
+        throw error;
+    });
+    pending.set(key, request);
+    return request;
+}
+function save(symbols, keys) {
+    symbols.forEach((symbol, index) => {
+        resolved.set(keys[index], symbol);
+    });
+}
+function clear() {
+    resolved.clear();
+    pending.clear();
+}
+
+const COMMAND_PREFIX = 'plugin:system-symbols|';
+function fluent$1(icons) {
+    return core.invoke(`${COMMAND_PREFIX}get_fluent_icons`, {
+        icons
+    });
+}
+function sf$1(symbols) {
+    return core.invoke(`${COMMAND_PREFIX}get_sf_symbols`, {
+        symbols
+    });
+}
+
+function fluent(icon) {
+    return `fluent:${icon}`;
+}
+function sf(symbol) {
+    return `sf:${symbol}`;
+}
+
+function assert(value, name) {
+    if (value.trim().length === 0) {
+        throw new Error(`${name} must not be empty`);
+    }
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+
+/**
+ * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.
+ *
+ * `Segoe Fluent Icons` is preferred by the Rust backend, with
+ * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows
+ * platform rejects with the backend platform error.
+ *
+ * @param icon Glyph text or codepoint, for example `"\uE8BB"` or `"U+E8BB"`.
+ * @returns SVG path data and viewBox metadata for the icon.
+ */
+function getFluentIcon(icon) {
+    assert(icon, 'icon');
+    return load(fluent(icon), async () => {
+        const [symbol] = await fluent$1([icon]);
+        return symbol;
+    });
+}
+/**
+ * Returns a previously resolved Windows Fluent icon without starting IPC.
+ *
+ * @param icon Glyph text or codepoint used to resolve the icon.
+ * @returns Cached SVG data, or `undefined` when the icon has not been loaded.
+ */
+function getCachedFluentIcon(icon) {
+    assert(icon, 'icon');
+    return get(fluent(icon));
+}
+/**
+ * Preloads Windows Fluent icons in one backend request.
+ *
+ * @param icons Glyph texts or codepoints to preload.
+ */
+async function preloadFluentIcons(...icons) {
+    const unique$1 = unique(icons);
+    unique$1.forEach((icon) => assert(icon, 'icon'));
+    const missing = unique$1.filter((icon) => !get(fluent(icon)));
+    if (missing.length === 0) {
+        return;
+    }
+    const symbols = await fluent$1(missing);
+    save(symbols, missing.map((icon) => fluent(icon)));
+}
+/**
+ * Resolves a macOS SF Symbol name to SVG path data.
+ *
+ * Calling this on a non-macOS platform rejects with the backend platform error.
+ *
+ * @param symbol SF Symbols name, for example `"square.and.arrow.up"`.
+ * @returns SVG path data and viewBox metadata for the symbol.
+ */
+function getSfSymbol(symbol) {
+    assert(symbol, 'symbol');
+    return load(sf(symbol), async () => {
+        const [icon] = await sf$1([symbol]);
+        return icon;
+    });
+}
+/**
+ * Returns a previously resolved SF Symbol without starting IPC.
+ *
+ * @param symbol SF Symbols name used to resolve the symbol.
+ * @returns Cached SVG data, or `undefined` when the symbol has not been loaded.
+ */
+function getCachedSfSymbol(symbol) {
+    assert(symbol, 'symbol');
+    return get(sf(symbol));
+}
+/**
+ * Preloads macOS SF Symbols in one backend request.
+ *
+ * @param symbols SF Symbols names to preload.
+ */
+async function preloadSfSymbols(...symbols) {
+    const unique$1 = unique(symbols);
+    unique$1.forEach((symbol) => assert(symbol, 'symbol'));
+    const missing = unique$1.filter((symbol) => !get(sf(symbol)));
+    if (missing.length === 0) {
+        return;
+    }
+    const icons = await sf$1(missing);
+    save(icons, missing.map((symbol) => sf(symbol)));
+}
+/**
+ * Clears the in-memory JavaScript symbol cache.
+ *
+ * This only affects frontend-side caching. The Rust backend keeps its own
+ * process-local cache.
+ */
+function clearSymbolCache() {
+    clear();
+}
+
+exports.clearSymbolCache = clearSymbolCache;
+exports.getCachedFluentIcon = getCachedFluentIcon;
+exports.getCachedSfSymbol = getCachedSfSymbol;
+exports.getFluentIcon = getFluentIcon;
+exports.getSfSymbol = getSfSymbol;
+exports.preloadFluentIcons = preloadFluentIcons;
+exports.preloadSfSymbols = preloadSfSymbols;

package/dist-js/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../guest-js/index.ts"],"sourcesContent":["import { invoke } from '@tauri-apps/api/core'\n\nconst COMMAND_PREFIX = 'plugin:system-symbols|'\n\nexport type SymbolSet = 'fluent' | 'sfSymbols'\nexport type FillRule = 'nonzero' | 'evenodd'\n\nexport interface SvgPath {\n  d: string\n  fillRule?: FillRule\n  opacity?: number\n}\n\nexport interface SvgSymbol {\n  set: SymbolSet\n  symbol: string\n  viewBox: string\n  paths: SvgPath[]\n}\n\nexport interface FluentIconOptions {}\n\nexport interface SfSymbolOptions {}\n\nconst cache = new Map<string, Promise<SvgSymbol>>()\n\n/**\n * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.\n *\n * `Segoe Fluent Icons` is preferred by the Rust backend, with\n * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows\n * platform rejects with the backend platform error.\n *\n * @param icon Glyph text or codepoint, for example `\"\\uE8BB\"` or `\"U+E8BB\"`.\n * @param options Reserved for future Fluent icon rendering options.\n * @returns SVG path data and viewBox metadata for the icon.\n */\nexport function getFluentIcon(\n  icon: string,\n  options?: FluentIconOptions\n): Promise<SvgSymbol> {\n  assertText(icon, 'icon')\n  return load('fluent', icon, options, 'get_fluent_icon', {\n    icon,\n    options: options ?? null\n  })\n}\n\n/**\n * Resolves a macOS SF Symbol name to SVG path data.\n *\n * Calling this on a non-macOS platform rejects with the backend platform error.\n *\n * @param symbol SF Symbols name, for example `\"square.and.arrow.up\"`.\n * @param options Reserved for future SF Symbols rendering options.\n * @returns SVG path data and viewBox metadata for the symbol.\n */\nexport function getSfSymbol(\n  symbol: string,\n  options?: SfSymbolOptions\n): Promise<SvgSymbol> {\n  assertText(symbol, 'symbol')\n  return load('sfSymbols', symbol, options, 'get_sf_symbol', {\n    symbol,\n    options: options ?? null\n  })\n}\n\n/**\n * Clears the in-memory JavaScript symbol cache.\n *\n * This only affects frontend-side Promise caching. The Rust backend keeps its\n * own process-local cache.\n */\nexport function clearSymbolCache(): void {\n  cache.clear()\n}\n\nfunction load(\n  set: SymbolSet,\n  symbol: string,\n  options: FluentIconOptions | SfSymbolOptions | undefined,\n  command: string,\n  args: Record<string, unknown>\n): Promise<SvgSymbol> {\n  const key = cacheKey(set, symbol, options)\n  const cached = cache.get(key)\n  if (cached) {\n    return cached\n  }\n\n  const pending = invoke<SvgSymbol>(`${COMMAND_PREFIX}${command}`, args).catch(\n    (error) => {\n      cache.delete(key)\n      throw error\n    }\n  )\n\n  cache.set(key, pending)\n  return pending\n}\n\nfunction assertText(value: string, name: string): void {\n  if (value.trim().length === 0) {\n    throw new Error(`${name} must not be empty`)\n  }\n}\n\nfunction cacheKey(\n  set: SymbolSet,\n  symbol: string,\n  options: FluentIconOptions | SfSymbolOptions | undefined\n): string {\n  return `${set}:${symbol}:${JSON.stringify(options ?? {})}`\n}\n"],"names":["invoke"],"mappings":";;;;AAEA,MAAM,cAAc,GAAG,wBAAwB;AAsB/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B;AAEnD;;;;;;;;;;AAUG;AACG,SAAU,aAAa,CAC3B,IAAY,EACZ,OAA2B,EAAA;AAE3B,IAAA,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;IACxB,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;QACtD,IAAI;QACJ,OAAO,EAAE,OAAO,IAAI;AACrB,KAAA,CAAC;AACJ;AAEA;;;;;;;;AAQG;AACG,SAAU,WAAW,CACzB,MAAc,EACd,OAAyB,EAAA;AAEzB,IAAA,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;QACzD,MAAM;QACN,OAAO,EAAE,OAAO,IAAI;AACrB,KAAA,CAAC;AACJ;AAEA;;;;;AAKG;SACa,gBAAgB,GAAA;IAC9B,KAAK,CAAC,KAAK,EAAE;AACf;AAEA,SAAS,IAAI,CACX,GAAc,EACd,MAAc,EACd,OAAwD,EACxD,OAAe,EACf,IAA6B,EAAA;IAE7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7B,IAAI,MAAM,EAAE;AACV,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,MAAM,OAAO,GAAGA,WAAM,CAAY,CAAA,EAAG,cAAc,GAAG,OAAO,CAAA,CAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAC1E,CAAC,KAAK,KAAI;AACR,QAAA,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AACjB,QAAA,MAAM,KAAK;AACb,IAAA,CAAC,CACF;AAED,IAAA,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC;AACvB,IAAA,OAAO,OAAO;AAChB;AAEA,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY,EAAA;IAC7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAA,kBAAA,CAAoB,CAAC;IAC9C;AACF;AAEA,SAAS,QAAQ,CACf,GAAc,EACd,MAAc,EACd,OAAwD,EAAA;AAExD,IAAA,OAAO,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;AAC5D;;;;;;"}

package/dist-js/index.d.ts

@@ -0,0 +1,66 @@
+interface Path {
+    d: string;
+    fillRule?: 'nonzero' | 'evenodd';
+    opacity?: number;
+}
+interface Symbol {
+    viewBox: string;
+    paths: Path[];
+}
+
+/**
+ * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.
+ *
+ * `Segoe Fluent Icons` is preferred by the Rust backend, with
+ * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows
+ * platform rejects with the backend platform error.
+ *
+ * @param icon Glyph text or codepoint, for example `"\uE8BB"` or `"U+E8BB"`.
+ * @returns SVG path data and viewBox metadata for the icon.
+ */
+declare function getFluentIcon(icon: string): Promise<Symbol>;
+/**
+ * Returns a previously resolved Windows Fluent icon without starting IPC.
+ *
+ * @param icon Glyph text or codepoint used to resolve the icon.
+ * @returns Cached SVG data, or `undefined` when the icon has not been loaded.
+ */
+declare function getCachedFluentIcon(icon: string): Symbol | undefined;
+/**
+ * Preloads Windows Fluent icons in one backend request.
+ *
+ * @param icons Glyph texts or codepoints to preload.
+ */
+declare function preloadFluentIcons(...icons: string[]): Promise<void>;
+/**
+ * Resolves a macOS SF Symbol name to SVG path data.
+ *
+ * Calling this on a non-macOS platform rejects with the backend platform error.
+ *
+ * @param symbol SF Symbols name, for example `"square.and.arrow.up"`.
+ * @returns SVG path data and viewBox metadata for the symbol.
+ */
+declare function getSfSymbol(symbol: string): Promise<Symbol>;
+/**
+ * Returns a previously resolved SF Symbol without starting IPC.
+ *
+ * @param symbol SF Symbols name used to resolve the symbol.
+ * @returns Cached SVG data, or `undefined` when the symbol has not been loaded.
+ */
+declare function getCachedSfSymbol(symbol: string): Symbol | undefined;
+/**
+ * Preloads macOS SF Symbols in one backend request.
+ *
+ * @param symbols SF Symbols names to preload.
+ */
+declare function preloadSfSymbols(...symbols: string[]): Promise<void>;
+/**
+ * Clears the in-memory JavaScript symbol cache.
+ *
+ * This only affects frontend-side caching. The Rust backend keeps its own
+ * process-local cache.
+ */
+declare function clearSymbolCache(): void;
+
+export { clearSymbolCache, getCachedFluentIcon, getCachedSfSymbol, getFluentIcon, getSfSymbol, preloadFluentIcons, preloadSfSymbols };
+export type { Path, Symbol };

package/dist-js/index.js

@@ -0,0 +1,98 @@
+import { clear, get, load, save } from './cache.js';
+import { fluent, sf } from './commands.js';
+import { fluent as fluent$1, sf as sf$1 } from './key.js';
+import { assert, unique } from './text.js';
+
+/**
+ * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.
+ *
+ * `Segoe Fluent Icons` is preferred by the Rust backend, with
+ * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows
+ * platform rejects with the backend platform error.
+ *
+ * @param icon Glyph text or codepoint, for example `"\uE8BB"` or `"U+E8BB"`.
+ * @returns SVG path data and viewBox metadata for the icon.
+ */
+function getFluentIcon(icon) {
+    assert(icon, 'icon');
+    return load(fluent$1(icon), async () => {
+        const [symbol] = await fluent([icon]);
+        return symbol;
+    });
+}
+/**
+ * Returns a previously resolved Windows Fluent icon without starting IPC.
+ *
+ * @param icon Glyph text or codepoint used to resolve the icon.
+ * @returns Cached SVG data, or `undefined` when the icon has not been loaded.
+ */
+function getCachedFluentIcon(icon) {
+    assert(icon, 'icon');
+    return get(fluent$1(icon));
+}
+/**
+ * Preloads Windows Fluent icons in one backend request.
+ *
+ * @param icons Glyph texts or codepoints to preload.
+ */
+async function preloadFluentIcons(...icons) {
+    const unique$1 = unique(icons);
+    unique$1.forEach((icon) => assert(icon, 'icon'));
+    const missing = unique$1.filter((icon) => !get(fluent$1(icon)));
+    if (missing.length === 0) {
+        return;
+    }
+    const symbols = await fluent(missing);
+    save(symbols, missing.map((icon) => fluent$1(icon)));
+}
+/**
+ * Resolves a macOS SF Symbol name to SVG path data.
+ *
+ * Calling this on a non-macOS platform rejects with the backend platform error.
+ *
+ * @param symbol SF Symbols name, for example `"square.and.arrow.up"`.
+ * @returns SVG path data and viewBox metadata for the symbol.
+ */
+function getSfSymbol(symbol) {
+    assert(symbol, 'symbol');
+    return load(sf$1(symbol), async () => {
+        const [icon] = await sf([symbol]);
+        return icon;
+    });
+}
+/**
+ * Returns a previously resolved SF Symbol without starting IPC.
+ *
+ * @param symbol SF Symbols name used to resolve the symbol.
+ * @returns Cached SVG data, or `undefined` when the symbol has not been loaded.
+ */
+function getCachedSfSymbol(symbol) {
+    assert(symbol, 'symbol');
+    return get(sf$1(symbol));
+}
+/**
+ * Preloads macOS SF Symbols in one backend request.
+ *
+ * @param symbols SF Symbols names to preload.
+ */
+async function preloadSfSymbols(...symbols) {
+    const unique$1 = unique(symbols);
+    unique$1.forEach((symbol) => assert(symbol, 'symbol'));
+    const missing = unique$1.filter((symbol) => !get(sf$1(symbol)));
+    if (missing.length === 0) {
+        return;
+    }
+    const icons = await sf(missing);
+    save(icons, missing.map((symbol) => sf$1(symbol)));
+}
+/**
+ * Clears the in-memory JavaScript symbol cache.
+ *
+ * This only affects frontend-side caching. The Rust backend keeps its own
+ * process-local cache.
+ */
+function clearSymbolCache() {
+    clear();
+}
+
+export { clearSymbolCache, getCachedFluentIcon, getCachedSfSymbol, getFluentIcon, getSfSymbol, preloadFluentIcons, preloadSfSymbols };

package/dist-js/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../guest-js/index.ts"],"sourcesContent":["import { invoke } from '@tauri-apps/api/core'\n\nconst COMMAND_PREFIX = 'plugin:system-symbols|'\n\nexport type SymbolSet = 'fluent' | 'sfSymbols'\nexport type FillRule = 'nonzero' | 'evenodd'\n\nexport interface SvgPath {\n  d: string\n  fillRule?: FillRule\n  opacity?: number\n}\n\nexport interface SvgSymbol {\n  set: SymbolSet\n  symbol: string\n  viewBox: string\n  paths: SvgPath[]\n}\n\nexport interface FluentIconOptions {}\n\nexport interface SfSymbolOptions {}\n\nconst cache = new Map<string, Promise<SvgSymbol>>()\n\n/**\n * Resolves a Windows Segoe Fluent Icons glyph to SVG path data.\n *\n * `Segoe Fluent Icons` is preferred by the Rust backend, with\n * `Segoe MDL2 Assets` used as the fallback font. Calling this on a non-Windows\n * platform rejects with the backend platform error.\n *\n * @param icon Glyph text or codepoint, for example `\"\\uE8BB\"` or `\"U+E8BB\"`.\n * @param options Reserved for future Fluent icon rendering options.\n * @returns SVG path data and viewBox metadata for the icon.\n */\nexport function getFluentIcon(\n  icon: string,\n  options?: FluentIconOptions\n): Promise<SvgSymbol> {\n  assertText(icon, 'icon')\n  return load('fluent', icon, options, 'get_fluent_icon', {\n    icon,\n    options: options ?? null\n  })\n}\n\n/**\n * Resolves a macOS SF Symbol name to SVG path data.\n *\n * Calling this on a non-macOS platform rejects with the backend platform error.\n *\n * @param symbol SF Symbols name, for example `\"square.and.arrow.up\"`.\n * @param options Reserved for future SF Symbols rendering options.\n * @returns SVG path data and viewBox metadata for the symbol.\n */\nexport function getSfSymbol(\n  symbol: string,\n  options?: SfSymbolOptions\n): Promise<SvgSymbol> {\n  assertText(symbol, 'symbol')\n  return load('sfSymbols', symbol, options, 'get_sf_symbol', {\n    symbol,\n    options: options ?? null\n  })\n}\n\n/**\n * Clears the in-memory JavaScript symbol cache.\n *\n * This only affects frontend-side Promise caching. The Rust backend keeps its\n * own process-local cache.\n */\nexport function clearSymbolCache(): void {\n  cache.clear()\n}\n\nfunction load(\n  set: SymbolSet,\n  symbol: string,\n  options: FluentIconOptions | SfSymbolOptions | undefined,\n  command: string,\n  args: Record<string, unknown>\n): Promise<SvgSymbol> {\n  const key = cacheKey(set, symbol, options)\n  const cached = cache.get(key)\n  if (cached) {\n    return cached\n  }\n\n  const pending = invoke<SvgSymbol>(`${COMMAND_PREFIX}${command}`, args).catch(\n    (error) => {\n      cache.delete(key)\n      throw error\n    }\n  )\n\n  cache.set(key, pending)\n  return pending\n}\n\nfunction assertText(value: string, name: string): void {\n  if (value.trim().length === 0) {\n    throw new Error(`${name} must not be empty`)\n  }\n}\n\nfunction cacheKey(\n  set: SymbolSet,\n  symbol: string,\n  options: FluentIconOptions | SfSymbolOptions | undefined\n): string {\n  return `${set}:${symbol}:${JSON.stringify(options ?? {})}`\n}\n"],"names":[],"mappings":";;AAEA,MAAM,cAAc,GAAG,wBAAwB;AAsB/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B;AAEnD;;;;;;;;;;AAUG;AACG,SAAU,aAAa,CAC3B,IAAY,EACZ,OAA2B,EAAA;AAE3B,IAAA,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;IACxB,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;QACtD,IAAI;QACJ,OAAO,EAAE,OAAO,IAAI;AACrB,KAAA,CAAC;AACJ;AAEA;;;;;;;;AAQG;AACG,SAAU,WAAW,CACzB,MAAc,EACd,OAAyB,EAAA;AAEzB,IAAA,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;QACzD,MAAM;QACN,OAAO,EAAE,OAAO,IAAI;AACrB,KAAA,CAAC;AACJ;AAEA;;;;;AAKG;SACa,gBAAgB,GAAA;IAC9B,KAAK,CAAC,KAAK,EAAE;AACf;AAEA,SAAS,IAAI,CACX,GAAc,EACd,MAAc,EACd,OAAwD,EACxD,OAAe,EACf,IAA6B,EAAA;IAE7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7B,IAAI,MAAM,EAAE;AACV,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,MAAM,OAAO,GAAG,MAAM,CAAY,CAAA,EAAG,cAAc,GAAG,OAAO,CAAA,CAAE,EAAE,IAAI,CAAC,CAAC,KAAK,CAC1E,CAAC,KAAK,KAAI;AACR,QAAA,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AACjB,QAAA,MAAM,KAAK;AACb,IAAA,CAAC,CACF;AAED,IAAA,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC;AACvB,IAAA,OAAO,OAAO;AAChB;AAEA,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY,EAAA;IAC7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,QAAA,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAA,kBAAA,CAAoB,CAAC;IAC9C;AACF;AAEA,SAAS,QAAQ,CACf,GAAc,EACd,MAAc,EACd,OAAwD,EAAA;AAExD,IAAA,OAAO,CAAA,EAAG,GAAG,CAAA,CAAA,EAAI,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;AAC5D;;;;"}

package/dist-js/key.d.ts

@@ -0,0 +1,2 @@
+export declare function fluent(icon: string): string;
+export declare function sf(symbol: string): string;

package/dist-js/key.js

@@ -0,0 +1,8 @@
+function fluent(icon) {
+    return `fluent:${icon}`;
+}
+function sf(symbol) {
+    return `sf:${symbol}`;
+}
+
+export { fluent, sf };

package/dist-js/text.d.ts

@@ -0,0 +1,2 @@
+export declare function assert(value: string, name: string): void;
+export declare function unique(values: string[]): string[];

package/dist-js/text.js

@@ -0,0 +1,10 @@
+function assert(value, name) {
+    if (value.trim().length === 0) {
+        throw new Error(`${name} must not be empty`);
+    }
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+
+export { assert, unique };

package/dist-js/types.d.ts

@@ -0,0 +1,9 @@
+export interface Path {
+    d: string;
+    fillRule?: 'nonzero' | 'evenodd';
+    opacity?: number;
+}
+export interface Symbol {
+    viewBox: string;
+    paths: Path[];
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "tauri-plugin-system-symbols",
+  "version": "0.1.0",
+  "description": "System symbol SVG paths for Tauri apps.",
+  "license": "MIT",
+  "author": "insd47",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/insd47/tauri-plugin-system-symbols.git"
+  },
+  "packageManager": "pnpm@10.24.0",
+  "type": "module",
+  "types": "./dist-js/index.d.ts",
+  "main": "./dist-js/index.cjs",
+  "module": "./dist-js/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist-js/index.d.ts",
+      "import": "./dist-js/index.js",
+      "require": "./dist-js/index.cjs"
+    }
+  },
+  "files": [
+    "dist-js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "check": "tsc --noEmit",
+    "prepack": "pnpm run build"
+  },
+  "dependencies": {
+    "@tauri-apps/api": "^2.11.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.3.0",
+    "prettier": "^3.8.4",
+    "rollup": "^4.44.0",
+    "rollup-plugin-dts": "^6.2.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.8.3"
+  }
+}