@maple-design/ui-vue 1.1.0 → 1.1.1

package/highlight/web-types.en-US.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "framework": "vue",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "name": "Maple Design Mobile",
   "contributions": {
     "html": {
@@ -425,6 +425,15 @@
         {
           "name": "mp-auto-complete",
           "attributes": [
+            {
+              "name": "need-confirm",
+              "description": "Applies only to overlay editing. Choosing a suggestion commits and closes by default; true keeps a draft until confirmation. Submission still runs form validation and before-commit; rejection keeps the editor open. AutoComplete typing does not auto-submit; a changed text draft provides a confirmation button, while choosing a suggestion completes selection immediately.",
+              "default": "false",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
             {
               "name": "model-value",
               "description": "Controlled text",
@@ -2055,18 +2064,45 @@
           "name": "mp-cascader",
           "attributes": [
             {
-              "name": "model-value / default-value",
-              "description": "Controlled value / uncontrolled initial value",
-              "default": "Single: ''; multiple: []",
+              "name": "need-confirm",
+              "description": "Applies only to overlay editing. Single selection commits and closes on choice by default; true keeps a draft until confirmation. Multiple selection defaults to confirmation. Submission still runs form validation and before-commit; rejection keeps the editor open.",
+              "default": "Single false; multiple true",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "model-value",
+              "description": "Controlled selected value; supports v-model",
+              "default": "undefined",
               "value": {
                 "type": "`CascaderBaseValue`",
                 "kind": "expression"
               }
             },
             {
-              "name": "open / default-open",
-              "description": "Controlled / initial open state",
-              "default": "undefined / false",
+              "name": "default-value",
+              "description": "Initial uncontrolled selection; read once",
+              "default": "Single: undefined with path-mode, otherwise ''; multiple: []",
+              "value": {
+                "type": "`CascaderBaseValue`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "open",
+              "description": "Controlled open state; supports v-model:open",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-open",
+              "description": "Initial uncontrolled open state; read only at initialization",
+              "default": "false",
               "value": {
                 "type": "`boolean`",
                 "kind": "expression"
@@ -2082,9 +2118,18 @@
               }
             },
             {
-              "name": "input-value / default-input-value",
-              "description": "Search text, independent of selected values",
-              "default": "undefined / ''",
+              "name": "input-value",
+              "description": "Controlled search text, independent of selection; supports v-model:input-value",
+              "default": "undefined",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-input-value",
+              "description": "Initial uncontrolled search text, independent of selection; read only at initialization",
+              "default": "''",
               "value": {
                 "type": "`string`",
                 "kind": "expression"
@@ -2118,8 +2163,26 @@
               }
             },
             {
-              "name": "disabled / readonly / error",
-              "description": "Inherits form state unless explicitly overridden",
+              "name": "disabled",
+              "description": "Disabled state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "Read-only state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error",
+              "description": "Error state; explicit values override inherited Form / Group state",
               "default": "undefined",
               "value": {
                 "type": "`boolean`",
@@ -2136,8 +2199,17 @@
               }
             },
             {
-              "name": "hint / line",
-              "description": "Floating hint / standard variant underline",
+              "name": "hint",
+              "description": "Enable the floating hint",
+              "default": "true",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "line",
+              "description": "Show the underline in the standard variant",
               "default": "true",
               "value": {
                 "type": "`boolean`",
@@ -2145,8 +2217,26 @@
               }
             },
             {
-              "name": "text-color / focus-color / blur-color",
-              "description": "Field colors",
+              "name": "text-color",
+              "description": "Custom per-instance text color; prefer tokens for static themes",
+              "default": "—",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "focus-color",
+              "description": "Custom per-instance focused color; prefer tokens for static themes",
+              "default": "—",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "blur-color",
+              "description": "Custom per-instance unfocused color; prefer tokens for static themes",
               "default": "—",
               "value": {
                 "type": "`string`",
@@ -4127,8 +4217,17 @@
               }
             },
             {
-              "name": "confirm-button / cancel-button",
-              "description": "Show action buttons",
+              "name": "confirm-button",
+              "description": "Show the confirm button",
+              "default": "true",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "cancel-button",
+              "description": "Show the cancel button",
               "default": "true",
               "value": {
                 "type": "`boolean`",
@@ -4145,8 +4244,17 @@
               }
             },
             {
-              "name": "confirm-button-text / cancel-button-text",
-              "description": "Button labels",
+              "name": "confirm-button-text",
+              "description": "Confirm button text",
+              "default": "Localized text",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "cancel-button-text",
+              "description": "Cancel button text",
               "default": "Localized text",
               "value": {
                 "type": "`string`",
@@ -4154,8 +4262,8 @@
               }
             },
             {
-              "name": "confirm-button-props / cancel-button-props",
-              "description": "Button props, including colors",
+              "name": "confirm-button-props",
+              "description": "Confirm button props",
               "default": "-",
               "value": {
                 "type": "`ButtonProps`",
@@ -4163,8 +4271,35 @@
               }
             },
             {
-              "name": "confirm-button-loading / cancel-button-loading",
-              "description": "Loading state",
+              "name": "cancel-button-props",
+              "description": "Cancel button props",
+              "default": "-",
+              "value": {
+                "type": "`ButtonProps`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "confirm-button-loading",
+              "description": "Confirm button loading state",
+              "default": "false",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "cancel-button-loading",
+              "description": "Cancel button loading state",
+              "default": "false",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "confirm-button-disabled",
+              "description": "Confirm button disabled state",
               "default": "false",
               "value": {
                 "type": "`boolean`",
@@ -4172,8 +4307,8 @@
               }
             },
             {
-              "name": "confirm-button-disabled / cancel-button-disabled",
-              "description": "Disabled state",
+              "name": "cancel-button-disabled",
+              "description": "Cancel button disabled state",
               "default": "false",
               "value": {
                 "type": "`boolean`",
@@ -4190,8 +4325,26 @@
               }
             },
             {
-              "name": "overlay-class / dialog-class / body-class",
-              "description": "Custom classes",
+              "name": "overlay-class",
+              "description": "Custom overlay classes",
+              "default": "-",
+              "value": {
+                "type": "`string | any[]`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "dialog-class",
+              "description": "Custom dialog panel classes",
+              "default": "-",
+              "value": {
+                "type": "`string | any[]`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "body-class",
+              "description": "Custom body classes",
               "default": "-",
               "value": {
                 "type": "`string | any[]`",
@@ -4199,8 +4352,26 @@
               }
             },
             {
-              "name": "overlay-style / dialog-style / body-style",
-              "description": "Custom styles",
+              "name": "overlay-style",
+              "description": "Custom overlay styles",
+              "default": "-",
+              "value": {
+                "type": "`StyleValue`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "dialog-style",
+              "description": "Custom dialog panel styles",
+              "default": "-",
+              "value": {
+                "type": "`StyleValue`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "body-style",
+              "description": "Custom body styles",
               "default": "-",
               "value": {
                 "type": "`StyleValue`",
@@ -5053,11 +5224,29 @@
               }
             },
             {
-              "name": "disabled / readonly / error",
+              "name": "disabled",
+              "description": "`boolean`",
+              "default": "",
+              "value": {
+                "type": "Consumer-supplied disabled state after merging Form / Group state",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "`boolean`",
+              "default": "",
+              "value": {
+                "type": "Consumer-supplied read-only state after merging Form / Group state",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error",
               "description": "`boolean`",
               "default": "",
               "value": {
-                "type": "Provided by the consumer after merging Form / Group state",
+                "type": "Consumer-supplied error state after merging Form / Group state",
                 "kind": "expression"
               }
             },
@@ -5071,11 +5260,29 @@
               }
             },
             {
-              "name": "text-color / focus-color / blur-color",
+              "name": "text-color",
+              "description": "`string`",
+              "default": "",
+              "value": {
+                "type": "Custom per-instance text color; prefer tokens for static themes",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "focus-color",
+              "description": "`string`",
+              "default": "",
+              "value": {
+                "type": "Custom per-instance focused color; prefer tokens for static themes",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "blur-color",
               "description": "`string`",
               "default": "",
               "value": {
-                "type": "Custom text, focused and unfocused colors",
+                "type": "Custom per-instance unfocused color; prefer tokens for static themes",
                 "kind": "expression"
               }
             },
@@ -5803,11 +6010,11 @@
               }
             },
             {
-              "name": "open / v-model:open",
+              "name": "open",
               "description": "boolean",
-              "default": "Controlled standalone preview state",
+              "default": "Controlled standalone preview state Supports v-model:open.",
               "value": {
-                "type": "-",
+                "type": "`-`",
                 "kind": "expression"
               }
             },
@@ -7515,11 +7722,20 @@
               }
             },
             {
-              "name": "active-item / default-active-item",
-              "description": "Controlled / initial active named entry",
+              "name": "active-item",
+              "description": "Controlled active named entry; supports v-model:active-item",
+              "default": "",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-active-item",
+              "description": "Initial uncontrolled active named entry",
               "default": "",
               "value": {
-                "type": "undefined / null",
+                "type": "`null`",
                 "kind": "expression"
               }
             },
@@ -8522,20 +8738,38 @@
           "name": "mp-people-select",
           "attributes": [
             {
-              "name": "model-value / v-model",
-              "description": "string / null",
-              "default": "Controlled person identity; explicit null remains empty.",
+              "name": "need-confirm",
+              "description": "`boolean`",
+              "default": "Applies only to overlay editing. Single selection commits and closes on choice by default; true keeps a draft until confirmation. Multiple selection defaults to confirmation. Submission still runs form validation and before-commit; rejection keeps the editor open.",
               "value": {
-                "type": "undefined",
+                "type": "Single `false`; multiple `true`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "multiple",
+              "description": "boolean",
+              "default": "Enable multiple person selection using a string[] model.",
+              "value": {
+                "type": "false",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "model-value",
+              "description": "PeopleSelectValue",
+              "default": "A person ID in single mode or an ID array in multiple mode; explicit null remains empty. Supports v-model.",
+              "value": {
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "default-value",
-              "description": "string",
+              "description": "string / string[]",
               "default": "Uncontrolled initial identity, read only at creation.",
               "value": {
-                "type": "''",
+                "type": "'' / []",
                 "kind": "expression"
               }
             },
@@ -8740,7 +8974,7 @@
             {
               "name": "clearable",
               "description": "boolean",
-              "default": "Allow clearing an editable field; deferred modes clear the draft and publish after confirmation.",
+              "default": "Allow clearing an editable field; confirmation mode clears the draft and publishes after confirmation; immediate mode clears and commits directly.",
               "value": {
                 "type": "false",
                 "kind": "expression"
@@ -8748,10 +8982,10 @@
             },
             {
               "name": "empty-value",
-              "description": "string / null / function",
-              "default": "Published clear value; explicit null is retained; omission uses an empty string.",
+              "description": "string / string[] / null / function",
+              "default": "Value emitted when clearing; defaults to '' in single mode and [] in multiple mode. Explicit null is preserved.",
               "value": {
-                "type": "''",
+                "type": "'' / []",
                 "kind": "expression"
               }
             },
@@ -8831,11 +9065,11 @@
           "events": [
             {
               "name": "update:model-value",
-              "description": "value: string / null"
+              "description": "value: PeopleSelectValue"
             },
             {
               "name": "change",
-              "description": "value: string / null"
+              "description": "value: PeopleSelectValue"
             },
             {
               "name": "update:open / open-change",
@@ -11115,8 +11349,26 @@
           "name": "mp-select",
           "attributes": [
             {
-              "name": "model-value / default-value",
-              "description": "Controlled value / uncontrolled initial value",
+              "name": "need-confirm",
+              "description": "Applies only to overlay editing. Single selection commits and closes on choice by default; true keeps a draft until confirmation. Multiple selection defaults to confirmation. Submission still runs form validation and before-commit; rejection keeps the editor open.",
+              "default": "Single false; multiple true",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "model-value",
+              "description": "Controlled selected value; supports v-model",
+              "default": "undefined",
+              "value": {
+                "type": "`Value | null`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-value",
+              "description": "Initial uncontrolled selection; read once",
               "default": "Single: ''; multiple: []",
               "value": {
                 "type": "`Value`",
@@ -11124,9 +11376,18 @@
               }
             },
             {
-              "name": "open / default-open",
-              "description": "Controlled / initial open state",
-              "default": "undefined / false",
+              "name": "open",
+              "description": "Controlled open state; supports v-model:open",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-open",
+              "description": "Initial uncontrolled open state; read only at initialization",
+              "default": "false",
               "value": {
                 "type": "`boolean`",
                 "kind": "expression"
@@ -11142,9 +11403,18 @@
               }
             },
             {
-              "name": "input-value / default-input-value",
-              "description": "Search text, independent of selected values",
-              "default": "undefined / ''",
+              "name": "input-value",
+              "description": "Controlled search text, independent of selection; supports v-model:input-value",
+              "default": "undefined",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "default-input-value",
+              "description": "Initial uncontrolled search text, independent of selection; read only at initialization",
+              "default": "''",
               "value": {
                 "type": "`string`",
                 "kind": "expression"
@@ -11178,8 +11448,8 @@
               }
             },
             {
-              "name": "disabled / readonly / error",
-              "description": "Inherits form state unless explicitly overridden",
+              "name": "disabled",
+              "description": "Disabled state; explicit values override inherited Form / Group state",
               "default": "undefined",
               "value": {
                 "type": "`boolean`",
@@ -11187,17 +11457,44 @@
               }
             },
             {
-              "name": "placeholder",
-              "description": "Placeholder",
-              "default": "—",
-              "value": {
+              "name": "readonly",
+              "description": "Read-only state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error",
+              "description": "Error state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "placeholder",
+              "description": "Placeholder",
+              "default": "—",
+              "value": {
                 "type": "`string`",
                 "kind": "expression"
               }
             },
             {
-              "name": "hint / line",
-              "description": "Floating hint / standard variant underline",
+              "name": "hint",
+              "description": "Enable the floating hint",
+              "default": "true",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "line",
+              "description": "Show the underline in the standard variant",
               "default": "true",
               "value": {
                 "type": "`boolean`",
@@ -11205,8 +11502,26 @@
               }
             },
             {
-              "name": "text-color / focus-color / blur-color",
-              "description": "Field colors",
+              "name": "text-color",
+              "description": "Custom per-instance text color; prefer tokens for static themes",
+              "default": "—",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "focus-color",
+              "description": "Custom per-instance focused color; prefer tokens for static themes",
+              "default": "—",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "blur-color",
+              "description": "Custom per-instance unfocused color; prefer tokens for static themes",
               "default": "—",
               "value": {
                 "type": "`string`",
@@ -11457,8 +11772,17 @@
               }
             },
             {
-              "name": "show-header-on-empty / show-footer-on-empty",
-              "description": "Display header/footer in empty state",
+              "name": "show-header-on-empty",
+              "description": "Show the header in the empty state",
+              "default": "false",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-footer-on-empty",
+              "description": "Show the footer in the empty state",
               "default": "false",
               "value": {
                 "type": "`boolean`",
@@ -11846,7 +12170,7 @@
             {
               "name": "show-input",
               "description": "boolean",
-              "default": "Show attached InputNumber controls, two in range mode.",
+              "default": "Show attached InputNumber controls, two in range mode. The slider aria-describedby is also applied to the numeric inputs and combined with form error descriptions.",
               "value": {
                 "type": "false",
                 "kind": "expression"
@@ -15185,7 +15509,7 @@
             },
             {
               "name": "popup-container",
-              "description": "Render target; false renders locally. Moves within a document or between accessible same-origin frames attempt to restore unchanged focus on native inputs, buttons and similar elements, including inside open shadow roots; opaque potential closed-shadow hosts are not refocused.",
+              "description": "Mount container; false renders in place. When switching within a document or between accessible same-origin iframes, focus restoration is attempted for native inputs and buttons that have not been transferred, including equivalent elements in open Shadow DOM. Opaque hosts that may contain closed Shadow DOM are not restored automatically.",
               "default": "body",
               "value": {
                 "type": "string | HTMLElement | false",
@@ -15266,7 +15590,7 @@
             },
             {
               "name": "hide-empty",
-              "description": "Skip an empty content slot",
+              "description": "Skip a directly empty content slot; a component node counts as nonempty even if it renders nothing",
               "default": "false",
               "value": {
                 "type": "boolean",
@@ -15337,29 +15661,56 @@
               }
             },
             {
-              "name": "popup-class / popup-style",
-              "description": "Positioning-layer class/style",
+              "name": "popup-class",
+              "description": "Custom positioning-layer classes",
+              "default": "-",
+              "value": {
+                "type": "`ClassName`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "popup-style",
+              "description": "Custom positioning layer styles",
+              "default": "-",
+              "value": {
+                "type": "`CSSProperties`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "content-class",
+              "description": "Custom content layer classes",
+              "default": "-",
+              "value": {
+                "type": "`ClassName`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "content-style",
+              "description": "Custom content layer styles",
               "default": "-",
               "value": {
-                "type": "ClassName / CSSProperties",
+                "type": "`CSSProperties`",
                 "kind": "expression"
               }
             },
             {
-              "name": "content-class / content-style",
-              "description": "Content-layer class/style",
+              "name": "arrow-class",
+              "description": "Custom arrow classes",
               "default": "-",
               "value": {
-                "type": "ClassName / CSSProperties",
+                "type": "`ClassName`",
                 "kind": "expression"
               }
             },
             {
-              "name": "arrow-class / arrow-style",
-              "description": "Arrow class/style",
+              "name": "arrow-style",
+              "description": "Custom arrow styles",
               "default": "-",
               "value": {
-                "type": "ClassName / CSSProperties",
+                "type": "`CSSProperties`",
                 "kind": "expression"
               }
             }
@@ -15377,236 +15728,371 @@
           "name": "mp-upload",
           "attributes": [
             {
-              "name": "model-value / default-value",
-              "description": "UploadFileItem[]",
-              "default": "",
+              "name": "model-value",
+              "description": "`UploadFileItem[] | null`",
+              "default": "Controlled file list; use with v-model",
               "value": {
-                "type": "Controlled value / uncontrolled initial []",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
-              "name": "accept / capture",
-              "description": "`string / UploadCapture`<br>`UploadCapture: boolean | 'user' | 'environment' | undefined`",
-              "default": "",
+              "name": "default-value",
+              "description": "`UploadFileItem[]`",
+              "default": "Initial uncontrolled file list",
               "value": {
-                "type": "Unspecified",
+                "type": "`[]`",
                 "kind": "expression"
               }
             },
             {
-              "name": "multiple / directory / draggable",
-              "description": "boolean",
-              "default": "",
+              "name": "accept",
+              "description": "`string`",
+              "default": "Accepted file types, e.g. image/*",
               "value": {
-                "type": "false",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
-              "name": "disabled / readonly",
-              "description": "boolean",
-              "default": "",
+              "name": "capture",
+              "description": "`boolean | 'user' | 'environment'`",
+              "default": "False or omitted preserves photo selection; true requests capture, user / environment requests the front / rear camera; device and browser support varies",
               "value": {
-                "type": "undefined inherits Form; explicit false overrides",
+                "type": "`false`",
                 "kind": "expression"
               }
             },
             {
-              "name": "action / method",
-              "description": "string",
-              "default": "",
+              "name": "multiple",
+              "description": "`boolean`",
+              "default": "Allow multiple files",
               "value": {
-                "type": "None / post",
+                "type": "`false`",
                 "kind": "expression"
               }
             },
             {
-              "name": "headers / data",
-              "description": "object or async(file) => object",
-              "default": "",
+              "name": "reupload",
+              "description": "`boolean`",
+              "default": "Allow replacing a selected file",
+              "value": {
+                "type": "`false`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "directory",
+              "description": "`boolean`",
+              "default": "Select a directory; multiple provides an alternative on unsupported devices",
               "value": {
-                "type": "Cancelable during request preparation",
+                "type": "`false`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "draggable",
+              "description": "`boolean`",
+              "default": "Enable drag and drop",
+              "value": {
+                "type": "`false`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "disabled",
+              "description": "`boolean`",
+              "default": "Disable interaction; inherits Form, explicit false overrides",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "`boolean`",
+              "default": "Read-only; inherits Form, explicit false overrides",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "action",
+              "description": "`string`",
+              "default": "Upload request URL",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "method",
+              "description": "`string`",
+              "default": "Upload request method",
+              "value": {
+                "type": "`'post'`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "headers",
+              "description": "`UploadHeaders`",
+              "default": "Request headers object or async function; preparation remains cancelable",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "data",
+              "description": "`UploadData`",
+              "default": "Additional request data object or async function; preparation remains cancelable",
+              "value": {
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "name",
-              "description": "string / (file) => string",
-              "default": "",
+              "description": "`string | ((file: UploadFileItem) => string)`",
+              "default": "Form field name for the uploaded file",
               "value": {
-                "type": "file",
+                "type": "`'file'`",
                 "kind": "expression"
               }
             },
             {
               "name": "with-credentials",
-              "description": "boolean",
-              "default": "",
+              "description": "`boolean`",
+              "default": "Include credentials in cross-origin requests",
               "value": {
-                "type": "false",
+                "type": "`false`",
                 "kind": "expression"
               }
             },
             {
               "name": "custom-request",
-              "description": "(UploadRequestOptions) => UploadRequest / Promise / void",
-              "default": "",
+              "description": "`UploadCustomRequest`",
+              "default": "Custom transport; may return an object with abort",
               "value": {
-                "type": "Custom transport; may return abort",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "auto-upload",
-              "description": "boolean",
-              "default": "",
+              "description": "`boolean`",
+              "default": "Upload automatically after selection; requires action or custom-request",
               "value": {
-                "type": "true; requires action or custom-request to start",
+                "type": "`true`",
                 "kind": "expression"
               }
             },
             {
-              "name": "max-files / max-file-size / max-total-size",
-              "description": "number",
-              "default": "",
+              "name": "max-files",
+              "description": "`number`",
+              "default": "Maximum file count; applies when greater than 0",
+              "value": {
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "max-file-size",
+              "description": "`number`",
+              "default": "Maximum size per file in bytes",
               "value": {
-                "type": "Unspecified; sizes use bytes, max-files applies when >0",
+                "type": "`undefined`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "max-total-size",
+              "description": "`number`",
+              "default": "Maximum total file size in bytes",
+              "value": {
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "resolve-type",
-              "description": "file / data-url / object-url",
-              "default": "",
+              "description": "`'file' | 'data-url' | 'object-url'`",
+              "default": "File reading mode; object-url generates url for files and thumbnailUrl for images",
               "value": {
-                "type": "object-url; all files get url, images also get thumbnailUrl",
+                "type": "`'object-url'`",
                 "kind": "expression"
               }
             },
             {
               "name": "create-thumbnail-url",
-              "description": "(options) => string / Promise",
-              "default": "",
+              "description": "`UploadCreateThumbnailUrl`",
+              "default": "Custom thumbnail URL; caller owns the URL and its cleanup",
               "value": {
-                "type": "Custom URLs belong to callers and are not automatically revoked",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "before-add",
-              "description": "async(files) => File[]",
-              "default": "",
+              "description": "`(files: File[]) => File[] | Promise<File[]>`",
+              "default": "Filter or replace a batch of incoming files",
               "value": {
-                "type": "Batch filtering/replacement",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "before-read",
-              "description": "async(file) => boolean / File",
-              "default": "",
+              "description": "`UploadBeforeRead`",
+              "default": "Validate before reading; false / rejection rejects, replacements are revalidated",
               "value": {
-                "type": "false/rejection rejects; replacements are revalidated",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "before-upload",
-              "description": "async(item) => boolean / File / Blob",
-              "default": "",
+              "description": "`UploadBeforeUpload`",
+              "default": "Validate before upload; false keeps ready, throw / rejection reports error, replacements are revalidated",
               "value": {
-                "type": "false keeps ready; throw/rejection reports error; replacements are revalidated",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "before-remove",
-              "description": "async(item,list) => boolean",
-              "default": "",
+              "description": "`UploadBeforeRemove`",
+              "default": "Validate before removal; false / rejection prevents removal",
               "value": {
-                "type": "false/rejection prevents removal",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "is-success-response",
-              "description": "(xhr,item) => boolean",
-              "default": "",
+              "description": "`UploadIsSuccessResponse`",
+              "default": "Custom success predicate; defaults to HTTP 2xx",
               "value": {
-                "type": "HTTP 2xx by default",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "request-choose",
-              "description": "(chooseFile,event) => void / Promise",
-              "default": "",
+              "description": "`UploadRequestChoose`",
+              "default": "Own the selection entry; exceptions do not automatically open a file chooser",
               "value": {
-                "type": "Own the selection entry; exceptions do not automatically open a file chooser",
+                "type": "`undefined`",
                 "kind": "expression"
               }
             },
             {
               "name": "list-type",
-              "description": "text / picture / picture-card",
-              "default": "",
+              "description": "`'text' | 'picture' | 'picture-card'`",
+              "default": "File list appearance; supported on both platforms",
               "value": {
-                "type": "text; supported on both platforms",
+                "type": "`'text'`",
                 "kind": "expression"
               }
             },
             {
               "name": "image-fit",
-              "description": "fill / contain / cover / none / scale-down",
-              "default": "",
+              "description": "`'fill' | 'contain' | 'cover' | 'none' | 'scale-down'`",
+              "default": "Thumbnail fit; item.fit overrides",
               "value": {
-                "type": "cover; item.fit overrides",
+                "type": "`'cover'`",
                 "kind": "expression"
               }
             },
             {
               "name": "preview",
-              "description": "boolean",
-              "default": "",
+              "description": "`boolean`",
+              "default": "Enable built-in image / video preview",
               "value": {
-                "type": "true",
+                "type": "`true`",
                 "kind": "expression"
               }
             },
             {
-              "name": "show-file-list / show-upload-button / show-remove-button",
-              "description": "boolean",
-              "default": "",
+              "name": "show-file-list",
+              "description": "`boolean`",
+              "default": "Show the file list",
               "value": {
-                "type": "true",
+                "type": "`true`",
                 "kind": "expression"
               }
             },
             {
-              "name": "show-retry-button / show-cancel-button / show-preview-button",
-              "description": "boolean",
-              "default": "",
+              "name": "show-upload-button",
+              "description": "`boolean`",
+              "default": "Show the file selection button",
               "value": {
-                "type": "true",
+                "type": "`true`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-remove-button",
+              "description": "`boolean`",
+              "default": "Show the remove button",
+              "value": {
+                "type": "`true`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-retry-button",
+              "description": "`boolean`",
+              "default": "Show the retry button",
+              "value": {
+                "type": "`true`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-cancel-button",
+              "description": "`boolean`",
+              "default": "Show the cancel button",
+              "value": {
+                "type": "`true`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "show-preview-button",
+              "description": "`boolean`",
+              "default": "Show the preview button",
+              "value": {
+                "type": "`true`",
                 "kind": "expression"
               }
             },
             {
               "name": "show-download-button",
-              "description": "boolean",
-              "default": "",
+              "description": "`boolean`",
+              "default": "Show the download button; disabled prevents interaction",
+              "value": {
+                "type": "`false`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "elevation",
+              "description": "`boolean | number`",
+              "default": "Elevation of the upload trigger",
               "value": {
-                "type": "false; disabled prevents interaction",
+                "type": "`false`",
                 "kind": "expression"
               }
             },
             {
-              "name": "elevation / ripple",
-              "description": "boolean or number / boolean",
-              "default": "",
+              "name": "ripple",
+              "description": "`boolean`",
+              "default": "Enable the upload trigger ripple",
               "value": {
-                "type": "false / true",
+                "type": "`true`",
                 "kind": "expression"
               }
             }
@@ -15678,8 +16164,26 @@
               }
             },
             {
-              "name": "disabled / readonly / error",
-              "description": "State; explicit values override Form",
+              "name": "disabled",
+              "description": "Disabled state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "readonly",
+              "description": "Read-only state; explicit values override inherited Form / Group state",
+              "default": "undefined",
+              "value": {
+                "type": "`boolean`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "error",
+              "description": "Error state; explicit values override inherited Form / Group state",
               "default": "undefined",
               "value": {
                 "type": "`boolean`",
@@ -15777,8 +16281,26 @@
               }
             },
             {
-              "name": "text-color / focus-color / blur-color",
-              "description": "Dynamic instance colors; prefer tokens for static themes",
+              "name": "text-color",
+              "description": "Custom per-instance text color; prefer tokens for static themes",
+              "default": "undefined",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "focus-color",
+              "description": "Custom per-instance focused color; prefer tokens for static themes",
+              "default": "undefined",
+              "value": {
+                "type": "`string`",
+                "kind": "expression"
+              }
+            },
+            {
+              "name": "blur-color",
+              "description": "Custom per-instance unfocused color; prefer tokens for static themes",
               "default": "undefined",
               "value": {
                 "type": "`string`",