@stacksjs/stx 0.2.170 → 0.2.172

package/dist/signals.js

@@ -5637,6 +5637,36 @@ catch (e) {} }
     }, 300);
   }
 
+  /*
+   * Is the APP in dark mode, not just the OS?
+   *
+   * stx's own color-mode boot writes a class (default 'dark') and/or an
+   * attribute (data-theme / data-color-mode) onto <html>, so an app pinned to
+   * light on a dark OS must not get a dark overlay over a light page. An
+   * explicit override wins over both, and the media query is the last resort.
+   *
+   * One function rather than the resolution inlined per surface. #1875 fixed
+   * this at the two dialog call sites, and toast kept the OS-only version and
+   * shipped the exact bug #1875 describes; that is what a per-call-site fix
+   * costs. See #1912.
+   */
+  function _resolveDark(override) {
+    if (override != null)
+      return !!override;
+
+    var root = document.documentElement;
+    if (root.classList.contains('dark'))
+      return true;
+
+    var attr = root.getAttribute('data-theme') || root.getAttribute('data-color-mode');
+    if (attr === 'dark')
+      return true;
+    if (attr === 'light')
+      return false;
+
+    return !!(window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches);
+  }
+
   function addToast(type, message, options) {
     var container = _getToastContainer();
     if (!container) {
@@ -5648,6 +5678,26 @@ catch (e) {} }
     var id = ++_toastId;
     var maxToasts = parseInt(container.getAttribute('data-stx-toast-max') || '5', 10);
 
+    /*
+     * A semantic id replaces its own toast in place (stacksjs/stx#1913).
+     *
+     * Without it, a persistent 'Publishing...' toast and the call that clears
+     * it on completion have to thread the numeric return value between two
+     * different functions by hand, which is the state management the primitive
+     * exists to remove. With an id of 'publish' the second call simply replaces
+     * the first, and toast.dismiss('publish') ends it.
+     */
+    var key = opts.id != null ? String(opts.id) : '';
+    if (key) {
+      var prior = container.querySelector('[data-stx-toast-key="' + key.replace(/"/g, '') + '"]');
+      // Removed outright rather than through removeToast, which animates for
+      // 300ms first. This is a REPLACEMENT, not a dismissal: animating the old
+      // one out while the new one animates in shows both at once, in the same
+      // slot, which is exactly the flicker a keyed toast exists to avoid.
+      if (prior && prior.parentNode)
+        prior.parentNode.removeChild(prior);
+    }
+
     // Enforce max toasts \u2014 remove oldest
     var existing = container.querySelectorAll('[data-stx-toast]');
     while (existing.length >= maxToasts && existing.length > 0) {
@@ -5659,7 +5709,7 @@ catch (e) {} }
     var anims = _getToastAnimClass(container);
     var borderColor = _toastColors[type] || _toastColors.info;
     var icon = _toastIcons[type] || _toastIcons.info;
-    var isDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+    var isDark = _resolveDark(opts.dark);
     var bg = isDark ? '#1f2937' : '#ffffff';
     var textColor = isDark ? '#f3f4f6' : '#1f2937';
     var shadow = isDark ? '0 4px 12px rgba(0,0,0,0.4)' : '0 4px 12px rgba(0,0,0,0.15)';
@@ -5667,6 +5717,8 @@ catch (e) {} }
     var el = document.createElement('div');
     el.id = 'stx-toast-' + id;
     el.setAttribute('data-stx-toast', String(id));
+    if (key)
+      el.setAttribute('data-stx-toast-key', key);
     el.setAttribute('role', 'alert');
     el.setAttribute('aria-live', 'assertive');
     el.style.cssText = 'pointer-events:auto;display:flex;align-items:flex-start;gap:0.75rem;padding:0.875rem 1rem;border-radius:0.5rem;border-left:4px solid ' + borderColor + ';background:' + bg + ';color:' + textColor + ';box-shadow:' + shadow + ';animation:' + anims.inAnim + ' 0.3s ease;font-family:system-ui,-apple-system,sans-serif;font-size:0.875rem;line-height:1.4;max-width:100%';
@@ -5675,9 +5727,32 @@ catch (e) {} }
     iconSpan.style.cssText = 'flex-shrink:0;display:flex;align-items:center;margin-top:1px';
     iconSpan.innerHTML = icon;
 
-    var msgSpan = document.createElement('span');
+    /*
+     * Title above message, when one is given (#1913).
+     *
+     * Collapsing the two into one string loses the hierarchy that makes a toast
+     * scannable, and every one of the 16 call sites in the reporting app passed
+     * a title. A wrapper is used only when there IS a title, so the untitled
+     * shape renders exactly as it did.
+     */
+    var msgSpan = document.createElement(opts.title ? 'div' : 'span');
     msgSpan.style.cssText = 'flex:1;word-wrap:break-word';
-    msgSpan.textContent = message;
+
+    if (opts.title) {
+      var titleEl = document.createElement('div');
+      titleEl.setAttribute('data-stx-toast-title', '');
+      titleEl.style.cssText = 'font-weight:600;margin-bottom:0.125rem';
+      titleEl.textContent = opts.title;
+      msgSpan.appendChild(titleEl);
+
+      var bodyEl = document.createElement('div');
+      bodyEl.style.cssText = 'opacity:0.9';
+      bodyEl.textContent = message;
+      msgSpan.appendChild(bodyEl);
+    }
+    else {
+      msgSpan.textContent = message;
+    }
 
     var closeBtn = document.createElement('button');
     closeBtn.type = 'button';
@@ -5704,7 +5779,20 @@ catch (e) {} }
     info: function(message, options) { return addToast('info', message, options); },
     warning: function(message, options) { return addToast('warning', message, options); },
     dismiss: function(id) {
-      if (id !== undefined) { removeToast(id); return; }
+      if (id !== undefined) {
+        // A string id is the semantic key the caller passed; a number is the
+        // handle addToast returned. Both dismiss, so a caller does not have to
+        // know which kind it is holding (#1913).
+        if (typeof id === 'string') {
+          var c = _getToastContainer();
+          var match = c && c.querySelector('[data-stx-toast-key="' + id.replace(/"/g, '') + '"]');
+          if (match)
+            removeToast(match.getAttribute('data-stx-toast'));
+          return;
+        }
+        removeToast(id);
+        return;
+      }
       var container = _getToastContainer();
       if (!container) return;
       var all = container.querySelectorAll('[data-stx-toast]');
@@ -5782,17 +5870,7 @@ catch (e) {} }
     // (e.g. data-theme) onto <html>, so an app pinned to light on a dark OS used
     // to get a dark dialog over a light page. An explicit opts.dark wins over
     // both, and the media query stays as the last resort. See #1875.
-    var _root = document.documentElement;
-    var _attrTheme = _root.getAttribute('data-theme') || _root.getAttribute('data-color-mode');
-    var isDark = opts.dark != null
-      ? !!opts.dark
-      : _root.classList.contains('dark')
-        ? true
-        : _attrTheme === 'dark'
-          ? true
-          : _attrTheme === 'light'
-            ? false
-            : !!(window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches);
+    var isDark = _resolveDark(opts.dark);
     var bg = isDark ? '#1f2937' : '#ffffff';
     var textColor = isDark ? '#f3f4f6' : '#1f2937';
     var subColor = isDark ? '#9ca3af' : '#6b7280';

package/dist/ssg.d.ts

@@ -257,6 +257,14 @@ export interface CachedPage {
     etag: string;
     headers?: Record<string, string>;
 }
+/**
+ * Whether a page declares an `action` — the export that receives its own POST.
+ *
+ * Exported so the rule is testable without running a build. A page action
+ * cannot run in a static build: `action` receives a POST, and a static build
+ * produces files, so there is no server left to receive one (stacksjs/stx#1847).
+ */
+export declare function declaresPageAction(source: string): boolean;
 /**
  * Generate sitemap.xml
  */