v0.6.0

Upgrading from 0.5.x

Several actions are renamed after what the avatar does on screen, instead of the situation they were first written for. The old names keep working in 0.6 and print a one-time notice in the browser console; they stop working in 1.0. To upgrade, replace the old names in play() calls and in action-state or face-state listeners:

Old name	New name	What it looks like
send	affirm	A nod
warning	wary	Head turned, one eye close, a guarded up-and-down look
error, system-error, connection-error	refuse	A head shake
blocked, policy-blocked	angry	Lowered, glaring eyes
wait	waiting-spin (or waiting)	The default waiting spin
failed, fail	failure
verify, review	inspect
slot	random

action-state now reports affirm, wary, angry and refuse, and face-state reports wary and refuse. A shake reads as "no", so use refuse when the Agent cannot or will not do something, and failure when a task or connection fails. Antenna blinking is removed: setAntennaFlash() now does nothing and prints a one-time notice, and it is deleted in 1.0. Packages that depend on ^0.5.x do not pick up 0.6 automatically.

Added

• Added the waiting-wave action: both eyes bob in staggered waves. startWaiting({ variant: 'wave' }) loops it continuously.
• Added waiting-spin as the explicit name of the default waiting motion, and startWaiting({ variant: 'spin' }).
• Added brand-inspired color palettes to the demo. Colors apply to a stage card around the avatar; hovering a swatch previews it, a dice button picks a random palette, a swap button exchanges the background and head colors, and a reset button appears on the stage while the colors differ from the default. The page opens by rolling the stage through the palettes in step with the eyes' reel spin, ending with a faint rainbow ripple.

Changed

• Renamed actions as listed above.
• Demo labels now describe the expression: Waiting · Spin, Waiting · Scroll, Affirm, Wary, Angry and Refuse. The toolbar row is one card as wide as the actions, with Head shape and a random-colors button.
• Refined the wary expression with independently tilted eyes, adjusted eye proportions and eyelids.

Also in this release

• The embedded eyes engine for robot and dev-board screens is still in development. It will get its own version number and release; progress is tracked in embedded/CHANGELOG.md.

Removed

• Removed antenna blinking (setAntennaFlash()), which added little and is no longer shown in the demo.

Fixed

• The demo no longer shows intermediate layouts while loading, keeps its action rows even and stable on phones and under browser page translators, and keeps an open panel on screen.

v0.5.2

Added

• Added the love action: the eyes lean together into a heart, beat three times, then return.
• Added the random action (alias slot): the eyes roll like slot-machine reels, then settle with a bounce.

Fixed

• love now shows the full heart under reduced motion, and love and random follow motion preference changes while they play.

v0.4.3

Fixed

• Restored head dragging, waiting, sleep and wake, and touch cancellation alongside press-and-hold squeezing.
• Refined the wrap waiting animation with shared rotational projection, optical height compensation, and edge contact so the eyes turn around the head without overlapping, clipping, or using transparency.

v0.4.2

新增

• 新增第二种等待方式 startWaiting({ variant: 'wrap' })，以及单次播放的 play('waiting-wrap')。
• 新增按住头像中心挤压、到底轻颤、松开后的弹簧与果冻回弹。
• 新增天线拖动、局部头部形变、弹簧复原及复原后的愤怒反应。
• 新增 setPressSqueeze() 与 setAntennaDrag() 开关、交互状态事件和低动态支持。
• 在线 Demo 增加多语言“试一下”交互标签。

变更

• Demo 中第二种等待命名为“等待 · 环绕”，并放在原等待按钮之后。

修复

• 拖动天线开始时，双眼不再返回中心。
• 拖动期间，双眼持续看向实时光标位置。

这是合并后的 v0.4 系列公开版本，包含原 v0.4.0、v0.4.1 与 v0.4.2 的全部内容。

v0.3.2

Fixed

• Unified synchronous size parsing so numeric and px values no longer pass through a transient default size.
• Added the existing public sleep(), wake(), and input() helpers to the TypeScript declarations.
• Prevented delayed replacement work in the accessibility request example from starting after cancellation or a newer request.
• Made the example's business status the only automatic live region while keeping the visible debug log readable on demand.
• Stabilized request-replacement regression coverage and strengthened package integrity checks.

v0.3.1

Fixed

• Prevented disconnect cleanup from recreating per-instance media-query listeners and observers.
• Kept auto-sleep working correctly with motion="reduce" while waiting/input retain priority.
• Ensured reduced-motion state changes commit their final static SVG, including fully closed sleep.
• Corrected stopWaiting() lifecycle termination and avoided false terminal events on idle calls.
• Preserved explicit noteActivity() API semantics while keeping automatic wake behavior governed by wake-on.
• Rejected prototype-like action aliases such as constructor and __proto__ before state changes.

Agent Robot Avatar v0.3.0

Highlights

• Added wake-on="activity|interaction|manual" for configurable wake behavior.
• Added motion="auto|reduce|full" with system reduced-motion support.
• Added semantic action-state lifecycle events for host integrations and accessibility.
• Improved cancellation, drag/touch handling, size validation, and inspect configuration.
• Added visibility-aware rendering pauses and per-frame pointer coalescing.
• Expanded automated validation across Chromium, Firefox, and WebKit.

See CHANGELOG.md for the complete release notes.

Agent Robot Avatar v0.2.1

Fixed

• Fixed dynamic custom-element creation through document.createElement() and direct construction.
• Prevented interrupted animations from overriding resets or newer actions.
• Fixed automatic sleep repeatedly restarting instead of reaching sleep.
• Kept head, eye-mask, and antenna colors synchronized during dynamic updates.
• Cancelled pending timers, animations, waiting, and drag feedback when an avatar is removed; reattached avatars preserve their settings.

Validation

• 25 Chromium browser tests
• TypeScript declaration checks
• Release and packed-package consumer tests
• GitHub Pages build

Install or update with npm install agent-robot-avatar@0.2.1.

Agent Robot Avatar v0.2.0

Highlights

• Published the zero-dependency Web Component package to npm with built-in TypeScript declarations.
• Fixed continuous waiting transitions and centralized built-in action routing.
• Shared global input listeners across instances and paused settled sleep rendering.
• Updated the interactive Demo, README artwork, animated preview, and nine-language documentation.
• Added package, SSR import, browser, type, and release verification tests.

Install

npm install agent-robot-avatar

The existing v0.1.0 release remains available and unchanged.

v0.1.0

First public release of Agent Robot Avatar.