@caribeng/ui 22.4.0 → 22.6.0

package/types/caribeng-ui.d.ts

@@ -444,6 +444,411 @@ interface CbTranslation {
     incorrectPassword: string;
     password: string;
     open: string;
+    pdfOutline: string;
+    pdfSidebarView: string;
+    /** `{0}`: título de la entrada del índice. */
+    pdfExpandItem: string;
+    /** `{0}`: título de la entrada del índice. */
+    pdfCollapseItem: string;
+    pdfDownloadFilled: string;
+    pdfAnnotate: string;
+    pdfHighlight: string;
+    pdfNote: string;
+    pdfDraw: string;
+    pdfSign: string;
+    pdfColor: string;
+    pdfColorYellow: string;
+    pdfColorGreen: string;
+    pdfColorBlue: string;
+    pdfColorRed: string;
+    pdfAnnotations: string;
+    pdfNoAnnotations: string;
+    /** `{0}`: texto resaltado. */
+    pdfHighlightOf: string;
+    /** `{0}`: texto de la nota. */
+    pdfNoteOf: string;
+    pdfHighlightNoun: string;
+    pdfInkOf: string;
+    pdfSignatureOf: string;
+    pdfEmptyNote: string;
+    pdfComment: string;
+    pdfNoteText: string;
+    pdfDone: string;
+    pdfDeleteAnnotation: string;
+    /** `{0}`: tipo de anotación; `{1}`: página. */
+    pdfAnnotationAdded: string;
+    pdfAnnotationRemoved: string;
+    /** `{0}` y `{1}`: posición horizontal y vertical en la página. */
+    pdfAnnotationMoved: string;
+    /** `{0}`: ancho de la firma en % del ancho de la página. */
+    pdfSignatureResized: string;
+    /** `{0}`: tamaño de letra en puntos. */
+    pdfNoteResized: string;
+    pdfAnnotationHint: string;
+    pdfHighlightHint: string;
+    pdfNoteHint: string;
+    pdfDrawHint: string;
+    pdfSignTitle: string;
+    pdfInsertSignature: string;
+    pdfCancel: string;
+    pdfDownloadAnnotated: string;
+    editorCodeTools: string;
+    editorCodeLanguage: string;
+    editorPlainText: string;
+    editorCopyCode: string;
+    editorCodeCopied: string;
+    editorImageCaption: string;
+    editorTableCells: string;
+    editorMergeRight: string;
+    editorMergeDown: string;
+    editorSplitCell: string;
+    editorCollapsible: string;
+    editorCollapsibleTitle: string;
+    editorToc: string;
+    editorTocTitle: string;
+    editorMentions: string;
+    /** `{0}`: fecha y hora. */
+    editorDraftFound: string;
+    editorRestoreDraft: string;
+    editorDiscardDraft: string;
+    /** `{0}`: hora. */
+    editorDraftSaved: string;
+    ganttChart: string;
+    ganttScale: string;
+    ganttDay: string;
+    ganttWeek: string;
+    ganttMonth: string;
+    /** `{0}`: número de semana. */
+    ganttWeekShort: string;
+    ganttTask: string;
+    ganttStart: string;
+    ganttEnd: string;
+    ganttDuration: string;
+    ganttProgress: string;
+    ganttAssignee: string;
+    /** `{0}`: días. */
+    ganttDays: string;
+    /** `{0}`: grupo. */
+    ganttExpand: string;
+    /** `{0}`: grupo. */
+    ganttCollapse: string;
+    /** `{0}`: tarea, `{1}`: fechas, `{2}`: avance. */
+    ganttBarLabel: string;
+    /** `{0}`: grupo, `{1}`: fechas, `{2}`: avance. */
+    ganttGroupLabel: string;
+    /** `{0}`: hito, `{1}`: fecha. */
+    ganttMilestoneLabel: string;
+    /** `{0}`: tareas. */
+    ganttDependsOn: string;
+    /** `{0}` → `{1}`. */
+    ganttRemoveLink: string;
+    /** `{0}` → `{1}`. */
+    ganttLinkAdded: string;
+    ganttLinkRemoved: string;
+    /** `{0}`: tarea, `{1}`: fechas. */
+    ganttMoved: string;
+    /** `{0}`: tarea, `{1}`: avance. */
+    ganttProgressChanged: string;
+    ganttInstructions: string;
+    schedulerPrevious: string;
+    schedulerNext: string;
+    schedulerViews: string;
+    schedulerMonth: string;
+    schedulerWeek: string;
+    schedulerDay: string;
+    schedulerAgenda: string;
+    schedulerAllDay: string;
+    /** `{0}`: eventos. */
+    schedulerMore: string;
+    /** `{0}`: eventos, `{1}`: día. */
+    schedulerMoreLabel: string;
+    /** `{0}`: día. */
+    schedulerOpenDay: string;
+    /** `{0}`: día. */
+    schedulerNewEvent: string;
+    schedulerNoEvents: string;
+    /** `{0}`: evento con su fecha. */
+    schedulerMoved: string;
+    schedulerInstructions: string;
+    dataGridToolbar: string;
+    dataGridAddRow: string;
+    dataGridDeleteRow: string;
+    /** `{0}`: cantidad. */
+    dataGridDeleteRows: string;
+    dataGridOneError: string;
+    /** `{0}`: cantidad. */
+    dataGridErrors: string;
+    /** `{0}`: cantidad. */
+    dataGridChanged: string;
+    dataGridRequired: string;
+    /** `{0}`: mínimo. */
+    dataGridMin: string;
+    /** `{0}`: máximo. */
+    dataGridMax: string;
+    dataGridInvalidNumber: string;
+    dataGridInvalidDate: string;
+    dataGridInvalidOption: string;
+    /** `{0}`: cantidad. */
+    dataGridCopied: string;
+    /** `{0}`: cantidad. */
+    dataGridPasted: string;
+    /** `{0}`: cantidad. */
+    dataGridCleared: string;
+    dataGridUndone: string;
+    dataGridRedone: string;
+    dataGridRowAdded: string;
+    /** `{0}`: cantidad. */
+    dataGridRowsDeleted: string;
+    dataGridInstructions: string;
+    dataGridReadonlyInstructions: string;
+    dynamicFormSubmit: string;
+    dynamicFormRequired: string;
+    /** `{0}`: mínimo. */
+    dynamicFormMin: string;
+    /** `{0}`: máximo. */
+    dynamicFormMax: string;
+    /** `{0}`: caracteres. */
+    dynamicFormMinLength: string;
+    /** `{0}`: caracteres. */
+    dynamicFormMaxLength: string;
+    dynamicFormEmail: string;
+    dynamicFormPattern: string;
+    dynamicFormInvalid: string;
+    dynamicFormSummaryOne: string;
+    /** `{0}`: cantidad. */
+    dynamicFormSummary: string;
+    dynamicFormNext: string;
+    dynamicFormBack: string;
+    /** `{0}`: paso; `{1}`: total. */
+    dynamicFormStep: string;
+    /** `{0}`: grupo. */
+    dynamicFormAdd: string;
+    /** `{0}`: elemento. */
+    dynamicFormRemove: string;
+    /** `{0}`: número. */
+    dynamicFormItem: string;
+    /** `{0}`: elemento. */
+    dynamicFormAdded: string;
+    /** `{0}`: elemento. */
+    dynamicFormRemoved: string;
+    tableTotal: string;
+    /** `{0}`: grupo. */
+    tableSubtotal: string;
+    tableScrollRegion: string;
+    accountPickerPlaceholder: string;
+    /** `{0}`: cantidad. */
+    accountPickerResults: string;
+    journalHeader: string;
+    journalDate: string;
+    journalType: string;
+    journalNumber: string;
+    journalDescription: string;
+    journalLines: string;
+    journalAccount: string;
+    journalThirdParty: string;
+    journalCostCenter: string;
+    journalLineDescription: string;
+    journalDebit: string;
+    journalCredit: string;
+    journalDifference: string;
+    journalBalanced: string;
+    journalUnbalanced: string;
+    journalBalance: string;
+    journalSave: string;
+    journalAccountRequired: string;
+    journalAmountRequired: string;
+    journalThirdPartyRequired: string;
+    journalCannotSave: string;
+    journalErrDate: string;
+    journalErrLines: string;
+    /** `{0}`: diferencia. */
+    journalErrUnbalanced: string;
+    /** `{0}`: cantidad. */
+    journalErrCells: string;
+    periodPickerPlaceholder: string;
+    periodPresets: string;
+    periodKind: string;
+    periodMonth: string;
+    periodQuarterTab: string;
+    periodYear: string;
+    periodPrevYear: string;
+    periodNextYear: string;
+    periodPrevYears: string;
+    periodNextYears: string;
+    /** `{0}`: trimestre; `{1}`: año. */
+    periodQuarter: string;
+    /** `{0}`: trimestre. */
+    periodQuarterShort: string;
+    /** `{0}`: trimestre; `{1}`: año fiscal. */
+    periodFiscalQuarter: string;
+    /** `{0}`: año fiscal. */
+    periodFiscalYear: string;
+    periodClosed: string;
+    periodThisMonth: string;
+    periodLastMonth: string;
+    periodThisQuarter: string;
+    periodLastQuarter: string;
+    periodYearToDate: string;
+    periodThisYear: string;
+    periodLastYear: string;
+    reportTitle: string;
+    reportToolbar: string;
+    reportLevel: string;
+    /** `{0}`: nivel. */
+    reportLevelN: string;
+    reportHideZero: string;
+    reportExcel: string;
+    reportPrint: string;
+    reportVariation: string;
+    agingTitle: string;
+    /** `{0}`: fecha de corte. */
+    agingAsOf: string;
+    agingParty: string;
+    agingCurrent: string;
+    /** `{0}`, `{1}`: días. */
+    agingRange: string;
+    /** `{0}`: días. */
+    agingOver: string;
+    agingMaxDays: string;
+    /** `{0}`: días. */
+    agingDays: string;
+    /** `{0}`: días. */
+    agingDueIn: string;
+    /** `{0}`: cantidad. */
+    agingDocs: string;
+    /** `{0}`: tercero. */
+    agingDocsOf: string;
+    agingNumber: string;
+    agingDate: string;
+    agingDue: string;
+    agingOverdue: string;
+    agingBalance: string;
+    agingSummary: string;
+    agingDetail: string;
+    importStepFile: string;
+    importStepMap: string;
+    importStepReview: string;
+    importDrop: string;
+    importChoose: string;
+    importPaste: string;
+    importPasteHint: string;
+    importSheet: string;
+    importHeader: string;
+    /** `{0}`: filas; `{1}`: columnas. */
+    importRowsRead: string;
+    importSample: string;
+    importMapHint: string;
+    importField: string;
+    importColumn: string;
+    importExample: string;
+    importUnmapped: string;
+    /** `{0}`: letra. */
+    importColumnN: string;
+    /** `{0}`: campos. */
+    importMissing: string;
+    /** `{0}`: cantidad. */
+    importValid: string;
+    /** `{0}`: cantidad. */
+    importInvalid: string;
+    importOnlyValid: string;
+    importPreview: string;
+    importBack: string;
+    importNext: string;
+    /** `{0}`: cantidad. */
+    importDo: string;
+    importErrFile: string;
+    importErrRequired: string;
+    importErrNumber: string;
+    importErrDate: string;
+    importErrBoolean: string;
+    reconStatement: string;
+    reconLedger: string;
+    reconStatementPending: string;
+    reconLedgerPending: string;
+    reconProgress: string;
+    /** `{0}`: cantidad. */
+    reconItems: string;
+    reconToolbar: string;
+    reconAuto: string;
+    reconMatch: string;
+    reconUnmatch: string;
+    /** `{0}`: extracto; `{1}`: libros. */
+    reconSelection: string;
+    /** `{0}`: diferencia. */
+    reconDiff: string;
+    reconOnlyPending: string;
+    reconMatched: string;
+    reconCreate: string;
+    /** `{0}`: movimiento. */
+    reconCreateFor: string;
+    reconNothingPending: string;
+    /** `{0}`: cantidad. */
+    reconAutoDone: string;
+    reconMatchedDone: string;
+    /** `{0}`: cantidad. */
+    reconUnmatchedDone: string;
+    pivotTitle: string;
+    pivotConfig: string;
+    pivotRows: string;
+    pivotColumns: string;
+    pivotAggregate: string;
+    pivotNone: string;
+    pivotEmpty: string;
+    pivotSum: string;
+    pivotCount: string;
+    pivotAvg: string;
+    pivotMin: string;
+    pivotMax: string;
+    kpiPrevious: string;
+    /** `{0}`: porcentaje. */
+    kpiUp: string;
+    /** `{0}`: porcentaje. */
+    kpiDown: string;
+    kpiSame: string;
+    /** `{0}`: primero; `{1}`: último; `{2}`: puntos. */
+    kpiTrend: string;
+    kpiGoal: string;
+    /** `{0}`: porcentaje; `{1}`: meta. */
+    kpiOfGoal: string;
+    auditTitle: string;
+    auditSearch: string;
+    auditUser: string;
+    auditAction: string;
+    auditEntity: string;
+    auditAllUsers: string;
+    auditAllActions: string;
+    /** `{0}`: cantidad. */
+    auditCount: string;
+    auditCreated: string;
+    auditUpdated: string;
+    auditDeleted: string;
+    /** `{0}`: cantidad. */
+    auditChanges: string;
+    /** Singular de `auditChanges`. */
+    auditChangesOne: string;
+    /** `{0}`: registro. */
+    auditChangesOf: string;
+    auditField: string;
+    auditBefore: string;
+    auditAfter: string;
+    auditEmpty: string;
+    auditNone: string;
+    auditTime: string;
+    auditNote: string;
+    documentTaxId: string;
+    documentDate: string;
+    documentParty: string;
+    documentCode: string;
+    documentDescription: string;
+    documentQuantity: string;
+    documentUnitPrice: string;
+    documentDiscount: string;
+    documentTax: string;
+    documentAmount: string;
+    documentSubtotal: string;
+    documentTotal: string;
+    documentInWords: string;
+    documentNotes: string;
     scrollableArea: string;
     scrollTop: string;
     resizePanels: string;
@@ -609,8 +1014,211 @@ interface CbTranslation {
     quickFormat: string;
     insertBlock: string;
     paragraph: string;
+    commentsFeed: string;
+    commentsShow: string;
+    commentsAll: string;
+    commentsOnly: string;
+    commentsActivity: string;
+    commentsEmpty: string;
+    commentsWrite: string;
+    commentsWriteReply: string;
+    commentsNew: string;
+    commentsEditing: string;
+    /** `{0}`: autor del comentario. */
+    commentsReplyTo: string;
+    /** `{0}`: autor del comentario. */
+    commentsRepliesTo: string;
+    commentsSend: string;
+    commentsReply: string;
+    commentsEdit: string;
+    commentsDelete: string;
+    commentsDeleteConfirm: string;
+    commentsEdited: string;
+    commentsDeleted: string;
+    commentsAddReaction: string;
+    commentsReactions: string;
+    /** `{0}`: emoji; `{1}`: cantidad; `{2}`: quiénes. */
+    commentsReactionLabel: string;
+    commentsYou: string;
+    commentsJustNow: string;
+    commentsPosted: string;
+    commentsSaved: string;
+    commentsShortcut: string;
+    notificationsTitle: string;
+    /** `{0}`: avisos sin leer. */
+    notificationsBellUnread: string;
+    notificationsMarkAllRead: string;
+    notificationsShow: string;
+    notificationsAll: string;
+    notificationsUnread: string;
+    notificationsUnreadItem: string;
+    /** `{0}`: título del aviso. */
+    notificationsMarkRead: string;
+    /** `{0}`: título del aviso. */
+    notificationsMarkUnread: string;
+    notificationsMarkReadShort: string;
+    notificationsMarkUnreadShort: string;
+    notificationsEmpty: string;
+    notificationsAllRead: string;
+    notificationsViewAll: string;
+    notificationsToday: string;
+    notificationsYesterday: string;
+    notificationsEarlier: string;
+    notificationsJustNow: string;
+    /** `{0}`: título del aviso. */
+    notificationsNew: string;
+    /** `{0}`: cantidad. */
+    notificationsNewMany: string;
+    notificationsMarkedRead: string;
+    notificationsMarkedUnread: string;
+    notificationsMarkedAllRead: string;
+    notificationsRemoved: string;
+    signaturePad: string;
+    signatureEmptyState: string;
+    signatureSignedState: string;
+    signaturePlaceholder: string;
+    signatureModes: string;
+    signatureDraw: string;
+    signatureType: string;
+    signatureTypeLabel: string;
+    signatureHint: string;
+    signatureHintDraw: string;
+    signatureUndo: string;
+    signatureClear: string;
+    signatureCleared: string;
+    signatureUndone: string;
+    /** `{0}`/`{1}`: ancho y alto en %; `{2}`/`{3}`: en píxeles. */
+    cropperValue: string;
+    cropperRatio: string;
+    cropperRotateLeft: string;
+    cropperRotateRight: string;
+    cropperRotatedLeft: string;
+    cropperRotatedRight: string;
+    cropperChoose: string;
+    cropperChange: string;
+    cropperEmpty: string;
+    cropperPreview: string;
+    cropperDone: string;
+    cropperInvalidFile: string;
+    cropperLoadError: string;
+    infiniteLoading: string;
+    infiniteLoadMore: string;
+    /** `{0}`: nuevos; `{1}`: total. */
+    infiniteLoaded: string;
+    infiniteEnd: string;
+    infiniteError: string;
+    infiniteRetry: string;
+    mediaVideo: string;
+    mediaAudio: string;
+    mediaControls: string;
+    mediaPlay: string;
+    mediaPause: string;
+    /** `{0}`: segundos. */
+    mediaBack: string;
+    /** `{0}`: segundos. */
+    mediaForward: string;
+    mediaSeek: string;
+    /** `{0}`: tiempo actual; `{1}`: duración. */
+    mediaTimeOf: string;
+    mediaHours: string;
+    mediaMinutes: string;
+    mediaSeconds: string;
+    mediaMute: string;
+    mediaVolume: string;
+    /** `{0}`: porcentaje. */
+    mediaVolumeSet: string;
+    mediaSpeed: string;
+    /** `{0}`: velocidad ("1,5×"). */
+    mediaSpeedSet: string;
+    mediaCaptions: string;
+    mediaCaptionsLanguage: string;
+    mediaCaptionsNone: string;
+    /** `{0}`: idioma. */
+    mediaCaptionsOn: string;
+    mediaCaptionsOff: string;
+    mediaPip: string;
+    mediaFullscreen: string;
+    mediaExitFullscreen: string;
+    mediaTranscript: string;
+    mediaError: string;
+    mediaShortcuts: string;
+    flowEditor: string;
+    flowDiagram: string;
+    flowList: string;
+    flowView: string;
+    flowAdd: string;
+    flowStart: string;
+    flowTask: string;
+    flowDecision: string;
+    flowEnd: string;
+    /** `{0}`: tipo de nodo; `{1}`: su nombre. */
+    flowNodeOf: string;
+    /** `{0}`: destinos separados por comas. */
+    flowExits: string;
+    flowNoExits: string;
+    /** `{0}`: nombre del nodo. */
+    flowExitsOf: string;
+    /** `{0}` y `{1}`: nombres de los nodos. */
+    flowEdgeOf: string;
+    flowConnect: string;
+    /** `{0}`: nombre del nodo. */
+    flowConnectFrom: string;
+    /** `{0}` y `{1}`: nombres de los nodos. */
+    flowConnected: string;
+    /** `{0}` y `{1}`: nombres de los nodos. */
+    flowCannotConnect: string;
+    flowConnectCancelled: string;
+    flowDelete: string;
+    /** `{0}`: nombre del nodo. */
+    flowDeleteNode: string;
+    /** `{0}`: tipo y nombre del nodo. */
+    flowAdded: string;
+    /** `{0}`: lo que se eliminó. */
+    flowRemoved: string;
+    /** `{0}`: tipo de nodo. */
+    flowNameOf: string;
+    flowEdgeLabel: string;
+    /** `{0}` y `{1}`: nombres de los nodos. */
+    flowEdgeLabelOf: string;
+    /** `{0}`: nombre del nodo. */
+    flowConnectTo: string;
+    flowChooseTarget: string;
+    flowAddConnection: string;
+    /** `{0}`: nombre del destino. */
+    flowRemoveConnection: string;
+    flowLayout: string;
+    flowLaidOut: string;
+    flowZoomIn: string;
+    flowZoomOut: string;
+    flowFit: string;
+    flowZoom: string;
+    flowEmpty: string;
+    /** `{0}`: número de problemas. */
+    flowIssues: string;
+    flowNoIssues: string;
+    /** `{0}`: descripción del problema. */
+    flowIssueOf: string;
+    flowIssueNoStart: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueManyStarts: string;
+    flowIssueNoEnd: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueStartIncoming: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueEndOutgoing: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueDeadEnd: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueBranches: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueBranchLabel: string;
+    /** `{0}`: nombre del nodo. */
+    flowIssueUnreachable: string;
+    flowNodeHint: string;
+    flowReadonlyHint: string;
+    flowEdgeHint: string;
 }
-/** Español (idioma por defecto). */
+/** Español. */
 declare const CB_LOCALE_ES: CbTranslation;
 /** Inglés. */
 declare const CB_LOCALE_EN: CbTranslation;
@@ -661,11 +1269,23 @@ interface CaribeNgConfig {
     optionalText?: string;
     /**
      * Idioma de los textos de interfaz (etiquetas accesibles, botones, mensajes
-     * por defecto): `'es'` (por defecto), `'en'` o un objeto `CbTranslation` propio.
+     * por defecto): `'en'` (por defecto), `'es'` o un objeto `CbTranslation` propio.
      */
     locale?: CbLocaleCode | CbTranslation;
     /** Textos sueltos que sobrescriben los del idioma, p. ej. `{ close: 'Salir' }`. */
     translation?: Partial<CbTranslation>;
+    /**
+     * Moneda por defecto de los importes (código ISO 4217: `COP`, `USD`…) en tablas,
+     * Data Grid e `injectCbAmount()`. Sin ella, los importes se escriben sin símbolo.
+     */
+    currency?: string;
+    /** Negativos con signo (`-1.234`, por defecto) o entre paréntesis (`(1.234)`, estilo contable). */
+    negativeStyle?: 'minus' | 'parens';
+    /**
+     * Idioma y país (BCP 47) con el que se escriben los importes: `es-CO` da
+     * `$ 1.234,50`. Si se omite, el del idioma de la interfaz (`es`, `en`).
+     */
+    numberLocale?: string;
 }
 /**
  * Indicador visual de obligatoriedad en la etiqueta de los campos:
@@ -890,6 +1510,95 @@ interface CbOverlayFocusOptions {
  */
 declare function cbOverlayFocus(options: CbOverlayFocusOptions): void;
 
+/**
+ * Fecha relativa a `now` ("hace 5 minutos", "ayer", "en 2 horas") en el idioma `locale`;
+ * a partir de una semana, la fecha corta ("23 oct 2026"). Por debajo de un minuto devuelve
+ * `justNow` ("ahora mismo").
+ *
+ * @example
+ * ```ts
+ * cbRelativeTime(comment.date, Date.now(), t().intlLocale, t().commentsJustNow);
+ * ```
+ */
+declare function cbRelativeTime(date: Date | string | number, now: number, locale: string, justNow: string): string;
+
+/** Cómo se escriben los negativos: `-1.234,00` o `(1.234,00)` (estilo contable). */
+type CbNegativeStyle = 'minus' | 'parens';
+/** Totales de una columna: suma, promedio, cuenta, mínimo o máximo. */
+type CbSummary = 'sum' | 'avg' | 'count' | 'min' | 'max';
+/** Opciones de `cbFormatAmount()`. */
+interface CbAmountOptions {
+    /** Código ISO 4217 (`COP`, `USD`…); `null` escribe solo el número. */
+    readonly currency?: string | null;
+    /** Decimales fijos (por defecto 2; 0 en monedas sin centavos como JPY o CLP). */
+    readonly decimals?: number;
+    readonly negative?: CbNegativeStyle;
+    /** `symbol` ($), `narrowSymbol` ($ sin país) o `code` (COP). */
+    readonly currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code';
+}
+/** Número a partir de un valor (número o texto numérico); `null` si no lo es. */
+declare function cbToNumber(value: unknown): number | null;
+/**
+ * Importe con el formato del idioma: separadores, decimales, moneda y negativos
+ * entre paréntesis si se pide (`(1.234,50)`). Un valor que no es número se
+ * devuelve como texto (vacío si es `null`).
+ *
+ * ```ts
+ * cbFormatAmount(-1234.5, 'es-CO', { currency: 'COP', negative: 'parens' }); // "($ 1.234,50)"
+ * ```
+ */
+declare function cbFormatAmount(value: unknown, locale: string, options?: CbAmountOptions): string;
+/**
+ * Total de una lista de valores (los que no son número se ignoran, salvo en
+ * `count`). Las sumas se redondean para evitar errores de coma flotante
+ * (`0.1 + 0.2` da `0.3`).
+ */
+declare function cbSummarize(values: readonly unknown[], kind: CbSummary): number | null;
+/**
+ * Formateador de importes con la moneda y el estilo de negativos de
+ * `provideCaribeNG({ currency, negativeStyle, numberLocale })` (o el idioma activo).
+ * Debe llamarse en un contexto de inyección.
+ */
+declare function injectCbAmount(): (value: unknown, options?: CbAmountOptions) => string;
+
+/** Breakpoints de CaribeNG, de menor a mayor (`xs` es todo lo que queda por debajo de `sm`). */
+type CbBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+/** Ancho mínimo de cada breakpoint en px (coinciden con `--cb-breakpoint-*` y las utilidades `md:cb-*`). */
+declare const CB_BREAKPOINTS: Readonly<Record<CbBreakpoint, number>>;
+/**
+ * El breakpoint actual como signals, para lo que las utilidades CSS no pueden hacer: no renderizar
+ * una parte, cambiar un input o elegir otra vista según el ancho de la ventana (mobile-first).
+ *
+ * En el servidor (o sin `matchMedia`) todas las consultas son `false` y `current()` es `xs`.
+ *
+ * @example
+ * ```ts
+ * protected readonly bp = inject(CbBreakpoints);
+ * protected readonly desktop = this.bp.up('lg');
+ * ```
+ * ```html
+ * @if (desktop()) { <aside>…</aside> }
+ * <cb-table [size]="bp.down('md')() ? 'sm' : 'md'" />
+ * ```
+ */
+declare class CbBreakpoints {
+    private readonly isBrowser;
+    /** Un signal por media query: el servicio vive lo que la app, así que los listeners no se quitan. */
+    private readonly queries;
+    /** El breakpoint mayor cuyo ancho mínimo se cumple. */
+    readonly current: Signal<CbBreakpoint>;
+    /** `true` desde el ancho de `bp` en adelante (`md:` en las utilidades). */
+    up(bp: CbBreakpoint): Signal<boolean>;
+    /** `true` por debajo del ancho de `bp` (`down('md')` es el móvil y la tableta en vertical). */
+    down(bp: CbBreakpoint): Signal<boolean>;
+    /** `true` desde `from` hasta antes de `to`. */
+    between(from: CbBreakpoint, to: CbBreakpoint): Signal<boolean>;
+    /** Cualquier media query (`(orientation: portrait)`, `(prefers-reduced-motion: reduce)`…) como signal. */
+    matches(query: string): Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CbBreakpoints, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CbBreakpoints>;
+}
+
 /**
  * Idioma de los textos de interfaz de CaribeNG. Se configura con
  * `provideCaribeNG({ locale, translation })` y puede cambiarse en caliente:
@@ -917,6 +1626,6 @@ declare class CbLocaleService {
 /** Traducciones activas de CaribeNG como signal (para usar en componentes). */
 declare function injectCbTranslation(): Signal<CbTranslation>;
 
-export { CB_COLOR_PRESETS, CB_CONFIG, CB_DEFAULT_CONFIG, CB_LOCALES, CB_LOCALE_EN, CB_LOCALE_ES, CbConfirmationService, CbLocaleService, CbThemeService, cbFieldState, cbFormat, cbOverlayFocus, cbRunCommand, cbVisibleItems, injectCbTranslation, provideCaribeNG };
-export type { CaribeNgConfig, CbColorPreset, CbConfirmSeverity, CbConfirmation, CbConfirmationRequest, CbFieldIndicator, CbFieldState, CbLocaleCode, CbMenuCommandEvent, CbOverlayFocusOptions, CbPrimaryScale, CbRequiredIndicator, CbSeverity, CbSize, CbTheme, CbThemePreference, CbTranslation };
+export { CB_BREAKPOINTS, CB_COLOR_PRESETS, CB_CONFIG, CB_DEFAULT_CONFIG, CB_LOCALES, CB_LOCALE_EN, CB_LOCALE_ES, CbBreakpoints, CbConfirmationService, CbLocaleService, CbThemeService, cbFieldState, cbFormat, cbFormatAmount, cbOverlayFocus, cbRelativeTime, cbRunCommand, cbSummarize, cbToNumber, cbVisibleItems, injectCbAmount, injectCbTranslation, provideCaribeNG };
+export type { CaribeNgConfig, CbAmountOptions, CbBreakpoint, CbColorPreset, CbConfirmSeverity, CbConfirmation, CbConfirmationRequest, CbFieldIndicator, CbFieldState, CbLocaleCode, CbMenuCommandEvent, CbNegativeStyle, CbOverlayFocusOptions, CbPrimaryScale, CbRequiredIndicator, CbSeverity, CbSize, CbSummary, CbTheme, CbThemePreference, CbTranslation };
 //# sourceMappingURL=caribeng-ui.d.ts.map