js_widget_runtime 0.4.60

Run JavaScript widgets as Flutter widgets using QuickJS (VM) or Web Workers (web).

0.4.60

• Automated patch bump.

0.4.59

• Automated patch bump.

0.4.58

• Automated patch bump.

0.4.57

• Automated patch bump.

0.4.56

• Automated patch bump.

0.4.55

• Automated patch bump.

0.4.54

• Automated patch bump.

0.4.53

• Automated patch bump.

0.4.52

• Automated patch bump.

0.4.51

• Automated patch bump.

0.4.50

• Automated patch bump.

0.4.49

• Automated patch bump.

0.4.48

• Automated patch bump.

0.4.47

• Automated patch bump.

0.4.46

• Automated patch bump.

0.4.45

• 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)

0.4.44

• 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

0.4.43

0.4.42

• 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.

0.4.40

• Automated patch bump.

0.4.39

• Automated patch bump.

0.4.38

• Automated patch bump.

0.4.37

• Automated patch bump.

0.4.36

• Automated patch bump.

0.4.35

• 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.

0.4.34

• 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.

0.4.33

• 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.

0.4.32

• 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.

0.4.31

• Automated patch bump.

0.4.30

• Automated patch bump.

0.4.29

• Automated patch bump.

0.4.28

• Automated patch bump.

0.4.27

• Automated patch bump.

0.4.26

• Automated patch bump.

Unreleased

• 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.

0.4.25

• Automated patch bump.

0.4.24

• 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.

0.4.23

• 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.

0.4.22

• 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).

0.4.21

• 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.

0.4.20

• 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).

0.4.19

• Automated patch bump.

0.4.18

• Automated patch bump.

0.4.17

• Automated patch bump.

0.4.16

• Automated patch bump.

0.4.15

• Automated patch bump.

0.4.14

• Automated patch bump.

0.4.13

• 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.

0.4.12

• 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.

0.4.11

• 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.

0.4.10

• 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.

0.4.9

• 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.

0.4.8

• 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.

0.4.7

• 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.

0.4.6

• 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.

0.4.5

• 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.

0.4.4

• Automated patch bump.

0.4.3

• 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.

0.4.2

• 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).

0.4.1

• 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.

0.4.0

• 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.

0.3.2

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

0.3.1

• Automated patch bump.

0.3.0

• 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.

0.2.0

• 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).

0.1.1

• Automated patch bump.

0.1.0

• 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.

0.0.7

• Automated patch bump.

0.0.6

• Automated patch bump.

0.0.5

• Automated patch bump.

0.0.4

• Automated patch bump.

0.0.3

• Automated patch bump.

0.0.2

• Automated patch bump.

Changelog

0.0.1

• 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.