@telesign/boreal-web-components 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/cjs/bds-popover.cjs.entry.js

@@ -0,0 +1,271 @@
+'use strict';
+
+var index = require('./index-BcSjvXJk.js');
+var anchored_mixin = require('./anchored.mixin-CnIwkaUi.js');
+var _enum = require('./enum-DLblRCkQ.js');
+require('./floating.mixin-Bje4320w.js');
+
+const bdsPopoverCss = () => `@charset "UTF-8";:root{--popover-arrow-size:var(--boreal-spacing-s);--popover-width:320px}.popover{position:fixed;margin:0;overflow:visible;border-radius:var(--boreal-radius-xs2);font-size:var(--boreal-typography-font-size-xs);line-height:var(--boreal-typography-line-height-xs);font-family:var(--boreal-typography-font-family-primary);font-weight:var(--boreal-typography-font-weight-regular);background:var(--boreal-ui-inverse);-webkit-filter:drop-shadow(0px 2px 8px rgba(0, 0, 0, 0.15));filter:drop-shadow(0px 2px 8px rgba(0, 0, 0, 0.15));-webkit-box-shadow:none;box-shadow:none;-webkit-box-sizing:border-box;box-sizing:border-box;border:transparent;cursor:auto}.popover-content{position:relative;padding:var(--boreal-spacing-s)}.popover[popover]:not(:popover-open){display:none}.popover-header{border-bottom:var(--boreal-stroke-default-light) solid 1px;padding:var(--boreal-spacing-m) var(--boreal-spacing-xs) var(--boreal-spacing-m) var(--boreal-spacing-s);display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between}.popover-header__content{display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center}.popover-header__title{font-size:var(--boreal-typography-font-size-sm);font-weight:var(--boreal-typography-font-weight-semibold);line-height:var(--boreal-typography-line-height-sm)}.popover-header__icon{font-size:var(--boreal-typography-font-size-md);margin-right:var(--boreal-spacing-3xs)}.popover-header__close{margin-left:var(--boreal-spacing-s)}.popover-footer{border-top:var(--boreal-stroke-default-light) solid 1px;padding:var(--boreal-spacing-s) var(--boreal-spacing-xs) var(--boreal-spacing-s) var(--boreal-spacing-s);display:-ms-flexbox;display:flex;-ms-flex-align:center;align-items:center;-ms-flex-pack:justify;justify-content:space-between}.popover .popover-arrow{position:absolute;width:var(--popover-arrow-size);height:var(--popover-arrow-size);pointer-events:none}.popover .popover-arrow::before{content:"";position:absolute;width:var(--popover-arrow-size);height:var(--popover-arrow-size);background:var(--boreal-ui-inverse);-webkit-transform:rotate(45deg);transform:rotate(45deg)}.popover[data-placement^=top] .popover-arrow{bottom:calc(var(--popover-arrow-size) / -2)}.popover[data-placement^=top] .popover-arrow::before{top:0}.popover[data-placement^=bottom] .popover-arrow{top:calc(var(--popover-arrow-size) / -2)}.popover[data-placement^=bottom] .popover-arrow::before{top:0}.popover[data-placement^=left] .popover-arrow{right:calc(var(--popover-arrow-size) / -2)}.popover[data-placement^=left] .popover-arrow::before{left:0}.popover[data-placement^=right] .popover-arrow{left:calc(var(--popover-arrow-size) / -2)}.popover[data-placement^=right] .popover-arrow::before{left:0}`;
+
+const BdsPopover = class extends index.Mixin(anchored_mixin.anchoredMixin) {
+    constructor(hostRef) {
+        super();
+        index.registerInstance(this, hostRef);
+        /**
+         * Override default options for the floating mixin.
+         * This can be overridden by passing a different object to the `floatingOptions` prop.
+         */
+        this.floatingOptions = {};
+        /**
+         * If true, disables the popover.
+         * @default false
+         */
+        this.disabled = false;
+        /**
+         * Width of the popover content.
+         * - number: width in pixels (e.g. 320 → "320px")
+         * - 'full': 100% of the trigger/parent width
+         * - 'auto': fits the content
+         * @default 320
+         */
+        this.width = 320;
+        /**
+         * If true, displays the header section with icon and title slots.
+         * @default false
+         */
+        this.header = false;
+        /**
+         * If true, displays the footer section with helper and button slots.
+         * @default false
+         */
+        this.footer = false;
+        /**
+         * If true, displays a close button inside the header. Requires `header` to be true.
+         * @default false
+         */
+        this.closable = false;
+        /**
+         * Tracks the visibility state of the floating element.
+         * Triggers a re-render when changed.
+         */
+        this.isVisible = false;
+    }
+    /**
+     * Returns the resolved options for the floating mixin, merging `floatingOptions`
+     * prop values with their defaults.
+     */
+    get options() {
+        return {
+            placement: this.floatingOptions.placement ?? 'bottom',
+            offset: this.floatingOptions.offset ?? 16,
+            arrow: this.floatingOptions.hideArrow ? undefined : this.arrowElement,
+            strategy: 'fixed',
+            shift: true,
+            flip: true,
+        };
+    }
+    /**
+     * Returns the popover width based on the `width` prop.
+     * If `width` is 'full', returns '100%'.
+     * If `width` is 'auto', returns 'auto'.
+     * Otherwise, returns the provided width in pixels.
+     */
+    get popoverWidth() {
+        if (this.width === 'full')
+            return '100%';
+        if (this.width === 'auto')
+            return 'auto';
+        return `${this.width}px`;
+    }
+    /**
+     * Returns the lifecycle hooks consumed by the anchored mixin to control
+     * tooltip visibility and positioning.
+     * @override anchoredMixin.hooks
+     */
+    get hooks() {
+        return {
+            onPositionUpdate: result => this.handlePosition(result),
+            onBeforeShow: () => !this.disabled,
+            onAfterShow: () => this.attachClickOutside(),
+            onAfterHide: () => this.detachClickOutside(),
+            onBeforeLoad: () => this.attachTrigger(),
+            subscribeToTrigger: (el) => this.subscribe(el),
+        };
+    }
+    /**
+     * Attaches a click outside listener to the document.
+     * If `closeOnClickOutside` is true, the popover will close when the user clicks outside.
+     */
+    attachClickOutside() {
+        if (this.floatingOptions?.closeOnClickOutside === false)
+            return;
+        this.boundClickOutside = (e) => this.handleClickOutside(e);
+        document.addEventListener('mousedown', this.boundClickOutside);
+    }
+    /**
+     * Detaches the click outside listener from the document.
+     * If `closeOnClickOutside` is true, the popover will close when the user clicks outside.
+     */
+    detachClickOutside() {
+        if (this.floatingOptions?.closeOnClickOutside === false)
+            return;
+        if (this.boundClickOutside !== null) {
+            document.removeEventListener('mousedown', this.boundClickOutside);
+            this.boundClickOutside = () => { };
+        }
+    }
+    /**
+     * Applies the arrow element's `x` and `y` coordinates calculated by the
+     * floating middleware. Skips the update when the arrow element is not
+     * connected to the DOM or when middleware data is absent.
+     *
+     * @param result - The positioning result that may contain `middlewareData.arrow`
+     * with the computed `x` and `y` offsets for the arrow element.
+     */
+    setArrowPosition(result) {
+        if (result.middlewareData?.arrow && !this.disabled && this.arrowElement?.isConnected) {
+            const { x: arrowX, y: arrowY } = result.middlewareData.arrow;
+            Object.assign(this.arrowElement.style, {
+                left: arrowX != null ? `${arrowX}px` : '',
+                top: arrowY != null ? `${arrowY}px` : '',
+            });
+        }
+    }
+    /**
+     *  Handles the click outside event.
+     *  If the click is inside the trigger or the floating content, it will not close the popover.
+     * @param e - Mouse event with the click coordinates.
+     */
+    handleClickOutside(e) {
+        const target = e.target;
+        const clickedInsideTrigger = this.el.contains(target);
+        const clickedInsideFloating = this.floatingContent.contains(target) || this.floatingContent === target;
+        if (!clickedInsideTrigger && !clickedInsideFloating) {
+            this.hide();
+        }
+    }
+    /**
+     * Handles the click event on the floating content. Prevents the default behavior of the click event.
+     * If `closeOnClick` is true, the popover will close when the user clicks inside the floating content.
+     * @param e - Mouse event with the click coordinates.
+     */
+    handleContentClick(e) {
+        e.stopPropagation();
+        this.handleFloatingClick();
+    }
+    /**
+     * Handles the click event on the floating content.
+     * If `closeOnClick` is true, the popover will close when the user clicks inside the floating content.
+     */
+    handleFloatingClick() {
+        if (this.floatingOptions.closeOnClick)
+            this.hide();
+    }
+    /**
+     *  Handles the position update event.
+     *  Updates the position of the floating content and the arrow element.
+     * @param result - Positioning result with the position and the placement.
+     */
+    handlePosition(result) {
+        this.floatingContent.setAttribute('data-placement', result.placement);
+        this.setArrowPosition(result);
+        if (this.width === 'full' && this.triggerSlot !== null && this.triggerSlot !== undefined) {
+            const realTrigger = this.triggerSlot.parentElement ?? this.triggerSlot;
+            const newWidth = realTrigger.getBoundingClientRect().width;
+            const currentWidth = this.floatingContent.getBoundingClientRect().width;
+            if (Math.round(currentWidth) !== Math.round(newWidth)) {
+                this.floatingContent.style.width = `${newWidth}px`;
+            }
+            void this.updatePosition(this.triggerSlot, this.floatingContent, this.options, r => {
+                this.floatingContent.setAttribute('data-placement', r.placement);
+                this.setArrowPosition(r);
+            });
+        }
+        else if (this.width === 'auto') {
+            this.floatingContent.style.width = '';
+        }
+    }
+    /**
+     *  Attaches the trigger to the popover.
+     *  If the trigger is not set, it will return.
+     * @returns
+     */
+    attachTrigger() {
+        if (this.trigger !== null && this.trigger !== undefined)
+            return;
+    }
+    /**
+     *  Subscribes the trigger to the popover.
+     *  If the trigger is not a button, input, or select element, it will return.
+     * @param trigger - The trigger element to subscribe.
+     */
+    subscribe(trigger) {
+        if (trigger === undefined)
+            return;
+        this.trigger = trigger;
+        trigger.setAttribute('part', 'popover-trigger');
+        trigger.setAttribute('ariaDescribedBy', 'popover-content');
+        trigger.setAttribute('aria-haspopup', 'true');
+        trigger.setAttribute('aria-expanded', 'false');
+        const parentBds = trigger.closest('bds-button, bds-input, bds-select');
+        if (parentBds !== null && parentBds !== undefined) {
+            const nativeEl = parentBds.querySelector('button, input');
+            const listenTarget = nativeEl ?? parentBds;
+            this.listenTarget = listenTarget;
+            this.listenTarget.addEventListener('click', (evt) => this.handleShow(evt));
+            this.listenTarget.addEventListener('keydown', (evt) => this.handleKeydown(evt, () => this.showElement(), () => this.hideElement()));
+        }
+        else {
+            this.trigger.addEventListener('click', (evt) => this.handleShow(evt));
+            this.trigger.addEventListener('keydown', (evt) => this.handleKeydown(evt, () => this.showElement(), () => this.hideElement()));
+        }
+    }
+    /**
+     *  Handles the show event.
+     *  If the event is not a click event, it will stop the propagation.
+     * @param evt - Mouse event with the click coordinates.
+     */
+    handleShow(evt) {
+        evt.stopPropagation();
+        this.toggle();
+    }
+    /**
+     *  Returns true if the arrow should be shown, false otherwise.
+     * @returns - True if the arrow should be shown, false otherwise.
+     */
+    get canShowArrow() {
+        return !this.floatingOptions.hideArrow || false;
+    }
+    /**
+     *  Returns the placement of the popover.
+     * @returns - The placement of the popover.
+     */
+    get getPlacement() {
+        return this.floatingOptions.placement || 'bottom';
+    }
+    /**
+     *  Returns true if the header slot is present, false otherwise.
+     * @returns - True if the header slot is present, false otherwise.
+     */
+    get hasHeaderSlot() {
+        return this.el.querySelector('[slot="header"]') !== null;
+    }
+    /**
+     *  Returns true if the footer slot is present, false otherwise.
+     * @returns - True if the footer slot is present, false otherwise.
+     */
+    get hasFooterSlot() {
+        return this.el.querySelector('[slot="footer"]') !== null;
+    }
+    disconnectedCallback() {
+        this.listenTarget.removeEventListener('click', (evt) => this.handleShow(evt));
+        this.trigger.removeEventListener('click', (evt) => this.handleShow(evt));
+    }
+    render() {
+        return (index.h(index.Host, { key: 'e00cacf63369fc0c409d003aaf495eeef1af424c' }, index.h("div", { key: '0262e5dc2789d817c1332d12d598b7f6bb71a188', class: "popover", style: { width: this.popoverWidth }, popover: "manual", role: "tooltip", "data-placement": this.getPlacement, "data-hidearrow": this.canShowArrow, "aria-hidden": this.isVisible ? 'false' : 'true', onClick: (e) => this.handleContentClick(e), ref: el => (this.floatingContent = el) }, this.header && (index.h("div", { key: '63156ddf954e2c2b6452184f060ea502b9798d2f', class: "popover-header" }, index.h("div", { key: '1183b88e3352637d9fce99d160c3d1df56b6010b', class: "popover-header__content" }, index.h("span", { key: '48dcc7ac417bddfd9f19e388e32833d6930a566c', class: "popover-header__icon" }, index.h("slot", { key: 'a852564051439b09b30f8f0f054c29ccb6c4f722', name: "header-icon" })), index.h("span", { key: 'aaaef66cd3454c4dd3bd4be7e0613187943f49b0', class: "popover-header__title" }, index.h("slot", { key: '231224f3e9115e300998942aecfd07ae7b45dda7', name: "header-title" }))), this.closable && (index.h("bds-button", { key: '67ccc016aa89d0627812ad80ad1121bdb3e25692', class: "popover-header__close", size: _enum.BUTTON_SIZES.SMALL, onBdsClick: () => this.hide() }, index.h("em", { key: '40cdcbf5e9ca75e55f45cdce3db6af2ed5088298', slot: "icon", class: "bds-icon-close" }))))), this.canShowArrow && (index.h("div", { key: 'a8bd41e82c5f4a0d7fe7a02287c29140490118e4', class: "popover-arrow", part: "arrow", ref: el => (this.arrowElement = el) })), index.h("div", { key: 'a205d8490fb192ebf0c75388775a8247b06d4431', class: "popover-content", tabIndex: -1, part: "popover-content" }, index.h("slot", { key: 'e3447f0022c0c78a28d176df5d85ff05daea8bd6' })), this.footer && (index.h("div", { key: 'd16a93b4c702e342c89a7192b9a528f39e035601', class: "popover-footer", onClick: (e) => e.stopPropagation() }, index.h("slot", { key: '0c046c725771991b981b5baf090c1ecc023987c6', name: "footer-helper" }), index.h("slot", { key: '3f4391e420d411b0ae84df6fe29d4fc9e96fc206', name: "footer-button" }))))));
+    }
+    get el() { return index.getElement(this); }
+};
+BdsPopover.style = bdsPopoverCss();
+
+exports.bds_popover = BdsPopover;

package/dist/cjs/bds-spinner.cjs.entry.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var index = require('./index-BcSjvXJk.js');
+var validateProps = require('./validateProps-BNOBk1Xs.js');
+
+const SPINNER_SIZES = {
+    SMALL: 'sm',
+    MEDIUM: 'md',
+    LARGE: 'lg',
+};
+
+const bdsSpinnerCss = () => `@charset "UTF-8";:host{display:block}.bds-spinner{display:inline-block;position:relative;width:1em;height:1em}.bds-spinner::before,.bds-spinner::after{content:"";position:absolute;border-color:transparent transparent var(--boreal-primary-base) transparent;border-radius:50%;border-width:3px;border-style:solid;top:0;left:0;width:100%;height:100%;-webkit-box-sizing:border-box;box-sizing:border-box}.bds-spinner::before{opacity:0.2;border-style:dashed;-webkit-animation:spin 0.8s linear infinite;animation:spin 0.8s linear infinite}.bds-spinner::after{-webkit-animation:draw-arc 0.8s linear infinite;animation:draw-arc 0.8s linear infinite}.bds-spinner--small{width:var(--boreal-layout-m);height:var(--boreal-layout-m)}.bds-spinner--medium{width:var(--boreal-layout-ml);height:var(--boreal-layout-ml)}.bds-spinner--large{width:var(--boreal-layout-xl);height:var(--boreal-layout-xl)}.bds-spinner__sr-only{position:absolute;width:1px;height:1px;padding:0;margin:0;overflow:hidden;clip:rect(0, 0, 0, 0);-webkit-clip-path:inset(50%);clip-path:inset(50%);white-space:nowrap;border:0}@-webkit-keyframes spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}@keyframes spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}@-webkit-keyframes draw-arc{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}60%{-webkit-transform:rotate(330deg);transform:rotate(330deg)}65%{-webkit-transform:rotate(335deg);transform:rotate(335deg)}90%{-webkit-transform:rotate(350deg);transform:rotate(350deg)}95%{-webkit-transform:rotate(355deg);transform:rotate(355deg)}98%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}100%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}@keyframes draw-arc{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}60%{-webkit-transform:rotate(330deg);transform:rotate(330deg)}65%{-webkit-transform:rotate(335deg);transform:rotate(335deg)}90%{-webkit-transform:rotate(350deg);transform:rotate(350deg)}95%{-webkit-transform:rotate(355deg);transform:rotate(355deg)}98%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}100%{-webkit-transform:rotate(360deg);transform:rotate(360deg)}}`;
+
+const BdsSpinner = class {
+    constructor(hostRef) {
+        index.registerInstance(this, hostRef);
+        /**
+         * Controls the visual size of the spinner.
+         * @default "small"
+         */
+        this.size = SPINNER_SIZES.SMALL;
+        /**
+         * Accessible label announced by screen readers to describe the loading state.
+         * @default "Loading"
+         */
+        this.label = 'Loading';
+    }
+    checkPropValues() {
+        validateProps.validatePropValue(Object.values(SPINNER_SIZES), SPINNER_SIZES.SMALL, this.el, 'size');
+    }
+    componentWillLoad() {
+        this.checkPropValues();
+    }
+    get getClassMap() {
+        return {
+            'bds-spinner': true,
+            'bds-spinner--small': this.size === SPINNER_SIZES.SMALL,
+            'bds-spinner--medium': this.size === SPINNER_SIZES.MEDIUM,
+            'bds-spinner--large': this.size === SPINNER_SIZES.LARGE,
+        };
+    }
+    render() {
+        return (index.h(index.Host, { key: 'b38497732140f7e9dd155199c49f8365f00b004b', class: this.getClassMap, role: "status", "aria-label": this.label, "aria-live": "polite", "aria-busy": "true" }, index.h("span", { key: '47befa4469a3cf297493c54bcb8acc5bca76fbd3', class: "bds-spinner__sr-only" }, this.label)));
+    }
+    get el() { return index.getElement(this); }
+    static get watchers() { return {
+        "size": [{
+                "checkPropValues": 0
+            }]
+    }; }
+};
+BdsSpinner.style = bdsSpinnerCss();
+
+exports.bds_spinner = BdsSpinner;