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

package/dist/src/extensions/wiki-link/types.d.ts

@@ -1,34 +0,0 @@
-import type { Data, Literal } from 'mdast';
-/**
- * mdast node for a wiki-style link like [[target]] or [[target|alias]].
- */
-export interface WikiLink extends Literal {
-    type: 'wikiLink';
-    value: string;
-    data: Data & {
-        alias: string | null;
-    };
-}
-declare module 'mdast' {
-    interface RootContentMap {
-        wikiLink: WikiLink;
-    }
-    interface PhrasingContentMap {
-        wikiLink: WikiLink;
-    }
-}
-declare module 'micromark-util-types' {
-    interface TokenTypeMap {
-        wikiLink: 'wikiLink';
-        wikiLinkMarker: 'wikiLinkMarker';
-        wikiLinkData: 'wikiLinkData';
-        wikiLinkTarget: 'wikiLinkTarget';
-        wikiLinkAliasMarker: 'wikiLinkAliasMarker';
-        wikiLinkAlias: 'wikiLinkAlias';
-    }
-}
-declare module 'mdast-util-to-markdown' {
-    interface ConstructNameMap {
-        wikiLink: 'wikiLink';
-    }
-}

package/dist/src/format.d.ts

@@ -1,8 +0,0 @@
-import type { Section, SectionMatch } from './lattice.js';
-import type { CmdContext, Styler } from './context.js';
-export declare function formatSectionId(id: string, s: Styler): string;
-export declare function formatSectionPreview(ctx: CmdContext, section: Section, opts?: {
-    reason?: string;
-}): string;
-export declare function formatResultList(ctx: CmdContext, header: string, matches: SectionMatch[]): string;
-export declare function formatNavHints(ctx: CmdContext): string;

package/dist/src/format.js

@@ -1,43 +0,0 @@
-import { join, relative } from 'node:path';
-export function formatSectionId(id, s) {
-    const parts = id.split('#');
-    return parts.length === 1
-        ? s.boldWhite(parts[0])
-        : s.dim(parts.slice(0, -1).join('#') + '#') +
-            s.boldWhite(parts[parts.length - 1]);
-}
-export function formatSectionPreview(ctx, section, opts) {
-    const s = ctx.styler;
-    const relPath = relative(process.cwd(), join(ctx.projectRoot, section.filePath));
-    const kind = section.id.includes('#') ? 'Section' : 'File';
-    const reasonSuffix = opts?.reason ? ' ' + s.dim(`(${opts.reason})`) : '';
-    const lines = [
-        `${s.dim('*')} ${s.dim(kind + ':')} [[${formatSectionId(section.id, s)}]]${reasonSuffix}`,
-        `  ${s.dim('Defined in')} ${s.cyan(relPath)}${s.dim(`:${section.startLine}-${section.endLine}`)}`,
-    ];
-    if (section.firstParagraph) {
-        lines.push('', `  ${s.dim('>')} ${section.firstParagraph}`);
-    }
-    return lines.join('\n');
-}
-export function formatResultList(ctx, header, matches) {
-    const lines = ['', `## ${header}`, ''];
-    for (let i = 0; i < matches.length; i++) {
-        if (i > 0)
-            lines.push('');
-        lines.push(formatSectionPreview(ctx, matches[i].section, {
-            reason: matches[i].reason,
-        }));
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-export function formatNavHints(ctx) {
-    const s = ctx.styler;
-    const hints = ctx.mode === 'cli'
-        ? `${s.dim('*')} \`lat section "section#id"\` \u2014 show full content with outgoing/incoming refs\n` +
-            `${s.dim('*')} \`lat search "new query"\` \u2014 search for something else`
-        : `${s.dim('*')} \`lat_section\` \u2014 show full content with outgoing/incoming refs\n` +
-            `${s.dim('*')} \`lat_search\` \u2014 search for something else`;
-    return `\n## To navigate further:\n\n${hints}`;
-}

package/dist/src/init-version.d.ts

@@ -1,10 +0,0 @@
-/**
- * Bump this number whenever `lat init` setup or defaults change in a way that
- * requires users to re-run it (e.g. new hooks, generated files, MCP config, or
- * a configuration migration).
- */
-export declare const INIT_VERSION = 7;
-export declare function readInitVersion(latDir: string): number | null;
-export declare function readFileHash(latDir: string, relPath: string): string | null;
-export declare function contentHash(content: string): string;
-export declare function writeInitMeta(latDir: string, fileHashes: Record<string, string>): void;

package/dist/src/init-version.js

@@ -1,49 +0,0 @@
-import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/**
- * Bump this number whenever `lat init` setup or defaults change in a way that
- * requires users to re-run it (e.g. new hooks, generated files, MCP config, or
- * a configuration migration).
- */
-export const INIT_VERSION = 7;
-function cachePath(latDir) {
-    return join(latDir, '.cache', 'lat_init.json');
-}
-function readMeta(latDir) {
-    const p = cachePath(latDir);
-    if (!existsSync(p))
-        return null;
-    try {
-        return JSON.parse(readFileSync(p, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-export function readInitVersion(latDir) {
-    const meta = readMeta(latDir);
-    if (!meta)
-        return null;
-    return typeof meta.init_version === 'number' ? meta.init_version : null;
-}
-export function readFileHash(latDir, relPath) {
-    const meta = readMeta(latDir);
-    return meta?.file_hashes?.[relPath] ?? null;
-}
-export function contentHash(content) {
-    return createHash('sha256').update(content).digest('hex');
-}
-export function writeInitMeta(latDir, fileHashes) {
-    const cacheDir = join(latDir, '.cache');
-    mkdirSync(cacheDir, { recursive: true });
-    // Merge with existing hashes so we don't lose entries from agents
-    // that weren't selected this run
-    const existing = readMeta(latDir);
-    const mergedHashes = { ...existing?.file_hashes, ...fileHashes };
-    const data = {
-        init_version: INIT_VERSION,
-        file_hashes: mergedHashes,
-    };
-    writeFileSync(cachePath(latDir), JSON.stringify(data, null, 2) + '\n');
-}

package/dist/src/lattice.d.ts

@@ -1,109 +0,0 @@
-import type { Root } from 'mdast';
-export type Section = {
-    id: string;
-    heading: string;
-    depth: number;
-    file: string;
-    filePath: string;
-    children: Section[];
-    startLine: number;
-    endLine: number;
-    firstParagraph: string;
-    /** GitHub-compatible anchor generated from the rendered heading text. */
-    githubSlug?: string;
-};
-export type Ref = {
-    target: string;
-    fromSection: string;
-    file: string;
-    line: number;
-};
-/** An ordinary markdown destination or an undefined reference-style link. */
-export type MdLink = {
-    /** Destination exactly as authored, percent-escapes and all. */
-    url: string;
-    kind: 'link' | 'image' | 'definition';
-    line: number;
-} | {
-    /** Authored label that should have a matching definition. */
-    identifier: string;
-    /** Full reference syntax exactly as authored. */
-    source: string;
-    kind: 'linkReference' | 'imageReference';
-    line: number;
-};
-/**
- * Every field this build reads out of the `lat:` mapping. Kept in one place so
- * a field added later is covered by the misplacement check without a second
- * edit — the trap this list guards against is silent, so it must not depend on
- * whoever adds the next field remembering to register it twice.
- */
-export declare const LAT_FIELDS: readonly ["require-code-mention", "mode", "require-mode", "status", "reviewed-hash", "tags"];
-/**
- * Something wrong with the frontmatter itself, carried out of the parser for a
- * caller to report. Both kinds fail OPEN if they stay quiet: a misplaced or
- * unparseable `require-code-mention` turns a validation off and `lat check`
- * then reports success on a file that is no longer being validated.
- */
-export type FrontmatterProblem = {
-    kind: 'root-level-field';
-    field: string;
-} | {
-    kind: 'parse-error';
-    message: string;
-};
-export type LatFrontmatter = {
-    /** Every key under the `lat:` mapping, parsed but not mapped to a field. */
-    raw: Record<string, unknown>;
-    requireCodeMention?: boolean;
-    /** Populated only when something is wrong; absent on a healthy document. */
-    problems?: FrontmatterProblem[];
-};
-export declare function parseFrontmatter(content: string): LatFrontmatter;
-export declare function findLatticeDir(from?: string): string | null;
-export declare function findProjectRoot(from?: string): string | null;
-export declare function listLatticeFiles(latticeDir: string): Promise<string[]>;
-export declare function parseSections(filePath: string, content: string, projectRoot?: string, tree?: Root): Section[];
-export declare function loadAllSections(latticeDir: string, projectRoot?: string): Promise<Section[]>;
-export declare function flattenSections(sections: Section[]): Section[];
-/**
- * Build an index mapping path suffixes to their full vault-relative paths.
- * Used by resolveRef to allow short references when a suffix is unambiguous.
- *
- * For a file like `lat.md/guides/setup`, indexes both `guides/setup` and `setup`.
- * This ensures backward-compatible short refs after the vault root moved to the
- * project root (so section IDs now include the `lat.md/` prefix).
- */
-export declare function buildFileIndex(sections: Section[]): Map<string, string[]>;
-export type SectionSlugIndex = ReadonlyMap<string, string>;
-/**
- * Map GitHub-slugged heading paths back to canonical, literal-heading ids.
- * Every path segment accepts either representation so an implicit literal h1
- * can still prefix slugged child headings during short-ref resolution.
- */
-export declare function buildSectionSlugIndex(sections: Section[]): Map<string, string>;
-export type ResolveResult = {
-    resolved: string;
-    ambiguous: string[] | null;
-    /** When ambiguous but exactly one candidate has the section, suggest it. */
-    suggested: string | null;
-};
-/**
- * Resolve a potentially short reference to its canonical full-path form.
- * If the file segment of the ref is a bare stem that uniquely maps to one
- * full path, expands it. Otherwise returns the ref unchanged.
- *
- * When ambiguous (multiple files share the stem), returns all candidates.
- * If exactly one candidate actually contains the referenced section,
- * `suggested` is set to that candidate so the caller can propose a fix.
- */
-export declare function resolveRef(target: string, sectionIds: Set<string>, fileIndex: Map<string, string[]>, slugIndex?: SectionSlugIndex): ResolveResult;
-export type SectionMatch = {
-    section: Section;
-    reason: string;
-    score?: number;
-};
-export declare function findSections(sections: Section[], query: string): SectionMatch[];
-export declare function extractRefs(filePath: string, content: string, projectRoot?: string, tree?: Root): Ref[];
-/** Extract link destinations and undefined full/collapsed references. */
-export declare function extractLinks(content: string, tree?: Root): MdLink[];