@patternfly/pfe-core 2.4.1 → 4.0.0

package/controllers/cascade-controller.d.ts

@@ -1,8 +1,14 @@
 import type { ReactiveController, ReactiveElement } from 'lit';
+/**
+ * @deprecated use context, especially via `@patternfly/pfe-core/functions/context.js`;
+ */
 export interface Options<E extends ReactiveElement> {
     properties: Partial<Record<keyof E, string | string[]>>;
     prefix?: string;
 }
+/**
+ * @deprecated use context, especially via `@patternfly/pfe-core/functions/context.js`;
+ */
 export declare class CascadeController<E extends ReactiveElement> implements ReactiveController {
     host: E;
     options?: Options<E> | undefined;
@@ -18,17 +24,22 @@ export declare class CascadeController<E extends ReactiveElement> implements Rea
     /**
      * Handles the cascading of properties to nested components when new elements are added
      * Attribute updates/additions are handled by the attribute callback
+     * @param [nodeList=this.host.children]
      */
     cascadeProperties(nodeList?: HTMLCollection | NodeList): void;
     /**
      * Gets the configured attribute name for the decorated property,
      * falling back to the lowercased property name, and caches the attribute name
      * with it's designated child selectors for value-propagation on change
+     * @param propName
+     * @param cascade
      */
     initProp(propName: string, cascade: string | string[]): void;
     private parse;
     /**
      * Copy the named attribute to a target element.
+     * @param name attr name
+     * @param el element
      */
     private _copyAttribute;
     private _cascadeAttributes;

package/controllers/cascade-controller.js

@@ -2,8 +2,10 @@ import { __decorate } from "tslib";
 import { bound } from '../decorators/bound.js';
 import { debounce } from '../functions/debounce.js';
 import { Logger } from './logger.js';
-class CascadeController {
-    static { this.instances = new WeakMap(); }
+/**
+ * @deprecated use context, especially via `@patternfly/pfe-core/functions/context.js`;
+ */
+export class CascadeController {
     constructor(host, options) {
         this.host = host;
         this.options = options;
@@ -32,6 +34,7 @@ class CascadeController {
     /**
      * Handles the cascading of properties to nested components when new elements are added
      * Attribute updates/additions are handled by the attribute callback
+     * @param [nodeList=this.host.children]
      */
     cascadeProperties(nodeList = this.host.children) {
         if (this.host.isConnected) {
@@ -63,6 +66,8 @@ class CascadeController {
      * Gets the configured attribute name for the decorated property,
      * falling back to the lowercased property name, and caches the attribute name
      * with it's designated child selectors for value-propagation on change
+     * @param propName
+     * @param cascade
      */
     initProp(propName, cascade) {
         for (const nodeItem of [cascade].flat(Infinity).filter(Boolean)) {
@@ -93,6 +98,8 @@ class CascadeController {
     }
     /**
      * Copy the named attribute to a target element.
+     * @param name attr name
+     * @param el element
      */
     async _copyAttribute(name, el) {
         this.logger.log(`copying ${name} to ${el}`);
@@ -130,8 +137,8 @@ class CascadeController {
         }
     }
 }
+CascadeController.instances = new WeakMap();
 __decorate([
     bound
 ], CascadeController.prototype, "parse", null);
-export { CascadeController };
 //# sourceMappingURL=cascade-controller.js.map

package/controllers/cascade-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-controller.js","sourceRoot":"","sources":["cascade-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveElement } from 'lit';\n\nimport { bound } from '../decorators/bound.js';\nimport { debounce } from '../functions/debounce.js';\nimport { Logger } from './logger.js';\n\nexport interface Options<E extends ReactiveElement> {\n  properties: Partial<Record<keyof E, string | string[]>>;\n  prefix?: string;\n}\n\nexport class CascadeController<E extends ReactiveElement> implements ReactiveController {\n  private class: typeof ReactiveElement;\n\n  private logger: Logger;\n\n  static instances: WeakMap<ReactiveElement, CascadeController<ReactiveElement>> = new WeakMap();\n\n  mo = new MutationObserver(this.parse);\n\n  cache = new Map<string, string[]>();\n\n  constructor(public host: E, public options?: Options<E>) {\n    this.class = host.constructor as typeof ReactiveElement;\n    this.logger = new Logger(this.host);\n    CascadeController.instances.set(host, this);\n    const properties = this.options?.properties ?? {} as Options<E>['properties'];\n    for (const [propName, cascade] of Object.entries(properties)) {\n      this.initProp(propName, cascade);\n    }\n    host.addController(this);\n    this.cascadeProperties = debounce(this.cascadeProperties, 1);\n  }\n\n  hostUpdated() {\n    this.cascadeProperties();\n  }\n\n  hostConnected() {\n    this.mo.observe(this.host, { attributes: true, childList: true });\n    this.cascadeProperties();\n  }\n\n  hostDisconnected() {\n    this.mo.disconnect();\n  }\n\n  /**\n   * Handles the cascading of properties to nested components when new elements are added\n   * Attribute updates/additions are handled by the attribute callback\n   */\n  cascadeProperties(nodeList: HTMLCollection | NodeList = this.host.children) {\n    if (this.host.isConnected) {\n      const selectors = this.cache.keys();\n\n      // Find out if anything in the nodeList matches any of the observed selectors for cacading properties\n      if (!nodeList) {\n        return this._cascadeAttributes(selectors, this.cache);\n      }\n\n\n      for (const node of nodeList) {\n        // if this node has a match function (i.e., it's an HTMLElement, not a text node),\n        if (node instanceof Element) {\n          // see if it matches one of the selectors, otherwise drop it (like it's hot).\n          for (const selector of selectors) {\n            // console.log('_copyAttribute', name, value, el.getAttribute(name));\n            if (node.matches(selector)) {\n              const attrNames = this.cache.get(selector);\n              // each selector can match multiple properties/attributes, so\n              // copy each of them\n              for (const attrName of attrNames ?? []) {\n                this._copyAttribute(attrName, node);\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Gets the configured attribute name for the decorated property,\n   * falling back to the lowercased property name, and caches the attribute name\n   * with it's designated child selectors for value-propagation on change\n   */\n  initProp(propName: string, cascade: string | string[]) {\n    for (const nodeItem of [cascade].flat(Infinity).filter(Boolean) as string[]) {\n      const { attribute } = this.class.getPropertyOptions(propName);\n\n      const attr =\n          typeof attribute === 'string' ? attribute\n        : propName.toLowerCase();\n\n      // Create an object with the node as the key and an array of attributes\n      // that are to be cascaded down to it\n      if (!this.cache.get(nodeItem)) {\n        this.cache.set(nodeItem, [attr]);\n      } else {\n        this.cache.get(nodeItem)?.push(attr);\n      }\n    }\n  }\n\n  @bound private parse(mutations: MutationRecord[]) {\n    // Iterate over the mutation list, look for cascade updates\n    for (const mutation of mutations ?? []) {\n      // If a new node is added, attempt to cascade attributes to it\n      if (mutation.type === 'childList' && mutation.addedNodes.length) {\n        this.cascadeProperties(mutation.addedNodes);\n      } else if (mutation.type === 'attributes') {\n        this._cascadeAttributes(this.cache.keys(), this.cache);\n      }\n    }\n  }\n\n  /**\n   * Copy the named attribute to a target element.\n   */\n  private async _copyAttribute(name: string, el: Element) {\n    this.logger.log(`copying ${name} to ${el}`);\n    const value = this.host.getAttribute(name);\n    if (el.isConnected) {\n      if (value == null) {\n        el.removeAttribute(name);\n      } else {\n        el.setAttribute(name, value);\n      }\n    }\n  }\n\n  private _cascadeAttributes(selectors: IterableIterator<string>, set: this['cache']) {\n    for (const selector of selectors) {\n      for (const attr of set.get(selector) ?? []) {\n        this._cascadeAttribute(attr, selector);\n      }\n    }\n  }\n\n  /**\n   * Trigger a cascade of the named attribute to any child elements that match\n   * the `to` selector.  The selector can match elements in the light DOM and\n   * shadow DOM.\n   * @param  name The name of the attribute to cascade (not necessarily the same as the property name).\n   * @param  to A CSS selector that matches the elements that should received the cascaded attribute.  The selector will be applied within `this` element's light and shadow DOM trees.\n   */\n  private _cascadeAttribute(name: string, to: string) {\n    const recipients = [\n      ...this.host.querySelectorAll(to),\n      ...this.host.shadowRoot?.querySelectorAll(to) ?? [],\n    ];\n\n    for (const node of recipients) {\n      this._copyAttribute(name, node);\n    }\n  }\n}\n"]}
+{"version":3,"file":"cascade-controller.js","sourceRoot":"","sources":["cascade-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController, ReactiveElement } from 'lit';\n\nimport { bound } from '../decorators/bound.js';\nimport { debounce } from '../functions/debounce.js';\nimport { Logger } from './logger.js';\n\n/**\n * @deprecated use context, especially via `@patternfly/pfe-core/functions/context.js`;\n */\nexport interface Options<E extends ReactiveElement> {\n  properties: Partial<Record<keyof E, string | string[]>>;\n  prefix?: string;\n}\n\n/**\n * @deprecated use context, especially via `@patternfly/pfe-core/functions/context.js`;\n */\nexport class CascadeController<E extends ReactiveElement> implements ReactiveController {\n  private class: typeof ReactiveElement;\n\n  private logger: Logger;\n\n  static instances: WeakMap<ReactiveElement, CascadeController<ReactiveElement>> =\n    new WeakMap<ReactiveElement, CascadeController<ReactiveElement>>();\n\n  mo: MutationObserver = new MutationObserver(this.parse);\n\n  cache: Map<string, string[]> = new Map<string, string[]>();\n\n  constructor(public host: E, public options?: Options<E> | undefined) {\n    this.class = host.constructor as typeof ReactiveElement;\n    this.logger = new Logger(this.host);\n    CascadeController.instances.set(host, this);\n    const properties = this.options?.properties ?? {} as Options<E>['properties'];\n    for (const [propName, cascade] of Object.entries(properties)) {\n      this.initProp(propName, cascade);\n    }\n    host.addController(this);\n    this.cascadeProperties = debounce(this.cascadeProperties, 1);\n  }\n\n  hostUpdated(): void {\n    this.cascadeProperties();\n  }\n\n  hostConnected(): void {\n    this.mo.observe(this.host, { attributes: true, childList: true });\n    this.cascadeProperties();\n  }\n\n  hostDisconnected(): void {\n    this.mo.disconnect();\n  }\n\n  /**\n   * Handles the cascading of properties to nested components when new elements are added\n   * Attribute updates/additions are handled by the attribute callback\n   * @param [nodeList=this.host.children]\n   */\n  cascadeProperties(nodeList: HTMLCollection | NodeList = this.host.children): void {\n    if (this.host.isConnected) {\n      const selectors = this.cache.keys();\n\n      // Find out if anything in the nodeList matches any of the observed selectors for cacading properties\n      if (!nodeList) {\n        return this._cascadeAttributes(selectors, this.cache);\n      }\n\n\n      for (const node of nodeList) {\n        // if this node has a match function (i.e., it's an HTMLElement, not a text node),\n        if (node instanceof Element) {\n          // see if it matches one of the selectors, otherwise drop it (like it's hot).\n          for (const selector of selectors) {\n            // console.log('_copyAttribute', name, value, el.getAttribute(name));\n            if (node.matches(selector)) {\n              const attrNames = this.cache.get(selector);\n              // each selector can match multiple properties/attributes, so\n              // copy each of them\n              for (const attrName of attrNames ?? []) {\n                this._copyAttribute(attrName, node);\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Gets the configured attribute name for the decorated property,\n   * falling back to the lowercased property name, and caches the attribute name\n   * with it's designated child selectors for value-propagation on change\n   * @param propName\n   * @param cascade\n   */\n  initProp(propName: string, cascade: string | string[]): void {\n    for (const nodeItem of [cascade].flat(Infinity).filter(Boolean) as string[]) {\n      const { attribute } = this.class.getPropertyOptions(propName);\n\n      const attr =\n          typeof attribute === 'string' ? attribute\n        : propName.toLowerCase();\n\n      // Create an object with the node as the key and an array of attributes\n      // that are to be cascaded down to it\n      if (!this.cache.get(nodeItem)) {\n        this.cache.set(nodeItem, [attr]);\n      } else {\n        this.cache.get(nodeItem)?.push(attr);\n      }\n    }\n  }\n\n  @bound private parse(mutations: MutationRecord[]) {\n    // Iterate over the mutation list, look for cascade updates\n    for (const mutation of mutations ?? []) {\n      // If a new node is added, attempt to cascade attributes to it\n      if (mutation.type === 'childList' && mutation.addedNodes.length) {\n        this.cascadeProperties(mutation.addedNodes);\n      } else if (mutation.type === 'attributes') {\n        this._cascadeAttributes(this.cache.keys(), this.cache);\n      }\n    }\n  }\n\n  /**\n   * Copy the named attribute to a target element.\n   * @param name attr name\n   * @param el element\n   */\n  private async _copyAttribute(name: string, el: Element) {\n    this.logger.log(`copying ${name} to ${el}`);\n    const value = this.host.getAttribute(name);\n    if (el.isConnected) {\n      if (value == null) {\n        el.removeAttribute(name);\n      } else {\n        el.setAttribute(name, value);\n      }\n    }\n  }\n\n  private _cascadeAttributes(selectors: IterableIterator<string>, set: this['cache']) {\n    for (const selector of selectors) {\n      for (const attr of set.get(selector) ?? []) {\n        this._cascadeAttribute(attr, selector);\n      }\n    }\n  }\n\n  /**\n   * Trigger a cascade of the named attribute to any child elements that match\n   * the `to` selector.  The selector can match elements in the light DOM and\n   * shadow DOM.\n   * @param  name The name of the attribute to cascade (not necessarily the same as the property name).\n   * @param  to A CSS selector that matches the elements that should received the cascaded attribute.  The selector will be applied within `this` element's light and shadow DOM trees.\n   */\n  private _cascadeAttribute(name: string, to: string) {\n    const recipients = [\n      ...this.host.querySelectorAll(to),\n      ...this.host.shadowRoot?.querySelectorAll(to) ?? [],\n    ];\n\n    for (const node of recipients) {\n      this._copyAttribute(name, node);\n    }\n  }\n}\n"]}

package/controllers/combobox-controller.d.ts

@@ -0,0 +1,117 @@
+import { nothing, type ReactiveController, type ReactiveControllerHost } from 'lit';
+import type { ActivedescendantControllerOptions } from './activedescendant-controller.js';
+import type { RovingTabindexControllerOptions } from './roving-tabindex-controller.js';
+import type { ListboxControllerOptions } from './listbox-controller.js';
+type AllOptions<Item extends HTMLElement> = ActivedescendantControllerOptions<Item> & ListboxControllerOptions<Item> & RovingTabindexControllerOptions<Item>;
+export interface ComboboxControllerOptions<Item extends HTMLElement> extends Omit<AllOptions<Item>, 'getATFocusedItem' | 'getControlsElements' | 'getActiveDescendantContainer' | 'getItemsContainer'> {
+    /**
+     * Predicate which establishes whether the listbox is expanded
+     * e.g. `isExpanded: () => this.expanded`, if the host's `expanded` property
+     * should correspond to the listbox expanded state.
+     */
+    isExpanded(): boolean;
+    /**
+     * Callback which the host must implement to change the expanded state to true.
+     * Return or resolve false to prevent the change.
+     */
+    requestShowListbox(): void | boolean | Promise<boolean> | Promise<void>;
+    /**
+     * Callback which the host must implement to change the expanded to false.
+     * Return or resolve false to prevent the default.
+     */
+    requestHideListbox(): void | boolean | Promise<boolean> | Promise<void>;
+    /**
+     * Returns the listbox container element
+     */
+    getListboxElement(): HTMLElement | null;
+    /**
+     * Returns the toggle button, if it exists
+     */
+    getToggleButton(): HTMLElement | null;
+    /**
+     * Returns the combobox input, if it exists
+     */
+    getComboboxInput(): HTMLElement | null;
+    /**
+     * Returns the label for the toggle button, combobox input, and listbox.
+     * when `ariaLabelledByElements` is supported, the label elements associated with
+     * the host element are used instead, and this value is ignored.
+     */
+    getFallbackLabel(): string;
+    /**
+     * Called on an item to retrieve it's value string. By default, returns the `value` property
+     * of the item, as if it implemented the `<option>` element's interface.
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionElement
+     */
+    getItemValue?(item: Item): string;
+    /**
+     * Optional callback, called on the combobox input element to set its value.
+     * by default, returns the element's `value` DOM property.
+     */
+    getComboboxValue?(combobox: HTMLElement): string;
+    /**
+     * Optional callback, called on the combobox input element to set its value.
+     * by default, sets the element's `value` DOM property.
+     */
+    setComboboxValue?(item: HTMLElement, value: string): void;
+    /**
+     * Called on each item, with the combobox input, to determine if the item should be shown in the
+     * listbox or filtered out. Return false to hide the item. By default, checks whether the item's
+     * value starts with the input value (when both are lowercased).
+     */
+    isItemFiltered?(item: Item, value: string): boolean;
+    /**
+     * Called on each item when the filter changes.
+     * By default, toggles the `hidden` attribute on the item
+     */
+    setItemHidden?(item: Item, hidden: boolean): void;
+}
+/**
+ * @summary Implements the WAI-ARIA pattern [Editable Combobox with Both List and Inline Autocomplete].
+ *
+ * Combobox with keyboard and pointer navigation, using the aria-activedescendant pattern.
+ *
+ * WARNING: Safari VoiceOver does not support aria-activedescendant, so Safari users
+ * rely on the combobox input value being announced when navigating the listbox with the keyboard.
+ * We have erred on the side that it may be less-broken to avoid announcing disabled items in that
+ * case, rather than announcing the disabled items value without indicating that it is disabled.
+ * @see (https://bugs.webkit.org/show_bug.cgi?id=269026)
+ *
+ * [pattern]: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-both/
+ */
+export declare class ComboboxController<Item extends HTMLElement> implements ReactiveController {
+    #private;
+    host: ReactiveControllerHost;
+    static of<T extends HTMLElement>(host: ReactiveControllerHost, options: ComboboxControllerOptions<T>): ComboboxController<T>;
+    /**
+     * Whether the `ariaActiveDescendantElement` IDL attribute is supported for cross-root ARIA.
+     */
+    static get supportsCrossRootActiveDescendant(): boolean;
+    private static langs;
+    private static langsRE;
+    private options;
+    /** All items */
+    get items(): Item[];
+    set items(value: Item[]);
+    /** Whether the combobox is disabled */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /** Whether multiselect is enabled */
+    get multi(): boolean;
+    set multi(value: boolean);
+    /** The current selection: a list of items */
+    get selected(): Item[];
+    set selected(value: Item[]);
+    private constructor();
+    hostConnected(): Promise<void>;
+    hostUpdated(): void;
+    hostDisconnected(): void;
+    /**
+     * For Browsers which do not support `ariaActiveDescendantElement`, we must clone
+     * the listbox items into the same root as the combobox input
+     * Call this method to return either an array of (cloned) list box items, to be placed in your
+     * shadow template, or nothing in the case the browser supports cross-root aria.
+     */
+    renderItemsToShadowRoot(): Node[] | typeof nothing;
+}
+export {};