@things-factory/figure-ui 10.1.203 → 10.1.205

package/dist-client/modeller/fasten-form.d.ts

@@ -1,4 +1,4 @@
-import type { FigureAuthoringAction, FigureFace } from '@hatiolab/figure-model';
+import type { FigureAuthoringAction, FigureFace, FigureSurfacePlace } from '@hatiolab/figure-model';
 import { type FaceView, type FastenMode, type FastenTarget } from './fasten-geometry.js';
 import type { FastenChange } from './figure-fasten-drawing.js';
 import { type Alignment, type Axis } from './links.js';
@@ -15,6 +15,8 @@ export interface FastenForm {
     align: Partial<Record<Axis, Alignment>>;
     alignMm: Partial<Record<Axis, number>>;
     alignInput: Partial<Record<Axis, string>>;
+    /** On a point of the target's curved surface instead of a face (ADR-0140 3.9): where, as the record says it. */
+    surface?: FigureSurfacePlace;
 }
 export declare const freshFasten: () => FastenForm;
 /** The part's own fastening as a form, or a fresh one: a window opens on what the part has (walk 1, 2026-09-26). */
@@ -25,8 +27,15 @@ export declare function fastenTargetsOf(revision: FigureRevision, part: string):
     loops: boolean;
 }>;
 /**
- * A new aim: the plane, another part, or another face of the same part. Where on the face is filled in as where the
- * part stands now, so fastening it keeps it there (`placeKeptOf`); the author changes it from there.
+ * The point of a target's curved surface on the side the part stands on now (ADR-0140 3.9): the kernel's
+ * (`figureSurfaceKeptPlaceOf`), or, the part standing on its axis, the surface's first point.
+ */
+export declare function surfaceKeptOf(revision: FigureRevision, part: string, target: string): FigureSurfacePlace | undefined;
+/**
+ * A new aim: the plane, another part, another face of the same part, or a point of its curved surface. Where on the
+ * face -- or the surface -- is filled in as where the part stands now, so fastening it keeps it there (`placeKeptOf`,
+ * `surfaceKeptOf`); the author changes it from there. A part aimed at a sphere, or beside a cylinder's side within its
+ * length, is aimed at the surface: it is fastened as it stands (ADR-0140 3.6).
  */
 export declare function aimFasten(revision: FigureRevision, part: string, form: FastenForm, to: {
     plane: true;
@@ -34,6 +43,8 @@ export declare function aimFasten(revision: FigureRevision, part: string, form:
     part: string;
 } | {
     targetFace: FigureFace;
+} | {
+    surface: true;
 }): FastenForm;
 /** A change the drawing asks: a face, a way, a gap or a place across the face. */
 export declare function fastenChanged(revision: FigureRevision, part: string, form: FastenForm, change: FastenChange): FastenForm;
@@ -56,6 +67,12 @@ export interface FastenPlan {
         part: string;
         face: string;
     };
+    /** On a point of the target's curved surface: which surface, about which axis, and where (ADR-0140 3.9). */
+    surface?: {
+        form: 'around' | 'toward';
+        axis: Axis;
+        place: FigureSurfacePlace;
+    };
 }
 export declare function fastenPlanOf(revision: FigureRevision, part: string, f: FastenForm): FastenPlan;
 type Say = (key: string, params?: Record<string, string>) => string;
@@ -63,4 +80,20 @@ type Say = (key: string, params?: Record<string, string>) => string;
 export declare function fastenSentenceOf(form: FastenForm, plan: FastenPlan, planeWord: string, say: Say): string;
 /** What the folded details hold that is not their default, said while folded; nothing for the default. */
 export declare function fastenDetailWordsOf(form: FastenForm, say: Say): string[];
+/**
+ * A part pressed on the canvas while the window is open (ADR-0140 stage 4): aimed at, on the face or the point pressed,
+ * its middle where it was pressed -- the kernel's reading of the press (`figureFastenTargetAt`), the point and normal brought into that part's own
+ * frame by the pose its body is drawn at (`at.id`, a row's copy too). The part itself, one hanging from it, or one with
+ * nothing to fasten to is not aimed at; a press on a curve there is no fastening to aims at the part alone. Each says
+ * why, by its words' key.
+ */
+export declare function aimFastenAt(revision: FigureRevision, part: string, form: FastenForm, at: {
+    id: string;
+    point?: readonly number[];
+    normal?: readonly number[];
+}): {
+    form?: FastenForm;
+    note?: 'aim-self' | 'aim-cannot' | 'target-would-loop' | 'aim-not-here';
+    part: string;
+};
 export {};

package/dist-client/modeller/fasten-form.js

@@ -1,6 +1,7 @@
-import { FIGURE_FACES } from '@hatiolab/figure-model';
+import { FIGURE_FACES, figureFastenTargetAt, figurePlaneFacingOf, figureSurfaceKeptPlaceOf } from '@hatiolab/figure-model';
 import { faceViewOf } from './fasten-geometry.js';
-import { alignOf, alignRowsOf, canFasten, facesOf, fasteningOf, fastenGapOf, hangsFrom, heldBy, mountingPlaneOf, placeKeptOf } from './links.js';
+import { alignOf, alignRowsOf, canFasten, facesOf, fasteningOf, fastenGapOf, hangsFrom, heldBy, mountingPlaneOf, placeKeptOf, surfaceOf } from './links.js';
+import { ownerOf } from './fields.js';
 /*
  * A fastening as it is chosen, before it is done: to what, which face, how, where across the face. The fastening window
  * (`figure-fasten-dialog.ts`) holds one and changes it as the author chooses; the attach command is worked out from it
@@ -33,12 +34,36 @@ export function fastenTargetsOf(revision, part) {
         .map(one => ({ part: one, loops: hangsFrom(asset, one, part) })));
 }
 /**
- * A new aim: the plane, another part, or another face of the same part. Where on the face is filled in as where the
- * part stands now, so fastening it keeps it there (`placeKeptOf`); the author changes it from there.
+ * The point of a target's curved surface on the side the part stands on now (ADR-0140 3.9): the kernel's
+ * (`figureSurfaceKeptPlaceOf`), or, the part standing on its axis, the surface's first point.
+ */
+export function surfaceKeptOf(revision, part, target) {
+    const surface = surfaceOf(revision.asset, target);
+    if (!surface)
+        return undefined;
+    return (figureSurfaceKeptPlaceOf(revision.asset, part, target, { ...revision.inputs }) ??
+        (surface.form === 'around' ? { around: 0, along: 'centre' } : { toward: { x: 0, y: 1, z: 0 } }));
+}
+/**
+ * A new aim: the plane, another part, another face of the same part, or a point of its curved surface. Where on the
+ * face -- or the surface -- is filled in as where the part stands now, so fastening it keeps it there (`placeKeptOf`,
+ * `surfaceKeptOf`); the author changes it from there. A part aimed at a sphere, or beside a cylinder's side within its
+ * length, is aimed at the surface: it is fastened as it stands (ADR-0140 3.6).
  */
 export function aimFasten(revision, part, form, to) {
+    if ('surface' in to)
+        return { ...form, surface: surfaceKeptOf(revision, part, form.target), align: {}, alignMm: {}, alignInput: {} };
+    if ('part' in to) {
+        /* Beside its curved surface -- a sphere's anywhere, a cylinder's side within its length -- or with no face at all. */
+        const beside = figureSurfaceKeptPlaceOf(revision.asset, part, to.part, { ...revision.inputs });
+        const kept = beside ?? (!facesOf(revision.asset, to.part).length ? surfaceKeptOf(revision, part, to.part) : undefined);
+        if (kept)
+            return { ...form, toPlane: false, target: to.part, surface: kept, align: {}, alignMm: {}, alignInput: {} };
+    }
+    form = { ...form, surface: undefined };
+    /* Aimed at the plane, it meets it toward the side the placement uses -- below a ceiling -- until the author says (ADR-0140 3.11). */
     const f = 'plane' in to
-        ? { ...form, toPlane: true, target: '' }
+        ? { ...form, toPlane: true, target: '', facing: form.toPlane ? form.facing : (figurePlaneFacingOf(revision.asset) ?? form.facing) }
         : 'part' in to
             ? { ...form, toPlane: false, target: to.part }
             : { ...form, targetFace: to.targetFace };
@@ -56,6 +81,10 @@ export function fastenChanged(revision, part, form, change) {
     const f = form;
     if ('targetFace' in change)
         return aimFasten(revision, part, f, { targetFace: change.targetFace });
+    if ('onSurface' in change)
+        return aimFasten(revision, part, f, { surface: true });
+    if ('surface' in change)
+        return { ...f, surface: change.surface };
     if ('mode' in change)
         return { ...f, facing: change.mode };
     if ('gap' in change)
@@ -76,7 +105,21 @@ export function fastenPlanOf(revision, part, f) {
             ? { part: f.target, face: targetFace }
             : undefined;
     /* The plane takes a part standing on it or hanging below it, a wall only one standing out of it (ADR-0140 3.11). */
-    const mode = f.toPlane ? (mountingPlaneOf(asset).facings.includes(f.facing) ? f.facing : 'meet') : f.facing;
+    const planeWay = figurePlaneFacingOf(asset);
+    const mode = f.toPlane ? (mountingPlaneOf(asset).facings.includes(f.facing) ? f.facing : (planeWay ?? 'meet')) : f.facing;
+    const surface = !f.toPlane && f.target && f.surface ? surfaceOf(asset, f.target) : undefined;
+    if (surface) {
+        /* On the surface: where is the surface's own words, so no alignment goes with it (ADR-0140 3.9). */
+        const action = {
+            kind: 'attach',
+            part,
+            to: { part: f.target, surface: f.surface },
+            facing: mode,
+            ...fastenGapOf(f),
+            replace: !!heldBy(asset, part)
+        };
+        return { theirFaces, targetFace, mode, alignRows: [], action, surface: { ...surface, place: f.surface } };
+    }
     if (!aim)
         return { theirFaces, targetFace, mode, alignRows: [] };
     const align = alignOf(asset, aim, f.align, f.alignMm, f.alignInput);
@@ -85,7 +128,8 @@ export function fastenPlanOf(revision, part, f) {
         kind: 'attach',
         part,
         to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: targetFace },
-        ...(f.toPlane ? (mode === 'flush' ? { facing: mode } : {}) : { facing: mode }),
+        /* On the plane the kernel takes the placement's way when none is said: only another way is said. */
+        ...(f.toPlane ? (mode === planeWay ? {} : { facing: mode }) : { facing: mode }),
         ...fastenGapOf(f),
         ...(align ? { align } : {}),
         replace: !!heldBy(asset, part)
@@ -103,7 +147,8 @@ export function fastenPlanOf(revision, part, f) {
 }
 /** 「bin의 윗면에 올려놓기」: what the fastening is, in one line -- the part is the one the window is open on, not named again. */
 export function fastenSentenceOf(form, plan, planeWord, say) {
-    const to = form.toPlane ? planeWord : `${form.target}의 ${say('figure.label.face-' + plan.targetFace)}`;
+    const where = plan.surface ? say('figure.label.surface-' + plan.surface.form) : say('figure.label.face-' + plan.targetFace);
+    const to = form.toPlane ? planeWord : `${form.target}의 ${where}`;
     return say(`figure.text.fasten-sentence-${plan.mode}`, { to });
 }
 /** What the folded details hold that is not their default, said while folded; nothing for the default. */
@@ -116,4 +161,37 @@ export function fastenDetailWordsOf(form, say) {
                 : [])
     ];
 }
+/**
+ * A part pressed on the canvas while the window is open (ADR-0140 stage 4): aimed at, on the face or the point pressed,
+ * its middle where it was pressed -- the kernel's reading of the press (`figureFastenTargetAt`), the point and normal brought into that part's own
+ * frame by the pose its body is drawn at (`at.id`, a row's copy too). The part itself, one hanging from it, or one with
+ * nothing to fasten to is not aimed at; a press on a curve there is no fastening to aims at the part alone. Each says
+ * why, by its words' key.
+ */
+export function aimFastenAt(revision, part, form, at) {
+    const target = ownerOf(at.id);
+    const offered = fastenTargetsOf(revision, part).find(t => t.part === target);
+    if (target === part)
+        return { note: 'aim-self', part: target };
+    if (!offered)
+        return { note: 'aim-cannot', part: target };
+    if (offered.loops)
+        return { note: 'target-would-loop', part: target };
+    const aimed = aimFasten(revision, part, form, { part: target });
+    const pose = revision.geometry.find(g => g.id === at.id)?.pose;
+    if (!pose || !at.point || !at.normal)
+        return { form: aimed, part: target };
+    /* Into the part's own frame: rᵀ (p − t), and the normal by rᵀ. */
+    const own = (v, from = [0, 0, 0]) => [0, 1, 2].map(c => [0, 1, 2].reduce((sum, i) => sum + pose.r[i][c] * (v[i] - from[i]), 0));
+    const lands = figureFastenTargetAt(revision.asset, target, own(at.point, pose.t), own(at.normal), { ...revision.inputs });
+    if ('face' in lands) {
+        /* On the face where it was pressed, as a point of a curved surface is: its middle there. */
+        const onFace = aimFasten(revision, part, { ...aimed, surface: undefined }, { targetFace: lands.face });
+        const at = lands.at;
+        return { form: { ...onFace, align: Object.fromEntries(Object.keys(at).map(a => [a, 'mm'])), alignMm: { ...at }, alignInput: {} }, part: target };
+    }
+    if ('surface' in lands)
+        return { form: { ...aimed, toPlane: false, target, surface: lands.surface, align: {}, alignMm: {}, alignInput: {} }, part: target };
+    return { form: aimed, note: 'aim-not-here', part: target };
+}
 //# sourceMappingURL=fasten-form.js.map

package/dist-client/modeller/fasten-form.js.map

@@ -1 +1 @@
-{"version":3,"file":"fasten-form.js","sourceRoot":"","sources":["../../client/modeller/fasten-form.ts"],"names":[],"mappings":"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","sourcesContent":["import { FIGURE_FACES } from '@hatiolab/figure-model'\nimport type { FigureAuthoringAction, FigureFace } from '@hatiolab/figure-model'\n\nimport { faceViewOf, type FaceView, type FastenMode, type FastenTarget } from './fasten-geometry.js'\nimport type { FastenChange } from './figure-fasten-drawing.js'\nimport {\n  alignOf,\n  alignRowsOf,\n  canFasten,\n  facesOf,\n  fasteningOf,\n  fastenGapOf,\n  hangsFrom,\n  heldBy,\n  mountingPlaneOf,\n  placeKeptOf,\n  type Alignment,\n  type Axis\n} from './links.js'\nimport type { FigureRevision } from './revision.js'\n\n/*\n * A fastening as it is chosen, before it is done: to what, which face, how, where across the face. The fastening window\n * (`figure-fasten-dialog.ts`) holds one and changes it as the author chooses; the attach command is worked out from it\n * only here, so the window, its preview and the panel's 「정렬 고치기」 send the same command for the same choice.\n */\n\nconst FACES = Object.keys(FIGURE_FACES) as FigureFace[]\n\nexport interface FastenForm {\n  toPlane: boolean\n  target: string\n  targetFace: FigureFace\n  /** How it meets the face: its near end on it, its far end on it (flush), or its middle (ADR-0140 3.11). */\n  facing: FastenMode\n  gap: number\n  /** The record's gap when it is worked out (a length that follows something): kept until a number is typed. */\n  gapKept: unknown\n  align: Partial<Record<Axis, Alignment>>\n  alignMm: Partial<Record<Axis, number>>\n  alignInput: Partial<Record<Axis, string>>\n}\n\nexport const freshFasten = (): FastenForm => ({\n  toPlane: false,\n  target: '',\n  targetFace: 'top',\n  facing: 'meet',\n  gap: 0,\n  gapKept: undefined,\n  align: {},\n  alignMm: {},\n  alignInput: {}\n})\n\n/** The part's own fastening as a form, or a fresh one: a window opens on what the part has (walk 1, 2026-09-26). */\nexport function fastenFormOf(revision: FigureRevision, part: string): FastenForm {\n  const own = fasteningOf(revision, part)\n  return own && !own.atOrigin ? ({ ...freshFasten(), ...own } as FastenForm) : freshFasten()\n}\n\n/** What a part may be fastened to: every other part that can be, each said whether it would close a loop. */\nexport function fastenTargetsOf(revision: FigureRevision, part: string): Array<{ part: string; loops: boolean }> {\n  const asset = revision.asset\n  return (\n    asset.appearance\n      .map(look => look.target)\n      .filter(one => one !== part && canFasten(asset, one))\n      /* Not a part that hangs from this one: fastening a frame to its own roller would close a loop. */\n      .map(one => ({ part: one, loops: hangsFrom(asset, one, part) }))\n  )\n}\n\n/**\n * A new aim: the plane, another part, or another face of the same part. Where on the face is filled in as where the\n * part stands now, so fastening it keeps it there (`placeKeptOf`); the author changes it from there.\n */\nexport function aimFasten(\n  revision: FigureRevision,\n  part: string,\n  form: FastenForm,\n  to: { plane: true } | { part: string } | { targetFace: FigureFace }\n): FastenForm {\n  const f: FastenForm =\n    'plane' in to\n      ? { ...form, toPlane: true, target: '' }\n      : 'part' in to\n        ? { ...form, toPlane: false, target: to.part }\n        : { ...form, targetFace: to.targetFace }\n  const theirFaces = f.target ? facesOf(revision.asset, f.target) : FACES\n  const targetFace = (theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0]) as FigureFace\n  const aim: FastenTarget | undefined = f.toPlane\n    ? 'plane'\n    : f.target\n      ? { part: f.target, face: targetFace }\n      : undefined\n  return { ...f, ...(aim ? placeKeptOf(revision, part, aim) : { align: {}, alignMm: {}, alignInput: {} }) }\n}\n\n/** A change the drawing asks: a face, a way, a gap or a place across the face. */\nexport function fastenChanged(\n  revision: FigureRevision,\n  part: string,\n  form: FastenForm,\n  change: FastenChange\n): FastenForm {\n  const f = form\n  if ('targetFace' in change) return aimFasten(revision, part, f, { targetFace: change.targetFace as FigureFace })\n  if ('mode' in change) return { ...f, facing: change.mode }\n  if ('gap' in change) return { ...f, gap: change.gap, gapKept: undefined }\n  return {\n    ...f,\n    align: { ...f.align, [change.axis]: change.how },\n    alignMm: change.how === 'mm' ? { ...f.alignMm, [change.axis]: change.mm ?? 0 } : f.alignMm\n  }\n}\n\n/** What a form comes to: the face aimed at, the way, the drawing of the face and the command. */\nexport interface FastenPlan {\n  /** Nothing is aimed at until a part or the plane is chosen. */\n  aim?: FastenTarget\n  theirFaces: string[]\n  targetFace: FigureFace\n  mode: FastenMode\n  view?: FaceView\n  /** The axes across the face asked in rows: where the drawing cannot set the place. */\n  alignRows: { axis: Axis; edges: boolean }[]\n  action?: FigureAuthoringAction\n  /** The face the command would meet, lit on the canvas while it is tried. */\n  face?: { part: string; face: string }\n}\n\nexport function fastenPlanOf(revision: FigureRevision, part: string, f: FastenForm): FastenPlan {\n  const asset = revision.asset\n  const theirFaces = f.target ? facesOf(asset, f.target) : FACES\n  const targetFace = (theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0]) as FigureFace\n  const aim: FastenTarget | undefined = f.toPlane\n    ? 'plane'\n    : f.target\n      ? { part: f.target, face: targetFace }\n      : undefined\n  /* The plane takes a part standing on it or hanging below it, a wall only one standing out of it (ADR-0140 3.11). */\n  const mode: FastenMode = f.toPlane ? (mountingPlaneOf(asset).facings.includes(f.facing) ? f.facing : 'meet') : f.facing\n  if (!aim) return { theirFaces, targetFace, mode, alignRows: [] }\n  const align = alignOf(asset, aim, f.align, f.alignMm, f.alignInput)\n  const view = faceViewOf(revision, part, aim, mode)\n  const action = {\n    kind: 'attach',\n    part,\n    to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: targetFace },\n    ...(f.toPlane ? (mode === 'flush' ? { facing: mode } : {}) : { facing: mode }),\n    ...fastenGapOf(f),\n    ...(align ? { align } : {}),\n    replace: !!heldBy(asset, part)\n  } as FigureAuthoringAction\n  return {\n    aim,\n    theirFaces,\n    targetFace,\n    mode,\n    view,\n    alignRows: alignRowsOf(asset, aim, view, f.alignInput),\n    action,\n    ...(f.toPlane ? {} : { face: { part: f.target, face: targetFace } })\n  }\n}\n\ntype Say = (key: string, params?: Record<string, string>) => string\n\n/** 「bin의 윗면에 올려놓기」: what the fastening is, in one line -- the part is the one the window is open on, not named again. */\nexport function fastenSentenceOf(\n  form: FastenForm,\n  plan: FastenPlan,\n  planeWord: string,\n  say: Say\n): string {\n  const to = form.toPlane ? planeWord : `${form.target}의 ${say('figure.label.face-' + plan.targetFace)}`\n  return say(`figure.text.fasten-sentence-${plan.mode}`, { to })\n}\n\n/** What the folded details hold that is not their default, said while folded; nothing for the default. */\nexport function fastenDetailWordsOf(form: FastenForm, say: Say): string[] {\n  return [\n    ...(form.gapKept !== undefined\n      ? [say('figure.text.fasten-summary-gap-worked-out')]\n      : form.gap\n        ? [say('figure.text.fasten-summary-gap', { mm: String(form.gap) })]\n        : [])\n  ]\n}\n"]}
+{"version":3,"file":"fasten-form.js","sourceRoot":"","sources":["../../client/modeller/fasten-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAG1H,OAAO,EAAE,UAAU,EAAqD,MAAM,sBAAsB,CAAA;AAEpG,OAAO,EACL,OAAO,EACP,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,SAAS,EACT,MAAM,EACN,eAAe,EACf,WAAW,EACX,SAAS,EAGV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;;GAIG;AAEH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAiB,CAAA;AAkBvD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAe,EAAE,CAAC,CAAC;IAC5C,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,UAAU,EAAE,EAAE;CACf,CAAC,CAAA;AAEF,oHAAoH;AACpH,MAAM,UAAU,YAAY,CAAC,QAAwB,EAAE,IAAY;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACvC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,GAAG,EAAiB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AAC5F,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,eAAe,CAAC,QAAwB,EAAE,IAAY;IACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAC5B,OAAO,CACL,KAAK,CAAC,UAAU;SACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;SACxB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrD,kGAAkG;SACjG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CACnE,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAwB,EAAE,IAAY,EAAE,MAAc;IAClF,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAC9B,OAAO,CACL,wBAAwB,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9E,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAChG,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,QAAwB,EACxB,IAAY,EACZ,IAAgB,EAChB,EAAuF;IAEvF,IAAI,SAAS,IAAI,EAAE;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IACpI,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjB,sHAAsH;QACtH,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QAC9F,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACtH,IAAI,IAAI;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;IACtH,CAAC;IACD,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IACtC,qIAAqI;IACrI,MAAM,CAAC,GACL,OAAO,IAAI,EAAE;QACX,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;QACnI,CAAC,CAAC,MAAM,IAAI,EAAE;YACZ,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE;YAC9C,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAA;IAC9C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACvE,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAe,CAAA;IACnG,MAAM,GAAG,GAA6B,CAAC,CAAC,OAAO;QAC7C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;YACtC,CAAC,CAAC,SAAS,CAAA;IACf,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;AAC3G,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,IAAY,EACZ,IAAgB,EAChB,MAAoB;IAEpB,MAAM,CAAC,GAAG,IAAI,CAAA;IACd,IAAI,YAAY,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAwB,EAAE,CAAC,CAAA;IAChH,IAAI,WAAW,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IACjF,IAAI,SAAS,IAAI,MAAM;QAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;IACjE,IAAI,MAAM,IAAI,MAAM;QAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAA;IAC1D,IAAI,KAAK,IAAI,MAAM;QAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;IACzE,OAAO;QACL,GAAG,CAAC;QACJ,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE;QAChD,OAAO,EAAE,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;KAC3F,CAAA;AACH,CAAC;AAmBD,MAAM,UAAU,YAAY,CAAC,QAAwB,EAAE,IAAY,EAAE,CAAa;IAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAA;IAC5B,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9D,MAAM,UAAU,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAe,CAAA;IACnG,MAAM,GAAG,GAA6B,CAAC,CAAC,OAAO;QAC7C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;YACtC,CAAC,CAAC,SAAS,CAAA;IACf,oHAAoH;IACpH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACrI,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5F,IAAI,OAAO,EAAE,CAAC;QACZ,oGAAoG;QACpG,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,QAAQ;YACd,IAAI;YACJ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;YAC1C,MAAM,EAAE,IAAI;YACZ,GAAG,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;SACN,CAAA;QAC1B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,OAAQ,EAAE,EAAE,CAAA;IAC5G,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,CAAA;IACnE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;QAClF,oGAAoG;QACpG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC/E,GAAG,WAAW,CAAC,CAAC,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;KACN,CAAA;IAC1B,OAAO;QACL,GAAG;QACH,UAAU;QACV,UAAU;QACV,IAAI;QACJ,IAAI;QACJ,SAAS,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC;QACtD,MAAM;QACN,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;KACrE,CAAA;AACH,CAAC;AAID,yHAAyH;AACzH,MAAM,UAAU,gBAAgB,CAC9B,IAAgB,EAChB,IAAgB,EAChB,SAAiB,EACjB,GAAQ;IAER,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,uBAAuB,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;IAC3H,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAA;IAChE,OAAO,GAAG,CAAC,+BAA+B,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,mBAAmB,CAAC,IAAgB,EAAE,GAAQ;IAC5D,OAAO;QACL,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS;YAC5B,CAAC,CAAC,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,GAAG;gBACR,CAAC,CAAC,CAAC,GAAG,CAAC,gCAAgC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC,CAAC,EAAE,CAAC;KACV,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,QAAwB,EACxB,IAAY,EACZ,IAAgB,EAChB,EAAyE;IAEzE,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC7B,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;IAC5E,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC9D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzD,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACrE,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/D,MAAM,IAAI,GAAI,QAAQ,CAAC,QAAyE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAA;IAChI,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC1E,kEAAkE;IAClE,MAAM,GAAG,GAAG,CAAC,CAAoB,EAAE,OAA0B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzK,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IACzH,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACpB,4FAA4F;QAC5F,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,IAAkB,EAAE,CAAC,CAAA;QACpH,MAAM,EAAE,GAAG,KAAK,CAAC,EAAmC,CAAA;QACpD,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAwB,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACzK,CAAC;IACD,IAAI,SAAS,IAAI,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC3J,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAC5D,CAAC","sourcesContent":["import { FIGURE_FACES, figureFastenTargetAt, figurePlaneFacingOf, figureSurfaceKeptPlaceOf } from '@hatiolab/figure-model'\nimport type { FigureAuthoringAction, FigureFace, FigureSurfacePlace } from '@hatiolab/figure-model'\n\nimport { faceViewOf, type FaceView, type FastenMode, type FastenTarget } from './fasten-geometry.js'\nimport type { FastenChange } from './figure-fasten-drawing.js'\nimport {\n  alignOf,\n  alignRowsOf,\n  canFasten,\n  facesOf,\n  fasteningOf,\n  fastenGapOf,\n  hangsFrom,\n  heldBy,\n  mountingPlaneOf,\n  placeKeptOf,\n  surfaceOf,\n  type Alignment,\n  type Axis\n} from './links.js'\nimport type { FigureRevision } from './revision.js'\nimport { ownerOf } from './fields.js'\n\n/*\n * A fastening as it is chosen, before it is done: to what, which face, how, where across the face. The fastening window\n * (`figure-fasten-dialog.ts`) holds one and changes it as the author chooses; the attach command is worked out from it\n * only here, so the window, its preview and the panel's 「정렬 고치기」 send the same command for the same choice.\n */\n\nconst FACES = Object.keys(FIGURE_FACES) as FigureFace[]\n\nexport interface FastenForm {\n  toPlane: boolean\n  target: string\n  targetFace: FigureFace\n  /** How it meets the face: its near end on it, its far end on it (flush), or its middle (ADR-0140 3.11). */\n  facing: FastenMode\n  gap: number\n  /** The record's gap when it is worked out (a length that follows something): kept until a number is typed. */\n  gapKept: unknown\n  align: Partial<Record<Axis, Alignment>>\n  alignMm: Partial<Record<Axis, number>>\n  alignInput: Partial<Record<Axis, string>>\n  /** On a point of the target's curved surface instead of a face (ADR-0140 3.9): where, as the record says it. */\n  surface?: FigureSurfacePlace\n}\n\nexport const freshFasten = (): FastenForm => ({\n  toPlane: false,\n  target: '',\n  targetFace: 'top',\n  facing: 'meet',\n  gap: 0,\n  gapKept: undefined,\n  align: {},\n  alignMm: {},\n  alignInput: {}\n})\n\n/** The part's own fastening as a form, or a fresh one: a window opens on what the part has (walk 1, 2026-09-26). */\nexport function fastenFormOf(revision: FigureRevision, part: string): FastenForm {\n  const own = fasteningOf(revision, part)\n  return own && !own.atOrigin ? ({ ...freshFasten(), ...own } as FastenForm) : freshFasten()\n}\n\n/** What a part may be fastened to: every other part that can be, each said whether it would close a loop. */\nexport function fastenTargetsOf(revision: FigureRevision, part: string): Array<{ part: string; loops: boolean }> {\n  const asset = revision.asset\n  return (\n    asset.appearance\n      .map(look => look.target)\n      .filter(one => one !== part && canFasten(asset, one))\n      /* Not a part that hangs from this one: fastening a frame to its own roller would close a loop. */\n      .map(one => ({ part: one, loops: hangsFrom(asset, one, part) }))\n  )\n}\n\n/**\n * The point of a target's curved surface on the side the part stands on now (ADR-0140 3.9): the kernel's\n * (`figureSurfaceKeptPlaceOf`), or, the part standing on its axis, the surface's first point.\n */\nexport function surfaceKeptOf(revision: FigureRevision, part: string, target: string): FigureSurfacePlace | undefined {\n  const surface = surfaceOf(revision.asset, target)\n  if (!surface) return undefined\n  return (\n    figureSurfaceKeptPlaceOf(revision.asset, part, target, { ...revision.inputs }) ??\n    (surface.form === 'around' ? { around: 0, along: 'centre' } : { toward: { x: 0, y: 1, z: 0 } })\n  )\n}\n\n/**\n * A new aim: the plane, another part, another face of the same part, or a point of its curved surface. Where on the\n * face -- or the surface -- is filled in as where the part stands now, so fastening it keeps it there (`placeKeptOf`,\n * `surfaceKeptOf`); the author changes it from there. A part aimed at a sphere, or beside a cylinder's side within its\n * length, is aimed at the surface: it is fastened as it stands (ADR-0140 3.6).\n */\nexport function aimFasten(\n  revision: FigureRevision,\n  part: string,\n  form: FastenForm,\n  to: { plane: true } | { part: string } | { targetFace: FigureFace } | { surface: true }\n): FastenForm {\n  if ('surface' in to) return { ...form, surface: surfaceKeptOf(revision, part, form.target), align: {}, alignMm: {}, alignInput: {} }\n  if ('part' in to) {\n    /* Beside its curved surface -- a sphere's anywhere, a cylinder's side within its length -- or with no face at all. */\n    const beside = figureSurfaceKeptPlaceOf(revision.asset, part, to.part, { ...revision.inputs })\n    const kept = beside ?? (!facesOf(revision.asset, to.part).length ? surfaceKeptOf(revision, part, to.part) : undefined)\n    if (kept) return { ...form, toPlane: false, target: to.part, surface: kept, align: {}, alignMm: {}, alignInput: {} }\n  }\n  form = { ...form, surface: undefined }\n  /* Aimed at the plane, it meets it toward the side the placement uses -- below a ceiling -- until the author says (ADR-0140 3.11). */\n  const f: FastenForm =\n    'plane' in to\n      ? { ...form, toPlane: true, target: '', facing: form.toPlane ? form.facing : (figurePlaneFacingOf(revision.asset) ?? form.facing) }\n      : 'part' in to\n        ? { ...form, toPlane: false, target: to.part }\n        : { ...form, targetFace: to.targetFace }\n  const theirFaces = f.target ? facesOf(revision.asset, f.target) : FACES\n  const targetFace = (theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0]) as FigureFace\n  const aim: FastenTarget | undefined = f.toPlane\n    ? 'plane'\n    : f.target\n      ? { part: f.target, face: targetFace }\n      : undefined\n  return { ...f, ...(aim ? placeKeptOf(revision, part, aim) : { align: {}, alignMm: {}, alignInput: {} }) }\n}\n\n/** A change the drawing asks: a face, a way, a gap or a place across the face. */\nexport function fastenChanged(\n  revision: FigureRevision,\n  part: string,\n  form: FastenForm,\n  change: FastenChange\n): FastenForm {\n  const f = form\n  if ('targetFace' in change) return aimFasten(revision, part, f, { targetFace: change.targetFace as FigureFace })\n  if ('onSurface' in change) return aimFasten(revision, part, f, { surface: true })\n  if ('surface' in change) return { ...f, surface: change.surface }\n  if ('mode' in change) return { ...f, facing: change.mode }\n  if ('gap' in change) return { ...f, gap: change.gap, gapKept: undefined }\n  return {\n    ...f,\n    align: { ...f.align, [change.axis]: change.how },\n    alignMm: change.how === 'mm' ? { ...f.alignMm, [change.axis]: change.mm ?? 0 } : f.alignMm\n  }\n}\n\n/** What a form comes to: the face aimed at, the way, the drawing of the face and the command. */\nexport interface FastenPlan {\n  /** Nothing is aimed at until a part or the plane is chosen. */\n  aim?: FastenTarget\n  theirFaces: string[]\n  targetFace: FigureFace\n  mode: FastenMode\n  view?: FaceView\n  /** The axes across the face asked in rows: where the drawing cannot set the place. */\n  alignRows: { axis: Axis; edges: boolean }[]\n  action?: FigureAuthoringAction\n  /** The face the command would meet, lit on the canvas while it is tried. */\n  face?: { part: string; face: string }\n  /** On a point of the target's curved surface: which surface, about which axis, and where (ADR-0140 3.9). */\n  surface?: { form: 'around' | 'toward'; axis: Axis; place: FigureSurfacePlace }\n}\n\nexport function fastenPlanOf(revision: FigureRevision, part: string, f: FastenForm): FastenPlan {\n  const asset = revision.asset\n  const theirFaces = f.target ? facesOf(asset, f.target) : FACES\n  const targetFace = (theirFaces.includes(f.targetFace) ? f.targetFace : theirFaces[0]) as FigureFace\n  const aim: FastenTarget | undefined = f.toPlane\n    ? 'plane'\n    : f.target\n      ? { part: f.target, face: targetFace }\n      : undefined\n  /* The plane takes a part standing on it or hanging below it, a wall only one standing out of it (ADR-0140 3.11). */\n  const planeWay = figurePlaneFacingOf(asset)\n  const mode: FastenMode = f.toPlane ? (mountingPlaneOf(asset).facings.includes(f.facing) ? f.facing : (planeWay ?? 'meet')) : f.facing\n  const surface = !f.toPlane && f.target && f.surface ? surfaceOf(asset, f.target) : undefined\n  if (surface) {\n    /* On the surface: where is the surface's own words, so no alignment goes with it (ADR-0140 3.9). */\n    const action = {\n      kind: 'attach',\n      part,\n      to: { part: f.target, surface: f.surface },\n      facing: mode,\n      ...fastenGapOf(f),\n      replace: !!heldBy(asset, part)\n    } as FigureAuthoringAction\n    return { theirFaces, targetFace, mode, alignRows: [], action, surface: { ...surface, place: f.surface! } }\n  }\n  if (!aim) return { theirFaces, targetFace, mode, alignRows: [] }\n  const align = alignOf(asset, aim, f.align, f.alignMm, f.alignInput)\n  const view = faceViewOf(revision, part, aim, mode)\n  const action = {\n    kind: 'attach',\n    part,\n    to: f.toPlane ? { plane: 'mounting-plane' } : { part: f.target, face: targetFace },\n    /* On the plane the kernel takes the placement's way when none is said: only another way is said. */\n    ...(f.toPlane ? (mode === planeWay ? {} : { facing: mode }) : { facing: mode }),\n    ...fastenGapOf(f),\n    ...(align ? { align } : {}),\n    replace: !!heldBy(asset, part)\n  } as FigureAuthoringAction\n  return {\n    aim,\n    theirFaces,\n    targetFace,\n    mode,\n    view,\n    alignRows: alignRowsOf(asset, aim, view, f.alignInput),\n    action,\n    ...(f.toPlane ? {} : { face: { part: f.target, face: targetFace } })\n  }\n}\n\ntype Say = (key: string, params?: Record<string, string>) => string\n\n/** 「bin의 윗면에 올려놓기」: what the fastening is, in one line -- the part is the one the window is open on, not named again. */\nexport function fastenSentenceOf(\n  form: FastenForm,\n  plan: FastenPlan,\n  planeWord: string,\n  say: Say\n): string {\n  const where = plan.surface ? say('figure.label.surface-' + plan.surface.form) : say('figure.label.face-' + plan.targetFace)\n  const to = form.toPlane ? planeWord : `${form.target}의 ${where}`\n  return say(`figure.text.fasten-sentence-${plan.mode}`, { to })\n}\n\n/** What the folded details hold that is not their default, said while folded; nothing for the default. */\nexport function fastenDetailWordsOf(form: FastenForm, say: Say): string[] {\n  return [\n    ...(form.gapKept !== undefined\n      ? [say('figure.text.fasten-summary-gap-worked-out')]\n      : form.gap\n        ? [say('figure.text.fasten-summary-gap', { mm: String(form.gap) })]\n        : [])\n  ]\n}\n\n/**\n * A part pressed on the canvas while the window is open (ADR-0140 stage 4): aimed at, on the face or the point pressed,\n * its middle where it was pressed -- the kernel's reading of the press (`figureFastenTargetAt`), the point and normal brought into that part's own\n * frame by the pose its body is drawn at (`at.id`, a row's copy too). The part itself, one hanging from it, or one with\n * nothing to fasten to is not aimed at; a press on a curve there is no fastening to aims at the part alone. Each says\n * why, by its words' key.\n */\nexport function aimFastenAt(\n  revision: FigureRevision,\n  part: string,\n  form: FastenForm,\n  at: { id: string; point?: readonly number[]; normal?: readonly number[] }\n): { form?: FastenForm; note?: 'aim-self' | 'aim-cannot' | 'target-would-loop' | 'aim-not-here'; part: string } {\n  const target = ownerOf(at.id)\n  const offered = fastenTargetsOf(revision, part).find(t => t.part === target)\n  if (target === part) return { note: 'aim-self', part: target }\n  if (!offered) return { note: 'aim-cannot', part: target }\n  if (offered.loops) return { note: 'target-would-loop', part: target }\n  const aimed = aimFasten(revision, part, form, { part: target })\n  const pose = (revision.geometry as Array<{ id: string; pose?: { r: number[][]; t: number[] } }>).find(g => g.id === at.id)?.pose\n  if (!pose || !at.point || !at.normal) return { form: aimed, part: target }\n  /* Into the part's own frame: rᵀ (p − t), and the normal by rᵀ. */\n  const own = (v: readonly number[], from: readonly number[] = [0, 0, 0]) => [0, 1, 2].map(c => [0, 1, 2].reduce((sum, i) => sum + pose.r[i]![c]! * (v[i]! - from[i]!), 0))\n  const lands = figureFastenTargetAt(revision.asset, target, own(at.point, pose.t), own(at.normal), { ...revision.inputs })\n  if ('face' in lands) {\n    /* On the face where it was pressed, as a point of a curved surface is: its middle there. */\n    const onFace = aimFasten(revision, part, { ...aimed, surface: undefined }, { targetFace: lands.face as FigureFace })\n    const at = lands.at as Partial<Record<Axis, number>>\n    return { form: { ...onFace, align: Object.fromEntries(Object.keys(at).map(a => [a, 'mm'])) as FastenForm['align'], alignMm: { ...at }, alignInput: {} }, part: target }\n  }\n  if ('surface' in lands) return { form: { ...aimed, toPlane: false, target, surface: lands.surface, align: {}, alignMm: {}, alignInput: {} }, part: target }\n  return { form: aimed, note: 'aim-not-here', part: target }\n}\n"]}

package/dist-client/modeller/figure-fasten-dialog.d.ts

@@ -7,9 +7,10 @@ import './figure-fasten-drawing.js';
 import type { FigureRevision } from './revision.js';
 declare const FigureFastenDialog_base: (new (...args: any[]) => LitElement) & typeof LitElement;
 /**
- * 붙이기 창: what the selected part is fastened to, on which face, how (user 2026-10-17: 「속성에는 심플하고 직관적인
- * 결과 위주로, 편집은 팝업에서 넓은 공간을 써서」). The editor stands it over the side panel with its title and close,
- * where the canvas stays in sight (2026-10-19: the standard popup, always modal, hid the 3D it was choosing for).
+ * 붙이기 창: what the selected part is fastened to, on which face, how -- chosen with room to see it, in the standard
+ * popup the editor opens (`openPopup`: its title, its close, moved by its head; no backdrop, so the canvas can be
+ * pressed while it is open) (user 2026-10-17: 「속성에는 심플하고 직관적인 결과 위주로, 편집은 팝업에서 넓은 공간을
+ * 써서」; 2026-10-18: the standard popup, not a window of its own; put back 2026-10-20).
  *
  * Everything chosen here is tried, not done: the command it comes to is told to the editor as it changes
  * (`preview-command`), and the canvas draws it. 「적용」 sends it once (`fasten-apply`), one step of the history;
@@ -29,6 +30,8 @@ export declare class FigureFastenDialog extends FigureFastenDialog_base {
     /** Why the last 「적용」 was refused, in the editor's words. */
     error: string;
     private form?;
+    /** Why a press on the canvas aimed at nothing, or only at the part (ADR-0140 stage 4); cleared by the next choice. */
+    private aimNote;
     /** The command the part's own fastening comes to, as opened: tried unchanged, nothing new is said of it. */
     private opened?;
     private told;
@@ -51,6 +54,17 @@ export declare class FigureFastenDialog extends FigureFastenDialog_base {
      */
     private renderLoops;
     private aim;
+    /**
+     * A part pressed on the canvas while the window is open (ADR-0140 stage 4): aimed at, on the face or the point pressed
+     * -- the kernel's reading of the press (`figureFastenTargetAt`), the point and normal brought into that part's own
+     * frame by the pose it is drawn at. The part itself, or one hanging from it, is not aimed at; and a press on a curve
+     * there is no fastening to aims at the part alone. Each is said.
+     */
+    aimAt(at: {
+        id: string;
+        point?: number[];
+        normal?: number[];
+    }): void;
     /** The part under the pointer or the focus in the list, for the canvas to light; the plane lights nothing. */
     private hover;
     private set;

package/dist-client/modeller/figure-fasten-dialog.js

@@ -10,14 +10,15 @@ import { CommonPopupStyles } from '@operato/styles';
 import { SidePanelStyles } from '@things-factory/figure-viewer/dist-client/side-panel-styles.js';
 import './figure-fasten-drawing.js';
 import { turnsInPlace } from './fasten-geometry.js';
-import { aimFasten, fastenChanged, fastenDetailWordsOf, fastenFormOf, fastenPlanOf, fastenSentenceOf, fastenTargetsOf } from './fasten-form.js';
-import { fieldWordsOf, hasInstanceSize, heldBy, mountingPlaneOf } from './links.js';
+import { aimFasten, aimFastenAt, fastenChanged, fastenDetailWordsOf, fastenFormOf, fastenPlanOf, fastenSentenceOf, fastenTargetsOf } from './fasten-form.js';
+import { fieldWordsOf, hasInstanceSize, heldBy, mountingPlaneOf, surfaceOf } from './links.js';
 /** The target list's entry for the plane the figure stands by. */
 const PLANE = '__plane';
 /**
- * 붙이기 창: what the selected part is fastened to, on which face, how (user 2026-10-17: 「속성에는 심플하고 직관적인
- * 결과 위주로, 편집은 팝업에서 넓은 공간을 써서」). The editor stands it over the side panel with its title and close,
- * where the canvas stays in sight (2026-10-19: the standard popup, always modal, hid the 3D it was choosing for).
+ * 붙이기 창: what the selected part is fastened to, on which face, how -- chosen with room to see it, in the standard
+ * popup the editor opens (`openPopup`: its title, its close, moved by its head; no backdrop, so the canvas can be
+ * pressed while it is open) (user 2026-10-17: 「속성에는 심플하고 직관적인 결과 위주로, 편집은 팝업에서 넓은 공간을
+ * 써서」; 2026-10-18: the standard popup, not a window of its own; put back 2026-10-20).
  *
  * Everything chosen here is tried, not done: the command it comes to is told to the editor as it changes
  * (`preview-command`), and the canvas draws it. 「적용」 sends it once (`fasten-apply`), one step of the history;
@@ -35,6 +36,8 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         this.previewWords = [];
         /** Why the last 「적용」 was refused, in the editor's words. */
         this.error = '';
+        /** Why a press on the canvas aimed at nothing, or only at the part (ADR-0140 stage 4); cleared by the next choice. */
+        this.aimNote = '';
         this.told = '';
         this.hovered = null;
         this.onKey = async (e) => {
@@ -79,11 +82,16 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         SidePanelStyles,
         CommonPopupStyles,
         css `
+      /*
+        The popup holds it at its own height and cuts what is past the screen: the window scrolls itself, within the
+        screen less the popup's head and margins, 취소 · 적용 kept at its foot (below).
+      */
       :host {
         display: grid;
         gap: 16px;
         padding: var(--popup-padding, 16px);
         overflow: auto;
+        max-height: calc(100dvh - 32px - 56px);
       }
       /* The result in one line, at the top: it changes with every choice below it. */
       p[fasten-sentence] {
@@ -137,7 +145,7 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         margin: 0;
         color: var(--md-sys-color-error);
       }
-      /* 취소 · 적용 stay in sight at the window's foot when what is above them is taller than the panel. */
+      /* 취소 · 적용 stay in sight at the window's foot when what is above them is taller than the screen. */
       ox-popup-actions {
         position: sticky;
         bottom: calc(-1 * var(--popup-padding, 16px));
@@ -205,11 +213,16 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         .alignMm=${f.alignMm}
         .gap=${f.gap}
         .partName=${this.partId}
+        .surfaceForm=${f.toPlane || !f.target ? '' : (surfaceOf(asset, f.target)?.form ?? '')}
+        .surface=${plan.surface}
         ?locked=${this.locked}
-        @fasten-change=${(e) => (this.form = fastenChanged(revision, this.partId, this.form, e.detail))}
+        @fasten-change=${(e) => {
+            this.aimNote = '';
+            this.form = fastenChanged(revision, this.partId, this.form, e.detail);
+        }}
       ></figure-fasten-drawing>`;
         return html `
-      ${plan.aim
+      ${plan.aim || plan.surface
             ? html `<p fasten-sentence role="status">
               ${fastenSentenceOf(f, plan, planeWord, (key, params) => i18next.t(key, params))}
             </p>`
@@ -218,13 +231,15 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         <h4 id="what">${i18next.t('figure.label.fasten-what')}</h4>
         ${this.renderTargets(revision, f, planeWord)}
       </div>
-      ${plan.aim
+      ${plan.aim || plan.surface
             ? html `<div question="face">
                 <h4>
                   ${
             /* The face asked is the target's, named: the part meets it by its real shape, by no face of its own. */ f.toPlane
                 ? i18next.t('figure.label.fasten-face-on-plane', { plane: planeWord })
-                : i18next.t('figure.label.fasten-face-on-part', { part: f.target })}
+                : /* A sphere has no face to choose: where on its surface. */ plan.theirFaces.length
+                    ? i18next.t('figure.label.fasten-face-on-part', { part: f.target })
+                    : i18next.t('figure.label.fasten-face-on-surface', { part: f.target })}
                 </h4>
                 ${drawing('face')}
               </div>
@@ -255,6 +270,7 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
               </div>
               ${ /* The one it has, tried unchanged: that it stays where it is goes without saying. */JSON.stringify(plan.action ?? null) === this.opened ? nothing : this.renderPreviewWords()}`
             : nothing}
+      ${this.aimNote ? html `<p hint aim-note role="status">${this.aimNote}</p>` : nothing}
       ${this.error ? html `<p error role="alert">${this.error}</p>` : nothing}
       <ox-popup-actions>
         <md-text-button slot="cancel" cancel @click=${this.cancel}>${i18next.t('figure.button.cancel')}</md-text-button>
@@ -312,11 +328,26 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
     aim(part) {
         if (this.locked || !this.revision || !this.form)
             return;
+        this.aimNote = '';
         const chosen = this.form.toPlane ? PLANE : this.form.target;
         if (part === chosen)
             return;
         this.form = aimFasten(this.revision, this.partId, this.form, part === PLANE ? { plane: true } : { part });
     }
+    /**
+     * A part pressed on the canvas while the window is open (ADR-0140 stage 4): aimed at, on the face or the point pressed
+     * -- the kernel's reading of the press (`figureFastenTargetAt`), the point and normal brought into that part's own
+     * frame by the pose it is drawn at. The part itself, or one hanging from it, is not aimed at; and a press on a curve
+     * there is no fastening to aims at the part alone. Each is said.
+     */
+    aimAt(at) {
+        if (this.locked || !this.revision || !this.form)
+            return;
+        const aimed = aimFastenAt(this.revision, this.partId, this.form, at);
+        this.aimNote = aimed.note ? i18next.t(`figure.text.${aimed.note}`, { part: aimed.part, mine: this.partId }) : '';
+        if (aimed.form)
+            this.form = aimed.form;
+    }
     /** The part under the pointer or the focus in the list, for the canvas to light; the plane lights nothing. */
     hover(part) {
         const lit = part && part !== PLANE ? part : null;
@@ -398,6 +429,8 @@ let FigureFastenDialog = class FigureFastenDialog extends localize(i18next)(LitE
         this.setAttribute('role', 'dialog');
         this.setAttribute('aria-label', i18next.t('figure.label.fastening'));
         this.addEventListener('keydown', this.onKey);
+        /* The popup's fitting width is the overlay's own setting; the window asks it for room for the face and the way side by side. */
+        this.closest('ox-floating-overlay')?.style.setProperty('--overlay-center-fit-width', '640px');
     }
 };
 __decorate([
@@ -424,6 +457,10 @@ __decorate([
     state(),
     __metadata("design:type", Object)
 ], FigureFastenDialog.prototype, "form", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], FigureFastenDialog.prototype, "aimNote", void 0);
 FigureFastenDialog = __decorate([
     customElement('figure-fasten-dialog')
 ], FigureFastenDialog);