@stackcraftmx/calcita 0.32.2 → 0.51.0

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\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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"}
+{"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 {createLogger} from '@/observability/logger.js';\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    // a quién avisarle de un texto que no existe (reportMissingText); sin él, un aviso en la consola\n    onMissingText: null,\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}>, onMissingText?: Function|null}} 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, onMissingText?: 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. Con `defaultValue` el texto es opcional: si no\n *     existe se usa ese y no se avisa\n * @returns {string} la llave misma si no hay texto, para que se note qué falta (y se avisa: reportMissingText)\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    reportMissingText(settings, namespace, plainKey);\n    return `${namespace}${NAMESPACE_SEPARATOR}${plainKey}`;\n}\n\nconst log = createLogger('texts');\n// los textos que faltan de los que ya se avisó en la consola: uno por idioma y llave, no uno por cada pintada\nconst warnedMissingTexts = new Set();\n\n/**\n * Avisa que un texto no existe. Sin aviso, la pantalla enseñaba la llave («profile:tabs.documents») y nadie se enteraba\n * hasta verla. Con onMissingText del proyecto (ToolkitProvider) se le avisa a él cada vez y decide (mandarlo a Sentry,\n * tronar una prueba); sin él, un aviso en la consola, una sola vez por idioma y llave (el nivel lo pone setLogLevel).\n *\n * @param {{language: string, onMissingText?: Function|null}} settings\n * @param {string} namespace\n * @param {string} key\n * @returns {void}\n */\nfunction reportMissingText(settings, namespace, key) {\n    if (settings.onMissingText) {\n        settings.onMissingText({namespace, key, language: settings.language});\n        return;\n    }\n    const missingId = `${settings.language}${NAMESPACE_SEPARATOR}${namespace}${NAMESPACE_SEPARATOR}${key}`;\n    if (warnedMissingTexts.has(missingId)) {\n        return;\n    }\n    warnedMissingTexts.add(missingId);\n    log.warn(`No hay texto para «${namespace}${NAMESPACE_SEPARATOR}${key}» en «${settings.language}»: la pantalla enseña la llave`);\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/types/DataTable/AuditTrailDialog.d.ts

@@ -1,19 +1,4 @@
-/**
- * @param {object} props
- * @param {boolean} props.open
- * @param {() => void} props.onClose
- * @param {string} props.title ya traducido («Historial de Q3 · ago 2026»)
- * @param {import('react').ReactNode} [props.subtitle]
- * @param {string} props.subjectKey
- * @param {(tableRequest: object, signal: AbortSignal) => Promise<{rows: Array, total: number, facets?: object}>} props.fetchPage
- * @param {Record<string, object>} props.eventDictionary
- * @param {Record<string, object>} [props.resultDictionary]
- * @param {Array<object>} [props.extraColumns]
- * @param {import('react').ReactNode} [props.header] va entre el subtítulo y la tabla (p. ej. pestañas que cambian lo que se
- *     consulta)
- * @param {(row: any) => string|null} [props.eventSuffixOf] complemento del evento de un renglón (AuditTrailTable)
- */
-export default function AuditTrailDialog(props: {
+declare const AuditTrailDialog: (props: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -29,4 +14,8 @@ export default function AuditTrailDialog(props: {
     extraColumns?: Array<object>;
     header?: import('react').ReactNode;
     eventSuffixOf?: (row: any) => string | null;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default AuditTrailDialog;

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

@@ -1,8 +1,9 @@
-/**
- * @param {{activeCount?: number, onClear: () => void, children: import('react').ReactNode}} props children = el filtro
- */
-export default function HeaderFilterPopover(props: {
+declare const HeaderFilterPopover: (props: {
     activeCount?: number;
     onClear: () => void;
     children: import('react').ReactNode;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default HeaderFilterPopover;

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

@@ -1,11 +1,4 @@
-/**
- * @param {object} props
- * @param {string[]} [props.value]
- * @param {(value: string[]) => void} props.onChange
- * @param {Array<{value: string, total: number}>} [props.options] faceta del servidor
- * @param {(value: string) => import('react').ReactNode} [props.renderOption] cómo se lee el valor (diccionario)
- */
-export default function MultiSelectColumnFilter(props: {
+declare const MultiSelectColumnFilter: (props: {
     value?: string[];
     onChange: (value: string[]) => void;
     options?: Array<{
@@ -13,4 +6,8 @@ export default function MultiSelectColumnFilter(props: {
         total: number;
     }>;
     renderOption?: (value: string) => import('react').ReactNode;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default MultiSelectColumnFilter;

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

@@ -1,16 +1,4 @@
-/**
- * @param {object} props
- * @param {string} props.label
- * @param {boolean} [props.sortable]
- * @param {{column: string, direction: 'asc'|'desc'}} [props.sortEntry]
- * @param {() => void} [props.onSort]
- * @param {() => void} [props.onClearSort]
- * @param {boolean} [props.filterable]
- * @param {number} [props.activeCount]
- * @param {() => void} [props.onClear]
- * @param {import('react').ReactNode} [props.children] el filtro de la columna
- */
-export default function SortableFilterHeader(props: {
+declare const SortableFilterHeader: (props: {
     label: string;
     sortable?: boolean;
     sortEntry?: {
@@ -23,4 +11,8 @@ export default function SortableFilterHeader(props: {
     activeCount?: number;
     onClear?: () => void;
     children?: import('react').ReactNode;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default SortableFilterHeader;

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

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

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

@@ -1,17 +1,12 @@
-/**
- * @param {object} props
- * @param {Array<object>} props.chipConfig lo que arma buildChipConfig
- * @param {object} props.filters
- * @param {(field: string, value: unknown) => void} props.onSetFilter
- * @param {() => void} props.onClearAll
- * @param {number} [props.quickActiveCount] accesos rápidos puestos que no tienen chip aquí
- * @param {object} [props.texts] los textos que cambian, con la forma de `table` en los textos del paquete
- */
-export default function FilterChips(props: {
+declare const FilterChips: (props: {
     chipConfig: Array<object>;
     filters: object;
     onSetFilter: (field: string, value: unknown) => void;
     onClearAll: () => void;
     quickActiveCount?: number;
     texts?: object;
-}): import("react").JSX.Element | null;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element | null;
+export default FilterChips;

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

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

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

@@ -1,83 +1,7 @@
 import { SELECTION_PHONE_LAYOUT } from '../ui/actions/SelectionActions.js';
 export { SELECTION_PHONE_LAYOUT };
 export type RowSelection = import('./rowSelection.js').RowSelection;
-/** @typedef {import('./rowSelection.js').RowSelection} RowSelection */
-/**
- * @param {object} props
- * @param {(params: {filters: Record<string, any>, sortOrders: Array<{column: string, direction: 'asc'|'desc'}>, page: number, pageSize: number}, signal: AbortSignal) => Promise<{rows: any[], total: number, facets?: Record<string, Array<{value: any, total: number}> | number>, capped?: boolean}>} props.fetchPage
- *     page cuenta desde 0; toServerTableParams lo convierte a la query del API
- * @param {string} props.queryKey cambia cuando cambia el CONJUNTO (no los filtros): dispara recarga
- * @param {boolean} [props.enabled] false mientras la sección está oculta: una tabla que nadie ve no consulta
- * @param {Array<object>} props.columns textColumn / facetColumn / detailColumn o columnas del DataGrid
- * @param {Record<string, string>} [props.filterKinds]
- * @param {Record<string, unknown>} [props.filterDefaults]
- * @param {Array<object>} [props.chipConfig] buildChipConfig
- * @param {Array<object>} [props.quickFilters] {field, facetKey, caption, allLabel, renderLabel, order, clears,
- *     isOverridden, renderExtra, allCountKey, hideAllCount}
- * @param {string|null} [props.searchField] filtro de texto que se saca a la barra; null quita la caja
- * @param {string} [props.searchPlaceholder]
- * @param {boolean} [props.searchInBar] la caja de búsqueda va arriba, en la barra de la app (BarActions): en escritorio,
- *     como el buscador de una ventana de macOS; en el teléfono con cápsulas flota arriba con las demás; sin cápsulas se
- *     queda aquí. Por omisión no
- * @param {boolean} [props.collapseSearchInBar] en la barra, sin usar se encoge a la lupa y se estira al picarla; por
- *     omisión sí (false: siempre abierta)
- * @param {string} [props.emptyLabel]
- * @param {(total: number) => string} [props.countLabel] "12 pedidos"; por defecto "12 registros"
- * @param {number[]} [props.pageSizeOptions]
- * @param {number} [props.defaultPageSize]
- * @param {(row: any) => string|number} [props.getRowId]
- * @param {string} [props.prefix] estado en la URL con este prefijo (nuqs); sin él, en memoria
- * @param {unknown} [props.refreshToken] cambia para volver a consultar la misma página (después de una acción)
- * @param {(summary: {total: number, capped: boolean}) => import('react').ReactNode} [props.footer]
- * @param {import('react').ReactNode} [props.toolbarExtra] a la derecha del conteo (p. ej. el selector de año)
- * @param {(summary: {countText: string, total: number, capped: boolean}) => import('react').ReactNode} [props.header] reemplaza
- *     el renglón del conteo: la página pinta título, conteo y controles en uno solo. countText ya viene traducido y con
- *     el tope
- * @param {import('react').ReactNode} [props.beforeQuickFilters] arriba de los accesos rápidos (p. ej. las pestañas de producto)
- * @param {Array<object>} [props.columnGroupingModel] bandas que agrupan columnas bajo un nombre, arriba de sus
- *     encabezados (columnGroupingModel del DataGrid). Con ellas el encabezado mide un renglón más
- * @param {(params: any) => string} [props.getRowClassName]
- * @param {(row: any) => boolean} [props.isRowVisible] cuáles renglones de la página se pintan; los demás se esconden
- *     SIN volver a consultar (p. ej. plegar un grupo de renglones). Sin ella se pintan todos. OJO: va con useCallback;
- *     una función nueva en cada pintada haría filtrar la página cada vez
- * @param {boolean} [props.striped] renglones alternos (cebra) con el color de hover del tema; al pasar el cursor se usa
- *     el de «seleccionado» para que el renglón bajo el cursor se siga distinguiendo
- * @param {(params: any) => number|'auto'|null} [props.getRowHeight]
- * @param {boolean} [props.hideFooterWhenAllRowsFit] esconde el pie (el paginador) mientras todo lo que hay cabe en la
- *     página; si un día no cabe, el pie vuelve solo. Para tablas que casi nunca pasan de una página
- * @param {boolean} [props.showGoToPage] «Ir a página N» junto al paginador; por omisión escondido (con las flechas basta en
- *     casi todas las tablas). Para listas de muchas páginas que se recorren por número
- * @param {object} [props.gridSx] estilos extra del DataGrid (clases de renglón)
- * @param {number} [props.maxGridHeight] alto máximo del contenedor; sin él la tabla crece con sus renglones (default)
- * @param {string} [props.ariaLabel] nombre de la tabla para lectores de pantalla
- * @param {string} [props.fixedColumn] campo de la columna que se queda pegada a la izquierda al deslizar de lado (como
- *     fixedSelectColumn de mui-datatables)
- * @param {Array<{key: string, label: string, icon?: import('react').ReactNode, color?: 'inherit'|'primary'|'secondary'|'error'|'info'|'success'|'warning', isDisabled?: (selection: RowSelection) => boolean, onClick: (selection: RowSelection, helpers: {clearSelection: () => void, refresh: () => void}) => unknown}>} [props.selectionActions]
- *     con ellas cada renglón lleva su casilla y, al elegir, sale la barra de los elegidos con estas acciones. label ya
- *     traducido; onClick recibe la selección (con isAllMatching mande `filters`, no `ids`) y cómo quitar la selección y volver
- *     a consultar después de actuar
- * @param {(row: any) => boolean} [props.isRowSelectable] cuáles renglones se pueden elegir (un pedido entregado no se cancela)
- * @param {boolean} [props.allowSelectAllMatching] la casilla de arriba elige todos los que coinciden (la acción recibe los
- *     filtros) y el aviso deja quedarse solo con la página; por omisión sí. false: la casilla elige la página y nunca se
- *     ofrece «todos»
- * @param {(selection: RowSelection) => void} [props.onSelectionChange] cada que cambia la selección; también enciende las
- *     casillas sin barra de acciones (la pantalla pinta las suyas)
- * @param {'top'|'split'} [props.selectionPhoneLayout] SELECTION_PHONE_LAYOUT: en el teléfono con vidrio o minimalista, todo
- *     arriba (por omisión) o el conteo arriba y las acciones abajo. Sin vidrio, en el renglón como en escritorio
- * @param {(request: {filters: Record<string, any>, sortOrders: Array<{column: string, direction: 'asc'|'desc'}>, page: number, pageSize: number}) => void} [props.onQueryChange]
- *     cada que cambia lo que pide la tabla (un filtro, el orden, la página), antes de consultar: para la lógica de negocio que
- *     depende de lo filtrado («si eligió Cancelados, enseñe el motivo»)
- * @param {(result: {rows: any[], total: number, facets: object, capped: boolean}) => void} [props.onLoaded] cada que llega una
- *     página del servidor
- * @param {(error: unknown) => void} [props.onLoadError] cuando la consulta falla (la tabla ya enseña su aviso con «Reintentar»)
- * @param {object} [props.gridProps] lo demás del DataGrid de MUI, sobre todo sus eventos (onRowClick, onRowDoubleClick,
- *     onCellKeyDown…). OJO: lo que la tabla controla (paginar, ordenar y filtrar en el servidor, el alto, la selección) no se
- *     reemplaza desde aquí: para eso están sus props
- * @param {object} [props.texts] los textos de la tabla que cambian, con la forma de `table` en los textos del paquete
- *     (src/locales/es.js), ya en el idioma de la pantalla: {selection: {clear: 'Deseleccionar'}, empty: {filtered: '…'}}.
- *     También les llegan a sus filtros de columna, sus chips y su barra de elegidos
- */
-export default function ServerTable(props: {
+declare const ServerTable: (props: {
     fetchPage: (params: {
         filters: Record<string, any>;
         sortOrders: Array<{
@@ -131,10 +55,10 @@ export default function ServerTable(props: {
     getRowHeight?: (params: any) => number | 'auto' | null;
     hideFooterWhenAllRowsFit?: boolean;
     showGoToPage?: boolean;
-    gridSx?: object;
+    gridSx?: object | Array<object> | Function;
     maxGridHeight?: number;
     ariaLabel?: string;
-    fixedColumn?: string;
+    fixedColumn?: string | string[];
     selectionActions?: Array<{
         key: string;
         label: string;
@@ -167,5 +91,17 @@ export default function ServerTable(props: {
     }) => void;
     onLoadError?: (error: unknown) => void;
     gridProps?: object;
+    renderCard?: (row: any, helpers: {
+        index: number;
+    }) => import('react').ReactNode;
+    view?: 'table' | 'cards';
+    defaultView?: 'table' | 'cards';
+    onViewChange?: (view: 'table' | 'cards') => void;
+    showViewToggle?: boolean;
+    cardSkeleton?: import('react').ReactNode;
     texts?: object;
-}): import("react").JSX.Element;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default ServerTable;

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

@@ -0,0 +1,14 @@
+declare const ServerTableFilterDrawer: (props: {
+    fields: object[];
+    anchor?: 'left' | 'right';
+    width?: number;
+    title?: string;
+    buttonLabel?: string;
+    onApply?: (values: Record<string, unknown>) => void;
+    children?: import('react').ReactNode;
+    texts?: object;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default ServerTableFilterDrawer;

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

@@ -0,0 +1,12 @@
+export type StackedEntry = import('react').ReactNode | {
+    label?: import('react').ReactNode;
+    value: import('react').ReactNode;
+    note?: import('react').ReactNode;
+};
+declare const StackedCell: (props: {
+    entries: StackedEntry[];
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default StackedCell;

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

@@ -0,0 +1,27 @@
+declare const TableCardsView: (props: {
+    rows: any[];
+    renderCard: (row: any, helpers: {
+        index: number;
+    }) => import('react').ReactNode;
+    rowIdOf: (row: any) => string | number;
+    isLoading: boolean;
+    page: number;
+    pageCount: number;
+    onPageChange: (page: number) => void;
+    hasActiveFilters: boolean;
+    emptyLabel?: string;
+    onClearFilters: () => void;
+    skeleton?: import('react').ReactNode;
+    ariaLabel?: string;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export declare const TableViewToggle: (props: {
+    view: 'table' | 'cards';
+    onChange: (view: 'table' | 'cards') => void;
+} & {
+    slots?: Record<string, import('react').ElementType>;
+    slotProps?: Record<string, object | ((partProps: object) => object)>;
+}) => import("react").JSX.Element;
+export default TableCardsView;

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

@@ -0,0 +1,21 @@
+/**
+ * El ancho de un texto en px con la letra de la página; sin navegador, por número de letras.
+ *
+ * @param {string} text
+ * @param {{fontSize?: number, fontWeight?: number}} [options]
+ * @returns {number}
+ */
+export declare function textWidthOf(text: string, { fontSize, fontWeight }?: {
+    fontSize?: number;
+    fontWeight?: number;
+}): number;
+/**
+ * El ancho de una columna de estatus: el de su etiqueta más larga (o el del encabezado, con sus íconos) más lo de alrededor.
+ *
+ * @param {string[]} labels el encabezado primero y luego las etiquetas, ya traducidos
+ * @param {{variant?: 'dot'|'chip'}} [options]
+ * @returns {number} px, redondeado hacia arriba
+ */
+export declare function statusColumnWidthOf([header, ...labels]: string[], { variant }?: {
+    variant?: 'dot' | 'chip';
+}): number;

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

@@ -1,3 +1,7 @@
+/** El campo de las columnas de la casa que no son datos: para nombrarlas en fixedColumn ({fixedColumn: [ACTIONS_COLUMN_FIELD, …]}). */
+export declare const DETAIL_COLUMN_FIELD = "__detail";
+export declare const ACTIONS_COLUMN_FIELD = "__actions";
+export declare const COLUMN_STACKED_KEY = "calcitaStacked";
 export type GridColumnProps = {
     width?: number;
     minWidth?: number;
@@ -93,3 +97,110 @@ export declare function detailColumn({ onOpen, ariaLabelOf, ...unknownOptions }:
         row: any;
     }) => import("react").JSX.Element;
 };
+/**
+ * Columna de datos apilados: los que se leen de corrido en un solo lugar, uno debajo del otro, los que hagan falta (la
+ * empresa, su RFC y su régimen; el contacto, su correo y su teléfono). El primero es el principal (en negritas) y los demás
+ * van en gris. Cada dato va solo, si el encabezado ya dice qué son, o con su etiqueta arriba ({label, value}) si el
+ * encabezado nombra al grupo. Con orden y filtro en el servidor como textColumn, por el campo de la columna. La tabla pone
+ * los renglones a su alto sola.
+ *
+ *   stackedColumn({field: 'business_name', label: 'Empresa', entries: (row) => [row.business_name, row.rfc, row.regime]})
+ *   stackedColumn({field: 'created_at', label: 'Fechas', entries: (row) => [
+ *       {label: 'Alta', value: formatDate(row.created_at)},
+ *       {label: 'Último cambio', value: formatDate(row.updated_at)},
+ *   ]})
+ *
+ * @param {{field: string, label: string, entries: (row: any, value: any) => import('./StackedCell.js').StackedEntry[], sort?: boolean, filter?: boolean} & GridColumnProps} columnDeclaration
+ *     entries: los datos de cada renglón en orden; `value` es el de la columna ya con su valueFormatter. Un dato vacío
+ *     no se pinta (salvo el principal o uno con etiqueta: enseñan «—»)
+ */
+export declare function stackedColumn({ field, label, entries, sort, filter, ...gridColumnProps }: {
+    field: string;
+    label: string;
+    entries: (row: any, value: any) => import('./StackedCell.js').StackedEntry[];
+    sort?: boolean;
+    filter?: boolean;
+} & GridColumnProps): {
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    flex?: number;
+    align?: 'left' | 'center' | 'right';
+    headerAlign?: 'left' | 'center' | 'right';
+    valueFormatter?: (value: any, row: any) => string;
+    valueGetter?: (value: any, row: any) => any;
+    field: string;
+    headerName: string;
+    sortable: boolean;
+    filterable: boolean;
+    renderHeader: () => import("react").JSX.Element;
+    calcitaStacked: boolean;
+    renderCell: (params: any) => import("react").JSX.Element;
+};
+/**
+ * Columna de estatus desde un diccionario: el estatus con su color y su explicación (StatusChip), filtro con las facetas del
+ * servidor (como facetColumn) y un ancho que alcanza para la etiqueta más larga del diccionario. Con `t` el ancho se mide
+ * con las etiquetas en el idioma de la pantalla (sin él, 160 px o el `width` que se le dé).
+ *
+ *   statusColumn({field: 'status', label: 'Estado', dictionary: ORDER_STATUS, t})
+ *
+ * @param {{field: string, label: string, dictionary: Record<string, object>, t?: (key: string) => string, short?: boolean, variant?: 'dot'|'chip', sort?: boolean, filter?: boolean, facetKey?: string} & GridColumnProps} columnDeclaration
+ *     filter false: sin filtro en el encabezado (cuando el servidor no da facetas de este campo)
+ */
+export declare function statusColumn({ field, label, dictionary, t, short, variant, sort, filter, facetKey, ...gridColumnProps }: {
+    field: string;
+    label: string;
+    dictionary: Record<string, object>;
+    t?: (key: string) => string;
+    short?: boolean;
+    variant?: 'dot' | 'chip';
+    sort?: boolean;
+    filter?: boolean;
+    facetKey?: string;
+} & GridColumnProps): {
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    flex?: number;
+    align?: 'left' | 'center' | 'right';
+    headerAlign?: 'left' | 'center' | 'right';
+    valueFormatter?: (value: any, row: any) => string;
+    valueGetter?: (value: any, row: any) => any;
+    field: string;
+    headerName: string;
+    sortable: boolean;
+    filterable: boolean;
+    renderHeader: () => import("react").JSX.Element;
+    renderCell: ({ row }: {
+        row: any;
+    }) => import("react").JSX.Element;
+};
+/**
+ * Columna con el menú «⋯» de cada renglón (ActionsMenu): las acciones van en su columna con un ícono, no con clic en toda
+ * la fila. Va de un ancho fijo, así se puede dejar pegada al deslizar: fixedColumn={[ACTIONS_COLUMN_FIELD, 'company']}.
+ *
+ *   actionsColumn({label: 'Acciones del cliente', actionsOf: (row) => [{key: 'open', label: 'Abrir', to: `/clientes/${row.id}`}]})
+ *
+ * @param {object} declaration
+ * @param {string} declaration.label el nombre del botón (lector de pantalla y su globo), ya traducido
+ * @param {(row: any) => Array<object>} declaration.actionsOf las acciones de ese renglón, con la forma de ActionsMenu
+ * @param {(row: any) => string} [declaration.labelOf] el nombre del botón por renglón («Acciones de Acme»)
+ * @param {number} [declaration.width] por omisión 56
+ */
+export declare function actionsColumn({ label, actionsOf, labelOf: labelOfRow, width, ...unknownOptions }: {
+    label: string;
+    actionsOf: (row: any) => Array<object>;
+    labelOf?: (row: any) => string;
+    width?: number;
+}): {
+    field: string;
+    headerName: string;
+    sortable: boolean;
+    filterable: boolean;
+    disableColumnMenu: boolean;
+    width: number;
+    align: string;
+    renderCell: ({ row }: {
+        row: any;
+    }) => import("react").JSX.Element;
+};

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

@@ -1,10 +1,11 @@
 export declare const TableFilterContext: import("react").Context<null>;
 /**
- * @returns {{filters: object, setFilter: Function, clearFilter: Function, sortOrders: Array, toggleSort: Function, clearSort: Function, facets: object}}
+ * @returns {{filters: object, setFilter: Function, setFilters: Function, clearFilter: Function, sortOrders: Array, toggleSort: Function, clearSort: Function, facets: object}}
  */
 export declare function useTableFilter(): {
     filters: object;
     setFilter: Function;
+    setFilters: Function;
     clearFilter: Function;
     sortOrders: any[];
     toggleSort: Function;

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

@@ -0,0 +1,29 @@
+/**
+ * Los campos fijos como lista, con el orden en que se dieron.
+ *
+ * @param {string|string[]|null|undefined} fixedColumn
+ * @returns {string[]}
+ */
+export declare function fixedFieldsOf(fixedColumn: string | string[] | null | undefined): string[];
+/**
+ * Cada columna fija con su `left` en px.
+ *
+ * @param {string[]} fields los campos fijos, de izquierda a derecha
+ * @param {Array<{field: string, width?: number, minWidth?: number, flex?: number}>} columns las columnas de la tabla
+ * @param {{startLeft?: number}} [options] startLeft: lo que ya va pegado antes (la casilla de elegir renglones)
+ * @returns {Array<{field: string, left: number, isLast: boolean, hasUnknownWidth: boolean}>} hasUnknownWidth: no es la última
+ *     y su ancho no es fijo (la siguiente podría encimarse)
+ */
+export declare function fixedColumnOffsetsOf(fields: string[], columns: Array<{
+    field: string;
+    width?: number;
+    minWidth?: number;
+    flex?: number;
+}>, { startLeft }?: {
+    startLeft?: number;
+}): Array<{
+    field: string;
+    left: number;
+    isLast: boolean;
+    hasUnknownWidth: boolean;
+}>;

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

@@ -0,0 +1,15 @@
+/**
+ * @param {number} pageCount cuántas páginas tiene la tabla
+ * @returns {number[]} las páginas como las cuenta una persona: 1, 2, 3... pageCount
+ */
+export declare function pageNumbersOf(pageCount: number): number[];
+/**
+ * filterOptions del Autocomplete.
+ *
+ * @param {number[]} pageNumbers todas las páginas
+ * @param {{inputValue: string}} state lo que lleva tecleado la persona
+ * @returns {number[]} sin teclear, todas; tecleando, primero las que empiezan así y luego las que lo contienen
+ */
+export declare function filterPages(pageNumbers: number[], { inputValue }: {
+    inputValue: string;
+}): number[];

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

@@ -4,8 +4,14 @@ export { default as EmptyState } from './EmptyState.js';
 export { default as FilterChips } from './FilterChips.js';
 export { default as GoToPage } from './GoToPage.js';
 export { SELECTION_PHONE_LAYOUT, default as ServerTable } from './ServerTable.js';
+export { default as ServerTableFilterDrawer } from './ServerTableFilterDrawer.js';
 export { buildChipConfig } from './buildChipConfig.js';
-export { detailColumn, facetColumn, textColumn } from './columns.js';
+export { ACTIONS_COLUMN_FIELD, DETAIL_COLUMN_FIELD, actionsColumn, detailColumn, facetColumn, stackedColumn, statusColumn, textColumn, } from './columns.js';
+export { default as StackedCell } from './StackedCell.js';
+export { statusColumnWidthOf, textWidthOf } from './columnWidths.js';
+export { fixedColumnOffsetsOf, fixedFieldsOf } from './fixedColumns.js';
+export { TableViewToggle, default as TableCardsView } from './TableCardsView.js';
+export { TABLE_VIEW, useTableView } from './useTableView.js';
 export { TableFilterContext, useTableFilter } from './filterContext.js';
 export { toServerTableParams } from './serverTableParams.js';
 export { buildTableActors, tableMachine } from './tableMachine.js';