@umodeapporg/ui 0.0.0-canary.ca10e69

package/dist/hooks/useVoiceTranscription.js

@@ -0,0 +1,208 @@
+import { useState, useRef, useSyncExternalStore, useCallback, useEffect } from "react";
+import { uiLogger } from "../helpers/uiLogger.js";
+const getRecognitionCtor = () => {
+  const w = window;
+  return w.SpeechRecognition ?? w.webkitSpeechRecognition ?? null;
+};
+const subscribeToNothing = () => () => void 0;
+const isRecognitionAvailable = () => getRecognitionCtor() !== null;
+const isUnavailableOnServer = () => false;
+const listensOneUtterancePerSession = () => {
+  const { userAgent, maxTouchPoints } = navigator;
+  return /Android|iPhone|iPad|iPod/i.test(userAgent) || /Macintosh/i.test(userAgent) && maxTouchPoints > 1;
+};
+const readUtterance = (event) => {
+  let utterance = "";
+  for (let resultIndex = 0; resultIndex < event.results.length; resultIndex += 1) {
+    const transcript = event.results[resultIndex]?.[0]?.transcript?.trim() ?? "";
+    const normalizedTranscript = transcript.toLowerCase();
+    const normalizedUtterance = utterance.toLowerCase();
+    if (!transcript || normalizedUtterance.endsWith(normalizedTranscript)) continue;
+    utterance = normalizedTranscript.startsWith(normalizedUtterance) ? transcript : `${utterance} ${transcript}`;
+  }
+  return utterance;
+};
+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 appendTranscriptText = (current, addition) => {
+  if (!addition) return current;
+  const needsSpace = current.length > 0 && !/\s$/.test(current) && !/^[\s.,!?]/.test(addition);
+  return current + (needsSpace ? " " : "") + addition;
+};
+const applyVoiceUpdate = (current, update) => {
+  let next = current;
+  for (let wordIndex = 0; wordIndex < update.deleteWords; wordIndex += 1) {
+    next = next.replace(/\s*\S+\s*$/, "");
+  }
+  return appendTranscriptText(next, update.insert);
+};
+const appendInterimTranscript = (committed, interim) => appendTranscriptText(committed, interim);
+const RECOGNITION_ERROR_TO_VOICE_ERROR = {
+  "not-allowed": "permission",
+  "service-not-allowed": "permission",
+  "audio-capture": "microphone",
+  network: "network",
+  "language-not-supported": "unavailable",
+  "bad-grammar": "unavailable"
+};
+const MAX_SILENT_RESTARTS = 2;
+const detachRecognition = (recognition) => {
+  recognition.onresult = null;
+  recognition.onerror = null;
+  recognition.onend = null;
+};
+const useVoiceTranscription = ({
+  lang = "pt-BR",
+  onCommit,
+  onInterim
+}) => {
+  const [isListening, setIsListening] = useState(false);
+  const [error, setError] = useState(null);
+  const recognitionRef = useRef(null);
+  const wantsListeningRef = useRef(false);
+  const silentRestartCountRef = useRef(0);
+  const onCommitRef = useRef(onCommit);
+  const onInterimRef = useRef(onInterim);
+  onCommitRef.current = onCommit;
+  onInterimRef.current = onInterim;
+  const isSupported = useSyncExternalStore(subscribeToNothing, isRecognitionAvailable, isUnavailableOnServer);
+  const stop = useCallback(() => {
+    wantsListeningRef.current = false;
+    recognitionRef.current?.stop();
+  }, []);
+  const startSession = useCallback(() => {
+    const Ctor = getRecognitionCtor();
+    if (!Ctor) return false;
+    const oneUtterancePerSession = listensOneUtterancePerSession();
+    const recognition = new Ctor();
+    recognition.lang = lang;
+    recognition.continuous = !oneUtterancePerSession;
+    recognition.interimResults = true;
+    let sessionHeardSpeech = false;
+    let sessionEndedByError = false;
+    let uncommittedTranscript = "";
+    recognition.onresult = (event) => {
+      if (recognitionRef.current !== recognition) return;
+      sessionHeardSpeech = true;
+      if (oneUtterancePerSession) {
+        uncommittedTranscript = readUtterance(event);
+        onInterimRef.current?.(uncommittedTranscript);
+        return;
+      }
+      let interim = "";
+      for (let resultIndex = event.resultIndex; resultIndex < event.results.length; resultIndex += 1) {
+        const result = event.results[resultIndex];
+        const transcript = result?.[0]?.transcript ?? "";
+        if (result?.isFinal) {
+          onCommitRef.current(buildUpdateFromTranscript(transcript));
+        } else {
+          interim += transcript;
+        }
+      }
+      uncommittedTranscript = interim.trim();
+      onInterimRef.current?.(uncommittedTranscript);
+    };
+    recognition.onerror = (event) => {
+      if (recognitionRef.current !== recognition) return;
+      if (event.error === "no-speech") return;
+      sessionEndedByError = true;
+      if (event.error === "aborted") return;
+      uiLogger.warn("[useVoiceTranscription] error", event.error);
+      setError(RECOGNITION_ERROR_TO_VOICE_ERROR[event.error] ?? "unavailable");
+    };
+    recognition.onend = () => {
+      if (recognitionRef.current !== recognition) return;
+      if (uncommittedTranscript) onCommitRef.current(buildUpdateFromTranscript(uncommittedTranscript));
+      onInterimRef.current?.("");
+      silentRestartCountRef.current = sessionHeardSpeech ? 0 : silentRestartCountRef.current + 1;
+      const shouldResume = wantsListeningRef.current && !sessionEndedByError && silentRestartCountRef.current <= MAX_SILENT_RESTARTS;
+      if (shouldResume && startSession()) return;
+      wantsListeningRef.current = false;
+      recognitionRef.current = null;
+      setIsListening(false);
+    };
+    recognitionRef.current = recognition;
+    try {
+      recognition.start();
+      return true;
+    } catch (startError) {
+      uiLogger.warn("[useVoiceTranscription] start failed", startError);
+      detachRecognition(recognition);
+      recognitionRef.current = null;
+      setError("unavailable");
+      return false;
+    }
+  }, [lang]);
+  const start = useCallback(() => {
+    setError(null);
+    silentRestartCountRef.current = 0;
+    wantsListeningRef.current = true;
+    if (startSession()) {
+      setIsListening(true);
+      return;
+    }
+    wantsListeningRef.current = false;
+  }, [startSession]);
+  const toggle = useCallback(() => {
+    if (isListening) stop();
+    else start();
+  }, [isListening, start, stop]);
+  useEffect(
+    () => () => {
+      wantsListeningRef.current = false;
+      const recognition = recognitionRef.current;
+      if (!recognition) return;
+      detachRecognition(recognition);
+      recognitionRef.current = null;
+      recognition.abort();
+    },
+    []
+  );
+  return { isSupported, isListening, error, toggle, stop };
+};
+export {
+  VOICE_COMMANDS,
+  appendInterimTranscript,
+  applyVoiceUpdate,
+  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, useSyncExternalStore } 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  abort: () => 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\n/* The API never appears or goes away while a page is open, so there is nothing to subscribe to.\n   The store exists for the server answer: `window` is not there, and the first client render has\n   to agree with it for hydration to hold. */\nconst subscribeToNothing = () => () => undefined;\nconst isRecognitionAvailable = () => getRecognitionCtor() !== null;\nconst isUnavailableOnServer = () => false;\n\n/* Phones run another engine behind the same API. Asked to listen continuously it delivers earlier\n   phrases again and flags unfinished ones as final, so `isFinal` cannot be trusted there and a phone\n   listens one utterance per session, restarting between them. iPadOS reports itself as a Mac. */\nconst listensOneUtterancePerSession = (): boolean => {\n  const { userAgent, maxTouchPoints } = navigator;\n  return /Android|iPhone|iPad|iPod/i.test(userAgent) || (/Macintosh/i.test(userAgent) && maxTouchPoints > 1);\n};\n\n/* Those engines either grow one result in place or deliver the text so far again as a new result,\n   so a result that already holds what came before replaces it instead of being appended to it. */\nconst readUtterance = (event: ISpeechRecognitionEvent): string => {\n  let utterance = '';\n  for (let resultIndex = 0; resultIndex < event.results.length; resultIndex += 1) {\n    const transcript = event.results[resultIndex]?.[0]?.transcript?.trim() ?? '';\n    const normalizedTranscript = transcript.toLowerCase();\n    const normalizedUtterance = utterance.toLowerCase();\n    if (!transcript || normalizedUtterance.endsWith(normalizedTranscript)) continue;\n    utterance = normalizedTranscript.startsWith(normalizedUtterance) ? transcript : `${utterance} ${transcript}`;\n  }\n  return utterance;\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\nconst appendTranscriptText = (current: string, addition: string): string => {\n  if (!addition) return current;\n  const needsSpace = current.length > 0 && !/\\s$/.test(current) && !/^[\\s.,!?]/.test(addition);\n  return current + (needsSpace ? ' ' : '') + addition;\n};\n\nexport const applyVoiceUpdate = (current: string, update: IVoiceTranscriptionUpdate): string => {\n  let next = current;\n  for (let wordIndex = 0; wordIndex < update.deleteWords; wordIndex += 1) {\n    next = next.replace(/\\s*\\S+\\s*$/, '');\n  }\n  return appendTranscriptText(next, update.insert);\n};\n\nexport const appendInterimTranscript = (committed: string, interim: string): string =>\n  appendTranscriptText(committed, interim);\n\nexport type TVoiceTranscriptionError = 'permission' | 'microphone' | 'network' | 'unavailable';\n\nconst RECOGNITION_ERROR_TO_VOICE_ERROR: Record<string, TVoiceTranscriptionError> = {\n  'not-allowed': 'permission',\n  'service-not-allowed': 'permission',\n  'audio-capture': 'microphone',\n  network: 'network',\n  'language-not-supported': 'unavailable',\n  'bad-grammar': 'unavailable',\n};\n\nconst MAX_SILENT_RESTARTS = 2;\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  error: TVoiceTranscriptionError | null;\n  toggle: () => void;\n  stop: () => void;\n}\n\nconst detachRecognition = (recognition: ISpeechRecognition) => {\n  recognition.onresult = null;\n  recognition.onerror = null;\n  recognition.onend = null;\n};\n\nexport const useVoiceTranscription = ({\n  lang = 'pt-BR',\n  onCommit,\n  onInterim,\n}: IUseVoiceTranscriptionParams): IUseVoiceTranscriptionResult => {\n  const [isListening, setIsListening] = useState(false);\n  const [error, setError] = useState<TVoiceTranscriptionError | null>(null);\n  const recognitionRef = useRef<ISpeechRecognition | null>(null);\n  const wantsListeningRef = useRef(false);\n  const silentRestartCountRef = useRef(0);\n  const onCommitRef = useRef(onCommit);\n  const onInterimRef = useRef(onInterim);\n\n  onCommitRef.current = onCommit;\n  onInterimRef.current = onInterim;\n\n  const isSupported = useSyncExternalStore(subscribeToNothing, isRecognitionAvailable, isUnavailableOnServer);\n\n  const stop = useCallback(() => {\n    wantsListeningRef.current = false;\n    recognitionRef.current?.stop();\n  }, []);\n\n  const startSession = useCallback((): boolean => {\n    const Ctor = getRecognitionCtor();\n    if (!Ctor) return false;\n\n    const oneUtterancePerSession = listensOneUtterancePerSession();\n\n    const recognition = new Ctor();\n    recognition.lang = lang;\n    recognition.continuous = !oneUtterancePerSession;\n    recognition.interimResults = true;\n\n    let sessionHeardSpeech = false;\n    let sessionEndedByError = false;\n    let uncommittedTranscript = '';\n\n    recognition.onresult = (event) => {\n      if (recognitionRef.current !== recognition) return;\n      sessionHeardSpeech = true;\n\n      if (oneUtterancePerSession) {\n        uncommittedTranscript = readUtterance(event);\n        onInterimRef.current?.(uncommittedTranscript);\n        return;\n      }\n\n      let interim = '';\n      for (let resultIndex = event.resultIndex; resultIndex < event.results.length; resultIndex += 1) {\n        const result = event.results[resultIndex];\n        const transcript = result?.[0]?.transcript ?? '';\n        if (result?.isFinal) {\n          onCommitRef.current(buildUpdateFromTranscript(transcript));\n        } else {\n          interim += transcript;\n        }\n      }\n      uncommittedTranscript = interim.trim();\n      onInterimRef.current?.(uncommittedTranscript);\n    };\n\n    recognition.onerror = (event) => {\n      if (recognitionRef.current !== recognition) return;\n      if (event.error === 'no-speech') return;\n      sessionEndedByError = true;\n      if (event.error === 'aborted') return;\n      uiLogger.warn('[useVoiceTranscription] error', event.error);\n      setError(RECOGNITION_ERROR_TO_VOICE_ERROR[event.error] ?? 'unavailable');\n    };\n\n    recognition.onend = () => {\n      if (recognitionRef.current !== recognition) return;\n      if (uncommittedTranscript) onCommitRef.current(buildUpdateFromTranscript(uncommittedTranscript));\n      onInterimRef.current?.('');\n      silentRestartCountRef.current = sessionHeardSpeech ? 0 : silentRestartCountRef.current + 1;\n      const shouldResume =\n        wantsListeningRef.current && !sessionEndedByError && silentRestartCountRef.current <= MAX_SILENT_RESTARTS;\n      if (shouldResume && startSession()) return;\n      wantsListeningRef.current = false;\n      recognitionRef.current = null;\n      setIsListening(false);\n    };\n\n    recognitionRef.current = recognition;\n    try {\n      recognition.start();\n      return true;\n    } catch (startError) {\n      uiLogger.warn('[useVoiceTranscription] start failed', startError);\n      detachRecognition(recognition);\n      recognitionRef.current = null;\n      setError('unavailable');\n      return false;\n    }\n  }, [lang]);\n\n  const start = useCallback(() => {\n    setError(null);\n    silentRestartCountRef.current = 0;\n    wantsListeningRef.current = true;\n    if (startSession()) {\n      setIsListening(true);\n      return;\n    }\n    wantsListeningRef.current = false;\n  }, [startSession]);\n\n  const toggle = useCallback(() => {\n    if (isListening) stop();\n    else start();\n  }, [isListening, start, stop]);\n\n  useEffect(\n    () => () => {\n      wantsListeningRef.current = false;\n      const recognition = recognitionRef.current;\n      if (!recognition) return;\n      detachRecognition(recognition);\n      recognitionRef.current = null;\n      recognition.abort();\n    },\n    [],\n  );\n\n  return { isSupported, isListening, error, toggle, stop };\n};\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+export { default as ControlledButton, getButtonClassName } 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 FieldLabel } from './components/Form/FieldLabel';
+export { default as ControlledBreadcrumb } from './components/Navigation/ControlledBreadcrumb';
+export { default as ErrorPage } from './components/Navigation/ErrorPage';
+export { default as LinkButton } from './components/Navigation/LinkButton';
+export { default as PageTitle } from './components/Navigation/PageTitle';
+export * from './components/Navigation/PageTitleNavigationContext';
+export * from './components/Navigation/UiNavigationContext';
+export { default as UnifiedSearchBar } from './components/Search/UnifiedSearchBar';
+export { default as AppShell } from './components/Shell/AppShell';
+export { default as ShellLanguageToggle } from './components/Shell/LanguageToggle';
+export * from './components/Shell/SidebarMenu';
+export { default as ShellThemeToggle } from './components/Shell/ThemeToggle';
+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 type { IImageMaskPainterProps } from './components/UI/ImageMaskPainter/index';
+export { default as ImageMaskPainter } from './components/UI/ImageMaskPainter/index';
+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 { default as UserMenu } from './components/UI/UserMenu';
+export * from './helpers/composeRefs';
+export * from './helpers/layeredSurfaces';
+export * from './helpers/mergeClasses';
+export * from './helpers/themeSkins';
+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 './hooks/useThemeSkin';
+export * from './locales';
+export * from './motion/index';

package/dist/index.js

@@ -0,0 +1,157 @@
+import { default as default2, getButtonClassName } from "./components/Form/ControlledButton.js";
+import { default as default3 } from "./components/Form/ControlledCheckbox.js";
+import { default as default4 } from "./components/Form/ControlledDialog.js";
+import { default as default5 } from "./components/Form/ControlledDrawer.js";
+import { default as default6 } from "./components/Form/ControlledImage/index.js";
+import { default as default7 } from "./components/Form/ControlledInput.js";
+import { default as default8 } from "./components/Form/ControlledRadio.js";
+import { ControlledSelect } from "./components/Form/ControlledSelect.js";
+import { default as default9 } from "./components/Form/ControlledSwitch.js";
+import { default as default10 } from "./components/Form/ControlledTabs.js";
+import { default as default11 } from "./components/Form/ControlledTextarea.js";
+import { default as default12 } from "./components/Form/ControlledViewToggle.js";
+import { default as default13 } from "./components/Form/FieldLabel.js";
+import { default as default14 } from "./components/Navigation/ControlledBreadcrumb.js";
+import { default as default15 } from "./components/Navigation/ErrorPage.js";
+import { default as default16 } from "./components/Navigation/LinkButton.js";
+import { default as default17 } from "./components/Navigation/PageTitle.js";
+import { PageTitleNavigationProvider, usePageTitleNavigation } from "./components/Navigation/PageTitleNavigationContext.js";
+import { UiNavigationProvider, useUiNavigation } from "./components/Navigation/UiNavigationContext.js";
+import { default as default18 } from "./components/Search/UnifiedSearchBar.js";
+import { default as default19 } from "./components/Shell/AppShell.js";
+import { default as default20 } from "./components/Shell/LanguageToggle.js";
+import { resolveSidebarItemId } from "./components/Shell/SidebarMenu.js";
+import { default as default21 } from "./components/Shell/ThemeToggle.js";
+import { UiAccessProvider, useUiAccess } from "./components/UI/access/UiAccessContext.js";
+import { default as default22 } from "./components/UI/BaseDataCard.js";
+import { default as default23 } from "./components/UI/Chips/OutlinedChip.js";
+import { default as default24 } from "./components/UI/Colors.js";
+import { default as default25 } from "./components/UI/ColorSwatch.js";
+import { default as default26 } from "./components/UI/ControlledAccordion.js";
+import { default as default27 } from "./components/UI/ControlledCollapse.js";
+import { default as default28 } from "./components/UI/ControlledMenu.js";
+import { default as default29 } from "./components/UI/ControlledPopover.js";
+import { default as default30 } from "./components/UI/ControlledProgress.js";
+import { default as default31 } from "./components/UI/ControlledSlider.js";
+import { default as default32 } from "./components/UI/ControlledTooltip.js";
+import { default as default33 } from "./components/UI/CustomBadge.js";
+import { default as default34 } from "./components/UI/CustomCard.js";
+import { default as default35 } from "./components/UI/ImageMaskPainter/index.js";
+import { default as default36 } from "./components/UI/InformationCard.js";
+import { default as default37 } from "./components/UI/LoadingSpinner.js";
+import { MaterialSymbol, combineClasses } from "./components/UI/MaterialSymbol/index.js";
+import { default as default38 } from "./components/UI/NoDataFound/index.js";
+import { default as default39 } from "./components/UI/SkeletonLoading.js";
+import { default as default40 } from "./components/UI/UserMenu.js";
+import { composeRefs } from "./helpers/composeRefs.js";
+import { LAYERED_SURFACE_ATTRIBUTE, LAYERED_SURFACE_DATA_ATTRIBUTE, LAYERED_SURFACE_SELECTOR, isPressOnLayeredSurface } from "./helpers/layeredSurfaces.js";
+import { mergeClasses } from "./helpers/mergeClasses.js";
+import { UI_THEME_SKINS, UI_THEME_SKIN_ATTRIBUTE, UI_THEME_SKIN_SCHEMES, isUiThemeSkin } from "./helpers/themeSkins.js";
+import { readThemeToken, useThemeChartTokens } from "./helpers/themeTokens.js";
+import { configureUiLogger, uiLogger } from "./helpers/uiLogger.js";
+import { configureUiPreferences, readUiPreference, resolveUiPreferenceScopeId, writeUiPreference } from "./helpers/uiPreferences.js";
+import { useAnchoredFloating } from "./hooks/useAnchoredFloating.js";
+import { BREAKPOINTS, useBreakpoint } from "./hooks/useBreakpoint.js";
+import { useDebounce } from "./hooks/useDebounce.js";
+import { useHoverCapable } from "./hooks/useHoverCapable.js";
+import { useMobile } from "./hooks/useMobile.js";
+import { useNotification, useNotificationStore } from "./hooks/useNotification.js";
+import { useResolvedTheme } from "./hooks/useResolvedTheme.js";
+import { useThemeSkin } from "./hooks/useThemeSkin.js";
+import { uiLocales } from "./locales/index.js";
+import { collapseVariants, createDrawerVariants, dialogVariants, fadeVariants, floatingVariants, scrimVariants, tooltipVariants } from "./motion/motionPresets.js";
+import { MOTION_OFFSET_PX, enterTransition, exitTransition, motionDuration, motionEase } from "./motion/motionTokens.js";
+export {
+  default19 as AppShell,
+  BREAKPOINTS,
+  default22 as BaseDataCard,
+  default25 as ColorSwatch,
+  default24 as Colors,
+  default26 as ControlledAccordion,
+  default14 as ControlledBreadcrumb,
+  default2 as ControlledButton,
+  default3 as ControlledCheckbox,
+  default27 as ControlledCollapse,
+  default4 as ControlledDialog,
+  default5 as ControlledDrawer,
+  default6 as ControlledImage,
+  default7 as ControlledInput,
+  default28 as ControlledMenu,
+  default29 as ControlledPopover,
+  default30 as ControlledProgress,
+  default8 as ControlledRadio,
+  ControlledSelect,
+  default31 as ControlledSlider,
+  default9 as ControlledSwitch,
+  default10 as ControlledTabs,
+  default11 as ControlledTextarea,
+  default32 as ControlledTooltip,
+  default12 as ControlledViewToggle,
+  default33 as CustomBadge,
+  default34 as CustomCard,
+  default15 as ErrorPage,
+  default13 as FieldLabel,
+  default35 as ImageMaskPainter,
+  default36 as InformationCard,
+  LAYERED_SURFACE_ATTRIBUTE,
+  LAYERED_SURFACE_DATA_ATTRIBUTE,
+  LAYERED_SURFACE_SELECTOR,
+  default16 as LinkButton,
+  default37 as LoadingSpinner,
+  MOTION_OFFSET_PX,
+  MaterialSymbol,
+  default38 as NoDataFound,
+  default23 as OutlinedChip,
+  default17 as PageTitle,
+  PageTitleNavigationProvider,
+  default20 as ShellLanguageToggle,
+  default21 as ShellThemeToggle,
+  default39 as SkeletonLoading,
+  UI_THEME_SKINS,
+  UI_THEME_SKIN_ATTRIBUTE,
+  UI_THEME_SKIN_SCHEMES,
+  UiAccessProvider,
+  UiNavigationProvider,
+  default18 as UnifiedSearchBar,
+  default40 as UserMenu,
+  collapseVariants,
+  combineClasses,
+  composeRefs,
+  configureUiLogger,
+  configureUiPreferences,
+  createDrawerVariants,
+  dialogVariants,
+  enterTransition,
+  exitTransition,
+  fadeVariants,
+  floatingVariants,
+  getButtonClassName,
+  isPressOnLayeredSurface,
+  isUiThemeSkin,
+  mergeClasses,
+  motionDuration,
+  motionEase,
+  readThemeToken,
+  readUiPreference,
+  resolveSidebarItemId,
+  resolveUiPreferenceScopeId,
+  scrimVariants,
+  tooltipVariants,
+  uiLocales,
+  uiLogger,
+  useAnchoredFloating,
+  useBreakpoint,
+  useDebounce,
+  useHoverCapable,
+  useMobile,
+  useNotification,
+  useNotificationStore,
+  usePageTitleNavigation,
+  useResolvedTheme,
+  useThemeChartTokens,
+  useThemeSkin,
+  useUiAccess,
+  useUiNavigation,
+  writeUiPreference
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/interfaces/IFileAttachment.d.ts

@@ -0,0 +1,18 @@
+export type TFileAttachmentKind = 'image' | 'audio' | 'video' | 'pdf' | 'document' | 'other';
+/**
+ * A file that finished uploading and can be referenced by anything that composes text: a chat
+ * message, a task description, a comment. The shape is the one the attachments endpoint already
+ * returns, so no surface needs its own upload contract.
+ */
+export interface IFileAttachment {
+    fileId: string;
+    url: string;
+    name: string;
+    mimeType: string;
+    size: number;
+    kind: TFileAttachmentKind;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    transcript?: string;
+}

package/dist/interfaces/IFileAttachment.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IFileAttachment.js.map

package/dist/interfaces/IFileAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFileAttachment.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/interfaces/IFilterOption.d.ts

@@ -0,0 +1,12 @@
+export interface IFilterOption {
+    value: string;
+    label: string;
+    tooltip?: string;
+    swatch?: string;
+    /** Contexto secundário da opção (fornecedor, código, origem), exibido menor ao lado do rótulo. */
+    secondaryLabel?: string;
+    /** Renders `secondaryLabel` as a brand chip instead of faint text, for a context worth noticing. */
+    emphasizeSecondaryLabel?: boolean;
+    /** Opção visível mas não selecionável (continua na lista para o usuário saber que existe). */
+    disabled?: boolean;
+}

package/dist/interfaces/IFilterOption.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IFilterOption.js.map

package/dist/interfaces/IFilterOption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFilterOption.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}