@pure-ds/storybook 0.7.4 → 0.7.23

package/dist/pds-reference.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-02-24T10:36:00.918Z",
+  "generatedAt": "2026-02-26T14:42:23.254Z",
   "sources": {
     "customElements": "custom-elements.json",
     "ontology": "src\\js\\pds-core\\pds-ontology.js",
@@ -10,8 +10,8 @@
     "pds-calendar": {
       "tag": "pds-calendar",
       "className": "PdsCalendar",
-      "displayName": "Pds Calendar",
-      "storyTitle": "Components/Pds Calendar",
+      "displayName": "pds-calendar",
+      "storyTitle": "Components/pds-calendar",
       "category": "Components",
       "description": null,
       "docsDescription": "A fully featured calendar component with month navigation, event display, and expandable day views",
@@ -63,6 +63,14 @@
           "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",
@@ -88,7 +96,8 @@
           "description": "The date to display (defaults to current date). Accepts any valid date string",
           "type": "String",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "date"
         }
       ],
       "properties": [
@@ -159,8 +168,8 @@
     "pds-drawer": {
       "tag": "pds-drawer",
       "className": "PdsDrawer",
-      "displayName": "Pds Drawer",
-      "storyTitle": "Components/Pds Drawer",
+      "displayName": "pds-drawer",
+      "storyTitle": "Components/pds-drawer",
       "category": "Components",
       "description": null,
       "docsDescription": "Slide-out panels from any edge",
@@ -209,42 +218,48 @@
           "description": "Controls whether the drawer is open or closed",
           "type": "boolean",
           "default": null,
-          "fieldName": "open"
+          "fieldName": "open",
+          "property": "open"
         },
         {
           "name": "position",
           "description": "Position of the drawer relative to the viewport",
           "type": "\"bottom\" | \"top\" | \"left\" | \"right\"",
           "default": "\"bottom\"",
-          "fieldName": "position"
+          "fieldName": "position",
+          "property": "position"
         },
         {
           "name": "drag",
           "description": "Controls drag interaction behavior",
           "type": "\"header\" | \"none\"",
           "default": "\"header\"",
-          "fieldName": "drag"
+          "fieldName": "drag",
+          "property": "drag"
         },
         {
           "name": "max-height",
           "description": "Maximum height for top/bottom positioned drawers (CSS value)",
           "type": "string",
           "default": "\"70vh\"",
-          "fieldName": "maxHeight"
+          "fieldName": "maxHeight",
+          "property": "maxHeight"
         },
         {
           "name": "min-height",
           "description": "Minimum height for top/bottom positioned drawers (CSS value)",
           "type": "string",
           "default": "\"auto\"",
-          "fieldName": "minHeight"
+          "fieldName": "minHeight",
+          "property": "minHeight"
         },
         {
           "name": "show-close",
           "description": "Whether to show the close button in the header",
           "type": "boolean",
           "default": "false",
-          "fieldName": "showClose"
+          "fieldName": "showClose",
+          "property": "showClose"
         }
       ],
       "properties": [
@@ -411,8 +426,8 @@
     "pds-fab": {
       "tag": "pds-fab",
       "className": "PdsFab",
-      "displayName": "Pds Fab",
-      "storyTitle": "Components/Pds Fab",
+      "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",
@@ -453,28 +468,32 @@
           "description": "Controls whether the FAB is expanded",
           "type": "boolean",
           "default": null,
-          "fieldName": "open"
+          "fieldName": "open",
+          "property": "open"
         },
         {
           "name": "radius",
           "description": "Distance in pixels from the main FAB to satellites",
           "type": "number",
           "default": "100",
-          "fieldName": "radius"
+          "fieldName": "radius",
+          "property": "radius"
         },
         {
           "name": "spread",
           "description": "Arc angle in degrees for satellite distribution",
           "type": "number",
           "default": "90",
-          "fieldName": "spread"
+          "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"
+          "fieldName": "startAngle",
+          "property": "startAngle"
         }
       ],
       "properties": [
@@ -633,94 +652,107 @@
       "attributes": [
         {
           "name": "json-schema",
-          "description": null,
+          "description": "Primary schema input. Provide a JSON Schema object to generate the form layout and validation rules.",
           "type": "object",
           "default": "undefined",
-          "fieldName": "jsonSchema"
+          "fieldName": "jsonSchema",
+          "property": "jsonSchema"
         },
         {
           "name": "ui-schema",
-          "description": null,
+          "description": "Optional UI overrides keyed by JSON Pointer. Controls layout, widgets, surfaces, dialogs, and per-field hints.",
           "type": "object",
           "default": "undefined",
-          "fieldName": "uiSchema"
+          "fieldName": "uiSchema",
+          "property": "uiSchema"
         },
         {
           "name": "options",
-          "description": null,
+          "description": "Toolkit-level options that adjust widget families, layouts, and validation behavior. Supports path-specific overrides.",
           "type": "object",
           "default": "undefined",
-          "fieldName": "options"
+          "fieldName": "options",
+          "property": "options"
         },
         {
           "name": "values",
-          "description": null,
+          "description": "Initial data that pre-populates the generated form. Shape must match the JSON Schema.",
           "type": "object",
           "default": "undefined",
-          "fieldName": "values"
+          "fieldName": "values",
+          "property": "values"
         },
         {
           "name": "action",
           "description": null,
           "type": "string",
           "default": null,
-          "fieldName": "action"
+          "fieldName": "action",
+          "property": "action"
         },
         {
           "name": "method",
           "description": null,
           "type": "string",
           "default": "\"post\"",
-          "fieldName": "method"
+          "fieldName": "method",
+          "property": "method"
         },
         {
           "name": "disabled",
           "description": null,
           "type": "boolean",
           "default": null,
-          "fieldName": "disabled"
+          "fieldName": "disabled",
+          "property": "disabled"
         },
         {
           "name": "hide-actions",
           "description": null,
           "type": "boolean",
           "default": "false",
-          "fieldName": "hideActions"
+          "fieldName": "hideActions",
+          "property": "hideActions"
         },
         {
           "name": "submit-label",
           "description": null,
           "type": "string",
           "default": "\"Submit\"",
-          "fieldName": "submitLabel"
+          "fieldName": "submitLabel",
+          "property": "submitLabel"
         },
         {
           "name": "reset-label",
           "description": null,
           "type": "string",
           "default": "\"Reset\"",
-          "fieldName": "resetLabel"
+          "fieldName": "resetLabel",
+          "property": "resetLabel"
         },
         {
           "name": "hide-reset",
           "description": null,
           "type": "boolean",
           "default": "false",
-          "fieldName": "hideReset"
+          "fieldName": "hideReset",
+          "property": "hideReset"
         },
         {
           "name": "hide-submit",
           "description": null,
           "type": "boolean",
           "default": null,
-          "fieldName": "hideSubmit"
+          "fieldName": "hideSubmit",
+          "property": "hideSubmit"
         },
         {
           "name": "hide-legend",
           "description": null,
           "type": "boolean",
           "default": "false",
-          "fieldName": "hideLegend"
+          "fieldName": "hideLegend",
+          "property": "hideLegend"
         }
       ],
       "properties": [
@@ -987,8 +1019,8 @@
     "pds-icon": {
       "tag": "pds-icon",
       "className": "SvgIcon",
-      "displayName": "Pds Icon",
-      "storyTitle": "Components/Pds Icon",
+      "displayName": "pds-icon",
+      "storyTitle": "Components/pds-icon",
       "category": "Components",
       "description": "SVG Icon Web Component\n\nSVG Icon Web Component",
       "docsDescription": null,
@@ -1079,6 +1111,15 @@
         }
       ],
       "properties": [
+        {
+          "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": "externalIconCache",
           "attribute": null,
@@ -1097,6 +1138,24 @@
           "reflects": false,
           "privacy": "public"
         },
+        {
+          "name": "externalPathDebugLogged",
+          "attribute": null,
+          "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,
@@ -1106,6 +1165,24 @@
           "reflects": false,
           "privacy": "public"
         },
+        {
+          "name": "getExternalIconURL",
+          "attribute": null,
+          "description": "Resolve an external icon URL from icon name + base path.",
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "hasConfiguredExternalIconPath",
+          "attribute": null,
+          "description": "Returns true when externalPath is explicitly present in runtime config.",
+          "type": null,
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
         {
           "name": "inlineSprites",
           "attribute": null,
@@ -1124,6 +1201,24 @@
           "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",
+          "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": "observedAttributes",
           "attribute": null,
@@ -1337,8 +1432,8 @@
     "pds-omnibox": {
       "tag": "pds-omnibox",
       "className": "PdsOmnibox",
-      "displayName": "Pds Omnibox",
-      "storyTitle": "Components/Pds Omnibox",
+      "displayName": "pds-omnibox",
+      "storyTitle": "Components/pds-omnibox",
       "category": "Components",
       "description": null,
       "docsDescription": "Omnibox search input with PDS styling and form association",
@@ -1360,49 +1455,56 @@
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "name"
         },
         {
           "name": "placeholder",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "placeholder"
         },
         {
           "name": "value",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "value"
         },
         {
           "name": "disabled",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "disabled"
         },
         {
           "name": "required",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "required"
         },
         {
           "name": "autocomplete",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "autocomplete"
         },
         {
           "name": "icon",
           "description": null,
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "icon"
         }
       ],
       "properties": [
@@ -1601,8 +1703,8 @@
     "pds-richtext": {
       "tag": "pds-richtext",
       "className": "RichText",
-      "displayName": "Pds Richtext",
-      "storyTitle": "Components/Pds Richtext",
+      "displayName": "pds-richtext",
+      "storyTitle": "Components/pds-richtext",
       "category": "Components",
       "description": null,
       "docsDescription": "Rich text editor with markdown support and formatting toolbar. Provide a #showdown import-map entry for best performance; set format=\"markdown\" to keep submitted values as Markdown.",
@@ -1645,66 +1747,75 @@
       "attributes": [
         {
           "name": "name",
-          "description": null,
+          "description": "Update the form field name.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "name"
         },
         {
           "name": "placeholder",
-          "description": null,
+          "description": "Set the placeholder text.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "placeholder"
         },
         {
           "name": "disabled",
-          "description": null,
+          "description": "Enable or disable user input.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "disabled"
         },
         {
           "name": "required",
-          "description": null,
+          "description": "Toggle required validation.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "required"
         },
         {
           "name": "submit-on-enter",
-          "description": null,
+          "description": "Enable or disable submit-on-enter behaviour.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "submitOnEnter"
         },
         {
           "name": "spellcheck",
-          "description": null,
+          "description": "Toggle native spell checking support.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "spellcheck"
         },
         {
           "name": "toolbar",
-          "description": null,
+          "description": "Show or hide the formatting toolbar.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "toolbar"
         },
         {
           "name": "value",
-          "description": null,
+          "description": "Update the editor value programmatically.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "value"
         },
         {
           "name": "format",
-          "description": null,
+          "description": "Change the output format for future values.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "format"
         }
       ],
       "properties": [
@@ -1867,8 +1978,8 @@
     "pds-scrollrow": {
       "tag": "pds-scrollrow",
       "className": "PdsScrollrow",
-      "displayName": "Pds Scrollrow",
-      "storyTitle": "Components/Pds Scrollrow",
+      "displayName": "pds-scrollrow",
+      "storyTitle": "Components/pds-scrollrow",
       "category": "Components",
       "description": null,
       "docsDescription": "Horizontal scrolling container with navigation buttons",
@@ -1902,31 +2013,35 @@
       "attributes": [
         {
           "name": "label",
-          "description": null,
+          "description": "Update the accessible label and optional fallback heading text.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "label"
         },
         {
           "name": "snap",
-          "description": null,
+          "description": "Adjust the scroll snap alignment.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "snap"
         },
         {
           "name": "tile-min",
-          "description": null,
+          "description": "Minimum tile size applied to slotted content.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "tileMin"
         },
         {
           "name": "tile-max",
-          "description": null,
+          "description": "Maximum tile size applied to slotted content.",
           "type": null,
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "tileMax"
         }
       ],
       "properties": [
@@ -1989,8 +2104,8 @@
     "pds-splitpanel": {
       "tag": "pds-splitpanel",
       "className": "PdsSplitpanel",
-      "displayName": "Pds Splitpanel",
-      "storyTitle": "Components/Pds Splitpanel",
+      "displayName": "pds-splitpanel",
+      "storyTitle": "Components/pds-splitpanel",
       "category": "Components",
       "description": null,
       "docsDescription": "Split panels divide content areas with a draggable divider for resizable layouts.",
@@ -2028,7 +2143,8 @@
           "description": "The layout direction of the panels. Can be \"horizontal\" or \"vertical\". Defaults to \"horizontal\".",
           "type": "String",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "layout"
         },
         {
           "name": "defaultsplit",
@@ -2042,14 +2158,16 @@
           "description": "The viewport width in pixels below which the component switches to mobile view. Defaults to 1024.",
           "type": "Number",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "breakpoint"
         },
         {
           "name": "open",
           "description": "Controls the visibility of the primary panel in mobile view.",
           "type": "Boolean",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "open"
         }
       ],
       "properties": [
@@ -2315,8 +2433,8 @@
     "pds-theme": {
       "tag": "pds-theme",
       "className": "PdsTheme",
-      "displayName": "Pds Theme",
-      "storyTitle": "Components/Pds Theme",
+      "displayName": "pds-theme",
+      "storyTitle": "Components/pds-theme",
       "category": "Components",
       "description": null,
       "docsDescription": null,
@@ -2343,8 +2461,8 @@
     "pds-toaster": {
       "tag": "pds-toaster",
       "className": "AppToaster",
-      "displayName": "Pds Toaster",
-      "storyTitle": "Components/Pds Toaster",
+      "displayName": "pds-toaster",
+      "storyTitle": "Components/pds-toaster",
       "category": "Components",
       "description": null,
       "docsDescription": "Toast notification system with auto-dismiss and stacking. Toast notifications appear in the top-right corner and auto-dismiss after a few seconds based on message length.",
@@ -2590,8 +2708,8 @@
     "pds-treeview": {
       "tag": "pds-treeview",
       "className": "PdsTreeview",
-      "displayName": "Pds Treeview",
-      "storyTitle": "Components/Pds Treeview",
+      "displayName": "pds-treeview",
+      "storyTitle": "Components/pds-treeview",
       "category": "Components",
       "description": null,
       "docsDescription": "Accessible treeview with nested structure rendering, keyboard navigation, and optional form-associated selection.",
@@ -2610,45 +2728,59 @@
       "attributes": [
         {
           "name": "name",
-          "description": null,
-          "type": null,
+          "description": "Form field name used when participating in form submission.",
+          "type": "string",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "name"
         },
         {
           "name": "value",
-          "description": null,
-          "type": null,
+          "description": "Selected value for single-select mode.",
+          "type": "string",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "value"
         },
         {
           "name": "disabled",
-          "description": null,
-          "type": null,
+          "description": "Disables interactions when true.",
+          "type": "boolean",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "disabled"
         },
         {
           "name": "required",
-          "description": null,
-          "type": null,
+          "description": "Requires at least one selected node for form validity.",
+          "type": "boolean",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "required"
         },
         {
           "name": "display-only",
-          "description": null,
-          "type": null,
+          "description": "Read-only presentation mode; disables selection and form value syncing.",
+          "type": "boolean",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "displayOnly"
         },
         {
           "name": "expanded-all",
-          "description": null,
-          "type": null,
+          "description": "Expands all branch nodes after data load.",
+          "type": "boolean",
           "default": null,
-          "fieldName": null
+          "fieldName": null,
+          "property": "expandedAll"
+        },
+        {
+          "name": "multiselect",
+          "description": "Selection mode.\r\n\r\n- `off`: single select\r\n- `checkboxes`: persistent multiselect with checkboxes\r\n- `auto`: touch/coarse pointer gets checkbox mode",
+          "type": "\"off\"|\"checkboxes\"|\"auto\"",
+          "default": null,
+          "fieldName": null,
+          "property": "multiselect"
         },
         {
           "name": "src",
@@ -2662,8 +2794,8 @@
         {
           "name": "disabled",
           "attribute": "disabled",
-          "description": null,
-          "type": null,
+          "description": "Disables interactions when true.",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2671,8 +2803,8 @@
         {
           "name": "displayOnly",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "Read-only presentation mode; disables selection and form value syncing.",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2680,8 +2812,8 @@
         {
           "name": "expandedAll",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "Expands all branch nodes after data load.",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2695,11 +2827,20 @@
           "reflects": false,
           "privacy": "public"
         },
+        {
+          "name": "multiselect",
+          "attribute": "multiselect",
+          "description": "Selection mode.\r\n\r\n- `off`: single select\r\n- `checkboxes`: persistent multiselect with checkboxes\r\n- `auto`: touch/coarse pointer gets checkbox mode",
+          "type": "\"off\"|\"checkboxes\"|\"auto\"",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
         {
           "name": "name",
           "attribute": "name",
-          "description": null,
-          "type": null,
+          "description": "Form field name used when participating in form submission.",
+          "type": "string",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2707,8 +2848,8 @@
         {
           "name": "options",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "Alias for `settings`.",
+          "type": "PdsTreeviewOptions",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2716,8 +2857,8 @@
         {
           "name": "required",
           "attribute": "required",
-          "description": null,
-          "type": null,
+          "description": "Requires at least one selected node for form validity.",
+          "type": "boolean",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2725,8 +2866,17 @@
         {
           "name": "selectedNode",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "First selected node (or active selected node in multiselect).",
+          "type": "PdsTreeviewNode|null",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "selectedNodes",
+          "attribute": null,
+          "description": "All selected nodes.",
+          "type": "PdsTreeviewNode[]",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2734,8 +2884,8 @@
         {
           "name": "settings",
           "attribute": null,
-          "description": null,
-          "type": null,
+          "description": "Current runtime settings for data loading and behavior.",
+          "type": "PdsTreeviewOptions",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2743,8 +2893,17 @@
         {
           "name": "value",
           "attribute": "value",
-          "description": null,
-          "type": null,
+          "description": "Selected value for single-select mode.",
+          "type": "string",
+          "default": null,
+          "reflects": false,
+          "privacy": "public"
+        },
+        {
+          "name": "values",
+          "attribute": null,
+          "description": "Selected values in multiselect mode.",
+          "type": "string[]",
           "default": null,
           "reflects": false,
           "privacy": "public"
@@ -2778,13 +2937,13 @@
         },
         {
           "name": "checkValidity",
-          "description": null,
+          "description": "Runs form-associated validity checks.\n\nRuns form-associated validity checks.",
           "parameters": [],
           "return": "boolean"
         },
         {
           "name": "collapseAll",
-          "description": null,
+          "description": "Collapses every expanded branch node.\n\nCollapses every expanded branch node.",
           "parameters": [],
           "return": "void"
         },
@@ -2795,11 +2954,29 @@
           "return": "void"
         },
         {
-          "name": "expandAll",
+          "name": "disconnectedCallback",
           "description": null,
           "parameters": [],
           "return": "void"
         },
+        {
+          "name": "expandAll",
+          "description": "Expands every currently indexed branch node.\n\nExpands every currently indexed branch node.",
+          "parameters": [],
+          "return": "void"
+        },
+        {
+          "name": "focus",
+          "description": "Focuses the active/selected row, or first visible row as fallback.",
+          "parameters": [
+            {
+              "name": "options",
+              "type": "FocusOptions",
+              "description": null
+            }
+          ],
+          "return": "void"
+        },
         {
           "name": "formAssociatedCallback",
           "description": null,
@@ -2840,29 +3017,35 @@
         },
         {
           "name": "getSelectedNode",
-          "description": null,
+          "description": "Backward-compatible accessor for `selectedNode`.\n\nBackward-compatible accessor for `selectedNode`.",
           "parameters": [],
-          "return": "any"
+          "return": "PdsTreeviewNode | null"
+        },
+        {
+          "name": "getSelectedNodes",
+          "description": "Backward-compatible accessor for `selectedNodes`.\n\nBackward-compatible accessor for `selectedNodes`.",
+          "parameters": [],
+          "return": "PdsTreeviewNode[]"
         },
         {
           "name": "refresh",
-          "description": null,
+          "description": "Reloads tree data from settings/source and re-renders the component.\n\nReloads tree data from settings/source and re-renders the component.",
           "parameters": [],
           "return": "Promise<void>"
         },
         {
           "name": "reportValidity",
-          "description": null,
+          "description": "Runs and reports form-associated validity checks.\n\nRuns and reports form-associated validity checks.",
           "parameters": [],
           "return": "boolean"
         },
         {
           "name": "selectById",
-          "description": null,
+          "description": "Selects a node by node id.\n\nSelects a node by node id.",
           "parameters": [
             {
               "name": "id",
-              "type": "any",
+              "type": "string",
               "description": null,
               "optional": false
             }
@@ -2871,11 +3054,24 @@
         },
         {
           "name": "selectByValue",
-          "description": null,
+          "description": "Selects the first node whose `value` matches.\n\nSelects the first node whose `value` matches.",
           "parameters": [
             {
               "name": "value",
-              "type": "any",
+              "type": "string | number | null | undefined",
+              "description": null,
+              "optional": false
+            }
+          ],
+          "return": "boolean"
+        },
+        {
+          "name": "selectByValues",
+          "description": "Selects multiple nodes by value.\r\n\r\nIn single-select mode, only the first resolved value is selected.\n\nSelects multiple nodes by value.\n\nIn single-select mode, only the first resolved value is selected.",
+          "parameters": [
+            {
+              "name": "values",
+              "type": "Array<string | number>",
               "description": null,
               "optional": false
             }
@@ -2932,8 +3128,8 @@
     "pds-upload": {
       "tag": "pds-upload",
       "className": "UploadArea",
-      "displayName": "Pds Upload",
-      "storyTitle": "Components/Pds Upload",
+      "displayName": "pds-upload",
+      "storyTitle": "Components/pds-upload",
       "category": "Components",
       "description": "Drag-and-drop file uploader that participates in native forms.\n\nDrag-and-drop file uploader that participates in native forms.",
       "docsDescription": "File upload with preview and validation",
@@ -5543,9 +5739,9 @@
   "storyIndex": {
     "pds-calendar": {
       "slug": "pds-calendar",
-      "storyTitle": "Components/Pds Calendar",
+      "storyTitle": "Components/pds-calendar",
       "category": "Components",
-      "name": "Pds Calendar",
+      "name": "pds-calendar",
       "description": "A fully featured calendar component with month navigation, event display, and expandable day views",
       "tags": [
         "autodocs",
@@ -5591,6 +5787,14 @@
           "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",
@@ -5614,9 +5818,9 @@
     },
     "pds-drawer": {
       "slug": "pds-drawer",
-      "storyTitle": "Components/Pds Drawer",
+      "storyTitle": "Components/pds-drawer",
       "category": "Components",
-      "name": "Pds Drawer",
+      "name": "pds-drawer",
       "description": "Slide-out panels from any edge",
       "tags": [
         "autodocs",
@@ -5661,9 +5865,9 @@
     },
     "pds-fab": {
       "slug": "pds-fab",
-      "storyTitle": "Components/Pds Fab",
+      "storyTitle": "Components/pds-fab",
       "category": "Components",
-      "name": "Pds Fab",
+      "name": "pds-fab",
       "description": "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",
       "tags": [
         "action",
@@ -5726,9 +5930,9 @@
     },
     "pds-icon": {
       "slug": "pds-icon",
-      "storyTitle": "Components/Pds Icon",
+      "storyTitle": "Components/pds-icon",
       "category": "Components",
-      "name": "Pds Icon",
+      "name": "pds-icon",
       "description": null,
       "tags": [
         "autodocs",
@@ -5760,9 +5964,9 @@
     },
     "pds-omnibox": {
       "slug": "pds-omnibox",
-      "storyTitle": "Components/Pds Omnibox",
+      "storyTitle": "Components/pds-omnibox",
       "category": "Components",
-      "name": "Pds Omnibox",
+      "name": "pds-omnibox",
       "description": "Omnibox search input with PDS styling and form association",
       "tags": [
         "autocomplete",
@@ -5788,9 +5992,9 @@
     },
     "pds-richtext": {
       "slug": "pds-richtext",
-      "storyTitle": "Components/Pds Richtext",
+      "storyTitle": "Components/pds-richtext",
       "category": "Components",
-      "name": "Pds Richtext",
+      "name": "pds-richtext",
       "description": "Rich text editor with markdown support and formatting toolbar. Provide a #showdown import-map entry for best performance; set format=\"markdown\" to keep submitted values as Markdown.",
       "tags": [
         "autodocs",
@@ -5829,9 +6033,9 @@
     },
     "pds-scrollrow": {
       "slug": "pds-scrollrow",
-      "storyTitle": "Components/Pds Scrollrow",
+      "storyTitle": "Components/pds-scrollrow",
       "category": "Components",
-      "name": "Pds Scrollrow",
+      "name": "pds-scrollrow",
       "description": "Horizontal scrolling container with navigation buttons",
       "tags": [
         "autodocs",
@@ -5861,9 +6065,9 @@
     },
     "pds-splitpanel": {
       "slug": "pds-splitpanel",
-      "storyTitle": "Components/Pds Splitpanel",
+      "storyTitle": "Components/pds-splitpanel",
       "category": "Components",
-      "name": "Pds Splitpanel",
+      "name": "pds-splitpanel",
       "description": "Split panels divide content areas with a draggable divider for resizable layouts.",
       "tags": [
         "autodocs",
@@ -5929,9 +6133,9 @@
     },
     "pds-theme": {
       "slug": "pds-theme",
-      "storyTitle": "Components/Pds Theme",
+      "storyTitle": "Components/pds-theme",
       "category": "Components",
-      "name": "Pds Theme",
+      "name": "pds-theme",
       "description": null,
       "tags": [
         "appearance",
@@ -5956,9 +6160,9 @@
     },
     "pds-toaster": {
       "slug": "pds-toaster",
-      "storyTitle": "Components/Pds Toaster",
+      "storyTitle": "Components/pds-toaster",
       "category": "Components",
-      "name": "Pds Toaster",
+      "name": "pds-toaster",
       "description": "Toast notification system with auto-dismiss and stacking. Toast notifications appear in the top-right corner and auto-dismiss after a few seconds based on message length.",
       "tags": [
         "alert",
@@ -5990,9 +6194,9 @@
     },
     "pds-treeview": {
       "slug": "pds-treeview",
-      "storyTitle": "Components/Pds Treeview",
+      "storyTitle": "Components/pds-treeview",
       "category": "Components",
-      "name": "Pds Treeview",
+      "name": "pds-treeview",
       "description": "Accessible treeview with nested structure rendering, keyboard navigation, and optional form-associated selection.",
       "tags": [
         "autodocs",
@@ -6018,9 +6222,9 @@
     },
     "pds-upload": {
       "slug": "pds-upload",
-      "storyTitle": "Components/Pds Upload",
+      "storyTitle": "Components/pds-upload",
       "category": "Components",
-      "name": "Pds Upload",
+      "name": "pds-upload",
       "description": "File upload with preview and validation",
       "tags": [
         "autodocs",
@@ -6057,9 +6261,9 @@
     },
     "accordion": {
       "slug": "accordion",
-      "storyTitle": "Enhancements/Accordion",
+      "storyTitle": "Enhancements/.accordion",
       "category": "Enhancements",
-      "name": "Accordion",
+      "name": ".accordion",
       "description": null,
       "tags": [
         "accordion",
@@ -6080,11 +6284,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\Accordion.stories.js"
       ]
     },
-    "button-working": {
-      "slug": "button-working",
-      "storyTitle": "Enhancements/Button Working",
+    "button-a-class": {
+      "slug": "button-a-class",
+      "storyTitle": "Enhancements/button, a[class*=",
       "category": "Enhancements",
-      "name": "Button Working",
+      "name": "button, a[class*=",
       "description": null,
       "tags": [
         "button",
@@ -6111,11 +6315,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\ButtonWorking.stories.js"
       ]
     },
-    "clip": {
-      "slug": "clip",
-      "storyTitle": "Enhancements/Clip",
+    "data-clip": {
+      "slug": "data-clip",
+      "storyTitle": "Enhancements/[data-clip]",
       "category": "Enhancements",
-      "name": "Clip",
+      "name": "[data-clip]",
       "description": null,
       "tags": [
         "clamp",
@@ -6142,11 +6346,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\Clip.stories.js"
       ]
     },
-    "color-input": {
-      "slug": "color-input",
-      "storyTitle": "Enhancements/Color Input",
+    "label-data-color": {
+      "slug": "label-data-color",
+      "storyTitle": "Enhancements/label[data-color]",
       "category": "Enhancements",
-      "name": "Color Input",
+      "name": "label[data-color]",
       "description": null,
       "tags": [
         "color",
@@ -6165,11 +6369,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\ColorInput.stories.js"
       ]
     },
-    "dropdowns": {
-      "slug": "dropdowns",
-      "storyTitle": "Enhancements/Dropdowns",
+    "nav-data-dropdown": {
+      "slug": "nav-data-dropdown",
+      "storyTitle": "Enhancements/nav[data-dropdown]",
       "category": "Enhancements",
-      "name": "Dropdowns",
+      "name": "nav[data-dropdown]",
       "description": null,
       "tags": [
         "data-dropdown",
@@ -6198,11 +6402,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\Dropdowns.stories.js"
       ]
     },
-    "open-groups": {
-      "slug": "open-groups",
-      "storyTitle": "Enhancements/Open Groups",
+    "fieldset-role-group-data-open": {
+      "slug": "fieldset-role-group-data-open",
+      "storyTitle": "Enhancements/fieldset[role=group][data-open]",
       "category": "Enhancements",
-      "name": "Open Groups",
+      "name": "fieldset[role=group][data-open]",
       "description": null,
       "tags": [
         "checkbox",
@@ -6233,11 +6437,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\OpenGroups.stories.js"
       ]
     },
-    "range-sliders": {
-      "slug": "range-sliders",
-      "storyTitle": "Enhancements/Range Sliders",
+    "input-type": {
+      "slug": "input-type",
+      "storyTitle": "Enhancements/input[type=",
       "category": "Enhancements",
-      "name": "Range Sliders",
+      "name": "input[type=",
       "description": null,
       "tags": [
         "enhancement",
@@ -6262,11 +6466,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\RangeSliders.stories.js"
       ]
     },
-    "required-fields": {
-      "slug": "required-fields",
-      "storyTitle": "Enhancements/Required Fields",
+    "form-data-required": {
+      "slug": "form-data-required",
+      "storyTitle": "Enhancements/form[data-required]",
       "category": "Enhancements",
-      "name": "Required Fields",
+      "name": "form[data-required]",
       "description": null,
       "tags": [
         "asterisk",
@@ -6295,11 +6499,11 @@
         "packages\\pds-storybook\\stories\\enhancements\\RequiredFields.stories.js"
       ]
     },
-    "toggles": {
-      "slug": "toggles",
-      "storyTitle": "Enhancements/Toggles",
+    "label-data-toggle": {
+      "slug": "label-data-toggle",
+      "storyTitle": "Enhancements/label[data-toggle]",
       "category": "Enhancements",
-      "name": "Toggles",
+      "name": "label[data-toggle]",
       "description": null,
       "tags": [
         "checkbox",
@@ -6557,48 +6761,6 @@
         "packages\\pds-storybook\\stories\\foundations\\SmartSurfaces.stories.js"
       ]
     },
-    "spacing": {
-      "slug": "spacing",
-      "storyTitle": "Foundations/Spacing",
-      "category": "Foundations",
-      "name": "Spacing",
-      "description": "Spacing tokens ensure consistent rhythm, balance, and hierarchy across layouts.",
-      "tags": [
-        "gap",
-        "layout",
-        "margin",
-        "padding",
-        "rhythm",
-        "scale",
-        "spacing",
-        "tokens"
-      ],
-      "pdsParameters": {
-        "tags": [
-          "spacing",
-          "gap",
-          "padding",
-          "margin",
-          "rhythm",
-          "tokens",
-          "layout",
-          "scale"
-        ]
-      },
-      "stories": [
-        {
-          "exportName": "SpacingScale",
-          "name": "Spacing Scale",
-          "id": "foundations-spacing--spacing-scale",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\foundations\\Spacing.stories.js"
-        }
-      ],
-      "files": [
-        "packages\\pds-storybook\\stories\\foundations\\Spacing.stories.js"
-      ]
-    },
     "typography": {
       "slug": "typography",
       "storyTitle": "Foundations/Typography",
@@ -7011,84 +7173,9 @@
       "storyTitle": "Primitives/Form Elements",
       "category": "Primitives",
       "name": "Form Elements",
-      "description": "Standard HTML form controls styled by PDS. \n\n**💡 For modern apps, consider using [pds-form](/story/components-pds-form--simple-form)** - a powerful web component that automatically generates forms from JSON Schema with built-in validation, conditional logic, and data binding.\n\nThese primitive form controls provide the foundation for manual form building when you need full control over the markup.",
-      "tags": [
-        "buttons",
-        "forms"
-      ],
-      "pdsParameters": {
-        "tags": [
-          "buttons",
-          "forms"
-        ]
-      },
-      "stories": [
-        {
-          "exportName": "Default",
-          "name": "Default",
-          "id": "primitives-form-elements--default",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\primitives\\FormElements.stories.js"
-        },
-        {
-          "exportName": "InputsWithIcons",
-          "name": "InputsWithIcons",
-          "id": "primitives-form-elements--inputs-with-icons",
-          "tags": [],
-          "description": "Input fields can be enhanced with icons to provide visual context. Use the `input-icon` class wrapper and position icons at the start (default) or end (`input-icon-end`) of the input.",
-          "source": "packages\\pds-storybook\\stories\\primitives\\FormElements.stories.js"
-        }
-      ],
-      "files": [
-        "packages\\pds-storybook\\stories\\primitives\\FormElements.stories.js"
-      ]
-    },
-    "html-form-elements": {
-      "slug": "html-form-elements",
-      "storyTitle": "Primitives/HTML Form Elements",
-      "category": "Primitives",
-      "name": "HTML Form Elements",
-      "description": "Standard HTML form controls styled by PDS. \n\n**💡 For modern apps, consider using [pds-form](/story/components-pds-form--simple-form)** - a powerful web component that automatically generates forms from JSON Schema with built-in validation, conditional logic, and data binding.\n\nThese primitive form controls provide the foundation for manual form building when you need full control over the markup.",
-      "tags": [
-        "buttons",
-        "forms"
-      ],
-      "pdsParameters": {
-        "tags": [
-          "buttons",
-          "forms"
-        ]
-      },
-      "stories": [
-        {
-          "exportName": "Default",
-          "name": "Default",
-          "id": "primitives-html-form-elements--default",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\primitives\\HtmlFormElements.stories.js"
-        },
-        {
-          "exportName": "InputsWithIcons",
-          "name": "InputsWithIcons",
-          "id": "primitives-html-form-elements--inputs-with-icons",
-          "tags": [],
-          "description": "Input fields can be enhanced with icons to provide visual context. Use the `input-icon` class wrapper and position icons at the start (default) or end (`input-icon-end`) of the input.",
-          "source": "packages\\pds-storybook\\stories\\primitives\\HtmlFormElements.stories.js"
-        }
-      ],
-      "files": [
-        "packages\\pds-storybook\\stories\\primitives\\HtmlFormElements.stories.js"
-      ]
-    },
-    "html-form-groups": {
-      "slug": "html-form-groups",
-      "storyTitle": "Primitives/HTML Form Groups",
-      "category": "Primitives",
-      "name": "HTML Form Groups",
       "description": "Accessible radio groups and checkbox groups with proper ARIA attributes and semantic HTML.\r\n\r\n## Unified Styling\r\n\r\nRadio groups (\\",
       "tags": [
+        "buttons",
         "checkbox",
         "forms",
         "grouping",
@@ -7104,6 +7191,8 @@
       },
       "stories": [],
       "files": [
+        "packages\\pds-storybook\\stories\\primitives\\FormElements.stories.js",
+        "packages\\pds-storybook\\stories\\primitives\\HtmlFormElements.stories.js",
         "packages\\pds-storybook\\stories\\primitives\\HtmlFormGroups.stories.js"
       ]
     },
@@ -7261,7 +7350,16 @@
           "pds-toast"
         ]
       },
-      "stories": [],
+      "stories": [
+        {
+          "exportName": "PDSParse",
+          "name": "PDS.parse()",
+          "id": "pds-pds-object--pdsparse",
+          "tags": [],
+          "description": null,
+          "source": "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js"
+        }
+      ],
       "files": [
         "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js",
         "packages\\pds-storybook\\stories\\utils\\PdsToast.stories.js"