@stacksjs/stx 0.2.119 → 0.2.121

package/dist/craft-bridge.js

@@ -159,6 +159,12 @@ else if (data.type === 'event' && data.method) {
     });
   }
 
+  // Live component handles, keyed by id, so an event coming back from the host
+  // can be routed to the callbacks registered on the right one. Without this
+  // the onSelect/onSpaceChange callbacks were stored and never invoked.
+  const sidebars = new Map();
+  const spacesSidebars = new Map();
+
   function createNativeUIFacade() {
     class Sidebar {
       constructor(id) {
@@ -178,10 +184,42 @@ else if (data.type === 'event' && data.method) {
         return this;
       }
       destroy() {
+        sidebars.delete(this.id);
         sendNativeUI('destroyComponent', { id: this.id, type: 'sidebar' });
       }
     }
 
+    /**
+     * An Arc-style sidebar of swipeable spaces.
+     *
+     * Separate from Sidebar rather than an option on it: a source list selects
+     * one row out of many, while a spaces sidebar selects one whole SCENE, and
+     * a host that renders the switcher natively (a segmented control in the
+     * toolbar, a Touch Bar strip) needs the space list, not the item list.
+     */
+    class SpacesSidebar {
+      constructor(id) {
+        this.id = id;
+        this._spaceCallbacks = [];
+      }
+      setSpaces(spaces) {
+        sendNativeUI('setSidebarSpaces', { sidebarId: this.id, spaces });
+        return this;
+      }
+      setActiveSpace(spaceId) {
+        sendNativeUI('setActiveSpace', { sidebarId: this.id, spaceId });
+        return this;
+      }
+      onSpaceChange(callback) {
+        this._spaceCallbacks.push(callback);
+        return this;
+      }
+      destroy() {
+        spacesSidebars.delete(this.id);
+        sendNativeUI('destroyComponent', { id: this.id, type: 'spacesSidebar' });
+      }
+    }
+
     class FileBrowser {
       constructor(id) {
         this.id = id;
@@ -218,12 +256,33 @@ else if (data.type === 'event' && data.method) {
       }
     }
 
+    // Host -> page. The host names the component in the payload; we look up the
+    // handle and fan out to whatever the page registered on it.
+    on('sidebar.select', function(params) {
+      const sidebar = sidebars.get(params && params.sidebarId);
+      if (sidebar) sidebar._selectCallbacks.forEach(fn => fn(params.itemId));
+    });
+    on('sidebar.spaceChange', function(params) {
+      const sidebar = spacesSidebars.get(params && params.sidebarId);
+      if (sidebar) sidebar._spaceCallbacks.forEach(fn => fn(params.spaceId));
+    });
+
     return {
       createSidebar(options) {
         const opts = options || {};
         const id = opts.id || 'sidebar-' + Date.now() + '-' + Math.random().toString(36).slice(2);
         sendNativeUI('createSidebar', Object.assign({}, opts, { id }));
-        return new Sidebar(id);
+        const sidebar = new Sidebar(id);
+        sidebars.set(id, sidebar);
+        return sidebar;
+      },
+      createSpacesSidebar(options) {
+        const opts = options || {};
+        const id = opts.id || 'spaces-' + Date.now() + '-' + Math.random().toString(36).slice(2);
+        sendNativeUI('createSpacesSidebar', Object.assign({}, opts, { id }));
+        const sidebar = new SpacesSidebar(id);
+        spacesSidebars.set(id, sidebar);
+        return sidebar;
       },
       createFileBrowser(options) {
         const opts = options || {};
@@ -372,6 +431,26 @@ else if (data.type === 'event' && data.method) {
       platform: () => request('process.platform'),
     },
 
+    // Gesture stream
+    //
+    // A webview's wheel events carry no phase information, so a page can only
+    // guess where a trackpad swipe begins and ends \u2014 typically with an idle
+    // timeout, which mistimes the release and cannot see momentum at all. The
+    // host holds the real NSEvent, so it forwards the phases instead:
+    //
+    //   { axis: 'horizontal' | 'vertical',
+    //     phase: 'begin' | 'change' | 'end',
+    //     deltaX, deltaY,            // points since the last event
+    //     velocityX, velocityY,      // points per second, at 'end'
+    //     momentum: boolean }        // the OS is coasting, not the finger
+    //
+    // Consumers must stay correct when nothing ever arrives: a host without
+    // gesture support simply never emits, so keep the wheel path bound and let
+    // a begin phase take over from it.
+    gestures: {
+      onSwipe: (callback) => on('gesture.swipe', callback),
+    },
+
     // Native component helpers
     nativeUI,
     components: componentAPI

package/dist/craft-components.d.ts

@@ -123,7 +123,14 @@ export declare const CRAFT_COMPONENTS: {
   nativeType: 'craft-sidebar';
   fallbackTag: 'aside';
   fallbackClasses: 'craft-sidebar craft-sidebar-tahoe';
-  nativeProps: readonly ['id', 'variant', 'material', 'backgroundEffect', 'allowsVibrancy', 'materialOpacity', 'materialDarkOpacity', 'minWidth', 'maxWidth', 'canCollapse', 'searchPlaceholder', 'selectedItem', 'sections'];
+  nativeProps: readonly ['id', 'variant', 'material', 'backgroundEffect', 'allowsVibrancy', 'materialOpacity', 'materialDarkOpacity', 'minWidth', 'maxWidth', 'canCollapse', 'searchPlaceholder', 'selectedItem', 'sections', 'spaces', 'selectedSpace'];
+  render: unknown
+};
+  'sidebar-space': {
+  nativeType: 'craft-sidebar-space';
+  fallbackTag: 'section';
+  fallbackClasses: 'craft-sidebar-space';
+  nativeProps: readonly ['id', 'label', 'icon', 'tint'];
   render: unknown
 };
   'sidebar-section': {
@@ -503,6 +510,48 @@ export declare const CRAFT_COMPONENT_STYLES: `
   background: rgba(255, 255, 255, 0.24);
 }
 
+/* Spaces fallback. Stacked in document order behind a rail — legible without
+   a native host, and deliberately not a second swipe implementation. */
+.craft-sidebar-spaces {
+  position: relative;
+  z-index: 1;
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+}
+.craft-sidebar-space-title {
+  padding: 10px 8px 4px;
+  font-size: 13px;
+  font-weight: 600;
+}
+.craft-sidebar-space-switcher {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  gap: 1px;
+  padding-top: 6px;
+}
+.craft-sidebar-space-tab {
+  display: grid;
+  place-items: center;
+  width: 28px;
+  height: 26px;
+  border: 0;
+  border-radius: 7px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 11px;
+  font-weight: 700;
+  opacity: 0.4;
+  cursor: default;
+}
+.craft-sidebar-space-tab[data-selected="true"] {
+  opacity: 1;
+  background: rgba(255, 255, 255, 0.55);
+}
+
 .craft-code-editor {
   font-family: 'SF Mono', 'Fira Code', monospace;
   font-size: 13px;
@@ -578,11 +627,36 @@ export declare const CRAFT_COMPONENT_RUNTIME: `
     var config = parseConfig(sidebar);
     if (!config) return;
 
+    var hasSpaces = !!(config.spaces && config.spaces.length);
+    // Spaces need a host that can swipe between whole scenes. Falling back to
+    // createSidebar would flatten every space into one list, which is worse
+    // than the web rendering already on the page — so leave that in place.
+    if (hasSpaces && typeof nativeUI.createSpacesSidebar !== 'function') return;
+
     try {
       var nativeConfig = Object.assign({}, config);
       delete nativeConfig.sections;
-      var nativeSidebar = nativeUI.createSidebar(nativeConfig);
-      if (nativeSidebar && config.sections) {
+      delete nativeConfig.spaces;
+
+      var nativeSidebar = hasSpaces
+        ? nativeUI.createSpacesSidebar(nativeConfig)
+        : nativeUI.createSidebar(nativeConfig);
+
+      if (nativeSidebar && hasSpaces && nativeSidebar.setSpaces) {
+        nativeSidebar.setSpaces(config.spaces);
+      }
+      if (nativeSidebar && hasSpaces && config.selectedSpace && nativeSidebar.setActiveSpace) {
+        nativeSidebar.setActiveSpace(config.selectedSpace);
+      }
+      if (nativeSidebar && hasSpaces && nativeSidebar.onSpaceChange) {
+        nativeSidebar.onSpaceChange(function(spaceId) {
+          sidebar.dispatchEvent(new CustomEvent('craft-sidebar:space', {
+            bubbles: true,
+            detail: { spaceId: spaceId, sidebarId: config.id }
+          }));
+        });
+      }
+      if (nativeSidebar && !hasSpaces && config.sections) {
         config.sections.forEach(function(section) {
           if (nativeSidebar.addSection) nativeSidebar.addSection(section);
         });

package/dist/craft-components.js

@@ -218,10 +218,19 @@ export const CRAFT_COMPONENTS = {
       "canCollapse",
       "searchPlaceholder",
       "selectedItem",
-      "sections"
+      "sections",
+      "spaces",
+      "selectedSpace"
     ],
     render: renderCraftSidebar
   },
+  "sidebar-space": {
+    nativeType: "craft-sidebar-space",
+    fallbackTag: "section",
+    fallbackClasses: "craft-sidebar-space",
+    nativeProps: ["id", "label", "icon", "tint"],
+    render: renderCraftSidebarSpace
+  },
   "sidebar-section": {
     nativeType: "craft-sidebar-section",
     fallbackTag: "section",
@@ -620,6 +629,48 @@ export const CRAFT_COMPONENTS = {
   background: rgba(255, 255, 255, 0.24);
 }
 
+/* Spaces fallback. Stacked in document order behind a rail \u2014 legible without
+   a native host, and deliberately not a second swipe implementation. */
+.craft-sidebar-spaces {
+  position: relative;
+  z-index: 1;
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+}
+.craft-sidebar-space-title {
+  padding: 10px 8px 4px;
+  font-size: 13px;
+  font-weight: 600;
+}
+.craft-sidebar-space-switcher {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  align-items: center;
+  gap: 1px;
+  padding-top: 6px;
+}
+.craft-sidebar-space-tab {
+  display: grid;
+  place-items: center;
+  width: 28px;
+  height: 26px;
+  border: 0;
+  border-radius: 7px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 11px;
+  font-weight: 700;
+  opacity: 0.4;
+  cursor: default;
+}
+.craft-sidebar-space-tab[data-selected="true"] {
+  opacity: 1;
+  background: rgba(255, 255, 255, 0.55);
+}
+
 .craft-code-editor {
   font-family: 'SF Mono', 'Fira Code', monospace;
   font-size: 13px;
@@ -694,11 +745,36 @@ export const CRAFT_COMPONENTS = {
     var config = parseConfig(sidebar);
     if (!config) return;
 
+    var hasSpaces = !!(config.spaces && config.spaces.length);
+    // Spaces need a host that can swipe between whole scenes. Falling back to
+    // createSidebar would flatten every space into one list, which is worse
+    // than the web rendering already on the page \u2014 so leave that in place.
+    if (hasSpaces && typeof nativeUI.createSpacesSidebar !== 'function') return;
+
     try {
       var nativeConfig = Object.assign({}, config);
       delete nativeConfig.sections;
-      var nativeSidebar = nativeUI.createSidebar(nativeConfig);
-      if (nativeSidebar && config.sections) {
+      delete nativeConfig.spaces;
+
+      var nativeSidebar = hasSpaces
+        ? nativeUI.createSpacesSidebar(nativeConfig)
+        : nativeUI.createSidebar(nativeConfig);
+
+      if (nativeSidebar && hasSpaces && nativeSidebar.setSpaces) {
+        nativeSidebar.setSpaces(config.spaces);
+      }
+      if (nativeSidebar && hasSpaces && config.selectedSpace && nativeSidebar.setActiveSpace) {
+        nativeSidebar.setActiveSpace(config.selectedSpace);
+      }
+      if (nativeSidebar && hasSpaces && nativeSidebar.onSpaceChange) {
+        nativeSidebar.onSpaceChange(function(spaceId) {
+          sidebar.dispatchEvent(new CustomEvent('craft-sidebar:space', {
+            bubbles: true,
+            detail: { spaceId: spaceId, sidebarId: config.id }
+          }));
+        });
+      }
+      if (nativeSidebar && !hasSpaces && config.sections) {
         config.sections.forEach(function(section) {
           if (nativeSidebar.addSection) nativeSidebar.addSection(section);
         });
@@ -755,10 +831,10 @@ export function processCraftComponents(content, config = {}) {
 </body>`);
     else
       content += CRAFT_COMPONENT_RUNTIME;
-  content = content.replace(/<@craft-sidebar\s*([^>]*)>([\s\S]*?)<\/@craft-sidebar>/g, (match, propsStr, children) => {
+  content = content.replace(/<@craft-sidebar(?![-\w])\s*([^>]*)>([\s\S]*?)<\/@craft-sidebar>/g, (match, propsStr, children) => {
     return renderCraftComponent("sidebar", propsStr, children.trim(), config, classPrefix);
   });
-  content = content.replace(/<@craft-sidebar\s*([^>]*?)\/>/g, (match, propsStr) => {
+  content = content.replace(/<@craft-sidebar(?![-\w])\s*([^>]*?)\/>/g, (match, propsStr) => {
     return renderCraftComponent("sidebar", propsStr, "", config, classPrefix);
   });
   content = content.replace(/<@craft-(\w+[-\w]*)\s*([^>]*?)\/>/g, (match, componentName, propsStr) => {
@@ -806,7 +882,7 @@ function parseProps(propsStr) {
   return props;
 }
 function renderCraftSidebar(props, children) {
-  const id = normalizeId(String(props.id || `craft-sidebar-${hashString(children || JSON.stringify(props))}`)), sections = normalizeSidebarSections(props.sections) || extractSidebarSections(children), selectedItem = String(props.selectedItem || props.selected || sections[0]?.items[0]?.id || ""), config = {
+  const id = normalizeId(String(props.id || `craft-sidebar-${hashString(children || JSON.stringify(props))}`)), spaces = normalizeSidebarSpaces(props.spaces) || extractSidebarSpaces(children), sections = spaces.length ? [] : normalizeSidebarSections(props.sections) || extractSidebarSections(children), selectedSpace = String(props.selectedSpace || spaces[0]?.id || ""), openSpace = spaces.find((space) => space.id === selectedSpace) || spaces[0], selectedItem = String(props.selectedItem || props.selected || (spaces.length ? openSpace?.sections[0]?.items[0]?.id : sections[0]?.items[0]?.id) || ""), config = {
     id,
     variant: String(props.variant || "desktop"),
     material: String(props.material || "sidebar"),
@@ -819,14 +895,30 @@ function renderCraftSidebar(props, children) {
     canCollapse: props.canCollapse !== !1 && props.canCollapse !== "false",
     searchPlaceholder: props.searchPlaceholder ? String(props.searchPlaceholder) : void 0,
     selectedItem,
-    sections
-  }, fallbackClasses = String(props.__fallbackClasses || "craft-sidebar craft-sidebar-tahoe"), width = Number(props.width || props.sidebarWidth || 286), native = props.native === !1 || props.native === "false" ? "false" : "true", search = config.searchPlaceholder ? `<div class="craft-sidebar-search"><input type="search" placeholder="${escapeHtml(config.searchPlaceholder)}"></div>` : "", sectionHtml = sections.length ? sections.map((section) => renderSidebarSectionFallback(section, selectedItem)).join("") : children;
+    sections,
+    spaces,
+    selectedSpace: selectedSpace || void 0
+  }, fallbackClasses = String(props.__fallbackClasses || "craft-sidebar craft-sidebar-tahoe"), width = Number(props.width || props.sidebarWidth || 286), native = props.native === !1 || props.native === "false" ? "false" : "true", search = config.searchPlaceholder ? `<div class="craft-sidebar-search"><input type="search" placeholder="${escapeHtml(config.searchPlaceholder)}"></div>` : "";
+  let body;
+  if (spaces.length)
+    body = renderSidebarSpacesFallback(spaces, selectedSpace, selectedItem);
+  else if (sections.length)
+    body = sections.map((section) => renderSidebarSectionFallback(section, selectedItem)).join("");
+  else
+    body = children;
   return `<aside class="${escapeAttribute(fallbackClasses)}" data-craft="craft-sidebar" data-craft-native-sidebar data-craft-sidebar-id="${escapeAttribute(id)}" data-native="${native}" style="--craft-sidebar-width:${width}px">
   ${search}
-  ${sectionHtml}
+  ${body}
 </aside>
 <script type="application/json" data-craft-sidebar-config="${escapeAttribute(id)}">${escapeScriptJson(config)}</script>`;
 }
+function renderCraftSidebarSpace(props, children) {
+  const id = normalizeId(String(props.id || props.label || "space"));
+  return `<section class="craft-sidebar-space" data-craft="craft-sidebar-space" data-space-id="${escapeAttribute(id)}">
+    ${props.label ? `<div class="craft-sidebar-space-title">${escapeHtml(String(props.label))}</div>` : ""}
+    ${children}
+  </section>`;
+}
 function renderCraftSidebarSection(props, children) {
   const title = String(props.header || props.title || "");
   return `<section class="craft-sidebar-section" data-craft="craft-sidebar-section" data-section-id="${escapeAttribute(String(props.id || "section"))}">
@@ -868,6 +960,43 @@ function extractSidebarItems(content) {
   }
   return items;
 }
+function extractSidebarSpaces(children) {
+  const spaces = [], spacePattern = /<@craft-sidebar-space\s*([^>]*?)(?:\/>|>([\s\S]*?)<\/@craft-sidebar-space>)/g;
+  let spaceMatch;
+  while ((spaceMatch = spacePattern.exec(children)) !== null) {
+    const props = parseProps(spaceMatch[1] || ""), body = spaceMatch[2] || "", label = String(props.label || props.title || `Space ${spaces.length + 1}`);
+    spaces.push({
+      id: String(props.id || normalizeId(label)),
+      label,
+      icon: props.icon ? String(props.icon) : void 0,
+      tint: props.tint ? String(props.tint) : void 0,
+      sections: extractSidebarSections(body)
+    });
+  }
+  return spaces;
+}
+function normalizeSidebarSpaces(value) {
+  if (!value)
+    return;
+  if (Array.isArray(value))
+    return value;
+  if (typeof value !== "string")
+    return;
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return;
+  }
+}
+function renderSidebarSpacesFallback(spaces, selectedSpace, selectedItem) {
+  const rail = spaces.map((space) => `<button class="craft-sidebar-space-tab" type="button" data-space-target="${escapeAttribute(space.id)}" data-selected="${space.id === selectedSpace ? "true" : "false"}" title="${escapeAttribute(space.label || space.id)}">${space.icon ? `<span class="craft-sidebar-item-icon" data-icon="${escapeAttribute(space.icon)}"></span>` : escapeHtml((space.label || space.id).charAt(0))}</button>`).join("");
+  return `<div class="craft-sidebar-spaces">${spaces.map((space) => `<section class="craft-sidebar-space" data-space-id="${escapeAttribute(space.id)}" data-selected="${space.id === selectedSpace ? "true" : "false"}">
+    ${space.label ? `<div class="craft-sidebar-space-title">${escapeHtml(space.label)}</div>` : ""}
+    ${space.sections.map((section) => renderSidebarSectionFallback(section, selectedItem)).join("")}
+  </section>`).join("")}</div>
+  <div class="craft-sidebar-space-switcher">${rail}</div>`;
+}
 function normalizeSidebarSections(value) {
   if (!value)
     return;