wj-elements 0.1.199 → 0.1.201

package/dist/packages/wje-accordion-item/accordion-item.element.d.ts

@@ -0,0 +1,40 @@
+import { default as WJElement } from '../wje-element/element.js';
+/**
+ * @summary This class represents an Accordion Item element, extending the WJElement class.
+ * @documentation https://elements.webjet.sk/components/accordion-item
+ * @status stable
+ * @augments WJElement
+ * @slot - The accordion item main content.
+ * @tag wje-accordion
+ */
+export default class AccordionItem extends WJElement {
+    /**
+     * Getter for the CSS stylesheet.
+     * @returns {object} The styles for the Accordion Item 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[];
+    /**
+     * Method to draw the Accordion Item element. This method returns a document fragment containing the drawn element.
+     * @returns {object} The document fragment containing the drawn element.
+     */
+    draw(): object;
+    headline: HTMLDivElement;
+    toggle: HTMLSlotElement;
+    /**
+     * Method to execute after the Accordion Item element is drawn.
+     */
+    afterDraw(): void;
+    /**
+     * Method to handle the attribute changes.
+     */
+    collapse: () => void;
+    /**
+     * Method to handle the attribute changes.
+     */
+    expand: () => void;
+}

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

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

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

@@ -0,0 +1,158 @@
+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[];
+    /**
+     * Terminates and cleans up the currently active animation if it exists.
+     * Calls the `cancel` method to stop the animation process.
+     * @returns {void} Does not return any value.
+     */
+    destroyAnimation(): void;
+    /**
+     * Plays the currently assigned animation, if available.
+     * @returns {void} This method does not return any value.
+     */
+    play(): void;
+    /**
+     * Cancels the current animation if it is initialized and has a cancel method.
+     * Logs a warning if the animation is not initialized or the cancel method is unavailable.
+     * @returns {void} Does not return a value.
+     */
+    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,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(): Array<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: string);
+    /**
+     * 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 | number);
+    /**
+     * 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(): 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;