@umodeapporg/ui 0.0.0-canary.ca10e69

package/dist/hooks/useFileAttachments.js

@@ -0,0 +1,158 @@
+import { useState, useRef, useEffect, useCallback, useMemo } from "react";
+import { useTranslation } from "react-i18next";
+import { uiLogger } from "../helpers/uiLogger.js";
+import { generateUUID } from "../helpers/utilityHelpers.js";
+import { useNotification } from "./useNotification.js";
+import { compressImageFile } from "../helpers/imageCompression.js";
+const DEFAULT_MAX_FILES = 10;
+const DEFAULT_MAX_FILE_SIZE_BYTES = 50 * 1024 * 1024;
+const previewUrlFor = (file) => {
+  if (file.type.startsWith("image/") || file.type.startsWith("video/")) return URL.createObjectURL(file);
+  return null;
+};
+let sharedUploader = null;
+const configureSharedFileUploader = (uploader) => {
+  sharedUploader = uploader;
+};
+const defaultUploader = (file, options) => {
+  if (!sharedUploader) throw new Error("No shared file uploader configured");
+  return sharedUploader(file, options);
+};
+const useFileAttachments = (options = {}) => {
+  const {
+    uploadFile = defaultUploader,
+    maxFiles = DEFAULT_MAX_FILES,
+    maxFileSizeBytes = DEFAULT_MAX_FILE_SIZE_BYTES,
+    compressImages = true
+  } = options;
+  const { t } = useTranslation("ui");
+  const { notify } = useNotification();
+  const [stagedAttachments, setStagedAttachments] = useState([]);
+  const abortControllersRef = useRef(/* @__PURE__ */ new Map());
+  const stagedRef = useRef([]);
+  stagedRef.current = stagedAttachments;
+  const uploadFileRef = useRef(uploadFile);
+  uploadFileRef.current = uploadFile;
+  useEffect(
+    () => () => {
+      abortControllersRef.current.forEach((controller) => controller.abort());
+      abortControllersRef.current.clear();
+      stagedRef.current.forEach((attachment) => {
+        if (attachment.previewUrl) URL.revokeObjectURL(attachment.previewUrl);
+      });
+    },
+    []
+  );
+  const patchAttachment = useCallback((stagingId, patch) => {
+    setStagedAttachments(
+      (current) => current.map((attachment) => attachment.stagingId === stagingId ? { ...attachment, ...patch } : attachment)
+    );
+  }, []);
+  const uploadStagedFile = useCallback(
+    async (stagingId, file, extras) => {
+      const controller = new AbortController();
+      abortControllersRef.current.set(stagingId, controller);
+      try {
+        const uploaded = await uploadFileRef.current(file, {
+          signal: controller.signal,
+          onProgress: (percentage) => patchAttachment(stagingId, { progress: percentage })
+        });
+        patchAttachment(stagingId, {
+          status: "done",
+          progress: 100,
+          uploaded: { ...uploaded, ...extras }
+        });
+      } catch (error) {
+        if (!controller.signal.aborted) {
+          uiLogger.error("File attachment upload failed", error);
+          patchAttachment(stagingId, { status: "error" });
+        }
+      } finally {
+        abortControllersRef.current.delete(stagingId);
+      }
+    },
+    [patchAttachment]
+  );
+  const addFiles = useCallback(
+    async (files, extras = {}) => {
+      const incoming = (files ?? []).filter(Boolean);
+      if (!incoming.length) return;
+      const availableSlots = maxFiles - stagedRef.current.length;
+      if (availableSlots <= 0) {
+        notify({ message: t("followUp.attachments.tooMany", { max: maxFiles }), type: "error" });
+        return;
+      }
+      const accepted = incoming.slice(0, availableSlots);
+      if (accepted.length < incoming.length) {
+        notify({ message: t("followUp.attachments.tooMany", { max: maxFiles }), type: "error" });
+      }
+      for (const originalFile of accepted) {
+        if (originalFile.size > maxFileSizeBytes) {
+          notify({ message: t("followUp.attachments.tooLarge", { name: originalFile.name }), type: "error" });
+          continue;
+        }
+        const file = compressImages ? await compressImageFile(originalFile) : originalFile;
+        const stagingId = generateUUID();
+        const staged = {
+          stagingId,
+          file,
+          previewUrl: previewUrlFor(file),
+          progress: 0,
+          status: "uploading",
+          uploaded: null,
+          extras
+        };
+        setStagedAttachments((current) => [...current, staged]);
+        uploadStagedFile(stagingId, file, extras);
+      }
+    },
+    [compressImages, maxFileSizeBytes, maxFiles, notify, t, uploadStagedFile]
+  );
+  const removeAttachment = useCallback((stagingId) => {
+    abortControllersRef.current.get(stagingId)?.abort();
+    abortControllersRef.current.delete(stagingId);
+    setStagedAttachments((current) => {
+      const target = current.find((attachment) => attachment.stagingId === stagingId);
+      if (target?.previewUrl) URL.revokeObjectURL(target.previewUrl);
+      return current.filter((attachment) => attachment.stagingId !== stagingId);
+    });
+  }, []);
+  const retryAttachment = useCallback(
+    (stagingId) => {
+      const target = stagedRef.current.find((attachment) => attachment.stagingId === stagingId);
+      if (!target || target.status !== "error") return;
+      patchAttachment(stagingId, { status: "uploading", progress: 0 });
+      uploadStagedFile(stagingId, target.file, target.extras);
+    },
+    [patchAttachment, uploadStagedFile]
+  );
+  const clearAttachments = useCallback(() => {
+    abortControllersRef.current.forEach((controller) => controller.abort());
+    abortControllersRef.current.clear();
+    setStagedAttachments((current) => {
+      current.forEach((attachment) => {
+        if (attachment.previewUrl) URL.revokeObjectURL(attachment.previewUrl);
+      });
+      return [];
+    });
+  }, []);
+  const isUploading = stagedAttachments.some((attachment) => attachment.status === "uploading");
+  const readyAttachments = useMemo(
+    () => stagedAttachments.filter((attachment) => attachment.status === "done" && attachment.uploaded).map((attachment) => attachment.uploaded),
+    [stagedAttachments]
+  );
+  return {
+    stagedAttachments,
+    addFiles,
+    removeAttachment,
+    retryAttachment,
+    clearAttachments,
+    isUploading,
+    readyAttachments
+  };
+};
+export {
+  configureSharedFileUploader,
+  useFileAttachments
+};
+//# sourceMappingURL=useFileAttachments.js.map

package/dist/hooks/useFileAttachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileAttachments.js","sources":["../../src/hooks/useFileAttachments.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useTranslation } from 'react-i18next';\n\nimport { uiLogger } from '@/helpers/uiLogger';\nimport { generateUUID } from '@/helpers/utilityHelpers';\nimport { useNotification } from '@/hooks/useNotification';\nimport { IFileAttachment } from '@/interfaces/IFileAttachment';\n\nimport { compressImageFile } from '../helpers/imageCompression';\n\nconst DEFAULT_MAX_FILES = 10;\nconst DEFAULT_MAX_FILE_SIZE_BYTES = 50 * 1024 * 1024;\n\nexport type TFileUploader = (\n  file: File,\n  options: { signal?: AbortSignal; onProgress?: (percentage: number) => void },\n) => Promise<IFileAttachment>;\n\nexport type TStagedAttachmentStatus = 'uploading' | 'done' | 'error';\n\nexport interface IStagedAttachmentExtras {\n  durationMs?: number;\n  transcript?: string;\n}\n\nexport interface IStagedAttachment {\n  stagingId: string;\n  file: File;\n  previewUrl: string | null;\n  progress: number;\n  status: TStagedAttachmentStatus;\n  uploaded: IFileAttachment | null;\n  extras: IStagedAttachmentExtras;\n}\n\nexport interface IUseFileAttachmentsOptions {\n  /** Storage seam: a surface with its own bucket passes its uploader instead of the shared one. */\n  uploadFile?: TFileUploader;\n  maxFiles?: number;\n  maxFileSizeBytes?: number;\n  compressImages?: boolean;\n}\n\nexport interface IUseFileAttachmentsResult {\n  stagedAttachments: Array<IStagedAttachment>;\n  addFiles: (files: Array<File>, extras?: IStagedAttachmentExtras) => Promise<void>;\n  removeAttachment: (stagingId: string) => void;\n  retryAttachment: (stagingId: string) => void;\n  clearAttachments: () => void;\n  isUploading: boolean;\n  readyAttachments: Array<IFileAttachment>;\n}\n\nconst previewUrlFor = (file: File): string | null => {\n  if (file.type.startsWith('image/') || file.type.startsWith('video/')) return URL.createObjectURL(file);\n  return null;\n};\n\nlet sharedUploader: TFileUploader | null = null;\n\n/** The host registers the uploader that backs surfaces without a bucket of their own. */\nexport const configureSharedFileUploader = (uploader: TFileUploader | null): void => {\n  sharedUploader = uploader;\n};\n\nconst defaultUploader: TFileUploader = (file, options) => {\n  if (!sharedUploader) throw new Error('No shared file uploader configured');\n  return sharedUploader(file, options);\n};\n\n/**\n * Staging area between picking a file and having a stored reference for it: upload progress,\n * cancellation, retry and object-URL lifecycle. Whoever owns the surface decides what to do\n * with `readyAttachments` (send them beside a message, or write them into the body).\n */\nexport const useFileAttachments = (options: IUseFileAttachmentsOptions = {}): IUseFileAttachmentsResult => {\n  const {\n    uploadFile = defaultUploader,\n    maxFiles = DEFAULT_MAX_FILES,\n    maxFileSizeBytes = DEFAULT_MAX_FILE_SIZE_BYTES,\n    compressImages = true,\n  } = options;\n\n  const { t } = useTranslation('ui');\n  const { notify } = useNotification();\n  const [stagedAttachments, setStagedAttachments] = useState<Array<IStagedAttachment>>([]);\n  const abortControllersRef = useRef<Map<string, AbortController>>(new Map());\n  const stagedRef = useRef<Array<IStagedAttachment>>([]);\n  stagedRef.current = stagedAttachments;\n\n  const uploadFileRef = useRef<TFileUploader>(uploadFile);\n  uploadFileRef.current = uploadFile;\n\n  useEffect(\n    () => () => {\n      abortControllersRef.current.forEach((controller) => controller.abort());\n      abortControllersRef.current.clear();\n      stagedRef.current.forEach((attachment) => {\n        if (attachment.previewUrl) URL.revokeObjectURL(attachment.previewUrl);\n      });\n    },\n    [],\n  );\n\n  const patchAttachment = useCallback((stagingId: string, patch: Partial<IStagedAttachment>) => {\n    setStagedAttachments((current) =>\n      current.map((attachment) => (attachment.stagingId === stagingId ? { ...attachment, ...patch } : attachment)),\n    );\n  }, []);\n\n  const uploadStagedFile = useCallback(\n    async (stagingId: string, file: File, extras: IStagedAttachmentExtras) => {\n      const controller = new AbortController();\n      abortControllersRef.current.set(stagingId, controller);\n\n      try {\n        const uploaded = await uploadFileRef.current(file, {\n          signal: controller.signal,\n          onProgress: (percentage) => patchAttachment(stagingId, { progress: percentage }),\n        });\n\n        patchAttachment(stagingId, {\n          status: 'done',\n          progress: 100,\n          uploaded: { ...uploaded, ...extras },\n        });\n      } catch (error) {\n        if (!controller.signal.aborted) {\n          uiLogger.error('File attachment upload failed', error);\n          patchAttachment(stagingId, { status: 'error' });\n        }\n      } finally {\n        abortControllersRef.current.delete(stagingId);\n      }\n    },\n    [patchAttachment],\n  );\n\n  const addFiles = useCallback(\n    async (files: Array<File>, extras: IStagedAttachmentExtras = {}) => {\n      const incoming = (files ?? []).filter(Boolean);\n      if (!incoming.length) return;\n\n      const availableSlots = maxFiles - stagedRef.current.length;\n      if (availableSlots <= 0) {\n        notify({ message: t('followUp.attachments.tooMany', { max: maxFiles }), type: 'error' });\n        return;\n      }\n\n      const accepted = incoming.slice(0, availableSlots);\n      if (accepted.length < incoming.length) {\n        notify({ message: t('followUp.attachments.tooMany', { max: maxFiles }), type: 'error' });\n      }\n\n      for (const originalFile of accepted) {\n        if (originalFile.size > maxFileSizeBytes) {\n          notify({ message: t('followUp.attachments.tooLarge', { name: originalFile.name }), type: 'error' });\n          continue;\n        }\n\n        const file = compressImages ? await compressImageFile(originalFile) : originalFile;\n        const stagingId = generateUUID();\n        const staged: IStagedAttachment = {\n          stagingId,\n          file,\n          previewUrl: previewUrlFor(file),\n          progress: 0,\n          status: 'uploading',\n          uploaded: null,\n          extras,\n        };\n\n        setStagedAttachments((current) => [...current, staged]);\n        uploadStagedFile(stagingId, file, extras);\n      }\n    },\n    [compressImages, maxFileSizeBytes, maxFiles, notify, t, uploadStagedFile],\n  );\n\n  const removeAttachment = useCallback((stagingId: string) => {\n    abortControllersRef.current.get(stagingId)?.abort();\n    abortControllersRef.current.delete(stagingId);\n\n    setStagedAttachments((current) => {\n      const target = current.find((attachment) => attachment.stagingId === stagingId);\n      if (target?.previewUrl) URL.revokeObjectURL(target.previewUrl);\n      return current.filter((attachment) => attachment.stagingId !== stagingId);\n    });\n  }, []);\n\n  const retryAttachment = useCallback(\n    (stagingId: string) => {\n      const target = stagedRef.current.find((attachment) => attachment.stagingId === stagingId);\n      if (!target || target.status !== 'error') return;\n\n      patchAttachment(stagingId, { status: 'uploading', progress: 0 });\n      uploadStagedFile(stagingId, target.file, target.extras);\n    },\n    [patchAttachment, uploadStagedFile],\n  );\n\n  const clearAttachments = useCallback(() => {\n    abortControllersRef.current.forEach((controller) => controller.abort());\n    abortControllersRef.current.clear();\n\n    setStagedAttachments((current) => {\n      current.forEach((attachment) => {\n        if (attachment.previewUrl) URL.revokeObjectURL(attachment.previewUrl);\n      });\n      return [];\n    });\n  }, []);\n\n  const isUploading = stagedAttachments.some((attachment) => attachment.status === 'uploading');\n\n  const readyAttachments = useMemo(\n    () =>\n      stagedAttachments\n        .filter((attachment) => attachment.status === 'done' && attachment.uploaded)\n        .map((attachment) => attachment.uploaded as IFileAttachment),\n    [stagedAttachments],\n  );\n\n  return {\n    stagedAttachments,\n    addFiles,\n    removeAttachment,\n    retryAttachment,\n    clearAttachments,\n    isUploading,\n    readyAttachments,\n  };\n};\n"],"names":[],"mappings":"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"}

package/dist/hooks/useHoverCapable.d.ts

@@ -0,0 +1,6 @@
+/**
+ * True when the primary pointer can hover (mouse/trackpad). False on touch, where
+ * a `group-hover` affordance never appears and its control becomes undiscoverable.
+ * Use it to render such controls permanently instead of hiding them behind hover.
+ */
+export declare const useHoverCapable: () => boolean;

package/dist/hooks/useHoverCapable.js

@@ -0,0 +1,28 @@
+import { useState, useEffect } from "react";
+const HOVER_QUERY = "(hover: hover) and (pointer: fine)";
+const readHoverCapability = () => {
+  try {
+    return window.matchMedia(HOVER_QUERY).matches;
+  } catch {
+    return true;
+  }
+};
+const useHoverCapable = () => {
+  const [hoverCapable, setHoverCapable] = useState(readHoverCapability);
+  useEffect(() => {
+    let mediaQuery;
+    try {
+      mediaQuery = window.matchMedia(HOVER_QUERY);
+    } catch {
+      return void 0;
+    }
+    const handleChange = () => setHoverCapable(mediaQuery.matches);
+    mediaQuery.addEventListener("change", handleChange);
+    return () => mediaQuery.removeEventListener("change", handleChange);
+  }, []);
+  return hoverCapable;
+};
+export {
+  useHoverCapable
+};
+//# sourceMappingURL=useHoverCapable.js.map

package/dist/hooks/useHoverCapable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHoverCapable.js","sources":["../../src/hooks/useHoverCapable.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nconst HOVER_QUERY = '(hover: hover) and (pointer: fine)';\n\nconst readHoverCapability = (): boolean => {\n  try {\n    return window.matchMedia(HOVER_QUERY).matches;\n  } catch {\n    return true;\n  }\n};\n\n/**\n * True when the primary pointer can hover (mouse/trackpad). False on touch, where\n * a `group-hover` affordance never appears and its control becomes undiscoverable.\n * Use it to render such controls permanently instead of hiding them behind hover.\n */\nexport const useHoverCapable = (): boolean => {\n  const [hoverCapable, setHoverCapable] = useState(readHoverCapability);\n\n  useEffect(() => {\n    let mediaQuery: MediaQueryList;\n    try {\n      mediaQuery = window.matchMedia(HOVER_QUERY);\n    } catch {\n      return undefined;\n    }\n\n    const handleChange = () => setHoverCapable(mediaQuery.matches);\n    mediaQuery.addEventListener('change', handleChange);\n    return () => mediaQuery.removeEventListener('change', handleChange);\n  }, []);\n\n  return hoverCapable;\n};\n"],"names":[],"mappings":";AAEA,MAAM,cAAc;AAEpB,MAAM,sBAAsB,MAAe;AACzC,MAAI;AACF,WAAO,OAAO,WAAW,WAAW,EAAE;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAOO,MAAM,kBAAkB,MAAe;AAC5C,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,mBAAmB;AAEpE,YAAU,MAAM;AACd,QAAI;AACJ,QAAI;AACF,mBAAa,OAAO,WAAW,WAAW;AAAA,IAC5C,QAAQ;AACN,aAAO;AAAA,IACT;AAEA,UAAM,eAAe,MAAM,gBAAgB,WAAW,OAAO;AAC7D,eAAW,iBAAiB,UAAU,YAAY;AAClD,WAAO,MAAM,WAAW,oBAAoB,UAAU,YAAY;AAAA,EACpE,GAAG,CAAA,CAAE;AAEL,SAAO;AACT;"}

package/dist/hooks/useInlineEditor.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export declare const useInlineEditor: (active: boolean, onStopEdit: () => void, onNavigate: (direction: 1 | -1) => void) => {
+    containerRef: React.RefObject<HTMLDivElement>;
+    handleKeyDown: (event: React.KeyboardEvent) => void;
+};

package/dist/hooks/useInlineEditor.js

@@ -0,0 +1,42 @@
+import { useRef, useEffect } from "react";
+import { LAYERED_SURFACE_SELECTOR } from "../helpers/layeredSurfaces.js";
+const commitActiveElement = (container) => {
+  const active = document.activeElement;
+  if (active instanceof HTMLElement && container?.contains(active)) active.blur();
+};
+const useInlineEditor = (active, onStopEdit, onNavigate) => {
+  const containerRef = useRef(null);
+  useEffect(() => {
+    if (!active) return;
+    const focusable = containerRef.current?.querySelector("input, textarea, select, button, [tabindex]");
+    focusable?.focus();
+  }, [active]);
+  useEffect(() => {
+    if (!active) return void 0;
+    const handlePointerDown = (event) => {
+      const target = event.target instanceof Element ? event.target : null;
+      if (!target || containerRef.current?.contains(target)) return;
+      if (target.closest(LAYERED_SURFACE_SELECTOR)) return;
+      commitActiveElement(containerRef.current);
+      onStopEdit();
+    };
+    document.addEventListener("pointerdown", handlePointerDown);
+    return () => document.removeEventListener("pointerdown", handlePointerDown);
+  }, [active, onStopEdit]);
+  const handleKeyDown = (event) => {
+    if (event.key === "Tab") {
+      event.preventDefault();
+      commitActiveElement(containerRef.current);
+      onNavigate(event.shiftKey ? -1 : 1);
+    } else if (event.key === "Escape") {
+      event.stopPropagation();
+      commitActiveElement(containerRef.current);
+      onStopEdit();
+    }
+  };
+  return { containerRef, handleKeyDown };
+};
+export {
+  useInlineEditor
+};
+//# sourceMappingURL=useInlineEditor.js.map

package/dist/hooks/useInlineEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInlineEditor.js","sources":["../../src/hooks/useInlineEditor.ts"],"sourcesContent":["import React, { useEffect, useRef } from 'react';\n\nimport { LAYERED_SURFACE_SELECTOR } from '@/helpers/layeredSurfaces';\n\n// Persiste editores que salvam no blur (ex.: ProductDataSheetField) antes do\n// container desmontar ao navegar/fechar.\nconst commitActiveElement = (container: HTMLElement | null) => {\n  const active = document.activeElement;\n  if (active instanceof HTMLElement && container?.contains(active)) active.blur();\n};\n\n// Wiring compartilhado dos editores inline: foca o primeiro controle ao abrir,\n// fecha no clique fora e navega entre campos editáveis com Tab / Shift+Tab.\nexport const useInlineEditor = (active: boolean, onStopEdit: () => void, onNavigate: (direction: 1 | -1) => void) => {\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!active) return;\n    const focusable = containerRef.current?.querySelector<HTMLElement>('input, textarea, select, button, [tabindex]');\n    focusable?.focus();\n  }, [active]);\n\n  useEffect(() => {\n    if (!active) return undefined;\n\n    const handlePointerDown = (event: PointerEvent) => {\n      const target = event.target instanceof Element ? event.target : null;\n      if (!target || containerRef.current?.contains(target)) return;\n      // Select menus portal outside the container; interacting with them (including the search\n      // field, which sits in the panel but outside the listbox) does not end the edit.\n      if (target.closest(LAYERED_SURFACE_SELECTOR)) return;\n      commitActiveElement(containerRef.current);\n      onStopEdit();\n    };\n\n    document.addEventListener('pointerdown', handlePointerDown);\n    return () => document.removeEventListener('pointerdown', handlePointerDown);\n  }, [active, onStopEdit]);\n\n  const handleKeyDown = (event: React.KeyboardEvent) => {\n    if (event.key === 'Tab') {\n      event.preventDefault();\n      commitActiveElement(containerRef.current);\n      onNavigate(event.shiftKey ? -1 : 1);\n    } else if (event.key === 'Escape') {\n      event.stopPropagation();\n      commitActiveElement(containerRef.current);\n      onStopEdit();\n    }\n  };\n\n  return { containerRef, handleKeyDown };\n};\n"],"names":[],"mappings":";;AAMA,MAAM,sBAAsB,CAAC,cAAkC;AAC7D,QAAM,SAAS,SAAS;AACxB,MAAI,kBAAkB,eAAe,WAAW,SAAS,MAAM,UAAU,KAAA;AAC3E;AAIO,MAAM,kBAAkB,CAAC,QAAiB,YAAwB,eAA4C;AACnH,QAAM,eAAe,OAAuB,IAAI;AAEhD,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,YAAY,aAAa,SAAS,cAA2B,6CAA6C;AAChH,eAAW,MAAA;AAAA,EACb,GAAG,CAAC,MAAM,CAAC;AAEX,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ,QAAO;AAEpB,UAAM,oBAAoB,CAAC,UAAwB;AACjD,YAAM,SAAS,MAAM,kBAAkB,UAAU,MAAM,SAAS;AAChE,UAAI,CAAC,UAAU,aAAa,SAAS,SAAS,MAAM,EAAG;AAGvD,UAAI,OAAO,QAAQ,wBAAwB,EAAG;AAC9C,0BAAoB,aAAa,OAAO;AACxC,iBAAA;AAAA,IACF;AAEA,aAAS,iBAAiB,eAAe,iBAAiB;AAC1D,WAAO,MAAM,SAAS,oBAAoB,eAAe,iBAAiB;AAAA,EAC5E,GAAG,CAAC,QAAQ,UAAU,CAAC;AAEvB,QAAM,gBAAgB,CAAC,UAA+B;AACpD,QAAI,MAAM,QAAQ,OAAO;AACvB,YAAM,eAAA;AACN,0BAAoB,aAAa,OAAO;AACxC,iBAAW,MAAM,WAAW,KAAK,CAAC;AAAA,IACpC,WAAW,MAAM,QAAQ,UAAU;AACjC,YAAM,gBAAA;AACN,0BAAoB,aAAa,OAAO;AACxC,iBAAA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,cAAc,cAAA;AACzB;"}

package/dist/hooks/useMobile.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Kept as the historical name used across the app. It now delegates to
+ * `useBreakpoint`, so the JS notion of "mobile" and the Tailwind `tablet:`
+ * variant agree on the same 640px edge instead of drifting (it used to be a
+ * hardcoded 720px, which made CSS and behaviour disagree between 640 and 720).
+ */
+export declare function useMobile(): boolean;

package/dist/hooks/useMobile.js

@@ -0,0 +1,8 @@
+import { useBreakpoint } from "./useBreakpoint.js";
+function useMobile() {
+  return useBreakpoint().isMobile;
+}
+export {
+  useMobile
+};
+//# sourceMappingURL=useMobile.js.map

package/dist/hooks/useMobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMobile.js","sources":["../../src/hooks/useMobile.ts"],"sourcesContent":["import { useBreakpoint } from './useBreakpoint';\n\n/**\n * Kept as the historical name used across the app. It now delegates to\n * `useBreakpoint`, so the JS notion of \"mobile\" and the Tailwind `tablet:`\n * variant agree on the same 640px edge instead of drifting (it used to be a\n * hardcoded 720px, which made CSS and behaviour disagree between 640 and 720).\n */\nexport function useMobile(): boolean {\n  return useBreakpoint().isMobile;\n}\n"],"names":[],"mappings":";AAQO,SAAS,YAAqB;AACnC,SAAO,gBAAgB;AACzB;"}

package/dist/hooks/useNotification.d.ts

@@ -0,0 +1,38 @@
+import { TypeOptions } from 'react-toastify';
+export interface IToastNotification {
+    message: string;
+    useAction?: boolean;
+    onAction?: (value: boolean) => void;
+    actionLabel?: string;
+    type: TypeOptions;
+    timeout: number;
+}
+export type TNotifyPriority = 'normal' | 'high';
+export interface INotifyParams {
+    message: string;
+    type: TypeOptions;
+    timeout?: number;
+    useAction?: boolean;
+    onAction?: (value: boolean) => void;
+    actionLabel?: string;
+    /**
+     * `high` marks a toast that names the real cause of a failure, such as an access denial raised by
+     * the request layer. Only one toast is on screen at a time and `notify` replaces whatever is
+     * there, so without this a screen's generic "failed to load", fired moments later for the SAME
+     * request, would erase the only message that explained why it failed.
+     */
+    priority?: TNotifyPriority;
+}
+export interface INotificationStore {
+    notification: IToastNotification | null;
+    notify: (params: INotifyParams) => void;
+    setNotification: (notification: IToastNotification | null) => void;
+    closeNotify: () => void;
+}
+export declare const useNotificationStore: import('zustand').UseBoundStore<import('zustand').StoreApi<INotificationStore>>;
+export declare const useNotification: () => {
+    notification: IToastNotification | null;
+    notify: (params: INotifyParams) => void;
+    setNotification: (notification: IToastNotification | null) => void;
+    closeNotify: () => void;
+};

package/dist/hooks/useNotification.js

@@ -0,0 +1,39 @@
+import { create } from "zustand";
+import { useShallow } from "zustand/react/shallow";
+let priorityHoldUntil = 0;
+const useNotificationStore = create((set) => ({
+  notification: null,
+  closeNotify: () => {
+    priorityHoldUntil = 0;
+    set({ notification: null });
+  },
+  setNotification: (notification) => set({ notification }),
+  notify: (params) => {
+    const timeout = params.timeout || 5e3;
+    if (params.priority === "high") {
+      priorityHoldUntil = Date.now() + timeout;
+    } else if (Date.now() < priorityHoldUntil) {
+      return;
+    }
+    set({ notification: null });
+    set({ notification: { ...params, timeout } });
+    setTimeout(() => {
+      if (useNotificationStore.getState().notification?.message === params.message) {
+        set({ notification: null });
+      }
+    }, timeout + 500);
+  }
+}));
+const useNotification = () => useNotificationStore(
+  useShallow((s) => ({
+    notification: s.notification,
+    notify: s.notify,
+    setNotification: s.setNotification,
+    closeNotify: s.closeNotify
+  }))
+);
+export {
+  useNotification,
+  useNotificationStore
+};
+//# sourceMappingURL=useNotification.js.map

package/dist/hooks/useNotification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotification.js","sources":["../../src/hooks/useNotification.tsx"],"sourcesContent":["import { TypeOptions } from 'react-toastify';\nimport { create } from 'zustand';\nimport { useShallow } from 'zustand/react/shallow';\n\nexport interface IToastNotification {\n  message: string;\n  useAction?: boolean;\n  onAction?: (value: boolean) => void;\n  actionLabel?: string;\n  type: TypeOptions;\n  timeout: number;\n}\n\nexport type TNotifyPriority = 'normal' | 'high';\n\nexport interface INotifyParams {\n  message: string;\n  type: TypeOptions;\n  timeout?: number;\n  useAction?: boolean;\n  onAction?: (value: boolean) => void;\n  actionLabel?: string;\n  /**\n   * `high` marks a toast that names the real cause of a failure, such as an access denial raised by\n   * the request layer. Only one toast is on screen at a time and `notify` replaces whatever is\n   * there, so without this a screen's generic \"failed to load\", fired moments later for the SAME\n   * request, would erase the only message that explained why it failed.\n   */\n  priority?: TNotifyPriority;\n}\n\nexport interface INotificationStore {\n  notification: IToastNotification | null;\n  notify: (params: INotifyParams) => void;\n  setNotification: (notification: IToastNotification | null) => void;\n  closeNotify: () => void;\n}\n\n/** Wall-clock instant until which a `high` toast holds the screen against a `normal` one. */\nlet priorityHoldUntil = 0;\n\nexport const useNotificationStore = create<INotificationStore>((set) => ({\n  notification: null,\n\n  closeNotify: () => {\n    priorityHoldUntil = 0;\n    set({ notification: null });\n  },\n\n  setNotification: (notification) => set({ notification }),\n\n  notify: (params) => {\n    const timeout = params.timeout || 5000;\n\n    if (params.priority === 'high') {\n      priorityHoldUntil = Date.now() + timeout;\n    } else if (Date.now() < priorityHoldUntil) {\n      return;\n    }\n\n    set({ notification: null });\n    set({ notification: { ...params, timeout } });\n\n    setTimeout(() => {\n      if (useNotificationStore.getState().notification?.message === params.message) {\n        set({ notification: null });\n      }\n    }, timeout + 500);\n  },\n}));\n\nexport const useNotification = () =>\n  useNotificationStore(\n    useShallow((s) => ({\n      notification: s.notification,\n      notify: s.notify,\n      setNotification: s.setNotification,\n      closeNotify: s.closeNotify,\n    })),\n  );\n"],"names":[],"mappings":";;AAuCA,IAAI,oBAAoB;AAEjB,MAAM,uBAAuB,OAA2B,CAAC,SAAS;AAAA,EACvE,cAAc;AAAA,EAEd,aAAa,MAAM;AACjB,wBAAoB;AACpB,QAAI,EAAE,cAAc,MAAM;AAAA,EAC5B;AAAA,EAEA,iBAAiB,CAAC,iBAAiB,IAAI,EAAE,cAAc;AAAA,EAEvD,QAAQ,CAAC,WAAW;AAClB,UAAM,UAAU,OAAO,WAAW;AAElC,QAAI,OAAO,aAAa,QAAQ;AAC9B,0BAAoB,KAAK,QAAQ;AAAA,IACnC,WAAW,KAAK,IAAA,IAAQ,mBAAmB;AACzC;AAAA,IACF;AAEA,QAAI,EAAE,cAAc,MAAM;AAC1B,QAAI,EAAE,cAAc,EAAE,GAAG,QAAQ,QAAA,GAAW;AAE5C,eAAW,MAAM;AACf,UAAI,qBAAqB,SAAA,EAAW,cAAc,YAAY,OAAO,SAAS;AAC5E,YAAI,EAAE,cAAc,MAAM;AAAA,MAC5B;AAAA,IACF,GAAG,UAAU,GAAG;AAAA,EAClB;AACF,EAAE;AAEK,MAAM,kBAAkB,MAC7B;AAAA,EACE,WAAW,CAAC,OAAO;AAAA,IACjB,cAAc,EAAE;AAAA,IAChB,QAAQ,EAAE;AAAA,IACV,iBAAiB,EAAE;AAAA,IACnB,aAAa,EAAE;AAAA,EAAA,EACf;AACJ;"}

package/dist/hooks/useResolvedTheme.d.ts

@@ -0,0 +1,7 @@
+export type TUiResolvedTheme = 'light' | 'dark';
+/**
+ * The theme as painted on `<html data-theme>`, which the app's ThemeManager (or the inline boot
+ * script) always writes before React reads it. Observing the DOM instead of an app store keeps
+ * the UI layer free of the dashboard's state, and stays correct wherever the attribute is set.
+ */
+export declare const useResolvedTheme: () => TUiResolvedTheme;

package/dist/hooks/useResolvedTheme.js

@@ -0,0 +1,15 @@
+import { useSyncExternalStore } from "react";
+const THEME_ATTRIBUTE = "data-theme";
+const readResolvedTheme = () => typeof document !== "undefined" && document.documentElement.getAttribute(THEME_ATTRIBUTE) === "dark" ? "dark" : "light";
+const subscribeToThemeAttribute = (onChange) => {
+  if (typeof document === "undefined") return () => void 0;
+  const observer = new MutationObserver(onChange);
+  observer.observe(document.documentElement, { attributes: true, attributeFilter: [THEME_ATTRIBUTE] });
+  return () => observer.disconnect();
+};
+const readServerTheme = () => "light";
+const useResolvedTheme = () => useSyncExternalStore(subscribeToThemeAttribute, readResolvedTheme, readServerTheme);
+export {
+  useResolvedTheme
+};
+//# sourceMappingURL=useResolvedTheme.js.map

package/dist/hooks/useResolvedTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedTheme.js","sources":["../../src/hooks/useResolvedTheme.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nexport type TUiResolvedTheme = 'light' | 'dark';\n\nconst THEME_ATTRIBUTE = 'data-theme';\n\nconst readResolvedTheme = (): TUiResolvedTheme =>\n  typeof document !== 'undefined' && document.documentElement.getAttribute(THEME_ATTRIBUTE) === 'dark'\n    ? 'dark'\n    : 'light';\n\nconst subscribeToThemeAttribute = (onChange: () => void): (() => void) => {\n  if (typeof document === 'undefined') return () => undefined;\n\n  const observer = new MutationObserver(onChange);\n  observer.observe(document.documentElement, { attributes: true, attributeFilter: [THEME_ATTRIBUTE] });\n  return () => observer.disconnect();\n};\n\nconst readServerTheme = (): TUiResolvedTheme => 'light';\n\n/**\n * The theme as painted on `<html data-theme>`, which the app's ThemeManager (or the inline boot\n * script) always writes before React reads it. Observing the DOM instead of an app store keeps\n * the UI layer free of the dashboard's state, and stays correct wherever the attribute is set.\n */\nexport const useResolvedTheme = (): TUiResolvedTheme =>\n  useSyncExternalStore(subscribeToThemeAttribute, readResolvedTheme, readServerTheme);\n"],"names":[],"mappings":";AAIA,MAAM,kBAAkB;AAExB,MAAM,oBAAoB,MACxB,OAAO,aAAa,eAAe,SAAS,gBAAgB,aAAa,eAAe,MAAM,SAC1F,SACA;AAEN,MAAM,4BAA4B,CAAC,aAAuC;AACxE,MAAI,OAAO,aAAa,YAAa,QAAO,MAAM;AAElD,QAAM,WAAW,IAAI,iBAAiB,QAAQ;AAC9C,WAAS,QAAQ,SAAS,iBAAiB,EAAE,YAAY,MAAM,iBAAiB,CAAC,eAAe,GAAG;AACnG,SAAO,MAAM,SAAS,WAAA;AACxB;AAEA,MAAM,kBAAkB,MAAwB;AAOzC,MAAM,mBAAmB,MAC9B,qBAAqB,2BAA2B,mBAAmB,eAAe;"}

package/dist/hooks/useThemeSkin.d.ts

@@ -0,0 +1,7 @@
+import { TUiThemeSkin } from '../helpers/themeSkins';
+/**
+ * The skin painted on `<html data-theme-skin>`, or `null` when the scheme is plain. A skin
+ * changes token VALUES without changing the scheme, so anything that caches a colour read
+ * from the stylesheet has to depend on this next to `useResolvedTheme`.
+ */
+export declare const useThemeSkin: () => TUiThemeSkin | null;

package/dist/hooks/useThemeSkin.js

@@ -0,0 +1,19 @@
+import { useSyncExternalStore } from "react";
+import { UI_THEME_SKIN_ATTRIBUTE, isUiThemeSkin } from "../helpers/themeSkins.js";
+const readThemeSkin = () => {
+  if (typeof document === "undefined") return null;
+  const skin = document.documentElement.getAttribute(UI_THEME_SKIN_ATTRIBUTE);
+  return isUiThemeSkin(skin) ? skin : null;
+};
+const subscribeToSkinAttribute = (onChange) => {
+  if (typeof document === "undefined") return () => void 0;
+  const observer = new MutationObserver(onChange);
+  observer.observe(document.documentElement, { attributes: true, attributeFilter: [UI_THEME_SKIN_ATTRIBUTE] });
+  return () => observer.disconnect();
+};
+const readServerSkin = () => null;
+const useThemeSkin = () => useSyncExternalStore(subscribeToSkinAttribute, readThemeSkin, readServerSkin);
+export {
+  useThemeSkin
+};
+//# sourceMappingURL=useThemeSkin.js.map

package/dist/hooks/useThemeSkin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeSkin.js","sources":["../../src/hooks/useThemeSkin.ts"],"sourcesContent":["import { useSyncExternalStore } from 'react';\n\nimport { isUiThemeSkin, TUiThemeSkin, UI_THEME_SKIN_ATTRIBUTE } from '../helpers/themeSkins';\n\nconst readThemeSkin = (): TUiThemeSkin | null => {\n  if (typeof document === 'undefined') return null;\n\n  const skin = document.documentElement.getAttribute(UI_THEME_SKIN_ATTRIBUTE);\n  return isUiThemeSkin(skin) ? skin : null;\n};\n\nconst subscribeToSkinAttribute = (onChange: () => void): (() => void) => {\n  if (typeof document === 'undefined') return () => undefined;\n\n  const observer = new MutationObserver(onChange);\n  observer.observe(document.documentElement, { attributes: true, attributeFilter: [UI_THEME_SKIN_ATTRIBUTE] });\n  return () => observer.disconnect();\n};\n\nconst readServerSkin = (): TUiThemeSkin | null => null;\n\n/**\n * The skin painted on `<html data-theme-skin>`, or `null` when the scheme is plain. A skin\n * changes token VALUES without changing the scheme, so anything that caches a colour read\n * from the stylesheet has to depend on this next to `useResolvedTheme`.\n */\nexport const useThemeSkin = (): TUiThemeSkin | null =>\n  useSyncExternalStore(subscribeToSkinAttribute, readThemeSkin, readServerSkin);\n"],"names":[],"mappings":";;AAIA,MAAM,gBAAgB,MAA2B;AAC/C,MAAI,OAAO,aAAa,YAAa,QAAO;AAE5C,QAAM,OAAO,SAAS,gBAAgB,aAAa,uBAAuB;AAC1E,SAAO,cAAc,IAAI,IAAI,OAAO;AACtC;AAEA,MAAM,2BAA2B,CAAC,aAAuC;AACvE,MAAI,OAAO,aAAa,YAAa,QAAO,MAAM;AAElD,QAAM,WAAW,IAAI,iBAAiB,QAAQ;AAC9C,WAAS,QAAQ,SAAS,iBAAiB,EAAE,YAAY,MAAM,iBAAiB,CAAC,uBAAuB,GAAG;AAC3G,SAAO,MAAM,SAAS,WAAA;AACxB;AAEA,MAAM,iBAAiB,MAA2B;AAO3C,MAAM,eAAe,MAC1B,qBAAqB,0BAA0B,eAAe,cAAc;"}

package/dist/hooks/useVoiceTranscription.d.ts

@@ -0,0 +1,29 @@
+export type TVoiceCommandKey = 'comma' | 'period' | 'newline' | 'space' | 'question' | 'exclamation' | 'deleteWord';
+interface IVoiceCommand {
+    key: TVoiceCommandKey;
+    phrases: Array<string>;
+    insert?: string;
+    action?: 'deleteWord';
+}
+export declare const VOICE_COMMANDS: Array<IVoiceCommand>;
+export interface IVoiceTranscriptionUpdate {
+    insert: string;
+    deleteWords: number;
+}
+export declare const applyVoiceUpdate: (current: string, update: IVoiceTranscriptionUpdate) => string;
+export declare const appendInterimTranscript: (committed: string, interim: string) => string;
+export type TVoiceTranscriptionError = 'permission' | 'microphone' | 'network' | 'unavailable';
+interface IUseVoiceTranscriptionParams {
+    lang?: string;
+    onCommit: (update: IVoiceTranscriptionUpdate) => void;
+    onInterim?: (text: string) => void;
+}
+interface IUseVoiceTranscriptionResult {
+    isSupported: boolean;
+    isListening: boolean;
+    error: TVoiceTranscriptionError | null;
+    toggle: () => void;
+    stop: () => void;
+}
+export declare const useVoiceTranscription: ({ lang, onCommit, onInterim, }: IUseVoiceTranscriptionParams) => IUseVoiceTranscriptionResult;
+export {};