@vscada/core 0.0.1

package/dist/custom-elements.json

@@ -0,0 +1,1068 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/scada-view.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "inferAnimationPriority",
+          "return": {
+            "type": {
+              "text": "AnimationPriority"
+            }
+          },
+          "parameters": [
+            {
+              "name": "handleKey",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Story 4.3 Task 2 — infers each animation handle's LOD-cap priority\ntier from its OWN synthetic handle-map key, which every primitive that\nregisters an `AnimationHandle` already names systematically (never a\nreal tag): `recipe.ts`'s `__vessel-wave-animation-${id}`,\n`rotation-drive/base.ts`'s `__rotating-animations-${id}`, and\n`conveyance/pipe`'s `nextId('pipe-flow-animation')`. Zero primitive-\npackage changes needed for this — `_registerHandles` is the one place\nevery primitive's `HandleMap` already funnels through.\n\nKnown limitation, not introduced by this story: `rotation-drive/base.ts`\nbundles a driven-equipment element's rotation AND its state-lamp blink\ninto ONE combined pause/resume handle (pre-existing architecture), so\nthat handle is tagged `'rotation'`, not `'state-lamp'` — under a very\ntight LOD cap, a running pump's blink could pause alongside its\nrotation.\n\nArchitecture code audit (2026-08-27, AD-5 finding P1-1) — the STANDALONE\n`indicator-lamp` primitive used to never register through\n`AnimationRegistry` at all (its blink was driven by direct\n`AnimationControl` calls inline in its own state handler), which meant a\nstale/disconnected scene could not freeze it either — the exact failure\nAD-5 exists to prevent. It now registers its blink as a proper\n`AnimationHandle` (`__indicator-lamp-animation-${id}`), tagged\n`'state-lamp'` here so it both respects freeze-on-stale AND keeps the\noriginally-intended \"state-lamps survive longest\" property deliberately,\nvia the rank-0 tier `ANIMATION_PRIORITY_RANK` already defined for it,\nrather than accidentally via non-registration.\n\nStory 3.8 — `vapor/base.ts`'s `__vapor-drift-animation-${id}` (plume and\nsteam-vent's shared billow-drift handle) is tagged `'wave'`, the same\ntier as the vessel liquid wave: both are ambient, lowest-priority-to-\nsurvive continuous motion under a tight LOD cap, never safety-critical.\nExported so this mapping is directly unit-testable without standing up a\nfull scene (mirrors every other primitive-package registration site's\nown doc comment above — no primitive-package code needed here either)."
+        },
+        {
+          "kind": "class",
+          "description": "Root element. Story 1.1 proved Lit + Shadow DOM wiring; Story 1.2 added\nthe `scene` validation pipeline (AD-8). This story wires the actual\nframe pipeline (AD-1): `values`/`setValues()` feed the store; the single\nper-instance scheduler reads it on each tick and writes through handles\n→ renderer. `TimeSource`/`Renderer` are constructor-injectable for\ntests (spec §8.4); real usage via `document.createElement`/markup uses\nthe live defaults.",
+          "name": "ScadaView",
+          "cssProperties": [
+            {
+              "description": "Keyboard focus ring color (§11), resolved from the active theme's `focusRing` token when declared.",
+              "name": "--vscada-focus-ring-color",
+              "default": "#2c7be5"
+            },
+            {
+              "description": "Keyboard focus ring width (§11).",
+              "name": "--vscada-focus-ring-width",
+              "default": "2px"
+            },
+            {
+              "description": "Keyboard focus ring offset (§11).",
+              "name": "--vscada-focus-ring-offset",
+              "default": "2px"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The root `<svg>` the whole scene renders into.",
+              "name": "canvas"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_scene",
+              "type": {
+                "text": "Scene | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_lastError",
+              "type": {
+                "text": "SceneErrorDetail | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingDevValidation",
+              "type": {
+                "text": "Promise<void> | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_sceneGeneration",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_renderer",
+              "type": {
+                "text": "Renderer"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "renderer"
+            },
+            {
+              "kind": "field",
+              "name": "_store",
+              "type": {
+                "text": "ValueStore"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ValueStore(timeSource, (detail) => this._dispatchValueWarning(detail))"
+            },
+            {
+              "kind": "field",
+              "name": "_scheduler",
+              "type": {
+                "text": "Scheduler"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Scheduler(timeSource, this._store, renderer, this._animations)"
+            },
+            {
+              "kind": "field",
+              "name": "_animations",
+              "type": {
+                "text": "AnimationRegistry"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new AnimationRegistry()"
+            },
+            {
+              "kind": "field",
+              "name": "_staticRepresentations",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new StaticRepresentationRegistry()",
+              "description": "Story 4.4 Task 1 — §11 reduced-motion's declared-static-swap registry, sibling to `_animations` but a distinct registration surface (see `StaticRepresentationRegistry`'s own doc)."
+            },
+            {
+              "kind": "field",
+              "name": "_reducedMotion",
+              "type": {
+                "text": "ReducedMotionController"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ReducedMotionController(this, this._staticRepresentations, matchMedia)"
+            },
+            {
+              "kind": "field",
+              "name": "_liveRegion",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LiveRegionController()",
+              "description": "Story 4.4 Task 3 — §11 ARIA live region; unsubscribed in `disconnectedCallback`."
+            },
+            {
+              "kind": "field",
+              "name": "_unsubscribeConditionTransition",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_builtElements",
+              "type": {
+                "text": "BuiltElement[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_builtDefs",
+              "type": {
+                "text": "SVGDefsElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_watermark",
+              "type": {
+                "text": "WatermarkOverlay | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_licenseVerdict",
+              "type": {
+                "text": "LicenseVerdict"
+              },
+              "privacy": "private",
+              "default": "{ status: 'unlicensed' }"
+            },
+            {
+              "kind": "field",
+              "name": "_needsStructureInsert",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_schedulerStarted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_unsubscribeLicense",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_interactive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "true",
+              "description": "Story 4.2 — §3.2 `interactive`: \"Whether elements emit click events.\" A cheap global toggle (AC3) checked at dispatch time, never a rebuild trigger."
+            },
+            {
+              "kind": "field",
+              "name": "_gestureArbiter",
+              "type": {
+                "text": "GestureArbiter"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "description": "Story 4.2 Task 2 — one arbiter per instance, surviving rebuilds, so a drag begun before a mid-gesture rebuild still resolves correctly via the same tracked pointerId."
+            },
+            {
+              "kind": "field",
+              "name": "_hitLayerGroup",
+              "type": {
+                "text": "SVGGElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_hitAreaEntries",
+              "type": {
+                "text": "{ rect: SVGRectElement; w: number; h: number; origin: { x: number; y: number } }[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Hit rects built THIS structure build, with enough info to recompute their box in place on a zoom change (Story 4.3 Task 1) — never rebuilt for a zoom-only change, only for a real structural rebuild."
+            },
+            {
+              "kind": "field",
+              "name": "_viewportState",
+              "type": {
+                "text": "ViewportStateController"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "description": "Story 4.3 Task 1 — AD-4 view state (zoom/pan), reset on scene reload, NOT scene data. Owns its own tween-drive subscription independent of `_scheduler`'s start/stop lifecycle."
+            },
+            {
+              "kind": "field",
+              "name": "_panZoomGestures",
+              "type": {
+                "text": "PanZoomGestureController"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_viewportGroup",
+              "type": {
+                "text": "SVGGElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The one root `<g>` every built element/hit-layer renders inside — translate+scale is the ONLY thing zoom/pan ever touches (AD-2: never re-render on zoom). Rebuilt fresh each structure build, re-stamped with the CURRENT transform immediately (a rebuild mid-gesture must not visually snap to identity)."
+            },
+            {
+              "kind": "field",
+              "name": "_lodActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Story 4.3 Task 2 — previous LOD resolution, fed back into `resolveLodActive` for its hysteresis band."
+            },
+            {
+              "kind": "field",
+              "name": "_listenersAttached",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_isIntersecting",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "true",
+              "description": "Story 4.3 Task 3 — off-screen (`IntersectionObserver`) / hidden-tab (`visibilitychange`) pause. Assumed visible until the observer's first callback."
+            },
+            {
+              "kind": "field",
+              "name": "_intersectionObserver",
+              "type": {
+                "text": "IntersectionObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_boundVisibilityChange",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_unsubscribeRenderStats",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Story 4.3 Task 4 — `render-stats` consumer, only subscribed while `debug` is on."
+            },
+            {
+              "kind": "field",
+              "name": "_groupViewState",
+              "type": {
+                "text": "GroupViewStateController | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Story 2.5 — view state (AD-4: collapse/expand), NOT scene data. Constructed lazily on first scene load, `reset()` on every subsequent one — never on a same-scene rebuild (e.g. a group toggle), which is what lets a toggle survive its own rebuild."
+            },
+            {
+              "kind": "field",
+              "name": "_flowInferenceCache",
+              "type": {
+                "text": "FlowInferenceCache | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Story 2.4 Task 2/3 — rebuilt fresh every structure build (tied to the currently-registered handles' lifecycle, unlike `_groupViewState` above)."
+            },
+            {
+              "kind": "field",
+              "name": "_flowStoppedSourceIds",
+              "privacy": "private",
+              "default": "new Set<string>()"
+            },
+            {
+              "kind": "field",
+              "name": "_flowClosedNodeIds",
+              "privacy": "private",
+              "default": "new Set<string>()"
+            },
+            {
+              "kind": "field",
+              "name": "_flowTrackedElementIds",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Adversarial-review Fix 3 — ids that got a flow-state-tracking Fsm/handle registered this build, INCLUDING hidden children of a collapsed group (never in `_builtElements`, which only holds visually-built elements). Teardown needs this separately so a hidden source's tracking registration doesn't leak across rebuilds."
+            },
+            {
+              "kind": "field",
+              "name": "stalenessTimeout",
+              "type": {
+                "text": "number"
+              },
+              "description": "§3.2 — configuring the timeout is allowed; disabling the freeze behavior it drives is not (NFR4)."
+            },
+            {
+              "kind": "field",
+              "name": "snapThreshold",
+              "type": {
+                "text": "number"
+              },
+              "description": "Story 1.3 Task 4 — the tween-vs-snap `|Δ|` cap, as a component-level option (sensible default, see `DEFAULT_SNAP_THRESHOLD`)."
+            },
+            {
+              "kind": "field",
+              "name": "connectionState",
+              "type": {
+                "text": "ConnectionState"
+              },
+              "description": "§3.2 — parent-supplied upstream health. `'disconnected'` freezes the entire scene (§4.4) regardless of individual timestamps."
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "SchedulerMode"
+              },
+              "description": "§3.2 `mode` (Story 4.1, §8.3 \"one code path\") — delegates entirely to\n`Scheduler.mode`, which owns the live↔static transition (snap-then-stop\n/ restart). Static mode is what makes `setValues()` below apply a\nsynchronous write pass instead of starting the rAF loop (AC1)."
+            },
+            {
+              "kind": "field",
+              "name": "animated",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "§3.2 `animate` (Story 4.1 AC1) — master switch for continuous animation,\northogonal to `mode` (§8.1: static mode keeps animations running by\ndefault; this is the explicit opt-out for true snapshot capture).\nExposed as `animated`, not `animate` — `Element.prototype.animate()`\n(the native Web Animations API method every `HTMLElement` already has)\nwould otherwise collide with a same-named boolean property, breaking\nthe class's assignability to `Element`/`CustomElementConstructor`."
+            },
+            {
+              "kind": "field",
+              "name": "reducedMotionActive",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Story 4.4 Task 1 — current `prefers-reduced-motion` state as last observed by the core-owned listener (§11). Read-only: the OS/browser preference, not a settable switch — `animated` remains the one property that toggles continuous motion directly.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "snapToTargets",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "AC4 — every in-flight tween and data interpolation completes to its target immediately (Story 4.1's static-mode switch depends on this). Story 4.3 — a mid-flight PROGRAMMATIC zoom tween (gesture-driven zoom is never mid-flight — it's already immediate) settles the same way."
+            },
+            {
+              "kind": "field",
+              "name": "interactive",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Story 4.2 AC3 — §3.2 `interactive`. Gates whether a tap/click ever dispatches `element-click` (checked at pointerup time); does not remove or rebuild the hit-area structure itself."
+            },
+            {
+              "kind": "field",
+              "name": "zoom",
+              "type": {
+                "text": "number"
+              },
+              "description": "Story 4.3 Task 1 — §3.2 `zoom`, two-way. A GESTURE update (pinch/\nwheel/drag-zoom) writes `_viewportState` directly and this getter\nreflects it immediately; an external `view.zoom = x` assignment\nanimates via the tween layer instead of jumping (`setZoomAnimated`).\nNever a structural rebuild (AD-2) — the root viewport `<g>` transform\nplus an in-place hit-area recompute (`_onViewportFrame`) are the ONLY\nthings a zoom change touches, superseding Story 4.2's rebuild-per-\nzoom-change behavior."
+            },
+            {
+              "kind": "field",
+              "name": "debug",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "§3.2 `debug` — gates 1Hz `render-stats` accounting entirely; subscribes/unsubscribes the event-dispatching consumer on toggle."
+            },
+            {
+              "kind": "method",
+              "name": "seekAll",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "timeMs",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Story 1.7 — the sanctioned deterministic-frame mechanism for visual\nregression: seeks every registered WAAPI animation (impeller\nrotation, flow dashes, lamp blink, …) to an absolute `currentTime`.\nDev/test utility — trivially small, never load-bearing for production\nrendering. If a screenshot still shows motion after this, something\nbypassed the animation registry (AD-5) and that's a real bug this\nmethod exists to catch, not a test to work around."
+            },
+            {
+              "kind": "method",
+              "name": "exportSVG",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "§3.3 `exportSVG` (Story 4.1 AC3) — works in ANY mode (live or static):\nserializes the current rendered `<svg>` to a standalone string. Returns\n`''` if no scene has been built yet (nothing to export)."
+            },
+            {
+              "kind": "field",
+              "name": "tagPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "Story 2.6 AC2 — every tag lookup is prefixed by this string (`ValueStore.tagPrefix`); changing it at runtime re-resolves and resets interpolation state for affected tags (see `Scheduler`'s own doc on `syncTagPrefixIfChanged`)."
+            },
+            {
+              "kind": "field",
+              "name": "scene",
+              "type": {
+                "text": "Scene | null"
+              },
+              "description": "§3.2 `scene` — the currently-loaded, validated scene, or `null` if none has been assigned yet or the last assignment failed structural validation (AD-8; see the setter below)."
+            },
+            {
+              "kind": "field",
+              "name": "pendingDevValidation",
+              "type": {
+                "text": "Promise<void> | null"
+              },
+              "description": "Awaitable in tests; resolves once dev-only Zod diagnostics for the current scene have run.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "values",
+              "type": {
+                "text": "TagValue[]"
+              },
+              "description": "Reconstructed from the store's current buffer — not a cached mirror of the last-pushed array (AD-4: no extra state)."
+            },
+            {
+              "kind": "method",
+              "name": "setValues",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "values",
+                  "type": {
+                    "text": "TagValue[]"
+                  }
+                }
+              ],
+              "description": "Imperative equivalent of setting `values` (§3.3). Story 4.1 AC1 — in\nstatic mode this is the \"single synchronous write pass, no rAF\" §8.3\ndescribes: `Scheduler.snapToTargets()` (already the sanctioned\nimmediate-write path, AC4) writes every registration's current value\nwith zero tween, with no rAF loop ever started. `_viewportState` is\ndeliberately untouched here (unlike the public `snapToTargets()`\nbelow) — a value push must not also snap an unrelated in-flight zoom/\npan gesture."
+            },
+            {
+              "kind": "method",
+              "name": "clearValues",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The only way values are cleared — never an empty `setValues([])` (§3.3, §4.2)."
+            },
+            {
+              "kind": "method",
+              "name": "_onLicenseVerdict",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "verdict",
+                  "type": {
+                    "text": "LicenseVerdict"
+                  }
+                }
+              ],
+              "description": "Story 6.3 — reacts to the module-level license verdict: toggles this instance's watermark and (once, page-wide) logs the trial notice."
+            },
+            {
+              "kind": "method",
+              "name": "_buildElements",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "scene",
+                  "type": {
+                    "text": "Scene"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_registerFlowStateTracking",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "SceneElement"
+                  }
+                }
+              ],
+              "description": "Story 2.4 Task 2/3 — drives `this._flowInferenceCache.update()` off an\nactual tag-value-driven state transition (never per tick — the cache's\nown doc requires \"on a source/valve FSM state-change event\"). The one\nevent-driven mechanism this codebase has for observing a value change\nIS a scheduler-registered handle's `write()` (exactly how\npump-centrifugal drives its own internal FSM); `FlowInferenceCache.update`\nis itself signature-guarded (a no-op unless the stopped/closed set\nactually changed), so calling it unconditionally here — rather than\ngating on `Fsm`'s own `changed` flag, which is `false` on a value's\nvery first resolution — is both safe and correct."
+            },
+            {
+              "kind": "method",
+              "name": "_toggleGroup",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "groupId",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Story 2.5 Task 3 — the `element-click`/`elementType:'group'` + `toggleGroup` wiring `group-view-state.ts` deferred to `<scada-view>`. A collapse-state change is a structure-once (AD-2) event exactly like a scene reload: full teardown + rebuild, just without resetting `_groupViewState` (only a genuinely new `scene` assignment does that)."
+            },
+            {
+              "kind": "method",
+              "name": "_handleConditionTransition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "elementId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "Condition"
+                  }
+                }
+              ],
+              "description": "Story 4.4 Task 3 — resolves elementId -> a `LiveRegionController`\nannouncement. `next` alone can't distinguish \"stale because THIS tag\ntimed out\" from \"stale because the whole scene disconnected\" (both\ncollapse into the same `Condition` by the time `Scheduler` reports\nthem, §4.3's `worstOf`) — read `connectionState` at the moment of the\ntransition to disambiguate, exactly as `Scheduler.onConditionTransition`'s\nown doc says the caller must."
+            },
+            {
+              "kind": "method",
+              "name": "_wrapHandlesForLiveRegion",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HandleMap"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "SceneElement"
+                  }
+                },
+                {
+                  "name": "handles",
+                  "type": {
+                    "text": "HandleMap"
+                  }
+                }
+              ],
+              "description": "Story 4.4 Task 3 — wraps every numeric handle whose tag has a declared\nthreshold with a thin band-transition check (`resolveAlarmBand`),\nannouncing only on an actual band CHANGE into a non-normal band (never\nevery write) before delegating to the primitive's own handle. The\nquantity word in the announcement (\"level\", \"needle\", …) is the tag's\nown binding `type` — the same vocabulary the scene author already\nchose, never a new naming scheme."
+            },
+            {
+              "kind": "method",
+              "name": "_registerHandles",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "elementId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "handles",
+                  "type": {
+                    "text": "HandleMap"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_teardownBuiltElements",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_maybeStartScheduler",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchValueWarning",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "ValueWarningDetail"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchElementClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "ElementClickDetail"
+                  }
+                }
+              ],
+              "description": "Story 4.2 Task 2 — §3.4 `element-click`."
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchElementHover",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "elementId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "tags",
+                  "type": {
+                    "text": "string[]"
+                  }
+                }
+              ],
+              "description": "Story 4.2 Task 2 — §3.4 `element-hover`; only ever called for a fine (mouse) pointer entering (AC2 — `attachElementInteraction`'s own gate)."
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchRenderStats",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "stats",
+                  "type": {
+                    "text": "RenderStats"
+                  }
+                }
+              ],
+              "description": "§3.4 `render-stats` (Story 4.3 Task 4) — only ever called while `debug` is on."
+            },
+            {
+              "kind": "method",
+              "name": "_onViewportFrame",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "transform",
+                  "type": {
+                    "text": "ViewportTransform"
+                  }
+                }
+              ],
+              "description": "Story 4.3 Task 1 — the ONE per-gesture-frame write path: stamps the\nviewport `<g>`'s transform, recomputes every hit-area's box in place\nfor the new zoom (no rebuild, AD-2), and re-evaluates the LOD\nthreshold. Called both from a live gesture (immediate) and from the\nexternal-set zoom tween's own per-tick callback."
+            },
+            {
+              "kind": "method",
+              "name": "_applyViewportTransform",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "transform",
+                  "type": {
+                    "text": "ViewportTransform"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_viewBoxScale",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "description": "Story 4.3 Task 1 — converts the SVG's live CSS-to-viewBox scale ratio\n(assumes uniform `xMidYMid meet` scaling — this component's own\n`render()` always sets `viewBox=\"0 0 canvasWidth canvasHeight\"` with\nno `preserveAspectRatio` override) so a gesture's CLIENT-space (CSS\npx) delta converts to the SAME viewBox-unit space `pan` lives in."
+            },
+            {
+              "kind": "method",
+              "name": "_toCanvasPoint",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{ x: number; y: number }"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "clientX",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "clientY",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Converts an absolute CLIENT-space point (pinch centroid / wheel cursor) into the viewBox-unit space `zoomAboutPoint`'s anchor expects."
+            },
+            {
+              "kind": "method",
+              "name": "_attachPanZoomListeners",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "svg",
+                  "type": {
+                    "text": "SVGSVGElement"
+                  }
+                }
+              ],
+              "description": "Story 4.3 Task 1 — attached ONCE (`firstUpdated`) on the root `<svg>`,\nnot per-element: Pointer Events bubble, so this observes every\ngesture including ones starting over an element's hit area (this\ncomponent has no drag-to-reposition affordance — any drag anywhere\npans the camera). `touch-action: none` (component styles) stops the\nbrowser's own native touch scroll/pinch from fighting this."
+            },
+            {
+              "kind": "method",
+              "name": "_syncVisibilityPause",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Story 4.3 Task 3 — off-screen (`IntersectionObserver`) OR hidden-tab\n(`document.hidden`) either one pauses; both must clear before\nresuming. Idempotent via `Scheduler`'s own `pauseForOffscreen`/\n`resumeFromOffscreen` guards, so calling this on every observer/\nvisibilitychange firing (even a redundant one) is safe."
+            }
+          ],
+          "events": [
+            {
+              "name": "element-click",
+              "type": {
+                "text": "CustomEvent<ElementClickDetail>"
+              },
+              "description": "A scene element's (or collapsed group's) hit area was activated by click/tap/keyboard, while `interactive` is true (§3.4)."
+            },
+            {
+              "name": "value-warning",
+              "type": {
+                "text": "CustomEvent<ValueWarningDetail>"
+              },
+              "description": "Dev-only: a pushed `TagValue` didn't map to any declared binding/state/threshold for its element."
+            },
+            {
+              "name": "element-hover",
+              "type": {
+                "text": "CustomEvent<ElementHoverDetail>"
+              },
+              "description": "A fine (mouse) pointer entered a scene element's hit area (§3.4)."
+            },
+            {
+              "name": "render-stats",
+              "type": {
+                "text": "CustomEvent<RenderStats>"
+              },
+              "description": "Once per second while `debug` is true: frame-timing/element-count accounting for perf diagnostics (§3.2 `debug`)."
+            },
+            {
+              "type": {
+                "text": "CustomEvent<SceneErrorDetail>"
+              },
+              "description": "A structurally invalid `scene` assignment (AD-8), or a dev-only Zod diagnostic on an otherwise-valid one. Structural failures render nothing until a valid scene is assigned.",
+              "name": "scene-error"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "license-key",
+              "type": {
+                "text": "string"
+              },
+              "description": "Plain-HTML-attribute fallback for `setLicenseKey()` (Story 6.2 Task 2). Module-level, not per-instance."
+            },
+            {
+              "name": "tag-prefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "Plain-HTML-attribute fallback for the `tagPrefix` property (Story 2.6 AC2)."
+            },
+            {
+              "name": "interactive",
+              "type": {
+                "text": "string"
+              },
+              "description": "Plain-HTML-attribute fallback for the `interactive` property. Any value other than the literal `\"false\"` means interactive."
+            },
+            {
+              "name": "mode",
+              "type": {
+                "text": "string"
+              },
+              "description": "Plain-HTML-attribute fallback for the `mode` property. `\"static\"` selects static mode; any other value (including absent) means live."
+            },
+            {
+              "name": "animated",
+              "type": {
+                "text": "string"
+              },
+              "description": "Plain-HTML-attribute fallback for the `animated` property. Any value other than the literal `\"false\"` means animated."
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "scada-view",
+          "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "tags",
+          "type": {
+            "text": "array"
+          },
+          "default": "[...new Set(element.bindings.map((binding) => binding.tag))]"
+        },
+        {
+          "kind": "variable",
+          "name": "elementId"
+        },
+        {
+          "kind": "function",
+          "name": "defineScadaView",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "tagName",
+              "default": "'scada-view'"
+            }
+          ],
+          "description": "Explicit registration — importing"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "inferAnimationPriority",
+          "declaration": {
+            "name": "inferAnimationPriority",
+            "module": "src/scada-view.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ScadaView",
+          "declaration": {
+            "name": "ScadaView",
+            "module": "src/scada-view.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineScadaView",
+          "declaration": {
+            "name": "defineScadaView",
+            "module": "src/scada-view.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tagName",
+          "declaration": {
+            "name": "ScadaView",
+            "module": "src/scada-view.ts"
+          }
+        }
+      ]
+    }
+  ]
+}