lecodes-sdk 2.8.0 → 2.8.1

package/dist/global.d.ts

@@ -248,6 +248,7 @@ declare global {
   const tileOriented: typeof SDK.tileOriented
   const tileTurns: typeof SDK.tileTurns
   const toast: typeof SDK.toast
+  const trackGesture: typeof SDK.trackGesture
   const use: typeof SDK.use
   type ARError = SDK.ARError
   type ARErrorCode = SDK.ARErrorCode
@@ -378,6 +379,9 @@ declare global {
   type GeoPosition = SDK.GeoPosition
   type GeoWatch = SDK.GeoWatch
   type Geometry = SDK.Geometry
+  type Gesture = SDK.Gesture
+  type GestureHandler = SDK.GestureHandler
+  type GestureTarget = SDK.GestureTarget
   type GizmoAnchor = SDK.GizmoAnchor
   type GizmoStyle = SDK.GizmoStyle
   type HapticStyle = SDK.HapticStyle

package/dist/types/inject.d.ts

@@ -37,6 +37,7 @@ export { audio, type PlaySoundOptions, type SpatialOptions, type Rolloff, type A
 export { openFilePicker, files, type FileData } from "./runtime/files";
 export { share } from "./runtime/share";
 export { ClickEvent, TouchStartEvent, LongPressEvent, MouseEnterEvent } from "./runtime/touch";
+export { trackGesture, type Gesture, type GestureHandler, type GestureTarget } from "./runtime/gestures";
 export { Scene2D } from "./g2/Scene2D";
 export { Node2D } from "./g2/Node2D";
 export { Camera2D } from "./g2/Camera2D";

package/dist/types/plugin.d.ts

@@ -22,6 +22,7 @@ export { Vec2, Vec3, type Vec3Like } from "./math/vec";
 export { Quat, type QuatLike } from "./math/quat";
 export { Mat4 } from "./math/mat4";
 export type { ClickEvent, TouchStartEvent } from "./runtime/touch";
+export { trackGesture, type Gesture, type GestureHandler, type GestureTarget } from "./runtime/gestures";
 export type { DismissOptions } from "./ui/presentable";
 /** The seam the push plugin's wrapper installs its runtime on (src/runtime/pushSeam.ts): what the app's transport
  *  reads the device's address from, registers through, and a push channel's handlers are kept by. */

package/dist/types/plugins/gen/ar/sdk/ar.d.ts

@@ -44,6 +44,9 @@ export type ARSceneOptions = SceneOptions & {
     /** "world" (default): planes, hit tests, anchors, image and QR targets. "images": image and QR
      *  targets only — lighter on iOS; no planes, no hit test, no `root`. */
     mode?: ARMode;
+    /** How far in front of the user `root` is placed, metres (default 1): along the camera's heading,
+     *  on the floor. */
+    rootDistance?: number;
 };
 export type AROpenOptions = PresentOptions & Omit<StartOptions, "mode" | "images" | "codes"> & {
     /** The scene's ambient (its `environmentIntensity`) follows the estimated light; turns
@@ -128,6 +131,8 @@ export declare class ARScene extends Scene {
     /** Whether this host registered the "ar" service (the app lists the plugin, the host has a half). */
     static get isSupported(): boolean;
     readonly mode: ARMode;
+    /** Metres between the user and `root` when it is placed (`rootDistance` option, default 1). */
+    readonly rootDistance: number;
     /** `open()` warm-renders the scene first (default true). */
     useWarmRender: boolean;
     private _opening;
@@ -147,7 +152,8 @@ export declare class ARScene extends Scene {
     private _codesWarned;
     private _options;
     private _root;
-    /** The first horizontal plane's pose: where `root` is pinned. */
+    /** The floor's height (world Y, metres): the first horizontal plane below the camera this session
+     *  found. Null until one is; `root` is placed on it. */
     private _floor;
     /** The image targets. `source` is held for the bytes: a fetched response owns its buffer, which the
      *  host frees once the response is collected — the File the session is handed only names it. */
@@ -174,9 +180,17 @@ export declare class ARScene extends Scene {
     /** A grid drawn on every plane (each plane's child mesh). */
     get showPlanes(): boolean;
     set showPlanes(on: boolean);
-    /** The floor: an anchor pinned on the first horizontal plane the session finds (it fires `track`
-     *  then). Until that it is the world's origin — where the session began. Not in "images" mode. */
+    /** The place in front of the user: an anchor `rootDistance` metres ahead of the camera along its
+     *  heading, on the floor — the first horizontal plane below the camera the session finds; it is
+     *  pinned there and fires `track` then — turned the way the user looks (its −Z along the heading,
+     *  so a model's front, +Z, faces the user). Until the floor is found (and on the web, which finds
+     *  none) it sits the same way at the camera's own height, not pinned. Made on first use; put
+     *  content under it. `placeRoot()` puts it in front of the user again. Not in "images" mode. */
     get root(): Anchor;
+    /** Put `root` in front of the user again — where they look now, `rootDistance` metres ahead, on the
+     *  floor if one is known (the camera's height otherwise), facing them: a "reset" button, or a
+     *  placement after the user has moved. Makes `root` when there is none yet. */
+    placeRoot(): Anchor;
     /** An anchor that follows an image (a printed marker, a poster): the session finds it in the camera
      *  image and keeps the anchor on it — a rigid pose in metres (its centre, Y out of the image, the
      *  image in XZ), its size `anchor.extent`. `physicalWidth` = the printed width in metres. Hidden
@@ -244,8 +258,14 @@ export declare class ARScene extends Scene {
     private _wire;
     /** Pin `anchor` at `pose` (where it is until the session holds it) — now, or when a session starts. */
     private _place;
-    /** `root` onto the floor (the first horizontal plane of this session). */
-    private _pinRoot;
+    /** Where `root` goes now: `rootDistance` metres from the camera along its heading (its forward
+     *  flattened to the floor; looking straight down or up, the way the top of the screen points), at
+     *  the floor's height when one is known, else the camera's; turned so its −Z runs along the
+     *  heading — a model's front (+Z) faces the user. */
+    private _rootPose;
+    /** `root` in front of the user: moved there now, and pinned there when the floor is known (a
+     *  session holds a pin; without one `_pinAll` does not re-pin root — it waits for its own floor). */
+    private _placeRoot;
     private _pin;
     /** A session began: every pose anchor is pinned where it is. */
     private _pinAll;

package/dist/types/runtime/gestures.d.ts

@@ -0,0 +1,52 @@
+import type { TouchStartEvent, TrackHandler } from "./touch";
+/** One reading of a gesture, handed to `onStart` / `onMove` / `onEnd` (a fresh object each time). */
+export interface Gesture {
+    /** The centroid of the live fingers, in the event's client coordinates (logical px). */
+    centerX: number;
+    centerY: number;
+    /** The centroid's move since the previous `onMove` (0 on start / end). */
+    deltaX: number;
+    deltaY: number;
+    /** Mean finger distance to the centroid over the previous one (1 with one finger, 1 on start / end). */
+    scale: number;
+    /** The mean change of each finger's angle about the centroid since the previous `onMove`, radians,
+     *  positive = clockwise on screen (0 with one finger, 0 on start / end). */
+    rotation: number;
+    /** The number of live fingers (0 in `onEnd`: the last one lifted). */
+    pointers: number;
+}
+/** What `trackGesture` takes: the gesture's callbacks and the claim every finger's track makes. */
+export interface GestureHandler {
+    /** Passed to every finger's `ev.track(...)` (default `true`: a scrollable above never takes the pan). */
+    claim?: TrackHandler["claim"];
+    /** The first finger landed. */
+    onStart?(g: Gesture): void;
+    /** Any finger moved: the change since the previous `onMove`. */
+    onMove?(g: Gesture): void;
+    /** The last finger lifted. */
+    onEnd?(g: Gesture): void;
+    /** The host cancelled one of the fingers: the whole gesture is over. */
+    onCancel?(): void;
+}
+/** Anything that hands out touchstarts: a UI element (`onTouchStart`) or a scene / node
+ *  (`addEventListener("touchstart", …)`). */
+export type GestureTarget = {
+    onTouchStart(callback: (ev: TouchStartEvent<any>) => void): unknown;
+} | {
+    addEventListener(channel: "touchstart", callback: (ev: TouchStartEvent<any>) => void): void;
+    removeEventListener(channel: "touchstart", callback: (ev: TouchStartEvent<any>) => void): void;
+};
+/**
+ * Follow pan, pinch and twist on `target` as one gesture: every finger that lands on it is tracked,
+ * and `onMove` reports the change of the whole set since the previous move — the centroid's move,
+ * the spread's ratio, the twist's angle. One finger is a gesture too (a pan, scale 1, rotation 0).
+ *
+ * ```ts
+ * trackGesture(scene, {
+ *   onMove(g) { zoom *= g.scale; angle += g.rotation; panX += g.deltaX; panY += g.deltaY },
+ * })
+ * ```
+ */
+export declare const trackGesture: (target: GestureTarget, handler: GestureHandler) => {
+    remove(): void;
+};

package/dist/types/ui/UIModal.d.ts

@@ -28,9 +28,10 @@ export type UIModalShow = (() => boolean) | Signal<boolean>;
  * request, `onDismiss`. By default it hides an unbound modal and writes `false` into a bound
  * signal; a bound function has nowhere to write, so a modal bound to one without `onDismiss`
  * cannot be dismissed (a forced choice — the same as `dismissible(false)`). `display` is not a
- * modal's switch: a `.style({ display })` on it throws (a bound display died on the first
- * dismissal, which wrote a static `display: "none"` over the binding — the dialog never opened
- * again).
+ * modal's switch (a bound display died on the first dismissal, which wrote a static
+ * `display: "none"` over the binding — the dialog never opened again). Deprecated, for the
+ * transition period a `.style({ display })` is still accepted, with a warning: a function becomes
+ * `bindShow(() => fn() !== "none")`, a value a show() / hide(); it will throw again.
  */
 export interface UIModal extends UIWidget {
     /**
@@ -82,6 +83,7 @@ export declare class ModalElement extends WidgetElement {
     private _poseObj?;
     private _poseKey;
     constructor(style: UIModalStyle, children: UINodeChild[] | ChildrenFn);
+    private _bindDisplay;
     private _pose;
     transition(hidden: UIModalTransition): this;
     bindShow(value: UIModalShow): this;

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "2.8.0";
+export declare const SDK_VERSION = "2.8.1";
 /** The major of a semver string, or null when it is not one. */
 export declare const sdkMajor: (version: string | null | undefined) => number | null;
 /** The `// sdk: <version>` line of a compiled bundle's header (sdk/src/compile/header.ts), read from