@forgeax/engine-geometry 0.1.2

package/dist/assets/mesh-decoder.d.ts

@@ -0,0 +1,6 @@
+import { type AssetDecoder, type AssetDecoderContribution, type AssetKind, type MeshAsset } from '@forgeax/engine-types';
+export declare const meshAssetKind: AssetKind<MeshAsset, 'mesh'>;
+/** Geometry validates mesh payload shape before any render owner consumes it. */
+export declare const meshAssetDecoder: AssetDecoder<MeshAsset>;
+export declare const meshAssetContribution: AssetDecoderContribution<MeshAsset, 'mesh'>;
+//# sourceMappingURL=mesh-decoder.d.ts.map

package/dist/assets/mesh-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-decoder.d.ts","sourceRoot":"","sources":["../../src/assets/mesh-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EAGd,KAAK,SAAS,EAGf,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,SAAS,EAAE,MAAM,CAEtB,CAAC;AA2BlC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,SAAS,CA+CpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAI7E,CAAC"}

package/dist/assets/primitive-mesh.d.ts

@@ -0,0 +1,5 @@
+import type { AssetError, MeshAsset, Result } from '@forgeax/engine-types';
+export type PrimitiveMeshKind = 'cube' | 'triangle' | 'quad' | 'sphere' | 'cylinder' | 'nine-slice-quad';
+/** Create one ordinary mesh payload for allocation or interning by an owning World. */
+export declare function createPrimitiveMesh(kind: PrimitiveMeshKind): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=primitive-mesh.d.ts.map

package/dist/assets/primitive-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-mesh.d.ts","sourceRoot":"","sources":["../../src/assets/primitive-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM3E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,iBAAiB,CAAC;AAEtB,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAoB1F"}

package/dist/box.d.ts

@@ -0,0 +1,41 @@
+import { AssetError, type MeshAsset, type Result } from '@forgeax/engine-types';
+/**
+ * Floats per vertex for the procedural-geometry interleaved buffer that the
+ * factory bodies fill in (position(3) + normal(3) + uv(2)). The
+ * `meshFromInterleaved` helper expands this into the runtime 12-float
+ * (position + normal + uv + tangent) layout consumed by the standard
+ * pipeline (feat-20260518 M4 D-10).
+ */
+export declare const FACTORY_FLOATS_PER_VERTEX = 8;
+/**
+ * Floats per vertex emitted by the factories' final MeshAsset
+ * `vertices` Float32Array buffer: position(3) + normal(3) + uv(2) +
+ * tangent(4) = 12. Procedural meshes feed both the standard and unlit
+ * pipelines (D-10); BUILTIN_CUBE / TRIANGLE keep their 6-floats inline
+ * shape (D-2 lock).
+ */
+export declare const PROCEDURAL_FLOATS_PER_VERTEX = 12;
+/**
+ * Shared helper: build MeshAsset POD from the factory-emitted 8-floats
+ * interleaved buffer (position + normal + uv) plus index list. Computes
+ * per-vertex tangent (vec4) via `computeTangentVec4` (M4 / D-2 path A) and
+ * expands the buffer to the runtime 12-floats stride (position + normal +
+ * uv + tangent). All six procedural factories funnel through this helper
+ * so the tangent SSOT lives in `geometry/tangent.ts` (D-7).
+ */
+export declare function meshFromInterleaved(vertices: Float32Array, indices: Uint16Array | Uint32Array): Result<MeshAsset, AssetError>;
+/** Shared helper: AssetError for degenerate geometry parameters. */
+export declare function degenerate(detail: string): AssetError;
+/**
+ * Build a procedural box geometry aligned with Three.js r184 BoxGeometry.
+ *
+ * @param width positive X-axis extent
+ * @param height positive Y-axis extent
+ * @param depth positive Z-axis extent
+ * @param widthSegments >= 1 subdivisions along X
+ * @param heightSegments >= 1 subdivisions along Y
+ * @param depthSegments >= 1 subdivisions along Z
+ * @returns `Result<MeshAsset, AssetError>` with attributes populated
+ */
+export declare function createBoxGeometry(width: number, height: number, depth: number, widthSegments?: number, heightSegments?: number, depthSegments?: number): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=box.d.ts.map

package/dist/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../src/box.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,UAAU,EAEV,KAAK,SAAS,EAEd,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAI/B;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAsD/C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,WAAW,GAAG,WAAW,GACjC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CA0F/B;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAMrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAU,EACzB,cAAc,GAAE,MAAU,EAC1B,aAAa,GAAE,MAAU,GACxB,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CA2M/B"}

package/dist/capsule.d.ts

@@ -0,0 +1,14 @@
+import type { AssetError, MeshAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+/**
+ * Build a procedural capsule geometry aligned with Bevy `Capsule3d` /
+ * Three.js r184 CapsuleGeometry.
+ *
+ * @param radius hemisphere + cylinder radius (> 0)
+ * @param length cylinder mid-section height (>= 0; total height = length + 2*radius)
+ * @param capSegments latitude bands per hemisphere (>= 1); default 4
+ * @param radialSegments longitudes around the axis (>= 3); default 8
+ * @returns `Result<MeshAsset, AssetError>` with attributes populated
+ */
+export declare function createCapsuleGeometry(radius: number, length: number, capSegments?: number, radialSegments?: number): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=capsule.d.ts.map

package/dist/capsule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule.d.ts","sourceRoot":"","sources":["../src/capsule.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGzD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,MAAU,GACzB,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAuG/B"}

package/dist/cone.d.ts

@@ -0,0 +1,4 @@
+import type { AssetError, MeshAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+export declare function createConeGeometry(radius: number, height: number, radialSegments?: number, heightSegments?: number): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=cone.d.ts.map

package/dist/cone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cone.d.ts","sourceRoot":"","sources":["../src/cone.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIzD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAW,EAC3B,cAAc,GAAE,MAAU,GACzB,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAI/B"}

package/dist/cylinder.d.ts

@@ -0,0 +1,4 @@
+import type { AssetError, MeshAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+export declare function createCylinderGeometry(radiusTop: number, radiusBottom: number, height: number, radialSegments?: number, heightSegments?: number): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=cylinder.d.ts.map

package/dist/cylinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cylinder.d.ts","sourceRoot":"","sources":["../src/cylinder.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGzD,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,MAAW,EAC3B,cAAc,GAAE,MAAU,GACzB,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CA4J/B"}

package/dist/dim2.d.ts

@@ -0,0 +1,73 @@
+import { box2, circle2 } from '@forgeax/engine-math';
+import type { AssetError, MeshAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+export type Vec2 = readonly [number, number];
+export type Shape2d = {
+    readonly kind: 'circle';
+    readonly radius: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'circular-sector';
+    readonly radius: number;
+    readonly angle: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'circular-segment';
+    readonly radius: number;
+    readonly angle: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'ellipse';
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'annulus';
+    readonly innerRadius: number;
+    readonly outerRadius: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'capsule';
+    readonly radius: number;
+    readonly halfLength: number;
+    readonly resolution?: number;
+} | {
+    readonly kind: 'rhombus';
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+} | {
+    readonly kind: 'rectangle';
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly kind: 'regular-polygon';
+    readonly radius: number;
+    readonly sides: number;
+} | {
+    readonly kind: 'triangle';
+    readonly vertices: readonly [Vec2, Vec2, Vec2];
+} | {
+    readonly kind: 'segment';
+    readonly vertices: readonly [Vec2, Vec2];
+} | {
+    readonly kind: 'polyline';
+    readonly vertices: readonly Vec2[];
+};
+export type Shape2dPose = {
+    readonly translation?: Vec2;
+    readonly rotation?: number;
+};
+export type Shape2dMeshOptions = {
+    readonly uv?: {
+        readonly kind: 'circular-mask';
+        readonly angle: number;
+    };
+};
+export type Shape2dBounds = {
+    readonly aabb: box2.Box2;
+    readonly circle: circle2.Circle2;
+};
+export declare function create2dGeometry(shape: Shape2d, options?: Shape2dMeshOptions): Result<MeshAsset, AssetError>;
+export declare function compute2dBounds(shape: Shape2d, pose?: Shape2dPose): Result<Shape2dBounds, AssetError>;
+export declare function create2dRingGeometry(shape: Shape2d, thickness: number, resolutionOverride?: number): Result<MeshAsset, AssetError>;
+//# sourceMappingURL=dim2.d.ts.map

package/dist/dim2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dim2.d.ts","sourceRoot":"","sources":["../src/dim2.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { VertexAttributePackDetail } from '@forgeax/engine-types';
+export { meshAssetContribution, meshAssetDecoder, meshAssetKind } from './assets/mesh-decoder';
+export { createPrimitiveMesh, type PrimitiveMeshKind } from './assets/primitive-mesh';
+export { createBoxGeometry, meshFromInterleaved, PROCEDURAL_FLOATS_PER_VERTEX, } from './box';
+export { createCapsuleGeometry } from './capsule';
+export { createConeGeometry } from './cone';
+export { createCylinderGeometry } from './cylinder';
+export { compute2dBounds, create2dGeometry, create2dRingGeometry, type Shape2d, type Shape2dBounds, type Shape2dMeshOptions, type Shape2dPose, type Vec2, } from './dim2';
+export { createPlaneGeometry } from './plane';
+export { createSphereGeometry } from './sphere';
+export { computeTangentVec4 } from './tangent';
+export { createTorusGeometry } from './torus';
+export { buildMeshAttributeMapForUvSets, deriveVertexBufferLayout, deriveVertexBufferLayoutFromProjection, deriveVertexLayoutProjection, deriveVertexLayoutProjectionFromMask, type GpuVertexBufferLayoutEntry, type PackedVertexAttributes, packInterleavedVertexAttributes, VertexAttributePackError, type VertexLayoutProjection, type VertexLayoutProjectionAttribute, type VertexLayoutProjectionMaskError, } from './vertex-attribute-layout';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,sCAAsC,EACtC,4BAA4B,EAC5B,oCAAoC,EACpC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,2BAA2B,CAAC"}