@jini-ai/ui 0.1.0

package/dist/features/mention-autocomplete/react/hooks/useMentionAutocomplete.js

@@ -0,0 +1,115 @@
+import { useMemo, useRef, useState } from 'react';
+import { useDismissOnOutsideOrEscape } from '../../../../browser/index.js';
+import { DEFAULT_MAX_RESULTS_PER_CATEGORY, DEFAULT_TRIGGER_CHAR } from '../../constants.js';
+import { buildMentionToken, filterMentionItems, groupItemsByCategory, hasAnyResults, insertMentionToken, mentionSelectionKey, readMentionTrigger, } from '../../rules.js';
+/**
+ * Owns a mention-enabled textarea's trigger-detection state (which `@token`
+ * is currently in progress), the active category tab, the filtered/grouped
+ * results, the multi-select "context chips" set (add on pick, remove on
+ * chip click — the vendored picker's `selectedSkillIds`/`selectedPluginIds`/
+ * etc. arrays, generalized to one `T[]` list keyed by `category:id`), and
+ * the splice-in-a-token pick flow (including restoring focus+cursor to the
+ * textarea after a pick, since the picker itself never takes focus — it's
+ * driven by `onMouseDown`/`preventDefault` the same way the vendored picker
+ * was).
+ *
+ * Deliberately i18n-free (returns plain data only) — see this package's
+ * i18n policy on why a hook shouldn't thread `useT()` through effect/callback
+ * dependencies. The presentational layer translates category labels itself.
+ */
+export function useMentionAutocomplete({ value, onValueChange, items, categories, onSelectionChange, triggerChar = DEFAULT_TRIGGER_CHAR, getSearchText, maxResultsPerCategory = DEFAULT_MAX_RESULTS_PER_CATEGORY, }) {
+    const textareaRef = useRef(null);
+    const containerRef = useRef(null);
+    const [mention, setMention] = useState(null);
+    const [activeCategory, setActiveCategory] = useState('all');
+    const [selectedItems, setSelectedItems] = useState([]);
+    const refreshFromTextarea = () => {
+        const textarea = textareaRef.current;
+        if (!textarea)
+            return;
+        setMention(readMentionTrigger(textarea.value, textarea.selectionStart ?? textarea.value.length, triggerChar));
+    };
+    const onTextareaChange = (event) => {
+        const nextValue = event.target.value;
+        onValueChange(nextValue);
+        setMention(readMentionTrigger(nextValue, event.target.selectionStart ?? nextValue.length, triggerChar));
+    };
+    const onTextareaKeyDown = (event) => {
+        if (event.key === 'Escape' && mention) {
+            event.preventDefault();
+            setMention(null);
+        }
+    };
+    // The textarea content/cursor are unchanged by an Escape press, so a
+    // same-key `keyup`-driven re-read of the trigger (see `onTextareaKeyUp`
+    // below) would otherwise immediately re-detect the still-live `@token`
+    // and reopen the mention that `onTextareaKeyDown` just closed. Skip the
+    // refresh specifically for the key that just closed it.
+    const onTextareaKeyUp = (event) => {
+        if (event.key === 'Escape')
+            return;
+        refreshFromTextarea();
+    };
+    const closeMention = () => setMention(null);
+    useDismissOnOutsideOrEscape(closeMention, { enabled: mention !== null, containerRef });
+    const pickItem = (item) => {
+        const token = buildMentionToken(item.label, triggerChar);
+        const textarea = textareaRef.current;
+        const { nextValue, cursor } = insertMentionToken(value, mention, token);
+        onValueChange(nextValue);
+        setMention(null);
+        setSelectedItems((current) => {
+            if (current.some((existing) => mentionSelectionKey(existing.category, existing.id) === mentionSelectionKey(item.category, item.id))) {
+                return current;
+            }
+            const next = [...current, item];
+            onSelectionChange?.(next);
+            return next;
+        });
+        requestAnimationFrame(() => {
+            if (!textarea)
+                return;
+            textarea.focus();
+            textarea.setSelectionRange(cursor, cursor);
+        });
+    };
+    const removeItem = (item) => {
+        setSelectedItems((current) => {
+            const key = mentionSelectionKey(item.category, item.id);
+            const next = current.filter((existing) => mentionSelectionKey(existing.category, existing.id) !== key);
+            onSelectionChange?.(next);
+            return next;
+        });
+    };
+    const query = (mention?.query ?? '').trim();
+    // Filter the full candidate set first (uncapped — `items.length` as the
+    // cap is a no-op ceiling), then let `groupItemsByCategory` apply the
+    // per-category cap independently, matching the vendored picker's
+    // per-kind `.slice(0, 10)` rather than one shared cap across every
+    // category combined.
+    const filteredItems = useMemo(() => filterMentionItems(items, query, getSearchText, items.length), [items, query, getSearchText]);
+    const groups = useMemo(() => groupItemsByCategory(filteredItems, categories, activeCategory, maxResultsPerCategory), [filteredItems, categories, activeCategory, maxResultsPerCategory]);
+    const selectedKeys = useMemo(() => new Set(selectedItems.map((item) => mentionSelectionKey(item.category, item.id))), [selectedItems]);
+    return {
+        textareaRef,
+        containerRef,
+        mention,
+        isOpen: mention !== null,
+        query,
+        activeCategory,
+        setActiveCategory,
+        groups,
+        hasResults: hasAnyResults(groups),
+        selectedItems,
+        selectedKeys,
+        onTextareaChange,
+        onTextareaClick: refreshFromTextarea,
+        onTextareaKeyUp,
+        onTextareaFocus: closeMention,
+        onTextareaKeyDown,
+        pickItem,
+        removeItem,
+        closeMention,
+    };
+}
+//# sourceMappingURL=useMentionAutocomplete.js.map

package/dist/features/mention-autocomplete/react/hooks/useMentionAutocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMentionAutocomplete.js","sourceRoot":"","sources":["../../../../../src/features/mention-autocomplete/react/hooks/useMentionAutocomplete.ts"],"names":[],"mappings":"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"}

package/dist/features/mention-autocomplete/rules.d.ts

@@ -0,0 +1,54 @@
+import type { MentionCategory, MentionCategoryFilter, MentionInsertResult, MentionItem, MentionTriggerMatch } from './types.js';
+/**
+ * Detect an in-progress `@token` ending at `cursor` within `value` (e.g. a
+ * textarea's current value + selection start). The trigger must be at the
+ * start of the text or preceded by whitespace, and the token itself may not
+ * contain whitespace or another trigger character. Returns `null` when the
+ * cursor isn't inside a live trigger.
+ */
+export declare function readMentionTrigger(value: string, cursor: number, triggerChar?: string): MentionTriggerMatch | null;
+/** Prefix `label` with `triggerChar` unless it's already there. */
+export declare function buildMentionToken(label: string, triggerChar?: string): string;
+/**
+ * Splice `token` into `value` at the active trigger match (or append it, with
+ * a leading newline separator when the existing text is non-empty, when
+ * there's no active match — e.g. inserting context without having typed the
+ * trigger first). Trims any whitespace immediately after a replaced trigger
+ * so the result doesn't end up with a double space. Returns the next value
+ * plus the cursor position to restore focus to.
+ */
+export declare function insertMentionToken(value: string, match: MentionTriggerMatch | null, token: string): MentionInsertResult;
+/** Case-insensitive substring filter, capped to `maxResults`. `getSearchText`
+ *  defaults to `label` alone; pass a richer selector to also match on id/meta/
+ *  other host fields (mirrors the vendored picker's per-kind search index). */
+export declare function filterMentionItems<T extends MentionItem>(items: T[], query: string, getSearchText?: (item: T) => string, maxResults?: number): T[];
+export interface MentionResultGroup<T extends MentionItem> {
+    category: MentionCategory;
+    items: T[];
+}
+/**
+ * Group already-filtered items by category, in the given category order,
+ * omitting categories that end up with zero visible items (after applying
+ * `activeFilter`). Each category's item list is capped to
+ * `maxItemsPerCategory` independently — matching the vendored picker's
+ * per-kind `.slice(0, 10)` (each capability kind got its own 10-result cap,
+ * not one shared cap across every kind combined).
+ */
+export declare function groupItemsByCategory<T extends MentionItem>(items: T[], categories: MentionCategory[], activeFilter?: MentionCategoryFilter, maxItemsPerCategory?: number): MentionResultGroup<T>[];
+/** Is `categoryId` shown under the current tab filter? True when the filter
+ *  is `'all'` or matches the category exactly. */
+export declare function isCategoryVisible(activeFilter: MentionCategoryFilter, categoryId: string): boolean;
+/**
+ * A composite `category:id` selection key. Items are only guaranteed unique
+ * within their own category (two different categories may reuse the same
+ * raw id, e.g. a "general" skill and a "general" plugin), so selection
+ * tracking keys on the pair rather than the bare id.
+ */
+export declare function mentionSelectionKey(categoryId: string, itemId: string): string;
+/** Whether there's at least one visible group — drives the "no results"/
+ *  empty state. `groupItemsByCategory` never returns an empty-items group
+ *  (it filters those out itself), so this is equivalent to `groups.length >
+ *  0` for groups produced that way; expressed as a named predicate so the
+ *  call site reads as intent rather than an array-length check. */
+export declare function hasAnyResults<T extends MentionItem>(groups: MentionResultGroup<T>[]): boolean;
+//# sourceMappingURL=rules.d.ts.map

package/dist/features/mention-autocomplete/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/features/mention-autocomplete/rules.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMhI;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAA6B,GACzC,mBAAmB,GAAG,IAAI,CAiB5B;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,MAA6B,GAAG,MAAM,CAEnG;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,mBAAmB,GAAG,IAAI,EACjC,KAAK,EAAE,MAAM,GACZ,mBAAmB,CAWrB;AAED;;+EAE+E;AAC/E,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EACtD,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAA6B,EACzD,UAAU,GAAE,MAAyC,GACpD,CAAC,EAAE,CAIL;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW;IACvD,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EACxD,KAAK,EAAE,CAAC,EAAE,EACV,UAAU,EAAE,eAAe,EAAE,EAC7B,YAAY,GAAE,qBAA2C,EACzD,mBAAmB,GAAE,MAAyC,GAC7D,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAQzB;AAED;kDACkD;AAClD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAElG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;mEAImE;AACnE,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAE7F"}

package/dist/features/mention-autocomplete/rules.js

@@ -0,0 +1,109 @@
+/**
+ * Pure mention-autocomplete logic — no React, no i18n hook. Category
+ * `label`s passed through here are plain English strings meant to be
+ * translated via the caller's `useT()`, per this package's i18n convention.
+ */
+import { ALL_CATEGORY_FILTER, DEFAULT_MAX_RESULTS_PER_CATEGORY, DEFAULT_TRIGGER_CHAR } from './constants.js';
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Detect an in-progress `@token` ending at `cursor` within `value` (e.g. a
+ * textarea's current value + selection start). The trigger must be at the
+ * start of the text or preceded by whitespace, and the token itself may not
+ * contain whitespace or another trigger character. Returns `null` when the
+ * cursor isn't inside a live trigger.
+ */
+export function readMentionTrigger(value, cursor, triggerChar = DEFAULT_TRIGGER_CHAR) {
+    const beforeCursor = value.slice(0, cursor);
+    const escaped = escapeRegExp(triggerChar);
+    const pattern = new RegExp(`(^|\\s)${escaped}([^\\s${escaped}]*)$`);
+    const match = pattern.exec(beforeCursor);
+    if (!match)
+        return null;
+    // Both capture groups are mandatory (neither is inside a `?`-optional
+    // alternation) — whenever `match` is non-null, both participated and are
+    // real strings (possibly empty), never `undefined`. The non-null
+    // assertions just satisfy `RegExpExecArray`'s generically-optional index
+    // type; there's no runtime path where either is actually missing.
+    const prefix = match[1];
+    return {
+        start: match.index + prefix.length,
+        end: cursor,
+        query: match[2],
+    };
+}
+/** Prefix `label` with `triggerChar` unless it's already there. */
+export function buildMentionToken(label, triggerChar = DEFAULT_TRIGGER_CHAR) {
+    return label.startsWith(triggerChar) ? label : `${triggerChar}${label}`;
+}
+/**
+ * Splice `token` into `value` at the active trigger match (or append it, with
+ * a leading newline separator when the existing text is non-empty, when
+ * there's no active match — e.g. inserting context without having typed the
+ * trigger first). Trims any whitespace immediately after a replaced trigger
+ * so the result doesn't end up with a double space. Returns the next value
+ * plus the cursor position to restore focus to.
+ */
+export function insertMentionToken(value, match, token) {
+    const tokenWithSpace = `${token} `;
+    if (!match) {
+        const spacer = value.trim().length > 0 ? '\n' : '';
+        const nextValue = `${value}${spacer}${tokenWithSpace}`;
+        return { nextValue, cursor: nextValue.length };
+    }
+    const before = value.slice(0, match.start);
+    const after = value.slice(match.end).replace(/^\s+/, '');
+    const nextValue = `${before}${tokenWithSpace}${after}`;
+    return { nextValue, cursor: before.length + tokenWithSpace.length };
+}
+/** Case-insensitive substring filter, capped to `maxResults`. `getSearchText`
+ *  defaults to `label` alone; pass a richer selector to also match on id/meta/
+ *  other host fields (mirrors the vendored picker's per-kind search index). */
+export function filterMentionItems(items, query, getSearchText = (item) => item.label, maxResults = DEFAULT_MAX_RESULTS_PER_CATEGORY) {
+    const q = query.trim().toLowerCase();
+    const matched = q ? items.filter((item) => getSearchText(item).toLowerCase().includes(q)) : items;
+    return matched.slice(0, maxResults);
+}
+/**
+ * Group already-filtered items by category, in the given category order,
+ * omitting categories that end up with zero visible items (after applying
+ * `activeFilter`). Each category's item list is capped to
+ * `maxItemsPerCategory` independently — matching the vendored picker's
+ * per-kind `.slice(0, 10)` (each capability kind got its own 10-result cap,
+ * not one shared cap across every kind combined).
+ */
+export function groupItemsByCategory(items, categories, activeFilter = ALL_CATEGORY_FILTER, maxItemsPerCategory = DEFAULT_MAX_RESULTS_PER_CATEGORY) {
+    const groups = [];
+    for (const category of categories) {
+        if (!isCategoryVisible(activeFilter, category.id))
+            continue;
+        const categoryItems = items.filter((item) => item.category === category.id).slice(0, maxItemsPerCategory);
+        if (categoryItems.length > 0)
+            groups.push({ category, items: categoryItems });
+    }
+    return groups;
+}
+/** Is `categoryId` shown under the current tab filter? True when the filter
+ *  is `'all'` or matches the category exactly. */
+export function isCategoryVisible(activeFilter, categoryId) {
+    return activeFilter === ALL_CATEGORY_FILTER || activeFilter === categoryId;
+}
+/**
+ * A composite `category:id` selection key. Items are only guaranteed unique
+ * within their own category (two different categories may reuse the same
+ * raw id, e.g. a "general" skill and a "general" plugin), so selection
+ * tracking keys on the pair rather than the bare id.
+ */
+export function mentionSelectionKey(categoryId, itemId) {
+    return `${categoryId}:${itemId}`;
+}
+/** Whether there's at least one visible group — drives the "no results"/
+ *  empty state. `groupItemsByCategory` never returns an empty-items group
+ *  (it filters those out itself), so this is equivalent to `groups.length >
+ *  0` for groups produced that way; expressed as a named predicate so the
+ *  call site reads as intent rather than an array-length check. */
+export function hasAnyResults(groups) {
+    return groups.length > 0;
+}
+//# sourceMappingURL=rules.js.map

package/dist/features/mention-autocomplete/rules.js.map

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

package/dist/features/mention-autocomplete/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Generic types for a "type a trigger character, get a filtered picker"
+ * mention/capability autocomplete: inline trigger-token detection in a
+ * text field, tabbed multi-category filtered results, and removable
+ * selection chips. `TIcon` is left as a type parameter (defaulting to
+ * `unknown`) rather than fixed to a React node — see `react/components`'
+ * `MentionAutocompleteItem` alias, which is where the React-shaped
+ * `icon?: ReactNode` actually gets used; keeping it generic here is what
+ * lets this file stay free of a runtime React import, per this package's
+ * React-layout policy.
+ *
+ * Origin: the `@`-token detection / tabbed capability picker / removable
+ * chips shape from the vendored schedule/mention god-component (recon r6
+ * §1.19) — "directly analogous to the `QuickSwitcher.tsx` precedent."
+ * OD-specific only via the capability data types (`SkillSummary`/
+ * `InstalledPluginRecord`/`McpServerConfig`/`ConnectorDetail`); this module
+ * replaces all four with one generic `MentionItem` shape instead.
+ */
+/** A single autocomplete-able item: any host-owned capability/entity with a
+ *  stable id, a display label, and a category it belongs to. */
+export interface MentionItem<TIcon = unknown> {
+    id: string;
+    label: string;
+    /** Must match one of the host-supplied `MentionCategory.id`s. */
+    category: string;
+    /** Secondary line rendered under the label (e.g. a description or type). */
+    meta?: string | undefined;
+    /** Host-rendered icon/leading visual — kept generic (not `ReactNode`
+     *  directly) so this file can stay free of a runtime React import. */
+    icon?: TIcon | undefined;
+}
+/** A pluggable result category (e.g. "Skills", "Plugins", "MCP",
+ *  "Connectors") — `label` is plain English, used directly as a `useT()`
+ *  key by the caller, per this package's i18n convention. */
+export interface MentionCategory {
+    id: string;
+    label: string;
+}
+/** The active category-tab filter: `'all'`, or one specific category id. */
+export type MentionCategoryFilter = 'all' | string;
+/** A detected in-progress `@token` at the current cursor position. */
+export interface MentionTriggerMatch {
+    /** Index of the trigger character itself (e.g. `@`) within the source text. */
+    start: number;
+    /** Cursor position the match was read at (== end of the in-progress token). */
+    end: number;
+    /** Text typed after the trigger character so far. */
+    query: string;
+}
+/** The result of splicing a picked item's token into the source text. */
+export interface MentionInsertResult {
+    nextValue: string;
+    /** Cursor position to restore focus to after the splice. */
+    cursor: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/mention-autocomplete/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/mention-autocomplete/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;gEACgE;AAChE,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,OAAO;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;0EACsE;IACtE,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B;AAED;;6DAE6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/features/mention-autocomplete/types.js

@@ -0,0 +1,20 @@
+/**
+ * Generic types for a "type a trigger character, get a filtered picker"
+ * mention/capability autocomplete: inline trigger-token detection in a
+ * text field, tabbed multi-category filtered results, and removable
+ * selection chips. `TIcon` is left as a type parameter (defaulting to
+ * `unknown`) rather than fixed to a React node — see `react/components`'
+ * `MentionAutocompleteItem` alias, which is where the React-shaped
+ * `icon?: ReactNode` actually gets used; keeping it generic here is what
+ * lets this file stay free of a runtime React import, per this package's
+ * React-layout policy.
+ *
+ * Origin: the `@`-token detection / tabbed capability picker / removable
+ * chips shape from the vendored schedule/mention god-component (recon r6
+ * §1.19) — "directly analogous to the `QuickSwitcher.tsx` precedent."
+ * OD-specific only via the capability data types (`SkillSummary`/
+ * `InstalledPluginRecord`/`McpServerConfig`/`ConnectorDetail`); this module
+ * replaces all four with one generic `MentionItem` shape instead.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/mention-autocomplete/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/mention-autocomplete/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/features/observability/boot-timing.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Boot timing observer.
+ *
+ * Reports a boot-timing event once, after the app's first page becomes
+ * fully rendered. Buckets:
+ *
+ *   - navigation_start_offset_ms: navigationStart → loadEvent.start
+ *     (the standard "page load" metric).
+ *   - dom_interactive_ms: navigationStart → domInteractive
+ *   - dom_content_loaded_ms: navigationStart → domContentLoadedEventStart
+ *
+ * Origin (`observability/boot-timing.ts`) called this a stability signal
+ * "more than a behavioral one" to justify bypassing product-analytics
+ * consent gating — that call belongs to whatever host wires the
+ * {@link SafetyEventReporter}, not to this module.
+ *
+ * Fires at most once per page load (per provider instance — see
+ * `installBootTimingObserver`'s module-level guard).
+ */
+import { type SafetyEventReporter } from './ports.js';
+export interface BootTimingOptions {
+    reporter?: SafetyEventReporter | undefined;
+}
+/**
+ * Installs the boot-timing observer. Safe to call multiple times — only
+ * the first call in a page load actually observes; later calls return an
+ * inert teardown.
+ *
+ * @overallScore 100
+ */
+export declare function installBootTimingObserver(options?: BootTimingOptions): () => void;
+//# sourceMappingURL=boot-timing.d.ts.map

package/dist/features/observability/boot-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-timing.d.ts","sourceRoot":"","sources":["../../../src/features/observability/boot-timing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAC5C;AAID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,IAAI,CA0BrF"}

package/dist/features/observability/boot-timing.js

@@ -0,0 +1,129 @@
+/**
+ * Boot timing observer.
+ *
+ * Reports a boot-timing event once, after the app's first page becomes
+ * fully rendered. Buckets:
+ *
+ *   - navigation_start_offset_ms: navigationStart → loadEvent.start
+ *     (the standard "page load" metric).
+ *   - dom_interactive_ms: navigationStart → domInteractive
+ *   - dom_content_loaded_ms: navigationStart → domContentLoadedEventStart
+ *
+ * Origin (`observability/boot-timing.ts`) called this a stability signal
+ * "more than a behavioral one" to justify bypassing product-analytics
+ * consent gating — that call belongs to whatever host wires the
+ * {@link SafetyEventReporter}, not to this module.
+ *
+ * Fires at most once per page load (per provider instance — see
+ * `installBootTimingObserver`'s module-level guard).
+ */
+import { noopSafetyEventReporter } from './ports.js';
+let captured = false;
+/**
+ * Installs the boot-timing observer. Safe to call multiple times — only
+ * the first call in a page load actually observes; later calls return an
+ * inert teardown.
+ *
+ * @overallScore 100
+ */
+export function installBootTimingObserver(options = {}) {
+    const reporter = options.reporter ?? noopSafetyEventReporter;
+    if (typeof window === 'undefined')
+        return () => undefined;
+    if (typeof performance === 'undefined')
+        return () => undefined;
+    if (captured)
+        return () => undefined;
+    const onReady = () => {
+        if (captured)
+            return;
+        captured = true;
+        // Defer to the next idle tick so we capture the post-load timings
+        // (loadEventEnd is set synchronously inside the `load` handler).
+        schedule(() => emit(reporter));
+    };
+    // Three possible states on install: still loading, interactive, or
+    // already complete (HMR / dev / fast paths). Cover all three.
+    if (document.readyState === 'complete') {
+        onReady();
+    }
+    else {
+        window.addEventListener('load', onReady, { once: true });
+    }
+    return () => {
+        captured = true;
+        window.removeEventListener('load', onReady);
+    };
+}
+// `schedule`'s only call site (`onReady`, inside `installBootTimingObserver`)
+// only ever runs after that function's own `typeof window === 'undefined'`
+// guard has already passed, so a second check here was dead code for every
+// real call — removed rather than tested around (see
+// packages/ui/source-map.md's 2026-07-22 dated entry).
+function schedule(fn) {
+    const rIC = window.requestIdleCallback;
+    if (typeof rIC === 'function') {
+        rIC(fn, { timeout: 2000 });
+        return;
+    }
+    setTimeout(fn, 50);
+}
+function emit(reporter) {
+    // PerformanceNavigationTiming is the modern shape; Navigation Timing v1
+    // (`performance.timing`) is deprecated but still present in some engines
+    // — preferred the typed v2 surface and only fall back when
+    // getEntriesByType returns nothing.
+    const nav = readNavigationTiming();
+    if (!nav)
+        return;
+    reporter('client_boot_timing', {
+        navigation_start_offset_ms: round(nav.navigationStart),
+        dom_interactive_ms: round(nav.domInteractive),
+        dom_content_loaded_ms: round(nav.domContentLoadedEventStart),
+        dom_complete_ms: round(nav.domComplete),
+        load_event_ms: round(nav.loadEventStart),
+        transfer_size_bytes: typeof nav.transferSize === 'number' && nav.transferSize > 0 ? nav.transferSize : undefined,
+        // `emit` is only ever reached via `onReady`, which itself only ever
+        // runs after `installBootTimingObserver` has already read
+        // `document.readyState` directly (unconditionally, no `typeof` guard)
+        // earlier in the same call — so `document` is provably already
+        // resolvable in global scope by the time this line runs; a `typeof
+        // document !== 'undefined'` re-check here was dead code for every real
+        // call, removed rather than tested around (see
+        // packages/ui/source-map.md's 2026-07-22 dated entry).
+        visibility_state: document.visibilityState,
+    });
+}
+function readNavigationTiming() {
+    const [entry] = performance.getEntriesByType('navigation');
+    if (entry) {
+        return {
+            navigationStart: entry.startTime,
+            domInteractive: entry.domInteractive,
+            domContentLoadedEventStart: entry.domContentLoadedEventStart,
+            domComplete: entry.domComplete,
+            loadEventStart: entry.loadEventStart,
+            transferSize: entry.transferSize,
+        };
+    }
+    // Legacy fallback — `performance.timing` returns absolute epoch
+    // timestamps; normalise against navigationStart to match the v2-style
+    // relative shape.
+    const legacy = performance.timing;
+    if (!legacy)
+        return null;
+    const base = legacy.navigationStart;
+    return {
+        navigationStart: 0,
+        domInteractive: legacy.domInteractive - base,
+        domContentLoadedEventStart: legacy.domContentLoadedEventStart - base,
+        domComplete: legacy.domComplete - base,
+        loadEventStart: legacy.loadEventStart - base,
+    };
+}
+function round(value) {
+    if (typeof value !== 'number' || Number.isNaN(value))
+        return undefined;
+    return Math.round(value);
+}
+//# sourceMappingURL=boot-timing.js.map

package/dist/features/observability/boot-timing.js.map

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

package/dist/features/observability/iframe.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Iframe load tracker.
+ *
+ * Iframe load failures don't propagate to a global `window.error` listener
+ * — they're trapped inside the frame — so {@link installResourceErrorObserver}
+ * (`resource-error.ts`) can't see them. This helper instruments a single
+ * `<iframe>` element for failure/timeout and reports scoped events; the
+ * caller supplies it when mounting the iframe (e.g. a preview/renderer
+ * surface) and gets a cleanup callback back.
+ *
+ * Origin (`observability/iframe-error.ts`) hard-coded `artifactId`/
+ * `projectId`/`conversationId` fields tied to OD's domain model. Genericized
+ * to a free-form `context` bag so any host can attach its own identifiers.
+ */
+import { type SafetyEventReporter } from './ports.js';
+export interface TrackIframeLoadOptions {
+    iframe: HTMLIFrameElement;
+    /** Label so a host's dashboards can split iframe surfaces from each other
+     *  (e.g. "file-preview", "embedded-canvas"). */
+    surface: string;
+    reporter?: SafetyEventReporter | undefined;
+    /** Timeout before an unresolved load is reported as stuck. Defaults to 15000. */
+    timeoutMs?: number;
+    /** Arbitrary extra context merged into every emitted event. */
+    context?: Record<string, unknown>;
+}
+/**
+ * Instruments an iframe for load failure/timeout and returns a cleanup
+ * function. Does not report on ordinary successful loads (the common case)
+ * to avoid multiplying event volume — only settles the timeout.
+ *
+ * @overallScore 100
+ */
+export declare function trackIframeLoad(options: TrackIframeLoadOptions): () => void;
+//# sourceMappingURL=iframe.d.ts.map

package/dist/features/observability/iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../../src/features/observability/iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAI/E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B;oDACgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC3C,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAyC3E"}