waybetter 0.1.1 → 0.6.0

package/dist/runtime/themeIcons.js

@@ -0,0 +1,263 @@
+// Icon packs: a standalone document (`*.icons.json`) of glyphs by semantic name (`home`, `like`,
+// `reply`), drawn over a site's own icons. A theme only names a pack (a suggestion); the owner's icon
+// choice is separate ("Follow the theme", a pack, or the site's own icons). Pure.
+//
+// A pack is data, never an SVG document: a glyph is path data (checked against a path grammar), a few
+// colored layers of path data, or a small PNG. The engine builds the SVG itself, so no element,
+// attribute, script or reference can arrive with a pack.
+//
+// Drawing: nothing in the site's DOM is rewritten. The site's own `<svg>` box gets the glyph as a CSS
+// mask filled with `currentColor` (so the site's color states keep working: a liked heart stays the
+// like color) and its own paths are made transparent. Colored glyphs (layers, PNG) are a background
+// image instead. Which `<svg>` is which icon is the site's table (container first, path signature
+// second). No glyph, no match or no pack: no rule, the site's icon stays.
+import { COLOR_ROLES } from "./themeComponents.js";
+/** Semantic names a pack may draw. `.active` is a selected navigation item, `.on` an action that is set. */
+export const ICON_NAMES = [
+    'home', 'home.active', 'explore', 'explore.active', 'notifications', 'notifications.active', 'messages', 'messages.active',
+    'grok', 'bookmarks', 'bookmarks.active', 'lists', 'communities', 'premium', 'profile', 'profile.active', 'more', 'compose',
+    'reply', 'repost', 'repost.on', 'like', 'like.on', 'views', 'bookmark', 'bookmark.on', 'share',
+    'verified', 'logo', 'caret', 'back', 'close', 'search', 'settings',
+    'media', 'gif', 'poll', 'emoji', 'schedule', 'location', 'pinned', 'repostContext', 'lock',
+];
+export const ICON_GROUPS = ['nav', 'actions', 'composer', 'misc'];
+/** Limits of a pack (the JSON Schema and the Store check say the same). */
+export const ICON_LIMITS = { names: 64, pathChars: 4000, layers: 6, pngChars: 6000, packBytes: 120_000, labelChars: 12, overrides: 8 };
+/** Path data only: commands, numbers, separators. */
+export const PATH_GRAMMAR = /^[MmLlHhVvCcSsQqTtAaZz0-9eE\s,.+-]{1,4000}$/;
+const PNG_DATA = /^data:image\/png;base64,[A-Za-z0-9+/]+={0,2}$/;
+const HEX = /^#[0-9a-f]{6}$/i;
+/** Words a theme or pack may put next to an action: written into CSS strings. */
+const LABEL_TEXT = /^[\p{L}\p{N} [\]().:+\-_/#@*~!?]{1,12}$/u;
+export const BASE_ICON_STYLE = { stroke: 1.75, cap: 'round', join: 'round', scale: 1 };
+export const ICON_LABEL_NAMES = ['reply', 'repost', 'like', 'views', 'bookmark', 'share'];
+const obj = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const plain = (value, max) => typeof value === 'string' ? value.replace(/[\u0000-\u001f\u007f<>]/g, '').trim().slice(0, max) : '';
+const num = (value, min, max, fallback) => typeof value === 'number' && Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;
+const path = (value) => typeof value === 'string' && PATH_GRAMMAR.test(value);
+function sanitizeFill(value) {
+    if (typeof value === 'string')
+        return COLOR_ROLES.includes(value) ? value : HEX.test(value) ? value.toLowerCase() : null;
+    const source = obj(value);
+    return typeof source.from === 'string' && typeof source.to === 'string' && HEX.test(source.from) && HEX.test(source.to) ? { from: source.from.toLowerCase(), to: source.to.toLowerCase() } : null;
+}
+/** One glyph from JSON, or null when it is not valid path data, layers or a small PNG. */
+export function sanitizeGlyph(value) {
+    const source = obj(value);
+    if (path(source.d))
+        return { d: source.d.trim(), ...(source.rule === 'evenodd' ? { rule: 'evenodd' } : {}), ...(source.stroke === true ? { stroke: true } : {}) };
+    if (Array.isArray(source.layers)) {
+        const layers = source.layers.slice(0, ICON_LIMITS.layers).flatMap(raw => {
+            const layer = obj(raw), fill = sanitizeFill(layer.fill);
+            if (!path(layer.d) || !fill)
+                return [];
+            return [{ d: layer.d.trim(), fill, ...(typeof layer.opacity === 'number' ? { opacity: +num(layer.opacity, 0, 1, 1).toFixed(2) } : {}), ...(layer.rule === 'evenodd' ? { rule: 'evenodd' } : {}) }];
+        });
+        return layers.length ? { layers } : null;
+    }
+    if (typeof source.png === 'string' && source.png.length <= ICON_LIMITS.pngChars + 22 && PNG_DATA.test(source.png))
+        return { png: source.png, ...(source.pixel === true ? { pixel: true } : {}) };
+    return null;
+}
+export const sanitizeIconStyle = (value, base = BASE_ICON_STYLE) => {
+    const source = obj(value);
+    const pick = (item, options, fallback) => options.includes(item) ? item : fallback;
+    return {
+        stroke: +num(source.stroke, 1, 2.5, base.stroke).toFixed(2), cap: pick(source.cap, ['round', 'square', 'butt'], base.cap),
+        join: pick(source.join, ['round', 'miter', 'bevel'], base.join), scale: +num(source.scale, 0.8, 1.25, base.scale).toFixed(2),
+    };
+};
+function sanitizeGlyphs(value, max) {
+    const source = obj(value);
+    const out = {};
+    let count = 0;
+    for (const name of ICON_NAMES) {
+        if (count >= max || !Object.hasOwn(source, name))
+            continue;
+        const glyph = sanitizeGlyph(source[name]);
+        if (glyph) {
+            out[name] = glyph;
+            count++;
+        }
+    }
+    return out;
+}
+function sanitizeSymbols(value) {
+    const source = obj(value);
+    const out = {};
+    if (source.like === 'heart' || source.like === 'star' || source.like === 'custom')
+        out.like = source.like;
+    if (['dot', 'bullet', 'slash', 'dash', 'pipe', 'none'].includes(source.separator))
+        out.separator = source.separator;
+    return Object.keys(out).length ? out : undefined;
+}
+function sanitizeLabels(value) {
+    const source = obj(value);
+    const out = {};
+    for (const name of ICON_LABEL_NAMES)
+        if (typeof source[name] === 'string' && LABEL_TEXT.test(source[name]))
+            out[name] = source[name].trim();
+    return Object.keys(out).length ? out : undefined;
+}
+/** Any JSON to a valid pack, or null when it has no id, no name or no valid glyph. */
+export function sanitizeIconPack(input) {
+    const source = obj(input);
+    const name = plain(source.name, 60);
+    const id = typeof source.id === 'string' && /^[a-z0-9-]{1,40}$/.test(source.id) ? source.id : '';
+    const glyphs = sanitizeGlyphs(source.glyphs, ICON_LIMITS.names);
+    if (!id || !name || !Object.keys(glyphs).length)
+        return null;
+    const symbols = sanitizeSymbols(source.symbols), labels = sanitizeLabels(source.labels);
+    return {
+        id, name, description: plain(source.description, 200), author: plain(source.author, 60), license: plain(source.license, 60) || 'unknown',
+        source: plain(source.source, 200), credits: plain(source.credits, 400), version: 1, style: sanitizeIconStyle(source.style), glyphs,
+        ...(symbols ? { symbols } : {}), ...(labels ? { labels } : {}),
+    };
+}
+/** Parses an imported `*.icons.json`; errors are human-readable. */
+export function parseIconPackJson(json) {
+    if (json.length > ICON_LIMITS.packBytes)
+        return { error: 'This icon pack is larger than 120 KB.' };
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch {
+        return { error: 'This file is not valid JSON.' };
+    }
+    const pack = sanitizeIconPack(raw);
+    if (!pack)
+        return { error: 'An icon pack needs an "id", a "name" and at least one valid glyph.' };
+    const dropped = Object.keys(obj(obj(raw).glyphs)).length - Object.keys(pack.glyphs).length;
+    const warnings = [];
+    if (dropped > 0)
+        warnings.push(`${dropped} glyph(s) were ignored: unknown names, or drawings that are not plain path data.`);
+    if (pack.license === 'unknown')
+        warnings.push('This pack does not say under which license its drawings are.');
+    return { pack, warnings };
+}
+/** The `icons` group of a theme from JSON. Null when it says nothing valid. */
+export function sanitizeThemeIcons(value) {
+    const source = obj(value);
+    const out = {};
+    if (typeof source.pack === 'string' && /^[a-z0-9-]{1,40}$/.test(source.pack))
+        out.pack = source.pack;
+    if (Object.keys(obj(source.style)).length) {
+        const style = obj(source.style), full = sanitizeIconStyle(style);
+        out.style = Object.fromEntries(['stroke', 'cap', 'join', 'scale'].filter(key => key in style).map(key => [key, full[key]]));
+    }
+    const overrides = sanitizeGlyphs(source.overrides, ICON_LIMITS.overrides);
+    if (Object.keys(overrides).length)
+        out.overrides = overrides;
+    const symbols = sanitizeSymbols(source.symbols);
+    if (symbols)
+        out.symbols = symbols;
+    const labels = sanitizeLabels(source.labels);
+    if (labels)
+        out.labels = labels;
+    return Object.keys(out).length ? out : null;
+}
+export const normalizeIconChoice = (value) => typeof value === 'string' && /^[a-z0-9-]{1,40}$/.test(value) ? value : 'theme';
+export function createIconCatalog(builtins, installed = []) {
+    const packs = [...builtins, ...installed.filter(pack => !builtins.some(item => item.id === pack.id))];
+    const get = (id) => packs.find(pack => pack.id === id) ?? null;
+    return { packs, get, resolve: (choice, theme) => choice === 'site' ? null : choice === 'theme' ? get(theme?.pack) : get(choice) };
+}
+// ---------------------------------------------------------------------------------------------
+// Drawing
+const esc = (value) => value.replace(/[<>&"']/g, '');
+const paint = (fill, colors, id) => {
+    if (typeof fill === 'string')
+        return { attr: HEX.test(fill) ? fill : colors?.[fill] ?? '#000000', def: '' };
+    return { attr: `url(#${id})`, def: `<linearGradient id="${id}" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="${esc(fill.from)}"/><stop offset="1" stop-color="${esc(fill.to)}"/></linearGradient>` };
+};
+/** The SVG document of a glyph, built from validated data. `colors` resolves role fills of layers; a single path is black (it is used as a mask). */
+export function glyphSvg(glyph, style, colors = null) {
+    const open = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">';
+    if ('d' in glyph) {
+        const attrs = glyph.stroke
+            ? `fill="none" stroke="#000" stroke-width="${style.stroke}" stroke-linecap="${style.cap}" stroke-linejoin="${style.join}"`
+            : `fill="#000"${glyph.rule ? ' fill-rule="evenodd"' : ''}`;
+        return `${open}<path d="${esc(glyph.d)}" ${attrs}/></svg>`;
+    }
+    if ('layers' in glyph) {
+        const defs = [];
+        const paths = glyph.layers.map((layer, index) => {
+            const { attr, def } = paint(layer.fill, colors, `g${index}`);
+            if (def)
+                defs.push(def);
+            return `<path d="${esc(layer.d)}" fill="${attr}"${layer.opacity !== undefined ? ` opacity="${layer.opacity}"` : ''}${layer.rule ? ' fill-rule="evenodd"' : ''}/>`;
+        });
+        return `${open}${defs.length ? `<defs>${defs.join('')}</defs>` : ''}${paths.join('')}</svg>`;
+    }
+    return null;
+}
+const svgUrl = (svg) => `url("data:image/svg+xml,${encodeURIComponent(svg).replace(/'/g, '%27').replace(/"/g, '%22')}")`;
+/** True for glyphs that carry their own colors (drawn as an image, not as a mask of the current color). */
+export const isColored = (glyph) => !('d' in glyph);
+/** Selectors of the `<svg>` boxes of one icon. */
+export function iconSelectors(matcher) {
+    const out = [];
+    if (matcher.ctx)
+        out.push(...matcher.ctx.split(/,(?![^(]*\))/).map(one => one.trim()));
+    for (const prefix of matcher.sig ?? [])
+        if (PATH_GRAMMAR.test(prefix))
+            out.push(`svg:has(> g > path[d^="${prefix}"])`);
+    return out;
+}
+/**
+ * CSS that draws `pack` over a site's icons. One rule per glyph the pack has and the site's table
+ * knows, inside guards: forced colors remove backgrounds (a masked icon would vanish) and an engine
+ * without masks would paint solid squares.
+ */
+export function compileIcons(pack, theme, table, ctx) {
+    if (ctx.allowed === false)
+        return '';
+    const glyphs = { ...pack?.glyphs, ...theme?.overrides };
+    const style = { ...(pack?.style ?? BASE_ICON_STYLE), ...theme?.style };
+    const masked = [], colored = [], hidden = [];
+    for (const name of ICON_NAMES) {
+        const glyph = glyphs[name], matcher = table[name];
+        if (!glyph || !matcher)
+            continue;
+        const gate = ctx.gate ? `html[${ctx.gate}~="${matcher.group}"] ` : '';
+        const selectors = iconSelectors(matcher).map(one => `${gate}${one}`);
+        if (!selectors.length)
+            continue;
+        const size = `${Math.round(style.scale * 100)}%`;
+        if ('png' in glyph) {
+            colored.push(`${selectors.join(',')}{background:url("${glyph.png}") center / ${size} no-repeat !important;${glyph.pixel ? 'image-rendering:pixelated;' : ''}}`);
+        }
+        else {
+            const svg = glyphSvg(glyph, style, ctx.colors);
+            if (!svg)
+                continue;
+            if (isColored(glyph))
+                colored.push(`${selectors.join(',')}{background:${svgUrl(svg)} center / ${size} no-repeat !important}`);
+            else
+                masked.push(`${selectors.join(',')}{background-color:currentColor !important;-webkit-mask:${svgUrl(svg)} center / ${size} no-repeat;mask:${svgUrl(svg)} center / ${size} no-repeat}`);
+        }
+        hidden.push(...selectors.map(one => `${one} > *`));
+    }
+    if (!hidden.length)
+        return '';
+    const hide = `${hidden.join(',')}{opacity:0 !important}`;
+    const images = colored.length ? `${colored.join('\n')}\n` : '';
+    // Colored glyphs need no mask support; masked ones are dropped together with their hiding rule where masks are missing.
+    if (!masked.length)
+        return `@media (forced-colors:none){\n${images}${hide}\n}`;
+    return `@media (forced-colors:none){@supports ((mask-image:url("")) or (-webkit-mask-image:url(""))){\n${images}${masked.join('\n')}\n${hide}\n}}`;
+}
+/** The groups of `table` whose core icons are all on the page (`has(selector)` says whether one matches). Empty table entries count as present. */
+export function iconGroupsPresent(table, has) {
+    return ICON_GROUPS.filter(group => {
+        const core = ICON_NAMES.map(name => table[name]).filter((matcher) => !!matcher && matcher.group === group && !!matcher.core);
+        return core.every(matcher => iconSelectors(matcher).some(selector => { try {
+            return has(selector);
+        }
+        catch {
+            return false;
+        } }));
+    });
+}
+//# sourceMappingURL=themeIcons.js.map

package/dist/runtime/themeIcons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeIcons.js","sourceRoot":"","sources":["../../../runtime/src/themeIcons.ts"],"names":[],"mappings":"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","sourcesContent":["// Icon packs: a standalone document (`*.icons.json`) of glyphs by semantic name (`home`, `like`,\n// `reply`), drawn over a site's own icons. A theme only names a pack (a suggestion); the owner's icon\n// choice is separate (\"Follow the theme\", a pack, or the site's own icons). Pure.\n//\n// A pack is data, never an SVG document: a glyph is path data (checked against a path grammar), a few\n// colored layers of path data, or a small PNG. The engine builds the SVG itself, so no element,\n// attribute, script or reference can arrive with a pack.\n//\n// Drawing: nothing in the site's DOM is rewritten. The site's own `<svg>` box gets the glyph as a CSS\n// mask filled with `currentColor` (so the site's color states keep working: a liked heart stays the\n// like color) and its own paths are made transparent. Colored glyphs (layers, PNG) are a background\n// image instead. Which `<svg>` is which icon is the site's table (container first, path signature\n// second). No glyph, no match or no pack: no rule, the site's icon stays.\n\nimport { COLOR_ROLES, type ColorRole, type RoleColors } from './themeComponents.ts';\n\n/** Semantic names a pack may draw. `.active` is a selected navigation item, `.on` an action that is set. */\nexport const ICON_NAMES = [\n  'home', 'home.active', 'explore', 'explore.active', 'notifications', 'notifications.active', 'messages', 'messages.active',\n  'grok', 'bookmarks', 'bookmarks.active', 'lists', 'communities', 'premium', 'profile', 'profile.active', 'more', 'compose',\n  'reply', 'repost', 'repost.on', 'like', 'like.on', 'views', 'bookmark', 'bookmark.on', 'share',\n  'verified', 'logo', 'caret', 'back', 'close', 'search', 'settings',\n  'media', 'gif', 'poll', 'emoji', 'schedule', 'location', 'pinned', 'repostContext', 'lock',\n] as const;\nexport type IconName = typeof ICON_NAMES[number];\nexport const ICON_GROUPS = ['nav', 'actions', 'composer', 'misc'] as const;\nexport type IconGroup = typeof ICON_GROUPS[number];\n\n/** Limits of a pack (the JSON Schema and the Store check say the same). */\nexport const ICON_LIMITS = { names: 64, pathChars: 4000, layers: 6, pngChars: 6000, packBytes: 120_000, labelChars: 12, overrides: 8 } as const;\n/** Path data only: commands, numbers, separators. */\nexport const PATH_GRAMMAR = /^[MmLlHhVvCcSsQqTtAaZz0-9eE\\s,.+-]{1,4000}$/;\nconst PNG_DATA = /^data:image\\/png;base64,[A-Za-z0-9+/]+={0,2}$/;\nconst HEX = /^#[0-9a-f]{6}$/i;\n/** Words a theme or pack may put next to an action: written into CSS strings. */\nconst LABEL_TEXT = /^[\\p{L}\\p{N} [\\]().:+\\-_/#@*~!?]{1,12}$/u;\n\nexport type IconFill = ColorRole | string | { from: string; to: string };\nexport type IconGlyph =\n  | { d: string; rule?: 'evenodd'; stroke?: boolean }\n  | { layers: Array<{ d: string; fill: IconFill; opacity?: number; rule?: 'evenodd' }> }\n  | { png: string; pixel?: boolean };\nexport type IconStyle = { stroke: number; cap: 'round' | 'square' | 'butt'; join: 'round' | 'miter' | 'bevel'; scale: number };\nexport const BASE_ICON_STYLE: IconStyle = { stroke: 1.75, cap: 'round', join: 'round', scale: 1 };\nexport const ICON_LABEL_NAMES = ['reply', 'repost', 'like', 'views', 'bookmark', 'share'] as const;\nexport type IconLabels = Partial<Record<typeof ICON_LABEL_NAMES[number], string>>;\nexport type IconSymbols = { like?: 'heart' | 'star' | 'custom'; separator?: 'dot' | 'bullet' | 'slash' | 'dash' | 'pipe' | 'none' };\n\nexport type IconPack = {\n  id: string;\n  name: string;\n  description: string;\n  author: string;\n  /** SPDX id, or `own` for the author's own drawings, or a plain name for artwork under other terms. */\n  license: string;\n  /** Where the drawings come from (a project name or URL as text) and whom to credit. */\n  source: string;\n  credits: string;\n  version: 1;\n  style: IconStyle;\n  glyphs: Partial<Record<IconName, IconGlyph>>;\n  symbols?: IconSymbols;\n  labels?: IconLabels;\n};\n\n/** What a theme says about icons: a pack by id, plus small adjustments. Never a whole pack. */\nexport type ThemeIcons = { pack?: string; style?: Partial<IconStyle>; overrides?: Partial<Record<IconName, IconGlyph>>; symbols?: IconSymbols; labels?: IconLabels };\n\nconst obj = (value: unknown): Record<string, unknown> => value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {};\nconst plain = (value: unknown, max: number) => typeof value === 'string' ? value.replace(/[\\u0000-\\u001f\\u007f<>]/g, '').trim().slice(0, max) : '';\nconst num = (value: unknown, min: number, max: number, fallback: number) => typeof value === 'number' && Number.isFinite(value) ? Math.min(max, Math.max(min, value)) : fallback;\nconst path = (value: unknown): value is string => typeof value === 'string' && PATH_GRAMMAR.test(value);\n\nfunction sanitizeFill(value: unknown): IconFill | null {\n  if (typeof value === 'string') return (COLOR_ROLES as readonly string[]).includes(value) ? value : HEX.test(value) ? value.toLowerCase() : null;\n  const source = obj(value);\n  return typeof source.from === 'string' && typeof source.to === 'string' && HEX.test(source.from) && HEX.test(source.to) ? { from: source.from.toLowerCase(), to: source.to.toLowerCase() } : null;\n}\n\n/** One glyph from JSON, or null when it is not valid path data, layers or a small PNG. */\nexport function sanitizeGlyph(value: unknown): IconGlyph | null {\n  const source = obj(value);\n  if (path(source.d)) return { d: source.d.trim(), ...(source.rule === 'evenodd' ? { rule: 'evenodd' as const } : {}), ...(source.stroke === true ? { stroke: true } : {}) };\n  if (Array.isArray(source.layers)) {\n    const layers = source.layers.slice(0, ICON_LIMITS.layers).flatMap(raw => {\n      const layer = obj(raw), fill = sanitizeFill(layer.fill);\n      if (!path(layer.d) || !fill) return [];\n      return [{ d: layer.d.trim(), fill, ...(typeof layer.opacity === 'number' ? { opacity: +num(layer.opacity, 0, 1, 1).toFixed(2) } : {}), ...(layer.rule === 'evenodd' ? { rule: 'evenodd' as const } : {}) }];\n    });\n    return layers.length ? { layers } : null;\n  }\n  if (typeof source.png === 'string' && source.png.length <= ICON_LIMITS.pngChars + 22 && PNG_DATA.test(source.png)) return { png: source.png, ...(source.pixel === true ? { pixel: true } : {}) };\n  return null;\n}\n\nexport const sanitizeIconStyle = (value: unknown, base: IconStyle = BASE_ICON_STYLE): IconStyle => {\n  const source = obj(value);\n  const pick = <T extends string>(item: unknown, options: readonly T[], fallback: T) => options.includes(item as T) ? item as T : fallback;\n  return {\n    stroke: +num(source.stroke, 1, 2.5, base.stroke).toFixed(2), cap: pick(source.cap, ['round', 'square', 'butt'] as const, base.cap),\n    join: pick(source.join, ['round', 'miter', 'bevel'] as const, base.join), scale: +num(source.scale, 0.8, 1.25, base.scale).toFixed(2),\n  };\n};\n\nfunction sanitizeGlyphs(value: unknown, max: number): Partial<Record<IconName, IconGlyph>> {\n  const source = obj(value);\n  const out: Partial<Record<IconName, IconGlyph>> = {};\n  let count = 0;\n  for (const name of ICON_NAMES) {\n    if (count >= max || !Object.hasOwn(source, name)) continue;\n    const glyph = sanitizeGlyph(source[name]);\n    if (glyph) { out[name] = glyph; count++; }\n  }\n  return out;\n}\nfunction sanitizeSymbols(value: unknown): IconSymbols | undefined {\n  const source = obj(value);\n  const out: IconSymbols = {};\n  if (source.like === 'heart' || source.like === 'star' || source.like === 'custom') out.like = source.like;\n  if (['dot', 'bullet', 'slash', 'dash', 'pipe', 'none'].includes(source.separator as string)) out.separator = source.separator as IconSymbols['separator'];\n  return Object.keys(out).length ? out : undefined;\n}\nfunction sanitizeLabels(value: unknown): IconLabels | undefined {\n  const source = obj(value);\n  const out: IconLabels = {};\n  for (const name of ICON_LABEL_NAMES) if (typeof source[name] === 'string' && LABEL_TEXT.test(source[name] as string)) out[name] = (source[name] as string).trim();\n  return Object.keys(out).length ? out : undefined;\n}\n\n/** Any JSON to a valid pack, or null when it has no id, no name or no valid glyph. */\nexport function sanitizeIconPack(input: unknown): IconPack | null {\n  const source = obj(input);\n  const name = plain(source.name, 60);\n  const id = typeof source.id === 'string' && /^[a-z0-9-]{1,40}$/.test(source.id) ? source.id : '';\n  const glyphs = sanitizeGlyphs(source.glyphs, ICON_LIMITS.names);\n  if (!id || !name || !Object.keys(glyphs).length) return null;\n  const symbols = sanitizeSymbols(source.symbols), labels = sanitizeLabels(source.labels);\n  return {\n    id, name, description: plain(source.description, 200), author: plain(source.author, 60), license: plain(source.license, 60) || 'unknown',\n    source: plain(source.source, 200), credits: plain(source.credits, 400), version: 1, style: sanitizeIconStyle(source.style), glyphs,\n    ...(symbols ? { symbols } : {}), ...(labels ? { labels } : {}),\n  };\n}\n\n/** Parses an imported `*.icons.json`; errors are human-readable. */\nexport function parseIconPackJson(json: string): { pack: IconPack; warnings: string[] } | { error: string } {\n  if (json.length > ICON_LIMITS.packBytes) return { error: 'This icon pack is larger than 120 KB.' };\n  let raw: unknown;\n  try { raw = JSON.parse(json); } catch { return { error: 'This file is not valid JSON.' }; }\n  const pack = sanitizeIconPack(raw);\n  if (!pack) return { error: 'An icon pack needs an \"id\", a \"name\" and at least one valid glyph.' };\n  const dropped = Object.keys(obj(obj(raw).glyphs)).length - Object.keys(pack.glyphs).length;\n  const warnings: string[] = [];\n  if (dropped > 0) warnings.push(`${dropped} glyph(s) were ignored: unknown names, or drawings that are not plain path data.`);\n  if (pack.license === 'unknown') warnings.push('This pack does not say under which license its drawings are.');\n  return { pack, warnings };\n}\n\n/** The `icons` group of a theme from JSON. Null when it says nothing valid. */\nexport function sanitizeThemeIcons(value: unknown): ThemeIcons | null {\n  const source = obj(value);\n  const out: ThemeIcons = {};\n  if (typeof source.pack === 'string' && /^[a-z0-9-]{1,40}$/.test(source.pack)) out.pack = source.pack;\n  if (Object.keys(obj(source.style)).length) {\n    const style = obj(source.style), full = sanitizeIconStyle(style);\n    out.style = Object.fromEntries((['stroke', 'cap', 'join', 'scale'] as const).filter(key => key in style).map(key => [key, full[key]])) as Partial<IconStyle>;\n  }\n  const overrides = sanitizeGlyphs(source.overrides, ICON_LIMITS.overrides);\n  if (Object.keys(overrides).length) out.overrides = overrides;\n  const symbols = sanitizeSymbols(source.symbols); if (symbols) out.symbols = symbols;\n  const labels = sanitizeLabels(source.labels); if (labels) out.labels = labels;\n  return Object.keys(out).length ? out : null;\n}\n\n// ---------------------------------------------------------------------------------------------\n// The owner's choice and the catalog\n\n/** `theme`: follow the theme's suggestion; `site`: the site's own icons; otherwise a pack id. */\nexport type IconChoice = 'theme' | 'site' | string;\nexport const normalizeIconChoice = (value: unknown): IconChoice => typeof value === 'string' && /^[a-z0-9-]{1,40}$/.test(value) ? value : 'theme';\n\nexport type IconCatalog = {\n  packs: readonly IconPack[];\n  get(id: string | undefined): IconPack | null;\n  /** The pack that is drawn: the owner's pick, else the theme's suggestion; null for the site's own icons or an unknown pack. */\n  resolve(choice: IconChoice, theme: ThemeIcons | null | undefined): IconPack | null;\n};\nexport function createIconCatalog(builtins: readonly IconPack[], installed: readonly IconPack[] = []): IconCatalog {\n  const packs = [...builtins, ...installed.filter(pack => !builtins.some(item => item.id === pack.id))];\n  const get = (id: string | undefined) => packs.find(pack => pack.id === id) ?? null;\n  return { packs, get, resolve: (choice, theme) => choice === 'site' ? null : choice === 'theme' ? get(theme?.pack) : get(choice) };\n}\n\n// ---------------------------------------------------------------------------------------------\n// Drawing\n\nconst esc = (value: string) => value.replace(/[<>&\"']/g, '');\nconst paint = (fill: IconFill, colors: RoleColors | null, id: string): { attr: string; def: string } => {\n  if (typeof fill === 'string') return { attr: HEX.test(fill) ? fill : colors?.[fill as ColorRole] ?? '#000000', def: '' };\n  return { attr: `url(#${id})`, def: `<linearGradient id=\"${id}\" x1=\"0\" y1=\"0\" x2=\"0\" y2=\"1\"><stop offset=\"0\" stop-color=\"${esc(fill.from)}\"/><stop offset=\"1\" stop-color=\"${esc(fill.to)}\"/></linearGradient>` };\n};\n\n/** The SVG document of a glyph, built from validated data. `colors` resolves role fills of layers; a single path is black (it is used as a mask). */\nexport function glyphSvg(glyph: IconGlyph, style: IconStyle, colors: RoleColors | null = null): string | null {\n  const open = '<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\">';\n  if ('d' in glyph) {\n    const attrs = glyph.stroke\n      ? `fill=\"none\" stroke=\"#000\" stroke-width=\"${style.stroke}\" stroke-linecap=\"${style.cap}\" stroke-linejoin=\"${style.join}\"`\n      : `fill=\"#000\"${glyph.rule ? ' fill-rule=\"evenodd\"' : ''}`;\n    return `${open}<path d=\"${esc(glyph.d)}\" ${attrs}/></svg>`;\n  }\n  if ('layers' in glyph) {\n    const defs: string[] = [];\n    const paths = glyph.layers.map((layer, index) => {\n      const { attr, def } = paint(layer.fill, colors, `g${index}`);\n      if (def) defs.push(def);\n      return `<path d=\"${esc(layer.d)}\" fill=\"${attr}\"${layer.opacity !== undefined ? ` opacity=\"${layer.opacity}\"` : ''}${layer.rule ? ' fill-rule=\"evenodd\"' : ''}/>`;\n    });\n    return `${open}${defs.length ? `<defs>${defs.join('')}</defs>` : ''}${paths.join('')}</svg>`;\n  }\n  return null;\n}\nconst svgUrl = (svg: string) => `url(\"data:image/svg+xml,${encodeURIComponent(svg).replace(/'/g, '%27').replace(/\"/g, '%22')}\")`;\n/** True for glyphs that carry their own colors (drawn as an image, not as a mask of the current color). */\nexport const isColored = (glyph: IconGlyph) => !('d' in glyph);\n\n/** How a site finds one of its icons: the container that holds it (stable hooks), else the start of its path data. */\nexport type IconMatcher = {\n  /** Selector of the icon's `<svg>` by its container (`[data-testid=\"like\"] svg`). */\n  ctx?: string;\n  /** Prefixes of the site's own path data for this icon, for icons without a container hook. */\n  sig?: readonly string[];\n  group: IconGroup;\n  /** Needed for its group to be drawn at all (a rail never shows half ours, half the site's). */\n  core?: boolean;\n};\nexport type IconTable = Partial<Record<IconName, IconMatcher>>;\n\n/** Selectors of the `<svg>` boxes of one icon. */\nexport function iconSelectors(matcher: IconMatcher): string[] {\n  const out: string[] = [];\n  if (matcher.ctx) out.push(...matcher.ctx.split(/,(?![^(]*\\))/).map(one => one.trim()));\n  for (const prefix of matcher.sig ?? []) if (PATH_GRAMMAR.test(prefix)) out.push(`svg:has(> g > path[d^=\"${prefix}\"])`);\n  return out;\n}\n\nexport type IconContext = {\n  colors: RoleColors | null;\n  /** Attribute on `<html>` that lists the groups that are on (`data-wb-icons=\"nav actions\"`); absent: every group draws. */\n  gate?: string;\n  /** The owner lets themes and packs change icons (default: yes). */\n  allowed?: boolean;\n};\n\n/**\n * CSS that draws `pack` over a site's icons. One rule per glyph the pack has and the site's table\n * knows, inside guards: forced colors remove backgrounds (a masked icon would vanish) and an engine\n * without masks would paint solid squares.\n */\nexport function compileIcons(pack: IconPack | null, theme: ThemeIcons | null | undefined, table: IconTable, ctx: IconContext): string {\n  if (ctx.allowed === false) return '';\n  const glyphs: Partial<Record<IconName, IconGlyph>> = { ...pack?.glyphs, ...theme?.overrides };\n  const style = { ...(pack?.style ?? BASE_ICON_STYLE), ...theme?.style };\n  const masked: string[] = [], colored: string[] = [], hidden: string[] = [];\n  for (const name of ICON_NAMES) {\n    const glyph = glyphs[name], matcher = table[name];\n    if (!glyph || !matcher) continue;\n    const gate = ctx.gate ? `html[${ctx.gate}~=\"${matcher.group}\"] ` : '';\n    const selectors = iconSelectors(matcher).map(one => `${gate}${one}`);\n    if (!selectors.length) continue;\n    const size = `${Math.round(style.scale * 100)}%`;\n    if ('png' in glyph) {\n      colored.push(`${selectors.join(',')}{background:url(\"${glyph.png}\") center / ${size} no-repeat !important;${glyph.pixel ? 'image-rendering:pixelated;' : ''}}`);\n    } else {\n      const svg = glyphSvg(glyph, style, ctx.colors);\n      if (!svg) continue;\n      if (isColored(glyph)) colored.push(`${selectors.join(',')}{background:${svgUrl(svg)} center / ${size} no-repeat !important}`);\n      else masked.push(`${selectors.join(',')}{background-color:currentColor !important;-webkit-mask:${svgUrl(svg)} center / ${size} no-repeat;mask:${svgUrl(svg)} center / ${size} no-repeat}`);\n    }\n    hidden.push(...selectors.map(one => `${one} > *`));\n  }\n  if (!hidden.length) return '';\n  const hide = `${hidden.join(',')}{opacity:0 !important}`;\n  const images = colored.length ? `${colored.join('\\n')}\\n` : '';\n  // Colored glyphs need no mask support; masked ones are dropped together with their hiding rule where masks are missing.\n  if (!masked.length) return `@media (forced-colors:none){\\n${images}${hide}\\n}`;\n  return `@media (forced-colors:none){@supports ((mask-image:url(\"\")) or (-webkit-mask-image:url(\"\"))){\\n${images}${masked.join('\\n')}\\n${hide}\\n}}`;\n}\n\n/** The groups of `table` whose core icons are all on the page (`has(selector)` says whether one matches). Empty table entries count as present. */\nexport function iconGroupsPresent(table: IconTable, has: (selector: string) => boolean): IconGroup[] {\n  return ICON_GROUPS.filter(group => {\n    const core = ICON_NAMES.map(name => table[name]).filter((matcher): matcher is IconMatcher => !!matcher && matcher.group === group && !!matcher.core);\n    return core.every(matcher => iconSelectors(matcher).some(selector => { try { return has(selector); } catch { return false; } }));\n  });\n}\n"]}

package/dist/runtime/themeRuntime.d.ts

@@ -0,0 +1,100 @@
+import { type ResolvedFonts, type ResolvedTheme } from './themeApi.ts';
+import type { ThemeCatalog, ThemeChoice } from './themeChoice.ts';
+import { type FontSpec, type ThemeSpec } from './themeSpec.ts';
+/** A style rule as the engine reads it (CSSStyleRule, or a plain object in tests). */
+export type RuleLike = {
+    selectorText: string;
+    style: {
+        getPropertyValue(name: string): string;
+        length?: number;
+    };
+};
+/** The font roles as the plugin API reports them in a site's page; an inheriting interface uses `siteStack` (the site's own font). */
+export declare function resolvedFonts(font: FontSpec, siteStack: string): ResolvedFonts;
+/**
+ * Every style rule of `doc`'s stylesheets (inside media/supports groups too), except `own`'s (the
+ * engine's own sheets: read as the site's, their radii and colors would be re-declared), each as it
+ * takes effect (`effectiveRule`). A `@supports` group the browser does not pass is left out.
+ */
+export declare function collectRules(doc: Document, own: HTMLStyleElement | null | ReadonlyArray<HTMLStyleElement | null>): RuleLike[];
+type SheetLike = {
+    cssRules: CSSRuleList | ArrayLike<unknown>;
+};
+/**
+ * The same for an open shadow root the site renders a part of itself in (X's chat embed): its adopted
+ * sheets and its `<style>` elements, except the engine's own adopted `own` sheet.
+ */
+export declare function collectRootRules(root: {
+    adoptedStyleSheets?: readonly SheetLike[];
+    styleSheets?: ArrayLike<SheetLike>;
+}, own: SheetLike | null, css?: {
+    supports?(condition: string): boolean;
+}): RuleLike[];
+/**
+ * The last theme CSS a tab showed, kept in the page's own storage so the next document paints it
+ * from its first frame: native code only hands the theme over once the page has finished loading,
+ * and the live CSS needs the site's rules, which it inserts while it renders. sessionStorage is per
+ * tab and survives reloads and navigations; localStorage (smaller cap: the site uses it too) is per
+ * account and covers a tab's first document.
+ */
+export type ThemeSnapshot = {
+    key: string;
+    choice: unknown;
+    css: string;
+};
+export declare const SNAPSHOT_SESSION_MAX = 1000000;
+export declare const SNAPSHOT_LOCAL_MAX = 200000;
+export type SnapshotStores = {
+    session?: Storage | null;
+    local?: Storage | null;
+};
+export declare function readSnapshot({ session, local }: SnapshotStores): ThemeSnapshot | null;
+/** Stores `snapshot` (null clears it: the site's own look needs none), each store within its cap. */
+export declare function writeSnapshot({ session, local }: SnapshotStores, snapshot: ThemeSnapshot | null): void;
+/** What the engine needs to know about a site. `Mode` is the site's own color mode (X: light, dim, dark). */
+export type ThemeRuntimeSite<Mode extends string = string> = {
+    /** The site's built-in themes (themeChoice.ts). */
+    catalog: ThemeCatalog;
+    /** The mode before the page has a body. */
+    initialMode: Mode;
+    /** The site's color mode as the page paints it now (read before the theme's own override: e.g. the body's inline style). */
+    readMode(win: Window): Mode;
+    /** The theme's CSS for the site's current `rules` (the engine's own sheet excluded) in `mode`; `vars` are `siteVars` as the site sets them. */
+    css(rules: RuleLike[], choice: ThemeChoice, mode: Mode, vars: Record<string, string>): string;
+    /** The active theme resolved for plugins and the UI kit (the site's own palette when the theme keeps its colors). */
+    resolved(choice: ThemeChoice, mode: Mode): ResolvedTheme;
+    /** Custom properties of the site's root read with the theme's sheet disabled (their unthemed values). */
+    siteVars?: readonly string[];
+    /**
+     * The theme's CSS that does not depend on the site's stylesheet: components, variants, decoration,
+     * icons. It lives in its own sheet (`staticId`), so the site inserting rules never rebuilds it; it is
+     * rebuilt when the theme or the site's mode changes and on `refresh()` (the owner's switches, the
+     * icon choice, the language).
+     */
+    staticCss?(choice: ThemeChoice, mode: Mode): string;
+    /** Id of that sheet's `<style>` (default `wb-theme-static`). */
+    staticId?: string;
+    /** Id of the theme's `<style>` (default `wb-theme-css`). */
+    styleId?: string;
+    /** Name in console errors. */
+    name?: string;
+};
+export type ThemeHandle<Mode extends string = string> = {
+    apply(choice: unknown): void;
+    current(): ThemeChoice;
+    theme(): ThemeSpec;
+    /** The site's color mode the theme was last rendered for. */
+    mode(): Mode;
+    /** The active theme as values for plugins (`api.theme.current()`). */
+    resolved(): ResolvedTheme;
+    /** Calls `listener` after the theme or the site's color mode changes. */
+    onChange(listener: () => void): () => void;
+    /** Rebuilds the theme's CSS now: something it depends on besides the theme changed (the owner's switches, the icon choice). */
+    refresh(): void;
+};
+export type ThemeRuntimeOptions = {
+    loadFonts?(names: string[]): void;
+};
+/** Keeps the site's page in the owner's theme (see the top of this file). */
+export declare function installThemeRuntime<Mode extends string>(win: Window, site: ThemeRuntimeSite<Mode>, options?: ThemeRuntimeOptions): ThemeHandle<Mode>;
+export {};