@umodeapporg/ui 0.1.0

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,41 @@
+import { useRef, useEffect } from "react";
+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('[role="menu"], [role="listbox"]')) 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\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      // Menus dos selects renderizam em portal fora do container; interagir\n      // com eles não encerra a edição.\n      if (target.closest('[role=\"menu\"], [role=\"listbox\"]')) 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":";AAIA,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,iCAAiC,EAAG;AACvD,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/useVoiceTranscription.d.ts

@@ -0,0 +1,25 @@
+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;
+}
+interface IUseVoiceTranscriptionParams {
+    lang?: string;
+    onCommit: (update: IVoiceTranscriptionUpdate) => void;
+    onInterim?: (text: string) => void;
+}
+interface IUseVoiceTranscriptionResult {
+    isSupported: boolean;
+    isListening: boolean;
+    toggle: () => void;
+    stop: () => void;
+}
+export declare const useVoiceTranscription: ({ lang, onCommit, onInterim, }: IUseVoiceTranscriptionParams) => IUseVoiceTranscriptionResult;
+export {};

package/dist/hooks/useVoiceTranscription.js

@@ -0,0 +1,106 @@
+import { useState, useRef, useCallback, useEffect } from "react";
+import { uiLogger } from "../helpers/uiLogger.js";
+const getRecognitionCtor = () => {
+  const w = window;
+  return w.SpeechRecognition ?? w.webkitSpeechRecognition ?? null;
+};
+const VOICE_COMMANDS = [
+  { key: "comma", phrases: ["vírgula", "virgula", "comma"], insert: ", " },
+  { key: "period", phrases: ["ponto", "ponto final", "period"], insert: ". " },
+  { key: "newline", phrases: ["nova linha", "quebra de linha", "parágrafo", "paragrafo", "new line"], insert: "\n" },
+  { key: "space", phrases: ["espaço", "espaco", "space"], insert: " " },
+  {
+    key: "question",
+    phrases: ["interrogação", "interrogacao", "ponto de interrogação", "question mark"],
+    insert: "? "
+  },
+  {
+    key: "exclamation",
+    phrases: ["exclamação", "exclamacao", "ponto de exclamação", "exclamation mark"],
+    insert: "! "
+  },
+  { key: "deleteWord", phrases: ["apagar", "apaga", "apagar palavra", "delete"], action: "deleteWord" }
+];
+const PHRASE_TO_COMMAND = /* @__PURE__ */ new Map();
+for (const command of VOICE_COMMANDS) {
+  for (const phrase of command.phrases) PHRASE_TO_COMMAND.set(phrase, command);
+}
+const normalize = (value) => value.trim().toLowerCase().replace(/[.,!?;:]+$/, "");
+const buildUpdateFromTranscript = (transcript) => {
+  const words = transcript.trim().split(/\s+/).filter(Boolean);
+  let insert = "";
+  let deleteWords = 0;
+  for (const word of words) {
+    const command = PHRASE_TO_COMMAND.get(normalize(word));
+    if (command?.action === "deleteWord") {
+      deleteWords += 1;
+      insert = "";
+      continue;
+    }
+    if (command?.insert !== void 0) {
+      insert = insert.replace(/\s+$/, "") + command.insert;
+      continue;
+    }
+    insert += (insert && !insert.endsWith(" ") && !insert.endsWith("\n") ? " " : "") + word;
+  }
+  return { insert, deleteWords };
+};
+const useVoiceTranscription = ({
+  lang = "pt-BR",
+  onCommit,
+  onInterim
+}) => {
+  const [isListening, setIsListening] = useState(false);
+  const recognitionRef = useRef(null);
+  const onCommitRef = useRef(onCommit);
+  const onInterimRef = useRef(onInterim);
+  onCommitRef.current = onCommit;
+  onInterimRef.current = onInterim;
+  const isSupported = getRecognitionCtor() !== null;
+  const stop = useCallback(() => {
+    recognitionRef.current?.stop();
+  }, []);
+  const start = useCallback(() => {
+    const Ctor = getRecognitionCtor();
+    if (!Ctor) return;
+    const recognition = new Ctor();
+    recognition.lang = lang;
+    recognition.continuous = true;
+    recognition.interimResults = true;
+    recognition.onresult = (event) => {
+      let interim = "";
+      for (let i = event.resultIndex; i < event.results.length; i += 1) {
+        const result = event.results[i];
+        const transcript = result[0].transcript;
+        if (result.isFinal) {
+          onCommitRef.current(buildUpdateFromTranscript(transcript));
+        } else {
+          interim += transcript;
+        }
+      }
+      onInterimRef.current?.(interim.trim());
+    };
+    recognition.onerror = (event) => {
+      uiLogger.warn("[useVoiceTranscription] error", event.error);
+      setIsListening(false);
+    };
+    recognition.onend = () => {
+      onInterimRef.current?.("");
+      setIsListening(false);
+    };
+    recognitionRef.current = recognition;
+    recognition.start();
+    setIsListening(true);
+  }, [lang]);
+  const toggle = useCallback(() => {
+    if (isListening) stop();
+    else start();
+  }, [isListening, start, stop]);
+  useEffect(() => () => recognitionRef.current?.stop(), []);
+  return { isSupported, isListening, toggle, stop };
+};
+export {
+  VOICE_COMMANDS,
+  useVoiceTranscription
+};
+//# sourceMappingURL=useVoiceTranscription.js.map

package/dist/hooks/useVoiceTranscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVoiceTranscription.js","sources":["../../src/hooks/useVoiceTranscription.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\n\nimport { uiLogger } from '@/helpers/uiLogger';\n\ninterface ISpeechRecognitionAlternative {\n  transcript: string;\n}\n\ninterface ISpeechRecognitionResult {\n  0: ISpeechRecognitionAlternative;\n  isFinal: boolean;\n}\n\ninterface ISpeechRecognitionEvent {\n  resultIndex: number;\n  results: { length: number; [index: number]: ISpeechRecognitionResult };\n}\n\ninterface ISpeechRecognition {\n  lang: string;\n  continuous: boolean;\n  interimResults: boolean;\n  start: () => void;\n  stop: () => void;\n  onresult: ((event: ISpeechRecognitionEvent) => void) | null;\n  onerror: ((event: { error: string }) => void) | null;\n  onend: (() => void) | null;\n}\n\ntype TSpeechRecognitionCtor = new () => ISpeechRecognition;\n\nconst getRecognitionCtor = (): TSpeechRecognitionCtor | null => {\n  const w = window as unknown as {\n    SpeechRecognition?: TSpeechRecognitionCtor;\n    webkitSpeechRecognition?: TSpeechRecognitionCtor;\n  };\n  return w.SpeechRecognition ?? w.webkitSpeechRecognition ?? null;\n};\n\nexport type TVoiceCommandKey = 'comma' | 'period' | 'newline' | 'space' | 'question' | 'exclamation' | 'deleteWord';\n\ninterface IVoiceCommand {\n  key: TVoiceCommandKey;\n  phrases: Array<string>;\n  insert?: string;\n  action?: 'deleteWord';\n}\n\n// Spoken keywords matched against the user's speech. They must stay as literal\n// recognition tokens (not UI strings), so the i18n check is disabled here.\n/* eslint-disable i18n-check/no-portuguese-strings */\nexport const VOICE_COMMANDS: Array<IVoiceCommand> = [\n  { key: 'comma', phrases: ['vírgula', 'virgula', 'comma'], insert: ', ' },\n  { key: 'period', phrases: ['ponto', 'ponto final', 'period'], insert: '. ' },\n  { key: 'newline', phrases: ['nova linha', 'quebra de linha', 'parágrafo', 'paragrafo', 'new line'], insert: '\\n' },\n  { key: 'space', phrases: ['espaço', 'espaco', 'space'], insert: ' ' },\n  {\n    key: 'question',\n    phrases: ['interrogação', 'interrogacao', 'ponto de interrogação', 'question mark'],\n    insert: '? ',\n  },\n  {\n    key: 'exclamation',\n    phrases: ['exclamação', 'exclamacao', 'ponto de exclamação', 'exclamation mark'],\n    insert: '! ',\n  },\n  { key: 'deleteWord', phrases: ['apagar', 'apaga', 'apagar palavra', 'delete'], action: 'deleteWord' },\n];\n/* eslint-enable i18n-check/no-portuguese-strings */\n\nconst PHRASE_TO_COMMAND = new Map<string, IVoiceCommand>();\nfor (const command of VOICE_COMMANDS) {\n  for (const phrase of command.phrases) PHRASE_TO_COMMAND.set(phrase, command);\n}\n\nconst normalize = (value: string): string =>\n  value\n    .trim()\n    .toLowerCase()\n    .replace(/[.,!?;:]+$/, '');\n\nexport interface IVoiceTranscriptionUpdate {\n  insert: string;\n  deleteWords: number;\n}\n\nconst buildUpdateFromTranscript = (transcript: string): IVoiceTranscriptionUpdate => {\n  const words = transcript.trim().split(/\\s+/).filter(Boolean);\n  let insert = '';\n  let deleteWords = 0;\n\n  for (const word of words) {\n    const command = PHRASE_TO_COMMAND.get(normalize(word));\n    if (command?.action === 'deleteWord') {\n      deleteWords += 1;\n      insert = '';\n      continue;\n    }\n    if (command?.insert !== undefined) {\n      insert = insert.replace(/\\s+$/, '') + command.insert;\n      continue;\n    }\n    insert += (insert && !insert.endsWith(' ') && !insert.endsWith('\\n') ? ' ' : '') + word;\n  }\n\n  return { insert, deleteWords };\n};\n\ninterface IUseVoiceTranscriptionParams {\n  lang?: string;\n  onCommit: (update: IVoiceTranscriptionUpdate) => void;\n  onInterim?: (text: string) => void;\n}\n\ninterface IUseVoiceTranscriptionResult {\n  isSupported: boolean;\n  isListening: boolean;\n  toggle: () => void;\n  stop: () => void;\n}\n\nexport const useVoiceTranscription = ({\n  lang = 'pt-BR',\n  onCommit,\n  onInterim,\n}: IUseVoiceTranscriptionParams): IUseVoiceTranscriptionResult => {\n  const [isListening, setIsListening] = useState(false);\n  const recognitionRef = useRef<ISpeechRecognition | null>(null);\n  const onCommitRef = useRef(onCommit);\n  const onInterimRef = useRef(onInterim);\n\n  onCommitRef.current = onCommit;\n  onInterimRef.current = onInterim;\n\n  const isSupported = getRecognitionCtor() !== null;\n\n  const stop = useCallback(() => {\n    recognitionRef.current?.stop();\n  }, []);\n\n  const start = useCallback(() => {\n    const Ctor = getRecognitionCtor();\n    if (!Ctor) return;\n\n    const recognition = new Ctor();\n    recognition.lang = lang;\n    recognition.continuous = true;\n    recognition.interimResults = true;\n\n    recognition.onresult = (event) => {\n      let interim = '';\n      for (let i = event.resultIndex; i < event.results.length; i += 1) {\n        const result = event.results[i];\n        const transcript = result[0].transcript;\n        if (result.isFinal) {\n          onCommitRef.current(buildUpdateFromTranscript(transcript));\n        } else {\n          interim += transcript;\n        }\n      }\n      onInterimRef.current?.(interim.trim());\n    };\n\n    recognition.onerror = (event) => {\n      uiLogger.warn('[useVoiceTranscription] error', event.error);\n      setIsListening(false);\n    };\n\n    recognition.onend = () => {\n      onInterimRef.current?.('');\n      setIsListening(false);\n    };\n\n    recognitionRef.current = recognition;\n    recognition.start();\n    setIsListening(true);\n  }, [lang]);\n\n  const toggle = useCallback(() => {\n    if (isListening) stop();\n    else start();\n  }, [isListening, start, stop]);\n\n  useEffect(() => () => recognitionRef.current?.stop(), []);\n\n  return { isSupported, isListening, toggle, stop };\n};\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export { default as ControlledButton } from './components/Form/ControlledButton';
+export { default as ControlledCheckbox } from './components/Form/ControlledCheckbox';
+export { default as ControlledDialog } from './components/Form/ControlledDialog';
+export { default as ControlledDrawer } from './components/Form/ControlledDrawer';
+export { default as ControlledImage } from './components/Form/ControlledImage/index';
+export { default as ControlledInput } from './components/Form/ControlledInput';
+export { default as ControlledRadio } from './components/Form/ControlledRadio';
+export * from './components/Form/ControlledSelect';
+export { default as ControlledSwitch } from './components/Form/ControlledSwitch';
+export { default as ControlledTabs } from './components/Form/ControlledTabs';
+export { default as ControlledTextarea } from './components/Form/ControlledTextarea';
+export { default as ControlledViewToggle } from './components/Form/ControlledViewToggle';
+export { default as ControlledBreadcrumb } from './components/Navigation/ControlledBreadcrumb';
+export { default as ErrorPage } from './components/Navigation/ErrorPage';
+export { default as PageTitle } from './components/Navigation/PageTitle';
+export * from './components/Navigation/PageTitleNavigationContext';
+export { default as UnifiedSearchBar } from './components/Search/UnifiedSearchBar';
+export * from './components/UI/access/UiAccessContext';
+export { default as BaseDataCard } from './components/UI/BaseDataCard';
+export { default as OutlinedChip } from './components/UI/Chips/OutlinedChip';
+export { default as Colors } from './components/UI/Colors';
+export { default as ColorSwatch } from './components/UI/ColorSwatch';
+export { default as ControlledAccordion } from './components/UI/ControlledAccordion';
+export { default as ControlledCollapse } from './components/UI/ControlledCollapse';
+export { default as ControlledMenu } from './components/UI/ControlledMenu';
+export { default as ControlledPopover } from './components/UI/ControlledPopover';
+export { default as ControlledProgress } from './components/UI/ControlledProgress';
+export { default as ControlledSlider } from './components/UI/ControlledSlider';
+export { default as ControlledTooltip } from './components/UI/ControlledTooltip';
+export { default as CustomBadge } from './components/UI/CustomBadge';
+export { default as CustomCard } from './components/UI/CustomCard';
+export { default as InformationCard } from './components/UI/InformationCard';
+export { default as LoadingSpinner } from './components/UI/LoadingSpinner';
+export * from './components/UI/MaterialSymbol/index';
+export { default as NoDataFound } from './components/UI/NoDataFound/index';
+export { default as SkeletonLoading } from './components/UI/SkeletonLoading';
+export * from './helpers/composeRefs';
+export * from './helpers/layeredSurfaces';
+export * from './helpers/themeTokens';
+export * from './helpers/uiLogger';
+export * from './helpers/uiPreferences';
+export * from './hooks/useAnchoredFloating';
+export * from './hooks/useBreakpoint';
+export * from './hooks/useDebounce';
+export * from './hooks/useHoverCapable';
+export * from './hooks/useMobile';
+export * from './hooks/useNotification';
+export * from './hooks/useResolvedTheme';
+export * from './locales';
+export * from './motion/index';