@things-factory/figure-ui 10.1.204 → 10.1.206

package/dist-client/modeller/keys.js

@@ -11,6 +11,12 @@ export function keyActionOf(e, selected) {
         return e.shiftKey ? 'redo' : 'undo';
     if (mod && key === 'y')
         return 'redo';
+    if (mod && key === 'c')
+        return selected ? 'copy' : 'hold';
+    if (mod && key === 'v')
+        return e.shiftKey ? 'hold' : 'paste';
+    if (mod && key === 'x')
+        return 'hold';
     if (!selected)
         return null;
     if (mod && key === 'd')

package/dist-client/modeller/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../client/modeller/keys.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,GAA6B,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;AAkBxF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAA;AAEvD,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,QAAgB;IACtD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/G,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACzB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IAC/B,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3D,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,WAAW,CAAA;IAC1C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,WAAW,CAAC;QAAE,OAAO,QAAQ,CAAA;IACtE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAA;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;IAChF,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/*\n * The modeller's keys: undo and redo on Ctrl+Z / Ctrl+Y, and what a person reaches for next. Read apart\n * from the element so the rule is tested without a browser.\n *\n * Typing is never taken: a key pressed in a field belongs to the field -- Backspace in a name box deletes a letter,\n * not the part.\n */\nexport type KeyAction = 'undo' | 'redo' | 'duplicate' | 'remove' | 'deselect' | GizmoKey\n\n/** The gizmo's modes on W, E and R, as the scene has them. */\nexport type GizmoKey = 'translate' | 'rotate' | 'scale'\nconst GIZMO_KEYS: Record<string, GizmoKey> = { w: 'translate', e: 'rotate', r: 'scale' }\n\nexport interface KeyLike {\n  key: string\n  ctrlKey?: boolean\n  metaKey?: boolean\n  shiftKey?: boolean\n  altKey?: boolean\n  /** The element the key was pressed in -- the first of the event's composed path. */\n  target?: { tagName?: string; isContentEditable?: boolean } | null\n  /**\n   * Pressed with the canvas focused. The scene takes W, E and R there itself; they are passed on only from elsewhere\n   * -- a part picked in the parts list left the focus there, and the gizmo could not be had at all (2026-09-25).\n   * Passing a key the scene already took would toggle the gizmo off again.\n   */\n  inScene?: boolean\n}\n\nconst TYPING = new Set(['INPUT', 'SELECT', 'TEXTAREA'])\n\nexport function keyActionOf(e: KeyLike, selected: string): KeyAction | null {\n  if (e.target && (TYPING.has(String(e.target.tagName).toUpperCase()) || e.target.isContentEditable)) return null\n  if (e.altKey) return null\n  const mod = !!(e.ctrlKey || e.metaKey)\n  const key = e.key.toLowerCase()\n  if (mod && key === 'z') return e.shiftKey ? 'redo' : 'undo'\n  if (mod && key === 'y') return 'redo'\n  if (!selected) return null\n  if (mod && key === 'd') return 'duplicate'\n  if (!mod && (key === 'delete' || key === 'backspace')) return 'remove'\n  if (!mod && key === 'escape') return 'deselect'\n  if (!mod && !e.shiftKey && !e.inScene && GIZMO_KEYS[key]) return GIZMO_KEYS[key]\n  return null\n}\n"]}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../client/modeller/keys.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,GAA6B,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;AAkBxF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAA;AAEvD,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,QAAgB;IACtD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/G,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACzB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IAC/B,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3D,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IACzD,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;IAC5D,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,WAAW,CAAA;IAC1C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,WAAW,CAAC;QAAE,OAAO,QAAQ,CAAA;IACtE,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAA;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;IAChF,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/*\n * The modeller's keys: undo and redo on Ctrl+Z / Ctrl+Y, and what a person reaches for next. Read apart\n * from the element so the rule is tested without a browser.\n *\n * Typing is never taken: a key pressed in a field belongs to the field -- Backspace in a name box deletes a letter,\n * not the part.\n */\n/*\n * `copy` · `paste` are the modeller's own: a part copied and pasted is the kernel's duplicate, with a name of its own.\n * Left to the scene, Ctrl+C / Ctrl+V copied the canvas object with the part's name -- two objects of one name, the copy\n * moving the original (user 2026-10-21). `hold` is a key kept from the scene that the modeller has no use for: the\n * scene's cut and bulk paste act on canvas objects alone and leave the figure out of step with them.\n */\nexport type KeyAction = 'undo' | 'redo' | 'duplicate' | 'remove' | 'deselect' | 'copy' | 'paste' | 'hold' | GizmoKey\n\n/** The gizmo's modes on W, E and R, as the scene has them. */\nexport type GizmoKey = 'translate' | 'rotate' | 'scale'\nconst GIZMO_KEYS: Record<string, GizmoKey> = { w: 'translate', e: 'rotate', r: 'scale' }\n\nexport interface KeyLike {\n  key: string\n  ctrlKey?: boolean\n  metaKey?: boolean\n  shiftKey?: boolean\n  altKey?: boolean\n  /** The element the key was pressed in -- the first of the event's composed path. */\n  target?: { tagName?: string; isContentEditable?: boolean } | null\n  /**\n   * Pressed with the canvas focused. The scene takes W, E and R there itself; they are passed on only from elsewhere\n   * -- a part picked in the parts list left the focus there, and the gizmo could not be had at all (2026-09-25).\n   * Passing a key the scene already took would toggle the gizmo off again.\n   */\n  inScene?: boolean\n}\n\nconst TYPING = new Set(['INPUT', 'SELECT', 'TEXTAREA'])\n\nexport function keyActionOf(e: KeyLike, selected: string): KeyAction | null {\n  if (e.target && (TYPING.has(String(e.target.tagName).toUpperCase()) || e.target.isContentEditable)) return null\n  if (e.altKey) return null\n  const mod = !!(e.ctrlKey || e.metaKey)\n  const key = e.key.toLowerCase()\n  if (mod && key === 'z') return e.shiftKey ? 'redo' : 'undo'\n  if (mod && key === 'y') return 'redo'\n  if (mod && key === 'c') return selected ? 'copy' : 'hold'\n  if (mod && key === 'v') return e.shiftKey ? 'hold' : 'paste'\n  if (mod && key === 'x') return 'hold'\n  if (!selected) return null\n  if (mod && key === 'd') return 'duplicate'\n  if (!mod && (key === 'delete' || key === 'backspace')) return 'remove'\n  if (!mod && key === 'escape') return 'deselect'\n  if (!mod && !e.shiftKey && !e.inScene && GIZMO_KEYS[key]) return GIZMO_KEYS[key]\n  return null\n}\n"]}

package/dist-client/modeller/links.d.ts

@@ -1,6 +1,6 @@
 import { figureJointAsFixed } from '@hatiolab/figure-model';
-import type { FigureFollow, FigureSizeRange } from '@hatiolab/figure-model';
-import type { FigureAsset, FigureAuthoringAction, FigureBindingPlace, FigureFace, FigureFacing, FigureJoint } from '@hatiolab/figure-model';
+import type { FigureFollow, FigureInstanceSizeRange } from '@hatiolab/figure-model';
+import type { FigureAsset, FigureAuthoringAction, FigureBindingPlace, FigureFace, FigureFacing, FigureJoint, FigureSurfacePlace } from '@hatiolab/figure-model';
 import { type FigureRevision } from './revision.js';
 import { type JointAxisVector } from './joint-axis.js';
 export type Axis = 'x' | 'y' | 'z';
@@ -14,6 +14,11 @@ export type Follow = FigureFollow;
  */
 /** What one measure of a part is worked out from, read back from the graph (figure-model's reader, one copy). */
 export declare function followOf(asset: FigureAsset, part: string, axis: Axis): Follow;
+/**
+ * The parts whose size follows the figure's size on some axis, in the model's order: the ones that change when the
+ * figure is resized on a drawing. Read by figure-model's own follow (`figureFollowOf`), not worked out again here.
+ */
+export declare function sizeFollowersOf(asset: FigureAsset): string[];
 /** Whether the asset declares an instance size on an axis — only then can a dimension follow it. */
 export declare const hasInstanceSize: (asset: FigureAsset, axis: Axis) => boolean;
 /** The part this one is fastened to, or `null`. The mounting plane counts as fastened (the model names no part). */
@@ -91,6 +96,11 @@ export declare function measureNow(revision: FigureRevision, part: string, axis:
  * written (a portal's opening sides as well as its outer faces). A sphere has none.
  */
 export declare function facesOf(asset: FigureAsset, part: string): string[];
+/** The curved surface a part offers to be fastened to at a point: a cylinder's side or a sphere's round (ADR-0140 3.9). */
+export declare function surfaceOf(asset: FigureAsset, part: string): {
+    form: 'around' | 'toward';
+    axis: Axis;
+} | undefined;
 /** The axis a face of a part faces along, from the same definitions. */
 export declare function faceAxisOf(asset: FigureAsset, part: string, face: string): Axis | undefined;
 /** Whether `attach` can take this part: any part whose shape has a flat face. */
@@ -105,7 +115,7 @@ export declare function rowAxesOf(asset: FigureAsset, part: string): Axis[];
  * Why a part cannot be made into a row here, in the terms `rowAxesOf` refuses it: said, not hidden (ADR-0097 §5.5).
  * Nothing when it can, or when it already is a row (that row is shown where it stands).
  */
-export declare function rowBlockOf(asset: FigureAsset, part: string): 'unfastened' | 'on-plane' | 'holds-parts' | 'at-origin' | undefined;
+export declare function rowBlockOf(asset: FigureAsset, part: string): 'unfastened' | 'on-plane' | 'holds-parts' | 'at-origin' | 'on-surface' | undefined;
 /** The row a part is made into, as its fastening's record keeps it. */
 export declare const rowOf: (asset: FigureAsset, part: string) => {
     axis: import("@hatiolab/figure-model").FigureJointAxis;
@@ -187,6 +197,8 @@ export declare function fasteningOf(revision: FigureRevision, part: string): {
     alignMm: Partial<Record<Axis, number>>;
     /** Placed by a part's origin (ADR-0107 decision 4): no face to fasten by, and the form does not write it. */
     atOrigin?: true;
+    /** On a point of the target's curved surface (ADR-0140 3.9), as the record says it. */
+    surface?: FigureSurfacePlace;
 } | null;
 /**
  * The `gap` an attach command writes from the form: a worked-out gap as it was read, else the number, else none. Read as
@@ -215,7 +227,7 @@ export declare function placeKeptOf(revision: FigureRevision, part: string, targ
 export declare function alignOf(asset: FigureAsset, target: {
     part: string;
     face: string;
-} | 'plane', how: Partial<Record<Axis, Alignment>>, mm: Partial<Record<Axis, number>>, inputs?: Partial<Record<Axis, string>>): Partial<Record<Axis, "min" | "max" | {
+} | 'plane', how: Partial<Record<Axis, Alignment>>, mm: Partial<Record<Axis, number>>, inputs?: Partial<Record<Axis, string>>): Partial<Record<Axis, "max" | "min" | {
     mm: number | {
         from: {
             of: "instance";
@@ -346,32 +358,27 @@ export declare const holdsThings: (asset: FigureAsset) => boolean;
 /** What `accepts` a person typed: names split on commas, trimmed, blanks and repeats dropped. */
 export declare const acceptsOf: (typed: string) => string[];
 /**
- * The sizes a board may give this figure: the range it declares now, and the range measured afresh -- the default
- * (1 mm to ten times the authored size) narrowed only where the figure cannot follow, by figure-model's own functions.
- * A range measured when a part filled what the others left (ROBOT_ARM: Y from 1,854 mm) stays narrow after the part is
- * made to grow with the figure; measuring again gives the figure its whole range back. Nothing when no size is declared.
+ * The sizes a board may give this figure, per axis: the ends its author narrowed, and the rest as far as its parts
+ * allow, computed by figure-model (`figureInstanceSizeRangeOf`, ADR-0087 decision 6) -- the screen does not measure
+ * on its own. Nothing when no size is declared.
  */
-export declare function instanceRangeOf(asset: FigureAsset): {
-    declared: FigureSizeRange;
-    measured: FigureSizeRange;
-} | undefined;
+export declare function instanceRangeOf(asset: FigureAsset): Record<Axis, FigureInstanceSizeRange> | undefined;
 /**
- * The size range to declare for a figure that has none yet: its parts' extent now as the size it is authored at, and
- * as wide as its parts allow around it (the same measure 「다시 재기」 uses). Undefined when the figure already has a
- * size or has nothing to measure. Without a declared size a board cannot resize the figure, and no part is offered
- * to follow its size -- every figure made in the modeller was left there (user, 2026-09-25).
+ * The size to declare for a figure that has none yet: its parts' extent now, the size it is authored at. Undefined when
+ * the figure already has a size or has nothing to measure. Without a declared size a board cannot resize the figure,
+ * and no part is offered to follow its size -- every figure made in the modeller was left there (user, 2026-09-25).
  */
-export declare function instanceRangeToDeclare(asset: FigureAsset): {
-    range: FigureSizeRange;
+export declare function instanceSizeToDeclare(asset: FigureAsset): {
     at: Record<Axis, number>;
 } | undefined;
-/** Whether measuring again would change the declared range (to a micrometre). */
 /**
- * The declared range with one end typed by the author: the sizes a figure may be placed at are a claim about the
- * product (a gantry spans metres, not 30 cm to 29 m), and measuring only ever widens them. Nothing when the typed
- * value is not a number; whether the figure holds there is the command's to say.
+ * The ends the author narrowed, with one end typed or cleared: a number narrows that end, an empty field opens it
+ * again to what the parts allow. Whether the figure holds there is the command's to say.
  */
-export declare function rangeWith(declared: FigureSizeRange, axis: Axis, bound: 'min' | 'max', value: number): FigureSizeRange | undefined;
+export declare function rangeWith(range: Record<Axis, FigureInstanceSizeRange>, axis: Axis, bound: 'min' | 'max', value: number): Partial<Record<Axis, {
+    min?: number;
+    max?: number;
+}>>;
 /**
  * For a figure that grows by one ratio: how many of its lengths would follow the ratio, and which it leaves with their
  * own number (not those that follow another length -- they grow with it). Nothing for a figure of another sizing.
@@ -382,7 +389,6 @@ export declare function proportionToFollow(asset: FigureAsset): {
 } | undefined;
 /** A value of the figure as it stands, by its graph reference. */
 export declare function valueNow(revision: FigureRevision, ref: string | undefined): number | undefined;
-export declare function rangeDiffers(a: FigureSizeRange, b: FigureSizeRange): boolean;
 /**
  * Whether the figure is a mechanism -- a part turns about a joint. Such a figure should grow by one ratio (chief
  * architect's ruling 2026-09-24); the modeller proposes it, the author declares it.

package/dist-client/modeller/links.js

@@ -1,4 +1,4 @@
-import { figureShapeFaces, figurePartsExtentOf, figureFollowOf, proposeFigureProportion, defaultInstanceSizeRange, foldInstanceSizeRange, figureAttachmentsOf, figureBindingsOf, figureInstanceSizeLimitsOf, figureFollowableAxesOf, figureShapeProviderOf, figureMimicTermsOf, figureFastenKeptPlaceOf, figureFastenAxesOf, figureJointAsFixed, figureJointWithMotion } from '@hatiolab/figure-model';
+import { figureShapeFaces, figurePartsExtentOf, figureFollowOf, proposeFigureProportion, figureAttachmentsOf, figureBindingsOf, figureInstanceSizeRangeOf, figureFollowableAxesOf, figureShapeProviderOf, figureMimicTermsOf, figureFastenKeptPlaceOf, figureFastenAxesOf, figureJointAsFixed, figureJointWithMotion, figureSurfaceOf } from '@hatiolab/figure-model';
 import { startingShapeKindOf } from './starting-shape.js';
 import { boxOf } from './align.js';
 import { graphValuesOf } from './revision.js';
@@ -14,6 +14,21 @@ const modelOf = (asset) => asset.document.model;
 export function followOf(asset, part, axis) {
     return figureFollowOf(asset, part, axis);
 }
+/**
+ * The parts whose size follows the figure's size on some axis, in the model's order: the ones that change when the
+ * figure is resized on a drawing. Read by figure-model's own follow (`figureFollowOf`), not worked out again here.
+ */
+export function sizeFollowersOf(asset) {
+    const parts = modelOf(asset).nodes.filter(n => n.op === 'place@1').map(n => n.id);
+    return parts.filter(part => AXES.some(axis => {
+        try {
+            return figureFollowOf(asset, part, axis).of === 'instance';
+        }
+        catch {
+            return false;
+        }
+    }));
+}
 /** Whether the asset declares an instance size on an axis — only then can a dimension follow it. */
 export const hasInstanceSize = (asset, axis) => modelOf(asset).inputs.some(i => i.id === `size.${axis}` && i.role === 'design');
 /** The part this one is fastened to, or `null`. The mounting plane counts as fastened (the model names no part). */
@@ -202,7 +217,13 @@ export function measureNow(revision, part, axis) {
  */
 export function facesOf(asset, part) {
     const shape = modelOf(asset).nodes.find(n => n.id === `${part}.shape`);
-    return inScreenOrder(Object.keys((shape && figureShapeFaces(shape)) ?? {}));
+    const faces = (shape && figureShapeFaces(shape)) ?? {};
+    /* A cylinder's curved side is no face: a part is fastened to a point on it (ADR-0140 3.9, `surfaceOf`). */
+    return inScreenOrder(Object.keys(faces).filter(f => faces[f].contact !== 'line'));
+}
+/** The curved surface a part offers to be fastened to at a point: a cylinder's side or a sphere's round (ADR-0140 3.9). */
+export function surfaceOf(asset, part) {
+    return figureSurfaceOf(asset, part);
 }
 /** Faces in the order the screen lists them: the six outer ones left to front, then the rest as the shape gives them. */
 const SCREEN_ORDER = ['left', 'right', 'bottom', 'top', 'back', 'front'];
@@ -217,7 +238,7 @@ export function faceAxisOf(asset, part, face) {
 }
 /** Whether `attach` can take this part: any part whose shape has a flat face. */
 export function canFasten(asset, part) {
-    return facesOf(asset, part).length > 0;
+    return facesOf(asset, part).length > 0 || !!surfaceOf(asset, part);
 }
 const OUTER = { x: ['left', 'right'], y: ['bottom', 'top'], z: ['back', 'front'] };
 /**
@@ -253,6 +274,9 @@ export function rowBlockOf(asset, part) {
         return 'on-plane';
     if (joints.some(o => 'part' in o.body0 && o.body0.part === part))
         return 'holds-parts';
+    /* On a point of a curved surface a row has no face to run across (ADR-0140 3.9): the kernel refuses it. */
+    if ('surface' in j.body0)
+        return 'on-surface';
     if (!('face' in j.body0) || 'at' in j.body1)
         return 'at-origin';
     return undefined;
@@ -328,8 +352,22 @@ export function fasteningOf(revision, part) {
         return null;
     const toPlane = 'plane' in record.body0;
     const target = 'part' in record.body0 ? record.body0.part : '';
+    const surface = 'surface' in record.body0 ? record.body0.surface : undefined;
     const targetFace = 'face' in record.body0 ? record.body0.face : 'top';
-    const atOrigin = !('plane' in record.body0) && (!('face' in record.body0) || 'at' in record.body1);
+    const atOrigin = !('plane' in record.body0) && ((!('face' in record.body0) && !surface) || 'at' in record.body1);
+    if (surface)
+        return {
+            toPlane,
+            target,
+            targetFace,
+            facing: record.origin?.facing ?? 'meet',
+            gap: typeof record.origin?.gap === 'number' ? record.origin.gap : 0,
+            ...(record.origin?.gap !== undefined && typeof record.origin.gap !== 'number' ? { gapKept: record.origin.gap } : {}),
+            align: {},
+            alignMm: {},
+            surface,
+            ...(atOrigin ? { atOrigin: true } : {})
+        };
     /* Where across the face: as the record says it, and where it says nothing, where the part stands now. */
     const kept = placeKeptOf(revision, part, toPlane ? 'plane' : { part: target, face: targetFace });
     for (const [axis, how] of Object.entries(record.origin?.align ?? {})) {
@@ -591,55 +629,45 @@ export const holdsThings = (asset) => (asset.document.capabilities.names ?? []).
 /** What `accepts` a person typed: names split on commas, trimmed, blanks and repeats dropped. */
 export const acceptsOf = (typed) => [...new Set(typed.split(',').map(one => one.trim()).filter(Boolean))];
 /**
- * The sizes a board may give this figure: the range it declares now, and the range measured afresh -- the default
- * (1 mm to ten times the authored size) narrowed only where the figure cannot follow, by figure-model's own functions.
- * A range measured when a part filled what the others left (ROBOT_ARM: Y from 1,854 mm) stays narrow after the part is
- * made to grow with the figure; measuring again gives the figure its whole range back. Nothing when no size is declared.
+ * The sizes a board may give this figure, per axis: the ends its author narrowed, and the rest as far as its parts
+ * allow, computed by figure-model (`figureInstanceSizeRangeOf`, ADR-0087 decision 6) -- the screen does not measure
+ * on its own. Nothing when no size is declared.
  */
 export function instanceRangeOf(asset) {
-    const inputs = modelOf(asset).inputs;
-    const declared = {};
-    const authored = {};
-    for (const axis of AXES) {
-        const input = inputs.find(i => i.id === `size.${axis}` && i.role === 'design');
-        const at = asset.designInputs[`size.${axis}`];
-        if (!input || typeof at !== 'number')
-            return undefined;
-        declared[axis] = { min: input.min ?? 0, max: input.max ?? Infinity };
-        authored[axis] = at;
-    }
-    const start = defaultInstanceSizeRange(authored);
-    const measured = foldInstanceSizeRange(start, figureInstanceSizeLimitsOf(asset, start)).range;
-    return { declared, measured };
+    const range = figureInstanceSizeRangeOf(asset);
+    return AXES.every(axis => range[axis]) ? range : undefined;
 }
 /**
- * The size range to declare for a figure that has none yet: its parts' extent now as the size it is authored at, and
- * as wide as its parts allow around it (the same measure 「다시 재기」 uses). Undefined when the figure already has a
- * size or has nothing to measure. Without a declared size a board cannot resize the figure, and no part is offered
- * to follow its size -- every figure made in the modeller was left there (user, 2026-09-25).
+ * The size to declare for a figure that has none yet: its parts' extent now, the size it is authored at. Undefined when
+ * the figure already has a size or has nothing to measure. Without a declared size a board cannot resize the figure,
+ * and no part is offered to follow its size -- every figure made in the modeller was left there (user, 2026-09-25).
  */
-export function instanceRangeToDeclare(asset) {
+export function instanceSizeToDeclare(asset) {
     if (instanceRangeOf(asset) || !asset.appearance.length)
         return undefined;
     /* The parts as they rest -- not the room their joints swing them through, which declared a door 8208 mm every way. */
     const at = figurePartsExtentOf(asset);
     if (AXES.some(axis => !(at[axis] > 0)))
         return undefined;
-    const start = defaultInstanceSizeRange(at);
-    return { range: foldInstanceSizeRange(start, figureInstanceSizeLimitsOf(asset, start)).range, at };
+    return { at };
 }
-/** Whether measuring again would change the declared range (to a micrometre). */
 /**
- * The declared range with one end typed by the author: the sizes a figure may be placed at are a claim about the
- * product (a gantry spans metres, not 30 cm to 29 m), and measuring only ever widens them. Nothing when the typed
- * value is not a number; whether the figure holds there is the command's to say.
+ * The ends the author narrowed, with one end typed or cleared: a number narrows that end, an empty field opens it
+ * again to what the parts allow. Whether the figure holds there is the command's to say.
  */
-export function rangeWith(declared, axis, bound, value) {
-    if (!Number.isFinite(value))
-        return undefined;
-    const next = structuredClone(declared);
-    next[axis][bound] = value;
-    return next;
+export function rangeWith(range, axis, bound, value) {
+    const out = {};
+    for (const a of AXES) {
+        const ends = {};
+        for (const b of ['min', 'max']) {
+            const typed = a === axis && b === bound;
+            if (typed ? Number.isFinite(value) : range[a].narrowed[b])
+                ends[b] = typed ? value : range[a][b];
+        }
+        if (Object.keys(ends).length)
+            out[a] = ends;
+    }
+    return out;
 }
 /**
  * For a figure that grows by one ratio: how many of its lengths would follow the ratio, and which it leaves with their
@@ -668,9 +696,6 @@ export function valueNow(revision, ref) {
         return undefined;
     }
 }
-export function rangeDiffers(a, b) {
-    return AXES.some(axis => Math.abs(a[axis].min - b[axis].min) > 1e-3 || Math.abs(a[axis].max - b[axis].max) > 1e-3);
-}
 /**
  * Whether the figure is a mechanism -- a part turns about a joint. Such a figure should grow by one ratio (chief
  * architect's ruling 2026-09-24); the modeller proposes it, the author declares it.