@stackcraftmx/calcita 0.0.0-stage → 0.23.0

package/dist/types/api/createApiClient.d.ts

@@ -0,0 +1,146 @@
+import { ApiError } from './ApiError.js';
+/** Cómo se lee una respuesta que salió bien. */
+export declare const API_RESPONSE_PARSE: Readonly<{
+    json: "json";
+    blob: "blob";
+    response: "response";
+}>;
+/**
+ * La dirección completa: la base del cliente más el camino, con los parámetros. Un camino que ya trae http(s) va tal cual.
+ * Los parámetros vacíos (undefined, null) no viajan; una lista viaja repetida (estado=a&estado=b).
+ *
+ * @param {string} baseUrl
+ * @param {string} path
+ * @param {Record<string, unknown>} [params]
+ * @returns {string}
+ */
+export declare function apiUrlOf(baseUrl: string, path: string, params?: Record<string, unknown>): string;
+/**
+ * Retry-After en segundos: el estándar admite segundos o una fecha HTTP.
+ *
+ * @param {string|null} retryAfterHeader
+ * @returns {number|null}
+ */
+export declare function retryAfterSecondsOf(retryAfterHeader: string | null): number | null;
+export type ApiRequestOptions = {
+    /**
+     * objeto → JSON; FormData, Blob o URLSearchParams tal cual
+     */
+    body?: unknown;
+    /**
+     * los de la dirección (?page=2)
+     */
+    params?: Record<string, unknown>;
+    /**
+     * para cancelar
+     */
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON
+     */
+    parse?: 'json' | 'blob' | 'response';
+    /**
+     * un 401 que se espera (¿hay sesión?, el login)
+     */
+    skipUnauthenticatedHandler?: boolean;
+    /**
+     * el de esta petición
+     */
+    timeoutMilliseconds?: number;
+};
+export type ApiDownloadOptions = {
+    params?: Record<string, unknown>;
+    signal?: AbortSignal;
+    onDownloadProgress?: (progress: {
+        loaded: number;
+        total: number | null;
+    }) => void;
+    /**
+     * si el servidor no manda el nombre
+     */
+    fallbackFileName?: string;
+    /**
+     * por omisión sin límite
+     */
+    timeoutMilliseconds?: number;
+};
+export type ApiClient = {
+    request: (method: string, path: string, options?: ApiRequestOptions) => Promise<any>;
+    get: (path: string, options?: ApiRequestOptions) => Promise<any>;
+    post: (path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>;
+    put: (path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>;
+    patch: (path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>;
+    delete: (path: string, options?: ApiRequestOptions) => Promise<any>;
+    download: (path: string, options?: ApiDownloadOptions) => Promise<{
+        blob: Blob;
+        fileName: string;
+    }>;
+};
+/**
+ * Lo que acepta cada petición.
+ *
+ * @typedef {object} ApiRequestOptions
+ * @property {unknown} [body] objeto → JSON; FormData, Blob o URLSearchParams tal cual
+ * @property {Record<string, unknown>} [params] los de la dirección (?page=2)
+ * @property {AbortSignal} [signal] para cancelar
+ * @property {Record<string, string>} [headers]
+ * @property {'json'|'blob'|'response'} [parse] cómo se lee la respuesta (API_RESPONSE_PARSE); por omisión JSON
+ * @property {boolean} [skipUnauthenticatedHandler] un 401 que se espera (¿hay sesión?, el login)
+ * @property {number} [timeoutMilliseconds] el de esta petición
+ */
+/**
+ * Lo que acepta una descarga.
+ *
+ * @typedef {object} ApiDownloadOptions
+ * @property {Record<string, unknown>} [params]
+ * @property {AbortSignal} [signal]
+ * @property {(progress: {loaded: number, total: number|null}) => void} [onDownloadProgress]
+ * @property {string} [fallbackFileName] si el servidor no manda el nombre
+ * @property {number} [timeoutMilliseconds] por omisión sin límite
+ */
+/**
+ * El cliente del proyecto: cada método regresa el JSON de la respuesta (null si vino vacía) o truena con un ApiError.
+ *
+ * @typedef {object} ApiClient
+ * @property {(method: string, path: string, options?: ApiRequestOptions) => Promise<any>} request
+ * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} get
+ * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} post
+ * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} put
+ * @property {(path: string, body?: unknown, options?: ApiRequestOptions) => Promise<any>} patch
+ * @property {(path: string, options?: ApiRequestOptions) => Promise<any>} delete
+ * @property {(path: string, options?: ApiDownloadOptions) => Promise<{blob: Blob, fileName: string}>} download
+ */
+/**
+ * Arma el cliente del proyecto.
+ *
+ * @param {object} [options]
+ * @param {string} [options.baseUrl] lo que va antes de cada camino, p. ej. '/api/v1'
+ * @param {RequestCredentials} [options.credentials] 'same-origin' (por omisión, la cookie de sesión del mismo dominio) o
+ *     'include' (un API en otro dominio con cookies)
+ * @param {() => string|null|undefined} [options.getToken] con él cada petición lleva Authorization: Bearer; sin token, va
+ *     sin el header (el servidor responde 401)
+ * @param {Record<string, string>} [options.headers] los que van en todas las peticiones
+ * @param {string|null} [options.publishedBuildHeader] el header con la compilación publicada; null para no leerlo
+ * @param {{cookieName?: string, headerName?: string, refreshPath?: string}|null} [options.csrf] Laravel Sanctum:
+ *     {refreshPath: '/auth/csrf-token'}; por omisión la cookie XSRF-TOKEN y el header X-XSRF-TOKEN
+ * @param {number} [options.timeoutMilliseconds] el tiempo máximo de una consulta (0 = sin límite); por omisión 60 s
+ * @param {(error: ApiError) => void} [options.onUnauthenticated] qué hacer con un 401 (normalmente ir a iniciar sesión)
+ * @param {typeof fetch} [options.fetch] para un servidor de mentira o para las pruebas; por omisión el del navegador
+ * @returns {ApiClient}
+ */
+export declare function createApiClient({ baseUrl, credentials, getToken, headers: commonHeaders, publishedBuildHeader, csrf, timeoutMilliseconds: defaultTimeoutMilliseconds, onUnauthenticated, fetch: fetchImplementation, }?: {
+    baseUrl?: string;
+    credentials?: RequestCredentials;
+    getToken?: () => string | null | undefined;
+    headers?: Record<string, string>;
+    publishedBuildHeader?: string | null;
+    csrf?: {
+        cookieName?: string;
+        headerName?: string;
+        refreshPath?: string;
+    } | null;
+    timeoutMilliseconds?: number;
+    onUnauthenticated?: (error: ApiError) => void;
+    fetch?: typeof fetch;
+}): ApiClient;

package/dist/types/api/staleChunks.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ¿El error es un archivo de pantalla que ya no existe (se publicó otra versión), y no otra cosa?
+ *
+ * @param {unknown} error
+ * @returns {boolean}
+ */
+export declare function isStaleChunkError(error: unknown): boolean;
+/**
+ * Lo que va en el .catch() de un import dinámico: si el archivo es de una versión vieja, recarga una vez; si no, deja
+ * pasar el error tal cual para que lo vea quien corresponda.
+ *
+ * @param {unknown} error
+ * @returns {Promise<never>}
+ */
+export declare function recoverFromStaleChunk(error: unknown): Promise<never>;

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

@@ -0,0 +1,28 @@
+/**
+ * @param {object} props
+ * @param {{name: string, email?: string, subtitle?: string, avatarUrl?: string}} props.user
+ * @param {string} [props.profilePath] sin ella no sale «Mi perfil»
+ * @param {Array<{to?: string, onClick?: Function, label?: string, labelKey?: string, Icon?: import('react').ElementType}>} [props.accountMenuItems]
+ * @param {() => void} [props.onSignOut] sin él no sale «Salir»
+ * @param {boolean} [props.isSigningOut]
+ * @param {import('react').ReactNode} [props.settings] los ajustes de la app, entre los datos de la persona y sus ligas
+ */
+export default function AccountMenu({ user, profilePath, accountMenuItems, onSignOut, isSigningOut, settings }: {
+    user: {
+        name: string;
+        email?: string;
+        subtitle?: string;
+        avatarUrl?: string;
+    };
+    profilePath?: string;
+    accountMenuItems?: Array<{
+        to?: string;
+        onClick?: Function;
+        label?: string;
+        labelKey?: string;
+        Icon?: import('react').ElementType;
+    }>;
+    onSignOut?: () => void;
+    isSigningOut?: boolean;
+    settings?: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,66 @@
+/** Los dos estilos de barra. */
+export declare const MENU_POSITION: Readonly<{
+    side: "side";
+    top: "top";
+}>;
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} [props.logo] el logo chico (28 px), en la barra junto al nombre y en el cajón del teléfono
+ * @param {string} [props.brandName] el nombre de la app; por omisión el appName de ToolkitProvider
+ * @param {string} [props.brandCaption] el renglón chico debajo del nombre («Panel de administración»)
+ * @param {string} [props.homePath] por omisión '/'
+ * @param {object[]} [props.menuItems] lo que regresa composeMenu
+ * @param {'side'|'top'} [props.menuPosition] por omisión 'side' (MENU_POSITION)
+ * @param {{name: string, email?: string, subtitle?: string, avatarUrl?: string}|null} [props.user] quién está dentro
+ * @param {string} [props.profilePath] la ruta de Mi perfil
+ * @param {object[]} [props.accountMenuItems] renglones propios en el menú de la cuenta ({to | onClick, label | labelKey, Icon})
+ * @param {() => void} [props.onSignOut] sin él no sale «Salir» (una app sin sesión)
+ * @param {boolean} [props.isSigningOut]
+ * @param {import('react').ReactNode} [props.headerActions] botones propios en la barra, antes de la cuenta
+ * @param {Record<string, number>} [props.menuBadges] los conteos del servidor por badgeKey de cada entrada del menú
+ *     (useMenuBadges): lo pendiente de cada pantalla, como numerito
+ * @param {import('react').ReactNode} [props.accountSettings] ajustes propios del proyecto dentro del menú de la cuenta, debajo de
+ *     letra, idioma y claro u oscuro (con SettingSection, para que se vean igual)
+ * @param {import('react').ReactNode} [props.sidebarFooter] lo de abajo del menú lateral (una tarjeta de ayuda…)
+ * @param {boolean} [props.showFontSizeToggle] por omisión sí
+ * @param {boolean} [props.showLanguageToggle] por omisión sí
+ * @param {boolean} [props.showColorSchemeToggle] por omisión sí
+ * @param {import('react').ReactNode} [props.ribbons] avisos propios dentro de la barra
+ * @param {boolean} [props.isNavigating] la pantalla siguiente se está descargando (react-router: useIsNavigating)
+ * @param {boolean} [props.defaultCollapsed] el menú lateral empieza encogido (la persona lo cambia y se recuerda)
+ * @param {boolean} [props.minimizeTabBarOnScroll] en el teléfono con vidrio, la barra de pestañas se encoge al leer hacia
+ *     abajo y regresa al subir (como iOS 26); por omisión sí
+ * @param {number|string} [props.contentMaxWidth] por omisión 1400
+ * @param {import('react').ReactNode} props.children el contenido
+ */
+export declare const AppLayout: ({ logo, brandName, brandCaption, homePath, menuItems, menuPosition, user, profilePath, accountMenuItems, onSignOut, isSigningOut, headerActions, accountSettings, menuBadges, sidebarFooter, showFontSizeToggle, showLanguageToggle, showColorSchemeToggle, ribbons, isNavigating, defaultCollapsed, minimizeTabBarOnScroll, contentMaxWidth, children, }: {
+    logo?: import('react').ReactNode;
+    brandName?: string;
+    brandCaption?: string;
+    homePath?: string;
+    menuItems?: object[];
+    menuPosition?: 'side' | 'top';
+    user?: {
+        name: string;
+        email?: string;
+        subtitle?: string;
+        avatarUrl?: string;
+    } | null;
+    profilePath?: string;
+    accountMenuItems?: object[];
+    onSignOut?: () => void;
+    isSigningOut?: boolean;
+    headerActions?: import('react').ReactNode;
+    menuBadges?: Record<string, number>;
+    accountSettings?: import('react').ReactNode;
+    sidebarFooter?: import('react').ReactNode;
+    showFontSizeToggle?: boolean;
+    showLanguageToggle?: boolean;
+    showColorSchemeToggle?: boolean;
+    ribbons?: import('react').ReactNode;
+    isNavigating?: boolean;
+    defaultCollapsed?: boolean;
+    minimizeTabBarOnScroll?: boolean;
+    contentMaxWidth?: number | string;
+    children: import('react').ReactNode;
+}) => import("react").JSX.Element;

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

@@ -0,0 +1,34 @@
+/**
+ * Un ajuste: su nombre y sus opciones a la vista. Es público: el proyecto agrega los suyos al menú de la cuenta con la
+ * misma forma (AppLayout accountSettings), como el vidrio en los ejemplos.
+ *
+ * @param {object} props
+ * @param {string} props.label ya traducido
+ * @param {string} props.value la opción elegida
+ * @param {Object[]} props.options
+ * @param {string} props.options[].value
+ * @param {string} props.options[].label ya traducido
+ * @param {import('react').ReactNode} [props.options[].icon]
+ * @param {(value: string) => void} props.onChange
+ */
+export declare function SettingSection({ label, value, options, onChange }: {
+    label: string;
+    value: string;
+    options: {
+        value: string;
+        label: string;
+        icon?: import('react').ReactNode;
+    }[];
+    onChange: (value: string) => void;
+}): import("react").JSX.Element;
+/**
+ * @param {object} props
+ * @param {boolean} [props.showFontSize] por omisión sí
+ * @param {boolean} [props.showLanguage] por omisión sí
+ * @param {boolean} [props.showColorScheme] por omisión sí
+ */
+export default function AppearanceSettings({ showFontSize, showLanguage, showColorScheme }: {
+    showFontSize?: boolean;
+    showLanguage?: boolean;
+    showColorScheme?: boolean;
+}): import("react").JSX.Element[];

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

@@ -0,0 +1,21 @@
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} [props.logo] el logo chico (28 px)
+ * @param {string} [props.brandName] por omisión el appName de ToolkitProvider
+ * @param {string} props.title el título de la tarjeta y de la pestaña, ya traducido
+ * @param {import('react').ReactNode} [props.description] el renglón debajo del título
+ * @param {import('react').ReactNode} props.children el formulario
+ * @param {import('react').ReactNode} [props.footer] debajo de la tarjeta (los botones de prueba, el aviso de privacidad…)
+ * @param {boolean} [props.showLanguageToggle] por omisión sí
+ * @param {boolean} [props.showColorSchemeToggle] por omisión sí
+ */
+export declare const AuthLayout: ({ logo, brandName, title, description, children, footer, showLanguageToggle, showColorSchemeToggle }: {
+    logo?: import('react').ReactNode;
+    brandName?: string;
+    title: string;
+    description?: import('react').ReactNode;
+    children: import('react').ReactNode;
+    footer?: import('react').ReactNode;
+    showLanguageToggle?: boolean;
+    showColorSchemeToggle?: boolean;
+}) => import("react").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * @param {object} props
+ * @param {string} props.label el nombre de la acción, ya traducido: «Agregar sucursal»
+ * @param {import('react').ReactNode} props.icon el ícono (<AddRoundedIcon />)
+ * @param {(event: object) => void} [props.onClick]
+ * @param {boolean} [props.disabled]
+ * @param {'inherit'|'primary'|'secondary'|'success'|'error'|'info'|'warning'} [props.color] por omisión primary
+ */
+export default function BarActionButton({ label, icon, onClick, disabled, color, ...buttonProps }: {
+    label: string;
+    icon: import('react').ReactNode;
+    onClick?: (event: object) => void;
+    disabled?: boolean;
+    color?: 'inherit' | 'primary' | 'secondary' | 'success' | 'error' | 'info' | 'warning';
+}): import("react").JSX.Element;

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

@@ -0,0 +1,18 @@
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} props.children los botones de este grupo (normalmente BarActionButton)
+ * @param {string} [props.label] el nombre del grupo (lector de pantalla): «Acciones de pedidos»
+ * @param {number} [props.order] en qué lugar va entre los grupos de la pantalla (CSS order; por omisión el de aparición)
+ * @param {object|Function|Array} [props.sx] estilos propios de la cápsula de arriba o de la flotante del teléfono (o del
+ *     grupo, en la franja)
+ * @param {object|Function|Array} [props.inlineSx] estilos de la cápsula cuando se queda en la pantalla
+ * @param {boolean} [props.bare] sin cápsula alrededor: lo de adentro ya es una (un buscador)
+ */
+export default function BarActions({ children, label, order, sx, inlineSx, bare }: {
+    children: import('react').ReactNode;
+    label?: string;
+    order?: number;
+    sx?: object | Function | any[];
+    inlineSx?: object | Function | any[];
+    bare?: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+export declare const BAR_CAPSULE_HEIGHT_PIXELS = 48;
+/**
+ * Lo demás va al div de la cápsula: aria-label (el nombre del grupo para quien usa lector de pantalla), id, onClick…
+ * role va por omisión en 'group' (lo que se agrupa se anuncia junto).
+ *
+ * @param {Omit<import('react').HTMLAttributes<HTMLDivElement>, 'children'> & {children: import('react').ReactNode, sx?: object|Function|Array<any>}} props
+ *     children: los botones del grupo; sx: estilos propios, encima de los de la cápsula
+ */
+export default function BarCapsule({ children, sx, role, ...rest }: Omit<import('react').HTMLAttributes<HTMLDivElement>, 'children'> & {
+    children: import('react').ReactNode;
+    sx?: object | Function | Array<any>;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} [props.headerActions]
+ * @param {boolean} props.showFontSizeToggle
+ * @param {boolean} props.showLanguageToggle
+ * @param {boolean} props.showColorSchemeToggle
+ * @param {object|null} props.user
+ * @param {string} [props.profilePath]
+ * @param {object[]} [props.accountMenuItems]
+ * @param {import('react').ReactNode} [props.accountSettings] los ajustes del proyecto, en el menú de la cuenta (SettingSection)
+ * @param {boolean} [props.vertical] en columna, para el menú lateral encogido
+ * @param {() => void} [props.onSignOut]
+ * @param {boolean} [props.isSigningOut]
+ */
+export default function HeaderTools({ headerActions, showFontSizeToggle, showLanguageToggle, showColorSchemeToggle, user, profilePath, accountMenuItems, onSignOut, isSigningOut, accountSettings, vertical, }: {
+    headerActions?: import('react').ReactNode;
+    showFontSizeToggle: boolean;
+    showLanguageToggle: boolean;
+    showColorSchemeToggle: boolean;
+    user: object | null;
+    profilePath?: string;
+    accountMenuItems?: object[];
+    accountSettings?: import('react').ReactNode;
+    vertical?: boolean;
+    onSignOut?: () => void;
+    isSigningOut?: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+/**
+ * @param {object} props
+ * @param {object[]} props.menuItems lo que regresa composeMenu
+ * @param {object|null} props.activeItem la entrada de la pantalla abierta
+ * @param {Record<string, number>} [props.menuBadges] los conteos del servidor por badgeKey
+ * @param {import('react').ReactNode} [props.account] la cuenta (o el engrane), en su círculo junto a la barra
+ * @param {import('react').ReactNode} [props.moreFooter] lo que va al final de la hoja de «Más» (la tarjeta del menú lateral)
+ * @param {boolean} [props.minimizeOnScroll] se encoge al leer hacia abajo; por omisión sí
+ */
+export default function MobileTabBar({ menuItems, activeItem, menuBadges, account, moreFooter, minimizeOnScroll }: {
+    menuItems: object[];
+    activeItem: object | null;
+    menuBadges?: Record<string, number>;
+    account?: import('react').ReactNode;
+    moreFooter?: import('react').ReactNode;
+    minimizeOnScroll?: boolean;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,13 @@
+/**
+ * @param {object} props
+ * @param {boolean} [props.showFontSize]
+ * @param {boolean} [props.showLanguage]
+ * @param {boolean} [props.showColorScheme]
+ * @param {import('react').ReactNode} [props.extraSettings] los ajustes del proyecto, debajo de los del paquete
+ */
+export default function SettingsMenu({ showFontSize, showLanguage, showColorScheme, extraSettings }: {
+    showFontSize?: boolean;
+    showLanguage?: boolean;
+    showColorScheme?: boolean;
+    extraSettings?: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,31 @@
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} [props.logo] el logo chico (28 px), el que se queda con el menú encogido
+ * @param {string} props.brandName el nombre de la app
+ * @param {string} [props.brandCaption] el renglón chico debajo del nombre («Panel de administración»)
+ * @param {string} props.homePath
+ * @param {object[]} props.menuItems lo que regresa composeMenu
+ * @param {object|null} props.activeItem
+ * @param {boolean} props.collapsed
+ * @param {import('react').ReactNode} [props.footer]
+ * @param {boolean} [props.showBrand] el logo y el nombre arriba; por omisión sí (en escritorio van en la barra)
+ * @param {() => void} [props.onNavigate]
+ * @param {Record<string, number>} [props.menuBadges] los conteos del servidor por badgeKey
+ * @param {import('react').ReactNode} [props.railTop] arriba del menú encogido que hace de barra: la ☰ y el logo
+ * @param {import('react').ReactNode} [props.railBottom] abajo de ese menú: los ajustes y la cuenta
+ */
+export default function SideMenu({ logo, brandName, brandCaption, homePath, menuItems, activeItem, collapsed, footer, showBrand, onNavigate, railTop, railBottom, menuBadges, }: {
+    logo?: import('react').ReactNode;
+    brandName: string;
+    brandCaption?: string;
+    homePath: string;
+    menuItems: object[];
+    activeItem: object | null;
+    collapsed: boolean;
+    footer?: import('react').ReactNode;
+    showBrand?: boolean;
+    onNavigate?: () => void;
+    menuBadges?: Record<string, number>;
+    railTop?: import('react').ReactNode;
+    railBottom?: import('react').ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+/**
+ * @param {object} props
+ * @param {object} props.menuItem una entrada de composeMenu
+ * @param {object|null} props.activeItem la entrada de la pantalla abierta
+ * @param {boolean} props.collapsed el menú está encogido (solo íconos)
+ * @param {() => void} [props.onNavigate] al elegir una pantalla (el cajón del teléfono se cierra)
+ * @param {Record<string, number>} [props.menuBadges] los conteos del servidor por badgeKey (menuBadgeOf)
+ * @param {number} [props.depth]
+ */
+export default function SideMenuEntry({ menuItem, activeItem, collapsed, onNavigate, menuBadges, depth }: {
+    menuItem: object;
+    activeItem: object | null;
+    collapsed: boolean;
+    onNavigate?: () => void;
+    menuBadges?: Record<string, number>;
+    depth?: number;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,24 @@
+/** Hacia dónde sale el menú: a la derecha del botón (menú lateral) o arriba de él (pestañas del teléfono). */
+export declare const SUBMENU_PLACEMENT: Readonly<{
+    side: "side";
+    above: "above";
+}>;
+/**
+ * @param {object} props
+ * @param {Element|null} props.anchorElement el botón del que cuelga (null = cerrado)
+ * @param {() => void} props.onClose
+ * @param {object} props.menuItem la entrada con sus hijas (children)
+ * @param {object|null} props.activeItem la entrada de la pantalla abierta
+ * @param {Record<string, number>} [props.menuBadges] los conteos del servidor por badgeKey
+ * @param {() => void} [props.onNavigate] al elegir una hija
+ * @param {'side'|'above'} [props.placement] SUBMENU_PLACEMENT; por omisión a la derecha
+ */
+export default function SubmenuActionsMenu({ anchorElement, onClose, menuItem, activeItem, menuBadges, onNavigate, placement }: {
+    anchorElement: Element | null;
+    onClose: () => void;
+    menuItem: object;
+    activeItem: object | null;
+    menuBadges?: Record<string, number>;
+    onNavigate?: () => void;
+    placement?: 'side' | 'above';
+}): import("react").JSX.Element;

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

@@ -0,0 +1,13 @@
+/**
+ * @param {object} props
+ * @param {object[]} props.menuItems todo el menú (lo que regresa composeMenu)
+ * @param {string[]} props.pinnedKeys las que van hoy en la barra (menuItemKeyOf)
+ * @param {(keys: string[]) => void} props.onDone con las elegidas, en el orden del menú
+ * @param {() => void} props.onReset regresar a las del proyecto
+ */
+export default function TabBarEditor({ menuItems, pinnedKeys, onDone, onReset }: {
+    menuItems: object[];
+    pinnedKeys: string[];
+    onDone: (keys: string[]) => void;
+    onReset: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+/**
+ * @param {{menuItems: object[], activeItem: object|null}} props
+ */
+export default function TopMenu({ menuItems, activeItem }: {
+    menuItems: object[];
+    activeItem: object | null;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+export declare const AppMenuContext: import("react").Context<{
+    menuItems: never[];
+}>;
+/**
+ * @returns {{menuItems: object[]}} lo que AppLayout recibió de composeMenu
+ */
+export declare function useAppMenu(): {
+    menuItems: object[];
+};

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

@@ -0,0 +1,35 @@
+/** Dónde quedó un botón de acción: en una cápsula, en el menú «⋯» o suelto. */
+export declare const BAR_ACTIONS_PLACEMENT: Readonly<{
+    capsule: "capsule";
+    menu: "menu";
+    inline: "inline";
+}>;
+export declare const BarActionsSlotContext: import("react").Context<{
+    slot: null;
+    phoneSlot: null;
+    usesCapsules: boolean;
+}>;
+export declare const BarActionsPlacementContext: import("react").Context<"inline">;
+export declare const BarActionsMenuCloseContext: import("react").Context<() => void>;
+/**
+ * @returns {{slot: Element|null, phoneSlot: Element|null, usesCapsules: boolean}} slot: el lugar de la barra en escritorio;
+ *     phoneSlot: el renglón flotante del teléfono; usesCapsules: la barra va en cápsulas
+ */
+export declare function useBarActionsSlot(): {
+    slot: Element | null;
+    phoneSlot: Element | null;
+    usesCapsules: boolean;
+};
+/**
+ * Dónde quedó lo que está adentro de BarActions (BAR_ACTIONS_PLACEMENT). Fuera de BarActions, 'inline'.
+ *
+ * @returns {string}
+ */
+export declare function useBarActionsPlacement(): string;
+/**
+ * En el menú «⋯» del teléfono, la función que lo cierra (para algo propio que haga su acción y deba cerrarlo); fuera de él
+ * no hace nada.
+ *
+ * @returns {() => void}
+ */
+export declare function useCloseBarActionsMenu(): () => void;

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

@@ -0,0 +1,9 @@
+/**
+ * @param {Element|null} anchorElement el botón que abre el menú
+ * @returns {{anchorOrigin: object, transformOrigin: object, gapSx: object}} para el <Menu> de MUI (gapSx va en el sx del papel)
+ */
+export declare function barMenuPlacementOf(anchorElement: Element | null): {
+    anchorOrigin: object;
+    transformOrigin: object;
+    gapSx: object;
+};

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

@@ -0,0 +1,55 @@
+/**
+ * El nombre de una entrada del menú.
+ *
+ * @param {{label?: string, labelKey?: string}} menuItem
+ * @param {(key: string) => string} t el traductor de la pantalla
+ * @returns {string}
+ */
+export declare function menuItemLabelOf(menuItem: {
+    label?: string;
+    labelKey?: string;
+}, t: (key: string) => string): string;
+/**
+ * Para qué sirve una entrada (para las tarjetas de un inicio).
+ *
+ * @param {{description?: string, descriptionKey?: string}} menuItem
+ * @param {(key: string) => string} t
+ * @returns {string|undefined}
+ */
+export declare function menuItemDescriptionOf(menuItem: {
+    description?: string;
+    descriptionKey?: string;
+}, t: (key: string) => string): string | undefined;
+/**
+ * El título de la sección del menú lateral donde va la entrada («Operación», «Administración»).
+ *
+ * @param {{section?: string, sectionKey?: string}} menuItem
+ * @param {(key: string) => string} t
+ * @returns {string|undefined}
+ */
+export declare function menuItemSectionOf(menuItem: {
+    section?: string;
+    sectionKey?: string;
+}, t: (key: string) => string): string | undefined;
+/**
+ * Las entradas juntas por sección: las secciones salen en el orden en que aparece su primera entrada, y adentro cada
+ * entrada en su orden. Las entradas sin sección forman su propio bloque sin título.
+ *
+ * Por qué por título y no por vecindad: con vecindad, dos módulos de la misma sección con un `order` de otra en medio
+ * partían la sección en dos («Interfaz» salía dos veces). Así cada módulo dice su sección sin coordinar números.
+ *
+ * @param {object[]} menuItems lo que regresa composeMenu
+ * @param {(key: string) => string} t
+ * @returns {Array<{title: string|undefined, menuItems: object[]}>}
+ */
+export declare function menuSectionsOf(menuItems: object[], t: (key: string) => string): Array<{
+    title: string | undefined;
+    menuItems: object[];
+}>;
+/**
+ * Las iniciales para el avatar: «Ana María López» → «AM», «Usuario de Ejemplo» → «UE». Sin nombre, «?».
+ *
+ * @param {string|null|undefined} fullName
+ * @returns {string}
+ */
+export declare function initialsOf(fullName: string | null | undefined): string;