@oxy.so/bloom 7.0.1 → 7.1.0

package/docs/adoption-matrix.mdx

@@ -113,9 +113,9 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `activity-heatmap` | `@oxy.so/bloom/activity-heatmap` + barrel | universal | `activity-heatmap.mdx` | yes | 1 |  |  |  |  |
 | `address` | `@oxy.so/bloom/address` + barrel | universal | `address.mdx` | yes | 2 | n/a¹ |  |  |  |
 | `admonition` | `@oxy.so/bloom/admonition` + barrel | universal | `admonition.mdx` | yes | 1 |  |  |  |  |
-| `agent-avatar` | `@oxy.so/bloom/agent-avatar` + barrel | universal | `agent-avatar.mdx` | yes | 9 |  |  |  |  |
+| `agent-avatar` | `@oxy.so/bloom/agent-avatar` + barrel | universal | `agent-avatar.mdx` | yes | 14 |  |  |  |  |
 | `agent-chat` | `@oxy.so/bloom/agent-chat` + barrel | web fork | `agent-chat.mdx` | yes | 3 | n/a¹ |  |  | reads |
-| `agent-creator` | `@oxy.so/bloom/agent-creator` + barrel | web fork | `agent-creator.mdx` | yes | 4 | reads |  |  |  |
+| `agent-creator` | `@oxy.so/bloom/agent-creator` + barrel | web fork | `agent-creator.mdx` | yes | 5 | reads |  |  |  |
 | `agent-limits-card` | `@oxy.so/bloom/agent-limits-card` + barrel | universal | `agent-limits-card.mdx` | yes | 2 |  |  |  | reads |
 | `agent-log` | `@oxy.so/bloom/agent-log` + barrel | universal | `agent-log.mdx` | yes | 1 |  |  |  |  |
 | `agent-progress` | `@oxy.so/bloom/agent-progress` + barrel | universal | `agent-progress.mdx` | yes | 2 |  |  |  | reads |
@@ -192,7 +192,7 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `hooks` | `@oxy.so/bloom/hooks` + barrel | universal | `hooks.mdx` | yes | 12 |  |  |  | reads |
 | `hover-card` | `@oxy.so/bloom/hover-card` + barrel | web fork | `hover-card.mdx` | yes | 4 |  |  | reads | reads |
 | `icon-circle` | `@oxy.so/bloom/icon-circle` + barrel | universal | `icon-circle.mdx` | yes | 1 |  |  |  |  |
-| `icons` | `@oxy.so/bloom/icons` + barrel | universal | `icons.mdx` | yes | 59 |  |  |  |  |
+| `icons` | `@oxy.so/bloom/icons` + barrel | universal | `icons.mdx` | yes | 60 |  |  |  |  |
 | `image-aspect-ratio-cache` | `@oxy.so/bloom/image-aspect-ratio-cache` + barrel | universal | `image-aspect-ratio-cache.mdx` | yes | 1 |  |  |  |  |
 | `image-resolver` | `@oxy.so/bloom/image-resolver` + barrel | universal | `image-resolver.mdx` | yes | 8 |  |  |  |  |
 | `important-alerts-card` | `@oxy.so/bloom/important-alerts-card` + barrel | universal | `important-alerts-card.mdx` | yes | 1 |  |  |  |  |
@@ -260,7 +260,7 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `pressable-scale` | `@oxy.so/bloom/pressable-scale` + barrel | universal | `pressable-scale.mdx` | yes | 1 |  |  |  |  |
 | `price-breakdown` | `@oxy.so/bloom/price-breakdown` + barrel | universal | `price-breakdown.mdx` | yes | 3 |  |  |  | reads |
 | `progressive-blur` | `@oxy.so/bloom/progressive-blur` + barrel | web fork | `progressive-blur.mdx` | yes | 1 |  |  |  |  |
-| `project-board` | `@oxy.so/bloom/project-board` + barrel | web fork | `project-board.mdx` | yes | 1 |  |  |  |  |
+| `project-board` | `@oxy.so/bloom/project-board` + barrel | web fork | `project-board.mdx` | yes | 2 |  |  |  |  |
 | `proof-of-delivery` | `@oxy.so/bloom/proof-of-delivery` + barrel | universal | `proof-of-delivery.mdx` | yes | 1 |  |  |  | reads |
 | `property-insights` | `@oxy.so/bloom/property-insights` + barrel | universal | `property-insights.mdx` | yes | 5 |  |  |  | reads |
 | `provider` | `@oxy.so/bloom/provider` | universal | `provider.mdx` | yes | 3 |  |  |  |  |
@@ -274,9 +274,9 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `route-stops` | `@oxy.so/bloom/route-stops` + barrel | universal | `route-stops.mdx` | yes | 2 |  |  |  |  |
 | `screen` | `@oxy.so/bloom/screen` + barrel | universal | `screen.mdx` | yes | 5 |  |  |  |  |
 | `scroll` | `@oxy.so/bloom/scroll` + barrel | web fork | `scroll.mdx` | yes | 5 |  |  |  |  |
-| `search` | `@oxy.so/bloom/search` + barrel | universal | `search.mdx` | yes | 3 |  |  |  |  |
+| `search` | `@oxy.so/bloom/search` + barrel | universal | `search.mdx` | yes | 4 |  |  |  |  |
 | `segmented-control` | `@oxy.so/bloom/segmented-control` + barrel | universal | `segmented-control.mdx` | yes | 4 | reads | reads |  |  |
-| `select` | `@oxy.so/bloom/select` + barrel | web fork | `select.mdx` | yes | 10 | reads | reads | reads | reads |
+| `select` | `@oxy.so/bloom/select` + barrel | web fork | `select.mdx` | yes | 11 | reads | reads | reads | reads |
 | `settings-list` | `@oxy.so/bloom/settings-list` + barrel | universal | `settings-list.mdx` | yes | 5 |  |  |  |  |
 | `settings-modal` | `@oxy.so/bloom/settings-modal` + barrel | universal | `settings-modal.mdx` | yes | 10 |  |  |  | reads |
 | `shapes` | `@oxy.so/bloom/shapes` + barrel | universal | `shapes.mdx` | yes | 4 |  |  |  |  |
@@ -292,7 +292,7 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `stay-search` | `@oxy.so/bloom/stay-search` + barrel | universal | `stay-search.mdx` | yes | 5 |  |  |  |  |
 | `stepper` | `@oxy.so/bloom/stepper` + barrel | universal | `stepper.mdx` | yes | 4 | reads | reads |  |  |
 | `sticker` | `@oxy.so/bloom/sticker` + barrel | web fork | `sticker.mdx` | yes | 1 |  |  |  |  |
-| `styles` | `@oxy.so/bloom/styles` + barrel | universal | `styles.mdx` | yes | 84 | n/a¹ |  |  |  |
+| `styles` | `@oxy.so/bloom/styles` + barrel | universal | `styles.mdx` | yes | 85 | n/a¹ |  |  |  |
 | `subtle-hover` | `@oxy.so/bloom/subtle-hover` + barrel | universal | `subtle-hover.mdx` | yes | 1 |  |  |  |  |
 | `surface` | `@oxy.so/bloom/surface` + barrel | web fork | `surface.mdx` | yes | 38 |  |  |  |  |
 | `surfaces` | `@oxy.so/bloom/surfaces` + barrel | web fork | `alert.mdx` | yes | 3 |  |  |  |  |
@@ -305,9 +305,9 @@ The classification is an EQUALITY in `src/__tests__/adoption-matrix.test.ts`, no
 | `task-list` | `@oxy.so/bloom/task-list` + barrel | universal | `task-list.mdx` | yes | 1 |  |  |  |  |
 | `teleport` | `@oxy.so/bloom/teleport` | universal | `teleport.mdx` | yes | 1 |  |  |  |  |
 | `tenancy` | `@oxy.so/bloom/tenancy` + barrel | universal | `tenancy.mdx` | yes | 5 |  | reads |  |  |
-| `text-field` | `@oxy.so/bloom/text-field` + barrel | universal | `text-field.mdx` | yes | 16 | reads | reads |  |  |
+| `text-field` | `@oxy.so/bloom/text-field` + barrel | universal | `text-field.mdx` | yes | 17 | reads | reads |  |  |
 | `textarea` | `@oxy.so/bloom/textarea` + barrel | universal | `textarea.mdx` | yes | 4 | reads | reads |  | n/a¹ |
-| `theme` | `@oxy.so/bloom/theme` + barrel | web fork | `theme.mdx` | yes | 351 |  |  | n/a¹ | reads |
+| `theme` | `@oxy.so/bloom/theme` + barrel | web fork | `theme.mdx` | yes | 353 |  |  | n/a¹ | reads |
 | `theme-toggle` | `@oxy.so/bloom/theme-toggle` + barrel | universal | `theme-toggle.mdx` | yes | 2 | n/a¹ |  |  |  |
 | `toast` | `@oxy.so/bloom/toast` + barrel | universal | `toast.mdx` | yes | 17 |  |  |  |  |
 | `tooltip` | `@oxy.so/bloom/tooltip` + barrel | web fork | `tooltip.mdx` | yes | 1 |  |  |  |  |

package/docs/agent-avatar.mdx

@@ -1,24 +1,49 @@
 ---
 title: Agent Avatar
-description: Procedural agent artwork with editable recipes, expressions and motion.
+description: Editable agent artwork and the recovered 3D character renderer.
 ---
 
 # Agent Avatar
 
-`AgentAvatar` draws the same artwork with `react-native-svg` on web, iOS and Android. Recipes retain their own colors when the application theme changes.
+`AgentAvatar` uses the recovered original beta engine for its 3D characters. With an `AgentAvatarProvider`, existing recipes for the paper and blob silhouettes also render through that engine, retaining its fur, lighting, volume and animation. Circle, triangle, flower, diamond and heart reuse the engine’s corresponding shapes. Eight distinct bodies extend that catalog: pebble, squircle, slender, pocket, petal, star, cloud and shield. Their contours come from Bloom’s existing artwork; saved recipes do not need rewriting. All supported bodies use the original 3D eye catalog and animation.
 
 ```tsx
-import { AgentAvatar, FOLD_CONFIG } from '@oxy.so/bloom/agent-avatar';
-
-<AgentAvatar config={{ ...FOLD_CONFIG, eyes: 'curious', hue: 254 }} size={64} label="Peri" />
+import { AgentAvatar, AgentAvatarProvider, FOLD_CONFIG } from '@oxy.so/bloom/agent-avatar';
+
+<AgentAvatarProvider runtimeUrl="https://example.com/bloom-character/runtime.mjs">
+  <AgentAvatar
+    config={{ ...FOLD_CONFIG, character: {
+      preset: 'blue_beret', selections: { accessory: 'crown' },
+    } }}
+    size={128}
+    interactive
+    label="Peri"
+  />
+</AgentAvatarProvider>
 ```
 
-`config` is an `AvatarConfig`. The published presets include blobs, folded paper and aliens; the original recipe schema also retains its mascot settings. The source artwork currently renders the mascot family through the blob silhouette and material path; outfit and activity settings have no additional renderer. `parsePreset` validates saved recipes and migrates older field values.
+Host the package's complete `assets/character-runtime/` directory. The provider takes the URL of `runtime.mjs` and loads it only when an avatar is visible. The original generated engine files are preserved byte for byte with an integrity manifest. See the asset directory's README for provenance and source limitations.
+
+## Editing
+
+The `character` recipe holds a `preset` and optional `selections` for shape, color, eyes, eyewear and accessory. Explicit selections override preset defaults. `none` removes eyewear or an accessory. The editor reads the engine's actual selection and availability, including shape-dependent eye styles. Changing shape clears an explicit eye override so an unsupported pair is not restored.
+
+The editor presents one shape catalog and one eye catalog through `ShapeArc` and `EmotionPicker`. The eye orbit offers the engine’s nine native styles for both original and migrated bodies, with unsupported combinations disabled. Migrated bodies default to the original oval eyes. Saved expression, eye-size, spacing and tilt fields no longer modify a migrated face; the engine owns its eye geometry and animation. The shared `GlossArt` palette and custom color picker edit either body source. Original presets keep their authored appearance until explicitly edited.
+
+Alien avatars have been removed from the available catalog. Saved aliens, mascots and hidden-face recipes retain compatibility rendering. The shape selector shows static silhouettes without eyes or accessories: original catalog PNGs and cached SVG contours for migrated bodies. Paper grain and material effects become the engine’s 3D surface. Migrated bodies accept the original eyewear and accessory catalog. Headwear, Bulb, bow and Tuft use rigid contour anchors; eyewear and headphones retain their original placement. Original meshes, materials and fur remain intact.
+
+## Interaction and lifecycle
+
+`interactive` enables the original engine's pointer tracking and touch/drag interaction. Change `reactionKey` from an accessible button to replay its authored signature reaction for an intact preset, or the original 3D wave for customized and migrated bodies. Shape changes retain the last painted frame while the new geometry prepares. Changing `workingKey` starts a working episode and then returns to the interactive mode; `workingCycles` controls its duration. The creator’s **React** and **Work** buttons preview these original animations for both original and migrated bodies.
+
+`paused`, reduced motion and `motion: 0` stop animation after a complete appearance frame. `portrait` prepares a static thumbnail. The beta can report readiness while drawing transparency if initialized with its reduced-motion flag; the adapter waits for painted pixels and then freezes its clock instead.
+
+Web shares the beta engine and one animation clock per document. Different migrated contours isolate their rendering modules because the recovered engine caches geometry by its original appearance key; they share one preparation worker. Unused contour modules are released. Animated characters each need a graphics surface. Use `portrait` for galleries and selectors. Static thumbnail preparation is serialized, retains a bounded cache and releases its graphics surface after painting. Offscreen/background avatars pause; unmount releases listeners and rendering resources.
 
-Change `entranceKey` to replay the curled arrival and `workingKey` to play a hop and full paper turn. `workingCycles` defaults to one. `paused`, reduced motion and `motion: 0` freeze animation; expression and explicit gaze changes still render. Sleeping agents use closed lids and four drifting sleep marks. The original `interactive` and `portrait` compatibility props remain reserved.
+`className` and `style` apply to the outer layout node through Bloom's NativeWind wrapper. `label` defaults to the translated “Agent avatar”; `locale` overrides the scope and `accessibilityLabel` overrides the name. Prefer a meaningful name when the avatar identifies an agent.
 
-`className` and `style` apply to the outer layout node through Bloom's NativeWind wrapper. `label` defaults to the translated “Agent avatar” in the nearest locale scope (`locale` overrides it); `accessibilityLabel` overrides it. Prefer a meaningful name when the image identifies an agent.
+## Native and fallback
 
-The renderer preserves the original silhouettes, projection, expression springs, blink timing, attention, wandering, fold turns, shape morphs, gradient stops and deterministic grain tile. It updates drawing geometry on the JavaScript animation clock and pauses in the background or when outside the viewport on web. Large animated grids should be profiled on the target device.
+The optional native bridge uses `react-native-webview` and requires an absolute runtime URL reachable by the device. Web is verified in Chrome; physical-device validation remains pending. Separate WebViews cannot share engine memory or graphics contexts.
 
-Grain uses the original seed-713 tile and `soft-light` compositing on isolated React Native view layers, shared with web. This requires the new native renderer and Android 10 or later; older native renderers do not implement this blend mode. Blob grain follows the original backing-pixel scale (capped at 2×), while paper grain follows the original CSS-pixel scale. Sleep marks retain the original `ui-rounded, system-ui, sans-serif` font stack; installed fonts can differ between platforms. Physical-device pixel comparisons remain necessary.
+An unavailable runtime or missing native peer displays the translated unavailable state. Consumers without a runtime provider retain the universal SVG renderer for procedural recipes. That renderer preserves the original contours, folds, expression springs and deterministic grain; it does not support the beta's new 3D parts.

package/docs/agent-creator.mdx

@@ -1,6 +1,6 @@
 ---
 title: AgentCreator
-description: Controlled agent profile editor with live avatar, emotion orbit, shape arc, custom color, and speech preferences.
+description: Controlled agent profile editor with a live 3D avatar, eye orbit, shape arc, custom color, and speech preferences.
 order: 105
 ---
 
@@ -25,9 +25,17 @@ Mount under `BloomProvider` and give the editor a bounded height. Layout classes
 
 ## Appearance
 
-The preview is 162px. Sixteen upright expression chips orbit at a 116px radius; dragging or a mouse wheel rotates the orbit. Hover, focus, backgrounding and reduced motion pause automatic movement. The shape selector uses the source's 210px circular track, unbounded index, spring, drag and wheel geometry. Choose a silhouette by pressing it; keyboard arrows, Home and End select shapes on web. BloomProvider’s direction reverses horizontal movement in RTL.
+The preview is 162px. With `AgentAvatarProvider`, one shape arc combines the eleven original engine shapes with eight distinct migrated bodies: pebble, squircle, slender, pocket, petal, star, cloud and shield. Equivalent circle, triangle, flower, diamond and heart recipes reuse the original geometry. Alien avatars have been removed from the available catalog and examples; saved alien recipes remain readable for compatibility.
 
-Nine glossy color presets preserve the avatar's other controls. The custom picker contains a saturation/brightness field, hue rail and hex entry; dark custom fills switch to light eyes. HSV state preserves the selected hue when the field reaches black or gray. Invalid hex input resets to the last emitted color. Speech and appearance edits preserve the agent's identity and unrelated fields.
+The eye orbit offers nine original 3D eye styles for both body sources. Migrated bodies default to oval eyes; historical expression, eye-size, spacing and tilt settings no longer alter their faces. The engine owns eye geometry and animation, and its capabilities disable unsupported combinations. Changing shape clears an incompatible eye override. Original presets keep their authored eyes until explicitly edited.
+
+Upright eye chips orbit at a 116px radius; dragging or a mouse wheel rotates the orbit. Hover, focus, backgrounding and reduced motion pause automatic movement. The shape selector uses a 210px circular track, an unbounded index, spring, drag and wheel geometry. Choose a silhouette by pressing it; keyboard arrows, Home and End select shapes on web. BloomProvider’s direction reverses horizontal movement in RTL.
+
+Nine glossy color presets and the shared custom picker edit both original and migrated bodies. The picker contains a saturation/brightness field, hue rail and hex entry. HSV state preserves the selected hue when the field reaches black or gray; invalid hex input resets to the last emitted color. Choosing a named engine swatch clears its custom RGB override. Speech and appearance edits preserve the agent’s identity and unrelated fields.
+
+The preview accepts pointer and touch reactions. **React** and **Work** buttons also support keyboard activation and preview the original engine’s animations on either body source. Working returns to the interactive preview after its episode. Eye chips and original shape chips use catalog PNG thumbnails. Migrated shape chips use cached static SVG silhouettes from their actual contours, matching the catalog’s flat pink artwork. The shape wheel renders no avatars or 3D canvases.
+
+The preset selector provides authored characters; eyewear and accessories use Bloom Select on both original and migrated bodies. Explicit selections survive switching between these bodies. Headwear, Bulb, bow and Tuft attach to migrated contour anchors; eyewear and headphones keep their original placement. Intact presets retain their authored signature reaction; edited and migrated bodies use the original 3D wave. Catalog titles retain their original English names by default. Hosts can translate them through `labels.characterOption(category, id, title)`; control labels follow the editor locale. Consumers without a runtime provider retain compatibility rendering and controls for saved procedural recipes.
 
 ## Preferences and speech
 
@@ -39,7 +47,7 @@ Web previews use the browser's local device voice catalog and cancel playback wh
 
 ## Locale and shared primitives
 
-All fixed labels, hints, accessible names and picker values use the `AGENT_CREATOR_MESSAGES` catalog and Bloom’s 15 supported locales. `locale` overrides the root locale for this editor; `labels` overrides individual catalog entries. Agent names, descriptions and host voice names remain consumer data.
+Fixed labels, hints and accessible control names use the `AGENT_CREATOR_MESSAGES` catalog and Bloom’s 15 supported locales. `locale` overrides the root locale for this editor; `labels` overrides individual catalog entries. Agent names, descriptions and host voice names remain consumer data.
 
 Profile inputs, textarea, select, switch, segmented control, close control and popover reuse Bloom’s current primitives. Original layout and interaction class chains are retained. Bloom’s active palette and materials supply their colors. The custom HSV picker reads `Field` membership: disabling the enclosing field disables its gestures, keyboard updates and hex input; field errors and descriptions associate with its inputs.
 

package/docs/multi-agent-chat.mdx

@@ -3,6 +3,11 @@
 `MultiAgentChat` combines individual and group conversations, the agent creator,
 animated avatars, an editable agent library and a demo marketplace.
 
+The conversation header centers a 56px agent avatar above a 28px name capsule.
+Press it to edit the active agent, or choose participants in a group chat. Long
+names truncate within the available header width; navigation and conversation
+actions keep their own hit areas on narrow screens.
+
 ```tsx
 import { MultiAgentChat } from '@oxy.so/bloom/multi-agent-chat';
 
@@ -67,3 +72,10 @@ geometry on web and native. NativeWind’s default 14px rem otherwise compiles
 `gap-2.5` to 8.75px rather than 10px; the installed preview also drops Metro’s
 `inlineRem` option on one export path. No consumer rem workaround is required
 for these component utilities: import Bloom’s generated theme/preset.
+
+Browser checks for header alignment, keyboard editing, long names and sidebar
+search transitions: `node scripts/verify-chat-interactions.mjs` against Storybook
+on port 6006. Set `BLOOM_PLAYWRIGHT_MODULE` if Playwright is installed elsewhere.
+The search width has one animation owner per platform: CSS on web and Reanimated
+on native. Combining them restarts the CSS transition every frame and doubles
+the observed opening time.

package/docs/project-board.mdx

@@ -26,10 +26,10 @@ On web, Enter opens a ticket; space picks it up, arrows move it, space commits a
 
 ## Motion and verification
 
-The original Tailwind class recipes, custom SVG glyphs, empty-state geometry and reveal timing remain in the shared NativeWind content. The template preserves the original 272px drawer, 325ms reveal, 273px columns and shell insets while reusing Bloom’s current Sidebar. Buttons, chips, fields, selectors, menus, tooltips and charts compose Bloom 6.4 primitives. Palette and material follow the current Bloom theme.
+The original Tailwind class recipes, custom SVG glyphs, empty-state geometry and reveal timing remain in the shared NativeWind content. Ticket presence expands/collapses the measured slot and its 6px gap over 320ms while fading, scaling between 0.7 and 1, and changing blur between 6px and 0. Initial tickets stay at rest. Removed tickets become inaccessible immediately; the gesture owner remains mounted through a long cross-column drag. Drops keep the visual overlay for the 320ms trip to the measured destination, hiding the resting card until arrival. Cancelling a cross-column preview restores the original columns. The template preserves the original 272px drawer, 325ms reveal, 273px columns and shell insets while reusing Bloom’s current Sidebar. Buttons, chips, fields, selectors, menus, tooltips and charts compose the current Bloom primitives. Palette and material follow the current Bloom theme.
 
-Web runs the original create Genie displacement field and the detail Genie’s cached perspective bands: live content remains interactive at rest; visual copies are inert and have rebased SVG IDs. The dialogs retain Bloom’s imperative lifecycle, focus handling and overlay stack through `presentation="custom"`. Entry/exit reverse from the current shape when interrupted and respect reduced motion.
+Web runs the original create Genie displacement field and the detail Genie’s cached perspective bands: live content remains interactive at rest; visual copies are inert and have rebased SVG IDs. The dialogs retain Bloom’s imperative lifecycle, focus handling and overlay stack through `presentation="custom"`. Entry/exit reverse from the current shape when interrupted and respect reduced motion. Detail snapshots target Bloom’s shared chart SVG and rebase its paint references. Its plot reveal waits for the Genie handoff; `TokensChartCard animate={false}` paints the full plot without a reveal frame loop and changing back to `true` restarts from zero. Raw injected CSS uses normal selectors, including the dark shadow, rather than CSS-module syntax.
 
 React Native can animate the original stretch, scale, translation and timing through Reanimated, but it does not expose a View’s live pixels as `feDisplacementMap` input or DOM clipping bands. Those two pixel deformations remain specific to web. Native touch/paint behavior has not been verified on a physical device; platform CSS exports do not establish pixel equivalence.
 
-Chrome at 1440×900 compared the original and Bloom side by side: create measured 560×230px and detail 609×876px in both, with the original descriptions, people, resources, activity and token data. Real browser checks cover wide/compact, dark and RTL rendering, keyboard moves, creation, favorites, comments and Escape. Thirteen focused Jest cases cover data transitions, interactions and default/custom Dialog completion semantics. Browser keyboard capture is intentional because react-native-web consumes space before bubbling. Pointer dragging remains a separate browser check; the final scripted drag started from a card outside the horizontally scrolled viewport and did not establish a drop result.
+Chrome at 1440×900 compared the original and Bloom side by side: create measured 560×230px and detail 609×876px in both, with the original descriptions, people, resources, activity and token data. Real browser checks cover wide/compact, dark and RTL rendering, keyboard moves, creation, favorites, comments and Escape. Thirteen focused Jest cases cover data transitions, interactions and default/custom Dialog completion semantics. Browser keyboard capture is intentional because react-native-web consumes space before bubbling. The polish browser checks now establish pointer drops within a column, across columns after holding for 1200ms, and outside-column cancellation; all finish without a residual overlay. These pointer checks cover LTR; RTL pointer dragging and edge auto-scroll remain unverified. At 390×844 the detail measures 374×828 with 8px outer insets. Native long creation forms have a bounded ScrollView that preserves submit taps. A local headless Chrome frame sample over 1.6 seconds measured 90 frames in the reference and 61 in Bloom, with maximum gaps of 103ms and 130ms respectively; equivalent geometry and timelines do not establish equal rendering performance.

package/lib/commonjs/agent-avatar/AgentAvatar.js

@@ -3,212 +3,24 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AgentAvatar = AgentAvatar;
+exports.AgentAvatar = void 0;
 var _react = require("react");
-var _reactNative = require("react-native");
-var _reactNativeReanimated = require("react-native-reanimated");
-var _messages = require("../locale/messages.js");
-var _styledPrimitives = require("../styles/styled-primitives.js");
-var _artwork = require("./artwork.js");
-var _attention = require("./attention.js");
-var _blink = require("./blink.js");
+var _CharacterAvatar = require("./CharacterAvatar.js");
+var _ProceduralAvatar = require("./ProceduralAvatar.js");
 var _context = require("./context.js");
-var _drawing = require("./drawing.js");
-var _entrance = require("./entrance.js");
-var _face = require("./face.js");
-var _messages2 = require("./messages.js");
-var _SvgDrawing = require("./SvgDrawing.js");
-var _wander = require("./wander.js");
-var _working = require("./working.js");
+var _legacyRecipe = require("./legacy-recipe.js");
 var _jsxRuntime = require("react/jsx-runtime");
-const TAU = Math.PI * 2;
-const randomSeed = () => {
-  if (globalThis.crypto?.getRandomValues) return globalThis.crypto.getRandomValues(new Uint32Array(1))[0];
-  return Math.floor(Math.random() * 4294967296) >>> 0;
-};
-
-/** Animated procedural artwork; shared geometry, face rig and materials across platforms. */
-function AgentAvatar({
-  config,
-  size = 64,
-  paused = false,
-  label,
-  locale,
-  entranceKey,
-  workingKey,
-  workingCycles = 1,
-  className,
-  style,
-  accessibilityLabel,
-  testID
-}) {
+/** Both catalogs use the recovered engine when their recipe is supported. */
+const AgentAvatar = exports.AgentAvatar = /*#__PURE__*/(0, _react.memo)(function AgentAvatar(props) {
   const {
-    messages
-  } = (0, _messages.useMessages)(_messages2.AGENT_AVATAR_MESSAGES, locale);
-  const initialReduced = (0, _reactNativeReanimated.useReducedMotion)();
-  const [reduced, setReduced] = (0, _react.useState)(initialReduced);
-  (0, _react.useEffect)(() => {
-    const subscription = _reactNative.AccessibilityInfo.addEventListener('reduceMotionChanged', setReduced);
-    const media = _reactNative.Platform.OS === 'web' && typeof matchMedia !== 'undefined' ? matchMedia('(prefers-reduced-motion: reduce)') : undefined;
-    const change = () => setReduced(media.matches);
-    media?.addEventListener('change', change);
-    if (media) change();
-    return () => {
-      subscription?.remove?.();
-      media?.removeEventListener('change', change);
-    };
-  }, []);
-  const backingSize = Math.round(size * Math.min(_reactNative.PixelRatio.get() || 1, 2));
-  const root = (0, _react.useRef)(null);
-  const randomized = (0, _react.useRef)(false);
-  const state = (0, _react.useRef)(null);
-  if (!state.current) {
-    const seed = config.seed >>> 0;
-    state.current = {
-      phase: seed / 4294967296 * TAU,
-      blink: (0, _blink.createBlink)(seed),
-      wander: (0, _wander.createWander)(seed ^ config.seed, config.family === 'fold'),
-      attention: (0, _attention.createAttention)(seed ^ config.seed),
-      shapeMorph: {
-        started: 0,
-        active: false
-      },
-      velocity: {},
-      entrance: {
-        elapsed: _entrance.ENTRANCE_SECONDS
-      },
-      working: {
-        elapsed: _working.WORKING_SECONDS
-      }
-    };
-  }
-  const renderDrawing = () => {
-    const context = new _drawing.DrawingContext(),
-      s = state.current;
-    const appearance = (0, _face.faceAtSize)(config, size),
-      target = (0, _face.expressionRig)(appearance);
-    (0, _artwork.drawAvatar)(context, appearance, s.phase, s.face ?? target, s.gaze ?? (0, _face.gazeAngles)(appearance, s.phase, target), size, s.entrance.elapsed, s.working.elapsed, undefined, Math.max(1, Math.floor(workingCycles)), backingSize);
-    return context;
-  };
-  const [drawing, setDrawing] = (0, _react.useState)(renderDrawing);
-  const observeDrawing = (0, _react.useContext)(_context.AvatarDrawingObserver);
-  (0, _react.useLayoutEffect)(() => {
-    observeDrawing?.(drawing);
-  }, [observeDrawing, drawing]);
-  (0, _react.useEffect)(() => {
-    const s = state.current,
-      cycles = Math.max(1, Math.floor(workingCycles));
-    if (!randomized.current) {
-      s.wander = (0, _wander.createWander)(randomSeed() ^ config.seed, config.family === 'fold');
-      const seed = randomSeed();
-      s.phase = seed / 4294967296 * TAU;
-      s.blink = (0, _blink.createBlink)(seed);
-      s.attention = (0, _attention.createAttention)(randomSeed() ^ config.seed);
-      randomized.current = true;
-    }
-    const duration = _working.WORKING_SECONDS * cycles,
-      appearance = (0, _face.faceAtSize)(config, size),
-      target = (0, _face.expressionRig)(appearance);
-    if (s.entrance.key !== entranceKey) s.entrance = {
-      key: entranceKey,
-      elapsed: entranceKey === undefined || paused ? _entrance.ENTRANCE_SECONDS : 0
-    };
-    if (s.working.key !== workingKey) {
-      s.working = {
-        key: workingKey,
-        elapsed: workingKey === undefined || paused ? duration : 0
-      };
-      if (workingKey !== undefined) s.entrance.elapsed = _entrance.ENTRANCE_SECONDS;
-    }
-    if (config.idle || workingKey === undefined) s.working.elapsed = duration;
-    s.expression ??= s.face ?? target;
-    s.face ??= target;
-    s.gaze ??= (0, _face.gazeAngles)(appearance, s.phase, target, s.wander.point);
-    const frozen = paused || reduced || config.motion === 0;
-    if (reduced || config.motion === 0) {
-      s.entrance.elapsed = _entrance.ENTRANCE_SECONDS;
-      s.working.elapsed = duration;
-    }
-    if (frozen) {
-      s.shapeMorph = {
-        started: 0,
-        active: false
-      };
-      s.face = target;
-      s.expression = target;
-      s.velocity = {};
-      if (!paused || config.lookAt !== 'wander') s.gaze = (0, _face.gazeAngles)(appearance, s.phase, target, s.wander.point);
-    }
-    const draw = () => {
-      const context = new _drawing.DrawingContext();
-      (0, _artwork.drawAvatar)(context, appearance, s.phase, s.face, s.gaze, size, s.entrance.elapsed, s.working.elapsed, frozen ? undefined : s.shapeMorph, cycles, backingSize);
-      setDrawing(context);
-    };
-    let frame = 0,
-      last = 0,
-      visible = true,
-      active = _reactNative.AppState.currentState !== 'background',
-      transitioning = true;
-    const tick = now => {
-      if (!last) last = now;
-      if (now - last >= (transitioning ? 16 : 32)) {
-        if (visible && active) {
-          const milliseconds = Math.min(now - last, 64),
-            seconds = milliseconds / 1000;
-          s.entrance.elapsed = Math.min(_entrance.ENTRANCE_SECONDS, s.entrance.elapsed + seconds);
-          s.working.elapsed = Math.min(duration, s.working.elapsed + seconds);
-          const base = (0, _face.easeFace)(s.expression ?? target, target, s.velocity, seconds);
-          s.expression = base;
-          transitioning = Object.keys(target).some(key => base[key] !== target[key]) || s.shapeMorph.active;
-          s.face = config.family === 'fold' || base.smile > 0.2 ? (0, _attention.advanceAttention)(s.attention, seconds * 8 / config.duration, base, appearance) : base;
-          s.face.blink = config.idle ? 1 : (0, _blink.advanceBlink)(s.blink, seconds);
-          transitioning ||= s.blink.blinking;
-          s.phase = (s.phase + seconds * TAU / config.duration) % TAU;
-          if (!config.idle && config.lookAt === 'wander') (0, _wander.advanceWander)(s.wander, seconds * 8 / config.duration, config.family === 'fold');
-          const aim = (0, _face.gazeAngles)(appearance, s.phase, s.face, s.wander.point),
-            ease = 1 - Math.exp(-milliseconds / 85);
-          s.gaze = [s.gaze[0] + (aim[0] - s.gaze[0]) * ease, s.gaze[1] + (aim[1] - s.gaze[1]) * ease];
-          draw();
-        }
-        last = now;
-      }
-      frame = requestAnimationFrame(tick);
-    };
-    const subscription = _reactNative.AppState.addEventListener('change', next => {
-      active = next === 'active';
-      last = 0;
-    });
-    let observer;
-    if (_reactNative.Platform.OS === 'web' && typeof IntersectionObserver !== 'undefined' && root.current instanceof Element) {
-      observer = new IntersectionObserver(entries => {
-        visible = entries[0]?.isIntersecting ?? true;
-      });
-      observer.observe(root.current);
-    }
-    draw();
-    if (!frozen) frame = requestAnimationFrame(tick);
-    return () => {
-      cancelAnimationFrame(frame);
-      subscription?.remove?.();
-      observer?.disconnect();
-    };
-  }, [config, size, backingSize, paused, reduced, entranceKey, workingKey, workingCycles]);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_styledPrimitives.StyledView, {
-    ref: root,
-    className: className,
-    style: [{
-      width: size,
-      height: size,
-      maxWidth: '100%'
-    }, style],
-    accessible: true,
-    accessibilityRole: "image",
-    accessibilityLabel: accessibilityLabel ?? label ?? messages.label,
-    testID: testID,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_SvgDrawing.Drawing, {
-      context: drawing,
-      size: size
-    })
+    runtimeUrl
+  } = (0, _react.useContext)(_context.CharacterRuntimeContext);
+  const beta = props.config.character && props.config.character.preset !== 'bloom';
+  const legacy = runtimeUrl && !(0, _legacyRecipe.legacyRecipeUnsupported)(props.config);
+  return beta || legacy ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_CharacterAvatar.CharacterAvatar, {
+    ...props
+  }, beta ? 'character' : 'legacy') : /*#__PURE__*/(0, _jsxRuntime.jsx)(_ProceduralAvatar.ProceduralAvatar, {
+    ...props
   });
-}
+});
 //# sourceMappingURL=AgentAvatar.js.map

package/lib/commonjs/agent-avatar/AgentAvatar.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","_reactNativeReanimated","_messages","_styledPrimitives","_artwork","_attention","_blink","_context","_drawing","_entrance","_face","_messages2","_SvgDrawing","_wander","_working","_jsxRuntime","TAU","Math","PI","randomSeed","globalThis","crypto","getRandomValues","Uint32Array","floor","random","AgentAvatar","config","size","paused","label","locale","entranceKey","workingKey","workingCycles","className","style","accessibilityLabel","testID","messages","useMessages","AGENT_AVATAR_MESSAGES","initialReduced","useReducedMotion","reduced","setReduced","useState","useEffect","subscription","AccessibilityInfo","addEventListener","media","Platform","OS","matchMedia","undefined","change","matches","remove","removeEventListener","backingSize","round","min","PixelRatio","get","root","useRef","randomized","state","current","seed","phase","blink","createBlink","wander","createWander","family","attention","createAttention","shapeMorph","started","active","velocity","entrance","elapsed","ENTRANCE_SECONDS","working","WORKING_SECONDS","renderDrawing","context","DrawingContext","s","appearance","faceAtSize","target","expressionRig","drawAvatar","face","gaze","gazeAngles","max","drawing","setDrawing","observeDrawing","useContext","AvatarDrawingObserver","useLayoutEffect","cycles","duration","key","idle","expression","point","frozen","motion","lookAt","draw","frame","last","visible","AppState","currentState","transitioning","tick","now","milliseconds","seconds","base","easeFace","Object","keys","some","smile","advanceAttention","advanceBlink","blinking","advanceWander","aim","ease","exp","requestAnimationFrame","next","observer","IntersectionObserver","Element","entries","isIntersecting","observe","cancelAnimationFrame","disconnect","jsx","StyledView","ref","width","height","maxWidth","accessible","accessibilityRole","children","Drawing"],"sourceRoot":"../../../src","sources":["agent-avatar/AgentAvatar.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_CharacterAvatar","_ProceduralAvatar","_context","_legacyRecipe","_jsxRuntime","AgentAvatar","exports","memo","props","runtimeUrl","useContext","CharacterRuntimeContext","beta","config","character","preset","legacy","legacyRecipeUnsupported","jsx","CharacterAvatar","ProceduralAvatar"],"sourceRoot":"../../../src","sources":["agent-avatar/AgentAvatar.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAD,OAAA;AACA,IAAAE,iBAAA,GAAAF,OAAA;AACA,IAAAG,QAAA,GAAAH,OAAA;AACA,IAAAI,aAAA,GAAAJ,OAAA;AAA0D,IAAAK,WAAA,GAAAL,OAAA;AAG1D;AACO,MAAMM,WAAW,GAAAC,OAAA,CAAAD,WAAA,gBAAG,IAAAE,WAAI,EAAC,SAASF,WAAWA,CAACG,KAAuB,EAAE;EAC5E,MAAM;IAAEC;EAAW,CAAC,GAAG,IAAAC,iBAAU,EAACC,gCAAuB,CAAC;EAC1D,MAAMC,IAAI,GACRJ,KAAK,CAACK,MAAM,CAACC,SAAS,IAAIN,KAAK,CAACK,MAAM,CAACC,SAAS,CAACC,MAAM,KAAK,OAAO;EACrE,MAAMC,MAAM,GAAGP,UAAU,IAAI,CAAC,IAAAQ,qCAAuB,EAACT,KAAK,CAACK,MAAM,CAAC;EACnE,OAAOD,IAAI,IAAII,MAAM,gBACnB,IAAAZ,WAAA,CAAAc,GAAA,EAAClB,gBAAA,CAAAmB,eAAe;IAAA,GAAyCX;EAAK,GAAxCI,IAAI,GAAG,WAAW,GAAG,QAAsB,CAAC,gBAElE,IAAAR,WAAA,CAAAc,GAAA,EAACjB,iBAAA,CAAAmB,gBAAgB;IAAA,GAAKZ;EAAK,CAAG,CAC/B;AACH,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/agent-avatar/AgentAvatarProvider.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AgentAvatarProvider = AgentAvatarProvider;
+var _react = require("react");
+var _context = require("./context.js");
+var _jsxRuntime = require("react/jsx-runtime");
+const EMPTY_CAPABILITIES = new Map();
+function sameRecord(left, right) {
+  const keys = Object.keys(left);
+  return keys.length === Object.keys(right).length && keys.every(key => left[key] === right[key]);
+}
+
+/** Enables the optional character engine without fetching it until an avatar needs it. */
+function AgentAvatarProvider({
+  runtimeUrl,
+  children
+}) {
+  const [cache, setCapabilities] = (0, _react.useState)(() => ({
+    runtimeUrl,
+    entries: EMPTY_CAPABILITIES
+  }));
+  const activeRuntime = (0, _react.useRef)(runtimeUrl);
+  activeRuntime.current = runtimeUrl;
+  // An old module's catalog cannot describe the newly selected runtime, even
+  // for the same saved recipe. Hide its cache during the first changed render.
+  const capabilitiesByKey = cache.runtimeUrl === runtimeUrl ? cache.entries : EMPTY_CAPABILITIES;
+  (0, _react.useEffect)(() => {
+    setCapabilities(previous => previous.runtimeUrl === runtimeUrl ? previous : {
+      runtimeUrl,
+      entries: EMPTY_CAPABILITIES
+    });
+  }, [runtimeUrl]);
+  const reportCapabilities = (0, _react.useCallback)(next => {
+    // A disposed renderer can finish preparing after its runtime was replaced.
+    if (activeRuntime.current !== runtimeUrl) return;
+    setCapabilities(previous => {
+      if (activeRuntime.current !== runtimeUrl) return previous;
+      const prior = previous.runtimeUrl === runtimeUrl ? previous.entries : EMPTY_CAPABILITIES;
+      const known = prior.get(next.key);
+      if (known && sameRecord(known.available, next.available) && sameRecord(known.selected, next.selected)) return previous;
+      const entries = new Map(prior);
+      entries.delete(next.key);
+      entries.set(next.key, next);
+      if (entries.size > 64) entries.delete(entries.keys().next().value);
+      return {
+        runtimeUrl,
+        entries
+      };
+    });
+  }, [runtimeUrl]);
+  const value = (0, _react.useMemo)(() => ({
+    runtimeUrl,
+    capabilitiesByKey,
+    reportCapabilities
+  }), [runtimeUrl, capabilitiesByKey, reportCapabilities]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_context.CharacterRuntimeContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+//# sourceMappingURL=AgentAvatarProvider.js.map

package/lib/commonjs/agent-avatar/AgentAvatarProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_context","_jsxRuntime","EMPTY_CAPABILITIES","Map","sameRecord","left","right","keys","Object","length","every","key","AgentAvatarProvider","runtimeUrl","children","cache","setCapabilities","useState","entries","activeRuntime","useRef","current","capabilitiesByKey","useEffect","previous","reportCapabilities","useCallback","next","prior","known","get","available","selected","delete","set","size","value","useMemo","jsx","CharacterRuntimeContext","Provider"],"sourceRoot":"../../../src","sources":["agent-avatar/AgentAvatarProvider.tsx"],"mappings":"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","ignoreList":[]}