@adcops/autocore-react 3.1.1 → 3.3.5

package/additional-docs/react_performance_notes.md

@@ -0,0 +1,94 @@
+# AutoCore React Performance & Architecture Notes
+
+## Overview
+
+This document details the architectural decisions and performance optimizations implemented in the `autocore-react` library, specifically regarding the `EventEmitterContext` and `AutoCoreTagContext`. These changes were made to solve issues with infinite re-render loops and performance bottlenecks when handling high-frequency sensor data (e.g., 50Hz+ updates).
+
+## Key Performance Rules
+
+### 1. Avoid Global Context State Updates for High-Frequency Data
+
+**The Problem:**
+Originally, `EventEmitterContext` stored the latest event payload in its state (`state.eventData`).
+Every time a WebSocket message arrived (e.g., a sensor value update), `setState` was called.
+Since `EventEmitterContext` wraps the entire application, **every single component in the app re-rendered** on every sensor update.
+
+**The Fix:**
+We removed the `setState` call from the `dispatch` function.
+- **Old way:** `dispatch` -> `setState` -> `Context Value Change` -> `App Re-render`.
+- **New way:** `dispatch` -> Iterate Subscribers -> `callback(payload)`.
+
+**Rule:**
+> Do NOT store high-frequency data (like sensor readings) in a global Context's `value` or `state` property if that Context is consumed by the root component. Use a subscription model (observers/listeners) instead.
+
+### 2. Stable Object References (Memoization)
+
+**The Problem:**
+In `AutoCoreTagContext`, the `scales` prop was defaulted using a destructuring assignment: `scales = {}`.
+This created a **new object reference** on every render.
+This unstable reference was used in `useEffect` dependency arrays, causing effects to re-run infinitely, leading to subscription storms and infinite loops.
+
+**The Fix:**
+We memoized the default empty object:
+```typescript
+const defaultScales = useMemo(() => ({}), []);
+const actualScales = scales ?? defaultScales;
+```
+And used `actualScales` everywhere.
+
+**Rule:**
+> Always ensure objects passed to Context Providers or used in `useEffect` dependencies are referentially stable. Use `useMemo` for derived objects and constants.
+
+### 3. Side-Effects in Render Phase
+
+**The Problem:**
+`EventEmitterProvider` was calling `hub.setContext(contextValue)` directly in the component body (during the render phase).
+React's Concurrent Mode or Strict Mode can call the render function multiple times without committing, leading to unpredictable state in the `Hub` singleton.
+
+**The Fix:**
+Moved the side-effect to `useEffect`:
+```typescript
+useEffect(() => {
+  hub.setContext(contextValue);
+}, [hub, contextValue]);
+```
+
+**Rule:**
+> Never mutate external Singletons or perform side-effects in the main body of a React Functional Component. Always use `useEffect`.
+
+---
+
+## Data Flow Architecture
+
+### 1. Tag Name vs. FQDN
+
+To decouple the UI from the backend implementation:
+- **FQDN (Fully Qualified Domain Name)**: The backend address (e.g., `ADS.Main.bStart`). Used only for wire communication.
+- **TagName**: The local UI alias (e.g., `startCmd`). Used by React components.
+
+**The Flow:**
+1. **Component**: Calls `useAutoCoreTag("startCmd")`.
+2. **Context**: Looks up config, finds FQDN `ADS.Main.bStart`.
+3. **Context**: Calls `hub.subscribe("startCmd", "ADS.Main.bStart")`.
+4. **Hub**: Maps `ADS.Main.bStart` -> `startCmd`.
+5. **Backend**: Sends update for `ADS.Main.bStart`.
+6. **Hub**: Receives update, translates topic to `startCmd`, dispatches event.
+7. **Context**: Listens for `startCmd`, updates state.
+8. **Component**: Re-renders with new value.
+
+### 2. Dual-State Storage
+
+`AutoCoreTagContext` stores two versions of every value:
+1. **`rawValues`**: The exact JSON received from the server. **(Source of Truth)**
+2. **`values`**: The scaled/decoded value for display.
+
+When a scale changes (e.g., mm to inches), we recompute `values` from `rawValues`. We never rescale a previously scaled value to avoid floating-point drift.
+
+---
+
+## Best Practices for Team
+
+1. **Use Hooks**: Always use `useAutoCoreTag` or `useAutoCoreTags`. Do not consume the Context directly unless necessary.
+2. **Key by TagName**: When adding features, always prefer `tagName` over `fqdn` for local logic.
+3. **Console Logs**: Avoid leaving `console.log` in render paths (components). It floods the console and slows down the browser.
+4. **Strict Mode**: Be aware that React Strict Mode mounts components twice. Your `useEffect` cleanup functions must be robust.

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

@@ -1 +1 @@
-{"version":3,"file":"AutoCoreDevPanel.d.ts","sourceRoot":"","sources":["../../src/components/AutoCoreDevPanel.tsx"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AAEH,OAAO,KAAqD,MAAM,OAAO,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D;;GAEG;AACH,UAAU,qBAAqB;IAC7B;;;OAGG;IACH,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAE3B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsK5D,CAAC"}
+{"version":3,"file":"AutoCoreDevPanel.d.ts","sourceRoot":"","sources":["../../src/components/AutoCoreDevPanel.tsx"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AAEH,OAAO,KAAqD,MAAM,OAAO,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D;;GAEG;AACH,UAAU,qBAAqB;IAC7B;;;OAGG;IACH,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAE3B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsK5D,CAAC"}

package/dist/components/AutoCoreDevPanel.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useContext,useMemo,useState,useCallback}from"react";import{AutoCoreTagContext}from"../core/AutoCoreTagContext";export const AutoCoreDevPanel=({tags:e,title:t="AutoCore Dev Panel",className:n=""})=>{const{values:a,rawValues:o,isLoading:l,write:r,tap:s,scales:i}=useContext(AutoCoreTagContext),[d,c]=useState({}),[u,h]=useState({}),m=useMemo(()=>e.map(e=>{const t=a[e.tagName],n=o[e.tagName],l=e.scale??"",r=l?i[l]:void 0;return{tag:e,display:t,raw:n,scaleName:l,factor:r?.scale,label:r?.label}}),[e,a,o,i]),x=useCallback((e,t)=>{c(n=>({...n,[e]:t})),h(t=>({...t,[e]:""}))},[]),p=useCallback((e,t)=>{h(n=>({...n,[e]:t}))},[]),g=useCallback(async e=>{const t=e.tagName,n=d[t];try{if("boolean"===e.valueType){const e="true"===n||"false"!==n&&!a[t];return await r(t,e),void x(t,"")}if("number"===e.valueType){if(null==n||""===n.trim())return void p(t,"Enter a number.");const e=Number(n);return Number.isNaN(e)?void p(t,"Invalid number."):(await r(t,e),void x(t,""))}if("string"===e.valueType)return await r(t,n??""),void x(t,"");try{const e=n?.trim()?JSON.parse(n):null;await r(t,e),x(t,"")}catch(e){p(t,"Invalid JSON.")}}catch(e){p(t,e?.message??String(e))}},[d,x,p,r,a]);return _jsxs("div",{className:`rounded-md border border-gray-200 bg-white text-sm ${n}`,style:{minWidth:680},children:[_jsx("div",{className:"flex items-center justify-between px-3 py-2",style:{borderBottom:"1px solid #eee"},children:_jsxs("div",{className:"flex items-center gap-2",children:[_jsx("strong",{children:t}),_jsx("span",{title:l?"Loading":"Live",style:{width:8,height:8,borderRadius:999,background:l?"#aaa":"#22c55e",display:"inline-block"}})]})}),_jsx("div",{style:{overflowX:"auto"},children:_jsxs("table",{style:{borderCollapse:"collapse",width:"100%"},children:[_jsx("thead",{children:_jsxs("tr",{children:[_jsx(Th,{children:"Tag"}),_jsx(Th,{children:"Kind"}),_jsx(Th,{children:"Domain"}),_jsx(Th,{children:"Symbol"}),_jsx(Th,{children:"Display"}),_jsx(Th,{children:"Raw"}),_jsx(Th,{children:"Scale"}),_jsx(Th,{children:"Units"}),_jsx(Th,{children:"Input"}),_jsx(Th,{children:"Actions"})]})}),_jsx("tbody",{children:m.map(({tag:e,display:t,raw:n,scaleName:a,factor:o,label:l})=>{const r=d[e.tagName]??"",i=u[e.tagName];return _jsxs("tr",{children:[_jsx(Td,{mono:!0,children:e.tagName}),_jsx(Td,{mono:!0,children:e.valueType}),_jsx(Td,{mono:!0,children:e.domain}),_jsx(Td,{mono:!0,children:e.symbolName}),_jsx(Td,{mono:!0,children:fmt(t)}),_jsx(Td,{mono:!0,children:fmt(n)}),_jsx(Td,{mono:!0,children:a?`${a} ×${o??1}`:"—"}),_jsx(Td,{mono:!0,children:a?l??"":"—"}),_jsxs(Td,{children:[_jsx(InputForTag,{tag:e,buf:r,setBuf:t=>x(e.tagName,t),onKeyDown:t=>((e,t)=>{"Enter"!==e.key||e.shiftKey||(e.preventDefault(),g(t))})(t,e)}),i&&_jsx("div",{style:{color:"#dc2626",marginTop:4},children:i})]}),_jsx(Td,{children:_jsxs("div",{style:{display:"flex",gap:6},children:[_jsx("button",{onClick:()=>g(e),children:"Write"}),"boolean"===e.valueType&&_jsx("button",{onClick:()=>s(e.tagName),children:"TAP"})]})})]},e.tagName)})})]})})]})};const Th=({children:e})=>_jsx("th",{style:{textAlign:"left",borderBottom:"1px solid #ddd",padding:"6px 8px",fontFamily:"ui-monospace, SFMono-Regular, Menlo, monospace"},children:e}),Td=({children:e,mono:t})=>_jsx("td",{style:{borderBottom:"1px solid #eee",padding:"6px 8px",whiteSpace:"nowrap",fontFamily:t?"ui-monospace, SFMono-Regular, Menlo, monospace":"inherit"},children:e}),InputForTag=({tag:e,buf:t,setBuf:n,onKeyDown:a})=>"boolean"===e.valueType?_jsxs("label",{style:{display:"inline-flex",alignItems:"center",gap:6},children:[_jsx("input",{type:"checkbox",checked:t?"true"===t:Boolean,onChange:e=>n(e.target.checked?"true":"false"),onKeyDown:a}),_jsx("span",{children:"set"})]}):"number"===e.valueType?_jsx("input",{type:"number",step:"any",value:t,onChange:e=>n(e.target.value),onKeyDown:a,style:{width:140},placeholder:"number…"}):"string"===e.valueType?_jsx("input",{type:"text",value:t,onChange:e=>n(e.target.value),onKeyDown:a,style:{width:180},placeholder:"text…"}):_jsx("textarea",{value:t,onChange:e=>n(e.target.value),onKeyDown:a,rows:2,style:{width:260,fontFamily:"ui-monospace, SFMono-Regular, Menlo, monospace"},placeholder:'{"foo": 42}'});function fmt(e){if(null==e)return"—";if("number"==typeof e)return Number.isFinite(e)?e.toString():String(e);if("string"==typeof e)return e;try{return JSON.stringify(e)}catch{return String(e)}}
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useContext,useMemo,useState,useCallback}from"react";import{AutoCoreTagContext}from"../core/AutoCoreTagContext";const getDomain=e=>e.split(".")[0];export const AutoCoreDevPanel=({tags:e,title:n="AutoCore Dev Panel",className:t=""})=>{const{values:o,rawValues:a,isLoading:s,write:l,tap:r,scales:i}=useContext(AutoCoreTagContext),[d,c]=useState({}),[u,h]=useState({}),x=useMemo(()=>e.map(e=>{const n=o[e.fqdn],t=a[e.fqdn],s=e.scale??"",l=s?i[s]:void 0;return{tag:e,display:n,raw:t,scaleName:s,factor:l?.scale,label:l?.label}}),[e,o,a,i]),m=useCallback((e,n)=>{c(t=>({...t,[e]:n})),h(n=>({...n,[e]:""}))},[]),p=useCallback((e,n)=>{h(t=>({...t,[e]:n}))},[]),y=useCallback(async e=>{const n=e.fqdn,t=d[n];try{if("boolean"===e.valueType){const e="true"===t||"false"!==t&&!o[n];return await l(n,e),void m(n,"")}if("number"===e.valueType){if(null==t||""===t.trim())return void p(n,"Enter a number.");const e=Number(t);return Number.isNaN(e)?void p(n,"Invalid number."):(await l(n,e),void m(n,""))}if("string"===e.valueType)return await l(n,t??""),void m(n,"");try{const e=t?.trim()?JSON.parse(t):null;await l(n,e),m(n,"")}catch(e){p(n,"Invalid JSON.")}}catch(e){p(n,e?.message??String(e))}},[d,m,p,l,o]);return _jsxs("div",{className:`rounded-md border border-gray-200 bg-white text-sm ${t}`,style:{minWidth:680},children:[_jsx("div",{className:"flex items-center justify-between px-3 py-2",style:{borderBottom:"1px solid #eee"},children:_jsxs("div",{className:"flex items-center gap-2",children:[_jsx("strong",{children:n}),_jsx("span",{title:s?"Loading":"Live",style:{width:8,height:8,borderRadius:999,background:s?"#aaa":"#22c55e",display:"inline-block"}})]})}),_jsx("div",{style:{overflowX:"auto"},children:_jsxs("table",{style:{borderCollapse:"collapse",width:"100%"},children:[_jsx("thead",{children:_jsxs("tr",{children:[_jsx(Th,{children:"Tag"}),_jsx(Th,{children:"Kind"}),_jsx(Th,{children:"Domain"}),_jsx(Th,{children:"Symbol"}),_jsx(Th,{children:"Display"}),_jsx(Th,{children:"Raw"}),_jsx(Th,{children:"Scale"}),_jsx(Th,{children:"Units"}),_jsx(Th,{children:"Input"}),_jsx(Th,{children:"Actions"})]})}),_jsx("tbody",{children:x.map(({tag:e,display:n,raw:t,scaleName:o,factor:a,label:s})=>{const l=d[e.fqdn]??"",i=u[e.fqdn];return _jsxs("tr",{children:[_jsx(Td,{mono:!0,children:e.tagName}),_jsx(Td,{mono:!0,children:e.valueType}),_jsx(Td,{mono:!0,children:getDomain(e.fqdn)}),_jsx(Td,{mono:!0,children:e.fqdn}),_jsx(Td,{mono:!0,children:fmt(n)}),_jsx(Td,{mono:!0,children:fmt(t)}),_jsx(Td,{mono:!0,children:o?`${o} ×${a??1}`:"—"}),_jsx(Td,{mono:!0,children:o?s??"":"—"}),_jsxs(Td,{children:[_jsx(InputForTag,{tag:e,buf:l,setBuf:n=>m(e.fqdn,n),onKeyDown:n=>((e,n)=>{"Enter"!==e.key||e.shiftKey||(e.preventDefault(),y(n))})(n,e)}),i&&_jsx("div",{style:{color:"#dc2626",marginTop:4},children:i})]}),_jsx(Td,{children:_jsxs("div",{style:{display:"flex",gap:6},children:[_jsx("button",{onClick:()=>y(e),children:"Write"}),"boolean"===e.valueType&&_jsx("button",{onClick:()=>r(e.fqdn),children:"TAP"})]})})]},e.fqdn)})})]})})]})};const Th=({children:e})=>_jsx("th",{style:{textAlign:"left",borderBottom:"1px solid #ddd",padding:"6px 8px",fontFamily:"ui-monospace, SFMono-Regular, Menlo, monospace"},children:e}),Td=({children:e,mono:n})=>_jsx("td",{style:{borderBottom:"1px solid #eee",padding:"6px 8px",whiteSpace:"nowrap",fontFamily:n?"ui-monospace, SFMono-Regular, Menlo, monospace":"inherit"},children:e}),InputForTag=({tag:e,buf:n,setBuf:t,onKeyDown:o})=>"boolean"===e.valueType?_jsxs("label",{style:{display:"inline-flex",alignItems:"center",gap:6},children:[_jsx("input",{type:"checkbox",checked:n?"true"===n:Boolean,onChange:e=>t(e.target.checked?"true":"false"),onKeyDown:o}),_jsx("span",{children:"set"})]}):"number"===e.valueType?_jsx("input",{type:"number",step:"any",value:n,onChange:e=>t(e.target.value),onKeyDown:o,style:{width:140},placeholder:"number…"}):"string"===e.valueType?_jsx("input",{type:"text",value:n,onChange:e=>t(e.target.value),onKeyDown:o,style:{width:180},placeholder:"text…"}):_jsx("textarea",{value:n,onChange:e=>t(e.target.value),onKeyDown:o,rows:2,style:{width:260,fontFamily:"ui-monospace, SFMono-Regular, Menlo, monospace"},placeholder:'{"foo": 42}'});function fmt(e){if(null==e)return"—";if("number"==typeof e)return Number.isFinite(e)?e.toString():String(e);if("string"==typeof e)return e;try{return JSON.stringify(e)}catch{return String(e)}}

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

@@ -1 +1 @@
-{"version":3,"file":"FileList.d.ts","sourceRoot":"","sources":["../../src/components/FileList.tsx"],"names":[],"mappings":"AASA;;;;;;GAMG;AAEH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAW/D;;GAEG;AACH;;GAEG;AACH,KAAK,aAAa,GAAG;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAG,CAAC,OAAO,EAAC,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAG,CAAC,OAAO,EAAC,MAAM,KAAK,IAAI,CAAC;CACvC,CAAA;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA8Q5C,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"FileList.d.ts","sourceRoot":"","sources":["../../src/components/FileList.tsx"],"names":[],"mappings":"AASA;;;;;;GAMG;AAEH,OAAO,KAA0C,MAAM,OAAO,CAAC;AAY/D;;GAEG;AACH;;GAEG;AACH,KAAK,aAAa,GAAG;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAG,CAAC,OAAO,EAAC,MAAM,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAG,CAAC,OAAO,EAAC,MAAM,KAAK,IAAI,CAAC;CACvC,CAAA;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA8Q5C,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/components/FileList.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import React,{useState,useContext,useEffect}from"react";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Toolbar}from"primereact/toolbar";import{Button}from"primereact/button";import{confirmPopup}from"primereact/confirmpopup";import{FileUpload}from"primereact/fileupload";import{EventEmitterContext}from"../core/EventEmitterContext";export const FileList=({domain:e="DATASTORE",enableUpload:t=!1,subdir:o,filter:a=".json",onSuccess:n,onError:i})=>{const[r,l]=useState(0),{invoke:s}=useContext(EventEmitterContext),[c,d]=useState(),m=e=>null!==e?void 0!==o?`${o}/${e}`:e:"",p=async()=>{try{const t=void 0!==o?{subdir:o}:{};let a=await s(e,"list_files",t),n=[];for(let e=0;e<a.data.length;++e){const t=a.data[e];n.push({id:e+1,name:t})}d(n)}catch(e){i&&i(`Failed to upload file list: ${e}`)}};const u=()=>{l(e=>e+1)},f=`File Listing [/${void 0!==o?o:""}]`,x=_jsx(React.Fragment,{children:_jsx("span",{style:{fontWeight:600},children:f})}),b=_jsxs(React.Fragment,{children:[t&&_jsx(FileUpload,{customUpload:!0,auto:!0,uploadHandler:async t=>{const o=t.files[0];let a=m(o.name);const r=new FileReader;r.onload=async t=>{const r=t.target?.result,l=function c(e){let t="",o=new Uint8Array(e),a=o.byteLength;for(let e=0;e<a;e++)t+=String.fromCharCode(o[e]);return window.btoa(t)}(r);try{await s(e,"write_file",{file_name:a,value:l,options:{base64:!0}}),n&&n(`Uploaded file ${o.name}`),p()}catch(e){i&&i(`Failed to upload file: ${e}`)}u()},r.onerror=e=>{i&&i(`Error reading file: ${e}`)},r.readAsArrayBuffer(o)},accept:a,maxFileSize:25e3,mode:"basic",chooseLabel:"",chooseOptions:{icon:"pi pi-upload",className:"p-button-icon-only p-button-text p-button-rounded p-mr-2"}},r),_jsx(Button,{icon:"pi pi-refresh",onClick:()=>{p()},className:"p-button-rounded p-mr-2","aria-label":"Refresh",size:"small",rounded:!0,text:!0})]}),h=(t,o)=>{confirmPopup({target:o.currentTarget,message:`Are you want to delete file ${t.name}?\nWARNING: This cannot be undone.`,icon:"pi pi-info-circle",defaultFocus:"reject",acceptClassName:"p-button-danger",accept:()=>(async t=>{let o=m(t);try{await s(e,"delete_file",{file_name:o}),n&&n(`Deleted file: ${t}`),p()}catch(e){i&&i(`Failed to delete file: ${e}`)}p()})(t.name)})};return useEffect(()=>(p(),()=>{}),[e,t]),_jsxs("div",{children:[_jsx(Toolbar,{start:x,end:b,style:{padding:"1mm"}}),_jsxs(DataTable,{value:c,children:[_jsx(Column,{field:"name",header:"Name"}),_jsx(Column,{body:t=>_jsxs(_Fragment,{children:[_jsx(Button,{icon:"pi pi-download",onClick:()=>(async t=>{let o=m(t.name);try{await s(e,"download_file",{file_name:o}),n&&n(`Downloaded file: ${t.name}`)}catch(e){i&&i(`Failed downloading file: ${e}`)}})(t),className:"p-button-rounded p-button-success p-mr-2",style:{marginRight:"2mm"},size:"small"}),_jsx(Button,{icon:"pi pi-trash",onClick:e=>h(t,e),className:"p-button-rounded p-button-danger",size:"small"})]}),header:"Actions"})]})]})};export default FileList;
+import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import React,{useState,useContext,useEffect}from"react";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Toolbar}from"primereact/toolbar";import{Button}from"primereact/button";import{confirmPopup}from"primereact/confirmpopup";import{FileUpload}from"primereact/fileupload";import{EventEmitterContext}from"../core/EventEmitterContext";import{MessageType}from"../hub/CommandMessage";export const FileList=({domain:e="DATASTORE",enableUpload:t=!1,subdir:a,filter:o=".json",onSuccess:n,onError:i})=>{const[r,s]=useState(0),{invoke:l}=useContext(EventEmitterContext),[c,m]=useState(),d=e=>null!==e?void 0!==a?`${a}/${e}`:e:"",p=async()=>{try{const t=void 0!==a?{subdir:a}:{};let o=await l(`${e}.list_files`,MessageType.Request,t),n=[];for(let e=0;e<o.data.length;++e){const t=o.data[e];n.push({id:e+1,name:t})}m(n)}catch(e){i&&i(`Failed to upload file list: ${e}`)}};const u=()=>{s(e=>e+1)},f=`File Listing [/${void 0!==a?a:""}]`,b=_jsx(React.Fragment,{children:_jsx("span",{style:{fontWeight:600},children:f})}),x=_jsxs(React.Fragment,{children:[t&&_jsx(FileUpload,{customUpload:!0,auto:!0,uploadHandler:async t=>{const a=t.files[0];let o=d(a.name);const r=new FileReader;r.onload=async t=>{const r=t.target?.result,s=function c(e){let t="",a=new Uint8Array(e),o=a.byteLength;for(let e=0;e<o;e++)t+=String.fromCharCode(a[e]);return window.btoa(t)}(r);try{await l(`${e}.write_file`,MessageType.Request,{file_name:o,value:s,options:{base64:!0}}),n&&n(`Uploaded file ${a.name}`),p()}catch(e){i&&i(`Failed to upload file: ${e}`)}u()},r.onerror=e=>{i&&i(`Error reading file: ${e}`)},r.readAsArrayBuffer(a)},accept:o,maxFileSize:25e3,mode:"basic",chooseLabel:"",chooseOptions:{icon:"pi pi-upload",className:"p-button-icon-only p-button-text p-button-rounded p-mr-2"}},r),_jsx(Button,{icon:"pi pi-refresh",onClick:()=>{p()},className:"p-button-rounded p-mr-2","aria-label":"Refresh",size:"small",rounded:!0,text:!0})]}),g=(t,a)=>{confirmPopup({target:a.currentTarget,message:`Are you want to delete file ${t.name}?\nWARNING: This cannot be undone.`,icon:"pi pi-info-circle",defaultFocus:"reject",acceptClassName:"p-button-danger",accept:()=>(async t=>{let a=d(t);try{await l(`${e}.delete_file`,MessageType.Request,{file_name:a}),n&&n(`Deleted file: ${t}`),p()}catch(e){i&&i(`Failed to delete file: ${e}`)}p()})(t.name)})};return useEffect(()=>(p(),()=>{}),[e,t]),_jsxs("div",{children:[_jsx(Toolbar,{start:b,end:x,style:{padding:"1mm"}}),_jsxs(DataTable,{value:c,children:[_jsx(Column,{field:"name",header:"Name"}),_jsx(Column,{body:t=>_jsxs(_Fragment,{children:[_jsx(Button,{icon:"pi pi-download",onClick:()=>(async t=>{let a=d(t.name);try{await l(`${e}.download_file`,MessageType.Request,{file_name:a}),n&&n(`Downloaded file: ${t.name}`)}catch(e){i&&i(`Failed downloading file: ${e}`)}})(t),className:"p-button-rounded p-button-success p-mr-2",style:{marginRight:"2mm"},size:"small"}),_jsx(Button,{icon:"pi pi-trash",onClick:e=>g(t,e),className:"p-button-rounded p-button-danger",size:"small"})]}),header:"Actions"})]})]})};export default FileList;

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

@@ -1 +1 @@
-{"version":3,"file":"FileSelect.d.ts","sourceRoot":"","sources":["../../src/components/FileSelect.tsx"],"names":[],"mappings":"AAUA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAO/D,KAAK,eAAe,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAOD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0FhD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"FileSelect.d.ts","sourceRoot":"","sources":["../../src/components/FileSelect.tsx"],"names":[],"mappings":"AAUA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAQ/D,KAAK,eAAe,GAAG;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB,CAAA;AAOD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0FhD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/FileSelect.js

@@ -1 +1 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useContext,useEffect}from"react";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Button}from"primereact/button";import{EventEmitterContext}from"../core/EventEmitterContext";export const FileSelect=({domain:e="DATASTORE",subdir:t,filter:n,onFileSelected:l,onAccept:i,onCancel:o})=>{const{invoke:a}=useContext(EventEmitterContext),[s,c]=useState([]),[r,m]=useState(null),u=e=>{m(e),l&&l(e.name)};return useEffect(()=>{(async()=>{try{let l;l=null!=n?t?{subdir:t,options:{filter:n}}:{options:{filter:n}}:t?{subdir:t}:{};const i=(await a(e,"list_files",l)).data.map((e,t)=>({id:t+1,name:e}));c(i)}catch(e){}})()},[e,t]),_jsxs("div",{children:[_jsxs(DataTable,{value:s,selectionMode:"single",selection:r,onSelectionChange:e=>u(e.value),children:[_jsx(Column,{field:"name",header:"File Name"}),_jsx(Column,{body:e=>_jsx(Button,{label:r?.name===e.name?"Selected":"Select",icon:r?.name===e.name?"pi pi-check-circle":"pi pi-circle-off",onClick:()=>u(e),className:"p-button-rounded "+(r?.name===e.name?"p-button-success":"p-button-outlined"),"aria-label":"Select",size:"small"}),header:"Select"})]}),_jsxs("div",{style:{display:"flex",justifyContent:"flex-end",marginTop:"10px"},children:[_jsx(Button,{label:"Cancel",icon:"pi pi-times",className:"p-button-text",onClick:o}),_jsx(Button,{label:"Accept",icon:"pi pi-check",className:"p-button",onClick:()=>{void 0!==i&&null!==r&&i(null!==r?void 0!==t?`${t}/${r.name}`:r.name:"")},disabled:!r})]})]})};export default FileSelect;
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useContext,useEffect}from"react";import{DataTable}from"primereact/datatable";import{Column}from"primereact/column";import{Button}from"primereact/button";import{EventEmitterContext}from"../core/EventEmitterContext";import{MessageType}from"../hub/CommandMessage";export const FileSelect=({domain:e="DATASTORE",subdir:t,filter:n,onFileSelected:l,onAccept:a,onCancel:i})=>{const{invoke:o}=useContext(EventEmitterContext),[s,c]=useState([]),[r,m]=useState(null),u=e=>{m(e),l&&l(e.name)};return useEffect(()=>{(async()=>{try{let l;l=null!=n?t?{subdir:t,options:{filter:n}}:{options:{filter:n}}:t?{subdir:t}:{};const a=(await o(`${e}.list_files`,MessageType.Request,l)).data.map((e,t)=>({id:t+1,name:e}));c(a)}catch(e){}})()},[e,t]),_jsxs("div",{children:[_jsxs(DataTable,{value:s,selectionMode:"single",selection:r,onSelectionChange:e=>u(e.value),children:[_jsx(Column,{field:"name",header:"File Name"}),_jsx(Column,{body:e=>_jsx(Button,{label:r?.name===e.name?"Selected":"Select",icon:r?.name===e.name?"pi pi-check-circle":"pi pi-circle-off",onClick:()=>u(e),className:"p-button-rounded "+(r?.name===e.name?"p-button-success":"p-button-outlined"),"aria-label":"Select",size:"small"}),header:"Select"})]}),_jsxs("div",{style:{display:"flex",justifyContent:"flex-end",marginTop:"10px"},children:[_jsx(Button,{label:"Cancel",icon:"pi pi-times",className:"p-button-text",onClick:i}),_jsx(Button,{label:"Accept",icon:"pi pi-check",className:"p-button",onClick:()=>{void 0!==a&&null!==r&&a(null!==r?void 0!==t?`${t}/${r.name}`:r.name:"")},disabled:!r})]})]})};export default FileSelect;

package/dist/core/AutoCoreTagContext.d.ts

@@ -4,101 +4,77 @@
  * @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
+ * A React Context + Provider that manages the state and synchronization of "Tags" (data points)
+ * between the React frontend and the AutoCore backend.
  *
- * @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.
+ * It acts as the central data store for real-time values, handling:
+ * - **Buffering**: Stores raw controller values exactly as received.
+ * - **Scaling**: Converts raw values to display values (e.g., mm -> inches) based on configuration.
+ * - **Synchronization**: Subscribes to live updates from the server.
+ * - **Writing**: Converts display values back to raw controller units before sending.
  *
- * ❖ **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
+ * @remarks
+ * ❖ **Dual-State Representation**
+ * To prevent rounding errors and race conditions, we maintain two parallel states:
+ * 1. `rawValues[tagName]`: The exact value received from the controller (Source of Truth).
+ * 2. `values[tagName]`: The derived value shown in the UI (calculated from raw + scale).
  *
- * ❖ **Writes**
- * - `write(tagName, displayValue)` → (codec?) → inverse-scale → `write_value`
- * - `tap(tagName)` pulses booleans `true → (300ms) → false` with proper domain envelopes
+ * When a scale changes (e.g., user switches units), we recompute `values` from `rawValues`.
+ * We *never* rescale a previously scaled value.
  *
- * ❖ **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
+ * ❖ **Key Features**
+ * - **Resilient Initialization**: Eagerly fetches initial values (via ADS refresh or read fallback).
+ * - **Server-Stored Scales**: Can load unit preferences from the server (GNV domain).
+ * - **Optimized Updates**: Uses stable references and memoization to minimize React re-renders.
+ * - **Type Safety**: Strongly typed context via generic `VMapRuntime`.
  *
  * @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}
- *   },
+ * // 1. Define your tags
+ * const tags = [
+ *   { tagName: "position", fqdn: "ADS.Axis.Pos", valueType: "number", scale: "dist" },
+ *   { tagName: "speed",    fqdn: "ADS.Axis.Vel", valueType: "number", scale: "dist" }
+ * ];
+ *
+ * // 2. Define scales
+ * const scales = {
+ *   dist: { name: "dist", scale: 1.0, label: "mm" }
  * };
  *
- * 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>
- *     </>
- *   );
- * }
+ * // 3. Wrap application
+ * <AutoCoreTagProvider tags={tags} scales={scales}>
+ *   <App />
+ * </AutoCoreTagProvider>
  * ```
  */
 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>>;
+/**
+ * Extracts the domain (first segment) from a Fully-Qualified Domain Name.
+ * @param fqdn - The full topic path (e.g., "ads.plc1.gio.bControlPowerOk")
+ * @returns The domain segment (e.g., "ads")
+ */
 /**
  * AutoCoreTagProvider
  *
@@ -108,111 +84,9 @@ export declare const AutoCoreTagContext: React.Context<BaseContextValue<VMapRunt
  * 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>
- * ```
+ * @param props.tags - List of tag configurations (tagName, fqdn, etc.)
+ * @param props.scales - Map of scale definitions (name, factor, label)
+ * @param props.eagerRead - If true, automatically fetches initial values on mount
  */
 export declare const AutoCoreTagProvider: React.FC<{
     children: ReactNode;

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

@@ -1 +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,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,eAAO,MAAM,kBAAkB,8CAQ7B,CAAC;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CAkbA,CAAC"}
+{"version":3,"file":"AutoCoreTagContext.d.ts","sourceRoot":"","sources":["../../src/core/AutoCoreTagContext.tsx"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EAAE,EAQV,KAAK,SAAS,EACjB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EACT,WAAW,EACd,MAAM,oBAAoB,CAAC;AAI5B;;;GAGG;AACH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,8CAQ7B,CAAC;AAsBH;;;;GAIG;AAIH;;;;;;;;;;;;GAYG;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,CA0cA,CAAC"}

package/dist/core/AutoCoreTagContext.js

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