@stackcraftmx/calcita 0.0.0-stage → 0.25.0

package/dist/types/index.d.ts

@@ -0,0 +1,91 @@
+export { ToolkitProvider } from './toolkit/ToolkitProvider.js';
+export { useToolkitNavigation, useToolkitSettings } from './toolkit/toolkitContext.js';
+export { useToolkitTranslation } from './toolkit/useToolkitTranslation.js';
+export { default as ComponentTexts } from './toolkit/ComponentTexts.js';
+export { DEFAULT_CURRENCY, DEFAULT_LANGUAGE, DEFAULT_LANGUAGES, configureToolkit, toolkitSettings, translateToolkit } from './toolkit/toolkitSettings.js';
+export { browserNavigation, createBrowserNavigation } from './toolkit/browserNavigation.js';
+export { createHashNavigation } from './toolkit/hashNavigation.js';
+export { default as toolkitTextsEs } from './locales/es.js';
+export { default as toolkitTextsEn } from './locales/en.js';
+export { ConfirmDialog, ModalWaiting, NEW_BUILD_NOTICE_VARIANT, NewBuildNotice, StaleBuildBoundary, TOAST_DEFAULT_OPTIONS, Toaster, confirmActionMachine, dismissToast, errorsObjectToMessage, toastDefault, toastError, toastInfo, toastLoading, toastProblem, toastPromise, toastSuccess, toastWarn, useConfirmAction, } from './feedback/index.js';
+export { DEFAULT_FILE_TYPES, DOWNLOAD_STATUS, DownloadManager, UNKNOWN_FILE_TYPE, cancelDownload, clearFinishedDownloads, downloadsMachine, startDownload, useFileTypes, } from './downloads/index.js';
+export { THEME_LOOK, TOP_BAR, createToolkitTheme } from './theme/createToolkitTheme.js';
+export { isAndroidDevice } from './theme/androidDevice.js';
+export { MINIMAL_BACKGROUND } from './theme/components/minimalComponents.js';
+export { STACKCRAFT, stackcraftDarkPalette, stackcraftLightPalette } from './theme/stackcraftPalette.js';
+export { toolkitComponents } from './theme/toolkitComponents.js';
+export { mergeComponents } from './theme/mergeComponents.js';
+export { GLASS_INSET_PIXELS, GLASS_MENU_RADIUS_PIXELS, GLASS_OPACITY, GLASS_PANEL_RADIUS_PIXELS, ambientBackgroundOf, glassDropOf, glassStylesOf, glassSurfaceOf, accentTextStylesOf, canvasFieldStylesOf, fieldWellStylesOf, fixedBackgroundLayerOf, isGlassTheme, materialBackgroundOf, materialStylesOf, materialSurfaceOf, scrollEdgeStylesOf, } from './theme/glassSurface.js';
+export { AppLayout, MENU_POSITION } from './appShell/AppLayout.js';
+export { AuthLayout } from './appShell/AuthLayout.js';
+export { default as BarActions } from './appShell/BarActions.js';
+export { default as BarActionButton } from './appShell/BarActionButton.js';
+export { default as BarSearch } from './appShell/BarSearch.js';
+export { default as ActionsMenu } from './ui/actions/ActionsMenu.js';
+export { SELECTION_PHONE_LAYOUT, default as SelectionActions, selectionFloatsOnPhone } from './ui/actions/SelectionActions.js';
+export { BAR_ACTIONS_PLACEMENT, useBarActionsPlacement, useCloseBarActionsMenu } from './appShell/barActionsSlot.js';
+export { BAR_CAPSULE_HEIGHT_PIXELS, default as BarCapsule } from './appShell/BarCapsule.js';
+export { usesMobileTabBar } from './appShell/tabBarRule.js';
+export { SettingSection, default as AppearanceSettings } from './appShell/AppearanceSettings.js';
+export { barMenuPlacementOf } from './appShell/barMenuPlacement.js';
+export { DRAWER_WIDTH_COLLAPSED, DRAWER_WIDTH_EXPANDED, MAIN_CONTENT_ID } from './appShell/shellSizes.js';
+export { useAppMenu } from './appShell/appMenuContext.js';
+export { usePageTitle } from './appShell/pageTitle.js';
+export { initialsOf, menuItemDescriptionOf, menuItemLabelOf, menuItemSectionOf, menuSectionsOf } from './appShell/menuItemText.js';
+export { activeMenuItemOf, composeMenu, menuBadgeOf, menuBreadcrumbsOf, mobileTabsOf, parentMenuItemOf, screenMenuItemsOf } from './navigation/appMenu.js';
+export { menuBadgesFrom, useMenuBadges } from './navigation/useMenuBadges.js';
+export { allowOnlyUnrestricted, createAccessChecker } from './access/accessRules.js';
+export { default as Can } from './access/Can.js';
+export { default as RequireAccess } from './access/RequireAccess.js';
+export { useAccessChecker, useCan } from './access/useCan.js';
+export { default as PermissionMatrix } from './access/PermissionMatrix.js';
+export { composePermissionGroups, groupStateOf, withPermission, withPermissionGroup } from './access/permissionGroups.js';
+export { DEFAULT_PASSWORD_POLICY, PASSWORD_RULE, isPasswordAccepted, passwordChecksOf } from './auth/passwordRules.js';
+export { default as PasswordChecklist } from './auth/PasswordChecklist.js';
+export { ERROR_PAGE_KIND, default as ErrorPage } from './ui/layout/ErrorPage.js';
+export { default as FileDropzone } from './upload/FileDropzone.js';
+export { FILE_ACCEPT_PRESETS, FILE_REJECTION, matchesAccept, parseFileSize, resolveAccept } from './upload/fileRules.js';
+export { buildUploadActors, uploadMachine } from './upload/uploadMachine.js';
+export { uploadWithProgress } from './upload/uploadWithProgress.js';
+export { APP_BAR_HEIGHT_CSS_VARIABLE, BackButton, CHART_VIEW, CalendarHeatmap, CollapsibleSection, ColorSchemeToggle, ContentDialog, CopyButton, DateRangeFilter, DefinitionList, DetailHeader, DictionaryText, DocumentTitle, DownloadMenu, FONT_SIZE_LEVELS, FontSizeToggle, FullPageLoader, GlassLensFilter, GlassPanel, LANGUAGES, LanguageToggle, MetricCard, PageBreadcrumbs, PageHeader, PageHeading, ProfileHeader, TREND_DIRECTION, PeriodRangeSelector, QuickFilters, SCROLL_MARGIN_BELOW_APP_BAR, SEGMENTED_CONTROL_SX, ScrollableRow, SecretField, SectionCard, SegmentedControl, StatusChip, TableToggle, Tag, scrollableRow, useAppBarHeightPublisher, } from './ui/index.js';
+export { default as CatalogInput } from './inputs/CatalogInput.js';
+export { default as ColorInput } from './inputs/ColorInput.js';
+export { default as FieldFrame } from './inputs/FieldFrame.js';
+export { FORM_ROW_CLASS, FormRow, default as FormSection } from './inputs/FormSection.js';
+export { default as NumberInput } from './inputs/NumberInput.js';
+export { default as SelectInput } from './inputs/SelectInput.js';
+export { default as WizardLayout } from './inputs/WizardLayout.js';
+export { default as TextInput } from './inputs/TextInput.js';
+export { HEX_COLOR, MIN_CONTRAST, contrastOnWhite, readableVariantOf } from './inputs/colorContrast.js';
+export { cleanNumberText, completeDecimals, groupThousands } from './inputs/numberText.js';
+export { translateValidationMessage } from './forms/validationMessages.js';
+export { dictionaryEntryOf, labelOf, lookup, shortLabelOf } from './dictionaries/dictionaries.js';
+export { dayOfPlainDate, formatCurrency, formatDate, formatDateTime, formatFileSize, formatList, formatMonthName, formatMonthShortName, formatNumber, formatPercent, formatTime, formatWeekdayShortName, formattersOf, } from './formatting.js';
+export { useFormatters } from './toolkit/useFormatters.js';
+export { parseInstant, parsePlainDate } from './dates.js';
+export { fieldErrorsOf, problemMessage, problemTitle } from './problems.js';
+export { newIdentifier } from './identifiers.js';
+export { XLSX_CONTENT_TYPE, fileNameFromContentDisposition, isCompleteZip, saveBlob } from './files.js';
+export { REDIRECT_PARAM, readRedirectParam, safeInternalPath, withRedirect } from './navigation.js';
+export { recallListUrl, rememberListUrl, useRememberListUrl } from './lastListUrl.js';
+export { currentHistoryIndex, forgetPageName, pageNameAt, rememberPageName, useNavigationTrail, usePageName } from './navigationTrail.js';
+export { periodRangeIsValid, rangeEndAfterStartChange, rangeEndOptionsOf } from './periodRanges.js';
+export { createLogger, setLogLevel } from './observability/logger.js';
+export { isNewBuildPublished, reportPublishedBuild, useNewBuildPublished } from './observability/publishedBuild.js';
+export { BUILD_WATCH_ACTION, buildWatchActionOf, publishedBuildIdOf } from './observability/buildWatch.js';
+export { usePublishedBuildWatch } from './observability/usePublishedBuildWatch.js';
+export { API_ERROR_STATUS, ApiError } from './api/ApiError.js';
+export { API_RESPONSE_PARSE, apiUrlOf, createApiClient } from './api/createApiClient.js';
+export { isStaleChunkError, recoverFromStaleChunk } from './api/staleChunks.js';
+export { ACCOUNT_EVENT_KIND, default as ActivityLog } from './security/ActivityLog.js';
+export { default as RecoveryCodesDialog } from './security/RecoveryCodesDialog.js';
+export { default as SessionsCard } from './security/SessionsCard.js';
+export { default as InboxLayout } from './inbox/InboxLayout.js';
+export { default as MessageList } from './inbox/MessageList.js';
+export { default as MessageView } from './inbox/MessageView.js';
+export { inboxDateOf } from './inbox/inboxDates.js';
+export { INSTALL_VARIANT, detectPlatform, parseIOSMajor, resolveInstallVariant } from './pwa/installInstructions.js';
+export { useInstallPrompt } from './pwa/useInstallPrompt.js';
+export { default as InstallInstructionsDialog, variantHasInstructions } from './pwa/InstallInstructionsDialog.js';
+export { default as InstallPromptBanner } from './pwa/InstallPromptBanner.js';
+export { default as InstallAppSetting } from './pwa/InstallAppSetting.js';

package/dist/types/inputs/CatalogInput.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|string[]|null|undefined} props.value la clave elegida ('' = ninguna); con multiple, la lista ([] = ninguna)
+ * @param {(code: any) => void} props.onChange recibe la clave ('' al borrar); con multiple, la lista de claves
+ * @param {() => void} [props.onBlur]
+ * @param {Array<{code: string, label: string}>} props.options
+ * @param {(option: {code: string, label: string}) => string} [props.formatLabel] por omisión «Nombre (clave)»
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText]
+ * @param {boolean} [props.loading] el catálogo todavía no llega
+ * @param {string} [props.placeholder] la pista con el campo vacío, ya traducida (p. ej. «Busque un estado»): sin ella, en un
+ *     formulario agrupado el campo vacío solo enseña su botón y no se entiende qué es
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {boolean} [props.multiple] elegir varias claves
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function CatalogInput({ name, label, value, onChange, onBlur, options, formatLabel, error, helperText, loading, disabled, inputRef, placeholder, multiple, texts, }: {
+    name?: string;
+    label: string;
+    value: string | string[] | null | undefined;
+    onChange: (code: any) => void;
+    onBlur?: () => void;
+    options: Array<{
+        code: string;
+        label: string;
+    }>;
+    formatLabel?: (option: {
+        code: string;
+        label: string;
+    }) => string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    loading?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    multiple?: boolean;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/ColorInput.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|null|undefined} props.value '#RRGGBB' o ''
+ * @param {(color: string) => void} props.onChange recibe el color en mayúsculas
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText] cuando no hay color
+ * @param {boolean} [props.checkContrast] avisa si casi no se lee sobre blanco (por omisión sí)
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function ColorInput({ name, label, value, onChange, onBlur, error, helperText, checkContrast, disabled, inputRef, texts, }: {
+    name?: string;
+    label: string;
+    value: string | null | undefined;
+    onChange: (color: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    checkContrast?: boolean;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/FieldFrame.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @param {object} props
+ * @param {string} props.inputId el id del campo (la etiqueta lo nombra para el lector de pantalla)
+ * @param {string} [props.labelId] el id de la etiqueta, para un campo que no es un <input> (la lista desplegable de MUI es un
+ *     div: `for` no la une con su etiqueta y el campo la nombra con aria-labelledby)
+ * @param {import('react').ReactNode} props.label ya traducida
+ * @param {import('react').ReactNode} props.children el campo
+ */
+export default function FieldFrame({ inputId, labelId, label, children }: {
+    inputId: string;
+    labelId?: string;
+    label: import('react').ReactNode;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;

package/dist/types/inputs/FormSection.d.ts

@@ -0,0 +1,29 @@
+/** La clase de cada renglón: la sección le dibuja su línea de arriba, esté donde esté adentro de la tarjeta. */
+export declare const FORM_ROW_CLASS = "calcita-form-row";
+/**
+ * Un renglón del formulario agrupado: la etiqueta a la izquierda y lo que sea a la derecha (un campo, un interruptor, un
+ * texto). Los campos del framework lo usan solos dentro de una FormSection; FormRow suelto es para lo demás.
+ *
+ * @param {object} props
+ * @param {import('react').ReactNode} props.label ya traducida
+ * @param {string} [props.htmlFor] el id del campo que nombra la etiqueta
+ * @param {string} [props.labelId] el id de la etiqueta (para un campo que la nombra con aria-labelledby)
+ * @param {import('react').ReactNode} props.children
+ */
+export declare function FormRow({ label, htmlFor, labelId, children }: {
+    label: import('react').ReactNode;
+    htmlFor?: string;
+    labelId?: string;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;
+/**
+ * @param {object} props
+ * @param {string} [props.title] ya traducido; va arriba de la tarjeta
+ * @param {import('react').ReactNode} [props.footer] la explicación, abajo de la tarjeta
+ * @param {import('react').ReactNode} props.children los campos, directo o dentro de un Grid, un Stack o un componente propio
+ */
+export default function FormSection({ title, footer, children }: {
+    title?: string;
+    footer?: import('react').ReactNode;
+    children: import('react').ReactNode;
+}): import("react").JSX.Element;

package/dist/types/inputs/NumberInput.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|number|null|undefined} props.value el texto limpio ('2850000.50'); '' = vacío
+ * @param {(value: string) => void} props.onChange recibe el texto limpio
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText]
+ * @param {number} [props.decimals] por omisión 2
+ * @param {boolean} [props.allowNegative]
+ * @param {import('react').ReactNode} [props.prefix] p. ej. «$»
+ * @param {import('react').ReactNode} [props.suffix] p. ej. «MXN» o «%»
+ * @param {number} [props.maxDigits] tope de dígitos (por omisión 17)
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function NumberInput({ name, label, value, onChange, onBlur, error, helperText, decimals, allowNegative, prefix, suffix, maxDigits, disabled, inputRef, texts, }: {
+    name?: string;
+    label: string;
+    value: string | number | null | undefined;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    decimals?: number;
+    allowNegative?: boolean;
+    prefix?: import('react').ReactNode;
+    suffix?: import('react').ReactNode;
+    maxDigits?: number;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/SelectInput.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|number|Array<string|number>|null|undefined} props.value '' = sin elegir; con multiple, la lista ([] = ninguna)
+ * @param {(value: any) => void} props.onChange recibe el valor elegido (con multiple, la lista), no el evento
+ * @param {() => void} [props.onBlur]
+ * @param {Array<{value: string|number, label: string, description?: string}>} props.options
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText] ayuda fija; el error la reemplaza
+ * @param {string} [props.placeholder] texto de la opción vacía
+ * @param {boolean} [props.disabled]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]
+ * @param {boolean} [props.multiple] elegir varias opciones
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function SelectInput({ name, label, value, onChange, onBlur, options, error, helperText, placeholder, disabled, inputRef, multiple, texts, }: {
+    name?: string;
+    label: string;
+    value: string | number | Array<string | number> | null | undefined;
+    onChange: (value: any) => void;
+    onBlur?: () => void;
+    options: Array<{
+        value: string | number;
+        label: string;
+        description?: string;
+    }>;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    multiple?: boolean;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/TextInput.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {string} props.label ya traducido
+ * @param {string|null|undefined} props.value
+ * @param {(value: string) => void} props.onChange recibe el texto, no el evento
+ * @param {() => void} [props.onBlur]
+ * @param {string|{key: string, values?: object}} [props.error] el error a enseñar (undefined = sin error)
+ * @param {string} [props.type] 'password' agrega el ojo
+ * @param {string} [props.helperText] ayuda fija; el error la reemplaza
+ * @param {string} [props.placeholder] ya traducido; el ejemplo de qué escribir (se va al escribir)
+ * @param {import('react').ReactNode} [props.startAdornment]
+ * @param {import('react').ReactNode} [props.endAdornment] adorno al final (en contraseñas manda el ojo)
+ * @param {boolean} [props.uppercase] normaliza a mayúsculas mientras se escribe
+ * @param {(value: string) => string} [props.normalizeOnBlur]
+ * @param {import('react').Ref<HTMLInputElement>} [props.inputRef] para enfocar el campo (react-hook-form lo usa)
+ * @param {boolean} [props.clearable] la ⓧ para borrar el texto; por omisión sí (no en contraseñas ni con adorno propio)
+ * @param {boolean} [props.multiline] (y lo demás de TextField de MUI: minRows, autoComplete, autoFocus, slotProps, sx…)
+ * @param {number} [props.minRows]
+ * @param {number} [props.maxRows]
+ * @param {string} [props.autoComplete]
+ * @param {boolean} [props.autoFocus]
+ * @param {boolean} [props.disabled]
+ * @param {boolean} [props.required]
+ * @param {boolean} [props.fullWidth]
+ * @param {string} [props.id]
+ * @param {object} [props.slotProps]
+ * @param {object} [props.sx]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
+ */
+export default function TextInput({ name, label, value, onChange, onBlur, error, type, helperText, startAdornment, endAdornment: customEndAdornment, uppercase, normalizeOnBlur, inputRef, clearable, texts, ...textFieldProps }: {
+    name?: string;
+    label: string;
+    value: string | null | undefined;
+    onChange: (value: string) => void;
+    onBlur?: () => void;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    type?: string;
+    helperText?: string;
+    placeholder?: string;
+    startAdornment?: import('react').ReactNode;
+    endAdornment?: import('react').ReactNode;
+    uppercase?: boolean;
+    normalizeOnBlur?: (value: string) => string;
+    inputRef?: import('react').Ref<HTMLInputElement>;
+    clearable?: boolean;
+    multiline?: boolean;
+    minRows?: number;
+    maxRows?: number;
+    autoComplete?: string;
+    autoFocus?: boolean;
+    disabled?: boolean;
+    required?: boolean;
+    fullWidth?: boolean;
+    id?: string;
+    slotProps?: object;
+    sx?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/WizardLayout.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @param {object} props
+ * @param {Object[]} props.steps en orden
+ * @param {string} props.steps[].key
+ * @param {string} props.steps[].label ya traducido
+ * @param {boolean} [props.steps[].optional] se puede omitir
+ * @param {import('react').ReactNode} props.steps[].content los campos del paso
+ * @param {number} props.activeIndex el paso que se ve
+ * @param {Set<string>} props.skippedKeys los pasos omitidos
+ * @param {boolean} [props.isSubmitting] mientras se envía, «Anterior» se apaga
+ * @param {() => void} props.onBack
+ * @param {() => void} props.onNext
+ * @param {() => void} props.onSkip
+ * @param {import('react').ReactNode} props.submitButton el botón de enviar del último paso
+ * @param {import('react').ReactNode} [props.problemAlert] el aviso de errores del servidor, arriba de los botones del último paso
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common`: {wizard: {next, back, skip, optional, skipped, stepOf}}
+ */
+export default function WizardLayout({ steps, activeIndex, skippedKeys, isSubmitting, onBack, onNext, onSkip, submitButton, problemAlert, texts, }: {
+    steps: {
+        key: string;
+        label: string;
+        optional?: boolean;
+        content: import('react').ReactNode;
+    }[];
+    activeIndex: number;
+    skippedKeys: Set<string>;
+    isSubmitting?: boolean;
+    onBack: () => void;
+    onNext: () => void;
+    onSkip: () => void;
+    submitButton: import('react').ReactNode;
+    problemAlert?: import('react').ReactNode;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/inputs/colorContrast.d.ts

@@ -0,0 +1,18 @@
+/** El contraste mínimo de WCAG AA para texto normal. */
+export declare const MIN_CONTRAST = 4.5;
+/** Un color escrito como #RRGGBB. */
+export declare const HEX_COLOR: RegExp;
+/**
+ * Cuánto contrasta un color sobre blanco: 21 es negro, 1 es blanco.
+ *
+ * @param {string} color #RRGGBB
+ * @returns {number|null} null si no es un color #RRGGBB
+ */
+export declare function contrastOnWhite(color: string): number | null;
+/**
+ * El mismo tono, oscurecido lo justo para llegar a MIN_CONTRAST sobre blanco. Si ya se lee, regresa el mismo.
+ *
+ * @param {string} color #RRGGBB
+ * @returns {string|null} #RRGGBB en mayúsculas; null si no es un color #RRGGBB
+ */
+export declare function readableVariantOf(color: string): string | null;

package/dist/types/inputs/formLayoutContext.d.ts

@@ -0,0 +1,3 @@
+export declare const FormSectionContext: import("react").Context<boolean>;
+/** true si el campo va dentro de una FormSection. */
+export declare const useIsInsideFormSection: () => boolean;

package/dist/types/inputs/numberText.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Deja solo dígitos y UN punto, con el tope de decimales del campo. Lo demás (letras, comas, espacios) se va.
+ *
+ * @param {string|number|null|undefined} text lo que se tecleó o se pegó
+ * @param {number} decimals cuántos decimales caben
+ * @param {boolean} [allowNegative] si se puede escribir el signo de menos al principio
+ * @returns {string} '2850000.5'; '' si no quedó nada
+ */
+export declare function cleanNumberText(text: string | number | null | undefined, decimals: number, allowNegative?: boolean): string;
+/**
+ * Con separador de miles, sin tocar los decimales que se están escribiendo: '2850000.5' → '2,850,000.5'.
+ *
+ * @param {string|null|undefined} numberText lo que regresa cleanNumberText
+ * @returns {string}
+ */
+export declare function groupThousands(numberText: string | null | undefined): string;
+/**
+ * Al salir del campo: con todos sus decimales, completando con ceros y cortando lo de más (nunca redondea).
+ * '2850000.5' → '2850000.50'; '1.005' → '1.00'; '' se queda '' (el campo puede ser opcional).
+ *
+ * @param {string} numberText lo que regresa cleanNumberText
+ * @param {number} decimals
+ * @returns {string}
+ */
+export declare function completeDecimals(numberText: string, decimals: number): string;

package/dist/types/kanban/KanbanBoard.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @param {object} props
+ * @param {Array<{id: string, title: string, limit?: number, count?: number, collapsible?: boolean, defaultCollapsed?: boolean}>} props.columns
+ *     en su orden. count: cuántas tarjetas tiene de verdad cuando la pantalla le pasa solo las filtradas (el tope se cuenta
+ *     contra todas). collapsible: lleva su botón para encogerse (el congelador); defaultCollapsed: empieza encogida
+ * @param {Array<{id: string, columnId: string, title: string, completed?: boolean, description?: string, tags?: Array<string|{label: string, color?: string}>, assignees?: Array<{id: string, name: string, avatarUrl?: string}>, dueDate?: string, checklist?: {done: number, total: number}, comments?: number, attachments?: number} & Record<string, any>>} props.cards
+ *     el orden de cada columna es el orden en este arreglo; cada tarjeta puede traer sus campos propios (llegan a renderCard,
+ *     a cardActions y a onCardClick tal cual). dueDate: AAAA-MM-DD
+ * @param {(move: {cardId: string, fromColumnId: string, toColumnId: string, toIndex: number}) => void} props.onMove
+ * @param {(card: any) => import('react').ReactNode} [props.renderCard] lo de adentro de cada tarjeta (recibe la tarjeta de cards)
+ * @param {(cardId: string) => void} [props.onCardClick]
+ * @param {(newCard: {columnId: string, title: string}) => void} [props.onAddCard] con él cada columna lleva su «+» para agregar
+ *     escribiendo el título
+ * @param {(card: any) => Array<{key: string, label: string, icon?: import('react').ReactNode, color?: string, disabled?: boolean, onClick: () => void}>} [props.cardActions]
+ *     las acciones del «⋯» de cada tarjeta (editar, asignarme, borrar…); sin ellas no hay «⋯»
+ * @param {(column: any) => Array<{key: string, label: string, icon?: import('react').ReactNode, color?: string, disabled?: boolean, onClick: () => void}>} [props.columnActions]
+ *     las acciones del «⋯» de cada columna (renombrar, limpiar…)
+ * @param {(card: any, completed: boolean) => void} [props.onCardComplete] con él cada tarjeta lleva su círculo para terminarla
+ *     (completed true) o reabrirla (false); la pantalla decide qué más pasa (moverla a «Listo», guardar la fecha)
+ * @param {(columnId: string, collapsed: boolean) => void} [props.onColumnCollapse] cada que una columna se encoge o se abre
+ * @param {string} props.ariaLabel ya traducido
+ * @param {object} [props.texts] los textos que cambian, con la forma de `kanban` en los textos del paquete
+ */
+export default function KanbanBoard({ columns, cards, onMove, renderCard, onCardClick, onAddCard, cardActions, columnActions, onCardComplete, onColumnCollapse, ariaLabel, texts, }: {
+    columns: Array<{
+        id: string;
+        title: string;
+        limit?: number;
+        count?: number;
+        collapsible?: boolean;
+        defaultCollapsed?: boolean;
+    }>;
+    cards: Array<{
+        id: string;
+        columnId: string;
+        title: string;
+        completed?: boolean;
+        description?: string;
+        tags?: Array<string | {
+            label: string;
+            color?: string;
+        }>;
+        assignees?: Array<{
+            id: string;
+            name: string;
+            avatarUrl?: string;
+        }>;
+        dueDate?: string;
+        checklist?: {
+            done: number;
+            total: number;
+        };
+        comments?: number;
+        attachments?: number;
+    } & Record<string, any>>;
+    onMove: (move: {
+        cardId: string;
+        fromColumnId: string;
+        toColumnId: string;
+        toIndex: number;
+    }) => void;
+    renderCard?: (card: any) => import('react').ReactNode;
+    onCardClick?: (cardId: string) => void;
+    onAddCard?: (newCard: {
+        columnId: string;
+        title: string;
+    }) => void;
+    cardActions?: (card: any) => Array<{
+        key: string;
+        label: string;
+        icon?: import('react').ReactNode;
+        color?: string;
+        disabled?: boolean;
+        onClick: () => void;
+    }>;
+    columnActions?: (column: any) => Array<{
+        key: string;
+        label: string;
+        icon?: import('react').ReactNode;
+        color?: string;
+        disabled?: boolean;
+        onClick: () => void;
+    }>;
+    onCardComplete?: (card: any, completed: boolean) => void;
+    onColumnCollapse?: (columnId: string, collapsed: boolean) => void;
+    ariaLabel: string;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/kanban/kanbanCards.d.ts

@@ -0,0 +1,22 @@
+/** Cómo va la fecha límite de una tarjeta. */
+export declare const DUE_STATUS: Readonly<{
+    overdue: "overdue";
+    today: "today";
+    upcoming: "upcoming";
+}>;
+/**
+ * El día de hoy como AAAA-MM-DD en la zona de este navegador (la fecha límite es un día, no un instante).
+ *
+ * @param {Date} [now]
+ * @returns {string}
+ */
+export declare function todayIsoDateOf(now?: Date): string;
+/**
+ * Cómo va una fecha límite contra hoy. AAAA-MM-DD se compara bien como texto.
+ *
+ * @param {string|null|undefined} dueDate AAAA-MM-DD
+ * @param {string} today AAAA-MM-DD
+ * @returns {'overdue'|'today'|'upcoming'|null} null sin fecha
+ */
+export declare function dueStatusOf(dueDate: string | null | undefined, today: string): 'overdue' | 'today' | 'upcoming' | null;
+export { tagOf } from '../ui/labels/tagOf.js';

package/dist/types/kanban/kanbanMoves.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Las tarjetas de una columna, en su orden.
+ *
+ * @template {{id: string, columnId: string}} Card las tarjetas del proyecto, con lo que traigan (título, etiquetas…)
+ * @param {Card[]} cards
+ * @param {string} columnId
+ * @returns {Card[]}
+ */
+export declare function cardsOfColumn<Card extends {
+    id: string;
+    columnId: string;
+}>(cards: Card[], columnId: string): Card[];
+/**
+ * Las tarjetas con una movida: la tarjeta queda en toColumnId, en la posición toIndex de esa columna.
+ *
+ * @template {{id: string, columnId: string}} Card las tarjetas del proyecto, con lo que traigan (título, etiquetas…)
+ * @param {Card[]} cards
+ * @param {{cardId: string, toColumnId: string, toIndex: number}} move
+ * @returns {Card[]} un arreglo nuevo (el de entrada no se toca), con las mismas tarjetas
+ */
+export declare function moveCard<Card extends {
+    id: string;
+    columnId: string;
+}>(cards: Card[], { cardId, toColumnId, toIndex }: {
+    cardId: string;
+    toColumnId: string;
+    toIndex: number;
+}): Card[];
+/**
+ * ¿La columna pasó su tope de tarjetas (el límite de trabajo en curso)? Sin tope, nunca.
+ *
+ * @param {{limit?: number}} column
+ * @param {number} cardCount
+ * @returns {boolean}
+ */
+export declare function isOverLimit(column: {
+    limit?: number;
+}, cardCount: number): boolean;

package/dist/types/kanban.d.ts

@@ -0,0 +1,3 @@
+export { default as KanbanBoard } from './kanban/KanbanBoard.js';
+export { cardsOfColumn, isOverLimit, moveCard } from './kanban/kanbanMoves.js';
+export { DUE_STATUS, dueStatusOf, tagOf, todayIsoDateOf } from './kanban/kanbanCards.js';

package/dist/types/laravel/csrfRetry.d.ts

@@ -0,0 +1,21 @@
+export declare const CSRF_TOKEN_MISMATCH_STATUS = 419;
+/**
+ * Arma el manejador del 419 para el interceptor de respuesta.
+ *
+ * @param {object} dependencies
+ * @param {() => Promise<unknown>} dependencies.refreshCsrfToken GET auth/csrf-token (deja la cookie nueva)
+ * @param {(config: any) => Promise<any>} dependencies.repeatRequest vuelve a mandar la petición con el mismo
+ *     cliente
+ * @param {(config: any) => void} [dependencies.onRetry] para el log (sin datos personales)
+ * @returns {(error: {config?: object, response?: {status: number}}) => Promise<object|null>} la respuesta de la repetición, o null si no aplica
+ */
+export declare function createCsrfRetryHandler({ refreshCsrfToken, repeatRequest, onRetry }: {
+    refreshCsrfToken: () => Promise<unknown>;
+    repeatRequest: (config: any) => Promise<any>;
+    onRetry?: (config: any) => void;
+}): (error: {
+    config?: object;
+    response?: {
+        status: number;
+    };
+}) => Promise<object | null>;

package/dist/types/laravel.d.ts

@@ -0,0 +1 @@
+export { CSRF_TOKEN_MISMATCH_STATUS, createCsrfRetryHandler } from './laravel/csrfRetry.js';

package/dist/types/lastListUrl.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Anota la URL de una lista.
+ *
+ * @param {string} listKey p. ej. 'upload-control'
+ * @param {string} listUrl pathname + search
+ */
+export declare function rememberListUrl(listKey: string, listUrl: string): void;
+/**
+ * La última URL anotada de una lista, ya validada como ruta interna; null si no hay.
+ *
+ * @param {string} listKey
+ * @returns {string|null}
+ */
+export declare function recallListUrl(listKey: string): string | null;
+/**
+ * Se monta en la página de la lista: al salir de ella guarda la URL con la que se estaba viendo.
+ *
+ * @param {string} listKey
+ */
+export declare function useRememberListUrl(listKey: string): void;