@pracht/vite-plugin 0.10.0 → 0.11.1

package/dist/index.d.mts

@@ -135,6 +135,21 @@ interface PrachtLlmsTxtOptions {
    * ```
    */
   exclude?: string[];
+  /**
+   * Ceiling on how many prerendered instances a single dynamic route
+   * contributes to the Pages section. Defaults to 50; `0` lists every
+   * instance.
+   *
+   * The instances kept are the first ones `getStaticPaths()` returns, after
+   * `exclude` is applied — the author's order, which for a blog is usually
+   * newest-first.
+   *
+   * llms.txt is an index, not a sitemap. A 5,000-post blog expanded through
+   * `getStaticPaths()` produces a 5,000-line, 180 KB file — larger than most
+   * agent context budgets. Truncation is never silent: a line above the Pages
+   * section names the route and the ratio it lists.
+   */
+  maxPagesPerRoute?: number;
 }
 /**
  * Optional client-router features, compiled out of the client bundle when
@@ -157,6 +172,16 @@ interface PrachtPluginOptions {
    * compiled out of the client bundle. See {@link PrachtClientOptions}.
    */
   client?: PrachtClientOptions;
+  /**
+   * Group the Preact runtime into a shared `vendor` chunk. Defaults to `true`.
+   *
+   * The group is appended to whatever `build.rollupOptions.output` chunking
+   * the app configures, so app-level grouping and the framework chunk compose
+   * (see `frameworkChunkGroups()`). Set `false` to contribute nothing at all —
+   * for an app that places `frameworkChunkGroups()` itself, or one that wants
+   * Preact merged into its own chunks.
+   */
+  vendorChunk?: boolean;
   appFile?: string;
   routesDir?: string;
   shellsDir?: string;
@@ -218,6 +243,50 @@ interface PrachtPluginOptions {
   llmsTxt?: false | PrachtLlmsTxtOptions;
 }
 //#endregion
+//#region src/chunk-groups.d.ts
+/**
+ * Pracht's client chunking policy, expressed as something an app can build on.
+ *
+ * The framework has exactly one opinion here: Preact belongs in its own chunk,
+ * shared by every route and cached across deploys that only change app code.
+ * Everything else about chunking is the app's call — merging the long tail of
+ * small initial chunks, splitting a heavy dependency out of a route, grouping
+ * by feature.
+ *
+ * Those two have to coexist, and under Rolldown that is not automatic:
+ * `output.codeSplitting` makes `manualChunks` and `advancedChunks` ignored
+ * outright, so a plugin that hard-codes one form silently deletes whichever
+ * form the app used. Pracht therefore looks at what the app configured and
+ * contributes its group in the same form, as one entry appended to the app's
+ * list rather than as a replacement for it.
+ *
+ * Precedence follows Rolldown's own rule — higher `priority` first, then
+ * declaration order. The app's groups are declared first, so an app group that
+ * would also capture Preact wins at equal priority, and pracht's group only
+ * takes what nothing else claimed. To keep the framework chunk intact while
+ * merging everything around it, give the app group a `test` that excludes
+ * Preact, or raise pracht's group by placing {@link frameworkChunkGroups}
+ * explicitly and setting `vendorChunk: false`.
+ */
+/** Name of the chunk pracht groups the Preact runtime into. */
+declare const FRAMEWORK_VENDOR_CHUNK = "vendor";
+interface ChunkGroup {
+  name: string;
+  test?: RegExp | string;
+  priority?: number;
+  minSize?: number;
+  [option: string]: unknown;
+}
+/**
+ * Pracht's chunk groups, as a fresh array an app can place in its own
+ * `output.codeSplitting.groups`.
+ *
+ * Use this together with `pracht({ vendorChunk: false })` when the framework
+ * group has to sit somewhere other than last — pracht then contributes no
+ * chunking config of its own and the app's list is the whole policy.
+ */
+declare function frameworkChunkGroups(): ChunkGroup[];
+//#endregion
 //#region src/plugin-codegen.d.ts
 declare function createPrachtClientModuleSource(options?: PrachtPluginOptions, buildOptions?: {
   root?: string;
@@ -244,10 +313,12 @@ interface ExtractedCapability {
   name: string;
   /** Manifest-relative module path, e.g. "./capabilities/notes-search.ts". */
   file: string;
+  title: string;
   description: string;
   effect: string | null;
   httpPath: string | null;
   webmcp: boolean;
+  webmcpUntrustedContent: boolean;
   inputSchema: Record<string, unknown> | null;
 }
 /**
@@ -276,9 +347,17 @@ declare function createPrachtCapabilitiesClientModuleSource(options?: PrachtPlug
  * validation/middleware/policy stays server-side. Each dispatch carries the
  * transport marker header so audit events can attribute it to WebMCP.
  *
- * Targets the Chrome origin-trial API: `document.modelContext.registerTool()`
- * (Chrome 150+; `navigator.modelContext` is the deprecated pre-150 location
- * and is kept as a fallback). No-ops silently when the API is absent.
+ * 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.
  */
 declare function createPrachtWebmcpModuleSource(options?: PrachtPluginOptions, buildOptions?: {
   root?: string;
@@ -287,4 +366,4 @@ declare function createPrachtWebmcpModuleSource(options?: PrachtPluginOptions, b
 //#region src/index.d.ts
 declare function pracht(options?: PrachtPluginOptions): Plugin[];
 //#endregion
-export { type EnvLeakReference, type EnvSafetyOptions, 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, 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, extractCapabilities, formatEnvLeakError, frameworkChunkGroups, pracht, scanCodeForEnvLeaks };