다섯 종류는 전부 끝난 일을 남긴다. 없는 것은 읽는 사람이 자기 손으로 다시 하려면 무엇부터 하는가다. Case 의 environment 는 평문 한 칸이라 명령이 들어가지 않고, 같은 셋업을 쓰는 Case 가 넷이면 같은 문장이 네 벌 복제된다. 프로젝트는 필수, 주제는 선택으로 둔다. 주제 없는 셋업이 그 프로젝트의 공통 구성이고, 주제를 붙이면 그 주제의 구성이다 — 스키마를 나누지 않고 두 범위를 같은 종류로 받는다. 버전만 본문 밖에 둔다(pinnedVersions). 이 절차가 어느 버전 위에서 성립했는지는 그 기록의 유효 범위이고, 목록과 머리말이 본문을 열지 않고 보여 줘야 한다. 나머지 셋(실행 절차·구성 값·확인 방법)은 명령과 표를 담아야 하므로 본문이다. 이름은 SETUP 이다. ENVIRONMENT 가 영어로는 자연스럽지만 case_detail.environment 와 겹친다 — 이 저장소가 열네 번 밟은 실패가 「종류를 손으로 나열한 곳을 빠뜨린다」이고 그걸 찾는 수단이 grep 이다. 손으로 나열해 두었던 자리를 이번에 표로 바꿨다. publicPath 의 삼항 사슬은 마지막 else 가 「나머지 전부」여서 새 종류의 주소가 조용히 /questions/… 가 됐고, document-editor 의 칸 경로도 같은 모양이었다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
113 lines
6.3 KiB
TypeScript
113 lines
6.3 KiB
TypeScript
import type { components } from "../../../contracts/studio/generated.ts";
|
|
import type { Asset } from "../../../contracts/studio/contract.ts";
|
|
import type { TopicVariantEdit } from "../../../contracts/management/contract.ts";
|
|
import type { DocumentEditorController } from "./document-editor-controller.ts";
|
|
import { CASE_FIELD_PATHS, CaseFields } from "./case-fields.tsx";
|
|
import { CONCEPT_FIELD_PATHS, ConceptFields } from "./concept-fields.tsx";
|
|
import { COMMON_FIELD_PATHS, CommonDocumentFields } from "./common-document-fields.tsx";
|
|
import { DocumentStatusBar } from "./document-status-bar.tsx";
|
|
import { InstantPreview } from "./instant-preview.tsx";
|
|
import { DECISION_FIELD_PATHS, ProjectDecisionFields } from "./project-decision-fields.tsx";
|
|
import { issuesOutside } from "./field-issues.tsx";
|
|
import { QUESTION_FIELD_PATHS, QuestionFields } from "./question-fields.tsx";
|
|
import { REFERENCE_FIELD_PATHS, ReferenceFields } from "./reference-fields.tsx";
|
|
import { SETUP_FIELD_PATHS, SetupFields } from "./setup-fields.tsx";
|
|
|
|
type CatalogEntry = components["schemas"]["CatalogEntry"];
|
|
type RecordKind = components["schemas"]["RecordKind"];
|
|
|
|
export function DocumentEditor({
|
|
controller,
|
|
catalog,
|
|
variants,
|
|
assets,
|
|
onAssetsObserved,
|
|
onAssetUploaded,
|
|
}: {
|
|
controller: DocumentEditorController;
|
|
catalog: CatalogEntry[];
|
|
/** 고른 주제의 축. 주제를 고르지 않았거나 축을 쓰지 않는 주제면 빈 목록이다. */
|
|
variants: readonly TopicVariantEdit[];
|
|
/** Owned by `DocumentEditorScreen` so the CASE editor's Picker/Upload and Instant Preview share one list. */
|
|
assets: readonly Asset[];
|
|
onAssetsObserved: (assets: readonly Asset[]) => void;
|
|
onAssetUploaded: (asset: Asset) => void;
|
|
}) {
|
|
const topics = catalog.filter(({ type }) => type === "TOPIC");
|
|
const projects = catalog.filter(({ type }) => type === "PROJECT");
|
|
const relations = catalog.filter(({ type }) => type === "RELATION");
|
|
const evidence = catalog.filter(({ type }) => type === "EVIDENCE");
|
|
|
|
/*
|
|
게시를 막는 것이 무엇인지 그 칸 아래에 적는다. 예전에는 이 목록이 화면 맨 위에 한 덩어리로
|
|
있었고, 작성자는 `/topicId` 같은 경로를 읽고 어느 칸인지 스스로 찾아야 했다.
|
|
|
|
어느 칸에도 붙지 못한 것은 게시 버튼 옆에 남긴다 — 사라지면 이유를 말해 주지 않는 실패만
|
|
남는다.
|
|
*/
|
|
const issues = controller.publishIssues;
|
|
/*
|
|
삼항 사슬의 마지막 else 가 「나머지 전부」였다. 종류를 더하면 그 종류의 지적이 결정의
|
|
칸 경로로 걸러져, 자기 칸 아래에 붙지도 게시 버튼 옆에 남지도 않고 사라진다. 표로 두면
|
|
컴파일러가 빈 자리를 잡는다.
|
|
*/
|
|
const KIND_PATHS: Record<RecordKind, readonly string[]> = {
|
|
CASE: CASE_FIELD_PATHS,
|
|
CONCEPT: CONCEPT_FIELD_PATHS,
|
|
REFERENCE: REFERENCE_FIELD_PATHS,
|
|
QUESTION: QUESTION_FIELD_PATHS,
|
|
SETUP: SETUP_FIELD_PATHS,
|
|
PROJECT_DECISION: DECISION_FIELD_PATHS,
|
|
};
|
|
const kindPaths = KIND_PATHS[controller.draft.kind];
|
|
const unplaced = issuesOutside(issues, [...COMMON_FIELD_PATHS, ...kindPaths]);
|
|
|
|
/*
|
|
편집과 미리보기를 한 화면에 나란히 둔다. 예전에는 탭이었고, 고친 것이 어떻게 보이는지
|
|
확인하려면 탭을 옮겨야 했다 — 옮기는 동안 편집 중이던 칸은 화면에서 사라졌고, 돌아오면
|
|
스크롤 위치도 잃었다. 두 패널을 동시에 두면 그 왕복이 통째로 없어진다.
|
|
|
|
탭을 없앴으므로 각 패널은 스스로 이름을 가져야 한다. `aria-labelledby` 로 제목을 가리켜
|
|
landmark 로 만든다 — 탭 목록이 하던 "여기는 편집, 저기는 미리보기" 안내를 대신한다.
|
|
*/
|
|
return (
|
|
<div className="studio-editor-page">
|
|
<div className="studio-editor-split">
|
|
<section className="studio-editor-workspace" aria-labelledby="studio-edit-title">
|
|
<header className="studio-editor-heading">
|
|
<p className="studio-eyebrow">{controller.draft.kind} · VERSION {controller.saved.version}</p>
|
|
<h1 id="studio-edit-title">문서 편집</h1>
|
|
<p>{controller.draft.title || "제목 없는 작업본"}</p>
|
|
</header>
|
|
<CommonDocumentFields draft={controller.draft} topics={topics} projects={projects} relations={relations} variants={variants} issues={issues} onUpdate={controller.update} />
|
|
{controller.draft.kind === "CASE"
|
|
? <CaseFields draft={controller.draft} issues={issues} onChange={controller.replace} onAssetsObserved={onAssetsObserved} onAssetUploaded={onAssetUploaded} />
|
|
: controller.draft.kind === "CONCEPT"
|
|
? <ConceptFields draft={controller.draft} issues={issues} onChange={controller.replace} onAssetsObserved={onAssetsObserved} onAssetUploaded={onAssetUploaded} />
|
|
: controller.draft.kind === "SETUP"
|
|
? <SetupFields draft={controller.draft} issues={issues} onChange={controller.replace} onAssetsObserved={onAssetsObserved} onAssetUploaded={onAssetUploaded} />
|
|
: controller.draft.kind === "REFERENCE"
|
|
? <ReferenceFields draft={controller.draft} issues={issues} onChange={controller.replace} />
|
|
: controller.draft.kind === "QUESTION"
|
|
? <QuestionFields draft={controller.draft} evidence={evidence} issues={issues} onChange={controller.replace} />
|
|
: <ProjectDecisionFields draft={controller.draft} issues={issues} onChange={controller.replace} />}
|
|
</section>
|
|
{/*
|
|
미리보기는 편집 칸보다 훨씬 짧을 수도, 길 수도 있다. 그대로 두면 본문을 스크롤하는
|
|
동안 화면 밖으로 나가 버리므로 붙잡아 두고 자기 높이 안에서 따로 스크롤한다.
|
|
*/}
|
|
<section className="studio-editor-preview" aria-labelledby="studio-preview-title">
|
|
<header className="studio-editor-preview__heading">
|
|
<p className="studio-eyebrow">LIVE</p>
|
|
<h2 id="studio-preview-title">즉시 미리보기</h2>
|
|
</header>
|
|
<div className="studio-editor-preview__body">
|
|
<InstantPreview draft={controller.draft} catalog={catalog} assets={assets} />
|
|
</div>
|
|
</section>
|
|
</div>
|
|
<DocumentStatusBar controller={controller} unplacedIssues={unplaced} />
|
|
</div>
|
|
);
|
|
}
|