@farm.js/core 0.1.34 → 0.1.36

package/dist/{app-DgotYGbq.d.ts → app-Yfa2dsFy.d.ts}

@@ -1,16 +1,15 @@
-import { J as FarmConfig, P as ParsedRoute, aF as ResolvedFarmRouteRuntimeConfig, aG as ApplicationMetadataRouteKind, s as RouteModule, ae as LayoutModule, aj as SSGCollectionResult, e as FarmRequest, f as FarmResponse, aH as ResolvedFarmAPIConfig, aI as FarmMarkdownResolvedConfig, u as FarmMdxResolvedConfig, aJ as ResolvedFarmDevtoolsConfig, aK as ResolvedFarmDevIndicatorsConfig, aL as ResolvedFarmAuthConfig, aM as ResolvedFarmPerformanceConfig, aN as ResolvedFarmSecurityConfig } from './client-plugins-DZjHC4Mi.js';
-import { F as FarmDocsResolvedConfig } from './types-DFbjpjXX.js';
-import { F as FarmWorkflowsResolvedConfig } from './workflows-CR9ex-gz.js';
+import { I as FarmConfig, P as ParsedRoute, aK as ResolvedFarmRouteRuntimeConfig, aL as ApplicationMetadataRouteKind, s as RouteModule, ad as LayoutModule, ak as SSGCollectionResult, e as FarmRequest, f as FarmResponse, aM as ResolvedFarmAPIConfig, aN as FarmDocsResolvedConfig, aF as FarmMarkdownResolvedConfig, u as FarmMdxResolvedConfig, aO as ResolvedFarmDevtoolsConfig, aP as ResolvedFarmDevIndicatorsConfig, aQ as ResolvedFarmAuthConfig, aR as ResolvedFarmPerformanceConfig, aS as ResolvedFarmSecurityConfig } from './client-plugins-r1mOtSC1.js';
+import { F as FarmWorkflowsResolvedConfig } from './workflows-jZ4BcdoZ.js';
 import { FarmCronResolvedConfig } from './cron.js';
 import { R as ResolvedFarmImageConfig } from './image-config-Duob7wER.js';
 import { ProgrammaticRedirectRoute, ProgrammaticRouteSearchClientOptions } from './routes.js';
 import { ViteDevServer } from 'vite';
 import { F as FarmIslandStrategy } from './island-CfGru1MO.js';
-import { M as MetadataImageKind } from './metadata-Cjs8JMRM.js';
+import { M as MetadataImageKind, c as createFarmDefaultMCPServer } from './agent-mcp-luzfXK-P.js';
 import { FarmServerRendererRuntime, FarmRenderer } from './renderer.js';
-import { F as FarmRouteRenderPlan } from './render-plan-D72O1qm4.js';
-import { R as ResolvedFarmI18nConfig } from './types-Z0aotQ8w.js';
-import { F as FarmI18nRuntime } from './runtime-BirxPwbZ.js';
+import { F as FarmRouteRenderPlan } from './render-plan-Cw4f5E_R.js';
+import { R as ResolvedFarmI18nConfig } from './types-CnH8DOqo.js';
+import { F as FarmI18nRuntime } from './runtime-BgDQzBiu.js';
 import { R as ResolvedFarmThemeConfig } from './types-DQnyD3VD.js';
 
 interface IsolatedClientBoundaryReference {
@@ -35,13 +34,25 @@ interface RouteEntry {
     route: ParsedRoute;
     modulePath: string;
     markdownSourcePath?: string;
+    /**
+     * A page's URL pattern. Layouts, loading and error boundaries use their app
+     * directory instead, route groups included (`/(auth)`), because a group adds
+     * no URL segment and two of them can share one URL.
+     */
     pattern: string;
+    /** A page's directory pattern, set only when it differs from `pattern` (route groups). */
+    directory?: string;
     source?: "file" | "programmatic";
     sourceRoot: string;
 }
 interface RouteSlotEntry extends RouteEntry {
     name: string;
     ownerPattern: string;
+    /**
+     * The owning layout's pattern when route groups make it differ from
+     * `ownerPattern` (a URL pattern); slots render into the layout with this pattern.
+     */
+    ownerDirectory?: string;
     interception: boolean;
     fallback: boolean;
     containerId: string;
@@ -49,6 +60,8 @@ interface RouteSlotEntry extends RouteEntry {
 interface MatchedRouteSlot {
     name: string;
     ownerPattern: string;
+    /** See `RouteSlotEntry.ownerDirectory`. */
+    ownerDirectory?: string;
     containerId: string;
     interception: boolean;
     fallback: boolean;
@@ -58,12 +71,16 @@ interface MatchedRouteSlot {
 interface FarmClientRouteManifest {
     routes: Array<{
         pattern: string;
+        /** The page's directory pattern when route groups make it differ from `pattern`. */
+        directory?: string;
         modulePath: string;
         shouldHydrate: boolean;
         isClientComponent: boolean;
         islandStrategy: FarmIslandStrategy | null;
         hasIsolatedClientBoundaries?: true;
         isolatedBoundaries?: IsolatedClientBoundaryReference[];
+        /** The async page renders as a server tree inside its hydrating layout's root. */
+        serverTree?: true;
         renderPlan: FarmRouteRenderPlan;
         suppressedAsyncHydration?: true;
         /** Why an async page's client components could not become islands. */
@@ -179,13 +196,16 @@ declare class RouteManager {
         params: Record<string, string>;
     } | null;
     /**
-     * Return the nearest matching loading boundary for a pathname.
+     * Return the nearest matching loading boundary for a pathname. Pass the page
+     * `matchRoute` selected when it is known (`null` for none); otherwise the page is
+     * matched only if a boundary inside a route group needs it.
      */
-    getMatchingLoading(pathname: string): RouteEntry | null;
+    getMatchingLoading(pathname: string, route?: RouteEntry | null): RouteEntry | null;
     /**
-     * Return the nearest matching error boundary for a pathname.
+     * Return the nearest matching error boundary for a pathname. `route` works as it
+     * does for `getMatchingLoading`.
      */
-    getMatchingError(pathname: string): RouteEntry | null;
+    getMatchingError(pathname: string, route?: RouteEntry | null): RouteEntry | null;
     matchMetadataImage(pathname: string): {
         image: MetadataImageEntry;
         params: Record<string, string>;
@@ -244,9 +264,11 @@ declare class RouteManager {
     private discoverProgrammaticRoutes;
     private loadProgrammaticRoutesModule;
     /**
-     * Find all layouts that should wrap a given path
+     * Find all layouts that should wrap a given path. A layout inside a route group
+     * wraps only the pages in that group, so it needs the selected page.
      */
     private findMatchingLayouts;
+    private matchPageRoute;
     private findMatchingRouteSlots;
     private matchesRoutePrefix;
     private findNearestBoundary;
@@ -287,6 +309,8 @@ interface FarmNavigationFragmentLayout {
 interface FarmNavigationFragmentSlot {
     name: string;
     ownerPattern: string;
+    /** The owning layout's pattern when route groups make it differ from `ownerPattern`. */
+    ownerDirectory?: string;
     containerId: string;
     module: {
         default?: any;
@@ -305,6 +329,8 @@ interface FarmNavigationFragmentInput {
     pageShouldHydrate: boolean;
     layoutShouldHydrate: boolean;
     islandStrategy?: FarmIslandStrategy | null;
+    /** The page renders as a server tree inside its hydrating layout's root. */
+    serverTree?: boolean;
 }
 declare class ServerRenderer {
     private config;
@@ -316,6 +342,8 @@ declare class ServerRenderer {
     private rendererRuntime;
     private appliedAppSetupModule;
     private security;
+    private apiRouteExists?;
+    private defaultMCPServer?;
     constructor(config: Required<FarmConfig>, routeManager: RouteManager, i18nRuntime?: FarmI18nRuntime, viteServer?: ViteDevServer);
     initialize(): Promise<void>;
     /**
@@ -389,6 +417,18 @@ declare class ServerRenderer {
     private getAgentCrawlers;
     /** `/robots.txt` from `agent.crawlers` when no robots.ts owns it. */
     private renderGeneratedRobotsTxt;
+    private getAgentSitemap;
+    /** `/sitemap.xml` from `agent.sitemap` when no sitemap.ts owns it. */
+    private renderGeneratedSitemap;
+    /** Lets the default MCP server see the app's API routes, which the dev server owns. */
+    setAPIRouteLookup(exists: (path: string) => boolean): void;
+    /**
+     * The default read-only MCP server (`agent.mcp`), or undefined when the app has an MCP
+     * server of its own: a route that answers /mcp, an API route at /api/mcp, `@farm.js/mcp`,
+     * or a registered server such as the docs engine's. Production applies the same rules.
+     */
+    getDefaultMCPServer(): ReturnType<typeof createFarmDefaultMCPServer> | undefined;
+    private renderDefaultMCP;
     /** Same inputs the production server gives llms.txt: static pages and root metadata. */
     private createLlmsTxtContext;
     /**

package/dist/app-markdown.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkBTAG7LI7cjs = require('./chunk-BTAG7LI7.cjs');
+var _chunkJZVADIODcjs = require('./chunk-JZVADIOD.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunkBTAG7LI7cjs = require('./chunk-BTAG7LI7.cjs');
 
 
 
-var _chunkUX5S4JEOcjs = require('./chunk-UX5S4JEO.cjs');
+var _chunk42NHY7HWcjs = require('./chunk-42NHY7HW.cjs');
 
 
 
@@ -20,11 +20,11 @@ var _chunkOHY2ZWUGcjs = require('./chunk-OHY2ZWUG.cjs');
 
 
 
-var _chunkXXJU7FCCcjs = require('./chunk-XXJU7FCC.cjs');
+var _chunkEUV4YR3Vcjs = require('./chunk-EUV4YR3V.cjs');
 require('./chunk-J63ZH5OQ.cjs');
-require('./chunk-M64YUMA4.cjs');
-require('./chunk-KNBBQHO2.cjs');
+require('./chunk-75RZHGLS.cjs');
 require('./chunk-E3UK5IIB.cjs');
+require('./chunk-KNBBQHO2.cjs');
 require('./chunk-G7HXGLEC.cjs');
 require('./chunk-S3A45T7F.cjs');
 require('./chunk-FJ3M4CUX.cjs');
@@ -47,4 +47,4 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkXXJU7FCCcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.createFarmMarkdownErrorBody = _chunkXXJU7FCCcjs.createFarmMarkdownErrorBody; exports.createFarmMarkdownRouteModule = _chunkUX5S4JEOcjs.createFarmMarkdownRouteModule; exports.createFarmMarkdownRouteModuleFromFile = _chunkBTAG7LI7cjs.createFarmMarkdownRouteModuleFromFile; exports.createFarmMarkdownSourceResponse = _chunkUX5S4JEOcjs.createFarmMarkdownSourceResponse; exports.createMarkdownMetadata = _chunkUX5S4JEOcjs.createMarkdownMetadata; exports.farmRequestWantsMarkdown = _chunkXXJU7FCCcjs.farmRequestWantsMarkdown; exports.isFarmMarkdownPageFile = _chunkUX5S4JEOcjs.isFarmMarkdownPageFile; exports.isFarmMarkdownPublicSourceResponse = _chunkUX5S4JEOcjs.isFarmMarkdownPublicSourceResponse; exports.loadFarmMdxComponents = _chunkBTAG7LI7cjs.loadFarmMdxComponents; exports.normalizeFarmMarkdownRoutePath = _chunkUX5S4JEOcjs.normalizeFarmMarkdownRoutePath; exports.parseMarkdownFrontmatter = _chunkUX5S4JEOcjs.parseMarkdownFrontmatter; exports.resolveFarmMdxComponentsModulePath = _chunkOHY2ZWUGcjs.resolveFarmMdxComponentsModulePath; exports.resolveMdxConfig = _chunkOHY2ZWUGcjs.resolveMdxConfig; exports.titleFromMarkdown = _chunkUX5S4JEOcjs.titleFromMarkdown;
+exports.FARM_MARKDOWN_CONTENT_TYPE = _chunkEUV4YR3Vcjs.FARM_MARKDOWN_CONTENT_TYPE; exports.createFarmMarkdownErrorBody = _chunkEUV4YR3Vcjs.createFarmMarkdownErrorBody; exports.createFarmMarkdownRouteModule = _chunk42NHY7HWcjs.createFarmMarkdownRouteModule; exports.createFarmMarkdownRouteModuleFromFile = _chunkJZVADIODcjs.createFarmMarkdownRouteModuleFromFile; exports.createFarmMarkdownSourceResponse = _chunk42NHY7HWcjs.createFarmMarkdownSourceResponse; exports.createMarkdownMetadata = _chunk42NHY7HWcjs.createMarkdownMetadata; exports.farmRequestWantsMarkdown = _chunkEUV4YR3Vcjs.farmRequestWantsMarkdown; exports.isFarmMarkdownPageFile = _chunk42NHY7HWcjs.isFarmMarkdownPageFile; exports.isFarmMarkdownPublicSourceResponse = _chunk42NHY7HWcjs.isFarmMarkdownPublicSourceResponse; exports.loadFarmMdxComponents = _chunkJZVADIODcjs.loadFarmMdxComponents; exports.normalizeFarmMarkdownRoutePath = _chunk42NHY7HWcjs.normalizeFarmMarkdownRoutePath; exports.parseMarkdownFrontmatter = _chunk42NHY7HWcjs.parseMarkdownFrontmatter; exports.resolveFarmMdxComponentsModulePath = _chunkOHY2ZWUGcjs.resolveFarmMdxComponentsModulePath; exports.resolveMdxConfig = _chunkOHY2ZWUGcjs.resolveMdxConfig; exports.titleFromMarkdown = _chunk42NHY7HWcjs.titleFromMarkdown;

package/dist/app-markdown.d.mts

@@ -1,5 +1,5 @@
-import { t as FarmMdxComponents, u as FarmMdxResolvedConfig, s as RouteModule } from './client-plugins-CLObcuCq.mjs';
-export { z as FARM_MARKDOWN_CONTENT_TYPE, x as FarmMdxComponent, y as FarmMdxUserConfig, A as createFarmMarkdownErrorBody, B as farmRequestWantsMarkdown, v as resolveFarmMdxComponentsModulePath, w as resolveMdxConfig } from './client-plugins-CLObcuCq.mjs';
+import { t as FarmMdxComponents, u as FarmMdxResolvedConfig, s as RouteModule } from './client-plugins-C3mK9Pol.mjs';
+export { z as FARM_MARKDOWN_CONTENT_TYPE, x as FarmMdxComponent, y as FarmMdxUserConfig, A as createFarmMarkdownErrorBody, B as farmRequestWantsMarkdown, v as resolveFarmMdxComponentsModulePath, w as resolveMdxConfig } from './client-plugins-C3mK9Pol.mjs';
 export { FarmMarkdownPageModuleInput, FarmMarkdownPageSource, createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse, createMarkdownMetadata, isFarmMarkdownPageFile, isFarmMarkdownPublicSourceResponse, normalizeFarmMarkdownRoutePath, parseMarkdownFrontmatter, titleFromMarkdown } from './internal/app-markdown-runtime.mjs';
 import './lifecycle-DK06VuKP.mjs';
 import './integration-api-0y4FXJpC.mjs';
@@ -18,19 +18,18 @@ import 'unstorage';
 import './schema.mjs';
 import 'react';
 import '@farming-labs/orm';
-import './types-DFbjpjXX.mjs';
 import '@farming-labs/docs';
-import './observability-BupkiN0m.mjs';
+import './observability-CoXunYhS.mjs';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-CR9ex-gz.mjs';
+import './workflows-jZ4BcdoZ.mjs';
 import './cron.mjs';
 import './env.mjs';
 import './server-action-security.mjs';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-Duob7wER.mjs';
-import './types-Z0aotQ8w.mjs';
+import './types-CnH8DOqo.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';
 import './after.mjs';

package/dist/app-markdown.d.ts

@@ -1,5 +1,5 @@
-import { t as FarmMdxComponents, u as FarmMdxResolvedConfig, s as RouteModule } from './client-plugins-DZjHC4Mi.js';
-export { z as FARM_MARKDOWN_CONTENT_TYPE, x as FarmMdxComponent, y as FarmMdxUserConfig, A as createFarmMarkdownErrorBody, B as farmRequestWantsMarkdown, v as resolveFarmMdxComponentsModulePath, w as resolveMdxConfig } from './client-plugins-DZjHC4Mi.js';
+import { t as FarmMdxComponents, u as FarmMdxResolvedConfig, s as RouteModule } from './client-plugins-r1mOtSC1.js';
+export { z as FARM_MARKDOWN_CONTENT_TYPE, x as FarmMdxComponent, y as FarmMdxUserConfig, A as createFarmMarkdownErrorBody, B as farmRequestWantsMarkdown, v as resolveFarmMdxComponentsModulePath, w as resolveMdxConfig } from './client-plugins-r1mOtSC1.js';
 export { FarmMarkdownPageModuleInput, FarmMarkdownPageSource, createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse, createMarkdownMetadata, isFarmMarkdownPageFile, isFarmMarkdownPublicSourceResponse, normalizeFarmMarkdownRoutePath, parseMarkdownFrontmatter, titleFromMarkdown } from './internal/app-markdown-runtime.js';
 import './lifecycle-DK06VuKP.js';
 import './integration-api-BPJo5oXb.js';
@@ -18,19 +18,18 @@ import 'unstorage';
 import './schema.js';
 import 'react';
 import '@farming-labs/orm';
-import './types-DFbjpjXX.js';
 import '@farming-labs/docs';
-import './observability-BupkiN0m.js';
+import './observability-CoXunYhS.js';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-CR9ex-gz.js';
+import './workflows-jZ4BcdoZ.js';
 import './cron.js';
 import './env.js';
 import './server-action-security.js';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-Duob7wER.js';
-import './types-Z0aotQ8w.js';
+import './types-CnH8DOqo.js';
 import './types-DQnyD3VD.js';
 import './font.js';
 import './after.js';

package/dist/app-markdown.mjs

@@ -1,7 +1,7 @@
 import {
   createFarmMarkdownRouteModuleFromFile,
   loadFarmMdxComponents
-} from "./chunk-3VSKDFAT.mjs";
+} from "./chunk-WZ77PUAM.mjs";
 import {
   createFarmMarkdownRouteModule,
   createFarmMarkdownSourceResponse,
@@ -11,7 +11,7 @@ import {
   normalizeFarmMarkdownRoutePath,
   parseMarkdownFrontmatter,
   titleFromMarkdown
-} from "./chunk-AGC75XAE.mjs";
+} from "./chunk-4WCZJQUO.mjs";
 import {
   resolveFarmMdxComponentsModulePath,
   resolveMdxConfig
@@ -20,11 +20,11 @@ import {
   FARM_MARKDOWN_CONTENT_TYPE,
   createFarmMarkdownErrorBody,
   farmRequestWantsMarkdown
-} from "./chunk-ZUSJDQ2Q.mjs";
+} from "./chunk-WWIKMBRN.mjs";
 import "./chunk-MVL2RAJW.mjs";
-import "./chunk-QLQ32WC4.mjs";
-import "./chunk-BTHHUD7Q.mjs";
+import "./chunk-ZLAT2CWY.mjs";
 import "./chunk-FUZEBRP3.mjs";
+import "./chunk-BTHHUD7Q.mjs";
 import "./chunk-O7BH5O46.mjs";
 import "./chunk-7LTCDQRS.mjs";
 import "./chunk-Z3HATSKO.mjs";