@es3d/es3d 1.0.0 → 1.0.2

package/src/index.js

@@ -1,47 +1,47 @@
-// Public API of the ES3D reference implementation.
-//
-//   import { compile, createRenderer, Camera } from '@es3d/es3d';
-//
-//   const result = compile(text);              // parse + validate + build + flatten
-//   if (!result.ok) console.error(result.diagnostics.map((d) => d.format()).join('\n\n'));
-//   const renderer = await createRenderer(canvas);   // WebGPU, else WebGL2
-//   renderer.setScene(result.scene, (entry, lod) => result.cache.mesh(entry, lod));
-//   const camera = new Camera().frame(result.scene.bounds);
-//   renderer.render(camera, { width: canvas.clientWidth, height: canvas.clientHeight });
-//
-//   const svg = await importFiles([{ name: 'logo.svg', bytes }]);   // SVG, OBJ, STL, STEP, glTF → ES3D
-//   const { files } = exportFormat(svg.text, 'glb');                 // ES3D → glTF, OBJ, STL, STEP
-//
-// The format, scene, geometry and I/O modules run in Node as well; only the
-// renderer and controls need a browser.
-
-// documents
-export { parse, parseStrict, detectSyntax, formatDiagnostics } from './format/parse.js';
-export { serialize, SERIALIZE_PRESETS } from './format/serializer.js';
-export { Document, Element, Attr, Comment, walk, h } from './format/ast.js';
-export { Diagnostic, ES3DError } from './format/errors.js';
-export { ELEMENTS, elementSpec, attrSpec } from './format/schema.js';
-
-// scene pipeline
-export { compile, generateGeometry, GeometryCache } from './pipeline.js';
-export { openGeometryStore, indexedDBStore, memoryStore, restoreGeometry, saveGeometry, persistGeometry, geometryKey, GEOMETRY_REVISION } from './cache/geometry-store.js';
-export { RenderScene, updateDynamic, FLAG_MIRRORED, FLAG_NO_COLLIDE } from './scene/flatten.js';
-export { pick, raycast } from './scene/picking.js';
-export { applyLimits, sweepCamera, constrainCamera } from './scene/camera-constraints.js';
-
-// rendering (browser)
-export { createRenderer, Renderer } from './render/renderer.js';
-export { Camera } from './render/camera.js';
-export { OrbitControls } from './render/orbit-controls.js';
-export { ScrollTimeline } from './render/scroll-timeline.js';
-export { createStage, ancestorNames } from './render/stage.js';
-
-// conversion and optimization
-export { importFiles, exportFormat, detectKind, INPUT_KINDS, OUTPUT_FORMATS } from './io/convert.js';
-export { svgToES3D } from './io/svg-import.js';
-export { exportOBJ, parseOBJ, objToScene } from './io/obj.js';
-export { exportGLB, parseGLB, glbToScene, isGLB, parseGLTF, gltfToScene } from './io/gltf.js';
-export { exportSTL, parseSTL, stlToScene } from './io/stl.js';
-export { exportSTEP, parseSTEP, stepToScene, isSTEP } from './io/step.js';
-export { sceneToMeshDocument } from './io/mesh-import.js';
-export { optimize, expandProcedural } from './optimize/optimizer.js';
+// Public API of the ES3D reference implementation.
+//
+//   import { compile, createRenderer, Camera, formatDiagnostics } from '@es3d/es3d';
+//
+//   const result = compile(text);              // parse + validate + build + flatten
+//   if (!result.ok) console.error(formatDiagnostics(result));
+//   const renderer = await createRenderer(canvas);   // WebGPU, else WebGL2
+//   renderer.setScene(result.scene, (entry, lod) => result.cache.mesh(entry, lod));
+//   const camera = new Camera().frame(result.scene.bounds);
+//   renderer.render(camera, { width: canvas.clientWidth, height: canvas.clientHeight });
+//
+//   const svg = await importFiles([{ name: 'logo.svg', bytes }]);   // SVG, OBJ, STL, STEP, glTF → ES3D
+//   const { files } = exportFormat(svg.text, 'glb');                 // ES3D → glTF, OBJ, STL, STEP
+//
+// The format, scene, geometry and I/O modules run in Node as well; only the
+// renderer and controls need a browser.
+
+// documents
+export { parse, parseStrict, detectSyntax, formatDiagnostics } from './format/parse.js';
+export { serialize, SERIALIZE_PRESETS } from './format/serializer.js';
+export { Document, Element, Attr, Comment, walk, h } from './format/ast.js';
+export { Diagnostic, ES3DError } from './format/errors.js';
+export { ELEMENTS, elementSpec, attrSpec } from './format/schema.js';
+
+// scene pipeline
+export { compile, generateGeometry, GeometryCache } from './pipeline.js';
+export { openGeometryStore, indexedDBStore, memoryStore, restoreGeometry, saveGeometry, persistGeometry, geometryKey, GEOMETRY_REVISION } from './cache/geometry-store.js';
+export { RenderScene, updateDynamic, FLAG_MIRRORED, FLAG_NO_COLLIDE } from './scene/flatten.js';
+export { pick, raycast } from './scene/picking.js';
+export { applyLimits, sweepCamera, constrainCamera } from './scene/camera-constraints.js';
+
+// rendering (browser)
+export { createRenderer, Renderer } from './render/renderer.js';
+export { Camera } from './render/camera.js';
+export { OrbitControls } from './render/orbit-controls.js';
+export { ScrollTimeline } from './render/scroll-timeline.js';
+export { createStage, ancestorNames } from './render/stage.js';
+
+// conversion and optimization
+export { importFiles, exportFormat, detectKind, INPUT_KINDS, OUTPUT_FORMATS } from './io/convert.js';
+export { svgToES3D } from './io/svg-import.js';
+export { exportOBJ, parseOBJ, objToScene } from './io/obj.js';
+export { exportGLB, parseGLB, glbToScene, isGLB, parseGLTF, gltfToScene } from './io/gltf.js';
+export { exportSTL, parseSTL, stlToScene } from './io/stl.js';
+export { exportSTEP, parseSTEP, stepToScene, isSTEP } from './io/step.js';
+export { sceneToMeshDocument } from './io/mesh-import.js';
+export { optimize, expandProcedural } from './optimize/optimizer.js';

package/src/io/compression.js

@@ -1,67 +1,67 @@
-// Compression helpers that work in browsers (CompressionStream) and in Node
-// (zlib, which also provides brotli). Used for file-size statistics and the
-// benchmark, and for loading .gz files.
-
-const isNode = typeof process !== 'undefined' && !!(process.versions && process.versions.node) && typeof window === 'undefined';
-
-let zlibPromise = null;
-function zlib() {
-  // Node only; the variable keeps bundlers from trying to resolve it for browsers
-  const specifier = 'node:zlib';
-  if (!zlibPromise) zlibPromise = import(/* @vite-ignore */ specifier);
-  return zlibPromise;
-}
-
-function toBytes(data) {
-  if (typeof data === 'string') return new TextEncoder().encode(data);
-  if (data instanceof Uint8Array) return data;
-  return new Uint8Array(data);
-}
-
-async function streamBytes(bytes, transform) {
-  const stream = new Blob([bytes]).stream().pipeThrough(transform);
-  return new Uint8Array(await new Response(stream).arrayBuffer());
-}
-
-/** gzip (level 9 in Node, browser default otherwise). */
-export async function gzip(data) {
-  const bytes = toBytes(data);
-  if (isNode) {
-    const z = await zlib();
-    return new Uint8Array(z.gzipSync(bytes, { level: 9 }));
-  }
-  return streamBytes(bytes, new CompressionStream('gzip'));
-}
-
-export async function gunzip(data) {
-  const bytes = toBytes(data);
-  if (isNode) {
-    const z = await zlib();
-    return new Uint8Array(z.gunzipSync(bytes));
-  }
-  return streamBytes(bytes, new DecompressionStream('gzip'));
-}
-
-/** Brotli (quality 11). Returns null where unavailable (browsers lack a brotli compressor API). */
-export async function brotli(data) {
-  const bytes = toBytes(data);
-  if (isNode) {
-    const z = await zlib();
-    return new Uint8Array(z.brotliCompressSync(bytes, { params: { [z.constants.BROTLI_PARAM_QUALITY]: 11, [z.constants.BROTLI_PARAM_SIZE_HINT]: bytes.length } }));
-  }
-  try {
-    return await streamBytes(bytes, new CompressionStream('br'));
-  } catch {
-    return null;
-  }
-}
-
-export async function compressedSizes(data) {
-  const bytes = toBytes(data);
-  const [g, b] = await Promise.all([gzip(bytes), brotli(bytes)]);
-  return { raw: bytes.length, gzip: g.length, brotli: b ? b.length : null };
-}
-
-export function isGzip(bytes) {
-  return bytes.length > 2 && bytes[0] === 0x1f && bytes[1] === 0x8b;
-}
+// Compression helpers that work in browsers (CompressionStream) and in Node
+// (zlib, which also provides brotli). Used for file-size statistics and the
+// benchmark, and for loading .gz files.
+
+const isNode = typeof process !== 'undefined' && !!(process.versions && process.versions.node) && typeof window === 'undefined';
+
+let zlibPromise = null;
+function zlib() {
+  // Node only; the variable keeps bundlers from trying to resolve it for browsers
+  const specifier = 'node:zlib';
+  if (!zlibPromise) zlibPromise = import(/* @vite-ignore */ specifier);
+  return zlibPromise;
+}
+
+function toBytes(data) {
+  if (typeof data === 'string') return new TextEncoder().encode(data);
+  if (data instanceof Uint8Array) return data;
+  return new Uint8Array(data);
+}
+
+async function streamBytes(bytes, transform) {
+  const stream = new Blob([bytes]).stream().pipeThrough(transform);
+  return new Uint8Array(await new Response(stream).arrayBuffer());
+}
+
+/** gzip (level 9 in Node, browser default otherwise). */
+export async function gzip(data) {
+  const bytes = toBytes(data);
+  if (isNode) {
+    const z = await zlib();
+    return new Uint8Array(z.gzipSync(bytes, { level: 9 }));
+  }
+  return streamBytes(bytes, new CompressionStream('gzip'));
+}
+
+export async function gunzip(data) {
+  const bytes = toBytes(data);
+  if (isNode) {
+    const z = await zlib();
+    return new Uint8Array(z.gunzipSync(bytes));
+  }
+  return streamBytes(bytes, new DecompressionStream('gzip'));
+}
+
+/** Brotli (quality 11). Returns null where unavailable (browsers lack a brotli compressor API). */
+export async function brotli(data) {
+  const bytes = toBytes(data);
+  if (isNode) {
+    const z = await zlib();
+    return new Uint8Array(z.brotliCompressSync(bytes, { params: { [z.constants.BROTLI_PARAM_QUALITY]: 11, [z.constants.BROTLI_PARAM_SIZE_HINT]: bytes.length } }));
+  }
+  try {
+    return await streamBytes(bytes, new CompressionStream('br'));
+  } catch {
+    return null;
+  }
+}
+
+export async function compressedSizes(data) {
+  const bytes = toBytes(data);
+  const [g, b] = await Promise.all([gzip(bytes), brotli(bytes)]);
+  return { raw: bytes.length, gzip: g.length, brotli: b ? b.length : null };
+}
+
+export function isGzip(bytes) {
+  return bytes.length > 2 && bytes[0] === 0x1f && bytes[1] === 0x8b;
+}