@adcops/autocore-react 3.0.40 → 3.1.5

package/dist/components/ProgressBarWithValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBarWithValue.d.ts","sourceRoot":"","sources":["../../src/components/ProgressBarWithValue.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,4BAA4B,CAAC;AAEpC,UAAU,yBAAyB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAG,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA0BpE,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/ProgressBarWithValue.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{ProgressBar}from"primereact/progressbar";import"./ProgressBarWithValue.css";export const ProgressBarWithValue=({value:r,max:e,label:s})=>{let a=r,t=!1;return void 0!==e&&(e>0?a=r/e*100:(a=0,t=!0)),_jsxs("div",{className:"custom-progress-bar",children:[_jsx(ProgressBar,{showValue:!1,value:a,mode:t?"indeterminate":"determinate"}),_jsxs("div",{className:"centered-value",children:[s?`${s} `:""," ",r," ",e?`of ${e}`:""]})]})};export default ProgressBarWithValue;
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React from"react";import{ProgressBar}from"primereact/progressbar";import"./ProgressBarWithValue.css";export const ProgressBarWithValue=({value:r,max:e,label:s})=>{let a=r,t=!1;return void 0!==e&&(e>0?a=r/e*100:(a=0,t=!0)),_jsxs("div",{className:"custom-progress-bar",children:[_jsx(ProgressBar,{showValue:!1,value:a,mode:t?"indeterminate":"determinate"}),_jsxs("div",{className:"centered-value",children:[s?`${s} `:""," ",r," ",e?`of ${e}`:""]})]})};export default ProgressBarWithValue;

package/dist/components/TextInput.d.ts

@@ -1,111 +1,70 @@
 import React from "react";
-import { InputTextProps } from 'primereact/inputtext';
-import { EventEmitterContext } from "../core/EventEmitterContext.js";
-import { KeyFilterType } from "primereact/keyfilter";
-/**
- * Properties of the component.
- */
-interface TextInputProps extends Omit<InputTextProps, "prefix"> {
-    /**
-     * The label for the field.
-     */
-    label: React.ReactNode | undefined;
-    /**
-     * The value for the field.
-     */
-    value: string | undefined;
-    /**
-     * Optional filter for key entry. Not a validator, but won't accept keystrokes outside the filter.
-     * @type {RegExp | "pint" | "int" | "pnum" | "money" | "num" | "hex" | "email" | "alpha" | "alphanum"}
-     */
-    keyFilter: KeyFilterType | undefined;
-    /**
-     * An optional prefix before the data entry field.
-     */
-    prefix: React.ReactNode | undefined;
-    /**
-     * An optional suffix after the data entry field.
-     */
-    suffix: React.ReactNode | undefined;
-    /**
-     * A small, advisory text below the field.
-     */
-    description: React.ReactNode | undefined;
-    /**
-     * If true, all functions of the field will be disabled.
-     */
-    disabled: boolean | undefined;
-    /** Topic on which the value will be dispatched through the user interfave on successful data entry. */
-    dispatchTopic: string | undefined;
-    /**
-     * Placeholder string to display if the value is empty.
-     */
-    placeholder: string | undefined;
+import { type InputTextProps } from "primereact/inputtext";
+import type { KeyFilterType } from "primereact/keyfilter";
+interface TextInputProps extends Omit<InputTextProps, "prefix" | "value" | "onChange"> {
+    /** The label for the field (shown in an addon). */
+    label?: React.ReactNode;
+    /** Controlled value from parent. */
+    value?: string;
     /**
-     * The user has accepted a new value.
-     * @param newValue New value accepted by the user.
+     * PrimeReact key filter (lowercase) or RegExp.
+     * Examples: "pint" | "int" | "pnum" | "money" | "num" | "hex" | "email" | "alpha" | "alphanum"
      */
+    keyfilter?: KeyFilterType;
+    /** Optional prefix addon before the input. */
+    prefix?: React.ReactNode;
+    /** Optional suffix addon after the input. */
+    suffix?: React.ReactNode;
+    /** Small, advisory text below the field. */
+    description?: React.ReactNode;
+    /** Disable entire control. */
+    disabled?: boolean;
+    /** Placeholder string. */
+    placeholder?: string;
+    /** Called when the user ACCEPTS a new value (Enter or ✔). */
     onValueChanged?(newValue: string): void;
-    /** Regular expression used to validate the value before it is broadcast */
-    validator: RegExp;
+    /** Regex validation used on accept (not on each keystroke). */
+    validator?: RegExp;
 }
 /**
- * State variables of the component.
+ * A styled text input field with support for labels, prefixes/suffixes,
+ * validation, key filters, and accept/reset actions.
+ *
+ * This component wraps PrimeReact's <InputText> in a p-inputgroup with
+ * optional ✔ and ✖ buttons for committing or cancelling edits.
+ *
+ * Features:
+ * - Label, prefix, and suffix addons for context
+ * - Optional `keyfilter` for keystroke-level restrictions (PrimeReact presets or RegExp)
+ * - Optional `validator` RegExp applied when accepting a value
+ * - Calls `onValueChanged(newValue)` only when the user accepts (Enter key or ✔ button)
+ * - Escape key or ✖ button reverts to the last accepted value
+ * - Controlled input: always provide a string `value` (defaults to `""`)
+ *
+ * ## Example
+ *
+ * ```tsx
+ * import { useState } from "react";
+ * import { TextInput } from "./TextInput";
+ *
+ * export function ExampleForm() {
+ *   const [partNumber, setPartNumber] = useState("ADC-0001");
+ *
+ *   return (
+ *     <TextInput
+ *       label="Part Number"
+ *       value={partNumber}
+ *       onValueChanged={setPartNumber}
+ *       placeholder="Enter part number"
+ *       keyfilter="alphanum"
+ *       validator={/^[A-Z0-9-]+$/}
+ *       description="Use only uppercase letters, digits, and dashes."
+ *       prefix={<i className="pi pi-tag" />}
+ *     />
+ *   );
+ * }
+ * ```
  */
-interface TextInputState {
-    entryValue: string | undefined;
-    isValid: boolean;
-    editing: boolean;
-}
-/**
- * A convenient field with all the usual features of inputing values.
- * Wraps the common features of use of a InputText, p-inputgroup, some icon buttons,
- * accepting and rejecting values and keyboard management.
- */
-export declare class TextInput extends React.Component<TextInputProps, TextInputState> {
-    static contextType: React.Context<import("../core/EventEmitterContext.js").EventEmitterContextType>;
-    context: React.ContextType<typeof EventEmitterContext>;
-    /**
-     * Default properties for the component.
-     */
-    static defaultProps: {
-        label: string;
-        value: undefined;
-        keyFilter: undefined;
-        writeTopic: undefined;
-        onValueChanged: undefined;
-        description: undefined;
-        prefix: undefined;
-        suffix: undefined;
-        disabled: boolean;
-        dispatchTopic: undefined;
-        placeholder: undefined;
-        validator: undefined;
-    };
-    /**
-     *
-     * @param {FooterViewProps} props
-     */
-    constructor(props: TextInputProps);
-    /**
-     * The component has been loaded into the DOM.
-     */
-    componentDidMount(): void;
-    componentDidUpdate(prevProps: TextInputProps): void;
-    /**
-     * Check the new value against the validator RegEx, if one was specified.
-     * @param val The new value.
-     * @returns True if no validator specified or the value is valid, false if not valid.
-     */
-    private validateValue;
-    /**
-     * The user has elected to accept the input value. Validate and store, if valid.
-     */
-    private onAcceptValue;
-    /**
-     * The user wishes to reset/cancel the previous value.
-     */
-    private onResetValue;
-    render(): import("react/jsx-runtime").JSX.Element;
-}
+export declare const TextInput: React.FC<TextInputProps>;
 export {};
+//# sourceMappingURL=TextInput.d.ts.map

package/dist/components/TextInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../../src/components/TextInput.tsx"],"names":[],"mappings":"AASA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,UAAU,cAAe,SAAQ,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;IAClF,mDAAmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAExB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAE1B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAqG9C,CAAC"}

package/dist/components/TextInput.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React from"react";import{InputText}from"primereact/inputtext";import{Button}from"primereact/button";import{EventEmitterContext}from"../core/EventEmitterContext.js";export class TextInput extends React.Component{constructor(t){super(t),Object.defineProperty(this,"validateValue",{enumerable:!0,configurable:!0,writable:!0,value:t=>void 0===this.props.validator||null===this.props.validator||this.props.validator.test(t)}),this.state={entryValue:t.value,isValid:void 0!==t.value&&this.validateValue(t.value),editing:!1}}componentDidMount(){}componentDidUpdate(t){t.value!==this.props.value&&this.setState({entryValue:this.props.value,editing:!1})}onAcceptValue(){void 0!==this.state.entryValue&&this.validateValue(this.state.entryValue)?(this.setState({isValid:!0,editing:!1}),this.props.onValueChanged&&this.props.onValueChanged(this.state.entryValue),void 0!==this.props.dispatchTopic&&this.context.dispatch({topic:this.props.dispatchTopic,payload:this.state.entryValue})):this.setState({isValid:!1})}onResetValue(){this.setState({entryValue:this.props.value,isValid:void 0!==this.props.value&&this.validateValue(this.props.value),editing:!1})}render(){const{prefix:t,...e}=this.props;return _jsxs("div",{children:[_jsxs("div",{className:"p-inputgroup flex-1",children:[_jsx("span",{className:"p-inputgroup-addon",children:this.props.label}),void 0!==this.props.prefix&&_jsx("span",{className:"p-inputgroup-addon",children:this.props.prefix}),_jsx(InputText,{...e,keyfilter:this.props.keyFilter,placeholder:this.props.placeholder,value:this.state.entryValue,onChange:t=>{this.setState({entryValue:t.target.value,editing:!0})},className:this.state.isValid?"":"p-invalid",onKeyDown:t=>{"Enter"===t.key?this.onAcceptValue():"Escape"===t.key&&this.onResetValue()},disabled:this.props.disabled}),void 0!==this.props.suffix&&_jsx("span",{className:"p-inputgroup-addon",children:this.props.suffix}),_jsx(Button,{icon:"pi pi-check",disabled:this.props.disabled||!this.state.editing,className:"p-button-success",onClick:()=>this.onAcceptValue(),visible:this.state.editing}),_jsx(Button,{icon:"pi pi-times",disabled:this.props.disabled||!this.state.editing,className:"p-button-danger",onClickCapture:()=>this.onResetValue(),visible:this.state.editing})]}),void 0!==this.props.description&&_jsx("small",{children:this.props.description})]})}}Object.defineProperty(TextInput,"contextType",{enumerable:!0,configurable:!0,writable:!0,value:EventEmitterContext}),Object.defineProperty(TextInput,"defaultProps",{enumerable:!0,configurable:!0,writable:!0,value:{label:"",value:void 0,keyFilter:void 0,writeTopic:void 0,onValueChanged:void 0,description:void 0,prefix:void 0,suffix:void 0,disabled:!1,dispatchTopic:void 0,placeholder:void 0,validator:void 0}});
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useEffect,useMemo,useState}from"react";import{InputText}from"primereact/inputtext";import{Button}from"primereact/button";function toStr(e){return e??""}export const TextInput=e=>{const{label:t,value:s,keyfilter:n,prefix:a,suffix:i,description:o,disabled:r=!1,placeholder:c,onValueChanged:l,validator:u,...p}=e,[d,m]=useState(toStr(s)),[x,f]=useState(!1),[j,v]=useState(!s||h(s,u));function h(e,t){return!t||t.test(e)}function _(){const e=d,t=h(e,u);v(t),t&&(f(!1),l?.(e))}function b(){const e=toStr(s);m(e),f(!1),v(!e||h(e,u))}useEffect(()=>{m(toStr(s)),f(!1),v(!s||h(s,u))},[s,u]);const N=useMemo(()=>toStr(d),[d]);return _jsxs("div",{children:[_jsxs("div",{className:"p-inputgroup flex-1",children:[_jsx("span",{className:"p-inputgroup-addon",children:t}),void 0!==a&&_jsx("span",{className:"p-inputgroup-addon",children:a}),_jsx(InputText,{...p,keyfilter:n,placeholder:c,value:N,onChange:e=>{m(e.target.value),f(!0)},className:j?p.className??"":`${p.className??""} p-invalid`,onKeyDown:e=>{"Enter"===e.key?_():"Escape"===e.key&&b()},disabled:r}),void 0!==i&&_jsx("span",{className:"p-inputgroup-addon",children:i}),_jsx(Button,{icon:"pi pi-check",disabled:r||!x,className:"p-button-success",onClick:_,visible:x}),_jsx(Button,{icon:"pi pi-times",disabled:r||!x,className:"p-button-danger",onClick:b,visible:x})]}),void 0!==o&&_jsx("small",{children:o})]})};

package/dist/components/ToggleGroup.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { SelectButtonProps } from 'primereact/selectbutton';
+import { type SelectButtonProps } from 'primereact/selectbutton';
 import { IndicatorColor } from "../core/IndicatorColor";
 export { IndicatorColor };
 import { ActionMode } from '../core/ActionMode';
@@ -20,3 +20,4 @@ export interface ToggleGroupProps extends SelectButtonProps {
 }
 export declare const ToggleGroup: React.FC<ToggleGroupProps>;
 export default ToggleGroup;
+//# sourceMappingURL=ToggleGroup.d.ts.map

package/dist/components/ToggleGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleGroup.d.ts","sourceRoot":"","sources":["../../src/components/ToggleGroup.tsx"],"names":[],"mappings":"AASA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI/E,OAAO,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAC,cAAc,EAAC,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,UAAU,EAAC,CAAC;AAMpB,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAyRlD,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/components/ToggleGroup.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{useState,useEffect,useContext}from"react";import{SelectButton}from"primereact/selectbutton";import{EventEmitterContext}from"../core/EventEmitterContext";import{IndicatorColor}from"../core/IndicatorColor";export{IndicatorColor};import{ActionMode}from"../core/ActionMode";export{ActionMode};import clsx from"clsx";export const ToggleGroup=({label:o,topic:t,onColor:e,offColor:n,command:r,commandTopic:i,commandArgs:l,disableTopic:s,invisibleTopic:a,actionMode:c,invert:d,onValueChanged:u,...p})=>{const[m]=useState((()=>`toggleGroup-${Math.random().toString(36).substr(2,9)}`)),[f,g]=useState(void 0),[v,h]=useState(!1),[b,x]=useState(!1),[C,I]=useState(!1),y=useContext(EventEmitterContext);useEffect((()=>(t&&y.subscribe(t,A),s&&y.subscribe(s,j),a&&y.subscribe(a,M),()=>{})),[t,s,a]);const A=o=>{g(o)},j=o=>{h(o)},M=o=>{x(o)},E=()=>{C||(I(!0),c!==ActionMode.Tap&&c!==ActionMode.Pressed||T(!0))},S=()=>{C&&(I(!1),c===ActionMode.Tap?T(!1):c===ActionMode.Released&&T(!0))},T=o=>{if(r&&r.length>0){const t={topic:i,value:o,...l};y.dispatch({topic:r,payload:t})}};let $=f;void 0!==p.value&&($=p.value);let _=((o,t,e)=>{if(!t||0===t.length)return IndicatorColor.IndicatorInvalid;let n=Array.isArray(e)?e:void 0!==e?[e]:[IndicatorColor.IndicatorInvalid],r=typeof o;if("boolean"===r)return o?n[0]:n.length>1?n[1]:n[0];if("number"===r&&t.length>o){if(n.length>o){return n[o]}return n[0]}if("string"===r){let e=t.indexOf(o);return-1!==e&&e<n.length?n[e]:n[0]}return null!=e?Array.isArray(e)?e[0]:e:IndicatorColor.IndicatorInvalid})($,p.options,e);void 0===$&&(_=IndicatorColor.IndicatorInvalid);const N=void 0!==p.options&&null!==p.options&&void 0!==p.options.length&&p.options.length>2,G=`${m}-togglegroup-selectbutton-container`;return _jsxs("div",{className:"flex",children:[_jsx("style",{children:`\n                ${void 0!==n?`\n                    .${G} .p-selectbutton .p-button {\n                        background-color: ${n};\n                    }\n                `:""}\n                .${G} .p-selectbutton .p-button.p-highlight {\n                    background-color: ${_} !important;\n                    border-color: ${_} !important;\n                }\n            `}),_jsx("div",{className:G,children:_jsxs("div",{className:"p-inputgroup",children:[_jsx("span",{className:"p-inputgroup-addon",style:{flexGrow:1},children:o}),_jsx(SelectButton,{...p,options:p.options,disabled:v||p.disabled,multiple:N,className:clsx(m,p.className,{"p-invalid":void 0===p.value}),style:b?{display:"none"}:{},value:((o,t)=>{if(null==t||0===t.length)return;let e=typeof o;if("boolean"==e){return o&&t.length>1?t[1]:t[0]}if("number"==e){let e=o;if(void 0!==e&&e<t.length)return t[e]}else if("string"==e)return o})($,p.options),allowEmpty:!1,onMouseDown:E,onTouchStart:E,onMouseUp:S,onTouchEnd:S,onChange:o=>(o=>{if(null!=u)if(void 0===p.options||null===p.options||0===p.options.length)u(!!N&&0);else{let t=0;for(let e=0;e<p.options.length;++e)if(o===p.options[e]){t=e;break}u(N?t:t>0)}})(o.value)})]})})]})};export default ToggleGroup;
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useEffect,useContext}from"react";import{SelectButton}from"primereact/selectbutton";import{EventEmitterContext}from"../core/EventEmitterContext";import{IndicatorColor}from"../core/IndicatorColor";export{IndicatorColor};import{ActionMode}from"../core/ActionMode";export{ActionMode};import clsx from"clsx";export const ToggleGroup=({label:o,topic:t,onColor:e,offColor:n,command:r,commandTopic:i,commandArgs:l,disableTopic:s,invisibleTopic:a,actionMode:c,invert:d,onValueChanged:u,...p})=>{const[m]=useState(()=>`toggleGroup-${Math.random().toString(36).substr(2,9)}`),[f,g]=useState(void 0),[v,h]=useState(!1),[b,x]=useState(!1),[C,I]=useState(!1),y=useContext(EventEmitterContext);useEffect(()=>(t&&y.subscribe(t,A),s&&y.subscribe(s,j),a&&y.subscribe(a,M),()=>{}),[t,s,a]);const A=o=>{g(o)},j=o=>{h(o)},M=o=>{x(o)},E=()=>{C||(I(!0),c!==ActionMode.Tap&&c!==ActionMode.Pressed||T(!0))},S=()=>{C&&(I(!1),c===ActionMode.Tap?T(!1):c===ActionMode.Released&&T(!0))},T=o=>{if(r&&r.length>0){const t={topic:i,value:o,...l};y.dispatch({topic:r,payload:t})}};let $=f;void 0!==p.value&&($=p.value);let _=((o,t,e)=>{if(!t||0===t.length)return IndicatorColor.IndicatorInvalid;let n=Array.isArray(e)?e:void 0!==e?[e]:[IndicatorColor.IndicatorInvalid],r=typeof o;if("boolean"===r)return o?n[0]:n.length>1?n[1]:n[0];if("number"===r&&t.length>o){if(n.length>o){return n[o]}return n[0]}if("string"===r){let e=t.indexOf(o);return-1!==e&&e<n.length?n[e]:n[0]}return null!=e?Array.isArray(e)?e[0]:e:IndicatorColor.IndicatorInvalid})($,p.options,e);void 0===$&&(_=IndicatorColor.IndicatorInvalid);const N=void 0!==p.options&&null!==p.options&&void 0!==p.options.length&&p.options.length>2,G=`${m}-togglegroup-selectbutton-container`;return _jsxs("div",{className:"flex",children:[_jsx("style",{children:`\n                ${void 0!==n?`\n                    .${G} .p-selectbutton .p-button {\n                        background-color: ${n};\n                    }\n                `:""}\n                .${G} .p-selectbutton .p-button.p-highlight {\n                    background-color: ${_} !important;\n                    border-color: ${_} !important;\n                }\n            `}),_jsx("div",{className:G,children:_jsxs("div",{className:"p-inputgroup",children:[_jsx("span",{className:"p-inputgroup-addon",style:{flexGrow:1},children:o}),_jsx(SelectButton,{...p,options:p.options,disabled:v||p.disabled,multiple:N,className:clsx(m,p.className,{"p-invalid":void 0===p.value}),style:b?{display:"none"}:{},value:((o,t)=>{if(null==t||0===t.length)return;let e=typeof o;if("boolean"==e){return o&&t.length>1?t[1]:t[0]}if("number"==e){let e=o;if(void 0!==e&&e<t.length)return t[e]}else if("string"==e)return o})($,p.options),allowEmpty:!1,onMouseDown:E,onTouchStart:E,onMouseUp:S,onTouchEnd:S,onChange:o=>(o=>{if(null!=u)if(void 0===p.options||null===p.options||0===p.options.length)u(!!N&&0);else{let t=0;for(let e=0;e<p.options.length;++e)if(o===p.options[e]){t=e;break}u(N?t:t>0)}})(o.value)})]})})]})};export default ToggleGroup;

package/dist/components/ValueDisplay.d.ts

@@ -1,5 +1,5 @@
 import { Component } from 'react';
-import { EventEmitterContextType } from '../core/EventEmitterContext';
+import { type EventEmitterContextType } from '../core/EventEmitterContext';
 import type { NumerableFormatOptions } from '../core/NumerableTypes';
 /**
  * Properties of the ValueDisplay component.
@@ -142,4 +142,5 @@ declare class ValueDisplay extends Component<Props, State> {
      */
     render(): import("react/jsx-runtime").JSX.Element;
 }
-export { ValueDisplay, NumerableFormatOptions };
+export { ValueDisplay, type NumerableFormatOptions };
+//# sourceMappingURL=ValueDisplay.d.ts.map

package/dist/components/ValueDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueDisplay.d.ts","sourceRoot":"","sources":["../../src/components/ValueDisplay.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlC,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAGhG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE;;GAEG;AACH,UAAU,KAAK;IACX;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAGjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,KAAK;IACX,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,cAAM,YAAa,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IAE9C,2EAA2E;IAC3E,MAAM,CAAC,WAAW,mDAAuB;IAGzC,sFAAsF;IACtF,SAAS,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnD;;;OAGG;gBACS,KAAK,EAAE,KAAK;IAQxB;;;OAGG;IACH,iBAAiB;IAUjB;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,KAAK;IAQnC;;;OAGG;IACH,oBAAoB;IAOpB;;;;OAIG;IACH,MAAM;CAiCT;AAED,OAAO,EAAE,YAAY,EAAE,KAAK,sBAAsB,EAAE,CAAC"}

package/dist/components/ValueDisplay.js

@@ -1 +1 @@
-import{jsx as _jsx}from"react/jsx-runtime";import{Component}from"react";import{format as numerableFormat}from"numerable";import clsx from"clsx";import{EventEmitterContext}from"../core/EventEmitterContext";class ValueDisplay extends Component{constructor(e){super(e),Object.defineProperty(this,"unsubscribeTopicId",{enumerable:!0,configurable:!0,writable:!0,value:null}),this.state={subscribedValue:e.value,fontSize:"100%"}}componentDidMount(){const{topic:e}=this.props;if(e){const{subscribe:t}=this.context;this.unsubscribeTopicId=t(e,(e=>{this.setState({subscribedValue:e})}))}}componentDidUpdate(e){this.props.value!==e.value&&this.setState({subscribedValue:this.props.value})}componentWillUnmount(){if(this.unsubscribeTopicId){const{unsubscribe:e}=this.context;e(this.unsubscribeTopicId)}}render(){const{x:e,y:t,width:i,height:s,format:o,formatOptions:r,className:n,useAbsolutePositioning:a}=this.props,{subscribedValue:l,fontSize:u}=this.state,{scale:c,xOffset:p,yOffset:b}=this.context,m={position:a?"absolute":"relative",display:a?"":"inline-block",verticalAlign:"middle",fontSize:u&&c>1?100*c+"%":u,top:a&&t?`${b+c*t}px`:void 0,left:a&&e?`${p+c*e}px`:void 0,width:i?i*c+"px":void 0,height:s?s*c+"px":void 0,lineHeight:s?s*c+"px":void 0,whiteSpace:"nowrap"};let d;return d="number"==typeof l||"string"==typeof l&&!isNaN(Number(l))?numerableFormat(l,o,r):l,_jsx("div",{className:clsx(n),style:m,children:d})}}Object.defineProperty(ValueDisplay,"contextType",{enumerable:!0,configurable:!0,writable:!0,value:EventEmitterContext});export{ValueDisplay};
+import{jsx as _jsx}from"react/jsx-runtime";import{Component}from"react";import{format as numerableFormat}from"numerable";import clsx from"clsx";import{EventEmitterContext}from"../core/EventEmitterContext";class ValueDisplay extends Component{constructor(e){super(e),Object.defineProperty(this,"unsubscribeTopicId",{enumerable:!0,configurable:!0,writable:!0,value:null}),this.state={subscribedValue:e.value,fontSize:"100%"}}componentDidMount(){const{topic:e}=this.props;if(e){const{subscribe:t}=this.context;this.unsubscribeTopicId=t(e,e=>{this.setState({subscribedValue:e})})}}componentDidUpdate(e){this.props.value!==e.value&&this.setState({subscribedValue:this.props.value})}componentWillUnmount(){if(this.unsubscribeTopicId){const{unsubscribe:e}=this.context;e(this.unsubscribeTopicId)}}render(){const{x:e,y:t,width:i,height:s,format:o,formatOptions:r,className:n,useAbsolutePositioning:a}=this.props,{subscribedValue:l,fontSize:u}=this.state,{scale:c,xOffset:p,yOffset:b}=this.context,m={position:a?"absolute":"relative",display:a?"":"inline-block",verticalAlign:"middle",fontSize:u&&c>1?100*c+"%":u,top:a&&t?`${b+c*t}px`:void 0,left:a&&e?`${p+c*e}px`:void 0,width:i?i*c+"px":void 0,height:s?s*c+"px":void 0,lineHeight:s?s*c+"px":void 0,whiteSpace:"nowrap"};let d;return d="number"==typeof l||"string"==typeof l&&!isNaN(Number(l))?numerableFormat(l,o,r):l,_jsx("div",{className:clsx(n),style:m,children:d})}}Object.defineProperty(ValueDisplay,"contextType",{enumerable:!0,configurable:!0,writable:!0,value:EventEmitterContext});export{ValueDisplay};

package/dist/components/ValueIndicator.d.ts

@@ -63,4 +63,5 @@ export declare class ValueIndicator extends Component<ValueIndicatorProps, Value
     render(): import("react/jsx-runtime").JSX.Element;
 }
 export default ValueIndicator;
-export { NumerableFormatOptions };
+export { type NumerableFormatOptions };
+//# sourceMappingURL=ValueIndicator.d.ts.map

package/dist/components/ValueIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueIndicator.d.ts","sourceRoot":"","sources":["../../src/components/ValueIndicator.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,sBAAsB,CAAC;AAG9B;;GAEG;AACH,UAAU,mBAAmB;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAG3C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEnC;;;OAGG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,UAAU,mBAAmB;CAC5B;AAID;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAGnF;;;OAGG;gBACS,KAAK,EAAE,mBAAmB;IAMtC;;;OAGG;IAIH,MAAM;CA2BT;AAED,eAAe,cAAc,CAAC;AAC9B,OAAO,EAAE,KAAK,sBAAsB,EAAE,CAAC"}

package/dist/components/ValueIndicator.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{Component}from"react";import{Tooltip}from"primereact/tooltip";import{ValueDisplay}from"./ValueDisplay";import"./ValueIndicator.css";export class ValueIndicator extends Component{constructor(t){super(t),this.state={}}render(){return _jsxs("div",{className:"value-indicator-container",style:this.props.style,children:[_jsx(Tooltip,{target:".value-indicator-container"}),void 0!==this.props.label&&_jsx("div",{className:"value-indicator-label",children:this.props.label}),_jsx(ValueDisplay,{className:this.props.className,value:this.props.value,format:this.props.format,formatOptions:this.props.formatOptions,topic:this.props.topic,"data-pr-tooltip":this.props.tooltip,"data-pr-position":"down","data-pr-mousetrack":!0,"data-pr-showDelay":2e3})]})}}export default ValueIndicator;
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{Component}from"react";import{Tooltip}from"primereact/tooltip";import{ValueDisplay}from"./ValueDisplay";import"./ValueIndicator.css";export class ValueIndicator extends Component{constructor(t){super(t),this.state={}}render(){return _jsxs("div",{className:"value-indicator-container",style:this.props.style,children:[_jsx(Tooltip,{target:".value-indicator-container"}),void 0!==this.props.label&&_jsx("div",{className:"value-indicator-label",children:this.props.label}),_jsx(ValueDisplay,{className:this.props.className,value:this.props.value,format:this.props.format,formatOptions:this.props.formatOptions,topic:this.props.topic,"data-pr-tooltip":this.props.tooltip,"data-pr-position":"down","data-pr-mousetrack":!0,"data-pr-showDelay":2e3})]})}}export default ValueIndicator;export{};

package/dist/components/ValueInput.d.ts

@@ -47,7 +47,7 @@
  * to the console when accepted.
  */
 import React from 'react';
-import { InputNumberProps } from 'primereact/inputnumber';
+import { type InputNumberProps } from 'primereact/inputnumber';
 /**
  * Properties of the ValueInput component.
  */
@@ -155,3 +155,4 @@ interface ValueInputProps extends Omit<InputNumberProps, 'value'> {
  */
 export declare const ValueInput: React.FC<ValueInputProps>;
 export default ValueInput;
+//# sourceMappingURL=ValueInput.d.ts.map

package/dist/components/ValueInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValueInput.d.ts","sourceRoot":"","sources":["../../src/components/ValueInput.tsx"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI5E;;GAEG;AACH,UAAU,eAAgB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAE7D;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAGnC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEzB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGlC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGlC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAG1C;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAG1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B,uGAAuG;IACvG,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA6KhD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/ValueInput.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{useState,useRef,useEffect,useContext}from"react";import{InputNumber}from"primereact/inputnumber";import{EventEmitterContext}from"../core/EventEmitterContext";import{Button}from"primereact/button";export const ValueInput=({label:e="",value:t=null,min:s,max:i,minPrecision:n=0,maxPrecision:o=3,mode:a="decimal",currency:u="USD",prefix:l,suffix:r,showButtons:c=!1,step:p=1,locale:m="en-US",description:d,disabled:x=!1,dispatchTopic:f,placeholder:v,onValueChanged:b,...h})=>{const[j,C]=useState(t),[E,_]=useState(t),[S,g]=useState(t),[y,N]=useState(!1),[k,B]=useState(!1),D=useRef(null),F=useContext(EventEmitterContext);useEffect((()=>{null!==S?(_(S),g(null),B(!1)):t!==E&&(_(t),C(t),N(!1),B(!1))}),[t,E]);const I=()=>{var e;y&&null!==j&&(e=j,void 0!==i&&e>i||void 0!==s&&e<s?B(!0):(_(j),N(!1),b?.(j),B(!1),f&&F.dispatch({topic:f,payload:j})))},w=()=>{y&&(C(null),_(null),N(!1),B(!1))};return _jsxs("div",{children:[_jsxs("div",{className:"p-inputgroup flex-1",children:[_jsx("span",{className:"p-inputgroup-addon",children:e}),_jsx(InputNumber,{...h,ref:D,invalid:k,min:s,max:i,minFractionDigits:n,maxFractionDigits:o,mode:a,prefix:l,suffix:r,showButtons:c,step:p,placeholder:v,value:E,onChange:e=>{return t=e.value,y||(g(E),N(!0)),void C(t);var t},locale:m,currency:u,onKeyDown:e=>{"Enter"===e.key?I():"Escape"===e.key&&w()},disabled:x}),_jsx(Button,{icon:"pi pi-check",disabled:x||!y,className:"p-button-success",onClick:()=>I(),visible:y,size:"small",autoFocus:!1}),_jsx(Button,{icon:"pi pi-times",disabled:x||!y,className:"p-button-danger",onClickCapture:()=>w(),visible:y,size:"small",autoFocus:!1})]}),d&&_jsx("small",{children:d})]})};export default ValueInput;
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useRef,useEffect,useContext}from"react";import{InputNumber}from"primereact/inputnumber";import{EventEmitterContext}from"../core/EventEmitterContext";import{Button}from"primereact/button";export const ValueInput=({label:e="",value:t=null,min:s,max:i,minPrecision:n=0,maxPrecision:a=3,mode:o="decimal",currency:u="USD",prefix:l,suffix:r,showButtons:c=!1,step:p=1,locale:m="en-US",description:d,disabled:x=!1,dispatchTopic:f,placeholder:v,onValueChanged:b,...h})=>{const[j,C]=useState(t),[E,_]=useState(t),[S,g]=useState(t),[y,N]=useState(!1),[k,B]=useState(!1),D=useRef(null),F=useContext(EventEmitterContext);useEffect(()=>{null!==S?(_(S),g(null),B(!1)):t!==E&&(_(t),C(t),N(!1),B(!1))},[t,E]);const I=()=>{var e;y&&null!==j&&(e=j,void 0!==i&&e>i||void 0!==s&&e<s?B(!0):(_(j),N(!1),b?.(j),B(!1),f&&F.dispatch({topic:f,payload:j})))},w=()=>{y&&(C(null),_(null),N(!1),B(!1))};return _jsxs("div",{children:[_jsxs("div",{className:"p-inputgroup flex-1",children:[_jsx("span",{className:"p-inputgroup-addon",children:e}),_jsx(InputNumber,{...h,ref:D,invalid:k,min:s,max:i,minFractionDigits:n,maxFractionDigits:a,mode:o,prefix:l,suffix:r,showButtons:c,step:p,placeholder:v,value:E,onChange:e=>{return t=e.value,y||(g(E),N(!0)),void C(t);var t},locale:m,currency:u,onKeyDown:e=>{"Enter"===e.key?I():"Escape"===e.key&&w()},disabled:x}),_jsx(Button,{icon:"pi pi-check",disabled:x||!y,className:"p-button-success",onClick:()=>I(),visible:y,size:"small",autoFocus:!1}),_jsx(Button,{icon:"pi pi-times",disabled:x||!y,className:"p-button-danger",onClickCapture:()=>w(),visible:y,size:"small",autoFocus:!1})]}),d&&_jsx("small",{children:d})]})};export default ValueInput;

package/dist/core/ActionMode.d.ts

@@ -7,3 +7,4 @@ export declare enum ActionMode {
     Pressed = "Pressed",
     Released = "Released"
 }
+//# sourceMappingURL=ActionMode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionMode.d.ts","sourceRoot":"","sources":["../../src/core/ActionMode.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,oBAAY,UAAU;IAClB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,QAAQ,aAAa;CACxB"}

package/dist/core/AutoCoreTagContext.d.ts

@@ -0,0 +1,243 @@
+/**
+ * @module core/AutoCoreTagContext
+ *
+ * @document ../../additional-docs/AutCoreTagContext.md
+ *
+ * @summary
+ * A React Context + Provider that:
+ * - Buffers **raw** controller values for every tag (exactly as received)
+ * - Derives **display** values from raw using current `scales` and optional tag `codec`
+ * - Recomputes display values **from raw** whenever a scale changes (no lossy re-scaling)
+ * - Inverse-scales on `write()` so the server always receives controller units
+ * - Supports ADS one-shot refresh, GNV-style scale objects, and resilient eager reads
+ *
+ * @remarks
+ * ❖ **Two representations per tag**
+ * - `rawValues[tagName]`: last controller value as-is (pre-scale, pre-codec)
+ * - `values[tagName]`: app-visible value derived from raw (scales/codec applied)
+ *
+ * ❖ **Scaling**
+ * - Provide `scales` keyed by scale group (e.g., `"position"`, `"load"`).
+ * - Each scale may point at a server tag (`serverTag`) that publishes an object
+ *   `{ name, scale, label }` (GNV-style). When received, the Provider recomputes
+ *   *only* affected display values **from raw**.
+ * - Manual `updateScale(name, scale, label)` writes the object back to the server
+ *   (if `serverTag` is configured) and recomputes from raw locally.
+ *
+ * ❖ **Lifecycle order (eagerRead = true)**
+ * 1. Pull server scales first (so first ADS burst displays in correct units)
+ * 2. Register ADS symbols and subscribe all domains
+ * 3. Eager-pull non-ADS (refresh if available, else read_value)
+ * 4. ADS `refresh` one-shot publish
+ *
+ * ❖ **Writes**
+ * - `write(tagName, displayValue)` → (codec?) → inverse-scale → `write_value`
+ * - `tap(tagName)` pulses booleans `true → (300ms) → false` with proper domain envelopes
+ *
+ * ❖ **Resilience**
+ * - Eager reads tolerate “missing key” errors on fresh systems and keep going
+ * - All re-scaling recomputes from **raw** to avoid cumulative precision/race issues
+ *
+ * @example Minimal wiring
+ * ```tsx
+ * import { AutoCoreTagProvider } from "@adcops/autocore-react/core/AutoCoreTagContext";
+ * import type { TagConfig, ScaleConfig } from "@adcops/autocore-react/core/AutoCoreTagTypes";
+ *
+ * const acTagSpec = [
+ *   { tagName: "pressPosition", domain: "ADS", valueType: "number", symbolName: "AX.Press.Position", scale: "position" },
+ *   { tagName: "pressLoad",     domain: "ADS", valueType: "number", symbolName: "AX.Press.Load",     scale: "load" },
+ *   { tagName: "isMotorsOn",    domain: "ADS", valueType: "boolean", symbolName: "GIO.isMotorsOn" },
+ * ] as const satisfies readonly TagConfig[];
+ *
+ * const scales: Record<string, ScaleConfig> = {
+ *   position: {
+ *     name: "position",
+ *     scale: 1.0,
+ *     label: "mm",
+ *     serverTag: { domain: "GNV", symbolName: "position_units" }, // expects {name, scale, label}
+ *   },
+ *   load: {
+ *     name: "load",
+ *     scale: 1.0,
+ *     label: "N",
+ *     serverTag: { domain: "GNV", symbolName: "load_units" },     // expects {name, scale, label}
+ *   },
+ * };
+ *
+ * export function AppRoot() {
+ *   return (
+ *     <AutoCoreTagProvider tags={acTagSpec} scales={scales} eagerRead>
+ *       <App />
+ *     </AutoCoreTagProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Consuming values with hooks
+ * ```tsx
+ * import { makeAutoCoreTagHooks } from "@adcops/autocore-react/hooks/useAutoCoreTag";
+ * import { AutoCoreTagContext } from "@adcops/autocore-react/core/AutoCoreTagContext";
+ *
+ * export const AutoCoreHooks = makeAutoCoreTagHooks(AutoCoreTagContext, acTagSpec);
+ *
+ * function Dashboard() {
+ *   const { value: pos } = AutoCoreHooks.useAutoCoreTag("pressPosition"); // display units
+ *   const { value: load } = AutoCoreHooks.useAutoCoreTag("pressLoad");
+ *   const { scales, updateScale } = AutoCoreHooks.useScales();
+ *
+ *   return (
+ *     <>
+ *       <div>Position: {pos} {scales.position.label}</div>
+ *       <div>Load: {load} {scales.load.label}</div>
+ *       <button onClick={() => updateScale("position", 1/25.4, "in")}>inches</button>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+import React, { type ReactNode } from "react";
+import type { BaseContextValue, TagConfig, ScaleConfig } from "./AutoCoreTagTypes";
+/**
+ * Runtime type for the values map - allows any tag name to map to any value type.
+ * This is the generic type used when the specific tag configuration is not known at compile time.
+ */
+type VMapRuntime = Record<string, unknown>;
+/**
+ * The React Context that holds all AutoCore tag state and operations.
+ *
+ * This context provides:
+ * - `values`: Display values (with scaling/codecs applied)
+ * - `rawValues`: Raw controller values as received from server
+ * - `isLoading`: Whether initial data loading is complete
+ * - `write`: Function to write a value to a tag
+ * - `tap`: Function to pulse a boolean tag (true → delay → false)
+ * - `scales`: Current scale configurations
+ * - `updateScale`: Function to change a scale factor/label
+ *
+ * @see AutoCoreTagProvider for the provider implementation
+ * @see makeAutoCoreTagHooks for creating typed hooks from this context
+ */
+export declare const AutoCoreTagContext: React.Context<BaseContextValue<VMapRuntime>>;
+/**
+ * AutoCoreTagProvider
+ *
+ * @description
+ * React Provider that wires up AutoCore tags to live server updates, buffers **raw**
+ * controller values, exposes **display** values (scales/codec applied), and handles
+ * writes/taps with proper domain envelopes. Scaling is **always** applied to display
+ * values only; raw values remain untouched and are the single source of truth.
+ *
+ * @props
+ * - `tags: readonly TagConfig[]`
+ *    The full tag spec. Each tag declares `tagName`, `domain`, `symbolName`,
+ *    `valueType` ("boolean"|"number"|"string"|"json"), optional `scale` name, and
+ *    optional `codec` for JSON.
+ *
+ * - `scales?: Record<string, ScaleConfig>`
+ *    Map of scale groups (`position`, `load`, …). Each scale may include an optional
+ *    `serverTag` `{ domain, symbolName }`. When present, the provider reads that key
+ *    first and subscribes to updates. The server must publish a GNV-style object
+ *    `{ name, scale, label }` (stringified or object). When a new scale arrives,
+ *    the provider recomputes affected display values **from raw**.
+ *
+ * - `eagerRead?: boolean = true`
+ *    If true, the provider performs a non-ADS eager fetch pass (refresh if available,
+ *    otherwise read_value with backoff) and then performs a single ADS `refresh`.
+ *    Missing keys are common on clean systems—these are logged and skipped.
+ *
+ * - `children: ReactNode`
+ *    Your app subtree that consumes `AutoCoreTagContext`.
+ *
+ * @context value
+ * - `values`: Partial<Record<tagName, unknown>> — app-visible (scaled/decoded)
+ * - `rawValues`: Record<tagName, unknown>       — last controller values as received
+ * - `isLoading`: boolean                        — true until initial wiring completes
+ * - `write(tagName, displayValue)`: Promise<void>
+ *      Serializes/encodes JSON if needed and inverse-scales numbers back to raw units.
+ *      Dispatches `write_value` with appropriate domain envelope:
+ *      - ADS: `{ symbol_name, value }`
+ *      - GNV: `{ group:"ux", key, value }`
+ *      - Other: `{ key, value }`
+ * - `tap(tagName)`: Promise<void>
+ *      For boolean tags only. Pulses true → 300ms → false with the proper envelope.
+ * - `scales`: Record<string, ScaleConfig>       — current factors/labels
+ * - `updateScale(name, scale, label)`: Promise<void>
+ *      Writes `{ name, scale, label }` to the configured `serverTag` (if present) and
+ *      recomputes display values **from raw** locally.
+ *
+ * @example With server-driven scales (GNV) and ADS data
+ * ```tsx
+ * const tags: readonly TagConfig[] = [
+ *   { tagName: "pressPosition", domain: "ADS", valueType: "number", symbolName: "AX.Press.Pos",   scale: "position" },
+ *   { tagName: "pressLoad",     domain: "ADS", valueType: "number", symbolName: "AX.Press.Load",  scale: "load" },
+ *   { tagName: "isMotorsOn",    domain: "ADS", valueType: "boolean", symbolName: "GIO.isMotorsOn" },
+ *   // JSON with codec example
+ *   { tagName: "jobMeta",       domain: "GNV", valueType: "json",   symbolName: "job_meta",
+ *     codec: {
+ *       fromServer: (raw) => (typeof raw === "string" ? JSON.parse(raw) : raw),
+ *       toServer:   (val) => JSON.stringify(val),
+ *     }
+ *   },
+ * ] as const;
+ *
+ * const scales: Record<string, ScaleConfig> = {
+ *   position: {
+ *     name: "position",
+ *     scale: 1, label: "mm",
+ *     serverTag: { domain: "GNV", symbolName: "position_units" } // expects {name, scale, label}
+ *   },
+ *   load: {
+ *     name: "load",
+ *     scale: 1, label: "N",
+ *     serverTag: { domain: "GNV", symbolName: "load_units" }     // expects {name, scale, label}
+ *   }
+ * };
+ *
+ * <AutoCoreTagProvider tags={tags} scales={scales} eagerRead>
+ *   <YourApp/>
+ * </AutoCoreTagProvider>
+ * ```
+ *
+ * @example Reading values, raw vs display, and writing
+ * ```tsx
+ * import { makeAutoCoreTagHooks } from "../hooks/useAutoCoreTag";
+ * import { AutoCoreTagContext } from "../core/AutoCoreTagContext";
+ *
+ * const Hooks = makeAutoCoreTagHooks(AutoCoreTagContext, tags);
+ *
+ * function Status() {
+ *   const { value: pos, isLoading } = Hooks.useAutoCoreTag("pressPosition"); // scaled
+ *   const { value: rawPos } = (() => {
+ *     // access raw via context when needed for debugging
+ *     const ctx = React.useContext(AutoCoreTagContext);
+ *     return { value: ctx.rawValues["pressPosition"] };
+ *   })();
+ *
+ *   const { scales, updateScale } = Hooks.useScales();
+ *
+ *   return (
+ *     <>
+ *       <div>Pos: {pos} {scales.position.label} (raw: {String(rawPos)})</div>
+ *       <button onClick={() => updateScale("position", 1/25.4, "in")}>inches</button>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example Tapping booleans and writing numbers in display units
+ * ```tsx
+ * const { tap } = Hooks.useAutoCoreTag("isMotorsOn");
+ * const { write } = Hooks.useAutoCoreTag("pressPosition");
+ *
+ * <button onClick={() => tap()}>Motors TAP</button>
+ * <button onClick={() => write(10.0)}>Jog to 10 (display units)</button>
+ * ```
+ */
+export declare const AutoCoreTagProvider: React.FC<{
+    children: ReactNode;
+    tags: readonly TagConfig[];
+    scales?: Record<string, ScaleConfig>;
+    eagerRead?: boolean;
+}>;
+export {};
+//# sourceMappingURL=AutoCoreTagContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutoCoreTagContext.d.ts","sourceRoot":"","sources":["../../src/core/AutoCoreTagContext.tsx"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAGH,OAAO,KAAK,EAAE,EAQV,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EACT,WAAW,EACd,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,8CAQ7B,CAAC;AAuBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkHG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB,CAu0BA,CAAC"}

package/dist/core/AutoCoreTagContext.js

@@ -0,0 +1 @@
+import{jsx as _jsx}from"react/jsx-runtime";import React,{useRef,createContext,useCallback,useContext,useEffect,useMemo,useState}from"react";import{EventEmitterContext}from"./EventEmitterContext";export const AutoCoreTagContext=createContext({values:{},rawValues:{},isLoading:!0,write:async()=>{},tap:async()=>{},scales:{},updateScale:async()=>{}});const sleep=e=>new Promise(t=>setTimeout(t,e));export const AutoCoreTagProvider=({children:e,tags:t,scales:a={},eagerRead:s=!0})=>{const o=useRef(!1),{invoke:r,isConnected:n,subscribe:c,unsubscribe:l}=useContext(EventEmitterContext),[u,i]=useState(()=>{const e={};for(const a of t)void 0!==a.initialValue&&(e[a.tagName]=a.initialValue);return e}),[m,f]=useState({}),[y,b]=useState(a),p=useRef(y),v=useRef(u);useEffect(()=>{p.current=y},[y]),useEffect(()=>{v.current=u},[u]);const[d,g]=useState(!0),N=useCallback((e,t)=>{const{valueType:a,scale:s,codec:o}=e;if("number"===a&&"number"==typeof t&&s){const e=p.current[s];return t*(e?.scale??1)}if("json"===a&&o?.fromServer)try{return o.fromServer(t)}catch{}return t},[]),C=useCallback((e,t)=>{const{valueType:a,scale:s,codec:o}=e;if("json"===a&&o?.toServer)try{t=o.toServer(t)}catch{}if("number"===a&&"number"==typeof t&&s){const e=p.current[s];return t/(e?.scale??1)}return t},[]),w=useCallback(e=>{const a=t.filter(t=>t.scale===e);a.length&&f(e=>{const t={...e};for(const e of a){const a=v.current[e.tagName];if("number"!=typeof a)continue;const s=N(e,a);t[e.tagName]!==s&&(t[e.tagName]=s)}return t})},[t,N]),h=useCallback((e,t)=>{i(a=>a[e.tagName]===t?a:{...a,[e.tagName]:t});const a=N(e,t);f(t=>t[e.tagName]===a?t:{...t,[e.tagName]:a})},[N]),x=useCallback(async(e,t,a)=>{const s=a?.concurrency??4,o=a?.minDelayMs??20,n=a?.jitterMs??40;let c=0;const l=Array.from({length:s},()=>(async()=>{for(;;){const a=c++;if(a>=t.length)return;const s=t[a];try{let t=!1;try{await r(e,"refresh",{topic:s.symbolName}),t=!0}catch{}if(!t){const t="GNV"===e.toUpperCase()?{group:"ux",key:s.symbolName}:{key:s.symbolName};s.options&&(t.options=s.options);try{const a=await r(e,"read_value",t);a?.success&&a?.valid&&h(s,a.data)}catch(e){}}}catch(e){}finally{const e=Math.floor(Math.random()*n);await sleep(o+e)}}})());await Promise.all(l)},[r,h]),k=useCallback(async()=>{for(const[e,t]of Object.entries(a)){if(!t.serverTag)continue;const{domain:a,symbolName:s}=t.serverTag;try{const t=await r(a,"read_value",{group:"ux",key:s});if(t.data&&(t.success??1)&&(t.valid??1)){const a=JSON.parse(t.data);if(a&&"number"==typeof a.scale){const{scale:t,label:s}=a;b(a=>({...a,[e]:{...a[e],scale:t,label:s??a[e]?.label??"---"}})),w(e)}}}catch{}}},[r,a,w]);useEffect(()=>{let e=!0;const a=[],u=async()=>{if(e&&!o.current){o.current=!0;try{await(async()=>{const o=new Map;for(const e of t){const t=o.get(e.domain);t?t.push(e):o.set(e.domain,[e])}try{await k();for(const[t,n]of o.entries()){if("ADS"===t.toUpperCase())for(const e of n)try{const t=e.options?{symbol_name:e.symbolName,options:e.options}:{symbol_name:e.symbolName};await r("ADS","register_symbol",t)}catch(e){}else for(const e of n)await r(t,"subscribe",{data_filter:e.symbolName});for(const s of n){const o=c(`${t}/${s.symbolName}`,t=>{e&&h(s,t?.value)});a.push(o)}s&&"ADS"!==t.toUpperCase()&&await x(t,n,{concurrency:4,minDelayMs:20,jitterMs:40})}s&&await r("ADS","refresh",{})}finally{e&&setTimeout(()=>e&&g(!1),100)}})()}finally{e&&setTimeout(()=>e&&g(!1),100)}}};if(n())u();else{const e=c("HUB/connected",()=>{l(e),u()});a.push(e)}return()=>{e=!1,a.forEach(l),o.current=!1}},[c,l,n,r,s,t,k,x,h]);const S=useMemo(()=>Object.entries(a).filter(([,e])=>e.serverTag).map(([e,t])=>({scaleName:e,domain:t.serverTag.domain,symbolName:t.serverTag.symbolName})),[a]);useEffect(()=>{let e=!0;const t=[];for(const{scaleName:a,domain:s,symbolName:o}of S){const r=c(`${s}/${o}`,t=>{if(!e)return;const s=t?.value;if(s&&"object"==typeof s&&"number"==typeof s.scale){const{scale:e,label:t}=s;b(s=>({...s,[a]:{...s[a],scale:e,label:t??s[a]?.label??"---"}})),w(a)}});t.push(r)}return()=>{e=!1,t.forEach(l)}},[c,l,S,w]);const T=useCallback(async(e,a)=>{const s=t.find(t=>t.tagName===e);if(!s)return;const o=C(s,a);let n;const c=s.domain.toUpperCase();n="ADS"===c?{symbol_name:s.symbolName,value:o}:"GNV"===c?{group:"ux",key:s.symbolName,value:o}:{key:s.symbolName,value:o},await r(s.domain,"write_value",n)},[t,r,C]),E=useCallback(async e=>{const a=t.find(t=>t.tagName===e);if(!a)return;if("boolean"!==a.valueType)return;const s=a.domain.toUpperCase(),o=e=>"ADS"===s?{symbol_name:a.symbolName,value:e}:"GNV"===s?{group:"ux",key:a.symbolName,value:e}:{key:a.symbolName,value:e};await r(a.domain,"write_value",o(!0)),await sleep(300),await r(a.domain,"write_value",o(!1))},[t,r]),_=useCallback(async(e,t,a)=>{const s=y[e];s&&(s.serverTag&&await r(s.serverTag.domain,"write_value",{group:"ux",key:s.serverTag.symbolName,value:{name:e,scale:t,label:a}}),b(s=>({...s,[e]:{...s[e],scale:t,label:a}})),w(e))},[y,r,w]);useEffect(()=>{f(e=>{const a={...e};for(const e of t){const t=v.current[e.tagName];if(void 0===t)continue;const s=N(e,t);a[e.tagName]!==s&&(a[e.tagName]=s)}return a})},[t,N,y]);const j=useMemo(()=>({values:m,rawValues:u,isLoading:d,write:T,tap:E,scales:y,updateScale:_}),[m,u,d,T,E,y,_]);return _jsx(AutoCoreTagContext.Provider,{value:j,children:e})};