wj-elements 0.4.1 → 0.4.3

package/dist/base-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.js","sources":["../packages/utils/base-path.js"],"sourcesContent":["let basePath = '';\n\nfunction resolveBasePathFromModuleUrl() {\n  if (typeof import.meta?.url !== 'string' || import.meta.url === '') {\n    return '';\n  }\n\n  try {\n    return new URL(/* @vite-ignore */ '.', import.meta.url).href;\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Sets the base path for the application.\n * @param {string} path The base path to be set.\n * @returns {void} This function does not return anything.\n */\nexport function setBasePath(path) {\n  basePath = path;\n}\n\n/**\n * Returns the base path of the application, optionally appending a specified relative path.\n * If the base path has not been set, it determines the base path from the first script element\n * with a `base-path` attribute or generates it based on the current script location.\n * @param {string} [appendedPath] The relative path to append to the base path. Defaults to an empty string.\n * @returns {string} The complete base path, with the appended relative path if specified.\n */\nexport function getBasePath(appendedPath = '') {\n  if (!basePath) {\n    const scripts = [...document.getElementsByTagName('script')];\n    const basePathScript = scripts.find(script => script.hasAttribute('data-base-path'));\n\n    if (basePathScript) {\n      setBasePath(basePathScript.dataset.basePath  || '');\n    } else {\n      setBasePath(resolveBasePathFromModuleUrl());\n    }\n  }\n\n  const subPath = appendedPath.replace(/^\\//, '');\n\n  return basePath.replace(/\\/$/, '') + (appendedPath ? '/' + subPath : '');\n}\n"],"names":[],"mappings":"AAAA,IAAI,WAAW;AAEf,SAAS,+BAA+B;AAFxC;AAGE,MAAI,SAAO,wCAAa,SAAQ,YAAY,YAAY,QAAQ,IAAI;AAClE,WAAO;AAAA,EACT;AAEA,MAAI;AACF,WAAO,IAAI;AAAA;AAAA,MAAuB;AAAA,MAAK,YAAY;AAAA,IAAG,EAAE;AAAA,EAC1D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAOO,SAAS,YAAY,MAAM;AAChC,aAAW;AACb;AASO,SAAS,YAAY,eAAe,IAAI;AAC7C,MAAI,CAAC,UAAU;AACb,UAAM,UAAU,CAAC,GAAG,SAAS,qBAAqB,QAAQ,CAAC;AAC3D,UAAM,iBAAiB,QAAQ,KAAK,YAAU,OAAO,aAAa,gBAAgB,CAAC;AAEnF,QAAI,gBAAgB;AAClB,kBAAY,eAAe,QAAQ,YAAa,EAAE;AAAA,IACpD,OAAO;AACL,kBAAY,6BAA4B,CAAE;AAAA,IAC5C;AAAA,EACF;AAEA,QAAM,UAAU,aAAa,QAAQ,OAAO,EAAE;AAE9C,SAAO,SAAS,QAAQ,OAAO,EAAE,KAAK,eAAe,MAAM,UAAU;AACvE;"}
+{"version":3,"file":"base-path.js","sources":["../packages/utils/base-path.js"],"sourcesContent":["let basePath = '';\n\nfunction resolveBasePathFromModuleUrl() {\n  if (typeof import.meta?.url !== 'string' || import.meta.url === '') {\n    return '';\n  }\n\n  try {\n    // eslint-disable-next-line jsdoc/no-bad-blocks\n    return new URL(/* @vite-ignore */ '.', import.meta.url).href;\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Sets the base path for the application.\n * @param {string} path The base path to be set.\n * @returns {void} This function does not return anything.\n */\nexport function setBasePath(path) {\n  basePath = path;\n}\n\n/**\n * Returns the base path of the application, optionally appending a specified relative path.\n * If the base path has not been set, it determines the base path from the first script element\n * with a `base-path` attribute or generates it based on the current script location.\n * @param {string} [appendedPath] The relative path to append to the base path. Defaults to an empty string.\n * @returns {string} The complete base path, with the appended relative path if specified.\n */\nexport function getBasePath(appendedPath = '') {\n  if (!basePath) {\n    const scripts = [...document.getElementsByTagName('script')];\n    const basePathScript = scripts.find(script => script.hasAttribute('data-base-path'));\n\n    if (basePathScript) {\n      setBasePath(basePathScript.dataset.basePath  || '');\n    } else {\n      setBasePath(resolveBasePathFromModuleUrl());\n    }\n  }\n\n  const subPath = appendedPath.replace(/^\\//, '');\n\n  return basePath.replace(/\\/$/, '') + (appendedPath ? '/' + subPath : '');\n}\n"],"names":[],"mappings":"AAAA,IAAI,WAAW;AAEf,SAAS,+BAA+B;AAFxC;AAGE,MAAI,SAAO,wCAAa,SAAQ,YAAY,YAAY,QAAQ,IAAI;AAClE,WAAO;AAAA,EACT;AAEA,MAAI;AAEF,WAAO,IAAI;AAAA;AAAA,MAAuB;AAAA,MAAK,YAAY;AAAA,IAAG,EAAE;AAAA,EAC1D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAOO,SAAS,YAAY,MAAM;AAChC,aAAW;AACb;AASO,SAAS,YAAY,eAAe,IAAI;AAC7C,MAAI,CAAC,UAAU;AACb,UAAM,UAAU,CAAC,GAAG,SAAS,qBAAqB,QAAQ,CAAC;AAC3D,UAAM,iBAAiB,QAAQ,KAAK,YAAU,OAAO,aAAa,gBAAgB,CAAC;AAEnF,QAAI,gBAAgB;AAClB,kBAAY,eAAe,QAAQ,YAAa,EAAE;AAAA,IACpD,OAAO;AACL,kBAAY,6BAA4B,CAAE;AAAA,IAC5C;AAAA,EACF;AAEA,QAAM,UAAU,aAAa,QAAQ,OAAO,EAAE;AAE9C,SAAO,SAAS,QAAQ,OAAO,EAAE,KAAK,eAAe,MAAM,UAAU;AACvE;"}

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

@@ -24,8 +24,8 @@ import { default as WJElement } from '../wje-element/element.js';
  * @cssproperty [--wje-accordion-headline-color=var(--wje-color-contrast-11)] - Text color of the headline area.
  * @cssproperty [--wje-accordion-content-color=var(--wje-color-contrast-6)] - Text color of the expandable content area.
  * @cssproperty [--wje-accordion-marker-rotate=0deg] - Rotation applied to the toggle marker icon.
- * @fires wje-accordion-item:open - Dispatched when the item is expanded.
- * @fires wje-accordion-item:close - Dispatched when the item is collapsed.
+ * // @fires wje-accordion-item:open - Dispatched when the item is expanded.
+ * // @fires wje-accordion-item:close - Dispatched when the item is collapsed.
  * @tag wje-accordion-item
  */
 export default class AccordionItem extends WJElement {

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

@@ -21,7 +21,6 @@ export function getHsl(text: string, s?: number, l?: number): string;
  * Generates background and text HSL colors for avatars based on input text.
  * The text color is a darker, more saturated variant of the background color
  * to ensure sufficient contrast while keeping the same hue.
- *
  * @param {string} text The input text (e.g. initials or name).
  * @returns {{ background: string, color: string }}
  */

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

@@ -55,9 +55,8 @@ export default class Breadcrumb extends WJElement {
      * @param {string} name The name of the attribute that was changed.
      * @param {string|null} oldValue The previous value of the attribute before it was changed. Null if the attribute was not previously set.
      * @param {string|null} newValue The new value of the attribute after it was changed. Null if the attribute was removed.
-     * @returns {boolean} Returns false to signal no default behavior is implemented.
      */
-    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): boolean;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     active: boolean;
     syncAria(): void;
     /**

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

@@ -88,9 +88,9 @@ export default class Carousel extends WJElement {
      * Returns the interaction scroll behavior for UI controls.
      * Continuous multi-slide loops use instant snapping to avoid blank edge states
      * while the browser is still animating a previous smooth scroll.
-     * @returns {ScrollBehavior|string}
+     * @returns {string}
      */
-    getControlBehavior(): ScrollBehavior | string;
+    getControlBehavior(): string;
     /**
      * Sets up the IntersectionObserver for the Carousel.
      */
@@ -138,9 +138,9 @@ export default class Carousel extends WJElement {
     /**
      * Scrolls the carousel to a visual slide index.
      * @param {number} vIndex
-     * @param {ScrollBehavior|string} behavior
+     * @param {string} behavior
      */
-    scrollToVisualIndex(vIndex: number, behavior?: ScrollBehavior | string): void;
+    scrollToVisualIndex(vIndex: number, behavior?: string): void;
     snapRestoreFrame: any;
     /**
      * Goes to the next slide.
@@ -192,9 +192,9 @@ export default class Carousel extends WJElement {
      * @returns {Array}
      */
     getSlidesWithClones(): any[];
-    /** Maps logical index -> visual index (accounts for leading clone when loop=true) */
+    /** Maps logical index to visual index, including leading clones when loop is enabled. */
     getVisualIndexForLogical(index: any): any;
-    /** Maps visual index -> logical index (handles clones at 0 and last when loop=true) */
+    /** Maps visual index to logical index, including edge clones when loop is enabled. */
     getLogicalIndexForVisual(vIndex: any): any;
     /**
      * Returns the maximum logical slide index that can still render a full viewport.

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

@@ -8,6 +8,9 @@ import { default as WJElement } from '../wje-element/element.js';
  * @status stable
  * @augments WJElement
  * @attribute {string} for - The id of the element to copy content from.
+ * @attribute {string} label - Accessible label for the button. Also used as fallback tooltip text when the `tooltip` attribute is present without a value.
+ * @attribute {string} label-success - Text displayed in the tooltip after a successful copy. Used only when the `tooltip` attribute is present.
+ * @attribute {string} tooltip - Enables the tooltip. When set to a string, the value is used as the default tooltip content.
  * @attribute {string} value - The text to be copied.
  * @slot - This is a default/unnamed slot.
  * @csspart button - Styles the button element.
@@ -43,8 +46,8 @@ export default class CopyButton extends WJElement {
      * @returns {DocumentFragment} The created document fragment.
      */
     draw(): DocumentFragment;
+    _tooltipElement: HTMLElement;
     icon: HTMLElement;
-    tooltip: HTMLElement;
     /**
      * Adds event listeners for the click, focus, and blur events.
      */
@@ -76,9 +79,8 @@ export default class CopyButton extends WJElement {
     /**
      * Handles the copied event.
      * You can override this method to customize the behavior when the text is copied.
-     * @param {Event} e The event object.
      */
-    copied: (e: Event) => void;
+    copied: () => void;
     /**
      * Copies the specified text or node.
      * @param {HTMLElement} button The button element.

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

@@ -77,7 +77,35 @@ export default class Dropdown extends WJElement {
      */
     afterDraw(): void;
     onSlotChange: () => void;
-    popupHideCallback: (e: any) => void;
+    /**
+     * Handles popup hide events and closes only the dropdown that owns the popup.
+     * This prevents nested dropdowns from collapsing their parent dropdown when the
+     * child popup is hidden.
+     * @param {Event} e The popup hide event.
+     */
+    popupHideCallback: (e: Event) => void;
+    /**
+     * Assigns the current dropdown instance as the owner of its popup layers.
+     * Owner metadata is later used to resolve which dropdown should react to
+     * delegated menu-item clicks, including portaled popup content.
+     */
+    syncPopupOwner(): void;
+    /**
+     * Recursively assigns owner metadata to the dropdown content subtree while
+     * leaving nested dropdown roots untouched, so each nested dropdown can keep
+     * its own ownership boundary.
+     * @param {HTMLElement} [root] The subtree root whose children should inherit this dropdown owner. Defaults to the current dropdown.
+     */
+    syncOwnedContentOwner(root?: HTMLElement): void;
+    /**
+     * Resolves the dropdown that owns a clicked menu item. The lookup prefers
+     * explicit owner metadata and falls back to DOM traversal so both regular
+     * and portaled dropdown content can be scoped correctly.
+     * @param {EventTarget[]} path The composed event path.
+     * @param {HTMLElement} item The clicked menu item element.
+     * @returns {HTMLElement|null} The owning dropdown element or null when it cannot be resolved.
+     */
+    getMenuItemOwner(path: EventTarget[], item: HTMLElement): HTMLElement | null;
     /**
      * Handles delegated clicks from inside the popup and closes the dropdown when a leaf menu item is selected.
      * This works even when the menu is portaled, because we rely on the composed path.

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

@@ -130,7 +130,7 @@ export default class WJElement extends HTMLElement {
     /**
      * Sets ARIA state via attributes.
      * Accepts camelCase keys without the "aria" prefix, plus "role".
-     * Example: setAriaState({ role: 'tab', selected: true, controls: 'panel-1' })
+     * Example: setAriaState({ role: 'tab', selected: true, controls: 'panel-1' }).
      * @param {object} state
      */
     setAriaState(state?: object): void;

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

@@ -166,4 +166,5 @@ export default class Input extends FormAssociatedElement {
      * @returns {boolean} Whether the input has the slot.
      */
     hasSlot(el: HTMLElement, slotName?: string): boolean;
+    #private;
 }

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

@@ -54,6 +54,9 @@ export default class Option extends WJElement {
      * @returns {boolean} Returns true if the 'wje-select' element has the 'multiple' attribute, otherwise false.
      */
     get multiple(): boolean;
+    set ownerSelect(value: any);
+    get ownerSelect(): any;
+    _ownerSelect: any;
     /**
      * Sets the value attribute of the option.
      * @param {string} value The value to set.

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

@@ -11,6 +11,7 @@ import { default as Options } from '../wje-options/options.js';
 import { default as Checkbox } from '../wje-checkbox/checkbox.js';
 export class Select extends FormAssociatedElement {
     static _instanceId: number;
+    static portalStyles: string;
     /**
      * Returns the CSS styles for the component.
      * @static
@@ -143,6 +144,22 @@ export class Select extends FormAssociatedElement {
      * @returns {string} The default value of the input element.
      */
     get defaultValue(): string;
+    /**
+     * Sets or removes the `portaled` attribute on the select.
+     * Mirrors the dropdown API so popup content can be rendered in a portal root.
+     * @param {boolean|string} value Determines whether and where the popup should be portaled.
+     */
+    set portaled(value: boolean | string);
+    /**
+     * Getter for the `portaled` attribute value.
+     * @returns {string} The configured portal target or an empty string for the default body portal.
+     */
+    get portaled(): string;
+    /**
+     * Checks whether popup content should be portaled.
+     * @returns {boolean} True when the `portaled` attribute is present.
+     */
+    get isPortaled(): boolean;
     /**
      * Sets the trigger value.
      * @param {string} value The trigger value to set.

package/dist/{popup.element-DklicGea.js → popup.element-C8-g3WLs.js}

@@ -1693,7 +1693,7 @@ class Popup extends WJElement {
     for (const n of defNodes) {
       const ph = document.createComment("wje-portal-default");
       this._defPlaceholders.push({ node: n, ph });
-      n.parentNode && n.parentNode.insertBefore(ph, n.nextSibling);
+      if (n.parentNode) n.parentNode.insertBefore(ph, n.nextSibling);
       this._portalContainer.append(n);
     }
     const arrowNodes = (this.slotArrow instanceof HTMLSlotElement ? this.slotArrow.assignedNodes({ flatten: true }) : []).filter((n) => n && n.nodeType === Node.ELEMENT_NODE || n && n.nodeType === Node.TEXT_NODE);
@@ -1701,7 +1701,7 @@ class Popup extends WJElement {
     for (const n of arrowNodes) {
       const ph = document.createComment("wje-portal-arrow");
       this._arrowPlaceholders.push({ node: n, ph });
-      n.parentNode && n.parentNode.insertBefore(ph, n.nextSibling);
+      if (n.parentNode) n.parentNode.insertBefore(ph, n.nextSibling);
       this._portalContainer.append(n);
     }
     this._floatingEl = this._portalNative;
@@ -1898,4 +1898,4 @@ class Popup extends WJElement {
 export {
   Popup as P
 };
-//# sourceMappingURL=popup.element-DklicGea.js.map
+//# sourceMappingURL=popup.element-C8-g3WLs.js.map