@pracht/vite-plugin 0.11.0 → 0.12.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { PreactSsrPrecompileOptions } from "@pracht/preact-ssr-precompile";
-import { Plugin } from "vite";
+import { InlineConfig, Plugin } from "vite";
+import { EnvLeakReference, EnvLeakReference as EnvLeakReference$1, PUBLIC_ENV_PREFIX, VITE_BUILTIN_ENV_VARS, scanCodeForEnvLeaks } from "@pracht/capabilities/static";
 import { RenderMode, RenderMode as RenderMode$1 } from "@pracht/core";
 
 //#region src/plugin-assets.d.ts
@@ -10,29 +11,11 @@ declare const PRACHT_CAPABILITIES_MODULE_ID = "virtual:pracht/capabilities";
 declare const PRACHT_WEBMCP_MODULE_ID = "virtual:pracht/webmcp";
 //#endregion
 //#region src/env-safety.d.ts
-/**
- * Env vars Vite defines on `import.meta.env` in every bundle, plus NODE_ENV
- * which Vite's define pass statically replaces at build time (so it can never
- * leak and is referenced by countless dependencies).
- */
-declare const VITE_BUILTIN_ENV_VARS: Set<string>;
-/** Prefix that marks an env var as intentionally public. */
-declare const PUBLIC_ENV_PREFIX = "PRACHT_PUBLIC_";
 interface EnvSafetyOptions {
   /** Env var names allowed to appear in client bundles despite not being public. */
   allow?: string[];
 }
-interface EnvLeakReference {
-  accessor: "process.env" | "import.meta.env";
-  name: string;
-}
-/**
- * Scans JavaScript source for references to environment variables that are
- * neither public-prefixed, Vite built-ins, nor explicitly allowed, plus reads
- * that pull in the whole `import.meta.env` object.
- */
-declare function scanCodeForEnvLeaks(code: string, allow?: ReadonlySet<string>): EnvLeakReference[];
-interface EnvLeakProblem extends EnvLeakReference {
+interface EnvLeakProblem extends EnvLeakReference$1 {
   chunk: string;
   sources: string[];
 }
@@ -165,6 +148,12 @@ interface PrachtClientOptions {
    * `prefetch()` export a no-op.
    */
   prefetch?: boolean;
+  /**
+   * `useBlocker()` navigation guards. Off also drops the per-history-entry
+   * index the router stamps so a refused back/forward traversal can be put
+   * back, and makes `useBlocker()` never block (it warns in development).
+   */
+  navigationGuards?: boolean;
 }
 interface PrachtPluginOptions {
   /**
@@ -182,6 +171,12 @@ interface PrachtPluginOptions {
    * Preact merged into its own chunks.
    */
   vendorChunk?: boolean;
+  /**
+   * Inline the matched route and shell's emitted production CSS in the HTML
+   * head instead of linking those assets. Defaults to `false`; enable it for
+   * small critical stylesheets after accounting for HTML/cache duplication.
+   */
+  inlineCss?: boolean;
   appFile?: string;
   routesDir?: string;
   shellsDir?: string;
@@ -319,12 +314,13 @@ interface ExtractedCapability {
   httpPath: string | null;
   webmcp: boolean;
   webmcpUntrustedContent: boolean;
+  /** Inline input schema, or `null` when WebMCP codegen loads the server module to derive it. */
   inputSchema: Record<string, unknown> | null;
 }
 /**
- * Extract capability registrations (name → module path) from the app
- * manifest source and their exposure metadata from each capability source.
- * Pages-router apps have no manifest, so capabilities are manifest-mode only.
+ * Extract capability registrations (name → module path) from a manifest app
+ * or the pages router's generated manifest, then read exposure metadata from
+ * each capability source.
  */
 declare function extractCapabilities(options?: PrachtPluginOptions, root?: string): ExtractedCapability[];
 /**
@@ -341,29 +337,33 @@ declare function createPrachtCapabilitiesClientModuleSource(options?: PrachtPlug
   root?: string;
 }): string;
 /**
- * Generate `virtual:pracht/webmcp` — the disposable WebMCP registration shim.
- * One page tool per `expose.webmcp` capability; `execute` dispatches through
+ * Generate `virtual:pracht/webmcp` — the WebMCP registration shim.
+ * One page tool per `expose.webmcp` capability; dispatch goes through
  * `callCapability`, so the user's session authenticates the call and all
  * validation/middleware/policy stays server-side. Each dispatch carries the
  * transport marker header so audit events can attribute it to WebMCP.
  *
- * Targets the WebMCP CG draft API: `document.modelContext.registerTool()`
- * (ChatGPT desktop's built-in browser; Chromium 150+ within the 149–156
- * origin trial — the `document` getter landed in 150 and the deprecated
- * `navigator.modelContext` alias was removed in 152, so trial builds before
- * 150 are not targeted and no fallback is kept; current polyfills install the
- * `document` shape). No-ops silently when the API is absent.
- *
- * `execute()` returns the capability envelope (`{ ok, data }` /
- * `{ ok: false, error }`) as a plain object: per the spec the host serializes
- * the returned value itself, so wrapping it in MCP-style content blocks would
- * reach the agent double-encoded.
+ * The registration runtime — feature detection, `registerTool()` calls, and
+ * the WebMCP annotation policy — lives in
+ * `@pracht/capabilities/webmcp` (published, so non-pracht sites register tools
+ * with identical semantics); this module only
+ * contributes the statically extracted tool metadata and the app-specific
+ * dispatch. The registrar import is resolved from *this plugin's* copy of
+ * `@pracht/capabilities` at codegen time: the virtual module has no importer
+ * on disk, so a bare specifier would resolve against the app root — where an
+ * older installed copy may predate the `./webmcp` entry point. The registrar
+ * is stateless, so using the plugin's copy cannot split state.
  */
 declare function createPrachtWebmcpModuleSource(options?: PrachtPluginOptions, buildOptions?: {
   root?: string;
 }): string;
+declare function createPrachtWebmcpModuleSourceAsync(options?: PrachtPluginOptions, buildOptions?: {
+  root?: string;
+  loadCapability?: (file: string) => Promise<unknown>;
+  runnerConfig?: InlineConfig;
+}): Promise<string>;
 //#endregion
 //#region src/index.d.ts
 declare function pracht(options?: PrachtPluginOptions): Plugin[];
 //#endregion
-export { type ChunkGroup, type EnvLeakReference, type EnvSafetyOptions, FRAMEWORK_VENDOR_CHUNK, type LlmsTxtSection, PRACHT_CAPABILITIES_MODULE_ID, PRACHT_CLIENT_MODULE_ID, PRACHT_ISLANDS_CLIENT_MODULE_ID, PRACHT_SERVER_MODULE_ID, PRACHT_WEBMCP_MODULE_ID, PUBLIC_ENV_PREFIX, type PrachtAdapter, type PrachtClientOptions, type PrachtLlmsTxtOptions, type PrachtPluginOptions, type RenderMode, VITE_BUILTIN_ENV_VARS, createEnvSafetyPlugin, createPrachtCapabilitiesClientModuleSource, createPrachtClientModuleSource, createPrachtIslandsClientModuleSource, createPrachtRegistryModuleSource, createPrachtServerModuleSource, createPrachtWebmcpModuleSource, extractCapabilities, formatEnvLeakError, frameworkChunkGroups, pracht, scanCodeForEnvLeaks };
+export { type ChunkGroup, type EnvLeakReference, type EnvSafetyOptions, FRAMEWORK_VENDOR_CHUNK, type LlmsTxtSection, PRACHT_CAPABILITIES_MODULE_ID, PRACHT_CLIENT_MODULE_ID, PRACHT_ISLANDS_CLIENT_MODULE_ID, PRACHT_SERVER_MODULE_ID, PRACHT_WEBMCP_MODULE_ID, PUBLIC_ENV_PREFIX, type PrachtAdapter, type PrachtClientOptions, type PrachtLlmsTxtOptions, type PrachtPluginOptions, type RenderMode, VITE_BUILTIN_ENV_VARS, createEnvSafetyPlugin, createPrachtCapabilitiesClientModuleSource, createPrachtClientModuleSource, createPrachtIslandsClientModuleSource, createPrachtRegistryModuleSource, createPrachtServerModuleSource, createPrachtWebmcpModuleSource, createPrachtWebmcpModuleSourceAsync, extractCapabilities, formatEnvLeakError, frameworkChunkGroups, pracht, scanCodeForEnvLeaks };