@farm.js/core 0.1.0-beta.6 → 0.1.0-beta.8

package/dist/query/server.d.mts

@@ -0,0 +1,55 @@
+import { Parser } from './parsers.mjs';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.mjs';
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-ry-lxqmy.mjs';
+
+/**
+ * Farm.js Server-Side Query State Management
+ *
+ * Server-side utilities for parsing and handling URL search parameters
+ */
+
+type SearchParams = Record<string, string | string[] | undefined>;
+/**
+ * Server-side utility to load and parse search parameters
+ *
+ * @example
+ * ```tsx
+ * // In a server component
+ * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';
+ *
+ * export default async function MyPage({ searchParams }: PageProps) {
+ *   const params = await loadSearchParams(searchParams, {
+ *     search: parseAsString.withDefault!(''),
+ *     page: parseAsInteger.withDefault!(1),
+ *   });
+ *
+ *   return <div>Search: {params.search}, Page: {params.page}</div>;
+ * }
+ * ```
+ */
+declare function loadSearchParams<T extends Record<string, Parser<any>>>(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, parsers: T): Promise<{
+    [K in keyof T]: ReturnType<T[K]["parse"]>;
+}>;
+/**
+ * Creates pagination metadata for server components.
+ *
+ * @param searchParams The search parameters promise.
+ * @param options Configuration options for pagination.
+ * @returns Pagination metadata.
+ */
+declare function createPaginationMeta(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, options: {
+    totalItems: number;
+    itemsPerPage?: number;
+    pageParam?: string;
+}): Promise<{
+    currentPage: number;
+    itemsPerPage: number;
+    totalItems: number;
+    totalPages: number;
+    offset: number;
+    limit: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}>;
+
+export { Parser, type SearchParams, createPaginationMeta, loadSearchParams };

package/dist/query/server.d.ts

@@ -0,0 +1,55 @@
+import { Parser } from './parsers.js';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.js';
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-BALtrRim.js';
+
+/**
+ * Farm.js Server-Side Query State Management
+ *
+ * Server-side utilities for parsing and handling URL search parameters
+ */
+
+type SearchParams = Record<string, string | string[] | undefined>;
+/**
+ * Server-side utility to load and parse search parameters
+ *
+ * @example
+ * ```tsx
+ * // In a server component
+ * import { loadSearchParams, parseAsString, parseAsInteger } from 'farm/query/server';
+ *
+ * export default async function MyPage({ searchParams }: PageProps) {
+ *   const params = await loadSearchParams(searchParams, {
+ *     search: parseAsString.withDefault!(''),
+ *     page: parseAsInteger.withDefault!(1),
+ *   });
+ *
+ *   return <div>Search: {params.search}, Page: {params.page}</div>;
+ * }
+ * ```
+ */
+declare function loadSearchParams<T extends Record<string, Parser<any>>>(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, parsers: T): Promise<{
+    [K in keyof T]: ReturnType<T[K]["parse"]>;
+}>;
+/**
+ * Creates pagination metadata for server components.
+ *
+ * @param searchParams The search parameters promise.
+ * @param options Configuration options for pagination.
+ * @returns Pagination metadata.
+ */
+declare function createPaginationMeta(searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>, options: {
+    totalItems: number;
+    itemsPerPage?: number;
+    pageParam?: string;
+}): Promise<{
+    currentPage: number;
+    itemsPerPage: number;
+    totalItems: number;
+    totalPages: number;
+    offset: number;
+    limit: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}>;
+
+export { Parser, type SearchParams, createPaginationMeta, loadSearchParams };

package/dist/request-Dsq4kGW0.d.mts

@@ -0,0 +1,6 @@
+import './types-BMxWr97v.mjs';
+
+declare function _runWithCurrentRequest<T>(request: Request, fn: () => Promise<T> | T): Promise<T>;
+declare function getCurrentRequest(): Request;
+
+export { _runWithCurrentRequest as _, getCurrentRequest as g };

package/dist/request-udtobOLv.d.ts

@@ -0,0 +1,6 @@
+import './types-BMxWr97v.js';
+
+declare function _runWithCurrentRequest<T>(request: Request, fn: () => Promise<T> | T): Promise<T>;
+declare function getCurrentRequest(): Request;
+
+export { _runWithCurrentRequest as _, getCurrentRequest as g };

package/dist/request.d.mts

@@ -0,0 +1,2 @@
+export { g as getCurrentRequest } from './request-Dsq4kGW0.mjs';
+import './types-BMxWr97v.mjs';

package/dist/request.d.ts

@@ -0,0 +1,2 @@
+export { g as getCurrentRequest } from './request-udtobOLv.js';
+import './types-BMxWr97v.js';

package/dist/resolver-DJqjLMg_.d.mts

@@ -0,0 +1,14 @@
+import { b as FarmI18nLocaleSource, R as ResolvedFarmI18nConfig } from './types-BMxWr97v.mjs';
+
+interface FarmLocaleResolution {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    pathname: string;
+    redirect?: string;
+    persist: boolean;
+}
+declare function getFarmLocaleVaryHeaders(config: ResolvedFarmI18nConfig, resolution: FarmLocaleResolution): string[];
+declare function createFarmLocaleCookie(locale: string, config: Pick<ResolvedFarmI18nConfig, "cookie">): string;
+declare function matchFarmLocale(requested: string | null | undefined, locales: readonly string[]): string | undefined;
+
+export { type FarmLocaleResolution as F, createFarmLocaleCookie as c, getFarmLocaleVaryHeaders as g, matchFarmLocale as m };

package/dist/resolver-IH4RmPEl.d.ts

@@ -0,0 +1,14 @@
+import { b as FarmI18nLocaleSource, R as ResolvedFarmI18nConfig } from './types-BMxWr97v.js';
+
+interface FarmLocaleResolution {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    pathname: string;
+    redirect?: string;
+    persist: boolean;
+}
+declare function getFarmLocaleVaryHeaders(config: ResolvedFarmI18nConfig, resolution: FarmLocaleResolution): string[];
+declare function createFarmLocaleCookie(locale: string, config: Pick<ResolvedFarmI18nConfig, "cookie">): string;
+declare function matchFarmLocale(requested: string | null | undefined, locales: readonly string[]): string | undefined;
+
+export { type FarmLocaleResolution as F, createFarmLocaleCookie as c, getFarmLocaleVaryHeaders as g, matchFarmLocale as m };

package/dist/route-runtime-DoOHzCAD.d.mts

@@ -0,0 +1,38 @@
+type FarmRouteRuntime = "auto" | "node" | "edge";
+type FarmRouteRegions = "auto" | readonly string[];
+type FarmRouteMaxDuration = "auto" | number;
+/** Portable execution controls shared by file, programmatic, and config routes. */
+interface FarmRouteRuntimeConfig {
+    runtime?: FarmRouteRuntime;
+    regions?: FarmRouteRegions;
+    maxDuration?: FarmRouteMaxDuration;
+}
+interface ResolvedFarmRouteRuntimeConfig {
+    runtime: FarmRouteRuntime;
+    regions?: string[];
+    maxDuration?: number;
+}
+type FarmRouteRuntimeEntryKind = "page" | "api" | "rule";
+type FarmRouteRenderingMode = "static" | "dynamic";
+interface FarmRouteRuntimeManifestEntry extends ResolvedFarmRouteRuntimeConfig {
+    kind: FarmRouteRuntimeEntryKind;
+    pattern: string;
+    rendering: FarmRouteRenderingMode;
+    source?: string;
+}
+interface FarmRouteRuntimeManifest {
+    version: 1;
+    routes: FarmRouteRuntimeManifestEntry[];
+}
+declare function normalizeFarmRouteRuntimeConfig(value: FarmRouteRuntimeConfig | null | undefined, source?: string): FarmRouteRuntimeConfig;
+/** Merge from lowest to highest precedence. Explicit "auto" values reset inherited hints. */
+declare function mergeFarmRouteRuntimeConfigs(...configs: Array<FarmRouteRuntimeConfig | null | undefined>): FarmRouteRuntimeConfig;
+declare function resolveFarmRouteRuntimeConfig(config: FarmRouteRuntimeConfig | null | undefined, source?: string): ResolvedFarmRouteRuntimeConfig;
+declare function hasFarmRouteRuntimeControls(config: FarmRouteRuntimeConfig | null | undefined): boolean;
+declare function getFarmRouteRuntimeConfig(value: unknown): FarmRouteRuntimeConfig;
+declare function createFarmRouteRuntimeKey(config: ResolvedFarmRouteRuntimeConfig): string;
+/** Resolve matching route rules from broadest to most specific. */
+declare function resolveFarmRouteRuleRuntimeConfig(pathname: string, routeRules: Record<string, FarmRouteRuntimeConfig> | null | undefined): FarmRouteRuntimeConfig;
+declare function farmRouteRuleMatches(pattern: string, pathname: string): boolean;
+
+export { type FarmRouteRuntimeConfig as F, type ResolvedFarmRouteRuntimeConfig as R, type FarmRouteRuntime as a, type FarmRouteRegions as b, type FarmRouteMaxDuration as c, type FarmRouteRuntimeEntryKind as d, type FarmRouteRenderingMode as e, type FarmRouteRuntimeManifestEntry as f, type FarmRouteRuntimeManifest as g, hasFarmRouteRuntimeControls as h, getFarmRouteRuntimeConfig as i, createFarmRouteRuntimeKey as j, resolveFarmRouteRuleRuntimeConfig as k, farmRouteRuleMatches as l, mergeFarmRouteRuntimeConfigs as m, normalizeFarmRouteRuntimeConfig as n, resolveFarmRouteRuntimeConfig as r };

package/dist/route-runtime-DoOHzCAD.d.ts

@@ -0,0 +1,38 @@
+type FarmRouteRuntime = "auto" | "node" | "edge";
+type FarmRouteRegions = "auto" | readonly string[];
+type FarmRouteMaxDuration = "auto" | number;
+/** Portable execution controls shared by file, programmatic, and config routes. */
+interface FarmRouteRuntimeConfig {
+    runtime?: FarmRouteRuntime;
+    regions?: FarmRouteRegions;
+    maxDuration?: FarmRouteMaxDuration;
+}
+interface ResolvedFarmRouteRuntimeConfig {
+    runtime: FarmRouteRuntime;
+    regions?: string[];
+    maxDuration?: number;
+}
+type FarmRouteRuntimeEntryKind = "page" | "api" | "rule";
+type FarmRouteRenderingMode = "static" | "dynamic";
+interface FarmRouteRuntimeManifestEntry extends ResolvedFarmRouteRuntimeConfig {
+    kind: FarmRouteRuntimeEntryKind;
+    pattern: string;
+    rendering: FarmRouteRenderingMode;
+    source?: string;
+}
+interface FarmRouteRuntimeManifest {
+    version: 1;
+    routes: FarmRouteRuntimeManifestEntry[];
+}
+declare function normalizeFarmRouteRuntimeConfig(value: FarmRouteRuntimeConfig | null | undefined, source?: string): FarmRouteRuntimeConfig;
+/** Merge from lowest to highest precedence. Explicit "auto" values reset inherited hints. */
+declare function mergeFarmRouteRuntimeConfigs(...configs: Array<FarmRouteRuntimeConfig | null | undefined>): FarmRouteRuntimeConfig;
+declare function resolveFarmRouteRuntimeConfig(config: FarmRouteRuntimeConfig | null | undefined, source?: string): ResolvedFarmRouteRuntimeConfig;
+declare function hasFarmRouteRuntimeControls(config: FarmRouteRuntimeConfig | null | undefined): boolean;
+declare function getFarmRouteRuntimeConfig(value: unknown): FarmRouteRuntimeConfig;
+declare function createFarmRouteRuntimeKey(config: ResolvedFarmRouteRuntimeConfig): string;
+/** Resolve matching route rules from broadest to most specific. */
+declare function resolveFarmRouteRuleRuntimeConfig(pathname: string, routeRules: Record<string, FarmRouteRuntimeConfig> | null | undefined): FarmRouteRuntimeConfig;
+declare function farmRouteRuleMatches(pattern: string, pathname: string): boolean;
+
+export { type FarmRouteRuntimeConfig as F, type ResolvedFarmRouteRuntimeConfig as R, type FarmRouteRuntime as a, type FarmRouteRegions as b, type FarmRouteMaxDuration as c, type FarmRouteRuntimeEntryKind as d, type FarmRouteRenderingMode as e, type FarmRouteRuntimeManifestEntry as f, type FarmRouteRuntimeManifest as g, hasFarmRouteRuntimeControls as h, getFarmRouteRuntimeConfig as i, createFarmRouteRuntimeKey as j, resolveFarmRouteRuleRuntimeConfig as k, farmRouteRuleMatches as l, mergeFarmRouteRuntimeConfigs as m, normalizeFarmRouteRuntimeConfig as n, resolveFarmRouteRuntimeConfig as r };

package/dist/router.d.mts

@@ -0,0 +1,36 @@
+type FarmRouterPrimitiveParam = string | number | boolean;
+type FarmRouterPathParam = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+type FarmRouterPathParams = Record<string, FarmRouterPathParam>;
+type FarmRouterParams = Record<string, string>;
+interface FarmRouterRoute<TMeta = unknown> {
+    path: string;
+    name?: string;
+    meta?: TMeta;
+}
+type FarmRouterRouteInput<TMeta = unknown> = string | FarmRouterRoute<TMeta>;
+interface FarmRouterMatch<TMeta = unknown> {
+    route: FarmRouterRoute<TMeta>;
+    pathname: string;
+    params: FarmRouterParams;
+}
+type FarmRouterQueryValue = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+interface FarmRouterBuildOptions {
+    query?: URLSearchParams | Record<string, FarmRouterQueryValue>;
+    hash?: string;
+    trailingSlash?: boolean;
+}
+interface FarmRouterActiveOptions {
+    exact?: boolean;
+}
+interface FarmRouter<TMeta = unknown> {
+    routes: FarmRouterRoute<TMeta>[];
+    match(pathname: string): FarmRouterMatch<TMeta> | null;
+    build(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+    isActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+}
+declare function createFarmRouter<TMeta = unknown>(routes: FarmRouterRouteInput<TMeta>[]): FarmRouter<TMeta>;
+declare function matchFarmRoute(pattern: string, pathname: string): FarmRouterParams | null;
+declare function buildFarmRoutePath(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+declare function isFarmRouteActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+
+export { type FarmRouter, type FarmRouterActiveOptions, type FarmRouterBuildOptions, type FarmRouterMatch, type FarmRouterParams, type FarmRouterPathParam, type FarmRouterPathParams, type FarmRouterPrimitiveParam, type FarmRouterQueryValue, type FarmRouterRoute, type FarmRouterRouteInput, buildFarmRoutePath, createFarmRouter, isFarmRouteActive, matchFarmRoute };

package/dist/router.d.ts

@@ -0,0 +1,36 @@
+type FarmRouterPrimitiveParam = string | number | boolean;
+type FarmRouterPathParam = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+type FarmRouterPathParams = Record<string, FarmRouterPathParam>;
+type FarmRouterParams = Record<string, string>;
+interface FarmRouterRoute<TMeta = unknown> {
+    path: string;
+    name?: string;
+    meta?: TMeta;
+}
+type FarmRouterRouteInput<TMeta = unknown> = string | FarmRouterRoute<TMeta>;
+interface FarmRouterMatch<TMeta = unknown> {
+    route: FarmRouterRoute<TMeta>;
+    pathname: string;
+    params: FarmRouterParams;
+}
+type FarmRouterQueryValue = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+interface FarmRouterBuildOptions {
+    query?: URLSearchParams | Record<string, FarmRouterQueryValue>;
+    hash?: string;
+    trailingSlash?: boolean;
+}
+interface FarmRouterActiveOptions {
+    exact?: boolean;
+}
+interface FarmRouter<TMeta = unknown> {
+    routes: FarmRouterRoute<TMeta>[];
+    match(pathname: string): FarmRouterMatch<TMeta> | null;
+    build(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+    isActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+}
+declare function createFarmRouter<TMeta = unknown>(routes: FarmRouterRouteInput<TMeta>[]): FarmRouter<TMeta>;
+declare function matchFarmRoute(pattern: string, pathname: string): FarmRouterParams | null;
+declare function buildFarmRoutePath(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+declare function isFarmRouteActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+
+export { type FarmRouter, type FarmRouterActiveOptions, type FarmRouterBuildOptions, type FarmRouterMatch, type FarmRouterParams, type FarmRouterPathParam, type FarmRouterPathParams, type FarmRouterPrimitiveParam, type FarmRouterQueryValue, type FarmRouterRoute, type FarmRouterRouteInput, buildFarmRoutePath, createFarmRouter, isFarmRouteActive, matchFarmRoute };

package/dist/routes.d.mts

@@ -0,0 +1,224 @@
+import { F as FarmRouteRuntimeConfig, a as FarmRouteRuntime, b as FarmRouteRegions, c as FarmRouteMaxDuration } from './route-runtime-DoOHzCAD.mjs';
+import { ComponentType } from 'react';
+import { RouteDataCacheKey } from './cache.mjs';
+import { k as LayoutProps, s as Metadata, h as FarmAppContext, i as PageProps, P as PluginContextProps, p as RouteModule, x as ParsedRoute } from './client-plugins-BI2R6Eae.mjs';
+import './plugin-BJDf43dc.mjs';
+import 'http';
+import './types-D1A6-XvH.mjs';
+import 'db0';
+import 'unstorage';
+import './integration-api-CHT2OKAf.mjs';
+import '@farming-labs/orm';
+import './types-C9N-nk5R.mjs';
+import '@farming-labs/docs';
+import './markdown.mjs';
+import './observability.mjs';
+import 'vite';
+import './workflows.mjs';
+import './cron.mjs';
+import './env.mjs';
+import './server-action-security.mjs';
+import './image-config-Duob7wER.mjs';
+import './types-BMxWr97v.mjs';
+
+type ProgrammaticRouteRenderMode = "static" | "dynamic";
+type ProgrammaticRouteMethod = "GET" | "HEAD" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS";
+type ProgrammaticRoutePrimitive = string | number | boolean;
+type ProgrammaticStaticPathParams = Record<string, ProgrammaticRoutePrimitive | readonly ProgrammaticRoutePrimitive[]>;
+type ProgrammaticStaticPath = string | readonly ProgrammaticRoutePrimitive[] | ProgrammaticStaticPathParams;
+type ProgrammaticStaticPaths = () => readonly ProgrammaticStaticPath[] | Promise<readonly ProgrammaticStaticPath[]>;
+interface ProgrammaticRouteSchema<TOutput = unknown> {
+    parse(value: unknown): TOutput;
+}
+interface ProgrammaticRouteSearchOptions<TOutput = ProgrammaticRouteSearchFallback> {
+    schema?: ProgrammaticRouteSchema<TOutput>;
+    stripDefaults?: boolean | readonly string[];
+    preserve?: readonly string[];
+    temporary?: readonly string[];
+}
+type ProgrammaticRouteSearchConfig<TOutput = ProgrammaticRouteSearchFallback> = ProgrammaticRouteSchema<TOutput> | ProgrammaticRouteSearchOptions<TOutput>;
+type InferProgrammaticRouteSchema<TSchema, TFallback> = TSchema extends ProgrammaticRouteSchema<infer TOutput> ? TOutput : TFallback;
+type InferProgrammaticRouteSearch<TSearch, TFallback> = TSearch extends ProgrammaticRouteSearchOptions<infer TOutput> ? TOutput : TSearch extends ProgrammaticRouteSchema<infer TOutput> ? TOutput : TFallback;
+type ProgrammaticRouteParamsFallback = Record<string, string>;
+type ProgrammaticRouteSearchFallback = Record<string, string | string[] | undefined>;
+type ProgrammaticRouteMaybePromise<T> = T | Promise<T>;
+type ProgrammaticRouteDataStaleTime = number | false | `${number}ms` | `${number}s` | `${number}m` | `${number}h`;
+type ProgrammaticRouteContext = keyof FarmAppContext extends never ? unknown : FarmAppContext;
+type ProgrammaticRouteComponentProps<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TData = undefined> = Omit<PageProps, "params" | "searchParams"> & {
+    params: TParams;
+    search: TSearch;
+    searchParams: Promise<TSearch>;
+} & ([TData] extends [undefined] ? {
+    data?: undefined;
+} : {
+    data: TData;
+});
+type ProgrammaticRouteDataContext<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TContext = ProgrammaticRouteContext> = Omit<ProgrammaticRouteComponentProps<TParams, TSearch>, "context" | "data"> & {
+    context: TContext;
+    pluginContext?: PluginContextProps;
+};
+type ProgrammaticRouteDataCacheContext<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TBefore = unknown, TContext = ProgrammaticRouteContext> = ProgrammaticRouteDataContext<TParams, TSearch, TContext> & {
+    before: TBefore;
+};
+type ProgrammaticRouteGuardContext<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TContext = ProgrammaticRouteContext> = ProgrammaticRouteDataContext<TParams, TSearch, TContext>;
+type ProgrammaticRouteGuard<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TContext = ProgrammaticRouteContext> = (context: ProgrammaticRouteGuardContext<TParams, TSearch, TContext>) => ProgrammaticRouteMaybePromise<void>;
+type ProgrammaticRouteErrorComponentProps<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback> = Partial<ProgrammaticRouteComponentProps<TParams, TSearch>> & {
+    error: unknown;
+};
+type ProgrammaticRoutePendingComponentProps<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback> = Partial<ProgrammaticRouteComponentProps<TParams, TSearch>>;
+type ProgrammaticRouteDataCacheKeys<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TBefore = unknown, TContext = ProgrammaticRouteContext> = readonly string[] | ((context: ProgrammaticRouteDataCacheContext<TParams, TSearch, TBefore, TContext>) => ProgrammaticRouteMaybePromise<readonly string[]>);
+interface ProgrammaticRouteDataHooks<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TBefore = unknown, TData = unknown, TContext = ProgrammaticRouteContext> {
+    key?: (context: ProgrammaticRouteDataCacheContext<TParams, TSearch, NoInfer<TBefore>, TContext>) => ProgrammaticRouteMaybePromise<RouteDataCacheKey | null | undefined>;
+    staleTime?: ProgrammaticRouteDataStaleTime;
+    tags?: ProgrammaticRouteDataCacheKeys<TParams, TSearch, NoInfer<TBefore>, TContext>;
+    paths?: ProgrammaticRouteDataCacheKeys<TParams, TSearch, NoInfer<TBefore>, TContext>;
+    before?: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext>) => ProgrammaticRouteMaybePromise<TBefore>;
+    main: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext> & {
+        before: NoInfer<TBefore>;
+    }) => ProgrammaticRouteMaybePromise<TData>;
+    after?: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext> & {
+        before: NoInfer<TBefore>;
+        data: NoInfer<TData>;
+    }) => ProgrammaticRouteMaybePromise<void>;
+}
+type InferProgrammaticRouteData<TDataHooks> = TDataHooks extends {
+    main: (...args: any[]) => infer TResult;
+} ? Awaited<TResult> : undefined;
+interface ProgrammaticPageRoute<TParams = ProgrammaticRouteParamsFallback, TSearch = ProgrammaticRouteSearchFallback, TDataHooks extends ProgrammaticRouteDataHooks<TParams, TSearch, any, any, any> | undefined = ProgrammaticRouteDataHooks<TParams, TSearch, any, any, any> | undefined, TContext = ProgrammaticRouteContext> extends FarmRouteRuntimeConfig {
+    kind: "page";
+    path: string;
+    component: ComponentType<any>;
+    params?: ProgrammaticRouteSchema<TParams>;
+    search?: ProgrammaticRouteSearchConfig<TSearch>;
+    guard?: ProgrammaticRouteGuard<TParams, TSearch, TContext>;
+    data?: TDataHooks;
+    pending?: ComponentType<ProgrammaticRoutePendingComponentProps<TParams, TSearch>>;
+    error?: ComponentType<ProgrammaticRouteErrorComponentProps<TParams, TSearch>>;
+    notFound?: ComponentType<ProgrammaticRouteErrorComponentProps<TParams, TSearch>>;
+    render?: ProgrammaticRouteRenderMode;
+    staticPaths?: ProgrammaticStaticPaths;
+    revalidate?: number | false;
+    ppr?: boolean;
+    metadata?: Metadata & Record<string, any>;
+    generateMetadata?: RouteModule["generateMetadata"];
+}
+interface ProgrammaticLayoutRoute extends FarmRouteRuntimeConfig {
+    kind: "layout";
+    path: string;
+    component: ComponentType<LayoutProps>;
+    metadata?: Metadata & Record<string, any>;
+    generateMetadata?: (props: {
+        params: Record<string, string>;
+    }) => Promise<Metadata> | Metadata;
+}
+type ProgrammaticApiRouteOptions = Partial<Record<ProgrammaticRouteMethod, any>> & {
+    render?: ProgrammaticRouteRenderMode;
+} & FarmRouteRuntimeConfig;
+interface ProgrammaticApiRoute extends FarmRouteRuntimeConfig {
+    kind: "api";
+    path: string;
+    methods: Partial<Record<ProgrammaticRouteMethod, any>>;
+    render?: ProgrammaticRouteRenderMode;
+}
+interface ProgrammaticRedirectRoute {
+    kind: "redirect";
+    source: string;
+    destination: string;
+    permanent?: boolean;
+    statusCode?: number;
+}
+type ProgrammaticRouteDefinition = ProgrammaticPageRoute<any, any> | ProgrammaticLayoutRoute | ProgrammaticApiRoute | ProgrammaticRedirectRoute;
+interface ProgrammaticRouteManifest {
+    readonly __farmRoutes: true;
+    routes: ProgrammaticRouteDefinition[];
+}
+interface ProgrammaticRouteBuilder {
+    page(path: string, options: Omit<ProgrammaticPageRoute<any, any>, "kind" | "path">): ProgrammaticPageRoute;
+    layout(path: string, options: Omit<ProgrammaticLayoutRoute, "kind" | "path">): ProgrammaticLayoutRoute;
+    api(path: string, options: ProgrammaticApiRouteOptions): ProgrammaticApiRoute;
+    redirect(source: string, destination: string, options?: Omit<ProgrammaticRedirectRoute, "kind" | "source" | "destination">): ProgrammaticRedirectRoute;
+}
+type ProgrammaticRouteFactory = (builder: ProgrammaticRouteBuilder) => readonly ProgrammaticRouteDefinition[];
+type CreateRouteParams<TParamsSchema> = InferProgrammaticRouteSchema<TParamsSchema, ProgrammaticRouteParamsFallback>;
+type CreateRouteSearch<TSearchConfig> = InferProgrammaticRouteSearch<TSearchConfig, ProgrammaticRouteSearchFallback>;
+type CreateRouteSharedOptions<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined> = Omit<ProgrammaticPageRoute<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>>, "kind" | "path" | "component" | "params" | "search" | "data" | "guard"> & {
+    params?: TParamsSchema;
+    search?: TSearchConfig;
+    guard?: ProgrammaticRouteGuard<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>>;
+};
+type CreateRouteDataHooksWithBefore<TParams, TSearch, TBeforeResult, TMainResult, TContext = ProgrammaticRouteContext> = Omit<ProgrammaticRouteDataHooks<TParams, TSearch, NoInfer<Awaited<TBeforeResult>>, NoInfer<Awaited<TMainResult>>, TContext>, "before" | "main"> & {
+    before: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext>) => TBeforeResult;
+    main: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext> & {
+        before: NoInfer<Awaited<TBeforeResult>>;
+    }) => TMainResult;
+};
+type CreateRouteDataHooksWithoutBefore<TParams, TSearch, TMainResult, TContext = ProgrammaticRouteContext> = Omit<ProgrammaticRouteDataHooks<TParams, TSearch, undefined, NoInfer<Awaited<TMainResult>>, TContext>, "before" | "main"> & {
+    before?: undefined;
+    main: (context: ProgrammaticRouteDataContext<TParams, TSearch, TContext> & {
+        before: undefined;
+    }) => TMainResult;
+};
+type CreateRouteOptionsWithBefore<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined, TBefore, TData> = CreateRouteSharedOptions<TParamsSchema, TSearchConfig> & {
+    data: CreateRouteDataHooksWithBefore<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, TBefore, TData>;
+    component: ComponentType<ProgrammaticRouteComponentProps<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, NoInfer<Awaited<TData>>>>;
+};
+type CreateRouteOptionsWithoutBefore<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined, TData> = CreateRouteSharedOptions<TParamsSchema, TSearchConfig> & {
+    data: CreateRouteDataHooksWithoutBefore<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, TData>;
+    component: ComponentType<ProgrammaticRouteComponentProps<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, NoInfer<Awaited<TData>>>>;
+};
+type CreateRouteOptionsWithoutData<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined> = CreateRouteSharedOptions<TParamsSchema, TSearchConfig> & {
+    data?: undefined;
+    component: ComponentType<ProgrammaticRouteComponentProps<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, undefined>>;
+};
+type CreateRouteComponentOption<TComponent extends ComponentType<any>, TProps> = {
+    component: TComponent;
+} & (TComponent extends ComponentType<TProps> ? unknown : {
+    component: ComponentType<TProps>;
+});
+type CreateRouteOptions<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined = undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined = undefined, TBefore = unknown, TData = unknown> = CreateRouteOptionsWithBefore<TParamsSchema, TSearchConfig, TBefore, TData> | CreateRouteOptionsWithoutBefore<TParamsSchema, TSearchConfig, TData> | CreateRouteOptionsWithoutData<TParamsSchema, TSearchConfig>;
+declare const PROGRAMMATIC_ROUTE_FILE_NAMES: string[];
+declare function defineRoutes(input: readonly ProgrammaticRouteDefinition[] | ProgrammaticRouteFactory): ProgrammaticRouteManifest;
+declare const routesBuilder: ProgrammaticRouteBuilder;
+declare const page: (path: string, options: Omit<ProgrammaticPageRoute<any, any>, "kind" | "path">) => ProgrammaticPageRoute;
+declare const layout: (path: string, options: Omit<ProgrammaticLayoutRoute, "kind" | "path">) => ProgrammaticLayoutRoute;
+declare const api: (path: string, options: ProgrammaticApiRouteOptions) => ProgrammaticApiRoute;
+declare const redirect: (source: string, destination: string, options?: Omit<ProgrammaticRedirectRoute, "kind" | "source" | "destination">) => ProgrammaticRedirectRoute;
+interface ProgrammaticRouteSearchClientOptions {
+    stripDefaults?: boolean | readonly string[];
+    preserve?: readonly string[];
+    temporary?: readonly string[];
+}
+interface ProgrammaticRouteSearchResolution<TSearch = unknown> {
+    search: TSearch;
+    canonicalPath?: string;
+}
+declare function getProgrammaticRouteSearchSchema<TSearch = unknown>(search: ProgrammaticRouteSearchConfig<TSearch> | undefined): ProgrammaticRouteSchema<TSearch> | undefined;
+declare function getProgrammaticRouteSearchClientOptions(search: ProgrammaticRouteSearchConfig<any> | undefined): ProgrammaticRouteSearchClientOptions | undefined;
+declare function createRoute<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined = undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined = undefined, TBeforeResult = unknown, TMainResult = unknown, TComponent extends ComponentType<any> = ComponentType<any>>(path: string, options: Omit<CreateRouteOptionsWithBefore<TParamsSchema, TSearchConfig, TBeforeResult, TMainResult>, "component"> & CreateRouteComponentOption<TComponent, ProgrammaticRouteComponentProps<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, Awaited<TMainResult>>>): ProgrammaticPageRoute<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, CreateRouteDataHooksWithBefore<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, TBeforeResult, TMainResult>>;
+declare function createRoute<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined = undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined = undefined, TMainResult = unknown, TComponent extends ComponentType<any> = ComponentType<any>>(path: string, options: Omit<CreateRouteOptionsWithoutBefore<TParamsSchema, TSearchConfig, TMainResult>, "component"> & CreateRouteComponentOption<TComponent, ProgrammaticRouteComponentProps<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, Awaited<TMainResult>>>): ProgrammaticPageRoute<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, CreateRouteDataHooksWithoutBefore<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, TMainResult>>;
+declare function createRoute<TParamsSchema extends ProgrammaticRouteSchema<any> | undefined = undefined, TSearchConfig extends ProgrammaticRouteSearchConfig<any> | undefined = undefined>(path: string, options: CreateRouteOptionsWithoutData<TParamsSchema, TSearchConfig>): ProgrammaticPageRoute<CreateRouteParams<TParamsSchema>, CreateRouteSearch<TSearchConfig>, undefined>;
+declare function isProgrammaticRoutesFileName(fileName: string): boolean;
+declare function getProgrammaticRouteManifest(mod: Record<string, any> | null | undefined): ProgrammaticRouteManifest | null;
+declare function isProgrammaticRouteManifest(value: unknown): value is ProgrammaticRouteManifest;
+declare function isProgrammaticRouteDefinition(value: unknown): value is ProgrammaticRouteDefinition;
+declare function createProgrammaticRouteModuleId(filePath: string, kind: "page" | "layout" | "api", routePath: string): string;
+declare function parseProgrammaticRouteModuleId(moduleId: string): {
+    filePath: string;
+    kind: "page" | "layout" | "api";
+    routePath: string;
+} | null;
+declare function parseProgrammaticRoutePath(routePath: string, type?: ParsedRoute["type"]): ParsedRoute;
+declare function createRouteModuleFromProgrammaticPage(route: ProgrammaticPageRoute): RouteModule;
+declare function createLayoutModuleFromProgrammaticLayout(route: ProgrammaticLayoutRoute): {
+    metadata: (Metadata & Record<string, any>) | undefined;
+    generateMetadata: ((props: {
+        params: Record<string, string>;
+    }) => Promise<Metadata> | Metadata) | undefined;
+    runtime?: FarmRouteRuntime;
+    regions?: FarmRouteRegions;
+    maxDuration?: FarmRouteMaxDuration;
+    default: ComponentType<LayoutProps>;
+};
+declare function scanProgrammaticPagePaths(source: string): string[];
+
+export { type CreateRouteOptions, type InferProgrammaticRouteData, type InferProgrammaticRouteSchema, type InferProgrammaticRouteSearch, PROGRAMMATIC_ROUTE_FILE_NAMES, type ProgrammaticApiRoute, type ProgrammaticApiRouteOptions, type ProgrammaticLayoutRoute, type ProgrammaticPageRoute, type ProgrammaticRedirectRoute, type ProgrammaticRouteBuilder, type ProgrammaticRouteComponentProps, type ProgrammaticRouteContext, type ProgrammaticRouteDataCacheContext, type ProgrammaticRouteDataCacheKeys, type ProgrammaticRouteDataContext, type ProgrammaticRouteDataHooks, type ProgrammaticRouteDataStaleTime, type ProgrammaticRouteDefinition, type ProgrammaticRouteErrorComponentProps, type ProgrammaticRouteFactory, type ProgrammaticRouteGuard, type ProgrammaticRouteGuardContext, type ProgrammaticRouteManifest, type ProgrammaticRouteMaybePromise, type ProgrammaticRouteMethod, type ProgrammaticRouteParamsFallback, type ProgrammaticRoutePendingComponentProps, type ProgrammaticRoutePrimitive, type ProgrammaticRouteRenderMode, type ProgrammaticRouteSchema, type ProgrammaticRouteSearchClientOptions, type ProgrammaticRouteSearchConfig, type ProgrammaticRouteSearchFallback, type ProgrammaticRouteSearchOptions, type ProgrammaticRouteSearchResolution, type ProgrammaticStaticPath, type ProgrammaticStaticPathParams, type ProgrammaticStaticPaths, api, createLayoutModuleFromProgrammaticLayout, createProgrammaticRouteModuleId, createRoute, createRouteModuleFromProgrammaticPage, defineRoutes, getProgrammaticRouteManifest, getProgrammaticRouteSearchClientOptions, getProgrammaticRouteSearchSchema, isProgrammaticRouteDefinition, isProgrammaticRouteManifest, isProgrammaticRoutesFileName, layout, page, parseProgrammaticRouteModuleId, parseProgrammaticRoutePath, redirect, routesBuilder, scanProgrammaticPagePaths };