@metamesh/modeling 0.0.0-bootstrap.0 → 0.6.0

package/dist/api/engine.d.ts

@@ -0,0 +1,54 @@
+import type { TriangleMesh } from "@metamesh/modeling/geometry";
+import type { BuildOutput, FinalizedModel, GeometryResolution, ModelingContext, ModelingLimits, FinalizedPart, GeometrySamplingLimits } from "@metamesh/modeling";
+/** Default host resource ceilings for parts, vertices, triangles, and transferable bytes. */
+declare const defaultModelingLimits: Readonly<ModelingLimits>;
+
+
+/** Execution settings supplied by the host, independently of generator metadata. */
+export interface BuildOptions {
+    /** Per-build limits, no larger than the configured engine ceilings. */
+    readonly limits?: Partial<ModelingLimits>;
+    /** Physical sampling defaults; model-derived contexts and exact counts override these. */
+    readonly resolution?: GeometryResolution;
+    /** Optional bounded planar cleanup; unsupported candidates preserve the original part. */
+    readonly meshTopologyMode?: "original" | "optimized";
+}
+/** Host engine. No native values or manually disposable handles are exposed. */
+export interface ModelEngine {
+    /** Immutable resource ceilings selected when this engine was initialized. */
+    readonly limits: ModelingLimits;
+    /** Runs once, finalizes copied parts, and disposes all native values on every exit. */
+    build(build: (model: ModelingContext) => BuildOutput, options?: BuildOptions): FinalizedModel;
+    /** Serializes already finalized mesh parts; never prepares or builds a generator again. */
+    export3mf(parts: readonly ExportMeshPart[], options?: Export3mfOptions): Promise<ArrayBuffer>;
+}
+/** Manufacturing buffers accepted by the snapshot exporter. */
+export interface ExportMeshPart extends TriangleMesh {
+    /** Stable canonical lowercase identity; unique within the containing topology or output. */
+    readonly id: string;
+    /** Optional six-digit hex RGB display color. */
+    readonly color?: string;
+}
+/** Completed-snapshot serialization settings; filename selection belongs to the host. */
+export interface Export3mfOptions {
+    /** Document display name; defaults to MetaMesh model. */
+    readonly name?: string;
+}
+/** Kernel asset initialization. Networking and Worker ownership remain with the host. */
+export interface ModelEngineOptions {
+    /** Resolves the kernel's WASM asset. Browser hosts supply their bundled asset URL. */
+    readonly locateFile?: () => string;
+    /** Trusted application ceilings. Builds may lower them; generators receive no engine. */
+    readonly limits?: Partial<ModelingLimits>;
+}
+
+
+
+
+export { defaultModelingLimits };
+/** URL of the package's pinned WASM asset; browser bundlers may replace it with their emitted URL. */
+export declare const modelingWasmUrl: string;
+
+/** Initializes one host kernel and returns a lifecycle-safe engine. No generator initializes WASM. */
+export declare function createModelEngine(options?: ModelEngineOptions): Promise<ModelEngine>;
+export type { BuildOutput, FinalizedModel, FinalizedPart, ModelingContext, ModelingLimits, GeometryResolution, GeometrySamplingLimits, };