@stackcraftmx/calcita 0.23.0 → 0.26.0

package/dist/toolkit/ToolkitProvider.js

@@ -1,45 +1,53 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
-import { useMemo } from "react";
+import { useContext, useMemo } from "react";
 import { allowOnlyUnrestricted } from "../access/accessRules.js";
 import { browserNavigation } from "./browserNavigation.js";
 import { ToolkitContext } from "./toolkitContext.js";
 import { useFontSize } from "../ui/navigation/useFontSize.js";
-import { DEFAULT_CURRENCY, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit } from "./toolkitSettings.js";
+import { DEFAULT_CURRENCY, DEFAULT_LANGUAGES, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit } from "./toolkitSettings.js";
 const ToolkitProvider = ({
-  language = DEFAULT_LANGUAGE,
+  language,
+  languages,
   onLanguageChange,
   texts,
   translate,
   timeZone,
-  currency = DEFAULT_CURRENCY,
-  appName = "",
-  navigation = browserNavigation,
-  buildId = "",
-  canAccess = allowOnlyUnrestricted,
+  currency,
+  appName,
+  navigation,
+  buildId,
+  canAccess,
+  fileTypes,
   children
 }) => {
+  const parent = useContext(ToolkitContext);
   const settings = useMemo(() => ({
-    language,
-    onLanguageChange: onLanguageChange ?? null,
-    texts: texts ?? {},
-    translate: translate ?? null,
-    timeZone: timeZone ?? browserTimeZone(),
-    currency,
-    appName,
-    navigation,
-    buildId,
-    canAccess
-  }), [language, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess]);
-  configureToolkit({
-    language: settings.language,
-    texts: settings.texts,
-    translate: settings.translate,
-    timeZone: settings.timeZone,
-    currency,
-    appName,
-    buildId
-  });
+    language: language ?? parent?.language ?? DEFAULT_LANGUAGE,
+    languages: languages ?? parent?.languages ?? DEFAULT_LANGUAGES,
+    onLanguageChange: onLanguageChange ?? parent?.onLanguageChange ?? null,
+    texts: texts ?? parent?.texts ?? {},
+    translate: translate ?? parent?.translate ?? null,
+    timeZone: timeZone ?? parent?.timeZone ?? browserTimeZone(),
+    currency: currency ?? parent?.currency ?? DEFAULT_CURRENCY,
+    appName: appName ?? parent?.appName ?? "",
+    navigation: navigation ?? parent?.navigation ?? browserNavigation,
+    buildId: buildId ?? parent?.buildId ?? "",
+    canAccess: canAccess ?? parent?.canAccess ?? allowOnlyUnrestricted,
+    fileTypes: fileTypes ?? parent?.fileTypes ?? null
+  }), [parent, language, languages, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess, fileTypes]);
+  if (!parent) {
+    configureToolkit({
+      language: settings.language,
+      texts: settings.texts,
+      translate: settings.translate,
+      timeZone: settings.timeZone,
+      currency: settings.currency,
+      appName: settings.appName,
+      buildId: settings.buildId,
+      languages: settings.languages
+    });
+  }
   useFontSize();
   return /* @__PURE__ */ jsx(ToolkitContext.Provider, { value: settings, children });
 };

package/dist/toolkit/ToolkitProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolkitProvider.js","sources":["../../src/toolkit/ToolkitProvider.jsx"],"sourcesContent":["// El proveedor del paquete: el único lugar donde cada aplicación conecta su idioma, sus textos, su zona horaria y su\n// router. Va por encima de la aplicación, dentro del ThemeProvider de MUI (el tema lo arma cada proyecto; sin tema,\n// los componentes usan los colores por omisión de MUI).\n//\n//   <ToolkitProvider language=\"es\" navigation={reactRouterNavigation} texts={{es: {common: {actions: {back: 'Volver'}}}}}>\n//\n// Sin proveedor todo funciona en español, con la zona del navegador y la navegación del navegador.\n//\n// Lo renderiza la app: arrow (regla de la casa).\nimport {useMemo} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {ToolkitContext} from '@/toolkit/toolkitContext.js';\nimport {useFontSize} from '@/ui/navigation/useFontSize.js';\nimport {DEFAULT_CURRENCY, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit} from '@/toolkit/toolkitSettings.js';\n\n/**\n * @param {object} props\n * @param {string} [props.language] idioma activo: es o en (por omisión es)\n * @param {(language: string) => void} [props.onLanguageChange] lo llama LanguageToggle; el proyecto cambia su idioma\n * @param {object} [props.texts] textos propios por idioma, con la forma de locales/ ({es: {table: {...}}})\n * @param {(namespace: string, key: string, values?: object) => string|undefined} [props.translate] traductor del\n *     proyecto (por ejemplo i18next); undefined deja el texto del paquete\n * @param {string} [props.timeZone] zona de las fechas (por omisión la del navegador)\n * @param {string} [props.currency] moneda de los montos, código ISO 4217 (por omisión MXN)\n * @param {string} [props.appName] nombre de la aplicación para el título de la pestaña\n * @param {object} [props.navigation] {useNavigate, useLocation, Link}; por omisión la del navegador\n * @param {string} [props.buildId] la compilación del front que corre en esta pestaña; con ella NewBuildNotice sabe si el\n *     servidor ya publicó otra (reportPublishedBuild). Vacía (en desarrollo) nunca avisa\n * @param {(access: object|undefined|null) => boolean} [props.canAccess] quién ve qué (menú, rutas, botones): la regla del\n *     proyecto, normalmente createAccessChecker({abilities, roles, policies, context}). Sin ella solo se ve lo que no\n *     tiene regla\n * @param {import('react').ReactNode} props.children\n */\nexport const ToolkitProvider = ({\n    language = DEFAULT_LANGUAGE, onLanguageChange, texts, translate, timeZone, currency = DEFAULT_CURRENCY, appName = '',\n    navigation = browserNavigation, buildId = '', canAccess = allowOnlyUnrestricted, children,\n}) => {\n    const settings = useMemo(() => ({\n        language,\n        onLanguageChange: onLanguageChange ?? null,\n        texts: texts ?? {},\n        translate: translate ?? null,\n        timeZone: timeZone ?? browserTimeZone(),\n        currency,\n        appName,\n        navigation,\n        buildId,\n        canAccess,\n    }), [language, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess]);\n\n    // OJO: se configura durante el render (no en un efecto) para que los formatos y avisos que se llaman en este mismo\n    // render ya vean el idioma y la zona nuevos\n    configureToolkit({\n        language: settings.language, texts: settings.texts, translate: settings.translate, timeZone: settings.timeZone, currency, appName,\n        buildId,\n    });\n\n    // el tamaño de letra que la persona guardó: se aplica aquí, que siempre está montado. Antes lo aplicaba su botón en la\n    // barra; al pasar los ajustes al menú de la cuenta, al recargar se perdía hasta abrir el menú (error pagado)\n    useFontSize();\n\n    return <ToolkitContext.Provider value={settings}>{children}</ToolkitContext.Provider>;\n};\n"],"names":[],"mappings":";;;;;;;;AAkCO,MAAM,kBAAkB,CAAC;AAAA,EAC5B,WAAW;AAAA,EAAkB;AAAA,EAAkB;AAAA,EAAO;AAAA,EAAW;AAAA,EAAU,WAAW;AAAA,EAAkB,UAAU;AAAA,EAClH,aAAa;AAAA,EAAmB,UAAU;AAAA,EAAI,YAAY;AAAA,EAAuB;AACrF,MAAM;AACF,QAAM,WAAW,QAAQ,OAAO;AAAA,IAC5B;AAAA,IACA,kBAAkB,oBAAoB;AAAA,IACtC,OAAO,SAAS,CAAA;AAAA,IAChB,WAAW,aAAa;AAAA,IACxB,UAAU,YAAY,gBAAA;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACA,CAAC,UAAU,kBAAkB,OAAO,WAAW,UAAU,UAAU,SAAS,YAAY,SAAS,SAAS,CAAC;AAI/G,mBAAiB;AAAA,IACb,UAAU,SAAS;AAAA,IAAU,OAAO,SAAS;AAAA,IAAO,WAAW,SAAS;AAAA,IAAW,UAAU,SAAS;AAAA,IAAU;AAAA,IAAU;AAAA,IAC1H;AAAA,EAAA,CACH;AAID,cAAA;AAEA,6BAAQ,eAAe,UAAf,EAAwB,OAAO,UAAW,UAAS;AAC/D;"}
+{"version":3,"file":"ToolkitProvider.js","sources":["../../src/toolkit/ToolkitProvider.jsx"],"sourcesContent":["// El proveedor del paquete: el único lugar donde cada aplicación conecta su idioma, sus textos, su zona horaria y su\n// router. Va por encima de la aplicación, dentro del ThemeProvider de MUI (el tema lo arma cada proyecto; sin tema,\n// los componentes usan los colores por omisión de MUI).\n//\n//   <ToolkitProvider language=\"es\" navigation={reactRouterNavigation} texts={{es: {common: {actions: {back: 'Volver'}}}}}>\n//\n// Sin proveedor todo funciona en español, con la zona del navegador y la navegación del navegador.\n//\n// Un proveedor dentro de otro (una parte de la app en otro idioma, una vista previa) toma del de afuera lo que no le digan, y\n// sus componentes leen el suyo: el más cercano. Solo el de la raíz pone la configuración que leen las funciones sueltas\n// (avisos, errores, formatos sueltos): antes el de adentro se la cambiaba a toda la app. Dos islas de React en una página\n// vieja son dos raíces: cada isla pinta con la suya, y las funciones sueltas usan la última que se pintó (en ese caso los\n// componentes de la casa ya formatean con su proveedor; para un aviso, mándelo con el texto ya traducido).\n//\n// Lo renderiza la app: arrow (regla de la casa).\nimport {useContext, useMemo} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {ToolkitContext} from '@/toolkit/toolkitContext.js';\nimport {useFontSize} from '@/ui/navigation/useFontSize.js';\nimport {DEFAULT_CURRENCY, DEFAULT_LANGUAGE, DEFAULT_LANGUAGES, browserTimeZone, configureToolkit} from '@/toolkit/toolkitSettings.js';\n\n/**\n * @param {object} props\n * @param {string} [props.language] idioma activo, uno de `languages` (por omisión es)\n * @param {Array<{code: string, label: string, locale?: string}>} [props.languages] los idiomas que ofrece la app: su código,\n *     su nombre en su propio idioma («Português») y su locale de Intl ('pt-BR'). Por omisión español e inglés\n *     (DEFAULT_LANGUAGES). Sus traducciones van en `texts`\n * @param {Record<string, {Icon: import('react').ElementType, color?: string, label?: string, hint?: string}>} [props.fileTypes]\n *     tipos de archivo del proyecto para las descargas, además de Excel, CSV y PDF (downloads/fileTypes.js)\n * @param {(language: string) => void} [props.onLanguageChange] lo llama LanguageToggle; el proyecto cambia su idioma\n * @param {object} [props.texts] textos propios por idioma, con la forma de locales/ ({es: {table: {...}}})\n * @param {(namespace: string, key: string, values?: object) => string|undefined} [props.translate] traductor del\n *     proyecto (por ejemplo i18next); undefined deja el texto del paquete\n * @param {string} [props.timeZone] zona de las fechas (por omisión la del navegador)\n * @param {string} [props.currency] moneda de los montos, código ISO 4217 (por omisión MXN)\n * @param {string} [props.appName] nombre de la aplicación para el título de la pestaña\n * @param {object} [props.navigation] {useNavigate, useLocation, Link}; por omisión la del navegador\n * @param {string} [props.buildId] la compilación del front que corre en esta pestaña; con ella NewBuildNotice sabe si el\n *     servidor ya publicó otra (reportPublishedBuild). Vacía (en desarrollo) nunca avisa\n * @param {(access: object|undefined|null) => boolean} [props.canAccess] quién ve qué (menú, rutas, botones): la regla del\n *     proyecto, normalmente createAccessChecker({abilities, roles, policies, context}). Sin ella solo se ve lo que no\n *     tiene regla\n * @param {import('react').ReactNode} props.children\n */\nexport const ToolkitProvider = ({\n    language, languages, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess, fileTypes, children,\n}) => {\n    // el proveedor de afuera, si este va dentro de otro: de él sale lo que este no diga\n    const parent = useContext(ToolkitContext);\n    const settings = useMemo(() => ({\n        language: language ?? parent?.language ?? DEFAULT_LANGUAGE,\n        languages: languages ?? parent?.languages ?? DEFAULT_LANGUAGES,\n        onLanguageChange: onLanguageChange ?? parent?.onLanguageChange ?? null,\n        texts: texts ?? parent?.texts ?? {},\n        translate: translate ?? parent?.translate ?? null,\n        timeZone: timeZone ?? parent?.timeZone ?? browserTimeZone(),\n        currency: currency ?? parent?.currency ?? DEFAULT_CURRENCY,\n        appName: appName ?? parent?.appName ?? '',\n        navigation: navigation ?? parent?.navigation ?? browserNavigation,\n        buildId: buildId ?? parent?.buildId ?? '',\n        canAccess: canAccess ?? parent?.canAccess ?? allowOnlyUnrestricted,\n        fileTypes: fileTypes ?? parent?.fileTypes ?? null,\n    }), [parent, language, languages, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess, fileTypes]);\n\n    // solo el de la raíz: un proveedor de adentro le cambiaba el idioma y la zona a las funciones sueltas de toda la app.\n    // OJO: se configura durante el render (no en un efecto) para que los formatos y avisos que se llaman en este mismo\n    // render ya vean el idioma y la zona nuevos\n    if (!parent) {\n        configureToolkit({\n            language: settings.language, texts: settings.texts, translate: settings.translate, timeZone: settings.timeZone, currency: settings.currency,\n            appName: settings.appName, buildId: settings.buildId, languages: settings.languages,\n        });\n    }\n\n    // el tamaño de letra que la persona guardó: se aplica aquí, que siempre está montado. Antes lo aplicaba su botón en la\n    // barra; al pasar los ajustes al menú de la cuenta, al recargar se perdía hasta abrir el menú (error pagado)\n    useFontSize();\n\n    return <ToolkitContext.Provider value={settings}>{children}</ToolkitContext.Provider>;\n};\n"],"names":[],"mappings":";;;;;;;;AA6CO,MAAM,kBAAkB,CAAC;AAAA,EAC5B;AAAA,EAAU;AAAA,EAAW;AAAA,EAAkB;AAAA,EAAO;AAAA,EAAW;AAAA,EAAU;AAAA,EAAU;AAAA,EAAS;AAAA,EAAY;AAAA,EAAS;AAAA,EAAW;AAAA,EAAW;AACrI,MAAM;AAEF,QAAM,SAAS,WAAW,cAAc;AACxC,QAAM,WAAW,QAAQ,OAAO;AAAA,IAC5B,UAAU,YAAY,QAAQ,YAAY;AAAA,IAC1C,WAAW,aAAa,QAAQ,aAAa;AAAA,IAC7C,kBAAkB,oBAAoB,QAAQ,oBAAoB;AAAA,IAClE,OAAO,SAAS,QAAQ,SAAS,CAAA;AAAA,IACjC,WAAW,aAAa,QAAQ,aAAa;AAAA,IAC7C,UAAU,YAAY,QAAQ,YAAY,gBAAA;AAAA,IAC1C,UAAU,YAAY,QAAQ,YAAY;AAAA,IAC1C,SAAS,WAAW,QAAQ,WAAW;AAAA,IACvC,YAAY,cAAc,QAAQ,cAAc;AAAA,IAChD,SAAS,WAAW,QAAQ,WAAW;AAAA,IACvC,WAAW,aAAa,QAAQ,aAAa;AAAA,IAC7C,WAAW,aAAa,QAAQ,aAAa;AAAA,EAAA,IAC7C,CAAC,QAAQ,UAAU,WAAW,kBAAkB,OAAO,WAAW,UAAU,UAAU,SAAS,YAAY,SAAS,WAAW,SAAS,CAAC;AAK7I,MAAI,CAAC,QAAQ;AACT,qBAAiB;AAAA,MACb,UAAU,SAAS;AAAA,MAAU,OAAO,SAAS;AAAA,MAAO,WAAW,SAAS;AAAA,MAAW,UAAU,SAAS;AAAA,MAAU,UAAU,SAAS;AAAA,MACnI,SAAS,SAAS;AAAA,MAAS,SAAS,SAAS;AAAA,MAAS,WAAW,SAAS;AAAA,IAAA,CAC7E;AAAA,EACL;AAIA,cAAA;AAEA,6BAAQ,eAAe,UAAf,EAAwB,OAAO,UAAW,UAAS;AAC/D;"}

package/dist/toolkit/browserNavigation.js

@@ -1,13 +1,7 @@
 "use client";
 import { createElement, useSyncExternalStore } from "react";
+import { pathWithBase, pathWithoutBase } from "./navigationPaths.js";
 const HISTORY_BACK = -1;
-function navigateInBrowser(destination) {
-  if (destination === HISTORY_BACK) {
-    window.history.back();
-    return;
-  }
-  window.location.assign(destination);
-}
 function subscribeToHistory(onChange) {
   window.addEventListener("popstate", onChange);
   return () => window.removeEventListener("popstate", onChange);
@@ -15,20 +9,25 @@ function subscribeToHistory(onChange) {
 function currentHref() {
   return window.location.href;
 }
-function useBrowserLocation() {
-  const href = useSyncExternalStore(subscribeToHistory, currentHref, () => "");
-  const url = href ? new URL(href) : null;
-  return { pathname: url?.pathname ?? "/", search: url?.search ?? "", key: href };
-}
-function BrowserLink({ to, ...props }) {
-  return createElement("a", { href: to, ...props });
+function createBrowserNavigation({ basePath = "" } = {}) {
+  const navigate = (destination) => {
+    if (destination === HISTORY_BACK) {
+      window.history.back();
+      return;
+    }
+    window.location.assign(pathWithBase(basePath, destination));
+  };
+  const useBrowserLocation = () => {
+    const href = useSyncExternalStore(subscribeToHistory, currentHref, () => "");
+    const url = href ? new URL(href) : null;
+    return { pathname: url ? pathWithoutBase(basePath, url.pathname) : "/", search: url?.search ?? "", key: href };
+  };
+  const BrowserLink = ({ to, ...props }) => createElement("a", { href: pathWithBase(basePath, to), ...props });
+  return Object.freeze({ useNavigate: () => navigate, useLocation: useBrowserLocation, Link: BrowserLink });
 }
-const browserNavigation = Object.freeze({
-  useNavigate: () => navigateInBrowser,
-  useLocation: useBrowserLocation,
-  Link: BrowserLink
-});
+const browserNavigation = createBrowserNavigation();
 export {
-  browserNavigation
+  browserNavigation,
+  createBrowserNavigation
 };
 //# sourceMappingURL=browserNavigation.js.map

package/dist/toolkit/browserNavigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserNavigation.js","sources":["../../src/toolkit/browserNavigation.js"],"sourcesContent":["// La navegación por omisión: la del navegador, para usar el paquete sin router.\n//\n// Los componentes que navegan (BackButton, MetricCard, el regreso a la última lista) no importan react-router ni\n// Next.js: le piden al proveedor una navegación con tres piezas, las mismas que trae react-router:\n//   useNavigate()  regresa navigate(destino), donde destino es una ruta o -1 para regresar;\n//   useLocation()  regresa {pathname, search, key} de la página actual;\n//   Link           el enlace, que recibe `to` con la ruta.\n// Un proyecto con router pasa su adaptador (@stackcraftmx/calcita/react-router); sin él, esta cambia de página como un\n// enlace normal.\n//\n// OJO: aquí cada navegación recarga la página. Para una aplicación de una sola página se usa el adaptador de su router.\nimport {createElement, useSyncExternalStore} from 'react';\n\nconst HISTORY_BACK = -1;\n\n/**\n * Cambia de página: -1 regresa en el historial; una ruta abre esa ruta.\n *\n * @param {string|number} destination\n * @returns {void}\n */\nfunction navigateInBrowser(destination) {\n    if (destination === HISTORY_BACK) {\n        window.history.back();\n        return;\n    }\n\n    window.location.assign(destination);\n}\n\n/**\n * Avisa cuando cambia la página por el historial (atrás y adelante).\n *\n * @param {Function} onChange\n * @returns {Function} para dejar de escuchar\n */\nfunction subscribeToHistory(onChange) {\n    window.addEventListener('popstate', onChange);\n\n    return () => window.removeEventListener('popstate', onChange);\n}\n\n/**\n * La dirección actual como texto, para saber si cambió.\n *\n * @returns {string}\n */\nfunction currentHref() {\n    return window.location.href;\n}\n\n/**\n * La página actual, como la da react-router: la ruta, la búsqueda y una llave por página.\n *\n * @returns {{pathname: string, search: string, key: string}}\n */\nfunction useBrowserLocation() {\n    const href = useSyncExternalStore(subscribeToHistory, currentHref, () => '');\n    const url = href ? new URL(href) : null;\n\n    return {pathname: url?.pathname ?? '/', search: url?.search ?? '', key: href};\n}\n\n/**\n * El enlace sin router: un <a> con href.\n *\n * @param {{to: string}} props lo demás pasa al <a>\n * @returns {import('react').ReactElement}\n */\nfunction BrowserLink({to, ...props}) {\n    return createElement('a', {href: to, ...props});\n}\n\nexport const browserNavigation = Object.freeze({\n    useNavigate: () => navigateInBrowser,\n    useLocation: useBrowserLocation,\n    Link: BrowserLink,\n});\n"],"names":[],"mappings":";;AAaA,MAAM,eAAe;AAQrB,SAAS,kBAAkB,aAAa;AACpC,MAAI,gBAAgB,cAAc;AAC9B,WAAO,QAAQ,KAAI;AACnB;AAAA,EACJ;AAEA,SAAO,SAAS,OAAO,WAAW;AACtC;AAQA,SAAS,mBAAmB,UAAU;AAClC,SAAO,iBAAiB,YAAY,QAAQ;AAE5C,SAAO,MAAM,OAAO,oBAAoB,YAAY,QAAQ;AAChE;AAOA,SAAS,cAAc;AACnB,SAAO,OAAO,SAAS;AAC3B;AAOA,SAAS,qBAAqB;AAC1B,QAAM,OAAO,qBAAqB,oBAAoB,aAAa,MAAM,EAAE;AAC3E,QAAM,MAAM,OAAO,IAAI,IAAI,IAAI,IAAI;AAEnC,SAAO,EAAC,UAAU,KAAK,YAAY,KAAK,QAAQ,KAAK,UAAU,IAAI,KAAK,KAAI;AAChF;AAQA,SAAS,YAAY,EAAC,IAAI,GAAG,MAAK,GAAG;AACjC,SAAO,cAAc,KAAK,EAAC,MAAM,IAAI,GAAG,MAAK,CAAC;AAClD;AAEY,MAAC,oBAAoB,OAAO,OAAO;AAAA,EAC3C,aAAa,MAAM;AAAA,EACnB,aAAa;AAAA,EACb,MAAM;AACV,CAAC;"}
+{"version":3,"file":"browserNavigation.js","sources":["../../src/toolkit/browserNavigation.js"],"sourcesContent":["// La navegación por omisión: la del navegador, para usar el paquete sin router.\n//\n// Los componentes que navegan (BackButton, MetricCard, el regreso a la última lista) no importan react-router ni\n// Next.js: le piden al proveedor una navegación con tres piezas, las mismas que trae react-router:\n//   useNavigate()  regresa navigate(destino), donde destino es una ruta o -1 para regresar;\n//   useLocation()  regresa {pathname, search, key} de la página actual;\n//   Link           el enlace, que recibe `to` con la ruta.\n// Un proyecto con router pasa su adaptador (@stackcraftmx/calcita/react-router); sin él, esta cambia de página como un\n// enlace normal.\n//\n// Para un sistema que ya existe, sin router:\n//   - con prefijo (la app detrás de un proxy en /portal): createBrowserNavigation({basePath: '/portal'}). Los componentes\n//     siguen hablando de '/pedidos' y la dirección real lleva el prefijo;\n//   - con # en la dirección (un servidor que no sabe responder /pedidos al recargar): createHashNavigation(), en\n//     hashNavigation.js.\n//\n// OJO: aquí cada navegación recarga la página. Para una aplicación de una sola página se usa el adaptador de su router (o la\n// de #, que no recarga).\nimport {createElement, useSyncExternalStore} from 'react';\n\nimport {pathWithBase, pathWithoutBase} from '@/toolkit/navigationPaths.js';\n\nconst HISTORY_BACK = -1;\n\n/**\n * Avisa cuando cambia la página por el historial (atrás y adelante).\n *\n * @param {Function} onChange\n * @returns {Function} para dejar de escuchar\n */\nfunction subscribeToHistory(onChange) {\n    window.addEventListener('popstate', onChange);\n\n    return () => window.removeEventListener('popstate', onChange);\n}\n\n/**\n * La dirección actual como texto, para saber si cambió.\n *\n * @returns {string}\n */\nfunction currentHref() {\n    return window.location.href;\n}\n\n/**\n * La navegación del navegador, con o sin prefijo.\n *\n * @param {{basePath?: string}} [options] basePath: donde vive la app detrás de un proxy ('/portal'); sin él, la raíz\n * @returns {{useNavigate: () => (destination: string|number) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}\n */\nexport function createBrowserNavigation({basePath = ''} = {}) {\n    // cambia de página: -1 regresa en el historial; una ruta de la app abre esa ruta con el prefijo\n    const navigate = (destination) => {\n        if (destination === HISTORY_BACK) {\n            window.history.back();\n            return;\n        }\n        window.location.assign(pathWithBase(basePath, destination));\n    };\n\n    // la página actual como la da react-router (la ruta SIN el prefijo, la búsqueda y una llave por página)\n    const useBrowserLocation = () => {\n        const href = useSyncExternalStore(subscribeToHistory, currentHref, () => '');\n        const url = href ? new URL(href) : null;\n        return {pathname: url ? pathWithoutBase(basePath, url.pathname) : '/', search: url?.search ?? '', key: href};\n    };\n\n    // el enlace sin router: un <a> con la dirección real\n    const BrowserLink = ({to, ...props}) => createElement('a', {href: pathWithBase(basePath, to), ...props});\n\n    return Object.freeze({useNavigate: () => navigate, useLocation: useBrowserLocation, Link: BrowserLink});\n}\n\n/** La de omisión: sin prefijo. */\nexport const browserNavigation = createBrowserNavigation();\n"],"names":[],"mappings":";;;AAsBA,MAAM,eAAe;AAQrB,SAAS,mBAAmB,UAAU;AAClC,SAAO,iBAAiB,YAAY,QAAQ;AAE5C,SAAO,MAAM,OAAO,oBAAoB,YAAY,QAAQ;AAChE;AAOA,SAAS,cAAc;AACnB,SAAO,OAAO,SAAS;AAC3B;AAQO,SAAS,wBAAwB,EAAC,WAAW,GAAE,IAAI,CAAA,GAAI;AAE1D,QAAM,WAAW,CAAC,gBAAgB;AAC9B,QAAI,gBAAgB,cAAc;AAC9B,aAAO,QAAQ,KAAI;AACnB;AAAA,IACJ;AACA,WAAO,SAAS,OAAO,aAAa,UAAU,WAAW,CAAC;AAAA,EAC9D;AAGA,QAAM,qBAAqB,MAAM;AAC7B,UAAM,OAAO,qBAAqB,oBAAoB,aAAa,MAAM,EAAE;AAC3E,UAAM,MAAM,OAAO,IAAI,IAAI,IAAI,IAAI;AACnC,WAAO,EAAC,UAAU,MAAM,gBAAgB,UAAU,IAAI,QAAQ,IAAI,KAAK,QAAQ,KAAK,UAAU,IAAI,KAAK,KAAI;AAAA,EAC/G;AAGA,QAAM,cAAc,CAAC,EAAC,IAAI,GAAG,MAAK,MAAM,cAAc,KAAK,EAAC,MAAM,aAAa,UAAU,EAAE,GAAG,GAAG,MAAK,CAAC;AAEvG,SAAO,OAAO,OAAO,EAAC,aAAa,MAAM,UAAU,aAAa,oBAAoB,MAAM,YAAW,CAAC;AAC1G;AAGY,MAAC,oBAAoB,wBAAuB;"}

package/dist/toolkit/componentTextsContext.js

@@ -0,0 +1,15 @@
+"use client";
+import { createContext } from "react";
+const ComponentTextsContext = createContext(null);
+function layersOf(layer) {
+  const layers = [];
+  for (let current = layer; current; current = current.parent) {
+    layers.push(current);
+  }
+  return layers;
+}
+export {
+  ComponentTextsContext,
+  layersOf
+};
+//# sourceMappingURL=componentTextsContext.js.map

package/dist/toolkit/componentTextsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentTextsContext.js","sources":["../../src/toolkit/componentTextsContext.js"],"sourcesContent":["// Los textos propios que un componente les pasa a las piezas de adentro (la tabla a sus filtros de columna, sus chips y su\n// barra de elegidos): así un `texts` en ServerTable cambia también el «Limpiar esta columna» del filtro, sin pasarlo pieza por\n// pieza. Cada capa sabe cuál la envuelve (parent): la más cercana gana.\n//\n// Contexto de React, no renderiza: archivo .js (regla de la casa).\nimport {createContext} from 'react';\n\n/** @type {import('react').Context<{namespace: string, texts: object|undefined, parent: object|null}|null>} */\nexport const ComponentTextsContext = createContext(null);\n\n/**\n * Las capas de afuera hacia la más lejana, para componentTextOf.\n *\n * @param {{namespace: string, texts: object|undefined, parent: object|null}|null} layer\n * @returns {Array<{namespace: string, texts: object|undefined}>}\n */\nexport function layersOf(layer) {\n    const layers = [];\n    for (let current = layer; current; current = current.parent) {\n        layers.push(current);\n    }\n\n    return layers;\n}\n"],"names":[],"mappings":";;AAQY,MAAC,wBAAwB,cAAc,IAAI;AAQhD,SAAS,SAAS,OAAO;AAC5B,QAAM,SAAS,CAAA;AACf,WAAS,UAAU,OAAO,SAAS,UAAU,QAAQ,QAAQ;AACzD,WAAO,KAAK,OAAO;AAAA,EACvB;AAEA,SAAO;AACX;"}

package/dist/toolkit/hashNavigation.js

@@ -0,0 +1,40 @@
+"use client";
+import { createElement, useSyncExternalStore } from "react";
+import { hashHrefOf, hashLocationOf } from "./navigationPaths.js";
+const HISTORY_BACK = -1;
+function subscribeToHash(onChange) {
+  window.addEventListener("hashchange", onChange);
+  window.addEventListener("popstate", onChange);
+  return () => {
+    window.removeEventListener("hashchange", onChange);
+    window.removeEventListener("popstate", onChange);
+  };
+}
+function currentHref() {
+  return window.location.href;
+}
+function createHashNavigation() {
+  const navigate = (destination) => {
+    if (destination === HISTORY_BACK) {
+      window.history.back();
+      return;
+    }
+    const href = hashHrefOf(destination);
+    if (href.startsWith("#")) {
+      window.location.hash = href;
+      return;
+    }
+    window.location.assign(href);
+  };
+  const useHashLocation = () => {
+    const href = useSyncExternalStore(subscribeToHash, currentHref, () => "");
+    const { pathname, search } = hashLocationOf(href ? new URL(href).hash : "");
+    return { pathname, search, key: href };
+  };
+  const HashLink = ({ to, ...props }) => createElement("a", { href: hashHrefOf(to), ...props });
+  return Object.freeze({ useNavigate: () => navigate, useLocation: useHashLocation, Link: HashLink });
+}
+export {
+  createHashNavigation
+};
+//# sourceMappingURL=hashNavigation.js.map

package/dist/toolkit/hashNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashNavigation.js","sources":["../../src/toolkit/hashNavigation.js"],"sourcesContent":["// La navegación con # en la dirección (/app.php#/pedidos), sin router: para meter Calcita en un sistema que ya existe y cuyo\n// servidor no sabe responder /pedidos al recargar. Todo lo que va después del # se queda en el navegador: cambiar de\n// pantalla no recarga la página ni pide nada al servidor, y atrás y adelante funcionan.\n//\n//   <ToolkitProvider navigation={createHashNavigation()}>   // una vez, fuera del componente\n//\n// Con react-router se usa su createHashRouter con el adaptador de siempre (@stackcraftmx/calcita/react-router).\n//\n// Funciones genéricas: function (regla de la casa).\nimport {createElement, useSyncExternalStore} from 'react';\n\nimport {hashHrefOf, hashLocationOf} from '@/toolkit/navigationPaths.js';\n\nconst HISTORY_BACK = -1;\n\n/** Avisa cuando cambia lo que va después del # (un enlace, atrás o adelante). */\nfunction subscribeToHash(onChange) {\n    window.addEventListener('hashchange', onChange);\n    window.addEventListener('popstate', onChange);\n    return () => {\n        window.removeEventListener('hashchange', onChange);\n        window.removeEventListener('popstate', onChange);\n    };\n}\n\nfunction currentHref() {\n    return window.location.href;\n}\n\n/**\n * @returns {{useNavigate: () => (destination: string|number) => void, useLocation: () => {pathname: string, search: string, key: string}, Link: import('react').ElementType}}\n */\nexport function createHashNavigation() {\n    // -1 regresa en el historial; una ruta de la app cambia lo que va después del # (sin recargar)\n    const navigate = (destination) => {\n        if (destination === HISTORY_BACK) {\n            window.history.back();\n            return;\n        }\n        const href = hashHrefOf(destination);\n        if (href.startsWith('#')) {\n            window.location.hash = href;\n            return;\n        }\n        // una dirección de afuera: como un enlace normal\n        window.location.assign(href);\n    };\n\n    // la página de la app, leída de lo que va después del #\n    const useHashLocation = () => {\n        const href = useSyncExternalStore(subscribeToHash, currentHref, () => '');\n        const {pathname, search} = hashLocationOf(href ? new URL(href).hash : '');\n        return {pathname, search, key: href};\n    };\n\n    const HashLink = ({to, ...props}) => createElement('a', {href: hashHrefOf(to), ...props});\n\n    return Object.freeze({useNavigate: () => navigate, useLocation: useHashLocation, Link: HashLink});\n}\n"],"names":[],"mappings":";;;AAaA,MAAM,eAAe;AAGrB,SAAS,gBAAgB,UAAU;AAC/B,SAAO,iBAAiB,cAAc,QAAQ;AAC9C,SAAO,iBAAiB,YAAY,QAAQ;AAC5C,SAAO,MAAM;AACT,WAAO,oBAAoB,cAAc,QAAQ;AACjD,WAAO,oBAAoB,YAAY,QAAQ;AAAA,EACnD;AACJ;AAEA,SAAS,cAAc;AACnB,SAAO,OAAO,SAAS;AAC3B;AAKO,SAAS,uBAAuB;AAEnC,QAAM,WAAW,CAAC,gBAAgB;AAC9B,QAAI,gBAAgB,cAAc;AAC9B,aAAO,QAAQ,KAAI;AACnB;AAAA,IACJ;AACA,UAAM,OAAO,WAAW,WAAW;AACnC,QAAI,KAAK,WAAW,GAAG,GAAG;AACtB,aAAO,SAAS,OAAO;AACvB;AAAA,IACJ;AAEA,WAAO,SAAS,OAAO,IAAI;AAAA,EAC/B;AAGA,QAAM,kBAAkB,MAAM;AAC1B,UAAM,OAAO,qBAAqB,iBAAiB,aAAa,MAAM,EAAE;AACxE,UAAM,EAAC,UAAU,OAAM,IAAI,eAAe,OAAO,IAAI,IAAI,IAAI,EAAE,OAAO,EAAE;AACxE,WAAO,EAAC,UAAU,QAAQ,KAAK,KAAI;AAAA,EACvC;AAEA,QAAM,WAAW,CAAC,EAAC,IAAI,GAAG,MAAK,MAAM,cAAc,KAAK,EAAC,MAAM,WAAW,EAAE,GAAG,GAAG,MAAK,CAAC;AAExF,SAAO,OAAO,OAAO,EAAC,aAAa,MAAM,UAAU,aAAa,iBAAiB,MAAM,SAAQ,CAAC;AACpG;"}

package/dist/toolkit/navigationPaths.js

@@ -0,0 +1,49 @@
+const HASH_SIGN = "#";
+const ROOT_PATH = "/";
+function normalizedBasePath(basePath) {
+  const trimmed = (basePath ?? "").trim().replace(/\/+$/, "");
+  if (!trimmed) {
+    return "";
+  }
+  return trimmed.startsWith(ROOT_PATH) ? trimmed : `${ROOT_PATH}${trimmed}`;
+}
+function isAppPath(destination) {
+  return destination.startsWith(ROOT_PATH) && !destination.startsWith("//");
+}
+function pathWithBase(basePath, destination) {
+  const base = normalizedBasePath(basePath);
+  return base && isAppPath(destination) ? `${base}${destination}` : destination;
+}
+function pathWithoutBase(basePath, pathname) {
+  const base = normalizedBasePath(basePath);
+  if (!base) {
+    return pathname;
+  }
+  if (pathname === base) {
+    return ROOT_PATH;
+  }
+  return pathname.startsWith(`${base}${ROOT_PATH}`) ? pathname.slice(base.length) : pathname;
+}
+function hashLocationOf(hash) {
+  const route = (hash ?? "").replace(/^#/, "");
+  if (!route) {
+    return { pathname: ROOT_PATH, search: "" };
+  }
+  const searchStart = route.indexOf("?");
+  const pathname = searchStart === -1 ? route : route.slice(0, searchStart);
+  return {
+    pathname: pathname.startsWith(ROOT_PATH) ? pathname : `${ROOT_PATH}${pathname}`,
+    search: searchStart === -1 ? "" : route.slice(searchStart)
+  };
+}
+function hashHrefOf(destination) {
+  return isAppPath(destination) ? `${HASH_SIGN}${destination}` : destination;
+}
+export {
+  hashHrefOf,
+  hashLocationOf,
+  normalizedBasePath,
+  pathWithBase,
+  pathWithoutBase
+};
+//# sourceMappingURL=navigationPaths.js.map

package/dist/toolkit/navigationPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationPaths.js","sources":["../../src/toolkit/navigationPaths.js"],"sourcesContent":["// Las rutas de la navegación sin router, para sistemas que ya existen (una página de PHP, JSP o .NET con React en un pedazo):\n//   - con prefijo: la app vive en /portal/… detrás de un proxy, y los componentes hablan de /pedidos sin saberlo;\n//   - con # en la dirección (/app.php#/pedidos): el servidor viejo no sabe responder /pedidos al recargar, y todo lo que va\n//     después del # se queda en el navegador.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\n\nconst HASH_SIGN = '#';\nconst ROOT_PATH = '/';\n\n/**\n * El prefijo limpio: '' sin prefijo; si no, empieza con / y no termina con / ('portal/' → '/portal').\n *\n * @param {string|null|undefined} basePath\n * @returns {string}\n */\nexport function normalizedBasePath(basePath) {\n    const trimmed = (basePath ?? '').trim().replace(/\\/+$/, '');\n    if (!trimmed) {\n        return '';\n    }\n    return trimmed.startsWith(ROOT_PATH) ? trimmed : `${ROOT_PATH}${trimmed}`;\n}\n\n/**\n * ¿Es una ruta de la app ('/pedidos')? Una dirección de afuera ('https://…', '//otro.sitio') o relativa ('?pagina=2') no.\n *\n * @param {string} destination\n * @returns {boolean}\n */\nfunction isAppPath(destination) {\n    return destination.startsWith(ROOT_PATH) && !destination.startsWith('//');\n}\n\n/**\n * La dirección real de una ruta de la app con el prefijo puesto: '/pedidos' → '/portal/pedidos'. Lo que no es ruta de la\n * app se queda como viene.\n *\n * @param {string} basePath\n * @param {string} destination\n * @returns {string}\n */\nexport function pathWithBase(basePath, destination) {\n    const base = normalizedBasePath(basePath);\n    return base && isAppPath(destination) ? `${base}${destination}` : destination;\n}\n\n/**\n * La ruta de la app de una dirección real, sin el prefijo: '/portal/pedidos' → '/pedidos'; el prefijo solo → '/'. Una\n * dirección de fuera del prefijo se queda como viene.\n *\n * @param {string} basePath\n * @param {string} pathname\n * @returns {string}\n */\nexport function pathWithoutBase(basePath, pathname) {\n    const base = normalizedBasePath(basePath);\n    if (!base) {\n        return pathname;\n    }\n    if (pathname === base) {\n        return ROOT_PATH;\n    }\n    return pathname.startsWith(`${base}${ROOT_PATH}`) ? pathname.slice(base.length) : pathname;\n}\n\n/**\n * La página de la app que va después del # ('#/pedidos?estado=pendiente' → {pathname: '/pedidos', search: '?estado=pendiente'}).\n * Sin nada después del #, el inicio.\n *\n * @param {string} hash el de la dirección (location.hash), con o sin #\n * @returns {{pathname: string, search: string}}\n */\nexport function hashLocationOf(hash) {\n    const route = (hash ?? '').replace(/^#/, '');\n    if (!route) {\n        return {pathname: ROOT_PATH, search: ''};\n    }\n    const searchStart = route.indexOf('?');\n    const pathname = searchStart === -1 ? route : route.slice(0, searchStart);\n    return {\n        pathname: pathname.startsWith(ROOT_PATH) ? pathname : `${ROOT_PATH}${pathname}`,\n        search: searchStart === -1 ? '' : route.slice(searchStart),\n    };\n}\n\n/**\n * El enlace de una ruta de la app con # ('/pedidos' → '#/pedidos'). Lo que no es ruta de la app se queda como viene.\n *\n * @param {string} destination\n * @returns {string}\n */\nexport function hashHrefOf(destination) {\n    return isAppPath(destination) ? `${HASH_SIGN}${destination}` : destination;\n}\n"],"names":[],"mappings":"AAOA,MAAM,YAAY;AAClB,MAAM,YAAY;AAQX,SAAS,mBAAmB,UAAU;AACzC,QAAM,WAAW,YAAY,IAAI,KAAI,EAAG,QAAQ,QAAQ,EAAE;AAC1D,MAAI,CAAC,SAAS;AACV,WAAO;AAAA,EACX;AACA,SAAO,QAAQ,WAAW,SAAS,IAAI,UAAU,GAAG,SAAS,GAAG,OAAO;AAC3E;AAQA,SAAS,UAAU,aAAa;AAC5B,SAAO,YAAY,WAAW,SAAS,KAAK,CAAC,YAAY,WAAW,IAAI;AAC5E;AAUO,SAAS,aAAa,UAAU,aAAa;AAChD,QAAM,OAAO,mBAAmB,QAAQ;AACxC,SAAO,QAAQ,UAAU,WAAW,IAAI,GAAG,IAAI,GAAG,WAAW,KAAK;AACtE;AAUO,SAAS,gBAAgB,UAAU,UAAU;AAChD,QAAM,OAAO,mBAAmB,QAAQ;AACxC,MAAI,CAAC,MAAM;AACP,WAAO;AAAA,EACX;AACA,MAAI,aAAa,MAAM;AACnB,WAAO;AAAA,EACX;AACA,SAAO,SAAS,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,SAAS,MAAM,KAAK,MAAM,IAAI;AACtF;AASO,SAAS,eAAe,MAAM;AACjC,QAAM,SAAS,QAAQ,IAAI,QAAQ,MAAM,EAAE;AAC3C,MAAI,CAAC,OAAO;AACR,WAAO,EAAC,UAAU,WAAW,QAAQ,GAAE;AAAA,EAC3C;AACA,QAAM,cAAc,MAAM,QAAQ,GAAG;AACrC,QAAM,WAAW,gBAAgB,KAAK,QAAQ,MAAM,MAAM,GAAG,WAAW;AACxE,SAAO;AAAA,IACH,UAAU,SAAS,WAAW,SAAS,IAAI,WAAW,GAAG,SAAS,GAAG,QAAQ;AAAA,IAC7E,QAAQ,gBAAgB,KAAK,KAAK,MAAM,MAAM,WAAW;AAAA,EACjE;AACA;AAQO,SAAS,WAAW,aAAa;AACpC,SAAO,UAAU,WAAW,IAAI,GAAG,SAAS,GAAG,WAAW,KAAK;AACnE;"}

package/dist/toolkit/toolkitSettings.js

@@ -3,7 +3,10 @@ import en from "../locales/en.js";
 const DEFAULT_LANGUAGE = "es";
 const DEFAULT_CURRENCY = "MXN";
 const PACKAGE_TEXTS_BY_LANGUAGE = Object.freeze({ es, en });
-const INTL_LOCALE_BY_LANGUAGE = Object.freeze({ es: "es-MX", en: "en-US" });
+const DEFAULT_LANGUAGES = Object.freeze([
+  Object.freeze({ code: "es", label: "Español", locale: "es-MX" }),
+  Object.freeze({ code: "en", label: "English", locale: "en-US" })
+]);
 const NAMESPACE_SEPARATOR = ":";
 const KEY_SEPARATOR = ".";
 const PLURAL_SEPARATOR = "_";
@@ -20,7 +23,9 @@ let currentSettings = Object.freeze({
   currency: DEFAULT_CURRENCY,
   appName: "",
   // la compilación del front que corre en esta pestaña ('' en desarrollo): con ella se sabe si hay una versión nueva
-  buildId: ""
+  buildId: "",
+  // los idiomas que ofrece la app (DEFAULT_LANGUAGES)
+  languages: DEFAULT_LANGUAGES
 });
 function configureToolkit(settings) {
   currentSettings = Object.freeze({ ...currentSettings, ...settings });
@@ -28,8 +33,9 @@ function configureToolkit(settings) {
 function toolkitSettings() {
   return currentSettings;
 }
-function intlLocaleOf(language) {
-  return INTL_LOCALE_BY_LANGUAGE[language] ?? INTL_LOCALE_BY_LANGUAGE[DEFAULT_LANGUAGE];
+function intlLocaleOf(language, languages = currentSettings.languages) {
+  const known = languages?.find((entry) => entry.code === language) ?? DEFAULT_LANGUAGES.find((entry) => entry.code === language);
+  return known?.locale ?? language ?? DEFAULT_LANGUAGES[0].locale;
 }
 function valueAtPath(texts, path) {
   let value = texts;
@@ -56,6 +62,18 @@ function textOf(texts, namespace, key, values, language) {
 function interpolate(text, values) {
   return text.replace(INTERPOLATION, (placeholder, name) => values?.[name] === void 0 ? placeholder : String(values[name]));
 }
+function componentTextOf(layers, namespace, key, values, language) {
+  for (const layer of layers) {
+    if (layer.namespace !== namespace || !layer.texts) {
+      continue;
+    }
+    const text = textOf({ [namespace]: layer.texts }, namespace, key, values, language);
+    if (text !== void 0) {
+      return interpolate(text, values);
+    }
+  }
+  return void 0;
+}
 function translateWith(settings, defaultNamespace, key, values) {
   const [namespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];
   const projectText = settings.translate?.(namespace, plainKey, values);
@@ -77,7 +95,9 @@ function translateToolkit(defaultNamespace, key, values) {
 export {
   DEFAULT_CURRENCY,
   DEFAULT_LANGUAGE,
+  DEFAULT_LANGUAGES,
   browserTimeZone,
+  componentTextOf,
   configureToolkit,
   intlLocaleOf,
   toolkitSettings,

package/dist/toolkit/toolkitSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolkitSettings.js","sources":["../../src/toolkit/toolkitSettings.js"],"sourcesContent":["// La configuración del paquete: idioma, textos, zona horaria, moneda, nombre de la aplicación y navegación.\n//\n// La pone ToolkitProvider en cada render y la leen también las funciones que no son componentes (formatos de fecha y\n// número, avisos, errores del servidor). Sin proveedor valen los de omisión: español, la zona del navegador y la\n// navegación del navegador.\n//\n// Los textos se resuelven en este orden, para que cada proyecto cambie solo lo que necesite:\n//   1. translate del proyecto (por ejemplo el t de i18next), si regresa un texto;\n//   2. los textos que el proyecto pasó en `texts`, del idioma activo;\n//   3. los textos del paquete (locales/), del idioma activo y, si no está, en español.\n// Las llaves usan la forma de i18next: «namespace:llave.anidada», {{variable}} y plurales con _one / _other.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport es from '@/locales/es.js';\nimport en from '@/locales/en.js';\n\nexport const DEFAULT_LANGUAGE = 'es';\n// la moneda de los montos (código ISO 4217) cuando el proyecto no dice otra\nexport const DEFAULT_CURRENCY = 'MXN';\n\nconst PACKAGE_TEXTS_BY_LANGUAGE = Object.freeze({es, en});\n\n// cómo se escriben números y fechas en cada idioma (Intl)\nconst INTL_LOCALE_BY_LANGUAGE = Object.freeze({es: 'es-MX', en: 'en-US'});\n\nconst NAMESPACE_SEPARATOR = ':';\nconst KEY_SEPARATOR = '.';\nconst PLURAL_SEPARATOR = '_';\nconst PLURAL_OTHER = 'other';\nconst INTERPOLATION = /\\{\\{\\s*(\\w+)\\s*\\}\\}/g;\n\n/**\n * La zona horaria del navegador; si el navegador no la sabe, la de la Ciudad de México.\n *\n * @returns {string}\n */\nexport function browserTimeZone() {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone ?? 'America/Mexico_City';\n}\n\nlet currentSettings = Object.freeze({\n    language: DEFAULT_LANGUAGE,\n    texts: {},\n    translate: null,\n    timeZone: browserTimeZone(),\n    currency: DEFAULT_CURRENCY,\n    appName: '',\n    // la compilación del front que corre en esta pestaña ('' en desarrollo): con ella se sabe si hay una versión nueva\n    buildId: '',\n});\n\n/**\n * Cambia la configuración que leen las funciones del paquete. La llama ToolkitProvider; un proyecto sin React (o una\n * prueba) la puede llamar directo.\n *\n * @param {{language?: string, texts?: object, translate?: Function|null, timeZone?: string, currency?: string, appName?: string, buildId?: string}} settings\n * @returns {void}\n */\nexport function configureToolkit(settings) {\n    currentSettings = Object.freeze({...currentSettings, ...settings});\n}\n\n/**\n * La configuración vigente.\n *\n * @returns {{language: string, texts: object, translate: Function|null, timeZone: string, currency: string, appName: string, buildId: string}}\n */\nexport function toolkitSettings() {\n    return currentSettings;\n}\n\n/**\n * El locale de Intl del idioma (es → es-MX, en → en-US).\n *\n * @param {string} language\n * @returns {string}\n */\nexport function intlLocaleOf(language) {\n    return INTL_LOCALE_BY_LANGUAGE[language] ?? INTL_LOCALE_BY_LANGUAGE[DEFAULT_LANGUAGE];\n}\n\n/**\n * Lo que hay en una ruta de llaves («toast.error») dentro de un objeto de textos.\n *\n * @param {object|undefined} texts\n * @param {string} path\n * @returns {unknown}\n */\nfunction valueAtPath(texts, path) {\n    let value = texts;\n    for (const part of path.split(KEY_SEPARATOR)) {\n        if (value === null || typeof value !== 'object') {\n            return undefined;\n        }\n        value = value[part];\n    }\n\n    return value;\n}\n\n/**\n * El texto de una llave en un objeto de textos, con su plural si trae count (como i18next: llave_one, llave_other).\n *\n * @param {object|undefined} texts los textos de un idioma, por namespace\n * @param {string} namespace\n * @param {string} key\n * @param {object|undefined} values\n * @param {string} language\n * @returns {string|undefined}\n */\nfunction textOf(texts, namespace, key, values, language) {\n    const namespaceTexts = texts?.[namespace];\n    if (typeof values?.count === 'number') {\n        const pluralCategory = new Intl.PluralRules(intlLocaleOf(language)).select(values.count);\n        const pluralText = valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${pluralCategory}`)\n            ?? valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${PLURAL_OTHER}`);\n        if (typeof pluralText === 'string') {\n            return pluralText;\n        }\n    }\n\n    const text = valueAtPath(namespaceTexts, key);\n\n    return typeof text === 'string' ? text : undefined;\n}\n\n/**\n * Pone los valores en las {{variables}} del texto; una variable sin valor se queda como está.\n *\n * @param {string} text\n * @param {object|undefined} values\n * @returns {string}\n */\nfunction interpolate(text, values) {\n    return text.replace(INTERPOLATION, (placeholder, name) => (values?.[name] === undefined ? placeholder : String(values[name])));\n}\n\n/**\n * El texto de una llave con una configuración dada (la del proveedor o la vigente).\n *\n * @param {{language: string, texts: object, translate: Function|null}} settings\n * @param {string} defaultNamespace el namespace cuando la llave no trae uno («table», «common», «problems»...)\n * @param {string} key «llave» o «namespace:llave»\n * @param {object} [values] las variables del texto y, para el plural, count\n * @returns {string} la llave misma si no hay texto, para que se note qué falta\n */\nexport function translateWith(settings, defaultNamespace, key, values) {\n    const [namespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];\n    const projectText = settings.translate?.(namespace, plainKey, values);\n    if (typeof projectText === 'string') {\n        return projectText;\n    }\n\n    const text = textOf(settings.texts?.[settings.language], namespace, plainKey, values, settings.language)\n        ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[settings.language], namespace, plainKey, values, settings.language)\n        ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[DEFAULT_LANGUAGE], namespace, plainKey, values, DEFAULT_LANGUAGE);\n\n    if (text !== undefined) {\n        return interpolate(text, values);\n    }\n    // como en i18next: sin la llave en ningún lado, el texto por omisión que pidió quien llama (un globo opcional pasa ''\n    // y no se pinta); sin él, la llave tal cual, para que se note qué falta\n    if (typeof values?.defaultValue === 'string') {\n        return interpolate(values.defaultValue, values);\n    }\n    return `${namespace}${NAMESPACE_SEPARATOR}${plainKey}`;\n}\n\n/**\n * El texto de una llave con la configuración vigente, para lo que no es componente (avisos, errores del servidor).\n *\n * @param {string} defaultNamespace\n * @param {string} key\n * @param {object} [values]\n * @returns {string}\n */\nexport function translateToolkit(defaultNamespace, key, values) {\n    return translateWith(currentSettings, defaultNamespace, key, values);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"toolkitSettings.js","sources":["../../src/toolkit/toolkitSettings.js"],"sourcesContent":["// La configuración del paquete: idioma, textos, zona horaria, moneda, nombre de la aplicación y navegación.\n//\n// La pone ToolkitProvider en cada render y la leen también las funciones que no son componentes (formatos de fecha y\n// número, avisos, errores del servidor). Sin proveedor valen los de omisión: español, la zona del navegador y la\n// navegación del navegador.\n//\n// Los textos se resuelven en este orden, para que cada proyecto cambie solo lo que necesite:\n//   1. translate del proyecto (por ejemplo el t de i18next), si regresa un texto;\n//   2. los textos que el proyecto pasó en `texts`, del idioma activo;\n//   3. los textos del paquete (locales/), del idioma activo y, si no está, en español.\n// Las llaves usan la forma de i18next: «namespace:llave.anidada», {{variable}} y plurales con _one / _other.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport es from '@/locales/es.js';\nimport en from '@/locales/en.js';\n\nexport const DEFAULT_LANGUAGE = 'es';\n// la moneda de los montos (código ISO 4217) cuando el proyecto no dice otra\nexport const DEFAULT_CURRENCY = 'MXN';\n\nconst PACKAGE_TEXTS_BY_LANGUAGE = Object.freeze({es, en});\n\n/**\n * Los idiomas que ofrece la app cuando el proyecto no dice otros: su código, su nombre en su propio idioma (así lo busca quien\n * lo habla) y cómo se escriben sus números y fechas (Intl). El proyecto agrega los suyos en ToolkitProvider `languages` y pone\n * sus traducciones en `texts` (lo que no traduzca sale en español); los textos del paquete solo vienen en español e inglés.\n */\nexport const DEFAULT_LANGUAGES = Object.freeze([\n    Object.freeze({code: 'es', label: 'Español', locale: 'es-MX'}),\n    Object.freeze({code: 'en', label: 'English', locale: 'en-US'}),\n]);\n\nconst NAMESPACE_SEPARATOR = ':';\nconst KEY_SEPARATOR = '.';\nconst PLURAL_SEPARATOR = '_';\nconst PLURAL_OTHER = 'other';\nconst INTERPOLATION = /\\{\\{\\s*(\\w+)\\s*\\}\\}/g;\n\n/**\n * La zona horaria del navegador; si el navegador no la sabe, la de la Ciudad de México.\n *\n * @returns {string}\n */\nexport function browserTimeZone() {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone ?? 'America/Mexico_City';\n}\n\nlet currentSettings = Object.freeze({\n    language: DEFAULT_LANGUAGE,\n    texts: {},\n    translate: null,\n    timeZone: browserTimeZone(),\n    currency: DEFAULT_CURRENCY,\n    appName: '',\n    // la compilación del front que corre en esta pestaña ('' en desarrollo): con ella se sabe si hay una versión nueva\n    buildId: '',\n    // los idiomas que ofrece la app (DEFAULT_LANGUAGES)\n    languages: DEFAULT_LANGUAGES,\n});\n\n/**\n * Cambia la configuración que leen las funciones del paquete. La llama ToolkitProvider; un proyecto sin React (o una\n * prueba) la puede llamar directo.\n *\n * @param {{language?: string, texts?: object, translate?: Function|null, timeZone?: string, currency?: string, appName?: string, buildId?: string, languages?: Array<{code: string, label: string, locale?: string}>}} settings\n * @returns {void}\n */\nexport function configureToolkit(settings) {\n    currentSettings = Object.freeze({...currentSettings, ...settings});\n}\n\n/**\n * La configuración vigente.\n *\n * @returns {{language: string, texts: object, translate: Function|null, timeZone: string, currency: string, appName: string, buildId: string, languages: Array<{code: string, label: string, locale?: string}>}}\n */\nexport function toolkitSettings() {\n    return currentSettings;\n}\n\n/**\n * El locale de Intl del idioma: el que dice su lista de idiomas (es → es-MX, pt → pt-BR) o, si no dice, el código mismo\n * (Intl entiende «pt»). OJO: antes un idioma que no fuera es ni en salía con los números y las fechas de México.\n *\n * @param {string} language\n * @param {Array<{code: string, locale?: string}>} [languages] por omisión los de la configuración vigente\n * @returns {string}\n */\nexport function intlLocaleOf(language, languages = currentSettings.languages) {\n    const known = languages?.find((entry) => entry.code === language) ?? DEFAULT_LANGUAGES.find((entry) => entry.code === language);\n    return known?.locale ?? language ?? DEFAULT_LANGUAGES[0].locale;\n}\n\n/**\n * Lo que hay en una ruta de llaves («toast.error») dentro de un objeto de textos.\n *\n * @param {object|undefined} texts\n * @param {string} path\n * @returns {unknown}\n */\nfunction valueAtPath(texts, path) {\n    let value = texts;\n    for (const part of path.split(KEY_SEPARATOR)) {\n        if (value === null || typeof value !== 'object') {\n            return undefined;\n        }\n        value = value[part];\n    }\n\n    return value;\n}\n\n/**\n * El texto de una llave en un objeto de textos, con su plural si trae count (como i18next: llave_one, llave_other).\n *\n * @param {object|undefined} texts los textos de un idioma, por namespace\n * @param {string} namespace\n * @param {string} key\n * @param {object|undefined} values\n * @param {string} language\n * @returns {string|undefined}\n */\nfunction textOf(texts, namespace, key, values, language) {\n    const namespaceTexts = texts?.[namespace];\n    if (typeof values?.count === 'number') {\n        const pluralCategory = new Intl.PluralRules(intlLocaleOf(language)).select(values.count);\n        const pluralText = valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${pluralCategory}`)\n            ?? valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${PLURAL_OTHER}`);\n        if (typeof pluralText === 'string') {\n            return pluralText;\n        }\n    }\n\n    const text = valueAtPath(namespaceTexts, key);\n\n    return typeof text === 'string' ? text : undefined;\n}\n\n/**\n * Pone los valores en las {{variables}} del texto; una variable sin valor se queda como está.\n *\n * @param {string} text\n * @param {object|undefined} values\n * @returns {string}\n */\nfunction interpolate(text, values) {\n    return text.replace(INTERPOLATION, (placeholder, name) => (values?.[name] === undefined ? placeholder : String(values[name])));\n}\n\n/**\n * El texto de una llave en los textos propios de los componentes (la prop `texts` de un componente y los de ComponentTexts\n * de afuera), si alguno la trae. Cada capa es {namespace, texts} con la misma forma que ese namespace en los textos del\n * paquete (es.js): plurales con _one/_other y {{variables}}. La primera capa que trae la llave gana.\n *\n * @param {Array<{namespace: string, texts: object|undefined}>} layers de la más cercana a la más lejana\n * @param {string} namespace el de la llave\n * @param {string} key la llave sin namespace\n * @param {object|undefined} values\n * @param {string} language para elegir el plural\n * @returns {string|undefined} el texto ya con sus variables, o undefined si ninguna capa lo trae\n */\nexport function componentTextOf(layers, namespace, key, values, language) {\n    for (const layer of layers) {\n        if (layer.namespace !== namespace || !layer.texts) {\n            continue;\n        }\n        const text = textOf({[namespace]: layer.texts}, namespace, key, values, language);\n        if (text !== undefined) {\n            return interpolate(text, values);\n        }\n    }\n\n    return undefined;\n}\n\n/**\n * El texto de una llave con una configuración dada (la del proveedor o la vigente).\n *\n * @param {{language: string, texts: object, translate: Function|null}} settings\n * @param {string} defaultNamespace el namespace cuando la llave no trae uno («table», «common», «problems»...)\n * @param {string} key «llave» o «namespace:llave»\n * @param {object} [values] las variables del texto y, para el plural, count\n * @returns {string} la llave misma si no hay texto, para que se note qué falta\n */\nexport function translateWith(settings, defaultNamespace, key, values) {\n    const [namespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];\n    const projectText = settings.translate?.(namespace, plainKey, values);\n    if (typeof projectText === 'string') {\n        return projectText;\n    }\n\n    const text = textOf(settings.texts?.[settings.language], namespace, plainKey, values, settings.language)\n        ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[settings.language], namespace, plainKey, values, settings.language)\n        ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[DEFAULT_LANGUAGE], namespace, plainKey, values, DEFAULT_LANGUAGE);\n\n    if (text !== undefined) {\n        return interpolate(text, values);\n    }\n    // como en i18next: sin la llave en ningún lado, el texto por omisión que pidió quien llama (un globo opcional pasa ''\n    // y no se pinta); sin él, la llave tal cual, para que se note qué falta\n    if (typeof values?.defaultValue === 'string') {\n        return interpolate(values.defaultValue, values);\n    }\n    return `${namespace}${NAMESPACE_SEPARATOR}${plainKey}`;\n}\n\n/**\n * El texto de una llave con la configuración vigente, para lo que no es componente (avisos, errores del servidor).\n *\n * @param {string} defaultNamespace\n * @param {string} key\n * @param {object} [values]\n * @returns {string}\n */\nexport function translateToolkit(defaultNamespace, key, values) {\n    return translateWith(currentSettings, defaultNamespace, key, values);\n}\n"],"names":[],"mappings":"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"}

package/dist/toolkit/useFormatters.js

@@ -0,0 +1,12 @@
+"use client";
+import { useMemo } from "react";
+import { formattersOf } from "../formatting.js";
+import { useToolkitSettings } from "./toolkitContext.js";
+function useFormatters() {
+  const settings = useToolkitSettings();
+  return useMemo(() => formattersOf(() => settings), [settings]);
+}
+export {
+  useFormatters
+};
+//# sourceMappingURL=useFormatters.js.map

package/dist/toolkit/useFormatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormatters.js","sources":["../../src/toolkit/useFormatters.js"],"sourcesContent":["// Los formatos de fecha, hora, número, moneda y tamaño de archivo con la configuración del ToolkitProvider MÁS CERCANO.\n//\n// Es lo que usan los componentes del paquete, y lo que conviene en los del proyecto: con dos proveedores (una parte de la app\n// en otro idioma, o dos islas de React en una página que no es de React) cada parte escribe con el suyo. Los formatos sueltos\n// (formatDate…) usan el de la raíz: sirven para lo que no es componente.\n//\n//   const {formatDate, formatCurrency} = useFormatters();\n//   <Typography>{formatDate(order.created_at)} · {formatCurrency(order.total)}</Typography>\n//\n// Hook genérico: function (regla de la casa).\nimport {useMemo} from 'react';\n\nimport {formattersOf} from '@/formatting.js';\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\n\n/**\n * @returns {ReturnType<typeof formattersOf>} formatNumber, formatList, formatCurrency, formatFileSize, formatPercent,\n *     formatDateTime, formatDate, formatTime, formatMonthName, formatMonthShortName y formatWeekdayShortName\n */\nexport function useFormatters() {\n    const settings = useToolkitSettings();\n    return useMemo(() => formattersOf(() => settings), [settings]);\n}\n"],"names":[],"mappings":";;;;AAmBO,SAAS,gBAAgB;AAC5B,QAAM,WAAW,mBAAkB;AACnC,SAAO,QAAQ,MAAM,aAAa,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC;AACjE;"}

package/dist/toolkit/useToolkitTranslation.js

@@ -1,14 +1,18 @@
 "use client";
-import { useCallback } from "react";
+import { useContext, useCallback } from "react";
+import { ComponentTextsContext, layersOf } from "./componentTextsContext.js";
 import { useToolkitSettings } from "./toolkitContext.js";
-import { translateWith } from "./toolkitSettings.js";
-function useToolkitTranslation(namespace) {
+import { componentTextOf, translateWith } from "./toolkitSettings.js";
+const NAMESPACE_SEPARATOR = ":";
+function useToolkitTranslation(namespace, ownTexts) {
   const settings = useToolkitSettings();
+  const outerTexts = useContext(ComponentTextsContext);
   const defaultNamespace = Array.isArray(namespace) ? namespace[0] : namespace;
-  const t = useCallback(
-    (key, values) => translateWith(settings, defaultNamespace, key, values),
-    [settings, defaultNamespace]
-  );
+  const t = useCallback((key, values) => {
+    const [keyNamespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];
+    const layers = [{ namespace: defaultNamespace, texts: ownTexts }, ...layersOf(outerTexts)];
+    return componentTextOf(layers, keyNamespace, plainKey, values, settings.language) ?? translateWith(settings, defaultNamespace, key, values);
+  }, [settings, defaultNamespace, ownTexts, outerTexts]);
   const changeLanguage = useCallback((language) => settings.onLanguageChange?.(language), [settings]);
   return { t, language: settings.language, changeLanguage };
 }

package/dist/toolkit/useToolkitTranslation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToolkitTranslation.js","sources":["../../src/toolkit/useToolkitTranslation.js"],"sourcesContent":["// Los textos del paquete dentro de un componente, con la misma forma que useTranslation de react-i18next:\n//\n//   const {t, language, changeLanguage} = useToolkitTranslation('table');\n//   t('goToPage.of', {count: pageCount, total})\n//\n// Se vuelve a pintar cuando cambia el idioma o los textos del proveedor. El orden en que se buscan los textos está en\n// toolkitSettings.js.\n//\n// Hook genérico: function (regla de la casa).\nimport {useCallback} from 'react';\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\nimport {translateWith} from '@/toolkit/toolkitSettings.js';\n\n/**\n * @param {string|string[]} [namespace] el namespace de las llaves sin prefijo; con una lista, el primero. Sin él, cada\n *     llave lleva el suyo ('orders:list.title')\n * @returns {{t: (key: string, values?: object) => string, language: string, changeLanguage: (language: string) => void}}\n */\nexport function useToolkitTranslation(namespace) {\n    const settings = useToolkitSettings();\n    const defaultNamespace = Array.isArray(namespace) ? namespace[0] : namespace;\n    const t = useCallback(\n        (key, values) => translateWith(settings, defaultNamespace, key, values),\n        [settings, defaultNamespace],\n    );\n    // sin onLanguageChange del proyecto no hay a quién avisarle: el botón de idioma no hace nada\n    const changeLanguage = useCallback((language) => settings.onLanguageChange?.(language), [settings]);\n\n    return {t, language: settings.language, changeLanguage};\n}\n"],"names":[],"mappings":";;;;AAkBO,SAAS,sBAAsB,WAAW;AAC7C,QAAM,WAAW,mBAAkB;AACnC,QAAM,mBAAmB,MAAM,QAAQ,SAAS,IAAI,UAAU,CAAC,IAAI;AACnE,QAAM,IAAI;AAAA,IACN,CAAC,KAAK,WAAW,cAAc,UAAU,kBAAkB,KAAK,MAAM;AAAA,IACtE,CAAC,UAAU,gBAAgB;AAAA,EACnC;AAEI,QAAM,iBAAiB,YAAY,CAAC,aAAa,SAAS,mBAAmB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAElG,SAAO,EAAC,GAAG,UAAU,SAAS,UAAU,eAAc;AAC1D;"}
+{"version":3,"file":"useToolkitTranslation.js","sources":["../../src/toolkit/useToolkitTranslation.js"],"sourcesContent":["// Los textos del paquete dentro de un componente, con la misma forma que useTranslation de react-i18next:\n//\n//   const {t, language, changeLanguage} = useToolkitTranslation('table');\n//   t('goToPage.of', {count: pageCount, total})\n//\n// Se vuelve a pintar cuando cambia el idioma o los textos del proveedor. El orden en que se buscan los textos está en\n// toolkitSettings.js; antes que todos van los textos propios del componente (su prop `texts`, el segundo parámetro) y los de\n// ComponentTexts de afuera: un texto de una pantalla se cambia ahí, sin tocar el idioma completo.\n//\n//   const {t} = useToolkitTranslation('table', texts);\n//\n// Hook genérico: function (regla de la casa).\nimport {useCallback, useContext} from 'react';\nimport {ComponentTextsContext, layersOf} from '@/toolkit/componentTextsContext.js';\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\nimport {componentTextOf, translateWith} from '@/toolkit/toolkitSettings.js';\n\nconst NAMESPACE_SEPARATOR = ':';\n\n/**\n * @param {string|string[]} [namespace] el namespace de las llaves sin prefijo; con una lista, el primero. Sin él, cada\n *     llave lleva el suyo ('orders:list.title')\n * @param {object} [ownTexts] los textos propios del componente (su prop `texts`), con la forma de ese namespace\n * @returns {{t: (key: string, values?: object) => string, language: string, changeLanguage: (language: string) => void}}\n */\nexport function useToolkitTranslation(namespace, ownTexts) {\n    const settings = useToolkitSettings();\n    const outerTexts = useContext(ComponentTextsContext);\n    const defaultNamespace = Array.isArray(namespace) ? namespace[0] : namespace;\n    const t = useCallback((key, values) => {\n        const [keyNamespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];\n        const layers = [{namespace: defaultNamespace, texts: ownTexts}, ...layersOf(outerTexts)];\n        return componentTextOf(layers, keyNamespace, plainKey, values, settings.language)\n            ?? translateWith(settings, defaultNamespace, key, values);\n    }, [settings, defaultNamespace, ownTexts, outerTexts]);\n    // sin onLanguageChange del proyecto no hay a quién avisarle: el botón de idioma no hace nada\n    const changeLanguage = useCallback((language) => settings.onLanguageChange?.(language), [settings]);\n\n    return {t, language: settings.language, changeLanguage};\n}\n"],"names":[],"mappings":";;;;;AAiBA,MAAM,sBAAsB;AAQrB,SAAS,sBAAsB,WAAW,UAAU;AACvD,QAAM,WAAW,mBAAkB;AACnC,QAAM,aAAa,WAAW,qBAAqB;AACnD,QAAM,mBAAmB,MAAM,QAAQ,SAAS,IAAI,UAAU,CAAC,IAAI;AACnE,QAAM,IAAI,YAAY,CAAC,KAAK,WAAW;AACnC,UAAM,CAAC,cAAc,QAAQ,IAAI,IAAI,SAAS,mBAAmB,IAAI,IAAI,MAAM,qBAAqB,CAAC,IAAI,CAAC,kBAAkB,GAAG;AAC/H,UAAM,SAAS,CAAC,EAAC,WAAW,kBAAkB,OAAO,SAAQ,GAAG,GAAG,SAAS,UAAU,CAAC;AACvF,WAAO,gBAAgB,QAAQ,cAAc,UAAU,QAAQ,SAAS,QAAQ,KACzE,cAAc,UAAU,kBAAkB,KAAK,MAAM;AAAA,EAChE,GAAG,CAAC,UAAU,kBAAkB,UAAU,UAAU,CAAC;AAErD,QAAM,iBAAiB,YAAY,CAAC,aAAa,SAAS,mBAAmB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAElG,SAAO,EAAC,GAAG,UAAU,SAAS,UAAU,eAAc;AAC1D;"}

package/dist/types/DataTable/AuditTrailTable.d.ts

@@ -10,8 +10,9 @@
  * @param {string} props.ariaLabel
  * @param {number} [props.maxGridHeight]
  * @param {unknown} [props.refreshToken] cambia para volver a consultar (después de una acción sobre el mismo renglón)
+ * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
  */
-export default function AuditTrailTable({ subjectKey, fetchPage, eventDictionary, resultDictionary, extraColumns, ariaLabel, maxGridHeight, refreshToken, eventSuffixOf, }: {
+export default function AuditTrailTable({ subjectKey, fetchPage, eventDictionary, resultDictionary, extraColumns, ariaLabel, maxGridHeight, refreshToken, eventSuffixOf, texts, }: {
     subjectKey: string;
     fetchPage: (tableRequest: object, signal: AbortSignal) => Promise<{
         rows: any[];
@@ -25,4 +26,5 @@ export default function AuditTrailTable({ subjectKey, fetchPage, eventDictionary
     ariaLabel: string;
     maxGridHeight?: number;
     refreshToken?: unknown;
+    texts?: object;
 }): import("react").JSX.Element;

package/dist/types/DataTable/EmptyState.d.ts

@@ -1,8 +1,13 @@
 /**
- * @param {{filtered?: boolean, label?: string, onClearFilters?: () => void}} props label ya traducido
+ * @param {object} [props]
+ * @param {boolean} [props.filtered]
+ * @param {string} [props.label] ya traducido
+ * @param {() => void} [props.onClearFilters]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
  */
-export default function EmptyState({ filtered, label, onClearFilters }: {
+export default function EmptyState({ filtered, label, onClearFilters, texts }?: {
     filtered?: boolean;
     label?: string;
     onClearFilters?: () => void;
+    texts?: object;
 }): import("react").JSX.Element;

package/dist/types/DataTable/FilterChips.d.ts

@@ -5,11 +5,13 @@
  * @param {(field: string, value: unknown) => void} props.onSetFilter
  * @param {() => void} props.onClearAll
  * @param {number} [props.quickActiveCount] accesos rápidos puestos que no tienen chip aquí
+ * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
  */
-export default function FilterChips({ chipConfig, filters, onSetFilter, onClearAll, quickActiveCount }: {
+export default function FilterChips({ chipConfig, filters, onSetFilter, onClearAll, quickActiveCount, texts }: {
     chipConfig: Array<object>;
     filters: object;
     onSetFilter: (field: string, value: unknown) => void;
     onClearAll: () => void;
     quickActiveCount?: number;
+    texts?: object;
 }): import("react").JSX.Element | null;

package/dist/types/DataTable/GoToPage.d.ts

@@ -1,8 +1,13 @@
 /**
- * @param {{page: number, pageCount: number, onChange: (page: number) => void}} props page cuenta desde 0
+ * @param {object} props
+ * @param {number} props.page cuenta desde 0
+ * @param {number} props.pageCount
+ * @param {(page: number) => void} props.onChange
+ * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
  */
-export default function GoToPage({ page, pageCount, onChange }: {
+export default function GoToPage({ page, pageCount, onChange, texts }: {
     page: number;
     pageCount: number;
     onChange: (page: number) => void;
+    texts?: object;
 }): import("react").JSX.Element | null;

package/dist/types/DataTable/SelectionBar.d.ts

@@ -0,0 +1,32 @@
+/** Dónde va la barra de los elegidos: todo en el renglón, o dividida en el teléfono (arriba el conteo, abajo las acciones). */
+export declare const SELECTION_BAR_VARIANT: Readonly<{
+    row: "row";
+    header: "header";
+    actions: "actions";
+}>;
+/**
+ * @param {object} props
+ * @param {string} props.countText «5 elegidos», ya traducido
+ * @param {Array<{key: string, label: string, icon?: import('react').ReactNode, color?: string, isDisabled?: boolean}>} props.actions
+ *     las acciones de la pantalla, con isDisabled ya resuelto para la selección de ahora
+ * @param {string|null} props.runningActionKey la acción que está corriendo: mientras, las demás se apagan
+ * @param {(actionKey: string) => void} props.onRunAction
+ * @param {() => void} props.onClear quitar la selección
+ * @param {'row'|'header'|'actions'} [props.variant] SELECTION_BAR_VARIANT; por omisión el renglón
+ * @param {object} [props.sx]
+ */
+export default function SelectionBar({ countText, actions, runningActionKey, onRunAction, onClear, variant, sx }: {
+    countText: string;
+    actions: Array<{
+        key: string;
+        label: string;
+        icon?: import('react').ReactNode;
+        color?: string;
+        isDisabled?: boolean;
+    }>;
+    runningActionKey: string | null;
+    onRunAction: (actionKey: string) => void;
+    onClear: () => void;
+    variant?: 'row' | 'header' | 'actions';
+    sx?: object;
+}): import("react").JSX.Element;