@mieweb/ui 0.10.0-dev.2 → 0.10.0-dev.4

package/dist/index.d.cts

@@ -1478,6 +1478,10 @@ interface UseDiarizationOptions {
     /** Load the ~50 MB speaker runtime + warm Whisper. Set false to keep it dormant until it's needed
      *  (e.g. a host feature that's off). Default true. */
     enabled?: boolean;
+    /** Anchor clusters against THIS namespace's enrolled voices — pass the same value used at enrollment
+     *  (`useVoiceSetup` / `VoiceManager`), or scoped users get "Speaker N" (or another user's labels)
+     *  from the legacy shared store. Omit for the original unscoped store. */
+    voiceprintNamespace?: string;
 }
 interface UseDiarizationResult {
     /** TitaNet runtime is loaded (diarization can run). */
@@ -1494,6 +1498,11 @@ declare function useDiarization(options?: UseDiarizationOptions): UseDiarization
 
 type HeyOzwellPhase = 'listening' | 'dictating' | 'transcribing';
 interface UseHeyOzwellOptions {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. A scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records); omit to keep the original shared store. Pass the SAME value to every voice
+     *  surface (`VoiceSetup` / `VoiceManager`), or verification and enrollment read different stores. */
+    voiceprintNamespace?: string;
     /** ON: "hey ozwell" opens the chat AND starts dictating. OFF: it just opens the chat and waits. */
     autoDictateOnWake?: boolean;
     /** Close the chat popup after "ozwell I'm done" transcribes + sends. */
@@ -1532,8 +1541,9 @@ interface UseHeyOzwellOptions {
      *  mishearing, then press send) instead of sending it automatically. An accuracy safety net for clinical
      *  use — off by default so the hands-free flow stays hands-free. */
     reviewBeforeSend?: boolean;
-    /** Diarization tuning for conversation mode (threshold, maxSpeakers, minSegmentSeconds, inferRoles). */
-    diarizationOptions?: Omit<UseDiarizationOptions, 'enabled'>;
+    /** Diarization tuning for conversation mode (threshold, maxSpeakers, minSegmentSeconds, inferRoles).
+     *  `enabled` and `voiceprintNamespace` are owned by the hook (conversationMode / the shared prop). */
+    diarizationOptions?: Omit<UseDiarizationOptions, 'enabled' | 'voiceprintNamespace'>;
 }
 /** Props to spread onto <HeyOzwellToggle>. */
 interface HeyOzwellToggleBindings {
@@ -1704,6 +1714,12 @@ interface ModelInfoListProps {
 declare function ModelInfoList({ status }: ModelInfoListProps): react_jsx_runtime.JSX.Element;
 
 interface HandsFreeChatProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id (`voiceprintNamespace={user.id}`). Scopes both the wake
+     *  verifier and the embedded VoiceManager; a scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records). Omit to keep the original shared store. Any standalone `VoiceSetup` /
+     *  `VoiceManager` the host renders must receive the SAME value. */
+    voiceprintNamespace?: string;
     /** Chat header title. */
     title?: string;
     /** Suggested-action chips for the empty state. */
@@ -1729,9 +1745,15 @@ interface HandsFreeChatProps {
     autoDictateOnWake?: boolean;
 }
 /** Say "hey ozwell" to dictate, "ozwell I'm done" to send — wake + speaker-verify + dictation + AIChat. */
-declare function HandsFreeChat({ title, suggestions, userName, logoSrc, transcription, requireDoctor, liveTranscript, conversationMode, reviewBeforeSend, autoDictateOnWake, }: HandsFreeChatProps): react_jsx_runtime.JSX.Element;
+declare function HandsFreeChat({ voiceprintNamespace, title, suggestions, userName, logoSrc, transcription, requireDoctor, liveTranscript, conversationMode, reviewBeforeSend, autoDictateOnWake, }: HandsFreeChatProps): react_jsx_runtime.JSX.Element;
 
 interface VoiceSetupProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. Enroll with the SAME value the verifying surface
+     *  (`useHeyOzwell` / `HandsFreeChat`) and `VoiceManager` use, or they can't see this enrollment.
+     *  A scoped store starts empty — no legacy unscoped records are inherited. Omit for the original
+     *  shared store. */
+    voiceprintNamespace?: string;
     /**
      * 'enroll' (default) = fresh first-time setup. 'add' = jump straight into appending a new voice/condition
      * to the existing voiceprints — what the settings menu's "Add a voice" uses, so the user doesn't have to
@@ -1750,17 +1772,28 @@ interface VoiceSetupProps {
     onCancel?: () => void;
 }
 /** On-device voice enrollment — tap the octopus, it pulses as you talk. Brand-aligned. */
-declare function VoiceSetup({ mode, voiceId, label, logoSrc, onDone, onCancel, }: VoiceSetupProps): react_jsx_runtime.JSX.Element;
+declare function VoiceSetup({ voiceprintNamespace, mode, voiceId, label, logoSrc, onDone, onCancel, }: VoiceSetupProps): react_jsx_runtime.JSX.Element;
 
 interface VoiceManagerProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. Must be the SAME value the verifying surface (`useHeyOzwell` /
+     *  `HandsFreeChat`) uses, or this page manages a different store than the one gating wakes (it would
+     *  look empty and enroll into the wrong store). A scoped store starts empty — no legacy unscoped
+     *  records are inherited. Omit to manage the original shared store. */
+    voiceprintNamespace?: string;
     /** Octopus logo source, forwarded to the enrollment screen. */
     logoSrc?: string;
 }
 /** The central voice-enrollment management page. */
-declare function VoiceManager({ logoSrc }: VoiceManagerProps): react_jsx_runtime.JSX.Element;
+declare function VoiceManager({ logoSrc, voiceprintNamespace, }: VoiceManagerProps): react_jsx_runtime.JSX.Element;
 
 type VoiceSetupPhase = 'intro' | 'getready' | 'speak' | 'gotit' | 'deny' | 'done';
 interface UseVoiceSetupOptions {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. A scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records); omit to keep the original shared store. Enroll with the SAME value the
+     *  verifying surface (`useHeyOzwell` / `HandsFreeChat`) uses, or it can't see this enrollment. */
+    voiceprintNamespace?: string;
     /** Start directly in "add a voice" (append) mode instead of a fresh enroll — for the settings menu's
      *  "Add a voice", which appends another authorized voice / condition to the existing voiceprints. */
     startAdding?: boolean;
@@ -1924,6 +1957,12 @@ interface UseSpeakerVerifyOpts {
     /** Set false to skip loading the ~50 MB sherpa/TitaNet runtime (e.g. when the doctor-only gate is off).
      *  Defaults to true so existing callers are unchanged. */
     enabled?: boolean;
+    /** Isolates persisted enrollment from other users of the same browser profile — e.g. pass the
+     *  signed-in user's id. Every returned method (enroll / verify / identify / listVoices / clear…)
+     *  operates on that scoped store, which starts empty: scoped records do NOT inherit the legacy
+     *  unscoped key. Use the SAME value across enrollment, verification, and management (`useVoiceSetup`,
+     *  `useHeyOzwell`, `VoiceManager`), or they read different stores. Omit for the original shared one. */
+    voiceprintNamespace?: string;
 }
 declare function useSpeakerVerify(opts?: UseSpeakerVerifyOpts): SpeakerVerifyHandle;
 
@@ -2089,18 +2128,6 @@ declare function askOzwell(messages: OzwellMessage[] | string, opts?: AskOpts):
  */
 declare function askOzwellStream(messages: OzwellMessage[] | string, onToken: (delta: string, full: string) => void, opts?: AskOpts): Promise<string>;
 
-/**
- * IndexedDB store for on-device voiceprints (enrollment vectors), replacing localStorage for this data.
- *
- * Why IndexedDB and not localStorage: it's asynchronous (off the main thread), stores `Float32Array`
- * natively via structured clone (no JSON-stringifying embeddings into bloated number arrays), and isn't
- * capped at ~5 MB. Why not OPFS: these are small *structured records* keyed by id, not large files —
- * IndexedDB is the right tool; OPFS is for the big model files.
- *
- * One object store, keyed by a string id; values are any structured-cloneable object, so `Float32Array`s
- * survive the round-trip intact. On first read of a key it migrates a legacy localStorage value (if a
- * parser is supplied) and then clears it.
- */
 /**
  * Read a voiceprint record. If IndexedDB has nothing for `key` but localStorage does, migrate it via
  * `migrateLegacy` (parse the old JSON string → the new shape), persist it to IndexedDB, and clear the
@@ -2111,9 +2138,9 @@ declare function getVoiceprints<T>(key: string, migrateLegacy?: (raw: string) =>
 declare function setVoiceprints(key: string, value: unknown): Promise<void>;
 /** Remove a voiceprint record (and any stale localStorage copy). */
 declare function clearVoiceprints(key: string): Promise<void>;
-declare function loadWhatPrints(): Promise<Record<string, Float32Array[]>>;
-declare function saveWhatPrints(map: Record<string, Float32Array[]>): Promise<void>;
-declare function clearWhatPrints(): Promise<void>;
+declare function loadWhatPrints(namespace?: string): Promise<Record<string, Float32Array[]>>;
+declare function saveWhatPrints(map: Record<string, Float32Array[]>, namespace?: string): Promise<void>;
+declare function clearWhatPrints(namespace?: string): Promise<void>;
 
 /**
  * Shared on-device audio helpers for Hey Ozwell — previously copy-pasted across the enrollment,
@@ -10167,8 +10194,27 @@ interface SidebarNavGroupProps {
     groupId?: string;
     /** Additional CSS classes */
     className?: string;
+    /**
+     * Keep items mounted when the group is collapsed, hidden via `hidden`.
+     *
+     * For groups whose children own DOM state that a remount would destroy —
+     * uncontrolled inputs, media playback position, an editor instance. State
+     * survives the group's own collapse *and* the desktop rail collapsing.
+     *
+     * Does **not** make collapsed items findable by in-page search: `hidden` is
+     * `display: none`, and browsers do not match text inside it. `hidden="until-found"`
+     * would deliver that, but it is not portable enough to build the API on yet.
+     *
+     * Mirrors `CollapsibleContent`'s prop of the same name, and carries the same
+     * caveat: this path does **not** animate. `hidden` is `display: none`, which
+     * an animated height cannot run through, and dropping it for the duration
+     * would let keyboard users tab into content that is visually collapsed. Not
+     * animating is the safe answer until `hidden` can be sequenced around the
+     * animation.
+     */
+    forceMount?: boolean;
 }
-declare function SidebarNavGroup({ label, icon, children, defaultExpanded, groupId, className, }: SidebarNavGroupProps): React__default.JSX.Element;
+declare function SidebarNavGroup({ label, icon, children, defaultExpanded, groupId, className, forceMount, }: SidebarNavGroupProps): React__default.JSX.Element;
 interface SidebarNavItemProps {
     /** Item label */
     label: string;

package/dist/index.d.ts

@@ -1478,6 +1478,10 @@ interface UseDiarizationOptions {
     /** Load the ~50 MB speaker runtime + warm Whisper. Set false to keep it dormant until it's needed
      *  (e.g. a host feature that's off). Default true. */
     enabled?: boolean;
+    /** Anchor clusters against THIS namespace's enrolled voices — pass the same value used at enrollment
+     *  (`useVoiceSetup` / `VoiceManager`), or scoped users get "Speaker N" (or another user's labels)
+     *  from the legacy shared store. Omit for the original unscoped store. */
+    voiceprintNamespace?: string;
 }
 interface UseDiarizationResult {
     /** TitaNet runtime is loaded (diarization can run). */
@@ -1494,6 +1498,11 @@ declare function useDiarization(options?: UseDiarizationOptions): UseDiarization
 
 type HeyOzwellPhase = 'listening' | 'dictating' | 'transcribing';
 interface UseHeyOzwellOptions {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. A scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records); omit to keep the original shared store. Pass the SAME value to every voice
+     *  surface (`VoiceSetup` / `VoiceManager`), or verification and enrollment read different stores. */
+    voiceprintNamespace?: string;
     /** ON: "hey ozwell" opens the chat AND starts dictating. OFF: it just opens the chat and waits. */
     autoDictateOnWake?: boolean;
     /** Close the chat popup after "ozwell I'm done" transcribes + sends. */
@@ -1532,8 +1541,9 @@ interface UseHeyOzwellOptions {
      *  mishearing, then press send) instead of sending it automatically. An accuracy safety net for clinical
      *  use — off by default so the hands-free flow stays hands-free. */
     reviewBeforeSend?: boolean;
-    /** Diarization tuning for conversation mode (threshold, maxSpeakers, minSegmentSeconds, inferRoles). */
-    diarizationOptions?: Omit<UseDiarizationOptions, 'enabled'>;
+    /** Diarization tuning for conversation mode (threshold, maxSpeakers, minSegmentSeconds, inferRoles).
+     *  `enabled` and `voiceprintNamespace` are owned by the hook (conversationMode / the shared prop). */
+    diarizationOptions?: Omit<UseDiarizationOptions, 'enabled' | 'voiceprintNamespace'>;
 }
 /** Props to spread onto <HeyOzwellToggle>. */
 interface HeyOzwellToggleBindings {
@@ -1704,6 +1714,12 @@ interface ModelInfoListProps {
 declare function ModelInfoList({ status }: ModelInfoListProps): react_jsx_runtime.JSX.Element;
 
 interface HandsFreeChatProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id (`voiceprintNamespace={user.id}`). Scopes both the wake
+     *  verifier and the embedded VoiceManager; a scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records). Omit to keep the original shared store. Any standalone `VoiceSetup` /
+     *  `VoiceManager` the host renders must receive the SAME value. */
+    voiceprintNamespace?: string;
     /** Chat header title. */
     title?: string;
     /** Suggested-action chips for the empty state. */
@@ -1729,9 +1745,15 @@ interface HandsFreeChatProps {
     autoDictateOnWake?: boolean;
 }
 /** Say "hey ozwell" to dictate, "ozwell I'm done" to send — wake + speaker-verify + dictation + AIChat. */
-declare function HandsFreeChat({ title, suggestions, userName, logoSrc, transcription, requireDoctor, liveTranscript, conversationMode, reviewBeforeSend, autoDictateOnWake, }: HandsFreeChatProps): react_jsx_runtime.JSX.Element;
+declare function HandsFreeChat({ voiceprintNamespace, title, suggestions, userName, logoSrc, transcription, requireDoctor, liveTranscript, conversationMode, reviewBeforeSend, autoDictateOnWake, }: HandsFreeChatProps): react_jsx_runtime.JSX.Element;
 
 interface VoiceSetupProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. Enroll with the SAME value the verifying surface
+     *  (`useHeyOzwell` / `HandsFreeChat`) and `VoiceManager` use, or they can't see this enrollment.
+     *  A scoped store starts empty — no legacy unscoped records are inherited. Omit for the original
+     *  shared store. */
+    voiceprintNamespace?: string;
     /**
      * 'enroll' (default) = fresh first-time setup. 'add' = jump straight into appending a new voice/condition
      * to the existing voiceprints — what the settings menu's "Add a voice" uses, so the user doesn't have to
@@ -1750,17 +1772,28 @@ interface VoiceSetupProps {
     onCancel?: () => void;
 }
 /** On-device voice enrollment — tap the octopus, it pulses as you talk. Brand-aligned. */
-declare function VoiceSetup({ mode, voiceId, label, logoSrc, onDone, onCancel, }: VoiceSetupProps): react_jsx_runtime.JSX.Element;
+declare function VoiceSetup({ voiceprintNamespace, mode, voiceId, label, logoSrc, onDone, onCancel, }: VoiceSetupProps): react_jsx_runtime.JSX.Element;
 
 interface VoiceManagerProps {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. Must be the SAME value the verifying surface (`useHeyOzwell` /
+     *  `HandsFreeChat`) uses, or this page manages a different store than the one gating wakes (it would
+     *  look empty and enroll into the wrong store). A scoped store starts empty — no legacy unscoped
+     *  records are inherited. Omit to manage the original shared store. */
+    voiceprintNamespace?: string;
     /** Octopus logo source, forwarded to the enrollment screen. */
     logoSrc?: string;
 }
 /** The central voice-enrollment management page. */
-declare function VoiceManager({ logoSrc }: VoiceManagerProps): react_jsx_runtime.JSX.Element;
+declare function VoiceManager({ logoSrc, voiceprintNamespace, }: VoiceManagerProps): react_jsx_runtime.JSX.Element;
 
 type VoiceSetupPhase = 'intro' | 'getready' | 'speak' | 'gotit' | 'deny' | 'done';
 interface UseVoiceSetupOptions {
+    /** Isolates persisted enrollment (WHO + WHAT prints) from other users of the same browser profile —
+     *  e.g. pass the signed-in user's id. A scoped store starts empty (it does NOT inherit legacy
+     *  unscoped records); omit to keep the original shared store. Enroll with the SAME value the
+     *  verifying surface (`useHeyOzwell` / `HandsFreeChat`) uses, or it can't see this enrollment. */
+    voiceprintNamespace?: string;
     /** Start directly in "add a voice" (append) mode instead of a fresh enroll — for the settings menu's
      *  "Add a voice", which appends another authorized voice / condition to the existing voiceprints. */
     startAdding?: boolean;
@@ -1924,6 +1957,12 @@ interface UseSpeakerVerifyOpts {
     /** Set false to skip loading the ~50 MB sherpa/TitaNet runtime (e.g. when the doctor-only gate is off).
      *  Defaults to true so existing callers are unchanged. */
     enabled?: boolean;
+    /** Isolates persisted enrollment from other users of the same browser profile — e.g. pass the
+     *  signed-in user's id. Every returned method (enroll / verify / identify / listVoices / clear…)
+     *  operates on that scoped store, which starts empty: scoped records do NOT inherit the legacy
+     *  unscoped key. Use the SAME value across enrollment, verification, and management (`useVoiceSetup`,
+     *  `useHeyOzwell`, `VoiceManager`), or they read different stores. Omit for the original shared one. */
+    voiceprintNamespace?: string;
 }
 declare function useSpeakerVerify(opts?: UseSpeakerVerifyOpts): SpeakerVerifyHandle;
 
@@ -2089,18 +2128,6 @@ declare function askOzwell(messages: OzwellMessage[] | string, opts?: AskOpts):
  */
 declare function askOzwellStream(messages: OzwellMessage[] | string, onToken: (delta: string, full: string) => void, opts?: AskOpts): Promise<string>;
 
-/**
- * IndexedDB store for on-device voiceprints (enrollment vectors), replacing localStorage for this data.
- *
- * Why IndexedDB and not localStorage: it's asynchronous (off the main thread), stores `Float32Array`
- * natively via structured clone (no JSON-stringifying embeddings into bloated number arrays), and isn't
- * capped at ~5 MB. Why not OPFS: these are small *structured records* keyed by id, not large files —
- * IndexedDB is the right tool; OPFS is for the big model files.
- *
- * One object store, keyed by a string id; values are any structured-cloneable object, so `Float32Array`s
- * survive the round-trip intact. On first read of a key it migrates a legacy localStorage value (if a
- * parser is supplied) and then clears it.
- */
 /**
  * Read a voiceprint record. If IndexedDB has nothing for `key` but localStorage does, migrate it via
  * `migrateLegacy` (parse the old JSON string → the new shape), persist it to IndexedDB, and clear the
@@ -2111,9 +2138,9 @@ declare function getVoiceprints<T>(key: string, migrateLegacy?: (raw: string) =>
 declare function setVoiceprints(key: string, value: unknown): Promise<void>;
 /** Remove a voiceprint record (and any stale localStorage copy). */
 declare function clearVoiceprints(key: string): Promise<void>;
-declare function loadWhatPrints(): Promise<Record<string, Float32Array[]>>;
-declare function saveWhatPrints(map: Record<string, Float32Array[]>): Promise<void>;
-declare function clearWhatPrints(): Promise<void>;
+declare function loadWhatPrints(namespace?: string): Promise<Record<string, Float32Array[]>>;
+declare function saveWhatPrints(map: Record<string, Float32Array[]>, namespace?: string): Promise<void>;
+declare function clearWhatPrints(namespace?: string): Promise<void>;
 
 /**
  * Shared on-device audio helpers for Hey Ozwell — previously copy-pasted across the enrollment,
@@ -10167,8 +10194,27 @@ interface SidebarNavGroupProps {
     groupId?: string;
     /** Additional CSS classes */
     className?: string;
+    /**
+     * Keep items mounted when the group is collapsed, hidden via `hidden`.
+     *
+     * For groups whose children own DOM state that a remount would destroy —
+     * uncontrolled inputs, media playback position, an editor instance. State
+     * survives the group's own collapse *and* the desktop rail collapsing.
+     *
+     * Does **not** make collapsed items findable by in-page search: `hidden` is
+     * `display: none`, and browsers do not match text inside it. `hidden="until-found"`
+     * would deliver that, but it is not portable enough to build the API on yet.
+     *
+     * Mirrors `CollapsibleContent`'s prop of the same name, and carries the same
+     * caveat: this path does **not** animate. `hidden` is `display: none`, which
+     * an animated height cannot run through, and dropping it for the duration
+     * would let keyboard users tab into content that is visually collapsed. Not
+     * animating is the safe answer until `hidden` can be sequenced around the
+     * animation.
+     */
+    forceMount?: boolean;
 }
-declare function SidebarNavGroup({ label, icon, children, defaultExpanded, groupId, className, }: SidebarNavGroupProps): React__default.JSX.Element;
+declare function SidebarNavGroup({ label, icon, children, defaultExpanded, groupId, className, forceMount, }: SidebarNavGroupProps): React__default.JSX.Element;
 interface SidebarNavItemProps {
     /** Item label */
     label: string;