@jini-ai/ui 0.3.14 → 0.4.1

package/dist/theme/types.d.ts

@@ -0,0 +1,39 @@
+/** The intentionally small palette every admin theme supplies in both schemes. */
+export interface AdminThemeColors {
+    readonly primary: string;
+    readonly primaryInk: string;
+    readonly bg: string;
+    readonly surface: string;
+    readonly text: string;
+    readonly muted: string;
+    readonly border: string;
+    readonly danger: string;
+    readonly success: string;
+    readonly warning: string;
+}
+/** Product fonts and palette are data. Font loading URLs are stylesheet URLs. */
+export interface AdminTheme {
+    readonly name: string;
+    readonly fonts: {
+        readonly body: string;
+        readonly heading: string;
+        readonly mono?: string;
+        readonly load?: readonly string[];
+    };
+    readonly light: AdminThemeColors;
+    readonly dark: AdminThemeColors;
+    readonly radius?: string;
+    /** Unitless spacing multiplier, from 0.5 to 2. */
+    readonly density?: number;
+}
+export type ColorScheme = 'light' | 'dark';
+export type ColorSchemePreference = ColorScheme | 'system';
+export type MatchMediaPort = (query: string) => {
+    readonly matches: boolean;
+    addEventListener?: (type: 'change', listener: () => void) => void;
+    removeEventListener?: (type: 'change', listener: () => void) => void;
+};
+/** Only these DOM capabilities are needed; no ambient document is consulted. */
+export type AdminThemeTarget = Pick<HTMLElement, 'style' | 'getAttribute' | 'setAttribute' | 'removeAttribute'>;
+export type AdminThemeDocument = Pick<Document, 'head' | 'createElement' | 'baseURI'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/theme/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/theme/validation.d.ts

@@ -0,0 +1,15 @@
+import type { AdminTheme } from './types.js';
+export declare const adminThemeColorKeys: readonly ["primary", "primaryInk", "bg", "surface", "text", "muted", "border", "danger", "success", "warning"];
+type Validation = {
+    readonly valid: true;
+    readonly theme: AdminTheme;
+} | {
+    readonly valid: false;
+    readonly errors: readonly string[];
+};
+/** Validate serializable theme data before any DOM or font-loading effect. */
+export declare function validateAdminTheme({ theme }: {
+    readonly theme: unknown;
+}): Validation;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/theme/validation.js

@@ -0,0 +1,55 @@
+export const adminThemeColorKeys = ['primary', 'primaryInk', 'bg', 'surface', 'text', 'muted', 'border', 'danger', 'success', 'warning'];
+const record = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const safeValue = (value) => typeof value === 'string' && value.trim().length > 0
+    && value.length <= 512 && !/[;{}\x00-\x1f<>\\]/.test(value) && !/url\s*\(|\/\*|\*\//i.test(value);
+// Concrete palette values, deliberately excluding dependent var()/url() expressions.
+const component = '(?:[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:%|deg|rad|grad|turn)?|none)';
+const components = new RegExp(`^(?:rgb|rgba|hsl|hsla|oklch|oklab|lab|lch)\\(\\s*${component}(?:\\s*,\\s*|\\s+)${component}(?:\\s*,\\s*|\\s+)${component}(?:(?:\\s*[,/]\\s*)${component})?\\s*\\)$`, 'i');
+const colorValue = (value) => safeValue(value)
+    && (/^#[\da-f]{3}(?:[\da-f]{1}|[\da-f]{3}|[\da-f]{5})?$/i.test(value)
+        || components.test(value)
+        || /^(?:transparent|black|white|red|green|blue|gray|grey)$/i.test(value));
+/** Validate serializable theme data before any DOM or font-loading effect. */
+export function validateAdminTheme({ theme }) {
+    const errors = [];
+    if (!record(theme))
+        return { valid: false, errors: ['Theme must be an object'] };
+    if (!safeValue(theme.name))
+        errors.push('name must be a nonempty safe string');
+    const fonts = theme.fonts;
+    if (!record(fonts) || !safeValue(fonts.body) || !safeValue(fonts.heading) || (fonts.mono !== undefined && !safeValue(fonts.mono))) {
+        errors.push('fonts must provide body and heading font stacks');
+    }
+    if (record(fonts) && fonts.load !== undefined) {
+        if (!Array.isArray(fonts.load) || fonts.load.length > 16 || !fonts.load.every((url) => {
+            if (typeof url !== 'string' || url.length > 4096 || /[\x00-\x20<>]/.test(url))
+                return false;
+            try {
+                return new URL(url, 'https://font-base.invalid').protocol === 'https:';
+            }
+            catch {
+                return false;
+            }
+        }))
+            errors.push('fonts.load must contain relative or HTTPS stylesheet URLs');
+    }
+    for (const scheme of ['light', 'dark']) {
+        const colors = theme[scheme];
+        if (!record(colors)) {
+            errors.push(`${scheme} must be a complete palette`);
+            continue;
+        }
+        for (const key of adminThemeColorKeys)
+            if (!Object.hasOwn(colors, key) || !colorValue(colors[key]))
+                errors.push(`${scheme}.${key} must be a concrete CSS color`);
+        for (const key of Object.keys(colors))
+            if (!adminThemeColorKeys.includes(key))
+                errors.push(`${scheme}.${key} is not a theme color`);
+    }
+    if (theme.radius !== undefined && (typeof theme.radius !== 'string' || !/^(?:0|\d+(?:\.\d+)?(?:px|rem|em))$/.test(theme.radius)))
+        errors.push('radius must be a nonnegative CSS length');
+    if (theme.density !== undefined && (typeof theme.density !== 'number' || !Number.isFinite(theme.density) || theme.density < 0.5 || theme.density > 2))
+        errors.push('density must be between 0.5 and 2');
+    return errors.length ? { valid: false, errors } : { valid: true, theme: theme };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/appearance.js

@@ -30,7 +30,7 @@ export function applyAppearanceToDocument({ theme, accentColor, }) {
     else {
         root.removeAttribute('data-theme');
     }
-    const vars = accentVars(resolveAccentColor(accentColor));
+    const vars = accentVars({ accentColor: resolveAccentColor({ value: accentColor }) });
     for (const name of Object.keys(vars)) {
         root.style.setProperty(name, vars[name]);
     }

package/dist/utils/browser-request.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Browser transport defaults stay here rather than importing a Node package.
+ * Preserve a caller's cancellation alongside the deadline; fetch keeps its native ABI.
+ */
+export declare function requestWithTimeout({ url, timeoutMs }: {
+    url: string | URL;
+    timeoutMs: number;
+}, { fetch, init }?: {
+    fetch?: typeof globalThis.fetch;
+    init?: RequestInit;
+}): Promise<Response>;
+//# sourceMappingURL=browser-request.d.ts.map

package/dist/utils/browser-request.js

@@ -0,0 +1,10 @@
+/**
+ * Browser transport defaults stay here rather than importing a Node package.
+ * Preserve a caller's cancellation alongside the deadline; fetch keeps its native ABI.
+ */
+export function requestWithTimeout({ url, timeoutMs }, { fetch, init = {} } = {}) {
+    const timeout = AbortSignal.timeout(timeoutMs);
+    const signal = init.signal ? AbortSignal.any([init.signal, timeout]) : timeout;
+    return (fetch ?? globalThis.fetch)(url, { ...init, signal });
+}
+//# sourceMappingURL=browser-request.js.map

package/dist/utils/color-math.d.ts

@@ -10,25 +10,39 @@ export interface Rgb {
  * channel dropped. Returns `null` if `value` is undefined or contains no
  * hex-color-shaped substring.
  */
-export declare function normalizeHex(value: string | undefined): string | null;
+export declare function normalizeHex({ value }: {
+    value: string | undefined;
+}): string | null;
 /** Decodes a hex color string to `{ r, g, b }` (0-255 each), or `null` if it doesn't normalize to a valid hex color. */
-export declare function hexToRgb(hex: string): Rgb | null;
+export declare function hexToRgb({ hex }: {
+    hex: string;
+}): Rgb | null;
 /**
  * Perceptual luminance of `hex` in `[0, 1]` via the ITU-R BT.709 luma
  * weights (0.2126R + 0.7152G + 0.0722B). Not true WCAG relative luminance —
  * see the module doc comment. Returns `1` (treated as "light") if `hex`
  * doesn't decode to a valid color.
  */
-export declare function luminance(hex: string): number;
+export declare function luminance({ hex }: {
+    hex: string;
+}): number;
 /** Clamps `value` to `[0, 255]` and formats it as a 2-digit lowercase hex byte. */
-export declare function toHexByte(value: number): string;
+export declare function toHexByte({ value }: {
+    value: number;
+}): string;
 /**
  * Linearly mixes `hex` and `other` in RGB space. `weight` is `hex`'s share
  * of the result, clamped to `[0, 1]` (`1` returns `hex`, `0` returns
  * `other`). A color that fails to decode falls back to black (`hex`) or
  * white (`other`) respectively, so the mix is still well-defined.
  */
-export declare function mixHex(hex: string, other: string, weight: number): string;
+export declare function mixHex({ hex, other, weight }: {
+    hex: string;
+    other: string;
+    weight: number;
+}): string;
 /** Picks `#111111` (near-black) or `#ffffff` (white) as the more readable text color for a `hex` background, using {@link luminance}. */
-export declare function readableTextColor(hex: string): string;
+export declare function readableTextColor({ hex }: {
+    hex: string;
+}): string;
 //# sourceMappingURL=color-math.d.ts.map

package/dist/utils/color-math.js

@@ -16,7 +16,7 @@
  * channel dropped. Returns `null` if `value` is undefined or contains no
  * hex-color-shaped substring.
  */
-export function normalizeHex(value) {
+export function normalizeHex({ value }) {
     const match = value?.match(/#[0-9a-fA-F]{3}\b|#[0-9a-fA-F]{6}\b|#[0-9a-fA-F]{8}\b/);
     if (!match)
         return null;
@@ -29,8 +29,8 @@ export function normalizeHex(value) {
     return raw;
 }
 /** Decodes a hex color string to `{ r, g, b }` (0-255 each), or `null` if it doesn't normalize to a valid hex color. */
-export function hexToRgb(hex) {
-    const normalized = normalizeHex(hex);
+export function hexToRgb({ hex }) {
+    const normalized = normalizeHex({ value: hex });
     if (!normalized)
         return null;
     return {
@@ -45,14 +45,14 @@ export function hexToRgb(hex) {
  * see the module doc comment. Returns `1` (treated as "light") if `hex`
  * doesn't decode to a valid color.
  */
-export function luminance(hex) {
-    const rgb = hexToRgb(hex);
+export function luminance({ hex }) {
+    const rgb = hexToRgb({ hex });
     if (!rgb)
         return 1;
     return (0.2126 * rgb.r + 0.7152 * rgb.g + 0.0722 * rgb.b) / 255;
 }
 /** Clamps `value` to `[0, 255]` and formats it as a 2-digit lowercase hex byte. */
-export function toHexByte(value) {
+export function toHexByte({ value }) {
     return Math.max(0, Math.min(255, value)).toString(16).padStart(2, '0');
 }
 /**
@@ -61,19 +61,19 @@ export function toHexByte(value) {
  * `other`). A color that fails to decode falls back to black (`hex`) or
  * white (`other`) respectively, so the mix is still well-defined.
  */
-export function mixHex(hex, other, weight) {
-    const a = hexToRgb(hex) ?? { r: 0, g: 0, b: 0 };
-    const b = hexToRgb(other) ?? { r: 255, g: 255, b: 255 };
+export function mixHex({ hex, other, weight }) {
+    const a = hexToRgb({ hex }) ?? { r: 0, g: 0, b: 0 };
+    const b = hexToRgb({ hex: other }) ?? { r: 255, g: 255, b: 255 };
     const clampedWeight = Math.max(0, Math.min(1, weight));
     const mixed = {
         r: Math.round(a.r * clampedWeight + b.r * (1 - clampedWeight)),
         g: Math.round(a.g * clampedWeight + b.g * (1 - clampedWeight)),
         b: Math.round(a.b * clampedWeight + b.b * (1 - clampedWeight)),
     };
-    return `#${toHexByte(mixed.r)}${toHexByte(mixed.g)}${toHexByte(mixed.b)}`;
+    return `#${toHexByte({ value: mixed.r })}${toHexByte({ value: mixed.g })}${toHexByte({ value: mixed.b })}`;
 }
 /** Picks `#111111` (near-black) or `#ffffff` (white) as the more readable text color for a `hex` background, using {@link luminance}. */
-export function readableTextColor(hex) {
-    return luminance(hex) > 0.56 ? '#111111' : '#ffffff';
+export function readableTextColor({ hex }) {
+    return luminance({ hex }) > 0.56 ? '#111111' : '#ffffff';
 }
 //# sourceMappingURL=color-math.js.map

package/dist/utils/copy-to-clipboard.d.ts

@@ -1,11 +1,22 @@
+export interface ClipboardWritePort {
+    writeText(requiredArgs: {
+        text: string;
+    }): Promise<void>;
+}
+export interface CopyToClipboardOptions {
+    clipboard?: ClipboardWritePort;
+    document?: Document;
+    isHTMLElement?: (requiredArgs: {
+        value: Element | null;
+    }) => boolean;
+}
 /**
- * Copy `text` to the system clipboard.
- *
- * @param text - The text to place on the clipboard.
- * @returns `true` on success (either path), `false` when both the Clipboard
- *   API and the `execCommand('copy')` fallback fail.
- * @complexity O(1) — a single clipboard write, with a bounded-size DOM
- *   fallback (create/select/copy/remove one textarea) on rejection.
+ * Copy `requiredArgs.text` to the system clipboard.
+ * Optional ports replace the clipboard writer, fallback document and element check.
+ * Returns true on success through either strategy, false when both writes fail.
+ * O(1): one clipboard write and a single temporary textarea on rejection.
  */
-export declare function copyToClipboard(text: string): Promise<boolean>;
+export declare function copyToClipboard({ text }: {
+    text: string;
+}, options?: CopyToClipboardOptions): Promise<boolean>;
 //# sourceMappingURL=copy-to-clipboard.d.ts.map

package/dist/utils/copy-to-clipboard.js

@@ -3,21 +3,25 @@
 // locked-clipboard contexts, or insecure (HTTP) origins where
 // navigator.clipboard.writeText rejects.
 /**
- * Copy `text` to the system clipboard.
- *
- * @param text - The text to place on the clipboard.
- * @returns `true` on success (either path), `false` when both the Clipboard
- *   API and the `execCommand('copy')` fallback fail.
- * @complexity O(1) — a single clipboard write, with a bounded-size DOM
- *   fallback (create/select/copy/remove one textarea) on rejection.
+ * Copy `requiredArgs.text` to the system clipboard.
+ * Optional ports replace the clipboard writer, fallback document and element check.
+ * Returns true on success through either strategy, false when both writes fail.
+ * O(1): one clipboard write and a single temporary textarea on rejection.
  */
-export async function copyToClipboard(text) {
+export async function copyToClipboard({ text }, options = {}) {
     try {
-        await navigator.clipboard.writeText(text);
+        if (options.clipboard)
+            await options.clipboard.writeText({ text });
+        else
+            await navigator.clipboard.writeText(text);
         return true;
     }
     catch {
-        const priorFocus = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+        const document = options.document ?? globalThis.document;
+        const isHTMLElement = options.isHTMLElement ?? (({ value }) => value instanceof HTMLElement);
+        const priorFocus = isHTMLElement({ value: document.activeElement })
+            ? document.activeElement
+            : null;
         const ta = document.createElement('textarea');
         ta.value = text;
         ta.style.position = 'fixed';
@@ -30,7 +34,7 @@ export async function copyToClipboard(text) {
         // "abrupt completion through finally" branch permanently unreachable —
         // same dead-branch discipline as this repo's `daemon/tool-executor.ts`
         // and `packages/ui`'s `useMemoryExtractions.hooks.ts` precedents (see
-        // packages/ui/source-map.md's 2026-07-22 dated entry).
+        // packages/ui/archived provenance ledger's 2026-07-22 dated entry).
         const cleanup = () => {
             document.body.removeChild(ta);
             if (priorFocus?.isConnected) {

package/dist/utils/dom-subscriptions.js

@@ -7,7 +7,7 @@
 // Ported from a chat-surface-scoped `providers/dom/*.dom.ts` pair in the
 // source project, where these were filed under one feature's "DOM bridges"
 // despite having no feature-specific logic in their bodies — see
-// packages/ui/source-map.md for the reclassification note.
+// packages/ui/archived provenance ledger for the reclassification note.
 /** The current viewport size, or a zero-size fallback outside the browser (SSR). */
 export function getViewportSize() {
     if (typeof window === 'undefined')

package/dist/utils/endpoint-policy.d.ts

@@ -47,9 +47,13 @@
  * are a first-class configuration, not an attack.
  */
 /** True for `localhost`, `::1`, `127.0.0.0/8`, and their IPv4-mapped-IPv6 forms. Allowed — local model servers live here. */
-export declare function isLoopbackEndpointHost(hostname: string): boolean;
+export declare function isLoopbackEndpointHost({ hostname }: {
+    hostname: string;
+}): boolean;
 /** True for RFC1918/link-local/CGNAT/multicast/unspecified/unique-local-IPv6 literals — private space a credentialed request must not be steered into. */
-export declare function isBlockedEndpointHost(hostname: string): boolean;
+export declare function isBlockedEndpointHost({ hostname }: {
+    hostname: string;
+}): boolean;
 /**
  * Whether `raw` is an endpoint this UI will accept: an absolute `http(s)` URL
  * whose literal hostname is not private address space.
@@ -61,5 +65,7 @@ export declare function isBlockedEndpointHost(hostname: string): boolean;
  * time. This is the cheap check that runs on every keystroke, not the last
  * line of defense.
  */
-export declare function isAllowedEndpointUrl(raw: string): boolean;
+export declare function isAllowedEndpointUrl({ raw }: {
+    raw: string;
+}): boolean;
 //# sourceMappingURL=endpoint-policy.d.ts.map

package/dist/utils/endpoint-policy.js

@@ -102,7 +102,7 @@ function ipv4MappedToDotted(hostname) {
     return [(value >>> 24) & 255, (value >>> 16) & 255, (value >>> 8) & 255, value & 255].join('.');
 }
 /** True for `localhost`, `::1`, `127.0.0.0/8`, and their IPv4-mapped-IPv6 forms. Allowed — local model servers live here. */
-export function isLoopbackEndpointHost(hostname) {
+export function isLoopbackEndpointHost({ hostname }) {
     const host = normalizeHost(hostname);
     if (host === 'localhost' || host === '::1')
         return true;
@@ -112,7 +112,7 @@ export function isLoopbackEndpointHost(hostname) {
     return Boolean(mapped && isLoopbackIpv4(mapped));
 }
 /** True for RFC1918/link-local/CGNAT/multicast/unspecified/unique-local-IPv6 literals — private space a credentialed request must not be steered into. */
-export function isBlockedEndpointHost(hostname) {
+export function isBlockedEndpointHost({ hostname }) {
     const host = normalizeHost(hostname);
     if (host === '::')
         return true;
@@ -136,7 +136,7 @@ export function isBlockedEndpointHost(hostname) {
  * time. This is the cheap check that runs on every keystroke, not the last
  * line of defense.
  */
-export function isAllowedEndpointUrl(raw) {
+export function isAllowedEndpointUrl({ raw }) {
     const trimmed = raw.trim();
     if (!trimmed)
         return false;
@@ -150,8 +150,8 @@ export function isAllowedEndpointUrl(raw) {
     if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
         return false;
     const hostname = parsed.hostname.toLowerCase();
-    if (isLoopbackEndpointHost(hostname))
+    if (isLoopbackEndpointHost({ hostname }))
         return true;
-    return !isBlockedEndpointHost(hostname);
+    return !isBlockedEndpointHost({ hostname });
 }
 //# sourceMappingURL=endpoint-policy.js.map

package/dist/utils/markdown-scroll-sync.js

@@ -116,10 +116,10 @@ export function measureEditorBlockOffsets(textarea, blockLines, text) {
     // would require either reintroducing this package's own documented
     // `@vitest/coverage-v8` jsdom/node branch-merge bug (see
     // `features/html-viewer/dependencies`'s precedent in
-    // packages/ui/source-map.md) or hand-faking this function's full
+    // packages/ui/archived provenance ledger) or hand-faking this function's full
     // `innerHTML`/`querySelectorAll`/`getComputedStyle` surface under plain
     // Node — disproportionate to a defensive guard with no reachable path.
-    // See packages/ui/source-map.md's 2026-07-22 dated entry.
+    // See packages/ui/archived provenance ledger's 2026-07-22 dated entry.
     if (blockLines.length === 0 || typeof document === 'undefined')
         return null;
     const computed = window.getComputedStyle(textarea);
@@ -269,7 +269,7 @@ export function mapScrollPosition(value, source, target) {
     // sourceLow` always, and a `span > 0 ? ... : 0` guard against
     // division-by-zero was dead code for every possible call, not a real
     // defensive branch — removed rather than tested around (see
-    // packages/ui/source-map.md's 2026-07-22 dated entry for the full proof).
+    // packages/ui/archived provenance ledger's 2026-07-22 dated entry for the full proof).
     const span = sourceHigh - sourceLow;
     const fraction = (value - sourceLow) / span;
     return targetLow + fraction * (targetHigh - targetLow);

package/dist/utils/notifications.d.ts

@@ -3,7 +3,7 @@
  * "long-running task finished" style completion signals.
  *
  * Origin: `utils/notifications.ts`. Genericized in two places (see
- * `packages/ui/source-map.md`):
+ * `packages/ui/archived provenance ledger`):
  *   - `labelKey: keyof Dict` (OD's fixed translation dictionary type)
  *     widened to a plain `string` — this package's i18n feature has no
  *     fixed `Dict` shape for a sound catalog to key into.

package/dist/utils/notifications.js

@@ -3,7 +3,7 @@
  * "long-running task finished" style completion signals.
  *
  * Origin: `utils/notifications.ts`. Genericized in two places (see
- * `packages/ui/source-map.md`):
+ * `packages/ui/archived provenance ledger`):
  *   - `labelKey: keyof Dict` (OD's fixed translation dictionary type)
  *     widened to a plain `string` — this package's i18n feature has no
  *     fixed `Dict` shape for a sound catalog to key into.

package/dist/utils/polygon-selection.d.ts

@@ -10,7 +10,7 @@
  * Correction to an earlier framing: this is NOT multi-user
  * presence/collaboration (no cursors-of-other-users, no realtime presence
  * state exist in the source) — it is a single-user lasso-select tool. See
- * `packages/ui/source-map.md`'s `html-viewer` classification section.
+ * `packages/ui/archived provenance ledger`'s `html-viewer` classification section.
  *
  * Only the geometry primitives ship here — the source's own
  * `buildPodSnapshot`/`pruneContainerSelections`/`podOverlayWeights` (which

package/dist/utils/polygon-selection.js

@@ -10,7 +10,7 @@
  * Correction to an earlier framing: this is NOT multi-user
  * presence/collaboration (no cursors-of-other-users, no realtime presence
  * state exist in the source) — it is a single-user lasso-select tool. See
- * `packages/ui/source-map.md`'s `html-viewer` classification section.
+ * `packages/ui/archived provenance ledger`'s `html-viewer` classification section.
  *
  * Only the geometry primitives ship here — the source's own
  * `buildPodSnapshot`/`pruneContainerSelections`/`podOverlayWeights` (which

package/dist/utils/scroll-tabs-with-wheel.d.ts

@@ -15,5 +15,8 @@
  * to pixels per `deltaMode`) and calls `event.preventDefault()` so the page
  * itself doesn't also scroll vertically.
  */
-export declare function scrollTabsWithWheel(tabBar: Pick<HTMLDivElement, 'clientWidth' | 'scrollLeft' | 'scrollWidth'>, event: Pick<globalThis.WheelEvent, 'ctrlKey' | 'deltaMode' | 'deltaX' | 'deltaY' | 'preventDefault'>): void;
+export declare function scrollTabsWithWheel({ tabBar, event }: {
+    tabBar: Pick<HTMLDivElement, 'clientWidth' | 'scrollLeft' | 'scrollWidth'>;
+    event: Pick<globalThis.WheelEvent, 'ctrlKey' | 'deltaMode' | 'deltaX' | 'deltaY' | 'preventDefault'>;
+}): void;
 //# sourceMappingURL=scroll-tabs-with-wheel.d.ts.map

package/dist/utils/scroll-tabs-with-wheel.js

@@ -21,7 +21,7 @@
  * to pixels per `deltaMode`) and calls `event.preventDefault()` so the page
  * itself doesn't also scroll vertically.
  */
-export function scrollTabsWithWheel(tabBar, event) {
+export function scrollTabsWithWheel({ tabBar, event }) {
     if (event.ctrlKey)
         return;
     if (Math.abs(event.deltaY) <= Math.abs(event.deltaX))

package/dist/utils/smooth-scroll-to-top.js

@@ -49,7 +49,7 @@ function unitBezier(x1, y1, x2, y2) {
             // full domain t∈[0,1] (the only range `smoothScrollToTop` ever feeds
             // in, since its own `t` is clamped via `Math.min(1, ...)`) and the
             // minimum observed was ~0.6095 — nowhere near this 1e-6 guard. See
-            // packages/ui/source-map.md's 2026-07-22 dated entry for the full
+            // packages/ui/archived provenance ledger's 2026-07-22 dated entry for the full
             // re-verification record (matches this task's own standard for
             // documenting provable unreachability instead of forcing a test).
             if (Math.abs(d) < 1e-6)

package/dist/utils/sse.d.ts

@@ -22,5 +22,7 @@ export type ParsedSseFrame = {
  *   are present but do not parse as JSON.
  * @complexity O(n) in the frame's line count — one linear scan.
  */
-export declare function parseSseFrame(frame: string): ParsedSseFrame | null;
+export declare function parseSseFrame({ frame }: {
+    frame: string;
+}): ParsedSseFrame | null;
 //# sourceMappingURL=sse.d.ts.map

package/dist/utils/sse.js

@@ -14,7 +14,7 @@
  *   are present but do not parse as JSON.
  * @complexity O(n) in the frame's line count — one linear scan.
  */
-export function parseSseFrame(frame) {
+export function parseSseFrame({ frame }) {
     const lines = frame.split('\n');
     const comments = [];
     let event = 'message';