@pure-ds/storybook 0.5.41 → 0.5.42

package/.storybook/addons/html-preview/preview.js

@@ -256,11 +256,7 @@ function generatePdsFabMarkup(fabElement) {
   });
 
   if (Array.isArray(fabElement.satellites) && fabElement.satellites.length > 0) {
-    const satellitesSource =
-      fabElement.getAttribute?.('data-satellites-source') ||
-      fabElement.dataset?.satellitesSource ||
-      null;
-    attrs.push(satellitesSource || '.satellites=${satellites}');
+    attrs.push('${lazyProps({ satellites })}');
   }
 
   const formattedAttrs = attrs.length > 0
@@ -280,6 +276,7 @@ function generatePdsFabMarkup(fabElement) {
 export const withHTMLExtractor = (storyFn, context) => {
   const story = storyFn();
   const channel = addons.getChannel();
+  let fabRetryCount = 0;
   
   // Function to extract and send HTML
   const extractAndSendHTML = async () => {
@@ -302,6 +299,17 @@ export const withHTMLExtractor = (storyFn, context) => {
         const alerts = Array.from(container.querySelectorAll('.callout'));
         let markup = '';
 
+        if (pdsFabElements.length > 0) {
+          const missingSatellites = pdsFabElements.some((fab) => !fab.satellites || fab.satellites.length === 0);
+          if (missingSatellites && fabRetryCount < 3) {
+            fabRetryCount += 1;
+            customElements.whenDefined('pds-fab').then(() => {
+              setTimeout(extractAndSendHTML, 100 * fabRetryCount);
+            });
+            return;
+          }
+        }
+
         // Include any alert/info boxes before the form
         if (alerts.length > 0) {
           alerts.forEach(alert => {

package/.storybook/manager.js

@@ -605,6 +605,8 @@ function matchesOntology(item, expandedTerms) {
 addons.register(ADDON_ID, (api) => {
   let currentQuery = '';
 
+  const reorderPdsObjectChildren = () => {};
+
   const updateIndicator = (active, terms, noMatches = false) => {
     let indicator = document.getElementById('pds-ontology-indicator');
     if (!indicator) {
@@ -736,6 +738,8 @@ addons.register(ADDON_ID, (api) => {
       const tree = document.getElementById('storybook-explorer-tree');
       const hasVisibleItems = tree && tree.querySelector('[data-highlightable="true"]');
       updateIndicator(true, expandedTerms, !hasVisibleItems);
+
+      reorderPdsObjectChildren();
       
       document.querySelectorAll('#storybook-explorer-menu ol').forEach(ol => {
         ol.style.display = 'none';
@@ -743,6 +747,10 @@ addons.register(ADDON_ID, (api) => {
     }, 100);
   };
 
+  api.on(STORY_CHANGED, () => {
+    setTimeout(reorderPdsObjectChildren, 0);
+  });
+
   const hookSearch = () => {
     const searchField = document.getElementById('storybook-explorer-searchfield');
     if (!searchField) {

package/.storybook/preview.js

@@ -1391,29 +1391,9 @@ const preview = {
           'About PDS',
           ['What Is PDS', 'Getting Started'],
           'PDS',
-          [
-            'About PDS',
-            ['What Is PDS', 'Getting Started'],
-            'Foundations',
-            ['Colors', 'Typography', 'HTML Defaults', 'Icons', 'Spacing', 'Smart Surfaces'],
-            'Primitives',
-            ['Buttons', 'Forms', 'Form Groups', 'Alerts', 'Badges', 'Cards', 'Tables', 'Media', 'Accordion'],
-            'Layout',
-            ['Overview', 'System'],
-            'Utilities',
-            ['Grid System'],
-            'Patterns',
-            ['Border Effects', 'Utilities'],
-            'Enhancements',
-            ['Mesh Gradients', 'Interactive States', 'Toggles', 'Dropdowns', 'Range Sliders', 'Required Fields'],
-            'Components',
-            ['pds-form', 'Pds Icon', 'Pds Drawer', 'Pds Toaster', 'Pds Tabstrip', 'Pds Splitpanel', 'Pds Scrollrow', 'Pds Richtext', 'Pds Upload'],
-            'Reference'
-          ],
-          'About PDS',
-          ['What is PDS', 'Getting Started'],
+          ['PDS Object', ['Docs', 'PDS.ask()', 'PDS.toast()', 'PDS.parse()']],
           'Foundations',
-          ['Colors', 'Typography', 'HTML Defaults', 'Icons', 'Spacing', 'Smart Surfaces'],
+          ['Colors', 'Typography', 'HTML Defaults', 'Icons', 'Spacing', 'Smart Surfaces', 'Backdrop'],
           'Primitives',
           ['Buttons', 'Forms', 'Form Groups', 'Alerts', 'Badges', 'Cards', 'Tables', 'Media', 'Accordion'],
           'Layout',

package/dist/pds-reference.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-01-30T12:08:42.136Z",
+  "generatedAt": "2026-01-31T10:14:59.283Z",
   "sources": {
     "customElements": "custom-elements.json",
     "ontology": "src\\js\\pds-core\\pds-ontology.js",
@@ -6767,8 +6767,8 @@
     },
     "backdrop": {
       "slug": "backdrop",
-      "storyTitle": "Utilities/Backdrop",
-      "category": "Utilities",
+      "storyTitle": "Foundations/Backdrop",
+      "category": "Foundations",
       "name": "Backdrop",
       "description": "Backdrop utilities for modal overlays, drawers, and lightboxes. Provides consistent blur and dimming effects with light/dark variants.",
       "tags": [
@@ -6791,73 +6791,76 @@
         "packages\\pds-storybook\\stories\\utilities\\Backdrop.stories.js"
       ]
     },
-    "pds-ask": {
-      "slug": "pds-ask",
-      "storyTitle": "Utilities/PDS ask",
-      "category": "Utilities",
-      "name": "PDS ask",
-      "description": "The `PDS.ask()` helper wraps the native `<dialog>` element with PDS styling and a promise-based API.\nUse it to collect quick confirmations or to stage entire forms before committing data back to the host application.",
+    "pds-object": {
+      "slug": "pds-object",
+      "storyTitle": "PDS/PDS Object",
+      "category": "PDS",
+      "name": "PDS Object",
+      "description": "Use <code>PDS.toast()</code> to show non-blocking notifications. The helper ensures a <code>pds-toaster</code> instance exists before displaying the message.",
       "tags": [
         "alert",
+        "api",
+        "autodocs",
         "confirm",
         "dialog",
         "dialogs",
+        "feedback",
         "forms",
         "interaction",
         "modal",
+        "notifications",
         "overlay",
+        "parse",
+        "pds",
         "pds-ask",
+        "pds-parse",
+        "pds-toast",
         "popup",
-        "prompt"
+        "prompt",
+        "reference",
+        "runtime",
+        "toast",
+        "utilities"
       ],
       "pdsParameters": {
         "tags": [
-          "interaction",
-          "dialogs",
-          "forms",
-          "pds-ask",
-          "modal",
-          "alert",
-          "confirm",
-          "prompt"
+          "toast",
+          "notifications",
+          "feedback",
+          "pds-toast"
         ]
       },
       "stories": [
         {
-          "exportName": "BareConfirm",
-          "name": "Are you sure?",
-          "id": "utilities-pds-ask--bare-confirm",
+          "exportName": "PDSAsk",
+          "name": "PDS.ask()",
+          "id": "pds-pds-object--pdsask",
           "tags": [],
           "description": null,
           "source": "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js"
         },
         {
-          "exportName": "QuickConfirm",
-          "name": "Boolean confirm flow",
-          "id": "utilities-pds-ask--quick-confirm",
+          "exportName": "PDSParse",
+          "name": "PDS.parse()",
+          "id": "pds-pds-object--pdsparse",
           "tags": [],
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js"
+          "source": "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js"
         },
         {
-          "exportName": "formSubdialog",
-          "name": "Embed a pds-form subform",
-          "id": "utilities-pds-ask--form-subdialog",
+          "exportName": "PDSToast",
+          "name": "PDS.toast()",
+          "id": "pds-pds-object--pdstoast",
           "tags": [],
           "description": null,
-          "source": "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js"
-        },
-        {
-          "exportName": "MiniForm",
-          "name": "Mini form submission",
-          "id": "utilities-pds-ask--mini-form",
-          "tags": [],
-          "description": null,
-          "source": "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js"
+          "source": "packages\\pds-storybook\\stories\\utils\\PdsToast.stories.js"
         }
       ],
       "files": [
-        "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js"
+        "packages\\pds-storybook\\stories\\utils\\PdsAsk.stories.js",
+        "packages\\pds-storybook\\stories\\utils\\PdsParse.stories.js",
+        "packages\\pds-storybook\\stories\\utils\\PdsRuntime.stories.js",
+        "packages\\pds-storybook\\stories\\utils\\PdsToast.stories.js"
       ]
     },
     "what-is-pds": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pure-ds/storybook",
-  "version": "0.5.41",
+  "version": "0.5.42",
   "description": "Storybook showcase for Pure Design System with live configuration",
   "type": "module",
   "private": false,
@@ -38,7 +38,7 @@
     "pds:build-icons": "pds-build-icons"
   },
   "peerDependencies": {
-    "@pure-ds/core": "^0.5.41"
+    "@pure-ds/core": "^0.5.42"
   },
   "dependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",