@plebeiantech/lat.md 0.12.3-fork.4 → 0.12.3-fork.6

package/dist/src/view/store.js

@@ -8,10 +8,14 @@ import { toPosix } from '../walk.js';
 import { renderMarkdown } from './markdown.js';
 import { buildViewDiagnostics } from './diagnostics.js';
 import { buildGitDiffTree } from './git-diff.js';
+import { buildViewGraph } from './graph.js';
+import { buildViewTableOfContents } from './table-of-contents.js';
 import { emptyViewGitSnapshot, findViewGitRepository, readViewGitSnapshot, sameViewGitSnapshot, } from './git.js';
+import { DEFAULT_VIEW_LOGO_TEXT } from './protocol.js';
 import { createMarkdownWikiLinkResolver, getViewSource, ViewDocumentNotFoundError, } from './repository.js';
 import { buildViewReferenceIndex, parseViewMarkdownFile, renderSectionBackReferences, } from './references.js';
 const DEFAULT_DEBOUNCE_MS = 75;
+const DEFAULT_GIT_POLL_MS = 2_000;
 function isInside(root, candidate) {
     const rel = relative(root, candidate);
     return (rel === '' ||
@@ -21,6 +25,10 @@ function projectPath(projectRoot, path) {
     const normalized = isAbsolute(path) ? relative(projectRoot, path) : path;
     return toPosix(normalized).replace(/^\.\//, '');
 }
+function excludedCodePath(projectRoot, path, excludedPaths) {
+    const absolutePath = resolve(projectRoot, path);
+    return excludedPaths.some((root) => isInside(resolve(root), absolutePath));
+}
 function sourcePath(path) {
     return SOURCE_EXTENSIONS.has(extname(path).toLowerCase());
 }
@@ -64,11 +72,14 @@ async function loadCodeReferenceFiles(projectRoot, refs) {
     }));
     return files;
 }
-async function scanCodeState(projectRoot) {
+async function scanCodeState(projectRoot, excludedPaths = []) {
     const scan = await scanCodeRefs(projectRoot);
-    const scope = new Set(scan.files.map((path) => projectPath(projectRoot, path)));
+    const allowed = (path) => !excludedCodePath(projectRoot, path, excludedPaths);
+    const files = scan.files.filter(allowed);
+    const refs = scan.refs.filter((ref) => allowed(ref.file));
+    const scope = new Set(files.map((path) => projectPath(projectRoot, path)));
     return {
-        files: await loadCodeReferenceFiles(projectRoot, scan.refs),
+        files: await loadCodeReferenceFiles(projectRoot, refs),
         scope,
     };
 }
@@ -89,18 +100,21 @@ function viewIndex(latDir, paths, diagnostics, git) {
                 files: Object.fromEntries([...git.files].map(([path, file]) => [path, file.status])),
             }
             : null,
+        logoText: DEFAULT_VIEW_LOGO_TEXT,
     };
 }
 async function buildSnapshot(latDir, projectRoot, markdownFiles, codeFiles, git, generation, markdownGeneration) {
     const files = new Map([...markdownFiles].sort(([left], [right]) => left.localeCompare(right)));
     const allSections = [...files.values()].flatMap((file) => file.sections);
     const diagnostics = await buildViewDiagnostics(files.values(), codeFiles.values(), allSections, projectRoot);
+    const references = buildViewReferenceIndex(files.values(), codeFiles.values(), allSections);
     return {
         generation,
         markdownGeneration,
         files,
         allSections,
-        references: buildViewReferenceIndex(files.values(), codeFiles.values(), allSections),
+        references,
+        graph: buildViewGraph(files.values(), codeFiles.values(), allSections, diagnostics, git, generation),
         diagnostics,
         git,
         index: viewIndex(latDir, [...files.keys()], diagnostics, git),
@@ -121,6 +135,8 @@ export class ViewStore {
     watcher = null;
     pendingPaths = new Set();
     debounceTimer = null;
+    gitPollTimer = null;
+    gitPollQueued = false;
     refreshTail = Promise.resolve();
     closed = false;
     constructor(latDir, projectRoot, realLatDir, snapshot, codeFiles, codeScope, gitRepository, options) {
@@ -140,6 +156,7 @@ export class ViewStore {
         return this.snapshotValue.markdownGeneration;
     }
     startWatching() {
+        this.startGitPolling();
         if (this.options.watch === false || this.watcher)
             return;
         try {
@@ -159,6 +176,9 @@ export class ViewStore {
     getIndex() {
         return this.snapshotValue.index;
     }
+    getGraph() {
+        return this.snapshotValue.graph;
+    }
     async getDocument(requestedPath) {
         if (!requestedPath ||
             requestedPath.includes('\\') ||
@@ -171,19 +191,39 @@ export class ViewStore {
         if (!file) {
             throw new ViewDocumentNotFoundError('Markdown document not found');
         }
-        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections);
+        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections, snapshot.references);
         const rendered = await renderMarkdown(file.content, requestedPath, resolver, { errors: [...(snapshot.diagnostics.get(requestedPath) ?? [])] }, file.tree);
+        const errors = [...(snapshot.diagnostics.get(requestedPath) ?? [])];
         const gitFile = snapshot.git.files.get(requestedPath);
-        const gitRendered = gitFile
-            ? await renderMarkdown(file.content, requestedPath, resolver, { errors: [...(snapshot.diagnostics.get(requestedPath) ?? [])] }, buildGitDiffTree(gitFile.baseContent, file.content, file.tree))
+        const gitTree = gitFile
+            ? buildGitDiffTree(gitFile.baseContent, file.content, file.tree)
+            : null;
+        const gitRendered = gitTree
+            ? await renderMarkdown(file.content, requestedPath, resolver, { errors }, gitTree)
             : null;
-        const errors = [...(snapshot.diagnostics.get(requestedPath) ?? [])];
         return {
             path: requestedPath,
             ...rendered,
             gitHtml: gitRendered?.html ?? null,
+            tableOfContents: buildViewTableOfContents(file.sections, file.tree, {
+                errors,
+                gitTree,
+            }),
+            graphNodeIds: Object.fromEntries(snapshot.graph.nodes
+                .filter((node) => node.documentPath === requestedPath && node.kind === 'document')
+                .map((node) => {
+                const hash = new URL(node.url, 'http://lat.local').hash.slice(1);
+                let headingId = hash;
+                try {
+                    headingId = decodeURIComponent(hash);
+                }
+                catch {
+                    // Keep malformed fragments as-is; they cannot collide with valid ids.
+                }
+                return [headingId, node.id];
+            })),
             errors,
-            backReferences: await renderSectionBackReferences(snapshot.references, file.sections, this.latDir, this.projectRoot, (path) => createMarkdownWikiLinkResolver(this.latDir, path, snapshot.allSections)),
+            backReferences: await renderSectionBackReferences(snapshot.references, file.sections, this.latDir, this.projectRoot, (path) => createMarkdownWikiLinkResolver(this.latDir, path, snapshot.allSections, snapshot.references)),
             frontmatter: {
                 requireCodeMention: parseFrontmatter(file.content).requireCodeMention === true,
             },
@@ -197,7 +237,10 @@ export class ViewStore {
         if (this.closed)
             return Promise.resolve();
         const normalized = paths.map((path) => path ? projectPath(this.projectRoot, path) : '');
-        const refresh = this.refreshTail.then(() => this.applyRefresh(normalized));
+        return this.queueRefresh(normalized, false);
+    }
+    queueRefresh(paths, pollGit) {
+        const refresh = this.refreshTail.then(() => this.applyRefresh(paths, pollGit));
         this.refreshTail = refresh.catch(() => { });
         return refresh;
     }
@@ -206,6 +249,9 @@ export class ViewStore {
         if (this.debounceTimer)
             clearTimeout(this.debounceTimer);
         this.debounceTimer = null;
+        if (this.gitPollTimer)
+            clearInterval(this.gitPollTimer);
+        this.gitPollTimer = null;
         this.watcher?.close();
         this.watcher = null;
         await this.refreshTail;
@@ -226,6 +272,24 @@ export class ViewStore {
             });
         }, this.options.debounceMs ?? DEFAULT_DEBOUNCE_MS);
     }
+    startGitPolling() {
+        const interval = this.options.gitPollMs ?? DEFAULT_GIT_POLL_MS;
+        if (!this.gitRepository || interval <= 0 || this.gitPollTimer)
+            return;
+        this.gitPollTimer = setInterval(() => {
+            if (this.closed || this.gitPollQueued)
+                return;
+            this.gitPollQueued = true;
+            void this.queueRefresh([], true)
+                .catch((error) => {
+                process.stderr.write(`lat ui git: ${error.message}\n`);
+            })
+                .finally(() => {
+                this.gitPollQueued = false;
+            });
+        }, interval);
+        this.gitPollTimer.unref();
+    }
     async readMarkdownFile(absolutePath) {
         let realFile;
         try {
@@ -239,7 +303,7 @@ export class ViewStore {
         const content = await readFile(realFile, 'utf8');
         return parseViewMarkdownFile(absolutePath, content, this.latDir, this.projectRoot);
     }
-    async applyRefresh(paths) {
+    async applyRefresh(paths, pollGit) {
         const fullRefresh = paths.includes('');
         const latPath = projectPath(this.projectRoot, this.latDir);
         const touchesMarkdown = fullRefresh ||
@@ -298,7 +362,7 @@ export class ViewStore {
             }
             linkedResourceChanged = paths.some((path) => path.startsWith(`${latPath}/`) && !path.toLowerCase().endsWith('.md'));
         }
-        if (touchesMarkdown && this.gitRepository) {
+        if ((touchesMarkdown || pollGit) && this.gitRepository) {
             try {
                 const nextGit = await readViewGitSnapshot(this.gitRepository, markdownFiles);
                 gitChanged = !sameViewGitSnapshot(git, nextGit);
@@ -308,12 +372,15 @@ export class ViewStore {
                 process.stderr.write(`lat ui git: ${error.message}\n`);
             }
         }
-        const codePaths = paths.filter((path) => path && sourcePath(path) && !obviouslyIgnoredCodePath(path, latPath));
+        const codePaths = paths.filter((path) => path &&
+            sourcePath(path) &&
+            !obviouslyIgnoredCodePath(path, latPath) &&
+            !excludedCodePath(this.projectRoot, path, this.options.codeExcludePaths ?? []));
         const refreshCodeScope = fullRefresh ||
             paths.some((path) => path === '.gitignore' || path.endsWith('/.gitignore')) ||
             codePaths.some((path) => !this.codeScope.has(path) && !this.ignoredCodePaths.has(path));
         if (refreshCodeScope) {
-            const nextCode = await scanCodeState(this.projectRoot);
+            const nextCode = await scanCodeState(this.projectRoot, this.options.codeExcludePaths);
             codeFiles = nextCode.files;
             this.codeScope = nextCode.scope;
             this.ignoredCodePaths.clear();
@@ -369,7 +436,7 @@ export async function createViewStore(latDir, projectRoot, options = {}) {
     const [realLatDir, markdownPaths, codeState, gitRepository] = await Promise.all([
         realpath(latDir),
         listLatticeFiles(latDir),
-        scanCodeState(projectRoot),
+        scanCodeState(projectRoot, options.codeExcludePaths),
         options.git === false
             ? Promise.resolve(null)
             : findViewGitRepository(projectRoot, latDir),

package/dist/src/view/table-of-contents.d.ts

@@ -0,0 +1,9 @@
+import type { Root } from 'mdast';
+import { type Section } from '../lattice.js';
+import type { ViewDocumentError, ViewDocumentTocItem } from './protocol.js';
+export type ViewTableOfContentsOptions = {
+    errors?: readonly ViewDocumentError[];
+    gitTree?: Root | null;
+};
+/** Project rendered headings into the document's local navigation. */
+export declare function buildViewTableOfContents(sections: Section[], tree: Root, options?: ViewTableOfContentsOptions): ViewDocumentTocItem[];

package/dist/src/view/table-of-contents.js

@@ -0,0 +1,103 @@
+import { visit } from 'unist-util-visit';
+import { flattenSections } from '../lattice.js';
+function headingText(node) {
+    if (!node || typeof node !== 'object')
+        return '';
+    const value = node;
+    if (value.type === 'text' || value.type === 'inlineCode') {
+        return value.value ?? '';
+    }
+    if (value.type === 'image' || value.type === 'imageReference') {
+        return value.alt ?? '';
+    }
+    if (value.type === 'wikiLink') {
+        return value.data?.alias ?? value.value ?? '';
+    }
+    return value.children?.map(headingText).join('') ?? '';
+}
+function sectionAtLine(sections, line) {
+    let owner = null;
+    for (const section of sections) {
+        if (line < section.startLine || line > section.endLine)
+            continue;
+        if (!owner || section.depth >= owner.depth)
+            owner = section;
+    }
+    return owner;
+}
+function classNames(node) {
+    const value = node.data?.hProperties?.className;
+    if (Array.isArray(value))
+        return value.map(String);
+    return value ? [String(value)] : [];
+}
+function hasGitChanges(node) {
+    if (classNames(node).some((name) => name.startsWith('git-'))) {
+        return true;
+    }
+    if (!('children' in node) || !Array.isArray(node.children))
+        return false;
+    return node.children.some((child) => hasGitChanges(child));
+}
+function gitChangedSections(sections, tree) {
+    const changed = new Set();
+    if (!tree)
+        return changed;
+    const headingStack = [];
+    const rootSection = sections[0] ?? null;
+    for (const node of tree.children) {
+        if (node.type === 'heading') {
+            while (headingStack.length > 0 &&
+                headingStack[headingStack.length - 1].depth >= node.depth) {
+                headingStack.pop();
+            }
+            const line = node.position?.start.line;
+            const section = line
+                ? (sections.find((candidate) => candidate.startLine === line && candidate.depth === node.depth) ?? null)
+                : null;
+            if (section)
+                headingStack.push(section);
+            if (hasGitChanges(node)) {
+                const owner = section ?? headingStack[headingStack.length - 1] ?? rootSection;
+                if (owner)
+                    changed.add(owner.id);
+            }
+            continue;
+        }
+        if (!hasGitChanges(node))
+            continue;
+        const line = node.position?.start.line;
+        const owner = (line ? sectionAtLine(sections, line) : null) ??
+            headingStack[headingStack.length - 1] ??
+            rootSection;
+        if (owner)
+            changed.add(owner.id);
+    }
+    return changed;
+}
+/** Project rendered headings into the document's local navigation. */
+export function buildViewTableOfContents(sections, tree, options = {}) {
+    const flatSections = flattenSections(sections);
+    const titles = [];
+    visit(tree, 'heading', (node) => {
+        titles.push(headingText(node));
+    });
+    const errorCounts = new Map();
+    for (const error of options.errors ?? []) {
+        const owner = sectionAtLine(flatSections, error.line);
+        if (owner)
+            errorCounts.set(owner.id, (errorCounts.get(owner.id) ?? 0) + 1);
+    }
+    const gitChanges = gitChangedSections(flatSections, options.gitTree);
+    return flatSections.flatMap((section, index) => section.githubSlug
+        ? [
+            {
+                id: section.githubSlug,
+                title: titles[index] || section.heading,
+                depth: section.depth,
+                errorCount: errorCounts.get(section.id) ?? 0,
+                hasGitChanges: gitChanges.has(section.id),
+            },
+        ]
+        : []);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plebeiantech/lat.md",
-  "version": "0.12.3-fork.4",
+  "version": "0.12.3-fork.6",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "license": "MIT",
@@ -32,12 +32,14 @@
     "@vitejs/plugin-react": "^5.0.0",
     "@types/mdast": "^4.0.4",
     "@types/node": "^25.3.0",
+    "graphology": "^0.26.0",
     "highlight.js": "^11.12.0",
     "mdast-util-from-markdown": "^2.0.3",
     "micromark-util-types": "^2.0.2",
     "prettier": "^3.8.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "sigma": "^3.0.3",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vite": "^7.0.0",

package/templates/AGENTS.md

@@ -17,6 +17,8 @@ After EVERY task, before responding to the user:
 
 This project uses [lat.md](https://www.npmjs.com/package/lat.md) to maintain a structured knowledge graph of its architecture, design decisions, and test specs in the `lat.md/` directory. It is a set of cross-linked markdown files that describe **what** this project does and **why** — the domain concepts, key design decisions, business logic, and test specifications. Use it to ground your work in the actual architecture rather than guessing. Do not treat `lat.md/` as a journal or changelog; it should be a focused snapshot of current or planned state, and should not grow just to note insignificant details.
 
+Project-specific lat documentation belongs in `lat.md/`. Do not modify this generated instruction file or a generated `lat-md` `SKILL.md` to record project guidance: both are owned by lat tooling and may be replaced by a later `lat init`.
+
 # Commands
 
 ```bash
@@ -103,16 +105,3 @@ Details about this child topic.
 ```
 
 The second example is invalid because `Bad Section` has no leading paragraph. `lat check` validates this rule and reports errors for missing or overly long leading paragraphs.
-
-# Diátaxis modes
-
-Documents under `lat.md/tutorials/`, `lat.md/how-to/`, `lat.md/reference/`, and `lat.md/explanation/` are checked against their Diátaxis mode. Declare it explicitly with nested frontmatter, or rely on the directory:
-
-```markdown
----
-lat:
-  mode: reference
----
-```
-
-If a document is in one of the four mode directories, the declared mode must match that directory. Each mode enforces one shape rule: tutorials need an ordered list of steps and a stated outcome; how-to guides need an ordered list of steps; reference docs must not contain narrative prose (no second paragraph under a heading); explanations must not give imperative commands. Run `lat check mode` to validate.

package/templates/fork/conventions.md

@@ -0,0 +1,95 @@
+# lat.md conventions this project enforces
+
+`lat check` fails on every rule below. They are not style preferences. This
+block is generated and a later `lat init` replaces it — record project guidance
+in `lat.md/`, never here.
+
+## Every document goes in a Diátaxis mode directory
+
+A document belongs in exactly one of four subdirectories, and `lat check mode`
+enforces one shape rule for each:
+
+| Directory | Holds | Shape rule |
+| --- | --- | --- |
+| `lat.md/tutorials/` | a guided first pass for someone new | an ordered list of steps, and a stated outcome |
+| `lat.md/how-to/` | a recipe for a task that recurs | an ordered list of steps |
+| `lat.md/reference/` | lookup facts: fields, states, limits, names | no narrative prose — no second paragraph under a heading |
+| `lat.md/explanation/` | why the design is what it is | no imperative commands |
+
+Do not write documents at the top of `lat.md/`. The root index is the only file
+that belongs there. When it carries `require-mode: true`, a document with no
+declared mode and no mode directory is a `lat check` error.
+
+**A document that fails its mode is usually two documents.** A file that lists
+the states *and* argues for the design is mixed: the lookup half goes in
+`reference/`, the reasoning half in `explanation/`, and each links the other.
+Filing it under one mode and softening the prose until the check passes is the
+wrong repair. So is leaving it at the top level where no check can see it.
+
+Classify before writing, not after. If a `diataxis` skill is available, use it.
+
+## Every project has at least one `@lat:` code ref
+
+`lat check` fails a tree that has documents and no `@lat:` ref anywhere in the
+codebase. A graph nothing points at cannot be reached from the code, which is
+the only reason it exists.
+
+Start at the application entrypoint — `config/application.rb`, `src/index.ts`,
+`main.go`, `manage.py`, whatever a new reader opens first — and point it at the
+root index:
+
+```ruby
+# @lat: [[lat#Acme]]
+module Acme
+```
+
+Then one ref per section that source code actually implements, placed at that
+code. Never in a block at the top of a file.
+
+### An `@lat:` pointer is exempt from this project's comment conventions
+
+A repository that minimises, budgets, or forbids comments is right about prose
+comments and does not reach this one. An `@lat:` line is a machine directive,
+in the same class as `# frozen_string_literal:` or `// eslint-disable`. It
+carries no rationale, asserts nothing a reader could dispute, and cannot rot
+quietly — `lat check` fails the moment its target moves or disappears.
+
+Add the ref. Then, if the reasoning that would have been a comment is worth
+keeping, put it in a `lat.md/explanation/` section and let the pointer reach it.
+
+### The marker is a comment syntax, not a language allowlist
+
+`//` for C-family languages; `#` for Ruby, Python, shell, Elixir, YAML, Make,
+and everything else that comments with `#`. The scan is textual and walks every
+non-markdown file in the project, so every language works.
+
+Any list of example languages you find is a list of examples. Never conclude a
+language is unsupported because it is absent from one. `lat check` prints what
+it scanned:
+
+```
+Scanned 41 .md, 622 .rb, 118 .tsx in 1.2s
+```
+
+Read that line rather than guessing, and if you are still unsure, add one ref
+and run the check. It costs one command.
+
+(The tree-sitter grammars limit only `[[src/file.ts#symbol]]` wiki links, which
+resolve a symbol inside source. `@lat:` refs point the other way and have no
+such limit.)
+
+## Test specs are wired to their tests
+
+A document describing tests declares it in frontmatter:
+
+```markdown
+---
+lat:
+  require-code-mention: true
+---
+```
+
+Every leaf section then needs exactly one `@lat:` comment at the test that
+covers it, and every section needs at least one sentence saying what it
+verifies and why. `lat check` reports any spec section no test claims, and any
+ref pointing at no section.

package/templates/skill/SKILL.md

@@ -10,6 +10,8 @@ description: >-
 
 This skill covers the syntax, structure rules, and conventions for writing `lat.md/` files. Load it whenever you need to create or edit sections in the `lat.md/` directory.
 
+Project-specific lat documentation belongs in `lat.md/`. Do not modify this generated skill or a generated `AGENTS.md` to record project guidance: both are owned by lat tooling and may be replaced by a later `lat init`.
+
 ## What belongs in lat.md
 
 `lat.md/` files describe **what** the project does and **why** — domain concepts, key design decisions, business logic, and test specifications. They do NOT duplicate source code. Think of each section as an anchor that source code references back to.
@@ -162,20 +164,7 @@ lat:
 ---
 ```
 
-Supported fields: `require-code-mention` for test spec enforcement, and `mode` for Diátaxis mode declaration.
-
-## Diátaxis modes
-
-Documents in `tutorials/`, `how-to/`, `reference/`, or `explanation/` under `lat.md/` are checked against their Diátaxis mode. Declare it with nested frontmatter:
-
-```yaml
----
-lat:
-  mode: reference
----
-```
-
-If the document is in one of the four mode directories, the declared mode must match that directory. Each mode enforces one shape rule: tutorials need an ordered list of steps and a stated outcome; how-to guides need an ordered list of steps; reference docs must not contain narrative prose (no second paragraph under a heading); explanations must not give imperative commands. `lat check mode` validates this.
+Currently the only supported field is `require-code-mention` for test spec enforcement.
 
 ## Validation
 

package/dist/src/view/client/assets/index-B0n0u03y.css

@@ -1 +0,0 @@
-:root{color:#25231f;background:#f8f7f3;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-synthesis:none;text-rendering:optimizeLegibility;--background: #f8f7f3;--panel: #f0eee8;--panel-border: #dedbd1;--text: #25231f;--muted: #777268;--accent: #7357d9;--accent-soft: #e7e0ff;--danger: #b72f3d;--danger-soft: #f8dfe2;--danger-border: #e7a5ad;--warning: #a87000;--warning-soft: #f5e7b8;--success: #2f7a48;--success-soft: #dceede;--git-notification: #e47f19;--code: #ece9e1;--syntax-built-in: #9a3f75;--syntax-comment: #777268;--syntax-keyword: #6c4bc2;--syntax-number: #a85414;--syntax-string: #397348;--syntax-title: #26649a}@media(prefers-color-scheme:dark){:root{color:#e8e6df;background:#181816;--background: #181816;--panel: #201f1c;--panel-border: #34322d;--text: #e8e6df;--muted: #9c978d;--accent: #ad9aff;--accent-soft: #332b52;--danger: #ff7e8a;--danger-soft: #49262b;--danger-border: #713941;--warning: #e9bd4c;--warning-soft: #43391e;--success: #83d79a;--success-soft: #213d29;--git-notification: #f0a044;--code: #25241f;--syntax-built-in: #e6a2cc;--syntax-comment: #88847c;--syntax-keyword: #c2adff;--syntax-number: #efb271;--syntax-string: #9fd0a5;--syntax-title: #8fc6ef}}*{box-sizing:border-box}body{margin:0;min-width:320px;min-height:100vh;color:var(--text);background:var(--background)}a{color:var(--accent)}.app-shell{display:grid;grid-template-columns:260px minmax(0,1fr);min-height:100vh}.sidebar{position:sticky;top:0;height:100vh;padding:28px 18px;overflow-y:auto;background:var(--panel);border-right:1px solid var(--panel-border)}.sidebar-header{display:flex;margin:0 10px 34px;align-items:center;justify-content:space-between}.brand{display:inline-block;color:var(--text);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:21px;font-weight:750;letter-spacing:-.04em;text-decoration:none}.brand span{color:var(--accent)}.sidebar-actions{display:flex;align-items:center;gap:3px}.sidebar-search,.sidebar-git{display:inline-flex;width:28px;height:28px;align-items:center;justify-content:center;color:var(--muted);cursor:pointer;background:transparent;border:0;border-radius:6px}.sidebar-search:hover,.sidebar-search[aria-current=page],.sidebar-git:hover{color:var(--accent);background:var(--accent-soft)}.sidebar-git[aria-pressed=true]{color:var(--warning);background:var(--warning-soft)}.sidebar-git{position:relative}.sidebar-git[data-has-changes=true]:after{position:absolute;top:3px;right:3px;width:6px;height:6px;content:"";background:var(--git-notification);border-radius:50%;box-shadow:0 0 0 1.5px var(--panel)}.sidebar-search svg,.sidebar-git svg{width:17px;height:17px;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:1.8}.file-tree{display:grid;min-width:0;gap:2px}.tree-directory>summary{display:flex;padding:7px 10px;align-items:center;gap:7px;color:var(--muted);font-size:12px;font-weight:650;cursor:pointer;list-style:none;border-radius:7px}.tree-directory>summary::-webkit-details-marker{display:none}.tree-directory>summary>a,.tree-directory>summary>span{min-width:0;flex:1;color:inherit;text-decoration:none}.tree-directory>summary>a,.tree-directory>summary>span{display:flex;align-items:center;gap:8px}.tree-directory>summary:before{content:"›";display:inline-block;width:10px;font-size:15px;line-height:1;transform-origin:center;transition:transform .12s ease}.tree-directory[open]>summary:before{transform:rotate(90deg)}.tree-directory>summary:hover{color:var(--text);background:color-mix(in srgb,var(--accent-soft) 55%,transparent)}.tree-children{display:grid;margin-left:15px;padding-left:7px;gap:2px;border-left:1px solid var(--panel-border)}.tree-directory[open]>.tree-children{margin-top:2px}.document-link{display:flex;padding:7px 10px;align-items:center;gap:8px;overflow:hidden;color:var(--muted);font-size:13px;line-height:1.35;text-decoration:none;text-overflow:ellipsis;white-space:nowrap;border-radius:7px}.document-link-name{min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.document-state-disc{width:7px;height:7px;flex:0 0 auto;border-radius:50%}.document-state-disc.has-errors{background:var(--danger);box-shadow:0 0 0 2px color-mix(in srgb,var(--danger) 12%,transparent)}.document-state-disc.git-modified{background:var(--warning);box-shadow:0 0 0 2px color-mix(in srgb,var(--warning) 12%,transparent)}.document-state-disc.git-new{background:var(--success);box-shadow:0 0 0 2px color-mix(in srgb,var(--success) 12%,transparent)}.document-state-disc.has-errors.git-modified{background:linear-gradient(90deg,var(--danger) 0 50%,var(--warning) 50% 100%)}.document-state-disc.has-errors.git-new{background:linear-gradient(90deg,var(--danger) 0 50%,var(--success) 50% 100%)}.document-link:hover,.document-link.active{color:var(--text);background:var(--accent-soft)}.document-link.active{font-weight:650}.main{width:100%;max-width:980px;min-width:0;padding:46px clamp(28px,6vw,82px) 100px}.main.restoring-history-scroll{visibility:hidden}.document-header{max-width:760px;margin-bottom:34px}.document-metadata{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.document-path{color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px}.document-flag{padding:3px 8px;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:700;letter-spacing:.025em;background:var(--accent-soft);border:1px solid color-mix(in srgb,var(--accent) 25%,transparent);border-radius:999px}.document-error-toggle{display:inline-flex;padding:3px 8px;align-items:center;color:var(--danger);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:700;letter-spacing:.025em;cursor:pointer;background:var(--danger-soft);border:1px solid var(--danger-border);border-radius:999px}.document-error-toggle:hover,.document-error-toggle[aria-expanded=true]{color:var(--text)}.document-error-panel{margin-top:12px;overflow:hidden;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:color-mix(in srgb,var(--danger-soft) 55%,var(--background));border:1px solid var(--danger-border);border-radius:8px}.document-error-header{padding:9px 13px 7px;color:var(--danger);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:750;letter-spacing:.08em;text-transform:uppercase}.document-error-item{display:grid;padding:10px 13px 11px;gap:5px;color:inherit;text-decoration:none}.document-error-item+.document-error-item{border-top:1px solid var(--danger-border)}.document-error-item:hover{background:color-mix(in srgb,var(--danger-soft) 75%,transparent)}.document-error-location{color:var(--danger);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:11px;font-weight:700}.document-error-message{color:var(--muted);font-size:12px;line-height:1.45;white-space:pre-wrap}.source-context{position:relative;z-index:1;width:calc(100% - 5.25rem);max-width:760px;margin:12px 16px 12px 4.25rem;overflow:visible;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:color-mix(in srgb,var(--code) 72%,transparent);border:1px solid var(--panel-border);border-radius:8px}.source-context.has-references:not(.references-open){margin-bottom:24px}.source-context-header{display:flex;min-height:36px;padding:7px 10px 7px 13px;align-items:center;gap:12px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:700;letter-spacing:.08em;text-transform:uppercase}.source-reference-toggle{position:relative;z-index:1;display:flex;height:0;align-items:center;gap:10px}.source-reference-toggle:before,.source-reference-toggle:after{height:1px;flex:1;content:"";background:var(--panel-border);visibility:hidden}.source-context.references-open .source-reference-toggle:before,.source-context.references-open .source-reference-toggle:after{visibility:visible}.source-reference-toggle button{display:inline-flex;padding:4px 7px;align-items:center;gap:6px;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:650;line-height:1.3;letter-spacing:.02em;text-transform:none;cursor:pointer;background:var(--accent-soft);border:0;border-radius:5px}.source-reference-toggle button:hover{color:var(--text)}.source-reference-toggle button>span{min-width:16px;padding:1px 4px;color:var(--muted);text-align:center;background:color-mix(in srgb,var(--background) 65%,transparent);border-radius:999px}.source-context-current{padding:0 13px 13px}.source-context-current>a,.source-reference-item>a{color:var(--text);text-decoration:none}.source-breadcrumbs{display:flex;align-items:center;gap:5px;overflow:hidden;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;font-weight:650;white-space:nowrap}.source-breadcrumbs>span{display:inline-flex;min-width:0;align-items:center;gap:5px}.source-breadcrumbs>span>span{color:var(--muted)}.source-context-current>a:hover .source-breadcrumbs,.source-reference-item>a:hover .source-breadcrumbs{text-decoration:underline;text-underline-offset:3px}.source-context-paragraph p{margin:8px 0 0;color:var(--text);font-size:13px;line-height:1.5}.source-context-paragraph a,.source-reference-paragraph a{text-underline-offset:2px}.source-reference-list{padding:17px 0 3px}.source-reference-item{padding:10px 13px}.source-reference-item+.source-reference-item{border-top:1px solid var(--panel-border)}.source-reference-paragraph p{margin:5px 0 0;color:var(--muted);font-size:12px;line-height:1.4}.source-code{max-width:100%;padding:10px 0;overflow-x:auto;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:13px;line-height:1.55;background:var(--code);border:1px solid var(--panel-border);border-radius:10px;overflow-anchor:none}.source-collapse{display:flex;min-width:max-content;min-height:34px;align-items:center;color:var(--muted);background:color-mix(in srgb,var(--panel) 52%,transparent);border-top:1px solid color-mix(in srgb,var(--panel-border) 72%,transparent);border-bottom:1px solid color-mix(in srgb,var(--panel-border) 72%,transparent)}.source-collapse:first-child{margin-top:-10px;border-top:0;border-radius:10px 10px 0 0}.source-collapse:last-child{margin-bottom:-10px;border-bottom:0;border-radius:0 0 10px 10px}.source-collapse>span{flex:0 0 4.25rem;padding-right:14px;text-align:right;-webkit-user-select:none;user-select:none}.source-collapse button{padding:6px 20px 6px 0;color:var(--muted);font:inherit;font-size:11px;cursor:pointer;background:transparent;border:0}.source-collapse button:hover{color:var(--accent)}.source-line{display:flex;min-width:max-content}.source-line.focused{background:color-mix(in srgb,var(--accent-soft) 72%,transparent)}.source-line-number{flex:0 0 4.25rem;padding-right:14px;color:var(--muted);text-align:right;-webkit-user-select:none;user-select:none}.source-line.focused .source-line-number{color:var(--accent)}.source-line-content{flex:1 0 auto;padding-right:20px;color:var(--text);white-space:pre}.source-code .hljs-comment,.source-code .hljs-quote{color:var(--syntax-comment);font-style:italic}.source-code .hljs-keyword,.source-code .hljs-literal,.source-code .hljs-selector-tag,.source-code .hljs-section{color:var(--syntax-keyword)}.source-code .hljs-string,.source-code .hljs-regexp,.source-code .hljs-addition,.source-code .hljs-attribute{color:var(--syntax-string)}.source-code .hljs-number,.source-code .hljs-symbol,.source-code .hljs-bullet{color:var(--syntax-number)}.source-code .hljs-title,.source-code .hljs-function,.source-code .hljs-class,.source-code .hljs-type{color:var(--syntax-title)}.source-code .hljs-built_in,.source-code .hljs-variable.language_,.source-code .hljs-meta{color:var(--syntax-built-in)}.source-code .hljs-deletion{color:#bd3d3d}.source-code .hljs-emphasis{font-style:italic}.source-code .hljs-strong{font-weight:700}.markdown{max-width:760px;font-size:16px;line-height:1.72}.markdown h1,.markdown h2,.markdown h3,.markdown h4{margin:2em 0 .65em;line-height:1.2;letter-spacing:-.025em;scroll-margin-top:24px}.section-back-reference-toggle{display:inline-flex;padding:3px 5px 3px 7px;margin-left:10px;align-items:center;gap:5px;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:650;line-height:1.3;letter-spacing:.01em;vertical-align:middle;cursor:pointer;background:var(--accent-soft);border:0;border-radius:5px}.section-back-reference-toggle:hover,.section-back-reference-toggle[aria-expanded=true]{color:var(--text)}.section-back-reference-count{min-width:16px;padding:1px 4px;color:var(--muted);text-align:center;background:color-mix(in srgb,var(--background) 65%,transparent);border-radius:999px}.section-back-reference-panel{margin:-.15em 0 1.5em;overflow:hidden;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:color-mix(in srgb,var(--code) 72%,transparent);border:1px solid var(--panel-border);border-radius:8px}.section-back-reference-panel[hidden]{display:none}.section-back-reference-header{padding:9px 13px 7px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;font-weight:700;letter-spacing:.08em;text-transform:uppercase}.section-back-reference-item{padding:10px 13px 11px}.section-back-reference-item+.section-back-reference-item{border-top:1px solid var(--panel-border)}.section-back-reference-location{display:inline-flex;align-items:center;gap:5px;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:12px;font-weight:650;line-height:1.35;text-decoration:none}.section-back-reference-location:hover{text-decoration:underline;text-underline-offset:3px}.section-back-reference-location>span[aria-hidden=true]{color:var(--muted)}.section-back-reference-paragraph p{margin:5px 0 0;color:var(--muted);font-size:12px;line-height:1.45}.section-back-reference-paragraph a{text-underline-offset:2px}.section-back-reference-code .code-link-language{margin-right:0;font-size:7px}.markdown .section-back-reference-code>code{display:block;padding:7px 9px;margin-top:7px;overflow-x:auto;color:var(--muted);font-size:11px;line-height:1.4;white-space:pre;border:1px solid color-mix(in srgb,var(--panel-border) 75%,transparent)}.markdown h1{margin-top:0;font-size:clamp(32px,5vw,46px)}.markdown h2{padding-top:.4em;font-size:26px;border-top:1px solid var(--panel-border)}.markdown h3{font-size:20px}.markdown p,.markdown ul,.markdown ol,.markdown blockquote,.markdown pre{margin:0 0 1.25em}.markdown li+li{margin-top:.35em}.markdown a{text-decoration-thickness:1px;text-underline-offset:3px}.markdown .markdown-error{color:var(--danger);scroll-margin-top:24px;text-decoration-color:currentColor}.markdown p.markdown-error,.markdown li.markdown-error,.markdown blockquote.markdown-error,.markdown pre.markdown-error,.markdown h1.markdown-error,.markdown h2.markdown-error,.markdown h3.markdown-error,.markdown h4.markdown-error,.markdown h5.markdown-error,.markdown h6.markdown-error{padding-left:10px;background:color-mix(in srgb,var(--danger-soft) 42%,transparent);box-shadow:inset 3px 0 0 var(--danger)}.markdown a.markdown-error,.markdown span.markdown-error{padding:.08em .2em;margin:-.08em -.2em;background:var(--danger-soft);border-radius:3px;box-decoration-break:clone;-webkit-box-decoration-break:clone}.markdown ins.git-added,.markdown del.git-removed{padding:.08em .12em;margin:-.08em -.04em;border-radius:3px;box-decoration-break:clone;-webkit-box-decoration-break:clone}.markdown ins.git-added{color:var(--success);text-decoration:none;background:var(--success-soft)}.markdown del.git-removed{color:var(--danger);background:var(--danger-soft);text-decoration-thickness:1px}.markdown p.git-added,.markdown blockquote.git-added,.markdown pre.git-added,.markdown h1.git-added,.markdown h2.git-added,.markdown h3.git-added,.markdown h4.git-added,.markdown h5.git-added,.markdown h6.git-added,.markdown li.git-added{padding-left:10px;color:var(--success);background:color-mix(in srgb,var(--success-soft) 55%,transparent);box-shadow:inset 3px 0 0 var(--success)}.markdown p.git-removed,.markdown div.git-removed,.markdown blockquote.git-removed,.markdown pre.git-removed,.markdown li.git-removed{padding-left:10px;color:var(--danger);text-decoration:line-through;background:color-mix(in srgb,var(--danger-soft) 55%,transparent);box-shadow:inset 3px 0 0 var(--danger)}.wiki-link-context{color:var(--muted)}a.wiki-link-segmented{text-decoration:none}a.wiki-link-segmented>.wiki-link-context,a.wiki-link-segmented>.wiki-link-leaf{text-decoration-line:underline;text-decoration-color:currentColor;text-decoration-thickness:1px;text-underline-offset:3px}.code-link-language{display:inline-flex;width:1.55em;height:1.55em;margin-right:.38em;align-items:center;justify-content:center;color:#fff;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.62em;font-style:normal;font-weight:800;line-height:1;text-decoration:none;vertical-align:.12em;background:var(--muted);border-radius:3px}.code-language-ts{background:#3178c6}.code-language-js{color:#25231f;background:#f0db4f}.code-language-py{background:#3776ab}.code-language-rs{background:#9a4b2f}.code-language-go{color:#15343b;background:#6ad7e5}.code-language-c{background:#5968ba}a.wiki-link-active{padding:.12em .28em;margin:-.12em -.28em;background:var(--accent-soft);border-radius:4px;box-decoration-break:clone;-webkit-box-decoration-break:clone}.markdown blockquote{margin-left:0;padding-left:18px;color:var(--muted);border-left:3px solid var(--panel-border)}.markdown code{padding:.16em .36em;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:.9em;background:var(--code);border-radius:5px}.markdown pre{padding:18px 20px;overflow-x:auto;background:var(--code);border:1px solid var(--panel-border);border-radius:10px}.markdown pre code{padding:0;background:transparent}.markdown img{max-width:100%}.markdown hr{margin:2.5em 0;border:0;border-top:1px solid var(--panel-border)}.visually-hidden{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;white-space:nowrap;border:0;clip:rect(0,0,0,0)}.search-page{width:100%;max-width:760px}.search-input-shell{display:flex;height:52px;padding:0 16px;align-items:center;gap:11px;color:var(--muted);background:var(--panel);border:1px solid var(--panel-border);border-radius:10px;box-shadow:0 1px 1px color-mix(in srgb,var(--text) 5%,transparent)}.search-input-shell:focus-within{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 55%,var(--panel-border));box-shadow:0 0 0 3px color-mix(in srgb,var(--accent) 12%,transparent)}.search-input-shell svg{width:20px;height:20px;flex:0 0 auto;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:1.8}.search-input-shell input{width:100%;min-width:0;padding:0;color:var(--text);font:inherit;font-size:17px;line-height:1;background:transparent;border:0;outline:0}.search-input-shell input::placeholder{color:var(--muted)}.search-input-shell input::-webkit-search-cancel-button{cursor:pointer}.search-status{min-height:42px;padding:12px 2px 8px;color:var(--muted);font-size:12px}.search-results{display:grid;gap:10px}.search-result{display:block;padding:16px 18px;color:var(--text);text-decoration:none;background:color-mix(in srgb,var(--panel) 72%,transparent);border:1px solid var(--panel-border);border-radius:9px;transition:border-color .12s ease,background .12s ease,transform .12s ease}.search-result:hover{background:var(--panel);border-color:color-mix(in srgb,var(--accent) 38%,var(--panel-border));transform:translateY(-1px)}.search-result-breadcrumbs{display:flex;align-items:center;gap:5px;overflow:hidden;color:var(--accent);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:11px;font-weight:650;white-space:nowrap}.search-result-breadcrumbs>span{display:inline-flex;min-width:0;align-items:center;gap:5px}.search-result-breadcrumbs>span>span{color:var(--muted)}.search-result h2{margin:7px 0 0;font-size:18px;line-height:1.3;letter-spacing:-.015em}.search-result p{margin:6px 0 0;color:var(--muted);font-size:13px;line-height:1.5}.state{display:flex;min-height:50vh;align-items:center;justify-content:center;color:var(--muted)}.state.error{flex-direction:column;gap:8px;text-align:center}.state.error strong{color:var(--text)}@media(max-width:760px){.app-shell{display:block}.sidebar{position:static;width:100%;height:auto;padding:18px;border-right:0;border-bottom:1px solid var(--panel-border)}.sidebar-header{margin-bottom:18px}.sidebar nav{display:none}.main{padding-top:28px}.source-context{width:calc(100% - 24px);margin-right:12px;margin-left:12px}}