nucleation 0.10.21 → 0.10.23

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;
+}