@ionic/docs 7.5.8-dev.11703088210.14a72b83 → 7.5.8-dev.11705350665.1a40ee3a

package/core.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2023-12-20T16:05:29",
+  "timestamp": "2024-01-15T20:32:58",
   "compiler": {
     "name": "@stencil/core",
-    "version": "4.8.0",
+    "version": "4.8.1",
     "typescriptVersion": "5.2.2"
   },
   "components": [
@@ -2574,7 +2574,7 @@
         "ion-loading",
         "ion-menu",
         "ion-modal",
-        "ion-picker",
+        "ion-picker-legacy",
         "ion-popover"
       ],
       "dependencies": [],
@@ -2594,7 +2594,7 @@
         "ion-modal": [
           "ion-backdrop"
         ],
-        "ion-picker": [
+        "ion-picker-legacy": [
           "ion-backdrop"
         ],
         "ion-popover": [
@@ -7866,6 +7866,11 @@
           "name": "--wheel-highlight-background",
           "annotation": "prop",
           "docs": "The background of the highlight under the selected item when using a wheel style layout, or in the month/year picker for grid style layouts."
+        },
+        {
+          "name": "--wheel-highlight-border-radius",
+          "annotation": "prop",
+          "docs": "The border radius of the highlight under the selected item when using a wheel style layout, or in the month/year picker for grid style layouts."
         }
       ],
       "slots": [
@@ -7924,32 +7929,27 @@
       "dependencies": [
         "ion-buttons",
         "ion-button",
-        "ion-picker-internal",
-        "ion-picker-column-internal",
-        "ion-item",
-        "ion-label",
+        "ion-picker",
+        "ion-picker-column",
+        "ion-picker-column-option",
         "ion-icon",
+        "ion-ripple-effect",
         "ion-popover"
       ],
       "dependencyGraph": {
         "ion-datetime": [
           "ion-buttons",
           "ion-button",
-          "ion-picker-internal",
-          "ion-picker-column-internal",
-          "ion-item",
-          "ion-label",
+          "ion-picker",
+          "ion-picker-column",
+          "ion-picker-column-option",
           "ion-icon",
+          "ion-ripple-effect",
           "ion-popover"
         ],
         "ion-button": [
           "ion-ripple-effect"
         ],
-        "ion-item": [
-          "ion-icon",
-          "ion-ripple-effect",
-          "ion-note"
-        ],
         "ion-popover": [
           "ion-backdrop"
         ]
@@ -9991,7 +9991,7 @@
           "mutable": false,
           "attr": "autofocus",
           "reflectToAttr": false,
-          "docs": "This Boolean attribute lets you specify that a form control should have input focus when the page loads.",
+          "docs": "Sets the [`autofocus` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus) on the native input element.\n\nThis may not be sufficient for the element to be focused on page load. See [managing focus](/docs/developing/managing-focus) for more information.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -10978,7 +10978,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the native `input` in `ion-input`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.",
+          "docs": "Sets focus on the native `input` in `ion-input`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.\n\nSee [managing focus](/docs/developing/managing-focus) for more information.",
           "docsTags": []
         }
       ],
@@ -11964,7 +11964,6 @@
         }
       ],
       "dependents": [
-        "ion-datetime",
         "ion-select-popover"
       ],
       "dependencies": [
@@ -11978,9 +11977,6 @@
           "ion-ripple-effect",
           "ion-note"
         ],
-        "ion-datetime": [
-          "ion-item"
-        ],
         "ion-select-popover": [
           "ion-item"
         ]
@@ -12971,14 +12967,10 @@
       "slots": [],
       "parts": [],
       "dependents": [
-        "ion-datetime",
         "ion-select-popover"
       ],
       "dependencies": [],
       "dependencyGraph": {
-        "ion-datetime": [
-          "ion-label"
-        ],
         "ion-select-popover": [
           "ion-label"
         ]
@@ -17265,7 +17257,7 @@
     },
     {
       "filePath": "src/components/picker/picker.tsx",
-      "encapsulation": "scoped",
+      "encapsulation": "shadow",
       "tag": "ion-picker",
       "docs": "",
       "docsTags": [
@@ -17275,6 +17267,442 @@
         }
       ],
       "usage": {},
+      "props": [
+        {
+          "name": "mode",
+          "type": "\"ios\" | \"md\"",
+          "mutable": false,
+          "attr": "mode",
+          "reflectToAttr": false,
+          "docs": "The mode determines which platform styles to use.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "ios",
+              "type": "string"
+            },
+            {
+              "value": "md",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [
+        {
+          "event": "touchstart",
+          "capture": false,
+          "passive": true
+        }
+      ],
+      "styles": [
+        {
+          "name": "--fade-background-rgb",
+          "annotation": "prop",
+          "docs": "Background of the gradient covering non-selected items in rgb format"
+        },
+        {
+          "name": "--highlight-background",
+          "annotation": "prop",
+          "docs": "Background of the picker highlight for the selected item"
+        },
+        {
+          "name": "--highlight-border-radius",
+          "annotation": "prop",
+          "docs": "Border radius of the picker highlight for the selected item"
+        }
+      ],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "ion-datetime"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "ion-datetime": [
+          "ion-picker"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/picker-column/picker-column.tsx",
+      "encapsulation": "shadow",
+      "tag": "ion-picker-column",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "virtualProp",
+          "text": "{\"ios\" | \"md\"} mode - The mode determines which platform styles to use."
+        },
+        {
+          "name": "slot",
+          "text": "prefix - Content to show on the left side of the picker options."
+        },
+        {
+          "name": "slot",
+          "text": "suffix - Content to show on the right side of the picker options."
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "color",
+          "type": "\"danger\" | \"dark\" | \"light\" | \"medium\" | \"primary\" | \"secondary\" | \"success\" | \"tertiary\" | \"warning\" | string & Record<never, never> | undefined",
+          "complexType": {
+            "original": "Color",
+            "resolved": "\"danger\" | \"dark\" | \"light\" | \"medium\" | \"primary\" | \"secondary\" | \"success\" | \"tertiary\" | \"warning\" | string & Record<never, never> | undefined",
+            "references": {
+              "Color": {
+                "location": "import",
+                "path": "../../interface",
+                "id": "src/interface.d.ts::Color"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "color",
+          "reflectToAttr": true,
+          "docs": "The color to use from your application's color palette.\nDefault options are: `\"primary\"`, `\"secondary\"`, `\"tertiary\"`, `\"success\"`, `\"warning\"`, `\"danger\"`, `\"light\"`, `\"medium\"`, and `\"dark\"`.\nFor more information on colors, see [theming](/docs/theming/basics).",
+          "docsTags": [],
+          "default": "'primary'",
+          "values": [
+            {
+              "value": "danger",
+              "type": "string"
+            },
+            {
+              "value": "dark",
+              "type": "string"
+            },
+            {
+              "value": "light",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "primary",
+              "type": "string"
+            },
+            {
+              "value": "secondary",
+              "type": "string"
+            },
+            {
+              "value": "success",
+              "type": "string"
+            },
+            {
+              "value": "tertiary",
+              "type": "string"
+            },
+            {
+              "value": "warning",
+              "type": "string"
+            },
+            {
+              "type": "string & Record<never, never>"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": false,
+          "docs": "If `true`, the user cannot interact with the picker.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "mode",
+          "type": "\"ios\" | \"md\"",
+          "mutable": false,
+          "attr": "mode",
+          "reflectToAttr": false,
+          "docs": "The mode determines which platform styles to use.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "ios",
+              "type": "string"
+            },
+            {
+              "value": "md",
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "value",
+          "type": "number | string | undefined",
+          "complexType": {
+            "original": "string | number",
+            "resolved": "number | string | undefined",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The selected option in the picker.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the scrollable container within the picker column.\nUse this method instead of the global `pickerColumn.focus()`.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "ionChange",
+          "detail": "PickerColumnChangeEventDetail",
+          "bubbles": true,
+          "complexType": {
+            "original": "PickerColumnChangeEventDetail",
+            "resolved": "PickerColumnChangeEventDetail",
+            "references": {
+              "PickerColumnChangeEventDetail": {
+                "location": "import",
+                "path": "./picker-column-interfaces",
+                "id": "src/components/picker-column/picker-column-interfaces.ts::PickerColumnChangeEventDetail"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the value has changed.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "prefix",
+          "docs": "Content to show on the left side of the picker options."
+        },
+        {
+          "name": "suffix",
+          "docs": "Content to show on the right side of the picker options."
+        }
+      ],
+      "parts": [],
+      "dependents": [
+        "ion-datetime"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "ion-datetime": [
+          "ion-picker-column"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/picker-column-option/picker-column-option.tsx",
+      "encapsulation": "shadow",
+      "tag": "ion-picker-column-option",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "color",
+          "type": "\"danger\" | \"dark\" | \"light\" | \"medium\" | \"primary\" | \"secondary\" | \"success\" | \"tertiary\" | \"warning\" | string & Record<never, never> | undefined",
+          "complexType": {
+            "original": "Color",
+            "resolved": "\"danger\" | \"dark\" | \"light\" | \"medium\" | \"primary\" | \"secondary\" | \"success\" | \"tertiary\" | \"warning\" | string & Record<never, never> | undefined",
+            "references": {
+              "Color": {
+                "location": "import",
+                "path": "../../interface",
+                "id": "src/interface.d.ts::Color"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "color",
+          "reflectToAttr": true,
+          "docs": "The color to use from your application's color palette.\nDefault options are: `\"primary\"`, `\"secondary\"`, `\"tertiary\"`, `\"success\"`, `\"warning\"`, `\"danger\"`, `\"light\"`, `\"medium\"`, and `\"dark\"`.\nFor more information on colors, see [theming](/docs/theming/basics).",
+          "docsTags": [],
+          "default": "'primary'",
+          "values": [
+            {
+              "value": "danger",
+              "type": "string"
+            },
+            {
+              "value": "dark",
+              "type": "string"
+            },
+            {
+              "value": "light",
+              "type": "string"
+            },
+            {
+              "value": "medium",
+              "type": "string"
+            },
+            {
+              "value": "primary",
+              "type": "string"
+            },
+            {
+              "value": "secondary",
+              "type": "string"
+            },
+            {
+              "value": "success",
+              "type": "string"
+            },
+            {
+              "value": "tertiary",
+              "type": "string"
+            },
+            {
+              "value": "warning",
+              "type": "string"
+            },
+            {
+              "type": "string & Record<never, never>"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": false,
+          "docs": "If `true`, the user cannot interact with the picker column option.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "value",
+          "type": "any",
+          "complexType": {
+            "original": "any | null",
+            "resolved": "any",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The text value of the option.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "any"
+            }
+          ],
+          "optional": true,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "ion-datetime"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "ion-datetime": [
+          "ion-picker-column-option"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/picker-legacy/picker.tsx",
+      "encapsulation": "scoped",
+      "tag": "ion-picker-legacy",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "virtualProp",
+          "text": "{\"ios\" | \"md\"} mode - The mode determines which platform styles to use."
+        }
+      ],
+      "usage": {},
       "props": [
         {
           "name": "animated",
@@ -17330,7 +17758,7 @@
               "PickerButton": {
                 "location": "import",
                 "path": "./picker-interface",
-                "id": "src/components/picker/picker-interface.ts::PickerButton"
+                "id": "src/components/picker-legacy/picker-interface.ts::PickerButton"
               }
             }
           },
@@ -17357,7 +17785,7 @@
               "PickerColumn": {
                 "location": "import",
                 "path": "./picker-interface",
-                "id": "src/components/picker/picker-interface.ts::PickerColumn"
+                "id": "src/components/picker-legacy/picker-interface.ts::PickerColumn"
               }
             }
           },
@@ -17694,7 +18122,7 @@
               "PickerColumn": {
                 "location": "import",
                 "path": "./picker-interface",
-                "id": "src/components/picker/picker-interface.ts::PickerColumn"
+                "id": "src/components/picker-legacy/picker-interface.ts::PickerColumn"
               }
             },
             "return": "Promise<PickerColumn | undefined>"
@@ -18005,12 +18433,12 @@
       "dependents": [],
       "dependencies": [
         "ion-backdrop",
-        "ion-picker-column"
+        "ion-picker-legacy-column"
       ],
       "dependencyGraph": {
-        "ion-picker": [
+        "ion-picker-legacy": [
           "ion-backdrop",
-          "ion-picker-column"
+          "ion-picker-legacy-column"
         ]
       }
     },
@@ -21238,6 +21666,7 @@
         "ion-button",
         "ion-card",
         "ion-chip",
+        "ion-datetime",
         "ion-datetime-button",
         "ion-fab-button",
         "ion-item",
@@ -21267,6 +21696,9 @@
         "ion-chip": [
           "ion-ripple-effect"
         ],
+        "ion-datetime": [
+          "ion-ripple-effect"
+        ],
         "ion-datetime-button": [
           "ion-ripple-effect"
         ],
@@ -22977,7 +23409,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the native `input` in `ion-searchbar`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.",
+          "docs": "Sets focus on the native `input` in `ion-searchbar`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.\n\nSee [managing focus](/docs/developing/managing-focus) for more information.",
           "docsTags": []
         }
       ],
@@ -26100,7 +26532,7 @@
           "mutable": false,
           "attr": "autofocus",
           "reflectToAttr": false,
-          "docs": "This Boolean attribute lets you specify that a form control should have input focus when the page loads.",
+          "docs": "Sets the [`autofocus` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus) on the native input element.\n\nThis may not be sufficient for the element to be focused on page load. See [managing focus](/docs/developing/managing-focus) for more information.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -26918,7 +27350,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global\n`textarea.focus()`.",
+          "docs": "Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global\n`textarea.focus()`.\n\nSee [managing focus](/docs/developing/managing-focus) for more information.",
           "docsTags": []
         }
       ],
@@ -29058,15 +29490,20 @@
       "docstring": "",
       "path": "src/components/datetime/datetime-interface.ts"
     },
-    "src/components/picker-column-internal/picker-column-internal-interfaces.ts::PickerColumnItem": {
-      "declaration": "export interface PickerColumnItem {\n  text: string;\n  value: string | number;\n  disabled?: boolean;\n}",
+    "src/components/picker-column/picker-column-interfaces.ts::PickerColumnChangeEventDetail": {
+      "declaration": "export interface PickerColumnChangeEventDetail {\n  value: PickerColumnValue;\n}",
+      "docstring": "",
+      "path": "src/components/picker-column/picker-column-interfaces.ts"
+    },
+    "src/components/picker-column/picker-column-interfaces.ts::PickerColumnValue": {
+      "declaration": "export type PickerColumnValue = string | number | undefined;",
       "docstring": "",
-      "path": "src/components/picker-column-internal/picker-column-internal-interfaces.ts"
+      "path": "src/components/picker-column/picker-column-interfaces.ts"
     },
-    "src/components/picker-internal/picker-internal-interfaces.ts::PickerInternalChangeEventDetail": {
-      "declaration": "export interface PickerInternalChangeEventDetail {\n  useInputMode: boolean;\n  inputModeColumn?: HTMLIonPickerColumnInternalElement;\n}",
+    "src/components/picker/picker-interfaces.ts::PickerChangeEventDetail": {
+      "declaration": "export interface PickerChangeEventDetail {\n  useInputMode: boolean;\n  inputModeColumn?: HTMLIonPickerColumnElement;\n}",
       "docstring": "",
-      "path": "src/components/picker-internal/picker-internal-interfaces.ts"
+      "path": "src/components/picker/picker-interfaces.ts"
     },
     "src/components/spinner/spinner-configs.ts::SpinnerTypes": {
       "declaration": "\"bubbles\" | \"circles\" | \"circular\" | \"crescent\" | \"dots\" | \"lines\" | \"lines-small\" | \"lines-sharp\" | \"lines-sharp-small\"",
@@ -29168,15 +29605,15 @@
       "docstring": "",
       "path": "src/components/router/utils/interface.ts"
     },
-    "src/components/picker/picker-interface.ts::PickerButton": {
+    "src/components/picker-legacy/picker-interface.ts::PickerButton": {
       "declaration": "export interface PickerButton {\n  text?: string;\n  role?: string;\n  cssClass?: string | string[];\n  handler?: (value: any) => boolean | void;\n}",
       "docstring": "",
-      "path": "src/components/picker/picker-interface.ts"
+      "path": "src/components/picker-legacy/picker-interface.ts"
     },
-    "src/components/picker/picker-interface.ts::PickerColumn": {
+    "src/components/picker-legacy/picker-interface.ts::PickerColumn": {
       "declaration": "export interface PickerColumn {\n  name: string;\n  align?: string;\n  /**\n   * Changing this value allows the initial value of a picker column to be set.\n   */\n  selectedIndex?: number;\n  prevSelected?: number;\n  prefix?: string;\n  suffix?: string;\n  options: PickerColumnOption[];\n  cssClass?: string | string[];\n  columnWidth?: string;\n  prefixWidth?: string;\n  suffixWidth?: string;\n  optionsWidth?: string;\n}",
       "docstring": "",
-      "path": "src/components/picker/picker-interface.ts"
+      "path": "src/components/picker-legacy/picker-interface.ts"
     },
     "src/components/popover/popover-interface.ts::TriggerAction": {
       "declaration": "export type TriggerAction = 'click' | 'hover' | 'context-menu';",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ionic/docs",
-  "version": "7.5.8-dev.11703088210.14a72b83",
+  "version": "7.5.8-dev.11705350665.1a40ee3a",
   "description": "Pre-packaged API documentation for the Ionic docs.",
   "main": "core.json",
   "types": "core.d.ts",