@jini-ai/ui 0.1.0

package/dist/utils/auto-open-file.js

@@ -0,0 +1,161 @@
+// Decide whether to auto-open a file after an agent write/edit tool result.
+// Only files that exist in the project's refreshed file list should open as
+// tabs — out-of-project paths (upstream repo edits, system files) would
+// otherwise create permanent placeholder tabs.
+//
+// Resolution order:
+//   1) Path-suffix match. If the agent's `filePath` equals or ends with
+//      `/${file.path}` (full segment alignment), treat it as a positive
+//      identification of that project file. If exactly one file matches,
+//      open it. If multiple files share a path-suffix with `filePath`,
+//      decline as ambiguous rather than open the wrong one.
+//   2) Basename fallback — only when `filePath` has no slash (it's already
+//      a basename) and exactly one project file has that basename. This
+//      preserves the golden path for short filePath inputs while still
+//      rejecting external edits that happen to share a basename with a
+//      project file (those will have a slash in `filePath` and reach this
+//      step with zero suffix matches → declined).
+const NO_MODULES = new Set();
+function basenameOf(p) {
+    // `String.prototype.split` always returns a non-empty array (even for
+    // `''`, which splits to `['']`), so `.pop()` can never actually return
+    // `undefined` here — the `?? p` fallback this used to have was dead code
+    // for every real string input, not real API surface, so it was removed
+    // rather than tested around.
+    return p.split('/').pop();
+}
+export function decideAutoOpenAfterWrite(filePath, nextFiles, options = {}) {
+    const moduleFileNames = options.moduleFileNames ?? NO_MODULES;
+    // Resolve a positive identification into an open decision, declining files
+    // that are modules of a multi-file HTML entry rather than standalone pages.
+    const resolve = (fileName) => moduleFileNames.has(fileName)
+        ? { shouldOpen: false, fileName: null }
+        : { shouldOpen: true, fileName };
+    if (!filePath)
+        return { shouldOpen: false, fileName: null };
+    // 1) Path-suffix match against full project-relative paths.
+    const suffixMatches = [];
+    for (const f of nextFiles) {
+        const rel = f.path ?? f.name;
+        if (!rel)
+            continue;
+        if (filePath === rel) {
+            suffixMatches.push(f);
+            continue;
+        }
+        // Require segment alignment: filePath ends with "/${rel}" so that
+        // "subdir/App.jsx" matches ".../subdir/App.jsx" but not
+        // ".../notsubdir/App.jsx".
+        if (filePath.length > rel.length && filePath.endsWith('/' + rel)) {
+            suffixMatches.push(f);
+        }
+    }
+    if (suffixMatches.length === 1) {
+        return resolve(suffixMatches[0].name);
+    }
+    if (suffixMatches.length > 1) {
+        // Multiple project files plausibly correspond to this path — refuse
+        // rather than open the wrong one.
+        return { shouldOpen: false, fileName: null };
+    }
+    // 2) Basename fallback only when filePath itself is just a basename.
+    // If filePath contains a slash but didn't path-suffix-match anything,
+    // it's an external edit that happens to share a basename — declining
+    // is the whole point of the guard.
+    if (filePath.includes('/')) {
+        return { shouldOpen: false, fileName: null };
+    }
+    const basenameMatches = nextFiles.filter((f) => {
+        const rel = f.path ?? f.name;
+        return rel ? basenameOf(rel) === filePath : false;
+    });
+    if (basenameMatches.length === 1) {
+        return resolve(basenameMatches[0].name);
+    }
+    return { shouldOpen: false, fileName: null };
+}
+function isHtmlPreviewFile(file) {
+    const path = file.path ?? file.name;
+    return file.kind === 'html' || /\.html?$/i.test(path);
+}
+// Markdown documents (plan.md, report.md, DESIGN.md, …) often render inline
+// in a viewer, so a turn that produces one should surface it just like an
+// HTML page. Extension — not `kind` — is the discriminator here so a caller
+// whose backend maps both `.md` and `.txt` to the same generic text kind
+// still opens markdown while deliberately leaving plain `.txt` alone.
+function isMarkdownPreviewFile(file) {
+    const path = file.path ?? file.name;
+    return /\.(md|markdown)$/i.test(path);
+}
+// Auto-open priority for a turn's produced files. Higher wins. HTML is the
+// primary visual deliverable, so when a turn writes both an HTML page and a
+// markdown note (e.g. index.html + README.md) the page takes focus; markdown
+// is the next-best previewable artifact; everything else (decks, images, raw
+// text) has no in-place preview worth stealing focus for and is left for the
+// user to open from the produced-files list.
+function autoOpenPreviewRank(file) {
+    if (isHtmlPreviewFile(file))
+        return 2;
+    if (isMarkdownPreviewFile(file))
+        return 1;
+    return 0;
+}
+// `zh/index.html` → depth 2, root `index.html` → depth 1; null for non-entry
+// files. Depth orders competing entries so the site root wins over a locale
+// or section subtree's own index.
+function siteEntryDepth(file) {
+    const path = file.path ?? file.name;
+    if (!/(^|\/)index\.html?$/i.test(path))
+        return null;
+    return path.split('/').length;
+}
+// Pick which of a turn's produced files to auto-open in the viewer. Among
+// previewable files, a higher-priority kind always beats a lower one; ties
+// break to the most recently written file (newest mtime). Returns null when
+// the turn produced nothing previewable.
+export function selectAutoOpenProducedArtifact(producedFiles, options = {}) {
+    if (options.preferSiteEntry) {
+        let entry = null;
+        let entryDepth = Number.POSITIVE_INFINITY;
+        for (const file of producedFiles) {
+            if (!isHtmlPreviewFile(file))
+                continue;
+            const depth = siteEntryDepth(file);
+            if (depth === null)
+                continue;
+            if (depth < entryDepth) {
+                entry = file;
+                entryDepth = depth;
+                continue;
+            }
+            if (depth > entryDepth || !entry)
+                continue;
+            const nextMtime = typeof file.mtime === 'number' && Number.isFinite(file.mtime) ? file.mtime : 0;
+            const entryMtime = typeof entry.mtime === 'number' && Number.isFinite(entry.mtime) ? entry.mtime : 0;
+            if (nextMtime >= entryMtime)
+                entry = file;
+        }
+        if (entry)
+            return entry.name;
+    }
+    let selected = null;
+    let selectedRank = 0;
+    for (const file of producedFiles) {
+        const rank = autoOpenPreviewRank(file);
+        if (rank === 0)
+            continue;
+        if (!selected || rank > selectedRank) {
+            selected = file;
+            selectedRank = rank;
+            continue;
+        }
+        if (rank < selectedRank)
+            continue;
+        const nextMtime = typeof file.mtime === 'number' && Number.isFinite(file.mtime) ? file.mtime : 0;
+        const selectedMtime = typeof selected.mtime === 'number' && Number.isFinite(selected.mtime) ? selected.mtime : 0;
+        if (nextMtime >= selectedMtime)
+            selected = file;
+    }
+    return selected?.name ?? null;
+}
+//# sourceMappingURL=auto-open-file.js.map

package/dist/utils/auto-open-file.js.map

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

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

@@ -0,0 +1,34 @@
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Extracts and normalizes the first 3/6/8-digit hex color found anywhere in
+ * `value` (e.g. pulled out of a longer string like `"color: #fff;"`) to a
+ * lowercase `#rrggbb` string. An 8-digit match (`#rrggbbaa`) has its alpha
+ * channel dropped. Returns `null` if `value` is undefined or contains no
+ * hex-color-shaped substring.
+ */
+export declare function normalizeHex(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;
+/**
+ * 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;
+/** Clamps `value` to `[0, 255]` and formats it as a 2-digit lowercase hex byte. */
+export declare function toHexByte(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;
+/** 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;
+//# sourceMappingURL=color-math.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"color-math.d.ts","sourceRoot":"","sources":["../../src/utils/color-math.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASrE;AAED,wHAAwH;AACxH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAQhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUzE;AAED,yIAAyI;AACzI,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/utils/color-math.js

@@ -0,0 +1,79 @@
+// Small hex-color math primitives: normalization, RGB decoding, a perceptual
+// luminance heuristic, and weighted hex mixing. Used for deriving readable
+// text/border/muted shades from an arbitrary source color (e.g. a generated
+// or user-picked accent) without a full color-management library.
+//
+// `luminance()` here is the ITU-R BT.709 luma formula applied directly to
+// gamma-encoded (sRGB) channel values — a fast perceptual-brightness
+// approximation, NOT the WCAG 2.x "relative luminance" definition (which
+// first linearizes each channel through the sRGB gamma curve). Preserved
+// as-is from the origin implementation rather than "corrected" to the WCAG
+// formula, since that would change every derived color's output.
+/**
+ * Extracts and normalizes the first 3/6/8-digit hex color found anywhere in
+ * `value` (e.g. pulled out of a longer string like `"color: #fff;"`) to a
+ * lowercase `#rrggbb` string. An 8-digit match (`#rrggbbaa`) has its alpha
+ * channel dropped. Returns `null` if `value` is undefined or contains no
+ * hex-color-shaped substring.
+ */
+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;
+    const raw = match[0].toLowerCase();
+    if (raw.length === 4) {
+        return `#${raw[1]}${raw[1]}${raw[2]}${raw[2]}${raw[3]}${raw[3]}`;
+    }
+    if (raw.length === 9)
+        return raw.slice(0, 7);
+    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);
+    if (!normalized)
+        return null;
+    return {
+        r: parseInt(normalized.slice(1, 3), 16),
+        g: parseInt(normalized.slice(3, 5), 16),
+        b: parseInt(normalized.slice(5, 7), 16),
+    };
+}
+/**
+ * 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 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) {
+    return Math.max(0, Math.min(255, value)).toString(16).padStart(2, '0');
+}
+/**
+ * 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 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 };
+    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)}`;
+}
+/** 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';
+}
+//# sourceMappingURL=color-math.js.map

package/dist/utils/color-math.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+export declare function copyToClipboard(text: string): Promise<boolean>;
+//# sourceMappingURL=copy-to-clipboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/utils/copy-to-clipboard.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuCpE"}

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

@@ -0,0 +1,56 @@
+// Copies text to the clipboard using the canonical Clipboard API, falling
+// back to a hidden textarea + execCommand('copy') for older browsers,
+// 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.
+ */
+export async function copyToClipboard(text) {
+    try {
+        await navigator.clipboard.writeText(text);
+        return true;
+    }
+    catch {
+        const priorFocus = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.style.position = 'fixed';
+        ta.style.opacity = '0';
+        document.body.appendChild(ta);
+        ta.select();
+        // Cleanup is repeated at each return point rather than living in a
+        // `finally` clause: this `try`'s own `catch { return false; }` can
+        // never itself throw, so a `finally` here would carry v8's synthetic
+        // "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).
+        const cleanup = () => {
+            document.body.removeChild(ta);
+            if (priorFocus?.isConnected) {
+                try {
+                    priorFocus.focus({ preventScroll: true });
+                }
+                catch {
+                    priorFocus.focus();
+                }
+            }
+        };
+        try {
+            const result = document.execCommand('copy');
+            cleanup();
+            return result;
+        }
+        catch {
+            cleanup();
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=copy-to-clipboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy-to-clipboard.js","sourceRoot":"","sources":["../../src/utils/copy-to-clipboard.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,sEAAsE;AACtE,8DAA8D;AAC9D,yCAAyC;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,GACd,QAAQ,CAAC,aAAa,YAAY,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QAChF,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QAC9C,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC;QAChB,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9B,EAAE,CAAC,MAAM,EAAE,CAAC;QACZ,mEAAmE;QACnE,mEAAmE;QACnE,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,sEAAsE;QACtE,uDAAuD;QACvD,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,UAAU,EAAE,WAAW,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,UAAU,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC;YACV,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/design-md.d.ts

@@ -0,0 +1,27 @@
+export interface DesignMdModule {
+    /** Rendered when the module has no preamble/heading content yet. */
+    heading: string;
+    /** Case-insensitive substrings matched against `##` heading text. */
+    keywords: string[];
+    /** When true, the module is the document's untitled preamble (before the first `##`), not a `##` section. */
+    includePreamble?: boolean;
+}
+export interface DesignMdSlice {
+    text: string;
+    start: number;
+    end: number;
+    /** False when no matching content was found and `text` is a generated default. */
+    exists: boolean;
+}
+interface DesignMdHeadingMatch {
+    start: number;
+    title: string;
+}
+export declare function designMdHeadings(body: string, startOffset: number): DesignMdHeadingMatch[];
+export declare function designMdHeadingMatches(title: string, module: DesignMdModule): boolean;
+export declare function designMdDefaultModuleText(module: DesignMdModule, preamble?: string): string;
+export declare function designMdModuleSlice(body: string, module: DesignMdModule): DesignMdSlice;
+export declare function normalizeDesignMdModuleDraft(module: DesignMdModule, draft: string): string;
+export declare function replaceDesignMdModule(body: string, module: DesignMdModule, draft: string): string;
+export {};
+//# sourceMappingURL=design-md.d.ts.map

package/dist/utils/design-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-md.d.ts","sourceRoot":"","sources":["../../src/utils/design-md.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6GAA6G;IAC7G,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa1F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAGrF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,SAAK,GAAG,MAAM,CAGvF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,CA+CvF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjG"}

package/dist/utils/design-md.js

@@ -0,0 +1,94 @@
+// designMd* — pure helpers for slicing a single "module" section out of a
+// DESIGN.md-shaped markdown document (an optional frontmatter block, an
+// optional preamble before the first `##` heading, then `##`-delimited
+// sections) and replacing that slice in place. A module is matched by
+// checking whether any of its `keywords` appears (case-insensitively) in a
+// heading's text — the same fuzzy match a hand-edited doc's headings need to
+// keep matching after a human renames "Color Palette" to "Palette", etc.
+export function designMdHeadings(body, startOffset) {
+    return [...body.slice(startOffset).matchAll(/^##\s+(.+?)\s*$/gm)].map((match) => {
+        // `RegExpMatchArray.index` and a capture group are typed as possibly
+        // `undefined` because the JS regex API can't express "always set for a
+        // `matchAll` result" / "always set for a mandatory capture group" — for
+        // this specific pattern (an unanchored global match, one non-optional
+        // `(.+?)` group) both are always defined whenever a match exists.
+        const start = startOffset + match.index;
+        return {
+            start,
+            title: match[1],
+        };
+    });
+}
+export function designMdHeadingMatches(title, module) {
+    const normalized = title.replace(/^\d+[.)]\s*/, '').trim().toLowerCase();
+    return module.keywords.some((keyword) => normalized.includes(keyword));
+}
+export function designMdDefaultModuleText(module, preamble = '') {
+    if (module.includePreamble)
+        return preamble || `# ${module.heading}\n`;
+    return `## ${module.heading}\n\n`;
+}
+export function designMdModuleSlice(body, module) {
+    const frontmatter = body.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+    const contentStart = frontmatter ? frontmatter[0].length : 0;
+    const headings = designMdHeadings(body, contentStart);
+    const preambleEnd = headings[0]?.start ?? body.length;
+    const preamble = body.slice(contentStart, preambleEnd).trim();
+    const matchedIndexes = headings
+        .map((heading, index) => (designMdHeadingMatches(heading.title, module) ? index : -1))
+        .filter((index) => index >= 0);
+    if (module.includePreamble && preamble.length > 0) {
+        return {
+            text: preamble,
+            start: contentStart,
+            end: preambleEnd,
+            exists: true,
+        };
+    }
+    if (matchedIndexes.length > 0) {
+        const first = matchedIndexes[0];
+        const last = matchedIndexes[matchedIndexes.length - 1];
+        const start = headings[first].start;
+        const end = headings[last + 1]?.start ?? body.length;
+        return {
+            text: body.slice(start, end).trim(),
+            start,
+            end,
+            exists: true,
+        };
+    }
+    if (module.includePreamble) {
+        return {
+            text: designMdDefaultModuleText(module, preamble),
+            start: contentStart,
+            end: preambleEnd,
+            exists: false,
+        };
+    }
+    return {
+        text: designMdDefaultModuleText(module),
+        start: body.length,
+        end: body.length,
+        exists: false,
+    };
+}
+export function normalizeDesignMdModuleDraft(module, draft) {
+    const trimmed = draft.trim();
+    if (module.includePreamble)
+        return trimmed;
+    if (!trimmed)
+        return `## ${module.heading}`;
+    return /^##\s+/m.test(trimmed) ? trimmed : `## ${module.heading}\n\n${trimmed}`;
+}
+export function replaceDesignMdModule(body, module, draft) {
+    const slice = designMdModuleSlice(body, module);
+    const nextText = normalizeDesignMdModuleDraft(module, draft);
+    const before = body.slice(0, slice.start).trimEnd();
+    const after = body.slice(slice.end).trimStart();
+    return [before, nextText, after]
+        .filter((part) => part.trim().length > 0)
+        .join('\n\n')
+        .trimEnd()
+        .concat('\n');
+}
+//# sourceMappingURL=design-md.js.map

package/dist/utils/design-md.js.map

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

package/dist/utils/dom-subscriptions.d.ts

@@ -0,0 +1,50 @@
+export interface ViewportSize {
+    width: number;
+    height: number;
+}
+/** The current viewport size, or a zero-size fallback outside the browser (SSR). */
+export declare function getViewportSize(): ViewportSize;
+/** The document body, or `null` outside the browser (SSR). */
+export declare function getDocumentBody(): HTMLElement | null;
+/**
+ * Fires `onClose` on a `pointerdown` outside `container.current`, or on
+ * Escape anywhere. A no-op subscription outside the browser (SSR).
+ *
+ * Uses `pointerdown` (not `mousedown`/`click`) to match every real popover/
+ * dropdown call site that dismisses on outside interaction (verified against
+ * `ViewportSwitcher`/`BrowserViewportControls` in `packages/ui/src/browser/
+ * useDismissOnOutsideOrEscape.ts`'s callers) — it fires before `mouseup`-based
+ * text selection can interfere and covers touch input `click` doesn't.
+ *
+ * @param container - A ref-like box holding the element to treat as
+ *   "inside" (any click within it is ignored). Omit entirely (`undefined`)
+ *   to skip the outside-click listener and react to Escape only — e.g. a
+ *   modal whose backdrop click is already handled by the caller.
+ * @param onClose - Called once per qualifying outside-click or Escape key.
+ * @returns A cleanup function that removes the listener(s) that were added.
+ */
+export declare function subscribeOutsideClickOrEscape(container: {
+    current: HTMLElement | null;
+} | undefined, onClose: () => void): () => void;
+/**
+ * Adds a `window` event listener for `eventName` and returns the matching
+ * removal function. A no-op subscription outside the browser (SSR).
+ */
+export declare function subscribeWindowEvent(eventName: string, onEvent: (event: Event) => void): () => void;
+/**
+ * Fires `onVisible` when the tab regains focus or becomes visible again
+ * (e.g. returning from an external OAuth/redirect tab) — skipped while the
+ * tab itself is hidden, since `visibilitychange` also fires on the way out.
+ * A no-op subscription outside the browser (SSR).
+ */
+export declare function subscribeVisibleFocusOrVisibilityChange(onVisible: () => void): () => void;
+/** Runs `callback` every `ms` via `window.setInterval`; the returned
+ *  function clears it. A no-op outside the browser (SSR). */
+export declare function scheduleInterval(callback: () => void, ms: number): () => void;
+/** Runs `callback` once after `ms` via `window.setTimeout`; the returned
+ *  function cancels it. A no-op outside the browser (SSR). */
+export declare function scheduleTimeout(callback: () => void, ms: number): () => void;
+/** Opens `url` in a new tab (`noopener,noreferrer`); a no-op outside the
+ *  browser (SSR). */
+export declare function openExternalUrl(url: string): void;
+//# sourceMappingURL=dom-subscriptions.d.ts.map

package/dist/utils/dom-subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-subscriptions.d.ts","sourceRoot":"","sources":["../../src/utils/dom-subscriptions.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAGpD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE;IAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,EACtD,OAAO,EAAE,MAAM,IAAI,GAClB,MAAM,IAAI,CAgBZ;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC9B,MAAM,IAAI,CAIZ;AAED;;;;;GAKG;AACH,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAYzF;AAED;6DAC6D;AAC7D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAI7E;AAED;8DAC8D;AAC9D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAI5E;AAED;qBACqB;AACrB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGjD"}