@ng-primitives/mcp 0.127.0 → 0.128.0

package/src/generated/api-data.json

@@ -115,6 +115,16 @@
     "inputs": [],
     "outputs": []
   },
+  "NgpThreadMessage": {
+    "name": "NgpThreadMessage",
+    "description": "",
+    "selector": "[ngpThreadMessage]",
+    "exportAs": [
+      "ngpThreadMessage"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpPromptComposer": {
     "name": "NgpPromptComposer",
     "description": "",
@@ -131,6 +141,16 @@
       }
     ]
   },
+  "NgpPromptComposerInput": {
+    "name": "NgpPromptComposerInput",
+    "description": "",
+    "selector": "input[ngpPromptComposerInput], textarea[ngpPromptComposerInput]",
+    "exportAs": [
+      "ngpPromptComposerInput"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpThreadSuggestion": {
     "name": "NgpThreadSuggestion",
     "description": "",
@@ -156,16 +176,6 @@
     ],
     "outputs": []
   },
-  "NgpThreadMessage": {
-    "name": "NgpThreadMessage",
-    "description": "",
-    "selector": "[ngpThreadMessage]",
-    "exportAs": [
-      "ngpThreadMessage"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
   "NgpPromptComposerSubmit": {
     "name": "NgpPromptComposerSubmit",
     "description": "",
@@ -208,16 +218,6 @@
     ],
     "outputs": []
   },
-  "NgpPromptComposerInput": {
-    "name": "NgpPromptComposerInput",
-    "description": "",
-    "selector": "input[ngpPromptComposerInput], textarea[ngpPromptComposerInput]",
-    "exportAs": [
-      "ngpPromptComposerInput"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
   "NgpPromptComposerDictation": {
     "name": "NgpPromptComposerDictation",
     "description": "",
@@ -229,7 +229,7 @@
       {
         "name": "disabled",
         "type": "boolean",
-        "description": "Whether the submit button should be disabled.",
+        "description": "Whether the dictation button should be disabled.",
         "isRequired": false
       }
     ],
@@ -578,8 +578,14 @@
     "inputs": [
       {
         "name": "ngpColorPickerValue",
+        "type": "Color | undefined",
+        "description": "The color value. When defined the picker is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpColorPickerDefaultValue",
         "type": "Color",
-        "description": "The color value.",
+        "description": "The default color value for uncontrolled usage.",
         "isRequired": false
       }
     ],
@@ -625,10 +631,16 @@
     "inputs": [
       {
         "name": "ngpColorWheelValue",
-        "type": "Color",
+        "type": "Color | undefined",
         "description": "The color value.",
         "isRequired": false
       },
+      {
+        "name": "ngpColorWheelDefaultValue",
+        "type": "Color",
+        "description": "The default color value for uncontrolled usage.",
+        "isRequired": false
+      },
       {
         "name": "ngpColorWheelColorSpace",
         "type": "'rgb' | 'hsl' | 'hsb'",
@@ -662,10 +674,16 @@
     "inputs": [
       {
         "name": "ngpColorAreaValue",
-        "type": "Color",
+        "type": "Color | undefined",
         "description": "The color value.",
         "isRequired": false
       },
+      {
+        "name": "ngpColorAreaDefaultValue",
+        "type": "Color",
+        "description": "The default color value for uncontrolled usage.",
+        "isRequired": false
+      },
       {
         "name": "ngpColorAreaXChannel",
         "type": "'red' | 'green' | 'blue' | 'hue' | 'saturation' | 'lightness' | 'brightness' | 'alpha'",
@@ -712,10 +730,16 @@
     "inputs": [
       {
         "name": "ngpColorFieldValue",
-        "type": "Color",
+        "type": "Color | undefined",
         "description": "The color value.",
         "isRequired": false
       },
+      {
+        "name": "ngpColorFieldDefaultValue",
+        "type": "Color",
+        "description": "The default color value for uncontrolled usage.",
+        "isRequired": false
+      },
       {
         "name": "ngpColorFieldChannel",
         "type": "ColorChannel | undefined",
@@ -754,10 +778,16 @@
     "inputs": [
       {
         "name": "ngpColorSliderValue",
-        "type": "Color",
+        "type": "Color | undefined",
         "description": "The color value.",
         "isRequired": false
       },
+      {
+        "name": "ngpColorSliderDefaultValue",
+        "type": "Color",
+        "description": "The default color value for uncontrolled usage.",
+        "isRequired": false
+      },
       {
         "name": "ngpColorSliderChannel",
         "type": "'red' | 'green' | 'blue' | 'hue' | 'saturation' | 'lightness' | 'brightness' | 'alpha'",
@@ -805,7 +835,13 @@
       {
         "name": "ngpColorSwatchPickerValue",
         "type": "Color | undefined",
-        "description": "The selected color.",
+        "description": "The selected color. When defined the swatch picker is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpColorSwatchPickerDefaultValue",
+        "type": "Color | undefined",
+        "description": "The default selected color for uncontrolled usage (undefined = no selection).",
         "isRequired": false
       },
       {
@@ -950,7 +986,7 @@
       },
       {
         "name": "ngpComboboxDropdownPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "Placement",
         "description": "The position of the dropdown.",
         "isRequired": false,
         "defaultValue": "'bottom'"
@@ -1167,7 +1203,7 @@
       },
       {
         "name": "ngpContextMenuSubmenuTriggerPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "Placement",
         "description": "Define the placement of the submenu relative to the trigger.\n@default 'right-start'",
         "isRequired": false,
         "defaultValue": "'right-start'"
@@ -1263,6 +1299,36 @@
     "inputs": [],
     "outputs": []
   },
+  "NgpDatePickerNextMonth": {
+    "name": "NgpDatePickerNextMonth",
+    "description": "A button that navigates to the next month.",
+    "selector": "[ngpDatePickerNextMonth]",
+    "exportAs": [
+      "ngpDatePickerNextMonth"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
+  "NgpDatePickerPreviousMonth": {
+    "name": "NgpDatePickerPreviousMonth",
+    "description": "A button that navigates to the previous month.",
+    "selector": "[ngpDatePickerPreviousMonth]",
+    "exportAs": [
+      "ngpDatePickerPreviousMonth"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
+  "NgpDatePickerDateButton": {
+    "name": "NgpDatePickerDateButton",
+    "description": "A button that represents a date in the date picker grid.",
+    "selector": "[ngpDatePickerDateButton]",
+    "exportAs": [
+      "ngpDatePickerDateButton"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpDatePickerCell": {
     "name": "NgpDatePickerCell",
     "description": "A cell in the date picker grid.",
@@ -1291,26 +1357,6 @@
     ],
     "outputs": []
   },
-  "NgpDatePickerNextMonth": {
-    "name": "NgpDatePickerNextMonth",
-    "description": "A button that navigates to the next month.",
-    "selector": "[ngpDatePickerNextMonth]",
-    "exportAs": [
-      "ngpDatePickerNextMonth"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
-  "NgpDatePickerPreviousMonth": {
-    "name": "NgpDatePickerPreviousMonth",
-    "description": "A button that navigates to the previous month.",
-    "selector": "[ngpDatePickerPreviousMonth]",
-    "exportAs": [
-      "ngpDatePickerPreviousMonth"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
   "NgpDatePickerCellRender": {
     "name": "NgpDatePickerCellRender",
     "description": "A structural directive that renders a cell in the date picker grid.",
@@ -1321,167 +1367,187 @@
     "inputs": [],
     "outputs": []
   },
-  "NgpDatePickerDateButton": {
-    "name": "NgpDatePickerDateButton",
-    "description": "A button that represents a date in the date picker grid.",
-    "selector": "[ngpDatePickerDateButton]",
-    "exportAs": [
-      "ngpDatePickerDateButton"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
-  "NgpDatePickerRowRender": {
-    "name": "NgpDatePickerRowRender",
-    "description": "A structural directive that renders a row of weekdays in the date picker grid.",
-    "selector": "[ngpDatePickerRowRender]",
-    "exportAs": [
-      "ngpDatePickerRowRender"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
-  "NgpDatePicker": {
-    "name": "NgpDatePicker",
-    "description": "The outermost container for the date picker.",
-    "selector": "[ngpDatePicker]",
+  "NgpDateRangePicker": {
+    "name": "NgpDateRangePicker",
+    "description": "",
+    "selector": "[ngpDateRangePicker]",
     "exportAs": [
-      "ngpDatePicker"
+      "ngpDateRangePicker"
     ],
     "inputs": [
       {
-        "name": "ngpDatePickerMin",
+        "name": "ngpDateRangePickerMin",
         "type": "T | undefined",
         "description": "The minimum date that can be selected.",
         "isRequired": false
       },
       {
-        "name": "ngpDatePickerMax",
+        "name": "ngpDateRangePickerMax",
         "type": "T | undefined",
         "description": "The maximum date that can be selected.",
         "isRequired": false
       },
       {
-        "name": "ngpDatePickerDisabled",
+        "name": "ngpDateRangePickerDisabled",
         "type": "boolean",
         "description": "Determine if the date picker is disabled.",
         "isRequired": false,
         "defaultValue": "false"
       },
       {
-        "name": "ngpDatePickerDateDisabled",
+        "name": "ngpDateRangePickerDateDisabled",
         "type": "(date: T) => boolean",
         "description": "A function that is called to determine if a specific date should be disabled.",
         "isRequired": false
       },
       {
-        "name": "ngpDatePickerFirstDayOfWeek",
+        "name": "ngpDateRangePickerFirstDayOfWeek",
         "type": "1 | 2 | 3 | 4 | 5 | 6 | 7",
         "description": "Sets which day starts the week in the calendar.\nAccepts 0-7 where 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday, 7=Sunday.\nDefaults to NgpDatePickerConfig.firstDayOfWeek (default 7 if not overridden).\nNote: Update calendar header column order when changing from Sunday start.\n@default 7 (Sunday)",
         "isRequired": false
       },
       {
-        "name": "ngpDatePickerDate",
+        "name": "ngpDateRangePickerStartDate",
         "type": "T | undefined",
-        "description": "The selected value.",
+        "description": "The selected start date",
         "isRequired": false
       },
       {
-        "name": "ngpDatePickerFocusedDate",
-        "type": "T",
+        "name": "ngpDateRangePickerDefaultStartDate",
+        "type": "T | undefined",
+        "description": "The default (uncontrolled) start date.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpDateRangePickerEndDate",
+        "type": "T | undefined",
+        "description": "The selected end date",
+        "isRequired": false
+      },
+      {
+        "name": "ngpDateRangePickerDefaultEndDate",
+        "type": "T | undefined",
+        "description": "The default (uncontrolled) end date.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpDateRangePickerFocusedDate",
+        "type": "T | undefined",
         "description": "The focused value.",
         "isRequired": false
+      },
+      {
+        "name": "ngpDateRangePickerDefaultFocusedDate",
+        "type": "T",
+        "description": "The default (uncontrolled) focused value.",
+        "isRequired": false
       }
     ],
     "outputs": [
       {
-        "name": "ngpDatePickerDateChange",
+        "name": "ngpDateRangePickerStartDateChange",
         "type": "T | undefined",
         "description": "Emit when the date changes."
       },
       {
-        "name": "ngpDatePickerFocusedDateChange",
+        "name": "ngpDateRangePickerEndDateChange",
+        "type": "T | undefined",
+        "description": "Emit when the end date changes."
+      },
+      {
+        "name": "ngpDateRangePickerFocusedDateChange",
         "type": "T",
         "description": "Emit when the focused date changes."
       }
     ]
   },
-  "NgpDateRangePicker": {
-    "name": "NgpDateRangePicker",
-    "description": "",
-    "selector": "[ngpDateRangePicker]",
+  "NgpDatePicker": {
+    "name": "NgpDatePicker",
+    "description": "The outermost container for the date picker.",
+    "selector": "[ngpDatePicker]",
     "exportAs": [
-      "ngpDateRangePicker"
+      "ngpDatePicker"
     ],
     "inputs": [
       {
-        "name": "ngpDateRangePickerMin",
+        "name": "ngpDatePickerMin",
         "type": "T | undefined",
         "description": "The minimum date that can be selected.",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerMax",
+        "name": "ngpDatePickerMax",
         "type": "T | undefined",
         "description": "The maximum date that can be selected.",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerDisabled",
+        "name": "ngpDatePickerDisabled",
         "type": "boolean",
         "description": "Determine if the date picker is disabled.",
         "isRequired": false,
         "defaultValue": "false"
       },
       {
-        "name": "ngpDateRangePickerDateDisabled",
+        "name": "ngpDatePickerDateDisabled",
         "type": "(date: T) => boolean",
         "description": "A function that is called to determine if a specific date should be disabled.",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerFirstDayOfWeek",
+        "name": "ngpDatePickerFirstDayOfWeek",
         "type": "1 | 2 | 3 | 4 | 5 | 6 | 7",
         "description": "Sets which day starts the week in the calendar.\nAccepts 0-7 where 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday, 7=Sunday.\nDefaults to NgpDatePickerConfig.firstDayOfWeek (default 7 if not overridden).\nNote: Update calendar header column order when changing from Sunday start.\n@default 7 (Sunday)",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerStartDate",
+        "name": "ngpDatePickerDate",
         "type": "T | undefined",
-        "description": "The selected start date",
+        "description": "The selected value.",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerEndDate",
+        "name": "ngpDatePickerDefaultDate",
         "type": "T | undefined",
-        "description": "The selected end date",
+        "description": "The default (uncontrolled) selected value.",
         "isRequired": false
       },
       {
-        "name": "ngpDateRangePickerFocusedDate",
-        "type": "T",
+        "name": "ngpDatePickerFocusedDate",
+        "type": "T | undefined",
         "description": "The focused value.",
         "isRequired": false
+      },
+      {
+        "name": "ngpDatePickerDefaultFocusedDate",
+        "type": "T",
+        "description": "The default (uncontrolled) focused value.",
+        "isRequired": false
       }
     ],
     "outputs": [
       {
-        "name": "ngpDateRangePickerStartDateChange",
+        "name": "ngpDatePickerDateChange",
         "type": "T | undefined",
         "description": "Emit when the date changes."
       },
       {
-        "name": "ngpDateRangePickerEndDateChange",
-        "type": "T | undefined",
-        "description": "Emit when the end date changes."
-      },
-      {
-        "name": "ngpDateRangePickerFocusedDateChange",
+        "name": "ngpDatePickerFocusedDateChange",
         "type": "T",
         "description": "Emit when the focused date changes."
       }
     ]
   },
+  "NgpDatePickerRowRender": {
+    "name": "NgpDatePickerRowRender",
+    "description": "A structural directive that renders a row of weekdays in the date picker grid.",
+    "selector": "[ngpDatePickerRowRender]",
+    "exportAs": [
+      "ngpDatePickerRowRender"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpDialogTitle": {
     "name": "NgpDialogTitle",
     "description": "",
@@ -2052,22 +2118,22 @@
     "inputs": [],
     "outputs": []
   },
-  "NgpListboxSection": {
-    "name": "NgpListboxSection",
+  "NgpListboxTrigger": {
+    "name": "NgpListboxTrigger",
     "description": "",
-    "selector": "[ngpListboxSection]",
+    "selector": "[ngpListboxTrigger]",
     "exportAs": [
-      "ngpListboxSection"
+      "ngpListboxTrigger"
     ],
     "inputs": [],
     "outputs": []
   },
-  "NgpListboxTrigger": {
-    "name": "NgpListboxTrigger",
+  "NgpListboxSection": {
+    "name": "NgpListboxSection",
     "description": "",
-    "selector": "[ngpListboxTrigger]",
+    "selector": "[ngpListboxSection]",
     "exportAs": [
-      "ngpListboxTrigger"
+      "ngpListboxSection"
     ],
     "inputs": [],
     "outputs": []
@@ -2123,8 +2189,14 @@
       },
       {
         "name": "ngpListboxValue",
+        "type": "T[] | undefined",
+        "description": "The listbox selection. When defined the listbox is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpListboxDefaultValue",
         "type": "T[]",
-        "description": "The listbox selection.",
+        "description": "The default listbox selection for uncontrolled usage.",
         "isRequired": false,
         "defaultValue": "[]"
       },
@@ -2160,8 +2232,14 @@
     "inputs": [
       {
         "name": "ngpMenuItemRadioGroupValue",
+        "type": "string | null | undefined",
+        "description": "The current value of the radio group. When defined the group is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpMenuItemRadioGroupDefaultValue",
         "type": "string | null",
-        "description": "The current value of the radio group",
+        "description": "The default value for uncontrolled usage",
         "isRequired": false,
         "defaultValue": "null"
       }
@@ -2223,6 +2301,16 @@
     ],
     "outputs": []
   },
+  "NgpMenuItemIndicator": {
+    "name": "NgpMenuItemIndicator",
+    "description": "The `NgpMenuItemIndicator` directive renders inside a checkbox or radio menu item\nand exposes `data-checked` based on the parent item's checked state.",
+    "selector": "[ngpMenuItemIndicator]",
+    "exportAs": [
+      "ngpMenuItemIndicator"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpMenuItemCheckbox": {
     "name": "NgpMenuItemCheckbox",
     "description": "The `NgpMenuItemCheckbox` directive represents a menu item that can be toggled on and off.",
@@ -2233,8 +2321,14 @@
     "inputs": [
       {
         "name": "ngpMenuItemCheckboxChecked",
+        "type": "boolean | undefined",
+        "description": "Whether the checkbox is checked. When defined the checkbox is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpMenuItemCheckboxDefaultChecked",
         "type": "boolean",
-        "description": "Whether the checkbox is checked",
+        "description": "The default checked state for uncontrolled usage",
         "isRequired": false,
         "defaultValue": "false"
       },
@@ -2254,16 +2348,6 @@
       }
     ]
   },
-  "NgpMenuItemIndicator": {
-    "name": "NgpMenuItemIndicator",
-    "description": "The `NgpMenuItemIndicator` directive renders inside a checkbox or radio menu item\nand exposes `data-checked` based on the parent item's checked state.",
-    "selector": "[ngpMenuItemIndicator]",
-    "exportAs": [
-      "ngpMenuItemIndicator"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
   "NgpMenu": {
     "name": "NgpMenu",
     "description": "The `NgpMenu` is a container for menu items.",
@@ -2282,6 +2366,58 @@
     ],
     "outputs": []
   },
+  "NgpSubmenuTrigger": {
+    "name": "NgpSubmenuTrigger",
+    "description": "",
+    "selector": "[ngpSubmenuTrigger]",
+    "exportAs": [
+      "ngpSubmenuTrigger"
+    ],
+    "inputs": [
+      {
+        "name": "ngpSubmenuTrigger",
+        "type": "NgpOverlayContent<T> | undefined",
+        "description": "Access the submenu template ref.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpSubmenuTriggerDisabled",
+        "type": "boolean",
+        "description": "Define if the trigger should be disabled.\n@default false",
+        "isRequired": false,
+        "defaultValue": "false"
+      },
+      {
+        "name": "ngpSubmenuTriggerPlacement",
+        "type": "Placement",
+        "description": "Define the placement of the menu relative to the trigger.\n@default 'right-start'",
+        "isRequired": false,
+        "defaultValue": "'right-start'"
+      },
+      {
+        "name": "ngpSubmenuTriggerOffset",
+        "type": "NgpOffset",
+        "description": "Define the offset of the menu relative to the trigger.\nCan be a number (applies to mainAxis) or an object with mainAxis, crossAxis, and alignmentAxis.\n@default 0",
+        "isRequired": false,
+        "defaultValue": "0"
+      },
+      {
+        "name": "ngpSubmenuTriggerFlip",
+        "type": "NgpFlip",
+        "description": "Define whether the menu should flip when there is not enough space for the menu.\nCan be a boolean to enable/disable, or an object with padding and fallbackPlacements options.\n@default true",
+        "isRequired": false,
+        "defaultValue": "true"
+      },
+      {
+        "name": "ngpSubmenuTriggerContainer",
+        "type": "string | HTMLElement | null",
+        "description": "Define the container in which the menu should be attached.\n@default document.body",
+        "isRequired": false,
+        "defaultValue": "null"
+      }
+    ],
+    "outputs": []
+  },
   "NgpMenuTrigger": {
     "name": "NgpMenuTrigger",
     "description": "The `NgpMenuTrigger` directive allows you to turn an element into a menu trigger.",
@@ -2305,7 +2441,7 @@
       },
       {
         "name": "ngpMenuTriggerPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "Placement",
         "description": "Define the placement of the menu relative to the trigger.\n@default 'bottom-start'",
         "isRequired": false,
         "defaultValue": "'bottom-start'"
@@ -2380,58 +2516,6 @@
     ],
     "outputs": []
   },
-  "NgpSubmenuTrigger": {
-    "name": "NgpSubmenuTrigger",
-    "description": "",
-    "selector": "[ngpSubmenuTrigger]",
-    "exportAs": [
-      "ngpSubmenuTrigger"
-    ],
-    "inputs": [
-      {
-        "name": "ngpSubmenuTrigger",
-        "type": "NgpOverlayContent<T> | undefined",
-        "description": "Access the submenu template ref.",
-        "isRequired": false
-      },
-      {
-        "name": "ngpSubmenuTriggerDisabled",
-        "type": "boolean",
-        "description": "Define if the trigger should be disabled.\n@default false",
-        "isRequired": false,
-        "defaultValue": "false"
-      },
-      {
-        "name": "ngpSubmenuTriggerPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
-        "description": "Define the placement of the menu relative to the trigger.\n@default 'right-start'",
-        "isRequired": false,
-        "defaultValue": "'right-start'"
-      },
-      {
-        "name": "ngpSubmenuTriggerOffset",
-        "type": "NgpOffset",
-        "description": "Define the offset of the menu relative to the trigger.\nCan be a number (applies to mainAxis) or an object with mainAxis, crossAxis, and alignmentAxis.\n@default 0",
-        "isRequired": false,
-        "defaultValue": "0"
-      },
-      {
-        "name": "ngpSubmenuTriggerFlip",
-        "type": "NgpFlip",
-        "description": "Define whether the menu should flip when there is not enough space for the menu.\nCan be a boolean to enable/disable, or an object with padding and fallbackPlacements options.\n@default true",
-        "isRequired": false,
-        "defaultValue": "true"
-      },
-      {
-        "name": "ngpSubmenuTriggerContainer",
-        "type": "string | HTMLElement | null",
-        "description": "Define the container in which the menu should be attached.\n@default document.body",
-        "isRequired": false,
-        "defaultValue": "null"
-      }
-    ],
-    "outputs": []
-  },
   "NgpMeterTrack": {
     "name": "NgpMeterTrack",
     "description": "",
@@ -2771,8 +2855,14 @@
     "inputs": [
       {
         "name": "ngpNumberFieldValue",
+        "type": "number | null | undefined",
+        "description": "The value of the number field. When defined the number field is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpNumberFieldDefaultValue",
         "type": "number | null",
-        "description": "The value of the number field.",
+        "description": "The default value of the number field for uncontrolled usage.\n@default null",
         "isRequired": false,
         "defaultValue": "null"
       },
@@ -3004,6 +3094,30 @@
     ],
     "outputs": []
   },
+  "NgpPasswordInput": {
+    "name": "NgpPasswordInput",
+    "description": "Apply the `ngpPasswordInput` directive to an `input` element within an `ngpPassword` container.\nIt is a complete input (form control, interactions, autofill) with password visibility toggling\nlayered on top, so it does not need to be combined with `ngpInput`.",
+    "selector": "input[ngpPasswordInput]",
+    "exportAs": [
+      "ngpPasswordInput"
+    ],
+    "inputs": [
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "description": "Whether the input is disabled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpPasswordInputIgnorePasswordManagers",
+        "type": "boolean",
+        "description": "Whether to opt the input out of password manager injection\n(1Password, LastPass, Bitwarden, etc.).",
+        "isRequired": false,
+        "defaultValue": "false"
+      }
+    ],
+    "outputs": []
+  },
   "NgpPassword": {
     "name": "NgpPassword",
     "description": "The `NgpPassword` directive is a container for a password field and its visibility toggle.",
@@ -3034,30 +3148,6 @@
       }
     ]
   },
-  "NgpPasswordInput": {
-    "name": "NgpPasswordInput",
-    "description": "Apply the `ngpPasswordInput` directive to an `input` element within an `ngpPassword` container.\nIt is a complete input (form control, interactions, autofill) with password visibility toggling\nlayered on top, so it does not need to be combined with `ngpInput`.",
-    "selector": "input[ngpPasswordInput]",
-    "exportAs": [
-      "ngpPasswordInput"
-    ],
-    "inputs": [
-      {
-        "name": "disabled",
-        "type": "boolean",
-        "description": "Whether the input is disabled.",
-        "isRequired": false
-      },
-      {
-        "name": "ngpPasswordInputIgnorePasswordManagers",
-        "type": "boolean",
-        "description": "Whether to opt the input out of password manager injection\n(1Password, LastPass, Bitwarden, etc.).",
-        "isRequired": false,
-        "defaultValue": "false"
-      }
-    ],
-    "outputs": []
-  },
   "NgpPopoverArrow": {
     "name": "NgpPopoverArrow",
     "description": "",
@@ -3108,7 +3198,7 @@
       },
       {
         "name": "ngpPopoverTriggerPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "Placement",
         "description": "Define the placement of the popover relative to the trigger.\n@default 'top'",
         "isRequired": false,
         "defaultValue": "'bottom'"
@@ -3373,8 +3463,14 @@
     "inputs": [
       {
         "name": "ngpRatingValue",
+        "type": "number | undefined",
+        "description": "The value of the rating. When defined the rating is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpRatingDefaultValue",
         "type": "number",
-        "description": "The value of the rating.",
+        "description": "The default value of the rating for uncontrolled usage.\n@default 0",
         "isRequired": false,
         "defaultValue": "0"
       },
@@ -3509,16 +3605,6 @@
     ],
     "outputs": []
   },
-  "NgpSearchClear": {
-    "name": "NgpSearchClear",
-    "description": "The `NgpSearchClear` directive is can be added to a button to clear the search field on click.",
-    "selector": "[ngpSearchClear]",
-    "exportAs": [
-      "ngpSearchClear"
-    ],
-    "inputs": [],
-    "outputs": []
-  },
   "NgpSearch": {
     "name": "NgpSearch",
     "description": "The `NgpSearch` directive is a container for the search field components.",
@@ -3529,6 +3615,16 @@
     "inputs": [],
     "outputs": []
   },
+  "NgpSearchClear": {
+    "name": "NgpSearchClear",
+    "description": "The `NgpSearchClear` directive can be added to a button to clear the search field on click.",
+    "selector": "[ngpSearchClear]",
+    "exportAs": [
+      "ngpSearchClear"
+    ],
+    "inputs": [],
+    "outputs": []
+  },
   "NgpSelectPortal": {
     "name": "NgpSelectPortal",
     "description": "",
@@ -3801,15 +3897,27 @@
     "inputs": [
       {
         "name": "ngpRangeSliderLow",
+        "type": "number | undefined",
+        "description": "The low value of the range slider. When defined the low thumb is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpRangeSliderDefaultLow",
         "type": "number",
-        "description": "The low value of the range slider.",
+        "description": "The default low value for uncontrolled usage.\n@default 0",
         "isRequired": false,
         "defaultValue": "0"
       },
       {
         "name": "ngpRangeSliderHigh",
+        "type": "number | undefined",
+        "description": "The high value of the range slider. When defined the high thumb is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpRangeSliderDefaultHigh",
         "type": "number",
-        "description": "The high value of the range slider.",
+        "description": "The default high value for uncontrolled usage.\n@default 100",
         "isRequired": false,
         "defaultValue": "100"
       },
@@ -3872,8 +3980,14 @@
     "inputs": [
       {
         "name": "ngpSliderValue",
-        "type": "number",
+        "type": "number | undefined",
         "description": "The value of the slider.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpSliderDefaultValue",
+        "type": "number",
+        "description": "The default value of the slider for uncontrolled usage.\n@default 0",
         "isRequired": false,
         "defaultValue": "0"
       },
@@ -3939,8 +4053,14 @@
     "inputs": [
       {
         "name": "ngpSwitchChecked",
+        "type": "boolean | undefined",
+        "description": "Determine if the switch is checked. When defined the switch is controlled.",
+        "isRequired": false
+      },
+      {
+        "name": "ngpSwitchDefaultChecked",
         "type": "boolean",
-        "description": "Determine if the switch is checked.\n@default false",
+        "description": "The default checked state for uncontrolled usage.\n@default false",
         "isRequired": false,
         "defaultValue": "false"
       },
@@ -4290,7 +4410,7 @@
       },
       {
         "name": "ngpTooltipTriggerPlacement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "Placement",
         "description": "Define the placement of the tooltip relative to the trigger.\n@default 'top'",
         "isRequired": false,
         "defaultValue": "'top'"
@@ -4440,7 +4560,7 @@
     "properties": [
       {
         "name": "placement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "NgpPlacement",
         "description": "The default placement for the combobox dropdown.",
         "default": "'bottom'"
       },
@@ -4621,7 +4741,7 @@
       },
       {
         "name": "placement",
-        "type": "'top' | 'right' | 'bottom' | 'left' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-start' | 'bottom-end' | 'left-start' | 'left-end'",
+        "type": "NgpPlacement",
         "description": "Define the placement of the menu relative to the trigger.",
         "default": "'bottom-start'"
       },
@@ -4704,7 +4824,7 @@
       },
       {
         "name": "placement",
-        "type": "Placement",
+        "type": "NgpPlacement",
         "description": "Define the placement of the content relative to the trigger.",
         "default": "'bottom-start'"
       },
@@ -4792,7 +4912,7 @@
       },
       {
         "name": "placement",
-        "type": "Placement",
+        "type": "NgpPlacement",
         "description": "Define the placement of the popover relative to the trigger.",
         "default": "'bottom'"
       },
@@ -4863,8 +4983,8 @@
     "properties": [
       {
         "name": "content",
-        "type": "NgpOverlayContent<T>",
-        "description": "Content to display in the overlay (component or template)"
+        "type": "Signal<NgpOverlayContent<T> | null | undefined>",
+        "description": "Content to display in the overlay (component or template). Read whenever the overlay opens, and while it is open a change swaps the rendered content, so a trigger can hand over an input signal and let it change.  Clearing it closes the overlay immediately - there is nothing left to render, so neither the hide delay nor the exit animation applies - and an overlay with no content will not open."
       },
       {
         "name": "triggerElement",
@@ -4898,7 +5018,7 @@
       },
       {
         "name": "placement",
-        "type": "Signal<Placement>",
+        "type": "Signal<NgpPlacement>",
         "description": "Preferred placement of the overlay relative to the trigger."
       },
       {
@@ -4928,7 +5048,7 @@
       },
       {
         "name": "strategy",
-        "type": "Strategy",
+        "type": "NgpPositioningStrategy",
         "description": "Whether the overlay should be positioned with fixed or absolute strategy"
       },
       {
@@ -4958,7 +5078,7 @@
       },
       {
         "name": "additionalMiddleware",
-        "type": "Middleware[]",
+        "type": "NgpMiddleware[]",
         "description": "Additional middleware for floating UI positioning"
       },
       {
@@ -5021,7 +5141,7 @@
     "properties": [
       {
         "name": "placement",
-        "type": "Placement",
+        "type": "NgpPlacement",
         "description": "The default placement for the select dropdown.",
         "default": "'bottom'"
       },
@@ -5213,7 +5333,7 @@
       },
       {
         "name": "placement",
-        "type": "Placement",
+        "type": "NgpPlacement",
         "description": "Define the placement of the tooltip relative to the trigger.",
         "default": "'top'"
       },