peepface 0.0.0-stage → 0.1.0

package/dist/peepface.js

@@ -0,0 +1,329 @@
+/* peepface v0.1.0 — 由 build.mjs 从 core.js 生成，不要手改 */
+/* peepface core — 工厂版
+ * createFace(container, options) → { setState, getState, destroy }
+ * 无状态判定、无全局单例，可在一页里同时跑多个实例。
+ */
+(function (root) {
+  'use strict';
+
+  const DEG = Math.PI / 180;
+  const SAMPLES = 64;
+  const R = 56;
+
+  /* ---------------- 几何 ---------------- */
+
+  const cross = (a, b) => [a[1]*b[2]-a[2]*b[1], a[2]*b[0]-a[0]*b[2], a[0]*b[1]-a[1]*b[0]];
+  const norm = v => { const l = Math.hypot(...v) || 1; return [v[0]/l, v[1]/l, v[2]/l]; };
+
+  const sphere = (lon, lat) => {
+    const lo = lon * DEG, la = lat * DEG;
+    return [Math.sin(lo)*Math.cos(la), Math.sin(la), Math.cos(lo)*Math.cos(la)];
+  };
+
+  const rotate = (n, yaw, pitch) => {
+    const a = yaw * DEG, b = pitch * DEG;
+    const x1 =  n[0]*Math.cos(a) + n[2]*Math.sin(a);
+    const z1 = -n[0]*Math.sin(a) + n[2]*Math.cos(a);
+    const y2 =  n[1]*Math.cos(b) - z1*Math.sin(b);
+    const z2 =  n[1]*Math.sin(b) + z1*Math.cos(b);
+    return [x1, y2, z2];
+  };
+
+  const tangentFrame = n => {
+    let u = cross([0, 1, 0], n);
+    if (Math.hypot(...u) < 1e-6) u = [1, 0, 0];
+    u = norm(u);
+    return { u, v: norm(cross(n, u)) };
+  };
+
+  /* 椭圆眼形：用两段 A 命令，带旋转角。
+     之前的 capsule 实现在 hw > hh（横条）时两端圆心重合，会退化成圆。 */
+  function eyePath(cx, cy, ux, uy, hw, hh) {
+    const theta = Math.atan2(uy, ux) * 180 / Math.PI;
+    const p0x = cx + ux * hw, p0y = cy + uy * hw;
+    const p1x = cx - ux * hw, p1y = cy - uy * hw;
+    return 'M' + p0x.toFixed(2) + ' ' + p0y.toFixed(2) +
+           'A' + hw.toFixed(2) + ' ' + hh.toFixed(2) + ' ' + theta.toFixed(1) +
+           ' 0 1 ' + p1x.toFixed(2) + ' ' + p1y.toFixed(2) +
+           'A' + hw.toFixed(2) + ' ' + hh.toFixed(2) + ' ' + theta.toFixed(1) +
+           ' 0 1 ' + p0x.toFixed(2) + ' ' + p0y.toFixed(2) + 'Z';
+  }
+
+  /* ---------------- 形体 ---------------- */
+
+  const SHAPES = {
+    circle: () => 1,
+    blob:   th => 1 + 0.05*Math.cos(3*th + 0.6) + 0.02*Math.cos(5*th - 1.1),
+    tall:   th => { const a=0.90, b=1.12, c=Math.cos(th), s=Math.sin(th); return a*b/Math.hypot(b*c, a*s); },
+    wide:   th => { const a=1.14, b=0.88, c=Math.cos(th), s=Math.sin(th); return a*b/Math.hypot(b*c, a*s); },
+  };
+
+  const TABLE = {};
+  for (const k in SHAPES) {
+    TABLE[k] = Array.from({ length: SAMPLES }, (_, i) => SHAPES[k](i / SAMPLES * Math.PI * 2));
+  }
+
+  function radiusPath(radii, scale) {
+    let d = '';
+    for (let i = 0; i < SAMPLES; i++) {
+      const th = i / SAMPLES * Math.PI * 2;
+      const r = radii[i] * R * scale;
+      d += (i ? 'L' : 'M') + (Math.cos(th) * r).toFixed(1) + ' ' + (Math.sin(th) * r).toFixed(1);
+    }
+    return d + 'Z';
+  }
+
+  /* ---------------- 表情 ---------------- */
+
+  const EXPR = {
+    neutral:   { w: 11.5, h: 24,  tilt: -13 },
+    sad:       { w: 11.5, h: 21,  tilt: -28 },
+    focused:   { w: 19,   h: 8.5, tilt: 0   },
+    happy:     { w: 16,   h: 7,   tilt: -18 },
+    surprised: { w: 13,   h: 29,  tilt: -8  },
+    sleepy:    { w: 20,   h: 3.2, tilt: -2  },
+    confused:  { w: 10.5, h: 19,  tilt: 30  },
+    droop:     { w: 11,   h: 16,  tilt: -44 },
+  };
+
+  /* ---------------- 状态（来自 states.json） ---------------- */
+
+  const STATES = {
+    idle:      { expr:'neutral',   shape:'circle', gaze:[0, 0.05],    breath:0.008, blink:[2.6, 6.0] },
+    listening: { expr:'neutral',   shape:'circle', gaze:[0, 0.60],    breath:0.010, blink:[2.4, 5.0] },
+    thinking:  { expr:'sad',       shape:'blob',   gaze:[0, 0.60],    breath:0.014, blink:[2.0, 4.0], ring:1 },
+    searching: { expr:'focused',   shape:'circle', gaze:[0, 0.10],    breath:0.012, blink:[3.0, 6.0], scan:1 },
+    streaming: { expr:'neutral',   shape:'circle', gaze:[0, 0.15],    breath:0.012, blink:[3.0, 6.0] },
+    working:   { expr:'focused',   shape:'circle', gaze:[0, 0.15],    breath:0.020, blink:[3.0, 7.0] },
+    waiting:   { expr:'neutral',   shape:'blob',   gaze:[0.55, 0.05], breath:0.006, blink:[3.0, 7.0], ring:0.5 },
+    blocked:   { expr:'confused',  shape:'tall',   gaze:[-0.40, 0.10], breath:0.005, blink:[4.0, 8.0] },
+    finished:  { expr:'happy',     shape:'wide',   gaze:[0, 0.20],    breath:0.006, blink:[3.0, 6.0] },
+    failed:    { expr:'droop',     shape:'circle', gaze:[0, 0.42],    breath:0.004, blink:[5.0, 9.0] },
+    sleeping:  { expr:'sleepy',    shape:'circle', gaze:[0, -0.20],   breath:0.004, blink:[9, 16], asleep:1 },
+    waking:    { expr:'surprised', shape:'circle', gaze:[0, 0.35],    breath:0.016, blink:[1.4, 2.6] },
+  };
+
+  const ease = (cur, tgt, tau, dt) => cur + (tgt - cur) * (1 - Math.exp(-dt / tau));
+
+  /* ---------------- 工厂 ---------------- */
+
+  let uid = 0;
+
+  function createFace(container, options) {
+    if (!container) throw new Error('peepface: container required');
+    const opts = options || {};
+    const size = opts.size || 84;
+    const dark = !!opts.dark;
+    const follow = opts.follow !== false;
+    const id = 'pf' + (++uid);
+
+    const host = document.createElement('div');
+    host.className = 'peepface';
+    const shadow = host.attachShadow({ mode: 'open' });
+
+    shadow.innerHTML = `
+      <style>
+        :host { all: initial; }
+        .wrap {
+          position: relative; width: ${size}px; height: ${size}px;
+          display: block; user-select: none;
+        }
+        svg { width: 100%; height: 100%; display: block; overflow: visible; }
+        .face { fill: ${dark ? '#e8e8e8' : '#0a0a0c'}; }
+        .ring { fill: none; stroke: ${dark ? '#e8e8e8' : '#0a0a0c'}; stroke-width: 1.4; opacity: 0; }
+      </style>
+      <div class="wrap">
+        <svg viewBox="-70 -70 140 140">
+          <defs>
+            <mask id="${id}-holes" maskUnits="userSpaceOnUse" x="-70" y="-70" width="140" height="140">
+              <path id="${id}-body-mask" fill="#fff" d=""/>
+              <path id="${id}-eye-l" fill="#000" d=""/>
+              <path id="${id}-eye-r" fill="#000" d=""/>
+            </mask>
+          </defs>
+          <path id="${id}-ring" class="ring" d=""/>
+          <path id="${id}-body" class="face" mask="url(#${id}-holes)" d=""/>
+        </svg>
+      </div>`;
+
+    const el = {
+      body:     shadow.getElementById(id + '-body'),
+      bodyMask: shadow.getElementById(id + '-body-mask'),
+      eyeL:     shadow.getElementById(id + '-eye-l'),
+      eyeR:     shadow.getElementById(id + '-eye-r'),
+      ring:     shadow.getElementById(id + '-ring'),
+      wrap:     shadow.querySelector('.wrap'),
+    };
+
+    const S = {
+      state: opts.state && STATES[opts.state] ? opts.state : 'idle',
+      yaw: 0, pitch: 0,
+      expr: 'neutral', shape: 'circle',
+      radii: TABLE.circle.slice(),
+      blink: 0, blinkT: -1, blinkDur: 0.26, nextBlink: 2 + Math.random() * 3,
+      breath: 0.008, ring: 0, tRing: 0,
+      pointer: null, time: Math.random() * 5, morph: null, asleep: 0,
+    };
+
+    function applyState(name) {
+      const st = STATES[name] || STATES.idle;
+      S.state = name;
+      S.expr = st.expr;
+      S.shape = st.shape;
+      S.tRing = st.ring || 0;
+      S.breath = st.breath;
+      S.asleep = st.asleep ? 1 : 0;
+      if (st.blink) S.nextBlink = st.blink[0] + Math.random() * (st.blink[1] - st.blink[0]);
+    }
+
+    function blink(dur) {
+      if (S.blinkT >= 0 && S.blinkT < 0.5) return;
+      S.blinkT = 0; S.blinkDur = dur || 0.26;
+    }
+
+    function onPointer(e) {
+      if (!follow) return;
+      const r = el.wrap.getBoundingClientRect();
+      if (!r.width) return;
+      const cx = r.left + r.width / 2, cy = r.top + r.height / 2;
+      const half = Math.max(r.width, 1);
+      let gx = (e.clientX - cx) / half, gy = -(e.clientY - cy) / half;
+      const len = Math.hypot(gx, gy);
+      if (len > 1) { gx /= len; gy /= len; }
+      S.pointer = [gx, gy];
+    }
+    const onLeave = () => { S.pointer = null; };
+
+    if (follow) {
+      window.addEventListener('pointermove', onPointer, { passive: true });
+      document.addEventListener('mouseleave', onLeave);
+      window.addEventListener('blur', onLeave);
+    }
+
+    let last = performance.now();
+    let alive = true;
+
+    function tick(now) {
+      const dt = Math.min(0.05, (now - last) / 1000);
+      last = now; S.time += dt;
+
+      const cur = STATES[S.state];
+      const bias = cur.gaze || [0, 0];
+
+      let ty, tp;
+      if (S.pointer) {
+        ty = S.pointer[0] * 40 + bias[0] * 18;
+        tp = -S.pointer[1] * 28 - bias[1] * 16;
+      } else {
+        ty = Math.sin(S.time * 0.42) * 8 + Math.sin(S.time * 0.17 + 1.3) * 4 + bias[0] * 18;
+        tp = Math.cos(S.time * 0.31) * 5 - bias[1] * 16;
+      }
+      if (cur.scan) ty += Math.sin(S.time * 3.6) * 30;
+
+      S.yaw = ease(S.yaw, ty, 0.08, dt);
+      S.pitch = ease(S.pitch, tp, 0.08, dt);
+
+      if (S.asleep) {
+        S.blink = 0;                     // 闭眼交给 sleepy 眼形本身表达
+        S.blinkT = -1;
+        S.nextBlink = 1e9;               // 睡着不眨
+      } else if (S.blinkT >= 0) {
+        S.blinkT += dt / S.blinkDur;
+        if (S.blinkT >= 1) { S.blinkT = -1; S.blink = 0; }
+        else {
+          const t = S.blinkT, U1 = 0.42, U2 = 0.56;
+          const ss = x => x * x * (3 - 2 * x);
+          S.blink = t < U1 ? ss(t / U1) : t <= U2 ? 1 : 1 - ss((t - U2) / (1 - U2));
+        }
+      } else {
+        S.nextBlink -= dt;
+        if (S.nextBlink <= 0) {
+          blink(0.26);
+          const b = cur.blink || [2.6, 6];
+          S.nextBlink = b[0] + Math.random() * (b[1] - b[0]);
+        }
+      }
+
+      const target = TABLE[S.shape] || TABLE.circle;
+      for (let i = 0; i < SAMPLES; i++) S.radii[i] = ease(S.radii[i], target[i], 0.12, dt);
+
+      const scale = 1 + Math.sin(S.time * 1.4) * S.breath;
+      const d = radiusPath(S.radii, scale);
+      el.body.setAttribute('d', d);
+      el.bodyMask.setAttribute('d', d);
+
+      const ex = EXPR[S.expr] || EXPR.neutral;
+      const eyes = [{ id: 'eyeL', lon: -27 }, { id: 'eyeR', lon: 27 }];
+      for (let k = 0; k < eyes.length; k++) {
+        const e = eyes[k];
+        const n = rotate(sphere(e.lon, 10), S.yaw, S.pitch);
+        const px = n[0] * R, py = -n[1] * R;
+        const tf = tangentFrame(n);
+        const uS = [tf.u[0], -tf.u[1]], vS = [tf.v[0], -tf.v[1]];
+        const uz = Math.hypot(uS[0], uS[1]) || 1e-4;
+        const vz = Math.hypot(vS[0], vS[1]) || 1e-4;
+        const ux = uS[0] / uz, uy = uS[1] / uz;
+        const roll = -S.yaw * 0.28 + ex.tilt;
+        const cR = Math.cos(roll * DEG), sR = Math.sin(roll * DEG);
+        const wx = ux * cR - uy * sR, wy = ux * sR + uy * cR;
+        const hw = (ex.w / 2) * Math.max(0.22, uz);
+        const hh = Math.max(0.3, (ex.h / 2) * vz * (1 - S.blink * 0.995));
+        el[e.id].setAttribute('d', eyePath(px, py, wx, wy, hw, hh));
+        const vis = Math.max(0, Math.min(1, (n[2] - 0.02) / 0.22));
+        el[e.id].setAttribute('opacity', vis.toFixed(2));
+      }
+
+      S.ring = ease(S.ring, S.tRing, 0.25, dt);
+      if (S.ring > 0.02) {
+        const rx = 74, ry = 26, rot = -18 * DEG, a0 = S.time * 0.9;
+        let p = '';
+        for (let i = 0; i <= 60; i++) {
+          const a = i / 60 * Math.PI * 2 + a0;
+          const x0 = Math.cos(a) * rx, y0 = Math.sin(a) * ry;
+          p += (i ? 'L' : 'M') + (x0 * Math.cos(rot) - y0 * Math.sin(rot)).toFixed(1) + ' '
+               + (x0 * Math.sin(rot) + y0 * Math.cos(rot)).toFixed(1);
+        }
+        el.ring.setAttribute('d', p + 'Z');
+        el.ring.style.opacity = (S.ring * 0.45).toFixed(2);
+      } else {
+        el.ring.style.opacity = 0;
+      }
+    }
+
+    function frame(now) {
+      if (!alive) return;
+      try { tick(now); } catch (e) { /* 一帧出错不杀循环 */ }
+      requestAnimationFrame(frame);
+    }
+
+    container.appendChild(host);
+    applyState(S.state);
+    requestAnimationFrame(frame);
+
+    return {
+      setState(name) {
+        applyState(name);
+        // 换状态的瞬间眨一次眼盖住形变
+        blink(0.26);
+      },
+      getState() { return S.state; },
+      blink() { blink(0.26); },
+      destroy() {
+        alive = false;
+        if (follow) {
+          window.removeEventListener('pointermove', onPointer);
+          document.removeEventListener('mouseleave', onLeave);
+          window.removeEventListener('blur', onLeave);
+        }
+        host.remove();
+      },
+      el: host,
+    };
+  }
+
+  root.peepface = {
+    createFace,
+    STATES: Object.keys(STATES),
+    VERSION: '0.1.0',
+  };
+})(typeof window !== 'undefined' ? window : globalThis);

package/dist/peepface.mjs

@@ -0,0 +1,10 @@
+/* peepface v0.1.0 — 由 build.mjs 从 core.js 生成，不要手改 */
+import './peepface.js';
+
+const api = globalThis.peepface;
+if (!api) throw new Error('peepface: UMD 入口没有正确挂载');
+
+export const createFace = api.createFace;
+export const STATES = api.STATES;
+export const VERSION = api.VERSION;
+export default api;

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "peepface",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "agent 状态的视觉词汇表：12 个生命周期状态、12 KB、零依赖纯 SVG",
+  "type": "module",
+  "main": "./dist/peepface.mjs",
+  "module": "./dist/peepface.mjs",
+  "browser": "./dist/peepface.js",
+  "types": "./peepface.d.ts",
+  "exports": {
+    ".": {
+      "types": "./peepface.d.ts",
+      "import": "./dist/peepface.mjs",
+      "default": "./dist/peepface.js"
+    },
+    "./states.json": "./states.json",
+    "./plugin-dsh": "./plugin-dsh/lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "core.js",
+    "states.json",
+    "README.md",
+    "LICENSE",
+    "peepface.d.ts"
+  ],
+  "sideEffects": [
+    "./dist/peepface.js"
+  ],
+  "keywords": [
+    "agent",
+    "avatar",
+    "status",
+    "svg",
+    "ui",
+    "ai",
+    "llm",
+    "status-indicator",
+    "peepface"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SilasSolivagus/peepface.git"
+  },
+  "homepage": "https://silassolivagus.github.io/peepface/",
+  "bugs": {
+    "url": "https://github.com/SilasSolivagus/peepface/issues"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "prepublishOnly": "node build.mjs"
+  }
 }

package/peepface.d.ts

@@ -0,0 +1,43 @@
+export type FaceState =
+  | 'idle'
+  | 'listening'
+  | 'thinking'
+  | 'searching'
+  | 'streaming'
+  | 'working'
+  | 'waiting'
+  | 'blocked'
+  | 'finished'
+  | 'failed'
+  | 'sleeping'
+  | 'waking';
+
+export interface FaceOptions {
+  /** 初始状态，默认 'idle' */
+  state?: FaceState;
+  /** 显示尺寸（px），默认 84 */
+  size?: number;
+  /** 深色主题：白脸黑眼。默认 false */
+  dark?: boolean;
+  /** 眼睛跟随鼠标，默认 true */
+  follow?: boolean;
+}
+
+export interface Face {
+  setState(state: FaceState): void;
+  getState(): FaceState;
+  blink(): void;
+  destroy(): void;
+  readonly el: HTMLElement;
+}
+
+export function createFace(container: Element, options?: FaceOptions): Face;
+export const STATES: FaceState[];
+export const VERSION: string;
+
+declare const peepface: {
+  createFace: typeof createFace;
+  STATES: typeof STATES;
+  VERSION: typeof VERSION;
+};
+export default peepface;