@stackcraftmx/calcita 0.31.0 → 0.32.1

package/dist/toolkit/ToolkitProvider.js

@@ -5,7 +5,8 @@ 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_LANGUAGES, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit } from "./toolkitSettings.js";
+import { DEFAULT_HOUR_CYCLE, DEFAULT_CURRENCY, DEFAULT_LANGUAGES, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit } from "./toolkitSettings.js";
+import { warnUnknownProps } from "./unknownProps.js";
 const ToolkitProvider = ({
   language,
   languages,
@@ -14,13 +15,16 @@ const ToolkitProvider = ({
   translate,
   timeZone,
   currency,
+  hourCycle,
   appName,
   navigation,
   buildId,
   canAccess,
   fileTypes,
-  children
+  children,
+  ...unknownProps
 }) => {
+  warnUnknownProps("ToolkitProvider", unknownProps);
   const parent = useContext(ToolkitContext);
   const settings = useMemo(() => ({
     language: language ?? parent?.language ?? DEFAULT_LANGUAGE,
@@ -30,12 +34,28 @@ const ToolkitProvider = ({
     translate: translate ?? parent?.translate ?? null,
     timeZone: timeZone ?? parent?.timeZone ?? browserTimeZone(),
     currency: currency ?? parent?.currency ?? DEFAULT_CURRENCY,
+    hourCycle: hourCycle ?? parent?.hourCycle ?? DEFAULT_HOUR_CYCLE,
     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]);
+  }), [
+    parent,
+    language,
+    languages,
+    onLanguageChange,
+    texts,
+    translate,
+    timeZone,
+    currency,
+    hourCycle,
+    appName,
+    navigation,
+    buildId,
+    canAccess,
+    fileTypes
+  ]);
   if (!parent) {
     configureToolkit({
       language: settings.language,
@@ -43,6 +63,7 @@ const ToolkitProvider = ({
       translate: settings.translate,
       timeZone: settings.timeZone,
       currency: settings.currency,
+      hourCycle: settings.hourCycle,
       appName: settings.appName,
       buildId: settings.buildId,
       languages: settings.languages

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// 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;"}
+{"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_HOUR_CYCLE, DEFAULT_LANGUAGE, DEFAULT_LANGUAGES, browserTimeZone, configureToolkit} from '@/toolkit/toolkitSettings.js';\nimport {warnUnknownProps} from '@/toolkit/unknownProps.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 {'h23'|'h12'} [props.hourCycle] la hora de 24 horas («15:10», por omisión) o de 12 con a.m. y p.m. («3:10 p.m.»):\n *     HOUR_CYCLE.twentyFourHours o HOUR_CYCLE.twelveHours\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, hourCycle, appName, navigation, buildId, canAccess, fileTypes,\n    children,\n    ...unknownProps\n}) => {\n    warnUnknownProps('ToolkitProvider', unknownProps);\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        hourCycle: hourCycle ?? parent?.hourCycle ?? DEFAULT_HOUR_CYCLE,\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, hourCycle, appName, navigation, buildId, canAccess,\n        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            hourCycle: settings.hourCycle, 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":";;;;;;;;;AAgDO,MAAM,kBAAkB,CAAC;AAAA,EAC5B;AAAA,EAAU;AAAA,EAAW;AAAA,EAAkB;AAAA,EAAO;AAAA,EAAW;AAAA,EAAU;AAAA,EAAU;AAAA,EAAW;AAAA,EAAS;AAAA,EAAY;AAAA,EAAS;AAAA,EAAW;AAAA,EACjI;AAAA,EACA,GAAG;AACP,MAAM;AACF,mBAAiB,mBAAmB,YAAY;AAEhD,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,WAAW,aAAa,QAAQ,aAAa;AAAA,IAC7C,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;AAAA,IAAC;AAAA,IAAQ;AAAA,IAAU;AAAA,IAAW;AAAA,IAAkB;AAAA,IAAO;AAAA,IAAW;AAAA,IAAU;AAAA,IAAU;AAAA,IAAW;AAAA,IAAS;AAAA,IAAY;AAAA,IAAS;AAAA,IAC/H;AAAA,EAAA,CAAU;AAKd,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,WAAW,SAAS;AAAA,MAAW,SAAS,SAAS;AAAA,MAAS,SAAS,SAAS;AAAA,MAAS,WAAW,SAAS;AAAA,IAAA,CAC5G;AAAA,EACL;AAIA,cAAA;AAEA,6BAAQ,eAAe,UAAf,EAAwB,OAAO,UAAW,UAAS;AAC/D;"}

package/dist/toolkit/toolkitContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolkitContext.js","sources":["../../src/toolkit/toolkitContext.js"],"sourcesContent":["// El contexto de ToolkitProvider y los hooks que lo leen. Vive aparte del proveedor (que es .jsx) para que los hooks se\n// importen desde archivos .js sin arrastrar JSX.\n//\n// Hooks genéricos: function (regla de la casa).\nimport {createContext, useContext} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nexport const ToolkitContext = createContext(null);\n\n/**\n * La configuración del proveedor; sin proveedor, la vigente con la navegación del navegador.\n *\n * @returns {{language: string, onLanguageChange: Function|null, texts: object, translate: Function|null, timeZone: string, currency: string, appName: string, buildId: string, navigation: object, canAccess: Function}}\n */\nexport function useToolkitSettings() {\n    const settings = useContext(ToolkitContext);\n\n    return settings ?? {...toolkitSettings(), onLanguageChange: null, navigation: browserNavigation, canAccess: allowOnlyUnrestricted};\n}\n\n/**\n * La navegación que conectó el proyecto: {useNavigate, useLocation, Link}.\n *\n * @returns {{useNavigate: Function, useLocation: Function, Link: import('react').ElementType}}\n */\nexport function useToolkitNavigation() {\n    return useToolkitSettings().navigation;\n}\n"],"names":[],"mappings":";;;;;AASY,MAAC,iBAAiB,cAAc,IAAI;AAOzC,SAAS,qBAAqB;AACjC,QAAM,WAAW,WAAW,cAAc;AAE1C,SAAO,YAAY,EAAC,GAAG,mBAAmB,kBAAkB,MAAM,YAAY,mBAAmB,WAAW,sBAAqB;AACrI;AAOO,SAAS,uBAAuB;AACnC,SAAO,mBAAkB,EAAG;AAChC;"}
+{"version":3,"file":"toolkitContext.js","sources":["../../src/toolkit/toolkitContext.js"],"sourcesContent":["// El contexto de ToolkitProvider y los hooks que lo leen. Vive aparte del proveedor (que es .jsx) para que los hooks se\n// importen desde archivos .js sin arrastrar JSX.\n//\n// Hooks genéricos: function (regla de la casa).\nimport {createContext, useContext} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {toolkitSettings} from '@/toolkit/toolkitSettings.js';\n\nexport const ToolkitContext = createContext(null);\n\n/**\n * La configuración del proveedor; sin proveedor, la vigente con la navegación del navegador.\n *\n * @returns {{language: string, onLanguageChange: Function|null, texts: object, translate: Function|null, timeZone: string, currency: string, hourCycle: 'h23'|'h12', appName: string, buildId: string, navigation: object, canAccess: Function}}\n */\nexport function useToolkitSettings() {\n    const settings = useContext(ToolkitContext);\n\n    return settings ?? {...toolkitSettings(), onLanguageChange: null, navigation: browserNavigation, canAccess: allowOnlyUnrestricted};\n}\n\n/**\n * La navegación que conectó el proyecto: {useNavigate, useLocation, Link}.\n *\n * @returns {{useNavigate: Function, useLocation: Function, Link: import('react').ElementType}}\n */\nexport function useToolkitNavigation() {\n    return useToolkitSettings().navigation;\n}\n"],"names":[],"mappings":";;;;;AASY,MAAC,iBAAiB,cAAc,IAAI;AAOzC,SAAS,qBAAqB;AACjC,QAAM,WAAW,WAAW,cAAc;AAE1C,SAAO,YAAY,EAAC,GAAG,mBAAmB,kBAAkB,MAAM,YAAY,mBAAmB,WAAW,sBAAqB;AACrI;AAOO,SAAS,uBAAuB;AACnC,SAAO,mBAAkB,EAAG;AAChC;"}

package/dist/toolkit/toolkitSettings.js

@@ -2,6 +2,11 @@ import es from "../locales/es.js";
 import en from "../locales/en.js";
 const DEFAULT_LANGUAGE = "es";
 const DEFAULT_CURRENCY = "MXN";
+const HOUR_CYCLE = Object.freeze({
+  twentyFourHours: "h23",
+  twelveHours: "h12"
+});
+const DEFAULT_HOUR_CYCLE = HOUR_CYCLE.twentyFourHours;
 const PACKAGE_TEXTS_BY_LANGUAGE = Object.freeze({ es, en });
 const DEFAULT_LANGUAGES = Object.freeze([
   Object.freeze({ code: "es", label: "Español", locale: "es-MX" }),
@@ -21,6 +26,8 @@ let currentSettings = Object.freeze({
   translate: null,
   timeZone: browserTimeZone(),
   currency: DEFAULT_CURRENCY,
+  // la hora de 24 o de 12 horas (HOUR_CYCLE)
+  hourCycle: DEFAULT_HOUR_CYCLE,
   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: "",
@@ -94,8 +101,10 @@ function translateToolkit(defaultNamespace, key, values) {
 }
 export {
   DEFAULT_CURRENCY,
+  DEFAULT_HOUR_CYCLE,
   DEFAULT_LANGUAGE,
   DEFAULT_LANGUAGES,
+  HOUR_CYCLE,
   browserTimeZone,
   componentTextOf,
   configureToolkit,

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/**\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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"}
+{"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\n/**\n * Cómo se escribe la hora: de 24 horas («15:10», la de omisión) o de 12 con a.m. y p.m. («3:10 p.m.»). Son los valores de\n * `hourCycle` de Intl, por eso se ven así.\n */\nexport const HOUR_CYCLE = Object.freeze({\n    twentyFourHours: 'h23',\n    twelveHours: 'h12',\n});\nexport const DEFAULT_HOUR_CYCLE = HOUR_CYCLE.twentyFourHours;\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    // la hora de 24 o de 12 horas (HOUR_CYCLE)\n    hourCycle: DEFAULT_HOUR_CYCLE,\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, hourCycle?: 'h23'|'h12', 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, hourCycle: 'h23'|'h12', 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/unknownProps.js

@@ -0,0 +1,33 @@
+const THEME_NAME_PREFIX = "Calcita";
+const REACT_OWN_PROPS = /* @__PURE__ */ new Set(["ref"]);
+const warnedProps = /* @__PURE__ */ new Set();
+function isDevelopmentBuild() {
+  try {
+    return process.env.NODE_ENV !== "production";
+  } catch {
+    return false;
+  }
+}
+function unknownPropMessageOf(componentName, propName) {
+  const name = componentName.startsWith(THEME_NAME_PREFIX) ? componentName.slice(THEME_NAME_PREFIX.length) : componentName;
+  return `Calcita · ${name} no conoce la opción «${propName}» y no la usa. Revise el nombre en el README o en «Hecho en Calcita».`;
+}
+function warnUnknownProps(componentName, unknownProps) {
+  if (!isDevelopmentBuild()) {
+    return;
+  }
+  for (const propName of Object.keys(unknownProps)) {
+    const warnedKey = `${componentName}.${propName}`;
+    if (REACT_OWN_PROPS.has(propName) || warnedProps.has(warnedKey)) {
+      continue;
+    }
+    warnedProps.add(warnedKey);
+    console.warn(unknownPropMessageOf(componentName, propName));
+  }
+}
+export {
+  isDevelopmentBuild,
+  unknownPropMessageOf,
+  warnUnknownProps
+};
+//# sourceMappingURL=unknownProps.js.map

package/dist/toolkit/unknownProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknownProps.js","sources":["../../src/toolkit/unknownProps.js"],"sourcesContent":["// Avisa en la consola, mientras se programa, cuando una pieza de la casa recibe una opción que no conoce.\n//\n// Por qué existe: React descarta sin decir nada lo que un componente no lee. Al pasar a Calcita las pantallas de un sistema que\n// ya existía, las opciones con otro nombre (countNoun en lugar de countLabel, label en lugar de ariaLabelOf) se perdieron en\n// silencio: la pantalla abría bien, pero sin esos textos, y solo las encontró una comparación de textos de punta a punta.\n//\n// Cómo se usa: cada pieza junta lo que no conoce con «...unknownProps» al leer sus props y se lo pasa a warnUnknownProps:\n//\n//   const {columns, fetchPage, ...unknownProps} = usePieceProps(props, THEME_NAME);\n//   warnUnknownProps(THEME_NAME, unknownProps);\n//\n// Solo avisa en desarrollo (en producción no hace nada) y una vez por pieza y opción, no en cada render.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\n\n// el prefijo de los nombres de las piezas en el tema (CalcitaServerTable): el aviso dice solo el del componente\nconst THEME_NAME_PREFIX = 'Calcita';\n// React 19 manda `ref` como un prop más: no es una opción de la pieza\nconst REACT_OWN_PROPS = new Set(['ref']);\n// las que ya se avisaron («ServerTable.countNoun»): el aviso sale una vez, no en cada render\nconst warnedProps = new Set();\n\n/**\n * ¿Se está programando? Los empaquetadores (Vite, Next) cambian process.env.NODE_ENV por su valor al construir la app. Una\n * página sin empaquetador no tiene `process`: se toma como producción y no se avisa.\n *\n * @returns {boolean}\n */\nexport function isDevelopmentBuild() {\n    try {\n        return process.env.NODE_ENV !== 'production';\n    } catch {\n        return false;\n    }\n}\n\n/**\n * El aviso de una opción que la pieza no conoce.\n *\n * @param {string} componentName el nombre de la pieza en el tema («CalcitaServerTable») o el del componente\n * @param {string} propName\n * @returns {string}\n */\nexport function unknownPropMessageOf(componentName, propName) {\n    const name = componentName.startsWith(THEME_NAME_PREFIX) ? componentName.slice(THEME_NAME_PREFIX.length) : componentName;\n    return `Calcita · ${name} no conoce la opción «${propName}» y no la usa. Revise el nombre en el README o en «Hecho en Calcita».`;\n}\n\n/**\n * Avisa (solo en desarrollo, una vez por pieza y opción) de cada opción que la pieza no leyó.\n *\n * @param {string} componentName el nombre de la pieza en el tema («CalcitaServerTable») o el del componente\n * @param {object} unknownProps lo que quedó después de leer las opciones que la pieza conoce\n * @returns {void}\n */\nexport function warnUnknownProps(componentName, unknownProps) {\n    if (!isDevelopmentBuild()) {\n        return;\n    }\n    for (const propName of Object.keys(unknownProps)) {\n        const warnedKey = `${componentName}.${propName}`;\n        if (REACT_OWN_PROPS.has(propName) || warnedProps.has(warnedKey)) {\n            continue;\n        }\n        warnedProps.add(warnedKey);\n        console.warn(unknownPropMessageOf(componentName, propName));\n    }\n}\n"],"names":[],"mappings":"AAgBA,MAAM,oBAAoB;AAE1B,MAAM,kBAAkB,oBAAI,IAAI,CAAC,KAAK,CAAC;AAEvC,MAAM,cAAc,oBAAI,IAAG;AAQpB,SAAS,qBAAqB;AACjC,MAAI;AACA,WAAO,QAAQ,IAAI,aAAa;AAAA,EACpC,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AASO,SAAS,qBAAqB,eAAe,UAAU;AAC1D,QAAM,OAAO,cAAc,WAAW,iBAAiB,IAAI,cAAc,MAAM,kBAAkB,MAAM,IAAI;AAC3G,SAAO,aAAa,IAAI,yBAAyB,QAAQ;AAC7D;AASO,SAAS,iBAAiB,eAAe,cAAc;AAC1D,MAAI,CAAC,mBAAkB,GAAI;AACvB;AAAA,EACJ;AACA,aAAW,YAAY,OAAO,KAAK,YAAY,GAAG;AAC9C,UAAM,YAAY,GAAG,aAAa,IAAI,QAAQ;AAC9C,QAAI,gBAAgB,IAAI,QAAQ,KAAK,YAAY,IAAI,SAAS,GAAG;AAC7D;AAAA,IACJ;AACA,gBAAY,IAAI,SAAS;AACzB,YAAQ,KAAK,qBAAqB,eAAe,QAAQ,CAAC;AAAA,EAC9D;AACJ;"}

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

@@ -12,7 +12,7 @@
  * @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, texts, }: {
+export default function AuditTrailTable({ subjectKey, fetchPage, eventDictionary, resultDictionary, extraColumns, ariaLabel, maxGridHeight, refreshToken, eventSuffixOf, texts, ...unknownProps }: {
     subjectKey: string;
     fetchPage: (tableRequest: object, signal: AbortSignal) => Promise<{
         rows: any[];

package/dist/types/DataTable/ColumnFilters/TextColumnFilter.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {{value: string, onChange: (value: string) => void, label?: string}} props label ya traducido
  */
-export default function TextColumnFilter({ value, onChange, label }: {
+export default function TextColumnFilter({ value, onChange, label, ...unknownProps }: {
     value: string;
     onChange: (value: string) => void;
     label?: string;

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

@@ -74,9 +74,11 @@ export declare function facetColumn({ field, label, facetKey, renderOption, sort
  * Columna de acción al final de la fila: un icono que abre el detalle (la ruta propia del renglón). Un icono y no la
  * fila entera a propósito: la fila como botón se dispara al seleccionar texto y no se ve que se puede abrir.
  *
+ * El globo del icono se cambia con los textos de la tabla (ServerTable texts={{detail: {tooltip: '…'}}}), no aquí.
+ *
  * @param {{onOpen: (row: any) => void, ariaLabelOf?: (row: any) => string}} declaration ariaLabelOf ya traducido
  */
-export declare function detailColumn({ onOpen, ariaLabelOf }: {
+export declare function detailColumn({ onOpen, ariaLabelOf, ...unknownOptions }: {
     onOpen: (row: any) => void;
     ariaLabelOf?: (row: any) => string;
 }): {

package/dist/types/access/Can.d.ts

@@ -4,7 +4,7 @@
  * @param {import('react').ReactNode} props.children
  * @param {import('react').ReactNode} [props.fallback] lo que se pinta si no puede; por omisión nada
  */
-export default function Can({ access, children, fallback }: {
+export default function Can({ access, children, fallback, ...unknownProps }: {
     access: object;
     children: import('react').ReactNode;
     fallback?: import('react').ReactNode;

package/dist/types/access/RequireAccess.d.ts

@@ -4,7 +4,7 @@
  * @param {import('react').ReactNode} props.children
  * @param {import('react').ReactNode} [props.fallback] lo que se ve sin permiso; por omisión la página de 403
  */
-export default function RequireAccess({ access, children, fallback }: {
+export default function RequireAccess({ access, children, fallback, ...unknownProps }: {
     access?: object;
     children: import('react').ReactNode;
     fallback?: import('react').ReactNode;

package/dist/types/account/AccountProvider.d.ts

@@ -8,7 +8,7 @@
  * @param {(canAccess: (access: object|null|undefined) => boolean) => import('react').ReactNode} props.children recibe la
  *     regla de permisos de la sesión
  */
-export default function AccountProvider({ connector, refreshKey, initialSession, children }: {
+export default function AccountProvider({ connector, refreshKey, initialSession, children, ...unknownProps }: {
     connector: import('./accountConnector.js').AccountConnector;
     refreshKey?: unknown;
     initialSession?: import('./accountConnector.js').AccountSession | null;

package/dist/types/account/ForgotPasswordScreen.d.ts

@@ -7,7 +7,7 @@
  * @param {boolean} [props.showColorSchemeToggle]
  * @param {object} [props.texts] los textos que cambian, con la forma de `auth` en los textos del paquete
  */
-export default function ForgotPasswordScreen({ signInPath, logo, brandName, showLanguageToggle, showColorSchemeToggle, texts }: {
+export default function ForgotPasswordScreen({ signInPath, logo, brandName, showLanguageToggle, showColorSchemeToggle, texts, ...unknownProps }: {
     signInPath?: string;
     logo?: import('react').ReactNode;
     brandName?: string;

package/dist/types/account/ResetPasswordScreen.d.ts

@@ -9,7 +9,7 @@
  * @param {boolean} [props.showColorSchemeToggle]
  * @param {object} [props.texts] los textos que cambian, con la forma de `account` en los textos del paquete
  */
-export default function ResetPasswordScreen({ signInPath, forgotPasswordPath, tokenParam, logo, brandName, showLanguageToggle, showColorSchemeToggle, texts, }: {
+export default function ResetPasswordScreen({ signInPath, forgotPasswordPath, tokenParam, logo, brandName, showLanguageToggle, showColorSchemeToggle, texts, ...unknownProps }: {
     signInPath: string;
     forgotPasswordPath?: string;
     tokenParam?: string;

package/dist/types/appShell/MenuLinks.d.ts

@@ -3,7 +3,7 @@
  * @param {Array<{to?: string, href?: string, onClick?: Function, label?: string, labelKey?: string, Icon?: import('react').ElementType, icon?: import('react').ReactNode}>} props.links
  * @param {() => void} props.onClose cierra el menú al elegir
  */
-export default function MenuLinks({ links, onClose }: {
+export default function MenuLinks({ links, onClose, ...unknownProps }: {
     links: Array<{
         to?: string;
         href?: string;

package/dist/types/appShell/pageTitle.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {{children: import('react').ReactNode}} props
  */
-export declare function PageTitleProvider({ children }: {
+export declare function PageTitleProvider({ children, ...unknownProps }: {
     children: import('react').ReactNode;
 }): import("react").JSX.Element;
 /**

package/dist/types/datePickers/DateInput.d.ts

@@ -19,7 +19,7 @@ export declare const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
  * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function DateInput({ name, label, value, onChange, onBlur, error, helperText, minDate, maxDate, disableFuture, disablePast, openTo, disabled, inputRef, texts, }: {
+export default function DateInput({ name, label, value, onChange, onBlur, error, helperText, minDate, maxDate, disableFuture, disablePast, openTo, disabled, inputRef, texts, ...unknownProps }: {
     name?: string;
     label: string;
     value: string | null | undefined;

package/dist/types/downloads/DownloadManager.d.ts

@@ -2,6 +2,6 @@
  * @param {object} [props]
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function DownloadManager({ texts }?: {
+export default function DownloadManager({ texts, ...unknownProps }?: {
     texts?: object;
 }): import("react").JSX.Element;

package/dist/types/formatting.d.ts

@@ -2,7 +2,7 @@
  * Los formatos con la configuración que da settingsOf (se lee en cada llamada: si cambia el idioma, el siguiente formato ya
  * sale en el nuevo).
  *
- * @param {() => {language: string, languages?: Array<{code: string, locale?: string}>, timeZone: string, currency: string}} settingsOf
+ * @param {() => {language: string, languages?: Array<{code: string, locale?: string}>, timeZone: string, currency: string, hourCycle?: 'h23'|'h12'}} settingsOf
  */
 export declare function formattersOf(settingsOf: () => {
     language: string;
@@ -12,6 +12,7 @@ export declare function formattersOf(settingsOf: () => {
     }>;
     timeZone: string;
     currency: string;
+    hourCycle?: 'h23' | 'h12';
 }): Readonly<{
     formatNumber: (value: number | string | null | undefined, fallback?: string) => string;
     formatList: (items: string[]) => string;

package/dist/types/forms/FormProblemAlert.d.ts

@@ -1,6 +1,6 @@
 /**
  * @param {{sx?: object}} props
  */
-export default function FormProblemAlert({ sx }: {
+export default function FormProblemAlert({ sx, ...unknownProps }: {
     sx?: object;
 }): import("react").JSX.Element | null;

package/dist/types/forms/FormServerProblem.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {{error: (Error & {problem?: object})|null}} props el error del contexto de la máquina (null = sin error)
  */
-export default function FormServerProblem({ error }: {
+export default function FormServerProblem({ error, ...unknownProps }: {
     error: (Error & {
         problem?: object;
     }) | null;

package/dist/types/forms/FormWizard.d.ts

@@ -9,7 +9,7 @@
  * @param {string} props.submitLabel ya traducido: el botón del último paso
  * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {wizard: {next, back, skip, optional, skipped, stepOf}}
  */
-export default function FormWizard({ steps, submitLabel, texts }: {
+export default function FormWizard({ steps, submitLabel, texts, ...unknownProps }: {
     steps: {
         key: string;
         label: string;

package/dist/types/forms/auth/ChangePasswordForm.d.ts

@@ -6,7 +6,7 @@
  * @param {object} [props.policy] las reglas de la nueva; por omisión DEFAULT_PASSWORD_POLICY
  * @param {object} [props.texts] los textos que cambian, con la forma de `auth` en los textos del paquete
  */
-export default function ChangePasswordForm({ onSubmit, requireCurrentPassword, policy, texts }: {
+export default function ChangePasswordForm({ onSubmit, requireCurrentPassword, policy, texts, ...unknownProps }: {
     onSubmit: (values: {
         currentPassword?: string;
         newPassword: string;

package/dist/types/forms/auth/ForgotPasswordForm.d.ts

@@ -5,7 +5,7 @@
  * @param {string} [props.signInPath] la liga para regresar a iniciar sesión
  * @param {object} [props.texts] los textos que cambian, con la forma de `auth` en los textos del paquete
  */
-export default function ForgotPasswordForm({ onSubmit, signInPath, texts }: {
+export default function ForgotPasswordForm({ onSubmit, signInPath, texts, ...unknownProps }: {
     onSubmit: (values: {
         email: string;
     }) => Promise<unknown>;

package/dist/types/hookForm/FormProblemAlert.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {{control?: object, sx?: object}} props control: el de useForm, si la pantalla no usa FormProvider
  */
-export default function FormProblemAlert({ control, sx }: {
+export default function FormProblemAlert({ control, sx, ...unknownProps }: {
     control?: object;
     sx?: object;
 }): import("react").JSX.Element | null;

package/dist/types/hookForm/FormWizard.d.ts

@@ -9,7 +9,7 @@
  * @param {string} props.submitLabel ya traducido: el botón del último paso
  * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {wizard: {next, back, skip, optional, skipped, stepOf}}
  */
-export default function FormWizard({ steps, submitLabel, texts }: {
+export default function FormWizard({ steps, submitLabel, texts, ...unknownProps }: {
     steps: {
         key: string;
         label: string;

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export { ToolkitProvider } from './toolkit/ToolkitProvider.js';
 export { useToolkitNavigation, useToolkitSettings } from './toolkit/toolkitContext.js';
 export { useToolkitTranslation } from './toolkit/useToolkitTranslation.js';
 export { default as ComponentTexts } from './toolkit/ComponentTexts.js';
-export { DEFAULT_CURRENCY, DEFAULT_LANGUAGE, DEFAULT_LANGUAGES, configureToolkit, toolkitSettings, translateToolkit } from './toolkit/toolkitSettings.js';
+export { DEFAULT_CURRENCY, DEFAULT_HOUR_CYCLE, DEFAULT_LANGUAGE, DEFAULT_LANGUAGES, HOUR_CYCLE, configureToolkit, toolkitSettings, translateToolkit, } from './toolkit/toolkitSettings.js';
 export { browserNavigation, createBrowserNavigation } from './toolkit/browserNavigation.js';
 export { createHashNavigation } from './toolkit/hashNavigation.js';
 export { default as toolkitTextsEs } from './locales/es.js';

package/dist/types/inputs/CatalogInput.d.ts

@@ -17,7 +17,7 @@
  * @param {boolean} [props.multiple] elegir varias claves
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function CatalogInput({ name, label, value, onChange, onBlur, options, formatLabel, error, helperText, loading, disabled, inputRef, placeholder, multiple, texts, }: {
+export default function CatalogInput({ name, label, value, onChange, onBlur, options, formatLabel, error, helperText, loading, disabled, inputRef, placeholder, multiple, texts, ...unknownProps }: {
     name?: string;
     label: string;
     value: string | string[] | null | undefined;

package/dist/types/inputs/FieldFrame.d.ts

@@ -6,7 +6,7 @@
  * @param {import('react').ReactNode} props.label ya traducida
  * @param {import('react').ReactNode} props.children el campo
  */
-export default function FieldFrame({ inputId, labelId, label, children }: {
+export default function FieldFrame({ inputId, labelId, label, children, ...unknownProps }: {
     inputId: string;
     labelId?: string;
     label: import('react').ReactNode;

package/dist/types/inputs/NumberInput.d.ts

@@ -16,7 +16,7 @@
  * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function NumberInput({ name, label, value, onChange, onBlur, error, helperText, decimals, allowNegative, prefix, suffix, maxDigits, disabled, inputRef, texts, }: {
+export default function NumberInput({ name, label, value, onChange, onBlur, error, helperText, decimals, allowNegative, prefix, suffix, maxDigits, disabled, inputRef, texts, ...unknownProps }: {
     name?: string;
     label: string;
     value: string | number | null | undefined;

package/dist/types/inputs/TextInput.d.ts

@@ -7,7 +7,8 @@
  * @param {() => void} [props.onBlur]
  * @param {string|{key: string, values?: object}} [props.error] el error a enseñar (undefined = sin error)
  * @param {string} [props.type] 'password' agrega el ojo
- * @param {string} [props.helperText] ayuda fija; el error la reemplaza
+ * @param {string} [props.helperText] ayuda fija; el error la reemplaza. Por omisión el campo deja su renglón vacío para que
+ *     no brinque al salir un error; con helperText="" no lo deja (un campo con botones al lado en el mismo renglón)
  * @param {string} [props.placeholder] ya traducido; el ejemplo de qué escribir (se va al escribir)
  * @param {import('react').ReactNode} [props.startAdornment]
  * @param {import('react').ReactNode} [props.endAdornment] adorno al final (en contraseñas manda el ojo)

package/dist/types/pwa/InstallAppSetting.d.ts

@@ -2,6 +2,6 @@
  * @param {object} [props]
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function InstallAppSetting({ texts }?: {
+export default function InstallAppSetting({ texts, ...unknownProps }?: {
     texts?: object;
 }): import("react").JSX.Element | null;

package/dist/types/theme/createToolkitTheme.d.ts

@@ -46,7 +46,7 @@ export declare const TOP_BAR: Readonly<{
  * @param {object} [options.overrides] cualquier otra cosa de createTheme (breakpoints, spacing…)
  * @returns {object} el tema de MUI
  */
-export declare function createToolkitTheme({ colorSchemes, colorSchemeSelector, fontFamily, glass, look, bar, minimalTones, fields, cssTokens, components, overrides, }?: {
+export declare function createToolkitTheme({ colorSchemes, colorSchemeSelector, fontFamily, glass, look, bar, minimalTones, fields, cssTokens, components, overrides, ...unknownOptions }?: {
     colorSchemes?: {
         light?: object | boolean;
         dark?: object | boolean;

package/dist/types/toolkit/ComponentTexts.d.ts

@@ -4,7 +4,7 @@
  * @param {object} [props.texts] los textos que cambian, con la forma de ese namespace
  * @param {import('react').ReactNode} props.children
  */
-export default function ComponentTexts({ namespace, texts, children }: {
+export default function ComponentTexts({ namespace, texts, children, ...unknownProps }: {
     namespace: string;
     texts?: object;
     children: import('react').ReactNode;

package/dist/types/toolkit/ToolkitProvider.d.ts

@@ -12,6 +12,8 @@
  *     proyecto (por ejemplo i18next); undefined deja el texto del paquete
  * @param {string} [props.timeZone] zona de las fechas (por omisión la del navegador)
  * @param {string} [props.currency] moneda de los montos, código ISO 4217 (por omisión MXN)
+ * @param {'h23'|'h12'} [props.hourCycle] la hora de 24 horas («15:10», por omisión) o de 12 con a.m. y p.m. («3:10 p.m.»):
+ *     HOUR_CYCLE.twentyFourHours o HOUR_CYCLE.twelveHours
  * @param {string} [props.appName] nombre de la aplicación para el título de la pestaña
  * @param {object} [props.navigation] {useNavigate, useLocation, Link}; por omisión la del navegador
  * @param {string} [props.buildId] la compilación del front que corre en esta pestaña; con ella NewBuildNotice sabe si el
@@ -21,7 +23,7 @@
  *     tiene regla
  * @param {import('react').ReactNode} props.children
  */
-export declare const ToolkitProvider: ({ language, languages, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess, fileTypes, children, }: {
+export declare const ToolkitProvider: ({ language, languages, onLanguageChange, texts, translate, timeZone, currency, hourCycle, appName, navigation, buildId, canAccess, fileTypes, children, ...unknownProps }: {
     language?: string;
     languages?: Array<{
         code: string;
@@ -39,6 +41,7 @@ export declare const ToolkitProvider: ({ language, languages, onLanguageChange,
     translate?: (namespace: string, key: string, values?: object) => string | undefined;
     timeZone?: string;
     currency?: string;
+    hourCycle?: 'h23' | 'h12';
     appName?: string;
     navigation?: object;
     buildId?: string;

package/dist/types/toolkit/toolkitContext.d.ts

@@ -2,7 +2,7 @@ export declare const ToolkitContext: import("react").Context<null>;
 /**
  * La configuración del proveedor; sin proveedor, la vigente con la navegación del navegador.
  *
- * @returns {{language: string, onLanguageChange: Function|null, texts: object, translate: Function|null, timeZone: string, currency: string, appName: string, buildId: string, navigation: object, canAccess: Function}}
+ * @returns {{language: string, onLanguageChange: Function|null, texts: object, translate: Function|null, timeZone: string, currency: string, hourCycle: 'h23'|'h12', appName: string, buildId: string, navigation: object, canAccess: Function}}
  */
 export declare function useToolkitSettings(): {
     language: string;
@@ -11,6 +11,7 @@ export declare function useToolkitSettings(): {
     translate: Function | null;
     timeZone: string;
     currency: string;
+    hourCycle: 'h23' | 'h12';
     appName: string;
     buildId: string;
     navigation: object;