@stackcraftmx/calcita 0.32.1 → 0.47.0

package/dist/types/mexico/cfdiReader.d.ts

@@ -0,0 +1,95 @@
+export type Cfdi = {
+    version: string | null;
+    series: string | null;
+    folio: string | null;
+    issuedAt: string | null;
+    /**
+     * CFDI_VOUCHER_TYPE
+     */
+    voucherType: string | null;
+    paymentMethod: string | null;
+    paymentForm: string | null;
+    currency: string | null;
+    exchangeRate: string | null;
+    subtotal: string | null;
+    discount: string | null;
+    total: string | null;
+    placeOfIssue: string | null;
+    issuer: {
+        rfc: string | null;
+        name: string | null;
+        taxRegime: string | null;
+    };
+    receiver: {
+        rfc: string | null;
+        name: string | null;
+        cfdiUse: string | null;
+        taxRegime: string | null;
+        postalCode: string | null;
+    };
+    concepts: Array<{
+        productCode: string | null;
+        quantity: string | null;
+        unitCode: string | null;
+        description: string | null;
+        unitValue: string | null;
+        amount: string | null;
+    }>;
+    taxes: {
+        transferred: string | null;
+        withheld: string | null;
+    };
+    /**
+     * null: sin timbre del SAT
+     */
+    stamp: {
+        uuid: string | null;
+        stampedAt: string | null;
+        certifierRfc: string | null;
+    } | null;
+};
+/**
+ * Una factura leída: los montos en texto, como vienen en el XML.
+ *
+ * @typedef {object} Cfdi
+ * @property {string|null} version
+ * @property {string|null} series
+ * @property {string|null} folio
+ * @property {string|null} issuedAt
+ * @property {string|null} voucherType CFDI_VOUCHER_TYPE
+ * @property {string|null} paymentMethod
+ * @property {string|null} paymentForm
+ * @property {string|null} currency
+ * @property {string|null} exchangeRate
+ * @property {string|null} subtotal
+ * @property {string|null} discount
+ * @property {string|null} total
+ * @property {string|null} placeOfIssue
+ * @property {{rfc: string|null, name: string|null, taxRegime: string|null}} issuer
+ * @property {{rfc: string|null, name: string|null, cfdiUse: string|null, taxRegime: string|null, postalCode: string|null}} receiver
+ * @property {Array<{productCode: string|null, quantity: string|null, unitCode: string|null, description: string|null, unitValue: string|null, amount: string|null}>} concepts
+ * @property {{transferred: string|null, withheld: string|null}} taxes
+ * @property {{uuid: string|null, stampedAt: string|null, certifierRfc: string|null}|null} stamp null: sin timbre del SAT
+ */
+/** El tipo de comprobante (TipoDeComprobante): ingreso, egreso, traslado, nómina o pago. */
+export declare const CFDI_VOUCHER_TYPE: Readonly<{
+    income: "I";
+    expense: "E";
+    transfer: "T";
+    payroll: "N";
+    payment: "P";
+}>;
+/**
+ * Lee el XML de un CFDI.
+ *
+ * @param {string} xmlText
+ * @returns {Cfdi|null} null si el XML no es un CFDI (no trae su Comprobante con Emisor y Receptor)
+ */
+export declare function readCfdi(xmlText: string): Cfdi | null;
+/**
+ * Lee el CFDI de un archivo elegido (un File o un Blob).
+ *
+ * @param {Blob} file
+ * @returns {Promise<Cfdi|null>} lo de readCfdi
+ */
+export declare function readCfdiFile(file: Blob): Promise<Cfdi | null>;

package/dist/types/mexico/derReader.d.ts

@@ -0,0 +1,54 @@
+/** Las etiquetas DER que se leen. */
+export declare const DER_TAG: Readonly<{
+    integer: 2;
+    objectIdentifier: 6;
+    utf8String: 12;
+    printableString: 19;
+    teletexString: 20;
+    ia5String: 22;
+    utcTime: 23;
+    generalizedTime: 24;
+    bmpString: 30;
+    sequence: 48;
+    set: 49;
+}>;
+/**
+ * Una pieza DER y, si agrupa otras, sus piezas.
+ *
+ * @param {Uint8Array} bytes
+ * @param {number} [offset]
+ * @returns {{tag: number, content: Uint8Array, end: number, children: Array<object>|null}}
+ */
+export declare function readDerNode(bytes: Uint8Array, offset?: number): {
+    tag: number;
+    content: Uint8Array;
+    end: number;
+    children: Array<object> | null;
+};
+/**
+ * Un identificador de objeto (OID) como se escribe: '2.5.4.45'.
+ *
+ * @param {Uint8Array} content
+ * @returns {string}
+ */
+export declare function objectIdentifierOf(content: Uint8Array): string;
+/**
+ * El texto de una pieza de texto (UTF-8, imprimible, latin-1 o UTF-16 de los nombres con acentos).
+ *
+ * @param {{tag: number, content: Uint8Array}} node
+ * @returns {string}
+ */
+export declare function derTextOf({ tag, content }: {
+    tag: number;
+    content: Uint8Array;
+}): string;
+/**
+ * Una fecha de certificado como instante ISO: UTCTime 'AAMMDDhhmmssZ' (de 1950 a 2049) o GeneralizedTime 'AAAAMMDDhhmmssZ'.
+ *
+ * @param {{tag: number, content: Uint8Array}} node
+ * @returns {string} '2030-11-02T04:56:30.000Z'
+ */
+export declare function derTimeOf(node: {
+    tag: number;
+    content: Uint8Array;
+}): string;

package/dist/types/mexico/efirmaKey.d.ts

@@ -0,0 +1,26 @@
+/** Por qué no pasó la llave. */
+export declare const EFIRMA_KEY_PROBLEM: Readonly<{
+    notKey: "notKey";
+    wrongPassword: "wrongPassword";
+    otherCertificate: "otherCertificate";
+}>;
+/** Un «no» de la llave, con su motivo (reason es uno de EFIRMA_KEY_PROBLEM). */
+export declare class EfirmaKeyError extends Error {
+    reason: string;
+    /**
+     * @param {string} reason EFIRMA_KEY_PROBLEM
+     */
+    constructor(reason: string);
+}
+/**
+ * Abre la llave con la contraseña y la compara con el certificado. Si todo está bien no regresa nada; si no, truena con
+ * EfirmaKeyError y su motivo.
+ *
+ * @param {{certificateBytes: ArrayBuffer|Uint8Array, keyBytes: ArrayBuffer|Uint8Array, password: string}} efirma
+ * @returns {Promise<void>}
+ */
+export declare function verifyEfirmaKey({ certificateBytes, keyBytes, password }: {
+    certificateBytes: ArrayBuffer | Uint8Array;
+    keyBytes: ArrayBuffer | Uint8Array;
+    password: string;
+}): Promise<void>;

package/dist/types/mexico/mexicoIdentifiers.d.ts

@@ -0,0 +1,61 @@
+/** De qué tipo es un RFC. */
+export declare const RFC_KIND: Readonly<{
+    company: "company";
+    person: "person";
+    generic: "generic";
+}>;
+/**
+ * El dígito verificador de un RFC (el último carácter), calculado con el resto de 11 del SAT.
+ *
+ * @param {string} rfc el RFC completo (se ignora su último carácter)
+ * @returns {string} '0'-'9' o 'A'
+ */
+export declare function rfcCheckDigitOf(rfc: string): string;
+/**
+ * De qué tipo es un RFC bien formado; null si no tiene la forma.
+ *
+ * @param {string|null|undefined} rfc
+ * @returns {string|null} RFC_KIND
+ */
+export declare function rfcKindOf(rfc: string | null | undefined): string | null;
+/**
+ * ¿El RFC está bien escrito? Revisa su forma (persona moral, física o genérico) y que la fecha exista.
+ *
+ * El dígito verificador va aparte (strict) y no por omisión: si un RFC real no lo cumpliera, la persona se quedaría sin poder
+ * seguir, y quien dice si un RFC existe es el SAT.
+ *
+ * @param {string|null|undefined} rfc
+ * @param {{strict?: boolean}} [options] strict: además, el dígito verificador
+ * @returns {boolean}
+ */
+export declare function isValidRfc(rfc: string | null | undefined, { strict }?: {
+    strict?: boolean;
+}): boolean;
+/**
+ * El dígito verificador de una CURP (el último).
+ *
+ * @param {string} curp la CURP completa (se ignora su último carácter)
+ * @returns {string}
+ */
+export declare function curpCheckDigitOf(curp: string): string;
+/**
+ * ¿La CURP está bien escrita? Su forma (con el estado y el sexo), que la fecha exista y su dígito verificador.
+ *
+ * @param {string|null|undefined} curp
+ * @returns {boolean}
+ */
+export declare function isValidCurp(curp: string | null | undefined): boolean;
+/**
+ * El dígito verificador de una CLABE (el 18.º).
+ *
+ * @param {string} clabe la CLABE completa o sus primeros 17 dígitos
+ * @returns {string}
+ */
+export declare function clabeCheckDigitOf(clabe: string): string;
+/**
+ * ¿La CLABE está bien escrita? 18 dígitos (los espacios no cuentan) y su dígito verificador.
+ *
+ * @param {string|null|undefined} clabe
+ * @returns {boolean}
+ */
+export declare function isValidClabe(clabe: string | null | undefined): boolean;

package/dist/types/mexico/mexicoRules.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @param {{strict?: boolean}} [options] strict: también el dígito verificador (ver isValidRfc)
+ * @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}}
+ */
+export declare function rfcRule({ strict }?: {
+    strict?: boolean;
+}): {
+    name: string;
+    message: {
+        key: string;
+    };
+    test: (value: unknown) => boolean;
+};
+/** @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}} */
+export declare function curpRule(): {
+    name: string;
+    message: {
+        key: string;
+    };
+    test: (value: unknown) => boolean;
+};
+/** @returns {{name: string, message: {key: string}, test: (value: unknown) => boolean}} */
+export declare function clabeRule(): {
+    name: string;
+    message: {
+        key: string;
+    };
+    test: (value: unknown) => boolean;
+};

package/dist/types/mexico.d.ts

@@ -0,0 +1,11 @@
+export { RFC_KIND, clabeCheckDigitOf, curpCheckDigitOf, isValidClabe, isValidCurp, isValidRfc, rfcCheckDigitOf, rfcKindOf, } from './mexico/mexicoIdentifiers.js';
+export { clabeRule, curpRule, rfcRule } from './mexico/mexicoRules.js';
+export { CERTIFICATE_STATUS, certificateStatusOf, readCertificate } from './mexico/certificateReader.js';
+export { CFDI_VOUCHER_TYPE, readCfdi, readCfdiFile } from './mexico/cfdiReader.js';
+export { EFIRMA_KEY_PROBLEM, EfirmaKeyError, verifyEfirmaKey } from './mexico/efirmaKey.js';
+export { default as CfdiSummary } from './mexico/CfdiSummary.js';
+export { default as EfirmaFields } from './mexico/EfirmaFields.js';
+export type Cfdi = import('./mexico/cfdiReader.js').Cfdi;
+export type EfirmaCertificate = ReturnType<typeof import('./mexico/certificateReader.js').readCertificate>;
+/** Una factura leída (lo que regresa readCfdi). @typedef {import('./mexico/cfdiReader.js').Cfdi} Cfdi */
+/** Un certificado leído (lo que regresa readCertificate). @typedef {ReturnType<typeof import('./mexico/certificateReader.js').readCertificate>} EfirmaCertificate */

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

@@ -1,9 +1,18 @@
-export { Controller, FormProvider, useForm, useFormContext } from 'react-hook-form';
+export { Controller, FormProvider, useFieldArray, useForm, useFormContext, useWatch } from 'react-hook-form';
 export { yupResolver } from '@hookform/resolvers/yup';
+export { default as FormAttachmentsField } from './hookForm/FormAttachmentsField.js';
 export { default as FormCatalogField } from './hookForm/FormCatalogField.js';
+export { default as FormCheckboxGroupField } from './hookForm/FormCheckboxGroupField.js';
 export { default as FormColorField } from './hookForm/FormColorField.js';
+export { default as FormFileField } from './hookForm/FormFileField.js';
+export { default as FormFileUploadField } from './hookForm/FormFileUploadField.js';
+export { default as FormImageField } from './hookForm/FormImageField.js';
+export { default as FormMaskedField } from './hookForm/FormMaskedField.js';
 export { default as FormNumberField } from './hookForm/FormNumberField.js';
 export { default as FormProblemAlert } from './hookForm/FormProblemAlert.js';
+export { default as FormRepeatingFields } from './hookForm/FormRepeatingFields.js';
+export { default as FormTransferListField } from './hookForm/FormTransferListField.js';
+export { listTotalAtMostRule, listTotalOf, orderedInListRule, uniqueInListRule } from './forms/listRules.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';

package/dist/types/rich-text.d.ts

@@ -0,0 +1,5 @@
+export { default as FormRichTextField } from './richText/FormRichTextField.js';
+export { default as RichTextEditor } from './richText/RichTextEditor.js';
+export { default as RichTextView } from './richText/RichTextView.js';
+export { DEFAULT_RICH_TEXT_FEATURES, RICH_TEXT_FEATURE, SAFE_LINK_PROTOCOLS, isSafeLinkUrl, linkUrlOf, normalizedHtmlOf } from './richText/richTextRules.js';
+export { RICH_TEXT_HEADING_LEVELS, richTextExtensionsOf } from './richText/richTextExtensions.js';

package/dist/types/richText/FormRichTextField.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {{name: string} & Omit<Parameters<typeof import('./RichTextEditor.js').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de
+ *     RichTextEditor (features, maxLength, placeholder…), sin value / onChange / onBlur / error
+ */
+export default function FormRichTextField({ name, ...editorProps }: {
+    name: string;
+} & Omit<Parameters<typeof import('./RichTextEditor.js').default>[0], 'name' | 'value' | 'onChange' | 'onBlur' | 'error'>): import("react").JSX.Element;

package/dist/types/richText/RichTextEditor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @param {object} props
+ * @param {string} [props.name]
+ * @param {import('react').ReactNode} props.label ya traducida
+ * @param {string|null|undefined} props.value el HTML guardado ('' sin texto)
+ * @param {(html: string) => void} props.onChange recibe el HTML ('' si se borra todo)
+ * @param {() => void} [props.onBlur]
+ * @param {string} [props.placeholder] ya traducido: lo que se ve con el editor vacío
+ * @param {string|{key: string, values?: object}} [props.error]
+ * @param {string} [props.helperText] ya traducida
+ * @param {number} [props.maxLength] el tope de caracteres (con su contador abajo)
+ * @param {string[]} [props.features] los botones de la barra (RICH_TEXT_FEATURE); por omisión todos
+ * @param {Array<object>} [props.extensions] extensiones de Tiptap del proyecto
+ * @param {import('react').ReactNode} [props.toolbarActions] botones propios al final de la barra
+ * @param {(editor: import('@tiptap/react').Editor) => void} [props.onEditorReady] el editor de Tiptap, al estar listo
+ * @param {number} [props.minHeight] el alto mínimo del texto en px; por omisión 160
+ * @param {boolean} [props.disabled]
+ * @param {object} [props.sx]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `richText` en los textos del paquete
+ */
+export default function RichTextEditor(props: {
+    name?: string;
+    label: import('react').ReactNode;
+    value: string | null | undefined;
+    onChange: (html: string) => void;
+    onBlur?: () => void;
+    placeholder?: string;
+    error?: string | {
+        key: string;
+        values?: object;
+    };
+    helperText?: string;
+    maxLength?: number;
+    features?: string[];
+    extensions?: Array<object>;
+    toolbarActions?: import('react').ReactNode;
+    onEditorReady?: (editor: import('@tiptap/react').Editor) => void;
+    minHeight?: number;
+    disabled?: boolean;
+    sx?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/richText/RichTextLinkPopover.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @param {object} props
+ * @param {HTMLElement|null} props.anchorElement el botón de la liga (null: cerrada)
+ * @param {string} props.initialUrl la liga que ya tiene el texto ('' si no tiene)
+ * @param {(url: string) => void} props.onSave recibe la dirección ya revisada
+ * @param {() => void} props.onRemove
+ * @param {() => void} props.onClose
+ * @param {(key: string) => string} props.t el traductor del editor
+ */
+export default function RichTextLinkPopover({ anchorElement, initialUrl, onSave, onRemove, onClose, t }: {
+    anchorElement: HTMLElement | null;
+    initialUrl: string;
+    onSave: (url: string) => void;
+    onRemove: () => void;
+    onClose: () => void;
+    t: (key: string) => string;
+}): import("react").JSX.Element;

package/dist/types/richText/RichTextToolbar.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @param {object} props
+ * @param {import('@tiptap/react').Editor|null} props.editor
+ * @param {string[]} props.features
+ * @param {boolean} props.disabled
+ * @param {(key: string, values?: object) => string} props.t el traductor del editor (namespace richText)
+ * @param {import('react').ReactNode} [props.actions] botones del proyecto al final de la barra
+ */
+export default function RichTextToolbar({ editor, features, disabled, t, actions }: {
+    editor: import('@tiptap/react').Editor | null;
+    features: string[];
+    disabled: boolean;
+    t: (key: string, values?: object) => string;
+    actions?: import('react').ReactNode;
+}): import("react").JSX.Element | null;

package/dist/types/richText/RichTextView.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @param {object} props
+ * @param {string|null|undefined} props.value el HTML guardado
+ * @param {string[]} [props.features] lo que se deja pasar (por omisión, lo de un editor completo)
+ * @param {Array<object>} [props.extensions] las extensiones de Tiptap del proyecto (las mismas que tiene su editor)
+ * @param {object} [props.sx]
+ */
+export default function RichTextView(props: {
+    value: string | null | undefined;
+    features?: string[];
+    extensions?: Array<object>;
+    sx?: object;
+}): import("react").JSX.Element;

package/dist/types/richText/richTextContentSx.d.ts

@@ -0,0 +1,7 @@
+/**
+ * El sx del contenido (.tiptap es la caja que edita Tiptap; en la vista es la misma, sin editar).
+ *
+ * @param {object} theme
+ * @returns {object}
+ */
+export declare function richTextContentSxOf(theme: object): object;

package/dist/types/richText/richTextExtensions.d.ts

@@ -0,0 +1,15 @@
+export declare const RICH_TEXT_HEADING_LEVELS: readonly number[];
+/**
+ * @param {object} options
+ * @param {string[]} options.features los botones de la barra (RICH_TEXT_FEATURE)
+ * @param {string} [options.placeholder] ya traducido: lo que se ve con el editor vacío
+ * @param {number} [options.maxLength] el tope de caracteres; sin él, sin tope
+ * @param {Array<object>} [options.extensions] extensiones de Tiptap del proyecto, al final
+ * @returns {Array<object>}
+ */
+export declare function richTextExtensionsOf({ features, placeholder, maxLength, extensions }: {
+    features: string[];
+    placeholder?: string;
+    maxLength?: number;
+    extensions?: Array<object>;
+}): Array<object>;

package/dist/types/richText/richTextRules.d.ts

@@ -0,0 +1,41 @@
+/** Los botones que puede traer la barra del editor. */
+export declare const RICH_TEXT_FEATURE: Readonly<{
+    textStyle: "textStyle";
+    bold: "bold";
+    italic: "italic";
+    underline: "underline";
+    strike: "strike";
+    bulletList: "bulletList";
+    orderedList: "orderedList";
+    blockquote: "blockquote";
+    codeBlock: "codeBlock";
+    link: "link";
+    align: "align";
+    clear: "clear";
+    history: "history";
+}>;
+/** Los de siempre: todos. Un editor más sencillo pasa su lista (features={[RICH_TEXT_FEATURE.bold, …]}). */
+export declare const DEFAULT_RICH_TEXT_FEATURES: readonly ("align" | "blockquote" | "bold" | "bulletList" | "clear" | "codeBlock" | "history" | "italic" | "link" | "orderedList" | "strike" | "textStyle" | "underline")[];
+/** Los protocolos que puede llevar una liga. */
+export declare const SAFE_LINK_PROTOCOLS: readonly string[];
+/**
+ * La dirección de una liga lista para guardarse, o null si no se acepta.
+ *
+ * @param {string|null|undefined} typedUrl lo que escribió la persona
+ * @returns {string|null}
+ */
+export declare function linkUrlOf(typedUrl: string | null | undefined): string | null;
+/**
+ * ¿Se acepta esta dirección como liga? (lo que pide la extensión de ligas del editor)
+ *
+ * @param {string} url
+ * @returns {boolean}
+ */
+export declare function isSafeLinkUrl(url: string): boolean;
+/**
+ * El HTML del editor como se guarda: '' si no hay nada escrito.
+ *
+ * @param {string|null|undefined} html
+ * @returns {string}
+ */
+export declare function normalizedHtmlOf(html: string | null | undefined): string;

package/dist/types/table.d.ts

@@ -1,3 +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 { AuditTrailDialog, AuditTrailTable, EmptyState, FILTER_KINDS, FilterChips, GoToPage, SELECTION_PHONE_LAYOUT, ServerTable, ServerTableFilterDrawer, 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/ui/actions/ActionsMenu.d.ts

@@ -1,20 +1,35 @@
+/** Los renglones que no son acciones. */
+export declare const ACTIONS_MENU_ROW: Readonly<{
+    section: "section";
+    divider: "divider";
+}>;
 /**
  * @param {object} props
  * @param {string} props.label el nombre del botón (lector de pantalla y su tooltip), ya traducido
- * @param {Array<{key: string, label: string, icon?: import('react').ReactNode, color?: string, disabled?: boolean, onClick: () => void}>} [props.actions]
+ * @param {Array<{key: string, type?: string, label?: string, icon?: import('react').ReactNode, description?: string, color?: string, disabled?: boolean, onClick?: () => void, href?: string, download?: string|boolean, children?: object[], render?: (helpers: {close: () => void}) => import('react').ReactNode}>} [props.actions]
  * @param {import('react').ReactNode} [props.icon] otro ícono para el botón (por omisión «⋯»)
  * @param {'small'|'medium'} [props.size]
+ * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
 export default function ActionsMenu(props: {
     label: string;
     actions?: Array<{
         key: string;
-        label: string;
+        type?: string;
+        label?: string;
         icon?: import('react').ReactNode;
+        description?: string;
         color?: string;
         disabled?: boolean;
-        onClick: () => void;
+        onClick?: () => void;
+        href?: string;
+        download?: string | boolean;
+        children?: object[];
+        render?: (helpers: {
+            close: () => void;
+        }) => import('react').ReactNode;
     }>;
     icon?: import('react').ReactNode;
     size?: 'small' | 'medium';
+    texts?: object;
 }): import("react").JSX.Element | null;

package/dist/types/ui/actions/CopyButton.d.ts

@@ -1,15 +1,18 @@
 /**
  * @param {object} props
- * @param {string} props.value lo que se copia
- * @param {string} [props.label] ya traducido; por omisión «Copiar»
+ * @param {string|(() => string)} props.value lo que se copia; una función se llama al picar
+ * @param {string} [props.label] ya traducido: qué copia («Copiar el folio»); por omisión «Copiar». Es el globo y el nombre
+ *     del botón para un lector de pantalla
  * @param {'small'|'medium'} [props.size]
  * @param {() => void} [props.onCopied]
+ * @param {(error: unknown) => void} [props.onCopyFailed] el navegador no dejó copiar (el botón ya lo dice en rojo)
  * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete
  */
-export default function CopyButton({ value, label, size, onCopied, texts, ...unknownProps }: {
-    value: string;
+export default function CopyButton({ value, label, size, onCopied, onCopyFailed, texts, ...unknownProps }: {
+    value: string | (() => string);
     label?: string;
     size?: 'small' | 'medium';
     onCopied?: () => void;
+    onCopyFailed?: (error: unknown) => void;
     texts?: object;
 }): import("react").JSX.Element;

package/dist/types/ui/actions/tableRowText.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {Array<string|number|null|undefined>} cells las celdas en el orden de las columnas, ya formateadas
+ * @returns {string} las celdas unidas con tabulador; una vacía o nula queda vacía. Un tabulador o un salto de renglón dentro
+ *     de una celda se cambia por un espacio: partirían el renglón al pegarlo
+ */
+export declare function tableRowTextOf(cells: Array<string | number | null | undefined>): string;

package/dist/types/ui/cards/RecordCard.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @param {object} props
+ * @param {import('react').ReactNode} props.title el nombre del registro, ya traducido
+ * @param {import('react').ReactNode} [props.eyebrow] arriba del título: el folio o el tipo
+ * @param {import('react').ReactNode} [props.subtitle] abajo del título
+ * @param {string|import('react').ReactNode} [props.avatar] un texto (de él salen las iniciales) o un ícono
+ * @param {import('react').ReactNode} [props.status] a la derecha: StatusChip, IconBadge…
+ * @param {Parameters<typeof import('../actions/ActionsMenu.js').default>[0]['actions']} [props.actions] el menú «⋯», con sus secciones,
+ *     separadores, ligas y submenús (los renglones de ActionsMenu)
+ * @param {Array<{key?: string, title?: import('react').ReactNode, facts?: Array<{label: import('react').ReactNode, value: import('react').ReactNode, emphasis?: boolean}>, content?: import('react').ReactNode}>} [props.groups]
+ *     los datos, en grupos; emphasis los pone en negritas; content en lugar de facts para un grupo libre (una barra, unas
+ *     insignias, un enlace)
+ * @param {import('react').ReactNode} [props.header] un encabezado propio en lugar del de la casa (avatar, títulos, estatus)
+ * @param {import('react').ReactNode} [props.children] contenido libre entre el cuerpo y lo de abajo
+ * @param {{label: import('react').ReactNode, value: import('react').ReactNode, caption?: import('react').ReactNode}} [props.highlight] el dato principal
+ * @param {import('react').ReactNode} [props.trailing] la última columna del cuerpo, después de los grupos y del dato principal
+ *     (el estatus o unos botones, cuando el orden obligatorio los pone al final)
+ * @param {string} [props.columns] en escritorio, el ancho de cada columna del cuerpo como en CSS ('1.2fr 1fr 1fr auto'); por
+ *     omisión, los grupos a partes iguales y el dato principal y trailing a su medida
+ * @param {import('react').ReactNode} [props.footer] abajo, a todo lo ancho
+ * @param {import('react').ReactNode} [props.details] lo que se despliega con «Ver detalle»
+ * @param {string} [props.detailsLabel] ya traducido; por omisión «Ver detalle»
+ * @param {boolean} [props.defaultDetailsOpen]
+ * @param {(isOpen: boolean) => void} [props.onDetailsToggle]
+ * @param {() => void} [props.onOpen] el botón para abrir el registro (su detalle)
+ * @param {string} [props.openLabel] ya traducido: el nombre de ese botón («Abrir el pedido P-1203»)
+ * @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 RecordCard(props: {
+    title: import('react').ReactNode;
+    eyebrow?: import('react').ReactNode;
+    subtitle?: import('react').ReactNode;
+    avatar?: string | import('react').ReactNode;
+    status?: import('react').ReactNode;
+    actions?: Parameters<typeof import('../actions/ActionsMenu.js').default>[0]['actions'];
+    groups?: Array<{
+        key?: string;
+        title?: import('react').ReactNode;
+        facts?: Array<{
+            label: import('react').ReactNode;
+            value: import('react').ReactNode;
+            emphasis?: boolean;
+        }>;
+        content?: import('react').ReactNode;
+    }>;
+    header?: import('react').ReactNode;
+    children?: import('react').ReactNode;
+    highlight?: {
+        label: import('react').ReactNode;
+        value: import('react').ReactNode;
+        caption?: import('react').ReactNode;
+    };
+    trailing?: import('react').ReactNode;
+    columns?: string;
+    footer?: import('react').ReactNode;
+    details?: import('react').ReactNode;
+    detailsLabel?: string;
+    defaultDetailsOpen?: boolean;
+    onDetailsToggle?: (isOpen: boolean) => void;
+    onOpen?: () => void;
+    openLabel?: string;
+    sx?: object;
+    texts?: object;
+}): import("react").JSX.Element;

package/dist/types/ui/cards/RecordCardSkeleton.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @param {object} props
+ * @param {number} [props.groups] cuántos grupos de datos (como los de la tarjeta)
+ * @param {number} [props.factsPerGroup]
+ * @param {boolean} [props.withAvatar]
+ * @param {boolean} [props.withHighlight]
+ * @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 RecordCardSkeleton({ groups, factsPerGroup, withAvatar, withHighlight, sx, texts, ...unknownProps }: {
+    groups?: number;
+    factsPerGroup?: number;
+    withAvatar?: boolean;
+    withHighlight?: boolean;
+    sx?: object;
+    texts?: object;
+}): import("react").JSX.Element;