@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/themes/style-registry.js

@@ -0,0 +1,129 @@
+"use strict";
+// Named style classes — the `classDef` / `linkStyle` equivalent.
+//
+// Styling & theming — Card "Named style classes".
+//
+//   defineStyle('critical', { stroke: '#ef4444', strokeWidth: 3 });
+//   node.setStyle({ styleClass: 'critical' });      // reference it
+//   link.updateStyle({ styleClass: 'critical' });   // …from links too
+//
+// A named style is just a bag of NodeStyle/LinkStyle properties held in a Map.
+// It is resolved to VALUES by `style-cascade.ts` (see that file for the ordered
+// cascade and for why we resolve inline rather than emitting CSS classes).
+//
+// `styleClass` accepts a space-separated LIST (`'critical dashed'`); later names
+// win, exactly like a CSS class list read left-to-right.
+//
+// Renderers subscribe via `onStyleRegistryChange` so that redefining a style
+// after nodes are already cached invalidates those cached VNodes.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineStyle = defineStyle;
+exports.defineStyles = defineStyles;
+exports.getStyle = getStyle;
+exports.hasStyle = hasStyle;
+exports.removeStyle = removeStyle;
+exports.clearStyles = clearStyles;
+exports.listStyles = listStyles;
+exports.notifyStyleRegistryChanged = notifyStyleRegistryChanged;
+exports.getStyleRegistryVersion = getStyleRegistryVersion;
+exports.onStyleRegistryChange = onStyleRegistryChange;
+exports.resolveStyleClasses = resolveStyleClasses;
+const registry_scope_1 = require("../ext/registry-scope");
+const registry = new Map();
+const listeners = new Set();
+let version = 0;
+function bump() {
+    version++;
+    listeners.forEach(listener => listener());
+}
+/**
+ * Define (or redefine) a named style. Definitions are copied, so later mutation
+ * of the caller's object has no effect.
+ */
+function defineStyle(name, style) {
+    registry.set(name, Object.assign({}, style));
+    bump();
+}
+/** Define several named styles at once. */
+function defineStyles(styles) {
+    for (const [name, style] of Object.entries(styles)) {
+        registry.set(name, Object.assign({}, style));
+    }
+    bump();
+}
+/**
+ * The raw definition, or undefined when the name was never defined.
+ *
+ * DIAGRAM-FIRST, then process-global — see `ext/registry-scope.ts`. A diagram
+ * that defined its own `critical` sees its own; one that did not still sees the
+ * app-wide definition.
+ */
+function getStyle(name) {
+    var _a, _b;
+    return (_b = (_a = (0, registry_scope_1.scopedTable)(registry_scope_1.STYLES)) === null || _a === void 0 ? void 0 : _a.get(name)) !== null && _b !== void 0 ? _b : registry.get(name);
+}
+function hasStyle(name) {
+    var _a;
+    return ((_a = (0, registry_scope_1.scopedTable)(registry_scope_1.STYLES)) === null || _a === void 0 ? void 0 : _a.has(name)) === true || registry.has(name);
+}
+function removeStyle(name) {
+    const existed = registry.delete(name);
+    if (existed)
+        bump();
+    return existed;
+}
+/** Drop every named style (tests, and hosts tearing a document down). */
+function clearStyles() {
+    if (registry.size === 0)
+        return;
+    registry.clear();
+    bump();
+}
+function listStyles() {
+    const scoped = (0, registry_scope_1.scopedTable)(registry_scope_1.STYLES);
+    if (!scoped || scoped.size === 0)
+        return Array.from(registry.keys());
+    return [...new Set([...registry.keys(), ...scoped.keys()])];
+}
+/**
+ * Internal: let a PER-DIAGRAM registry participate in the version/notify
+ * protocol. A scoped registration must invalidate cached VNodes for exactly the
+ * reason a global one must — the definition is baked into the cache. Notifying
+ * every renderer (not just the contributing one) is deliberate: over-invalidation
+ * costs a repaint, under-invalidation shows a stale picture.
+ */
+function notifyStyleRegistryChanged() {
+    bump();
+}
+/** Bumped on every mutation — renderers key cache invalidation off this. */
+function getStyleRegistryVersion() {
+    return version;
+}
+/** Subscribe to registry mutations. Returns the unsubscribe function. */
+function onStyleRegistryChange(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+/**
+ * Merge a `styleClass` list into ONE partial style. Names are applied
+ * left-to-right (later names win); unknown names are ignored.
+ */
+function resolveStyleClasses(styleClass) {
+    var _a, _b;
+    if (!styleClass)
+        return {};
+    const names = styleClass.trim().split(/\s+/).filter(Boolean);
+    if (names.length === 0)
+        return {};
+    // THE RENDER-PATH READ. `getStyle` — not `registry.get` — because this is the
+    // one lookup that decides what a node is actually painted with, and it must
+    // resolve against the diagram being painted rather than the process.
+    if (names.length === 1)
+        return ((_a = getStyle(names[0])) !== null && _a !== void 0 ? _a : {});
+    const merged = {};
+    for (const name of names) {
+        Object.assign(merged, (_b = getStyle(name)) !== null && _b !== void 0 ? _b : {});
+    }
+    return merged;
+}
+//# sourceMappingURL=style-registry.js.map

package/src/libs/renderer/src/themes/style-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-registry.js","sourceRoot":"","sources":["../../../../../../renderer/src/themes/style-registry.ts"],"names":[],"mappings":"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"}

package/src/libs/renderer/src/themes/theme-a11y.d.ts

@@ -0,0 +1,65 @@
+import type { Theme } from '../types/theme.types';
+/** One checked pair. */
+export interface ContrastCheck {
+    /** `text.primary on node.fill` — human-readable, stable enough to assert on. */
+    id: string;
+    /** Broad bucket, so callers can enforce selectively. */
+    kind: 'text' | 'selection' | 'state' | 'link' | 'port' | 'category';
+    foreground: string;
+    background: string;
+    /** Undefined when a colour could not be parsed (system colour, gradient, …). */
+    ratio?: number;
+    /** The WCAG minimum this pair is held to. */
+    required: number;
+    /** `false` only when we could measure it AND it fell short. */
+    passes: boolean;
+    /** WCAG lets disabled/inactive controls off; reported, never enforced. */
+    exempt?: boolean;
+}
+export interface ContrastReport {
+    theme: string;
+    checks: ContrastCheck[];
+    /** Non-exempt checks that failed. */
+    failures: ContrastCheck[];
+    /** True when nothing enforceable failed. */
+    passes: boolean;
+}
+/**
+ * Every contrast pair in a theme that a reader depends on.
+ *
+ * `textLevel` defaults to AA (4.5:1). Pass `WCAG.AAA_TEXT` to hold a theme to
+ * AAA — which is what the high-contrast themes are built and tested against.
+ */
+export declare function auditThemeContrast(theme: Theme, textLevel?: number): ContrastReport;
+/** Throw with a readable diff when a theme does not conform. Use in tests/CI. */
+export declare function assertThemeContrast(theme: Theme, textLevel?: number): void;
+export interface DeriveThemeOptions {
+    /** The theme to derive FROM (normally a hand-tuned light theme). */
+    from: Theme;
+    /**
+     * What to build:
+     *   'dark'           — the dark counterpart (flip the surfaces, keep the hues)
+     *   'high-contrast'  — same colour scheme, pushed to AAA text / strong strokes
+     */
+    mode: 'dark' | 'high-contrast';
+    /** Name of the result. Defaults to `"<from> (Dark)"` / `"<from> (High Contrast)"`. */
+    name?: string;
+    /** Text level the result is repaired to. Default AA; the HC themes use AAA. */
+    textLevel?: number;
+}
+/**
+ * Auto-derive a theme from another one, then PROVE it conforms.
+ *
+ * The generation step is deliberately dumb (flip lightness for 'dark', keep the
+ * palette for 'high-contrast'); the value is in the second step, which walks the
+ * SAME audit the caller can run and repairs every enforceable failure with
+ * `ensureContrast`. The result is asserted before it is returned, so a derived
+ * theme that could not be repaired is a loud error, never a subtly unreadable
+ * diagram.
+ *
+ * Derived alongside the surfaces: the STATE colours (selected / highlighted /
+ * hovered / disabled / error), the SECONDARY text, and the semantic category
+ * palette — i.e. everything a theme swap has to move together for the diagram to
+ * stay coherent.
+ */
+export declare function deriveTheme(options: DeriveThemeOptions): Theme;

package/src/libs/renderer/src/themes/theme-a11y.js

@@ -0,0 +1,256 @@
+"use strict";
+// Accessibility-aware theming: audit a theme, and derive one that PASSES.
+//
+// Styling & theming, Card "design-token bridge + accessibility-aware theming".
+//
+// Two things live here, and they are the same thing twice:
+//
+//   auditThemeContrast(theme)   — every contrast pair a reader actually depends
+//                                 on, checked against WCAG, as DATA.
+//   deriveTheme({ from, mode }) — build the counterpart theme (dark from light,
+//                                 high-contrast from either) and then RUN THAT
+//                                 AUDIT on the result, repairing any pair that
+//                                 fails.
+//
+// The derive utility is only trustworthy because the audit exists: a generated
+// palette that was never checked is a guess. `deriveTheme` guarantees its output
+// clears the level it was asked for, or it throws — which is what lets the
+// built-in high-contrast themes be *validated* rather than asserted by hand.
+//
+// WHICH PAIRS. Not every combination — the ones a user reads:
+//   text        label colour on the node surface, and on the canvas
+//   selection   the selected node's stroke against its own fill, and against the
+//               canvas (a selection ring you cannot see is a keyboard-navigation
+//               dead end — this is the closest thing we have to a focus ring, and
+//               it is what selection-follows-focus paints)
+//   states      highlighted / error / hovered / disabled strokes vs their fills
+//   links       the link stroke against the canvas background
+//   ports       each port colour against the port fill
+//   categories  every semantic colour the host can bind (Card "Theme-bound
+//               properties") against the node surface it will sit on
+//
+// Non-text UI (strokes, rings, graphical objects) is held to WCAG 1.4.11's 3:1;
+// text to 1.4.3's 4.5:1. `disabled` is exempt by 1.4.3 itself and is reported
+// but never enforced.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditThemeContrast = auditThemeContrast;
+exports.assertThemeContrast = assertThemeContrast;
+exports.deriveTheme = deriveTheme;
+const contrast_1 = require("./contrast");
+function check(id, kind, foreground, background, required, exempt = false) {
+    const ratio = (0, contrast_1.contrastRatio)(foreground, background);
+    return Object.assign({ id,
+        kind,
+        foreground,
+        background,
+        ratio,
+        required, 
+        // An unmeasurable pair is not a failure (it is a system colour the OS
+        // guarantees, or a paint server) — but it is never silently a pass either:
+        // `ratio` stays undefined and the caller can see that.
+        passes: ratio === undefined ? true : ratio >= required - 1e-9 }, (exempt ? { exempt } : {}));
+}
+/**
+ * Every contrast pair in a theme that a reader depends on.
+ *
+ * `textLevel` defaults to AA (4.5:1). Pass `WCAG.AAA_TEXT` to hold a theme to
+ * AAA — which is what the high-contrast themes are built and tested against.
+ */
+function auditThemeContrast(theme, textLevel = contrast_1.WCAG.AA_TEXT) {
+    var _a;
+    const c = theme.colors;
+    const canvas = c.background.default;
+    const surface = c.node.default.fill;
+    const checks = [];
+    // ---- text ---------------------------------------------------------------
+    checks.push(check('text.primary on node.fill', 'text', c.text.primary, surface, textLevel));
+    checks.push(check('text.primary on background', 'text', c.text.primary, canvas, textLevel));
+    checks.push(check('text.secondary on background', 'text', c.text.secondary, canvas, textLevel));
+    checks.push(check('text.disabled on background', 'text', c.text.disabled, canvas, textLevel, true));
+    // The label a selected node carries still has to be readable on the SELECTED
+    // fill — the pair a light-on-light selection tint quietly breaks.
+    checks.push(check('text.primary on node.selected.fill', 'text', c.text.primary, c.node.selected.fill, textLevel));
+    checks.push(check('text.primary on node.highlighted.fill', 'text', c.text.primary, c.node.highlighted.fill, textLevel));
+    // ---- selection (our focus indicator) ------------------------------------
+    checks.push(check('node.selected.stroke on node.selected.fill', 'selection', c.node.selected.stroke, c.node.selected.fill, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('node.selected.stroke on background', 'selection', c.node.selected.stroke, canvas, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('link.selected on background', 'selection', c.link.selected, canvas, contrast_1.WCAG.AA_NON_TEXT));
+    // ---- other states -------------------------------------------------------
+    checks.push(check('node.highlighted.stroke on node.highlighted.fill', 'state', c.node.highlighted.stroke, c.node.highlighted.fill, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('node.error.stroke on node.error.fill', 'state', c.node.error.stroke, c.node.error.fill, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('node.default.stroke on background', 'state', c.node.default.stroke, canvas, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('node.disabled.stroke on node.disabled.fill', 'state', c.node.disabled.stroke, c.node.disabled.fill, contrast_1.WCAG.AA_NON_TEXT, true));
+    // ---- links --------------------------------------------------------------
+    checks.push(check('link.default on background', 'link', c.link.default, canvas, contrast_1.WCAG.AA_NON_TEXT));
+    checks.push(check('link.highlighted on background', 'link', c.link.highlighted, canvas, contrast_1.WCAG.AA_NON_TEXT));
+    // ---- ports --------------------------------------------------------------
+    const portFill = c.background.surface;
+    for (const kind of ['input', 'output', 'bi']) {
+        checks.push(check(`port.${kind} on port fill`, 'port', c.port[kind], portFill, contrast_1.WCAG.AA_NON_TEXT));
+    }
+    // ---- the caller's semantic palette (Card "Theme-bound properties") -------
+    // These are colours the host BINDS to nodes; if they fail on the node surface,
+    // theme-bound properties are the thing that made the diagram unreadable.
+    for (const [name, value] of Object.entries((_a = theme.categories) !== null && _a !== void 0 ? _a : {})) {
+        if (!value)
+            continue;
+        checks.push(check(`category.${name} on node.fill`, 'category', value, surface, contrast_1.WCAG.AA_NON_TEXT));
+    }
+    const failures = checks.filter(item => !item.passes && !item.exempt);
+    return {
+        theme: theme.name,
+        checks,
+        failures,
+        passes: failures.length === 0,
+    };
+}
+/** Throw with a readable diff when a theme does not conform. Use in tests/CI. */
+function assertThemeContrast(theme, textLevel = contrast_1.WCAG.AA_TEXT) {
+    const report = auditThemeContrast(theme, textLevel);
+    if (report.passes)
+        return;
+    const lines = report.failures.map(f => { var _a, _b; return `  ${f.id}: ${(_b = (_a = f.ratio) === null || _a === void 0 ? void 0 : _a.toFixed(2)) !== null && _b !== void 0 ? _b : '?'}:1 (needs ${f.required}:1) — ${f.foreground} on ${f.background}`; });
+    throw new Error(`Theme "${theme.name}" fails WCAG contrast:\n${lines.join('\n')}`);
+}
+/**
+ * The light↔dark flip: same hue, same saturation, MIRRORED HSL LIGHTNESS.
+ *
+ * Two wrong ways this could have been done, both of which we tried:
+ *
+ *   `255 - c` (channel inversion) rotates the hue — a blue node border comes back
+ *   yellow. Useless.
+ *
+ *   Mirroring RELATIVE LUMINANCE (`L' = 1 - L`, blending toward white/black to
+ *   reach it) keeps the hue but destroys the SATURATION: to lift the light
+ *   theme's deep red `#b91c1c` to the mirrored luminance you must blend it almost
+ *   all the way to white, and it lands as `#faf0f0` — a pale pink. Every semantic
+ *   category came back as a different shade of near-white, i.e. indistinguishable.
+ *   (Found by actually printing the derived theme, not by reading the code.)
+ *
+ * HSL lightness is the axis that means "light↔dark" and nothing else, so flipping
+ * it — and only it — is the operation this actually wanted all along.
+ *
+ * Clamped away from the poles: a pure `#ffffff` mirrors to `#000000`, and a theme
+ * built out of absolute black has nowhere left to go for elevation.
+ */
+const DARK_L_FLOOR = 0.07;
+const DARK_L_CEILING = 0.96;
+function flipLightness(hex) {
+    const l = (0, contrast_1.lightnessOf)(hex);
+    if (l === undefined)
+        return hex;
+    return (0, contrast_1.withLightness)(hex, Math.min(DARK_L_CEILING, Math.max(DARK_L_FLOOR, 1 - l)));
+}
+/**
+ * A SURFACE in the derived dark theme: flipped, then floated above the canvas.
+ *
+ * Flipping alone collapses surfaces together — a light theme's `#ffffff` canvas
+ * and `#f9fafb` node fill both mirror to the floor and become the same colour, so
+ * the nodes vanish into the background. Real dark themes separate surfaces by
+ * ELEVATION (higher = lighter), which is what `step` is: the surface is
+ * guaranteed to sit at least that far above the canvas in lightness.
+ */
+function darkSurface(hex, canvasLightness, step) {
+    var _a;
+    const flipped = flipLightness(hex);
+    const l = (_a = (0, contrast_1.lightnessOf)(flipped)) !== null && _a !== void 0 ? _a : 0;
+    const lifted = Math.max(l, canvasLightness + step);
+    return (0, contrast_1.withLightness)(flipped, Math.min(DARK_L_CEILING, lifted));
+}
+/** Push a colour away from `background` until it clears `minimum`. */
+function intensify(hex, background, minimum) {
+    return (0, contrast_1.ensureContrast)(hex, background, minimum);
+}
+/**
+ * Auto-derive a theme from another one, then PROVE it conforms.
+ *
+ * The generation step is deliberately dumb (flip lightness for 'dark', keep the
+ * palette for 'high-contrast'); the value is in the second step, which walks the
+ * SAME audit the caller can run and repairs every enforceable failure with
+ * `ensureContrast`. The result is asserted before it is returned, so a derived
+ * theme that could not be repaired is a loud error, never a subtly unreadable
+ * diagram.
+ *
+ * Derived alongside the surfaces: the STATE colours (selected / highlighted /
+ * hovered / disabled / error), the SECONDARY text, and the semantic category
+ * palette — i.e. everything a theme swap has to move together for the diagram to
+ * stay coherent.
+ */
+function deriveTheme(options) {
+    var _a, _b, _c, _d, _e, _f;
+    const { from, mode } = options;
+    const textLevel = (_a = options.textLevel) !== null && _a !== void 0 ? _a : (mode === 'high-contrast' ? contrast_1.WCAG.AAA_TEXT : contrast_1.WCAG.AA_TEXT);
+    const dark = mode === 'dark';
+    const strokeMin = mode === 'high-contrast' ? contrast_1.WCAG.AA_TEXT : contrast_1.WCAG.AA_NON_TEXT;
+    /** Foreground colours (strokes, text, semantic hues): flip, keep the hue. */
+    const fg = (hex) => (dark ? flipLightness(hex) : hex);
+    const canvas = dark ? flipLightness(from.colors.background.default) : from.colors.background.default;
+    const canvasL = (_b = (0, contrast_1.lightnessOf)(canvas)) !== null && _b !== void 0 ? _b : 0;
+    /** Backgrounds/fills: flip AND float above the canvas, or they merge into it. */
+    const bg = (hex, step = 0.06) => (dark ? darkSurface(hex, canvasL, step) : hex);
+    const surface = bg(from.colors.node.default.fill);
+    const portFill = bg(from.colors.background.surface);
+    // A state's fill is floated a little higher than a plain node's, so a selected
+    // node reads as raised even before its stroke is considered.
+    const nodeState = (state) => {
+        const fill = bg(state.fill, 0.1);
+        return { fill, stroke: intensify(fg(state.stroke), fill, strokeMin) };
+    };
+    const colors = {
+        background: {
+            default: canvas,
+            surface: portFill,
+            elevated: bg(from.colors.background.elevated, 0.12),
+        },
+        text: {
+            primary: (0, contrast_1.ensureContrast)(fg(from.colors.text.primary), surface, textLevel),
+            secondary: (0, contrast_1.ensureContrast)(fg(from.colors.text.secondary), canvas, textLevel),
+            disabled: fg(from.colors.text.disabled),
+            inverse: fg(from.colors.text.inverse),
+        },
+        node: {
+            default: { fill: surface, stroke: intensify(fg(from.colors.node.default.stroke), canvas, strokeMin) },
+            selected: nodeState(from.colors.node.selected),
+            highlighted: nodeState(from.colors.node.highlighted),
+            hovered: nodeState(from.colors.node.hovered),
+            // Disabled is WCAG-exempt: keep it visually recessive rather than forcing it.
+            disabled: { fill: bg(from.colors.node.disabled.fill), stroke: fg(from.colors.node.disabled.stroke) },
+            error: nodeState(from.colors.node.error),
+        },
+        link: {
+            default: intensify(fg(from.colors.link.default), canvas, strokeMin),
+            selected: intensify(fg(from.colors.link.selected), canvas, strokeMin),
+            highlighted: intensify(fg(from.colors.link.highlighted), canvas, strokeMin),
+            hovered: intensify(fg(from.colors.link.hovered), canvas, strokeMin),
+            disabled: fg(from.colors.link.disabled),
+        },
+        port: {
+            input: intensify(fg(from.colors.port.input), portFill, strokeMin),
+            output: intensify(fg(from.colors.port.output), portFill, strokeMin),
+            bi: intensify(fg(from.colors.port.bi), portFill, strokeMin),
+        },
+        primary: intensify(fg(from.colors.primary), canvas, strokeMin),
+        secondary: intensify(fg(from.colors.secondary), canvas, strokeMin),
+        success: intensify(fg(from.colors.success), canvas, strokeMin),
+        warning: intensify(fg(from.colors.warning), canvas, strokeMin),
+        error: intensify(fg(from.colors.error), canvas, strokeMin),
+        info: intensify(fg(from.colors.info), canvas, strokeMin),
+    };
+    // The semantic palette rides along: a category colour that stops being legible
+    // on the new surface is exactly the failure theme-bound properties exist to
+    // prevent.
+    const categories = {};
+    for (const [name, value] of Object.entries((_c = from.categories) !== null && _c !== void 0 ? _c : {})) {
+        if (value)
+            categories[name] = intensify(fg(value), surface, contrast_1.WCAG.AA_NON_TEXT);
+    }
+    // High contrast also THICKENS: a 1px hairline is not an accessible border no
+    // matter how well it contrasts.
+    const numbers = mode === 'high-contrast'
+        ? Object.assign(Object.assign({}, ((_d = from.numbers) !== null && _d !== void 0 ? _d : {})), { hairline: 2, regular: 3, emphasis: 4, heavy: 5 }) : Object.assign({}, ((_e = from.numbers) !== null && _e !== void 0 ? _e : {}));
+    const theme = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, from), { name: (_f = options.name) !== null && _f !== void 0 ? _f : `${from.name} (${mode === 'dark' ? 'Dark' : 'High Contrast'})`, colors }), (Object.keys(categories).length ? { categories } : {})), (Object.keys(numbers).length ? { numbers } : {})), { nodes: Object.assign(Object.assign({}, from.nodes), { default: Object.assign(Object.assign({}, from.nodes.default), { fill: colors.node.default.fill, stroke: colors.node.default.stroke, strokeWidth: mode === 'high-contrast' ? Math.max(2, from.nodes.default.strokeWidth) : from.nodes.default.strokeWidth }) }), links: Object.assign(Object.assign({}, from.links), { default: Object.assign(Object.assign({}, from.links.default), { stroke: colors.link.default, strokeWidth: mode === 'high-contrast' ? Math.max(3, from.links.default.strokeWidth) : from.links.default.strokeWidth }) }), ports: Object.assign(Object.assign({}, from.ports), { colors: Object.assign({}, colors.port) }) });
+    // The whole point: a derived theme that does not conform is a bug, not a theme.
+    assertThemeContrast(theme, textLevel);
+    return theme;
+}
+//# sourceMappingURL=theme-a11y.js.map

package/src/libs/renderer/src/themes/theme-a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-a11y.js","sourceRoot":"","sources":["../../../../../../renderer/src/themes/theme-a11y.ts"],"names":[],"mappings":"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"}

package/src/libs/renderer/src/themes/theme-css.d.ts

@@ -0,0 +1,30 @@
+import type { Theme } from '../types/theme.types';
+/** A single CSS rule in the shared stylesheet. */
+export interface StyleRule {
+    /** Selector WITHOUT the instance scope (added by {@link generateBaseStyleSheet}). */
+    selector: string;
+    /** Declarations, in CSS property form (`stroke-width`, not `strokeWidth`). */
+    decls: Record<string, string>;
+}
+/**
+ * Every themed rule the renderer ships, in cascade order.
+ *
+ * INVARIANT (pinned by svg-renderer.scoped-theme.spec): no rule here may carry a
+ * theme literal — every painted value resolves through `var(--grafloria-*)`, and
+ * every referenced variable is declared in {@link THEME_VARS}. `fill: none` on
+ * links is structural (a link is a stroke, never a fill), not a theme value.
+ */
+export declare const BASE_STYLE_RULES: readonly StyleRule[];
+/** `[data-grafloria-instance="grafloria-3"]` — selects one diagram's root (and scoped hosts). */
+export declare function instanceScopeSelector(instanceId: string): string;
+/**
+ * The shared, theme-INDEPENDENT stylesheet. Identical for every renderer on the
+ * page, so it is injected once and deduped by element id.
+ */
+export declare function generateBaseStyleSheet(): string;
+/**
+ * One renderer's variable block: the ONLY place a theme's values are written.
+ * Scoped to that renderer's root, so a second diagram with a different theme
+ * cannot be repainted by it.
+ */
+export declare function generateInstanceVarBlock(theme: Theme, instanceId: string): string;