mdorigin 0.1.0

package/dist/core/router.js

@@ -0,0 +1,82 @@
+import path from 'node:path';
+import { normalizeContentPath } from './content-store.js';
+export function resolveRequest(pathname) {
+    const normalizedRequestPath = normalizeRequestPath(pathname);
+    if (normalizedRequestPath === null) {
+        return { kind: 'not-found', requestPath: pathname };
+    }
+    if (normalizedRequestPath === '/') {
+        return {
+            kind: 'html',
+            requestPath: normalizedRequestPath,
+            sourcePath: 'index.md',
+        };
+    }
+    if (normalizedRequestPath.endsWith('/')) {
+        const sourcePath = normalizeContentPath(`${normalizedRequestPath.slice(1)}index.md`);
+        return sourcePath === null
+            ? { kind: 'not-found', requestPath: normalizedRequestPath }
+            : {
+                kind: 'html',
+                requestPath: normalizedRequestPath,
+                sourcePath,
+            };
+    }
+    const relativePath = normalizedRequestPath.slice(1);
+    const extension = path.posix.extname(relativePath).toLowerCase();
+    if (extension === '.html') {
+        const sourcePath = normalizeContentPath(`${relativePath.slice(0, -'.html'.length)}.md`);
+        return sourcePath === null
+            ? { kind: 'not-found', requestPath: normalizedRequestPath }
+            : {
+                kind: 'html',
+                requestPath: normalizedRequestPath,
+                sourcePath,
+            };
+    }
+    if (extension === '.md') {
+        const sourcePath = normalizeContentPath(relativePath);
+        return sourcePath === null
+            ? { kind: 'not-found', requestPath: normalizedRequestPath }
+            : {
+                kind: 'markdown',
+                requestPath: normalizedRequestPath,
+                sourcePath,
+            };
+    }
+    if (extension === '') {
+        const sourcePath = normalizeContentPath(`${relativePath}.md`);
+        return sourcePath === null
+            ? { kind: 'not-found', requestPath: normalizedRequestPath }
+            : {
+                kind: 'html',
+                requestPath: normalizedRequestPath,
+                sourcePath,
+            };
+    }
+    const sourcePath = normalizeContentPath(relativePath);
+    return sourcePath === null
+        ? { kind: 'not-found', requestPath: normalizedRequestPath }
+        : {
+            kind: 'asset',
+            requestPath: normalizedRequestPath,
+            sourcePath,
+        };
+}
+function normalizeRequestPath(pathname) {
+    try {
+        const decoded = decodeURIComponent(pathname || '/');
+        const collapsed = decoded.replace(/\/{2,}/g, '/');
+        const absolute = collapsed.startsWith('/') ? collapsed : `/${collapsed}`;
+        const segments = absolute.split('/');
+        if (segments.some((segment) => segment === '..')) {
+            return null;
+        }
+        const normalized = path.posix.normalize(absolute);
+        const hasTrailingSlash = absolute.endsWith('/') && normalized !== '/' && !normalized.endsWith('/');
+        return hasTrailingSlash ? `${normalized}/` : normalized;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/core/site-config.d.ts

@@ -0,0 +1,38 @@
+import type { ContentStore } from './content-store.js';
+import type { TemplateName } from '../html/template-kind.js';
+import type { BuiltInThemeName } from '../html/theme.js';
+export interface SiteNavItem {
+    label: string;
+    href: string;
+}
+export interface SiteConfig {
+    siteTitle?: string;
+    siteDescription?: string;
+    showDate?: boolean;
+    showSummary?: boolean;
+    stylesheet?: string;
+    theme?: BuiltInThemeName;
+    template?: TemplateName;
+    topNav?: SiteNavItem[];
+    showHomeIndex?: boolean;
+}
+export interface ResolvedSiteConfig {
+    siteTitle: string;
+    siteDescription?: string;
+    showDate: boolean;
+    showSummary: boolean;
+    theme: BuiltInThemeName;
+    template: TemplateName;
+    topNav: SiteNavItem[];
+    showHomeIndex: boolean;
+    stylesheetContent?: string;
+    siteTitleConfigured: boolean;
+    siteDescriptionConfigured: boolean;
+}
+export interface LoadSiteConfigOptions {
+    cwd?: string;
+    rootDir?: string;
+    configPath?: string;
+}
+export declare function loadSiteConfig(options?: LoadSiteConfigOptions): Promise<ResolvedSiteConfig>;
+export declare function applySiteConfigFrontmatterDefaults(store: ContentStore, siteConfig: ResolvedSiteConfig): Promise<ResolvedSiteConfig>;

package/dist/core/site-config.js

@@ -0,0 +1,123 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getDirectoryIndexCandidates } from './directory-index.js';
+import { parseMarkdownDocument } from './markdown.js';
+export async function loadSiteConfig(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const rootDir = options.rootDir ? path.resolve(options.rootDir) : null;
+    const configFilePath = options.configPath
+        ? path.resolve(cwd, options.configPath)
+        : await resolveDefaultConfigPath(cwd, rootDir);
+    let parsedConfig = {};
+    try {
+        const configSource = await readFile(configFilePath, 'utf8');
+        parsedConfig = JSON.parse(configSource);
+    }
+    catch (error) {
+        if (!isNodeNotFound(error)) {
+            throw error;
+        }
+    }
+    const stylesheetPath = parsedConfig.stylesheet
+        ? path.resolve(path.dirname(configFilePath), parsedConfig.stylesheet)
+        : null;
+    const stylesheetContent = stylesheetPath
+        ? await readFile(stylesheetPath, 'utf8')
+        : undefined;
+    return {
+        siteTitle: typeof parsedConfig.siteTitle === 'string' && parsedConfig.siteTitle !== ''
+            ? parsedConfig.siteTitle
+            : 'mdorigin',
+        siteDescription: typeof parsedConfig.siteDescription === 'string' &&
+            parsedConfig.siteDescription !== ''
+            ? parsedConfig.siteDescription
+            : undefined,
+        showDate: parsedConfig.showDate ?? true,
+        showSummary: parsedConfig.showSummary ?? true,
+        theme: isBuiltInThemeName(parsedConfig.theme) ? parsedConfig.theme : 'paper',
+        template: isTemplateName(parsedConfig.template) ? parsedConfig.template : 'document',
+        topNav: normalizeTopNav(parsedConfig.topNav),
+        showHomeIndex: typeof parsedConfig.showHomeIndex === 'boolean'
+            ? parsedConfig.showHomeIndex
+            : normalizeTopNav(parsedConfig.topNav).length === 0,
+        stylesheetContent,
+        siteTitleConfigured: typeof parsedConfig.siteTitle === 'string' && parsedConfig.siteTitle !== '',
+        siteDescriptionConfigured: typeof parsedConfig.siteDescription === 'string' &&
+            parsedConfig.siteDescription !== '',
+    };
+}
+export async function applySiteConfigFrontmatterDefaults(store, siteConfig) {
+    if (siteConfig.siteTitleConfigured && siteConfig.siteDescriptionConfigured) {
+        return siteConfig;
+    }
+    for (const candidatePath of getDirectoryIndexCandidates('')) {
+        const entry = await store.get(candidatePath);
+        if (entry === null || entry.kind !== 'text' || entry.text === undefined) {
+            continue;
+        }
+        const parsed = await parseMarkdownDocument(candidatePath, entry.text);
+        return {
+            ...siteConfig,
+            siteTitle: siteConfig.siteTitleConfigured
+                ? siteConfig.siteTitle
+                : typeof parsed.meta.title === 'string' && parsed.meta.title !== ''
+                    ? parsed.meta.title
+                    : siteConfig.siteTitle,
+            siteDescription: siteConfig.siteDescriptionConfigured
+                ? siteConfig.siteDescription
+                : typeof parsed.meta.summary === 'string' && parsed.meta.summary !== ''
+                    ? parsed.meta.summary
+                    : siteConfig.siteDescription,
+        };
+    }
+    return siteConfig;
+}
+async function resolveDefaultConfigPath(cwd, rootDir) {
+    const rootConfigPath = rootDir ? path.join(rootDir, 'mdorigin.config.json') : null;
+    if (rootConfigPath && (await pathExists(rootConfigPath))) {
+        return rootConfigPath;
+    }
+    return path.join(cwd, 'mdorigin.config.json');
+}
+function isBuiltInThemeName(value) {
+    return value === 'paper' || value === 'atlas' || value === 'gazette';
+}
+function isTemplateName(value) {
+    return value === 'document' || value === 'editorial';
+}
+function isNodeNotFound(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+async function pathExists(filePath) {
+    try {
+        await readFile(filePath, 'utf8');
+        return true;
+    }
+    catch (error) {
+        if (isNodeNotFound(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+function normalizeTopNav(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.flatMap((item) => {
+        if (typeof item === 'object' &&
+            item !== null &&
+            'label' in item &&
+            'href' in item &&
+            typeof item.label === 'string' &&
+            item.label !== '' &&
+            typeof item.href === 'string' &&
+            item.href !== '') {
+            return [{ label: item.label, href: item.href }];
+        }
+        return [];
+    });
+}

package/dist/html/template-kind.d.ts

@@ -0,0 +1 @@
+export type TemplateName = 'document' | 'editorial';

package/dist/html/template-kind.js

@@ -0,0 +1 @@
+export {};

package/dist/html/template.d.ts

@@ -0,0 +1,19 @@
+import type { SiteNavItem } from '../core/site-config.js';
+import type { TemplateName } from './template-kind.js';
+import { type BuiltInThemeName } from './theme.js';
+export interface RenderDocumentOptions {
+    siteTitle: string;
+    siteDescription?: string;
+    title: string;
+    body: string;
+    summary?: string;
+    date?: string;
+    showSummary?: boolean;
+    showDate?: boolean;
+    theme: BuiltInThemeName;
+    template: TemplateName;
+    topNav?: SiteNavItem[];
+    stylesheetContent?: string;
+}
+export declare function renderDocument(options: RenderDocumentOptions): string;
+export declare function escapeHtml(value: string): string;

package/dist/html/template.js

@@ -0,0 +1,67 @@
+import { getBuiltInThemeStyles } from './theme.js';
+export function renderDocument(options) {
+    const title = escapeHtml(options.title);
+    const siteTitle = escapeHtml(options.siteTitle);
+    const siteDescription = options.siteDescription
+        ? escapeHtml(options.siteDescription)
+        : undefined;
+    const summaryMeta = options.summary
+        ? `<meta name="description" content="${escapeHtml(options.summary)}">`
+        : '';
+    const stylesheetBlock = `<style>${getBuiltInThemeStyles(options.theme)}${options.stylesheetContent ? `\n${options.stylesheetContent}` : ''}</style>`;
+    const navBlock = options.topNav && options.topNav.length > 0
+        ? `<nav class="site-nav"><ul>${options.topNav
+            .map((item) => `<li><a href="${escapeHtml(item.href)}">${escapeHtml(item.label)}</a></li>`)
+            .join('')}</ul></nav>`
+        : '';
+    const siteDescriptionBlock = siteDescription
+        ? `<span>${siteDescription}</span>`
+        : '';
+    const articleBody = options.template === 'editorial'
+        ? renderEditorialBody(options)
+        : options.body;
+    return [
+        '<!doctype html>',
+        '<html lang="en">',
+        '<head>',
+        '<meta charset="utf-8">',
+        '<meta name="viewport" content="width=device-width, initial-scale=1">',
+        `<title>${title} | ${siteTitle}</title>`,
+        summaryMeta,
+        stylesheetBlock,
+        '</head>',
+        `<body data-theme="${options.theme}" data-template="${options.template}">`,
+        `<header class="site-header"><div class="site-header__inner"><div class="site-header__brand"><p class="site-header__title"><a href="/">${siteTitle}</a></p>${siteDescriptionBlock}</div>${navBlock}</div></header>`,
+        '<main>',
+        `<article>${articleBody}</article>`,
+        '</main>',
+        '</body>',
+        '</html>',
+    ].join('');
+}
+function renderEditorialBody(options) {
+    const heroLines = [
+        '<div class="page-intro">',
+        `<p class="page-intro__eyebrow">${escapeHtml(options.siteTitle)}</p>`,
+        `<h1 class="page-intro__title">${escapeHtml(options.title)}</h1>`,
+    ];
+    if (options.showSummary !== false && options.summary) {
+        heroLines.push(`<p class="page-intro__summary">${escapeHtml(options.summary)}</p>`);
+    }
+    if (options.showDate !== false && options.date) {
+        heroLines.push(`<p class="page-intro__meta">${escapeHtml(options.date)}</p>`);
+    }
+    heroLines.push('</div>');
+    return `${heroLines.join('')}<div class="page-body">${stripLeadingH1(options.body)}</div>`;
+}
+function stripLeadingH1(html) {
+    return html.replace(/^\s*<h1>.*?<\/h1>\s*/s, '');
+}
+export function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}

package/dist/html/theme.d.ts

@@ -0,0 +1,2 @@
+export type BuiltInThemeName = 'paper' | 'atlas' | 'gazette';
+export declare function getBuiltInThemeStyles(theme: BuiltInThemeName): string;