import type { JsonValue } from "../../core/types.js";
import type { LiveMapFeedListener, LiveMapSetManyValues, LivePath } from "../../types/livemap.types.js";
import { type OrderedProjectedObject, type OrderedProjectedValue } from "../../core/ordered-projected-value.js";
export type LiveMapPathKind = "array" | "object";
/**
 * Validate a public LiveMap path.
 *
 * LiveMap paths are arrays of string keys and non-negative integer array
 * indexes. The returned path is a normalized copy, so callers do not retain a
 * mutable user-supplied path reference.
 */
export declare function must_live_path(path: unknown): LivePath;
/** Validate a value as JSON before it enters LiveMap mutation surfaces. */
export declare function must_json_value(value: unknown, path: LivePath): JsonValue;
/** Admit one public JavaScript value into LiveMap's immutable semantic carrier. */
export declare function must_ordered_projected_value(value: unknown, path: LivePath): OrderedProjectedValue;
/**
 * Validate `setMany` input as a plain JSON object.
 *
 * `setMany` is intentionally object-only: each own enumerable key becomes a
 * child write under `path`, and each child value must be valid JSON.
 */
export declare function must_set_many_values(value: unknown, path: LivePath): LiveMapSetManyValues;
/** Admit the ordered object bag accepted by `setMany` without materializing it. */
export declare function must_ordered_projected_object(value: unknown, path: LivePath): OrderedProjectedObject;
/** Validate feed listener input from public subscription surfaces. */
export declare function must_feed_listener(listener: unknown): LiveMapFeedListener;
/** Validate a user-supplied object key for object helper APIs. */
export declare function must_object_key(key: unknown, path: LivePath): string;
/** Build the standard object/array kind error for path-scoped helpers. */
export declare function path_kind_error(path: LivePath, kind: LiveMapPathKind): Error;
/** Build the standard array-index resolution error. */
export declare function array_index_error(path: LivePath, index: number): Error;
/** True for plain object records accepted by LiveMap JSON object guards. */
export declare function is_plain_json_object_value(value: unknown): value is Readonly<Record<string, unknown>>;
//# sourceMappingURL=livemap.guard.d.ts.map