for-humanity 0.12.0 → 0.13.1

package/src/entry/cli/_function/create-processor/_rehype-assets.ts

@@ -1,70 +0,0 @@
-import {existsSync, realpathSync, statSync} from "node:fs";
-import {dirname, extname, isAbsolute, relative, resolve, sep} from "node:path";
-import type {Root} from "hast";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {asset_media_dir, asset_media_extensions} from "@/constant/asset";
-import {copy_error_asset} from "@/constant/copy";
-import {toAssetPath} from "@/util/file/to-asset-path";
-
-/**
- * 명시적으로 참조한 로컬 이미지·첨부의 수집 계약
- */
-export interface AssetOptions {
-    /**
-     * 자원을 읽을 수 있는 문서 루트
-     */
-    root: string;
-    /**
-     * dev 응답과 정적 복사에서 공유할 URL → 파일 목록
-     */
-    files: Map<string, string>;
-}
-
-/**
- * 파일 위치 기준 이미지·첨부 → 내용 지문 URL · 원시 HTML도 같은 규칙
- * 없는 파일, 폴더 밖 경로와 symlink, 지원하지 않는 이미지 형식은 빌드 실패
- * 절대 URL·외부 URL은 작성자가 제공하며 수집하지 않음
- */
-export const rehypeAssets = (options: AssetOptions) => (tree: Root, file: VFile) => {
-    visit(tree, "element", (node) => {
-        const property = node.tagName === "img" ? "src" : "href";
-        const url = node.properties[property];
-
-        if ((node.tagName !== "img" && node.tagName !== "a") || typeof url !== "string" || /^(?:[a-z][a-z\d+.-]*:|\/|#)/i.test(url)) {
-            return;
-        }
-
-        const match = /^([^?#]+)([?#].*)?$/.exec(url);
-        if (match === null) {
-            return;
-        }
-
-        const path = decodeURIComponent(match[1]);
-        const extension = extname(path).toLowerCase();
-        if (!asset_media_extensions.has(extension)) {
-            if (node.tagName === "img") {
-                file.fail(`${copy_error_asset}: 지원하지 않는 이미지 형식 · ${url}`, node);
-            }
-            return;
-        }
-
-        const target = resolve(dirname(file.path), path);
-        const location = relative(options.root, target);
-        if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) {
-            file.fail(`${copy_error_asset}: 문서 폴더 밖 · ${url}`, node);
-        }
-        if (!existsSync(target)) {
-            file.fail(`${copy_error_asset}: 파일이 없다 · ${url}`, node);
-        }
-        const actual = realpathSync(target);
-        const actualLocation = relative(realpathSync(options.root), actual);
-        if (actualLocation === ".." || actualLocation.startsWith(`..${sep}`) || isAbsolute(actualLocation) || !statSync(actual).isFile()) {
-            file.fail(`${copy_error_asset}: 문서 폴더 밖이거나 일반 파일이 아니다 · ${url}`, node);
-        }
-
-        const assetUrl = toAssetPath({path: `${asset_media_dir}/asset${extension}`, file: actual});
-        options.files.set(assetUrl, actual);
-        node.properties[property] = match[2] === undefined ? assetUrl : `${assetUrl}${match[2]}`;
-    });
-};

package/src/entry/cli/_function/create-processor/_rehype-heading-ids.ts

@@ -1,34 +0,0 @@
-import Slugger from "github-slugger";
-import type {Root} from "hast";
-import {toString as toPlainText} from "hast-util-to-string";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import type {DocHeading} from "@/type/doc-heading";
-
-/**
- * 제목 id와 목차 수집 · 같은 제목은 -1, -2 접미사
- * 작성한 제목 텍스트를 그대로 사용
- */
-export const rehypeHeadingIds = () => (tree: Root, file: VFile) => {
-    const slugger = new Slugger();
-    const headings: DocHeading[] = [];
-
-    visit(tree, "element", (node) => {
-        const depth = /^h([1-6])$/.exec(node.tagName)?.[1];
-
-        if (depth === undefined) {
-            return;
-        }
-
-        const text = toPlainText(node);
-
-        node.properties.id = typeof node.properties.id === "string" ? node.properties.id : slugger.slug(text);
-        headings.push({depth: Number(depth), slug: node.properties.id, text});
-        // 텍스트 노드에는 className을 줄 수 없어 강조 영역을 분리 · 제목의 기존 줄바꿈 유지
-        node.children = [{type: "element", tagName: "span", properties: {className: ["wg_prose__headingText"]}, children: node.children}];
-    });
-
-    if (file.data.fh) {
-        file.data.fh.headings = headings;
-    }
-};

package/src/entry/cli/_function/create-processor/_remark-report.ts

@@ -1,15 +0,0 @@
-import {relative} from "node:path";
-import type {Root} from "mdast";
-import type {VFile} from "vfile";
-
-/**
- * 파일 경고의 터미널 출력 · 파일:줄 경고 · 빌드 계속
- * 경고 수집 뒤 실행하는 마지막 remark 플러그인
- */
-export const remarkReport = (options: {root: string}) => (_tree: Root, file: VFile) => {
-    const path = relative(options.root, file.path);
-
-    for (const message of file.messages) {
-        console.warn(`${message.line === undefined ? path : `${path}:${message.line}`} ${message.reason}`);
-    }
-};

package/src/entry/cli/_function/create-processor/_remark-snippets.ts

@@ -1,117 +0,0 @@
-import {existsSync, readFileSync, realpathSync, statSync} from "node:fs";
-import {dirname, extname, isAbsolute, relative, resolve, sep} from "node:path";
-import type {Root} from "mdast";
-import {visit} from "unist-util-visit";
-import type {VFile} from "vfile";
-import {copy_error_snippet} from "@/constant/copy";
-import {snippet_language_by_extension, snippet_pattern, snippet_region_pattern} from "@/entry/cli/_constant/snippet";
-
-/**
- * 스니펫 수집 계약
- */
-export interface SnippetOptions {
-    /**
-     * 스니펫을 읽을 수 있는 문서 루트
-     */
-    root: string;
-    /**
-     * dev 새로고침이 지켜볼 불러온 파일 경로
-     */
-    snippets: Set<string>;
-}
-
-/**
- * region 이름이 있으면 그 안만, 없으면 전체 · region 표시 줄은 항상 제거 · 공통 들여쓰기 제거
- */
-const toSnippetBody = (source: string, region: string | undefined): string | undefined => {
-    const lines = source.replace(/\r\n/g, "\n").split("\n");
-    let inside = region === undefined;
-    let found = region === undefined;
-    const kept: string[] = [];
-
-    for (const line of lines) {
-        const marker = snippet_region_pattern.exec(line);
-
-        if (marker !== null) {
-            if (region !== undefined && marker[2] === region) {
-                inside = marker[1] === undefined;
-                found = true;
-            }
-
-            continue;
-        }
-
-        if (inside) {
-            kept.push(line);
-        }
-    }
-
-    if (!found) {
-        return undefined;
-    }
-
-    while (kept.length > 0 && kept[0]?.trim() === "") {
-        kept.shift();
-    }
-
-    while (kept.length > 0 && kept.at(-1)?.trim() === "") {
-        kept.pop();
-    }
-
-    const indents = kept.filter((line) => line.trim() !== "").map((line) => line.length - line.trimStart().length);
-    const indent = indents.length === 0 ? 0 : Math.min(...indents);
-
-    return kept.map((line) => line.slice(Math.min(indent, line.length - line.trimStart().length))).join("\n");
-};
-
-/**
- * `<<< ./path.ext#region 메타` 문단 → 코드 펜스 · 파일 위치 기준 경로 · 문서 폴더 밖과 없는 파일은 빌드 실패
- * 불러온 파일은 dev 감시 목록에 올림
- */
-export const remarkSnippets = (options: SnippetOptions) => (tree: Root, file: VFile) => {
-    visit(tree, "paragraph", (node, index, parent) => {
-        const [child] = node.children;
-
-        if (node.children.length !== 1 || child === undefined || child.type !== "text" || parent === undefined || index === undefined) {
-            return;
-        }
-
-        const match = snippet_pattern.exec(child.value.trim());
-
-        if (match === null) {
-            return;
-        }
-
-        const [, path = "", region, meta] = match;
-        const target = resolve(dirname(file.path), path);
-        const location = relative(options.root, target);
-
-        if (location === ".." || location.startsWith(`..${sep}`) || isAbsolute(location)) {
-            file.fail(`${copy_error_snippet}: 문서 폴더 밖 · ${path}`, node);
-        }
-
-        if (!existsSync(target)) {
-            file.fail(`${copy_error_snippet}: 파일이 없다 · ${path}`, node);
-        }
-
-        const actual = realpathSync(target);
-        const actualLocation = relative(realpathSync(options.root), actual);
-
-        if (actualLocation === ".." || actualLocation.startsWith(`..${sep}`) || isAbsolute(actualLocation) || !statSync(actual).isFile()) {
-            file.fail(`${copy_error_snippet}: 문서 폴더 밖이거나 일반 파일이 아니다 · ${path}`, node);
-        }
-
-        const body = toSnippetBody(readFileSync(actual, "utf8"), region);
-
-        if (body === undefined) {
-            file.fail(`${copy_error_snippet}: region 이 없다 · ${path}#${region}`, node);
-            return;
-        }
-
-        const extension = extname(actual).toLowerCase();
-        const lang = snippet_language_by_extension[extension] === undefined ? extension.slice(1) : snippet_language_by_extension[extension];
-
-        options.snippets.add(actual);
-        parent.children.splice(index, 1, {type: "code", lang, meta: meta === undefined ? null : meta, value: body});
-    });
-};

package/src/entry/cli/_function/create-processor/_shiki-transformers.ts

@@ -1,91 +0,0 @@
-import {
-    transformerMetaHighlight,
-    transformerNotationDiff,
-    transformerNotationErrorLevel,
-    transformerNotationHighlight,
-    transformerNotationWordHighlight,
-} from "@shikijs/transformers";
-import type {Element, ElementContent} from "hast";
-import type {ShikiTransformer} from "shiki";
-
-/**
- * 펜스 메타에 `line-numbers` 가 있으면 pre 에 줄 번호 클래스 · 번호는 CSS counter
- */
-const lineNumbers: ShikiTransformer = {
-    name: "for-humanity:line-numbers",
-    pre(node) {
-        const meta = this.options.meta?.__raw;
-
-        if (typeof meta === "string" && /\bline-numbers\b/.test(meta)) {
-            this.addClassToHast(node, "wg_prose__lineNumbers");
-        }
-    },
-};
-
-/**
- * 펜스 메타 `bad`·`good` → pre 에 블록 색 클래스 · 바탕색은 token.css 가 바꿈
- */
-const tone: ShikiTransformer = {
-    name: "for-humanity:code-tone",
-    pre(node) {
-        const meta = this.options.meta?.__raw;
-
-        if (typeof meta !== "string") {
-            return;
-        }
-
-        for (const word of ["bad", "good"]) {
-            if (new RegExp(`\\b${word}\\b`).test(meta)) {
-                this.addClassToHast(node, `wg_prose__code--${word}`);
-            }
-        }
-    },
-};
-
-/**
- * 펜스 메타 `[파일 이름]` → figure 로 감싸고 제목 띠에 파일 이름과 언어 · 블록 색 클래스는 figure 에도 둠
- */
-const fileTitle: ShikiTransformer = {
-    name: "for-humanity:code-title",
-    root(root) {
-        const meta = this.options.meta?.__raw;
-        const title = typeof meta === "string" ? /\[([^\]]+)\]/.exec(meta)?.[1] : undefined;
-
-        if (title === undefined) {
-            return;
-        }
-
-        const tones = typeof meta === "string" ? ["bad", "good"].filter((word) => new RegExp(`\\b${word}\\b`).test(meta)) : [];
-        const caption: Element = {
-            type: "element",
-            tagName: "figcaption",
-            properties: {className: ["wg_prose__codeFileTitle"]},
-            children: [
-                {type: "text", value: title},
-                {type: "element", tagName: "span", properties: {className: ["wg_prose__codeFileLang"]}, children: [{type: "text", value: this.options.lang}]},
-            ],
-        };
-        const figure: Element = {
-            type: "element",
-            tagName: "figure",
-            properties: {className: ["wg_prose__codeFile", ...tones.map((tone) => `wg_prose__codeFile--${tone}`)]},
-            children: [caption, ...root.children.filter((child): child is ElementContent => child.type !== "doctype")],
-        };
-
-        root.children = [figure];
-    },
-};
-
-/**
- * 코드 줄 표기 · `// [!code highlight|error|warning|++|--]`, `// [!code word:x]`, 메타 `{2,4-6}`, `line-numbers`, 블록 색 `bad`·`good`, 제목 `[파일 이름]`
- */
-export const shikiTransformers: ShikiTransformer[] = [
-    transformerNotationHighlight({matchAlgorithm: "v3"}),
-    transformerNotationErrorLevel({matchAlgorithm: "v3"}),
-    transformerNotationDiff({matchAlgorithm: "v3"}),
-    transformerNotationWordHighlight({matchAlgorithm: "v3"}),
-    transformerMetaHighlight(),
-    lineNumbers,
-    tone,
-    fileTitle,
-];

package/src/entry/cli/_function/create-processor/create-processor.ts

@@ -1,64 +0,0 @@
-import rehypeShiki from "@shikijs/rehype";
-import rehypeRaw from "rehype-raw";
-import rehypeStringify from "rehype-stringify";
-import remarkDirective from "remark-directive";
-import remarkFrontmatter from "remark-frontmatter";
-import remarkGfm from "remark-gfm";
-import remarkParse from "remark-parse";
-import remarkRehype from "remark-rehype";
-import remarkSmartypants from "remark-smartypants";
-import {createCssVariablesTheme} from "shiki";
-import {unified} from "unified";
-import {rehypeHead} from "@/component/widget/prose/_function/rehype-head";
-import {rehypeSections} from "@/component/widget/prose/_function/rehype-sections/rehype-sections";
-import {rehypeTables} from "@/component/widget/prose/_function/rehype-tables";
-import {remarkBlocks} from "@/component/widget/prose/_function/remark-blocks";
-import {remarkFlow} from "@/component/widget/prose/_function/remark-flow";
-import {remarkLinks} from "@/component/widget/prose/_function/remark-links";
-import {remarkParts} from "@/component/widget/prose/_function/remark-parts";
-import {remarkStatus} from "@/component/widget/prose/_function/remark-status";
-import {remarkSwatch} from "@/component/widget/prose/_function/remark-swatch";
-import {remarkUnknownDirectives} from "@/component/widget/prose/_function/remark-unknown-directives";
-import {rehypeAssets} from "@/entry/cli/_function/create-processor/_rehype-assets";
-import {rehypeHeadingIds} from "@/entry/cli/_function/create-processor/_rehype-heading-ids";
-import {remarkReport} from "@/entry/cli/_function/create-processor/_remark-report";
-import {remarkSnippets} from "@/entry/cli/_function/create-processor/_remark-snippets";
-import {shikiTransformers} from "@/entry/cli/_function/create-processor/_shiki-transformers";
-import type {SiteConfig} from "@/type/site-config";
-
-/**
- * Markdown 처리 순서: remark(스니펫·부품·흐름도) → 코드 강조(줄 표기·블록 색 transformer) → 머리 → 제목 id → 가름 수집 → 표
- * 플러그인 HTML 조각은 마지막 rehype-raw에서 해석
- * Shiki inline style: token.css의 --app-code-* 참조
- */
-export const createProcessor = (options: {site: SiteConfig; root: string; files?: Map<string, string>; snippets?: Set<string>}) => {
-    return unified()
-        .use(remarkParse)
-        .use(remarkFrontmatter, ["yaml"])
-        .use(remarkGfm)
-        .use(remarkSnippets, {root: options.root, snippets: options.snippets ?? new Set<string>()})
-        .use(remarkSmartypants)
-        .use(remarkDirective)
-        .use(remarkBlocks)
-        .use(remarkParts)
-        .use(remarkFlow)
-        .use(remarkStatus, {status: options.site.status})
-        .use(remarkSwatch)
-        .use(remarkLinks, {root: options.root})
-        .use(remarkUnknownDirectives)
-        .use(remarkReport, {root: options.root})
-        .use(remarkRehype, {allowDangerousHtml: true})
-        .use(rehypeShiki, {theme: createCssVariablesTheme({name: "for-humanity", variablePrefix: "--app-code-"}), transformers: shikiTransformers})
-        .use(rehypeHead)
-        .use(rehypeHeadingIds)
-        .use(rehypeSections)
-        .use(rehypeTables)
-        .use(rehypeRaw)
-        .use(rehypeAssets, {root: options.root, files: options.files ?? new Map<string, string>()})
-        .use(rehypeStringify, {allowDangerousHtml: true});
-};
-
-/**
- * 플러그인 조립을 마친 Markdown 처리기
- */
-export type Processor = ReturnType<typeof createProcessor>;

package/src/entry/cli/_function/read-docs.ts

@@ -1,128 +0,0 @@
-import {readdir, readFile} from "node:fs/promises";
-import {join, posix, sep} from "node:path";
-import {VFile} from "vfile";
-import {parse as parseYaml} from "yaml";
-import {asset_dir, asset_favicon_path} from "@/constant/asset";
-import {
-    copy_error_doc_id,
-    copy_error_doc_id_clash,
-    copy_error_doc_parent_cycle,
-    copy_error_doc_parent_group,
-    copy_error_doc_parent_missing,
-    copy_error_frontmatter,
-} from "@/constant/copy";
-import type {Processor} from "@/entry/cli/_function/create-processor/create-processor";
-import type {Doc} from "@/type/doc";
-import {docDataSchema} from "@/type/doc-data";
-import type {DocFileData} from "@/type/doc-file-data";
-
-/**
- * 문서 폴더를 읽고 명령별 출력 경로와 함께 검증하는 입력
- */
-export interface ReadDocsParams {
-    /**
-     * CLI에 넘긴 문서 폴더의 절대 경로
-     */
-    root: string;
-    /**
-     * 설정·자원 목록을 연결한 Markdown 처리기
-     */
-    processor: Processor;
-    /**
-     * 명령이 생성할 파일과 충돌하는 첫 경로 조각 · 생략 시 추가 예약 없음
-     */
-    reserved?: readonly string[];
-}
-
-/**
- * Markdown 수집과 렌더링 · 루트 README는 홈, AGENTS·CLAUDE는 작성 지침으로 분리
- * 문서 목록에서 루트 안내 파일·node_modules·dist 제외
- * 머리말·문서 식별자 중복·플러그인 오류 시 실패
- */
-export const readDocs = async (options: ReadDocsParams): Promise<Doc[]> => {
-    const paths = (await readdir(options.root, {recursive: true})).filter(
-        (path) => /\.mdx?$/i.test(path) && !/^(readme|agents|claude)\.md$/i.test(path) && !path.split(sep).includes("node_modules") && !path.startsWith(`dist${sep}`),
-    );
-    const docs = await Promise.all(
-        paths.map(async (path): Promise<Doc> => {
-            const id = path
-                .replace(/\.mdx?$/i, "")
-                .split(sep)
-                .join("/")
-                .toLowerCase();
-            const segments = id.split("/");
-
-            // Hono·SSG·정적 제공의 공통 URL 계약 · 예약 문자에 의한 페이지 누락 방지
-            if (
-                segments.some((segment) => segment === "" || segment === "." || segment === ".." || segment === "index.html") ||
-                /[#?%*:\\]/.test(id) ||
-                /[\p{Cc}]/u.test(id) ||
-                options.reserved?.includes(segments[0]) === true ||
-                segments[0] === asset_dir ||
-                segments[0] === asset_favicon_path.slice(1)
-            ) {
-                throw new Error(`${copy_error_doc_id}: ${path}`);
-            }
-
-            const source = await readFile(join(options.root, path), "utf8");
-            // remark가 제외하는 UTF-8 BOM을 원문에서도 제거 · 지시문의 offset 기준 일치
-            const file = new VFile({value: source.replace(/^\uFEFF/, ""), path: join(options.root, path)});
-            const tree = options.processor.parse(file);
-            const frontmatter = tree.children[0];
-            const parsed = docDataSchema.safeParse(frontmatter?.type === "yaml" ? parseYaml(frontmatter.value) : {});
-
-            if (!parsed.success) {
-                throw new Error(`${copy_error_frontmatter}: ${path}: ${parsed.error.issues.map((issue) => `${issue.path.join(".")} ${issue.message}`).join(", ")}`);
-            }
-
-            // 상대 부모 id는 파일 위치 기준으로 한 번 해소 · 문서 루트를 바꿔도 같은 관계 유지
-            const data = {
-                ...parsed.data,
-                parent: parsed.data.parent !== undefined && /^\.\.?\//.test(parsed.data.parent) ? posix.join(posix.dirname(id), parsed.data.parent) : parsed.data.parent,
-            };
-
-            // 플러그인의 제목·절 정보 공유
-            const fh: DocFileData = {frontmatter: data, headings: [], sections: []};
-            file.data.fh = fh;
-
-            // YAML 노드만 제외 · 본문 위치와 오류의 원본 줄·열·offset 유지
-            tree.children = tree.children.filter((node) => node.type !== "yaml");
-            const rendered = await options.processor.run(tree, file);
-
-            return {
-                id,
-                data,
-                ancestors: [],
-                html: options.processor.stringify(rendered, file),
-                outline: {headings: fh.headings, sections: fh.sections},
-            };
-        }),
-    );
-    const duplicateIds = [...Map.groupBy(docs, (doc) => doc.id)].filter((entry) => entry[1].length > 1);
-
-    if (duplicateIds.length > 0) {
-        throw new Error(`${copy_error_doc_id_clash}: ${duplicateIds.map((entry) => entry[0]).join(", ")}`);
-    }
-
-    // 모든 파일을 수집한 뒤 부모 참조 검증 · 파일 읽기 순서와 무관한 문서 경로
-    const docsById = new Map(docs.map((doc) => [doc.id, doc]));
-    return docs.map((doc) => {
-        const ancestors = new Set([doc.id]);
-        for (let parentId = doc.data.parent; parentId !== undefined; ) {
-            const parent = docsById.get(parentId);
-            if (parent === undefined) {
-                throw new Error(`${copy_error_doc_parent_missing}: ${doc.id} → ${parentId}`);
-            }
-            if (ancestors.has(parent.id)) {
-                throw new Error(`${copy_error_doc_parent_cycle}: ${[...ancestors, parent.id].join(" → ")}`);
-            }
-            if (JSON.stringify(parent.data.group) !== JSON.stringify(doc.data.group)) {
-                throw new Error(`${copy_error_doc_parent_group}: ${doc.id} → ${parent.id}`);
-            }
-            ancestors.add(parent.id);
-            parentId = parent.data.parent;
-        }
-
-        return {...doc, ancestors: [...ancestors].slice(1).toReversed()};
-    });
-};

package/src/entry/cli/_function/read-home.ts

@@ -1,32 +0,0 @@
-import {readdir, readFile} from "node:fs/promises";
-import {join} from "node:path";
-import {VFile} from "vfile";
-import {copy_error_home_clash} from "@/constant/copy";
-import type {Processor} from "@/entry/cli/_function/create-processor/create-processor";
-import type {DocContent} from "@/type/doc-content";
-import type {DocFileData} from "@/type/doc-file-data";
-
-/**
- * 문서 폴더의 README.md → 홈 · 대소문자 무시 · frontmatter 불필요
- * 파일이 없으면 생성 안내 표시, 이름만 다른 README 중복은 오류
- */
-export const readHome = async (options: {root: string; processor: Processor}): Promise<DocContent | undefined> => {
-    const paths = (await readdir(options.root)).filter((path) => path.toLowerCase() === "readme.md");
-
-    if (paths.length > 1) {
-        throw new Error(`${copy_error_home_clash}: ${paths.join(", ")}`);
-    }
-
-    if (paths.length === 0) {
-        return undefined;
-    }
-
-    const path = join(options.root, paths[0]);
-    const fh: DocFileData = {headings: [], sections: []};
-    // 파서와 지시문 원문 복원의 offset 기준을 맞추기 위해 BOM 제외
-    const file = new VFile({value: (await readFile(path, "utf8")).replace(/^\uFEFF/, ""), path, data: {fh}});
-
-    await options.processor.process(file);
-
-    return {html: String(file), outline: {headings: fh.headings, sections: fh.sections}};
-};

package/src/entry/cli/_function/to-crawling-app.ts

@@ -1,42 +0,0 @@
-import {Hono} from "hono";
-import {html} from "hono/html";
-import {crawling_robots_path, crawling_sitemap_path} from "@/entry/cli/_constant/crawling";
-import type {AppOptions} from "@/entry/cli/_function/create-app";
-import type {SiteConfig} from "@/type/site-config";
-
-/**
- * URL을 명시한 공개 프로젝트의 크롤러 응답 입력
- */
-export interface CrawlingParams {
-    /**
-     * 설정 검증에서 루트 origin으로 정규화한 공개 HTTP(S) URL
-     */
-    url: NonNullable<SiteConfig["url"]>;
-    /**
-     * dev 파일 변경 시 교체되는 현재 문서 목록 · 본문은 사이트맵에 포함하지 않음
-     */
-    store: AppOptions["store"];
-}
-
-/**
- * dev와 정적 빌드에서 같은 크롤러 파일 생성 · 정책·수정 시각은 추정하지 않음
- */
-export const toCrawlingApp = (params: CrawlingParams) => {
-    const app = new Hono();
-
-    app.get(crawling_robots_path, (c) => c.text(`User-agent: *\nAllow: /\n\nSitemap: ${params.url}${crawling_sitemap_path}\n`));
-    app.get(
-        crawling_sitemap_path,
-        (_c) =>
-            new Response(
-                html`<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-<url><loc>${params.url}/</loc></url>
-${params.store.docs.map((doc) => html`<url><loc>${params.url}/${doc.id.split("/").map(encodeURIComponent).join("/")}/</loc></url>`)}
-</urlset>`.toString(),
-                {headers: {"Content-Type": "application/xml; charset=utf-8"}},
-            ),
-    );
-
-    return app;
-};