@prolibu-suite/cobalt-core 0.3.0 → 0.5.0

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

@@ -25,6 +25,12 @@ export declare class CoDrawer {
     closeOnOverlay: boolean;
     /** Close when pressing Escape */
     closeOnEscape: boolean;
+    /** Render without the modal overlay: no scrim, no body-scroll lock — the
+     *  page behind stays fully interactive. The panel promotes itself to the
+     *  browser top layer (Popover API) so ancestor filters/transforms can't
+     *  clip it. Close vectors: X button, Escape, or the consumer flipping
+     *  `open` — there is deliberately no click-outside in this mode. */
+    modeless: boolean;
     /** Show a loading overlay over the body */
     loading: boolean;
     /** Requested to close (X, backdrop, Esc). Consumer should set `open=false`. */
@@ -41,5 +47,11 @@ export declare class CoDrawer {
     private handleCloseClick;
     private stopPropagation;
     private handleTransitionEnd;
+    private asideEl?;
+    /** Modeless only: keep the aside promoted to the top layer for its whole
+     *  lifetime (mirrors co-overlay's syncPopover; eviction on disconnect is
+     *  automatic). */
+    private promoteModeless;
+    componentDidLoad(): void;
     render(): any;
 }

package/dist/types/components/co-drive-card/co-drive-card.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * co-drive-card — a selectable Drive item card.
+ *
+ * A plain flex/grid surface that `co-card` cannot host: `co-card` projects its
+ * children into a shadow-DOM body that forces block flow, clips with
+ * `overflow:hidden`, locks a 16px radius + a real 1px border, and paints an
+ * opaque surface that occludes the selected accent tint. This component renders
+ * two faithful layouts instead — a `folder` flex row and a `file` column with a
+ * thumbnail — with an absolute corner select-chip, a 1.5px inset selection ring,
+ * and a shadow-sm + hairline hover.
+ *
+ * @slot thumb    - (file) The thumbnail region at the top of the card.
+ * @slot type     - (file) The file-type tile in the foot row. Falls back to
+ *                  <co-file-type-tile> when `ext` is set.
+ * @slot trailing - (folder) Trailing content after the star (e.g. a dots menu).
+ * @slot actions  - (file) The fading action affordance in the foot row.
+ */
+export declare class CoDriveCard {
+    /** Which layout to render. */
+    variant: 'folder' | 'file';
+    /** Vertical rhythm / sizing. */
+    density: 'comfy' | 'compact';
+    /** Accent CSS color driving the icon tile, selection ring and select chip. */
+    accent: string;
+    /** Primary label (name). */
+    name: string;
+    /** Muted secondary line (meta). */
+    meta: string;
+    /** Whether the item is selected. Controlled — parent updates it on coToggleSelect. */
+    selected: boolean;
+    /** Whether the item is starred. */
+    starred: boolean;
+    /** (file) Whether the item is the active/current item — draws a heavier inset ring. */
+    active: boolean;
+    /** (file) File extension used to render a default <co-file-type-tile> in the foot when the `type` slot is empty. */
+    ext?: string;
+    /** Fired when the card is activated (click / Enter / Space). */
+    coOpen: EventEmitter<void>;
+    /** Fired when the select chip is toggled — emits the NEW selected state. */
+    coToggleSelect: EventEmitter<boolean>;
+    /** Fired when the star affordance is clicked. */
+    coStar: EventEmitter<void>;
+    private handleOpen;
+    private handleKeyDown;
+    private handleToggleSelect;
+    private handleStar;
+    private renderSelectChip;
+    private renderFolder;
+    private renderFile;
+    render(): any;
+}

package/dist/types/components/co-drop-zone/co-drop-zone.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * co-drop-zone — a drag-to-upload overlay.
+ *
+ * Wraps arbitrary slotted content and paints an absolute dashed overlay on top
+ * of it while a drag is in progress. Can be driven two ways:
+ *  1. Controlled — the consumer toggles `active` (e.g. from its own drag state).
+ *  2. Self-managed — the host listens for native dragenter/over/leave/drop and
+ *     flips `active` itself, emitting `coDragStateChange` and `coDrop`.
+ *
+ * Report ref: 3.17 (446–449); drag overlay spec: report lines 135–136.
+ */
+export declare class CoDropZone {
+    /** Whether the drag-to-upload overlay is visible. */
+    active: boolean;
+    /** Accent color for the dashed border, badge icon and tinted background. */
+    accent: string;
+    /** Overlay label text. */
+    label: string;
+    /** Phosphor icon name shown in the badge. */
+    icon: string;
+    /** Emitted with the dropped files. */
+    coDrop: EventEmitter<File[]>;
+    /** Emitted whenever the internal drag-over state flips. */
+    coDragStateChange: EventEmitter<boolean>;
+    /**
+     * Nested dragenter/dragleave counter. Without it, moving the cursor over a
+     * slotted child fires `dragleave` (from the parent) then `dragenter` (from the
+     * child), which would flicker the overlay off and on.
+     */
+    private dragDepth;
+    private setActive;
+    private handleDragEnter;
+    private handleDragOver;
+    private handleDragLeave;
+    private handleDrop;
+    render(): any;
+}

package/dist/types/components/co-empty-state/co-empty-state.d.ts

@@ -9,5 +9,11 @@ export declare class CoEmptyState {
     heading?: string;
     /** Descriptive text */
     description?: string;
+    /** Visual style: `plain` (default, current behavior) or `card` (framed white card). */
+    variant: 'plain' | 'card';
+    /** Size scale. `l` grows the medallion (98px) and heading (24/500). */
+    size: 'm' | 'l';
+    /** Phosphor icon weight. Defaults to `light` (plain) / `regular` (card) when unset. */
+    iconWeight?: 'thin' | 'light' | 'regular' | 'bold' | 'fill' | 'duotone';
     render(): any;
 }

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

@@ -3,7 +3,9 @@ export declare class CoFab {
     icon: string;
     label?: string;
     variant: 'primary' | 'secondary' | 'stroke';
-    size: 'l' | 'm' | 's';
+    size: 'xl' | 'l' | 'm' | 's';
+    /** Accessible label for icon-only FABs (falls back to `label`/`icon`). */
+    ariaLabelText?: string;
     disabled: boolean;
     /** Fixed position on screen */
     position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'none';

package/dist/types/components/co-file-type-tile/co-file-type-tile.d.ts

@@ -0,0 +1,11 @@
+export declare class CoFileTypeTile {
+    /** File extension (e.g. "pdf", "docx", "png"). Case-insensitive; a leading dot is ignored. */
+    ext: string;
+    /** Tile edge length in px (React uses 44 / 34 / 26). */
+    size: number;
+    /** Corner radius in px (React uses 11 / 9 / 7). */
+    radius: number;
+    /** When true, use the type's tint/accent colors; when false, neutral gray-100 / gray-600. */
+    colorTags: boolean;
+    render(): any;
+}

package/dist/types/components/co-icon-button/co-icon-button.d.ts

@@ -1,9 +1,15 @@
 export declare class CoIconButton {
     /**
-     * filled = dark background (negro), outlined = light background (blanco + border)
+     * filled = dark background (negro), outlined = light background (blanco + border),
+     * ghost = transparent background, no border, tinted hover (negro-8 on light / blanco-16 on dark).
      * Matches Figma: Secundario → filled, Primario → outlined
      */
     variant: 'filled' | 'outlined' | 'ghost';
+    /**
+     * Surface the button sits on. `dark` → white icon + blanco-16 hover (on-dark theming).
+     * Defaults to `light` (no extra class → identical to previous behavior).
+     */
+    surface: 'light' | 'dark';
     /** Shape: pill or straight corners */
     shape: 'rounded' | 'square';
     /**
@@ -11,6 +17,17 @@ export declare class CoIconButton {
      * xl=80, lg=64, md=56, sm=48, xs=32, xxs=24
      */
     size: 'xl' | 'lg' | 'md' | 'sm' | 'xs' | 'xxs';
+    /**
+     * Override the container box in px (width === height). When set, takes precedence
+     * over the `size` class dimensions — lets you hit 32/36/40 rounded squares.
+     * When omitted, the `size` class dimensions apply (unchanged behavior).
+     */
+    boxSize?: number;
+    /**
+     * Override the rendered icon size in px. When set, takes precedence over the
+     * per-`size` icon default (which is otherwise unchanged — e.g. 16px at xs).
+     */
+    iconSize?: number;
     /** Disabled state */
     disabled: boolean;
     /** Accessible label */
@@ -19,7 +36,5 @@ export declare class CoIconButton {
     icon?: string;
     /** Icon weight */
     iconWeight: 'regular' | 'thin' | 'light' | 'bold' | 'fill' | 'duotone';
-    /** Override the size-derived glyph px (e.g. 24). Falls back to the size default. */
-    iconSize?: number;
     render(): any;
 }

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

@@ -42,8 +42,16 @@ export declare class CoInput {
     autocomplete?: string;
     /** Validation status */
     status: 'default' | 'error' | 'success' | 'warning' | 'info';
-    /** Size variant: s (28px), sm (32px), md (40px, default), lg (48px) */
+    /** Size variant: s (28px), sm (32px), md (40px, default), lg (48px).
+     *  In the filled search-pill variant (`fill`) this drives the pill height
+     *  instead (s ≈ 38px). */
     size: 's' | 'sm' | 'md' | 'lg';
+    /** Filled search-pill variant. When true the field renders as a minimal gray
+     *  pill (background gray-100, no border/box-shadow, 10px radius) with a search
+     *  glyph on the left and a plain-`x` clear — the floating label, helper text and
+     *  status chrome are suppressed. When false (default) the field renders
+     *  IDENTICALLY to the standard text field. */
+    fill: boolean;
     /** Label for the integrated action button (Botón variant) */
     actionLabel?: string;
     /** Phosphor icon name for the integrated action button */
@@ -74,5 +82,9 @@ export declare class CoInput {
     private get hasValue();
     private get statusFieldIcon();
     private get helperIcon();
+    /** Filled search-pill variant (fill=true). Minimal chrome: icon-left + native
+     *  input + plain-x clear. No labels, helper text, status icons, chips or action.
+     *  The default field render path is left untouched. */
+    private renderFill;
     render(): any;
 }

package/dist/types/components/co-media-thumb/co-media-thumb.d.ts

@@ -0,0 +1,21 @@
+/**
+ * An image / video preview region. Renders a cover image when `src` is set,
+ * an optional dark scrim + play button when `video` is true, and a default
+ * slot fallback (for a type-icon box) when there is no `src`.
+ *
+ * @slot - Fallback content shown when `src` is not set (e.g. a type-icon box).
+ */
+export declare class CoMediaThumb {
+    /** Image source URL. When set, a cover image is rendered. */
+    src?: string;
+    /** Show the video overlay (dark scrim + centered play button). */
+    video: boolean;
+    /** Height of the region. Accepts a CSS length or a bare number (→ px). */
+    height: string | number;
+    /** Corner radius in px. */
+    radius: number;
+    /** Alternative text for the image. */
+    alt?: string;
+    private toCss;
+    render(): any;
+}

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

@@ -34,6 +34,10 @@ export declare class CoMenu {
     autoClose: boolean;
     /** Whether the menu panel is visible. Reflected to attribute. */
     open: boolean;
+    /** Fixes the panel to an exact width (e.g. `'210px'`). When unset, the panel
+     *  keeps its intrinsic auto width (min-width 200px). Also tune padding with the
+     *  `--co-menu-padding` CSS var (default 4px; design uses 6px). */
+    width?: string;
     coOpen: EventEmitter<void>;
     coClose: EventEmitter<void>;
     el: HTMLElement;

package/dist/types/components/co-menu-item/co-menu-item.d.ts

@@ -14,12 +14,21 @@ import { EventEmitter } from '../../stencil-public-runtime';
  * Submenu nesting is unbounded — submenu items can themselves have submenus.
  */
 export declare class CoMenuItem {
-    /** Icon name (Phosphor) rendered before the label. */
+    /** Icon name (Phosphor) rendered before the label. Optional — rows may be
+     *  label-only. */
     icon?: string;
+    /** Overrides the leading icon size (px). Defaults to 16. */
+    iconSize?: number;
     /** Text shown in the row. */
     label?: string;
     /** Tighter row metrics (32px instead of 36px). */
     dense: boolean;
+    /** Marks the row as selected — paints an at-rest gray-100 background. Used by
+     *  single-select menus (sort/type). */
+    selected: boolean;
+    /** Renders a trailing check (size 15) after the label. Pair with `selected`
+     *  to mark the chosen option in a single-select menu. */
+    trailingCheck: boolean;
     /** Visually disabled — pointer events ignored, opacity reduced. */
     disabled: boolean;
     /** `danger` shifts text + icon to the destructive color. Use for Delete, etc. */

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

@@ -14,8 +14,25 @@ export declare class CoModal {
     closable: boolean;
     /** Close when clicking the overlay backdrop */
     closeOnOverlay: boolean;
-    /** Modal width: sm (400px), md (540px), lg (680px) */
-    size: 'sm' | 'md' | 'lg';
+    /**
+     * Opt-in: close when Escape is pressed. Default false → existing consumers
+     * are unchanged.
+     *
+     * Handled here rather than by forwarding co-overlay's own `closeOnEscape`:
+     * co-overlay emits the SAME `coClose` for a backdrop click and for Escape,
+     * and this component gates that event on `closeOnOverlay`. Forwarding would
+     * therefore swallow Escape whenever `closeOnOverlay` is false.
+     */
+    closeOnEscape: boolean;
+    /**
+     * Modal width: sm (400px), md (540px), lg (680px),
+     * full (min(1400px, 95vw) × 92vh — media/document viewers).
+     *
+     * `full` also drops the body padding and lets the body grow, so a slotted
+     * <video>/<iframe> fills the panel edge-to-edge instead of sitting in a
+     * content-height box.
+     */
+    size: 'sm' | 'md' | 'lg' | 'full';
     /** Hide body section and all border dividers (compact confirm dialogs) */
     noDividers: boolean;
     /** Emitted when the modal requests to close */
@@ -28,6 +45,7 @@ export declare class CoModal {
     private handleOverlayClick;
     private handleCloseClick;
     private stopPropagation;
+    handleKeydown(e: KeyboardEvent): void;
     private handleTransitionEnd;
     render(): any;
 }

package/dist/types/components/co-option-list/co-option-list.d.ts

@@ -0,0 +1,105 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { OptionListItem } from './optionListLogic';
+/**
+ * Núcleo de lista de opciones — la única fuente del look & behavior de los
+ * dropdowns Cobalt (co-ref-field, co-combobox, co-autocomplete,
+ * co-command-search) y de los pickers de celda de suite-v2.
+ *
+ * NO renderiza trigger ni chrome de panel (popover/dialog/ancho): eso es del
+ * host. Es 100% controlada: no muta `value`; emite y el host decide.
+ *
+ * @slot footer - Footer del panel (normalmente <co-list-footer>).
+ */
+export declare class CoOptionList {
+    el: HTMLElement;
+    /** JSON string o array de OptionListItem. */
+    items: string | OptionListItem[];
+    /** Selección actual: id single o JSON array de ids. */
+    value: string;
+    /** Display-items de la selección (para selected-first con ids fuera de página). */
+    selectedItems: string | OptionListItem[];
+    multiple: boolean;
+    /** Partición selected-first (snapshot al llamar snapshotOrder()). */
+    selectedFirst: boolean;
+    /** Afford. del seleccionado: check (combobox/autocomplete) o X deselect (ref-field). */
+    selectedAffordance: 'check' | 'deselect';
+    /** Botón remove por fila seleccionada en multiple (tags de combobox). */
+    removableItems: boolean;
+    searchable: boolean;
+    searchPlaceholder: string;
+    searchDebounce: number;
+    /** Pre-seed del término (modo convert de las celdas). */
+    initialTerm: string;
+    loading: boolean;
+    /** Total del server: deriva hasMore + hint "N more results". */
+    total: number;
+    /** Fallback cuando el host no conoce totales (⌘K). total>0 manda. */
+    hasMore: boolean;
+    emptyMessage: string;
+    /** Si se setea y hay selección, fila "quitar selección" al tope. */
+    clearOptionLabel: string;
+    /** Lista virtualizada (autocomplete/combobox). Ignora `group`. */
+    virtual: boolean;
+    /** Resalta el match del término en los labels. */
+    highlightMatches: boolean;
+    /** Término externo para highlight (input en el host, p.ej. ⌘K). */
+    highlightTerm: string;
+    avatarShape: 'circle' | 'square';
+    /** Auto-resalta la primera fila navegable al montar y en cada cambio de
+     *  items (paridad command-palette: tipear + Enter = primer resultado).
+     *  Salta filas disabled vía nextActiveIndex. */
+    autoHighlight: boolean;
+    coSearch: EventEmitter<string>;
+    coChange: EventEmitter<{
+        value: string | string[];
+        item: OptionListItem;
+    }>;
+    coLoadMore: EventEmitter<void>;
+    coClearSelection: EventEmitter<void>;
+    coRemoveItem: EventEmitter<string>;
+    term: string;
+    activeIndex: number;
+    scrollTop: number;
+    private searchInputEl?;
+    private optionsEl?;
+    private osInstance?;
+    private debounceTimer?;
+    /** Snapshot selected-first (ver snapshotOrder). */
+    private sortSnapshot;
+    private displaySnapshot;
+    private get parsedItems();
+    private get selectedIds();
+    private get orderedItems();
+    private get effectiveHighlightTerm();
+    componentWillLoad(): void;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    onItemsChange(): void;
+    /** Re-toma el snapshot selected-first. El host la llama al abrir su panel. */
+    snapshotOrder(): Promise<void>;
+    /**
+     * Enfoca el input de búsqueda esperando visibilidad real: el panel del host
+     * se vuelve visible frames después (showPopover/position en rAF) y focus()
+     * sobre subtree oculto es no-op silencioso. Reintenta ~20 frames.
+     */
+    focusSearch(): Promise<void>;
+    /** Navegación para hosts con input externo. true = tecla consumida (host hace preventDefault). */
+    handleKey(e: KeyboardEvent): Promise<boolean>;
+    private takeSnapshot;
+    private processKey;
+    /**
+     * Enter sobre un control real (footer, fila clear) activa ese control
+     * nativamente — nunca el highlight (regla heredada de CellRefPicker).
+     */
+    private onRootKeyDown;
+    private onSearchInput;
+    private pick;
+    private maybeLoadMore;
+    private onNativeScroll;
+    private scrollActiveIntoView;
+    private renderLeading;
+    private renderLabelText;
+    private renderRow;
+    private renderVirtual;
+    render(): any;
+}

package/dist/types/components/co-option-list/optionListLogic.d.ts

@@ -0,0 +1,69 @@
+export interface OptionListItem {
+    _id: string;
+    label: string;
+    /** Colorea el label (categorías con color propio). */
+    labelColor?: string;
+    /** Subline muted (p.ej. email). */
+    description?: string;
+    /** Texto secundario junto al label, renderizado como "- suffix". */
+    suffix?: string;
+    /** Pill junto al label (generaliza el workspace badge de suite-v2). */
+    badge?: {
+        label: string;
+        color?: string;
+    };
+    /** Phosphor icon como leading visual (si no hay avatar/color). */
+    icon?: string;
+    /** Color del dot / ring del avatar. */
+    color?: string;
+    /** Iniciales del avatar. */
+    avatar?: string;
+    /** URL de imagen del avatar. */
+    image?: string;
+    /** Header de sección: se inserta uno al CAMBIAR de group (patrón ⌘K). */
+    group?: string;
+    disabled?: boolean;
+}
+export type OptionListRow = {
+    kind: 'header';
+    label: string;
+} | {
+    kind: 'item';
+    item: OptionListItem;
+    index: number;
+};
+export declare function parseItems(raw: string | OptionListItem[]): OptionListItem[];
+export declare function parseValue(raw: string): string[];
+/**
+ * Selected-first contra el snapshot tomado al abrir (patrón co-ref-field):
+ * idle → bloque seleccionado en orden de snapshot (sintetizando desde
+ * snapshotDisplay los que la página actual no contiene) + resto en orden de
+ * server; buscando → solo resultados reales, seleccionados primero.
+ *
+ * Invariante: todo id en `snapshotIds` DEBE tener una entrada correspondiente
+ * en `snapshotDisplay` (armado por el caller desde selectedItems ∪ items al
+ * tomar el snapshot). Un id sin display-item asociado se cae silenciosamente
+ * de la lista en modo idle (el `byId.get(d._id) ?? d` sintetiza desde el
+ * display-item mismo, pero no hay nada que sintetizar si el id nunca entró a
+ * snapshotDisplay en primer lugar).
+ */
+export declare function orderItems(items: OptionListItem[], snapshotIds: Set<string>, snapshotDisplay: OptionListItem[], searching: boolean): OptionListItem[];
+/** Aplana a filas de render insertando un header cuando `group` cambia
+ *  (groupItems de co-command-search). `index` cuenta solo items. */
+export declare function buildRows(items: OptionListItem[]): OptionListRow[];
+/** Siguiente highlight: wrap, salta disabled. -1 = sin items navegables. */
+export declare function nextActiveIndex(current: number, delta: 1 | -1, items: OptionListItem[]): number;
+/** `total > 0` tiene precedencia (deriva remaining); si no, vale `hasMoreProp`. */
+export declare function deriveMore(count: number, total: number, hasMoreProp: boolean): {
+    hasMore: boolean;
+    remaining: number;
+};
+export declare const VIRTUAL_ITEM_HEIGHT = 34;
+export declare const VIRTUAL_VIEWPORT_ITEMS = 8;
+export declare const VIRTUAL_OVERSCAN = 3;
+export declare function virtualSlice(scrollTop: number, count: number): {
+    totalHeight: number;
+    startIdx: number;
+    endIdx: number;
+    offsetY: number;
+};

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

@@ -26,6 +26,7 @@ export declare class CoPopover {
     private cachedOffsetAncestor;
     private offsetAncestorComputed;
     private docListenersBound;
+    componentDidLoad(): void;
     disconnectedCallback(): void;
     onOpenChange(isOpen: boolean): void;
     private bindDocListeners;

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

@@ -58,8 +58,6 @@ export declare class CoRefField {
     searchPlaceholder: string;
     searchDebounce: number;
     emptyMessage: string;
-    /** If set, shows a "Create" button in the panel footer. */
-    createLabel?: string;
     /** Show footer buttons (same pattern as co-combobox). */
     showFooter: boolean;
     /** Label for the primary footer button. */
@@ -90,29 +88,21 @@ export declare class CoRefField {
     coLoadMore: EventEmitter<void>;
     coOpen: EventEmitter<void>;
     coClose: EventEmitter<void>;
-    coCreate: EventEmitter<string>;
     coRemove: EventEmitter<string>;
     coFooterPrimary: EventEmitter<void>;
     coFooterSecondary: EventEmitter<void>;
     el: HTMLElement;
     isOpen: boolean;
-    searchText: string;
     /** How many trailing chips don't fit the trigger width (responsive mode). */
     overflowCount: number;
-    private searchInputEl?;
-    private optionsEl?;
-    private osInstance?;
-    private debounceTimer?;
+    /** The co-option-list primitive rendered inside the panel (mounted on-demand
+     *  while open). Used only to focus its search input on open. */
+    private optionListEl?;
     private chipsEl?;
     private observedChipsEl?;
     private lastChipsKey;
     private resizeObserver?;
-    /** Selection captured when the panel opens — the dropdown partitions
-     *  selected-first against THIS set so options don't jump while toggling. */
-    private sortSnapshot;
-    /** Display items for the selection captured at open (value order), used to
-     *  prepend selected items the current options page doesn't contain. */
-    private openDisplaySnapshot;
+    private pendingFocus;
     private get parsedOptions();
     private get parsedSelectedDisplay();
     /**
@@ -121,9 +111,6 @@ export declare class CoRefField {
      */
     private get effectiveDisplayItems();
     private get parsedValue();
-    private get hasMore();
-    private get remainingCount();
-    componentWillLoad(): void;
     connectedCallback(): void;
     componentDidRender(): void;
     disconnectedCallback(): void;
@@ -137,30 +124,21 @@ export declare class CoRefField {
     private handlePopoverOpen;
     private handlePopoverClose;
     private handleTriggerClick;
-    private handleSearchInput;
     private handleOptionClick;
     private handleClear;
     private handleRemoveChip;
-    private handleScroll;
-    private handleCreateClick;
     private handleFooterPrimary;
     private handleFooterSecondary;
     private renderTrigger;
     /**
-     * Leading visual for a selected value / option. Prefers a real avatar
-     * (image with initials+color fallback, via <co-avatar>), then a color dot.
-     * `size`: 'xxs' (24px) for the selected value, 'xs' (32px) for option rows.
+     * Leading visual for a selected value / chip. Prefers a real avatar (image
+     * with initials+color fallback, via <co-avatar>), then a color dot. Fixed
+     * 'xxs' (24px) size — only the trigger and chips use it now; option rows moved
+     * to <co-option-list>.
      */
     private renderItemAvatar;
     private renderSingleValue;
     private renderMultipleValue;
-    /**
-     * Options in display order: the selection captured at open comes FIRST
-     * (in chip/value order, including selected items the current page doesn't
-     * contain — synthesized from their display item), then the rest in server
-     * order. While searching, only real results render (still selected-first).
-     */
-    private get orderedOptions();
     private renderPanel;
     render(): any;
 }

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

@@ -0,0 +1,32 @@
+/** A single contiguous segment of the bar. */
+export interface CoSegment {
+    /** Portion of `total` this segment fills. */
+    value: number;
+    /** Any CSS color / token, e.g. `var(--co-color-primary-azul)`. */
+    color: string;
+    /** Optional label (used as the segment `title` tooltip). */
+    label?: string;
+}
+/**
+ * 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"`.
+ */
+export declare class CoSegmentedBar {
+    /** Track height in px. */
+    thickness: number;
+    /** Corner rounding of the track. `full` = pill. */
+    radius: 'full' | 'sm' | 'lg';
+    /** Background color of the empty track. */
+    trackColor: string;
+    /** The value the segments are measured against (100% = full track). */
+    total: number;
+    /**
+     * Segments to render — a JSON string OR an array of
+     * `{ value: number; color: string; label?: string }`.
+     */
+    segments: string | CoSegment[];
+    /** Normalize the `segments` prop (JSON string or array) to a clean array. */
+    private get parsedSegments();
+    render(): any;
+}

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

@@ -91,6 +91,8 @@ export declare class CoSidebarNav {
     private handleLeafClick;
     private handleSearchInput;
     private renderSearch;
+    /** Icon size follows the surface: 16 next to a label (Figma Home Link spec),
+        18 for the icon-only rail chips (min mode) where the glyph stands alone. */
     private renderIcon;
     /**
      * Renders a label with the search-matching substring highlighted.

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

@@ -8,6 +8,10 @@ export declare class CoTab {
     selected: boolean;
     /** Size */
     size: 'large' | 'small';
+    /** Visual variant: filled pill (default), underline tab, or segmented-control pill */
+    variant: 'pill' | 'underline' | 'segmented';
+    /** Optional count/badge pill rendered after the label */
+    badge?: string;
     /** Left icon (Phosphor name) */
     iconLeft?: string;
     /** Right icon (Phosphor name) */