@farm.js/core 0.1.0-beta.21 → 0.1.0-beta.23

package/dist/docs.d.mts

@@ -0,0 +1,80 @@
+import { FarmLayoutFonts } from './font.mjs';
+import { F as FarmDocsResolvedConfig, a as FarmDocsUserConfig } from './types-DTzm4TCl.mjs';
+export { b as FarmDocsConfigInput, c as FarmDocsNavigationConfig, f as FarmDocsSidebarItem, d as FarmDocsSocialImageConfig, e as FarmDocsSocialImageFonts } from './types-DTzm4TCl.mjs';
+import { DocsConfig } from '@farming-labs/docs';
+
+interface FarmDocsPublicFontAsset {
+    family: "Geist Sans" | "Geist Mono";
+    url: string;
+}
+
+interface FarmDocsHandlerOptions {
+    root: string;
+    srcDir?: string;
+    clientEntry?: string;
+    fontAssets?: readonly FarmDocsPublicFontAsset[];
+    /** Resolve semantic fonts from the layouts that apply to the requested docs route. */
+    resolveLayoutFonts?: (pathname: string) => FarmLayoutFonts | undefined | Promise<FarmLayoutFonts | undefined>;
+    /** Stylesheet containing the `@font-face` rules generated by Farm's font compiler. */
+    fontStylesheetHref?: string;
+}
+interface FarmDocsPage {
+    slug: string;
+    title: string;
+    description?: string;
+    section?: string;
+    href: string;
+    sourcePath: string;
+    lastModified?: string;
+}
+interface LoadedFarmDocsPage extends FarmDocsPage {
+    body: string;
+    frontmatter: Record<string, string>;
+}
+declare function isFarmDocsRequest(docs: FarmDocsResolvedConfig | undefined, request: Request): boolean;
+declare function resolveFarmDocsContentDir(docs: FarmDocsResolvedConfig, options: FarmDocsHandlerOptions): string;
+declare function getFarmDocsRouteTypeEntries(docs: FarmDocsResolvedConfig | undefined): string[];
+declare function getFarmDocsDocumentNavigationMatchers(docs: FarmDocsResolvedConfig | undefined): string[];
+declare function loadFarmDocsPage(contentDir: string, docs: FarmDocsResolvedConfig, slug: string): LoadedFarmDocsPage | null;
+declare function discoverFarmDocsPages(contentDir: string, docs: FarmDocsResolvedConfig): FarmDocsPage[];
+declare function createFarmDocsHandler(docs: FarmDocsResolvedConfig | undefined, options: FarmDocsHandlerOptions): (request: Request) => Promise<Response | null>;
+
+interface FarmDocsAPIOptions {
+    rootDir?: string;
+    root?: string;
+    srcDir?: string;
+    docs?: FarmDocsUserConfig | FarmDocsResolvedConfig;
+    config?: Partial<DocsConfig>;
+    configPath?: string;
+    entry?: string;
+    docsPath?: string;
+    contentDir?: string;
+}
+interface FarmDocsCloudRouteOptions {
+    locale?: string;
+    publicBaseUrl?: string;
+}
+interface FarmDocsCloudServer {
+    handleRequest(request: Request, options?: FarmDocsCloudRouteOptions): Promise<Response>;
+}
+type FarmDocsCloudIntegration = FarmDocsCloudServer | (FarmDocsCloudRouteOptions & {
+    docsCloud?: FarmDocsCloudServer;
+});
+interface FarmDocsAPIRouteHandlers {
+    GET(request: Request): Promise<Response>;
+    POST(request: Request): Promise<Response>;
+}
+type FarmDocsAPIHandler = (request: Request) => Promise<Response | null>;
+type FarmDocsRuntimeConfig = {
+    root?: string;
+    srcDir?: string;
+    docs?: FarmDocsResolvedConfig;
+};
+declare global {
+    var __FARM_DOCS_RUNTIME_CONFIG__: FarmDocsRuntimeConfig | undefined;
+}
+declare function isFarmDocsAPIRequest(requestOrPathname: Request | string): boolean;
+declare function createDocsAPI(options?: FarmDocsAPIOptions, cloudIntegration?: FarmDocsCloudIntegration): FarmDocsAPIRouteHandlers;
+declare function createFarmDocsAPIHandler(options?: FarmDocsAPIOptions, cloudIntegration?: FarmDocsCloudIntegration): FarmDocsAPIHandler;
+
+export { type FarmDocsAPIHandler, type FarmDocsAPIOptions, type FarmDocsAPIRouteHandlers, type FarmDocsCloudIntegration, type FarmDocsCloudRouteOptions, type FarmDocsCloudServer, type FarmDocsHandlerOptions, type FarmDocsPage, FarmDocsResolvedConfig, FarmDocsUserConfig, type LoadedFarmDocsPage, createDocsAPI, createFarmDocsAPIHandler, createFarmDocsHandler, discoverFarmDocsPages, getFarmDocsDocumentNavigationMatchers, getFarmDocsRouteTypeEntries, isFarmDocsAPIRequest, isFarmDocsRequest, loadFarmDocsPage, resolveFarmDocsContentDir };

package/dist/docs.d.ts

@@ -0,0 +1,80 @@
+import { FarmLayoutFonts } from './font.js';
+import { F as FarmDocsResolvedConfig, a as FarmDocsUserConfig } from './types-DTzm4TCl.js';
+export { b as FarmDocsConfigInput, c as FarmDocsNavigationConfig, f as FarmDocsSidebarItem, d as FarmDocsSocialImageConfig, e as FarmDocsSocialImageFonts } from './types-DTzm4TCl.js';
+import { DocsConfig } from '@farming-labs/docs';
+
+interface FarmDocsPublicFontAsset {
+    family: "Geist Sans" | "Geist Mono";
+    url: string;
+}
+
+interface FarmDocsHandlerOptions {
+    root: string;
+    srcDir?: string;
+    clientEntry?: string;
+    fontAssets?: readonly FarmDocsPublicFontAsset[];
+    /** Resolve semantic fonts from the layouts that apply to the requested docs route. */
+    resolveLayoutFonts?: (pathname: string) => FarmLayoutFonts | undefined | Promise<FarmLayoutFonts | undefined>;
+    /** Stylesheet containing the `@font-face` rules generated by Farm's font compiler. */
+    fontStylesheetHref?: string;
+}
+interface FarmDocsPage {
+    slug: string;
+    title: string;
+    description?: string;
+    section?: string;
+    href: string;
+    sourcePath: string;
+    lastModified?: string;
+}
+interface LoadedFarmDocsPage extends FarmDocsPage {
+    body: string;
+    frontmatter: Record<string, string>;
+}
+declare function isFarmDocsRequest(docs: FarmDocsResolvedConfig | undefined, request: Request): boolean;
+declare function resolveFarmDocsContentDir(docs: FarmDocsResolvedConfig, options: FarmDocsHandlerOptions): string;
+declare function getFarmDocsRouteTypeEntries(docs: FarmDocsResolvedConfig | undefined): string[];
+declare function getFarmDocsDocumentNavigationMatchers(docs: FarmDocsResolvedConfig | undefined): string[];
+declare function loadFarmDocsPage(contentDir: string, docs: FarmDocsResolvedConfig, slug: string): LoadedFarmDocsPage | null;
+declare function discoverFarmDocsPages(contentDir: string, docs: FarmDocsResolvedConfig): FarmDocsPage[];
+declare function createFarmDocsHandler(docs: FarmDocsResolvedConfig | undefined, options: FarmDocsHandlerOptions): (request: Request) => Promise<Response | null>;
+
+interface FarmDocsAPIOptions {
+    rootDir?: string;
+    root?: string;
+    srcDir?: string;
+    docs?: FarmDocsUserConfig | FarmDocsResolvedConfig;
+    config?: Partial<DocsConfig>;
+    configPath?: string;
+    entry?: string;
+    docsPath?: string;
+    contentDir?: string;
+}
+interface FarmDocsCloudRouteOptions {
+    locale?: string;
+    publicBaseUrl?: string;
+}
+interface FarmDocsCloudServer {
+    handleRequest(request: Request, options?: FarmDocsCloudRouteOptions): Promise<Response>;
+}
+type FarmDocsCloudIntegration = FarmDocsCloudServer | (FarmDocsCloudRouteOptions & {
+    docsCloud?: FarmDocsCloudServer;
+});
+interface FarmDocsAPIRouteHandlers {
+    GET(request: Request): Promise<Response>;
+    POST(request: Request): Promise<Response>;
+}
+type FarmDocsAPIHandler = (request: Request) => Promise<Response | null>;
+type FarmDocsRuntimeConfig = {
+    root?: string;
+    srcDir?: string;
+    docs?: FarmDocsResolvedConfig;
+};
+declare global {
+    var __FARM_DOCS_RUNTIME_CONFIG__: FarmDocsRuntimeConfig | undefined;
+}
+declare function isFarmDocsAPIRequest(requestOrPathname: Request | string): boolean;
+declare function createDocsAPI(options?: FarmDocsAPIOptions, cloudIntegration?: FarmDocsCloudIntegration): FarmDocsAPIRouteHandlers;
+declare function createFarmDocsAPIHandler(options?: FarmDocsAPIOptions, cloudIntegration?: FarmDocsCloudIntegration): FarmDocsAPIHandler;
+
+export { type FarmDocsAPIHandler, type FarmDocsAPIOptions, type FarmDocsAPIRouteHandlers, type FarmDocsCloudIntegration, type FarmDocsCloudRouteOptions, type FarmDocsCloudServer, type FarmDocsHandlerOptions, type FarmDocsPage, FarmDocsResolvedConfig, FarmDocsUserConfig, type LoadedFarmDocsPage, createDocsAPI, createFarmDocsAPIHandler, createFarmDocsHandler, discoverFarmDocsPages, getFarmDocsDocumentNavigationMatchers, getFarmDocsRouteTypeEntries, isFarmDocsAPIRequest, isFarmDocsRequest, loadFarmDocsPage, resolveFarmDocsContentDir };

package/dist/docs.mjs

@@ -9,9 +9,9 @@ import {
   isFarmDocsRequest,
   loadFarmDocsPage,
   resolveFarmDocsContentDir
-} from "./chunk-LLPN5SEZ.mjs";
+} from "./chunk-DVPRBMU2.mjs";
 import "./chunk-V7RBCSDJ.mjs";
-import "./chunk-CEVMYGDL.mjs";
+import "./chunk-YD5IRKVS.mjs";
 import "./chunk-UVCIEUJC.mjs";
 import "./chunk-RQ633A5I.mjs";
 import "./chunk-USLFXFFH.mjs";
@@ -19,13 +19,14 @@ import "./chunk-E257KFBU.mjs";
 import "./chunk-7MABZJIM.mjs";
 import "./chunk-YW7OBE6Q.mjs";
 import "./chunk-74YTBPTY.mjs";
-import "./chunk-7ZVN3YZI.mjs";
 import "./chunk-GY2STC2S.mjs";
+import "./chunk-7ZVN3YZI.mjs";
+import "./chunk-4E6VRJ6P.mjs";
+import "./chunk-GXASWWJU.mjs";
 import "./chunk-WORFTBLU.mjs";
+import "./chunk-H53KVQUU.mjs";
 import "./chunk-ZVWA4ZQ3.mjs";
 import "./chunk-7FBJLMQH.mjs";
-import "./chunk-4E6VRJ6P.mjs";
-import "./chunk-GXASWWJU.mjs";
 import "./chunk-CRN3AH35.mjs";
 import "./chunk-QGOHVJ6J.mjs";
 import "./chunk-FQYDHKKU.mjs";

package/dist/env-types.d.mts

@@ -0,0 +1,12 @@
+interface GenerateEnvTypesOptions {
+    root: string;
+    srcDir?: string;
+    outFile?: string;
+    configPath?: string;
+    /** Lower-priority layer config files, ordered before the project config. */
+    layerConfigPaths?: readonly string[];
+}
+declare function generateEnvTypes(options: GenerateEnvTypesOptions): Promise<string>;
+declare function createEnvTypeDeclarations(options: GenerateEnvTypesOptions, outPath: string): string;
+
+export { type GenerateEnvTypesOptions, createEnvTypeDeclarations, generateEnvTypes };

package/dist/env-types.d.ts

@@ -0,0 +1,12 @@
+interface GenerateEnvTypesOptions {
+    root: string;
+    srcDir?: string;
+    outFile?: string;
+    configPath?: string;
+    /** Lower-priority layer config files, ordered before the project config. */
+    layerConfigPaths?: readonly string[];
+}
+declare function generateEnvTypes(options: GenerateEnvTypesOptions): Promise<string>;
+declare function createEnvTypeDeclarations(options: GenerateEnvTypesOptions, outPath: string): string;
+
+export { type GenerateEnvTypesOptions, createEnvTypeDeclarations, generateEnvTypes };

package/dist/env.d.mts

@@ -0,0 +1,45 @@
+interface EnvSchema<TOutput = unknown> {
+    parse(value: unknown): TOutput;
+}
+type EnvParser<TOutput = unknown> = EnvSchema<TOutput> | ((value: string | undefined, context: {
+    key: string;
+    scope: "server" | "public";
+}) => TOutput);
+type EnvShape = Record<string, EnvParser<any>>;
+type InferEnvParser<TParser> = TParser extends EnvSchema<infer TOutput> ? TOutput : TParser extends (value: string | undefined, context: any) => infer TOutput ? TOutput : never;
+type InferEnvShape<TShape> = TShape extends EnvShape ? {
+    [K in keyof TShape]: InferEnvParser<TShape[K]>;
+} : {};
+interface FarmEnvConfig<TServer extends EnvShape = EnvShape, TPublic extends EnvShape = EnvShape> {
+    server?: TServer;
+    public?: TPublic;
+}
+interface ResolvedFarmEnv<TServer extends Record<string, any> = Record<string, unknown>, TPublic extends Record<string, any> = Record<string, unknown>> {
+    server: TServer;
+    public: TPublic;
+}
+type InferEnv<TConfig> = TConfig extends FarmEnvConfig<infer TServer, infer TPublic> ? ResolvedFarmEnv<InferEnvShape<TServer>, InferEnvShape<TPublic>> : ResolvedFarmEnv;
+/**
+ * Augmented by generated src/farm.d.ts for project-specific autocomplete.
+ */
+interface FarmEnvTypes {
+}
+type FarmServerEnv = FarmEnvTypes extends {
+    server: infer TServer;
+} ? TServer extends Record<string, any> ? TServer : Record<string, unknown> : Record<string, unknown>;
+type FarmPublicEnv = FarmEnvTypes extends {
+    public: infer TPublic;
+} ? TPublic extends Record<string, any> ? TPublic : Record<string, unknown> : Record<string, unknown>;
+type FarmTypedEnv = ResolvedFarmEnv<FarmServerEnv, FarmPublicEnv>;
+declare function resolveEnv<TConfig extends FarmEnvConfig<any, any> | undefined>(config: TConfig, source?: Record<string, string | undefined>): InferEnv<NonNullable<TConfig>>;
+declare function setEnv(env: ResolvedFarmEnv): void;
+declare function getResolvedEnv<TEnv extends ResolvedFarmEnv = FarmTypedEnv>(): TEnv;
+declare function getEnv<TServer extends Record<string, any> = FarmServerEnv>(): TServer;
+declare function getEnv<TKey extends Extract<keyof FarmServerEnv, string>>(key: TKey): FarmServerEnv[TKey];
+declare function getPublicEnv<TPublic extends Record<string, any> = FarmPublicEnv>(): TPublic;
+declare function getPublicEnv<TKey extends Extract<keyof FarmPublicEnv, string>>(key: TKey): FarmPublicEnv[TKey];
+declare const env: FarmServerEnv;
+declare const serverEnv: Record<string, unknown>;
+declare const publicEnv: FarmPublicEnv;
+
+export { type EnvParser, type EnvSchema, type EnvShape, type FarmEnvConfig, type FarmEnvTypes, type FarmPublicEnv, type FarmServerEnv, type FarmTypedEnv, type InferEnv, type InferEnvParser, type InferEnvShape, type ResolvedFarmEnv, env, getEnv, getPublicEnv, getResolvedEnv, publicEnv, resolveEnv, serverEnv, setEnv };

package/dist/env.d.ts

@@ -0,0 +1,45 @@
+interface EnvSchema<TOutput = unknown> {
+    parse(value: unknown): TOutput;
+}
+type EnvParser<TOutput = unknown> = EnvSchema<TOutput> | ((value: string | undefined, context: {
+    key: string;
+    scope: "server" | "public";
+}) => TOutput);
+type EnvShape = Record<string, EnvParser<any>>;
+type InferEnvParser<TParser> = TParser extends EnvSchema<infer TOutput> ? TOutput : TParser extends (value: string | undefined, context: any) => infer TOutput ? TOutput : never;
+type InferEnvShape<TShape> = TShape extends EnvShape ? {
+    [K in keyof TShape]: InferEnvParser<TShape[K]>;
+} : {};
+interface FarmEnvConfig<TServer extends EnvShape = EnvShape, TPublic extends EnvShape = EnvShape> {
+    server?: TServer;
+    public?: TPublic;
+}
+interface ResolvedFarmEnv<TServer extends Record<string, any> = Record<string, unknown>, TPublic extends Record<string, any> = Record<string, unknown>> {
+    server: TServer;
+    public: TPublic;
+}
+type InferEnv<TConfig> = TConfig extends FarmEnvConfig<infer TServer, infer TPublic> ? ResolvedFarmEnv<InferEnvShape<TServer>, InferEnvShape<TPublic>> : ResolvedFarmEnv;
+/**
+ * Augmented by generated src/farm.d.ts for project-specific autocomplete.
+ */
+interface FarmEnvTypes {
+}
+type FarmServerEnv = FarmEnvTypes extends {
+    server: infer TServer;
+} ? TServer extends Record<string, any> ? TServer : Record<string, unknown> : Record<string, unknown>;
+type FarmPublicEnv = FarmEnvTypes extends {
+    public: infer TPublic;
+} ? TPublic extends Record<string, any> ? TPublic : Record<string, unknown> : Record<string, unknown>;
+type FarmTypedEnv = ResolvedFarmEnv<FarmServerEnv, FarmPublicEnv>;
+declare function resolveEnv<TConfig extends FarmEnvConfig<any, any> | undefined>(config: TConfig, source?: Record<string, string | undefined>): InferEnv<NonNullable<TConfig>>;
+declare function setEnv(env: ResolvedFarmEnv): void;
+declare function getResolvedEnv<TEnv extends ResolvedFarmEnv = FarmTypedEnv>(): TEnv;
+declare function getEnv<TServer extends Record<string, any> = FarmServerEnv>(): TServer;
+declare function getEnv<TKey extends Extract<keyof FarmServerEnv, string>>(key: TKey): FarmServerEnv[TKey];
+declare function getPublicEnv<TPublic extends Record<string, any> = FarmPublicEnv>(): TPublic;
+declare function getPublicEnv<TKey extends Extract<keyof FarmPublicEnv, string>>(key: TKey): FarmPublicEnv[TKey];
+declare const env: FarmServerEnv;
+declare const serverEnv: Record<string, unknown>;
+declare const publicEnv: FarmPublicEnv;
+
+export { type EnvParser, type EnvSchema, type EnvShape, type FarmEnvConfig, type FarmEnvTypes, type FarmPublicEnv, type FarmServerEnv, type FarmTypedEnv, type InferEnv, type InferEnvParser, type InferEnvShape, type ResolvedFarmEnv, env, getEnv, getPublicEnv, getResolvedEnv, publicEnv, resolveEnv, serverEnv, setEnv };

package/dist/environment/vite.d.mts

@@ -0,0 +1,22 @@
+import { Plugin } from 'vite';
+import { FarmEnvironment } from '../environment.mjs';
+
+interface AstNode {
+    type: string;
+    start: number;
+    end: number;
+    [key: string]: unknown;
+}
+interface TransformEnvironmentFunctionsOptions {
+    code: string;
+    id: string;
+    environment: FarmEnvironment;
+    parse: (code: string) => AstNode;
+}
+interface TransformEnvironmentFunctionsResult {
+    code: string;
+}
+declare function transformEnvironmentFunctions(options: TransformEnvironmentFunctionsOptions): TransformEnvironmentFunctionsResult | null;
+declare function farmEnvironmentFunctionsPlugin(): Plugin;
+
+export { type TransformEnvironmentFunctionsOptions, type TransformEnvironmentFunctionsResult, farmEnvironmentFunctionsPlugin, transformEnvironmentFunctions };

package/dist/environment/vite.d.ts

@@ -0,0 +1,22 @@
+import { Plugin } from 'vite';
+import { FarmEnvironment } from '../environment.js';
+
+interface AstNode {
+    type: string;
+    start: number;
+    end: number;
+    [key: string]: unknown;
+}
+interface TransformEnvironmentFunctionsOptions {
+    code: string;
+    id: string;
+    environment: FarmEnvironment;
+    parse: (code: string) => AstNode;
+}
+interface TransformEnvironmentFunctionsResult {
+    code: string;
+}
+declare function transformEnvironmentFunctions(options: TransformEnvironmentFunctionsOptions): TransformEnvironmentFunctionsResult | null;
+declare function farmEnvironmentFunctionsPlugin(): Plugin;
+
+export { type TransformEnvironmentFunctionsOptions, type TransformEnvironmentFunctionsResult, farmEnvironmentFunctionsPlugin, transformEnvironmentFunctions };

package/dist/environment.d.mts

@@ -0,0 +1,18 @@
+type AnyEnvironmentFunction = (...args: never[]) => unknown;
+type FarmEnvironment = "server" | "client";
+interface FarmIsomorphicFnOptions<TArgs extends unknown[], TServerResult, TClientResult> {
+    server: (...args: TArgs) => TServerResult;
+    client: (...args: TArgs) => TClientResult;
+}
+declare class FarmEnvironmentError extends Error {
+    readonly api: "createServerOnlyFn" | "createClientOnlyFn";
+    readonly expected: FarmEnvironment;
+    readonly actual: FarmEnvironment;
+    readonly code = "FARM_ENVIRONMENT_MISMATCH";
+    constructor(api: "createServerOnlyFn" | "createClientOnlyFn", expected: FarmEnvironment, actual: FarmEnvironment);
+}
+declare function createServerOnlyFn<TFunction extends AnyEnvironmentFunction>(implementation: TFunction): TFunction;
+declare function createClientOnlyFn<TFunction extends AnyEnvironmentFunction>(implementation: TFunction): TFunction;
+declare function createIsomorphicFn<TArgs extends unknown[], TServerResult, TClientResult>(options: FarmIsomorphicFnOptions<TArgs, TServerResult, TClientResult>): (...args: TArgs) => TServerResult | TClientResult;
+
+export { type FarmEnvironment, FarmEnvironmentError, type FarmIsomorphicFnOptions, createClientOnlyFn, createIsomorphicFn, createServerOnlyFn };

package/dist/environment.d.ts

@@ -0,0 +1,18 @@
+type AnyEnvironmentFunction = (...args: never[]) => unknown;
+type FarmEnvironment = "server" | "client";
+interface FarmIsomorphicFnOptions<TArgs extends unknown[], TServerResult, TClientResult> {
+    server: (...args: TArgs) => TServerResult;
+    client: (...args: TArgs) => TClientResult;
+}
+declare class FarmEnvironmentError extends Error {
+    readonly api: "createServerOnlyFn" | "createClientOnlyFn";
+    readonly expected: FarmEnvironment;
+    readonly actual: FarmEnvironment;
+    readonly code = "FARM_ENVIRONMENT_MISMATCH";
+    constructor(api: "createServerOnlyFn" | "createClientOnlyFn", expected: FarmEnvironment, actual: FarmEnvironment);
+}
+declare function createServerOnlyFn<TFunction extends AnyEnvironmentFunction>(implementation: TFunction): TFunction;
+declare function createClientOnlyFn<TFunction extends AnyEnvironmentFunction>(implementation: TFunction): TFunction;
+declare function createIsomorphicFn<TArgs extends unknown[], TServerResult, TClientResult>(options: FarmIsomorphicFnOptions<TArgs, TServerResult, TClientResult>): (...args: TArgs) => TServerResult | TClientResult;
+
+export { type FarmEnvironment, FarmEnvironmentError, type FarmIsomorphicFnOptions, createClientOnlyFn, createIsomorphicFn, createServerOnlyFn };

package/dist/font.d.mts

@@ -0,0 +1,95 @@
+type FarmFontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
+interface FarmFontSource {
+    /** Local file path or remote URL, depending on the loader. */
+    path: string;
+    /** A fixed weight (`400`) or variable range (`100 900`). */
+    weight?: number | string;
+    /** Font style for this source. */
+    style?: string;
+    /** Optional CSS unicode-range descriptor. */
+    unicodeRange?: string;
+}
+interface FarmFontOptions {
+    /** CSS font-family name. */
+    family: string;
+    /** A fixed weight (`400`) or variable range (`100 900`). */
+    weight?: number | string;
+    /** Font style. @default "normal" */
+    style?: string;
+    /** Browser loading behavior. @default "swap" */
+    display?: FarmFontDisplay;
+    /** CSS custom property populated by `variable`, for example `--font-sans`. */
+    variable?: `--${string}`;
+    /** Fallback family names appended to the generated stack. */
+    fallback?: string[];
+    /** Emit font preload hints. @default true */
+    preload?: boolean;
+}
+interface LocalFontOptions extends FarmFontOptions {
+    /**
+     * A file relative to this module, a package font specifier, or explicit
+     * sources for a multi-weight family.
+     */
+    src: string | FarmFontSource[];
+}
+interface RemoteFontSource extends FarmFontSource {
+    /** Optional integrity value for this source. Overrides the family-level value. */
+    integrity?: string;
+}
+interface RemoteFontOptions extends FarmFontOptions {
+    /** HTTPS font URL, or explicit remote sources for a multi-weight family. */
+    src: string | RemoteFontSource[];
+    /** Download and fingerprint the font during the build, or retain its URL. */
+    strategy?: "self-host" | "external";
+    /** Optional Subresource Integrity value checked while self-hosting. */
+    integrity?: string;
+}
+interface FarmFont {
+    /** Generated class that applies the font family and fallback stack. */
+    className: string;
+    /** Generated class that defines the configured CSS custom property. */
+    variable: string;
+    /** Inline-style equivalent of the generated family. */
+    style: Readonly<{
+        fontFamily: string;
+        fontStyle?: string;
+        fontWeight?: number | string;
+    }>;
+    /** Compiled resources that should be preloaded when this font is selected. */
+    preloads: readonly Readonly<{
+        href: string;
+        type: string;
+    }>[];
+}
+/** Semantic font roles inherited by framework-owned surfaces such as Farm Docs. */
+interface FarmLayoutFonts {
+    /** Default text and prose font. */
+    body?: FarmFont;
+    /** Code, keyboard input, and other technical UI font. */
+    code?: FarmFont;
+}
+interface FarmLayoutFontModule {
+    fonts?: FarmLayoutFonts;
+}
+/**
+ * Define the semantic fonts exported by a layout.
+ *
+ * Layouts are resolved from the root toward the requested route. A nearer
+ * layout overrides only the roles it defines, so it can replace `body` while
+ * continuing to inherit `code` from a parent layout.
+ */
+declare function defineLayoutFonts<const T extends FarmLayoutFonts>(fonts: T): T;
+/** Resolve semantic font roles from root layout to nearest layout. */
+declare function resolveFarmLayoutFonts(layouts: readonly FarmLayoutFontModule[]): FarmLayoutFonts | undefined;
+/**
+ * Compile local font files into hashed application assets and generated CSS.
+ * The call is removed at build time and adds no font-loader runtime code.
+ */
+declare function localFont(_options: LocalFontOptions): FarmFont;
+/**
+ * Compile a remote font into a self-hosted application asset by default.
+ * Use `strategy: "external"` only when the browser should retain the remote URL.
+ */
+declare function remoteFont(_options: RemoteFontOptions): FarmFont;
+
+export { type FarmFont, type FarmFontDisplay, type FarmFontOptions, type FarmFontSource, type FarmLayoutFontModule, type FarmLayoutFonts, type LocalFontOptions, type RemoteFontOptions, type RemoteFontSource, defineLayoutFonts, localFont, remoteFont, resolveFarmLayoutFonts };

package/dist/font.d.ts

@@ -0,0 +1,95 @@
+type FarmFontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
+interface FarmFontSource {
+    /** Local file path or remote URL, depending on the loader. */
+    path: string;
+    /** A fixed weight (`400`) or variable range (`100 900`). */
+    weight?: number | string;
+    /** Font style for this source. */
+    style?: string;
+    /** Optional CSS unicode-range descriptor. */
+    unicodeRange?: string;
+}
+interface FarmFontOptions {
+    /** CSS font-family name. */
+    family: string;
+    /** A fixed weight (`400`) or variable range (`100 900`). */
+    weight?: number | string;
+    /** Font style. @default "normal" */
+    style?: string;
+    /** Browser loading behavior. @default "swap" */
+    display?: FarmFontDisplay;
+    /** CSS custom property populated by `variable`, for example `--font-sans`. */
+    variable?: `--${string}`;
+    /** Fallback family names appended to the generated stack. */
+    fallback?: string[];
+    /** Emit font preload hints. @default true */
+    preload?: boolean;
+}
+interface LocalFontOptions extends FarmFontOptions {
+    /**
+     * A file relative to this module, a package font specifier, or explicit
+     * sources for a multi-weight family.
+     */
+    src: string | FarmFontSource[];
+}
+interface RemoteFontSource extends FarmFontSource {
+    /** Optional integrity value for this source. Overrides the family-level value. */
+    integrity?: string;
+}
+interface RemoteFontOptions extends FarmFontOptions {
+    /** HTTPS font URL, or explicit remote sources for a multi-weight family. */
+    src: string | RemoteFontSource[];
+    /** Download and fingerprint the font during the build, or retain its URL. */
+    strategy?: "self-host" | "external";
+    /** Optional Subresource Integrity value checked while self-hosting. */
+    integrity?: string;
+}
+interface FarmFont {
+    /** Generated class that applies the font family and fallback stack. */
+    className: string;
+    /** Generated class that defines the configured CSS custom property. */
+    variable: string;
+    /** Inline-style equivalent of the generated family. */
+    style: Readonly<{
+        fontFamily: string;
+        fontStyle?: string;
+        fontWeight?: number | string;
+    }>;
+    /** Compiled resources that should be preloaded when this font is selected. */
+    preloads: readonly Readonly<{
+        href: string;
+        type: string;
+    }>[];
+}
+/** Semantic font roles inherited by framework-owned surfaces such as Farm Docs. */
+interface FarmLayoutFonts {
+    /** Default text and prose font. */
+    body?: FarmFont;
+    /** Code, keyboard input, and other technical UI font. */
+    code?: FarmFont;
+}
+interface FarmLayoutFontModule {
+    fonts?: FarmLayoutFonts;
+}
+/**
+ * Define the semantic fonts exported by a layout.
+ *
+ * Layouts are resolved from the root toward the requested route. A nearer
+ * layout overrides only the roles it defines, so it can replace `body` while
+ * continuing to inherit `code` from a parent layout.
+ */
+declare function defineLayoutFonts<const T extends FarmLayoutFonts>(fonts: T): T;
+/** Resolve semantic font roles from root layout to nearest layout. */
+declare function resolveFarmLayoutFonts(layouts: readonly FarmLayoutFontModule[]): FarmLayoutFonts | undefined;
+/**
+ * Compile local font files into hashed application assets and generated CSS.
+ * The call is removed at build time and adds no font-loader runtime code.
+ */
+declare function localFont(_options: LocalFontOptions): FarmFont;
+/**
+ * Compile a remote font into a self-hosted application asset by default.
+ * Use `strategy: "external"` only when the browser should retain the remote URL.
+ */
+declare function remoteFont(_options: RemoteFontOptions): FarmFont;
+
+export { type FarmFont, type FarmFontDisplay, type FarmFontOptions, type FarmFontSource, type FarmLayoutFontModule, type FarmLayoutFonts, type LocalFontOptions, type RemoteFontOptions, type RemoteFontSource, defineLayoutFonts, localFont, remoteFont, resolveFarmLayoutFonts };

package/dist/headers.d.mts

@@ -0,0 +1,22 @@
+interface RequestCookie {
+    name: string;
+    value: string;
+}
+interface ReadonlyHeaders extends Iterable<[string, string]> {
+    get(name: string): string | null;
+    has(name: string): boolean;
+    forEach(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any): void;
+    entries(): IterableIterator<[string, string]>;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<string>;
+}
+interface ReadonlyRequestCookies extends Iterable<RequestCookie> {
+    get(name: string): RequestCookie | undefined;
+    getAll(name?: string): RequestCookie[];
+    has(name: string): boolean;
+    toString(): string;
+}
+declare function headers(): ReadonlyHeaders;
+declare function cookies(): ReadonlyRequestCookies;
+
+export { type ReadonlyHeaders, type ReadonlyRequestCookies, type RequestCookie, cookies, headers };

package/dist/headers.d.ts

@@ -0,0 +1,22 @@
+interface RequestCookie {
+    name: string;
+    value: string;
+}
+interface ReadonlyHeaders extends Iterable<[string, string]> {
+    get(name: string): string | null;
+    has(name: string): boolean;
+    forEach(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any): void;
+    entries(): IterableIterator<[string, string]>;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<string>;
+}
+interface ReadonlyRequestCookies extends Iterable<RequestCookie> {
+    get(name: string): RequestCookie | undefined;
+    getAll(name?: string): RequestCookie[];
+    has(name: string): boolean;
+    toString(): string;
+}
+declare function headers(): ReadonlyHeaders;
+declare function cookies(): ReadonlyRequestCookies;
+
+export { type ReadonlyHeaders, type ReadonlyRequestCookies, type RequestCookie, cookies, headers };