@meshy-ai/cli 0.2.0 → 0.3.0

package/dist/internal/obj-transform.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OBJ print preparation — the legacy `fix_obj.py` transform as a streaming module.
+ *
+ * Meshy exports Y-up OBJ files in arbitrary units; slicers want Z-up
+ * millimetres with the model standing on the build plate. The transform is
+ *
+ *   R(x, y, z) = (x, -z, y)        Y-up → Z-up; determinant +1, so face winding is kept
+ *   v' = s·R(v) + (tx, ty, tz)     s = height_mm / (zmax − zmin) of the rotated box,
+ *                                  XY centred on the origin, minZ on the plate (0)
+ *   n' = R(n)                      normals only rotate — no scale, no translation
+ *
+ * Every other line (vt, f, o, g, s, usemtl, mtllib, comments, blanks) is copied
+ * verbatim, so topology, UVs and material bindings cannot drift. Extra fields on
+ * a `v` line (vertex colours, w) are kept verbatim after the three coordinates.
+ *
+ * Two streaming passes keep memory constant regardless of file size: pass 1 folds
+ * every vertex into a bounding box, pass 2 rewrites lines through a write stream
+ * into a temp file in the target directory. The temp file is published only after
+ * the whole rewrite succeeded — nothing is written when validation fails, an
+ * existing output is never overwritten, and the input is replaced only with
+ * `inPlace` (temp file + rename on the same filesystem).
+ *
+ * Material dependencies (`mtllib`, and `map_*` textures inside those MTLs) are
+ * resolved relative to the input and only inside the input's directory tree.
+ * When the output lands in another directory they are copied alongside it; a
+ * missing or escaping dependency is a validation error there unless the caller
+ * asked for `geometryOnly`, because a "success" with a silently broken material
+ * is worse than a refusal. Every copy target is proven to lie inside the write
+ * root (`root`, i.e. the --workspace, else the output directory) on its *real*
+ * path before any directory is created or byte copied, and again right before
+ * publication — a symlinked `materials/` inside the target cannot redirect a
+ * copy outside. No env, no credentials, no network.
+ */
+import { type Warning } from "./errors.js";
+import { type AuthorisedRoot } from "./paths.js";
+export type Vec3 = [number, number, number];
+export interface Bbox {
+    min: Vec3;
+    max: Vec3;
+}
+export declare const OBJ_ROTATION: "(x,y,z)->(x,-z,y)";
+export declare const DEFAULT_HEIGHT_MM = 75;
+/** Same engineering ceiling as endpoint-contracts.json `limits.obj_bytes`. */
+export declare const DEFAULT_MAX_OBJ_BYTES: number;
+/** A rotated height at or below this is treated as degenerate (flat model). */
+export declare const MIN_MODEL_HEIGHT = 0.000001;
+export interface ObjTransformReport {
+    /** Absolute input path. */
+    input: string;
+    /** Absolute path of the written file (equals `input` when in place). */
+    output: string;
+    height_mm: number;
+    scale: number;
+    rotation: typeof OBJ_ROTATION;
+    translation: Vec3;
+    /** Bounding box of the input as written (its own axes and units). */
+    before_bbox: Bbox;
+    /** Bounding box of the output (Z-up, millimetres). */
+    after_bbox: Bbox;
+    counts: {
+        vertices: number;
+        normals: number;
+        uvs: number;
+        faces: number;
+        lines_total: number;
+    };
+    material: {
+        /** `mtllib` references as written, in order, deduplicated. */
+        mtllib: string[];
+        /** Absolute paths of dependencies copied next to the output by this run. */
+        copied: string[];
+        /** References (as written) that could not be resolved inside the input's directory. */
+        missing: string[];
+    };
+    in_place: boolean;
+    warnings: Warning[];
+}
+export interface PrepareObjOptions {
+    /** Target height in millimetres (default 75). Must be finite and > 0. */
+    heightMm?: number;
+    /** Explicit output file (or existing directory). Mutually exclusive with `inPlace`. */
+    outputPath?: string;
+    /** Replace the input itself via temp file + rename. */
+    inPlace?: boolean;
+    /** Never copy MTL/texture dependencies; missing ones become warnings only. */
+    geometryOnly?: boolean;
+    /** Refuse inputs larger than this many bytes (default 2 GiB). */
+    maxBytes?: number;
+    /**
+     * Authorised root for every write (the output and each copied dependency).
+     * Defaults to the output's directory; pass the --workspace (frozen with the
+     * flags) to confine writes to it. Checked on real paths against the frozen
+     * directory, so symlinked parents cannot escape it and a root replaced
+     * mid-run is refused.
+     */
+    root?: string | AuthorisedRoot;
+}
+export declare function rotateYUpToZUp(v: Vec3): Vec3;
+/** Default output beside the input: `<stem>.print.obj`. */
+export declare function defaultOutputPath(input: string): string;
+/**
+ * Six fixed decimals (error ≤ 5e-7, inside the 1e-5 mm oracle tolerance) with
+ * trailing zeros trimmed so a unit box does not become a wall of `.000000`.
+ * `-0` never appears: a slicer gains nothing from a signed zero.
+ */
+export declare function formatObjNumber(n: number): string;
+/** Texture references (`map_Kd [-options] file`) inside an MTL. */
+export declare function textureReferencesInMtl(text: string): string[];
+/**
+ * Rotate, scale and ground an OBJ for printing. See the module comment for the
+ * maths and the file contract. Throws CliError (`validation` / `local_io` /
+ * `not_found`) or UsageError; on any failure no output file exists.
+ */
+export declare function prepareObjForPrint(inputPath: string, opts?: PrepareObjOptions): Promise<ObjTransformReport>;
+//# sourceMappingURL=obj-transform.d.ts.map

package/dist/internal/obj-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obj-transform.d.ts","sourceRoot":"","sources":["../../src/internal/obj-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAsBH,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAA4D,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAG3G,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,IAAI,CAAC;CACX;AAED,eAAO,MAAM,YAAY,EAAG,mBAA4B,CAAC;AACzD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,QAAyB,CAAC;AAC5D,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,WAAO,CAAC;AAUrC,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,YAAY,CAAC;IAC9B,WAAW,EAAE,IAAI,CAAC;IAClB,qEAAqE;IACrE,WAAW,EAAE,IAAI,CAAC;IAClB,sDAAsD;IACtD,UAAU,EAAE,IAAI,CAAC;IACjB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE;QACR,8DAA8D;QAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,4EAA4E;QAC5E,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,uFAAuF;QACvF,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAE5C;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjD;AA8RD,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAe7D;AA0ID;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsKrH"}