grid-apps-cmms/src/mesh/api.js

/** Copyright Stewart Allen <sa@grid.space> -- All Rights Reserved */

"use strict";

// dep: moto.license
// dep: moto.client
// dep: moto.broker
// dep: moto.space
// dep: mesh.util
// dep: mesh.edges
// dep: mesh.group
// dep: mesh.model
// dep: mesh.sketch
// dep: add.three
// use: add.array
gapp.register("mesh.api", [], (root, exports) => {

const { Matrix4, Vector3 } = THREE;
const { base, mesh, moto } = root;
const { space } = moto;
const { util } = mesh;
const { newPolygon } = base;

const worker = moto.client.fn
const groups = [];
const sketches = [];

let selected = [];
let tools = [];

const selection = {
    count() {
        return selected.length;
    },

    // @returns {MeshObject[]} or all groups if not strict and no selection
    list(strict) {
        return selected.length || strict ? selected.slice() : groups.slice();
    },

    // return selected groups + groups from selected models
    groups(strict) {
        let all = selection.list(strict);
        let grp = all.filter(s => s instanceof mesh.group);
        let mdl = all.filter(s => s instanceof mesh.model);
        for (let m of mdl) {
            grp.addOnce(m.group);
        }
        return grp;
    },

    // return selected models + models from selected groups
    models(strict) {
        let all = selection.list(strict);
        let grp = all.filter(s => s instanceof mesh.group);
        let mdl = all.filter(s => s instanceof mesh.model);
        for (let g of grp) {
            for (let m of g.models) {
                mdl.addOnce(m);
            }
        }
        return mdl;
    },

    sketch() {
        return selection.sketches()[0];
    },

    sketches() {
        return selection.list(true).filter(s => s.type === 'sketch');
    },

    sketch_items() {
        return selection.list(true).filter(s => s.type === 'sketch_item')
    },

    contains(object) {
        return selected.contains(object);
    },

    // @param group {MeshObject[]}
    set(objects, toolist) {
        // flatten groups into model lists when present
        selected = objects.map(o => o.models ? o.models : o).flat();
        tools = toolist || [];
        util.defer(selection.update);
    },

    // @param group {MeshObject}
    add(object, tool = mode.is([ modes.tool ])) {
        // eject incompatible types from selection
        switch (object.type) {
            case 'sketch':
                mode.sketch();
                tools.length = 0;
                selected.length = 0;
                mesh.edges?.end();
                break;
            case 'group':
            case 'model':
                selected = selected.filter(s => s.type !== 'sketch');
                break;
        }
        // when group added, add group models instead
        if (object.models) {
            for (let m of object.models) {
                selected.addOnce(m);
                if (tool) {
                    tools.addOnce(m);
                }
            }
        } else {
            selected.addOnce(object);
            if (tool) {
                tools.addOnce(object);
            }
        }
        util.defer(selection.update);
    },

    // @param group {MeshObject}
    remove(object) {
        if (object.models) {
            for (let m of object.models) {
                selected.remove(m);
                tools.remove(m);
            }
        } else {
            selected.remove(object);
            tools.remove(object);
        }
        util.defer(selection.update);
    },

    // remove all
    delete() {
        if (sketch.selected.delete()) {
            return;
        }
        for (let s of selection.list()) {
            selection.remove(s);
            tools.remove(s);
            s.showBounds(false);
            s.remove();
        }
    },

    // @param group {MeshObject}
    toggle(object, tool = mode.is([ modes.tool ])) {
        if (object.models) {
            for (let m of object.models) {
                if (selected.contains(m)) {
                    return selection.remove(object);
                }
            }
            return selection.add(object, tool);
        }
        if (selected.contains(object)) {
            selection.remove(object);
        } else {
            selection.add(object, tool);
        }
    },

    clear() {
        if (sketch.selected.clear()) {
            return;
        }
        for (let s of selection.list()) {
            selection.remove(s);
            tools.remove(s);
        }
        for (let m of api.model.list()) {
            m.clearSelections();
        }
        return true;
    },

    visible() {
        for (let m of selection.models()) {
            m.visible(...arguments);
        }
        util.defer(selection.update);
    },

    // update selection and wireframe for all objects
    update() {
        // de-select all
        for (let group of groups) {
            group.select(false);
            group.normals(prefs.map.space.norm || false);
            group.wireframe(prefs.map.space.wire || false, {
                opacity: prefs.map.wireframe.opacity}
            );
        }
        for (let sketch of sketches) {
            sketch.select(false);
        }
        api.updateFog();
        // prevent selection of model and its group
        let mgsel = selected.filter(s => s instanceof mesh.model).map(m => m.group);
        selected = selected.filter(sel => !mgsel.contains(sel)).filter(v => v);
        // highlight selected
        for (let object of selected) {
            object.select(true, tools.contains(object));
        }
        // update saved selection id list
        prefs.save( prefs.map.space.select = selected.map(s => s.id) );
        prefs.save( prefs.map.space.tools = tools.map(s => s.id) );
        // force repaint in case of idle
        space.update();
        return selection;
    },

    drag(opt = {}) {
        selected.forEach(s => s.drag(opt));
        return selection;
    },

    move(dx = 0, dy = 0, dz = 0) {
        for (let s of [...selection.groups(), ...selection.sketches()]) {
            s.move(dx, dy, dz);
        }
        return selection;
    },

    rotate(dx = 0, dy = 0, dz = 0) {
        for (let s of selection.groups()) {
            s.rotate(dx, dy, dz);
        }
        return selection;
    },

    qrotate(q) {
        for (let s of selection.groups()) {
            s.qrotate(q);
        }
        return selection;
    },

    scale(dx = 0, dy = 0, dz = 0) {
        for (let s of selection.groups()) {
            let { x, y, z } = s.scale();
            s.scale(x * dx, y * dy, z * dz);
        }
        return selection;
    },

    floor() {
        for (let s of selection.groups()) {
            s.floor(...arguments);
        }
        return selection;
    },

    centerXY() {
        for (let s of [...selection.groups(), ...selection.sketches()]) {
            s.centerXY(...arguments);
        }
        return selection;
    },

    boundsBox() {
        for (let m of selection.groups()) {
            m.showBounds(...arguments);
        }
        return selection;
    },

    home() {
        return selection.centerXY().floor();
    },

    focus() {
        api.focus(selection.list());
    },

    bounds() {
        return util.bounds(selected.map(s => s.object));
    },

    show() {
        for (let m of selection.models()) {
            m.visible(true);
        }
    },

    hide() {
        for (let m of selection.models()) {
            m.visible(false);
        }
    }
};

const pattern = {
    /**
     * @param {int} count number of entities
     * @param {float[]} center [x,y,z]
     */
    circle(count, center) {
        async function doit(count = 3, center = [0,0], zdelta = 0) {
            api.modal.hide();
            let models = selection.models();
            let [ cx, cy ] = center;
            for (let model of models) {
                await api.tool.regroup([ model ]);
                let pos = model.group.position().clone();
                let stepr = (Math.PI * 2) / count;
                let modnu = [ model ];
                for (let i=1; i<count; i++) {
                    let clone = await model.duplicate();
                    let [x, y] = base.util.rotate(pos.x - cx, pos.y - cy, stepr * i);
                    clone.group.centerModels().position(0,0,0);
                    clone.group.rotate(0, 0, stepr * i);
                    clone.group.move(x + cx, y + cy, pos.z);
                    modnu.push(clone);
                    // pos.z += zdelta;
                }
                await api.tool.regroup(modnu);
            }
        }
        if (!count) {
            api.modal.dialog({
                title: "circle pattern",
                body: [ h.div({ class: "addgear" }, [
                    h.label('total count'),
                    h.input({ value: 3, size: 5, id: "_count" }),
                    h.label('center x,y'),
                    h.input({ value: "0,0", size: 5, id: "_center" }),
                    // h.label('z delta'),
                    // h.input({ value: "0", size: 5, id: "_zdelta" }),
                    h.button({ _: "create", onclick() {
                        let { _count, _center, _zdelta } = api.modal.bound;
                        doit(
                            parseInt(_count.value),
                            _center.value.split(',').map(v => parseFloat(v)),
                            // parseFloat(_zdelta.value)
                        );
                    } })
                ]) ]
            });
            api.modal.bound._count.focus();
        } else {
            doit(count, origin);
        }
    },

    grid(x, y, xs, ys) {
        async function doit(x = 3, y = 3, xs = 10, ys = 10) {
            api.modal.hide();
            let models = selection.models();
            for (let model of models) {
                await api.tool.regroup([ model ]);
                let pos = model.group.position().clone();
                let modnu = [ model ];
                for (let i=0; i<x; i++) {
                    for (let j=0; j<y; j++) {
                        if (i === 0 && j === 0) continue;
                        let clone = await model.duplicate();
                        clone.group.centerModels().position(i * xs + pos.x, -j * ys + pos.y, pos.z);
                        modnu.push(clone);
                    }
                }
                await api.tool.regroup(modnu);
            }
        }
        if (!(x && y)) {
            api.modal.dialog({
                title: "grid pattern",
                body: [ h.div({ class: "addgear" }, [
                    h.label('x count'),
                    h.input({ value: 3, size: 5, id: "_x" }),
                    h.label('y count'),
                    h.input({ value: 3, size: 5, id: "_y" }),
                    h.label('x spacing'),
                    h.input({ value: 20, size: 5, id: "_xs" }),
                    h.label('y spacing'),
                    h.input({ value: 20, size: 5, id: "_ys" }),
                    h.button({ _: "create", onclick() {
                        doit(
                            parseInt(api.modal.bound._x.value) || 3,
                            parseInt(api.modal.bound._y.value) || 3,
                            parseFloat(api.modal.bound._xs.value) || 3,
                            parseFloat(api.modal.bound._ys.value) || 3,
                        );
                    } })
                ]) ]
            });
            api.modal.bound._x.focus();
        } else {
            doit(x, y, xs, ys);
        }
    }
};

const group = {
    // @returns {MeshGroup[]}
    list() {
        return groups.slice();
    },

    // @param group {MeshModel[]}
    new(models, id, name) {
        return group.add(new mesh.group(models, id, name));
    },

    // @param group {MeshGroup}
    add(group) {
        groups.addOnce(group);
        space.world.add(group.object);
        util.defer(selection.update);
        space.update();
        return group;
    },

    // @param group {MeshGroup}
    remove(group) {
        groups.remove(group);
        space.world.remove(group.object);
        space.update();
    }
};

let model = {
    // @returns {MeshModel[]}
    list() {
        return groups.map(g => g.models).flat();
    }
};

let sketch = {
    add(sk) {
        sketches.addOnce(sk);
        space.world.add(sk.object);
        util.defer(selection.update);
        return sk;
    },

    remove(sk) {
        sketches.remove(sk);
        space.world.remove(sk.object);
        space.update();
    },

    list() {
        return sketches;
    },

    extrude(opt = {}) {
        let sketch = selection.sketch();
        if (!sketch) {
            return log('select a sketch to extrude');
        }
        api.modal.dialog({
            title: "extrude",
            body: [ h.div({ class: "addgear" }, [
                h.label('height'),
                h.input({ value: opt.height || 10, size: 5, id: "_height" }),
                h.hr(),
                h.code("optional"),
                h.hr(),
                h.label('chamfer top'),
                h.input({ value: opt.chamfer_top || 0, size: 5, id: "_chamtop" }),
                h.label('chamfer bottom'),
                h.input({ value: opt.chamfer_bottom || 0, size: 5, id: "_chambot" }),
                h.button({ _: "create", onclick() {
                    const { _height, _chamtop, _chambot } = api.modal.bound;
                    sketch.extrude({
                        selection: sketch.selected.count() > 0,
                        ...opt,
                        height: parseFloat(_height.value),
                        chamfer_top: parseFloat(_chamtop.value),
                        chamfer_bottom: parseFloat(_chambot.value),
                    });
                    api.modal.hide();
                } })
            ]) ]
        });
        api.modal.bound._height.focus();
    },

    arrange: {
        group() {
            sketch.selection.ifcan((sketch, items) => {
                let group = Date.now().toString(36);
                items.forEach(i => i.group = group);
                log('grouped', items.length, 'sketch items');
            }, 2);
        },

        ungroup() {
            sketch.selection.ifcan((sketch, items) => {
                items.forEach(i => delete i.group);
                log('ungrouped', items.length, 'sketch items');
            });
        },

        center() {
            sketch.selection.bounded_op((sketch, bounds, recs) => {
                let center = bounds.center(0);
                for (let rec of recs) {
                    rec.poly.move({ x: -center.x, y: -center.y, z:0 });
                    Object.assign(rec.item, rec.poly.toObject());
                }
                sketch.render();
            });
        },

        fliph() {
            sketch.selection.ifcan((sketch, items) => {
                items.filter(i => i.type === 'polygon').forEach(item => {
                    Object.assign(item, newPolygon().fromObject(item).flip('x').toObject());
                });
                sketch.render();
            });
        },

        flipv() {
            sketch.selection.ifcan((sketch, items) => {
                items.filter(i => i.type === 'polygon').forEach(item => {
                    Object.assign(item, newPolygon().fromObject(item).flip('y').toObject());
                });
                sketch.render();
            });
        }
    },

    // related to a selected sketch
    selected: {
        get one() {
            return selection.sketch();
        },

        list() {
            return selection.sketches();
        },

        clear() {
            let list = selection.list(true);
            return list[0]?.type === 'sketch' && list[0].selection.clear();
        },

        delete() {
            let list = selection.list(true);
            return list[0]?.type === 'sketch' && list[0].selection.delete();
        },
    },

    // related to items selections in a selected sketch
    selection: {
        ifcan(fn, count = 1) {
            let one = sketch.selected.one;
            let items = one?.items.filter(i => i.selected);
            if (items?.length >= count) {
                return fn(one, items) || true;
            } else {
                return false;
            }
        },

        bounded_op(fn) {
            return sketch.selection.ifcan((sketch, items) => {
                let bounds;
                let recs = [];
                items.filter(i => i.type === 'polygon').forEach(item => {
                    let poly = newPolygon().fromObject(item);
                    let bnds = poly.bounds;
                    bounds = (bounds ? bounds.merge(bnds) : bnds);
                    recs.push({ item, poly });
                });
                return (bounds && (fn(sketch, bounds, recs) || true)) || false;
            }) || false;
        },

        duplicate(opt = {}) {
            return sketch.selection.bounded_op((sketch, bounds, recs) => {
                let { shift, select } = opt;
                let x = bounds.width(), y = 0, z = 0;
                for (let rec of recs) {
                    let { item, poly } = rec;
                    let item2 = structuredClone(item);
                    item.selected = !select;
                    item2.group += 'D';
                    shift && Object.assign(item2, poly.move({ x, y, z }).toObject());
                    sketch.add_item(item2, { select });
                }
            });
        },
    },

    boolean: {
        nest() {
            sketch.selected.one?.boolean.nest();
        },

        flatten() {
            sketch.selected.one?.boolean.flatten();
        },

        evenodd() {
            sketch.selected.one?.boolean.evenodd();
        },

        union() {
            sketch.selected.one?.boolean.union();
        },

        intersect() {
            sketch.selected.one?.boolean.intersect();
        },

        difference() {
            sketch.selected.one?.boolean.difference();
        }
    },

    pattern: {
        circle() {
            sketch.selected.one?.pattern.circle();
        },

        grid() {
            sketch.selected.one?.pattern.grid();
        }
    }
};

let add = {
    sketch(opt) {
        sketch.add(new mesh.sketch(opt));
    },

    /** add sketch components */

    circle(opt = {}) {
        let sketch = selection.sketch();
        if (!sketch) {
            return log('select a sketch');
        }
        api.modal.dialog({
            title: "add circle",
            body: [ h.div({ class: "addgear" }, [
                h.label('radius in mm'),
                h.input({ value: opt.radius || 10, size: 5, id: "_radius" }),
                h.hr(),
                h.code("optional"),
                h.hr(),
                h.label('point spacing'),
                h.input({ value: opt.spacing || 0, size: 5, id: "_spacing" }),
                h.label('point count'),
                h.input({ value: opt.points || 0, size: 5, id: "_points" }),
                h.button({ _: "create", onclick() {
                    const { _radius, _points, _spacing } = api.modal.bound;
                    sketch.add_circle({
                        radius: parseFloat(_radius.value),
                        points: parseInt(_points.value),
                        spacing: parseFloat(_spacing.value),
                    });
                    api.modal.hide();
                } })
            ]) ]
        });
        api.modal.bound._radius.focus();
    },

    rectangle() {
        let sel = selection.sketches();
        if (!sel.length) {
            return log('select a sketch');
        }
        return sel[0].add_rectangle(...arguments);
    },

    /** add models */

    input() {
        api.modal.dialog({
            title: "vertices",
            body: [ h.div({ class: "addact" }, [
                h.textarea({ value: '', size: 5, id: "genvrt" }),
                h.button({ _: "create", onclick() {
                    const vert = (api.modal.bound.genvrt.value)
                        .split(',').map(v => parseFloat(v)).toFloat32();
                    const nmdl = new mesh.model({ file: "input", mesh: vert });
                    const ngrp = group.new([ nmdl ]);
                    api.modal.hide();
                } })
            ]) ]
        });
        api.modal.bound.genvrt.focus();
    },

    cube() {
        const box = new THREE.BoxGeometry(1,1,1).toNonIndexed();
        const vert = box.attributes.position.array;
        const nmdl = new mesh.model({ file: "box", mesh: vert });
        const ngrp = group.new([ nmdl ]);
        ngrp.scale(10, 10, 10).floor();
        return ngrp;
    },

    cylinder(opt = {}) {
        function gencyl(opt = {}) {
            let { diameter, height, facets, chamfer, bore } = opt;
            api.modal.hide();
            if (diameter && height) {
                const center = { x:0, y:0, z:0 };
                log(`add cylinder faces=${facets} height=${height} diameter=${diameter}`);
                facets = Math.max(3, facets || diameter * 3)
                const cyl = newPolygon().centerCircle(center, diameter/2, facets);
                if (bore && bore < diameter) {
                    cyl.addInner(newPolygon().centerCircle(center, bore/2, facets));
                }
                const vert = cyl.extrude(height, { chamfer }).toFloat32();
                const nmdl = new mesh.model({ file: "cylinder", mesh: vert });
                const ngrp = group.new([ nmdl ]);
                ngrp.floor();
            }
        }
        if (opt.facets && opt.diameter && opt.height) {
            return gencyl(opt.diameter, opt.height, opt.facets);
        } else {
            api.modal.dialog({
                title: "cylinder",
                body: [ h.div({ class: "addgear" }, [
                    h.label('diameter'),
                    h.input({ value: opt.diameter || 20, size: 5, id: "_diameter" }),
                    h.label('height'),
                    h.input({ value: opt.height || 10, size: 5, id: "_height" }),
                    h.hr(),
                    h.label('bore'),
                    h.input({ value: opt.facets || 0, size: 5, id: "_bore" }),
                    h.label('facets'),
                    h.input({ value: opt.facets || 0, size: 5, id: "_facets" }),
                    h.label('chamfer'),
                    h.input({ value: opt.chamfer || 0, size: 5, id: "_chamfer" }),
                    h.button({ _: "create", onclick() {
                        const { _diameter, _facets, _height, _chamfer, _bore } = api.modal.bound;
                        gencyl({
                            diameter: parseFloat(_diameter.value),
                            height: parseFloat(_height.value),
                            facets: parseInt(_facets.value),
                            bore: parseFloat(_bore.value),
                            chamfer: parseFloat(_chamfer.value),
                        });
                    } })
                ]) ]
            });
            api.modal.bound._diameter.focus();
        }
    },

    gear(opt = {}) {
        function gengear(bound) {
            const { _teeth, _module, _angle, _twist, _shaft, _offset, _height, _chamfer } = bound;
            api.modal.hide();
            let params;
            worker.model_gen_gear(params = {
                teeth: parseInt(_teeth.value),
                module: parseFloat(_module.value),
                angle: parseFloat(_angle.value),
                twist: parseFloat(_twist.value),
                shaft: parseFloat(_shaft.value),
                offset: parseFloat(_offset.value),
                height: parseFloat(_height.value),
                chamfer: parseFloat(_chamfer.value),
            }).then(gear => {
                const nmdl = new mesh.model({ file: "gear", mesh: gear.toFloat32() });
                const ngrp = group.new([ nmdl ]);
                ngrp.floor();
                Object.assign(last, params);
                api.prefs.save();
            });
        }
        let last = api.prefs.map.gear = (api.prefs.map.gear || {});
        api.modal.dialog({
            title: "gear generator",
            body: [ h.div({ class: "addgear" }, [
                h.label('number of teeth'),
                h.input({ value: opt.teeth || last.teeth || 20, size: 5, id: "_teeth" }),
                h.label('shaft diameter'),
                h.input({ value: opt.shaft || last.shaft || 5, size: 5, id: "_shaft" }),
                h.label('z height'),
                h.input({ value: opt.height || last.height || 15, size: 5, id: "_height" }),
                h.label({ _:'chamfer', title:"negative values apply chamfer to the bottom only" }),
                h.input({ value: opt.chamfer || last.chamfer || 0, size: 5, id: "_chamfer" }),
                h.hr(),
                h.code("all other settings must"),
                h.code("match for gears to mesh"),
                h.hr(),
                h.label('module (diam / teeth)'),
                h.input({ value: opt.module || last.module || 3, size: 5, id: "_module" }),
                h.label('pressure angle'),
                h.input({ value: opt.angle || last.angle || 20, size: 5, id: "_angle" }),
                h.label('twist angle (helix)'),
                h.input({ value: opt.twist || last.twist || 0, size: 5, id: "_twist" }),
                h.label('tooth offset (play)'),
                h.input({ value: opt.offset || last.offset || 0.1, size: 5, id: "_offset" }),
                h.button({ _: "create", onclick() { gengear(api.modal.bound) } })
            ]) ]
        });
        api.modal.bound._teeth.focus();
    }
};

let file = {
    import() {
        // binding created in mesh.build
        $('import').click();
        // allow importing the same file twice
        setTimeout(() => { $('import').value = ''; }, 100);
    },

    export() {
        let recs = selection.models().map(m => { return {
            id: m.id, matrix: m.matrix, file: m.file
        } });
        if (recs.length === 0) {
            return log(`no models to export`);
        }
        function doit(ext = 'obj') {
            log(`exporting ${recs.length} model(s)`);
            let file = api.modal.bound.filename.value || "export.obj";
            if (file.toLowerCase().indexOf(`.${ext}`) < 0) {
                file = `${file}.${ext}`;
            }
            worker.file_export({
                recs, format: ext
            }).then(data => {
                if (data.length) {
                    util.download(data, file);
                }
            }).finally( api.modal.hide );
        }
        api.modal.dialog({
            title: `export ${recs.length} model(s)`,
            body: [ h.div({ class: "export" }, [
                h.div([
                    h.div("filename"),
                    h.input({ id: "filename", value: "mesh_export" })
                ]),
                h.div([
                    h.button({ _: "download OBJ", onclick() { doit('obj') } }),
                    h.button({ _: "download STL", onclick() { doit('stl') } })
                ])
            ]) ]
        });
    },
};

// return selection if models are invalid. can happen when called from
// even bound to a button which delivers a PointEvent argument
function fallback(models, strict) {
    return Array.isArray(models) ? models : selection.models(strict);
}

const tool = {
    merge(models) {
        models = fallback(models);
        if (models.length < 2) {
            return log('nothing to merge');
        }
        log(`merging ${models.length} models`).pin();
        worker.model_merge(models.map(m => {
            return { id: m.id, matrix: m.matrix }
        }))
        .then(data => {
            api.selection.visible(false);
            let group = api.group.new([new mesh.model({
                file: `merged`,
                mesh: data
            })]).promote();
            api.selection.set([group]);
            log('merge complete').unpin();
        });
    },

    union(models) {
        models = fallback(models);
        if (models.length < 2) {
            return log('nothing to union');
        }
        log(`union ${models.length} models`).pin();
        worker.model_union(models.map(m => {
            return { id: m.id, matrix: m.matrix }
        }))
        .then(data => {
            api.selection.visible(false);
            let group = api.group.new([new mesh.model({
                file: `union`,
                mesh: data
            })]).promote();
            api.selection.set([group]);
        })
        .catch(error => {
            log(`union error: ${error}`);
        })
        .finally(() => {
            log('union complete').unpin();
        });
    },

    difference(models) {
        models = fallback(models);
        if (models.length < 2) {
            return log('nothing to diff');
        }
        log(`diff ${models.length} models`).pin();
        worker.model_difference(models.map(m => {
            return { id: m.id, matrix: m.matrix }
        }))
        .then(data => {
            api.selection.visible(false);
            let group = api.group.new([new mesh.model({
                file: `diff`,
                mesh: data
            })]).promote();
            api.selection.set([group]);
        })
        .catch(error => {
            log(`diff error: ${error}`);
        })
        .finally(() => {
            log('diff complete').unpin();
        });
    },

    intersect(models) {
        models = fallback(models);
        if (models.length < 2) {
            return log('nothing to intersect');
        }
        log(`intersect ${models.length} models`).pin();
        worker.model_intersect(models.map(m => {
            return { id: m.id, matrix: m.matrix }
        }))
        .then(data => {
            let group = api.group.new([new mesh.model({
                file: `intersect`,
                mesh: data
            })]).promote();
            api.selection.visible(false);
            api.selection.set([group]);
        })
        .catch(error => {
            log(`intersect error: ${error}`);
        })
        .finally(() => {
            log('intersect complete').unpin();
        });
    },

    subtract(models) {
        models = fallback(models);
        if (models.length < 2) {
            return log('nothing to subtract');
        }
        log(`subtract ${models.length} models`).pin();
        worker.model_subtract(models.map(m => {
            return { id: m.id, matrix: m.matrix, tool: m.tool() }
        }))
        .then(data => {
            let group = api.group.new([new mesh.model({
                file: `subtract`,
                mesh: data
            })]).promote();
            api.selection.visible(false);
            api.selection.set([group]);
        })
        .catch(error => {
            log(`subtract error: ${error}`);
        })
        .finally(() => {
            log('subtract complete').unpin();
        });
    },

    duplicate() {
        let { dup_shift, dup_sel } = api.prefs.map.space;
        if (sketch.selection.duplicate({ select: dup_sel, shift: dup_shift })) {
            return;
        }
        let models = selection.models();
        if (dup_sel) {
            selection.clear();
        }
        for (let m of models) {
            m.duplicate({ select: dup_sel, shift: dup_shift });
        }
    },

    mirror() {
        for (let m of selection.models()) {
            m.mirror();
        }
    },

    invert() {
        for (let m of selection.models()) {
            m.invert(api.mode.get());
        }
    },

    rename(models, type = 'model') {
        models = fallback(models, true);
        let model = models[0];
        if (!model) {
            return;
        }
        if (models.length > 1) {
            return log('rename requires a single selection');
        }
        let onclick = onkeydown = (ev) => {
            if (ev.code && ev.code !== 'Enter') {
                return;
            }
            model.rename( $('tempedit').value.trim() );
            util.defer(selection.update);
            api.modal.hide();
        };
        let { tempedit } = api.modal.show(`rename ${type}`, h.div({ class: "rename"}, [
            h.input({ id: "tempedit", value: model.file, onkeydown }),
            h.button({ _: 'ok', onclick })
        ]));
        tempedit.setSelectionRange(0,1000);
        tempedit.focus();
    },

    regroup(models) {
        models = fallback(models, true);
        if (models.length === 0) {
            return;
        }
        log(`regrouping ${models.length} model(s)`);
        let bounds = util.bounds(models);
        let { mid } = bounds;
        return Promise.all(models.map(m => m.ungroup())).then(() => {
            return mesh.api.group.new(models)
                .centerModels()
                .position(mid.x, mid.y, mid.z);;
        });
    },

    analyze(models, opt = { compound: true }) {
        models = fallback(models);
        log('analyzing mesh(es)').pin();
        let promises = [];
        let mcore = new Matrix4().makeRotationX(Math.PI / 2);
        for (let m of models) {
            // todo - translate vertices with source model's matrix
            let p = worker.model_analyze({ id: m.id, opt }).then(data => {
                let { areas, edges } = data.mapped;
                let nm = areas.map(area => new mesh.model({
                    file: (area.length/3).toString(),
                    mesh: area.toFloat32()
                })).map( nm => nm.applyMatrix4(mcore.clone().multiply(m.mesh.matrixWorld)) );
                if (nm.length) {
                    mesh.api.group.new(nm, undefined, "patch");
                }
            });
            promises.push(p);
        }
        return Promise.all(promises).then(() => {
            log('analysis complete').unpin();
        });
    },

    isolate(models) {
        models = fallback(models);
        log('isolating bodies').pin();
        let promises = [];
        let mcore = new Matrix4().makeRotationX(Math.PI / 2);
        let mark = Date.now();
        for (let m of models) {
            let p = worker.model_isolate({ id: m.id }).then(bodies => {
                bodies = bodies.map(vert => new mesh.model({
                    file: m.file,
                    mesh: vert.toFloat32()
                })).map( nm => nm.applyMatrix4(mcore.clone().multiply(m.mesh.matrixWorld)) );
                mesh.api.group.new(bodies, undefined, "isolate");
            });
            promises.push(p);
        }
        return Promise.all(promises).then(() => {
            log('isolation complete').unpin();
            // log(`... isolate time = ${Date.now() - mark}`);
        });
    },

    indexFaces(models, opt = {}) {
        models = fallback(models);
        log('mapping faces').pin();
        let promises = [];
        let mark = Date.now();
        for (let m of models) {
            let p = worker.model_indexFaces({ id: m.id, opt }).then(data => {
                // console.log({map_info: data});
            });
            promises.push(p);
        }
        Promise.all(promises).then(() => {
            log('mapping complete').unpin();
            // log(`... index time = ${Date.now() - mark}`);
        });
    },

    heal(models, opt = {}) {
        models = fallback(models);
        let promises = [];
        for (let m of models) {
            let p = worker.model_heal({
                id: m.id, opt
            }).then(data => {
                if (data) {
                    m.reload(
                        data.vertices,
                        data.indices,
                        data.normals
                    );
                }
            });
            promises.push(p);
        }
        return new Promise((resolve, reject) => {
            Promise.all(promises).then(() => {
                resolve();
            });
        });
    },

    repair(models) {
        models = fallback(models);
        log('repairing mesh(es)').pin();
        tool.heal(models, { merge: true }).then(() => {
            log('repair commplete').unpin();
            util.defer(selection.update);
        });
    },

    clean(models) {
        models = fallback(models);
        tool.heal(models, { merge: false }).then(() => {
            log('cleaning complete').unpin();
            util.defer(selection.update);
        });
    },

    rebuild(models) {
        Promise.all(fallback(models).map(m => m.rebuild()));
    }
};

const modes = {
    object: "object",   // mesh or group
    tool: "tool",       // mesh or group for subtraction
    face: "face",       // facet / triangle
    surface: "surface", // normal aligned & adjacent faces
    edge: "edge",       // edge of a face
    sketch: "sketch",   // 2D sketching
};

// edit mode
const mode = {
    set(mode) {
        prefs.save(prefs.map.mode = mode);
        for (let key of Object.values(modes)) {
            $(`mode-${key}`).classList.remove('selected');
        }
        $(`mode-${mode}`).classList.add('selected');
        api.mode.check();
        mesh.edges?.end();
        if (mode === 'sketch') {
            $C('sketch-on',   null, 'hide');
            $C('sketch-off', 'hide', null);
        } else {
            $C('sketch-off',  null, 'hide');
            $C('sketch-on',  'hide', null);
        }
    },

    get() {
        return prefs.map.mode;
    },

    is(modelist) {
        for (let m of modelist) {
            if (prefs.map.mode === m) return true;
        }
        return false;
    },

    check() {
        if (prefs.map.mode === modes.surface) {
            tool.indexFaces();
        }
    },

    object() {
        if (!mode.is([ modes.object, modes.tool ])) {
            selection.clear();
        }
        mode.set(modes.object);
    },

    tool() {
        if (!mode.is([ modes.object, modes.tool ])) {
            selection.clear();
        }
        mode.set(modes.tool);
    },

    face() {
        if (!mode.is([ modes.face, modes.surface ])) {
            selection.clear();
        }
        mode.set(modes.face);
    },

    surface() {
        if (!mode.is([ modes.face, modes.surface ])) {
            selection.clear();
        }
        mode.set(modes.surface);
    },

    edge() {
        if (!mode.is([ modes.edge ])) {
            selection.clear();
        }
        mode.set(modes.edge);
        mesh.edges.start();
    },

    sketch() {
        if (!mode.is([ modes.sketch ])) {
            selection.clear();
        }
        mode.set(modes.sketch);
    }
};

// cache pref signature so we know when it changes
let prefsig;
let prefsignew;

// persisted preference map
const prefs = {
    map: {
        info: {
            group: "show",
            span: "show"
        },
        mode: modes.object,
        edit: {
            scale_group_X: true,
            scale_group_Y: true,
            scale_group_Z: true
        },
        space: {
            snap: 1,
            snapon: false,
            center: false,
            floor: false,
            wire: false,
            grid: true,
            dark: false,
            select: []
        },
        normals: {
            length: 0.25,
            color_lite: 0xffff00,
            color_dark: 0xffff00,
        },
        surface: {
            radians: 0.1,
            radius: 0.2
        },
        wireframe: {
            opacity: 0.4,
            fog: 3
        }
    },

    // look for changes in pref signature
    changed() {
        prefsignew = JSON.stringify(prefs.map);
        return prefsignew !== prefsig;
    },

    // persist to data store
    save() {
        if (prefs.changed()) {
            mesh.db.admin.put("prefs", prefs.map);
            prefsig = prefsignew;
        }
    },

    // reload from data store
    load() {
        return mesh.db.admin.get("prefs").then(data => {
            // handle/ignore incompatible older prefs
            if (data) Object.assign(prefs.map, data);
        });
    }
};

// api is augmented in mesh.build (log, modal, download)
const api = exports({
    help() {
        window.open("https://docs.grid.space/projects/mesh-tool");
    },

    version() {
        window.location = "/choose?back";
    },

    donate() {
        window.open("https://www.paypal.com/paypalme/gridspace3d");
    },

    kirimoto() {
        window.location = "/kiri";
    },

    clear() {
        for (let group of group.list()) {
            group.remove(group);
        }
    },

    // @param object {THREE.Object3D | THREE.Object3D[] | Point}
    focus(object) {
        let { center } = object.center ? object : util.bounds(object);
        // when no valid objects supplied, set origin
        if (isNaN(center.x * center.y * center.z)) {
            center = { x: 0, y: 0, z: 0 };
        }
        let { normal } = object;
        let left, up;
        if (normal) {
            let { x, y, z } = normal;
            left = new Vector3(x,y,z).angleTo(new Vector3(0,-1,0));
            up = new Vector3(x,y,z).angleTo(new Vector3(0,0,1));
            if (x < 0) left = -left;
        }
        // sets "home" views (front, back, home, reset)
        space.platform.setCenter(center.x, -center.y, center.z);
        // sets camera focus
        space.view.panTo(center.x, center.z, -center.y, left, up);
    },

    grid(state = { toggle:true }) {
        let { platform } = space;
        let { map, save } = prefs;
        if (state.toggle) {
            platform.showGrid(!platform.isGridVisible());
        } else {
            platform.showGrid(state);
        }
        map.space.grid = platform.isGridVisible();
        save();
    },

    wireframe(state = { toggle:true }, opt = { opacity: prefs.map.wireframe.opacity }) {
        const mspace = prefs.map.space;
        let wire = mspace.wire;
        if (state.toggle) {
            wire = !wire;
        } else {
            wire = state;
        }
        for (let m of model.list()) {
            m.wireframe(wire, opt);
        }
        prefs.save( mspace.wire = wire );
        api.updateFog();
    },

    updateFog() {
        const mspace = prefs.map.space;
        const mwire = prefs.map.wireframe;
        if (mspace.wire) {
            space.scene.setFog(mwire.fog, mspace.dark ? 0 : 0xffffff);
        } else {
            space.scene.setFog(false);
        }
    },

    normals(state = {toggle:true}) {
        let norm = prefs.map.space.norm;
        if (state.toggle) {
            norm = !norm;
        } else {
            norm = state;
        }
        for (let m of model.list()) {
            m.normals(norm);
        }
        prefs.save( prefs.map.space.norm = norm );
    },

    mode,

    modes,

    selection,

    pattern,

    group,

    model,

    sketch,

    add,

    file,

    tool,

    prefs,

    objects() {
        // return model objects suitable for finding ray intersections
        return [
            ...group.list().map(o => o.models).flat().map(o => o.mesh),
            ...sketches.map(s => s.meshes).flat()
        ];
    },

    isDebug: self.debug === true
});

function log() {
    return api.log.emit(...arguments);
}

const { broker } = gapp;
const call = broker.send;

// publish messages when api functions are called
broker.wrapObject(selection, 'selection');
broker.wrapObject(model, 'model');
broker.wrapObject(group, 'group');

// optimize db writes by merging updates
prefs.save = util.deferWrap(prefs.save, 100);

});