@energy8platform/golem 0.2.1 → 0.5.0

package/dist/lib/interactive-bones.d.ts

@@ -0,0 +1,37 @@
+import type { RigPlayer } from "./rig-runtime";
+import type { PartTransform } from "./interactive-editor";
+export interface BoneEditPatch {
+    format: "golem.bone-edits";
+    version: 1;
+    documentId: string;
+    transforms: Record<string, PartTransform>;
+}
+export interface InteractiveBoneEditorOptions {
+    player: Pick<RigPlayer, "doc" | "onBeforePose" | "refreshPose">;
+    documentId: string;
+    onChange?: (patch: BoneEditPatch) => void;
+    onRender?: () => void;
+    historyLimit?: number;
+}
+/** Add bone offsets after expression controls, before constraints and native skinning. */
+export declare function createInteractiveBoneEditor(options: InteractiveBoneEditorOptions): {
+    getTransform: (id: string) => {
+        x: number;
+        y: number;
+        rotation: number;
+        scaleX: number;
+        scaleY: number;
+    };
+    exportPatch: () => BoneEditPatch;
+    validatePatch: (value: unknown) => BoneEditPatch;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    setTransform(id: string, value: Partial<PartTransform>): void;
+    importPatch(value: unknown): void;
+    reset(id?: string): void;
+    setVisible(value: boolean): void;
+    undo(): void;
+    redo(): void;
+    dispose(): void;
+};
+export type InteractiveBoneEditor = ReturnType<typeof createInteractiveBoneEditor>;

package/dist/lib/interactive-editor.d.ts

@@ -0,0 +1,80 @@
+import type { RigPlayer } from "./rig-runtime";
+export interface EditorPoint {
+    x: number;
+    y: number;
+}
+export interface PartTransform {
+    x: number;
+    y: number;
+    rotation: number;
+    scaleX: number;
+    scaleY: number;
+}
+export interface InteractiveEditPatch {
+    format: "golem.interactive-edits";
+    version: 1;
+    documentId: string;
+    transforms: Record<string, PartTransform>;
+}
+export interface EditorGroup {
+    id: string;
+    members: readonly string[];
+    pivotBone?: string;
+}
+export type InteractivePlayer = Pick<RigPlayer, "doc" | "view" | "world" | "renderItems" | "clipPolygons" | "onAfterPose" | "refreshPose">;
+export interface InteractiveEditorOptions {
+    player: InteractivePlayer;
+    /** Transparent overlay aligned with the player's rendered viewport. It is cleared by the editor. */
+    overlay: HTMLCanvasElement;
+    /** Host-defined stable rig fingerprint; mismatched patches are rejected. */
+    documentId: string;
+    groups?: readonly EditorGroup[];
+    /** Override when overlay backing pixels differ from the renderer's logical coordinates. */
+    screenToDocument?: (client: EditorPoint) => EditorPoint;
+    documentToOverlay?: (point: EditorPoint) => EditorPoint;
+    alphaFallback?: "skip" | "geometry";
+    onChange?: (patch: InteractiveEditPatch) => void;
+    onSelection?: (id: string | null) => void;
+    onHover?: (id: string | null) => void;
+    onError?: (error: Error) => void;
+    onGestureStart?: () => void;
+    /** Render the host scene after a manual refresh; never called from the pose hook. */
+    onRender?: () => void;
+    historyLimit?: number;
+}
+export interface EditorFrame {
+    id: string;
+    center: EditorPoint;
+    corners: EditorPoint[];
+    handles: {
+        name: string;
+        p: EditorPoint;
+    }[];
+}
+/** Embedded part editor. Source documents are never mutated; edits replay after every evaluated pose. */
+export declare function createInteractiveEditor(options: InteractiveEditorOptions): {
+    select: (id: string | null) => void;
+    hitTest: (p: EditorPoint) => string | null;
+    getFrame: (id: string) => EditorFrame | null;
+    getTransform: (id: string) => {
+        x: number;
+        y: number;
+        rotation: number;
+        scaleX: number;
+        scaleY: number;
+    };
+    readonly selection: string | null;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    exportPatch: () => InteractiveEditPatch;
+    setEnabled(value: boolean): void;
+    setVisible(value: boolean): void;
+    setTransform(id: string, value: Partial<PartTransform>): void;
+    reset(id?: string): void;
+    undo(): void;
+    redo(): void;
+    importPatch(value: unknown): void;
+    dispose(): void;
+};
+export type InteractiveEditor = ReturnType<typeof createInteractiveEditor>;
+export { createInteractiveBoneEditor, type BoneEditPatch, type InteractiveBoneEditorOptions } from "./interactive-bones";