@konce-pt/react 0.11.2 → 0.14.0

package/dist/map/llms.txt

@@ -9,46 +9,53 @@ interface.
 Import: `import { KptMap, createLeafletEngine } from '@konce-pt/react/map';`
 
 ## Requirements
-1. The **optional** `leaflet` dependency — the library does not install it: `pnpm add leaflet`
+1. The **optional** `leaflet` dependency - the library does not install it: `pnpm add leaflet`
 2. Its stylesheet: `import 'leaflet/dist/leaflet.css';`
 3. An engine factory on the `engine` prop: `engine={() => createLeafletEngine()}`
 
 Leaflet is loaded with a dynamic `import()`, so an app that never renders a map does not download
-it. Without the package the component still imports and compiles — only rendering the map ends with
+it. Without the package the component still imports and compiles - only rendering the map ends with
 a readable message.
 
 ## Props
-- `locations`: `readonly KptMapLocation<T>[]` — **required**
-- `categories`: `readonly KptMapCategory[]` — **required**
-- `engine`: `KptMapEngineFactory` — **required**; a factory, not an instance, because every map
+- `locations`: `readonly KptMapLocation<T>[]` - **required**
+- `categories`: `readonly KptMapCategory[]` - **required**
+- `engine`: `KptMapEngineFactory` - **required**; a factory, not an instance, because every map
   needs its own object. Read once, at mount.
-- `country`: string = `'PL'` — the initial view preset; an unknown code falls back to Poland
-- `view`, `bounds` — an explicit view or extent; they override `country`
-- `restrictToCountry`: boolean — blocks panning outside the country's bounds
+- `country`: string = `'PL'` - the initial view preset; an unknown code falls back to Poland
+- `view`, `bounds` - an explicit view or extent; they override `country`
+- `restrictToCountry`: boolean - blocks panning outside the country's bounds
 - `cluster`: boolean = true, `clusterOptions`, `clusterColorBy`: `'dominant' | 'none'`
 - `legend`, `legendCounts`: boolean = true
-- `hiddenCategories` / `defaultHiddenCategories` / `onHiddenCategoriesChange` — the ids hidden in
+- `hiddenCategories` / `defaultHiddenCategories` / `onHiddenCategoriesChange` - the ids hidden in
   the legend, controlled or uncontrolled
 - `showUserLocation`, `followUser`: boolean; `geolocation`: `KptMapGeolocationPort | null`
-- `allowCreate`: boolean — the "Add location" menu under the right mouse button
+- `allowCreate`: boolean - the "Add location" menu under the right mouse button
 - `search`: boolean, `searchPlaceholder`, `searchOptions`, `searchZoom`, `searchMarker`
-- `geocoder`: `KptMapGeocoderPort | null` — this map's geocoder; it feeds both the search and the
+- `searchSpeech`: boolean = false - a microphone in the search field: a click clears the phrase and one
+  spoken utterance becomes the query (same `debounce`/`minLength` as typing); `searchSpeechLang`: string -
+  its language (BCP 47); `searchSpeechColor` - listening colour (theme colour by default). Hidden without browser support. `KptMapSearch` on its own takes `speech` / `speechLang` / `speechColor`
+- `geocoder`: `KptMapGeocoderPort | null` - this map's geocoder; it feeds both the search and the
   address suggestions in the create form
 - `popupLayout`: `'plain' | 'card'`; `distanceFrom`: `KptLatLng | null`
 - `height`: string = `'480px'`; `tileUrl`, `attribution` (ignored by the Google engine)
-- `renderPopup`, `renderCreateForm` — see below
+- `renderPopup`, `renderCreateForm` - see below
 - `className`, `ref` and every other `<div>` prop go to the host
 
 ## Events
 `onLocationClick`, `onClusterClick`, `onLocationCreate`, `onSearchSelect`, `onViewChange`,
-`onUserPositionChange`, `onUserLocationError`.
+`onUserPositionChange`, `onUserLocationError`, `onEngineError`.
 
-`onLocationCreate` gives `{ at, categoryId, value }` — the component appends **nothing** to
+`onEngineError(error)` fires when the engine fails to start (no `leaflet` package, a rejected Google key);
+the error is also logged to the console. `followUser` and the position callbacks are read fresh on every
+fix, so changing them does not restart the geolocation watch.
+
+`onLocationCreate` gives `{ at, categoryId, value }` - the component appends **nothing** to
 `locations`; the application is the source of truth.
 
 ## Render props instead of templates
-The Angular port picks a popup template per category (`kptMapPopup category="…"`). React has one
-prop and a `switch`: `renderPopup({ location, data, category, distance, close })` — the category
+The Angular port picks a popup template per category (`kptMapPopup category="..."`). React has one
+prop and a `switch`: `renderPopup({ location, data, category, distance, close })` - the category
 travels in the context, and the type of `data` follows the map's generic without an extra input.
 
     <KptMap
@@ -64,7 +71,7 @@ travels in the context, and the type of `data` follows the map's generic without
 
 ## Ports are props, not DI
 Angular injects `KPT_MAP_ENGINE`, `KPT_MAP_GEOCODER` and `KPT_MAP_GEOLOCATION`. React has no
-injector, so all three arrive as props — and the geocoder was already per-map in Angular for a
+injector, so all three arrive as props - and the geocoder was already per-map in Angular for a
 licensing reason (a Google geocoder may only be paired with a Google map), so nothing is lost.
 
 The ports themselves are promise-shaped rather than `Observable`-shaped: `reverse()`, `search()`
@@ -72,7 +79,7 @@ and `resolve()` return promises and take an `AbortSignal`, which is what `fetch`
 
     import { createNominatimGeocoder, browserGeolocation } from '@konce-pt/react/map';
 
-    <KptMap geocoder={createNominatimGeocoder()} geolocation={browserGeolocation()} … />
+    <KptMap geocoder={createNominatimGeocoder()} geolocation={browserGeolocation()} ... />
 
 `createGeocoderStub()` and `geolocationStub(at)` cover demos and tests.
 
@@ -83,18 +90,18 @@ second mount waits for the first teardown to finish, instead of failing with "Ma
 already initialized".
 
 ## Sub-components
-- `KptMapLegend` — the legend on its own, when you want it somewhere other than under the map
+- `KptMapLegend` - the legend on its own, when you want it somewhere other than under the map
   (`hiddenCategories` instead of Angular's `hidden`: `hidden` on a DOM element is a boolean and
   would clash with the `<div>` prop)
-- `KptMapPoiCard` — the ready-made place card for `popupLayout="card"`
-- `KptMapSearch` — the address field alone
-- `KptMapCreateDialog`, `KptMapHoursField`, `KptMapImageField` — the schema-built form and its two
+- `KptMapPoiCard` - the ready-made place card for `popupLayout="card"`
+- `KptMapSearch` - the address field alone
+- `KptMapCreateDialog`, `KptMapHoursField`, `KptMapImageField` - the schema-built form and its two
   non-trivial field types
 
 ## Validation without a form framework
 The create dialog is built from `category.fields`. The Angular port stands on Signal Forms; here the
 model is plain state and the rules are a map of functions beside it. The contract is the same:
-declared once with the schema, and the "do not shout in red" gate lives in presentation — an error
+declared once with the schema, and the "do not shout in red" gate lives in presentation - an error
 shows after the field is touched or after a failed submit.
 
 ## Tokens

package/dist/map/map-create-dialog.d.ts

@@ -5,17 +5,17 @@ import type { KptMapGeocoderPort } from './ports.ts';
 export interface KptMapCreateDialogProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onSubmit'>, KptI18nOverrides {
     category: KptMapCategory;
     at: KptLatLng;
-    /** Geokoder tego formularza — źródło podpowiedzi adresowych dla pól z `autofill`. */
+    /** Geokoder tego formularza - źródło podpowiedzi adresowych dla pól z `autofill`. */
     geocoder?: KptMapGeocoderPort | null;
     onSave: (value: Record<string, unknown>) => void;
     onCancel: () => void;
 }
 /**
- * Treść dialogu „dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
+ * Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
  *
  * Port Angulara stoi tu na Signal Forms; w Reakcie formularza-frameworka nie ma, więc model to
  * zwykły stan, a reguły walidacji są mapą funkcji obok niego. Kontrakt zostaje ten sam:
- * walidacja deklarowana raz przy schemie, a bramka „nie strasz czerwienią" siedzi w prezentacji
- * — błąd pokazuje się po dotknięciu pola albo po próbie zapisu.
+ * walidacja deklarowana raz przy schemie, a bramka "nie strasz czerwienią" siedzi w prezentacji
+ * - błąd pokazuje się po dotknięciu pola albo po próbie zapisu.
  */
 export declare function KptMapCreateDialog({ category, at, geocoder, onSave, onCancel, locale: localeOverride, dictionary, className, ...rest }: Readonly<KptMapCreateDialogProps>): import("react").JSX.Element;

package/dist/map/map-create-dialog.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { emptyWeek, parseTime, weekdayName } from '@konce-pt/map';
 import { useEffect, useMemo, useState } from 'react';
@@ -15,7 +16,7 @@ import { KptMapHoursField } from "./map-hours-field.js";
 import { KptMapImageField } from "./map-image-field.js";
 /** Typy pól, które przyjmą fragment adresu. Data czy liczba nie mają z nim nic wspólnego. */
 const TEXTUAL = new Set(['text', 'textarea']);
-/** Pusta wartość właściwa dla typu pola — formularz startuje bez `undefined`. */
+/** Pusta wartość właściwa dla typu pola - formularz startuje bez `undefined`. */
 function initialValue(def) {
     if (def.initial !== undefined)
         return def.initial;
@@ -40,13 +41,17 @@ function initialModel(fields) {
         out[def.key] = initialValue(def);
     return out;
 }
+/** Wartość pola tekstowego z modelu `unknown` - liczba zostaje liczbą zapisaną tekstem, reszta pustym napisem. */
+function asText(value) {
+    return typeof value === 'string' || typeof value === 'number' ? String(value) : '';
+}
 /**
- * Treść dialogu „dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
+ * Treść dialogu "dodaj lokalizację" budowana ze schemy kategorii (`category.fields`).
  *
  * Port Angulara stoi tu na Signal Forms; w Reakcie formularza-frameworka nie ma, więc model to
  * zwykły stan, a reguły walidacji są mapą funkcji obok niego. Kontrakt zostaje ten sam:
- * walidacja deklarowana raz przy schemie, a bramka „nie strasz czerwienią" siedzi w prezentacji
- * — błąd pokazuje się po dotknięciu pola albo po próbie zapisu.
+ * walidacja deklarowana raz przy schemie, a bramka "nie strasz czerwienią" siedzi w prezentacji
+ * - błąd pokazuje się po dotknięciu pola albo po próbie zapisu.
  */
 export function KptMapCreateDialog({ category, at, geocoder = null, onSave, onCancel, locale: localeOverride, dictionary, className, ...rest }) {
     const { t, locale } = useKptMessages({ locale: localeOverride, dictionary });
@@ -55,42 +60,48 @@ export function KptMapCreateDialog({ category, at, geocoder = null, onSave, onCa
     const [touched, setTouched] = useState({});
     /** Po nieudanej próbie zapisu pokazujemy błędy wszystkich pól, nie tylko dotkniętych. */
     const [submitted, setSubmitted] = useState(false);
-    /** Trwa zapytanie do geokodera — pokazujemy notkę zamiast ciszy. */
-    const [geocoding, setGeocoding] = useState(false);
     /** Ostatnio ustalony adres; `address` bywa czytelniejszy niż suma pól. */
     const [address, setAddress] = useState(null);
-    // Inna kategoria to inny formularz — model wraca do wartości początkowych.
-    const schemaRef = useMemo(() => fields, [fields]);
-    useEffect(() => {
-        setModel(initialModel(schemaRef));
+    // Inna kategoria to inny formularz - model wraca do wartości początkowych. Liczone w renderze
+    // (wzorzec poprzedniej wartości): efekt pokazałby jedną klatkę pól starej kategorii.
+    const [modelFields, setModelFields] = useState(fields);
+    if (modelFields !== fields) {
+        setModelFields(fields);
+        setModel(initialModel(fields));
         setTouched({});
         setSubmitted(false);
-    }, [schemaRef]);
+    }
     /** Czy kategoria ma pola do podpowiedzenia i jest czym je podpowiedzieć. */
     const autofillFields = useMemo(() => fields.filter((def) => def.autofill && TEXTUAL.has(def.type)), [fields]);
     const hasAutofill = !!geocoder && autofillFields.length > 0;
+    /** Tożsamość bieżącego zapytania do geokodera - nowa przy każdej zmianie jego wejść. */
+    const geocodeRequest = useMemo(() => (geocoder && autofillFields.length > 0 ? { geocoder, at, locale, autofillFields } : null), [geocoder, at, locale, autofillFields]);
+    /** Zapytanie, na które przyszła już odpowiedź (albo błąd). */
+    const [settledRequest, setSettledRequest] = useState(null);
+    /** Trwa zapytanie do geokodera - pokazujemy notkę zamiast ciszy. */
+    const geocoding = geocodeRequest !== null && settledRequest !== geocodeRequest;
     /**
      * Podpowiada adres z geokodowania wstecznego współrzędnych kliknięcia. Wypełnia wyłącznie
-     * pola z `autofill` i wyłącznie te, które są jeszcze puste — podpowiedź nigdy nie kasuje
+     * pola z `autofill` i wyłącznie te, które są jeszcze puste - podpowiedź nigdy nie kasuje
      * tego, co użytkownik zdążył wpisać.
      */
     useEffect(() => {
-        if (!geocoder || autofillFields.length === 0)
+        if (!geocodeRequest)
             return;
+        const request = geocodeRequest;
         const controller = new AbortController();
-        setGeocoding(true);
-        geocoder
-            .reverse(at, { language: locale, signal: controller.signal })
+        request.geocoder
+            .reverse(request.at, { language: request.locale, signal: controller.signal })
             .then((found) => {
             if (controller.signal.aborted)
                 return;
-            setGeocoding(false);
+            setSettledRequest(request);
             setAddress(found);
             if (!found)
                 return;
             setModel((current) => {
                 const next = { ...current };
-                for (const def of autofillFields) {
+                for (const def of request.autofillFields) {
                     const value = found[def.autofill];
                     // Puste pole = to, czego użytkownik nie tknął.
                     if (typeof value === 'string' && value && !next[def.key])
@@ -101,16 +112,13 @@ export function KptMapCreateDialog({ category, at, geocoder = null, onSave, onCa
         })
             .catch(() => {
             if (!controller.signal.aborted)
-                setGeocoding(false);
+                setSettledRequest(request);
         });
-        return () => {
-            controller.abort();
-            setGeocoding(false);
-        };
-    }, [geocoder, at, locale, autofillFields]);
+        return () => controller.abort();
+    }, [geocodeRequest]);
     /**
      * Komunikat błędu pola albo `null`. Dzień otwarty musi mieć obie godziny i różne od siebie;
-     * dzień oznaczony jako zamknięty przechodzi bez zastrzeżeń — to prawidłowa odpowiedź,
+     * dzień oznaczony jako zamknięty przechodzi bez zastrzeżeń - to prawidłowa odpowiedź,
      * a nie brak danych.
      */
     const errorFor = (def) => {
@@ -174,7 +182,7 @@ export function KptMapCreateDialog({ category, at, geocoder = null, onSave, onCa
         const common = { onTouch: touch(def.key), invalid: !!visibleError(def), touched: !!touched[def.key] };
         switch (def.type) {
             case 'textarea':
-                return (_jsx(KptTextarea, { value: String(value ?? ''), onValueChange: (next) => set(def.key, next), placeholder: def.placeholder ?? '', ...common }));
+                return (_jsx(KptTextarea, { value: asText(value), onValueChange: (next) => set(def.key, next), placeholder: def.placeholder ?? '', ...common }));
             case 'number':
                 return (_jsx(KptInputNumber, { value: value, onValueChange: (next) => set(def.key, next), min: typeof def.min === 'number' ? def.min : undefined, max: typeof def.max === 'number' ? def.max : undefined, placeholder: def.placeholder ?? '', ...common }));
             case 'date':
@@ -186,11 +194,11 @@ export function KptMapCreateDialog({ category, at, geocoder = null, onSave, onCa
             case 'checkbox':
                 return (_jsx(KptCheckbox, { checked: !!value, onCheckedChange: (next) => set(def.key, next), label: def.placeholder ?? '', onTouch: touch(def.key) }));
             case 'image':
-                return (_jsx(KptMapImageField, { value: String(value ?? ''), onValueChange: (next) => set(def.key, next), invalid: !!visibleError(def), touched: !!touched[def.key], onTouch: touch(def.key) }));
+                return (_jsx(KptMapImageField, { value: asText(value), onValueChange: (next) => set(def.key, next), invalid: !!visibleError(def), touched: !!touched[def.key], onTouch: touch(def.key) }));
             case 'hours':
                 return (_jsx(KptMapHoursField, { value: value ?? emptyWeek(), onValueChange: (next) => set(def.key, next), onTouch: touch(def.key) }));
             default:
-                return (_jsx(KptInput, { id: controlId(def), type: def.type === 'tel' || def.type === 'email' || def.type === 'url' ? def.type : 'text', value: String(value ?? ''), onValueChange: (next) => set(def.key, next), placeholder: def.placeholder ?? (def.type === 'url' ? 'https://' : ''), ...common }));
+                return (_jsx(KptInput, { id: controlId(def), type: def.type === 'tel' || def.type === 'email' || def.type === 'url' ? def.type : 'text', value: asText(value), onValueChange: (next) => set(def.key, next), placeholder: def.placeholder ?? (def.type === 'url' ? 'https://' : ''), ...common }));
         }
     }
 }

package/dist/map/map-hours-field.d.ts

@@ -6,14 +6,14 @@ export interface KptMapHoursFieldProps extends Omit<ComponentPropsWithRef<'div'>
     onValueChange: (value: KptMapOpeningHours) => void;
     disabled?: boolean;
     readOnly?: boolean;
-    /** Wywoływane po każdej zmianie — moment, w którym pole staje się dotknięte. */
+    /** Wywoływane po każdej zmianie - moment, w którym pole staje się dotknięte. */
     onTouch?: () => void;
 }
 /**
- * Pole „godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
+ * Pole "godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
  *
- * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem „zamknięte". Skrót
- * „tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni — bez niego wypełnienie
+ * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem "zamknięte". Skrót
+ * "tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni - bez niego wypełnienie
  * formularza to czternaście pól.
  *
  * Nazwy dni idą z `Intl`, nie ze słownika: rozkład tygodnia jest uniwersalny, a tłumaczenie

package/dist/map/map-hours-field.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { emptyWeek, weekdayName } from '@konce-pt/map';
 import { useState } from 'react';
@@ -10,15 +11,15 @@ import { KptIconButton } from "../icon-button/icon-button.js";
 /** Ile przedziałów na dobę dopuszczamy. Dwa pokrywają przerwę i dobę przez północ. */
 const MAX_RANGES = 2;
 /**
- * Snap minut na tarczy zegara. Godziny otwarcia chodzą co kwadrans, a nie co minutę —
+ * Snap minut na tarczy zegara. Godziny otwarcia chodzą co kwadrans, a nie co minutę -
  * krok 5 daje trafienie w 07:30 czy 22:45 bez celowania w pojedynczą minutę.
  */
 const MINUTE_STEP = 5;
 /**
- * Pole „godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
+ * Pole "godziny otwarcia" formularza dodawania lokalizacji (`type: 'hours'` w schemie).
  *
- * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem „zamknięte". Skrót
- * „tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni — bez niego wypełnienie
+ * Siedem wierszy od poniedziałku, każdy z parą godzin i znacznikiem "zamknięte". Skrót
+ * "tak samo przez cały tydzień" kopiuje poniedziałek na pozostałe dni - bez niego wypełnienie
  * formularza to czternaście pól.
  *
  * Nazwy dni idą z `Intl`, nie ze słownika: rozkład tygodnia jest uniwersalny, a tłumaczenie
@@ -26,7 +27,7 @@ const MINUTE_STEP = 5;
  */
 export function KptMapHoursField({ value, onValueChange, disabled = false, readOnly = false, onTouch, locale: localeOverride, dictionary, className, ...rest }) {
     const { t, locale } = useKptMessages({ locale: localeOverride, dictionary });
-    /** Skrót „tak samo przez cały tydzień" — stan pola, nie część wartości. */
+    /** Skrót "tak samo przez cały tydzień" - stan pola, nie część wartości. */
     const [sameAllWeek, setSameAllWeek] = useState(false);
     const rows = Array.from({ length: 7 }, (_, index) => {
         const day = (index + 1);
@@ -38,7 +39,7 @@ export function KptMapHoursField({ value, onValueChange, disabled = false, readO
             ranges: (entry?.ranges ?? []).map((range) => ({ from: range.from, to: range.to })),
         };
     });
-    /** Zapis zawsze przez pełny, uporządkowany tydzień — model nie ma dziur. */
+    /** Zapis zawsze przez pełny, uporządkowany tydzień - model nie ma dziur. */
     const write = (change) => {
         const base = emptyWeek().map((day) => value.find((entry) => entry.day === day.day) ?? day);
         onValueChange(change(base));
@@ -79,7 +80,7 @@ export function KptMapHoursField({ value, onValueChange, disabled = false, readO
         ranges[index][edge] = time;
         return { ...day, closed: false, ranges };
     });
-    return (_jsxs("div", { className: cn('kpt-map-hours-field', className), ...rest, children: [_jsx(KptCheckbox, { className: "kpt-map-hours-field__same", checked: sameAllWeek, onCheckedChange: onSameAllWeek, disabled: disabled || readOnly, label: t('map.field.hoursSameAllWeek') }), _jsx("ul", { className: "kpt-map-hours-field__week", children: rows.map((row) => (_jsxs("li", { className: "kpt-map-hours-field__day", "data-locked": locked(row) ? '' : undefined, children: [_jsx("span", { className: "kpt-map-hours-field__name", children: row.name }), _jsx("div", { className: "kpt-map-hours-field__ranges", children: !row.closed ? (_jsxs(_Fragment, { children: [row.ranges.map((range, index) => (_jsxs("div", { className: "kpt-map-hours-field__range", children: [_jsx(KptDatepicker, { selectionMode: "time", minuteStep: MINUTE_STEP, value: range.from, onValueChange: (time) => setTime(row, index, 'from', String(time ?? '')), disabled: locked(row), "aria-label": `${t('map.field.hoursFrom')} — ${row.name}`, onTouch: onTouch }), _jsx("span", { className: "kpt-map-hours-field__dash", "aria-hidden": "true", children: "\u2013" }), _jsx(KptDatepicker, { selectionMode: "time", minuteStep: MINUTE_STEP, value: range.to, onValueChange: (time) => setTime(row, index, 'to', String(time ?? '')), disabled: locked(row), "aria-label": `${t('map.field.hoursTo')} — ${row.name}`, onTouch: onTouch }), row.ranges.length > 1 ? (_jsx(KptIconButton, { variant: "text", size: "sm", disabled: locked(row), "aria-label": t('map.field.hoursRemoveRange'), onClick: () => patch(row.day, (day) => ({
+    return (_jsxs("div", { className: cn('kpt-map-hours-field', className), ...rest, children: [_jsx(KptCheckbox, { className: "kpt-map-hours-field__same", checked: sameAllWeek, onCheckedChange: onSameAllWeek, disabled: disabled || readOnly, label: t('map.field.hoursSameAllWeek') }), _jsx("ul", { className: "kpt-map-hours-field__week", children: rows.map((row) => (_jsxs("li", { className: "kpt-map-hours-field__day", "data-locked": locked(row) ? '' : undefined, children: [_jsx("span", { className: "kpt-map-hours-field__name", children: row.name }), _jsx("div", { className: "kpt-map-hours-field__ranges", children: !row.closed ? (_jsxs(_Fragment, { children: [row.ranges.map((range, index) => (_jsxs("div", { className: "kpt-map-hours-field__range", children: [_jsx(KptDatepicker, { selectionMode: "time", minuteStep: MINUTE_STEP, value: range.from, onValueChange: (time) => setTime(row, index, 'from', String(time ?? '')), disabled: locked(row), "aria-label": `${t('map.field.hoursFrom')} - ${row.name}`, onTouch: onTouch }), _jsx("span", { className: "kpt-map-hours-field__dash", "aria-hidden": "true", children: "-" }), _jsx(KptDatepicker, { selectionMode: "time", minuteStep: MINUTE_STEP, value: range.to, onValueChange: (time) => setTime(row, index, 'to', String(time ?? '')), disabled: locked(row), "aria-label": `${t('map.field.hoursTo')} - ${row.name}`, onTouch: onTouch }), row.ranges.length > 1 ? (_jsx(KptIconButton, { variant: "text", size: "sm", disabled: locked(row), "aria-label": t('map.field.hoursRemoveRange'), onClick: () => patch(row.day, (day) => ({
                                                     ...day,
                                                     ranges: day.ranges.filter((_, i) => i !== index).map((r) => ({ ...r })),
                                                 })), children: _jsx(KptIcon, { name: "minus" }) })) : null] }, index))), row.ranges.length < MAX_RANGES ? (_jsxs("button", { className: "kpt-map-hours-field__add", type: "button", disabled: locked(row), onClick: () => patch(row.day, (day) => ({

package/dist/map/map-image-field.d.ts

@@ -12,13 +12,13 @@ export interface KptMapImageFieldProps extends Omit<ComponentPropsWithRef<'div'>
     onTouch?: () => void;
 }
 /**
- * Pole „zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
+ * Pole "zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
  *
  * Wartością jest zawsze **string**: albo `data:` z wybranego pliku, albo adres wklejony przez
  * użytkownika. Karta miejsca nie rozróżnia jednego od drugiego, więc formularz nie musi
  * decydować za aplikację, gdzie zdjęcia mieszkają.
  *
- * Plik czytamy w przeglądarce i nigdzie nie wysyłamy — biblioteka nie ma i nie chce mieć
+ * Plik czytamy w przeglądarce i nigdzie nie wysyłamy - biblioteka nie ma i nie chce mieć
  * wiedzy o storage'u aplikacji.
  */
 export declare function KptMapImageField({ value, onValueChange, disabled, readOnly, invalid, touched, maxBytes, onTouch, locale, dictionary, className, ...rest }: Readonly<KptMapImageFieldProps>): import("react").JSX.Element;

package/dist/map/map-image-field.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from 'react';
 import { cn } from "../internal/cn.js";
@@ -5,16 +6,16 @@ import { useKptMessages } from "../i18n/i18n-context.js";
 import { KptFileUpload } from "../file-upload/file-upload.js";
 import { KptIcon } from "../icon/icon.js";
 import { KptInput } from "../input/input.js";
-/** Domyślny limit pliku. Data URL puchnie o ~⅓, a wartość leci w `onLocationCreate`. */
+/** Domyślny limit pliku. Data URL puchnie o ~1/3, a wartość leci w `onLocationCreate`. */
 const DEFAULT_MAX_BYTES = 2 * 1024 * 1024;
 /**
- * Pole „zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
+ * Pole "zdjęcie" formularza dodawania lokalizacji (`type: 'image'` w schemie kategorii).
  *
  * Wartością jest zawsze **string**: albo `data:` z wybranego pliku, albo adres wklejony przez
  * użytkownika. Karta miejsca nie rozróżnia jednego od drugiego, więc formularz nie musi
  * decydować za aplikację, gdzie zdjęcia mieszkają.
  *
- * Plik czytamy w przeglądarce i nigdzie nie wysyłamy — biblioteka nie ma i nie chce mieć
+ * Plik czytamy w przeglądarce i nigdzie nie wysyłamy - biblioteka nie ma i nie chce mieć
  * wiedzy o storage'u aplikacji.
  */
 export function KptMapImageField({ value, onValueChange, disabled = false, readOnly = false, invalid = false, touched = false, maxBytes = DEFAULT_MAX_BYTES, onTouch, locale, dictionary, className, ...rest }) {
@@ -42,12 +43,12 @@ export function KptMapImageField({ value, onValueChange, disabled = false, readO
             return;
         }
         const reader = new FileReader();
-        reader.onload = () => onValueChange(String(reader.result ?? ''));
+        reader.onload = () => onValueChange((typeof reader.result === 'string' ? reader.result : ''));
         reader.onerror = () => setSizeError(t('map.field.imageTooLarge', { max: maxLabel }));
         reader.readAsDataURL(file);
     };
     return (_jsxs("div", { className: cn('kpt-map-image-field', className), ...rest, children: [_jsx(KptFileUpload, { accept: "image/*", value: files, onValueChange: onFiles, disabled: disabled || readOnly, invalid: invalid, touched: touched }), _jsxs("label", { className: "kpt-map-image-field__url", children: [_jsx("span", { className: "kpt-map-image-field__url-label", children: t('map.field.orPasteUrl') }), _jsx(KptInput, { type: "url", value: urlValue, onValueChange: (url) => {
-                            // Adres i plik wykluczają się — dwa źródła jednej wartości myliłyby użytkownika.
+                            // Adres i plik wykluczają się - dwa źródła jednej wartości myliłyby użytkownika.
                             if (url)
                                 setFiles([]);
                             setSizeError(null);

package/dist/map/map-legend.d.ts

@@ -4,20 +4,20 @@ import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
 export interface KptMapLegendProps extends Omit<ComponentPropsWithRef<'div'>, 'children'>, KptI18nOverrides {
     categories: readonly KptMapCategory[];
     /**
-     * Identyfikatory ukrytych kategorii — kontrolowane. Nazwa dłuższa niż `hidden` z portu
+     * Identyfikatory ukrytych kategorii - kontrolowane. Nazwa dłuższa niż `hidden` z portu
      * Angulara, bo `hidden` na elemencie DOM jest booleanem i kolidowałoby z propsem `<div>`.
      */
     hiddenCategories?: string[];
     defaultHiddenCategories?: string[];
     onHiddenCategoriesChange?: (hidden: string[]) => void;
-    /** Opcjonalne liczniki `{ categoryId: liczba }` — pokazywane przy etykiecie. */
+    /** Opcjonalne liczniki `{ categoryId: liczba }` - pokazywane przy etykiecie. */
     counts?: Record<string, number> | null;
     orientation?: 'horizontal' | 'vertical';
-    /** Wyłącza chowanie kategorii — legenda staje się czysto informacyjna. */
+    /** Wyłącza chowanie kategorii - legenda staje się czysto informacyjna. */
     interactive?: boolean;
 }
 /**
- * Legenda mapy — lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
+ * Legenda mapy - lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
  * kliknięcie chowa i pokazuje kategorię.
  *
  * `KptMap` renderuje ją sam pod mapą przy `legend`; kto chce ją gdzie indziej, wyłącza tamto

package/dist/map/map-legend.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { colorVarOf, contrastVarOf } from '@konce-pt/map';
 import { cn } from "../internal/cn.js";
@@ -5,7 +6,7 @@ import { useControllableState } from "../internal/use-controllable-state.js";
 import { useKptMessages } from "../i18n/i18n-context.js";
 import { KptIcon } from "../icon/icon.js";
 /**
- * Legenda mapy — lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
+ * Legenda mapy - lista kategorii ze znacznikiem koloru i ikoną. Pozycje są przyciskami:
  * kliknięcie chowa i pokazuje kategorię.
  *
  * `KptMap` renderuje ją sam pod mapą przy `legend`; kto chce ją gdzie indziej, wyłącza tamto
@@ -33,7 +34,7 @@ export function KptMapLegend({ categories, hiddenCategories, defaultHiddenCatego
             const isHidden = hiddenSet.has(category.id);
             const label = t(isHidden ? 'map.showCategory' : 'map.hideCategory', { category: category.label });
             return (_jsxs("button", { type: "button", className: cn('kpt-map-legend__item', isHidden && 'kpt-map-legend__item--off'), style: {
-                    // Glif dostaje kolor kontrastowy — zaszyta biel gubi się na jasnych rolach.
+                    // Glif dostaje kolor kontrastowy - zaszyta biel gubi się na jasnych rolach.
                     '--_kpt-legend-color': colorVarOf(category.color),
                     '--_kpt-legend-fg': contrastVarOf(category.color),
                 }, "aria-pressed": interactive ? !isHidden : undefined, "aria-label": interactive ? label : undefined, disabled: !interactive, onClick: () => toggle(category.id), children: [_jsx("span", { className: "kpt-map-legend__swatch", "aria-hidden": "true", children: category.icon ? _jsx(KptIcon, { name: category.icon }) : null }), _jsx("span", { className: "kpt-map-legend__label", children: category.label }), counts ? _jsx("span", { className: "kpt-map-legend__count", children: counts[category.id] ?? 0 }) : null] }, category.id));

package/dist/map/map-poi-card.d.ts

@@ -24,14 +24,14 @@ export interface KptMapPoiCardProps extends Omit<ComponentPropsWithRef<'div'>, '
     onShare?: (poi: KptMapPoi) => void;
 }
 /**
- * Karta miejsca do popupu mapy — dystans, zdjęcie, akcje, kategoria, rozwijane godziny
+ * Karta miejsca do popupu mapy - dystans, zdjęcie, akcje, kategoria, rozwijane godziny
  * otwarcia i wiersze kontaktowe z kopiowaniem.
  *
  * Komponent jest sterowany danymi: bierze `KptMapPoi`, a nie model domenowy aplikacji.
- * Mapowanie `KptMapLocation.data` → `KptMapPoi` robi aplikacja, dzięki czemu karta nie wie,
+ * Mapowanie `KptMapLocation.data` -> `KptMapPoi` robi aplikacja, dzięki czemu karta nie wie,
  * czy pokazuje ładowarkę, restaurację, czy punkt serwisowy.
  *
- * Sam popup trzeba przełączyć na `popupLayout="card"` — inaczej karta dostanie szerokość
+ * Sam popup trzeba przełączyć na `popupLayout="card"` - inaczej karta dostanie szerokość
  * i padding przeznaczone dla treści tekstowej.
  *
  * @example

package/dist/map/map-poi-card.js

@@ -1,3 +1,4 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { foregroundVarOf, formatDistance, formatLatLng, groupWeek, isAlwaysOpen, isOpenAt, nextChange, normalizeUrl, prettyUrl, } from '@konce-pt/map';
 import { useId, useRef, useState } from 'react';
@@ -8,14 +9,14 @@ import { KptButton } from "../button/button.js";
 import { KptIcon } from "../icon/icon.js";
 import { KptIconButton } from "../icon-button/icon-button.js";
 /**
- * Karta miejsca do popupu mapy — dystans, zdjęcie, akcje, kategoria, rozwijane godziny
+ * Karta miejsca do popupu mapy - dystans, zdjęcie, akcje, kategoria, rozwijane godziny
  * otwarcia i wiersze kontaktowe z kopiowaniem.
  *
  * Komponent jest sterowany danymi: bierze `KptMapPoi`, a nie model domenowy aplikacji.
- * Mapowanie `KptMapLocation.data` → `KptMapPoi` robi aplikacja, dzięki czemu karta nie wie,
+ * Mapowanie `KptMapLocation.data` -> `KptMapPoi` robi aplikacja, dzięki czemu karta nie wie,
  * czy pokazuje ładowarkę, restaurację, czy punkt serwisowy.
  *
- * Sam popup trzeba przełączyć na `popupLayout="card"` — inaczej karta dostanie szerokość
+ * Sam popup trzeba przełączyć na `popupLayout="card"` - inaczej karta dostanie szerokość
  * i padding przeznaczone dla treści tekstowej.
  *
  * @example
@@ -37,9 +38,9 @@ export function KptMapPoiCard({ poi, distance = null, category = null, primaryLa
         defaultValue: defaultHoursExpanded,
         onChange: onHoursExpandedChange,
     });
-    /** Rośnie przy każdym rozwinięciu godzin — karta bywa otwarta dłużej niż minutę. */
+    /** Rośnie przy każdym rozwinięciu godzin - karta bywa otwarta dłużej niż minutę. */
     const [now, setNow] = useState(() => Date.now());
-    /** Klucz wiersza, którego wartość właśnie skopiowano — przełącza ikonę na „check". */
+    /** Klucz wiersza, którego wartość właśnie skopiowano - przełącza ikonę na "check". */
     const [justCopied, setJustCopied] = useState(null);
     const copyTimer = useRef(null);
     /** Bez API schowka przycisk kopiowania w ogóle się nie renderuje. */
@@ -50,7 +51,7 @@ export function KptMapPoiCard({ poi, distance = null, category = null, primaryLa
     const open = isOpenAt(poi.hours, new Date(now));
     const hoursGroups = groupWeek(poi.hours, locale);
     const statusLabel = alwaysOpen ? t('map.poi.alwaysOpen') : t(open ? 'map.poi.openNow' : 'map.poi.closedNow');
-    /** Dopisek „otwarcie o 11:00" — nie ma go dla 24/7 ani gdy zmiana jest dalej niż doba. */
+    /** Dopisek "otwarcie o 11:00" - nie ma go dla 24/7 ani gdy zmiana jest dalej niż doba. */
     const statusHint = (() => {
         if (alwaysOpen || !hasHours)
             return null;
@@ -110,7 +111,7 @@ export function KptMapPoiCard({ poi, distance = null, category = null, primaryLa
             await navigator.clipboard.writeText(row.copyValue);
         }
         catch {
-            // Odmowa zgody albo brak bezpiecznego kontekstu — nie ma czego zgłaszać użytkownikowi.
+            // Odmowa zgody albo brak bezpiecznego kontekstu - nie ma czego zgłaszać użytkownikowi.
             return;
         }
         setJustCopied(row.kind);
@@ -145,8 +146,8 @@ export function KptMapPoiCard({ poi, distance = null, category = null, primaryLa
     };
     const distanceLabel = formatDistance(distance, locale);
     return (_jsxs("div", { className: cn('kpt-map-poi', className), ...rest, children: [_jsxs("header", { className: "kpt-map-poi__head", children: [_jsx("p", { className: "kpt-map-poi__title", role: "heading", "aria-level": 3, children: poi.title }), closable ? (_jsx(KptIconButton, { hostProps: { className: 'kpt-map-poi__close' }, variant: "text", size: "sm", "aria-label": t('common.close'), onClick: onClose, children: _jsx(KptIcon, { name: "x" }) })) : null] }), _jsxs("p", { className: "kpt-map-poi__meta", children: [distanceLabel ? _jsx("strong", { className: "kpt-map-poi__distance", children: distanceLabel }) : null, poi.address ? _jsx("span", { className: "kpt-map-poi__address", children: poi.address }) : null] }), _jsxs("div", { className: "kpt-map-poi__scroll", children: [_jsx("div", { className: "kpt-map-poi__media", children: poi.photo ? (_jsx("img", { className: "kpt-map-poi__photo", src: poi.photo, alt: poi.photoAlt ?? poi.title, loading: "lazy", decoding: "async" })) : (_jsx("div", { className: "kpt-map-poi__photo-empty", "aria-label": t('map.poi.noPhoto'), role: "img", children: _jsx(KptIcon, { name: "photo", size: "1.75rem" }) })) }), _jsxs("div", { className: "kpt-map-poi__actions", children: [primaryLabel ? (_jsx(KptButton, { hostProps: { className: 'kpt-map-poi__cta' }, size: "sm", fullWidth: true, onClick: () => onPrimaryAction?.(poi), children: primaryLabel })) : null, showShare ? (_jsx(KptIconButton, { variant: "outline", size: "sm", "aria-label": t('map.poi.share'), onClick: share, children: _jsx(KptIcon, { name: "share" }) })) : null, showFavourite ? (_jsx(KptIconButton, { hostProps: { className: 'kpt-map-poi__fav', 'data-on': isFavourite ? '' : undefined }, variant: "outline", size: "sm", "aria-pressed": isFavourite, "aria-label": t(isFavourite ? 'map.poi.removeFavourite' : 'map.poi.addFavourite'), onClick: () => setFavourite(!isFavourite), children: _jsx(KptIcon, { name: "star" }) })) : null] }), category ? (_jsxs("p", { className: "kpt-map-poi__category", style: { '--_kpt-poi-color': foregroundVarOf(category.color) }, children: [category.icon ? _jsx(KptIcon, { className: "kpt-map-poi__category-icon", name: category.icon }) : null, category.label] })) : null, hasHours ? (_jsxs("div", { className: "kpt-map-poi__hours", children: [_jsxs("button", { className: "kpt-map-poi__hours-toggle", type: "button", "aria-expanded": expanded, "aria-controls": hoursId, onClick: () => {
-                                    // Odświeżamy zegar przy rozwinięciu — karta bywa otwarta dłużej niż minutę.
+                                    // Odświeżamy zegar przy rozwinięciu - karta bywa otwarta dłużej niż minutę.
                                     setNow(Date.now());
                                     setExpanded(!expanded);
-                                }, children: [_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: "clock" }), _jsx("span", { className: "kpt-map-poi__status", "data-open": open || alwaysOpen, children: statusLabel }), statusHint ? _jsxs("span", { className: "kpt-map-poi__status-hint", children: ["\u00B7 ", statusHint] }) : null, _jsx(KptIcon, { className: "kpt-map-poi__chevron", name: "chevron-down" })] }), expanded ? (_jsx("dl", { className: "kpt-map-poi__week", id: hoursId, children: hoursGroups.map((group) => (_jsxs("div", { style: { display: 'contents' }, children: [_jsx("dt", { className: "kpt-map-poi__week-day", children: group.label }), _jsx("dd", { className: "kpt-map-poi__week-hours", children: group.closed ? (_jsx("span", { className: "kpt-map-poi__week-closed", children: t('map.poi.closedDay') })) : (group.ranges.map((range) => (_jsx("span", { className: "kpt-map-poi__week-range", children: range }, range)))) })] }, group.label))) })) : null] })) : null, rows.length || poi.facts?.length ? (_jsxs("ul", { className: "kpt-map-poi__rows", children: [rows.map((row) => (_jsxs("li", { className: "kpt-map-poi__row", children: [_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: row.icon }), row.href ? (_jsx("a", { className: "kpt-map-poi__row-value kpt-map-poi__row-link", href: row.href, target: row.external ? '_blank' : undefined, rel: row.external ? 'noopener' : undefined, children: row.text })) : (_jsx("span", { className: "kpt-map-poi__row-value", children: row.text })), _jsxs("span", { className: "kpt-map-poi__row-actions", children: [row.href ? (_jsx("a", { className: "kpt-map-poi__row-action", href: row.href, target: row.external ? '_blank' : undefined, rel: row.external ? 'noopener' : undefined, "aria-label": row.actionLabel, title: row.actionLabel, children: _jsx(KptIcon, { name: row.actionIcon }) })) : null, canCopy ? (_jsx("button", { className: "kpt-map-poi__row-action", type: "button", "aria-label": t('map.poi.copy'), title: t('map.poi.copy'), onClick: () => void copy(row), children: _jsx(KptIcon, { name: justCopied === row.kind ? 'check' : 'copy' }) })) : null] })] }, row.kind))), (poi.facts ?? []).map((fact) => (_jsxs("li", { className: "kpt-map-poi__row kpt-map-poi__row--fact", children: [fact.icon ? (_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: fact.icon })) : (_jsx("span", { className: "kpt-map-poi__row-icon", "aria-hidden": "true" })), _jsxs("span", { className: "kpt-map-poi__row-value", children: [_jsx("span", { className: "kpt-map-poi__fact-label", children: fact.label }), " ", fact.value] })] }, fact.label)))] })) : null, _jsx("p", { className: "kpt-map-poi__live", "aria-live": "polite", children: justCopied ? t('map.poi.copied') : '' })] })] }));
+                                }, children: [_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: "clock" }), _jsx("span", { className: "kpt-map-poi__status", "data-open": open || alwaysOpen, children: statusLabel }), statusHint ? _jsxs("span", { className: "kpt-map-poi__status-hint", children: [", ", statusHint] }) : null, _jsx(KptIcon, { className: "kpt-map-poi__chevron", name: "chevron-down" })] }), expanded ? (_jsx("dl", { className: "kpt-map-poi__week", id: hoursId, children: hoursGroups.map((group) => (_jsxs("div", { style: { display: 'contents' }, children: [_jsx("dt", { className: "kpt-map-poi__week-day", children: group.label }), _jsx("dd", { className: "kpt-map-poi__week-hours", children: group.closed ? (_jsx("span", { className: "kpt-map-poi__week-closed", children: t('map.poi.closedDay') })) : (group.ranges.map((range) => (_jsx("span", { className: "kpt-map-poi__week-range", children: range }, range)))) })] }, group.label))) })) : null] })) : null, rows.length || poi.facts?.length ? (_jsxs("ul", { className: "kpt-map-poi__rows", children: [rows.map((row) => (_jsxs("li", { className: "kpt-map-poi__row", children: [_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: row.icon }), row.href ? (_jsx("a", { className: "kpt-map-poi__row-value kpt-map-poi__row-link", href: row.href, target: row.external ? '_blank' : undefined, rel: row.external ? 'noopener noreferrer' : undefined, children: row.text })) : (_jsx("span", { className: "kpt-map-poi__row-value", children: row.text })), _jsxs("span", { className: "kpt-map-poi__row-actions", children: [row.href ? (_jsx("a", { className: "kpt-map-poi__row-action", href: row.href, target: row.external ? '_blank' : undefined, rel: row.external ? 'noopener noreferrer' : undefined, "aria-label": row.actionLabel, title: row.actionLabel, children: _jsx(KptIcon, { name: row.actionIcon }) })) : null, canCopy ? (_jsx("button", { className: "kpt-map-poi__row-action", type: "button", "aria-label": t('map.poi.copy'), title: t('map.poi.copy'), onClick: () => void copy(row), children: _jsx(KptIcon, { name: justCopied === row.kind ? 'check' : 'copy' }) })) : null] })] }, row.kind))), (poi.facts ?? []).map((fact) => (_jsxs("li", { className: "kpt-map-poi__row kpt-map-poi__row--fact", children: [fact.icon ? (_jsx(KptIcon, { className: "kpt-map-poi__row-icon", name: fact.icon })) : (_jsx("span", { className: "kpt-map-poi__row-icon", "aria-hidden": "true" })), _jsxs("span", { className: "kpt-map-poi__row-value", children: [_jsx("span", { className: "kpt-map-poi__fact-label", children: fact.label }), " ", fact.value] })] }, fact.label)))] })) : null, _jsx("p", { className: "kpt-map-poi__live", "aria-live": "polite", children: justCopied ? t('map.poi.copied') : '' })] })] }));
 }

package/dist/map/map-search.d.ts

@@ -1,6 +1,7 @@
 import type { KptMapBounds, KptMapSearchResult } from '@konce-pt/map';
 import { type ComponentPropsWithRef } from 'react';
 import { type KptI18nOverrides } from '../i18n/i18n-context.tsx';
+import { type KptSpeechColor } from '../speech/speech-button.tsx';
 import type { KptMapGeocoderPort } from './ports.ts';
 export interface KptMapSearchProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onSelect'>, KptI18nOverrides {
     /** Geokoder tego pola. Bez metody `search()` pole renderuje się wyłączone. */
@@ -13,25 +14,35 @@ export interface KptMapSearchProps extends Omit<ComponentPropsWithRef<'div'>, 'c
     debounce?: number;
     /** Ile podpowiedzi najwyżej. */
     limit?: number;
-    /** Zawężenie twarde do krajów (ISO 3166-1 alpha-2) — wyniki spoza nich nie wrócą. */
+    /** Zawężenie twarde do krajów (ISO 3166-1 alpha-2) - wyniki spoza nich nie wrócą. */
     countryCodes?: readonly string[] | null;
     /** Preferowany prostokąt wyników. Nie odcina reszty świata, tylko przesuwa ją niżej. */
     viewbox?: KptMapBounds | null;
     disabled?: boolean;
-    /** Wybrano miejsce — **zawsze ze współrzędnymi**. */
+    /**
+     * Mikrofon w polu (Web Speech API): kliknięcie czyści frazę, a jedna podyktowana wypowiedź
+     * staje się zapytaniem - z tym samym `debounce` i `minLength` co pisanie. Bez wsparcia
+     * przeglądarki się nie pokazuje.
+     */
+    speech?: boolean;
+    /** Język dyktowania (BCP 47); bez niego z `KptI18nProvider`. */
+    speechLang?: string;
+    /** Kolor "stop" i fali w trakcie nasłuchu; domyślnie kolor motywu. */
+    speechColor?: KptSpeechColor;
+    /** Wybrano miejsce - **zawsze ze współrzędnymi**. */
     onSelect?: (result: KptMapSearchResult) => void;
-    /** Pole wyczyszczone — rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
+    /** Pole wyczyszczone - rodzic sprząta po sobie (np. chowa tymczasową pinezkę). */
     onClear?: () => void;
 }
 /**
  * Wyszukiwarka adresów: pole z podpowiedziami z geokodera. Wynik wyboru leci w `onSelect`,
- * a co z nim zrobić — decyduje rodzic (`KptMap` przenosi na niego widok).
+ * a co z nim zrobić - decyduje rodzic (`KptMap` przenosi na niego widok).
  *
  * Świadomie **nie** stoi na `KptAutocomplete`: tamten filtruje opcje po stronie klienta (wyniki
  * geokodera, tolerancyjne na literówki, wypadałyby z listy), a jego wartością jest sam `string`
- * — nie ma czym przewieźć współrzędnych.
+ * - nie ma czym przewieźć współrzędnych.
  *
  * @example
  * <KptMapSearch geocoder={geocoder} viewbox={bounds} onSelect={goTo} />
  */
-export declare function KptMapSearch({ geocoder, placeholder, minLength, debounce, limit, countryCodes, viewbox, disabled, onSelect, onClear, locale: localeOverride, dictionary, className, ...rest }: Readonly<KptMapSearchProps>): import("react").JSX.Element;
+export declare function KptMapSearch({ geocoder, placeholder, minLength, debounce, limit, countryCodes, viewbox, disabled, speech, speechLang, speechColor, onSelect, onClear, locale: localeOverride, dictionary, className, ...rest }: Readonly<KptMapSearchProps>): import("react").JSX.Element;