@syntrologie/runtime-sdk 2.8.0-canary.155 → 2.8.0-canary.157

package/dist/actions/schema.d.ts

@@ -121,12 +121,12 @@ declare const WidgetConfigZ: z.ZodObject<{
     priority: z.ZodOptional<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
     widgetId: string;
-    priority?: number | undefined;
     props?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
 }, {
     widgetId: string;
-    priority?: number | undefined;
     props?: Record<string, unknown> | undefined;
+    priority?: number | undefined;
 }>;
 /**
  * Tour step (schema-safe version).
@@ -4067,10 +4067,6 @@ declare const InsertHtmlZ: z.ZodObject<{
     };
     position: "before" | "after" | "prepend" | "append" | "replace";
     html: string;
-    deepLink?: {
-        tileId: string;
-        itemId?: string | undefined;
-    } | undefined;
     label?: string | undefined;
     triggerWhen?: {
         type: "rules";
@@ -4153,6 +4149,10 @@ declare const InsertHtmlZ: z.ZodObject<{
         method?: "GET" | "POST" | undefined;
         timeoutMs?: number | undefined;
     } | null | undefined;
+    deepLink?: {
+        tileId: string;
+        itemId?: string | undefined;
+    } | undefined;
 }, {
     kind: "content:insertHtml";
     anchorId: {
@@ -4161,10 +4161,6 @@ declare const InsertHtmlZ: z.ZodObject<{
     };
     position: "before" | "after" | "prepend" | "append" | "replace";
     html: string;
-    deepLink?: {
-        tileId: string;
-        itemId?: string | undefined;
-    } | undefined;
     label?: string | undefined;
     triggerWhen?: {
         type: "rules";
@@ -4247,6 +4243,10 @@ declare const InsertHtmlZ: z.ZodObject<{
         method?: "GET" | "POST" | undefined;
         timeoutMs?: number | undefined;
     } | null | undefined;
+    deepLink?: {
+        tileId: string;
+        itemId?: string | undefined;
+    } | undefined;
 }>;
 declare const HighlightZ: z.ZodObject<{
     kind: z.ZodLiteral<"overlays:highlight">;
@@ -9154,12 +9154,12 @@ declare const MountWidgetZ: z.ZodObject<{
         priority: z.ZodOptional<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
         widgetId: string;
-        priority?: number | undefined;
         props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
     }, {
         widgetId: string;
-        priority?: number | undefined;
         props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
     }>;
     label: z.ZodOptional<z.ZodString>;
 } & {
@@ -9653,8 +9653,8 @@ declare const MountWidgetZ: z.ZodObject<{
     slot: string;
     widget: {
         widgetId: string;
-        priority?: number | undefined;
         props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
     };
     label?: string | undefined;
     triggerWhen?: {
@@ -9743,8 +9743,8 @@ declare const MountWidgetZ: z.ZodObject<{
     slot: string;
     widget: {
         widgetId: string;
-        priority?: number | undefined;
         props?: Record<string, unknown> | undefined;
+        priority?: number | undefined;
     };
     label?: string | undefined;
     triggerWhen?: {
@@ -17291,10 +17291,6 @@ export declare const coreActionStepSchemas: ({
         };
         position: "before" | "after" | "prepend" | "append" | "replace";
         html: string;
-        deepLink?: {
-            tileId: string;
-            itemId?: string | undefined;
-        } | undefined;
         label?: string | undefined;
         triggerWhen?: {
             type: "rules";
@@ -17377,6 +17373,10 @@ export declare const coreActionStepSchemas: ({
             method?: "GET" | "POST" | undefined;
             timeoutMs?: number | undefined;
         } | null | undefined;
+        deepLink?: {
+            tileId: string;
+            itemId?: string | undefined;
+        } | undefined;
     }, {
         kind: "content:insertHtml";
         anchorId: {
@@ -17385,10 +17385,6 @@ export declare const coreActionStepSchemas: ({
         };
         position: "before" | "after" | "prepend" | "append" | "replace";
         html: string;
-        deepLink?: {
-            tileId: string;
-            itemId?: string | undefined;
-        } | undefined;
         label?: string | undefined;
         triggerWhen?: {
             type: "rules";
@@ -17471,6 +17467,10 @@ export declare const coreActionStepSchemas: ({
             method?: "GET" | "POST" | undefined;
             timeoutMs?: number | undefined;
         } | null | undefined;
+        deepLink?: {
+            tileId: string;
+            itemId?: string | undefined;
+        } | undefined;
     }>;
 } | {
     defName: string;
@@ -22394,12 +22394,12 @@ export declare const coreActionStepSchemas: ({
             priority: z.ZodOptional<z.ZodNumber>;
         }, "strict", z.ZodTypeAny, {
             widgetId: string;
-            priority?: number | undefined;
             props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
         }, {
             widgetId: string;
-            priority?: number | undefined;
             props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
         }>;
         label: z.ZodOptional<z.ZodString>;
     } & {
@@ -22893,8 +22893,8 @@ export declare const coreActionStepSchemas: ({
         slot: string;
         widget: {
             widgetId: string;
-            priority?: number | undefined;
             props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
         };
         label?: string | undefined;
         triggerWhen?: {
@@ -22983,8 +22983,8 @@ export declare const coreActionStepSchemas: ({
         slot: string;
         widget: {
             widgetId: string;
-            priority?: number | undefined;
             props?: Record<string, unknown> | undefined;
+            priority?: number | undefined;
         };
         label?: string | undefined;
         triggerWhen?: {

package/dist/components/SyntroBottomSheet.d.ts

@@ -0,0 +1,171 @@
+/**
+ * SyntroBottomSheet — mobile-mode equivalent of {@link SyntroDrawer}.
+ *
+ * On phone-sized viewports a side-aligned 380px panel feels foreign.
+ * Visitors expect the iOS / Telegram pattern: tap launcher → sheet rises
+ * from the bottom edge, three snap points (peek / mid / full), drag-handle
+ * dismiss, and nested-scroll handoff so dragging on long content scrolls
+ * the content first and only takes over the sheet once the content has
+ * 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``
+ * 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.
+ *
+ * **Snap points** (vh 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)%``.
+ *
+ * **Drag handle** is a 44px-tall touch target across the top, matching
+ * Apple's recommended minimum for finger taps. ``pointerdown`` here
+ * always treats the gesture as sheet drag — no nested-scroll
+ * negotiation. The grabber pill (4×40px) inside it is purely visual.
+ *
+ * **Drag on content** uses the standard iOS handoff: when the touch
+ * lands inside the content scroll container *and* the container has
+ * ``scrollTop > 0``, the content scrolls and the sheet stays put. Once
+ * the content reaches ``scrollTop === 0`` and the user keeps dragging
+ * down, the sheet takes over (decided lazily at first ``pointermove``).
+ *
+ * **Snap-on-release** computes velocity from the last ~100ms of
+ * pointermove samples. ``|velocity| > 0.5px/ms`` → step one snap in the
+ * fling direction. Otherwise → nearest snap by current position. Below
+ * peek with downward intent → dismiss.
+ *
+ * **Animation** reuses ``themeConfig.canvas.transitionDuration`` and
+ * ``transitionEasing`` (same tokens as the drawer). Transition is
+ * disabled during active drag and re-enabled at release so the snap
+ * animates smoothly.
+ *
+ * Decorator-free (matches drawer): uses ``static override properties``.
+ */
+import { LitElement, nothing } from 'lit';
+import type { SmartCanvasRuntime } from '../runtime.js';
+import type { TelemetryClient } from '../telemetry/types.js';
+import type { TileConfig } from '../types.js';
+import './SyntroTileStack.js';
+export interface BottomSheetSnapPoints {
+    /** Lowest rest position. Drag below this with downward intent → dismiss. */
+    peek?: number;
+    /** Default open position when the sheet first appears. */
+    mid?: number;
+    /** Maximum height. Sheet won't grow past this even if dragged up further. */
+    full?: number;
+}
+export interface BottomSheetThemeConfig {
+    canvas: {
+        transitionDuration?: string;
+        transitionEasing?: string;
+        border?: string;
+        blur?: string;
+        snapPoints?: BottomSheetSnapPoints;
+    };
+}
+type SnapName = 'peek' | 'mid' | 'full';
+export declare class SyntroBottomSheet extends LitElement {
+    static properties: {
+        isOpen: {
+            type: BooleanConstructor;
+        };
+        tiles: {
+            attribute: boolean;
+        };
+        isLoading: {
+            type: BooleanConstructor;
+        };
+        error: {
+            type: StringConstructor;
+        };
+        canvasTitle: {
+            type: StringConstructor;
+        };
+        runtimeRef: {
+            attribute: boolean;
+        };
+        telemetry: {
+            attribute: boolean;
+        };
+        themeConfig: {
+            attribute: boolean;
+        };
+        snap: {
+            attribute: boolean;
+        };
+        dragOffsetVh: {
+            attribute: boolean;
+        };
+        isDragging: {
+            attribute: boolean;
+        };
+    };
+    isOpen: boolean;
+    tiles: TileConfig[];
+    isLoading: boolean;
+    error: string | undefined;
+    canvasTitle: string | undefined;
+    runtimeRef: SmartCanvasRuntime | null;
+    telemetry: TelemetryClient | null;
+    themeConfig: BottomSheetThemeConfig;
+    snap: SnapName;
+    /** Live drag offset in vh — added to the active snap's translateY
+     *  during an in-progress drag. Reset to 0 on release. */
+    dragOffsetVh: number;
+    isDragging: boolean;
+    private _activePointerId;
+    private _dragStartY;
+    private _dragStartSnap;
+    private _samples;
+    /** True once the gesture has committed to dragging the sheet. Used to
+     *  defer the nested-scroll-vs-sheet decision until the first move. */
+    private _gestureCommitted;
+    /** True if the pointerdown landed on the drag handle. Handle gestures
+     *  always commit to sheet-drag without nested-scroll negotiation. */
+    private _gestureFromHandle;
+    /** Cached scroll container ref so we can check ``scrollTop`` cheaply
+     *  during pointermove without re-querying. */
+    private _scrollEl;
+    private _onDocumentMousedown;
+    createRenderRoot(): this;
+    private get _canvas();
+    private get _duration();
+    private get _easing();
+    private get _border();
+    private get _blur();
+    /** Resolved snap-point heights (vh). */
+    private get snapPoints();
+    /** Top-edge position in vh (from top of viewport) for the active snap
+     *  plus any in-progress drag offset. Higher value = sheet sits lower. */
+    private get _topEdgeVh();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    /** Convert a vertical pointer delta (px, downward = positive) to a vh
+     *  offset. Used during drag and for velocity calculations. */
+    private _pxToVh;
+    /** Velocity in vh/ms over the last ``VELOCITY_SAMPLE_WINDOW_MS``. */
+    private _computeVelocityVhPerMs;
+    /** Pick the destination snap from the current top-edge position
+     *  (without drag offset overriding the active snap), velocity, and
+     *  fling threshold. Returns ``null`` to indicate dismiss. */
+    private _decideSnapOnRelease;
+    /** Adapter: ``_computeVelocityVhPerMs`` returns vh/ms; the threshold is
+     *  expressed in px/ms (matching existing iOS conventions). Convert
+     *  back so the comparison is unit-correct. */
+    private _pxToVelocityForDecision;
+    private _onPointerDown;
+    private _onPointerMove;
+    private _onPointerUp;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'syntro-bottom-sheet': SyntroBottomSheet;
+    }
+}
+export {};

package/dist/components/SyntroCanvasOverlay.d.ts

@@ -23,6 +23,7 @@
  * experimentalDecorators).
  */
 import { LitElement } from 'lit';
+import './SyntroBottomSheet.js';
 import type { SmartCanvasRuntime } from '../runtime.js';
 import type { TelemetryClient } from '../telemetry/types.js';
 import type { TileConfig } from '../types.js';
@@ -58,6 +59,9 @@ export declare class SyntroCanvasOverlay extends LitElement {
         launcherAnimate: {
             type: BooleanConstructor;
         };
+        isMobileMode: {
+            attribute: boolean;
+        };
     };
     isOpen: boolean;
     tiles: TileConfig[];
@@ -69,7 +73,15 @@ export declare class SyntroCanvasOverlay extends LitElement {
     telemetry: TelemetryClient | null;
     themeConfig: Record<string, any>;
     launcherAnimate: boolean;
+    /** Tracks ``runtime.context.surface.mode === 'mobile'`` so the
+     *  template can switch between ``<syntro-drawer>`` and
+     *  ``<syntro-bottom-sheet>``. Agent surfaces are handled at a higher
+     *  level by ``SmartCanvasElementLit`` (which renders inline-shell
+     *  before this overlay ever mounts), so this overlay only ever runs
+     *  on web — mobile vs desktop is the only branch it needs. */
+    isMobileMode: boolean;
     private _notifications;
+    private _surfaceUnsub;
     /** Prev-state map: entry.id → last evaluated boolean */
     private _notifyPrevState;
     /** Unsubscribe for the EventBus notify-watcher subscription */
@@ -80,12 +92,14 @@ export declare class SyntroCanvasOverlay extends LitElement {
     createRenderRoot(): this;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private _subscribeSurface;
     updated(changed: Map<string, unknown>): void;
     private _syncNotificationsController;
     private _startNotifyWatcher;
     private _stopNotifyWatcher;
     private _restartNotifyWatcher;
     private _trackTilesViewed;
+    private _surfaceMeta;
     private _toggle;
     private _handleNotificationClick;
     private _handleNotificationDismiss;