@prolibu-suite/cobalt-core 0.5.0 → 0.7.0

package/dist/types/components.d.ts

@@ -183,6 +183,10 @@ export namespace Components {
           * @default 'regular'
          */
         "iconWeight": 'regular' | 'thin' | 'light' | 'bold' | 'fill' | 'duotone';
+        /**
+          * Full name / tooltip content. When set (non-empty), the avatar renders wrapped in a `co-tooltip` showing this text on hover/focus — every consumer gets the tooltip for free instead of having to wire it up externally. When unset, renders exactly as before (no wrapper).
+         */
+        "name"?: string;
         /**
           * Optional 2px ring color (hex/CSS). Drives the inset ::after ring.
          */
@@ -587,6 +591,74 @@ export namespace Components {
          */
         "variant": 'elevated' | 'outlined' | 'flat';
     }
+    /**
+     * A generic slide carousel. Coordinates light-DOM `co-carousel-item`
+     * children (same pattern as co-tab-group): the parent stamps aria and
+     * inertness on each item and translates a flex track to the active index.
+     * No v-model in the Vue wrappers — consume with `:value` + `@coSlideChange`.
+     */
+    interface CoCarousel {
+        /**
+          * Show prev/next arrows
+          * @default true
+         */
+        "arrows": boolean;
+        /**
+          * Container aspect ratio
+          * @default 'auto'
+         */
+        "aspectRatio": '16:9' | '4:3' | '1:1' | '21:9' | 'auto';
+        /**
+          * Auto-advance slides
+          * @default false
+         */
+        "autoplay": boolean;
+        /**
+          * Show dot indicators
+          * @default true
+         */
+        "dots": boolean;
+        "goTo": (index: number) => Promise<void>;
+        /**
+          * Autoplay interval in milliseconds (floored at 1000)
+          * @default 6000
+         */
+        "interval": number;
+        /**
+          * Language for aria labels (es/en/pt, accepts full locales)
+          * @default 'es'
+         */
+        "locale": string;
+        /**
+          * Wrap around at the ends
+          * @default true
+         */
+        "loop": boolean;
+        "next": () => Promise<void>;
+        /**
+          * Pause autoplay while hovered
+          * @default true
+         */
+        "pauseOnHover": boolean;
+        "prev": () => Promise<void>;
+        /**
+          * Enable pointer swipe navigation
+          * @default true
+         */
+        "swipe": boolean;
+        /**
+          * Active slide index
+          * @default 0
+         */
+        "value": number;
+    }
+    /**
+     * A single slide inside a co-carousel. The parent carousel stamps
+     * aria-label / aria-hidden / inert on each item (same light-DOM
+     * coordination pattern as co-tab-group ↔ co-tab).
+     */
+    interface CoCarouselItem {
+    }
     interface CoCheckbox {
         /**
           * Visual appearance: - 'default' — the standard labeled form checkbox (unchanged). - 'overlay' — a standalone frosted rounded selection chip (Drive), no label, bespoke SVG glyphs.
@@ -1381,6 +1453,11 @@ export namespace Components {
           * @default null
          */
         "value": string | null;
+        /**
+          * Visual style. `flat` strips the inner co-date-field's border and background so it reads as plain content instead of a boxed control — padding, label, focus ring, disabled and invalid states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed. co-date-field itself has no `variant` prop, so this is applied from the outside via `::part(field)` — see co-date-picker.css.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     /**
      * @deprecated Use `<co-date-range-picker>` instead.
@@ -1535,6 +1612,11 @@ export namespace Components {
           * @default ''
          */
         "value": string;
+        /**
+          * 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 invalid states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     interface CoDrawer {
         /**
@@ -1798,6 +1880,11 @@ export namespace Components {
           * @default false
          */
         "disabled": boolean;
+        /**
+          * With `label`: icon-only circle at rest that stretches into the extended pill on hover/focus-visible (springy "liquid" morph).
+          * @default false
+         */
+        "expandOnHover": boolean;
         /**
           * @default 'plus'
          */
@@ -2017,6 +2104,11 @@ export namespace Components {
           * Label for the integrated action button (Botón variant)
          */
         "actionLabel"?: string;
+        /**
+          * 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.
+          * @default false
+         */
+        "autoFocus": boolean;
         /**
           * Autocomplete hint for the browser
          */
@@ -2080,6 +2172,10 @@ export namespace Components {
           * Secondary label displayed on the right side
          */
         "secondaryLabel"?: string;
+        /**
+          * Programmatically focus the inner input (post-hydration safe).
+         */
+        "setFocus": () => Promise<void>;
         /**
           * 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).
           * @default 'md'
@@ -2100,6 +2196,11 @@ export namespace Components {
           * @default ''
          */
         "value": string;
+        /**
+          * Visual style. `flat` strips the field's border and background so it reads as plain content instead of a boxed input — padding, label, focus ring, disabled and status states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     /**
      * Multiline JSON / arbitrary-object editor — a `<textarea>` with inline JSON
@@ -3070,6 +3171,11 @@ export namespace Components {
           * @default ''
          */
         "value": string;
+        /**
+          * 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.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     /**
      * Rich text editor backed by Tiptap v3.
@@ -3082,6 +3188,15 @@ export namespace Components {
           * Account/imported fonts shown in a separate "Imported fonts" section. JS property: `Array<{ label: string; value: string }>`. HTML attribute: JSON string of the same array.
          */
         "accountFonts"?: string | { label: string; value: string }[];
+        /**
+          * Passthrough: `accept` for the toolbar attachment picker.
+         */
+        "attachmentAccept"?: string;
+        /**
+          * Passthrough: shows the toolbar attachment button (host owns the files).
+          * @default false
+         */
+        "attachmentsEnabled": boolean;
         /**
           * @default false
          */
@@ -3165,6 +3280,11 @@ export namespace Components {
           * @default null
          */
         "value": string | null;
+        /**
+          * Visual style. `flat` strips the frame'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. The toolbar keeps its own background + bottom border (a subtle, token-driven separator), which is what keeps toolbar and editable area legible/separated once the outer box is gone. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     /**
      * Formatting toolbar for co-rich-text-editor. Receives the Tiptap editor
@@ -3173,6 +3293,15 @@ export namespace Components {
      * color palette pickers.
      */
     interface CoRichTextToolbar {
+        /**
+          * `accept` attr for the attachment file picker (e.g. '.pdf,.png').
+         */
+        "attachmentAccept"?: string;
+        /**
+          * Shows the attachment button (compact-assets variant). The editor never owns the attachment list — it only emits the picked files.
+          * @default false
+         */
+        "attachmentsEnabled": boolean;
         /**
           * @default false
          */
@@ -3194,7 +3323,7 @@ export namespace Components {
           * Toolbar layout variant.
           * @default 'basic'
          */
-        "variant": 'none' | 'compact' | 'basic' | 'full';
+        "variant": 'none' | 'compact' | 'compact-assets' | 'basic' | 'full';
     }
     interface CoRichTextViewer {
         /**
@@ -3206,6 +3335,10 @@ export namespace Components {
           * Text shown when there is no content.
          */
         "emptyText"?: string;
+        /**
+          * Feature overrides (JSON string for HTML attr, or object via JS property) — mirror the editor's `features`. They only WIDEN the whitelist: e.g. `mentions` keeps the V1 quill markup attrs (`data-id`, `data-denotation-char`, …) so the mention chip keeps its style hook in read mode. Without it the preset profile strips them.
+         */
+        "features"?: string | object;
         /**
           * Input format. `html` is the lightweight path.
           * @default 'html'
@@ -3329,6 +3462,11 @@ export namespace Components {
           * @default ''
          */
         "value": string | string[];
+        /**
+          * 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.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     interface CoSeparator {
         /**
@@ -3724,6 +3862,11 @@ export namespace Components {
           * @default ''
          */
         "value": string;
+        /**
+          * Visual style. `flat` strips the field's border and background so it reads as plain content instead of a boxed textarea — padding, label, focus ring, disabled and status states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant": 'default' | 'flat';
     }
     interface CoToast {
         /**
@@ -4090,6 +4233,10 @@ export interface CoCalendarMonthCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLCoCalendarMonthElement;
 }
+export interface CoCarouselCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLCoCarouselElement;
+}
 export interface CoCheckboxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLCoCheckboxElement;
@@ -4537,6 +4684,40 @@ declare global {
         prototype: HTMLCoCardElement;
         new (): HTMLCoCardElement;
     };
+    interface HTMLCoCarouselElementEventMap {
+        "coSlideChange": number;
+    }
+    /**
+     * A generic slide carousel. Coordinates light-DOM `co-carousel-item`
+     * children (same pattern as co-tab-group): the parent stamps aria and
+     * inertness on each item and translates a flex track to the active index.
+     * No v-model in the Vue wrappers — consume with `:value` + `@coSlideChange`.
+     */
+    interface HTMLCoCarouselElement extends Components.CoCarousel, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLCoCarouselElementEventMap>(type: K, listener: (this: HTMLCoCarouselElement, ev: CoCarouselCustomEvent<HTMLCoCarouselElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLCoCarouselElementEventMap>(type: K, listener: (this: HTMLCoCarouselElement, ev: CoCarouselCustomEvent<HTMLCoCarouselElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLCoCarouselElement: {
+        prototype: HTMLCoCarouselElement;
+        new (): HTMLCoCarouselElement;
+    };
+    /**
+     * A single slide inside a co-carousel. The parent carousel stamps
+     * aria-label / aria-hidden / inert on each item (same light-DOM
+     * coordination pattern as co-tab-group ↔ co-tab).
+     */
+    interface HTMLCoCarouselItemElement extends Components.CoCarouselItem, HTMLStencilElement {
+    }
+    var HTMLCoCarouselItemElement: {
+        prototype: HTMLCoCarouselItemElement;
+        new (): HTMLCoCarouselItemElement;
+    };
     interface HTMLCoCheckboxElementEventMap {
         "coChange": boolean;
     }
@@ -5547,6 +5728,7 @@ declare global {
         "coReady": void;
         "coFontPopupShow": void;
         "coFontPopupHide": void;
+        "coAttachmentsSelected": { files: File[] };
     }
     /**
      * Rich text editor backed by Tiptap v3.
@@ -5571,6 +5753,7 @@ declare global {
     interface HTMLCoRichTextToolbarElementEventMap {
         "coAction": { action: string; payload?: unknown };
         "coPopoverChange": { open: boolean };
+        "coAttachmentsSelected": { files: File[] };
     }
     /**
      * Formatting toolbar for co-rich-text-editor. Receives the Tiptap editor
@@ -5948,6 +6131,8 @@ declare global {
         "co-calendar": HTMLCoCalendarElement;
         "co-calendar-month": HTMLCoCalendarMonthElement;
         "co-card": HTMLCoCardElement;
+        "co-carousel": HTMLCoCarouselElement;
+        "co-carousel-item": HTMLCoCarouselItemElement;
         "co-checkbox": HTMLCoCheckboxElement;
         "co-checkbox-group": HTMLCoCheckboxGroupElement;
         "co-chip": HTMLCoChipElement;
@@ -6166,6 +6351,10 @@ declare namespace LocalJSX {
           * @default 'regular'
          */
         "iconWeight"?: 'regular' | 'thin' | 'light' | 'bold' | 'fill' | 'duotone';
+        /**
+          * Full name / tooltip content. When set (non-empty), the avatar renders wrapped in a `co-tooltip` showing this text on hover/focus — every consumer gets the tooltip for free instead of having to wire it up externally. When unset, renders exactly as before (no wrapper).
+         */
+        "name"?: string;
         /**
           * Optional 2px ring color (hex/CSS). Drives the inset ::after ring.
          */
@@ -6621,6 +6810,75 @@ declare namespace LocalJSX {
          */
         "variant"?: 'elevated' | 'outlined' | 'flat';
     }
+    /**
+     * A generic slide carousel. Coordinates light-DOM `co-carousel-item`
+     * children (same pattern as co-tab-group): the parent stamps aria and
+     * inertness on each item and translates a flex track to the active index.
+     * No v-model in the Vue wrappers — consume with `:value` + `@coSlideChange`.
+     */
+    interface CoCarousel {
+        /**
+          * Show prev/next arrows
+          * @default true
+         */
+        "arrows"?: boolean;
+        /**
+          * Container aspect ratio
+          * @default 'auto'
+         */
+        "aspectRatio"?: '16:9' | '4:3' | '1:1' | '21:9' | 'auto';
+        /**
+          * Auto-advance slides
+          * @default false
+         */
+        "autoplay"?: boolean;
+        /**
+          * Show dot indicators
+          * @default true
+         */
+        "dots"?: boolean;
+        /**
+          * Autoplay interval in milliseconds (floored at 1000)
+          * @default 6000
+         */
+        "interval"?: number;
+        /**
+          * Language for aria labels (es/en/pt, accepts full locales)
+          * @default 'es'
+         */
+        "locale"?: string;
+        /**
+          * Wrap around at the ends
+          * @default true
+         */
+        "loop"?: boolean;
+        /**
+          * Emitted when the active slide changes (user, autoplay or method)
+         */
+        "onCoSlideChange"?: (event: CoCarouselCustomEvent<number>) => void;
+        /**
+          * Pause autoplay while hovered
+          * @default true
+         */
+        "pauseOnHover"?: boolean;
+        /**
+          * Enable pointer swipe navigation
+          * @default true
+         */
+        "swipe"?: boolean;
+        /**
+          * Active slide index
+          * @default 0
+         */
+        "value"?: number;
+    }
+    /**
+     * A single slide inside a co-carousel. The parent carousel stamps
+     * aria-label / aria-hidden / inert on each item (same light-DOM
+     * coordination pattern as co-tab-group ↔ co-tab).
+     */
+    interface CoCarouselItem {
+    }
     interface CoCheckbox {
         /**
           * Visual appearance: - 'default' — the standard labeled form checkbox (unchanged). - 'overlay' — a standalone frosted rounded selection chip (Drive), no label, bespoke SVG glyphs.
@@ -7547,6 +7805,11 @@ declare namespace LocalJSX {
           * @default null
          */
         "value"?: string | null;
+        /**
+          * Visual style. `flat` strips the inner co-date-field's border and background so it reads as plain content instead of a boxed control — padding, label, focus ring, disabled and invalid states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed. co-date-field itself has no `variant` prop, so this is applied from the outside via `::part(field)` — see co-date-picker.css.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     /**
      * @deprecated Use `<co-date-range-picker>` instead.
@@ -7714,6 +7977,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "value"?: string;
+        /**
+          * 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 invalid states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     interface CoDrawer {
         /**
@@ -8050,6 +8318,11 @@ declare namespace LocalJSX {
           * @default false
          */
         "disabled"?: boolean;
+        /**
+          * With `label`: icon-only circle at rest that stretches into the extended pill on hover/focus-visible (springy "liquid" morph).
+          * @default false
+         */
+        "expandOnHover"?: boolean;
         /**
           * @default 'plus'
          */
@@ -8294,6 +8567,11 @@ declare namespace LocalJSX {
           * Label for the integrated action button (Botón variant)
          */
         "actionLabel"?: string;
+        /**
+          * 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.
+          * @default false
+         */
+        "autoFocus"?: boolean;
         /**
           * Autocomplete hint for the browser
          */
@@ -8401,6 +8679,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "value"?: string;
+        /**
+          * Visual style. `flat` strips the field's border and background so it reads as plain content instead of a boxed input — padding, label, focus ring, disabled and status states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     /**
      * Multiline JSON / arbitrary-object editor — a `<textarea>` with inline JSON
@@ -9453,6 +9736,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "value"?: string;
+        /**
+          * 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.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     /**
      * Rich text editor backed by Tiptap v3.
@@ -9465,6 +9753,15 @@ declare namespace LocalJSX {
           * Account/imported fonts shown in a separate "Imported fonts" section. JS property: `Array<{ label: string; value: string }>`. HTML attribute: JSON string of the same array.
          */
         "accountFonts"?: string | { label: string; value: string }[];
+        /**
+          * Passthrough: `accept` for the toolbar attachment picker.
+         */
+        "attachmentAccept"?: string;
+        /**
+          * Passthrough: shows the toolbar attachment button (host owns the files).
+          * @default false
+         */
+        "attachmentsEnabled"?: boolean;
         /**
           * @default false
          */
@@ -9505,6 +9802,10 @@ declare namespace LocalJSX {
          */
         "locale"?: string;
         "maxLength"?: number;
+        /**
+          * Re-emitted from the inner toolbar: files picked via the attach button. Declared here so hosts can bind on the editor (the toolbar is internal).
+         */
+        "onCoAttachmentsSelected"?: (event: CoRichTextEditorCustomEvent<{ files: File[] }>) => void;
         "onCoBlur"?: (event: CoRichTextEditorCustomEvent<void>) => void;
         /**
           * Emitted on blur (committed value).
@@ -9564,6 +9865,11 @@ declare namespace LocalJSX {
           * @default null
          */
         "value"?: string | null;
+        /**
+          * Visual style. `flat` strips the frame'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. The toolbar keeps its own background + bottom border (a subtle, token-driven separator), which is what keeps toolbar and editable area legible/separated once the outer box is gone. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     /**
      * Formatting toolbar for co-rich-text-editor. Receives the Tiptap editor
@@ -9572,6 +9878,15 @@ declare namespace LocalJSX {
      * color palette pickers.
      */
     interface CoRichTextToolbar {
+        /**
+          * `accept` attr for the attachment file picker (e.g. '.pdf,.png').
+         */
+        "attachmentAccept"?: string;
+        /**
+          * Shows the attachment button (compact-assets variant). The editor never owns the attachment list — it only emits the picked files.
+          * @default false
+         */
+        "attachmentsEnabled"?: boolean;
         /**
           * @default false
          */
@@ -9593,6 +9908,10 @@ declare namespace LocalJSX {
           * Emitted whenever a toolbar action runs (observability for hosts).
          */
         "onCoAction"?: (event: CoRichTextToolbarCustomEvent<{ action: string; payload?: unknown }>) => void;
+        /**
+          * Files picked from the toolbar attachment button. The host owns them.
+         */
+        "onCoAttachmentsSelected"?: (event: CoRichTextToolbarCustomEvent<{ files: File[] }>) => void;
         /**
           * Emitted when a toolbar popover/dropdown opens or closes (host hides the selection bubble while one is open to avoid spatial overlap).
          */
@@ -9601,7 +9920,7 @@ declare namespace LocalJSX {
           * Toolbar layout variant.
           * @default 'basic'
          */
-        "variant"?: 'none' | 'compact' | 'basic' | 'full';
+        "variant"?: 'none' | 'compact' | 'compact-assets' | 'basic' | 'full';
     }
     interface CoRichTextViewer {
         /**
@@ -9613,6 +9932,10 @@ declare namespace LocalJSX {
           * Text shown when there is no content.
          */
         "emptyText"?: string;
+        /**
+          * Feature overrides (JSON string for HTML attr, or object via JS property) — mirror the editor's `features`. They only WIDEN the whitelist: e.g. `mentions` keeps the V1 quill markup attrs (`data-id`, `data-denotation-char`, …) so the mention chip keeps its style hook in read mode. Without it the preset profile strips them.
+         */
+        "features"?: string | object;
         /**
           * Input format. `html` is the lightweight path.
           * @default 'html'
@@ -9738,6 +10061,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "value"?: string | string[];
+        /**
+          * 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.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     interface CoSeparator {
         /**
@@ -10193,6 +10521,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "value"?: string;
+        /**
+          * Visual style. `flat` strips the field's border and background so it reads as plain content instead of a boxed textarea — padding, label, focus ring, disabled and status states are unaffected. `default` (the standard bordered box) renders identically to before this prop existed.
+          * @default 'default'
+         */
+        "variant"?: 'default' | 'flat';
     }
     interface CoToast {
         /**
@@ -10580,6 +10913,7 @@ declare namespace LocalJSX {
         "shape": 'circle' | 'square';
         "color": string;
         "ringColor": string;
+        "name": string;
     }
     interface CoAvatarGroupAttributes {
         "max": number;
@@ -10666,6 +11000,18 @@ declare namespace LocalJSX {
         "clickable": boolean;
         "stretch": boolean;
     }
+    interface CoCarouselAttributes {
+        "value": number;
+        "autoplay": boolean;
+        "interval": number;
+        "loop": boolean;
+        "arrows": boolean;
+        "dots": boolean;
+        "pauseOnHover": boolean;
+        "swipe": boolean;
+        "aspectRatio": '16:9' | '4:3' | '1:1' | '21:9' | 'auto';
+        "locale": string;
+    }
     interface CoCheckboxAttributes {
         "checked": boolean;
         "indeterminate": boolean;
@@ -10844,6 +11190,7 @@ declare namespace LocalJSX {
         "label": string;
         "placeholder": string;
         "size": 's' | 'sm' | 'md' | 'lg';
+        "variant": 'default' | 'flat';
         "name": string;
         "disabled": boolean;
         "readonly": boolean;
@@ -10894,6 +11241,7 @@ declare namespace LocalJSX {
         "placeholder": string;
         "layout": 'vertical' | 'horizontal';
         "size": 's' | 'sm' | 'md' | 'lg';
+        "variant": 'default' | 'flat';
         "placement": Placement;
         "open": boolean;
         "applyLabel": string;
@@ -10965,6 +11313,7 @@ declare namespace LocalJSX {
         "ariaLabelText": string;
         "disabled": boolean;
         "position": 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left' | 'none';
+        "expandOnHover": boolean;
     }
     interface CoFileFieldAttributes {
         "label": string;
@@ -11027,9 +11376,11 @@ declare namespace LocalJSX {
         "type": string;
         "name": string;
         "required": boolean;
+        "autoFocus": boolean;
         "autocomplete": string;
         "status": 'default' | 'error' | 'success' | 'warning' | 'info';
         "size": 's' | 'sm' | 'md' | 'lg';
+        "variant": 'default' | 'flat';
         "fill": boolean;
         "actionLabel": string;
         "actionIcon": string;
@@ -11244,6 +11595,7 @@ declare namespace LocalJSX {
         "iconLeft": string;
         "layout": 'vertical' | 'horizontal';
         "size": 's' | 'sm' | 'md' | 'lg' | 'default';
+        "variant": 'default' | 'flat';
         "value": string;
         "options": string;
         "selectedDisplay": string;
@@ -11268,6 +11620,7 @@ declare namespace LocalJSX {
         "secondaryLabel": string;
         "helperText": string;
         "status": 'default' | 'error' | 'success' | 'warning' | 'info';
+        "variant": 'default' | 'flat';
         "disabled": boolean;
         "readonly": boolean;
         "required": boolean;
@@ -11276,15 +11629,19 @@ declare namespace LocalJSX {
         "autofocus": boolean;
         "toolbar": ToolbarVariant;
         "features": string | object;
+        "attachmentsEnabled": boolean;
+        "attachmentAccept": string;
         "fontFamilies": string | { label: string; value: string }[];
         "accountFonts": string | { label: string; value: string }[];
         "fontsLoading": boolean;
         "locale": string;
     }
     interface CoRichTextToolbarAttributes {
-        "variant": 'none' | 'compact' | 'basic' | 'full';
+        "variant": 'none' | 'compact' | 'compact-assets' | 'basic' | 'full';
         "disabled": boolean;
         "locale": string;
+        "attachmentsEnabled": boolean;
+        "attachmentAccept": string;
     }
     interface CoRichTextViewerAttributes {
         "value": string | null;
@@ -11292,6 +11649,7 @@ declare namespace LocalJSX {
         "preset": RichTextPreset;
         "emptyText": string;
         "compact": boolean;
+        "features": string | object;
     }
     interface CoRowAttributes {
         "position": 'top' | 'middle' | 'bottom' | 'single';
@@ -11319,6 +11677,7 @@ declare namespace LocalJSX {
         "value": string | string[];
         "multiple": boolean;
         "size": 's' | 'sm' | 'md' | 'lg';
+        "variant": 'default' | 'flat';
         "searchable": boolean;
         "searchPlaceholder": string;
         "emptyText": string;
@@ -11418,6 +11777,7 @@ declare namespace LocalJSX {
         "helperText": string;
         "layout": 'vertical' | 'horizontal';
         "size": 's' | 'sm' | 'md' | 'lg';
+        "variant": 'default' | 'flat';
         "clearable": boolean;
         "resize": 'vertical' | 'none' | 'both';
     }
@@ -11518,6 +11878,8 @@ declare namespace LocalJSX {
         "co-calendar": Omit<CoCalendar, keyof CoCalendarAttributes> & { [K in keyof CoCalendar & keyof CoCalendarAttributes]?: CoCalendar[K] } & { [K in keyof CoCalendar & keyof CoCalendarAttributes as `attr:${K}`]?: CoCalendarAttributes[K] } & { [K in keyof CoCalendar & keyof CoCalendarAttributes as `prop:${K}`]?: CoCalendar[K] };
         "co-calendar-month": Omit<CoCalendarMonth, keyof CoCalendarMonthAttributes> & { [K in keyof CoCalendarMonth & keyof CoCalendarMonthAttributes]?: CoCalendarMonth[K] } & { [K in keyof CoCalendarMonth & keyof CoCalendarMonthAttributes as `attr:${K}`]?: CoCalendarMonthAttributes[K] } & { [K in keyof CoCalendarMonth & keyof CoCalendarMonthAttributes as `prop:${K}`]?: CoCalendarMonth[K] } & OneOf<"year", CoCalendarMonth["year"], CoCalendarMonthAttributes["year"]> & OneOf<"month", CoCalendarMonth["month"], CoCalendarMonthAttributes["month"]> & OneOf<"timeZone", CoCalendarMonth["timeZone"], CoCalendarMonthAttributes["timeZone"]>;
         "co-card": Omit<CoCard, keyof CoCardAttributes> & { [K in keyof CoCard & keyof CoCardAttributes]?: CoCard[K] } & { [K in keyof CoCard & keyof CoCardAttributes as `attr:${K}`]?: CoCardAttributes[K] } & { [K in keyof CoCard & keyof CoCardAttributes as `prop:${K}`]?: CoCard[K] };
+        "co-carousel": Omit<CoCarousel, keyof CoCarouselAttributes> & { [K in keyof CoCarousel & keyof CoCarouselAttributes]?: CoCarousel[K] } & { [K in keyof CoCarousel & keyof CoCarouselAttributes as `attr:${K}`]?: CoCarouselAttributes[K] } & { [K in keyof CoCarousel & keyof CoCarouselAttributes as `prop:${K}`]?: CoCarousel[K] };
+        "co-carousel-item": CoCarouselItem;
         "co-checkbox": Omit<CoCheckbox, keyof CoCheckboxAttributes> & { [K in keyof CoCheckbox & keyof CoCheckboxAttributes]?: CoCheckbox[K] } & { [K in keyof CoCheckbox & keyof CoCheckboxAttributes as `attr:${K}`]?: CoCheckboxAttributes[K] } & { [K in keyof CoCheckbox & keyof CoCheckboxAttributes as `prop:${K}`]?: CoCheckbox[K] };
         "co-checkbox-group": Omit<CoCheckboxGroup, keyof CoCheckboxGroupAttributes> & { [K in keyof CoCheckboxGroup & keyof CoCheckboxGroupAttributes]?: CoCheckboxGroup[K] } & { [K in keyof CoCheckboxGroup & keyof CoCheckboxGroupAttributes as `attr:${K}`]?: CoCheckboxGroupAttributes[K] } & { [K in keyof CoCheckboxGroup & keyof CoCheckboxGroupAttributes as `prop:${K}`]?: CoCheckboxGroup[K] };
         "co-chip": Omit<CoChip, keyof CoChipAttributes> & { [K in keyof CoChip & keyof CoChipAttributes]?: CoChip[K] } & { [K in keyof CoChip & keyof CoChipAttributes as `attr:${K}`]?: CoChipAttributes[K] } & { [K in keyof CoChip & keyof CoChipAttributes as `prop:${K}`]?: CoChip[K] };
@@ -11658,6 +12020,19 @@ declare module "@stencil/core" {
              */
             "co-calendar-month": LocalJSX.IntrinsicElements["co-calendar-month"] & JSXBase.HTMLAttributes<HTMLCoCalendarMonthElement>;
             "co-card": LocalJSX.IntrinsicElements["co-card"] & JSXBase.HTMLAttributes<HTMLCoCardElement>;
+            /**
+             * A generic slide carousel. Coordinates light-DOM `co-carousel-item`
+             * children (same pattern as co-tab-group): the parent stamps aria and
+             * inertness on each item and translates a flex track to the active index.
+             * No v-model in the Vue wrappers — consume with `:value` + `@coSlideChange`.
+             */
+            "co-carousel": LocalJSX.IntrinsicElements["co-carousel"] & JSXBase.HTMLAttributes<HTMLCoCarouselElement>;
+            /**
+             * A single slide inside a co-carousel. The parent carousel stamps
+             * aria-label / aria-hidden / inert on each item (same light-DOM
+             * coordination pattern as co-tab-group ↔ co-tab).
+             */
+            "co-carousel-item": LocalJSX.IntrinsicElements["co-carousel-item"] & JSXBase.HTMLAttributes<HTMLCoCarouselItemElement>;
             "co-checkbox": LocalJSX.IntrinsicElements["co-checkbox"] & JSXBase.HTMLAttributes<HTMLCoCheckboxElement>;
             "co-checkbox-group": LocalJSX.IntrinsicElements["co-checkbox-group"] & JSXBase.HTMLAttributes<HTMLCoCheckboxGroupElement>;
             "co-chip": LocalJSX.IntrinsicElements["co-chip"] & JSXBase.HTMLAttributes<HTMLCoChipElement>;