@native-sdk/core 0.5.1 → 0.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@native-sdk/core",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "The TypeScript authoring tier: the app-core subset, its dev-time transpiler to arena-backed Zig, and the SDK module cores import",
   "repository": {
     "type": "git",

package/sdk/events.ts

@@ -26,8 +26,9 @@
 //   - `TextInputEvent`, `ScrollState`: Msg-arm PAYLOAD fields —
 //     `{ kind: "draft_edit"; edit: TextInputEvent }`,
 //     `{ kind: "scrolled"; scroll: ScrollState }`.
-//   - `FrameEvent`, `KeyEvent`: the wiring channels' parameter records —
-//     `frameMsg(model, frame: FrameEvent)`, `keyMsg(key: KeyEvent)`.
+//   - `FrameEvent`, `KeyEvent`, `PinchEvent`: the wiring channels'
+//     parameter records — `frameMsg(model, frame: FrameEvent)`,
+//     `keyMsg(key: KeyEvent)`, `pinchMsg(pinch: PinchEvent)`.
 //   - `ColorScheme`, `ChromeInsets`, `ChromeButtons`, `AudioState`: field
 //     types INSIDE the arm records the `appearanceMsg`/`chromeMsg`/audio
 //     routes name (the arms themselves stay inline unions of `kind` plus
@@ -72,6 +73,42 @@ export interface KeyEvent {
   readonly super: boolean;
 }
 
+/// The pinch phase vocabulary — a NAMED begin/change/end alias (the host
+/// matches enum members by name, so this is the `phase` field's type in
+/// `pinchMsg`'s parameter record). A host-cancelled gesture folds into
+/// "end": pinch delivers incremental deltas the app applies as they
+/// arrive, so there is no transient state to roll back. A terminal host
+/// event that still measured a nonzero delta delivers it as a final
+/// "change" before the "end", so the cumulative product always matches
+/// what the OS reported.
+export type PinchPhase = "begin" | "change" | "end";
+
+/// The pinch channel's record (`pinchMsg(pinch)`): the trackpad pinch
+/// gesture, phase-explicit. `windowId`/`label` name the source window and
+/// gpu-surface view — `x`/`y` are view-local, so a coordinate without its
+/// view is not a position, and multi-window apps tell pinches apart by
+/// these. `scale` is the magnification DELTA for this event (nonzero
+/// only on "change"), and the delta is MULTIPLICATIVE: the cumulative
+/// gesture scale is the running product of `1 + scale` — apply it
+/// memorylessly, `zoom *= 1 + scale`, no gesture-start bookkeeping. On
+/// macOS this is AppKit's raw per-event `NSEvent.magnification`, which
+/// IS that multiplicative delta per the browser-engine convention, so
+/// the product matches the zoom the same gesture performs in Safari and
+/// Chrome. `x`/`y` is the pointer anchor in view-local canvas
+/// points — the pointer location during the gesture (hosts report gesture
+/// events at the pointer, not at a midpoint between the fingers), so a
+/// zoom can anchor under the cursor. Pinch is a view-global gesture — it
+/// never routes through widgets — so this is the honest home for timeline
+/// and canvas zoom. Only hosts with a pinch source emit it (macOS today).
+export interface PinchEvent {
+  readonly windowId: number;
+  readonly label: string;
+  readonly phase: PinchPhase;
+  readonly scale: number;
+  readonly x: number;
+  readonly y: number;
+}
+
 /// The appearance vocabulary — a NAMED light/dark alias (the host matches
 /// enum members by name, so this is the `colorScheme` field's type in the
 /// arm `appearanceMsg` names).