@carbon/web-components 2.51.0 → 2.51.1-rc.0

package/lib/components/dropdown/dropdown.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Copyright IBM Corp. 2019, 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { LitElement, TemplateResult } from 'lit';
+import { DROPDOWN_DIRECTION, DROPDOWN_KEYBOARD_ACTION, DROPDOWN_SIZE, DROPDOWN_TYPE, NAVIGATION_DIRECTION } from './defs';
+import CDSDropdownItem from './dropdown-item';
+export { DROPDOWN_KEYBOARD_ACTION, DROPDOWN_DIRECTION, DROPDOWN_SIZE, DROPDOWN_TYPE, NAVIGATION_DIRECTION, };
+declare const CDSDropdown_base: (new (...args: any[]) => {
+    _getValidityMessage(state: string): string | undefined;
+    _testValidity(): string;
+    invalid: boolean;
+    required: boolean;
+    requiredValidityMessage: string;
+    validityMessage: string;
+    value: string;
+    checkValidity(): boolean;
+    setCustomValidity(validityMessage: string): void;
+}) & {
+    new (...args: any[]): {
+        _handles: Set<import("../../globals/internal/handle").default>;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+    };
+    _hostListeners: {
+        [listenerName: string]: {
+            [type: string]: {
+                options?: boolean | AddEventListenerOptions;
+            };
+        };
+    };
+} & (new (...args: any[]) => {
+    _hFormdata: import("../../globals/internal/handle").default | null;
+    _handleFormdata(event: Event): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}) & (new (...args: any[]) => {
+    focus(): void;
+}) & typeof LitElement;
+/**
+ * Dropdown.
+ *
+ * @element cds-dropdown
+ * @csspart label-text The label text.
+ * @csspart helper-text The helper text.
+ * @csspart trigger-button The trigger button.
+ * @csspart menu-body The menu body.
+ * @csspart validity-message The validity message.
+ * @fires cds-dropdown-beingselected
+ *   The custom event fired before a dropdown item is selected upon a user gesture.
+ *   Cancellation of this event stops changing the user-initiated selection.
+ * @fires cds-dropdown-beingtoggled
+ *   The custom event fired before the open state of this dropdown is toggled upon a user gesture.
+ *   Cancellation of this event stops the user-initiated toggling.
+ * @fires cds-dropdown-selected - The custom event fired after a dropdown item is selected upon a user gesture.
+ * @fires cds-dropdown-toggled - The custom event fired after the open state of this dropdown is toggled upon a user gesture.
+ */
+declare class CDSDropdown extends CDSDropdown_base {
+    /**
+     * `true` if there is an AI Label.
+     */
+    protected _hasAILabel: boolean;
+    /**
+     * Currently slotted AI decorator nodes (`cds-ai-label`/slug) with listeners attached.
+     */
+    private _aiDecoratorNodes;
+    /**
+     * Floating UI controller instance for autoalign positioning.
+     */
+    private _floatingController;
+    /**
+     * Handles interaction on an AI decorator while the menu is open.
+     */
+    private _handleAIDecoratorInteraction;
+    protected _activeDescendant?: string;
+    /**
+     * The content of the selected item.
+     */
+    protected _selectedItemContent: DocumentFragment | null;
+    /**
+     * `true` if the trigger button should be focusable.
+     * Derived class can set `false` to this if the trigger button contains another primary focusable element (e.g. `input`).
+     */
+    protected _shouldTriggerBeFocusable: boolean;
+    /**
+     * The list box `<div>` node.
+     */
+    protected _listBoxNode: HTMLDivElement;
+    /**
+     * The menu body element.
+     */
+    protected _menuBodyNode: HTMLDivElement;
+    /**
+     * The trigger button element.
+     */
+    protected _triggerButtonNode: HTMLDivElement;
+    /**
+     * The `<slot>` element for the helper text in the shadow DOM.
+     */
+    protected _slotHelperTextNode: HTMLSlotElement;
+    /**
+     * The `<slot>` element for the title text in the shadow DOM.
+     */
+    protected _slotTitleTextNode: HTMLSlotElement;
+    /**
+     * @param itemToSelect A dropdown item. Absense of this argument means clearing selection.
+     * @returns `true` if the selection of this dropdown should change if the given item is selected upon user interaction.
+     */
+    protected _selectionShouldChange(itemToSelect?: CDSDropdownItem): boolean;
+    /**
+     * A callback that runs after change in dropdown selection upon user interaction is confirmed.
+     *
+     * @param itemToSelect
+     *   A dropdown item.
+     *   Absense of this argument means clearing selection, which may be handled by a derived class.
+     */
+    protected _selectionDidChange(itemToSelect?: CDSDropdownItem): void;
+    /**
+     * Handles `click` event on the top-level element in the shadow DOM.
+     *
+     * @param event The event.
+     */
+    protected _handleClickInner(event: MouseEvent): void;
+    /**
+     * Handler for the `keydown` event on the top-level element in the shadow DOM.
+     */
+    protected _handleKeydownInner(event: KeyboardEvent): void;
+    private _handleMenuInputKeydown;
+    protected _shouldClearMenuInputOnEscape({ menuOpen, }: {
+        event: KeyboardEvent;
+        menuOpen: boolean;
+        isInputTarget: boolean;
+    }): boolean;
+    protected get _supportsMenuInputFiltering(): boolean;
+    protected get _menuInputNode(): HTMLInputElement | null;
+    protected _clearMenuInputFiltering(): void;
+    private _shouldForwardKeyToMenuInput;
+    private _forwardKeyToMenuInput;
+    private _shouldRetainMenuInputFocus;
+    /**
+     * Handles keypress events (Space, Enter)
+     */
+    protected _handleKeypressInner(event: KeyboardEvent): void;
+    /**
+     * Handles `blur` event handler on the document this element is in.
+     *
+     * @param event The event.
+     */
+    protected _handleMouseoverInner(event: MouseEvent): void;
+    protected _handleMouseleaveInner(event: MouseEvent): void;
+    protected _handleFocusOut(event: FocusEvent): void;
+    /**
+     * Handles `slotchange` event for the `<slot>` for helper text.
+     */
+    protected _handleSlotchangeHelperText(): void;
+    /**
+     * Handles `slotchange` event for the `<slot>` for label text.
+     */
+    protected _handleSlotchangeLabelText(): void;
+    /**
+     * Handles `slotchange` event.
+     */
+    protected _handleAILabelSlotChange({ target }: Event): void;
+    disconnectedCallback(): void;
+    /**
+     * Updates listeners for AI decorator nodes to ensure only one menu stays open.
+     */
+    private _updateAIDecoratorListeners;
+    /**
+     * Handles user-initiated selection of a dropdown item.
+     *
+     * @param [item] The dropdown item user wants to select. Absense of this argument means clearing selection.
+     */
+    protected _handleUserInitiatedSelectItem(item?: CDSDropdownItem): void;
+    protected _shouldCloseAfterSelection(item?: CDSDropdownItem): boolean;
+    /**
+     * Handles user-initiated toggling the open state.
+     *
+     * @param [force] If specified, forces the open state to the given one.
+     */
+    protected _handleUserInitiatedToggle(force?: boolean, { restoreTriggerFocus, focusMenu, highlightSelectedOnOpen, }?: {
+        restoreTriggerFocus?: boolean;
+        focusMenu?: boolean;
+        highlightSelectedOnOpen?: boolean;
+    }): void;
+    /**
+     * Clears the selection of dropdown items.
+     */
+    protected _clearHighlight(): void;
+    protected _getDropdownItemFromEvent(event: Event): CDSDropdownItem | null;
+    protected _setHighlightedItem(item?: CDSDropdownItem | null, { scrollIntoView }?: {
+        scrollIntoView?: boolean;
+    }): void;
+    protected _getNextDropdownItem(item: CDSDropdownItem): CDSDropdownItem | null;
+    protected _updateSelectedNextSibling(item?: CDSDropdownItem | null): void;
+    protected _highlightSelectedItem(): void;
+    protected _navigate(direction: number): void;
+    /**
+     * @returns The content preceding the trigger button.
+     */
+    protected _renderPrecedingLabel(): TemplateResult | undefined;
+    /**
+     * @returns The main content of the trigger button.
+     */
+    protected _renderLabel(): TemplateResult;
+    /**
+     * @returns The title label.
+     */
+    protected _renderTitleLabel(): TemplateResult;
+    /**
+     * @returns The content following the trigger button.
+     */
+    protected _renderFollowingLabel(): TemplateResult | undefined;
+    /**
+     * Handles event to include selected value on the parent form.
+     *
+     * @param event The event.
+     */
+    _handleFormdata(event: FormDataEvent): void;
+    /**
+     * 'aria-label' of the ListBox component.
+     * Specify a label to be read by screen readers on the container node
+     */
+    ariaLabel: string;
+    /**
+     * Specify the direction of the dropdown. Can be either top or bottom.
+     */
+    direction: DROPDOWN_DIRECTION;
+    /**
+     * Specify whether auto align functionality should be applied
+     */
+    autoalign: boolean;
+    /**
+     * `true` if this dropdown should be disabled.
+     */
+    disabled: boolean;
+    /**
+     * The helper text.
+     */
+    helperText: string;
+    /**
+     * Specify whether the title text should be hidden or not
+     */
+    hideLabel: boolean;
+    /**
+     * `true` to show the UI of the invalid state.
+     */
+    invalid: boolean;
+    /**
+     * Message which is displayed if the value is invalid.
+     */
+    invalidText: string;
+    /**
+     * Provide the title text that will be read by a screen reader when visiting this control
+     */
+    titleText: string;
+    /**
+     * Name for the dropdown in the `FormData`
+     */
+    name: string;
+    /**
+     * `true` if this dropdown should be open.
+     */
+    open: boolean;
+    /**
+     * Whether or not the Dropdown is readonly
+     */
+    readOnly: boolean;
+    /**
+     * `true` if the value is required.
+     */
+    required: boolean;
+    /**
+     * The special validity message for `required`.
+     */
+    requiredValidityMessage: string;
+    /**
+     * Dropdown size.
+     */
+    size: DROPDOWN_SIZE;
+    /**
+     * The `aria-label` attribute for the UI indicating the closed state.
+     */
+    toggleLabelClosed: string;
+    /**
+     * The `aria-label` attribute for the UI indicating the open state.
+     */
+    toggleLabelOpen: string;
+    /**
+     * Generic label that will be used as the textual representation of what this field is for
+     */
+    label: string;
+    /**
+     * `true` if this dropdown should use the inline UI variant.
+     */
+    type: DROPDOWN_TYPE;
+    /**
+     * The validity message.
+     */
+    validityMessage: string;
+    /**
+     * The value of the selected item.
+     */
+    value: string;
+    /**
+     * Specify whether the control is currently in warning state
+     */
+    warn: boolean;
+    /**
+     * Provide the text that is displayed when the control is in warning state
+     */
+    warnText: string;
+    /**
+     * The computed aria-label for the toggle button based on open state.
+     */
+    get toggleLabel(): string;
+    shouldUpdate(changedProperties: any): boolean;
+    updated(changedProperties: any): void;
+    /**
+     * Clears Floating UI styles when auto-align is off or the menu closes.
+     */
+    private _resetFloatingStyles;
+    /**
+     * Runs Floating UI placement while auto-align is active.
+     */
+    private _updateAutoAlignPlacement;
+    /**
+     * Normalizes validation props based on disabled and readOnly states
+     */
+    protected get _normalizedProps(): {
+        disabled: boolean;
+        invalid: boolean;
+        warn: boolean;
+    };
+    /**
+     * The CSS class list for dropdown listbox
+     */
+    protected get _classes(): any;
+    render(): TemplateResult<1>;
+    /**
+     * Symbols of keys that triggers opening/closing menu and selecting/deselecting menu item.
+     */
+    static TRIGGER_KEYS: Set<string>;
+    /**
+     * A selector that will return highlighted items.
+     */
+    static get selectorItemHighlighted(): string;
+    /**
+     * A selector that will return dropdown items.
+     */
+    static get selectorItem(): string;
+    /**
+     * A selector that will return selected items.
+     */
+    static get selectorItemSelected(): string;
+    /**
+     * The name of the custom event fired before a dropdown item is selected upon a user gesture.
+     * Cancellation of this event stops changing the user-initiated selection.
+     */
+    static get eventBeforeSelect(): string;
+    /**
+     * The name of the custom event fired after a a dropdown item is selected upon a user gesture.
+     */
+    static get eventSelect(): string;
+    /**
+     * The name of the custom event fired before this dropdown item is being toggled upon a user gesture.
+     * Cancellation of this event stops the user-initiated action of toggling this dropdown item.
+     */
+    static get eventBeforeToggle(): string;
+    /**
+     * The name of the custom event fired after this dropdown item is toggled upon a user gesture.
+     */
+    static get eventToggle(): string;
+    /**
+     * A selector that will return the slug item.
+     *
+     * remove in v12
+     */
+    static get slugItem(): string;
+    /**
+     * A selector that will return the AI Label item.
+     */
+    static get aiLabelItem(): string;
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    static styles: any;
+    /**
+     * @returns A action for dropdown for the given key symbol.
+     */
+    static getAction(key: string): DROPDOWN_KEYBOARD_ACTION;
+}
+export default CDSDropdown;
+//# sourceMappingURL=dropdown.d.ts.map

package/lib/components/dropdown/dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown/dropdown.ts"],"names":[],"mappings":"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"}

package/lib/components/dropdown/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright IBM Corp. 2021, 2022
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import './dropdown';
+import './dropdown-item';
+import './dropdown-skeleton';
+//# sourceMappingURL=index.d.ts.map

package/lib/components/dropdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/dropdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,YAAY,CAAC;AACpB,OAAO,iBAAiB,CAAC;AACzB,OAAO,qBAAqB,CAAC"}

package/lib/components/feature-flags/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright IBM Corp. 2025, 2026
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * <feature-flags> provides scoped feature flags to child components.
+ *
+ * Usage:
+ * Wrap any child components inside <feature-flags> to provide scoped feature flags like this:
+ * <feature-flags enable-dialog-element="true">
+ *   <component></component>
+ * </feature-flags>
+ *
+ * Available flags:
+ * - enable-dialog-element
+ * - enable-treeview-controllable
+ * - ... (and others listed in observedAttributes)
+ *
+ * How to check a Flag in your component:
+ *   import { isFeatureFlagEnabled } from './feature-flags';
+ *   isFeatureFlagEnabled('enable-dialog-element', this)
+ *   Returns true if the flag is enabled in the nearest <feature-flags> ancestor
+ */
+import { LitElement } from 'lit';
+declare class FeatureFlagsElement extends LitElement {
+    private scope;
+    private flags;
+    /**
+     * Mapping of feature flag attributes to their related component names.
+     */
+    private static readonly flagComponentMap;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, _oldVal: string | null, newVal: string | null): void;
+    private getParentScope;
+    private updateScope;
+    render(): import("lit-html").TemplateResult<1>;
+    isFeatureFlagEnabled(flag: string): any;
+    private getScope;
+}
+export default FeatureFlagsElement;
+export declare function findParentFeatureFlags(el: HTMLElement): FeatureFlagsElement | null;
+export declare function isFeatureFlagEnabled(flag: string, context: HTMLElement): boolean;
+//# sourceMappingURL=index.d.ts.map

package/lib/components/feature-flags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/feature-flags/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAYvC,cACM,mBAAoB,SAAQ,UAAU;IAC1C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,KAAK,CAAoB;IAEjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAU7B;IAEX,MAAM,KAAK,kBAAkB,aAE5B;;IAOD,iBAAiB;IAKjB,wBAAwB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBvB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,WAAW;IASnB,MAAM;IAIC,oBAAoB,CAAC,IAAI,EAAE,MAAM;IAIxC,OAAO,CAAC,QAAQ;CAGjB;AAED,eAAe,mBAAmB,CAAC;AAKnC,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,WAAW,GACd,mBAAmB,GAAG,IAAI,CAS5B;AAGD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,OAAO,CAGT"}

package/lib/components/file-uploader/defs.d.ts

@@ -1,11 +1,3 @@
-/**
- * Copyright IBM Corp. 2026
- *
- * This source code is licensed under the Apache-2.0 license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-//#region src/components/file-uploader/defs.d.ts
 /**
  * Copyright IBM Corp. 2020, 2022, 2023
  *
@@ -15,37 +7,35 @@
 /**
  * The state of `<cds-file-uploader-item>`.
  */
-declare enum FILE_UPLOADER_ITEM_STATE {
-  /**
-   * Upload in progress.
-   */
-  UPLOADING = "uploading",
-  /**
-   * Upload complete.
-   */
-  COMPLETE = "complete",
-  /**
-   * Editing.
-   */
-  EDIT = "edit"
+export declare enum FILE_UPLOADER_ITEM_STATE {
+    /**
+     * Upload in progress.
+     */
+    UPLOADING = "uploading",
+    /**
+     * Upload complete.
+     */
+    COMPLETE = "complete",
+    /**
+     * Editing.
+     */
+    EDIT = "edit"
 }
 /**
  * File uploader item size.
  */
-declare enum FILE_UPLOADER_ITEM_SIZE {
-  /**
-   * Small size.
-   */
-  SMALL = "sm",
-  /**
-   * Medium size.
-   */
-  MEDIUM = "md",
-  /**
-   * Large size.
-   */
-  LARGE = "lg"
+export declare enum FILE_UPLOADER_ITEM_SIZE {
+    /**
+     * Small size.
+     */
+    SMALL = "sm",
+    /**
+     * Medium size.
+     */
+    MEDIUM = "md",
+    /**
+     * Large size.
+     */
+    LARGE = "lg"
 }
-//#endregion
-export { FILE_UPLOADER_ITEM_SIZE, FILE_UPLOADER_ITEM_STATE };
 //# sourceMappingURL=defs.d.ts.map

package/lib/components/file-uploader/defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.d.ts","sourceRoot":"","sources":["../../../src/components/file-uploader/defs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,wBAAwB;IAClC;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,uBAAuB;IACjC;;OAEG;IACH,KAAK,OAAO;IAEZ;;OAEG;IACH,MAAM,OAAO;IAEb;;OAEG;IACH,KAAK,OAAO;CACb"}

package/lib/components/file-uploader/demo-file-uploader.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Copyright IBM Corp. 2019, 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { LitElement } from 'lit';
+import './index';
+import { BUTTON_SIZE } from '../button/button';
+/**
+ * A class to manage file uploading states, like sending file contents to server.
+ * DEMONSTRATION-PURPOSE ONLY.
+ * Data/state handling in file uploading tends to involve lots of application-specific logics
+ * and thus abstracting everything in a library won't be a good return on investment
+ * vs. letting users copy code here and implement features that fit their needs.
+ */
+export default class CDSCEDemoFileUploader extends LitElement {
+    /**
+     * The files being uploaded.
+     */
+    private _files;
+    /**
+     * Handles `cds-drop-container-changed` on `<cds-file-drop-container>`.
+     *
+     * @param event The event.
+     */
+    private _handleChange;
+    /**
+     * Handles `cds-file-uploader-item-deleted` on `<cds-file-uploader-item>`.
+     *
+     * @param event The event.
+     */
+    private _handleDelete;
+    /**
+     * Simulates updating file.
+     *
+     * @param data The data of the file being uploaded.
+     */
+    private _simulateUpload;
+    /**
+     * The file types the file input should accept, separated by space.
+     */
+    accept: string;
+    /**
+     * `true` if the drop container should be disabled.
+     */
+    button: boolean;
+    /**
+     * Button kind.
+     */
+    buttonKind: string;
+    /**
+     * Button label.
+     */
+    buttonLabel: string;
+    /**
+     * `true` if the drop container should be disabled.
+     */
+    disabled: boolean;
+    /**
+     * Icon description.
+     */
+    iconDescription: string;
+    /**
+     * The input name.
+     */
+    inputName: string;
+    /**
+     * The label description text.
+     */
+    labelDescription: string;
+    /**
+     * The label title.
+     */
+    labelTitle: string;
+    /**
+     * `true` if the drop container should accept more than one files at once.
+     * Note that even with `false` set here, user _can_ select multiple files one by one.
+     */
+    multiple: boolean;
+    /**
+     * The size of the button item.
+     */
+    size: BUTTON_SIZE;
+    /**
+     * The state of this file uploader item.
+     */
+    inputState: string;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=demo-file-uploader.d.ts.map

package/lib/components/file-uploader/demo-file-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-file-uploader.d.ts","sourceRoot":"","sources":["../../../src/components/file-uploader/demo-file-uploader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,UAAU,EAAE,MAAM,KAAK,CAAC;AAMvC,OAAO,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;;;;GAMG;AAEH,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,UAAU;IAC3D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAkB;IAEhC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;OAIG;YACW,eAAe;IA2C7B;;OAEG;IAEH,MAAM,SAAM;IAEZ;;OAEG;IAEH,MAAM,UAAS;IAEf;;OAEG;IAEH,UAAU,SAAa;IAEvB;;OAEG;IAEH,WAAW,SAAc;IAEzB;;OAEG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,eAAe,SAAM;IAErB;;OAEG;IAEH,SAAS,SAAM;IAEf;;OAEG;IAEH,gBAAgB,SAAM;IAEtB;;OAEG;IAEH,UAAU,SAAM;IAEhB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;OAEG;IAEH,IAAI,cAAsB;IAE1B;;OAEG;IAEH,UAAU,SAAM;IAEhB,MAAM;CAwDP"}