@spectrum-web-components/menu 1.7.0 → 1.8.0

package/custom-elements.json

@@ -103,6 +103,63 @@
               },
               "privacy": "protected"
             },
+            {
+              "kind": "field",
+              "name": "touchStartY",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "iPad scroll detection properties\n\nThis feature prevents menu item selection during iPad scrolling to avoid\naccidental selections when users are trying to scroll through a long menu.\n\nHow it works:\n1. On touchstart: Record initial Y position and timestamp\n2. On touchmove: Calculate vertical movement and time elapsed\n3. If movement > threshold AND time < threshold: Mark as scrolling\n4. On touchend: Reset scrolling state after a delay\n5. During selection: Prevent selection if scrolling is detected\n\nThis prevents the common iPad issue where users accidentally select menu\nitems while trying to scroll through the menu content.\n\nThreshold Values:\n- Movement threshold: 10px (consistent with Card component click vs. drag detection)\n- Time threshold: 300ms (consistent with longpress duration across the design system)\n- Reset delay: 100ms (allows final touch events to be processed)\n\nThese values are carefully chosen to balance preventing accidental triggers\nwhile allowing intentional scroll gestures. They represent a common UX pattern\nin mobile interfaces and are consistent with other components in the design system."
+            },
+            {
+              "kind": "field",
+              "name": "touchStartTime",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "isCurrentlyScrolling",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "scrollThreshold",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "10",
+              "description": "Minimum vertical movement (in pixels) required to trigger scrolling detection.\n\nThis threshold is consistent with other components in the design system:\n- Card component uses 10px for click vs. drag detection\n- Menu component uses 10px for scroll vs. selection detection\n\nThe 10px threshold is carefully chosen to:\n- Allow for natural finger tremor and accidental touches\n- Distinguish between intentional scroll gestures and taps\n- Provide consistent behavior across the platform"
+            },
+            {
+              "kind": "field",
+              "name": "scrollTimeThreshold",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "300",
+              "description": "Maximum time (in milliseconds) for a movement to be considered scrolling.\n\nThis threshold is consistent with other timing values in the design system:\n- Longpress duration: 300ms (ActionButton, LongpressController)\n- Scroll detection: 300ms (Menu component)\n\nQuick movements within this timeframe are likely intentional scrolls,\nwhile slower movements are more likely taps or selections."
+            },
+            {
+              "kind": "field",
+              "name": "isScrolling",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "description": "Public getter for scrolling state\nReturns true if the component is currently in a scrolling state"
+            },
             {
               "kind": "field",
               "name": "label",
@@ -425,6 +482,57 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleTouchStart",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "TouchEvent"
+                  },
+                  "description": "The TouchEvent from the touchstart event"
+                }
+              ],
+              "description": "Handles touchstart events for iPad scroll detection.\n\nRecords the initial touch position and timestamp to establish a baseline\nfor detecting scroll gestures. Only processes single-touch events to\navoid interference with multi-touch gestures."
+            },
+            {
+              "kind": "method",
+              "name": "handleTouchMove",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "TouchEvent"
+                  },
+                  "description": "The TouchEvent from the touchmove event"
+                }
+              ],
+              "description": "Handles touchmove events for iPad scroll detection.\n\nCalculates the vertical movement distance and time elapsed since touchstart.\nIf the movement exceeds the threshold (10px) and happens within the time\nthreshold (300ms), it marks the interaction as scrolling. This helps\ndistinguish between intentional scroll gestures and accidental touches."
+            },
+            {
+              "kind": "method",
+              "name": "handleTouchEnd",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Handles touchend events for iPad scroll detection.\n\nResets the scrolling state after a short delay (100ms) to allow for\nany final touch events to be processed. This delay prevents immediate\nstate changes that could interfere with the selection logic.\n\nThe 100ms delay is consistent with the design system's approach to\ntouch event handling and ensures that any final touch events or\ngesture recognition can complete before the scrolling state is reset."
+            },
             {
               "kind": "field",
               "name": "pointerUpTarget",
@@ -1044,6 +1152,87 @@
                 "module": "src/Menu.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "touchStartY",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "description": "iPad scroll detection properties\n\nThis feature prevents menu item selection during iPad scrolling to avoid\naccidental selections when users are trying to scroll through a long menu.\n\nHow it works:\n1. On touchstart: Record initial Y position and timestamp\n2. On touchmove: Calculate vertical movement and time elapsed\n3. If movement > threshold AND time < threshold: Mark as scrolling\n4. On touchend: Reset scrolling state after a delay\n5. During selection: Prevent selection if scrolling is detected\n\nThis prevents the common iPad issue where users accidentally select menu\nitems while trying to scroll through the menu content.\n\nThreshold Values:\n- Movement threshold: 10px (consistent with Card component click vs. drag detection)\n- Time threshold: 300ms (consistent with longpress duration across the design system)\n- Reset delay: 100ms (allows final touch events to be processed)\n\nThese values are carefully chosen to balance preventing accidental triggers\nwhile allowing intentional scroll gestures. They represent a common UX pattern\nin mobile interfaces and are consistent with other components in the design system.",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "touchStartTime",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "default": "undefined",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isCurrentlyScrolling",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollThreshold",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "10",
+              "description": "Minimum vertical movement (in pixels) required to trigger scrolling detection.\n\nThis threshold is consistent with other components in the design system:\n- Card component uses 10px for click vs. drag detection\n- Menu component uses 10px for scroll vs. selection detection\n\nThe 10px threshold is carefully chosen to:\n- Allow for natural finger tremor and accidental touches\n- Distinguish between intentional scroll gestures and taps\n- Provide consistent behavior across the platform",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollTimeThreshold",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "300",
+              "description": "Maximum time (in milliseconds) for a movement to be considered scrolling.\n\nThis threshold is consistent with other timing values in the design system:\n- Longpress duration: 300ms (ActionButton, LongpressController)\n- Scroll detection: 300ms (Menu component)\n\nQuick movements within this timeframe are likely intentional scrolls,\nwhile slower movements are more likely taps or selections.",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isScrolling",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "public",
+              "description": "Public getter for scrolling state\nReturns true if the component is currently in a scrolling state",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
             {
               "kind": "field",
               "name": "label",
@@ -1456,6 +1645,69 @@
                 "module": "src/Menu.js"
               }
             },
+            {
+              "kind": "method",
+              "name": "handleTouchStart",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "TouchEvent"
+                  },
+                  "description": "The TouchEvent from the touchstart event"
+                }
+              ],
+              "description": "Handles touchstart events for iPad scroll detection.\n\nRecords the initial touch position and timestamp to establish a baseline\nfor detecting scroll gestures. Only processes single-touch events to\navoid interference with multi-touch gestures.",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleTouchMove",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "TouchEvent"
+                  },
+                  "description": "The TouchEvent from the touchmove event"
+                }
+              ],
+              "description": "Handles touchmove events for iPad scroll detection.\n\nCalculates the vertical movement distance and time elapsed since touchstart.\nIf the movement exceeds the threshold (10px) and happens within the time\nthreshold (300ms), it marks the interaction as scrolling. This helps\ndistinguish between intentional scroll gestures and accidental touches.",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleTouchEnd",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Handles touchend events for iPad scroll detection.\n\nResets the scrolling state after a short delay (100ms) to allow for\nany final touch events to be processed. This delay prevents immediate\nstate changes that could interfere with the selection logic.\n\nThe 100ms delay is consistent with the design system's approach to\ntouch event handling and ensures that any final touch events or\ngesture recognition can complete before the scrolling state is reset.",
+              "inheritedFrom": {
+                "name": "Menu",
+                "module": "src/Menu.js"
+              }
+            },
             {
               "kind": "field",
               "name": "pointerUpTarget",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@spectrum-web-components/menu",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "publishConfig": {
         "access": "public"
     },
@@ -96,15 +96,15 @@
     ],
     "dependencies": {
         "@lit-labs/observers": "^2.0.2",
-        "@spectrum-web-components/action-button": "1.7.0",
-        "@spectrum-web-components/base": "1.7.0",
-        "@spectrum-web-components/divider": "1.7.0",
-        "@spectrum-web-components/icon": "1.7.0",
-        "@spectrum-web-components/icons-ui": "1.7.0",
-        "@spectrum-web-components/overlay": "1.7.0",
-        "@spectrum-web-components/popover": "1.7.0",
-        "@spectrum-web-components/reactive-controllers": "1.7.0",
-        "@spectrum-web-components/shared": "1.7.0"
+        "@spectrum-web-components/action-button": "1.8.0",
+        "@spectrum-web-components/base": "1.8.0",
+        "@spectrum-web-components/divider": "1.8.0",
+        "@spectrum-web-components/icon": "1.8.0",
+        "@spectrum-web-components/icons-ui": "1.8.0",
+        "@spectrum-web-components/overlay": "1.8.0",
+        "@spectrum-web-components/popover": "1.8.0",
+        "@spectrum-web-components/reactive-controllers": "1.8.0",
+        "@spectrum-web-components/shared": "1.8.0"
     },
     "types": "./src/index.d.ts",
     "customElements": "custom-elements.json",

package/sp-menu-divider.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 import { MenuDivider } from './src/MenuDivider.js';
 declare global {
     interface HTMLElementTagNameMap {

package/sp-menu-divider.dev.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-divider.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuDivider } from './src/MenuDivider.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuDivider } from './src/MenuDivider.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
   "mappings": ";AAWA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAE9B,cAAc,mBAAmB,WAAW;",
   "names": []
 }

package/sp-menu-divider.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-divider.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuDivider } from './src/MenuDivider.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuDivider } from './src/MenuDivider.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-divider', MenuDivider);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-divider': MenuDivider;\n    }\n}\n"],
   "mappings": "aAWA,OAAS,eAAAA,MAAmB,uBAC5B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,kBAAmBD,CAAW",
   "names": ["MenuDivider", "defineElement"]
 }

package/sp-menu-group.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 import { MenuGroup } from './src/MenuGroup.js';
 declare global {
     interface HTMLElementTagNameMap {

package/sp-menu-group.dev.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-group.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuGroup } from './src/MenuGroup.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuGroup } from './src/MenuGroup.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
   "mappings": ";AAWA,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAE9B,cAAc,iBAAiB,SAAS;",
   "names": []
 }

package/sp-menu-group.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-group.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuGroup } from './src/MenuGroup.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuGroup } from './src/MenuGroup.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-group', MenuGroup);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-group': MenuGroup;\n    }\n}\n"],
   "mappings": "aAWA,OAAS,aAAAA,MAAiB,qBAC1B,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,gBAAiBD,CAAS",
   "names": ["MenuGroup", "defineElement"]
 }

package/sp-menu-item.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 import { MenuItem } from './src/MenuItem.js';
 declare global {
     interface HTMLElementTagNameMap {

package/sp-menu-item.dev.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-item.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuItem } from './src/MenuItem.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuItem } from './src/MenuItem.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
   "mappings": ";AAWA,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAE9B,cAAc,gBAAgB,QAAQ;",
   "names": []
 }

package/sp-menu-item.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu-item.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { MenuItem } from './src/MenuItem.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { MenuItem } from './src/MenuItem.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu-item', MenuItem);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu-item': MenuItem;\n    }\n}\n"],
   "mappings": "aAWA,OAAS,YAAAA,MAAgB,oBACzB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,eAAgBD,CAAQ",
   "names": ["MenuItem", "defineElement"]
 }

package/sp-menu.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 import { Menu } from './src/Menu.js';
 declare global {
     interface HTMLElementTagNameMap {

package/sp-menu.dev.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { Menu } from './src/Menu.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { Menu } from './src/Menu.dev.js'\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
   "mappings": ";AAWA,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAE9B,cAAc,WAAW,IAAI;",
   "names": []
 }

package/sp-menu.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["sp-menu.ts"],
-  "sourcesContent": ["/*\nCopyright 2020 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*/\nimport { Menu } from './src/Menu.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
+  "sourcesContent": ["/**\n * Copyright 2025 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nimport { Menu } from './src/Menu.js';\nimport { defineElement } from '@spectrum-web-components/base/src/define-element.js';\n\ndefineElement('sp-menu', Menu);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-menu': Menu;\n    }\n}\n"],
   "mappings": "aAWA,OAAS,QAAAA,MAAY,gBACrB,OAAS,iBAAAC,MAAqB,sDAE9BA,EAAc,UAAWD,CAAI",
   "names": ["Menu", "defineElement"]
 }

package/src/Menu.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Copyright 2025 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 import { CSSResultArray, PropertyValues, SpectrumElement, TemplateResult } from '@spectrum-web-components/base';
 import { MenuItem } from './MenuItem.js';
 import type { MenuItemKeydownEvent } from './MenuItem.js';
@@ -35,6 +46,69 @@ export declare class Menu extends Menu_base {
     };
     private get isSubmenu();
     protected rovingTabindexController?: RovingTabindexController<MenuItem>;
+    /**
+     * iPad scroll detection properties
+     *
+     * This feature prevents menu item selection during iPad scrolling to avoid
+     * accidental selections when users are trying to scroll through a long menu.
+     *
+     * How it works:
+     * 1. On touchstart: Record initial Y position and timestamp
+     * 2. On touchmove: Calculate vertical movement and time elapsed
+     * 3. If movement > threshold AND time < threshold: Mark as scrolling
+     * 4. On touchend: Reset scrolling state after a delay
+     * 5. During selection: Prevent selection if scrolling is detected
+     *
+     * This prevents the common iPad issue where users accidentally select menu
+     * items while trying to scroll through the menu content.
+     *
+     * Threshold Values:
+     * - Movement threshold: 10px (consistent with Card component click vs. drag detection)
+     * - Time threshold: 300ms (consistent with longpress duration across the design system)
+     * - Reset delay: 100ms (allows final touch events to be processed)
+     *
+     * These values are carefully chosen to balance preventing accidental triggers
+     * while allowing intentional scroll gestures. They represent a common UX pattern
+     * in mobile interfaces and are consistent with other components in the design system.
+     */
+    private touchStartY;
+    private touchStartTime;
+    private isCurrentlyScrolling;
+    /**
+     * Minimum vertical movement (in pixels) required to trigger scrolling detection.
+     *
+     * This threshold is consistent with other components in the design system:
+     * - Card component uses 10px for click vs. drag detection
+     * - Menu component uses 10px for scroll vs. selection detection
+     *
+     * The 10px threshold is carefully chosen to:
+     * - Allow for natural finger tremor and accidental touches
+     * - Distinguish between intentional scroll gestures and taps
+     * - Provide consistent behavior across the platform
+     *
+     * @see {@link packages/card/src/Card.ts} for similar threshold usage
+     */
+    private scrollThreshold;
+    /**
+     * Maximum time (in milliseconds) for a movement to be considered scrolling.
+     *
+     * This threshold is consistent with other timing values in the design system:
+     * - Longpress duration: 300ms (ActionButton, LongpressController)
+     * - Scroll detection: 300ms (Menu component)
+     *
+     * Quick movements within this timeframe are likely intentional scrolls,
+     * while slower movements are more likely taps or selections.
+     *
+     * @see {@link packages/action-button/src/ActionButton.ts} for longpress duration
+     * @see {@link packages/overlay/src/LongpressController.ts} for longpress duration
+     */
+    private scrollTimeThreshold;
+    /**
+     * Public getter for scrolling state
+     * Returns true if the component is currently in a scrolling state
+     */
+    get isScrolling(): boolean;
+    set isScrolling(value: boolean);
     /**
      * label of the menu
      */
@@ -127,6 +201,39 @@ export declare class Menu extends Menu_base {
      */
     focusOnFirstSelectedItem({ preventScroll, }?: FocusOptions): void;
     focus({ preventScroll }?: FocusOptions): void;
+    /**
+     * Handles touchstart events for iPad scroll detection.
+     *
+     * Records the initial touch position and timestamp to establish a baseline
+     * for detecting scroll gestures. Only processes single-touch events to
+     * avoid interference with multi-touch gestures.
+     *
+     * @param event - The TouchEvent from the touchstart event
+     */
+    private handleTouchStart;
+    /**
+     * Handles touchmove events for iPad scroll detection.
+     *
+     * Calculates the vertical movement distance and time elapsed since touchstart.
+     * If the movement exceeds the threshold (10px) and happens within the time
+     * threshold (300ms), it marks the interaction as scrolling. This helps
+     * distinguish between intentional scroll gestures and accidental touches.
+     *
+     * @param event - The TouchEvent from the touchmove event
+     */
+    private handleTouchMove;
+    /**
+     * Handles touchend events for iPad scroll detection.
+     *
+     * Resets the scrolling state after a short delay (100ms) to allow for
+     * any final touch events to be processed. This delay prevents immediate
+     * state changes that could interfere with the selection logic.
+     *
+     * The 100ms delay is consistent with the design system's approach to
+     * touch event handling and ensures that any final touch events or
+     * gesture recognition can complete before the scrolling state is reset.
+     */
+    private handleTouchEnd;
     private pointerUpTarget;
     private handleFocusout;
     private handleClick;