@code-plate/iran-cities 1.1.0 → 2.0.0

package/dist/hooks-K7pTMF2R.cjs

@@ -0,0 +1,139 @@
+let react = require("react");
+// src/hooks.ts
+function isEmptyQuery(value) {
+	return value === void 0 || value === null || value === "";
+}
+const EMPTY_CITIES = Object.freeze([]);
+function createHooks(api) {
+	function resolveInitial(initialProvince, initialCity) {
+		const province = isEmptyQuery(initialProvince) ? void 0 : api.getProvince(initialProvince);
+		if (isEmptyQuery(initialCity)) return { provinceId: province === null || province === void 0 ? void 0 : province.id };
+		const city = province ? api.getCity(initialCity, province.id) : api.getCity(initialCity);
+		if (!city) return { provinceId: province === null || province === void 0 ? void 0 : province.id };
+		return {
+			provinceId: city.provinceId,
+			cityId: city.id
+		};
+	}
+	function useProvinces() {
+		return (0, react.useMemo)(() => api.getProvincesList(), []);
+	}
+	function useCities(provinceQuery) {
+		return (0, react.useMemo)(() => isEmptyQuery(provinceQuery) ? EMPTY_CITIES : api.getCities(provinceQuery), [provinceQuery]);
+	}
+	function useProvinceCitySelect(options = {}) {
+		var _selectedProvince$en, _selectedCity$en;
+		const { value, onChange, initialProvince, initialCity } = options;
+		const [inner, setInner] = (0, react.useState)(() => resolveInitial(initialProvince, initialCity));
+		const controlled = value !== void 0;
+		const current = controlled ? value : inner;
+		const onChangeRef = (0, react.useRef)(onChange);
+		(0, react.useEffect)(() => {
+			onChangeRef.current = onChange;
+		}, [onChange]);
+		const selectedProvince = (0, react.useMemo)(() => current.provinceId === void 0 ? void 0 : api.getProvinceById(current.provinceId), [current.provinceId]);
+		const selectedCity = (0, react.useMemo)(() => {
+			if (current.cityId === void 0 || !selectedProvince) return void 0;
+			const city = api.getCityById(current.cityId);
+			return city && city.provinceId === selectedProvince.id ? city : void 0;
+		}, [current.cityId, selectedProvince]);
+		const provinces = useProvinces();
+		const cities = useCities(selectedProvince === null || selectedProvince === void 0 ? void 0 : selectedProvince.id);
+		const provinceId = selectedProvince === null || selectedProvince === void 0 ? void 0 : selectedProvince.id;
+		const cityId = selectedCity === null || selectedCity === void 0 ? void 0 : selectedCity.id;
+		const commit = (0, react.useCallback)((next) => {
+			var _onChangeRef$current;
+			if (!controlled) setInner(next);
+			(_onChangeRef$current = onChangeRef.current) === null || _onChangeRef$current === void 0 || _onChangeRef$current.call(onChangeRef, next);
+		}, [controlled]);
+		const setProvince = (0, react.useCallback)((query) => {
+			const province = isEmptyQuery(query) ? void 0 : api.getProvince(query);
+			commit({
+				provinceId: province === null || province === void 0 ? void 0 : province.id,
+				cityId: void 0
+			});
+		}, [commit]);
+		const setCity = (0, react.useCallback)((query) => {
+			var _api$getCity;
+			if (provinceId === void 0 || isEmptyQuery(query)) {
+				commit({
+					provinceId,
+					cityId: void 0
+				});
+				return;
+			}
+			commit({
+				provinceId,
+				cityId: (_api$getCity = api.getCity(query, provinceId)) === null || _api$getCity === void 0 ? void 0 : _api$getCity.id
+			});
+		}, [commit, provinceId]);
+		const reset = (0, react.useCallback)(() => commit({}), [commit]);
+		const normalizedValue = (0, react.useMemo)(() => ({
+			provinceId,
+			cityId
+		}), [provinceId, cityId]);
+		return {
+			provinces,
+			cities,
+			province: (_selectedProvince$en = selectedProvince === null || selectedProvince === void 0 ? void 0 : selectedProvince.en) !== null && _selectedProvince$en !== void 0 ? _selectedProvince$en : "",
+			city: (_selectedCity$en = selectedCity === null || selectedCity === void 0 ? void 0 : selectedCity.en) !== null && _selectedCity$en !== void 0 ? _selectedCity$en : "",
+			provinceId,
+			cityId,
+			value: normalizedValue,
+			selectedProvince,
+			selectedCity,
+			setProvince,
+			setCity,
+			reset
+		};
+	}
+	function useStableOptions(options) {
+		const { limit, locale, fuzzy, maxDistance, emptyQuery } = options !== null && options !== void 0 ? options : {};
+		return (0, react.useMemo)(() => ({
+			limit,
+			locale,
+			fuzzy,
+			maxDistance,
+			emptyQuery
+		}), [
+			limit,
+			locale,
+			fuzzy,
+			maxDistance,
+			emptyQuery
+		]);
+	}
+	function useCitySearch(initialQuery = "", options) {
+		const [query, setQuery] = (0, react.useState)(initialQuery);
+		const stable = useStableOptions(options);
+		return {
+			query,
+			setQuery,
+			results: (0, react.useMemo)(() => api.searchCities(query, stable), [query, stable])
+		};
+	}
+	function useProvinceSearch(initialQuery = "", options) {
+		const [query, setQuery] = (0, react.useState)(initialQuery);
+		const stable = useStableOptions(options);
+		return {
+			query,
+			setQuery,
+			results: (0, react.useMemo)(() => api.searchProvinces(query, stable), [query, stable])
+		};
+	}
+	return {
+		useProvinces,
+		useCities,
+		useProvinceCitySelect,
+		useCitySearch,
+		useProvinceSearch
+	};
+}
+Object.defineProperty(exports, "createHooks", {
+	enumerable: true,
+	get: function() {
+		return createHooks;
+	}
+});
+
+//# sourceMappingURL=hooks-K7pTMF2R.cjs.map

package/dist/hooks-K7pTMF2R.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-K7pTMF2R.cjs","names":["useMemo","useState","useRef","useEffect","useCallback"],"sources":["../src/hooks.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\r\nimport type {\r\n  City,\r\n  FlatCity,\r\n  IranCities,\r\n  IranCitiesHooks,\r\n  Province,\r\n  ProvinceCitySelect,\r\n  ProvinceCitySelectOptions,\r\n  ProvinceCityValue,\r\n  ProvinceListItem,\r\n  Query,\r\n  SearchOptions,\r\n  SearchState,\r\n} from './types';\r\n\r\nfunction isEmptyQuery(value: Query | undefined | null): value is undefined | null | '' {\r\n  return value === undefined || value === null || value === '';\r\n}\r\n\r\nconst EMPTY_CITIES: readonly City[] = Object.freeze([]);\r\n\r\nexport function createHooks(api: IranCities): IranCitiesHooks {\r\n  function resolveInitial(initialProvince?: Query, initialCity?: Query): ProvinceCityValue {\r\n    const province = isEmptyQuery(initialProvince) ? undefined : api.getProvince(initialProvince);\r\n    if (isEmptyQuery(initialCity)) return { provinceId: province?.id };\r\n    const city = province ? api.getCity(initialCity, province.id) : api.getCity(initialCity);\r\n    if (!city) return { provinceId: province?.id };\r\n    return { provinceId: city.provinceId, cityId: city.id };\r\n  }\r\n\r\n  function useProvinces(): ProvinceListItem[] {\r\n    return useMemo(() => api.getProvincesList(), []);\r\n  }\r\n\r\n  function useCities(provinceQuery: Query | undefined | null): readonly City[] {\r\n    return useMemo(\r\n      () => (isEmptyQuery(provinceQuery) ? EMPTY_CITIES : api.getCities(provinceQuery)),\r\n      [provinceQuery],\r\n    );\r\n  }\r\n\r\n  function useProvinceCitySelect(options: ProvinceCitySelectOptions = {}): ProvinceCitySelect {\r\n    const { value, onChange, initialProvince, initialCity } = options;\r\n    const [inner, setInner] = useState<ProvinceCityValue>(() => resolveInitial(initialProvince, initialCity));\r\n    const controlled = value !== undefined;\r\n    const current = controlled ? value : inner;\r\n\r\n    const onChangeRef = useRef(onChange);\r\n    useEffect(() => {\r\n      onChangeRef.current = onChange;\r\n    }, [onChange]);\r\n\r\n    const selectedProvince = useMemo(\r\n      () => (current.provinceId === undefined ? undefined : api.getProvinceById(current.provinceId)),\r\n      [current.provinceId],\r\n    );\r\n    const selectedCity = useMemo(() => {\r\n      if (current.cityId === undefined || !selectedProvince) return undefined;\r\n      const city = api.getCityById(current.cityId);\r\n      return city && city.provinceId === selectedProvince.id ? city : undefined;\r\n    }, [current.cityId, selectedProvince]);\r\n\r\n    const provinces = useProvinces();\r\n    const cities = useCities(selectedProvince?.id);\r\n\r\n    const provinceId = selectedProvince?.id;\r\n    const cityId = selectedCity?.id;\r\n\r\n    const commit = useCallback(\r\n      (next: ProvinceCityValue) => {\r\n        if (!controlled) setInner(next);\r\n        onChangeRef.current?.(next);\r\n      },\r\n      [controlled],\r\n    );\r\n\r\n    const setProvince = useCallback(\r\n      (query: Query) => {\r\n        const province = isEmptyQuery(query) ? undefined : api.getProvince(query);\r\n        commit({ provinceId: province?.id, cityId: undefined });\r\n      },\r\n      [commit],\r\n    );\r\n\r\n    const setCity = useCallback(\r\n      (query: Query) => {\r\n        if (provinceId === undefined || isEmptyQuery(query)) {\r\n          commit({ provinceId, cityId: undefined });\r\n          return;\r\n        }\r\n        commit({ provinceId, cityId: api.getCity(query, provinceId)?.id });\r\n      },\r\n      [commit, provinceId],\r\n    );\r\n\r\n    const reset = useCallback(() => commit({}), [commit]);\r\n\r\n    const normalizedValue = useMemo<ProvinceCityValue>(() => ({ provinceId, cityId }), [provinceId, cityId]);\r\n\r\n    return {\r\n      provinces,\r\n      cities,\r\n      province: selectedProvince?.en ?? '',\r\n      city: selectedCity?.en ?? '',\r\n      provinceId,\r\n      cityId,\r\n      value: normalizedValue,\r\n      selectedProvince,\r\n      selectedCity,\r\n      setProvince,\r\n      setCity,\r\n      reset,\r\n    };\r\n  }\r\n\r\n  function useStableOptions(options: SearchOptions | undefined): SearchOptions {\r\n    const { limit, locale, fuzzy, maxDistance, emptyQuery } = options ?? {};\r\n    return useMemo(\r\n      () => ({ limit, locale, fuzzy, maxDistance, emptyQuery }),\r\n      [limit, locale, fuzzy, maxDistance, emptyQuery],\r\n    );\r\n  }\r\n\r\n  function useCitySearch(initialQuery = '', options?: SearchOptions): SearchState<FlatCity> {\r\n    const [query, setQuery] = useState(initialQuery);\r\n    const stable = useStableOptions(options);\r\n    const results = useMemo(() => api.searchCities(query, stable), [query, stable]);\r\n    return { query, setQuery, results };\r\n  }\r\n\r\n  function useProvinceSearch(initialQuery = '', options?: SearchOptions): SearchState<Province> {\r\n    const [query, setQuery] = useState(initialQuery);\r\n    const stable = useStableOptions(options);\r\n    const results = useMemo(() => api.searchProvinces(query, stable), [query, stable]);\r\n    return { query, setQuery, results };\r\n  }\r\n\r\n  return { useProvinces, useCities, useProvinceCitySelect, useCitySearch, useProvinceSearch };\r\n}\r\n"],"mappings":"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"}