for-humanity 0.12.0 → 0.13.0

package/src/component/widget/prose/_constant/heading-highlight.ts

@@ -1,4 +0,0 @@
-/**
- * 앵커 이동 후 제목 강조 유지 시간 · 이후 CSS로 서서히 해제
- */
-export const heading_highlight_hold_ms = 3000;

package/src/component/widget/prose/_constant/section.ts

@@ -1,7 +0,0 @@
-/**
- * 목차 대상 제목 깊이 · h2 절, h3 소제목
- */
-export const section_heading_depth = {
-    section: 2,
-    sub: 3,
-} as const;

package/src/component/widget/prose/_constant/status.ts

@@ -1,9 +0,0 @@
-/**
- * 상태 문구 뒤 날짜 패턴 · YYYY-MM-DD
- */
-export const status_date_pattern = String.raw`\d{4}-\d{2}-\d{2}`;
-
-/**
- * 미등록 날짜 상태 후보 · 등록 문구 치환 뒤 남은 괄호 문구
- */
-export const status_candidate_pattern = new RegExp(String.raw`\([^()\n]*${status_date_pattern}\)`, "g");

package/src/component/widget/prose/_function/has-block-content.ts

@@ -1,30 +0,0 @@
-import type {Nodes} from "mdast";
-
-/**
- * 부품 본문의 내용 판정 · 참조 정의·주석·빈 텍스트와 빈 구조 제외
- * 이미지·표·구분선·주석 외 원시 HTML은 본문 요소
- */
-export const hasBlockContent = (node: Nodes): boolean => {
-    if (node.type === "definition") {
-        return false;
-    }
-
-    if (node.type === "html") {
-        // HTML의 빈 주석·대체 닫힘·미종결 주석 포함
-        return node.value.replace(/<!--(?:>|->|[\s\S]*?(?:--!?>|$))/g, "").trim() !== "";
-    }
-
-    if ("value" in node) {
-        return node.value.trim() !== "";
-    }
-
-    if (node.type === "table" || node.type === "textDirective") {
-        return true;
-    }
-
-    if ("children" in node) {
-        return node.children.some(hasBlockContent);
-    }
-
-    return true;
-};

package/src/component/widget/prose/_function/rehype-head.ts

@@ -1,31 +0,0 @@
-import type {Root} from "hast";
-import type {VFile} from "vfile";
-import {section_heading_depth} from "@/component/widget/prose/_constant/section";
-
-/**
- * name 제목과 첫 절 앞 본문의 공통 머리 · README는 원문의 h1 사용
- */
-export const rehypeHead = () => (tree: Root, file: VFile) => {
-    const frontmatter = file.data.fh?.frontmatter;
-
-    const firstSection = tree.children.findIndex((node) => node.type === "element" && node.tagName === `h${section_heading_depth.section}`);
-    const leadEnd = firstSection === -1 ? tree.children.length : firstSection;
-
-    if (frontmatter === undefined && leadEnd === 0) {
-        return;
-    }
-
-    tree.children = [
-        {
-            type: "element",
-            tagName: "header",
-            properties: {className: ["wg_prose__head"]},
-            children: [...tree.children.slice(0, leadEnd).filter((node) => node.type !== "doctype")],
-        },
-        ...tree.children.slice(leadEnd),
-    ];
-
-    if (frontmatter !== undefined && tree.children[0].type === "element") {
-        tree.children[0].children.unshift({type: "element", tagName: "h1", properties: {}, children: [{type: "text", value: frontmatter.name}]});
-    }
-};

package/src/component/widget/prose/_function/rehype-sections/_to-section-headings.ts

@@ -1,20 +0,0 @@
-import type {Element, Root} from "hast";
-import {section_heading_depth} from "@/component/widget/prose/_constant/section";
-
-/**
- * 목차 대상 h2·h3 · 중첩 블록까지 문서 순서 수집
- * rehype-heading-ids의 순회 순서와 일치
- */
-export const toSectionHeadings = (node: Root | Element): Element[] => {
-    return node.children.flatMap((child) => {
-        if (child.type !== "element") {
-            return [];
-        }
-
-        if (child.tagName === `h${section_heading_depth.section}` || child.tagName === `h${section_heading_depth.sub}`) {
-            return [child];
-        }
-
-        return toSectionHeadings(child);
-    });
-};

package/src/component/widget/prose/_function/rehype-sections/rehype-sections.ts

@@ -1,21 +0,0 @@
-import type {Root} from "hast";
-import type {VFile} from "vfile";
-import {toSectionHeadings} from "@/component/widget/prose/_function/rehype-sections/_to-section-headings";
-import type {DocSection} from "@/type/doc-section";
-
-/**
- * h2·h3의 가름 메타데이터 수집 · 작성한 제목은 그대로 유지
- * id·목차 텍스트는 앞 단계의 rehype-heading-ids 소유
- * file.data.fh.sections는 headings의 h2·h3 순서와 일치
- */
-export const rehypeSections = () => (tree: Root, file: VFile) => {
-    if (file.data.fh === undefined) {
-        return;
-    }
-
-    file.data.fh.sections = toSectionHeadings(tree).map(
-        (heading): DocSection => ({
-            part: typeof heading.properties.dataPart === "string" ? heading.properties.dataPart : undefined,
-        }),
-    );
-};

package/src/component/widget/prose/_function/rehype-tables.ts

@@ -1,22 +0,0 @@
-import type {Root} from "hast";
-import {SKIP, visit} from "unist-util-visit";
-
-/**
- * 넓은 표의 내부 가로 스크롤 래퍼
- */
-export const rehypeTables = () => (tree: Root) => {
-    visit(tree, "element", (node, index, parent) => {
-        if (node.tagName !== "table" || parent === undefined || index === undefined) {
-            return;
-        }
-
-        parent.children[index] = {
-            type: "element",
-            tagName: "div",
-            properties: {className: ["wg_prose__table"]},
-            children: [node],
-        };
-
-        return [SKIP, index + 1];
-    });
-};

package/src/component/widget/prose/_function/remark-blocks.ts

@@ -1,112 +0,0 @@
-import type {Root} from "mdast";
-import {toString as toPlainText} from "mdast-util-to-string";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {section_heading_depth} from "@/component/widget/prose/_constant/section";
-import {hasBlockContent} from "@/component/widget/prose/_function/has-block-content";
-import {copy_error_directive_syntax} from "@/constant/copy";
-
-/**
- * Note·Details의 제목·본문·속성·닫힘 계약
- * label은 첫 자식 · summary는 Details의 첫 요소 · 원문 위치는 오류 기준
- */
-export const remarkBlocks = () => (tree: Root, file: VFile) => {
-    const source = String(file.value);
-
-    visit(tree, (node, _index, parent) => {
-        if (node.type === "leafDirective" && node.name === "part" && parent?.type !== "root") {
-            file.fail(`${copy_error_directive_syntax}: part · 문서 최상위에 작성`, node);
-        }
-
-        if (node.type !== "containerDirective" && node.type !== "leafDirective" && node.type !== "textDirective") {
-            return;
-        }
-
-        if (node.name !== "note" && node.name !== "details") {
-            return;
-        }
-
-        if (node.type !== "containerDirective") {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · ::: 블록으로 작성`, node);
-        }
-
-        const label = node.children.at(0);
-
-        if (label?.type !== "paragraph" || label.data?.directiveLabel !== true || label.children.some((child) => child.type !== "text")) {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 일반 텍스트 제목 필수`, node);
-        }
-
-        const title = toPlainText(label).trim();
-
-        if (title === "") {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 비어 있지 않은 제목 필수`, node);
-        }
-
-        if (!node.children.slice(1).some(hasBlockContent)) {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 본문 필수`, node);
-        }
-
-        const unsupported = node.attributes ? Object.keys(node.attributes).find((key) => node.name !== "details" || key !== "open") : undefined;
-
-        if (unsupported !== undefined) {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 미지원 속성 ${unsupported}`, node);
-        }
-
-        const open = node.attributes?.open;
-        const attributeSource = source.slice(label.position?.end.offset, node.position?.end.offset).split(/\r?\n/, 1)[0].trim();
-
-        // 속성 정규화 이전의 표기 · 중복 open과 open="" 거부
-        if (attributeSource !== "" && (node.name !== "details" || !/^\{[ \t]*open[ \t]*\}$/.test(attributeSource))) {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 허용 속성은 Details의 {open}, 나머지는 생략`, node);
-        }
-
-        const original = source.slice(node.position?.start.offset, node.position?.end.offset);
-        const opening = /^(:{3,})/.exec(original);
-        const closing = /(?:^|\n)[ \t>]*(:{3,})[ \t]*\r?$/.exec(original);
-
-        if (
-            opening === null ||
-            closing === null ||
-            closing.index + closing[0].length !== original.length ||
-            closing[1].length < opening[1].length ||
-            node.position?.end.offset === node.children.at(-1)?.position?.end.offset
-        ) {
-            file.fail(`${copy_error_directive_syntax}: ${node.name} · 블록을 닫는 fence 필수`, node);
-        }
-
-        visit(node, "heading", (heading) => {
-            if (heading.depth <= section_heading_depth.section) {
-                file.fail(`${copy_error_directive_syntax}: ${node.name} · #·## 제목은 부품 밖에 작성`, heading);
-            }
-        });
-
-        // 코드 안의 :::가 container를 먼저 닫은 경우 · 더 긴 바깥 fence로 구분
-        visit(node, "code", (code) => {
-            const originalCode = source.slice(code.position?.start.offset, code.position?.end.offset);
-            const codeOpening = /^ {0,3}(`{3,}|~{3,})/.exec(originalCode);
-            const codeClosing = /(?:^|\n)[ \t>]*(`{3,}|~{3,})[ \t]*\r?$/.exec(originalCode);
-
-            if (
-                codeOpening !== null &&
-                (codeClosing === null ||
-                    codeClosing.index + codeClosing[0].length !== originalCode.length ||
-                    codeClosing[1][0] !== codeOpening[1][0] ||
-                    codeClosing[1].length < codeOpening[1].length)
-            ) {
-                file.fail(`${copy_error_directive_syntax}: ${node.name} · 코드 fence를 닫고, 코드 안의 :보다 긴 바깥 fence 사용`, code);
-            }
-        });
-
-        label.children = [{type: "text", value: title}];
-        label.data = {
-            ...label.data,
-            hName: node.name === "note" ? "strong" : "summary",
-            hProperties: {className: [node.name === "note" ? "wg_prose__noteTitle" : "wg_prose__detailsSummary"]},
-        };
-        node.data = {
-            ...node.data,
-            hName: node.name === "note" ? "aside" : "details",
-            hProperties: node.name === "note" ? {className: ["wg_prose__note"], ariaLabel: title} : {className: ["wg_prose__details"], open: open === ""},
-        };
-    });
-};

package/src/component/widget/prose/_function/remark-flow.ts

@@ -1,26 +0,0 @@
-import type {Root} from "mdast";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {copy_error_flow} from "@/constant/copy";
-import {renderFlow} from "@/util/mermaid/render-flow";
-
-/**
- * Mermaid → 격자 SVG · beautiful-mermaid 기반
- * 실패 시 파일·줄을 포함한 빌드 오류
- */
-export const remarkFlow = () => (tree: Root, file: VFile) => {
-    visit(tree, "code", (node, index, parent) => {
-        if (node.lang !== "mermaid" || parent === undefined || index === undefined) {
-            return;
-        }
-
-        try {
-            parent.children[index] = {
-                type: "html",
-                value: `<div class="wg_prose__flow">${renderFlow(node.value)}</div>`,
-            };
-        } catch (error) {
-            file.fail(`${copy_error_flow}: ${error instanceof Error ? error.message : String(error)}`, node);
-        }
-    });
-};

package/src/component/widget/prose/_function/remark-links.ts

@@ -1,33 +0,0 @@
-import {existsSync} from "node:fs";
-import {dirname, posix, relative, resolve} from "node:path";
-import type {Root} from "mdast";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {copy_warn_broken_link} from "@/constant/copy";
-
-/**
- * 상대 Markdown 링크 → 사이트 URL · query·hash 원문 유지
- * 외부·절대 URL과 같은 페이지 hash 유지 · 없는 파일은 터미널 경고
- */
-export const remarkLinks = (options: {root: string}) => (tree: Root, file: VFile) => {
-    const here = dirname(relative(options.root, file.path));
-
-    visit(tree, (node) => {
-        if (node.type !== "link" && node.type !== "definition") {
-            return;
-        }
-
-        // 셋째 capture: query·hash 접미사 · 파일 확인과 경로 정규화에서 제외
-        const match = /^(?![a-z]+:|\/|#)([^#?]+)(\.mdx?)([?#].*|)$/i.exec(node.url);
-
-        if (match) {
-            if (!existsSync(resolve(dirname(file.path), `${match[1]}${match[2]}`))) {
-                file.message(`${copy_warn_broken_link}: ${node.url}`, node);
-            }
-
-            const target = posix.join(here, `${match[1]}${match[2]}`).toLowerCase();
-
-            node.url = target === "readme.md" ? `/${match[3]}` : `/${posix.join(here, match[1]).toLowerCase()}/${match[3]}`;
-        }
-    });
-};

package/src/component/widget/prose/_function/remark-parts.ts

@@ -1,26 +0,0 @@
-import type {Root} from "mdast";
-import {toString as toPlainText} from "mdast-util-to-string";
-import {section_heading_depth} from "@/component/widget/prose/_constant/section";
-
-/**
- * ::part[이름]의 본문 가름과 다음 h2의 data-part
- * rehype-sections에서 같은 지점의 목차 묶음 생성
- */
-export const remarkParts = () => (tree: Root) => {
-    for (const [index, node] of tree.children.entries()) {
-        if (node.type !== "leafDirective" || node.name !== "part") {
-            continue;
-        }
-
-        const section = tree.children.slice(index + 1).find((next) => next.type === "heading" && next.depth === section_heading_depth.section);
-
-        node.data = {hName: "div", hProperties: {className: ["wg_prose__part"]}};
-
-        if (section) {
-            section.data = {
-                ...section.data,
-                hProperties: {...section.data?.hProperties, dataPart: toPlainText(node).trim()},
-            };
-        }
-    }
-};

package/src/component/widget/prose/_function/remark-status.ts

@@ -1,59 +0,0 @@
-import {escape as escapeHtml, escapeRegExp} from "es-toolkit/string";
-import type {Root} from "mdast";
-import {findAndReplace, type RegExpMatchObject} from "mdast-util-find-and-replace";
-import type {VFile} from "vfile";
-import {status_candidate_pattern, status_date_pattern} from "@/component/widget/prose/_constant/status";
-import {copy_warn_unknown_status} from "@/constant/copy";
-import type {SiteConfig} from "@/type/site-config";
-
-/**
- * 설정 문구의 상태 표지 변환 · 괄호 제거 · 제목·링크 제외
- * 미등록 날짜 문구는 파일 경고 · remark-report에서 출력
- */
-export const remarkStatus = (options: {status: SiteConfig["status"]}) => {
-    const statuses = options.status.toSorted((a, b) => b.phrase.length - a.phrase.length);
-    const phrases = statuses.map((item) => [escapeRegExp(item.phrase), ...(item.date ? [`(?: ${status_date_pattern})?`] : [])].join("")).join("|");
-    const pattern = new RegExp(String.raw`\((${phrases})\)|(${phrases})`, "g");
-    const ignore = ["link", "linkReference", "heading"];
-
-    return (tree: Root, file: VFile) => {
-        findAndReplace(
-            tree,
-            [
-                pattern,
-                (_match: string, inParens: string | undefined, bare: string | undefined) => {
-                    const text = inParens ?? bare;
-                    const item = statuses.find((status) => text?.startsWith(status.phrase));
-
-                    // findAndReplace의 false: 원문 유지
-                    if (text === undefined || item === undefined) {
-                        return false;
-                    }
-
-                    return {
-                        type: "html",
-                        value: `<span class="wg_prose__pill wg_prose__pill--${item.kind}">${escapeHtml(text)}</span>`,
-                    };
-                },
-            ],
-            {ignore},
-        );
-
-        findAndReplace(
-            tree,
-            [
-                status_candidate_pattern,
-                (match: string, info: RegExpMatchObject) => {
-                    // 치환된 텍스트에 position 부재 · 위치가 남은 가까운 조상 기준
-                    file.message(
-                        `${copy_warn_unknown_status}: ${match}`,
-                        info.stack.findLast((node) => node.position !== undefined),
-                    );
-
-                    return false;
-                },
-            ],
-            {ignore},
-        );
-    };
-};

package/src/component/widget/prose/_function/remark-swatch.ts

@@ -1,16 +0,0 @@
-import type {Root} from "mdast";
-import {visit} from "unist-util-visit";
-
-/**
- * 인라인 hex 색 값의 칩 표시
- * 문서별 색은 --wg-prose-chip-color로 전달 · 고정 스타일시트 값 불가
- */
-export const remarkSwatch = () => (tree: Root) => {
-    visit(tree, "inlineCode", (node) => {
-        if (/^#[0-9a-f]{3,8}$/i.test(node.value.trim())) {
-            node.data = {
-                hProperties: {className: ["wg_prose__color"], style: `--wg-prose-chip-color: ${node.value.trim()}`},
-            };
-        }
-    });
-};

package/src/component/widget/prose/_function/remark-unknown-directives.ts

@@ -1,25 +0,0 @@
-import type {Root} from "mdast";
-import {SKIP, visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {copy_error_unknown_directive} from "@/constant/copy";
-
-/**
- * hName 없는 블록 지시문은 작성 오류
- * textDirective는 원문 복원 · 예:이것 같은 일반 문장의 오인 방지
- */
-export const remarkUnknownDirectives = () => (tree: Root, file: VFile) => {
-    visit(tree, (node, index, parent) => {
-        if (node.type === "textDirective" && parent !== undefined && index !== undefined) {
-            parent.children[index] = {
-                type: "text",
-                value: String(file.value).slice(node.position?.start.offset, node.position?.end.offset),
-            };
-
-            return SKIP;
-        }
-
-        if ((node.type === "leafDirective" || node.type === "containerDirective") && node.data?.hName === undefined) {
-            file.fail(`${copy_error_unknown_directive}: ${node.name}`, node);
-        }
-    });
-};