@m3e/core 1.1.2 → 1.1.3

package/dist/custom-elements.json

@@ -1180,69 +1180,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/shared/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./controllers\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./decorators\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./directives\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./mixins\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./primitives\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./tokens\""
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./utils\""
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/platform/index.ts",
@@ -1344,6 +1281,69 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./controllers\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./decorators\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./directives\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./mixins\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./primitives\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./tokens\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./utils\""
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/a11y/keycodes/getKeyCode.ts",
@@ -5507,6 +5507,86 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/controllers/AnimationLoopController.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A `ReactiveController` used to execute a function in an animation loop.",
+          "name": "AnimationLoopController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "#frameId",
+              "privacy": "private",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#lastTime",
+              "privacy": "private",
+              "type": {
+                "text": "number"
+              },
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "#running",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#callback",
+              "privacy": "private",
+              "type": {
+                "text": "(deltaTime: number, elapsedTime: number) => void"
+              },
+              "readonly": true,
+              "default": "callback"
+            },
+            {
+              "kind": "field",
+              "name": "#loop",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "hostDisconnected"
+            },
+            {
+              "kind": "method",
+              "name": "start",
+              "description": "Starts the animation loop."
+            },
+            {
+              "kind": "method",
+              "name": "stop",
+              "description": "Stops the animation loop."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AnimationLoopController",
+          "declaration": {
+            "name": "AnimationLoopController",
+            "module": "src/shared/controllers/AnimationLoopController.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shared/controllers/FocusController.ts",
@@ -5516,6 +5596,15 @@
           "description": "A `ReactiveController` used to monitor the focused state of one or more elements.",
           "name": "FocusController",
           "members": [
+            {
+              "kind": "field",
+              "name": "#touch",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "#callback",
@@ -5525,6 +5614,12 @@
               },
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "#keyDownHandler",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "#focusInHandler",
@@ -5537,6 +5632,18 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "#touchStartHandler",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "#touchEndHandler",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "_observe",
@@ -5585,6 +5692,24 @@
                 "module": "src/shared/controllers/MonitorControllerBase.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "#handleKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "#handleFocusIn",
@@ -6214,6 +6339,14 @@
       "path": "src/shared/controllers/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./AnimationLoopController\""
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -8473,20 +8606,142 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/shared/primitives/CollapsibleElement.ts",
-      "declarations": [
+      "path": "src/shared/directives/index.ts",
+      "declarations": [],
+      "exports": [
         {
-          "kind": "class",
-          "description": "A container used to expand and collapse content.",
-          "name": "M3eCollapsibleElement",
-          "cssProperties": [
-            {
-              "description": "The duration of the expand / collapse animation.",
-              "name": "--m3e-collapsible-animation-duration"
-            }
-          ],
-          "slots": [
-            {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./safeStyleMap\""
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/directives/safeStyleMap.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SafeStyleMapDirective",
+          "members": [
+            {
+              "kind": "field",
+              "name": "_previousStyleProperties",
+              "type": {
+                "text": "Set<string> | undefined"
+              },
+              "privacy": "private"
+            }
+          ],
+          "superclass": {
+            "name": "Directive",
+            "package": "lit/directive.js"
+          }
+        },
+        {
+          "kind": "variable",
+          "name": "safeStyleMap",
+          "description": "A directive that applies CSS properties to an element.\r\n\r\n`safeStyleMap` can only be used in the `style` attribute and must be the only\r\nexpression in the attribute. It takes the property names in the\r\nStyleInfostyleInfo object and adds the properties to the inline\r\nstyle of the element.\r\n\r\nProperty names with dashes (`-`) are assumed to be valid CSS\r\nproperty names and set on the element's style object using `setProperty()`.\r\nNames without dashes are assumed to be camelCased JavaScript property names\r\nand set on the element's style object using property assignment, allowing the\r\nstyle object to translate JavaScript-style names to CSS property names.\r\n\r\nFor example `safeStyleMap({backgroundColor: 'red', 'border-top': '5px', '--size':\r\n'0'})` sets the `background-color`, `border-top` and `--size` properties.",
+          "parameters": [
+            {
+              "name": "styleInfo"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "safeStyleMap",
+          "declaration": {
+            "name": "safeStyleMap",
+            "module": "src/shared/directives/safeStyleMap.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SafeStyleMapDirective",
+          "declaration": {
+            "name": "SafeStyleMapDirective",
+            "module": "src/shared/directives/safeStyleMap.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/primitives/ActionElementBase.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A base implementation for an element, nested within a clickable element, used to\r\nperform an action. This class must be inherited.",
+          "name": "ActionElementBase",
+          "members": [
+            {
+              "kind": "field",
+              "name": "#clickHandler",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_onClick",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  },
+                  "description": "The click event to handle."
+                }
+              ],
+              "description": "When implemented by a derived class, handles the specified click event."
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ActionElementBase",
+          "declaration": {
+            "name": "ActionElementBase",
+            "module": "src/shared/primitives/ActionElementBase.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/primitives/CollapsibleElement.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A container used to expand and collapse content.",
+          "name": "M3eCollapsibleElement",
+          "cssProperties": [
+            {
+              "description": "The duration of the expand / collapse animation.",
+              "name": "--m3e-collapsible-animation-duration"
+            }
+          ],
+          "slots": [
+            {
               "description": "Renders the collapsible content.",
               "name": ""
             }
@@ -9228,6 +9483,14 @@
       "path": "src/shared/primitives/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./ActionElementBase\""
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -10326,10 +10589,21 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether hover and focus event will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
+              "description": "Whether hover and focus events will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "disableHover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether hover events will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
+              "attribute": "disable-hover",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "show",
@@ -10493,7 +10767,7 @@
           ],
           "attributes": [
             {
-              "description": "Whether hover and focus event will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
+              "description": "Whether hover and focus events will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
               "name": "disabled",
               "type": {
                 "text": "boolean"
@@ -10501,6 +10775,15 @@
               "default": "false",
               "fieldName": "disabled"
             },
+            {
+              "description": "Whether hover events will not trigger the state layer. State layers can still\r\nbe controlled manually using the `show` and `hide` methods.",
+              "name": "disable-hover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disableHover"
+            },
             {
               "name": "for",
               "type": {
@@ -10831,74 +11114,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/shared/directives/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "\"./safeStyleMap\""
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/shared/directives/safeStyleMap.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SafeStyleMapDirective",
-          "members": [
-            {
-              "kind": "field",
-              "name": "_previousStyleProperties",
-              "type": {
-                "text": "Set<string> | undefined"
-              },
-              "privacy": "private"
-            }
-          ],
-          "superclass": {
-            "name": "Directive",
-            "package": "lit/directive.js"
-          }
-        },
-        {
-          "kind": "variable",
-          "name": "safeStyleMap",
-          "description": "A directive that applies CSS properties to an element.\r\n\r\n`safeStyleMap` can only be used in the `style` attribute and must be the only\r\nexpression in the attribute. It takes the property names in the\r\nStyleInfostyleInfo object and adds the properties to the inline\r\nstyle of the element.\r\n\r\nProperty names with dashes (`-`) are assumed to be valid CSS\r\nproperty names and set on the element's style object using `setProperty()`.\r\nNames without dashes are assumed to be camelCased JavaScript property names\r\nand set on the element's style object using property assignment, allowing the\r\nstyle object to translate JavaScript-style names to CSS property names.\r\n\r\nFor example `safeStyleMap({backgroundColor: 'red', 'border-top': '5px', '--size':\r\n'0'})` sets the `background-color`, `border-top` and `--size` properties.",
-          "parameters": [
-            {
-              "name": "styleInfo"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "safeStyleMap",
-          "declaration": {
-            "name": "safeStyleMap",
-            "module": "src/shared/directives/safeStyleMap.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SafeStyleMapDirective",
-          "declaration": {
-            "name": "SafeStyleMapDirective",
-            "module": "src/shared/directives/safeStyleMap.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/shared/tokens/ColorToken.ts",
@@ -12769,12 +12984,51 @@
           "description": "Mixin to augment an element with behavior emits a click event on keyboard events.",
           "name": "KeyboardClick",
           "members": [
+            {
+              "kind": "field",
+              "name": "#keyPressed",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#keyDownHandler",
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "#keyUpHandler",
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "#focusOutHandler",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "#handleKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "#handleKeyUp",
@@ -13681,6 +13935,50 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/utils/focusWhenReady.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "focusWhenReady",
+          "return": {
+            "type": {
+              "text": "Promise<boolean>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The element to to focus."
+            },
+            {
+              "name": "timeout",
+              "default": "200",
+              "type": {
+                "text": "number"
+              },
+              "description": "The maximum amount of time to attempt to focus `el`.",
+              "optional": true
+            }
+          ],
+          "description": "Asynchronously attempts to focus an element once it becomes focusable."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "focusWhenReady",
+          "declaration": {
+            "name": "focusWhenReady",
+            "module": "src/shared/utils/focusWhenReady.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shared/utils/forcedColorsActive.ts",
@@ -13859,6 +14157,14 @@
       "path": "src/shared/utils/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./focusWhenReady\""
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -13899,6 +14205,14 @@
             "package": "\"./hasAssignedNodes\""
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./interceptProperty\""
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -13907,6 +14221,22 @@
             "package": "\"./prefersReducedMotion\""
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./resolveElementById\""
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./resolveFragmentUrl\""
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -13917,6 +14247,55 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/utils/interceptProperty.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "interceptProperty",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "T"
+              },
+              "description": "The object whose property should be intercepted."
+            },
+            {
+              "name": "prop",
+              "type": {
+                "text": "K"
+              },
+              "description": "The property key to intercept."
+            },
+            {
+              "name": "options",
+              "type": {
+                "text": "{\r\n    get?: (getter: () => T[K]) => T[K];\r\n    set?: (value: T[K], setter: (v: T[K]) => void) => void;\r\n  }"
+              },
+              "description": "Configuration object for interceptor callbacks."
+            }
+          ],
+          "description": "Intercepts property access and mutations on a target object, allowing custom logic\r\nto run when the property is read or written to."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "interceptProperty",
+          "declaration": {
+            "name": "interceptProperty",
+            "module": "src/shared/utils/interceptProperty.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shared/utils/prefersReducedMotion.ts",
@@ -13943,6 +14322,84 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/utils/resolveElementById.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "resolveElementById",
+          "return": {
+            "type": {
+              "text": "Promise<T | null>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "description": "The element ID to resolve."
+            },
+            {
+              "name": "root",
+              "default": "document",
+              "type": {
+                "text": "ParentNode"
+              },
+              "description": "Optional root node to query from (defaults to document)."
+            }
+          ],
+          "description": "Resolves an element by ID, waiting for document readiness if needed."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "resolveElementById",
+          "declaration": {
+            "name": "resolveElementById",
+            "module": "src/shared/utils/resolveElementById.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/utils/resolveFragmentUrl.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "resolveFragmentUrl",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "description": "The fragment identifier to append (e.g., an SVG element's ID)."
+            }
+          ],
+          "description": "Resolves a URL fragment reference (`url(path#id)`) based on the current document location.\r\n\r\nThis helper is typically used when constructing fragment-based URLs for SVG\r\nreferences (e.g., masks, clipPaths, filters) where the browser requires a fully\r\nqualified `url(...)` value that includes the current path.\r\n\r\nHow it works:\r\n- Safely reads `document.location` (guarded for SSR environments).\r\n- Extracts the current page's path + query string.\r\n- Removes any existing hash fragment from the URL.\r\n- Appends `#${id}` to produce a stable fragment reference.\r\n\r\nExample:\r\n  // If the current page is /viewer/page?mode=edit#section2\r\n  resolveFragmentUrl(\"clip\") → \"url(/viewer/page?mode=edit#clip)\""
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "resolveFragmentUrl",
+          "declaration": {
+            "name": "resolveFragmentUrl",
+            "module": "src/shared/utils/resolveFragmentUrl.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shared/utils/scrollIntoViewIfNeeded.ts",