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

package/dist/types/mixins/anchored.mixin.d.ts

@@ -2,6 +2,7 @@ import { IFloatingAdapter, PositioningEngine } from "../services/floating/positi
 import { MixedInCtor } from '../stencil-public-runtime';
 import { Logger } from "../services/logger/Logger";
 import { FloatingMixinOptions } from "../services/floating/interfaces/Floating";
+import { AnchoredHooks } from "../services/floating/interfaces/Anchored";
 /**
  * Positioning and trigger mixin for anchor-based floating elements.
  *
@@ -109,6 +110,8 @@ export declare const anchoredMixin: <B extends MixedInCtor>(Base: B) => {
          * either via slot change handler or `componentDidLoad`.
          */
         triggerSlot: HTMLElement;
+        el: HTMLElement;
+        readonly hooks: AnchoredHooks;
         /**
          * Shows the floating element using the Popover API
          * and starts position auto-update relative to `triggerSlot`.
@@ -160,7 +163,7 @@ export declare const anchoredMixin: <B extends MixedInCtor>(Base: B) => {
          * @param options - Positioning options (placement, offset, flip, shift, arrow)
          * @param onPositionUpdate - Optional callback invoked after each position update
          */
-        updatePosition(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: (result: Awaited<ReturnType<PositioningEngine["computePosition"]>>) => void): Promise<import("../services/floating/interfaces/Positioning").PositioningResult>;
+        updatePosition(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: (result: Awaited<ReturnType<PositioningEngine["computePosition"]>>) => void): Promise<import("../services").PositioningResult>;
         /**
          * Starts automatic position synchronization between the trigger
          * and the floating element. Runs `updatePosition` once immediately,
@@ -171,7 +174,7 @@ export declare const anchoredMixin: <B extends MixedInCtor>(Base: B) => {
          * @param options - Positioning options
          * @param onPositionUpdate - Optional callback after each position update
          */
-        startAutoUpdate(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: Parameters<(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: (result: Awaited<ReturnType<PositioningEngine["computePosition"]>>) => void) => Promise<import("../services/floating/interfaces/Positioning").PositioningResult>>[3]): void;
+        startAutoUpdate(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: Parameters<(triggerElement: HTMLElement, floatingElement: HTMLElement, options: FloatingMixinOptions, onPositionUpdate?: (result: Awaited<ReturnType<PositioningEngine["computePosition"]>>) => void) => Promise<import("../services").PositioningResult>>[3]): void;
         /**
          * Stops automatic position synchronization and clears the cleanup reference.
          */
@@ -200,6 +203,9 @@ export declare const anchoredMixin: <B extends MixedInCtor>(Base: B) => {
          * @param hideFn - Bound hide function to remove
          */
         floatingDisconnect(showFn: (this: void) => void, hideFn: (this: void) => void): void;
+        subscribeToTrigger(trigger?: HTMLElement): void;
+        onBeforeLoad(): void;
+        componentDidLoad(): void;
         /**
          * Initializes the positioning engine, logger, and binds lifecycle methods
          * so they can be safely passed as event listener callbacks.
@@ -213,10 +219,9 @@ export declare const anchoredMixin: <B extends MixedInCtor>(Base: B) => {
          * when the component is removed from the DOM.
          */
         disconnectedCallback(): void;
-        floatingOptions: import("../services/floating/interfaces/Props").FloatingAnchoredProp;
+        floatingOptions: import("../services").FloatingProp;
         floatingContent: HTMLElement;
         isVisible: boolean;
-        readonly hooks: import("@/services/floating/interfaces/Floating").FloatingHooks;
         onBeforeHide(target?: HTMLElement): boolean;
         show(target?: HTMLElement): void;
         hide(target?: HTMLElement): void;

package/dist/types/mixins/backdrop.mixin.d.ts

@@ -0,0 +1,103 @@
+import { MixedInCtor } from '../stencil-public-runtime';
+import { BackdropHooks } from "../services/floating/interfaces/Backdrop";
+export declare const backdropMixin: <B extends MixedInCtor>(Base: B) => {
+    new (...args: any[]): {
+        /**
+         * The dialog element associated with this backdrop.
+         */
+        dialogElement: HTMLDialogElement;
+        /**
+         * Determines whether clicking on the backdrop closes the dialog.
+         */
+        backdropClose: boolean;
+        /**
+         * Determines whether pressing the Escape key closes the dialog.
+         */
+        escapeClose: boolean;
+        /**
+         * Determines whether pressing the Escape key closes the dialog.
+         */
+        preventClose: boolean;
+        /**
+         * Indicates whether the dialog is currently in the process of closing.
+         */
+        isClosing: boolean;
+        /**
+         * Scroll lock is handled per dialog instance.
+         * This assumes dialogs are opened in a nested manner.
+         */
+        previousOverflow: string;
+        /**
+         * Override in component to provide custom hooks.
+         * @returns {BackdropHooks} The custom hooks object.
+         */
+        readonly hooks: BackdropHooks;
+        /**
+         * Shows the dialog element by calling showModal and setting isVisible to true.
+         * Overrides floating mixin showElement()
+         */
+        showElement(): void;
+        /**
+         * Hides the dialog element by calling close and setting isVisible to false, and resets isClosing.
+         * Overrides floating mixin hideElement()
+         */
+        hideElement(): void;
+        /**
+         * Closes the dialog element, preventing multiple close attempts and calling hooks if available.
+         * * If the onBEforeClose() hook is passed, the implementation SHOULD call the hide() function.
+         */
+        closeElement(): void;
+        /**
+         * Toggles the visibility of the dialog: closes if visible, shows if hidden.
+         */
+        toggle(): void;
+        /**
+         * Overrides the hooks inherited from floating mixin.
+         * Hook called after the dialog is shown. Locks the scroll and calls custom hooks.
+         * @param target The target HTMLElement
+         */
+        onAfterShow(target?: HTMLElement): void;
+        /**
+         * Hook called after the dialog is hidden. Restores the previous overflow style and calls custom hooks.
+         * @param target The target HTMLElement
+         */
+        onAfterHide(target?: HTMLElement): void;
+        /**
+         * A lifecycle hook that is invoked just before the dialog begins to close.
+         * This provides an opportunity to perform custom actions, such as triggering closing animations,
+         * before the dialog is actually hidden from view.
+         * * If the onBeforeClose() hook is passed, the implementation SHOULD call the hide() function.
+         * @param target The target HTMLElement, typically the dialog element.
+         */
+        onBeforeClose(target?: HTMLElement): void;
+        /**
+         * Handle backdrop click to close the dialog.
+         * @param e Mouse Event at click
+         */
+        handleBackdropClick(e: MouseEvent): void;
+        /**
+         * Handle Escape keydown to close the dialog.
+         * @param ev KeyboardEvent
+         */
+        handleKeydown(ev: KeyboardEvent): void;
+        /**
+         * Adds a transition class to the dialog element.
+         * Cleanup and closing logic must be handled by the caller.
+         */
+        addTransitionAnimation(animationClassName: string): void;
+        /**
+         * Removes a transition class to the dialog element.
+         * Calling must be handled by the caller.
+         */
+        removeTransitionAnimation(animationClassName: string): void;
+        floatingOptions: import("../services").FloatingProp;
+        floatingContent: HTMLElement;
+        isVisible: boolean;
+        readonly options: import("../services").FloatingMixinOptions;
+        onBeforeShow(target?: HTMLElement): boolean;
+        onBeforeHide(target?: HTMLElement): boolean;
+        show(target?: HTMLElement): void;
+        hide(target?: HTMLElement): void;
+    };
+} & B;
+//# sourceMappingURL=backdrop.mixin.d.ts.map

package/dist/types/mixins/floating.mixin.d.ts

@@ -1,5 +1,5 @@
-import { FloatingHooks } from "../services/floating/interfaces/Floating";
-import { FloatingAnchoredProp } from "../services/floating/interfaces/Props";
+import { FloatingHooks, FloatingMixinOptions } from "../services/floating/interfaces/Floating";
+import { FloatingProp } from "../services/floating/interfaces/Props";
 import { MixedInCtor } from '../stencil-public-runtime';
 /**
  * Core lifecycle mixin for all floating elements in the design system.
@@ -66,7 +66,7 @@ export declare const floatingMixin: <B extends MixedInCtor>(Base: B) => {
          * Configuration prop passed by the consumer component.
          * Allows external control over lifecycle hooks and floating behavior.
          */
-        floatingOptions: FloatingAnchoredProp;
+        floatingOptions: FloatingProp;
         /**
          * Reference to the floating element in the DOM.
          * Must be assigned via `ref` in the component's render method.
@@ -90,6 +90,14 @@ export declare const floatingMixin: <B extends MixedInCtor>(Base: B) => {
          * @returns FloatingHooks — an object with optional lifecycle callbacks
          */
         readonly hooks: FloatingHooks;
+        /**
+         * Default options for the floating mixin.
+         * Override this getter in the component to customize placement,
+         * offset, strategy, flip, shift, and arrow.
+         *
+         * @returns FloatingMixinOptions — default options for the mixin
+         */
+        readonly options: FloatingMixinOptions;
         /**
          * Called before the element is shown.
          * Aggregates both the component `hooks` and `floatingOptions` controls.

package/dist/types/mixins/form-associated.mixin.d.ts

@@ -9,7 +9,7 @@ import { type EventEmitter, type MixedInCtor } from '../stencil-public-runtime';
  *
  * @example
  * ```typescript
- * import { AttachInternals, Component, Event, EventEmitter, Mixin, Prop } from '../stencil-public-runtime';
+ * import { AttachInternals, Component, Event, EventEmitter, Mixin, Prop, State, Watch } from '../stencil-public-runtime';
  *
  * import { setFormValue } from '@/utils/form';
  * import { formAssociatedMixin, type IFormControl } from '@/mixins/form-associated.mixin';
@@ -18,6 +18,12 @@ import { type EventEmitter, type MixedInCtor } from '../stencil-public-runtime';
  * export class BdsTextField extends Mixin(formAssociatedMixin) implements ITextField, IFormControl<string> {
  *   @AttachInternals() internals!: ElementInternals;
  *
+ *   @Prop({ reflect: true }) readonly disabled: boolean = false;
+ *   @State() private isDisabled: boolean = false;
+ *
+ *   @Watch('disabled')
+ *   onDisabledChange(next: boolean) { this.isDisabled = next; }
+ *
  *   @Prop({ mutable: true, reflect: true }) value: string = '';
  *
  *   @Event() valueChange!: EventEmitter<string>;
@@ -99,28 +105,26 @@ export interface IFormControl<T> extends IFormAssociatedCallbacks, IFormValueEmi
 /**
  * Shared base mixin for Form-Associated Custom Elements in Boreal DS.
  *
- * Provides:
- * - `name`, `disabled`, and `required` form props
- * - `formDisabledCallback` with universal disabled sync behavior
+ * Provides `formDisabledCallback` — the only behavior that is identical across
+ * all FACE components. It writes to the component's `isDisabled` state, which
+ * each component must declare as `@State() private isDisabled: boolean = false`.
+ *
+ * Each component must declare directly on its class body:
+ * - `@AttachInternals() internals!: ElementInternals`
+ * - `@Prop({ reflect: true }) readonly name!: string`
+ * - `@Prop({ reflect: true }) readonly disabled: boolean = false`
+ * - `@Prop({ reflect: true }) readonly required: boolean = false`
+ * - `@State() private isDisabled: boolean = false`
+ * - `@Watch('disabled') onDisabledChange(next: boolean) { this.isDisabled = next; }`
  *
- * Each component must declare `@AttachInternals() internals!: ElementInternals`
- * directly on its class body — Stencil's compiler requires this decorator to be
- * statically visible on the component class, not inside a mixin factory.
+ * Stencil's compiler requires `@Prop` and `@State` decorators to be statically
+ * visible on the component class — they cannot be inherited from a mixin.
  *
  * Components must also implement `IFormControl<T>` for value registration,
  * reset, state restoration, and 2-way binding event emission.
  */
 export declare const formAssociatedMixin: <B extends MixedInCtor>(Base: B) => {
     new (...args: any[]): {
-        /** Name of the form control, submitted as a key in the form data. */
-        readonly name: string;
-        /** Disables the control. Synced automatically from a parent `<fieldset>` or `<form>` via `formDisabledCallback`. */
-        readonly disabled: boolean;
-        /** Marks the control as required for form submission. */
-        readonly required: boolean;
-        /**
-         * Sync component disabled state with parent form disabled state.
-         */
         formDisabledCallback(disabled: boolean): void;
     };
 } & B;

package/dist/types/mixins/index.d.ts

@@ -1,4 +1,5 @@
 export * from './form-associated.mixin';
 export * from './floating.mixin';
 export * from './anchored.mixin';
+export * from './backdrop.mixin';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/services/floating/index.d.ts

@@ -0,0 +1,4 @@
+export * from './positioning.service';
+export * from './interfaces';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/services/floating/interfaces/Anchored.d.ts

@@ -0,0 +1,7 @@
+import { FloatingHooks } from './Floating';
+export interface AnchoredHooks extends FloatingHooks {
+    onBeforeLoad?: (el?: HTMLElement) => void;
+    onAfterLoad?: (el?: HTMLElement) => void;
+    subscribeToTrigger?: (el?: HTMLElement) => void;
+}
+//# sourceMappingURL=Anchored.d.ts.map

package/dist/types/services/floating/interfaces/Backdrop.d.ts

@@ -0,0 +1,5 @@
+import { FloatingHooks } from './Floating';
+export interface BackdropHooks extends FloatingHooks {
+    onBeforeClose?: (el?: HTMLElement) => void;
+}
+//# sourceMappingURL=Backdrop.d.ts.map

package/dist/types/services/floating/interfaces/Floating.d.ts

@@ -1,6 +1,6 @@
 import { Placement, Strategy } from '@floating-ui/dom';
 import { PositioningResult } from './Positioning';
-import { FloatingAnchoredProp } from './Props';
+import { FloatingProp } from './Props';
 /**
  * Add methods to the `onBeforeShow`, `onAfterShow`, `onBeforeHide`, and `onAfterHide` to add custom logic.
  * Pass the element to the method to get the reference to the floating element.
@@ -31,7 +31,7 @@ export interface FloatingMixinOptions {
  * The mixin could provide a getter to able the developer override values.
  */
 export interface IFloatingMixin extends FloatingHooks {
-    floatingOptions: FloatingAnchoredProp;
+    floatingOptions?: FloatingProp;
     get options(): FloatingMixinOptions;
     get hooks(): FloatingHooks;
 }

package/dist/types/services/floating/interfaces/Props.d.ts

@@ -1,4 +1,4 @@
-import { Position } from "../../../types/position";
+import { PopoverPosition, Position } from "../../../types/position";
 import { Arrow } from '../types/Arrow';
 import { FloatingHooks, FloatingMixinOptions } from './Floating';
 /**
@@ -28,8 +28,9 @@ export interface FloatingTooltipProp extends FloatingAnchoredProp {
  * add closeOnClick prop to close the popover when the trigger element is clicked.
  * add clickOutside prop to close the popover when the user click outside the popover.
  */
-export interface FloatingPopoverProp extends FloatingAnchoredProp {
+export interface FloatingPopoverProp extends Omit<FloatingAnchoredProp, 'placement'> {
     closeOnClick?: boolean;
-    clickOutside?: boolean;
+    closeOnClickOutside?: boolean;
+    placement?: PopoverPosition;
 }
 //# sourceMappingURL=Props.d.ts.map

package/dist/types/services/floating/interfaces/index.d.ts

@@ -0,0 +1,6 @@
+export * from './Floating';
+export * from './Props';
+export * from './Anchored';
+export * from './Positioning';
+export * from './Backdrop';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/services/floating/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Arrow';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from './floating';
+export * from './logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/services/logger/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/types/coreColors.d.ts

@@ -0,0 +1,8 @@
+export declare const CORE_COLORS: {
+    readonly DEFAULT: "default";
+    readonly PRIMARY: "primary";
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+};
+export type CoreColors = (typeof CORE_COLORS)[keyof typeof CORE_COLORS];
+//# sourceMappingURL=coreColors.d.ts.map

package/dist/types/types/form.d.ts

@@ -1,4 +1,3 @@
-export type ValidationTiming = 'blur' | 'input' | 'submit';
 export interface IFormValidator {
     key: keyof ValidityStateFlags;
     isValid: (el: HTMLElement) => boolean;

package/dist/types/types/position.d.ts

@@ -9,5 +9,12 @@ export declare const POSITION: {
     readonly LEFT: "left";
     readonly RIGHT: "right";
 };
+export declare const POPOVER_POSITION: {
+    readonly TOP: "top-start";
+    readonly BOTTOM: "bottom-start";
+    readonly LEFT: "left";
+    readonly RIGHT: "right";
+};
 export type Position = (typeof POSITION)[keyof typeof POSITION];
+export type PopoverPosition = (typeof POPOVER_POSITION)[keyof typeof POPOVER_POSITION];
 //# sourceMappingURL=position.d.ts.map

package/dist/types/types/states.d.ts

@@ -1,4 +1,4 @@
-export declare const STATES: {
+export declare const COMPONENT_STATES: {
     readonly DEFAULT: "default";
     readonly ERROR: "error";
     readonly DISABLED: "disabled";
@@ -7,7 +7,7 @@ export declare const STATES: {
     readonly FOCUS: "focus";
     readonly VISITED: "visited";
 };
-export type State = (typeof STATES)[keyof typeof STATES];
+export type ComponentState = (typeof COMPONENT_STATES)[keyof typeof COMPONENT_STATES];
 export declare const PROCESS_STATUS: {
     readonly NEUTRAL: "neutral";
     readonly PENDING: "pending";

package/dist/types/utils/__test__/backdrop-mock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A backdrop mock used to test backdrop based components
+ */
+export declare function setupBackdropMocks(): void;
+//# sourceMappingURL=backdrop-mock.d.ts.map

package/dist/types/utils/__test__/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const TEST_CONSTANT = "This is a test constant used in many tests.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/utils/__test__/fixtures.d.ts

@@ -0,0 +1,6 @@
+export declare const TEST_FIXTURE: {
+    first: string;
+    middle: string;
+    last: string;
+};
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/types/utils/__test__/helpers.d.ts

@@ -0,0 +1,14 @@
+import { AnyHTMLElement } from '../../stencil-public-runtime';
+/**
+ * Returns inner element of hydrated component
+ */
+export declare const getInner: (root: AnyHTMLElement | undefined) => HTMLElement;
+/**
+ * Verify if exist an element and throw an error if it doesn't exist.
+ *
+ * @param condition The element or condition to evaluate.
+ * @param message Custom error message.
+ * @throws {Error} If the condition is false, null, or undefined.
+ */
+export declare function assertExists<T>(condition: T | null | undefined, message: string): asserts condition is T;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/utils/__test__/index.d.ts

@@ -0,0 +1,7 @@
+export * from './constants';
+export * from './fixtures';
+export * from './popover-mock';
+export * from './backdrop-mock';
+export * from './helpers';
+export * from './mocks';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/__test__/mocks/ElementInternals.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @file Mock implementation of ElementInternals for testing purposes.
+ * simulates the behavior of ElementInternals in a testing environment, allowing components
+ * that rely on form association and validation to be tested without a real browser environment.
+ */
+declare global {
+    interface Window {
+        /** Mock global of ElementInternals Class */
+        ElementInternals: typeof ElementInternals;
+    }
+    interface HTMLElement {
+        /** Simulate native attachInternals method to associate forms */
+        attachInternals(): ElementInternals;
+    }
+    interface HTMLFormElement {
+        /** Simulate native requestSubmit method to trigger form submission */
+        requestSubmit(): void;
+        /** Simulate native reset method to trigger form reset */
+        reset(): void;
+    }
+}
+/**
+ * Mock class that simulates the behavior of ElementInternals for Stencil components.
+ * Allows handling validity states and form association in tests.
+ */
+export declare class ElementInternals {
+    /** Reference to the associated form element */
+    form: HTMLFormElement | null;
+    setFormValue: jest.Mock<any, any, any>;
+    setValidity: jest.Mock<any, any, any>;
+    checkValidity: jest.Mock<boolean, [], any>;
+    reportValidity: jest.Mock<boolean, [], any>;
+    /**
+     * Simulate form submission by dispatching a submit event on the associated form
+     * This should be do it because in testing evironment doesn't exist requesSubmit method on form element,
+     * so we need to simulate it to test the submit behavior of the button component.
+     * */
+    requestSubmit: jest.Mock<void, [], ElementInternals>;
+}
+/**
+ * Initializes the necessary mocks in the global environment
+ * to ensure that components relying on ElementInternals can function correctly during tests.
+ * This includes defining the attachInternals method on HTMLElement and simulating form submission methods.
+ */
+export declare function attachInternals(): void;
+//# sourceMappingURL=ElementInternals.d.ts.map

package/dist/types/utils/__test__/mocks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ElementInternals';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/__test__/popover-mock.d.ts

@@ -0,0 +1,2 @@
+export declare function setupPopoverMocks(): void;
+//# sourceMappingURL=popover-mock.d.ts.map

package/dist/types/utils/constants/common/Aria.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type for aria-label values used across components.
+ */
+type AriaLabels = {
+    [key: string]: string;
+};
+/**
+ * Centralized list of `aria-label` values used by interactive elements.
+ * Add new entries to the `ARIA_LABELS` object to keep labels consistent
+ * and prevent typos across the design system.
+ */
+export declare const ARIA_LABELS: AriaLabels;
+export {};
+//# sourceMappingURL=Aria.d.ts.map

package/dist/types/utils/constants/common/Icons.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type for icon font-class names used across components.
+ */
+type Icons = {
+    [key: string]: string;
+};
+/**
+ * Centralized list of icon font-class names used by design-system components.
+ * Add new entries to the `ICONS` object to keep class names consistent
+ * and prevent typos across the design system.
+ */
+export declare const ICONS: Icons;
+export {};
+//# sourceMappingURL=Icons.d.ts.map

package/dist/types/utils/constants/common/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Aria';
+export * from './Events';
+export * from './Icons';
+export * from './Keys';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from './common';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/helpers/common/BaseAttributes.d.ts

@@ -1,16 +1,9 @@
 /**
- * Ensure the given component instance has an auto-generated id if one wasn't provided.
- * Designed to be called from `componentWillLoad` on a Stencil component.
+ * Generates a stable random ID for internal ARIA linkage.
+ * Used by components to wire labels, descriptions, and controls
+ * without exposing the ID as a public prop.
+ *
+ * @param prefix - Component-specific prefix for readability in DevTools.
  */
-export declare function createId(component: {
-    idComponent?: string;
-}): void;
-/**
- * Components can spread the result into their host.
- */
-export declare function getBaseAttributes(component: {
-    idComponent: string;
-}): {
-    id: string;
-};
+export declare function createId(prefix?: string): string;
 //# sourceMappingURL=BaseAttributes.d.ts.map

package/dist/types/utils/helpers/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './BaseAttributes';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common';
+export * from './validateProps';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/helpers/validateProps.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates a component prop against a list of accepted values.
+ * If the current value is invalid, the prop is reset to the fallback and a warning is issued.
+ *
+ * @param acceptedValues - The list of valid values for the prop.
+ * @param fallbackValue - The value to apply when the current value is invalid.
+ * @param element - The host element whose property will be corrected.
+ * @param propertyName - The name of the prop to validate.
+ */
+export declare function validatePropValue<T extends string>(acceptedValues: readonly T[], fallbackValue: T, element: HTMLElement, propertyName: string): void;
+//# sourceMappingURL=validateProps.d.ts.map

package/dist/types/utils/index.d.ts

@@ -1,4 +1,7 @@
 export * from './a11y';
 export * from './dom';
 export * from './form';
+export * from './helpers';
+export * from './__test__';
+export * from './constants';
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telesign/boreal-web-components",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Stencil Component Starter",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
@@ -19,8 +19,9 @@
       "require": "./loader/index.cjs",
       "types": "./loader/index.d.ts"
     },
-    "./components/*": {
-      "import": "./components-build/*"
+    "./components/*.js": {
+      "import": "./components-build/*.js",
+      "types": "./components-build/*.d.ts"
     },
     "./types": {
       "import": "./dist/collection/types/index.js",

package/dist/boreal-web-components/p-B9wshZ_4.js

@@ -1 +0,0 @@
-const a={DEFAULT:"default",ERROR:"error",DISABLED:"disabled"},i={INFO:"info"},r=["role","aria-activedescendant","aria-atomic","aria-autocomplete","aria-braillelabel","aria-brailleroledescription","aria-busy","aria-checked","aria-colcount","aria-colindex","aria-colindextext","aria-colspan","aria-controls","aria-current","aria-describedby","aria-description","aria-details","aria-disabled","aria-errormessage","aria-expanded","aria-flowto","aria-haspopup","aria-hidden","aria-invalid","aria-keyshortcuts","aria-label","aria-labelledby","aria-level","aria-live","aria-multiline","aria-multiselectable","aria-orientation","aria-owns","aria-placeholder","aria-posinset","aria-pressed","aria-readonly","aria-relevant","aria-required","aria-roledescription","aria-rowcount","aria-rowindex","aria-rowindextext","aria-rowspan","aria-selected","aria-setsize","aria-sort","aria-valuemax","aria-valuemin","aria-valuenow","aria-valuetext"],e=a=>((a,i=[])=>{const r={};return i.forEach((i=>{if(a.hasAttribute(i)){const e=a.getAttribute(i);null!==e&&(r[i]=e),a.removeAttribute(i)}})),r})(a,r);export{i as S,a,e as i}