@vscada/primitives 0.0.1

package/dist/rotation-drive/base.d.ts

@@ -0,0 +1,110 @@
+import type { AnimationControl, DefaultTransition, HandleMap, Renderer, SceneElement, TransitionSpec, ValueWarningDetail } from '@vscada/core';
+/** One state's visual — lamp color ALWAYS paired with a text label (AD-3: color never stands alone). */
+export interface RotatingStateVisual {
+    lampColor: string;
+    blink: boolean;
+    label: string;
+}
+/**
+ * Minimal structural shape `buildRotationDrive` needs from a primitive's
+ * own token namespace (`PumpTokens`, `DrivenEquipmentTokens`, `FanTokens`,
+ * ...). Every one of those interfaces satisfies this structurally — no
+ * primitive needs to cast or adapt its real tokens object to call in here.
+ */
+export interface RotatingTokensLike {
+    states: Record<string, RotatingStateVisual>;
+    bodyEnergizedColor: string;
+    bodyDeenergizedColor: string;
+}
+/** The SVG elements a state change writes into. `body` is optional — some primitives (e.g. a bare rotor icon) may not have a distinct energized-highlight surface. */
+export interface RotatingVisualRefs {
+    body?: Element;
+    lamp: Element;
+    label: Element;
+}
+/**
+ * §6.2's lamp+label+body-highlight state pairing, generic over any state
+ * set (the pump's 5-state `stopped/starting/running/tripped/unavailable`,
+ * a fan's 3-state `off/running/fault`, ...). Returns the resolved visual
+ * (or `undefined` for an unmapped state name absent from `tokens.states`,
+ * matching pump-centrifugal's original "nothing sensible to render, hold
+ * prior visual" behavior) so the caller can decide the blink control's
+ * pause/resume.
+ */
+export declare function applyRotatingStateVisual(renderer: Renderer, tokens: RotatingTokensLike, state: string, runningState: string, visuals: RotatingVisualRefs): RotatingStateVisual | undefined;
+/**
+ * §6.2's asymmetric ramp/coast default-transition idiom (pump: 1800ms
+ * ease-out up, 3500ms ease-in down), generalized: any primitive whose
+ * default transition depends only on "is the new state the running state"
+ * can build its `DefaultTransition` with one call instead of hand-rolling
+ * the same ternary pump-centrifugal originally wrote inline.
+ */
+export declare function makeAsymmetricTransition(runningState: string, up: TransitionSpec, down: TransitionSpec): DefaultTransition;
+/**
+ * Task 3's hysteresis band, generalized (Dev Notes: "keep it in the shared
+ * base — turbines may reuse it at high RPM") — even though only the two
+ * fan primitives consume it in this story. Tracks its own on/off state
+ * internally (never recomputed from scratch each tick): once ON, `value`
+ * must fall BELOW `threshold * (1 - band)` to turn back off; once OFF, it
+ * must rise ABOVE `threshold * (1 + band)` to turn back on. A value
+ * oscillating right at `threshold` therefore never flickers.
+ */
+export declare class HysteresisSwitch {
+    private readonly threshold;
+    /** Fraction of `threshold` for the dead band on each side. §Task 3 decision: ±5% (0.05). */
+    private readonly band;
+    private on;
+    constructor(threshold: number, 
+    /** Fraction of `threshold` for the dead band on each side. §Task 3 decision: ±5% (0.05). */
+    band?: number);
+    /** Feeds one new sample; returns the (possibly updated) on/off state. */
+    update(value: number): boolean;
+    get isOn(): boolean;
+}
+export interface RotationDriveOptions {
+    element: SceneElement;
+    renderer: Renderer;
+    tokens: RotatingTokensLike;
+    /** The one state name that counts as "energized/spinning up" (pump/fan-equivalent: `'running'`). */
+    runningState: string;
+    defaultTransition: DefaultTransition;
+    visuals: RotatingVisualRefs;
+    /**
+     * Every WAAPI control whose `playbackRate` should track the tweened
+     * rotation rate — usually one (a single impeller/rotor), but a fan's
+     * blur-disc crossover (Task 3) needs BOTH its discrete-blade control and
+     * its blurred-ring control kept in sync (AD-2: both pre-built, opacity
+     * toggled, never rebuilt — so both must keep spinning even while hidden).
+     */
+    rotationControls: AnimationControl[];
+    blinkControl: AnimationControl;
+    /** Ceiling for the `rotate` binding's normalized rate (pump-centrifugal's `MAX_IMPELLER_RATE` convention). Defaults to 4. */
+    maxRate?: number;
+    /** Live in-flight speed-tag retarget smoothing window while running (pump-centrifugal's 300ms). Defaults to 300. */
+    liveSmoothingMs?: number;
+    /**
+     * Optional hook invoked with the RAW (un-normalized) speed-tag value on
+     * every `rotate`-binding write, before rate normalization — this is the
+     * seam a fan primitive uses to drive its `HysteresisSwitch` against the
+     * true RPM value (the normalized 0..1 rate fraction is the wrong unit
+     * for an RPM threshold token).
+     */
+    onSpeedRawValue?: (rawValue: number, now: number) => void;
+    onWarning?: (detail: ValueWarningDetail) => void;
+}
+export interface RotationDrive {
+    handles: HandleMap;
+    /** The FSM-resolved state as of the most recent `state`-binding write; `undefined` before the first write ever lands. */
+    getCurrentState(): string | undefined;
+}
+/**
+ * Wires one element's full rotation drive: `state` binding -> `Fsm` ->
+ * lamp/label/body visual + tween retarget; `rotate` binding -> normalized
+ * target rate, live-retargeted while running; a `TweenHandle` that ticks
+ * every registered rotation control's `playbackRate`; and ONE bundled
+ * `AnimationHandle` (AD-5) pausing/resuming/seeking every rotation control
+ * plus the blink control together — the same shape pump-centrifugal's
+ * original single `__pump-animations-*` handle already established.
+ */
+export declare function buildRotationDrive(opts: RotationDriveOptions): RotationDrive;
+//# sourceMappingURL=base.d.ts.map

package/dist/rotation-drive/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/rotation-drive/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,SAAS,EACT,QAAQ,EACR,YAAY,EAGZ,cAAc,EAEd,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAsBtB,wGAAwG;AACxG,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,sKAAsK;AACtK,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,mBAAmB,GAAG,SAAS,CASjC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,GAAG,iBAAiB,CAE1H;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,4FAA4F;IAC5F,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,EAAE,CAAS;gBAGA,SAAS,EAAE,MAAM;IAClC,4FAA4F;IAC3E,IAAI,SAAO;IAG9B,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAM9B,IAAI,IAAI,IAAI,OAAO,CAElB;CACF;AAUD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,oGAAoG;IACpG,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;;;;;OAMG;IACH,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,6HAA6H;IAC7H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oHAAoH;IACpH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,CAAC;IACnB,yHAAyH;IACzH,eAAe,IAAI,MAAM,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAqG5E"}

package/dist/valves/ball/ball.stories.d.ts

@@ -0,0 +1,26 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Closed: ValveStory;
+export declare const MidStroke: ValveStory;
+export declare const Open: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=ball.stories.d.ts.map

package/dist/valves/ball/ball.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ball.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/ball/ball.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAA2E,CAAC;AACjG,eAAO,MAAM,SAAS,EAAE,UAAmE,CAAC;AAC5F,eAAO,MAAM,IAAI,EAAE,UAAqE,CAAC;AACzF,eAAO,MAAM,KAAK,EAAE,UAAsF,CAAC;AAC3G,eAAO,MAAM,WAAW,EAAE,UAAwF,CAAC;AAEnH,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/ball/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/ball/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/ball/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AA+GrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/base.d.ts

@@ -0,0 +1,70 @@
+import type { AnimationControl, HandleMap, Renderer, SceneElement, ValueWarningDetail } from '@vscada/core';
+/**
+ * Story 3.5 Task 1 — the shared machinery every valve primitive
+ * (gate/ball/butterfly/control/check/relief) builds on, mirroring
+ * `rotation-drive/base.ts`'s "extract-then-specialize" shape. Owns the GENERIC
+ * halves: the `closed/opening/open/closing/fault` state set, the
+ * position-fraction `Tween` guaranteeing the §6.2 "3-15s, never jump"
+ * stroke regardless of how sparsely a real position tag updates (core's
+ * OWN store-level interpolation caps at 2000ms and can snap on a big enough
+ * jump — see `scheduler.ts`'s `MAX_TWEEN_DURATION_MS`/`DEFAULT_SNAP_THRESHOLD`
+ * — neither guarantee is strong enough for a valve, so this module keeps
+ * its own independent `Tween` and treats every incoming raw value as a
+ * fresh TARGET, never trusting the scheduler's own smoothing/snapping for
+ * this channel), and the direction-arrow blink registration (AD-5). It does
+ * NOT own SVG structure (AD-3: stays with each primitive's own `build()`)
+ * or the type-specific disc/gate/bore geometry (Task 2) — that's wired
+ * through the `onFraction` callback below.
+ */
+export type ValveState = 'closed' | 'opening' | 'open' | 'closing' | 'fault';
+/** One state's visual — indicator color ALWAYS paired with a text label (AD-3: color never stands alone). */
+export interface ValveStateVisualLike {
+    indicatorColor: string;
+    blink: boolean;
+    label: string;
+}
+/** Minimal structural shape `buildValveDrive` needs from `ValveTokens`. */
+export interface ValveTokensLike {
+    states: Record<string, ValveStateVisualLike>;
+    defaultStrokeMs: number;
+}
+/** The SVG elements a valve's state/fraction writes touch. */
+export interface ValveVisualRefs {
+    /** The element whose `scaleX` (transform-origin left edge) reads the fill fraction 0..1 — the "grey closed / medium color open" body-fill read (AC2). */
+    fill: Element;
+    /** AD-3: state color always paired with this text label. */
+    indicator: Element;
+    label: Element;
+}
+export interface ValveDriveOptions {
+    element: SceneElement;
+    renderer: Renderer;
+    tokens: ValveTokensLike;
+    visuals: ValveVisualRefs;
+    /** Registered blink-capable control lighting the direction arrows during transit (Task 1: "direction arrows lit during motion (registered blink-capable)"), AD-5. */
+    arrowControl: AnimationControl;
+    /** The element whose opacity toggles 0/1 alongside `arrowControl`'s pause/resume — the arrow GROUP itself (built by the primitive, geometry unowned by base). */
+    arrowVisual: Element;
+    /** Per-type callback: writes the fraction (0..1) into that type's own disc/gate/bore geometry (Task 2 — base.ts deliberately owns none of this, AD-3). */
+    onFraction: (renderer: Renderer, fraction: number) => void;
+    onWarning?: (detail: ValueWarningDetail) => void;
+}
+export interface ValveDrive {
+    handles: HandleMap;
+    /** The resolved state as of the most recent write (explicit or derived); `undefined` before the first-ever write lands. */
+    getCurrentState(): ValveState | undefined;
+}
+/**
+ * Wires one valve element's full drive: an optional `position` binding
+ * (continuous, drives the fraction Tween's TARGET directly — real
+ * telemetry, when present, owns the continuous channel) and/or an optional
+ * `state` binding (FSM-resolved discrete label/indicator/arrows; ALSO
+ * drives the fraction Tween's target when no position tag exists, per Dev
+ * Notes: "position is the primary channel, states derive when no position
+ * tag exists" — read the other direction, when there's no position tag the
+ * FSM's own resolved state becomes the fraction's driver). `fault` freezes
+ * the fraction at whatever it last physically reached (Dev Notes: a stuck
+ * valve doesn't un-stick visually).
+ */
+export declare function buildValveDrive(opts: ValveDriveOptions): ValveDrive;
+//# sourceMappingURL=base.d.ts.map

package/dist/valves/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/valves/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,SAAS,EAAiB,QAAQ,EAAE,YAAY,EAA4B,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGtK;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7E,6GAA6G;AAC7G,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,yJAAyJ;IACzJ,IAAI,EAAE,OAAO,CAAC;IACd,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,eAAe,CAAC;IACzB,qKAAqK;IACrK,YAAY,EAAE,gBAAgB,CAAC;IAC/B,iKAAiK;IACjK,WAAW,EAAE,OAAO,CAAC;IACrB,0JAA0J;IAC1J,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,2HAA2H;IAC3H,eAAe,IAAI,UAAU,GAAG,SAAS,CAAC;CAC3C;AASD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CA4JnE"}

package/dist/valves/butterfly/butterfly.stories.d.ts

@@ -0,0 +1,26 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Closed: ValveStory;
+export declare const MidStroke: ValveStory;
+export declare const Open: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=butterfly.stories.d.ts.map

package/dist/valves/butterfly/butterfly.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"butterfly.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/butterfly/butterfly.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAAqE,CAAC;AAC3F,eAAO,MAAM,SAAS,EAAE,UAA2D,CAAC;AACpF,eAAO,MAAM,IAAI,EAAE,UAAqE,CAAC;AACzF,eAAO,MAAM,KAAK,EAAE,UAAsF,CAAC;AAC3G,eAAO,MAAM,WAAW,EAAE,UAAwF,CAAC;AAEnH,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/butterfly/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/butterfly/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/butterfly/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AA0HrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/check/check.stories.d.ts

@@ -0,0 +1,25 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Closed: ValveStory;
+export declare const Open: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=check.stories.d.ts.map

package/dist/valves/check/check.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/check/check.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAAsE,CAAC;AAC5F,eAAO,MAAM,IAAI,EAAE,UAAsF,CAAC;AAC1G,eAAO,MAAM,KAAK,EAAE,UAAkE,CAAC;AACvF,eAAO,MAAM,WAAW,EAAE,UAA6E,CAAC;AAExG,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/check/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/check/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AA0HrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/control/control.stories.d.ts

@@ -0,0 +1,26 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Closed: ValveStory;
+export declare const MidStroke: ValveStory;
+export declare const Open: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=control.stories.d.ts.map

package/dist/valves/control/control.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/control/control.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAAsD,CAAC;AAC5E,eAAO,MAAM,SAAS,EAAE,UAAiE,CAAC;AAC1F,eAAO,MAAM,IAAI,EAAE,UAAsD,CAAC;AAC1E,eAAO,MAAM,KAAK,EAAE,UAAsF,CAAC;AAC3G,eAAO,MAAM,WAAW,EAAE,UAAwF,CAAC;AAEnH,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/control/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/control/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/control/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AA+IrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/gate/gate.stories.d.ts

@@ -0,0 +1,26 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Closed: ValveStory;
+export declare const MidStroke: ValveStory;
+export declare const Open: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=gate.stories.d.ts.map

package/dist/valves/gate/gate.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/gate/gate.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAAsD,CAAC;AAC5E,eAAO,MAAM,SAAS,EAAE,UAAiE,CAAC;AAC1F,eAAO,MAAM,IAAI,EAAE,UAAsD,CAAC;AAC1E,eAAO,MAAM,KAAK,EAAE,UAAsF,CAAC;AAC3G,eAAO,MAAM,WAAW,EAAE,UAAwF,CAAC;AAEnH,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/gate/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/gate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AAqHrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/index.d.ts

@@ -0,0 +1,8 @@
+import type { PrimitiveGroup } from '@vscada/core';
+/**
+ * Valve entry point (§6.1) — Story 3.5's batch of six, all built on
+ * `./base.ts`'s shared FSM/position/tween drive machinery, matching
+ * `rotating/index.ts`/`vessels/index.ts`'s established merge pattern.
+ */
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/valves/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,cAUnB,CAAC"}

package/dist/valves/relief/index.d.ts

@@ -0,0 +1,3 @@
+import type { PrimitiveGroup } from '@vscada/core';
+export declare const valves: PrimitiveGroup;
+//# sourceMappingURL=index.d.ts.map

package/dist/valves/relief/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/valves/relief/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAyD,MAAM,cAAc,CAAC;AAiJrH,eAAO,MAAM,MAAM,EAAE,cAGnB,CAAC"}

package/dist/valves/relief/relief.stories.d.ts

@@ -0,0 +1,26 @@
+import { type ValveStory, type ValveStoryArgs, type ValveStoryMeta } from '../story-kit';
+export declare const meta: ValveStoryMeta;
+export declare const argTypes: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export declare const Seated: ValveStory;
+export declare const Lifting: ValveStory;
+export declare const FullyLifted: ValveStory;
+export declare const Fault: ValveStory;
+export declare const StaleFreeze: ValveStory;
+export declare function render(container: HTMLElement, args?: Partial<ValveStoryArgs>): import("../story-kit").MountedValveStory;
+export default meta;
+//# sourceMappingURL=relief.stories.d.ts.map

package/dist/valves/relief/relief.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relief.stories.d.ts","sourceRoot":"","sources":["../../../src/valves/relief/relief.stories.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjI,eAAO,MAAM,IAAI,EAAE,cAKlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAAwB,CAAC;AAE9C,eAAO,MAAM,MAAM,EAAE,UAA+D,CAAC;AACrF,eAAO,MAAM,OAAO,EAAE,UAAqE,CAAC;AAC5F,eAAO,MAAM,WAAW,EAAE,UAAqE,CAAC;AAChG,eAAO,MAAM,KAAK,EAAE,UAAoF,CAAC;AACzG,eAAO,MAAM,WAAW,EAAE,UAAsF,CAAC;AAEjH,wBAAgB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,4CAEhF;AAED,eAAe,IAAI,CAAC"}

package/dist/valves/story-kit.d.ts

@@ -0,0 +1,54 @@
+import { ScadaView, type Renderer, type TimeSource } from '@vscada/core';
+export interface ValveStoryMeta {
+    title: string;
+    /** The registered primitive `type` — must be a key in `valves.primitives`. */
+    elementType: string;
+    width: number;
+    height: number;
+}
+export interface ValveStoryArgs {
+    /** 0..100 — the commanded position (AC1). */
+    position: number;
+    /** Sends the `state` tag mapped to `fault` alongside `position` (a stuck valve freezes at whatever fraction it last reached). */
+    fault: boolean;
+    /** Reuses Story 1.6's freeze mechanism (`connectionState = 'disconnected'`). */
+    stale: boolean;
+}
+export declare function defaultValveStoryArgs(): ValveStoryArgs;
+export declare const VALVE_STORY_ARG_TYPES: {
+    readonly position: {
+        readonly control: {
+            readonly type: "range";
+            readonly min: 0;
+            readonly max: 100;
+            readonly step: 1;
+        };
+    };
+    readonly fault: {
+        readonly control: "boolean";
+    };
+    readonly stale: {
+        readonly control: "boolean";
+    };
+};
+export interface ValveStory {
+    name: string;
+    args?: Partial<ValveStoryArgs>;
+}
+export interface MountedValveStory {
+    element: ScadaView;
+    setArgs(next: Partial<ValveStoryArgs>): void;
+    teardown(): void;
+}
+export interface MountValveStoryOptions {
+    /** Real usage always gets the real WAAPI-backed `domRenderer`; tests inject a stub (jsdom/happy-dom has no `Element.animate`). */
+    renderer?: Renderer;
+    timeSource?: TimeSource;
+}
+/**
+ * Mounts one valve primitive as a real `<scada-view>` inside `container`,
+ * driven by `args` (position sweep / fault toggle / stale freeze). Mirrors
+ * `mountRotatingStory`/`mountVesselStory`'s shape exactly.
+ */
+export declare function mountValveStory(container: HTMLElement, meta: ValveStoryMeta, initialArgs?: Partial<ValveStoryArgs>, options?: MountValveStoryOptions): MountedValveStory;
+//# sourceMappingURL=story-kit.d.ts.map

package/dist/valves/story-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-kit.d.ts","sourceRoot":"","sources":["../../src/valves/story-kit.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,SAAS,EACT,KAAK,QAAQ,EAGb,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAsCtB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iIAAiI;IACjI,KAAK,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CAEtD;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;CAIxB,CAAC;AA0CX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,kIAAkI;IAClI,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,cAAc,EACpB,WAAW,GAAE,OAAO,CAAC,cAAc,CAAM,EACzC,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,CA2BnB"}