for-humanity 0.2.0 → 0.3.0

package/src/content/to-doc-groups/_to-doc-group-branches.ts

@@ -1,4 +1,5 @@
-import {locale_doc_group, locale_doc_name} from "@/constant/locale";
+import {locale_doc_group} from "@/constant/locale";
+import {toDocBranches} from "@/content/to-doc-groups/_to-doc-branches";
 import type {Doc} from "@/type/doc";
 import type {DocGroup} from "@/type/doc-group";
 
@@ -10,6 +11,10 @@ interface DocGroupBranchesOptions {
      * 부모 경로에 속한 문서
      */
     docs: readonly Doc[];
+    /**
+     * 검증된 부모 id별 문서 · 자손을 각 단계에서 다시 수집하지 않음
+     */
+    children: ReadonlyMap<Doc["data"]["parent"], Doc[]>;
     /**
      * 부모까지의 경로 · 최상위는 빈 배열
      */
@@ -49,10 +54,17 @@ export const toDocGroupBranches = (options: DocGroupBranchesOptions): DocGroup[]
             return {
                 name: group.name,
                 path: group.path,
-                docs: group.docs
-                    .filter((doc) => doc.data.group.length === group.path.length)
-                    .toSorted((a, b) => a.data.order - b.data.order || a.data.name.localeCompare(b.data.name, locale_doc_name) || a.id.localeCompare(b.id, locale_doc_name)),
-                groups: toDocGroupBranches({docs: group.docs, path: group.path, positions: options.positions, unlistedPosition: options.unlistedPosition}),
+                docs: toDocBranches({
+                    docs: group.docs.filter((doc) => doc.data.group.length === group.path.length && doc.data.parent === undefined),
+                    children: options.children,
+                }),
+                groups: toDocGroupBranches({
+                    docs: group.docs,
+                    children: options.children,
+                    path: group.path,
+                    positions: options.positions,
+                    unlistedPosition: options.unlistedPosition,
+                }),
             };
         });
 };

package/src/content/to-doc-groups/to-doc-groups.ts

@@ -10,5 +10,6 @@ export const toDocGroups = (options: {docs: readonly Doc[]; navigation: SiteConf
     // 같은 조상을 지정한 경로는 최초 navigation 위치를 우선
     const positions = new Map(options.navigation.flatMap((path, index) => path.map((_name, depth) => [JSON.stringify(path.slice(0, depth + 1)), index] as const)).toReversed());
 
-    return toDocGroupBranches({docs: options.docs, path: [], positions, unlistedPosition: options.navigation.length});
+    const children = Map.groupBy(options.docs, (doc) => doc.data.parent);
+    return toDocGroupBranches({docs: options.docs, children, path: [], positions, unlistedPosition: options.navigation.length});
 };

package/src/style/token.css

@@ -55,7 +55,8 @@
     --app-font-mono: "JetBrains Mono Variable", var(--app-font-sans);
     --app-font-brand: "Architects Daughter", var(--app-font-sans);
 
-    /* 글자 크기 · 12px 기본과 역할별 제목 크기 */
+    /* 글자 크기 · 11px 비상호작용 묶음 · 12px 기본과 역할별 제목 크기 */
+    --app-font-size-group: 11px;
     --app-font-size-label: 12px;
     --app-font-size-detail: 12px;
     --app-font-size-dense: 12px;
@@ -65,9 +66,9 @@
     --app-font-size-section: 14px;
     --app-font-size-title: 16px;
 
-    /* 굵기 · 기본 400 · 현재 위치 500 · 제목·강조 600 */
+    /* 굵기 · 기본 400 · 현재 위치·제목·강조 600 */
     --app-font-weight-mark: 400;
-    --app-font-weight-active: 500;
+    --app-font-weight-active: 600;
     --app-font-weight-strong: 600;
     --app-font-weight-title: 600;
 

package/src/type/doc-branch.ts

@@ -0,0 +1,11 @@
+import type {Doc} from "@/type/doc";
+
+/**
+ * 문서 탐색의 클릭 가능한 가지 · 원래 URL과 본문을 유지
+ */
+export interface DocBranch extends Doc {
+    /**
+     * 같은 부모 아래의 문서 · order·제목·id 순, 말단 문서는 생략
+     */
+    children?: DocBranch[];
+}

package/src/type/doc-data.ts

@@ -22,6 +22,10 @@ export const docDataSchema = z.object({
      * 사이드바의 문서 묶음 경로 · 문자열도 배열로 정규화
      */
     group: groupPathSchema,
+    /**
+     * 같은 묶음 안의 부모 문서 id · 확장자 제외, ./·../ 상대 경로도 허용
+     */
+    parent: z.string().trim().min(1).optional(),
     /**
      * 묶음 안의 읽는 순서 · 미지정 문서는 뒤에서 이름순
      */

package/src/type/doc-group.ts

@@ -1,4 +1,5 @@
 import type {Doc} from "@/type/doc";
+import type {DocBranch} from "@/type/doc-branch";
 
 /**
  * 사이드바의 문서 묶음 · 같은 이름도 전체 경로로 구분
@@ -13,9 +14,9 @@ export interface DocGroup {
      */
     path: Doc["data"]["group"];
     /**
-     * 현재 묶음에 직접 속한 문서 · order·제목·id 순
+     * 현재 묶음의 부모 없는 문서 · 하위 문서는 각 문서 가지에 포함
      */
-    docs: Doc[];
+    docs: DocBranch[];
     /**
      * 현재 묶음의 하위 묶음 · navigation·이름 순
      */

package/src/type/doc.ts

@@ -13,4 +13,8 @@ export interface Doc extends DocContent {
      * 검증된 머리말
      */
     data: DocData;
+    /**
+     * 검증된 부모 문서 경로 · 최상위부터 직접 부모까지, 자신은 제외
+     */
+    ancestors: string[];
 }

package/src/type/site-assets.ts

@@ -2,6 +2,14 @@
  * 모든 페이지가 공유하는 HTML 머리 자원
  */
 export interface SiteAssets {
+    /**
+     * 내용 지문으로 구분한 스타일시트 URL
+     */
+    stylePath: string;
+    /**
+     * 내용 지문으로 구분한 브라우저 스크립트 URL
+     */
+    clientPath: string;
     /**
      * 내장 @font-face · head의 style 내용
      */

package/src/util/file/to-asset-path.ts

@@ -0,0 +1,26 @@
+import {createHash} from "node:crypto";
+import {readFileSync} from "node:fs";
+import {posix} from "node:path";
+
+/**
+ * 파일 내용으로 자원 URL을 구분하는 입력
+ */
+export interface AssetPathOptions {
+    /**
+     * 사이트 루트 기준 기본 자원 경로
+     */
+    path: string;
+    /**
+     * 배포할 실제 파일 경로
+     */
+    file: string;
+}
+
+/**
+ * 파일명에 내용 지문 추가 · 같은 내용은 같은 URL, 변경한 내용은 새 캐시 키 사용
+ */
+export const toAssetPath = (options: AssetPathOptions) => {
+    const extension = posix.extname(options.path);
+
+    return `${posix.dirname(options.path)}/${posix.basename(options.path, extension)}.${createHash("sha256").update(readFileSync(options.file)).digest("hex")}${extension}`;
+};