[Preview] Triangles and debug pages

packages/core/src/color/lighting.ts

@@ -88,7 +88,7 @@ export function shadeWallFace(base: string, face: keyof WallsMask): string {
   return shadeColor(base, -delta);
 }
 
-export type ShapeType = "ramp" | "wedge" | "spike";
+export type ShapeType = "ramp" | "wedge" | "spike" | "triangle" | "polygon";
 
 interface ShapeSurfaceDefinition {
   id: string;
@@ -113,7 +113,9 @@ const SHAPE_SURFACE_DEFINITIONS: Record<ShapeType, ShapeSurfaceDefinition[]> = {
   spike: [
     { id: "primary", baseAngle: 0 },
     { id: "secondary", baseAngle: 270 }
-  ]
+  ],
+  triangle: [{ id: "primary", baseAngle: 0 }],
+  polygon: [{ id: "primary", baseAngle: 0 }]
 };
 
 const SHAPE_LIGHT_SOURCE_ANGLE = 180;

packages/core/src/controller/sceneController.ts

@@ -1,6 +1,6 @@
 import { createIsometricCamera, normalizeInvertMultiplier } from "../camera/camera";
 import type { CameraHandle, CameraState } from "../camera/camera";
-import type { ProjectionMode, SceneDimensions, WallsMask, Voxel, GridContext, VoxelGrid } from "../types";
+import type { ProjectionMode, SceneDimensions, WallsMask, Voxel, GridContext, VoxelGrid, FaceAppearanceOverride } from "../types";
 import { buildSceneContext, computeWallMask, wallMasksEqual } from "../scene/context";
 import { mergeVoxels as mergeVoxelsGrid } from "../merge/mergeVoxels";
 import { normalizeMergeVoxelsOption, is2dMerge, is3dMerge } from "../merge/mergeVoxelsOption";
@@ -15,6 +15,8 @@ export interface SceneState {
   showFloor: boolean;
   projection: ProjectionMode;
   mergeVoxels?: MergeVoxelsOption;
+  lighting?: (voxel: Voxel, face: string) => FaceAppearanceOverride | undefined;
+  resolveTexture?: (name: string, face: string) => string | undefined;
 }
 
 export type SceneRenderMode = "cubes" | "slice-renderer";
@@ -135,8 +137,10 @@ export function sceneController(options: SceneControllerOptions = {}): SceneCont
     }
 
     const cubeOnly = rawVoxels.every((voxel) => !voxel || (voxel.shape ?? "cube") === "cube");
-    const shouldPreMerge = is2dMerge(mergeOption);
-    const grid = shouldPreMerge ? mergeVoxelsGrid(rawVoxels) : rawVoxels;
+    let grid: VoxelGrid = rawVoxels;
+    if (is2dMerge(mergeOption)) {
+      grid = mergeVoxelsGrid(rawVoxels);
+    }
 
     cachedRawVoxels = rawVoxels;
     cachedRawVoxelsLength = rawVoxels.length;
@@ -157,7 +161,9 @@ export function sceneController(options: SceneControllerOptions = {}): SceneCont
       showFloor: lastState.showFloor,
       projection: lastState.projection,
       rotX: camera.state.rotX,
-      rotY: camera.state.rotY
+      rotY: camera.state.rotY,
+      lighting: lastState.lighting,
+      resolveTexture: lastState.resolveTexture
     },
     dimensions: dimensionOverride
   });
@@ -176,7 +182,9 @@ export function sceneController(options: SceneControllerOptions = {}): SceneCont
         showFloor: state.showFloor,
         projection: state.projection,
         rotX: camera.state.rotX,
-        rotY: camera.state.rotY
+        rotY: camera.state.rotY,
+        lighting: state.lighting,
+        resolveTexture: state.resolveTexture
       },
       dimensions: dimensionOverride
     });
@@ -322,7 +330,9 @@ export function sceneController(options: SceneControllerOptions = {}): SceneCont
       prevState.showWalls !== state.showWalls ||
       prevState.showFloor !== state.showFloor ||
       prevState.projection !== state.projection ||
-      prevState.mergeVoxels !== state.mergeVoxels;
+      prevState.mergeVoxels !== state.mergeVoxels ||
+      prevState.lighting !== state.lighting ||
+      prevState.resolveTexture !== state.resolveTexture;
     if (profile) profile.needsRebuild = needsRebuild;
     if (needsRebuild) {
       const buildStart = profile ? nowMs() : 0;

packages/core/src/index.ts

@@ -1,9 +1,14 @@
 // @layoutit/voxcss-core — Pure-math voxel rendering engine (zero browser globals)
 
 export type {
+  Vec2,
+  Vec3,
   Voxel,
   VoxelGrid,
+  InputVoxel,
+  InputVoxelGrid,
   CubeFace,
+  DirectionalLight,
   GridContext,
   WallsMask,
   OffsetMap,
@@ -16,9 +21,24 @@ export {
   WALL_CLASS, CEILING_CLASS, STYLE_ID
 } from "./types";
 
-export { buildSceneContext, getVoxelBounds, wallMasksEqual, computeWallMask } from "./scene/context";
+export { buildSceneContext, normalizeVoxels, getVoxelBounds, getVoxelZBounds, wallMasksEqual, computeWallMask } from "./scene/context";
 export type { SceneContextBuildResult } from "./scene/context";
-export { computeVisibleFaces } from "./scene/visibility";
+export { computeVisibleFaces, computeFacesWithOcclusion } from "./scene/visibility";
+export { precomputeOcclusion } from "./scene/occlusion";
+export type { OcclusionMap } from "./scene/occlusion";
+export { directionBinFromCamera, directionVectorFromBin, OCCLUSION_DIR_BINS, AZIMUTH_BINS, ELEVATION_BINS } from "./scene/occlusionDirection";
+export { isCovered, isBottomOccluded, shouldRenderBottom } from "./scene/coverage";
+export { voxelToPolygons } from "./scene/polygonModel";
+export type { Polygon } from "./scene/polygonModel";
+export { findGaps } from "./scene/manifoldCheck";
+export type { GapReport } from "./scene/manifoldCheck";
+export { extractExteriorSurface } from "./scene/exteriorSurface";
+export { findGeometricDefects } from "./scene/geometricCheck";
+export type { GeometricDefect } from "./scene/geometricCheck";
+export { simulatedAnnealing, score as scoreVoxels } from "./scene/searchSA";
+export type { SAOptions, SAResult, ScoreBreakdown } from "./scene/searchSA";
+export { computeShapeStyle } from "./shape/shapeStyle";
+export { shapeCoversFullyFace, oppositeFace } from "./shape/coverage";
 
 export { createIsometricCamera, normalizeInvertMultiplier } from "./camera/camera";
 export type { CameraState, CameraHandle, AutoRotateOption, AutoRotateConfig } from "./camera/camera";
@@ -49,10 +69,12 @@ export {
 export type { CubeFaceAppearance } from "./color/faceAppearance";
 
 export { mergeVoxels } from "./merge/mergeVoxels";
+export { mergePolygons } from "./merge/mergePolygons";
 export {
   normalizeMergeVoxelsOption,
   is2dMerge,
-  is3dMerge
+  is3dMerge,
+  isPolyMerge
 } from "./merge/mergeVoxelsOption";
 export type { MergeVoxelsOption } from "./merge/mergeVoxelsOption";
 
@@ -82,6 +104,12 @@ export type {
 
 export { parseMagicaVoxel } from "./parser/parseMagicaVoxel";
 export type { MagicaVoxelParseResult } from "./parser/parseMagicaVoxel";
+export { parseObj } from "./parser/parseObj";
+export type { ObjParseOptions, ObjParseResult } from "./parser/parseObj";
+export { parseMtl } from "./parser/parseMtl";
+export type { MtlParseResult } from "./parser/parseMtl";
+export { parseGltf } from "./parser/parseGltf";
+export type { GltfParseOptions, GltfParseResult } from "./parser/parseGltf";
 
 export {
   encodeRgbaToPng,