@prolibu-suite/cobalt-core 0.10.4 → 0.11.1

package/dist/types/components/co-ref-field/co-ref-field.d.ts

@@ -19,15 +19,39 @@ export interface RefFieldDisplayItem {
     avatar?: string;
     image?: string;
 }
+/**
+ * Campo para elegir uno o varios registros relacionados (contactos, empresas,
+ * workspaces…) con búsqueda y paginación del lado del host: el componente pinta
+ * el trigger y el panel (`co-option-list`) y emite `coSearch`/`coLoadMore`; el
+ * host responde con `options`, `total` y `loading`. Wrapper Vue: `CoRefField` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot panel - Reemplaza la lista del panel por contenido propio del host (su búsqueda, opciones y accesibilidad); se conservan el chrome del panel y el footer. Selecciona con `selectOption()`.
+ * @slot panel-footer - Contenido libre al pie de la lista del panel (p. ej. un switch), encima de los botones de `showFooter`.
+ *
+ * @part trigger-text - Texto del valor seleccionado en el trigger (modo single).
+ * @part trigger-placeholder - Placeholder del trigger sin valor.
+ * @part trigger-inherited - Texto del valor heredado (`inheritedLabel`) cuando no hay valor.
+ * @part trigger-inherited-badge - Chip junto al valor heredado (`inheritedBadgeLabel`).
+ * @part trigger-badge - Insignia de estado tras el valor (`triggerBadgeIcon`).
+ * @part trigger-edit - Botón lápiz del trigger (`editable`).
+ * @part trigger-clear - Botón × que vacía la selección (`clearable`).
+ * @part trigger-chevron - Ícono de apertura del panel.
+ */
 export declare class CoRefField {
+    /** Etiqueta del campo. */
     label?: string;
     /** Whether the field is required (renders a required marker on the label). */
     required: boolean;
+    /** Texto secundario junto a la etiqueta (p. ej. «Opcional»). */
     secondaryLabel?: string;
     /** Phosphor icon name rendered before the label text. */
     labelIcon?: string;
+    /** Texto del trigger sin valor (salvo que haya `inheritedLabel`). */
     placeholder: string;
+    /** Deshabilita el campo: no abre el panel ni muestra × ni lápiz. */
     disabled: boolean;
+    /** Muestra la × que vacía la selección cuando hay valor (default `true`); emite `coClear`. */
     clearable: boolean;
     /** Shows a pencil button on the single-value trigger that emits
      *  `coEditSelected` with the selected record id. The host owns policy
@@ -35,9 +59,13 @@ export declare class CoRefField {
     editable: boolean;
     /** Accessible name / tooltip for the edit button. */
     editLabel: string;
+    /** Selección múltiple: la selección se pinta como chips y `value` es un JSON array de ids. */
     multiple: boolean;
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning';
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
+    /** Ícono Phosphor al inicio del trigger. */
     iconLeft?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
@@ -65,9 +93,13 @@ export declare class CoRefField {
     loading: boolean;
     /** Total count of matching records from the API. */
     total: number;
+    /** Buscador en el panel (default `true`); el filtrado lo hace el host al recibir `coSearch`. */
     searchable: boolean;
+    /** Placeholder del buscador del panel. */
     searchPlaceholder: string;
+    /** Espera en ms entre la última tecla y el `coSearch` (default 350). */
     searchDebounce: number;
+    /** Texto del panel cuando no hay opciones. */
     emptyMessage: string;
     /** Show footer buttons (same pattern as co-combobox). */
     showFooter: boolean;
@@ -127,17 +159,27 @@ export declare class CoRefField {
     pinnable: boolean;
     /** Drag-reorder de la lista del panel (forward a co-option-list). */
     listReorderable: boolean;
+    /** Cambió la selección (el componente ya actualizó `value`). `detail.value`: el id
+     *  elegido, o el array completo en `multiple`; `detail.item`: la opción elegida o quitada. */
     coChange: EventEmitter<{
         value: string | string[];
         item: RefFieldOption;
     }>;
+    /** Se vació la selección (× del trigger o deselección de la fila en single). Sin `detail`. */
     coClear: EventEmitter<void>;
+    /** Término del buscador del panel, con debounce. El host filtra y responde con `options`. */
     coSearch: EventEmitter<string>;
+    /** Pide la página siguiente de opciones (scroll al final del panel). Sin `detail`. */
     coLoadMore: EventEmitter<void>;
+    /** Se abrió el panel. No burbujea. */
     coOpen: EventEmitter<void>;
+    /** Se cerró el panel. No burbujea. */
     coClose: EventEmitter<void>;
+    /** Se quitó un chip en `multiple`; `detail` = id quitado. También sale `coChange` con la selección nueva. */
     coRemove: EventEmitter<string>;
+    /** Click en el botón primario del footer (`showFooter`); cierra el panel. Sin `detail`. */
     coFooterPrimary: EventEmitter<void>;
+    /** Click en el botón secundario del footer (p. ej. «Nuevo»); el panel queda abierto. Sin `detail`. */
     coFooterSecondary: EventEmitter<void>;
     /** Re-emisión del toggle de pin de una fila del panel (pinnable). */
     coPinToggle: EventEmitter<{

package/dist/types/components/co-rich-text-editor/co-rich-text-editor.d.ts

@@ -7,11 +7,19 @@ import type { Editor, RichTextOutput, RichTextPreset, ToolbarVariant } from '@pr
  * ProseMirror builds its editable DOM imperatively — Stencil's scoped CSS would
  * never reach it. All styles live in light DOM via BEM + `--co-*` tokens.
  *
+ * Editor de texto enriquecido configurado por `preset` (tarea, comentario,
+ * notas, email, documento, impresión). Wrapper Vue: `CoRichTextEditor` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot content-end - Zona entre el contenido y la barra inferior (adjuntos pendientes, vistas previas). Siempre montar el hijo y ocultarlo con CSS.
+ * @slot toolbar-end - Al final de la fila de la barra cuando `toolbarPosition="bottom"` (p. ej. el botón «Enviar»). Siempre montar el hijo.
+ *
  * @part wrapper - Outer container
  * @part toolbar - Formatting toolbar
  * @part content - Editable ProseMirror surface
  * @part label - Field label
  * @part helper - Helper text row
+ * @part toolbar-row - Fila de la barra inferior (`toolbarPosition="bottom"`) con el slot `toolbar-end`.
  */
 export declare class CoRichTextEditor {
     el: HTMLElement;
@@ -19,10 +27,15 @@ export declare class CoRichTextEditor {
     value: string | null;
     /** Preset controlling allowed nodes/marks, toolbar and sanitization. */
     preset: RichTextPreset;
+    /** Texto de ayuda del editor vacío. */
     placeholder: string;
+    /** Etiqueta del campo. */
     label?: string;
+    /** Texto secundario junto a la etiqueta. */
     secondaryLabel?: string;
+    /** Texto de ayuda o de error bajo el editor. */
     helperText?: string;
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
     /** Visual style. `flat` strips the frame's border and background so it
      *  reads as plain content instead of a boxed control — padding, label,
@@ -32,11 +45,17 @@ export declare class CoRichTextEditor {
      *  outer box is gone. `default` (the standard bordered box) renders
      *  identically to before this prop existed. */
     variant: 'default' | 'flat';
+    /** Deshabilita el editor. */
     disabled: boolean;
+    /** Solo lectura: sin barra ni edición; `coChange` sale en el acto (p. ej. al marcar una casilla de task-list). */
     readonly: boolean;
+    /** Campo obligatorio (marca de requerido en la etiqueta). */
     required: boolean;
+    /** Límite de caracteres (sobrescribe el del preset); muestra el contador «n / max». */
     maxLength?: number;
+    /** Muestra el contador de caracteres aunque no haya `maxLength`. */
     showCharacterCount: boolean;
+    /** Enfoca el editor al montarse. */
     autofocus: boolean;
     /** Toolbar layout. `auto` uses the preset default. */
     toolbar: ToolbarVariant;
@@ -100,8 +119,11 @@ export declare class CoRichTextEditor {
     coInput: EventEmitter<RichTextOutput>;
     /** Emitted on blur (committed value). */
     coChange: EventEmitter<RichTextOutput>;
+    /** El editor ganó el foco. */
     coFocus: EventEmitter<void>;
+    /** El editor perdió el foco (lo sigue `coChange`). */
     coBlur: EventEmitter<void>;
+    /** Se vació el contenido con `clear()`. */
     coClear: EventEmitter<void>;
     /** Emitted once the editor is mounted and ready. */
     coReady: EventEmitter<void>;
@@ -145,10 +167,8 @@ export declare class CoRichTextEditor {
     private _loadedAccountFonts;
     private _fontLoaderCalled;
     private _fontLoaderLoading;
-    /** Last emitted JSON string — guards the value Watch against feedback loops. */
-    private lastEmittedJson;
-    /** Last emitted HTML string — parents often send HTML back via value prop. */
-    private lastEmittedHtml;
+    /** Guarda anti-eco compartida (utils/rich-text-host). */
+    private echo;
     /** True while applying an external value (suppresses emit). */
     private applyingExternal;
     private rt;
@@ -162,17 +182,23 @@ export declare class CoRichTextEditor {
     onAccountFontsChange(): void;
     onValueChange(next: string | null): void;
     onEditableChange(): void;
+    /** Documento como JSON de ProseMirror, o `null` si está vacío. */
     getJSON(): Promise<object | null>;
+    /** HTML sanitizado según el preset (`getHtml`, no `getHTML`, para no chocar con `HTMLElement`). */
     getHtml(): Promise<string>;
+    /** Texto plano del documento. */
     getText(): Promise<string>;
+    /** Vacía el contenido y emite `coClear`. */
     clear(): Promise<void>;
+    /** Enfoca el editor (`focusEditor`, no `focus`, para no chocar con `HTMLElement`). */
     focusEditor(): Promise<void>;
+    /** Reemplaza el contenido: HTML (string) o JSON de ProseMirror. */
     setContent(content: string | object): Promise<void>;
+    /** Instancia Tiptap subyacente (escape hatch para control avanzado), o `null` antes de montar. */
     getEditorInstance(): Promise<Editor | null>;
     /** Whether the image node is enabled (mirrors presets.ts `wantImage` logic). */
     private get imagesEnabled();
     private get parsedFeatures();
-    private parseValue;
     private sanitizeHtml;
     private buildOutput;
     private handleUpdate;

package/dist/types/components/co-rich-text-toolbar/co-rich-text-toolbar.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import type { Editor, ToolbarEntry } from '@prolibu-suite/cobalt-rich-text';
+import type { Editor, ToolbarEntry, ToolbarExtraItem } from '@prolibu-suite/cobalt-rich-text';
 /**
  * Formatting toolbar for co-rich-text-editor. Receives the Tiptap editor
  * instance via the `editor` JS property, runs commands, and reflects active
@@ -8,16 +8,19 @@ import type { Editor, ToolbarEntry } from '@prolibu-suite/cobalt-rich-text';
  *
  * @part toolbar - The toolbar container
  * @part button - A toolbar button
+ *
+ * Wrapper Vue: `CoRichTextToolbar` de `@prolibu-suite/cobalt-vue`.
  */
 export declare class CoRichTextToolbar {
     el: HTMLElement;
     /** Editor instance (set as a property by the host editor). */
     editor?: Editor;
     /** Toolbar layout variant. */
-    variant: 'none' | 'compact' | 'compact-assets' | 'basic' | 'notes' | 'email' | 'full';
+    variant: 'none' | 'compact' | 'compact-assets' | 'basic' | 'notes' | 'email' | 'full' | 'document';
     /** Placement inside co-rich-text-editor. `bottom` drops the toolbar's own bottom
      * border/background/rounding: the editor's toolbar row paints the separator. */
     position: 'top' | 'bottom';
+    /** Deshabilita la barra: sus botones no ejecutan acciones sobre el editor. */
     disabled: boolean;
     /** BCP-47 locale for UI strings (e.g. 'en', 'es-CO', 'pt-BR'). Default English. */
     locale: string;
@@ -28,6 +31,13 @@ export declare class CoRichTextToolbar {
     attachmentsEnabled: boolean;
     /** `accept` attr for the attachment file picker (e.g. '.pdf,.png'). */
     attachmentAccept?: string;
+    /** Muestra «Encabezado» (variante document). co-document-editor lo apaga mientras se edita la banda. */
+    documentHeaderEnabled: boolean;
+    /**
+     * Botones del host al final de la barra (propiedad JS o JSON): `[{ id, label, icon? }]`.
+     * Su clic emite `coAction` con `{ action: id, payload: { extra: true } }` y no toca el editor.
+     */
+    extraItems?: ToolbarExtraItem[] | string;
     /** Emitted whenever a toolbar action runs (observability for hosts). */
     coAction: EventEmitter<{
         action: string;
@@ -81,6 +91,8 @@ export declare class CoRichTextToolbar {
     componentWillLoad(): void;
     onVariantChange(v: string): void;
     onAttachmentsEnabledChange(): void;
+    onDocumentHeaderEnabledChange(): void;
+    private get parsedExtraItems();
     onEditorChange(next?: Editor, prev?: Editor): void;
     /**
      * Command whose presence in the schema proves an item's extension is loaded.
@@ -88,6 +100,12 @@ export declare class CoRichTextToolbar {
      * link, paragraph/heading, undo/redo, text color) and are always shown.
      */
     private static readonly ITEM_COMMAND;
+    /**
+     * Filtro por schema SOLO de la variante `document` (co-document-editor): el editor
+     * del encabezado (preset print-header) no tiene links, títulos, listas ni firmas.
+     * Las demás variantes resuelven exactamente como antes (spec: el RTE no cambia).
+     */
+    private static readonly DOCUMENT_ITEM_COMMAND;
     /**
      * Resolve a variant to the items actually usable in the current editor:
      * hide any control whose extension the active preset didn't load, then

package/dist/types/components/co-rich-text-viewer/co-rich-text-viewer.d.ts

@@ -1,4 +1,12 @@
 import type { RichTextPreset } from '@prolibu-suite/cobalt-rich-text';
+/**
+ * Visor de solo lectura de contenido rich text (HTML o JSON de ProseMirror),
+ * sanitizado según el `preset`. En `format="html"` no carga Tiptap: solo
+ * DOMPurify. Wrapper Vue: `CoRichTextViewer` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part content - El contenido renderizado.
+ * @part empty - El texto de vacío (`emptyText`) cuando no hay contenido.
+ */
 export declare class CoRichTextViewer {
     /** HTML string (default) or ProseMirror JSON string. */
     value: string | null;

package/dist/types/components/co-row/co-row.d.ts

@@ -3,6 +3,9 @@
  * @slot prefix  - Leading content (icon, checkbox)
  * @slot         - Main content
  * @slot suffix  - Trailing content (switch, badge, action)
+ *
+ * Wrapper Vue: `CoRow` de `@prolibu-suite/cobalt-vue`.
+ * @part row - La fila.
  */
 export declare class CoRow {
     /** Position in a group — affects border radius */

package/dist/types/components/co-segmented-bar/co-segmented-bar.d.ts

@@ -11,6 +11,12 @@ export interface CoSegment {
  * A stacked, multi-segment meter — a pill track split into N contiguous
  * colored segments (e.g. a storage breakdown). Display-only; colors are
  * supplied by the consumer. Provide an external legend via `slot="legend"`.
+ * Wrapper Vue: `CoSegmentedBar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @slot legend - Leyenda externa bajo la barra.
+ * @part segmented-bar - Contenedor del componente.
+ * @part track - La pista (pastilla) que contiene los segmentos.
+ * @part segment - Cada segmento de color.
  */
 export declare class CoSegmentedBar {
     /** Track height in px. */

package/dist/types/components/co-select/co-select.d.ts

@@ -7,7 +7,14 @@ export interface SelectOption {
     image?: string;
     disabled?: boolean;
 }
+/**
+ * Selector desplegable de una o varias opciones de una lista conocida, con
+ * búsqueda opcional del lado del cliente y lista virtualizada. Para opciones que
+ * vienen paginadas del servidor usá `co-ref-field`. Wrapper Vue: `CoSelect` de
+ * `@prolibu-suite/cobalt-vue`.
+ */
 export declare class CoSelect {
+    /** Etiqueta del campo (también es su nombre accesible). */
     label?: string;
     /** Accessible name for the combobox when there is NO visible `label` (compact
      *  rows that drop the field label). Same `ariaLabelText` precedent as
@@ -17,27 +24,58 @@ export declare class CoSelect {
     ariaLabelText?: string;
     /** Whether the field is required (renders a required marker on the label). */
     required: boolean;
+    /** Texto secundario junto a la etiqueta (p. ej. «Opcional»); con `labelStyle="inline-help"` va a la derecha. */
     secondaryLabel?: string;
+    /** Texto del trigger sin selección. */
     placeholder: string;
+    /** Deshabilita el campo. */
     disabled: boolean;
+    /** Ícono Phosphor al inicio del trigger. */
     iconLeft?: string;
+    /** Tamaño (px) del `co-icon` de `iconLeft`. Sin setear, conserva el actual (16). */
+    iconSize?: number;
+    /** Botón × para vaciar la selección cuando hay valor; emite `coClear` y `coChange`. */
     clearable: boolean;
+    /** Texto de ayuda o de error bajo el campo. */
     helperText?: string;
     /** Label layout: vertical (label above) or horizontal (label beside) */
     layout: 'vertical' | 'horizontal';
+    /** Estado de validación: pinta el borde y el `helperText` con el color del estado. */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
+    /** Opciones: array de `{ value, label, icon?, image?, disabled? }`, array de strings
+     *  (value = label), o ese mismo array como JSON desde HTML. */
     options: SelectOption[] | string[] | string;
+    /** Selección: el `value` de la opción en single; en `multiple`, array o JSON array.
+     *  `''` significa «sin selección» (una opción con `value: ''` no se puede marcar).
+     *  El componente lo actualiza al elegir. */
     value: string | string[];
+    /** Selección múltiple: el panel queda abierto y `value`/`coChange` llevan un array. */
     multiple: boolean;
-    size: 's' | 'sm' | 'md' | 'lg';
+    /** Alto del trigger: `xs` 24 · `s` 28 · `sm` 32 · `md` 40 (default) · `lg` 48. Un valor fuera de la lista cae al default. */
+    size: 'xs' | 's' | 'sm' | 'md' | 'lg';
     /** Visual style. `flat` strips the trigger's border and background so it
      *  reads as plain content instead of a boxed control — padding, label,
-     *  focus ring, disabled and status states are unaffected. `default` (the
-     *  standard bordered box) renders identically to before this prop existed. */
-    variant: 'default' | 'flat';
+     *  focus ring, disabled and status states are unaffected. `soft` pinta un
+     *  fondo `gray-100` sólido con borde transparente (mismo grosor que el
+     *  default, no cambia el tamaño de la caja). `default` (the standard
+     *  bordered box) renders identically to before this prop existed. */
+    variant: 'default' | 'flat' | 'soft';
+    /** Layout de la fila de etiqueta. `inline-help` la muestra en una sola fila
+     *  (`label` a la izquierda, `secondaryLabel` a la derecha, alineados a la
+     *  línea de base) y ajusta el borde/gap del trigger para ese contexto
+     *  (modal). `default` mantiene el layout actual (labels apiladas arriba,
+     *  centradas verticalmente entre sí). */
+    labelStyle: 'default' | 'inline-help';
+    /** Superficie del panel desplegable. `dark` = fondo `surface-primary` +
+     *  texto `text-inverse`, con el check de la opción seleccionada al
+     *  INICIO (hueco siempre reservado, como `co-menu-item leadingCheck`).
+     *  `light` (default) conserva el panel y el check al final tal cual hoy. */
+    menuSurface: 'light' | 'dark';
     /** Show a search box inside the dropdown to filter options client-side. */
     searchable: boolean;
+    /** Placeholder del buscador del panel (`searchable`). */
     searchPlaceholder: string;
+    /** Texto del panel cuando la búsqueda no encuentra opciones. */
     emptyText: string;
     /** Footer de confirmación al pie del panel (paridad co-combobox/co-ref-field). */
     showFooter: boolean;
@@ -56,10 +94,15 @@ export declare class CoSelect {
     private optionsContainerEl?;
     private osInstance?;
     private searchInputEl?;
+    /** Alto y hueco de fila con los que virtualiza la lista. Se leen de los knobs
+     *  del menú (`--co-select-option-height`, `--co-select-menu-gap`) en cada
+     *  apertura; sin knobs, el paso histórico de 34 (ver `virtualRows.ts`). */
+    private rowMetrics;
     /** Scroll pendiente hacia la opción activa, resuelto en componentDidRender. */
     private pendingActiveScroll;
     private activeScrollFrames;
-    private static readonly ITEM_HEIGHT;
+    /** Filas visibles sin scroll. Es el mismo 8 del `max-height` de
+     *  `.co-select__options` (8 altos + 7 huecos): si cambia uno, cambia el otro. */
     private static readonly VIEWPORT_ITEMS;
     private static readonly OVERSCAN;
     /** Ids del shadow root (únicos por instancia sin sufijos aleatorios).
@@ -75,7 +118,10 @@ export declare class CoSelect {
      *  el scroll quedaba clampeado en cualquier parte de la lista en vez de en la
      *  opción seleccionada. El loop corta solo al verificar el write o al cerrar. */
     private static readonly ACTIVE_SCROLL_MAX_FRAMES;
+    /** Cambió la selección (`value` ya está actualizado): `detail` = value elegido, o el
+     *  array completo en `multiple`. Al vaciar con la ×: `''` (o `[]`). */
     coChange: EventEmitter<string | string[]>;
+    /** Se vació la selección con la ×. Sin `detail`; le sigue un `coChange`. */
     coClear: EventEmitter<void>;
     /** Click en el botón primario del footer (el panel se cierra solo). */
     coFooterPrimary: EventEmitter<void>;
@@ -98,6 +144,12 @@ export declare class CoSelect {
     /** Al abrir, la activa arranca en la opción seleccionada (la primera de ellas
      *  en multiple) para que las flechas continúen desde donde el usuario está. */
     private resetActiveIndex;
+    /** Valor en px de una custom property heredada por el host, o `null` si no
+     *  está seteada o no resuelve a px. El caso común (`12px`, o un token `--co-*`
+     *  en px, que ya llega sustituido) se lee directo; cualquier otra forma
+     *  (`calc()`, `rem`…) la resuelve el motor CSS sobre un nodo de prueba
+     *  `display: none` que vive solo durante la lectura. */
+    private readCssLengthPx;
     onOpenChange(open: boolean): void;
     private handleSearchInput;
     private handleTriggerClick;
@@ -115,6 +167,19 @@ export declare class CoSelect {
      *  intacto. */
     private handleNavKeyDown;
     private setActiveIndex;
+    /** El puntero MUEVE la activa: hay un solo resaltado, el de `--active`, y el
+     *  CSS ya no pinta `:hover` en las filas. Con los dos canales se veían DOS
+     *  filas resaltadas a la vez (la activa por teclado y la de abajo del mouse).
+     *
+     *  `pointermove` y no `mouseenter`/`mouseover`: cuando el TECLADO scrollea la
+     *  lista bajo un mouse quieto, el navegador actualiza el hover y dispara esos
+     *  eventos de borde, pero no un `pointermove` — la activa del teclado no se la
+     *  roba una fila que pasó por debajo del cursor (medido en Chromium).
+     *
+     *  Sin `scrollActiveIntoView`: la fila ya está bajo el puntero, scrollear la
+     *  haría saltar. El toque no cuenta: arrastrar el dedo es scrollear. Una fila
+     *  deshabilitada no llega acá (`pointer-events: none`). */
+    private handleOptionPointerMove;
     /** Enter/Space sobre una opción deshabilitada no hace nada — igual que el
      *  click (la tecla igual se consume: el panel abierto no togglea). */
     private activateActiveOption;
@@ -153,6 +218,9 @@ export declare class CoSelect {
     disconnectedCallback(): void;
     /** Option label with the matched substring wrapped for highlighting. */
     private renderLabel;
+    /** `?? LEGACY`: el harness de specs no siembra inicializadores de campo en
+     *  todos los casos; en el build real `rowMetrics` siempre existe. */
+    private get metrics();
     private getVirtualSlice;
     render(): any;
 }

package/dist/types/components/co-select/virtualRows.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Geometría del virtualizador de filas de `co-select`, pura: recibe medidas y
+ * devuelve medidas, sin tocar el DOM (el componente es el que las lee del CSS).
+ *
+ * El paso de una fila es su ALTO más el HUECO hasta la siguiente. Los dos salen
+ * de los knobs del menú (`--co-select-option-height`, `--co-select-menu-gap`);
+ * sin ellos rige el paso de 0.10.x (ver `LEGACY_ROW_METRICS`).
+ */
+export interface RowMetrics {
+    /** Alto de una fila, en px. */
+    rowHeight: number;
+    /** Hueco entre dos filas consecutivas, en px (no hay hueco después de la última). */
+    gap: number;
+}
+/**
+ * Paso histórico, el de 0.10.x: 34 px por fila, sin hueco. Las filas por defecto
+ * miden 32 (`min-height`), así que el virtualizador reserva 2 px de más por fila
+ * — la lista corta muestra ese sobrante como aire al pie del panel. Se conserva
+ * TAL CUAL para que ningún consumidor actual vea cambiar el alto de su menú; el
+ * que setea `--co-select-option-height` obtiene el paso exacto de sus filas. Es
+ * el mismo 34 del fallback del `max-height` de `.co-select__options`.
+ */
+export declare const LEGACY_ROW_METRICS: Readonly<RowMetrics>;
+/** Alto de `count` filas apiladas: sin hueco colgando después de la última. */
+export declare function listHeight(count: number, m: RowMetrics): number;
+/** Ventana de filas a renderizar para un `scrollTop`, con `overscan` a cada lado. */
+export declare function virtualSlice(total: number, scrollTop: number, m: RowMetrics, viewportItems: number, overscan: number): {
+    totalHeight: number;
+    startIdx: number;
+    endIdx: number;
+    offsetY: number;
+};
+/**
+ * `scrollTop` que deja la fila `index` entera dentro de una ventana de
+ * `viewportItems` filas: si está arriba, la sube al borde superior; si está
+ * abajo, la pega al inferior; si ya se ve, no mueve nada.
+ */
+export declare function scrollTopToReveal(index: number, scrollTop: number, m: RowMetrics, viewportItems: number): number;
+/**
+ * Medidas a partir de los knobs. `readPx` devuelve el valor en px de una custom
+ * property, o `null` si no está seteada o no se puede resolver a px. Lo que
+ * falte o sea inválido (alto ≤ 0, hueco < 0, NaN) cae al valor histórico.
+ */
+export declare function resolveRowMetrics(readPx: (cssVar: string) => number | null): RowMetrics;

package/dist/types/components/co-separator/co-separator.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Línea divisoria horizontal o vertical, con espaciado e inset opcionales y
+ * color/grosor configurables por prop. Wrapper Vue: `CoSeparator` de
+ * `@prolibu-suite/cobalt-vue`.
+ *
+ * @part separator - La línea.
+ */
 export declare class CoSeparator {
     /** Orientation: horizontal (default) or vertical */
     vertical: boolean;

package/dist/types/components/co-sidebar/co-sidebar.d.ts

@@ -1,5 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
+ * Barra lateral de navegación con cabecera, cuerpo de ítems y pie. Wrapper Vue:
+ * `CoSidebar` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part sidebar - La barra completa.
+ * @part header - Área del slot `header`.
+ * @part body - Área de navegación (slot por defecto).
+ * @part footer - Área del slot `footer`.
+ *
  * @slot header - Logo / branding area
  * @slot        - Navigation items (co-list-item, etc.)
  * @slot footer - Bottom section

package/dist/types/components/co-sidebar-nav/co-sidebar-nav.d.ts

@@ -21,6 +21,7 @@ export interface NavigateDetail {
  * A complete sidebar navigation component that renders a hierarchical menu.
  * Accepts the raw `uiSchemas.sideBar` JSON from the Prolibu API and
  * automatically renders categories, expandable groups, and leaf items.
+ * Wrapper Vue: `CoSidebarNav` de `@prolibu-suite/cobalt-vue`.
  *
  * @example
  * ```html

package/dist/types/components/co-skeleton/co-skeleton.d.ts

@@ -2,6 +2,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
 /**
  * Placeholder de carga con shimmer (sweep). Componer apilando varios.
  * Respeta prefers-reduced-motion (sin animación).
+ * Wrapper Vue: `CoSkeleton` de `@prolibu-suite/cobalt-vue`.
+ *
+ * @part skeleton - El bloque con el shimmer.
  */
 export declare class CoSkeleton {
     /** rect (default) | text (radio menor) | circle */