wj-elements 0.1.151 → 0.1.152

package/dist/packages/wje-avatar/avatar.element.d.ts

@@ -0,0 +1,76 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents an Avatar element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/avatar
+ * @status stable
+ * @augments WJElement
+ * @slot - The avatar main content.
+ * @csspart native - The component's native wrapper.
+ * @cssproperty --wje-avatar-width;
+ * @cssproperty --wje-avatar-height;
+ * @cssproperty --wje-avatar-font-size;
+ * @cssproperty --wje-avatar-font-weight;
+ * @cssproperty --wje-avatar-color;
+ * @cssproperty --wje-avatar-background-color;
+ * @cssproperty --wje-avatar-border-radius;
+ * @cssproperty --wje-avatar-border-color;
+ * @cssproperty --wje-avatar-border-width;
+ * @cssproperty --wje-avatar-border-style;
+ * @tag wje-avatar
+ */
+export default class Avatar extends WJElement {
+    /**
+     * Getter for cssStyleSheet.
+     * @returns {string} styles
+     */
+    static get cssStyleSheet(): string;
+    /**
+     * Returns the list of attributes to observe for changes.
+     * @static
+     * @returns {Array<string>}
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Sets the value of the 'label' attribute for the element.
+     * @param {string} value The new value to be set for the 'label' attribute.
+     */
+    set label(value: string);
+    /**
+     * Retrieves the value of the 'label' attribute for the element.
+     * If the attribute is not set, it defaults to an empty string.
+     * @returns {string} The value of the 'label' attribute or an empty string if not defined.
+     */
+    get label(): string;
+    /**
+     * Sets the value of initials for the element by updating
+     * the 'initials' attribute with the provided value.
+     * @param {string} value The value to be set as the initials.
+     */
+    set initials(value: boolean);
+    /**
+     * Retrieves the value of the 'initials' attribute if it exists.
+     * @returns {boolean} Returns true if the 'initials' attribute is present, otherwise false.
+     */
+    get initials(): boolean;
+    /**
+     * Sets the size attribute for the element.
+     * @param {string | number} value The value to set for the size attribute.
+     */
+    set size(value: string);
+    /**
+     * Retrieves the size attribute of the element. If the size attribute
+     * is not defined, it returns the default value 'medium'.
+     * @returns {string} The size value of the element or 'medium' if not specified.
+     */
+    get size(): string;
+    /**
+     * Method to draw the avatar element and return a document fragment.
+     * @returns {object} fragment - The document fragment
+     */
+    draw(): object;
+    /**
+     * Method to check if the avatar is an image.
+     * @returns {boolean} - True if the avatar is an image, false otherwise
+     */
+    isImage(): boolean;
+}

package/dist/packages/wje-avatar/avatar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/wje-avatar/service/service.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Generates an HSL color value based on the input text.
+ * @param {string} text The input text to generate the HSL color.
+ * @param {number} [s] The saturation value (in percentage) for the HSL color.
+ * @param {number} [l] The lightness value (in percentage) for the HSL color.
+ * @returns {string} - The HSL color string in the format `hsl(h, s%, l%)`.
+ * @description
+ * This function computes a hash from the input text and uses it to generate
+ * a hue value. The hue is combined with the provided saturation and lightness
+ * values to create an HSL color. This can be useful for consistently assigning
+ * colors based on text input, such as for avatars or tags.
+ * @example
+ * // Returns 'hsl(180, 40%, 65%)'
+ * getHsl('example');
+ * @example
+ * // Returns 'hsl(300, 50%, 70%)'
+ * getHsl('test', 50, 70);
+ */
+export function getHsl(text: string, s?: number, l?: number): string;
+/**
+ * Generates initials from a given string.
+ * @param {string} string The input string, typically a full name.
+ * @param {number} [length] The desired number of initials (default is 2).
+ * @returns {string} - The generated initials in uppercase.
+ * @description
+ * This function takes a string, splits it by spaces, and generates initials.
+ * It always includes the first character of the first word. If the input string
+ * contains more than one word and the `length` parameter is greater than 1, it
+ * also includes the first character of the last word.
+ * @example
+ * // Returns 'JD'
+ * getInitials('John Doe');
+ * @example
+ * // Returns 'J'
+ * getInitials('John');
+ * @example
+ * // Returns 'JM'
+ * getInitials('John Michael Doe', 2);
+ */
+export function getInitials(string: string, length?: number): string;

package/dist/packages/wje-badge/badge.d.ts

@@ -0,0 +1,2 @@
+import { default as Badge } from './badge.element.js';
+export default Badge;

package/dist/packages/wje-badge/badge.element.d.ts

@@ -0,0 +1,35 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents a Badge element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/badge
+ * @status stable
+ * @augments WJElement
+ * @attribute {string} color - The color of the badge element. Accepts any valid string primary, secondary, success, danger, warning, info, default.
+ * @slot - The badge's main content.
+ * @csspart native - The component's native wrapper.
+ * @cssproperty [--wje-badge-border-radius=var(--wje-border-radius-pill)] - Border radius of the badge element.
+ * @tag wje-badge
+ */
+export default class Badge extends WJElement {
+    /**
+     * Retrieves the CSS stylesheet for the Badge element.
+     * @static
+     * @returns {CSSStyleSheet} The CSS styles associated with the Badge.
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Specifies the attributes to observe for changes.
+     * @static
+     * @returns {Array<string>} An array containing the names of attributes to observe.
+     * @example
+     * static get observedAttributes() {
+     *   return ['color'];
+     * }
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Creates the DOM structure for the Badge element.
+     * @returns {DocumentFragment} A document fragment containing the Badge's structure.
+     */
+    draw(): DocumentFragment;
+}

package/dist/packages/wje-badge/badge.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/wje-breadcrumb/breadcrumb.d.ts

@@ -0,0 +1,2 @@
+import { default as Breadcrumb } from './breadcrumb.element.js';
+export default Breadcrumb;

package/dist/packages/wje-breadcrumb/breadcrumb.element.d.ts

@@ -0,0 +1,80 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents a Breadcrumb element, extending the WJElement class. It provides a navigational aid in user interfaces, displaying the current location within a hierarchy.
+ * @documentation https://elements.webjet.sk/components/breadcrumb
+ * @status stable
+ * @augments WJElement
+ * @slot - The main content of the breadcrumb.
+ * @slot start - Slot for content at the start of the breadcrumb.
+ * @slot end - Slot for content at the end of the breadcrumb.
+ * @slot separator - Slot for a custom separator between breadcrumb items.
+ * @csspart native - The native wrapper of the breadcrumb component.
+ * @csspart separator - The separator between breadcrumb items.
+ * @cssproperty [--wje-breadcrumb-a=var(--wje-color-contrast-8)] - The color of the breadcrumb text.
+ * @cssproperty [--wje-breadcrumb-a-hover=var(--wje-color-contrast-6)] - The color of the breadcrumb separator line.
+ * @tag wje-breadcrumb
+ */
+export default class Breadcrumb extends WJElement {
+    /**
+     * Get CSS stylesheet for the Breadcrumb element.
+     * @static
+     * @returns {object} styles - The CSS styles
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Get observed attributes for the Breadcrumb element.
+     * @static
+     * @returns {Array<string>} - The observed attributes array for the Breadcrumb element.
+     */
+    static get observedAttributes(): string[];
+    _showSeparator: boolean;
+    showCollapsedIndicator: boolean;
+    /**
+     * Set show separator flag.
+     * @param {boolean} value The value to set
+     */
+    set showSeparator(value: boolean);
+    /**
+     * Get show separator flag.
+     * @returns {boolean} showSeparator - The show separator flag
+     */
+    get showSeparator(): boolean;
+    /**
+     * Set collapsed variant.
+     * @param {string} value The value to set
+     */
+    set collapsedVariant(value: string);
+    /**
+     * Get collapsed variant.
+     * @returns {string} The collapsed variant value in uppercase.
+     */
+    get collapsedVariant(): string;
+    _collapsedVariant: string;
+    /**
+     * Attribute changed callback method.
+     * @returns {boolean} false - Always returns false
+     */
+    attributeChangedCallback(name: any, oldValue: any, newValue: any): boolean;
+    active: boolean;
+    /**
+     * Draw method for the Breadcrumb element.
+     * @returns {object} fragment - The document fragment
+     */
+    draw(): object;
+    native: HTMLAnchorElement;
+    /**
+     * Draw collapsed indicator method.
+     * @returns {object} - The collapsed indicator element.
+     */
+    drawCollapsedIndicator(): object;
+    /**
+     * Collapse dropdown button.
+     * @returns {object} dropdown - The dropdown button.
+     */
+    collapseDropdown(): object;
+    /**
+     * Collapse button method.
+     * @returns {object} - The button element.
+     */
+    collapseButton(): object;
+}

package/dist/packages/wje-breadcrumbs/breadcrumbs.d.ts

@@ -0,0 +1,2 @@
+import { default as Breadcrumbs } from './breadcrumbs.element.js';
+export default Breadcrumbs;

package/dist/packages/wje-breadcrumbs/breadcrumbs.element.d.ts

@@ -0,0 +1,97 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents a Breadcrumbs container, extending the WJElement class. It acts as a wrapper for individual breadcrumb elements and manages their behavior, such as collapsing and marking the last breadcrumb.
+ * @documentation https://elements.webjet.sk/components/breadcrumbs
+ * @status stable
+ * @augments WJElement
+ * @slot - The container for breadcrumb elements.
+ * @csspart container - The component's container wrapper.
+ * @attribute {number} max-items - The maximum number of visible breadcrumbs before collapsing.
+ * @attribute {number} items-before-collapse - The number of breadcrumbs to show before the collapsed indicator.
+ * @attribute {number} items-after-collapse - The number of breadcrumbs to show after the collapsed indicator.
+ * @tag wje-breadcrumbs
+ * @example
+ * <!-- Example usage -->
+ * <wje-breadcrumbs max-items="5" items-before-collapse="2" items-after-collapse="2">
+ *   <wje-breadcrumb>Home</wje-breadcrumb>
+ *   <wje-breadcrumb>About</wje-breadcrumb>
+ *   <wje-breadcrumb>Services</wje-breadcrumb>
+ *   <wje-breadcrumb>Portfolio</wje-breadcrumb>
+ *   <wje-breadcrumb>Contact</wje-breadcrumb>
+ * </wje-breadcrumbs>
+ *
+ * <!-- Output: Only the first two and last two breadcrumbs will be visible, with a collapsed indicator in the middle -->
+ */
+export default class Breadcrumbs extends WJElement {
+    /**
+     * Get CSS stylesheet for the Breadcrumbs element.
+     * @static
+     * @returns {object} styles - The CSS styles
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Get observed attributes for the Breadcrumb element.
+     * @static
+     * @returns {Array<string>} - The observed attributes array for the Breadcrumb element.
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Last breadcrumb flag
+     * @type {boolean}
+     */
+    last: boolean;
+    /**
+     * Set variant attribute for the Breadcrumbs element.
+     * @param value
+     */
+    set variant(value: string);
+    /**
+     * Get variant attribute for the Breadcrumbs element.
+     * @returns {string}
+     */
+    get variant(): string;
+    /**
+     * Get items before collapse attribute.
+     * @param {string} value
+     */
+    set maxItems(value: number);
+    /**
+     * Get items before collapse attribute.
+     * @returns {number}
+     */
+    get maxItems(): number;
+    /**
+     * Get items before collapse attribute.
+     * @param value
+     */
+    set itemsBeforeCollapse(value: number);
+    /**
+     * Get items before collapse attribute.
+     * @returns {number}
+     */
+    get itemsBeforeCollapse(): number;
+    /**
+     * Get items after collapse attribute.
+     * @param value
+     */
+    set itemsAfterCollapse(value: number);
+    /**
+     * Get items after collapse attribute.
+     * @returns {number}
+     */
+    get itemsAfterCollapse(): number;
+    /**
+     * Draw method for the Breadcrumbs element.
+     * @returns {object} fragment - The document fragment
+     */
+    draw(): object;
+    /**
+     * After draw method for the Breadcrumbs element.
+     */
+    afterDraw(): void;
+    /**
+     * Get breadcrumbs method.
+     * @returns {Array} - The breadcrumbs array
+     */
+    getBreadcrumbs(): any[];
+}

package/dist/packages/wje-breadcrumbs/breadcrumbs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/wje-button/button.d.ts

@@ -0,0 +1,2 @@
+import { default as Button } from './button.element.js';
+export default Button;

package/dist/packages/wje-button/button.element.d.ts

@@ -0,0 +1,173 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents Button element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/button
+ * @status stable
+ * @augments WJElement
+ * @dependency wje-icon
+ * @slot - The button main content.
+ * @slot icon - The button icon.
+ * @slot caret - The button caret.
+ * @slot start - The button start slot.
+ * @slot end - The button end slot.
+ * @slot toggle - The button toggle slot.
+ * @csspart native - The component's native wrapper.
+ * @cssproperty [--wje-button-background-color=transparent] - Background color of the component;
+ * @cssproperty [--wje-button-border-color=--wje-color-contrast-4] - Border color of the component;
+ * @cssproperty [--wje-button-color=--wje-color-contrast-11] - Color of the component;
+ * @cssproperty [--wje-button-border-radius=--wje-border-radius-medium] - Border radius of the component;
+ * @cssproperty [--wje-button-border-width=1px] - Border width of the component;
+ * @cssproperty [--wje-button-border-style=solid] - Border style of the component;
+ * @cssproperty [--wje-button-border-color=--wje-color-contrast-1] - Border color of the component;
+ * @cssproperty [--wje-button-margin-inline=0] - Margin inline of the component;
+ */
+export default class Button extends WJElement {
+    /**
+     * Get CSS stylesheet for the Button element.
+     * @static
+     * @returns {CSSStyleSheet} styles - The CSS stylesheet for the Button element.
+     */
+    static get cssStyleSheet(): CSSStyleSheet;
+    /**
+     * Get observed attributes for the Button element.
+     * @static
+     * @returns {Array<string>} observedAttributes - The observed attributes array for the Button element.
+     */
+    static get observedAttributes(): string[];
+    /**
+     * @summary A static property that indicates whether the custom element is form-associated or not.
+     * Form-associated custom elements are elements that can participate in form submission.
+     * @type {boolean}
+     */
+    static formAssociated: boolean;
+    internals_: ElementInternals;
+    /**
+     * Dependencies of the Button element.
+     * @type {object}
+     */
+    dependencies: object;
+    /**
+     * Properties of the element Button.
+     * @param value
+     */
+    set color(value: string);
+    /**
+     * Get color of the Button element.
+     * @returns {string|string}
+     */
+    get color(): string;
+    /**
+     * Set variant of the Button element.
+     * @param value
+     */
+    set caret(value: boolean);
+    /**
+     * Get variant of the Button element.
+     * @returns {boolean}
+     */
+    get caret(): boolean;
+    /**
+     * Set variant of the Button element.
+     * @param value
+     */
+    set tooltip(value: boolean);
+    /**
+     * Get variant of the Button element.
+     * @returns {boolean}
+     */
+    get tooltip(): boolean;
+    /**
+     * Set variant of the Button element.
+     * @param value
+     */
+    set dialog(value: any);
+    /**
+     * Get variant of the Button element.
+     * @returns {string|object}
+     */
+    get dialog(): any;
+    /**
+     * Set active state of the Button element.
+     * @param {boolean} value The value to set
+     */
+    set active(value: boolean);
+    /**
+     * Get active state of the Button element.
+     * @returns {boolean} active - The active state
+     */
+    get active(): boolean;
+    /**
+     * Set disabled state of the Button element.
+     * @param {boolean} value The value to set
+     */
+    set disabled(value: boolean);
+    /**
+     * Get disabled state of the Button element.
+     * @returns {boolean} disabled - The disabled state
+     */
+    get disabled(): boolean;
+    /**
+     * Set fill of the Button element.
+     * @param {string} value The value to set
+     */
+    set fill(value: string);
+    /**
+     * Get fill of the Button element.
+     * @returns {string} fill - The fill value
+     */
+    get fill(): string;
+    /**
+     * Set outline state of the Button element.
+     * @param {boolean} value The value to set
+     */
+    set outline(value: boolean);
+    /**
+     * Get outline state of the Button element.
+     * @returns {boolean} outline - The outline state
+     */
+    get outline(): boolean;
+    /**
+     * Set stop propagation state of the Button element.
+     * @param {boolean} value The value to set
+     */
+    set stopPropagation(value: boolean);
+    /**
+     * Get stop propagation state of the Button element.
+     * @returns {boolean} stopPropagation - The stop propagation state
+     */
+    get stopPropagation(): boolean;
+    /**
+     * @summary Callback function that is called when the custom element is associated with a form.
+     * This function sets the internal `_form` property to the associated form.
+     * @param {HTMLFormElement} form The form the custom element is associated with.
+     */
+    formAssociatedCallback(form: HTMLFormElement): void;
+    _form: HTMLFormElement;
+    /**
+     * @summary Callback function that is called when the form-associated state of the custom element changes.
+     * This function updates the 'disabled' attribute of the element based on the new state.
+     * @param {boolean} disabled The new form-associated state.
+     */
+    formDisabledCallback(disabled: boolean): void;
+    /**
+     * Draw method for the Button element.
+     * @returns {object} fragment - The document fragment containing the drawn element.
+     */
+    draw(): object;
+    hasToggle: boolean;
+    slotToggle: HTMLSlotElement;
+    /**
+     * After draw method for the Button element.
+     */
+    afterDraw(): void;
+    unbindRouterLinks: any;
+    /**
+     * Event dialog open method for the Button element.
+     * @param {Event} e The event object
+     */
+    eventDialogOpen: (e: Event) => void;
+    /**
+     * Toggle states method for the Button element.
+     */
+    toggleStates: () => void;
+}

package/dist/packages/wje-button/button.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/packages/wje-button-group/button-group.d.ts

@@ -0,0 +1,2 @@
+import { default as ButtonGroup } from './button-group.element.js';
+export default ButtonGroup;

package/dist/packages/wje-button-group/button-group.element.d.ts

@@ -0,0 +1,39 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary ButtonGroup class
+ * @class
+ * @augments WJElement
+ * @csspart native - The component's native wrapper.
+ * @slot - The button group main content.
+ * @csspart native - The component's native wrapper.
+ */
+export default class ButtonGroup extends WJElement {
+    /**
+     * Get CSS stylesheet for the ButtonGroup element.
+     * @static
+     * @returns {object} styles - The CSS styles
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Get observed attributes for the ButtonGroup element.
+     * @static
+     * @returns {Array<string>} observedAttributes - The observed attributes array
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Draw method for the ButtonGroup element.
+     * @returns {object} fragment - The document fragment
+     */
+    draw(): object;
+    slotElement: HTMLSlotElement;
+    /**
+     * After draw method for the ButtonGroup element.
+     */
+    afterDraw(): void;
+    /**
+     * Find button method to find the button element.
+     * @param {object} el The element
+     * @returns {object} button - The button element
+     */
+    findButton(el: object): object;
+}

package/dist/packages/wje-card/card.d.ts

@@ -0,0 +1,2 @@
+import { default as Card } from './card.element.js';
+export default Card;

package/dist/packages/wje-card/card.element.d.ts

@@ -0,0 +1,29 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents Card element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/card
+ * @status stable
+ * @augments WJElement
+ * @slot - The card main content.
+ * @cssproperty [--wje-card-margin-top=0] - Margin top of the component;
+ * @cssproperty [--wje-card-margin-bottom=1rem] - Margin bottom of the component;
+ * @cssproperty [--wje-card-margin-inline=0] - Margin inline of the component;
+ * @cssproperty [--wje-card-border-color=transparent] - Border color of the component;
+ * @cssproperty [--wje-card-background=#fff] - Background of the component;
+ */
+export default class Card extends WJElement {
+    /**
+     * Get CSS stylesheet for the Card element.
+     * @static
+     * @returns {object} styles - The CSS styles
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Draw method for the Card element.
+     * @param {object} context The context object
+     * @param {object} store The store object
+     * @param {object} params The parameters
+     * @returns {object} fragment - The document fragment
+     */
+    draw(context: object, store: object, params: object): object;
+}

package/dist/packages/wje-card-content/card-content.d.ts

@@ -0,0 +1,2 @@
+import { default as CardContent } from './card-content.element.js';
+export default CardContent;

package/dist/packages/wje-card-content/card-content.element.d.ts

@@ -0,0 +1,22 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents an Card Content element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/card-content
+ * @status stable
+ * @augments WJElement
+ * @slot - The card content main content.
+ * @cssproperty [--wje-card-padding=0] - Padding of the component;
+ */
+export default class CardContent extends WJElement {
+    /**
+     * Get CSS stylesheet for the CardContent element.
+     * @static
+     * @returns {object} styles - The CSS styles for the CardContent element.
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Draw method for the CardContent element.
+     * @returns {object} fragment - The document fragment containing the drawn element.
+     */
+    draw(): object;
+}

package/dist/packages/wje-card-controls/card-controls.d.ts

@@ -0,0 +1,2 @@
+import { default as CardControls } from './card-controls.element.js';
+export default CardControls;

package/dist/packages/wje-card-controls/card-controls.element.d.ts

@@ -0,0 +1,23 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents Card Controls element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/card-controls
+ * @status stable
+ * @augments WJElement
+ * @slot - The card controls main content.
+ * @cssproperty [--wje-card-controls-font-size=11px] - Font size of the component;
+ * @cssproperty [--wje-card-controls-font-family=--wje-font-family-secondary] - Font family of the component;
+ */
+export default class CardControls extends WJElement {
+    /**
+     * Get CSS stylesheet for the CardControls element.
+     * @static
+     * @returns {object} styles - The CSS styles
+     */
+    static get cssStyleSheet(): any;
+    /**
+     * Draw method for the CardControls element.
+     * @returns {object} fragment - The document fragment
+     */
+    draw(): object;
+}

package/dist/packages/wje-card-header/card-header.d.ts

@@ -0,0 +1,2 @@
+import { default as CardHeader } from './card-header.element.js';
+export default CardHeader;