feat(478-2 문서 사이트): 진짜 추출로 맞춤 — TypeDoc kind-dir(대소문자 겹침 막음) · 도구 대 추출 비교 규칙 · 공용 도구 묶음 · 손글 지문 · TS 메뉴 쪽
- TypeDoc router kind-dir — structure 는 같은 이름 인터페이스 · 함수가 Windows 에서 한 파일로 덮임 · 겹침 링크 안 함 - 비교: TS = export 함수 · 메서드 · 생성자 · 접근자(상속 · 숨은 생성자 뺌 · export * 는 원본으로) · 파이썬 = 안쪽 함수 뺀 전부 ↔ griffe(속성 · 자동 생성 __init__ 반영) - groups.yml 공용 도구(common_util_* 끝 규칙) · 묶음 없음 0 · 손글 18 묶음 지문 - 결과: 함수 5,746 · 묶음 18 · 세션 칸 45 · 서버 주소 41 · strict 경고 0 · test_478_docs 9 통과 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5.5
@@ -0,0 +1,5 @@
|
||||
---
|
||||
지문: a0ee5171a3
|
||||
---
|
||||
|
||||
공용 도구 — 인증 · 좌표계 · 저장소 · 프로젝트 설정 · 그림 같은 여러 페이지가 함께 쓰는 도우미.
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 10df7a8380
|
||||
---
|
||||
|
||||
3D 길 모형 — 종단 · 횡단으로 길 몸체를 지음.
|
||||
|
||||
- 노선 초안 · 종단 고침 동안 낡음 표시 · [저장] 뒤 서버 Node 가 다시 지음.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: f4a6907e23
|
||||
---
|
||||
|
||||
횡단 설계선 · 면적 계산 — 브라우저 즉시 · [저장] 때 서버 Node 정본.
|
||||
|
||||
- 설계선 = [[computeCrossDesign]] ↔ 파이썬 짝 · 단면적은 표준 · 구조물 측점 모두 Node.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: dce3f67328
|
||||
---
|
||||
|
||||
횡단 화면 — 카드 단추 · 조정창 · 반폭 · 표준횡단 · 상세 표.
|
||||
|
||||
- 카드 단추 = 세션 `crossdesign` 의 바꾼 칸만 · 메모리 상세 설계를 안 덮음.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: f36ccf36ae
|
||||
---
|
||||
|
||||
관 · 배수 — 배수판 관 편집 · 배수유역 · 관 옵션.
|
||||
|
||||
- 관 주인 = 가게 `pipes` · 배수 편집기는 숨어도 가게를 따름.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: a0e40f1c62
|
||||
---
|
||||
|
||||
누가토량 · 유토 배분 · 운반거리.
|
||||
|
||||
- 누가토량 = TS 한 벌(브라우저 · Node) · 그릴 때 셈(접혀도 셈).
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 582a7c1377
|
||||
---
|
||||
|
||||
평면 발자국 — 횡단 결과로 평면에 깎기 · 쌓기 테두리.
|
||||
|
||||
- 묶음 마지막 단계 · B07 은 따로(파이썬) · 거울 시험.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: e6f779df26
|
||||
---
|
||||
|
||||
측점마다 원지반 표본 — 브라우저 지형 격자 · 서버 npz.
|
||||
|
||||
- 표본 짝 = 브라우저 격자 ↔ 서버 `sample_xy`(거울 시험) · 입력 선이 달라 mm 차.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 86e59255e5
|
||||
---
|
||||
|
||||
계산 묶음 · 설계 가게 · 상세 가게 — 입력 → 파생 한 방향.
|
||||
|
||||
- 묶음 단계 = 노선 → 따라감 → 측점 → 지반 → 첫 계획선 → 종단 → 횡단 → 발자국 · 차례 번호 · 옛 차례 버림.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: eb1c3888ea
|
||||
---
|
||||
|
||||
종단 계획고 — ▲▼ · 직선화 · 자유지정 · 쉬프트 · 종단 R · 시종점 · 페이지 설정.
|
||||
|
||||
- 편집값 주인 = 가게 `alignmentDraft`(세션 `alignment-draft`) · 지금 값 = 초안 ?? 서버 저장분.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 9abd21f485
|
||||
---
|
||||
|
||||
추천 노선 후보를 서버가 찾고 화면이 보여 줌 · 고른 후보를 [적용].
|
||||
|
||||
- 후보 초기 종단 = [적용] 체인과 같은 조각을 메모리에서 셈 · 저장본 `route_recommend/initial`.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: d59d1cfa21
|
||||
---
|
||||
|
||||
평면 노선 편집기 — 교점 끌기 · 방향키 · 교점 추가 · 삭제 · 곡선 R · L · 스냅.
|
||||
|
||||
- 조작은 편집기 메모리 → 놓을 때 세션 `route-draft` · 첫 초안이면 초안 전 상세를 hold.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 61b274fe26
|
||||
---
|
||||
|
||||
노선이 바뀐 [저장] — 새 노선 짜기 · 관 · 구조물 · 추가 측점 따라감 · 횡단 고침 넘김.
|
||||
|
||||
- 서버 [[run_route_save_chain]] = 노선 · 측점 · 표본 · 횡단을 처음부터 · 전부 아니면 없음.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 14969d7db0
|
||||
---
|
||||
|
||||
[저장] · [확정] · [초기화] · 떠남.
|
||||
|
||||
- [저장] · [확정] = 한 본문 한 요청 · 서버가 차례(노선 → 설정 → 관 → 구조물 → 추가 측점 → 종단 → 관 옵션 → 상단측 → 횡단)로 · 하나라도 실패 = 되돌림.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 4f0dd19e4e
|
||||
---
|
||||
|
||||
페이지 틀 · 보기 전환 · 패널 · 고름.
|
||||
|
||||
- B05 ↔ B06 전환 = 보기 숨김 · 보임만 · 보인 보기가 가게 · 세션을 다시 읽음 · 묶음은 숨은 동안도 셈.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: c9e11c5080
|
||||
---
|
||||
|
||||
서버 창구 · 저장소 · 스키마 — 브라우저 요청을 받아 DB · 정본 파일을 읽고 씀.
|
||||
|
||||
- 정본 쓰기 = [저장] · [확정] · [초기화] · 저장 밖 셋만.
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: 829ee0d82e
|
||||
---
|
||||
|
||||
측점 목록 · 열쇠 · 갈아끼움 — 노선 · 시설이 바뀌면 측점을 다시 세움.
|
||||
|
||||
- 열쇠 = [[common_util_station_key#stationKey]] 한 벌(파이썬 짝 · 거울 시험).
|
||||
|
||||
@@ -1,3 +1,7 @@
|
||||
---
|
||||
지문: e29d73c2ef
|
||||
---
|
||||
|
||||
구조물 — 추가 · 옮김 · 지움 · 형상 · 소단 · 시설 줄.
|
||||
|
||||
- 주인 = 가게 `structures` · 화면 사본은 가게 알림으로 맞춤([[announceDesignStore]]).
|
||||
|
||||
+55
-17
@@ -79,7 +79,7 @@ def run_typedoc(ts_files: list[str], out: Path) -> dict[tuple[str, str], str]:
|
||||
"entryPoints": [(ROOT / f).as_posix() for f in ts_files],
|
||||
"tsconfig": (ROOT / "tsconfig.json").as_posix(),
|
||||
"skipErrorChecking": True,
|
||||
"router": "structure",
|
||||
"router": "kind-dir",
|
||||
"out": (out / "src" / "ts").as_posix(),
|
||||
"json": (out / "typedoc.json").as_posix(),
|
||||
"readme": "none",
|
||||
@@ -95,20 +95,55 @@ def run_typedoc(ts_files: list[str], out: Path) -> dict[tuple[str, str], str]:
|
||||
return typedoc_pages(out)
|
||||
|
||||
|
||||
def typedoc_pages(out: Path) -> dict[tuple[str, str], str]:
|
||||
FN_KINDS = {64, 512, 2048, 262144} # TypeDoc 함수 · 생성자 · 메서드 · 접근자
|
||||
KIND_DIR = {64: "functions", 32: "variables", 128: "classes"} # router kind-dir 폴더
|
||||
|
||||
|
||||
def typedoc_entries(out: Path) -> list[tuple[str, str, int, str]]:
|
||||
"""TypeDoc JSON → (파일, 이름, 종류, 화면 경로).
|
||||
|
||||
클래스 칸 = `Class.name` · 다시 내보내기 = 가리키는 것의 종류.
|
||||
"""
|
||||
project = json.loads((out / "typedoc.json").read_text(encoding="utf-8"))
|
||||
modules = [m for m in project.get("children", []) if m["kind"] == 2] or [
|
||||
{**project, "name": ""}
|
||||
]
|
||||
pages = {}
|
||||
modules = [m for m in project.get("children", []) if m["kind"] == 2]
|
||||
by_id: dict[int, dict] = {}
|
||||
|
||||
def index(r: dict) -> None:
|
||||
by_id[r["id"]] = r
|
||||
for c in r.get("children", []):
|
||||
index(c)
|
||||
|
||||
index(project)
|
||||
rows = []
|
||||
for mod in modules:
|
||||
base = f"ts/{mod['name']}/" if mod["name"] else "ts/"
|
||||
file = mod["sources"][0]["fileName"] if mod.get("sources") else f"{mod['name']}.ts"
|
||||
slug = mod["name"].replace("/", "_")
|
||||
for c in mod.get("children", []):
|
||||
if c["kind"] in (64, 32) and c.get("sources"):
|
||||
rel = f"{base}{c['name']}.html"
|
||||
if (out / "src" / rel).exists():
|
||||
pages[(c["sources"][0]["fileName"], c["name"])] = rel
|
||||
return pages
|
||||
folder = KIND_DIR.get(c["kind"])
|
||||
page = f"ts/{folder}/{slug}.{c['name']}/index.html" if folder else ""
|
||||
kind = c["kind"]
|
||||
if kind == 4194304:
|
||||
kind = by_id.get(c.get("target"), {}).get("kind", kind)
|
||||
rows.append((file, c["name"], kind, page))
|
||||
if c["kind"] != 128:
|
||||
continue
|
||||
for m in c.get("children", []):
|
||||
if m.get("sources") and not m.get("flags", {}).get("isInherited"):
|
||||
rows.append(
|
||||
(file, f"{c['name']}.{m['name']}", m["kind"], f"{page}#{m['name'].lower()}")
|
||||
)
|
||||
return rows
|
||||
|
||||
|
||||
def typedoc_pages(out: Path) -> dict[tuple[str, str], str]:
|
||||
"""(파일, 이름) → 화면 경로 · 대소문자만 다른 겹침(Windows 한 파일)은 링크 안 함."""
|
||||
rows = [r for r in typedoc_entries(out) if r[3]]
|
||||
seen = Counter(rel.split("#")[0].lower() for *_, rel in rows if "#" not in rel)
|
||||
return {
|
||||
(file, name): rel
|
||||
for file, name, _, rel in rows
|
||||
if seen[rel.split("#")[0].lower()] == 1 and (out / "src" / rel.split("#")[0]).exists()
|
||||
}
|
||||
|
||||
|
||||
def py_ident(file: str) -> str:
|
||||
@@ -116,7 +151,7 @@ def py_ident(file: str) -> str:
|
||||
|
||||
|
||||
def griffe_names(file: str) -> set[str]:
|
||||
"""griffe 가 보는 함수 이름(모듈 함수 · 클래스 메서드 `Class.name`)."""
|
||||
"""griffe 가 보는 함수 이름(모듈 함수 · 클래스 메서드 · 속성 `Class.name` · 자동 생성 뺌)."""
|
||||
mod = griffe.load(py_ident(file), search_paths=[str(ROOT)], allow_inspection=False)
|
||||
names: set[str] = set()
|
||||
|
||||
@@ -124,7 +159,7 @@ def griffe_names(file: str) -> set[str]:
|
||||
for name, m in obj.members.items():
|
||||
if m.is_alias:
|
||||
continue
|
||||
if m.is_function:
|
||||
if (m.is_function or "property" in m.labels) and m.lineno:
|
||||
names.add(prefix + name)
|
||||
elif m.is_class:
|
||||
walk(m, f"{prefix}{name}.")
|
||||
@@ -386,9 +421,12 @@ class Site:
|
||||
self.gid.update({f["id"]: gid for gid, fns in groups.items() for f in fns})
|
||||
nav.append({page["title"]: self.write_page(page, groups)})
|
||||
home.append(f"- [{page['title']}]({page['id']}/index.md)")
|
||||
ts_nav = (
|
||||
[{"TypeScript": "ts/index.html"}] if (self.src / "ts" / "index.html").exists() else []
|
||||
)
|
||||
ts_nav = []
|
||||
if (self.src / "ts" / "index.html").exists():
|
||||
(self.src / "ts.md").write_text(
|
||||
"# TypeScript 함수 화면\n\n[TypeDoc 열기](ts/index.html)\n", encoding="utf-8"
|
||||
)
|
||||
ts_nav = [{"TypeScript": "ts.md"}]
|
||||
nav.append({"함수 화면": [*ts_nav, {"파이썬": "py/index.md"}]})
|
||||
(self.src / "index.md").write_text("\n".join(home) + "\n", encoding="utf-8")
|
||||
(self.src / ".nav.json").write_text(json.dumps(nav, ensure_ascii=False), encoding="utf-8")
|
||||
|
||||
@@ -69,6 +69,7 @@ pages:
|
||||
- design_pipeline_stations
|
||||
- design_pipeline_probe_station
|
||||
- common_util_station_key
|
||||
- common_util_station
|
||||
- id: ground
|
||||
title: 지반 표본
|
||||
registry: ["ground.*"]
|
||||
@@ -80,6 +81,7 @@ pages:
|
||||
- B06_Section_Engine_SampleExtend
|
||||
- B06_Section_Router_Widen
|
||||
- common_util_surface_sampler
|
||||
- common_util_surface_confirmation
|
||||
- id: earthwork
|
||||
title: 토량 · 유토 배분
|
||||
registry: ["earth.*", "haul.*"]
|
||||
@@ -102,6 +104,7 @@ pages:
|
||||
- B05_Profile_PageSettings
|
||||
- B05_Profile_Api_PageSettings
|
||||
- design_profile*
|
||||
- common_util_route_profile
|
||||
- id: cross
|
||||
title: 횡단 설계 계산
|
||||
registry: ["cross.*"]
|
||||
@@ -179,6 +182,8 @@ pages:
|
||||
- B06_Section_Section_*
|
||||
- B06_Section_UI_Page_Persist
|
||||
- common_util_calc_runner
|
||||
- common_util_derived_store
|
||||
- common_util_node_bundle
|
||||
- id: save
|
||||
title: 저장 · 확정 · 초기화 · 떠남
|
||||
files:
|
||||
@@ -216,3 +221,7 @@ pages:
|
||||
- B05_Profile
|
||||
- B06_Section
|
||||
- B05_Profile_Debug
|
||||
- id: common
|
||||
title: 공용 도구
|
||||
files:
|
||||
- common_util_*
|
||||
|
||||
Reference in New Issue
Block a user