@adcops/autocore-react 3.0.39 → 3.1.1

package/src/core/ValueSimulator.ts

@@ -3,13 +3,13 @@
  * Created Date: 2024-01-18 12:49:58
  * Author: Thomas C. Bitsky Jr.
  * -----
- * Last Modified: 2024-03-08 09:33:45
+ * Last Modified: 2025-09-05 14:50:12
  * Modified By: ADC
  * -----
  * 
  */
 
-import { EmitterDispatchFunction } from "./EventEmitterContext";
+import type { EmitterDispatchFunction } from "./EventEmitterContext";
 
 
 /**

package/src/hooks/useAutoCoreTag.ts

@@ -0,0 +1,103 @@
+/*
+ * Copyright (C) 2025 Automated Design Corp.. All Rights Reserved.
+ * Created Date: 2025-09-05 08:03:32
+ * -----
+ * Last Modified: 2025-09-10 10:22:31
+ * -----
+ *
+ */
+
+/**
+ * @module hooks/useAutoCoreTag.ts
+ *
+ * Factory for generating strongly-typed React hooks to consume AutoCoreTagContext.
+ */
+
+import { useCallback, useContext, useMemo } from "react";
+import type { BaseContextValue, TagConfig, TagValueMap } from "../core/AutoCoreTagTypes";
+
+export function makeAutoCoreTagHooks<Spec extends readonly TagConfig[]>(
+  Context: React.Context<BaseContextValue<TagValueMap<Spec>>>,
+  tags: Spec
+) {
+  type VMap = TagValueMap<Spec>;
+  type TagNames = keyof VMap & string;
+
+  const findCfg = (tagName: string) =>
+    tags.find(t => t.tagName === tagName) as (Spec[number] | undefined);
+
+  /**
+   * Access a single tag by name.
+   * Returns current value, raw value, direct server writer, and tap helper.
+   */
+  const useAutoCoreTag = <K extends TagNames>(tagName: K) => {
+    const { values, rawValues, isLoading, write: ctxWrite, tap: ctxTap } = useContext(Context);
+
+    const cfg = findCfg(tagName as string);
+    if (!cfg) throw new Error(`useAutoCoreTag: unknown tagName '${String(tagName)}'`);
+
+    const write = useCallback(
+      (displayValue: VMap[K]) => ctxWrite(tagName, displayValue),
+      [ctxWrite, tagName]
+    );
+
+    const tap = useCallback(() => ctxTap?.(tagName), [ctxTap, tagName]);
+
+    return {
+      value: values[tagName] as VMap[K],
+      rawValue: rawValues[tagName as string],
+      write,
+      tap,
+      isLoading,
+    } as const;
+  };
+
+  /**
+   * Access multiple tags at once with a bulk writer.
+   */
+  const useAutoCoreTags = <K extends TagNames>(tagNames: readonly K[]) => {
+    const { values, rawValues, isLoading, write: ctxWrite } = useContext(Context);
+
+    const subset = useMemo(
+      () =>
+        Object.fromEntries(
+          tagNames.map(k => [k, values[k] as VMap[K]])
+        ) as { [P in K]: VMap[P] },
+      [values, tagNames]
+    );
+
+    const rawSubset = useMemo(
+      () =>
+        Object.fromEntries(
+          tagNames.map(k => [k, rawValues[k as string]])
+        ) as { [P in K]: unknown },
+      [rawValues, tagNames]
+    );
+
+    const write = useCallback(async (tagName: K, value: VMap[K]) => {
+      await ctxWrite(tagName, value);
+    }, [ctxWrite]);
+
+    return { values: subset, rawValues: rawSubset, write, isLoading } as const;
+  };
+
+  /**
+   * Compute a derived value from the full tag state.
+   */
+  const useAutoCoreSelect = <R>(selector: (all: Readonly<Partial<VMap>>) => R, deps: any[] = []) => {
+    const { values, isLoading } = useContext(Context);
+    const selected = useMemo(() => selector(values), [values, ...deps]);
+    return { selected, isLoading } as const;
+  };
+
+  /**
+   * Access scale configurations and update functions.
+   */
+  const useScales = () => {
+    const { scales, updateScale } = useContext(Context);
+    const getScale = useCallback((scaleName: string) => scales[scaleName], [scales]);
+    return { scales, updateScale, getScale } as const;
+  };
+
+  return { useAutoCoreTag, useAutoCoreTags, useAutoCoreSelect, useScales } as const;
+}

package/src/hub/HubBase.ts

@@ -3,14 +3,14 @@
  * Created Date: 2023-12-15 14:21:33
  * Author: Thomas C. Bitsky Jr.
  * -----
- * Last Modified: 2025-03-31 08:35:09
+ * Last Modified: 2025-09-05 14:50:03
  * Modified By: ADC
  * -----
  * 
  */
 
-import { EventEmitterContextType} from '../core/EventEmitterContext';
-import {CommandMessageResult} from "./CommandMessage";
+import type { EventEmitterContextType} from '../core/EventEmitterContext';
+import type {CommandMessageResult} from "./CommandMessage";
 
 
 /**

package/src/hub/HubSimulate.ts

@@ -2,7 +2,7 @@
  * Copyright (C) 2023 Automated Design Corp. All Rights Reserved.
  * Created Date: 2023-12-17 10:38:21
  * -----
- * Last Modified: 2024-04-24 11:56:26
+ * Last Modified: 2025-09-05 14:49:57
  * Modified By: ADC
  * -----
  * 
@@ -10,7 +10,7 @@
 
 
 import { HubBase } from './HubBase';
-import { CommandMessageResult } from "./CommandMessage";
+import type { CommandMessageResult } from "./CommandMessage";
 /**
  * Hub for simulating functionality when no backend is present.
  */

package/src/hub/HubTauri.ts

@@ -3,16 +3,16 @@
  * Created Date: 2023-12-17 09:50:23
  * Author: Thomas C. Bitsky Jr.
  * -----
- * Last Modified: 2024-04-24 11:56:32
+ * Last Modified: 2025-09-05 14:53:18
  * Modified By: ADC
  * -----
  * 
  */
 
-import { InvokeArgs } from '@tauri-apps/api/tauri';
+import type { InvokeArgs } from '@tauri-apps/api/tauri';
 import { HubBase } from './HubBase';
 import {event, invoke} from '@tauri-apps/api';
-import {CommandMessageResult} from "./CommandMessage";
+import type {CommandMessageResult} from "./CommandMessage";
 
 /**
  * Hub for integrating with the Tauri backend.

package/src/hub/HubWebSocket.ts

@@ -2,7 +2,7 @@
  * Copyright (C) 2024 Automated Design Corp.. All Rights Reserved.
  * Created Date: 2024-04-17 09:13:07
  * -----
- * Last Modified: 2025-03-31 08:35:12
+ * Last Modified: 2025-09-05 15:18:44
  * -----
  * 
  */
@@ -22,7 +22,7 @@
  */
 
 import { HubBase } from './HubBase';
-import {CommandMessage, CommandMessageResult} from "./CommandMessage";
+import type { CommandMessage, CommandMessageResult } from "./CommandMessage";
 
 // Function to parse the JSON string received from the server into a CommandMessage object
 // function parseCommandMessage(jsonString: string): CommandMessage {
@@ -57,31 +57,28 @@ interface RequestRecord {
  * @returns {Blob} A Blob object representing the decoded binary data.
  */
 function b64toBlob(
-    b64Data: string, 
-    contentType: string = 'application/octet-stream', 
+    b64Data: string,
+    contentType: string = "application/octet-stream",
     sliceSize: number = 512
 ): Blob {
-
     const byteCharacters = atob(b64Data);
-    const byteArrays: Uint8Array[] = [];
+    const buffers: ArrayBuffer[] = [];
 
     for (let offset = 0; offset < byteCharacters.length; offset += sliceSize) {
         const slice = byteCharacters.slice(offset, offset + sliceSize);
 
-        const byteNumbers: number[] = new Array(slice.length);
-        for (let i = 0; i < slice.length; i++) {
-            byteNumbers[i] = slice.charCodeAt(i);
-        }
+        const byteNumbers = new Array<number>(slice.length);
+        for (let i = 0; i < slice.length; i++) byteNumbers[i] = slice.charCodeAt(i);
 
-        const byteArray = new Uint8Array(byteNumbers);
-        byteArrays.push(byteArray);
+        const uint8 = new Uint8Array(byteNumbers);
+        buffers.push(uint8.buffer as ArrayBuffer); // <-- pass ArrayBuffer to Blob
     }
 
-    const blob = new Blob(byteArrays, { type: contentType });
-    return blob;
+    return new Blob(buffers, { type: contentType });
 }
 
 
+
 /**
  * Creates a temporary hyperlink in the document and programmatically triggers a download of the Blob provided.
  *
@@ -129,9 +126,9 @@ export class HubWebSocket extends HubBase {
      */
     constructor() {
         super();
-        
+
         const host = window.location.hostname; // Get the hostname from the address bar
-        
+
         // Default to using autocore-server.
         let port = undefined; // window.location.port; // Get the port from the address bar, if any
 
@@ -146,13 +143,13 @@ export class HubWebSocket extends HubBase {
         //
         // Websocket connection established.
         //
-        this.socket.onopen = function() {
+        this.socket.onopen = function () {
             console.log("WebSocket connection established.");
             self.publish("HUB/connected", true);
             self.setIsConnected(true);
         };
-        
-                
+
+
         // Message recevied via the websocket connection.
         //
         this.socket.onmessage = (event) => {
@@ -164,22 +161,22 @@ export class HubWebSocket extends HubBase {
 
                 const { resolve, reject } = this.pendingRequests.get(data.request_id)!;
 
-                if (data.fname === "FILE_DOWNLOAD" 
+                if (data.fname === "FILE_DOWNLOAD"
                     && data.args["file_name"] !== undefined && data.args["file_name"] !== null
                     && data.args["file_name"].length > 0
                 ) {
 
                     // The file name was supplied in the original request
                     let tokens = data.args["file_name"].split("/");
-                    
-                    const filename = tokens[tokens.length - 1]; 
+
+                    const filename = tokens[tokens.length - 1];
                     if (data.result && data.result.success) {
                         const blob = b64toBlob(data.result.data);
                         downloadBlob(blob, filename);
-                        
+
                         // Don't send the whole file through; that's crazy.
                         data.result.data = filename;
-                        
+
                         // Signal the function that initiated the download that all is well.
                         resolve(data.result);
 
@@ -190,14 +187,14 @@ export class HubWebSocket extends HubBase {
 
                 }
                 else {
-                    
+
                     if (!data.result?.success) {
                         // Return the result to the function that initiated the request.
                         reject(new Error(data.result?.error_message));
                     } else {
                         // Send the error to the function that intiated the request.
                         resolve(data.result);
-                    }    
+                    }
                 }
                 this.pendingRequests.delete(data.request_id);
             } else {
@@ -217,7 +214,7 @@ export class HubWebSocket extends HubBase {
         //
         this.socket.onclose = () => {
             self.setIsConnected(false);
-            console.log('WebSocket connection closed.');            
+            console.log('WebSocket connection closed.');
         };
     }
 
@@ -229,13 +226,13 @@ export class HubWebSocket extends HubBase {
      * @param payload The arguments of the command.
      * @returns Promise<CommandMessageResult>
      */
-    invoke = (domain : string, fname: string, payload?: object): Promise<CommandMessageResult> => {
+    invoke = (domain: string, fname: string, payload?: object): Promise<CommandMessageResult> => {
 
         return new Promise((resolve, reject) => {
             const id = ++this.requestId; // Increment and use the request ID
             this.pendingRequests.set(id, { resolve, reject });
 
-            let cm : CommandMessage = {
+            let cm: CommandMessage = {
                 request_id: id,
                 domain: domain,
                 fname: fname,
@@ -250,10 +247,10 @@ export class HubWebSocket extends HubBase {
     handleUnsolicitedMessage = (msg: CommandMessage) => {
         // Handle messages that do not correspond to a pending request
 
-        if (msg.fname === "BROADCAST" 
+        if (msg.fname === "BROADCAST"
             && msg.domain.length >= 1
             && msg.result !== undefined && msg.result !== null
-            && msg.result.data !== undefined && msg.result.data !== null            
+            && msg.result.data !== undefined && msg.result.data !== null
         ) {
 
             let topic = `${msg.domain}/${msg.result.data["topic"]}`;
@@ -266,7 +263,7 @@ export class HubWebSocket extends HubBase {
         // }
     }
 
-    disconnect= (): void => {
+    disconnect = (): void => {
         this.socket.close();
     }
 

package/src/hub/index.ts

@@ -2,7 +2,7 @@
  * Copyright (C) 2024 Automated Design Corp. All Rights Reserved.
  * Created Date: 2024-01-16 21:07:29
  * -----
- * Last Modified: 2024-05-31 07:51:19
+ * Last Modified: 2025-09-05 14:53:01
  * Modified By: ADC
  * -----
  * 
@@ -12,7 +12,7 @@ import { HubBase as Hub } from './HubBase';
 import { HubTauri } from './HubTauri';
 import { HubWebSocket } from "./HubWebSocket";
 import {HubSimulate} from "./HubSimulate"
-import { CommandMessage, CommandMessageResult } from './CommandMessage';
+import type { CommandMessage, CommandMessageResult } from './CommandMessage';
 
 
 let hubInstance: Hub | null = null;

package/tsconfig.json

@@ -1,34 +1,49 @@
 {
     "compilerOptions": {
-      "target": "ES2020", // Set the JavaScript language version for emitted JavaScript and include compatible library declarations
-      "outDir": "./dist", // Specify an output folder for all emitted files
-      "useDefineForClassFields": true, // Use 'define' semantics for class fields (as opposed to 'set')
-  
-      // Specify a set of compiled-in library files to be included in the compilation context
-      "lib": ["ES2020", "DOM", "DOM.Iterable"], 
-  
-      "module": "ESNext", // Specify what module code is generated (here, it's the latest module standard)
-      "declaration": true, // Generate the types files (*.d.ts)      
-      "skipLibCheck": true, // Skip type checking of declaration files (*.d.ts)
+        "target": "ES2020", // Set the JavaScript language version for emitted JavaScript and include compatible library declarations
+        "outDir": "./dist", // Specify an output folder for all emitted files
+        "useDefineForClassFields": true, // Use 'define' semantics for class fields (as opposed to 'set')
+        // Specify a set of compiled-in library files to be included in the compilation context
+        "lib": [
+            "ES2020",
+            "DOM",
+            "DOM.Iterable"
+        ],
+        "module": "ESNext", // Specify what module code is generated (here, it's the latest module standard)
+        "declaration": true, // Generate the types files (*.d.ts)      
+        "skipLibCheck": true, // Skip type checking of declaration files (*.d.ts)
+        /* Bundler mode */
+        "moduleResolution": "bundler", // "node", // Choose the module resolution strategy: 'node' for Node.js
+        "allowSyntheticDefaultImports": true, // Allow default imports from modules with no default export
+        "resolveJsonModule": true, // Include modules imported with '.json' extension
+        "isolatedModules": true, // Ensure each file can be safely transpiled without relying on other imports
+        "noEmit": false, // Do not emit outputs (if set to true, no files are emitted)
+        "jsx": "react-jsx", // Specify JSX code generation: 'preserve', 'react', or 'react-jsx' (new transform)
+        /* Linting */
+        "strict": true, // Enable all strict type checking options
+        "noUnusedLocals": true, // Report errors on unused locals
+        "noUnusedParameters": true, // Report errors on unused parameters
+        "noFallthroughCasesInSwitch": true, // Report errors for fallthrough cases in switch statement
 
-      /* Bundler mode */
-      "moduleResolution": "node", // Choose the module resolution strategy: 'node' for Node.js
-      "allowSyntheticDefaultImports": true, // Allow default imports from modules with no default export
-      "resolveJsonModule": true, // Include modules imported with '.json' extension
-      "isolatedModules": true, // Ensure each file can be safely transpiled without relying on other imports
-      "noEmit": false, // Do not emit outputs (if set to true, no files are emitted)
-      "jsx": "react-jsx", // Specify JSX code generation: 'preserve', 'react', or 'react-jsx' (new transform)
-  
-      /* Linting */
-      "strict": true, // Enable all strict type checking options
-      "noUnusedLocals": true, // Report errors on unused locals
-      "noUnusedParameters": true, // Report errors on unused parameters
-      "noFallthroughCasesInSwitch": true // Report errors for fallthrough cases in switch statement
+        /* publish doc along with js code to help with auto-completion */
+        "declarationMap": true, // nice for “go to definition”
+        "emitDeclarationOnly": false, // we want JS + types (default is fine)
+        "removeComments": false, // JS comments: optional; .d.ts will still carry JSDoc
+        "stripInternal": true, // hides /** @internal */ APIs from .d.ts (optional)
+
+        /*  helpful for cross-platform support */
+        "forceConsistentCasingInFileNames": true, 
+
+
+
+        "rootDir" : "src",
+        "verbatimModuleSyntax": true, // This keeps import/export syntax intact and avoids synthetic re-exports TS sometimes injects:
     },
-    "include": ["src"], // Specify file glob patterns to include in the program
-    "exclude": [        // Specify file globa patterns to exclude from compilation
+    "include": [
+        "src"
+    ], // Specify file glob patterns to include in the program
+    "exclude": [ // Specify file globa patterns to exclude from compilation
         "node_modules",
         "dist"
-    ]    
-  }
-  
+    ]
+}