@geekity/cms 0.3.0

package/dist/init.js

@@ -0,0 +1,125 @@
+import { createRequire } from 'node:module';
+import { cp, mkdir, readdir, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * The scaffolding `geekity init` copies, resolved from this module rather than
+ * from the working directory so it is found whether the CLI is running from
+ * `src/` under tsx or from `dist/` inside `node_modules`.
+ */
+export const SITE_TEMPLATE_DIR = fileURLToPath(new URL('../templates/site/', import.meta.url));
+/**
+ * `.gitignore` cannot be shipped under its own name: npm rewrites a
+ * `.gitignore` inside a package to `.npmignore` when it packs it, so the
+ * template carries it as `gitignore` and init renames it back.
+ */
+const DOTFILES = new Map([['gitignore', '.gitignore']]);
+/** Thrown when the target directory already holds something. */
+export class DirectoryNotEmptyError extends Error {
+    directory;
+    name = 'DirectoryNotEmptyError';
+    constructor(directory) {
+        super(`${directory} is not empty. geekity init only writes into a new or empty directory, so it can never overwrite a site you already have.`);
+        this.directory = directory;
+    }
+}
+/**
+ * Create a new site.
+ *
+ * The template is copied as it is; only `package.json` and
+ * `pnpm-workspace.yaml` are generated, because a nested manifest or workspace
+ * file inside `templates/` would be picked up by the workspace and by every
+ * tool that walks for one.
+ */
+export async function initSite(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const directory = path.resolve(cwd, options.directory);
+    if (!(await isEmptyOrMissing(directory)))
+        throw new DirectoryNotEmptyError(directory);
+    await mkdir(directory, { recursive: true });
+    await cp(SITE_TEMPLATE_DIR, directory, { recursive: true });
+    for (const [packed, real] of DOTFILES) {
+        await rename(path.join(directory, packed), path.join(directory, real));
+    }
+    const manifest = siteManifest({
+        name: options.name ?? path.basename(directory),
+        version: options.version ?? ownManifest().version,
+    });
+    await writeFile(path.join(directory, 'package.json'), `${JSON.stringify(manifest, undefined, 2)}\n`, 'utf8');
+    await writeFile(path.join(directory, 'pnpm-workspace.yaml'), pnpmSettings(), 'utf8');
+    return { directory, files: (await readdir(directory)).sort() };
+}
+/**
+ * pnpm settings a new site starts with, as `pnpm-workspace.yaml`.
+ *
+ * pnpm reads its settings from this file even for a single package, and from
+ * version 11 reads nothing else: the `pnpm` field in `package.json` is
+ * ignored. Two things are settled here so a fresh install runs quietly and
+ * unattended. Other package managers ignore the file.
+ */
+export function pnpmSettings() {
+    return [
+        '# pnpm settings for this site. Other package managers ignore this file.',
+        '',
+        '# tsx pulls in esbuild, whose install script pnpm blocks until it is',
+        '# allowed by name.',
+        'allowBuilds:',
+        '  esbuild: true',
+        '',
+        '# nunjucks names chokidar an optional peer and only reaches for it when a',
+        "# FileSystemLoader is built with `watch: true`. The CMS's loader never is.",
+        'peerDependencyRules:',
+        '  allowedVersions:',
+        "    nunjucks>chokidar: '5'",
+        '',
+    ].join('\n');
+}
+/**
+ * The manifest a new site starts life with.
+ *
+ * The three devDependencies are the TypeScript toolchain the template needs:
+ * `tsx` runs `server.ts` and loads a TypeScript config for the bin, and
+ * `typescript` plus `@types/node` are what type checking the site takes. Their
+ * ranges are this package's own, so a site starts on the versions the CMS was
+ * built and tested against rather than on a range frozen in the source.
+ */
+export function siteManifest(options) {
+    const toolchain = ownManifest().devDependencies ?? {};
+    return {
+        name: options.name,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            dev: 'tsx watch server.ts',
+            start: 'tsx server.ts',
+            sync: 'geekity sync',
+        },
+        dependencies: {
+            '@geekity/cms': `^${options.version}`,
+        },
+        devDependencies: {
+            '@types/node': toolchain['@types/node'] ?? '^24.0.0',
+            tsx: toolchain['tsx'] ?? '^4.20.0',
+            typescript: toolchain['typescript'] ?? '^5.9.0',
+        },
+    };
+}
+/** True when the directory does not exist, or exists with nothing in it. */
+async function isEmptyOrMissing(directory) {
+    try {
+        return (await readdir(directory)).length === 0;
+    }
+    catch (error) {
+        const code = error?.code;
+        if (code === 'ENOENT')
+            return true;
+        throw error;
+    }
+}
+/** This package's own manifest, read from beside the module that is running. */
+export function ownManifest() {
+    const require = createRequire(import.meta.url);
+    return require('../package.json');
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/web/assets.d.ts

@@ -0,0 +1,65 @@
+import type { Stats } from 'node:fs';
+/** URL prefix the theme's own files are served under. */
+export declare const THEME_ASSET_PREFIX = "/theme/";
+/**
+ * URL prefix uploads are served under, and the content subdirectory they live
+ * in. They are the same word on purpose: doc's Eleventy config copies
+ * `content/uploads/` through to `/uploads/`, so a Markdown link the editor
+ * writes has to resolve to the same URL whether the site is being served by the
+ * CMS or built by Eleventy.
+ */
+export declare const UPLOAD_ASSET_PREFIX = "/uploads/";
+/** The content subdirectory {@link UPLOAD_ASSET_PREFIX} is served from. */
+export declare const UPLOAD_DIRECTORY = "uploads";
+/** How long a browser may keep an upload. A day: the bytes at a URL never change. */
+export declare const UPLOAD_ASSET_MAX_AGE = 86400;
+/** One file under `content/uploads/`, or `undefined`. */
+export declare function findUpload(relative: string, contentDir: string): StaticAsset | undefined;
+/** Directory inside a theme that holds the files served over HTTP. */
+export declare const THEME_STATIC_DIR = "static";
+/** How long a browser may keep a theme asset. One hour. */
+export declare const THEME_ASSET_MAX_AGE = 3600;
+/** A file on disk, located and described, ready to be served. */
+export interface StaticAsset {
+    /** Absolute path on disk. */
+    file: string;
+    /** Size and modification time, for the validators. */
+    stats: Stats;
+    /** Media type, from the extension. */
+    contentType: string;
+    /** Strong-looking validator over size and mtime. */
+    etag: string;
+}
+/** A theme file. The theme's assets are ordinary {@link StaticAsset}s. */
+export type ThemeAsset = StaticAsset;
+/**
+ * Find one file under a list of roots, first root that has it winning.
+ *
+ * Returns `undefined` when the request escapes its root, names a directory, or
+ * matches nothing. Traversal is checked after resolution rather than by
+ * inspecting the request, so an encoded `..` cannot slip past.
+ */
+export declare function findAsset(relative: string, roots: string[]): StaticAsset | undefined;
+/**
+ * Find one asset, site theme first and packaged theme second, the same order
+ * templates resolve in.
+ */
+export declare function findThemeAsset(relative: string, themeDirs: string[]): ThemeAsset | undefined;
+/** The theme directories to search, in order: the site's, then the package's. */
+export declare function themeSearchPath(siteThemeDir: string): string[];
+/** How long a browser may keep an asset, when the caller does not say. */
+export interface AssetResponseOptions {
+    /** Seconds. Defaults to {@link THEME_ASSET_MAX_AGE}. */
+    maxAge?: number | undefined;
+}
+/** The response body and headers for an asset. */
+export declare function assetResponse(asset: StaticAsset, options?: AssetResponseOptions): Response;
+/** The 304 an unchanged asset gets, which carries the validators and no body. */
+export declare function assetNotModified(asset: StaticAsset, options?: AssetResponseOptions): Response;
+/** {@link assetResponse} at the theme's cache lifetime. */
+export declare function themeAssetResponse(asset: ThemeAsset): Response;
+/** {@link assetNotModified} at the theme's cache lifetime. */
+export declare function themeAssetNotModified(asset: ThemeAsset): Response;
+/** Whether a request's `If-None-Match` covers this asset. */
+export declare function matchesEtag(ifNoneMatch: string | undefined, etag: string): boolean;
+//# sourceMappingURL=assets.d.ts.map

package/dist/web/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/web/assets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAMrC,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAExF;AAED,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,KAAK,CAAC;IACb,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CA6BpF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,SAAS,CAK5F;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9D;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,QAAQ,CAG9F;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,oBAAyB,GAAG,QAAQ,CAKjG;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAE9D;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,CAEjE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlF"}

package/dist/web/assets.js

@@ -0,0 +1,152 @@
+import { createReadStream, statSync } from 'node:fs';
+import path from 'node:path';
+import { Readable } from 'node:stream';
+import { PACKAGED_THEME_DIR } from './templates.js';
+/** URL prefix the theme's own files are served under. */
+export const THEME_ASSET_PREFIX = '/theme/';
+/**
+ * URL prefix uploads are served under, and the content subdirectory they live
+ * in. They are the same word on purpose: doc's Eleventy config copies
+ * `content/uploads/` through to `/uploads/`, so a Markdown link the editor
+ * writes has to resolve to the same URL whether the site is being served by the
+ * CMS or built by Eleventy.
+ */
+export const UPLOAD_ASSET_PREFIX = '/uploads/';
+/** The content subdirectory {@link UPLOAD_ASSET_PREFIX} is served from. */
+export const UPLOAD_DIRECTORY = 'uploads';
+/** How long a browser may keep an upload. A day: the bytes at a URL never change. */
+export const UPLOAD_ASSET_MAX_AGE = 86400;
+/** One file under `content/uploads/`, or `undefined`. */
+export function findUpload(relative, contentDir) {
+    return findAsset(relative, [path.join(contentDir, UPLOAD_DIRECTORY)]);
+}
+/** Directory inside a theme that holds the files served over HTTP. */
+export const THEME_STATIC_DIR = 'static';
+/** How long a browser may keep a theme asset. One hour. */
+export const THEME_ASSET_MAX_AGE = 3600;
+/**
+ * Find one file under a list of roots, first root that has it winning.
+ *
+ * Returns `undefined` when the request escapes its root, names a directory, or
+ * matches nothing. Traversal is checked after resolution rather than by
+ * inspecting the request, so an encoded `..` cannot slip past.
+ */
+export function findAsset(relative, roots) {
+    const normalized = normalizeAssetPath(relative);
+    if (normalized === undefined)
+        return undefined;
+    for (const directory of roots) {
+        const root = path.resolve(directory);
+        const file = path.resolve(root, normalized);
+        // `path.resolve` has already collapsed every `..`; anything that landed
+        // outside the root was trying to get out.
+        if (file !== root && !file.startsWith(root + path.sep))
+            continue;
+        let stats;
+        try {
+            stats = statSync(file);
+        }
+        catch {
+            continue;
+        }
+        if (!stats.isFile())
+            continue;
+        return {
+            file,
+            stats,
+            contentType: contentTypeFor(file),
+            etag: `"${stats.size.toString(16)}-${Math.trunc(stats.mtimeMs).toString(16)}"`,
+        };
+    }
+    return undefined;
+}
+/**
+ * Find one asset, site theme first and packaged theme second, the same order
+ * templates resolve in.
+ */
+export function findThemeAsset(relative, themeDirs) {
+    return findAsset(relative, themeDirs.map((themeDir) => path.join(themeDir, THEME_STATIC_DIR)));
+}
+/** The theme directories to search, in order: the site's, then the package's. */
+export function themeSearchPath(siteThemeDir) {
+    return [siteThemeDir, PACKAGED_THEME_DIR];
+}
+/** The response body and headers for an asset. */
+export function assetResponse(asset, options = {}) {
+    const body = Readable.toWeb(createReadStream(asset.file));
+    return new Response(body, { headers: assetHeaders(asset, options) });
+}
+/** The 304 an unchanged asset gets, which carries the validators and no body. */
+export function assetNotModified(asset, options = {}) {
+    const headers = assetHeaders(asset, options);
+    headers.delete('content-length');
+    headers.delete('content-type');
+    return new Response(null, { status: 304, headers });
+}
+/** {@link assetResponse} at the theme's cache lifetime. */
+export function themeAssetResponse(asset) {
+    return assetResponse(asset);
+}
+/** {@link assetNotModified} at the theme's cache lifetime. */
+export function themeAssetNotModified(asset) {
+    return assetNotModified(asset);
+}
+/** Whether a request's `If-None-Match` covers this asset. */
+export function matchesEtag(ifNoneMatch, etag) {
+    if (ifNoneMatch === undefined)
+        return false;
+    if (ifNoneMatch.trim() === '*')
+        return true;
+    return ifNoneMatch
+        .split(',')
+        .map((candidate) => candidate.trim().replace(/^W\//, ''))
+        .includes(etag);
+}
+function assetHeaders(asset, options) {
+    const maxAge = options.maxAge ?? THEME_ASSET_MAX_AGE;
+    return new Headers({
+        'content-type': asset.contentType,
+        'content-length': String(asset.stats.size),
+        'cache-control': `public, max-age=${String(maxAge)}`,
+        'last-modified': new Date(asset.stats.mtimeMs).toUTCString(),
+        etag: asset.etag,
+    });
+}
+/**
+ * A request path under an asset prefix as a path relative to the directory it
+ * is served from, or `undefined` when it is not one worth looking up.
+ */
+function normalizeAssetPath(relative) {
+    if (relative === '' || relative.endsWith('/'))
+        return undefined;
+    if (relative.includes('\0'))
+        return undefined;
+    // A leading slash would make `path.resolve` ignore the theme directory.
+    return relative.replace(/^\/+/, '');
+}
+/** Media types for what a theme actually ships. */
+const CONTENT_TYPES = new Map([
+    ['.css', 'text/css; charset=utf-8'],
+    ['.js', 'text/javascript; charset=utf-8'],
+    ['.mjs', 'text/javascript; charset=utf-8'],
+    ['.json', 'application/json; charset=utf-8'],
+    ['.map', 'application/json; charset=utf-8'],
+    ['.svg', 'image/svg+xml'],
+    ['.png', 'image/png'],
+    ['.jpg', 'image/jpeg'],
+    ['.jpeg', 'image/jpeg'],
+    ['.gif', 'image/gif'],
+    ['.webp', 'image/webp'],
+    ['.avif', 'image/avif'],
+    ['.ico', 'image/x-icon'],
+    ['.woff', 'font/woff'],
+    ['.woff2', 'font/woff2'],
+    ['.ttf', 'font/ttf'],
+    ['.otf', 'font/otf'],
+    ['.txt', 'text/plain; charset=utf-8'],
+    ['.webmanifest', 'application/manifest+json'],
+]);
+function contentTypeFor(file) {
+    return CONTENT_TYPES.get(path.extname(file).toLowerCase()) ?? 'application/octet-stream';
+}
+//# sourceMappingURL=assets.js.map

package/dist/web/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/web/assets.ts"],"names":[],"mappings":"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"}

package/dist/web/context.d.ts

@@ -0,0 +1,121 @@
+import type { ResolvedConfig } from '../config.ts';
+import type { Document } from '../content/document.ts';
+/** Where the site-wide data file lives, relative to the content directory. */
+export declare const SITE_DATA_FILE = "_data/site.json";
+/** How many posts a listing page holds when the site does not say. */
+export declare const DEFAULT_POSTS_PER_PAGE = 10;
+/**
+ * Site-wide data, from `content/_data/site.json` when the site has one.
+ *
+ * Eleventy exposes the same file as the `site` global, so a layout ported from
+ * an Eleventy build reads `{{ site.title }}` unchanged. Unknown keys are kept,
+ * so a site can put anything in the file and reach it from its templates.
+ */
+export interface SiteData {
+    /** Site title. Defaults to `Geekity`. */
+    title: string;
+    /** One-line description, shown under the title. */
+    tagline?: string | undefined;
+    /** Public origin. Defaults to the configured `baseUrl`. */
+    url: string;
+    /** Site author. */
+    author?: string | undefined;
+    /**
+     * The site's avatar, as the public path it is served at. Empty until one has
+     * been uploaded on the settings screen; the ActivityPub actor's `icon`.
+     */
+    avatar?: string | undefined;
+    /** How many posts a listing page holds. */
+    postsPerPage?: number | undefined;
+    [key: string]: unknown;
+}
+/**
+ * What Eleventy calls `page`: the data about the document being rendered, as
+ * opposed to the document's own front matter.
+ */
+export interface PageContext {
+    /** The document's URL path. Always ends in `/`. */
+    url: string;
+    /** Publish date, absent for a document that has none. */
+    date?: Date | undefined;
+    /** The permalink's last segment, Eleventy's `page.fileSlug`. */
+    fileSlug: string;
+    /** The source file, relative to the content directory, Eleventy-style. */
+    inputPath: string;
+}
+/**
+ * One document as a template sees it.
+ *
+ * The shape mirrors what an Eleventy layout receives: the front matter at the
+ * top level, the rendered body as `content`, and `page` alongside. Two keys
+ * Eleventy puts on a collection item rather than on the page — `url` and
+ * `tags` — are here too, so one shape serves both a rendered page and an entry
+ * in a listing.
+ */
+export interface DocumentContext {
+    /** Display title. */
+    title: string;
+    /** Publish date, absent for a document that has none. */
+    date?: Date | undefined;
+    /** Taxonomy, in the order the file lists it. */
+    tags: string[];
+    /** The Markdown body rendered to HTML. Templates print it with `| safe`. */
+    content: string;
+    /** The document's URL path, the same value as `page.url`. */
+    url: string;
+    /** Eleventy's `page`. */
+    page: PageContext;
+    /** `post` or `page`. */
+    type: string;
+    /** Everything else from the front matter, including unmodelled keys. */
+    [key: string]: unknown;
+}
+/**
+ * A document as a template sees it.
+ *
+ * Front matter goes on first so the keys the CMS models always win: a file
+ * with a stray `content` or `page` key cannot displace the rendered body or
+ * the page data.
+ */
+export declare function documentContext(document: Document): DocumentContext;
+/** Reads `content/_data/site.json`, and re-reads it when the file changes. */
+export interface SiteDataSource {
+    /** The current site data, defaults filled in. */
+    read(): SiteData;
+}
+/**
+ * The settings the admin stores, as site data.
+ *
+ * The admin's settings screen is the source of truth for the values it
+ * manages, and `content/_data/site.json` is the mirror it writes for an
+ * Eleventy build. Handing the source a reader for the settings is what makes a
+ * saved title show on the very next request rather than on the next time the
+ * file's modification time is noticed.
+ */
+export interface SiteSettingsSource {
+    /** The stored settings as site data. Empty when nothing is stored. */
+    read(): Partial<SiteData>;
+}
+/** What {@link createSiteDataSource} reads from besides the config. */
+export interface CreateSiteDataSourceOptions {
+    /** The admin's settings, when the CMS has an admin store to read them from. */
+    settings?: SiteSettingsSource | undefined;
+}
+/**
+ * A source over one site's data.
+ *
+ * The file is read once and then only again when its modification time moves,
+ * so a render costs one `stat` rather than one parse. A file that is missing
+ * or will not parse falls back to the defaults instead of failing the request:
+ * a typo in `site.json` should not take the site down.
+ *
+ * The stored settings, when there are any, go on top of the file. They are the
+ * same values the file was last written from, so the two normally agree; the
+ * overlay is what keeps them agreeing in the moment between a save and the
+ * file's `mtime` being noticed, and the file underneath is what carries the
+ * keys the settings form does not manage.
+ */
+export declare function createSiteDataSource(config: ResolvedConfig, options?: CreateSiteDataSourceOptions): SiteDataSource;
+/** How many posts a listing page holds, from the site data or the default. */
+export declare function postsPerPage(site: SiteData): number;
+//# sourceMappingURL=context.d.ts.map

package/dist/web/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/web/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACxB,gDAAgD;IAChD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe,CA0BnE;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,IAAI,IAAI,QAAQ,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3B;AAED,uEAAuE;AACvE,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,2BAAgC,GACxC,cAAc,CAiChB;AAaD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAMnD"}

package/dist/web/context.js

@@ -0,0 +1,112 @@
+import { readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+/** Where the site-wide data file lives, relative to the content directory. */
+export const SITE_DATA_FILE = '_data/site.json';
+/** How many posts a listing page holds when the site does not say. */
+export const DEFAULT_POSTS_PER_PAGE = 10;
+/**
+ * A document as a template sees it.
+ *
+ * Front matter goes on first so the keys the CMS models always win: a file
+ * with a stray `content` or `page` key cannot displace the rendered body or
+ * the page data.
+ */
+export function documentContext(document) {
+    const date = toDate(document.date);
+    return {
+        ...document.extra,
+        permalink: document.permalink,
+        slug: document.slug,
+        draft: document.draft,
+        ...optional('description', document.description),
+        ...optional('author', document.author),
+        ...optional('updated', toDate(document.updated)),
+        ...optional('activitypub', document.activitypub),
+        title: document.title,
+        ...optional('date', date),
+        tags: document.tags,
+        content: document.html,
+        url: document.permalink,
+        type: document.type,
+        page: {
+            url: document.permalink,
+            ...optional('date', date),
+            fileSlug: document.slug,
+            inputPath: `./${document.path}`,
+        },
+    };
+}
+/**
+ * A source over one site's data.
+ *
+ * The file is read once and then only again when its modification time moves,
+ * so a render costs one `stat` rather than one parse. A file that is missing
+ * or will not parse falls back to the defaults instead of failing the request:
+ * a typo in `site.json` should not take the site down.
+ *
+ * The stored settings, when there are any, go on top of the file. They are the
+ * same values the file was last written from, so the two normally agree; the
+ * overlay is what keeps them agreeing in the moment between a save and the
+ * file's `mtime` being noticed, and the file underneath is what carries the
+ * keys the settings form does not manage.
+ */
+export function createSiteDataSource(config, options = {}) {
+    const file = path.join(config.contentDir, ...SITE_DATA_FILE.split('/'));
+    const settings = options.settings;
+    let cached = {};
+    let cachedAt;
+    function fromFile() {
+        let modifiedAt;
+        try {
+            modifiedAt = statSync(file).mtimeMs;
+        }
+        catch {
+            cachedAt = undefined;
+            cached = {};
+            return cached;
+        }
+        if (modifiedAt === cachedAt)
+            return cached;
+        cachedAt = modifiedAt;
+        cached = readSiteFile(file);
+        return cached;
+    }
+    return {
+        read() {
+            // The defaults are rebuilt per read rather than captured, because
+            // `config.baseUrl` may have been settled from the settings after this
+            // source was made.
+            const defaults = { title: 'Geekity', url: config.baseUrl };
+            return { ...defaults, ...fromFile(), ...settings?.read() };
+        },
+    };
+}
+function readSiteFile(file) {
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** How many posts a listing page holds, from the site data or the default. */
+export function postsPerPage(site) {
+    const configured = site['postsPerPage'];
+    if (typeof configured === 'number' && Number.isInteger(configured) && configured > 0) {
+        return configured;
+    }
+    return DEFAULT_POSTS_PER_PAGE;
+}
+function toDate(value) {
+    if (value === undefined)
+        return undefined;
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? undefined : parsed;
+}
+function optional(key, value) {
+    return value === undefined ? {} : { [key]: value };
+}
+//# sourceMappingURL=context.js.map

package/dist/web/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/web/context.ts"],"names":[],"mappings":"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"}

package/dist/web/documents.d.ts

@@ -0,0 +1,28 @@
+import type { Document } from '../content/document.ts';
+import type { ContentStore } from '../content/store.ts';
+/**
+ * Whether the public site may show a document.
+ *
+ * Two things hide one: `draft: true` in the front matter, and living under
+ * `_trash/`. Both stay indexed so the admin can find them; neither is ever
+ * served, listed, or fed.
+ */
+export declare function isPublicDocument(document: Document): boolean;
+/**
+ * The document a public URL resolves to, or `undefined`.
+ *
+ * This is the single lookup the public site does: every representation of a
+ * document — the theme's HTML, the Markdown file, the JSON object — is the
+ * same document found the same way, so they cannot disagree about what exists.
+ */
+export declare function publicDocumentAt(store: ContentStore, permalink: string): Document | undefined;
+/**
+ * The ActivityStreams id of a document, or `undefined` when it has none.
+ *
+ * Only a published post federates (doc-4), so only a published post has an id
+ * to advertise. This is what the theme's `<link rel="alternate">` points at,
+ * and it is deliberately the same string the object dispatcher answers under:
+ * the page and the object agree about the post's name in the fediverse.
+ */
+export declare function activityStreamsId(document: Document, baseUrl: string): string | undefined;
+//# sourceMappingURL=documents.d.ts.map

package/dist/web/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/web/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAI7F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzF"}