@plebeiantech/lat.md 0.12.3-fork.15 → 0.12.3-fork.16

package/dist/src/view/vercel-build.js

@@ -0,0 +1,133 @@
+import { cp, lstat, mkdir, mkdtemp, readFile, rename, rm, writeFile, } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
+import { nodeFileTrace } from '@vercel/nft';
+import { LAT_UI_CONTENT_SECURITY_POLICY } from '../../vendor/lat.md-server/index.js';
+const defaultDependencies = {
+    traceFiles: nodeFileTrace,
+};
+function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function basePathSegments(basePath) {
+    const parsed = new URL(basePath, 'http://lat.local');
+    if (parsed.origin !== 'http://lat.local' ||
+        parsed.search ||
+        parsed.hash ||
+        !basePath.startsWith('/')) {
+        throw new Error(`Invalid Lat UI server base path: ${basePath}`);
+    }
+    return parsed.pathname
+        .split('/')
+        .filter(Boolean)
+        .map((part) => {
+        const decoded = decodeURIComponent(part);
+        if (decoded === '.' ||
+            decoded === '..' ||
+            decoded.includes('/') ||
+            decoded.includes('\\')) {
+            throw new Error(`Invalid Lat UI server base path: ${basePath}`);
+        }
+        return decoded;
+    });
+}
+function safeTracePath(path) {
+    if (isAbsolute(path) ||
+        path === '..' ||
+        path.startsWith(`..${sep}`) ||
+        path.split(/[\\/]/).includes('..')) {
+        throw new Error(`Node file trace escaped the server artifact: ${path}`);
+    }
+    return path;
+}
+function outputConfig() {
+    const securityHeaders = {
+        'Content-Security-Policy': LAT_UI_CONTENT_SECURITY_POLICY,
+        'Referrer-Policy': 'no-referrer',
+        'X-Content-Type-Options': 'nosniff',
+    };
+    const immutableHeaders = {
+        'Cache-Control': 'public, max-age=31536000, immutable',
+    };
+    return {
+        version: 3,
+        routes: [
+            { src: '/(.*)', headers: securityHeaders, continue: true },
+            {
+                src: '/(?:.*?/)?assets/.*',
+                headers: immutableHeaders,
+                continue: true,
+            },
+            {
+                src: '/(?:.*?/)?data/[^/]+/[a-f0-9]{20}\\.json',
+                headers: immutableHeaders,
+                continue: true,
+            },
+            { handle: 'filesystem' },
+            { src: '/', dest: '/index.html' },
+            { src: '/(.*)/', dest: '/$1/index.html' },
+            { src: '/(.*)', dest: '/$1/index.html' },
+        ],
+    };
+}
+/** Convert an installed portable Lat UI server into Vercel Build Output API v3. */
+export async function buildVercelOutput(requestedArtifact, requestedOutput = '.vercel/output', options = {}, dependencies = defaultDependencies) {
+    const artifactDir = resolve(requestedArtifact);
+    const outputDir = resolve(requestedOutput);
+    if (!options.force) {
+        try {
+            await lstat(outputDir);
+            throw new Error(`Vercel build output already exists: ${outputDir}. Use force to replace it.`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    const manifestFile = join(artifactDir, 'server-data', 'server.json');
+    const manifest = JSON.parse(await readFile(manifestFile, 'utf8'));
+    if (typeof manifest.basePath !== 'string') {
+        throw new Error(`Invalid Lat UI server manifest: ${manifestFile}`);
+    }
+    const entrypoint = join(artifactDir, 'app.mjs');
+    const trace = await dependencies.traceFiles([entrypoint], {
+        base: artifactDir,
+        conditions: ['node', 'production'],
+        exportsOnly: true,
+        processCwd: artifactDir,
+    });
+    for (const warning of trace.warnings) {
+        options.warn?.(`Node file trace: ${warning.message}`);
+    }
+    await mkdir(dirname(outputDir), { recursive: true });
+    const stagingDir = await mkdtemp(join(dirname(outputDir), '.lat-vercel-staging-'));
+    try {
+        const staticDir = join(stagingDir, 'static');
+        const functionPath = join('functions', ...basePathSegments(manifest.basePath), 'api', 'search.func');
+        const functionDir = join(stagingDir, functionPath);
+        await cp(join(artifactDir, 'public'), staticDir, { recursive: true });
+        for (const traced of trace.fileList) {
+            const path = safeTracePath(traced);
+            const destination = join(functionDir, path);
+            await mkdir(dirname(destination), { recursive: true });
+            await cp(join(artifactDir, path), destination, {
+                dereference: true,
+                recursive: true,
+            });
+        }
+        await writeFile(join(functionDir, '.vc-config.json'), json({
+            runtime: 'nodejs22.x',
+            handler: 'app.mjs',
+            launcherType: 'Nodejs',
+            shouldAddHelpers: true,
+        }));
+        await writeFile(join(stagingDir, 'config.json'), json(outputConfig()));
+        if (options.force)
+            await rm(outputDir, { recursive: true, force: true });
+        await rename(stagingDir, outputDir);
+        return { files: trace.fileList.size, functionPath, outputDir };
+    }
+    catch (error) {
+        await rm(stagingDir, { recursive: true, force: true });
+        throw error;
+    }
+}

package/dist/src/view/vercel-server-build.d.ts

@@ -0,0 +1,10 @@
+import type { CmdContext } from '../context.js';
+import { buildServerView, type ServerViewBuildOptions, type ServerViewBuildResult } from './server-build.js';
+import { type VercelBuildOptions, type VercelBuildResult } from './vercel-build.js';
+export type VercelServerBuildDependencies = {
+    buildNode: typeof buildServerView;
+    buildOutput: (artifact: string, output: string, options: VercelBuildOptions) => Promise<VercelBuildResult>;
+    installDependencies: (artifact: string) => Promise<void>;
+};
+/** Build the portable server in staging, install it, then emit Vercel v3 output. */
+export declare function buildVercelServerView(ctx: CmdContext, requestedOutput: string, options?: ServerViewBuildOptions, dependencies?: VercelServerBuildDependencies): Promise<ServerViewBuildResult>;

package/dist/src/view/vercel-server-build.js

@@ -0,0 +1,61 @@
+import { spawn } from 'node:child_process';
+import { mkdir, mkdtemp, rm } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { buildServerView, } from './server-build.js';
+import { validateViewBuildOutput } from './static-build.js';
+import { buildVercelOutput, } from './vercel-build.js';
+function installServerDependencies(artifact) {
+    const executable = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const args = [
+        'install',
+        '--ignore-scripts',
+        '--no-package-lock',
+        '--omit=dev',
+        '--no-audit',
+        '--no-fund',
+    ];
+    return new Promise((resolveInstall, reject) => {
+        const child = spawn(executable, args, { cwd: artifact, stdio: 'inherit' });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0) {
+                resolveInstall();
+                return;
+            }
+            reject(new Error(`npm install failed${signal ? ` with signal ${signal}` : ` with exit code ${code}`}`));
+        });
+    });
+}
+const defaultDependencies = {
+    buildNode: buildServerView,
+    buildOutput: buildVercelOutput,
+    installDependencies: installServerDependencies,
+};
+/** Build the portable server in staging, install it, then emit Vercel v3 output. */
+export async function buildVercelServerView(ctx, requestedOutput, options = {}, dependencies = defaultDependencies) {
+    const outputDir = resolve(ctx.projectRoot, requestedOutput);
+    await validateViewBuildOutput(outputDir, ctx.projectRoot, 'Vercel', options.force);
+    await mkdir(dirname(outputDir), { recursive: true });
+    const stagingDir = await mkdtemp(join(dirname(outputDir), '.lat-vercel-server-'));
+    const nodeArtifact = join(stagingDir, 'node');
+    try {
+        const result = await dependencies.buildNode(ctx, nodeArtifact, {
+            ...options,
+            force: false,
+        });
+        await dependencies.installDependencies(nodeArtifact);
+        await dependencies.buildOutput(nodeArtifact, outputDir, {
+            force: options.force,
+            warn: (message) => console.warn(message),
+        });
+        return { ...result, outputDir };
+    }
+    finally {
+        await rm(stagingDir, {
+            recursive: true,
+            force: true,
+            maxRetries: 10,
+            retryDelay: 150,
+        });
+    }
+}

package/dist/vendor/lat.md-server/index.d.ts

@@ -1,6 +1,6 @@
 import { type IncomingMessage, type RequestListener, type Server, type ServerResponse } from 'node:http';
 import { type Express } from 'express';
-export declare const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.githubassets.com; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
+export declare const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.com https://github.githubassets.com https://img.shields.io; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
 export type LatServerAppOptions = {
     /** Handle dynamic routes before immutable files and fallback handlers. */
     handle?: LatServerRequestHandler;

package/dist/vendor/lat.md-server/index.js

@@ -1,7 +1,7 @@
 import { createServer, } from 'node:http';
 import { readFileSync } from 'node:fs';
 import express from 'express';
-export const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.githubassets.com; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
+export const LAT_UI_CONTENT_SECURITY_POLICY = "default-src 'self'; connect-src 'self' https://tiles.openfreemap.org; font-src 'self' data:; img-src 'self' data: https://github.com https://github.githubassets.com https://img.shields.io; style-src 'self' 'unsafe-inline'; worker-src 'self' blob:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'";
 function setSecurityHeaders(res) {
     res.setHeader('Content-Security-Policy', LAT_UI_CONTENT_SECURITY_POLICY);
     res.setHeader('Referrer-Policy', 'no-referrer');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plebeiantech/lat.md",
-  "version": "0.12.3-fork.15",
+  "version": "0.12.3-fork.16",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,12 @@
   "bin": {
     "lat": "./dist/src/cli/index.js"
   },
+  "exports": {
+    "./server": {
+      "types": "./dist/src/view/server-deployment.d.ts",
+      "import": "./dist/src/view/server-deployment.js"
+    }
+  },
   "files": [
     "dist/src",
     "dist/vendor",
@@ -35,6 +41,8 @@
     "@codemirror/merge": "^6.12.2",
     "@codemirror/state": "^6.7.1",
     "@codemirror/view": "^6.43.9",
+    "@fontsource-variable/geist": "^5.3.0",
+    "@fontsource-variable/geist-mono": "^5.3.0",
     "@lezer/highlight": "^1.2.3",
     "@types/geojson": "^7946.0.16",
     "@types/express": "^5.0.6",
@@ -74,6 +82,7 @@
     "@libsql/client": "^0.17.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@repomix/tree-sitter-wasms": "^0.1.17",
+    "@vercel/nft": "^1.10.0",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
     "express": "^5.2.1",
@@ -106,17 +115,20 @@
     "web-tree-sitter": "^0.26.6",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lat.md/embed-minilm-fp16": "0.1.0",
-    "@lat.md/embed": "0.2.0"
+    "@lat.md/embed": "0.2.0",
+    "@lat.md/embed-minilm-fp16": "0.1.0"
   },
   "scripts": {
     "build": "tsc && tsx scripts/fork-vendor-ui-server.ts && pnpm build:view",
     "build:view": "vite build --config view/vite.config.ts && vite build --config view/highlight.vite.config.ts",
+    "build:site": "pnpm --filter @lat.md/server build && node scripts/prepare-site-packages.mjs && pnpm build && node dist/src/cli/index.js ui build server --force",
+    "build:site:vercel": "pnpm build:site && node scripts/vendor-site-packages.mjs && npm install --prefix .lat-build/server --ignore-scripts --no-package-lock && node scripts/build-vercel-output.mjs",
+    "build:site:source": "pnpm buildall && node dist/src/cli/index.js ui build server --force",
     "buildall": "pnpm build:packages && pnpm build",
     "setup:rust": "pnpm --filter @lat.md/embed setup:rust",
     "build:wasm": "pnpm --filter @lat.md/embed build:wasm",
     "build:weights": "pnpm --filter @lat.md/embed-minilm-fp16 build:weights",
-    "build:packages": "pnpm --filter @lat.md/server build && pnpm --filter @lat.md/embed build && pnpm --filter @lat.md/embed-minilm-fp16 build",
+    "build:packages": "pnpm --filter @lat.md/server build && pnpm --filter @lat.md/stemmer build && pnpm --filter @lat.md/embed build && pnpm --filter @lat.md/embed-minilm-fp16 build",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "pnpm --filter @lat.md/server build && tsc --noEmit && tsc --noEmit -p view/tsconfig.json",

package/dist/src/view/client/assets/abnfDiagram-VCTEODGH-V7-T6qsl.js

@@ -1 +0,0 @@
-import{g as p,r as u,d as a}from"./chunk-SVP7TREG-BHROkr6D.js";import{p as f}from"./chunk-JWPE2WC7-VvU_gZI6.js";import{_ as n,l as o}from"./mermaid.core-bds9A7e2.js";import{M as c,b as d}from"./cynefin-OW5HDTMX-CeA8IKWo.js";import"./index-KZcnpXJH.js";var v=d().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),l=t?parseInt(t,10):0,m=s?parseInt(s,10):1/0;return{min:l,max:m}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new c(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},B={parser:R,db:a,renderer:u,styles:p};export{B as diagram};