@stackcraftmx/calcita 0.0.0-stage → 0.23.0

package/dist/theme/toolkitComponents.js

@@ -0,0 +1,26 @@
+import { MuiAppBar } from "./components/MuiAppBar.js";
+import { MuiBackdrop } from "./components/MuiBackdrop.js";
+import { MuiButton } from "./components/MuiButton.js";
+import { MuiButtonBase } from "./components/MuiButtonBase.js";
+import { MuiChip } from "./components/MuiChip.js";
+import { MuiDataGrid } from "./components/MuiDataGrid.js";
+import { MuiDrawer } from "./components/MuiDrawer.js";
+import { MuiMenuItem } from "./components/MuiMenuItem.js";
+import { MuiTypography } from "./components/MuiTypography.js";
+function toolkitComponents() {
+  return {
+    ...MuiAppBar(),
+    ...MuiBackdrop(),
+    ...MuiButton(),
+    ...MuiButtonBase(),
+    ...MuiChip(),
+    ...MuiDataGrid(),
+    ...MuiDrawer(),
+    ...MuiMenuItem(),
+    ...MuiTypography()
+  };
+}
+export {
+  toolkitComponents
+};
+//# sourceMappingURL=toolkitComponents.js.map

package/dist/theme/toolkitComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkitComponents.js","sources":["../../src/theme/toolkitComponents.js"],"sourcesContent":["// Los ajustes de componentes de MUI del framework (del tema de walk-ot), juntos. Un archivo por componente en\n// theme/components/: para cambiar cómo se ve un componente se abre el suyo y nada más.\n//\n// createToolkitTheme() ya los trae. Un proyecto con su propio createTheme los puede usar sueltos:\n//   createTheme({components: {...toolkitComponents(), ...losMios}})\n//\n// Funciones puras, sin React: function (regla de la casa).\nimport {MuiAppBar} from '@/theme/components/MuiAppBar.js';\nimport {MuiBackdrop} from '@/theme/components/MuiBackdrop.js';\nimport {MuiButton} from '@/theme/components/MuiButton.js';\nimport {MuiButtonBase} from '@/theme/components/MuiButtonBase.js';\nimport {MuiChip} from '@/theme/components/MuiChip.js';\nimport {MuiDataGrid} from '@/theme/components/MuiDataGrid.js';\nimport {MuiDrawer} from '@/theme/components/MuiDrawer.js';\nimport {MuiMenuItem} from '@/theme/components/MuiMenuItem.js';\nimport {MuiTypography} from '@/theme/components/MuiTypography.js';\n\n/**\n * @returns {object} el `components` del tema de MUI\n */\nexport function toolkitComponents() {\n    return {\n        ...MuiAppBar(),\n        ...MuiBackdrop(),\n        ...MuiButton(),\n        ...MuiButtonBase(),\n        ...MuiChip(),\n        ...MuiDataGrid(),\n        ...MuiDrawer(),\n        ...MuiMenuItem(),\n        ...MuiTypography(),\n    };\n}\n"],"names":[],"mappings":";;;;;;;;;AAoBO,SAAS,oBAAoB;AAChC,SAAO;AAAA,IACH,GAAG,UAAS;AAAA,IACZ,GAAG,YAAW;AAAA,IACd,GAAG,UAAS;AAAA,IACZ,GAAG,cAAa;AAAA,IAChB,GAAG,QAAO;AAAA,IACV,GAAG,YAAW;AAAA,IACd,GAAG,UAAS;AAAA,IACZ,GAAG,YAAW;AAAA,IACd,GAAG,cAAa;AAAA,EACxB;AACA;"}

package/dist/timeline.js

@@ -0,0 +1,8 @@
+import { default as default2 } from "./ui/timeline/GroupedTimeline.js";
+import { TIMELINE_EMPHASIS, timelineDotOf } from "./ui/timeline/timelineDot.js";
+export {
+  default2 as GroupedTimeline,
+  TIMELINE_EMPHASIS,
+  timelineDotOf
+};
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/toolkit/ToolkitProvider.js

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

package/dist/toolkit/ToolkitProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolkitProvider.js","sources":["../../src/toolkit/ToolkitProvider.jsx"],"sourcesContent":["// El proveedor del paquete: el único lugar donde cada aplicación conecta su idioma, sus textos, su zona horaria y su\n// router. Va por encima de la aplicación, dentro del ThemeProvider de MUI (el tema lo arma cada proyecto; sin tema,\n// los componentes usan los colores por omisión de MUI).\n//\n//   <ToolkitProvider language=\"es\" navigation={reactRouterNavigation} texts={{es: {common: {actions: {back: 'Volver'}}}}}>\n//\n// Sin proveedor todo funciona en español, con la zona del navegador y la navegación del navegador.\n//\n// Lo renderiza la app: arrow (regla de la casa).\nimport {useMemo} from 'react';\nimport {allowOnlyUnrestricted} from '@/access/accessRules.js';\nimport {browserNavigation} from '@/toolkit/browserNavigation.js';\nimport {ToolkitContext} from '@/toolkit/toolkitContext.js';\nimport {useFontSize} from '@/ui/navigation/useFontSize.js';\nimport {DEFAULT_CURRENCY, DEFAULT_LANGUAGE, browserTimeZone, configureToolkit} from '@/toolkit/toolkitSettings.js';\n\n/**\n * @param {object} props\n * @param {string} [props.language] idioma activo: es o en (por omisión es)\n * @param {(language: string) => void} [props.onLanguageChange] lo llama LanguageToggle; el proyecto cambia su idioma\n * @param {object} [props.texts] textos propios por idioma, con la forma de locales/ ({es: {table: {...}}})\n * @param {(namespace: string, key: string, values?: object) => string|undefined} [props.translate] traductor del\n *     proyecto (por ejemplo i18next); undefined deja el texto del paquete\n * @param {string} [props.timeZone] zona de las fechas (por omisión la del navegador)\n * @param {string} [props.currency] moneda de los montos, código ISO 4217 (por omisión MXN)\n * @param {string} [props.appName] nombre de la aplicación para el título de la pestaña\n * @param {object} [props.navigation] {useNavigate, useLocation, Link}; por omisión la del navegador\n * @param {string} [props.buildId] la compilación del front que corre en esta pestaña; con ella NewBuildNotice sabe si el\n *     servidor ya publicó otra (reportPublishedBuild). Vacía (en desarrollo) nunca avisa\n * @param {(access: object|undefined|null) => boolean} [props.canAccess] quién ve qué (menú, rutas, botones): la regla del\n *     proyecto, normalmente createAccessChecker({abilities, roles, policies, context}). Sin ella solo se ve lo que no\n *     tiene regla\n * @param {import('react').ReactNode} props.children\n */\nexport const ToolkitProvider = ({\n    language = DEFAULT_LANGUAGE, onLanguageChange, texts, translate, timeZone, currency = DEFAULT_CURRENCY, appName = '',\n    navigation = browserNavigation, buildId = '', canAccess = allowOnlyUnrestricted, children,\n}) => {\n    const settings = useMemo(() => ({\n        language,\n        onLanguageChange: onLanguageChange ?? null,\n        texts: texts ?? {},\n        translate: translate ?? null,\n        timeZone: timeZone ?? browserTimeZone(),\n        currency,\n        appName,\n        navigation,\n        buildId,\n        canAccess,\n    }), [language, onLanguageChange, texts, translate, timeZone, currency, appName, navigation, buildId, canAccess]);\n\n    // OJO: se configura durante el render (no en un efecto) para que los formatos y avisos que se llaman en este mismo\n    // render ya vean el idioma y la zona nuevos\n    configureToolkit({\n        language: settings.language, texts: settings.texts, translate: settings.translate, timeZone: settings.timeZone, currency, appName,\n        buildId,\n    });\n\n    // el tamaño de letra que la persona guardó: se aplica aquí, que siempre está montado. Antes lo aplicaba su botón en la\n    // barra; al pasar los ajustes al menú de la cuenta, al recargar se perdía hasta abrir el menú (error pagado)\n    useFontSize();\n\n    return <ToolkitContext.Provider value={settings}>{children}</ToolkitContext.Provider>;\n};\n"],"names":[],"mappings":";;;;;;;;AAkCO,MAAM,kBAAkB,CAAC;AAAA,EAC5B,WAAW;AAAA,EAAkB;AAAA,EAAkB;AAAA,EAAO;AAAA,EAAW;AAAA,EAAU,WAAW;AAAA,EAAkB,UAAU;AAAA,EAClH,aAAa;AAAA,EAAmB,UAAU;AAAA,EAAI,YAAY;AAAA,EAAuB;AACrF,MAAM;AACF,QAAM,WAAW,QAAQ,OAAO;AAAA,IAC5B;AAAA,IACA,kBAAkB,oBAAoB;AAAA,IACtC,OAAO,SAAS,CAAA;AAAA,IAChB,WAAW,aAAa;AAAA,IACxB,UAAU,YAAY,gBAAA;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACA,CAAC,UAAU,kBAAkB,OAAO,WAAW,UAAU,UAAU,SAAS,YAAY,SAAS,SAAS,CAAC;AAI/G,mBAAiB;AAAA,IACb,UAAU,SAAS;AAAA,IAAU,OAAO,SAAS;AAAA,IAAO,WAAW,SAAS;AAAA,IAAW,UAAU,SAAS;AAAA,IAAU;AAAA,IAAU;AAAA,IAC1H;AAAA,EAAA,CACH;AAID,cAAA;AAEA,6BAAQ,eAAe,UAAf,EAAwB,OAAO,UAAW,UAAS;AAC/D;"}

package/dist/toolkit/browserNavigation.js

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

package/dist/toolkit/browserNavigation.js.map

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

package/dist/toolkit/toolkitContext.js

@@ -0,0 +1,19 @@
+"use client";
+import { createContext, useContext } from "react";
+import { allowOnlyUnrestricted } from "../access/accessRules.js";
+import { browserNavigation } from "./browserNavigation.js";
+import { toolkitSettings } from "./toolkitSettings.js";
+const ToolkitContext = createContext(null);
+function useToolkitSettings() {
+  const settings = useContext(ToolkitContext);
+  return settings ?? { ...toolkitSettings(), onLanguageChange: null, navigation: browserNavigation, canAccess: allowOnlyUnrestricted };
+}
+function useToolkitNavigation() {
+  return useToolkitSettings().navigation;
+}
+export {
+  ToolkitContext,
+  useToolkitNavigation,
+  useToolkitSettings
+};
+//# sourceMappingURL=toolkitContext.js.map

package/dist/toolkit/toolkitContext.js.map

@@ -0,0 +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;"}

package/dist/toolkit/toolkitSettings.js

@@ -0,0 +1,87 @@
+import es from "../locales/es.js";
+import en from "../locales/en.js";
+const DEFAULT_LANGUAGE = "es";
+const DEFAULT_CURRENCY = "MXN";
+const PACKAGE_TEXTS_BY_LANGUAGE = Object.freeze({ es, en });
+const INTL_LOCALE_BY_LANGUAGE = Object.freeze({ es: "es-MX", en: "en-US" });
+const NAMESPACE_SEPARATOR = ":";
+const KEY_SEPARATOR = ".";
+const PLURAL_SEPARATOR = "_";
+const PLURAL_OTHER = "other";
+const INTERPOLATION = /\{\{\s*(\w+)\s*\}\}/g;
+function browserTimeZone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone ?? "America/Mexico_City";
+}
+let currentSettings = Object.freeze({
+  language: DEFAULT_LANGUAGE,
+  texts: {},
+  translate: null,
+  timeZone: browserTimeZone(),
+  currency: DEFAULT_CURRENCY,
+  appName: "",
+  // la compilación del front que corre en esta pestaña ('' en desarrollo): con ella se sabe si hay una versión nueva
+  buildId: ""
+});
+function configureToolkit(settings) {
+  currentSettings = Object.freeze({ ...currentSettings, ...settings });
+}
+function toolkitSettings() {
+  return currentSettings;
+}
+function intlLocaleOf(language) {
+  return INTL_LOCALE_BY_LANGUAGE[language] ?? INTL_LOCALE_BY_LANGUAGE[DEFAULT_LANGUAGE];
+}
+function valueAtPath(texts, path) {
+  let value = texts;
+  for (const part of path.split(KEY_SEPARATOR)) {
+    if (value === null || typeof value !== "object") {
+      return void 0;
+    }
+    value = value[part];
+  }
+  return value;
+}
+function textOf(texts, namespace, key, values, language) {
+  const namespaceTexts = texts?.[namespace];
+  if (typeof values?.count === "number") {
+    const pluralCategory = new Intl.PluralRules(intlLocaleOf(language)).select(values.count);
+    const pluralText = valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${pluralCategory}`) ?? valueAtPath(namespaceTexts, `${key}${PLURAL_SEPARATOR}${PLURAL_OTHER}`);
+    if (typeof pluralText === "string") {
+      return pluralText;
+    }
+  }
+  const text = valueAtPath(namespaceTexts, key);
+  return typeof text === "string" ? text : void 0;
+}
+function interpolate(text, values) {
+  return text.replace(INTERPOLATION, (placeholder, name) => values?.[name] === void 0 ? placeholder : String(values[name]));
+}
+function translateWith(settings, defaultNamespace, key, values) {
+  const [namespace, plainKey] = key.includes(NAMESPACE_SEPARATOR) ? key.split(NAMESPACE_SEPARATOR, 2) : [defaultNamespace, key];
+  const projectText = settings.translate?.(namespace, plainKey, values);
+  if (typeof projectText === "string") {
+    return projectText;
+  }
+  const text = textOf(settings.texts?.[settings.language], namespace, plainKey, values, settings.language) ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[settings.language], namespace, plainKey, values, settings.language) ?? textOf(PACKAGE_TEXTS_BY_LANGUAGE[DEFAULT_LANGUAGE], namespace, plainKey, values, DEFAULT_LANGUAGE);
+  if (text !== void 0) {
+    return interpolate(text, values);
+  }
+  if (typeof values?.defaultValue === "string") {
+    return interpolate(values.defaultValue, values);
+  }
+  return `${namespace}${NAMESPACE_SEPARATOR}${plainKey}`;
+}
+function translateToolkit(defaultNamespace, key, values) {
+  return translateWith(currentSettings, defaultNamespace, key, values);
+}
+export {
+  DEFAULT_CURRENCY,
+  DEFAULT_LANGUAGE,
+  browserTimeZone,
+  configureToolkit,
+  intlLocaleOf,
+  toolkitSettings,
+  translateToolkit,
+  translateWith
+};
+//# sourceMappingURL=toolkitSettings.js.map

package/dist/toolkit/toolkitSettings.js.map

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

package/dist/toolkit/useToolkitTranslation.js

@@ -0,0 +1,18 @@
+"use client";
+import { useCallback } from "react";
+import { useToolkitSettings } from "./toolkitContext.js";
+import { translateWith } from "./toolkitSettings.js";
+function useToolkitTranslation(namespace) {
+  const settings = useToolkitSettings();
+  const defaultNamespace = Array.isArray(namespace) ? namespace[0] : namespace;
+  const t = useCallback(
+    (key, values) => translateWith(settings, defaultNamespace, key, values),
+    [settings, defaultNamespace]
+  );
+  const changeLanguage = useCallback((language) => settings.onLanguageChange?.(language), [settings]);
+  return { t, language: settings.language, changeLanguage };
+}
+export {
+  useToolkitTranslation
+};
+//# sourceMappingURL=useToolkitTranslation.js.map

package/dist/toolkit/useToolkitTranslation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolkitTranslation.js","sources":["../../src/toolkit/useToolkitTranslation.js"],"sourcesContent":["// Los textos del paquete dentro de un componente, con la misma forma que useTranslation de react-i18next:\n//\n//   const {t, language, changeLanguage} = useToolkitTranslation('table');\n//   t('goToPage.of', {count: pageCount, total})\n//\n// Se vuelve a pintar cuando cambia el idioma o los textos del proveedor. El orden en que se buscan los textos está en\n// toolkitSettings.js.\n//\n// Hook genérico: function (regla de la casa).\nimport {useCallback} from 'react';\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\nimport {translateWith} from '@/toolkit/toolkitSettings.js';\n\n/**\n * @param {string|string[]} [namespace] el namespace de las llaves sin prefijo; con una lista, el primero. Sin él, cada\n *     llave lleva el suyo ('orders:list.title')\n * @returns {{t: (key: string, values?: object) => string, language: string, changeLanguage: (language: string) => void}}\n */\nexport function useToolkitTranslation(namespace) {\n    const settings = useToolkitSettings();\n    const defaultNamespace = Array.isArray(namespace) ? namespace[0] : namespace;\n    const t = useCallback(\n        (key, values) => translateWith(settings, defaultNamespace, key, values),\n        [settings, defaultNamespace],\n    );\n    // sin onLanguageChange del proyecto no hay a quién avisarle: el botón de idioma no hace nada\n    const changeLanguage = useCallback((language) => settings.onLanguageChange?.(language), [settings]);\n\n    return {t, language: settings.language, changeLanguage};\n}\n"],"names":[],"mappings":";;;;AAkBO,SAAS,sBAAsB,WAAW;AAC7C,QAAM,WAAW,mBAAkB;AACnC,QAAM,mBAAmB,MAAM,QAAQ,SAAS,IAAI,UAAU,CAAC,IAAI;AACnE,QAAM,IAAI;AAAA,IACN,CAAC,KAAK,WAAW,cAAc,UAAU,kBAAkB,KAAK,MAAM;AAAA,IACtE,CAAC,UAAU,gBAAgB;AAAA,EACnC;AAEI,QAAM,iBAAiB,YAAY,CAAC,aAAa,SAAS,mBAAmB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAElG,SAAO,EAAC,GAAG,UAAU,SAAS,UAAU,eAAc;AAC1D;"}

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

@@ -0,0 +1,32 @@
+/**
+ * @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({ open, onClose, title, subtitle, subjectKey, fetchPage, eventDictionary, resultDictionary, extraColumns, header, eventSuffixOf, }: {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    subtitle?: import('react').ReactNode;
+    subjectKey: string;
+    fetchPage: (tableRequest: object, signal: AbortSignal) => Promise<{
+        rows: any[];
+        total: number;
+        facets?: object;
+    }>;
+    eventDictionary: Record<string, object>;
+    resultDictionary?: Record<string, object>;
+    extraColumns?: Array<object>;
+    header?: import('react').ReactNode;
+    eventSuffixOf?: (row: any) => string | null;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,28 @@
+/**
+ * @param {object} props
+ * @param {string} props.subjectKey identifica el renglón (cambia la consulta al cambiar de renglón); '' no consulta
+ * @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] columnas del DataGrid propias del módulo (archivo, origen, motivo...)
+ * @param {(row: any) => string|null} [props.eventSuffixOf] texto que va después del evento con « · » (p. ej. para
+ *     quién era la descarga); null = solo el evento
+ * @param {string} props.ariaLabel
+ * @param {number} [props.maxGridHeight]
+ * @param {unknown} [props.refreshToken] cambia para volver a consultar (después de una acción sobre el mismo renglón)
+ */
+export default function AuditTrailTable({ subjectKey, fetchPage, eventDictionary, resultDictionary, extraColumns, ariaLabel, maxGridHeight, refreshToken, eventSuffixOf, }: {
+    subjectKey: string;
+    fetchPage: (tableRequest: object, signal: AbortSignal) => Promise<{
+        rows: any[];
+        total: number;
+        facets?: object;
+    }>;
+    eventDictionary: Record<string, object>;
+    resultDictionary?: Record<string, object>;
+    extraColumns?: Array<object>;
+    eventSuffixOf?: (row: any) => string | null;
+    ariaLabel: string;
+    maxGridHeight?: number;
+    refreshToken?: unknown;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+/**
+ * @param {{activeCount?: number, onClear: () => void, children: import('react').ReactNode}} props children = el filtro
+ */
+export default function HeaderFilterPopover({ activeCount, onClear, children }: {
+    activeCount?: number;
+    onClear: () => void;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,16 @@
+/**
+ * @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({ value, onChange, options, renderOption }: {
+    value?: string[];
+    onChange: (value: string[]) => void;
+    options?: Array<{
+        value: string;
+        total: number;
+    }>;
+    renderOption?: (value: string) => import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,26 @@
+/**
+ * @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({ label, sortable, sortEntry, onSort, onClearSort, filterable, activeCount, onClear, children, }: {
+    label: string;
+    sortable?: boolean;
+    sortEntry?: {
+        column: string;
+        direction: 'asc' | 'desc';
+    };
+    onSort?: () => void;
+    onClearSort?: () => void;
+    filterable?: boolean;
+    activeCount?: number;
+    onClear?: () => void;
+    children?: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,8 @@
+/**
+ * @param {{value: string, onChange: (value: string) => void, label?: string}} props label ya traducido
+ */
+export default function TextColumnFilter({ value, onChange, label }: {
+    value: string;
+    onChange: (value: string) => void;
+    label?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { default as HeaderFilterPopover } from './HeaderFilterPopover.js';
+export { default as MultiSelectColumnFilter } from './MultiSelectColumnFilter.js';
+export { default as SortableFilterHeader } from './SortableFilterHeader.js';
+export { default as TextColumnFilter } from './TextColumnFilter.js';

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

@@ -0,0 +1,8 @@
+/**
+ * @param {{filtered?: boolean, label?: string, onClearFilters?: () => void}} props label ya traducido
+ */
+export default function EmptyState({ filtered, label, onClearFilters }: {
+    filtered?: boolean;
+    label?: string;
+    onClearFilters?: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * @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í
+ */
+export default function FilterChips({ chipConfig, filters, onSetFilter, onClearAll, quickActiveCount }: {
+    chipConfig: Array<object>;
+    filters: object;
+    onSetFilter: (field: string, value: unknown) => void;
+    onClearAll: () => void;
+    quickActiveCount?: number;
+}): import("react").JSX.Element | null;

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

@@ -0,0 +1,8 @@
+/**
+ * @param {{page: number, pageCount: number, onChange: (page: number) => void}} props page cuenta desde 0
+ */
+export default function GoToPage({ page, pageCount, onChange }: {
+    page: number;
+    pageCount: number;
+    onChange: (page: number) => void;
+}): import("react").JSX.Element | null;

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

@@ -0,0 +1,110 @@
+/**
+ * @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}>>, 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)
+ */
+export default function ServerTable({ fetchPage, queryKey, enabled, columns, filterKinds, filterDefaults, chipConfig, quickFilters, searchField, searchPlaceholder, searchInBar, collapseSearchInBar, emptyLabel, countLabel, pageSizeOptions, defaultPageSize, getRowId, prefix, refreshToken, footer, toolbarExtra, header, beforeQuickFilters, columnGroupingModel, getRowClassName, isRowVisible, hideFooterWhenAllRowsFit, showGoToPage, striped, getRowHeight, gridSx, maxGridHeight, ariaLabel, fixedColumn, }: {
+    fetchPage: (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;
+        }>>;
+        capped?: boolean;
+    }>;
+    queryKey: string;
+    enabled?: boolean;
+    columns: Array<object>;
+    filterKinds?: Record<string, string>;
+    filterDefaults?: Record<string, unknown>;
+    chipConfig?: Array<object>;
+    quickFilters?: Array<object>;
+    searchField?: string | null;
+    searchPlaceholder?: string;
+    searchInBar?: boolean;
+    collapseSearchInBar?: boolean;
+    emptyLabel?: string;
+    countLabel?: (total: number) => string;
+    pageSizeOptions?: number[];
+    defaultPageSize?: number;
+    getRowId?: (row: any) => string | number;
+    prefix?: string;
+    refreshToken?: unknown;
+    footer?: (summary: {
+        total: number;
+        capped: boolean;
+    }) => import('react').ReactNode;
+    toolbarExtra?: import('react').ReactNode;
+    header?: (summary: {
+        countText: string;
+        total: number;
+        capped: boolean;
+    }) => import('react').ReactNode;
+    beforeQuickFilters?: import('react').ReactNode;
+    columnGroupingModel?: Array<object>;
+    getRowClassName?: (params: any) => string;
+    isRowVisible?: (row: any) => boolean;
+    striped?: boolean;
+    getRowHeight?: (params: any) => number | 'auto' | null;
+    hideFooterWhenAllRowsFit?: boolean;
+    showGoToPage?: boolean;
+    gridSx?: object;
+    maxGridHeight?: number;
+    ariaLabel?: string;
+    fixedColumn?: string;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,22 @@
+/**
+ * @param {object} declaration
+ * @param {Array<{key: string, label: string, format?: (value: string) => string}>} [declaration.text]
+ * @param {Array<{key: string, label: string, itemLabel?: (value: string) => string}>} [declaration.multiSelect]
+ * @returns {Array<{key: string, isActive: (value: unknown) => boolean, chipsFor: Function}>}
+ */
+export declare function buildChipConfig({ text, multiSelect }?: {
+    text?: Array<{
+        key: string;
+        label: string;
+        format?: (value: string) => string;
+    }>;
+    multiSelect?: Array<{
+        key: string;
+        label: string;
+        itemLabel?: (value: string) => string;
+    }>;
+}): Array<{
+    key: string;
+    isActive: (value: unknown) => boolean;
+    chipsFor: Function;
+}>;