@gd-kirie/ipc 0.1.1 → 0.2.0

package/README.md

@@ -8,24 +8,73 @@ level bridge on `globalThis`, and this package only wraps that bridge with a sma
 ## API
 
 ```ts
-import { onIpcMessageReceived, sendIpcMessage } from "@gd-kirie/ipc";
+import { onTextReceived, sendText } from "@gd-kirie/ipc";
 
-sendIpcMessage({
+sendText(JSON.stringify({
   type: "web_ready",
-});
+}));
 
-const unsubscribe = onIpcMessageReceived((message) => {
+const unsubscribe = onTextReceived((message) => {
   console.log(message);
 });
 
 unsubscribe();
 ```
 
-`sendIpcMessage()` serializes the message with `JSON.stringify()` and forwards the
-result to the current native bridge:
+The package selects the native transport from `window.kirie.platform`, which is
+injected by Kirie before page scripts run.
+
+Android exposes three channels backed by CBOR packets and AndroidX WebKit
+ArrayBuffer messages. iOS exposes the same lane API over WKWebView script
+messages, carrying each CBOR packet as base64 inside the platform string
+message:
+
+- `sendText()` / `onTextReceived()` for CBOR text strings
+- `sendBinary()` / `onBinaryReceived()` for CBOR byte strings
+- `sendData()` / `onDataReceived()` for CBOR-encoded structured data through `cborg`
+
+The structured data subset is limited to `null`, booleans, numbers, strings,
+arrays, and objects with string keys. JSON message shapes are a caller or
+adapter convention and should be sent with `sendText()` when needed.
+
+## Pointer input forwarding
+
+> [!IMPORTANT]
+> Kirie WebViews normally fill their native host above Godot. CSS transparency
+> does not pass native hit tests through to Godot, so visible Godot controls
+> behind the WebView cannot be clicked without pointer forwarding. Most Kirie
+> pages should import `@gd-kirie/ipc/pointer-input/auto`.
+
+Enable both sides; the browser entry registers on import:
+
+```gdscript
+$KirieNode.pointer_input_forwarding_enabled = true
+```
+
+```ts
+import "@gd-kirie/ipc/pointer-input/auto";
+```
+
+### Custom event orchestration
+
+For custom targets or lifetimes, use the explicit entry instead:
+
+```ts
+import {
+  createPointerEventsHandler,
+  phaseFromPointerEvent,
+  sendPointerEvent,
+} from "@gd-kirie/ipc/pointer-input";
+```
+
+`createPointerEventsHandler()` returns `capture`, `bubble`, and `cancel` handlers;
+the caller owns their registration and removal.
 
-- Android: `globalThis.KirieAndroidBridge.postMessage(...)`
-- iOS: `globalThis.webkit.messageHandlers.kirie.postMessage(...)`
+`pointerdown` bubbling decides ownership: `event.stopPropagation()` keeps the
+sequence in the WebView; otherwise its move, up, and cancel events are forwarded
+to Godot.
 
-`onIpcMessageReceived()` listens for `kirie:ipc-message` events dispatched by the
-native bridge.
+Forwarding uses Godot's
+[`Input.parse_input_event()`](https://docs.godotengine.org/en/stable/classes/class_input.html#class-input-method-parse-input-event)
+API; forwarded mouse and touch events retain their destination
+[`window_id`](https://docs.godotengine.org/en/stable/classes/class_inputeventfromwindow.html#class-inputeventfromwindow-property-window-id).

package/dist/index.d.ts

@@ -1,21 +1,54 @@
 //#region src/index.d.ts
-type AndroidBridge = {
-  postMessage(messageJson: string): void;
-};
-type IosBridge = {
-  postMessage(messageJson: string): void;
-};
+type KiriePlatformOs = "android" | "ios" | "macos" | "windows" | "linux";
+type KiriePlatformBackend = "webview" | "wkwebview" | "godot-cef";
+interface KiriePlatform {
+  os: KiriePlatformOs;
+  backend: KiriePlatformBackend;
+}
+interface KirieRuntime {
+  platform: KiriePlatform;
+}
+interface KirieAndroidChannel {
+  postMessage(message: ArrayBuffer): void;
+  onmessage: ((event: MessageEvent) => void) | null;
+}
+interface KirieIosMessageHandler {
+  postMessage(message: string): void;
+}
+interface KirieIosWebkit {
+  messageHandlers?: {
+    kirie?: KirieIosMessageHandler;
+  };
+}
 declare global {
-  var KirieAndroidBridge: AndroidBridge | undefined;
-  var webkit: {
-    messageHandlers?: {
-      kirie?: IosBridge;
-    };
-  } | undefined;
+  interface Window {
+    kirie?: KirieRuntime;
+    KirieTextChannel?: KirieAndroidChannel;
+    KirieBinaryChannel?: KirieAndroidChannel;
+    KirieDataChannel?: KirieAndroidChannel;
+    webkit?: KirieIosWebkit;
+    sendIpcMessage(message: string): void;
+    sendIpcBinaryMessage(message: ArrayBuffer): void;
+    sendIpcData(message: KirieData): void;
+    onIpcMessage?: KirieMessageHandler<string>;
+    onIpcBinaryMessage?: KirieMessageHandler<ArrayBuffer>;
+    onIpcDataMessage?: KirieMessageHandler<KirieData>;
+  }
 }
-type KirieIpcMessageHandler<TMessage = unknown> = (message: TMessage) => void;
-declare function sendIpcMessage(message: unknown): void;
-declare function onIpcMessageReceived<TMessage = unknown>(handler: KirieIpcMessageHandler<TMessage>): () => void;
+/**
+* Structured data lane subset shared with Godot Variant data.
+* It intentionally excludes engine-local and JavaScript-local object types.
+*/
+type KirieData = null | boolean | number | string | KirieData[] | {
+  [key: string]: KirieData;
+};
+type KirieMessageHandler<TMessage> = (message: TMessage) => void;
+declare function sendText(message: string): void;
+declare function sendBinary(bytes: Uint8Array): void;
+declare function sendData(value: KirieData): void;
+declare function onTextReceived(handler: KirieMessageHandler<string>): () => void;
+declare function onBinaryReceived(handler: KirieMessageHandler<Uint8Array>): () => void;
+declare function onDataReceived(handler: KirieMessageHandler<KirieData>): () => void;
 //#endregion
-export { KirieIpcMessageHandler, onIpcMessageReceived, sendIpcMessage };
+export { KirieData, KirieMessageHandler, KiriePlatform, KiriePlatformBackend, KiriePlatformOs, KirieRuntime, onBinaryReceived, onDataReceived, onTextReceived, sendBinary, sendData, sendText };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAEK,aAAA;EACH,WAAA,CAAY,WAAA;AAAA;AAAA,KAGT,SAAA;EACH,WAAA,CAAY,WAAA;AAAA;AAAA;MAIR,kBAAA,EAAoB,aAAA;EAAA,IAEpB,MAAA;IAEE,eAAA;MACE,KAAA,GAAQ,SAAA;IAAA;EAAA;AAAA;AAAA,KAMN,sBAAA,wBAA8C,OAAA,EAAS,QAAA;AAAA,iBAEnD,cAAA,CAAe,OAAA;AAAA,iBAuBf,oBAAA,oBAAA,CACd,OAAA,EAAS,sBAAA,CAAuB,QAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAKY,eAAA;AAAA,KACA,oBAAA;AAAA,UAEK,aAAA;EACf,EAAA,EAAI,eAAA;EACJ,OAAA,EAAS,oBAAA;AAAA;AAAA,UAGM,YAAA;EACf,QAAA,EAAU,aAAA;AAAA;AAAA,UAGF,mBAAA;EACR,WAAA,CAAY,OAAA,EAAS,WAAA;EACrB,SAAA,IAAa,KAAA,EAAO,YAAA;AAAA;AAAA,UAGZ,sBAAA;EACR,WAAA,CAAY,OAAA;AAAA;AAAA,UAUJ,cAAA;EACR,eAAA;IACE,KAAA,GAAQ,sBAAA;EAAA;AAAA;AAAA;YAKA,MAAA;IACR,KAAA,GAAQ,YAAA;IACR,gBAAA,GAAmB,mBAAA;IACnB,kBAAA,GAAqB,mBAAA;IACrB,gBAAA,GAAmB,mBAAA;IACnB,MAAA,GAAS,cAAA;IACT,cAAA,CAAe,OAAA;IACf,oBAAA,CAAqB,OAAA,EAAS,WAAA;IAC9B,WAAA,CAAY,OAAA,EAAS,SAAA;IACrB,YAAA,GAAe,mBAAA;IACf,kBAAA,GAAqB,mBAAA,CAAoB,WAAA;IACzC,gBAAA,GAAmB,mBAAA,CAAoB,SAAA;EAAA;AAAA;;AAhCrB;AAAA;;KAwCV,SAAA,sCAKR,SAAA;EAAA,eACiB,SAAA;AAAA;AAAA,KAET,mBAAA,cAAiC,OAAA,EAAS,QAAA;AAAA,iBAqRtC,QAAA,CAAS,OAAA;AAAA,iBAIT,UAAA,CAAW,KAAO,EAAA,UAAA;AAAA,iBAIlB,QAAA,CAAS,KAAO,EAAA,SAAA;AAAA,iBAIhB,cAAA,CAAe,OAAS,EAAA,mBAAA;AAAA,iBAIxB,gBAAA,CAAiB,OAAA,EAAS,mBAAA,CAAoB,UAAA;AAAA,iBAI9C,cAAA,CAAe,OAAA,EAAS,mBAAA,CAAoB,SAAA"}

package/dist/index.js

@@ -1,30 +1,175 @@
+import { decode, encode } from "cborg";
 //#region src/index.ts
-const IPC_MESSAGE_EVENT = "kirie:ipc-message";
-function sendIpcMessage(message) {
-	const messageJson = JSON.stringify(message);
-	if (messageJson === void 0) throw new TypeError("Kirie IPC message root must serialize to a JSON string. See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#description for details.");
-	const androidBridge = globalThis.KirieAndroidBridge;
-	if (androidBridge) {
-		androidBridge.postMessage(messageJson);
-		return;
-	}
-	const iosBridge = globalThis.webkit?.messageHandlers?.kirie;
-	if (iosBridge) {
-		iosBridge.postMessage(messageJson);
-		return;
+const READY_MESSAGE = /* @__PURE__ */ new ArrayBuffer(0);
+const ENCODE_OPTIONS = { float64: true };
+function asArrayBuffer(bytes) {
+	if (bytes.buffer instanceof ArrayBuffer && bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) return bytes.buffer;
+	const copy = new Uint8Array(bytes.byteLength);
+	copy.set(bytes);
+	return copy.buffer;
+}
+function asUint8Array(value) {
+	if (value instanceof ArrayBuffer) return new Uint8Array(value);
+	throw new TypeError("Kirie message must be an ArrayBuffer.");
+}
+function decodeText(value) {
+	const decoded = decode(asUint8Array(value));
+	if (typeof decoded !== "string") throw new TypeError("Kirie text message must decode to a string.");
+	return decoded;
+}
+function decodeBinary(value) {
+	const decoded = decode(asUint8Array(value));
+	if (decoded instanceof Uint8Array) return decoded;
+	throw new TypeError("Kirie binary message must decode to bytes.");
+}
+function currentTransport() {
+	const platform = window.kirie?.platform;
+	return transports[`${platform?.os}/${platform?.backend}`];
+}
+function listenAndroid(channel, read, handler) {
+	const listener = (event) => {
+		handler(read(event.data));
+	};
+	channel.onmessage = listener;
+	channel.postMessage(READY_MESSAGE);
+	return () => {
+		if (channel.onmessage === listener) channel.onmessage = null;
+	};
+}
+function requireAndroidChannel(name) {
+	const channel = window[name];
+	if (!channel) throw new Error(`Kirie Android channel is not available: ${name}`);
+	return channel;
+}
+const androidTransport = {
+	sendText(message) {
+		requireAndroidChannel("KirieTextChannel").postMessage(asArrayBuffer(encode(message, ENCODE_OPTIONS)));
+	},
+	sendBinary(bytes) {
+		requireAndroidChannel("KirieBinaryChannel").postMessage(asArrayBuffer(encode(bytes, ENCODE_OPTIONS)));
+	},
+	sendData(value) {
+		requireAndroidChannel("KirieDataChannel").postMessage(asArrayBuffer(encode(value, ENCODE_OPTIONS)));
+	},
+	onTextReceived(handler) {
+		return listenAndroid(requireAndroidChannel("KirieTextChannel"), decodeText, handler);
+	},
+	onBinaryReceived(handler) {
+		return listenAndroid(requireAndroidChannel("KirieBinaryChannel"), decodeBinary, handler);
+	},
+	onDataReceived(handler) {
+		return listenAndroid(requireAndroidChannel("KirieDataChannel"), (value) => decode(asUint8Array(value)), handler);
 	}
-	throw new Error("Kirie native IPC bridge is not available.");
+};
+function requireIosMessageHandler() {
+	const handler = window.webkit?.messageHandlers?.kirie;
+	if (!handler) throw new Error("Kirie iOS message handler is not available: window.webkit.messageHandlers.kirie");
+	return handler;
+}
+function bytesToBase64(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
 }
-function onIpcMessageReceived(handler) {
+function base64ToArrayBuffer(encoded) {
+	const binary = atob(encoded);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	return bytes.buffer;
+}
+function postIosPacket(lane, packet) {
+	requireIosMessageHandler().postMessage(JSON.stringify({
+		lane,
+		packet: bytesToBase64(packet)
+	}));
+}
+function listenIos(lane, read, handler) {
 	const listener = (event) => {
-		handler(event.detail);
+		if (!(event instanceof CustomEvent) || !isIosPacketMessage(event.detail)) return;
+		if (event.detail.lane !== lane) return;
+		handler(read(base64ToArrayBuffer(event.detail.packet)));
 	};
-	globalThis.addEventListener(IPC_MESSAGE_EVENT, listener);
+	window.addEventListener("kirie:ipc-packet", listener);
+	return () => window.removeEventListener("kirie:ipc-packet", listener);
+}
+function isIosPacketMessage(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const message = value;
+	return (message.lane === "text" || message.lane === "binary" || message.lane === "data") && typeof message.packet === "string";
+}
+const iosTransport = {
+	sendText(message) {
+		postIosPacket("text", encode(message, ENCODE_OPTIONS));
+	},
+	sendBinary(bytes) {
+		postIosPacket("binary", encode(bytes, ENCODE_OPTIONS));
+	},
+	sendData(value) {
+		postIosPacket("data", encode(value, ENCODE_OPTIONS));
+	},
+	onTextReceived(handler) {
+		return listenIos("text", decodeText, handler);
+	},
+	onBinaryReceived(handler) {
+		return listenIos("binary", decodeBinary, handler);
+	},
+	onDataReceived(handler) {
+		return listenIos("data", (value) => decode(asUint8Array(value)), handler);
+	}
+};
+function listenCefLegacy(name, handler) {
+	const callbacks = window;
+	callbacks[name] = handler;
 	return () => {
-		globalThis.removeEventListener(IPC_MESSAGE_EVENT, listener);
+		if (callbacks[name] === handler) callbacks[name] = void 0;
 	};
 }
+const cefTransport = {
+	sendText(message) {
+		window.sendIpcMessage(message);
+	},
+	sendBinary(bytes) {
+		window.sendIpcBinaryMessage(asArrayBuffer(bytes));
+	},
+	sendData(value) {
+		window.sendIpcData(value);
+	},
+	onTextReceived(handler) {
+		return listenCefLegacy("onIpcMessage", handler);
+	},
+	onBinaryReceived(handler) {
+		return listenCefLegacy("onIpcBinaryMessage", (value) => handler(new Uint8Array(value)));
+	},
+	onDataReceived(handler) {
+		return listenCefLegacy("onIpcDataMessage", handler);
+	}
+};
+const transports = {
+	"android/webview": androidTransport,
+	"ios/wkwebview": iosTransport,
+	"linux/godot-cef": cefTransport,
+	"macos/godot-cef": cefTransport,
+	"windows/godot-cef": cefTransport
+};
+function sendText(message) {
+	currentTransport().sendText(message);
+}
+function sendBinary(bytes) {
+	currentTransport().sendBinary(bytes);
+}
+function sendData(value) {
+	currentTransport().sendData(value);
+}
+function onTextReceived(handler) {
+	return currentTransport().onTextReceived(handler);
+}
+function onBinaryReceived(handler) {
+	return currentTransport().onBinaryReceived(handler);
+}
+function onDataReceived(handler) {
+	return currentTransport().onDataReceived(handler);
+}
 //#endregion
-export { onIpcMessageReceived, sendIpcMessage };
+export { onBinaryReceived, onDataReceived, onTextReceived, sendBinary, sendData, sendText };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["const IPC_MESSAGE_EVENT = \"kirie:ipc-message\";\n\ntype AndroidBridge = {\n  postMessage(messageJson: string): void;\n};\n\ntype IosBridge = {\n  postMessage(messageJson: string): void;\n};\n\ndeclare global {\n  var KirieAndroidBridge: AndroidBridge | undefined;\n\n  var webkit:\n    | {\n        messageHandlers?: {\n          kirie?: IosBridge;\n        };\n      }\n    | undefined;\n}\n\nexport type KirieIpcMessageHandler<TMessage = unknown> = (message: TMessage) => void;\n\nexport function sendIpcMessage(message: unknown): void {\n  const messageJson = JSON.stringify(message);\n  if (messageJson === undefined) {\n    throw new TypeError(\n      \"Kirie IPC message root must serialize to a JSON string. See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#description for details.\",\n    );\n  }\n\n  const androidBridge = globalThis.KirieAndroidBridge;\n  if (androidBridge) {\n    androidBridge.postMessage(messageJson);\n    return;\n  }\n\n  const iosBridge = globalThis.webkit?.messageHandlers?.kirie;\n  if (iosBridge) {\n    iosBridge.postMessage(messageJson);\n    return;\n  }\n\n  throw new Error(\"Kirie native IPC bridge is not available.\");\n}\n\nexport function onIpcMessageReceived<TMessage = unknown>(\n  handler: KirieIpcMessageHandler<TMessage>,\n): () => void {\n  const listener = (event: Event) => {\n    handler((event as CustomEvent<TMessage>).detail);\n  };\n\n  globalThis.addEventListener(IPC_MESSAGE_EVENT, listener);\n\n  return () => {\n    globalThis.removeEventListener(IPC_MESSAGE_EVENT, listener);\n  };\n}\n"],"mappings":";AAAA,MAAM,oBAAoB;AAwB1B,SAAgB,eAAe,SAAwB;CACrD,MAAM,cAAc,KAAK,UAAU,QAAQ;AAC3C,KAAI,gBAAgB,KAAA,EAClB,OAAM,IAAI,UACR,uLACD;CAGH,MAAM,gBAAgB,WAAW;AACjC,KAAI,eAAe;AACjB,gBAAc,YAAY,YAAY;AACtC;;CAGF,MAAM,YAAY,WAAW,QAAQ,iBAAiB;AACtD,KAAI,WAAW;AACb,YAAU,YAAY,YAAY;AAClC;;AAGF,OAAM,IAAI,MAAM,4CAA4C;;AAG9D,SAAgB,qBACd,SACY;CACZ,MAAM,YAAY,UAAiB;AACjC,UAAS,MAAgC,OAAO;;AAGlD,YAAW,iBAAiB,mBAAmB,SAAS;AAExD,cAAa;AACX,aAAW,oBAAoB,mBAAmB,SAAS"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { decode, encode } from \"cborg\";\n\nconst READY_MESSAGE = new ArrayBuffer(0);\nconst ENCODE_OPTIONS = { float64: true } as const;\n\nexport type KiriePlatformOs = \"android\" | \"ios\" | \"macos\" | \"windows\" | \"linux\";\nexport type KiriePlatformBackend = \"webview\" | \"wkwebview\" | \"godot-cef\";\n\nexport interface KiriePlatform {\n  os: KiriePlatformOs;\n  backend: KiriePlatformBackend;\n}\n\nexport interface KirieRuntime {\n  platform: KiriePlatform;\n}\n\ninterface KirieAndroidChannel {\n  postMessage(message: ArrayBuffer): void;\n  onmessage: ((event: MessageEvent) => void) | null;\n}\n\ninterface KirieIosMessageHandler {\n  postMessage(message: string): void;\n}\n\ntype KirieLane = \"text\" | \"binary\" | \"data\";\n\ninterface KirieIosPacketMessage {\n  lane: KirieLane;\n  packet: string;\n}\n\ninterface KirieIosWebkit {\n  messageHandlers?: {\n    kirie?: KirieIosMessageHandler;\n  };\n}\n\ndeclare global {\n  interface Window {\n    kirie?: KirieRuntime;\n    KirieTextChannel?: KirieAndroidChannel;\n    KirieBinaryChannel?: KirieAndroidChannel;\n    KirieDataChannel?: KirieAndroidChannel;\n    webkit?: KirieIosWebkit;\n    sendIpcMessage(message: string): void;\n    sendIpcBinaryMessage(message: ArrayBuffer): void;\n    sendIpcData(message: KirieData): void;\n    onIpcMessage?: KirieMessageHandler<string>;\n    onIpcBinaryMessage?: KirieMessageHandler<ArrayBuffer>;\n    onIpcDataMessage?: KirieMessageHandler<KirieData>;\n  }\n}\n\n/**\n * Structured data lane subset shared with Godot Variant data.\n * It intentionally excludes engine-local and JavaScript-local object types.\n */\nexport type KirieData =\n  | null\n  | boolean\n  | number\n  | string\n  | KirieData[]\n  | { [key: string]: KirieData };\n\nexport type KirieMessageHandler<TMessage> = (message: TMessage) => void;\n\ninterface KirieTransport {\n  sendText(message: string): void;\n  sendBinary(bytes: Uint8Array): void;\n  sendData(value: KirieData): void;\n  onTextReceived(handler: KirieMessageHandler<string>): () => void;\n  onBinaryReceived(handler: KirieMessageHandler<Uint8Array>): () => void;\n  onDataReceived(handler: KirieMessageHandler<KirieData>): () => void;\n}\n\nfunction asArrayBuffer(bytes: Uint8Array): ArrayBuffer {\n  if (\n    bytes.buffer instanceof ArrayBuffer &&\n    bytes.byteOffset === 0 &&\n    bytes.byteLength === bytes.buffer.byteLength\n  ) {\n    return bytes.buffer;\n  }\n\n  const copy = new Uint8Array(bytes.byteLength);\n  copy.set(bytes);\n  return copy.buffer as ArrayBuffer;\n}\n\nfunction asUint8Array(value: unknown): Uint8Array {\n  if (value instanceof ArrayBuffer) {\n    return new Uint8Array(value);\n  }\n\n  throw new TypeError(\"Kirie message must be an ArrayBuffer.\");\n}\n\nfunction decodeText(value: unknown): string {\n  const decoded = decode(asUint8Array(value));\n  if (typeof decoded !== \"string\") {\n    throw new TypeError(\"Kirie text message must decode to a string.\");\n  }\n\n  return decoded;\n}\n\nfunction decodeBinary(value: unknown): Uint8Array {\n  const decoded = decode(asUint8Array(value));\n  if (decoded instanceof Uint8Array) {\n    return decoded;\n  }\n\n  throw new TypeError(\"Kirie binary message must decode to bytes.\");\n}\n\nfunction currentTransport(): KirieTransport {\n  const platform = window.kirie?.platform;\n  return transports[`${platform?.os}/${platform?.backend}`];\n}\n\nfunction listenAndroid<TMessage>(\n  channel: KirieAndroidChannel,\n  read: (value: unknown) => TMessage,\n  handler: KirieMessageHandler<TMessage>,\n): () => void {\n  const listener = (event: MessageEvent) => {\n    handler(read(event.data));\n  };\n\n  channel.onmessage = listener;\n  channel.postMessage(READY_MESSAGE);\n\n  return () => {\n    if (channel.onmessage === listener) {\n      channel.onmessage = null;\n    }\n  };\n}\n\nfunction requireAndroidChannel(\n  name: \"KirieTextChannel\" | \"KirieBinaryChannel\" | \"KirieDataChannel\",\n): KirieAndroidChannel {\n  const channel = window[name];\n  if (!channel) {\n    throw new Error(`Kirie Android channel is not available: ${name}`);\n  }\n\n  return channel;\n}\n\nconst androidTransport: KirieTransport = {\n  sendText(message) {\n    requireAndroidChannel(\"KirieTextChannel\").postMessage(\n      asArrayBuffer(encode(message, ENCODE_OPTIONS)),\n    );\n  },\n\n  sendBinary(bytes) {\n    requireAndroidChannel(\"KirieBinaryChannel\").postMessage(\n      asArrayBuffer(encode(bytes, ENCODE_OPTIONS)),\n    );\n  },\n\n  sendData(value) {\n    requireAndroidChannel(\"KirieDataChannel\").postMessage(\n      asArrayBuffer(encode(value, ENCODE_OPTIONS)),\n    );\n  },\n\n  onTextReceived(handler) {\n    return listenAndroid(requireAndroidChannel(\"KirieTextChannel\"), decodeText, handler);\n  },\n\n  onBinaryReceived(handler) {\n    return listenAndroid(requireAndroidChannel(\"KirieBinaryChannel\"), decodeBinary, handler);\n  },\n\n  onDataReceived(handler) {\n    return listenAndroid(\n      requireAndroidChannel(\"KirieDataChannel\"),\n      (value) => decode(asUint8Array(value)) as KirieData,\n      handler,\n    );\n  },\n};\n\nfunction requireIosMessageHandler(): KirieIosMessageHandler {\n  const handler = window.webkit?.messageHandlers?.kirie;\n  if (!handler) {\n    throw new Error(\n      \"Kirie iOS message handler is not available: window.webkit.messageHandlers.kirie\",\n    );\n  }\n\n  return handler;\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  let binary = \"\";\n  for (const byte of bytes) {\n    binary += String.fromCharCode(byte);\n  }\n\n  return btoa(binary);\n}\n\nfunction base64ToArrayBuffer(encoded: string): ArrayBuffer {\n  const binary = atob(encoded);\n  const bytes = new Uint8Array(binary.length);\n  for (let index = 0; index < binary.length; index += 1) {\n    bytes[index] = binary.charCodeAt(index);\n  }\n\n  return bytes.buffer as ArrayBuffer;\n}\n\nfunction postIosPacket(lane: KirieLane, packet: Uint8Array): void {\n  requireIosMessageHandler().postMessage(\n    JSON.stringify({\n      lane,\n      packet: bytesToBase64(packet),\n    } satisfies KirieIosPacketMessage),\n  );\n}\n\nfunction listenIos<TMessage>(\n  lane: KirieLane,\n  read: (value: unknown) => TMessage,\n  handler: KirieMessageHandler<TMessage>,\n): () => void {\n  const listener = (event: Event) => {\n    if (!(event instanceof CustomEvent) || !isIosPacketMessage(event.detail)) {\n      return;\n    }\n\n    if (event.detail.lane !== lane) {\n      return;\n    }\n\n    handler(read(base64ToArrayBuffer(event.detail.packet)));\n  };\n\n  window.addEventListener(\"kirie:ipc-packet\", listener);\n  return () => window.removeEventListener(\"kirie:ipc-packet\", listener);\n}\n\nfunction isIosPacketMessage(value: unknown): value is KirieIosPacketMessage {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const message = value as Partial<KirieIosPacketMessage>;\n  return (\n    (message.lane === \"text\" || message.lane === \"binary\" || message.lane === \"data\") &&\n    typeof message.packet === \"string\"\n  );\n}\n\nconst iosTransport: KirieTransport = {\n  sendText(message) {\n    postIosPacket(\"text\", encode(message, ENCODE_OPTIONS));\n  },\n\n  sendBinary(bytes) {\n    postIosPacket(\"binary\", encode(bytes, ENCODE_OPTIONS));\n  },\n\n  sendData(value) {\n    postIosPacket(\"data\", encode(value, ENCODE_OPTIONS));\n  },\n\n  onTextReceived(handler) {\n    return listenIos(\"text\", decodeText, handler);\n  },\n\n  onBinaryReceived(handler) {\n    return listenIos(\"binary\", decodeBinary, handler);\n  },\n\n  onDataReceived(handler) {\n    return listenIos(\"data\", (value) => decode(asUint8Array(value)) as KirieData, handler);\n  },\n};\n\ntype KirieCefCallbackName = \"onIpcMessage\" | \"onIpcBinaryMessage\" | \"onIpcDataMessage\";\n\ninterface KirieCefCallbacks {\n  onIpcMessage?: KirieMessageHandler<string>;\n  onIpcBinaryMessage?: KirieMessageHandler<ArrayBuffer>;\n  onIpcDataMessage?: KirieMessageHandler<KirieData>;\n}\n\nfunction listenCefLegacy<TName extends KirieCefCallbackName>(\n  name: TName,\n  handler: KirieCefCallbacks[TName],\n): () => void {\n  const callbacks = window as unknown as KirieCefCallbacks;\n  callbacks[name] = handler;\n\n  return () => {\n    if (callbacks[name] === handler) {\n      callbacks[name] = undefined;\n    }\n  };\n}\n\nconst cefTransport: KirieTransport = {\n  sendText(message) {\n    window.sendIpcMessage(message);\n  },\n\n  sendBinary(bytes) {\n    window.sendIpcBinaryMessage(asArrayBuffer(bytes));\n  },\n\n  sendData(value) {\n    window.sendIpcData(value);\n  },\n\n  onTextReceived(handler) {\n    // TODO: Switch to Godot CEF listener objects after the upstream addListener lifecycle fix ships.\n    return listenCefLegacy(\"onIpcMessage\", handler);\n  },\n\n  onBinaryReceived(handler) {\n    return listenCefLegacy(\"onIpcBinaryMessage\", (value) => handler(new Uint8Array(value)));\n  },\n\n  onDataReceived(handler) {\n    return listenCefLegacy(\"onIpcDataMessage\", handler);\n  },\n};\n\nconst transports: Record<string, KirieTransport> = {\n  \"android/webview\": androidTransport,\n  \"ios/wkwebview\": iosTransport,\n  \"linux/godot-cef\": cefTransport,\n  \"macos/godot-cef\": cefTransport,\n  \"windows/godot-cef\": cefTransport,\n};\n\nexport function sendText(message: string): void {\n  currentTransport().sendText(message);\n}\n\nexport function sendBinary(bytes: Uint8Array): void {\n  currentTransport().sendBinary(bytes);\n}\n\nexport function sendData(value: KirieData): void {\n  currentTransport().sendData(value);\n}\n\nexport function onTextReceived(handler: KirieMessageHandler<string>): () => void {\n  return currentTransport().onTextReceived(handler);\n}\n\nexport function onBinaryReceived(handler: KirieMessageHandler<Uint8Array>): () => void {\n  return currentTransport().onBinaryReceived(handler);\n}\n\nexport function onDataReceived(handler: KirieMessageHandler<KirieData>): () => void {\n  return currentTransport().onDataReceived(handler);\n}\n"],"mappings":"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"}

package/dist/pointer-input/auto.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/pointer-input/auto.js

@@ -0,0 +1,11 @@
+import { createPointerEventsHandler } from "./index.js";
+//#region src/pointer-input/auto.ts
+const pointerEventsHandler = createPointerEventsHandler();
+document.addEventListener("pointerdown", pointerEventsHandler.bubble);
+document.addEventListener("pointermove", pointerEventsHandler.capture, true);
+document.addEventListener("pointerup", pointerEventsHandler.capture, true);
+document.addEventListener("pointercancel", pointerEventsHandler.capture, true);
+document.addEventListener("pointermove", pointerEventsHandler.bubble);
+//#endregion
+
+//# sourceMappingURL=auto.js.map

package/dist/pointer-input/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","names":[],"sources":["../../src/pointer-input/auto.ts"],"sourcesContent":["import { createPointerEventsHandler } from \"./index\";\n\nconst pointerEventsHandler = createPointerEventsHandler();\n\ndocument.addEventListener(\"pointerdown\", pointerEventsHandler.bubble);\ndocument.addEventListener(\"pointermove\", pointerEventsHandler.capture, true);\ndocument.addEventListener(\"pointerup\", pointerEventsHandler.capture, true);\ndocument.addEventListener(\"pointercancel\", pointerEventsHandler.capture, true);\ndocument.addEventListener(\"pointermove\", pointerEventsHandler.bubble);\n"],"mappings":";;AAEA,MAAM,uBAAuB,2BAA2B;AAExD,SAAS,iBAAiB,eAAe,qBAAqB,MAAM;AACpE,SAAS,iBAAiB,eAAe,qBAAqB,SAAS,IAAI;AAC3E,SAAS,iBAAiB,aAAa,qBAAqB,SAAS,IAAI;AACzE,SAAS,iBAAiB,iBAAiB,qBAAqB,SAAS,IAAI;AAC7E,SAAS,iBAAiB,eAAe,qBAAqB,MAAM"}

package/dist/pointer-input/index.d.ts

@@ -0,0 +1,14 @@
+//#region src/pointer-input/index.d.ts
+type PointerPhase = "down" | "move" | "up" | "cancel";
+type PointerEventSender = (event: PointerEvent, phase?: PointerPhase) => void;
+interface PointerEventsHandler {
+  capture(event: PointerEvent): void;
+  bubble(event: PointerEvent): void;
+  cancel(): void;
+}
+declare function sendPointerEvent(event: PointerEvent, phase?: PointerPhase): void;
+declare function createPointerEventsHandler(sendPointer?: PointerEventSender): PointerEventsHandler;
+declare function phaseFromPointerEvent(event: PointerEvent): PointerPhase;
+//#endregion
+export { PointerEventSender, PointerEventsHandler, PointerPhase, createPointerEventsHandler, phaseFromPointerEvent, sendPointerEvent };
+//# sourceMappingURL=index.d.ts.map

package/dist/pointer-input/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/pointer-input/index.ts"],"mappings":";KAGY,YAAA;AAAA,KAmBA,kBAAA,IAAsB,KAAA,EAAO,YAAA,EAAc,KAAA,GAAQ,YAAA;AAAA,UAE9C,oBAAA;EACf,OAAA,CAAQ,KAAA,EAAO,YAAA;EACf,MAAA,CAAO,KAAA,EAAO,YAAA;EACd,MAAA;AAAA;AAAA,iBAGc,gBAAA,CACd,KAAA,EAAO,YAAA,EACP,KAAA,GAAO,YAAA;AAAA,iBAwBO,0BAAA,CACd,WAAA,GAAa,kBAAA,GACZ,oBAAA;AAAA,iBA8Fa,qBAAA,CAAsB,KAAA,EAAO,YAAA,GAAe,YAAA"}

package/dist/pointer-input/index.js

@@ -0,0 +1,105 @@
+import { sendData } from "../index.js";
+//#region src/pointer-input/index.ts
+function sendPointerEvent(event, phase = phaseFromPointerEvent(event)) {
+	const view = event.view ?? window;
+	const pointerType = event.pointerType;
+	if (pointerType !== "mouse" && pointerType !== "pen" && pointerType !== "touch") throw new TypeError(`Kirie cannot forward pointer type: ${pointerType}`);
+	sendData({ __gd_kirie_control: {
+		kind: "pointer",
+		phase,
+		pointer_id: event.pointerId,
+		pointer_type: pointerType,
+		normalized_x: event.clientX / view.innerWidth,
+		normalized_y: event.clientY / view.innerHeight,
+		button: event.button,
+		buttons: event.buttons,
+		pressure: event.pressure
+	} });
+}
+function createPointerEventsHandler(sendPointer = sendPointerEvent) {
+	const claimedPointers = /* @__PURE__ */ new Map();
+	/**
+	* Completes events for pointer sequences previously claimed during bubbling.
+	*
+	* Triggering workflow:
+	*
+	* {@link EventTarget.addEventListener}
+	*   -> `pointermove|pointerup|pointercancel`
+	*     -> {@link capture}
+	*
+	* Upstream:
+	* - {@link EventTarget.addEventListener}
+	*
+	* Downstream:
+	* - {@link sendPointerEvent}
+	*/
+	const capture = (event) => {
+		if (!claimedPointers.has(event.pointerId) || event.type !== "pointermove" && event.type !== "pointerup" && event.type !== "pointercancel") return;
+		sendPointer(event);
+		if (event.type === "pointerup" || event.type === "pointercancel") {
+			claimedPointers.delete(event.pointerId);
+			return;
+		}
+		claimedPointers.set(event.pointerId, event);
+	};
+	/**
+	* Claims bubbled pointer downs and forwards unpressed mouse hover.
+	*
+	* Triggering workflow:
+	*
+	* {@link EventTarget.addEventListener}
+	*   -> `pointerdown|pointermove`
+	*     -> {@link bubble}
+	*
+	* Upstream:
+	* - {@link EventTarget.addEventListener}
+	*
+	* Downstream:
+	* - {@link sendPointerEvent}
+	*/
+	const bubble = (event) => {
+		if (event.type === "pointerdown") {
+			sendPointer(event);
+			claimedPointers.set(event.pointerId, event);
+			return;
+		}
+		if (event.type !== "pointermove" || claimedPointers.has(event.pointerId) || event.pointerType !== "mouse" || event.buttons !== 0) return;
+		sendPointer(event);
+	};
+	/**
+	* Cancels every pointer sequence currently claimed by this handler.
+	*
+	* Triggering workflow:
+	*
+	* {@link createPointerEventsHandler}
+	*   -> {@link PointerEventsHandler.cancel}
+	*
+	* Upstream:
+	* - caller of {@link PointerEventsHandler.cancel}
+	*
+	* Downstream:
+	* - {@link sendPointerEvent}
+	*/
+	const cancel = () => {
+		for (const pointerEvent of claimedPointers.values()) sendPointer(pointerEvent, "cancel");
+		claimedPointers.clear();
+	};
+	return {
+		capture,
+		bubble,
+		cancel
+	};
+}
+function phaseFromPointerEvent(event) {
+	switch (event.type) {
+		case "pointerdown": return "down";
+		case "pointermove": return "move";
+		case "pointerup": return "up";
+		case "pointercancel": return "cancel";
+		default: throw new TypeError(`Kirie cannot forward pointer event type: ${event.type}`);
+	}
+}
+//#endregion
+export { createPointerEventsHandler, phaseFromPointerEvent, sendPointerEvent };
+
+//# sourceMappingURL=index.js.map

package/dist/pointer-input/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/pointer-input/index.ts"],"sourcesContent":["import type { KirieData } from \"../index\";\nimport { sendData } from \"../index\";\n\nexport type PointerPhase = \"down\" | \"move\" | \"up\" | \"cancel\";\ntype PointerType = \"mouse\" | \"pen\" | \"touch\";\n\ninterface PointerInputRecord extends Record<string, KirieData> {\n  kind: \"pointer\";\n  phase: PointerPhase;\n  pointer_id: number;\n  pointer_type: PointerType;\n  normalized_x: number;\n  normalized_y: number;\n  button: number;\n  buttons: number;\n  pressure: number;\n}\n\ninterface PointerControlRecord extends Record<string, KirieData> {\n  __gd_kirie_control: PointerInputRecord;\n}\n\nexport type PointerEventSender = (event: PointerEvent, phase?: PointerPhase) => void;\n\nexport interface PointerEventsHandler {\n  capture(event: PointerEvent): void;\n  bubble(event: PointerEvent): void;\n  cancel(): void;\n}\n\nexport function sendPointerEvent(\n  event: PointerEvent,\n  phase: PointerPhase = phaseFromPointerEvent(event),\n): void {\n  const view = event.view ?? window;\n\n  const pointerType = event.pointerType;\n  if (pointerType !== \"mouse\" && pointerType !== \"pen\" && pointerType !== \"touch\") {\n    throw new TypeError(`Kirie cannot forward pointer type: ${pointerType}`);\n  }\n\n  sendData({\n    __gd_kirie_control: {\n      kind: \"pointer\",\n      phase,\n      pointer_id: event.pointerId,\n      pointer_type: pointerType,\n      normalized_x: event.clientX / view.innerWidth,\n      normalized_y: event.clientY / view.innerHeight,\n      button: event.button,\n      buttons: event.buttons,\n      pressure: event.pressure,\n    },\n  } satisfies PointerControlRecord);\n}\n\nexport function createPointerEventsHandler(\n  sendPointer: PointerEventSender = sendPointerEvent,\n): PointerEventsHandler {\n  // A sequence is claimed only when its down event reaches the document bubble phase.\n  const claimedPointers = new Map<number, PointerEvent>();\n\n  /**\n   * Completes events for pointer sequences previously claimed during bubbling.\n   *\n   * Triggering workflow:\n   *\n   * {@link EventTarget.addEventListener}\n   *   -> `pointermove|pointerup|pointercancel`\n   *     -> {@link capture}\n   *\n   * Upstream:\n   * - {@link EventTarget.addEventListener}\n   *\n   * Downstream:\n   * - {@link sendPointerEvent}\n   */\n  const capture = (event: PointerEvent): void => {\n    if (\n      !claimedPointers.has(event.pointerId) ||\n      (event.type !== \"pointermove\" && event.type !== \"pointerup\" && event.type !== \"pointercancel\")\n    ) {\n      return;\n    }\n\n    sendPointer(event);\n    if (event.type === \"pointerup\" || event.type === \"pointercancel\") {\n      claimedPointers.delete(event.pointerId);\n      return;\n    }\n\n    claimedPointers.set(event.pointerId, event);\n  };\n\n  /**\n   * Claims bubbled pointer downs and forwards unpressed mouse hover.\n   *\n   * Triggering workflow:\n   *\n   * {@link EventTarget.addEventListener}\n   *   -> `pointerdown|pointermove`\n   *     -> {@link bubble}\n   *\n   * Upstream:\n   * - {@link EventTarget.addEventListener}\n   *\n   * Downstream:\n   * - {@link sendPointerEvent}\n   */\n  const bubble = (event: PointerEvent): void => {\n    if (event.type === \"pointerdown\") {\n      sendPointer(event);\n      claimedPointers.set(event.pointerId, event);\n      return;\n    }\n\n    if (\n      event.type !== \"pointermove\" ||\n      claimedPointers.has(event.pointerId) ||\n      event.pointerType !== \"mouse\" ||\n      event.buttons !== 0\n    ) {\n      return;\n    }\n\n    sendPointer(event);\n  };\n\n  /**\n   * Cancels every pointer sequence currently claimed by this handler.\n   *\n   * Triggering workflow:\n   *\n   * {@link createPointerEventsHandler}\n   *   -> {@link PointerEventsHandler.cancel}\n   *\n   * Upstream:\n   * - caller of {@link PointerEventsHandler.cancel}\n   *\n   * Downstream:\n   * - {@link sendPointerEvent}\n   */\n  const cancel = (): void => {\n    for (const pointerEvent of claimedPointers.values()) {\n      sendPointer(pointerEvent, \"cancel\");\n    }\n    claimedPointers.clear();\n  };\n\n  return { capture, bubble, cancel };\n}\n\nexport function phaseFromPointerEvent(event: PointerEvent): PointerPhase {\n  switch (event.type) {\n    case \"pointerdown\":\n      return \"down\";\n    case \"pointermove\":\n      return \"move\";\n    case \"pointerup\":\n      return \"up\";\n    case \"pointercancel\":\n      return \"cancel\";\n    default:\n      throw new TypeError(`Kirie cannot forward pointer event type: ${event.type}`);\n  }\n}\n"],"mappings":";;AA8BA,SAAgB,iBACd,OACA,QAAsB,sBAAsB,KAAK,GAC3C;CACN,MAAM,OAAO,MAAM,QAAQ;CAE3B,MAAM,cAAc,MAAM;CAC1B,IAAI,gBAAgB,WAAW,gBAAgB,SAAS,gBAAgB,SACtE,MAAM,IAAI,UAAU,sCAAsC,aAAa;CAGzE,SAAS,EACP,oBAAoB;EAClB,MAAM;EACN;EACA,YAAY,MAAM;EAClB,cAAc;EACd,cAAc,MAAM,UAAU,KAAK;EACnC,cAAc,MAAM,UAAU,KAAK;EACnC,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,UAAU,MAAM;CAClB,EACF,CAAgC;AAClC;AAEA,SAAgB,2BACd,cAAkC,kBACZ;CAEtB,MAAM,kCAAkB,IAAI,IAA0B;;;;;;;;;;;;;;;;CAiBtD,MAAM,WAAW,UAA8B;EAC7C,IACE,CAAC,gBAAgB,IAAI,MAAM,SAAS,KACnC,MAAM,SAAS,iBAAiB,MAAM,SAAS,eAAe,MAAM,SAAS,iBAE9E;EAGF,YAAY,KAAK;EACjB,IAAI,MAAM,SAAS,eAAe,MAAM,SAAS,iBAAiB;GAChE,gBAAgB,OAAO,MAAM,SAAS;GACtC;EACF;EAEA,gBAAgB,IAAI,MAAM,WAAW,KAAK;CAC5C;;;;;;;;;;;;;;;;CAiBA,MAAM,UAAU,UAA8B;EAC5C,IAAI,MAAM,SAAS,eAAe;GAChC,YAAY,KAAK;GACjB,gBAAgB,IAAI,MAAM,WAAW,KAAK;GAC1C;EACF;EAEA,IACE,MAAM,SAAS,iBACf,gBAAgB,IAAI,MAAM,SAAS,KACnC,MAAM,gBAAgB,WACtB,MAAM,YAAY,GAElB;EAGF,YAAY,KAAK;CACnB;;;;;;;;;;;;;;;CAgBA,MAAM,eAAqB;EACzB,KAAK,MAAM,gBAAgB,gBAAgB,OAAO,GAChD,YAAY,cAAc,QAAQ;EAEpC,gBAAgB,MAAM;CACxB;CAEA,OAAO;EAAE;EAAS;EAAQ;CAAO;AACnC;AAEA,SAAgB,sBAAsB,OAAmC;CACvE,QAAQ,MAAM,MAAd;EACE,KAAK,eACH,OAAO;EACT,KAAK,eACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,iBACH,OAAO;EACT,SACE,MAAM,IAAI,UAAU,4CAA4C,MAAM,MAAM;CAChF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gd-kirie/ipc",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -13,14 +13,26 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./pointer-input": {
+      "types": "./dist/pointer-input/index.d.ts",
+      "import": "./dist/pointer-input/index.js"
+    },
+    "./pointer-input/auto": {
+      "types": "./dist/pointer-input/auto.d.ts",
+      "import": "./dist/pointer-input/auto.js"
     }
   },
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "cborg": "^4.5.8"
+  },
   "devDependencies": {
-    "tsdown": "^0.21.10",
-    "typescript": "^5.9.3"
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.15"
   },
   "publishConfig": {
     "access": "public",
@@ -28,6 +40,7 @@
   },
   "scripts": {
     "build": "tsdown",
+    "test:run": "vitest run",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }