@syntrologie/runtime-sdk 2.8.0-canary.176 → 2.8.0-canary.178

package/dist/components/SyntroBottomSheet.d.ts

@@ -9,18 +9,20 @@
  * reached its top.
  *
  * **Geometry:** ``position: fixed; left:0; right:0; bottom:0;
- * height: 100vh`` with a vertical ``translateY()`` to position the
- * **top edge** of the sheet at the active snap point. ``height = 100vh``
+ * height: 100svh`` with a vertical ``translateY()`` to position the
+ * **top edge** of the sheet at the active snap point. ``height = 100svh``
  * keeps the sheet's bottom anchored even when the snap point moves —
- * the content area below the handle just expands. Inner padding uses
- * ``env(safe-area-inset-bottom)`` so the iPhone home indicator doesn't
- * eat the last row of tiles.
+ * the content area below the handle just expands. ``svh`` (small
+ * viewport height) is used instead of ``dvh`` so the sheet doesn't
+ * jump when the mobile browser chrome (URL bar) appears or hides.
+ * Inner padding uses ``env(safe-area-inset-bottom)`` so the iPhone
+ * home indicator doesn't eat the last row of tiles.
  *
- * **Snap points** (vh percentages, peek default 30, mid 70, full 95)
+ * **Snap points** (svh percentages, peek default 30, mid 70, full 95)
  * are configurable via ``theme.canvas.snapPoints``. ``peek`` is the
  * lowest position the sheet rests at — dragging below peek with a
  * downward velocity dispatches ``canvas-toggle`` (close) rather than
- * snapping back. The translateY is computed as ``(100 - snapVh)%``.
+ * snapping back. The translateY is computed as ``(100 - snapVh)svh``.
  *
  * **Drag handle** is a 44px-tall touch target across the top, matching
  * Apple's recommended minimum for finger taps. ``pointerdown`` here
@@ -134,6 +136,7 @@ export declare class SyntroBottomSheet extends LitElement {
     private _scrollEl;
     /** Saved body overflow value before we apply scroll lock. */
     private _savedBodyOverflow;
+    private _entryRafId;
     private _onDocumentMousedown;
     private _onScrimClick;
     createRenderRoot(): this;
@@ -158,6 +161,7 @@ export declare class SyntroBottomSheet extends LitElement {
     updated(changed: Map<string, unknown>): void;
     private _lockBodyScroll;
     private _unlockBodyScroll;
+    private _scheduleEntryTransition;
     /** Convert a vertical pointer delta (px, downward = positive) to a vh
      *  offset. Used during drag and for velocity calculations. */
     private _pxToVh;

package/dist/components/SyntroLauncher.d.ts

@@ -74,6 +74,7 @@ export declare class SyntroLauncher extends LitElement {
     colorPrimary: string;
     colorPrimaryHover: string;
     launcherConfig: LauncherElementConfig;
+    hasActiveTiles: boolean;
     _launcherPos: {
         x: number;
         y: number;

package/dist/index.js

@@ -7698,6 +7698,7 @@ var SyntroBottomSheet = class extends LitElement6 {
     __publicField(this, "_scrollEl", null);
     /** Saved body overflow value before we apply scroll lock. */
     __publicField(this, "_savedBodyOverflow", null);
+    __publicField(this, "_entryRafId", 0);
     // --- Outside-click-to-close (matches SyntroDrawer pattern) ---
     __publicField(this, "_onDocumentMousedown", (e) => {
       if (!this.isOpen) return;
@@ -7790,6 +7791,7 @@ var SyntroBottomSheet = class extends LitElement6 {
   disconnectedCallback() {
     super.disconnectedCallback();
     document.removeEventListener("mousedown", this._onDocumentMousedown);
+    cancelAnimationFrame(this._entryRafId);
     this._unlockBodyScroll();
   }
   updated(changed) {
@@ -7799,6 +7801,7 @@ var SyntroBottomSheet = class extends LitElement6 {
       if (this.isOpen) {
         this.snap = "mid";
         this._lockBodyScroll();
+        this._scheduleEntryTransition();
       } else {
         this._unlockBodyScroll();
       }
@@ -7821,6 +7824,22 @@ var SyntroBottomSheet = class extends LitElement6 {
       this._savedBodyOverflow = null;
     }
   }
+  _scheduleEntryTransition() {
+    if (typeof window === "undefined") return;
+    cancelAnimationFrame(this._entryRafId);
+    this._entryRafId = requestAnimationFrame(() => {
+      const container = this.querySelector('[data-syntro-bottom-sheet="container"]');
+      if (!container) return;
+      const targetTransform = container.style.transform;
+      const targetTransition = container.style.transition;
+      container.style.transition = "none";
+      container.style.transform = "translateY(100svh)";
+      this._entryRafId = requestAnimationFrame(() => {
+        container.style.transition = targetTransition;
+        container.style.transform = targetTransform;
+      });
+    });
+  }
   // ── Snap math ────────────────────────────────────────────────────────────
   /** Convert a vertical pointer delta (px, downward = positive) to a vh
    *  offset. Used during drag and for velocity calculations. */
@@ -7889,6 +7908,7 @@ var SyntroBottomSheet = class extends LitElement6 {
   _onPointerDown(e, fromHandle) {
     var _a3, _b;
     if (this._activePointerId !== null) return;
+    if (!fromHandle && this.snap !== "full") return;
     this._activePointerId = e.pointerId;
     this._dragStartY = e.clientY;
     this._dragStartSnap = this.snap;
@@ -7985,15 +8005,17 @@ var SyntroBottomSheet = class extends LitElement6 {
       left: "0",
       right: "0",
       bottom: "0",
-      // ``100dvh`` (dynamic viewport height) shrinks when the iOS soft
-      // keyboard appears, so a tile with a text input doesn't end up
-      // covered by the keyboard. ``100vh`` would be measured against the
-      // pre-keyboard viewport and lose the bottom of the sheet behind
-      // the keyboard. Browser support: Safari 15.4+, Chrome 108+,
-      // Firefox 101+ — universal in 2026.
-      height: "100dvh",
+      // ``100svh`` (small viewport height) is the viewport with the
+      // mobile browser chrome (URL bar) visible.  Using ``svh`` instead
+      // of ``dvh`` prevents the sheet from jumping when Chrome/Safari
+      // shows or hides the URL bar — the sheet is always sized for the
+      // smallest viewport.  When the URL bar hides, a small gap appears
+      // at the bottom rather than a jarring position shift.  Browser
+      // support: Safari 15.4+, Chrome 108+, Firefox 101+ — universal
+      // in 2026.
+      height: "100svh",
       pointerEvents: "auto",
-      transform: `translateY(${topEdgeVh}vh)`,
+      transform: `translateY(${topEdgeVh}svh)`,
       transition: this.isDragging ? "none" : `transform ${dur} ${ease}, opacity ${dur} ease-out`,
       display: "flex",
       flexDirection: "column",
@@ -8023,11 +8045,13 @@ var SyntroBottomSheet = class extends LitElement6 {
       borderRadius: "3px",
       background: "rgba(255, 255, 255, 0.4)"
     };
+    const snapVh = this.snapPoints[this.snap];
     const scrollAreaStyles = {
       flex: "1 1 auto",
       overflowY: "auto",
       padding: "0 1rem 1rem",
-      touchAction: "pan-y"
+      touchAction: "pan-y",
+      maxHeight: `calc(${snapVh}svh - 56px)`
     };
     return html6`
       <div data-syntro-bottom-sheet="root" style=${styleMap6(rootStyles)}>
@@ -9293,6 +9317,7 @@ var SyntroCanvasOverlay = class extends LitElement7 {
           .themeConfig=${this.themeConfig}
           .launcherIcon=${(_e2 = (_d = (_c = this.themeConfig) == null ? void 0 : _c.launcher) == null ? void 0 : _d.icon) != null ? _e2 : null}
           ?launcherAnimate=${this.launcherAnimate && !this.isOpen}
+          .hasActiveTiles=${this.tiles.length > 0}
           @launcher-toggle=${this._onLauncherToggle}
         ></syntro-launcher>
       </div>
@@ -9508,7 +9533,7 @@ function error(prefix, message, data) {
 }
 
 // src/version.ts
-var SDK_VERSION = "2.8.0-canary.176";
+var SDK_VERSION = "2.8.0-canary.178";
 
 // src/types.ts
 var SDK_SCHEMA_VERSION = "2.0";
@@ -10748,6 +10773,7 @@ var SyntroLauncher = class extends LitElement11 {
     __publicField(this, "colorPrimary", TOKEN_PURPLE_42);
     __publicField(this, "colorPrimaryHover", TOKEN_PURPLE_5);
     __publicField(this, "launcherConfig", {});
+    __publicField(this, "hasActiveTiles", true);
     // --- Private reactive state ---
     __publicField(this, "_launcherPos", null);
     __publicField(this, "_hovered", false);
@@ -10910,7 +10936,8 @@ var SyntroLauncher = class extends LitElement11 {
       border: "none",
       backgroundColor: "var(--sc-launcher-background)",
       cursor: ((_a3 = this._drag) == null ? void 0 : _a3.dragged) ? "grabbing" : "pointer",
-      touchAction: "none"
+      touchAction: "none",
+      opacity: !this.hasActiveTiles && !this.isOpen ? "0.3" : void 0
     };
     const animateClass = this.launcherAnimate && !this.isOpen ? "syntro-launcher-animate" : "";
     const showBadge = !this.isOpen && this.notificationCount > 0;