@crustjs/store 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -1,4 +1,251 @@
 /**
+* Recursively makes all properties of `T` optional.
+*
+* - Plain objects are recursed into — each nested key becomes optional.
+* - Arrays are left as-is (replaced wholesale, not partially updated).
+* - Primitives pass through unchanged.
+*
+* Used by {@link Store.patch} for deep partial updates.
+*
+* @example
+* ```ts
+* type Config = { ui: { theme: string; fontSize: number }; verbose: boolean };
+* type Partial = DeepPartial<Config>;
+* // → { ui?: { theme?: string; fontSize?: number }; verbose?: boolean }
+* ```
+*/
+type DeepPartial<T> = T extends readonly unknown[] ? T : T extends Record<string, unknown> ? { [K in keyof T]? : DeepPartial<T[K]> } : T;
+/**
+* Result returned by a {@link StoreValidator} when validation succeeds.
+*
+* Carries the (possibly transformed) config value from the schema.
+*/
+interface StoreValidatorSuccess<T> {
+	readonly ok: true;
+	readonly value: T;
+}
+/**
+* A single validation issue reported by a {@link StoreValidator}.
+*
+* Compatible with the canonical `ValidationIssue` shape used across the Crust
+* validation platform.
+*/
+interface StoreValidatorIssue {
+	/** Human-readable description of the validation failure. */
+	message: string;
+	/** Dot-path to the invalid field, or empty string for root-level issues. */
+	path: string;
+}
+/**
+* Result returned by a {@link StoreValidator} when validation fails.
+*
+* Carries structured issues for programmatic handling and error rendering.
+*/
+interface StoreValidatorFailure {
+	readonly ok: false;
+	readonly issues: readonly StoreValidatorIssue[];
+}
+/**
+* Discriminated union result from a {@link StoreValidator}.
+*/
+type StoreValidatorResult<T> = StoreValidatorSuccess<T> | StoreValidatorFailure;
+/**
+* A provider-agnostic validator function for full config objects.
+*
+* Accepts a config value and returns a discriminated result indicating
+* success (with a possibly-transformed value) or failure (with structured issues).
+*
+* Store adapters in `@crustjs/validate` produce functions matching this contract
+* from Standard Schema, Zod, or Effect schemas.
+*
+* @typeParam T - The expected config type.
+*
+* @example
+* ```ts
+* const validator: StoreValidator<Config> = (config) => {
+*   if (typeof config.theme !== "string") {
+*     return { ok: false, issues: [{ message: "Expected string", path: "theme" }] };
+*   }
+*   return { ok: true, value: config };
+* };
+* ```
+*/
+type StoreValidator<T> = (value: unknown) => StoreValidatorResult<T> | Promise<StoreValidatorResult<T>>;
+/**
+* Options for {@link createStore}.
+*
+* @typeParam T - The store data shape, inferred from `defaults`.
+*
+* @example
+* ```ts
+* const store = createStore({
+*   dirPath: configDir("my-cli"),
+*   defaults: {
+*     ui: { theme: "light", fontSize: 14 },
+*     verbose: false,
+*     tags: ["default"],
+*   },
+* });
+* ```
+*/
+interface CreateStoreOptions<T extends Record<string, unknown>> {
+	/**
+	* Absolute directory path where the store JSON file is persisted.
+	*
+	* Use a path helper ({@link configDir}, {@link dataDir}, etc.) to resolve
+	* the platform-standard directory from an app name.
+	*/
+	dirPath: string;
+	/**
+	* Store name used as the JSON filename in the directory.
+	*
+	* Defaults to `"config"`, producing `config.json`. Set to a different value
+	* to create multiple stores under the same directory
+	* (e.g. `name: "auth"` → `auth.json`).
+	*
+	* Must not contain path separators or the `.json` extension.
+	*/
+	name?: string;
+	/**
+	* Default values for the store. Defines the data shape and provides
+	* fallback values when no persisted file exists or keys are missing.
+	*
+	* The TypeScript type of `defaults` determines the store's `T` parameter.
+	*/
+	defaults: T;
+	/**
+	* Optional validator function applied to config objects during read, write,
+	* update, and patch operations.
+	*
+	* When provided, validation is **strict by default**: invalid config will
+	* cause a `CrustStoreError` with `VALIDATION` code to be thrown on both
+	* persistence (write/update/patch) and load (read) paths.
+	*
+	* Use store adapters from `@crustjs/validate/standard`, `@crustjs/validate/zod`,
+	* or `@crustjs/validate/effect` to create validators from schema definitions.
+	*
+	* @example
+	* ```ts
+	* import { storeValidator } from "@crustjs/validate/zod";
+	* import { z } from "zod";
+	*
+	* const store = createStore({
+	*   dirPath: configDir("my-cli"),
+	*   defaults: { theme: "light", verbose: false },
+	*   validator: storeValidator(z.object({ theme: z.enum(["light", "dark"]) })),
+	* });
+	* ```
+	*/
+	validator?: StoreValidator<T>;
+	/**
+	* When `true` (the default), persisted keys not present in `defaults`
+	* are dropped on read. Set to `false` to preserve unknown keys.
+	*
+	* @default true
+	*/
+	pruneUnknown?: boolean;
+}
+/**
+* Receives the current effective state and returns an updated state.
+*
+* Used by {@link Store.update} to apply mutations atomically.
+*
+* @example
+* ```ts
+* await store.update((current) => ({
+*   ...current,
+*   ui: { ...current.ui, theme: "dark" },
+* }));
+* ```
+*/
+type StoreUpdater<T> = (current: T) => NoInfer<T>;
+/**
+* A typed async store returned by {@link createStore}.
+*
+* Provides `read`, `write`, `update`, `patch`, and `reset` operations for a
+* typed state object persisted as JSON on the local filesystem.
+*
+* @typeParam T - The store data shape, inferred from `defaults`.
+*
+* @example
+* ```ts
+* const store = createStore({
+*   dirPath: configDir("my-cli"),
+*   defaults: {
+*     ui: { theme: "light", fontSize: 14 },
+*     verbose: false,
+*   },
+* });
+*
+* const state = await store.read();
+* await store.write({ ui: { theme: "dark", fontSize: 14 }, verbose: true });
+* await store.update((s) => ({ ...s, verbose: false }));
+* await store.patch({ ui: { theme: "dark" } });
+* await store.reset();
+* ```
+*/
+interface Store<T> {
+	/**
+	* Reads the persisted state, merging defaults for missing keys.
+	*
+	* Always returns a complete `T` — missing persisted keys are filled
+	* from `defaults`.
+	*
+	* When a validator is configured, the merged config is validated after
+	* defaults are applied. Invalid persisted config fails loudly.
+	*
+	* @returns The effective config value (possibly transformed by the validator).
+	* @throws {CrustStoreError} `PARSE` if persisted JSON is malformed.
+	* @throws {CrustStoreError} `VALIDATION` if the config fails validation.
+	* @throws {CrustStoreError} `IO` on filesystem read failures.
+	*/
+	read(): Promise<T>;
+	/**
+	* Atomically persists the full state object.
+	*
+	* When a validator is configured, the config is validated before persistence.
+	*
+	* @param state - The complete state to persist.
+	* @throws {CrustStoreError} `VALIDATION` if the config fails validation.
+	* @throws {CrustStoreError} `IO` on filesystem write failures.
+	*/
+	write(state: NoInfer<T>): Promise<void>;
+	/**
+	* Reads current effective state, applies the updater, and persists.
+	*
+	* When a validator is configured, the updated config is validated before
+	* persistence. The read step during update does **not** validate separately
+	* to avoid double-validation overhead — the `current` value passed to the
+	* updater may not have been validated (e.g. if the persisted file was
+	* manually edited).
+	*
+	* @param updater - Function receiving current state and returning updated state.
+	* @throws {CrustStoreError} `PARSE` if persisted JSON is malformed.
+	* @throws {CrustStoreError} `VALIDATION` if the updated config fails validation.
+	* @throws {CrustStoreError} `IO` on filesystem failures.
+	*/
+	update(updater: StoreUpdater<T>): Promise<void>;
+	/**
+	* Applies a deep partial update to the current state and persists.
+	*
+	* Only the provided keys are updated; everything else is preserved.
+	* Arrays are replaced wholesale (not merged element-by-element).
+	*
+	* @param partial - A deep-partial subset of the state to merge in.
+	* @throws {CrustStoreError} `VALIDATION` if the merged config fails validation.
+	* @throws {CrustStoreError} `PARSE` if persisted JSON is malformed.
+	* @throws {CrustStoreError} `IO` on filesystem failures.
+	*/
+	patch(partial: DeepPartial<NoInfer<T>>): Promise<void>;
+	/**
+	* Removes the persisted state file, returning the store to
+	* defaults-on-read behavior.
+	*
+	* @throws {CrustStoreError} `IO` on filesystem deletion failures.
+	*/
+	reset(): Promise<void>;
+}
+/**
 * Contextual details attached to a `PATH` error.
 *
 * Returned when the resolved or provided config file path is invalid.
@@ -28,6 +275,18 @@ interface IOErrorDetails {
 	operation: "read" | "write" | "delete";
 }
 /**
+* Contextual details attached to a `VALIDATION` error.
+*
+* Returned when a store validator rejects a config object during
+* read, write, update, or patch operations.
+*/
+interface ValidationErrorDetails {
+	/** The store operation during which validation failed. */
+	operation: "read" | "write" | "update" | "patch";
+	/** Structured validation issues for programmatic handling. */
+	issues: readonly StoreValidatorIssue[];
+}
+/**
 * Maps each {@link StoreErrorCode} to its structured details type.
 *
 * Used internally for conditional constructor parameters and type narrowing.
@@ -36,6 +295,7 @@ interface StoreErrorDetailsMap {
 	PATH: PathErrorDetails;
 	PARSE: ParseErrorDetails;
 	IO: IOErrorDetails;
+	VALIDATION: ValidationErrorDetails;
 }
 /**
 * All possible error codes emitted by `@crustjs/store`.
@@ -43,6 +303,7 @@ interface StoreErrorDetailsMap {
 * - `PATH` — Invalid or unsupported config file path
 * - `PARSE` — Malformed JSON in persisted config file
 * - `IO` — Filesystem read, write, or delete failure
+* - `VALIDATION` — Config object rejected by a store validator
 *
 * @example
 * ```ts
@@ -56,6 +317,11 @@ interface StoreErrorDetailsMap {
 *       case "PARSE":
 *         console.error(`Corrupt config at ${err.details.path}`);
 *         break;
+*       case "VALIDATION":
+*         for (const issue of err.details.issues) {
+*           console.error(`${issue.path}: ${issue.message}`);
+*         }
+*         break;
 *       case "IO":
 *         console.error(`File ${err.details.operation} failed: ${err.message}`);
 *         break;
@@ -68,7 +334,7 @@ type StoreErrorCode = keyof StoreErrorDetailsMap;
 /** Resolves the details type for a given {@link StoreErrorCode}. */
 type StoreErrorDetails<C extends StoreErrorCode> = StoreErrorDetailsMap[C];
 /**
-* A typed error thrown by `@crustjs/store` for path, parse, and IO failures.
+* A typed error thrown by `@crustjs/store` for path, parse, IO, and validation failures.
 *
 * Every `CrustStoreError` carries a {@link StoreErrorCode} that identifies the failure
 * category, along with structured {@link StoreErrorDetails} for programmatic handling
@@ -143,10 +409,11 @@ interface PlatformEnv {
 * Resolves the platform-standard config directory for the given app.
 *
 * Platform conventions:
-* - **Linux**: `$XDG_CONFIG_HOME/<appName>` or `~/.config/<appName>`
-* - **macOS**: `~/Library/Application Support/<appName>`
+* - **Linux / macOS**: `$XDG_CONFIG_HOME/<appName>` or `~/.config/<appName>`
 * - **Windows**: `%APPDATA%/<appName>` or `~/AppData/Roaming/<appName>`
 *
+* macOS uses XDG conventions for consistency with Linux.
+*
 * @param appName - Application name used as directory name. Must be a non-empty
 *   string without path separators.
 * @param env - Optional platform environment override for testing.
@@ -159,241 +426,99 @@ interface PlatformEnv {
 *
 * const dir = configDir("my-cli");
 * // → "/home/user/.config/my-cli" (Linux)
-* // → "/Users/user/Library/Application Support/my-cli" (macOS)
+* // → "/Users/user/.config/my-cli" (macOS)
 * // → "C:\\Users\\user\\AppData\\Roaming\\my-cli" (Windows)
 * ```
 */
 declare function configDir(appName: string, env?: PlatformEnv): string;
-/** Supported type literals for store fields. */
-type ValueType = "string" | "number" | "boolean";
-/**
-* Resolves a type literal to its corresponding TypeScript primitive type.
-*
-* - `"string"` → `string`
-* - `"number"` → `number`
-* - `"boolean"` → `boolean`
-*/
-type ResolvePrimitive<T extends ValueType> = T extends "string" ? string : T extends "number" ? number : T extends "boolean" ? boolean : never;
-/** Shared fields present on every store field definition. */
-interface FieldDefBase {
-	/** Human-readable description for documentation and tooling. */
-	description?: string;
-}
-/** Base for scalar (non-array) fields — `array` must be omitted. */
-interface ScalarFieldBase extends FieldDefBase {
-	/** Must be omitted for scalar fields — set to `true` for array fields. */
-	array?: never;
-}
-/** A scalar string field. */
-interface StringFieldDef extends ScalarFieldBase {
-	type: "string";
-	/** Default string value when the field is not persisted. */
-	default?: string;
-}
-/** A scalar number field. */
-interface NumberFieldDef extends ScalarFieldBase {
-	type: "number";
-	/** Default number value when the field is not persisted. */
-	default?: number;
-}
-/** A scalar boolean field. */
-interface BooleanFieldDef extends ScalarFieldBase {
-	type: "boolean";
-	/** Default boolean value when the field is not persisted. */
-	default?: boolean;
-}
-/** Base for array fields — `array` is required as `true`. */
-interface ArrayFieldBase extends FieldDefBase {
-	/** Collect values into an array. */
-	array: true;
-}
-/** An array of strings field. */
-interface StringArrayFieldDef extends ArrayFieldBase {
-	type: "string";
-	/** Default string array value when the field is not persisted. */
-	default?: readonly string[];
-}
-/** An array of numbers field. */
-interface NumberArrayFieldDef extends ArrayFieldBase {
-	type: "number";
-	/** Default number array value when the field is not persisted. */
-	default?: readonly number[];
-}
-/** An array of booleans field. */
-interface BooleanArrayFieldDef extends ArrayFieldBase {
-	type: "boolean";
-	/** Default boolean array value when the field is not persisted. */
-	default?: readonly boolean[];
-}
 /**
-* Defines a single field in a store's config schema.
+* Resolves the platform-standard data directory for the given app.
 *
-* Discriminated by `type` and `array` for type-safe `default` values.
+* Platform conventions:
+* - **Linux / macOS**: `$XDG_DATA_HOME/<appName>` or `~/.local/share/<appName>`
+* - **Windows**: `%LOCALAPPDATA%/<appName>/Data` or `~/AppData/Local/<appName>/Data`
 *
-* @example
-* ```ts
-* const fields = {
-*   theme: { type: "string", default: "light" },
-*   verbose: { type: "boolean", default: false },
-*   tags: { type: "string", array: true, default: [] },
-*   token: { type: "string" },  // optional — no default
-* } satisfies FieldsDef;
-* ```
-*/
-type FieldDef = StringFieldDef | NumberFieldDef | BooleanFieldDef | StringArrayFieldDef | NumberArrayFieldDef | BooleanArrayFieldDef;
-/** Record mapping field names to their definitions. */
-type FieldsDef = Record<string, FieldDef>;
-/**
-* Infer the resolved type for a single field definition.
+* macOS uses XDG conventions for consistency with Linux.
 *
-* - **array** → `primitive[]` (or `primitive[] | undefined` if no default)
-* - **has default** → `primitive` (guaranteed present)
-* - **no default** → `primitive | undefined` (optional)
-*/
-type InferFieldValue<F extends FieldDef> = F extends {
-	array: true;
-} ? F extends {
-	default: readonly ResolvePrimitive<F["type"]>[];
-} ? ResolvePrimitive<F["type"]>[] : ResolvePrimitive<F["type"]>[] | undefined : F extends {
-	default: ResolvePrimitive<F["type"]>;
-} ? ResolvePrimitive<F["type"]> : ResolvePrimitive<F["type"]> | undefined;
-/**
-* Maps a full {@link FieldsDef} record to the inferred config object type.
+* @param appName - Application name used as directory name. Must be a non-empty
+*   string without path separators.
+* @param env - Optional platform environment override for testing.
+* @returns Absolute path to the app's data directory.
+* @throws {CrustStoreError} `PATH` if `appName` is invalid or platform is unsupported.
 *
 * @example
 * ```ts
-* type Config = InferStoreConfig<{
-*   theme: { type: "string"; default: "light" };
-*   verbose: { type: "boolean" };
-* }>;
-* // → { theme: string; verbose: boolean | undefined }
+* import { dataDir } from "@crustjs/store";
+*
+* const dir = dataDir("my-cli");
+* // → "/home/user/.local/share/my-cli" (Linux)
+* // → "/Users/user/.local/share/my-cli" (macOS)
+* // → "C:\\Users\\user\\AppData\\Local\\my-cli\\Data" (Windows)
 * ```
 */
-type InferStoreConfig<F extends FieldsDef> = { [K in keyof F] : InferFieldValue<F[K]> };
+declare function dataDir(appName: string, env?: PlatformEnv): string;
 /**
-* Options for {@link createStore}.
+* Resolves the platform-standard state directory for the given app.
 *
-* @typeParam F - The field definitions record (inferred via `const` generic).
+* Platform conventions:
+* - **Linux / macOS**: `$XDG_STATE_HOME/<appName>` or `~/.local/state/<appName>`
+* - **Windows**: `%LOCALAPPDATA%/<appName>/State` or `~/AppData/Local/<appName>/State`
 *
-* @example
-* ```ts
-* const store = createStore({
-*   dirPath: configDir("my-cli"),
-*   fields: {
-*     theme: { type: "string", default: "light" },
-*     verbose: { type: "boolean", default: false },
-*   },
-* });
-* ```
-*/
-interface CreateStoreOptions<F extends FieldsDef> {
-	/**
-	* Absolute directory path where the store JSON file is persisted.
-	*
-	* Use the {@link configDir} helper to resolve the platform-standard
-	* config directory from an app name.
-	*/
-	dirPath: string;
-	/**
-	* Store name used as the JSON filename in the directory.
-	*
-	* Defaults to `"config"`, producing `config.json`. Set to a different value
-	* to create multiple stores under the same directory
-	* (e.g. `name: "auth"` → `auth.json`).
-	*
-	* Must not contain path separators or the `.json` extension.
-	*/
-	name?: string;
-	/**
-	* Field definitions that declare the store's config schema.
-	*
-	* Each key maps to a {@link FieldDef} with a `type` discriminant and optional
-	* `default`. Fields without a `default` are optional (`T | undefined`).
-	*/
-	fields: F;
-}
-/**
-* Receives the current effective config and returns an updated config.
+* macOS uses XDG conventions for consistency with Linux.
 *
-* Used by {@link Store.update} to apply partial mutations atomically.
+* @param appName - Application name used as directory name. Must be a non-empty
+*   string without path separators.
+* @param env - Optional platform environment override for testing.
+* @returns Absolute path to the app's state directory.
+* @throws {CrustStoreError} `PATH` if `appName` is invalid or platform is unsupported.
 *
 * @example
 * ```ts
-* await store.update((current) => ({
-*   ...current,
-*   theme: "dark",
-* }));
+* import { stateDir } from "@crustjs/store";
+*
+* const dir = stateDir("my-cli");
+* // → "/home/user/.local/state/my-cli" (Linux)
+* // → "/Users/user/.local/state/my-cli" (macOS)
+* // → "C:\\Users\\user\\AppData\\Local\\my-cli\\State" (Windows)
 * ```
 */
-type StoreUpdater<TConfig> = (current: TConfig) => NoInfer<TConfig>;
+declare function stateDir(appName: string, env?: PlatformEnv): string;
 /**
-* A typed async config store returned by {@link createStore}.
+* Resolves the platform-standard cache directory for the given app.
 *
-* Provides `read`, `write`, `update`, and `reset` operations for a single
-* typed config object persisted as JSON on the local filesystem.
+* Platform conventions:
+* - **Linux / macOS**: `$XDG_CACHE_HOME/<appName>` or `~/.cache/<appName>`
+* - **Windows**: `%LOCALAPPDATA%/<appName>/Cache` or `~/AppData/Local/<appName>/Cache`
 *
-* @typeParam TConfig - The inferred config shape from field definitions.
+* macOS uses XDG conventions for consistency with Linux.
+*
+* @param appName - Application name used as directory name. Must be a non-empty
+*   string without path separators.
+* @param env - Optional platform environment override for testing.
+* @returns Absolute path to the app's cache directory.
+* @throws {CrustStoreError} `PATH` if `appName` is invalid or platform is unsupported.
 *
 * @example
 * ```ts
-* const store = createStore({
-*   dirPath: configDir("my-cli"),
-*   fields: {
-*     theme: { type: "string", default: "light" },
-*   },
-* });
+* import { cacheDir } from "@crustjs/store";
 *
-* const config = await store.read();
-* await store.write({ theme: "dark" });
-* await store.update((c) => ({ ...c, theme: "dark" }));
-* await store.reset();
+* const dir = cacheDir("my-cli");
+* // → "/home/user/.cache/my-cli" (Linux)
+* // → "/Users/user/.cache/my-cli" (macOS)
+* // → "C:\\Users\\user\\AppData\\Local\\my-cli\\Cache" (Windows)
 * ```
 */
-interface Store<TConfig> {
-	/**
-	* Reads the persisted config, applying field defaults for missing keys.
-	*
-	* Always returns a value — fields with defaults are guaranteed present,
-	* fields without defaults may be `undefined`.
-	*
-	* @returns The effective config value.
-	* @throws {CrustStoreError} `PARSE` if persisted JSON is malformed.
-	* @throws {CrustStoreError} `IO` on filesystem read failures.
-	*/
-	read(): Promise<TConfig>;
-	/**
-	* Atomically persists the full config object.
-	*
-	* @param config - The complete config to persist.
-	* @throws {CrustStoreError} `IO` on filesystem write failures.
-	*/
-	write(config: NoInfer<TConfig>): Promise<void>;
-	/**
-	* Reads current effective config, applies the updater, and persists.
-	*
-	* @param updater - Function receiving current config and returning updated config.
-	* @throws {CrustStoreError} `PARSE` if persisted JSON is malformed.
-	* @throws {CrustStoreError} `IO` on filesystem failures.
-	*/
-	update(updater: StoreUpdater<TConfig>): Promise<void>;
-	/**
-	* Removes the persisted config file, returning the store to defaults-on-read behavior.
-	*
-	* @throws {CrustStoreError} `IO` on filesystem deletion failures.
-	*/
-	reset(): Promise<void>;
-}
+declare function cacheDir(appName: string, env?: PlatformEnv): string;
 /**
-* Creates a typed async config store backed by a local JSON file.
+* Creates a typed async store backed by a local JSON file.
 *
 * The store resolves its file path once at creation time from `dirPath` and
-* optional `name`. Field definitions declare the config schema — each field's
-* `type` determines its TypeScript type, and the presence of `default`
-* determines whether the field is guaranteed or optional (`T | undefined`).
+* optional `name`. The `defaults` object declares the data shape — its
+* TypeScript type determines the store's type parameter `T`.
 *
-* @typeParam F - Field definitions record (inferred via `const` generic).
+* @typeParam T - The store data shape (inferred from `defaults`).
 * @param options - Store configuration options.
-* @returns A {@link Store} instance with `read`, `write`, `update`, and `reset` methods.
+* @returns A {@link Store} instance with `read`, `write`, `update`, `patch`, and `reset` methods.
 * @throws {CrustStoreError} `PATH` if `dirPath` or `name` is invalid.
 *
 * @example
@@ -402,20 +527,20 @@ interface Store<TConfig> {
 *
 * const store = createStore({
 *   dirPath: configDir("my-cli"),
-*   fields: {
-*     theme: { type: "string", default: "light" },
-*     verbose: { type: "boolean", default: false },
-*     token: { type: "string" },
+*   defaults: {
+*     ui: { theme: "light", fontSize: 14 },
+*     verbose: false,
 *   },
 * });
 *
-* const config = await store.read();
-* // → { theme: "light", verbose: false } (defaults when no persisted file)
+* const state = await store.read();
+* // → { ui: { theme: "light", fontSize: 14 }, verbose: false }
 *
-* await store.write({ theme: "dark", verbose: true, token: "abc" });
-* await store.update((c) => ({ ...c, theme: "light" }));
+* await store.write({ ui: { theme: "dark", fontSize: 14 }, verbose: true });
+* await store.update((s) => ({ ...s, verbose: false }));
+* await store.patch({ ui: { theme: "dark" } });
 * await store.reset();
 * ```
 */
-declare function createStore<const F extends FieldsDef>(options: CreateStoreOptions<F>): Store<InferStoreConfig<F>>;
-export { createStore, configDir, ValueType, StoreUpdater, StoreErrorCode, Store, PlatformEnv, InferStoreConfig, FieldsDef, FieldDef, CrustStoreError, CreateStoreOptions };
+declare function createStore<const T extends Record<string, unknown>>(options: CreateStoreOptions<T>): Store<T>;
+export { stateDir, dataDir, createStore, configDir, cacheDir, ValidationErrorDetails, StoreValidatorSuccess, StoreValidatorResult, StoreValidatorIssue, StoreValidatorFailure, StoreValidator, StoreUpdater, StoreErrorCode, Store, PlatformEnv, CrustStoreError, CreateStoreOptions };