@spectrum-web-components/overlay 0.0.0-20241209155954

package/src/LongpressController.dev.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["LongpressController.ts"],
+  "sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport {\n    isAndroid,\n    isIOS,\n} from '@spectrum-web-components/shared/src/platform.js';\nimport { conditionAttributeWithId } from '@spectrum-web-components/base/src/condition-attribute-with-id.js';\nimport { randomID } from '@spectrum-web-components/shared/src/random-id.js';\n\nimport { noop } from './AbstractOverlay.dev.js'\nimport {\n    InteractionController,\n    InteractionTypes,\n} from './InteractionController.dev.js'\n\nconst LONGPRESS_DURATION = 300;\nexport const LONGPRESS_INSTRUCTIONS = {\n    touch: 'Double tap and long press for additional options',\n    keyboard: 'Press Space or Alt+Down Arrow for additional options',\n    mouse: 'Click and hold for additional options',\n};\n\ntype LongpressEvent = {\n    source: 'pointer' | 'keyboard';\n};\n\nexport class LongpressController extends InteractionController {\n    override type = InteractionTypes.longpress;\n\n    override get activelyOpening(): boolean {\n        return (\n            this.longpressState === 'opening' ||\n            this.longpressState === 'pressed'\n        );\n    }\n\n    protected longpressState: null | 'potential' | 'opening' | 'pressed' = null;\n\n    override releaseDescription = noop;\n\n    private timeout!: ReturnType<typeof setTimeout>;\n\n    handleLongpress(): void {\n        this.open = true;\n        this.longpressState =\n            this.longpressState === 'potential' ? 'opening' : 'pressed';\n    }\n\n    handlePointerdown(event: PointerEvent): void {\n        if (!this.target) return;\n        if (event.button !== 0) return;\n        this.longpressState = 'potential';\n        document.addEventListener('pointerup', this.handlePointerup);\n        document.addEventListener('pointercancel', this.handlePointerup);\n        // Only dispatch longpress event if the trigger element isn't doing it for us.\n        const triggerHandlesLongpress = 'holdAffordance' in this.target;\n        if (triggerHandlesLongpress) return;\n        this.timeout = setTimeout(() => {\n            if (!this.target) return;\n            this.target.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'pointer',\n                    },\n                })\n            );\n        }, LONGPRESS_DURATION);\n    }\n\n    private handlePointerup = (): void => {\n        clearTimeout(this.timeout);\n        if (!this.target) return;\n        // When triggered by the pointer, the last of `opened`\n        // or `pointerup` should move the `longpressState` to\n        // `null` so that the earlier event can void the \"light\n        // dismiss\" and keep the Overlay open.\n        this.longpressState =\n            this.overlay?.state === 'opening' ? 'pressed' : null;\n        document.removeEventListener('pointerup', this.handlePointerup);\n        document.removeEventListener('pointercancel', this.handlePointerup);\n    };\n\n    private handleKeydown(event: KeyboardEvent): void {\n        const { code, altKey } = event;\n        if (altKey && code === 'ArrowDown') {\n            event.stopPropagation();\n            event.stopImmediatePropagation();\n        }\n    }\n\n    private handleKeyup(event: KeyboardEvent): void {\n        const { code, altKey } = event;\n        if (code === 'Space' || (altKey && code === 'ArrowDown')) {\n            if (!this.target) {\n                return;\n            }\n            event.stopPropagation();\n            this.target.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'keyboard',\n                    },\n                })\n            );\n            setTimeout(() => {\n                this.longpressState = null;\n            });\n        }\n    }\n\n    override prepareDescription(trigger: HTMLElement): void {\n        if (\n            // do not reapply until target is recycled\n            this.releaseDescription !== noop ||\n            // require \"longpress content\" to apply relationship\n            !this.overlay.elements.length\n        ) {\n            return;\n        }\n\n        const longpressDescription = document.createElement('div');\n        longpressDescription.id = `longpress-describedby-descriptor-${randomID()}`;\n        const messageType = isIOS() || isAndroid() ? 'touch' : 'keyboard';\n        longpressDescription.textContent = LONGPRESS_INSTRUCTIONS[messageType];\n        longpressDescription.slot = 'longpress-describedby-descriptor';\n        const triggerParent = trigger.getRootNode() as HTMLElement;\n        const overlayParent = this.overlay.getRootNode() as HTMLElement;\n        // Manage the placement of the helper element in an accessible place with\n        // the lowest chance of negatively affecting the layout of the page.\n        if (triggerParent === overlayParent) {\n            // Trigger and Overlay in same DOM tree...\n            // Append helper element to Overlay.\n            this.overlay.append(longpressDescription);\n        } else {\n            // If Trigger in <body>, hide helper\n            longpressDescription.hidden = !('host' in triggerParent);\n            // Trigger and Overlay in different DOM tree, Trigger in shadow tree...\n            // Insert helper element after Trigger.\n            trigger.insertAdjacentElement('afterend', longpressDescription);\n        }\n\n        const releaseDescription = conditionAttributeWithId(\n            trigger,\n            'aria-describedby',\n            [longpressDescription.id]\n        );\n        this.releaseDescription = () => {\n            releaseDescription();\n            longpressDescription.remove();\n            this.releaseDescription = noop;\n        };\n    }\n\n    override shouldCompleteOpen(): void {\n        // When triggered by the pointer, the last of `opened`\n        // or `pointerup` should move the `longpressState` to\n        // `null` so that the earlier event can void the \"light\n        // dismiss\" and keep the Overlay open.\n        this.longpressState =\n            this.longpressState === 'pressed' ? null : this.longpressState;\n    }\n\n    override init(): void {\n        // Clean up listeners if they've already been bound\n        this.abortController?.abort();\n        this.abortController = new AbortController();\n        const { signal } = this.abortController;\n        this.target.addEventListener(\n            'longpress',\n            () => this.handleLongpress(),\n            { signal }\n        );\n        this.target.addEventListener(\n            'pointerdown',\n            (event: PointerEvent) => this.handlePointerdown(event),\n            { signal }\n        );\n\n        this.prepareDescription(this.target);\n        if (\n            (this.target as HTMLElement & { holdAffordance: boolean })\n                .holdAffordance\n        ) {\n            // Only bind keyboard events when the trigger element isn't doing it for us.\n            return;\n        }\n        this.target.addEventListener(\n            'keydown',\n            (event: KeyboardEvent) => this.handleKeydown(event),\n            { signal }\n        );\n        this.target.addEventListener(\n            'keyup',\n            (event: KeyboardEvent) => this.handleKeyup(event),\n            { signal }\n        );\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/src/LongpressController.js

@@ -0,0 +1,2 @@
+"use strict";import{isAndroid as a,isIOS as d}from"@spectrum-web-components/shared/src/platform.js";import{conditionAttributeWithId as p}from"@spectrum-web-components/base/src/condition-attribute-with-id.js";import{randomID as l}from"@spectrum-web-components/shared/src/random-id.js";import{noop as r}from"./AbstractOverlay.js";import{InteractionController as h,InteractionTypes as c}from"./InteractionController.js";const g=300;export const LONGPRESS_INSTRUCTIONS={touch:"Double tap and long press for additional options",keyboard:"Press Space or Alt+Down Arrow for additional options",mouse:"Click and hold for additional options"};export class LongpressController extends h{constructor(){super(...arguments);this.type=c.longpress;this.longpressState=null;this.releaseDescription=r;this.handlePointerup=()=>{var e;clearTimeout(this.timeout),this.target&&(this.longpressState=((e=this.overlay)==null?void 0:e.state)==="opening"?"pressed":null,document.removeEventListener("pointerup",this.handlePointerup),document.removeEventListener("pointercancel",this.handlePointerup))}}get activelyOpening(){return this.longpressState==="opening"||this.longpressState==="pressed"}handleLongpress(){this.open=!0,this.longpressState=this.longpressState==="potential"?"opening":"pressed"}handlePointerdown(e){!this.target||e.button!==0||(this.longpressState="potential",document.addEventListener("pointerup",this.handlePointerup),document.addEventListener("pointercancel",this.handlePointerup),"holdAffordance"in this.target)||(this.timeout=setTimeout(()=>{this.target&&this.target.dispatchEvent(new CustomEvent("longpress",{bubbles:!0,composed:!0,detail:{source:"pointer"}}))},g))}handleKeydown(e){const{code:t,altKey:o}=e;o&&t==="ArrowDown"&&(e.stopPropagation(),e.stopImmediatePropagation())}handleKeyup(e){const{code:t,altKey:o}=e;if(t==="Space"||o&&t==="ArrowDown"){if(!this.target)return;e.stopPropagation(),this.target.dispatchEvent(new CustomEvent("longpress",{bubbles:!0,composed:!0,detail:{source:"keyboard"}})),setTimeout(()=>{this.longpressState=null})}}prepareDescription(e){if(this.releaseDescription!==r||!this.overlay.elements.length)return;const t=document.createElement("div");t.id=`longpress-describedby-descriptor-${l()}`;const o=d()||a()?"touch":"keyboard";t.textContent=LONGPRESS_INSTRUCTIONS[o],t.slot="longpress-describedby-descriptor";const n=e.getRootNode(),s=this.overlay.getRootNode();n===s?this.overlay.append(t):(t.hidden=!("host"in n),e.insertAdjacentElement("afterend",t));const i=p(e,"aria-describedby",[t.id]);this.releaseDescription=()=>{i(),t.remove(),this.releaseDescription=r}}shouldCompleteOpen(){this.longpressState=this.longpressState==="pressed"?null:this.longpressState}init(){var t;(t=this.abortController)==null||t.abort(),this.abortController=new AbortController;const{signal:e}=this.abortController;this.target.addEventListener("longpress",()=>this.handleLongpress(),{signal:e}),this.target.addEventListener("pointerdown",o=>this.handlePointerdown(o),{signal:e}),this.prepareDescription(this.target),!this.target.holdAffordance&&(this.target.addEventListener("keydown",o=>this.handleKeydown(o),{signal:e}),this.target.addEventListener("keyup",o=>this.handleKeyup(o),{signal:e}))}}
+//# sourceMappingURL=LongpressController.js.map

package/src/LongpressController.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["LongpressController.ts"],
+  "sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\n\nimport {\n    isAndroid,\n    isIOS,\n} from '@spectrum-web-components/shared/src/platform.js';\nimport { conditionAttributeWithId } from '@spectrum-web-components/base/src/condition-attribute-with-id.js';\nimport { randomID } from '@spectrum-web-components/shared/src/random-id.js';\n\nimport { noop } from './AbstractOverlay.js';\nimport {\n    InteractionController,\n    InteractionTypes,\n} from './InteractionController.js';\n\nconst LONGPRESS_DURATION = 300;\nexport const LONGPRESS_INSTRUCTIONS = {\n    touch: 'Double tap and long press for additional options',\n    keyboard: 'Press Space or Alt+Down Arrow for additional options',\n    mouse: 'Click and hold for additional options',\n};\n\ntype LongpressEvent = {\n    source: 'pointer' | 'keyboard';\n};\n\nexport class LongpressController extends InteractionController {\n    override type = InteractionTypes.longpress;\n\n    override get activelyOpening(): boolean {\n        return (\n            this.longpressState === 'opening' ||\n            this.longpressState === 'pressed'\n        );\n    }\n\n    protected longpressState: null | 'potential' | 'opening' | 'pressed' = null;\n\n    override releaseDescription = noop;\n\n    private timeout!: ReturnType<typeof setTimeout>;\n\n    handleLongpress(): void {\n        this.open = true;\n        this.longpressState =\n            this.longpressState === 'potential' ? 'opening' : 'pressed';\n    }\n\n    handlePointerdown(event: PointerEvent): void {\n        if (!this.target) return;\n        if (event.button !== 0) return;\n        this.longpressState = 'potential';\n        document.addEventListener('pointerup', this.handlePointerup);\n        document.addEventListener('pointercancel', this.handlePointerup);\n        // Only dispatch longpress event if the trigger element isn't doing it for us.\n        const triggerHandlesLongpress = 'holdAffordance' in this.target;\n        if (triggerHandlesLongpress) return;\n        this.timeout = setTimeout(() => {\n            if (!this.target) return;\n            this.target.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'pointer',\n                    },\n                })\n            );\n        }, LONGPRESS_DURATION);\n    }\n\n    private handlePointerup = (): void => {\n        clearTimeout(this.timeout);\n        if (!this.target) return;\n        // When triggered by the pointer, the last of `opened`\n        // or `pointerup` should move the `longpressState` to\n        // `null` so that the earlier event can void the \"light\n        // dismiss\" and keep the Overlay open.\n        this.longpressState =\n            this.overlay?.state === 'opening' ? 'pressed' : null;\n        document.removeEventListener('pointerup', this.handlePointerup);\n        document.removeEventListener('pointercancel', this.handlePointerup);\n    };\n\n    private handleKeydown(event: KeyboardEvent): void {\n        const { code, altKey } = event;\n        if (altKey && code === 'ArrowDown') {\n            event.stopPropagation();\n            event.stopImmediatePropagation();\n        }\n    }\n\n    private handleKeyup(event: KeyboardEvent): void {\n        const { code, altKey } = event;\n        if (code === 'Space' || (altKey && code === 'ArrowDown')) {\n            if (!this.target) {\n                return;\n            }\n            event.stopPropagation();\n            this.target.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'keyboard',\n                    },\n                })\n            );\n            setTimeout(() => {\n                this.longpressState = null;\n            });\n        }\n    }\n\n    override prepareDescription(trigger: HTMLElement): void {\n        if (\n            // do not reapply until target is recycled\n            this.releaseDescription !== noop ||\n            // require \"longpress content\" to apply relationship\n            !this.overlay.elements.length\n        ) {\n            return;\n        }\n\n        const longpressDescription = document.createElement('div');\n        longpressDescription.id = `longpress-describedby-descriptor-${randomID()}`;\n        const messageType = isIOS() || isAndroid() ? 'touch' : 'keyboard';\n        longpressDescription.textContent = LONGPRESS_INSTRUCTIONS[messageType];\n        longpressDescription.slot = 'longpress-describedby-descriptor';\n        const triggerParent = trigger.getRootNode() as HTMLElement;\n        const overlayParent = this.overlay.getRootNode() as HTMLElement;\n        // Manage the placement of the helper element in an accessible place with\n        // the lowest chance of negatively affecting the layout of the page.\n        if (triggerParent === overlayParent) {\n            // Trigger and Overlay in same DOM tree...\n            // Append helper element to Overlay.\n            this.overlay.append(longpressDescription);\n        } else {\n            // If Trigger in <body>, hide helper\n            longpressDescription.hidden = !('host' in triggerParent);\n            // Trigger and Overlay in different DOM tree, Trigger in shadow tree...\n            // Insert helper element after Trigger.\n            trigger.insertAdjacentElement('afterend', longpressDescription);\n        }\n\n        const releaseDescription = conditionAttributeWithId(\n            trigger,\n            'aria-describedby',\n            [longpressDescription.id]\n        );\n        this.releaseDescription = () => {\n            releaseDescription();\n            longpressDescription.remove();\n            this.releaseDescription = noop;\n        };\n    }\n\n    override shouldCompleteOpen(): void {\n        // When triggered by the pointer, the last of `opened`\n        // or `pointerup` should move the `longpressState` to\n        // `null` so that the earlier event can void the \"light\n        // dismiss\" and keep the Overlay open.\n        this.longpressState =\n            this.longpressState === 'pressed' ? null : this.longpressState;\n    }\n\n    override init(): void {\n        // Clean up listeners if they've already been bound\n        this.abortController?.abort();\n        this.abortController = new AbortController();\n        const { signal } = this.abortController;\n        this.target.addEventListener(\n            'longpress',\n            () => this.handleLongpress(),\n            { signal }\n        );\n        this.target.addEventListener(\n            'pointerdown',\n            (event: PointerEvent) => this.handlePointerdown(event),\n            { signal }\n        );\n\n        this.prepareDescription(this.target);\n        if (\n            (this.target as HTMLElement & { holdAffordance: boolean })\n                .holdAffordance\n        ) {\n            // Only bind keyboard events when the trigger element isn't doing it for us.\n            return;\n        }\n        this.target.addEventListener(\n            'keydown',\n            (event: KeyboardEvent) => this.handleKeydown(event),\n            { signal }\n        );\n        this.target.addEventListener(\n            'keyup',\n            (event: KeyboardEvent) => this.handleKeyup(event),\n            { signal }\n        );\n    }\n}\n"],
+  "mappings": "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",
+  "names": ["isAndroid", "isIOS", "conditionAttributeWithId", "randomID", "noop", "InteractionController", "InteractionTypes", "LONGPRESS_DURATION", "_a", "event", "code", "altKey", "trigger", "longpressDescription", "messageType", "triggerParent", "overlayParent", "releaseDescription", "signal"]
+}

package/src/Overlay.d.ts

@@ -0,0 +1,134 @@
+import { PropertyValues, TemplateResult } from '@spectrum-web-components/base';
+import { ElementResolutionController } from '@spectrum-web-components/reactive-controllers/src/ElementResolution.js';
+import type { OpenableElement, OverlayState, OverlayTypes, Placement, TriggerInteraction } from './overlay-types.js';
+import { AbstractOverlay } from './AbstractOverlay.js';
+import { VirtualTrigger } from './VirtualTrigger.js';
+import { PlacementController } from './PlacementController.js';
+import type { ClickController } from './ClickController.js';
+import type { HoverController } from './HoverController.js';
+import type { LongpressController } from './LongpressController.js';
+export { LONGPRESS_INSTRUCTIONS } from './LongpressController.js';
+declare let OverlayFeatures: typeof AbstractOverlay & import("./overlay-types.js").Constructor<import("@spectrum-web-components/base").SpectrumElement>;
+/**
+ * @element sp-overlay
+ *
+ * @fires sp-opened - announces that an overlay has completed any entry animations
+ * @fires sp-closed - announce that an overlay has compelted any exit animations
+ * @fires slottable-request - requests to add or remove slottable content
+ */
+export declare class Overlay extends OverlayFeatures {
+    static styles: import("@spectrum-web-components/base").CSSResult[];
+    /**
+     * An Overlay that is `delayed` will wait until a warm-up period of 1000ms
+     * has completed before opening. Once the warmup period has completed, all
+     * subsequent Overlays will open immediately. When no Overlays are opened,
+     * a cooldown period of 1000ms will begin. Once the cooldown has completed,
+     * the next Overlay to be opened will be subject to the warm-up period if
+     * provided that option.
+     */
+    get delayed(): boolean;
+    set delayed(delayed: boolean);
+    private _delayed;
+    dialogEl: HTMLDialogElement & {
+        showPopover(): void;
+        hidePopover(): void;
+    };
+    /**
+     * Whether the overlay is currently functional or not
+     */
+    get disabled(): boolean;
+    set disabled(disabled: boolean);
+    private _disabled;
+    elements: OpenableElement[];
+    parentOverlayToForceClose?: Overlay;
+    private get hasNonVirtualTrigger();
+    /**
+     * The `offset` property accepts either a single number, to
+     * define the offset of the Overlay along the main axis from
+     * the trigger, or 2-tuple, to define the offset along the
+     * main axis and the cross axis. This option has no effect
+     * when there is no trigger element.
+     */
+    offset: number | [number, number];
+    protected get placementController(): PlacementController;
+    /**
+     * Whether the Overlay is projected onto the "top layer" or not.
+     */
+    get open(): boolean;
+    set open(open: boolean);
+    private _open;
+    static openCount: number;
+    /**
+     * Instruct the Overlay where to place itself in
+     * relationship to the trigger element.
+     * @type {"top" | "top-start" | "top-end" | "right" | "right-start" | "right-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end"}
+     */
+    placement?: Placement;
+    /**
+     * The state in which the last `request-slottable` event was dispatched.
+     * Do not allow overlays from dispatching the same state twice in a row.
+     */
+    private lastRequestSlottableState;
+    /**
+     * Whether to pass focus to the overlay once opened, or
+     * to the appropriate value based on the "type" of the overlay
+     * when set to `"auto"`.
+     *
+     */
+    receivesFocus: 'true' | 'false' | 'auto';
+    slotEl: HTMLSlotElement;
+    get state(): OverlayState;
+    set state(state: OverlayState);
+    _state: OverlayState;
+    strategy?: ClickController | HoverController | LongpressController;
+    tipPadding?: number;
+    /**
+     * An optional ID reference for the trigger element combined with the optional
+     * interaction (click | hover | longpress) by which the overlay shold open
+     * the overlay with an `@`: e.g. `trigger@click` opens the overlay when an
+     * element with the ID "trigger" is clicked.
+     */
+    trigger?: string;
+    /**
+     * An element reference for the trigger element that the overlay should relate to.
+     */
+    triggerElement: HTMLElement | VirtualTrigger | null;
+    /**
+     * The specific interaction to listen for on the `triggerElement` to open the overlay.
+     */
+    triggerInteraction?: TriggerInteraction;
+    /**
+     * Configures the open/close heuristics of the Overlay.
+     * @type {"auto" | "hint" | "manual" | "modal" | "page"}
+     */
+    type: OverlayTypes;
+    protected wasOpen: boolean;
+    protected get elementResolver(): ElementResolutionController;
+    private get usesDialog();
+    private get popoverValue();
+    protected get requiresPosition(): boolean;
+    protected managePosition(): void;
+    protected managePopoverOpen(): Promise<void>;
+    protected applyFocus(targetOpenState: boolean, focusEl: HTMLElement | null): Promise<void>;
+    protected returnFocus(): void;
+    private closeOnFocusOut;
+    protected manageOpen(oldOpen: boolean): Promise<void>;
+    protected bindEvents(): void;
+    protected handleBeforetoggle(event: Event & {
+        newState: string;
+    }): void;
+    protected handleBrowserClose(event: Event): void;
+    manuallyKeepOpen(): void;
+    protected handleSlotchange(): void;
+    shouldPreventClose(): boolean;
+    protected requestSlottable(): void;
+    willUpdate(changes: PropertyValues): void;
+    protected updated(changes: PropertyValues): void;
+    protected renderContent(): TemplateResult;
+    private get dialogStyleMap();
+    protected renderDialog(): TemplateResult;
+    protected renderPopover(): TemplateResult;
+    render(): TemplateResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}