@plebeiantech/lat.md 0.12.3-fork.9 → 0.13.4-fork.1

package/dist/src/cli/context.d.ts

@@ -1,11 +0,0 @@
-import type { CmdContext, Styler } from '../context.js';
-export type { CmdContext };
-export declare function makeStyler(): Styler;
-export declare function resolveContext(opts: {
-    dir?: string;
-    color?: boolean;
-}): CmdContext;
-export declare function resolveCheckContext(opts: {
-    dir?: string;
-    color?: boolean;
-}, target?: string): CmdContext;

package/dist/src/cli/context.js

@@ -1,58 +0,0 @@
-import { statSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { styleText } from 'node:util';
-import { findLatticeDir } from '../lattice.js';
-export function makeStyler() {
-    return {
-        bold: (s) => styleText('bold', s),
-        dim: (s) => styleText('dim', s),
-        red: (s) => styleText('red', s),
-        cyan: (s) => styleText('cyan', s),
-        white: (s) => styleText('white', s),
-        green: (s) => styleText('green', s),
-        yellow: (s) => styleText('yellow', s),
-        boldWhite: (s) => styleText(['bold', 'white'], s),
-    };
-}
-export function resolveContext(opts) {
-    const color = opts.color !== false;
-    if (!color) {
-        process.env.NO_COLOR = '1';
-    }
-    const latDir = findLatticeDir(opts.dir) ?? '';
-    if (!latDir) {
-        console.error(styleText('red', 'No lat.md directory found'));
-        console.error(styleText('dim', 'Run `lat init` to create one.'));
-        process.exit(1);
-    }
-    const projectRoot = dirname(latDir);
-    return { latDir, projectRoot, styler: makeStyler(), mode: 'cli' };
-}
-export function resolveCheckContext(opts, target) {
-    if (target === undefined)
-        return resolveContext(opts);
-    if (opts.color === false) {
-        process.env.NO_COLOR = '1';
-    }
-    const projectRoot = resolve(opts.dir ?? process.cwd());
-    const latDir = resolve(projectRoot, target);
-    try {
-        if (!statSync(latDir).isDirectory()) {
-            console.error(styleText('red', `Check target is not a directory: ${target}`));
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT')
-            throw error;
-        console.error(styleText('red', `Check directory not found: ${target}`));
-        process.exit(1);
-    }
-    return {
-        latDir,
-        projectRoot,
-        styler: makeStyler(),
-        mode: 'cli',
-        headless: true,
-    };
-}

package/dist/src/cli/expand.d.ts

@@ -1,8 +0,0 @@
-import { type Section } from '../lattice.js';
-import type { CmdContext, CmdResult } from '../context.js';
-/**
- * Resolve [[refs]] in text and return the expanded output.
- * Returns null if there are no wiki links, or if resolution fails.
- */
-export declare function expandPrompt(ctx: CmdContext, text: string, preloadedSections?: Section[]): Promise<string | null>;
-export declare function expandCommand(ctx: CmdContext, text: string): Promise<CmdResult>;

package/dist/src/cli/expand.js

@@ -1,94 +0,0 @@
-import { join, relative } from 'node:path';
-import { loadAllSections, findSections, } from '../lattice.js';
-import { UNTRUSTED_NOTICE, quoteUntrusted, cleanUntrustedId, } from '../untrusted.js';
-const WIKI_LINK_RE = /\[\[([^\]]+)\]\]/g;
-function formatLocation(section, projectRoot) {
-    const relPath = relative(process.cwd(), join(projectRoot, section.filePath));
-    return `${cleanUntrustedId(relPath)}:${section.startLine}-${section.endLine}`;
-}
-/**
- * Resolve [[refs]] in text and return the expanded output.
- * Returns null if there are no wiki links, or if resolution fails.
- */
-export async function expandPrompt(ctx, text, preloadedSections) {
-    const refs = [...text.matchAll(WIKI_LINK_RE)];
-    if (refs.length === 0)
-        return null;
-    const allSections = preloadedSections ?? (await loadAllSections(ctx.latDir));
-    const resolved = new Map();
-    const errors = [];
-    for (const match of refs) {
-        const target = match[1];
-        if (resolved.has(target))
-            continue;
-        const matches = findSections(allSections, target);
-        if (matches.length >= 1) {
-            resolved.set(target, {
-                target,
-                best: matches[0],
-                alternatives: matches.slice(1),
-            });
-        }
-        else {
-            errors.push(`No section found for [[${target}]]`);
-        }
-    }
-    if (errors.length > 0)
-        return null;
-    // Replace [[refs]] inline
-    let output = text.replace(WIKI_LINK_RE, (_match, target) => {
-        const ref = resolved.get(target);
-        return `[[${cleanUntrustedId(ref.best.section.id)}]]`;
-    });
-    // Append context block as nested outliner
-    output += '\n\n<lat-context>\n';
-    output += UNTRUSTED_NOTICE + '\n';
-    for (const ref of resolved.values()) {
-        const isExact = ref.best.reason === 'exact match' ||
-            ref.best.reason.startsWith('file stem expanded');
-        const all = isExact ? [ref.best] : [ref.best, ...ref.alternatives];
-        if (isExact) {
-            output += `* \`[[${ref.target}]]\` is referring to:\n`;
-        }
-        else {
-            output += `* \`[[${ref.target}]]\` might be referring to either of the following:\n`;
-        }
-        for (const m of all) {
-            const reason = isExact ? '' : ` (${cleanUntrustedId(m.reason)})`;
-            output += `  * [[${cleanUntrustedId(m.section.id)}]]${reason}\n`;
-            output += `    * ${formatLocation(m.section, ctx.projectRoot)}\n`;
-            if (m.section.firstParagraph) {
-                output += `    * ${quoteUntrusted(m.section.firstParagraph)}\n`;
-            }
-        }
-    }
-    output += '</lat-context>\n';
-    return output;
-}
-export async function expandCommand(ctx, text) {
-    const result = await expandPrompt(ctx, text);
-    if (result === null) {
-        const refs = [...text.matchAll(WIKI_LINK_RE)];
-        if (refs.length === 0) {
-            return { output: text };
-        }
-        // Resolution failed — find which ref is broken
-        const allSections = await loadAllSections(ctx.latDir);
-        for (const match of refs) {
-            const target = match[1];
-            const matches = findSections(allSections, target);
-            if (matches.length === 0) {
-                const s = ctx.styler;
-                return {
-                    output: s.red(`No section found for [[${target}]]`) +
-                        ' (no exact, substring, or fuzzy matches).\n' +
-                        s.dim('Ask the user to correct the reference.'),
-                    isError: true,
-                };
-            }
-        }
-        // All refs matched individually but expansion still failed — shouldn't happen
-        return { output: text };
-    }
-    return { output: result };
-}

package/dist/src/cli/gen-index.d.ts

@@ -1,45 +0,0 @@
-export declare function mdEscapeLabel(value: string): string;
-export declare function mdEscapeDest(value: string): string;
-export type IndexEntrySource = {
-    /** Filesystem entry name: "notes.md" for a file, "guides" for a directory. */
-    name: string;
-    /**
-     * Link destination relative to the index file being written: the child's
-     * own filename ("notes.md"), or its own index file for a directory
-     * ("guides/guides.md"). This is what actually resolves on disk — unlike
-     * the wiki-link stem, it keeps the .md extension.
-     */
-    dest: string;
-    /** Absolute path to read the title/summary from (the file itself, or a directory's own index file). */
-    readFrom: string;
-};
-/**
- * Render the generated bullet list for a directory index, one entry per
- * child, sorted by title. Each entry links through the wiki-link stem
- * (`entryToStem`-compatible) using a real Markdown link so the title can
- * carry a human-written summary — which is exactly why it must be escaped:
- * the title is repository text landing inside `[...]`.
- */
-export declare function renderIndexEntries(entries: IndexEntrySource[]): Promise<string>;
-/**
- * Compute, for each line, whether it lies inside a fenced code block.
- * Marker and bullet-run detection must skip fenced lines — otherwise a
- * documentation example that shows the marker syntax (or a sample bullet
- * list) inside a ``` block gets mistaken for the real thing and rewritten.
- */
-export declare function fencedLineMask(lines: string[]): boolean[];
-export type SpliceResult = {
-    ok: true;
-    content: string;
-} | {
-    ok: false;
-    message: string;
-};
-/**
- * Splice a freshly rendered entry list into an index file's content inside
- * `<!-- lat:index:begin -->` / `<!-- lat:index:end -->` markers, preserving
- * everything outside that region byte for byte. An unmarked file is
- * migrated by wrapping the first contiguous run of local index entry
- * bullets; a malformed marker pair is refused rather than guessed at.
- */
-export declare function spliceIndexContent(existingContent: string | null, dirLabel: string, renderedList: string): SpliceResult;

package/dist/src/cli/gen-index.js

@@ -1,235 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { cleanUntrusted } from '../untrusted.js';
-import { isLatticeLocalDest } from './link-scheme.js';
-// Mirrors the two escaping rules in hooks/generate_docs_index.rb (see
-// lat-t1y.5). Both were found by a working exploit against that generator,
-// and the same exploit applies here: an index entry's title is repository
-// text (an H1 heading or a leading paragraph) placed into a generated
-// Markdown link, so it must be treated as untrusted the moment it is quoted.
-/**
- * Escape a link LABEL. Without this, a title of `Real](https://evil/)
- * [ignore` closes the generated link early and reopens it against an
- * attacker's URL, leaving the real target as the label of a second,
- * harmless-looking link. Backslash-escaping is CommonMark's own answer: each
- * of these renders as the literal character.
- */
-const MD_LABEL_SPECIALS = /([\\[\]()`])/g;
-export function mdEscapeLabel(value) {
-    return value.replace(MD_LABEL_SPECIALS, '\\$1');
-}
-/**
- * Escape a link DESTINATION. A destination does not escape the same way a
- * label does: a `)` anywhere ends the destination there, and CommonMark reads
- * a bare `\` in a destination as an escape for the punctuation after it.
- * Percent-encoding survives the round trip; backslash-escaping does not,
- * because a renderer that decodes `%5C` back to `\` does not then treat it as
- * an escape character again.
- *
- * `%` itself must be in the class too, or the encoding is not injective: a
- * file genuinely named `a%28b.md` would be emitted verbatim and then decoded
- * by the renderer to `a(b.md` — a link to a path that does not exist.
- */
-const MD_DEST_SPECIALS = /[()<>\s%\\]/g;
-export function mdEscapeDest(value) {
-    return value.replace(MD_DEST_SPECIALS, (c) => '%' + c.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0'));
-}
-function fallbackTitle(name) {
-    const stem = name.endsWith('.md') ? name.slice(0, -3) : name;
-    return stem.replace(/[-_]/g, ' ');
-}
-/**
- * Pull a title (first `# ` heading) and a summary (the paragraph that
- * follows it, or the document's own leading paragraph when it has no
- * heading) out of a document's raw text. Deliberately simple line scanning
- * rather than a full parse — good enough for index generation, and it avoids
- * depending on parseSections' heading-to-id machinery here.
- */
-async function titleAndSummary(readFrom, fallback) {
-    let content;
-    try {
-        content = await readFile(readFrom, 'utf-8');
-    }
-    catch {
-        return { title: fallback, summary: '(no summary yet)' };
-    }
-    const stripped = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '');
-    const lines = stripped.split(/\r?\n/);
-    let idx = 0;
-    while (idx < lines.length && lines[idx].trim() === '')
-        idx++;
-    let title = fallback;
-    if (idx < lines.length && /^#\s+\S/.test(lines[idx])) {
-        title = lines[idx].replace(/^#\s+/, '').trim();
-        idx++;
-    }
-    while (idx < lines.length && lines[idx].trim() === '')
-        idx++;
-    const paraLines = [];
-    while (idx < lines.length &&
-        lines[idx].trim() !== '' &&
-        !/^#{1,6}\s/.test(lines[idx]) &&
-        !/^- /.test(lines[idx])) {
-        paraLines.push(lines[idx]);
-        idx++;
-    }
-    const summary = paraLines.join(' ').trim();
-    return {
-        title: cleanUntrusted(title || fallback, 120),
-        summary: summary ? cleanUntrusted(summary, 300) : '(no summary yet)',
-    };
-}
-/**
- * Render the generated bullet list for a directory index, one entry per
- * child, sorted by title. Each entry links through the wiki-link stem
- * (`entryToStem`-compatible) using a real Markdown link so the title can
- * carry a human-written summary — which is exactly why it must be escaped:
- * the title is repository text landing inside `[...]`.
- */
-export async function renderIndexEntries(entries) {
-    const rendered = await Promise.all(entries.map(async (entry) => {
-        const { title, summary } = await titleAndSummary(entry.readFrom, fallbackTitle(entry.name));
-        return {
-            title,
-            line: `- [${mdEscapeLabel(title)}](${mdEscapeDest(entry.dest)}) — ${mdEscapeLabel(summary)}`,
-        };
-    }));
-    rendered.sort((a, b) => a.title.toLowerCase().localeCompare(b.title.toLowerCase()));
-    return rendered.map((r) => r.line).join('\n');
-}
-/** HTML comment markers delimiting the region `--fix` is allowed to rewrite. */
-const BEGIN_MARKER = '<!-- lat:index:begin -->';
-const END_MARKER = '<!-- lat:index:end -->';
-// Tolerant of a trailing \r so a CRLF file's marker lines still match —
-// `existingContent` is otherwise split on plain '\n' (see the module doc).
-const BEGIN_RE = /^<!-- lat:index:begin -->\r?$/;
-const END_RE = /^<!-- lat:index:end -->\r?$/;
-/**
- * True when `line` is a "local index entry bullet" per the shared predicate
- * documented in link-scheme.ts: the legacy wiki form, or a Markdown link
- * bullet whose destination names a child of this directory. This MUST agree
- * with `parseIndexEntries` in check.ts — both read the same bullets, and a
- * second, differently-behaved copy of the rule is exactly how they drift.
- */
-function isIndexEntryBulletLine(line) {
-    const trimmed = line.replace(/\r$/, '');
-    if (/^- \[\[/.test(trimmed))
-        return true;
-    const m = /^- \[(?:\\.|[^\]])*\]\(([^)]*)\)/.exec(trimmed);
-    if (!m)
-        return false;
-    return isLatticeLocalDest(m[1]);
-}
-/** A fenced code block delimiter line (opening or closing ``` or ~~~). */
-const FENCE_RE = /^ {0,3}(`{3,}|~{3,})/;
-/**
- * Compute, for each line, whether it lies inside a fenced code block.
- * Marker and bullet-run detection must skip fenced lines — otherwise a
- * documentation example that shows the marker syntax (or a sample bullet
- * list) inside a ``` block gets mistaken for the real thing and rewritten.
- */
-export function fencedLineMask(lines) {
-    const mask = new Array(lines.length).fill(false);
-    let inFence = false;
-    for (let i = 0; i < lines.length; i++) {
-        const isFenceDelim = FENCE_RE.test(lines[i].replace(/\r$/, ''));
-        if (isFenceDelim) {
-            // The delimiter line itself counts as "inside" so it can never be
-            // mistaken for a marker or entry bullet either.
-            mask[i] = true;
-            inFence = !inFence;
-        }
-        else {
-            mask[i] = inFence;
-        }
-    }
-    return mask;
-}
-/**
- * Splice a freshly rendered entry list into an index file's content inside
- * `<!-- lat:index:begin -->` / `<!-- lat:index:end -->` markers, preserving
- * everything outside that region byte for byte. An unmarked file is
- * migrated by wrapping the first contiguous run of local index entry
- * bullets; a malformed marker pair is refused rather than guessed at.
- */
-export function spliceIndexContent(existingContent, dirLabel, renderedList) {
-    const block = `${BEGIN_MARKER}\n${renderedList}\n${END_MARKER}`;
-    if (existingContent === null) {
-        return { ok: true, content: `${dirLabel} directory index.\n\n${block}\n` };
-    }
-    const lines = existingContent.replace(/\n$/, '').split('\n');
-    const fenced = fencedLineMask(lines);
-    const beginIdx = lines.findIndex((l, i) => !fenced[i] && BEGIN_RE.test(l));
-    // The end marker that matters is the first one AFTER begin (per the
-    // design contract). Fall back to the first end anywhere so an end marker
-    // with no begin at all is still detected and reported.
-    let endIdx = -1;
-    if (beginIdx !== -1) {
-        for (let i = beginIdx + 1; i < lines.length; i++) {
-            if (!fenced[i] && END_RE.test(lines[i])) {
-                endIdx = i;
-                break;
-            }
-        }
-    }
-    else {
-        endIdx = lines.findIndex((l, i) => !fenced[i] && END_RE.test(l));
-    }
-    if (beginIdx !== -1 || endIdx !== -1) {
-        if (beginIdx === -1) {
-            return {
-                ok: false,
-                message: 'found a "lat:index:end" marker with no matching "lat:index:begin" marker — fix the markers by hand before running --fix again',
-            };
-        }
-        if (endIdx === -1) {
-            return {
-                ok: false,
-                message: 'found a "lat:index:begin" marker with no matching "lat:index:end" marker — fix the markers by hand before running --fix again',
-            };
-        }
-        if (endIdx < beginIdx) {
-            return {
-                ok: false,
-                message: 'found a "lat:index:end" marker before the "lat:index:begin" marker — fix the markers by hand before running --fix again',
-            };
-        }
-        const before = lines.slice(0, beginIdx);
-        const after = lines.slice(endIdx + 1);
-        const rebuilt = [...before, block, ...after].join('\n');
-        return { ok: true, content: `${rebuilt}\n` };
-    }
-    // No markers at all: migrate. Find the first contiguous run of local index
-    // entry bullets and replace exactly that run with the marked block.
-    let runStart = -1;
-    let runEnd = -1;
-    for (let i = 0; i < lines.length; i++) {
-        if (!fenced[i] && isIndexEntryBulletLine(lines[i])) {
-            if (runStart === -1)
-                runStart = i;
-            runEnd = i;
-        }
-        else if (runStart !== -1) {
-            break;
-        }
-    }
-    if (runStart !== -1) {
-        const before = lines.slice(0, runStart);
-        const after = lines.slice(runEnd + 1);
-        const rebuilt = [...before, block, ...after].join('\n');
-        return { ok: true, content: `${rebuilt}\n` };
-    }
-    // No entry-bullet run: insert before the first heading, or append at the end.
-    const headingIdx = lines.findIndex((l, i) => !fenced[i] && /^#{2,6}\s/.test(l));
-    if (headingIdx !== -1) {
-        const before = lines.slice(0, headingIdx);
-        while (before.length > 0 && before[before.length - 1].trim() === '') {
-            before.pop();
-        }
-        const after = lines.slice(headingIdx);
-        const rebuilt = [...before, '', block, '', ...after].join('\n');
-        return { ok: true, content: `${rebuilt}\n` };
-    }
-    const trimmedExisting = lines.join('\n').replace(/\s+$/, '');
-    const rebuilt = trimmedExisting.length > 0 ? `${trimmedExisting}\n\n${block}` : block;
-    return { ok: true, content: `${rebuilt}\n` };
-}

package/dist/src/cli/link-scheme.d.ts

@@ -1,54 +0,0 @@
-/**
- * Decide whether a Markdown link destination points inside the lattice or
- * out at the wider world.
- *
- * This exists as its own module because two callers need the same answer and
- * a second, differently-behaved copy of the rule is exactly how the two
- * drift: `parseIndexEntries` in check.ts decides which index bullets are
- * generated entries, and `spliceIndexContent` in gen-index.ts decides which
- * bullets belong to the region `--fix` is allowed to rewrite. If those two
- * ever disagree about a line, `--fix` rewrites a bullet the checker does not
- * track, or leaves one it does.
- *
- * `localLinkTarget` in check.ts applies the same rule inline for
- * relative-link validation. It is upstream code and is deliberately left
- * alone here; if this ever moves upstream, that is the call site to fold in.
- */
-/**
- * True when `url` carries a URL scheme (`https:`, `mailto:`, `file:`) and is
- * therefore not a path inside the lattice.
- *
- * A Windows drive letter is the one case that looks like a scheme and is not
- * — `C:\docs\a.md` matches the scheme grammar because a drive letter is a
- * single ASCII letter followed by a colon. Treat it as a path, the same way
- * `localLinkTarget` does, so the two agree.
- */
-export declare function hasUrlScheme(url: string): boolean;
-/**
- * True when `url` is a destination the lattice can own: no scheme, and not
- * rooted at the filesystem root. A root-absolute path is excluded for the
- * same reason `localLinkTarget` excludes it — it names a location outside
- * the lattice tree, so it is never a child entry of a directory index.
- */
-export declare function isLatticeLocalDest(url: string): boolean;
-/**
- * Reduce a Markdown link destination to the name of the directory child it
- * refers to, or null when it refers to no child of this directory at all.
- *
- * The naive reading — take the first `/`-separated segment — is wrong in
- * four distinct ways, and each one was observed producing a bogus entry
- * name that `lat check` then reported as a stale entry that "does not
- * exist":
- *
- *   https://example.com/docs  ->  "https:"   a scheme is not a path segment
- *   ./notes.md                ->  "."        a no-op prefix is not a child
- *   ../siblings/x.md          ->  ".."       this escapes the directory
- *   notes.md#intro            ->  "notes.md#intro"  fragments are not names
- *
- * Order is load-bearing. The fragment and query are split off BEFORE
- * percent-decoding, and the path is split on `/` BEFORE decoding too, for
- * the same reason `localLinkTarget` does it: `%23` and `%2F` decode to `#`
- * and `/`, and decoding first would let a filename that legitimately
- * contains either one truncate or split itself.
- */
-export declare function indexEntryNameFromDest(dest: string): string | null;

package/dist/src/cli/link-scheme.js

@@ -1,101 +0,0 @@
-/**
- * Decide whether a Markdown link destination points inside the lattice or
- * out at the wider world.
- *
- * This exists as its own module because two callers need the same answer and
- * a second, differently-behaved copy of the rule is exactly how the two
- * drift: `parseIndexEntries` in check.ts decides which index bullets are
- * generated entries, and `spliceIndexContent` in gen-index.ts decides which
- * bullets belong to the region `--fix` is allowed to rewrite. If those two
- * ever disagree about a line, `--fix` rewrites a bullet the checker does not
- * track, or leaves one it does.
- *
- * `localLinkTarget` in check.ts applies the same rule inline for
- * relative-link validation. It is upstream code and is deliberately left
- * alone here; if this ever moves upstream, that is the call site to fold in.
- */
-/**
- * True when `url` carries a URL scheme (`https:`, `mailto:`, `file:`) and is
- * therefore not a path inside the lattice.
- *
- * A Windows drive letter is the one case that looks like a scheme and is not
- * — `C:\docs\a.md` matches the scheme grammar because a drive letter is a
- * single ASCII letter followed by a colon. Treat it as a path, the same way
- * `localLinkTarget` does, so the two agree.
- */
-export function hasUrlScheme(url) {
-    const u = url.trim();
-    if (/^[a-zA-Z]:\\/.test(u))
-        return false;
-    return /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(u);
-}
-/**
- * True when `url` is a destination the lattice can own: no scheme, and not
- * rooted at the filesystem root. A root-absolute path is excluded for the
- * same reason `localLinkTarget` excludes it — it names a location outside
- * the lattice tree, so it is never a child entry of a directory index.
- */
-export function isLatticeLocalDest(url) {
-    const u = url.trim();
-    if (u === '')
-        return false;
-    if (u.startsWith('/'))
-        return false;
-    return !hasUrlScheme(u);
-}
-/**
- * Reduce a Markdown link destination to the name of the directory child it
- * refers to, or null when it refers to no child of this directory at all.
- *
- * The naive reading — take the first `/`-separated segment — is wrong in
- * four distinct ways, and each one was observed producing a bogus entry
- * name that `lat check` then reported as a stale entry that "does not
- * exist":
- *
- *   https://example.com/docs  ->  "https:"   a scheme is not a path segment
- *   ./notes.md                ->  "."        a no-op prefix is not a child
- *   ../siblings/x.md          ->  ".."       this escapes the directory
- *   notes.md#intro            ->  "notes.md#intro"  fragments are not names
- *
- * Order is load-bearing. The fragment and query are split off BEFORE
- * percent-decoding, and the path is split on `/` BEFORE decoding too, for
- * the same reason `localLinkTarget` does it: `%23` and `%2F` decode to `#`
- * and `/`, and decoding first would let a filename that legitimately
- * contains either one truncate or split itself.
- */
-export function indexEntryNameFromDest(dest) {
-    if (!isLatticeLocalDest(dest))
-        return null;
-    const u = dest.trim();
-    const queryAt = u.indexOf('?');
-    const fragmentAt = u.indexOf('#');
-    const pathEnd = Math.min(queryAt === -1 ? u.length : queryAt, fragmentAt === -1 ? u.length : fragmentAt);
-    let path = u.slice(0, pathEnd);
-    // `./` contributes nothing to the path, and may be repeated.
-    while (path.startsWith('./'))
-        path = path.slice(2);
-    // `..` leaves the directory whose index this is, so whatever it names is
-    // by definition not a child of it.
-    if (path === '..' || path.startsWith('../'))
-        return null;
-    if (path === '' || path === '.')
-        return null;
-    const segment = path.split('/')[0];
-    if (segment === '')
-        return null;
-    let decoded;
-    try {
-        decoded = decodeURIComponent(segment);
-    }
-    catch {
-        decoded = segment;
-    }
-    // A percent-encoded `.` or `..` (e.g. `%2e%2e`) decodes to the same
-    // traversal segment the raw check above already rejects. Re-check after
-    // decoding so both spellings agree — this is a consistency fix, not a
-    // security one: parseIndexEntries only compares names, it never builds a
-    // filesystem path from one.
-    if (decoded === '.' || decoded === '..')
-        return null;
-    return decoded;
-}

package/dist/src/cli/locate.d.ts

@@ -1,2 +0,0 @@
-import type { CmdContext, CmdResult } from '../context.js';
-export declare function locateCommand(ctx: CmdContext, query: string): Promise<CmdResult>;

package/dist/src/cli/locate.js

@@ -1,17 +0,0 @@
-import { loadAllSections, findSections } from '../lattice.js';
-import { formatResultList } from '../format.js';
-export async function locateCommand(ctx, query) {
-    const stripped = query.replace(/^\[\[|\]\]$/g, '');
-    const sections = await loadAllSections(ctx.latDir);
-    const matches = findSections(sections, stripped);
-    if (matches.length === 0) {
-        const s = ctx.styler;
-        return {
-            output: s.red(`No sections matching "${stripped}" (no exact, substring, or fuzzy matches)`),
-            isError: true,
-        };
-    }
-    return {
-        output: formatResultList(ctx, `Sections matching "${stripped}":`, matches),
-    };
-}

package/dist/src/cli/refs.d.ts

@@ -1,22 +0,0 @@
-import { type Section, type SectionMatch } from '../lattice.js';
-import type { CmdContext, CmdResult } from '../context.js';
-export type Scope = 'md' | 'code' | 'md+code';
-export type RefsFound = {
-    kind: 'found';
-    target: Section;
-    mdRefs: SectionMatch[];
-    codeRefs: string[];
-};
-export type RefsError = {
-    kind: 'no-match';
-    suggestions: SectionMatch[];
-};
-export type RefsResult = RefsFound | RefsError;
-/**
- * Find all sections and code locations that reference a given section or
- * source file. Accepts section ids (full-path, short-form) and source file
- * paths (e.g. src/app.rs#foo). Source file queries match wiki links directly
- * without section resolution.
- */
-export declare function findRefs(ctx: CmdContext, query: string, scope: Scope): Promise<RefsResult>;
-export declare function refsCommand(ctx: CmdContext, query: string, scope: Scope): Promise<CmdResult>;