@energy8platform/golem 0.2.1 → 0.5.0

package/dist/lib/rig-control-qa.d.ts

@@ -0,0 +1,319 @@
+import { type RigDocument } from "./rig-format";
+import { type ControlCase } from "./rig-controls";
+export declare function checkControlCases(doc: RigDocument, cases: ControlCase[]): {
+    passed: boolean;
+    errors: {
+        case: number;
+        subject: string;
+        message: string;
+    }[];
+    effects: {
+        id: string;
+        geometryOrOpacityChanged: boolean;
+    }[];
+    scope: string;
+};
+export declare function makeControlSweep(doc: RigDocument, probes: Record<string, number[]>): {
+    cases: {
+        values: {
+            [x: string]: number;
+        };
+        label: string;
+    }[];
+    doc: {
+        path: {
+            rotation: number;
+            id: string;
+            order: number;
+            bones: string[];
+            target: string;
+            mixRotate: number;
+            mixX: number;
+            mixY: number;
+            positionMode: "fixed" | "percent";
+            spacingMode: "length" | "fixed" | "percent" | "proportional";
+            rotateMode: "tangent" | "chain" | "chainScale";
+            position: number;
+            spacing: number;
+        }[];
+        transform: {
+            x: number;
+            y: number;
+            rotation: number;
+            scaleX: number;
+            scaleY: number;
+            shearY: number;
+            id: string;
+            order: number;
+            bones: string[];
+            target: string;
+            local: boolean;
+            relative: boolean;
+            mixRotate: number;
+            mixX: number;
+            mixY: number;
+            mixScaleX: number;
+            mixScaleY: number;
+            mixShearY: number;
+        }[];
+        bones: {
+            length: number;
+            id: string;
+            transform: {
+                x: number;
+                y: number;
+                rotation: number;
+                scaleX: number;
+                scaleY: number;
+                shearX: number;
+                shearY: number;
+            };
+            inherit: "normal" | "onlyTranslation" | "noRotationOrReflection" | "noScale" | "noScaleOrReflection";
+            parent?: string | undefined;
+            role?: string | undefined;
+            color?: string | undefined;
+        }[];
+        ik: {
+            id: string;
+            order: number;
+            bones: string[];
+            target: string;
+            mix: number;
+            softness: number;
+            bendPositive: boolean;
+            compress: boolean;
+            stretch: boolean;
+            uniform: boolean;
+            iterations?: number | undefined;
+            tolerance?: number | undefined;
+        }[];
+        format: "energy8.rig";
+        version: 2;
+        meta: {
+            width: number;
+            height: number;
+            name: string;
+            notes?: string | undefined;
+            reference?: {
+                x: number;
+                y: number;
+                src: string;
+                opacity: number;
+                scale: number;
+            } | undefined;
+        };
+        assets: {
+            id: string;
+            src: string;
+            width: number;
+            height: number;
+            rotate: 0 | 90;
+            frame?: [number, number, number, number] | undefined;
+            trim?: [number, number] | undefined;
+            origin?: {
+                inpainted: boolean;
+                sourceImage?: string | undefined;
+                bboxSpace?: "source" | "document" | undefined;
+                bbox?: [number, number, number, number] | undefined;
+                prompt?: string | undefined;
+            } | undefined;
+        }[];
+        slots: {
+            id: string;
+            color: string;
+            bone: string;
+            alpha: number;
+            z: number;
+            blend: "normal" | "add" | "multiply" | "screen";
+            clip?: string | undefined;
+            attachment?: string | undefined;
+        }[];
+        attachments: ({
+            x: number;
+            y: number;
+            type: "region";
+            rotation: number;
+            scaleX: number;
+            scaleY: number;
+            id: string;
+            slot: string;
+            asset: string;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "mesh";
+            id: string;
+            slot: string;
+            asset: string;
+            uvs: number[];
+            triangles: number[];
+            hull: number;
+            width?: number | undefined;
+            height?: number | undefined;
+            vertices?: number[] | undefined;
+            weights?: {
+                x: number;
+                y: number;
+                bone: string;
+                w: number;
+            }[][] | undefined;
+        } | {
+            type: "path";
+            id: string;
+            slot: string;
+            lengths: number[];
+            closed: boolean;
+            constantSpeed: boolean;
+            vertices?: number[] | undefined;
+            weights?: {
+                x: number;
+                y: number;
+                bone: string;
+                w: number;
+            }[][] | undefined;
+        })[];
+        animations: {
+            id: string;
+            duration: number;
+            loop: boolean;
+            tracks: ({
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "control";
+                prop: "value";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "bone";
+                prop: "x" | "y" | "rotation" | "scaleX" | "scaleY" | "shearX" | "shearY";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "slot";
+                prop: "color" | "attachment" | "alpha" | "z";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "deform";
+                prop: string;
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "ik";
+                prop: "mix" | "softness" | "bendPositive" | "compress" | "stretch";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "transform";
+                prop: "x" | "y" | "rotation" | "scaleX" | "scaleY" | "shearY" | "mixRotate" | "mixX" | "mixY" | "mixScaleX" | "mixScaleY" | "mixShearY";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "path";
+                prop: "mixRotate" | "mixX" | "mixY" | "position" | "spacing";
+                interpolation?: "segment" | "pchip" | undefined;
+            } | {
+                keys: {
+                    t: number;
+                    v: string | number | number[] | string[] | null;
+                    ease: "linear" | "step" | "ease_in" | "ease_out" | "ease_in_out" | "minimum_jerk" | "back_out" | "elastic_out" | {
+                        bezier: [number, number, number, number];
+                    };
+                }[];
+                id: string;
+                target: "drawOrder";
+                prop: "order";
+                interpolation?: "segment" | "pchip" | undefined;
+            })[];
+            events: {
+                t: number;
+                name: string;
+                payload?: Record<string, unknown> | undefined;
+            }[];
+            preset?: {
+                params: Record<string, unknown>;
+                name: string;
+            } | undefined;
+        }[];
+        controls?: {
+            id: string;
+            min: number;
+            max: number;
+            default: number;
+            label?: string | undefined;
+        }[] | undefined;
+        controlBindings?: {
+            id: string;
+            axes: {
+                keys: number[];
+                control: string;
+            }[];
+            channels: ({
+                values: (number | number[])[];
+                id: string;
+                target: "bone";
+                prop: "x" | "y" | "rotation" | "scaleX" | "scaleY" | "shearX" | "shearY";
+            } | {
+                values: (number | number[])[];
+                id: string;
+                target: "slot";
+                prop: "alpha";
+            } | {
+                values: (number | number[])[];
+                id: string;
+                target: "deform";
+                prop: "vertices";
+            })[];
+        }[] | undefined;
+    };
+    animation: string;
+    times: number[];
+};

package/dist/lib/rig-controls.d.ts

@@ -0,0 +1,13 @@
+/** Semantic control grids; pure math shared by the editor, renderer and validation tools. */
+import type { ControlBinding, RigDocument } from "./rig-format";
+import type { Pose } from "./rig-anim";
+export declare function controlPose(doc: RigDocument, values: Record<string, number>): Pose;
+export declare function sampleBinding(binding: ControlBinding, values: number[]): (number | number[])[];
+/** Bindings own absolute output channels. They are resolved before constraints and never mutate input. */
+export declare function resolveControls(doc: RigDocument, input: Pose): Pose;
+export interface ControlCase {
+    label: string;
+    values: Record<string, number>;
+}
+/** Bounded cartesian grid. Explicit probes make coverage reproducible rather than pretending to test all poses. */
+export declare function controlCases(doc: RigDocument, probes: Record<string, number[]>): ControlCase[];