@admin-layout/tailwind-ui 12.2.4-alpha.57 → 12.2.4-alpha.58

package/lib/components/AIToolbar/components/completion/AssistantAvatar.d.ts

@@ -1,4 +1,5 @@
 interface AssistantAvatarProps {
+    /** Static fallback avatar (default portrait). Used when no sprite is resolved. */
     avatarSrc: string | null;
     /** Optional message sequence number rendered as "#N" beneath the avatar. */
     index?: number;
@@ -6,7 +7,18 @@ interface AssistantAvatarProps {
     size?: number;
     /** Tailwind classes applied to the column wrapper. */
     className?: string;
+    /**
+     * Character `file_name` (i.e. the PNG card stem — "Seraphina"). When set
+     * together with `text`, the avatar switches to the matching expression
+     * sprite from the character's sprite folder.
+     */
+    characterFileName?: string | null;
+    /**
+     * Message text used to pick an emotion sprite. The classifier maps the
+     * text to one of 28 GoEmotions labels (`neutral`, `joy`, `caring`, ...).
+     */
+    text?: string | null;
 }
-export declare function AssistantAvatar({ avatarSrc, index, size, className }: AssistantAvatarProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantAvatar({ avatarSrc, index, size, className, characterFileName, text, }: AssistantAvatarProps): import("react/jsx-runtime").JSX.Element;
 export default AssistantAvatar;
 //# sourceMappingURL=AssistantAvatar.d.ts.map

package/lib/components/AIToolbar/components/completion/AssistantAvatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantAvatar.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/AssistantAvatar.tsx"],"names":[],"mappings":"AASA,UAAU,oBAAoB;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAS,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CA6B/F;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"AssistantAvatar.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/AssistantAvatar.tsx"],"names":[],"mappings":"AAgBA,UAAU,oBAAoB;IAC1B,kFAAkF;IAClF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,EAC5B,SAAS,EACT,KAAK,EACL,IAAS,EACT,SAAS,EACT,iBAAiB,EACjB,IAAI,GACP,EAAE,oBAAoB,2CA2CtB;AAED,eAAe,eAAe,CAAC"}

package/lib/components/AIToolbar/components/completion/AssistantAvatar.js

@@ -1,15 +1,27 @@
-import {jsxs,jsx}from'react/jsx-runtime';import'../../../../utils/isBrowser/index.js';import {cn}from'../../../../utils/util.js';import'react';import'fast-deep-equal/react.js';function AssistantAvatar({
+import {jsxs,jsx}from'react/jsx-runtime';import*as React from'react';import'../../../../utils/isBrowser/index.js';import {cn}from'../../../../utils/util.js';import'fast-deep-equal/react.js';import {useCharacterSprite}from'../../hooks/useCharacterSprite.js';import {classifyEmotion}from'../../utils/emotionClassifier.js';function AssistantAvatar({
   avatarSrc,
   index,
-  size = 44,
-  className
+  size = 60,
+  className,
+  characterFileName,
+  text
 }) {
   const hasNumber = typeof index === 'number';
+  // Pick an emotion only when we actually have a character that can supply
+  // a sprite — avoids burning a Tauri round-trip for non-Tauri builds.
+  const emotion = React.useMemo(() => {
+    if (!characterFileName || !text) return null;
+    return classifyEmotion(text);
+  }, [characterFileName, text]);
+  const spriteSrc = useCharacterSprite(characterFileName ?? null, emotion);
+  // Prefer the emotion sprite; fall back to the static avatar while it loads
+  // or when sprite resolution returned null (no character / outside Tauri).
+  const renderedSrc = spriteSrc ?? avatarSrc;
   return jsxs("div", {
     className: cn('flex shrink-0 flex-col items-center gap-1 pt-0.5', className),
     "aria-hidden": !hasNumber,
-    children: [avatarSrc ? jsx("img", {
-      src: avatarSrc,
+    children: [renderedSrc ? jsx("img", {
+      src: renderedSrc,
       alt: "",
       "aria-hidden": "true",
       draggable: false,

package/lib/components/AIToolbar/components/completion/AssistantAvatar.js.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantAvatar.js","sources":["../../../../../src/components/AIToolbar/components/completion/AssistantAvatar.tsx"],"sourcesContent":[null],"names":["_jsxs"],"mappings":"gLAWI,SAAA,eAAA,CAAA;WACM;OACN;MACA,GAAK,EAAE;;;AAGV,EAAA,MAAA,SAAA,GAAA,OAAA,KAAA,KAAA,QAAA;AAED,EAAA,OAAAA,IAAA,CAAA,KAAA,EAAA;AA+BA,IAAA,SAAA,EAAe,qDAAgB,EAAA,SAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"AssistantAvatar.js","sources":["../../../../../src/components/AIToolbar/components/completion/AssistantAvatar.tsx"],"sourcesContent":[null],"names":[],"mappings":"gUA+BI,SAAA,eAAA,CAAA;;;AAGG,EAAA,IAAA,GAAA,EAAA;AACH,EAAA,SAAO;AACV,EAAA,iBAAA;AAED,EAAA;AAoDA,CAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/components/completion/Input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/Input.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAQ/C,eAAO,MAAM,KAAK,GAAI,sTAsBnB,mBAAmB,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB,4CAyTA,CAAC"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/Input.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAQ/C,eAAO,MAAM,KAAK,GAAI,sTAsBnB,mBAAmB,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB,4CA6TA,CAAC"}

package/lib/components/AIToolbar/components/completion/Input.js

@@ -178,7 +178,9 @@ import {jsx,jsxs,Fragment}from'react/jsx-runtime';import {useRef,useMemo,useLayo
                   className: "flex w-full gap-3",
                   children: [jsx(AssistantAvatar, {
                     avatarSrc: character?.avatarSrc ?? null,
-                    index: idx + 1
+                    index: idx + 1,
+                    characterFileName: character?.fileName ?? null,
+                    text: msg.content
                   }), jsxs("div", {
                     className: "min-w-0 flex-1",
                     children: [jsxs("div", {
@@ -211,7 +213,9 @@ import {jsx,jsxs,Fragment}from'react/jsx-runtime';import {useRef,useMemo,useLayo
                   className: "flex w-full gap-3",
                   children: [jsx(AssistantAvatar, {
                     avatarSrc: character?.avatarSrc ?? null,
-                    index: sortedAsc.length + 1
+                    index: sortedAsc.length + 1,
+                    characterFileName: character?.fileName ?? null,
+                    text: response
                   }), jsxs("div", {
                     className: "min-w-0 flex-1",
                     children: [jsxs("div", {

package/lib/components/AIToolbar/components/completion/Input.js.map

@@ -1 +1 @@
-{"version":3,"file":"Input.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"Input.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/components/completion/MessageHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageHistory.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/MessageHistory.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C,UAAU,mBAAmB;IACzB,mBAAmB,EAAE,WAAW,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,GAAI,6FAK5B,mBAAmB,4CAuIrB,CAAC"}
+{"version":3,"file":"MessageHistory.d.ts","sourceRoot":"","sources":["../../../../../src/components/AIToolbar/components/completion/MessageHistory.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAM5C,UAAU,mBAAmB;IACzB,mBAAmB,EAAE,WAAW,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,GAAI,6FAK5B,mBAAmB,4CAyIrB,CAAC"}

package/lib/components/AIToolbar/components/completion/MessageHistory.js

@@ -101,7 +101,9 @@ import {jsxs,jsx,Fragment}from'react/jsx-runtime';import {MessageSquareText,Chev
               className: "flex w-full gap-3",
               children: [jsx(AssistantAvatar, {
                 avatarSrc: character?.avatarSrc ?? null,
-                index: arr.length - descIdx
+                index: arr.length - descIdx,
+                characterFileName: character?.fileName ?? null,
+                text: message.content
               }), jsxs("div", {
                 className: "min-w-0 flex-1",
                 children: [jsxs("div", {

package/lib/components/AIToolbar/components/completion/MessageHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessageHistory.js","sources":["../../../../../src/components/AIToolbar/components/completion/MessageHistory.tsx"],"sourcesContent":[null],"names":[],"mappings":"i1EAcC,MAAA,cAAA,GAAA,CAAA;AAED,EAAA,mBAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"MessageHistory.js","sources":["../../../../../src/components/AIToolbar/components/completion/MessageHistory.tsx"],"sourcesContent":[null],"names":[],"mappings":"i1EAcC,MAAA,cAAA,GAAA,CAAA;AAED,EAAA,mBAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"useActiveCharacter.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"names":[],"mappings":"AAwBA,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;AA2GD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CA8D3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAqFpD"}
+{"version":3,"file":"useActiveCharacter.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"names":[],"mappings":"AAyBA,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;AA2GD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAiE3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAqFpD"}

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

@@ -1,4 +1,4 @@
-import*as React from'react';// Active-character lookup for the AIToolbar.
+import*as React from'react';import {clearCharacterSpriteCache}from'./useCharacterSprite.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
@@ -122,6 +122,9 @@ function useActiveCharacter() {
     let unlisten = null;
     let cancelled = false;
     safeListen(CHARACTER_REFRESH_EVENT, () => {
+      // Sprites may have changed on disk (new install / uninstall); drop
+      // cached data URLs so the next render re-fetches.
+      clearCharacterSpriteCache();
       void reload();
     }).then(fn => {
       if (cancelled) fn();else unlisten = fn;

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

@@ -1 +1 @@
-{"version":3,"file":"useActiveCharacter.js","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"sourcesContent":[null],"names":[],"mappings":"4BAwBA;;;;;;AAMI;AACH;AAED;;;AAGI;AACH;AAED;;;;AAII;;AAGH;AA2GD,MAAA,uBAAA,GAAA,0BAAA;;;;AAIG;AACH;AAgEA,MAAA,wBAAA,GAAA,2BAAA;;;AAGG,MAAA,4BAAA,GAAA,8BAAA;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"useActiveCharacter.js","sources":["../../../../src/components/AIToolbar/hooks/useActiveCharacter.ts"],"sourcesContent":[null],"names":[],"mappings":"4FAyBA;;;;;;AAMI;AACH;AAED;;;AAGI;AACH;AAED;;;;AAII;;AA8GJ;;;;AAIG;AACH;AAmEA;;;AAGG,MAAA,8BAAA,GAAA,iCAAA;AACH,MAAA,4BAAgB,GAAA,8BAqFf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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"}

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

@@ -0,0 +1,103 @@
+import*as React from'react';// Expression-sprite lookup for assistant message bubbles.
+//
+// Resolves `(characterFileName, label)` → `data:image/png;base64,...` via the
+// Tauri command `character_get_expression`, with a module-level cache so the
+// same sprite is fetched at most once per session even when many messages map
+// to the same emotion.
+//
+// The Rust side (`character_get_expression`) already implements graceful
+// fallback through `neutral`/`joy`/avatar when the requested label is missing,
+// so callers can pass any of the 28 GoEmotions labels without first checking
+// which sprites the character actually ships.
+//
+// Degrades to `null` outside Tauri / when no character file_name is provided.
+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;
+  }
+}
+// Two layered caches keyed by `${fileName}::${label}`:
+//
+//   - `urlCache` resolves synchronously on subsequent calls (no re-render flicker).
+//   - `pendingCache` deduplicates concurrent fetches for the same key when
+//     several messages on screen happen to share the same emotion.
+const urlCache = new Map();
+const pendingCache = new Map();
+function cacheKey(fileName, label) {
+  return `${fileName}::${label}`;
+}
+async function fetchSprite(fileName, label) {
+  const key = cacheKey(fileName, label);
+  const cached = urlCache.get(key);
+  if (cached !== undefined) return cached;
+  const pending = pendingCache.get(key);
+  if (pending) return pending;
+  const promise = (async () => {
+    const dto = await safeInvoke('character_get_expression', {
+      fileName,
+      label
+    });
+    if (!dto || !dto.base64 || dto.base64.length < 100) {
+      urlCache.set(key, '');
+      return null;
+    }
+    const url = `data:${dto.mime_type || 'image/png'};base64,${dto.base64}`;
+    urlCache.set(key, url);
+    // If Rust fell back to a different label (sprite missing), also cache
+    // the resolved label so a subsequent call for it short-circuits.
+    if (dto.label && dto.label !== label) {
+      urlCache.set(cacheKey(fileName, dto.label), url);
+    }
+    return url;
+  })();
+  pendingCache.set(key, promise);
+  try {
+    return await promise;
+  } finally {
+    pendingCache.delete(key);
+  }
+}
+/**
+ * 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`).
+ */
+function useCharacterSprite(characterFileName, label) {
+  const key = characterFileName && label ? cacheKey(characterFileName, label) : null;
+  const cachedInitial = key ? urlCache.get(key) ?? null : null;
+  const [src, setSrc] = React.useState(cachedInitial && cachedInitial !== '' ? cachedInitial : null);
+  React.useEffect(() => {
+    if (!characterFileName || !label) {
+      setSrc(null);
+      return;
+    }
+    let alive = true;
+    fetchSprite(characterFileName, label).then(url => {
+      if (alive) setSrc(url);
+    });
+    return () => {
+      alive = false;
+    };
+  }, [characterFileName, label]);
+  return src;
+}
+/**
+ * Clears the sprite cache. Call after `character_refresh` so newly-installed
+ * sprite packs aren't shadowed by stale data URLs.
+ */
+function clearCharacterSpriteCache() {
+  urlCache.clear();
+  pendingCache.clear();
+}export{clearCharacterSpriteCache,useCharacterSprite};//# sourceMappingURL=useCharacterSprite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCharacterSprite.js","sources":["../../../../src/components/AIToolbar/hooks/useCharacterSprite.ts"],"sourcesContent":[null],"names":[],"mappings":"4BAqFA;;;;;;AAMG;AACH;AAyBA;;;AAGG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/lib/components/AIToolbar/utils/emotionClassifier.d.ts

@@ -0,0 +1,19 @@
+export type EmotionLabel = 'admiration' | 'amusement' | 'anger' | 'annoyance' | 'approval' | 'caring' | 'confusion' | 'curiosity' | 'desire' | 'disappointment' | 'disapproval' | 'disgust' | 'embarrassment' | 'excitement' | 'fear' | 'gratitude' | 'grief' | 'joy' | 'love' | 'nervousness' | 'neutral' | 'optimism' | 'pride' | 'realization' | 'relief' | 'remorse' | 'sadness' | 'surprise';
+/** All 28 labels, in the SillyTavern canonical order. */
+export declare const ALL_EMOTIONS: EmotionLabel[];
+/**
+ * Classify a chat-message string into one of the 28 GoEmotions labels.
+ *
+ * Returns `'neutral'` when no rule fires, which is what every sprite pack
+ * uses as the fallback (and what `character_get_expression` falls back to
+ * server-side when the requested sprite is missing).
+ *
+ * @param text - The assistant's message text. Markdown formatting is fine —
+ *               the regexes only care about word content.
+ * @param available - Optional restrict-set: only return labels present here.
+ *                    Useful when the caller knows which sprites the
+ *                    character actually ships and wants to avoid a Tauri
+ *                    round-trip for labels that will fall back anyway.
+ */
+export declare function classifyEmotion(text: string | null | undefined, available?: readonly string[]): EmotionLabel;
+//# sourceMappingURL=emotionClassifier.d.ts.map

package/lib/components/AIToolbar/utils/emotionClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionClassifier.d.ts","sourceRoot":"","sources":["../../../../src/components/AIToolbar/utils/emotionClassifier.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,YAAY,GAClB,YAAY,GACZ,WAAW,GACX,OAAO,GACP,WAAW,GACX,UAAU,GACV,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,SAAS,GACT,eAAe,GACf,YAAY,GACZ,MAAM,GACN,WAAW,GACX,OAAO,GACP,KAAK,GACL,MAAM,GACN,aAAa,GACb,SAAS,GACT,UAAU,GACV,OAAO,GACP,aAAa,GACb,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEjB,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,YAAY,EA6BtC,CAAC;AAgNF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAuB5G"}

package/lib/components/AIToolbar/utils/emotionClassifier.js

@@ -0,0 +1,142 @@
+// Lightweight emotion classifier for assistant message text.
+//
+// Picks one of the 28 SillyTavern / GoEmotions labels so the AIToolbar can
+// switch the assistant's avatar to the matching expression sprite (see
+// `packages-extensions/seraphina-character-extension/characters/Seraphina/`
+// for the canonical sprite layout: `neutral.png`, `joy.png`, `caring.png`,
+// `surprise.png`, etc.).
+//
+// This is intentionally a heuristic (regex/keyword scoring) — fast, offline,
+// no model dependency — and is the same shape (`text → label`) as a real
+// GoEmotions classifier, so it can be transparently swapped for an ONNX
+// transformer later without touching the call sites.
+//
+// Limitations:
+//   - English only; would need rework for i18n responses.
+//   - Misses subtle nuance (sarcasm, mixed emotions) — picks the *strongest*
+//     signal and never returns more than one label.
+//   - Stage directions in italics ("smiles warmly") count the same as inline
+//     dialogue; that's actually desirable for character-card style replies
+//     where mood lives in the prose.
+/** All 28 labels, in the SillyTavern canonical order. */
+const RULES = [{
+  label: 'joy',
+  patterns: [/\b(happy|happiness|joy(ful)?|delight(ed|ful)?|cheerful|glad)\b/gi, /\b(smile[sd]?|grin(s|ned|ning)?|beam(s|ing|ed)?)\b/gi, /:\)|=\)|<3+/g]
+}, {
+  label: 'amusement',
+  patterns: [/\b(laugh(s|ed|ing|ter)?|chuckle[sd]?|giggle[sd]?|snicker(s|ed|ing)?)\b/gi, /\b(amus(ed|ing|ement)|funny|hilarious|teasing)\b/gi, /\bha+ha+\b/gi, /lol\b/gi]
+}, {
+  label: 'love',
+  patterns: [/\b(i love you|love you|my love|beloved|darling|sweetheart|dearest)\b/gi, /\b(adore[sd]?|cherish(ed|es)?|smitten)\b/gi],
+  weight: 2
+}, {
+  label: 'caring',
+  patterns: [/\b(gentle(ly)?|tender(ly)?|softly|kind(ly|ness)?|warm(ly|th)?|reassuring(ly)?)\b/gi, /\b(comfort(s|ed|ing)?|soothing(ly)?|protect(s|ing|ed)?|nurturing)\b/gi, /\b(are you (ok|okay|alright)|how are you feeling|don'?t worry)\b/gi]
+}, {
+  label: 'admiration',
+  patterns: [/\b(impressive|impressed|brilliant|magnificent|incredible|amazing|remarkable|astonishing|stunning|breathtaking)\b/gi, /\b(well done|great job|so proud of you)\b/gi]
+}, {
+  label: 'approval',
+  patterns: [/\b(approve|agree|exactly|precisely|that'?s right|good idea|sounds good|works for me)\b/gi, /\b(yes,?\s+(of course|absolutely|certainly))/gi]
+}, {
+  label: 'disapproval',
+  patterns: [/\b(disapprove|that'?s wrong|i don'?t agree|i wouldn'?t|shouldn'?t have)\b/gi, /\b(unacceptable|not okay)\b/gi]
+}, {
+  label: 'anger',
+  patterns: [/\b(angry|furious|enraged|seething|livid|outraged)\b/gi, /\b(scowl(s|ed|ing)?|glare[sd]?|snarl(s|ed|ing)?|growl(s|ed|ing)?)\b/gi, /\bhow dare you\b/gi],
+  weight: 2
+}, {
+  label: 'annoyance',
+  patterns: [/\b(annoy(ed|ing|ance)?|irritat(ed|ing|ion)|frustrat(ed|ing|ion))\b/gi, /\b(sigh(s|ed|ing)?|huff(s|ed|ing)?|rolls? (her|his|their) eyes)\b/gi, /\b(ugh|tsk)\b/gi]
+}, {
+  label: 'fear',
+  patterns: [/\b(afraid|scared|terrified|frightened|fearful|horrified)\b/gi, /\b(trembl(es|ed|ing)|shiver(s|ed|ing)?|flinch(es|ed|ing)?)\b/gi, /\b(panic(ked|king)?|dread)\b/gi],
+  weight: 2
+}, {
+  label: 'nervousness',
+  patterns: [/\b(nervous(ly|ness)?|anxious(ly)?|uneasy|jittery|tense(ly)?|on edge)\b/gi, /\b(fidget(s|ed|ing)?|bites? (her|his|their) lip|wrings? (her|his|their) hands)\b/gi]
+}, {
+  label: 'sadness',
+  patterns: [/\b(sad(ness|ly)?|unhappy|sorrow(ful)?|heartbroken|miserable|melancholy|forlorn)\b/gi, /\b(tear(s|ful|y)|crying|weep(s|ing|ed)?|sob(s|bing|bed)?)\b/gi, /:\(/g],
+  weight: 2
+}, {
+  label: 'grief',
+  patterns: [/\b(grief|grieving|mourn(s|ed|ing)?|bereaved|devastated)\b/gi, /\b(loss of|passed away|gone forever)\b/gi],
+  weight: 2
+}, {
+  label: 'remorse',
+  patterns: [/\b(i'?m sorry|i am sorry|my apologies|apologi[sz]e|forgive me|regret(s|ted|ting)?|guilty|guilt)\b/gi, /\b(shouldn'?t have|wish i hadn'?t)\b/gi],
+  weight: 2
+}, {
+  label: 'disappointment',
+  patterns: [/\b(disappointed|disappointing|let down|underwhelm(ed|ing)?|expected (more|better))\b/gi]
+}, {
+  label: 'embarrassment',
+  patterns: [/\b(embarrass(ed|ing|ment)?|flustered|mortified|sheepish(ly)?)\b/gi, /\b(blush(es|ed|ing)?|cheeks (turn|burn|flush))\b/gi]
+}, {
+  label: 'disgust',
+  patterns: [/\b(disgust(ed|ing)?|revolted|repulsed|nauseat(ed|ing)|gross|yuck|ew)\b/gi, /\b(grimace[sd]?|wrinkles? (her|his|their) nose)\b/gi]
+}, {
+  label: 'excitement',
+  patterns: [/\b(excited(ly)?|thrilled|exhilarat(ed|ing)|exhilaration|elated|ecstatic|stoked|pumped)\b/gi, /\b(can'?t wait|bouncing|jumps? up)\b/gi]
+}, {
+  label: 'gratitude',
+  patterns: [/\b(thank you|thanks|thank(ful|fully)?|grateful(ly)?|appreciat(e|ed|ing|ion))\b/gi],
+  weight: 2
+}, {
+  label: 'pride',
+  patterns: [/\b(proud(ly)?|pride)\b/gi, /\b(chin (held )?high|stands? tall)\b/gi]
+}, {
+  label: 'relief',
+  patterns: [/\b(relief|relieved|reliev(es|ed|ing)?)\b/gi, /\b(exhale[sd]? (deeply|slowly)|breathes? out)\b/gi]
+}, {
+  label: 'optimism',
+  patterns: [/\b(hopeful(ly)?|optimist(ic)?|things will (work|turn) out|look(ing)? forward|we'?ll figure)\b/gi]
+}, {
+  label: 'desire',
+  patterns: [/\b(crave[sd]?|yearn(s|ed|ing)?|long(s|ed|ing) for|want(s|ed|ing)? you|need(s|ed|ing)? you)\b/gi, /\b(lean(s|ed|ing)? in close|breathless)\b/gi]
+}, {
+  label: 'curiosity',
+  patterns: [/\b(curious(ly)?|curiosity|intrigu(ed|ing)|wonder(s|ed|ing)? (about|what|why|how))\b/gi, /\btell me more\b/gi]
+}, {
+  label: 'confusion',
+  patterns: [/\b(confus(ed|ing|ion)|puzzl(ed|ing)|baffl(ed|ing)|perplex(ed|ing))\b/gi, /\b(tilts? (her|his|their) head|raises? an eyebrow|i don'?t understand|what do you mean)\b/gi, /\?\?+/g]
+}, {
+  label: 'realization',
+  patterns: [/\b(realiz(es|ed|ing)|realisation|i see now|of course!|that makes sense|finally understand)\b/gi, /\b(aha|eureka)\b/gi]
+}, {
+  label: 'surprise',
+  patterns: [/\b(surpris(ed|ing|e)|astonish(ed|ing)|astounded|shocked|stunned|taken aback)\b/gi, /\b(gasp(s|ed|ing)?|eyes (widen|go wide))\b/gi, /\b(oh!|wha[at]?\?!)/gi]
+}];
+/**
+ * Classify a chat-message string into one of the 28 GoEmotions labels.
+ *
+ * Returns `'neutral'` when no rule fires, which is what every sprite pack
+ * uses as the fallback (and what `character_get_expression` falls back to
+ * server-side when the requested sprite is missing).
+ *
+ * @param text - The assistant's message text. Markdown formatting is fine —
+ *               the regexes only care about word content.
+ * @param available - Optional restrict-set: only return labels present here.
+ *                    Useful when the caller knows which sprites the
+ *                    character actually ships and wants to avoid a Tauri
+ *                    round-trip for labels that will fall back anyway.
+ */
+function classifyEmotion(text, available) {
+  if (!text) return 'neutral';
+  let bestLabel = 'neutral';
+  let bestScore = 0;
+  for (const rule of RULES) {
+    const weight = rule.weight ?? 1;
+    let score = 0;
+    for (const pattern of rule.patterns) {
+      const matches = text.match(pattern);
+      if (matches) score += matches.length * weight;
+    }
+    if (score > bestScore) {
+      bestScore = score;
+      bestLabel = rule.label;
+    }
+  }
+  return bestLabel;
+}export{classifyEmotion};//# sourceMappingURL=emotionClassifier.js.map

package/lib/components/AIToolbar/utils/emotionClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotionClassifier.js","sources":["../../../../src/components/AIToolbar/utils/emotionClassifier.ts"],"sourcesContent":[null],"names":[],"mappings":"AAqBA;AA8BA;AACA;AA6OA;;;;;;;;;;;;;AAaG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@admin-layout/tailwind-ui",
-    "version": "12.2.4-alpha.57",
+    "version": "12.2.4-alpha.58",
     "description": "Sample core for higher packages to depend on",
     "license": "ISC",
     "author": "CDMBase LLC",
@@ -96,5 +96,5 @@
     "typescript": {
         "definition": "lib/index.d.ts"
     },
-    "gitHead": "134adf9207d6cad519b1fd25f4c39615b3682354"
+    "gitHead": "4cf5febc99804338d85d52ec12787d7bbb661bad"
 }