@stackcraftmx/calcita 0.0.0-stage → 0.25.0

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

@@ -0,0 +1,16 @@
+/**
+ * @param {object} [props]
+ * @param {string} [props.message] ya traducido; por omisión el del paquete con el nombre de la app (appName de ToolkitProvider)
+ * @param {(outcome: 'accepted'|'dismissed'|null) => void} [props.onInstallChoice] lo que contestó la persona al diálogo de
+ *     instalar del navegador (Chrome, Edge, Android)
+ * @param {() => void} [props.onShowSteps] abrió los pasos para instalar (iPhone, iPad, Firefox de Android)
+ * @param {() => void} [props.onDismiss] dijo «Ahora no» (o cerró los pasos): no se le vuelve a ofrecer en este navegador
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function InstallPromptBanner({ message, onInstallChoice, onShowSteps, onDismiss, texts }?: {
+    message?: string;
+    onInstallChoice?: (outcome: 'accepted' | 'dismissed' | null) => void;
+    onShowSteps?: () => void;
+    onDismiss?: () => void;
+    texts?: object;
+}): import("react").JSX.Element | null;

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

@@ -0,0 +1,52 @@
+/**
+ * Lo que se le enseña a la persona. `native`: el navegador tiene su propio diálogo de instalar (un botón). Sin manera
+ * razonable de instalar (Android con Chromium antes de que avise, Safari o Firefox de escritorio) no hay variante (null)
+ * y no se enseña nada.
+ */
+export declare const INSTALL_VARIANT: Readonly<{
+    native: "native";
+    iosModern: "iosModern";
+    iosClassic: "iosClassic";
+    androidFirefox: "androidFirefox";
+}>;
+/**
+ * La versión mayor de iOS del user agent del iPhone («CPU iPhone OS 26_0 like Mac OS X» → 26). El iPad (iPadOS 13 en
+ * adelante) se presenta como «Macintosh» y no trae versión.
+ *
+ * @param {string} [userAgent]
+ * @returns {number|null} null si no se pudo leer
+ */
+export declare function parseIOSMajor(userAgent?: string): number | null;
+/**
+ * Describe el equipo a partir del navigator. Solo lee; no decide nada.
+ *
+ * @param {{userAgent?: string, maxTouchPoints?: number}} [navigatorLike] window.navigator o algo con su forma
+ * @returns {{userAgent: string, isIOS: boolean, isIPhone: boolean, isIPad: boolean, isAndroid: boolean, isFirefox: boolean, isSamsung: boolean, iosMajor: number|null}}
+ */
+export declare function detectPlatform(navigatorLike?: {
+    userAgent?: string;
+    maxTouchPoints?: number;
+}): {
+    userAgent: string;
+    isIOS: boolean;
+    isIPhone: boolean;
+    isIPad: boolean;
+    isAndroid: boolean;
+    isFirefox: boolean;
+    isSamsung: boolean;
+    iosMajor: number | null;
+};
+/**
+ * Qué enseñar.
+ *
+ * @param {object} options
+ * @param {ReturnType<typeof detectPlatform>} options.platform
+ * @param {boolean} options.canPromptNative el navegador ya avisó que se puede instalar (beforeinstallprompt)
+ * @param {boolean} options.isInstalled ya se abrió como app instalada
+ * @returns {string|null} una de INSTALL_VARIANT, o null si no hay nada que ofrecer
+ */
+export declare function resolveInstallVariant({ platform, canPromptNative, isInstalled }: {
+    platform: ReturnType<typeof detectPlatform>;
+    canPromptNative: boolean;
+    isInstalled: boolean;
+}): string | null;

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

@@ -0,0 +1,13 @@
+/**
+ * @returns {{variant: string|null, isInstalled: boolean, dismissed: boolean, dismiss: () => void, promptInstall: () => Promise<'accepted'|'dismissed'|null>}}
+ *     promptInstall regresa lo que contestó la persona al diálogo del navegador (null: ya no había diálogo)
+ *   variant: una de INSTALL_VARIANT o null (nada que ofrecer). NO toma en cuenta el «Ahora no»: la invitación sí lo respeta,
+ *   pero la entrada del menú de la cuenta no, porque ahí la persona la busca a propósito.
+ */
+export declare function useInstallPrompt(): {
+    variant: string | null;
+    isInstalled: boolean;
+    dismissed: boolean;
+    dismiss: () => void;
+    promptInstall: () => Promise<'accepted' | 'dismissed' | null>;
+};

package/dist/types/react-hook-form.d.ts

@@ -0,0 +1,12 @@
+export { Controller, FormProvider, useForm, useFormContext } from 'react-hook-form';
+export { yupResolver } from '@hookform/resolvers/yup';
+export { default as FormCatalogField } from './hookForm/FormCatalogField.js';
+export { default as FormColorField } from './hookForm/FormColorField.js';
+export { default as FormNumberField } from './hookForm/FormNumberField.js';
+export { default as FormProblemAlert } from './hookForm/FormProblemAlert.js';
+export { default as FormSelectField } from './hookForm/FormSelectField.js';
+export { default as FormWizard } from './hookForm/FormWizard.js';
+export { default as FormTextField } from './hookForm/FormTextField.js';
+export { default as SubmitButton } from './hookForm/SubmitButton.js';
+export { SERVER_PROBLEM_ROOT, applyServerProblem } from './hookForm/applyServerProblem.js';
+export { useHookFormField } from './hookForm/useHookFormField.js';

package/dist/types/react-router.d.ts

@@ -0,0 +1,2 @@
+export { reactRouterNavigation } from './adapters/reactRouter.js';
+export { RouteErrorScreen, useIsNavigating, withAccess, withChunkRecovery } from './adapters/reactRouterRoutes.js';

package/dist/types/security/ActivityLog.d.ts

@@ -0,0 +1,33 @@
+/** Los tipos de evento que el paquete conoce, con su texto en security:activity.kinds. */
+export declare const ACCOUNT_EVENT_KIND: Readonly<{
+    signedIn: "signedIn";
+    signInFailed: "signInFailed";
+    signedOut: "signedOut";
+    passwordChanged: "passwordChanged";
+    twoStepEnabled: "twoStepEnabled";
+    twoStepDisabled: "twoStepDisabled";
+    passkeyAdded: "passkeyAdded";
+    passkeyRemoved: "passkeyRemoved";
+    recoveryCodesGenerated: "recoveryCodesGenerated";
+    recoveryCodeUsed: "recoveryCodeUsed";
+    sessionsClosed: "sessionsClosed";
+}>;
+/**
+ * @param {object} props
+ * @param {Array<{id: string, kind: string, occurredAt: string, device?: string|null, network?: string|null, description?: string}>|null} props.events
+ *     del más nuevo al más viejo; null mientras llegan
+ * @param {string|null} [props.error] ya traducido si no se pudieron traer
+ * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
+ */
+export default function ActivityLog({ events, error, texts }: {
+    events: Array<{
+        id: string;
+        kind: string;
+        occurredAt: string;
+        device?: string | null;
+        network?: string | null;
+        description?: string;
+    }> | null;
+    error?: string | null;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/security/RecoveryCodesDialog.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {object} props
+ * @param {string[]|null} props.codes los códigos recién generados; sin códigos el diálogo está cerrado
+ * @param {string} [props.account] la cuenta (normalmente el correo), para el archivo
+ * @param {() => void} props.onClose solo se llama después de «Ya los guardé»
+ * @param {(method: 'copy'|'download') => void} [props.onCodesSaved] la persona los copió o los descargó (para la bitácora de
+ *     seguridad)
+ * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
+ */
+export default function RecoveryCodesDialog({ codes, account, onClose, onCodesSaved, texts }: {
+    codes: string[] | null;
+    account?: string;
+    onClose: () => void;
+    onCodesSaved?: (method: 'copy' | 'download') => void;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/security/SessionsCard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @param {object} props
+ * @param {Array<{id: string, browser?: string|null, platform?: string|null, isMobile?: boolean, startedAt: string, network?: string|null, isCurrent?: boolean}>|null} props.sessions
+ *     null mientras llegan
+ * @param {string|null} [props.error] ya traducido (ApiError.message) si no se pudieron traer
+ * @param {() => Promise<number>} props.onCloseOthers cierra las demás; regresa cuántas cerró
+ * @param {() => void} [props.onClosed] p. ej. volver a pedir la lista
+ * @param {object} [props.texts] los textos que cambian, con la forma de `security` en los textos del paquete
+ */
+export default function SessionsCard({ sessions, error, onCloseOthers, onClosed, texts }: {
+    sessions: Array<{
+        id: string;
+        browser?: string | null;
+        platform?: string | null;
+        isMobile?: boolean;
+        startedAt: string;
+        network?: string | null;
+        isCurrent?: boolean;
+    }> | null;
+    error?: string | null;
+    onCloseOthers: () => Promise<number>;
+    onClosed?: () => void;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/security/passkeys.d.ts

@@ -0,0 +1,18 @@
+/** ¿El navegador sabe usar llaves de acceso? */
+export declare function passkeysSupported(): boolean;
+/**
+ * Crea una llave de acceso nueva con las opciones del servidor. Regresa lo que hay que mandarle para que la guarde.
+ *
+ * @param {object} options las opciones de registro del servidor (PublicKeyCredentialCreationOptionsJSON)
+ * @returns {Promise<object>} la respuesta del navegador (RegistrationResponseJSON)
+ * @throws {Error & {cancelled: boolean}} con el mensaje ya traducido
+ */
+export declare function createPasskey(options: object): Promise<object>;
+/**
+ * Firma el reto del servidor con una llave. Sin allowCredentials en las opciones, el navegador ofrece las que tenga.
+ *
+ * @param {object} options las opciones de entrada del servidor (PublicKeyCredentialRequestOptionsJSON)
+ * @returns {Promise<object>} la respuesta del navegador (AuthenticationResponseJSON)
+ * @throws {Error & {cancelled: boolean}} con el mensaje ya traducido
+ */
+export declare function signWithPasskey(options: object): Promise<object>;

package/dist/types/table.d.ts

@@ -0,0 +1,3 @@
+export { AuditTrailDialog, AuditTrailTable, EmptyState, FILTER_KINDS, FilterChips, GoToPage, SELECTION_PHONE_LAYOUT, ServerTable, TableFilterContext, buildChipConfig, buildTableActors, detailColumn, facetColumn, isFilterActive, tableMachine, textColumn, toServerTableParams, useDebouncedFilter, useTableFilter, useTableState, } from './DataTable/index.js';
+export type RowSelection = import('./DataTable/rowSelection.js').RowSelection;
+/** @typedef {import('./DataTable/rowSelection.js').RowSelection} RowSelection */

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

@@ -0,0 +1,11 @@
+/**
+ * @param {{userAgent?: string|null, userAgentData?: {platform?: string}|null}|null} [navigatorLike] por omisión el del
+ *     navegador; se pasa a mano en el servidor o en pruebas
+ * @returns {boolean}
+ */
+export declare function isAndroidDevice(navigatorLike?: {
+    userAgent?: string | null;
+    userAgentData?: {
+        platform?: string;
+    } | null;
+} | null): boolean;

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

@@ -0,0 +1,17 @@
+/**
+ * El tracking de un tamaño, en em. Entre dos tamaños de la tabla se reparte en línea recta; fuera de ella, el del extremo.
+ *
+ * @param {number} sizePixels
+ * @returns {string} p. ej. '-0.02em'
+ */
+export declare function trackingOf(sizePixels: number): string;
+/**
+ * Un tamaño de letra con SU espaciado: lo que se pone en el sx de un componente que cambia el tamaño de su letra.
+ *
+ * @param {number} sizePixels
+ * @returns {{fontSize: string, letterSpacing: string}} el tamaño en rem (crece con el tamaño de letra que elige la persona)
+ */
+export declare function textSizeOf(sizePixels: number): {
+    fontSize: string;
+    letterSpacing: string;
+};

package/dist/types/theme/components/MuiAppBar.d.ts

@@ -0,0 +1,13 @@
+export declare function MuiAppBar(): {
+    MuiAppBar: {
+        defaultProps: {
+            elevation: number;
+        };
+        styleOverrides: {
+            root: ({ ownerState, theme }: {
+                ownerState: any;
+                theme: any;
+            }) => any;
+        };
+    };
+};

package/dist/types/theme/components/MuiBackdrop.d.ts

@@ -0,0 +1,11 @@
+export declare function MuiBackdrop(): {
+    MuiBackdrop: {
+        styleOverrides: {
+            root: {
+                '&:not(.MuiBackdrop-invisible)': {
+                    backgroundColor: string;
+                };
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiButton.d.ts

@@ -0,0 +1,27 @@
+export declare function MuiButton(): {
+    MuiButton: {
+        defaultProps: {
+            disableElevation: boolean;
+        };
+        styleOverrides: {
+            root: ({ theme }: {
+                theme: any;
+            }) => {
+                textTransform: string;
+                fontWeight: number;
+                '&:focus-visible': {
+                    outline: string;
+                    outlineOffset: number;
+                };
+            };
+            sizeSmall: ({ theme }: {
+                theme: any;
+            }) => {
+                [x: number]: {
+                    minHeight: number;
+                };
+                minHeight: number;
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiButtonBase.d.ts

@@ -0,0 +1,14 @@
+export declare function MuiButtonBase(): {
+    MuiButtonBase: {
+        styleOverrides: {
+            root: ({ theme }: {
+                theme: any;
+            }) => {
+                '&:focus-visible': {
+                    outline: string;
+                    outlineOffset: number;
+                };
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiChip.d.ts

@@ -0,0 +1,29 @@
+export declare function MuiChip(): {
+    MuiChip: {
+        styleOverrides: {
+            root: ({ ownerState, theme }: {
+                ownerState: any;
+                theme: any;
+            }) => {
+                backgroundColor?: undefined;
+                color?: undefined;
+                border?: undefined;
+            } | {
+                backgroundColor: any;
+                color: any;
+                border: string;
+            };
+            sizeSmall: ({ ownerState, theme }: {
+                ownerState: any;
+                theme: any;
+            }) => {
+                height?: undefined;
+            } | {
+                [x: number]: {
+                    height: number;
+                };
+                height: number;
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiDataGrid.d.ts

@@ -0,0 +1,45 @@
+export declare function MuiDataGrid(): {
+    MuiDataGrid: {
+        styleOverrides: {
+            root: ({ theme }: {
+                theme: any;
+            }) => {
+                '--DataGrid-rowBorderColor': any;
+                border: string;
+            };
+            columnHeaders: ({ theme }: {
+                theme: any;
+            }) => {
+                backgroundColor: any;
+            };
+            columnHeader: ({ theme }: {
+                theme: any;
+            }) => {
+                fontWeight: number;
+                color: any;
+                '&:focus, &:focus-within': {
+                    outline: string;
+                    outlineOffset: number;
+                };
+            };
+            row: ({ theme }: {
+                theme: any;
+            }) => {
+                '&:hover': {
+                    backgroundColor: any;
+                };
+                '&.Mui-selected, &.Mui-selected:hover': {
+                    backgroundColor: any;
+                };
+            };
+            cell: ({ theme }: {
+                theme: any;
+            }) => {
+                '&:focus, &:focus-within': {
+                    outline: string;
+                    outlineOffset: number;
+                };
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiDialog.d.ts

@@ -0,0 +1,9 @@
+export declare function MuiDialog(): {
+    MuiDialog: {
+        styleOverrides: {
+            paper: {
+                outline: number;
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiDrawer.d.ts

@@ -0,0 +1,13 @@
+export declare function MuiDrawer(): {
+    MuiDrawer: {
+        styleOverrides: {
+            paper: ({ theme }: {
+                theme: any;
+            }) => {
+                backgroundColor: any;
+                color: any;
+                borderRight: string;
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiMenuItem.d.ts

@@ -0,0 +1,17 @@
+export declare function MuiMenuItem(): {
+    MuiMenuItem: {
+        styleOverrides: {
+            root: ({ theme }: {
+                theme: any;
+            }) => {
+                '&:focus-visible': {
+                    outline: string;
+                    backgroundColor: any;
+                };
+                '&.Mui-selected:focus-visible': {
+                    backgroundColor: any;
+                };
+            };
+        };
+    };
+};

package/dist/types/theme/components/MuiTypography.d.ts

@@ -0,0 +1,20 @@
+export declare function MuiTypography(): {
+    MuiCssBaseline: {
+        styleOverrides: {
+            body: {
+                letterSpacing: number;
+            };
+        };
+    };
+    MuiTypography: {
+        styleOverrides: {
+            caption: {
+                fontWeight: number;
+            };
+            overline: {
+                fontWeight: number;
+                letterSpacing: string;
+            };
+        };
+    };
+};

package/dist/types/theme/components/glassComponents.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @param {object} [options]
+ * @param {boolean} [options.surfaces] también el contenido (tarjetas, acordeón, avisos, tabla) con material; por omisión no
+ * @returns {object} el `components` del tema de MUI
+ */
+export declare function glassComponents({ surfaces }?: {
+    surfaces?: boolean;
+}): object;

package/dist/types/theme/components/minimalComponents.d.ts

@@ -0,0 +1,22 @@
+/** Los fondos del minimalista: el gris agrupado de Apple y la tarjeta un escalón arriba, en claro y en oscuro. */
+export declare const MINIMAL_BACKGROUND: Readonly<{
+    light: {
+        default: string;
+        paper: string;
+    };
+    dark: {
+        default: string;
+        paper: string;
+    };
+}>;
+/**
+ * La superficie de lo que flota en el minimalista, sólida, en claro y en oscuro.
+ *
+ * @param {object} theme
+ * @returns {object}
+ */
+export declare function minimalFloatingStylesOf(theme: object): object;
+/**
+ * @returns {object} el `components` del tema de MUI para el estilo minimalista
+ */
+export declare function minimalComponents(): object;

package/dist/types/theme/components/paletteOf.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {object} theme el tema de MUI
+ * @returns {object} la paleta (con variables CSS si las hay)
+ */
+export declare function paletteOf(theme: object): object;

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

@@ -0,0 +1,48 @@
+/** El estilo del tema: el de Stackcraft (con vidrio o sin él) o el minimalista, plano y tonal. */
+export declare const THEME_LOOK: Readonly<{
+    standard: "standard";
+    minimal: "minimal";
+}>;
+/**
+ * La barra de arriba, con vidrio y con el minimalista: por omisión como las ventanas de macOS Tahoe, sin franja (el nombre
+ * y los botones en cápsulas por grupo; lo eligió el autor al verlas), o la franja de lado a lado. Con vidrio las cápsulas
+ * son de vidrio y el contenido pasa por debajo desenfocado; con el minimalista son bloques del tono de las tarjetas sobre
+ * el color del fondo (AppLayout). El estilo de Stackcraft sin vidrio se queda con su barra de siempre.
+ */
+export declare const TOP_BAR: Readonly<{
+    band: "band";
+    capsules: "capsules";
+}>;
+/**
+ * @param {object} [options]
+ * @param {{light?: object|boolean, dark?: object|boolean}} [options.colorSchemes] los colores de cada modo; por omisión los de
+ *     Stackcraft; true: los de MUI tal cual
+ * @param {'class'|'data'|'media'|string} [options.colorSchemeSelector] cómo se elige el modo; por omisión 'class'
+ * @param {string} [options.fontFamily] por omisión la letra del sistema
+ * @param {boolean|{opacity?: number, surfaces?: boolean}} [options.glass] vidrio líquido en lo que flota y en los
+ *     controles; por omisión no. Con {opacity} se elige qué tan opaco (0 a 1; por omisión GLASS_OPACITY, 0.6) y con
+ *     {surfaces: true} también las tarjetas del contenido (por omisión sólidas, como pide la guía; avisa en consola)
+ * @param {'standard'|'minimal'} [options.look] el estilo (THEME_LOOK): el de Stackcraft (por omisión) o el minimalista,
+ *     plano y tonal (sin bordes ni sombras: las superficies se separan por su tono; sin vidrio aunque se pida)
+ * @param {'capsules'|'band'} [options.bar] la barra de arriba con vidrio o con el minimalista (TOP_BAR): por omisión en
+ *     cápsulas; 'band' la franja de lado a lado
+ * @param {object} [options.components] ajustes propios de componentes (se suman; en el mismo estilo ganan los del proyecto)
+ * @param {object} [options.overrides] cualquier otra cosa de createTheme (breakpoints, spacing…)
+ * @returns {object} el tema de MUI
+ */
+export declare function createToolkitTheme({ colorSchemes, colorSchemeSelector, fontFamily, glass, look, bar, components, overrides, }?: {
+    colorSchemes?: {
+        light?: object | boolean;
+        dark?: object | boolean;
+    };
+    colorSchemeSelector?: 'class' | 'data' | 'media' | string;
+    fontFamily?: string;
+    glass?: boolean | {
+        opacity?: number;
+        surfaces?: boolean;
+    };
+    look?: 'standard' | 'minimal';
+    bar?: 'capsules' | 'band';
+    components?: object;
+    overrides?: object;
+}): object;