@metamesh/modeling 0.17.0 → 0.19.0

package/dist/docs/reference/text/VectorTextLayoutOptions.md

@@ -1,111 +0,0 @@
-# VectorTextLayoutOptions
-
-Text bounded to 512 UTF-16 units: horizontal lines or one circular line without wrapping.
-
-## Extends
-
-- [`VectorTextOptions`](VectorTextOptions.md)
-
-## Properties
-
-### align?
-
-
-
-`readonly` `optional` **align?**: `"center"` \| `"left"` \| `"right"`
-
-
-
-Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
-
-***
-
-### baseline?
-
-
-
-`readonly` `optional` **baseline?**: [`VectorTextArcBaseline`](VectorTextArcBaseline.md)
-
-
-
-Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
-
-***
-
-### lineHeight?
-
-
-
-`readonly` `optional` **lineHeight?**: `number`
-
-
-
-Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
-
-***
-
-### verticalAlign?
-
-
-
-`readonly` `optional` **verticalAlign?**: `"center"` \| `"top"` \| `"bottom"` \| `"baseline"`
-
-
-
-Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
-
-***
-
-### fontSize
-
-
-
-`readonly` **fontSize**: `number`
-
-
-
-Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
-
-#### Inherited from
-
-[`VectorTextOptions`](VectorTextOptions.md).[`fontSize`](VectorTextOptions.md#fontsize)
-
-***
-
-### fontWeight?
-
-
-
-`readonly` `optional` **fontWeight?**: `number`
-
-
-
-Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
-
-#### Inherited from
-
-[`VectorTextOptions`](VectorTextOptions.md).[`fontWeight`](VectorTextOptions.md#fontweight)
-
-***
-
-### letterSpacing?
-
-
-
-`readonly` `optional` **letterSpacing?**: `number`
-
-
-
-Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
-
-#### Inherited from
-
-[`VectorTextOptions`](VectorTextOptions.md).[`letterSpacing`](VectorTextOptions.md#letterspacing)
-
-
-## Related APIs
-
-- [VectorTextArcBaseline](VectorTextArcBaseline.md)
-- [VectorTextOptions](VectorTextOptions.md)
-
-Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/text/VectorTextMetrics.md

@@ -1,94 +0,0 @@
-# VectorTextMetrics
-
-Text measurements from the same immutable layout that supplies geometry and SVG outlines.
-
-## Properties
-
-### bounds
-
-
-
-`readonly` **bounds**: [`Bounds2Data`](Bounds2Data.md) \| `null`
-
-
-
-Visible curve bounds after alignment, or null when the text has no ink.
-
-***
-
-### advance
-
-
-
-`readonly` **advance**: readonly \[`number`, `number`\]
-
-
-
-Unaligned logical advance and negative baseline displacement in mm; arcs retain [arc length, 0].
-
-***
-
-### logicalWidth
-
-
-
-`readonly` **logicalWidth**: `number`
-
-
-
-Maximum logical line advance in millimetres, including spaces; arc length on circular baselines.
-
-***
-
-### ascent
-
-
-
-`readonly` **ascent**: `number`
-
-
-
-Selected font's ascender distance above a baseline in millimetres, independent of the text.
-
-***
-
-### descent
-
-
-
-`readonly` **descent**: `number`
-
-
-
-Selected font's descender distance below a baseline in millimetres, a non-negative value.
-
-***
-
-### lineHeight
-
-
-
-`readonly` **lineHeight**: `number`
-
-
-
-Actual distance between baselines in millimetres.
-
-***
-
-### lineCount
-
-
-
-`readonly` **lineCount**: `number`
-
-
-
-Number of lines, including empty and trailing lines; empty text occupies one line.
-
-
-## Related APIs
-
-- [Bounds2Data](Bounds2Data.md)
-
-Package: `@metamesh/modeling@0.17.0`.

package/dist/docs/reference/text/VectorTextOptions.md

@@ -1,50 +0,0 @@
-# VectorTextOptions
-
-Shaping controls for a prepared exact font face; all lengths are in millimetres.
-
-## Extended by
-
-- [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)
-
-## Properties
-
-### fontSize
-
-
-
-`readonly` **fontSize**: `number`
-
-
-
-Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
-
-***
-
-### fontWeight?
-
-
-
-`readonly` `optional` **fontWeight?**: `number`
-
-
-
-Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
-
-***
-
-### letterSpacing?
-
-
-
-`readonly` `optional` **letterSpacing?**: `number`
-
-
-
-Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
-
-
-## Related APIs
-
-- [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
-
-Package: `@metamesh/modeling@0.17.0`.

package/dist/engine/export-3mf.js

@@ -1,116 +0,0 @@
-import { Zip, ZipDeflate } from "fflate";
-import { GeometryError } from "../geometry/errors.js";
-import { analyzeSolidMesh } from "../geometry/mesh/mesh-solid.js";
-import { analyzeTriangleMesh } from "../geometry/mesh/mesh.js";
-import { MeshViewCache } from "./mesh-view-cache.js";
-const namespace = "http://schemas.microsoft.com/3dmanufacturing/core/2015/02";
-const declaration = '<?xml version="1.0" encoding="UTF-8"?>';
-const encoder = new TextEncoder();
-const escapeXml = (value) => value.replace(/[&<>"']/g, (character) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[character]);
-/** Private core 3MF serializer. It preserves the selected buffers and streams bounded XML chunks. */
-export function meshesTo3mf(parts, options) {
-    if (options.meshValidation !== undefined &&
-        options.meshValidation !== "topology" &&
-        options.meshValidation !== "solid")
-        throw new GeometryError("INVALID_ARGUMENT", "Unsupported mesh validation mode.", {
-            operation: "export3mf",
-        });
-    const name = options.name ?? "MetaMesh model";
-    if (typeof name !== "string" ||
-        name.length === 0 ||
-        name.length > 1024 ||
-        // eslint-disable-next-line no-control-regex -- XML 1.0 disallows these control characters.
-        /[\u0000-\u0008\u000b\u000c\u000e-\u001f\ud800-\udfff\ufffe\uffff]/u.test(name))
-        throw new GeometryError("INVALID_ARGUMENT", "3MF names require one through 1024 valid XML characters.", { operation: "export3mf" });
-    const analyzed = new MeshViewCache();
-    for (const part of parts) {
-        let facts = analyzed.get(part);
-        if (facts !== undefined)
-            continue;
-        facts =
-            options.meshValidation === "solid"
-                ? analyzeSolidMesh(part)
-                : analyzeTriangleMesh(part, { requireClosed: true, includeTopology: true });
-        if (!(facts.signedVolume > 0) || facts.vertexCount >= 2 ** 31 || facts.triangleCount >= 2 ** 31)
-            throw new GeometryError("INVALID_TOPOLOGY", "3MF parts require positive oriented volume and valid core resource counts.", { operation: "export3mf" });
-        analyzed.set(part, facts);
-    }
-    const chunks = [];
-    let bytes = 0, complete = false;
-    const zip = new Zip((error, data, final) => {
-        if (error !== null)
-            throw error;
-        bytes += data.byteLength;
-        if (bytes >= 0xffffffff)
-            throw new GeometryError("COMPLEXITY_LIMIT", "3MF ZIP output exceeds its 32-bit container limit.", { operation: "export3mf" });
-        chunks.push(data);
-        complete = final;
-    });
-    const add = (path) => {
-        const file = new ZipDeflate(path, { level: 6 });
-        file.mtime = new Date(1980, 0, 1);
-        zip.add(file);
-        return file;
-    };
-    const addText = (path, contents) => add(path).push(encoder.encode(contents), true);
-    try {
-        addText("[Content_Types].xml", `${declaration}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/></Types>`);
-        addText("_rels/.rels", `${declaration}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Target="/3D/3dmodel.model" Id="model" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/></Relationships>`);
-        const model = add("3D/3dmodel.model");
-        let xml = "", xmlBytes = 0;
-        const flush = (final = false) => {
-            const data = encoder.encode(xml);
-            xmlBytes += data.byteLength;
-            if (xmlBytes >= 0xffffffff)
-                throw new GeometryError("COMPLEXITY_LIMIT", "3MF model XML exceeds its 32-bit ZIP entry limit.", { operation: "export3mf" });
-            model.push(data, final);
-            xml = "";
-        };
-        const append = (value) => {
-            xml += value;
-            if (xml.length >= 32_768)
-                flush();
-        };
-        append(`${declaration}<model unit="millimeter" xml:lang="en-US" xmlns="${namespace}"><metadata name="Application">MetaMesh Modeling</metadata><metadata name="Title">${escapeXml(name)}</metadata><resources>`);
-        const colors = new Map();
-        for (const part of parts)
-            if (part.color !== undefined && !colors.has(part.color.toLowerCase()))
-                colors.set(part.color.toLowerCase(), colors.size);
-        const materialId = parts.length + 1;
-        if (colors.size) {
-            append(`<basematerials id="${materialId}">`);
-            for (const color of colors.keys())
-                append(`<base name="Color ${color.slice(1)}" displaycolor="${color.toUpperCase()}FF"/>`);
-            append("</basematerials>");
-        }
-        parts.forEach((part, index) => {
-            const material = part.color === undefined
-                ? ""
-                : ` pid="${materialId}" pindex="${colors.get(part.color.toLowerCase())}"`;
-            append(`<object id="${index + 1}" name="${escapeXml(part.id)}" partnumber="${escapeXml(part.id)}" type="model"${material}><mesh><vertices>`);
-            for (let offset = 0; offset < part.positions.length; offset += 3)
-                append(`<vertex x="${part.positions[offset]}" y="${part.positions[offset + 1]}" z="${part.positions[offset + 2]}"/>`);
-            append("</vertices><triangles>");
-            for (let offset = 0; offset < part.indices.length; offset += 3)
-                append(`<triangle v1="${part.indices[offset]}" v2="${part.indices[offset + 1]}" v3="${part.indices[offset + 2]}"/>`);
-            append("</triangles></mesh></object>");
-        });
-        append("</resources><build>");
-        parts.forEach((_, index) => append(`<item objectid="${index + 1}"/>`));
-        append("</build></model>");
-        flush(true);
-        zip.end();
-        if (!complete)
-            throw new Error("The synchronous 3MF compressor did not complete.");
-        const result = new Uint8Array(bytes);
-        let offset = 0;
-        for (const chunk of chunks) {
-            result.set(chunk, offset);
-            offset += chunk.byteLength;
-        }
-        return result.buffer;
-    }
-    finally {
-        zip.terminate();
-    }
-}

package/dist/engine/model-dependencies.js

@@ -1,46 +0,0 @@
-/** Projects recorded reads into immutable host metadata without evaluating any computation. */
-export function createModelDependencies(output, modelParameters, entries, readerIds) {
-    const parameterNames = (entry) => [...(entry?.parameters.keys() ?? [])].filter((key) => typeof key === "string");
-    const rootParameters = new Map();
-    const parametersFor = (root) => {
-        const cached = rootParameters.get(root);
-        if (cached !== undefined)
-            return cached;
-        const parameters = new Set();
-        const visited = new Set();
-        const pending = [root];
-        while (pending.length > 0) {
-            const id = pending.pop();
-            if (visited.has(id))
-                continue;
-            visited.add(id);
-            const entry = entries.get(id);
-            for (const key of parameterNames(entry))
-                parameters.add(key);
-            for (const dependency of entry?.dependencies.keys() ?? [])
-                pending.push(dependency);
-        }
-        const result = [...parameters];
-        rootParameters.set(root, result);
-        return result;
-    };
-    return Object.freeze({
-        modelParameters: Object.freeze([...modelParameters].sort()),
-        computations: Object.freeze([...entries].map(([id, entry]) => Object.freeze({
-            id,
-            parameters: Object.freeze(parameterNames(entry).sort()),
-            computations: Object.freeze([...(entry?.dependencies.keys() ?? [])].sort()),
-        }))),
-        parts: Object.freeze(output.map((part) => {
-            const roots = [part.geometry, part.position, part.rotation].flatMap((value) => {
-                const id = typeof value === "function" ? readerIds.get(value) : undefined;
-                return id === undefined ? [] : [id];
-            });
-            return Object.freeze({
-                id: part.id,
-                computations: Object.freeze(roots),
-                parameters: Object.freeze([...new Set(roots.flatMap(parametersFor))].sort()),
-            });
-        })),
-    });
-}