@mvarble/mesearch 0.1.0

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@mvarble/mesearch",
+  "version": "0.1.0",
+  "description": "An opinionated static site for a library of agent-written notes: concepts, writeups and sequences under content/, rendered as a textbook with KaTeX, a dependency graph and an index.",
+  "license": "MIT",
+  "author": "Matthew Varble <matthew@rodent.club>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mvarble/mesearch.git",
+    "directory": "packages/mesearch"
+  },
+  "homepage": "https://github.com/mvarble/mesearch#readme",
+  "bugs": {
+    "url": "https://github.com/mvarble/mesearch/issues"
+  },
+  "keywords": [
+    "markdown",
+    "mdsvex",
+    "svelte",
+    "sveltekit",
+    "katex",
+    "static-site",
+    "notes",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "mesearch": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./kit": {
+      "types": "./dist/kit.d.ts",
+      "import": "./dist/kit.js"
+    },
+    "./Statement.svelte": {
+      "svelte": "./app/components/Statement.svelte",
+      "default": "./app/components/Statement.svelte"
+    },
+    "./Proof.svelte": {
+      "svelte": "./app/components/Proof.svelte",
+      "default": "./app/components/Proof.svelte"
+    },
+    "./tsconfig.json": "./tsconfig.project.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "app",
+    "templates",
+    "tsconfig.project.json"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "dependencies": {
+    "@mvarble/mesearch-cms": "^0.1.0",
+    "@mvarble/mesearch-markdown": "^0.1.0",
+    "@mvarble/mesearch-ui": "^0.1.0",
+    "@sveltejs/adapter-static": "^3.0.10",
+    "@sveltejs/kit": "^2.70.3",
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
+    "katex": "^0.18.4",
+    "svelte": "^5.57.1",
+    "vite": "^8.3.2"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.5",
+    "@types/node": "^22.14.0",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test 'test/**/*.test.mjs'"
+  }
+}

package/templates/AGENTS.md

@@ -0,0 +1,64 @@
+# Writing for {{title}}
+
+This repository is a [mesearch](https://github.com/mvarble/mesearch) site: a library of documents written to be read and learned from. `mesearch dev` serves it while you write and `mesearch build` writes the static site to `build/`. Everything about how the site looks is mesearch's; this repository holds only the documents and a little configuration.
+
+These instructions apply to every agent writing here. They sit alongside any procedure you were given for the task (an `/explain` run, say); where the two disagree about this site's layout or conventions, this file wins.
+
+## Layout
+
+```
+content/
+    description.md                  what the site is about; opens the home page
+    concepts/<slug>/index.md        one concept per folder
+    concepts/<slug>/description.md  optional one- or two-sentence preview
+    writeups/<slug>/index.md        one writeup per folder
+    writeups/<slug>/description.md  optional preview
+    sequences/<slug>/index.md       an ordered run of writeups
+```
+
+- A **concept** explains a single idea on its own terms. A **writeup** works through something --- a source document, a problem, a topic --- using concepts.
+- The folder name is the slug: lowercase words joined by hyphens, named after the idea (`net-interest-margin`), never dated.
+- Documents may be `.md` or `.svx` ([mdsvex](https://mdsvex.pngwn.io/): markdown that can import and use Svelte components). Anything else a document uses --- images, data, components --- goes in its own folder and is referenced relatively, as `![A tree of outcomes](./tree.svg)`.
+- Before creating a concept, check `content/concepts/`: if it exists, link to it and never rewrite or duplicate it. If a concept a document needs is missing, create it.
+
+## Frontmatter
+
+Every `index` document starts with YAML frontmatter:
+
+```yaml
+---
+title: Net interest margin
+created: 2026-10-01
+updated: 2026-10-03 # only when revising; omit on creation
+depends_on: [basis-points, writeups/bank-balance-sheets]
+katex_macros:
+    '\NIM': '\mathrm{NIM}'
+---
+```
+
+- `title` is required. It may contain inline math (`$\sigma$-algebras`).
+- `created` and `updated` are dates. Without them the site falls back to the git history of the document's folder.
+- `depends_on` lists what a reader must understand first, by slug. A bare slug names a concept or a writeup; write `concepts/<slug>` or `writeups/<slug>` when both exist. These become the solid arrows of the map, so they should be the real prerequisites --- the documents a reader would otherwise be lost without --- not everything mentioned.
+- `katex_macros` are added to the site-wide macros in `mesearch.config.ts` for this document only.
+- A sequence (`content/sequences/<slug>/index.md`) also has `documents:`, the writeups in reading order. Its body introduces the sequence.
+
+A `description.md` has no frontmatter beyond optional `katex_macros`. It is one or two plain sentences saying what the document covers, for the map's preview panel and the index; without one, the document's first paragraph is used.
+
+## Links
+
+- Link to other documents with relative paths, the way the folders sit on disk: `[basis points](../basis-points/)` from one concept to another, `[the writeup](../../writeups/bank-balance-sheets/)` from a concept to a writeup. Links ending in `index.md` also work. The site rewrites them to the right URLs.
+- A link between two documents that do not depend on each other draws a dashed line on the map, so link generously where it helps the reader.
+- Never put a link inside a heading. When a section concerns another document, put `See also: [Name](../name/)` on its own line under the heading.
+
+## Prose
+
+Write in the register of a textbook: impersonal third-person exposition in complete sentences and paragraphs, with tables and bullet lists only where they genuinely help. Never address the reader or write in the first person, and never refer to the conversation or session that produced the document. Prefer a concrete example to an abstract definition alone. Each document must stand on its own for a reader arriving at it first, relying only on what it links as prerequisites.
+
+## Site-specific opinions
+
+<!-- Opinions particular to this site go here: its subject, the reader's
+background, notation conventions, what to emphasise. For example:
+
+- The reader is comfortable with undergraduate real analysis.
+- Write probability measures as \PP and expectations as \EE.
+-->

package/templates/content/concepts/example-concept/description.md

@@ -0,0 +1 @@
+A one- or two-sentence preview, shown when the concept is selected on the map and in the index.

package/templates/content/concepts/example-concept/index.md

@@ -0,0 +1,16 @@
+---
+title: An example concept
+created: {{date}}
+---
+
+A concept explains one idea on its own terms: what it is, why it matters, and an example. Its folder name is its slug, so this one lives at `concepts/example-concept/`.
+
+# A section
+
+Headings become the table of contents beside the page. Display math is written like this:
+
+$$
+	\int_0^1 x \, {\rm d}x = \frac{1}{2}. @tag(half)
+$$
+
+The `@tag(half)` numbers the equation, and [this link](eq:half) refers back to it.

package/templates/content/description.md

@@ -0,0 +1 @@
+What this site is for, in a paragraph or two. This text opens the home page, above the map of every concept and writeup. It is ordinary markdown: it can link to [a concept](./concepts/example-concept/) and use math like $e^{i\pi} = -1$.

package/templates/content/writeups/example-writeup/index.md

@@ -0,0 +1,7 @@
+---
+title: An example writeup
+created: {{date}}
+depends_on: [example-concept]
+---
+
+A writeup works through something using the concepts beneath it. Its `depends_on` list draws the solid arrow from [the example concept](../../concepts/example-concept/) to here on the map; a plain link between two documents that do not depend on each other draws a dashed line instead.

package/templates/mesearch.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from '@mvarble/mesearch';
+
+export default defineConfig({
+    // The site's name, shown on the home page and in every tab.
+    title: '{{title}}',
+    // author: 'Your name',
+    // lang: 'en',
+
+    // The URL prefix the site is served from, if not the root of its domain,
+    // as in GitHub Pages' '/<repository>'.
+    // base: '/notes',
+
+    // KaTeX macros every document can use. A document adds its own in its
+    // frontmatter, under `katex_macros`.
+    katexMacros: {
+        // '\\PP': '\\mathbb{P}',
+        // '\\EE': '\\mathbb{E}',
+    },
+
+    // How the map lays itself out.
+    // graph: { charge: -900, linkDistance: 80, gravity: 0.02 },
+});

package/tsconfig.project.json

@@ -0,0 +1,16 @@
+{
+    "compilerOptions": {
+        "target": "es2023",
+        "lib": ["es2023", "dom", "dom.iterable"],
+        "module": "nodenext",
+        "moduleResolution": "nodenext",
+        "strict": true,
+        "skipLibCheck": true,
+        "allowJs": true,
+        "checkJs": false,
+        "noEmit": true,
+        "allowImportingTsExtensions": true,
+        "verbatimModuleSyntax": true
+    },
+    "include": ["${configDir}/mesearch.config.ts", "${configDir}/content/**/*"]
+}