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

package/dist/transport-BmbGTXA5.d.mts

@@ -0,0 +1,49 @@
+type MultipartField = string | number | boolean | bigint | Blob | Date | null | undefined;
+type MultipartValues = Record<string, MultipartField | readonly MultipartField[]>;
+/**
+ * A real FormData value that retains the submitted value shape for generated
+ * API-client inference.
+ */
+type TypedFormData<TValues> = FormData & {
+    readonly __farmMultipartInput: TValues;
+};
+type MultipartSchema<TSchema> = TSchema & {
+    readonly __farmMultipartSchema: true;
+};
+type FarmStreamResponse<TItem> = Response & {
+    readonly __farmStreamItem: TItem;
+};
+interface FarmAPIStream<TItem> extends AsyncIterable<TItem> {
+    readonly response: Response;
+    cancel(reason?: unknown): Promise<void>;
+}
+type SchemaLike = {
+    parse(data: unknown): unknown;
+};
+/**
+ * Mark a body schema as multipart. The handler still receives the schema's
+ * parsed object; generated clients require `toFormData(...)` for the request.
+ */
+declare function multipart<TSchema extends SchemaLike>(schema: TSchema): MultipartSchema<TSchema>;
+declare function isMultipartSchema(value: unknown): value is MultipartSchema<SchemaLike>;
+/**
+ * Encode a typed object as multipart FormData without converting File or Blob
+ * values to JSON or base64.
+ */
+declare function toFormData<TValues extends MultipartValues>(values: TValues): TypedFormData<TValues>;
+/**
+ * Stream JSON values as newline-delimited JSON. Each source value becomes one
+ * independently decodable item instead of buffering the whole response.
+ */
+declare function jsonStream<TItem>(source: AsyncIterable<TItem> | Iterable<TItem>, init?: ResponseInit): FarmStreamResponse<TItem>;
+declare function isJSONStreamResponse(response: {
+    headers?: Pick<Headers, "get"> | null;
+}): boolean;
+/**
+ * Decode a Farm JSON stream lazily. The response body is read only as the
+ * consumer advances the async iterator, preserving fetch backpressure.
+ */
+declare function readJSONStream<TItem>(response: Response): FarmAPIStream<TItem>;
+declare function isFarmAPIStream(value: unknown): value is FarmAPIStream<unknown>;
+
+export { type FarmAPIStream as F, type MultipartSchema as M, type TypedFormData as T, type MultipartField as a, type MultipartValues as b, type FarmStreamResponse as c, isJSONStreamResponse as d, isFarmAPIStream as e, isMultipartSchema as i, jsonStream as j, multipart as m, readJSONStream as r, toFormData as t };

package/dist/transport-BmbGTXA5.d.ts

@@ -0,0 +1,49 @@
+type MultipartField = string | number | boolean | bigint | Blob | Date | null | undefined;
+type MultipartValues = Record<string, MultipartField | readonly MultipartField[]>;
+/**
+ * A real FormData value that retains the submitted value shape for generated
+ * API-client inference.
+ */
+type TypedFormData<TValues> = FormData & {
+    readonly __farmMultipartInput: TValues;
+};
+type MultipartSchema<TSchema> = TSchema & {
+    readonly __farmMultipartSchema: true;
+};
+type FarmStreamResponse<TItem> = Response & {
+    readonly __farmStreamItem: TItem;
+};
+interface FarmAPIStream<TItem> extends AsyncIterable<TItem> {
+    readonly response: Response;
+    cancel(reason?: unknown): Promise<void>;
+}
+type SchemaLike = {
+    parse(data: unknown): unknown;
+};
+/**
+ * Mark a body schema as multipart. The handler still receives the schema's
+ * parsed object; generated clients require `toFormData(...)` for the request.
+ */
+declare function multipart<TSchema extends SchemaLike>(schema: TSchema): MultipartSchema<TSchema>;
+declare function isMultipartSchema(value: unknown): value is MultipartSchema<SchemaLike>;
+/**
+ * Encode a typed object as multipart FormData without converting File or Blob
+ * values to JSON or base64.
+ */
+declare function toFormData<TValues extends MultipartValues>(values: TValues): TypedFormData<TValues>;
+/**
+ * Stream JSON values as newline-delimited JSON. Each source value becomes one
+ * independently decodable item instead of buffering the whole response.
+ */
+declare function jsonStream<TItem>(source: AsyncIterable<TItem> | Iterable<TItem>, init?: ResponseInit): FarmStreamResponse<TItem>;
+declare function isJSONStreamResponse(response: {
+    headers?: Pick<Headers, "get"> | null;
+}): boolean;
+/**
+ * Decode a Farm JSON stream lazily. The response body is read only as the
+ * consumer advances the async iterator, preserving fetch backpressure.
+ */
+declare function readJSONStream<TItem>(response: Response): FarmAPIStream<TItem>;
+declare function isFarmAPIStream(value: unknown): value is FarmAPIStream<unknown>;
+
+export { type FarmAPIStream as F, type MultipartSchema as M, type TypedFormData as T, type MultipartField as a, type MultipartValues as b, type FarmStreamResponse as c, isJSONStreamResponse as d, isFarmAPIStream as e, isMultipartSchema as i, jsonStream as j, multipart as m, readJSONStream as r, toFormData as t };

package/dist/types-BMxWr97v.d.mts

@@ -0,0 +1,81 @@
+type FarmI18nRouting = "prefix-always" | "prefix-except-default" | "none";
+type FarmI18nDetectionSignal = "url" | "cookie" | "accept-language";
+type FarmI18nLocaleSource = FarmI18nDetectionSignal | "default" | "explicit";
+type FarmI18nDirection = "ltr" | "rtl";
+interface FarmI18nCookieConfig {
+    name?: string;
+    maxAge?: number;
+    path?: string;
+    sameSite?: "lax" | "strict" | "none";
+    secure?: boolean;
+}
+interface FarmI18nUserConfig {
+    locales: readonly string[];
+    defaultLocale: string;
+    /** Directory containing `<locale>.json`, or a path containing `{locale}`. */
+    messages?: string;
+    routing?: FarmI18nRouting;
+    detection?: false | readonly FarmI18nDetectionSignal[];
+    fallbackLocale?: string;
+    strict?: boolean;
+    cookie?: FarmI18nCookieConfig;
+    direction?: Partial<Record<string, FarmI18nDirection>>;
+    /** @deprecated Use `detection: false` to disable automatic detection. */
+    localeDetection?: boolean;
+}
+interface ResolvedFarmI18nCookieConfig {
+    name: string;
+    maxAge: number;
+    path: string;
+    sameSite: "lax" | "strict" | "none";
+    secure: boolean;
+}
+interface ResolvedFarmI18nConfig {
+    enabled: boolean;
+    locales: readonly string[];
+    defaultLocale: string;
+    messages: string;
+    routing: FarmI18nRouting;
+    detection: readonly FarmI18nDetectionSignal[];
+    fallbackLocale: string;
+    strict: boolean;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: Readonly<Record<string, FarmI18nDirection>>;
+}
+type FarmI18nCatalog = Record<string, string>;
+type FarmI18nCatalogs = Record<string, FarmI18nCatalog>;
+interface FarmI18nClientSnapshot {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    locales: readonly string[];
+    defaultLocale: string;
+    routing: FarmI18nRouting;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: FarmI18nDirection;
+    messages: FarmI18nCatalog;
+}
+/** The generated `farm.d.ts` file augments this interface. */
+interface FarmI18nMessageRegistry {
+}
+/** The generated `farm.d.ts` file augments this interface. */
+interface FarmI18nLocaleRegistry {
+}
+type RegisteredMessageKey = Extract<keyof FarmI18nMessageRegistry, string>;
+type RegisteredLocale = Extract<keyof FarmI18nLocaleRegistry, string>;
+type FarmI18nMessageKey = [RegisteredMessageKey] extends [never] ? string : RegisteredMessageKey;
+type FarmI18nLocale = [RegisteredLocale] extends [never] ? string : RegisteredLocale;
+type FarmI18nMessageValues<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? FarmI18nMessageRegistry[TKey] : Record<string, unknown>;
+type FarmI18nMessageArgs<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? keyof FarmI18nMessageRegistry[TKey] extends never ? [values?: FarmI18nMessageRegistry[TKey]] : [values: FarmI18nMessageRegistry[TKey]] : [values?: Record<string, unknown>];
+interface FarmTranslator {
+    <TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): string;
+    rich<TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): unknown;
+    raw<TKey extends FarmI18nMessageKey>(key: TKey): string;
+    has(key: string): boolean;
+}
+declare global {
+    interface Window {
+        __FARM_I18N__?: FarmI18nClientSnapshot;
+    }
+}
+
+export type { FarmI18nCatalogs as F, ResolvedFarmI18nConfig as R, FarmI18nClientSnapshot as a, FarmI18nLocaleSource as b, FarmI18nLocale as c, FarmTranslator as d, FarmI18nMessageArgs as e, FarmI18nMessageKey as f, FarmI18nCookieConfig as g, FarmI18nDetectionSignal as h, FarmI18nDirection as i, FarmI18nRouting as j, FarmI18nUserConfig as k, FarmI18nCatalog as l, FarmI18nLocaleRegistry as m, FarmI18nMessageRegistry as n, FarmI18nMessageValues as o };

package/dist/types-BMxWr97v.d.ts

@@ -0,0 +1,81 @@
+type FarmI18nRouting = "prefix-always" | "prefix-except-default" | "none";
+type FarmI18nDetectionSignal = "url" | "cookie" | "accept-language";
+type FarmI18nLocaleSource = FarmI18nDetectionSignal | "default" | "explicit";
+type FarmI18nDirection = "ltr" | "rtl";
+interface FarmI18nCookieConfig {
+    name?: string;
+    maxAge?: number;
+    path?: string;
+    sameSite?: "lax" | "strict" | "none";
+    secure?: boolean;
+}
+interface FarmI18nUserConfig {
+    locales: readonly string[];
+    defaultLocale: string;
+    /** Directory containing `<locale>.json`, or a path containing `{locale}`. */
+    messages?: string;
+    routing?: FarmI18nRouting;
+    detection?: false | readonly FarmI18nDetectionSignal[];
+    fallbackLocale?: string;
+    strict?: boolean;
+    cookie?: FarmI18nCookieConfig;
+    direction?: Partial<Record<string, FarmI18nDirection>>;
+    /** @deprecated Use `detection: false` to disable automatic detection. */
+    localeDetection?: boolean;
+}
+interface ResolvedFarmI18nCookieConfig {
+    name: string;
+    maxAge: number;
+    path: string;
+    sameSite: "lax" | "strict" | "none";
+    secure: boolean;
+}
+interface ResolvedFarmI18nConfig {
+    enabled: boolean;
+    locales: readonly string[];
+    defaultLocale: string;
+    messages: string;
+    routing: FarmI18nRouting;
+    detection: readonly FarmI18nDetectionSignal[];
+    fallbackLocale: string;
+    strict: boolean;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: Readonly<Record<string, FarmI18nDirection>>;
+}
+type FarmI18nCatalog = Record<string, string>;
+type FarmI18nCatalogs = Record<string, FarmI18nCatalog>;
+interface FarmI18nClientSnapshot {
+    locale: string;
+    source: FarmI18nLocaleSource;
+    locales: readonly string[];
+    defaultLocale: string;
+    routing: FarmI18nRouting;
+    cookie: ResolvedFarmI18nCookieConfig;
+    direction: FarmI18nDirection;
+    messages: FarmI18nCatalog;
+}
+/** The generated `farm.d.ts` file augments this interface. */
+interface FarmI18nMessageRegistry {
+}
+/** The generated `farm.d.ts` file augments this interface. */
+interface FarmI18nLocaleRegistry {
+}
+type RegisteredMessageKey = Extract<keyof FarmI18nMessageRegistry, string>;
+type RegisteredLocale = Extract<keyof FarmI18nLocaleRegistry, string>;
+type FarmI18nMessageKey = [RegisteredMessageKey] extends [never] ? string : RegisteredMessageKey;
+type FarmI18nLocale = [RegisteredLocale] extends [never] ? string : RegisteredLocale;
+type FarmI18nMessageValues<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? FarmI18nMessageRegistry[TKey] : Record<string, unknown>;
+type FarmI18nMessageArgs<TKey extends FarmI18nMessageKey> = TKey extends RegisteredMessageKey ? keyof FarmI18nMessageRegistry[TKey] extends never ? [values?: FarmI18nMessageRegistry[TKey]] : [values: FarmI18nMessageRegistry[TKey]] : [values?: Record<string, unknown>];
+interface FarmTranslator {
+    <TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): string;
+    rich<TKey extends FarmI18nMessageKey>(key: TKey, ...args: FarmI18nMessageArgs<TKey>): unknown;
+    raw<TKey extends FarmI18nMessageKey>(key: TKey): string;
+    has(key: string): boolean;
+}
+declare global {
+    interface Window {
+        __FARM_I18N__?: FarmI18nClientSnapshot;
+    }
+}
+
+export type { FarmI18nCatalogs as F, ResolvedFarmI18nConfig as R, FarmI18nClientSnapshot as a, FarmI18nLocaleSource as b, FarmI18nLocale as c, FarmTranslator as d, FarmI18nMessageArgs as e, FarmI18nMessageKey as f, FarmI18nCookieConfig as g, FarmI18nDetectionSignal as h, FarmI18nDirection as i, FarmI18nRouting as j, FarmI18nUserConfig as k, FarmI18nCatalog as l, FarmI18nLocaleRegistry as m, FarmI18nMessageRegistry as n, FarmI18nMessageValues as o };

package/dist/types-CsR8fpgF.d.mts

@@ -0,0 +1,30 @@
+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 { FarmThemeRuntime as F, ResolvedFarmThemeConfig as R, FarmThemeSnapshot as a, FarmThemePreference as b, FarmResolvedTheme as c, FarmThemeConfig as d };

package/dist/types-CsR8fpgF.d.ts

@@ -0,0 +1,30 @@
+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 { FarmThemeRuntime as F, ResolvedFarmThemeConfig as R, FarmThemeSnapshot as a, FarmThemePreference as b, FarmResolvedTheme as c, FarmThemeConfig as d };

package/dist/types-D1A6-XvH.d.mts

@@ -0,0 +1,73 @@
+import { ConnectorOptions } from 'db0';
+import { BuiltinDriverOptions, BuiltinDriverName, Driver, Storage } from 'unstorage';
+
+type ObjectShape<T> = T extends object ? T : Record<string, never>;
+type FarmStorageBuiltinDriverWithoutDB0 = Exclude<Extract<BuiltinDriverName, keyof BuiltinDriverOptions>, "db0">;
+type FarmStorageBuiltinDriverConfigMap = {
+    [K in FarmStorageBuiltinDriverWithoutDB0]: {
+        driver: K;
+        options?: BuiltinDriverOptions[K];
+    } & Partial<ObjectShape<BuiltinDriverOptions[K]>>;
+};
+type FarmStorageDatabaseDriverMap = {
+    sqlite: "node-sqlite";
+    "node-sqlite": "node-sqlite";
+    sqlite3: "sqlite3";
+    "better-sqlite3": "better-sqlite3";
+    postgres: "postgresql";
+    postgresql: "postgresql";
+    pg: "postgresql";
+    mysql: "mysql2";
+    mysql2: "mysql2";
+    pglite: "pglite";
+    planetscale: "planetscale";
+    libsql: "libsql";
+    "libsql-node": "libsql-node";
+    "libsql-http": "libsql-http";
+};
+type FarmStorageDatabaseDriverName = keyof FarmStorageDatabaseDriverMap;
+type FarmStorageDatabaseConfigMap = {
+    [K in FarmStorageDatabaseDriverName]: {
+        driver: K;
+        options?: ConnectorOptions[FarmStorageDatabaseDriverMap[K]];
+        tableName?: string;
+    } & Partial<ObjectShape<ConnectorOptions[FarmStorageDatabaseDriverMap[K]]>>;
+};
+type FarmStorageMemoryDriverConfig = {
+    driver?: "memory";
+};
+type FarmStorageLocalDriverConfig = {
+    driver: "local";
+    options?: BuiltinDriverOptions["fs-lite"];
+} & Partial<ObjectShape<BuiltinDriverOptions["fs-lite"]>>;
+type FarmStorageDB0DriverConfig = {
+    driver: "db0";
+    options: BuiltinDriverOptions["db0"];
+};
+type FarmStorageBuiltinDriverConfig = FarmStorageMemoryDriverConfig | FarmStorageLocalDriverConfig | FarmStorageDB0DriverConfig | FarmStorageBuiltinDriverConfigMap[FarmStorageBuiltinDriverWithoutDB0];
+interface FarmStorageClient extends Storage {
+    readonly kind: "farm-storage-client";
+    ready(): Promise<Storage>;
+    createStorage(): Promise<Storage>;
+    resolveDriver(): Promise<Driver>;
+}
+type FarmStorageRuntimeClient = object | (() => unknown | Promise<unknown>);
+interface FarmStorageCustomDriverConfig {
+    driver: Driver | (() => Driver | Promise<Driver>);
+}
+type FarmStorageDatabaseConfig = FarmStorageDatabaseConfigMap[FarmStorageDatabaseDriverName];
+type FarmStorageClientConfig = FarmStorageBuiltinDriverConfig | FarmStorageDatabaseConfig | FarmStorageCustomDriverConfig;
+type FarmStorageMountConfig = FarmStorageClientConfig | FarmStorageClient;
+type FarmStorageMounts = Record<string, FarmStorageMountConfig>;
+type FarmStorageConfigObject = FarmStorageClientConfig & {
+    /**
+     * Existing FarmStorageClient instances still drive Farm's key/value storage.
+     * Other objects/functions are treated as application runtime clients for
+     * schema-backed integration persistence via @farming-labs/orm.
+     */
+    client?: FarmStorageClient | FarmStorageRuntimeClient;
+    mounts?: FarmStorageMounts;
+};
+type FarmStorageUserConfig = FarmStorageConfigObject | FarmStorageClient;
+
+export type { FarmStorageBuiltinDriverConfig as F, FarmStorageClient as a, FarmStorageClientConfig as b, FarmStorageConfigObject as c, FarmStorageCustomDriverConfig as d, FarmStorageDatabaseConfig as e, FarmStorageDatabaseDriverName as f, FarmStorageLocalDriverConfig as g, FarmStorageRuntimeClient as h, FarmStorageMountConfig as i, FarmStorageMounts as j, FarmStorageUserConfig as k };

package/dist/types-D1A6-XvH.d.ts

@@ -0,0 +1,73 @@
+import { ConnectorOptions } from 'db0';
+import { BuiltinDriverOptions, BuiltinDriverName, Driver, Storage } from 'unstorage';
+
+type ObjectShape<T> = T extends object ? T : Record<string, never>;
+type FarmStorageBuiltinDriverWithoutDB0 = Exclude<Extract<BuiltinDriverName, keyof BuiltinDriverOptions>, "db0">;
+type FarmStorageBuiltinDriverConfigMap = {
+    [K in FarmStorageBuiltinDriverWithoutDB0]: {
+        driver: K;
+        options?: BuiltinDriverOptions[K];
+    } & Partial<ObjectShape<BuiltinDriverOptions[K]>>;
+};
+type FarmStorageDatabaseDriverMap = {
+    sqlite: "node-sqlite";
+    "node-sqlite": "node-sqlite";
+    sqlite3: "sqlite3";
+    "better-sqlite3": "better-sqlite3";
+    postgres: "postgresql";
+    postgresql: "postgresql";
+    pg: "postgresql";
+    mysql: "mysql2";
+    mysql2: "mysql2";
+    pglite: "pglite";
+    planetscale: "planetscale";
+    libsql: "libsql";
+    "libsql-node": "libsql-node";
+    "libsql-http": "libsql-http";
+};
+type FarmStorageDatabaseDriverName = keyof FarmStorageDatabaseDriverMap;
+type FarmStorageDatabaseConfigMap = {
+    [K in FarmStorageDatabaseDriverName]: {
+        driver: K;
+        options?: ConnectorOptions[FarmStorageDatabaseDriverMap[K]];
+        tableName?: string;
+    } & Partial<ObjectShape<ConnectorOptions[FarmStorageDatabaseDriverMap[K]]>>;
+};
+type FarmStorageMemoryDriverConfig = {
+    driver?: "memory";
+};
+type FarmStorageLocalDriverConfig = {
+    driver: "local";
+    options?: BuiltinDriverOptions["fs-lite"];
+} & Partial<ObjectShape<BuiltinDriverOptions["fs-lite"]>>;
+type FarmStorageDB0DriverConfig = {
+    driver: "db0";
+    options: BuiltinDriverOptions["db0"];
+};
+type FarmStorageBuiltinDriverConfig = FarmStorageMemoryDriverConfig | FarmStorageLocalDriverConfig | FarmStorageDB0DriverConfig | FarmStorageBuiltinDriverConfigMap[FarmStorageBuiltinDriverWithoutDB0];
+interface FarmStorageClient extends Storage {
+    readonly kind: "farm-storage-client";
+    ready(): Promise<Storage>;
+    createStorage(): Promise<Storage>;
+    resolveDriver(): Promise<Driver>;
+}
+type FarmStorageRuntimeClient = object | (() => unknown | Promise<unknown>);
+interface FarmStorageCustomDriverConfig {
+    driver: Driver | (() => Driver | Promise<Driver>);
+}
+type FarmStorageDatabaseConfig = FarmStorageDatabaseConfigMap[FarmStorageDatabaseDriverName];
+type FarmStorageClientConfig = FarmStorageBuiltinDriverConfig | FarmStorageDatabaseConfig | FarmStorageCustomDriverConfig;
+type FarmStorageMountConfig = FarmStorageClientConfig | FarmStorageClient;
+type FarmStorageMounts = Record<string, FarmStorageMountConfig>;
+type FarmStorageConfigObject = FarmStorageClientConfig & {
+    /**
+     * Existing FarmStorageClient instances still drive Farm's key/value storage.
+     * Other objects/functions are treated as application runtime clients for
+     * schema-backed integration persistence via @farming-labs/orm.
+     */
+    client?: FarmStorageClient | FarmStorageRuntimeClient;
+    mounts?: FarmStorageMounts;
+};
+type FarmStorageUserConfig = FarmStorageConfigObject | FarmStorageClient;
+
+export type { FarmStorageBuiltinDriverConfig as F, FarmStorageClient as a, FarmStorageClientConfig as b, FarmStorageConfigObject as c, FarmStorageCustomDriverConfig as d, FarmStorageDatabaseConfig as e, FarmStorageDatabaseDriverName as f, FarmStorageLocalDriverConfig as g, FarmStorageRuntimeClient as h, FarmStorageMountConfig as i, FarmStorageMounts as j, FarmStorageUserConfig as k };

package/dist/types-DTzm4TCl.d.mts

@@ -0,0 +1,78 @@
+import { DocsConfig } from '@farming-labs/docs';
+
+interface FarmDocsSidebarItem {
+    label?: string;
+    title?: string;
+    slug?: string;
+    href?: string;
+    icon?: string;
+    children?: FarmDocsSidebarItem[];
+    items?: FarmDocsSidebarItem[];
+}
+interface FarmDocsNavigationConfig {
+    sidebar?: FarmDocsSidebarItem[];
+}
+interface FarmDocsSocialImageConfig {
+    /** Generate a page-specific 1200×630 social image. Defaults to true. */
+    enabled?: boolean;
+    /** Absolute public origin used in social metadata, e.g. https://example.com. */
+    baseUrl?: string;
+    /** Site name shown in Open Graph metadata. Defaults to the docs navigation title. */
+    siteName?: string;
+    /** Short brand label drawn in the image header. Defaults to siteName. */
+    brand?: string;
+    /** Optional WOFF2 URLs or data URLs embedded into the generated SVG. */
+    fonts?: FarmDocsSocialImageFonts;
+}
+interface FarmDocsSocialImageFonts {
+    /** Display face used for page titles. */
+    display?: string;
+    /** Sans-serif face used for descriptions. */
+    sans?: string;
+    /** Monospace face used for labels, routes, and diagrams. */
+    mono?: string;
+}
+type FarmDocsRuntimeConfig = Partial<DocsConfig> & {
+    /**
+     * Public favicon URL used by the standalone docs renderer.
+     * Set this explicitly when docs should share the host application's icon.
+     */
+    favicon?: string;
+    /**
+     * Optional serializable navigation tree used by Farm's docs runtime.
+     * Icon values reference keys from `icons`.
+     */
+    navigation?: FarmDocsNavigationConfig;
+    /**
+     * Automatic page-specific Open Graph and X images for Markdown docs.
+     * Enabled by default. Set false to opt out for the complete docs tree.
+     */
+    socialImage?: boolean | FarmDocsSocialImageConfig;
+};
+type FarmDocsConfigInput = FarmDocsRuntimeConfig & {
+    /**
+     * Farm public route for docs, e.g. "/docs". When passed through
+     * `config`, this is converted to the docs package's folder-style `entry`.
+     */
+    entry?: string;
+    /** Explicit public route prefix. Defaults to `entry`. */
+    docsPath?: string;
+    /** Source content directory, relative to the project root. */
+    contentDir?: string;
+    /** Set to false to opt out even when a docs config file exists. */
+    enabled?: boolean;
+    /** Inline @farming-labs/docs config object. */
+    config?: FarmDocsRuntimeConfig;
+    /** Path to docs.config.* or docs.json. */
+    configPath?: string;
+};
+type FarmDocsUserConfig = boolean | FarmDocsConfigInput;
+interface FarmDocsResolvedConfig {
+    enabled: boolean;
+    entry: string;
+    contentDir?: string;
+    configPath?: string;
+    config: FarmDocsRuntimeConfig & Pick<DocsConfig, "entry">;
+}
+
+export type { FarmDocsResolvedConfig as F, FarmDocsUserConfig as a, FarmDocsConfigInput as b, FarmDocsNavigationConfig as c, FarmDocsSocialImageConfig as d, FarmDocsSocialImageFonts as e, FarmDocsSidebarItem as f };

package/dist/types-DTzm4TCl.d.ts

@@ -0,0 +1,78 @@
+import { DocsConfig } from '@farming-labs/docs';
+
+interface FarmDocsSidebarItem {
+    label?: string;
+    title?: string;
+    slug?: string;
+    href?: string;
+    icon?: string;
+    children?: FarmDocsSidebarItem[];
+    items?: FarmDocsSidebarItem[];
+}
+interface FarmDocsNavigationConfig {
+    sidebar?: FarmDocsSidebarItem[];
+}
+interface FarmDocsSocialImageConfig {
+    /** Generate a page-specific 1200×630 social image. Defaults to true. */
+    enabled?: boolean;
+    /** Absolute public origin used in social metadata, e.g. https://example.com. */
+    baseUrl?: string;
+    /** Site name shown in Open Graph metadata. Defaults to the docs navigation title. */
+    siteName?: string;
+    /** Short brand label drawn in the image header. Defaults to siteName. */
+    brand?: string;
+    /** Optional WOFF2 URLs or data URLs embedded into the generated SVG. */
+    fonts?: FarmDocsSocialImageFonts;
+}
+interface FarmDocsSocialImageFonts {
+    /** Display face used for page titles. */
+    display?: string;
+    /** Sans-serif face used for descriptions. */
+    sans?: string;
+    /** Monospace face used for labels, routes, and diagrams. */
+    mono?: string;
+}
+type FarmDocsRuntimeConfig = Partial<DocsConfig> & {
+    /**
+     * Public favicon URL used by the standalone docs renderer.
+     * Set this explicitly when docs should share the host application's icon.
+     */
+    favicon?: string;
+    /**
+     * Optional serializable navigation tree used by Farm's docs runtime.
+     * Icon values reference keys from `icons`.
+     */
+    navigation?: FarmDocsNavigationConfig;
+    /**
+     * Automatic page-specific Open Graph and X images for Markdown docs.
+     * Enabled by default. Set false to opt out for the complete docs tree.
+     */
+    socialImage?: boolean | FarmDocsSocialImageConfig;
+};
+type FarmDocsConfigInput = FarmDocsRuntimeConfig & {
+    /**
+     * Farm public route for docs, e.g. "/docs". When passed through
+     * `config`, this is converted to the docs package's folder-style `entry`.
+     */
+    entry?: string;
+    /** Explicit public route prefix. Defaults to `entry`. */
+    docsPath?: string;
+    /** Source content directory, relative to the project root. */
+    contentDir?: string;
+    /** Set to false to opt out even when a docs config file exists. */
+    enabled?: boolean;
+    /** Inline @farming-labs/docs config object. */
+    config?: FarmDocsRuntimeConfig;
+    /** Path to docs.config.* or docs.json. */
+    configPath?: string;
+};
+type FarmDocsUserConfig = boolean | FarmDocsConfigInput;
+interface FarmDocsResolvedConfig {
+    enabled: boolean;
+    entry: string;
+    contentDir?: string;
+    configPath?: string;
+    config: FarmDocsRuntimeConfig & Pick<DocsConfig, "entry">;
+}
+
+export type { FarmDocsResolvedConfig as F, FarmDocsUserConfig as a, FarmDocsConfigInput as b, FarmDocsNavigationConfig as c, FarmDocsSocialImageConfig as d, FarmDocsSocialImageFonts as e, FarmDocsSidebarItem as f };

package/dist/utils-3sQgfkya.d.ts

@@ -0,0 +1,23 @@
+import { C as ParsedRoute, B as RouteSegment } from './client-plugins-DuuleQKk.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;
+};
+declare function resolveAppPath(root: string, ...paths: string[]): string;
+declare function toViteModuleId(filePath: string, root: string): string;
+declare function fileExists(filePath: string): Promise<boolean>;
+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 { parseSearchParams as a, fileExists as f, globFiles as g, logger as l, matchRoute as m, parseRoutePath as p, resolveAppPath as r, segmentsToPattern as s, toViteModuleId as t };