@openpicker/protocol 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -100,6 +100,18 @@ interface PickParams {
     lockSelectorEdit?: boolean;
     /** Only allow confirming (OK) when the selector matches exactly one element. Default: false. */
     requireUniqueMatch?: boolean;
+    /**
+     * Restrict which elements can be picked: the user may only select an element that
+     * matches this CSS selector — hovering a descendant snaps to the nearest matching
+     * ancestor (Element.closest), and elements with no match are not selectable
+     * (not-allowed cursor, click ignored). A comma list works:
+     * "input, textarea, select, [contenteditable]". Omit for no restriction.
+     *
+     * Orthogonal to {@link selector}: `mustMatch` decides WHICH element is picked,
+     * `selector` decides HOW its selector is built. Must be a valid CSS selector — an
+     * invalid one rejects the pick with `invalid_params`.
+     */
+    mustMatch?: string;
 }
 interface PickedElement {
     tag: string;

package/dist/index.d.ts

@@ -100,6 +100,18 @@ interface PickParams {
     lockSelectorEdit?: boolean;
     /** Only allow confirming (OK) when the selector matches exactly one element. Default: false. */
     requireUniqueMatch?: boolean;
+    /**
+     * Restrict which elements can be picked: the user may only select an element that
+     * matches this CSS selector — hovering a descendant snaps to the nearest matching
+     * ancestor (Element.closest), and elements with no match are not selectable
+     * (not-allowed cursor, click ignored). A comma list works:
+     * "input, textarea, select, [contenteditable]". Omit for no restriction.
+     *
+     * Orthogonal to {@link selector}: `mustMatch` decides WHICH element is picked,
+     * `selector` decides HOW its selector is built. Must be a valid CSS selector — an
+     * invalid one rejects the pick with `invalid_params`.
+     */
+    mustMatch?: string;
 }
 interface PickedElement {
     tag: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpicker/protocol",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Open postMessage protocol for the openpicker CSS element picker — wire types, constants, and selector helpers.",
   "license": "MIT",
   "author": "Usertour (https://www.usertour.io)",