mixdog 1.2.6 → 1.3.1

package/src/runtime/shared/agent-avatar-sprites.mjs

@@ -0,0 +1,445 @@
+// The mascot's pixel art as string layers on its 16x12 grid
+// (design/mockups/mixy-art): one string per row, '.' an empty cell and one
+// letter a colour key (see MASCOT_INKS in agent-avatar.mjs: B body, D ears
+// (0.7 of the body), L light marks, E the eye ink, the rest fixed inks). Each
+// species names its tail and legs and carries its ears and marks (nose
+// included); eyes and accessories are shared layers.
+export const MASCOT_SPRITES = Object.freeze({
+  body: [
+    '................',
+    '................',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '...BBBBBBBBBB...',
+    '................',
+    '................',
+  ],
+  tails: {
+    dog: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '..............B.',
+      '.............BB.',
+      '................',
+      '................',
+      '................',
+    ],
+    curl: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '.............BB.',
+      '.............BB.',
+      '................',
+      '................',
+      '................',
+    ],
+  },
+  legs: {
+    dog: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '...B.B....B.B...',
+      '...B.B....B.B...',
+    ],
+    short: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '...B.B....B.B...',
+      '................',
+    ],
+  },
+  species: {
+    labrador: {
+      tail: 'dog',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '................',
+        '................',
+        '................',
+        '.DD..........DD.',
+        '.DD..........DD.',
+        '.DD..........DD.',
+        '.DD..........DD.',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '.......KK.......',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    shepherd: {
+      tail: 'dog',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '..DD........DD..',
+        '...DD......DD...',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '......DKKD......',
+        '......DDDD......',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    terrier: {
+      tail: 'dog',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '................',
+        '...DDD....DDD...',
+        '..D..........D..',
+        '..D..........D..',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '.......KK.......',
+        '.....LLLLLL.....',
+        '......LLLL......',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    corgi: {
+      tail: 'dog',
+      legs: 'short',
+      eye: 'K',
+      ears: [
+        '...DD......DD...',
+        '...DDD....DDD...',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '.......LL.......',
+        '.......LL.......',
+        '.......LL.......',
+        '.......LL.......',
+        '......LKKL......',
+        '......LLLL......',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    husky: {
+      tail: 'dog',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '..DD........DD..',
+        '...DD......DD...',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '...DDDD..DDDD...',
+        '...DDDD..DDDD...',
+        '...DD......DD...',
+        '................',
+        '......LKKL......',
+        '.....LLLLLL.....',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    shiba: {
+      tail: 'curl',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '....D......D....',
+        '...DD......DD...',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '...LL.LKKL.LL...',
+        '...LLLLLLLLLL...',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+    },
+    mixy: {
+      tail: 'dog',
+      legs: 'dog',
+      eye: 'K',
+      ears: [
+        '............D...',
+        '............DD..',
+        '.............D..',
+        '.DD..........D..',
+        '.DD.............',
+        '.DD.............',
+        '.DD.............',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+      ],
+      marks: [
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '................',
+        '.......KK.......',
+        '................',
+        '...SSSSSSSSSS...',
+        '.......GG.......',
+        '......GGGG......',
+        '.......GG.......',
+      ],
+    },
+  },
+  eyes: {
+    calm: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '.....E....E.....',
+      '.....E....E.....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+    happy: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '.....E....E.....',
+      '....E.E..E.E....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+    wink: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '.....E..........',
+      '.....E...EEE....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+    sleepy: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '....EEE..EEE....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+  },
+  accessories: {
+    collar: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '...RRRRRRRRRR...',
+      '.......GG.......',
+      '................',
+      '................',
+    ],
+    glasses: [
+      '................',
+      '................',
+      '................',
+      '....SSS..SSS....',
+      '....S.SSSS.S....',
+      '....S.S..S.S....',
+      '....SSS..SSS....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+    beanie: [
+      '.......WW.......',
+      '....NNNNNNNN....',
+      '...nnnnnnnnnn...',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+    scarf: [
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '...RRrRRrRRRR...',
+      '....Rr..........',
+      '................',
+      '................',
+    ],
+    bow: [
+      '................',
+      '.........FFF....',
+      '.........FfF....',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+      '................',
+    ],
+  },
+});

package/src/runtime/shared/agent-avatar.d.mts

@@ -0,0 +1,64 @@
+export interface MascotLook {
+  species: string;
+  accessory: string;
+  expression: string;
+}
+export interface MascotAvatar extends MascotLook {
+  kind: 'mascot';
+  color: string;
+}
+export type AgentAvatarState = 'idle' | 'typing' | 'message';
+export interface CustomAvatar {
+  kind: 'custom';
+  /** File names; `idle` is required and every missing state falls back to it. */
+  states: { idle: string } & Partial<Record<AgentAvatarState, string>>;
+}
+export type AgentAvatarValue = MascotAvatar | CustomAvatar;
+export interface MascotCell {
+  x: number;
+  y: number;
+  fill: string;
+}
+export interface MascotParts {
+  tail: MascotCell[];
+  legs: MascotCell[];
+  body: MascotCell[];
+  ear: MascotCell[];
+  marks: MascotCell[];
+  eyes: MascotCell[];
+  blink: MascotCell[];
+  accessory: MascotCell[];
+}
+export interface AvatarImageInfo {
+  format: 'png' | 'gif' | 'webp';
+  width: number;
+  height: number;
+  animated: boolean;
+}
+export const AGENT_AVATAR_COLORS: readonly string[];
+export const MASCOT_SPECIES: readonly string[];
+export const MASCOT_ACCESSORIES: readonly string[];
+export const MASCOT_EXPRESSIONS: readonly string[];
+export const MASCOT_INKS: Readonly<Record<string, string>>;
+export const MIXY_AVATAR: Readonly<MascotAvatar>;
+export const AGENT_AVATAR_STATES: readonly AgentAvatarState[];
+export const AGENT_AVATAR_LATER_STATES: readonly string[];
+export const AGENT_AVATAR_IMAGE_FILE: RegExp;
+export const AGENT_AVATAR_STATE_FILE: RegExp;
+export const AGENT_AVATAR_DIR: string;
+export const AGENT_AVATAR_IMAGE_MAX_BYTES: number;
+export const AGENT_AVATAR_IMAGE_MAX_SIDE: number;
+export function shadeHex(hex: string, k: number): string;
+export function mascotFromVariant(variant: string): MascotLook | null;
+export function mascotLook(avatar: MascotLook): string;
+export function mascotParts(avatar: MascotLook & { color: string }): MascotParts | null;
+export function mascotCells(avatar: MascotLook & { color: string }): MascotCell[];
+export function cellPaths(cells: readonly MascotCell[]): Array<{ fill: string; d: string }>;
+export function agentAvatarStatePath(file: string): string;
+export function avatarPosterFile(file: string): string;
+export function customAvatarStateFile(avatar: CustomAvatar, state: AgentAvatarState): string;
+export function avatarImageInfo(bytes: Uint8Array): AvatarImageInfo | null;
+export function agentAvatarImageProblem(bytes: Uint8Array): string;
+export function normalizeAgentAvatar(value: unknown): AgentAvatarValue | null;
+export function defaultAgentAvatar(id: string): MascotAvatar;
+export function agentAvatar(id: string, stored: unknown): AgentAvatarValue;