@lucasbernardosn/react-utils 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Bernardo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/hooks/index.d.ts

@@ -0,0 +1,2 @@
+import { useCopyToClipboard } from "./use-copy-to-clipboard.js";
+export { useCopyToClipboard };

package/dist/hooks/index.js

@@ -0,0 +1,2 @@
+import { useCopyToClipboard } from "./use-copy-to-clipboard.js";
+export { useCopyToClipboard };

package/dist/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,26 @@
+//#region src/hooks/use-copy-to-clipboard.d.ts
+/** Texto atualmente copiado para a área de transferência, ou null se nenhum texto foi copiado. */
+type CopiedValue = string | null;
+/** Função que copia um texto para a área de transferência e retorna se a operação foi bem-sucedida. */
+type CopyFn = (text: string) => Promise<boolean>;
+/**
+ * Retorno do hook useCopyToClipboard.
+ */
+type UseCopyToClipboardReturn = {
+  /** Último texto copiado com sucesso para a área de transferência, ou null se ainda não houve cópia. */
+  copiedText: CopiedValue;
+  /** Função para copiar um texto para a área de transferência. */
+  copy: CopyFn;
+};
+/**
+ * Gerencia a cópia de texto para a área de transferência do navegador.
+ *
+ * Expõe o último texto copiado com sucesso e uma função de cópia que retorna
+ * um booleano indicando se a operação foi concluída. A função é segura para
+ * ambientes que não suportam a API Clipboard.
+ *
+ * @returns Objeto com o texto atualmente copiado e a função de cópia.
+ */
+export declare const useCopyToClipboard: () => UseCopyToClipboardReturn;
+//#endregion
+//# sourceMappingURL=use-copy-to-clipboard.d.ts.map

package/dist/hooks/use-copy-to-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copy-to-clipboard.d.ts","names":[],"sources":["../../src/hooks/use-copy-to-clipboard.ts"],"mappings":";;KAGK;;KAGA,UAAU,iBAAiB;;;;KAK3B;;EAEH,YAAY;;EAEZ,MAAM;;;;;;;;;;;qBAYK,0BAAyB"}

package/dist/hooks/use-copy-to-clipboard.js

@@ -0,0 +1,36 @@
+import { useCallback, useState } from "react";
+//#region src/hooks/use-copy-to-clipboard.ts
+/**
+* Gerencia a cópia de texto para a área de transferência do navegador.
+*
+* Expõe o último texto copiado com sucesso e uma função de cópia que retorna
+* um booleano indicando se a operação foi concluída. A função é segura para
+* ambientes que não suportam a API Clipboard.
+*
+* @returns Objeto com o texto atualmente copiado e a função de cópia.
+*/
+const useCopyToClipboard = () => {
+	const [copiedText, setCopiedText] = useState(null);
+	return {
+		copiedText,
+		copy: useCallback(async (text) => {
+			if (typeof navigator === "undefined" || !navigator.clipboard) {
+				console.warn("useCopyToClipboard: Clipboard not supported");
+				return false;
+			}
+			try {
+				await navigator.clipboard.writeText(text);
+				setCopiedText(text);
+				return true;
+			} catch (error) {
+				console.warn("useCopyToClipboard: Copy failed", error);
+				setCopiedText(null);
+				return false;
+			}
+		}, [])
+	};
+};
+//#endregion
+export { useCopyToClipboard };
+
+//# sourceMappingURL=use-copy-to-clipboard.js.map

package/dist/hooks/use-copy-to-clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copy-to-clipboard.js","names":[],"sources":["../../src/hooks/use-copy-to-clipboard.ts"],"sourcesContent":["import { useCallback, useState } from 'react';\n\n/** Texto atualmente copiado para a área de transferência, ou null se nenhum texto foi copiado. */\ntype CopiedValue = string | null;\n\n/** Função que copia um texto para a área de transferência e retorna se a operação foi bem-sucedida. */\ntype CopyFn = (text: string) => Promise<boolean>;\n\n/**\n * Retorno do hook useCopyToClipboard.\n */\ntype UseCopyToClipboardReturn = {\n  /** Último texto copiado com sucesso para a área de transferência, ou null se ainda não houve cópia. */\n  copiedText: CopiedValue;\n  /** Função para copiar um texto para a área de transferência. */\n  copy: CopyFn;\n};\n\n/**\n * Gerencia a cópia de texto para a área de transferência do navegador.\n *\n * Expõe o último texto copiado com sucesso e uma função de cópia que retorna\n * um booleano indicando se a operação foi concluída. A função é segura para\n * ambientes que não suportam a API Clipboard.\n *\n * @returns Objeto com o texto atualmente copiado e a função de cópia.\n */\nexport const useCopyToClipboard = (): UseCopyToClipboardReturn => {\n  const [copiedText, setCopiedText] = useState<CopiedValue>(null);\n\n  const copy: CopyFn = useCallback(async (text) => {\n    /*\n     * A API Clipboard pode não estar disponível em contextos sem HTTPS,\n     * em ambientes de teste ou em SSR (onde `navigator` nem existe) —\n     * verificar antes de usar é necessário.\n     */\n    if (typeof navigator === 'undefined' || !navigator.clipboard) {\n      console.warn('useCopyToClipboard: Clipboard not supported');\n      return false;\n    }\n\n    try {\n      await navigator.clipboard.writeText(text);\n      setCopiedText(text);\n      return true;\n    } catch (error) {\n      console.warn('useCopyToClipboard: Copy failed', error);\n      setCopiedText(null);\n      return false;\n    }\n  }, []);\n\n  return { copiedText, copy };\n};\n"],"mappings":";;;;;;;;;;;AA2BA,MAAa,2BAAqD;CAChE,MAAM,CAAC,YAAY,iBAAiB,SAAsB,IAAI;CAwB9D,OAAO;EAAE;EAAY,MAtBA,YAAY,OAAO,SAAS;GAM/C,IAAI,OAAO,cAAc,eAAe,CAAC,UAAU,WAAW;IAC5D,QAAQ,KAAK,6CAA6C;IAC1D,OAAO;GACT;GAEA,IAAI;IACF,MAAM,UAAU,UAAU,UAAU,IAAI;IACxC,cAAc,IAAI;IAClB,OAAO;GACT,SAAS,OAAO;IACd,QAAQ,KAAK,mCAAmC,KAAK;IACrD,cAAc,IAAI;IAClB,OAAO;GACT;EACF,GAAG,CAAC,CAEoB;CAAE;AAC5B"}

package/dist/hooks/use-media-query.d.ts

@@ -0,0 +1,24 @@
+//#region src/hooks/use-media-query.d.ts
+/**
+ * Configurações opcionais para controlar o comportamento inicial do hook useMediaQuery.
+ */
+type UseMediaQueryOptions = {
+  /** Valor padrão retornado quando `initializeWithValue` é false. */
+  defaultValue?: boolean;
+  /** Define se deve inicializar com o valor atual da media query. */
+  initializeWithValue?: boolean;
+};
+/**
+ * Monitora continuamente mudanças em media queries CSS, reagindo automaticamente
+ * a alterações no tamanho da viewport ou outras características do dispositivo.
+ *
+ * O hook gerencia automaticamente a adição e remoção de listeners, prevenindo
+ * vazamentos de memória quando o componente é desmontado.
+ *
+ * @param query - String da media query CSS a ser monitorada (ex: `"(min-width: 768px)"`).
+ * @param options - Configurações opcionais para controlar o comportamento inicial do hook.
+ * @returns Verdadeiro quando a media query atual corresponde à condição especificada, falso caso contrário.
+ */
+export declare const useMediaQuery: (query: string, options?: UseMediaQueryOptions) => boolean;
+//#endregion
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/hooks/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","names":[],"sources":["../../src/hooks/use-media-query.ts"],"mappings":";;;;KAKK;;EAEH;;EAEA;;;;;;;;;;;;;qBAcW,gBACX,eACA,UAAS"}

package/dist/hooks/use-media-query.js

@@ -0,0 +1,41 @@
+import { useCallback, useLayoutEffect, useState } from "react";
+//#region src/hooks/use-media-query.ts
+/**
+* Monitora continuamente mudanças em media queries CSS, reagindo automaticamente
+* a alterações no tamanho da viewport ou outras características do dispositivo.
+*
+* O hook gerencia automaticamente a adição e remoção de listeners, prevenindo
+* vazamentos de memória quando o componente é desmontado.
+*
+* @param query - String da media query CSS a ser monitorada (ex: `"(min-width: 768px)"`).
+* @param options - Configurações opcionais para controlar o comportamento inicial do hook.
+* @returns Verdadeiro quando a media query atual corresponde à condição especificada, falso caso contrário.
+*/
+const useMediaQuery = (query, options = {}) => {
+	const { defaultValue = false, initializeWithValue = true } = options;
+	const getMatches = useCallback((query) => {
+		return window.matchMedia(query).matches;
+	}, []);
+	const [matches, setMatches] = useState(() => {
+		if (initializeWithValue) return getMatches(query);
+		return defaultValue;
+	});
+	const handleChange = useCallback(() => {
+		setMatches(getMatches(query));
+	}, [query, getMatches]);
+	useLayoutEffect(() => {
+		const matchMedia = window.matchMedia(query);
+		handleChange();
+		if (matchMedia.addListener) matchMedia.addListener(handleChange);
+		else matchMedia.addEventListener("change", handleChange);
+		return () => {
+			if (matchMedia.removeListener) matchMedia.removeListener(handleChange);
+			else matchMedia.removeEventListener("change", handleChange);
+		};
+	}, [query, handleChange]);
+	return matches;
+};
+//#endregion
+export { useMediaQuery };
+
+//# sourceMappingURL=use-media-query.js.map

package/dist/hooks/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.js","names":[],"sources":["../../src/hooks/use-media-query.ts"],"sourcesContent":["import { useCallback, useLayoutEffect, useState } from 'react';\n\n/**\n * Configurações opcionais para controlar o comportamento inicial do hook useMediaQuery.\n */\ntype UseMediaQueryOptions = {\n  /** Valor padrão retornado quando `initializeWithValue` é false. */\n  defaultValue?: boolean;\n  /** Define se deve inicializar com o valor atual da media query. */\n  initializeWithValue?: boolean;\n};\n\n/**\n * Monitora continuamente mudanças em media queries CSS, reagindo automaticamente\n * a alterações no tamanho da viewport ou outras características do dispositivo.\n *\n * O hook gerencia automaticamente a adição e remoção de listeners, prevenindo\n * vazamentos de memória quando o componente é desmontado.\n *\n * @param query - String da media query CSS a ser monitorada (ex: `\"(min-width: 768px)\"`).\n * @param options - Configurações opcionais para controlar o comportamento inicial do hook.\n * @returns Verdadeiro quando a media query atual corresponde à condição especificada, falso caso contrário.\n */\nexport const useMediaQuery = (\n  query: string,\n  options: UseMediaQueryOptions = {},\n): boolean => {\n  const { defaultValue = false, initializeWithValue = true } = options;\n\n  const getMatches = useCallback((query: string): boolean => {\n    return window.matchMedia(query).matches;\n  }, []);\n\n  const [matches, setMatches] = useState<boolean>(() => {\n    if (initializeWithValue) {\n      return getMatches(query);\n    }\n\n    return defaultValue;\n  });\n\n  const handleChange = useCallback(() => {\n    setMatches(getMatches(query));\n  }, [query, getMatches]);\n\n  useLayoutEffect(() => {\n    const matchMedia = window.matchMedia(query);\n\n    handleChange();\n\n    /*\n     * Safari < 14 não suporta `addEventListener` em MediaQueryList —\n     * usa os métodos deprecated `addListener`/`removeListener` como fallback.\n     */\n    if (matchMedia.addListener) {\n      matchMedia.addListener(handleChange);\n    } else {\n      matchMedia.addEventListener('change', handleChange);\n    }\n\n    return () => {\n      if (matchMedia.removeListener) {\n        matchMedia.removeListener(handleChange);\n      } else {\n        matchMedia.removeEventListener('change', handleChange);\n      }\n    };\n  }, [query, handleChange]);\n\n  return matches;\n};\n"],"mappings":";;;;;;;;;;;;;AAuBA,MAAa,iBACX,OACA,UAAgC,CAAC,MACrB;CACZ,MAAM,EAAE,eAAe,OAAO,sBAAsB,SAAS;CAE7D,MAAM,aAAa,aAAa,UAA2B;EACzD,OAAO,OAAO,WAAW,KAAK,CAAC,CAAC;CAClC,GAAG,CAAC,CAAC;CAEL,MAAM,CAAC,SAAS,cAAc,eAAwB;EACpD,IAAI,qBACF,OAAO,WAAW,KAAK;EAGzB,OAAO;CACT,CAAC;CAED,MAAM,eAAe,kBAAkB;EACrC,WAAW,WAAW,KAAK,CAAC;CAC9B,GAAG,CAAC,OAAO,UAAU,CAAC;CAEtB,sBAAsB;EACpB,MAAM,aAAa,OAAO,WAAW,KAAK;EAE1C,aAAa;EAMb,IAAI,WAAW,aACb,WAAW,YAAY,YAAY;OAEnC,WAAW,iBAAiB,UAAU,YAAY;EAGpD,aAAa;GACX,IAAI,WAAW,gBACb,WAAW,eAAe,YAAY;QAEtC,WAAW,oBAAoB,UAAU,YAAY;EAEzD;CACF,GAAG,CAAC,OAAO,YAAY,CAAC;CAExB,OAAO;AACT"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { useCopyToClipboard } from "./hooks/use-copy-to-clipboard.js";
+import { CreateContextOptions, CreateContextReturn, createContext } from "./utils/create-context.js";
+import { mergeRefs } from "./utils/merge-refs.js";
+import "./utils/index.js";
+export { CreateContextOptions, CreateContextReturn, createContext, mergeRefs, useCopyToClipboard };

package/dist/index.js

@@ -0,0 +1,4 @@
+import { useCopyToClipboard } from "./hooks/use-copy-to-clipboard.js";
+import { createContext } from "./utils/create-context.js";
+import { mergeRefs } from "./utils/merge-refs.js";
+export { createContext, mergeRefs, useCopyToClipboard };

package/dist/utils/create-context.d.ts

@@ -0,0 +1,59 @@
+import React from "react";
+//#region src/utils/create-context.d.ts
+/**
+ * Opções do `createContext`.
+ */
+export type CreateContextOptions = {
+  /**
+   * Nome exibido no React DevTools e na mensagem de erro.
+   *
+   * @example 'TabsContext'
+   */
+  name: string;
+  /**
+   * Componentes públicos que fornecem o contexto, citados na mensagem de erro.
+   *
+   * Na lib, o Provider é interno: quem é de fora fornece o contexto pelo
+   * `Root` ou pelo `RootProvider`, então são esses nomes que entram aqui. Em
+   * contexto de app, em que o Provider é a própria API pública, entra ele.
+   *
+   * @example ['Splitter.Root', 'Splitter.RootProvider']
+   */
+  providers: [string, ...string[]];
+};
+/**
+ * Retorno do `createContext`: o Provider e o hook que lê o valor dele.
+ *
+ * O Provider é tipado como `React.Provider` (e não `React.Context`) para que o
+ * valor só seja lido pelo hook: `use(Provider)` não compila.
+ *
+ * @template TValue - Tipo do valor armazenado no contexto.
+ */
+export type CreateContextReturn<TValue> = [provider: React.Provider<TValue>, useContext: () => TValue];
+/**
+ * Cria um contexto estrito: o hook lança `ContextError` quando chamado fora do
+ * Provider.
+ *
+ * Os nomes do Provider e do hook são escolhidos na desestruturação. Convenção:
+ * `XContextProvider` e `useXContext`.
+ *
+ * @template TValue - Tipo do valor armazenado no contexto.
+ * @param options - Nome do contexto e do componente que o provê.
+ * @returns Tupla com o Provider e o hook.
+ *
+ * @example
+ * ```tsx
+ * export const [SplitterContextProvider, useSplitterContext] =
+ *   createContext<UseSplitterContext>({
+ *     name: 'SplitterContext',
+ *     providers: ['Splitter.Root', 'Splitter.RootProvider'],
+ *   });
+ *
+ * <SplitterContextProvider value={splitter}>{children}</SplitterContextProvider>;
+ *
+ * const splitter = useSplitterContext();
+ * ```
+ */
+export declare const createContext: <TValue>(options: CreateContextOptions) => CreateContextReturn<TValue>;
+//#endregion
+//# sourceMappingURL=create-context.d.ts.map

package/dist/utils/create-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context.d.ts","names":[],"sources":["../../src/utils/create-context.ts"],"mappings":";;;;;YAaY;;;;;;EAMV;;;;;;;;;;EAUA;;;;;;;;;;YA0BU,oBAAoB,WAC9B,UAAU,MAAM,SAAS,SACzB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;qBA2BP,gBAAiB,QAC5B,SAAS,yBACR,oBAAoB"}

package/dist/utils/create-context.js

@@ -0,0 +1,57 @@
+import { createContext as createContext$1, use } from "react";
+//#region src/utils/create-context.ts
+/**
+* Valor default de todo contexto criado aqui: só é lido quando não há Provider
+* acima. Como é um símbolo privado, nenhum valor legítimo (`0`, `false`, `''`,
+* `undefined`) se confunde com ele.
+*/
+const MISSING_PROVIDER = Symbol("MissingProvider");
+/**
+* Junta os nomes com vírgula e "ou" antes do último, cada um entre crases.
+*/
+const providersListFormat = new Intl.ListFormat("pt-BR", { type: "disjunction" });
+/**
+* Cria um contexto estrito: o hook lança `ContextError` quando chamado fora do
+* Provider.
+*
+* Os nomes do Provider e do hook são escolhidos na desestruturação. Convenção:
+* `XContextProvider` e `useXContext`.
+*
+* @template TValue - Tipo do valor armazenado no contexto.
+* @param options - Nome do contexto e do componente que o provê.
+* @returns Tupla com o Provider e o hook.
+*
+* @example
+* ```tsx
+* export const [SplitterContextProvider, useSplitterContext] =
+*   createContext<UseSplitterContext>({
+*     name: 'SplitterContext',
+*     providers: ['Splitter.Root', 'Splitter.RootProvider'],
+*   });
+*
+* <SplitterContextProvider value={splitter}>{children}</SplitterContextProvider>;
+*
+* const splitter = useSplitterContext();
+* ```
+*/
+const createContext = (options) => {
+	const { name, providers } = options;
+	const errorMessage = `\`${name}\` não encontrado: o componente precisa estar dentro de ${providersListFormat.format(providers.map((provider) => `\`${provider}\``))}.`;
+	const Context = createContext$1(MISSING_PROVIDER);
+	Context.displayName = name;
+	const useContext = () => {
+		const value = use(Context);
+		if (value === MISSING_PROVIDER) {
+			const error = new Error(errorMessage);
+			error.name = "ContextError";
+			Error.captureStackTrace?.(error, useContext);
+			throw error;
+		}
+		return value;
+	};
+	return [Context, useContext];
+};
+//#endregion
+export { createContext };
+
+//# sourceMappingURL=create-context.js.map

package/dist/utils/create-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context.js","names":["createReactContext"],"sources":["../../src/utils/create-context.ts"],"sourcesContent":["import type React from 'react';\nimport { createContext as createReactContext, use } from 'react';\n\n/**\n * Valor default de todo contexto criado aqui: só é lido quando não há Provider\n * acima. Como é um símbolo privado, nenhum valor legítimo (`0`, `false`, `''`,\n * `undefined`) se confunde com ele.\n */\nconst MISSING_PROVIDER: unique symbol = Symbol('MissingProvider');\n\n/**\n * Opções do `createContext`.\n */\nexport type CreateContextOptions = {\n  /**\n   * Nome exibido no React DevTools e na mensagem de erro.\n   *\n   * @example 'TabsContext'\n   */\n  name: string;\n  /**\n   * Componentes públicos que fornecem o contexto, citados na mensagem de erro.\n   *\n   * Na lib, o Provider é interno: quem é de fora fornece o contexto pelo\n   * `Root` ou pelo `RootProvider`, então são esses nomes que entram aqui. Em\n   * contexto de app, em que o Provider é a própria API pública, entra ele.\n   *\n   * @example ['Splitter.Root', 'Splitter.RootProvider']\n   */\n  providers: [string, ...string[]];\n};\n\n/**\n * `Error.captureStackTrace` é exclusivo do V8 e fica fora dos tipos da lib\n * padrão do TypeScript.\n */\ntype V8ErrorConstructor = ErrorConstructor & {\n  captureStackTrace?: (target: object, constructorOpt?: () => unknown) => void;\n};\n\n/**\n * Junta os nomes com vírgula e \"ou\" antes do último, cada um entre crases.\n */\nconst providersListFormat = new Intl.ListFormat('pt-BR', {\n  type: 'disjunction',\n});\n\n/**\n * Retorno do `createContext`: o Provider e o hook que lê o valor dele.\n *\n * O Provider é tipado como `React.Provider` (e não `React.Context`) para que o\n * valor só seja lido pelo hook: `use(Provider)` não compila.\n *\n * @template TValue - Tipo do valor armazenado no contexto.\n */\nexport type CreateContextReturn<TValue> = [\n  provider: React.Provider<TValue>,\n  useContext: () => TValue,\n];\n\n/**\n * Cria um contexto estrito: o hook lança `ContextError` quando chamado fora do\n * Provider.\n *\n * Os nomes do Provider e do hook são escolhidos na desestruturação. Convenção:\n * `XContextProvider` e `useXContext`.\n *\n * @template TValue - Tipo do valor armazenado no contexto.\n * @param options - Nome do contexto e do componente que o provê.\n * @returns Tupla com o Provider e o hook.\n *\n * @example\n * ```tsx\n * export const [SplitterContextProvider, useSplitterContext] =\n *   createContext<UseSplitterContext>({\n *     name: 'SplitterContext',\n *     providers: ['Splitter.Root', 'Splitter.RootProvider'],\n *   });\n *\n * <SplitterContextProvider value={splitter}>{children}</SplitterContextProvider>;\n *\n * const splitter = useSplitterContext();\n * ```\n */\nexport const createContext = <TValue>(\n  options: CreateContextOptions,\n): CreateContextReturn<TValue> => {\n  const { name, providers } = options;\n\n  const errorMessage = `\\`${name}\\` não encontrado: o componente precisa estar dentro de ${providersListFormat.format(\n    providers.map((provider) => `\\`${provider}\\``),\n  )}.`;\n\n  const Context = createReactContext<TValue | typeof MISSING_PROVIDER>(\n    MISSING_PROVIDER,\n  );\n\n  Context.displayName = name;\n\n  const useContext = (): TValue => {\n    const value = use(Context);\n\n    if (value === MISSING_PROVIDER) {\n      const error = new Error(errorMessage);\n\n      error.name = 'ContextError';\n\n      // Tira o hook do stack: a primeira linha passa a ser o componente que o\n      // chamou. Só existe em engines V8; nas outras, o stack fica completo.\n      (Error as V8ErrorConstructor).captureStackTrace?.(error, useContext);\n\n      throw error;\n    }\n\n    return value;\n  };\n\n  return [Context, useContext];\n};\n"],"mappings":";;;;;;;AAQA,MAAM,mBAAkC,OAAO,iBAAiB;;;;AAmChE,MAAM,sBAAsB,IAAI,KAAK,WAAW,SAAS,EACvD,MAAM,cACR,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AAuCD,MAAa,iBACX,YACgC;CAChC,MAAM,EAAE,MAAM,cAAc;CAE5B,MAAM,eAAe,KAAK,KAAK,0DAA0D,oBAAoB,OAC3G,UAAU,KAAK,aAAa,KAAK,SAAS,GAAG,CAC/C,EAAE;CAEF,MAAM,UAAUA,gBACd,gBACF;CAEA,QAAQ,cAAc;CAEtB,MAAM,mBAA2B;EAC/B,MAAM,QAAQ,IAAI,OAAO;EAEzB,IAAI,UAAU,kBAAkB;GAC9B,MAAM,QAAQ,IAAI,MAAM,YAAY;GAEpC,MAAM,OAAO;GAIb,MAA8B,oBAAoB,OAAO,UAAU;GAEnE,MAAM;EACR;EAEA,OAAO;CACT;CAEA,OAAO,CAAC,SAAS,UAAU;AAC7B"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+import { CreateContextOptions, CreateContextReturn, createContext } from "./create-context.js";
+import { mergeRefs } from "./merge-refs.js";
+export { CreateContextOptions, CreateContextReturn, createContext, mergeRefs };

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+import { createContext } from "./create-context.js";
+import { mergeRefs } from "./merge-refs.js";
+export { createContext, mergeRefs };

package/dist/utils/merge-refs.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+//#region src/utils/merge-refs.d.ts
+/**
+ * Combina múltiplas refs em uma única ref callback.
+ *
+ * Refs `undefined`/`null` são ignoradas silenciosamente. Útil para expor um
+ * elemento tanto para uma ref interna quanto para uma ref encaminhada
+ * (`forwardRef`) simultaneamente.
+ *
+ * @template T - Tipo do valor referenciado (ex: elemento DOM ou instância).
+ * @param refs - Lista de refs (callback, RefObject, `undefined` ou `null`) a serem combinadas.
+ * @returns Ref callback única que propaga o node para todas as refs recebidas.
+ */
+export declare function mergeRefs<T>(...refs: (React.Ref<T> | undefined)[]): React.RefCallback<T>;
+//#endregion
+//# sourceMappingURL=merge-refs.d.ts.map

package/dist/utils/merge-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-refs.d.ts","names":[],"sources":["../../src/utils/merge-refs.ts"],"mappings":";;;;;;;;;;;;;wBAgCgB,UAAU,MACrB,OAAO,MAAM,IAAI,oBACnB,MAAM,YAAY"}

package/dist/utils/merge-refs.js

@@ -0,0 +1,36 @@
+//#region src/utils/merge-refs.ts
+/**
+* Atribui `value` a uma ref, normalizando callback refs e RefObjects.
+*
+* Necessário porque o React expõe dois formatos de ref e não há uma API
+* unificada para escrevê-los — esta função esconde esse detalhe dos
+* consumidores.
+*
+* @template T - Tipo do valor referenciado (ex: elemento DOM ou instância).
+* @param ref - Ref callback, RefObject ou `undefined`/`null` (ignorada).
+* @param value - Valor a ser atribuído à ref.
+*/
+function setRef(ref, value) {
+	if (typeof ref === "function") ref(value);
+	else if (ref != null) ref.current = value;
+}
+/**
+* Combina múltiplas refs em uma única ref callback.
+*
+* Refs `undefined`/`null` são ignoradas silenciosamente. Útil para expor um
+* elemento tanto para uma ref interna quanto para uma ref encaminhada
+* (`forwardRef`) simultaneamente.
+*
+* @template T - Tipo do valor referenciado (ex: elemento DOM ou instância).
+* @param refs - Lista de refs (callback, RefObject, `undefined` ou `null`) a serem combinadas.
+* @returns Ref callback única que propaga o node para todas as refs recebidas.
+*/
+function mergeRefs(...refs) {
+	return (node) => {
+		for (const ref of refs) setRef(ref, node);
+	};
+}
+//#endregion
+export { mergeRefs };
+
+//# sourceMappingURL=merge-refs.js.map

package/dist/utils/merge-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-refs.js","names":[],"sources":["../../src/utils/merge-refs.ts"],"sourcesContent":["import type React from 'react';\n\n/**\n * Atribui `value` a uma ref, normalizando callback refs e RefObjects.\n *\n * Necessário porque o React expõe dois formatos de ref e não há uma API\n * unificada para escrevê-los — esta função esconde esse detalhe dos\n * consumidores.\n *\n * @template T - Tipo do valor referenciado (ex: elemento DOM ou instância).\n * @param ref - Ref callback, RefObject ou `undefined`/`null` (ignorada).\n * @param value - Valor a ser atribuído à ref.\n */\nfunction setRef<T>(ref: React.Ref<T> | undefined, value: T | null): void {\n  if (typeof ref === 'function') {\n    (ref as React.RefCallback<T>)(value);\n  } else if (ref != null) {\n    (ref as React.RefObject<T | null>).current = value;\n  }\n}\n\n/**\n * Combina múltiplas refs em uma única ref callback.\n *\n * Refs `undefined`/`null` são ignoradas silenciosamente. Útil para expor um\n * elemento tanto para uma ref interna quanto para uma ref encaminhada\n * (`forwardRef`) simultaneamente.\n *\n * @template T - Tipo do valor referenciado (ex: elemento DOM ou instância).\n * @param refs - Lista de refs (callback, RefObject, `undefined` ou `null`) a serem combinadas.\n * @returns Ref callback única que propaga o node para todas as refs recebidas.\n */\nexport function mergeRefs<T>(\n  ...refs: (React.Ref<T> | undefined)[]\n): React.RefCallback<T> {\n  return (node: T | null) => {\n    for (const ref of refs) {\n      setRef(ref, node);\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAS,OAAU,KAA+B,OAAuB;CACvE,IAAI,OAAO,QAAQ,YACjB,IAA8B,KAAK;MAC9B,IAAI,OAAO,MAChB,IAAmC,UAAU;AAEjD;;;;;;;;;;;;AAaA,SAAgB,UACd,GAAG,MACmB;CACtB,QAAQ,SAAmB;EACzB,KAAK,MAAM,OAAO,MAChB,OAAO,KAAK,IAAI;CAEpB;AACF"}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@lucasbernardosn/react-utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "React hooks and utilities.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@lucasbernardosn/tsconfig": "1.0.0",
+    "@testing-library/jest-dom": "7.0.1",
+    "@testing-library/react": "16.3.3",
+    "@testing-library/user-event": "14.6.7",
+    "@types/node": "26.6.3",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@vitejs/plugin-react": "6.1.1",
+    "jsdom": "30.1.1",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsdown": "0.23.0",
+    "typescript": "6.0.3",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LucasBernardoSN/react-monorepo.git",
+    "directory": "packages/react/utils"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:report": "tsdown --report",
+    "lint": "biome lint --write",
+    "format": "biome format --write",
+    "check": "biome check --write",
+    "test": "vitest",
+    "test:run": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.