@adcops/autocore-react 3.0.40 → 3.1.1

package/dist/core/AutoCoreTagTypes.d.ts

@@ -0,0 +1,162 @@
+/**
+ * @module core/AutoCoreTagTypes
+ *
+ * Core type system for AutoCore's tag layer:
+ * - Strongly-typed tag values (boolean/number/string/json)
+ * - Optional **scales** for numeric unit conversion (e.g., mm ⇄ in)
+ * - Optional **codecs** to present richer client-side types (Date/Map) while
+ *   keeping pure JSON across the wire (serde_json::Value on the server)
+ */
+export type PrimitiveKind = "boolean" | "number" | "string" | "json";
+/** Strict JSON value (mirrors serde_json::Value) */
+type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | {
+    [key: string]: JsonValue;
+} | JsonValue[];
+/**
+ * Extended client-side value you *may* choose to present in the UI.
+ * Use codecs to round-trip these as pure JSON to the server.
+ */
+export type ExtendedJsonValue = JsonValue | Date | Map<string, JsonValue>;
+/**
+ * Map a tag's declared primitive kind to the app-visible type.
+ * - "json" becomes ExtendedJsonValue so UIs can work with Date/Map when desired.
+ */
+export type TagValueOf<K extends PrimitiveKind> = K extends "boolean" ? boolean : K extends "number" ? number : K extends "string" ? string : ExtendedJsonValue;
+/**
+ * Runtime binding for a single tag, as returned by hooks like `useAutoCoreTag`.
+ * - `value` is app-visible (already scaled/decoded)
+ * - `rawValue` is the last **unscaled, un-decoded** controller value received (server JSON)
+ * - `write` expects app-visible value (provider will inverse-scale/encode)
+ * - `tap` is typically for boolean momentaries (provider may pulse true→false)
+ */
+export type TagBinding<T> = Readonly<{
+    /** App-visible value (scaled/decoded). */
+    value: T | undefined;
+    /** Last raw value from the server (pre-scale, pre-codec). */
+    rawValue: unknown | undefined;
+    /** Write a new app-visible value (provider will inverse-scale/encode). */
+    write: (displayValue: T) => Promise<void>;
+    /** Momentary action; typically boolean true→false pulse. */
+    tap: () => Promise<void>;
+    /** True while initial read/bootstrapping is in progress. */
+    isLoading: boolean;
+}>;
+/**
+ * Configuration for a named scale group.
+ * Apply by setting `scale: "<name>"` on numeric tags.
+ */
+export interface ScaleConfig {
+    /** Unique name for this scale group (e.g., "position", "load") */
+    name: string;
+    /** Current scale factor — incoming values ×= scale; outgoing values /= scale */
+    scale: number;
+    /** Units/label for display (e.g., "mm", "in", "lbs") */
+    label: string;
+    /** Optional description for debugging/documentation */
+    description?: string;
+    /**
+     * Optional server tag that provides the scale dynamically.
+     * (If used, your provider should subscribe and update `scale` when it changes.)
+     */
+    serverTag?: {
+        domain: string;
+        symbolName: string;
+    };
+}
+/**
+ * A codec lets a tag expose a richer client-side type while staying JSON on the wire.
+ * Common examples:
+ * - Date values: ISO string ⇄ Date
+ * - Map-like blobs: object ⇄ Map<string, JsonValue>
+ */
+export type TagCodec<TIn = unknown, TOut extends JsonValue = JsonValue> = {
+    /** raw JSON (from server) → app-visible value */
+    fromServer?: (raw: unknown) => TIn;
+    /** app-visible value → pure JSON (to server) */
+    toServer?: (value: TIn) => TOut;
+};
+/**
+ * Tag configuration descriptor used to build a typed spec.
+ *
+ * @typeParam K - Literal tag name (use `as const` on your spec array)
+ * @typeParam T - Primitive kind for type mapping (boolean/number/string/json)
+ */
+export type TagConfig<K extends string = string, T extends PrimitiveKind = PrimitiveKind> = {
+    /** Local key used by UI/consumers (unique within your spec) */
+    tagName: K;
+    /** Domain for the symbol (e.g., "ADS", "MEMORYSTORE") */
+    domain: string;
+    /** Server symbol/topic name (as used by your backend invoke API) */
+    symbolName: string;
+    /** Declared primitive kind for typing and DevPanel rendering */
+    valueType: T;
+    /** Optional initial **raw** value before first server update */
+    initialValue?: TagValueOf<T>;
+    /** Optional per-tag hook/config options (e.g., cycle time, debounce) */
+    options?: Record<string, unknown>;
+    /**
+     * Optional scale group for numeric tags.
+     * If present, provider will:
+     * - Multiply incoming numbers by the group's `scale`
+     * - Divide outgoing numbers by the group's `scale`
+     */
+    scale?: string;
+    /**
+     * Optional codec to present richer UI types while keeping JSON on the wire.
+     * Only commonly used with `valueType: "json"`.
+     */
+    codec?: TagCodec;
+};
+/** Extract the tag config for a particular tag name `K` from a `Spec` */
+export type ExtractByTag<Spec extends readonly TagConfig[], K> = Extract<Spec[number], {
+    tagName: K;
+}>;
+/**
+ * Build a strongly-typed map of tagName → app-visible value type.
+ * Use with `as const` specs to preserve literal tag names.
+ */
+export type TagValueMap<Spec extends readonly TagConfig[]> = {
+    [K in Spec[number]["tagName"]]: TagValueOf<ExtractByTag<Spec, K>["valueType"]>;
+};
+/**
+ * Helper: binding type for a specific tag name from a spec.
+ */
+export type BindingOf<Spec extends readonly TagConfig[], K extends Spec[number]["tagName"]> = TagBinding<TagValueMap<Spec>[K]>;
+/**
+ * Enhanced context value with scale management.
+ * Providers should:
+ * - Buffer **raw** values in `rawValues` (pre-scale, pre-codec)
+ * - Populate `values` from `rawValues` using current scales/codecs
+ * - Inverse-scale/encode on write(t) before invoking backend
+ */
+export interface BaseContextValue<VMap extends Record<string, any>> {
+    /** Current app-visible tag values (already scaled/decoded). */
+    values: Partial<VMap>;
+    /** Last raw (controller) values, as received (pre-scale, pre-codec). */
+    rawValues: Record<string, unknown>;
+    /** Whether initial reads are pending. */
+    isLoading: boolean;
+    /**
+     * Write a single tag value (app-visible → provider will inverse-scale/encode).
+     * Strongly typed by tag name when used with a typed Context.
+     */
+    write: <K extends keyof VMap & string>(tagName: K, value: VMap[K]) => Promise<void>;
+    /**
+     * Trigger a momentary/toggle action for a tag.
+     * Typically used for boolean "request" bits.
+     */
+    tap: <K extends keyof VMap & string>(tagName: K) => Promise<void>;
+    /** Current scale configurations by name. */
+    scales: Record<string, ScaleConfig>;
+    /**
+     * Update a scale group (factor and label). Providers should recompute affected tags from **raw**.
+     *
+     * @param scaleName - Name of the scale group (e.g., "position")
+     * @param newScale  - New scale factor (display = raw * newScale)
+     * @param newLabel  - New units label (e.g., "inches")
+     */
+    updateScale: (scaleName: string, newScale: number, newLabel: string) => Promise<void>;
+}
+export {};
+//# sourceMappingURL=AutoCoreTagTypes.d.ts.map

package/dist/core/AutoCoreTagTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoCoreTagTypes.d.ts","sourceRoot":"","sources":["../../src/core/AutoCoreTagTypes.ts"],"names":[],"mappings":"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"}

package/dist/core/AutoCoreTagTypes.js

@@ -0,0 +1 @@
+export{};

package/dist/core/EventEmitterContext.d.ts

@@ -1,6 +1,298 @@
-import React, { ReactNode } from "react";
+/**
+ * @fileoverview EventEmitterContext - Global Event Bus for AutoCore React Applications
+ *
+ * The EventEmitterContext provides a comprehensive event-driven communication system for React applications,
+ * enabling seamless interaction between components and backend services. It serves as the foundational layer
+ * for AutoCore's real-time data flow and component communication architecture.
+ *
+ * ## Core Features
+ *
+ * - **Global Event Bus**: Publish and subscribe to events across all components
+ * - **Backend Integration**: Direct communication with AutoCore server via Hub abstraction
+ * - **Type-Safe Subscriptions**: Strongly-typed event handling with automatic cleanup
+ * - **Connection Management**: Automatic reconnection and state synchronization
+ * - **Development Tools**: Built-in debugging and subscription introspection
+ *
+ * ## Architecture
+ *
+ * The system consists of three main components:
+ * 1. **EventEmitterProvider**: React context provider that manages global state
+ * 2. **Hub**: Abstraction layer for backend communication (WebSocket, HTTP, etc.)
+ * 3. **Subscription Manager**: Handles event routing and lifecycle management
+ *
+ * ## Basic Usage
+ *
+ * ### 1. Application Setup
+ *
+ * Wrap your entire application with the EventEmitterProvider:
+ *
+ * ```tsx
+ * // App.tsx
+ * import React from 'react';
+ * import { EventEmitterProvider } from '@adcops/autocore-react/core/EventEmitterContext';
+ * import { PrimeReactProvider } from 'primereact/api';
+ * import { MainView } from './MainView';
+ *
+ * export default function App() {
+ *   return (
+ *     <EventEmitterProvider>
+ *       <PrimeReactProvider>
+ *         <MainView />
+ *       </PrimeReactProvider>
+ *     </EventEmitterProvider>
+ *   );
+ * }
+ * ```
+ *
+ * ### 2. Component Communication
+ *
+ * Use the context for inter-component communication:
+ *
+ * ```tsx
+ * // PublisherComponent.tsx
+ * import React, { useContext } from 'react';
+ * import { EventEmitterContext } from '@adcops/autocore-react/core/EventEmitterContext';
+ * import { Button } from 'primereact/button';
+ *
+ * export const PublisherComponent: React.FC = () => {
+ *   const { dispatch } = useContext(EventEmitterContext);
+ *
+ *   const handleButtonClick = () => {
+ *     dispatch({
+ *       topic: 'user-action/button-clicked',
+ *       payload: { timestamp: Date.now(), buttonId: 'main-action' }
+ *     });
+ *   };
+ *
+ *   return <Button label="Trigger Event" onClick={handleButtonClick} />;
+ * };
+ *
+ * // SubscriberComponent.tsx
+ * import React, { useContext, useEffect, useState } from 'react';
+ * import { EventEmitterContext } from '@adcops/autocore-react/core/EventEmitterContext';
+ *
+ * export const SubscriberComponent: React.FC = () => {
+ *   const { subscribe, unsubscribe } = useContext(EventEmitterContext);
+ *   const [lastAction, setLastAction] = useState<any>(null);
+ *
+ *   useEffect(() => {
+ *     const subscriptionId = subscribe('user-action/button-clicked', (payload) => {
+ *       setLastAction(payload);
+ *       console.log('Button clicked at:', payload.timestamp);
+ *     });
+ *
+ *     return () => unsubscribe(subscriptionId);
+ *   }, [subscribe, unsubscribe]);
+ *
+ *   return (
+ *     <div>
+ *       {lastAction && (
+ *         <p>Last action: {new Date(lastAction.timestamp).toLocaleTimeString()}</p>
+ *       )}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * ### 3. Backend Integration
+ *
+ * Communicate with AutoCore server through the integrated Hub:
+ *
+ * ```tsx
+ * // ControlPanel.tsx
+ * import React, { useContext, useEffect, useState } from 'react';
+ * import { EventEmitterContext } from '@adcops/autocore-react/core/EventEmitterContext';
+ * import { Button } from 'primereact/button';
+ * import { InputNumber } from 'primereact/inputnumber';
+ *
+ * export const ControlPanel: React.FC = () => {
+ *   const { invoke, subscribe, unsubscribe, isConnected } = useContext(EventEmitterContext);
+ *   const [motorSpeed, setMotorSpeed] = useState<number>(0);
+ *   const [targetSpeed, setTargetSpeed] = useState<number>(100);
+ *   const [connected, setConnected] = useState<boolean>(false);
+ *
+ *   // Monitor connection status
+ *   useEffect(() => {
+ *     setConnected(isConnected());
+ *
+ *     const connectionSub = subscribe('HUB/connected', () => setConnected(true));
+ *     const disconnectionSub = subscribe('HUB/disconnected', () => setConnected(false));
+ *
+ *     return () => {
+ *       unsubscribe(connectionSub);
+ *       unsubscribe(disconnectionSub);
+ *     };
+ *   }, [subscribe, unsubscribe, isConnected]);
+ *
+ *   // Subscribe to real-time motor speed updates
+ *   useEffect(() => {
+ *     const speedSub = subscribe('ADS/MAIN.motor.speed', (data) => {
+ *       setMotorSpeed(data.value);
+ *     });
+ *
+ *     return () => unsubscribe(speedSub);
+ *   }, [subscribe, unsubscribe]);
+ *
+ *   // Send commands to backend
+ *   const handleSpeedChange = async () => {
+ *     try {
+ *       const result = await invoke('ADS', 'write_value', {
+ *         symbol_name: 'MAIN.motor.setpoint',
+ *         value: targetSpeed
+ *       });
+ *
+ *       if (!result.success) {
+ *         console.error('Failed to set motor speed:', result.error_message);
+ *       }
+ *     } catch (error) {
+ *       console.error('Communication error:', error);
+ *     }
+ *   };
+ *
+ *   const handleEmergencyStop = async () => {
+ *     try {
+ *       await invoke('ADS', 'emergency_stop', {});
+ *     } catch (error) {
+ *       console.error('Emergency stop failed:', error);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div className="control-panel">
+ *       <div className="status">
+ *         Connection: {connected ? '🟢 Connected' : '🔴 Disconnected'}
+ *       </div>
+ *
+ *       <div className="motor-control">
+ *         <p>Current Speed: {motorSpeed} RPM</p>
+ *
+ *         <InputNumber
+ *           value={targetSpeed}
+ *           onValueChange={(e) => setTargetSpeed(e.value || 0)}
+ *           min={0}
+ *           max={1000}
+ *           suffix=" RPM"
+ *         />
+ *
+ *         <Button
+ *           label="Set Speed"
+ *           onClick={handleSpeedChange}
+ *           disabled={!connected}
+ *         />
+ *
+ *         <Button
+ *           label="Emergency Stop"
+ *           onClick={handleEmergencyStop}
+ *           severity="danger"
+ *           disabled={!connected}
+ *         />
+ *       </div>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * ### 4. Advanced Pattern: State Management Hook
+ *
+ * Create reusable hooks for common patterns:
+ *
+ * ```tsx
+ * // hooks/useRealtimeValue.ts
+ * import { useContext, useEffect, useState } from 'react';
+ * import { EventEmitterContext } from '@adcops/autocore-react/core/EventEmitterContext';
+ *
+ * export function useRealtimeValue<T>(topic: string, initialValue?: T) {
+ *   const { subscribe, unsubscribe } = useContext(EventEmitterContext);
+ *   const [value, setValue] = useState<T | undefined>(initialValue);
+ *   const [lastUpdate, setLastUpdate] = useState<Date | null>(null);
+ *
+ *   useEffect(() => {
+ *     const subscriptionId = subscribe(topic, (data) => {
+ *       setValue(data.value);
+ *       setLastUpdate(new Date());
+ *     });
+ *
+ *     return () => unsubscribe(subscriptionId);
+ *   }, [topic, subscribe, unsubscribe]);
+ *
+ *   return { value, lastUpdate };
+ * }
+ *
+ * // Usage in component
+ * export const SensorDisplay: React.FC = () => {
+ *   const { value: temperature } = useRealtimeValue<number>('ADS/sensors.temperature');
+ *   const { value: pressure } = useRealtimeValue<number>('ADS/sensors.pressure');
+ *
+ *   return (
+ *     <div>
+ *       <p>Temperature: {temperature?.toFixed(1)}°C</p>
+ *       <p>Pressure: {pressure?.toFixed(2)} bar</p>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * ## Integration with AutoCore Systems
+ *
+ * The EventEmitterContext is designed to work seamlessly with other AutoCore React components:
+ *
+ * ```tsx
+ * // Complete AutoCore application setup
+ * import React from 'react';
+ * import { EventEmitterProvider } from '@adcops/autocore-react/core/EventEmitterContext';
+ * import { AutoCoreTagProvider } from '@adcops/autocore-react/core/AutoCoreTagContext';
+ * import { PrimeReactProvider } from 'primereact/api';
+ * import { tagSpec } from './config/tags';
+ * import { MainInterface } from './components/MainInterface';
+ *
+ * export default function App() {
+ *   return (
+ *     <EventEmitterProvider>
+ *       <AutoCoreTagProvider tags={tagSpec} eagerRead>
+ *         <PrimeReactProvider>
+ *           <MainInterface />
+ *         </PrimeReactProvider>
+ *       </AutoCoreTagProvider>
+ *     </EventEmitterProvider>
+ *   );
+ * }
+ * ```
+ *
+ * ## Best Practices
+ *
+ * 1. **Always Cleanup Subscriptions**: Use the cleanup function returned by useEffect
+ * 2. **Use Meaningful Topic Names**: Follow a hierarchical naming convention (e.g., 'domain/category/specific')
+ * 3. **Handle Connection States**: Always check connection status before invoking backend functions
+ * 4. **Error Handling**: Wrap invoke calls in try-catch blocks
+ * 5. **Type Safety**: Use TypeScript interfaces for payload structures
+ * 6. **Performance**: Avoid subscribing to high-frequency events in render-heavy components
+ *
+ * ## Debugging
+ *
+ * Use the built-in debugging features:
+ *
+ * ```tsx
+ * const { getSubscriptions, state } = useContext(EventEmitterContext);
+ *
+ * // View all subscriptions
+ * console.log('All subscriptions:', getSubscriptions());
+ *
+ * // View subscriptions for specific topic
+ * console.log('Motor subscriptions:', getSubscriptions('ADS/MAIN.motor.speed'));
+ *
+ * // View current state
+ * console.log('EventEmitter state:', state);
+ * ```
+ *
+ * @module core/EventEmitterContext
+ * @version 3.0.41
+ * @author Automated Design Corp.
+ * @since 1.0.0
+ */
+import React from "react";
+import type { ReactNode } from "react";
 import { Hub } from "../hub";
-import { CommandMessageResult } from "../hub/CommandMessage";
+import type { CommandMessageResult } from "../hub/CommandMessage";
 export { Hub };
 /**
  * Represents an event subsription.
@@ -267,3 +559,4 @@ export declare const EventEmitterContext: React.Context<EventEmitterContextType>
 export declare const EventEmitterProvider: React.FC<{
     children: ReactNode;
 }>;
+//# sourceMappingURL=EventEmitterContext.d.ts.map

package/dist/core/EventEmitterContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitterContext.d.ts","sourceRoot":"","sources":["../../src/core/EventEmitterContext.tsx"],"names":[],"mappings":"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"}

package/dist/core/EventEmitterContext.js

@@ -1 +1 @@
-import{jsx as _jsx}from"react/jsx-runtime";import{createContext,useState,useMemo,useCallback,useRef,useEffect}from"react";import{createHub,Hub}from"../hub";export{Hub};let globalSubscriptionId=1;export const EventEmitterContext=createContext({state:{subscriptions:{},nextSubscriptionId:1},dispatch:()=>{},subscribe:()=>0,invoke:async(t,e,s)=>Promise.resolve({data:{},success:!1,error_message:""}),unsubscribe:t=>{},hub:null,getSubscriptions:()=>[],isConnected:()=>!1});export const EventEmitterProvider=({children:t})=>{const[e,s]=useState({subscriptions:{},nextSubscriptionId:1}),r=useMemo((()=>createHub()),[]),c=useRef({});useEffect((()=>{c.current=e.subscriptions}),[e.subscriptions]);const o=useCallback((t=>{const{topic:e,payload:r}=t,o=c.current[e]?.slice()??[];for(const t of o)try{t.callback(r)}catch(t){}s((t=>({...t,eventData:r})))}),[]),n=useCallback(((t,e)=>{const r=++globalSubscriptionId,o=[...c.current[t]??[],{id:r,callback:e}];return c.current[t]=o,s((e=>({...e,subscriptions:{...e.subscriptions,[t]:o},nextSubscriptionId:globalSubscriptionId+1}))),r}),[]),i=useCallback((t=>{const e=c.current;for(const s of Object.keys(e)){const r=e[s].filter((e=>e.id!==t));r.length?e[s]=r:delete e[s]}s((t=>({...t,subscriptions:{...e}})))}),[]);import.meta&&import.meta.hot&&import.meta.hot.dispose((()=>{c.current={}}));const u=useMemo((()=>({state:e,dispatch:o,subscribe:n,unsubscribe:i,invoke:r.invoke,hub:r,getSubscriptions:t=>t?c.current[t]??[]:c.current,isConnected:r.isConnected})),[e,r,o,n,i]);return r.setContext(u),_jsx(EventEmitterContext.Provider,{value:u,children:t})};
+import{jsx as _jsx}from"react/jsx-runtime";import React,{createContext,useState,useMemo,useCallback,useRef,useEffect}from"react";import{createHub,Hub}from"../hub";export{Hub};export const EventEmitterContext=createContext({state:{subscriptions:{},nextSubscriptionId:1},dispatch:()=>{},subscribe:()=>0,invoke:async(e,t,r)=>Promise.resolve({data:{},success:!1,error_message:""}),unsubscribe:e=>{},hub:null,getSubscriptions:()=>[],isConnected:()=>!1});export const EventEmitterProvider=({children:e})=>{const[t,r]=useState({subscriptions:{},nextSubscriptionId:1}),s=useMemo(()=>createHub(),[]),c=useRef(1),n=useRef({});useEffect(()=>{r(e=>({...e,subscriptions:{...n.current},nextSubscriptionId:c.current}))},[]);const o=useCallback(e=>{const{topic:t,payload:s}=e,c=n.current[t]?.slice()??[];for(const e of c)try{e.callback(s)}catch(e){}r(e=>({...e,eventData:s}))},[]),u=useCallback((e,t)=>{const s=c.current++,o={id:s,callback:t},u=[...n.current[e]??[],o];return n.current={...n.current,[e]:u},r(e=>({...e,subscriptions:{...n.current},nextSubscriptionId:c.current})),s},[]),i=useCallback(e=>{const t={};for(const[r,s]of Object.entries(n.current)){const c=s.filter(t=>t.id!==e);c.length>0&&(t[r]=c)}n.current=t,r(e=>({...e,subscriptions:{...t}}))},[]);useEffect(()=>()=>{n.current={},c.current=1},[]),import.meta&&import.meta.hot&&import.meta.hot.dispose(()=>{n.current={},c.current=1});const a=useMemo(()=>({state:t,dispatch:o,subscribe:u,unsubscribe:i,invoke:s.invoke,hub:s,getSubscriptions:e=>e?n.current[e]??[]:n.current,isConnected:s.isConnected}),[t,s,o,u,i]);return s.setContext(a),_jsx(EventEmitterContext.Provider,{value:a,children:e})};

package/dist/core/IndicatorButtonState.d.ts

@@ -19,3 +19,4 @@ export interface IndicatorButtonState {
      */
     isPressed: boolean;
 }
+//# sourceMappingURL=IndicatorButtonState.d.ts.map

package/dist/core/IndicatorButtonState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorButtonState.d.ts","sourceRoot":"","sources":["../../src/core/IndicatorButtonState.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAEzC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAG,OAAO,CAAC;CACvB"}

package/dist/core/IndicatorColor.d.ts

@@ -24,3 +24,4 @@ export declare enum IndicatorColor {
     /** Use for informational buttons. No other meaning allowed. */
     IndicatorInfo = "blue"
 }
+//# sourceMappingURL=IndicatorColor.d.ts.map

package/dist/core/IndicatorColor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorColor.d.ts","sourceRoot":"","sources":["../../src/core/IndicatorColor.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,oBAAY,cAAc;IACtB,8CAA8C;IAC9C,cAAc,UAAU;IACxB,+EAA+E;IAC/E,WAAW,UAAiB;IAC5B,kCAAkC;IAClC,YAAY,SAAS;IACrB,uDAAuD;IACvD,YAAY,QAAQ;IACpB,8DAA8D;IAC9D,eAAe,WAAW;IAC1B,sDAAsD;IACtD,cAAc,QAAgB;IAC9B,yDAAyD;IACzD,gBAAgB,WAAkB;IAClC,wFAAwF;IACxF,gBAAgB,UAAU;IAC1B,4DAA4D;IAC5D,mBAAmB,SAAS;IAC5B,+DAA+D;IAC/D,aAAa,SAAS;CACzB"}

package/dist/core/MaskPatterns.d.ts

@@ -73,3 +73,4 @@ export declare const PrimeReactMaskPatterns: {
     /** International phone number with optional extension */
     readonly PhoneNumberIreland: "+353 99 999 9999 x99999";
 };
+//# sourceMappingURL=MaskPatterns.d.ts.map

package/dist/core/MaskPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaskPatterns.d.ts","sourceRoot":"","sources":["../../src/core/MaskPatterns.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC1B;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;IAIH;;OAEG;;CAEG,CAAC;AAIX;;GAEG;AACH,eAAO,MAAM,sBAAsB;IAC/B,iCAAiC;;IAEjC,+CAA+C;;IAE/C,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;IAEzD,yDAAyD;;CAGnD,CAAC"}

package/dist/core/NumerableTypes.d.ts

@@ -56,3 +56,4 @@ type NumerableFormatNumberOptions = NumerableFormatParams[0][2];
  */
 export type NumerableFormatOptions = NonNullable<NumerableFormatNumberOptions>;
 export {};
+//# sourceMappingURL=NumerableTypes.d.ts.map

package/dist/core/NumerableTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumerableTypes.d.ts","sourceRoot":"","sources":["../../src/core/NumerableTypes.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;GAIG;AACH,KAAK,wBAAwB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC3C,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9B,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9B,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAC/B,GACG,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,GAC/D,CAAC,SAAS;IACR,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9B,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAC/B,GACD,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,GAC1C,CAAC,SAAS;IACR,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CAC/B,GACD,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,GACrB,GAAG,CAAC;AAER;;;;GAIG;AACH,KAAK,oBAAoB,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAEtE;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;CAAE,GACpE,KAAK,CAAC;AAEV;;;GAGG;AACH,KAAK,qBAAqB,GAAG,oBAAoB,CAAC,OAAO,MAAM,CAAC,CAAC;AAGjE;;;;GAIG;AACH,KAAK,4BAA4B,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/core/NumerableTypes.js

@@ -1 +1 @@
-export{};
+import{format}from"numerable";

package/dist/core/PositionContext.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 /**
  * Interface representing the position and scale context of a component within its parent container.
  *
@@ -36,3 +35,4 @@ export interface IPositionContext {
  */
 export declare const DimensionsContext: import("react").Context<IPositionContext>;
 export default DimensionsContext;
+//# sourceMappingURL=PositionContext.d.ts.map

package/dist/core/PositionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PositionContext.d.ts","sourceRoot":"","sources":["../../src/core/PositionContext.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAE/B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,2CAI5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/core/UniqueId.d.ts

@@ -14,3 +14,4 @@
  *
  */
 export declare function UniqueId(): string;
+//# sourceMappingURL=UniqueId.d.ts.map

package/dist/core/UniqueId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueId.d.ts","sourceRoot":"","sources":["../../src/core/UniqueId.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,IAAK,MAAM,CAElC"}

package/dist/core/ValueSimulator.d.ts

@@ -1,4 +1,4 @@
-import { EmitterDispatchFunction } from "./EventEmitterContext";
+import type { EmitterDispatchFunction } from "./EventEmitterContext";
 /**
  * Generates values for simulating data into an HMI.
  * Used for demonstration and development testing.
@@ -69,3 +69,4 @@ export declare class ValueSimulator {
     protected updateTopic(topic: string, value: any): void;
 }
 export default ValueSimulator;
+//# sourceMappingURL=ValueSimulator.d.ts.map

package/dist/core/ValueSimulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueSimulator.d.ts","sourceRoot":"","sources":["../../src/core/ValueSimulator.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE;;;GAGG;AACH,qBAAa,cAAc;IAEvB,SAAS,CAAC,KAAK,EAAE,OAAO,CAAS;IACjC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAQ;IAEhC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAK;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAK;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAK;IAC7B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAK;IAE7B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAC5B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAC5B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAC5B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAE5B,SAAS,CAAC,iBAAiB,EAAG,OAAO,CAAQ;IAC7C,SAAS,CAAC,iBAAiB,EAAG,OAAO,CAAQ;IAC7C,SAAS,CAAC,iBAAiB,EAAG,OAAO,CAAQ;IAC7C,SAAS,CAAC,iBAAiB,EAAG,OAAO,CAAQ;IAE7C,SAAS,CAAC,UAAU,EAAG,MAAM,CAA+B;IAC5D,SAAS,CAAC,UAAU,EAAG,MAAM,CAA+B;IAC5D,SAAS,CAAC,UAAU,EAAG,MAAM,CAAsC;IACnE,SAAS,CAAC,UAAU,EAAG,MAAM,CAAsC;IAEnE,SAAS,CAAC,UAAU,EAAE,MAAM,CAAK;IAEjC,SAAS,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAE5C;;;OAGG;gBACS,QAAQ,EAAE,uBAAuB;IAI7C;;OAEG;IACH,KAAK;IAWL;;OAEG;IACH,IAAI;IAQJ;;OAEG;IACH,SAAS,CAAC,MAAM;IA+BhB;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAYzF;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAOnG;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAQlD;AAED,eAAe,cAAc,CAAC"}

package/dist/core/ValueSimulator.js

@@ -1 +1 @@
-export class ValueSimulator{constructor(i){Object.defineProperty(this,"bBit1",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"bBit2",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iRamp1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iRamp2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fRamp1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fRamp2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iSin1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iSin2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fSin1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fSin2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iRamp1DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iRamp2DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"fRamp1DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"fRamp2DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iSin1Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2}),Object.defineProperty(this,"iSin2Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2}),Object.defineProperty(this,"fSin1Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2/10}),Object.defineProperty(this,"fSin2Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2/10}),Object.defineProperty(this,"intervalId",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"dispatch",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.dispatch=i}start(){0===this.intervalId&&(this.intervalId=setInterval((()=>this.update()),1e3))}stop(){0!==this.intervalId&&(clearInterval(this.intervalId),this.intervalId=0)}update(){this.bBit1=!this.bBit1,this.bBit2=!this.bBit2,[this.iRamp1,this.iRamp1DirectionUp]=this.updateRamp(this.iRamp1,this.iRamp1DirectionUp,32767),[this.iRamp2,this.iRamp2DirectionUp]=this.updateRamp(this.iRamp2,this.iRamp2DirectionUp,32767),[this.fRamp1,this.fRamp1DirectionUp]=this.updateRamp(this.fRamp1,this.fRamp1DirectionUp,3276.7),[this.fRamp2,this.fRamp2DirectionUp]=this.updateRamp(this.fRamp2,this.fRamp2DirectionUp,3276.7),[this.iSin1,this.iSin1Angle]=this.updateSin(this.iSin1,this.iSin1Angle,Math.PI/180,32767),[this.iSin2,this.iSin2Angle]=this.updateSin(this.iSin2,this.iSin2Angle,Math.PI/180,32767),[this.fSin1,this.fSin1Angle]=this.updateSin(this.fSin1,this.fSin1Angle,Math.PI/180,3276.7),[this.fSin2,this.fSin2Angle]=this.updateSin(this.fSin2,this.fSin2Angle,Math.PI/180,3276.7),this.updateTopic("value-simulator-bBit1",this.bBit1),this.updateTopic("value-simulator-bBit2",this.bBit2),this.updateTopic("value-simulator-iRamp1",this.iRamp1),this.updateTopic("value-simulator-iRamp2",this.iRamp2),this.updateTopic("value-simulator-fRamp1",this.fRamp1),this.updateTopic("value-simulator-fRamp2",this.fRamp2),this.updateTopic("value-simulator-iSin1",this.iSin1),this.updateTopic("value-simulator-iSin2",this.iSin2),this.updateTopic("value-simulator-fSin1",this.fSin1),this.updateTopic("value-simulator-fSin2",this.fSin2)}updateRamp(i,e,t){if(e){if(++i>=t)return[i,!1]}else if(--i<=0)return[i,!0];return[i,e]}updateSin(i,e,t,a){return e+=t,[Math.sin(e)*a,e]}updateTopic(i,e){this.dispatch({topic:i,payload:e})}}export default ValueSimulator;
+export class ValueSimulator{constructor(i){Object.defineProperty(this,"bBit1",{enumerable:!0,configurable:!0,writable:!0,value:!1}),Object.defineProperty(this,"bBit2",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iRamp1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iRamp2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fRamp1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fRamp2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iSin1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iSin2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fSin1",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"fSin2",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"iRamp1DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iRamp2DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"fRamp1DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"fRamp2DirectionUp",{enumerable:!0,configurable:!0,writable:!0,value:!0}),Object.defineProperty(this,"iSin1Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2}),Object.defineProperty(this,"iSin2Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2}),Object.defineProperty(this,"fSin1Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2/10}),Object.defineProperty(this,"fSin2Angle",{enumerable:!0,configurable:!0,writable:!0,value:Math.random()*Math.PI*2/10}),Object.defineProperty(this,"intervalId",{enumerable:!0,configurable:!0,writable:!0,value:0}),Object.defineProperty(this,"dispatch",{enumerable:!0,configurable:!0,writable:!0,value:void 0}),this.dispatch=i}start(){0===this.intervalId&&(this.intervalId=setInterval(()=>this.update(),1e3))}stop(){0!==this.intervalId&&(clearInterval(this.intervalId),this.intervalId=0)}update(){this.bBit1=!this.bBit1,this.bBit2=!this.bBit2,[this.iRamp1,this.iRamp1DirectionUp]=this.updateRamp(this.iRamp1,this.iRamp1DirectionUp,32767),[this.iRamp2,this.iRamp2DirectionUp]=this.updateRamp(this.iRamp2,this.iRamp2DirectionUp,32767),[this.fRamp1,this.fRamp1DirectionUp]=this.updateRamp(this.fRamp1,this.fRamp1DirectionUp,3276.7),[this.fRamp2,this.fRamp2DirectionUp]=this.updateRamp(this.fRamp2,this.fRamp2DirectionUp,3276.7),[this.iSin1,this.iSin1Angle]=this.updateSin(this.iSin1,this.iSin1Angle,Math.PI/180,32767),[this.iSin2,this.iSin2Angle]=this.updateSin(this.iSin2,this.iSin2Angle,Math.PI/180,32767),[this.fSin1,this.fSin1Angle]=this.updateSin(this.fSin1,this.fSin1Angle,Math.PI/180,3276.7),[this.fSin2,this.fSin2Angle]=this.updateSin(this.fSin2,this.fSin2Angle,Math.PI/180,3276.7),this.updateTopic("value-simulator-bBit1",this.bBit1),this.updateTopic("value-simulator-bBit2",this.bBit2),this.updateTopic("value-simulator-iRamp1",this.iRamp1),this.updateTopic("value-simulator-iRamp2",this.iRamp2),this.updateTopic("value-simulator-fRamp1",this.fRamp1),this.updateTopic("value-simulator-fRamp2",this.fRamp2),this.updateTopic("value-simulator-iSin1",this.iSin1),this.updateTopic("value-simulator-iSin2",this.iSin2),this.updateTopic("value-simulator-fSin1",this.fSin1),this.updateTopic("value-simulator-fSin2",this.fSin2)}updateRamp(i,e,t){if(e){if(++i>=t)return[i,!1]}else if(--i<=0)return[i,!0];return[i,e]}updateSin(i,e,t,a){return e+=t,[Math.sin(e)*a,e]}updateTopic(i,e){this.dispatch({topic:i,payload:e})}}export default ValueSimulator;

package/dist/core/hoc.d.ts

@@ -29,3 +29,4 @@ export type HocAddSubscriptionProps = {
  * @returns A component that subscribes to the given topic and updates its specified prop with the received data.
  */
 export declare function hocAddSubscription<P extends HocAddSubscriptionProps>(WrappedComponent: React.ComponentType<P>, topic: string, propName: keyof P): (props: Omit<P, keyof HocAddSubscriptionProps>) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=hoc.d.ts.map

package/dist/core/hoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoc.d.ts","sourceRoot":"","sources":["../../src/core/hoc.tsx"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AAGH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAG/D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IAClC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAGF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,uBAAuB,EAChE,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,CAAC,IAED,OAAO,IAAI,CAAC,CAAC,EAAE,MAAM,uBAAuB,CAAC,6CAchE"}

package/dist/core/hoc.js

@@ -1 +1 @@
-import{jsx as _jsx}from"react/jsx-runtime";import{useState,useEffect,useContext}from"react";import{EventEmitterContext}from"./EventEmitterContext";export function hocAddSubscription(t,e,r){return function(n){const[o,s]=useState(),{subscribe:u,unsubscribe:i}=useContext(EventEmitterContext);useEffect((()=>{const t=u(e,s);return()=>i(t)}),[e,u,i]);return _jsx(t,{...n,...{[r]:o}})}}
+import{jsx as _jsx}from"react/jsx-runtime";import React,{useState,useEffect,useContext}from"react";import{EventEmitterContext}from"./EventEmitterContext";export function hocAddSubscription(t,e,r){return function(n){const[o,s]=useState(),{subscribe:u,unsubscribe:c}=useContext(EventEmitterContext);useEffect(()=>{const t=u(e,s);return()=>c(t)},[e,u,c]);return _jsx(t,{...n,...{[r]:o}})}}

package/dist/hooks/adsHooks.d.ts

@@ -143,3 +143,4 @@ export declare function useAdsWriteScaledValue(symbolName: string, scale: number
  * ```
  */
 export declare function useAdsTapValue(symbolName: string): () => Promise<void>;
+//# sourceMappingURL=adsHooks.d.ts.map

package/dist/hooks/adsHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adsHooks.d.ts","sourceRoot":"","sources":["../../src/hooks/adsHooks.tsx"],"names":[],"mappings":"AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,qBAAqB,GAC9B,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,EAC7C,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,UAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAM,SAuDnC,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,IAMjC,OAAO,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,mBAO1D;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAKnD,MAAM,mBAa1C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CActE"}

package/dist/hooks/adsHooks.js

@@ -1 +1 @@
-import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";function sleep(e){return new Promise((t=>setTimeout(t,e)))}export const useAdsRegisterSymbols=(e,t,n={})=>{const{invoke:r,subscribe:s,unsubscribe:o,isConnected:u}=useContext(EventEmitterContext),c=useRef([]),a=useRef(!0);return useEffect((()=>{a.current=!0;const i=async()=>{for(const[o,u]of Object.entries(t))try{const t=n[o]?{symbol_name:u,options:n[o]}:{symbol_name:u};await r("ADS","register_symbol",t);const i=s(`ADS/${u}`,(t=>{if(a.current){const n=e[o];n&&n(t.value)}}));c.current.push(i)}catch(e){}await r("ADS","refresh",{})};if(u())i();else{let e=s("HUB/connected",(()=>{i(),o(e)}));c.current.push(e)}return()=>{a.current=!1,c.current.forEach((e=>o(e))),c.current=[]}}),[]),null};export function useAdsWriteValue(e){const{invoke:t}=useContext(EventEmitterContext);return async n=>{try{await t("ADS","write_value",{symbol_name:e,value:n})}catch(e){}}}export function useAdsWriteScaledValue(e,t,n){const{invoke:r}=useContext(EventEmitterContext);return useCallback((async s=>{const o=(s-n)/t;try{await r("ADS","write_value",{symbol_name:e,value:o})}catch(e){}}),[e,t,n,r])}export function useAdsTapValue(e){const{invoke:t}=useContext(EventEmitterContext),n="write_value";return async()=>{try{await t("ADS",n,{symbol_name:e,value:!0}),await sleep(300),await t("ADS",n,{symbol_name:e,value:!1})}catch(e){}}}
+import{useContext,useRef,useEffect,useCallback}from"react";import{EventEmitterContext}from"../core/EventEmitterContext";function sleep(e){return new Promise(t=>setTimeout(t,e))}export const useAdsRegisterSymbols=(e,t,n={})=>{const{invoke:r,subscribe:s,unsubscribe:o,isConnected:u}=useContext(EventEmitterContext),c=useRef([]),a=useRef(!0);return useEffect(()=>{a.current=!0;const i=async()=>{for(const[o,u]of Object.entries(t))try{const t=n[o]?{symbol_name:u,options:n[o]}:{symbol_name:u};await r("ADS","register_symbol",t);const i=s(`ADS/${u}`,t=>{if(a.current){const n=e[o];n&&n(t.value)}});c.current.push(i)}catch(e){}await r("ADS","refresh",{})};if(u())i();else{let e=s("HUB/connected",()=>{i(),o(e)});c.current.push(e)}return()=>{a.current=!1,c.current.forEach(e=>o(e)),c.current=[]}},[]),null};export function useAdsWriteValue(e){const{invoke:t}=useContext(EventEmitterContext);return async n=>{try{await t("ADS","write_value",{symbol_name:e,value:n})}catch(e){}}}export function useAdsWriteScaledValue(e,t,n){const{invoke:r}=useContext(EventEmitterContext);return useCallback(async s=>{const o=(s-n)/t;try{await r("ADS","write_value",{symbol_name:e,value:o})}catch(e){}},[e,t,n,r])}export function useAdsTapValue(e){const{invoke:t}=useContext(EventEmitterContext),n="write_value";return async()=>{try{await t("ADS",n,{symbol_name:e,value:!0}),await sleep(300),await t("ADS",n,{symbol_name:e,value:!1})}catch(e){}}}