nucleation 0.10.22 → 0.10.23

package/renderer/Brush.mjs

@@ -0,0 +1,335 @@
+// generated by diplomat-tool
+import { Field3 } from "./Field3.mjs"
+import { InterpolationSpace } from "./InterpolationSpace.mjs"
+import { NucleationError } from "./NucleationError.mjs"
+import { Palette } from "./Palette.mjs"
+import { Sdf } from "./Sdf.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Brush_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Brush_destroy(ptr);
+});
+
+/**
+ * Decides which block goes at each point of a filled shape. Wraps `BrushEnum`.
+ */
+export class Brush {
+    // Internal ptr reference:
+    #ptr = null;
+
+    // Lifetimes are only to keep dependencies alive.
+    // Since JS won't garbage collect until there are no incoming edges.
+    #selfEdge = [];
+
+    #internalConstructor(symbol, ptr, selfEdge) {
+        if (symbol !== diplomatRuntime.internalConstructor) {
+            console.error("Brush is an Opaque type. You cannot call its constructor.");
+            return;
+        }
+        this.#ptr = ptr;
+        this.#selfEdge = selfEdge;
+
+        // Are we being borrowed? If not, we can register.
+        if (this.#selfEdge.length === 0) {
+            Brush_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    /**
+     * Every point becomes `block_name` (a block-state string).
+     */
+    static solid(blockName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const blockNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, blockName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_solid(diplomatReceive.buffer, blockNameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Nearest-block-to-RGB-color brush.
+     */
+    static color(r, g, b) {
+
+        const result = wasm.Brush_color(r, g, b);
+
+        try {
+            return new Brush(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Linear color gradient between two anchored points.
+     */
+    static linearGradient(x1, y1, z1, r1, g1, b1, x2, y2, z2, r2, g2, b2, space) {
+
+        const result = wasm.Brush_linear_gradient(x1, y1, z1, r1, g1, b1, x2, y2, z2, r2, g2, b2, space.ffiValue);
+
+        try {
+            return new Brush(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Base color shaded by surface normal against light direction
+     * (`lx`, `ly`, `lz`).
+     */
+    static shaded(r, g, b, lx, ly, lz) {
+
+        const result = wasm.Brush_shaded(r, g, b, lx, ly, lz);
+
+        try {
+            return new Brush(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Bilinear gradient over the patch `origin + s*u + t*v` with corner colors
+     * c00/c10/c01/c11.
+     */
+    static bilinearGradient(ox, oy, oz, ux, uy, uz, vx, vy, vz, r00, g00, b00, r10, g10, b10, r01, g01, b01, r11, g11, b11, space) {
+
+        const result = wasm.Brush_bilinear_gradient(ox, oy, oz, ux, uy, uz, vx, vy, vz, r00, g00, b00, r10, g10, b10, r01, g01, b01, r11, g11, b11, space.ffiValue);
+
+        try {
+            return new Brush(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Inverse-distance-weighted gradient between colored anchor points.
+     * `positions` is flat `[x0, y0, z0, x1, …]` and `colors` is flat
+     * `[r0, g0, b0, r1, …]`; both must describe the same non-zero number of
+     * points (`positions.len() == colors.len()`, a multiple of 3).
+     */
+    static pointGradient(positions, colors, falloff, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const positionsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, positions, "i32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_point_gradient(diplomatReceive.buffer, positionsSlice.ptr, colorsSlice.ptr, falloff, space.ffiValue);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Spotlight-lit base color (`r`, `g`, `b`): Lambert shading toward a
+     * cone light at (`px`, `py`, `pz`) aimed along (`dx`, `dy`, `dz`).
+     * Full intensity inside 0.7 × `cone_angle_deg`, smoothstep falloff
+     * to zero at the cone edge; surfaces facing away or outside the cone
+     * drop to a 4% ambient floor.
+     */
+    static spotlight(px, py, pz, dx, dy, dz, coneAngleDeg, r, g, b) {
+
+        const result = wasm.Brush_spotlight(px, py, pz, dx, dy, dz, coneAngleDeg, r, g, b);
+
+        try {
+            return new Brush(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Use `palette` for this brush's color→block snapping instead of the
+     * default all-blocks palette. No-op for `solid` brushes, which place
+     * a fixed block state. Set it before filling; the palette is shared,
+     * not copied.
+     */
+    setPalette(palette) {
+    wasm.Brush_set_palette(this.ffiValue, palette.ffiValue);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Gradient along a parametric curve: `stops` holds the curve parameters in
+     * `[0, 1]` and `colors` the matching flat RGB triples
+     * (`colors.len() == stops.len() * 3`, `stops` non-empty).
+     */
+    static curveGradient(stops, colors, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const stopsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, stops, "f32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_curve_gradient(diplomatReceive.buffer, stopsSlice.ptr, colorsSlice.ptr, space.ffiValue);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Compatibility path that colors voxels by evaluating an SDF graph as
+     * a scalar field. Prefer `field3` for new code.
+     * `stops` are in `[0, 1]`; `colors` are flat RGB triples. The sampled
+     * value is remapped from `[lo, hi]` before reading the gradient.
+     */
+    static fieldSdf(field, stops, colors, lo, hi, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const stopsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, stops, "f32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_field_sdf(diplomatReceive.buffer, field.ffiValue, stopsSlice.ptr, colorsSlice.ptr, lo, hi, space.ffiValue);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Color every voxel by evaluating a geometry-neutral scalar field at
+     * its center. The field is cloned into the brush, so both wrappers
+     * may be independently destroyed after construction.
+     */
+    static field3(field, stops, colors, lo, hi, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const stopsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, stops, "f32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_field3(diplomatReceive.buffer, field.ffiValue, stopsSlice.ptr, colorsSlice.ptr, lo, hi, space.ffiValue);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Legacy JSON-first field brush. Prefer `field3` for new code.
+     */
+    static field(fieldJson, stops, colors, lo, hi, space) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const fieldJsonSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, fieldJson)));
+        const stopsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, stops, "f32")));
+        const colorsSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.slice(wasm, colors, "u8")));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.Brush_field(diplomatReceive.buffer, fieldJsonSlice.ptr, stopsSlice.ptr, colorsSlice.ptr, lo, hi, space.ffiValue);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+            return new Brush(diplomatRuntime.internalConstructor, diplomatRuntime.ptrRead(wasm, diplomatReceive.buffer), []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/renderer/BuildAnimation.d.mts

@@ -0,0 +1,179 @@
+// generated by diplomat-tool
+import type { AnimationEffect } from "./AnimationEffect.mjs"
+import type { Brush } from "./Brush.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { Shape } from "./Shape.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A schematic wrapper that records construction calls as animation targets.
+ */
+export class BuildAnimation {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    static create(name: string): BuildAnimation;
+
+    /**
+     * Clone an existing schematic into one animation group. Entity-only
+     * schematics are supported; overlapping block/entity integer positions
+     * are rejected rather than silently dropping a model.
+     */
+    static fromSchematic(schematic: Schematic): BuildAnimation;
+
+    /**
+     * Apply one effect to every existing animation group.
+     */
+    animateAll(effect: AnimationEffect): void;
+
+    setDefaultEffect(effect: AnimationEffect): void;
+
+    /**
+     * Apply an effect to exactly the next recorded operation or explicit group.
+     * The returned borrowed builder enables fluent calls in every generated binding.
+     */
+    withEffect(effect: AnimationEffect): BuildAnimation;
+
+    setStepMs(stepMs: number): void;
+
+    setStaggerTotalMs(totalMs: number): void;
+
+    clearStagger(): void;
+
+    /**
+     * Shift every construction group's start time. Negative offsets let a
+     * repeating staggered effect cross the beginning of a loop capture.
+     */
+    setStaggerOffsetMs(offsetMs: number): void;
+
+    /**
+     * Capture exactly one loop period, excluding the duplicate endpoint.
+     * The rounded frame count evenly partitions the complete period.
+     */
+    setLoopPeriodMs(periodMs: number): void;
+
+    clearLoopPeriod(): void;
+
+    beginGroup(): void;
+
+    beginKeyedGroup(key: number): void;
+
+    endGroup(): number;
+
+    setBlock(x: number, y: number, z: number, block: string): number;
+
+    createRegion(name: string, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): void;
+
+    setBlockInRegion(region: string, x: number, y: number, z: number, block: string): number;
+
+    translate(x: number, y: number, z: number, durationMs: number): void;
+
+    translateRegion(region: string, x: number, y: number, z: number, durationMs: number): void;
+
+    translateAll(x: number, y: number, z: number, durationMs: number): void;
+
+    rotateX(degrees: number, durationMs: number): void;
+
+    rotateY(degrees: number, durationMs: number): void;
+
+    rotateZ(degrees: number, durationMs: number): void;
+
+    rotateRegionX(region: string, degrees: number, durationMs: number): void;
+
+    rotateRegionY(region: string, degrees: number, durationMs: number): void;
+
+    rotateRegionZ(region: string, degrees: number, durationMs: number): void;
+
+    rotateAllX(degrees: number, durationMs: number): void;
+
+    rotateAllY(degrees: number, durationMs: number): void;
+
+    rotateAllZ(degrees: number, durationMs: number): void;
+
+    flipX(durationMs: number): void;
+
+    flipY(durationMs: number): void;
+
+    flipZ(durationMs: number): void;
+
+    flipRegionX(region: string, durationMs: number): void;
+
+    flipRegionY(region: string, durationMs: number): void;
+
+    flipRegionZ(region: string, durationMs: number): void;
+
+    flipAllX(durationMs: number): void;
+
+    flipAllY(durationMs: number): void;
+
+    flipAllZ(durationMs: number): void;
+
+    stampRegion(source: Schematic, region: string, x: number, y: number, z: number, exclusions: string, durationMs: number): void;
+
+    stampBox(source: Schematic, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, x: number, y: number, z: number, exclusions: string, durationMs: number): void;
+
+    setOperationGizmos(enabled: boolean): void;
+
+    /**
+     * Record a named point on the open group, or on the most recent group.
+     * Coordinates are the block coordinates poses use. Returns the group
+     * id the anchor belongs to.
+     */
+    addAnchor(name: string, x: number, y: number, z: number): number;
+
+    /**
+     * Record a named point on an already recorded group.
+     */
+    addAnchorToGroup(group: number, name: string, x: number, y: number, z: number): void;
+
+    /**
+     * Every recorded anchor as JSON: `[{ name, group, local: [x, y, z] }]`.
+     */
+    anchorsJson(): string;
+
+    /**
+     * The build as an animated GLB — one textured node per group, TRS
+     * keyframes sampled at `fps`, anchors as child nodes, and
+     * `extras.nucleation` for opacity/tint/emissive and the camera track —
+     * base64-encoded.
+     */
+    toAnimatedGlbB64(pack: ResourcePack, fps: number): string;
+
+    /**
+     * The finished build as a Sponge `.schem`, base64-encoded — every recorded
+     * placement applied, no timeline.
+     */
+    toSchemB64(): string;
+
+    /**
+     * The finished build as a `.litematic`, base64-encoded.
+     */
+    toLitematicB64(): string;
+
+    operationsJson(): string;
+
+    frameJson(timeMs: number): string;
+
+    /**
+     * Fill a parametric shape and record its voxels as ordered groups in
+     * the same transactional construction operation.
+     */
+    fillAlongParameter(shape: Shape, brush: Brush, groupCount: number): number;
+
+    addArmorStand(x: number, y: number, z: number, yaw: number, armorMaterial: string): number;
+
+    animateCamera(effect: AnimationEffect, offsetMs: number): void;
+
+    frameCount(fps: number, holdMs: number): number;
+
+    groupCount(): number;
+
+    durationMs(): number;
+}

package/renderer/BuildAnimation.d.ts

@@ -0,0 +1,179 @@
+// generated by diplomat-tool
+import type { AnimationEffect } from "./AnimationEffect.mjs"
+import type { Brush } from "./Brush.mjs"
+import type { NucleationError } from "./NucleationError.mjs"
+import type { ResourcePack } from "./ResourcePack.mjs"
+import type { Schematic } from "./Schematic.mjs"
+import type { Shape } from "./Shape.mjs"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A schematic wrapper that records construction calls as animation targets.
+ */
+export class BuildAnimation {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    static create(name: string): BuildAnimation;
+
+    /**
+     * Clone an existing schematic into one animation group. Entity-only
+     * schematics are supported; overlapping block/entity integer positions
+     * are rejected rather than silently dropping a model.
+     */
+    static fromSchematic(schematic: Schematic): BuildAnimation;
+
+    /**
+     * Apply one effect to every existing animation group.
+     */
+    animateAll(effect: AnimationEffect): void;
+
+    setDefaultEffect(effect: AnimationEffect): void;
+
+    /**
+     * Apply an effect to exactly the next recorded operation or explicit group.
+     * The returned borrowed builder enables fluent calls in every generated binding.
+     */
+    withEffect(effect: AnimationEffect): BuildAnimation;
+
+    setStepMs(stepMs: number): void;
+
+    setStaggerTotalMs(totalMs: number): void;
+
+    clearStagger(): void;
+
+    /**
+     * Shift every construction group's start time. Negative offsets let a
+     * repeating staggered effect cross the beginning of a loop capture.
+     */
+    setStaggerOffsetMs(offsetMs: number): void;
+
+    /**
+     * Capture exactly one loop period, excluding the duplicate endpoint.
+     * The rounded frame count evenly partitions the complete period.
+     */
+    setLoopPeriodMs(periodMs: number): void;
+
+    clearLoopPeriod(): void;
+
+    beginGroup(): void;
+
+    beginKeyedGroup(key: number): void;
+
+    endGroup(): number;
+
+    setBlock(x: number, y: number, z: number, block: string): number;
+
+    createRegion(name: string, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number): void;
+
+    setBlockInRegion(region: string, x: number, y: number, z: number, block: string): number;
+
+    translate(x: number, y: number, z: number, durationMs: number): void;
+
+    translateRegion(region: string, x: number, y: number, z: number, durationMs: number): void;
+
+    translateAll(x: number, y: number, z: number, durationMs: number): void;
+
+    rotateX(degrees: number, durationMs: number): void;
+
+    rotateY(degrees: number, durationMs: number): void;
+
+    rotateZ(degrees: number, durationMs: number): void;
+
+    rotateRegionX(region: string, degrees: number, durationMs: number): void;
+
+    rotateRegionY(region: string, degrees: number, durationMs: number): void;
+
+    rotateRegionZ(region: string, degrees: number, durationMs: number): void;
+
+    rotateAllX(degrees: number, durationMs: number): void;
+
+    rotateAllY(degrees: number, durationMs: number): void;
+
+    rotateAllZ(degrees: number, durationMs: number): void;
+
+    flipX(durationMs: number): void;
+
+    flipY(durationMs: number): void;
+
+    flipZ(durationMs: number): void;
+
+    flipRegionX(region: string, durationMs: number): void;
+
+    flipRegionY(region: string, durationMs: number): void;
+
+    flipRegionZ(region: string, durationMs: number): void;
+
+    flipAllX(durationMs: number): void;
+
+    flipAllY(durationMs: number): void;
+
+    flipAllZ(durationMs: number): void;
+
+    stampRegion(source: Schematic, region: string, x: number, y: number, z: number, exclusions: string, durationMs: number): void;
+
+    stampBox(source: Schematic, minX: number, minY: number, minZ: number, maxX: number, maxY: number, maxZ: number, x: number, y: number, z: number, exclusions: string, durationMs: number): void;
+
+    setOperationGizmos(enabled: boolean): void;
+
+    /**
+     * Record a named point on the open group, or on the most recent group.
+     * Coordinates are the block coordinates poses use. Returns the group
+     * id the anchor belongs to.
+     */
+    addAnchor(name: string, x: number, y: number, z: number): number;
+
+    /**
+     * Record a named point on an already recorded group.
+     */
+    addAnchorToGroup(group: number, name: string, x: number, y: number, z: number): void;
+
+    /**
+     * Every recorded anchor as JSON: `[{ name, group, local: [x, y, z] }]`.
+     */
+    anchorsJson(): string;
+
+    /**
+     * The build as an animated GLB — one textured node per group, TRS
+     * keyframes sampled at `fps`, anchors as child nodes, and
+     * `extras.nucleation` for opacity/tint/emissive and the camera track —
+     * base64-encoded.
+     */
+    toAnimatedGlbB64(pack: ResourcePack, fps: number): string;
+
+    /**
+     * The finished build as a Sponge `.schem`, base64-encoded — every recorded
+     * placement applied, no timeline.
+     */
+    toSchemB64(): string;
+
+    /**
+     * The finished build as a `.litematic`, base64-encoded.
+     */
+    toLitematicB64(): string;
+
+    operationsJson(): string;
+
+    frameJson(timeMs: number): string;
+
+    /**
+     * Fill a parametric shape and record its voxels as ordered groups in
+     * the same transactional construction operation.
+     */
+    fillAlongParameter(shape: Shape, brush: Brush, groupCount: number): number;
+
+    addArmorStand(x: number, y: number, z: number, yaw: number, armorMaterial: string): number;
+
+    animateCamera(effect: AnimationEffect, offsetMs: number): void;
+
+    frameCount(fps: number, holdMs: number): number;
+
+    groupCount(): number;
+
+    durationMs(): number;
+}