@admin-layout/tailwind-ui 12.2.4-alpha.9 → 12.2.4-alpha.98

package/lib/hooks/activeCharacterPreference.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Persisted preference for which installed character card is **active**
+ * across the toolbar + dashboard webviews (`character_list[].file_name` stem —
+ * e.g. `"Aria"`, `"Seraphina"`).
+ *
+ * Mirrors the `useChatBackground` pattern: localStorage + `storage` events +
+ * Tauri `emit`/`listen` so the dashboard sees the selection without sharing a
+ * `window` reference with the floating bar.
+ */
+/** localStorage key — exported for `storage` listeners in other hooks. */
+export declare const ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY = "yantra:active-character:file-name";
+/** Event name broadcast when the preferred character changes (payload: `{ fileName: string | null }`). */
+export declare const ACTIVE_CHARACTER_CHANGE_EVENT = "yantra:active-character-change";
+export declare function readPreferredActiveCharacterFileName(): string | null;
+/**
+ * Write the user's character choice and fan out so every webview recomputes
+ * active character (toolbar + `/chat`).
+ */
+export declare function setPreferredActiveCharacterFileName(fileName: string | null): Promise<void>;
+/** Pick the character row that matches the stored preference; otherwise the
+ *  default-slot character (see `characterSlotsPreference`); otherwise list[0]. */
+export declare function resolveActiveCharacterFromList<T extends {
+    file_name?: string | null;
+}>(list: T[] | null | undefined): T | null;
+//# sourceMappingURL=activeCharacterPreference.d.ts.map

package/lib/hooks/activeCharacterPreference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeCharacterPreference.d.ts","sourceRoot":"","sources":["../../src/hooks/activeCharacterPreference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,0EAA0E;AAC1E,eAAO,MAAM,sCAAsC,sCAAsC,CAAC;AAE1F,0GAA0G;AAC1G,eAAO,MAAM,6BAA6B,mCAAmC,CAAC;AAE9E,wBAAgB,oCAAoC,IAAI,MAAM,GAAG,IAAI,CAOpE;AAYD;;;GAGG;AACH,wBAAsB,mCAAmC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhG;AAED;kFACkF;AAClF,wBAAgB,8BAA8B,CAAC,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAClF,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAC7B,CAAC,GAAG,IAAI,CAcV"}

package/lib/hooks/activeCharacterPreference.js

@@ -0,0 +1,71 @@
+import {readDefaultCharacterFileName}from'./characterSlotsPreference.js';/**
+ * Persisted preference for which installed character card is **active**
+ * across the toolbar + dashboard webviews (`character_list[].file_name` stem —
+ * e.g. `"Aria"`, `"Seraphina"`).
+ *
+ * Mirrors the `useChatBackground` pattern: localStorage + `storage` events +
+ * Tauri `emit`/`listen` so the dashboard sees the selection without sharing a
+ * `window` reference with the floating bar.
+ */
+/** localStorage key — exported for `storage` listeners in other hooks. */
+const ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY = 'yantra:active-character:file-name';
+/** Event name broadcast when the preferred character changes (payload: `{ fileName: string | null }`). */
+const ACTIVE_CHARACTER_CHANGE_EVENT = 'yantra:active-character-change';
+function readPreferredActiveCharacterFileName() {
+  if (typeof window === 'undefined') return null;
+  try {
+    return window.localStorage.getItem(ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY);
+  } catch {
+    return null;
+  }
+}
+async function safeEmit(event, payload) {
+  try {
+    // @ts-ignore optional dynamic import
+    const mod = await import('@tauri-apps/api/event');
+    await mod.emit(event, payload);
+  } catch {
+    /* non-Tauri or event module missing */
+  }
+}
+/**
+ * Write the user's character choice and fan out so every webview recomputes
+ * active character (toolbar + `/chat`).
+ */
+async function setPreferredActiveCharacterFileName(fileName) {
+  if (typeof window === 'undefined') return;
+  try {
+    if (fileName && fileName.trim()) {
+      window.localStorage.setItem(ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY, fileName.trim());
+    } else {
+      window.localStorage.removeItem(ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY);
+    }
+  } catch {
+    // ignore quota
+  }
+  window.dispatchEvent(new CustomEvent(ACTIVE_CHARACTER_CHANGE_EVENT, {
+    detail: {
+      fileName: fileName?.trim() || null
+    }
+  }));
+  await safeEmit(ACTIVE_CHARACTER_CHANGE_EVENT, {
+    fileName: fileName?.trim() || null
+  });
+}
+/** Pick the character row that matches the stored preference; otherwise the
+ *  default-slot character (see `characterSlotsPreference`); otherwise list[0]. */
+function resolveActiveCharacterFromList(list) {
+  if (!list?.length) return null;
+  const pref = readPreferredActiveCharacterFileName();
+  if (pref) {
+    const match = list.find(c => c.file_name === pref);
+    if (match) return match;
+  }
+  // Fallback: the file_name assigned to the user's default slot (1–9).
+  const slotFile = readDefaultCharacterFileName();
+  if (slotFile) {
+    const match = list.find(c => c.file_name === slotFile);
+    if (match) return match;
+  }
+  return list[0] ?? null;
+}export{ACTIVE_CHARACTER_CHANGE_EVENT,ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY,readPreferredActiveCharacterFileName,resolveActiveCharacterFromList,setPreferredActiveCharacterFileName};//# sourceMappingURL=activeCharacterPreference.js.map

package/lib/hooks/activeCharacterPreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeCharacterPreference.js","sources":["../../src/hooks/activeCharacterPreference.ts"],"sourcesContent":[null],"names":[],"mappings":"yEAAA;;;;;;;;AAQG;AAKH;AAEA,MAAA,sCAAA,GAAA;AACA;AAEA,MAAA,6BAAgB,GAAA;AAmBhB,SAAA,oCAAA,GAAA;;;AAGG,IAAA,OAAA,MAAA,CAAA,YAAA,CAAA,OAAA,CAAA,sCAAA,CAAA;AACH,EAAA,CAAA,CAAA,MAAA;AAqBA,IAAA,OAAA,IAAA;AACkF,EAAA;AAClF;AAA2D,eAAU,QAAQ,CAAA,KAAO,EAAA,OAAA,EAAA;AAAE,EAAA,IAClF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/hooks/characterOverrides.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-character overrides (Phase C):
+ *   - `voiceId`   → preferred cloud-TTS voice id (e.g. ElevenLabs voice id)
+ *   - `addendum`  → extra system-prompt text appended to the persona
+ *
+ * Storage keys (per character `file_name`):
+ *   `yantra:character-voice-id:<file_name>`
+ *   `yantra:character-addendum:<file_name>`
+ *
+ * Mirrors `characterSlotsPreference.ts`: localStorage + same-tab DOM event +
+ * cross-webview Tauri event so any panel reflects edits immediately.
+ */
+export declare const CHARACTER_OVERRIDES_CHANGE_EVENT = "yantra:character-overrides-change";
+export interface CharacterOverrides {
+    voiceId: string;
+    addendum: string;
+}
+export declare function readCharacterVoiceId(fileName: string): string;
+export declare function readCharacterAddendum(fileName: string): string;
+export declare function readCharacterOverrides(fileName: string): CharacterOverrides;
+export declare function setCharacterVoiceId(fileName: string, voiceId: string): void;
+export declare function setCharacterAddendum(fileName: string, addendum: string): void;
+export declare function setCharacterOverrides(fileName: string, next: Partial<CharacterOverrides>): void;
+/**
+ * Subscribe to overrides for a single character `file_name`.  Updates on
+ * same-tab events, cross-tab `storage` events, and Tauri cross-webview emits.
+ */
+export declare function useCharacterOverrides(fileName: string | null | undefined): CharacterOverrides;
+//# sourceMappingURL=characterOverrides.d.ts.map

package/lib/hooks/characterOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterOverrides.d.ts","sourceRoot":"","sources":["../../src/hooks/characterOverrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,eAAO,MAAM,gCAAgC,sCAAsC,CAAC;AAKpF,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AA2CD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAM3E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI7E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAK/F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,CA8C7F"}

package/lib/hooks/characterOverrides.js

@@ -0,0 +1,130 @@
+import*as React from'react';/**
+ * Per-character overrides (Phase C):
+ *   - `voiceId`   → preferred cloud-TTS voice id (e.g. ElevenLabs voice id)
+ *   - `addendum`  → extra system-prompt text appended to the persona
+ *
+ * Storage keys (per character `file_name`):
+ *   `yantra:character-voice-id:<file_name>`
+ *   `yantra:character-addendum:<file_name>`
+ *
+ * Mirrors `characterSlotsPreference.ts`: localStorage + same-tab DOM event +
+ * cross-webview Tauri event so any panel reflects edits immediately.
+ */
+const CHARACTER_OVERRIDES_CHANGE_EVENT = 'yantra:character-overrides-change';
+const VOICE_ID_PREFIX = 'yantra:character-voice-id:';
+const ADDENDUM_PREFIX = 'yantra:character-addendum:';
+const EMPTY = {
+  voiceId: '',
+  addendum: ''
+};
+function safeGet(key) {
+  if (typeof window === 'undefined') return '';
+  try {
+    return window.localStorage.getItem(key) ?? '';
+  } catch {
+    return '';
+  }
+}
+function safeSet(key, value) {
+  if (typeof window === 'undefined') return;
+  try {
+    if (value) window.localStorage.setItem(key, value);else window.localStorage.removeItem(key);
+  } catch {
+    /* quota */
+  }
+}
+async function safeEmit(event, payload) {
+  try {
+    // @ts-ignore optional peer
+    const mod = await import('@tauri-apps/api/event');
+    await mod.emit(event, payload);
+  } catch {
+    /* non-Tauri */
+  }
+}
+function broadcast(fileName) {
+  if (typeof window === 'undefined') return;
+  window.dispatchEvent(new CustomEvent(CHARACTER_OVERRIDES_CHANGE_EVENT, {
+    detail: {
+      fileName
+    }
+  }));
+  void safeEmit(CHARACTER_OVERRIDES_CHANGE_EVENT, {
+    fileName
+  });
+}
+function readCharacterVoiceId(fileName) {
+  if (!fileName) return '';
+  return safeGet(VOICE_ID_PREFIX + fileName).trim();
+}
+function readCharacterAddendum(fileName) {
+  if (!fileName) return '';
+  return safeGet(ADDENDUM_PREFIX + fileName);
+}
+function readCharacterOverrides(fileName) {
+  if (!fileName) return EMPTY;
+  return {
+    voiceId: readCharacterVoiceId(fileName),
+    addendum: readCharacterAddendum(fileName)
+  };
+}
+function setCharacterVoiceId(fileName, voiceId) {
+  if (!fileName) return;
+  safeSet(VOICE_ID_PREFIX + fileName, voiceId.trim());
+  broadcast(fileName);
+}
+function setCharacterAddendum(fileName, addendum) {
+  if (!fileName) return;
+  safeSet(ADDENDUM_PREFIX + fileName, addendum);
+  broadcast(fileName);
+}
+function setCharacterOverrides(fileName, next) {
+  if (!fileName) return;
+  if (typeof next.voiceId === 'string') safeSet(VOICE_ID_PREFIX + fileName, next.voiceId.trim());
+  if (typeof next.addendum === 'string') safeSet(ADDENDUM_PREFIX + fileName, next.addendum);
+  broadcast(fileName);
+}
+/**
+ * Subscribe to overrides for a single character `file_name`.  Updates on
+ * same-tab events, cross-tab `storage` events, and Tauri cross-webview emits.
+ */
+function useCharacterOverrides(fileName) {
+  const key = fileName ?? '';
+  const [snap, setSnap] = React.useState(() => readCharacterOverrides(key));
+  React.useEffect(() => {
+    if (typeof window === 'undefined') return;
+    setSnap(readCharacterOverrides(key));
+    if (!key) return;
+    const refresh = e => {
+      // Only re-read when our character (or any character) changed.
+      const detail = e?.detail;
+      if (detail?.fileName && detail.fileName !== key) return;
+      setSnap(readCharacterOverrides(key));
+    };
+    window.addEventListener(CHARACTER_OVERRIDES_CHANGE_EVENT, refresh);
+    window.addEventListener('storage', refresh);
+    let unlistenTauri = null;
+    let cancelled = false;
+    (async () => {
+      try {
+        // @ts-ignore optional peer
+        const mod = await import('@tauri-apps/api/event');
+        const off = await mod.listen(CHARACTER_OVERRIDES_CHANGE_EVENT, e => {
+          const fn = e.payload?.fileName;
+          if (fn && fn !== key) return;
+          setSnap(readCharacterOverrides(key));
+        });
+        if (cancelled) off();else unlistenTauri = off;
+      } catch {
+        /* non-Tauri */
+      }
+    })();
+    return () => {
+      cancelled = true;
+      window.removeEventListener(CHARACTER_OVERRIDES_CHANGE_EVENT, refresh);
+      window.removeEventListener('storage', refresh);
+      if (unlistenTauri) unlistenTauri();
+    };
+  }, [key]);
+  return snap;
+}export{CHARACTER_OVERRIDES_CHANGE_EVENT,readCharacterAddendum,readCharacterOverrides,readCharacterVoiceId,setCharacterAddendum,setCharacterOverrides,setCharacterVoiceId,useCharacterOverrides};//# sourceMappingURL=characterOverrides.js.map

package/lib/hooks/characterOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterOverrides.js","sources":["../../src/hooks/characterOverrides.ts"],"sourcesContent":[null],"names":[],"mappings":"4BAAA;;;;;;;;;;;AAWG;sCASgC,GAAA;MAC/B,eAAgB,GAAA,4BAAA;MAChB,eAAiB,GAAA,4BAAA;AACpB,MAAA,KAAA,GAAA;AA2CD,EAAA,OAAA,EAAA,EAAA;AAKA,EAAA,QAAA,EAAA;AAKA,CAAA;AAQA,SAAA,OAAA,CAAA,GAAA,EAAA;AAMA,EAAA,IAAA,OAAA,MAAA,KAAgB,WAAA,EAAA,OAAoB,EAAC;AAMrC,EAAA,IAAA;AAOA,IAAA,OAAA,MAAA,CAAA,YAAA,CAAA,OAAA,CAAA,GAAA,CAAA,IAAA,EAAA;;;AAGG,EAAA;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/hooks/characterSlotsPreference.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Persisted character slots 1–9 — user-managed bookmarks of installed
+ * characters.  Each slot points to a character `file_name` (e.g. `"Aria"`).
+ *
+ * One slot is marked **default** and is used at startup when no other active
+ * character preference is set (see `resolveActiveCharacterFromList`).
+ *
+ * Mirrors `activeCharacterPreference.ts`: localStorage + custom DOM event +
+ * Tauri broadcast so every webview reacts to changes.
+ */
+export declare const CHARACTER_SLOTS_STORAGE_KEY = "yantra:character-slots";
+export declare const CHARACTER_SLOTS_DEFAULT_KEY = "yantra:character-slots:default";
+export declare const CHARACTER_SLOTS_CHANGE_EVENT = "yantra:character-slots-change";
+export type SlotNumber = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+export type CharacterSlots = Partial<Record<SlotNumber, string>>;
+export declare const SLOT_NUMBERS: readonly SlotNumber[];
+export declare function readCharacterSlots(): CharacterSlots;
+export declare function readDefaultSlot(): SlotNumber;
+export declare function writeCharacterSlots(next: CharacterSlots): Promise<void>;
+export declare function setSlot(slot: SlotNumber, fileName: string | null): Promise<void>;
+export declare function setDefaultSlot(slot: SlotNumber): Promise<void>;
+/** Returns the file_name assigned to the default slot, if any. */
+export declare function readDefaultCharacterFileName(): string | null;
+export interface UseCharacterSlotsResult {
+    slots: CharacterSlots;
+    defaultSlot: SlotNumber;
+    setSlot: (slot: SlotNumber, fileName: string | null) => Promise<void>;
+    setDefaultSlot: (slot: SlotNumber) => Promise<void>;
+}
+/** Subscribe to the persisted slot map + default slot.  Updates on
+ *  same-tab events, cross-tab `storage` events, and Tauri cross-webview emits. */
+export declare function useCharacterSlots(): UseCharacterSlotsResult;
+//# sourceMappingURL=characterSlotsPreference.d.ts.map

package/lib/hooks/characterSlotsPreference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterSlotsPreference.d.ts","sourceRoot":"","sources":["../../src/hooks/characterSlotsPreference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,2BAA2B,mCAAmC,CAAC;AAC5E,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAE5E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAyC,CAAC;AAMxF,wBAAgB,kBAAkB,IAAI,cAAc,CAiBnD;AAED,wBAAgB,eAAe,IAAI,UAAU,CAS5C;AAsBD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpE;AAED,kEAAkE;AAClE,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAI5D;AAMD,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED;kFACkF;AAClF,wBAAgB,iBAAiB,IAAI,uBAAuB,CAyC3D"}

package/lib/hooks/characterSlotsPreference.js

@@ -0,0 +1,141 @@
+import*as React from'react';/**
+ * Persisted character slots 1–9 — user-managed bookmarks of installed
+ * characters.  Each slot points to a character `file_name` (e.g. `"Aria"`).
+ *
+ * One slot is marked **default** and is used at startup when no other active
+ * character preference is set (see `resolveActiveCharacterFromList`).
+ *
+ * Mirrors `activeCharacterPreference.ts`: localStorage + custom DOM event +
+ * Tauri broadcast so every webview reacts to changes.
+ */
+const CHARACTER_SLOTS_STORAGE_KEY = 'yantra:character-slots';
+const CHARACTER_SLOTS_DEFAULT_KEY = 'yantra:character-slots:default';
+const CHARACTER_SLOTS_CHANGE_EVENT = 'yantra:character-slots-change';
+const SLOT_NUMBERS = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+function isSlotNumber(n) {
+  return Number.isInteger(n) && n >= 1 && n <= 9;
+}
+function readCharacterSlots() {
+  if (typeof window === 'undefined') return {};
+  try {
+    const raw = window.localStorage.getItem(CHARACTER_SLOTS_STORAGE_KEY);
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    const out = {};
+    for (const [key, value] of Object.entries(parsed)) {
+      const n = Number(key);
+      if (isSlotNumber(n) && typeof value === 'string' && value.trim()) {
+        out[n] = value.trim();
+      }
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
+function readDefaultSlot() {
+  if (typeof window === 'undefined') return 1;
+  try {
+    const raw = window.localStorage.getItem(CHARACTER_SLOTS_DEFAULT_KEY);
+    const n = raw ? Number(raw) : 1;
+    return isSlotNumber(n) ? n : 1;
+  } catch {
+    return 1;
+  }
+}
+async function safeEmit(event, payload) {
+  try {
+    // @ts-ignore optional dynamic import
+    const mod = await import('@tauri-apps/api/event');
+    await mod.emit(event, payload);
+  } catch {
+    /* non-Tauri */
+  }
+}
+function broadcast(slots, defaultSlot) {
+  if (typeof window === 'undefined') return;
+  window.dispatchEvent(new CustomEvent(CHARACTER_SLOTS_CHANGE_EVENT, {
+    detail: {
+      slots,
+      defaultSlot
+    }
+  }));
+  void safeEmit(CHARACTER_SLOTS_CHANGE_EVENT, {
+    slots,
+    defaultSlot
+  });
+}
+async function writeCharacterSlots(next) {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(CHARACTER_SLOTS_STORAGE_KEY, JSON.stringify(next));
+  } catch {
+    /* quota */
+  }
+  broadcast(next, readDefaultSlot());
+}
+async function setSlot(slot, fileName) {
+  const current = readCharacterSlots();
+  if (fileName && fileName.trim()) {
+    current[slot] = fileName.trim();
+  } else {
+    delete current[slot];
+  }
+  await writeCharacterSlots(current);
+}
+async function setDefaultSlot(slot) {
+  if (typeof window === 'undefined') return;
+  try {
+    window.localStorage.setItem(CHARACTER_SLOTS_DEFAULT_KEY, String(slot));
+  } catch {
+    /* quota */
+  }
+  broadcast(readCharacterSlots(), slot);
+}
+/** Returns the file_name assigned to the default slot, if any. */
+function readDefaultCharacterFileName() {
+  const slots = readCharacterSlots();
+  const defSlot = readDefaultSlot();
+  return slots[defSlot] ?? null;
+}
+/** Subscribe to the persisted slot map + default slot.  Updates on
+ *  same-tab events, cross-tab `storage` events, and Tauri cross-webview emits. */
+function useCharacterSlots() {
+  const [snapshot, setSnapshot] = React.useState(() => ({
+    slots: readCharacterSlots(),
+    defaultSlot: readDefaultSlot()
+  }));
+  React.useEffect(() => {
+    if (typeof window === 'undefined') return;
+    const refresh = () => setSnapshot({
+      slots: readCharacterSlots(),
+      defaultSlot: readDefaultSlot()
+    });
+    window.addEventListener(CHARACTER_SLOTS_CHANGE_EVENT, refresh);
+    window.addEventListener('storage', refresh);
+    let unlistenTauri = null;
+    let cancelled = false;
+    (async () => {
+      try {
+        // @ts-ignore optional peer
+        const mod = await import('@tauri-apps/api/event');
+        const off = await mod.listen(CHARACTER_SLOTS_CHANGE_EVENT, refresh);
+        if (cancelled) off();else unlistenTauri = off;
+      } catch {
+        /* non-Tauri */
+      }
+    })();
+    return () => {
+      cancelled = true;
+      window.removeEventListener(CHARACTER_SLOTS_CHANGE_EVENT, refresh);
+      window.removeEventListener('storage', refresh);
+      if (unlistenTauri) unlistenTauri();
+    };
+  }, []);
+  return {
+    slots: snapshot.slots,
+    defaultSlot: snapshot.defaultSlot,
+    setSlot,
+    setDefaultSlot
+  };
+}export{CHARACTER_SLOTS_CHANGE_EVENT,CHARACTER_SLOTS_DEFAULT_KEY,CHARACTER_SLOTS_STORAGE_KEY,SLOT_NUMBERS,readCharacterSlots,readDefaultCharacterFileName,readDefaultSlot,setDefaultSlot,setSlot,useCharacterSlots,writeCharacterSlots};//# sourceMappingURL=characterSlotsPreference.js.map

package/lib/hooks/characterSlotsPreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterSlotsPreference.js","sources":["../../src/hooks/characterSlotsPreference.ts"],"sourcesContent":[null],"names":[],"mappings":"4BAAA;;;;;;;;;AASG;AAEH,MAAA,2BAAa,GAAA;AACb,MAAA,2BAAa,GAAA;AACb,MAAA,4BAAa,GAAA;AAED,kBAAa,IAAI,CAAC,EAAA,CAAG,EAAC,CAAA,EAAI,GAAG,CAAC,EAAA,CAAG,EAAC,CAAA,EAAI,GAAG,CAAC;AACtD,SAAM,YAAM,CAAA,CAAA,EAAA;AAEZ,EAAA,OAAA,MAAO,UAAM,CAAA,CAAA,CAAA,IAAA,CAAY,IAAE,CAAA,IAAA,CAAA,IAAS,CAAA;AAMpC;AAmBA,SAAA,kBAAgB,GAAA;AA+BhB,EAAA,IAAA,OAAA,MAAA,KAAsB,WAAA,EAAA,OAAoB,EAAA;AAU1C,EAAA,IAAA;AAUA,IAAA,MAAA,GAAA,GAAA,MAAA,CAAA,YAAsB,CAAA,OAAmB,CAAA,2BAA4B,CAQpE;AAED,IAAA,IAAA,CAAA,GAAA,EAAA,OAAA,EAAA;AACA,IAAA,MAAA,MAAA,GAAA,IAAA,CAAgB,KAAA,CAAA,GAAA,CAAA;AAUhB,IAAA,cAAiB;IACb,KAAK,iBAAiB,CAAA,IAAA,MAAA,CAAA,OAAA,CAAA,MAAA,CAAA,EAAA;MACtB,MAAA,CAAA,GAAW,WAAY;AACvB,MAAA,IAAA,YAAgB,CAAA,CAAA,CAAA,IAAA,OAAY,KAAQ,KAAE,YAAa,KAAK,CAAA,IAAQ,EAAA,EAAI;QACpE,GAAA,CAAA,CAAA,CAAA,GAAA,KAAiB,CAAA,IAAM,EAAA;AAC1B,MAAA;AAED,IAAA;AACkF,IAAA,OAAA,GAAA;AAClF,EAAA,CAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/hooks/index.d.ts

@@ -1,3 +1,7 @@
+export * from './activeCharacterPreference';
+export * from './characterSlotsPreference';
+export * from './characterOverrides';
+export * from './useGlobalShortcutBridge';
 export * from './useTheme';
 export * from './useWindowSize';
 export * from './useToast';

package/lib/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/lib/hooks/useGlobalShortcutBridge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Subscribes to native global-shortcut events emitted by the Tauri shell and
+ * dispatches them to the local React app state.
+ *
+ * Currently handles:
+ *   - `bar:switch-slot` `{ slot: 0..9 }` — activates the character assigned to
+ *     the given slot.  `slot === 0` resolves to the user-chosen default slot.
+ *
+ * No-op in non-Tauri environments.  Mount this hook once near the desktop bar
+ * root so the listener lives for the lifetime of the bar webview.
+ */
+/**
+ * Browser CustomEvent names dispatched by this bridge when the corresponding
+ * Tauri global shortcut fires. Consumers (e.g. voice hook, activity-tracker
+ * UI) listen on `window` to react to the shortcut.
+ */
+export declare const BAR_TOGGLE_MIC_EVENT = "yantra:toggle-mic";
+export declare const BAR_TOGGLE_AUDIO_EVENT = "yantra:toggle-audio";
+export declare const BAR_TOGGLE_EYE_EVENT = "yantra:toggle-eye";
+export declare function useGlobalShortcutBridge(): void;
+//# sourceMappingURL=useGlobalShortcutBridge.d.ts.map

package/lib/hooks/useGlobalShortcutBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalShortcutBridge.d.ts","sourceRoot":"","sources":["../../src/hooks/useGlobalShortcutBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsBH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAC5D,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,wBAAgB,uBAAuB,IAAI,IAAI,CA6C9C"}

package/lib/hooks/useGlobalShortcutBridge.js

@@ -0,0 +1,68 @@
+import*as React from'react';import {readCharacterSlots,readDefaultSlot}from'./characterSlotsPreference.js';import {setPreferredActiveCharacterFileName}from'./activeCharacterPreference.js';/**
+ * Subscribes to native global-shortcut events emitted by the Tauri shell and
+ * dispatches them to the local React app state.
+ *
+ * Currently handles:
+ *   - `bar:switch-slot` `{ slot: 0..9 }` — activates the character assigned to
+ *     the given slot.  `slot === 0` resolves to the user-chosen default slot.
+ *
+ * No-op in non-Tauri environments.  Mount this hook once near the desktop bar
+ * root so the listener lives for the lifetime of the bar webview.
+ */
+function resolveSlotFileName(slot) {
+  const slots = readCharacterSlots();
+  if (slot === 0) {
+    const defaultSlot = readDefaultSlot();
+    return slots[defaultSlot] ?? null;
+  }
+  if (slot >= 1 && slot <= 9) {
+    return slots[slot] ?? null;
+  }
+  return null;
+}
+/**
+ * Browser CustomEvent names dispatched by this bridge when the corresponding
+ * Tauri global shortcut fires. Consumers (e.g. voice hook, activity-tracker
+ * UI) listen on `window` to react to the shortcut.
+ */
+const BAR_TOGGLE_MIC_EVENT = 'yantra:toggle-mic';
+const BAR_TOGGLE_AUDIO_EVENT = 'yantra:toggle-audio';
+const BAR_TOGGLE_EYE_EVENT = 'yantra:toggle-eye';
+function useGlobalShortcutBridge() {
+  React.useEffect(() => {
+    if (typeof window === 'undefined') return;
+    let cancelled = false;
+    const offs = [];
+    (async () => {
+      try {
+        // @ts-ignore optional Tauri runtime
+        const mod = await import('@tauri-apps/api/event');
+        const off = await mod.listen('bar:switch-slot', event => {
+          const slot = event.payload?.slot;
+          if (typeof slot !== 'number') return;
+          const fileName = resolveSlotFileName(slot);
+          if (!fileName) {
+            console.debug(`[GlobalShortcut] slot ${slot} is empty; ignoring`);
+            return;
+          }
+          setPreferredActiveCharacterFileName(fileName);
+        });
+        offs.push(off);
+        const relays = [['bar:toggle-mic', BAR_TOGGLE_MIC_EVENT], ['bar:toggle-audio', BAR_TOGGLE_AUDIO_EVENT], ['bar:toggle-eye', BAR_TOGGLE_EYE_EVENT]];
+        for (const [tauriEvent, domEvent] of relays) {
+          const offRelay = await mod.listen(tauriEvent, () => {
+            window.dispatchEvent(new CustomEvent(domEvent));
+          });
+          offs.push(offRelay);
+        }
+        if (cancelled) offs.forEach(f => f());
+      } catch {
+        /* non-Tauri environment — nothing to listen to */
+      }
+    })();
+    return () => {
+      cancelled = true;
+      offs.forEach(f => f());
+    };
+  }, []);
+}export{BAR_TOGGLE_AUDIO_EVENT,BAR_TOGGLE_EYE_EVENT,BAR_TOGGLE_MIC_EVENT,useGlobalShortcutBridge};//# sourceMappingURL=useGlobalShortcutBridge.js.map

package/lib/hooks/useGlobalShortcutBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalShortcutBridge.js","sources":["../../src/hooks/useGlobalShortcutBridge.ts"],"sourcesContent":[null],"names":[],"mappings":"4LAAA;;;;;;;;;;AAUG;;AA0BA,EAAA,MAAA,KAAA,GAAA,kBAAA,EAAA;AACH,EAAA,IAAA,IAAA,KAAO,CAAA,EAAA;AACP,IAAA,MAAA,WAAa,GAAA,eAAA,EAAA;AACb,IAAA,OAAA,KAAO,CAAA,WAAM,CAAA,IAAA,IAAA;AAEb,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/hooks/useToast.d.ts

@@ -11,7 +11,7 @@ export interface ToastOptions {
 }
 export declare const ToastContainer: ({ children }: {
     children: React.ReactNode;
-}) => React.JSX.Element;
+}) => import("react/jsx-runtime").JSX.Element;
 export declare const useToast: () => (options: ToastOptions) => void;
 export declare const useToastCloseAll: () => () => void;
 //# sourceMappingURL=useToast.d.ts.map

package/lib/hooks/useToast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../src/hooks/useToast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAKtE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC;IACxF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AA+GD,eAAO,MAAM,cAAc,GAAI,cAAc;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,sBAgCzE,CAAC;AAGF,eAAO,MAAM,QAAQ,kBA/IA,YAAY,KAAK,IAqJrC,CAAC;AAGF,eAAO,MAAM,gBAAgB,cAvJT,IA6JnB,CAAC"}
+{"version":3,"file":"useToast.d.ts","sourceRoot":"","sources":["../../src/hooks/useToast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAKtE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC;IACxF,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AA+GD,eAAO,MAAM,cAAc,GAAI,cAAc;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,4CAgCzE,CAAC;AAGF,eAAO,MAAM,QAAQ,kBA/IA,YAAY,KAAK,IAqJrC,CAAC;AAGF,eAAO,MAAM,gBAAgB,cAvJT,IA6JnB,CAAC"}