@plebeiantech/lat.md 0.12.3-fork.2 → 0.12.3-fork.20

package/dist/src/view/static-protocol.d.ts

@@ -0,0 +1,47 @@
+import type { ViewExternalDocument, ViewIndex, ViewSourceDocument } from './protocol.js';
+export type ViewStaticSourceRequest = {
+    path: string;
+    symbol: string;
+    from: string;
+    line: number;
+    at: number;
+};
+export type ViewStaticSourceFile = Pick<ViewSourceDocument, 'path' | 'content' | 'highlightedLines'>;
+export type ViewStaticSourceView = Omit<ViewSourceDocument, keyof ViewStaticSourceFile>;
+export type ViewStaticSourceEntry = {
+    file: string;
+    view: string;
+};
+export type ViewStaticExternalEntry = {
+    kind: 'markdown';
+    document: string;
+} | {
+    kind: 'source';
+    file: string;
+    view: string;
+};
+export type ViewStaticExternalSourceView = {
+    kind: 'source';
+    target: string;
+    source: ViewStaticSourceView;
+};
+export type ViewStaticExternalMarkdown = Extract<ViewExternalDocument, {
+    kind: 'markdown';
+}>;
+export type ViewStaticManifest = {
+    version: 1;
+    index: ViewIndex;
+    graph: string;
+    documents: Record<string, string>;
+    sources: Record<string, ViewStaticSourceEntry>;
+    externals: Record<string, ViewStaticExternalEntry>;
+};
+export type ViewStaticBootstrap = {
+    manifest: ViewStaticManifest;
+    responses: Record<string, object>;
+};
+export declare const VIEW_STATIC_BOOTSTRAP_ID = "lat-static-bootstrap";
+/** Match the live document endpoint key used by the static browser adapter. */
+export declare function viewStaticDocumentRequest(path: string): string;
+/** Stable lookup key shared by the static exporter and browser adapter. */
+export declare function viewStaticSourceKey(request: ViewStaticSourceRequest): string;

package/dist/src/view/static-protocol.js

@@ -0,0 +1,15 @@
+export const VIEW_STATIC_BOOTSTRAP_ID = 'lat-static-bootstrap';
+/** Match the live document endpoint key used by the static browser adapter. */
+export function viewStaticDocumentRequest(path) {
+    return `/api/document?path=${encodeURIComponent(path)}`;
+}
+/** Stable lookup key shared by the static exporter and browser adapter. */
+export function viewStaticSourceKey(request) {
+    return JSON.stringify([
+        request.path,
+        request.symbol,
+        request.from,
+        request.line,
+        request.at,
+    ]);
+}

package/dist/src/view/store.d.ts

@@ -1,6 +1,7 @@
-import { type Section } from '../lattice.js';
+import { type ExternalResolver } from '@plebeiantech/lat.md-core/external-sources';
+import type { Section } from '@plebeiantech/lat.md-core/lattice-model';
 import { type ViewGitRepository, type ViewGitSnapshot } from './git.js';
-import type { ViewDocument, ViewDocumentError, ViewIndex, ViewProjectChange, ViewSourceDocument } from './protocol.js';
+import type { ViewDocument, ViewDocumentEditResponse, ViewDocumentError, ViewDocumentSource, ViewExternalDocument, ViewGraph, ViewIndex, ViewProjectGeneration, ViewDocumentTree, ViewSourceDocument } from './protocol.js';
 import { type ViewCodeReferenceFile, type ViewParsedMarkdownFile, type ViewReferenceIndex } from './references.js';
 export type ViewProjectSnapshot = {
     generation: number;
@@ -8,16 +9,24 @@ export type ViewProjectSnapshot = {
     files: ReadonlyMap<string, ViewParsedMarkdownFile>;
     allSections: Section[];
     references: ViewReferenceIndex;
+    graph: ViewGraph;
     diagnostics: ReadonlyMap<string, readonly ViewDocumentError[]>;
     git: ViewGitSnapshot;
     index: ViewIndex;
+    external: ExternalResolver;
 };
 export type ViewStoreOptions = {
+    /** Export-only allowlist, applied before source/backlink/resource reads. */
+    publishable?: (path: string) => Promise<boolean>;
+    codeExcludePaths?: string[];
     debounceMs?: number;
     git?: boolean;
+    gitPollMs?: number;
     watch?: boolean;
+    externalIgnoreLocal?: boolean;
+    externalCa?: string | Buffer;
 };
-type ViewStoreListener = (change: ViewProjectChange) => void;
+type ViewStoreListener = (change: ViewProjectGeneration) => void;
 /** Own the immutable, incrementally refreshed project snapshot for `lat ui`. */
 export declare class ViewStore {
     readonly latDir: string;
@@ -31,24 +40,38 @@ export declare class ViewStore {
     private ignoredCodePaths;
     private listeners;
     private watcher;
+    private externalWatchers;
     private pendingPaths;
     private debounceTimer;
+    private gitPollTimer;
+    private gitPollQueued;
     private refreshTail;
+    private editTail;
     private closed;
     constructor(latDir: string, projectRoot: string, realLatDir: string, snapshot: ViewProjectSnapshot, codeFiles: Map<string, ViewCodeReferenceFile>, codeScope: Set<string>, gitRepository: ViewGitRepository | null, options: ViewStoreOptions);
     get snapshot(): ViewProjectSnapshot;
     get markdownGeneration(): number;
     startWatching(): void;
+    private refreshExternalWatchers;
     subscribe(listener: ViewStoreListener): () => void;
     getIndex(): ViewIndex;
+    getGraph(): ViewGraph;
+    renderSectionOutput(markdown: string, sectionId: string): Promise<ViewDocumentTree>;
     getDocument(requestedPath: string): Promise<ViewDocument>;
+    private editableDocumentPath;
+    getDocumentSource(requestedPath: string): Promise<ViewDocumentSource>;
+    getDocumentResource(requestedPath: string): Promise<Buffer>;
+    editDocument(requestedPath: string, baseContent: string, editedContent: string): Promise<ViewDocumentEditResponse>;
     getSource(requestedPath: string, requestedSymbol?: string, origin?: {
         sectionId: string;
         line: number;
     }, requestedLine?: number): Promise<ViewSourceDocument>;
+    getExternal(target: string): Promise<ViewExternalDocument>;
     refresh(paths: string[]): Promise<void>;
+    private queueRefresh;
     close(): Promise<void>;
     private scheduleRefresh;
+    private startGitPolling;
     private readMarkdownFile;
     private applyRefresh;
 }