@farm.js/core 0.1.61 → 0.1.63

package/dist/json-ld.d.mts

@@ -0,0 +1,94 @@
+/**
+ * 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

@@ -0,0 +1,94 @@
+/**
+ * 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.mjs

@@ -1,6 +1,4 @@
-import {
-  __name
-} from "./chunk-LPEX4YW6.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 
 // src/json-ld.ts
 var SCHEMA_CONTEXT = "https://schema.org";
@@ -23,7 +21,6 @@ function article(input) {
     }
   });
 }
-__name(article, "article");
 function breadcrumbList(items) {
   return thing("BreadcrumbList", {
     itemListElement: items.map((item, index) => ({
@@ -33,7 +30,6 @@ function breadcrumbList(items) {
     }))
   });
 }
-__name(breadcrumbList, "breadcrumbList");
 function faqPage(items) {
   return thing("FAQPage", {
     mainEntity: items.map((item) => ({
@@ -43,7 +39,6 @@ function faqPage(items) {
     }))
   });
 }
-__name(faqPage, "faqPage");
 function product(input) {
   return thing("Product", {
     name: input.name,
@@ -56,7 +51,6 @@ function product(input) {
     aggregateRating: rating(input.aggregateRating)
   });
 }
-__name(product, "product");
 function softwareApplication(input) {
   return thing("SoftwareApplication", {
     name: input.name,
@@ -70,19 +64,16 @@ function softwareApplication(input) {
     aggregateRating: rating(input.aggregateRating)
   });
 }
-__name(softwareApplication, "softwareApplication");
 function thing(type, properties) {
   return { "@context": SCHEMA_CONTEXT, "@type": type, ...prune(properties) };
 }
-__name(thing, "thing");
 function person(input) {
   if (typeof input === "string") return { "@type": "Person", name: input };
   return { "@type": input.type ?? "Person", ...prune({ name: input.name, url: input.url }) };
 }
-__name(person, "person");
 function offers(input) {
   if (!input) return void 0;
-  const offer = /* @__PURE__ */ __name((value) => ({
+  const offer = (value) => ({
     "@type": "Offer",
     ...prune({
       price: value.price,
@@ -90,19 +81,16 @@ function offers(input) {
       availability: value.availability && `${SCHEMA_CONTEXT}/${value.availability}`,
       url: value.url
     })
-  }), "offer");
+  });
   return Array.isArray(input) ? input.map(offer) : offer(input);
 }
-__name(offers, "offers");
 function rating(input) {
   return input && { "@type": "AggregateRating", ...prune({ ...input }) };
 }
-__name(rating, "rating");
 function toDate(value) {
   if (!(value instanceof Date)) return value;
   return Number.isNaN(value.getTime()) ? void 0 : value.toISOString();
 }
-__name(toDate, "toDate");
 function prune(object) {
   const result = {};
   for (const [key, value] of Object.entries(object)) {
@@ -112,7 +100,6 @@ function prune(object) {
   }
   return result;
 }
-__name(prune, "prune");
 export {
   article,
   breadcrumbList,

package/dist/layers-DMRXRL7F.cjs

@@ -0,0 +1,18 @@
+"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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,55 @@
+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

@@ -0,0 +1,55 @@
+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

@@ -0,0 +1,176 @@
+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 };