@luxonis/depthai-viewer-common 3.8.1 → 3.8.3

package/dist/providers/ThemeProvider.js

@@ -2,19 +2,37 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import React from 'react';
 import { noop } from '../utils/functions.js';
 import { getItemFromLocalStorage, setItemToLocalStorage } from '../utils/local-storage.js';
+/**
+ * Supported theme preferences shown by the theme picker.
+ */
 export const THEME_PREFERENCES = ['light', 'dark', 'system'];
 const DARK_CLASS = 'dark';
 const COLOR_SCHEME_QUERY = '(prefers-color-scheme: dark)';
 const isThemePreference = (value) => THEME_PREFERENCES.includes(value);
 const prefersDark = () => typeof window !== 'undefined' && window.matchMedia(COLOR_SCHEME_QUERY).matches;
+/**
+ * Resolves a user theme preference into the theme currently rendered by the UI.
+ *
+ * @param preference - User-selected theme preference.
+ * @returns Concrete light or dark theme.
+ */
 export const resolveTheme = (preference) => preference === 'system' ? (prefersDark() ? 'dark' : 'light') : preference;
+/**
+ * Reads the stored theme preference from local storage.
+ *
+ * @returns Stored theme preference, or `system` when the stored value is missing or invalid.
+ */
 export const readStoredTheme = () => {
     const stored = getItemFromLocalStorage('theme');
     return isThemePreference(stored) ? stored : 'system';
 };
 /**
- * Applied both from React and from the inline bootstrap script in index.html, which
- * runs before first paint so the app never flashes the light theme on load.
+ * Applies a resolved theme to the document root.
+ *
+ * @remarks
+ * This toggles the `dark` class on `document.documentElement`. It is used both from
+ * React and from the inline bootstrap script in `index.html`, which runs before first
+ * paint so the app never flashes the light theme on load.
  */
 export const applyTheme = (theme) => {
     document.documentElement.classList.toggle(DARK_CLASS, theme === 'dark');
@@ -25,7 +43,26 @@ const ThemeContext = React.createContext({
     setTheme: noop,
     toggleTheme: noop,
 });
+/**
+ * Returns the current theme context.
+ *
+ * @remarks
+ * Outside {@link ThemeProvider}, this hook returns the default system/light context.
+ */
 export const useTheme = () => React.useContext(ThemeContext);
+/**
+ * Provides shared theme state and keeps DOM/local storage in sync.
+ *
+ * @remarks
+ * The provider reads the initial preference from local storage, follows OS theme changes
+ * while the preference is `system`, persists explicit user changes, and applies the
+ * resolved theme to the document root.
+ *
+ * @example
+ * ```tsx
+ * <ThemeProvider>{children}</ThemeProvider>
+ * ```
+ */
 export const ThemeProvider = ({ children }) => {
     const [theme, setThemeState] = React.useState(readStoredTheme);
     const [systemTheme, setSystemTheme] = React.useState(() => prefersDark() ? 'dark' : 'light');

package/dist/providers/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/providers/ThemeProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../src/providers/ThemeProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAe3F;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEhF,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAE1D,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE,CACtE,iBAAiB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAC;AAEtD,MAAM,WAAW,GAAG,GAAG,EAAE,CACxB,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAA2B,EAAiB,EAAE,CAC1E,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAoB,EAAE;IACpD,MAAM,MAAM,GAAG,uBAAuB,CAAkB,OAAO,CAAC,CAAC;IACjE,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAE,EAAE;IAClD,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC;AACzE,CAAC,CAAC;AA4BF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAe;IACtD,KAAK,EAAE,QAAQ;IACf,aAAa,EAAE,OAAO;IACtB,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;CACjB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAChF,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAkB,eAAe,CAAC,CAAC;IAChF,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,GAAG,EAAE,CACxE,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAChC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;IAE/D,0DAA0D;IAC1D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,CAAC,KAA0B,EAAE,EAAE;YACnD,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC,CAAC;QAEF,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,UAAU,CAAC,aAAa,CAAC,CAAC;IAC3B,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,IAAqB,EAAE,EAAE;QAC5D,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QAC1C,QAAQ,CAAC,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EACvD,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,CAAC,CAC7C,CAAC;IAEF,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAyB,CAAC;AAChF,CAAC,CAAC"}

package/dist/providers/VisualizerRuntimeConfigProvider.d.ts

@@ -1,17 +1,57 @@
 import React from 'react';
 import { type RuntimeConfig } from '../visualizer/index.js';
 export declare const STREAM_DIAGNOSTICS_LOCAL_STORAGE_KEY: "viewer-stream-diagnostics-enabled";
-type VisualizerRuntimeConfigContextValue = {
+/**
+ * Runtime configuration state exposed to visualizer consumers.
+ */
+export type VisualizerRuntimeConfigContextValue = {
+    /**
+     * Current immutable visualizer runtime configuration.
+     */
     runtimeConfig: Readonly<RuntimeConfig>;
+    /**
+     * Merges a partial runtime configuration into the current value.
+     */
     updateRuntimeConfig: (runtimeConfig: Readonly<RuntimeConfig>) => void;
+    /**
+     * Updates the maximum expected stereo depth value in millimeters.
+     */
     setStereoDepthMaxValue: (value: number | undefined) => void;
+    /**
+     * Enables or disables perspective rendering for point cloud panels.
+     */
     setPerspective: (value: boolean | undefined) => void;
+    /**
+     * Updates neural camera intrinsics used by depth and point cloud decoding.
+     */
     setNeuralCameraIntrinsics: (value: RuntimeConfig['neuralCameraIntrinsics']) => void;
 };
-type VisualizerRuntimeConfigProviderProps = React.PropsWithChildren<{
+/**
+ * Props for the visualizer runtime configuration provider.
+ */
+export type VisualizerRuntimeConfigProviderProps = React.PropsWithChildren<{
+    /**
+     * Runtime configuration applied on initial render before any user changes.
+     */
     initialRuntimeConfig?: Readonly<RuntimeConfig>;
 }>;
+/**
+ * Provides visualizer runtime settings and synchronizes them with the shared visualizer runtime store.
+ *
+ * @remarks
+ * Initial values are merged with persisted runtime settings, then updates are mirrored
+ * into the visualizer runtime store used by stream panels.
+ *
+ * @example
+ * ```tsx
+ * <VisualizerRuntimeConfigProvider initialRuntimeConfig={{ debugLogs: true }}>
+ * 	{children}
+ * </VisualizerRuntimeConfigProvider>
+ * ```
+ */
 export declare const VisualizerRuntimeConfigProvider: React.FC<VisualizerRuntimeConfigProviderProps>;
+/**
+ * Returns the current visualizer runtime configuration context.
+ */
 export declare function useVisualizerRuntimeConfig(): VisualizerRuntimeConfigContextValue;
-export {};
 //# sourceMappingURL=VisualizerRuntimeConfigProvider.d.ts.map

package/dist/providers/VisualizerRuntimeConfigProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VisualizerRuntimeConfigProvider.d.ts","sourceRoot":"","sources":["../../src/providers/VisualizerRuntimeConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAEN,KAAK,aAAa,EAClB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,oCAAoC,EAAG,mCAA4C,CAAC;AAGjG,KAAK,mCAAmC,GAAG;IAC1C,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IACtE,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5D,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,yBAAyB,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,wBAAwB,CAAC,KAAK,IAAI,CAAC;CACpF,CAAC;AA2BF,KAAK,oCAAoC,GAAG,KAAK,CAAC,iBAAiB,CAAC;IACnE,oBAAoB,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH,eAAO,MAAM,+BAA+B,EAAE,KAAK,CAAC,EAAE,CAAC,oCAAoC,CAkF1F,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}
+{"version":3,"file":"VisualizerRuntimeConfigProvider.d.ts","sourceRoot":"","sources":["../../src/providers/VisualizerRuntimeConfigProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAEN,KAAK,aAAa,EAClB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,oCAAoC,EAAG,mCAA4C,CAAC;AAGjG;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG;IACjD;;OAEG;IACH,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACvC;;OAEG;IACH,mBAAmB,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IACtE;;OAEG;IACH,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5D;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD;;OAEG;IACH,yBAAyB,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,wBAAwB,CAAC,KAAK,IAAI,CAAC;CACpF,CAAC;AA2BF;;GAEG;AACH,MAAM,MAAM,oCAAoC,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC1E;;OAEG;IACH,oBAAoB,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,+BAA+B,EAAE,KAAK,CAAC,EAAE,CAAC,oCAAoC,CAkF1F,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}

package/dist/providers/VisualizerRuntimeConfigProvider.js

@@ -17,7 +17,7 @@ function readPersistedStreamDiagnostics() {
 }
 function readPersistedStereoDepthMaxValue() {
     const rawValue = globalThis.localStorage?.getItem(STEREO_DEPTH_MAX_VALUE_STORAGE_KEY);
-    // biome-ignore lint/suspicious/noDoubleEquals: <explanation>
+    // biome-ignore lint/suspicious/noDoubleEquals: Treat null and undefined as missing persisted data.
     if (rawValue == undefined) {
         return undefined;
     }
@@ -26,6 +26,20 @@ function readPersistedStereoDepthMaxValue() {
         ? parsedValue
         : DEFAULT_STEREO_DEPTH_MAX_VALUE;
 }
+/**
+ * Provides visualizer runtime settings and synchronizes them with the shared visualizer runtime store.
+ *
+ * @remarks
+ * Initial values are merged with persisted runtime settings, then updates are mirrored
+ * into the visualizer runtime store used by stream panels.
+ *
+ * @example
+ * ```tsx
+ * <VisualizerRuntimeConfigProvider initialRuntimeConfig={{ debugLogs: true }}>
+ * 	{children}
+ * </VisualizerRuntimeConfigProvider>
+ * ```
+ */
 export const VisualizerRuntimeConfigProvider = ({ children, initialRuntimeConfig, }) => {
     const [runtimeConfig, setRuntimeConfigState] = React.useState(() => ({
         stereoDepthMaxValue: initialRuntimeConfig?.stereoDepthMaxValue ?? readPersistedStereoDepthMaxValue(),
@@ -35,7 +49,7 @@ export const VisualizerRuntimeConfigProvider = ({ children, initialRuntimeConfig
         streamDiagnostics: initialRuntimeConfig?.streamDiagnostics ?? readPersistedStreamDiagnostics(),
     }));
     const updateRuntimeConfig = React.useCallback((nextRuntimeConfig) => {
-        // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+        // biome-ignore lint/suspicious/noExplicitAny: React state updater merges partial runtime config.
         setRuntimeConfigState((currentRuntimeConfig) => ({
             ...currentRuntimeConfig,
             ...nextRuntimeConfig,
@@ -55,7 +69,7 @@ export const VisualizerRuntimeConfigProvider = ({ children, initialRuntimeConfig
     }, [runtimeConfig]);
     React.useEffect(() => {
         const stereoDepthMaxValue = runtimeConfig.stereoDepthMaxValue;
-        // biome-ignore lint/suspicious/noDoubleEquals: <explanation>
+        // biome-ignore lint/suspicious/noDoubleEquals: Treat null and undefined as missing runtime config.
         if (stereoDepthMaxValue == undefined) {
             globalThis.localStorage?.removeItem(STEREO_DEPTH_MAX_VALUE_STORAGE_KEY);
             return;
@@ -77,6 +91,9 @@ export const VisualizerRuntimeConfigProvider = ({ children, initialRuntimeConfig
     ]);
     return (_jsx(VisualizerRuntimeConfigContext.Provider, { value: contextValue, children: children }));
 };
+/**
+ * Returns the current visualizer runtime configuration context.
+ */
 export function useVisualizerRuntimeConfig() {
     return React.useContext(VisualizerRuntimeConfigContext);
 }

package/dist/providers/VisualizerRuntimeConfigProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"VisualizerRuntimeConfigProvider.js","sourceRoot":"","sources":["../../src/providers/VisualizerRuntimeConfigProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"VisualizerRuntimeConfigProvider.js","sourceRoot":"","sources":["../../src/providers/VisualizerRuntimeConfigProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EACN,gBAAgB,IAAI,4BAA4B,GAEhD,MAAM,wBAAwB,CAAC;AAEhC,MAAM,kCAAkC,GAAG,qBAA8B,CAAC;AAC1E,MAAM,CAAC,MAAM,oCAAoC,GAAG,mCAA4C,CAAC;AACjG,MAAM,8BAA8B,GAAG,IAAa,CAAC;AA4BrD,MAAM,8BAA8B,GAAG,KAAK,CAAC,aAAa,CAAsC;IAC/F,aAAa,EAAE,EAAE;IACjB,mBAAmB,EAAE,IAAI;IACzB,sBAAsB,EAAE,IAAI;IAC5B,cAAc,EAAE,IAAI;IACpB,yBAAyB,EAAE,IAAI;CAC/B,CAAC,CAAC;AAEH,SAAS,8BAA8B;IACtC,OAAO,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,oCAAoC,CAAC,KAAK,MAAM,CAAC;AAC1F,CAAC;AAED,SAAS,gCAAgC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,kCAAkC,CAAC,CAAC;IACtF,mGAAmG;IACnG,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC;QACrD,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,8BAA8B,CAAC;AACnC,CAAC;AAYD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAmD,CAAC,EAC/F,QAAQ,EACR,oBAAoB,GACpB,EAAE,EAAE;IACJ,MAAM,CAAC,aAAa,EAAE,qBAAqB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAA0B,GAAG,EAAE,CAAC,CAAC;QAC7F,mBAAmB,EAClB,oBAAoB,EAAE,mBAAmB,IAAI,gCAAgC,EAAE;QAChF,WAAW,EAAE,oBAAoB,EAAE,WAAW;QAC9C,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB;QACpE,SAAS,EAAE,oBAAoB,EAAE,SAAS;QAC1C,iBAAiB,EAAE,oBAAoB,EAAE,iBAAiB,IAAI,8BAA8B,EAAE;KAC9F,CAAC,CAAC,CAAC;IAEJ,MAAM,mBAAmB,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,iBAA0C,EAAE,EAAE;QAC5F,iGAAiG;QACjG,qBAAqB,CAAC,CAAC,oBAAyB,EAAE,EAAE,CAAC,CAAC;YACrD,GAAG,oBAAoB;YACvB,GAAG,iBAAiB;SACpB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,sBAAsB,GAAG,KAAK,CAAC,WAAW,CAC/C,CAAC,KAAyB,EAAE,EAAE;QAC7B,mBAAmB,CAAC,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC,EACD,CAAC,mBAAmB,CAAC,CACrB,CAAC;IAEF,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,CACvC,CAAC,KAA0B,EAAE,EAAE;QAC9B,mBAAmB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,CAAC,EACD,CAAC,mBAAmB,CAAC,CACrB,CAAC;IAEF,MAAM,yBAAyB,GAAG,KAAK,CAAC,WAAW,CAClD,CAAC,KAA8C,EAAE,EAAE;QAClD,mBAAmB,CAAC,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC,EACD,CAAC,mBAAmB,CAAC,CACrB,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,4BAA4B,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,MAAM,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC;QAC9D,mGAAmG;QACnG,IAAI,mBAAmB,IAAI,SAAS,EAAE,CAAC;YACtC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,kCAAkC,CAAC,CAAC;YACxE,OAAO;QACR,CAAC;QAED,UAAU,CAAC,YAAY,EAAE,OAAO,CAC/B,kCAAkC,EAClC,mBAAmB,CAAC,QAAQ,EAAE,CAC9B,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CACjC,GAAG,EAAE,CAAC,CAAC;QACN,aAAa;QACb,mBAAmB;QACnB,sBAAsB;QACtB,cAAc;QACd,yBAAyB;KACzB,CAAC,EACF;QACC,aAAa;QACb,mBAAmB;QACnB,sBAAsB;QACtB,cAAc;QACd,yBAAyB;KACzB,CACD,CAAC;IAEF,OAAO,CACN,KAAC,8BAA8B,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YAC1D,QAAQ,GACgC,CAC1C,CAAC;AACH,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACzC,OAAO,KAAK,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;AACzD,CAAC"}

package/dist/utils/arrays.d.ts

@@ -1,2 +1,9 @@
+/**
+ * Splits a flat list into rows with a fixed number of columns.
+ *
+ * @param list - Items to split.
+ * @param columns - Number of items per row, or `null` to keep all items in one row.
+ * @returns Two-dimensional row layout.
+ */
 export declare function makeColumns<T>(list: T[], columns: number | null): T[][];
 //# sourceMappingURL=arrays.d.ts.map

package/dist/utils/arrays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAWvE"}
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAWvE"}

package/dist/utils/arrays.js

@@ -1,3 +1,10 @@
+/**
+ * Splits a flat list into rows with a fixed number of columns.
+ *
+ * @param list - Items to split.
+ * @param columns - Number of items per row, or `null` to keep all items in one row.
+ * @returns Two-dimensional row layout.
+ */
 export function makeColumns(list, columns) {
     if (!columns) {
         return [list];

package/dist/utils/arrays.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAI,IAAS,EAAE,OAAsB;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../src/utils/arrays.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,IAAS,EAAE,OAAsB;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/utils/functions.d.ts

@@ -1,2 +1,5 @@
+/**
+ * Empty callback used as a stable default function.
+ */
 export declare const noop: () => void;
 //# sourceMappingURL=functions.d.ts.map

package/dist/utils/functions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/utils/functions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,YAEhB,CAAC"}
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/utils/functions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,IAAI,YAEhB,CAAC"}

package/dist/utils/functions.js

@@ -1,3 +1,6 @@
+/**
+ * Empty callback used as a stable default function.
+ */
 export const noop = () => {
     /* no-op */
 };

package/dist/utils/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/utils/functions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE;IACxB,WAAW;AACZ,CAAC,CAAC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/utils/functions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE;IACxB,WAAW;AACZ,CAAC,CAAC"}

package/dist/utils/local-storage.d.ts

@@ -1,5 +1,25 @@
+/**
+ * Local storage keys managed by the common viewer package.
+ */
 export type LocalStorageItems = 'topicList' | 'analyticsEnabled' | 'theme';
+/**
+ * Reads and parses a JSON value from local storage.
+ *
+ * @param key - Known local storage key.
+ * @returns Parsed value, or `null` when the key is not present.
+ */
 export declare function getItemFromLocalStorage<T>(key: LocalStorageItems): T | null;
+/**
+ * Serializes and stores a value in local storage.
+ *
+ * @param key - Known local storage key.
+ * @param value - Value to serialize.
+ */
 export declare function setItemToLocalStorage(key: LocalStorageItems, value: unknown): void;
+/**
+ * Removes a managed key from local storage.
+ *
+ * @param key - Known local storage key.
+ */
 export declare function removeItemFromLocalStorage(key: LocalStorageItems): void;
 //# sourceMappingURL=local-storage.d.ts.map

package/dist/utils/local-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/utils/local-storage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE3E,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,QAE3E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,iBAAiB,QAEhE"}
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/utils/local-storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAQ3E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,QAE3E;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,iBAAiB,QAEhE"}

package/dist/utils/local-storage.js

@@ -1,3 +1,9 @@
+/**
+ * Reads and parses a JSON value from local storage.
+ *
+ * @param key - Known local storage key.
+ * @returns Parsed value, or `null` when the key is not present.
+ */
 export function getItemFromLocalStorage(key) {
     const itemInStorage = localStorage.getItem(key);
     if (!itemInStorage) {
@@ -5,9 +11,20 @@ export function getItemFromLocalStorage(key) {
     }
     return JSON.parse(itemInStorage);
 }
+/**
+ * Serializes and stores a value in local storage.
+ *
+ * @param key - Known local storage key.
+ * @param value - Value to serialize.
+ */
 export function setItemToLocalStorage(key, value) {
     localStorage.setItem(key, JSON.stringify(value));
 }
+/**
+ * Removes a managed key from local storage.
+ *
+ * @param key - Known local storage key.
+ */
 export function removeItemFromLocalStorage(key) {
     localStorage.removeItem(key);
 }

package/dist/utils/local-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.js","sourceRoot":"","sources":["../../src/utils/local-storage.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAI,GAAsB;IAChE,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAsB,EAAE,KAAc;IAC3E,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAsB;IAChE,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"local-storage.js","sourceRoot":"","sources":["../../src/utils/local-storage.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAI,GAAsB;IAChE,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEhD,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAM,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAsB,EAAE,KAAc;IAC3E,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAsB;IAChE,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/logger.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Local storage key controlling whether Viewer debug logs are enabled.
+ */
 export declare const DEBUG_LOGS_LOCAL_STORAGE_KEY: "viewer-debug-logs-enabled";
 type ElectronLogLevel = 'TRACE' | 'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'CRITICAL';
 declare global {
@@ -11,17 +14,45 @@ declare global {
         };
     }
 }
+/**
+ * Singleton logger used by Viewer and Visualizer code paths.
+ *
+ * @remarks
+ * Debug output is controlled by `DEBUG_LOGS_LOCAL_STORAGE_KEY`. When Electron log forwarding is
+ * available, messages are also forwarded to the native host on a best-effort basis.
+ */
 export declare class Logger {
     protected static instance: Logger | null;
     private static _debugLogsEnabled;
     protected constructor();
+    /**
+     * Whether debug logs are currently enabled.
+     */
     static get debugLogsEnabled(): boolean;
     static set debugLogsEnabled(value: boolean);
+    /**
+     * Writes an informational log entry when debug logs are enabled.
+     */
     log(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Writes an informational log entry when debug logs are enabled.
+     */
     info(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Writes a debug log entry when debug logs are enabled.
+     */
     debug(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Writes a warning log entry when debug logs are enabled.
+     */
     warn(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Writes an error log entry when debug logs are enabled.
+     */
     error(message?: any, ...optionalParams: any[]): void;
+    /**
+     * Returns the shared logger instance.
+     */
     static getLogger(): Logger;
 }
 export {};

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,EAAG,2BAAoC,CAAC;AAEjF,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEnF,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,UAAU,CAAC,EAAE;YACZ,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;gBAChB,EAAE,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,gBAAgB,CAAC;gBACxB,OAAO,EAAE,MAAM,CAAC;aAChB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACvB,CAAC;KACF;CACD;AA6CD,qBAAa,MAAM;IAClB,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAwB;IAExD,SAAS;IAET,MAAM,KAAK,gBAAgB,IAAI,OAAO,CAOrC;IAED,MAAM,KAAK,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAGzC;IAGM,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAQlD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAQnD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAQpD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAQnD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;WAO7C,SAAS,IAAI,MAAM;CAOjC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAG,2BAAoC,CAAC;AAEjF,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEnF,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,UAAU,CAAC,EAAE;YACZ,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;gBAChB,EAAE,EAAE,MAAM,CAAC;gBACX,KAAK,EAAE,gBAAgB,CAAC;gBACxB,OAAO,EAAE,MAAM,CAAC;aAChB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SACvB,CAAC;KACF;CACD;AA2CD;;;;;;GAMG;AACH,qBAAa,MAAM;IAClB,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAwB;IAExD,SAAS;IAET;;OAEG;IACH,MAAM,KAAK,gBAAgB,IAAI,OAAO,CAOrC;IAED,MAAM,KAAK,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAGzC;IAED;;OAEG;IAEI,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAOzD;;OAEG;IAEI,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAO1D;;OAEG;IAEI,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAO3D;;OAEG;IAEI,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAO1D;;OAEG;IAEI,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI;IAO3D;;OAEG;WACW,SAAS,IAAI,MAAM;CAOjC"}

package/dist/utils/logger.js

@@ -1,3 +1,6 @@
+/**
+ * Local storage key controlling whether Viewer debug logs are enabled.
+ */
 export const DEBUG_LOGS_LOCAL_STORAGE_KEY = 'viewer-debug-logs-enabled';
 function stringifyLogPart(value) {
     if (typeof value === 'string') {
@@ -34,12 +37,20 @@ function forwardToElectron(level, message, optionalParams) {
         // Electron log forwarding is best-effort and must never affect consumers.
     }
 }
-// Singleton class used for logging across our apps
-// Is controlled by DEBUG_LOGS_LOCAL_STORAGE_KEY key
+/**
+ * Singleton logger used by Viewer and Visualizer code paths.
+ *
+ * @remarks
+ * Debug output is controlled by `DEBUG_LOGS_LOCAL_STORAGE_KEY`. When Electron log forwarding is
+ * available, messages are also forwarded to the native host on a best-effort basis.
+ */
 export class Logger {
     static instance = null;
     static _debugLogsEnabled = null;
     constructor() { }
+    /**
+     * Whether debug logs are currently enabled.
+     */
     static get debugLogsEnabled() {
         if (Logger._debugLogsEnabled === null) {
             const storedValue = localStorage.getItem(DEBUG_LOGS_LOCAL_STORAGE_KEY);
@@ -51,41 +62,59 @@ export class Logger {
         Logger._debugLogsEnabled = value;
         localStorage.setItem(DEBUG_LOGS_LOCAL_STORAGE_KEY, value ? 'true' : 'false');
     }
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    /**
+     * Writes an informational log entry when debug logs are enabled.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: Logger methods intentionally match console signatures.
     log(message, ...optionalParams) {
         if (Logger.debugLogsEnabled) {
             console.log(message, ...optionalParams);
             forwardToElectron('INFO', message, optionalParams);
         }
     }
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    /**
+     * Writes an informational log entry when debug logs are enabled.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: Logger methods intentionally match console signatures.
     info(message, ...optionalParams) {
         if (Logger.debugLogsEnabled) {
             console.log(message, ...optionalParams);
             forwardToElectron('INFO', message, optionalParams);
         }
     }
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    /**
+     * Writes a debug log entry when debug logs are enabled.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: Logger methods intentionally match console signatures.
     debug(message, ...optionalParams) {
         if (Logger.debugLogsEnabled) {
             console.debug(message, ...optionalParams);
             forwardToElectron('DEBUG', message, optionalParams);
         }
     }
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    /**
+     * Writes a warning log entry when debug logs are enabled.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: Logger methods intentionally match console signatures.
     warn(message, ...optionalParams) {
         if (Logger.debugLogsEnabled) {
             console.warn(message, ...optionalParams);
             forwardToElectron('WARN', message, optionalParams);
         }
     }
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    /**
+     * Writes an error log entry when debug logs are enabled.
+     */
+    // biome-ignore lint/suspicious/noExplicitAny: Logger methods intentionally match console signatures.
     error(message, ...optionalParams) {
         if (Logger.debugLogsEnabled) {
             console.error(message, ...optionalParams);
             forwardToElectron('ERROR', message, optionalParams);
         }
     }
+    /**
+     * Returns the shared logger instance.
+     */
     static getLogger() {
         if (!Logger.instance) {
             Logger.instance = new Logger();

package/dist/utils/logger.js.map

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

package/dist/utils/sorting.d.ts

@@ -1,3 +1,9 @@
 import type { Topic } from '../hooks/connection.js';
+/**
+ * Sorts stream topics using the default Viewer display order.
+ *
+ * @param streams - Topics to sort in place.
+ * @returns The same array sorted by preferred stream order.
+ */
 export declare function sortStreamsDefault(streams: Topic[]): Topic[];
 //# sourceMappingURL=sorting.d.ts.map

package/dist/utils/sorting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../src/utils/sorting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAcpD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,WAmBlD"}
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../src/utils/sorting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAcpD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAAE,WAmBlD"}

package/dist/utils/sorting.js

@@ -10,6 +10,12 @@ const PreferredStreamOrder = [
     StreamTypes.RightRaw,
     StreamTypes.Depth,
 ];
+/**
+ * Sorts stream topics using the default Viewer display order.
+ *
+ * @param streams - Topics to sort in place.
+ * @returns The same array sorted by preferred stream order.
+ */
 export function sortStreamsDefault(streams) {
     return streams.sort((a, b) => {
         const indexA = PreferredStreamOrder.indexOf(a.name);

package/dist/utils/sorting.js.map

@@ -1 +1 @@
-{"version":3,"file":"sorting.js","sourceRoot":"","sources":["../../src/utils/sorting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,oBAAoB,GAAa;IACtC,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,GAAG;IACf,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,UAAU;IACtB,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,YAAY;IACxB,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,KAAK;CACjB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,CAAC;QACV,CAAC;QAED,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACV,CAAC;QAED,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC,CAAC;QACX,CAAC;QAED,OAAO,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sorting.js","sourceRoot":"","sources":["../../src/utils/sorting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,oBAAoB,GAAa;IACtC,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,GAAG;IACf,WAAW,CAAC,SAAS;IACrB,WAAW,CAAC,UAAU;IACtB,WAAW,CAAC,WAAW;IACvB,WAAW,CAAC,OAAO;IACnB,WAAW,CAAC,YAAY;IACxB,WAAW,CAAC,QAAQ;IACpB,WAAW,CAAC,KAAK;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,CAAC;QACV,CAAC;QAED,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACV,CAAC;QAED,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC,CAAC;QACX,CAAC;QAED,OAAO,MAAM,GAAG,MAAM,CAAC;IACxB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/topic.d.ts

@@ -1,5 +1,11 @@
 import { type StreamType } from '../constants/streams.js';
+/**
+ * Returns whether a topic name represents the point cloud stream.
+ */
 export declare function isPointCloudTopic(topic: string): boolean;
+/**
+ * Mapping from stream topic names to display group labels.
+ */
 export type TopicGroup = {
     [key in StreamType | string]: string;
 };

package/dist/utils/topic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["../../src/utils/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,yBAAyB,CAAC;AAEvE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,MAAM,MAAM,UAAU,GAAG;KACvB,GAAG,IAAI,UAAU,GAAG,MAAM,GAAG,MAAM;CACpC,CAAC"}
+{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["../../src/utils/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,yBAAyB,CAAC;AAEvE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;KACvB,GAAG,IAAI,UAAU,GAAG,MAAM,GAAG,MAAM;CACpC,CAAC"}

package/dist/utils/topic.js

@@ -1,4 +1,7 @@
 import { StreamTypes } from '../constants/streams.js';
+/**
+ * Returns whether a topic name represents the point cloud stream.
+ */
 export function isPointCloudTopic(topic) {
     return topic === StreamTypes.PointCloud;
 }

package/dist/utils/topic.js.map

@@ -1 +1 @@
-{"version":3,"file":"topic.js","sourceRoot":"","sources":["../../src/utils/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,OAAO,KAAK,KAAK,WAAW,CAAC,UAAU,CAAC;AACzC,CAAC"}
+{"version":3,"file":"topic.js","sourceRoot":"","sources":["../../src/utils/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,OAAO,KAAK,KAAK,WAAW,CAAC,UAAU,CAAC;AACzC,CAAC"}

package/dist/utils/units.d.ts

@@ -1,9 +1,33 @@
+/**
+ * Converts millimeters to the metric value shown in stream overlays.
+ */
 export declare function millimetersToMetricsViewValue(mmValue: number): number;
+/**
+ * Converts millimeters to centimeters with configurable decimal precision.
+ */
 export declare function millimetersToCentimeters(mmValue: number, precision?: number): number;
+/**
+ * Converts millimeters to meters with configurable decimal precision.
+ */
 export declare function millimetersToMeters(mmValue: number, precision?: number): number;
+/**
+ * Converts millimeters to the imperial value shown in stream overlays.
+ */
 export declare function millimetersToImperialViewValue(mmValue: number): number;
+/**
+ * Converts millimeters to inches with configurable decimal precision.
+ */
 export declare function millimetersToInches(mmValue: number, precision?: number): number;
+/**
+ * Converts millimeters to feet with configurable decimal precision.
+ */
 export declare function millimetersToFeet(mmValue: number, precision?: number): number;
+/**
+ * Returns the metric unit label used for a millimeter distance.
+ */
 export declare function millimetersToMetricsUnit(mmValue: number): string;
+/**
+ * Returns the imperial unit label used for a millimeter distance.
+ */
 export declare function millimetersToImperialUnit(mmValue: number): string;
 //# sourceMappingURL=units.d.ts.map