@vscada/core 0.0.1

package/dist/contracts/connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../src/contracts/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC"}

package/dist/contracts/handles.d.ts

@@ -0,0 +1,83 @@
+import type { TagValue } from './tag-value';
+import type { Renderer } from './renderer';
+/**
+ * `now` (the current tick's timestamp) is passed to every write so a
+ * handle can drive its OWN internal `Tween` (Story 1.5) — e.g. a
+ * state-triggered ramp needs to know when "now" is to retarget correctly.
+ * Handles that don't need it simply ignore the parameter.
+ */
+/** Tweened numeric writes (fill height, rotation angle, dash offset, …). */
+export interface NumericHandle {
+    kind: 'numeric';
+    write(renderer: Renderer, value: number, now: number): void;
+}
+/** Formatted text writes (readouts). Receives the raw value — the primitive owns formatting/units. */
+export interface TextHandle {
+    kind: 'text';
+    write(renderer: Renderer, value: TagValue['value'], now: number): void;
+}
+/**
+ * Discrete state writes. The scheduler passes the store's raw
+ * `currentValue` unsmoothed — a state code (e.g. 0/1/2) must never be
+ * numerically interpolated the way a continuous quantity is (Story 1.5
+ * fixed a latent Story 1.3 gap here: `NumericHandle`-style interpolation
+ * would otherwise blend between state codes into meaningless fractions).
+ */
+export interface StateHandle {
+    kind: 'state';
+    write(renderer: Renderer, value: TagValue['value'], now: number): void;
+}
+/**
+ * Drives an in-flight state-transition ramp/coast (§6.2's tween layer,
+ * Story 1.5). Ticked EVERY scheduler frame unconditionally — not gated on
+ * any tag's value changing, since the ramp must keep advancing across many
+ * ticks after the one tick where the driving state tag actually changed.
+ */
+export interface TweenHandle {
+    kind: 'tween';
+    tick(renderer: Renderer, now: number): void;
+    /** `snapToTargets()` (Story 1.6 AC4): completes any in-flight ramp to its target immediately and permanently (until the next retarget). */
+    snap(renderer: Renderer, now: number): void;
+}
+/**
+ * Continuous animation control (impeller spin, flow dash, plume drift).
+ * Every one of these a primitive creates must be registered with core's
+ * animation registry at build time (AD-5) — this handle IS that
+ * registration point. No freeze/staleness LOGIC here (Story 1.6); this is
+ * only the pause/resume control surface that story calls into.
+ */
+export interface AnimationHandle {
+    kind: 'animation';
+    pause(): void;
+    resume(): void;
+    /** Story 1.7: deterministic-frame capability for visual regression — sets every underlying WAAPI animation's `currentTime`. */
+    seek(timeMs: number): void;
+}
+/**
+ * Reduced-motion's declared static swap (Story 4.4 AC1, §11). An
+ * `AnimationHandle`'s `pause()` only holds the CURRENT frame — fine for a
+ * rotating impeller or a dashed flow line (still legible mid-cycle), but
+ * an opacity-driven drift/fade (vapor's plume/steam-vent) can pause on an
+ * ambiguous half-formed frame. A primitive with that shape also builds a
+ * static, non-animated representation and registers it here; core's
+ * `ReducedMotionController` calls `activate()`/`deactivate()` in lockstep
+ * with the SAME `prefers-reduced-motion` toggle that flips `animated`
+ * (never independently — see that controller's own doc).
+ */
+export interface StaticRepresentationHandle {
+    kind: 'static-representation';
+    /** Show the static representation, hide the animated one. */
+    activate(): void;
+    /** Reverse of `activate()`. */
+    deactivate(): void;
+}
+export type Handle = NumericHandle | TextHandle | StateHandle | AnimationHandle | TweenHandle | StaticRepresentationHandle;
+/**
+ * Returned by a primitive's `build()`. Keyed by the binding's `tag` — a
+ * simplification for the one-binding-per-tag-per-element case this story
+ * proves; if a future story needs multiple bindings sharing one tag on the
+ * same element, this keying scheme will need revisiting (documented, not
+ * solved speculatively here).
+ */
+export type HandleMap = Record<string, Handle>;
+//# sourceMappingURL=handles.d.ts.map

package/dist/contracts/handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/contracts/handles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;GAKG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7D;AAED,sGAAsG;AACtG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxE;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,2IAA2I;IAC3I,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,+HAA+H;IAC/H,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,IAAI,IAAI,CAAC;IACjB,+BAA+B;IAC/B,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,0BAA0B,CAAC;AAE3H;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/contracts/primitive.d.ts

@@ -0,0 +1,37 @@
+import type { SceneElement } from '../scene/scene-schema';
+import type { ThemeTokens } from '../tokens';
+import type { HandleMap } from './handles';
+import type { Renderer } from './renderer';
+/**
+ * Resolved theme handed to a primitive's `build()`. `defs` is the scene's
+ * ONE shared `<defs>` (spine convention — never per-primitive); core
+ * creates it fresh per scene build and primitives append their own
+ * definitions (gradients, etc.) into it, guarding against duplicate
+ * insertion by checking for an existing id first.
+ */
+export interface ThemeContext {
+    tokens: ThemeTokens;
+    defs: SVGDefsElement;
+}
+/**
+ * The primitive contract (AD-3): a pure structure factory. No store
+ * access, no clock access, no sibling-primitive imports, no literal
+ * colors — reference theme tokens by name only.
+ *
+ * `renderer` is passed ONLY so `build()` can call `renderer.animateTransform`
+ * to create continuous animations at build time (AD-5 requires every one be
+ * registerable/mockable) — it must never be used for anything else here;
+ * per-frame writes still happen exclusively through returned handles.
+ */
+export interface PrimitiveModule {
+    build(element: SceneElement, theme: ThemeContext, renderer: Renderer): {
+        svg: SVGElement;
+        handles: HandleMap;
+    };
+}
+/** What `registerPrimitives()` accepts — one entry point per primitive group. */
+export interface PrimitiveGroup {
+    group: string;
+    primitives: Readonly<Record<string, PrimitiveModule>>;
+}
+//# sourceMappingURL=primitive.d.ts.map

package/dist/contracts/primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../src/contracts/primitive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC;CAChH;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACvD"}

package/dist/contracts/renderer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The narrow seam (spec constraint C4) every per-frame DOM write passes
+ * through. Deliberately four methods, not a "renderer framework" — the
+ * point is mock-ability in tests today and a WebGL escape hatch later.
+ * Handles must NEVER touch the DOM directly; they call through this.
+ *
+ * The one-time structural render (Lit template → SVG shell, AD-2) does
+ * NOT go through this seam — only per-frame handle writes do.
+ */
+/** Handle returned by `animateTransform` — the only WAAPI surface a primitive ever touches. */
+export interface AnimationControl {
+    setPlaybackRate(rate: number): void;
+    pause(): void;
+    resume(): void;
+    /** Story 1.7: sets the WAAPI animation's `currentTime` directly — the sanctioned deterministic-frame mechanism for visual regression (never per-animation CSS overrides in test code). */
+    seek(timeMs: number): void;
+}
+export interface Renderer {
+    setTransform(node: Element, transform: string): void;
+    setAttr(node: Element, name: string, value: string): void;
+    setCssVar(node: Element, name: string, value: string): void;
+    setText(node: Element, value: string): void;
+    /**
+     * Creates a continuous, transform-only WAAPI loop (§9.4, AD-5) — e.g. the
+     * flow-dash translation, an impeller's rotation. One purpose-built method
+     * rather than exposing raw `Element.animate()`: keeps the seam mockable
+     * (the test environment's DOM has no WAAPI implementation at all) and
+     * keeps primitives from reaching for arbitrary animation options.
+     */
+    animateTransform(node: Element, keyframeTransforms: string[], durationMs: number): AnimationControl;
+}
+/** Default implementation: writes straight to the live SVG/HTML DOM. */
+export declare const domRenderer: Renderer;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/contracts/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/contracts/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,0LAA0L;IAC1L,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACrG;AAED,wEAAwE;AACxE,eAAO,MAAM,WAAW,EAAE,QAiCzB,CAAC"}

package/dist/contracts/tag-value.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dataset contract (spec §4.1). This is the only shape a consuming app
+ * touches at runtime — kept intentionally small and stable.
+ */
+export type TagValueQuality = 'good' | 'uncertain' | 'bad';
+export interface TagValue {
+    /** Required, unique identifier. */
+    tag: string;
+    value: number | boolean | string;
+    /** Defaults to 'good' when absent. */
+    quality?: TagValueQuality;
+    /** Epoch milliseconds, UTC. */
+    timestamp?: number;
+}
+/**
+ * `value-warning` event detail (dev-mode dataset contract violations,
+ * §3.4). `UNKNOWN_BINDING_TYPE` — Story 3.1 AC2: a binding whose `type`
+ * isn't one of the 11 declared literals, discovered at scene build.
+ * Story 5.5 AC2 — `MISSING_SVG_SOURCE`/`INVALID_SVG_SOURCE`: the imported
+ * element's `svgRef` doesn't resolve, or doesn't parse as SVG.
+ * `MISSING_SVG_ID`/`UNSUPPORTED_IMPORT_BINDING_TYPE`: a binding inside an
+ * `svg-import` element references an id absent from the foreign art, or
+ * declares a type outside the supported subset — the structural validator
+ * doesn't check binding shape (never has, for any element type), so this is
+ * the loader's own runtime defensiveness, same spirit as `classifyBinding`.
+ */
+export type ValueWarningCode = 'INVALID_TIMESTAMP_TYPE' | 'SUSPECTED_NON_MS_TIMESTAMP' | 'UNMAPPED_STATE_VALUE' | 'UNKNOWN_BINDING_TYPE' | 'NEGATIVE_EMISSION_VALUE' | 'MISSING_SVG_SOURCE' | 'INVALID_SVG_SOURCE' | 'MISSING_SVG_ID' | 'UNSUPPORTED_IMPORT_BINDING_TYPE';
+export interface ValueWarningDetail {
+    code: ValueWarningCode;
+    message: string;
+    tag: string;
+}
+//# sourceMappingURL=tag-value.d.ts.map

package/dist/contracts/tag-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-value.d.ts","sourceRoot":"","sources":["../../src/contracts/tag-value.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,4BAA4B,GAC5B,sBAAsB,GACtB,sBAAsB,GACtB,yBAAyB,GACzB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,iCAAiC,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/contracts/time-source.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Playback-ready clock abstraction (spec §8.4). Every timestamp comparison
+ * anywhere in core/primitives goes through this — never `Date.now()` or
+ * `performance.now()` inline (FR17, AD-4). This costs nothing today and is
+ * the difference between adding historical replay in a week vs. a month.
+ */
+export interface TimeSource {
+    now(): number;
+    /** Returns an unsubscribe function. */
+    onTick(cb: (t: number) => void): () => void;
+}
+/** Default live-mode implementation: `performance.now()` + `requestAnimationFrame`. */
+export declare const defaultTimeSource: TimeSource;
+//# sourceMappingURL=time-source.d.ts.map

package/dist/contracts/time-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-source.d.ts","sourceRoot":"","sources":["../../src/contracts/time-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,IAAI,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAED,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,EAAE,UAS/B,CAAC"}