@plebeiantech/lat.md 0.12.3-fork.7 → 0.12.3-fork.9

package/dist/src/cli/check-mode.d.ts

@@ -9,4 +9,13 @@ export declare const MODE_DIRS: Record<DiataxisMode, string>;
  * content, so the `require-mode` gate below never asks one to declare a mode.
  */
 export declare function indexNameFor(dirName: string): string;
-export declare function checkMode(latticeDir: string, projectRoot?: string): Promise<CheckError[]>;
+export type CheckModeOptions = {
+    /**
+     * Enforce as if the root index said this, whatever it actually says. Used to
+     * price adoption — running once each way and taking the difference is what
+     * the offer in `lat init` reports, and it keeps that number defined by this
+     * checker rather than by a second copy of its rules.
+     */
+    requireMode?: boolean;
+};
+export declare function checkMode(latticeDir: string, projectRoot?: string, options?: CheckModeOptions): Promise<CheckError[]>;

package/dist/src/cli/check-mode.js

@@ -190,7 +190,7 @@ export function indexNameFor(dirName) {
     return dirName.endsWith('.md') ? dirName : dirName + '.md';
 }
 /**
- * Whether the root index turns the mode requirement on.
+ * What the root index says about the mode requirement.
  *
  * Opt-in, and deliberately read from the tree rather than from a flag or an
  * environment variable: the rule belongs to a documentation set, not to a
@@ -198,21 +198,36 @@ export function indexNameFor(dirName) {
  * `lat init` stamps the flag into the root index it scaffolds, so a project
  * set up after this exists is gated from its first commit while an older one
  * is untouched until someone adds the line.
+ *
+ * The raw value is returned rather than a boolean so the caller can tell an
+ * absent flag from one that was set to something this never reads. `yes` and
+ * `1` are strings to a YAML 1.2 parser, and enforcing nothing on them while
+ * saying nothing about them is how a project ends up believing the gate is on.
  */
-async function requireModeEnabled(latticeDir) {
+async function readRequireModeFlag(latticeDir) {
     const indexPath = join(latticeDir, indexNameFor(basename(latticeDir)));
     try {
         const content = await readFile(indexPath, 'utf-8');
-        return parseFrontmatter(content).raw['require-mode'] === true;
+        return parseFrontmatter(content).raw['require-mode'];
     }
     catch {
-        return false;
+        return undefined;
     }
 }
-export async function checkMode(latticeDir, projectRoot = dirname(latticeDir)) {
+export async function checkMode(latticeDir, projectRoot = dirname(latticeDir), options = {}) {
     const files = await listLatticeFiles(latticeDir);
     const errors = [];
-    const requireMode = await requireModeEnabled(latticeDir);
+    const flag = await readRequireModeFlag(latticeDir);
+    const requireMode = options.requireMode ?? flag === true;
+    if (flag !== undefined && typeof flag !== 'boolean') {
+        const indexPath = join(latticeDir, indexNameFor(basename(latticeDir)));
+        errors.push({
+            file: relative(process.cwd(), indexPath),
+            line: 1,
+            target: toPosix(relative(projectRoot, indexPath)).replace(/\.md$/, ''),
+            message: `require-mode is ${JSON.stringify(flag)} — it must be true or false.\n    Anything else is enforced as off, so the gate this line looks like it turns on is not running.`,
+        });
+    }
     for (const file of files) {
         const content = await readFile(file, 'utf-8');
         const relPath = relative(process.cwd(), file);

package/dist/src/cli/fork-scaffold.d.ts

@@ -1,31 +1,88 @@
+/** What the root index says about the gate today. */
+export type RequireModeState = 'on' | 'off' | 'unset' | 'invalid';
 /**
- * Turn the gate on in a root index, whatever frontmatter it already has.
+ * Read the gate straight from a root index's frontmatter.
  *
- * Bailing on any existing frontmatter — the first version of this — produced a
- * silent no-op: a root index carrying `lat: tags: [...]` could never opt in,
- * and `lat init` re-offered on every run because the flag it had just written
- * was not there. Merging is what makes the offer terminate.
+ * Four states rather than a boolean, because `checkMode` enforces on `=== true`
+ * and anything looser here disagrees with it. A root index reading
+ * `require-mode: yes` is a string to this parser: treating that as "set" left
+ * the user believing the gate was on, `checkMode` enforcing nothing, and the
+ * one prompt that would have said so permanently silenced by the same value.
+ * `invalid` is reported rather than assumed either way.
+ */
+export declare function requireModeState(content: string): RequireModeState;
+/** What `planRequireMode` decided, before anything is written or asked. */
+export type StampPlan = 
+/** Already `true`; nothing to do. */
+{
+    kind: 'on';
+}
+/** Explicitly `false`. A deliberate opt-out is not re-offered. */
+ | {
+    kind: 'off';
+}
+/** The edited document, ready to write. */
+ | {
+    kind: 'stamped';
+    content: string;
+    movedRootKey: boolean;
+}
+/** Present but neither `true` nor `false`. */
+ | {
+    kind: 'invalid';
+    detail: string;
+}
+/** The frontmatter does not parse, so no field on it is read at all. */
+ | {
+    kind: 'unparseable';
+    detail: string;
+}
+/** `lat:` holds something that cannot carry a mapping key. */
+ | {
+    kind: 'unsupported';
+    detail: string;
+};
+/**
+ * Decide what turning the gate on in this document would do, without doing it.
+ *
+ * Parsed and re-emitted through the YAML document API rather than edited line
+ * by line. Line surgery looked cheaper — it preserves the file byte for byte
+ * except where it inserts — but it has to answer, from raw text, every question
+ * the parser already answers: which line opens the block, which lines are the
+ * `lat:` mapping's own children rather than a later key's, how far they are
+ * indented, and whether the value on the `lat:` line is a flow mapping, an
+ * anchor or a block scalar. Each wrong answer was its own defect: a flow
+ * mapping and an anchor were refused although both merge cleanly, an empty
+ * `lat:` beside a sibling list was refused because the scan walked past the end
+ * of the block, and one shape produced frontmatter that no longer parsed at
+ * all. `parseDocument` answers all of it, and round-trips comments and blank
+ * lines while doing so.
  *
- * Edited line by line rather than parsed and re-emitted, because re-emitting
- * reformats the whole block and discards its comments. The one shape that
- * cannot be edited safely — `lat:` carrying a flow mapping on its own line —
- * is returned unchanged, and the caller falls back to printing the edit.
+ * The one thing the document API does not give for free is that the fields
+ * already there survive, so that is asserted below rather than assumed.
  */
+export declare function planRequireMode(content: string): StampPlan;
+/** The edited document when the gate can be turned on, the input when not. */
 export declare function stampRequireMode(content: string): string;
-/** Whether the gate is on, read straight from a root index's frontmatter. */
-export declare function requireModeSet(content: string): boolean;
 /**
  * Append the four mode directories to the root index.
  *
  * Without this a fresh `lat init` leaves `lat check index` reporting four
  * missing entries, which is a poor first impression of a tool whose whole
- * pitch is that the check passes.
+ * pitch is that the check passes. Each directory is tested for separately: an
+ * index that already links `reference/` used to suppress the other three, so
+ * the three unlinked directories this had just created turned a passing
+ * `lat check index` into a failing one.
  */
 export declare function listModeDirs(content: string): string;
 /**
- * Scaffold the four mode directories and turn the gate on. Called only on the
- * run that creates `lat.md/`, so an existing tree is never restructured
- * underneath its owner.
+ * Scaffold the four mode directories and turn the gate on.
+ *
+ * Nothing at all happens when the gate cannot land in the root index. A tree
+ * left with four new directories and the gate still off is worse than one left
+ * alone: `checkMode` passes on it, so nothing ever says the adoption stopped
+ * half way — and if the index was not rewritten to list them, `lat check index`
+ * fails instead, on four directories the user never asked for.
  */
 export declare function writeForkScaffold(latDir: string): void;
 /**
@@ -36,9 +93,14 @@ export declare function writeForkScaffold(latDir: string): void;
  * for every project that needs it. Restructuring someone's tree without asking
  * is still wrong, so this asks.
  *
- * Silent when the flag is already set, when a previous run was told no, and
- * when there is no TTY to ask — the non-interactive path prints the count and
- * the manual edit instead, and records nothing, so a later interactive run
- * still offers.
+ * Whether the flag *can* be written is decided before anything is asked and
+ * before anything is written. Asking first cost a tree four directories and a
+ * rewritten index in exchange for a gate that never landed, and the user was
+ * told in the same breath that nothing could be edited.
+ *
+ * Silent when the flag is already set either way, when a previous run was told
+ * no, and when there is no TTY to ask — the non-interactive path prints the
+ * count and the manual edit instead, and records nothing, so a later
+ * interactive run still offers.
  */
 export declare function offerRequireMode(latDir: string, interactive: boolean, ask: (message: string) => Promise<boolean>): Promise<void>;

package/dist/src/cli/fork-scaffold.js

@@ -1,8 +1,9 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { listLatticeFiles, parseFrontmatter } from '../lattice.js';
-import { basename, join, relative, sep } from 'node:path';
+import { basename, dirname, join } from 'node:path';
 import { styleText } from 'node:util';
-import { DIATAXIS_MODES, MODE_DIRS, indexNameFor } from './check-mode.js';
+import { isMap, isScalar, isSeq, parseDocument } from 'yaml';
+import { parseFrontmatter } from '../lattice.js';
+import { DIATAXIS_MODES, MODE_DIRS, checkMode, indexNameFor, } from './check-mode.js';
 /**
  * Give a freshly created `lat.md/` the Diátaxis shape, and turn the gate on.
  *
@@ -71,84 +72,213 @@ function indexBody(dir) {
         'from a decision belong in `how-to/`, and the facts it fixes belong in ' +
         '`reference/`.\n');
 }
+// ── Turning the gate on in a root index ──────────────────────────────
 /**
- * Turn the gate on in a root index, whatever frontmatter it already has.
+ * The frontmatter fence, copied from `parseFrontmatter` rather than written
+ * afresh.
  *
- * Bailing on any existing frontmatter — the first version of this — produced a
- * silent no-op: a root index carrying `lat: tags: [...]` could never opt in,
- * and `lat init` re-offered on every run because the flag it had just written
- * was not there. Merging is what makes the offer terminate.
+ * The two readers have to agree on what counts as frontmatter. When they did
+ * not — this pattern once required the closing fence to end its line, which
+ * upstream's does not — a root index closed with `----` was frontmatter to the
+ * parser and no frontmatter here, so a whole second block was prepended above
+ * the real one. The original block still sat in the file, still looked live,
+ * and every field it declared was silently no longer read.
+ */
+const FENCE = /^---\n([\s\S]*?)\n---/;
+/**
+ * `lineWidth: 0` stops long values being wrapped onto continuation lines, and
+ * `flowCollectionPadding: false` keeps `[a, b]` from becoming `[ a, b ]`. Both
+ * exist to keep the diff to the line that changed.
+ */
+const STRINGIFY = { flowCollectionPadding: false, lineWidth: 0 };
+/**
+ * Read the gate straight from a root index's frontmatter.
  *
- * Edited line by line rather than parsed and re-emitted, because re-emitting
- * reformats the whole block and discards its comments. The one shape that
- * cannot be edited safely — `lat:` carrying a flow mapping on its own line —
- * is returned unchanged, and the caller falls back to printing the edit.
+ * Four states rather than a boolean, because `checkMode` enforces on `=== true`
+ * and anything looser here disagrees with it. A root index reading
+ * `require-mode: yes` is a string to this parser: treating that as "set" left
+ * the user believing the gate was on, `checkMode` enforcing nothing, and the
+ * one prompt that would have said so permanently silenced by the same value.
+ * `invalid` is reported rather than assumed either way.
  */
-export function stampRequireMode(content) {
-    const fence = content.match(/^---\n([\s\S]*?)\n---[ \t]*(\r?\n|$)/);
+export function requireModeState(content) {
+    const value = parseFrontmatter(content).raw['require-mode'];
+    if (value === undefined)
+        return 'unset';
+    if (value === true)
+        return 'on';
+    if (value === false)
+        return 'off';
+    return 'invalid';
+}
+function shapeOf(node) {
+    if (isSeq(node))
+        return 'a list';
+    if (isScalar(node))
+        return `the value ${JSON.stringify(node.value)}`;
+    return 'something other than a mapping';
+}
+/**
+ * Decide what turning the gate on in this document would do, without doing it.
+ *
+ * Parsed and re-emitted through the YAML document API rather than edited line
+ * by line. Line surgery looked cheaper — it preserves the file byte for byte
+ * except where it inserts — but it has to answer, from raw text, every question
+ * the parser already answers: which line opens the block, which lines are the
+ * `lat:` mapping's own children rather than a later key's, how far they are
+ * indented, and whether the value on the `lat:` line is a flow mapping, an
+ * anchor or a block scalar. Each wrong answer was its own defect: a flow
+ * mapping and an anchor were refused although both merge cleanly, an empty
+ * `lat:` beside a sibling list was refused because the scan walked past the end
+ * of the block, and one shape produced frontmatter that no longer parsed at
+ * all. `parseDocument` answers all of it, and round-trips comments and blank
+ * lines while doing so.
+ *
+ * The one thing the document API does not give for free is that the fields
+ * already there survive, so that is asserted below rather than assumed.
+ */
+export function planRequireMode(content) {
+    const state = requireModeState(content);
+    if (state === 'on')
+        return { kind: 'on' };
+    if (state === 'off')
+        return { kind: 'off' };
+    if (state === 'invalid') {
+        const value = parseFrontmatter(content).raw['require-mode'];
+        return {
+            kind: 'invalid',
+            detail: `require-mode is ${JSON.stringify(value)}; it must be true or false`,
+        };
+    }
+    const fence = content.match(FENCE);
+    // Every branch below produces `stamped` and then falls through to the same
+    // gate. Returning early from any of them is how the last version let the
+    // "no frontmatter here" branch write a second block above frontmatter the
+    // parser was reading perfectly well.
+    let stamped;
+    let movedRootKey = false;
     if (!fence) {
-        return `---\nlat:\n  require-mode: true\n---\n\n${content.replace(/^\n+/, '')}`;
+        stamped = `---\nlat:\n  require-mode: true\n---\n\n${content.replace(/^\n+/, '')}`;
     }
-    const body = fence[1];
-    if (/^\s*require-mode\s*:/m.test(body))
-        return content;
-    const lines = body.split('\n');
-    const latAt = lines.findIndex((line) => /^lat\s*:/.test(line));
-    let merged;
-    if (latAt === -1) {
-        merged = [...lines, 'lat:', '  require-mode: true'];
+    else {
+        const doc = parseDocument(fence[1]);
+        if (doc.errors.length > 0) {
+            return {
+                kind: 'unparseable',
+                detail: doc.errors[0].message.split('\n')[0],
+            };
+        }
+        const node = doc.get('lat', true);
+        if (node === undefined || node === null) {
+            doc.set('lat', doc.createNode({ 'require-mode': true }));
+        }
+        else if (isScalar(node) && node.value === null) {
+            // `lat:` with nothing under it. Replacing the key in place keeps its
+            // position and any comment attached to it.
+            doc.set('lat', doc.createNode({ 'require-mode': true }));
+        }
+        else if (isMap(node)) {
+            doc.setIn(['lat', 'require-mode'], true);
+        }
+        else {
+            return {
+                kind: 'unsupported',
+                detail: `\`lat:\` holds ${shapeOf(node)}, which cannot take \`require-mode\``,
+            };
+        }
+        // A root-level `require-mode` is dead — upstream reads fields only under
+        // `lat:` — and `checkFrontmatter` reports it as misplaced. Once the nested
+        // key exists that report stops firing, because the diagnostic asks whether
+        // the field is missing from `lat:`. Leaving the dead key behind would mean
+        // silently ending the one message that would ever have mentioned it, so it
+        // is moved rather than shadowed.
+        movedRootKey = doc.has('require-mode');
+        if (movedRootKey)
+            doc.delete('require-mode');
+        stamped = `---\n${doc.toString(STRINGIFY)}---${content.slice(fence[0].length)}`;
     }
-    else if (lines[latAt].replace(/^lat\s*:/, '').trim() !== '') {
-        // `lat: {mode: reference}` or `lat: &anchor` — a line-based insert would
-        // corrupt it, so say nothing and let the caller print the edit.
-        return content;
+    // The invariant, asserted rather than argued.
+    //
+    // Setting the flag is worth nothing if the merge quietly drops a field that
+    // was already there: an edit that lands `require-mode: true` and loses
+    // `require-code-mention: true` turns one check on and another off, and `lat
+    // check` then passes on a document that used to be enforced. Checking that
+    // the output parses is not enough to catch it — the losing edit parses fine.
+    // So every key read before must read back the same afterwards.
+    const before = parseFrontmatter(content);
+    const after = parseFrontmatter(stamped);
+    if ((after.problems ?? []).some((problem) => problem.kind === 'parse-error')) {
+        return {
+            kind: 'unsupported',
+            detail: 'the merged frontmatter did not parse',
+        };
     }
-    else {
-        // Siblings must share indentation, so take it from the existing first
-        // child rather than assuming two spaces.
-        const child = lines
-            .slice(latAt + 1)
-            .find((line) => line.trim() !== '' && /^\s/.test(line));
-        const indent = child ? (child.match(/^\s+/)?.[0] ?? '  ') : '  ';
-        merged = [
-            ...lines.slice(0, latAt + 1),
-            `${indent}require-mode: true`,
-            ...lines.slice(latAt + 1),
-        ];
+    if (after.raw['require-mode'] !== true) {
+        return {
+            kind: 'unsupported',
+            detail: 'the flag did not land where it is read',
+        };
     }
-    const end = fence[0].length;
-    return `---\n${merged.join('\n')}\n---${fence[2] || '\n'}${content.slice(end)}`;
+    for (const [key, value] of Object.entries(before.raw)) {
+        if (JSON.stringify(after.raw[key]) !== JSON.stringify(value)) {
+            return {
+                kind: 'unsupported',
+                detail: `the merge would change \`${key}\``,
+            };
+        }
+    }
+    return { kind: 'stamped', content: stamped, movedRootKey };
 }
-/** Whether the gate is on, read straight from a root index's frontmatter. */
-export function requireModeSet(content) {
-    return parseFrontmatter(content).raw['require-mode'] !== undefined;
+/** The edited document when the gate can be turned on, the input when not. */
+export function stampRequireMode(content) {
+    const plan = planRequireMode(content);
+    return plan.kind === 'stamped' ? plan.content : content;
 }
 /**
  * Append the four mode directories to the root index.
  *
  * Without this a fresh `lat init` leaves `lat check index` reporting four
  * missing entries, which is a poor first impression of a tool whose whole
- * pitch is that the check passes.
+ * pitch is that the check passes. Each directory is tested for separately: an
+ * index that already links `reference/` used to suppress the other three, so
+ * the three unlinked directories this had just created turned a passing
+ * `lat check index` into a failing one.
  */
 export function listModeDirs(content) {
-    const entries = DIATAXIS_MODES.map((mode) => {
-        const dir = MODE_DIRS[mode];
+    const missing = DIATAXIS_MODES.map((mode) => MODE_DIRS[mode]).filter((dir) => !content.includes(`(${dir}/`));
+    if (missing.length === 0)
+        return content;
+    const entries = missing
+        .map((dir) => {
         const { title, lead } = MODE_INDEX[dir];
         return `- [${title}](${dir}/${dir}.md) — ${lead}`;
-    }).join('\n');
-    if (content.includes(`(${MODE_DIRS.reference}/`))
-        return content;
+    })
+        .join('\n');
     let base = content;
     if (!base.endsWith('\n'))
         base += '\n';
-    return `${base}\nEvery document belongs in exactly one of these.\n\n${entries}\n`;
+    const intro = missing.length === DIATAXIS_MODES.length
+        ? '\nEvery document belongs in exactly one of these.\n\n'
+        : '\n';
+    return `${base}${intro}${entries}\n`;
 }
 /**
- * Scaffold the four mode directories and turn the gate on. Called only on the
- * run that creates `lat.md/`, so an existing tree is never restructured
- * underneath its owner.
+ * Scaffold the four mode directories and turn the gate on.
+ *
+ * Nothing at all happens when the gate cannot land in the root index. A tree
+ * left with four new directories and the gate still off is worse than one left
+ * alone: `checkMode` passes on it, so nothing ever says the adoption stopped
+ * half way — and if the index was not rewritten to list them, `lat check index`
+ * fails instead, on four directories the user never asked for.
  */
 export function writeForkScaffold(latDir) {
+    const rootIndex = join(latDir, indexNameFor(basename(latDir)));
+    const current = existsSync(rootIndex)
+        ? readFileSync(rootIndex, 'utf-8')
+        : null;
+    const stamped = current === null ? null : stampRequireMode(current);
+    if (stamped !== null && requireModeState(stamped) !== 'on')
+        return;
     const created = [];
     for (const mode of DIATAXIS_MODES) {
         const dir = MODE_DIRS[mode];
@@ -160,12 +290,10 @@ export function writeForkScaffold(latDir) {
         writeFileSync(indexPath, indexBody(dir));
         created.push(`${dir}/`);
     }
-    const rootIndex = join(latDir, indexNameFor(basename(latDir)));
-    if (existsSync(rootIndex)) {
-        const current = readFileSync(rootIndex, 'utf-8');
-        const stamped = listModeDirs(stampRequireMode(current));
-        if (stamped !== current)
-            writeFileSync(rootIndex, stamped);
+    if (current !== null && stamped !== null) {
+        const listed = listModeDirs(stamped);
+        if (listed !== current)
+            writeFileSync(rootIndex, listed);
     }
     if (created.length > 0) {
         console.log(styleText('green', 'Scaffolded Diátaxis modes') +
@@ -179,47 +307,94 @@ export function writeForkScaffold(latDir) {
  * Where a declined offer is remembered.
  *
  * Fork-owned rather than a field on upstream's `lat_init.json`, so recording
- * it costs no edit to `src/init-version.ts`. `lat.md/.cache/` is already in
- * the scaffolded `.gitignore`, so the marker stays out of the repository.
+ * it costs no edit to `src/init-version.ts`.
  */
-function declinePath(latDir) {
+function markerPath(latDir) {
     return join(latDir, '.cache', 'lat_fork.json');
 }
-function declined(latDir) {
+function readForkMeta(latDir) {
     try {
-        const raw = JSON.parse(readFileSync(declinePath(latDir), 'utf-8'));
-        return (typeof raw === 'object' &&
-            raw !== null &&
-            raw['require_mode_declined'] === true);
+        const raw = JSON.parse(readFileSync(markerPath(latDir), 'utf-8'));
+        // An array is an object too, and spreading one produces `{"0": ...}` —
+        // which then overwrites the file with something no reader understands.
+        if (typeof raw === 'object' && raw !== null && !Array.isArray(raw)) {
+            return raw;
+        }
     }
     catch {
-        return false;
+        // Absent or unreadable — nothing has been settled yet.
     }
+    return {};
 }
-function recordDecline(latDir) {
-    mkdirSync(join(latDir, '.cache'), { recursive: true });
-    writeFileSync(declinePath(latDir), JSON.stringify({ require_mode_declined: true }, null, 2) + '\n');
+function declined(latDir) {
+    return readForkMeta(latDir).require_mode_declined === true;
 }
-/** Documents the gate would reject today: not an index, no mode either way. */
-async function unmodedDocuments(latDir) {
-    const modeDirs = new Set(DIATAXIS_MODES.map((mode) => MODE_DIRS[mode]));
-    const files = await listLatticeFiles(latDir);
-    const offenders = [];
-    for (const file of files) {
-        const rel = relative(latDir, file).split(sep).join('/');
-        const segments = rel.split('/');
-        const fileName = segments.pop();
-        const holder = segments.length === 0 ? basename(latDir) : segments.at(-1);
-        if (fileName === indexNameFor(holder))
-            continue;
-        if (segments.length > 0 && modeDirs.has(segments[0]))
-            continue;
-        const declaredMode = parseFrontmatter(readFileSync(file, 'utf-8')).raw['mode'];
-        if (typeof declaredMode === 'string')
-            continue;
-        offenders.push(rel);
+/**
+ * Remember a no.
+ *
+ * The marker is a local answer, not a project fact: committed, it would tell
+ * every other clone that this project had already declined. `lat.md/.gitignore`
+ * covers `.cache/`, but that file is written only by the run that *creates*
+ * `lat.md/` — and this path exists for trees `lat init` did not create — so the
+ * cache is made to ignore itself rather than trusting a file that may not be
+ * there.
+ *
+ * Failure to record is reported and survived. This runs after the tree has
+ * already been restructured, and an unwritable cache directory is not a reason
+ * to abort `lat init` with a stack trace at that point.
+ */
+function recordDeclined(latDir) {
+    try {
+        const cacheDir = join(latDir, '.cache');
+        mkdirSync(cacheDir, { recursive: true });
+        const selfIgnore = join(cacheDir, '.gitignore');
+        if (!existsSync(selfIgnore))
+            writeFileSync(selfIgnore, '*\n');
+        writeFileSync(markerPath(latDir), JSON.stringify({ ...readForkMeta(latDir), require_mode_declined: true }, null, 2) + '\n');
+    }
+    catch (err) {
+        console.log('  ' +
+            styleText('dim', `Could not record the answer (${err.message}) — the offer will repeat.`));
+    }
+}
+/**
+ * What adopting the gate would newly cost, measured with the gate itself.
+ *
+ * Counted by running `checkMode` twice and taking the difference rather than
+ * by re-implementing its classification here. The hand-written version drifted
+ * immediately: it skipped every document inside a mode directory before
+ * reading what that document declared, so two files with byte-identical
+ * frontmatter were counted or not according to where they sat, and it reported
+ * one offender against two errors. Advertising a document as settled and then
+ * failing it is the failure worth avoiding, and only the checker knows.
+ */
+async function adoptionCost(latDir) {
+    const projectRoot = dirname(latDir);
+    const key = (error) => `${error.file}:${error.line}:${error.message}`;
+    const [gated, ungated] = await Promise.all([
+        checkMode(latDir, projectRoot, { requireMode: true }),
+        checkMode(latDir, projectRoot, { requireMode: false }),
+    ]);
+    const already = new Set(ungated.map(key));
+    return [
+        ...new Set(gated.filter((e) => !already.has(key(e))).map((e) => e.target)),
+    ];
+}
+/** Say what is wrong with a root index the gate cannot be written into. */
+function reportUnstampable(latDir, plan) {
+    const where = `${basename(latDir)}/${indexNameFor(basename(latDir))}`;
+    console.log('');
+    console.log(styleText('bold', 'Diátaxis modes'));
+    console.log('  ' +
+        styleText('dim', `require-mode cannot be set in ${where}: `) +
+        ('detail' in plan ? plan.detail : ''));
+    if (plan.kind === 'unparseable') {
+        // Worth more than the offer that prompted it. Every `lat:` field on a
+        // document whose frontmatter does not parse is silently ignored, so this
+        // root index is already not being read.
+        console.log('  ' +
+            styleText('dim', 'Until that parses, no `lat:` field on this document is read at all.'));
     }
-    return offenders;
 }
 /**
  * Offer the gate to a tree `lat init` did not create.
@@ -229,20 +404,39 @@ async function unmodedDocuments(latDir) {
  * for every project that needs it. Restructuring someone's tree without asking
  * is still wrong, so this asks.
  *
- * Silent when the flag is already set, when a previous run was told no, and
- * when there is no TTY to ask — the non-interactive path prints the count and
- * the manual edit instead, and records nothing, so a later interactive run
- * still offers.
+ * Whether the flag *can* be written is decided before anything is asked and
+ * before anything is written. Asking first cost a tree four directories and a
+ * rewritten index in exchange for a gate that never landed, and the user was
+ * told in the same breath that nothing could be edited.
+ *
+ * Silent when the flag is already set either way, when a previous run was told
+ * no, and when there is no TTY to ask — the non-interactive path prints the
+ * count and the manual edit instead, and records nothing, so a later
+ * interactive run still offers.
  */
 export async function offerRequireMode(latDir, interactive, ask) {
     const rootIndex = join(latDir, indexNameFor(basename(latDir)));
     if (!existsSync(rootIndex))
         return;
-    if (requireModeSet(readFileSync(rootIndex, 'utf-8')))
+    let current;
+    try {
+        current = readFileSync(rootIndex, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    const plan = planRequireMode(current);
+    if (plan.kind === 'on' || plan.kind === 'off')
+        return;
+    if (plan.kind !== 'stamped') {
+        // Not recorded and not silenced: this is a defect in the document with a
+        // fix the user can apply, and it stops being printed the moment they do.
+        reportUnstampable(latDir, plan);
         return;
+    }
     if (declined(latDir))
         return;
-    const offenders = await unmodedDocuments(latDir);
+    const offenders = await adoptionCost(latDir);
     console.log('');
     console.log(styleText('bold', 'Diátaxis modes'));
     console.log('  ' +
@@ -274,23 +468,19 @@ export async function offerRequireMode(latDir, interactive, ask) {
     }
     console.log('');
     if (!(await ask('  Turn require-mode on for this project?'))) {
-        recordDecline(latDir);
+        recordDeclined(latDir);
         console.log('  ' +
             styleText('dim', 'Skipped. Add') +
             ' require-mode: true ' +
             styleText('dim', 'to the root index whenever you want it.'));
         return;
     }
-    writeForkScaffold(latDir);
-    // The one frontmatter shape `stampRequireMode` refuses to edit. Saying so
-    // beats re-offering forever on a flag that never lands.
-    if (!requireModeSet(readFileSync(rootIndex, 'utf-8'))) {
+    writeFileSync(rootIndex, plan.content);
+    if (plan.movedRootKey) {
         console.log('  ' +
-            styleText('yellow', 'Could not edit the frontmatter safely.') +
-            styleText('dim', ' Add this under its `lat:` mapping by hand:'));
-        console.log('    ' + styleText('cyan', 'require-mode: true'));
-        return;
+            styleText('dim', 'Moved the stray root-level require-mode under `lat:`, where it is read.'));
     }
+    writeForkScaffold(latDir);
     if (offenders.length > 0) {
         console.log('  ' +
             styleText('dim', 'Run') +

package/dist/src/search/index.js

@@ -5,11 +5,27 @@ import { loadAllSections, flattenSections } from '../lattice.js';
 function hashContent(text) {
     return createHash('sha256').update(text).digest('hex');
 }
-async function sectionContent(section, projectRoot) {
-    const filePath = join(projectRoot, section.filePath);
-    const content = await readFile(filePath, 'utf-8');
-    const lines = content.split('\n');
-    return lines.slice(section.startLine - 1, section.endLine).join('\n');
+/**
+ * Read each lat.md file once, keyed by project-relative path. Section text is
+ * sliced from these lines by range: reading the file per section instead is
+ * O(sections × file size) — a 3.5 MB file holding 12k sections was re-read 12k
+ * times (~42 GB of string work) on every search.
+ */
+async function loadFileLines(sections, projectRoot) {
+    const lines = new Map();
+    for (const { filePath } of sections) {
+        if (lines.has(filePath))
+            continue;
+        const content = await readFile(join(projectRoot, filePath), 'utf-8');
+        lines.set(filePath, content.split('\n'));
+    }
+    return lines;
+}
+function sectionContent(section, lines) {
+    return lines
+        .get(section.filePath)
+        .slice(section.startLine - 1, section.endLine)
+        .join('\n');
 }
 export async function indexSections(latDir, db, embedder, onProgress) {
     const projectRoot = dirname(latDir);
@@ -17,8 +33,9 @@ export async function indexSections(latDir, db, embedder, onProgress) {
     const flat = flattenSections(allSections);
     // Build current state: id -> { section, content, hash }
     const current = new Map();
+    const lines = await loadFileLines(flat, projectRoot);
     for (const s of flat) {
-        const text = await sectionContent(s, projectRoot);
+        const text = sectionContent(s, lines);
         current.set(s.id, { section: s, content: text, hash: hashContent(text) });
     }
     // Get existing hashes from DB

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

@@ -0,0 +1 @@
+:root{color:#171717;background:#fff;font-family:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-synthesis:none;text-rendering:optimizeLegibility;color-scheme:light dark;--background: #fff;--panel: #fafafa;--sidebar: #fafafa;--sidebar-selection: #eaeaea;--panel-border: #eaeaea;--text: #171717;--muted: #666;--accent: #171717;--accent-soft: #ededed;--link: #0070f3;--danger: #e5484d;--danger-soft: #ffebe9;--danger-border: #f3b8b8;--warning: #b7791f;--warning-soft: #fff4ce;--success: #2e7d46;--success-soft: #e9f9ee;--git-notification: #e47f19;--code: #f5f5f5;--context-surface: #f7f7f7;--inline-code: #ededed;--reference-control: #e5e5e5;--graph-document: #0070f3;--graph-code: #d97706;--syntax-built-in: #9a3f75;--syntax-comment: #737373;--syntax-keyword: #6c4bc2;--syntax-number: #a85414;--syntax-string: #397348;--syntax-title: #26649a}@media(prefers-color-scheme:dark){:root{color:#ededed;background:#000;--background: #000;--panel: #0a0a0a;--sidebar: #000;--sidebar-selection: #242424;--panel-border: #262626;--text: #ededed;--muted: #888;--accent: #fff;--accent-soft: #1f1f1f;--link: rgb(82, 168, 255);--danger: #ff6166;--danger-soft: #2a1314;--danger-border: #5c2628;--warning: #f5a623;--warning-soft: #2a210f;--success: #62c073;--success-soft: #12261a;--git-notification: #f0a044;--code: #111;--context-surface: #111;--inline-code: #1f1f1f;--reference-control: #262626;--graph-document: rgb(82, 168, 255);--graph-code: #f5a623;--syntax-built-in: #e6a2cc;--syntax-comment: #888;--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);-webkit-font-smoothing:antialiased}::selection{color:var(--background);background:var(--text)}a{color:var(--link)}.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(--sidebar);border-right:0}.sidebar-header{display:flex;margin:0 2px 34px 10px;align-items:center;justify-content:space-between}.mobile-navigation-trigger{display:none}.brand{display:inline-flex;min-width:0;align-items:center;overflow:hidden;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;text-overflow:ellipsis;white-space:nowrap}.brand-logo{display:block;width:auto;height:21px;flex:none}.brand span{color:inherit}.sidebar-actions{display:flex;flex:none;align-items:center;gap:3px}.sidebar-search,.sidebar-graph,.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-graph:hover,.sidebar-graph[aria-current=page],.sidebar-git:hover{color:var(--accent);background:var(--sidebar-selection)}.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(--sidebar)}.sidebar-search svg,.sidebar-graph 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:var(--sidebar-selection)}.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(--sidebar-selection)}.document-link.active{font-weight:650}.main{--document-gutter: clamp(28px, 3vw, 48px);--document-toc-gutter: calc(var(--document-gutter) + 16px);width:100%;max-width:1280px;min-width:0;padding:28px var(--document-gutter) 100px}.main.restoring-history-scroll{visibility:hidden}.document-header{max-width:760px;margin-bottom:34px}.document-layout{display:grid;grid-template-columns:minmax(0,760px) 286px;grid-template-areas:"document toc";gap:var(--document-toc-gutter);align-items:start}.document-column{grid-area:document;min-width:0}.document-toc{grid-area:toc;position:sticky;top:28px;height:calc(100vh - 56px);box-sizing:border-box;padding-right:16px;overflow:hidden}.document-toc-title{display:flex;width:100%;min-height:24px;padding:0;align-items:center;gap:9px;color:var(--muted);font-family:inherit;font-size:13px;font-weight:650;text-align:left;background:transparent;border:0}.document-toc-toggle{display:none}.document-toc-title svg{width:17px;height:17px;flex:0 0 auto;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:2}.document-toc-list{display:block;max-height:calc(100% - 38px);margin-top:14px;overflow-y:auto;overscroll-behavior:contain;border-left:1px solid var(--panel-border);scrollbar-width:none}.document-toc-list::-webkit-scrollbar{display:none}.document-toc-link{position:relative;display:flex;padding:7px 0 7px calc(14px + var(--toc-depth) * 13px);align-items:center;gap:7px;color:var(--muted);font-size:12.5px;font-weight:520;line-height:17px;text-decoration:none;transition:color .14s ease;overflow-wrap:anywhere}.document-toc-link-label{min-width:0;flex:1}.document-toc-states{display:inline-flex;padding-right:2px;flex:0 0 auto;align-items:center;gap:4px}.document-toc-state{width:6px;height:6px;border-radius:50%;box-shadow:0 0 0 2px color-mix(in srgb,currentColor 12%,transparent)}.document-toc-state.git{color:var(--git-notification);background:currentColor}.document-toc-state.error{color:var(--danger);background:currentColor}.document-toc-link:before{position:absolute;top:4px;bottom:4px;left:-1px;width:2px;content:"";background:transparent;border-radius:2px}.document-toc-link:hover{color:var(--text)}.document-toc-link[data-depth="1"]{font-weight:650}.document-toc-link[aria-current=location]{color:var(--link)}.document-toc-link[aria-current=location]:before{background:var(--link)}.document-metadata{display:flex;min-height:28px;align-items:center;gap:10px;flex-wrap:wrap}.document-path{min-width:0;overflow-wrap:anywhere;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:Geist,Geist Sans,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:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:var(--context-surface);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(--reference-control);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(--link);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}.document-metadata+.source-code{margin-top:14px}.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(--reference-control);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:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:var(--context-surface);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(--link);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{font-size:26px}.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{overflow-wrap:anywhere;text-decoration-line:underline;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 ul.git-added,.markdown ol.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 pre:has(>code.git-added){color:var(--success);background:color-mix(in srgb,var(--success-soft) 55%,var(--code));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 ul.git-removed,.markdown ol.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)}.markdown pre:has(>code.git-removed){color:var(--danger);text-decoration:line-through;background:color-mix(in srgb,var(--danger-soft) 55%,var(--code));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,a.wiki-link-code:not(.wiki-link-segmented) .code-link-leading{text-decoration-line:underline;text-decoration-color:currentColor;text-decoration-thickness:1px;text-underline-offset:3px}.wiki-link-ref-count{display:inline-flex;min-width:1.45em;height:1.45em;padding:0 .34em;margin-left:.4em;align-items:center;justify-content:center;color:var(--muted);font-size:.66em;font-style:normal;font-weight:750;line-height:1;text-decoration:none;vertical-align:.15em;background:color-mix(in srgb,var(--muted) 14%,transparent);border-radius:999px}.markdown a:hover .wiki-link-ref-count{color:var(--text)}.external-link-icon{display:inline-block;width:.78em;height:.78em;margin-left:.28em;vertical-align:.02em;background:currentColor;-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 3h6v6M10 14 21 3M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / contain no-repeat;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 3h6v6M10 14 21 3M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / contain no-repeat}.code-link-language{display:inline-flex;width:1.55em;height:1.55em;margin-right:.38em;align-items:center;justify-content:center;color:var(--background);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(--text);border-radius:3px}.code-link-leading{display:inline-flex;align-items:baseline;white-space:nowrap}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(--inline-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:6px;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:6px;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(--link);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)}.graph-shell{position:relative;height:100vh;overflow:hidden;background:var(--panel)}.graph-topbar{position:absolute;z-index:8;inset:0 auto auto 0;width:50%;height:84px;pointer-events:none}.graph-topbar-graph{display:flex;min-width:0;padding:0 28px;align-items:center;gap:14px;height:100%;pointer-events:auto}.graph-topbar-graph .graph-header{display:flex;min-width:0;flex:0 0 212px;align-items:center;justify-content:space-between}.graph-topbar-graph .graph-tools{min-width:0}.graph-workspace{display:grid;height:100vh;min-height:0;grid-template-columns:minmax(0,1fr) minmax(0,1fr)}.graph-pane,.graph-inspector{position:relative;min-width:0;min-height:0}.graph-pane{overflow:hidden;border-right:1px solid var(--panel-border)}.graph-canvas-shell,.graph-canvas{position:absolute;inset:0}.graph-canvas-shell{background:radial-gradient(circle at center,color-mix(in srgb,var(--accent-soft) 22%,transparent),transparent 58%),var(--panel)}.graph-tools{display:flex;min-width:0;flex:1 1 auto;align-items:center;gap:8px}.graph-filter{display:flex;min-width:100px;height:36px;flex:1 1 220px;align-items:center;background:color-mix(in srgb,var(--background) 72%,transparent);border:1px solid var(--panel-border);border-radius:8px}.graph-filter:focus-within{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)}.graph-filter input{width:auto;min-width:0;flex:1 1 auto;padding:0 12px;color:var(--text);font:inherit;font-size:13px;background:transparent;border:0;outline:0}.graph-filter input::placeholder{color:var(--muted)}.graph-kind-filters{display:flex;flex:0 0 auto;align-items:center;gap:5px}.graph-kind-filters label{position:relative;display:inline-flex;cursor:pointer}.graph-kind-filters input{position:absolute;opacity:0;pointer-events:none}.graph-kind-filters label span{padding:4px 7px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:700;text-transform:capitalize;background:color-mix(in srgb,var(--background) 82%,transparent);border:1px solid var(--panel-border);border-radius:999px;-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px)}.graph-kind-filters input:checked+span{color:var(--accent);background:var(--accent-soft);border-color:color-mix(in srgb,var(--accent) 30%,var(--panel-border))}.graph-kind-filters input:focus-visible+span{outline:2px solid var(--accent);outline-offset:2px}.graph-node-count{flex:0 0 auto;padding-right:10px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:650;white-space:nowrap}.graph-fit{position:absolute;z-index:4;right:18px;bottom:18px;padding:5px 8px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:700;cursor:pointer;background:color-mix(in srgb,var(--background) 84%,transparent);border:1px solid var(--panel-border);border-radius:6px;-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px)}.graph-fit:hover{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 35%,var(--panel-border))}.graph-legend{position:absolute;z-index:4;bottom:20px;left:18px;display:flex;gap:12px;color:var(--muted);font-size:9px;font-weight:650}.graph-legend span{display:inline-flex;align-items:center;gap:5px}.graph-legend span:before{width:6px;height:6px;content:"";background:currentColor;border-radius:50%}.graph-legend .document{color:var(--graph-document)}.graph-legend .code{color:var(--graph-code)}.graph-legend .document input:checked+span{color:var(--graph-document)}.graph-legend .code input:checked+span{color:var(--graph-code)}.graph-legend input:not(:checked)+span{opacity:.42}.graph-no-results{position:absolute;z-index:3;inset:0;display:flex;align-items:center;justify-content:center;color:var(--muted);font-size:12px;pointer-events:none}.graph-inspector{background:var(--panel)}.graph-inspector-scroll{height:100%;overflow-y:auto;overscroll-behavior:contain}.graph-inspector-empty{display:flex;height:100%;padding:40px;align-items:center;justify-content:center;color:var(--muted);font-size:12px;line-height:1.5;text-align:center}.graph-inspector-document,.graph-inspector-source{padding:28px 28px 80px}.graph-inspector-document .markdown{max-width:none}.graph-inspector-document>.document-metadata{margin-bottom:28px}.graph-inspector-source .source-context{width:calc(100% - 5.25rem)}.graph-state{height:calc(100vh - 84px);min-height:0}@media(prefers-reduced-motion:reduce){.document-toc-link,.document-toc-chevron{transition:none}}@media(max-width:1100px)and (min-width:64rem){.graph-topbar-graph{padding:0 18px 0 28px;gap:8px}.graph-node-count{display:none}}@media(max-width:1340px){.document-layout{display:flex;flex-direction:column;gap:0;align-items:stretch}.document-toc{position:static;width:100%;max-width:760px;height:auto;padding:0;margin-bottom:28px;overflow:visible}.document-toc-heading{display:none}.document-toc-toggle{display:flex;min-height:52px;padding:0 16px;cursor:pointer;background:var(--panel);border:1px solid var(--panel-border);border-radius:7px}.document-toc-toggle:hover,.document-toc-toggle[aria-expanded=true]{color:var(--text)}.document-toc-chevron{margin-left:auto;color:var(--muted);font-size:18px;line-height:1;transform:rotate(90deg);transition:transform .12s ease}.document-toc[data-expanded=true] .document-toc-chevron{transform:rotate(-90deg)}.document-toc-list{display:none;max-height:min(52vh,420px);padding:8px 0;margin-top:0;background:var(--panel);border:1px solid var(--panel-border);border-top:0;border-radius:0 0 7px 7px}.document-toc[data-expanded=true] .document-toc-toggle{border-radius:7px 7px 0 0}.document-toc[data-expanded=true] .document-toc-list{display:block}}@media(min-width:64rem)and (max-width:1340px){.sidebar-header{min-height:42px}.document-layout{display:grid;grid-template-columns:minmax(0,1fr) minmax(240px,286px);grid-template-areas:"metadata toc" "document document";column-gap:var(--document-toc-gutter);row-gap:34px;align-items:start}.document-column{display:contents}.document-header{grid-area:metadata;min-width:0;margin:0}.document-metadata,.document-toc-toggle{min-height:42px}.document-toc{grid-area:toc;position:relative;z-index:1;top:0;max-width:286px;margin:0}.document-toc-list{position:absolute;top:100%;right:0;left:0}.document-toc-states{padding-right:14px}.markdown{grid-area:document;min-width:0}}@media not (min-width:64rem){body.mobile-navigation-open{overflow:hidden}.app-shell{display:block}.sidebar{position:sticky;z-index:20;top:0;width:100%;height:104px;padding:0;overflow:visible;border-right:0;border-bottom:1px solid var(--panel-border)}.sidebar-header{height:48px;padding:0 16px;margin:0}.sidebar-header .brand{font-size:18px}.sidebar-header .brand-logo{height:18px}.sidebar-actions{gap:5px}.sidebar-search,.sidebar-graph,.sidebar-git{width:36px;height:36px}.mobile-navigation-trigger{display:flex;width:100%;height:56px;padding:0 18px;align-items:center;gap:13px;overflow:hidden;color:var(--muted);font:inherit;font-size:13px;text-align:left;cursor:pointer;background:transparent;border:0;border-top:1px solid var(--panel-border)}.mobile-navigation-trigger:hover,.mobile-navigation-trigger[aria-expanded=true]{color:var(--text)}.mobile-navigation-trigger svg{width:18px;height:18px;flex:0 0 auto;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:1.8}.mobile-navigation-context{display:flex;min-width:0;align-items:center;gap:9px}.mobile-navigation-context>span:first-child{color:var(--text);font-weight:600}.mobile-navigation-context>span[aria-hidden=true]{color:var(--muted)}.mobile-navigation-current{min-width:0;overflow:hidden;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;text-overflow:ellipsis;white-space:nowrap}.sidebar nav{display:none}.sidebar[data-mobile-navigation-open=true] nav{position:fixed;z-index:19;inset:104px 0 0;display:block;padding:16px 16px max(28px,env(safe-area-inset-bottom));overflow-y:auto;overscroll-behavior:contain;background:var(--sidebar);outline:0}.sidebar[data-mobile-navigation-open=true] .file-tree{max-width:560px;margin:0 auto}.sidebar[data-mobile-navigation-open=true] .tree-directory>summary,.sidebar[data-mobile-navigation-open=true] .document-link{min-height:44px;padding-top:10px;padding-bottom:10px}.main{--mobile-gutter: clamp(20px, 5vw, 48px);padding:28px clamp(20px,5vw,48px) 80px}.document-toc{position:sticky;z-index:10;top:104px;width:calc(100% + var(--mobile-gutter) * 2);max-width:none;margin:-28px calc(var(--mobile-gutter) * -1) 28px;background:var(--background)}.document-toc-toggle{min-height:56px;padding:0 var(--mobile-gutter);background:color-mix(in srgb,var(--background) 94%,transparent);border-top:0;border-right:0;border-left:0;border-radius:0;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px)}.document-toc[data-expanded=true] .document-toc-toggle{border-radius:0}.document-toc-list{max-height:calc(100vh - 160px);max-height:calc(100dvh - 160px);padding-right:var(--mobile-gutter);padding-left:var(--mobile-gutter);background:var(--background);border-right:0;border-left:0;border-radius:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown .markdown-error{scroll-margin-top:180px}.source-context{width:calc(100% - 24px);margin-right:12px;margin-left:12px}.graph-shell{height:auto;min-height:100vh;min-height:100dvh;overflow:visible}.graph-topbar{position:sticky;top:0;width:100%;height:auto;background:color-mix(in srgb,var(--panel) 92%,transparent);border-bottom:1px solid var(--panel-border);-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);pointer-events:auto}.graph-topbar-graph{min-height:64px;padding:10px 16px;border-right:0}.graph-topbar-graph .graph-header{flex-basis:190px}.graph-header .brand{font-size:18px}.graph-header .brand-logo{height:18px}.graph-header .sidebar-search,.graph-header .sidebar-graph,.graph-header .sidebar-git{width:36px;height:36px}.graph-workspace{display:block;height:auto}.graph-pane{height:min(58vh,520px);height:min(58svh,520px);min-height:320px;border-right:0;border-bottom:1px solid var(--panel-border)}.graph-canvas{touch-action:none}.graph-filter input{font-size:16px}.graph-kind-filters label span{min-height:32px;padding:7px 10px}.graph-fit{min-width:44px;min-height:32px}.graph-inspector{min-height:55vh;min-height:55svh}.graph-inspector-scroll{height:auto;overflow:visible}.graph-inspector-empty{min-height:45vh}.graph-inspector-document,.graph-inspector-source{padding-right:20px;padding-left:20px}.graph-inspector-source .source-context{width:calc(100% - 24px)}.graph-state{height:auto;min-height:50vh}}@media(max-width:600px){.main{--mobile-gutter: 18px;padding-right:18px;padding-left:18px}.markdown{font-size:15.5px}.markdown h1{font-size:32px}.markdown h2{font-size:24px}.graph-topbar-graph{flex-wrap:wrap}.graph-topbar-graph .graph-header,.graph-topbar-graph .graph-tools,.graph-filter{flex-basis:100%}.graph-pane{height:52vh;height:52svh;min-height:300px}}

package/dist/src/view/client/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="color-scheme" content="light dark" />
     <title>lat.md</title>
-    <script type="module" crossorigin src="/assets/index-VZwPPiFE.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-W8ktvNj9.css">
+    <script type="module" crossorigin src="/assets/index-KWi67IMz.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-C3iaZyYT.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plebeiantech/lat.md",
-  "version": "0.12.3-fork.7",
+  "version": "0.12.3-fork.9",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "license": "MIT",
@@ -27,11 +27,11 @@
     "templates"
   ],
   "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^25.3.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@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",
@@ -54,13 +54,13 @@
     "github-slugger": "^2.0.0",
     "ignore-walk": "^8.0.0",
     "mdast-util-to-markdown": "^2.1.0",
+    "rehype-sanitize": "^6.0.0",
+    "rehype-slug": "^6.0.0",
+    "rehype-stringify": "^10.0.1",
     "remark-frontmatter": "^5.0.0",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "remark-stringify": "^11.0.0",
-    "rehype-sanitize": "^6.0.0",
-    "rehype-slug": "^6.0.0",
-    "rehype-stringify": "^10.0.1",
     "unified": "^11.0.0",
     "unist-util-visit": "^5.0.0",
     "web-tree-sitter": "^0.26.6",

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

@@ -1 +0,0 @@
-:root{color:#171717;background:#fff;font-family:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;font-synthesis:none;text-rendering:optimizeLegibility;color-scheme:light dark;--background: #fff;--panel: #fafafa;--sidebar: #fafafa;--sidebar-selection: #eaeaea;--panel-border: #eaeaea;--text: #171717;--muted: #666;--accent: #171717;--accent-soft: #ededed;--link: #0070f3;--danger: #e5484d;--danger-soft: #ffebe9;--danger-border: #f3b8b8;--warning: #b7791f;--warning-soft: #fff4ce;--success: #2e7d46;--success-soft: #e9f9ee;--git-notification: #e47f19;--code: #f5f5f5;--context-surface: #f7f7f7;--inline-code: #ededed;--reference-control: #e5e5e5;--graph-document: #0070f3;--graph-code: #d97706;--syntax-built-in: #9a3f75;--syntax-comment: #737373;--syntax-keyword: #6c4bc2;--syntax-number: #a85414;--syntax-string: #397348;--syntax-title: #26649a}@media(prefers-color-scheme:dark){:root{color:#ededed;background:#000;--background: #000;--panel: #0a0a0a;--sidebar: #000;--sidebar-selection: #242424;--panel-border: #262626;--text: #ededed;--muted: #888;--accent: #fff;--accent-soft: #1f1f1f;--link: rgb(82, 168, 255);--danger: #ff6166;--danger-soft: #2a1314;--danger-border: #5c2628;--warning: #f5a623;--warning-soft: #2a210f;--success: #62c073;--success-soft: #12261a;--git-notification: #f0a044;--code: #111;--context-surface: #111;--inline-code: #1f1f1f;--reference-control: #262626;--graph-document: rgb(82, 168, 255);--graph-code: #f5a623;--syntax-built-in: #e6a2cc;--syntax-comment: #888;--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);-webkit-font-smoothing:antialiased}::selection{color:var(--background);background:var(--text)}a{color:var(--link)}.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(--sidebar);border-right:0}.sidebar-header{display:flex;margin:0 2px 34px 10px;align-items:center;justify-content:space-between}.mobile-navigation-trigger{display:none}.brand{display:inline-flex;min-width:0;align-items:center;overflow:hidden;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;text-overflow:ellipsis;white-space:nowrap}.brand-logo{display:block;width:auto;height:21px;flex:none}.brand span{color:inherit}.sidebar-actions{display:flex;flex:none;align-items:center;gap:3px}.sidebar-search,.sidebar-graph,.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-graph:hover,.sidebar-graph[aria-current=page],.sidebar-git:hover{color:var(--accent);background:var(--sidebar-selection)}.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(--sidebar)}.sidebar-search svg,.sidebar-graph 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:var(--sidebar-selection)}.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(--sidebar-selection)}.document-link.active{font-weight:650}.main{--document-gutter: clamp(28px, 3vw, 48px);--document-toc-gutter: calc(var(--document-gutter) + 16px);width:100%;max-width:1280px;min-width:0;padding:28px var(--document-gutter) 100px}.main.restoring-history-scroll{visibility:hidden}.document-header{max-width:760px;margin-bottom:34px}.document-layout{display:grid;grid-template-columns:minmax(0,760px) 286px;grid-template-areas:"document toc";gap:var(--document-toc-gutter);align-items:start}.document-column{grid-area:document;min-width:0}.document-toc{grid-area:toc;position:sticky;top:28px;height:calc(100vh - 56px);box-sizing:border-box;padding-right:16px;overflow:hidden}.document-toc-title{display:flex;width:100%;min-height:24px;padding:0;align-items:center;gap:9px;color:var(--muted);font-family:inherit;font-size:13px;font-weight:650;text-align:left;background:transparent;border:0}.document-toc-toggle{display:none}.document-toc-title svg{width:17px;height:17px;flex:0 0 auto;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:2}.document-toc-list{display:block;max-height:calc(100% - 38px);margin-top:14px;overflow-y:auto;overscroll-behavior:contain;border-left:1px solid var(--panel-border);scrollbar-width:none}.document-toc-list::-webkit-scrollbar{display:none}.document-toc-link{position:relative;display:flex;padding:7px 0 7px calc(14px + var(--toc-depth) * 13px);align-items:center;gap:7px;color:var(--muted);font-size:12.5px;font-weight:520;line-height:17px;text-decoration:none;transition:color .14s ease;overflow-wrap:anywhere}.document-toc-link-label{min-width:0;flex:1}.document-toc-states{display:inline-flex;padding-right:2px;flex:0 0 auto;align-items:center;gap:4px}.document-toc-state{width:6px;height:6px;border-radius:50%;box-shadow:0 0 0 2px color-mix(in srgb,currentColor 12%,transparent)}.document-toc-state.git{color:var(--git-notification);background:currentColor}.document-toc-state.error{color:var(--danger);background:currentColor}.document-toc-link:before{position:absolute;top:4px;bottom:4px;left:-1px;width:2px;content:"";background:transparent;border-radius:2px}.document-toc-link:hover{color:var(--text)}.document-toc-link[data-depth="1"]{font-weight:650}.document-toc-link[aria-current=location]{color:var(--link)}.document-toc-link[aria-current=location]:before{background:var(--link)}.document-metadata{display:flex;min-height:28px;align-items:center;gap:10px;flex-wrap:wrap}.document-path{min-width:0;overflow-wrap:anywhere;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:Geist,Geist Sans,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:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:var(--context-surface);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(--reference-control);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(--link);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}.document-metadata+.source-code{margin-top:14px}.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(--reference-control);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:Geist,Geist Sans,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:var(--context-surface);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(--link);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{font-size:26px}.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{overflow-wrap:anywhere;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 ul.git-added,.markdown ol.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 pre:has(>code.git-added){color:var(--success);background:color-mix(in srgb,var(--success-soft) 55%,var(--code));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 ul.git-removed,.markdown ol.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)}.markdown pre:has(>code.git-removed){color:var(--danger);text-decoration:line-through;background:color-mix(in srgb,var(--danger-soft) 55%,var(--code));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}.wiki-link-ref-count{display:inline-flex;min-width:1.45em;height:1.45em;padding:0 .34em;margin-left:.4em;align-items:center;justify-content:center;color:var(--muted);font-size:.66em;font-style:normal;font-weight:750;line-height:1;text-decoration:none;vertical-align:.15em;background:color-mix(in srgb,var(--muted) 14%,transparent);border-radius:999px}.markdown a:hover .wiki-link-ref-count{color:var(--text)}.external-link-icon{display:inline-block;width:.78em;height:.78em;margin-left:.28em;vertical-align:.02em;background:currentColor;-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 3h6v6M10 14 21 3M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / contain no-repeat;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M15 3h6v6M10 14 21 3M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E") center / contain no-repeat}.code-link-language{display:inline-flex;width:1.55em;height:1.55em;margin-right:.38em;align-items:center;justify-content:center;color:var(--background);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(--text);border-radius:3px}.code-link-leading{display:inline-flex;align-items:baseline;white-space:nowrap}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(--inline-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:6px;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:6px;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(--link);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)}.graph-shell{position:relative;height:100vh;overflow:hidden;background:var(--panel)}.graph-topbar{position:absolute;z-index:8;inset:0 auto auto 0;width:50%;height:84px;pointer-events:none}.graph-topbar-graph{display:flex;min-width:0;padding:0 28px;align-items:center;gap:14px;height:100%;pointer-events:auto}.graph-topbar-graph .graph-header{display:flex;min-width:0;flex:0 0 212px;align-items:center;justify-content:space-between}.graph-topbar-graph .graph-tools{min-width:0}.graph-workspace{display:grid;height:100vh;min-height:0;grid-template-columns:minmax(0,1fr) minmax(0,1fr)}.graph-pane,.graph-inspector{position:relative;min-width:0;min-height:0}.graph-pane{overflow:hidden;border-right:1px solid var(--panel-border)}.graph-canvas-shell,.graph-canvas{position:absolute;inset:0}.graph-canvas-shell{background:radial-gradient(circle at center,color-mix(in srgb,var(--accent-soft) 22%,transparent),transparent 58%),var(--panel)}.graph-tools{display:flex;min-width:0;flex:1 1 auto;align-items:center;gap:8px}.graph-filter{display:flex;min-width:100px;height:36px;flex:1 1 220px;align-items:center;background:color-mix(in srgb,var(--background) 72%,transparent);border:1px solid var(--panel-border);border-radius:8px}.graph-filter:focus-within{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)}.graph-filter input{width:auto;min-width:0;flex:1 1 auto;padding:0 12px;color:var(--text);font:inherit;font-size:13px;background:transparent;border:0;outline:0}.graph-filter input::placeholder{color:var(--muted)}.graph-kind-filters{display:flex;flex:0 0 auto;align-items:center;gap:5px}.graph-kind-filters label{position:relative;display:inline-flex;cursor:pointer}.graph-kind-filters input{position:absolute;opacity:0;pointer-events:none}.graph-kind-filters label span{padding:4px 7px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:700;text-transform:capitalize;background:color-mix(in srgb,var(--background) 82%,transparent);border:1px solid var(--panel-border);border-radius:999px;-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px)}.graph-kind-filters input:checked+span{color:var(--accent);background:var(--accent-soft);border-color:color-mix(in srgb,var(--accent) 30%,var(--panel-border))}.graph-kind-filters input:focus-visible+span{outline:2px solid var(--accent);outline-offset:2px}.graph-node-count{flex:0 0 auto;padding-right:10px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:650;white-space:nowrap}.graph-fit{position:absolute;z-index:4;right:18px;bottom:18px;padding:5px 8px;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:9px;font-weight:700;cursor:pointer;background:color-mix(in srgb,var(--background) 84%,transparent);border:1px solid var(--panel-border);border-radius:6px;-webkit-backdrop-filter:blur(10px);backdrop-filter:blur(10px)}.graph-fit:hover{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 35%,var(--panel-border))}.graph-legend{position:absolute;z-index:4;bottom:20px;left:18px;display:flex;gap:12px;color:var(--muted);font-size:9px;font-weight:650}.graph-legend span{display:inline-flex;align-items:center;gap:5px}.graph-legend span:before{width:6px;height:6px;content:"";background:currentColor;border-radius:50%}.graph-legend .document{color:var(--graph-document)}.graph-legend .code{color:var(--graph-code)}.graph-legend .document input:checked+span{color:var(--graph-document)}.graph-legend .code input:checked+span{color:var(--graph-code)}.graph-legend input:not(:checked)+span{opacity:.42}.graph-no-results{position:absolute;z-index:3;inset:0;display:flex;align-items:center;justify-content:center;color:var(--muted);font-size:12px;pointer-events:none}.graph-inspector{background:var(--panel)}.graph-inspector-scroll{height:100%;overflow-y:auto;overscroll-behavior:contain}.graph-inspector-empty{display:flex;height:100%;padding:40px;align-items:center;justify-content:center;color:var(--muted);font-size:12px;line-height:1.5;text-align:center}.graph-inspector-document,.graph-inspector-source{padding:28px 28px 80px}.graph-inspector-document .markdown{max-width:none}.graph-inspector-document>.document-metadata{margin-bottom:28px}.graph-inspector-source .source-context{width:calc(100% - 5.25rem)}.graph-state{height:calc(100vh - 84px);min-height:0}@media(prefers-reduced-motion:reduce){.document-toc-link,.document-toc-chevron{transition:none}}@media(max-width:1100px)and (min-width:64rem){.graph-topbar-graph{padding:0 18px 0 28px;gap:8px}.graph-node-count{display:none}}@media(max-width:1340px){.document-layout{display:flex;flex-direction:column;gap:0}.document-toc{position:static;width:100%;max-width:760px;height:auto;padding:0;margin-bottom:28px;overflow:visible}.document-toc-heading{display:none}.document-toc-toggle{display:flex;min-height:52px;padding:0 16px;cursor:pointer;background:var(--panel);border:1px solid var(--panel-border);border-radius:7px}.document-toc-toggle:hover,.document-toc-toggle[aria-expanded=true]{color:var(--text)}.document-toc-chevron{margin-left:auto;color:var(--muted);font-size:18px;line-height:1;transform:rotate(90deg);transition:transform .12s ease}.document-toc[data-expanded=true] .document-toc-chevron{transform:rotate(-90deg)}.document-toc-list{display:none;max-height:min(52vh,420px);padding:8px 0;margin-top:0;background:var(--panel);border:1px solid var(--panel-border);border-top:0;border-radius:0 0 7px 7px}.document-toc[data-expanded=true] .document-toc-toggle{border-radius:7px 7px 0 0}.document-toc[data-expanded=true] .document-toc-list{display:block}}@media not (min-width:64rem){body.mobile-navigation-open{overflow:hidden}.app-shell{display:block}.sidebar{position:sticky;z-index:20;top:0;width:100%;height:104px;padding:0;overflow:visible;border-right:0;border-bottom:1px solid var(--panel-border)}.sidebar-header{height:48px;padding:0 16px;margin:0}.sidebar-header .brand{font-size:18px}.sidebar-header .brand-logo{height:18px}.sidebar-actions{gap:5px}.sidebar-search,.sidebar-graph,.sidebar-git{width:36px;height:36px}.mobile-navigation-trigger{display:flex;width:100%;height:56px;padding:0 18px;align-items:center;gap:13px;overflow:hidden;color:var(--muted);font:inherit;font-size:13px;text-align:left;cursor:pointer;background:transparent;border:0;border-top:1px solid var(--panel-border)}.mobile-navigation-trigger:hover,.mobile-navigation-trigger[aria-expanded=true]{color:var(--text)}.mobile-navigation-trigger svg{width:18px;height:18px;flex:0 0 auto;fill:none;stroke:currentColor;stroke-linecap:round;stroke-width:1.8}.mobile-navigation-context{display:flex;min-width:0;align-items:center;gap:9px}.mobile-navigation-context>span:first-child{color:var(--text);font-weight:600}.mobile-navigation-context>span[aria-hidden=true]{color:var(--muted)}.mobile-navigation-current{min-width:0;overflow:hidden;color:var(--muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;text-overflow:ellipsis;white-space:nowrap}.sidebar nav{display:none}.sidebar[data-mobile-navigation-open=true] nav{position:fixed;z-index:19;inset:104px 0 0;display:block;padding:16px 16px max(28px,env(safe-area-inset-bottom));overflow-y:auto;overscroll-behavior:contain;background:var(--sidebar);outline:0}.sidebar[data-mobile-navigation-open=true] .file-tree{max-width:560px;margin:0 auto}.sidebar[data-mobile-navigation-open=true] .tree-directory>summary,.sidebar[data-mobile-navigation-open=true] .document-link{min-height:44px;padding-top:10px;padding-bottom:10px}.main{--mobile-gutter: clamp(20px, 5vw, 48px);padding:28px clamp(20px,5vw,48px) 80px}.document-toc{position:sticky;z-index:10;top:104px;width:calc(100% + var(--mobile-gutter) * 2);max-width:none;margin:-28px calc(var(--mobile-gutter) * -1) 28px;background:var(--background)}.document-toc-toggle{min-height:56px;padding:0 var(--mobile-gutter);background:color-mix(in srgb,var(--background) 94%,transparent);border-right:0;border-left:0;border-radius:0;-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px)}.document-toc[data-expanded=true] .document-toc-toggle{border-radius:0}.document-toc-list{max-height:calc(100vh - 160px);max-height:calc(100dvh - 160px);padding-right:var(--mobile-gutter);padding-left:var(--mobile-gutter);background:var(--background);border-right:0;border-left:0;border-radius:0}.markdown h1,.markdown h2,.markdown h3,.markdown h4,.markdown .markdown-error{scroll-margin-top:180px}.source-context{width:calc(100% - 24px);margin-right:12px;margin-left:12px}.graph-shell{height:auto;min-height:100vh;min-height:100dvh;overflow:visible}.graph-topbar{position:sticky;top:0;width:100%;height:auto;background:color-mix(in srgb,var(--panel) 92%,transparent);border-bottom:1px solid var(--panel-border);-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);pointer-events:auto}.graph-topbar-graph{min-height:64px;padding:10px 16px;border-right:0}.graph-topbar-graph .graph-header{flex-basis:190px}.graph-header .brand{font-size:18px}.graph-header .brand-logo{height:18px}.graph-header .sidebar-search,.graph-header .sidebar-graph,.graph-header .sidebar-git{width:36px;height:36px}.graph-workspace{display:block;height:auto}.graph-pane{height:min(58vh,520px);height:min(58svh,520px);min-height:320px;border-right:0;border-bottom:1px solid var(--panel-border)}.graph-canvas{touch-action:none}.graph-filter input{font-size:16px}.graph-kind-filters label span{min-height:32px;padding:7px 10px}.graph-fit{min-width:44px;min-height:32px}.graph-inspector{min-height:55vh;min-height:55svh}.graph-inspector-scroll{height:auto;overflow:visible}.graph-inspector-empty{min-height:45vh}.graph-inspector-document,.graph-inspector-source{padding-right:20px;padding-left:20px}.graph-inspector-source .source-context{width:calc(100% - 24px)}.graph-state{height:auto;min-height:50vh}}@media(max-width:600px){.main{--mobile-gutter: 18px;padding-right:18px;padding-left:18px}.markdown{font-size:15.5px}.markdown h1{font-size:32px}.markdown h2{font-size:24px}.graph-topbar-graph{flex-wrap:wrap}.graph-topbar-graph .graph-header,.graph-topbar-graph .graph-tools,.graph-filter{flex-basis:100%}.graph-pane{height:52vh;height:52svh;min-height:300px}}