@babylonjs/core 9.13.0 → 9.14.0

package/Materials/Textures/HTML/htmlTexture.js

@@ -0,0 +1,455 @@
+/** This module has no top-level side effects: the engine extension it depends on is registered lazily from the constructor */
+import { BaseTexture } from "../baseTexture.pure.js";
+
+import { Matrix } from "../../../Maths/math.vector.pure.js";
+import { Observable } from "../../../Misc/observable.pure.js";
+import { Logger } from "../../../Misc/logger.js";
+import { IsWindowObjectExist } from "../../../Misc/domManagement.js";
+import { RegisterEnginesExtensionsEngineDynamicTexture } from "../../../Engines/Extensions/engine.dynamicTexture.pure.js";
+let _HasWarnedAboutMissingApi = false;
+function _WarnMissingApi(apiName) {
+    if (_HasWarnedAboutMissingApi) {
+        return;
+    }
+    _HasWarnedAboutMissingApi = true;
+    Logger.Warn(`HTML-in-Canvas: ${apiName} is not available. Enable chrome://flags/#canvas-draw-element, the built-in SVG fallback, or the three-html-render polyfill to use HtmlTexture.`);
+}
+let _HasWarnedAboutSvgFallback = false;
+function _WarnSvgFallback() {
+    if (_HasWarnedAboutSvgFallback) {
+        return;
+    }
+    _HasWarnedAboutSvgFallback = true;
+    Logger.Warn("HTML-in-Canvas: the SVG fallback could not rasterize the element. This usually means it references cross-origin or external resources, which taint the snapshot.");
+}
+let _HasWarnedAboutUploadFailure = false;
+function _WarnUploadFailure(error) {
+    if (_HasWarnedAboutUploadFailure) {
+        return;
+    }
+    _HasWarnedAboutUploadFailure = true;
+    const message = error instanceof Error ? error.message : String(error);
+    Logger.Warn(`HTML-in-Canvas: the native upload failed (${message}). The element must be a direct child of the engine's rendering canvas, which must carry the \`layoutsubtree\` attribute, and the upload must run during a paint event.`);
+}
+/**
+ * Detects whether the engine can upload an HTML element through the native (or polyfilled) WICG
+ * HTML-in-Canvas API, without emitting any warning. Used to decide whether the SVG fallback is needed.
+ * @param engine defines the engine to test
+ * @returns true when the WICG upload API is available for this engine
+ */
+export function IsHtmlInCanvasUploadSupported(engine) {
+    if (engine.isWebGPU) {
+        const queue = engine._device?.queue;
+        return !!queue && typeof queue.copyElementImageToTexture === "function";
+    }
+    const gl = engine._gl;
+    return !!gl && typeof gl.texElementImage2D === "function";
+}
+/**
+ * Uploads a live HTML element (or a captured ElementImage) into an existing 2D texture using the WICG
+ * HTML-in-Canvas API (https://github.com/WICG/html-in-canvas).
+ *
+ * This is a side-effect-free helper - it is only reachable when {@link HtmlTexture} (or a direct caller)
+ * is imported, so it adds nothing to bundles that do not use it. It relies on
+ * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),
+ * available either natively (behind chrome://flags/#canvas-draw-element) or through the
+ * three-html-render polyfill.
+ * @param engine defines the engine that owns the texture
+ * @param texture defines the internal texture to update
+ * @param element defines the source HTML element (or captured ElementImage) to upload
+ * @param invertY defines if data must be stored with Y axis inverted (true by default)
+ * @param config defines an optional source rectangle and sizing configuration
+ * @returns true if the upload succeeded, false otherwise (e.g. the API is unavailable)
+ */
+export function UploadHtmlElementToTexture(engine, texture, element, invertY = true, config) {
+    if (!texture || texture._isDisabled) {
+        return false;
+    }
+    if (engine.isWebGPU) {
+        return _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, config);
+    }
+    return _UploadHtmlElementToWebGLTexture(engine, texture, element, invertY, config);
+}
+// The texElementImage2D signature was changed mid-flight in the WICG proposal (see
+// https://github.com/WICG/html-in-canvas#idl-changes): the current spec form is
+// texElementImage2D(target, internalformat, element, config?), but older Chrome Canary builds (and the
+// three-html-render polyfill) still ship the legacy texImage2D-shaped overload
+// texElementImage2D(target, level, internalformat, format, type, element). We prefer the new form and
+// fall back to the legacy one when the implementation rejects it for the wrong number of arguments. The
+// detected shape is cached so we only pay the failed call once.
+let _UseLegacyTexElementImage2D = false;
+function _CallTexElementImage2D(gl, internalFormat, element, config) {
+    if (!_UseLegacyTexElementImage2D) {
+        try {
+            gl.texElementImage2D(gl.TEXTURE_2D, internalFormat, element, config);
+            return;
+        }
+        catch (error) {
+            // Only a wrong-arity TypeError means we are talking to the legacy signature; anything else
+            // (e.g. the element is not a canvas child) is a genuine upload failure and must propagate.
+            // Native rejects the new form with "N arguments required, but only M present"; the
+            // three-html-render polyfill rejects it with "unexpected argument count N".
+            if (!(error instanceof TypeError) || !/arguments required|argument count/.test(error.message)) {
+                throw error;
+            }
+            _UseLegacyTexElementImage2D = true;
+        }
+    }
+    // Legacy overload: texElementImage2D(target, level, internalformat, format, type, element).
+    gl.texElementImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, element);
+}
+function _UploadHtmlElementToWebGLTexture(engine, texture, element, invertY, config) {
+    // texElementImage2D is provided either natively (behind a flag) or by the three-html-render polyfill.
+    // Engines without a WebGL context (e.g. NullEngine) have no _gl and are handled by this guard.
+    const gl = engine._gl;
+    if (!gl || typeof gl.texElementImage2D !== "function") {
+        _WarnMissingApi("texElementImage2D");
+        return false;
+    }
+    // texElementImage2D requires a *sized* internal format (RGBA8, SRGB8_ALPHA8, RGBA16F or RGBA32F);
+    // the unsized gl.RGBA returned by _getInternalFormat is rejected.
+    const internalFormat = engine._getRGBABufferInternalSizedFormat(texture.type, texture.format, texture._useSRGBBuffer);
+    const wasPreviouslyBound = engine._bindTextureDirectly(gl.TEXTURE_2D, texture, true);
+    engine._unpackFlipY(invertY);
+    try {
+        _CallTexElementImage2D(gl, internalFormat, element, config);
+        if (texture.generateMipMaps) {
+            gl.generateMipmap(gl.TEXTURE_2D);
+        }
+        if (!wasPreviouslyBound) {
+            engine._bindTextureDirectly(gl.TEXTURE_2D, null);
+        }
+        texture.invertY = invertY;
+        texture.isReady = true;
+        return true;
+    }
+    catch (error) {
+        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is
+        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before
+        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later
+        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.
+        _WarnUploadFailure(error);
+        return false;
+    }
+}
+function _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, config) {
+    // copyElementImageToTexture is provided either natively (behind a flag) or by the three-html-render polyfill.
+    const device = engine._device;
+    const queue = device && device.queue;
+    if (!device || !queue || typeof queue.copyElementImageToTexture !== "function") {
+        _WarnMissingApi("GPUQueue.copyElementImageToTexture");
+        return false;
+    }
+    const gpuTexture = texture._hardwareTexture?.underlyingResource;
+    if (!gpuTexture) {
+        return false;
+    }
+    try {
+        const source = { source: element };
+        if (config) {
+            source.sx = config.sx;
+            source.sy = config.sy;
+            source.swidth = config.swidth;
+            source.sheight = config.sheight;
+        }
+        queue.copyElementImageToTexture(source, {
+            destination: { texture: gpuTexture },
+            width: config?.width ?? texture.width,
+            height: config?.height ?? texture.height,
+        });
+        if (texture.generateMipMaps) {
+            engine._generateMipmaps(texture);
+        }
+        // The WICG copyElementImageToTexture API has no flipY option; the destination orientation is
+        // determined by the source. We record the requested value for downstream sampling conventions.
+        texture.invertY = invertY;
+        texture.isReady = true;
+        return true;
+    }
+    catch (error) {
+        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is
+        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before
+        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later
+        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.
+        _WarnUploadFailure(error);
+        return false;
+    }
+}
+/**
+ * A texture whose content is rendered from a live HTML element using the WICG HTML-in-Canvas API
+ * (https://github.com/WICG/html-in-canvas).
+ *
+ * The element is hosted as a child of the engine's rendering canvas (which is marked `layoutsubtree`) so
+ * the browser can lay it out and snapshot it; the WICG API requires the source element to be a direct
+ * child of the canvas whose context performs the upload. Content is uploaded through
+ * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),
+ * available either natively (behind chrome://flags/#canvas-draw-element) or via the three-html-render
+ * polyfill (https://github.com/repalash/three-html-render). When neither is present, a built-in SVG
+ * `<foreignObject>` fallback is used instead (see `useSvgFallback`).
+ *
+ * As with {@link HtmlElementTexture}, updates are not automatic unless `autoUpdate` is enabled; in
+ * that case the texture refreshes whenever the host canvas reports a paint change.
+ */
+export class HtmlTexture extends BaseTexture {
+    /**
+     * Instantiates an HtmlTexture from an HTML element.
+     * @param name Defines the name of the texture
+     * @param element Defines the HTML element to render into the texture
+     * @param options Defines the texture creation options
+     */
+    constructor(name, element, options) {
+        super(options.scene || options.engine);
+        /**
+         * Observable triggered once the texture has been rendered for the first time.
+         */
+        this.onLoadObservable = new Observable();
+        this._paintHandler = null;
+        this._ownsHost = false;
+        this._originalParent = null;
+        this._originalNextSibling = null;
+        this._addedInert = false;
+        this.element = element;
+        this._textureMatrix = Matrix.Identity();
+        if (!element || (!options.engine && !options.scene)) {
+            this.host = null;
+            this._width = 0;
+            this._height = 0;
+            this._format = HtmlTexture._DefaultOptions.format;
+            this._generateMipMaps = HtmlTexture._DefaultOptions.generateMipMaps;
+            this._samplingMode = HtmlTexture._DefaultOptions.samplingMode;
+            this._useSvgFallback = HtmlTexture._DefaultOptions.useSvgFallback;
+            return;
+        }
+        this._generateMipMaps = options.generateMipMaps ?? HtmlTexture._DefaultOptions.generateMipMaps;
+        this._samplingMode = options.samplingMode ?? HtmlTexture._DefaultOptions.samplingMode;
+        this._format = options.format ?? HtmlTexture._DefaultOptions.format;
+        this._useSvgFallback = options.useSvgFallback ?? HtmlTexture._DefaultOptions.useSvgFallback;
+        const autoUpdate = options.autoUpdate ?? HtmlTexture._DefaultOptions.autoUpdate;
+        this._width = options.width || element.offsetWidth || 256;
+        this._height = options.height || element.offsetHeight || 256;
+        this.name = name;
+        this.wrapU = 0;
+        this.wrapV = 0;
+        this.anisotropicFilteringLevel = 1;
+        this.host = this._createHost();
+        // The native WICG API has no content until the first paint snapshot is recorded, so the initial
+        // upload must happen from a paint event. The rendering canvas emits `paint`; listen for at least the
+        // first one and, when auto-update is disabled, detach after that first refresh. A non-canvas helper
+        // host never emits `paint`, so this listener is simply never invoked there.
+        if (this.host) {
+            this._paintHandler = (event) => {
+                // A single `paint` event covers every changed child of the shared rendering canvas. When the
+                // browser reports which elements changed, skip the upload unless ours is among them, so that
+                // multiple HTML textures hosted on the same canvas don't all re-upload on every unrelated change.
+                if (event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {
+                    return;
+                }
+                this.update();
+                if (!autoUpdate && this._paintHandler && this.host) {
+                    this.host.removeEventListener("paint", this._paintHandler);
+                    this._paintHandler = null;
+                }
+            };
+            this.host.addEventListener("paint", this._paintHandler);
+        }
+        this._createInternalTexture();
+    }
+    _createHost() {
+        if (!IsWindowObjectExist() || typeof document === "undefined") {
+            return null;
+        }
+        // Remember where the caller had the element so dispose() can put it back: we are about to re-parent it
+        // into the host (the element must be a direct child of the host to be captured and laid out).
+        this._originalParent = this.element.parentNode;
+        this._originalNextSibling = this.element.nextSibling;
+        // Per the WICG spec, the source element must be a *direct child* of the same canvas whose WebGL/WebGPU
+        // context performs the upload, and that canvas must opt its subtree into layout via `layoutsubtree`.
+        // The engine already owns our texture through its rendering canvas, so the element has to live inside
+        // that canvas: it is the only one whose context can snapshot the element via texElementImage2D /
+        // copyElementImageToTexture. A separate canvas would lay the element out but could never be captured
+        // into the engine's texture (this is why nothing rendered on the native path before).
+        const renderingCanvas = this._getEngine()?.getRenderingCanvas() ?? null;
+        if (renderingCanvas) {
+            renderingCanvas.layoutSubtree = true;
+            // `layoutsubtree` opts children into hit testing; mark ours inert so it never steals pointer events
+            // from the canvas (e.g. camera controls). Synthetic event dispatch still reaches inert elements, so
+            // HtmlRaycastInteractionManager keeps working; HtmlInteractionManager clears it to enable native input.
+            this._addedInert = !this.element.hasAttribute("inert");
+            this.element.setAttribute("inert", "");
+            renderingCanvas.appendChild(this.element);
+            this._ownsHost = false;
+            return renderingCanvas;
+        }
+        // No rendering canvas (e.g. NullEngine / offscreen): the native upload paths cannot run, because they
+        // capture from the engine's canvas and there is none. Only the SVG fallback renders here, and it builds
+        // from the element's serialized markup rather than from a canvas - so a host *canvas* would buy nothing.
+        // Host the element in a hidden, off-screen <div> purely so it is laid out in the document (giving
+        // correct measured sizes); there is no canvas to capture into on this path.
+        const host = document.createElement("div");
+        host.style.position = "absolute";
+        host.style.left = "-99999px";
+        host.style.top = "0px";
+        host.style.pointerEvents = "none";
+        host.setAttribute("aria-hidden", "true");
+        host.appendChild(this.element);
+        document.body.appendChild(host);
+        this._ownsHost = true;
+        return host;
+    }
+    _createInternalTexture() {
+        const engine = this._getEngine();
+        if (engine) {
+            // createDynamicTexture is an engine extension; register it lazily (idempotent) so this module stays free of top-level side effects.
+            RegisterEnginesExtensionsEngineDynamicTexture();
+            this._texture = engine.createDynamicTexture(this._width, this._height, this._generateMipMaps, this._samplingMode);
+            this._texture.format = this._format;
+        }
+        // Trigger the initial render. On the native path this requests a paint so the first upload happens
+        // once a snapshot exists (calling the WICG API before the first snapshot throws); otherwise the
+        // SVG fallback (or a direct update) renders immediately.
+        this.requestUpdate();
+    }
+    /**
+     * @returns the texture matrix used in most of the material.
+     */
+    getTextureMatrix() {
+        return this._textureMatrix;
+    }
+    /**
+     * Requests the host canvas to emit a paint event on the next rendering update. When auto-update is
+     * enabled, this triggers a texture refresh in sync with the DOM. Falls back to an immediate update
+     * when the WICG API is not available.
+     */
+    requestUpdate() {
+        // `requestPaint` only exists on a WICG-capable rendering canvas; the helper <div> host has no such
+        // method, so fall back to an immediate update there.
+        const canvasHost = this.host;
+        if (canvasHost && typeof canvasHost.requestPaint === "function") {
+            canvasHost.requestPaint();
+        }
+        else {
+            this.update();
+        }
+    }
+    /**
+     * Updates the content of the texture from the current state of the HTML element.
+     * @param invertY Defines whether the texture should be inverted on Y (true by default)
+     */
+    update(invertY = true) {
+        const engine = this._getEngine();
+        if (this._texture == null || engine == null) {
+            return;
+        }
+        // When the native WICG upload API is unavailable, render through the SVG <foreignObject> fallback
+        // (unless it was explicitly disabled, in which case the upload helper emits a one-time warning).
+        if (this._useSvgFallback && !IsHtmlInCanvasUploadSupported(engine)) {
+            this._updateFromSvgFallback(engine, invertY);
+            return;
+        }
+        const wasReady = this.isReady();
+        UploadHtmlElementToTexture(engine, this._texture, this.element, invertY);
+        if (!wasReady && this.isReady()) {
+            this.onLoadObservable.notifyObservers(this);
+        }
+    }
+    /**
+     * Renders the element through an SVG `<foreignObject>` snapshot and uploads it to the texture. This
+     * fallback works in any browser but only captures same-origin, inline-styled content as a static image.
+     * @param engine defines the engine that owns the texture
+     * @param invertY defines whether the texture should be inverted on Y
+     */
+    _updateFromSvgFallback(engine, invertY) {
+        if (typeof document === "undefined" || typeof Image === "undefined" || typeof XMLSerializer === "undefined") {
+            return;
+        }
+        const svgUrl = this._buildSvgDataUrl();
+        if (!svgUrl) {
+            return;
+        }
+        const image = new Image();
+        image.onload = () => {
+            if (this._texture == null) {
+                return;
+            }
+            const wasReady = this.isReady();
+            try {
+                engine.updateDynamicTexture(this._texture, image, invertY, false, this._format);
+            }
+            catch {
+                _WarnSvgFallback();
+                return;
+            }
+            if (!wasReady && this.isReady()) {
+                this.onLoadObservable.notifyObservers(this);
+            }
+        };
+        image.onerror = () => {
+            _WarnSvgFallback();
+        };
+        image.src = svgUrl;
+    }
+    /**
+     * Serializes the element into an SVG `<foreignObject>` data URL sized to the texture.
+     * @returns a data URL, or null if serialization failed
+     */
+    _buildSvgDataUrl() {
+        try {
+            const clone = this.element.cloneNode(true);
+            clone.setAttribute("xmlns", "http://www.w3.org/1999/xhtml");
+            const serialized = new XMLSerializer().serializeToString(clone);
+            const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${this._width}" height="${this._height}">` +
+                `<foreignObject x="0" y="0" width="100%" height="100%">${serialized}</foreignObject>` +
+                `</svg>`;
+            return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Gets the current class name of the texture useful for serialization or dynamic coding.
+     * @returns "HtmlTexture"
+     */
+    getClassName() {
+        return "HtmlTexture";
+    }
+    /**
+     * Dispose the texture and release its associated resources.
+     */
+    dispose() {
+        if (this.host) {
+            if (this._paintHandler) {
+                this.host.removeEventListener("paint", this._paintHandler);
+                this._paintHandler = null;
+            }
+            // Remove the `inert` attribute we added so the caller gets the element back as they passed it.
+            if (this._addedInert) {
+                this.element.removeAttribute("inert");
+                this._addedInert = false;
+            }
+            // Restore the element to where the caller had it before we re-parented it into the host, rather
+            // than silently deleting their node from the document.
+            if (this._originalParent) {
+                const reference = this._originalNextSibling && this._originalNextSibling.parentNode === this._originalParent ? this._originalNextSibling : null;
+                this._originalParent.insertBefore(this.element, reference);
+            }
+            else {
+                this.element.remove();
+            }
+            // Remove the helper host we created (never the engine's borrowed rendering canvas).
+            if (this._ownsHost) {
+                this.host.remove();
+            }
+        }
+        this.onLoadObservable.clear();
+        super.dispose();
+    }
+}
+HtmlTexture._DefaultOptions = {
+    generateMipMaps: false,
+    samplingMode: 2,
+    format: 5,
+    autoUpdate: true,
+    useSvgFallback: true,
+};
+//# sourceMappingURL=htmlTexture.js.map

package/Materials/Textures/HTML/htmlTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlTexture.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/HTML/htmlTexture.ts"],"names":[],"mappings":"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","sourcesContent":["/** This module has no top-level side effects: the engine extension it depends on is registered lazily from the constructor */\n\nimport { type Nullable } from \"../../../types\";\nimport { BaseTexture } from \"../baseTexture.pure\";\nimport { Constants } from \"../../../Engines/constants\";\nimport { Matrix } from \"../../../Maths/math.vector.pure\";\nimport { Observable } from \"../../../Misc/observable.pure\";\nimport { Logger } from \"../../../Misc/logger\";\nimport { IsWindowObjectExist } from \"../../../Misc/domManagement\";\nimport { RegisterEnginesExtensionsEngineDynamicTexture } from \"../../../Engines/Extensions/engine.dynamicTexture.pure\";\n\nimport { type AbstractEngine } from \"../../../Engines/abstractEngine.pure\";\nimport { type ThinEngine } from \"../../../Engines/thinEngine.pure\";\nimport { type WebGPUEngine } from \"../../../Engines/webgpuEngine.pure\";\nimport { type WebGPUHardwareTexture } from \"../../../Engines/WebGPU/webgpuHardwareTexture\";\nimport { type InternalTexture } from \"../internalTexture\";\nimport { type Scene } from \"../../../scene.pure\";\n\nlet _HasWarnedAboutMissingApi = false;\n\nfunction _WarnMissingApi(apiName: string): void {\n    if (_HasWarnedAboutMissingApi) {\n        return;\n    }\n    _HasWarnedAboutMissingApi = true;\n    Logger.Warn(\n        `HTML-in-Canvas: ${apiName} is not available. Enable chrome://flags/#canvas-draw-element, the built-in SVG fallback, or the three-html-render polyfill to use HtmlTexture.`\n    );\n}\n\nlet _HasWarnedAboutSvgFallback = false;\n\nfunction _WarnSvgFallback(): void {\n    if (_HasWarnedAboutSvgFallback) {\n        return;\n    }\n    _HasWarnedAboutSvgFallback = true;\n    Logger.Warn(\"HTML-in-Canvas: the SVG fallback could not rasterize the element. This usually means it references cross-origin or external resources, which taint the snapshot.\");\n}\n\nlet _HasWarnedAboutUploadFailure = false;\n\nfunction _WarnUploadFailure(error: unknown): void {\n    if (_HasWarnedAboutUploadFailure) {\n        return;\n    }\n    _HasWarnedAboutUploadFailure = true;\n    const message = error instanceof Error ? error.message : String(error);\n    Logger.Warn(\n        `HTML-in-Canvas: the native upload failed (${message}). The element must be a direct child of the engine's rendering canvas, which must carry the \\`layoutsubtree\\` attribute, and the upload must run during a paint event.`\n    );\n}\n\n/**\n * Detects whether the engine can upload an HTML element through the native (or polyfilled) WICG\n * HTML-in-Canvas API, without emitting any warning. Used to decide whether the SVG fallback is needed.\n * @param engine defines the engine to test\n * @returns true when the WICG upload API is available for this engine\n */\nexport function IsHtmlInCanvasUploadSupported(engine: AbstractEngine): boolean {\n    if (engine.isWebGPU) {\n        const queue = (engine as WebGPUEngine)._device?.queue;\n        return !!queue && typeof queue.copyElementImageToTexture === \"function\";\n    }\n\n    const gl = (engine as ThinEngine)._gl as Nullable<WebGL2RenderingContext>;\n    return !!gl && typeof gl.texElementImage2D === \"function\";\n}\n\n/**\n * Uploads a live HTML element (or a captured ElementImage) into an existing 2D texture using the WICG\n * HTML-in-Canvas API (https://github.com/WICG/html-in-canvas).\n *\n * This is a side-effect-free helper - it is only reachable when {@link HtmlTexture} (or a direct caller)\n * is imported, so it adds nothing to bundles that do not use it. It relies on\n * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),\n * available either natively (behind chrome://flags/#canvas-draw-element) or through the\n * three-html-render polyfill.\n * @param engine defines the engine that owns the texture\n * @param texture defines the internal texture to update\n * @param element defines the source HTML element (or captured ElementImage) to upload\n * @param invertY defines if data must be stored with Y axis inverted (true by default)\n * @param config defines an optional source rectangle and sizing configuration\n * @returns true if the upload succeeded, false otherwise (e.g. the API is unavailable)\n */\nexport function UploadHtmlElementToTexture(\n    engine: AbstractEngine,\n    texture: Nullable<InternalTexture>,\n    element: Element | ElementImage,\n    invertY: boolean = true,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    if (!texture || texture._isDisabled) {\n        return false;\n    }\n\n    if (engine.isWebGPU) {\n        return _UploadHtmlElementToWebGPUTexture(engine as WebGPUEngine, texture, element, invertY, config);\n    }\n\n    return _UploadHtmlElementToWebGLTexture(engine as ThinEngine, texture, element, invertY, config);\n}\n\n// The texElementImage2D signature was changed mid-flight in the WICG proposal (see\n// https://github.com/WICG/html-in-canvas#idl-changes): the current spec form is\n// texElementImage2D(target, internalformat, element, config?), but older Chrome Canary builds (and the\n// three-html-render polyfill) still ship the legacy texImage2D-shaped overload\n// texElementImage2D(target, level, internalformat, format, type, element). We prefer the new form and\n// fall back to the legacy one when the implementation rejects it for the wrong number of arguments. The\n// detected shape is cached so we only pay the failed call once.\nlet _UseLegacyTexElementImage2D = false;\n\nfunction _CallTexElementImage2D(gl: WebGL2RenderingContext, internalFormat: number, element: Element | ElementImage, config?: WebGLCopyElementImageConfig): void {\n    if (!_UseLegacyTexElementImage2D) {\n        try {\n            gl.texElementImage2D(gl.TEXTURE_2D, internalFormat, element, config);\n            return;\n        } catch (error) {\n            // Only a wrong-arity TypeError means we are talking to the legacy signature; anything else\n            // (e.g. the element is not a canvas child) is a genuine upload failure and must propagate.\n            // Native rejects the new form with \"N arguments required, but only M present\"; the\n            // three-html-render polyfill rejects it with \"unexpected argument count N\".\n            if (!(error instanceof TypeError) || !/arguments required|argument count/.test((error as Error).message)) {\n                throw error;\n            }\n            _UseLegacyTexElementImage2D = true;\n        }\n    }\n\n    // Legacy overload: texElementImage2D(target, level, internalformat, format, type, element).\n    gl.texElementImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, element);\n}\n\nfunction _UploadHtmlElementToWebGLTexture(\n    engine: ThinEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    // texElementImage2D is provided either natively (behind a flag) or by the three-html-render polyfill.\n    // Engines without a WebGL context (e.g. NullEngine) have no _gl and are handled by this guard.\n    const gl = engine._gl as Nullable<WebGL2RenderingContext>;\n    if (!gl || typeof gl.texElementImage2D !== \"function\") {\n        _WarnMissingApi(\"texElementImage2D\");\n        return false;\n    }\n\n    // texElementImage2D requires a *sized* internal format (RGBA8, SRGB8_ALPHA8, RGBA16F or RGBA32F);\n    // the unsized gl.RGBA returned by _getInternalFormat is rejected.\n    const internalFormat = engine._getRGBABufferInternalSizedFormat(texture.type, texture.format, texture._useSRGBBuffer);\n    const wasPreviouslyBound = engine._bindTextureDirectly(gl.TEXTURE_2D, texture, true);\n    engine._unpackFlipY(invertY);\n\n    try {\n        _CallTexElementImage2D(gl, internalFormat, element, config);\n\n        if (texture.generateMipMaps) {\n            gl.generateMipmap(gl.TEXTURE_2D);\n        }\n\n        if (!wasPreviouslyBound) {\n            engine._bindTextureDirectly(gl.TEXTURE_2D, null);\n        }\n\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    }\n}\n\nfunction _UploadHtmlElementToWebGPUTexture(\n    engine: WebGPUEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    // copyElementImageToTexture is provided either natively (behind a flag) or by the three-html-render polyfill.\n    const device = engine._device;\n    const queue = device && device.queue;\n    if (!device || !queue || typeof queue.copyElementImageToTexture !== \"function\") {\n        _WarnMissingApi(\"GPUQueue.copyElementImageToTexture\");\n        return false;\n    }\n\n    const gpuTexture = (texture._hardwareTexture as Nullable<WebGPUHardwareTexture>)?.underlyingResource;\n    if (!gpuTexture) {\n        return false;\n    }\n\n    try {\n        const source: GPUCopyElementImageSource = { source: element };\n        if (config) {\n            source.sx = config.sx;\n            source.sy = config.sy;\n            source.swidth = config.swidth;\n            source.sheight = config.sheight;\n        }\n\n        queue.copyElementImageToTexture(source, {\n            destination: { texture: gpuTexture },\n            width: config?.width ?? texture.width,\n            height: config?.height ?? texture.height,\n        });\n\n        if (texture.generateMipMaps) {\n            engine._generateMipmaps(texture);\n        }\n\n        // The WICG copyElementImageToTexture API has no flipY option; the destination orientation is\n        // determined by the source. We record the requested value for downstream sampling conventions.\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    }\n}\n\n/**\n * Defines the options used to create an {@link HtmlTexture}.\n */\nexport interface IHtmlTextureOptions {\n    /** Defines the width of the texture in pixels (defaults to the element's offset width, then 256). */\n    width?: number;\n    /** Defines the height of the texture in pixels (defaults to the element's offset height, then 256). */\n    height?: number;\n    /** Defines whether mip maps should be created or not (default: false). */\n    generateMipMaps?: boolean;\n    /** Defines the sampling mode of the texture (default: TEXTURE_BILINEAR_SAMPLINGMODE). */\n    samplingMode?: number;\n    /** Defines the associated texture format (default: TEXTUREFORMAT_RGBA). */\n    format?: number;\n    /** Defines whether the texture is automatically updated when the host canvas emits a paint event (default: true). */\n    autoUpdate?: boolean;\n    /**\n     * Defines whether to fall back to an SVG `<foreignObject>` rasterization when the native WICG\n     * HTML-in-Canvas API is unavailable (default: true). The fallback works in any browser but only\n     * captures same-origin, inline-styled content as a static snapshot (see the documentation for caveats).\n     */\n    useSvgFallback?: boolean;\n    /** Defines the engine instance to use the texture with. Not mandatory if a scene is provided. */\n    engine?: Nullable<AbstractEngine>;\n    /** Defines the scene the texture belongs to. Not mandatory if an engine is provided. */\n    scene?: Nullable<Scene>;\n}\n\n/**\n * A texture whose content is rendered from a live HTML element using the WICG HTML-in-Canvas API\n * (https://github.com/WICG/html-in-canvas).\n *\n * The element is hosted as a child of the engine's rendering canvas (which is marked `layoutsubtree`) so\n * the browser can lay it out and snapshot it; the WICG API requires the source element to be a direct\n * child of the canvas whose context performs the upload. Content is uploaded through\n * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),\n * available either natively (behind chrome://flags/#canvas-draw-element) or via the three-html-render\n * polyfill (https://github.com/repalash/three-html-render). When neither is present, a built-in SVG\n * `<foreignObject>` fallback is used instead (see `useSvgFallback`).\n *\n * As with {@link HtmlElementTexture}, updates are not automatic unless `autoUpdate` is enabled; in\n * that case the texture refreshes whenever the host canvas reports a paint change.\n */\nexport class HtmlTexture extends BaseTexture {\n    /**\n     * The HTML element rendered into the texture.\n     */\n    public readonly element: HTMLElement;\n\n    /**\n     * The element that hosts {@link element} in the document. This is the engine's rendering canvas when one\n     * is available (required by the WICG API, which can only capture the element from that canvas), or a\n     * hidden helper `<div>` otherwise - in which case only the SVG fallback can render.\n     */\n    public readonly host: Nullable<HTMLElement>;\n\n    /**\n     * Observable triggered once the texture has been rendered for the first time.\n     */\n    public onLoadObservable: Observable<HtmlTexture> = new Observable<HtmlTexture>();\n\n    private static readonly _DefaultOptions: Required<Pick<IHtmlTextureOptions, \"generateMipMaps\" | \"samplingMode\" | \"format\" | \"autoUpdate\" | \"useSvgFallback\">> = {\n        generateMipMaps: false,\n        samplingMode: Constants.TEXTURE_BILINEAR_SAMPLINGMODE,\n        format: Constants.TEXTUREFORMAT_RGBA,\n        autoUpdate: true,\n        useSvgFallback: true,\n    };\n\n    private readonly _format: number;\n    private readonly _generateMipMaps: boolean;\n    private readonly _samplingMode: number;\n    private readonly _useSvgFallback: boolean;\n    private readonly _textureMatrix: Matrix;\n    private _paintHandler: Nullable<(event: PaintEvent) => void> = null;\n    private _ownsHost: boolean = false;\n    private _originalParent: Nullable<Node & ParentNode> = null;\n    private _originalNextSibling: Nullable<ChildNode> = null;\n    private _addedInert: boolean = false;\n    private _width: number;\n    private _height: number;\n\n    /**\n     * Instantiates an HtmlTexture from an HTML element.\n     * @param name Defines the name of the texture\n     * @param element Defines the HTML element to render into the texture\n     * @param options Defines the texture creation options\n     */\n    constructor(name: string, element: HTMLElement, options: IHtmlTextureOptions) {\n        super(options.scene || options.engine);\n\n        this.element = element;\n        this._textureMatrix = Matrix.Identity();\n\n        if (!element || (!options.engine && !options.scene)) {\n            this.host = null;\n            this._width = 0;\n            this._height = 0;\n            this._format = HtmlTexture._DefaultOptions.format;\n            this._generateMipMaps = HtmlTexture._DefaultOptions.generateMipMaps;\n            this._samplingMode = HtmlTexture._DefaultOptions.samplingMode;\n            this._useSvgFallback = HtmlTexture._DefaultOptions.useSvgFallback;\n            return;\n        }\n\n        this._generateMipMaps = options.generateMipMaps ?? HtmlTexture._DefaultOptions.generateMipMaps;\n        this._samplingMode = options.samplingMode ?? HtmlTexture._DefaultOptions.samplingMode;\n        this._format = options.format ?? HtmlTexture._DefaultOptions.format;\n        this._useSvgFallback = options.useSvgFallback ?? HtmlTexture._DefaultOptions.useSvgFallback;\n        const autoUpdate = options.autoUpdate ?? HtmlTexture._DefaultOptions.autoUpdate;\n\n        this._width = options.width || element.offsetWidth || 256;\n        this._height = options.height || element.offsetHeight || 256;\n\n        this.name = name;\n        this.wrapU = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.wrapV = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.anisotropicFilteringLevel = 1;\n\n        this.host = this._createHost();\n\n        // The native WICG API has no content until the first paint snapshot is recorded, so the initial\n        // upload must happen from a paint event. The rendering canvas emits `paint`; listen for at least the\n        // first one and, when auto-update is disabled, detach after that first refresh. A non-canvas helper\n        // host never emits `paint`, so this listener is simply never invoked there.\n        if (this.host) {\n            this._paintHandler = (event: PaintEvent) => {\n                // A single `paint` event covers every changed child of the shared rendering canvas. When the\n                // browser reports which elements changed, skip the upload unless ours is among them, so that\n                // multiple HTML textures hosted on the same canvas don't all re-upload on every unrelated change.\n                if (event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {\n                    return;\n                }\n                this.update();\n                if (!autoUpdate && this._paintHandler && this.host) {\n                    this.host.removeEventListener(\"paint\", this._paintHandler as EventListener);\n                    this._paintHandler = null;\n                }\n            };\n            this.host.addEventListener(\"paint\", this._paintHandler as EventListener);\n        }\n\n        this._createInternalTexture();\n    }\n\n    private _createHost(): Nullable<HTMLElement> {\n        if (!IsWindowObjectExist() || typeof document === \"undefined\") {\n            return null;\n        }\n\n        // Remember where the caller had the element so dispose() can put it back: we are about to re-parent it\n        // into the host (the element must be a direct child of the host to be captured and laid out).\n        this._originalParent = this.element.parentNode;\n        this._originalNextSibling = this.element.nextSibling;\n\n        // Per the WICG spec, the source element must be a *direct child* of the same canvas whose WebGL/WebGPU\n        // context performs the upload, and that canvas must opt its subtree into layout via `layoutsubtree`.\n        // The engine already owns our texture through its rendering canvas, so the element has to live inside\n        // that canvas: it is the only one whose context can snapshot the element via texElementImage2D /\n        // copyElementImageToTexture. A separate canvas would lay the element out but could never be captured\n        // into the engine's texture (this is why nothing rendered on the native path before).\n        const renderingCanvas = this._getEngine()?.getRenderingCanvas() ?? null;\n        if (renderingCanvas) {\n            renderingCanvas.layoutSubtree = true;\n            // `layoutsubtree` opts children into hit testing; mark ours inert so it never steals pointer events\n            // from the canvas (e.g. camera controls). Synthetic event dispatch still reaches inert elements, so\n            // HtmlRaycastInteractionManager keeps working; HtmlInteractionManager clears it to enable native input.\n            this._addedInert = !this.element.hasAttribute(\"inert\");\n            this.element.setAttribute(\"inert\", \"\");\n            renderingCanvas.appendChild(this.element);\n            this._ownsHost = false;\n            return renderingCanvas;\n        }\n\n        // No rendering canvas (e.g. NullEngine / offscreen): the native upload paths cannot run, because they\n        // capture from the engine's canvas and there is none. Only the SVG fallback renders here, and it builds\n        // from the element's serialized markup rather than from a canvas - so a host *canvas* would buy nothing.\n        // Host the element in a hidden, off-screen <div> purely so it is laid out in the document (giving\n        // correct measured sizes); there is no canvas to capture into on this path.\n        const host = document.createElement(\"div\");\n        host.style.position = \"absolute\";\n        host.style.left = \"-99999px\";\n        host.style.top = \"0px\";\n        host.style.pointerEvents = \"none\";\n        host.setAttribute(\"aria-hidden\", \"true\");\n\n        host.appendChild(this.element);\n        document.body.appendChild(host);\n        this._ownsHost = true;\n\n        return host;\n    }\n\n    private _createInternalTexture(): void {\n        const engine = this._getEngine();\n        if (engine) {\n            // createDynamicTexture is an engine extension; register it lazily (idempotent) so this module stays free of top-level side effects.\n            RegisterEnginesExtensionsEngineDynamicTexture();\n            this._texture = engine.createDynamicTexture(this._width, this._height, this._generateMipMaps, this._samplingMode);\n            this._texture.format = this._format;\n        }\n\n        // Trigger the initial render. On the native path this requests a paint so the first upload happens\n        // once a snapshot exists (calling the WICG API before the first snapshot throws); otherwise the\n        // SVG fallback (or a direct update) renders immediately.\n        this.requestUpdate();\n    }\n\n    /**\n     * @returns the texture matrix used in most of the material.\n     */\n    public override getTextureMatrix(): Matrix {\n        return this._textureMatrix;\n    }\n\n    /**\n     * Requests the host canvas to emit a paint event on the next rendering update. When auto-update is\n     * enabled, this triggers a texture refresh in sync with the DOM. Falls back to an immediate update\n     * when the WICG API is not available.\n     */\n    public requestUpdate(): void {\n        // `requestPaint` only exists on a WICG-capable rendering canvas; the helper <div> host has no such\n        // method, so fall back to an immediate update there.\n        const canvasHost = this.host as Nullable<HTMLCanvasElement>;\n        if (canvasHost && typeof canvasHost.requestPaint === \"function\") {\n            canvasHost.requestPaint();\n        } else {\n            this.update();\n        }\n    }\n\n    /**\n     * Updates the content of the texture from the current state of the HTML element.\n     * @param invertY Defines whether the texture should be inverted on Y (true by default)\n     */\n    public update(invertY: boolean = true): void {\n        const engine = this._getEngine();\n        if (this._texture == null || engine == null) {\n            return;\n        }\n\n        // When the native WICG upload API is unavailable, render through the SVG <foreignObject> fallback\n        // (unless it was explicitly disabled, in which case the upload helper emits a one-time warning).\n        if (this._useSvgFallback && !IsHtmlInCanvasUploadSupported(engine)) {\n            this._updateFromSvgFallback(engine, invertY);\n            return;\n        }\n\n        const wasReady = this.isReady();\n\n        UploadHtmlElementToTexture(engine, this._texture, this.element, invertY);\n\n        if (!wasReady && this.isReady()) {\n            this.onLoadObservable.notifyObservers(this);\n        }\n    }\n\n    /**\n     * Renders the element through an SVG `<foreignObject>` snapshot and uploads it to the texture. This\n     * fallback works in any browser but only captures same-origin, inline-styled content as a static image.\n     * @param engine defines the engine that owns the texture\n     * @param invertY defines whether the texture should be inverted on Y\n     */\n    private _updateFromSvgFallback(engine: AbstractEngine, invertY: boolean): void {\n        if (typeof document === \"undefined\" || typeof Image === \"undefined\" || typeof XMLSerializer === \"undefined\") {\n            return;\n        }\n\n        const svgUrl = this._buildSvgDataUrl();\n        if (!svgUrl) {\n            return;\n        }\n\n        const image = new Image();\n        image.onload = () => {\n            if (this._texture == null) {\n                return;\n            }\n            const wasReady = this.isReady();\n            try {\n                engine.updateDynamicTexture(this._texture, image, invertY, false, this._format);\n            } catch {\n                _WarnSvgFallback();\n                return;\n            }\n            if (!wasReady && this.isReady()) {\n                this.onLoadObservable.notifyObservers(this);\n            }\n        };\n        image.onerror = () => {\n            _WarnSvgFallback();\n        };\n        image.src = svgUrl;\n    }\n\n    /**\n     * Serializes the element into an SVG `<foreignObject>` data URL sized to the texture.\n     * @returns a data URL, or null if serialization failed\n     */\n    private _buildSvgDataUrl(): Nullable<string> {\n        try {\n            const clone = this.element.cloneNode(true) as HTMLElement;\n            clone.setAttribute(\"xmlns\", \"http://www.w3.org/1999/xhtml\");\n            const serialized = new XMLSerializer().serializeToString(clone);\n            const svg =\n                `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${this._width}\" height=\"${this._height}\">` +\n                `<foreignObject x=\"0\" y=\"0\" width=\"100%\" height=\"100%\">${serialized}</foreignObject>` +\n                `</svg>`;\n            return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Gets the current class name of the texture useful for serialization or dynamic coding.\n     * @returns \"HtmlTexture\"\n     */\n    public override getClassName(): string {\n        return \"HtmlTexture\";\n    }\n\n    /**\n     * Dispose the texture and release its associated resources.\n     */\n    public override dispose(): void {\n        if (this.host) {\n            if (this._paintHandler) {\n                this.host.removeEventListener(\"paint\", this._paintHandler as EventListener);\n                this._paintHandler = null;\n            }\n            // Remove the `inert` attribute we added so the caller gets the element back as they passed it.\n            if (this._addedInert) {\n                this.element.removeAttribute(\"inert\");\n                this._addedInert = false;\n            }\n            // Restore the element to where the caller had it before we re-parented it into the host, rather\n            // than silently deleting their node from the document.\n            if (this._originalParent) {\n                const reference = this._originalNextSibling && this._originalNextSibling.parentNode === this._originalParent ? this._originalNextSibling : null;\n                this._originalParent.insertBefore(this.element, reference);\n            } else {\n                this.element.remove();\n            }\n            // Remove the helper host we created (never the engine's borrowed rendering canvas).\n            if (this._ownsHost) {\n                this.host.remove();\n            }\n        }\n\n        this.onLoadObservable.clear();\n        super.dispose();\n    }\n}\n"]}

package/Materials/Textures/HTML/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./htmlTexture.js";
+export * from "./htmlInteractionManager.js";
+export * from "./htmlRaycastInteractionManager.js";
+export * from "./htmlInCanvasPolyfill.js";

package/Materials/Textures/HTML/index.js

@@ -0,0 +1,5 @@
+export * from "./htmlTexture.js";
+export * from "./htmlInteractionManager.js";
+export * from "./htmlRaycastInteractionManager.js";
+export * from "./htmlInCanvasPolyfill.js";
+//# sourceMappingURL=index.js.map

package/Materials/Textures/HTML/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/HTML/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC","sourcesContent":["export * from \"./htmlTexture\";\nexport * from \"./htmlInteractionManager\";\nexport * from \"./htmlRaycastInteractionManager\";\nexport * from \"./htmlInCanvasPolyfill\";\n"]}

package/Materials/Textures/HTML/pure.d.ts

@@ -0,0 +1,5 @@
+/** Pure barrel — re-exports only side-effect-free modules */
+export * from "./htmlTexture.js";
+export * from "./htmlInteractionManager.js";
+export * from "./htmlRaycastInteractionManager.js";
+export * from "./htmlInCanvasPolyfill.js";

package/Materials/Textures/HTML/pure.js

@@ -0,0 +1,6 @@
+/** Pure barrel — re-exports only side-effect-free modules */
+export * from "./htmlTexture.js";
+export * from "./htmlInteractionManager.js";
+export * from "./htmlRaycastInteractionManager.js";
+export * from "./htmlInCanvasPolyfill.js";
+//# sourceMappingURL=pure.js.map

package/Materials/Textures/HTML/pure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/HTML/pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC","sourcesContent":["/** Pure barrel — re-exports only side-effect-free modules */\nexport * from \"./htmlTexture\";\nexport * from \"./htmlInteractionManager\";\nexport * from \"./htmlRaycastInteractionManager\";\nexport * from \"./htmlInCanvasPolyfill\";\n"]}

package/Materials/Textures/index.d.ts

@@ -10,6 +10,7 @@ export * from "./envCubeTexture.js";
 export * from "./hdrCubeTexture.js";
 export * from "./exrCubeTexture.js";
 export * from "./htmlElementTexture.js";
+export * from "./HTML/index.js";
 export * from "./internalTexture.js";
 export * from "./Loaders/index.js";
 export * from "./mirrorTexture.js";

package/Materials/Textures/index.js

@@ -1,6 +1,5 @@
 /* eslint-disable @typescript-eslint/no-restricted-imports */
 export * from "./baseTexture.js";
-// eslint-disable-next-line import/export
 export * from "./baseTexture.polynomial.js";
 export * from "./colorGradingTexture.js";
 export * from "./cubeTexture.js";
@@ -12,6 +11,7 @@ export * from "./envCubeTexture.js";
 export * from "./hdrCubeTexture.js";
 export * from "./exrCubeTexture.js";
 export * from "./htmlElementTexture.js";
+export * from "./HTML/index.js";
 export * from "./internalTexture.js";
 export * from "./Loaders/index.js";
 export * from "./mirrorTexture.js";

package/Materials/Textures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAC9B,yCAAyC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AAEzC,kCAAkC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAEhD,gBAAgB;AAChB,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iDAAiD,CAAC;AAChE,cAAc,mDAAmD,CAAC;AAElE,8DAA8D;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,wDAAwD,CAAC;AACvE,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oDAAoD,CAAC;AAEnE,oEAAoE;AACpE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AACpE,cAAc,yDAAyD,CAAC;AACxE,cAAc,oDAAoD,CAAC;AACnE,cAAc,iDAAiD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./baseTexture\";\r\n// eslint-disable-next-line import/export\r\nexport * from \"./baseTexture.polynomial\";\r\nexport * from \"./colorGradingTexture\";\r\nexport * from \"./cubeTexture\";\r\nexport * from \"./dynamicTexture\";\r\nexport * from \"./equiRectangularCubeTexture\";\r\nexport * from \"./externalTexture\";\r\nexport * from \"./Filtering/hdrFiltering\";\r\nexport * from \"./envCubeTexture\";\r\nexport * from \"./hdrCubeTexture\";\r\nexport * from \"./exrCubeTexture\";\r\nexport * from \"./htmlElementTexture\";\r\nexport * from \"./internalTexture\";\r\nexport * from \"./Loaders/index\";\r\nexport * from \"./mirrorTexture\";\r\nexport * from \"./multiRenderTarget\";\r\nexport * from \"./Packer/index\";\r\nexport * from \"./Procedurals/index\";\r\nexport * from \"./rawCubeTexture\";\r\nexport * from \"./rawTexture\";\r\nexport * from \"./rawTexture2DArray\";\r\nexport * from \"./rawTexture3D\";\r\nexport * from \"./refractionTexture\";\r\nexport * from \"./renderTargetTexture\";\r\nexport * from \"./textureMerger\";\r\nexport * from \"./textureSampler\";\r\nexport * from \"./textureProcessor\";\r\nexport * from \"./texture\";\r\nexport * from \"./thinTexture\";\r\nexport * from \"./thinRenderTargetTexture\";\r\nexport * from \"./videoTexture\";\r\nexport * from \"./ktx2decoderTypes\";\r\nexport * from \"./textureCreationOptions\";\r\n\r\n// Shaders for procedural textures\r\nexport * from \"../../ShadersWGSL/procedural.vertex\";\r\nexport * from \"../../Shaders/procedural.vertex\";\r\n\r\n// HDR filtering\r\nexport * from \"../../Shaders/hdrFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.fragment\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.fragment\";\r\n\r\n// HDR filtering shader includes (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/importanceSampling\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/hdrFilteringFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/importanceSampling\";\r\nexport * from \"../../Shaders/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/hdrFilteringFunctions\";\r\n\r\n// Intersection & LTC helper functions (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/ltcHelperFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/ltcHelperFunctions\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../dev/core/src/Materials/Textures/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,eAAe,CAAC;AAE9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AAEzC,kCAAkC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAEhD,gBAAgB;AAChB,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,iDAAiD,CAAC;AAChE,cAAc,mDAAmD,CAAC;AAElE,8DAA8D;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,wDAAwD,CAAC;AACvE,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,oDAAoD,CAAC;AAEnE,oEAAoE;AACpE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AACpE,cAAc,yDAAyD,CAAC;AACxE,cAAc,oDAAoD,CAAC;AACnE,cAAc,iDAAiD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./baseTexture\";\r\n\r\nexport * from \"./baseTexture.polynomial\";\r\nexport * from \"./colorGradingTexture\";\r\nexport * from \"./cubeTexture\";\r\nexport * from \"./dynamicTexture\";\r\nexport * from \"./equiRectangularCubeTexture\";\r\nexport * from \"./externalTexture\";\r\nexport * from \"./Filtering/hdrFiltering\";\r\nexport * from \"./envCubeTexture\";\r\nexport * from \"./hdrCubeTexture\";\r\nexport * from \"./exrCubeTexture\";\r\nexport * from \"./htmlElementTexture\";\r\nexport * from \"./HTML/index\";\r\nexport * from \"./internalTexture\";\r\nexport * from \"./Loaders/index\";\r\nexport * from \"./mirrorTexture\";\r\nexport * from \"./multiRenderTarget\";\r\nexport * from \"./Packer/index\";\r\nexport * from \"./Procedurals/index\";\r\nexport * from \"./rawCubeTexture\";\r\nexport * from \"./rawTexture\";\r\nexport * from \"./rawTexture2DArray\";\r\nexport * from \"./rawTexture3D\";\r\nexport * from \"./refractionTexture\";\r\nexport * from \"./renderTargetTexture\";\r\nexport * from \"./textureMerger\";\r\nexport * from \"./textureSampler\";\r\nexport * from \"./textureProcessor\";\r\nexport * from \"./texture\";\r\nexport * from \"./thinTexture\";\r\nexport * from \"./thinRenderTargetTexture\";\r\nexport * from \"./videoTexture\";\r\nexport * from \"./ktx2decoderTypes\";\r\nexport * from \"./textureCreationOptions\";\r\n\r\n// Shaders for procedural textures\r\nexport * from \"../../ShadersWGSL/procedural.vertex\";\r\nexport * from \"../../Shaders/procedural.vertex\";\r\n\r\n// HDR filtering\r\nexport * from \"../../Shaders/hdrFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrFiltering.fragment\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../Shaders/hdrIrradianceFiltering.fragment\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.vertex\";\r\nexport * from \"../../ShadersWGSL/hdrIrradianceFiltering.fragment\";\r\n\r\n// HDR filtering shader includes (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/importanceSampling\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/hdrFilteringFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/importanceSampling\";\r\nexport * from \"../../Shaders/ShadersInclude/pbrBRDFFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/hdrFilteringFunctions\";\r\n\r\n// Intersection & LTC helper functions (needed by external packages)\r\nexport * from \"../../ShadersWGSL/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../ShadersWGSL/ShadersInclude/ltcHelperFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/clusteredLightingFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/intersectionFunctions\";\r\nexport * from \"../../Shaders/ShadersInclude/ltcHelperFunctions\";\r\n"]}