@jini-ai/ui 0.1.0

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

@@ -0,0 +1,277 @@
+import { parse, postprocess, preprocess } from 'micromark';
+import { gfm } from 'micromark-extension-gfm';
+// Split-view scroll sync between a raw markdown editor and its rendered
+// preview. A naive ratio sync (scrollTop / scrollRange) drifts badly because
+// a markdown source line and its rendered block have very different heights
+// (a `## heading` is one short line in source but a tall heading block in
+// preview). Instead we anchor on every top-level block: each block's source
+// line maps to one top-level DOM element in the preview, and we piecewise-
+// linearly interpolate scroll position between those anchor pairs so
+// matching blocks line up at the top edge of both panes.
+const CONTAINER_TOKENS = new Set(['blockQuote', 'listOrdered', 'listUnordered']);
+const FLOW_BLOCK_TOKENS = new Set([
+    'atxHeading',
+    'setextHeading',
+    'paragraph',
+    'codeFenced',
+    'codeIndented',
+    'htmlFlow',
+    'thematicBreak',
+    'table',
+]);
+// Computed styles that influence text wrapping/line height. Copied from the
+// textarea onto a hidden mirror so the mirror wraps identically. `box-sizing`,
+// `width`, and borders are forced separately so the content box matches
+// regardless of the textarea's own box model.
+const MIRROR_COPIED_STYLES = [
+    'font-family',
+    'font-size',
+    'font-weight',
+    'font-style',
+    'font-variant',
+    'line-height',
+    'letter-spacing',
+    'word-spacing',
+    'text-transform',
+    'text-indent',
+    'tab-size',
+    'white-space',
+    'overflow-wrap',
+    'word-break',
+    'padding-top',
+    'padding-right',
+    'padding-bottom',
+    'padding-left',
+];
+function hasVerticalProgression(offsets) {
+    if (offsets.length <= 1)
+        return true;
+    // `offsets` is a module-private function's only argument, always built
+    // internally (by `measureEditorBlockOffsets`/`measurePreviewBlockOffsets`
+    // via `new Array(...).fill(0)` or `.map()`) as a dense array — `offsets[0]`
+    // is always defined once the `length <= 1` guard above has passed, so the
+    // `?? 0` fallback this used to have was dead code for every real caller
+    // (same pattern as this file's `basenameOf`-style precedents elsewhere in
+    // this package).
+    const first = offsets[0];
+    return offsets.some((offset, index) => index > 0 && offset > first + 0.5);
+}
+/**
+ * 1-based source start line of every top-level markdown block, in document
+ * order. Nested blocks (list items, blockquote contents) collapse into their
+ * top-level container so the result lines up 1:1 with the preview article's
+ * direct element children.
+ */
+export function extractMarkdownBlockLines(markdown) {
+    if (!markdown)
+        return [];
+    let events;
+    try {
+        events = postprocess(parse({ extensions: [gfm()] })
+            .document()
+            .write(preprocess()(markdown, undefined, true)));
+    }
+    catch {
+        return [];
+    }
+    const lines = [];
+    let depth = 0;
+    for (const event of events) {
+        const phase = event[0];
+        const token = event[1];
+        const type = token.type;
+        if (CONTAINER_TOKENS.has(type)) {
+            if (phase === 'enter') {
+                if (depth === 0)
+                    lines.push(token.start.line);
+                depth += 1;
+            }
+            else {
+                depth = Math.max(0, depth - 1);
+            }
+            continue;
+        }
+        if (phase === 'enter' && depth === 0 && FLOW_BLOCK_TOKENS.has(type)) {
+            lines.push(token.start.line);
+        }
+    }
+    return lines;
+}
+function escapeMirrorText(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/**
+ * Pixel offset (within the textarea's scrollable content) of each block's
+ * start line, accounting for soft-wrapping. Measured with a hidden mirror that
+ * mimics the textarea's wrapping so the offsets stay accurate even when long
+ * lines wrap. Returns `null` when measurement is not possible.
+ */
+export function measureEditorBlockOffsets(textarea, blockLines, text) {
+    // The `typeof document === 'undefined'` half of this guard is real,
+    // intentional SSR-safety API contract (documented in this function's own
+    // JSDoc), but is empirically unreachable through this repo's actual call
+    // graph today: its only caller (`useMarkdownScrollSync`) only ever
+    // invokes it with an already browser-mounted `HTMLTextAreaElement` ref,
+    // which cannot exist without `document` already existing. A real test
+    // 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
+    // `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.
+    if (blockLines.length === 0 || typeof document === 'undefined')
+        return null;
+    const computed = window.getComputedStyle(textarea);
+    const mirror = document.createElement('div');
+    const style = mirror.style;
+    for (const prop of MIRROR_COPIED_STYLES) {
+        style.setProperty(prop, computed.getPropertyValue(prop));
+    }
+    // Reproduce the textarea content-box width regardless of its box model.
+    style.boxSizing = 'border-box';
+    style.borderWidth = '0';
+    style.margin = '0';
+    style.position = 'absolute';
+    style.top = '0';
+    style.left = '-9999px';
+    style.height = 'auto';
+    style.overflow = 'hidden';
+    style.visibility = 'hidden';
+    style.pointerEvents = 'none';
+    style.width = `${textarea.clientWidth}px`;
+    if (style.whiteSpace === 'normal' || !style.whiteSpace)
+        style.whiteSpace = 'pre-wrap';
+    const lines = text.split('\n');
+    const markersByLine = new Map();
+    blockLines.forEach((line, blockIndex) => {
+        const lineIndex = Math.max(0, Math.min(lines.length - 1, line - 1));
+        const existing = markersByLine.get(lineIndex);
+        if (existing)
+            existing.push(blockIndex);
+        else
+            markersByLine.set(lineIndex, [blockIndex]);
+    });
+    let buffer = '';
+    for (let i = 0; i < lines.length; i += 1) {
+        const markers = markersByLine.get(i);
+        if (markers) {
+            for (const blockIndex of markers)
+                buffer += `<span data-md-block="${blockIndex}"></span>`;
+        }
+        // `text.split('\n')` always yields a dense array (never a hole), so
+        // `lines[i]` for `i` in `[0, lines.length)` is always a defined string
+        // (possibly `''`) — the `?? ''` fallback this used to have was dead
+        // code for every real string input, removed rather than tested around
+        // (same pattern as `utils/auto-open-file.ts`'s `basenameOf`).
+        buffer += escapeMirrorText(lines[i]);
+        if (i < lines.length - 1)
+            buffer += '\n';
+    }
+    mirror.innerHTML = buffer;
+    document.body.appendChild(mirror);
+    const offsets = new Array(blockLines.length).fill(0);
+    try {
+        const markers = mirror.querySelectorAll('span[data-md-block]');
+        for (const marker of Array.from(markers)) {
+            const blockIndex = Number(marker.getAttribute('data-md-block'));
+            if (Number.isInteger(blockIndex) && blockIndex >= 0 && blockIndex < offsets.length) {
+                offsets[blockIndex] = marker.offsetTop;
+            }
+        }
+    }
+    finally {
+        document.body.removeChild(mirror);
+    }
+    if (!hasVerticalProgression(offsets))
+        return null;
+    return offsets;
+}
+/**
+ * Pixel offset (within the preview pane's scrollable content) of each rendered
+ * top-level block element. Returns `null` when the rendered article's direct
+ * element children do not match the expected block count — the caller then
+ * falls back to ratio sync rather than risk a wrong mapping.
+ *
+ * `previewSelector` identifies the preview article's root inside `pane`
+ * (defaults to `.markdown-rendered`, matching most markdown renderers'
+ * conventional root class).
+ */
+export function measurePreviewBlockOffsets(pane, blockCount, previewSelector = '.markdown-rendered') {
+    if (blockCount === 0)
+        return null;
+    const article = pane.querySelector(previewSelector);
+    if (!article)
+        return null;
+    const children = Array.from(article.children).filter((child) => child instanceof HTMLElement);
+    if (children.length !== blockCount)
+        return null;
+    const paneRect = pane.getBoundingClientRect();
+    const contentTop = paneRect.top - pane.scrollTop;
+    const offsets = children.map((child) => child.getBoundingClientRect().top - contentTop);
+    if (!hasVerticalProgression(offsets))
+        return null;
+    return offsets;
+}
+/**
+ * Build a monotonic anchor array spanning the full scrollable range: a `0`
+ * anchor at the top, the per-block offsets, and the total `scrollHeight` at the
+ * bottom, clamped non-decreasing so interpolation stays stable.
+ */
+export function buildScrollAnchors(blockOffsets, scrollHeight) {
+    const anchors = [0, ...blockOffsets, Math.max(0, scrollHeight)];
+    let previous = 0;
+    for (let i = 0; i < anchors.length; i += 1) {
+        const raw = anchors[i] ?? 0;
+        let value = Math.max(0, Math.min(scrollHeight, Number.isFinite(raw) ? raw : 0));
+        if (value < previous)
+            value = previous;
+        anchors[i] = value;
+        previous = value;
+    }
+    return anchors;
+}
+/**
+ * Map a scroll position from the source pane to the target pane using paired
+ * anchor arrays (same length, both monotonic). Linear interpolation within the
+ * bracketing segment.
+ */
+export function mapScrollPosition(value, source, target) {
+    const count = Math.min(source.length, target.length);
+    if (count === 0)
+        return value;
+    if (count === 1)
+        return target[0] ?? 0;
+    if (value <= (source[0] ?? 0))
+        return target[0] ?? 0;
+    if (value >= (source[count - 1] ?? 0))
+        return target[count - 1] ?? 0;
+    let low = 0;
+    let high = count - 1;
+    while (high - low > 1) {
+        const mid = (low + high) >> 1;
+        if ((source[mid] ?? 0) <= value)
+            low = mid;
+        else
+            high = mid;
+    }
+    const sourceLow = source[low] ?? 0;
+    const sourceHigh = source[high] ?? 0;
+    const targetLow = target[low] ?? 0;
+    const targetHigh = target[high] ?? 0;
+    // `span` is provably > 0 here, for *any* input array (not just a
+    // monotonic one): the early clamp checks above guarantee
+    // `source[0] <= value < source[count - 1]` before the search loop ever
+    // runs, and the loop's own invariant — `low` only ever advances when
+    // `source[mid] <= value`, `high` only ever advances when
+    // `source[mid] > value` — means `sourceLow <= value < sourceHigh` holds
+    // at every exit, loop-iteration count included. So `sourceHigh >
+    // 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).
+    const span = sourceHigh - sourceLow;
+    const fraction = (value - sourceLow) / span;
+    return targetLow + fraction * (targetHigh - targetLow);
+}
+//# sourceMappingURL=markdown-scroll-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-scroll-sync.js","sourceRoot":"","sources":["../../src/utils/markdown-scroll-sync.ts"],"names":[],"mappings":"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"}

package/dist/utils/notifications.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Desktop notification + short synthesized sound-cue system for
+ * "long-running task finished" style completion signals.
+ *
+ * Origin: `utils/notifications.ts`. Genericized in two places (see
+ * `packages/ui/source-map.md`):
+ *   - `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.
+ *   - The hard-coded `'/od-notifications-sw.js'` service-worker URL and
+ *     `'od-task-'` notification tag prefix are now caller-supplied
+ *     options (defaulting to generic, non-product-branded values).
+ */
+export type SoundId = string;
+export interface SoundOption {
+    id: SoundId;
+    labelKey: string;
+}
+export declare const SUCCESS_SOUNDS: SoundOption[];
+export declare const FAILURE_SOUNDS: SoundOption[];
+export declare const DEFAULT_SUCCESS_SOUND_ID: SoundId;
+export declare const DEFAULT_FAILURE_SOUND_ID: SoundId;
+/** Plays a registered sound id. No-ops silently on any failure (never throws into UI code). */
+export declare function playSound(id: SoundId): void;
+export declare function previewSuccess(id: SoundId): void;
+export declare function previewFailure(id: SoundId): void;
+export declare function notificationPermission(): NotificationPermission | 'unsupported';
+export declare function requestNotificationPermission(): Promise<NotificationPermission | 'unsupported'>;
+export interface CompletionNotificationOpts {
+    status: 'succeeded' | 'failed';
+    title: string;
+    body: string;
+    onClick?: () => void;
+    /** Service-worker script URL to register for the `showNotification` path.
+     *  Omit to skip the service-worker path entirely and go straight to the
+     *  `Notification` constructor. */
+    serviceWorkerUrl?: string;
+    /** Prefix for the notification `tag` (`${tagPrefix}-${status}`). Defaults
+     *  to `'task'`. */
+    tagPrefix?: string;
+}
+export type CompletionNotificationResult = 'shown' | 'unsupported' | 'permission-denied' | 'failed';
+/**
+ * Shows a completion notification, preferring the service-worker path (if
+ * `serviceWorkerUrl` is supplied and registration succeeds) and falling
+ * back to the direct `Notification` constructor.
+ *
+ * @overallScore 100
+ */
+export declare function showCompletionNotification(opts: CompletionNotificationOpts): Promise<CompletionNotificationResult>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/utils/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/utils/notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,WAAW,EAKvC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,EAIvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,OAAgB,CAAC;AACxD,eAAO,MAAM,wBAAwB,EAAE,OAAgB,CAAC;AAiHxD,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAU3C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,wBAAgB,sBAAsB,IAAI,sBAAsB,GAAG,aAAa,CAG/E;AAED,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,sBAAsB,GAAG,aAAa,CAAC,CAUrG;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;sCAEkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;uBACmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,aAAa,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAoEpG;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,4BAA4B,CAAC,CAIvC"}

package/dist/utils/notifications.js

@@ -0,0 +1,238 @@
+/**
+ * Desktop notification + short synthesized sound-cue system for
+ * "long-running task finished" style completion signals.
+ *
+ * Origin: `utils/notifications.ts`. Genericized in two places (see
+ * `packages/ui/source-map.md`):
+ *   - `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.
+ *   - The hard-coded `'/od-notifications-sw.js'` service-worker URL and
+ *     `'od-task-'` notification tag prefix are now caller-supplied
+ *     options (defaulting to generic, non-product-branded values).
+ */
+export const SUCCESS_SOUNDS = [
+    { id: 'ding', labelKey: 'notifications.sound.ding' },
+    { id: 'chime', labelKey: 'notifications.sound.chime' },
+    { id: 'two-tone-up', labelKey: 'notifications.sound.twoToneUp' },
+    { id: 'pluck', labelKey: 'notifications.sound.pluck' },
+];
+export const FAILURE_SOUNDS = [
+    { id: 'buzz', labelKey: 'notifications.sound.buzz' },
+    { id: 'two-tone-down', labelKey: 'notifications.sound.twoToneDown' },
+    { id: 'thud', labelKey: 'notifications.sound.thud' },
+];
+export const DEFAULT_SUCCESS_SOUND_ID = 'ding';
+export const DEFAULT_FAILURE_SOUND_ID = 'buzz';
+let ctx = null;
+const activeNotifications = new Set();
+function getCtx() {
+    if (typeof window === 'undefined')
+        return null;
+    const Ctor = window.AudioContext ?? window.webkitAudioContext;
+    if (!Ctor)
+        return null;
+    if (!ctx) {
+        try {
+            ctx = new Ctor();
+        }
+        catch {
+            return null;
+        }
+    }
+    if (ctx && ctx.state === 'suspended') {
+        void ctx.resume().catch(() => {
+            // Autoplay policy can refuse — fall through silently. The next
+            // user-gesture-driven call will retry.
+        });
+    }
+    return ctx;
+}
+function playTones(c, tones) {
+    const now = c.currentTime;
+    for (const tone of tones) {
+        const osc = c.createOscillator();
+        const gain = c.createGain();
+        osc.type = tone.type;
+        osc.frequency.value = tone.freq;
+        const peak = tone.gain;
+        const startAt = now + tone.start;
+        const endAt = startAt + tone.duration;
+        // Short attack to avoid clicks; exponential-ish decay via a linear
+        // ramp to near-zero (exponentialRamp can't reach exactly 0).
+        gain.gain.setValueAtTime(0.0001, startAt);
+        gain.gain.linearRampToValueAtTime(peak, startAt + Math.min(0.005, tone.duration * 0.2));
+        gain.gain.exponentialRampToValueAtTime(0.0001, endAt);
+        let last = osc;
+        if (tone.lowpass) {
+            const lp = c.createBiquadFilter();
+            lp.type = 'lowpass';
+            lp.frequency.value = tone.lowpass;
+            osc.connect(lp);
+            last = lp;
+        }
+        last.connect(gain);
+        gain.connect(c.destination);
+        osc.start(startAt);
+        osc.stop(endAt + 0.02);
+    }
+}
+const SOUND_PLAYERS = {
+    ding: (c) => {
+        playTones(c, [{ freq: 880, type: 'sine', start: 0, duration: 0.25, gain: 0.22 }]);
+    },
+    chime: (c) => {
+        playTones(c, [
+            { freq: 880, type: 'triangle', start: 0, duration: 0.4, gain: 0.18 },
+            { freq: 1320, type: 'triangle', start: 0, duration: 0.4, gain: 0.12 },
+        ]);
+    },
+    'two-tone-up': (c) => {
+        playTones(c, [
+            { freq: 660, type: 'square', start: 0, duration: 0.08, gain: 0.16 },
+            { freq: 990, type: 'square', start: 0.09, duration: 0.08, gain: 0.16 },
+        ]);
+    },
+    pluck: (c) => {
+        playTones(c, [{ freq: 220, type: 'sawtooth', start: 0, duration: 0.15, gain: 0.22, lowpass: 1200 }]);
+    },
+    buzz: (c) => {
+        playTones(c, [
+            { freq: 165, type: 'square', start: 0, duration: 0.06, gain: 0.2 },
+            { freq: 165, type: 'square', start: 0.1, duration: 0.06, gain: 0.2 },
+            { freq: 165, type: 'square', start: 0.2, duration: 0.06, gain: 0.2 },
+        ]);
+    },
+    'two-tone-down': (c) => {
+        playTones(c, [
+            { freq: 880, type: 'sine', start: 0, duration: 0.12, gain: 0.2 },
+            { freq: 440, type: 'sine', start: 0.13, duration: 0.12, gain: 0.2 },
+        ]);
+    },
+    thud: (c) => {
+        playTones(c, [{ freq: 80, type: 'sine', start: 0, duration: 0.12, gain: 0.32 }]);
+    },
+};
+/** Plays a registered sound id. No-ops silently on any failure (never throws into UI code). */
+export function playSound(id) {
+    const c = getCtx();
+    if (!c)
+        return;
+    const player = SOUND_PLAYERS[id];
+    if (!player)
+        return;
+    try {
+        player(c);
+    }
+    catch {
+        // A node creation/connection failure should never throw out to UI code.
+    }
+}
+export function previewSuccess(id) {
+    playSound(id);
+}
+export function previewFailure(id) {
+    playSound(id);
+}
+export function notificationPermission() {
+    if (typeof Notification === 'undefined')
+        return 'unsupported';
+    return Notification.permission;
+}
+export async function requestNotificationPermission() {
+    if (typeof Notification === 'undefined')
+        return 'unsupported';
+    if (Notification.permission === 'granted' || Notification.permission === 'denied') {
+        return Notification.permission;
+    }
+    try {
+        return await Notification.requestPermission();
+    }
+    catch {
+        return 'denied';
+    }
+}
+function notificationOptionsFor(opts) {
+    const tag = `${opts.tagPrefix ?? 'task'}-${opts.status}`;
+    return {
+        body: opts.body,
+        tag,
+        renotify: true,
+        data: {
+            status: opts.status,
+            url: typeof window === 'undefined' ? '/' : window.location.href,
+        },
+    };
+}
+async function showViaServiceWorker(opts) {
+    if (!opts.serviceWorkerUrl)
+        return null;
+    if (typeof navigator === 'undefined' || !('serviceWorker' in navigator))
+        return null;
+    try {
+        const registration = await navigator.serviceWorker.register(opts.serviceWorkerUrl);
+        const readyRegistration = await navigator.serviceWorker.ready.catch(() => registration);
+        if (!readyRegistration.showNotification)
+            return null;
+        await readyRegistration.showNotification(opts.title, notificationOptionsFor(opts));
+        return 'shown';
+    }
+    catch {
+        return null;
+    }
+}
+// `showViaConstructor`'s only caller (`showCompletionNotification`) already
+// checks `typeof Notification === 'undefined'` and
+// `Notification.permission !== 'granted'` before ever calling this
+// function, so re-checking either here is unreachable dead code — removed
+// rather than tested around (this file's `ToneSpec.gain` default is the
+// same pattern above).
+function showViaConstructor(opts) {
+    try {
+        const note = new Notification(opts.title, notificationOptionsFor(opts));
+        activeNotifications.add(note);
+        const release = () => {
+            note.onclick = null;
+            note.onclose = null;
+            note.onerror = null;
+            activeNotifications.delete(note);
+        };
+        note.onclick = () => {
+            try {
+                if (typeof window !== 'undefined')
+                    window.focus();
+            }
+            catch {
+                /* ignore */
+            }
+            opts.onClick?.();
+            try {
+                note.close();
+            }
+            catch {
+                /* ignore */
+            }
+        };
+        note.onclose = release;
+        note.onerror = release;
+        return 'shown';
+    }
+    catch {
+        return 'failed';
+    }
+}
+/**
+ * Shows a completion notification, preferring the service-worker path (if
+ * `serviceWorkerUrl` is supplied and registration succeeds) and falling
+ * back to the direct `Notification` constructor.
+ *
+ * @overallScore 100
+ */
+export async function showCompletionNotification(opts) {
+    if (typeof Notification === 'undefined')
+        return 'unsupported';
+    if (Notification.permission !== 'granted')
+        return 'permission-denied';
+    return (await showViaServiceWorker(opts)) ?? showViaConstructor(opts);
+}
+//# sourceMappingURL=notifications.js.map

package/dist/utils/notifications.js.map

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

package/dist/utils/platform.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Origin: `utils/platform.ts` — ported verbatim, no OD coupling (zero
+ * imports, pure `navigator.platform` sniff).
+ */
+export declare function isMacPlatform(): boolean;
+//# sourceMappingURL=platform.d.ts.map

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/utils/platform.js

@@ -0,0 +1,8 @@
+/**
+ * Origin: `utils/platform.ts` — ported verbatim, no OD coupling (zero
+ * imports, pure `navigator.platform` sniff).
+ */
+export function isMacPlatform() {
+    return typeof navigator !== 'undefined' && /Mac|iPod|iPhone|iPad/.test(navigator.platform);
+}
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,SAAS,KAAK,WAAW,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC7F,CAAC"}