blockymodel-web 0.1.0

package/dist/loaders/BlockyModelLoader.d.ts

@@ -0,0 +1,48 @@
+import * as THREE from "three";
+import type { BlockyModel } from "../types/blockymodel";
+/**
+ * Loader for .blockymodel files
+ * Parses JSON and builds Three.js Object3D hierarchy
+ */
+export declare class BlockyModelLoader extends THREE.Loader {
+    constructor(manager?: THREE.LoadingManager);
+    /**
+     * Load a .blockymodel file from URL
+     */
+    load(url: string): Promise<THREE.Group>;
+    /**
+     * Load from File object (for drag-drop / file input)
+     */
+    loadFromFile(file: File): Promise<THREE.Group>;
+    /**
+     * Parse BlockyModel JSON into Three.js scene graph
+     */
+    parse(json: BlockyModel): THREE.Group;
+    /**
+     * Recursively parse a BlockyNode into Three.js Object3D
+     */
+    private parseNode;
+    /**
+     * Create the appropriate Object3D based on shape type
+     */
+    private createNodeObject;
+    /**
+     * Create a box mesh from shape data
+     */
+    private createBox;
+    /**
+     * Create a quad (plane) mesh from shape data
+     */
+    private createQuad;
+    /**
+     * Create material based on shading mode
+     * Phase 1: Basic color material, texture mapping in Phase 2
+     */
+    private createMaterial;
+}
+/**
+ * Helper to apply a texture to all meshes in a loaded model
+ * Phase 1: Simple texture application without UV mapping
+ */
+export declare function applyTextureToModel(model: THREE.Group, texture: THREE.Texture): void;
+//# sourceMappingURL=BlockyModelLoader.d.ts.map

package/dist/loaders/BlockyModelLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockyModelLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/BlockyModelLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,sBAAsB,CAAC;AAO9B;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK,CAAC,MAAM;gBACrC,OAAO,CAAC,EAAE,KAAK,CAAC,cAAc;IAI1C;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAS7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAMpD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,CAAC,KAAK;IAcrC;;OAEG;IACH,OAAO,CAAC,SAAS;IAyBjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAkCjB;;OAEG;IACH,OAAO,CAAC,UAAU;IA6DlB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAqCvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,OAAO,EAAE,KAAK,CAAC,OAAO,GACrB,IAAI,CAgBN"}

package/dist/types/blockymodel.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BlockyModel format type definitions
+ * Based on Hytale's native 3D model format
+ */
+export interface Vec3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface Vec2 {
+    x: number;
+    y: number;
+}
+export interface Quaternion {
+    w: number;
+    x: number;
+    y: number;
+    z: number;
+}
+export interface FaceUV {
+    offset: Vec2;
+    mirror: {
+        x: boolean;
+        y: boolean;
+    };
+    angle: 0 | 90 | 180 | 270;
+}
+export interface TextureLayout {
+    front?: FaceUV;
+    back?: FaceUV;
+    left?: FaceUV;
+    right?: FaceUV;
+    top?: FaceUV;
+    bottom?: FaceUV;
+}
+export type ShapeType = "box" | "quad" | "none";
+export type ShadingMode = "standard" | "flat" | "fullbright" | "reflective";
+export type NormalDirection = "+X" | "-X" | "+Y" | "-Y" | "+Z" | "-Z";
+export interface ShapeSettings {
+    size?: Vec3;
+    normal?: NormalDirection;
+    isPiece?: boolean;
+    isStaticBox?: boolean;
+}
+export interface BlockyShape {
+    type: ShapeType;
+    offset: Vec3;
+    stretch: Vec3;
+    settings: ShapeSettings;
+    textureLayout: TextureLayout;
+    unwrapMode: "custom" | "auto";
+    visible: boolean;
+    doubleSided: boolean;
+    shadingMode: ShadingMode;
+}
+export interface BlockyNode {
+    id: string;
+    name: string;
+    position?: Vec3;
+    orientation?: Quaternion;
+    shape: BlockyShape;
+    children: BlockyNode[];
+}
+export interface BlockyModel {
+    lod?: "auto" | string;
+    format?: "character" | "prop";
+    nodes: BlockyNode[];
+}
+export declare const DEFAULT_POSITION: Vec3;
+export declare const DEFAULT_ORIENTATION: Quaternion;
+export declare const DEFAULT_STRETCH: Vec3;
+//# sourceMappingURL=blockymodel.d.ts.map

package/dist/types/blockymodel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockymodel.d.ts","sourceRoot":"","sources":["../../src/types/blockymodel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE;QAAE,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAGD,eAAO,MAAM,gBAAgB,EAAE,IAA2B,CAAC;AAC3D,eAAO,MAAM,mBAAmB,EAAE,UAAuC,CAAC;AAC1E,eAAO,MAAM,eAAe,EAAE,IAA2B,CAAC"}

package/dist/ui/HierarchyPanel.d.ts

@@ -0,0 +1,73 @@
+import type { Editor } from "../editor/Editor";
+/**
+ * Hierarchy panel showing the model tree structure
+ */
+export declare class HierarchyPanel {
+    private editor;
+    private container;
+    private treeContainer;
+    private contextMenu;
+    private contextTarget;
+    constructor(editor: Editor, containerId: string);
+    /**
+     * Build the hierarchy panel UI
+     */
+    private buildUI;
+    /**
+     * Setup event listeners
+     */
+    private setupEventListeners;
+    /**
+     * Refresh the hierarchy tree
+     */
+    refresh(): void;
+    /**
+     * Build tree recursively
+     */
+    private buildTree;
+    /**
+     * Get icon for object type
+     */
+    private getIcon;
+    /**
+     * Toggle expand/collapse
+     */
+    private toggleExpand;
+    /**
+     * Update selection highlight
+     */
+    private updateSelection;
+    /**
+     * Show context menu
+     */
+    private showContextMenu;
+    /**
+     * Hide context menu
+     */
+    private hideContextMenu;
+    /**
+     * Handle context menu action
+     */
+    private handleContextAction;
+    /**
+     * Add a child box
+     */
+    private addChildBox;
+    /**
+     * Add a child group
+     */
+    private addChildGroup;
+    /**
+     * Duplicate a node
+     */
+    private duplicateNode;
+    /**
+     * Delete a node
+     */
+    private deleteNode;
+    /**
+     * Cleanup
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=HierarchyPanel.d.ts.map

package/dist/ui/HierarchyPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchyPanel.d.ts","sourceRoot":"","sources":["../../src/ui/HierarchyPanel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA+B;gBAExC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAY/C;;OAEG;IACH,OAAO,CAAC,OAAO;IAsBf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf;;OAEG;IACH,OAAO,CAAC,SAAS;IA4DjB;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/ui/PropertyPanel.d.ts

@@ -0,0 +1,59 @@
+import * as THREE from "three";
+import type { Editor } from "../editor/Editor";
+/**
+ * Property panel for editing selected object properties
+ */
+export declare class PropertyPanel {
+    private editor;
+    private container;
+    private currentObject;
+    private isUpdating;
+    private nameInput;
+    private posInputs;
+    private rotInputs;
+    private scaleInputs;
+    private sizeInputs;
+    private offsetInputs;
+    private visibleCheckbox;
+    private doubleSidedCheckbox;
+    private shadingModeSelect;
+    private shapeTypeSpan;
+    constructor(editor: Editor, containerId: string);
+    /**
+     * Build the property panel UI
+     */
+    private buildUI;
+    /**
+     * Setup event listeners
+     */
+    private setupEventListeners;
+    /**
+     * Setup Vec3 input handlers
+     */
+    private setupVec3Input;
+    /**
+     * Set the object to display properties for
+     */
+    setObject(object: THREE.Object3D | null): void;
+    /**
+     * Update UI from current object
+     */
+    private updateFromObject;
+    /**
+     * Rebuild geometry after size/offset changes
+     */
+    private rebuildGeometry;
+    /**
+     * Show property sections
+     */
+    private showProperties;
+    /**
+     * Show empty state
+     */
+    private showEmpty;
+    /**
+     * Cleanup
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=PropertyPanel.d.ts.map

package/dist/ui/PropertyPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyPanel.d.ts","sourceRoot":"","sources":["../../src/ui/PropertyPanel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAO/C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,UAAU,CAAkB;IAGpC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAqE;IACtF,OAAO,CAAC,SAAS,CAAqE;IACtF,OAAO,CAAC,WAAW,CAAqE;IACxF,OAAO,CAAC,UAAU,CAAqE;IACvF,OAAO,CAAC,YAAY,CAAqE;IACzF,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAY/C;;OAEG;IACH,OAAO,CAAC,OAAO;IAoHf;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmH3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI;IAW9C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0DxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/ui/UVEditor.d.ts

@@ -0,0 +1,56 @@
+import * as THREE from "three";
+import type { Editor } from "../editor/Editor";
+/**
+ * UV Editor panel for per-face texture UV editing
+ */
+export declare class UVEditor {
+    private editor;
+    private container;
+    private currentObject;
+    private isUpdating;
+    private faceInputs;
+    constructor(editor: Editor, containerId: string);
+    /**
+     * Build the UV editor UI
+     */
+    private buildUI;
+    /**
+     * Setup event listeners
+     */
+    private setupEventListeners;
+    /**
+     * Handle face UV change
+     */
+    private handleFaceChange;
+    /**
+     * Get texture layout from current object
+     */
+    private getTextureLayout;
+    /**
+     * Set the object to edit UVs for
+     */
+    setObject(object: THREE.Object3D | null): void;
+    /**
+     * Update UI from current object
+     */
+    private updateFromObject;
+    /**
+     * Apply texture layout to geometry UVs
+     * Note: This is a simplified implementation - full UV mapping would require
+     * knowing the texture atlas dimensions
+     */
+    private applyTextureLayout;
+    /**
+     * Show content
+     */
+    private showContent;
+    /**
+     * Show empty state
+     */
+    private showEmpty;
+    /**
+     * Cleanup
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=UVEditor.d.ts.map

package/dist/ui/UVEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UVEditor.d.ts","sourceRoot":"","sources":["../../src/ui/UVEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAsB/C;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,UAAU,CAMH;gBAEH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAY/C;;OAEG;IACH,OAAO,CAAC,OAAO;IA0Df;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2C3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI;IAY9C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA4D1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/ui/index.d.ts

@@ -0,0 +1,4 @@
+export { PropertyPanel } from "./PropertyPanel";
+export { HierarchyPanel } from "./HierarchyPanel";
+export { UVEditor } from "./UVEditor";
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/viewer/ViewerController.d.ts

@@ -0,0 +1,71 @@
+import * as THREE from "three";
+import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
+export interface ViewerOptions {
+    container: HTMLElement;
+    backgroundColor?: number;
+}
+/**
+ * Main viewer controller
+ * Manages Three.js scene, camera, controls, and model loading
+ */
+export declare class ViewerController {
+    readonly scene: THREE.Scene;
+    readonly camera: THREE.PerspectiveCamera;
+    readonly renderer: THREE.WebGLRenderer;
+    readonly controls: OrbitControls;
+    readonly domElement: HTMLElement;
+    private loader;
+    private textureLoader;
+    private currentModel;
+    private animationId;
+    constructor(options: ViewerOptions);
+    private setupLighting;
+    private setupHelpers;
+    private handleResize;
+    private animate;
+    /**
+     * Load a .blockymodel file
+     */
+    loadModel(file: File): Promise<THREE.Group>;
+    /**
+     * Get the currently loaded model
+     */
+    getModel(): THREE.Group | null;
+    /**
+     * Load a texture and apply to current model
+     */
+    loadTexture(file: File): Promise<void>;
+    /**
+     * Fit camera to view the entire model
+     */
+    fitCameraToModel(): void;
+    /**
+     * Reset camera to default position
+     */
+    resetCamera(): void;
+    /**
+     * Set background color
+     */
+    setBackgroundColor(color: number | string): void;
+    /**
+     * Toggle wireframe mode on all meshes
+     */
+    toggleWireframe(enabled: boolean): void;
+    /**
+     * Get model hierarchy for debugging
+     */
+    getModelHierarchy(): object | null;
+    /**
+     * Count meshes in model
+     */
+    private countMeshes;
+    /**
+     * Dispose of model resources
+     */
+    private disposeModel;
+    /**
+     * Clean up all resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=ViewerController.d.ts.map

package/dist/viewer/ViewerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewerController.d.ts","sourceRoot":"","sources":["../../src/viewer/ViewerController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAG7E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,SAAgB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnC,SAAgB,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAChD,SAAgB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;IAC9C,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,UAAU,EAAE,WAAW,CAAC;IAExC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAuB;gBAE9B,OAAO,EAAE,aAAa;IAiDlC,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,OAAO,CAIb;IAEF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAuBjD;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI;IAI9B;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAqBxB;;OAEG;IACH,WAAW,IAAI,IAAI;IAUnB;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIhD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASvC;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAalC;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,IAAI,IAAI;CAYhB"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "blockymodel-web",
+  "version": "0.1.0",
+  "description": "Web-based 3D editor for BlockyModel format with transform gizmos, hierarchy panel, property editing, and undo/redo",
+  "type": "module",
+  "main": "./dist/blockymodel-web.umd.cjs",
+  "module": "./dist/blockymodel-web.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/blockymodel-web.js",
+      "require": "./dist/blockymodel-web.umd.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "build:lib": "vite build --mode lib && tsc -p tsconfig.build.json",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build:lib"
+  },
+  "keywords": [
+    "blockymodel",
+    "hytale",
+    "3d-editor",
+    "threejs",
+    "voxel",
+    "model-editor",
+    "webgl"
+  ],
+  "author": "Zacx <zacxdev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZacxDev/blockymodel-web.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ZacxDev/blockymodel-web/issues"
+  },
+  "homepage": "https://github.com/ZacxDev/blockymodel-web#readme",
+  "peerDependencies": {
+    "three": ">=0.150.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@types/three": "^0.170.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "jsdom": "^28.0.0",
+    "three": "^0.170.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^4.0.18"
+  }
+}

package/src/editor/Editor.ts

@@ -0,0 +1,196 @@
+import * as THREE from "three";
+import { SelectionManager } from "./SelectionManager";
+import { TransformManager } from "./TransformManager";
+import { History } from "./History";
+import type { Command } from "./commands/Command";
+import type { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
+
+export type EditorEvent =
+  | "selectionChanged"
+  | "objectChanged"
+  | "historyChanged"
+  | "modeChanged"
+  | "modelLoaded";
+
+export interface EditorOptions {
+  scene: THREE.Scene;
+  camera: THREE.Camera;
+  renderer: THREE.WebGLRenderer;
+  controls: OrbitControls;
+  domElement: HTMLElement;
+}
+
+type EventCallback = (...args: unknown[]) => void;
+
+/**
+ * Central editor state manager
+ * Coordinates selection, transforms, history, and emits events for UI updates
+ */
+export class Editor {
+  public readonly scene: THREE.Scene;
+  public readonly camera: THREE.Camera;
+  public readonly renderer: THREE.WebGLRenderer;
+  public readonly controls: OrbitControls;
+  public readonly domElement: HTMLElement;
+
+  public readonly selection: SelectionManager;
+  public readonly transform: TransformManager;
+  public readonly history: History;
+
+  private currentModel: THREE.Group | null = null;
+  private eventListeners: Map<EditorEvent, Set<EventCallback>> = new Map();
+
+  constructor(options: EditorOptions) {
+    this.scene = options.scene;
+    this.camera = options.camera;
+    this.renderer = options.renderer;
+    this.controls = options.controls;
+    this.domElement = options.domElement;
+
+    // Initialize subsystems
+    this.history = new History();
+    this.selection = new SelectionManager(this);
+    this.transform = new TransformManager(this);
+
+    // Forward selection events
+    this.selection.on("selectionChanged", (object: THREE.Object3D | null) => {
+      this.emit("selectionChanged", object);
+      this.transform.attach(object);
+    });
+
+    // Forward transform events
+    this.transform.on("objectChanged", (...args: unknown[]) => {
+      const object = args[0] as THREE.Object3D;
+      const command = args[1] as Command;
+      this.history.execute(command);
+      this.emit("objectChanged", object);
+    });
+
+    // Forward history events
+    this.history.on("historyChanged", () => {
+      this.emit("historyChanged");
+    });
+
+    // Listen for mode changes
+    this.transform.on("modeChanged", (...args: unknown[]) => {
+      const mode = args[0] as string;
+      this.emit("modeChanged", mode);
+    });
+  }
+
+  /**
+   * Set the current model being edited
+   */
+  setModel(model: THREE.Group | null): void {
+    this.currentModel = model;
+    this.selection.deselect();
+    this.history.clear();
+    this.emit("modelLoaded", model);
+  }
+
+  /**
+   * Get the current model
+   */
+  getModel(): THREE.Group | null {
+    return this.currentModel;
+  }
+
+  /**
+   * Get the currently selected object
+   */
+  getSelected(): THREE.Object3D | null {
+    return this.selection.getSelected();
+  }
+
+  /**
+   * Select an object
+   */
+  select(object: THREE.Object3D | null): void {
+    this.selection.select(object);
+  }
+
+  /**
+   * Execute a command (adds to history)
+   */
+  execute(command: Command): void {
+    this.history.execute(command);
+    this.emit("objectChanged", this.getSelected());
+  }
+
+  /**
+   * Undo the last command
+   */
+  undo(): void {
+    this.history.undo();
+    this.emit("objectChanged", this.getSelected());
+  }
+
+  /**
+   * Redo the last undone command
+   */
+  redo(): void {
+    this.history.redo();
+    this.emit("objectChanged", this.getSelected());
+  }
+
+  /**
+   * Check if undo is available
+   */
+  canUndo(): boolean {
+    return this.history.canUndo();
+  }
+
+  /**
+   * Check if redo is available
+   */
+  canRedo(): boolean {
+    return this.history.canRedo();
+  }
+
+  /**
+   * Set transform mode
+   */
+  setTransformMode(mode: "translate" | "rotate" | "scale"): void {
+    this.transform.setMode(mode);
+  }
+
+  /**
+   * Get current transform mode
+   */
+  getTransformMode(): "translate" | "rotate" | "scale" {
+    return this.transform.getMode();
+  }
+
+  /**
+   * Add event listener
+   */
+  on(event: EditorEvent, callback: EventCallback): void {
+    if (!this.eventListeners.has(event)) {
+      this.eventListeners.set(event, new Set());
+    }
+    this.eventListeners.get(event)!.add(callback);
+  }
+
+  /**
+   * Remove event listener
+   */
+  off(event: EditorEvent, callback: EventCallback): void {
+    this.eventListeners.get(event)?.delete(callback);
+  }
+
+  /**
+   * Emit an event
+   */
+  emit(event: EditorEvent, ...args: unknown[]): void {
+    this.eventListeners.get(event)?.forEach((callback) => callback(...args));
+  }
+
+  /**
+   * Clean up resources
+   */
+  dispose(): void {
+    this.selection.dispose();
+    this.transform.dispose();
+    this.eventListeners.clear();
+  }
+}