wj-elements 0.1.137 → 0.1.139

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

@@ -0,0 +1,153 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents an Animation element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/animation
+ * @status stable
+ * @augments WJElement
+ * @slot - The animation main content.
+ * @cssproperty --size - The size of the avatar.
+ * @tag wje-animation
+ */
+export default class Animation extends WJElement {
+    /**
+     * Getter for the CSS stylesheet.
+     * @returns {object} The styles for the Animation element.
+     */
+    static get cssStyleSheet(): object;
+    /**
+     * Getter for the observed attributes.
+     * @returns {Array} An array containing the name of the observed attribute.
+     */
+    static get observedAttributes(): any[];
+    _animations: any[];
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set name(value: string);
+    /**
+     * Getter for the name attribute.
+     * @returns {string}
+     */
+    get name(): string;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set duration(value: number);
+    /**
+     * Getter for the name attribute.
+     * @returns {number}
+     */
+    get duration(): number;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set delay(value: number);
+    /**
+     * Getter for the name attribute.
+     * @returns {number}
+     */
+    get delay(): number;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set endDelay(value: number);
+    /**
+     * Getter for the name attribute.
+     * @returns {number}
+     */
+    get endDelay(): number;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set fill(value: string);
+    /**
+     * Getter for the name attribute.
+     * @returns {string}
+     */
+    get fill(): string;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set iterations(value: string | number);
+    /**
+     * Getter for the name attribute.
+     * @returns {string|number}
+     */
+    get iterations(): string | number;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set iterationStart(value: number);
+    /**
+     * Getter for the name attribute.
+     * @returns {number}
+     */
+    get iterationStart(): number;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set direction(value: string);
+    /**
+     * Getter for the name attribute.
+     * @returns {string}
+     */
+    get direction(): string;
+    /**
+     * Setter for the name attribute.
+     * @param value
+     */
+    set easing(value: string);
+    /**
+     * Getter for the name attribute.
+     * @returns {string}
+     */
+    get easing(): string;
+    /**
+     * Setter for the animations property.
+     * @param {Array} value The new value for the animations property.
+     */
+    set animations(value: any[]);
+    /**
+     * Getter for the animations' property.
+     * @returns {Array} The current value of the animations' property.
+     */
+    get animations(): any[];
+    /**
+     * Method to draw the Animation element.
+     * @returns {object} The document fragment containing the drawn element.
+     */
+    draw(): object;
+    slotEl: HTMLSlotElement;
+    /**
+     * Method to perform actions after the Animation element is drawn.
+     * This method destroys any existing animation, fetches a new animations array,
+     * selects the appropriate animation, and applies it to the element.
+     */
+    afterDraw(): Promise<void>;
+    animation: Animation;
+    /**
+     * Method to fetch and parse the animations array from a CSS file.
+     * @returns {Array} An array of animation definitions parsed from the CSS file.
+     */
+    getAnimationsArray(): any[];
+    /**
+     * Method to destroy the current animation.
+     */
+    destroyAnimation(): void;
+    /**
+     * Method to play the current animation.
+     */
+    play(): void;
+    /**
+     * Method to cancel the current animation.
+     */
+    cancel(): void;
+}

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

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

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

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

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

@@ -0,0 +1,31 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents an Aside element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/aside
+ * @status stable
+ * @augments WJElement
+ * @slot - The aside main content.
+ * @cssproperty --wje-aside-width;
+ * @cssproperty --wje-aside-top;
+ * @cssproperty --wje-aside-border-color: var(--wje-border-color);
+ * @cssproperty --wje-aside-border-width;
+ * @cssproperty --wje-aside-border-style;
+ * @tag wje-aside
+ */
+export default class Aside extends WJElement {
+    /**
+     * Getter for the CSS stylesheet.
+     * @returns {object} The styles for the Aside element.
+     */
+    static get cssStyleSheet(): object;
+    /**
+     * Getter for the observed attributes.
+     * @returns {Array} An empty array as there are no observed attributes.
+     */
+    static get observedAttributes(): any[];
+    /**
+     * Method to draw the Aside element.
+     * @returns {object} The document fragment containing the drawn element.
+     */
+    draw(): object;
+}

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

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

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

@@ -0,0 +1,37 @@
+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;
+    /**
+     * 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/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(): Array<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(): object;
+    /**
+     * Get observed attributes for the Breadcrumb element.
+     * @static
+     * @returns {Array<string>} - The observed attributes array for the Breadcrumb element.
+     */
+    static get observedAttributes(): Array<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(): object;
+    /**
+     * Get observed attributes for the Breadcrumb element.
+     * @static
+     * @returns {Array<string>} - The observed attributes array for the Breadcrumb element.
+     */
+    static get observedAttributes(): Array<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: string);
+    /**
+     * 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(): Array<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 | string);
+    /**
+     * Get color of the Button element.
+     * @returns {string|string}
+     */
+    get color(): string | 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: string | object);
+    /**
+     * Get variant of the Button element.
+     * @returns {string|object}
+     */
+    get dialog(): string | object;
+    /**
+     * 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 {};