@techzyapp/ui-library 1.0.31 → 1.0.33

package/dist/components/ErrorState/errorMessage.d.cts

@@ -1,3 +1,11 @@
+/**
+ * Internal (not in the barrel): a development build? Read per call (not at import) so a test can switch modes.
+ * Written as the bare `process.env.NODE_ENV` member expression on purpose — that's the exact text bundlers
+ * replace (Vite / esbuild / webpack `define`). A `typeof process` guard would NOT be replaced and is `false`
+ * in every browser, hiding dev-only UI in development too; with no bundler define and no `process`, the
+ * `ReferenceError` lands in the `catch` → production.
+ */
+export declare function isDev(): boolean;
 /**
  * Pull a human-readable message out of whatever was thrown / returned — the shapes admin apps actually see:
  *
@@ -19,8 +27,32 @@ export declare function getErrorDetails(error: unknown): string | undefined;
  */
 export declare function getErrorTraceId(error: unknown): string | undefined;
 /**
- * Per-field validation messages of a `400` — `{ field: 'message' }`. Read from `error.fieldErrors` (an app
- * `ApiError`) or an axios-style `error.response.data.errors` (ASP.NET sends a string **or** an array of
- * strings per field — the first string wins). `undefined` when there are none.
+ * Per-field validation messages of a `400` — `{ field: 'message' }`. Tolerant of the shapes apps actually have:
+ *
+ * - `error.fieldErrors` — an object (`{ field: message }`), **a method returning one** (an app `ApiError`
+ *   exposing `fieldErrors()`), or an array of `{ field, message }`;
+ * - `error.details` — an array of `{ field, message }` (a common response-envelope shape);
+ * - axios-style `error.response.data.errors` — an object (ASP.NET: a string **or** an array of strings per
+ *   field; the first string wins) or an array of `{ field, message }`.
+ *
+ * In a list the first message per field wins. `undefined` when there are none.
  */
 export declare function getErrorFieldErrors(error: unknown): Record<string, string> | undefined;
+/**
+ * A field key as UI text: the last segment of a dotted path, split on camelCase / snake_case / kebab-case and
+ * Title Cased — `newPassword` / `NewPassword` / `new_password` → `"New Password"`, `address.zipCode` → `"Zip
+ * Code"`.
+ */
+export declare function humanizeField(key: string): string;
+/** The HTTP status on an error — `error.status` or axios-style `error.response.status` — when it's a number. */
+export declare function getErrorStatus(error: unknown): number | undefined;
+/**
+ * Whether the error came back **from the server** (a `traceId` or a numeric status other than `0`) — such a
+ * message is written for people. A render crash's message ("Cannot read properties of undefined") isn't.
+ */
+export declare function isServerError(error: unknown): boolean;
+/**
+ * Whether the request **never got a response** — only when the error says so explicitly: a `status` of `0`, or
+ * a network error code (`'network_error'`, or axios' `'ERR_NETWORK'`). No guessing from messages.
+ */
+export declare function isNetworkError(error: unknown): boolean;

package/dist/components/ErrorState/errorMessage.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Internal (not in the barrel): a development build? Read per call (not at import) so a test can switch modes.
+ * Written as the bare `process.env.NODE_ENV` member expression on purpose — that's the exact text bundlers
+ * replace (Vite / esbuild / webpack `define`). A `typeof process` guard would NOT be replaced and is `false`
+ * in every browser, hiding dev-only UI in development too; with no bundler define and no `process`, the
+ * `ReferenceError` lands in the `catch` → production.
+ */
+export declare function isDev(): boolean;
 /**
  * Pull a human-readable message out of whatever was thrown / returned — the shapes admin apps actually see:
  *
@@ -19,8 +27,32 @@ export declare function getErrorDetails(error: unknown): string | undefined;
  */
 export declare function getErrorTraceId(error: unknown): string | undefined;
 /**
- * Per-field validation messages of a `400` — `{ field: 'message' }`. Read from `error.fieldErrors` (an app
- * `ApiError`) or an axios-style `error.response.data.errors` (ASP.NET sends a string **or** an array of
- * strings per field — the first string wins). `undefined` when there are none.
+ * Per-field validation messages of a `400` — `{ field: 'message' }`. Tolerant of the shapes apps actually have:
+ *
+ * - `error.fieldErrors` — an object (`{ field: message }`), **a method returning one** (an app `ApiError`
+ *   exposing `fieldErrors()`), or an array of `{ field, message }`;
+ * - `error.details` — an array of `{ field, message }` (a common response-envelope shape);
+ * - axios-style `error.response.data.errors` — an object (ASP.NET: a string **or** an array of strings per
+ *   field; the first string wins) or an array of `{ field, message }`.
+ *
+ * In a list the first message per field wins. `undefined` when there are none.
  */
 export declare function getErrorFieldErrors(error: unknown): Record<string, string> | undefined;
+/**
+ * A field key as UI text: the last segment of a dotted path, split on camelCase / snake_case / kebab-case and
+ * Title Cased — `newPassword` / `NewPassword` / `new_password` → `"New Password"`, `address.zipCode` → `"Zip
+ * Code"`.
+ */
+export declare function humanizeField(key: string): string;
+/** The HTTP status on an error — `error.status` or axios-style `error.response.status` — when it's a number. */
+export declare function getErrorStatus(error: unknown): number | undefined;
+/**
+ * Whether the error came back **from the server** (a `traceId` or a numeric status other than `0`) — such a
+ * message is written for people. A render crash's message ("Cannot read properties of undefined") isn't.
+ */
+export declare function isServerError(error: unknown): boolean;
+/**
+ * Whether the request **never got a response** — only when the error says so explicitly: a `status` of `0`, or
+ * a network error code (`'network_error'`, or axios' `'ERR_NETWORK'`). No guessing from messages.
+ */
+export declare function isNetworkError(error: unknown): boolean;

package/dist/components/ErrorState/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../ErrorBoundary-gRGxeuM1.cjs"),e=require("../../QueryError-DP22IUnp.cjs");exports.ErrorBoundary=r.ErrorBoundary;exports.ErrorState=r.ErrorState;exports.default=r.ErrorState;exports.getErrorDetails=r.getErrorDetails;exports.getErrorFieldErrors=r.getErrorFieldErrors;exports.getErrorMessage=r.getErrorMessage;exports.getErrorTraceId=r.getErrorTraceId;exports.QueryError=e.QueryError;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../ErrorState-BXMjBWav.cjs"),o=require("../../ErrorBoundary-8iu-mR5Y.cjs"),r=require("../../errorMessage-C7N4KvUS.cjs");exports.ErrorState=e.ErrorState;exports.default=e.ErrorState;exports.ErrorBoundary=o.ErrorBoundary;exports.QueryError=o.QueryError;exports.getErrorDetails=r.getErrorDetails;exports.getErrorFieldErrors=r.getErrorFieldErrors;exports.getErrorMessage=r.getErrorMessage;exports.getErrorStatus=r.getErrorStatus;exports.getErrorTraceId=r.getErrorTraceId;exports.humanizeField=r.humanizeField;exports.isNetworkError=r.isNetworkError;exports.isServerError=r.isServerError;
 //# sourceMappingURL=index.cjs.map

package/dist/components/ErrorState/index.d.cts

@@ -1,7 +1,7 @@
 export { ErrorState, ErrorState as default } from './ErrorState';
-export type { ErrorStateProps } from './ErrorState';
+export type { ErrorStateProps, ErrorStateVariant } from './ErrorState';
 export { QueryError } from './QueryError';
 export type { QueryErrorProps } from './QueryError';
 export { ErrorBoundary } from './ErrorBoundary';
 export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, } from './errorMessage';
+export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, getErrorStatus, humanizeField, isNetworkError, isServerError, } from './errorMessage';

package/dist/components/ErrorState/index.d.ts

@@ -1,7 +1,7 @@
 export { ErrorState, ErrorState as default } from './ErrorState';
-export type { ErrorStateProps } from './ErrorState';
+export type { ErrorStateProps, ErrorStateVariant } from './ErrorState';
 export { QueryError } from './QueryError';
 export type { QueryErrorProps } from './QueryError';
 export { ErrorBoundary } from './ErrorBoundary';
 export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, } from './errorMessage';
+export { getErrorMessage, getErrorDetails, getErrorTraceId, getErrorFieldErrors, getErrorStatus, humanizeField, isNetworkError, isServerError, } from './errorMessage';

package/dist/components/ErrorState/index.js

@@ -1,13 +1,18 @@
-import { E as e, a as o, a as s, g as t, b as E, c as g, d } from "../../ErrorBoundary-B-37hGZW.js";
-import { Q as l } from "../../QueryError-Dtspj9l4.js";
+import { E as a, E as o } from "../../ErrorState-DKhZ4aJh.js";
+import { E as t, Q as E } from "../../ErrorBoundary-BSJL381Y.js";
+import { g as i, a as d, b as u, c as f, d as l, h as m, i as p, e as x } from "../../errorMessage-C83fB2h5.js";
 export {
-  e as ErrorBoundary,
-  o as ErrorState,
-  l as QueryError,
-  s as default,
-  t as getErrorDetails,
-  E as getErrorFieldErrors,
-  g as getErrorMessage,
-  d as getErrorTraceId
+  t as ErrorBoundary,
+  a as ErrorState,
+  E as QueryError,
+  o as default,
+  i as getErrorDetails,
+  d as getErrorFieldErrors,
+  u as getErrorMessage,
+  f as getErrorStatus,
+  l as getErrorTraceId,
+  m as humanizeField,
+  p as isNetworkError,
+  x as isServerError
 };
 //# sourceMappingURL=index.js.map

package/dist/components/ErrorState/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/components/FileCard/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FileCard-BYNJVmp0.cjs");exports.FileCard=e.FileCard;exports.default=e.FileCard;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FileCard-B3dfdTVN.cjs");exports.FileCard=e.FileCard;exports.default=e.FileCard;
 //# sourceMappingURL=index.cjs.map

package/dist/components/FileCard/index.js

@@ -1,4 +1,4 @@
-import { F as r, F } from "../../FileCard-BNfUAgsF.js";
+import { F as r, F } from "../../FileCard-R_sB8Qbx.js";
 export {
   r as FileCard,
   F as default

package/dist/components/FileUploader/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FileUploader-DdICa5UC.cjs");exports.FileUploader=e.FileUploader;exports.default=e.FileUploader;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FileUploader-4UMy0urx.cjs");exports.FileUploader=e.FileUploader;exports.default=e.FileUploader;
 //# sourceMappingURL=index.cjs.map

package/dist/components/FileUploader/index.js

@@ -1,4 +1,4 @@
-import { F as l, F as o } from "../../FileUploader-TOWwDOSS.js";
+import { F as l, F as o } from "../../FileUploader-B55atuxq.js";
 export {
   l as FileUploader,
   o as default

package/dist/components/Flag/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Flag-DXPQ2t8z.cjs");exports.Flag=e.Flag;exports.default=e.Flag;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Flag-CFvJHC0u.cjs");exports.Flag=e.Flag;exports.default=e.Flag;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Flag/index.js

@@ -1,4 +1,4 @@
-import { F as e, F as f } from "../../Flag-DDR6OANA.js";
+import { F as e, F as f } from "../../Flag-D7fmMqqy.js";
 export {
   e as Flag,
   f as default

package/dist/components/FullscreenToggle/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FullscreenToggle-BKo1lDSE.cjs");exports.FullscreenToggle=e.FullscreenToggle;exports.default=e.FullscreenToggle;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../FullscreenToggle-D7tUPCNI.cjs");exports.FullscreenToggle=e.FullscreenToggle;exports.default=e.FullscreenToggle;
 //# sourceMappingURL=index.cjs.map

package/dist/components/FullscreenToggle/index.js

@@ -1,4 +1,4 @@
-import { F as a, F as o } from "../../FullscreenToggle-DmH1541W.js";
+import { F as a, F as o } from "../../FullscreenToggle-CXmPqxJv.js";
 export {
   a as FullscreenToggle,
   o as default

package/dist/components/IconButton/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../IconButton-CvIXSFsr.cjs");exports.IconButton=t.IconButton;exports.default=t.IconButton;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const t=require("../../IconButton-BVrO9TBP.cjs");exports.IconButton=t.IconButton;exports.default=t.IconButton;
 //# sourceMappingURL=index.cjs.map

package/dist/components/IconButton/index.js

@@ -1,4 +1,4 @@
-import { I as a, I } from "../../IconButton-CL_6iMQh.js";
+import { I as a, I } from "../../IconButton-sC_E_TXd.js";
 export {
   a as IconButton,
   I as default

package/dist/components/List/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../List-ah2PNWeY.cjs");exports.List=e.List;exports.ListItem=e.ListItem;exports.default=e.List;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../List-DOsh6w-d.cjs"),t=require("../../ListItem-CUeIBhOF.cjs");exports.List=e.List;exports.default=e.List;exports.ListItem=t.ListItem;
 //# sourceMappingURL=index.cjs.map

package/dist/components/List/index.js

@@ -1,7 +1,8 @@
-import { L as t, a as L, L as e } from "../../List-BLPB3-B8.js";
+import { L, L as a } from "../../List-CXHlAI5w.js";
+import { L as o } from "../../ListItem-ehFB7TUW.js";
 export {
-  t as List,
-  L as ListItem,
-  e as default
+  L as List,
+  o as ListItem,
+  a as default
 };
 //# sourceMappingURL=index.js.map

package/dist/components/List/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/components/Loader/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Loader-CI1j71X8.cjs");exports.Loader=e.Loader;exports.default=e.Loader;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../../Loader-DNCEHqZb.cjs");exports.Loader=e.Loader;exports.default=e.Loader;
 //# sourceMappingURL=index.cjs.map

package/dist/components/Loader/index.js

@@ -1,4 +1,4 @@
-import { L as o, L as r } from "../../Loader-Czzb450N.js";
+import { L as o, L as r } from "../../Loader-ChrouvaR.js";
 export {
   o as Loader,
   r as default

package/dist/components/LocationPicker/LocationPicker.d.cts

@@ -0,0 +1,87 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+export type LocationPickerSize = 'sm' | 'md' | 'lg';
+/** A point on the map — the field's value (`null` while no pin is placed). */
+export interface LocationValue {
+    /** Latitude (განედი), `-90`…`90`. */
+    lat: number;
+    /** Longitude (გრძედი), `-180`…`180`. */
+    lng: number;
+}
+/** The map view — where it's centred and how far it's zoomed. */
+export interface LocationView {
+    center: LocationValue;
+    zoom: number;
+}
+/** Tbilisi — the default view when there's no pin. */
+export declare const TBILISI: LocationValue;
+export interface LocationPickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'color'> {
+    /** Controlled value — `{ lat, lng }`, or `null` for no pin. */
+    value?: LocationValue | null;
+    /** Initial value for uncontrolled use. */
+    defaultValue?: LocationValue | null;
+    /** Fires with the new point (map click, pin drag, typed coordinates, "my location") or `null` when cleared. */
+    onChange?: (value: LocationValue | null) => void;
+    /** Form field name — binds the value to a surrounding `<Form>` (value = `{ lat, lng } | null`). */
+    name?: string;
+    /** Label above the map. */
+    label?: ReactNode;
+    /** Helper / validation text under the fields. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Error state — red frame + helper. */
+    error?: boolean;
+    /** Shows a required asterisk after the label. */
+    required?: boolean;
+    /** Read-only: the map can be looked at but not pinned, the fields are disabled. */
+    disabled?: boolean;
+    /** Size of the latitude / longitude fields. Defaults to `md`. */
+    size?: LocationPickerSize;
+    /** Google Maps API key. Defaults to `config.maps.apiKey`. */
+    apiKey?: string;
+    /** Google Map ID (cloud styling + advanced marker). Defaults to `config.maps.mapId`. */
+    mapId?: string;
+    /** Controlled map centre. Defaults to the pin, else Tbilisi. */
+    center?: LocationValue;
+    /** Initial map centre (uncontrolled). Defaults to the value's pin, else Tbilisi. */
+    defaultCenter?: LocationValue;
+    /** Fires after the map is panned (once it settles) with the new centre. */
+    onCenterChange?: (center: LocationValue) => void;
+    /** Controlled zoom level. */
+    zoom?: number;
+    /** Initial zoom level (uncontrolled). Defaults to `12` (a city). */
+    defaultZoom?: number;
+    /** Fires with the new zoom level. */
+    onZoomChange?: (zoom: number) => void;
+    /** Height of the map in px. Defaults to `300`. */
+    mapHeight?: number;
+    /** Show the "my location" button (browser geolocation). Defaults to `true`. */
+    locateButton?: boolean;
+    /** Decimal places the coordinates are kept to. Defaults to `6` (~0.1 m). */
+    precision?: number;
+    /**
+     * Show an **address / place search** above the map (Google **Places API (New)** — enable it for the key).
+     * Picking a result drops the pin there and moves the map to it. Defaults to `false`.
+     */
+    search?: boolean;
+    /** Restrict the search to these regions (ISO 3166-1 alpha-2 codes, e.g. `['ge']`). Default: worldwide. */
+    searchRegions?: string[];
+    /**
+     * Look up the **address of the pin** (Google **Geocoding API** — enable it for the key) and show it under the
+     * map; reported through `onAddressChange` / `addressName`. A place picked from the search brings its own
+     * address (no extra lookup). Defaults to `false`.
+     */
+    geocode?: boolean;
+    /** Fires with the pin's address after a user change (`null` when there's no pin / no address). */
+    onAddressChange?: (address: string | null) => void;
+    /** Inside a `<Form>`: the field the pin's address is written to (e.g. `"address"`), alongside the coordinates. */
+    addressName?: string;
+}
+/**
+ * A location picker: a **Google Map** you click to drop a pin (drag it to adjust), with **latitude / longitude**
+ * fields below that stay in sync both ways — pasting `"41.7151, 44.8271"` into either fills both. The value is
+ * `{ lat, lng } | null`; binds to a `<Form>` by `name`. The map shows **Tbilisi** by default, doesn't hijack the
+ * page scroll (Ctrl / ⌘ + scroll zooms), offers **my location**, **centre on pin** and **remove pin**, and a
+ * copyable coordinate pill. Its **view is controllable** (`center` / `zoom` + `onCenterChange` / `onZoomChange`,
+ * or `defaultCenter` / `defaultZoom`). The Maps JavaScript API is loaded on demand with the `apiKey` prop or
+ * `config.maps.apiKey`; without a key (or if loading fails) the fields keep working and the map says why.
+ */
+export declare const LocationPicker: import("react").ForwardRefExoticComponent<LocationPickerProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/LocationPicker/LocationPicker.d.ts

@@ -0,0 +1,87 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+export type LocationPickerSize = 'sm' | 'md' | 'lg';
+/** A point on the map — the field's value (`null` while no pin is placed). */
+export interface LocationValue {
+    /** Latitude (განედი), `-90`…`90`. */
+    lat: number;
+    /** Longitude (გრძედი), `-180`…`180`. */
+    lng: number;
+}
+/** The map view — where it's centred and how far it's zoomed. */
+export interface LocationView {
+    center: LocationValue;
+    zoom: number;
+}
+/** Tbilisi — the default view when there's no pin. */
+export declare const TBILISI: LocationValue;
+export interface LocationPickerProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'color'> {
+    /** Controlled value — `{ lat, lng }`, or `null` for no pin. */
+    value?: LocationValue | null;
+    /** Initial value for uncontrolled use. */
+    defaultValue?: LocationValue | null;
+    /** Fires with the new point (map click, pin drag, typed coordinates, "my location") or `null` when cleared. */
+    onChange?: (value: LocationValue | null) => void;
+    /** Form field name — binds the value to a surrounding `<Form>` (value = `{ lat, lng } | null`). */
+    name?: string;
+    /** Label above the map. */
+    label?: ReactNode;
+    /** Helper / validation text under the fields. Adopts the error color while `error`. */
+    helperText?: ReactNode;
+    /** Error state — red frame + helper. */
+    error?: boolean;
+    /** Shows a required asterisk after the label. */
+    required?: boolean;
+    /** Read-only: the map can be looked at but not pinned, the fields are disabled. */
+    disabled?: boolean;
+    /** Size of the latitude / longitude fields. Defaults to `md`. */
+    size?: LocationPickerSize;
+    /** Google Maps API key. Defaults to `config.maps.apiKey`. */
+    apiKey?: string;
+    /** Google Map ID (cloud styling + advanced marker). Defaults to `config.maps.mapId`. */
+    mapId?: string;
+    /** Controlled map centre. Defaults to the pin, else Tbilisi. */
+    center?: LocationValue;
+    /** Initial map centre (uncontrolled). Defaults to the value's pin, else Tbilisi. */
+    defaultCenter?: LocationValue;
+    /** Fires after the map is panned (once it settles) with the new centre. */
+    onCenterChange?: (center: LocationValue) => void;
+    /** Controlled zoom level. */
+    zoom?: number;
+    /** Initial zoom level (uncontrolled). Defaults to `12` (a city). */
+    defaultZoom?: number;
+    /** Fires with the new zoom level. */
+    onZoomChange?: (zoom: number) => void;
+    /** Height of the map in px. Defaults to `300`. */
+    mapHeight?: number;
+    /** Show the "my location" button (browser geolocation). Defaults to `true`. */
+    locateButton?: boolean;
+    /** Decimal places the coordinates are kept to. Defaults to `6` (~0.1 m). */
+    precision?: number;
+    /**
+     * Show an **address / place search** above the map (Google **Places API (New)** — enable it for the key).
+     * Picking a result drops the pin there and moves the map to it. Defaults to `false`.
+     */
+    search?: boolean;
+    /** Restrict the search to these regions (ISO 3166-1 alpha-2 codes, e.g. `['ge']`). Default: worldwide. */
+    searchRegions?: string[];
+    /**
+     * Look up the **address of the pin** (Google **Geocoding API** — enable it for the key) and show it under the
+     * map; reported through `onAddressChange` / `addressName`. A place picked from the search brings its own
+     * address (no extra lookup). Defaults to `false`.
+     */
+    geocode?: boolean;
+    /** Fires with the pin's address after a user change (`null` when there's no pin / no address). */
+    onAddressChange?: (address: string | null) => void;
+    /** Inside a `<Form>`: the field the pin's address is written to (e.g. `"address"`), alongside the coordinates. */
+    addressName?: string;
+}
+/**
+ * A location picker: a **Google Map** you click to drop a pin (drag it to adjust), with **latitude / longitude**
+ * fields below that stay in sync both ways — pasting `"41.7151, 44.8271"` into either fills both. The value is
+ * `{ lat, lng } | null`; binds to a `<Form>` by `name`. The map shows **Tbilisi** by default, doesn't hijack the
+ * page scroll (Ctrl / ⌘ + scroll zooms), offers **my location**, **centre on pin** and **remove pin**, and a
+ * copyable coordinate pill. Its **view is controllable** (`center` / `zoom` + `onCenterChange` / `onZoomChange`,
+ * or `defaultCenter` / `defaultZoom`). The Maps JavaScript API is loaded on demand with the `apiKey` prop or
+ * `config.maps.apiKey`; without a key (or if loading fails) the fields keep working and the map says why.
+ */
+export declare const LocationPicker: import("react").ForwardRefExoticComponent<LocationPickerProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/LocationPicker/PlaceSearch.d.cts

@@ -0,0 +1,20 @@
+import type { GoogleMapsApi, LatLngLiteral, PlaceResult } from './googleMaps';
+export interface PlaceSearchProps {
+    api: GoogleMapsApi;
+    /** UI language for the suggestions. */
+    language?: string;
+    /** Bias results towards this point (the map's centre). */
+    bias?: () => LatLngLiteral | undefined;
+    /** Restrict results to these regions (ISO 3166-1 alpha-2, e.g. `['ge']`). */
+    regions?: string[];
+    size: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    /** Fires with the picked place's point + address. */
+    onPick: (place: PlaceResult) => void;
+}
+/**
+ * The address / place search above the map — our own field + listbox (so it looks and behaves like the rest of
+ * the library), fed by Google's Places API (New): debounced suggestions biased to the map centre, keyboard
+ * navigation (↑ ↓ Enter Escape), and a pick that resolves the place to a point. Internal to `LocationPicker`.
+ */
+export declare function PlaceSearch({ api, language, bias, regions, size, disabled, onPick, }: PlaceSearchProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/LocationPicker/PlaceSearch.d.ts

@@ -0,0 +1,20 @@
+import type { GoogleMapsApi, LatLngLiteral, PlaceResult } from './googleMaps';
+export interface PlaceSearchProps {
+    api: GoogleMapsApi;
+    /** UI language for the suggestions. */
+    language?: string;
+    /** Bias results towards this point (the map's centre). */
+    bias?: () => LatLngLiteral | undefined;
+    /** Restrict results to these regions (ISO 3166-1 alpha-2, e.g. `['ge']`). */
+    regions?: string[];
+    size: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    /** Fires with the picked place's point + address. */
+    onPick: (place: PlaceResult) => void;
+}
+/**
+ * The address / place search above the map — our own field + listbox (so it looks and behaves like the rest of
+ * the library), fed by Google's Places API (New): debounced suggestions biased to the map centre, keyboard
+ * navigation (↑ ↓ Enter Escape), and a pick that resolves the place to a point. Internal to `LocationPicker`.
+ */
+export declare function PlaceSearch({ api, language, bias, regions, size, disabled, onPick, }: PlaceSearchProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/LocationPicker/googleMaps.d.cts

@@ -0,0 +1,89 @@
+export interface LatLngLiteral {
+    lat: number;
+    lng: number;
+}
+export interface MapsLatLng {
+    lat(): number;
+    lng(): number;
+}
+export interface MapsEventListener {
+    remove(): void;
+}
+export interface MapsMouseEvent {
+    latLng: MapsLatLng | null;
+}
+export interface MapsMap {
+    setCenter(center: LatLngLiteral): void;
+    panTo(center: LatLngLiteral): void;
+    setZoom(zoom: number): void;
+    getZoom(): number | undefined;
+    getCenter(): MapsLatLng | undefined;
+    setOptions(options: Record<string, unknown>): void;
+    addListener(event: string, handler: (event: MapsMouseEvent) => void): MapsEventListener;
+}
+/** A custom pin image: an SVG string, its rendered size and the anchor (the tip) in that size's px. */
+export interface PinIcon {
+    svg: string;
+    width: number;
+    height: number;
+    anchorX: number;
+    anchorY: number;
+}
+/** The pin — a classic `Marker` or an `AdvancedMarkerElement`, adapted to one shape. */
+export interface MapsPin {
+    setPosition(position: LatLngLiteral | null): void;
+    /** Swap the pin image (e.g. a new accent color). */
+    setIcon(icon: PinIcon): void;
+    setDraggable(draggable: boolean): void;
+    onDragEnd(handler: (position: LatLngLiteral) => void): MapsEventListener;
+    remove(): void;
+}
+/** One autocomplete suggestion — a place's main text (name / street) and its secondary text (city, country). */
+export interface PlaceSuggestion {
+    id: string;
+    primary: string;
+    secondary?: string;
+}
+/** A picked place, resolved to a point (+ its formatted address when Google has one). */
+export interface PlaceResult {
+    location: LatLngLiteral;
+    address?: string;
+}
+/**
+ * An address / place search session (Places API (New)). Suggestions share one session token until a place is
+ * resolved — that's how Google bills a search as one session, not per keystroke.
+ */
+export interface PlacesSession {
+    suggest(input: string, options: {
+        language?: string;
+        bias?: LatLngLiteral;
+        regions?: string[];
+    }): Promise<PlaceSuggestion[]>;
+    /** Resolve a suggestion to its point + address (ends the session). */
+    resolve(id: string): Promise<PlaceResult | null>;
+}
+export interface GoogleMapsApi {
+    /** Google's `ColorScheme` value for a mode (the Map ID light / dark option; set when a map is created). */
+    colorScheme(mode: 'light' | 'dark'): unknown;
+    /** Start an address / place search session (loads the `places` library on first use). */
+    createPlacesSession(): PlacesSession;
+    /** The formatted address at a point (Geocoding API; loads `geocoding` on first use), or `null`. */
+    reverseGeocode(position: LatLngLiteral, language?: string): Promise<string | null>;
+    /** Create a map in `element`. */
+    createMap(element: HTMLElement, options: Record<string, unknown>): MapsMap;
+    /** Create the pin on `map` (an `AdvancedMarkerElement` when the map has a `mapId`). */
+    createPin(map: MapsMap, options: {
+        position: LatLngLiteral | null;
+        advanced: boolean;
+        icon?: PinIcon;
+    }): MapsPin;
+}
+/** Call `listener` when Google rejects the API key (immediately if it already has). Returns an unsubscribe. */
+export declare function onMapsAuthFailure(listener: () => void): () => void;
+/**
+ * Load the Maps JavaScript API (once per page) and return the small adapter `LocationPicker` uses. Reuses an
+ * already-present `google.maps` (an app that loads Maps itself, or tests); a failed load can be retried.
+ */
+export declare function loadGoogleMaps(apiKey: string, language?: string): Promise<GoogleMapsApi>;
+/** Test hook: forget the cached loader and any recorded key rejection. */
+export declare function resetGoogleMapsLoader(): void;