@cobre-npm/ds-v3 0.126.2 → 0.126.4

package/dist/types/components/atoms/CobreAvatar/CobreAvatar.vue.d.ts

@@ -1,5 +1,10 @@
 type sizeAvatarType = 'small' | 'medium' | 'large' | 'xs';
 type avatarType = 'empty' | 'disabled';
+/**
+ * CobreAvatar — a circular avatar showing short text (e.g. user initials).
+ * Use to represent a user or entity in lists, headers and menus. Exposes the
+ * `fullText` value as a tooltip on hover.
+ */
 interface Props {
     text?: string;
     fullText?: string;

package/dist/types/components/atoms/CobreBankLogo/CobreBankLogo.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreBankLogo — renders a bank or blockchain logo image from the static assets
+ * CDN, resolving the bank name as a tooltip. Use to display an institution logo
+ * inside lists, tables and detail views. Falls back to an UNKNOWN logo when the
+ * image fails to load.
+ */
 interface Props {
     idLogo: string;
     size: 'xs' | 'sm' | 'md' | 'lg' | 'auto';

package/dist/types/components/atoms/CobreButtonMenu/CobreButtonMenu.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreButtonMenu — a button styled for side-menu navigation entries.
+ * Use for menu items, nested sub-items and options inside CobreSideMenu.
+ * Renders its content through the `content` slot.
+ */
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     theme: {
         type: () => "item" | "subitem" | "option";

package/dist/types/components/atoms/CobreCardButton/CobreCardButton.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreCardButton — a selectable card with an icon, title and description.
+ * Use as a clickable option in choice lists (e.g. picking an account type or
+ * payment method) where each option needs an icon and supporting text.
+ */
 interface Props {
     iconClass: string;
     title: string;

package/dist/types/components/atoms/CobreColumnTable/CobreColumnTable.vue.d.ts

@@ -11,6 +11,13 @@ export interface TableItem {
     [key: string]: any;
     hovered?: boolean;
 }
+/**
+ * CobreColumnTable — a column-oriented table that renders each column as a
+ * vertical stack of cells. Use for tabular data where columns have configurable
+ * width, alignment, header info tooltips and per-column custom rendering.
+ * Each column key exposes a named slot receiving `{ data, index }` to override
+ * the default cell text.
+ */
 interface Props {
     displayedColumns: DisplayedColumn[];
     data: TableItem[];

package/dist/types/components/atoms/CobreCountryFlag/CobreCountryFlag.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreCountryFlag — renders a country flag image (SVG) from the static assets
+ * CDN. Use to display a country/region indicator next to currencies, phone
+ * inputs or location fields.
+ */
 interface Props {
     geo: string;
     width?: number;

package/dist/types/components/atoms/CobreDetailRow/CobreDetailRow.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreDetailRow — a label/value row for detail or summary views, with the label
+ * on the left and the value on the right. Use to list key/value pairs (e.g.
+ * reference, status, amount). Provides `label` and `value` slots to override the
+ * plain-text defaults with custom content.
+ */
 interface Props {
     label?: string;
     value?: string;

package/dist/types/components/atoms/CobreEmptyResults/CobreEmptyResults.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreEmptyResults — empty-state placeholder shown when a list, table, or search
+ * returns no data. Renders an illustration, a title, and an optional description.
+ * Use inside containers that may have no content; pick the `icon` that matches the
+ * context and `size: 'sm'` for compact areas.
+ */
 interface Props {
     title: string;
     description: string;

package/dist/types/components/atoms/CobreHeadline/CobreHeadline.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreHeadline — section title displayed as a single line of heading text.
+ * Use to label a section or content block. For body or label text use a different
+ * component such as CobreInputLabel or plain typography.
+ */
 interface Props {
     title: string;
 }

package/dist/types/components/atoms/CobreIndicative/CobreIndicative.vue.d.ts

@@ -1,9 +1,16 @@
+/** A selectable country dialing code option for CobreIndicative. */
 export interface Indicative {
     code: string;
     geo?: string;
     country?: string;
     isoCode?: string;
 }
+/**
+ * CobreIndicative — dropdown selector for a country dialing code (phone indicative),
+ * typically used as a prefix alongside a phone-number input. Renders the country flag
+ * and dialing code, and emits the selected code via `update:modelValue` (v-model).
+ * Provides `open-indicator`, `selected-option`, and `option` slots to customize rendering.
+ */
 interface Props {
     modelValue?: string;
     placeholder?: string;

package/dist/types/components/atoms/CobreInfoDetail/CobreInfoDetail.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreInfoDetail — a labeled detail field showing a title and its value, used in
+ * summaries and detail panels. Renders a skeleton while loading and a placeholder
+ * ('-') when there is no content. Use the `contentComponent` slot to render a custom
+ * value instead of plain text.
+ */
 interface Props {
     title?: string;
     contentClass?: string;

package/dist/types/components/atoms/CobreInputLabel/CobreInputLabel.vue.d.ts

@@ -1,3 +1,7 @@
+/**
+ * CobreInputLabel — the text label rendered above or beside form inputs.
+ * Use to caption a field; pass `isDisabled` to dim it when the associated input is disabled.
+ */
 interface Props {
     label?: string;
     isDisabled?: boolean;

package/dist/types/components/atoms/CobreOptionsSwitch/CobreOptionsSwitch.vue.d.ts

@@ -1,3 +1,4 @@
+/** A single selectable option in a CobreOptionsSwitch. */
 interface Option {
     id: number;
     name: string;
@@ -6,6 +7,11 @@ interface Option {
     disabled?: boolean;
     tooltipText?: string;
 }
+/**
+ * CobreOptionsSwitch — a segmented toggle that lets the user pick one option from a
+ * small set, with an animated highlight. Emits `change` with the selected option.
+ * Provide `option-{id}` slots to render content panels for each option when selected.
+ */
 interface Props {
     /** List of options - since 0.11.0 */
     options: Option[];

package/dist/types/components/atoms/CobrePager/CobrePager.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobrePager — compact pagination control showing the current item range and page,
+ * with previous/next buttons. Emits `previousPage` and `nextPage`; the parent owns
+ * page state. Use above or below paginated lists and tables.
+ */
 interface Props {
     totalPages?: number;
     currentPage: number;

package/dist/types/components/atoms/CobreRadio/CobreRadio.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreRadio — a single radio-button option with optional label and description.
+ * Use within a radio group (same `name`, shared `v-model`) to select one value.
+ * `type="box"` renders the option as a bordered, selectable card.
+ * Provides a `content` slot rendered before the label (e.g. for an icon).
+ */
 interface Props {
     value: string | number | string[];
     modelValue?: string | boolean;

package/dist/types/components/atoms/CobreRowActions/CobreRowActions.vue.d.ts

@@ -1,4 +1,10 @@
 import { RowAction } from './interfaces/CobreRowActions.interface';
+/**
+ * CobreRowActions — a compact toolbar of icon/label action buttons for a table row.
+ * Use to expose per-row operations (copy, download, delete...) that appear on hover.
+ * Each action is configured via the `actions` array (icon, tooltip, onClick/eventName,
+ * conditional show/loading). Emits `action` with the action's eventName when clicked.
+ */
 type __VLS_Props = {
     actions: RowAction[];
     visible: boolean;

package/dist/types/components/atoms/CobreRowActions/interfaces/CobreRowActions.interface.d.ts

@@ -1,12 +1,20 @@
+/** A single action button rendered by CobreRowActions for a table row, generic over the row's data type T. */
 export interface RowAction<T = unknown> {
     id: string;
     label?: string;
     icon: string;
+    /** Tooltip text shown on hover. */
     tooltipText?: string;
+    /** Handler invoked with the row's data when the action is clicked. */
     onClick?: (rowData: T) => void | undefined | Promise<void>;
+    /** Name of the event emitted instead of (or alongside) calling onClick. */
     eventName?: string;
+    /** Whether to show visual feedback after the action runs. */
     feedback?: boolean;
+    /** Visual style of the action. */
     type?: 'default' | 'info';
+    /** Whether the action is visible; can be a predicate evaluated against the row's data. */
     show?: boolean | ((rowData: T) => boolean);
+    /** Whether the action shows a loading state; can be a predicate evaluated against the row's data. */
     isLoading?: boolean | ((rowData: T) => boolean);
 }

package/dist/types/components/atoms/CobreSegmentedTabs/CobreSegmentedTabs.vue.d.ts

@@ -3,6 +3,12 @@ interface Option {
     label?: string;
     icon?: string;
 }
+/**
+ * CobreSegmentedTabs — a compact segmented control for picking one of a few options.
+ * Use for mutually exclusive choices (filters, view toggles) shown inline as joined pills.
+ * Each option renders its `icon` when provided, otherwise its `label`.
+ * Two-way bound via v-model; emits update:modelValue with the chosen option's value.
+ */
 interface Props {
     modelValue?: string;
     options: Option[];

package/dist/types/components/atoms/CobreSwitch/CobreSwitch.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreSwitch — a toggle switch for on/off (boolean) settings.
+ * Use to enable/disable a single option; for a labelled multi-radio choice use CobreRadio.
+ * Two-way bound via v-model; emits update:modelValue with the checked state and `changed`.
+ * Optional `label` and `description` render text beside the toggle.
+ */
 interface Props {
     modelValue: any;
     disabled?: boolean;

package/dist/types/components/atoms/CobreTabMenu/CobreTabMenu.vue.d.ts

@@ -7,6 +7,12 @@ interface Tab {
     icon?: string;
 }
 type Direction = 'row' | 'column';
+/**
+ * CobreTabMenu — a horizontal or vertical tab navigation bar.
+ * Use to switch between sections; each tab can show an icon, a count badge, and a tooltip.
+ * Two-way bound via v-model with the active Tab object; emits update:modelValue on select.
+ * Exposes `resetActiveTab` and `setActiveTab`. Initial tab can come from the URL `status` param.
+ */
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     tabs: {
         type: () => Tab[];

package/dist/types/components/atoms/CobreTabMenuV2/CobreTabMenu.vue.d.ts

@@ -8,6 +8,12 @@ interface Tab {
 }
 type Direction = 'row' | 'column';
 type Size = 'sm' | 'md';
+/**
+ * CobreTabMenu (V2) — a horizontal or vertical tab navigation bar.
+ * Use to switch between sections; each tab can show an icon, a count badge, and a tooltip.
+ * Two-way bound via v-model with the active Tab object; emits update:modelValue and `select`.
+ * Active tab is derived from modelValue (falls back to the first tab). Supports a `sm` size.
+ */
 type __VLS_Props = {
     tabs: Tab[];
     modelValue?: Tab;

package/dist/types/components/atoms/CobreTruncateTooltipText/CobreTruncateTooltipText.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreTruncateTooltipText — single-line text that truncates with an ellipsis and
+ * shows the full text in a tooltip only when it actually overflows its container.
+ * Use for table cells or tight layouts where long values must stay on one line.
+ */
 interface Props {
     text?: string;
 }

package/dist/types/components/atoms/CobreUploader/CobreUploader.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreUploader — a single-file drag-and-drop / browse upload area.
+ * Use to let the user pick or drop one file; once chosen it shows the file name,
+ * size, a type icon (csv/json/txt/xlsx) and a delete button.
+ * Emits `files-dropped`, `files-input`, and `deleted-file`; exposes `resetInputFile`.
+ */
 interface Props {
     currentFileType?: any;
     allowedExtensions?: string[];

package/dist/types/components/atoms/CobreWidgetState/CobreWidgetState.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreWidgetState — a compact, centered placeholder for a widget's non-data state.
+ * Use inside small cards/widgets to show a warning, error, or info message with an
+ * icon, title, and optional description (e.g. "no data", "failed to load").
+ */
 interface Props {
     variant: "warning" | "error" | "info";
     icon: string;

package/dist/types/components/molecules/CobreAccountCpButton/CobreAccountCpButton.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreAccountCpButton — compact chip-style button representing an account or counterparty.
+ * Use to show a selectable account/counterparty with its logo, alias, and masked account number.
+ * The leading icon is derived from `id`: ids starting with `acc` show a wallet/bank logo,
+ * otherwise a counterparty (users) icon. Emits `click` with the `id` when pressed.
+ */
 interface Props {
     id: string;
     alias: string;

package/dist/types/components/molecules/CobreAccountCpLogo/CobreAccountCpLogo.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreAccountCpLogo — renders the logo/icon for an account or counterparty.
+ * Use inside lists, selects, and chips to show a bank logo or a generic icon.
+ * When `logo` starts with `PR` it renders a CobreBankLogo; otherwise `logo` is
+ * treated as an icon class name and rendered as an `<i>`.
+ */
 interface Props {
     logo: string;
     size?: 'xs' | 'sm' | 'md' | 'lg';

package/dist/types/components/molecules/CobreAccountInfoFiled/CobreAccountInfoField.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreAccountInfoField — displays an account number with optional unmask, copy, and edit actions.
+ * Use to show a (masked by default) account value alongside reveal/copy/edit icon buttons that
+ * appear on hover. Emits `copy` and `edit` with the account value when those actions are used.
+ */
 interface Props {
     account?: string;
     isEnabledUnmask?: boolean;

package/dist/types/components/molecules/CobreAccountOptionSelect/CobreAccountOptionSelect.vue.d.ts

@@ -14,6 +14,12 @@ export interface CobreSelectableItem {
     isDisabled?: boolean;
     tooltipText?: string;
 }
+/**
+ * CobreAccountOptionSelect — a single selectable row showing an entity's logo, title,
+ * subtitle, optional currency label, and a badge. Use as an option inside account or
+ * counterparty selects/dropdowns. An optional `tooltipText` adds a hover tooltip.
+ * Accepts any `CobreSelectableItem`, not just accounts or counterparties.
+ */
 interface Props {
     account: CobreSelectableItem;
 }

package/dist/types/components/molecules/CobreActionList/CobreActionList.vue.d.ts

@@ -12,6 +12,12 @@ export interface Option {
     theme?: 'error';
     key?: string;
 }
+/**
+ * CobreActionList — a panel listing clickable action items, each with an optional icon,
+ * inline action, divider, or custom slot content. Use for contextual menus, help panels,
+ * and option lists. Supports `header` and `footer` slots plus per-option named slots.
+ * Emits `clickOption` with the selected option and `close` when the close button is pressed.
+ */
 interface Props {
     options: Array<Option>;
     hasCloseButton?: boolean;

package/dist/types/components/molecules/CobreAvatarsGroup/CobreAvatarsGroup.vue.d.ts

@@ -1,4 +1,10 @@
 type sizeAvatarType = 'small' | 'medium' | 'large';
+/**
+ * CobreAvatarsGroup — renders a row of overlapping avatars, one per email.
+ * Use to show a set of people (e.g. participants) compactly. Each avatar shows the
+ * email's first letter; empty strings render an 'empty' placeholder avatar, and an
+ * empty list renders a single 'disabled' avatar.
+ */
 type __VLS_Props = {
     emailsList: string[];
     size: sizeAvatarType;

package/dist/types/components/molecules/CobreBalanceCard/CobreBalanceCard.vue.d.ts

@@ -6,6 +6,11 @@ export interface BalanceCardItem {
     name: string;
     isStable: boolean;
 }
+/**
+ * CobreBalanceCard — a draggable card showing a currency balance with its flag, label, and name.
+ * Use in balance overviews/dashboards to display one currency's amount. Renders a skeleton
+ * placeholder while `isLoading` is true. Stable coins (item.isStable) use a wider flag treatment.
+ */
 interface Props {
     item?: BalanceCardItem;
     isLoading?: boolean;

package/dist/types/components/molecules/CobreCardIcon/CobreCardIcon.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreCardIcon — a selectable, icon-led card used as a radio-style option.
+ * Use within a group where each card represents one choice; clicking emits
+ * `update:modelValue` with the card's value and the matching card renders active.
+ * Renders an `icon` slot or, when `geo` is set, a country flag beside the label.
+ */
 interface Props {
     label: string;
     cardValue: string | number;

package/dist/types/components/molecules/CobreCopyTextBox/CobreCopyTextBox.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreCopyTextBox — a pill that displays a text value with a copy button.
+ * Use to surface a short, copyable value (id, code, account number); clicking
+ * the button emits `copy` with the text. Shows a skeleton while `isLoading`,
+ * a dash when empty, and a check icon when the value matches `copied`.
+ */
 interface Props {
     text: string;
     isLoading?: boolean;

package/dist/types/components/molecules/CobreEntityIdCopyButton/CobreEntityIdCopyButton.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreEntityIdCopyButton — shows an entity id in monospace with a copy button.
+ * Use to display a copyable identifier inline; clicking the button emits `copy`
+ * with the id. Shows a skeleton placeholder while `isLoading`, and a check icon
+ * when the id matches `copied`.
+ */
 interface Props {
     id: string;
     isLoading?: boolean;

package/dist/types/components/molecules/CobreFieldLogo/CobreFieldLogo.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreFieldLogo — a bank logo paired with a label in a single inline row.
+ * Use to display a bank/account identifier alongside its logo (e.g. account fields).
+ * Provides an `end` slot for trailing content such as a masked account number.
+ */
 interface Props {
     label: string;
     idLogo: string;

package/dist/types/components/molecules/CobreFlowResult/CobreFlowResult.vue.d.ts

@@ -1,5 +1,11 @@
 import { ButtonThemes } from '../../../types/button.types';
 import { IconTypeV3 } from '../../../types/icon.types';
+/**
+ * CobreFlowResult — a centered result/status screen with icon, title, body and actions.
+ * Use at the end of a flow to show success/error/info/warning/otp outcomes with up to
+ * two action buttons and an optional close button. Provides a `content` slot for custom
+ * body content between the subtitle and the action footer.
+ */
 interface Props {
     title?: string;
     subtitle?: string;

package/dist/types/components/molecules/CobreFormOtp/CobreFormOtp.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreFormOtp — a 6-digit OTP entry form built on top of CobreFlowResult.
+ * Use to collect a one-time code; emits `onComplete` when all 6 digits are filled,
+ * `submit` with the value on confirm, and `cancel` on the secondary button. Exposes
+ * `clearInput()` to reset the fields. Provides a `bottom` slot below the OTP inputs.
+ */
 interface Props {
     title: string;
     description: string;

package/dist/types/components/molecules/CobreInputAmount/CobreInputAmount.vue.d.ts

@@ -1,4 +1,10 @@
 import { CurrencyInputOptions } from 'vue-currency-input';
+/**
+ * CobreInputAmount — a formatted money/amount input built on vue-currency-input.
+ * Use for entering monetary amounts with grouping separators and a leading dollar
+ * icon; validates the value against min/max and required rules and shows an inline
+ * error. For amounts that also need a currency selector, use CobreInputCurrency.
+ */
 interface Props {
     modelValue: string | number | undefined;
     placeholder: string;

package/dist/types/components/molecules/CobreInputCurrency/CobreInputCurrency.vue.d.ts

@@ -4,6 +4,12 @@ interface Currency {
     label: string;
     geo: string;
 }
+/**
+ * CobreInputCurrency — a formatted amount input (vue-currency-input) paired with a
+ * currency selector (CobreSelect showing a country flag per option). Use when the
+ * user must enter both an amount and pick its currency; for an amount-only field
+ * use CobreInputAmount. Emits update:amount and update:currency on changes.
+ */
 interface Props {
     modelValue: string | number | undefined;
     errorMsg?: string;

package/dist/types/components/molecules/CobreInputDatePicker/CobreInputDatePicker.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreInputDatePicker — a date (or date-range) field built on @vuepic/vue-datepicker.
+ * Use for picking a single date or a start/end range; time picking is disabled and
+ * selection auto-applies. Renders an optional label, tooltip and inline error, and
+ * validates that required (and both range) dates are filled.
+ */
 type __VLS_Props = {
     label: string;
     isRequired?: boolean;

package/dist/types/components/molecules/CobreInputPhoneNumber/CobreInputPhoneNumber.vue.d.ts

@@ -1,4 +1,10 @@
 import { Indicative } from '@/components/atoms/CobreIndicative/CobreIndicative.vue';
+/**
+ * CobreInputPhoneNumber — a phone number field with a leading country indicative
+ * (dial-code) selector (CobreIndicative). Use to capture phone numbers; input is
+ * numeric-only and validated against min/max length. Emits update:modelValue with
+ * an object of `{ number, indicativeValue }` whenever either part changes.
+ */
 interface Props {
     modelValue: string | undefined | null;
     indicativeModelValue?: string;

package/dist/types/components/molecules/CobreInputUrl/CobreInputUrl.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreInputUrl — a URL field with a fixed "https://" prefix shown inside the input.
+ * Use to capture web addresses; the stored model value always keeps the "https://"
+ * prefix while the user types only the rest. Validates URL shape plus min/max length
+ * and shows an inline error or info message.
+ */
 interface Props {
     modelValue: string | undefined | null;
     errorMsg?: string;

package/dist/types/components/molecules/CobreKebabMenu/CobreKebabMenu.vue.d.ts

@@ -1,3 +1,4 @@
+/** A single entry in the kebab menu's dropdown (rendered via CobreActionList). */
 export interface Option {
     id: string;
     icon?: string;
@@ -6,6 +7,11 @@ export interface Option {
     lineBottom?: boolean;
     disabled?: boolean;
 }
+/**
+ * CobreKebabMenu — a vertical "more" (three-dots) icon button that opens a dropdown
+ * of actions. Use for row- or card-level overflow actions. Renders a CobreButton
+ * trigger and a CobreActionList of options; emits clickOption with the chosen Option.
+ */
 interface Props {
     options: Option[];
 }

package/dist/types/components/molecules/CobreLogoField/CobreLogoField.vue.d.ts

@@ -1,3 +1,8 @@
+/**
+ * CobreLogoField — a bank logo (CobreBankLogo) paired with a text label in a row.
+ * Use to display a bank/entity alongside its name, e.g. in lists or selected values.
+ * Provides an `end` slot for trailing content (icon, action) after the label.
+ */
 interface Props {
     label: string;
     idLogo: string;

package/dist/types/components/molecules/CobreModalAction/CobreModalAction.vue.d.ts

@@ -1,5 +1,11 @@
 import { IconTypeV3 } from '../../../types/icon.types';
 import { ButtonThemes } from '../../../types/button.types';
+/**
+ * CobreModalAction — a confirmation/result modal built on CobreModal + CobreFlowResult.
+ * Use for action dialogs that present a title, description, an icon and one or two
+ * action buttons (primary/secondary). Open/close it via the exposed `toggleModal`.
+ * Emits `clickPrimary`, `clickSecondary` and `close`.
+ */
 interface Props {
     title: string;
     description: string;

package/dist/types/components/molecules/CobreMultiOptionsFilter/CobreMultiOptionsFilter.vue.d.ts

@@ -1,4 +1,11 @@
 type Option = Record<string, any>;
+/**
+ * CobreMultiOptionsFilter — a dropdown chip that lets users pick multiple options.
+ * Renders a CobreChips trigger; opening it shows a checkbox list of `options`.
+ * The chip text summarises the selection (truncating with a "+N more" style label).
+ * Use inside toolbars/tables for multi-select filtering. Emits `clean` when cleared;
+ * the selected values are exposed via v-model. Provides an `option` slot per row.
+ */
 interface Props {
     options?: Option[];
     filterLabel?: string;

package/dist/types/components/molecules/CobreRowTable/CobreRowTable.vue.d.ts

@@ -1,5 +1,6 @@
 import { Option } from '../CobreKebabMenu/CobreKebabMenu.vue';
 import { RowAction } from '../../atoms/CobreRowActions/interfaces/CobreRowActions.interface';
+/** Definition of a single table column for CobreRowTable. */
 export interface Column {
     key: string;
     width: number;
@@ -9,10 +10,19 @@ export interface Column {
     class?: string;
     style?: string;
 }
+/** A table data row: arbitrary key/value record keyed by column. */
 export interface Item {
     [key: string]: any;
     hovered?: boolean;
 }
+/**
+ * CobreRowTable — a flexible row-based table for listing data with optional
+ * selection, navigation, kebab menus, row actions and per-column slots.
+ * Use to render tabular data where each column maps to a key in `data`; provide a
+ * named slot per column key for custom cell rendering. Shows skeletons while loading
+ * and an empty-results state when there is no data. Emits `selectItem`,
+ * `clickKebabOption` and `action`; selected rows are exposed via v-model:selectedRows.
+ */
 interface Props {
     displayedColumns: Column[];
     data: Item[];

package/dist/types/components/molecules/CobreSelectTags/CobreSelectTags.vue.d.ts

@@ -1,4 +1,11 @@
 import 'vue-select/dist/vue-select.css';
+/**
+ * CobreSelectTags — a multi-select built on vue-select that renders selections as
+ * removable tags. Use when users pick several options shown as chips inside the field.
+ * The search input is sanitised to allow only letters, numbers and `- _ @`.
+ * Forwards vue-select attrs and exposes `option`, `open-indicator`, `no-options`,
+ * `no-results`, `list-header`, `list-footer` and `spinner` slots.
+ */
 interface Props {
     labelName?: string;
     isRequired?: boolean;

package/dist/types/components/molecules/CobreTableCellCopy/CobreTableCellCopy.vue.d.ts

@@ -1,3 +1,9 @@
+/**
+ * CobreTableCellCopy — a truncating table cell with a hover copy button and tooltip.
+ * Use inside table cells to show text that truncates with ellipsis, reveals a copy
+ * button on hover, and shows the full value in a tooltip when it exceeds a threshold.
+ * Emits `copy` with the value to copy; provides a `content` slot after the text.
+ */
 interface Props {
     text?: string;
     allowCopy?: boolean;

package/dist/types/components/molecules/CobreTourTooltip/CobreTourTooltip.vue.d.ts

@@ -1,3 +1,4 @@
+/** A single step in a CobreTourTooltip guided tour. */
 export interface TourStep {
     title: string;
     description: string;
@@ -6,6 +7,12 @@ export interface TourStep {
     arrowSide?: 'right' | 'left' | 'top' | 'bottom';
     offsetY?: number;
 }
+/**
+ * CobreTourTooltip — a guided onboarding tour that spotlights elements with a blurred
+ * overlay and shows a positioned card with prev/next/finish controls per step.
+ * Use to walk users through a feature; auto-dismisses when the target leaves the
+ * viewport. Emits `navigate`, `dismiss` and `finish`.
+ */
 interface Props {
     steps: TourStep[];
     prevLabel?: string;