@m3e/core 1.0.0-rc.2 → 1.0.0-rc.4

package/dist/css-custom-data.json

@@ -251,6 +251,26 @@
       "name": "--m3e-state-layer-hover-opacity",
       "description": "Opacity on hover.",
       "values": []
+    },
+    {
+      "name": "--m3e-text-highlight-container-color",
+      "description": "Background color applied to highlighted text ranges.",
+      "values": []
+    },
+    {
+      "name": "--m3e-text-highlight-color",
+      "description": "Foreground color of highlighted text content.",
+      "values": []
+    },
+    {
+      "name": "--m3e-text-highlight-decoration",
+      "description": "Optional text decoration (e.g., underline, line-through) for highlighted text.",
+      "values": []
+    },
+    {
+      "name": "--m3e-text-highlight-shadow",
+      "description": "Optional text shadow for emphasis or contrast.",
+      "values": []
     }
   ],
   "pseudoElements": []

package/dist/custom-elements.json

@@ -9193,25 +9193,6 @@
           "kind": "mixin",
           "description": "Mixin that adds support for custom event attributes.",
           "name": "EventAttribute",
-          "members": [
-            {
-              "kind": "method",
-              "name": "dispatchEvent",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
-            }
-          ],
           "parameters": [
             {
               "name": "base",
@@ -9509,6 +9490,17 @@
           "description": "Mixin to augment an element with behavior used to submit a form.",
           "name": "FormSubmitter",
           "members": [
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "true",
+              "description": "Indicates that this custom element participates in form submission, validation, and form state restoration."
+            },
             {
               "kind": "field",
               "name": "name",
@@ -10045,6 +10037,11 @@
       "kind": "javascript-module",
       "path": "src/shared/mixins/Labelled.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "updateLabels",
+          "description": "A symbol through which to update labels to reflect a control's current state."
+        },
         {
           "kind": "function",
           "name": "isLabelledMixin",
@@ -10094,16 +10091,6 @@
               },
               "description": "The label elements that the element is associated with.",
               "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "[_updateLabels]",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
             }
           ],
           "parameters": [
@@ -10118,6 +10105,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "updateLabels",
+          "declaration": {
+            "name": "updateLabels",
+            "module": "src/shared/mixins/Labelled.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "isLabelledMixin",
@@ -10970,27 +10965,6 @@
                   "text": "void"
                 }
               }
-            },
-            {
-              "kind": "method",
-              "name": "dispatchEvent",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "inheritedFrom": {
-                "name": "EventAttribute",
-                "module": "src/shared/mixins/EventAttribute.ts"
-              }
             }
           ],
           "events": [
@@ -11759,6 +11733,14 @@
             "name": "*",
             "package": "\"./TextOverflowElement\""
           }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "\"./TextHighlightElement\""
+          }
         }
       ]
     },
@@ -13010,6 +12992,237 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/shared/primitives/TextHighlightElement.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Highlights text which matches a given search term.",
+          "name": "M3eTextHighlightElement",
+          "cssProperties": [
+            {
+              "description": "Background color applied to highlighted text ranges.",
+              "name": "--m3e-text-highlight-container-color"
+            },
+            {
+              "description": "Foreground color of highlighted text content.",
+              "name": "--m3e-text-highlight-color"
+            },
+            {
+              "description": "Optional text decoration (e.g., underline, line-through) for highlighted text.",
+              "name": "--m3e-text-highlight-decoration"
+            },
+            {
+              "description": "Optional text shadow for emphasis or contrast.",
+              "name": "--m3e-text-highlight-shadow"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Renders the content to highlight.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "__nextId",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "static": true,
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "#id",
+              "privacy": "private",
+              "default": "`m3e-text-highlight-${M3eTextHighlightElement.__nextId++}`"
+            },
+            {
+              "kind": "field",
+              "name": "#ranges",
+              "privacy": "private",
+              "default": "new Array<Range>()"
+            },
+            {
+              "kind": "field",
+              "name": "#styles",
+              "privacy": "private",
+              "type": {
+                "text": "CSSStyleSheet | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "A value indicating whether text highlighting is disabled.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "term",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The term to highlight.",
+              "attribute": "term"
+            },
+            {
+              "kind": "field",
+              "name": "caseSensitive",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "A value indicating whether matching is case sensitive.",
+              "attribute": "case-sensitive"
+            },
+            {
+              "kind": "field",
+              "name": "isSupported",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "A value indicating whether text highlighting is supported by the browser.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "ranges",
+              "type": {
+                "text": "readonly Range[]"
+              },
+              "description": "The ranges that match the current term.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "#isTextNode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "node",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#findTextNodes",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "parent",
+                  "type": {
+                    "text": "Node"
+                  }
+                },
+                {
+                  "name": "nodes",
+                  "type": {
+                    "text": "Node[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#highlight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "highlight",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Emitted when content is highlighted."
+            }
+          ],
+          "attributes": [
+            {
+              "description": "A value indicating whether matching is case sensitive.",
+              "name": "case-sensitive",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "caseSensitive"
+            },
+            {
+              "description": "A value indicating whether text highlighting is disabled.",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "description": "The term to highlight.",
+              "name": "term",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "term"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "m3e-text-highlight",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "M3eTextHighlightElement",
+          "declaration": {
+            "name": "M3eTextHighlightElement",
+            "module": "src/shared/primitives/TextHighlightElement.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "m3e-text-highlight",
+          "declaration": {
+            "name": "M3eTextHighlightElement",
+            "module": "src/shared/primitives/TextHighlightElement.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/shared/primitives/TextOverflowElement.ts",

package/dist/html-custom-data.json

@@ -197,6 +197,28 @@
       ],
       "references": []
     },
+    {
+      "name": "m3e-text-highlight",
+      "description": "Highlights text which matches a given search term.\n---\n\n\n### **Events:**\n - **highlight** - Emitted when content is highlighted.\n\n### **Slots:**\n - _default_ - Renders the content to highlight.\n\n### **CSS Properties:**\n - **--m3e-text-highlight-container-color** - Background color applied to highlighted text ranges. _(default: undefined)_\n- **--m3e-text-highlight-color** - Foreground color of highlighted text content. _(default: undefined)_\n- **--m3e-text-highlight-decoration** - Optional text decoration (e.g., underline, line-through) for highlighted text. _(default: undefined)_\n- **--m3e-text-highlight-shadow** - Optional text shadow for emphasis or contrast. _(default: undefined)_",
+      "attributes": [
+        {
+          "name": "case-sensitive",
+          "description": "A value indicating whether matching is case sensitive.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "A value indicating whether text highlighting is disabled.",
+          "values": []
+        },
+        {
+          "name": "term",
+          "description": "The term to highlight.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
     {
       "name": "m3e-text-overflow",
       "description": "An inline container which presents an ellipsis when content overflows.\n---\n\n\n### **Slots:**\n - _default_ - Renders the content to truncate with an ellipsis.",