@cobre-npm/ds-v3 0.126.0 → 0.126.2

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

@@ -1,4 +1,10 @@
 type IconType = "danger" | "success" | "warning" | "info" | null;
+/**
+ * CobreAlert — inline alert banner that surfaces a contextual status message.
+ * Use to highlight success, error, warning, or info states within page content.
+ * Optionally shows a close button (emits `close`) and a `contentComponent` slot
+ * for extra content below the message.
+ */
 interface Props {
     type?: IconType;
     content?: string;

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

@@ -1,5 +1,11 @@
 import { ButtonThemes, ButtonColors } from '../../../types/button.types';
 type Sizes = 'big' | 'medium' | 'small' | 'auto';
+/**
+ * CobreButton — the primary action button for the Cobre platform.
+ * Use for form submits, primary/secondary actions, toolbar actions, and icon-only
+ * buttons. For navigation that looks like inline text, use the `link` theme.
+ * Provides `start`, `end`, and `content` slots for icons or custom content.
+ */
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     theme: {
         type: () => ButtonThemes;

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

@@ -1,3 +1,8 @@
+/**
+ * CobreCheckbox — a single checkbox with optional label, helper description and tooltip.
+ * Use for boolean toggles in forms; binds via v-model and also emits 'changed'.
+ * Provides an `option` slot rendered after the label (e.g. an extra icon or control).
+ */
 interface Props {
     modelValue: any;
     disabled?: boolean;

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

@@ -1,3 +1,9 @@
+/**
+ * CobreEmptyState — a placeholder panel for empty or zero-data screens.
+ * Use to fill a section that has no content yet, pairing a descriptive message
+ * with an illustration on a subtle tinted background. Provides a `content` slot
+ * for the heading/text shown beside the image.
+ */
 type __VLS_Props = {
     image: string;
 };

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

@@ -1,4 +1,10 @@
 type IconType = 'danger' | 'success' | 'warning' | 'info' | null;
+/**
+ * CobreToastAlert — a self-contained toast-style status notification.
+ * Use to display a transient success, error, warning, or info message with an
+ * icon, title, and content. For an inline page banner with a close button, use
+ * CobreAlert instead.
+ */
 interface Props {
     type: IconType;
     content: string;

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

@@ -1,3 +1,8 @@
+/**
+ * CobreBadge — a compact pill for statuses, labels and filter chips.
+ * Use to surface state (success/error/warning/status-*), tags, or removable filters.
+ * Provides `start`, `content` and `end` slots; `content` replaces the default `text`.
+ */
 interface Props {
     type: string;
     isSelected?: boolean;

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

@@ -1,3 +1,8 @@
+/**
+ * CobreChips — a filter chip built on CobreButton's `filter` theme.
+ * Use to display an applied or selectable filter; shows a leading plus, icon, or a
+ * removable divider/close button that emits 'close' when a filter value is set.
+ */
 interface Props {
     label?: string;
     filterText?: string;

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

@@ -1,4 +1,12 @@
 type Positions = 'left' | 'right';
+/**
+ * CobreDrawer — a side panel that slides in from the left or right edge of the screen.
+ * Use for secondary flows, filters, or detail views that overlay the page without
+ * fully blocking it. Open/close via the exposed `toggleModal` ref; closes on Escape
+ * and (optionally) on outside click. Emits `close` (auto/outside) and `close-button`
+ * (close icon). Provides `content`, `footer`, and `onlyWrapper` slots.
+ * For a centered modal dialog, use CobreModal instead.
+ */
 interface Props {
     id?: string;
     position: Positions;

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

@@ -2,6 +2,13 @@ interface Option {
     text: string;
     id: string;
 }
+/**
+ * CobreDropdownButton — a split button that pairs a primary action with a
+ * chevron toggle that opens a dropdown action list.
+ * Use when a button has one main action plus a menu of related options.
+ * Emits `button-click` for the primary action and `clickOption` for menu selections.
+ * Provides a `content` slot to customize the primary button's label area.
+ */
 interface Props {
     actionListOptions: Array<Option>;
     label?: string;

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

@@ -1,3 +1,9 @@
+/**
+ * CobreInput — the standard single-line text field for the Cobre platform.
+ * Use for form text entry with built-in validation (length, numeric, letters,
+ * alphanumeric, email) and inline error/info messaging. Set `isSearchable` to
+ * render the compact search variant. For multi-line input use CobreTextArea.
+ */
 interface Props {
     modelValue: string | undefined | null;
     errorMsg?: string;

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

@@ -1,3 +1,10 @@
+/**
+ * CobreModal — a centered overlay dialog rendered over a dimmed backdrop.
+ * Use for focused interactions (confirmations, forms, details) that block the
+ * page until dismissed. Open/close via the exposed `toggleModal` ref; emits
+ * `close` when the close button is pressed. Provides a `content` slot.
+ * For a side panel that slides in from an edge, use CobreDrawer instead.
+ */
 interface Props {
     size?: 'xs' | 'md' | 'lg';
     hasCloseButton?: boolean;

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

@@ -1,4 +1,12 @@
 import 'vue-select/dist/vue-select.css';
+/**
+ * CobreSelect — the platform dropdown select, built on vue-select.
+ * Use for choosing from a list of options, with optional search, custom option
+ * rendering (bank logos, country flags, balances, badges) and a no-options state.
+ * Forwards extra vue-select props via attrs. Provides `option`, `selected-option`,
+ * `open-indicator`, `no-options`, `no-results`, `deselect`, `list-header`,
+ * `list-footer`, and `spinner` slots for full customization.
+ */
 interface Props {
     labelName?: string;
     isRequired?: boolean;

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

@@ -1,3 +1,8 @@
+/**
+ * CobreSnackBar — a compact single-line snackbar for brief, transient feedback.
+ * Use for confirmations or errors, optionally with an inline action button and a
+ * close button. For a richer banner with a title, use CobreAlert/CobreToastAlert.
+ */
 interface Props {
     closeToast: (e?: MouseEvent) => void;
     message: string;

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

@@ -1,3 +1,9 @@
+/**
+ * CobreTextArea — the standard multi-line text field for the Cobre platform.
+ * Use for longer free-form input with built-in length validation and inline
+ * error/info messaging. The height is configurable via `height`. For single-line
+ * input use CobreInput.
+ */
 interface Props {
     modelValue: string | undefined | null;
     id?: string;

package/dist/types/components/organisms/CobreAccountPickerModal/CobreAccountPickerModal.vue.d.ts

@@ -2,6 +2,13 @@ import { type CobreSelectableItem } from '../../molecules/CobreAccountOptionSele
 import type { AlertConfig, FilterConfig, TabConfigItem } from './interfaces/account-selector-modal.interface';
 export type { AlertType, AlertConfig, TabConfigItem, FilterOptionItem, FilterConfig } from './interfaces/account-selector-modal.interface';
 type AccountItem = CobreSelectableItem;
+/**
+ * CobreAccountPickerModal — a modal for searching and selecting an account or
+ * counterparty, with optional search, tabs, multi-option filters, and a balance
+ * visibility toggle. Use when the user must pick one account from a list.
+ * Open/close it via the exposed `toggleModal()`; emits `select` on choice.
+ * Provides a `custom-actions` slot for extra controls below the filters.
+ */
 interface Props {
     title: string;
     searchPlaceholder: string;

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@cobre-npm/ds-v3",
-  "version": "0.126.0",
+  "version": "0.126.2",
   "type": "module",
+  "packageManager": "pnpm@11.0.4",
+  "engines": {
+    "node": ">=20"
+  },
   "files": [
     "dist"
   ],