npm - agent-robot-avatar - Versions diffs - 0.3.0 → 0.3.2 - Mend

agent-robot-avatar 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/CHANGELOG.md +25 -0
package/README.md +9 -9
package/agent-robot-avatar.js +0 -1
package/docs/README.de.md +3 -3
package/docs/README.es.md +3 -3
package/docs/README.fr.md +3 -3
package/docs/README.ja.md +3 -3
package/docs/README.ko.md +3 -3
package/docs/README.pt.md +3 -3
package/docs/README.zh-CN.md +9 -9
package/docs/README.zh-TW.md +3 -3
package/index.d.ts +3 -0
package/package.json +1 -1
package/src/agent-robot-avatar-core.js +57 -24
package/src/agent-robot-avatar-runtime.js +192 -76
package/src/agent-robot-avatar-version.js +1 -1
package/src/agent-robot-avatar-runtime-fixes.js +0 -178

package/CHANGELOG.md CHANGED Viewed

@@ -6,6 +6,29 @@ The project follows Semantic Versioning for public releases. Internal developmen
 ## [Unreleased]
+## [0.3.2] - 2026-09-10
+### Fixed
+- Unified synchronous `size` attribute parsing so numeric and `px` values use the same validation immediately, without a transient fallback before runtime observers run.
+- Added the existing public `sleep()`, `wake()`, and `input()` convenience methods to the TypeScript declaration surface and type checks.
+- Stabilized request-replacement race tests by ordering competing clicks in the same browser task instead of depending on an 80 ms wall-clock window.
+- Expanded package integrity coverage to require the runtime and geometry modules explicitly.
+- Prevented the accessible request lifecycle example's delayed replacement step from starting after cancellation, a newer user request, or a newer replacement flow has invalidated it.
+- Made the example's business status the only automatic live region; the visible request debug log remains available for deliberate reading without `role="log"` live semantics or whole-log text rewrites.
+## [0.3.1] - 2026-09-10
+### Fixed
+- Prevented disconnect cleanup from recreating per-instance media-query listeners and observers; reattaching now initializes connected runtime resources once without emitting cleanup-only lifecycle events.
+- Decoupled automatic sleep timing from frame rendering so `motion="reduce"` can pause continuous drawing without disabling `auto-sleep`, while active waiting/input continue to take priority.
+- Ensured reduced-motion state changes commit their final static SVG before rendering pauses, including the fully closed sleep pose.
+- Made `stopWaiting()` terminate the action it actually resets: waiting ends normally, other active program actions are cancelled once, and idle calls emit no false terminal event.
+- Separated explicit `noteActivity()` calls from ambient DOM activity so host calls inside real event handlers keep API semantics while automatic wakeups continue to obey `wake-on`.
+- Restricted action alias lookup to declared keys so prototype-like names such as `constructor` and `__proto__` fail before changing waiting/action state.
 ## [0.3.0] - 2026-09-10
 ### Added
@@ -93,6 +116,8 @@ First public release.
 - npm-compatible package metadata for later package publication
 - Contribution guide, issue templates, pull request template, MIT License, and Ko-fi funding metadata
+[0.3.2]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.2
+[0.3.1]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.1
 [0.3.0]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.3.0
 [0.2.1]: https://github.com/CX-ArtLab/agent-robot-avatar/releases/tag/v0.2.1
 [0.2.0]: https://github.com/CX-ARTLab/agent-robot-avatar/releases/tag/v0.2.0

package/README.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](./LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](./LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar can also be used as a visual feedback layer for AG-UI-style a
 Agent Robot Avatar is built with SVG and vanilla JavaScript. It has no third-party animation framework dependency, works as a native custom element, and exposes a compact API for expressions, interaction states, pointer behavior, waiting feedback, and head-shape customization.
-**Current public version: v0.3.0**
+**Current public version: v0.3.2**
 <p align="center">
   <img src="./assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar interactive animation demo" width="560">
@@ -98,7 +98,7 @@ Return to the default idle state:
 avatar.reset();
 ```
-`reset()` cancels the current program action, pending waits, head animations, drag/rebound state, and delayed drag reactions, then returns to idle. Cancelled animation promises continue to resolve normally rather than rejecting. Removing the element performs the same internal cleanup without emitting cleanup-only `face-state` or `action-state` notifications. Reattaching starts from idle and preserves appearance and behavior attributes/settings.
+`reset()` cancels the current program action, pending waits, head animations, drag/rebound state, and delayed drag reactions, then returns to idle. Cancelled animation promises continue to resolve normally rather than rejecting. Removing the element performs the same internal cleanup without emitting cleanup-only `face-state` or `action-state` notifications, and also tears down its per-instance media-query listener and observers without restarting rendering as a cleanup side effect. Reattaching starts from idle, preserves appearance and behavior attributes/settings, and installs connected runtime resources once.
 A valid new action replaces the previous active action. The old semantic action receives `cancel`; it cannot resume later and overwrite the replacement. An unknown action throws before destructive cleanup. A no-op action such as `wake` while already awake leaves the current action unchanged.
@@ -147,7 +147,7 @@ avatar.startWaiting();
 avatar.stopWaiting();
 ```
-`startWaiting()` remains active until `stopWaiting()`, `reset()`, or another program action replaces it. A replacement reports `cancel`; `stopWaiting()` reports a normal `end`. Drag deformation remains available while waiting, but decorative drag expressions are suppressed and discarded rather than replayed after waiting ends.
+`startWaiting()` remains active until `stopWaiting()`, `reset()`, or another program action replaces it. A replacement reports `cancel`; `stopWaiting()` reports a normal `end` when waiting is active. For backward compatibility, calling `stopWaiting()` during another active program action still returns the avatar to idle; that action now receives exactly one `cancel`. Calling it with no active action does not manufacture a lifecycle event. Drag deformation remains available while waiting, but decorative drag expressions are suppressed and discarded rather than replayed after waiting ends.
 A typical request lifecycle can be written as:
@@ -182,7 +182,7 @@ avatar.addEventListener('action-state', (event) => {
 - `phase`: `start`, followed by exactly one `end` or `cancel` for each action that actually starts.
 - `source`: `api`, `interaction`, or `automatic`.
 - Continuous actions such as `startWaiting()` and active input do not emit `end` just because one animation cycle completes.
-- Replacement or `reset()` emits `cancel`; `stopWaiting()` emits `end` for waiting.
+- Replacement or `reset()` emits `cancel`; `stopWaiting()` emits `end` for active waiting, or `cancel` for a different active action that it resets to idle.
 - No-op calls emit no lifecycle event.
 - Decorative drag feedback uses `action: "reaction"` and `source: "interaction"`, so it cannot be confused with an API-level task success/failure.
 - The event bubbles and is `composed`, so it can be observed above the custom element/Shadow DOM boundary.
@@ -216,7 +216,7 @@ avatar.addEventListener('action-state', ({ detail }) => {
 Use a normal `role="status"` for routine updates. Do not announce blinking, gaze changes, or decorative drag reactions, and do not automatically make every error an interruptive alert. If the host already announces the same status elsewhere, the avatar can remain decorative to avoid duplicate screen-reader output.
-See [`examples/accessibility.html`](./examples/accessibility.html) for a runnable example.
+See [`examples/accessibility.html`](./examples/accessibility.html) for a runnable request-lifecycle example covering waiting, success, failure, connection errors, host cancellation, request replacement, and stale-result protection. Its live-region text follows host request state rather than low-level face changes.
 ## Wake policy
@@ -232,7 +232,7 @@ The `wake-on` attribute controls automatic wake behavior:
 | `interaction` | Only direct interaction with this avatar wakes it automatically. Activity elsewhere does not. |
 | `manual` | Environment activity, including direct avatar interaction, does not automatically wake it. |
-Explicit API intent remains explicit: `avatar.play('wake')` wakes the avatar in every mode, and `avatar.noteActivity()` keeps its existing behavior of recording activity and waking by default. Pass `false` to `noteActivity(false)` to record activity without waking. Other program actions may leave sleep when their action semantics require a new visible state. `reset()` always returns to idle.
+Explicit API intent remains explicit: `avatar.play('wake')` wakes the avatar in every mode, and `avatar.noteActivity()` records activity and wakes by default even when the host calls it from inside a real `keydown`, `pointerdown`, or `click` handler. Pass `false` to `noteActivity(false)` to record activity without waking. Automatic page/direct-interaction wakeups are handled separately and still obey `wake-on`; their `action-state` source is `automatic`, while an explicit host wake remains `api`. Other program actions may leave sleep when their action semantics require a new visible state. `reset()` always returns to idle.
 Different avatar instances may use different `wake-on` values.
@@ -250,7 +250,7 @@ Use the `motion` attribute to control animation intensity:
 | `reduce` | Keeps recognizable static states while suppressing continuous or elastic decorative motion. |
 | `full` | Uses the normal animation style regardless of the system reduced-motion preference. |
-Reduced mode suppresses continuous waiting orbits, idle wandering/blinking motion, head-follow inertia, elastic rebound, antenna spring motion, and status flashing where appropriate. Waiting/input lifecycles remain active until the host ends or replaces them, even when their visual state is static. Switching modes does not revive cancelled work or change `action-state` lifecycle semantics.
+Reduced mode suppresses continuous waiting orbits, idle wandering/blinking motion, head-follow inertia, elastic rebound, antenna spring motion, and status flashing where appropriate. Waiting/input lifecycles remain active until the host ends or replaces them, even when their visual state is static. Automatic sleep uses an independent cancellable timer rather than the draw loop, so it still works while reduced motion has paused continuous rendering; activity and runtime `auto-sleep` changes reschedule it, and active waiting/input are not overwritten. Static state changes are committed before reduced rendering pauses, including the final closed-eye sleep pose. Switching modes does not revive cancelled work or change `action-state` lifecycle semantics.
 ## Pointer following
@@ -425,7 +425,7 @@ Issues and pull requests are welcome. See [`CONTRIBUTING.md`](./CONTRIBUTING.md)
 ## Project status
-v0.3.0 is the current public release. v0.1.0 remains available as the first public version. The public API is intentionally small so it can evolve carefully before a future `1.0.0` stability commitment.
+v0.3.2 is the current public release. v0.1.0 remains available as the first public version. The public API is intentionally small so it can evolve carefully before a future `1.0.0` stability commitment.
 Agent Robot Avatar is independently developed and is not affiliated with, endorsed by, or representative of any AI platform or brand.

package/agent-robot-avatar.js CHANGED Viewed

@@ -7,7 +7,6 @@ import './src/agent-robot-avatar-inspect.js';
 import './src/agent-robot-avatar-failure.js';
 import './src/agent-robot-avatar-head-roundness.js';
 import './src/agent-robot-avatar-runtime.js';
-import './src/agent-robot-avatar-runtime-fixes.js';
 import { VERSION } from './src/agent-robot-avatar-version.js';
 // Elements already present in markup can upgrade while the core module is

package/docs/README.de.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar kann außerdem als visuelle Feedback-Ebene für Agent-Oberfl
 Agent Robot Avatar basiert auf SVG und Vanilla JavaScript und benötigt kein externes Animationsframework. Die Komponente funktioniert als natives Custom Element und stellt eine kompakte API für Ausdrücke, Interaktionszustände, Pointer-Following, Wartefeedback und Kopfform bereit.
-**Aktuelle öffentliche Version: v0.3.0**
+**Aktuelle öffentliche Version: v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Interaktive animierte Demo von Agent Robot Avatar" width="560">
@@ -153,7 +153,7 @@ Issues und Pull Requests sind willkommen. Bitte vor Änderungen [`CONTRIBUTING.m
 ## Projektstatus
-v0.3.0 ist die aktuelle öffentliche Version. v0.1.0 bleibt als erste öffentliche Version verfügbar. Die öffentliche API bleibt bewusst klein, damit sie vor einer späteren Stabilitätszusage mit `1.0.0` sorgfältig weiterentwickelt werden kann.
+v0.3.2 ist die aktuelle öffentliche Version. v0.1.0 bleibt als erste öffentliche Version verfügbar. Die öffentliche API bleibt bewusst klein, damit sie vor einer späteren Stabilitätszusage mit `1.0.0` sorgfältig weiterentwickelt werden kann.
 Agent Robot Avatar ist ein unabhängig entwickeltes Open-Source-Projekt und steht in keiner offiziellen Verbindung zu einer KI-Plattform oder Marke.

package/docs/README.es.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Versión](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Versión](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar también puede funcionar como una capa de feedback visual par
 Agent Robot Avatar está construido con SVG y JavaScript nativo, sin depender de frameworks de animación de terceros. Funciona como un Custom Element nativo y ofrece una API compacta para expresiones, estados de interacción, seguimiento del puntero, espera y forma de la cabeza.
-**Versión pública actual: v0.3.0**
+**Versión pública actual: v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demostración animada interactiva de Agent Robot Avatar" width="560">
@@ -212,7 +212,7 @@ Se aceptan Issues y Pull Requests. Consulta [`CONTRIBUTING.md`](../CONTRIBUTING.
 ## Estado del proyecto
-v0.3.0 es la versión pública actual. v0.1.0 continúa disponible como la primera versión pública. La API pública se mantiene deliberadamente pequeña para poder evolucionar con cuidado antes de un futuro compromiso de estabilidad `1.0.0`.
+v0.3.2 es la versión pública actual. v0.1.0 continúa disponible como la primera versión pública. La API pública se mantiene deliberadamente pequeña para poder evolucionar con cuidado antes de un futuro compromiso de estabilidad `1.0.0`.
 Agent Robot Avatar es un proyecto independiente de código abierto y no está afiliado, respaldado ni representa a ninguna plataforma o marca de IA.

package/docs/README.fr.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar peut également servir de couche de retour visuel pour les in
 Agent Robot Avatar est construit avec SVG et JavaScript natif, sans framework d’animation tiers. Il fonctionne comme un Custom Element natif et propose une API compacte pour les expressions, les états d’interaction, le suivi du pointeur, l’attente et la forme de la tête.
-**Version publique actuelle : v0.3.0**
+**Version publique actuelle : v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Démonstration animée interactive d’Agent Robot Avatar" width="560">
@@ -212,7 +212,7 @@ Issues et Pull Requests sont les bienvenus. Consultez [`CONTRIBUTING.md`](../CON
 ## État du projet
-v0.3.0 est la version publique actuelle. v0.1.0 reste disponible comme première version publique. L’API publique reste volontairement limitée afin d’évoluer avec prudence avant un futur engagement de stabilité `1.0.0`.
+v0.3.2 est la version publique actuelle. v0.1.0 reste disponible comme première version publique. L’API publique reste volontairement limitée afin d’évoluer avec prudence avant un futur engagement de stabilité `1.0.0`.
 Agent Robot Avatar est un projet open source développé indépendamment ; il n’est affilié, approuvé ni représentatif d’aucune plateforme ou marque d’IA.

package/docs/README.ja.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar は、AG-UI スタイルの Agent インターフェースに
 Agent Robot Avatar は SVG と Vanilla JavaScript だけで構築され、サードパーティー製アニメーションフレームワークに依存しません。ネイティブ Custom Element として動作し、表情、状態、ポインター追従、待機フィードバック、頭部形状をシンプルな API で制御できます。
-**現在の公開バージョン：v0.3.0**
+**現在の公開バージョン：v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar インタラクティブアニメーションデモ" width="560">
@@ -212,7 +212,7 @@ Issue と Pull Request を歓迎します。提出前に [`CONTRIBUTING.md`](../
 ## プロジェクトの状態
-v0.3.0 は現在の公開バージョンです。v0.1.0 は最初の公開バージョンとして引き続き利用できます。将来の `1.0.0` に向けて慎重に進化できるよう、公開 API は意図的に小さく保っています。
+v0.3.2 は現在の公開バージョンです。v0.1.0 は最初の公開バージョンとして引き続き利用できます。将来の `1.0.0` に向けて慎重に進化できるよう、公開 API は意図的に小さく保っています。
 Agent Robot Avatar は独立して開発されたオープンソースプロジェクトであり、特定の AI プラットフォームやブランドとは提携・公式承認関係にありません。

package/docs/README.ko.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![버전](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![버전](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar는 AG-UI 스타일 Agent 인터페이스의 시각적 피드
 Agent Robot Avatar는 SVG와 Vanilla JavaScript로만 구성되어 있으며 타사 애니메이션 프레임워크에 의존하지 않습니다. 네이티브 Custom Element로 동작하고 표정, 상호작용 상태, 포인터 추적, 대기 피드백, 머리 형태를 제어하는 간결한 API를 제공합니다.
-**현재 공개 버전: v0.3.0**
+**현재 공개 버전: v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 인터랙티브 애니메이션 데모" width="560">
@@ -212,7 +212,7 @@ Issue와 Pull Request를 환영합니다. 제출 전 [`CONTRIBUTING.md`](../CONT
 ## 프로젝트 상태
-v0.3.0은 현재 공개 버전입니다. v0.1.0은 첫 공개 버전으로 계속 제공됩니다. 향후 `1.0.0` 안정성 약속 이전에 신중하게 발전시킬 수 있도록 공개 API를 의도적으로 작게 유지하고 있습니다.
+v0.3.2은 현재 공개 버전입니다. v0.1.0은 첫 공개 버전으로 계속 제공됩니다. 향후 `1.0.0` 안정성 약속 이전에 신중하게 발전시킬 수 있도록 공개 API를 의도적으로 작게 유지하고 있습니다.
 Agent Robot Avatar는 독립적으로 개발된 오픈 소스 프로젝트이며 특정 AI 플랫폼이나 브랜드와 제휴하거나 공식 승인을 받은 프로젝트가 아닙니다.

package/docs/README.pt.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Versão](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Versão](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar também pode funcionar como uma camada de feedback visual par
 Agent Robot Avatar é construído com SVG e JavaScript puro, sem dependência de frameworks de animação de terceiros. Funciona como um Custom Element nativo e oferece uma API compacta para expressões, estados de interação, seguimento do ponteiro, feedback de espera e formato da cabeça.
-**Versão pública atual: v0.3.0**
+**Versão pública atual: v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Demonstração animada interativa do Agent Robot Avatar" width="560">
@@ -212,7 +212,7 @@ Issues e Pull Requests são bem-vindos. Leia [`CONTRIBUTING.md`](../CONTRIBUTING
 ## Status do projeto
-v0.3.0 é a versão pública atual. v0.1.0 continua disponível como a primeira versão pública. A API pública é mantida deliberadamente pequena para evoluir com cuidado antes de um futuro compromisso de estabilidade `1.0.0`.
+v0.3.2 é a versão pública atual. v0.1.0 continua disponível como a primeira versão pública. A API pública é mantida deliberadamente pequena para evoluir com cuidado antes de um futuro compromisso de estabilidade `1.0.0`.
 Agent Robot Avatar é um projeto independente de código aberto e não é afiliado, endossado nem representa nenhuma plataforma ou marca de IA.

package/docs/README.zh-CN.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -16,7 +16,7 @@
 Agent Robot Avatar 基于 SVG 与原生 JavaScript 构建，不依赖第三方动画框架，作为原生自定义元素工作，并提供尽量精简的公开 API。
-**当前公开版本：v0.3.0**
+**当前公开版本：v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 交互动画演示" width="560">
@@ -83,7 +83,7 @@ avatar.play('error');
 avatar.reset();
 ```
-`reset()` 会统一取消当前程序动作、待完成计时、头部动画、拖拽/回弹和尚未触发的拖拽表情，然后回到 `idle`。被取消的动画 Promise 仍按原约定正常结束，不会因为取消而产生未处理拒绝。移除组件时会执行同类内部清理，但不会额外发送用于清理的 `face-state` 或 `action-state` 通知；重新挂载后从 `idle` 开始，并保留配置。
+`reset()` 会统一取消当前程序动作、待完成计时、头部动画、拖拽/回弹和尚未触发的拖拽表情，然后回到 `idle`。被取消的动画 Promise 仍按原约定正常结束，不会因为取消而产生未处理拒绝。移除组件时会执行同类内部清理，但不会额外发送用于清理的 `face-state` 或 `action-state` 通知；同时会释放该实例的媒体偏好监听和观察器，清理过程不会反向重启渲染。重新挂载后从 `idle` 开始、保留配置，并只初始化一次连接期运行资源。
 真正开始的新动作会替换旧动作；旧动作不能在之后恢复并覆盖新动作。未知动作会在破坏性清理前抛错。已经醒着时调用 `wake`、已经处于持续输入时再次调用 `input` 等无操作调用不会破坏当前动作，也不会产生虚假的语义生命周期事件。
@@ -130,7 +130,7 @@ avatar.startWaiting();
 avatar.stopWaiting();
 ```
-`startWaiting()` 会一直保持到 `stopWaiting()`、`reset()` 或新的程序动作将其替换。`stopWaiting()` 对语义生命周期来说是正常 `end`；被其他动作或 reset 替换时是 `cancel`。
+`startWaiting()` 会一直保持到 `stopWaiting()`、`reset()` 或新的程序动作将其替换。当前确实处于 waiting 时，`stopWaiting()` 对 waiting 的语义生命周期是正常 `end`。为保持既有行为，如果在其他活跃程序动作期间调用 `stopWaiting()`，头像仍会回到 `idle`，但该动作现在会且只会记录一次 `cancel`；没有活跃动作时不会制造虚假的终止事件。
 等待、输入或其他尚未结束的程序动作期间仍可以拖拽产生形变，但拖拽表情不会覆盖程序动作；被抑制的拖拽表情会直接丢弃，不会在动作结束后补播。
@@ -167,7 +167,7 @@ avatar.addEventListener('action-state', (event) => {
 - `phase`：`start`，之后且仅之后一个 `end` 或 `cancel`。
 - `source`：`api`、`interaction`、`automatic`。
 - 持续 waiting / input 不会因为单次视觉循环完成而产生 `end`。
-- `stopWaiting()` 正常结束 waiting；reset 或其他动作替换时记录 `cancel`。
+- `stopWaiting()` 在 waiting 活跃时正常记录 `end`；若它把其他活跃程序动作重置为 idle，则该动作记录 `cancel`。
 - 无操作调用不产生虚假事件。
 - 普通拖拽反馈使用 `action: "reaction"`、`source: "interaction"`，不会被误认为 API 发出的任务成功/失败。
 - 事件会冒泡，并设置为 `composed`，可跨越组件的 Shadow DOM 边界监听。
@@ -199,7 +199,7 @@ avatar.addEventListener('action-state', ({ detail }) => {
 不要播报眨眼、视线变化或普通拖拽反应；也不要默认把所有错误都做成打断式警报。如果宿主本身已经播报同一状态，可以把头像视为装饰，避免重复通知。
-完整示例见 [`examples/accessibility.html`](../examples/accessibility.html)。
+完整示例见 [`examples/accessibility.html`](../examples/accessibility.html)，其中覆盖等待、成功、失败、连接错误、宿主取消、新请求替换旧请求，以及旧请求迟到结果不能覆盖新状态；无障碍文字由宿主请求状态驱动，不重复播报底层表情变化。
 ## 睡眠唤醒策略
@@ -215,7 +215,7 @@ avatar.addEventListener('action-state', ({ detail }) => {
 | `interaction` | 只有直接与这个头像交互时自动唤醒；页面其他区域活动不唤醒。 |
 | `manual` | 页面活动和头像交互都不会自动唤醒，由宿主显式控制。 |
-显式调用仍保持显式语义：`avatar.play('wake')` 在所有模式下都可唤醒；现有 `avatar.noteActivity()` 仍默认记录活动并唤醒，`noteActivity(false)` 只记录活动、不唤醒。其他程序动作可以按照动作语义离开睡眠；`reset()` 始终回到 `idle`。不同实例可以使用不同策略。
+显式调用仍保持显式语义：`avatar.play('wake')` 在所有模式下都可唤醒；`avatar.noteActivity()` 默认记录活动并唤醒，即使宿主是在真实 `keydown`、`pointerdown` 或 `click` 事件处理函数中调用它也一样。`noteActivity(false)` 只记录活动、不唤醒。页面环境活动与头像直接交互的自动唤醒会走独立来源并继续遵守 `wake-on`；自动唤醒的 `action-state` source 为 `automatic`，宿主显式唤醒仍为 `api`。其他程序动作可以按照动作语义离开睡眠；`reset()` 始终回到 `idle`。不同实例可以使用不同策略。
 ## 减少动态效果
@@ -231,7 +231,7 @@ avatar.addEventListener('action-state', ({ detail }) => {
 | `reduce` | 保留可辨认的静态状态，减少持续、弹性和闪烁类动画。 |
 | `full` | 始终使用普通动画，不受系统减少动态效果偏好影响。 |
-reduce 模式会简化等待转圈、待机游走/眨眼、惯性跟随、弹性回弹、天线弹簧和闪烁等装饰动态，但 waiting / input 等语义生命周期仍持续存在，直到宿主结束或替换。切换 motion 不会恢复已经被取消的旧动作，也不会改变 `action-state` 的语义。
+reduce 模式会简化等待转圈、待机游走/眨眼、惯性跟随、弹性回弹、天线弹簧和闪烁等装饰动态，但 waiting / input 等语义生命周期仍持续存在，直到宿主结束或替换。自动睡眠使用独立、可取消的计时调度，不依赖持续绘制，因此 reduce 已暂停绘制时仍能按 `auto-sleep` 进入睡眠；用户活动和运行时修改超时会重新调度，waiting/input 不会被自动睡眠覆盖。影响画面的静态状态会先提交最终 SVG 再暂停，包括最终闭眼的 sleep 姿态。切换 motion 不会恢复已经被取消的旧动作，也不会改变 `action-state` 的语义。
 ## 鼠标 / 指针跟随
@@ -379,7 +379,7 @@ LICENSE                   MIT License
 ## 项目状态
-v0.3.0 是当前公开版本。当前刻意保持较小的公开 API，以便在未来 `1.0.0` 稳定性承诺之前继续谨慎演进。
+v0.3.2 是当前公开版本。当前刻意保持较小的公开 API，以便在未来 `1.0.0` 稳定性承诺之前继续谨慎演进。
 Agent Robot Avatar 为独立开发的开源项目，不隶属于、代表或获得任何 AI 平台或品牌的官方背书。

package/docs/README.zh-TW.md CHANGED Viewed

@@ -6,7 +6,7 @@
 [English](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/README.md) | [简体中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-CN.md) | [繁體中文](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.zh-TW.md) | [日本語](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ja.md) | [한국어](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.ko.md) | [Español](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.es.md) | [Português](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.pt.md) | [Deutsch](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.de.md) | [Français](https://github.com/CX-ArtLab/agent-robot-avatar/blob/main/docs/README.fr.md)
-![Version](https://img.shields.io/badge/version-v0.3.0-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
+![Version](https://img.shields.io/badge/version-v0.3.2-111111?style=flat-square) [![License](https://img.shields.io/badge/license-MIT-0A7EA4?style=flat-square)](../LICENSE) [![CI](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/CX-ArtLab/agent-robot-avatar/actions/workflows/validate.yml) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-FF5E5B?style=flat-square&logo=ko-fi&logoColor=white)](https://ko-fi.com/P0E625WIOI)
 ![Vanilla JavaScript](https://img.shields.io/badge/Vanilla-JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=000) ![Web Component](https://img.shields.io/badge/Web-Native%20Component-5A67D8?style=flat-square) ![SVG](https://img.shields.io/badge/Rendering-SVG-FFB13B?style=flat-square&logo=svg&logoColor=000) ![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-2EA44F?style=flat-square) ![14 Agent States](https://img.shields.io/badge/Agent%20states-14-8B5CF6?style=flat-square) ![Pointer Following](https://img.shields.io/badge/Pointer-following-00A67E?style=flat-square) ![Jelly Drag](https://img.shields.io/badge/Drag-jelly%20physics-FF69B4?style=flat-square)
@@ -20,7 +20,7 @@ Agent Robot Avatar 也可作為 AG-UI 類 Agent 介面的視覺回饋層。
 Agent Robot Avatar 以 SVG 與原生 JavaScript 建構，不依賴第三方動畫框架。它作為原生自訂元素運作，並提供精簡 API 來控制表情、互動狀態、指標跟隨、等待回饋與頭部造型。
-**目前公開版本：v0.3.0**
+**目前公開版本：v0.3.2**
 <p align="center">
   <img src="../assets/demo/agent-robot-avatar-demo.gif" alt="Agent Robot Avatar 互動動畫展示" width="560">
@@ -214,7 +214,7 @@ LICENSE                   MIT License
 ## 專案狀態
-v0.3.0 是目前的公開版本。v0.1.0 作為第一個公開版本繼續保留。公開 API 目前刻意保持精簡，讓專案能在未來 `1.0.0` 穩定性承諾前持續謹慎演進。
+v0.3.2 是目前的公開版本。v0.1.0 作為第一個公開版本繼續保留。公開 API 目前刻意保持精簡，讓專案能在未來 `1.0.0` 穩定性承諾前持續謹慎演進。
 Agent Robot Avatar 是獨立開發的開源專案，不隸屬、代表或獲得任何 AI 平台或品牌的官方背書。

package/index.d.ts CHANGED Viewed

@@ -76,6 +76,9 @@ export interface AgentRobotAvatarEventMap extends HTMLElementEventMap {
 export declare class AgentRobotAvatar extends HTMLElement {
   play(action: AgentRobotAvatarAction): this | Promise<void>;
   reset(): this;
+  sleep(): this | Promise<void>;
+  wake(): this | Promise<void>;
+  input(active?: boolean): this | Promise<void>;
   startWaiting(): Promise<this>;
   stopWaiting(): this;
   setPointerFollow(enabled?: boolean): this;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-robot-avatar",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "A lightweight expressive robot avatar Web Component for AI agents and interactive applications.",
   "type": "module",
   "main": "./agent-robot-avatar.js",

package/src/agent-robot-avatar-core.js CHANGED Viewed

@@ -59,6 +59,13 @@ const AgentRobotAvatar = (() => {
   const clamp = (v, a, b) => Math.max(a, Math.min(b, v));
   const lerp = (a, b, t) => a + (b - a) * t;
   const clonePose = p => ({...p});
+  const DEFAULT_SIZE = 112;
+  const parseSize = value => {
+    const text = String(value ?? '').trim();
+    if (!/^(?:\d+(?:\.\d+)?|\.\d+)(?:px)?$/i.test(text)) return DEFAULT_SIZE;
+    const numeric = Number.parseFloat(text);
+    return Number.isFinite(numeric) && numeric > 0 ? numeric : DEFAULT_SIZE;
+  };
   const connectedFaces = new Set();
   const forEachConnectedFace = callback => {
@@ -73,8 +80,14 @@ const AgentRobotAvatar = (() => {
       if (face._dragJelly.active) face._onDragMove(event);
     });
   };
-  const handleGlobalPointerDown = () => forEachConnectedFace(face => face.noteActivity());
-  const handleGlobalKeyDown = () => forEachConnectedFace(face => face.noteActivity());
+  const handleGlobalPointerDown = event => forEachConnectedFace(face => {
+    if (typeof face._noteEnvironmentActivity === 'function') face._noteEnvironmentActivity(event);
+    else face.noteActivity();
+  });
+  const handleGlobalKeyDown = event => forEachConnectedFace(face => {
+    if (typeof face._noteEnvironmentActivity === 'function') face._noteEnvironmentActivity(event);
+    else face.noteActivity();
+  });
   const handleGlobalPointerEnd = event => {
     forEachConnectedFace(face => {
       if (face._dragJelly.active) face._onDragEnd(event);
@@ -175,34 +188,55 @@ const AgentRobotAvatar = (() => {
     }
     disconnectedCallback() {
-      unregisterConnectedFace(this);
-      this.removeEventListener('pointerdown', this._boundDragStart);
-      this.removeEventListener('click', this._boundClickCapture, true);
-      // Removal cancels work; reattachment starts idle with appearance settings intact.
-      this._resetToIdle(false);
-      this._blinkAnim = null;
-      this._blink = 1;
-      this._pointer.active = false;
-      this._pointer.influence = 0;
-      const drag = this._dragJelly;
-      if (drag.pointerId != null) {
-        try { this.releasePointerCapture(drag.pointerId); } catch (_) {}
+      // This callback is captured when the custom element is defined, so the
+      // runtime teardown must be entered from the registered core lifecycle.
+      this._runtimeDisconnecting = true;
+      try {
+        unregisterConnectedFace(this);
+        this.removeEventListener('pointerdown', this._boundDragStart);
+        this.removeEventListener('click', this._boundClickCapture, true);
+        // Removal cancels work; reattachment starts idle with appearance settings intact.
+        this._resetToIdle(false);
+        this._blinkAnim = null;
+        this._blink = 1;
+        this._pointer.active = false;
+        this._pointer.influence = 0;
+        const drag = this._dragJelly;
+        if (drag.pointerId != null) {
+          try { this.releasePointerCapture(drag.pointerId); } catch (_) {}
+        }
+        drag.active = false;
+        drag.pointerId = null;
+        this._finishDragReturn(null);
+        this._suppressClick = false;
+        this._running = false;
+        cancelAnimationFrame(this._raf);
+        this._raf = 0;
+      } finally {
+        this._teardownRuntime?.();
+        this._runtimeDisconnecting = false;
       }
-      drag.active = false;
-      drag.pointerId = null;
-      this._finishDragReturn(null);
-      this._suppressClick = false;
-      this._running = false;
-      cancelAnimationFrame(this._raf);
-      this._raf = 0;
     }
     static get observedAttributes() { return ['color','size','auto-sleep']; }
     attributeChangedCallback(name, oldV, newV) {
       if (oldV === newV) return;
       if (name === 'color') this._applyColor(newV);
-      if (name === 'size') this.style.setProperty('--face-size', `${Number(newV)||112}px`);
-      if (name === 'auto-sleep') this._autoSleepMs = Number(newV) || 0;
+      if (name === 'size') this._syncSizeAttribute();
+      if (name === 'auto-sleep') {
+        this._autoSleepMs = Number(newV) || 0;
+        this._scheduleAutoSleep?.();
+      }
+    }
+    _syncSizeAttribute() {
+      if (!this.hasAttribute('size')) {
+        this.style.removeProperty('--face-size');
+        return DEFAULT_SIZE;
+      }
+      const size = parseSize(this.getAttribute('size'));
+      this.style.setProperty('--face-size', `${size}px`);
+      return size;
     }
     _applyColor(value) {
@@ -1096,7 +1130,6 @@ const AgentRobotAvatar = (() => {
         this._updateLook(ts, dt);
         this._updateHeadFollow(ts, dt);
         this._updateDragJelly(dt);
-        this._autoSleep(ts);
         this._draw(ts);
       }
       if (this._canPauseFrames(ts)) {

package/src/agent-robot-avatar-runtime.js CHANGED Viewed

@@ -5,7 +5,6 @@ const basePlay = proto.play;
 const baseNoteActivity = proto.noteActivity;
 const baseSleep = proto.sleep;
 const baseWake = proto.wake;
-const baseAutoSleep = proto._autoSleep;
 const baseResetToIdle = proto._resetToIdle;
 const baseStartMorph = proto._startMorph;
 const baseAnimateHead = proto._animateHead;
@@ -22,6 +21,7 @@ const baseCanPauseFrames = proto._canPauseFrames;
 const baseInput = proto.input;
 const baseStartWaiting = proto.startWaiting;
 const baseStopWaiting = proto.stopWaiting;
+const baseDraw = proto._draw;
 const DEFAULT_SIZE = 112;
 const ACTION_ALIASES = Object.freeze({
@@ -50,30 +50,10 @@ const ACTION_ALIASES = Object.freeze({
   wake: 'wake',
 });
-let environmentEvent = null;
-let environmentClearQueued = false;
-function markEnvironmentEvent(event) {
-  environmentEvent = event;
-  if (environmentClearQueued) return;
-  environmentClearQueued = true;
-  queueMicrotask(() => {
-    environmentEvent = null;
-    environmentClearQueued = false;
-  });
-}
-// Core already owns the single shared window listeners. Capture on document so
-// policy context is available before the core's bubbling window handlers run,
-// without adding a second global window listener set per runtime feature.
-if (typeof document !== 'undefined') {
-  document.addEventListener('pointerdown', markEnvironmentEvent, true);
-  document.addEventListener('keydown', markEnvironmentEvent, true);
-}
 function normalizeAction(name) {
   const raw = String(name || '').trim().toLowerCase();
-  return { raw, canonical: ACTION_ALIASES[raw] || null };
+  const canonical = Object.hasOwn(ACTION_ALIASES, raw) ? ACTION_ALIASES[raw] : null;
+  return { raw, canonical };
 }
 function wakePolicy(instance) {
@@ -90,10 +70,12 @@ function reducedMotion(instance) {
   const requested = requestedMotion(instance);
   if (requested === 'reduce') return true;
   if (requested === 'full') return false;
-  if (instance._runtimeMotionQuery) return instance._runtimeMotionQuery.matches;
-  return typeof window !== 'undefined' && typeof window.matchMedia === 'function'
-    ? window.matchMedia('(prefers-reduced-motion: reduce)').matches
-    : false;
+  // A fresh query preserves the existing WebKit runtime-preference hardening
+  // without installing additional listeners.
+  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
+    return window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+  }
+  return instance._runtimeMotionQuery?.matches === true;
 }
 function emitActionState(instance, record, phase, silent = false) {
@@ -115,6 +97,7 @@ function cancelActiveAction(instance, { silent = false } = {}) {
 }
 function beginAction(instance, action, source, continuous = false) {
+  clearAutoSleep(instance);
   cancelActiveAction(instance);
   const record = {
     id: (instance._actionStateSequence || 0) + 1,
@@ -134,6 +117,7 @@ function finishAction(instance, record, phase = 'end') {
   if (instance._activeActionState !== record) return;
   instance._activeActionState = null;
   emitActionState(instance, record, phase);
+  scheduleAutoSleep(instance);
 }
 function trackFiniteAction(instance, record, result) {
@@ -148,24 +132,9 @@ function trackFiniteAction(instance, record, result) {
   }
 }
-function parseSize(value) {
-  const text = String(value ?? '').trim();
-  const match = text.match(/^(?:\d+(?:\.\d+)?|\.\d+)(?:px)?$/i);
-  if (!match) return DEFAULT_SIZE;
-  const numeric = Number.parseFloat(text);
-  if (!Number.isFinite(numeric) || numeric <= 0) return DEFAULT_SIZE;
-  return numeric;
-}
 function applySize(instance) {
-  if (!instance.hasAttribute('size')) {
-    if (instance._runtimeSizeApplied) instance.style.removeProperty('--face-size');
-    instance._runtimeSizeApplied = false;
-    return;
-  }
-  const size = parseSize(instance.getAttribute('size'));
-  instance.style.setProperty('--face-size', `${size}px`);
-  instance._runtimeSizeApplied = true;
+  instance._syncSizeAttribute();
+  instance._runtimeSizeApplied = instance.hasAttribute('size');
 }
 function hasVisibleLayout(instance) {
@@ -182,6 +151,98 @@ function cancelHeadAnimations(instance) {
   if (instance._headMotion) instance._headMotion.style.transform = '';
 }
+function cancelContinuousMotion(instance) {
+  cancelHeadAnimations(instance);
+  instance._blinkAnim = null;
+  instance._blink = 1;
+  instance._boredRoutine = null;
+  instance._boredLookSpeed = null;
+  if (instance._wanderTarget) instance._wanderTarget.x = instance._wanderTarget.y = 0;
+  if (instance._wander) instance._wander.x = instance._wander.y = 0;
+  if (instance._look) instance._look.x = instance._look.y = 0;
+}
+function dragAtRest(drag) {
+  if (!drag || drag.active || drag.returning || drag.pendingReaction) return false;
+  return Math.abs(drag.x) < 0.0001 && Math.abs(drag.y) < 0.0001 &&
+    Math.abs(drag.vx) < 0.0001 && Math.abs(drag.vy) < 0.0001 &&
+    Math.abs(drag.stretch) < 0.0001 && Math.abs(drag.shear) < 0.0001 &&
+    Math.abs(drag.pullX) < 0.0001 && Math.abs(drag.pullY) < 0.0001;
+}
+function clearIdleDragVisuals(instance) {
+  if (!dragAtRest(instance._dragJelly)) return;
+  if (instance._dragMotion) {
+    instance._dragMotion.style.transform = '';
+    instance._dragMotion.style.transformOrigin = '';
+  }
+  if (instance._headShape && instance._baseHeadPathD) {
+    instance._headShape.setAttribute('d', instance._baseHeadPathD);
+  }
+}
+function clearAutoSleep(instance) {
+  if (!instance._runtimeAutoSleepTimer) return;
+  clearTimeout(instance._runtimeAutoSleepTimer);
+  instance._runtimeAutoSleepTimer = 0;
+}
+function autoSleepBlocked(instance) {
+  const record = instance._activeActionState;
+  return Boolean(
+    !instance.isConnected ||
+    instance._runtimeDisconnecting ||
+    instance._sleeping ||
+    (record && !record.terminal && record.source !== 'interaction') ||
+    instance._waitingRequested ||
+    instance._waitingFx ||
+    instance._inputWanted ||
+    instance._state === 'input' ||
+    instance._expressionLock
+  );
+}
+function scheduleAutoSleep(instance) {
+  clearAutoSleep(instance);
+  const delayMs = Number(instance._autoSleepMs);
+  if (!Number.isFinite(delayMs) || delayMs <= 0 || autoSleepBlocked(instance)) return;
+  const remaining = Math.max(0, (instance._lastActivity + delayMs) - performance.now());
+  instance._runtimeAutoSleepTimer = setTimeout(() => {
+    instance._runtimeAutoSleepTimer = 0;
+    if (autoSleepBlocked(instance)) return;
+    const currentDelay = Number(instance._autoSleepMs);
+    if (!Number.isFinite(currentDelay) || currentDelay <= 0) return;
+    const nextRemaining = (instance._lastActivity + currentDelay) - performance.now();
+    if (nextRemaining > 1) {
+      scheduleAutoSleep(instance);
+      return;
+    }
+    const previousSource = instance._runtimeActionSource;
+    instance._runtimeActionSource = 'automatic';
+    try {
+      instance.sleep();
+    } finally {
+      instance._runtimeActionSource = previousSource;
+    }
+  }, remaining);
+}
+function requestVisualCommit(instance) {
+  if (!instance.isConnected || instance._runtimeDisconnecting) return;
+  instance._runtimeVisualDirty = true;
+  instance._resumeFrames?.();
+}
+function syncMotionPreference(instance) {
+  const reduced = reducedMotion(instance);
+  if (instance._runtimeLastReducedMotion === reduced) return reduced;
+  instance._runtimeLastReducedMotion = reduced;
+  instance._runtimeVisualDirty = true;
+  if (reduced) cancelContinuousMotion(instance);
+  return reduced;
+}
 function clearDragGeometry(instance, { preserveClick = false, releaseCapture = true } = {}) {
   const drag = instance._dragJelly;
   if (!drag) return;
@@ -298,26 +359,20 @@ function setRuntimeVisible(instance, visible) {
 }
 function handleMotionChange(instance) {
-  if (reducedMotion(instance)) {
-    cancelHeadAnimations(instance);
-    instance._blinkAnim = null;
-    instance._blink = 1;
-    instance._boredRoutine = null;
-    instance._boredLookSpeed = null;
-    instance._wanderTarget.x = 0;
-    instance._wanderTarget.y = 0;
-    instance._look.x = 0;
-    instance._look.y = 0;
+  const reduced = syncMotionPreference(instance);
+  if (reduced) {
+    cancelContinuousMotion(instance);
     instance._pose = { ...instance._toPose };
     instance._fromPose = { ...instance._toPose };
     instance._morphDuration = 0;
     if (instance._dragJelly?.returning) finishDragReturn(instance, instance._dragJelly.pendingReaction);
   }
-  instance._resumeFrames?.();
+  requestVisualCommit(instance);
+  scheduleAutoSleep(instance);
 }
 function ensureRuntime(instance) {
-  if (instance._runtimePolicyReady) return;
+  if (instance._runtimePolicyReady || !instance.isConnected || instance._runtimeDisconnecting) return;
   instance._runtimePolicyReady = true;
   if (!instance.style.touchAction) instance.style.touchAction = 'pinch-zoom';
   applySize(instance);
@@ -334,15 +389,18 @@ function ensureRuntime(instance) {
   if (typeof MutationObserver !== 'undefined') {
     instance._runtimeAttributeObserver = new MutationObserver(records => {
       let motionChanged = false;
+      let autoSleepChanged = false;
       for (const record of records) {
         if (record.attributeName === 'size') applySize(instance);
         if (record.attributeName === 'motion') motionChanged = true;
+        if (record.attributeName === 'auto-sleep') autoSleepChanged = true;
       }
       if (motionChanged) handleMotionChange(instance);
+      if (autoSleepChanged) scheduleAutoSleep(instance);
     });
     instance._runtimeAttributeObserver.observe(instance, {
       attributes: true,
-      attributeFilter: ['size', 'motion', 'wake-on'],
+      attributeFilter: ['size', 'motion', 'wake-on', 'auto-sleep'],
     });
   }
@@ -380,9 +438,12 @@ function ensureRuntime(instance) {
     };
     instance._runtimeLoopWrapped = true;
   }
+  scheduleAutoSleep(instance);
 }
 function teardownRuntime(instance) {
+  clearAutoSleep(instance);
+  cancelContinuousMotion(instance);
   instance._runtimeIntersectionObserver?.disconnect();
   instance._runtimeResizeObserver?.disconnect();
   instance._runtimeAttributeObserver?.disconnect();
@@ -404,6 +465,10 @@ function teardownRuntime(instance) {
   instance._runtimeLostCapture = null;
   instance._runtimePolicyReady = false;
   instance._runtimeVisible = false;
+  instance._runtimeLastReducedMotion = undefined;
+  instance._runtimeVisualDirty = false;
+  instance._pendingPointerEvent = null;
+  instance._pendingDragEvent = null;
 }
 function eventTargetsAvatar(event, instance) {
@@ -418,19 +483,28 @@ proto._isReducedMotion = function() {
 proto.noteActivity = function(wake = true) {
   ensureRuntime(this);
-  if (!wake || !this._sleeping) return baseNoteActivity.call(this, wake);
+  const shouldWake = wake !== false && (this._sleeping || this._state === 'sleep');
+  const result = baseNoteActivity.call(this, false);
+  scheduleAutoSleep(this);
+  if (shouldWake) this.wake();
+  return result;
+};
-  const event = environmentEvent;
-  if (!event) return baseNoteActivity.call(this, wake);
+proto._noteEnvironmentActivity = function(event) {
+  ensureRuntime(this);
+  const shouldConsiderWake = this._sleeping || this._state === 'sleep';
+  const result = baseNoteActivity.call(this, false);
+  scheduleAutoSleep(this);
+  if (!shouldConsiderWake) return result;
   const policy = wakePolicy(this);
   const shouldWake = policy === 'activity' || (policy === 'interaction' && eventTargetsAvatar(event, this));
-  if (!shouldWake) return baseNoteActivity.call(this, false);
+  if (!shouldWake) return result;
   const previousSource = this._runtimeActionSource;
   this._runtimeActionSource = 'automatic';
   try {
-    return baseNoteActivity.call(this, true);
+    return this.wake();
   } finally {
     this._runtimeActionSource = previousSource;
   }
@@ -443,11 +517,15 @@ proto._resetToIdle = function(notify = true) {
     return baseResetToIdle.call(this, notify);
   } finally {
     this._runtimeResetNotify = previous;
+    scheduleAutoSleep(this);
   }
 };
 proto._startMorph = function(target, duration, ease) {
-  return baseStartMorph.call(this, target, reducedMotion(this) ? 0 : duration, ease);
+  const reduced = reducedMotion(this);
+  const result = baseStartMorph.call(this, target, reduced ? 0 : duration, ease);
+  if (reduced) requestVisualCommit(this);
+  return result;
 };
 proto._animateHead = function(frames, duration) {
@@ -481,8 +559,12 @@ proto._updateHeadFollow = function(now, dt) {
 };
 proto._updateDragJelly = function(dt) {
-  if (!reducedMotion(this)) return baseUpdateDragJelly.call(this, dt);
   const drag = this._dragJelly;
+  if (!reducedMotion(this)) {
+    const result = baseUpdateDragJelly.call(this, dt);
+    clearIdleDragVisuals(this);
+    return result;
+  }
   if (!drag) return;
   if (drag.active) {
     drag.x = drag.targetX;
@@ -495,6 +577,7 @@ proto._updateDragJelly = function(dt) {
   } else if (drag.returning) {
     finishDragReturn(this, drag.pendingReaction);
   }
+  clearIdleDragVisuals(this);
 };
 proto._onPointerMove = function(event) {
@@ -542,15 +625,25 @@ proto._finishDragReturn = function(reaction) {
 };
 proto._resumeFrames = function() {
+  if (!this.isConnected || this._runtimeDisconnecting) return;
   ensureRuntime(this);
   if (this._runtimeVisible === false) return;
+  if (syncMotionPreference(this)) this._runtimeVisualDirty = true;
   return baseResumeFrames.call(this);
 };
+proto._draw = function(now) {
+  syncMotionPreference(this);
+  const result = baseDraw.call(this, now);
+  this._runtimeVisualDirty = false;
+  return result;
+};
 proto._canPauseFrames = function(now) {
   if (this._runtimeVisible === false) return true;
-  if (!reducedMotion(this)) return baseCanPauseFrames.call(this, now);
-  if (this._pendingPointerEvent || this._pendingDragEvent) return false;
+  const reduced = syncMotionPreference(this);
+  if (!reduced) return baseCanPauseFrames.call(this, now);
+  if (this._pendingPointerEvent || this._pendingDragEvent || this._runtimeVisualDirty) return false;
   return true;
 };
@@ -568,6 +661,7 @@ function leaveSleepForAction(instance) {
 }
 function prepareReplacement(instance, canonical) {
+  clearAutoSleep(instance);
   cancelActiveAction(instance);
   clearDragGeometry(instance, { preserveClick: true });
   instance._cancelPendingWaits?.();
@@ -618,6 +712,7 @@ proto.input = function(active = true) {
 proto.startWaiting = async function() {
   ensureRuntime(this);
+  clearAutoSleep(this);
   const result = await baseStartWaiting.call(this);
   if (this._waitingRequested && this._waitingFx) beginAction(this, 'waiting', 'api', true);
   return result;
@@ -626,7 +721,7 @@ proto.startWaiting = async function() {
 proto.stopWaiting = function() {
   ensureRuntime(this);
   const record = this._activeActionState?.action === 'waiting' ? this._activeActionState : null;
-  this._runtimeEndingWaiting = true;
+  this._runtimeEndingWaiting = Boolean(record);
   let result;
   try {
     result = baseStopWaiting.call(this);
@@ -661,14 +756,16 @@ proto.wake = function() {
   return result;
 };
-proto._autoSleep = function(now) {
-  const previousSource = this._runtimeActionSource;
-  this._runtimeActionSource = 'automatic';
-  try {
-    return baseAutoSleep.call(this, now);
-  } finally {
-    this._runtimeActionSource = previousSource;
-  }
+proto._autoSleep = function() {
+  // Auto-sleep is scheduled independently from drawing by scheduleAutoSleep().
+};
+proto._scheduleAutoSleep = function() {
+  scheduleAutoSleep(this);
+};
+proto._teardownRuntime = function() {
+  teardownRuntime(this);
 };
 function setMask(top, bottom, topY, bottomY, topAngle = 0, bottomAngle = 0) {
@@ -721,6 +818,26 @@ function drawReducedState(instance) {
   }
 }
+for (const property of ['_waitingFx', '_inspectFx', '_failureFx', '_warningFx', '_systemErrorShake']) {
+  const slot = Symbol(property);
+  Object.defineProperty(proto, property, {
+    configurable: true,
+    get() { return this[slot]; },
+    set(value) {
+      this[slot] = value;
+      this._runtimeVisualDirty = true;
+      if (this.isConnected && !this._runtimeDisconnecting && syncMotionPreference(this)) {
+        requestVisualCommit(this);
+        queueMicrotask(() => {
+          if (this.isConnected && !this._runtimeDisconnecting && syncMotionPreference(this)) {
+            cancelContinuousMotion(this);
+          }
+        });
+      }
+    },
+  });
+}
 registerAvatarExtension({
   name: 'runtime-policy',
   reset() {
@@ -728,7 +845,6 @@ registerAvatarExtension({
     if (!this._runtimeEndingWaiting) cancelActiveAction(this, { silent });
     clearDragGeometry(this, { preserveClick: !silent });
     this._pendingPointerEvent = null;
-    if (!this.isConnected) teardownRuntime(this);
   },
   draw() {
     ensureRuntime(this);

package/src/agent-robot-avatar-version.js CHANGED Viewed

@@ -1,3 +1,3 @@
-const VERSION = '0.3.0';
+const VERSION = '0.3.2';
 export { VERSION };

package/src/agent-robot-avatar-runtime-fixes.js DELETED Viewed

@@ -1,178 +0,0 @@
-import AgentRobotAvatar from './agent-robot-avatar-extension-host.js';
-const proto = AgentRobotAvatar.prototype;
-const baseUpdateDragJelly = proto._updateDragJelly;
-const baseResumeFrames = proto._resumeFrames;
-const baseCanPauseFrames = proto._canPauseFrames;
-const baseDraw = proto._draw;
-const baseIsReducedMotion = proto._isReducedMotion;
-let currentEnvironmentEvent = null;
-let clearEnvironmentTimer = 0;
-function rememberEnvironmentEvent(event) {
-  currentEnvironmentEvent = event;
-  if (clearEnvironmentTimer) clearTimeout(clearEnvironmentTimer);
-  clearEnvironmentTimer = setTimeout(() => {
-    currentEnvironmentEvent = null;
-    clearEnvironmentTimer = 0;
-  }, 0);
-}
-if (typeof document !== 'undefined') {
-  document.addEventListener('pointerdown', rememberEnvironmentEvent, true);
-  document.addEventListener('keydown', rememberEnvironmentEvent, true);
-}
-function wakePolicy(instance) {
-  const value = String(instance.getAttribute('wake-on') || 'activity').trim().toLowerCase();
-  return value === 'manual' || value === 'interaction' ? value : 'activity';
-}
-function eventTargetsAvatar(event, instance) {
-  const path = event?.composedPath?.();
-  if (Array.isArray(path)) return path.includes(instance);
-  return event?.target === instance || instance.contains?.(event?.target);
-}
-// Keep the public noteActivity(wake?) contract, but distinguish calls made by
-// the shared environment listeners from explicit API calls. Environment input
-// follows wake-on; an explicit noteActivity() remains an intentional wake.
-proto.noteActivity = function(wake = true) {
-  this._lastActivity = performance.now();
-  this._resumeFrames?.();
-  if (!wake || (!this._sleeping && this._state !== 'sleep')) return;
-  const event = currentEnvironmentEvent;
-  if (!event) {
-    this.wake();
-    return;
-  }
-  const policy = wakePolicy(this);
-  const shouldWake = policy === 'activity' || (policy === 'interaction' && eventTargetsAvatar(event, this));
-  if (!shouldWake) return;
-  const previousSource = this._runtimeActionSource;
-  this._runtimeActionSource = 'automatic';
-  try {
-    this.wake();
-  } finally {
-    this._runtimeActionSource = previousSource;
-  }
-};
-function dragAtRest(drag) {
-  if (!drag || drag.active || drag.returning || drag.pendingReaction) return false;
-  return Math.abs(drag.x) < 0.0001 && Math.abs(drag.y) < 0.0001 &&
-    Math.abs(drag.vx) < 0.0001 && Math.abs(drag.vy) < 0.0001 &&
-    Math.abs(drag.stretch) < 0.0001 && Math.abs(drag.shear) < 0.0001 &&
-    Math.abs(drag.pullX) < 0.0001 && Math.abs(drag.pullY) < 0.0001;
-}
-// Core's original jelly renderer writes an identity transform every frame even
-// after reset. Clear that identity transform once the interaction is fully at
-// rest so reset/disconnect leave no visual residue or unnecessary style churn.
-proto._updateDragJelly = function(dt) {
-  const result = baseUpdateDragJelly.call(this, dt);
-  if (dragAtRest(this._dragJelly)) {
-    if (this._dragMotion) {
-      this._dragMotion.style.transform = '';
-      this._dragMotion.style.transformOrigin = '';
-    }
-    if (this._headShape && this._baseHeadPathD) {
-      this._headShape.setAttribute('d', this._baseHeadPathD);
-    }
-  }
-  return result;
-};
-function cancelContinuousMotion(instance) {
-  const animations = instance._headMotion?.getAnimations?.() || [];
-  for (const animation of animations) animation.cancel();
-  if (instance._headMotion) instance._headMotion.style.transform = '';
-  instance._blinkAnim = null;
-  instance._blink = 1;
-  instance._boredRoutine = null;
-  instance._boredLookSpeed = null;
-  if (instance._wanderTarget) instance._wanderTarget.x = instance._wanderTarget.y = 0;
-  if (instance._look) instance._look.x = instance._look.y = 0;
-}
-function requestedMotion(instance) {
-  const value = String(instance.getAttribute('motion') || 'auto').trim().toLowerCase();
-  return value === 'reduce' || value === 'full' ? value : 'auto';
-}
-function effectiveReducedMotion(instance) {
-  const requested = requestedMotion(instance);
-  if (requested === 'reduce') return true;
-  if (requested === 'full') return false;
-  // A fresh MediaQueryList avoids engine-specific delays where an older
-  // MediaQueryList object's matches value lags behind a runtime preference
-  // update. Fall back to the coordinator's original resolver when unavailable.
-  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
-    return window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-  }
-  return baseIsReducedMotion.call(instance);
-}
-function syncMotionPreference(instance) {
-  const reduced = effectiveReducedMotion(instance);
-  if (instance._runtimeLastReducedMotion === reduced) return reduced;
-  instance._runtimeLastReducedMotion = reduced;
-  instance._runtimeVisualDirty = true;
-  if (reduced) cancelContinuousMotion(instance);
-  return reduced;
-}
-// Some engines deliver matchMedia change events later than the next animation
-// frame. Also sample the effective preference while frames are active so a
-// runtime switch cannot leave an old Web Animation running until that event.
-proto._isReducedMotion = function() {
-  return syncMotionPreference(this);
-};
-// Reduced motion should render each newly reached static state once, then stop
-// scheduling frames. Extension effects historically create some Web Animations
-// directly instead of routing through _animateHead; cancel those in a microtask
-// after an effect becomes active so ordinary-mode animation code stays intact.
-for (const property of ['_waitingFx', '_inspectFx', '_failureFx', '_warningFx', '_systemErrorShake']) {
-  const slot = Symbol(property);
-  Object.defineProperty(proto, property, {
-    configurable: true,
-    get() { return this[slot]; },
-    set(value) {
-      this[slot] = value;
-      this._runtimeVisualDirty = true;
-      if (this.isConnected && this._isReducedMotion?.()) {
-        this._resumeFrames?.();
-        queueMicrotask(() => {
-          if (this.isConnected && this._isReducedMotion?.()) cancelContinuousMotion(this);
-        });
-      }
-    },
-  });
-}
-proto._resumeFrames = function() {
-  if (this._isReducedMotion?.()) this._runtimeVisualDirty = true;
-  return baseResumeFrames.call(this);
-};
-proto._draw = function(now) {
-  syncMotionPreference(this);
-  const result = baseDraw.call(this, now);
-  this._runtimeVisualDirty = false;
-  return result;
-};
-proto._canPauseFrames = function(now) {
-  syncMotionPreference(this);
-  if (this._isReducedMotion?.() && this._runtimeVisualDirty) return false;
-  return baseCanPauseFrames.call(this, now);
-};
-export { AgentRobotAvatar };
-export default AgentRobotAvatar;