@pure-ds/core 0.6.10 → 0.7.1

package/public/assets/pds/components/pds-live-template-canvas.js

@@ -0,0 +1,172 @@
+import { PDS } from "#pds";
+
+const COMPONENT_TAG = "pds-live-template-canvas";
+
+let managerPromise = null;
+
+async function getManagerModule() {
+  if (managerPromise) return managerPromise;
+  managerPromise = (async () => {
+    const candidates = [
+      PDS?.currentConfig?.managerURL,
+      "../core/pds-manager.js",
+      "/assets/pds/core/pds-manager.js",
+    ].filter(Boolean);
+
+    const attempted = new Set();
+    for (const candidate of candidates) {
+      try {
+        const resolved = new URL(candidate, import.meta.url).href;
+        if (attempted.has(resolved)) continue;
+        attempted.add(resolved);
+        const mod = await import(resolved);
+        if (mod && typeof mod === "object") return mod;
+      } catch (e) {}
+    }
+
+    return null;
+  })();
+
+  return managerPromise;
+}
+
+class PdsLiveTemplateCanvas extends HTMLElement {
+  constructor() {
+    super();
+    this._templates = [];
+    this._selectedTemplateId = "";
+  }
+
+  connectedCallback() {
+    this._renderShell();
+    this._loadTemplates();
+  }
+
+  _renderShell() {
+    this.className = "stack-sm";
+    this.innerHTML = `
+      <label class="stack-xs">
+        <span>Template</span>
+        <div class="pds-live-template-omnibox"></div>
+      </label>
+      <p class="text-muted pds-live-template-description"></p>
+    `;
+
+  }
+
+  async _loadTemplates() {
+    const manager = await getManagerModule();
+    if (typeof manager?.listLiveTemplates !== "function") return;
+
+    this._templates = (await manager.listLiveTemplates()) || [];
+    this._selectedTemplateId = "";
+
+    const host = this.querySelector(".pds-live-template-omnibox");
+    if (!host) return;
+
+    host.replaceChildren();
+    try {
+      const omnibox = document.createElement("pds-omnibox");
+      omnibox.setAttribute("item-grid", "45px 1fr 0");
+      omnibox.setAttribute("placeholder", "Search canvas templates...");
+      omnibox.value = "";
+
+      const templates = this._templates;
+      omnibox.settings = {
+        hideCategory: true,
+        itemGrid: "45px 1fr 0",
+        categories: {
+          Templates: {
+            trigger: () => true,
+            getItems: (context = {}) => {
+              const query = String(context?.search || "").toLowerCase().trim();
+              return templates
+                .filter((item) => {
+                  if (!query) return true;
+                  const haystack = [item.name, item.description, ...(item.tags || [])]
+                    .join(" ")
+                    .toLowerCase();
+                  return haystack.includes(query);
+                })
+                .map((item) => ({
+                  id: item.id,
+                  text: item.name,
+                  description: item.description,
+                  icon: item.icon || "grid-four",
+                }));
+            },
+            action: (selection) => {
+              this._selectedTemplateId = selection?.id || "";
+              this._updateDescription();
+              this._applyTemplate();
+              return selection?.id || "";
+            },
+          },
+        },
+      };
+
+      omnibox.addEventListener("result-selected", (event) => {
+        const selectedId =
+          event?.detail?.id ||
+          this._templates.find((item) => item.name === event?.detail?.text)?.id ||
+          this._selectedTemplateId;
+        if (selectedId) {
+          this._selectedTemplateId = selectedId;
+        }
+        const selected = this._templates.find((item) => item.id === this._selectedTemplateId);
+        if (selected?.name) {
+          omnibox.value = selected.name;
+        }
+        this._updateDescription();
+      });
+
+      host.appendChild(omnibox);
+    } catch (error) {
+      const fallback = document.createElement("select");
+      fallback.className = "pds-live-template-select";
+      this._templates.forEach((template) => {
+        const option = document.createElement("option");
+        option.value = template.id;
+        option.textContent = template.name;
+        fallback.appendChild(option);
+      });
+      fallback.addEventListener("change", () => {
+        this._selectedTemplateId = fallback.value;
+        this._updateDescription();
+        this._applyTemplate();
+      });
+      host.appendChild(fallback);
+    }
+
+    this._updateDescription();
+  }
+
+  _updateDescription() {
+    const description = this.querySelector(".pds-live-template-description");
+    if (!description) return;
+    const selected = this._templates.find((item) => item.id === this._selectedTemplateId);
+    description.textContent = selected?.description || "";
+  }
+
+  async _applyTemplate() {
+    if (!this._selectedTemplateId) return;
+
+    const manager = await getManagerModule();
+    if (typeof manager?.runLiveImport !== "function") return;
+
+    const result = await manager.runLiveImport({
+      sourceType: "template",
+      templateId: this._selectedTemplateId,
+    });
+
+    this.dispatchEvent(
+      new CustomEvent("pds:live-template:inject", {
+        bubbles: true,
+        composed: true,
+        detail: { result, templateId: this._selectedTemplateId },
+      })
+    );
+  }
+}
+
+customElements.define(COMPONENT_TAG, PdsLiveTemplateCanvas);

package/public/assets/pds/components/pds-omnibox.js

@@ -13,6 +13,8 @@
  *
  * @property {Object} settings - AutoComplete settings object (required by consumer)
  */
+import { PDS } from "#pds";
+
 const LAYERS = ["tokens", "primitives", "components", "utilities"];
 const DEFAULT_PLACEHOLDER = "Search...";
 const DEFAULT_ICON = "magnifying-glass";
@@ -548,7 +550,15 @@ export class PdsOmnibox extends HTMLElement {
   async #handleAutoComplete(e) {
     if (!this.settings) return;
 
-    const AutoComplete = PDS.AutoComplete;
+    let AutoComplete = PDS.AutoComplete;
+    if ((!AutoComplete || typeof AutoComplete.connect !== "function") &&
+      typeof PDS.loadAutoComplete === "function") {
+      try {
+        AutoComplete = await PDS.loadAutoComplete();
+      } catch (error) {
+        return;
+      }
+    }
 
     if (AutoComplete && typeof AutoComplete.connect === "function") {
       const settings = {
@@ -648,6 +658,8 @@ export class PdsOmnibox extends HTMLElement {
     if (!suggestion) return;
     this.#suggestionsObserver = new MutationObserver(() => {
       if (!suggestion.classList.contains("ac-active")) {
+        this.removeAttribute("data-suggestions-open");
+        this.#clearSuggestionOverlayStyles(suggestion);
         this.#resetIconToDefault();
       }
     });
@@ -682,6 +694,106 @@ export class PdsOmnibox extends HTMLElement {
     this.#autoCompleteViewportHandler = null;
   }
 
+  #clearSuggestionOverlayStyles(suggestion) {
+    if (!suggestion || !suggestion.style) return;
+    suggestion.style.removeProperty("position");
+    suggestion.style.removeProperty("left");
+    suggestion.style.removeProperty("right");
+    suggestion.style.removeProperty("top");
+    suggestion.style.removeProperty("bottom");
+    suggestion.style.removeProperty("width");
+    suggestion.style.removeProperty("max-width");
+  }
+
+  #getComposedParent(node) {
+    if (!node) return null;
+    if (node.parentElement) return node.parentElement;
+    const root = node.getRootNode?.();
+    if (root && root.host) return root.host;
+    return null;
+  }
+
+  #hasTransformedAncestor(startNode) {
+    let current = startNode;
+    let safety = 0;
+    while (current && safety < 80) {
+      if (current instanceof Element) {
+        const style = getComputedStyle(current);
+        if (
+          style.transform !== "none" ||
+          style.perspective !== "none" ||
+          style.filter !== "none" ||
+          style.backdropFilter !== "none"
+        ) {
+          return true;
+        }
+      }
+      current = this.#getComposedParent(current);
+      safety += 1;
+    }
+    return false;
+  }
+
+  #shouldUseFixedSuggestionOverlay(container) {
+    if (!container) return false;
+    if (this.closest("pds-drawer, dialog")) return false;
+    return !this.#hasTransformedAncestor(this);
+  }
+
+  #positionSuggestionInline({ container, suggestion, rect, direction, offset, maxHeight }) {
+    if (!container || !suggestion) return;
+    this.#clearSuggestionOverlayStyles(suggestion);
+    if (direction === "up") {
+      suggestion.style.top = "auto";
+      suggestion.style.bottom = `${Math.round(rect.height + offset)}px`;
+    } else {
+      suggestion.style.bottom = "auto";
+      suggestion.style.top = `${Math.round(rect.height + offset)}px`;
+    }
+    container.setAttribute("data-direction", direction);
+    suggestion.setAttribute("data-direction", direction);
+    container.style.setProperty("--ac-max-height", `${maxHeight}px`);
+  }
+
+  #positionSuggestionOverlay({
+    container,
+    suggestion,
+    rect,
+    viewportHeight,
+    viewportWidth,
+    direction,
+    maxHeight,
+    gap,
+    offset,
+  }) {
+    if (!container || !suggestion || !suggestion.style) return;
+    if (suggestion.classList.contains("full-mobile")) {
+      this.#clearSuggestionOverlayStyles(suggestion);
+      return;
+    }
+
+    const clampedLeft = Math.max(gap, Math.min(rect.left, viewportWidth - rect.width - gap));
+    const clampedWidth = Math.max(0, Math.min(rect.width, viewportWidth - gap * 2));
+
+    suggestion.style.position = "fixed";
+    suggestion.style.left = `${Math.round(clampedLeft)}px`;
+    suggestion.style.width = `${Math.round(clampedWidth)}px`;
+    suggestion.style.maxWidth = `${Math.round(Math.max(0, viewportWidth - gap * 2))}px`;
+    suggestion.style.right = "auto";
+
+    if (direction === "up") {
+      suggestion.style.top = "auto";
+      suggestion.style.bottom = `${Math.round(viewportHeight - rect.top + offset)}px`;
+    } else {
+      suggestion.style.bottom = "auto";
+      suggestion.style.top = `${Math.round(rect.bottom + offset)}px`;
+    }
+
+    container.setAttribute("data-direction", direction);
+    suggestion.setAttribute("data-direction", direction);
+    container.style.setProperty("--ac-max-height", `${maxHeight}px`);
+  }
+
   #updateSuggestionMaxHeight() {
     if (!this.#input) return;
     const container = this.#input.parentElement;
@@ -696,6 +808,7 @@ export class PdsOmnibox extends HTMLElement {
       suggestion?.getAttribute("data-direction") ||
       container.getAttribute("data-direction") ||
       "down";
+    const offset = this.#readSpacingToken(container, "--ac-suggest-offset") || 0;
 
     const availableDown = viewportHeight - rect.bottom - gap;
     const availableUp = rect.top - gap;
@@ -705,8 +818,6 @@ export class PdsOmnibox extends HTMLElement {
       container.setAttribute("data-direction", direction);
       if (suggestion) suggestion.setAttribute("data-direction", direction);
       if (suggestion) {
-        const offset =
-          this.#readSpacingToken(container, "--ac-suggest-offset") || 0;
         if (direction === "up") {
           suggestion.style.top = "auto";
           suggestion.style.bottom = `${rect.height + offset}px`;
@@ -726,6 +837,39 @@ export class PdsOmnibox extends HTMLElement {
       Math.floor(Math.min(available, configuredMaxHeight)),
     );
     container.style.setProperty("--ac-max-height", `${maxHeight}px`);
+
+    const isSuggestionActive = suggestion?.classList?.contains("ac-active");
+    this.toggleAttribute("data-suggestions-open", Boolean(isSuggestionActive));
+
+    if (!suggestion || !isSuggestionActive || suggestion.classList.contains("full-mobile")) {
+      this.#clearSuggestionOverlayStyles(suggestion);
+      return;
+    }
+
+    if (!this.#shouldUseFixedSuggestionOverlay(container)) {
+      this.#positionSuggestionInline({
+        container,
+        suggestion,
+        rect,
+        direction,
+        offset,
+        maxHeight,
+      });
+      return;
+    }
+
+    const viewportWidth = window.visualViewport?.width || window.innerWidth;
+    this.#positionSuggestionOverlay({
+      container,
+      suggestion,
+      rect,
+      viewportHeight,
+      viewportWidth,
+      direction,
+      maxHeight,
+      gap,
+      offset,
+    });
   }
 
   #resolveSuggestionDirection(container) {

package/public/assets/pds/components/pds-richtext.js

@@ -1,3 +1,5 @@
+import { PDS } from "#pds";
+
 /**
  * Slack-style rich text field with a semantic output pipeline.
  *

package/public/assets/pds/components/pds-scrollrow.js

@@ -1,3 +1,5 @@
+import { PDS } from "#pds";
+
 /**
  * Horizontal scrolling row with optional heading and snap alignment controls.
  *
@@ -11,7 +13,11 @@
  *
  * @attr {string} label - Accessible label for the scroll region; also used as fallback heading copy
  * @attr {"start"|"center"} snap - Snap alignment for tiles when scrolling (default: start)
+ * @attr {string} tile-min - Minimum tile width (CSS length, e.g. "250px")
+ * @attr {string} tile-max - Maximum tile width (CSS length, e.g. "360px")
  */
+import { PDS } from "#pds";
+
 class PdsScrollrow extends HTMLElement {
   #viewport;
   #ro;
@@ -19,7 +25,7 @@ class PdsScrollrow extends HTMLElement {
   #adopted = false;
 
   static get observedAttributes() {
-    return ["label", "snap"];
+    return ["label", "snap", "tile-min", "tile-max"];
   }
 
   constructor() {
@@ -78,7 +84,7 @@ class PdsScrollrow extends HTMLElement {
   async #adopt() {
     if (this.#adopted || !this.shadowRoot) return;
     try {
-      if (window.PDS && typeof PDS.createStylesheet === 'function' && typeof PDS.adoptLayers === 'function') {
+      if (typeof PDS.createStylesheet === 'function' && typeof PDS.adoptLayers === 'function') {
         const componentSheet = PDS.createStylesheet(PdsScrollrow.#COMPONENT_CSS);
         await PDS.adoptLayers(this.shadowRoot, ['primitives','components', 'utilities'], [componentSheet]);
         this.#adopted = true;
@@ -128,6 +134,36 @@ class PdsScrollrow extends HTMLElement {
     else this.setAttribute("snap", String(val));
   }
 
+  /**
+   * Minimum tile size applied to slotted content.
+   * @returns {string|null}
+   */
+  get tileMin() {
+    return this.getAttribute("tile-min");
+  }
+  /**
+   * @param {string|null} val
+   */
+  set tileMin(val) {
+    if (val == null) this.removeAttribute("tile-min");
+    else this.setAttribute("tile-min", String(val));
+  }
+
+  /**
+   * Maximum tile size applied to slotted content.
+   * @returns {string|null}
+   */
+  get tileMax() {
+    return this.getAttribute("tile-max");
+  }
+  /**
+   * @param {string|null} val
+   */
+  set tileMax(val) {
+    if (val == null) this.removeAttribute("tile-max");
+    else this.setAttribute("tile-max", String(val));
+  }
+
   /**
    * Lifecycle hook called when the element is inserted into the document.
    */
@@ -189,6 +225,11 @@ class PdsScrollrow extends HTMLElement {
         this.#applySnap();
         break;
       }
+      case "tile-min":
+      case "tile-max": {
+        this.#applyTileSizing();
+        break;
+      }
     }
   }
 
@@ -256,6 +297,7 @@ class PdsScrollrow extends HTMLElement {
 
     // Apply initial snap alignment
     this.#applySnap();
+    this.#applyTileSizing();
 
     // Observe size changes to refresh controls
     this.#ro = new ResizeObserver(() => this.#updateControls());
@@ -274,6 +316,23 @@ class PdsScrollrow extends HTMLElement {
     }
   }
 
+  #applyTileSizing() {
+    const tileMin = this.tileMin;
+    const tileMax = this.tileMax;
+
+    if (tileMin && String(tileMin).trim()) {
+      this.style.setProperty("--tile-min", String(tileMin).trim());
+    } else {
+      this.style.removeProperty("--tile-min");
+    }
+
+    if (tileMax && String(tileMax).trim()) {
+      this.style.setProperty("--tile-max", String(tileMax).trim());
+    } else {
+      this.style.removeProperty("--tile-max");
+    }
+  }
+
   /**
    * Scroll the viewport by roughly one page in the indicated direction.
    * @param {Event} e

package/public/assets/pds/components/pds-splitpanel.js

@@ -1,3 +1,5 @@
+import { PDS } from "#pds";
+
 /**
  * @component pds-splitpanel
  * @description A split panel component that supports horizontal and vertical layouts, resizable panels, and a responsive mobile view.
@@ -300,7 +302,7 @@ class PdsSplitpanel extends HTMLElement {
 
       // Prefer PDS layers if available
       try {
-        if (window.PDS && typeof PDS.createStylesheet === "function" && typeof PDS.adoptLayers === "function") {
+            if (typeof PDS.createStylesheet === "function" && typeof PDS.adoptLayers === "function") {
           const componentStyles = PDS.createStylesheet(cssText);
           await PDS.adoptLayers(this.shadowRoot, ["primitives", "components"], [componentStyles]);
           return;

package/public/assets/pds/components/pds-theme.js

@@ -1,3 +1,5 @@
+import { PDS } from "#pds";
+
 /**
  * `<pds-theme>` exposes a zero-config theme toggle that updates `PDS.theme` and
  * keeps its UI in sync with programmatic theme changes.

package/public/assets/pds/components/pds-toaster.js

@@ -1,3 +1,5 @@
+import { PDS } from "#pds";
+
 /**
  * @element pds-toaster
  * @fires pds:toast - Global event for creating toasts
@@ -124,6 +126,14 @@ export class AppToaster extends HTMLElement {
            white-space: pre-line;
         }
 
+        aside.toast .toast-content {
+          width: 100%;
+        }
+
+        aside.toast .toast-action {
+          margin-top: var(--spacing-2);
+        }
+
         /* Mobile responsive toast positioning */
         @_media (max-width: 640px) {
           :host {
@@ -182,19 +192,23 @@ export class AppToaster extends HTMLElement {
       duration: null, // auto-calculated based on reading time
       closable: true,
       persistent: false, // if true, doesn't auto-dismiss
+      html: false,
+      action: null,
     };
 
     const config = { ...defaults, ...options };
 
     // Calculate reading time (average 200 words per minute)
-    const wordCount = message.split(/\s+/).length;
+    const messageText = String(message || "");
+    const readingText = config.html ? messageText.replace(/<[^>]*>/g, " ") : messageText;
+    const wordCount = readingText.split(/\s+/).filter(Boolean).length;
     const baseReadingTime = Math.max(2000, (wordCount / 200) * 60 * 1000); // minimum 2 seconds
 
     // Extend time for errors (people need more time to process error messages)
     const multiplier = config.type === "error" ? 1.5 : 1;
     const duration = config.duration || baseReadingTime * multiplier;
 
-    return this.#showToast(message, config, duration);
+    return this.#showToast(messageText, config, duration);
   }
 
   /*
@@ -213,7 +227,9 @@ export class AppToaster extends HTMLElement {
       config.type,
       config.closable,
       duration,
-      config.persistent
+      config.persistent,
+      config.html,
+      config.action
     );
 
     // Add to DOM
@@ -247,7 +263,7 @@ export class AppToaster extends HTMLElement {
    * @param {boolean} persistent
    * @returns {HTMLElement}
    */
-  createToastElement(id, message, type, closable, duration, persistent) {
+  createToastElement(id, message, type, closable, duration, persistent, html = false, action = null) {
     const toast = document.createElement("aside");
     toast.className = `toast callout ${this.#getAlertClass(type)}`;
     toast.setAttribute("data-toast-id", id);
@@ -260,6 +276,7 @@ export class AppToaster extends HTMLElement {
     icon.setAttribute("size", "lg");
 
     const content = document.createElement("div");
+    content.className = "toast-content";
 
     const title = document.createElement("div");
     title.className = "callout-title";
@@ -267,11 +284,41 @@ export class AppToaster extends HTMLElement {
 
     const text = document.createElement("p");
     text.style.margin = "0";
-    text.textContent = message;
+    if (html) {
+      text.innerHTML = String(message || "");
+    } else {
+      text.textContent = String(message || "");
+    }
 
     content.appendChild(title);
     content.appendChild(text);
 
+    if (action && typeof action === "object" && action.label) {
+      const actionButton = document.createElement("button");
+      actionButton.className = "btn-outline btn-sm toast-action";
+      actionButton.type = "button";
+      const actionLabel = document.createElement("span");
+      actionLabel.textContent = String(action.label);
+
+      if (action.icon) {
+        const icon = document.createElement("pds-icon");
+        icon.setAttribute("icon", String(action.icon));
+        icon.setAttribute("size", "sm");
+        actionButton.appendChild(icon);
+      }
+
+      actionButton.appendChild(actionLabel);
+      actionButton.addEventListener("click", () => {
+        if (typeof action.onClick === "function") {
+          action.onClick();
+        }
+        if (action.dismissOnClick !== false) {
+          this.dismissToast(id);
+        }
+      });
+      content.appendChild(actionButton);
+    }
+
     toast.appendChild(icon);
     toast.appendChild(content);