@admin-layout/tailwind-ui 12.2.4-alpha.7 → 12.2.4-alpha.79

package/lib/components/AIToolbar/components/types.d.ts

@@ -0,0 +1,194 @@
+import type { ChangeEvent, ClipboardEvent, Dispatch, KeyboardEvent, ReactNode, RefObject, SetStateAction } from 'react';
+export type ToolbarSelectedProvider = {
+    provider: string;
+    variables: Record<string, string>;
+};
+export type ToolbarAudioDevices = {
+    input: {
+        id: string;
+        name: string;
+    };
+    output: {
+        id: string;
+        name: string;
+    };
+};
+/**
+ * STT/AI provider row — kept structurally aligned with Pluely `TYPE_PROVIDER`
+ * so host hooks can satisfy {@link UseCompletionReturn} without casts.
+ */
+export type ToolbarAiProvider = {
+    id?: string;
+    streaming?: boolean;
+    responseContentPath?: string;
+    isCustom?: boolean;
+    curl: string;
+};
+/** File row shown in the attach popover (host may extend fields). */
+export type ToolbarAttachedFile = {
+    id: string;
+    name: string;
+    type?: string;
+    base64?: string;
+    size?: number;
+};
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+}
+export type ToolbarScreenshotConfiguration = {
+    mode: 'manual' | 'auto' | 'timer';
+    autoPrompt: string;
+    enabled: boolean;
+    /** Timer interval in seconds when mode === 'timer'. Min 10, default 600 (10 min). */
+    intervalSec?: number;
+    /** Apply ±20% jitter to the timer interval to vary capture timing. */
+    jitter?: boolean;
+};
+export interface ChatConversation {
+    id: string;
+    title: string;
+    messages: ChatMessage[];
+    createdAt: number;
+    updatedAt: number;
+}
+/** Optional flags passed to {@link UseCompletionReturn.submit} (e.g. regenerate). */
+export type CompletionSubmitOptions = {
+    /** Trim history from this assistant message onward and resubmit the preceding user turn. */
+    regenerateAssistantMessageId?: string;
+};
+export interface VadConfig {
+    enabled: boolean;
+    hop_size: number;
+    sensitivity_rms: number;
+    peak_threshold: number;
+    silence_chunks: number;
+    min_speech_chunks: number;
+    pre_speech_chunks: number;
+    noise_gate_threshold: number;
+    max_recording_duration_secs: number;
+}
+/**
+ * Shape returned by the host’s completion hook — everything the toolbar input stack needs.
+ */
+export interface UseCompletionReturn {
+    input: string;
+    setInput: (value: string) => void;
+    response: string;
+    setResponse: (value: string) => void;
+    isLoading: boolean;
+    error: string | null;
+    attachedFiles: ToolbarAttachedFile[];
+    addFile: (file: File) => Promise<void>;
+    removeFile: (fileId: string) => void;
+    clearFiles: () => void;
+    submit: (speechText?: string, opts?: CompletionSubmitOptions) => Promise<void>;
+    /** When implemented, per-message actions can regenerate that assistant reply. */
+    regenerateAssistantMessage?: (assistantMessageId: string) => Promise<void>;
+    cancel: () => void;
+    reset: () => void;
+    setState: Dispatch<SetStateAction<unknown>>;
+    enableVAD: boolean;
+    setEnableVAD: Dispatch<SetStateAction<boolean>>;
+    micOpen: boolean;
+    setMicOpen: Dispatch<SetStateAction<boolean>>;
+    currentConversationId: string | null;
+    conversationHistory: ChatMessage[];
+    loadConversation: (conversation: ChatConversation) => void;
+    startNewConversation: () => void;
+    messageHistoryOpen: boolean;
+    setMessageHistoryOpen: Dispatch<SetStateAction<boolean>>;
+    keepEngaged: boolean;
+    setKeepEngaged: Dispatch<SetStateAction<boolean>>;
+    screenshotConfiguration: ToolbarScreenshotConfiguration;
+    setScreenshotConfiguration: Dispatch<SetStateAction<ToolbarScreenshotConfiguration>>;
+    handleScreenshotSubmit: (base64: string, prompt?: string) => Promise<void>;
+    handleFileSelect: (e: ChangeEvent<HTMLInputElement>) => void;
+    handleKeyPress: (e: KeyboardEvent) => void;
+    handlePaste: (e: ClipboardEvent) => Promise<void>;
+    isPopoverOpen: boolean;
+    scrollAreaRef: RefObject<HTMLDivElement | null>;
+    resizeWindow: (expanded: boolean) => Promise<void>;
+    isFilesPopoverOpen: boolean;
+    setIsFilesPopoverOpen: Dispatch<SetStateAction<boolean>>;
+    onRemoveAllFiles: () => void;
+    inputRef: RefObject<HTMLInputElement | null>;
+    captureScreenshot: () => Promise<void>;
+    isScreenshotLoading: boolean;
+    selectedSttProvider: ToolbarSelectedProvider;
+    allSttProviders: ToolbarAiProvider[];
+    managedAiApiEnabled: boolean;
+    selectedAudioDevices: ToolbarAudioDevices;
+    /** Host wires STT (e.g. fetchSTT + provider selection). */
+    transcribeAudio: (audio: Blob) => Promise<string>;
+}
+export type AIToolbarHostPlatform = 'macos' | 'windows' | 'linux';
+/**
+ * System-audio popover: host implements permission + screenshot bridges; state comes from the host hook.
+ */
+export interface SystemAudioProps {
+    hasActiveLicense?: boolean;
+    supportsImages?: boolean;
+    checkSystemAudioAccess: () => Promise<boolean>;
+    requestSystemAudioAccess: () => Promise<void>;
+    /** Raw base64 PNG (no data: prefix). If omitted, screenshot control is hidden. */
+    captureSystemScreenshot?: () => Promise<string>;
+    capturing: boolean;
+    isProcessing: boolean;
+    isAIProcessing: boolean;
+    lastTranscription: string;
+    lastAIResponse: string;
+    error: string;
+    setupRequired: boolean;
+    startCapture: () => Promise<void>;
+    stopCapture: () => Promise<void>;
+    isPopoverOpen: boolean;
+    setIsPopoverOpen: Dispatch<SetStateAction<boolean>>;
+    useSystemPrompt: boolean;
+    setUseSystemPrompt: (value: boolean) => void;
+    contextContent: string;
+    setContextContent: (content: string) => void;
+    startNewConversation: () => void;
+    conversation: ChatConversation;
+    resizeWindow: (expanded: boolean) => void | Promise<void>;
+    quickActions: string[];
+    addQuickAction: (action: string) => void;
+    removeQuickAction: (action: string) => void;
+    isManagingQuickActions: boolean;
+    setIsManagingQuickActions: Dispatch<SetStateAction<boolean>>;
+    showQuickActions: boolean;
+    setShowQuickActions: Dispatch<SetStateAction<boolean>>;
+    handleQuickActionClick: (action: string) => Promise<void>;
+    vadConfig: VadConfig;
+    updateVadConfiguration: (config: VadConfig) => void;
+    isRecordingInContinuousMode: boolean;
+    recordingProgress: number;
+    manualStopAndSend: () => Promise<void>;
+    startContinuousRecording: () => Promise<void>;
+    ignoreContinuousRecording: () => Promise<void>;
+    scrollAreaRef: RefObject<HTMLDivElement | null>;
+    /** Optional host-provided content rendered under Settings dropdown. */
+    settingsDropdownContent?: ReactNode;
+    /** Optional footer (e.g. version, report bug) pinned under the scroll area, below Help & shortcuts. */
+    voicePopoverFooter?: ReactNode;
+    /** When false, omit native `title=` tooltips on primary voice popover controls (desktop bar setting). */
+    toolbarShowElementTitles?: boolean;
+}
+export type AIToolbarAppProps = {
+    isHidden?: boolean;
+    systemAudio: SystemAudioProps;
+    completion: UseCompletionReturn;
+    hasActiveLicense?: boolean;
+    supportsImages?: boolean;
+    cursorType?: string;
+    platform?: AIToolbarHostPlatform;
+    onOpenDashboard?: () => void | Promise<void>;
+    trailing?: ReactNode;
+    className?: string;
+    toolbarClassName?: string;
+    /** When false, omit native `title=` tooltips on toolbar controls (desktop bar setting). Default: show. */
+    showElementTitles?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/components/AIToolbar/components/types.d.ts.map

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

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.d.ts

@@ -0,0 +1,13 @@
+/** Entries fed from yantra marketplace uiLayout (`useMarketplaceCharacters`) before install. */
+export type MarketplaceCharacterEntry = {
+    name: string;
+    fileName?: string;
+    extensionId?: string;
+    extensionSlug?: string;
+    avatarSrc: string | null;
+};
+/** Dispatched when {@link setMarketplaceCharacters} updates the overlay list. */
+export declare const MARKETPLACE_CHARACTERS_CHANGED_EVENT = "yantra:marketplace-characters-changed";
+export declare function setMarketplaceCharacters(entries: MarketplaceCharacterEntry[]): void;
+export declare function getMarketplaceCharactersSnapshot(): MarketplaceCharacterEntry[];
+//# sourceMappingURL=marketplaceCharactersRegistry.d.ts.map

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceCharactersRegistry.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/marketplaceCharactersRegistry.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,yBAAyB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,oCAAoC,0CAA0C,CAAC;AAI5F,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAKnF;AAED,wBAAgB,gCAAgC,IAAI,yBAAyB,EAAE,CAE9E"}

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.js

@@ -0,0 +1,6 @@
+/** Dispatched when {@link setMarketplaceCharacters} updates the overlay list. */
+const MARKETPLACE_CHARACTERS_CHANGED_EVENT = 'yantra:marketplace-characters-changed';
+let marketplaceOverlay = [];
+function getMarketplaceCharactersSnapshot() {
+  return marketplaceOverlay;
+}export{MARKETPLACE_CHARACTERS_CHANGED_EVENT,getMarketplaceCharactersSnapshot};//# sourceMappingURL=marketplaceCharactersRegistry.js.map

package/lib/components/AIToolbar/hooks/marketplaceCharactersRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplaceCharactersRegistry.js","sources":["../../../../src/components/AIToolbar/hooks/marketplaceCharactersRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACY,0CAA4B,GAAA;IACpC,kBAAa,GAAA,EAAA;;;"}

package/lib/components/AIToolbar/hooks/useActiveCharacter.d.ts

@@ -0,0 +1,52 @@
+export interface ActiveCharacter {
+    /** Manifest `name` (or filesystem stem) — e.g. "Seraphina". */
+    name: string;
+    /** PNG card filename without extension — used to fetch avatar / sprites. */
+    fileName?: string;
+    /** Pre-baked `data:` URL for the avatar PNG, or null if not yet loaded. */
+    avatarSrc: string | null;
+}
+export interface CharacterListEntry {
+    name: string;
+    fileName?: string;
+    avatarSrc: string | null;
+}
+export interface CharacterPicker {
+    /** All installed characters with resolved avatars. */
+    characters: CharacterListEntry[];
+    /** Currently active character name, or null if none picked / none installed. */
+    activeName: string | null;
+    /** Switch the active character by name. Pass null to clear (revert to first). */
+    setActive: (name: string | null) => void;
+}
+/**
+ * Marketplace character entry — produced from `contributes.uiLayout` rows
+ * under `marketplace.characters.*`. Fed in from yantra-app via
+ * `setMarketplaceCharacters` so this package stays free of GraphQL deps.
+ */
+export interface MarketplaceCharacterEntry {
+    name: string;
+    fileName?: string;
+    extensionId?: string;
+    extensionSlug?: string;
+    /** Optional pre-resolved data URL (e.g. CDN avatar). Filesystem install will override. */
+    avatarSrc?: string | null;
+}
+/**
+ * Publish the current list of marketplace-contributed characters. Called by
+ * yantra-app after `useSettingsLoader({ configKey: 'marketplace.characters' })`
+ * resolves. Triggers a re-render of any active character hook.
+ */
+export declare function setMarketplaceCharacters(entries: MarketplaceCharacterEntry[]): void;
+/**
+ * Return the active character (name + avatar) or null when none is installed
+ * / we're not running under Tauri. Selection follows `pickActiveMerged` (file_name
+ * pref, then name pref) and stays in sync with `useCharacterPicker` / desktop settings.
+ */
+export declare function useActiveCharacter(): ActiveCharacter | null;
+/**
+ * Enumerate installed characters and switch the active one. Empty list and
+ * `activeName === null` outside Tauri / when nothing is installed.
+ */
+export declare function useCharacterPicker(): CharacterPicker;
+//# sourceMappingURL=useActiveCharacter.d.ts.map

package/lib/components/AIToolbar/hooks/useActiveCharacter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveCharacter.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,eAAe;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC5B,sDAAsD;IACtD,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,gFAAgF;IAChF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iFAAiF;IACjF,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5C;AASD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAkCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,IAAI,CASnF;AAkMD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAqC3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAmFpD"}

package/lib/components/AIToolbar/hooks/useActiveCharacter.js

@@ -0,0 +1,360 @@
+import*as React from'react';import {setPreferredActiveCharacterFileName,ACTIVE_CHARACTER_CHANGE_EVENT,readPreferredActiveCharacterFileName,ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY}from'../../../hooks/activeCharacterPreference.js';import {clearCharacterSpriteCache}from'./useCharacterSprite.js';import {MARKETPLACE_CHARACTERS_CHANGED_EVENT,getMarketplaceCharactersSnapshot}from'./marketplaceCharactersRegistry.js';// Active-character lookup for the AIToolbar.
+//
+// Surfaces the currently-selected character (name + avatar data URL) so the
+// completion popover and message history can show "Seraphina" with her avatar
+// instead of a generic "AI" label. Backed by the desktop Tauri commands
+// `character_list` and `character_get_avatar` (see
+// `yantra-app/portable-devices/desktop/src-tauri/src/features/character_feature/`).
+//
+// Degrades gracefully:
+//   - Outside Tauri (regular browser, SSR): returns null synchronously.
+//   - Tauri without any character-contributing extension installed: returns null.
+//   - Tauri with an extension but no avatar: returns name-only (avatarSrc = null).
+//
+// Re-fetches on the `yantra:character-refresh` Tauri event + the
+// `yantra:extensions-changed` window event (marketplace install/uninstall), and
+// re-resolves when either persisted preference changes:
+//   - `yantra:active-character-name` (name-based — CharacterPicker / toolbar), and/or
+//   - `yantra:active-character:file-name` + `yantra:active-character-change` (file_name
+//     + cross-webview emit — desktop settings / `activeCharacterPreference.ts`).
+//
+// When multiple characters are installed, resolution order is: **file_name**
+// preference first (so the dashboard bar and main app stay aligned), then
+// **name** preference (`yantra:active-character-name`), then `character_list[0]`.
+// Use `useCharacterPicker` to enumerate and switch by name (it also syncs
+// the file_name preference + Tauri fan-out).
+// constants
+const CHARACTER_REFRESH_EVENT = 'yantra:character-refresh';
+/**
+ * Window event dispatched by `yantra-app/portable-devices/desktop/src/utils/marketplaceInstall.ts`
+ * after the marketplace install / uninstall path triggers `character_refresh`.
+ * Listening here lets the avatar swap in without an app restart.
+ */
+const EXTENSIONS_CHANGED_EVENT = 'yantra:extensions-changed';
+/** Window event dispatched by `useCharacterPicker().setActive(...)` to notify subscribers. */
+const ACTIVE_CHARACTER_CHANGED_EVENT = 'yantra:active-character-changed';
+const ACTIVE_CHARACTER_STORAGE_KEY = 'yantra:active-character-name';
+/** Manifest contribution keys that should retrigger a character reload. */
+const CHARACTER_CONTRIBUTIONS = ['characters', 'uiLayout'];
+// marketplace registry (populated by yantra-app via setMarketplaceCharacters)
+let marketplaceRegistry = [];
+const marketplaceSubscribers = new Set();
+function subscribeMarketplace(cb) {
+  marketplaceSubscribers.add(cb);
+  return () => marketplaceSubscribers.delete(cb);
+}
+/**
+ * Publish the current list of marketplace-contributed characters. Called by
+ * yantra-app after `useSettingsLoader({ configKey: 'marketplace.characters' })`
+ * resolves. Triggers a re-render of any active character hook.
+ */
+function setMarketplaceCharacters(entries) {
+  marketplaceRegistry = Array.isArray(entries) ? entries : [];
+  marketplaceSubscribers.forEach(cb => {
+    try {
+      cb();
+    } catch {
+      // ignore subscriber errors
+    }
+  });
+}
+function getMarketplaceCharacters() {
+  return marketplaceRegistry;
+}
+/**
+ * Merge marketplace entries into the filesystem list. Filesystem wins on
+ * name conflicts (real avatar > stub), so the marketplace entry is dropped.
+ */
+function mergeWithMarketplace(filesystem, marketplace) {
+  if (marketplace.length === 0) return filesystem;
+  const seen = new Set(filesystem.map(c => c.name));
+  const extras = [];
+  for (const m of marketplace) {
+    if (!m.name || seen.has(m.name)) continue;
+    seen.add(m.name);
+    extras.push({
+      name: m.name,
+      file_name: m.fileName,
+      source: 'marketplace'
+    });
+  }
+  return extras.length ? [...filesystem, ...extras] : filesystem;
+}
+// helpers
+function isTauri() {
+  if (typeof window === 'undefined') return false;
+  const w = window;
+  return Boolean(w.__TAURI_INTERNALS__ ?? w.__TAURI__);
+}
+async function safeInvoke(cmd, args) {
+  if (!isTauri()) return null;
+  try {
+    // @ts-ignore — optional dynamic import, present as a peer dep in Tauri builds.
+    const mod = await import('@tauri-apps/api/core');
+    return await mod.invoke(cmd, args);
+  } catch {
+    return null;
+  }
+}
+async function safeListen(event, cb) {
+  if (!isTauri()) return () => {};
+  try {
+    // @ts-ignore — see safeInvoke note.
+    const mod = await import('@tauri-apps/api/event');
+    const unlisten = await mod.listen(event, e => cb(e.payload));
+    return unlisten;
+  } catch {
+    return () => {};
+  }
+}
+function readStoredActiveName() {
+  if (typeof window === 'undefined') return null;
+  try {
+    return window.localStorage.getItem(ACTIVE_CHARACTER_STORAGE_KEY);
+  } catch {
+    return null;
+  }
+}
+/**
+ * Decide whether an `extensions-changed` event is relevant to characters.
+ * Detail with no `contributes` array is treated as relevant (defensive
+ * reload) so we never miss a real change.
+ */
+function isCharacterRelevant(event) {
+  const detail = event.detail;
+  if (!detail || !Array.isArray(detail.contributes)) return true;
+  return detail.contributes.some(c => CHARACTER_CONTRIBUTIONS.includes(c));
+}
+function writeStoredActiveName(name) {
+  if (typeof window === 'undefined') return;
+  try {
+    if (name == null) window.localStorage.removeItem(ACTIVE_CHARACTER_STORAGE_KEY);else window.localStorage.setItem(ACTIVE_CHARACTER_STORAGE_KEY, name);
+  } catch {
+    // ignore quota / privacy-mode errors
+  }
+}
+async function fetchAvatarSrc(fileName) {
+  if (!fileName) return null;
+  const dto = await safeInvoke('character_get_avatar', {
+    fileName
+  });
+  if (!dto || !dto.base64 || dto.base64.length <= 100) return null;
+  return `data:${dto.mime_type || 'image/png'};base64,${dto.base64}`;
+}
+/**
+ * Choose the active row: **file_name** preference (desktop settings / cross-webview),
+ * else **name** preference (toolbar picker), else first in list.
+ */
+function pickActiveMerged(list) {
+  if (list.length === 0) return null;
+  const filePref = readPreferredActiveCharacterFileName();
+  if (filePref) {
+    const byFile = list.find(c => c.file_name === filePref);
+    if (byFile) return byFile;
+  }
+  const desiredName = readStoredActiveName();
+  if (desiredName) {
+    const byName = list.find(c => c.name === desiredName);
+    if (byName) return byName;
+  }
+  // No explicit selection: prefer an extension-contributed character over
+  // user-root cards so a freshly-installed extension (e.g. Seraphina) wins
+  // by default instead of dev/test residue sitting in the user data dir.
+  const extensionPick = list.find(c => c.source === 'extension');
+  if (extensionPick) return extensionPick;
+  return list[0];
+}
+/** Subscribe to both preference schemes + cross-webview Tauri event; bump resets derived selection. */
+function usePreferenceSyncBump() {
+  const [bump, setBump] = React.useState(0);
+  const bumpFn = React.useCallback(() => {
+    setBump(n => n + 1);
+  }, []);
+  return [bump, bumpFn];
+}
+function useCharacterPreferenceListeners(reload, bump) {
+  React.useEffect(() => {
+    let unlistenChar = null;
+    let unlistenFilePref = null;
+    let cancelled = false;
+    safeListen(CHARACTER_REFRESH_EVENT, () => {
+      clearCharacterSpriteCache();
+      void reload();
+      bump();
+    }).then(fn => {
+      if (cancelled) fn();else unlistenChar = fn;
+    });
+    safeListen(ACTIVE_CHARACTER_CHANGE_EVENT, () => {
+      clearCharacterSpriteCache();
+      bump();
+    }).then(fn => {
+      if (cancelled) fn();else unlistenFilePref = fn;
+    });
+    function onExtensionsChanged(e) {
+      if (!isCharacterRelevant(e)) return;
+      clearCharacterSpriteCache();
+      void reload();
+      bump();
+    }
+    function onActiveChanged() {
+      clearCharacterSpriteCache();
+      bump();
+    }
+    function onFilePrefLocal(e) {
+      clearCharacterSpriteCache();
+      bump();
+    }
+    function onStorageKey(ev) {
+      if (ev.key !== ACTIVE_CHARACTER_STORAGE_KEY && ev.key !== ACTIVE_CHARACTER_FILE_NAME_STORAGE_KEY && ev.key != null) {
+        return;
+      }
+      clearCharacterSpriteCache();
+      bump();
+    }
+    if (typeof window !== 'undefined') {
+      window.addEventListener(EXTENSIONS_CHANGED_EVENT, onExtensionsChanged);
+      window.addEventListener(ACTIVE_CHARACTER_CHANGED_EVENT, onActiveChanged);
+      window.addEventListener(ACTIVE_CHARACTER_CHANGE_EVENT, onFilePrefLocal);
+      window.addEventListener('storage', onStorageKey);
+    }
+    return () => {
+      cancelled = true;
+      if (unlistenChar) unlistenChar();
+      if (unlistenFilePref) unlistenFilePref();
+      if (typeof window !== 'undefined') {
+        window.removeEventListener(EXTENSIONS_CHANGED_EVENT, onExtensionsChanged);
+        window.removeEventListener(ACTIVE_CHARACTER_CHANGED_EVENT, onActiveChanged);
+        window.removeEventListener(ACTIVE_CHARACTER_CHANGE_EVENT, onFilePrefLocal);
+        window.removeEventListener('storage', onStorageKey);
+      }
+    };
+  }, [reload, bump]);
+}
+// main API
+/**
+ * Return the active character (name + avatar) or null when none is installed
+ * / we're not running under Tauri. Selection follows `pickActiveMerged` (file_name
+ * pref, then name pref) and stays in sync with `useCharacterPicker` / desktop settings.
+ */
+function useActiveCharacter() {
+  const [list, setList] = React.useState([]);
+  const [avatarSrc, setAvatarSrc] = React.useState(null);
+  const [bump, bumpFn] = usePreferenceSyncBump();
+  const reload = React.useCallback(async () => {
+    const next = await safeInvoke('character_list', {
+      shallow: false
+    });
+    setList(mergeWithMarketplace(next ?? [], getMarketplaceCharacters()));
+  }, []);
+  React.useEffect(() => {
+    void reload();
+    return subscribeMarketplace(() => {
+      void reload();
+    });
+  }, [reload]);
+  useCharacterPreferenceListeners(reload, bumpFn);
+  const active = React.useMemo(() => pickActiveMerged(list), [list, bump]);
+  React.useEffect(() => {
+    if (!active?.file_name) {
+      setAvatarSrc(null);
+      return;
+    }
+    let alive = true;
+    fetchAvatarSrc(active.file_name).then(src => {
+      if (alive) setAvatarSrc(src);
+    });
+    return () => {
+      alive = false;
+    };
+  }, [active?.file_name]);
+  if (!active) return null;
+  return {
+    name: active.name,
+    fileName: active.file_name,
+    avatarSrc
+  };
+}
+/**
+ * Enumerate installed characters and switch the active one. Empty list and
+ * `activeName === null` outside Tauri / when nothing is installed.
+ */
+function useCharacterPicker() {
+  const [list, setList] = React.useState([]);
+  const [avatars, setAvatars] = React.useState({});
+  const [bump, bumpFn] = usePreferenceSyncBump();
+  const [marketplaceBump, setMarketplaceBump] = React.useState(0);
+  React.useEffect(() => {
+    if (typeof window === 'undefined') return;
+    const onMk = () => setMarketplaceBump(n => n + 1);
+    window.addEventListener(MARKETPLACE_CHARACTERS_CHANGED_EVENT, onMk);
+    return () => window.removeEventListener(MARKETPLACE_CHARACTERS_CHANGED_EVENT, onMk);
+  }, []);
+  const reload = React.useCallback(async () => {
+    const next = await safeInvoke('character_list', {
+      shallow: false
+    });
+    setList(mergeWithMarketplace(next ?? [], getMarketplaceCharacters()));
+  }, []);
+  React.useEffect(() => {
+    void reload();
+    return subscribeMarketplace(() => {
+      void reload();
+    });
+  }, [reload]);
+  useCharacterPreferenceListeners(reload, bumpFn);
+  const activeName = React.useMemo(() => pickActiveMerged(list)?.name ?? null, [list, bump, marketplaceBump]);
+  // Resolve avatars for every character in the list (cached by file_name).
+  React.useEffect(() => {
+    let alive = true;
+    async function loadAll() {
+      const pending = list.filter(c => c.file_name && !(c.file_name in avatars));
+      if (pending.length === 0) return;
+      const entries = await Promise.all(pending.map(async c => [c.file_name, await fetchAvatarSrc(c.file_name)]));
+      if (!alive) return;
+      setAvatars(prev => {
+        const next = {
+          ...prev
+        };
+        for (const [key, src] of entries) next[key] = src;
+        return next;
+      });
+    }
+    void loadAll();
+    return () => {
+      alive = false;
+    };
+  }, [list, avatars]);
+  const characters = React.useMemo(() => {
+    const installed = list.map(c => ({
+      name: c.name,
+      fileName: c.file_name,
+      avatarSrc: c.file_name ? avatars[c.file_name] ?? null : null
+    }));
+    const seen = new Set(installed.map(c => c.name));
+    const extras = getMarketplaceCharactersSnapshot().filter(m => !seen.has(m.name)).map(m => ({
+      name: m.name,
+      fileName: m.fileName,
+      avatarSrc: m.avatarSrc ?? null
+    }));
+    return [...installed, ...extras];
+  }, [list, avatars, marketplaceBump]);
+  const setActive = React.useCallback(name => {
+    writeStoredActiveName(name);
+    const row = name ? list.find(c => c.name === name) : null;
+    void setPreferredActiveCharacterFileName(row?.file_name ?? null);
+    clearCharacterSpriteCache();
+    bumpFn();
+    if (typeof window !== 'undefined') {
+      window.dispatchEvent(new CustomEvent(ACTIVE_CHARACTER_CHANGED_EVENT, {
+        detail: {
+          name
+        }
+      }));
+    }
+  }, [list, bumpFn]);
+  return {
+    characters,
+    activeName,
+    setActive
+  };
+}export{setMarketplaceCharacters,useActiveCharacter,useCharacterPicker};//# sourceMappingURL=useActiveCharacter.js.map

package/lib/components/AIToolbar/hooks/useActiveCharacter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActiveCharacter.js","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"sourcesContent":[null],"names":[],"mappings":"2ZAyCA;;;;;;AAMI;AACH;AAED;;;AAGI;AACH;AAED;;;;AAII;;;AAGH;AASD;;;;;MASI,uBAAuB,GAAA,0BAAA;;AAEvB;AACH;AAkCD;;;;AAIG,MAAA,8BAAA,GAAA,iCAAA;AACH,MAAA,4BAAgB,GAAA;AA2MhB;;;;AAIG,MAAA,sBAAA,GAAA,IAAA,GAAA,EAAA;AACH,SAAA,oBAAgB,CAAA,EAAA,EAAA;AAuChB,EAAA,sBAAA,CAAA,GAAA,CAAA,EAAA,CAAA;;;AAGG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/hooks/useCharacterSprite.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the data URL for `(characterFileName, label)` or `null` while the
+ * sprite is loading / when running outside Tauri / when no character is set.
+ *
+ * Re-evaluates whenever either input changes. Cached results resolve in the
+ * same render (no transient `null`).
+ */
+export declare function useCharacterSprite(characterFileName: string | null | undefined, label: string | null | undefined): string | null;
+/**
+ * Clears the sprite cache. Call after `character_refresh` so newly-installed
+ * sprite packs aren't shadowed by stale data URLs.
+ */
+export declare function clearCharacterSpriteCache(): void;
+//# sourceMappingURL=useCharacterSprite.d.ts.map

package/lib/components/AIToolbar/hooks/useCharacterSprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCharacterSprite.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/useCharacterSprite.ts"],"names":[],"mappings":"AAqFA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC,MAAM,GAAG,IAAI,CAoBf;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD"}