@glissade/scene 0.38.0-pre.0 → 0.38.0

package/README.md

@@ -1,6 +1,22 @@
 # @glissade/scene
 
-The scene graph and the **DisplayList IR**: nodes (Group, Rect, Circle, Path, Text, Image, Video) whose every animatable property is a signal, `createScene`, and the canonical `evaluate(scene, timeline, t) → DisplayList`. Text layout (explicit fonts, Intl.Segmenter line breaking) is deterministic across browser and headless render. Yoga flexbox lives behind the LayoutEngine seam at the separate `@glissade/scene/layout` entry — the base path never pays for wasm — including `width/height: 'auto'` content sizing and `computedSize()`. Other tree-shaken subpaths carry `splitText` (`./type`), `Grid` (`./grid`), motion-path drivers (`./motion`), the SVG `d` parser (`./path`), and `Chart()` + serializable scales (`./chart`).
+The scene graph and the **DisplayList IR**: nodes (Group, Rect, Circle, Path, Text, Image, Video) whose every animatable property is a signal, `createScene`, and the canonical `evaluate(scene, timeline, t) → DisplayList`. Text layout (explicit fonts, Intl.Segmenter line breaking) is deterministic across browser and headless render. Yoga flexbox lives behind the LayoutEngine seam at the separate `@glissade/scene/layout` entry — the base path never pays for wasm — including `width/height: 'auto'` content sizing and `computedSize()`. Other tree-shaken subpaths carry `splitText` (`./type`), `Grid` (`./grid`), motion-path drivers (`./motion`), the SVG `d` parser (`./path`), `Chart()` + serializable scales (`./chart`), `Gauge()`/`Meter()` radial gauges (`./gauge`), and `defineComponent()` (`./component`).
+
+## Radial gauges — `Gauge()` / `Meter()`
+
+Radial data-viz on the tree-shakeable `@glissade/scene/gauge` subpath (off the base embed) — a pure build-time fan-out like `Chart()`: a spec → N stroked-arc **zones** + boundary **ticks** + a **needle** + separate **labels**, returning a `Group`.
+
+```ts
+import { Gauge } from '@glissade/scene/gauge';
+const g = Gauge({ id: 'trust', radius: 120, gap: 2.5, zones: [
+  { extent: [-90, -30], color: '#e6a700', label: 'BLIND' },
+  { extent: [-30,  30], color: '#3ddc97', label: 'CALIBRATED' },
+  { extent: [ 30,  90], color: '#ff5d73', label: 'RAGE' } ]});
+// authored needle: tl.to(g.targets('needle','rotation'), -70, { from: 0 })  // deg, 0 = up, + = clockwise
+// or value→angle:  Meter({ id, radius, zones, value: () => sig(), domain: [0, 100] })
+```
+
+Every part is an addressable sub-id (`needle`, `zone-{i}`, `tick-{i}`, `label-{i}`, `glow`) via `g.targets(sub, prop)`; **labels draw z-above the zones**, so a zone can dim without crushing its label. `apexEmphasis` (portrait-safe) and per-zone `labelStyle` override the label defaults. Full guide: [docs/gauges.md](https://github.com/tyevco/glissade/blob/main/docs/gauges.md).
 
 ```sh
 npm i @glissade/scene @glissade/core

package/dist/describe.js

@@ -23,7 +23,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.38.0-pre.0";
+const RAW_VERSION = "0.38.0";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /** Arity of a value type's numeric repr: vec2/vec2-arc → 2, number → 1; others (color/paint/path/string/boolean) carry no scalar arity. */
 function arityOf(type) {
@@ -439,7 +439,7 @@ const HELPERS = [
 		name: "Gauge",
 		summary: "Build-time radial gauge (data-viz, like Chart): a spec → N categorical stroked-arc zones + boundary ticks + a needle + separate labels, returning a Group. Angle deg: 0=up, +=clockwise. Needle takes AUTHORED keys (tl on targets(\"needle\",\"rotation\")) OR value→angle (Meter mode). Zones/ticks/needle/labels are each addressable sub-ids (zone-{i}, tick-{i}, needle, label-{i}, glow); labels draw z-above zones so a zone dim never crushes a label. Tree-shaken off the base scene index.",
 		import: "@glissade/scene/gauge",
-		usage: "Gauge({ id, radius, zones: { extent: [start,end], color, label?, labelStyle?: { family?, size?, fill?, weight? } }[], thickness?, gap?, needle?, needleAngle?, value?, domain?, sweep?, ticks?, apexEmphasis?: boolean | number, glow?, position? }): { node: Group, id, childId(sub?), targets(sub, prop): string[] }"
+		usage: "Gauge({ id, radius, zones: { extent: [start,end], color, label?, labelStyle?: { family?, size?, fill?, weight? } }[], thickness?, gap?, needle?, needleAngle?, value?, domain?, sweep?, ticks?, apexEmphasis?: boolean | number, glow?: boolean | { color?, radius?, blur? }, position? }): { node: Group, id, childId(sub?), targets(sub, prop): string[] }"
 	},
 	{
 		name: "Meter",

package/dist/gauge.d.ts

@@ -70,10 +70,15 @@ interface GaugeSpec {
    * your own `isPortrait(size)`.
    */
   apexEmphasis?: boolean | number;
-  /** add a center glow Circle (`glow` sub-id, opacity 0 — author animates it). */
+  /**
+   * add a center glow Circle (`glow` sub-id, opacity 0 — author animates it).
+   * By default it's a HARD-edged disc; pass `{ blur }` for a soft falloff (a
+   * Gaussian blur filter, stdDeviation px) so it reads as a real center-glow.
+   */
   glow?: boolean | {
     color?: string;
     radius?: number;
+    blur?: number;
   };
   /** where to place the gauge center in the parent (default the parent origin). */
   position?: readonly [number, number];

package/dist/gauge.js

@@ -74,7 +74,11 @@ function Gauge(spec) {
 			id: cid("glow"),
 			radius: g.radius ?? radius * .5,
 			fill: g.color ?? "#ffffff",
-			opacity: 0
+			opacity: 0,
+			...g.blur !== void 0 && g.blur > 0 ? { filters: [{
+				kind: "blur",
+				radius: g.blur
+			}] } : {}
 		}));
 	}
 	spec.zones.forEach((z, i) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.38.0-pre.0",
+  "version": "0.38.0",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -77,7 +77,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.38.0-pre.0"
+    "@glissade/core": "0.38.0"
   },
   "repository": {
     "type": "git",