@farm.js/core 0.1.60 → 0.1.61

package/dist/types.d-DQnyD3VD.d.ts

@@ -1,30 +0,0 @@
-type FarmThemePreference = "light" | "dark" | "system";
-type FarmResolvedTheme = Exclude<FarmThemePreference, "system">;
-interface FarmThemeConfig {
-    /** Initial preference when the visitor has not selected one. @default "system" */
-    default?: FarmThemePreference;
-    /** Cookie and cross-tab storage key. @default "farm-theme" */
-    storageKey?: string;
-}
-interface ResolvedFarmThemeConfig {
-    enabled: boolean;
-    default: FarmThemePreference;
-    storageKey: string;
-    cookiePath: string;
-}
-interface FarmThemeSnapshot {
-    /** Saved visitor preference. */
-    theme: FarmThemePreference;
-    /** Active browser color mode. Undefined during SSR when the preference is `system`. */
-    resolvedTheme: FarmResolvedTheme | undefined;
-    /** Whether the browser runtime has resolved the theme. */
-    mounted: boolean;
-}
-interface FarmThemeRuntime {
-    config: ResolvedFarmThemeConfig;
-    serverSnapshot: FarmThemeSnapshot;
-    snapshot: FarmThemeSnapshot;
-    setTheme(theme: FarmThemePreference): void;
-}
-
-export type { FarmThemeSnapshot as F, ResolvedFarmThemeConfig as R, FarmThemePreference as a, FarmResolvedTheme as b, FarmThemeRuntime as c, FarmThemeConfig as d };

package/dist/utils.d-DwZ-KLSB.d.ts

@@ -1,54 +0,0 @@
-import { q as RouteSegment, P as ParsedRoute } from './client-plugins.d-vXrbcfJ1.js';
-
-declare function parseRoutePath(filePath: string): ParsedRoute;
-declare function segmentsToPattern(segments: RouteSegment[]): string;
-declare function matchRoute(url: string, segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Decode a pathname once when it will be tested against multiple route chains. */
-declare function splitRoutePath(url: string): string[];
-/** Match an already decoded pathname so route-table scans do not repeatedly split it. */
-declare function matchRouteParts(urlParts: readonly string[], segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Match a route segment chain as an owner of the pathname or one of its descendants. */
-declare function matchRoutePrefix(url: string, segments: RouteSegment[]): boolean;
-/** Match an owner chain against an already decoded pathname. */
-declare function matchRoutePrefixParts(urlParts: readonly string[], segments: RouteSegment[]): boolean;
-declare function resolveAppPath(root: string, ...paths: string[]): string;
-/**
- * Convert an absolute module path inside the project root to a root-relative
- * URL path with forward slashes (e.g. `/src/app/page.tsx`), for values the
- * client passes to dynamic `import()`. On Windows the naive root-prefix slice
- * yields `\src\app\page.tsx`, which is not a valid module specifier. Returns
- * undefined for paths outside the root so callers keep their own fallbacks.
- */
-declare function toRootRelativeUrlPath(absolutePath: string, projectRoot: string): string | undefined;
-/**
- * Normalize a filesystem path to forward slashes. Node's fs accepts these on
- * every platform, and module ids handed to bundlers (e.g. Nitro handler and
- * task entries) must not contain backslashes.
- */
-declare function toPosixPath(filePath: string): string;
-declare function toViteModuleId(filePath: string, root: string): string;
-declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * Files matching `pattern` under `cwd`, sorted. tinyglobby lists them in the order its crawl finds
- * them, which changes from run to run; routes of equal rank keep the order they were found in, so
- * an unsorted list makes the client route table, and the hashes of every client chunk, change
- * between builds of the same app.
- */
-declare function globFiles(pattern: string, cwd: string): Promise<string[]>;
-declare function parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
-declare const logger: {
-    info: (message: string) => void;
-    success: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-    ready: (message: string) => void;
-    event: (message: string) => void;
-};
-
-export { matchRouteParts as a, matchRoutePrefix as b, matchRoutePrefixParts as c, parseSearchParams as d, splitRoutePath as e, fileExists as f, globFiles as g, toRootRelativeUrlPath as h, toViteModuleId as i, logger as l, matchRoute as m, parseRoutePath as p, resolveAppPath as r, segmentsToPattern as s, toPosixPath as t };

package/dist/utils.d-uKZcKJk4.d.mts

@@ -1,54 +0,0 @@
-import { q as RouteSegment, P as ParsedRoute } from './client-plugins.d-CgQQ-EAv.mjs';
-
-declare function parseRoutePath(filePath: string): ParsedRoute;
-declare function segmentsToPattern(segments: RouteSegment[]): string;
-declare function matchRoute(url: string, segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Decode a pathname once when it will be tested against multiple route chains. */
-declare function splitRoutePath(url: string): string[];
-/** Match an already decoded pathname so route-table scans do not repeatedly split it. */
-declare function matchRouteParts(urlParts: readonly string[], segments: RouteSegment[]): {
-    params: Record<string, string>;
-    matches: boolean;
-};
-/** Match a route segment chain as an owner of the pathname or one of its descendants. */
-declare function matchRoutePrefix(url: string, segments: RouteSegment[]): boolean;
-/** Match an owner chain against an already decoded pathname. */
-declare function matchRoutePrefixParts(urlParts: readonly string[], segments: RouteSegment[]): boolean;
-declare function resolveAppPath(root: string, ...paths: string[]): string;
-/**
- * Convert an absolute module path inside the project root to a root-relative
- * URL path with forward slashes (e.g. `/src/app/page.tsx`), for values the
- * client passes to dynamic `import()`. On Windows the naive root-prefix slice
- * yields `\src\app\page.tsx`, which is not a valid module specifier. Returns
- * undefined for paths outside the root so callers keep their own fallbacks.
- */
-declare function toRootRelativeUrlPath(absolutePath: string, projectRoot: string): string | undefined;
-/**
- * Normalize a filesystem path to forward slashes. Node's fs accepts these on
- * every platform, and module ids handed to bundlers (e.g. Nitro handler and
- * task entries) must not contain backslashes.
- */
-declare function toPosixPath(filePath: string): string;
-declare function toViteModuleId(filePath: string, root: string): string;
-declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * Files matching `pattern` under `cwd`, sorted. tinyglobby lists them in the order its crawl finds
- * them, which changes from run to run; routes of equal rank keep the order they were found in, so
- * an unsorted list makes the client route table, and the hashes of every client chunk, change
- * between builds of the same app.
- */
-declare function globFiles(pattern: string, cwd: string): Promise<string[]>;
-declare function parseSearchParams(searchParams: URLSearchParams): Record<string, string | string[]>;
-declare const logger: {
-    info: (message: string) => void;
-    success: (message: string) => void;
-    warn: (message: string) => void;
-    error: (message: string) => void;
-    ready: (message: string) => void;
-    event: (message: string) => void;
-};
-
-export { matchRouteParts as a, matchRoutePrefix as b, matchRoutePrefixParts as c, parseSearchParams as d, splitRoutePath as e, fileExists as f, globFiles as g, toRootRelativeUrlPath as h, toViteModuleId as i, logger as l, matchRoute as m, parseRoutePath as p, resolveAppPath as r, segmentsToPattern as s, toPosixPath as t };

package/dist/version.d.mts

@@ -1,3 +0,0 @@
-declare const FARM_VERSION: string;
-
-export { FARM_VERSION };

package/dist/version.d.ts

@@ -1,3 +0,0 @@
-declare const FARM_VERSION: string;
-
-export { FARM_VERSION };

package/dist/vite.d.mts

@@ -1,168 +0,0 @@
-import { Plugin, UserConfig, Connect } from 'vite';
-import { aF as FarmConfig, p as FarmUserConfig, au as PluginManager } from './client-plugins.d-CgQQ-EAv.mjs';
-import { FarmCacheUserConfig } from './cache.mjs';
-import { P as ProgrammaticClientRoutes } from './programmatic-routes-client.d-CPbNqtIi.mjs';
-export { r as readRouteRenderingDirectiveFromFile } from './programmatic-routes-client.d-CPbNqtIi.mjs';
-import { FarmPlatform } from './platform.mjs';
-import { _withAfterNodeMiddleware } from './after.mjs';
-import { A as APIRequestRuntime } from './server-client-bridge.d-DKWDl5NB.mjs';
-import { FarmRenderer } from './renderer.mjs';
-import { F as FarmIslandStrategy } from './island.d-CfGru1MO.mjs';
-export { c as createFarmNodeRequestAbortSignal } from './workflows.d-CRMzQZ3k.mjs';
-import { a as FarmImageConfig } from './image-config.d-CeDgNyX4.mjs';
-export { g as getPublicFarmImageConfig, r as resolveFarmImageConfig } from './image-config.d-CeDgNyX4.mjs';
-import './lifecycle.d-C2aLBOwu.mjs';
-import './route.d-BaVH3V0w.mjs';
-import './endpoint.d-BkMSCRf6.mjs';
-import 'http';
-import './server-fn.mjs';
-import './server-fn-error.d-DrcH9cc1.mjs';
-import './server-query.mjs';
-import './types.d-BnIqOn9w.mjs';
-import 'db0';
-import 'unstorage';
-import './schema.mjs';
-import 'react';
-import '@farming-labs/orm';
-import '@farming-labs/docs';
-import './observability.d-B2363jB6.mjs';
-import '@opentelemetry/api';
-import './cron.mjs';
-import './env.mjs';
-import './server-action-security.mjs';
-import './layers.d-CcS42OGR.mjs';
-import 'rolldown/utils';
-import 'rolldown';
-import './types.d-C41ePjvP.mjs';
-import './config.d-DqZkLwef.mjs';
-import './types.d-DQnyD3VD.mjs';
-import './font.mjs';
-import './route-rendering.d-BrIKA51A.mjs';
-import 'node:http';
-import './deployment.mjs';
-
-interface ResolvedClientCacheAdapterEntry {
-    /** Absolute adapter module path with forward slashes, ready for codegen. */
-    importPath: string;
-    options: {
-        version?: string;
-        flushDelayMs?: number;
-    };
-}
-interface ClientCachePersistenceEntryCode {
-    imports: string;
-    init: string;
-}
-/**
- * Resolve `cache.client.adapter` from configuration to an absolute module
- * path for the generated client entries. Fails the build with an actionable
- * error when the option is set but the module cannot be found.
- */
-declare function resolveFarmClientCacheAdapterEntry(root: string, cache: FarmCacheUserConfig | undefined): ResolvedClientCacheAdapterEntry | undefined;
-/**
- * Code fragments for the generated client entries: an import of the user's
- * adapter module and an init call that runs before hydration starts. Empty
- * strings when persistence is not configured, so entries stay unchanged.
- */
-declare function generateClientCachePersistenceCode(entry: ResolvedClientCacheAdapterEntry | undefined): ClientCachePersistenceEntryCode;
-
-declare function farmFontImportsPlugin(options?: {
-    root?: string;
-    basePath?: string;
-    publicDir?: string | false;
-    /** See TransformFarmFontCallsOptions.importCss. */
-    importCss?: boolean;
-}): Plugin;
-
-declare function farmImageImportsPlugin(): Plugin;
-
-/**
- * Sharp is an optional peer of @farm.js/core. Decide whether this run needs it
- * (development always optimizes with Sharp; production needs it on every
- * non-Cloudflare preset) and, when it is not installed:
- *
- * - `provider: "node"` fails with the install command;
- * - `provider: "auto"` (and `"cloudflare"` in development) falls back to the
- *   documented `provider: "none"` mode: original image URLs and no optimizer
- *   endpoint, so pages keep working without optimization.
- *
- * The returned images config is what the client, the dev handler, and the
- * production runtime must all use, so callers apply it before building plugins.
- */
-declare function resolveFarmImageProviderForRuntime<T extends FarmImageConfig>(images: T | undefined, options: {
-    root: string;
-    preset?: string;
-    dev?: boolean;
-}): T | undefined;
-/**
- * Which image optimizer a production server mounts for `images.provider`:
- * none, Sharp on Node, or the platform's transformer on Cloudflare presets.
- */
-declare function resolveFarmImageServerRuntime(images: Pick<FarmImageConfig, "provider">, preset: string): "none" | "node" | "cloudflare";
-
-interface FarmVitePluginOptions extends FarmConfig {
-    /** The resolved config's flag: the app has a `mobile` block. */
-    mobileClient?: boolean;
-    openapi?: FarmUserConfig["openapi"];
-    images?: FarmUserConfig["images"];
-    publicDir?: FarmUserConfig["publicDir"];
-    /** @internal Modules selected by the compiled isolated-hydration ownership plan. */
-    isolatedClientBoundaryModules?: ReadonlySet<string>;
-    /** @internal Component modules of programmatic routes, read from the evaluated routes files. */
-    programmaticClientRoutes?: ProgrammaticClientRoutes;
-}
-declare function farmI18nClientBridgePlugin(): Plugin;
-/**
- * Fail a browser graph that imports a server-only core entry, instead of
- * bundling its server runtime (for `@farm.js/core/og`, the `@vercel/og` wasm
- * renderer) into client code. A server graph that imports `@farm.js/core/og`
- * without the optional `@vercel/og` peer fails with the install command.
- * A Node builtin in a browser graph resolves to Farm's browser module for it.
- */
-declare function farmServerOnlyEntriesPlugin(options?: {
-    /** The browser graph's platform; a web build's mobile client passes `"mobile"`. */
-    platform?: FarmPlatform;
-}): Plugin;
-
-/** Exported for tests: the request boundary all Farm dev middlewares share. */
-declare function withFarmRequestTracing(handler: Parameters<typeof _withAfterNodeMiddleware>[0], apiRuntime?: APIRequestRuntime, resolveTraceUrl?: (request: Connect.IncomingMessage) => URL): Connect.NextHandleFunction;
-interface FarmModuleAstNode {
-    type: string;
-    start: number;
-    end: number;
-    [key: string]: unknown;
-}
-declare function rewriteEarlySsrRelativeImports(options: {
-    code: string;
-    id: string;
-    root: string;
-    parse: (code: string) => FarmModuleAstNode;
-}): string | null;
-declare function transformIsolatedClientBoundaryModule(options: {
-    code: string;
-    moduleReference: string;
-    islandStrategy: FarmIslandStrategy;
-    parse: (code: string) => FarmModuleAstNode;
-    /** Islands mode: server output in props travels as DOM slots (RFC 0003). */
-    slots?: boolean;
-    /**
-     * Islands mode: the module sets no `island` export and its islands can wait for an interaction
-     * (RFC 0003, section 11); `islandStrategy` is ignored.
-     */
-    inferredInteraction?: boolean;
-}): string | null;
-/**
- * Whether Farm should append its own client-root HMR handler to a
- * `"use client"` module.
- *
- * Re-rendering the whole root on every edit only makes sense for a renderer
- * that diffs the result against the live DOM. Rebuilding renderers such as
- * Solid would otherwise wipe the page's state for a one-character edit. They
- * ship their own HMR integration, which can only preserve component state if
- * Farm leaves the module unaccepted.
- */
-declare function shouldEmitFarmClientRootHmr(renderer?: FarmRenderer): boolean;
-declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin;
-declare function defineConfig(config?: FarmVitePluginOptions): Promise<UserConfig>;
-
-export { type ClientCachePersistenceEntryCode, defineConfig, farmFontImportsPlugin, farmI18nClientBridgePlugin, farmImageImportsPlugin, farmPlugin, farmServerOnlyEntriesPlugin, generateClientCachePersistenceCode, resolveFarmClientCacheAdapterEntry, resolveFarmImageProviderForRuntime, resolveFarmImageServerRuntime, rewriteEarlySsrRelativeImports, shouldEmitFarmClientRootHmr, transformIsolatedClientBoundaryModule, withFarmRequestTracing };

package/dist/vite.d.ts

@@ -1,168 +0,0 @@
-import { Plugin, UserConfig, Connect } from 'vite';
-import { aF as FarmConfig, p as FarmUserConfig, au as PluginManager } from './client-plugins.d-vXrbcfJ1.js';
-import { FarmCacheUserConfig } from './cache.js';
-import { P as ProgrammaticClientRoutes } from './programmatic-routes-client.d-CLG2N1yH.js';
-export { r as readRouteRenderingDirectiveFromFile } from './programmatic-routes-client.d-CLG2N1yH.js';
-import { FarmPlatform } from './platform.js';
-import { _withAfterNodeMiddleware } from './after.js';
-import { A as APIRequestRuntime } from './server-client-bridge.d-DKWDl5NB.js';
-import { FarmRenderer } from './renderer.js';
-import { F as FarmIslandStrategy } from './island.d-CfGru1MO.js';
-export { c as createFarmNodeRequestAbortSignal } from './workflows.d-CRMzQZ3k.js';
-import { a as FarmImageConfig } from './image-config.d-CeDgNyX4.js';
-export { g as getPublicFarmImageConfig, r as resolveFarmImageConfig } from './image-config.d-CeDgNyX4.js';
-import './lifecycle.d-C2aLBOwu.js';
-import './route.d-DBTEqifW.js';
-import './endpoint.d-BgHn0lhl.js';
-import 'http';
-import './server-fn.js';
-import './server-fn-error.d-DrcH9cc1.js';
-import './server-query.js';
-import './types.d-BnIqOn9w.js';
-import 'db0';
-import 'unstorage';
-import './schema.js';
-import 'react';
-import '@farming-labs/orm';
-import '@farming-labs/docs';
-import './observability.d-B2363jB6.js';
-import '@opentelemetry/api';
-import './cron.js';
-import './env.js';
-import './server-action-security.js';
-import './layers.d-CcS42OGR.js';
-import 'rolldown/utils';
-import 'rolldown';
-import './types.d-C41ePjvP.js';
-import './config.d-DqZkLwef.js';
-import './types.d-DQnyD3VD.js';
-import './font.js';
-import './route-rendering.d-Iss0C7GR.js';
-import 'node:http';
-import './deployment.js';
-
-interface ResolvedClientCacheAdapterEntry {
-    /** Absolute adapter module path with forward slashes, ready for codegen. */
-    importPath: string;
-    options: {
-        version?: string;
-        flushDelayMs?: number;
-    };
-}
-interface ClientCachePersistenceEntryCode {
-    imports: string;
-    init: string;
-}
-/**
- * Resolve `cache.client.adapter` from configuration to an absolute module
- * path for the generated client entries. Fails the build with an actionable
- * error when the option is set but the module cannot be found.
- */
-declare function resolveFarmClientCacheAdapterEntry(root: string, cache: FarmCacheUserConfig | undefined): ResolvedClientCacheAdapterEntry | undefined;
-/**
- * Code fragments for the generated client entries: an import of the user's
- * adapter module and an init call that runs before hydration starts. Empty
- * strings when persistence is not configured, so entries stay unchanged.
- */
-declare function generateClientCachePersistenceCode(entry: ResolvedClientCacheAdapterEntry | undefined): ClientCachePersistenceEntryCode;
-
-declare function farmFontImportsPlugin(options?: {
-    root?: string;
-    basePath?: string;
-    publicDir?: string | false;
-    /** See TransformFarmFontCallsOptions.importCss. */
-    importCss?: boolean;
-}): Plugin;
-
-declare function farmImageImportsPlugin(): Plugin;
-
-/**
- * Sharp is an optional peer of @farm.js/core. Decide whether this run needs it
- * (development always optimizes with Sharp; production needs it on every
- * non-Cloudflare preset) and, when it is not installed:
- *
- * - `provider: "node"` fails with the install command;
- * - `provider: "auto"` (and `"cloudflare"` in development) falls back to the
- *   documented `provider: "none"` mode: original image URLs and no optimizer
- *   endpoint, so pages keep working without optimization.
- *
- * The returned images config is what the client, the dev handler, and the
- * production runtime must all use, so callers apply it before building plugins.
- */
-declare function resolveFarmImageProviderForRuntime<T extends FarmImageConfig>(images: T | undefined, options: {
-    root: string;
-    preset?: string;
-    dev?: boolean;
-}): T | undefined;
-/**
- * Which image optimizer a production server mounts for `images.provider`:
- * none, Sharp on Node, or the platform's transformer on Cloudflare presets.
- */
-declare function resolveFarmImageServerRuntime(images: Pick<FarmImageConfig, "provider">, preset: string): "none" | "node" | "cloudflare";
-
-interface FarmVitePluginOptions extends FarmConfig {
-    /** The resolved config's flag: the app has a `mobile` block. */
-    mobileClient?: boolean;
-    openapi?: FarmUserConfig["openapi"];
-    images?: FarmUserConfig["images"];
-    publicDir?: FarmUserConfig["publicDir"];
-    /** @internal Modules selected by the compiled isolated-hydration ownership plan. */
-    isolatedClientBoundaryModules?: ReadonlySet<string>;
-    /** @internal Component modules of programmatic routes, read from the evaluated routes files. */
-    programmaticClientRoutes?: ProgrammaticClientRoutes;
-}
-declare function farmI18nClientBridgePlugin(): Plugin;
-/**
- * Fail a browser graph that imports a server-only core entry, instead of
- * bundling its server runtime (for `@farm.js/core/og`, the `@vercel/og` wasm
- * renderer) into client code. A server graph that imports `@farm.js/core/og`
- * without the optional `@vercel/og` peer fails with the install command.
- * A Node builtin in a browser graph resolves to Farm's browser module for it.
- */
-declare function farmServerOnlyEntriesPlugin(options?: {
-    /** The browser graph's platform; a web build's mobile client passes `"mobile"`. */
-    platform?: FarmPlatform;
-}): Plugin;
-
-/** Exported for tests: the request boundary all Farm dev middlewares share. */
-declare function withFarmRequestTracing(handler: Parameters<typeof _withAfterNodeMiddleware>[0], apiRuntime?: APIRequestRuntime, resolveTraceUrl?: (request: Connect.IncomingMessage) => URL): Connect.NextHandleFunction;
-interface FarmModuleAstNode {
-    type: string;
-    start: number;
-    end: number;
-    [key: string]: unknown;
-}
-declare function rewriteEarlySsrRelativeImports(options: {
-    code: string;
-    id: string;
-    root: string;
-    parse: (code: string) => FarmModuleAstNode;
-}): string | null;
-declare function transformIsolatedClientBoundaryModule(options: {
-    code: string;
-    moduleReference: string;
-    islandStrategy: FarmIslandStrategy;
-    parse: (code: string) => FarmModuleAstNode;
-    /** Islands mode: server output in props travels as DOM slots (RFC 0003). */
-    slots?: boolean;
-    /**
-     * Islands mode: the module sets no `island` export and its islands can wait for an interaction
-     * (RFC 0003, section 11); `islandStrategy` is ignored.
-     */
-    inferredInteraction?: boolean;
-}): string | null;
-/**
- * Whether Farm should append its own client-root HMR handler to a
- * `"use client"` module.
- *
- * Re-rendering the whole root on every edit only makes sense for a renderer
- * that diffs the result against the live DOM. Rebuilding renderers such as
- * Solid would otherwise wipe the page's state for a one-character edit. They
- * ship their own HMR integration, which can only preserve component state if
- * Farm leaves the module unaccepted.
- */
-declare function shouldEmitFarmClientRootHmr(renderer?: FarmRenderer): boolean;
-declare function farmPlugin(options?: FarmVitePluginOptions, initialPluginManager?: PluginManager): Plugin;
-declare function defineConfig(config?: FarmVitePluginOptions): Promise<UserConfig>;
-
-export { type ClientCachePersistenceEntryCode, defineConfig, farmFontImportsPlugin, farmI18nClientBridgePlugin, farmImageImportsPlugin, farmPlugin, farmServerOnlyEntriesPlugin, generateClientCachePersistenceCode, resolveFarmClientCacheAdapterEntry, resolveFarmImageProviderForRuntime, resolveFarmImageServerRuntime, rewriteEarlySsrRelativeImports, shouldEmitFarmClientRootHmr, transformIsolatedClientBoundaryModule, withFarmRequestTracing };