@reekon-tools/boldr-cad 1.1.0 → 1.3.0

package/dist/tools/survey.js

@@ -0,0 +1,286 @@
+import { afterEdit, analyze, tryAddConstraint } from '../app/edit';
+import { ed } from '../app/state';
+import { measure } from '../model/constraints';
+import { hyp } from '../model/geom';
+import { pushHistory } from '../model/history';
+import { maybeRoom, roomGeom } from '../model/rooms';
+import { onSessionReset, sessionState } from '../model/session';
+import { addLine, addPoint, gc, lineBetween, pinnedPoints } from '../model/sketch';
+import { page, SK, store } from '../model/store';
+import { TH } from '../render/theme';
+import { requestDraw, requestOverlayDraw, S, V } from '../render/view';
+import { fmtArea, fmtLen } from '../units';
+import { elevOpen } from '../editor/elevation';
+import { keypadOpen } from '../editor/keypad';
+import { drawsWalls, setMode } from '../editor/mode';
+import { toast, updateCtx, updateHint } from '../editor/ports';
+import { close3d } from '../editor/view3d';
+import { is3d } from '../editor/view3dState';
+import { anchorMark, lengthPreview, setTool } from './registry';
+/*
+  The templator: points measured by a device in the host app (BOLDR's T1R) build the drawing directly. Each point joins
+  the last with a line (or a wall, with the Walls toggle on), and the drawing holds what was measured: a driving
+  length on every edge, and a driving angle at every corner. That fixes the shape's FORM — a later drag moves it
+  whole, it doesn't flex it — while leaving it free to be moved and turned into place. On a closed shape the last
+  edge and the corners either side of it are already set by the rest, so they come out as reference dimensions
+  (grey, in parentheses) rather than being refused: rule 3, and the closing edge's length still shows.
+
+  Where it lands: the device measures from itself, not from the page. The first point taken on a page puts its frame
+  there — that point at the middle of the screen — and every later point keeps its true place relative to it, for
+  the rest of the session. Kept per page and not per run on purpose: a cutout taken after its outline, from the same
+  setup, has to land where it really is relative to the outline, or templating it was pointless.
+
+  Points come in on the plan's own axes — x to the right, y up (render/view.ts's S) — and are placed as given. Which
+  way a device's angle turns is the host's business, not the editor's: the host turns its device's frame into this
+  one, and that's where a mirror gets in or doesn't. BOLDR's T1R turns clockwise, so the app negates y
+  (templatorPlanInches); passing its x = r·cos θ, y = r·sin θ straight in drew every template mirrored (seen on a device,
+  2026-10-28).
+*/
+/** How close a point has to land to the first one to close the shape: about 50 mm, inside the device's own error. */
+export const SURVEY_CLOSE_IN = 2;
+/** A point this close to the last one is the same point taken twice (a double press), not a new corner. */
+export const SURVEY_SAME_IN = 1 / 16;
+/** Each page's frame for the session: what's added to a device point to place it on the plan. */
+const frames = sessionState(() => ({ byPage: {} }));
+const fresh = () => ({ chain: [], captures: {} });
+const withCapture = (capture) => (capture !== undefined ? { capture } : {});
+/** A driving length on line `lid`, as the two points it joins are now (so nothing moves). */
+function holdLength(lid, a, b, capture) {
+    const sk = SK(), pa = sk.points[a], pb = sk.points[b];
+    if (!pa || !pb)
+        return;
+    tryAddConstraint({ type: 'dist', a, b, kind: 'al', value: hyp(pb.x - pa.x, pb.y - pa.y), line: lid, driving: true, off: 0, ...withCapture(capture) }, { silent: true });
+}
+/**
+ * A corner this close to dead straight (or folded right back) is held as Collinear, not as an angle: the angle's
+ * equation turns on |cross|, whose slope vanishes there, so the solver reads a 180° angle as adding nothing (a
+ * reference dimension) and the corner is left as a hinge. Collinear says the same thing and holds it. 1e-4° is far
+ * outside where that happens (about 2e-6°) and far inside any real capture's spread, so a measured corner is never
+ * squared off by it — over a 30" edge it's a micrometre.
+ */
+const STRAIGHT_DEG = 1e-4;
+/** A driving angle at the corner where `l1` and `l2` meet, as it is now (Collinear, if it's straight). */
+function holdAngle(l1, l2, capture) {
+    if (!l1 || !l2 || l1 === l2)
+        return;
+    const c = { type: 'angle', l1, l2, value: 0, driving: true };
+    c.value = measure(SK(), c);
+    if (c.value < STRAIGHT_DEG || c.value > 180 - STRAIGHT_DEG) {
+        tryAddConstraint({ type: 'col', l1, l2 }, { silent: true });
+        return;
+    }
+    tryAddConstraint({ ...c, ...withCapture(capture) }, { silent: true });
+}
+export const surveyTool = {
+    st: fresh(),
+    /** Picked up (by a point arriving with another tool in hand): a new run. */
+    enter() { this.st = fresh(); },
+    /**
+     * Put down by cancelTool. Deliberately NOT the end of the run: undo cancels the tool in hand before it steps back,
+     * and ending the run there would leave a gap after every bad point undone. The run ends on Finish, Close shape,
+     * Esc or Enter (key, below) — which also put the templator down — or when another tool is picked up; either way the
+     * next point starts a new run (enter).
+     */
+    reset() { ed.preview = null; },
+    busy() { return false; },
+    /** Esc and Enter finish the run here, before the generic Esc (which can't tell itself from undo's cancel). */
+    key(e) {
+        if ((e.key === 'Escape' || e.key === 'Enter') && this.st.chain.length) {
+            this.finish();
+            return true;
+        }
+        return false;
+    },
+    /**
+     * End the run: the shape stays as drawn, and the templator is put down (back to Select). Left in hand it would
+     * swallow every tap — it has no pointer handling, its points come from the device — so the shape just made couldn't
+     * be selected, and a phone's bar, which drops the "Templator" label, wouldn't even say why. The next point picks it
+     * up again, in the same frame. A run of one point leaves nothing (a point on its own isn't a shape).
+     */
+    finish() {
+        const first = this.st.chain[0];
+        if (first)
+            pinnedPoints.delete(first);
+        this.st = fresh();
+        ed.preview = null;
+        if (store.project) {
+            gc(SK());
+            analyze();
+        }
+        if (ed.tool === 'survey')
+            setTool('select');
+        updateCtx();
+        updateHint();
+        requestDraw();
+    },
+    /** Close the run back to its first point (the bar's Close shape, or a point taken there). */
+    closeShape() {
+        if (liveChain().length < 3)
+            return;
+        pushHistory();
+        closeRun(undefined);
+        afterEdit();
+    },
+    hint() {
+        return this.st.chain.length
+            ? 'Take the next point with your templator. Take one back at the first point to close the shape.'
+            : 'Take points with your templator: each one joins the last.';
+    },
+};
+/** The run's points that are still in the drawing (an undo since can have taken the last few back). */
+function liveChain() {
+    const sk = SK(), st = surveyTool.st;
+    const keep = st.chain.filter(id => sk.points[id]);
+    if (keep.length !== st.chain.length)
+        st.chain = keep;
+    return keep;
+}
+/**
+ * The run's first and last points, marked — where the next point joins, and where one would close the shape — and,
+ * while the device streams its live point (setSurveyCursor), the edge the next point would make: dashed from the last
+ * point to it, with its length, as the tool's own screen draws it. Worked out as the overlay paints, so it follows
+ * the live point (and a point undone) without being set again.
+ */
+function showRun() {
+    ed.preview = (c, T) => {
+        const sk = SK(), ch = surveyTool.st.chain.filter(id => sk.points[id]);
+        if (!ch.length)
+            return;
+        const last = sk.points[ch[ch.length - 1]], cur = ed.surveyCursor;
+        if (cur && cur.page === page().id) {
+            const [x1, y1] = S(T, last.x, last.y), [x2, y2] = S(T, cur.x, cur.y);
+            c.save();
+            c.strokeStyle = TH.blue;
+            c.lineWidth = 1.5;
+            c.setLineDash([6, 5]);
+            c.beginPath();
+            c.moveTo(x1, y1);
+            c.lineTo(x2, y2);
+            c.stroke();
+            c.restore();
+            lengthPreview(c, T, last, cur);
+        }
+        for (const id of new Set([ch[0], ch[ch.length - 1]])) {
+            const p = sk.points[id];
+            const [x, y] = S(T, p.x, p.y);
+            anchorMark(c, x, y);
+        }
+    };
+    requestOverlayDraw();
+}
+/**
+ * A device point on the current page's plan: the page's frame added. The page's first point or first live point,
+ * whichever comes first, sets the frame — that point at the middle of the screen — so the first point taken lands
+ * under the cursor that was showing it. (The caller has made sure no wall view is open: V() would be the wall's.)
+ */
+function onPlan(x, y) {
+    const pg = page().id;
+    if (!frames.byPage[pg]) {
+        const v = V();
+        frames.byPage[pg] = { dx: v.cx - x, dy: v.cy - y };
+    }
+    const f = frames.byPage[pg];
+    return { x: x + f.dx, y: y + f.dy };
+}
+/**
+ * The device's live point, in inches on the plan's axes as takeSurveyPoint takes one, or null to hide it: a ring
+ * where its next point would land (render/draw.ts), plus the would-be edge while a run is open (showRun). Overlay
+ * only — it never touches the drawing, the undo history or React, so a host can call it many times a second.
+ * Whether it's showing afterwards: never in a wall view (its points belong to the plan) or a view-only drawing.
+ */
+export function setSurveyCursor(p) {
+    if (!p || ed.readOnly || elevOpen() || !store.project) {
+        if (ed.surveyCursor) {
+            ed.surveyCursor = null;
+            requestOverlayDraw();
+        }
+        return false;
+    }
+    const at = onPlan(p.x, p.y);
+    ed.surveyCursor = { x: at.x, y: at.y, page: page().id };
+    // (an undo cancels the tool's preview: the run's would-be edge comes back with the next live point)
+    if (ed.tool === 'survey' && !ed.preview && surveyTool.st.chain.length)
+        showRun();
+    else
+        requestOverlayDraw();
+    return true;
+}
+/** Close the run: the last edge back to the first point, its length, the two corners it makes, and a space. */
+function closeRun(capture) {
+    const sk = SK(), st = surveyTool.st, ch = st.chain;
+    const first = ch[0], last = ch[ch.length - 1];
+    const lid = addLine(sk, last, first, { kind: drawsWalls() ? 'wall' : 'line', constr: !drawsWalls() && ed.drawConstr });
+    // (already set by the rest of the shape: these come out as reference dimensions)
+    holdLength(lid, last, first, capture ?? st.captures[first]);
+    holdAngle(lineBetween(sk, ch[ch.length - 2], last), lid, st.captures[last]);
+    holdAngle(lid, lineBetween(sk, first, ch[1]), st.captures[first]);
+    const n = ch.length, rid = drawsWalls() || !ed.drawConstr ? maybeRoom(sk, ch.slice()) : null;
+    surveyTool.finish();
+    toast(rid ? sk.rooms[rid].name + ' added — ' + fmtArea(roomGeom(sk, sk.rooms[rid]).area) : 'Closed shape, ' + n + ' sides');
+}
+/**
+ * A point from the host's device, in inches, on the plan's axes — y up (see the note at the top). Starts the
+ * templator if it isn't in hand, and the run's frame on a page with none yet. False when the drawing can't take it
+ * now (the toast says why).
+ */
+export function takeSurveyPoint(x, y, capture) {
+    if (ed.readOnly)
+        return false;
+    if (elevOpen()) {
+        toast('Back out of the wall view to take templator points on the plan.', { warn: true });
+        return false;
+    }
+    if (keypadOpen()) {
+        toast('Close the keypad, then take the point again.', { warn: true });
+        return false;
+    }
+    // (the templator works on the plan: from the 3D tab or Annotate, back to Draft)
+    if (is3d())
+        close3d();
+    if (ed.mode !== 'draft')
+        setMode('draft');
+    if (ed.tool !== 'survey')
+        setTool('survey');
+    const sk = SK(), st = surveyTool.st, ch = liveChain();
+    const { x: wx, y: wy } = onPlan(x, y);
+    const last = ch.length ? sk.points[ch[ch.length - 1]] : null;
+    if (last && hyp(wx - last.x, wy - last.y) < SURVEY_SAME_IN) {
+        toast('Same point as the last one — move the templator, then take the next.', { warn: true });
+        return false;
+    }
+    if (ch.length >= 3) {
+        const p0 = sk.points[ch[0]];
+        if (hyp(wx - p0.x, wy - p0.y) < SURVEY_CLOSE_IN) {
+            pushHistory();
+            closeRun(capture);
+            afterEdit();
+            return true;
+        }
+    }
+    pushHistory();
+    const id = addPoint(sk, wx, wy);
+    if (capture !== undefined)
+        st.captures[id] = capture;
+    if (!ch.length) {
+        // (on its own until the next point, garbage collection would take it: kept until the run ends)
+        pinnedPoints.add(id);
+    }
+    else {
+        const prev = ch[ch.length - 1];
+        const lid = addLine(sk, prev, id, { kind: drawsWalls() ? 'wall' : 'line', constr: !drawsWalls() && ed.drawConstr });
+        holdLength(lid, prev, id, capture);
+        if (ch.length >= 2)
+            holdAngle(lineBetween(sk, ch[ch.length - 2], prev), lid, st.captures[prev]);
+    }
+    st.chain.push(id);
+    ed.sel = [];
+    afterEdit();
+    showRun();
+    updateHint();
+    const n = st.chain.length, a = sk.points[st.chain[n - 2]];
+    toast(n === 1 ? 'Templator: point 1, at the middle of the screen' : 'Point ' + n + ' · ' + fmtLen(hyp(wx - a.x, wy - a.y)));
+    return true;
+}
+// a new session (another drawing): every page's frame and the run start again
+onSessionReset(() => { surveyTool.st = fresh(); });
+//# sourceMappingURL=survey.js.map

package/dist/tools/survey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey.js","sourceRoot":"","sources":["../../src/tools/survey.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-cad",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "BOLDR's 2D layout editor (React Native, iOS/Android/web) and how its drawings are kept in BOLDR.",
   "author": "REEKON Tools",
   "license": "MIT",

package/src/app/state.ts

@@ -69,6 +69,11 @@ export const ed = sessionState(() => ({
   snapState: null as Snap | null,
   boxSel: null as BoxSel | null,
   preview: null as Preview | null,
+  /**
+   * The templating device's live point (surveyCursor): where its next point would land, on that page's plan. Its own
+   * overlay layer rather than `preview`, which belongs to the tool in hand — the cursor shows whatever tool that is.
+   */
+  surveyCursor: null as { x: number; y: number; page: string } | null,
   highlight: new Set<string>(),
   conflictTint: false,
   /** tap targets from the last painted frame (whoever paints stores drawPlan()'s result here) */

package/src/editor/actions.ts

@@ -13,6 +13,7 @@ import { convertNote } from '../tools/annotate';
 import { cornerAngle, dimCurve, dimEdges, dimLine, dimPointLine, dimPoints, dimTwoLines, editDim, faceChoices, onChoice, setDimFace, toggleRef } from '../tools/dim';
 import { edgeLabel, edgeOf } from '../model/planGeom';
 import type { LineTool } from '../tools/line';
+import type { SurveyTool } from '../tools/survey';
 import { offsetPrompt, splitLine } from '../tools/modify';
 import { filletable, filletPrompt } from '../tools/fillet';
 import { chamferPrompt } from '../tools/chamfer';
@@ -128,6 +129,15 @@ function ctxItems(): CtxEntry[] {
     // drawing: no bar (tap the last point again to finish, the first to close the shape; Esc or Enter on a keyboard)
     if (st.start) return items;
   }
+  if (ed.tool === 'survey') {
+    // The templator: its points come from the device, not from taps on the drawing — so unlike Line, nothing on the
+    // canvas can finish or close a run, and the bar has to. (A phone's bar drops the label; the toasts name it there.)
+    const n = (tools.survey as SurveyTool).st.chain.length;
+    items.push({ lbl: 'Templator' });
+    if (n >= 3) add('closeShape', 'Close shape', 'closeShape');
+    if (n >= 1) add('finish', 'Finish', 'finish');
+    return items;
+  }
   if (ed.tool === 'dim') { add('dim', 'Driving', 'dimDrive', { on: ed.dimLayer === 'drive' }); add('ref', 'Print', 'dimPrint', { on: ed.dimLayer === 'print' }); return items; }
   // nothing selected: the bar stays empty (Fit and Icons live in the top bar; grid snap and auto-constrain in Settings).
   // Just placed a door, window or cabinet (its tool still on): its bar, for its sizes
@@ -455,8 +465,9 @@ export function applyCtxAction(act: string, anchor?: unknown): void {
       break;
     case 'showcons': settings.showCons = !settings.showCons; updateTopBar(); break;
     case 'typelen': (tools[ed.tool] as LineTool).typeLength(''); return;
-    case 'closeShape': (tools[ed.tool] as LineTool).closeShape(); updateCtx(); return;
-    case 'finish': (tools[ed.tool] as LineTool).finish(); updateCtx(); return;
+    // (the Line tool's, or the templator's: both close and finish a run of points)
+    case 'closeShape': (tools[ed.tool] as LineTool | SurveyTool).closeShape(); updateCtx(); return;
+    case 'finish': (tools[ed.tool] as LineTool | SurveyTool).finish(); updateCtx(); return;
     case 'dimDrive': ed.dimLayer = 'drive'; break;
     case 'dimPrint': ed.dimLayer = 'print'; break;
     case 'h': case 'v': case 'par': case 'perp': case 'col': case 'eq': case 'mid': case 'online': case 'oncircle': case 'tan': case 'eqr': case 'conc':

package/src/index.ts

@@ -10,7 +10,7 @@ export type { CadDataProvider, CadFileMeta, CadMeasurements, CadMeasurementValue
 export type { Unit } from './units';
 export { memoryProvider } from './data/memory';
 export { setFileSaver } from './react/ports';
-export { laserReading, setLaserConnected } from './react/host';
+export { laserReading, setLaserConnected, surveyCursor, surveyPoint } from './react/host';
 export type { HostKeypad, HostKeypadExtra, HostKeypadRequest, MeasurementList, MeasurementListPage } from './react/hostKeypad';
 export type { CadLinkPick, CadLinks, CadSaveMeasurement, MeasurementKind } from './editor/links';
 export type { LinkInfo, LinkTarget } from './model/types';

package/src/react/host.ts

@@ -1,10 +1,12 @@
 import { applyReading, laser } from '../editor/laser';
 import { store } from '../model/store';
+import { setSurveyCursor, takeSurveyPoint } from '../tools/survey';
 import { notify } from './store';
 
 /*
   For the host app's measuring devices (BOLDR's Bluetooth lasers and tapes): say when one is connected, and pass its
-  readings in. A reading goes into an open keypad, onto the one selected wall or line, or into the tray.
+  readings in. A reading goes into an open keypad, onto the one selected wall or line, or into the tray. A templating
+  device's points (surveyPoint) build the drawing itself.
 */
 
 /** Whether an editor is on screen (CadEditor sets it): readings that arrive after it closed are left to the host. */
@@ -30,3 +32,33 @@ export function laserReading(inches: number, capture?: unknown): boolean {
   notify();
   return true;
 }
+
+/**
+ * A point measured by a templating device (BOLDR's T1R), in inches, on the plan's axes: x to the right, y UP. Turning
+ * the device's own frame into that is the host's job, and it's where the handedness goes: a device whose angle turns
+ * clockwise (the T1R's does) has to negate y, or every template is drawn mirrored. Each point joins the last, with its length and the
+ * corner's angle held (src/tools/survey.ts). The first one on a page lands at the middle of the screen, and the rest
+ * keep their true place relative to it for the session. False when no drawing is open to take it, or it can't now
+ * (a wall view or keypad open: the editor says so). `capture`: the host's record of the point, kept with the
+ * dimensions it sets and handed back on Save to group, as laserReading's is.
+ */
+export function surveyPoint(x: number, y: number, capture?: unknown): boolean {
+  if (!editorHost.open || !store.project || !Number.isFinite(x) || !Number.isFinite(y)) return false;
+  const ok = takeSurveyPoint(x, y, capture);
+  notify();
+  return ok;
+}
+
+/**
+ * The templating device's live point — where its next surveyPoint would land — on the same axes as surveyPoint, or
+ * null to hide it (the device stopped, its reading went stale, the host left the screen). Drawn as a ring, with the
+ * edge the next point would make while a run is open. The first live point on a page sets the page's frame as a first
+ * surveyPoint would, so the point taken next lands under the ring. Overlay only: no undo step, no React render, so it
+ * can be called on every notification (BOLDR's T1R streams it at 20 Hz). Whether it's showing afterwards: never with
+ * no drawing open, in a wall view, or in a view-only drawing.
+ */
+export function surveyCursor(point: { x: number; y: number } | null): boolean {
+  if (!editorHost.open || !store.project) return false;
+  const ok = point && Number.isFinite(point.x) && Number.isFinite(point.y) ? point : null;
+  return setSurveyCursor(ok);
+}

package/src/render/draw.ts

@@ -1201,11 +1201,28 @@ function paintWall(ctx: C2D, W: number, fixed: C2D): void {
   drawKeyPlan(fixed, W - k - 14, 70, k, plan, f);
 }
 
+/**
+ * The templating device's live point (tools/survey.ts setSurveyCursor): a ring with a dot, where its next point would
+ * land. Screen-sized, so it reads the same at any zoom. Only on the plan it was placed on: a wall view has other axes.
+ */
+function drawSurveyCursor(ctx: C2D, T: Xform): void {
+  const c = ed.surveyCursor;
+  if (!c || elevOpen() || c.page !== page().id) return;
+  const [x, y] = S(T, c.x, c.y);
+  ctx.save();
+  ctx.setLineDash([]); ctx.lineWidth = 2; ctx.strokeStyle = TH.blue; ctx.fillStyle = TH.blue;
+  ctx.beginPath(); ctx.arc(x, y, 10, 0, Math.PI * 2); ctx.stroke();
+  ctx.beginPath(); ctx.arc(x, y, 2.5, 0, Math.PI * 2); ctx.fill();
+  ctx.restore();
+}
+
 function paintOverlay(ctx: C2D, W: number, H: number, fixed: C2D = ctx): void {
   const T = mainT();
   // a selected image's outline and handles: with the moving parts, as it's turned, moved or sized (over the drawing)
   drawUnderlaySelection(ctx, T);
   if (ed.preview) ed.preview(ctx, T);
+  // (over the tool's preview — the templator's would-be edge runs into it — whatever tool is in hand)
+  drawSurveyCursor(ctx, T);
   drawSnap(ctx, T);
   if (ed.boxSel) {
     const { x0, y0, x1, y1 } = ed.boxSel;

package/src/tools/index.ts

@@ -10,10 +10,12 @@ import { ed } from '../app/state';
 import { tools } from './registry';
 import { selectTool } from './select';
 import { arcTool, circleTool, rectTool } from './shapes';
+import { surveyTool } from './survey';
 import { cabinetTool, heightTool, wallDoorTool, wallWindowTool } from '../editor/elevation';
 
 export { tools, setTool, cancelTool } from './registry';
 export type { LineTool } from './line';
+export type { SurveyTool } from './survey';
 
 /** Register every tool. Called once from main (not at import time, so import cycles stay harmless). */
 export function registerTools(): void {
@@ -31,6 +33,8 @@ export function registerTools(): void {
     door: Object.assign({}, openingTool, { enter() { ed.openingType = 'door'; } }),
     window: Object.assign({}, openingTool, { enter() { ed.openingType = 'window'; } }),
     room: roomTool,
+    // the templator: not on the rail — a point from the host's device picks it up (see react/host.ts surveyPoint)
+    survey: surveyTool,
     aselect: makeAselectTool(),
     // markup tools: a press on a handle of the just-drawn markup reshapes it instead of drawing new
     pen: withHandles(penTool),