@scenography/plugin-video 0.2.0

package/dist/data-BJdJij0e.cjs

@@ -0,0 +1,34 @@
+let _scenography_scene = require("@scenography/scene");
+//#region src/data/validate.ts
+const validateVideo = (video) => (0, _scenography_scene.validate)([
+	(0, _scenography_scene.existsProp)("id", "Video is missing an id."),
+	(0, _scenography_scene.existsProp)("src", "Video is missing a src."),
+	(0, _scenography_scene.existsProp)("position"),
+	(0, _scenography_scene.propIs)("position", _scenography_scene.isVec3, "position must be [x, y, z]."),
+	(0, _scenography_scene.existsProp)("size"),
+	(0, _scenography_scene.propIs)("size", _scenography_scene.isVec2, "size must be [width, height]."),
+	(0, _scenography_scene.propIs)("rotation", _scenography_scene.isFiniteNumber, "rotation must be a finite number.")
+])(video);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the video plugin: owns the `videos` scene key (a collection). */
+const videoData = {
+	kind: "videos",
+	cardinality: "many",
+	validate: (video) => validateVideo(video)
+};
+//#endregion
+Object.defineProperty(exports, "validateVideo", {
+	enumerable: true,
+	get: function() {
+		return validateVideo;
+	}
+});
+Object.defineProperty(exports, "videoData", {
+	enumerable: true,
+	get: function() {
+		return videoData;
+	}
+});
+
+//# sourceMappingURL=data-BJdJij0e.cjs.map

package/dist/data-BJdJij0e.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-BJdJij0e.cjs","names":["isVec3","isVec2","isFiniteNumber"],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  isFiniteNumber,\n  isVec2,\n  isVec3,\n  propIs,\n  validate,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { Video } from \"./video\";\n\nexport const validateVideo = (video: Video): ValidationResult =>\n  validate<Video>([\n    existsProp(\"id\", \"Video is missing an id.\"),\n    existsProp(\"src\", \"Video is missing a src.\"),\n    existsProp(\"position\"),\n    propIs(\"position\", isVec3, \"position must be [x, y, z].\"),\n    existsProp(\"size\"),\n    propIs(\"size\", isVec2, \"size must be [width, height].\"),\n    propIs(\"rotation\", isFiniteNumber, \"rotation must be a finite number.\"),\n  ])(video);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateVideo } from \"./validate\";\nimport type { Video } from \"./video\";\n\n/** The data half of the video plugin: owns the `videos` scene key (a collection). */\nexport const videoData: DataPlugin<Video> = {\n  kind: \"videos\",\n  cardinality: \"many\",\n  validate: (video) => validateVideo(video),\n};\n"],"mappings":";;AAYA,MAAa,iBAAiB,WAAA,GAAA,mBAAA,SAAA,CACZ;oCACH,MAAM,yBAAyB;oCAC/B,OAAO,yBAAyB;oCAChC,UAAU;gCACd,YAAYA,mBAAAA,QAAQ,6BAA6B;oCAC7C,MAAM;gCACV,QAAQC,mBAAAA,QAAQ,+BAA+B;gCAC/C,YAAYC,mBAAAA,gBAAgB,mCAAmC;AACxE,CAAC,CAAC,CAAC,KAAK;;;;ACfV,MAAa,YAA+B;CAC1C,MAAM;CACN,aAAa;CACb,WAAW,UAAU,cAAc,KAAK;AAC1C"}

package/dist/data-DqD4TXso.mjs

@@ -0,0 +1,23 @@
+import { existsProp, isFiniteNumber, isVec2, isVec3, propIs, validate } from "@scenography/scene";
+//#region src/data/validate.ts
+const validateVideo = (video) => validate([
+	existsProp("id", "Video is missing an id."),
+	existsProp("src", "Video is missing a src."),
+	existsProp("position"),
+	propIs("position", isVec3, "position must be [x, y, z]."),
+	existsProp("size"),
+	propIs("size", isVec2, "size must be [width, height]."),
+	propIs("rotation", isFiniteNumber, "rotation must be a finite number.")
+])(video);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the video plugin: owns the `videos` scene key (a collection). */
+const videoData = {
+	kind: "videos",
+	cardinality: "many",
+	validate: (video) => validateVideo(video)
+};
+//#endregion
+export { validateVideo as n, videoData as t };
+
+//# sourceMappingURL=data-DqD4TXso.mjs.map

package/dist/data-DqD4TXso.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-DqD4TXso.mjs","names":[],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  isFiniteNumber,\n  isVec2,\n  isVec3,\n  propIs,\n  validate,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { Video } from \"./video\";\n\nexport const validateVideo = (video: Video): ValidationResult =>\n  validate<Video>([\n    existsProp(\"id\", \"Video is missing an id.\"),\n    existsProp(\"src\", \"Video is missing a src.\"),\n    existsProp(\"position\"),\n    propIs(\"position\", isVec3, \"position must be [x, y, z].\"),\n    existsProp(\"size\"),\n    propIs(\"size\", isVec2, \"size must be [width, height].\"),\n    propIs(\"rotation\", isFiniteNumber, \"rotation must be a finite number.\"),\n  ])(video);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateVideo } from \"./validate\";\nimport type { Video } from \"./video\";\n\n/** The data half of the video plugin: owns the `videos` scene key (a collection). */\nexport const videoData: DataPlugin<Video> = {\n  kind: \"videos\",\n  cardinality: \"many\",\n  validate: (video) => validateVideo(video),\n};\n"],"mappings":";;AAYA,MAAa,iBAAiB,UAC5B,SAAgB;CACd,WAAW,MAAM,yBAAyB;CAC1C,WAAW,OAAO,yBAAyB;CAC3C,WAAW,UAAU;CACrB,OAAO,YAAY,QAAQ,6BAA6B;CACxD,WAAW,MAAM;CACjB,OAAO,QAAQ,QAAQ,+BAA+B;CACtD,OAAO,YAAY,gBAAgB,mCAAmC;AACxE,CAAC,CAAC,CAAC,KAAK;;;;ACfV,MAAa,YAA+B;CAC1C,MAAM;CACN,aAAa;CACb,WAAW,UAAU,cAAc,KAAK;AAC1C"}

package/dist/data.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-BJdJij0e.cjs");
+exports.validateVideo = require_data.validateVideo;
+exports.videoData = require_data.videoData;

package/dist/data.d.cts

@@ -0,0 +1,2 @@
+import { n as validateVideo, r as Video, t as videoData } from "./index-CtaN02zR.cjs";
+export { type Video, validateVideo, videoData };

package/dist/data.d.mts

@@ -0,0 +1,2 @@
+import { n as validateVideo, r as Video, t as videoData } from "./index-CtaN02zR.mjs";
+export { type Video, validateVideo, videoData };

package/dist/data.mjs

@@ -0,0 +1,2 @@
+import { n as validateVideo, t as videoData } from "./data-DqD4TXso.mjs";
+export { validateVideo, videoData };

package/dist/index-CtaN02zR.d.cts

@@ -0,0 +1,45 @@
+import { DataPlugin, ValidationResult, Vec2, Vec3 } from "@scenography/scene";
+
+//#region src/data/video.d.ts
+/**
+ * A flat video screen placed in the space, textured with an HTML video element
+ * (`.mp4`/`.webm`). Pure data: where the screen is and which file it plays.
+ * Playback (play/pause) and visibility are driven by `id` from the runtime
+ * through `ctx.video` — the definition stays serializable. (YouTube can't be used
+ * here: it has no streamable source for a WebGL texture.)
+ */
+interface Video {
+  id: string;
+  /** Video URL (`.mp4`/`.webm`). */
+  src: string;
+  /** World position `[x, y, z]` of the screen center. */
+  position: Vec3;
+  /** `[width, height]` of the screen in world units. */
+  size: Vec2;
+  /** Y-axis rotation in radians (the screen faces `+Z` before rotation). Defaults to `0`. */
+  rotation?: number;
+  /** Loop playback. Defaults to `true`. */
+  loop?: boolean;
+  /** Mute audio (required for autoplay without a user gesture). Defaults to `true`. */
+  muted?: boolean;
+  /** Start playing immediately. Defaults to `false` (behavior code plays it). */
+  autoplay?: boolean;
+  /** Start visible. Defaults to `true`. */
+  visible?: boolean;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Video screens placed in the space — provided by `@scenography/plugin-video`. */
+    videos?: Video[];
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateVideo: (video: Video) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the video plugin: owns the `videos` scene key (a collection). */
+declare const videoData: DataPlugin<Video>;
+//#endregion
+export { validateVideo as n, Video as r, videoData as t };
+//# sourceMappingURL=index-CtaN02zR.d.cts.map

package/dist/index-CtaN02zR.d.mts

@@ -0,0 +1,45 @@
+import { DataPlugin, ValidationResult, Vec2, Vec3 } from "@scenography/scene";
+
+//#region src/data/video.d.ts
+/**
+ * A flat video screen placed in the space, textured with an HTML video element
+ * (`.mp4`/`.webm`). Pure data: where the screen is and which file it plays.
+ * Playback (play/pause) and visibility are driven by `id` from the runtime
+ * through `ctx.video` — the definition stays serializable. (YouTube can't be used
+ * here: it has no streamable source for a WebGL texture.)
+ */
+interface Video {
+  id: string;
+  /** Video URL (`.mp4`/`.webm`). */
+  src: string;
+  /** World position `[x, y, z]` of the screen center. */
+  position: Vec3;
+  /** `[width, height]` of the screen in world units. */
+  size: Vec2;
+  /** Y-axis rotation in radians (the screen faces `+Z` before rotation). Defaults to `0`. */
+  rotation?: number;
+  /** Loop playback. Defaults to `true`. */
+  loop?: boolean;
+  /** Mute audio (required for autoplay without a user gesture). Defaults to `true`. */
+  muted?: boolean;
+  /** Start playing immediately. Defaults to `false` (behavior code plays it). */
+  autoplay?: boolean;
+  /** Start visible. Defaults to `true`. */
+  visible?: boolean;
+}
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Video screens placed in the space — provided by `@scenography/plugin-video`. */
+    videos?: Video[];
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateVideo: (video: Video) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the video plugin: owns the `videos` scene key (a collection). */
+declare const videoData: DataPlugin<Video>;
+//#endregion
+export { validateVideo as n, Video as r, videoData as t };
+//# sourceMappingURL=index-CtaN02zR.d.mts.map

package/dist/index.cjs

@@ -0,0 +1,79 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-BJdJij0e.cjs");
+let three = require("three");
+//#region src/buildVideo.ts
+/**
+* Build the three.js object for a `Video`: a plane textured with an HTML video
+* element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene
+* lights off. The video element is kept on `userData.video` for the controller
+* to play/pause; `VideoTexture` refreshes itself each frame while playing.
+*/
+function buildVideo(video) {
+	const el = document.createElement("video");
+	el.src = video.src;
+	el.loop = video.loop ?? true;
+	el.muted = video.muted ?? true;
+	el.playsInline = true;
+	el.preload = "auto";
+	el.load();
+	const texture = new three.VideoTexture(el);
+	texture.colorSpace = three.SRGBColorSpace;
+	const [width, height] = video.size;
+	const mesh = new three.Mesh(new three.PlaneGeometry(width, height), new three.MeshBasicMaterial({ map: texture }));
+	mesh.position.set(video.position[0], video.position[1], video.position[2]);
+	mesh.rotation.y = video.rotation ?? 0;
+	mesh.visible = video.visible ?? true;
+	mesh.name = `video:${video.id}`;
+	mesh.userData.scenographyId = video.id;
+	mesh.userData.video = el;
+	if (video.autoplay ?? false) el.play().catch(() => {});
+	return mesh;
+}
+//#endregion
+//#region src/VideoController.ts
+/**
+* High-level video control surfaced as `ctx.video`. Works over the live video
+* meshes (queried fresh each call so it survives hot-swaps), driving the
+* underlying HTML video elements by `id`.
+*/
+var VideoController = class {
+	getVideos;
+	constructor(getVideos) {
+		this.getVideos = getVideos;
+	}
+	element(id) {
+		return this.getVideos().get(id)?.userData.video;
+	}
+	/** Start (or resume) playback of the video with this `id`. */
+	play(id) {
+		this.element(id)?.play().catch(() => {});
+	}
+	/** Pause the video with this `id`. */
+	pause(id) {
+		this.element(id)?.pause();
+	}
+	/** Show or hide the screen with this `id`. */
+	setVisible(id, visible) {
+		const mesh = this.getVideos().get(id);
+		if (mesh) mesh.visible = visible;
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* The video plugin: builds each `Video` screen (an HTML video on a plane) and
+* exposes `ctx.video` — a controller that plays/pauses/shows the live screens.
+*/
+const video = () => ({
+	data: require_data.videoData,
+	build: (definition) => ({ object: buildVideo(definition) }),
+	controller: (elements) => ({ api: new VideoController(elements) })
+});
+//#endregion
+exports.VideoController = VideoController;
+exports.buildVideo = buildVideo;
+exports.validateVideo = require_data.validateVideo;
+exports.video = video;
+exports.videoData = require_data.videoData;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["VideoTexture","SRGBColorSpace","Mesh","PlaneGeometry","MeshBasicMaterial","videoData"],"sources":["../src/buildVideo.ts","../src/VideoController.ts","../src/plugin.ts"],"sourcesContent":["import { Mesh, MeshBasicMaterial, PlaneGeometry, SRGBColorSpace, VideoTexture, type Object3D } from \"three\";\nimport type { Video } from \"./data\";\n\n/**\n * Build the three.js object for a `Video`: a plane textured with an HTML video\n * element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene\n * lights off. The video element is kept on `userData.video` for the controller\n * to play/pause; `VideoTexture` refreshes itself each frame while playing.\n */\nexport function buildVideo(video: Video): Object3D {\n  const el = document.createElement(\"video\");\n  el.src = video.src;\n  el.loop = video.loop ?? true;\n  el.muted = video.muted ?? true;\n  el.playsInline = true;\n  el.preload = \"auto\";\n  el.load();\n\n  const texture = new VideoTexture(el);\n  texture.colorSpace = SRGBColorSpace;\n\n  const [width, height] = video.size;\n  const mesh = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));\n  mesh.position.set(video.position[0], video.position[1], video.position[2]);\n  mesh.rotation.y = video.rotation ?? 0;\n  mesh.visible = video.visible ?? true;\n  mesh.name = `video:${video.id}`;\n  mesh.userData.scenographyId = video.id;\n  mesh.userData.video = el;\n\n  if (video.autoplay ?? false) void el.play().catch(() => {});\n  return mesh;\n}\n","import type { VideoApi } from \"@scenography/engine\";\nimport type { Object3D } from \"three\";\n\n/**\n * High-level video control surfaced as `ctx.video`. Works over the live video\n * meshes (queried fresh each call so it survives hot-swaps), driving the\n * underlying HTML video elements by `id`.\n */\nexport class VideoController implements VideoApi {\n  private readonly getVideos: () => ReadonlyMap<string, Object3D>;\n\n  constructor(getVideos: () => ReadonlyMap<string, Object3D>) {\n    this.getVideos = getVideos;\n  }\n\n  private element(id: string): HTMLVideoElement | undefined {\n    return this.getVideos().get(id)?.userData.video as HTMLVideoElement | undefined;\n  }\n\n  /** Start (or resume) playback of the video with this `id`. */\n  play(id: string): void {\n    void this.element(id)?.play().catch(() => {});\n  }\n\n  /** Pause the video with this `id`. */\n  pause(id: string): void {\n    this.element(id)?.pause();\n  }\n\n  /** Show or hide the screen with this `id`. */\n  setVisible(id: string, visible: boolean): void {\n    const mesh = this.getVideos().get(id);\n    if (mesh) mesh.visible = visible;\n  }\n}\n","import type { EnginePlugin } from \"@scenography/engine\";\n\nimport { buildVideo } from \"./buildVideo\";\nimport { VideoController } from \"./VideoController\";\nimport { videoData, type Video } from \"./data\";\n\n/**\n * The video plugin: builds each `Video` screen (an HTML video on a plane) and\n * exposes `ctx.video` — a controller that plays/pauses/shows the live screens.\n */\nexport const video = (): EnginePlugin<Video> => ({\n  data: videoData,\n  build: (definition) => ({ object: buildVideo(definition) }),\n  controller: (elements) => ({ api: new VideoController(elements) }),\n});\n"],"mappings":";;;;;;;;;;AASA,SAAgB,WAAW,OAAwB;CACjD,MAAM,KAAK,SAAS,cAAc,OAAO;CACzC,GAAG,MAAM,MAAM;CACf,GAAG,OAAO,MAAM,QAAQ;CACxB,GAAG,QAAQ,MAAM,SAAS;CAC1B,GAAG,cAAc;CACjB,GAAG,UAAU;CACb,GAAG,KAAK;CAER,MAAM,UAAU,IAAIA,MAAAA,aAAa,EAAE;CACnC,QAAQ,aAAaC,MAAAA;CAErB,MAAM,CAAC,OAAO,UAAU,MAAM;CAC9B,MAAM,OAAO,IAAIC,MAAAA,KAAK,IAAIC,MAAAA,cAAc,OAAO,MAAM,GAAG,IAAIC,MAAAA,kBAAkB,EAAE,KAAK,QAAQ,CAAC,CAAC;CAC/F,KAAK,SAAS,IAAI,MAAM,SAAS,IAAI,MAAM,SAAS,IAAI,MAAM,SAAS,EAAE;CACzE,KAAK,SAAS,IAAI,MAAM,YAAY;CACpC,KAAK,UAAU,MAAM,WAAW;CAChC,KAAK,OAAO,SAAS,MAAM;CAC3B,KAAK,SAAS,gBAAgB,MAAM;CACpC,KAAK,SAAS,QAAQ;CAEtB,IAAI,MAAM,YAAY,OAAO,GAAQ,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CAC1D,OAAO;AACT;;;;;;;;ACxBA,IAAa,kBAAb,MAAiD;CAC/C;CAEA,YAAY,WAAgD;EAC1D,KAAK,YAAY;CACnB;CAEA,QAAgB,IAA0C;EACxD,OAAO,KAAK,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS;CAC5C;;CAGA,KAAK,IAAkB;EACrB,KAAU,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CAC9C;;CAGA,MAAM,IAAkB;EACtB,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM;CAC1B;;CAGA,WAAW,IAAY,SAAwB;EAC7C,MAAM,OAAO,KAAK,UAAU,CAAC,CAAC,IAAI,EAAE;EACpC,IAAI,MAAM,KAAK,UAAU;CAC3B;AACF;;;;;;;ACxBA,MAAa,eAAoC;CAC/C,MAAMC,aAAAA;CACN,QAAQ,gBAAgB,EAAE,QAAQ,WAAW,UAAU,EAAE;CACzD,aAAa,cAAc,EAAE,KAAK,IAAI,gBAAgB,QAAQ,EAAE;AAClE"}

package/dist/index.d.cts

@@ -0,0 +1,40 @@
+import { n as validateVideo, r as Video, t as videoData } from "./index-CtaN02zR.cjs";
+import { EnginePlugin, VideoApi } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * The video plugin: builds each `Video` screen (an HTML video on a plane) and
+ * exposes `ctx.video` — a controller that plays/pauses/shows the live screens.
+ */
+declare const video: () => EnginePlugin<Video>;
+//#endregion
+//#region src/buildVideo.d.ts
+/**
+ * Build the three.js object for a `Video`: a plane textured with an HTML video
+ * element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene
+ * lights off. The video element is kept on `userData.video` for the controller
+ * to play/pause; `VideoTexture` refreshes itself each frame while playing.
+ */
+declare function buildVideo(video: Video): Object3D;
+//#endregion
+//#region src/VideoController.d.ts
+/**
+ * High-level video control surfaced as `ctx.video`. Works over the live video
+ * meshes (queried fresh each call so it survives hot-swaps), driving the
+ * underlying HTML video elements by `id`.
+ */
+declare class VideoController implements VideoApi {
+  private readonly getVideos;
+  constructor(getVideos: () => ReadonlyMap<string, Object3D>);
+  private element;
+  /** Start (or resume) playback of the video with this `id`. */
+  play(id: string): void;
+  /** Pause the video with this `id`. */
+  pause(id: string): void;
+  /** Show or hide the screen with this `id`. */
+  setVisible(id: string, visible: boolean): void;
+}
+//#endregion
+export { type Video, VideoController, buildVideo, validateVideo, video, videoData };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,40 @@
+import { n as validateVideo, r as Video, t as videoData } from "./index-CtaN02zR.mjs";
+import { Object3D } from "three";
+import { EnginePlugin, VideoApi } from "@scenography/engine";
+
+//#region src/plugin.d.ts
+/**
+ * The video plugin: builds each `Video` screen (an HTML video on a plane) and
+ * exposes `ctx.video` — a controller that plays/pauses/shows the live screens.
+ */
+declare const video: () => EnginePlugin<Video>;
+//#endregion
+//#region src/buildVideo.d.ts
+/**
+ * Build the three.js object for a `Video`: a plane textured with an HTML video
+ * element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene
+ * lights off. The video element is kept on `userData.video` for the controller
+ * to play/pause; `VideoTexture` refreshes itself each frame while playing.
+ */
+declare function buildVideo(video: Video): Object3D;
+//#endregion
+//#region src/VideoController.d.ts
+/**
+ * High-level video control surfaced as `ctx.video`. Works over the live video
+ * meshes (queried fresh each call so it survives hot-swaps), driving the
+ * underlying HTML video elements by `id`.
+ */
+declare class VideoController implements VideoApi {
+  private readonly getVideos;
+  constructor(getVideos: () => ReadonlyMap<string, Object3D>);
+  private element;
+  /** Start (or resume) playback of the video with this `id`. */
+  play(id: string): void;
+  /** Pause the video with this `id`. */
+  pause(id: string): void;
+  /** Show or hide the screen with this `id`. */
+  setVisible(id: string, visible: boolean): void;
+}
+//#endregion
+export { type Video, VideoController, buildVideo, validateVideo, video, videoData };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,74 @@
+import { n as validateVideo, t as videoData } from "./data-DqD4TXso.mjs";
+import { Mesh, MeshBasicMaterial, PlaneGeometry, SRGBColorSpace, VideoTexture } from "three";
+//#region src/buildVideo.ts
+/**
+* Build the three.js object for a `Video`: a plane textured with an HTML video
+* element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene
+* lights off. The video element is kept on `userData.video` for the controller
+* to play/pause; `VideoTexture` refreshes itself each frame while playing.
+*/
+function buildVideo(video) {
+	const el = document.createElement("video");
+	el.src = video.src;
+	el.loop = video.loop ?? true;
+	el.muted = video.muted ?? true;
+	el.playsInline = true;
+	el.preload = "auto";
+	el.load();
+	const texture = new VideoTexture(el);
+	texture.colorSpace = SRGBColorSpace;
+	const [width, height] = video.size;
+	const mesh = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));
+	mesh.position.set(video.position[0], video.position[1], video.position[2]);
+	mesh.rotation.y = video.rotation ?? 0;
+	mesh.visible = video.visible ?? true;
+	mesh.name = `video:${video.id}`;
+	mesh.userData.scenographyId = video.id;
+	mesh.userData.video = el;
+	if (video.autoplay ?? false) el.play().catch(() => {});
+	return mesh;
+}
+//#endregion
+//#region src/VideoController.ts
+/**
+* High-level video control surfaced as `ctx.video`. Works over the live video
+* meshes (queried fresh each call so it survives hot-swaps), driving the
+* underlying HTML video elements by `id`.
+*/
+var VideoController = class {
+	getVideos;
+	constructor(getVideos) {
+		this.getVideos = getVideos;
+	}
+	element(id) {
+		return this.getVideos().get(id)?.userData.video;
+	}
+	/** Start (or resume) playback of the video with this `id`. */
+	play(id) {
+		this.element(id)?.play().catch(() => {});
+	}
+	/** Pause the video with this `id`. */
+	pause(id) {
+		this.element(id)?.pause();
+	}
+	/** Show or hide the screen with this `id`. */
+	setVisible(id, visible) {
+		const mesh = this.getVideos().get(id);
+		if (mesh) mesh.visible = visible;
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* The video plugin: builds each `Video` screen (an HTML video on a plane) and
+* exposes `ctx.video` — a controller that plays/pauses/shows the live screens.
+*/
+const video = () => ({
+	data: videoData,
+	build: (definition) => ({ object: buildVideo(definition) }),
+	controller: (elements) => ({ api: new VideoController(elements) })
+});
+//#endregion
+export { VideoController, buildVideo, validateVideo, video, videoData };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/buildVideo.ts","../src/VideoController.ts","../src/plugin.ts"],"sourcesContent":["import { Mesh, MeshBasicMaterial, PlaneGeometry, SRGBColorSpace, VideoTexture, type Object3D } from \"three\";\nimport type { Video } from \"./data\";\n\n/**\n * Build the three.js object for a `Video`: a plane textured with an HTML video\n * element. Unlit (`MeshBasicMaterial`) so it stays bright even with the scene\n * lights off. The video element is kept on `userData.video` for the controller\n * to play/pause; `VideoTexture` refreshes itself each frame while playing.\n */\nexport function buildVideo(video: Video): Object3D {\n  const el = document.createElement(\"video\");\n  el.src = video.src;\n  el.loop = video.loop ?? true;\n  el.muted = video.muted ?? true;\n  el.playsInline = true;\n  el.preload = \"auto\";\n  el.load();\n\n  const texture = new VideoTexture(el);\n  texture.colorSpace = SRGBColorSpace;\n\n  const [width, height] = video.size;\n  const mesh = new Mesh(new PlaneGeometry(width, height), new MeshBasicMaterial({ map: texture }));\n  mesh.position.set(video.position[0], video.position[1], video.position[2]);\n  mesh.rotation.y = video.rotation ?? 0;\n  mesh.visible = video.visible ?? true;\n  mesh.name = `video:${video.id}`;\n  mesh.userData.scenographyId = video.id;\n  mesh.userData.video = el;\n\n  if (video.autoplay ?? false) void el.play().catch(() => {});\n  return mesh;\n}\n","import type { VideoApi } from \"@scenography/engine\";\nimport type { Object3D } from \"three\";\n\n/**\n * High-level video control surfaced as `ctx.video`. Works over the live video\n * meshes (queried fresh each call so it survives hot-swaps), driving the\n * underlying HTML video elements by `id`.\n */\nexport class VideoController implements VideoApi {\n  private readonly getVideos: () => ReadonlyMap<string, Object3D>;\n\n  constructor(getVideos: () => ReadonlyMap<string, Object3D>) {\n    this.getVideos = getVideos;\n  }\n\n  private element(id: string): HTMLVideoElement | undefined {\n    return this.getVideos().get(id)?.userData.video as HTMLVideoElement | undefined;\n  }\n\n  /** Start (or resume) playback of the video with this `id`. */\n  play(id: string): void {\n    void this.element(id)?.play().catch(() => {});\n  }\n\n  /** Pause the video with this `id`. */\n  pause(id: string): void {\n    this.element(id)?.pause();\n  }\n\n  /** Show or hide the screen with this `id`. */\n  setVisible(id: string, visible: boolean): void {\n    const mesh = this.getVideos().get(id);\n    if (mesh) mesh.visible = visible;\n  }\n}\n","import type { EnginePlugin } from \"@scenography/engine\";\n\nimport { buildVideo } from \"./buildVideo\";\nimport { VideoController } from \"./VideoController\";\nimport { videoData, type Video } from \"./data\";\n\n/**\n * The video plugin: builds each `Video` screen (an HTML video on a plane) and\n * exposes `ctx.video` — a controller that plays/pauses/shows the live screens.\n */\nexport const video = (): EnginePlugin<Video> => ({\n  data: videoData,\n  build: (definition) => ({ object: buildVideo(definition) }),\n  controller: (elements) => ({ api: new VideoController(elements) }),\n});\n"],"mappings":";;;;;;;;;AASA,SAAgB,WAAW,OAAwB;CACjD,MAAM,KAAK,SAAS,cAAc,OAAO;CACzC,GAAG,MAAM,MAAM;CACf,GAAG,OAAO,MAAM,QAAQ;CACxB,GAAG,QAAQ,MAAM,SAAS;CAC1B,GAAG,cAAc;CACjB,GAAG,UAAU;CACb,GAAG,KAAK;CAER,MAAM,UAAU,IAAI,aAAa,EAAE;CACnC,QAAQ,aAAa;CAErB,MAAM,CAAC,OAAO,UAAU,MAAM;CAC9B,MAAM,OAAO,IAAI,KAAK,IAAI,cAAc,OAAO,MAAM,GAAG,IAAI,kBAAkB,EAAE,KAAK,QAAQ,CAAC,CAAC;CAC/F,KAAK,SAAS,IAAI,MAAM,SAAS,IAAI,MAAM,SAAS,IAAI,MAAM,SAAS,EAAE;CACzE,KAAK,SAAS,IAAI,MAAM,YAAY;CACpC,KAAK,UAAU,MAAM,WAAW;CAChC,KAAK,OAAO,SAAS,MAAM;CAC3B,KAAK,SAAS,gBAAgB,MAAM;CACpC,KAAK,SAAS,QAAQ;CAEtB,IAAI,MAAM,YAAY,OAAO,GAAQ,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CAC1D,OAAO;AACT;;;;;;;;ACxBA,IAAa,kBAAb,MAAiD;CAC/C;CAEA,YAAY,WAAgD;EAC1D,KAAK,YAAY;CACnB;CAEA,QAAgB,IAA0C;EACxD,OAAO,KAAK,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS;CAC5C;;CAGA,KAAK,IAAkB;EACrB,KAAU,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;CAC9C;;CAGA,MAAM,IAAkB;EACtB,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM;CAC1B;;CAGA,WAAW,IAAY,SAAwB;EAC7C,MAAM,OAAO,KAAK,UAAU,CAAC,CAAC,IAAI,EAAE;EACpC,IAAI,MAAM,KAAK,UAAU;CAC3B;AACF;;;;;;;ACxBA,MAAa,eAAoC;CAC/C,MAAM;CACN,QAAQ,gBAAgB,EAAE,QAAQ,WAAW,UAAU,EAAE;CACzD,aAAa,cAAc,EAAE,KAAK,IAAI,gBAAgB,QAAQ,EAAE;AAClE"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@scenography/plugin-video",
+  "version": "0.2.0",
+  "description": "Video plugin for scenography: video screens (HTML video on a plane) with ctx.video runtime control.",
+  "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"
+      }
+    },
+    "./data": {
+      "import": {
+        "types": "./dist/data.d.mts",
+        "default": "./dist/data.mjs"
+      },
+      "require": {
+        "types": "./dist/data.d.cts",
+        "default": "./dist/data.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"
+  }
+}