meowpress 0.1.1-alpha.1 → 0.2.0-alpha.0

package/README.md

@@ -3,7 +3,7 @@
 `meowpress` provides content reading, page rendering, themes and the build pipeline for static sites.
 Consumers own the site configuration and content and build through this package; the package does not own the application's posts or output directory.
 
-`0.1.1-alpha.0` has been published and accepted from the registry. The current `0.1.1-alpha.1` candidate updates the English site and CLI defaults and is not yet published. CSS and JSX are both required peers, allowing `^0.1.0 || ^0.1.1-alpha.0`, keeping the stable compatibility range and accepting this round's JSX/CSS alphas. The host selects the shared CSS/JSX modules, and this package does not privately install another CSS copy; it does not depend on Meowtail or MeowSlides. Actual out-of-package builds and theme identity acceptance are bound to exact tgz files, and peer contracts are not bypassed through overrides. Publishing still requires separate explicit authorization.
+Published history: `0.1.1-alpha.0` was accepted from the registry, followed by `0.1.1-alpha.1` with the English site and CLI defaults; `latest` remained `0.1.0`. The current workspace package is `0.2.0-alpha.0`, and its required CSS and JSX peer ranges accept `^0.2.0-alpha.0`. The host selects the shared CSS/JSX modules, and this package does not privately install another CSS copy; it does not depend on Meowtail or MeowSlides. Out-of-package builds and theme identity acceptance are bound to exact package archives, and peer contracts are not bypassed through overrides. Publishing requires separate explicit authorization.
 
 This package is a standalone content publishing library with source in `packages/meowpress`; it already has a public build entry, independent tests and typechecking,
 and does not depend on Assistant, WorkCell, Deno or the content and runtime state of a specific Blog. Style generation comes from `meowcss`,
@@ -25,6 +25,37 @@ export default meowSite({
 });
 ```
 
+## Pages a consumer owns
+
+A consumer that supplies `pages` owns the whole site map. The provider receives the content that was
+already loaded and returns complete documents; the package writes them at their paths, adds them to
+the agent-facing indexes, and does not publish its own blog routes next to them. One site map, one
+owner.
+
+```ts
+import { meowSite, type SitePage } from "meowpress/build";
+
+export default meowSite({
+  content: [{ directory: "/path/to/content" }],
+  outputDirectory: "/path/to/dist",
+  themeStylesheet: "site-theme.css",
+  pages: ({ posts, theme }): SitePage[] =>
+    posts.map((post) => ({
+      path: post.slug,
+      title: post.title,
+      html: renderDocument(post, theme),
+    })),
+});
+```
+
+- `pages` is a provider of complete HTML documents. A path that resolves above the site root is
+  refused rather than clamped.
+- `mdxComponents` adds named components to the MDX content pages; the built-in `Callout` stays
+  available.
+- `themeStylesheet` names the theme stylesheet the build writes, so a consumer page can link it. It
+  applies to the built-in pages as well, so a renamed stylesheet never leaves a page linking a file
+  that was not written.
+
 Directories in the configuration are provided explicitly by the application; the default theme resolves from this package and does not depend on the startup directory.
 The whole theme can be replaced with `theme: defineTheme(...)`; all static pages output that theme's root attributes and default options.
 The build writes `theme.cssText` to a temporary CSS file, then lets Bun handle fonts and other assets, and finally delivers through a stylesheet link,

package/dist/src/build.d.ts

@@ -1,6 +1,10 @@
 import { type ThemeDefinition } from "meowcss";
 import { type SiteIdentity } from "./identity.js";
-import { type ContentSourceInput } from "./content.js";
+import { type ContentSourceInput, type MdxComponent } from "./content.js";
+import { type SitePageProvider } from "./pages.js";
+export type { SitePage, SitePageContext, SitePageProvider } from "./pages.js";
+export type { ContentItem } from "./content.js";
+export type { SiteIdentity } from "./identity.js";
 export interface SiteConfig {
     /** One or more roots containing `posts/`, `thoughts/`, and optional assets. */
     content: ContentSourceInput | readonly ContentSourceInput[];
@@ -14,6 +18,12 @@ export interface SiteConfig {
     projectRootDirectory?: string;
     /** Site name, description, repository links and About copy; unset fields use neutral defaults. */
     site?: Partial<SiteIdentity>;
+    /** Consumer-supplied pages; the site writes and indexes them next to its own. */
+    pages?: SitePageProvider;
+    /** Extra components available to MDX content pages. */
+    mdxComponents?: Record<string, MdxComponent>;
+    /** Stylesheet file name for the theme; defaults to "blog-theme.css". */
+    themeStylesheet?: string;
 }
 export interface ResolvedSiteConfig {
     content: readonly ContentSourceInput[];
@@ -22,6 +32,9 @@ export interface ResolvedSiteConfig {
     theme: ThemeDefinition;
     projectRootDirectory?: string;
     site: SiteIdentity;
+    pages?: SitePageProvider;
+    mdxComponents: Record<string, MdxComponent>;
+    themeStylesheet: string;
 }
 /** Define a site config in the app package without taking on the build pipeline. */
 export declare function meowSite(config: SiteConfig): ResolvedSiteConfig;

package/dist/src/build.js

@@ -1,11 +1,12 @@
 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 { isAbsolute, join, relative, 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 { aboutPage, agentMarkdown, DEFAULT_THEME_STYLESHEET, homePage, listPage, llmText, postPage, skillPage, skillsIndexPage, thoughtPage, } from "./site.js";
 import { loadSkills } from "./skills.js";
+import { sitePageFile } from "./pages.js";
 /** Define a site config in the app package without taking on the build pipeline. */
 export function meowSite(config) {
     return {
@@ -17,6 +18,9 @@ export function meowSite(config) {
             ? resolve(config.projectRootDirectory)
             : undefined,
         site: { ...DEFAULT_SITE, ...config.site },
+        pages: config.pages,
+        mdxComponents: config.mdxComponents ?? {},
+        themeStylesheet: config.themeStylesheet ?? DEFAULT_THEME_STYLESHEET,
     };
 }
 async function writePage(generatedDirectory, pathname, html) {
@@ -58,13 +62,30 @@ async function buildStaticHtmlFromEntrypoints(entrypoints, generatedDirectory, o
         throw new Error("Unable to build site static HTML");
     }
 }
-async function writeContentPages(generatedDirectory, posts, thoughts, theme, site) {
+/** Consumer pages are written inside the generated directory and never above it. */
+function consumerPageFile(generatedDirectory, path) {
+    const file = sitePageFile(path);
+    const target = resolve(generatedDirectory, file);
+    const inside = relative(generatedDirectory, target);
+    if (!inside || inside.startsWith("..") || isAbsolute(inside)) {
+        throw new Error(`Site page path stays inside the site root: ${path}`);
+    }
+    return file;
+}
+async function writeConsumerPages(generatedDirectory, pages) {
+    const entrypoints = [];
+    for (const page of pages) {
+        entrypoints.push(await writePage(generatedDirectory, consumerPageFile(generatedDirectory, page.path), page.html));
+    }
+    return entrypoints;
+}
+async function writeContentPages(generatedDirectory, posts, thoughts, theme, site, stylesheet) {
     const entrypoints = [];
     for (const post of posts) {
-        entrypoints.push(await writePage(generatedDirectory, `posts/${post.slug}/index.html`, postPage(post, posts, thoughts, theme, site)));
+        entrypoints.push(await writePage(generatedDirectory, `posts/${post.slug}/index.html`, postPage(post, posts, thoughts, theme, site, stylesheet)));
     }
     for (const thought of thoughts) {
-        entrypoints.push(await writePage(generatedDirectory, `thoughts/${thought.slug}/index.html`, thoughtPage(thought, theme, site)));
+        entrypoints.push(await writePage(generatedDirectory, `thoughts/${thought.slug}/index.html`, thoughtPage(thought, theme, site, stylesheet)));
     }
     return entrypoints;
 }
@@ -72,30 +93,47 @@ 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,
-        }),
+        loadSection(config.content, "post", { components: config.mdxComponents }),
+        loadSection(config.content, "thought", { components: config.mdxComponents }),
+        config.pages
+            ? Promise.resolve([])
+            : 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)));
+    // A consumer that supplies its own pages owns the whole site map; the package's
+    // own blog routes are not published alongside them.
+    const pages = config.pages
+        ? await config.pages({
+            posts,
+            thoughts,
+            site: config.site,
+            theme: config.theme,
+        })
+        : undefined;
+    const entrypoints = [];
+    if (pages) {
+        entrypoints.push(...(await writeConsumerPages(generatedDirectory, pages)));
+    }
+    else {
+        entrypoints.push(...(await Promise.all([
+            writePage(generatedDirectory, "index.html", homePage(timeline, config.theme, config.site, config.themeStylesheet)),
+            writePage(generatedDirectory, "about/index.html", aboutPage(config.theme, config.site, config.themeStylesheet)),
+            writePage(generatedDirectory, "posts/index.html", listPage("post", posts, config.theme, config.site, config.themeStylesheet)),
+            writePage(generatedDirectory, "thoughts/index.html", listPage("thought", thoughts, config.theme, config.site, config.themeStylesheet)),
+            writePage(generatedDirectory, "skills/index.html", skillsIndexPage(skills, config.theme, config.site, config.themeStylesheet)),
+        ])), ...(await writeContentPages(generatedDirectory, posts, thoughts, config.theme, config.site, config.themeStylesheet)));
+        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, config.themeStylesheet)));
+        }
     }
-    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 writeFile(join(generatedDirectory, config.themeStylesheet), 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"')) {
@@ -105,10 +143,12 @@ export async function buildSite(input) {
     }
     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"),
+        writeFile(join(config.outputDirectory, "llm.txt"), llmText(posts, thoughts, config.site, pages), "utf8"),
+        writeFile(join(config.outputDirectory, "llms.txt"), llmText(posts, thoughts, config.site, pages), "utf8"),
+        writeFile(join(config.outputDirectory, "agents.md"), agentMarkdown(posts, thoughts, config.site, pages), "utf8"),
     ]);
     await rm(generatedDirectory, { recursive: true, force: true });
-    console.log(`Built ${posts.length} posts and ${thoughts.length} thoughts into site dist/.`);
+    console.log(pages
+        ? `Built ${posts.length} content items and ${pages.length} site pages into site dist/.`
+        : `Built ${posts.length} posts and ${thoughts.length} thoughts into site dist/.`);
 }

package/dist/src/content.d.ts

@@ -1,3 +1,4 @@
+import { type Child, type Props } from "meowjsx/runtime";
 export type ContentKind = "post" | "thought";
 export type Frontmatter = Record<string, unknown>;
 /** A content root containing `posts/`, `thoughts/`, and optional asset folders. */
@@ -11,7 +12,11 @@ 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;
+    /** Extra components available to MDX content pages. */
+    components?: Record<string, MdxComponent>;
 }
+/** A component an MDX content page may use by name. */
+export type MdxComponent = (props: Props) => Child;
 export interface ContentItem {
     kind: ContentKind;
     slug: string;

package/dist/src/content.js

@@ -112,7 +112,7 @@ function Callout(props) {
 const MDX_COMPONENTS = {
     Callout,
 };
-async function renderMdx(source) {
+async function renderMdx(source, components) {
     const compiled = await compile({ value: source }, {
         outputFormat: "function-body",
         remarkPlugins: [remarkGfm],
@@ -123,15 +123,15 @@ async function renderMdx(source) {
         jsxs: h,
     });
     const component = module.default;
-    return renderToHtml(component({ components: MDX_COMPONENTS }));
+    return renderToHtml(component({ components: { ...MDX_COMPONENTS, ...components } }));
 }
-async function renderSource(source, sourcePath) {
+async function renderSource(source, sourcePath, components) {
     if (sourcePath.endsWith(".md")) {
         return Bun.markdown.html(source, {
             tagFilter: true,
         });
     }
-    return renderMdx(source);
+    return renderMdx(source, components);
 }
 async function collectFiles(directory) {
     const entries = await readdir(directory, { withFileTypes: true });
@@ -186,7 +186,7 @@ export function normalizeContentSources(input) {
 function duplicateContentError(kind, slug) {
     return new Error(`Duplicate ${kind} slug "${slug}" while merging content sources.`);
 }
-async function loadSectionFromSource(source, kind) {
+async function loadSectionFromSource(source, kind, options) {
     const sectionDirectory = resolve(source.directory, `${kind}s`);
     let sourceFiles;
     try {
@@ -217,7 +217,7 @@ async function loadSectionFromSource(source, kind) {
         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));
+        const html = withoutLeadingHeading(await renderSource(document.body, sourcePath, options.components ?? {}));
         items.push({
             kind,
             slug,
@@ -241,7 +241,7 @@ 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);
+        const items = await loadSectionFromSource(source, kind, options);
         for (const item of items) {
             if (merged.has(item.slug)) {
                 if (duplicatePolicy === "error")

package/dist/src/pages.d.ts

@@ -0,0 +1,28 @@
+import type { ThemeDefinition } from "meowcss";
+import type { ContentItem } from "./content.js";
+import type { SiteIdentity } from "./identity.js";
+/** A page supplied by the consumer of the site. */
+export interface SitePage {
+    /** Route path below the site root; "packages/meowtail" becomes /packages/meowtail/. */
+    path: string;
+    title: string;
+    /** A complete HTML document for the route. */
+    html: string;
+    description?: string;
+    /** Grouping used by the site index and the agent-facing indexes. */
+    group?: string;
+    order?: number;
+}
+/** What a page provider receives when the site is built. */
+export interface SitePageContext {
+    posts: readonly ContentItem[];
+    thoughts: readonly ContentItem[];
+    site: SiteIdentity;
+    theme: ThemeDefinition;
+}
+/** Supplies the consumer's own pages for the site. */
+export type SitePageProvider = (context: SitePageContext) => readonly SitePage[] | Promise<readonly SitePage[]>;
+/** The route a page is published under, with a leading and a trailing slash. */
+export declare function sitePageUrl(path: string): string;
+/** The output file a page is written to, relative to the site root. */
+export declare function sitePageFile(path: string): string;

package/dist/src/pages.js

@@ -0,0 +1,10 @@
+/** The route a page is published under, with a leading and a trailing slash. */
+export function sitePageUrl(path) {
+    const normalized = path.replace(/^\/+|\/+$/g, "");
+    return normalized ? `/${normalized}/` : "/";
+}
+/** The output file a page is written to, relative to the site root. */
+export function sitePageFile(path) {
+    const normalized = path.replace(/^\/+|\/+$/g, "");
+    return normalized ? `${normalized}/index.html` : "index.html";
+}

package/dist/src/site.d.ts

@@ -1,13 +1,16 @@
 import { type ThemeDefinition } from "meowcss";
 import { type ContentItem } from "./content.js";
 import { type SiteIdentity } from "./identity.js";
+import { type SitePage } from "./pages.js";
 import type { Skill } from "./skills.js";
-export declare function homePage(items: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function listPage(kind: "post" | "thought", items: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function postPage(item: ContentItem, posts: ContentItem[], thoughts: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function thoughtPage(item: ContentItem, theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function aboutPage(theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function skillsIndexPage(skills: Skill[], theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function skillPage(skill: Skill, theme?: ThemeDefinition, site?: SiteIdentity): string;
-export declare function agentMarkdown(posts: ContentItem[], thoughts: ContentItem[], site?: SiteIdentity): string;
-export declare function llmText(posts: ContentItem[], thoughts: ContentItem[], site?: SiteIdentity): string;
+/** The name of the theme stylesheet the package writes by default. */
+export declare const DEFAULT_THEME_STYLESHEET = "blog-theme.css";
+export declare function homePage(items: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function listPage(kind: "post" | "thought", items: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function postPage(item: ContentItem, posts: ContentItem[], thoughts: ContentItem[], theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function thoughtPage(item: ContentItem, theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function aboutPage(theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function skillsIndexPage(skills: Skill[], theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function skillPage(skill: Skill, theme?: ThemeDefinition, site?: SiteIdentity, stylesheet?: string): string;
+export declare function agentMarkdown(posts: ContentItem[], thoughts: ContentItem[], site?: SiteIdentity, pages?: readonly SitePage[]): string;
+export declare function llmText(posts: ContentItem[], thoughts: ContentItem[], site?: SiteIdentity, pages?: readonly SitePage[]): string;

package/dist/src/site.js

@@ -4,7 +4,18 @@ import { Fragment, h } from "meowjsx/runtime";
 import { renderToHtml } from "meowjsx/web";
 import { withoutLeadingHeading } from "./content.js";
 import { DEFAULT_SITE } from "./identity.js";
+import { sitePageUrl } from "./pages.js";
 import { layoutSkillGraph } from "./skill-graph.js";
+/** The name of the theme stylesheet the package writes by default. */
+export const DEFAULT_THEME_STYLESHEET = "blog-theme.css";
+/** The href of the theme stylesheet for a page at a given depth. */
+function styleHref(depth, stylesheet) {
+    return `${"../".repeat(depth)}${stylesheet}`;
+}
+/** The number of directories a slug puts a page below its section. */
+function slugDepth(slug) {
+    return slug.split("/").filter(Boolean).length;
+}
 function SiteHeader({ activePath, site }) {
     return (h("header", { className: "site" },
         h("a", { className: "site-name", href: "/" }, site.name),
@@ -240,12 +251,12 @@ const FILTER_SCRIPT = `(() => {
     }
   }));
 })();`;
-export function homePage(items, theme = blogTheme, site = DEFAULT_SITE) {
+export function homePage(items, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     return pageHtml({
         site,
         theme,
         title: site.name,
-        styleHref: "./blog-theme.css",
+        styleHref: styleHref(0, stylesheet),
         children: (h(Fragment, null,
             h(Hero, { image: site.images?.hero ? `./${site.images.hero}` : undefined }),
             h(Filter, { posts: items.filter((item) => item.kind === "post").length, thoughts: items.filter((item) => item.kind === "thought").length }),
@@ -253,14 +264,14 @@ export function homePage(items, theme = blogTheme, site = DEFAULT_SITE) {
             h("script", { dangerouslySetInnerHTML: { __html: FILTER_SCRIPT } }))),
     });
 }
-export function listPage(kind, items, theme = blogTheme, site = DEFAULT_SITE) {
+export function listPage(kind, items, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     const isPost = kind === "post";
     return pageHtml({
         site,
         theme,
         title: isPost ? "Posts" : "Thoughts",
         activePath: isPost ? "/posts/" : "/thoughts/",
-        styleHref: "../blog-theme.css",
+        styleHref: styleHref(1, stylesheet),
         children: (h("main", { className: "listing" },
             h("header", { className: "listing-head" },
                 h("span", { className: "kind" }, isPost ? "Posts" : "Thoughts"),
@@ -293,7 +304,7 @@ function RelatedThoughts({ item, thoughts, }) {
         h("h2", null, "Thoughts from the same day"),
         related.map((thought) => (h(ThoughtCard, { item: thought, linked: true })))));
 }
-export function postPage(item, posts, thoughts, theme = blogTheme, site = DEFAULT_SITE) {
+export function postPage(item, posts, thoughts, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     const category = typeof item.metadata.category === "string" ? item.metadata.category : "Post";
     return pageHtml({
         site,
@@ -301,7 +312,7 @@ export function postPage(item, posts, thoughts, theme = blogTheme, site = DEFAUL
         title: item.title,
         description: item.excerpt,
         activePath: "/posts/",
-        styleHref: "../../blog-theme.css",
+        styleHref: styleHref(1 + slugDepth(item.slug), stylesheet),
         children: (h("main", null,
             h("article", null,
                 h("header", { className: "post-head" },
@@ -319,14 +330,14 @@ export function postPage(item, posts, thoughts, theme = blogTheme, site = DEFAUL
                 h(PostNavigation, { item: item, posts: posts })))),
     });
 }
-export function thoughtPage(item, theme = blogTheme, site = DEFAULT_SITE) {
+export function thoughtPage(item, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     return pageHtml({
         site,
         theme,
         title: item.title,
         description: item.excerpt,
         activePath: "/thoughts/",
-        styleHref: "../../blog-theme.css",
+        styleHref: styleHref(1 + slugDepth(item.slug), stylesheet),
         children: (h("main", null,
             h("article", null,
                 h("header", { className: "post-head" },
@@ -338,14 +349,14 @@ export function thoughtPage(item, theme = blogTheme, site = DEFAULT_SITE) {
                 h("div", { className: "prose", dangerouslySetInnerHTML: { __html: item.html } })))),
     });
 }
-export function aboutPage(theme = blogTheme, site = DEFAULT_SITE) {
+export function aboutPage(theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     const about = site.about;
     return pageHtml({
         site,
         theme,
         title: "About",
         activePath: "/about/",
-        styleHref: "../blog-theme.css",
+        styleHref: styleHref(1, stylesheet),
         children: (h("main", { className: "about" },
             h("div", { className: "avatar", "aria-hidden": "true" }, site.images?.about ? (h("img", { src: `../${site.images.about}`, alt: "", decoding: "async" })) : (h("span", { className: "avatar-initial" }, Array.from(site.name.trim())[0] ?? "M"))),
             about ? (h(Fragment, null,
@@ -594,7 +605,7 @@ const SKILL_BROWSER_SCRIPT = `(() => {
     });
   });
 })();`;
-export function skillsIndexPage(skills, theme = blogTheme, site = DEFAULT_SITE) {
+export function skillsIndexPage(skills, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     const publicSkills = skills.filter((skill) => skill.scope === "public");
     const projectSkills = skills.filter((skill) => skill.scope === "project");
     return pageHtml({
@@ -603,7 +614,7 @@ export function skillsIndexPage(skills, theme = blogTheme, site = DEFAULT_SITE)
         title: "Skills",
         description: "Methods and working conventions that can be handed to an Agent.",
         activePath: "/skills/",
-        styleHref: "../blog-theme.css",
+        styleHref: styleHref(1, stylesheet),
         children: (h("main", { className: "skills-index" },
             h("header", { className: "skills-head" },
                 h("span", { className: "skill-path" }, "~/skills"),
@@ -624,7 +635,7 @@ export function skillsIndexPage(skills, theme = blogTheme, site = DEFAULT_SITE)
             h("p", { className: "skills-prototype-note" }, "The reference graph starts from SKILL.md and is generated at build time from Markdown links."))),
     });
 }
-export function skillPage(skill, theme = blogTheme, site = DEFAULT_SITE) {
+export function skillPage(skill, theme = blogTheme, site = DEFAULT_SITE, stylesheet = DEFAULT_THEME_STYLESHEET) {
     const firstFile = skill.files[0];
     const command = skill.scope === "public" ? skillInstallCommand(site, skill) : skill.sourceBasePath;
     return pageHtml({
@@ -633,7 +644,9 @@ export function skillPage(skill, theme = blogTheme, site = DEFAULT_SITE) {
         title: skill.name,
         description: skill.description,
         activePath: "/skills/",
-        styleHref: skill.scope === "public" ? "../../blog-theme.css" : "../../../blog-theme.css",
+        styleHref: skill.scope === "public"
+            ? styleHref(1 + slugDepth(skill.slug), stylesheet)
+            : styleHref(2 + slugDepth(skill.slug), stylesheet),
         children: (h("main", { className: "skill-page" },
             h("a", { className: "skill-back", href: "/skills/" }, "\u2190 All Skills"),
             h("header", { className: "skill-browser-head" },
@@ -660,7 +673,16 @@ export function skillPage(skill, theme = blogTheme, site = DEFAULT_SITE) {
             h("script", { dangerouslySetInnerHTML: { __html: SKILL_BROWSER_SCRIPT } }))),
     });
 }
-export function agentMarkdown(posts, thoughts, site = DEFAULT_SITE) {
+export function agentMarkdown(posts, thoughts, site = DEFAULT_SITE, pages) {
+    const siteMap = pages
+        ? pages.map((page) => `- [${page.title}](${sitePageUrl(page.path)})`)
+        : [
+            "- [Home](/)",
+            "- [Posts](/posts/)",
+            "- [Thoughts](/thoughts/)",
+            "- [Skills](/skills/) (browse files and the auto-generated Markdown reference graph)",
+            "- [About](/about/)",
+        ];
     const lines = [
         `# ${site.name}`,
         "",
@@ -668,11 +690,7 @@ export function agentMarkdown(posts, thoughts, site = DEFAULT_SITE) {
         "",
         "## Site map",
         "",
-        "- [Home](/)",
-        "- [Posts](/posts/)",
-        "- [Thoughts](/thoughts/)",
-        "- [Skills](/skills/) (browse files and the auto-generated Markdown reference graph)",
-        "- [About](/about/)",
+        ...siteMap,
         "",
         "## Content model",
         "",
@@ -681,41 +699,57 @@ export function agentMarkdown(posts, thoughts, site = DEFAULT_SITE) {
         "- Content files support `.md` and `.mdx`, and may start with YAML frontmatter.",
         "- Frontmatter currently has no required fields; `title`, `date`, `created_at`, `category` and `tags` are recognized by the site.",
         "",
-        "## Public content",
-        "",
-        `Public posts: ${posts.length}.`,
-        `Public thoughts: ${thoughts.length}.`,
-        "",
-        "### Posts",
-        "",
-        ...posts.map((post) => `- [${post.title}](${itemUrl(post)}) — ${post.dateKey}`),
-        "",
-        "### Thoughts",
-        "",
-        ...thoughts.map((thought) => `- [${thought.title}](${itemUrl(thought)}) — ${thought.dateKey}`),
-        "",
+        // A consumer that owns the site map owns the routes of its content too.
+        ...(pages
+            ? []
+            : [
+                "## Public content",
+                "",
+                `Public posts: ${posts.length}.`,
+                `Public thoughts: ${thoughts.length}.`,
+                "",
+                "### Posts",
+                "",
+                ...posts.map((post) => `- [${post.title}](${itemUrl(post)}) — ${post.dateKey}`),
+                "",
+                "### Thoughts",
+                "",
+                ...thoughts.map((thought) => `- [${thought.title}](${itemUrl(thought)}) — ${thought.dateKey}`),
+                "",
+            ]),
     ];
     return lines.join("\n");
 }
-export function llmText(posts, thoughts, site = DEFAULT_SITE) {
+export function llmText(posts, thoughts, site = DEFAULT_SITE, pages) {
+    const routes = pages
+        ? pages.map((page) => `- ${page.title}: ${sitePageUrl(page.path)}`)
+        : [
+            "- Home: /",
+            "- Posts: /posts/",
+            "- Thoughts: /thoughts/",
+            "- Skills: /skills/",
+            "- About: /about/",
+        ];
     return [
         `# ${site.name}`,
         `> ${site.description}`,
         "",
         "## Pages",
-        "- Home: /",
-        "- Posts: /posts/",
-        "- Thoughts: /thoughts/",
-        "- Skills: /skills/",
-        "- About: /about/",
+        ...routes,
         "- Agent Markdown: /agents.md",
         "",
-        "## Posts",
-        ...posts.map((post) => `- ${post.title}: ${itemUrl(post)}`),
-        "",
-        "## Thoughts",
-        ...thoughts.map((thought) => `- ${thought.title}: ${itemUrl(thought)}`),
-        "",
+        // A consumer that owns the site map owns the routes of its content too;
+        // listing the content under routes the site does not publish would be wrong.
+        ...(pages
+            ? []
+            : [
+                "## Posts",
+                ...posts.map((post) => `- ${post.title}: ${itemUrl(post)}`),
+                "",
+                "## Thoughts",
+                ...thoughts.map((thought) => `- ${thought.title}: ${itemUrl(thought)}`),
+                "",
+            ]),
         "## Rules",
         "- Only the public build output is considered presentable content.",
         "- Drafts whose names start with _ under posts are not published or rendered.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meowpress",
-  "version": "0.1.1-alpha.1",
+  "version": "0.2.0-alpha.0",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -37,11 +37,11 @@
     "yaml": "^2.9.0"
   },
   "peerDependencies": {
-    "meowcss": "^0.1.0 || ^0.1.1-alpha.0",
-    "meowjsx": "^0.1.0 || ^0.1.1-alpha.0"
+    "meowcss": "^0.2.0-alpha.0",
+    "meowjsx": "^0.2.0-alpha.0"
   },
   "devDependencies": {
-    "meowjsx": "0.1.1-alpha.0",
-    "meowcss": "0.1.1-alpha.0"
+    "meowjsx": "0.2.0-alpha.0",
+    "meowcss": "0.2.0-alpha.0"
   }
 }