@farm.js/core 0.1.51-beta.3 → 0.1.61

package/dist/internal/server-tree.d.mts

@@ -1,50 +0,0 @@
-import React__default from 'react';
-import { F as FarmIslandValueStore } from '../island-value-protocol.d-BRayRghM.mjs';
-
-/** The script type of a page's tree. */
-declare const FARM_SERVER_TREE_SCRIPT_TYPE = "f/tree";
-/**
- * Marks a navigation response that carries only the page's payload. The browser rebuilds such a
- * page in its layout's React root and never shows its HTML, so the server leaves the HTML out.
- */
-declare const FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE = "partial";
-interface FarmServerTreeRenderOptions {
-    /** Renders a subtree the resolver could not represent with its client components as islands. */
-    isolate(element: React__default.ReactNode): React__default.ReactNode;
-    /**
-     * Islands mode: large values in the payload travel once, keyed by content, and a navigation
-     * leaves out the ones the browser holds.
-     */
-    values?: boolean;
-    /**
-     * A navigation the browser renders in its layout's React root: send the payload, the chunks it
-     * streams and the server HTML parts it cannot represent, without the page's rendered HTML.
-     */
-    payloadOnly?: boolean;
-}
-/**
- * @internal Resolves a server page and returns the page boundary's children: the resolved tree
- * and its payload. Errors from the page's own code, including redirect and notFound controls,
- * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
- */
-declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
-interface FarmServerTreeElementOptions {
-    load(reference: string): Promise<Record<string, unknown>>;
-    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
-    ServerHtml: React__default.ComponentType<any>;
-    /** Remounts the page's client components when it changes, as a navigation does. */
-    key?: string;
-    /** Islands mode's value store, for payloads that reference island values. */
-    values?: Pick<FarmIslandValueStore, "ingest" | "resolve">;
-    /** Islands mode: the function a server action reference stands for. */
-    actions?(id: string): (...args: unknown[]) => unknown;
-    /** Islands mode: decodes props JSON cannot hold (`decodeFarmTagged` in island-codec.ts). */
-    decode?(object: Record<string, unknown>, decodeChild: (value: unknown) => unknown): unknown;
-}
-/**
- * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
- * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
- */
-declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
-
-export { FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE, FARM_SERVER_TREE_SCRIPT_TYPE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/internal/server-tree.d.ts

@@ -1,50 +0,0 @@
-import React__default from 'react';
-import { F as FarmIslandValueStore } from '../island-value-protocol.d-BRayRghM.js';
-
-/** The script type of a page's tree. */
-declare const FARM_SERVER_TREE_SCRIPT_TYPE = "f/tree";
-/**
- * Marks a navigation response that carries only the page's payload. The browser rebuilds such a
- * page in its layout's React root and never shows its HTML, so the server leaves the HTML out.
- */
-declare const FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE = "partial";
-interface FarmServerTreeRenderOptions {
-    /** Renders a subtree the resolver could not represent with its client components as islands. */
-    isolate(element: React__default.ReactNode): React__default.ReactNode;
-    /**
-     * Islands mode: large values in the payload travel once, keyed by content, and a navigation
-     * leaves out the ones the browser holds.
-     */
-    values?: boolean;
-    /**
-     * A navigation the browser renders in its layout's React root: send the payload, the chunks it
-     * streams and the server HTML parts it cannot represent, without the page's rendered HTML.
-     */
-    payloadOnly?: boolean;
-}
-/**
- * @internal Resolves a server page and returns the page boundary's children: the resolved tree
- * and its payload. Errors from the page's own code, including redirect and notFound controls,
- * propagate unchanged. Suspense children resolve concurrently and stream as React renders them.
- */
-declare function renderFarmServerTreePage(ReactRuntime: typeof React__default, element: React__default.ReactNode, options: FarmServerTreeRenderOptions): Promise<React__default.ReactElement>;
-interface FarmServerTreeElementOptions {
-    load(reference: string): Promise<Record<string, unknown>>;
-    /** Renders a `<farm-server-html>` subtree from its server HTML and hydrates its islands. */
-    ServerHtml: React__default.ComponentType<any>;
-    /** Remounts the page's client components when it changes, as a navigation does. */
-    key?: string;
-    /** Islands mode's value store, for payloads that reference island values. */
-    values?: Pick<FarmIslandValueStore, "ingest" | "resolve">;
-    /** Islands mode: the function a server action reference stands for. */
-    actions?(id: string): (...args: unknown[]) => unknown;
-    /** Islands mode: decodes props JSON cannot hold (`decodeFarmTagged` in island-codec.ts). */
-    decode?(object: Record<string, unknown>, decodeChild: (value: unknown) => unknown): unknown;
-}
-/**
- * @internal Rebuilds a server-tree page in the browser from its server HTML, an element or the
- * HTML of a navigation, after loading its client modules. Returns null for a page without a tree.
- */
-declare function createFarmServerTreeElement(ReactRuntime: typeof React__default, source: ParentNode | string, options: FarmServerTreeElementOptions): Promise<React__default.ReactElement | null>;
-
-export { FARM_SERVER_TREE_PAYLOAD_ONLY_ATTRIBUTE, FARM_SERVER_TREE_SCRIPT_TYPE, type FarmServerTreeElementOptions, type FarmServerTreeRenderOptions, createFarmServerTreeElement, renderFarmServerTreePage };

package/dist/island-value-protocol.d-BRayRghM.d.mts

@@ -1,12 +0,0 @@
-interface FarmIslandValueStore {
-    /** Reads the value scripts under `root` that the store does not hold yet. */
-    ingest(root: ParentNode): void;
-    /** Replaces value references in parsed props with the values they name. */
-    resolve(value: unknown): unknown;
-    /** The header value naming the keys the store holds, or undefined when it holds none. */
-    heldHeader(): string | undefined;
-}
-/** Headers a navigation sends so the server can leave out values the browser holds. */
-declare function getFarmIslandValueHeaders(): Record<string, string>;
-
-export { type FarmIslandValueStore as F, getFarmIslandValueHeaders as g };

package/dist/island-value-protocol.d-BRayRghM.d.ts

@@ -1,12 +0,0 @@
-interface FarmIslandValueStore {
-    /** Reads the value scripts under `root` that the store does not hold yet. */
-    ingest(root: ParentNode): void;
-    /** Replaces value references in parsed props with the values they name. */
-    resolve(value: unknown): unknown;
-    /** The header value naming the keys the store holds, or undefined when it holds none. */
-    heldHeader(): string | undefined;
-}
-/** Headers a navigation sends so the server can leave out values the browser holds. */
-declare function getFarmIslandValueHeaders(): Record<string, string>;
-
-export { type FarmIslandValueStore as F, getFarmIslandValueHeaders as g };

package/dist/island.d-CfGru1MO.d.mts

@@ -1,9 +0,0 @@
-/**
- * Controls when Farm loads and hydrates a server-rendered client boundary.
- *
- * `load` is the compatibility-first default. The deferred strategies keep the
- * server-rendered HTML visible while postponing the boundary's JavaScript.
- */
-type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
-
-export type { FarmIslandStrategy as F };

package/dist/island.d-CfGru1MO.d.ts

@@ -1,9 +0,0 @@
-/**
- * Controls when Farm loads and hydrates a server-rendered client boundary.
- *
- * `load` is the compatibility-first default. The deferred strategies keep the
- * server-rendered HTML visible while postponing the boundary's JavaScript.
- */
-type FarmIslandStrategy = "load" | "interaction" | "visible" | "idle";
-
-export type { FarmIslandStrategy as F };

package/dist/json-ld.d.mts

@@ -1,94 +0,0 @@
-/**
- * Typed builders for common schema.org JSON-LD objects. Each returns a plain
- * object for `metadata.jsonLd`; spread the result to add more properties. Values
- * are passed through as written, so prefer absolute URLs.
- *
- * ```ts
- * import * as jsonLd from "@farm.js/core/json-ld";
- *
- * export const metadata = {
- *   jsonLd: jsonLd.breadcrumbList([{ name: "Docs", url: "https://acme.test/docs" }]),
- * };
- * ```
- */
-declare const SCHEMA_CONTEXT = "https://schema.org";
-/** A schema.org JSON-LD object with its `@context` and `@type`. */
-type JsonLd<TType extends string = string> = {
-    "@context": typeof SCHEMA_CONTEXT;
-    "@type": TType;
-    [property: string]: unknown;
-};
-/** A person or organization: a plain name, or a name with a URL. */
-type JsonLdPersonInput = string | {
-    name: string;
-    url?: string;
-    type?: "Person" | "Organization";
-};
-interface JsonLdOfferInput {
-    price: number | string;
-    /** ISO 4217 currency code, for example `"USD"`. */
-    priceCurrency: string;
-    availability?: "InStock" | "OutOfStock" | "PreOrder" | "BackOrder" | "Discontinued" | "LimitedAvailability" | "OnlineOnly" | "SoldOut";
-    url?: string;
-}
-interface JsonLdRatingInput {
-    ratingValue: number | string;
-    reviewCount?: number;
-    ratingCount?: number;
-    bestRating?: number | string;
-}
-type ArticleJsonLdType = "Article" | "BlogPosting" | "NewsArticle" | "TechArticle";
-interface ArticleJsonLdInput {
-    /** @default "Article" */
-    type?: ArticleJsonLdType;
-    headline: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    datePublished?: string | Date;
-    dateModified?: string | Date;
-    author?: JsonLdPersonInput | JsonLdPersonInput[];
-    publisher?: {
-        name: string;
-        url?: string;
-        logo?: string;
-    };
-}
-declare function article(input: ArticleJsonLdInput): JsonLd<ArticleJsonLdType>;
-interface BreadcrumbJsonLdItem {
-    name: string;
-    /** Omit for the current page, which may be the last item. */
-    url?: string;
-}
-declare function breadcrumbList(items: BreadcrumbJsonLdItem[]): JsonLd<"BreadcrumbList">;
-interface FaqJsonLdItem {
-    question: string;
-    answer: string;
-}
-declare function faqPage(items: FaqJsonLdItem[]): JsonLd<"FAQPage">;
-interface ProductJsonLdInput {
-    name: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    sku?: string;
-    brand?: string;
-    offers?: JsonLdOfferInput | JsonLdOfferInput[];
-    aggregateRating?: JsonLdRatingInput;
-}
-declare function product(input: ProductJsonLdInput): JsonLd<"Product">;
-interface SoftwareApplicationJsonLdInput {
-    name: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    /** For example `"DeveloperApplication"` or `"BusinessApplication"`. */
-    applicationCategory?: string;
-    operatingSystem?: string;
-    softwareVersion?: string;
-    offers?: JsonLdOfferInput | JsonLdOfferInput[];
-    aggregateRating?: JsonLdRatingInput;
-}
-declare function softwareApplication(input: SoftwareApplicationJsonLdInput): JsonLd<"SoftwareApplication">;
-
-export { type ArticleJsonLdInput, type ArticleJsonLdType, type BreadcrumbJsonLdItem, type FaqJsonLdItem, type JsonLd, type JsonLdOfferInput, type JsonLdPersonInput, type JsonLdRatingInput, type ProductJsonLdInput, type SoftwareApplicationJsonLdInput, article, breadcrumbList, faqPage, product, softwareApplication };

package/dist/json-ld.d.ts

@@ -1,94 +0,0 @@
-/**
- * Typed builders for common schema.org JSON-LD objects. Each returns a plain
- * object for `metadata.jsonLd`; spread the result to add more properties. Values
- * are passed through as written, so prefer absolute URLs.
- *
- * ```ts
- * import * as jsonLd from "@farm.js/core/json-ld";
- *
- * export const metadata = {
- *   jsonLd: jsonLd.breadcrumbList([{ name: "Docs", url: "https://acme.test/docs" }]),
- * };
- * ```
- */
-declare const SCHEMA_CONTEXT = "https://schema.org";
-/** A schema.org JSON-LD object with its `@context` and `@type`. */
-type JsonLd<TType extends string = string> = {
-    "@context": typeof SCHEMA_CONTEXT;
-    "@type": TType;
-    [property: string]: unknown;
-};
-/** A person or organization: a plain name, or a name with a URL. */
-type JsonLdPersonInput = string | {
-    name: string;
-    url?: string;
-    type?: "Person" | "Organization";
-};
-interface JsonLdOfferInput {
-    price: number | string;
-    /** ISO 4217 currency code, for example `"USD"`. */
-    priceCurrency: string;
-    availability?: "InStock" | "OutOfStock" | "PreOrder" | "BackOrder" | "Discontinued" | "LimitedAvailability" | "OnlineOnly" | "SoldOut";
-    url?: string;
-}
-interface JsonLdRatingInput {
-    ratingValue: number | string;
-    reviewCount?: number;
-    ratingCount?: number;
-    bestRating?: number | string;
-}
-type ArticleJsonLdType = "Article" | "BlogPosting" | "NewsArticle" | "TechArticle";
-interface ArticleJsonLdInput {
-    /** @default "Article" */
-    type?: ArticleJsonLdType;
-    headline: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    datePublished?: string | Date;
-    dateModified?: string | Date;
-    author?: JsonLdPersonInput | JsonLdPersonInput[];
-    publisher?: {
-        name: string;
-        url?: string;
-        logo?: string;
-    };
-}
-declare function article(input: ArticleJsonLdInput): JsonLd<ArticleJsonLdType>;
-interface BreadcrumbJsonLdItem {
-    name: string;
-    /** Omit for the current page, which may be the last item. */
-    url?: string;
-}
-declare function breadcrumbList(items: BreadcrumbJsonLdItem[]): JsonLd<"BreadcrumbList">;
-interface FaqJsonLdItem {
-    question: string;
-    answer: string;
-}
-declare function faqPage(items: FaqJsonLdItem[]): JsonLd<"FAQPage">;
-interface ProductJsonLdInput {
-    name: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    sku?: string;
-    brand?: string;
-    offers?: JsonLdOfferInput | JsonLdOfferInput[];
-    aggregateRating?: JsonLdRatingInput;
-}
-declare function product(input: ProductJsonLdInput): JsonLd<"Product">;
-interface SoftwareApplicationJsonLdInput {
-    name: string;
-    description?: string;
-    url?: string;
-    image?: string | string[];
-    /** For example `"DeveloperApplication"` or `"BusinessApplication"`. */
-    applicationCategory?: string;
-    operatingSystem?: string;
-    softwareVersion?: string;
-    offers?: JsonLdOfferInput | JsonLdOfferInput[];
-    aggregateRating?: JsonLdRatingInput;
-}
-declare function softwareApplication(input: SoftwareApplicationJsonLdInput): JsonLd<"SoftwareApplication">;
-
-export { type ArticleJsonLdInput, type ArticleJsonLdType, type BreadcrumbJsonLdItem, type FaqJsonLdItem, type JsonLd, type JsonLdOfferInput, type JsonLdPersonInput, type JsonLdRatingInput, type ProductJsonLdInput, type SoftwareApplicationJsonLdInput, article, breadcrumbList, faqPage, product, softwareApplication };

package/dist/layers-DMRXRL7F.cjs

@@ -1,18 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-
-
-
-
-
-var _chunk5Y2P454Ocjs = require('./chunk-5Y2P454O.cjs');
-require('./chunk-DQJ2CIH7.cjs');
-require('./chunk-BTZ5O6VM.cjs');
-
-
-
-
-
-
-
-exports.createFarmConfigResolutionPlugin = _chunk5Y2P454Ocjs.createFarmConfigResolutionPlugin; exports.getFarmAppDirectories = _chunk5Y2P454Ocjs.getFarmAppDirectories; exports.getFarmLayerAliases = _chunk5Y2P454Ocjs.getFarmLayerAliases; exports.getFarmSourceRoots = _chunk5Y2P454Ocjs.getFarmSourceRoots; exports.loadFarmConfigFile = _chunk5Y2P454Ocjs.loadFarmConfigFile; exports.resolveFarmLayers = _chunk5Y2P454Ocjs.resolveFarmLayers;

package/dist/layers-T55SA47E.mjs

@@ -1,18 +0,0 @@
-import {
-  createFarmConfigResolutionPlugin,
-  getFarmAppDirectories,
-  getFarmLayerAliases,
-  getFarmSourceRoots,
-  loadFarmConfigFile,
-  resolveFarmLayers
-} from "./chunk-52Y3C3HG.mjs";
-import "./chunk-VFXE6NWR.mjs";
-import "./chunk-Y6FXYEAI.mjs";
-export {
-  createFarmConfigResolutionPlugin,
-  getFarmAppDirectories,
-  getFarmLayerAliases,
-  getFarmSourceRoots,
-  loadFarmConfigFile,
-  resolveFarmLayers
-};

package/dist/layers.d-CcS42OGR.d.mts

@@ -1,55 +0,0 @@
-import * as rolldown_utils from 'rolldown/utils';
-import { Plugin } from 'rolldown';
-
-type OxcTransform = (typeof rolldown_utils)["transform"];
-type FarmLayerEntry = string;
-interface ResolvedFarmLayer {
-    /** The value used in `extends`. */
-    source: string;
-    /** Stable name used by the `#layers/<name>` alias. */
-    name: string;
-    /** Absolute layer package or directory root. */
-    root: string;
-    /** Source directory relative to the layer root. */
-    srcDir: string;
-    /** Resolved layer config file when one exists. */
-    configFile?: string;
-}
-interface FarmSourceRoot {
-    name: string;
-    root: string;
-    srcDir: string;
-    layer: boolean;
-}
-interface ResolveFarmLayersOptions {
-    root: string;
-    mode: "development" | "production";
-}
-interface FarmLayerResolution<TConfig extends Record<string, any>> {
-    config: TConfig & {
-        extends?: readonly FarmLayerEntry[];
-        layers: ResolvedFarmLayer[];
-    };
-    layers: ResolvedFarmLayer[];
-}
-declare function resolveFarmLayers<TConfig extends Record<string, any>>(projectConfig: TConfig, options: ResolveFarmLayersOptions): Promise<FarmLayerResolution<TConfig>>;
-declare function getFarmSourceRoots(config: {
-    root?: string;
-    srcDir?: string;
-    layers?: readonly ResolvedFarmLayer[];
-}): FarmSourceRoot[];
-declare function getFarmAppDirectories(config: {
-    root?: string;
-    srcDir?: string;
-    layers?: readonly ResolvedFarmLayer[];
-}): string[];
-declare function getFarmLayerAliases(layers: readonly ResolvedFarmLayer[] | undefined): Record<string, string>;
-declare function createFarmConfigResolutionPlugin(options: {
-    transform: OxcTransform;
-}): Plugin;
-declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: string, options: {
-    root: string;
-    cacheRoot?: string;
-}): Promise<TConfig>;
-
-export { type FarmSourceRoot as F, type ResolvedFarmLayer as R, type FarmLayerEntry as a, type FarmLayerResolution as b, type ResolveFarmLayersOptions as c, createFarmConfigResolutionPlugin as d, getFarmLayerAliases as e, getFarmSourceRoots as f, getFarmAppDirectories as g, loadFarmConfigFile as l, resolveFarmLayers as r };

package/dist/layers.d-CcS42OGR.d.ts

@@ -1,55 +0,0 @@
-import * as rolldown_utils from 'rolldown/utils';
-import { Plugin } from 'rolldown';
-
-type OxcTransform = (typeof rolldown_utils)["transform"];
-type FarmLayerEntry = string;
-interface ResolvedFarmLayer {
-    /** The value used in `extends`. */
-    source: string;
-    /** Stable name used by the `#layers/<name>` alias. */
-    name: string;
-    /** Absolute layer package or directory root. */
-    root: string;
-    /** Source directory relative to the layer root. */
-    srcDir: string;
-    /** Resolved layer config file when one exists. */
-    configFile?: string;
-}
-interface FarmSourceRoot {
-    name: string;
-    root: string;
-    srcDir: string;
-    layer: boolean;
-}
-interface ResolveFarmLayersOptions {
-    root: string;
-    mode: "development" | "production";
-}
-interface FarmLayerResolution<TConfig extends Record<string, any>> {
-    config: TConfig & {
-        extends?: readonly FarmLayerEntry[];
-        layers: ResolvedFarmLayer[];
-    };
-    layers: ResolvedFarmLayer[];
-}
-declare function resolveFarmLayers<TConfig extends Record<string, any>>(projectConfig: TConfig, options: ResolveFarmLayersOptions): Promise<FarmLayerResolution<TConfig>>;
-declare function getFarmSourceRoots(config: {
-    root?: string;
-    srcDir?: string;
-    layers?: readonly ResolvedFarmLayer[];
-}): FarmSourceRoot[];
-declare function getFarmAppDirectories(config: {
-    root?: string;
-    srcDir?: string;
-    layers?: readonly ResolvedFarmLayer[];
-}): string[];
-declare function getFarmLayerAliases(layers: readonly ResolvedFarmLayer[] | undefined): Record<string, string>;
-declare function createFarmConfigResolutionPlugin(options: {
-    transform: OxcTransform;
-}): Plugin;
-declare function loadFarmConfigFile<TConfig = Record<string, any>>(configPath: string, options: {
-    root: string;
-    cacheRoot?: string;
-}): Promise<TConfig>;
-
-export { type FarmSourceRoot as F, type ResolvedFarmLayer as R, type FarmLayerEntry as a, type FarmLayerResolution as b, type ResolveFarmLayersOptions as c, createFarmConfigResolutionPlugin as d, getFarmLayerAliases as e, getFarmSourceRoots as f, getFarmAppDirectories as g, loadFarmConfigFile as l, resolveFarmLayers as r };

package/dist/lifecycle.d-C2aLBOwu.d.mts

@@ -1,176 +0,0 @@
-type MaybePromise<T> = T | Promise<T>;
-type FarmClientPluginEnforce = "pre" | "post";
-type FarmClientNavigationAction = "push" | "replace" | "pop";
-type FarmClientHydrationMode = "hydrate" | "render";
-interface FarmClientLocation {
-    href: string;
-    pathname: string;
-    search: string;
-    hash: string;
-}
-interface FarmClientPluginRouter {
-    navigate(href: string, options?: Record<string, unknown>): MaybePromise<void>;
-    /** Re-render the current URL from fresh server data without replacing the document shell. */
-    refresh?(options?: Record<string, unknown>): MaybePromise<void>;
-    prefetch?(href: string): MaybePromise<void>;
-    clearCache?(): void;
-    getNavigationState?(): unknown;
-}
-interface FarmClientPluginMetadata {
-    name: string;
-    version?: string;
-}
-interface FarmClientPluginSetupEvent<TPublic = undefined> {
-    plugin: FarmClientPluginMetadata;
-    public: Readonly<TPublic>;
-    router: FarmClientPluginRouter;
-    isDev: boolean;
-    isProd: boolean;
-    deploymentId?: string;
-}
-interface FarmClientPluginStateEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginSetupEvent<TPublic> {
-    state: TState;
-}
-interface FarmClientHydrationSession {
-    container: Element;
-    location: FarmClientLocation;
-    mode: FarmClientHydrationMode;
-    startedAt: number;
-}
-interface FarmClientHydrationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientHydrationSession {
-}
-interface FarmClientHydrationCompleteEvent<TState = unknown, TPublic = undefined> extends FarmClientHydrationEvent<TState, TPublic> {
-    durationMs: number;
-    recovered: boolean;
-}
-interface FarmClientNavigationSession {
-    id: string;
-    from: FarmClientLocation | null;
-    to: FarmClientLocation;
-    action: FarmClientNavigationAction;
-    signal: AbortSignal;
-    startedAt: number;
-    route?: {
-        pattern?: string | null;
-        params?: Record<string, string>;
-    };
-}
-interface FarmClientNavigationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientNavigationSession {
-}
-interface FarmClientNavigationLoadedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
-    durationMs: number;
-    data?: unknown;
-}
-interface FarmClientNavigationResolvedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
-    durationMs: number;
-}
-interface FarmClientNavigationErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationResolvedEvent<TState, TPublic> {
-    error: unknown;
-}
-type FarmClientPluginErrorPhase = "setup" | "hydration" | "navigation" | "window" | "unhandled-rejection" | "performance" | `plugin:${string}` | (string & {});
-interface FarmClientPluginErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
-    error: unknown;
-    phase: FarmClientPluginErrorPhase;
-    location: FarmClientLocation;
-    navigation?: FarmClientNavigationSession;
-}
-interface FarmClientPerformanceEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
-    entry: PerformanceEntry;
-    location: FarmClientLocation;
-}
-interface FarmClientPluginCloseEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
-    reason: "pagehide" | "hmr" | "manual" | (string & {});
-}
-interface FarmClientPlugin<TState = unknown, TPublic = undefined> {
-    setup?(event: FarmClientPluginSetupEvent<TPublic>): MaybePromise<TState>;
-    hydration?: {
-        before?(event: FarmClientHydrationEvent<TState, TPublic>): MaybePromise<void>;
-        after?(event: FarmClientHydrationCompleteEvent<TState, TPublic>): MaybePromise<void>;
-    };
-    navigation?: {
-        before?(event: FarmClientNavigationEvent<TState, TPublic>): MaybePromise<void>;
-        loaded?(event: FarmClientNavigationLoadedEvent<TState, TPublic>): MaybePromise<void>;
-        resolved?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
-        rendered?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
-        error?(event: FarmClientNavigationErrorEvent<TState, TPublic>): MaybePromise<void>;
-    };
-    error?(event: FarmClientPluginErrorEvent<TState, TPublic>): MaybePromise<void>;
-    performance?(event: FarmClientPerformanceEvent<TState, TPublic>): MaybePromise<void>;
-    close?(event: FarmClientPluginCloseEvent<TState, TPublic>): MaybePromise<void>;
-}
-interface FarmClientPluginRegistration<TPublic = undefined> {
-    name: string;
-    version?: string;
-    enforce?: FarmClientPluginEnforce;
-    definition: FarmClientPlugin<any, TPublic>;
-    public?: TPublic;
-}
-/**
- * Define the lifecycle for an application's auto-discovered `src/client.ts`
- * entry. The identity helper preserves state inference while keeping the
- * module entirely in the browser bundle.
- */
-declare function defineClient<TState = unknown, TPublic = undefined>(definition: FarmClientPlugin<TState, TPublic>): FarmClientPlugin<TState, TPublic>;
-interface FarmClientPluginManagerOptions {
-    router: FarmClientPluginRouter;
-    isDev?: boolean;
-    isProd?: boolean;
-    deploymentId?: string;
-    window?: Window;
-}
-declare class FarmClientPluginManager {
-    private readonly registrations;
-    private readonly options;
-    private readonly instances;
-    private readonly performanceObservers;
-    private startPromise?;
-    private closePromise?;
-    private currentNavigation?;
-    private navigationSequence;
-    private starting;
-    private started;
-    private closed;
-    private readonly reportedErrors;
-    private runtimeErrorOverlay?;
-    private readonly handleWindowError;
-    private readonly handleUnhandledRejection;
-    private readonly handlePageHide;
-    constructor(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions);
-    start(): Promise<void>;
-    beginHydration(input: {
-        container: Element;
-        mode: FarmClientHydrationMode;
-    }): Promise<FarmClientHydrationSession>;
-    completeHydration(session: FarmClientHydrationSession, options?: {
-        recovered?: boolean;
-    }): Promise<void>;
-    failHydration(session: FarmClientHydrationSession, error: unknown): Promise<void>;
-    beginNavigation(input: {
-        from?: string | URL | FarmClientLocation | null;
-        to: string | URL | FarmClientLocation;
-        action: FarmClientNavigationAction;
-        route?: FarmClientNavigationSession["route"];
-    }): Promise<FarmClientNavigationSession>;
-    markNavigationLoaded(session: FarmClientNavigationSession, data?: unknown): Promise<void>;
-    cancelNavigation(session?: FarmClientNavigationSession, reason?: unknown): void;
-    resolveNavigation(session: FarmClientNavigationSession): Promise<void>;
-    scheduleNavigationRendered(session: FarmClientNavigationSession): Promise<void>;
-    failNavigation(session: FarmClientNavigationSession, error: unknown): Promise<void>;
-    reportError(error: unknown, phase: FarmClientPluginErrorPhase, navigation?: FarmClientNavigationSession, location?: FarmClientLocation, sourceEvent?: Event): Promise<void>;
-    close(reason?: FarmClientPluginCloseEvent["reason"]): Promise<void>;
-    getPlugins(): readonly FarmClientPluginMetadata[];
-    private startInternal;
-    private installBrowserListeners;
-    private installPerformanceObservers;
-    private closeInternal;
-    private runHook;
-    private runErrorHooks;
-    private createSetupEvent;
-    private createStateEvent;
-    private getLocation;
-    private getBaseUrl;
-    private logHookError;
-}
-declare function createClientPluginManager(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions): FarmClientPluginManager;
-
-export { FarmClientPluginManager as F, type FarmClientPlugin as a, type FarmClientHydrationCompleteEvent as b, createClientPluginManager as c, type FarmClientHydrationEvent as d, type FarmClientHydrationMode as e, type FarmClientHydrationSession as f, type FarmClientLocation as g, type FarmClientNavigationAction as h, type FarmClientNavigationErrorEvent as i, type FarmClientNavigationEvent as j, type FarmClientNavigationLoadedEvent as k, type FarmClientNavigationResolvedEvent as l, type FarmClientNavigationSession as m, type FarmClientPerformanceEvent as n, type FarmClientPluginCloseEvent as o, type FarmClientPluginEnforce as p, type FarmClientPluginErrorEvent as q, type FarmClientPluginErrorPhase as r, type FarmClientPluginManagerOptions as s, type FarmClientPluginMetadata as t, type FarmClientPluginRegistration as u, type FarmClientPluginRouter as v, type FarmClientPluginSetupEvent as w, type FarmClientPluginStateEvent as x, defineClient as y };