@scenography/plugin-cardboard 0.2.0

package/dist/index.cjs

@@ -0,0 +1,91 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let three = require("three");
+//#region src/DeviceOrientationControls.ts
+const DEG2RAD = Math.PI / 180;
+const ZEE = new three.Vector3(0, 0, 1);
+const SCREEN_TO_VIEW = new three.Quaternion(-Math.SQRT1_2, 0, 0, Math.SQRT1_2);
+const tmpEuler = new three.Euler();
+const tmpScreenAdjust = new three.Quaternion();
+/**
+* Orient the camera from the device gyroscope (DeviceOrientation API) for
+* cardboard/VR head-look. It only writes the camera while it has live sensor
+* data, so on a desktop (no gyro) it's a no-op and the other controls keep the
+* camera. iOS needs a permission prompt that must come from a user gesture —
+* `enable()` is meant to be called from the cardboard button's click handler.
+*/
+var DeviceOrientationControls = class {
+	camera;
+	enabled = false;
+	hasData = false;
+	alpha = 0;
+	beta = 0;
+	gamma = 0;
+	screenAngle = 0;
+	constructor(camera) {
+		this.camera = camera;
+		this.readScreenAngle();
+	}
+	/** Request permission (iOS) and start listening. Safe to call repeatedly. */
+	enable() {
+		if (this.enabled) return;
+		this.enabled = true;
+		const DOE = window.DeviceOrientationEvent;
+		if (DOE && typeof DOE.requestPermission === "function") DOE.requestPermission().then((state) => state === "granted" ? this.attach() : this.enabled = false).catch(() => this.enabled = false);
+		else this.attach();
+	}
+	disable() {
+		if (!this.enabled) return;
+		this.enabled = false;
+		this.hasData = false;
+		window.removeEventListener("deviceorientation", this.onOrientation);
+		window.removeEventListener("orientationchange", this.onScreenChange);
+	}
+	/** Apply the latest reading to the camera. No-op until sensor data arrives. */
+	update() {
+		if (!this.enabled || !this.hasData) return;
+		tmpEuler.set(this.beta, this.alpha, -this.gamma, "YXZ");
+		this.camera.quaternion.setFromEuler(tmpEuler);
+		this.camera.quaternion.multiply(SCREEN_TO_VIEW);
+		this.camera.quaternion.multiply(tmpScreenAdjust.setFromAxisAngle(ZEE, -this.screenAngle));
+	}
+	attach() {
+		window.addEventListener("deviceorientation", this.onOrientation);
+		window.addEventListener("orientationchange", this.onScreenChange);
+	}
+	readScreenAngle() {
+		this.screenAngle = (screen.orientation?.angle ?? 0) * DEG2RAD;
+	}
+	onScreenChange = () => this.readScreenAngle();
+	onOrientation = (event) => {
+		if (event.alpha == null) return;
+		this.alpha = event.alpha * DEG2RAD;
+		this.beta = (event.beta ?? 0) * DEG2RAD;
+		this.gamma = (event.gamma ?? 0) * DEG2RAD;
+		this.hasData = true;
+	};
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Cardboard head-look — a *system* plugin. It orients the kernel camera from the
+* device gyroscope for phone-in-a-headset viewing, taking the final say on
+* orientation each frame (so it must be registered *after* the roaming/framing
+* systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`
+* (which requests the iOS motion-sensor permission, hence a user gesture).
+*/
+const cardboard = () => ({
+	name: "cardboard",
+	setup: (ctx) => {
+		const gyro = new DeviceOrientationControls(ctx.camera);
+		return {
+			update: () => gyro.update(),
+			dispose: () => gyro.disable(),
+			api: { setEnabled: (enabled) => enabled ? gyro.enable() : gyro.disable() }
+		};
+	}
+});
+//#endregion
+exports.DeviceOrientationControls = DeviceOrientationControls;
+exports.cardboard = cardboard;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["Vector3","Quaternion","Euler"],"sources":["../src/DeviceOrientationControls.ts","../src/plugin.ts"],"sourcesContent":["import { Euler, Quaternion, Vector3, type PerspectiveCamera } from \"three\";\n\nconst DEG2RAD = Math.PI / 180;\nconst ZEE = new Vector3(0, 0, 1);\n// -90° about X: the phone's screen faces the user, but the camera looks out its\n// back, so the sensor frame is rotated into the viewing direction.\nconst SCREEN_TO_VIEW = new Quaternion(-Math.SQRT1_2, 0, 0, Math.SQRT1_2);\n\nconst tmpEuler = new Euler();\nconst tmpScreenAdjust = new Quaternion();\n\n/** iOS 13+ gates the motion sensors behind an async permission prompt. */\ninterface DeviceOrientationEventStatic {\n  requestPermission?: () => Promise<\"granted\" | \"denied\">;\n}\n\n/**\n * Orient the camera from the device gyroscope (DeviceOrientation API) for\n * cardboard/VR head-look. It only writes the camera while it has live sensor\n * data, so on a desktop (no gyro) it's a no-op and the other controls keep the\n * camera. iOS needs a permission prompt that must come from a user gesture —\n * `enable()` is meant to be called from the cardboard button's click handler.\n */\nexport class DeviceOrientationControls {\n  private enabled = false;\n  private hasData = false;\n  private alpha = 0;\n  private beta = 0;\n  private gamma = 0;\n  private screenAngle = 0;\n\n  constructor(private readonly camera: PerspectiveCamera) {\n    this.readScreenAngle();\n  }\n\n  /** Request permission (iOS) and start listening. Safe to call repeatedly. */\n  enable(): void {\n    if (this.enabled) return;\n    this.enabled = true;\n    const DOE = (window as unknown as { DeviceOrientationEvent?: DeviceOrientationEventStatic })\n      .DeviceOrientationEvent;\n    if (DOE && typeof DOE.requestPermission === \"function\") {\n      DOE.requestPermission()\n        .then((state) => (state === \"granted\" ? this.attach() : (this.enabled = false)))\n        .catch(() => (this.enabled = false));\n    } else {\n      this.attach();\n    }\n  }\n\n  disable(): void {\n    if (!this.enabled) return;\n    this.enabled = false;\n    this.hasData = false;\n    window.removeEventListener(\"deviceorientation\", this.onOrientation);\n    window.removeEventListener(\"orientationchange\", this.onScreenChange);\n  }\n\n  /** Apply the latest reading to the camera. No-op until sensor data arrives. */\n  update(): void {\n    if (!this.enabled || !this.hasData) return;\n    tmpEuler.set(this.beta, this.alpha, -this.gamma, \"YXZ\");\n    this.camera.quaternion.setFromEuler(tmpEuler);\n    this.camera.quaternion.multiply(SCREEN_TO_VIEW);\n    this.camera.quaternion.multiply(tmpScreenAdjust.setFromAxisAngle(ZEE, -this.screenAngle));\n  }\n\n  private attach(): void {\n    window.addEventListener(\"deviceorientation\", this.onOrientation);\n    window.addEventListener(\"orientationchange\", this.onScreenChange);\n  }\n\n  private readScreenAngle(): void {\n    this.screenAngle = (screen.orientation?.angle ?? 0) * DEG2RAD;\n  }\n\n  private readonly onScreenChange = (): void => this.readScreenAngle();\n\n  private readonly onOrientation = (event: DeviceOrientationEvent): void => {\n    if (event.alpha == null) return;\n    this.alpha = event.alpha * DEG2RAD;\n    this.beta = (event.beta ?? 0) * DEG2RAD;\n    this.gamma = (event.gamma ?? 0) * DEG2RAD;\n    this.hasData = true;\n  };\n}\n","import type { SystemPlugin } from \"@scenography/engine\";\n\nimport { DeviceOrientationControls } from \"./DeviceOrientationControls\";\n\n/** What the kernel's cardboard render toggle drives on this system. */\nexport interface CardboardApi {\n  /** Turn gyroscope head-look on/off (must run in a user gesture on iOS). */\n  setEnabled(enabled: boolean): void;\n}\n\n/**\n * Cardboard head-look — a *system* plugin. It orients the kernel camera from the\n * device gyroscope for phone-in-a-headset viewing, taking the final say on\n * orientation each frame (so it must be registered *after* the roaming/framing\n * systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`\n * (which requests the iOS motion-sensor permission, hence a user gesture).\n */\nexport const cardboard = (): SystemPlugin<CardboardApi> => ({\n  name: \"cardboard\",\n  setup: (ctx) => {\n    const gyro = new DeviceOrientationControls(ctx.camera);\n    return {\n      update: () => gyro.update(),\n      dispose: () => gyro.disable(),\n      api: { setEnabled: (enabled) => (enabled ? gyro.enable() : gyro.disable()) },\n    };\n  },\n});\n"],"mappings":";;;AAEA,MAAM,UAAU,KAAK,KAAK;AAC1B,MAAM,MAAM,IAAIA,MAAAA,QAAQ,GAAG,GAAG,CAAC;AAG/B,MAAM,iBAAiB,IAAIC,MAAAA,WAAW,CAAC,KAAK,SAAS,GAAG,GAAG,KAAK,OAAO;AAEvE,MAAM,WAAW,IAAIC,MAAAA,MAAM;AAC3B,MAAM,kBAAkB,IAAID,MAAAA,WAAW;;;;;;;;AAcvC,IAAa,4BAAb,MAAuC;CAQR;CAP7B,UAAkB;CAClB,UAAkB;CAClB,QAAgB;CAChB,OAAe;CACf,QAAgB;CAChB,cAAsB;CAEtB,YAAY,QAA4C;EAA3B,KAAA,SAAA;EAC3B,KAAK,gBAAgB;CACvB;;CAGA,SAAe;EACb,IAAI,KAAK,SAAS;EAClB,KAAK,UAAU;EACf,MAAM,MAAO,OACV;EACH,IAAI,OAAO,OAAO,IAAI,sBAAsB,YAC1C,IAAI,kBAAkB,CAAC,CACpB,MAAM,UAAW,UAAU,YAAY,KAAK,OAAO,IAAK,KAAK,UAAU,KAAO,CAAC,CAC/E,YAAa,KAAK,UAAU,KAAM;OAErC,KAAK,OAAO;CAEhB;CAEA,UAAgB;EACd,IAAI,CAAC,KAAK,SAAS;EACnB,KAAK,UAAU;EACf,KAAK,UAAU;EACf,OAAO,oBAAoB,qBAAqB,KAAK,aAAa;EAClE,OAAO,oBAAoB,qBAAqB,KAAK,cAAc;CACrE;;CAGA,SAAe;EACb,IAAI,CAAC,KAAK,WAAW,CAAC,KAAK,SAAS;EACpC,SAAS,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,KAAK,OAAO,KAAK;EACtD,KAAK,OAAO,WAAW,aAAa,QAAQ;EAC5C,KAAK,OAAO,WAAW,SAAS,cAAc;EAC9C,KAAK,OAAO,WAAW,SAAS,gBAAgB,iBAAiB,KAAK,CAAC,KAAK,WAAW,CAAC;CAC1F;CAEA,SAAuB;EACrB,OAAO,iBAAiB,qBAAqB,KAAK,aAAa;EAC/D,OAAO,iBAAiB,qBAAqB,KAAK,cAAc;CAClE;CAEA,kBAAgC;EAC9B,KAAK,eAAe,OAAO,aAAa,SAAS,KAAK;CACxD;CAEA,uBAA8C,KAAK,gBAAgB;CAEnE,iBAAkC,UAAwC;EACxE,IAAI,MAAM,SAAS,MAAM;EACzB,KAAK,QAAQ,MAAM,QAAQ;EAC3B,KAAK,QAAQ,MAAM,QAAQ,KAAK;EAChC,KAAK,SAAS,MAAM,SAAS,KAAK;EAClC,KAAK,UAAU;CACjB;AACF;;;;;;;;;;ACpEA,MAAa,mBAA+C;CAC1D,MAAM;CACN,QAAQ,QAAQ;EACd,MAAM,OAAO,IAAI,0BAA0B,IAAI,MAAM;EACrD,OAAO;GACL,cAAc,KAAK,OAAO;GAC1B,eAAe,KAAK,QAAQ;GAC5B,KAAK,EAAE,aAAa,YAAa,UAAU,KAAK,OAAO,IAAI,KAAK,QAAQ,EAAG;EAC7E;CACF;AACF"}

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+import { SystemPlugin } from "@scenography/engine";
+import { PerspectiveCamera } from "three";
+
+//#region src/plugin.d.ts
+/** What the kernel's cardboard render toggle drives on this system. */
+interface CardboardApi {
+  /** Turn gyroscope head-look on/off (must run in a user gesture on iOS). */
+  setEnabled(enabled: boolean): void;
+}
+/**
+ * Cardboard head-look — a *system* plugin. It orients the kernel camera from the
+ * device gyroscope for phone-in-a-headset viewing, taking the final say on
+ * orientation each frame (so it must be registered *after* the roaming/framing
+ * systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`
+ * (which requests the iOS motion-sensor permission, hence a user gesture).
+ */
+declare const cardboard: () => SystemPlugin<CardboardApi>;
+//#endregion
+//#region src/DeviceOrientationControls.d.ts
+/**
+ * Orient the camera from the device gyroscope (DeviceOrientation API) for
+ * cardboard/VR head-look. It only writes the camera while it has live sensor
+ * data, so on a desktop (no gyro) it's a no-op and the other controls keep the
+ * camera. iOS needs a permission prompt that must come from a user gesture —
+ * `enable()` is meant to be called from the cardboard button's click handler.
+ */
+declare class DeviceOrientationControls {
+  private readonly camera;
+  private enabled;
+  private hasData;
+  private alpha;
+  private beta;
+  private gamma;
+  private screenAngle;
+  constructor(camera: PerspectiveCamera);
+  /** Request permission (iOS) and start listening. Safe to call repeatedly. */
+  enable(): void;
+  disable(): void;
+  /** Apply the latest reading to the camera. No-op until sensor data arrives. */
+  update(): void;
+  private attach;
+  private readScreenAngle;
+  private readonly onScreenChange;
+  private readonly onOrientation;
+}
+//#endregion
+export { type CardboardApi, DeviceOrientationControls, cardboard };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+import { PerspectiveCamera } from "three";
+import { SystemPlugin } from "@scenography/engine";
+
+//#region src/plugin.d.ts
+/** What the kernel's cardboard render toggle drives on this system. */
+interface CardboardApi {
+  /** Turn gyroscope head-look on/off (must run in a user gesture on iOS). */
+  setEnabled(enabled: boolean): void;
+}
+/**
+ * Cardboard head-look — a *system* plugin. It orients the kernel camera from the
+ * device gyroscope for phone-in-a-headset viewing, taking the final say on
+ * orientation each frame (so it must be registered *after* the roaming/framing
+ * systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`
+ * (which requests the iOS motion-sensor permission, hence a user gesture).
+ */
+declare const cardboard: () => SystemPlugin<CardboardApi>;
+//#endregion
+//#region src/DeviceOrientationControls.d.ts
+/**
+ * Orient the camera from the device gyroscope (DeviceOrientation API) for
+ * cardboard/VR head-look. It only writes the camera while it has live sensor
+ * data, so on a desktop (no gyro) it's a no-op and the other controls keep the
+ * camera. iOS needs a permission prompt that must come from a user gesture —
+ * `enable()` is meant to be called from the cardboard button's click handler.
+ */
+declare class DeviceOrientationControls {
+  private readonly camera;
+  private enabled;
+  private hasData;
+  private alpha;
+  private beta;
+  private gamma;
+  private screenAngle;
+  constructor(camera: PerspectiveCamera);
+  /** Request permission (iOS) and start listening. Safe to call repeatedly. */
+  enable(): void;
+  disable(): void;
+  /** Apply the latest reading to the camera. No-op until sensor data arrives. */
+  update(): void;
+  private attach;
+  private readScreenAngle;
+  private readonly onScreenChange;
+  private readonly onOrientation;
+}
+//#endregion
+export { type CardboardApi, DeviceOrientationControls, cardboard };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,89 @@
+import { Euler, Quaternion, Vector3 } from "three";
+//#region src/DeviceOrientationControls.ts
+const DEG2RAD = Math.PI / 180;
+const ZEE = new Vector3(0, 0, 1);
+const SCREEN_TO_VIEW = new Quaternion(-Math.SQRT1_2, 0, 0, Math.SQRT1_2);
+const tmpEuler = new Euler();
+const tmpScreenAdjust = new Quaternion();
+/**
+* Orient the camera from the device gyroscope (DeviceOrientation API) for
+* cardboard/VR head-look. It only writes the camera while it has live sensor
+* data, so on a desktop (no gyro) it's a no-op and the other controls keep the
+* camera. iOS needs a permission prompt that must come from a user gesture —
+* `enable()` is meant to be called from the cardboard button's click handler.
+*/
+var DeviceOrientationControls = class {
+	camera;
+	enabled = false;
+	hasData = false;
+	alpha = 0;
+	beta = 0;
+	gamma = 0;
+	screenAngle = 0;
+	constructor(camera) {
+		this.camera = camera;
+		this.readScreenAngle();
+	}
+	/** Request permission (iOS) and start listening. Safe to call repeatedly. */
+	enable() {
+		if (this.enabled) return;
+		this.enabled = true;
+		const DOE = window.DeviceOrientationEvent;
+		if (DOE && typeof DOE.requestPermission === "function") DOE.requestPermission().then((state) => state === "granted" ? this.attach() : this.enabled = false).catch(() => this.enabled = false);
+		else this.attach();
+	}
+	disable() {
+		if (!this.enabled) return;
+		this.enabled = false;
+		this.hasData = false;
+		window.removeEventListener("deviceorientation", this.onOrientation);
+		window.removeEventListener("orientationchange", this.onScreenChange);
+	}
+	/** Apply the latest reading to the camera. No-op until sensor data arrives. */
+	update() {
+		if (!this.enabled || !this.hasData) return;
+		tmpEuler.set(this.beta, this.alpha, -this.gamma, "YXZ");
+		this.camera.quaternion.setFromEuler(tmpEuler);
+		this.camera.quaternion.multiply(SCREEN_TO_VIEW);
+		this.camera.quaternion.multiply(tmpScreenAdjust.setFromAxisAngle(ZEE, -this.screenAngle));
+	}
+	attach() {
+		window.addEventListener("deviceorientation", this.onOrientation);
+		window.addEventListener("orientationchange", this.onScreenChange);
+	}
+	readScreenAngle() {
+		this.screenAngle = (screen.orientation?.angle ?? 0) * DEG2RAD;
+	}
+	onScreenChange = () => this.readScreenAngle();
+	onOrientation = (event) => {
+		if (event.alpha == null) return;
+		this.alpha = event.alpha * DEG2RAD;
+		this.beta = (event.beta ?? 0) * DEG2RAD;
+		this.gamma = (event.gamma ?? 0) * DEG2RAD;
+		this.hasData = true;
+	};
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Cardboard head-look — a *system* plugin. It orients the kernel camera from the
+* device gyroscope for phone-in-a-headset viewing, taking the final say on
+* orientation each frame (so it must be registered *after* the roaming/framing
+* systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`
+* (which requests the iOS motion-sensor permission, hence a user gesture).
+*/
+const cardboard = () => ({
+	name: "cardboard",
+	setup: (ctx) => {
+		const gyro = new DeviceOrientationControls(ctx.camera);
+		return {
+			update: () => gyro.update(),
+			dispose: () => gyro.disable(),
+			api: { setEnabled: (enabled) => enabled ? gyro.enable() : gyro.disable() }
+		};
+	}
+});
+//#endregion
+export { DeviceOrientationControls, cardboard };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/DeviceOrientationControls.ts","../src/plugin.ts"],"sourcesContent":["import { Euler, Quaternion, Vector3, type PerspectiveCamera } from \"three\";\n\nconst DEG2RAD = Math.PI / 180;\nconst ZEE = new Vector3(0, 0, 1);\n// -90° about X: the phone's screen faces the user, but the camera looks out its\n// back, so the sensor frame is rotated into the viewing direction.\nconst SCREEN_TO_VIEW = new Quaternion(-Math.SQRT1_2, 0, 0, Math.SQRT1_2);\n\nconst tmpEuler = new Euler();\nconst tmpScreenAdjust = new Quaternion();\n\n/** iOS 13+ gates the motion sensors behind an async permission prompt. */\ninterface DeviceOrientationEventStatic {\n  requestPermission?: () => Promise<\"granted\" | \"denied\">;\n}\n\n/**\n * Orient the camera from the device gyroscope (DeviceOrientation API) for\n * cardboard/VR head-look. It only writes the camera while it has live sensor\n * data, so on a desktop (no gyro) it's a no-op and the other controls keep the\n * camera. iOS needs a permission prompt that must come from a user gesture —\n * `enable()` is meant to be called from the cardboard button's click handler.\n */\nexport class DeviceOrientationControls {\n  private enabled = false;\n  private hasData = false;\n  private alpha = 0;\n  private beta = 0;\n  private gamma = 0;\n  private screenAngle = 0;\n\n  constructor(private readonly camera: PerspectiveCamera) {\n    this.readScreenAngle();\n  }\n\n  /** Request permission (iOS) and start listening. Safe to call repeatedly. */\n  enable(): void {\n    if (this.enabled) return;\n    this.enabled = true;\n    const DOE = (window as unknown as { DeviceOrientationEvent?: DeviceOrientationEventStatic })\n      .DeviceOrientationEvent;\n    if (DOE && typeof DOE.requestPermission === \"function\") {\n      DOE.requestPermission()\n        .then((state) => (state === \"granted\" ? this.attach() : (this.enabled = false)))\n        .catch(() => (this.enabled = false));\n    } else {\n      this.attach();\n    }\n  }\n\n  disable(): void {\n    if (!this.enabled) return;\n    this.enabled = false;\n    this.hasData = false;\n    window.removeEventListener(\"deviceorientation\", this.onOrientation);\n    window.removeEventListener(\"orientationchange\", this.onScreenChange);\n  }\n\n  /** Apply the latest reading to the camera. No-op until sensor data arrives. */\n  update(): void {\n    if (!this.enabled || !this.hasData) return;\n    tmpEuler.set(this.beta, this.alpha, -this.gamma, \"YXZ\");\n    this.camera.quaternion.setFromEuler(tmpEuler);\n    this.camera.quaternion.multiply(SCREEN_TO_VIEW);\n    this.camera.quaternion.multiply(tmpScreenAdjust.setFromAxisAngle(ZEE, -this.screenAngle));\n  }\n\n  private attach(): void {\n    window.addEventListener(\"deviceorientation\", this.onOrientation);\n    window.addEventListener(\"orientationchange\", this.onScreenChange);\n  }\n\n  private readScreenAngle(): void {\n    this.screenAngle = (screen.orientation?.angle ?? 0) * DEG2RAD;\n  }\n\n  private readonly onScreenChange = (): void => this.readScreenAngle();\n\n  private readonly onOrientation = (event: DeviceOrientationEvent): void => {\n    if (event.alpha == null) return;\n    this.alpha = event.alpha * DEG2RAD;\n    this.beta = (event.beta ?? 0) * DEG2RAD;\n    this.gamma = (event.gamma ?? 0) * DEG2RAD;\n    this.hasData = true;\n  };\n}\n","import type { SystemPlugin } from \"@scenography/engine\";\n\nimport { DeviceOrientationControls } from \"./DeviceOrientationControls\";\n\n/** What the kernel's cardboard render toggle drives on this system. */\nexport interface CardboardApi {\n  /** Turn gyroscope head-look on/off (must run in a user gesture on iOS). */\n  setEnabled(enabled: boolean): void;\n}\n\n/**\n * Cardboard head-look — a *system* plugin. It orients the kernel camera from the\n * device gyroscope for phone-in-a-headset viewing, taking the final say on\n * orientation each frame (so it must be registered *after* the roaming/framing\n * systems). The kernel's stereo-render `cardboard` toggle drives its `setEnabled`\n * (which requests the iOS motion-sensor permission, hence a user gesture).\n */\nexport const cardboard = (): SystemPlugin<CardboardApi> => ({\n  name: \"cardboard\",\n  setup: (ctx) => {\n    const gyro = new DeviceOrientationControls(ctx.camera);\n    return {\n      update: () => gyro.update(),\n      dispose: () => gyro.disable(),\n      api: { setEnabled: (enabled) => (enabled ? gyro.enable() : gyro.disable()) },\n    };\n  },\n});\n"],"mappings":";;AAEA,MAAM,UAAU,KAAK,KAAK;AAC1B,MAAM,MAAM,IAAI,QAAQ,GAAG,GAAG,CAAC;AAG/B,MAAM,iBAAiB,IAAI,WAAW,CAAC,KAAK,SAAS,GAAG,GAAG,KAAK,OAAO;AAEvE,MAAM,WAAW,IAAI,MAAM;AAC3B,MAAM,kBAAkB,IAAI,WAAW;;;;;;;;AAcvC,IAAa,4BAAb,MAAuC;CAQR;CAP7B,UAAkB;CAClB,UAAkB;CAClB,QAAgB;CAChB,OAAe;CACf,QAAgB;CAChB,cAAsB;CAEtB,YAAY,QAA4C;EAA3B,KAAA,SAAA;EAC3B,KAAK,gBAAgB;CACvB;;CAGA,SAAe;EACb,IAAI,KAAK,SAAS;EAClB,KAAK,UAAU;EACf,MAAM,MAAO,OACV;EACH,IAAI,OAAO,OAAO,IAAI,sBAAsB,YAC1C,IAAI,kBAAkB,CAAC,CACpB,MAAM,UAAW,UAAU,YAAY,KAAK,OAAO,IAAK,KAAK,UAAU,KAAO,CAAC,CAC/E,YAAa,KAAK,UAAU,KAAM;OAErC,KAAK,OAAO;CAEhB;CAEA,UAAgB;EACd,IAAI,CAAC,KAAK,SAAS;EACnB,KAAK,UAAU;EACf,KAAK,UAAU;EACf,OAAO,oBAAoB,qBAAqB,KAAK,aAAa;EAClE,OAAO,oBAAoB,qBAAqB,KAAK,cAAc;CACrE;;CAGA,SAAe;EACb,IAAI,CAAC,KAAK,WAAW,CAAC,KAAK,SAAS;EACpC,SAAS,IAAI,KAAK,MAAM,KAAK,OAAO,CAAC,KAAK,OAAO,KAAK;EACtD,KAAK,OAAO,WAAW,aAAa,QAAQ;EAC5C,KAAK,OAAO,WAAW,SAAS,cAAc;EAC9C,KAAK,OAAO,WAAW,SAAS,gBAAgB,iBAAiB,KAAK,CAAC,KAAK,WAAW,CAAC;CAC1F;CAEA,SAAuB;EACrB,OAAO,iBAAiB,qBAAqB,KAAK,aAAa;EAC/D,OAAO,iBAAiB,qBAAqB,KAAK,cAAc;CAClE;CAEA,kBAAgC;EAC9B,KAAK,eAAe,OAAO,aAAa,SAAS,KAAK;CACxD;CAEA,uBAA8C,KAAK,gBAAgB;CAEnE,iBAAkC,UAAwC;EACxE,IAAI,MAAM,SAAS,MAAM;EACzB,KAAK,QAAQ,MAAM,QAAQ;EAC3B,KAAK,QAAQ,MAAM,QAAQ,KAAK;EAChC,KAAK,SAAS,MAAM,SAAS,KAAK;EAClC,KAAK,UAAU;CACjB;AACF;;;;;;;;;;ACpEA,MAAa,mBAA+C;CAC1D,MAAM;CACN,QAAQ,QAAQ;EACd,MAAM,OAAO,IAAI,0BAA0B,IAAI,MAAM;EACrD,OAAO;GACL,cAAc,KAAK,OAAO;GAC1B,eAAe,KAAK,QAAQ;GAC5B,KAAK,EAAE,aAAa,YAAa,UAAU,KAAK,OAAO,IAAI,KAAK,QAAQ,EAAG;EAC7E;CACF;AACF"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@scenography/plugin-cardboard",
+  "version": "0.2.0",
+  "description": "Cardboard plugin for scenography: gyroscope head-look (DeviceOrientation) for phone-in-a-headset viewing. A system plugin driven by the kernel's stereo-render toggle.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@scenography/scene": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.160.0",
+    "three": "^0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}