• New jsr.capture(opts?) — widgets can photograph their own rendered tree from inside their JS ({name} option names the file). Core bridge channel, host-dependent: the jsr_widget CLI implements it — --capture-dir <dir> writes the PNGs and the --json report lists them under captures[], so agent-authored widgets self-screenshot at the exact moment of their logic mid-event. Hosts without a handler reject the promise (graceful degradation). Fire-and-forget channel: a slow/unavailable capture can never stall the message queue.

• Automated patch bump.

0.4.127 #

• Automated patch bump.

• New voxel renderer node: a chunked voxel world rendered by a pure-Dart software pipeline on CustomPaint (no native deps, no new packages). Widget JS pushes per-chunk vertex buffers with jsr.hostCall('voxel.mesh', {id, key, origin, positions, colors, indices}) — plain arrays, rebuilt only on edit — and steers the camera with jsr.hostCall('voxel.camera', {id, position, yaw, pitch, light, skyColor}). voxel.attach probes support (older runtimes reject, so widgets degrade gracefully). The world state is bridge-owned (core capability): voxel.* host calls are intercepted before the host handler and feed the renderer's voxel nodes. Example: example/widgets/voxel-sandbox/.

• New jsr_widget CLI for headless widget verification by agents and humans: dart run bin/jsr_widget.dart test <widget-dir> runs the widget's real JavaScript on the QuickJS backend with NO rendering — dispatch events (--event, repeatable), seed storage, inject fetchJson fixtures, assert the final jsr.exportState (deep-subset match) and console output; --json prints a machine report and the exit code is 0/1. ... screenshot <widget-dir> pumps the rendered tree through the production renderer and writes a PNG (width/height/ scale/theme, --freeze-clock for determinism). Works from any project depending on the package; the QuickJS native library is auto-discovered from the pub cache when JSR_QUICKJS_LIB is unset. Documented in the authoring skill section 8.3.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Maintenance release: the in-repo agent memory store is refreshed (fa_widgets pins-only publish contract, flutter_agent coordination notes, live state-sync protocol references). No API or renderer changes — 0.4.121 remains the last functional release.

• video node: new onError: '<actionId>' prop — host playback failures (controller init, network, codec) arrive as {value: message} instead of a silent black box. Backed by the optional JsMediaController.errorStream (default null — existing hosts stay source-compatible); the reference video_player host publishes errorDescription + init failures, the web host the element error event. A synchronously throwing createVideoController no longer crashes the build — it fires onError.
• WidgetManifest.fromStorage parses tolerantly: a wrong-typed legacy field (e.g. a localization map under name) degrades that field to its fallback instead of discarding the whole manifest. Additive i18n keys (nameI18n/descriptionI18n) parse without loss — compat tests lock the host-side i18n schema contract.
• video-player example widget (1.0.7) wires onError to an inline error banner and exports videoError for headless tests/CLI.

• path node: JsPathPainter supports pure vertical/horizontal strokes with zero-width bounds (previously rendered nothing).

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• New declarative shape nodes from the Motion-Canvas port (yoclip#1): rect ({width, height, radius?, fill, stroke?, strokeWidth?, opacity?}), circle ({size, fill, stroke?, strokeWidth?, opacity?}), line ({x1, y1, x2, y2, stroke, strokeWidth? (default 2), opacity?}) and polygon ({points, fill, stroke?, strokeWidth?, opacity?} — points is a FLAT [x1, y1, x2, y2, ...] array). rect/circle size to their box with inside strokes; line/polygon size to the tight geometry bounds plus stroke inset. Pure CustomPaint — no web-view or SVG parsing.

• New jsr.motion builtins for declarative, Motion-Canvas-style animation (agreed with the yoclip port, IstiN/yoclip#1): tween(ms, startMs, durMs, from, to, easing?) — eased scalar clamped to from/to outside its window so results drop straight into the tree; mapRange(v, inMin, inMax, outMin, outMax, easing?) with clamped input; clamp(v, min, max); and wave(ms, periodMs, amplitude, phase?) — a zero-centered sine for beat-synced motion. All times are elapsed milliseconds; easing? accepts a function or a jsr.ease name string (default linear).
• Extended jsr.ease: new curves easeInOutCubic, easeInOutQuart, easeOutExpo, plus canonical-name aliases easeOutBack/easeOutBounce/ easeOutElastic (the original short names stay), and cubicBezier(x1, y1, x2, y2) — a factory for arbitrary CSS-style timing curves (Newton-Raphson solve with a bisection fallback, overshoot-safe).

• Automated patch bump.

• video node: fit now actually maps the picture when the parent reserved a fixed box (aspectRatio/sizedBox w+h/stack → tight constraints). Previously the surface was always wrapped in a natural-aspect AspectRatio, so contain/cover/fill rendered identically (everything letterboxed) and fit buttons looked dead. Loose parents (column/row children) keep the natural-shape behavior.
• video node: real fullscreen — the transport controls gain a fullscreen button (hidden with fullscreenButton: false) that pushes an in-app fullscreen route reusing the SAME media controller, so playback continues seamlessly and position/volume survive the round trip.

• text nodes honor width/height: the text box gets exactly that size, so textAlign: 'center' centers across the requested box instead of the intrinsic label width, at any nesting depth (CSS-style box semantics).
• column/row/stack/wrap nodes honor width/height (SizedBox cap, same loose-constraint semantics as container): siblings center across the requested span instead of the parent's full width. Reported via the yoclip deck renderer, where scenes place width + textAlign: 'center' on captions nested in columns.

• Fix compilation on Flutter 3.47+ stable: the flame_3d-backed GLB/glTF host now uses vendored flame_3d sources (lib/src/flame_3d_vendor, see VENDOR.md) carrying the flutter_gpu API fix (flame-engine/flame#3995 backport) instead of hosted flame_3d: ^0.3.0, which no longer compiles against the Flutter 3.47 flutter_gpu API. No public API changes; createJs3dHost, createFlame3dHost, and the shader assets keep working unchanged.
• Requires Flutter 3.47+ now (environment.flutter >=3.47.0); CI moved from the 3.44.4 pin to 3.47.1 and the flame-3.47 branch/automerge workflow are retired.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• fix(web): declare __IID before the shared bootstrap in the web worker script — the 0.4.75 iid tagging made __tag reference __IID unconditionally, but the web worker never declared it, so every widget message threw ReferenceError: __IID is not defined and JS widgets on the web client hung on the loading spinner (engine loaded, renderer built, first render never arrived).

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• fix(engine): cross-engine message routing on macOS JSC — flutter_js registers the native sendMessage callback as a STATIC, so every new runtime overwrites it and ALL live JS contexts dispatch through the LAST runtime's channel map. With several engines alive (a board with multiple widgets), one widget's fetch/render messages were delivered to a neighbour widget — e.g. the weather widget stayed on its loading spinner forever while its data rendered inside another widget (deterministic two-engine repro test included). The bootstrap now tags every message payload with the engine iid; a Dart-side router (installed into every live channel map) delivers each message to its owning engine and strips the tag before handlers run. QuickJS backend (per-engine native routing) only unwraps raw-id channels.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• fix(engine): SIGSEGV on widget dispose — native runtime release moved from scheduleMicrotask (same event-loop turn) to Future.delayed(Duration.zero) (next turn), with a final executePendingJob() drain before the release. flutter_js resolves promise bridges via microtasks (future.then → evaluate), so a microtask-scheduled release could free the JSContextGroup while a sibling microtask was still about to evaluate into it, crashing in JSValueToStringCopy with a dead JSC::VM. Applies to both dispose() and the old-runtime release path in run().

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Perf: micro-optimizations in JS bootstrap:
  • Monotonic counter for IDs instead of Math.random()+Date.now()
  • Reusable argument joiner for console.log (avoids Array.slice alloc)
  • setTimeout uses one-shot Timer instead of periodic
  • Manual JSON string building for timer/RAF messages (avoids JSON.stringify)

• Fix JS widget cross-engine leaks on macOS/JSC:
  • callEvent is now synchronous (skips __jsr_event_done round-trip)
  • Render trees tagged with __iid, routed to correct panel
  • requestAnimationFrame tagged with __iid for game loop routing
  • _isLive guard + try/catch on callEvent to prevent SIGSEGV on disposed runtime

• Fix callEvent deadlock: _handleEventDone was nulling _eventCompleter before _runEvent could complete it. On macOS (merged thread), JSC bridge callback fires DURING rt.evaluate() inside send(). Nulling the completer meant _runEvent's await never completed.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Fix SIGSEGV: defer old runtime release until AFTER new runtime init completes (was releasing during init via scheduleMicrotask, which ran between evaluate() calls and freed the old JSContextGroup out from under in-flight native callbacks).
• Reduce callEvent timeout from 30s to 5s — a single stuck event was blocking ALL widget interactions for 30 seconds.

• Fix dispose: use scheduleMicrotask instead of Future.delayed(Duration.zero) to avoid event-loop ordering issues that caused widgets to get stuck in loading state.

• Fix SIGSEGV: defer native JSContextGroup release to the next event-loop turn. During run() → dispose() → evaluate(), the current stack may still be inside executePendingJob() which holds native JSC callbacks. Releasing the context synchronously freed the JSContextGroup out from under those in-flight callbacks → crash in JSValueToStringCopy.

• Fix 3D host-flip: remember per-sceneId host selection so controllers recreated after a callEvent timeout route to the same host (Flame3dHost stays Flame3dHost) even when the renderer-side config lacks engine/src.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• feat(renderer): audio_player node — frame-driven declarative audio for JS scenes. Per-frame playing/volume/loop props and seekToMs change-seeks are reconciled against a host JsAudioController; JsMediaController gained concrete no-op setVolume/setLoop defaults, so existing hosts stay source-compatible. Zero-size widget, host-less renders are safe no-ops.

• fix(3d): flame_3d model rotation applied yaw as pitch and vice versa — Quaternion.euler(yaw, pitch, roll) takes yaw first, but the conversion passed pitch. A rotation: [0, 180, 0] model entry flipped the model nose-over-tail (wheels up) instead of turning it around; small yaw values (the only kind used before) looked like a slight lean.

• Automated patch bump.

• feat(3d): unlit: true on declarative scene3d model entries — swaps the loaded GLB's SpatialMaterial for an UnlitMaterial with the same albedo, so flat brand marks (logos, UI panels) render at their exact colors instead of being dimmed by the scene light rig.

• feat(3d): jsrSetFlameAssetBundle — replace Flame's global asset bundle (both Flame.bundle and the eagerly created Flame.assets cache) so host apps rendering projects from arbitrary directories (YoClip Studio) can serve GLB/OBJ model files that are not in the app's own bundle.

• fix(3d): anti-aliased headless GLB capture — the flame_3d offscreen painter now renders the world into a 2x render target and downscales it into the widget rect with FilterQuality.high (SSAA); 1x output — and a point-sampled downscale — had visibly jagged edges on hard GLB silhouettes (extruded logos, low-poly models).

• fix(3d): the 3D host dispatcher reference-counts shared controllers — when a scene3d node unmounts and remounts within the same frame (per-frame scene rebuilds in video pipelines), the new State's initState runs before the old State's dispose; previously the late dispose killed the controller the new State had just acquired, leaving the scene permanently empty for the rest of the export.

• fix(3d): headless capture mounts the game tree manually and renders the world's children directly — an unmounted FlameGame renders and updates nothing (frozen skeletal animations, unregistered lights, invisible scenes), and a vanilla world renderTree never reached Object3D children in offscreen capture (empty GPU pass).
• fix(3d): teardown races — disposed-controller guards and a MediaQuery-free World3D (pixel ratio explicit) so final-frame capture can't crash.
• feat(3d): headless GLB rendering for the flame_3d host — offscreen capture path renders the scene into a GPU render target and composites it into any canvas (video export / board snapshots), replacing the old headless placeholder. Requires Impeller + Flutter GPU enabled by the embedder.
• feat(3d): declarative scene3d configs — models: [{modelId, src, position, rotation, scale, animation}] + camera + time applied idempotently on every rebuild (diff-only), so video pipelines that re-render the node tree per frame can drive GLB scenes frame-accurately.
• feat(3d): Js3dCaptureSync pending-work tracker lets headless renderers wait for GPU init / model loads before capturing a frame.
• fix(3d): transparent scene background (Flame's opaque black default no longer covers layers composited behind the 3D scene).
• fix(3d): no more build→apply→notify→rebuild loop when declarative configs are applied on every widget rebuild; disposed-controller release guard; idempotent controller dispose (unmount/remount + final tree teardown).

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• The image node now sends a browser-ish User-Agent for network URLs: dart:io's default Dart/x.y (dart:io) UA is rejected by popular CDNs (Wikimedia answers HTTP 400), which made every remote image render as a broken-image icon.

• Fix dead button/iconButton taps: _buttonActionId ignored the documented onPressed prop (SKILL.md and every bundled demo use it) and fired the _tap fallback instead, so JS handlers keyed by action id never matched. onPressed now takes priority, onTap stays supported.

• Chore: split json_widget_renderer.dart (~1900 lines) into part files under lib/src/renderer/nodes/ (js_layout_nodes.dart, js_text_nodes.dart, js_input_nodes.dart) via private extensions, so every source file is back under the 1500-line PR gate. Pure refactor — no behavior or public API changes.

• Add a pure-Dart software 3D pipeline to the scene3d node: when the node carries a meshes prop it renders on CustomPaint — perspective-projected triangles, painter's z-sort, flat Lambert shading — with zero native dependencies and no Js3dHost required. Props: meshes ({vertices, faces, color}), camera (position, target, fov), rotation (x/y/z static transform; JS animates by re-rendering on raf/timer), light.direction, background, and onTap (fires with {x, y} local coordinates). Nodes without meshes keep routing to the host-provided Js3dHost engine. Malformed meshes/vertices/faces are skipped, never fatal. See docs/3d-spike.md for the flutter_gl evaluation and poly-budget guidance.

• Add 3D scene support via the new scene3d renderer node and jsr.scene3d.* JS API. The runtime provides a Js3dHost abstraction so host apps can plug in any engine (Flame 3D, three_dart, flutter_3d_controller, etc.).
• Supported JS commands: create, destroy, addModel, removeModel, setTransform, playAnimation, stopAnimation, setCamera, setLight.
• The node accepts id, width, height, camera, lights and renders a placeholder when no Js3dHost is registered.
• Add a 3d-viewer example widget using flutter_3d_controller to load and display GLB models.
• Add bridge and renderer tests for scene lifecycle and command forwarding.

• Add a textArea node to the JSON renderer: a multiline text input built on the same field machinery as textField. Props: value / initialValue, hint, minLines (default 3), maxLines (default 8, clamped to at least minLines; the field grows to maxLines then scrolls internally), onChange (fires per keystroke with {value}, exactly like textField), and an optional onSubmit (shows a done keyboard action and fires with {value}; without it Enter inserts a newline). storageKey / id / name register the live value with the field registry. The tree normalizer aliases textarea / TextArea and applies the same prop aliases (placeholder, value, onChanged) as textField.
• Make listView / gridView scrolling configurable. Both accept shrinkWrap (bool, default true) and physics ('never' / 'always' / 'platform'). Defaults: listView is always scrollable; gridView keeps its previous shrinkWrap: true + non-scrollable behavior for backwards compatibility. Previously gridView was hardcoded to shrinkWrap: true + NeverScrollableScrollPhysics. Follows the renderer's input tolerance: shrinkWrap accepts 'true'/'false' strings and numbers, unknown physics values fall back to the defaults.

• Fix and extend the chart node. It now reads its values from the documented data prop (points remains as a backwards-compatible alias), so apps passing data no longer render an empty box. New props: fillColor (hex with alpha allowed, e.g. #22c55e33; falls back to the line color at ~20% alpha), strokeWidth (default 2), and chartType — 'line' (default, the existing sparkline) or 'bar' (equal-width bars with rounded tops and a baseline). Follows the renderer's input tolerance: unknown chartType falls back to 'line', non-numeric data entries are skipped, empty data renders nothing.

• Add transition animation nodes to the JSON renderer. entrance plays a one-shot mount animation (animation: fade, slideUp, slideDown, slideLeft, slideRight, scale, fadeScale; delay ms for staggered list entrances, duration, curve) — implemented over TweenAnimationBuilder with an Interval curve, so no timers are ever scheduled. animatedSwitcher wraps Flutter's AnimatedSwitcher: when switchKey changes between renders the old child animates out and the new one in (animation: fade, slideLeft, slideRight, slideUp, scale, fadeScale), keyed via ValueKey(switchKey). Both follow the renderer's input tolerance: unknown variants fall back to fade, numeric strings parse, garbage never crashes. The curve parser is now shared as jsCurve in js_node_helpers.dart.

• Add a map node to the JSON renderer, built on flutter_map + latlong2 with OpenStreetMap tiles (no API key). Props: center {lat, lng}, zoom, markers [{id, lat, lng, label?, color?}], polylines [{points, color?, width?}], and fitBounds (true to fit all markers/polylines, or an explicit [[lat, lng], [lat, lng]] corner list). Events route through the standard bridge: onTap fires with {lat, lng} and onMarkerTap with {id}. JsonWidgetRenderer.mapTileProvider lets hosts/tests inject a custom TileProvider so tile loading never has to hit the network.

• Automated patch bump.

• Renderer no longer crashes on malformed numeric props from generated widgets: jsDouble/jsDoubleOrNull now parse numeric strings, take the first numeric element of a list, and fall back instead of throwing a cast error (e.g. borderRadius: [14, 14, 0, 0] previously killed the whole render tree). borderRadius in decorations, cards, inkWell and clipRRect also accepts CSS-style corner lists ([all], [tl-br, tr-bl], [tl, tr-bl, br], [tl, tr, br, bl]) via the new jsBorderRadius.

• Fix web compilation of JsWidgetEngine: _defaultBackend referenced FlutterJsWidgetEngineBackend unconditionally, but the conditional import resolves to the Web Worker backend on the web, so any web build importing the wrapper failed with "Method not found: 'FlutterJsWidgetEngineBackend'". The platform pick now lives in a factory behind its own conditional import (js_widget_engine_default.dart / js_widget_engine_default_web.dart).

• Fix JsWidgetBridge.callEvent for rapid-fire gestures: concurrent events (tap-down / tap-up / tap) raced on a single completer, so a stale __jsr_event_done completed the next event early and the following callEvent crashed with "Future already completed", permanently wedging event delivery (dead buttons in gesture-heavy widgets). Events are now serialized through an internal queue, and __jsr_event_done handling is take-and-null so stray/duplicate dones are ignored.

• Add pluggable JS engine backend:
  • New JsWidgetEngineBackend interface.
  • JsRuntimeConfig.backend lets hosts use a custom engine (e.g. QuickJS FFI).
  • Default backends remain flutter_js on VM and Web Worker on web.
• Add host-provided media support for video/audio nodes:
  • JsMediaHost, JsVideoController, JsAudioController interfaces.
  • JsonWidgetRenderer.mediaHost wires real players while the core package stays free of heavy native media dependencies.
• Add ExternalAssetResolver and JsonWidgetRenderer.externalAssetResolver for external:<id> image sources.
• Add dynamic font loading via JsFontResolver, JsFontLoader, and the fontFamily text style prop.

• Export UiViewTreeNormalizer from the public API so hosts can reuse the same React/HTML-style node-name aliases.

• Automated patch bump.

• Add path node for SVG path stroking with optional progress animation.
• Add absoluteFill node (alias fill) for expanded background fills.
• Add stack.fit support (expand / loose).
• Add universal effect props (offsetX/offsetY, scale, rotation, opacity, blur) on any node.
• Text improvements:
  • style.gradient renders text with a gradient via ShaderMask.
  • style.fontStyle: 'italic' supported in addition to italic: true.
  • style.lineHeight aliases style.height.
• Image improvements:
  • asset: and file: source prefixes.
  • Optional imageResolver callback for custom image providers.
• Add customBuilders map for host-defined node types.
• Add video and audio placeholder nodes.

• Add jsr.ease.* easing helpers (linear, easeIn, easeOut, easeInOut, bounce, elastic, backIn, backOut).
• Add renderer effects from YoClip:
  • Radial gradients (gradient.type: 'radial').
  • Box shadows (decoration.shadows).
  • Blur node and blur property on containers.
  • clip: true on rounded containers.
  • Static 3D transforms (rotateX, rotateY, perspective) on containers.
  • Text shadows and textTransform (uppercase/lowercase).

• Automated patch bump.

• BREAKING CHANGE: Rename global JS object and channels from yoloit to jsr.
  • All widgets must use jsr.render(), jsr.onEvent(), jsr.fetchJson(), etc.
  • All internal bridge channels are now prefixed with __jsr_ instead of __yoloit_.
• Add JsRuntimeConfig.hostBootstrapJs so hosts can inject host-specific APIs (e.g., jsr.yoloit = {...}) without polluting the core runtime.
• Update example widgets and documentation to use the new jsr API.
• Add AGENTS.md, CLAUDE.md, and agent skills for widget authoring and engine maintenance.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

• Automated patch bump.

Changelog #

• Initial release.
• JavaScript widget runtime for Flutter (VM via flutter_js, web via Web Workers).
• JSON-to-Flutter renderer (JsonWidgetRenderer) with layout, input, list, image, chart and animation nodes.
• Widget manifest loader (WidgetManifest, WidgetFileReader, AssetWidgetFileReader).
• Bridge APIs: render, fetchJson, exec, storage, secrets, timers and requestAnimationFrame.