nucleation 0.3.17 → 0.3.19

package/AnimationEffect.d.ts

@@ -0,0 +1,44 @@
+// generated by diplomat-tool
+import type { NucleationError } from "./NucleationError"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * A reusable set of property tracks, modelled after Anime.js object animations.
+ */
+export class AnimationEffect {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    static create(durationMs: number): AnimationEffect;
+
+    static instant(): AnimationEffect;
+
+    static popIn(durationMs: number): AnimationEffect;
+
+    static dropIn(durationMs: number, height: number): AnimationEffect;
+
+    static dropAndPop(durationMs: number, height: number): AnimationEffect;
+
+    static spinIn(durationMs: number, turns: number): AnimationEffect;
+
+    static turntable(durationMs: number): AnimationEffect;
+
+    /**
+     * Add a two-key property tween. Property names follow Anime.js/Three.js:
+     * `x`, `y`, `z`, `rotateX`, `rotateY`, `rotateZ`, `scale`, `opacity`,
+     * `tintR/G/B/A`, and `emissiveR/G/B`.
+     */
+    addTween(propertyName: string, from: number, to: number, easingName: string): void;
+
+    /**
+     * Add a normalised keyframe (`at` in `0..=1`) to a property track.
+     */
+    addKeyframe(propertyName: string, at: number, value: number, easingName: string): void;
+
+    setRepeatForever(): void;
+}

package/AnimationEffect.mjs

@@ -0,0 +1,204 @@
+// generated by diplomat-tool
+import { NucleationError } from "./NucleationError.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const AnimationEffect_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.AnimationEffect_destroy(ptr);
+});
+
+/**
+ * A reusable set of property tracks, modelled after Anime.js object animations.
+ */
+export class AnimationEffect {
+    // 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("AnimationEffect 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) {
+            AnimationEffect_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    static create(durationMs) {
+
+        const result = wasm.AnimationEffect_create(durationMs);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static instant() {
+
+        const result = wasm.AnimationEffect_instant();
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static popIn(durationMs) {
+
+        const result = wasm.AnimationEffect_pop_in(durationMs);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static dropIn(durationMs, height) {
+
+        const result = wasm.AnimationEffect_drop_in(durationMs, height);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static dropAndPop(durationMs, height) {
+
+        const result = wasm.AnimationEffect_drop_and_pop(durationMs, height);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static spinIn(durationMs, turns) {
+
+        const result = wasm.AnimationEffect_spin_in(durationMs, turns);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    static turntable(durationMs) {
+
+        const result = wasm.AnimationEffect_turntable(durationMs);
+
+        try {
+            return new AnimationEffect(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Add a two-key property tween. Property names follow Anime.js/Three.js:
+     * `x`, `y`, `z`, `rotateX`, `rotateY`, `rotateZ`, `scale`, `opacity`,
+     * `tintR/G/B/A`, and `emissiveR/G/B`.
+     */
+    addTween(propertyName, from, to, easingName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const propertyNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, propertyName)));
+        const easingNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, easingName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.AnimationEffect_add_tween(diplomatReceive.buffer, this.ffiValue, propertyNameSlice.ptr, from, to, easingNameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    /**
+     * Add a normalised keyframe (`at` in `0..=1`) to a property track.
+     */
+    addKeyframe(propertyName, at, value, easingName) {
+        let functionCleanupArena = new diplomatRuntime.CleanupArena();
+
+        const propertyNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, propertyName)));
+        const easingNameSlice = functionCleanupArena.alloc(diplomatRuntime.DiplomatBuf.sliceWrapper(wasm, diplomatRuntime.DiplomatBuf.str8(wasm, easingName)));
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 5, 4, true);
+
+
+        const result = wasm.AnimationEffect_add_keyframe(diplomatReceive.buffer, this.ffiValue, propertyNameSlice.ptr, at, value, easingNameSlice.ptr);
+
+        try {
+            if (!diplomatReceive.resultFlag) {
+                const cause = new NucleationError(diplomatRuntime.internalConstructor, diplomatRuntime.enumDiscriminant(wasm, diplomatReceive.buffer));
+                throw new globalThis.Error('NucleationError.' + cause.value, { cause });
+            }
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            functionCleanupArena.free();
+
+            diplomatReceive.free();
+        }
+    }
+
+    setRepeatForever() {
+    wasm.AnimationEffect_set_repeat_forever(this.ffiValue);
+
+        try {}
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/BuildAnimation.d.ts

@@ -0,0 +1,130 @@
+// generated by diplomat-tool
+import type { AnimationEffect } from "./AnimationEffect"
+import type { Brush } from "./Brush"
+import type { NucleationError } from "./NucleationError"
+import type { Schematic } from "./Schematic"
+import type { Shape } from "./Shape"
+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;
+
+    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;
+
+    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;
+}