meowpress 0.0.0-stage → 0.1.1-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lidessen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# Meowpress
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`meowpress` 提供静态站点的内容读取、页面渲染、主题和构建流程。
+消费者持有站点配置与内容，通过本包构建；本包不持有应用的文章或输出目录。
+
+当前准备 `0.1.1-alpha.0` 本地候选，尚未发布该版本。CSS 与 JSX 均为必需 peer，允许 `^0.1.0 || ^0.1.1-alpha.0`，保留稳定版兼容范围，并接受本轮 JSX/CSS alpha。宿主选定共享的 CSS/JSX 模块，本包不私装另一份 CSS；不依赖 Meowtail 或 MeowSlides。实际包外构建与主题身份验收绑定精确 tgz，不通过 override 绕过 peer 合同。发布仍需独立明确授权。
+
+本包是独立内容发布库，源码位于 `packages/meowpress`，已有公开构建入口、独立测试与类型检查，
+不依赖 Assistant、WorkCell、Deno 或特定 Blog 的内容与运行状态。样式生成来自 `meowcss`，
+HTML 渲染来自 `meowjsx/web`，无需安装 MeowUI。
+
+## 入口
+
+- `meowpress/build`：`meowSite()` 定义配置，`buildSite()` 执行构建；这是唯一对外 export。
+  内容读取、页面渲染、技能索引与主题是包内模块。
+- `meowpress --config ./site.config.ts`：Bun CLI，加载消费者提供的配置并构建。
+
+```ts
+import { meowSite } from "meowpress/build";
+
+export default meowSite({
+  content: [{ directory: "/path/to/content" }],
+  skillsDirectory: "/path/to/workspace",
+  outputDirectory: "/path/to/dist",
+});
+```
+
+配置中的目录由应用明确提供；默认主题从本包解析，不依赖启动目录。
+可通过 `theme: defineTheme(...)` 替换整套主题；所有静态页面输出该主题的根属性和默认选项。
+构建将 `theme.cssText` 写入临时 CSS，再由 Bun 处理字体与其他资源，最终通过 stylesheet 链接交付，
+无需客户端 JavaScript 即可应用主题。默认字体 Geist 的文件随站点打包，不依赖外部字体服务。
+使用默认字体时，输出同时包含 `licenses/geist-OFL.txt`，保留字体的 SIL OFL 许可。
+默认插画使用包内矢量与 CSS，不要求业务图片。可用 `site.images` 的 `hero`、`feed`、`about`
+显式设置装饰图路径，例如 `images/cover.svg`；路径相对内容根的 `assets/`，库负责各页面深度，
+资源沿现有资产构建流程交付。未设置 About 图片时使用站点名首字母。
+内容源包含 `posts/`、`thoughts/` 和可选资源；以下划线开头的草稿不进入发布输出。
+站点有自己的主题，不隐式安装 MeowUI 的应用主题。
+
+## 验证与构建
+
+安装 `meowpress` 及其 `meowcss`、`meowjsx` 依赖后，在消费者目录运行：
+
+```sh
+bunx --no-install meowpress --config ./site.config.ts
+```
+
+CLI 需要 Bun，输出位置由 `outputDirectory` 决定。字体文件从本包的正式 Geist 依赖解析，
+不要求消费者复制源码、安装工作区根依赖或访问外部字体服务。
+
+## 独立验证
+
+仓库依赖就绪后运行 `bun run --cwd packages/meowpress test` 和
+`bun run --cwd packages/meowpress typecheck`。测试位于 `tests/unit/`；真实构建测试通过公开
+`meowpress/build` 入口创建临时内容、主题和图片，
+覆盖 Markdown、MDX、Thought 输出及草稿页面/资产排除，不读取 Blog 内容或调用 Blog 构建。

package/dist/src/build.d.ts

@@ -0,0 +1,28 @@
+import { type ThemeDefinition } from "meowcss";
+import { type SiteIdentity } from "./identity.js";
+import { type ContentSourceInput } from "./content.js";
+export interface SiteConfig {
+    /** One or more roots containing `posts/`, `thoughts/`, and optional assets. */
+    content: ContentSourceInput | readonly ContentSourceInput[];
+    /** Workspace root used to discover public `skills/` and project `.agents/skills/`. */
+    skillsDirectory: string;
+    /** Static output directory for the generated site. */
+    outputDirectory: string;
+    /** Defaults to this package's own Blog theme. */
+    theme?: ThemeDefinition;
+    /** Optional project root when project Skills live outside `skillsDirectory`. */
+    projectRootDirectory?: string;
+    /** Site name, description, repository links and About copy; unset fields use neutral defaults. */
+    site?: Partial<SiteIdentity>;
+}
+export interface ResolvedSiteConfig {
+    content: readonly ContentSourceInput[];
+    skillsDirectory: string;
+    outputDirectory: string;
+    theme: ThemeDefinition;
+    projectRootDirectory?: string;
+    site: SiteIdentity;
+}
+/** Define a site config in the app package without taking on the build pipeline. */
+export declare function meowSite(config: SiteConfig): ResolvedSiteConfig;
+export declare function buildSite(input: SiteConfig | ResolvedSiteConfig): Promise<void>;

package/dist/src/build.js

@@ -0,0 +1,114 @@
+import { blogTheme } from "./theme.js";
+import { DEFAULT_SITE } from "./identity.js";
+import { mkdir, rm, writeFile, cp } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { collectContentAssets, isDraftAsset, loadSection, normalizeContentSources, } from "./content.js";
+import { aboutPage, agentMarkdown, homePage, listPage, llmText, postPage, skillPage, skillsIndexPage, thoughtPage, } from "./site.js";
+import { loadSkills } from "./skills.js";
+/** Define a site config in the app package without taking on the build pipeline. */
+export function meowSite(config) {
+    return {
+        content: normalizeContentSources(config.content),
+        skillsDirectory: resolve(config.skillsDirectory),
+        outputDirectory: resolve(config.outputDirectory),
+        theme: config.theme ?? blogTheme,
+        projectRootDirectory: config.projectRootDirectory
+            ? resolve(config.projectRootDirectory)
+            : undefined,
+        site: { ...DEFAULT_SITE, ...config.site },
+    };
+}
+async function writePage(generatedDirectory, pathname, html) {
+    const target = join(generatedDirectory, pathname);
+    await mkdir(resolve(target, ".."), { recursive: true });
+    await writeFile(target, html, "utf8");
+    return target;
+}
+async function stageAssets(generatedDirectory, sources) {
+    const assets = await collectContentAssets(sources, { directory: "assets" });
+    await Promise.all(assets
+        .filter((asset) => !isDraftAsset(asset.sourcePath, asset.assetRoot))
+        .map(async (asset) => {
+        const target = join(generatedDirectory, asset.relativePath);
+        await mkdir(resolve(target, ".."), { recursive: true });
+        await cp(asset.sourcePath, target, { force: true });
+    }));
+}
+async function copyPostAssets(outputDirectory, sources) {
+    const assets = await collectContentAssets(sources, { directory: "posts/assets" });
+    await Promise.all(assets
+        .filter((asset) => !isDraftAsset(asset.sourcePath, asset.assetRoot))
+        .map(async (asset) => {
+        const target = join(outputDirectory, "posts/assets", asset.relativePath);
+        await mkdir(resolve(target, ".."), { recursive: true });
+        await cp(asset.sourcePath, target, { force: true });
+    }));
+}
+async function buildStaticHtmlFromEntrypoints(entrypoints, generatedDirectory, outputDirectory) {
+    const result = await Bun.build({
+        entrypoints,
+        root: generatedDirectory,
+        outdir: outputDirectory,
+        target: "browser",
+        minify: true,
+    });
+    if (!result.success) {
+        console.error(result.logs);
+        throw new Error("Unable to build site static HTML");
+    }
+}
+async function writeContentPages(generatedDirectory, posts, thoughts, theme, site) {
+    const entrypoints = [];
+    for (const post of posts) {
+        entrypoints.push(await writePage(generatedDirectory, `posts/${post.slug}/index.html`, postPage(post, posts, thoughts, theme, site)));
+    }
+    for (const thought of thoughts) {
+        entrypoints.push(await writePage(generatedDirectory, `thoughts/${thought.slug}/index.html`, thoughtPage(thought, theme, site)));
+    }
+    return entrypoints;
+}
+export async function buildSite(input) {
+    const config = meowSite(input);
+    const generatedDirectory = resolve(config.outputDirectory, "../.generated");
+    const [posts, thoughts, skills] = await Promise.all([
+        loadSection(config.content, "post"),
+        loadSection(config.content, "thought"),
+        loadSkills(config.skillsDirectory, {
+            projectRootDirectory: config.projectRootDirectory,
+        }),
+    ]);
+    const timeline = [...posts, ...thoughts].sort((left, right) => (right.date?.getTime() ?? 0) - (left.date?.getTime() ?? 0));
+    await rm(config.outputDirectory, { recursive: true, force: true });
+    await rm(generatedDirectory, { recursive: true, force: true });
+    await mkdir(config.outputDirectory, { recursive: true });
+    await mkdir(generatedDirectory, { recursive: true });
+    const entrypoints = await Promise.all([
+        writePage(generatedDirectory, "index.html", homePage(timeline, config.theme, config.site)),
+        writePage(generatedDirectory, "about/index.html", aboutPage(config.theme, config.site)),
+        writePage(generatedDirectory, "posts/index.html", listPage("post", posts, config.theme, config.site)),
+        writePage(generatedDirectory, "thoughts/index.html", listPage("thought", thoughts, config.theme, config.site)),
+        writePage(generatedDirectory, "skills/index.html", skillsIndexPage(skills, config.theme, config.site)),
+    ]);
+    entrypoints.push(...(await writeContentPages(generatedDirectory, posts, thoughts, config.theme, config.site)));
+    for (const skill of skills) {
+        const skillPath = skill.scope === "public" ? `skills/${skill.slug}` : `skills/project/${skill.slug}`;
+        entrypoints.push(await writePage(generatedDirectory, `${skillPath}/index.html`, skillPage(skill, config.theme, config.site)));
+    }
+    await writeFile(join(generatedDirectory, "blog-theme.css"), config.theme.cssText.replaceAll('"@fontsource-variable/geist"', JSON.stringify(fileURLToPath(import.meta.resolve("@fontsource-variable/geist")))), "utf8");
+    await stageAssets(generatedDirectory, config.content);
+    await buildStaticHtmlFromEntrypoints(entrypoints, generatedDirectory, config.outputDirectory);
+    if (config.theme.cssText.includes('"@fontsource-variable/geist"')) {
+        const licensesDirectory = join(config.outputDirectory, "licenses");
+        await mkdir(licensesDirectory, { recursive: true });
+        await cp(fileURLToPath(import.meta.resolve("@fontsource-variable/geist/LICENSE")), join(licensesDirectory, "geist-OFL.txt"));
+    }
+    await copyPostAssets(config.outputDirectory, config.content);
+    await Promise.all([
+        writeFile(join(config.outputDirectory, "llm.txt"), llmText(posts, thoughts, config.site), "utf8"),
+        writeFile(join(config.outputDirectory, "llms.txt"), llmText(posts, thoughts, config.site), "utf8"),
+        writeFile(join(config.outputDirectory, "agents.md"), agentMarkdown(posts, thoughts, config.site), "utf8"),
+    ]);
+    await rm(generatedDirectory, { recursive: true, force: true });
+    console.log(`Built ${posts.length} posts and ${thoughts.length} thoughts into site dist/.`);
+}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export declare function runSiteCli(args?: string[]): Promise<void>;

package/dist/src/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env bun
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { buildSite } from "./build.js";
+function configPathFromArgs(args) {
+    const index = args.indexOf("--config");
+    const configPath = index >= 0 ? args[index + 1] : undefined;
+    if (!configPath || configPath.startsWith("--")) {
+        throw new Error("Usage: meowpress --config <site-config.ts>");
+    }
+    return resolve(process.cwd(), configPath);
+}
+export async function runSiteCli(args = Bun.argv.slice(2)) {
+    const configPath = configPathFromArgs(args);
+    const module = (await import(pathToFileURL(configPath).href));
+    const config = module.default ?? module.site;
+    if (!config)
+        throw new Error(`No default site config exported from ${configPath}`);
+    await buildSite(config);
+}
+if (import.meta.main)
+    await runSiteCli();

package/dist/src/content.d.ts

@@ -0,0 +1,50 @@
+export type ContentKind = "post" | "thought";
+export type Frontmatter = Record<string, unknown>;
+/** A content root containing `posts/`, `thoughts/`, and optional asset folders. */
+export interface ContentSource {
+    directory: string;
+    /** Namespace slugs and asset paths from this source to avoid collisions. */
+    slugPrefix?: string;
+}
+export type ContentSourceInput = string | ContentSource;
+export type DuplicateContentPolicy = "first-wins" | "error";
+export interface LoadSectionOptions {
+    /** The first source wins by default, so the source order is an explicit overlay order. */
+    duplicate?: DuplicateContentPolicy;
+}
+export interface ContentItem {
+    kind: ContentKind;
+    slug: string;
+    sourcePath: string;
+    title: string;
+    excerpt: string;
+    body: string;
+    html: string;
+    metadata: Frontmatter;
+    date?: Date;
+    dateKey: string;
+    timeLabel: string;
+    tags: string[];
+    readingMinutes: number;
+    characterCount: number;
+}
+export interface ParsedDocument {
+    metadata: Frontmatter;
+    body: string;
+}
+export interface ContentAsset {
+    sourcePath: string;
+    assetRoot: string;
+    relativePath: string;
+}
+export interface CollectContentAssetsOptions {
+    /** Relative directory below every source, for example `assets` or `posts/assets`. */
+    directory?: string;
+    duplicate?: DuplicateContentPolicy;
+}
+export declare function normalizeContentSources(input: ContentSourceInput | readonly ContentSourceInput[]): ContentSource[];
+export declare function loadSection(sources: ContentSourceInput | readonly ContentSourceInput[], kind: ContentKind, options?: LoadSectionOptions): Promise<ContentItem[]>;
+export declare function withoutLeadingHeading(html: string): string;
+export declare function collectAssetFiles(directory: string): Promise<string[]>;
+export declare function collectContentAssets(sources: ContentSourceInput | readonly ContentSourceInput[], options?: CollectContentAssetsOptions): Promise<ContentAsset[]>;
+export declare function isDraftAsset(assetPath: string, assetRoot: string): boolean;

package/dist/src/content.js

@@ -0,0 +1,312 @@
+import { compile, run } from "@mdx-js/mdx";
+import remarkGfm from "remark-gfm";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { relative, resolve, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { Fragment, h } from "meowjsx/runtime";
+import { renderToHtml } from "meowjsx/web";
+const CONTENT_EXTENSIONS = new Set([".md", ".mdx"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asText(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return undefined;
+}
+function parseFrontmatter(source) {
+    const match = source.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/);
+    if (!match)
+        return { metadata: {}, body: source };
+    const parsed = parseYaml(match[1]);
+    const metadata = isRecord(parsed) ? parsed : {};
+    return { metadata, body: source.slice(match[0].length) };
+}
+function metadataValue(metadata, keys) {
+    return keys.map((key) => metadata[key]).find((value) => value !== undefined);
+}
+function parseDate(value) {
+    const text = asText(value);
+    if (!text)
+        return undefined;
+    const date = new Date(text);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+function makeDateKey(value, date) {
+    const text = asText(value);
+    const explicitDate = text?.match(/^\d{4}-\d{2}-\d{2}/)?.[0];
+    if (explicitDate)
+        return explicitDate;
+    if (!date)
+        return "undated";
+    return new Intl.DateTimeFormat("en-CA", {
+        timeZone: "Asia/Shanghai",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).format(date);
+}
+function makeTimeLabel(value, date) {
+    const text = asText(value);
+    if (text) {
+        return text.match(/(?:T|\s)(\d{2}:\d{2})/)?.[1] ?? "";
+    }
+    if (!date)
+        return "";
+    return new Intl.DateTimeFormat("zh-CN", {
+        timeZone: "Asia/Shanghai",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    }).format(date);
+}
+function titleFromBody(body, slug) {
+    const heading = body.match(/^#\s+(.+)$/m)?.[1]?.trim();
+    if (heading)
+        return heading.replaceAll(/[*_`]/g, "");
+    return slug
+        .split("/")
+        .at(-1)
+        .replaceAll(/[-_]+/g, " ")
+        .replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+function stripMarkdown(source) {
+    return source
+        .replaceAll(/<!--[\s\S]*?-->/g, "")
+        .replaceAll(/^#{1,6}\s+/gm, "")
+        .replaceAll(/!\[([^\]]*)\]\([^)]*\)/g, "$1")
+        .replaceAll(/\[([^\]]+)\]\([^)]*\)/g, "$1")
+        .replaceAll(/[`*_~]/g, "")
+        .replaceAll(/^>\s?/gm, "")
+        .replaceAll(/^[-*+]\s+/gm, "")
+        .replaceAll(/^\d+\.\s+/gm, "")
+        .replaceAll(/\s+/g, " ")
+        .trim();
+}
+function getTags(metadata) {
+    const value = metadata.tags;
+    if (Array.isArray(value))
+        return value.map(asText).filter(Boolean);
+    if (typeof value === "string") {
+        return value
+            .split(",")
+            .map((tag) => tag.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+function getReadingMinutes(text) {
+    return Math.max(1, Math.ceil(text.length / 400));
+}
+function Callout(props) {
+    const tone = asText(props.tone) ?? "note";
+    return h("aside", { className: `mdx-callout mdx-callout-${tone}` }, props.children);
+}
+const MDX_COMPONENTS = {
+    Callout,
+};
+async function renderMdx(source) {
+    const compiled = await compile({ value: source }, {
+        outputFormat: "function-body",
+        remarkPlugins: [remarkGfm],
+    });
+    const module = await run(String(compiled), {
+        Fragment,
+        jsx: h,
+        jsxs: h,
+    });
+    const component = module.default;
+    return renderToHtml(component({ components: MDX_COMPONENTS }));
+}
+async function renderSource(source, sourcePath) {
+    if (sourcePath.endsWith(".md")) {
+        return Bun.markdown.html(source, {
+            tagFilter: true,
+        });
+    }
+    return renderMdx(source);
+}
+async function collectFiles(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        const entryPath = resolve(directory, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await collectFiles(entryPath)));
+            continue;
+        }
+        if (CONTENT_EXTENSIONS.has(entry.name.slice(entry.name.lastIndexOf(".")))) {
+            files.push(entryPath);
+        }
+    }
+    return files.sort((left, right) => left.localeCompare(right));
+}
+function isDraft(sourcePath, sectionDirectory, kind) {
+    if (kind !== "post")
+        return false;
+    const contentPath = relative(sectionDirectory, sourcePath);
+    return contentPath.split(sep).some((part) => part.startsWith("_"));
+}
+function makeSlug(sourcePath, sectionDirectory) {
+    const contentPath = relative(sectionDirectory, sourcePath);
+    return contentPath
+        .replace(/\.(md|mdx)$/i, "")
+        .split(sep)
+        .join("/");
+}
+function normalizeSlugPrefix(prefix) {
+    return (prefix ?? "")
+        .replaceAll("\\", "/")
+        .replace(/^\/+|\/+$/g, "")
+        .replaceAll(/\/+/g, "/");
+}
+function withSlugPrefix(prefix, slug) {
+    const normalizedPrefix = normalizeSlugPrefix(prefix);
+    return normalizedPrefix ? `${normalizedPrefix}/${slug}` : slug;
+}
+export function normalizeContentSources(input) {
+    const sources = Array.isArray(input) ? input : [input];
+    return sources.map((source) => {
+        const normalized = typeof source === "string" ? { directory: source } : source;
+        return {
+            directory: resolve(normalized.directory),
+            slugPrefix: normalizeSlugPrefix(normalized.slugPrefix) || undefined,
+        };
+    });
+}
+function duplicateContentError(kind, slug) {
+    return new Error(`Duplicate ${kind} slug "${slug}" while merging content sources.`);
+}
+async function loadSectionFromSource(source, kind) {
+    const sectionDirectory = resolve(source.directory, `${kind}s`);
+    let sourceFiles;
+    try {
+        sourceFiles = await collectFiles(sectionDirectory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const items = [];
+    for (const sourcePath of sourceFiles) {
+        if (isDraft(sourcePath, sectionDirectory, kind))
+            continue;
+        const sourceText = await readFile(sourcePath, "utf8");
+        const document = parseFrontmatter(sourceText);
+        const slug = withSlugPrefix(source.slugPrefix, makeSlug(sourcePath, sectionDirectory));
+        const dateValue = metadataValue(document.metadata, [
+            "published_at",
+            "publishedAt",
+            "date",
+            "created_at",
+            "createdAt",
+            "updated_at",
+            "updatedAt",
+        ]);
+        const date = parseDate(dateValue) ?? (await stat(sourcePath)).mtime;
+        const bodyWithoutLeadingHeading = document.body.replace(/^\s*#\s+.+?(?:\r?\n|$)+/, "");
+        const plainText = stripMarkdown(bodyWithoutLeadingHeading);
+        const title = asText(document.metadata.title) ?? titleFromBody(document.body, slug);
+        const html = withoutLeadingHeading(await renderSource(document.body, sourcePath));
+        items.push({
+            kind,
+            slug,
+            sourcePath,
+            title,
+            excerpt: plainText.slice(0, 180),
+            body: document.body,
+            html,
+            metadata: document.metadata,
+            date,
+            dateKey: makeDateKey(dateValue, date),
+            timeLabel: makeTimeLabel(dateValue, date),
+            tags: getTags(document.metadata),
+            readingMinutes: getReadingMinutes(plainText),
+            characterCount: plainText.length,
+        });
+    }
+    return items;
+}
+export async function loadSection(sources, kind, options = {}) {
+    const merged = new Map();
+    const duplicatePolicy = options.duplicate ?? "first-wins";
+    for (const source of normalizeContentSources(sources)) {
+        const items = await loadSectionFromSource(source, kind);
+        for (const item of items) {
+            if (merged.has(item.slug)) {
+                if (duplicatePolicy === "error")
+                    throw duplicateContentError(kind, item.slug);
+                continue;
+            }
+            merged.set(item.slug, item);
+        }
+    }
+    return [...merged.values()].sort((left, right) => {
+        return (right.date?.getTime() ?? 0) - (left.date?.getTime() ?? 0);
+    });
+}
+export function withoutLeadingHeading(html) {
+    return html.replace(/^\s*<h1>.*?<\/h1>\s*/s, "");
+}
+export async function collectAssetFiles(directory) {
+    try {
+        return await collectFilesForAssets(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+async function collectFilesForAssets(directory) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        const entryPath = resolve(directory, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await collectFilesForAssets(entryPath)));
+        }
+        else {
+            files.push(entryPath);
+        }
+    }
+    return files.sort((left, right) => left.localeCompare(right));
+}
+export async function collectContentAssets(sources, options = {}) {
+    const directory = options.directory ?? "assets";
+    const duplicatePolicy = options.duplicate ?? "first-wins";
+    const assets = new Map();
+    for (const source of normalizeContentSources(sources)) {
+        const assetRoot = resolve(source.directory, directory);
+        const sourceFiles = await collectAssetFiles(assetRoot);
+        for (const sourcePath of sourceFiles) {
+            const localPath = relative(assetRoot, sourcePath).split(sep).join("/");
+            const relativePath = withSlugPrefix(source.slugPrefix, localPath);
+            if (assets.has(relativePath)) {
+                if (duplicatePolicy === "error") {
+                    throw new Error(`Duplicate asset path "${relativePath}" while merging content sources.`);
+                }
+                continue;
+            }
+            assets.set(relativePath, { sourcePath, assetRoot, relativePath });
+        }
+    }
+    return [...assets.values()];
+}
+export function isDraftAsset(assetPath, assetRoot) {
+    return relative(assetRoot, assetPath)
+        .split(sep)
+        .some((part) => part.startsWith("_"));
+}

package/dist/src/identity.d.ts

@@ -0,0 +1,38 @@
+/** A profile link shown on the About page (e.g. a GitHub account). */
+export interface SiteProfileLink {
+    /** Service label, e.g. `GitHub`. */
+    label: string;
+    /** Visible handle, e.g. `@name`. */
+    handle: string;
+    href: string;
+}
+export interface SiteAbout {
+    /** Page heading. */
+    heading: string;
+    paragraphs: readonly string[];
+    /** Heading above the profile links. */
+    linksHeading?: string;
+    links?: readonly SiteProfileLink[];
+}
+/** Site-owned identity and copy. The application supplies it; the library keeps neutral defaults. */
+export interface SiteIdentity {
+    /** Display name used in header, footer and document titles. */
+    name: string;
+    /** Stable `data-site` value. */
+    id: string;
+    description: string;
+    /** `npx skills add <package>` source for public Skills; when absent the source path is shown. */
+    skillsPackage?: string;
+    /** Repository tree URL that Skill source paths resolve against; when absent no source link is shown. */
+    repositorySourceUrl?: string;
+    /** Content directory described in the agent-facing index, e.g. `apps/blog/content`. */
+    contentDirectory: string;
+    /** Optional artwork paths relative to the content assets root, e.g. `images/cover.png`. */
+    images?: {
+        hero?: string;
+        feed?: string;
+        about?: string;
+    };
+    about?: SiteAbout;
+}
+export declare const DEFAULT_SITE: SiteIdentity;

package/dist/src/identity.js

@@ -0,0 +1,6 @@
+export const DEFAULT_SITE = {
+    name: "Meowpress site",
+    id: "meowpress",
+    description: "长文与碎片想法的混排时间线。",
+    contentDirectory: "content",
+};

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export { collectContentAssets, collectAssetFiles, isDraftAsset, loadSection, normalizeContentSources, type ContentItem, type ContentAsset, type ContentKind, type ContentSource, type ContentSourceInput, type DuplicateContentPolicy, type LoadSectionOptions, } from "./content.js";
+export { buildSite, meowSite, type ResolvedSiteConfig, type SiteConfig } from "./build.js";
+export { aboutPage, agentMarkdown, homePage, listPage, llmText, postPage, skillPage, skillsIndexPage, thoughtPage, } from "./site.js";
+export { DEFAULT_SITE, type SiteAbout, type SiteIdentity, type SiteProfileLink } from "./identity.js";
+export { blogTheme, blogTokens, blogOptions } from "./theme.js";
+export { loadSkills, type LoadSkillsOptions, type Skill, type SkillFile, type SkillScope, } from "./skills.js";

package/dist/src/index.js

@@ -0,0 +1,6 @@
+export { collectContentAssets, collectAssetFiles, isDraftAsset, loadSection, normalizeContentSources, } from "./content.js";
+export { buildSite, meowSite } from "./build.js";
+export { aboutPage, agentMarkdown, homePage, listPage, llmText, postPage, skillPage, skillsIndexPage, thoughtPage, } from "./site.js";
+export { DEFAULT_SITE } from "./identity.js";
+export { blogTheme, blogTokens, blogOptions } from "./theme.js";
+export { loadSkills, } from "./skills.js";