@breadstone/mosaik-elements-foundation 0.0.226 → 0.0.227

package/Controls/Components/Misc/BackTop/BackTopElement.js

@@ -8,20 +8,73 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
+import { HTMLElementEventEmitter, on } from '@breadstone/mosaik-elements';
 import { RendererServiceLocator } from '../../../../Dom/Renderer';
-import { Emit } from '../../../../Events/Decorators/EmitDecorator';
-import { on, HTMLElementEventEmitter } from '@breadstone/mosaik-elements';
+import { Emit } from '../../../../events/Decorators/EmitDecorator';
 import { Attachable } from '../../../Behaviors/Attachable';
+import { Themeable } from '../../../Behaviors/Themeable';
 import { Attribute } from '../../../Decorators/AttributeDecorator';
 import { Component } from '../../../Decorators/ComponentDecorator';
 import { CustomElement } from '../../Abstracts/CustomElement';
 import { backTopElementTemplate } from './BackTopElementTemplate';
+import { backTopElementCosmopolitanStyle } from './Themes/BackTopElement.Cosmopolitan';
 import { backTopElementJoyStyle } from './Themes/BackTopElement.Joy';
 import { backTopElementMemphisStyle } from './Themes/BackTopElement.Memphis';
-import { backTopElementCosmopolitanStyle } from './Themes/BackTopElement.Cosmopolitan';
-import { Themeable } from '../../../Behaviors/Themeable';
 /**
- * The `{@link BackTopElement}` element.
+ * BackTop - A scrollable page navigation element that provides quick access to return to the top or bottom.
+ *
+ * @description
+ * The BackTop component creates an interactive floating action button that appears when a user scrolls
+ * beyond a specified offset threshold. It provides smooth scroll-to-position functionality for returning
+ * to either the top or bottom of scrollable containers. The component monitors scroll position in real-time,
+ * automatically showing or hiding itself based on the configured offset, and offers smooth animated scrolling
+ * behavior when activated. It includes attachment positioning capabilities for flexible placement within
+ * scrollable regions, making it ideal for long-form content pages, infinite scroll interfaces, or any
+ * scenario requiring convenient navigation across extensive vertical content.
+ *
+ * @name BackTop
+ * @element mosaik-back-top
+ * @category Misc
+ *
+ * @slot - Default slot for custom content (overrides default floating action button)
+ *
+ * @csspart root - The root container element wrapping the component
+ * @csspart button - The floating action button element that triggers scroll navigation
+ *
+ * @cssprop {String} --back-top-position - The positioning context for the back-to-top button
+ * @cssprop {String} --back-top-bottom - The distance from the bottom edge of the viewport
+ * @cssprop {String} --back-top-right - The distance from the right edge of the viewport
+ * @cssprop {String} --back-top-z-index - The stacking order above other page content
+ * @cssprop {String} --back-top-opacity - The base opacity when visible
+ * @cssprop {String} --back-top-visibility - The visibility state control
+ * @cssprop {String} --back-top-transition-property - The CSS properties to animate during state changes
+ * @cssprop {String} --back-top-transition-duration - The duration of show/hide transitions
+ * @cssprop {String} --back-top-transition-timing-function - The easing function for animations
+ *
+ * @dependency {FloatingActionButtonElement} - Floating action button for scroll trigger
+ *
+ * @fires restored {RestoredEvent} - Fired when scroll position has been restored to target (top or bottom)
+ *
+ * @example
+ * Basic back-to-top button (default):
+ * ```html
+ * <mosaik-back-top></mosaik-back-top>
+ * ```
+ *
+ * @example
+ * Configured for scrolling to bottom with custom offset:
+ * ```html
+ * <mosaik-back-top offset="200" to="bottom"></mosaik-back-top>
+ * ```
+ *
+ * @example
+ * Attached to a specific scrollable container:
+ * ```html
+ * <div id="scrollContainer" style="height: 400px; overflow-y: auto;">
+ *   <!-- Long content -->
+ *   <mosaik-back-top control="scrollContainer"></mosaik-back-top>
+ * </div>
+ * ```
  *
  * @public
  */
@@ -60,6 +113,8 @@ let BackTopElement = class BackTopElement extends Themeable(Attachable(CustomEle
     }
     /**
      * Gets or sets the `offset` property.
+     * The scroll offset threshold (in pixels) after which the back-to-top button becomes visible.
+     * The default value is 120 pixels.
      *
      * @public
      * @attr
@@ -75,6 +130,8 @@ let BackTopElement = class BackTopElement extends Themeable(Attachable(CustomEle
     }
     /**
      * Gets or sets the `to` property.
+     * Specifies the scroll destination: 'top' scrolls to the beginning, 'bottom' scrolls to the end.
+     * The default value is 'top'.
      *
      * @public
      * @attr
@@ -90,6 +147,7 @@ let BackTopElement = class BackTopElement extends Themeable(Attachable(CustomEle
     }
     /**
      * Returns the `position` property.
+     * The current scroll position as a percentage (0-100) of the total scrollable height.
      *
      * @public
      * @readonly
@@ -98,7 +156,7 @@ let BackTopElement = class BackTopElement extends Themeable(Attachable(CustomEle
         return this._position;
     }
     /**
-     * Called when back to top is restored.
+     * Called when the scroll position has been restored to the target location.
      * Provides reference to `{@link IEventDetail}` as event detail.
      *
      * @public

package/Controls/Components/Misc/BackTop/BackTopElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackTopElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/BackTop/BackTopElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BackTopElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/BackTop/BackTopElement.ts"],"names":[],"mappings":"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"}

package/Controls/Components/Misc/CookieConsent/CookiesConsentElement.d.ts

@@ -1,20 +1,89 @@
 import { IEventDetail, IEventEmitter } from '@breadstone/mosaik-elements';
 import { type IAnimatable } from '../../../Behaviors/Animatable';
 import { CustomElement } from '../../Abstracts/CustomElement';
-import type { ICookiesConsentElementEvents } from './ICookiesConsentElementEvents';
 import type { ICookiesConsentElementProps } from './ICookiesConsentElementProps';
 import { CookiesConsentElementIntl } from './Intl/CookiesConsentElementIntl';
 declare const CookiesConsentElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Animatable").IAnimatableProps & IAnimatable) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Elevatable").IElevatableProps) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
- * The `{@link CookiesConsentElement}` element.
+ * CookiesConsent - A configurable notification banner for managing user cookie consent and privacy preferences.
  *
- * @fires accepted - Called when the user accepts the cookies disclaimer.
- * @fires rejected - Called when the user rejects the cookies disclaimer.
- * @fires detailed - Called when the user wants to see the detailed cookies disclaimer.
+ * @description
+ * The CookiesConsent component provides a comprehensive, GDPR-compliant interface for informing users
+ * about cookie usage and capturing their consent preferences. It presents an elevated banner with
+ * customizable messaging, configurable action buttons for accepting or dismissing the disclaimer,
+ * and intelligent state management to track user responses. The component features smooth fade-in
+ * and fade-slide animations, internationalization support through the IntlController, and flexible
+ * positioning capabilities. It can be configured to show or hide accept/dismiss buttons independently,
+ * making it adaptable to various compliance requirements and user experience patterns. The component
+ * automatically animates out when users interact with the consent options, providing a polished
+ * and professional privacy management experience.
+ *
+ * @name CookiesConsent
+ * @element mosaik-cookies-consent
+ * @category Misc
+ *
+ * @slot actions - Custom action buttons to override or extend the default accept/dismiss buttons
+ *
+ * @csspart banner - The banner container element displaying the cookie consent message
+ *
+ * @cssprop {String} --cookies-consent-position - The positioning context for the consent banner
+ * @cssprop {String} --cookies-consent-bottom - The distance from the bottom edge of the viewport
+ * @cssprop {String} --cookies-consent-left - The distance from the left edge of the viewport
+ * @cssprop {String} --cookies-consent-right - The distance from the right edge of the viewport
+ * @cssprop {String} --cookies-consent-width - The width of the consent banner
+ * @cssprop {String} --cookies-consent-z-index - The stacking order above other page content
+ * @cssprop {String} --cookies-consent-margin - The outer spacing around the consent banner
+ *
+ * @dependency {BannerElement} - Banner container for the consent message and actions
+ * @dependency {ButtonElement} - Action buttons for accept and dismiss operations
+ *
+ * @fires cookiesAccepted {CookiesAcceptedEvent} - Fired when the user accepts the cookies disclaimer by clicking the accept button
+ * @fires cookiesDismissed {CookiesDismissedEvent} - Fired when the user dismisses the cookies disclaimer by clicking the dismiss button
+ *
+ * @example
+ * Basic cookie consent banner (shows by default):
+ * ```html
+ * <mosaik-cookies-consent acceptable dismissable></mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * Cookie consent with only accept button:
+ * ```html
+ * <mosaik-cookies-consent acceptable></mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * Hidden after user has already accepted:
+ * ```html
+ * <mosaik-cookies-consent
+ *   acceptable
+ *   dismissable
+ *   has-accepted-cookies>
+ * </mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * With elevated appearance:
+ * ```html
+ * <mosaik-cookies-consent
+ *   acceptable
+ *   dismissable
+ *   elevation="high">
+ * </mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * With custom action buttons:
+ * ```html
+ * <mosaik-cookies-consent>
+ *   <mosaik-button slot="actions" label="Learn More" variant="secondary"></mosaik-button>
+ *   <mosaik-button slot="actions" label="Accept All" variant="primary"></mosaik-button>
+ * </mosaik-cookies-consent>
+ * ```
  *
  * @public
  */
-export declare class CookiesConsentElement extends CookiesConsentElement_base implements ICookiesConsentElementProps, ICookiesConsentElementEvents, IAnimatable {
+export declare class CookiesConsentElement extends CookiesConsentElement_base implements ICookiesConsentElementProps, IAnimatable {
     private readonly _intl;
     private readonly _accepted;
     private readonly _dismissed;
@@ -36,7 +105,8 @@ export declare class CookiesConsentElement extends CookiesConsentElement_base im
     static get is(): string;
     /**
      * Gets or sets the `hasAcceptedCookies` property.
-     * Whether the user has already accepted the cookies disclaimer.
+     * Indicates whether the user has already accepted the cookies disclaimer.
+     * When true, the consent banner is hidden. The default value is false.
      *
      * @public
      * @attr
@@ -45,6 +115,8 @@ export declare class CookiesConsentElement extends CookiesConsentElement_base im
     set hasAcceptedCookies(value: boolean);
     /**
      * Gets or sets the `acceptable` property.
+     * Controls whether the accept button is displayed in the consent banner.
+     * The default value is false.
      *
      * @public
      * @attr
@@ -53,6 +125,8 @@ export declare class CookiesConsentElement extends CookiesConsentElement_base im
     set acceptable(value: boolean);
     /**
      * Gets or sets the `dismissable` property.
+     * Controls whether the dismiss button is displayed in the consent banner.
+     * The default value is false.
      *
      * @public
      * @attr
@@ -60,25 +134,26 @@ export declare class CookiesConsentElement extends CookiesConsentElement_base im
     get dismissable(): boolean;
     set dismissable(value: boolean);
     /**
-     * Called when the cookies disclaimer is accepted.
+     * Called when the user accepts the cookies disclaimer.
      * Provides reference to `{@link IEventDetail}` as event detail.
      *
      * @public
      * @readonly
      * @eventProperty
      */
-    get accepted(): IEventEmitter<IEventDetail<this>>;
+    get accepted(): IEventEmitter<IEventDetail>;
     /**
-     * Called when the cookies disclaimer is rejected.
+     * Called when the user dismisses the cookies disclaimer.
      * Provides reference to `{@link IEventDetail}` as event detail.
      *
      * @public
      * @readonly
      * @eventProperty
      */
-    get dismissed(): IEventEmitter<IEventDetail<this>>;
+    get dismissed(): IEventEmitter<IEventDetail>;
     /**
      * Returns the `intl` property.
+     * Provides access to the internationalization controller for localized messages.
      *
      * @public
      * @readonly
@@ -135,11 +210,6 @@ declare global {
     interface HTMLElementTagNameMap {
         'mosaik-cookies-consent': CookiesConsentElement;
     }
-    interface HTMLElementEventMap {
-        accepted: CustomEvent<IEventDetail>;
-        rejected: CustomEvent<IEventDetail>;
-        detailed: CustomEvent<IEventDetail>;
-    }
 }
 export {};
 //# sourceMappingURL=CookiesConsentElement.d.ts.map

package/Controls/Components/Misc/CookieConsent/CookiesConsentElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CookiesConsentElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/CookieConsent/CookiesConsentElement.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEnG,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAI7E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;;AAQ7E;;;;;;;;GAQG;AACH,qBAaa,qBACT,SAAQ,0BACR,YAAW,2BAA2B,EAAE,4BAA4B,EAAE,WAAW;IAIjF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,YAAY,CAAU;IAM9B;;OAEG;;IAoBH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;;OAMG;IACH,IAIW,kBAAkB,IAAI,OAAO,CAEvC;IAED,IAAW,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAK3C;IAED;;;;;OAKG;IACH,IAIW,UAAU,IAAI,OAAO,CAE/B;IAED,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAKnC;IAED;;;;;OAKG;IACH,IAIW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,OAAO,EAKpC;IAED;;;;;;;OAOG;IACH,IACW,QAAQ,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAEvD;IAED;;;;;;;OAOG;IACH,IACW,SAAS,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAExD;IAED;;;;;OAKG;IACH,IAAW,IAAI,IAAI,yBAAyB,CAE3C;IAMD;;;OAGG;IACa,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpD;;;OAGG;IACa,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInD;;;OAGG;IACa,oBAAoB,IAAI,IAAI;IAI5C;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQrC;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQtC;;;OAGG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,SAAS,IAAI,IAAI;CAM3B;AAED;;EAEE;AACF,yBAAiB,qBAAqB,CAAC;IACnC,KAAY,KAAK,GAAG,2BAA2B,CAAC;CACnD;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,wBAAwB,EAAE,qBAAqB,CAAC;KACnD;IAED,UAAU,mBAAmB;QACzB,QAAQ,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;QACpC,QAAQ,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;QACpC,QAAQ,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;KACvC;CACJ"}
+{"version":3,"file":"CookiesConsentElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/CookieConsent/CookiesConsentElement.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAInG,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAK7E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;;AAO7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,qBAaa,qBACT,SAAQ,0BACR,YAAW,2BAA2B,EAAE,WAAW;IAInD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,YAAY,CAAU;IAM9B;;OAEG;;IAoBH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;;;OAOG;IACH,IAIW,kBAAkB,IAAI,OAAO,CAEvC;IAED,IAAW,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAK3C;IAED;;;;;;;OAOG;IACH,IAIW,UAAU,IAAI,OAAO,CAE/B;IAED,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAKnC;IAED;;;;;;;OAOG;IACH,IAIW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,OAAO,EAKpC;IAED;;;;;;;OAOG;IACH,IACW,QAAQ,IAAI,aAAa,CAAC,YAAY,CAAC,CAEjD;IAED;;;;;;;OAOG;IACH,IACW,SAAS,IAAI,aAAa,CAAC,YAAY,CAAC,CAElD;IAED;;;;;;OAMG;IACH,IAAW,IAAI,IAAI,yBAAyB,CAE3C;IAMD;;;OAGG;IACa,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpD;;;OAGG;IACa,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInD;;;OAGG;IACa,oBAAoB,IAAI,IAAI;IAI5C;;;;OAIG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQrC;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAQtC;;;OAGG;IACI,QAAQ,IAAI,IAAI;IAIvB;;;OAGG;IACI,SAAS,IAAI,IAAI;CAM3B;AAED;;EAEE;AACF,yBAAiB,qBAAqB,CAAC;IACnC,KAAY,KAAK,GAAG,2BAA2B,CAAC;CACnD;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,wBAAwB,EAAE,qBAAqB,CAAC;KACnD;CACJ"}

package/Controls/Components/Misc/CookieConsent/CookiesConsentElement.js

@@ -8,12 +8,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { fadeOut, fadeSlideIn } from '../../../../Animations/Presets/Fade';
-import { Emit } from '../../../../Events/Decorators/EmitDecorator';
 import { HTMLElementEventEmitter } from '@breadstone/mosaik-elements';
+import { fadeOut, fadeSlideIn } from '../../../../Animations/Presets/Fade';
+import { Emit } from '../../../../events/Decorators/EmitDecorator';
 import { IntlController } from '../../../../Intl/IntlController';
 import { Animatable } from '../../../Behaviors/Animatable';
 import { Elevatable } from '../../../Behaviors/Elevatable';
+import { Themeable } from '../../../Behaviors/Themeable';
 import { Attribute } from '../../../Decorators/AttributeDecorator';
 import { Component } from '../../../Decorators/ComponentDecorator';
 import { CustomElement } from '../../Abstracts/CustomElement';
@@ -21,17 +22,86 @@ import { ButtonElement } from '../../Buttons/Button/ButtonElement';
 import { BannerElement } from '../../Grouping/Banner/BannerElement';
 import { cookiesConsentElementTemplate } from './CookiesConsentElementTemplate';
 import { CookiesConsentElementIntl } from './Intl/CookiesConsentElementIntl';
+import { cookiesConsentElementCosmopolitanStyle } from './Themes/CookiesConsentElement.Cosmopolitan';
 import { cookiesConsentElementJoyStyle } from './Themes/CookiesConsentElement.Joy';
 import { cookiesConsentElementMemphisStyle } from './Themes/CookiesConsentElement.Memphis';
-import { cookiesConsentElementCosmopolitanStyle } from './Themes/CookiesConsentElement.Cosmopolitan';
-import { Themeable } from '../../../Behaviors/Themeable';
 // #endregion
 /**
- * The `{@link CookiesConsentElement}` element.
+ * CookiesConsent - A configurable notification banner for managing user cookie consent and privacy preferences.
+ *
+ * @description
+ * The CookiesConsent component provides a comprehensive, GDPR-compliant interface for informing users
+ * about cookie usage and capturing their consent preferences. It presents an elevated banner with
+ * customizable messaging, configurable action buttons for accepting or dismissing the disclaimer,
+ * and intelligent state management to track user responses. The component features smooth fade-in
+ * and fade-slide animations, internationalization support through the IntlController, and flexible
+ * positioning capabilities. It can be configured to show or hide accept/dismiss buttons independently,
+ * making it adaptable to various compliance requirements and user experience patterns. The component
+ * automatically animates out when users interact with the consent options, providing a polished
+ * and professional privacy management experience.
+ *
+ * @name CookiesConsent
+ * @element mosaik-cookies-consent
+ * @category Misc
+ *
+ * @slot actions - Custom action buttons to override or extend the default accept/dismiss buttons
+ *
+ * @csspart banner - The banner container element displaying the cookie consent message
+ *
+ * @cssprop {String} --cookies-consent-position - The positioning context for the consent banner
+ * @cssprop {String} --cookies-consent-bottom - The distance from the bottom edge of the viewport
+ * @cssprop {String} --cookies-consent-left - The distance from the left edge of the viewport
+ * @cssprop {String} --cookies-consent-right - The distance from the right edge of the viewport
+ * @cssprop {String} --cookies-consent-width - The width of the consent banner
+ * @cssprop {String} --cookies-consent-z-index - The stacking order above other page content
+ * @cssprop {String} --cookies-consent-margin - The outer spacing around the consent banner
+ *
+ * @dependency {BannerElement} - Banner container for the consent message and actions
+ * @dependency {ButtonElement} - Action buttons for accept and dismiss operations
+ *
+ * @fires cookiesAccepted {CookiesAcceptedEvent} - Fired when the user accepts the cookies disclaimer by clicking the accept button
+ * @fires cookiesDismissed {CookiesDismissedEvent} - Fired when the user dismisses the cookies disclaimer by clicking the dismiss button
+ *
+ * @example
+ * Basic cookie consent banner (shows by default):
+ * ```html
+ * <mosaik-cookies-consent acceptable dismissable></mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * Cookie consent with only accept button:
+ * ```html
+ * <mosaik-cookies-consent acceptable></mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * Hidden after user has already accepted:
+ * ```html
+ * <mosaik-cookies-consent
+ *   acceptable
+ *   dismissable
+ *   has-accepted-cookies>
+ * </mosaik-cookies-consent>
+ * ```
+ *
+ * @example
+ * With elevated appearance:
+ * ```html
+ * <mosaik-cookies-consent
+ *   acceptable
+ *   dismissable
+ *   elevation="high">
+ * </mosaik-cookies-consent>
+ * ```
  *
- * @fires accepted - Called when the user accepts the cookies disclaimer.
- * @fires rejected - Called when the user rejects the cookies disclaimer.
- * @fires detailed - Called when the user wants to see the detailed cookies disclaimer.
+ * @example
+ * With custom action buttons:
+ * ```html
+ * <mosaik-cookies-consent>
+ *   <mosaik-button slot="actions" label="Learn More" variant="secondary"></mosaik-button>
+ *   <mosaik-button slot="actions" label="Accept All" variant="primary"></mosaik-button>
+ * </mosaik-cookies-consent>
+ * ```
  *
  * @public
  */
@@ -56,8 +126,8 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
         this._hasAcceptedCookies = false;
         this._acceptable = false;
         this._dismissable = false;
-        this._accepted = new HTMLElementEventEmitter(this, 'accepted');
-        this._dismissed = new HTMLElementEventEmitter(this, 'dismissed');
+        this._accepted = new HTMLElementEventEmitter(this, 'cookiesAccepted');
+        this._dismissed = new HTMLElementEventEmitter(this, 'cookiesDismissed');
     }
     // #endregion
     // #region Properties
@@ -74,7 +144,8 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
     }
     /**
      * Gets or sets the `hasAcceptedCookies` property.
-     * Whether the user has already accepted the cookies disclaimer.
+     * Indicates whether the user has already accepted the cookies disclaimer.
+     * When true, the consent banner is hidden. The default value is false.
      *
      * @public
      * @attr
@@ -90,6 +161,8 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
     }
     /**
      * Gets or sets the `acceptable` property.
+     * Controls whether the accept button is displayed in the consent banner.
+     * The default value is false.
      *
      * @public
      * @attr
@@ -105,6 +178,8 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
     }
     /**
      * Gets or sets the `dismissable` property.
+     * Controls whether the dismiss button is displayed in the consent banner.
+     * The default value is false.
      *
      * @public
      * @attr
@@ -119,7 +194,7 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
         }
     }
     /**
-     * Called when the cookies disclaimer is accepted.
+     * Called when the user accepts the cookies disclaimer.
      * Provides reference to `{@link IEventDetail}` as event detail.
      *
      * @public
@@ -130,7 +205,7 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
         return this._accepted;
     }
     /**
-     * Called when the cookies disclaimer is rejected.
+     * Called when the user dismisses the cookies disclaimer.
      * Provides reference to `{@link IEventDetail}` as event detail.
      *
      * @public
@@ -142,6 +217,7 @@ let CookiesConsentElement = class CookiesConsentElement extends Themeable(Animat
     }
     /**
      * Returns the `intl` property.
+     * Provides access to the internationalization controller for localized messages.
      *
      * @public
      * @readonly
@@ -234,12 +310,12 @@ __decorate([
     __metadata("design:paramtypes", [Boolean])
 ], CookiesConsentElement.prototype, "dismissable", null);
 __decorate([
-    Emit({ eventName: 'accepted' }),
+    Emit({ eventName: 'cookiesAccepted' }),
     __metadata("design:type", Object),
     __metadata("design:paramtypes", [])
 ], CookiesConsentElement.prototype, "accepted", null);
 __decorate([
-    Emit({ eventName: 'dismissed' }),
+    Emit({ eventName: 'cookiesDismissed' }),
     __metadata("design:type", Object),
     __metadata("design:paramtypes", [])
 ], CookiesConsentElement.prototype, "dismissed", null);

package/Controls/Components/Misc/CookieConsent/CookiesConsentElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"CookiesConsentElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/CookieConsent/CookiesConsentElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CookiesConsentElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/CookieConsent/CookiesConsentElement.ts"],"names":[],"mappings":"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"}

package/Controls/Components/Misc/LightChain/LightChainElement.d.ts

@@ -2,7 +2,87 @@ import { CustomElement } from '../../Abstracts/CustomElement';
 import type { ILightChainElementProps } from './ILightChainElementProps';
 declare const LightChainElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
- * The `{@link LightChainElement}` element.
+ * LightChain - A decorative animated string of lights effect for festive and ambient visual enhancement.
+ *
+ * @description
+ * The LightChain component creates an animated sequence of colorful light bulbs that simulate a string
+ * of holiday or decorative lights. It generates a configurable number of individual light elements with
+ * alternating colors and twinkling animation effects. The component supports three operational states:
+ * 'on' for continuous illumination, 'off' for static display, and 'auto' for automated animation cycles.
+ * Each light bulb is rendered with distinct styling based on its position in the sequence, creating
+ * a realistic and visually appealing lighting pattern. The component can be disabled to pause animations,
+ * making it ideal for seasonal decorations, festive page headers, celebration announcements, or any
+ * interface requiring whimsical animated accent elements. Based on CSS animations inspired by classic
+ * holiday light displays.
+ *
+ * @name LightChain
+ * @element mosaik-light-chain
+ * @category Misc
+ *
+ * @slot - Default slot (currently unused, lights are generated programmatically)
+ *
+ * @csspart root - The root container element wrapping the entire light chain
+ * @csspart blub - Individual light bulb element in the chain (repeated based on count)
+ *
+ * @cssprop {String} --light-chain-display - The display mode for the light chain container
+ * @cssprop {String} --light-chain-position - The positioning context for the light chain
+ * @cssprop {String} --light-chain-width - The total width of the light chain
+ * @cssprop {String} --light-chain-height - The total height of the light chain
+ * @cssprop {String} --light-chain-padding - The inner spacing within the container
+ * @cssprop {String} --light-chain-overflow - The overflow behavior for the container
+ * @cssprop {String} --light-chain-list-style - The list style type for the bulb list
+ * @cssprop {String} --light-chain-list-padding - The padding for the bulb list
+ * @cssprop {String} --light-chain-list-margin - The margin for the bulb list
+ * @cssprop {String} --light-chain-bulb-display - The display mode for individual bulbs
+ * @cssprop {String} --light-chain-bulb-position - The positioning for individual bulbs
+ * @cssprop {String} --light-chain-bulb-width - The width of each light bulb
+ * @cssprop {String} --light-chain-bulb-height - The height of each light bulb
+ * @cssprop {String} --light-chain-bulb-border-radius - The corner rounding for bulbs
+ * @cssprop {String} --light-chain-bulb-margin - The spacing between bulbs
+ * @cssprop {String} --light-chain-bulb-first-background - The background color for first bulb pattern
+ * @cssprop {String} --light-chain-bulb-first-box-shadow - The glow effect for first bulb pattern
+ * @cssprop {String} --light-chain-bulb-first-animation-name - The animation keyframes for first bulb
+ * @cssprop {String} --light-chain-bulb-first-animation-duration - The animation duration for first bulb
+ * @cssprop {String} --light-chain-bulb-first-animation-timing-function - The easing for first bulb animation
+ * @cssprop {String} --light-chain-bulb-first-animation-iteration-count - The animation repeat count for first bulb
+ * @cssprop {String} --light-chain-bulb-second-background - The background color for second bulb pattern
+ * @cssprop {String} --light-chain-bulb-second-box-shadow - The glow effect for second bulb pattern
+ * @cssprop {String} --light-chain-bulb-second-animation-name - The animation keyframes for second bulb
+ * @cssprop {String} --light-chain-bulb-second-animation-duration - The animation duration for second bulb
+ * @cssprop {String} --light-chain-bulb-second-animation-timing-function - The easing for second bulb animation
+ * @cssprop {String} --light-chain-bulb-second-animation-iteration-count - The animation repeat count for second bulb
+ * @cssprop {String} --light-chain-bulb-third-background - The background color for third bulb pattern
+ * @cssprop {String} --light-chain-bulb-third-box-shadow - The glow effect for third bulb pattern
+ * @cssprop {String} --light-chain-bulb-third-animation-name - The animation keyframes for third bulb
+ * @cssprop {String} --light-chain-bulb-third-animation-duration - The animation duration for third bulb
+ * @cssprop {String} --light-chain-bulb-third-animation-timing-function - The easing for third bulb animation
+ * @cssprop {String} --light-chain-bulb-third-animation-iteration-count - The animation repeat count for third bulb
+ *
+ * @example
+ * Basic light chain with default count (56 lights):
+ * ```html
+ * <mosaik-light-chain></mosaik-light-chain>
+ * ```
+ *
+ * @example
+ * Light chain with custom count:
+ * ```html
+ * <mosaik-light-chain count="100"></mosaik-light-chain>
+ * ```
+ *
+ * @example
+ * Light chain in different states:
+ * ```html
+ * <mosaik-light-chain state="on"></mosaik-light-chain>
+ * <mosaik-light-chain state="off"></mosaik-light-chain>
+ * <mosaik-light-chain state="auto"></mosaik-light-chain>
+ * ```
+ *
+ * @example
+ * Disabled light chain (paused animations):
+ * ```html
+ * <mosaik-light-chain disabled></mosaik-light-chain>
+ * ```
  *
  * @public
  */
@@ -24,6 +104,8 @@ export declare class LightChainElement extends LightChainElement_base implements
     static get is(): string;
     /**
      * Gets or sets the `count` property.
+     * The number of light bulbs to render in the chain.
+     * The default value is 56.
      *
      * @public
      * @attr
@@ -32,6 +114,9 @@ export declare class LightChainElement extends LightChainElement_base implements
     set count(value: number);
     /**
      * Gets or sets the `state` property.
+     * Controls the operational state of the light chain: 'on' for continuous illumination,
+     * 'off' for static display, or 'auto' for automated animation cycles.
+     * The default value is 'off'.
      *
      * @public
      * @attr

package/Controls/Components/Misc/LightChain/LightChainElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LightChainElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/LightChain/LightChainElement.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;;AASzE;;;;GAIG;AACH,qBAUa,iBACT,SAAQ,sBACR,YAAW,uBAAuB;IAIlC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAwB;IAMtC;;OAEG;;IAYH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;OAKG;IACH,IACW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED;;;;;OAKG;IACH,IACW,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,MAAM,CAExC;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,EAK5C;CAIJ;AAED;;EAEE;AACF,yBAAiB,iBAAiB,CAAC;IAC/B,KAAY,KAAK,GAAG,uBAAuB,CAAC;CAC/C;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,oBAAoB,EAAE,iBAAiB,CAAC;KAC3C;CACJ"}
+{"version":3,"file":"LightChainElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Misc/LightChain/LightChainElement.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;;AASzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,qBAUa,iBACT,SAAQ,sBACR,YAAW,uBAAuB;IAIlC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAwB;IAMtC;;OAEG;;IAYH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;;;OAOG;IACH,IACW,KAAK,IAAI,MAAM,CAEzB;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED;;;;;;;;OAQG;IACH,IACW,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,MAAM,CAExC;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,EAK5C;CAIJ;AAED;;EAEE;AACF,yBAAiB,iBAAiB,CAAC;IAC/B,KAAY,KAAK,GAAG,uBAAuB,CAAC;CAC/C;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,oBAAoB,EAAE,iBAAiB,CAAC;KAC3C;CACJ"}