@camox/api-contract 0.43.0 → 0.44.0

package/dist/icons.d.ts

@@ -0,0 +1,20 @@
+import type { IconifyJSON } from "@iconify/types";
+export declare const ICON_CATALOG_VERSION = "2.2.532";
+export type IconSvgData = {
+    body: string;
+    attributes: Record<string, string>;
+    attribution?: {
+        collection: string;
+        author: string;
+        license: string;
+        url?: string;
+    };
+};
+export declare function loadIconCollection(prefix: string): Promise<IconifyJSON>;
+export declare function iconCollectionIds(data: IconifyJSON): string[];
+export declare function resolveIconSvg(data: IconifyJSON, id: string): IconSvgData;
+export declare function scopeIconSvgIds(body: string, prefix: string): string;
+export declare function validateIconValue(value: unknown, schema: {
+    fieldType?: string;
+    enum?: unknown;
+}): void;

package/dist/icons.js

@@ -0,0 +1,72 @@
+import { getIconData, iconToSVG } from "@iconify/utils";
+// One immutable snapshot for declarations, schemas, picker and SVG resolution.
+export const ICON_CATALOG_VERSION = "2.2.532";
+const collections = new Map();
+export async function loadIconCollection(prefix) {
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(prefix))
+        throw new Error("Invalid icon collection");
+    const existing = collections.get(prefix);
+    if (existing)
+        return existing;
+    const pending = (async () => {
+        const response = await fetch(`https://unpkg.com/@iconify/json@${ICON_CATALOG_VERSION}/json/${prefix}.json`, { signal: AbortSignal.timeout(30_000) });
+        if (!response.ok)
+            throw new Error(`Unable to load icon collection ${prefix}`);
+        const data = (await response.json());
+        if (data.prefix !== prefix || !data.icons || !data.info?.license)
+            throw new Error("Invalid icon catalog or missing license");
+        return data;
+    })();
+    collections.set(prefix, pending);
+    // Bound worker memory; failed fetches must be retryable.
+    if (collections.size > 8)
+        collections.delete(collections.keys().next().value);
+    try {
+        return await pending;
+    }
+    catch (error) {
+        collections.delete(prefix);
+        throw error;
+    }
+}
+export function iconCollectionIds(data) {
+    return [...Object.keys(data.icons), ...Object.keys(data.aliases ?? {})]
+        .filter((name) => getIconData(data, name) !== null)
+        .sort()
+        .map((name) => `${data.prefix}:${name}`);
+}
+export function resolveIconSvg(data, id) {
+    const [prefix, name, extra] = id.split(":");
+    if (prefix !== data.prefix || !name || extra !== undefined)
+        throw new Error("Invalid icon ID");
+    const icon = getIconData(data, name);
+    if (!icon)
+        throw new Error(`Unknown icon: ${id}`);
+    const svg = iconToSVG(icon);
+    return {
+        body: svg.body,
+        attributes: svg.attributes,
+        attribution: data.info
+            ? {
+                collection: data.info.name,
+                author: data.info.author.name,
+                license: data.info.license.title,
+                url: data.info.license.url,
+            }
+            : undefined,
+    };
+}
+export function scopeIconSvgIds(body, prefix) {
+    const ids = [...body.matchAll(/\sid="([^\s"]+)"/g)].map((match) => match[1]);
+    if (!ids.length)
+        return body;
+    const pattern = ids.map((id) => id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+    return body.replace(new RegExp(`([#;"])(${pattern})([")]|\\.[a-z])`, "g"), (_match, before, id, after) => `${before}${prefix}${id}${after}`);
+}
+export function validateIconValue(value, schema) {
+    if (schema.fieldType !== "Icon")
+        return;
+    if (typeof value !== "string" || !Array.isArray(schema.enum) || !schema.enum.includes(value)) {
+        throw new Error(`Invalid icon ID: ${String(value)}`);
+    }
+}