@vesk/adapter 0.2.10 → 0.2.12

package/dist/error-tips.js

@@ -0,0 +1,91 @@
+const RUNTIME_AUTOIMPORTS = 'effect, derived, untrack, peek, tick, flushSync, on_destroy, createContext';
+const SYNTAX_KINDS = ['Unexpected token', 'Parse error', 'SyntaxError'];
+const MODULE_KINDS = ['Cannot find module', 'Cannot load module', 'Module not found'];
+const NULL_DEREF_KINDS = ['Cannot read properties of', 'Cannot read property'];
+const rules = [
+    {
+        match: (m) => m.includes('is not defined'),
+        build: () => ({
+            tips: [
+                'The name was referenced before it was imported or declared in this file, so the compiler treated it as undeclared.',
+            ],
+            suggestions: [
+                `Vesk auto-imports the reactive helpers from @vesk/runtime (${RUNTIME_AUTOIMPORTS}); note that \`batch\` does NOT exist — never import it.`,
+            ],
+            nextSteps: [
+                'Check the spelling, add an explicit import for the name, or declare it as a binding before use.',
+            ],
+        }),
+    },
+    {
+        match: (m) => SYNTAX_KINDS.some((k) => m.includes(k)),
+        build: () => ({
+            tips: ['The parser hit a token it could not place in the current context.'],
+            suggestions: [
+                'Statement mode accepts bare JSX plus if/for/while/switch/try — no return statement needed; expression mode requires `return <jsx>;`.',
+            ],
+            nextSteps: [
+                'Check the line under the ^ marker for missing brackets, quotes, or unclosed JSX tags, then fix and re-save.',
+            ],
+        }),
+    },
+    {
+        match: (m) => MODULE_KINDS.some((k) => m.includes(k)),
+        build: () => ({
+            tips: ['An import path could not be resolved from this file.'],
+            suggestions: ['Check the specifier spelling and the relative path (./ vs ../) in the import statement.'],
+            nextSteps: [
+                'Install the missing dependency or create the file at the expected path, then restart the dev server.',
+            ],
+        }),
+    },
+    {
+        match: (m) => m.toLowerCase().includes('unterminated'),
+        build: () => ({
+            tips: ['A string or template literal was opened earlier in the file and never closed.'],
+            suggestions: ['Look for a missing closing quote or backtick on the line just above the marker.'],
+            nextSteps: [
+                'Close the literal; to span lines, open it with a backtick and use ${expr} for interpolation.',
+            ],
+        }),
+    },
+    {
+        match: (m) => m.includes('is not a function') || m.includes('undefined is not'),
+        build: () => ({
+            tips: ['The value being called is not callable — often undefined, null, or the wrong import.'],
+            suggestions: ['Check that you imported the function itself and used the correct export name.'],
+            nextSteps: [
+                'Guard the call (typeof x === \'function\' && x()) or trace where the value is assigned before invoking it.',
+            ],
+        }),
+    },
+    {
+        match: (m) => NULL_DEREF_KINDS.some((k) => m.includes(k)) || m.includes(' of null') || m.includes(' of undefined'),
+        build: () => ({
+            tips: ['A property was read on null or undefined at the marked line.'],
+            suggestions: ['Guard the access with optional chaining (obj?.prop) or a default value (const x = data ?? {}).'],
+            nextSteps: [
+                'Trace where the value is set — async data may not have arrived when the component first renders.',
+            ],
+        }),
+    },
+];
+const FALLBACK = {
+    tips: ['The compiler reported an error in this file but no rule matched its message text.'],
+    suggestions: [
+        'Verify imports and that every referenced name is declared — and check the body in both statement mode (bare JSX, if/for/while/switch/try) and expression mode (return <jsx>).',
+    ],
+    nextSteps: [
+        'Look for a fuller error message printed above this one.',
+        'Restart the dev server if the error persists after the fix.',
+    ],
+};
+export function suggestFor(message) {
+    if (typeof message !== 'string')
+        return FALLBACK;
+    for (const rule of rules) {
+        if (rule.match(message))
+            return rule.build(message);
+    }
+    return FALLBACK;
+}

package/dist/hmr-utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shareable HMR source-text helpers factored out of `hmr.ts` so the .vsk hot
+ * path can be reused (and benchmarked) independently of the WebSocket server.
+ * Adapter text processing is tooling, not compiler syntax analysis — regex is
+ * permitted here.
+ */
+export interface ComponentAssignment {
+    name: string;
+    raw: string;
+}
+export declare function extractComponentAssignments(code: string): ComponentAssignment[];
+export declare function extractSourceDir(filename: string): string | null;
+export declare function escapeSource(src: string): string;
+//# sourceMappingURL=hmr-utils.d.ts.map

package/dist/hmr-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-utils.d.ts","sourceRoot":"","sources":["../src/hmr-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CA8B/E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/hmr-utils.js

@@ -0,0 +1,56 @@
+/**
+ * Shareable HMR source-text helpers factored out of `hmr.ts` so the .vsk hot
+ * path can be reused (and benchmarked) independently of the WebSocket server.
+ * Adapter text processing is tooling, not compiler syntax analysis — regex is
+ * permitted here.
+ */
+export function extractComponentAssignments(code) {
+    const assignments = [];
+    const startRegex = /__components\["(\w+)"\]\s*=\s*/;
+    const lines = code.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const m = lines[i].match(startRegex);
+        if (m) {
+            const name = m[1];
+            const startIdx = i;
+            let braceDepth = 0;
+            for (let j = 0; j < lines[i].length; j++) {
+                if (lines[i][j] === '{')
+                    braceDepth++;
+                if (lines[i][j] === '}')
+                    braceDepth--;
+            }
+            i++;
+            while (i < lines.length && braceDepth > 0) {
+                for (let j = 0; j < lines[i].length; j++) {
+                    if (lines[i][j] === '{')
+                        braceDepth++;
+                    if (lines[i][j] === '}')
+                        braceDepth--;
+                }
+                i++;
+            }
+            const fullAssignment = lines.slice(startIdx, i).join('\n');
+            assignments.push({ name, raw: fullAssignment });
+        }
+        else {
+            i++;
+        }
+    }
+    return assignments;
+}
+export function extractSourceDir(filename) {
+    if (filename === 'page.vsk')
+        return '';
+    if (filename.endsWith('/page.vsk'))
+        return filename.slice(0, -'/page.vsk'.length);
+    if (filename === 'layout.vsk')
+        return '';
+    if (filename.endsWith('/layout.vsk'))
+        return filename.slice(0, -'/layout.vsk'.length);
+    return null;
+}
+export function escapeSource(src) {
+    return src.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+}

package/dist/hmr.d.ts

@@ -1,7 +1,47 @@
 import type { Server } from 'node:http';
+import { type Codeframe } from '@vesk/adapter/src/error-codeframe';
 import type { RouteNode } from '@vesk/adapter/src/types';
+/**
+ * Canonical HMR error payload emitted on `'error'` broadcasts and exposed via
+ * `getHmrState()` (served at `/__vesk/hmr/state`). This is the wire contract
+ * between the HMR server and the client's `HmrErrorPayload` renderer.
+ */
+export interface HmrErrorPayload {
+    file: string;
+    filePath?: string;
+    line: number | null;
+    column: number | null;
+    message: string;
+    codeframe?: Codeframe;
+    tips?: string[];
+    suggestions?: string[];
+    nextSteps?: string[];
+    stack?: string;
+}
+export declare function getHmrState(): {
+    status: 'up' | 'closed';
+    lastCompileMs: number | null;
+    error: HmrErrorPayload | null;
+    hasError: boolean;
+    componentCount?: number;
+};
+export interface BuildErrorPayloadOptions {
+    /** Absolute app dir, used to resolve `filename` to disk for the codeframe. */
+    appDir?: string;
+    /** Extra fields merged into the returned payload (last writer wins). */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build the canonical HMR error payload from an arbitrary thrown value. Handles
+ * Error instances, plain strings, and objects exposing `.loc`/`.position`
+ * (acorn / VeskError shapes). When a line is recoverable it best-effort reads
+ * the source file from disk to attach a ±context codeframe; otherwise line/
+ * column are null and no codeframe is included (the client handles that case).
+ */
+export declare function buildErrorPayload(error: unknown, filename: string, opts?: BuildErrorPayloadOptions): HmrErrorPayload;
 export declare function createHmrServer(httpServer: Server, appDir: string, devDir: string, componentMap?: Map<string, string>): {
     broadcast: (type: string, data?: Record<string, unknown>) => void;
     handleFileChange: (filename: string | null, doFullBuild: () => Promise<void>, routeTree: RouteNode[]) => Promise<void>;
+    getHmrState: () => ReturnType<typeof getHmrState>;
 };
 //# sourceMappingURL=hmr.d.ts.map

package/dist/hmr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQxC,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AA6RzE,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAmI/L"}
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASxC,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,wBAA6B,GAClC,eAAe,CA4DjB;AA2RD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD,CAyJA"}

package/dist/hmr.js

@@ -3,10 +3,106 @@ import { readFileSync, existsSync, writeFileSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { compileClient } from '@vesk/compiler/src/client-codegen';
+import { buildHmrEvalSnippet } from './client-bundle';
 import { resolveComponentName, randomToken } from '@vesk/compiler/src/server-codegen';
 import { resolveErrorFile } from '@vesk/adapter/src/ssr-function';
 import { isAllowedWsUpgrade } from '@vesk/adapter/src/paths';
+import { parseCompilerError, buildCodeframe } from '@vesk/adapter/src/error-codeframe';
+import { suggestFor } from '@vesk/adapter/src/error-tips';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * The last enriched error payload broadcast over HMR, plus the last successful
+ * compile duration (ms). Cleared invariants:
+ *   - `lastError` set ONLY on `'error'` broadcasts; cleared on every
+ *     `'update'`/`'reload'` broadcast and on HMR watch start.
+ *   - `lastCompileMs` set from `'update'`/`'reload'` `time`; cleared on error.
+ */
+let lastError = null;
+let lastCompileMs = null;
+let lastComponentCount = null;
+export function getHmrState() {
+    return {
+        status: 'up',
+        lastCompileMs,
+        error: lastError,
+        hasError: lastError !== null,
+        ...(lastComponentCount !== null ? { componentCount: lastComponentCount } : {}),
+    };
+}
+/**
+ * Build the canonical HMR error payload from an arbitrary thrown value. Handles
+ * Error instances, plain strings, and objects exposing `.loc`/`.position`
+ * (acorn / VeskError shapes). When a line is recoverable it best-effort reads
+ * the source file from disk to attach a ±context codeframe; otherwise line/
+ * column are null and no codeframe is included (the client handles that case).
+ */
+export function buildErrorPayload(error, filename, opts = {}) {
+    const file = typeof filename === 'string' && filename ? filename : 'unknown';
+    const parsed = parseCompilerError(error, file);
+    const fallbackMessage = error instanceof Error ? error.message
+        : typeof error === 'string' ? error
+            : (() => { try {
+                return String(error);
+            }
+            catch {
+                return 'Unknown error';
+            } })();
+    const message = parsed && parsed.message ? parsed.message : fallbackMessage;
+    const line = parsed ? parsed.line : null;
+    const column = parsed ? parsed.column : null;
+    const stack = parsed && typeof parsed.stack === 'string' && parsed.stack
+        ? parsed.stack
+        : error instanceof Error && error.stack
+            ? error.stack
+            : undefined;
+    let codeframe;
+    if (line !== null && line >= 1 && typeof opts.appDir === 'string') {
+        let src;
+        try {
+            const absPath = resolve(opts.appDir, file);
+            if (existsSync(absPath))
+                src = readFileSync(absPath, 'utf-8');
+        }
+        catch {
+            src = undefined;
+        }
+        if (typeof src === 'string' && src.length > 0) {
+            const cf = buildCodeframe(src, line, column ?? 1);
+            if (cf) {
+                cf.file = file;
+                codeframe = cf;
+            }
+        }
+    }
+    const tipsData = suggestFor(message);
+    const filePath = typeof opts.appDir === 'string'
+        ? resolve(opts.appDir, file)
+        : undefined;
+    const payload = {
+        file,
+        line,
+        column,
+        message,
+    };
+    if (filePath)
+        payload.filePath = filePath;
+    if (codeframe)
+        payload.codeframe = codeframe;
+    if (tipsData.tips && tipsData.tips.length)
+        payload.tips = tipsData.tips;
+    if (tipsData.suggestions && tipsData.suggestions.length)
+        payload.suggestions = tipsData.suggestions;
+    if (tipsData.nextSteps && tipsData.nextSteps.length)
+        payload.nextSteps = tipsData.nextSteps;
+    if (stack)
+        payload.stack = stack;
+    if (opts.extra) {
+        for (const [k, v] of Object.entries(opts.extra)) {
+            payload[k] = v;
+        }
+    }
+    return payload;
+}
 function findRouteForSource(routeTree, sourceDir) {
     for (const node of routeTree) {
         if (node.sourceDir === sourceDir)
@@ -302,6 +398,11 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
     // appendHmrGlobals in client-bundle.ts). Broadcast with every update.
     const hmrNonce = randomToken(16);
     globalThis.__vesk_hmr_nonce = hmrNonce;
+    // HMR watch start — clear any stale error state so a fresh session starts
+    // clean (the client also pulls live state via /__vesk/hmr/state).
+    lastError = null;
+    lastCompileMs = null;
+    lastComponentCount = null;
     const wss = new WebSocketServer({ noServer: true });
     const clients = new Set();
     // Origin-checked upgrade: cross-site pages always attach an Origin header
@@ -321,6 +422,22 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
         ws.on('error', () => clients.delete(ws));
     });
     function broadcast(type, data) {
+        // Keep live state in lockstep with what clients receive. `lastError` is set
+        // ONLY on 'error' broadcasts and cleared on any successful update/reload;
+        // `lastCompileMs` tracks the most recent successful compile duration.
+        const d = (data ?? {});
+        if (type === 'error') {
+            lastError = (d && typeof d.message === 'string') ? d : null;
+            lastCompileMs = null;
+        }
+        else if (type === 'update' || type === 'reload') {
+            lastError = null;
+            if (typeof d.time === 'number')
+                lastCompileMs = d.time;
+            if (type === 'update' && d && typeof d.components === 'object' && d.components !== null) {
+                lastComponentCount = Object.keys(d.components).length;
+            }
+        }
         const msg = JSON.stringify({ type, nonce: hmrNonce, ...data });
         for (const ws of clients) {
             try {
@@ -347,16 +464,22 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
                 const assignments = extractComponentAssignments(code);
                 if (assignments.length > 0) {
                     const components = {};
-                    const fnSources = {};
-                    for (const { name, raw } of assignments) {
+                    for (const { name } of assignments) {
                         components[name] = true;
-                        fnSources[name] = raw;
                     }
-                    broadcast('update', {
-                        components,
-                        fnSources,
-                        time: Date.now() - start,
-                    });
+                    // Send the whole file scope (not per-component slices): a sliced
+                    // assignment closes over file top-level bindings (const navItems,
+                    // helpers, …) that the eval context does not have, so the
+                    // re-rendered component throws ReferenceError and the swap fails
+                    // silently (no reload, stale DOM, zero page errors).
+                    const snippet = buildHmrEvalSnippet(code);
+                    if (snippet.trim()) {
+                        broadcast('update', {
+                            components,
+                            fnSources: { _raw: snippet },
+                            time: Date.now() - start,
+                        });
+                    }
                 }
                 if (sourceDir !== null) {
                     const routeNode = findRouteForSource(routeTree, sourceDir);
@@ -368,9 +491,9 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
                 console.error(`vesk hmr: ${assignments.map(a => a.name).join(', ')} (${Date.now() - start}ms)`);
             }
             catch (e) {
-                const message = e instanceof Error ? e.message : String(e);
-                broadcast('error', { message, file: filename });
-                console.error(`vesk hmr: error — ${message}`);
+                const payload = buildErrorPayload(e, filename, { appDir });
+                broadcast('error', payload);
+                console.error(`vesk hmr: error — ${payload.message}`);
             }
             return;
         }
@@ -381,8 +504,7 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
                 broadcast('reload', { reason: `API: ${filename}`, time: Date.now() - start });
             }
             catch (e) {
-                const message = e instanceof Error ? e.message : String(e);
-                broadcast('error', { message, file: filename });
+                broadcast('error', buildErrorPayload(e, filename, { appDir }));
             }
             return;
         }
@@ -394,8 +516,7 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
                 console.error(`vesk hmr: middleware ${filename} rebuilt (${Date.now() - start}ms)`);
             }
             catch (e) {
-                const message = e instanceof Error ? e.message : String(e);
-                broadcast('error', { message, file: filename });
+                broadcast('error', buildErrorPayload(e, filename, { appDir }));
             }
             return;
         }
@@ -408,8 +529,7 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
                 console.error(`vesk hmr: ${filename} rebuilt (${Date.now() - start}ms)`);
             }
             catch (e) {
-                const message = e instanceof Error ? e.message : String(e);
-                broadcast('error', { message, file: filename });
+                broadcast('error', buildErrorPayload(e, filename, { appDir }));
             }
             return;
         }
@@ -419,9 +539,8 @@ export function createHmrServer(httpServer, appDir, devDir, componentMap) {
             broadcast('reload', { reason: `${filename} changed`, time: Date.now() - start });
         }
         catch (e) {
-            const message = e instanceof Error ? e.message : String(e);
-            broadcast('error', { message, file: filename });
+            broadcast('error', buildErrorPayload(e, filename, { appDir }));
         }
     }
-    return { broadcast, handleFileChange };
+    return { broadcast, handleFileChange, getHmrState };
 }

package/dist/index.d.ts

@@ -1,4 +1,40 @@
-import type { BuildOptions, BuildResult } from '@vesk/adapter/src/types';
+import type { BuildOptions, BuildResult, VeskPlugin } from '@vesk/adapter/src/types';
+/**
+ * Plugin activation record as consumed by the build gate. At runtime these come
+ * from the plugin-manager module (`@vesk/adapter/src/plugins`): either
+ * `getPluginRecords` (full `PluginRecord[]` — only `name` + `active` are used
+ * here) or `readPluginState` (`.vesk/plugins.json` entries). This local shape is
+ * the minimal dual-view of those two sources.
+ */
+export interface PluginStateRecord {
+    name: string;
+    active: boolean;
+}
+export interface PluginStateFile {
+    version: number;
+    plugins: PluginStateRecord[];
+}
+/**
+ * Defensive local mirror of the plugin-manager's `filterActivePlugins`
+ * (`@vesk/adapter/src/plugins`): keep when there is no matching record, or the
+ * record's `active` is true; drop when a name-matched record is explicitly
+ * inactive. Names match CASE-INSENSITIVELY to stay aligned with the manager —
+ * it reads/writes state via `eqIgnoreCase`. Only used as the fallback when the
+ * plugin-manager module is unavailable during a build; the live build gate in
+ * `build()` calls the module's own filter.
+ */
+export declare function filterActivePlugins(plugins: VeskPlugin[], records: PluginStateRecord[] | null | undefined): VeskPlugin[];
+/**
+ * Build-time enforcement gate (fallback): an INACTIVE plugin must NEVER ship —
+ * it must not have any hook invoked and must not appear in CSS / transformed
+ * JS / platform output. Returns the actives-only list. A null/absent state
+ * degrades to "all config plugins stay active" (defensive). The live gate in
+ * `build()` prefers `@vesk/adapter/src/plugins#filterActivePlugins`; this
+ * helper exists for the no-module fallback and for direct unit testing.
+ */
+export declare function filterPluginsForBuild(plugins: VeskPlugin[], state: PluginStateFile | null | undefined): VeskPlugin[];
 export declare function build(appDir: string, options?: BuildOptions): Promise<BuildResult | undefined>;
 export { startProdServer } from '@vesk/adapter/src/prod-server';
+export { createDevApiRouter, DEFAULT_CAPABILITIES, DEFAULT_COMMAND_ALLOWLIST, CapabilityTable, } from '@vesk/adapter/src/dev-api';
+export type { DevApiRouterOptions, DevApiRouter, DevApiCapabilities, CapabilityName, DiagnosticFinding, DevPanelResponse, RebuildResult, CommandResult, } from '@vesk/adapter/src/dev-api';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAEnD,MAAM,yBAAyB,CAAC;AAgBjC,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA+SpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAC7B,UAAU,EAChC,MAAM,yBAAyB,CAAC;AAiBjC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,UAAU,EAAE,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,EAAE,CAGd;AAWD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAyVpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC"}