@stackcraftmx/calcita 0.30.1 → 0.32.0

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/appShell/shellSizes.d.ts

@@ -14,7 +14,9 @@ export declare const GLASS_PANEL_GAP_PIXELS = 8;
 /**
  * Teléfono o escritorio. Teléfono: angosto (menos de 900 px, el «md» de MUI) O bajito (menos de 500 px de alto: un teléfono
  * acostado). Solo con el ancho, un iPhone Pro Max acostado (932 × 430) salía con el marco de escritorio y su menú lateral
- * no cabía (lo reportaron). Van como media queries para usarse en sx: [PHONE_MEDIA_QUERY]: {...}.
+ * no cabía (lo reportaron). Van como media queries para usarse en sx: [PHONE_MEDIA_QUERY]: {...}. Se exportan: un proyecto que
+ * ajusta una pieza del marco desde su tema (solo en escritorio o solo en el teléfono) usa la misma regla que el marco y no
+ * una copia que se le pueda desfasar.
  */
 export declare const PHONE_MEDIA_QUERY = "@media (max-width: 899.95px), (max-height: 499.95px)";
 export declare const DESKTOP_MEDIA_QUERY = "@media (min-width: 900px) and (min-height: 500px)";

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';
@@ -29,7 +29,7 @@ export { BAR_CAPSULE_HEIGHT_PIXELS, default as BarCapsule } from './appShell/Bar
 export { usesMobileTabBar } from './appShell/tabBarRule.js';
 export { SettingSection, default as AppearanceSettings } from './appShell/AppearanceSettings.js';
 export { barMenuPlacementOf } from './appShell/barMenuPlacement.js';
-export { DRAWER_WIDTH_COLLAPSED, DRAWER_WIDTH_EXPANDED, MAIN_CONTENT_ID } from './appShell/shellSizes.js';
+export { DESKTOP_MEDIA_QUERY, DRAWER_WIDTH_COLLAPSED, DRAWER_WIDTH_EXPANDED, MAIN_CONTENT_ID, PHONE_MEDIA_QUERY } from './appShell/shellSizes.js';
 export { useAppMenu } from './appShell/appMenuContext.js';
 export { usePageTitle } from './appShell/pageTitle.js';
 export { initialsOf, menuItemDescriptionOf, menuItemLabelOf, menuItemSectionOf, menuSectionsOf } from './appShell/menuItemText.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/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;

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

@@ -1,5 +1,14 @@
 export declare const DEFAULT_LANGUAGE = "es";
 export declare const DEFAULT_CURRENCY = "MXN";
+/**
+ * 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
+ * `hourCycle` de Intl, por eso se ven así.
+ */
+export declare const HOUR_CYCLE: Readonly<{
+    twentyFourHours: "h23";
+    twelveHours: "h12";
+}>;
+export declare const DEFAULT_HOUR_CYCLE: "h23";
 /**
  * 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
  * lo habla) y cómo se escriben sus números y fechas (Intl). El proyecto agrega los suyos en ToolkitProvider `languages` y pone
@@ -24,7 +33,7 @@ export declare function browserTimeZone(): string;
  * Cambia la configuración que leen las funciones del paquete. La llama ToolkitProvider; un proyecto sin React (o una
  * prueba) la puede llamar directo.
  *
- * @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
+ * @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
  * @returns {void}
  */
 export declare function configureToolkit(settings: {
@@ -33,6 +42,7 @@ export declare function configureToolkit(settings: {
     translate?: Function | null;
     timeZone?: string;
     currency?: string;
+    hourCycle?: 'h23' | 'h12';
     appName?: string;
     buildId?: string;
     languages?: Array<{
@@ -44,7 +54,7 @@ export declare function configureToolkit(settings: {
 /**
  * La configuración vigente.
  *
- * @returns {{language: string, texts: object, translate: Function|null, timeZone: string, currency: string, appName: string, buildId: string, languages: Array<{code: string, label: string, locale?: string}>}}
+ * @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}>}}
  */
 export declare function toolkitSettings(): {
     language: string;
@@ -52,6 +62,7 @@ export declare function toolkitSettings(): {
     translate: Function | null;
     timeZone: string;
     currency: string;
+    hourCycle: 'h23' | 'h12';
     appName: string;
     buildId: string;
     languages: Array<{

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

@@ -0,0 +1,23 @@
+/**
+ * ¿Se está programando? Los empaquetadores (Vite, Next) cambian process.env.NODE_ENV por su valor al construir la app. Una
+ * página sin empaquetador no tiene `process`: se toma como producción y no se avisa.
+ *
+ * @returns {boolean}
+ */
+export declare function isDevelopmentBuild(): boolean;
+/**
+ * El aviso de una opción que la pieza no conoce.
+ *
+ * @param {string} componentName el nombre de la pieza en el tema («CalcitaServerTable») o el del componente
+ * @param {string} propName
+ * @returns {string}
+ */
+export declare function unknownPropMessageOf(componentName: string, propName: string): string;
+/**
+ * Avisa (solo en desarrollo, una vez por pieza y opción) de cada opción que la pieza no leyó.
+ *
+ * @param {string} componentName el nombre de la pieza en el tema («CalcitaServerTable») o el del componente
+ * @param {object} unknownProps lo que quedó después de leer las opciones que la pieza conoce
+ * @returns {void}
+ */
+export declare function warnUnknownProps(componentName: string, unknownProps: object): void;

package/dist/types/ui/actions/CopyButton.d.ts

@@ -6,7 +6,7 @@
  * @param {() => void} [props.onCopied]
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function CopyButton({ value, label, size, onCopied, texts }: {
+export default function CopyButton({ value, label, size, onCopied, texts, ...unknownProps }: {
     value: string;
     label?: string;
     size?: 'small' | 'medium';

package/dist/types/ui/actions/SecretField.d.ts

@@ -7,7 +7,7 @@
  * @param {(isRevealed: boolean) => void} [props.onRevealChange] se destapó o se tapó (para registrar quién vio el secreto)
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function SecretField({ value, label, helperText, onCopied, onRevealChange, texts }: {
+export default function SecretField({ value, label, helperText, onCopied, onRevealChange, texts, ...unknownProps }: {
     value: string;
     label: string;
     helperText?: string;

package/dist/types/ui/labels/DictionaryText.d.ts

@@ -1,7 +1,7 @@
 /**
  * @param {{dictionary: Record<string, object>, value: string|null|undefined}} props
  */
-export default function DictionaryText({ dictionary, value }: {
+export default function DictionaryText({ dictionary, value, ...unknownProps }: {
     dictionary: Record<string, object>;
     value: string | null | undefined;
 }): string;

package/dist/types/ui/layout/FullPageLoader.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 FullPageLoader({ texts }?: {
+export default function FullPageLoader({ texts, ...unknownProps }?: {
     texts?: object;
 }): import("react").JSX.Element;