@db-ux/v-core-components 4.13.1-angular-signal-forms12-ac097f6 → 4.14.0

package/dist/shared/constants.d.ts

@@ -14,6 +14,8 @@ export declare const DEFAULT_INVALID_MESSAGE: string;
 export declare const DEFAULT_REMOVE: string;
 export declare const DEFAULT_BACK: string;
 export declare const DEFAULT_SELECTED: string;
+export declare const DEFAULT_SCROLL_LEFT: string;
+export declare const DEFAULT_SCROLL_RIGHT: string;
 export declare const DEFAULT_BURGER_MENU: string;
 export declare const DEFAULT_ICON: string;
 export declare const DEFAULT_ROWS: number;

package/dist/shared/model.d.ts

@@ -237,11 +237,13 @@ export type ValueProps = {
      */
     value?: any;
 };
-export type BaseFormProps = {
+export type DisabledProps = {
     /**
-     * The disabled attribute can be set to keep a user from clicking on the form element.
+     * The disabled attribute can be set to keep a user from clicking on the item.
      */
     disabled?: boolean | string;
+};
+export type BaseFormProps = {
     /**
      * The label attribute specifies the caption of the form element.
      */
@@ -250,7 +252,7 @@ export type BaseFormProps = {
      * The name attribute gives the name of the form control, as used in form submission and in the form element's elements object.
      */
     name?: string;
-};
+} & DisabledProps;
 export type CustomFormProps = {
     /**
      * Overwrites auto handling for aria-describedby.
@@ -537,10 +539,31 @@ export type ValueLabelType = {
     value: string;
     label?: string;
 };
+export type OverflowScrollButtonProps = {
+    /**
+     * Change amount of scroll distance when clicking on an overflow scroll arrow button.
+     */
+    arrowScrollDistance?: number | string;
+    /**
+     * Set the text for the scroll left button
+     */
+    scrollLeftText?: string;
+    /**
+     * Set the text for the scroll right button
+     */
+    scrollRightText?: string;
+};
+export type OverflowScrollButtonState = {
+    scroll: (left?: boolean) => void;
+    showScrollLeft?: boolean;
+    showScrollRight?: boolean;
+    evaluateScrollButtons: (tabList: Element) => void;
+};
 export type DocumentScrollState = {
     _documentScrollListenerCallbackId?: string;
     handleDocumentScroll: (event: any, parent?: HTMLElement) => void;
-    _observer?: IntersectionObserver;
+    _intersectionObserverCallbackId?: string;
+    _resizeObserverCallbackId?: string;
 };
 export type PopoverState = {
     handleEscape: (event: any) => void;

package/dist/utils/abstract-document-listener.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generic base class for singleton document event listeners.
+ * Manages a shared set of callbacks dispatched when a document-level
+ * event fires.
+ *
+ * Subclasses own their static state (callbacks, instance) and expose
+ * it via the abstract accessor methods below.
+ *
+ * @template TEvent - The event type passed to callbacks (Event, MouseEvent, etc.)
+ */
+export declare abstract class AbstractDocumentListener<TEvent = any> {
+    /**
+     * Subclasses must return a reference to their own static callbacks store.
+     */
+    protected abstract getCallbacks(): Record<string, (event: TEvent) => void>;
+    addCallback(callback: (event: TEvent) => void): string;
+    removeCallback(id: string): void;
+}

package/dist/utils/abstract-observer-listener.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generic base class for singleton observer listeners.
+ * Uses a Map<Element, Map<id, callback>> for O(1) element lookup in the
+ * observer handler — avoids quadratic scanning when many elements are observed.
+ *
+ * Subclasses own their static state (callbacksByElement, idToElement, observer,
+ * instance) and expose it via the abstract accessor methods below.
+ *
+ * @template TObserver - The observer type (ResizeObserver, IntersectionObserver, etc.)
+ * @template TEntry - The entry type passed to the callback
+ */
+export declare abstract class AbstractObserverListener<TObserver, TEntry> {
+    /**
+     * Returns a Map keyed by Element, where each value is a Map of id → callback.
+     */
+    protected abstract getCallbacksByElement(): Map<Element, Map<string, (entry: TEntry) => void>>;
+    /**
+     * Returns a Map of id → Element for reverse lookup during unobserve.
+     */
+    protected abstract getIdToElement(): Map<string, Element>;
+    /**
+     * Subclasses must return their own static observer instance (or null).
+     */
+    protected abstract getObserver(): TObserver | null;
+    /**
+     * Start observing an element via the underlying observer API.
+     */
+    protected abstract observeElement(observer: TObserver, element: Element): void;
+    /**
+     * Stop observing an element via the underlying observer API.
+     */
+    protected abstract unobserveElement(observer: TObserver, element: Element): void;
+    observe(element: Element, callback: (entry: TEntry) => void): string | undefined;
+    unobserve(id: string): void;
+    /**
+     * Called by subclass observer handlers to dispatch callbacks for an entry.
+     */
+    protected dispatchEntry(element: Element, entry: TEntry): void;
+}

package/dist/utils/document-click-listener.d.ts

@@ -1,8 +1,8 @@
-export declare class DocumentClickListener {
+import { AbstractDocumentListener } from './abstract-document-listener.js';
+export declare class DocumentClickListener extends AbstractDocumentListener {
     private static callbacks;
     private static _instance;
     private static runCallbacks;
     constructor();
-    addCallback(callback: (event: any) => void): string;
-    removeCallback(id: string): void;
+    protected getCallbacks(): Record<string, (event: any) => void>;
 }

package/dist/utils/document-scroll-listener.d.ts

@@ -1,9 +1,9 @@
-export declare class DocumentScrollListener {
+import { AbstractDocumentListener } from './abstract-document-listener.js';
+export declare class DocumentScrollListener extends AbstractDocumentListener {
     private static callbacks;
     private static _instance;
     private static runCallbacks;
     private ticking;
     constructor();
-    addCallback(callback: (event: any) => void): string;
-    removeCallback(id: string): void;
+    protected getCallbacks(): Record<string, (event: any) => void>;
 }

package/dist/utils/floating-components.d.ts

@@ -1,8 +1,3 @@
-export interface DBDataOutsidePair {
-    vx?: 'left' | 'right';
-    vy?: 'top' | 'bottom';
-}
-export declare const handleDataOutside: (el: HTMLElement) => DBDataOutsidePair;
 export declare const handleFixedDropdown: (element: HTMLElement, parent: HTMLElement, placement: string) => void;
 export declare const getFloatingProps: (element: HTMLElement, parent: HTMLElement, placement: string) => {
     top: number;
@@ -16,5 +11,33 @@ export declare const getFloatingProps: (element: HTMLElement, parent: HTMLElemen
     correctedPlacement: string;
     innerWidth: number;
     innerHeight: number;
+    outsideYBoth?: undefined;
+} | {
+    top: number;
+    bottom: number;
+    right: number;
+    height: number;
+    width: number;
+    left: number;
+    childHeight: number;
+    childWidth: number;
+    correctedPlacement: string;
+    innerWidth: number;
+    innerHeight: number;
+    outsideYBoth: boolean;
 };
-export declare const handleFixedPopover: (element: HTMLElement, parent: HTMLElement, placement: string) => void;
+export declare const handleFixedPopover: (element: HTMLElement, parent: HTMLElement, placement?: string) => void;
+/**
+ * Detects whether a floating element overflows the viewport edges
+ * and sets `data-outside-vy` / `data-outside-vx` attributes accordingly.
+ * CSS rules can use these attributes to flip/reposition the element.
+ *
+ * If the element was already flipped (has existing data-outside-* attributes),
+ * it checks whether the flipped position would overflow on the opposite side
+ * using the parent's rect as reference, preventing infinite flip-flop.
+ */
+export interface DBDataOutsidePair {
+    vx?: 'left' | 'right';
+    vy?: 'top' | 'bottom';
+}
+export declare const handleDataOutside: (el: HTMLElement) => DBDataOutsidePair;

package/dist/utils/intersection-observer-listener.d.ts

@@ -0,0 +1,15 @@
+import { AbstractObserverListener } from './abstract-observer-listener.js';
+type IntersectionCallback = (entry: IntersectionObserverEntry) => void;
+export declare class IntersectionObserverListener extends AbstractObserverListener<IntersectionObserver, IntersectionObserverEntry> {
+    private static _instance;
+    private static callbacksByElement;
+    private static idToElement;
+    private static observer;
+    constructor();
+    protected getCallbacksByElement(): Map<Element, Map<string, IntersectionCallback>>;
+    protected getIdToElement(): Map<string, Element>;
+    protected getObserver(): IntersectionObserver | null;
+    protected observeElement(observer: IntersectionObserver, element: Element): void;
+    protected unobserveElement(observer: IntersectionObserver, element: Element): void;
+}
+export {};

package/dist/utils/resize-observer-listener.d.ts

@@ -0,0 +1,15 @@
+import { AbstractObserverListener } from './abstract-observer-listener.js';
+type ResizeCallback = (entry: ResizeObserverEntry) => void;
+export declare class ResizeObserverListener extends AbstractObserverListener<ResizeObserver, ResizeObserverEntry> {
+    private static _instance;
+    private static callbacksByElement;
+    private static idToElement;
+    private static observer;
+    constructor();
+    protected getCallbacksByElement(): Map<Element, Map<string, ResizeCallback>>;
+    protected getIdToElement(): Map<string, Element>;
+    protected getObserver(): ResizeObserver | null;
+    protected observeElement(observer: ResizeObserver, element: Element): void;
+    protected unobserveElement(observer: ResizeObserver, element: Element): void;
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@db-ux/v-core-components",
-  "version": "4.13.1-angular-signal-forms12-ac097f6",
+  "version": "4.14.0",
   "type": "module",
   "description": "Vue components for @db-ux/core-components",
   "repository": {
@@ -28,8 +28,8 @@
     "dist/"
   ],
   "dependencies": {
-    "@db-ux/core-components": "4.13.1-angular-signal-forms12-ac097f6",
-    "@db-ux/core-foundations": "4.13.1-angular-signal-forms12-ac097f6"
+    "@db-ux/core-components": "4.14.0",
+    "@db-ux/core-foundations": "4.14.0"
   },
   "devDependencies": {
     "@playwright/experimental-ct-vue": "1.60.0",