topotopo 0.1.0 → 0.2.0

package/dist/workspace.js

@@ -1,11 +1,37 @@
-// A workspace: named graphs (persisted as JSON files), saved assets, and the engine
+// A workspace: named graphs (persisted as JSON files), saved assets, the human's input files, and the engine
 // that cooks them. Shared by the MCP server, the live viewer and the CLI.
+//   <dir>/graphs/<name>.json   graphs        <dir>/assets/<name>.json   saved assets
+//   <dir>/inputs/…             files people drop in (meshes, guide curves, PNG masks), read with file nodes; or a
+//                              folder given to the constructor (`topotopo view`: inputs/ beside the graph file)
+//   <dir>/exports/…            export output
 import fs from 'node:fs';
 import path from 'node:path';
 import { Engine, wiringOf } from './graph/engine.js';
 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']);
+/** 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(/^.*[\\/]/, '');
+    if (b.endsWith('.points.json') && b.length > '.points.json'.length)
+        return 'points.json';
+    const i = b.lastIndexOf('.');
+    return i > 0 ? b.slice(i + 1) : '';
+}
+export function inputKind(ext) {
+    return GEOMETRY_EXTS.has(ext) ? 'geometry' : IMAGE_EXTS.has(ext) ? 'image' : 'other';
+}
+/** Thrown by Workspace.edit when the edited graph does not validate; the stored graph is unchanged. */
+export class EditRejected extends Error {
+    errors;
+    constructor(errors) {
+        super(`✗ edits rejected (graph unchanged) — ${errors.length} error(s):\n` + errors.map((e) => `  [${e.node}] ${e.message}`).join('\n'));
+        this.name = 'EditRejected';
+        this.errors = errors;
+    }
+}
 export class Workspace {
     dir;
     engine;
@@ -13,16 +39,26 @@ export class Workspace {
     versions = new Map();
     lastReport = new Map();
     listeners = new Set();
-    constructor(dir, engine) {
+    /** the inputs folder given to the constructor (WorkspaceOptions.inputs), if any */
+    inputsAt;
+    constructor(dir, engine, opts = {}) {
         this.dir = path.resolve(dir);
         this.engine = engine;
+        this.inputsAt = opts.inputs === undefined ? undefined : path.resolve(opts.inputs);
         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'); }
+    /**
+     * 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
+     */
+    get inputDir() { return this.inputsAt ?? path.join(this.dir, 'inputs'); }
     load() {
-        for (const d of [this.dir, this.graphDir, this.assetDir, this.exportDir])
+        // the workspace's own inputs/ is made at once (people open it to drop files in); a folder given to the constructor
+        // is made by the first file written into it
+        for (const d of [this.dir, this.graphDir, this.assetDir, this.exportDir, ...(this.inputsAt ? [] : [this.inputDir])])
             fs.mkdirSync(d, { recursive: true });
         const assetErrors = [];
         for (const f of fs.readdirSync(this.assetDir).filter((f) => f.endsWith('.json'))) {
@@ -86,6 +122,41 @@ export class Workspace {
         this.graphs.delete(name);
         this.persist(name);
     }
+    /** Every file under inputs/, recursively: posix paths relative to it, sorted. Dot-files and dot-folders are skipped. */
+    listInputs() {
+        const out = [];
+        const walk = (dir, rel, depth) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                if (e.name.startsWith('.'))
+                    continue;
+                const abs = path.join(dir, e.name), r = rel ? `${rel}/${e.name}` : e.name;
+                let st;
+                try {
+                    st = fs.statSync(abs);
+                }
+                catch {
+                    continue;
+                } // a broken link
+                if (st.isDirectory()) {
+                    if (depth < 32)
+                        walk(abs, r, depth + 1);
+                } // the depth cap stops link cycles
+                else if (st.isFile()) {
+                    const ext = inputExt(e.name);
+                    out.push({ path: r, kind: inputKind(ext), ext, size: st.size, mtime: Math.round(st.mtimeMs) });
+                }
+            }
+        };
+        walk(this.inputDir, '', 0);
+        return out.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    }
     /** Merge nodes/vars/output of `patch` into an existing graph (upsert). */
     mergeGraph(name, patch) {
         patch = migrateGraph(patch);
@@ -261,6 +332,27 @@ export class Workspace {
         }
         return { graph: g, notes };
     }
+    /**
+     * The one path for an edit, whoever makes it (the MCP edit tool, the viewer's controls): apply the ops, validate
+     * (an invalid result throws EditRejected listing the per-node errors and stores nothing), store, cook at `frame`,
+     * then notify the listeners. They hear after the cook so that what they read (lastReport, cached geometry) is the
+     * new version's; a cook that throws still notifies, since the graph was stored.
+     */
+    async edit(name, ops, opts = {}) {
+        const { graph, notes } = this.applyEdits(name, ops);
+        const v = this.engine.validate(graph);
+        if (v.errors.length)
+            throw new EditRejected(v.errors);
+        this.setGraph(name, graph);
+        let report;
+        try {
+            report = await this.cook(name, undefined, opts.frame);
+        }
+        finally {
+            this.bump(name);
+        }
+        return { graph: this.getGraph(name), notes, report };
+    }
     async cook(name, target, frame) {
         const g = this.getGraph(name);
         const r = await this.engine.cook(g, { target, frame });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "topotopo",
-  "version": "0.1.0",
-  "description": "A procedural geometry engine: Houdini-style node graphs, headless, deterministic, exports to Unreal, Blender and Houdini",
+  "version": "0.2.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",
   "exports": {
@@ -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/interop.ts && node test/mcp.ts && node test/engine.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",
     "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,6 +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",
     "showcase": "node test/showcase.ts",
     "export:demo": "node scripts/export-demo.ts",
     "demo:footage": "node scripts/demo-footage.ts",
@@ -124,5 +125,9 @@
   "bugs": {
     "url": "https://github.com/topotopo-dev/topotopo/issues"
   },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/faxlab"
+  },
   "author": "faxcorp <hello@topotopo.dev>"
 }

package/shelf/brick_wall.json

@@ -2,7 +2,7 @@
   "version": 1,
   "description": "Brick wall from x = 0 to x = length: individual bricks in running, stack, English or Flemish bond, cut to the wall ends and top, with random offset, yaw and tint, standing slightly proud of a recessed mortar core. One wythe deep (headers are drawn as half bricks). Pivot at the start of the wall, on the ground, centred in thickness. Pieces: brick_wall_bricks (brick), brick_wall_mortar (mortar). Every piece is a closed box.",
   "params": {
-    "length": { "type": "float", "default": 3, "min": 0.3, "max": 12, "desc": "length along X (m)" },
+    "length": { "type": "float", "default": 3, "min": 0.3, "max": 40, "desc": "length along X (m)" },
     "height": { "type": "float", "default": 1.8, "min": 0.1, "max": 5, "desc": "height (m)" },
     "brick_length": {
       "type": "float",

package/shelf/wall_segment.json

@@ -2,10 +2,10 @@
   "version": 1,
   "description": "Straight wall from x = 0 to x = length with window (and an optional door) openings cut by a boolean, filled with the window_frame and door_frame shelf assets. The openings are spread in equal bays; the door takes the middle bay. Modular: segments placed end to end line up. Pivot at the start of the wall, on the ground, centred in thickness (+Z = outside). Pieces: wall (plaster) plus the frames' pieces. Every piece is closed (the wall is one watertight solid).",
   "params": {
-    "length": { "type": "float", "default": 4, "min": 0.5, "max": 20, "desc": "length along X (m)" },
+    "length": { "type": "float", "default": 4, "min": 0.5, "max": 60, "desc": "length along X (m)" },
     "height": { "type": "float", "default": 3, "min": 1, "max": 10, "desc": "height (m)" },
     "thickness": { "type": "float", "default": 0.25, "min": 0.05, "max": 1, "desc": "thickness along Z (m)" },
-    "windows": { "type": "int", "default": 2, "min": 0, "max": 10, "desc": "number of window openings" },
+    "windows": { "type": "int", "default": 2, "min": 0, "max": 24, "desc": "number of window openings" },
     "window_width": {
       "type": "float",
       "default": 1,