@pure-ds/storybook 0.7.23 → 0.7.26

package/dist/pds-reference.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-02-26T14:42:23.254Z",
+  "generatedAt": "2026-03-03T15:26:02.592Z",
   "sources": {
     "customElements": "custom-elements.json",
     "ontology": "src\\js\\pds-core\\pds-ontology.js",
@@ -14,7 +14,7 @@
       "storyTitle": "Components/pds-calendar",
       "category": "Components",
       "description": null,
-      "docsDescription": "A fully featured calendar component with month navigation, event display, and expandable day views",
+      "docsDescription": "A fully featured calendar component with month navigation, event display, and keyboard-accessible date selection",
       "pdsTags": [
         "autodocs",
         "calendar",
@@ -38,69 +38,61 @@
         ],
         "category": "form"
       },
-      "stories": [
-        {
-          "exportName": "Default",
-          "name": "Default",
-          "id": "components-pds-calendar--default",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
+      "stories": [],
+      "sourceModule": "public/assets/pds/components/pds-calendar.js",
+      "superclass": "HTMLElement",
+      "attributes": [
         {
-          "exportName": "DynamicEvents",
-          "name": "DynamicEvents",
-          "id": "components-pds-calendar--dynamic-events",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+          "name": "date",
+          "description": "The date to display (defaults to current date). Accepts any valid date string",
+          "type": "String",
+          "default": null,
+          "fieldName": null,
+          "property": "date"
         },
         {
-          "exportName": "EventTypes",
-          "name": "EventTypes",
-          "id": "components-pds-calendar--event-types",
-          "tags": [],
+          "name": "required",
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+          "type": null,
+          "default": null,
+          "fieldName": null,
+          "property": "required"
         },
         {
-          "exportName": "FormParticipation",
-          "name": "FormParticipation",
-          "id": "components-pds-calendar--form-participation",
-          "tags": [],
+          "name": "name",
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+          "type": null,
+          "default": null,
+          "fieldName": null,
+          "property": "name"
         },
         {
-          "exportName": "WithManyEvents",
-          "name": "WithManyEvents",
-          "id": "components-pds-calendar--with-many-events",
-          "tags": [],
+          "name": "disabled",
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+          "type": null,
+          "default": null,
+          "fieldName": null,
+          "property": "disabled"
         },
         {
-          "exportName": "WithSpecificDate",
-          "name": "WithSpecificDate",
-          "id": "components-pds-calendar--with-specific-date",
-          "tags": [],
+          "name": "compact",
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        }
-      ],
-      "sourceModule": "public/assets/pds/components/pds-calendar.js",
-      "superclass": "HTMLElement",
-      "attributes": [
-        {
-          "name": "date",
-          "description": "The date to display (defaults to current date). Accepts any valid date string",
-          "type": "String",
+          "type": null,
           "default": null,
           "fieldName": null,
-          "property": "date"
+          "property": "compact"
         }
       ],
       "properties": [
+        {
+          "name": "compact",
+          "attribute": "compact",
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
         {
           "name": "date",
           "attribute": "date",
@@ -118,22 +110,167 @@
           "default": "new DateHelper()",
           "reflects": false,
           "privacy": "public"
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "form",
+          "attribute": null,
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "formAssociated",
+          "attribute": null,
+          "description": null,
+          "type": "boolean",
+          "default": "true",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "name",
+          "attribute": "name",
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "required",
+          "attribute": "required",
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "type",
+          "attribute": null,
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "value",
+          "attribute": null,
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
         }
       ],
       "methods": [
+        {
+          "name": "checkValidity",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "focus",
+          "description": null,
+          "parameters": [
+            {
+              "name": "options",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "formAssociatedCallback",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "formDisabledCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "disabled",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "formResetCallback",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "formStateRestoreCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "state",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
         {
           "name": "refresh",
           "description": "Refreshes the calendar display",
           "parameters": [],
           "return": null
+        },
+        {
+          "name": "reportValidity",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "serializeDate",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "updateFormState",
+          "description": null,
+          "parameters": [],
+          "return": null
         }
       ],
       "events": [
+        {
+          "name": "month-change",
+          "description": null,
+          "type": "CustomEvent"
+        },
         {
           "name": "month-rendered",
           "description": null,
           "type": "CustomEvent"
         },
+        {
+          "name": "pds-calendar#month-change",
+          "description": "Dispatched when the visible month/year changes",
+          "type": null
+        },
         {
           "name": "pds-calendar#month-rendered",
           "description": "Dispatched after the calendar month is rendered with event fill capability",
@@ -165,403 +302,1355 @@
       ],
       "notes": []
     },
-    "pds-drawer": {
-      "tag": "pds-drawer",
-      "className": "PdsDrawer",
-      "displayName": "pds-drawer",
-      "storyTitle": "Components/pds-drawer",
-      "category": "Components",
+    "pds-code": {
+      "tag": "pds-code",
+      "className": "PDSCode",
+      "displayName": "PDS Code",
+      "storyTitle": null,
+      "category": null,
       "description": null,
-      "docsDescription": "Slide-out panels from any edge",
-      "pdsTags": [
-        "autodocs",
-        "drawer",
-        "grouping",
-        "interaction",
-        "layout",
-        "modal",
-        "navigation",
-        "overlay",
-        "panel",
-        "pds-drawer",
-        "sidebar"
-      ],
-      "ontology": {
-        "id": "pds-drawer",
-        "name": "Drawer",
-        "description": "Slide-out panel overlay",
-        "selectors": [
-          "pds-drawer"
-        ],
-        "tags": [
-          "panel",
-          "overlay",
-          "sidebar"
-        ],
-        "category": "overlay"
-      },
-      "stories": [
-        {
-          "exportName": "Default",
-          "name": "Default",
-          "id": "components-pds-drawer--default",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsDrawer.stories.js"
-        }
-      ],
-      "sourceModule": "public/assets/pds/components/pds-drawer.js",
+      "docsDescription": null,
+      "pdsTags": [],
+      "ontology": null,
+      "stories": [],
+      "sourceModule": "public/assets/pds/components/pds-code.js",
       "superclass": "HTMLElement",
       "attributes": [
         {
-          "name": "open",
-          "description": "Controls whether the drawer is open or closed",
-          "type": "boolean",
+          "name": "code",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": "open",
-          "property": "open"
+          "fieldName": null,
+          "property": "code"
         },
         {
-          "name": "position",
-          "description": "Position of the drawer relative to the viewport",
-          "type": "\"bottom\" | \"top\" | \"left\" | \"right\"",
-          "default": "\"bottom\"",
-          "fieldName": "position",
-          "property": "position"
-        },
-        {
-          "name": "drag",
-          "description": "Controls drag interaction behavior",
-          "type": "\"header\" | \"none\"",
-          "default": "\"header\"",
-          "fieldName": "drag",
-          "property": "drag"
-        },
-        {
-          "name": "max-height",
-          "description": "Maximum height for top/bottom positioned drawers (CSS value)",
-          "type": "string",
-          "default": "\"70vh\"",
-          "fieldName": "maxHeight",
-          "property": "maxHeight"
-        },
-        {
-          "name": "min-height",
-          "description": "Minimum height for top/bottom positioned drawers (CSS value)",
-          "type": "string",
-          "default": "\"auto\"",
-          "fieldName": "minHeight",
-          "property": "minHeight"
+          "name": "lang",
+          "description": null,
+          "type": null,
+          "default": null,
+          "fieldName": null
         },
         {
-          "name": "show-close",
-          "description": "Whether to show the close button in the header",
-          "type": "boolean",
-          "default": "false",
-          "fieldName": "showClose",
-          "property": "showClose"
+          "name": "theme",
+          "description": null,
+          "type": null,
+          "default": null,
+          "fieldName": null
         }
       ],
       "properties": [
         {
-          "name": "drag",
-          "attribute": "drag",
-          "description": "Controls drag interaction behavior",
-          "type": "\"header\" | \"none\"",
-          "default": "\"header\"",
-          "reflects": false,
-          "privacy": "public"
-        },
-        {
-          "name": "maxHeight",
-          "attribute": "max-height",
-          "description": "Maximum height for top/bottom positioned drawers (CSS value)",
-          "type": "string",
-          "default": "\"70vh\"",
+          "name": "code",
+          "attribute": "code",
+          "description": null,
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
-        },
+        }
+      ],
+      "methods": [
         {
-          "name": "minHeight",
-          "attribute": "min-height",
-          "description": "Minimum height for top/bottom positioned drawers (CSS value)",
-          "type": "string",
-          "default": "\"auto\"",
-          "reflects": false,
-          "privacy": "public"
+          "name": "attributeChangedCallback",
+          "description": null,
+          "parameters": [],
+          "return": "void"
         },
         {
-          "name": "open",
-          "attribute": "open",
-          "description": "Controls whether the drawer is open or closed",
-          "type": "boolean",
-          "default": null,
-          "reflects": false,
-          "privacy": "public"
+          "name": "captureInitialText",
+          "description": null,
+          "parameters": [],
+          "return": "void"
         },
         {
-          "name": "position",
-          "attribute": "position",
-          "description": "Position of the drawer relative to the viewport",
-          "type": "\"bottom\" | \"top\" | \"left\" | \"right\"",
-          "default": "\"bottom\"",
-          "reflects": false,
-          "privacy": "public"
+          "name": "connectedCallback",
+          "description": null,
+          "parameters": [],
+          "return": "void"
         },
         {
-          "name": "showClose",
-          "attribute": "show-close",
-          "description": "Whether to show the close button in the header",
-          "type": "boolean",
-          "default": "false",
-          "reflects": false,
-          "privacy": "public"
-        }
-      ],
-      "methods": [
-        {
-          "name": "clearContent",
-          "description": "Clear drawer content (removes all slotted content)",
+          "name": "disconnectedCallback",
+          "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "closeDrawer",
-          "description": "Closes the drawer",
+          "name": "ensureCodeFromContent",
+          "description": null,
           "parameters": [],
-          "return": null
+          "return": "boolean"
         },
         {
-          "name": "openDrawer",
-          "description": "Opens the drawer",
+          "name": "render",
+          "description": null,
           "parameters": [],
-          "return": null
+          "return": "Promise<void>"
         },
         {
-          "name": "setContent",
-          "description": "Set the content of the drawer",
+          "name": "setCode",
+          "description": null,
           "parameters": [
             {
-              "name": "bodyContent",
-              "type": "any|HTMLElement|string",
-              "description": "Content for the drawer body"
+              "name": "value",
+              "type": "any",
+              "description": null,
+              "optional": false
             },
             {
-              "name": "headerContent",
-              "type": "any|HTMLElement|string",
-              "description": "Optional header content"
+              "name": "{ lang, theme }",
+              "type": "{}",
+              "description": null,
+              "optional": true
             }
           ],
-          "return": "Promise<void>"
+          "return": "void"
         },
         {
-          "name": "show",
-          "description": "Configure and open the drawer in one call",
-          "parameters": [
-            {
-              "name": "htmlContent",
-              "type": "any|HTMLElement|string",
-              "description": "The main content to display"
-            },
-            {
-              "name": "options",
-              "type": "@param {any|HTMLElement|string} [options.header] - Header content\n   * @param {\"bottom\"|\"top\"|\"left\"|\"right\"} [options.position] - Drawer position\n   * @param {string} [options.maxHeight] - Maximum height (CSS value)\n   * @param {string} [options.minHeight] - Minimum height (CSS value)\n   * @param {boolean} [options.showClose] - Show close button\n   * @param {boolean} [options.waitForMedia=true] - Wait for images/videos to load\n   * @param {number} [options.mediaTimeout=500] - Media load timeout in ms\n   * ",
-              "description": "Configuration options"
-            }
-          ],
-          "return": "Promise<this>"
+          "name": "startTextObserver",
+          "description": null,
+          "parameters": [],
+          "return": "void"
         },
         {
-          "name": "toggleDrawer",
-          "description": "Toggles the drawer open/closed state",
+          "name": "stopTextObserver",
+          "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         }
       ],
-      "events": [
+      "events": [],
+      "slots": [],
+      "cssParts": [],
+      "notes": []
+    },
+    "pds-daterange": {
+      "tag": "pds-daterange",
+      "className": "PdsDateRange",
+      "displayName": "pds-daterange",
+      "storyTitle": "Components/pds-daterange",
+      "category": "Components",
+      "description": null,
+      "docsDescription": "Form-associated date range picker with compact dual-calendar dropdown and ISO interval value output.",
+      "pdsTags": [
+        "autodocs",
+        "calendar",
+        "date",
+        "form",
+        "pds-daterange",
+        "range",
+        "travel"
+      ],
+      "ontology": null,
+      "stories": [
         {
-          "name": "toggle",
-          "description": "Fired when the drawer opens or closes",
-          "type": null
+          "exportName": "Default",
+          "name": "Default",
+          "id": "components-pds-daterange--default",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsDaterange.stories.js"
         }
       ],
-      "slots": [
+      "sourceModule": "public/assets/pds/components/pds-daterange.js",
+      "superclass": "HTMLElement",
+      "attributes": [
         {
-          "name": "drawer-header",
-          "description": "Header content for the drawer"
+          "name": "name",
+          "description": "Form field name used during form submission.",
+          "type": "String",
+          "default": null,
+          "fieldName": null,
+          "property": "name"
         },
         {
-          "name": "drawer-content",
-          "description": "Main content of the drawer"
-        }
-      ],
-      "cssParts": [
+          "name": "required",
+          "description": "Requires both start and end dates to be selected.",
+          "type": "Boolean",
+          "default": null,
+          "fieldName": null,
+          "property": "required"
+        },
         {
-          "name": "backdrop",
-          "description": "The semi-transparent backdrop overlay"
+          "name": "disabled",
+          "description": "Disables interaction and closes the panel when active.",
+          "type": "Boolean",
+          "default": null,
+          "fieldName": null,
+          "property": "disabled"
         },
         {
-          "name": "panel",
-          "description": "The drawer panel container"
+          "name": "value",
+          "description": "Serialized range value as ISO interval: `YYYY-MM-DD/YYYY-MM-DD`.",
+          "type": "String",
+          "default": null,
+          "fieldName": null,
+          "property": "value"
         },
         {
-          "name": "header",
-          "description": "The drawer header section"
+          "name": "display-format",
+          "description": "Button date text format. Default is `d MMM yy`.",
+          "type": "String",
+          "default": null,
+          "fieldName": null,
+          "property": "displayFormat"
+        }
+      ],
+      "properties": [
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": "Whether the control is disabled.",
+          "type": "Boolean",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "close-button",
-          "description": "The close button"
+          "name": "displayFormat",
+          "attribute": null,
+          "description": "Button date text format.",
+          "type": "String",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "grab-handle",
-          "description": "The drag handle indicator"
+          "name": "endDate",
+          "attribute": null,
+          "description": "End date value.",
+          "type": "Date|null",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "content",
-          "description": "The drawer content section"
-        }
-      ],
-      "notes": []
-    },
+          "name": "form",
+          "attribute": null,
+          "description": null,
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "formAssociated",
+          "attribute": null,
+          "description": null,
+          "type": "boolean",
+          "default": "true",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "name",
+          "attribute": "name",
+          "description": "Form field name.",
+          "type": "String",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "required",
+          "attribute": "required",
+          "description": "Whether the field is required.",
+          "type": "Boolean",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "startDate",
+          "attribute": null,
+          "description": "Start date value.",
+          "type": "Date|null",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "value",
+          "attribute": "value",
+          "description": "Serialized range value as ISO interval: `YYYY-MM-DD/YYYY-MM-DD`.",
+          "type": "String",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        }
+      ],
+      "methods": [
+        {
+          "name": "addMonths",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            },
+            {
+              "name": "monthDelta",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "applyDisabledState",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "applyRangeSelection",
+          "description": null,
+          "parameters": [
+            {
+              "name": "pickedDate",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "bindCalendar",
+          "description": null,
+          "parameters": [
+            {
+              "name": "calendar",
+              "type": null,
+              "description": null
+            },
+            {
+              "name": "side",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "bindEvents",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "buildRangeEventsForMonth",
+          "description": null,
+          "parameters": [
+            {
+              "name": "year",
+              "type": null,
+              "description": null
+            },
+            {
+              "name": "month",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "checkValidity",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "closePanel",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "dispatchRangeChange",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "enforceMinimumGap",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "ensureCalendarsReady",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "formAssociatedCallback",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "formatDisplayDate",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "formDisabledCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "disabled",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "formResetCallback",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "formStateRestoreCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "state",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "handleOutsideClick",
+          "description": null,
+          "parameters": [
+            {
+              "name": "event",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "isOpen",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "isRangeComplete",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "openPanel",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "parseDate",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "parseRangeValue",
+          "description": null,
+          "parameters": [
+            {
+              "name": "rawValue",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "positionCalendars",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "reflectValueAttribute",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "refreshHighlights",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "reportValidity",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "serializeDate",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "setCalendarDate",
+          "description": null,
+          "parameters": [
+            {
+              "name": "calendar",
+              "type": null,
+              "description": null
+            },
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "syncUI",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "toDayStart",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "togglePanel",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "toMonthStart",
+          "description": null,
+          "parameters": [
+            {
+              "name": "value",
+              "type": null,
+              "description": null
+            }
+          ],
+          "return": null
+        },
+        {
+          "name": "updateFormState",
+          "description": null,
+          "parameters": [],
+          "return": null
+        }
+      ],
+      "events": [
+        {
+          "name": "change",
+          "description": "Native-like change event fired alongside `range-change`.",
+          "type": "Event"
+        },
+        {
+          "name": "range-change",
+          "description": "Fired whenever range selection changes.",
+          "type": "CustomEvent"
+        }
+      ],
+      "slots": [],
+      "cssParts": [
+        {
+          "name": "trigger",
+          "description": "The button used to open/close the date range panel."
+        },
+        {
+          "name": "panel",
+          "description": "The dropdown panel containing calendars and actions."
+        }
+      ],
+      "notes": []
+    },
+    "pds-drawer": {
+      "tag": "pds-drawer",
+      "className": "PdsDrawer",
+      "displayName": "pds-drawer",
+      "storyTitle": "Components/pds-drawer",
+      "category": "Components",
+      "description": null,
+      "docsDescription": "Slide-out panels from any edge",
+      "pdsTags": [
+        "autodocs",
+        "drawer",
+        "grouping",
+        "interaction",
+        "layout",
+        "modal",
+        "navigation",
+        "overlay",
+        "panel",
+        "pds-drawer",
+        "sidebar"
+      ],
+      "ontology": {
+        "id": "pds-drawer",
+        "name": "Drawer",
+        "description": "Slide-out panel overlay",
+        "selectors": [
+          "pds-drawer"
+        ],
+        "tags": [
+          "panel",
+          "overlay",
+          "sidebar"
+        ],
+        "category": "overlay"
+      },
+      "stories": [
+        {
+          "exportName": "Default",
+          "name": "Default",
+          "id": "components-pds-drawer--default",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsDrawer.stories.js"
+        }
+      ],
+      "sourceModule": "public/assets/pds/components/pds-drawer.js",
+      "superclass": "HTMLElement",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Controls whether the drawer is open or closed",
+          "type": "boolean",
+          "default": null,
+          "fieldName": "open",
+          "property": "open"
+        },
+        {
+          "name": "position",
+          "description": "Position of the drawer relative to the viewport",
+          "type": "\"bottom\" | \"top\" | \"left\" | \"right\"",
+          "default": "\"bottom\"",
+          "fieldName": "position",
+          "property": "position"
+        },
+        {
+          "name": "drag",
+          "description": "Controls drag interaction behavior",
+          "type": "\"header\" | \"none\"",
+          "default": "\"header\"",
+          "fieldName": "drag",
+          "property": "drag"
+        },
+        {
+          "name": "max-height",
+          "description": "Maximum height for top/bottom positioned drawers (CSS value)",
+          "type": "string",
+          "default": "\"70vh\"",
+          "fieldName": "maxHeight",
+          "property": "maxHeight"
+        },
+        {
+          "name": "min-height",
+          "description": "Minimum height for top/bottom positioned drawers (CSS value)",
+          "type": "string",
+          "default": "\"auto\"",
+          "fieldName": "minHeight",
+          "property": "minHeight"
+        },
+        {
+          "name": "show-close",
+          "description": "Whether to show the close button in the header",
+          "type": "boolean",
+          "default": "false",
+          "fieldName": "showClose",
+          "property": "showClose"
+        }
+      ],
+      "properties": [
+        {
+          "name": "drag",
+          "attribute": "drag",
+          "description": "Controls drag interaction behavior",
+          "type": "\"header\" | \"none\"",
+          "default": "\"header\"",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "maxHeight",
+          "attribute": "max-height",
+          "description": "Maximum height for top/bottom positioned drawers (CSS value)",
+          "type": "string",
+          "default": "\"70vh\"",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "minHeight",
+          "attribute": "min-height",
+          "description": "Minimum height for top/bottom positioned drawers (CSS value)",
+          "type": "string",
+          "default": "\"auto\"",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "open",
+          "attribute": "open",
+          "description": "Controls whether the drawer is open or closed",
+          "type": "boolean",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "position",
+          "attribute": "position",
+          "description": "Position of the drawer relative to the viewport",
+          "type": "\"bottom\" | \"top\" | \"left\" | \"right\"",
+          "default": "\"bottom\"",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "showClose",
+          "attribute": "show-close",
+          "description": "Whether to show the close button in the header",
+          "type": "boolean",
+          "default": "false",
+          "reflects": false,
+          "privacy": "public"
+        }
+      ],
+      "methods": [
+        {
+          "name": "clearContent",
+          "description": "Clear drawer content (removes all slotted content)",
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "closeDrawer",
+          "description": "Closes the drawer",
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "openDrawer",
+          "description": "Opens the drawer",
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "setContent",
+          "description": "Set the content of the drawer",
+          "parameters": [
+            {
+              "name": "bodyContent",
+              "type": "any|HTMLElement|string",
+              "description": "Content for the drawer body"
+            },
+            {
+              "name": "headerContent",
+              "type": "any|HTMLElement|string",
+              "description": "Optional header content"
+            }
+          ],
+          "return": "Promise<void>"
+        },
+        {
+          "name": "show",
+          "description": "Configure and open the drawer in one call",
+          "parameters": [
+            {
+              "name": "htmlContent",
+              "type": "any|HTMLElement|string",
+              "description": "The main content to display"
+            },
+            {
+              "name": "options",
+              "type": "@param {any|HTMLElement|string} [options.header] - Header content\n   * @param {\"bottom\"|\"top\"|\"left\"|\"right\"} [options.position] - Drawer position\n   * @param {string} [options.maxHeight] - Maximum height (CSS value)\n   * @param {string} [options.minHeight] - Minimum height (CSS value)\n   * @param {boolean} [options.showClose] - Show close button\n   * @param {boolean} [options.waitForMedia=true] - Wait for images/videos to load\n   * @param {number} [options.mediaTimeout=500] - Media load timeout in ms\n   * ",
+              "description": "Configuration options"
+            }
+          ],
+          "return": "Promise<this>"
+        },
+        {
+          "name": "toggleDrawer",
+          "description": "Toggles the drawer open/closed state",
+          "parameters": [],
+          "return": null
+        }
+      ],
+      "events": [
+        {
+          "name": "toggle",
+          "description": "Fired when the drawer opens or closes",
+          "type": null
+        }
+      ],
+      "slots": [
+        {
+          "name": "drawer-header",
+          "description": "Header content for the drawer"
+        },
+        {
+          "name": "drawer-content",
+          "description": "Main content of the drawer"
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "backdrop",
+          "description": "The semi-transparent backdrop overlay"
+        },
+        {
+          "name": "panel",
+          "description": "The drawer panel container"
+        },
+        {
+          "name": "header",
+          "description": "The drawer header section"
+        },
+        {
+          "name": "close-button",
+          "description": "The close button"
+        },
+        {
+          "name": "grab-handle",
+          "description": "The drag handle indicator"
+        },
+        {
+          "name": "content",
+          "description": "The drawer content section"
+        }
+      ],
+      "notes": []
+    },
     "pds-fab": {
       "tag": "pds-fab",
       "className": "PdsFab",
       "displayName": "pds-fab",
       "storyTitle": "Components/pds-fab",
       "category": "Components",
-      "description": "Floating Action Button (FAB) with expandable satellite actions\n\nFloating Action Button (FAB) with expandable satellite actions",
-      "docsDescription": "Floating Action Button (FAB) with expandable satellite actions. Perfect for quick access to common actions from anywhere in your app.\n\n### Key Features\n- 📍 **Fixed Positioning** - Always accessible from bottom-right corner\n- 🎯 **Smart Layout** - Automatically calculates optimal satellite positions (2-6 satellites)\n- ⚡ **Smooth Animations** - Spring-based animations with cascade timing\n- ♿ **Accessible** - Full keyboard navigation and ARIA support\n- 🎨 **Customizable** - CSS custom properties for complete theming\n\n### When to Use\n- Mobile-first applications requiring quick actions\n- Dashboard interfaces with frequent actions\n- Content creation tools (compose, upload, share)\n- Multi-step workflows with common entry points\n\n### Best Practices\n- Limit to 2-6 satellite actions (component enforces max 6)\n- Use clear, recognizable icons for satellites\n- Keep labels concise and actionable\n- Consider user",
+      "description": "Floating Action Button (FAB) with expandable satellite actions\n\nFloating Action Button (FAB) with expandable satellite actions",
+      "docsDescription": "Floating Action Button (FAB) with expandable satellite actions. Perfect for quick access to common actions from anywhere in your app.\n\n### Key Features\n- 📍 **Fixed Positioning** - Always accessible from bottom-right corner\n- 🎯 **Smart Layout** - Automatically calculates optimal satellite positions (2-6 satellites)\n- ⚡ **Smooth Animations** - Spring-based animations with cascade timing\n- ♿ **Accessible** - Full keyboard navigation and ARIA support\n- 🎨 **Customizable** - CSS custom properties for complete theming\n\n### When to Use\n- Mobile-first applications requiring quick actions\n- Dashboard interfaces with frequent actions\n- Content creation tools (compose, upload, share)\n- Multi-step workflows with common entry points\n\n### Best Practices\n- Limit to 2-6 satellite actions (component enforces max 6)\n- Use clear, recognizable icons for satellites\n- Keep labels concise and actionable\n- Consider user",
+      "pdsTags": [
+        "action",
+        "actions",
+        "autodocs",
+        "button",
+        "fab",
+        "floating",
+        "floating-action-button",
+        "interaction",
+        "menu",
+        "mobile",
+        "pds-fab"
+      ],
+      "ontology": {
+        "id": "pds-fab",
+        "name": "FAB",
+        "description": "Floating Action Button with expandable satellite actions",
+        "selectors": [
+          "pds-fab"
+        ],
+        "tags": [
+          "button",
+          "action",
+          "floating",
+          "interactive"
+        ],
+        "category": "action"
+      },
+      "stories": [],
+      "sourceModule": "public/assets/pds/components/pds-fab.js",
+      "superclass": "HTMLElement",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Controls whether the FAB is expanded",
+          "type": "boolean",
+          "default": null,
+          "fieldName": "open",
+          "property": "open"
+        },
+        {
+          "name": "radius",
+          "description": "Distance in pixels from the main FAB to satellites",
+          "type": "number",
+          "default": "100",
+          "fieldName": "radius",
+          "property": "radius"
+        },
+        {
+          "name": "spread",
+          "description": "Arc angle in degrees for satellite distribution",
+          "type": "number",
+          "default": "90",
+          "fieldName": "spread",
+          "property": "spread"
+        },
+        {
+          "name": "start-angle",
+          "description": "Starting angle in degrees (0=right, 90=down, 180=left, 270=up)\r\nIf not specified, the angle is auto-detected based on the FAB's corner position:\r\n- Bottom-right: 180° (fly left/up)\r\n- Bottom-left: 315° (fly right/up)\r\n- Top-right: 225° (fly left/down)\r\n- Top-left: 45° (fly right/down)",
+          "type": "number",
+          "default": "180 (or auto-detected)",
+          "fieldName": "startAngle",
+          "property": "startAngle"
+        }
+      ],
+      "properties": [
+        {
+          "name": "open",
+          "attribute": "open",
+          "description": "Controls whether the FAB is expanded",
+          "type": "boolean",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "radius",
+          "attribute": "radius",
+          "description": "Distance in pixels from the main FAB to satellites",
+          "type": "number",
+          "default": "100",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "satellites",
+          "attribute": null,
+          "description": "Array of satellite button configurations",
+          "type": "Array<{key: string, icon?: string, label?: string, action?: string}>",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "spread",
+          "attribute": "spread",
+          "description": "Arc angle in degrees for satellite distribution",
+          "type": "number",
+          "default": "90",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "startAngle",
+          "attribute": "start-angle",
+          "description": "Starting angle in degrees (0=right, 90=down, 180=left, 270=up)\r\nIf not specified, the angle is auto-detected based on the FAB's corner position:\r\n- Bottom-right: 180° (fly left/up)\r\n- Bottom-left: 315° (fly right/up)\r\n- Top-right: 225° (fly left/down)\r\n- Top-left: 45° (fly right/down)",
+          "type": "number",
+          "default": "180 (or auto-detected)",
+          "reflects": false,
+          "privacy": "public"
+        }
+      ],
+      "methods": [
+        {
+          "name": "attributeChangedCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "name",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "oldVal",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "newVal",
+              "type": "any",
+              "description": null,
+              "optional": false
+            }
+          ],
+          "return": "void"
+        },
+        {
+          "name": "connectedCallback",
+          "description": null,
+          "parameters": [],
+          "return": "void"
+        },
+        {
+          "name": "disconnectedCallback",
+          "description": null,
+          "parameters": [],
+          "return": "void"
+        }
+      ],
+      "events": [
+        {
+          "name": "satellite-click",
+          "description": "Fired when a satellite button is clicked",
+          "type": "CustomEvent"
+        }
+      ],
+      "slots": [
+        {
+          "name": "",
+          "description": "Main FAB button content (typically an icon or avatar)"
+        },
+        {
+          "name": "satellite-{key}",
+          "description": "Override individual satellite button content"
+        }
+      ],
+      "cssParts": [
+        {
+          "name": "fab",
+          "description": "The main FAB button"
+        },
+        {
+          "name": "satellite",
+          "description": "Individual satellite buttons"
+        },
+        {
+          "name": "label",
+          "description": "Satellite button labels"
+        }
+      ],
+      "notes": []
+    },
+    "pds-form": {
+      "tag": "pds-form",
+      "className": "SchemaForm",
+      "displayName": "PDS JSON Schema Form",
+      "storyTitle": "Components/pds-form",
+      "category": "Components",
+      "description": "<pds-form>\n\nForm Actions:\nBy default, the form includes Submit and Reset buttons inside the <form> element.\n\nUsage options:\n1. Default buttons:\n   <pds-form .jsonSchema=${schema}></pds-form>\n\n2. Customize labels:\n   <pds-form .jsonSchema=${schema} submit-label=\"Save\" reset-label=\"Clear\"></pds-form>\n\n3. Hide reset button:\n   <pds-form .jsonSchema=${schema} hide-reset></pds-form>\n\n4. Add extra buttons (slot):\n   <pds-form .jsonSchema=${schema}>\n     <button type=\"button\" slot=\"actions\"\n\n<pds-form>\n\nForm Actions:\nBy default, the form includes Submit and Reset buttons inside the <form> element.\n\nUsage options:\n1. Default buttons:\n   <pds-form .jsonSchema=${schema}></pds-form>\n\n2. Customize labels:\n   <pds-form .jsonSchema=${schema} submit-label=\"Save\" reset-label=\"Clear\"></pds-form>\n\n3. Hide reset button:\n   <pds-form .jsonSchema=${schema} hide-reset></pds-form>\n\n4. Add extra buttons (slot):\n   <pds-form .jsonSchema=${schema}>\n     <button type=\"button\" slot=\"actions\"",
+      "docsDescription": "**✨ Recommended for modern applications** - Automatically generate complete forms from [JSON Schema](https://json-schema.org/) definitions.\n\n### Key Features\n- 📝 **Zero boilerplate** - Define form structure in JSON, get a working form with validation\n- ✓ **Built-in validation** - Automatic validation based on schema rules (required, min/max, patterns, etc.)\n- 🔄 **Data binding** - Two-way data binding with form state management\n- 🎨 **PDS styled** - Uses all PDS design tokens automatically\n- 📱 **Responsive** - Mobile-friendly layouts out of the box\n- 🔀 **Conditional logic** - Show/hide/disable fields, computed values\n- 🗂️ **Nested objects** - Support for complex nested data structures\n- 🔧 **Extensible** - Custom field types and validators\n\n### Why Generate Forms from JSON Schema?\nInstead of manually writing HTML for every form field, validation rule, and error message, you define your data schema once and get:\n- Form UI generation\n- Client-side validation\n- Server-side validation (same schema)\n- API documentation\n- Type definitions\n- Database schemas\n\nSee the examples below to get started, or check the [primitive forms](/story/primitives-form-elements--default) for manual form building.",
       "pdsTags": [
-        "action",
-        "actions",
         "autodocs",
-        "button",
-        "fab",
-        "floating",
-        "floating-action-button",
+        "forms",
+        "input",
         "interaction",
-        "menu",
-        "mobile",
-        "pds-fab"
+        "json-schema",
+        "pds-form",
+        "validation"
       ],
       "ontology": {
-        "id": "pds-fab",
-        "name": "FAB",
-        "description": "Floating Action Button with expandable satellite actions",
+        "id": "pds-form",
+        "name": "JSON Form",
+        "description": "Auto-generated form from JSON Schema",
         "selectors": [
-          "pds-fab"
+          "pds-form"
         ],
         "tags": [
-          "button",
-          "action",
-          "floating",
-          "interactive"
+          "form",
+          "schema",
+          "auto-generate"
         ],
-        "category": "action"
+        "category": "form"
       },
       "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-fab.js",
-      "superclass": "HTMLElement",
+      "sourceModule": "public/assets/pds/components/pds-form.js",
+      "superclass": "LitElement",
       "attributes": [
         {
-          "name": "open",
-          "description": "Controls whether the FAB is expanded",
+          "name": "json-schema",
+          "description": "Primary schema input. Provide a JSON Schema object to generate the form layout and validation rules.",
+          "type": "object",
+          "default": "undefined",
+          "fieldName": "jsonSchema",
+          "property": "jsonSchema"
+        },
+        {
+          "name": "ui-schema",
+          "description": "Optional UI overrides keyed by JSON Pointer. Controls layout, widgets, surfaces, dialogs, and per-field hints.",
+          "type": "object",
+          "default": "undefined",
+          "fieldName": "uiSchema",
+          "property": "uiSchema"
+        },
+        {
+          "name": "options",
+          "description": "Toolkit-level options that adjust widget families, layouts, and validation behavior. Supports path-specific overrides.",
+          "type": "object",
+          "default": "undefined",
+          "fieldName": "options",
+          "property": "options"
+        },
+        {
+          "name": "values",
+          "description": "Initial data that pre-populates the generated form. Shape must match the JSON Schema.",
+          "type": "object",
+          "default": "undefined",
+          "fieldName": "values",
+          "property": "values"
+        },
+        {
+          "name": "action",
+          "description": null,
+          "type": "string",
+          "default": null,
+          "fieldName": "action",
+          "property": "action"
+        },
+        {
+          "name": "method",
+          "description": null,
+          "type": "string",
+          "default": "\"post\"",
+          "fieldName": "method",
+          "property": "method"
+        },
+        {
+          "name": "disabled",
+          "description": null,
+          "type": "boolean",
+          "default": null,
+          "fieldName": "disabled",
+          "property": "disabled"
+        },
+        {
+          "name": "hide-actions",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "fieldName": "hideActions",
+          "property": "hideActions"
+        },
+        {
+          "name": "submit-label",
+          "description": null,
+          "type": "string",
+          "default": "\"Submit\"",
+          "fieldName": "submitLabel",
+          "property": "submitLabel"
+        },
+        {
+          "name": "reset-label",
+          "description": null,
+          "type": "string",
+          "default": "\"Reset\"",
+          "fieldName": "resetLabel",
+          "property": "resetLabel"
+        },
+        {
+          "name": "hide-reset",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "fieldName": "hideReset",
+          "property": "hideReset"
+        },
+        {
+          "name": "hide-submit",
+          "description": null,
+          "type": "boolean",
+          "default": null,
+          "fieldName": "hideSubmit",
+          "property": "hideSubmit"
+        },
+        {
+          "name": "hide-legend",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "fieldName": "hideLegend",
+          "property": "hideLegend"
+        }
+      ],
+      "properties": [
+        {
+          "name": "action",
+          "attribute": "action",
+          "description": null,
+          "type": "string",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "disabled",
+          "attribute": "disabled",
+          "description": null,
+          "type": "boolean",
+          "default": null,
+          "reflects": true,
+          "privacy": "public"
+        },
+        {
+          "name": "hideActions",
+          "attribute": "hide-actions",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "hideLegend",
+          "attribute": "hide-legend",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "hideReset",
+          "attribute": "hide-reset",
+          "description": null,
+          "type": "boolean",
+          "default": "false",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "hideSubmit",
+          "attribute": "hide-submit",
+          "description": null,
           "type": "boolean",
           "default": null,
-          "fieldName": "open",
-          "property": "open"
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "radius",
-          "description": "Distance in pixels from the main FAB to satellites",
-          "type": "number",
-          "default": "100",
-          "fieldName": "radius",
-          "property": "radius"
+          "name": "jsonSchema",
+          "attribute": "json-schema",
+          "description": "Primary schema input. Provide a JSON Schema object to generate the form layout and validation rules.",
+          "type": "JSONSchema7 (object)",
+          "default": "undefined",
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "spread",
-          "description": "Arc angle in degrees for satellite distribution",
-          "type": "number",
-          "default": "90",
-          "fieldName": "spread",
-          "property": "spread"
+          "name": "method",
+          "attribute": "method",
+          "description": null,
+          "type": "string",
+          "default": "\"post\"",
+          "reflects": false,
+          "privacy": "public"
         },
         {
-          "name": "start-angle",
-          "description": "Starting angle in degrees (0=right, 90=down, 180=left, 270=up)\r\nIf not specified, the angle is auto-detected based on the FAB's corner position:\r\n- Bottom-right: 180° (fly left/up)\r\n- Bottom-left: 315° (fly right/up)\r\n- Top-right: 225° (fly left/down)\r\n- Top-left: 45° (fly right/down)",
-          "type": "number",
-          "default": "180 (or auto-detected)",
-          "fieldName": "startAngle",
-          "property": "startAngle"
-        }
-      ],
-      "properties": [
+          "name": "options",
+          "attribute": "options",
+          "description": "Toolkit-level options that adjust widget families, layouts, and validation behavior. Supports path-specific overrides.",
+          "type": "formOptions",
+          "default": "undefined",
+          "reflects": false,
+          "privacy": "public"
+        },
         {
-          "name": "open",
-          "attribute": "open",
-          "description": "Controls whether the FAB is expanded",
-          "type": "boolean",
+          "name": "properties",
+          "attribute": null,
+          "description": null,
+          "type": "{\n        jsonSchema: {\n            type: ObjectConstructor;\n            attribute: string;\n        };\n        uiSchema: {\n            type: ObjectConstructor;\n            attribute: string;\n        };\n        options: {\n            type: ObjectConstructor;\n        };\n        values: {\n            type: ObjectConstructor;\n        };\n        action: {\n            type: StringConstructor;\n        };\n        method: {\n            type: StringConstructor;\n        };\n        disabled: {\n            type: BooleanConstructor;\n            reflect: boolean;\n        };\n        hideActions: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        submitLabel: {\n            type: StringConstructor;\n            attribute: string;\n        };\n        resetLabel: {\n            type: StringConstructor;\n            attribute: string;\n        };\n        hideReset: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        hideSubmit: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        hideLegend: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n    }",
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "radius",
-          "attribute": "radius",
-          "description": "Distance in pixels from the main FAB to satellites",
-          "type": "number",
-          "default": "100",
+          "name": "resetLabel",
+          "attribute": "reset-label",
+          "description": null,
+          "type": "string",
+          "default": "\"Reset\"",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "satellites",
-          "attribute": null,
-          "description": "Array of satellite button configurations",
-          "type": "Array<{key: string, icon?: string, label?: string, action?: string}>",
-          "default": null,
+          "name": "submitLabel",
+          "attribute": "submit-label",
+          "description": null,
+          "type": "string",
+          "default": "\"Submit\"",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "spread",
-          "attribute": "spread",
-          "description": "Arc angle in degrees for satellite distribution",
-          "type": "number",
-          "default": "90",
+          "name": "uiSchema",
+          "attribute": "ui-schema",
+          "description": "Optional UI overrides keyed by JSON Pointer. Controls layout, widgets, surfaces, dialogs, and per-field hints.",
+          "type": "UISchema",
+          "default": "undefined",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "startAngle",
-          "attribute": "start-angle",
-          "description": "Starting angle in degrees (0=right, 90=down, 180=left, 270=up)\r\nIf not specified, the angle is auto-detected based on the FAB's corner position:\r\n- Bottom-right: 180° (fly left/up)\r\n- Bottom-left: 315° (fly right/up)\r\n- Top-right: 225° (fly left/down)\r\n- Top-left: 45° (fly right/down)",
-          "type": "number",
-          "default": "180 (or auto-detected)",
+          "name": "values",
+          "attribute": "values",
+          "description": "Initial data that pre-populates the generated form. Shape must match the JSON Schema.",
+          "type": "Record<string, any>",
+          "default": "undefined",
           "reflects": false,
           "privacy": "public"
         }
       ],
       "methods": [
         {
-          "name": "attributeChangedCallback",
+          "name": "connectedCallback",
+          "description": null,
+          "parameters": [],
+          "return": "void"
+        },
+        {
+          "name": "createRenderRoot",
+          "description": null,
+          "parameters": [],
+          "return": "this"
+        },
+        {
+          "name": "defineRenderer",
           "description": null,
           "parameters": [
             {
-              "name": "name",
-              "type": "any",
-              "description": null,
-              "optional": false
-            },
-            {
-              "name": "oldVal",
+              "name": "widgetKey",
               "type": "any",
               "description": null,
               "optional": false
             },
             {
-              "name": "newVal",
+              "name": "fn",
               "type": "any",
               "description": null,
               "optional": false
@@ -570,320 +1659,354 @@
           "return": "void"
         },
         {
-          "name": "connectedCallback",
+          "name": "getValuesFlat",
+          "description": null,
+          "parameters": [],
+          "return": "{}"
+        },
+        {
+          "name": "render",
+          "description": null,
+          "parameters": [],
+          "return": "any"
+        },
+        {
+          "name": "reset",
           "description": null,
           "parameters": [],
           "return": "void"
         },
         {
-          "name": "disconnectedCallback",
+          "name": "serialize",
+          "description": null,
+          "parameters": [],
+          "return": "{\n        json: {};\n        formData: FormData;\n    }"
+        },
+        {
+          "name": "submit",
           "description": null,
           "parameters": [],
+          "return": "Promise<any>"
+        },
+        {
+          "name": "useValidator",
+          "description": null,
+          "parameters": [
+            {
+              "name": "fn",
+              "type": "any",
+              "description": null,
+              "optional": false
+            }
+          ],
+          "return": "void"
+        },
+        {
+          "name": "willUpdate",
+          "description": null,
+          "parameters": [
+            {
+              "name": "changed",
+              "type": "any",
+              "description": null,
+              "optional": false
+            }
+          ],
           "return": "void"
         }
       ],
       "events": [
         {
-          "name": "satellite-click",
-          "description": "Fired when a satellite button is clicked",
-          "type": "CustomEvent"
-        }
-      ],
-      "slots": [
+          "name": "pw:array-add",
+          "type": "CustomEvent<formArrayEventDetail>",
+          "description": "Triggered when an array item is appended. Carries the path and index metadata."
+        },
         {
-          "name": "",
-          "description": "Main FAB button content (typically an icon or avatar)"
+          "name": "pw:array-remove",
+          "type": "CustomEvent<formArrayEventDetail>",
+          "description": "Triggered when an array item is removed."
         },
         {
-          "name": "satellite-{key}",
-          "description": "Override individual satellite button content"
-        }
-      ],
-      "cssParts": [
+          "name": "pw:array-reorder",
+          "type": "CustomEvent<formArrayEventDetail>",
+          "description": "Triggered when array items are reordered (drag & drop scenarios)."
+        },
         {
-          "name": "fab",
-          "description": "The main FAB button"
+          "name": "pw:dialog-open",
+          "type": "CustomEvent<formDialogEventDetail>",
+          "description": "Fires before a dialog-driven field opens (e.g. complex editors)."
         },
         {
-          "name": "satellite",
-          "description": "Individual satellite buttons"
+          "name": "pw:dialog-submit",
+          "type": "CustomEvent<formDialogEventDetail>",
+          "description": "Fires when a dialog-driven field is saved."
         },
         {
-          "name": "label",
-          "description": "Satellite button labels"
+          "name": "pw:submit",
+          "type": "CustomEvent<formSubmitDetail>",
+          "description": "Emitted after submission. `detail` includes `{ json, formData, valid, issues }` for server hand-off or additional processing."
+        },
+        {
+          "name": "pw:value-change",
+          "type": "CustomEvent<formValueChangeDetail>",
+          "description": "Live value updates whenever a field changes. `detail.name` contains the JSON Pointer-compatible path."
         }
       ],
-      "notes": []
+      "slots": [],
+      "cssParts": [],
+      "notes": [
+        "Typed interfaces for `formOptions`, `UISchema`, and related events live in `src/js/pds.d.ts`.",
+        "The form accepts standard JSON Schema (Draft 7) documents via the `jsonSchema` property. `uiSchema` and `options` fine-tune layout, widgets, and behaviors."
+      ]
     },
-    "pds-form": {
-      "tag": "pds-form",
-      "className": "SchemaForm",
-      "displayName": "PDS JSON Schema Form",
-      "storyTitle": "Components/pds-form",
+    "pds-icon": {
+      "tag": "pds-icon",
+      "className": "SvgIcon",
+      "displayName": "pds-icon",
+      "storyTitle": "Components/pds-icon",
       "category": "Components",
-      "description": "<pds-form>\n\nForm Actions:\nBy default, the form includes Submit and Reset buttons inside the <form> element.\n\nUsage options:\n1. Default buttons:\n   <pds-form .jsonSchema=${schema}></pds-form>\n\n2. Customize labels:\n   <pds-form .jsonSchema=${schema} submit-label=\"Save\" reset-label=\"Clear\"></pds-form>\n\n3. Hide reset button:\n   <pds-form .jsonSchema=${schema} hide-reset></pds-form>\n\n4. Add extra buttons (slot):\n   <pds-form .jsonSchema=${schema}>\n     <button type=\"button\" slot=\"actions\"\n\n<pds-form>\n\nForm Actions:\nBy default, the form includes Submit and Reset buttons inside the <form> element.\n\nUsage options:\n1. Default buttons:\n   <pds-form .jsonSchema=${schema}></pds-form>\n\n2. Customize labels:\n   <pds-form .jsonSchema=${schema} submit-label=\"Save\" reset-label=\"Clear\"></pds-form>\n\n3. Hide reset button:\n   <pds-form .jsonSchema=${schema} hide-reset></pds-form>\n\n4. Add extra buttons (slot):\n   <pds-form .jsonSchema=${schema}>\n     <button type=\"button\" slot=\"actions\"",
-      "docsDescription": "**✨ Recommended for modern applications** - Automatically generate complete forms from [JSON Schema](https://json-schema.org/) definitions.\n\n### Key Features\n- 📝 **Zero boilerplate** - Define form structure in JSON, get a working form with validation\n- ✓ **Built-in validation** - Automatic validation based on schema rules (required, min/max, patterns, etc.)\n- 🔄 **Data binding** - Two-way data binding with form state management\n- 🎨 **PDS styled** - Uses all PDS design tokens automatically\n- 📱 **Responsive** - Mobile-friendly layouts out of the box\n- 🔀 **Conditional logic** - Show/hide/disable fields, computed values\n- 🗂️ **Nested objects** - Support for complex nested data structures\n- 🔧 **Extensible** - Custom field types and validators\n\n### Why Generate Forms from JSON Schema?\nInstead of manually writing HTML for every form field, validation rule, and error message, you define your data schema once and get:\n- Form UI generation\n- Client-side validation\n- Server-side validation (same schema)\n- API documentation\n- Type definitions\n- Database schemas\n\nSee the examples below to get started, or check the [primitive forms](/story/primitives-form-elements--default) for manual form building.",
+      "description": "SVG Icon Web Component\n\nSVG Icon Web Component",
+      "docsDescription": null,
       "pdsTags": [
         "autodocs",
-        "forms",
-        "input",
-        "interaction",
-        "json-schema",
-        "pds-form",
-        "validation"
+        "graphic",
+        "icon",
+        "icons",
+        "pds-icon",
+        "phosphor",
+        "sprite",
+        "svg",
+        "symbol"
       ],
       "ontology": {
-        "id": "pds-form",
-        "name": "JSON Form",
-        "description": "Auto-generated form from JSON Schema",
+        "id": "pds-icon",
+        "name": "Icon",
+        "description": "SVG icon web component",
         "selectors": [
-          "pds-form"
+          "pds-icon"
         ],
         "tags": [
-          "form",
-          "schema",
-          "auto-generate"
+          "icon",
+          "graphic",
+          "svg"
         ],
-        "category": "form"
+        "category": "media"
       },
       "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-form.js",
-      "superclass": "LitElement",
+      "sourceModule": "public/assets/pds/components/pds-icon.js",
+      "superclass": "HTMLElement",
       "attributes": [
         {
-          "name": "json-schema",
-          "description": "Primary schema input. Provide a JSON Schema object to generate the form layout and validation rules.",
-          "type": "object",
-          "default": "undefined",
-          "fieldName": "jsonSchema",
-          "property": "jsonSchema"
-        },
-        {
-          "name": "ui-schema",
-          "description": "Optional UI overrides keyed by JSON Pointer. Controls layout, widgets, surfaces, dialogs, and per-field hints.",
-          "type": "object",
-          "default": "undefined",
-          "fieldName": "uiSchema",
-          "property": "uiSchema"
-        },
-        {
-          "name": "options",
-          "description": "Toolkit-level options that adjust widget families, layouts, and validation behavior. Supports path-specific overrides.",
-          "type": "object",
-          "default": "undefined",
-          "fieldName": "options",
-          "property": "options"
+          "name": "icon",
+          "description": "Icon name from the sprite sheet",
+          "type": "string",
+          "default": null,
+          "fieldName": null
         },
         {
-          "name": "values",
-          "description": "Initial data that pre-populates the generated form. Shape must match the JSON Schema.",
-          "type": "object",
-          "default": "undefined",
-          "fieldName": "values",
-          "property": "values"
+          "name": "size",
+          "description": "Icon size in pixels or named size (xs, sm, md, lg, xl, 2xl)",
+          "type": "string|number",
+          "default": null,
+          "fieldName": null
         },
         {
-          "name": "action",
-          "description": null,
+          "name": "color",
+          "description": "Icon color (CSS color value, default: currentColor)",
           "type": "string",
           "default": null,
-          "fieldName": "action",
-          "property": "action"
+          "fieldName": null
         },
         {
-          "name": "method",
-          "description": null,
+          "name": "label",
+          "description": "Accessible label for the icon (adds role=\"img\")",
           "type": "string",
-          "default": "\"post\"",
-          "fieldName": "method",
-          "property": "method"
+          "default": null,
+          "fieldName": null
         },
         {
-          "name": "disabled",
-          "description": null,
-          "type": "boolean",
+          "name": "rotate",
+          "description": "Rotation angle in degrees",
+          "type": "number",
           "default": null,
-          "fieldName": "disabled",
-          "property": "disabled"
+          "fieldName": null
         },
         {
-          "name": "hide-actions",
-          "description": null,
+          "name": "morph",
+          "description": "Morph the icon when the icon name changes",
           "type": "boolean",
-          "default": "false",
-          "fieldName": "hideActions",
-          "property": "hideActions"
-        },
-        {
-          "name": "submit-label",
-          "description": null,
-          "type": "string",
-          "default": "\"Submit\"",
-          "fieldName": "submitLabel",
-          "property": "submitLabel"
+          "default": null,
+          "fieldName": null
         },
         {
-          "name": "reset-label",
-          "description": null,
+          "name": "sprite",
+          "description": "Override sprite sheet path",
           "type": "string",
-          "default": "\"Reset\"",
-          "fieldName": "resetLabel",
-          "property": "resetLabel"
-        },
-        {
-          "name": "hide-reset",
-          "description": null,
-          "type": "boolean",
-          "default": "false",
-          "fieldName": "hideReset",
-          "property": "hideReset"
-        },
-        {
-          "name": "hide-submit",
-          "description": null,
-          "type": "boolean",
           "default": null,
-          "fieldName": "hideSubmit",
-          "property": "hideSubmit"
+          "fieldName": null
         },
         {
-          "name": "hide-legend",
-          "description": null,
+          "name": "no-sprite",
+          "description": "Force fallback icon rendering",
           "type": "boolean",
-          "default": "false",
-          "fieldName": "hideLegend",
-          "property": "hideLegend"
+          "default": null,
+          "fieldName": null
         }
       ],
       "properties": [
         {
-          "name": "action",
-          "attribute": "action",
-          "description": null,
-          "type": "string",
+          "name": "ensureConfigListeners",
+          "attribute": null,
+          "description": "Ensures one-time config lifecycle listeners so icons re-render when config becomes available.",
+          "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "disabled",
-          "attribute": "disabled",
+          "name": "externalIconCache",
+          "attribute": null,
           "description": null,
-          "type": "boolean",
-          "default": null,
-          "reflects": true,
+          "type": "Map<any, any>",
+          "default": "new Map()",
+          "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "hideActions",
-          "attribute": "hide-actions",
+          "name": "externalIconPromises",
+          "attribute": null,
           "description": null,
-          "type": "boolean",
-          "default": "false",
+          "type": "Map<any, any>",
+          "default": "new Map()",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "hideLegend",
-          "attribute": "hide-legend",
+          "name": "externalPathDebugLogged",
+          "attribute": null,
           "description": null,
-          "type": "boolean",
-          "default": "false",
+          "type": "Set<any>",
+          "default": "new Set()",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "hideReset",
-          "attribute": "hide-reset",
-          "description": null,
-          "type": "boolean",
-          "default": "false",
+          "name": "getExternalIconCacheKey",
+          "attribute": null,
+          "description": "Build a deterministic cache key for external icon content.",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "hideSubmit",
-          "attribute": "hide-submit",
-          "description": null,
-          "type": "boolean",
+          "name": "getExternalIconPath",
+          "attribute": null,
+          "description": "Get the external icons path from PDS config or use default",
+          "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "jsonSchema",
-          "attribute": "json-schema",
-          "description": "Primary schema input. Provide a JSON Schema object to generate the form layout and validation rules.",
-          "type": "JSONSchema7 (object)",
-          "default": "undefined",
+          "name": "getExternalIconURL",
+          "attribute": null,
+          "description": "Resolve an external icon URL from icon name + base path.",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "method",
-          "attribute": "method",
-          "description": null,
-          "type": "string",
-          "default": "\"post\"",
+          "name": "hasConfiguredExternalIconPath",
+          "attribute": null,
+          "description": "Returns true when externalPath is explicitly present in runtime config.",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "options",
-          "attribute": "options",
-          "description": "Toolkit-level options that adjust widget families, layouts, and validation behavior. Supports path-specific overrides.",
-          "type": "formOptions",
-          "default": "undefined",
+          "name": "inlineSprites",
+          "attribute": null,
+          "description": null,
+          "type": "Map<any, any>",
+          "default": "new Map()",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "properties",
+          "name": "instances",
           "attribute": null,
           "description": null,
-          "type": "{\n        jsonSchema: {\n            type: ObjectConstructor;\n            attribute: string;\n        };\n        uiSchema: {\n            type: ObjectConstructor;\n            attribute: string;\n        };\n        options: {\n            type: ObjectConstructor;\n        };\n        values: {\n            type: ObjectConstructor;\n        };\n        action: {\n            type: StringConstructor;\n        };\n        method: {\n            type: StringConstructor;\n        };\n        disabled: {\n            type: BooleanConstructor;\n            reflect: boolean;\n        };\n        hideActions: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        submitLabel: {\n            type: StringConstructor;\n            attribute: string;\n        };\n        resetLabel: {\n            type: StringConstructor;\n            attribute: string;\n        };\n        hideReset: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        hideSubmit: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n        hideLegend: {\n            type: BooleanConstructor;\n            attribute: string;\n        };\n    }",
-          "default": null,
+          "type": "Set<any>",
+          "default": "new Set()",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "resetLabel",
-          "attribute": "reset-label",
-          "description": null,
-          "type": "string",
-          "default": "\"Reset\"",
+          "name": "isDebugLoggingEnabled",
+          "attribute": null,
+          "description": "Whether verbose icon diagnostics should be logged.",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "submitLabel",
-          "attribute": "submit-label",
-          "description": null,
-          "type": "string",
-          "default": "\"Submit\"",
+          "name": "normalizeExternalIconPath",
+          "attribute": null,
+          "description": "Normalize the external icon path to make cache keys and URL joining stable.",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "uiSchema",
-          "attribute": "ui-schema",
-          "description": "Optional UI overrides keyed by JSON Pointer. Controls layout, widgets, surfaces, dialogs, and per-field hints.",
-          "type": "UISchema",
-          "default": "undefined",
+          "name": "observedAttributes",
+          "attribute": null,
+          "description": null,
+          "type": "string[]",
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "values",
-          "attribute": "values",
-          "description": "Initial data that pre-populates the generated form. Shape must match the JSON Schema.",
-          "type": "Record<string, any>",
-          "default": "undefined",
+          "name": "spritePromises",
+          "attribute": null,
+          "description": null,
+          "type": "Map<any, any>",
+          "default": "new Map()",
           "reflects": false,
           "privacy": "public"
         }
       ],
       "methods": [
+        {
+          "name": "attributeChangedCallback",
+          "description": null,
+          "parameters": [
+            {
+              "name": "name",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "oldValue",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "newValue",
+              "type": "any",
+              "description": null,
+              "optional": false
+            }
+          ],
+          "return": "void"
+        },
         {
           "name": "connectedCallback",
           "description": null,
@@ -891,351 +2014,329 @@
           "return": "void"
         },
         {
-          "name": "createRenderRoot",
+          "name": "disconnectedCallback",
           "description": null,
           "parameters": [],
-          "return": "this"
+          "return": "void"
         },
         {
-          "name": "defineRenderer",
+          "name": "ensureInlineSprite",
           "description": null,
           "parameters": [
             {
-              "name": "widgetKey",
+              "name": "spriteURL",
               "type": "any",
               "description": null,
               "optional": false
+            }
+          ],
+          "return": "Promise<any>"
+        },
+        {
+          "name": "fetchExternalIcon",
+          "description": "Fetch an external SVG icon and cache it\n\nFetch an external SVG icon and cache it",
+          "parameters": [
+            {
+              "name": "iconName",
+              "type": "string",
+              "description": "The icon name (without .svg extension)",
+              "optional": false
             },
             {
-              "name": "fn",
+              "name": "basePath",
               "type": "any",
               "description": null,
               "optional": false
             }
           ],
-          "return": "void"
+          "return": "Promise<boolean>"
         },
         {
-          "name": "getValuesFlat",
+          "name": "notifyInstances",
           "description": null,
           "parameters": [],
-          "return": "{}"
+          "return": "void"
         },
         {
           "name": "render",
           "description": null,
           "parameters": [],
-          "return": "any"
+          "return": "void"
         },
         {
-          "name": "reset",
+          "name": "spriteAvailable",
+          "description": "Check if sprite sheet is available\n\nCheck if sprite sheet is available",
+          "parameters": [],
+          "return": "boolean"
+        }
+      ],
+      "events": [],
+      "slots": [],
+      "cssParts": [],
+      "notes": []
+    },
+    "component_tag": {
+      "tag": "component_tag",
+      "className": "PdsLiveTemplateCanvas",
+      "displayName": "Component_tag",
+      "storyTitle": null,
+      "category": null,
+      "description": null,
+      "docsDescription": null,
+      "pdsTags": [],
+      "ontology": null,
+      "stories": [],
+      "sourceModule": "public/assets/pds/components/pds-live-template-canvas.js",
+      "superclass": "HTMLElement",
+      "attributes": [],
+      "properties": [],
+      "methods": [],
+      "events": [
+        {
+          "name": "pds:live-template:inject",
+          "description": null,
+          "type": "CustomEvent"
+        }
+      ],
+      "slots": [],
+      "cssParts": [],
+      "notes": []
+    },
+    "editor_tag": {
+      "tag": "editor_tag",
+      "className": "PdsLiveEdit",
+      "displayName": "Editor_tag",
+      "storyTitle": null,
+      "category": null,
+      "description": null,
+      "docsDescription": null,
+      "pdsTags": [],
+      "ontology": null,
+      "stories": [],
+      "sourceModule": "public/assets/pds/components/pds-live-edit.js",
+      "superclass": "HTMLElement",
+      "attributes": [],
+      "properties": [],
+      "methods": [
+        {
+          "name": "createSharedQuickModeMenuItem",
           "description": null,
           "parameters": [],
-          "return": "void"
+          "return": null
         },
         {
-          "name": "serialize",
+          "name": "isInteractiveEditingEnabled",
           "description": null,
           "parameters": [],
-          "return": "{\n        json: {};\n        formData: FormData;\n    }"
+          "return": null
         },
         {
-          "name": "submit",
+          "name": "openDesignSettings",
           "description": null,
           "parameters": [],
-          "return": "Promise<any>"
+          "return": null
         },
         {
-          "name": "useValidator",
+          "name": "openImportDetailsFromToast",
           "description": null,
           "parameters": [
             {
-              "name": "fn",
-              "type": "any",
-              "description": null,
-              "optional": false
+              "name": "options",
+              "type": null,
+              "description": null
             }
           ],
-          "return": "void"
+          "return": null
         },
         {
-          "name": "willUpdate",
+          "name": "resetConfig",
+          "description": null,
+          "parameters": [],
+          "return": null
+        },
+        {
+          "name": "setInteractiveEditingEnabled",
           "description": null,
           "parameters": [
             {
-              "name": "changed",
-              "type": "any",
-              "description": null,
-              "optional": false
+              "name": "enabled",
+              "type": null,
+              "description": null
             }
           ],
-          "return": "void"
+          "return": null
         }
       ],
       "events": [
         {
-          "name": "pw:array-add",
-          "type": "CustomEvent<formArrayEventDetail>",
-          "description": "Triggered when an array item is appended. Carries the path and index metadata."
-        },
-        {
-          "name": "pw:array-remove",
-          "type": "CustomEvent<formArrayEventDetail>",
-          "description": "Triggered when an array item is removed."
-        },
-        {
-          "name": "pw:array-reorder",
-          "type": "CustomEvent<formArrayEventDetail>",
-          "description": "Triggered when array items are reordered (drag & drop scenarios)."
-        },
-        {
-          "name": "pw:dialog-open",
-          "type": "CustomEvent<formDialogEventDetail>",
-          "description": "Fires before a dialog-driven field opens (e.g. complex editors)."
-        },
-        {
-          "name": "pw:dialog-submit",
-          "type": "CustomEvent<formDialogEventDetail>",
-          "description": "Fires when a dialog-driven field is saved."
-        },
-        {
-          "name": "pw:submit",
-          "type": "CustomEvent<formSubmitDetail>",
-          "description": "Emitted after submission. `detail` includes `{ json, formData, valid, issues }` for server hand-off or additional processing."
-        },
-        {
-          "name": "pw:value-change",
-          "type": "CustomEvent<formValueChangeDetail>",
-          "description": "Live value updates whenever a field changes. `detail.name` contains the JSON Pointer-compatible path."
+          "name": "pds:live-edit:disable",
+          "description": null,
+          "type": "CustomEvent"
         }
       ],
       "slots": [],
       "cssParts": [],
-      "notes": [
-        "Typed interfaces for `formOptions`, `UISchema`, and related events live in `src/js/pds.d.ts`.",
-        "The form accepts standard JSON Schema (Draft 7) documents via the `jsonSchema` property. `uiSchema` and `options` fine-tune layout, widgets, and behaviors."
-      ]
+      "notes": []
     },
-    "pds-icon": {
-      "tag": "pds-icon",
-      "className": "SvgIcon",
-      "displayName": "pds-icon",
-      "storyTitle": "Components/pds-icon",
+    "pds-omnibox": {
+      "tag": "pds-omnibox",
+      "className": "PdsOmnibox",
+      "displayName": "pds-omnibox",
+      "storyTitle": "Components/pds-omnibox",
       "category": "Components",
-      "description": "SVG Icon Web Component\n\nSVG Icon Web Component",
-      "docsDescription": null,
+      "description": null,
+      "docsDescription": "Omnibox search input with PDS styling and form association",
       "pdsTags": [
+        "autocomplete",
         "autodocs",
-        "graphic",
-        "icon",
-        "icons",
-        "pds-icon",
-        "phosphor",
-        "sprite",
-        "svg",
-        "symbol"
+        "forms",
+        "input",
+        "pds-omnibox",
+        "search"
       ],
-      "ontology": {
-        "id": "pds-icon",
-        "name": "Icon",
-        "description": "SVG icon web component",
-        "selectors": [
-          "pds-icon"
-        ],
-        "tags": [
-          "icon",
-          "graphic",
-          "svg"
-        ],
-        "category": "media"
-      },
+      "ontology": null,
       "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-icon.js",
+      "sourceModule": "public/assets/pds/components/pds-omnibox.js",
       "superclass": "HTMLElement",
       "attributes": [
-        {
-          "name": "icon",
-          "description": "Icon name from the sprite sheet",
-          "type": "string",
-          "default": null,
-          "fieldName": null
-        },
-        {
-          "name": "size",
-          "description": "Icon size in pixels or named size (xs, sm, md, lg, xl, 2xl)",
-          "type": "string|number",
+        {
+          "name": "name",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "name"
         },
         {
-          "name": "color",
-          "description": "Icon color (CSS color value, default: currentColor)",
-          "type": "string",
+          "name": "placeholder",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "placeholder"
         },
         {
-          "name": "label",
-          "description": "Accessible label for the icon (adds role=\"img\")",
-          "type": "string",
+          "name": "value",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "value"
         },
         {
-          "name": "rotate",
-          "description": "Rotation angle in degrees",
-          "type": "number",
+          "name": "disabled",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "disabled"
         },
         {
-          "name": "morph",
-          "description": "Morph the icon when the icon name changes",
-          "type": "boolean",
+          "name": "required",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "required"
         },
         {
-          "name": "sprite",
-          "description": "Override sprite sheet path",
-          "type": "string",
+          "name": "autocomplete",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "autocomplete"
         },
         {
-          "name": "no-sprite",
-          "description": "Force fallback icon rendering",
-          "type": "boolean",
+          "name": "icon",
+          "description": null,
+          "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "icon"
         }
       ],
       "properties": [
         {
-          "name": "ensureConfigListeners",
-          "attribute": null,
-          "description": "Ensures one-time config lifecycle listeners so icons re-render when config becomes available.",
+          "name": "autocomplete",
+          "attribute": "autocomplete",
+          "description": null,
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "externalIconCache",
-          "attribute": null,
+          "name": "disabled",
+          "attribute": "disabled",
           "description": null,
-          "type": "Map<any, any>",
-          "default": "new Map()",
+          "type": null,
+          "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "externalIconPromises",
+          "name": "formAssociated",
           "attribute": null,
           "description": null,
-          "type": "Map<any, any>",
-          "default": "new Map()",
+          "type": "boolean",
+          "default": "true",
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "externalPathDebugLogged",
-          "attribute": null,
+          "name": "icon",
+          "attribute": "icon",
           "description": null,
-          "type": "Set<any>",
-          "default": null,
-          "reflects": false,
-          "privacy": "public"
-        },
-        {
-          "name": "getExternalIconCacheKey",
-          "attribute": null,
-          "description": "Build a deterministic cache key for external icon content.",
-          "type": null,
-          "default": null,
-          "reflects": false,
-          "privacy": "public"
-        },
-        {
-          "name": "getExternalIconPath",
-          "attribute": null,
-          "description": "Get the external icons path from PDS config or use default",
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "getExternalIconURL",
-          "attribute": null,
-          "description": "Resolve an external icon URL from icon name + base path.",
+          "name": "name",
+          "attribute": "name",
+          "description": null,
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "hasConfiguredExternalIconPath",
-          "attribute": null,
-          "description": "Returns true when externalPath is explicitly present in runtime config.",
+          "name": "placeholder",
+          "attribute": "placeholder",
+          "description": null,
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "inlineSprites",
-          "attribute": null,
-          "description": null,
-          "type": "Map<any, any>",
-          "default": "new Map()",
-          "reflects": false,
-          "privacy": "public"
-        },
-        {
-          "name": "instances",
-          "attribute": null,
+          "name": "required",
+          "attribute": "required",
           "description": null,
-          "type": "Set<any>",
-          "default": "new Set()",
-          "reflects": false,
-          "privacy": "public"
-        },
-        {
-          "name": "isDebugLoggingEnabled",
-          "attribute": null,
-          "description": "Whether verbose icon diagnostics should be logged.",
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "normalizeExternalIconPath",
+          "name": "settings",
           "attribute": null,
-          "description": "Normalize the external icon path to make cache keys and URL joining stable.",
+          "description": null,
           "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "observedAttributes",
-          "attribute": null,
+          "name": "value",
+          "attribute": "value",
           "description": null,
-          "type": "string[]",
+          "type": null,
           "default": null,
           "reflects": false,
           "privacy": "public"
-        },
-        {
-          "name": "spritePromises",
-          "attribute": null,
-          "description": null,
-          "type": "Map<any, any>",
-          "default": "new Map()",
-          "reflects": false,
-          "privacy": "public"
         }
       ],
       "methods": [
@@ -1243,184 +2344,103 @@
           "name": "attributeChangedCallback",
           "description": null,
           "parameters": [
-            {
-              "name": "name",
-              "type": "any",
-              "description": null,
-              "optional": false
-            },
-            {
-              "name": "oldValue",
-              "type": "any",
-              "description": null,
-              "optional": false
-            },
-            {
-              "name": "newValue",
-              "type": "any",
-              "description": null,
-              "optional": false
-            }
-          ],
-          "return": "void"
-        },
-        {
-          "name": "connectedCallback",
-          "description": null,
-          "parameters": [],
-          "return": "void"
-        },
-        {
-          "name": "disconnectedCallback",
-          "description": null,
-          "parameters": [],
-          "return": "void"
-        },
-        {
-          "name": "ensureInlineSprite",
-          "description": null,
-          "parameters": [
-            {
-              "name": "spriteURL",
-              "type": "any",
-              "description": null,
-              "optional": false
-            }
-          ],
-          "return": "Promise<any>"
-        },
-        {
-          "name": "fetchExternalIcon",
-          "description": "Fetch an external SVG icon and cache it\n\nFetch an external SVG icon and cache it",
-          "parameters": [
-            {
-              "name": "iconName",
-              "type": "string",
-              "description": "The icon name (without .svg extension)",
-              "optional": false
-            }
-          ],
-          "return": "Promise<boolean>"
-        },
-        {
-          "name": "notifyInstances",
-          "description": null,
-          "parameters": [],
-          "return": "void"
-        },
-        {
-          "name": "render",
-          "description": null,
-          "parameters": [],
-          "return": "void"
-        },
-        {
-          "name": "spriteAvailable",
-          "description": "Check if sprite sheet is available\n\nCheck if sprite sheet is available",
-          "parameters": [],
-          "return": "boolean"
-        }
-      ],
-      "events": [],
-      "slots": [],
-      "cssParts": [],
-      "notes": []
-    },
-    "component_tag": {
-      "tag": "component_tag",
-      "className": "PdsLiveTemplateCanvas",
-      "displayName": "Component_tag",
-      "storyTitle": null,
-      "category": null,
-      "description": null,
-      "docsDescription": null,
-      "pdsTags": [],
-      "ontology": null,
-      "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-live-template-canvas.js",
-      "superclass": "HTMLElement",
-      "attributes": [],
-      "properties": [],
-      "methods": [],
-      "events": [
+            {
+              "name": "name",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "oldValue",
+              "type": "any",
+              "description": null,
+              "optional": false
+            },
+            {
+              "name": "newValue",
+              "type": "any",
+              "description": null,
+              "optional": false
+            }
+          ],
+          "return": "void"
+        },
         {
-          "name": "pds:live-template:inject",
+          "name": "checkValidity",
           "description": null,
-          "type": "CustomEvent"
-        }
-      ],
-      "slots": [],
-      "cssParts": [],
-      "notes": []
-    },
-    "editor_tag": {
-      "tag": "editor_tag",
-      "className": "PdsLiveEdit",
-      "displayName": "Editor_tag",
-      "storyTitle": null,
-      "category": null,
-      "description": null,
-      "docsDescription": null,
-      "pdsTags": [],
-      "ontology": null,
-      "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-live-edit.js",
-      "superclass": "HTMLElement",
-      "attributes": [],
-      "properties": [],
-      "methods": [
+          "parameters": [],
+          "return": "any"
+        },
         {
-          "name": "createSharedQuickModeMenuItem",
+          "name": "connectedCallback",
           "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "isInteractiveEditingEnabled",
+          "name": "disconnectedCallback",
           "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "openDesignSettings",
+          "name": "formAssociatedCallback",
           "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "openImportDetailsFromToast",
+          "name": "formDisabledCallback",
           "description": null,
           "parameters": [
             {
-              "name": "options",
-              "type": null,
-              "description": null
+              "name": "disabled",
+              "type": "any",
+              "description": null,
+              "optional": false
             }
           ],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "resetConfig",
+          "name": "formResetCallback",
           "description": null,
           "parameters": [],
-          "return": null
+          "return": "void"
         },
         {
-          "name": "setInteractiveEditingEnabled",
+          "name": "formStateRestoreCallback",
           "description": null,
           "parameters": [
             {
-              "name": "enabled",
-              "type": null,
-              "description": null
+              "name": "state",
+              "type": "any",
+              "description": null,
+              "optional": false
             }
           ],
-          "return": null
+          "return": "void"
+        },
+        {
+          "name": "reportValidity",
+          "description": null,
+          "parameters": [],
+          "return": "any"
         }
       ],
       "events": [
         {
-          "name": "pds:live-edit:disable",
+          "name": "change",
+          "description": null,
+          "type": "Event"
+        },
+        {
+          "name": "input",
+          "description": null,
+          "type": "Event"
+        },
+        {
+          "name": "suggestions-updated",
           "description": null,
           "type": "CustomEvent"
         }
@@ -1429,90 +2449,114 @@
       "cssParts": [],
       "notes": []
     },
-    "pds-omnibox": {
-      "tag": "pds-omnibox",
-      "className": "PdsOmnibox",
-      "displayName": "pds-omnibox",
-      "storyTitle": "Components/pds-omnibox",
+    "pds-rating": {
+      "tag": "pds-rating",
+      "className": "PdsRating",
+      "displayName": "pds-rating",
+      "storyTitle": "Components/pds-rating",
       "category": "Components",
-      "description": null,
-      "docsDescription": "Omnibox search input with PDS styling and form association",
+      "description": "Star-based rating input that participates in native HTML forms.\n\nStar-based rating input that participates in native HTML forms.",
+      "docsDescription": "Form-associated star rating control with keyboard, pointer, and half-step support.",
       "pdsTags": [
-        "autocomplete",
         "autodocs",
-        "forms",
+        "form",
         "input",
-        "pds-omnibox",
-        "search"
+        "pds-rating",
+        "rating",
+        "stars"
       ],
       "ontology": null,
-      "stories": [],
-      "sourceModule": "public/assets/pds/components/pds-omnibox.js",
-      "superclass": "HTMLElement",
-      "attributes": [
+      "stories": [
         {
-          "name": "name",
+          "exportName": "InForm",
+          "name": "InForm",
+          "id": "components-pds-rating--in-form",
+          "tags": [],
           "description": null,
-          "type": null,
-          "default": null,
-          "fieldName": null,
-          "property": "name"
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
         },
         {
-          "name": "placeholder",
+          "exportName": "Default",
+          "name": "Interactive Playground",
+          "id": "components-pds-rating--default",
+          "tags": [],
           "description": null,
-          "type": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+        },
+        {
+          "exportName": "States",
+          "name": "States",
+          "id": "components-pds-rating--states",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+        }
+      ],
+      "sourceModule": "public/assets/pds/components/pds-rating.js",
+      "superclass": "HTMLElement",
+      "attributes": [
+        {
+          "name": "max",
+          "description": "Maximum rating value and rendered star count (minimum 1, default 5)",
+          "type": "number",
           "default": null,
           "fieldName": null,
-          "property": "placeholder"
+          "property": "max"
         },
         {
           "name": "value",
-          "description": null,
-          "type": null,
+          "description": "Current rating value (snapped to 0.5 increments)",
+          "type": "number",
           "default": null,
           "fieldName": null,
           "property": "value"
         },
         {
           "name": "disabled",
-          "description": null,
-          "type": null,
+          "description": "Disables keyboard/pointer interaction and form submission value",
+          "type": "boolean",
           "default": null,
           "fieldName": null,
           "property": "disabled"
         },
         {
           "name": "required",
-          "description": null,
-          "type": null,
+          "description": "Marks the rating as required for form validation",
+          "type": "boolean",
           "default": null,
           "fieldName": null,
           "property": "required"
         },
         {
-          "name": "autocomplete",
-          "description": null,
-          "type": null,
+          "name": "readonly",
+          "description": "Makes the rating non-editable while still focusable",
+          "type": "boolean",
+          "default": null,
+          "fieldName": null
+        },
+        {
+          "name": "name",
+          "description": "Form field name used when submitting the rating",
+          "type": "string",
           "default": null,
           "fieldName": null,
-          "property": "autocomplete"
+          "property": "name"
         },
         {
-          "name": "icon",
-          "description": null,
-          "type": null,
+          "name": "color",
+          "description": "Optional active star color (CSS color value)",
+          "type": "string",
           "default": null,
           "fieldName": null,
-          "property": "icon"
+          "property": "color"
         }
       ],
       "properties": [
         {
-          "name": "autocomplete",
-          "attribute": "autocomplete",
-          "description": null,
-          "type": null,
+          "name": "color",
+          "attribute": "color",
+          "description": "Active star color override",
+          "type": "string",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1520,8 +2564,17 @@
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": null,
-          "type": null,
+          "description": "Disabled state",
+          "type": "boolean",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "form",
+          "attribute": null,
+          "description": "Associated form element",
+          "type": "HTMLFormElement|null",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1536,10 +2589,28 @@
           "privacy": "public"
         },
         {
-          "name": "icon",
-          "attribute": "icon",
+          "name": "innerHTML",
+          "attribute": null,
           "description": null,
           "type": null,
+          "default": "`\r\n      <style>\r\n        :host {\r\n          --rating-star-size: var(--spacing-lg);\r\n          --rating-star-gap: var(--spacing-2xs);\r\n          --rating-star-off: var(--color-text-muted);\r\n          --rating-star-on: var(--color-warning-500);\r\n          --rating-focus: var(--color-primary-500);\r\n          --rating-fill-pct: 0%;\r\n          display: inline-block;\r\n          inline-size: fit-content;\r\n          max-inline-size: 100%;\r\n          touch-action: none;\r\n        }\r\n\r\n        ::slotted(input[type=\"range\"]) {\r\n          position: absolute !important;\r\n          inset-inline-start: 0 !important;\r\n          inset-block-start: 0 !important;\r\n          inline-size: 1px !important;\r\n          block-size: 1px !important;\r\n          min-inline-size: 1px !important;\r\n          min-block-size: 1px !important;\r\n          margin: -1px !important;\r\n          border: 0 !important;\r\n          padding: 0 !important;\r\n          opacity: 0 !important;\r\n          overflow: hidden !important;\r\n          clip: rect(0 0 0 0) !important;\r\n          clip-path: inset(50%) !important;\r\n          white-space: nowrap !important;\r\n          appearance: none !important;\r\n          -webkit-appearance: none !important;\r\n          pointer-events: none !important;\r\n        }\r\n\r\n        .wrap {\r\n          position: relative;\r\n          display: inline-grid;\r\n          gap: var(--spacing-2xs);\r\n          align-items: center;\r\n          justify-items: start;\r\n          min-block-size: calc(var(--rating-star-size) + var(--spacing-xs));\r\n        }\r\n\r\n        .interactive {\r\n          display: inline-grid;\r\n          place-items: center start;\r\n          inline-size: 100%;\r\n          cursor: pointer;\r\n          user-select: none;\r\n          -webkit-tap-highlight-color: transparent;\r\n          touch-action: pan-x;\r\n        }\r\n\r\n        :host([disabled]) .interactive,\r\n        :host([readonly]) .interactive {\r\n          cursor: default;\r\n        }\r\n\r\n        :host([disabled]) {\r\n          opacity: 0.5;\r\n        }\r\n\r\n        .stars {\r\n          display: block;\r\n          inline-size: auto;\r\n          block-size: var(--rating-star-size);\r\n          overflow: visible;\r\n          transition: transform 220ms ease, opacity 220ms ease;\r\n        }\r\n\r\n        :host([data-in-view=\"false\"]) .stars {\r\n          opacity: 0;\r\n          transform: translateY(var(--spacing-xs)) scale(0.98);\r\n        }\r\n\r\n        :host([data-in-view=\"true\"]) .stars {\r\n          opacity: 1;\r\n          transform: translateY(0) scale(1);\r\n        }\r\n\r\n        input[type=\"range\"] {\r\n          position: absolute !important;\r\n          inset-inline-start: 0 !important;\r\n          inset-block-start: 0 !important;\r\n          inline-size: 1px !important;\r\n          block-size: 1px !important;\r\n          min-inline-size: 1px !important;\r\n          min-block-size: 1px !important;\r\n          margin: -1px !important;\r\n          border: 0 !important;\r\n          padding: 0 !important;\r\n          opacity: 0 !important;\r\n          overflow: hidden !important;\r\n          clip: rect(0 0 0 0) !important;\r\n          clip-path: inset(50%) !important;\r\n          white-space: nowrap !important;\r\n          appearance: none !important;\r\n          -webkit-appearance: none !important;\r\n          pointer-events: none !important;\r\n        }\r\n\r\n        :host(:focus-within) .interactive {\r\n          outline: 2px solid var(--rating-focus);\r\n          outline-offset: var(--spacing-3xs);\r\n          border-radius: var(--radius-sm);\r\n        }\r\n\r\n        @media (prefers-reduced-motion: reduce) {\r\n          .stars {\r\n            transition: none;\r\n          }\r\n        }\r\n      </style>\r\n\r\n      <div class=\"wrap\" part=\"control\">\r\n        <div class=\"interactive\" part=\"interactive\" aria-hidden=\"true\">\r\n          <svg class=\"stars\" part=\"stars\" focusable=\"false\" aria-hidden=\"true\"></svg>\r\n        </div>\r\n        <slot></slot>\r\n      </div>\r\n    `",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "max",
+          "attribute": "max",
+          "description": "Maximum rating value and rendered star count",
+          "type": "number",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "min",
+          "attribute": null,
+          "description": "Minimum rating value (always 0)",
+          "type": "number",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1547,17 +2618,26 @@
         {
           "name": "name",
           "attribute": "name",
-          "description": null,
-          "type": null,
+          "description": "Form field name",
+          "type": "string",
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "placeholder",
-          "attribute": "placeholder",
+          "name": "observedAttributes",
+          "attribute": null,
           "description": null,
-          "type": null,
+          "type": "string[]",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "readOnly",
+          "attribute": null,
+          "description": "Read-only state",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1565,17 +2645,44 @@
         {
           "name": "required",
           "attribute": "required",
-          "description": null,
-          "type": null,
+          "description": "Required state",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
         },
         {
-          "name": "settings",
+          "name": "step",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "Step size used for keyboard and pointer input (always 0.5)",
+          "type": "number",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "type",
+          "attribute": null,
+          "description": "Form control type (`range`)",
+          "type": "string",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "validationMessage",
+          "attribute": null,
+          "description": "Current validation message",
+          "type": "string",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "validity",
+          "attribute": null,
+          "description": "Current validity state",
+          "type": "ValidityState",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1583,8 +2690,17 @@
         {
           "name": "value",
           "attribute": "value",
-          "description": null,
-          "type": null,
+          "description": "Current rating value",
+          "type": "number",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "willValidate",
+          "attribute": null,
+          "description": "Whether the element is eligible for validation",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -1593,23 +2709,23 @@
       "methods": [
         {
           "name": "attributeChangedCallback",
-          "description": null,
+          "description": "Reacts to reflected attribute changes and keeps internal state in sync.",
           "parameters": [
             {
               "name": "name",
-              "type": "any",
+              "type": "string",
               "description": null,
               "optional": false
             },
             {
               "name": "oldValue",
-              "type": "any",
+              "type": "string | null",
               "description": null,
               "optional": false
             },
             {
               "name": "newValue",
-              "type": "any",
+              "type": "string | null",
               "description": null,
               "optional": false
             }
@@ -1618,54 +2734,35 @@
         },
         {
           "name": "checkValidity",
-          "description": null,
+          "description": "Runs constraint validation.\n\nRuns constraint validation.",
           "parameters": [],
-          "return": "any"
+          "return": "boolean"
         },
         {
           "name": "connectedCallback",
-          "description": null,
+          "description": "Initializes DOM wiring, syncing, and in-view animation observation.",
           "parameters": [],
           "return": "void"
         },
         {
           "name": "disconnectedCallback",
-          "description": null,
-          "parameters": [],
-          "return": "void"
-        },
-        {
-          "name": "formAssociatedCallback",
-          "description": null,
+          "description": "Cleans up listeners and observers.",
           "parameters": [],
           "return": "void"
         },
-        {
-          "name": "formDisabledCallback",
-          "description": null,
-          "parameters": [
-            {
-              "name": "disabled",
-              "type": "any",
-              "description": null,
-              "optional": false
-            }
-          ],
-          "return": "void"
-        },
         {
           "name": "formResetCallback",
-          "description": null,
+          "description": "Restores default value during parent form reset.\n\nRestores default value during parent form reset.",
           "parameters": [],
           "return": "void"
         },
         {
           "name": "formStateRestoreCallback",
-          "description": null,
+          "description": "Restores state from browser session history/form restore.\n\nRestores state from browser session history/form restore.",
           "parameters": [
             {
               "name": "state",
-              "type": "any",
+              "type": "string | File | FormData | null",
               "description": null,
               "optional": false
             }
@@ -1674,26 +2771,21 @@
         },
         {
           "name": "reportValidity",
-          "description": null,
+          "description": "Runs constraint validation and reports the result to the user agent.\n\nRuns constraint validation and reports the result to the user agent.",
           "parameters": [],
-          "return": "any"
+          "return": "boolean"
         }
       ],
       "events": [
         {
           "name": "change",
-          "description": null,
+          "description": "Fired after input when the value commit completes",
           "type": "Event"
         },
         {
           "name": "input",
-          "description": null,
+          "description": "Fired when the value changes via pointer or keyboard interaction",
           "type": "Event"
-        },
-        {
-          "name": "suggestions-updated",
-          "description": null,
-          "type": "CustomEvent"
         }
       ],
       "slots": [],
@@ -2496,6 +3588,33 @@
       "superclass": "HTMLElement",
       "attributes": [],
       "properties": [
+        {
+          "name": "activeToastIdsByKey",
+          "attribute": null,
+          "description": null,
+          "type": "Map<any, any>",
+          "default": "new Map()",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "activeToastKeys",
+          "attribute": null,
+          "description": null,
+          "type": "Set<any>",
+          "default": "new Set()",
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "activeToastKeysById",
+          "attribute": null,
+          "description": null,
+          "type": "Map<any, any>",
+          "default": "new Map()",
+          "reflects": false,
+          "privacy": "public"
+        },
         {
           "name": "toasts",
           "attribute": null,
@@ -3433,6 +4552,7 @@
           ".btn-primary",
           ".btn-secondary",
           ".btn-outline",
+          ".btn-danger",
           ".btn-sm",
           ".btn-xs",
           ".btn-lg",
@@ -4061,6 +5181,7 @@
           ".btn-primary",
           ".btn-secondary",
           ".btn-outline",
+          ".btn-danger",
           ".btn-sm",
           ".btn-xs",
           ".btn-lg",
@@ -4973,6 +6094,7 @@
         "form",
         "btn-primary",
         "btn-secondary",
+        "btn-danger",
         "btn-working",
         "pds-fab",
         "floating"
@@ -5742,7 +6864,7 @@
       "storyTitle": "Components/pds-calendar",
       "category": "Components",
       "name": "pds-calendar",
-      "description": "A fully featured calendar component with month navigation, event display, and expandable day views",
+      "description": "A fully featured calendar component with month navigation, event display, and keyboard-accessible date selection",
       "tags": [
         "autodocs",
         "calendar",
@@ -5762,58 +6884,47 @@
           "pds-calendar"
         ]
       },
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+      ]
+    },
+    "pds-daterange": {
+      "slug": "pds-daterange",
+      "storyTitle": "Components/pds-daterange",
+      "category": "Components",
+      "name": "pds-daterange",
+      "description": "Form-associated date range picker with compact dual-calendar dropdown and ISO interval value output.",
+      "tags": [
+        "autodocs",
+        "calendar",
+        "date",
+        "form",
+        "pds-daterange",
+        "range",
+        "travel"
+      ],
+      "pdsParameters": {
+        "tags": [
+          "pds-daterange",
+          "date",
+          "range",
+          "calendar",
+          "form"
+        ]
+      },
       "stories": [
         {
           "exportName": "Default",
           "name": "Default",
-          "id": "components-pds-calendar--default",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
-        {
-          "exportName": "DynamicEvents",
-          "name": "DynamicEvents",
-          "id": "components-pds-calendar--dynamic-events",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
-        {
-          "exportName": "EventTypes",
-          "name": "EventTypes",
-          "id": "components-pds-calendar--event-types",
+          "id": "components-pds-daterange--default",
           "tags": [],
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
-        {
-          "exportName": "FormParticipation",
-          "name": "FormParticipation",
-          "id": "components-pds-calendar--form-participation",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
-        {
-          "exportName": "WithManyEvents",
-          "name": "WithManyEvents",
-          "id": "components-pds-calendar--with-many-events",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
-        },
-        {
-          "exportName": "WithSpecificDate",
-          "name": "WithSpecificDate",
-          "id": "components-pds-calendar--with-specific-date",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+          "source": "packages\\pds-storybook\\stories\\components\\PdsDaterange.stories.js"
         }
       ],
       "files": [
-        "packages\\pds-storybook\\stories\\components\\PdsCalendar.stories.js"
+        "packages\\pds-storybook\\stories\\components\\PdsDaterange.stories.js"
       ]
     },
     "pds-drawer": {
@@ -5898,6 +7009,97 @@
         "packages\\pds-storybook\\stories\\components\\PdsFab.stories.js"
       ]
     },
+    "basics": {
+      "slug": "basics",
+      "storyTitle": "Components/pds-form/Basics",
+      "category": "Components/pds-form",
+      "name": "Basics",
+      "description": null,
+      "tags": [],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.Basics.stories.js"
+      ]
+    },
+    "conditional-calculated": {
+      "slug": "conditional-calculated",
+      "storyTitle": "Components/pds-form/Conditional & Calculated",
+      "category": "Components/pds-form",
+      "name": "Conditional & Calculated",
+      "description": null,
+      "tags": [],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.ConditionalAndCalculated.stories.js"
+      ]
+    },
+    "custom-content": {
+      "slug": "custom-content",
+      "storyTitle": "Components/pds-form/Custom Content",
+      "category": "Components/pds-form",
+      "name": "Custom Content",
+      "description": null,
+      "tags": [],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.CustomContent.stories.js"
+      ]
+    },
+    "dialogs": {
+      "slug": "dialogs",
+      "storyTitle": "Components/pds-form/Dialogs",
+      "category": "Components/pds-form",
+      "name": "Dialogs",
+      "description": null,
+      "tags": [],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.Dialogs.stories.js"
+      ]
+    },
+    "layout": {
+      "slug": "layout",
+      "storyTitle": "Components/pds-form/Layout",
+      "category": "Components/pds-form",
+      "name": "Layout",
+      "description": "Complete layout system: Container, Grid, Flex, Stack, and Gap utilities.",
+      "tags": [
+        "alignment",
+        "container",
+        "flex",
+        "gap",
+        "grid",
+        "layout",
+        "spacing",
+        "text",
+        "truncate",
+        "utilities"
+      ],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.Layout.stories.js",
+        "packages\\pds-storybook\\stories\\layout\\LayoutOverview.stories.js",
+        "packages\\pds-storybook\\stories\\layout\\LayoutSystem.stories.js"
+      ]
+    },
+    "selection-arrays": {
+      "slug": "selection-arrays",
+      "storyTitle": "Components/pds-form/Selection & Arrays",
+      "category": "Components/pds-form",
+      "name": "Selection & Arrays",
+      "description": null,
+      "tags": [],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsForm.SelectionAndArrays.stories.js"
+      ]
+    },
     "pds-form": {
       "slug": "pds-form",
       "storyTitle": "Components/pds-form",
@@ -5990,6 +7192,59 @@
         "packages\\pds-storybook\\stories\\components\\PdsOmnibox.stories.js"
       ]
     },
+    "pds-rating": {
+      "slug": "pds-rating",
+      "storyTitle": "Components/pds-rating",
+      "category": "Components",
+      "name": "pds-rating",
+      "description": "Form-associated star rating control with keyboard, pointer, and half-step support.",
+      "tags": [
+        "autodocs",
+        "form",
+        "input",
+        "pds-rating",
+        "rating",
+        "stars"
+      ],
+      "pdsParameters": {
+        "tags": [
+          "rating",
+          "stars",
+          "form",
+          "input",
+          "pds-rating"
+        ]
+      },
+      "stories": [
+        {
+          "exportName": "InForm",
+          "name": "InForm",
+          "id": "components-pds-rating--in-form",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+        },
+        {
+          "exportName": "Default",
+          "name": "Interactive Playground",
+          "id": "components-pds-rating--default",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+        },
+        {
+          "exportName": "States",
+          "name": "States",
+          "id": "components-pds-rating--states",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+        }
+      ],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsRating.stories.js"
+      ]
+    },
     "pds-richtext": {
       "slug": "pds-richtext",
       "storyTitle": "Components/pds-richtext",
@@ -6131,6 +7386,25 @@
         "packages\\pds-storybook\\stories\\components\\PdsTabstrip.stories.js"
       ]
     },
+    "pds-tags": {
+      "slug": "pds-tags",
+      "storyTitle": "Components/pds-tags",
+      "category": "Components",
+      "name": "pds-tags",
+      "description": "Compound multi-select built with pds-omnibox. Select/unselect values from suggestions and manage them as tags.",
+      "tags": [
+        "autocomplete",
+        "autodocs",
+        "forms",
+        "multiselect",
+        "pds-tags"
+      ],
+      "pdsParameters": {},
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\components\\PdsTags.stories.js"
+      ]
+    },
     "pds-theme": {
       "slug": "pds-theme",
       "storyTitle": "Components/pds-theme",
@@ -6893,31 +8167,6 @@
         "packages\\pds-storybook\\stories\\GettingStarted.stories.js"
       ]
     },
-    "layout": {
-      "slug": "layout",
-      "storyTitle": "Foundations/Layout",
-      "category": "Foundations",
-      "name": "Layout",
-      "description": "Complete layout system: Container, Grid, Flex, Stack, and Gap utilities.",
-      "tags": [
-        "alignment",
-        "container",
-        "flex",
-        "gap",
-        "grid",
-        "layout",
-        "spacing",
-        "text",
-        "truncate",
-        "utilities"
-      ],
-      "pdsParameters": {},
-      "stories": [],
-      "files": [
-        "packages\\pds-storybook\\stories\\layout\\LayoutOverview.stories.js",
-        "packages\\pds-storybook\\stories\\layout\\LayoutSystem.stories.js"
-      ]
-    },
     "border-effects": {
       "slug": "border-effects",
       "storyTitle": "Patterns/Border Effects",
@@ -7011,6 +8260,33 @@
         "packages\\pds-storybook\\stories\\patterns\\Utilities.stories.js"
       ]
     },
+    "articles": {
+      "slug": "articles",
+      "storyTitle": "Primitives/Articles",
+      "category": "Primitives",
+      "name": "Articles",
+      "description": "Long-form content layout pattern using semantic article markup and PDS primitives.",
+      "tags": [
+        "article",
+        "content",
+        "layout",
+        "readability",
+        "typography"
+      ],
+      "pdsParameters": {
+        "tags": [
+          "typography",
+          "content",
+          "article",
+          "layout",
+          "readability"
+        ]
+      },
+      "stories": [],
+      "files": [
+        "packages\\pds-storybook\\stories\\primitives\\ArticleLayout.stories.js"
+      ]
+    },
     "badges-pills": {
       "slug": "badges-pills",
       "storyTitle": "Primitives/Badges & Pills",
@@ -7335,6 +8611,9 @@
         "feedback",
         "notifications",
         "parse",
+        "pds-compiled",
+        "pds-enums",
+        "pds-object",
         "pds-parse",
         "pds-toast",
         "reference",
@@ -7350,17 +8629,9 @@
           "pds-toast"
         ]
       },
-      "stories": [
-        {
-          "exportName": "PDSParse",
-          "name": "PDS.parse()",
-          "id": "pds-pds-object--pdsparse",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js"
-        }
-      ],
+      "stories": [],
       "files": [
+        "packages\\pds-storybook\\stories\\utils\\PdsObjectApi.stories.js",
         "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js",
         "packages\\pds-storybook\\stories\\utils\\PdsToast.stories.js"
       ]