@mvarble/mesearch 0.1.0

package/app/routes/+page.ts

@@ -0,0 +1,18 @@
+import type { Component } from 'svelte';
+import loaders from '$cms/loaders';
+
+const component = async (filename: string | undefined) =>
+    filename && loaders[filename] ? (await loaders[filename]()).default : undefined;
+
+// The site's description, and every document's, as components: the home page
+// shows the first and the graph's panel the others.
+export const load = async ({ data }) => {
+    const descriptions: Record<string, Component> = {};
+    await Promise.all(
+        data.documents.map(async (doc) => {
+            const loaded = await component(doc.descriptionFilename);
+            if (loaded) descriptions[doc.key] = loaded;
+        }),
+    );
+    return { ...data, Description: await component(data.description), descriptions };
+};

package/app/routes/[kind=kind]/[slug]/+page.server.ts

@@ -0,0 +1,62 @@
+import { error } from '@sveltejs/kit';
+import type { OutlineEntry } from '@mvarble/mesearch-cms/presets/mesearch';
+import { citationLabel } from '@mvarble/mesearch-cms/presets/mesearch/runtime';
+import { referenceHtml } from '@mvarble/mesearch-ui/server';
+import site from '$site';
+import { cms } from '$cms';
+
+import { inlineHtml, toIndexEntry, toRef } from '$lib/server/refs';
+import type { TocEntry } from '$lib/types';
+
+export const entries = () =>
+    [...cms.documents.list(), ...cms.sequences.list()].map((doc) => {
+        const [kind, slug] = doc.key.split('/') as [string, string];
+        return { kind, slug };
+    });
+
+export const load = ({ params }) => {
+    const key = `${params.kind}/${params.slug}`;
+    const doc = cms.documents.get(key);
+    if (!doc) error(404, `There is no document at ${key}.`);
+
+    const toc = (entry: OutlineEntry): TocEntry => ({
+        slug: entry.slug,
+        depth: entry.depth,
+        titleHtml: inlineHtml(doc, entry.title),
+        children: entry.children.map(toc),
+    });
+
+    // Where the document sits in each sequence that includes it.
+    const memberships = cms.sequences.containing(key).map(({ sequence, index, documents }) => ({
+        sequence: toRef(sequence),
+        index,
+        documents: documents.map(toRef),
+    }));
+
+    // A sequence's own page lists what it orders.
+    const contents =
+        doc.kind == 'sequence'
+            ? (cms.sequences.get(key)?.documents ?? [])
+                  .map((member) => cms.documents.get(member))
+                  .filter((member) => !!member)
+                  .map(toIndexEntry)
+            : [];
+
+    return {
+        doc: toIndexEntry(doc),
+        filename: doc.filename,
+        toc: cms.outline(doc.filename).map(toc),
+        prerequisites: cms.prerequisites(key).map(toRef),
+        dependents: cms.dependents(key).map(toRef),
+        related: cms.related(key).map(toRef),
+        memberships,
+        contents,
+        // What the page cites, for the list at its end; `cite:key` links on the
+        // page jump to `#cite:key`.
+        references: cms.bibliography(key).map((citation) => ({
+            id: `cite:${citation.key}`,
+            label: citationLabel(citation),
+            html: referenceHtml(citation, { ...site.katexMacros, ...doc.katexMacros }),
+        })),
+    };
+};

package/app/routes/[kind=kind]/[slug]/+page.svelte

@@ -0,0 +1,116 @@
+<script lang="ts">
+    import {
+        Article,
+        ArticleHeader,
+        Chips,
+        Icon,
+        Pager,
+        Parts,
+        References,
+        SequenceTrack,
+        Toc,
+        kindLabel,
+    } from '@mvarble/mesearch-ui';
+    import site from '$site';
+    import { href } from '$lib/format';
+
+    let { data } = $props();
+    let doc = $derived(data.doc);
+
+    // Where the document sits: the site, its kind, and each sequence it is in.
+    let crumbs = $derived([
+        { label: site.title, url: href('') },
+        { label: kindLabel(doc.kind) },
+        ...data.memberships.map((m) => ({
+            label: m.sequence.title,
+            url: m.sequence.url,
+            note: `${m.index + 1} of ${m.documents.length}`,
+        })),
+    ]);
+</script>
+
+<svelte:head>
+    <title>{doc.title} · {site.title}</title>
+    {#if doc.summary}<meta name="description" content={doc.summary} />{/if}
+</svelte:head>
+
+{#snippet header()}
+    <ArticleHeader
+        {crumbs}
+        titleHtml={doc.titleHtml}
+        created={doc.created}
+        updated={doc.updated}
+        readingMinutes={doc.readingMinutes}
+        buildsOn={data.prerequisites}
+    />
+{/snippet}
+
+{#snippet sequences()}
+    {#each data.memberships as membership (membership.sequence.key)}
+        <SequenceTrack
+            title={membership.sequence.titleHtml}
+            url={membership.sequence.url}
+            items={membership.documents}
+            current={doc.key}
+        />
+    {/each}
+{/snippet}
+
+{#snippet contents(folded: boolean)}
+    <Toc entries={data.toc} label={folded ? 'Contents' : 'On this page'} />
+{/snippet}
+
+{#snippet footer()}
+    {#each data.memberships as membership (membership.sequence.key)}
+        <Pager
+            label="Through {membership.sequence.title}"
+            previous={membership.documents[membership.index - 1]}
+            next={membership.documents[membership.index + 1]}
+        />
+    {/each}
+    <section><Chips heading="Leads to" refs={data.dependents} /></section>
+    <section><Chips heading="Related" refs={data.related} /></section>
+    <a class="back" href="{href('')}#atlas"><Icon name="graph" size={16} /> Back to the map</a>
+{/snippet}
+
+<Article
+    kind={doc.kind}
+    {header}
+    {footer}
+    left={data.memberships.length ? sequences : undefined}
+    right={data.toc.length ? contents : undefined}
+    leftLabel={data.memberships.length == 1
+        ? `Sequence: ${data.memberships[0]!.sequence.title}`
+        : 'Sequences'}
+    leftNote={data.memberships.length == 1
+        ? `${data.memberships[0]!.index + 1} of ${data.memberships[0]!.documents.length}`
+        : undefined}
+    after={data.contents.length || data.references.length ? after : undefined}
+>
+    <data.Content />
+</Article>
+
+{#snippet after()}
+    <References entries={data.references} />
+    {#if data.contents.length}<Parts parts={data.contents} />{/if}
+{/snippet}
+
+<style>
+    section:empty {
+        display: none;
+    }
+
+    .back {
+        display: inline-flex;
+        align-items: center;
+        gap: 0.45rem;
+        align-self: flex-start;
+        font: 500 0.85rem / 1 var(--font-ui);
+        color: var(--muted);
+        text-decoration: none;
+    }
+
+    .back:hover {
+        color: var(--accent);
+    }
+</style>

package/app/routes/[kind=kind]/[slug]/+page.ts

@@ -0,0 +1,8 @@
+import { error } from '@sveltejs/kit';
+import loaders from '$cms/loaders';
+
+export const load = async ({ data }) => {
+    const loader = loaders[data.filename];
+    if (!loader) error(404, `${data.filename} is not a document.`);
+    return { ...data, Content: (await loader()).default };
+};

package/app/routes/search.json/+server.ts

@@ -0,0 +1,30 @@
+import { json } from '@sveltejs/kit';
+import { cms } from '$cms';
+
+import { href, plain } from '$lib/format';
+import { inlineHtml } from '$lib/server/refs';
+import type { SearchEntry } from '$lib/types';
+
+export const prerender = true;
+export const trailingSlash = 'never';
+
+// What the search palette searches: titles, summaries and the headings within
+// each document. One file, fetched the first time the palette opens, rather
+// than a copy inside every page.
+export const GET = () => {
+    const entries: SearchEntry[] = [...cms.documents.list(), ...cms.sequences.list()].map(
+        (doc) => ({
+            key: doc.key,
+            kind: doc.kind,
+            url: href(doc.key),
+            title: plain(doc.title),
+            summary: plain(doc.summary),
+            summaryHtml: inlineHtml(doc, doc.summary),
+            headings: cms.headings(doc.filename).map((heading) => ({
+                title: plain(heading.title),
+                slug: heading.slug,
+            })),
+        }),
+    );
+    return json(entries);
+};

package/app/static/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" rx="14" fill="#34317f"/><circle cx="22" cy="24" r="6" fill="#f9f8f3"/><circle cx="42" cy="24" r="6" fill="#f9f8f3"/><circle cx="32" cy="44" r="6" fill="#f9f8f3"/><path d="M22 24 32 44M42 24 32 44" stroke="#f9f8f3" stroke-width="3"/></svg>

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parseArgs } from 'node:util';
+import { initProject } from "./init.js";
+import { packageDir } from "./paths.js";
+import { exportOptions, findRoot, openProject } from "./project.js";
+const USAGE = `
+mesearch --- an opinionated site for a library of notes.
+
+  mesearch init [dir]     scaffold a project: content/, config, stylesheet, AGENTS.md
+  mesearch dev            serve the site, updating as documents change
+  mesearch build          write the static site
+
+Init options
+      --force         overwrite files that already exist
+
+Dev options
+  -p, --port <n>      port to listen on
+      --host [addr]   expose the server on the network
+      --open          open a browser once the server is up
+
+Build options
+  -o, --out <dir>     where to write the site   (default: build)
+      --base <path>   URL prefix the site is served under, overriding the config
+      --force         overwrite an output directory mesearch did not write
+
+  -h, --help          show this message
+  -v, --version       show the version
+
+Run inside a project: the nearest directory up from here whose package.json
+depends on @mvarble/mesearch, or that has a content/ folder.
+`.trim();
+const OPTIONS = {
+    out: { type: 'string', short: 'o' },
+    base: { type: 'string' },
+    force: { type: 'boolean', default: false },
+    port: { type: 'string', short: 'p' },
+    host: { type: 'string' },
+    open: { type: 'boolean', default: false },
+    help: { type: 'boolean', short: 'h', default: false },
+    version: { type: 'boolean', short: 'v', default: false },
+};
+async function main() {
+    const { values, positionals } = parseArgs({ options: OPTIONS, allowPositionals: true });
+    if (values.help)
+        return console.log(USAGE);
+    if (values.version)
+        return console.log(version());
+    const [command, ...rest] = positionals;
+    if (command == 'init') {
+        const dir = path.resolve(rest[0] ?? '.');
+        initProject(dir, { force: values.force });
+        return;
+    }
+    if (command != 'dev' && command != 'build') {
+        console.error(USAGE);
+        throw new Error(command ? `mesearch: no command \`${command}\`.` : 'mesearch: name a command.');
+    }
+    const root = findRoot(process.cwd());
+    if (!fs.existsSync(path.join(root, 'content'))) {
+        throw new Error(`mesearch: \`${root}\` has no content/ folder. Run \`mesearch init\` to make one.`);
+    }
+    const options = {
+        watch: command == 'dev',
+        outDir: values.out ? path.resolve(values.out) : undefined,
+        base: values.base,
+    };
+    exportOptions(options);
+    const project = await openProject(root, options);
+    const configFile = scaffold(project);
+    // SvelteKit reads `svelte.config.js` from the working directory, so that
+    // is where the scaffolding has to be.
+    process.chdir(project.workDir);
+    if (command == 'dev')
+        await dev(project, configFile, values);
+    else
+        await build(project, configFile, values.force);
+}
+// `.mesearch/`: what makes a directory of documents look like a SvelteKit
+// project, rewritten on every run so that it always matches this version.
+function scaffold(project) {
+    fs.mkdirSync(project.workDir, { recursive: true });
+    const kit = JSON.stringify(pathToFileURL(path.join(packageDir, 'dist', 'kit.js')).href);
+    const root = JSON.stringify(project.root);
+    const header = '// Written by mesearch on every run; edits here are lost.\n';
+    const write = (name, contents) => fs.writeFileSync(path.join(project.workDir, name), contents);
+    write('package.json', JSON.stringify({ private: true, type: 'module' }, null, 4) + '\n');
+    write('svelte.config.js', `${header}import { svelteConfig } from ${kit};\n\nexport default await svelteConfig(${root});\n`);
+    write('vite.config.js', `${header}import { viteConfig } from ${kit};\n\nexport default await viteConfig(${root});\n`);
+    write('.gitignore', '*\n');
+    return path.join(project.workDir, 'vite.config.js');
+}
+async function dev(project, configFile, values) {
+    const { createServer } = await import('vite');
+    const server = await createServer({
+        configFile,
+        server: {
+            port: values.port ? Number(values.port) : undefined,
+            host: values.host,
+            open: values.open,
+            // Only when a port was asked for. Otherwise Vite moves to the next
+            // free one, and a tab still open on the old port looks frozen.
+            strictPort: values.port !== undefined,
+        },
+    });
+    try {
+        await server.listen();
+    }
+    catch (error) {
+        await server.close();
+        throw error;
+    }
+    console.log(`mesearch: serving ${project.config.title} from ${project.root}`);
+    server.printUrls();
+}
+// Marks a directory as ours, so that a mistyped `--out` cannot quietly delete
+// somebody's work: the build empties its output directory, and it will only do
+// that to a directory that is empty or that a previous build made.
+const MARKER = '.mesearch-build';
+async function build(project, configFile, force) {
+    const outDir = project.outDir;
+    const entries = fs.existsSync(outDir) ? fs.readdirSync(outDir) : [];
+    if (entries.length > 0 && !entries.includes(MARKER) && !force) {
+        throw new Error(`mesearch: \`${outDir}\` is not empty and was not written by mesearch.\n` +
+            'Building would erase it. Pass --force if that is what you want.');
+    }
+    const { createBuilder } = await import('vite');
+    // `null` lets the config decide between Vite's builders, as `vite build`
+    // does. SvelteKit relies on the legacy one, driving its own server and
+    // client passes; forcing the new one builds the server for the browser.
+    const builder = await createBuilder({ configFile, logLevel: 'warn' }, null);
+    await builder.buildApp();
+    fs.writeFileSync(path.join(outDir, MARKER), '');
+    console.log(`mesearch: wrote ${path.relative(project.root, outDir) || '.'}/`);
+}
+function version() {
+    const manifest = fs.readFileSync(path.join(packageDir, 'package.json'), 'utf8');
+    return JSON.parse(manifest).version;
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+export interface GraphConfig {
+    charge?: number;
+    linkDistance?: number;
+    gravity?: number;
+}
+export interface MesearchConfig {
+    title?: string;
+    author?: string;
+    lang?: string;
+    base?: string;
+    katexMacros?: Record<string, string>;
+    graph?: GraphConfig;
+}
+export declare const defineConfig: (config: MesearchConfig) => MesearchConfig;
+export interface ResolvedConfig {
+    title: string;
+    author?: string;
+    lang: string;
+    base: string;
+    katexMacros: Record<string, string>;
+    graph: Required<GraphConfig>;
+    file?: string;
+}
+export declare function findConfigFile(root: string): string | undefined;
+export declare function loadConfig(root: string): Promise<ResolvedConfig>;
+export declare function validate(raw: unknown, file: string | undefined, fallbackTitle: string): ResolvedConfig;

package/dist/config.js

@@ -0,0 +1,82 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { CONFIG_FILES } from "./paths.js";
+// Typed identity, so an editor can check `mesearch.config.ts`.
+export const defineConfig = (config) => config;
+export function findConfigFile(root) {
+    return CONFIG_FILES.map((name) => path.join(root, name)).find((file) => fs.existsSync(file));
+}
+// Loads `mesearch.config.ts` through Vite's module runner, so the config can be
+// TypeScript and can import whatever the project has installed.
+export async function loadConfig(root) {
+    const file = findConfigFile(root);
+    let raw = {};
+    if (file) {
+        const { runnerImport } = await import('vite');
+        const { module } = await runnerImport(file, {
+            configFile: false,
+            root,
+            logLevel: 'error',
+        });
+        raw = module.default ?? {};
+    }
+    return validate(raw, file, path.basename(root));
+}
+// Every problem with the config at once, rather than the first.
+export function validate(raw, file, fallbackTitle) {
+    const where = file ? path.basename(file) : 'the config';
+    const problems = [];
+    const config = (raw && typeof raw == 'object' ? raw : {});
+    if (raw && typeof raw != 'object')
+        problems.push(`${where} must export an object.`);
+    const string = (field) => {
+        const value = config[field];
+        if (value === undefined)
+            return undefined;
+        if (typeof value != 'string')
+            problems.push(`${where}: \`${field}\` must be a string.`);
+        return typeof value == 'string' ? value : undefined;
+    };
+    const number = (object, field, fallback) => {
+        const value = object[field];
+        if (value === undefined)
+            return fallback;
+        if (typeof value != 'number' || !Number.isFinite(value)) {
+            problems.push(`${where}: \`graph.${field}\` must be a number.`);
+            return fallback;
+        }
+        return value;
+    };
+    let base = string('base') ?? '';
+    if (base == '/')
+        base = '';
+    if (base && (!base.startsWith('/') || base.endsWith('/'))) {
+        problems.push(`${where}: \`base\` must start with a slash and not end with one, as in '/notes'.`);
+    }
+    const macros = config.katexMacros ?? {};
+    if (typeof macros != 'object' ||
+        Array.isArray(macros) ||
+        Object.values(macros).some((value) => typeof value != 'string')) {
+        problems.push(`${where}: \`katexMacros\` must map macro names to strings.`);
+    }
+    const graph = (config.graph ?? {});
+    if (typeof graph != 'object')
+        problems.push(`${where}: \`graph\` must be an object.`);
+    const resolved = {
+        title: string('title') ?? fallbackTitle,
+        author: string('author'),
+        lang: string('lang') ?? 'en',
+        base,
+        katexMacros: typeof macros == 'object' ? macros : {},
+        graph: {
+            charge: number(graph, 'charge', -900),
+            linkDistance: number(graph, 'linkDistance', 80),
+            gravity: number(graph, 'gravity', 0.02),
+        },
+        file,
+    };
+    if (problems.length)
+        throw new Error(problems.map((p) => `mesearch: ${p}`).join('\n'));
+    return resolved;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/headings.d.ts

@@ -0,0 +1,2 @@
+import type { Root } from 'hast';
+export declare const rehypeDemoteHeadings: () => (tree: Root) => void;

package/dist/headings.js

@@ -0,0 +1,17 @@
+// A document's `#` is a section of the page, whose only `<h1>` is the title
+// in its header --- so every heading in a document is rendered one level
+// down: `#` as `<h2>`, `##` as `<h3>`, and so on, `######` staying `<h6>`.
+export const rehypeDemoteHeadings = () => (tree) => {
+    const stack = [tree];
+    while (stack.length) {
+        for (const child of stack.pop().children) {
+            if (child.type != 'element')
+                continue;
+            const level = /^h([1-6])$/.exec(child.tagName)?.[1];
+            if (level)
+                child.tagName = `h${Math.min(6, Number(level) + 1)}`;
+            stack.push(child);
+        }
+    }
+};
+//# sourceMappingURL=headings.js.map

package/dist/headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headings.js","sourceRoot":"","sources":["../src/headings.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CAAC,CAAC,IAAU,EAAE,EAAE;IACrD,MAAM,KAAK,GAA0B,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,GAAG,EAAG,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS;gBAAE,SAAS;YACtC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpD,IAAI,KAAK;gBAAE,KAAK,CAAC,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;AACL,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { defineConfig, type GraphConfig, type MesearchConfig } from './config.ts';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { defineConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,aAAa,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,6 @@
+export interface InitOptions {
+    force?: boolean;
+}
+export declare function initProject(dir: string, options?: InitOptions): void;
+export declare function tokensFile(): string;
+export declare function userStylesheet(): string;