Files
Aislo/B07_DesignDetail/openwebcad/src/tools/utility/layer-tools.ts
T
eomsangdon ea9d9685be feat(B07): CAD를 AutoCAD 명령 체계로 재구성한다 (조사표 1·2·3·5절)
저장소 사고로 잃은 4개 커밋(38eb7cd4·b8a11756·281528bf·f60b488d)의 작업물을
하나로 다시 담았다. 내용은 동일하다.

■ 구조
- commands/: 명령 정의(id·AutoCAD 별칭·글리프·도구/즉시실행)를 단일 소스로 두고
  리본·명령행·단축키가 모두 이 레지스트리를 읽는다. tools/tool.consts.ts 폐지.
- ribbon/: 탭→패널→명령 데이터(ribbon.config.ts)와 범용 렌더러 분리.
  AutoCAD 배치(홈·삽입·주석·뷰·출력)와 패널 확장(▾)을 따른다.
- tools/factories/sequence-tool.ts: 점·숫자·문자·객체·선택 단계를 선언하면
  xstate 머신을 만들어 주는 공장. 명령당 170줄 보일러플레이트 제거.
- helpers/geometry/: 3점 호·정다각형·타원·스플라인·구름형·평행이동·해치 스캔선·
  점렬 샘플링 등 상태 없는 순수 함수.
- Toolbar 483줄을 QuickAccessBar/Ribbon/InspectorPanel/StatusBar/CommandLine/
  ViewControls/PropertiesEditor/QuickProperties로 분해.

■ 명령 (조사표 기준)
- 1절 그리기 21건, 2절 수정 27건, 3절 도면층·특성·그룹·유틸리티 39건 전부 반영.
- 5절 주석 34건 중 26건 반영(문자·치수 16종·지시선·표·구름형·주석 축척).
- HatchEntity 추가(solid·pattern·cross·gradient) + JSON 왕복, Layer에 색·선가중치·
  선종류·동결·투명도 필드 추가, 그리기 루프가 동결·숨김·투명도를 반영.

■ 화면 실측에서 고친 결함
- 명령행 포커스 상태에서 ENTER가 도구로 가지 않던 문제
- 명령행 문자 입력이 접두사가 같은 명령으로 실행되던 문제
- 명령이 끝나도 입력을 계속 먹던 문제(점 입력 명령만 반복, 나머지는 선택 도구 복귀)
- 시퀀스 단계 인덱스 오사용 9건 + 단계 값 종류 검사 추가
- 해치 내부를 클릭해도 선택되지 않던 문제

미반영 8건(맞춤법 검사·꺾기 치수·치수 끊기/재연관/검사 치수·기하공차·지시선 수집·
축척 리스트 편집)은 조사표 `반영` 열과 PLAN.md에 사유를 적었다.
2026-08-30 01:34:13 +09:00

266 lines
9.1 KiB
TypeScript

/** 도면층 명령 (조사표 3절 도면층 패널) */
import { toast } from 'react-toastify';
import type { Layer } from '../../App.types';
import { openInspector } from '../../components/ui-state';
import type { Entity } from '../../entities/Entity';
import {
popLayerHistory,
pushLayerHistory,
restoreLayerState,
saveLayerState,
} from '../../helpers/layer-history';
import {
deleteEntities,
getActiveLayerId,
getEntities,
getLayers,
setActiveLayerId,
setEntities,
setLayers,
setSelectedEntityIds,
} from '../../state';
import { Tool } from '../../tools';
import { createSequenceTool } from '../factories/sequence-tool';
/** 도면층을 바꾸기 전에 직전 상태를 기록한다 (LAYERP가 되돌린다) */
function updateLayers(mutate: (layers: Layer[]) => Layer[]): void {
const current = getLayers();
pushLayerHistory(current);
setLayers(mutate(current.map((layer) => ({ ...layer }))));
}
const layerNameOf = (layerId: string): string =>
getLayers().find((layer) => layer.id === layerId)?.name ?? layerId;
/** LAYER — 도면층 특성 관리자(좌측 팔레트)를 연다 */
export function openLayerManager(): string {
openInspector('layers');
return '도면층 관리자';
}
export const layerCurrentToolStateMachine = createSequenceTool({
tool: Tool.LAYER_CURRENT,
helpers: false,
steps: [{ kind: 'entity', instructions: '현재 도면층으로 지정할 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
setActiveLayerId(layerId);
toast.success(`현재 도면층: ${layerNameOf(layerId)}`);
},
});
export const layerOffToolStateMachine = createSequenceTool({
tool: Tool.LAYOFF,
helpers: false,
steps: [{ kind: 'entity', instructions: '끌 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
updateLayers((layers) =>
layers.map((layer) => (layer.id === layerId ? { ...layer, isVisible: false } : layer))
);
toast.info(`도면층 끄기: ${layerNameOf(layerId)}`);
},
});
/** LAYON — 모든 도면층 켜기 */
export function turnAllLayersOn(): string {
updateLayers((layers) => layers.map((layer) => ({ ...layer, isVisible: true })));
toast.success('모든 도면층을 켰습니다.');
return '모든 도면층 켜기';
}
export const layerFreezeToolStateMachine = createSequenceTool({
tool: Tool.LAYFRZ,
helpers: false,
steps: [{ kind: 'entity', instructions: '동결할 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
if (layerId === getActiveLayerId()) {
toast.warn('현재 도면층은 동결할 수 없습니다.');
return;
}
updateLayers((layers) =>
layers.map((layer) => (layer.id === layerId ? { ...layer, isFrozen: true } : layer))
);
toast.info(`도면층 동결: ${layerNameOf(layerId)}`);
},
});
/** LAYTHW — 모든 도면층 동결 해제 */
export function thawAllLayers(): string {
updateLayers((layers) => layers.map((layer) => ({ ...layer, isFrozen: false })));
toast.success('모든 도면층을 동결 해제했습니다.');
return '동결 해제';
}
export const layerLockToolStateMachine = createSequenceTool({
tool: Tool.LAYLCK,
helpers: false,
steps: [{ kind: 'entity', instructions: '잠글 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
updateLayers((layers) =>
layers.map((layer) => (layer.id === layerId ? { ...layer, isLocked: true } : layer))
);
toast.info(`도면층 잠금: ${layerNameOf(layerId)}`);
},
});
export const layerUnlockToolStateMachine = createSequenceTool({
tool: Tool.LAYULK,
helpers: false,
steps: [{ kind: 'entity', instructions: '잠금 해제할 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
updateLayers((layers) =>
layers.map((layer) => (layer.id === layerId ? { ...layer, isLocked: false } : layer))
);
toast.success(`도면층 잠금 해제: ${layerNameOf(layerId)}`);
},
});
export const layerIsolateToolStateMachine = createSequenceTool({
tool: Tool.LAYISO,
helpers: false,
steps: [{ kind: 'entity', instructions: '남길 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
updateLayers((layers) =>
layers.map((layer) => ({ ...layer, isVisible: layer.id === layerId }))
);
toast.info(`도면층 분리: ${layerNameOf(layerId)}`);
},
});
/** LAYUNISO — 도면층 분리 해제 */
export function unisolateLayers(): string {
updateLayers((layers) => layers.map((layer) => ({ ...layer, isVisible: true })));
toast.success('도면층 분리를 해제했습니다.');
return '도면층 분리 해제';
}
/** LAYERP — 직전 도면층 상태로 되돌리기 */
export function restorePreviousLayers(): string {
const previous = popLayerHistory();
if (!previous) {
toast.info('되돌릴 도면층 상태가 없습니다.');
return '되돌릴 상태 없음';
}
setLayers(previous);
toast.success('직전 도면층 상태로 되돌렸습니다.');
return '직전 도면층 상태';
}
export const layerStateSaveToolStateMachine = createSequenceTool({
tool: Tool.LAYERSTATE,
helpers: false,
steps: [{ kind: 'text', instructions: '저장할 도면층 상태 이름을 입력하십시오.' }],
commit: (input) => {
saveLayerState(input.text(0), getLayers());
toast.success(`도면층 상태 저장: ${input.text(0)}`);
},
});
export const layerStateRestoreToolStateMachine = createSequenceTool({
tool: Tool.LAYERSTATE_RESTORE,
helpers: false,
steps: [{ kind: 'text', instructions: '복원할 도면층 상태 이름을 입력하십시오.' }],
commit: (input) => {
const restored = restoreLayerState(input.text(0));
if (!restored) {
toast.warn('그 이름으로 저장한 도면층 상태가 없습니다.');
return;
}
pushLayerHistory(getLayers());
setLayers(restored);
toast.success(`도면층 상태 복원: ${input.text(0)}`);
},
});
export const layerMatchToolStateMachine = createSequenceTool({
tool: Tool.LAYMCH,
helpers: false,
steps: [
{ kind: 'selection', instructions: '옮길 객체를 선택한 뒤 ENTER.' },
{ kind: 'entity', instructions: '대상 도면층의 객체를 선택하십시오.' },
],
commit: (input) => {
const layerId = input.entity(1).layerId;
for (const entity of input.entities(0)) {
entity.layerId = layerId;
}
setEntities([...getEntities()], true);
setSelectedEntityIds([]);
toast.success(`${input.entities(0).length}개 객체를 ${layerNameOf(layerId)}(으)로 옮겼습니다.`);
},
});
export const layerToCurrentToolStateMachine = createSequenceTool({
tool: Tool.LAYCUR,
helpers: false,
steps: [{ kind: 'selection', instructions: '현재 도면층으로 옮길 객체를 선택한 뒤 ENTER.' }],
commit: (input) => {
const layerId = getActiveLayerId();
for (const entity of input.entities(0)) {
entity.layerId = layerId;
}
setEntities([...getEntities()], true);
setSelectedEntityIds([]);
toast.success(`${input.entities(0).length}개 객체를 현재 도면층으로 옮겼습니다.`);
},
});
export const layerMergeToolStateMachine = createSequenceTool({
tool: Tool.LAYMRG,
helpers: false,
steps: [
{ kind: 'entity', instructions: '병합할(사라질) 도면층의 객체를 선택하십시오.' },
{ kind: 'entity', instructions: '대상 도면층의 객체를 선택하십시오.' },
],
commit: (input) => {
const sourceId = input.entity(0).layerId;
const targetId = input.entity(1).layerId;
if (sourceId === targetId) {
toast.warn('같은 도면층입니다.');
return;
}
for (const entity of getEntities()) {
if (entity.layerId === sourceId) entity.layerId = targetId;
}
setEntities([...getEntities()], true);
updateLayers((layers) => layers.filter((layer) => layer.id !== sourceId));
if (getActiveLayerId() === sourceId) setActiveLayerId(targetId);
toast.success(`도면층을 ${layerNameOf(targetId)}(으)로 병합했습니다.`);
},
});
export const layerDeleteToolStateMachine = createSequenceTool({
tool: Tool.LAYDEL,
helpers: false,
steps: [{ kind: 'entity', instructions: '삭제할 도면층의 객체를 선택하십시오.' }],
commit: (input) => {
const layerId = input.entity(0).layerId;
if (getLayers().length <= 1) {
toast.warn('마지막 도면층은 삭제할 수 없습니다.');
return;
}
const doomed: Entity[] = getEntities().filter((entity) => entity.layerId === layerId);
deleteEntities(doomed, true);
updateLayers((layers) => layers.filter((layer) => layer.id !== layerId));
if (getActiveLayerId() === layerId) setActiveLayerId(getLayers()[0].id);
toast.success(`도면층과 객체 ${doomed.length}개를 삭제했습니다.`);
},
});
/** LAYWALK — 부를 때마다 다음 도면층 하나만 보여 준다 */
let walkIndex = -1;
export function walkLayers(): string {
const layers = getLayers();
if (!layers.length) return '도면층 없음';
walkIndex = (walkIndex + 1) % layers.length;
const target = layers[walkIndex];
updateLayers((all) => all.map((layer) => ({ ...layer, isVisible: layer.id === target.id })));
toast.info(`도면층 탐색: ${target.name} (${walkIndex + 1}/${layers.length})`);
return `도면층 탐색 ${target.name}`;
}