brepjs 18.69.0 → 18.69.1

package/dist/brepjs.cjs

@@ -26,7 +26,7 @@ const require_measureFns = require("./measureFns-CrSEblGG.cjs");
 const require_cornerFinder = require("./cornerFinder-tTS3ny7e.cjs");
 const require_boolean2D = require("./boolean2D-xDBZQH_n.cjs");
 const require_blueprintFns = require("./blueprintFns-DULa6FpG.cjs");
-const require_importFns = require("./importFns-CwILDYiQ.cjs");
+const require_importFns = require("./importFns-8zgPWa83.cjs");
 const require_extrudeFns = require("./extrudeFns-IvYW5-8y.cjs");
 const require_cameraFns = require("./cameraFns-Bk8frXwa.cjs");
 const require_textMetrics = require("./textMetrics-CnCjqf59.cjs");

package/dist/brepjs.js

@@ -24,7 +24,7 @@ import { a as measureDistance, c as measureLinearProps, d as measureVolumeProps,
 import { t as cornerFinder } from "./cornerFinder-B8GvvW0U.js";
 import { a as fuseBlueprints, c as roundedRectangleBlueprint, i as cutBlueprints, n as fuse2D, o as intersectBlueprints, r as intersect2D, s as polysidesBlueprint, t as cut2D } from "./boolean2D-BNWuFXK_.js";
 import { S as reverseCurve, _ as curve2dIsOnCurve, a as isInside2D, b as curve2dSplitAt, c as scale2D, d as stretch2D, f as toSVGPathD, g as curve2dFirstPoint, h as curve2dDistanceFrom, i as getOrientation2D, l as sketchOnFace2D, m as curve2dBoundingBox, n as createCompoundBlueprint, o as mirror2D, p as translate2D, r as getBounds2D, s as rotate2D, t as createBlueprint, u as sketchOnPlane2D, v as curve2dLastPoint, x as curve2dTangentAt, y as curve2dParameter } from "./blueprintFns-BNhsXv6q.js";
-import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-1SHLSNtG.js";
+import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-BAJm4qfD.js";
 import { a as guidedSweep, c as sweep$1, i as complexExtrude, l as twistExtrude, n as extrudeAll, o as multiSectionSweep, r as revolve$1, s as supportExtrude, t as extrude$1 } from "./extrudeFns-CMr1tf7I.js";
 import { a as Sketch, b as loftAll, c as compoundSketchLoft, d as sketchFace, f as sketchLoft, h as sketchWires, i as Sketches, l as compoundSketchRevolve, m as sketchSweep, n as getFont, o as compoundSketchExtrude, p as sketchRevolve, r as loadFont, s as compoundSketchFace, t as textBlueprints, u as sketchExtrude, v as CompoundSketch, y as loft$1 } from "./textBlueprints-BXGrW7Ak.js";
 import { a as makeProjectedEdges, i as projectEdges, n as cameraLookAt, r as createCamera, s as isProjectionPlane, t as cameraFromPlane } from "./cameraFns-k787od3u.js";

package/dist/{importFns-CwILDYiQ.cjs → importFns-8zgPWa83.cjs}

@@ -61,6 +61,24 @@ var FLOAT = 5126;
 var UNSIGNED_INT = 5125;
 var ARRAY_BUFFER = 34962;
 var ELEMENT_ARRAY_BUFFER = 34963;
+var Y_UP_QUAT = [
+	-Math.SQRT1_2,
+	0,
+	0,
+	Math.SQRT1_2
+];
+/**
+* Scene-graph nodes for the single mesh. For Y-up (default) the mesh node is
+* parented under a rotation node so the Z-up vertices display upright in glTF
+* viewers; for Z-up the mesh node is the root with no transform.
+*/
+function sceneNodes(upAxis) {
+	return upAxis === "Z" ? [{ mesh: 0 }] : [{
+		name: "Z_up_to_Y_up",
+		rotation: Y_UP_QUAT,
+		children: [1]
+	}, { mesh: 0 }];
+}
 function computeMinMax(data) {
 	const min = [
 		Infinity,
@@ -209,7 +227,7 @@ function buildSingleBufferViews(indicesByteLength, verticesByteLength, normalsBy
 function buildGltfDocument(mesh, mode, options) {
 	const { vertices, normals, triangles } = mesh;
 	const materialMap = options?.materials;
-	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) return buildGltfDocumentWithMaterials(mesh, mode, materialMap);
+	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) return buildGltfDocumentWithMaterials(mesh, mode, materialMap, options.upAxis ?? "Y");
 	const indicesByteLength = triangles.byteLength;
 	const verticesByteLength = vertices.byteLength;
 	const normalsByteLength = normals.byteLength;
@@ -222,7 +240,7 @@ function buildGltfDocument(mesh, mode, options) {
 		},
 		scene: 0,
 		scenes: [{ nodes: [0] }],
-		nodes: [{ mesh: 0 }],
+		nodes: sceneNodes(options?.upAxis ?? "Y"),
 		meshes: [{ primitives: [{
 			attributes: {
 				POSITION: 1,
@@ -250,14 +268,14 @@ function buildGltfDocument(mesh, mode, options) {
 function buildGlbData(mesh, options) {
 	const materialMap = options?.materials;
 	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) {
-		const { doc, binBuffer } = buildGltfDocumentAndBufferWithMaterials(mesh, materialMap);
+		const { doc, binBuffer } = buildGltfDocumentAndBufferWithMaterials(mesh, materialMap, options.upAxis ?? "Y");
 		return {
 			doc,
 			binBuffer
 		};
 	}
 	return {
-		doc: buildGltfDocument(mesh, "glb"),
+		doc: buildGltfDocument(mesh, "glb", options),
 		binBuffer: buildBinaryBuffer(mesh)
 	};
 }
@@ -413,11 +431,12 @@ function appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx,
 /**
 * Build a glTF document from material layout.
 */
-function buildGltfDocFromLayout(mesh, layout) {
+function buildGltfDocFromLayout(mesh, layout, upAxis = "Y") {
 	const { primitiveData, indexBufferInfos, verticesOffset, totalByteLength, uniqueMaterials } = layout;
 	const accessors = [];
 	const bufferViews = [];
 	const { verticesAccIdx, normalsAccIdx } = appendVertexNormalSections(mesh, verticesOffset, accessors, bufferViews);
+	const primitives = appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx, normalsAccIdx, accessors, bufferViews);
 	return {
 		asset: {
 			version: "2.0",
@@ -425,8 +444,8 @@ function buildGltfDocFromLayout(mesh, layout) {
 		},
 		scene: 0,
 		scenes: [{ nodes: [0] }],
-		nodes: [{ mesh: 0 }],
-		meshes: [{ primitives: appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx, normalsAccIdx, accessors, bufferViews) }],
+		nodes: sceneNodes(upAxis),
+		meshes: [{ primitives }],
 		accessors,
 		bufferViews,
 		buffers: [{ byteLength: totalByteLength }],
@@ -453,9 +472,9 @@ function buildBinaryBufferFromLayout(mesh, layout) {
 /**
 * Build a glTF document with per-material primitives (base64 mode).
 */
-function buildGltfDocumentWithMaterials(mesh, _mode, materialMap) {
+function buildGltfDocumentWithMaterials(mesh, _mode, materialMap, upAxis = "Y") {
 	const layout = computeMaterialLayout(mesh, materialMap);
-	const doc = buildGltfDocFromLayout(mesh, layout);
+	const doc = buildGltfDocFromLayout(mesh, layout, upAxis);
 	if (_mode === "base64") {
 		const buffer = buildBinaryBufferFromLayout(mesh, layout);
 		doc.buffers[0] = {
@@ -468,10 +487,10 @@ function buildGltfDocumentWithMaterials(mesh, _mode, materialMap) {
 /**
 * Build both glTF document and binary buffer for GLB with materials.
 */
-function buildGltfDocumentAndBufferWithMaterials(mesh, materialMap) {
+function buildGltfDocumentAndBufferWithMaterials(mesh, materialMap, upAxis = "Y") {
 	const layout = computeMaterialLayout(mesh, materialMap);
 	return {
-		doc: buildGltfDocFromLayout(mesh, layout),
+		doc: buildGltfDocFromLayout(mesh, layout, upAxis),
 		binBuffer: buildBinaryBufferFromLayout(mesh, layout)
 	};
 }

package/dist/{importFns-1SHLSNtG.js → importFns-BAJm4qfD.js}

@@ -61,6 +61,24 @@ var FLOAT = 5126;
 var UNSIGNED_INT = 5125;
 var ARRAY_BUFFER = 34962;
 var ELEMENT_ARRAY_BUFFER = 34963;
+var Y_UP_QUAT = [
+	-Math.SQRT1_2,
+	0,
+	0,
+	Math.SQRT1_2
+];
+/**
+* Scene-graph nodes for the single mesh. For Y-up (default) the mesh node is
+* parented under a rotation node so the Z-up vertices display upright in glTF
+* viewers; for Z-up the mesh node is the root with no transform.
+*/
+function sceneNodes(upAxis) {
+	return upAxis === "Z" ? [{ mesh: 0 }] : [{
+		name: "Z_up_to_Y_up",
+		rotation: Y_UP_QUAT,
+		children: [1]
+	}, { mesh: 0 }];
+}
 function computeMinMax(data) {
 	const min = [
 		Infinity,
@@ -209,7 +227,7 @@ function buildSingleBufferViews(indicesByteLength, verticesByteLength, normalsBy
 function buildGltfDocument(mesh, mode, options) {
 	const { vertices, normals, triangles } = mesh;
 	const materialMap = options?.materials;
-	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) return buildGltfDocumentWithMaterials(mesh, mode, materialMap);
+	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) return buildGltfDocumentWithMaterials(mesh, mode, materialMap, options.upAxis ?? "Y");
 	const indicesByteLength = triangles.byteLength;
 	const verticesByteLength = vertices.byteLength;
 	const normalsByteLength = normals.byteLength;
@@ -222,7 +240,7 @@ function buildGltfDocument(mesh, mode, options) {
 		},
 		scene: 0,
 		scenes: [{ nodes: [0] }],
-		nodes: [{ mesh: 0 }],
+		nodes: sceneNodes(options?.upAxis ?? "Y"),
 		meshes: [{ primitives: [{
 			attributes: {
 				POSITION: 1,
@@ -250,14 +268,14 @@ function buildGltfDocument(mesh, mode, options) {
 function buildGlbData(mesh, options) {
 	const materialMap = options?.materials;
 	if (materialMap && materialMap.size > 0 && mesh.faceGroups.length > 0) {
-		const { doc, binBuffer } = buildGltfDocumentAndBufferWithMaterials(mesh, materialMap);
+		const { doc, binBuffer } = buildGltfDocumentAndBufferWithMaterials(mesh, materialMap, options.upAxis ?? "Y");
 		return {
 			doc,
 			binBuffer
 		};
 	}
 	return {
-		doc: buildGltfDocument(mesh, "glb"),
+		doc: buildGltfDocument(mesh, "glb", options),
 		binBuffer: buildBinaryBuffer(mesh)
 	};
 }
@@ -413,11 +431,12 @@ function appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx,
 /**
 * Build a glTF document from material layout.
 */
-function buildGltfDocFromLayout(mesh, layout) {
+function buildGltfDocFromLayout(mesh, layout, upAxis = "Y") {
 	const { primitiveData, indexBufferInfos, verticesOffset, totalByteLength, uniqueMaterials } = layout;
 	const accessors = [];
 	const bufferViews = [];
 	const { verticesAccIdx, normalsAccIdx } = appendVertexNormalSections(mesh, verticesOffset, accessors, bufferViews);
+	const primitives = appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx, normalsAccIdx, accessors, bufferViews);
 	return {
 		asset: {
 			version: "2.0",
@@ -425,8 +444,8 @@ function buildGltfDocFromLayout(mesh, layout) {
 		},
 		scene: 0,
 		scenes: [{ nodes: [0] }],
-		nodes: [{ mesh: 0 }],
-		meshes: [{ primitives: appendIndexPrimitives(primitiveData, indexBufferInfos, verticesAccIdx, normalsAccIdx, accessors, bufferViews) }],
+		nodes: sceneNodes(upAxis),
+		meshes: [{ primitives }],
 		accessors,
 		bufferViews,
 		buffers: [{ byteLength: totalByteLength }],
@@ -453,9 +472,9 @@ function buildBinaryBufferFromLayout(mesh, layout) {
 /**
 * Build a glTF document with per-material primitives (base64 mode).
 */
-function buildGltfDocumentWithMaterials(mesh, _mode, materialMap) {
+function buildGltfDocumentWithMaterials(mesh, _mode, materialMap, upAxis = "Y") {
 	const layout = computeMaterialLayout(mesh, materialMap);
-	const doc = buildGltfDocFromLayout(mesh, layout);
+	const doc = buildGltfDocFromLayout(mesh, layout, upAxis);
 	if (_mode === "base64") {
 		const buffer = buildBinaryBufferFromLayout(mesh, layout);
 		doc.buffers[0] = {
@@ -468,10 +487,10 @@ function buildGltfDocumentWithMaterials(mesh, _mode, materialMap) {
 /**
 * Build both glTF document and binary buffer for GLB with materials.
 */
-function buildGltfDocumentAndBufferWithMaterials(mesh, materialMap) {
+function buildGltfDocumentAndBufferWithMaterials(mesh, materialMap, upAxis = "Y") {
 	const layout = computeMaterialLayout(mesh, materialMap);
 	return {
-		doc: buildGltfDocFromLayout(mesh, layout),
+		doc: buildGltfDocFromLayout(mesh, layout, upAxis),
 		binBuffer: buildBinaryBufferFromLayout(mesh, layout)
 	};
 }

package/dist/index.d.ts

@@ -33,7 +33,7 @@ export { reverseCurve, curve2dBoundingBox, curve2dFirstPoint, curve2dLastPoint,
 export { createBlueprint, createCompoundBlueprint, getBounds2D, getOrientation2D, isInside2D, toSVGPathD, translate2D, rotate2D, scale2D, mirror2D, stretch2D, sketchOnPlane2D, sketchOnFace2D, } from './2d/blueprints/blueprintFns.js';
 export { getSingleFace, type SingleFace } from './query/helpers.js';
 export { exportOBJ } from './io/objExportFns.js';
-export { exportGltf, exportGlb, type GltfMaterial, type GltfExportOptions, } from './io/gltfExportFns.js';
+export { exportGltf, exportGlb, type GltfMaterial, type GltfExportOptions, type GltfFace, type MaterialFn, } from './io/gltfExportFns.js';
 export { exportDXF, blueprintToDXF, type DXFEntity, type DXFExportOptions, } from './io/dxfExportFns.js';
 export { exportThreeMF, type ThreeMFExportOptions, type ThreeMFMaterial, } from './io/threemfExportFns.js';
 export { importSVGPathD, importSVG, type SVGImportOptions } from './io/svgImportFns.js';

package/dist/io/gltfExportFns.d.ts

@@ -14,6 +14,23 @@ export interface GltfMaterial {
     /** Roughness factor 0–1. Default: 0.5 */
     roughness?: number;
 }
+/**
+ * A meshed face as presented to a {@link MaterialFn} — its stable id and the
+ * centroid of its triangles in part coordinates (Z-up, mm).
+ */
+export interface GltfFace {
+    /** Stable face identifier — matches ShapeMesh.faceGroups[].faceId. */
+    faceId: number;
+    /** Centroid of the face's vertices, in part (Z-up, mm) coordinates. */
+    center: [number, number, number];
+}
+/**
+ * Per-face material selector. Called once per face group; return a material to
+ * paint that face, or `undefined` to leave it at the glTF default. Consumed by
+ * tooling (e.g. brepjs-verify's `export const materials`) that has the mesh and
+ * builds the faceId→material map passed to {@link GltfExportOptions.materials}.
+ */
+export type MaterialFn = (face: GltfFace) => GltfMaterial | undefined;
 /**
  * Options for glTF/GLB export.
  *
@@ -23,6 +40,14 @@ export interface GltfMaterial {
 export interface GltfExportOptions {
     /** Map of faceId → material. FaceIds come from ShapeMesh.faceGroups[].faceId. */
     materials?: Map<number, GltfMaterial>;
+    /**
+     * Up-axis of the emitted document. brepjs geometry is Z-up (CAD convention),
+     * but glTF 2.0 mandates Y-up. With `'Y'` (the default) a root node carrying a
+     * −90° rotation about X is emitted so the part stands upright in standard glTF
+     * viewers (three.js, model-viewer, Blender); vertex data stays Z-up, matching
+     * the STEP/STL exports. Use `'Z'` to emit raw Z-up coordinates with no root node.
+     */
+    upAxis?: 'Y' | 'Z';
 }
 /**
  * Export a ShapeMesh to a glTF 2.0 JSON string with an embedded base64 buffer.

package/dist/io.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_meshFns = require("./meshFns-DwHAYqRN.cjs");
-const require_importFns = require("./importFns-CwILDYiQ.cjs");
+const require_importFns = require("./importFns-8zgPWa83.cjs");
 exports.blueprintToDXF = require_importFns.blueprintToDXF;
 exports.exportDXF = require_importFns.exportDXF;
 exports.exportGlb = require_importFns.exportGlb;

package/dist/io.d.ts

@@ -9,7 +9,7 @@
 export { importSTEP, importSTL, importIGES } from './io/importFns.js';
 export { exportSTEP, exportSTL, exportIGES } from './topology/meshFns.js';
 export { exportOBJ } from './io/objExportFns.js';
-export { exportGltf, exportGlb, type GltfMaterial, type GltfExportOptions, } from './io/gltfExportFns.js';
+export { exportGltf, exportGlb, type GltfMaterial, type GltfExportOptions, type GltfFace, type MaterialFn, } from './io/gltfExportFns.js';
 export { exportDXF, blueprintToDXF, type DXFEntity, type DXFExportOptions, } from './io/dxfExportFns.js';
 export { exportThreeMF, type ThreeMFExportOptions, type ThreeMFMaterial, } from './io/threemfExportFns.js';
 export { importSVGPathD, importSVG, type SVGImportOptions } from './io/svgImportFns.js';

package/dist/io.js

@@ -1,3 +1,3 @@
 import { n as exportSTEP, r as exportSTL, t as exportIGES } from "./meshFns-0RHalM3t.js";
-import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-1SHLSNtG.js";
+import { a as importSVG, c as blueprintToDXF, d as exportGltf, f as exportOBJ, i as exportSTEPConfigured, l as exportDXF, n as importSTEP, o as importSVGPathD, r as importSTL, s as exportThreeMF, t as importIGES, u as exportGlb } from "./importFns-BAJm4qfD.js";
 export { blueprintToDXF, exportDXF, exportGlb, exportGltf, exportIGES, exportOBJ, exportSTEP, exportSTEPConfigured, exportSTL, exportThreeMF, importIGES, importSTEP, importSTL, importSVG, importSVGPathD };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs",
-  "version": "18.69.0",
+  "version": "18.69.1",
   "description": "Web CAD library with pluggable geometry kernel",
   "keywords": [
     "cad",