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

package/dist/plugin.d.mts

@@ -0,0 +1,22 @@
+export { aO as APIHandlerLifecyclePayload, aK as APIRouteDiscoveredPayload, aR as BundleLifecyclePayload, U as BundleResultPayload, aP as ErrorLifecyclePayload, V as FarmPlugin, aE as FarmPluginBuildHooks, aG as FarmPluginClientConfig, aj as FarmPluginContext, aF as FarmPluginDevHooks, aB as FarmPluginDiscoveredRoute, aD as FarmPluginRenderHooks, an as FarmPluginRouteRuntimePayload, aC as FarmPluginRouterHooks, at as FarmPluginRuntimeAfterEvent, aq as FarmPluginRuntimeBaseEvent, as as FarmPluginRuntimeBeforeEvent, aw as FarmPluginRuntimeCloseEvent, ar as FarmPluginRuntimeContextEvent, au as FarmPluginRuntimeErrorEvent, ax as FarmPluginRuntimeHooks, am as FarmPluginRuntimeKind, az as FarmPluginRuntimeRequestHandler, ay as FarmPluginRuntimeRequestOptions, aA as FarmPluginRuntimeSession, av as FarmPluginRuntimeStartEvent, ao as FarmPluginSetupContext, ap as FarmPluginStateContext, ak as FarmRequestPluginContext, al as FarmRequestStore, aQ as HMRUpdatePayload, aJ as MiddlewareDiscoveredPayload, aS as NitroBuildLifecyclePayload, a3 as PluginManager, ai as PluginRequestContext, aN as RenderLifecyclePayload, aH as RouteDiscoveredPayload, aL as RouteMatchPayload, aM as RouteMatchResultPayload, aI as RoutesGeneratedPayload, aT as ShutdownPayload, a2 as definePlugin, f as farmPlugin } from './client-plugins-BI2R6Eae.mjs';
+import 'vite';
+import './plugin-BJDf43dc.mjs';
+import './env.mjs';
+import 'react';
+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 './workflows.mjs';
+import './cron.mjs';
+import './server-action-security.mjs';
+import './image-config-Duob7wER.mjs';
+import './types-BMxWr97v.mjs';
+import './cache.mjs';
+import './route-runtime-DoOHzCAD.mjs';

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+export { aO as APIHandlerLifecyclePayload, aK as APIRouteDiscoveredPayload, aR as BundleLifecyclePayload, U as BundleResultPayload, aP as ErrorLifecyclePayload, V as FarmPlugin, aE as FarmPluginBuildHooks, aG as FarmPluginClientConfig, aj as FarmPluginContext, aF as FarmPluginDevHooks, aB as FarmPluginDiscoveredRoute, aD as FarmPluginRenderHooks, an as FarmPluginRouteRuntimePayload, aC as FarmPluginRouterHooks, at as FarmPluginRuntimeAfterEvent, aq as FarmPluginRuntimeBaseEvent, as as FarmPluginRuntimeBeforeEvent, aw as FarmPluginRuntimeCloseEvent, ar as FarmPluginRuntimeContextEvent, au as FarmPluginRuntimeErrorEvent, ax as FarmPluginRuntimeHooks, am as FarmPluginRuntimeKind, az as FarmPluginRuntimeRequestHandler, ay as FarmPluginRuntimeRequestOptions, aA as FarmPluginRuntimeSession, av as FarmPluginRuntimeStartEvent, ao as FarmPluginSetupContext, ap as FarmPluginStateContext, ak as FarmRequestPluginContext, al as FarmRequestStore, aQ as HMRUpdatePayload, aJ as MiddlewareDiscoveredPayload, aS as NitroBuildLifecyclePayload, a3 as PluginManager, ai as PluginRequestContext, aN as RenderLifecyclePayload, aH as RouteDiscoveredPayload, aL as RouteMatchPayload, aM as RouteMatchResultPayload, aI as RoutesGeneratedPayload, aT as ShutdownPayload, a2 as definePlugin, f as farmPlugin } from './client-plugins-DU9oMspX.js';
+import 'vite';
+import './plugin-BJDf43dc.js';
+import './env.js';
+import 'react';
+import 'http';
+import './types-D1A6-XvH.js';
+import 'db0';
+import 'unstorage';
+import './integration-api-CHT2OKAf.js';
+import '@farming-labs/orm';
+import './types-C9N-nk5R.js';
+import '@farming-labs/docs';
+import './markdown.js';
+import './observability.js';
+import './workflows.js';
+import './cron.js';
+import './server-action-security.js';
+import './image-config-Duob7wER.js';
+import './types-BMxWr97v.js';
+import './cache.js';
+import './route-runtime-DoOHzCAD.js';

package/dist/plugin.mjs

@@ -1,26 +1,27 @@
 import {
   PluginManager,
   definePlugin
-} from "./chunk-C3DLZMBU.mjs";
-import "./chunk-RSKVYESE.mjs";
+} from "./chunk-DJSGLHCN.mjs";
+import "./chunk-RQ633A5I.mjs";
 import {
   farmPlugin
-} from "./chunk-A2LUXHD2.mjs";
+} from "./chunk-4MGVSBRP.mjs";
 import "./chunk-LGHEOHBU.mjs";
 import "./chunk-FRPWCMMG.mjs";
 import "./chunk-V6WE6JSZ.mjs";
 import "./chunk-3XNTL3FQ.mjs";
-import "./chunk-BHG3LVHH.mjs";
+import "./chunk-CGIXMLSY.mjs";
 import "./chunk-USWZZUEH.mjs";
 import "./chunk-7N62DNSO.mjs";
 import "./chunk-7HO6AEOP.mjs";
+import "./chunk-I4CUBGVF.mjs";
 import "./chunk-74YTBPTY.mjs";
 import "./chunk-7MABZJIM.mjs";
 import "./chunk-YW7OBE6Q.mjs";
 import "./chunk-GY2STC2S.mjs";
 import "./chunk-UB5UOSHB.mjs";
-import "./chunk-LLC7BNXW.mjs";
-import "./chunk-QGQX7SFC.mjs";
+import "./chunk-ZVWA4ZQ3.mjs";
+import "./chunk-7FBJLMQH.mjs";
 import "./chunk-XIVV5IWN.mjs";
 import "./chunk-GXASWWJU.mjs";
 import "./chunk-K4667E2Q.mjs";
@@ -40,7 +41,7 @@ import "./chunk-J4FNJ5IU.mjs";
 import "./chunk-PFE6GMNE.mjs";
 import "./chunk-RHIFZZUI.mjs";
 import "./chunk-LM2YNO4U.mjs";
-import "./chunk-EEABSBKK.mjs";
+import "./chunk-SSA7THPX.mjs";
 import "./chunk-QTZZ2ISQ.mjs";
 import "./chunk-ITN462YM.mjs";
 import "./chunk-B232I2GP.mjs";

package/dist/production-runtime-4KKq1AVC.d.mts

@@ -0,0 +1,79 @@
+import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-BI2R6Eae.mjs';
+import { R as ResolvedFarmI18nConfig } from './types-BMxWr97v.mjs';
+
+/**
+ * Server-side middleware utilities for accessing middleware data in pages
+ */
+
+type MiddlewareStoreInput = Record<string, any> | Map<string, any>;
+/**
+ * Internal: Run code with middleware data available
+ * This is called by the server renderer
+ */
+declare function _runWithMiddlewareData<T>(data: MiddlewareStoreInput, fn: () => T | Promise<T>): Promise<T>;
+/** Internal: Run code with server-only middleware context available. */
+declare function _runWithMiddlewareContext<T>(context: MiddlewareStoreInput, fn: () => T | Promise<T>): Promise<T>;
+/**
+ * Get middleware data in a server component
+ * No props needed - uses global storage!
+ *
+ * @example
+ * ```tsx
+ * import { getMiddlewareData } from 'farm/middleware';
+ *
+ * export default function Page() {
+ *   const data = getMiddlewareData();  // ← No props needed!
+ *   const user = data.get('user');
+ *   const demoInfo = data.get('demoInfo');
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function getMiddlewareData<T extends Record<string, any> = Record<string, any>>(): Map<keyof T, T[keyof T]>;
+/**
+ * Get a specific value from middleware data (synchronous)
+ * Uses AsyncLocalStorage for request scoping - no props needed.
+ *
+ * @example
+ * ```tsx
+ * import { getMiddlewareValue } from 'farm/middleware';
+ *
+ * export default function Page() {
+ *   const user = getMiddlewareValue<User>('user');  // ← No props needed!
+ *   const stats = getMiddlewareValue('dashboardStats');
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function getMiddlewareValue<T = any>(key: string): T | undefined;
+/**
+ * Read server-only values set by route middleware for the current request.
+ * The returned store is available to the matched page, layouts, and nested
+ * Server Components, but is never added to hydration props.
+ */
+declare function getMiddlewareContext<T extends Record<string, any> = Record<string, any>>(): ReadonlyMiddlewareStore<T>;
+
+interface ProductionMiddlewareModuleEntry {
+    path: string;
+    filePath?: string;
+    module: MiddlewareModule | Record<string, any>;
+}
+interface ProductionMiddlewareRunnerOptions {
+    config?: FarmMiddlewareConfig | null;
+    modules?: ProductionMiddlewareModuleEntry[];
+    i18n?: ResolvedFarmI18nConfig;
+}
+interface ProductionMiddlewareResult {
+    request: Request;
+    response: Response | null;
+    data: Map<string, any>;
+    context: Map<string, any>;
+    headers: Headers;
+    handled: boolean;
+}
+declare function createProductionMiddlewareRunner(options?: ProductionMiddlewareRunnerOptions): (request: Request) => Promise<ProductionMiddlewareResult>;
+declare function applyProductionMiddlewareHeaders(response: Response, middlewareHeaders?: Headers | null): Response;
+
+export { _runWithMiddlewareContext as _, applyProductionMiddlewareHeaders as a, _runWithMiddlewareData as b, createProductionMiddlewareRunner as c, getMiddlewareData as d, getMiddlewareValue as e, getMiddlewareContext as g };

package/dist/production-runtime-C_B79w2P.d.mts

@@ -0,0 +1,28 @@
+import './plugin-BJDf43dc.mjs';
+
+interface FarmChunkRecoveryOptions {
+    /**
+     * How long a page is considered already recovered before another chunk
+     * failure may trigger a reload. Defaults to 30 seconds.
+     */
+    maxAgeMs?: number;
+    /**
+     * Override the storage key. Mostly useful for tests and embedded runtimes.
+     */
+    storageKey?: string;
+    /**
+     * Called right before Farm reloads the page.
+     */
+    onRecover?: (error: unknown) => void;
+    /**
+     * Test hooks for browser globals.
+     */
+    reload?: () => void;
+    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null;
+    location?: Pick<Location, "pathname" | "search" | "reload">;
+    now?: () => number;
+}
+declare function isChunkLoadError(errorLike: unknown): boolean;
+declare function installChunkErrorRecovery(options?: FarmChunkRecoveryOptions): () => void;
+
+export { type FarmChunkRecoveryOptions as F, isChunkLoadError as a, installChunkErrorRecovery as i };

package/dist/production-runtime-DDEM1D2q.d.ts

@@ -0,0 +1,28 @@
+import './plugin-BJDf43dc.js';
+
+interface FarmChunkRecoveryOptions {
+    /**
+     * How long a page is considered already recovered before another chunk
+     * failure may trigger a reload. Defaults to 30 seconds.
+     */
+    maxAgeMs?: number;
+    /**
+     * Override the storage key. Mostly useful for tests and embedded runtimes.
+     */
+    storageKey?: string;
+    /**
+     * Called right before Farm reloads the page.
+     */
+    onRecover?: (error: unknown) => void;
+    /**
+     * Test hooks for browser globals.
+     */
+    reload?: () => void;
+    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null;
+    location?: Pick<Location, "pathname" | "search" | "reload">;
+    now?: () => number;
+}
+declare function isChunkLoadError(errorLike: unknown): boolean;
+declare function installChunkErrorRecovery(options?: FarmChunkRecoveryOptions): () => void;
+
+export { type FarmChunkRecoveryOptions as F, isChunkLoadError as a, installChunkErrorRecovery as i };

package/dist/production-runtime-DRsWDN2x.d.ts

@@ -0,0 +1,79 @@
+import { X as ReadonlyMiddlewareStore, Y as FarmMiddlewareConfig, Z as MiddlewareModule } from './client-plugins-DU9oMspX.js';
+import { R as ResolvedFarmI18nConfig } from './types-BMxWr97v.js';
+
+/**
+ * Server-side middleware utilities for accessing middleware data in pages
+ */
+
+type MiddlewareStoreInput = Record<string, any> | Map<string, any>;
+/**
+ * Internal: Run code with middleware data available
+ * This is called by the server renderer
+ */
+declare function _runWithMiddlewareData<T>(data: MiddlewareStoreInput, fn: () => T | Promise<T>): Promise<T>;
+/** Internal: Run code with server-only middleware context available. */
+declare function _runWithMiddlewareContext<T>(context: MiddlewareStoreInput, fn: () => T | Promise<T>): Promise<T>;
+/**
+ * Get middleware data in a server component
+ * No props needed - uses global storage!
+ *
+ * @example
+ * ```tsx
+ * import { getMiddlewareData } from 'farm/middleware';
+ *
+ * export default function Page() {
+ *   const data = getMiddlewareData();  // ← No props needed!
+ *   const user = data.get('user');
+ *   const demoInfo = data.get('demoInfo');
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function getMiddlewareData<T extends Record<string, any> = Record<string, any>>(): Map<keyof T, T[keyof T]>;
+/**
+ * Get a specific value from middleware data (synchronous)
+ * Uses AsyncLocalStorage for request scoping - no props needed.
+ *
+ * @example
+ * ```tsx
+ * import { getMiddlewareValue } from 'farm/middleware';
+ *
+ * export default function Page() {
+ *   const user = getMiddlewareValue<User>('user');  // ← No props needed!
+ *   const stats = getMiddlewareValue('dashboardStats');
+ *
+ *   return <div>Welcome {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function getMiddlewareValue<T = any>(key: string): T | undefined;
+/**
+ * Read server-only values set by route middleware for the current request.
+ * The returned store is available to the matched page, layouts, and nested
+ * Server Components, but is never added to hydration props.
+ */
+declare function getMiddlewareContext<T extends Record<string, any> = Record<string, any>>(): ReadonlyMiddlewareStore<T>;
+
+interface ProductionMiddlewareModuleEntry {
+    path: string;
+    filePath?: string;
+    module: MiddlewareModule | Record<string, any>;
+}
+interface ProductionMiddlewareRunnerOptions {
+    config?: FarmMiddlewareConfig | null;
+    modules?: ProductionMiddlewareModuleEntry[];
+    i18n?: ResolvedFarmI18nConfig;
+}
+interface ProductionMiddlewareResult {
+    request: Request;
+    response: Response | null;
+    data: Map<string, any>;
+    context: Map<string, any>;
+    headers: Headers;
+    handled: boolean;
+}
+declare function createProductionMiddlewareRunner(options?: ProductionMiddlewareRunnerOptions): (request: Request) => Promise<ProductionMiddlewareResult>;
+declare function applyProductionMiddlewareHeaders(response: Response, middlewareHeaders?: Headers | null): Response;
+
+export { _runWithMiddlewareContext as _, applyProductionMiddlewareHeaders as a, _runWithMiddlewareData as b, createProductionMiddlewareRunner as c, getMiddlewareData as d, getMiddlewareValue as e, getMiddlewareContext as g };

package/dist/query/client.d.mts

@@ -0,0 +1,61 @@
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-ry-lxqmy.mjs';
+import { Parser } from './parsers.mjs';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.mjs';
+
+/**
+ * Farm.js Client-Side Query State Management
+ *
+ * Type-safe URL search parameter state management - Like useState, but stored in the URL query string.
+ * Client-only hooks for managing query parameters in the browser.
+ * Inspired by nuqs implementation patterns.
+ */
+
+type UrlUpdateType = "push" | "replace";
+type HistoryMethod = "pushState" | "replaceState";
+interface Options {
+    history?: HistoryMethod;
+    shallow?: boolean;
+    scroll?: boolean;
+    throttleMs?: number;
+}
+declare function useQueryState<TParser extends Parser<any>>(key: string, parser: TParser, options?: Options): [
+    NonNullable<ReturnType<TParser["parse"]>> | null,
+    (value: NonNullable<ReturnType<TParser["parse"]>> | null) => void
+];
+declare function useQueryState<T>(key: string, parser: Parser<T>, options?: Options): [T | null, (value: T | null) => void];
+declare function useQueryStates<T extends Record<string, Parser<any>>>(parsers: T, options?: Options): [
+    {
+        [K in keyof T]: ReturnType<T[K]["parse"]>;
+    },
+    (updates: Partial<{
+        [K in keyof T]: ReturnType<T[K]["parse"]> | null;
+    }>) => void
+];
+declare function usePagination(options?: {
+    defaultPage?: number;
+    defaultLimit?: number;
+    pageKey?: string;
+    limitKey?: string;
+}): {
+    page: number;
+    setPage: (value: number | null) => void;
+    limit: number;
+    setLimit: (value: number | null) => void;
+    offset: number;
+    resetPagination: () => void;
+};
+declare function useSearchFilters<T extends Record<string, any>>(options?: {
+    searchKey?: string;
+    defaultFilters?: T;
+    filterKeys?: (keyof T)[];
+}): {
+    search: string | null;
+    setSearch: (value: string | null) => void;
+    filters: T;
+    setFilters: (updates: Partial<{
+        [x: string]: string | null;
+    }>) => void;
+    clearFilters: () => void;
+};
+
+export { type HistoryMethod, type Options, Parser, type UrlUpdateType, usePagination, useQueryState, useQueryStates, useSearchFilters };

package/dist/query/client.d.ts

@@ -0,0 +1,61 @@
+export { R as RouteParamsInput, l as loadRouteParams, p as parseRouteParams } from '../params-BALtrRim.js';
+import { Parser } from './parsers.js';
+export { asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, inferParserType } from './parsers.js';
+
+/**
+ * Farm.js Client-Side Query State Management
+ *
+ * Type-safe URL search parameter state management - Like useState, but stored in the URL query string.
+ * Client-only hooks for managing query parameters in the browser.
+ * Inspired by nuqs implementation patterns.
+ */
+
+type UrlUpdateType = "push" | "replace";
+type HistoryMethod = "pushState" | "replaceState";
+interface Options {
+    history?: HistoryMethod;
+    shallow?: boolean;
+    scroll?: boolean;
+    throttleMs?: number;
+}
+declare function useQueryState<TParser extends Parser<any>>(key: string, parser: TParser, options?: Options): [
+    NonNullable<ReturnType<TParser["parse"]>> | null,
+    (value: NonNullable<ReturnType<TParser["parse"]>> | null) => void
+];
+declare function useQueryState<T>(key: string, parser: Parser<T>, options?: Options): [T | null, (value: T | null) => void];
+declare function useQueryStates<T extends Record<string, Parser<any>>>(parsers: T, options?: Options): [
+    {
+        [K in keyof T]: ReturnType<T[K]["parse"]>;
+    },
+    (updates: Partial<{
+        [K in keyof T]: ReturnType<T[K]["parse"]> | null;
+    }>) => void
+];
+declare function usePagination(options?: {
+    defaultPage?: number;
+    defaultLimit?: number;
+    pageKey?: string;
+    limitKey?: string;
+}): {
+    page: number;
+    setPage: (value: number | null) => void;
+    limit: number;
+    setLimit: (value: number | null) => void;
+    offset: number;
+    resetPagination: () => void;
+};
+declare function useSearchFilters<T extends Record<string, any>>(options?: {
+    searchKey?: string;
+    defaultFilters?: T;
+    filterKeys?: (keyof T)[];
+}): {
+    search: string | null;
+    setSearch: (value: string | null) => void;
+    filters: T;
+    setFilters: (updates: Partial<{
+        [x: string]: string | null;
+    }>) => void;
+    clearFilters: () => void;
+};
+
+export { type HistoryMethod, type Options, Parser, type UrlUpdateType, usePagination, useQueryState, useQueryStates, useSearchFilters };

package/dist/query/index.d.mts

@@ -0,0 +1,90 @@
+export { Parser, 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';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * Farm.js Query State Types
+ */
+
+/**
+ * Props for Farm.js page components with search params
+ */
+/**
+ * Props for Farm.js layout components
+ */
+interface LayoutPropsSafe {
+    children: ReactNode;
+    params: Record<string, string>;
+}
+interface PagePropsSafe {
+    params: Record<string, string>;
+    searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>;
+}
+/**
+ * Query state configuration for Farm.js
+ */
+interface QueryStateConfig {
+    /**
+     * Default history method for URL updates
+     * @default 'push'
+     */
+    defaultHistoryMethod?: "push" | "replace";
+    /**
+     * Default shallow routing behavior
+     * @default true
+     */
+    shallow?: boolean;
+    /**
+     * Default scroll behavior
+     * @default true
+     */
+    scroll?: boolean;
+    /**
+     * Custom serialization options
+     */
+    serialization?: {
+        /**
+         * Custom URL key mappings
+         */
+        urlKeys?: Record<string, string>;
+        /**
+         * Custom base URL for serialization
+         */
+        baseUrl?: string;
+    };
+}
+/**
+ * Farm.js specific query state context
+ */
+interface FarmQueryStateContext {
+    /**
+     * Current search parameters
+     */
+    searchParams: URLSearchParams;
+    /**
+     * Current pathname
+     */
+    pathname: string;
+    /**
+     * Update URL with new search parameters
+     */
+    updateUrl: (params: Record<string, any>, options?: {
+        method?: "push" | "replace";
+        shallow?: boolean;
+        scroll?: boolean;
+    }) => void;
+    /**
+     * Clear all search parameters
+     */
+    clearParams: () => void;
+}
+/**
+ * Higher-order component for providing query state context
+ */
+type QueryStateProvider = ComponentType<{
+    children: ReactNode;
+    searchParams?: URLSearchParams;
+    pathname?: string;
+}>;
+
+export type { FarmQueryStateContext, LayoutPropsSafe, PagePropsSafe, QueryStateConfig, QueryStateProvider };

package/dist/query/index.d.ts

@@ -0,0 +1,90 @@
+export { Parser, 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';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * Farm.js Query State Types
+ */
+
+/**
+ * Props for Farm.js page components with search params
+ */
+/**
+ * Props for Farm.js layout components
+ */
+interface LayoutPropsSafe {
+    children: ReactNode;
+    params: Record<string, string>;
+}
+interface PagePropsSafe {
+    params: Record<string, string>;
+    searchParams: Promise<URLSearchParams | Record<string, string | string[] | undefined>>;
+}
+/**
+ * Query state configuration for Farm.js
+ */
+interface QueryStateConfig {
+    /**
+     * Default history method for URL updates
+     * @default 'push'
+     */
+    defaultHistoryMethod?: "push" | "replace";
+    /**
+     * Default shallow routing behavior
+     * @default true
+     */
+    shallow?: boolean;
+    /**
+     * Default scroll behavior
+     * @default true
+     */
+    scroll?: boolean;
+    /**
+     * Custom serialization options
+     */
+    serialization?: {
+        /**
+         * Custom URL key mappings
+         */
+        urlKeys?: Record<string, string>;
+        /**
+         * Custom base URL for serialization
+         */
+        baseUrl?: string;
+    };
+}
+/**
+ * Farm.js specific query state context
+ */
+interface FarmQueryStateContext {
+    /**
+     * Current search parameters
+     */
+    searchParams: URLSearchParams;
+    /**
+     * Current pathname
+     */
+    pathname: string;
+    /**
+     * Update URL with new search parameters
+     */
+    updateUrl: (params: Record<string, any>, options?: {
+        method?: "push" | "replace";
+        shallow?: boolean;
+        scroll?: boolean;
+    }) => void;
+    /**
+     * Clear all search parameters
+     */
+    clearParams: () => void;
+}
+/**
+ * Higher-order component for providing query state context
+ */
+type QueryStateProvider = ComponentType<{
+    children: ReactNode;
+    searchParams?: URLSearchParams;
+    pathname?: string;
+}>;
+
+export type { FarmQueryStateContext, LayoutPropsSafe, PagePropsSafe, QueryStateConfig, QueryStateProvider };

package/dist/query/parsers.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Farm.js Query State Parsers
+ *
+ * Shared parsers that can be used in both client and server contexts
+ */
+interface Parser<T> {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+    withDefault?: (defaultValue: T) => Parser<T>;
+}
+declare const asString: Parser<string>;
+declare const asInteger: Parser<number>;
+declare const asFloat: Parser<number>;
+declare const asBoolean: Parser<boolean>;
+declare function asArrayOf<T>(itemParser: Parser<T>): Parser<T[]>;
+declare function asJson<T>(): Parser<T>;
+declare const asIsoDate: Parser<Date>;
+declare const asIsoDateTime: Parser<Date>;
+declare function createParser<T>(config: {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+}): Parser<T>;
+type inferParserType<T> = T extends Parser<infer U> ? U : never;
+
+export { type Parser, asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, type inferParserType };

package/dist/query/parsers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Farm.js Query State Parsers
+ *
+ * Shared parsers that can be used in both client and server contexts
+ */
+interface Parser<T> {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+    withDefault?: (defaultValue: T) => Parser<T>;
+}
+declare const asString: Parser<string>;
+declare const asInteger: Parser<number>;
+declare const asFloat: Parser<number>;
+declare const asBoolean: Parser<boolean>;
+declare function asArrayOf<T>(itemParser: Parser<T>): Parser<T[]>;
+declare function asJson<T>(): Parser<T>;
+declare const asIsoDate: Parser<Date>;
+declare const asIsoDateTime: Parser<Date>;
+declare function createParser<T>(config: {
+    parse: (value: string) => T | null;
+    serialize: (value: T) => string;
+}): Parser<T>;
+type inferParserType<T> = T extends Parser<infer U> ? U : never;
+
+export { type Parser, asArrayOf, asBoolean, asFloat, asInteger, asIsoDate, asIsoDateTime, asJson, asString, createParser, type inferParserType };