@pure-ds/core 0.7.57 → 0.7.59

package/public/assets/pds/custom-elements.json

@@ -224,6 +224,18 @@
                 "text": "CustomEvent"
               }
             },
+            {
+              "name": "day-click",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "task-click",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "month-rendered",
               "type": {
@@ -237,6 +249,14 @@
             {
               "description": "Dispatched when the visible month/year changes",
               "name": "pds-calendar#month-change"
+            },
+            {
+              "description": "Dispatched when a day cell is selected from the calendar grid",
+              "name": "pds-calendar#day-click"
+            },
+            {
+              "description": "Dispatched when a task item is clicked",
+              "name": "pds-calendar#task-click"
             }
           ],
           "attributes": [
@@ -1145,6 +1165,10 @@
             {
               "description": "Animation duration (default: 420ms)",
               "name": "--transition-duration"
+            },
+            {
+              "description": "FAB z-index when used inside pds-drawer (default: var(--z-popover))",
+              "name": "--z-fab-in-drawer"
             }
           ],
           "cssParts": [
@@ -1204,19 +1228,48 @@
             {
               "kind": "field",
               "name": "startAngle",
-              "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)",
+              "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": {
                 "text": "number"
               },
               "default": "180 (or auto-detected)",
               "attribute": "start-angle"
             },
+            {
+              "kind": "field",
+              "name": "behavior",
+              "description": "Interaction mode for satellite menu.\r\n- click: toggles satellites when main FAB is clicked\r\n- hover: opens on hover/focus and closes when pointer leaves safe area",
+              "type": {
+                "text": "'click'|'hover'"
+              },
+              "default": "click",
+              "attribute": "behavior"
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "description": "Layout mode for host positioning.\r\n- fixed: FAB is anchored to viewport bottom-right\r\n- inline: FAB participates in normal document flow",
+              "type": {
+                "text": "'fixed'|'inline'"
+              },
+              "default": "fixed",
+              "attribute": "mode"
+            },
+            {
+              "kind": "field",
+              "name": "fabClass",
+              "description": "Space-separated class list forwarded to the internal button.\r\nUse this instead of host classes for btn-* and icon-only.",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "fab-class"
+            },
             {
               "kind": "field",
               "name": "satellites",
               "description": "Array of satellite button configurations",
               "type": {
-                "text": "Array<{key: string, icon?: string, label?: string, action?: string}>"
+                "text": "Array<{key: string, icon?: string, iconColor?: string, bgColor?: string, iconSize?: string, label?: string, action?: string}>"
               }
             }
           ],
@@ -1258,12 +1311,38 @@
             },
             {
               "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)",
+              "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": {
                 "text": "number"
               },
               "default": "180 (or auto-detected)",
               "fieldName": "startAngle"
+            },
+            {
+              "name": "behavior",
+              "description": "Interaction mode for opening satellites (default: click)",
+              "type": {
+                "text": "\"click\"|\"hover\""
+              },
+              "default": "click",
+              "fieldName": "behavior"
+            },
+            {
+              "name": "mode",
+              "description": "Layout mode for FAB positioning (default: fixed)",
+              "type": {
+                "text": "\"fixed\"|\"inline\""
+              },
+              "default": "fixed",
+              "fieldName": "mode"
+            },
+            {
+              "name": "fab-class",
+              "description": "Space-separated class list forwarded to the internal button.\r\nUse this instead of host classes for btn-* and icon-only.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "fabClass"
             }
           ],
           "superclass": {
@@ -1405,7 +1484,6 @@
               "type": {
                 "text": "string"
               },
-              "default": "\"Submit\"",
               "attribute": "submit-label"
             },
             {
@@ -1415,7 +1493,6 @@
               "type": {
                 "text": "string"
               },
-              "default": "\"Reset\"",
               "attribute": "reset-label"
             },
             {
@@ -1543,7 +1620,6 @@
               "type": {
                 "text": "string"
               },
-              "default": "\"Submit\"",
               "fieldName": "submitLabel"
             },
             {
@@ -1551,7 +1627,6 @@
               "type": {
                 "text": "string"
               },
-              "default": "\"Reset\"",
               "fieldName": "resetLabel"
             },
             {
@@ -2812,6 +2887,274 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "public/assets/pds/components/pds-locale.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Locale switcher component.\r\n\r\nThe component only persists canonical 5-letter locale tags (`xx-YY`),\r\nfor example `en-US` and `nl-NL`.",
+          "name": "PdsLocale",
+          "members": [
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "default": "true"
+            },
+            {
+              "kind": "method",
+              "name": "formAssociatedCallback"
+            },
+            {
+              "kind": "method",
+              "name": "formDisabledCallback",
+              "parameters": [
+                {
+                  "name": "disabled"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
+            {
+              "kind": "method",
+              "name": "formStateRestoreCallback",
+              "parameters": [
+                {
+                  "name": "state"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity"
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity"
+            },
+            {
+              "kind": "field",
+              "name": "form",
+              "readonly": true,
+              "type": {
+                "text": "HTMLFormElement|null"
+              },
+              "description": "Associated form element."
+            },
+            {
+              "kind": "field",
+              "name": "labels",
+              "readonly": true,
+              "type": {
+                "text": "NodeListOf<HTMLLabelElement>|null"
+              },
+              "description": "Associated labels."
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "readonly": true,
+              "type": {
+                "text": "string"
+              },
+              "description": "Form control type."
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "readonly": true,
+              "type": {
+                "text": "ValidityState|null"
+              },
+              "description": "Current validity state."
+            },
+            {
+              "kind": "field",
+              "name": "validationMessage",
+              "readonly": true,
+              "type": {
+                "text": "string"
+              },
+              "description": "Current validation message."
+            },
+            {
+              "kind": "field",
+              "name": "willValidate",
+              "readonly": true,
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the control participates in validation."
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "Form field name."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "Selected canonical locale tag (`xx-YY`)."
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether a value is required."
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether interaction is disabled."
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "\"compact\"|\"full\""
+              },
+              "description": "Label display mode."
+            },
+            {
+              "kind": "method",
+              "name": "whenReady",
+              "description": "Resolves once the first availability check is complete.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "available",
+              "description": "Whether locale switching is currently available.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "refresh",
+              "description": "Re-detect available locales and re-render.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "input",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Native-like input event when user selection changes."
+            },
+            {
+              "name": "change",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Native-like change event when user selection changes."
+            },
+            {
+              "name": "pds-locale:ready",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Emitted after locale availability is resolved."
+            },
+            {
+              "description": "Emitted after a new locale is selected.",
+              "name": "pds:locale:changed"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "Form field name used during submit."
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "Selected canonical locale tag (`xx-YY`)."
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Requires a locale value for validity."
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Disables interaction and omits form value."
+            },
+            {
+              "name": "mode",
+              "type": {
+                "text": "\"compact\"|\"full\""
+              },
+              "description": "Label display mode. In `compact`, the UI shows 2-letter aliases and puts the full Intl language name in the `title` attribute. In `full`, it renders the full Intl language name as the visible label.",
+              "default": "\"compact\""
+            },
+            {
+              "name": "data-label",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the locale radio group."
+            }
+          ],
+          "superclass": {
+            "name": "HTMLElement"
+          },
+          "tagName": "pds-locale",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "pds-locale",
+          "declaration": {
+            "name": "PdsLocale",
+            "module": "public/assets/pds/components/pds-locale.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "public/assets/pds/components/pds-omnibox.js",
@@ -4206,7 +4549,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Form-associated multi-select tags control built on top of `pds-omnibox`.\r\n\r\nUsers select suggestions from the omnibox and each selection is rendered as a removable\r\nchip. The component keeps selection state synchronized across:\r\n- the `value` attribute (comma-separated ids)\r\n- the `value` property (`string[]`)\r\n- form value via ElementInternals\r\n\r\nIf `settings` is not provided, the component derives omnibox categories from `options`.\r\nWhen `required` is set, at least one selected value is required for validity.",
+          "description": "Form-associated multi-select tags control built on top of `pds-omnibox`.\r\n\r\nUsers select suggestions from the omnibox and each selection is rendered as a removable\r\nchip. The component keeps selection state synchronized across:\r\n- the `value` attribute (comma-separated ids)\r\n- the `value` property (`string[]`)\r\n- form value via ElementInternals\r\n\r\nThe `options` object uses the same structure as `pds-omnibox.settings`.\r\nSee `pds-omnibox` JSDoc for the full options schema.\r\nBefore applying it, the component deep-merges internal defaults:\r\n- `hideCategory: true`\r\n- `itemGrid: \"0 1fr 0\"`\r\n- `iconHandler: () => \"\"`\r\n\r\nWhen `required` is set, at least one selected value is required for validity.",
           "name": "PdsTags",
           "members": [
             {
@@ -4230,17 +4573,9 @@
               "kind": "field",
               "name": "options",
               "type": {
-                "text": "Array<string|Object>"
-              },
-              "description": "Option source used to build omnibox suggestions"
-            },
-            {
-              "kind": "field",
-              "name": "settings",
-              "type": {
-                "text": "Object|null"
+                "text": "PdsOmniboxSettings|null"
               },
-              "description": "Omnibox-compatible settings source"
+              "description": "Omnibox options object (see `pds-omnibox.js` typedef)"
             },
             {
               "kind": "field",
@@ -4332,14 +4667,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "JSON array of options (`string[]` or object[] with id/text metadata)"
-            },
-            {
-              "name": "settings",
-              "type": {
-                "text": "string"
-              },
-              "description": "JSON omnibox settings; takes precedence over derived options settings"
+              "description": "JSON object with the same shape as `pds-omnibox.settings`"
             },
             {
               "name": "disabled",
@@ -4443,7 +4771,7 @@
                   "description": "Toast configuration",
                   "optional": true,
                   "type": {
-                    "text": "@param {\"information\"|\"success\"|\"warning\"|\"error\"} [options.type=\"information\"] - Toast type\n   * @param {number} [options.duration] - Duration in ms (auto-calculated if not provided)\n   * @param {boolean} [options.closable=true] - Whether toast can be closed manually\n   * @param {boolean} [options.persistent=false] - If true, toast doesn't auto-dismiss\n   * "
+                    "text": "@param {\"information\"|\"success\"|\"warning\"|\"error\"} [options.type=\"information\"] - Toast type\n    * @param {string} [options.title] - Optional heading text (falls back to type-based title when empty)\n   * @param {number} [options.duration] - Duration in ms (auto-calculated if not provided)\n   * @param {boolean} [options.closable=true] - Whether toast can be closed manually\n   * @param {boolean} [options.persistent=false] - If true, toast doesn't auto-dismiss\n   * @param {boolean} [options.returnToastElement=false] - If true, return the toast element instead of toast ID\n   * "
                   }
                 }
               ],
@@ -4451,7 +4779,27 @@
               "privacy": "public",
               "return": {
                 "type": {
-                  "text": "string"
+                  "text": "string|HTMLElement|null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getToastElement",
+              "parameters": [
+                {
+                  "name": "toastId",
+                  "description": "Toast ID",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Get toast element by ID.",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "HTMLElement|null"
                 }
               }
             },
@@ -4477,6 +4825,12 @@
                     "text": "\"information\"|\"success\"|\"warning\"|\"error\""
                   }
                 },
+                {
+                  "name": "title",
+                  "type": {
+                    "text": "string|null|undefined"
+                  }
+                },
                 {
                   "name": "closable",
                   "type": {

package/public/assets/pds/pds-css-complete.json

@@ -2786,7 +2786,7 @@
   ],
   "metadata": {
     "generator": "PDS CSS Data Generator",
-    "generatedAt": "2026-03-14T12:22:35.002Z",
+    "generatedAt": "2026-03-26T08:26:11.693Z",
     "totalProperties": 183,
     "totalClasses": 170,
     "totalAttributes": 6

package/public/assets/pds/vscode-custom-data.json

@@ -144,7 +144,35 @@
         },
         {
           "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)"
+          "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)"
+        },
+        {
+          "name": "behavior",
+          "description": "Interaction mode for opening satellites (default: click)",
+          "values": [
+            {
+              "name": "click"
+            },
+            {
+              "name": "hover"
+            }
+          ]
+        },
+        {
+          "name": "mode",
+          "description": "Layout mode for FAB positioning (default: fixed)",
+          "values": [
+            {
+              "name": "fixed"
+            },
+            {
+              "name": "inline"
+            }
+          ]
+        },
+        {
+          "name": "fab-class",
+          "description": "Space-separated class list forwarded to the internal button.\r\nUse this instead of host classes for btn-* and icon-only."
         }
       ]
     },

package/src/js/common/common.js

@@ -233,3 +233,77 @@ export function parseFragment(html, ...values) {
 export function parseHTML(html, ...values) {
   return parseFragment(html, ...values).childNodes;
 }
+
+export function throttle(fn, timeoutMs = 100) {
+  let handle;
+  return function throttled(...args) {
+    const fire = () => {
+      clearTimeout(handle);
+      fn(...args);
+    };
+    clearTimeout(handle);
+    handle = setTimeout(fire, timeoutMs);
+  };
+}
+
+export function enQueue(fn) {
+  setTimeout(fn, 0);
+}
+
+export function isUrl(str) {
+  try {
+    if (typeof str !== "string") return false;
+    if (str.indexOf("\n") !== -1 || str.indexOf(" ") !== -1) return false;
+    if (str.startsWith("#/")) return false;
+    const newUrl = new URL(str, window.location.origin);
+    return newUrl.protocol === "http:" || newUrl.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+
+export function withTimeout(promise, timeoutMs, label = "Operation") {
+  if (!timeoutMs || timeoutMs <= 0) return promise;
+
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      reject(new Error(`${label} timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+
+    Promise.resolve(promise)
+      .then((value) => {
+        clearTimeout(timeout);
+        resolve(value);
+      })
+      .catch((error) => {
+        clearTimeout(timeout);
+        reject(error);
+      });
+  });
+}
+
+export function escapeForRegExp(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+export function openCenteredWindow(url, width, height) {
+  const left = window.screen.width / 2 - width / 2;
+  const top = window.screen.height / 2 - height / 2;
+  return window.open(
+    url,
+    "",
+    `toolbar=no, location=no, directories=no, status=no, menubar=no, scrollbars=yes, resizable=yes, width=${width}, height=${height}, top=${top}, left=${left}`,
+  );
+}
+
+export function humanizeIdentifier(value) {
+  if (value == null) return "";
+  const input = String(value).trim();
+  if (!input) return "";
+
+  return input
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/[_-]+/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}