@glasshome/widget-sdk 1.19.0 → 1.20.1

package/dist/framework/components/anatomy.d.ts

@@ -24,7 +24,8 @@ export declare function WidgetHero(props: {
     art?: JSX.Element;
     class?: string;
 }): JSX.Element;
-/** The tile's control row: beside the value on a wide tile, under it on a narrow one, hidden on a short one. */
+/** The tile's control row: beside the value on a wide tile, under it on a narrow one, hidden on a short one.
+    A press here belongs to the row's controls; the widget only takes a hold from it. */
 export declare function WidgetControls(props: {
     children: JSX.Element;
 }): JSX.Element;

package/dist/framework/dialogs/WidgetDialog.d.ts

@@ -31,7 +31,7 @@ export interface WidgetDialogProps {
     controlsContent?: JSX.Element;
     /** What holding the tile opens: only what the tile cannot show (a group's members, colours, modes),
         as `PanelSection`s. It opens beside the tile, or from the bottom on a phone. A widget with nothing
-        the tile lacks passes none, and holding it opens nothing. */
+        the tile lacks passes none, and holding it says there is nothing more. */
     sheet?: () => JSX.Element;
     /** The tile's look, worn by its sheet so the tile reads as growing open: its icon in the head,
         its tone in the glass, its picture (a room, an album cover) as a band behind the head. */

package/dist/framework/gestures/use-widget-gestures.d.ts

@@ -7,6 +7,8 @@
  */
 import type { GestureConfig } from "../types";
 type GestureOrientation = "horizontal" | "vertical" | "square";
+/** A press that starts on a control inside a widget belongs to that control. */
+export declare const INTERACTIVE = "button, a, input, select, textarea, [role=\"slider\"], [role=\"radio\"], [role=\"switch\"]";
 export interface GestureHandlers {
     onPointerDown: (e: PointerEvent) => void;
     onPointerMove: (e: PointerEvent) => void;
@@ -26,6 +28,8 @@ export interface GestureHandlers {
     dispose: () => void;
     /** Where a hold is filling from, relative to the element; `fired` once it opened. */
     hold?: () => HoldFlood | null;
+    /** True while a hold opens something; the "nothing more here" answer does not count. */
+    holds?: () => boolean;
     /** Keyboard door: Enter or Space taps, the context-menu key or Shift+F10 holds. */
     onKeyDown?: (e: KeyboardEvent) => void;
 }

package/dist/framework/hooks/use-widget-context.d.ts

@@ -50,6 +50,10 @@ export interface ReactiveWidgetContext {
     developer?: () => boolean;
     /** The tile's box on the page, so a held tile's sheet opens beside it. Absent: it opens centred. */
     anchor?: () => HTMLElement | undefined;
+    /** Host hook: whether holding this widget opens anything. Absent on hosts that predate this field. */
+    onHoldable?: (holds: boolean) => void;
+    /** Host hook: a hold on this widget fired. Absent on hosts that predate this field. */
+    onHeld?: () => void;
 }
 export declare const WidgetCtx: import("solid-js").Context<ReactiveWidgetContext | undefined>;
 export declare function useWidgetContext(): ReactiveWidgetContext;

package/dist/framework/hooks/widget-registry.d.ts

@@ -1,5 +1,5 @@
 import { type Accessor, type Setter } from "solid-js";
-/** What a widget's parts tell each other: whether its dialog has a sheet, and the look the sheet wears. */
+/** What a widget's parts tell each other: whether its dialog has a sheet, the look the sheet wears, and a hold that found none. */
 export interface WidgetRegistry {
     hasSheet: Accessor<boolean>;
     setHasSheet: Setter<boolean>;
@@ -12,6 +12,9 @@ export interface WidgetRegistry {
     /** The head's icon. */
     icon: Accessor<string | undefined>;
     setIcon: Setter<string | undefined>;
+    /** A hold found no sheet: the shell says the widget has nothing more to show. */
+    nothingMore: Accessor<boolean>;
+    setNothingMore: Setter<boolean>;
 }
 /** `<Widget>` hands its parts a copy of the host context; this points the copy back at the original. */
 export declare const REGISTRY_KEY: unique symbol;