@things-factory/figure-ui 10.1.25 → 10.1.27

package/dist-client/modeller/joint-edits.js

@@ -0,0 +1,175 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ */
+/** The limits a new joint starts with. Revolute in degrees, prismatic in millimetres. */
+const NEW_LIMITS = {
+    revolute: { min: -90, max: 90 },
+    prismatic: { min: 0, max: 500 }
+};
+/** The span a parameter driving a continuous joint offers: one turn either way. */
+const CONTINUOUS_SPAN = { min: -360, max: 360 };
+/** The joint whose child is this part, if any. */
+export function jointOf(draft, part) {
+    return draft?.joints?.find(joint => joint.child === part);
+}
+/**
+ * Parts a part may be attached to: every other part except itself and anything attached below it, since
+ * either would close a loop the format refuses (`parent-cycle`).
+ */
+export function parentChoices(parts, part) {
+    const below = new Set([part]);
+    let grew = true;
+    while (grew) {
+        grew = false;
+        for (const one of parts) {
+            if (one.parent !== undefined && below.has(one.parent) && !below.has(one.name)) {
+                below.add(one.name);
+                grew = true;
+            }
+        }
+    }
+    return parts.map(one => one.name).filter(name => !!name && !below.has(name));
+}
+function freeName(taken, stem) {
+    const used = new Set(taken);
+    if (!used.has(stem))
+        return stem;
+    for (let n = 2;; n++)
+        if (!used.has(`${stem}-${n}`))
+            return `${stem}-${n}`;
+}
+/** The span the driving parameter offers for a joint: its limits, or one turn either way when it has none. */
+function spanOf(joint) {
+    return joint.limits ?? CONTINUOUS_SPAN;
+}
+function drivingParameter(joint) {
+    const span = spanOf(joint);
+    return {
+        name: joint.name,
+        range: { unit: joint.type === 'prismatic' ? 'mm' : 'deg', min: span.min, max: span.max },
+        default: 0,
+        clip: {
+            channels: [
+                {
+                    target: joint.name,
+                    keys: [
+                        { at: 0, value: span.min },
+                        { at: 1, value: span.max }
+                    ]
+                }
+            ]
+        }
+    };
+}
+/**
+ * Whether a parameter is the plain one `setJointType` made for a joint: one channel on that joint, keys at
+ * 0 and 1 spanning the given limits. Only such a parameter follows the joint when its limits or type change;
+ * one the author reshaped is left as written.
+ */
+function isPlainDriver(parameter, joint, span) {
+    const channels = parameter.clip?.channels ?? [];
+    if (channels.length !== 1)
+        return false;
+    const [channel] = channels;
+    if (channel.target !== joint.name || channel.path !== undefined)
+        return false;
+    const keys = channel.keys;
+    return (keys.length === 2 &&
+        keys[0].at === 0 &&
+        keys[1].at === 1 &&
+        keys[0].value === span.min &&
+        keys[1].value === span.max &&
+        parameter.range?.min === span.min &&
+        parameter.range?.max === span.max);
+}
+/**
+ * Sets how a part moves relative to its parent, or clears the joint with `undefined`.
+ *
+ * - From none: adds a joint whose origin is the centre of the part's bottom face, with a vertical axis and
+ *   starting limits, and a parameter that drives it over those limits.
+ * - To none: removes the joint and every channel that drove it; a parameter or clip left with no channel
+ *   is removed too, because the format refuses an empty one.
+ * - Between types: keeps the origin and axis, sets limits for the new type (none for continuous), and
+ *   moves a plain driving parameter along with them.
+ */
+export function setJointType(draft, part, type) {
+    const joints = draft.joints ?? [];
+    const existing = joints.find(joint => joint.child === part.name);
+    if (type === undefined) {
+        if (!existing)
+            return draft;
+        return withoutJoint(draft, existing.name);
+    }
+    if (!existing) {
+        const { position, size } = part.transform;
+        const joint = {
+            name: freeName([...joints.map(one => one.name)], `${part.name}-joint`),
+            child: part.name,
+            type,
+            origin: { x: position.x, y: position.y - size.y / 2, z: position.z },
+            axis: { x: 0, y: 1, z: 0 }
+        };
+        if (type !== 'continuous')
+            joint.limits = { ...NEW_LIMITS[type] };
+        const parameters = draft.parameters ?? [];
+        const taken = [...parameters.map(one => one.name), ...(draft.animations ?? []).map(one => one.name)];
+        const driver = drivingParameter(joint);
+        driver.name = freeName(taken, joint.name);
+        return { ...draft, joints: [...joints, joint], parameters: [...parameters, driver] };
+    }
+    if (existing.type === type)
+        return draft;
+    const next = { ...existing, type };
+    if (type === 'continuous')
+        delete next.limits;
+    else if (existing.type === 'continuous' || (existing.type === 'prismatic') !== (type === 'prismatic')) {
+        next.limits = { ...NEW_LIMITS[type] };
+    }
+    return replaceJoint(draft, existing, next);
+}
+/** Changes a joint's origin, axis or limits. A plain driving parameter follows new limits. */
+export function patchJoint(draft, name, patch) {
+    const existing = draft.joints?.find(joint => joint.name === name);
+    if (!existing)
+        return draft;
+    const next = { ...existing, ...patch };
+    if (existing.type === 'continuous')
+        delete next.limits;
+    return replaceJoint(draft, existing, next);
+}
+function replaceJoint(draft, before, after) {
+    const joints = (draft.joints ?? []).map(joint => (joint === before ? after : joint));
+    const was = spanOf(before);
+    const unitChanged = (before.type === 'prismatic') !== (after.type === 'prismatic');
+    const spanChanged = was.min !== spanOf(after).min || was.max !== spanOf(after).max;
+    if (!unitChanged && !spanChanged)
+        return { ...draft, joints };
+    const parameters = (draft.parameters ?? []).map(parameter => {
+        if (!isPlainDriver(parameter, before, was))
+            return parameter;
+        const driver = drivingParameter(after);
+        return { ...parameter, range: driver.range, clip: { ...parameter.clip, channels: driver.clip.channels } };
+    });
+    return { ...draft, joints, parameters };
+}
+function withoutJoint(draft, name) {
+    const keep = (one) => (one.channels ?? []).filter(channel => channel.target !== name);
+    const parameters = (draft.parameters ?? [])
+        .map(parameter => ({ ...parameter, clip: { ...parameter.clip, channels: keep(parameter.clip) } }))
+        .filter(parameter => parameter.clip.channels.length > 0);
+    const animations = (draft.animations ?? [])
+        .map(clip => ({ ...clip, channels: keep(clip) }))
+        .filter(clip => clip.channels.length > 0);
+    const joints = (draft.joints ?? []).filter(joint => joint.name !== name);
+    const next = { ...draft };
+    if (joints.length > 0)
+        next.joints = joints;
+    else
+        delete next.joints;
+    if (draft.parameters !== undefined)
+        next.parameters = parameters;
+    if (draft.animations !== undefined)
+        next.animations = animations;
+    return next;
+}
+//# sourceMappingURL=joint-edits.js.map

package/dist-client/modeller/joint-edits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joint-edits.js","sourceRoot":"","sources":["../../client/modeller/joint-edits.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\n\nimport type { FigureJoint, FigurePart, JointType, Vec3 } from '@hatiolab/figure-model'\n\nimport type { FigureDraft, PartModel } from './figure-source.js'\n\n/**\n * Editing joints and parents (ADR-0066). Pure functions over the draft and the part list, so the inspector\n * only renders and dispatches.\n *\n * A joint is always created together with the parameter that drives it. Values reach a joint only through\n * `parameters`, and the preview draws a slider per parameter, so a joint without one could be defined but\n * never seen moving.\n */\n\ntype Parameter = NonNullable<FigureDraft['parameters']>[number]\n\n/** The limits a new joint starts with. Revolute in degrees, prismatic in millimetres. */\nconst NEW_LIMITS: Record<Exclude<JointType, 'continuous'>, { min: number; max: number }> = {\n  revolute: { min: -90, max: 90 },\n  prismatic: { min: 0, max: 500 }\n}\n\n/** The span a parameter driving a continuous joint offers: one turn either way. */\nconst CONTINUOUS_SPAN = { min: -360, max: 360 }\n\n/** The joint whose child is this part, if any. */\nexport function jointOf(draft: FigureDraft | undefined, part: string): FigureJoint | undefined {\n  return draft?.joints?.find(joint => joint.child === part)\n}\n\n/**\n * Parts a part may be attached to: every other part except itself and anything attached below it, since\n * either would close a loop the format refuses (`parent-cycle`).\n */\nexport function parentChoices(parts: readonly PartModel[], part: string): string[] {\n  const below = new Set<string>([part])\n  let grew = true\n  while (grew) {\n    grew = false\n    for (const one of parts) {\n      if (one.parent !== undefined && below.has(one.parent) && !below.has(one.name)) {\n        below.add(one.name)\n        grew = true\n      }\n    }\n  }\n  return parts.map(one => one.name).filter(name => !!name && !below.has(name))\n}\n\nfunction freeName(taken: Iterable<string>, stem: string): string {\n  const used = new Set(taken)\n  if (!used.has(stem)) return stem\n  for (let n = 2; ; n++) if (!used.has(`${stem}-${n}`)) return `${stem}-${n}`\n}\n\n/** The span the driving parameter offers for a joint: its limits, or one turn either way when it has none. */\nfunction spanOf(joint: FigureJoint): { min: number; max: number } {\n  return joint.limits ?? CONTINUOUS_SPAN\n}\n\nfunction drivingParameter(joint: FigureJoint): Parameter {\n  const span = spanOf(joint)\n  return {\n    name: joint.name,\n    range: { unit: joint.type === 'prismatic' ? 'mm' : 'deg', min: span.min, max: span.max },\n    default: 0,\n    clip: {\n      channels: [\n        {\n          target: joint.name,\n          keys: [\n            { at: 0, value: span.min },\n            { at: 1, value: span.max }\n          ]\n        }\n      ]\n    }\n  }\n}\n\n/**\n * Whether a parameter is the plain one `setJointType` made for a joint: one channel on that joint, keys at\n * 0 and 1 spanning the given limits. Only such a parameter follows the joint when its limits or type change;\n * one the author reshaped is left as written.\n */\nfunction isPlainDriver(parameter: Parameter, joint: FigureJoint, span: { min: number; max: number }): boolean {\n  const channels = parameter.clip?.channels ?? []\n  if (channels.length !== 1) return false\n  const [channel] = channels\n  if (channel!.target !== joint.name || channel!.path !== undefined) return false\n  const keys = channel!.keys as { at: number; value: number }[]\n  return (\n    keys.length === 2 &&\n    keys[0]!.at === 0 &&\n    keys[1]!.at === 1 &&\n    keys[0]!.value === span.min &&\n    keys[1]!.value === span.max &&\n    parameter.range?.min === span.min &&\n    parameter.range?.max === span.max\n  )\n}\n\n/**\n * Sets how a part moves relative to its parent, or clears the joint with `undefined`.\n *\n * - From none: adds a joint whose origin is the centre of the part's bottom face, with a vertical axis and\n *   starting limits, and a parameter that drives it over those limits.\n * - To none: removes the joint and every channel that drove it; a parameter or clip left with no channel\n *   is removed too, because the format refuses an empty one.\n * - Between types: keeps the origin and axis, sets limits for the new type (none for continuous), and\n *   moves a plain driving parameter along with them.\n */\nexport function setJointType(draft: FigureDraft, part: FigurePart, type: JointType | undefined): FigureDraft {\n  const joints = draft.joints ?? []\n  const existing = joints.find(joint => joint.child === part.name)\n\n  if (type === undefined) {\n    if (!existing) return draft\n    return withoutJoint(draft, existing.name)\n  }\n\n  if (!existing) {\n    const { position, size } = part.transform\n    const joint: FigureJoint = {\n      name: freeName([...joints.map(one => one.name)], `${part.name}-joint`),\n      child: part.name,\n      type,\n      origin: { x: position.x, y: position.y - size.y / 2, z: position.z },\n      axis: { x: 0, y: 1, z: 0 }\n    }\n    if (type !== 'continuous') joint.limits = { ...NEW_LIMITS[type] }\n\n    const parameters = draft.parameters ?? []\n    const taken = [...parameters.map(one => one.name), ...(draft.animations ?? []).map(one => one.name)]\n    const driver = drivingParameter(joint)\n    driver.name = freeName(taken, joint.name)\n\n    return { ...draft, joints: [...joints, joint], parameters: [...parameters, driver] }\n  }\n\n  if (existing.type === type) return draft\n\n  const next: FigureJoint = { ...existing, type }\n  if (type === 'continuous') delete next.limits\n  else if (existing.type === 'continuous' || (existing.type === 'prismatic') !== (type === 'prismatic')) {\n    next.limits = { ...NEW_LIMITS[type] }\n  }\n\n  return replaceJoint(draft, existing, next)\n}\n\n/** Changes a joint's origin, axis or limits. A plain driving parameter follows new limits. */\nexport function patchJoint(\n  draft: FigureDraft,\n  name: string,\n  patch: { origin?: Vec3; axis?: Vec3; limits?: { min: number; max: number } }\n): FigureDraft {\n  const existing = draft.joints?.find(joint => joint.name === name)\n  if (!existing) return draft\n  const next: FigureJoint = { ...existing, ...patch }\n  if (existing.type === 'continuous') delete next.limits\n  return replaceJoint(draft, existing, next)\n}\n\nfunction replaceJoint(draft: FigureDraft, before: FigureJoint, after: FigureJoint): FigureDraft {\n  const joints = (draft.joints ?? []).map(joint => (joint === before ? after : joint))\n  const was = spanOf(before)\n  const unitChanged = (before.type === 'prismatic') !== (after.type === 'prismatic')\n  const spanChanged = was.min !== spanOf(after).min || was.max !== spanOf(after).max\n\n  if (!unitChanged && !spanChanged) return { ...draft, joints }\n\n  const parameters = (draft.parameters ?? []).map(parameter => {\n    if (!isPlainDriver(parameter, before, was)) return parameter\n    const driver = drivingParameter(after)\n    return { ...parameter, range: driver.range, clip: { ...parameter.clip, channels: driver.clip.channels } }\n  })\n  return { ...draft, joints, parameters }\n}\n\nfunction withoutJoint(draft: FigureDraft, name: string): FigureDraft {\n  const keep = <T extends { channels?: { target: string }[] }>(one: T) => (one.channels ?? []).filter(channel => channel.target !== name)\n\n  const parameters = (draft.parameters ?? [])\n    .map(parameter => ({ ...parameter, clip: { ...parameter.clip, channels: keep(parameter.clip) } }) as Parameter)\n    .filter(parameter => parameter.clip.channels.length > 0)\n  const animations = (draft.animations ?? [])\n    .map(clip => ({ ...clip, channels: keep(clip) }) as NonNullable<FigureDraft['animations']>[number])\n    .filter(clip => clip.channels.length > 0)\n  const joints = (draft.joints ?? []).filter(joint => joint.name !== name)\n\n  const next: FigureDraft = { ...draft }\n  if (joints.length > 0) next.joints = joints\n  else delete next.joints\n  if (draft.parameters !== undefined) next.parameters = parameters\n  if (draft.animations !== undefined) next.animations = animations\n  return next\n}\n"]}

package/dist-client/modeller/proposal-session.d.ts

@@ -12,6 +12,11 @@ export interface ProposalSession {
     picked: Set<string>;
     note: string;
     metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>;
+    /**
+     * The release-check fix this session was opened from, if any. The page translates the title from it;
+     * this module stays free of i18n because node tests import it directly.
+     */
+    fix?: FigureGateFix;
 }
 /** 서버 후보를 검토 세션으로 연다. 저장 형식이 아니면 화면에 후보를 열지 않는다. */
 export declare function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession;

package/dist-client/modeller/proposal-session.js

@@ -6,7 +6,7 @@ function selectedKeys(current, source) {
 export function openAiProposal(current, proposal) {
     const source = JSON.parse(proposal.source);
     if (!source || !Array.isArray(source.parts)) {
-        throw new Error('AI 후보의 Figure 형식이 올바르지 않습니다.');
+        throw new Error('the AI candidate is not a figure source: parts is missing or not an array');
     }
     return {
         source,
@@ -32,7 +32,8 @@ export function openSizingFix(current, fix) {
     };
     return {
         source,
-        title: `발행 검사 수정안 · ${fix.part}.anchor.${fix.axis}: ${fix.from ?? 'auto'} → ${fix.to}`,
+        title: '',
+        fix,
         picked: selectedKeys(current, source),
         note: ''
     };

package/dist-client/modeller/proposal-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"proposal-session.js","sourceRoot":"","sources":["../../client/modeller/proposal-session.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FigureSource } from '@hatiolab/figure-model'\n\nimport type { FigureGateFix, FigureProposal, ProposalFeedback } from '../types.js'\nimport { diffProposal } from './proposal.js'\n\n/**\n * 한 번의 AI 후보 검토에만 존재하는 상태다.\n *\n * 후보는 정본이 아니다. 후보 원본·선택·메모·측정값을 한 값으로 묶어 두면 화면이\n * 수락/거절 중 일부만 이전 후보에서 남기는 일이 없다.\n */\nexport interface ProposalSession {\n  source: FigureSource\n  title: string\n  picked: Set<string>\n  note: string\n  metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>\n}\n\nfunction selectedKeys(current: FigureSource | undefined, source: FigureSource): Set<string> {\n  return new Set(diffProposal(current, source).map(change => change.key))\n}\n\n/** 서버 후보를 검토 세션으로 연다. 저장 형식이 아니면 화면에 후보를 열지 않는다. */\nexport function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession {\n  const source = JSON.parse(proposal.source) as FigureSource\n  if (!source || !Array.isArray(source.parts)) {\n    throw new Error('AI 후보의 Figure 형식이 올바르지 않습니다.')\n  }\n\n  return {\n    source,\n    title: '',\n    picked: selectedKeys(current, source),\n    note: '',\n    metrics: {\n      grade: proposal.grade,\n      triangles: proposal.triangles,\n      groups: proposal.groups,\n      attempts: proposal.attempts,\n      quality: proposal.quality\n    }\n  }\n}\n\n/** 발행 게이트가 측정한 한-앵커 수정도 같은 후보 세션으로 연다. */\nexport function openSizingFix(current: FigureSource, fix: FigureGateFix): ProposalSession | undefined {\n  if (!current.parts.some(part => part.name === fix.part)) return undefined\n\n  const source: FigureSource = {\n    ...current,\n    parts: current.parts.map(part =>\n      part.name === fix.part ? { ...part, anchor: { ...(part.anchor ?? {}), [fix.axis]: fix.to } } : part\n    )\n  }\n\n  return {\n    source,\n    title: `발행 검사 수정안 · ${fix.part}.anchor.${fix.axis}: ${fix.from ?? 'auto'} → ${fix.to}`,\n    picked: selectedKeys(current, source),\n    note: ''\n  }\n}\n\n/** 후보 검토 중 사람의 선택을 뒤집는다. 기존 Set을 바꾸지 않아 Lit 상태 경계도 보존한다. */\nexport function toggleProposalChange(session: ProposalSession, key: string): ProposalSession {\n  const picked = new Set(session.picked)\n  if (picked.has(key)) picked.delete(key)\n  else picked.add(key)\n  return { ...session, picked }\n}\n\n/** 사람의 결정을, 다음 AI 요청에만 쓰는 제한된 피드백으로 만든다. */\nexport function feedbackFromSession(\n  current: FigureSource | undefined,\n  session: ProposalSession,\n  outcome: ProposalFeedback['outcome']\n): ProposalFeedback | undefined {\n  if (!session.metrics) return undefined\n\n  return {\n    outcome,\n    selectedChanges: outcome === 'accepted' ? session.picked.size : 0,\n    totalChanges: diffProposal(current, session.source).length,\n    note: session.note.trim().slice(0, 500) || undefined,\n    grade: session.metrics.grade,\n    quality: {\n      status: session.metrics.quality.status,\n      findingCodes: session.metrics.quality.findings.map(finding => finding.code)\n    }\n  }\n}\n"]}
+{"version":3,"file":"proposal-session.js","sourceRoot":"","sources":["../../client/modeller/proposal-session.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FigureSource } from '@hatiolab/figure-model'\n\nimport type { FigureGateFix, FigureProposal, ProposalFeedback } from '../types.js'\nimport { diffProposal } from './proposal.js'\n\n/**\n * 한 번의 AI 후보 검토에만 존재하는 상태다.\n *\n * 후보는 정본이 아니다. 후보 원본·선택·메모·측정값을 한 값으로 묶어 두면 화면이\n * 수락/거절 중 일부만 이전 후보에서 남기는 일이 없다.\n */\nexport interface ProposalSession {\n  source: FigureSource\n  title: string\n  picked: Set<string>\n  note: string\n  metrics?: Pick<FigureProposal, 'grade' | 'triangles' | 'groups' | 'attempts' | 'quality'>\n  /**\n   * The release-check fix this session was opened from, if any. The page translates the title from it;\n   * this module stays free of i18n because node tests import it directly.\n   */\n  fix?: FigureGateFix\n}\n\nfunction selectedKeys(current: FigureSource | undefined, source: FigureSource): Set<string> {\n  return new Set(diffProposal(current, source).map(change => change.key))\n}\n\n/** 서버 후보를 검토 세션으로 연다. 저장 형식이 아니면 화면에 후보를 열지 않는다. */\nexport function openAiProposal(current: FigureSource | undefined, proposal: FigureProposal): ProposalSession {\n  const source = JSON.parse(proposal.source) as FigureSource\n  if (!source || !Array.isArray(source.parts)) {\n    throw new Error('the AI candidate is not a figure source: parts is missing or not an array')\n  }\n\n  return {\n    source,\n    title: '',\n    picked: selectedKeys(current, source),\n    note: '',\n    metrics: {\n      grade: proposal.grade,\n      triangles: proposal.triangles,\n      groups: proposal.groups,\n      attempts: proposal.attempts,\n      quality: proposal.quality\n    }\n  }\n}\n\n/** 발행 게이트가 측정한 한-앵커 수정도 같은 후보 세션으로 연다. */\nexport function openSizingFix(current: FigureSource, fix: FigureGateFix): ProposalSession | undefined {\n  if (!current.parts.some(part => part.name === fix.part)) return undefined\n\n  const source: FigureSource = {\n    ...current,\n    parts: current.parts.map(part =>\n      part.name === fix.part ? { ...part, anchor: { ...(part.anchor ?? {}), [fix.axis]: fix.to } } : part\n    )\n  }\n\n  return {\n    source,\n    title: '',\n    fix,\n    picked: selectedKeys(current, source),\n    note: ''\n  }\n}\n\n/** 후보 검토 중 사람의 선택을 뒤집는다. 기존 Set을 바꾸지 않아 Lit 상태 경계도 보존한다. */\nexport function toggleProposalChange(session: ProposalSession, key: string): ProposalSession {\n  const picked = new Set(session.picked)\n  if (picked.has(key)) picked.delete(key)\n  else picked.add(key)\n  return { ...session, picked }\n}\n\n/** 사람의 결정을, 다음 AI 요청에만 쓰는 제한된 피드백으로 만든다. */\nexport function feedbackFromSession(\n  current: FigureSource | undefined,\n  session: ProposalSession,\n  outcome: ProposalFeedback['outcome']\n): ProposalFeedback | undefined {\n  if (!session.metrics) return undefined\n\n  return {\n    outcome,\n    selectedChanges: outcome === 'accepted' ? session.picked.size : 0,\n    totalChanges: diffProposal(current, session.source).length,\n    note: session.note.trim().slice(0, 500) || undefined,\n    grade: session.metrics.grade,\n    quality: {\n      status: session.metrics.quality.status,\n      findingCodes: session.metrics.quality.findings.map(finding => finding.code)\n    }\n  }\n}\n"]}

package/dist-client/pages/figure-modeller-page.d.ts

@@ -6,28 +6,6 @@ import '../modeller/figure-parts.js';
 import '../modeller/figure-inspector.js';
 import { PageView } from '@operato/shell';
 declare const FigureModellerPageBase: typeof PageView;
-/**
- * Figure 저작면.
- *
- * ## 세 칸이다
- *
- *   왼쪽   도형 팔레트 · 부품 목록 · 속성
- *   가운데 미리보기 — `FigureInstance` 를 실제로 세운다
- *   오른쪽 판단 — 늘 떠 있다
- *
- * 미리보기가 씬 위에서 실제로 동작하는 것이 이 도구의 전제다. **편집한 것이 곧 실제 결과물**이라야
- * "모델러에서는 되는데 도면에서는 다르다"가 생기지 않는다.
- *
- * ## 편집 데이터는 씬 모델 하나뿐이다
- *
- * 이 페이지가 갖는 것은 초안 하나와 부품 목록 — 미리보기에 그대로 세워지는 씬 모델이다.
- * 저장 형식(`FigureSource`)으로 바꾸는 것은 **경계에서만** 한다: 저장할 때, 판단할 때,
- * AI 후보와 비교할 때. 그 변환은 `figure-source.ts` 한 곳에서만 일어난다.
- *
- * 팔레트도 속성 편집기도 이 데이터를 직접 수정하지 않는다. 무엇을 하겠다는 것만 알리고,
- * 바꾸는 것은 이 페이지다. 두 곳에서 고치면 실행 취소도 저장도 어느 쪽이 맞는지 알 수
- * 없게 된다.
- */
 export declare class FigureModellerPage extends FigureModellerPageBase {
     static styles: import("lit").CSSResult;
     /** 편집 중인 Figure. 새로 만드는 중이면 `id` 가 없다. */
@@ -368,6 +346,8 @@ export declare class FigureModellerPage extends FigureModellerPageBase {
     private fillThumbnail;
     private save;
     private doSave;
+    /** Title of the candidate bar. A candidate opened from a release-check fix is described by translating that fix here. */
+    private proposalTitle;
     private renderSaveModal;
 }
 export {};

package/dist-client/pages/figure-modeller-page.js

@@ -13,7 +13,7 @@ import { i18next, localize } from '@operato/i18n';
 import { navigate, PageView } from '@operato/shell';
 import { openOverlay } from '@operato/layout';
 import { requestFigureAI, consumePendingFigureProposal } from '../modeller/figure-ai-target.js';
-import { validate } from '@hatiolab/figure-model';
+import { isPlaceholderType, placeholderType, TYPE_LENGTH, TYPE_PATTERN, validate } from '@hatiolab/figure-model';
 import * as edits from '../modeller/part-edits.js';
 import * as proposals from '../modeller/proposal.js';
 import * as proposalSessions from '../modeller/proposal-session.js';
@@ -91,6 +91,17 @@ function startingModel(type) {
  * 바꾸는 것은 이 페이지다. 두 곳에서 고치면 실행 취소도 저장도 어느 쪽이 맞는지 알 수
  * 없게 된다.
  */
+/**
+ * Whether this name could be released, by the format's own rules (`type-not-identifier`,
+ * `type-is-placeholder`). Saving is not blocked, but the type cannot change after creation, so the
+ * author has to hear it now to avoid a draft that can never be released.
+ */
+function releasableType(type) {
+    return (!isPlaceholderType(type) &&
+        TYPE_PATTERN.test(type) &&
+        type.length >= TYPE_LENGTH.min &&
+        type.length <= TYPE_LENGTH.max);
+}
 let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase {
     constructor() {
         super(...arguments);
@@ -1051,10 +1062,10 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
         const { errors, violations } = validate(picked);
         return html `
       <div decide>
-        <span>${this.proposalSession.title || i18next.t('figure.text.assistant-proposed-a-figure')}</span>
+        <span>${this.proposalTitle(this.proposalSession)}</span>
         <div spacer></div>
         <button drop @click=${() => this.discard()}>${i18next.t('figure.button.discard')}</button>
-        ${stale ? html `<span role="alert">원본이 변경되었습니다. 후보를 취소하고 AI 지원에서 다시 요청하세요.</span>` : ''}
+        ${stale ? html `<span role="alert">${i18next.t('figure.text.source-changed-ask-again')}</span>` : ''}
         <button take ?disabled=${stale || errors.length > 0 || this.proposalSession.picked.size === 0} @click=${() => this.take()}>
           ${i18next.t('figure.button.take-n-changes', { n: this.proposalSession.picked.size })}
         </button>
@@ -1352,7 +1363,7 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
         this.proposalFeedback = [];
         this.mode = 'edit';
         // 타입 이름을 사람이 정하기 전까지는 임시 이름을 쓴다. 저장할 때 확정한다.
-        const draftType = `FIGURE_${Date.now().toString(36).toUpperCase()}`;
+        const draftType = placeholderType();
         const { draft, parts } = startingModel(draftType);
         this.figure = { id: '', type: draftType, name: '' };
         this.draft = draft;
@@ -1616,8 +1627,12 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
         if (!this.figure.id) {
             // 신규 저장: 타입 코드와 표시 이름을 명확히 팝업으로 확인/입력받음
             let defaultType = this.draft?.figureType || this.figure.type || '';
-            if (!defaultType || defaultType.startsWith('FIGURE_')) {
-                defaultType = 'FIGURE';
+            /*
+              A placeholder is not prefilled. This used to prefill 'FIGURE', inviting the author to confirm a
+              meaningless name that cannot change later and that the release gate refuses.
+            */
+            if (!defaultType || isPlaceholderType(defaultType)) {
+                defaultType = '';
             }
             this.saveModalType = defaultType;
             this.saveModalName = this.figure.name || '';
@@ -1638,7 +1653,7 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
                 const typeToSave = (this.saveModalType || this.draft?.figureType || this.figure.type || 'FIGURE').trim().toUpperCase();
                 const nameToSave = (this.saveModalName || this.figure.name || typeToSave).trim();
                 if (!typeToSave) {
-                    throw new Error('타입 이름을 입력하세요.');
+                    throw new Error(i18next.t('figure.text.enter-a-type-name'));
                 }
                 const taken = await fetchFigureTypeNames();
                 if (taken.includes(typeToSave)) {
@@ -1693,6 +1708,19 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
             this.saving = false;
         }
     }
+    /** Title of the candidate bar. A candidate opened from a release-check fix is described by translating that fix here. */
+    proposalTitle(session) {
+        const fix = session.fix;
+        if (fix) {
+            return i18next.t('figure.text.release-check-fix', {
+                part: fix.part,
+                axis: fix.axis.toUpperCase(),
+                from: fix.from ?? 'auto',
+                to: fix.to
+            });
+        }
+        return session.title || i18next.t('figure.text.assistant-proposed-a-figure');
+    }
     renderSaveModal() {
         if (!this.showSaveModal)
             return nothing;
@@ -1700,23 +1728,26 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
       <div class="save-modal-backdrop" @click=${(e) => { if (e.target === e.currentTarget)
             this.showSaveModal = false; }}>
         <div class="save-modal-card" role="dialog" aria-modal="true">
-          <h3 class="save-modal-title">${i18next.t('figure.title.save-new-figure', { defaultValue: '도형 초안 저장' })}</h3>
-          <p class="save-modal-desc">${i18next.t('figure.text.save-new-figure-desc', { defaultValue: '도면과 캔버스에서 식별할 고유 타입 코드와 이름을 정합니다.' })}</p>
+          <h3 class="save-modal-title">${i18next.t('figure.title.save-new-figure')}</h3>
+          <p class="save-modal-desc">${i18next.t('figure.text.save-new-figure-desc')}</p>
 
           <div class="save-modal-field">
-            <label>${i18next.t('figure.label.figure-type', { defaultValue: '타입 코드 (영문 대문자)' })}</label>
+            <label>${i18next.t('figure.label.figure-type')}</label>
             <input
               .value=${this.saveModalType}
-              placeholder="예: OHT, AGV_LIFTER"
+              placeholder=${i18next.t('figure.text.figure-type-example')}
               @input=${(e) => (this.saveModalType = e.target.value.trim().toUpperCase())}
             />
+            ${this.saveModalType && !releasableType(this.saveModalType)
+            ? html `<div class="save-modal-error">${i18next.t('figure.text.type-name-will-not-release')}</div>`
+            : nothing}
           </div>
 
           <div class="save-modal-field">
-            <label>${i18next.t('figure.label.name', { defaultValue: '도형 이름' })}</label>
+            <label>${i18next.t('figure.label.name')}</label>
             <input
               .value=${this.saveModalName}
-              placeholder="예: 오버헤드 호이스트 트랜스포트"
+              placeholder=${i18next.t('figure.text.figure-name-example')}
               @input=${(e) => (this.saveModalName = e.target.value)}
             />
           </div>
@@ -1725,10 +1756,10 @@ let FigureModellerPage = class FigureModellerPage extends FigureModellerPageBase
 
           <div class="save-modal-actions">
             <button class="btn-cancel" @click=${() => (this.showSaveModal = false)}>
-              ${i18next.t('figure.button.cancel', { defaultValue: '취소' })}
+              ${i18next.t('figure.button.cancel')}
             </button>
             <button class="btn-confirm" ?disabled=${this.saving || !this.saveModalType} @click=${() => this.doSave()}>
-              ${this.saving ? i18next.t('figure.text.saving-figure', { defaultValue: '저장 중...' }) : i18next.t('figure.button.save', { defaultValue: '저장' })}
+              ${this.saving ? i18next.t('figure.text.saving-figure') : i18next.t('figure.button.save')}
             </button>
           </div>
         </div>