@aethervtt/shard-platform 0.0.1 → 0.1.0

package/dist/index.d.ts

@@ -17,6 +17,29 @@ export interface Platform {
      * first use. Absent on hosts without threads; `workersOf` falls back to running jobs inline.
      */
     readonly workers?: Workers;
+    /** The host's own performance instruments (long tasks, downloads), for 0062's metrics. */
+    readonly performance?: HostPerformance;
+}
+/**
+ * What the host itself can measure about a page or process (0062). Browsers report long tasks and
+ * resource timing; Node and Tauri report what they can, and leave out what they can't.
+ */
+export interface HostPerformance {
+    /** The user agent, or the runtime's name and version. */
+    readonly userAgent: string;
+    /**
+     * Main-thread tasks of 50 ms or more, as the host reports them: start (on the `clock`'s timeline)
+     * and duration, in ms. Returns an unsubscribe function. Absent where the host can't see them.
+     */
+    onLongTask?(listener: (startMs: number, durationMs: number) => void): () => void;
+    /** Bytes fetched so far (scripts, WASM, assets), over the wire and decoded. Absent without resource timing. */
+    downloads?(): HostDownloads;
+}
+export interface HostDownloads {
+    /** Bytes over the wire, headers included. Cached responses add nothing. */
+    transferred: number;
+    /** Bytes after decoding (decompression). */
+    decoded: number;
 }
 export * from './workers.js';
 export type MouseButton = 'left' | 'middle' | 'right' | 'back' | 'forward';
@@ -39,10 +62,35 @@ export type RawInputEvent = {
     y: number;
     dx: number;
     dy: number;
-} | {
+}
+/**
+ * Wheel movement in pixels (line and page deltas already converted). `x`/`y` (CSS pixels, from
+ * the element's top left) and `modifiers` come from sources that know them; a ctrl wheel is a
+ * trackpad pinch.
+ */
+ | {
     type: 'wheel';
     dx: number;
     dy: number;
+    x?: number;
+    y?: number;
+    modifiers?: number;
+}
+/**
+ * One pointer (0060): mouse, pen or touch, in CSS pixels from the element's top left. Gestures
+ * read these; `mouse-*` and `touch` events still feed the device resources and action maps.
+ */
+ | {
+    type: 'pointer';
+    id: number;
+    phase: PointerPhase;
+    pointer: PointerKind;
+    /** The button that went down (`down`/`up`), or the one held since (`move`). */
+    button: MouseButton;
+    x: number;
+    y: number;
+    /** `MODIFIERS` bits held: shift, ctrl, alt, meta. */
+    modifiers: number;
 } | {
     type: 'touch';
     id: number;
@@ -69,10 +117,44 @@ export type RawInputEvent = {
     type: 'text';
     text: string;
 };
+export type PointerPhase = 'down' | 'move' | 'up' | 'cancel';
+export type PointerKind = 'mouse' | 'pen' | 'touch';
+/** Bits of a pointer or wheel event's `modifiers`. */
+export declare const MODIFIERS: {
+    readonly shift: 1;
+    readonly ctrl: 2;
+    readonly alt: 4;
+    readonly meta: 8;
+};
+/**
+ * What the scene takes from the pointer while a control is enabled (0060). A source stops the
+ * host's default handling (`preventDefault`) only for what's listed here and for claimed pointers;
+ * everything else passes through to the page.
+ */
+export interface PointerPolicy {
+    /** Mouse buttons enabled controls drag with: presses with them, and the context menu for 'right'. */
+    buttons: readonly MouseButton[];
+    /** Wheel events zoom a control. */
+    wheel: boolean;
+    /** Touches drive a control: the element gets `touch-action: none`. */
+    touch: boolean;
+}
 /** Where raw input comes from: DOM listeners in a browser or webview, nothing when headless. */
 export interface InputSource {
     /** Appends events since the last drain (and polls devices like gamepads). */
     drain(out: RawInputEvent[]): void;
+    /**
+     * Calls `listener` whenever an event arrives, so an on-demand app wakes to drain it (0052).
+     * Returns an unsubscribe function. Polled devices (gamepads) don't call it.
+     */
+    onInput?(listener: () => void): () => void;
+    /**
+     * A consumer took this pointer's gesture (0060): its later events are the scene's
+     * (`preventDefault`), and it keeps reporting outside the element (pointer capture) until it ends.
+     */
+    claimPointer?(id: number): void;
+    /** What enabled controls take; see `PointerPolicy`. Called when it changes. */
+    setPointerPolicy?(policy: PointerPolicy): void;
     dispose(): void;
 }
 export type FileChangeKind = 'create' | 'modify' | 'remove';
@@ -194,6 +276,11 @@ export interface AudioBackend {
     readonly state: AudioContextState;
     /** Returns an id for `update` and `stop`. */
     play(voice: AudioVoiceDesc): number;
+    /**
+     * Gets a clip ready to play (a browser decodes it), so its first play starts on time instead of
+     * starting late into the clip. Optional: backends with nothing to prepare leave it out.
+     */
+    preload?(clip: AudioClipSource): void;
     update(voice: number, params: AudioVoiceParams): void;
     /** Stops a voice, fading out over `fade` seconds (default: at once). */
     stop(voice: number, fade?: number): void;

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./workers.js";
+const MODIFIERS = { shift: 1, ctrl: 2, alt: 4, meta: 8 };
 function createMemoryStorage() {
   const data = /* @__PURE__ */ new Map();
   return {
@@ -12,5 +13,6 @@ function createMemoryStorage() {
   };
 }
 export {
+  MODIFIERS,
   createMemoryStorage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-platform",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -16,7 +16,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-core": "0.0.1"
+    "@aethervtt/shard-core": "0.1.0"
   },
   "repository": {
     "type": "git",
@@ -28,6 +28,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+    "buildSha": "8e14c9896f82a3554b156f1ffdd68f2cc3e7d78a"
   }
 }