@grazziotin/react-components-next 1.0.1 → 2.1.0

package/dist/accessibility/index.d.mts

@@ -0,0 +1,136 @@
+import react__default from 'react';
+
+type SayFeedbackType = "info" | "success" | "warning" | "error" | "default";
+interface SayNotifyOptions {
+    type?: SayFeedbackType;
+    autoClose?: number;
+}
+interface SayCallOptions {
+    /**
+     * Tipo de feedback.  desativa notificação.
+     * Padrão:  (via  do hook).
+     */
+    type?: SayFeedbackType | false;
+    /**
+     * Exibe notificação via .
+     * Padrão: .
+     */
+    notify?: boolean;
+    /**
+     * Dispara vibração conforme .
+     * Padrão: .
+     */
+    vibrate?: boolean;
+    /** Duração da notificação em ms (repasse para ). */
+    autoClose?: number;
+}
+interface UseSayOptions {
+    /**
+     * Callback de notificação visual (ex.: toast).
+     * Omitir para não exibir notificação.
+     */
+    onNotify?: (text: string, options: SayNotifyOptions) => void;
+    /**
+     * Tipo padrão da notificação.
+     * Padrão: .
+     */
+    defaultNotifyType?: SayFeedbackType;
+    /**
+     * Auto-close padrão da notificação em ms.
+     * Padrão: .
+     */
+    defaultNotifyAutoClose?: number;
+    /**
+     * Duração padrão da vibração em ms.
+     * Padrão: .
+     */
+    vibrateDuration?: number;
+    /**
+     * Define se deve vibrar para o  informado.
+     * Padrão:  ( quando  é omitido ou ).
+     */
+    shouldVibrate?: (type?: SayFeedbackType | false) => boolean;
+}
+interface UseSayReturn {
+    say: (text: string, options?: SayCallOptions) => void;
+    isSpeaking: boolean;
+    textSpeaking: string;
+    setIsSpeaking: React.Dispatch<React.SetStateAction<boolean>>;
+}
+interface SayProps {
+    isSpeaking: boolean;
+    text: string;
+    setIsSpeaking: React.Dispatch<React.SetStateAction<boolean>>;
+    /**
+     * Nome da voz do .
+     * Padrão: .
+     */
+    voice?: string;
+    /**
+     * Velocidade da fala.
+     * Padrão: .
+     */
+    rate?: number;
+    /**
+     * Tom da voz.
+     * Padrão: .
+     */
+    pitch?: number;
+    /**
+     * Volume da fala.
+     * Padrão: .
+     */
+    volume?: number;
+    onEnd?: () => void;
+    onStart?: () => void;
+}
+
+/**
+ * Hook para disparar fala, notificação e vibração de forma configurável.
+ *
+ * @example
+ * ```tsx
+ * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({
+ *   onNotify: (text, { type }) => toast(text, { type }),
+ * });
+ *
+ * <Say
+ *   isSpeaking={isSpeaking}
+ *   text={textSpeaking}
+ *   setIsSpeaking={setIsSpeaking}
+ * />
+ *
+ * <button type="button" onClick={() => say("Operação concluída")}>
+ *   Falar
+ * </button>
+ * ```
+ */
+declare function useSay({ onNotify, defaultNotifyType, vibrateDuration, defaultNotifyAutoClose, shouldVibrate, }?: UseSayOptions): UseSayReturn;
+
+/**
+ * Sintetiza texto em fala via Web Speech API (`react-say`).
+ * Use com {@link useSay} para controlar `isSpeaking`, `text` e `setIsSpeaking`.
+ *
+ * @example
+ * ```tsx
+ * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({
+ *   onNotify: (text, { type }) => toast(text, { type }),
+ * });
+ *
+ * return (
+ *   <>
+ *     <Say
+ *       isSpeaking={isSpeaking}
+ *       text={textSpeaking}
+ *       setIsSpeaking={setIsSpeaking}
+ *       voice="Google português do Brasil"
+ *       rate={1.4}
+ *     />
+ *     <button type="button" onClick={() => say("Pronto")}>Falar</button>
+ *   </>
+ * );
+ * ```
+ */
+declare function Say({ text, onEnd, onStart, isSpeaking, setIsSpeaking, rate, voice, pitch, volume, }: Readonly<SayProps>): react__default.ReactElement | null;
+
+export { Say, type SayCallOptions, type SayFeedbackType, type SayNotifyOptions, type SayProps, type UseSayOptions, type UseSayReturn, useSay };

package/dist/accessibility/index.d.ts

@@ -0,0 +1,136 @@
+import react__default from 'react';
+
+type SayFeedbackType = "info" | "success" | "warning" | "error" | "default";
+interface SayNotifyOptions {
+    type?: SayFeedbackType;
+    autoClose?: number;
+}
+interface SayCallOptions {
+    /**
+     * Tipo de feedback.  desativa notificação.
+     * Padrão:  (via  do hook).
+     */
+    type?: SayFeedbackType | false;
+    /**
+     * Exibe notificação via .
+     * Padrão: .
+     */
+    notify?: boolean;
+    /**
+     * Dispara vibração conforme .
+     * Padrão: .
+     */
+    vibrate?: boolean;
+    /** Duração da notificação em ms (repasse para ). */
+    autoClose?: number;
+}
+interface UseSayOptions {
+    /**
+     * Callback de notificação visual (ex.: toast).
+     * Omitir para não exibir notificação.
+     */
+    onNotify?: (text: string, options: SayNotifyOptions) => void;
+    /**
+     * Tipo padrão da notificação.
+     * Padrão: .
+     */
+    defaultNotifyType?: SayFeedbackType;
+    /**
+     * Auto-close padrão da notificação em ms.
+     * Padrão: .
+     */
+    defaultNotifyAutoClose?: number;
+    /**
+     * Duração padrão da vibração em ms.
+     * Padrão: .
+     */
+    vibrateDuration?: number;
+    /**
+     * Define se deve vibrar para o  informado.
+     * Padrão:  ( quando  é omitido ou ).
+     */
+    shouldVibrate?: (type?: SayFeedbackType | false) => boolean;
+}
+interface UseSayReturn {
+    say: (text: string, options?: SayCallOptions) => void;
+    isSpeaking: boolean;
+    textSpeaking: string;
+    setIsSpeaking: React.Dispatch<React.SetStateAction<boolean>>;
+}
+interface SayProps {
+    isSpeaking: boolean;
+    text: string;
+    setIsSpeaking: React.Dispatch<React.SetStateAction<boolean>>;
+    /**
+     * Nome da voz do .
+     * Padrão: .
+     */
+    voice?: string;
+    /**
+     * Velocidade da fala.
+     * Padrão: .
+     */
+    rate?: number;
+    /**
+     * Tom da voz.
+     * Padrão: .
+     */
+    pitch?: number;
+    /**
+     * Volume da fala.
+     * Padrão: .
+     */
+    volume?: number;
+    onEnd?: () => void;
+    onStart?: () => void;
+}
+
+/**
+ * Hook para disparar fala, notificação e vibração de forma configurável.
+ *
+ * @example
+ * ```tsx
+ * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({
+ *   onNotify: (text, { type }) => toast(text, { type }),
+ * });
+ *
+ * <Say
+ *   isSpeaking={isSpeaking}
+ *   text={textSpeaking}
+ *   setIsSpeaking={setIsSpeaking}
+ * />
+ *
+ * <button type="button" onClick={() => say("Operação concluída")}>
+ *   Falar
+ * </button>
+ * ```
+ */
+declare function useSay({ onNotify, defaultNotifyType, vibrateDuration, defaultNotifyAutoClose, shouldVibrate, }?: UseSayOptions): UseSayReturn;
+
+/**
+ * Sintetiza texto em fala via Web Speech API (`react-say`).
+ * Use com {@link useSay} para controlar `isSpeaking`, `text` e `setIsSpeaking`.
+ *
+ * @example
+ * ```tsx
+ * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({
+ *   onNotify: (text, { type }) => toast(text, { type }),
+ * });
+ *
+ * return (
+ *   <>
+ *     <Say
+ *       isSpeaking={isSpeaking}
+ *       text={textSpeaking}
+ *       setIsSpeaking={setIsSpeaking}
+ *       voice="Google português do Brasil"
+ *       rate={1.4}
+ *     />
+ *     <button type="button" onClick={() => say("Pronto")}>Falar</button>
+ *   </>
+ * );
+ * ```
+ */
+declare function Say({ text, onEnd, onStart, isSpeaking, setIsSpeaking, rate, voice, pitch, volume, }: Readonly<SayProps>): react__default.ReactElement | null;
+
+export { Say, type SayCallOptions, type SayFeedbackType, type SayNotifyOptions, type SayProps, type UseSayOptions, type UseSayReturn, useSay };

package/dist/accessibility/index.js

@@ -0,0 +1,138 @@
+'use strict';
+
+var SayEngine = require('react-say');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var SayEngine__default = /*#__PURE__*/_interopDefault(SayEngine);
+
+// src/components/accessibility/say/utils/constants.ts
+var SPEECH_APIS = ["speechSynthesis", "SpeechSynthesisUtterance"];
+function hasSpeechSupport() {
+  return SPEECH_APIS.every((api) => api in globalThis);
+}
+function voicesAreEqual(current, next) {
+  if (current.length !== next.length) return false;
+  return current.every(
+    (v, i) => {
+      var _a, _b;
+      return v.name === ((_a = next[i]) == null ? void 0 : _a.name) && v.lang === ((_b = next[i]) == null ? void 0 : _b.lang);
+    }
+  );
+}
+function getSpeechSupport() {
+  if (!hasSpeechSupport()) return null;
+  return {
+    speechSynthesis: globalThis.speechSynthesis,
+    SpeechSynthesisUtterance: globalThis.SpeechSynthesisUtterance
+  };
+}
+var DEFAULT_SAY_VOICE = "Google portugu\xEAs do Brasil";
+var DEFAULT_SAY_RATE = 1.4;
+var DEFAULT_SAY_PITCH = 0.8;
+var DEFAULT_SAY_VOLUME = 1;
+var DEFAULT_SAY_NOTIFY_AUTO_CLOSE = 1500;
+var DEFAULT_SAY_VIBRATE_DURATION = 500;
+function defaultShouldVibrate(type) {
+  return !type || type === "warning";
+}
+
+// src/functions/nvl/nvl.ts
+function nvl(value, defaultValue) {
+  return value != null ? value : defaultValue;
+}
+function useSay({
+  onNotify,
+  defaultNotifyType = "success",
+  vibrateDuration = DEFAULT_SAY_VIBRATE_DURATION,
+  defaultNotifyAutoClose = DEFAULT_SAY_NOTIFY_AUTO_CLOSE,
+  shouldVibrate = defaultShouldVibrate
+} = {}) {
+  const [isSpeaking, setIsSpeaking] = react.useState(false);
+  const [textSpeaking, setTextSpeaking] = react.useState("");
+  const say = react.useCallback(
+    (text, options) => {
+      const type = options == null ? void 0 : options.type;
+      const notify = nvl(options == null ? void 0 : options.notify, true);
+      const vibrate = nvl(options == null ? void 0 : options.vibrate, true);
+      setIsSpeaking(true);
+      setTextSpeaking(text);
+      if (notify && type !== false && onNotify) {
+        onNotify(text, {
+          type: nvl(type, defaultNotifyType),
+          autoClose: nvl(options == null ? void 0 : options.autoClose, defaultNotifyAutoClose)
+        });
+      }
+      if (vibrate && shouldVibrate(type) && navigator.vibrate) {
+        navigator.vibrate(vibrateDuration);
+      }
+    },
+    [
+      onNotify,
+      shouldVibrate,
+      vibrateDuration,
+      defaultNotifyType,
+      defaultNotifyAutoClose
+    ]
+  );
+  return { say, isSpeaking, textSpeaking, setIsSpeaking };
+}
+function useSpeechPonyfill() {
+  const ponyfill = react.useMemo(() => getSpeechSupport(), []);
+  const [voices, setVoices] = react.useState([]);
+  react.useEffect(() => {
+    if (!hasSpeechSupport()) return;
+    const synthesis = globalThis.speechSynthesis;
+    const updateVoices = () => {
+      setVoices((current) => {
+        const next = synthesis.getVoices();
+        return voicesAreEqual(current, next) ? current : next;
+      });
+    };
+    synthesis.onvoiceschanged = updateVoices;
+    updateVoices();
+    return () => {
+      synthesis.onvoiceschanged = null;
+    };
+  }, []);
+  return { voices, ponyfill };
+}
+function Say({
+  text,
+  onEnd,
+  onStart,
+  isSpeaking,
+  setIsSpeaking,
+  rate = DEFAULT_SAY_RATE,
+  voice = DEFAULT_SAY_VOICE,
+  pitch = DEFAULT_SAY_PITCH,
+  volume = DEFAULT_SAY_VOLUME
+}) {
+  const { voices, ponyfill } = useSpeechPonyfill();
+  const handleEnd = react.useCallback(() => {
+    setIsSpeaking(false);
+    onEnd == null ? void 0 : onEnd();
+  }, [setIsSpeaking, onEnd]);
+  if (!isSpeaking || voices.length === 0 || !ponyfill) return null;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    SayEngine__default.default,
+    {
+      text,
+      rate,
+      pitch,
+      volume,
+      onEnd: handleEnd,
+      onStart,
+      ponyfill,
+      voice: voices.find((v) => v.name === voice)
+    }
+  );
+}
+var say_default = Say;
+
+exports.Say = say_default;
+exports.useSay = useSay;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/accessibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/accessibility/say/utils/constants.ts","../../src/functions/nvl/nvl.ts","../../src/components/accessibility/say/use-say.ts","../../src/components/accessibility/say/use-speech-ponyfill.ts","../../src/components/accessibility/say/index.tsx"],"names":["useState","useCallback","useMemo","useEffect","jsx","SayEngine"],"mappings":"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","file":"index.js","sourcesContent":["import type { SpeechPonyfill } from \"./interface\";\r\n\r\nexport const SPEECH_APIS = [\"speechSynthesis\", \"SpeechSynthesisUtterance\"];\r\n\r\nexport function hasSpeechSupport(): boolean {\r\n  return SPEECH_APIS.every((api) => api in globalThis);\r\n}\r\n\r\nexport function voicesAreEqual(\r\n  current: SpeechSynthesisVoice[],\r\n  next: SpeechSynthesisVoice[],\r\n): boolean {\r\n  if (current.length !== next.length) return false;\r\n\r\n  return current.every(\r\n    (v, i) => v.name === next[i]?.name && v.lang === next[i]?.lang,\r\n  );\r\n}\r\n\r\nexport function getSpeechSupport(): SpeechPonyfill | null {\r\n  if (!hasSpeechSupport()) return null;\r\n\r\n  return {\r\n    speechSynthesis: globalThis.speechSynthesis,\r\n    SpeechSynthesisUtterance: globalThis.SpeechSynthesisUtterance,\r\n  };\r\n}\r\n\r\nexport const DEFAULT_SAY_VOICE = \"Google português do Brasil\";\r\nexport const DEFAULT_SAY_RATE = 1.4;\r\nexport const DEFAULT_SAY_PITCH = 0.8;\r\nexport const DEFAULT_SAY_VOLUME = 1;\r\nexport const DEFAULT_SAY_NOTIFY_AUTO_CLOSE = 1500;\r\nexport const DEFAULT_SAY_VIBRATE_DURATION = 500;\r\n\r\nexport function defaultShouldVibrate(\r\n  type?: import(\"./interface\").SayFeedbackType | false,\r\n): boolean {\r\n  return !type || type === \"warning\";\r\n}\r\n\r\nconst sayConstants = `\r\nSintetiza texto em fala via Web Speech API (\\`react-say\\`), com hook \\`useSay\\` para notificação e vibração.\r\n\r\n**Importação:**\r\n\\`\\`\\`tsx\r\nimport { Say, useSay } from \"@grazziotin/react-components-next/accessibility\";\r\n\\`\\`\\`\r\n\r\n**Uso básico:**\r\n\\`\\`\\`tsx\r\nconst { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n  onNotify: (text, { type }) => toast(text, { type }),\r\n});\r\n\r\n<>\r\n  <Say\r\n    isSpeaking={isSpeaking}\r\n    text={textSpeaking}\r\n    setIsSpeaking={setIsSpeaking}\r\n  />\r\n  <button type=\"button\" onClick={() => say(\"Operação concluída\")}>\r\n    Falar\r\n  </button>\r\n</>\r\n\\`\\`\\`\r\n\r\nRequer suporte a \\`speechSynthesis\\` no navegador. A voz padrão é \\`Google português do Brasil\\`.\r\n`;\r\n\r\nexport default sayConstants;\r\n","/**\r\n * Função NVL (Null Value Logic) - retorna valor padrão se o valor for null/undefined\r\n * @param {T | null | undefined} value - Valor a ser verificado\r\n * @param {T} defaultValue - Valor padrão a ser retornado se value for null/undefined\r\n * @returns {T} Value se não for null/undefined, senão defaultValue\r\n * @template T - Tipo do valor\r\n * @example\r\n * nvl(null, 'padrão') // Retorna: 'padrão'\r\n * nvl('valor', 'padrão') // Retorna: 'valor'\r\n */\r\nexport function nvl<T>(value: T | null | undefined, defaultValue: T): T {\r\n  return value ?? defaultValue;\r\n}\r\n","import {\r\n  defaultShouldVibrate,\r\n  DEFAULT_SAY_NOTIFY_AUTO_CLOSE,\r\n  DEFAULT_SAY_VIBRATE_DURATION,\r\n} from \"./utils/constants\";\r\nimport type {\r\n  UseSayReturn,\r\n  UseSayOptions,\r\n  SayCallOptions,\r\n} from \"./utils/interface\";\r\nimport { nvl } from \"@/functions\";\r\nimport { useCallback, useState } from \"react\";\r\n\r\n/**\r\n * Hook para disparar fala, notificação e vibração de forma configurável.\r\n *\r\n * @example\r\n * ```tsx\r\n * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n *   onNotify: (text, { type }) => toast(text, { type }),\r\n * });\r\n *\r\n * <Say\r\n *   isSpeaking={isSpeaking}\r\n *   text={textSpeaking}\r\n *   setIsSpeaking={setIsSpeaking}\r\n * />\r\n *\r\n * <button type=\"button\" onClick={() => say(\"Operação concluída\")}>\r\n *   Falar\r\n * </button>\r\n * ```\r\n */\r\nexport function useSay({\r\n  onNotify,\r\n  defaultNotifyType = \"success\",\r\n  vibrateDuration = DEFAULT_SAY_VIBRATE_DURATION,\r\n  defaultNotifyAutoClose = DEFAULT_SAY_NOTIFY_AUTO_CLOSE,\r\n  shouldVibrate = defaultShouldVibrate,\r\n}: UseSayOptions = {}): UseSayReturn {\r\n  const [isSpeaking, setIsSpeaking] = useState(false);\r\n  const [textSpeaking, setTextSpeaking] = useState(\"\");\r\n\r\n  const say = useCallback(\r\n    (text: string, options?: SayCallOptions) => {\r\n      const type = options?.type;\r\n      const notify = nvl(options?.notify, true);\r\n      const vibrate = nvl(options?.vibrate, true);\r\n\r\n      setIsSpeaking(true);\r\n      setTextSpeaking(text);\r\n\r\n      if (notify && type !== false && onNotify) {\r\n        onNotify(text, {\r\n          type: nvl(type, defaultNotifyType),\r\n          autoClose: nvl(options?.autoClose, defaultNotifyAutoClose),\r\n        });\r\n      }\r\n\r\n      if (vibrate && shouldVibrate(type) && navigator.vibrate) {\r\n        navigator.vibrate(vibrateDuration);\r\n      }\r\n    },\r\n    [\r\n      onNotify,\r\n      shouldVibrate,\r\n      vibrateDuration,\r\n      defaultNotifyType,\r\n      defaultNotifyAutoClose,\r\n    ],\r\n  );\r\n\r\n  return { say, isSpeaking, textSpeaking, setIsSpeaking };\r\n}\r\n","import {\r\n  getSpeechSupport,\r\n  hasSpeechSupport,\r\n  voicesAreEqual,\r\n} from \"./utils/constants\";\r\nimport { useEffect, useMemo, useState } from \"react\";\r\n\r\nexport function useSpeechPonyfill() {\r\n  const ponyfill = useMemo(() => getSpeechSupport(), []);\r\n  const [voices, setVoices] = useState<SpeechSynthesisVoice[]>([]);\r\n\r\n  useEffect(() => {\r\n    if (!hasSpeechSupport()) return;\r\n\r\n    const synthesis = globalThis.speechSynthesis;\r\n\r\n    const updateVoices = () => {\r\n      setVoices((current) => {\r\n        const next = synthesis.getVoices();\r\n        return voicesAreEqual(current, next) ? current : next;\r\n      });\r\n    };\r\n\r\n    synthesis.onvoiceschanged = updateVoices;\r\n    updateVoices();\r\n\r\n    return () => {\r\n      synthesis.onvoiceschanged = null;\r\n    };\r\n  }, []);\r\n\r\n  return { voices, ponyfill };\r\n}\r\n","\"use client\";\r\n\r\nimport {\r\n  DEFAULT_SAY_PITCH,\r\n  DEFAULT_SAY_RATE,\r\n  DEFAULT_SAY_VOICE,\r\n  DEFAULT_SAY_VOLUME,\r\n} from \"./utils/constants\";\r\nimport SayEngine from \"react-say\";\r\nexport { useSay } from \"./use-say\";\r\nimport React, { useCallback } from \"react\";\r\nimport type { SayProps } from \"./utils/interface\";\r\nimport { useSpeechPonyfill } from \"./use-speech-ponyfill\";\r\n\r\n/**\r\n * Sintetiza texto em fala via Web Speech API (`react-say`).\r\n * Use com {@link useSay} para controlar `isSpeaking`, `text` e `setIsSpeaking`.\r\n *\r\n * @example\r\n * ```tsx\r\n * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n *   onNotify: (text, { type }) => toast(text, { type }),\r\n * });\r\n *\r\n * return (\r\n *   <>\r\n *     <Say\r\n *       isSpeaking={isSpeaking}\r\n *       text={textSpeaking}\r\n *       setIsSpeaking={setIsSpeaking}\r\n *       voice=\"Google português do Brasil\"\r\n *       rate={1.4}\r\n *     />\r\n *     <button type=\"button\" onClick={() => say(\"Pronto\")}>Falar</button>\r\n *   </>\r\n * );\r\n * ```\r\n */\r\nfunction Say({\r\n  text,\r\n  onEnd,\r\n  onStart,\r\n  isSpeaking,\r\n  setIsSpeaking,\r\n  rate = DEFAULT_SAY_RATE,\r\n  voice = DEFAULT_SAY_VOICE,\r\n  pitch = DEFAULT_SAY_PITCH,\r\n  volume = DEFAULT_SAY_VOLUME,\r\n}: Readonly<SayProps>): React.ReactElement | null {\r\n  const { voices, ponyfill } = useSpeechPonyfill();\r\n\r\n  const handleEnd = useCallback(() => {\r\n    setIsSpeaking(false);\r\n    onEnd?.();\r\n  }, [setIsSpeaking, onEnd]);\r\n\r\n  if (!isSpeaking || voices.length === 0 || !ponyfill) return null;\r\n\r\n  return (\r\n    <SayEngine\r\n      text={text}\r\n      rate={rate}\r\n      pitch={pitch}\r\n      volume={volume}\r\n      onEnd={handleEnd}\r\n      onStart={onStart}\r\n      ponyfill={ponyfill}\r\n      voice={voices.find((v) => v.name === voice)}\r\n    />\r\n  );\r\n}\r\n\r\nexport default Say;\r\n"]}

package/dist/accessibility/index.mjs

@@ -0,0 +1,127 @@
+import { nvl } from '../chunk-BWW3F4R4.mjs';
+import SayEngine from 'react-say';
+import { useState, useCallback, useMemo, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/components/accessibility/say/utils/constants.ts
+var SPEECH_APIS = ["speechSynthesis", "SpeechSynthesisUtterance"];
+function hasSpeechSupport() {
+  return SPEECH_APIS.every((api) => api in globalThis);
+}
+function voicesAreEqual(current, next) {
+  if (current.length !== next.length) return false;
+  return current.every(
+    (v, i) => {
+      var _a, _b;
+      return v.name === ((_a = next[i]) == null ? void 0 : _a.name) && v.lang === ((_b = next[i]) == null ? void 0 : _b.lang);
+    }
+  );
+}
+function getSpeechSupport() {
+  if (!hasSpeechSupport()) return null;
+  return {
+    speechSynthesis: globalThis.speechSynthesis,
+    SpeechSynthesisUtterance: globalThis.SpeechSynthesisUtterance
+  };
+}
+var DEFAULT_SAY_VOICE = "Google portugu\xEAs do Brasil";
+var DEFAULT_SAY_RATE = 1.4;
+var DEFAULT_SAY_PITCH = 0.8;
+var DEFAULT_SAY_VOLUME = 1;
+var DEFAULT_SAY_NOTIFY_AUTO_CLOSE = 1500;
+var DEFAULT_SAY_VIBRATE_DURATION = 500;
+function defaultShouldVibrate(type) {
+  return !type || type === "warning";
+}
+function useSay({
+  onNotify,
+  defaultNotifyType = "success",
+  vibrateDuration = DEFAULT_SAY_VIBRATE_DURATION,
+  defaultNotifyAutoClose = DEFAULT_SAY_NOTIFY_AUTO_CLOSE,
+  shouldVibrate = defaultShouldVibrate
+} = {}) {
+  const [isSpeaking, setIsSpeaking] = useState(false);
+  const [textSpeaking, setTextSpeaking] = useState("");
+  const say = useCallback(
+    (text, options) => {
+      const type = options == null ? void 0 : options.type;
+      const notify = nvl(options == null ? void 0 : options.notify, true);
+      const vibrate = nvl(options == null ? void 0 : options.vibrate, true);
+      setIsSpeaking(true);
+      setTextSpeaking(text);
+      if (notify && type !== false && onNotify) {
+        onNotify(text, {
+          type: nvl(type, defaultNotifyType),
+          autoClose: nvl(options == null ? void 0 : options.autoClose, defaultNotifyAutoClose)
+        });
+      }
+      if (vibrate && shouldVibrate(type) && navigator.vibrate) {
+        navigator.vibrate(vibrateDuration);
+      }
+    },
+    [
+      onNotify,
+      shouldVibrate,
+      vibrateDuration,
+      defaultNotifyType,
+      defaultNotifyAutoClose
+    ]
+  );
+  return { say, isSpeaking, textSpeaking, setIsSpeaking };
+}
+function useSpeechPonyfill() {
+  const ponyfill = useMemo(() => getSpeechSupport(), []);
+  const [voices, setVoices] = useState([]);
+  useEffect(() => {
+    if (!hasSpeechSupport()) return;
+    const synthesis = globalThis.speechSynthesis;
+    const updateVoices = () => {
+      setVoices((current) => {
+        const next = synthesis.getVoices();
+        return voicesAreEqual(current, next) ? current : next;
+      });
+    };
+    synthesis.onvoiceschanged = updateVoices;
+    updateVoices();
+    return () => {
+      synthesis.onvoiceschanged = null;
+    };
+  }, []);
+  return { voices, ponyfill };
+}
+function Say({
+  text,
+  onEnd,
+  onStart,
+  isSpeaking,
+  setIsSpeaking,
+  rate = DEFAULT_SAY_RATE,
+  voice = DEFAULT_SAY_VOICE,
+  pitch = DEFAULT_SAY_PITCH,
+  volume = DEFAULT_SAY_VOLUME
+}) {
+  const { voices, ponyfill } = useSpeechPonyfill();
+  const handleEnd = useCallback(() => {
+    setIsSpeaking(false);
+    onEnd == null ? void 0 : onEnd();
+  }, [setIsSpeaking, onEnd]);
+  if (!isSpeaking || voices.length === 0 || !ponyfill) return null;
+  return /* @__PURE__ */ jsx(
+    SayEngine,
+    {
+      text,
+      rate,
+      pitch,
+      volume,
+      onEnd: handleEnd,
+      onStart,
+      ponyfill,
+      voice: voices.find((v) => v.name === voice)
+    }
+  );
+}
+var say_default = Say;
+
+export { say_default as Say, useSay };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/accessibility/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/accessibility/say/utils/constants.ts","../../src/components/accessibility/say/use-say.ts","../../src/components/accessibility/say/use-speech-ponyfill.ts","../../src/components/accessibility/say/index.tsx"],"names":["useState","useCallback"],"mappings":";;;;;;AAEO,IAAM,WAAA,GAAc,CAAC,iBAAA,EAAmB,0BAA0B,CAAA;AAElE,SAAS,gBAAA,GAA4B;AAC1C,EAAA,OAAO,WAAA,CAAY,KAAA,CAAM,CAAC,GAAA,KAAQ,OAAO,UAAU,CAAA;AACrD;AAEO,SAAS,cAAA,CACd,SACA,IAAA,EACS;AACT,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,IAAA,CAAK,MAAA,EAAQ,OAAO,KAAA;AAE3C,EAAA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACb,CAAC,GAAG,CAAA,KAAG;AAfX,MAAA,IAAA,EAAA,EAAA,EAAA;AAec,MAAA,OAAA,CAAA,CAAE,IAAA,MAAA,CAAS,EAAA,GAAA,IAAA,CAAK,CAAC,CAAA,KAAN,IAAA,GAAA,MAAA,GAAA,EAAA,CAAS,IAAA,CAAA,IAAQ,CAAA,CAAE,IAAA,MAAA,CAAS,EAAA,GAAA,IAAA,CAAK,CAAC,CAAA,KAAN,IAAA,GAAA,MAAA,GAAA,EAAA,CAAS,IAAA,CAAA;AAAA,IAAA;AAAA,GAC5D;AACF;AAEO,SAAS,gBAAA,GAA0C;AACxD,EAAA,IAAI,CAAC,gBAAA,EAAiB,EAAG,OAAO,IAAA;AAEhC,EAAA,OAAO;AAAA,IACL,iBAAiB,UAAA,CAAW,eAAA;AAAA,IAC5B,0BAA0B,UAAA,CAAW;AAAA,GACvC;AACF;AAEO,IAAM,iBAAA,GAAoB,+BAAA;AAC1B,IAAM,gBAAA,GAAmB,GAAA;AACzB,IAAM,iBAAA,GAAoB,GAAA;AAC1B,IAAM,kBAAA,GAAqB,CAAA;AAC3B,IAAM,6BAAA,GAAgC,IAAA;AACtC,IAAM,4BAAA,GAA+B,GAAA;AAErC,SAAS,qBACd,IAAA,EACS;AACT,EAAA,OAAO,CAAC,QAAQ,IAAA,KAAS,SAAA;AAC3B;ACNO,SAAS,MAAA,CAAO;AAAA,EACrB,QAAA;AAAA,EACA,iBAAA,GAAoB,SAAA;AAAA,EACpB,eAAA,GAAkB,4BAAA;AAAA,EAClB,sBAAA,GAAyB,6BAAA;AAAA,EACzB,aAAA,GAAgB;AAClB,CAAA,GAAmB,EAAC,EAAiB;AACnC,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAI,SAAS,KAAK,CAAA;AAClD,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAI,SAAS,EAAE,CAAA;AAEnD,EAAA,MAAM,GAAA,GAAM,WAAA;AAAA,IACV,CAAC,MAAc,OAAA,KAA6B;AAC1C,MAAA,MAAM,OAAO,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,IAAA;AACtB,MAAA,MAAM,MAAA,GAAS,GAAA,CAAI,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,MAAA,EAAQ,IAAI,CAAA;AACxC,MAAA,MAAM,OAAA,GAAU,GAAA,CAAI,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,OAAA,EAAS,IAAI,CAAA;AAE1C,MAAA,aAAA,CAAc,IAAI,CAAA;AAClB,MAAA,eAAA,CAAgB,IAAI,CAAA;AAEpB,MAAA,IAAI,MAAA,IAAU,IAAA,KAAS,KAAA,IAAS,QAAA,EAAU;AACxC,QAAA,QAAA,CAAS,IAAA,EAAM;AAAA,UACb,IAAA,EAAM,GAAA,CAAI,IAAA,EAAM,iBAAiB,CAAA;AAAA,UACjC,SAAA,EAAW,GAAA,CAAI,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAS,SAAA,EAAW,sBAAsB;AAAA,SAC1D,CAAA;AAAA,MACH;AAEA,MAAA,IAAI,OAAA,IAAW,aAAA,CAAc,IAAI,CAAA,IAAK,UAAU,OAAA,EAAS;AACvD,QAAA,SAAA,CAAU,QAAQ,eAAe,CAAA;AAAA,MACnC;AAAA,IACF,CAAA;AAAA,IACA;AAAA,MACE,QAAA;AAAA,MACA,aAAA;AAAA,MACA,eAAA;AAAA,MACA,iBAAA;AAAA,MACA;AAAA;AACF,GACF;AAEA,EAAA,OAAO,EAAE,GAAA,EAAK,UAAA,EAAY,YAAA,EAAc,aAAA,EAAc;AACxD;AClEO,SAAS,iBAAA,GAAoB;AAClC,EAAA,MAAM,WAAW,OAAA,CAAQ,MAAM,gBAAA,EAAiB,EAAG,EAAE,CAAA;AACrD,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAIA,QAAAA,CAAiC,EAAE,CAAA;AAE/D,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,kBAAiB,EAAG;AAEzB,IAAA,MAAM,YAAY,UAAA,CAAW,eAAA;AAE7B,IAAA,MAAM,eAAe,MAAM;AACzB,MAAA,SAAA,CAAU,CAAC,OAAA,KAAY;AACrB,QAAA,MAAM,IAAA,GAAO,UAAU,SAAA,EAAU;AACjC,QAAA,OAAO,cAAA,CAAe,OAAA,EAAS,IAAI,CAAA,GAAI,OAAA,GAAU,IAAA;AAAA,MACnD,CAAC,CAAA;AAAA,IACH,CAAA;AAEA,IAAA,SAAA,CAAU,eAAA,GAAkB,YAAA;AAC5B,IAAA,YAAA,EAAa;AAEb,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,CAAU,eAAA,GAAkB,IAAA;AAAA,IAC9B,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,EAAE,QAAQ,QAAA,EAAS;AAC5B;ACMA,SAAS,GAAA,CAAI;AAAA,EACX,IAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,aAAA;AAAA,EACA,IAAA,GAAO,gBAAA;AAAA,EACP,KAAA,GAAQ,iBAAA;AAAA,EACR,KAAA,GAAQ,iBAAA;AAAA,EACR,MAAA,GAAS;AACX,CAAA,EAAkD;AAChD,EAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAS,GAAI,iBAAA,EAAkB;AAE/C,EAAA,MAAM,SAAA,GAAYC,YAAY,MAAM;AAClC,IAAA,aAAA,CAAc,KAAK,CAAA;AACnB,IAAA,KAAA,IAAA,IAAA,GAAA,MAAA,GAAA,KAAA,EAAA;AAAA,EACF,CAAA,EAAG,CAAC,aAAA,EAAe,KAAK,CAAC,CAAA;AAEzB,EAAA,IAAI,CAAC,UAAA,IAAc,MAAA,CAAO,WAAW,CAAA,IAAK,CAAC,UAAU,OAAO,IAAA;AAE5D,EAAA,uBACE,GAAA;AAAA,IAAC,SAAA;AAAA,IAAA;AAAA,MACC,IAAA;AAAA,MACA,IAAA;AAAA,MACA,KAAA;AAAA,MACA,MAAA;AAAA,MACA,KAAA,EAAO,SAAA;AAAA,MACP,OAAA;AAAA,MACA,QAAA;AAAA,MACA,OAAO,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,KAAK;AAAA;AAAA,GAC5C;AAEJ;AAEA,IAAO,WAAA,GAAQ","file":"index.mjs","sourcesContent":["import type { SpeechPonyfill } from \"./interface\";\r\n\r\nexport const SPEECH_APIS = [\"speechSynthesis\", \"SpeechSynthesisUtterance\"];\r\n\r\nexport function hasSpeechSupport(): boolean {\r\n  return SPEECH_APIS.every((api) => api in globalThis);\r\n}\r\n\r\nexport function voicesAreEqual(\r\n  current: SpeechSynthesisVoice[],\r\n  next: SpeechSynthesisVoice[],\r\n): boolean {\r\n  if (current.length !== next.length) return false;\r\n\r\n  return current.every(\r\n    (v, i) => v.name === next[i]?.name && v.lang === next[i]?.lang,\r\n  );\r\n}\r\n\r\nexport function getSpeechSupport(): SpeechPonyfill | null {\r\n  if (!hasSpeechSupport()) return null;\r\n\r\n  return {\r\n    speechSynthesis: globalThis.speechSynthesis,\r\n    SpeechSynthesisUtterance: globalThis.SpeechSynthesisUtterance,\r\n  };\r\n}\r\n\r\nexport const DEFAULT_SAY_VOICE = \"Google português do Brasil\";\r\nexport const DEFAULT_SAY_RATE = 1.4;\r\nexport const DEFAULT_SAY_PITCH = 0.8;\r\nexport const DEFAULT_SAY_VOLUME = 1;\r\nexport const DEFAULT_SAY_NOTIFY_AUTO_CLOSE = 1500;\r\nexport const DEFAULT_SAY_VIBRATE_DURATION = 500;\r\n\r\nexport function defaultShouldVibrate(\r\n  type?: import(\"./interface\").SayFeedbackType | false,\r\n): boolean {\r\n  return !type || type === \"warning\";\r\n}\r\n\r\nconst sayConstants = `\r\nSintetiza texto em fala via Web Speech API (\\`react-say\\`), com hook \\`useSay\\` para notificação e vibração.\r\n\r\n**Importação:**\r\n\\`\\`\\`tsx\r\nimport { Say, useSay } from \"@grazziotin/react-components-next/accessibility\";\r\n\\`\\`\\`\r\n\r\n**Uso básico:**\r\n\\`\\`\\`tsx\r\nconst { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n  onNotify: (text, { type }) => toast(text, { type }),\r\n});\r\n\r\n<>\r\n  <Say\r\n    isSpeaking={isSpeaking}\r\n    text={textSpeaking}\r\n    setIsSpeaking={setIsSpeaking}\r\n  />\r\n  <button type=\"button\" onClick={() => say(\"Operação concluída\")}>\r\n    Falar\r\n  </button>\r\n</>\r\n\\`\\`\\`\r\n\r\nRequer suporte a \\`speechSynthesis\\` no navegador. A voz padrão é \\`Google português do Brasil\\`.\r\n`;\r\n\r\nexport default sayConstants;\r\n","import {\r\n  defaultShouldVibrate,\r\n  DEFAULT_SAY_NOTIFY_AUTO_CLOSE,\r\n  DEFAULT_SAY_VIBRATE_DURATION,\r\n} from \"./utils/constants\";\r\nimport type {\r\n  UseSayReturn,\r\n  UseSayOptions,\r\n  SayCallOptions,\r\n} from \"./utils/interface\";\r\nimport { nvl } from \"@/functions\";\r\nimport { useCallback, useState } from \"react\";\r\n\r\n/**\r\n * Hook para disparar fala, notificação e vibração de forma configurável.\r\n *\r\n * @example\r\n * ```tsx\r\n * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n *   onNotify: (text, { type }) => toast(text, { type }),\r\n * });\r\n *\r\n * <Say\r\n *   isSpeaking={isSpeaking}\r\n *   text={textSpeaking}\r\n *   setIsSpeaking={setIsSpeaking}\r\n * />\r\n *\r\n * <button type=\"button\" onClick={() => say(\"Operação concluída\")}>\r\n *   Falar\r\n * </button>\r\n * ```\r\n */\r\nexport function useSay({\r\n  onNotify,\r\n  defaultNotifyType = \"success\",\r\n  vibrateDuration = DEFAULT_SAY_VIBRATE_DURATION,\r\n  defaultNotifyAutoClose = DEFAULT_SAY_NOTIFY_AUTO_CLOSE,\r\n  shouldVibrate = defaultShouldVibrate,\r\n}: UseSayOptions = {}): UseSayReturn {\r\n  const [isSpeaking, setIsSpeaking] = useState(false);\r\n  const [textSpeaking, setTextSpeaking] = useState(\"\");\r\n\r\n  const say = useCallback(\r\n    (text: string, options?: SayCallOptions) => {\r\n      const type = options?.type;\r\n      const notify = nvl(options?.notify, true);\r\n      const vibrate = nvl(options?.vibrate, true);\r\n\r\n      setIsSpeaking(true);\r\n      setTextSpeaking(text);\r\n\r\n      if (notify && type !== false && onNotify) {\r\n        onNotify(text, {\r\n          type: nvl(type, defaultNotifyType),\r\n          autoClose: nvl(options?.autoClose, defaultNotifyAutoClose),\r\n        });\r\n      }\r\n\r\n      if (vibrate && shouldVibrate(type) && navigator.vibrate) {\r\n        navigator.vibrate(vibrateDuration);\r\n      }\r\n    },\r\n    [\r\n      onNotify,\r\n      shouldVibrate,\r\n      vibrateDuration,\r\n      defaultNotifyType,\r\n      defaultNotifyAutoClose,\r\n    ],\r\n  );\r\n\r\n  return { say, isSpeaking, textSpeaking, setIsSpeaking };\r\n}\r\n","import {\r\n  getSpeechSupport,\r\n  hasSpeechSupport,\r\n  voicesAreEqual,\r\n} from \"./utils/constants\";\r\nimport { useEffect, useMemo, useState } from \"react\";\r\n\r\nexport function useSpeechPonyfill() {\r\n  const ponyfill = useMemo(() => getSpeechSupport(), []);\r\n  const [voices, setVoices] = useState<SpeechSynthesisVoice[]>([]);\r\n\r\n  useEffect(() => {\r\n    if (!hasSpeechSupport()) return;\r\n\r\n    const synthesis = globalThis.speechSynthesis;\r\n\r\n    const updateVoices = () => {\r\n      setVoices((current) => {\r\n        const next = synthesis.getVoices();\r\n        return voicesAreEqual(current, next) ? current : next;\r\n      });\r\n    };\r\n\r\n    synthesis.onvoiceschanged = updateVoices;\r\n    updateVoices();\r\n\r\n    return () => {\r\n      synthesis.onvoiceschanged = null;\r\n    };\r\n  }, []);\r\n\r\n  return { voices, ponyfill };\r\n}\r\n","\"use client\";\r\n\r\nimport {\r\n  DEFAULT_SAY_PITCH,\r\n  DEFAULT_SAY_RATE,\r\n  DEFAULT_SAY_VOICE,\r\n  DEFAULT_SAY_VOLUME,\r\n} from \"./utils/constants\";\r\nimport SayEngine from \"react-say\";\r\nexport { useSay } from \"./use-say\";\r\nimport React, { useCallback } from \"react\";\r\nimport type { SayProps } from \"./utils/interface\";\r\nimport { useSpeechPonyfill } from \"./use-speech-ponyfill\";\r\n\r\n/**\r\n * Sintetiza texto em fala via Web Speech API (`react-say`).\r\n * Use com {@link useSay} para controlar `isSpeaking`, `text` e `setIsSpeaking`.\r\n *\r\n * @example\r\n * ```tsx\r\n * const { say, isSpeaking, textSpeaking, setIsSpeaking } = useSay({\r\n *   onNotify: (text, { type }) => toast(text, { type }),\r\n * });\r\n *\r\n * return (\r\n *   <>\r\n *     <Say\r\n *       isSpeaking={isSpeaking}\r\n *       text={textSpeaking}\r\n *       setIsSpeaking={setIsSpeaking}\r\n *       voice=\"Google português do Brasil\"\r\n *       rate={1.4}\r\n *     />\r\n *     <button type=\"button\" onClick={() => say(\"Pronto\")}>Falar</button>\r\n *   </>\r\n * );\r\n * ```\r\n */\r\nfunction Say({\r\n  text,\r\n  onEnd,\r\n  onStart,\r\n  isSpeaking,\r\n  setIsSpeaking,\r\n  rate = DEFAULT_SAY_RATE,\r\n  voice = DEFAULT_SAY_VOICE,\r\n  pitch = DEFAULT_SAY_PITCH,\r\n  volume = DEFAULT_SAY_VOLUME,\r\n}: Readonly<SayProps>): React.ReactElement | null {\r\n  const { voices, ponyfill } = useSpeechPonyfill();\r\n\r\n  const handleEnd = useCallback(() => {\r\n    setIsSpeaking(false);\r\n    onEnd?.();\r\n  }, [setIsSpeaking, onEnd]);\r\n\r\n  if (!isSpeaking || voices.length === 0 || !ponyfill) return null;\r\n\r\n  return (\r\n    <SayEngine\r\n      text={text}\r\n      rate={rate}\r\n      pitch={pitch}\r\n      volume={volume}\r\n      onEnd={handleEnd}\r\n      onStart={onStart}\r\n      ponyfill={ponyfill}\r\n      voice={voices.find((v) => v.name === voice)}\r\n    />\r\n  );\r\n}\r\n\r\nexport default Say;\r\n"]}

package/dist/{chunk-4DIPDYEU.mjs → chunk-BWW3F4R4.mjs}

@@ -45,6 +45,12 @@ function nvl(value, defaultValue) {
 function removeDigits(value) {
   return value.replace(/\D/g, "");
 }
+function removeNonDigits(value) {
+  return value.replaceAll(/\d/g, "");
+}
+function removeTextOnly(value) {
+  return value.replaceAll(/[^\p{L}]/gu, "");
+}
 
 // src/functions/format-cpf-cnpj/format-cpf-cnpj.ts
 function formatCpfCnpj(data) {
@@ -74,6 +80,39 @@ function formatPhoneBr(phone) {
   return digits.replace(/(\d{2})(\d{5})(\d+)/, "($1) $2-$3");
 }
 
-export { __objRest, __spreadProps, __spreadValues, cn, formatCpfCnpj, formatPhoneBr, nvl };
-//# sourceMappingURL=chunk-4DIPDYEU.mjs.map
-//# sourceMappingURL=chunk-4DIPDYEU.mjs.map
+// src/functions/format-price-brl/format-price-brl.ts
+function formatPriceBrl(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "string") {
+    const digits = removeDigits(value);
+    if (!digits) return "";
+    const price = Number(digits) / 100;
+    if (Number.isNaN(price)) return "";
+    return price.toLocaleString("pt-BR", {
+      style: "currency",
+      currency: "BRL"
+    });
+  }
+  if (Number.isNaN(value)) return "";
+  return value.toLocaleString("pt-BR", { style: "currency", currency: "BRL" });
+}
+
+// src/functions/format-item-170/format-item-170.ts
+function formatItem170(item) {
+  if (!item) return "";
+  const digits = removeDigits(item).slice(0, 12);
+  if (!digits) return "";
+  return digits.replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})\.(\d)(\d{1,3})$/, "$1.$2.$3");
+}
+
+// src/functions/format-item-150/format-item-150.ts
+function formatItem150(item) {
+  if (!item) return "";
+  const digits = removeDigits(item).slice(0, 10);
+  if (!digits) return "";
+  return digits.replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})(\d)/, "$1.$2").replace(/(\d{2})\.(\d)(\d{1,3})$/, "$1.$2.$3");
+}
+
+export { __objRest, __spreadProps, __spreadValues, cn, formatCpfCnpj, formatItem150, formatItem170, formatPhoneBr, formatPriceBrl, nvl, removeDigits, removeNonDigits, removeTextOnly };
+//# sourceMappingURL=chunk-BWW3F4R4.mjs.map
+//# sourceMappingURL=chunk-BWW3F4R4.mjs.map

package/dist/chunk-BWW3F4R4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/functions/cn/cn.ts","../src/functions/nvl/nvl.ts","../src/core/remove-digits.ts","../src/functions/format-cpf-cnpj/format-cpf-cnpj.ts","../src/functions/format-phone-br/format-phone-br.ts","../src/functions/format-price-brl/format-price-brl.ts","../src/functions/format-item-170/format-item-170.ts","../src/functions/format-item-150/format-item-150.ts"],"names":[],"mappings":"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","file":"chunk-BWW3F4R4.mjs","sourcesContent":["import { twMerge } from \"tailwind-merge\";\r\nimport { clsx } from \"clsx\";\r\nimport type { ClassValue } from \"./utils/interfaces\";\r\n\r\nexport function cn(...values: ClassValue[]): string {\r\n  return twMerge(clsx(values));\r\n}\r\n","/**\r\n * Função NVL (Null Value Logic) - retorna valor padrão se o valor for null/undefined\r\n * @param {T | null | undefined} value - Valor a ser verificado\r\n * @param {T} defaultValue - Valor padrão a ser retornado se value for null/undefined\r\n * @returns {T} Value se não for null/undefined, senão defaultValue\r\n * @template T - Tipo do valor\r\n * @example\r\n * nvl(null, 'padrão') // Retorna: 'padrão'\r\n * nvl('valor', 'padrão') // Retorna: 'valor'\r\n */\r\nexport function nvl<T>(value: T | null | undefined, defaultValue: T): T {\r\n  return value ?? defaultValue;\r\n}\r\n","/** Remove tudo que não for dígito. */\r\nexport function removeDigits(value: string): string {\r\n  return value.replace(/\\D/g, \"\");\r\n}\r\n\r\n/** Remove tudo que não for número. */\r\nexport function removeNonDigits(value: string) {\r\n  return value.replaceAll(/\\d/g, \"\");\r\n}\r\n\r\n/** Remove tudo que não for letra. */\r\nexport function removeTextOnly(value: string) {\r\n  return value.replaceAll(/[^\\p{L}]/gu, \"\");\r\n}\r\n","import { removeDigits } from \"../../core/remove-digits\";\r\n\r\n/**\r\n * Formata CPF (até 11 dígitos) ou CNPJ (12–14 dígitos) conforme o tamanho.\r\n * @param data - Valor com ou sem formatação\r\n * @returns CPF `000.000.000-00` ou CNPJ `00.000.000/0000-00`; string vazia se ausente\r\n * @example\r\n * formatCpfCnpj(\"12345678901\") // \"123.456.789-01\"\r\n * formatCpfCnpj(\"12345678000199\") // \"12.345.678/0001-99\"\r\n */\r\nexport function formatCpfCnpj(data?: string): string {\r\n  if (!data) return \"\";\r\n  const value = removeDigits(data);\r\n\r\n  if (!value) return \"\";\r\n  if (value.length <= 11) {\r\n    const cpf = value.slice(0, 11);\r\n    return cpf\r\n      .replace(/(\\d{3})(\\d)/, \"$1.$2\")\r\n      .replace(/(\\d{3})(\\d)/, \"$1.$2\")\r\n      .replace(/(\\d{3})(\\d{1,2})$/, \"$1-$2\");\r\n  }\r\n\r\n  const cnpj = value.slice(0, 14);\r\n  return cnpj\r\n    .replace(/^(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/^(\\d{2})\\.(\\d{3})(\\d)/, \"$1.$2.$3\")\r\n    .replace(/\\.(\\d{3})(\\d)/, \".$1/$2\")\r\n    .replace(/(\\d{4})(\\d)/, \"$1-$2\");\r\n}\r\n","import { removeDigits } from \"../../core/remove-digits\";\r\n\r\n/**\r\n * Formata telefone brasileiro (até 11 dígitos): fixo `(00) 0000-0000` ou celular `(00) 00000-0000`.\r\n * @param phone - Valor com ou sem formatação\r\n * @returns Telefone formatado ou string vazia se ausente\r\n * @example\r\n * formatPhoneBr(\"11987654321\") // \"(11) 98765-4321\"\r\n * formatPhoneBr(\"1133334444\") // \"(11) 3333-4444\"\r\n */\r\nexport function formatPhoneBr(phone?: string): string {\r\n  if (!phone) return \"\";\r\n  const digits = removeDigits(phone).slice(0, 11);\r\n\r\n  if (!digits) return \"\";\r\n  if (digits.length <= 2) return digits;\r\n  if (digits.length <= 6) {\r\n    return digits.replace(/(\\d{2})(\\d+)/, \"($1) $2\");\r\n  }\r\n  if (digits.length <= 10) {\r\n    return digits.replace(/(\\d{2})(\\d{4})(\\d+)/, \"($1) $2-$3\");\r\n  }\r\n  return digits.replace(/(\\d{2})(\\d{5})(\\d+)/, \"($1) $2-$3\");\r\n}\r\n","import { removeDigits } from \"../../core/remove-digits\";\r\n\r\n/**\r\n * Formata um valor como moeda brasileira (BRL).\r\n *\r\n * - **string** — máscara de input: remove não dígitos, divide por 100 (centavos)\r\n * - **number** — valor já em reais\r\n *\r\n * @param value - Valor digitado ou numérico em reais\r\n * @returns Valor formatado (ex.: `R$ 1.234,56`) ou string vazia se ausente\r\n * @example\r\n * formatPriceBrl(\"123456\") // \"R$ 1.234,56\" (input)\r\n * formatPriceBrl(1234.56) // \"R$ 1.234,56\" (número)\r\n * formatPriceBrl(0) // \"R$ 0,00\"\r\n */\r\nexport function formatPriceBrl(value?: string | number | null): string {\r\n  if (value === undefined || value === null) return \"\";\r\n\r\n  if (typeof value === \"string\") {\r\n    const digits = removeDigits(value);\r\n    if (!digits) return \"\";\r\n    const price = Number(digits) / 100;\r\n    if (Number.isNaN(price)) return \"\";\r\n    return price.toLocaleString(\"pt-BR\", {\r\n      style: \"currency\",\r\n      currency: \"BRL\",\r\n    });\r\n  }\r\n\r\n  if (Number.isNaN(value)) return \"\";\r\n  return value.toLocaleString(\"pt-BR\", { style: \"currency\", currency: \"BRL\" });\r\n}\r\n","import { removeDigits } from \"../../core/remove-digits\";\r\n\r\n/**\r\n * Formata máscara de item 170 (até 12 dígitos) no padrão `00.00.00.00.0.000`.\r\n * Remove caracteres não numéricos antes de formatar.\r\n * @param item - Valor com ou sem formatação\r\n * @returns Item formatado ou string vazia se ausente\r\n * @example\r\n * formatItem170(\"123456789012\") // \"12.34.56.78.9.012\"\r\n */\r\nexport function formatItem170(item?: string): string {\r\n  if (!item) return \"\";\r\n  const digits = removeDigits(item).slice(0, 12);\r\n  if (!digits) return \"\";\r\n\r\n  return digits\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})\\.(\\d)(\\d{1,3})$/, \"$1.$2.$3\");\r\n}\r\n","import { removeDigits } from \"../../core/remove-digits\";\r\n\r\n/**\r\n * Formata máscara de item 150 (até 10 dígitos) no padrão `00.00.00.0.000`.\r\n * Remove caracteres não numéricos antes de formatar.\r\n * @param item - Valor com ou sem formatação\r\n * @returns Item formatado ou string vazia se ausente\r\n * @example\r\n * formatItem150(\"1234567890\") // \"12.34.56.7.890\"\r\n */\r\nexport function formatItem150(item?: string): string {\r\n  if (!item) return \"\";\r\n  const digits = removeDigits(item).slice(0, 10);\r\n  if (!digits) return \"\";\r\n\r\n  return digits\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})(\\d)/, \"$1.$2\")\r\n    .replace(/(\\d{2})\\.(\\d)(\\d{1,3})$/, \"$1.$2.$3\");\r\n}\r\n"]}