@prolibu-suite/cobalt-core 0.4.0 → 0.6.0

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

@@ -32,6 +32,8 @@ export declare class CoCombobox {
     footerSecondaryLabel: string;
     /** Options to display in the dropdown (array of objects or strings) */
     options: ComboboxOption[] | string[] | string;
+    /** Message shown when the filtered list is empty. */
+    emptyMessage: string;
     /** Currently selected values (multi-select) */
     value: string[] | string;
     /** Whether multiple values can be selected */
@@ -47,17 +49,22 @@ export declare class CoCombobox {
     isOpen: boolean;
     searchQuery: string;
     overflowCount: number;
-    scrollTop: number;
     el: HTMLElement;
     private chipContainerEl?;
-    private optionsContainerEl?;
-    private osInstance?;
+    private optionListEl?;
     private resizeObserver?;
-    private static readonly ITEM_HEIGHT;
-    private static readonly VIEWPORT_ITEMS;
-    private static readonly OVERSCAN;
-    /** Emitted when the selection changes */
-    coChange: EventEmitter<string[]>;
+    /** Foco diferido del search: @Watch corre antes del commit del render que
+     *  monta la lista (patrón co-ref-field). */
+    private pendingFocus;
+    /** Emitted when the selection changes. `item` is the picked option (the
+     *  option-list's native `{ _id, label }` shape); `null` on clear. */
+    coChange: EventEmitter<{
+        value: string[] | string;
+        item: {
+            _id: string;
+            label: string;
+        } | null;
+    }>;
     /** Emitted when the dropdown opens */
     coOpen: EventEmitter<void>;
     /** Emitted when the dropdown closes */
@@ -72,8 +79,8 @@ export declare class CoCombobox {
     private get parsedOptions();
     private get selectedValues();
     private get filteredOptions();
-    /** Option label with the matched substring wrapped for highlighting. */
-    private renderLabel;
+    /** Opciones filtradas client-side, mapeadas al item de co-option-list. */
+    private get listItemsJson();
     private get displayText();
     private get selectedOptions();
     private get hasValue();
@@ -88,12 +95,19 @@ export declare class CoCombobox {
     private handlePopoverOpen;
     private handlePopoverClose;
     private handleClear;
-    private handleOptionClick;
-    private handleRemoveOption;
-    private handleSearchInput;
+    /**
+     * Handler de coChange de <co-option-list>. Misma semántica que el click
+     * de opción anterior (single: set + cierra; multiple: la primitiva ya
+     * hace el toggle y entrega el array completo) pero almacenando `value`
+     * en el MISMO formato que antes (JSON-array-string siempre — lo que
+     * espera `selectedValues`, sin tocar ese getter) y emitiendo el detail
+     * normalizado `{ value, item }`.
+     */
+    private handleListChange;
+    /** Handler de coRemoveItem de <co-option-list> — también reusado por el
+     *  botón "x" de los chips del trigger (mismo efecto: quitar un valor). */
+    private handleListRemove;
     private handleFooterPrimary;
     private handleFooterSecondary;
-    private handleOptionsScroll;
-    private getVirtualSlice;
     render(): any;
 }

package/dist/types/components/co-command-search/co-command-search.d.ts

@@ -1,5 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import { CommandItem } from './commandSearchGroup';
+export interface CommandItem {
+    label: string;
+    value: string;
+    icon?: string;
+    subtitle?: string;
+    section?: string;
+    /** When true, selectItem emits coScopeChange only (no coSelect, no close). Two-stage commit. */
+    keepOpen?: boolean;
+}
 /**
  * A command palette / search component (⌘K style).
  * Opens as an overlay with a search input and filterable list of items.
@@ -35,10 +43,9 @@ export declare class CoCommandSearch {
      *  Shown as a grid at the top of the results, only while the query is empty. */
     favorites: string;
     private query;
-    private activeIndex;
     coSelect: EventEmitter<string>;
     coClose: EventEmitter<void>;
-    coQueryChange: EventEmitter<string>;
+    coSearch: EventEmitter<string>;
     /** Emitted when an item with keepOpen=true is selected. Detail = item.value (scope model key). */
     coScopeChange: EventEmitter<string>;
     /** Emitted when Backspace is pressed with an empty query, or when the scope chip ✕ is clicked.
@@ -59,12 +66,13 @@ export declare class CoCommandSearch {
     private get parsedChips();
     private get parsedTabs();
     private get parsedFavorites();
-    /** Item label with the matched substring wrapped for highlighting. */
-    private renderLabel;
     onActiveTabChange(newVal: string): void;
     onOpenChange(newVal: boolean): void;
     private handleInput;
+    private optionListEl?;
     private handleKeyDown;
+    /** Two-stage commit intacto: keepOpen → coScopeChange; resto → coSelect + close. */
+    private handleListPick;
     /** Two-stage commit: keepOpen items emit coScopeChange only; all others emit coSelect + close. */
     private selectItem;
     private close;

package/dist/types/components/co-command-search/commandSearchLogic.d.ts

@@ -1,4 +1,4 @@
-import { CommandItem } from './commandSearchGroup.js';
+import type { CommandItem } from './co-command-search.js';
 /**
  * Pure: should the component keep open and emit coScopeChange
  * instead of the default coSelect+close?

package/dist/types/components/co-data-table/co-data-table.d.ts

@@ -5,6 +5,7 @@ export interface CoDataTableColumn {
     width?: number;
     minWidth?: number;
     sortable?: boolean;
+    filterable?: boolean;
     sticky?: boolean;
     align?: 'left' | 'center' | 'right';
 }
@@ -43,6 +44,10 @@ export declare class CoDataTable {
     sortField: string;
     /** Current sort direction */
     sortOrder: 'asc' | 'desc' | '';
+    /** Fields with an active column filter (funnel filled + always visible). JSON string or array. */
+    filteredFields: string | string[];
+    /** Fields filtered by OTHER filter layers (funnel dimmed hint). JSON string or array. */
+    indirectFilteredFields: string | string[];
     /** Enable row selection with checkboxes */
     selectable: boolean;
     /** Keys of currently selected rows (JSON string or array) */
@@ -72,6 +77,18 @@ export declare class CoDataTable {
     coColumnPin: EventEmitter<{
         field: string;
     }>;
+    /** Emitted when a column's filter icon is clicked (rect = icon bounding box for anchoring). */
+    coHeaderFilter: EventEmitter<{
+        field: string;
+        rect: {
+            top: number;
+            left: number;
+            bottom: number;
+            right: number;
+            width: number;
+            height: number;
+        };
+    }>;
     /** Emitted when a row is double-clicked */
     coRowDblClick: EventEmitter<{
         row: any;
@@ -87,6 +104,8 @@ export declare class CoDataTable {
     parsedColumns: CoDataTableColumn[];
     parsedRows: any[];
     parsedSelectedKeys: Set<string>;
+    parsedFilteredFields: string[];
+    parsedIndirectFields: string[];
     columnWidths: Map<string, number>;
     resizingColumn: string | null;
     resizeStartX: number;
@@ -95,6 +114,8 @@ export declare class CoDataTable {
     parseColumns(): void;
     parseRows(): void;
     parseSelectedKeys(): void;
+    parseFilteredFields(): void;
+    parseIndirectFields(): void;
     componentWillLoad(): void;
     private handleSort;
     private isAllSelected;
@@ -105,6 +126,7 @@ export declare class CoDataTable {
     private handleRowClick;
     private handleRowDblClick;
     private handleColumnPin;
+    private handleColumnFilter;
     private formatCellValue;
     private getColumnStyle;
     private getColumnWidth;

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-input/co-input.d.ts

@@ -38,6 +38,12 @@ export declare class CoInput {
     name?: string;
     /** Whether the field is required */
     required: boolean;
+    /** Focus the inner input as soon as the component finishes hydrating.
+     *  Consumers can't reliably focus the shadow input themselves — Stencil's
+     *  lazy hydration replaces the shadow content AFTER mount, so an early
+     *  focus() lands on a node that gets thrown away. `componentDidLoad` runs
+     *  after hydration, which is exactly the right moment. */
+    autoFocus: boolean;
     /** Autocomplete hint for the browser */
     autocomplete?: string;
     /** Validation status */
@@ -71,6 +77,9 @@ export declare class CoInput {
     hasFocus: boolean;
     el: HTMLElement;
     private inputEl?;
+    /** Programmatically focus the inner input (post-hydration safe). */
+    setFocus(): Promise<void>;
+    componentDidLoad(): void;
     private handleInput;
     private handleChange;
     private handleFocus;

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

@@ -45,6 +45,10 @@ export declare class CoOptionList {
     /** 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[];

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-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,8 +8,8 @@ export declare class CoTab {
     selected: boolean;
     /** Size */
     size: 'large' | 'small';
-    /** Visual variant: filled pill (default) or underline tab */
-    variant: 'pill' | 'underline';
+    /** 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) */

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

@@ -4,13 +4,17 @@ export declare class CoTabGroup {
     /** Currently selected tab value */
     value?: string;
     /** Visual variant, propagated to slotted co-tab children */
-    variant: 'pill' | 'underline';
+    variant: 'pill' | 'underline' | 'segmented';
     /** Emitted when the active tab changes */
     coTabChange: EventEmitter<string>;
     onTabSelect(e: CustomEvent<string>): void;
     watchValue(): void;
     watchVariant(): void;
     componentDidLoad(): void;
+    /** Slotted tabs can mount AFTER the group (async v-for data): re-propagate
+        variant/selection whenever the slot content changes, or late tabs render
+        with the default pill variant. */
+    private onSlotChange;
     private syncTabs;
     render(): any;
 }