topotopo 0.2.0 → 0.3.0

package/dist/workspace.js

@@ -11,7 +11,7 @@ import { didYouMean, renameExprRefs } from './graph/params.js';
 import { migrateGraph } from './graph/migrate.js';
 const NAME_RE = /^[A-Za-z_][\w.-]*$/;
 const GEOMETRY_EXTS = new Set(['obj', 'stl', 'ply', 'glb', 'gltf', 'geo', 'bgeo', 'blend', 'csv', 'json', 'points.json']);
-const IMAGE_EXTS = new Set(['png']);
+const IMAGE_EXTS = new Set(['png', 'jpg', 'jpeg', 'webp']);
 /** Lower-case extension of a file name without the dot; ".points.json" is one extension, dot-files have none. */
 export function inputExt(file) {
     const b = file.toLowerCase().replace(/^.*[\\/]/, '');
@@ -41,15 +41,17 @@ export class Workspace {
     listeners = new Set();
     /** the inputs folder given to the constructor (WorkspaceOptions.inputs), if any */
     inputsAt;
+    exportsAt;
     constructor(dir, engine, opts = {}) {
         this.dir = path.resolve(dir);
         this.engine = engine;
         this.inputsAt = opts.inputs === undefined ? undefined : path.resolve(opts.inputs);
+        this.exportsAt = opts.exports === undefined ? undefined : path.resolve(opts.exports);
         engine.graphResolver = (n) => this.graphs.get(n);
     }
     get graphDir() { return path.join(this.dir, 'graphs'); }
     get assetDir() { return path.join(this.dir, 'assets'); }
-    get exportDir() { return path.join(this.dir, 'exports'); }
+    get exportDir() { return this.exportsAt ?? path.join(this.dir, 'exports'); }
     /**
      * files people drop in: meshes, guide curves and points, PNG masks and heightmaps (read as "inputs/<path>");
      * <dir>/inputs unless the constructor was given another folder
@@ -168,6 +170,10 @@ export class Workspace {
             base.params = { ...(base.params ?? {}), ...patch.params };
         if (patch.output)
             base.output = patch.output;
+        if (patch.outputs)
+            base.outputs = { ...base.outputs, ...patch.outputs };
+        if (patch.export !== undefined)
+            base.export = patch.export;
         if (patch.description)
             base.description = patch.description;
         return base;
@@ -253,6 +259,9 @@ export class Workspace {
                     delete g.nodes[n];
                     if (g.output === n)
                         delete g.output;
+                    for (const [id, out] of Object.entries(g.outputs ?? {}))
+                        if (out.node === n)
+                            delete g.outputs[id];
                     break;
                 }
                 case 'connect': {
@@ -282,6 +291,9 @@ export class Workspace {
                         setRef(r.node, r.idx, op.to);
                     if (g.output === n)
                         g.output = op.to;
+                    for (const out of Object.values(g.outputs ?? {}))
+                        if (out.node === n)
+                            out.node = op.to;
                     // expression references: npoints("old"), ch("old/param") …
                     const touched = [];
                     for (const [k, spec] of Object.entries(g.nodes)) {
@@ -312,6 +324,28 @@ export class Workspace {
                 case 'bypass':
                     g.nodes[need(op.node, where)].bypass = op.value ?? true;
                     break;
+                case 'export': {
+                    // the target of the default output, or of a named one; null removes it (validated with the graph)
+                    if (op.export === undefined)
+                        throw new Error(`${where}: give "export": a format ("glb"), {format, path?, ...options}, or null`);
+                    if (op.output === undefined) {
+                        if (op.export === null)
+                            delete g.export;
+                        else
+                            g.export = op.export;
+                        break;
+                    }
+                    const out = g.outputs?.[op.output];
+                    if (!out) {
+                        const s = didYouMean(op.output, Object.keys(g.outputs ?? {}));
+                        throw new Error(`${where}: no output "${op.output}"${s.length ? ` — did you mean ${s.join(', ')}?` : ''} (publish it in "outputs" first)`);
+                    }
+                    if (op.export === null)
+                        delete out.export;
+                    else
+                        out.export = op.export;
+                    break;
+                }
                 case 'insert': {
                     const after = need(op.after, `${where} after`);
                     if (!op.node || !NAME_RE.test(op.node) || g.nodes[op.node])
@@ -327,7 +361,7 @@ export class Workspace {
                     notes.push(`inserted "${op.node}" after "${after}"${consumers.length ? `; now feeds ${consumers.map((c) => c.node).join(', ')}` : ''}`);
                     break;
                 }
-                default: throw new Error(`${where}: unknown op. Use set, add, remove, connect, rename, output, vars, bypass, replace, insert`);
+                default: throw new Error(`${where}: unknown op. Use set, add, remove, connect, rename, output, vars, bypass, replace, insert, export`);
             }
         }
         return { graph: g, notes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "topotopo",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "An open-source procedural geometry engine: node graphs in JSON, cooked headless and deterministic, exported to Unreal, Blender and Houdini. Built for LLM agents through MCP, and for people through the CLI.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,7 @@
     "mcp": "node src/mcp/server.ts",
     "preview": "node scripts/preview.ts --examples",
     "cook": "node src/cli.ts",
-    "test": "node test/smoke.ts && node test/golden.ts && node test/property.ts && node test/fuzz.ts && node test/docs.ts && node test/portability.ts && node test/examples.ts && node scripts/gen-notice.ts --check && node test/io.ts && node test/import.ts && node test/interop.ts && node test/mcp.ts && node test/engine.ts && node test/viewer.ts && node test/viewer-logic.ts && node test/topology.ts && node test/deform.ts && node test/cloth.ts && node test/arrays.ts && node test/bugs.ts && node test/uv.ts && node test/polyedit.ts && node test/bevel.ts && node test/measure.ts && node test/render.ts && node test/packed.ts && node test/heightfield.ts && node test/remesh.ts && node test/pcg.ts && node test/scatterkernel.ts && node test/splines.ts && node test/shelf.ts && node test/textures.ts && node test/pool.ts && node test/kernelsloader.ts && node test/kernels.ts && node test/sdfgrid.ts && node test/remeshquad.ts && node test/erosionkernel.ts && node test/erosionsimd.ts && node test/particles.ts && node test/rbd.ts && node test/limits.ts",
+    "test": "node test/smoke.ts && node test/golden.ts && node test/property.ts && node test/fuzz.ts && node test/docs.ts && node test/portability.ts && node test/examples.ts && node scripts/gen-notice.ts --check && node test/io.ts && node test/import.ts && node test/interop.ts && node test/mcp.ts && node test/engine.ts && node test/viewer.ts && node test/viewer-logic.ts && node test/topology.ts && node test/deform.ts && node test/cloth.ts && node test/arrays.ts && node test/bugs.ts && node test/uv.ts && node test/polyedit.ts && node test/bevel.ts && node test/measure.ts && node test/render.ts && node test/packed.ts && node test/heightfield.ts && node test/remesh.ts && node test/pcg.ts && node test/scatterkernel.ts && node test/splines.ts && node test/shelf.ts && node test/textures.ts && node test/pool.ts && node test/kernelsloader.ts && node test/kernels.ts && node test/sdfgrid.ts && node test/remeshquad.ts && node test/erosionkernel.ts && node test/erosionsimd.ts && node test/particles.ts && node test/rbd.ts && node test/limits.ts && node test/viewer-outputs.ts",
     "test:limits": "node test/limits.ts",
     "kernels:build": "node scripts/kernels-build.ts",
     "test:kernels": "node test/scatterkernel.ts && node test/kernelsloader.ts && node test/kernels.ts && node test/sdfgrid.ts && node test/remeshquad.ts && node test/erosionkernel.ts && node test/erosionsimd.ts",
@@ -63,7 +63,7 @@
     "test:portability": "node test/portability.ts",
     "test:examples": "node test/examples.ts",
     "test:interop": "node test/interop.ts",
-    "test:viewer": "node test/viewer.ts && node test/viewer-logic.ts",
+    "test:viewer": "node test/viewer.ts && node test/viewer-logic.ts && node test/viewer-outputs.ts",
     "showcase": "node test/showcase.ts",
     "export:demo": "node scripts/export-demo.ts",
     "demo:footage": "node scripts/demo-footage.ts",
@@ -99,6 +99,7 @@
     "@modelcontextprotocol/sdk": "^1.32.0",
     "d3-delaunay": "^6.0.4",
     "earcut": "^3.2.4",
+    "fflate": "0.8.3",
     "manifold-3d": "^3.5.4",
     "meshoptimizer": "^1.3.0",
     "opentype.js": "^2.0.0",