@react-x11/components 0.1.0 → 0.2.0

package/dist/three/objects.d.ts

@@ -0,0 +1,185 @@
+import { Color, Euler, Vector3 } from './math.js';
+import type { Mat4 } from './math.js';
+import type { BufferGeometry } from './geometries.js';
+import type { Material } from './materials.js';
+/** The pointer handlers an object may carry — the r3f names. */
+export interface PointerHandlers {
+    onClick?: (event: unknown) => void;
+    onPointerDown?: (event: unknown) => void;
+    onPointerUp?: (event: unknown) => void;
+    onPointerMove?: (event: unknown) => void;
+    onPointerOver?: (event: unknown) => void;
+    onPointerOut?: (event: unknown) => void;
+}
+export declare const POINTER_PROPS: readonly ['onClick', 'onPointerDown', 'onPointerUp', 'onPointerMove', 'onPointerOver', 'onPointerOut'];
+/** Base for anything that can sit in the scene tree. */
+export declare class Object3D {
+    readonly id: number;
+    readonly isObject3D: boolean;
+    name: string;
+    userData: Record<string, unknown>;
+    parent: Object3D | null;
+    children: Object3D[];
+    readonly position: Vector3;
+    readonly rotation: Euler;
+    readonly scale: Vector3;
+    visible: boolean;
+    /** The cursor to show while this object is hovered (needs a handler). */
+    cursor: string | null;
+    /** @internal pointer handlers, written by the reconciler's applyProps */
+    __handlers: PointerHandlers | null;
+    /** @internal the world matrix of the frame that is on screen — picking
+     * rays are transformed by exactly what was drawn */
+    __world: Mat4 | null;
+    /** @internal notified on any change so a demand-mode surface redraws */
+    __dirty: (() => void) | null;
+    /** @internal */
+    _local: Mat4;
+    /** @internal */
+    _localDirty: boolean;
+    constructor();
+    add(...objects: Object3D[]): this;
+    remove(...objects: Object3D[]): this;
+    clear(): this;
+    /** @internal the whole subtree reports into the surface's dirty hook */
+    propagateDirty(dirty: (() => void) | null): void;
+    traverse(callback: (object: Object3D) => void): void;
+    getObjectByName(name: string): Object3D | undefined;
+    /** Local transform, recomposed only after a position/rotation/scale write. */
+    localMatrix(): Mat4;
+}
+export declare class Group extends Object3D {
+    readonly isGroup = true;
+}
+/**
+ * The scene root a `<Canvas>` owns. `background` is what
+ * `<color attach="background" args={['#101418']} />` writes, exactly as it
+ * does in r3f — the surface clears to it before drawing.
+ */
+export declare class Scene extends Object3D {
+    readonly isScene = true;
+    background: Color | null;
+}
+export type Primitive = 'triangles' | 'points' | 'lines' | 'lineStrip' | 'lineLoop';
+/** One `<instancedMesh instances={[…]}>` entry. */
+export interface InstanceSpec {
+    position?: readonly number[];
+    rotation?: readonly number[];
+    scale?: readonly number[] | number;
+    /** Overrides the material's colour for this instance only. */
+    color?: string | number | readonly number[];
+}
+/**
+ * Anything that draws a geometry with a material. `<points>`, `<line>` and
+ * friends differ only in the primitive their vertices are assembled into —
+ * the geometry, the material and the transform work identically for all of
+ * them, which is why they share this class.
+ */
+export declare class Mesh extends Object3D {
+    readonly isMesh: boolean;
+    geometry: BufferGeometry | null;
+    material: Material | null;
+    get primitive(): Primitive;
+    constructor(geometry?: BufferGeometry, material?: Material);
+}
+/** `<points>` — one vertex, one dot. Size comes from `<pointsMaterial>`. */
+export declare class Points extends Mesh {
+    readonly isPoints = true;
+    get primitive(): Primitive;
+}
+/** `<line>` — a connected strip, as three.js reads a vertex list. */
+export declare class Line extends Mesh {
+    readonly isLine: boolean;
+    get primitive(): Primitive;
+}
+/** `<lineSegments>` — disjoint vertex pairs. */
+export declare class LineSegments extends Line {
+    get primitive(): Primitive;
+}
+/** `<lineLoop>` — a closed strip. */
+export declare class LineLoop extends Line {
+    get primitive(): Primitive;
+}
+/**
+ * `<instancedMesh instances={[{ position, rotation, scale, color }, …]}>` —
+ * one geometry drawn many times.
+ *
+ * The `instances` array is declarative rather than three.js's imperative
+ * `setMatrixAt`, kept from the core design: what it saves is the geometry,
+ * which is uploaded (or compiled into a display list) once. Each instance
+ * still costs a transform and a draw — neither backend does GPU instancing,
+ * because ES 2 guarantees none and the GLX protocol encodes none.
+ */
+export declare class InstancedMesh extends Mesh {
+    readonly isInstancedMesh = true;
+    instances: InstanceSpec[];
+}
+export declare class Light extends Object3D {
+    readonly isLight: boolean;
+    intensity: number;
+    readonly color: Color;
+    constructor();
+}
+/** Costs no light unit: its colour joins the ambient term. */
+export declare class AmbientLight extends Light {
+    readonly isAmbientLight = true;
+}
+/** `position` is the direction the light comes from; no attenuation. */
+export declare class DirectionalLight extends Light {
+    readonly isDirectionalLight = true;
+}
+export declare class PointLight extends Light {
+    readonly isPointLight = true;
+    distance: number;
+    decay: number;
+}
+export declare class SpotLight extends PointLight {
+    readonly isSpotLight = true;
+    /** Radians; three.js's default. */
+    angle: number;
+    penumbra: number;
+    /**
+     * Where the cone points, as a point in world space. three.js's spot light
+     * aims at a `target` Object3D that has to be added to the scene; a Vector3
+     * carries the same information without the extra mount, and
+     * `target={[x, y, z]}` sets it.
+     */
+    readonly target: Vector3;
+    constructor();
+}
+/**
+ * The camera model both backends share: a position looking at a target.
+ *
+ * three.js cameras carry a free orientation (a quaternion); this one derives
+ * its view from `position`, `target` and `up`, which is what the fixed
+ * subset can express and what nearly all ported code does anyway —
+ * `camera.position.set(…); camera.lookAt(0, 0, 0)`. Writing to `rotation`
+ * on a camera does nothing, and that edge is documented rather than half
+ * supported.
+ */
+export declare class Camera extends Object3D {
+    readonly isCamera: boolean;
+    readonly up: Vector3;
+    readonly target: Vector3;
+    near: number;
+    far: number;
+    zoom: number;
+    constructor();
+    lookAt(x: number | Vector3 | readonly [number, number, number], y?: number, z?: number): void;
+    /** View matrix for the frame being drawn. */
+    viewMatrix(out?: Mat4): Mat4;
+    projectionMatrix(width: number, height: number, out?: Mat4): Mat4;
+}
+export declare class PerspectiveCamera extends Camera {
+    readonly isPerspectiveCamera = true;
+    /** Vertical field of view, degrees — three.js's convention. */
+    fov: number;
+    constructor(fov?: number, near?: number, far?: number);
+    projectionMatrix(width: number, height: number, out?: Mat4): Mat4;
+}
+export declare class OrthographicCamera extends Camera {
+    readonly isOrthographicCamera = true;
+    constructor(near?: number, far?: number);
+    projectionMatrix(width: number, height: number, out?: Mat4): Mat4;
+}
+//# sourceMappingURL=objects.d.ts.map

package/dist/three/objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../src/three/objects.ts"],"names":[],"mappings":"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"}

package/dist/three/objects.js

@@ -0,0 +1,309 @@
+// The retained scene graph: what `<mesh>`, `<group>` and the lights become.
+//
+// This is the half of the react-three-fiber model react-x11's core renderer
+// deliberately did not have. There, the scene was described by props and a
+// `useFrame` callback that wanted to move something called a state setter.
+// Here the objects are **mutable** and refs hand them out, so
+// `ref.current.rotation.y += delta` — the way every three-fiber component is
+// written — works unchanged: the write lands in a dirty flag, the next frame
+// composes the matrix again, and React hears nothing.
+//
+// What these classes are *not* is three.js. They carry the fields the two
+// react-x11 backends can actually draw — position/euler/scale transforms, no
+// quaternions, no layers, no shadow state — and nothing else, so anything
+// that works here works identically over indirect GLX and over DRI3.
+import { Color, Euler, Vector3, compose, identity, lookAtMatrix, orthographic, perspective, } from './math.js';
+export const POINTER_PROPS = [
+    'onClick',
+    'onPointerDown',
+    'onPointerUp',
+    'onPointerMove',
+    'onPointerOver',
+    'onPointerOut',
+];
+let nextId = 1;
+/** Base for anything that can sit in the scene tree. */
+export class Object3D {
+    id = nextId++;
+    isObject3D = true;
+    name = '';
+    userData = {};
+    parent = null;
+    children = [];
+    position = new Vector3(0, 0, 0);
+    rotation = new Euler(0, 0, 0);
+    scale = new Vector3(1, 1, 1);
+    visible = true;
+    /** The cursor to show while this object is hovered (needs a handler). */
+    cursor = null;
+    /** @internal pointer handlers, written by the reconciler's applyProps */
+    __handlers = null;
+    /** @internal the world matrix of the frame that is on screen — picking
+     * rays are transformed by exactly what was drawn */
+    __world = null;
+    /** @internal notified on any change so a demand-mode surface redraws */
+    __dirty = null;
+    // Underscore-public rather than `private` on purpose: a private member
+    // makes the class nominal, and the JSX augmentation in jsx.ts then exists
+    // twice (src and dist) as non-identical declarations in this repo's own
+    // typecheck program. Structural classes merge; nominal ones are TS2717.
+    /** @internal */
+    _local = identity();
+    /** @internal */
+    _localDirty = true;
+    constructor() {
+        const mark = () => {
+            this._localDirty = true;
+            this.__dirty?.();
+        };
+        this.position._onChange = mark;
+        this.rotation._onChange = mark;
+        this.scale._onChange = mark;
+    }
+    add(...objects) {
+        for (const object of objects) {
+            object.parent?.remove(object);
+            object.parent = this;
+            this.children.push(object);
+            object.propagateDirty(this.__dirty);
+        }
+        this.__dirty?.();
+        return this;
+    }
+    remove(...objects) {
+        for (const object of objects) {
+            const index = this.children.indexOf(object);
+            if (index === -1)
+                continue;
+            this.children.splice(index, 1);
+            object.parent = null;
+            object.propagateDirty(null);
+        }
+        this.__dirty?.();
+        return this;
+    }
+    clear() {
+        return this.remove(...this.children);
+    }
+    /** @internal the whole subtree reports into the surface's dirty hook */
+    propagateDirty(dirty) {
+        this.__dirty = dirty;
+        for (const child of this.children)
+            child.propagateDirty(dirty);
+    }
+    traverse(callback) {
+        callback(this);
+        for (const child of this.children)
+            child.traverse(callback);
+    }
+    getObjectByName(name) {
+        if (this.name === name)
+            return this;
+        for (const child of this.children) {
+            const found = child.getObjectByName(name);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    /** Local transform, recomposed only after a position/rotation/scale write. */
+    localMatrix() {
+        if (this._localDirty) {
+            compose(this.position.toArray(), this.rotation.toArray(), this.scale.toArray(), this._local);
+            this._localDirty = false;
+        }
+        return this._local;
+    }
+}
+export class Group extends Object3D {
+    isGroup = true;
+}
+/**
+ * The scene root a `<Canvas>` owns. `background` is what
+ * `<color attach="background" args={['#101418']} />` writes, exactly as it
+ * does in r3f — the surface clears to it before drawing.
+ */
+export class Scene extends Object3D {
+    isScene = true;
+    background = null;
+}
+/**
+ * Anything that draws a geometry with a material. `<points>`, `<line>` and
+ * friends differ only in the primitive their vertices are assembled into —
+ * the geometry, the material and the transform work identically for all of
+ * them, which is why they share this class.
+ */
+export class Mesh extends Object3D {
+    isMesh = true;
+    geometry = null;
+    material = null;
+    get primitive() {
+        return 'triangles';
+    }
+    constructor(geometry, material) {
+        super();
+        if (geometry)
+            this.geometry = geometry;
+        if (material)
+            this.material = material;
+    }
+}
+/** `<points>` — one vertex, one dot. Size comes from `<pointsMaterial>`. */
+export class Points extends Mesh {
+    isPoints = true;
+    get primitive() {
+        return 'points';
+    }
+}
+/** `<line>` — a connected strip, as three.js reads a vertex list. */
+export class Line extends Mesh {
+    isLine = true;
+    get primitive() {
+        return 'lineStrip';
+    }
+}
+/** `<lineSegments>` — disjoint vertex pairs. */
+export class LineSegments extends Line {
+    get primitive() {
+        return 'lines';
+    }
+}
+/** `<lineLoop>` — a closed strip. */
+export class LineLoop extends Line {
+    get primitive() {
+        return 'lineLoop';
+    }
+}
+/**
+ * `<instancedMesh instances={[{ position, rotation, scale, color }, …]}>` —
+ * one geometry drawn many times.
+ *
+ * The `instances` array is declarative rather than three.js's imperative
+ * `setMatrixAt`, kept from the core design: what it saves is the geometry,
+ * which is uploaded (or compiled into a display list) once. Each instance
+ * still costs a transform and a draw — neither backend does GPU instancing,
+ * because ES 2 guarantees none and the GLX protocol encodes none.
+ */
+export class InstancedMesh extends Mesh {
+    isInstancedMesh = true;
+    instances = [];
+}
+// ---------------------------------------------------------------------------
+// lights
+export class Light extends Object3D {
+    isLight = true;
+    intensity = 1;
+    color = new Color([1, 1, 1]);
+    constructor() {
+        super();
+        this.color._onChange = () => this.__dirty?.();
+    }
+}
+/** Costs no light unit: its colour joins the ambient term. */
+export class AmbientLight extends Light {
+    isAmbientLight = true;
+}
+/** `position` is the direction the light comes from; no attenuation. */
+export class DirectionalLight extends Light {
+    isDirectionalLight = true;
+}
+export class PointLight extends Light {
+    isPointLight = true;
+    distance = 0;
+    decay = 0;
+}
+export class SpotLight extends PointLight {
+    isSpotLight = true;
+    /** Radians; three.js's default. */
+    angle = Math.PI / 6;
+    penumbra = 0;
+    /**
+     * Where the cone points, as a point in world space. three.js's spot light
+     * aims at a `target` Object3D that has to be added to the scene; a Vector3
+     * carries the same information without the extra mount, and
+     * `target={[x, y, z]}` sets it.
+     */
+    target = new Vector3(0, 0, 0);
+    constructor() {
+        super();
+        this.target._onChange = () => this.__dirty?.();
+    }
+}
+// ---------------------------------------------------------------------------
+// cameras
+/**
+ * The camera model both backends share: a position looking at a target.
+ *
+ * three.js cameras carry a free orientation (a quaternion); this one derives
+ * its view from `position`, `target` and `up`, which is what the fixed
+ * subset can express and what nearly all ported code does anyway —
+ * `camera.position.set(…); camera.lookAt(0, 0, 0)`. Writing to `rotation`
+ * on a camera does nothing, and that edge is documented rather than half
+ * supported.
+ */
+export class Camera extends Object3D {
+    isCamera = true;
+    up = new Vector3(0, 1, 0);
+    target = new Vector3(0, 0, 0);
+    near = 0.1;
+    far = 1000;
+    zoom = 1;
+    constructor() {
+        super();
+        const mark = () => this.__dirty?.();
+        this.up._onChange = mark;
+        this.target._onChange = mark;
+    }
+    lookAt(x, y, z) {
+        if (typeof x === 'number')
+            this.target.set(x, y ?? 0, z ?? 0);
+        else if (x instanceof Vector3)
+            this.target.copy(x);
+        else
+            this.target.set(x[0], x[1], x[2]);
+    }
+    /** View matrix for the frame being drawn. */
+    viewMatrix(out) {
+        return lookAtMatrix(this.position.toArray(), this.target.toArray(), this.up.toArray(), out);
+    }
+    projectionMatrix(width, height, out) {
+        void width;
+        void height;
+        return identity(out);
+    }
+}
+export class PerspectiveCamera extends Camera {
+    isPerspectiveCamera = true;
+    /** Vertical field of view, degrees — three.js's convention. */
+    fov = 50;
+    constructor(fov, near, far) {
+        super();
+        if (fov !== undefined)
+            this.fov = fov;
+        if (near !== undefined)
+            this.near = near;
+        if (far !== undefined)
+            this.far = far;
+        this.position.set(0, 0, 5);
+    }
+    projectionMatrix(width, height, out) {
+        const aspect = width / Math.max(1, height);
+        return perspective(this.fov / this.zoom, aspect, this.near, this.far, out);
+    }
+}
+export class OrthographicCamera extends Camera {
+    isOrthographicCamera = true;
+    constructor(near, far) {
+        super();
+        if (near !== undefined)
+            this.near = near;
+        if (far !== undefined)
+            this.far = far;
+        this.position.set(0, 0, 5);
+    }
+    projectionMatrix(width, height, out) {
+        const aspect = width / Math.max(1, height);
+        return orthographic(-aspect / this.zoom, aspect / this.zoom, -1 / this.zoom, 1 / this.zoom, this.near, this.far, out);
+    }
+}
+//# sourceMappingURL=objects.js.map

package/dist/three/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../src/three/objects.ts"],"names":[],"mappings":"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"}

package/dist/three/passes.d.ts

@@ -0,0 +1,54 @@
+import { Object3D } from './objects.js';
+import type { Uniforms } from './materials.js';
+export declare class EffectComposer extends Object3D {
+    readonly isObject3D = false;
+    readonly isComposer = true;
+    enabled: boolean;
+    get passes(): Pass[];
+}
+/** One full-screen pass. */
+export declare class Pass extends Object3D {
+    readonly isObject3D = false;
+    readonly isPass: boolean;
+    readonly kind: string;
+    enabled: boolean;
+}
+/**
+ * Your own full-screen GLSL. Declare `uniform sampler2D tDiffuse` for the
+ * incoming image and `varying vec2 vUv` yourself, exactly as a three.js
+ * `ShaderPass` shader does. `resolution` (pixels), `texelSize` (1/pixels)
+ * and `time` (seconds) are set if you declare them, dropped if you do not.
+ */
+export declare class ShaderPass extends Pass {
+    readonly kind = "shaderPass";
+    fragmentShader: string;
+    /** Replaces the built-in full-screen quad shader; must write `vUv`. */
+    vertexShader: string;
+    private _uniforms;
+    get uniforms(): Uniforms;
+    set uniforms(value: Record<string, unknown>);
+}
+/** Bright areas bleed into their surroundings: threshold, separable blur at
+ * half resolution, composite — four draws. */
+export declare class BloomPass extends Pass {
+    readonly kind = "bloomPass";
+    /** Luminance above which a pixel blooms. */
+    threshold: number;
+    /** How much of the blurred result is added back. */
+    strength: number;
+    /** Blur width, in half-resolution texels. */
+    radius: number;
+}
+/** Darkens towards the corners. */
+export declare class VignettePass extends Pass {
+    readonly kind = "vignettePass";
+    /** Where the darkening starts: 0 at the centre, 1 in the corners. */
+    offset: number;
+    darkness: number;
+}
+/** Antialiasing in one full-screen pass — the only kind a composed scene
+ * can get, since an MSAA attachment is an ES 3 feature. */
+export declare class FxaaPass extends Pass {
+    readonly kind = "fxaaPass";
+}
+//# sourceMappingURL=passes.d.ts.map

package/dist/three/passes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passes.d.ts","sourceRoot":"","sources":["../../src/three/passes.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAkB,UAAU,SAAS;IACrC,QAAQ,CAAC,UAAU,QAAQ;IAC3B,OAAO,UAAQ;IAEf,IAAI,MAAM,IAAI,IAAI,EAAE,CAInB;CACF;AAED,4BAA4B;AAC5B,qBAAa,IAAK,SAAQ,QAAQ;IAChC,SAAkB,UAAU,SAAS;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAQ;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAgB;IACrC,OAAO,UAAQ;CAChB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAClC,SAAkB,IAAI,gBAAgB;IACtC,cAAc,SAAM;IACpB,uEAAuE;IACvE,YAAY,SAAM;IAElB,OAAO,CAAC,SAAS,CAAgB;IAEjC,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAU1C;CACF;AAED;8CAC8C;AAC9C,qBAAa,SAAU,SAAQ,IAAI;IACjC,SAAkB,IAAI,eAAe;IACrC,4CAA4C;IAC5C,SAAS,SAAQ;IACjB,oDAAoD;IACpD,QAAQ,SAAO;IACf,6CAA6C;IAC7C,MAAM,SAAK;CACZ;AAED,mCAAmC;AACnC,qBAAa,YAAa,SAAQ,IAAI;IACpC,SAAkB,IAAI,kBAAkB;IACxC,qEAAqE;IACrE,MAAM,SAAO;IACb,QAAQ,SAAO;CAChB;AAED;2DAC2D;AAC3D,qBAAa,QAAS,SAAQ,IAAI;IAChC,SAAkB,IAAI,cAAc;CACrC"}

package/dist/three/passes.js

@@ -0,0 +1,78 @@
+// `<effectComposer>` and the passes inside it, as scene-graph objects.
+//
+// Not objects *in* the scene: a composer has no transform and nothing to
+// draw, so the render walk steps over it the way it steps over a material.
+// What it holds is an ordered list of passes, and the order is the tree's.
+//
+// There is no `<renderPass>` as in three.js's composer. The surface's own
+// scene is always the input — a composer that did not compose *this* scene
+// would have nothing to be — so the first pass reads it and the last one
+// writes the window. Direct backend only: the GLX protocol encodes no
+// framebuffer objects to render into (see `DIRECT_ONLY_KINDS`).
+import { Object3D } from './objects.js';
+export class EffectComposer extends Object3D {
+    isObject3D = false;
+    isComposer = true;
+    enabled = true;
+    get passes() {
+        return this.children.filter((child) => Boolean(child.isPass));
+    }
+}
+/** One full-screen pass. */
+export class Pass extends Object3D {
+    isObject3D = false;
+    isPass = true;
+    kind = 'shaderPass';
+    enabled = true;
+}
+/**
+ * Your own full-screen GLSL. Declare `uniform sampler2D tDiffuse` for the
+ * incoming image and `varying vec2 vUv` yourself, exactly as a three.js
+ * `ShaderPass` shader does. `resolution` (pixels), `texelSize` (1/pixels)
+ * and `time` (seconds) are set if you declare them, dropped if you do not.
+ */
+export class ShaderPass extends Pass {
+    kind = 'shaderPass';
+    fragmentShader = '';
+    /** Replaces the built-in full-screen quad shader; must write `vUv`. */
+    vertexShader = '';
+    _uniforms = {};
+    get uniforms() {
+        return this._uniforms;
+    }
+    set uniforms(value) {
+        const wrapped = {};
+        for (const [name, entry] of Object.entries(value ?? {})) {
+            wrapped[name] =
+                entry && typeof entry === 'object' && 'value' in entry
+                    ? entry
+                    : { value: entry };
+        }
+        this._uniforms = wrapped;
+        this.__dirty?.();
+    }
+}
+/** Bright areas bleed into their surroundings: threshold, separable blur at
+ * half resolution, composite — four draws. */
+export class BloomPass extends Pass {
+    kind = 'bloomPass';
+    /** Luminance above which a pixel blooms. */
+    threshold = 0.75;
+    /** How much of the blurred result is added back. */
+    strength = 0.8;
+    /** Blur width, in half-resolution texels. */
+    radius = 1;
+}
+/** Darkens towards the corners. */
+export class VignettePass extends Pass {
+    kind = 'vignettePass';
+    /** Where the darkening starts: 0 at the centre, 1 in the corners. */
+    offset = 0.5;
+    darkness = 0.5;
+}
+/** Antialiasing in one full-screen pass — the only kind a composed scene
+ * can get, since an MSAA attachment is an ES 3 feature. */
+export class FxaaPass extends Pass {
+    kind = 'fxaaPass';
+}
+//# sourceMappingURL=passes.js.map

package/dist/three/passes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passes.js","sourceRoot":"","sources":["../../src/three/passes.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,sEAAsE;AACtE,gEAAgE;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACxB,UAAU,GAAG,KAAK,CAAC;IAC5B,UAAU,GAAG,IAAI,CAAC;IAC3B,OAAO,GAAG,IAAI,CAAC;IAEf,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAiB,EAAE,CACnD,OAAO,CAAE,KAAc,CAAC,MAAM,CAAC,CAChC,CAAC;IACJ,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,OAAO,IAAK,SAAQ,QAAQ;IACd,UAAU,GAAG,KAAK,CAAC;IAC5B,MAAM,GAAY,IAAI,CAAC;IACvB,IAAI,GAAW,YAAY,CAAC;IACrC,OAAO,GAAG,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI;IAChB,IAAI,GAAG,YAAY,CAAC;IACtC,cAAc,GAAG,EAAE,CAAC;IACpB,uEAAuE;IACvE,YAAY,GAAG,EAAE,CAAC;IAEV,SAAS,GAAa,EAAE,CAAC;IAEjC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,KAA8B;QACzC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK;oBACpD,CAAC,CAAE,KAA4B;oBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnB,CAAC;CACF;AAED;8CAC8C;AAC9C,MAAM,OAAO,SAAU,SAAQ,IAAI;IACf,IAAI,GAAG,WAAW,CAAC;IACrC,4CAA4C;IAC5C,SAAS,GAAG,IAAI,CAAC;IACjB,oDAAoD;IACpD,QAAQ,GAAG,GAAG,CAAC;IACf,6CAA6C;IAC7C,MAAM,GAAG,CAAC,CAAC;CACZ;AAED,mCAAmC;AACnC,MAAM,OAAO,YAAa,SAAQ,IAAI;IAClB,IAAI,GAAG,cAAc,CAAC;IACxC,qEAAqE;IACrE,MAAM,GAAG,GAAG,CAAC;IACb,QAAQ,GAAG,GAAG,CAAC;CAChB;AAED;2DAC2D;AAC3D,MAAM,OAAO,QAAS,SAAQ,IAAI;IACd,IAAI,GAAG,UAAU,CAAC;CACrC"}