@pro6pp/infer-react 0.0.2-beta.13 → 0.0.2-beta.15

package/dist/index.cjs

@@ -47,7 +47,8 @@ var DEFAULTS = {
   MAX_RETRIES: 0
 };
 var PATTERNS = {
-  DIGITS_1_3: /^[0-9]{1,3}$/
+  DIGITS_1_3: /^[0-9]{1,3}$/,
+  STREET_NUMBER_PREFIX: /^(\d+)\s*,\s*$/
 };
 var INITIAL_STATE = {
   query: "",
@@ -56,6 +57,7 @@ var INITIAL_STATE = {
   streets: [],
   suggestions: [],
   isValid: false,
+  value: null,
   isError: false,
   isLoading: false,
   hasMore: false,
@@ -111,9 +113,11 @@ var InferCore = class {
     this.updateState({
       query: value,
       isValid: false,
+      value: null,
       isLoading: !!value.trim(),
       selectedSuggestionIndex: -1,
-      hasMore: false
+      hasMore: false,
+      stage: isEditingFinal ? null : this.state.stage
     });
     if (isEditingFinal) {
       this.onSelect(null);
@@ -228,6 +232,7 @@ var InferCore = class {
       cities: [],
       streets: [],
       isValid: true,
+      value: value || null,
       stage: "final",
       hasMore: false
     });
@@ -243,10 +248,20 @@ var InferCore = class {
       } else {
         const prefix = this.getQueryPrefix(query);
         const shouldAddSubtitle = !prefix || !prefix.includes(subtitle);
+        let effectivePrefix = prefix;
+        if (prefix && subtitle) {
+          const prefixNumMatch = prefix.match(PATTERNS.STREET_NUMBER_PREFIX);
+          if (prefixNumMatch) {
+            const num = prefixNumMatch[1];
+            if (subtitle.startsWith(num)) {
+              effectivePrefix = "";
+            }
+          }
+        }
         if (shouldAddSubtitle) {
-          nextQuery = prefix ? `${prefix} ${text}, ${subtitle}, ` : `${text}, ${subtitle}, `;
+          nextQuery = effectivePrefix ? `${effectivePrefix} ${text}, ${subtitle}, ` : `${text}, ${subtitle}, `;
         } else {
-          nextQuery = prefix ? `${prefix} ${text}, ` : `${text}, `;
+          nextQuery = effectivePrefix ? `${effectivePrefix} ${text}, ` : `${text}, `;
         }
       }
       this.updateQueryAndFetch(nextQuery);
@@ -283,10 +298,12 @@ var InferCore = class {
     const currentSignal = this.abortController?.signal;
     const baseUrl = this.explicitApiUrl ? this.explicitApiUrl : `${DEFAULTS.API_URL}/infer/${this.country.toLowerCase()}`;
     const params = new URLSearchParams({
-      country: this.country.toLowerCase(),
       query: text,
       limit: this.currentLimit.toString()
     });
+    if (this.explicitApiUrl) {
+      params.append("country", this.country.toLowerCase());
+    }
     if (this.authKey) {
       params.set("authKey", this.authKey);
     }
@@ -339,7 +356,11 @@ var InferCore = class {
     if (data.stage === "mixed") {
       newState.cities = data.cities || [];
       newState.streets = data.streets || [];
-      newState.suggestions = [];
+      if (newState.cities?.length === 0 && newState.streets?.length === 0) {
+        newState.suggestions = uniqueSuggestions;
+      } else {
+        newState.suggestions = [];
+      }
     } else {
       newState.suggestions = uniqueSuggestions;
       newState.cities = [];
@@ -352,8 +373,16 @@ var InferCore = class {
     }
   }
   updateQueryAndFetch(nextQuery) {
-    this.updateState({ query: nextQuery, suggestions: [], cities: [], streets: [] });
-    this.updateState({ isLoading: true, isValid: false, hasMore: false });
+    this.updateState({
+      query: nextQuery,
+      suggestions: [],
+      cities: [],
+      streets: [],
+      isValid: false,
+      value: null,
+      isLoading: true,
+      hasMore: false
+    });
     this.debouncedFetch(nextQuery);
   }
   replaceLastSegment(fullText, newSegment) {
@@ -642,7 +671,18 @@ var HighlightedText = ({ text, query }) => {
   ));
 };
 function useInfer(config) {
-  const [state, setState] = (0, import_react.useState)(INITIAL_STATE);
+  const [state, setState] = (0, import_react.useState)(() => {
+    if (config.initialValue) {
+      return {
+        ...INITIAL_STATE,
+        value: config.initialValue,
+        query: `${config.initialValue.street} ${config.initialValue.street_number}, ${config.initialValue.city}`,
+        isValid: true,
+        stage: "final"
+      };
+    }
+    return INITIAL_STATE;
+  });
   const callbacksRef = (0, import_react.useRef)({
     onStateChange: config.onStateChange,
     onSelect: config.onSelect
@@ -654,7 +694,7 @@ function useInfer(config) {
     };
   }, [config.onStateChange, config.onSelect]);
   const core = (0, import_react.useMemo)(() => {
-    return new InferCore({
+    const instance = new InferCore({
       ...config,
       onStateChange: (newState) => {
         setState({ ...newState });
@@ -664,6 +704,12 @@ function useInfer(config) {
         callbacksRef.current.onSelect?.(selection);
       }
     });
+    if (config.initialValue) {
+      const address = config.initialValue;
+      const label = `${address.street} ${address.street_number}, ${address.city}`;
+      instance.selectItem({ label, value: address });
+    }
+    return instance;
   }, [
     config.country,
     config.authKey,
@@ -671,10 +717,16 @@ function useInfer(config) {
     config.fetcher,
     config.limit,
     config.debounceMs,
-    config.maxRetries
+    config.maxRetries,
+    config.initialValue
   ]);
+  const setValue = (address) => {
+    if (!address) return;
+    const label = `${address.street} ${address.street_number}, ${address.city}`;
+    core.selectItem({ label, value: address });
+  };
   return {
-    /** The current UI state (suggestions, loading status, query, etc.). */
+    /** The current UI state (suggestions, loading status, query, value, etc.). */
     state,
     /** The raw InferCore instance for manual control. */
     core,
@@ -684,9 +736,11 @@ function useInfer(config) {
       onChange: (e) => core.handleInput(e.target.value),
       onKeyDown: (e) => core.handleKeyDown(e)
     },
-    /** Function to manually select a specific suggestion. */
+    /** Manually select a specific suggestion. */
     selectItem: (item) => core.selectItem(item),
-    /** Function to load more results. */
+    /** Programmatically set the address value. */
+    setValue,
+    /** Load more results. */
     loadMore: () => core.loadMore()
   };
 }

package/dist/index.d.cts

@@ -1,14 +1,23 @@
 import React from 'react';
-import { InferConfig, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
+import { InferConfig, AddressValue, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
 export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, Stage } from '@pro6pp/infer-core';
 
+/**
+ * Extended configuration for the React hook.
+ */
+interface UseInferConfig extends InferConfig {
+    /**
+     * Initial address value to pre-fill the state with.
+     */
+    initialValue?: AddressValue;
+}
 /**
  * A headless React hook that provides the logic for address search using the Infer API.
  * @param config The engine configuration (authKey, country, etc.).
  * @returns An object containing the current state, the core instance, and pre-bound input props.
  */
-declare function useInfer(config: InferConfig): {
-    /** The current UI state (suggestions, loading status, query, etc.). */
+declare function useInfer(config: UseInferConfig): {
+    /** The current UI state (suggestions, loading status, query, value, etc.). */
     state: InferState;
     /** The raw InferCore instance for manual control. */
     core: InferCore;
@@ -18,15 +27,17 @@ declare function useInfer(config: InferConfig): {
         onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
         onKeyDown: (e: React.KeyboardEvent<HTMLInputElement>) => void;
     };
-    /** Function to manually select a specific suggestion. */
+    /** Manually select a specific suggestion. */
     selectItem: (item: InferResult | string) => boolean;
-    /** Function to load more results. */
+    /** Programmatically set the address value. */
+    setValue: (address: AddressValue) => void;
+    /** Load more results. */
     loadMore: () => void;
 };
 /**
  * Props for the Pro6PPInfer component.
  */
-interface Pro6PPInferProps extends InferConfig {
+interface Pro6PPInferProps extends UseInferConfig {
     /** Optional CSS class for the wrapper div. */
     className?: string;
     /** Optional inline styles for the wrapper div. */
@@ -65,4 +76,4 @@ interface Pro6PPInferProps extends InferConfig {
  */
 declare const Pro6PPInfer: React.ForwardRefExoticComponent<Pro6PPInferProps & React.RefAttributes<HTMLInputElement>>;
 
-export { Pro6PPInfer, type Pro6PPInferProps, useInfer };
+export { Pro6PPInfer, type Pro6PPInferProps, type UseInferConfig, useInfer };

package/dist/index.d.ts

@@ -1,14 +1,23 @@
 import React from 'react';
-import { InferConfig, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
+import { InferConfig, AddressValue, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
 export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, Stage } from '@pro6pp/infer-core';
 
+/**
+ * Extended configuration for the React hook.
+ */
+interface UseInferConfig extends InferConfig {
+    /**
+     * Initial address value to pre-fill the state with.
+     */
+    initialValue?: AddressValue;
+}
 /**
  * A headless React hook that provides the logic for address search using the Infer API.
  * @param config The engine configuration (authKey, country, etc.).
  * @returns An object containing the current state, the core instance, and pre-bound input props.
  */
-declare function useInfer(config: InferConfig): {
-    /** The current UI state (suggestions, loading status, query, etc.). */
+declare function useInfer(config: UseInferConfig): {
+    /** The current UI state (suggestions, loading status, query, value, etc.). */
     state: InferState;
     /** The raw InferCore instance for manual control. */
     core: InferCore;
@@ -18,15 +27,17 @@ declare function useInfer(config: InferConfig): {
         onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
         onKeyDown: (e: React.KeyboardEvent<HTMLInputElement>) => void;
     };
-    /** Function to manually select a specific suggestion. */
+    /** Manually select a specific suggestion. */
     selectItem: (item: InferResult | string) => boolean;
-    /** Function to load more results. */
+    /** Programmatically set the address value. */
+    setValue: (address: AddressValue) => void;
+    /** Load more results. */
     loadMore: () => void;
 };
 /**
  * Props for the Pro6PPInfer component.
  */
-interface Pro6PPInferProps extends InferConfig {
+interface Pro6PPInferProps extends UseInferConfig {
     /** Optional CSS class for the wrapper div. */
     className?: string;
     /** Optional inline styles for the wrapper div. */
@@ -65,4 +76,4 @@ interface Pro6PPInferProps extends InferConfig {
  */
 declare const Pro6PPInfer: React.ForwardRefExoticComponent<Pro6PPInferProps & React.RefAttributes<HTMLInputElement>>;
 
-export { Pro6PPInfer, type Pro6PPInferProps, useInfer };
+export { Pro6PPInfer, type Pro6PPInferProps, type UseInferConfig, useInfer };

package/dist/index.js

@@ -21,7 +21,8 @@ var DEFAULTS = {
   MAX_RETRIES: 0
 };
 var PATTERNS = {
-  DIGITS_1_3: /^[0-9]{1,3}$/
+  DIGITS_1_3: /^[0-9]{1,3}$/,
+  STREET_NUMBER_PREFIX: /^(\d+)\s*,\s*$/
 };
 var INITIAL_STATE = {
   query: "",
@@ -30,6 +31,7 @@ var INITIAL_STATE = {
   streets: [],
   suggestions: [],
   isValid: false,
+  value: null,
   isError: false,
   isLoading: false,
   hasMore: false,
@@ -85,9 +87,11 @@ var InferCore = class {
     this.updateState({
       query: value,
       isValid: false,
+      value: null,
       isLoading: !!value.trim(),
       selectedSuggestionIndex: -1,
-      hasMore: false
+      hasMore: false,
+      stage: isEditingFinal ? null : this.state.stage
     });
     if (isEditingFinal) {
       this.onSelect(null);
@@ -202,6 +206,7 @@ var InferCore = class {
       cities: [],
       streets: [],
       isValid: true,
+      value: value || null,
       stage: "final",
       hasMore: false
     });
@@ -217,10 +222,20 @@ var InferCore = class {
       } else {
         const prefix = this.getQueryPrefix(query);
         const shouldAddSubtitle = !prefix || !prefix.includes(subtitle);
+        let effectivePrefix = prefix;
+        if (prefix && subtitle) {
+          const prefixNumMatch = prefix.match(PATTERNS.STREET_NUMBER_PREFIX);
+          if (prefixNumMatch) {
+            const num = prefixNumMatch[1];
+            if (subtitle.startsWith(num)) {
+              effectivePrefix = "";
+            }
+          }
+        }
         if (shouldAddSubtitle) {
-          nextQuery = prefix ? `${prefix} ${text}, ${subtitle}, ` : `${text}, ${subtitle}, `;
+          nextQuery = effectivePrefix ? `${effectivePrefix} ${text}, ${subtitle}, ` : `${text}, ${subtitle}, `;
         } else {
-          nextQuery = prefix ? `${prefix} ${text}, ` : `${text}, `;
+          nextQuery = effectivePrefix ? `${effectivePrefix} ${text}, ` : `${text}, `;
         }
       }
       this.updateQueryAndFetch(nextQuery);
@@ -257,10 +272,12 @@ var InferCore = class {
     const currentSignal = this.abortController?.signal;
     const baseUrl = this.explicitApiUrl ? this.explicitApiUrl : `${DEFAULTS.API_URL}/infer/${this.country.toLowerCase()}`;
     const params = new URLSearchParams({
-      country: this.country.toLowerCase(),
       query: text,
       limit: this.currentLimit.toString()
     });
+    if (this.explicitApiUrl) {
+      params.append("country", this.country.toLowerCase());
+    }
     if (this.authKey) {
       params.set("authKey", this.authKey);
     }
@@ -313,7 +330,11 @@ var InferCore = class {
     if (data.stage === "mixed") {
       newState.cities = data.cities || [];
       newState.streets = data.streets || [];
-      newState.suggestions = [];
+      if (newState.cities?.length === 0 && newState.streets?.length === 0) {
+        newState.suggestions = uniqueSuggestions;
+      } else {
+        newState.suggestions = [];
+      }
     } else {
       newState.suggestions = uniqueSuggestions;
       newState.cities = [];
@@ -326,8 +347,16 @@ var InferCore = class {
     }
   }
   updateQueryAndFetch(nextQuery) {
-    this.updateState({ query: nextQuery, suggestions: [], cities: [], streets: [] });
-    this.updateState({ isLoading: true, isValid: false, hasMore: false });
+    this.updateState({
+      query: nextQuery,
+      suggestions: [],
+      cities: [],
+      streets: [],
+      isValid: false,
+      value: null,
+      isLoading: true,
+      hasMore: false
+    });
     this.debouncedFetch(nextQuery);
   }
   replaceLastSegment(fullText, newSegment) {
@@ -616,7 +645,18 @@ var HighlightedText = ({ text, query }) => {
   ));
 };
 function useInfer(config) {
-  const [state, setState] = useState(INITIAL_STATE);
+  const [state, setState] = useState(() => {
+    if (config.initialValue) {
+      return {
+        ...INITIAL_STATE,
+        value: config.initialValue,
+        query: `${config.initialValue.street} ${config.initialValue.street_number}, ${config.initialValue.city}`,
+        isValid: true,
+        stage: "final"
+      };
+    }
+    return INITIAL_STATE;
+  });
   const callbacksRef = useRef({
     onStateChange: config.onStateChange,
     onSelect: config.onSelect
@@ -628,7 +668,7 @@ function useInfer(config) {
     };
   }, [config.onStateChange, config.onSelect]);
   const core = useMemo(() => {
-    return new InferCore({
+    const instance = new InferCore({
       ...config,
       onStateChange: (newState) => {
         setState({ ...newState });
@@ -638,6 +678,12 @@ function useInfer(config) {
         callbacksRef.current.onSelect?.(selection);
       }
     });
+    if (config.initialValue) {
+      const address = config.initialValue;
+      const label = `${address.street} ${address.street_number}, ${address.city}`;
+      instance.selectItem({ label, value: address });
+    }
+    return instance;
   }, [
     config.country,
     config.authKey,
@@ -645,10 +691,16 @@ function useInfer(config) {
     config.fetcher,
     config.limit,
     config.debounceMs,
-    config.maxRetries
+    config.maxRetries,
+    config.initialValue
   ]);
+  const setValue = (address) => {
+    if (!address) return;
+    const label = `${address.street} ${address.street_number}, ${address.city}`;
+    core.selectItem({ label, value: address });
+  };
   return {
-    /** The current UI state (suggestions, loading status, query, etc.). */
+    /** The current UI state (suggestions, loading status, query, value, etc.). */
     state,
     /** The raw InferCore instance for manual control. */
     core,
@@ -658,9 +710,11 @@ function useInfer(config) {
       onChange: (e) => core.handleInput(e.target.value),
       onKeyDown: (e) => core.handleKeyDown(e)
     },
-    /** Function to manually select a specific suggestion. */
+    /** Manually select a specific suggestion. */
     selectItem: (item) => core.selectItem(item),
-    /** Function to load more results. */
+    /** Programmatically set the address value. */
+    setValue,
+    /** Load more results. */
     loadMore: () => core.loadMore()
   };
 }

package/package.json

@@ -20,7 +20,7 @@
     "url": "https://github.com/pro6pp/infer-sdk/issues"
   },
   "sideEffects": false,
-  "version": "0.0.2-beta.13",
+  "version": "0.0.2-beta.15",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -46,7 +46,7 @@
     "react": ">=16"
   },
   "dependencies": {
-    "@pro6pp/infer-core": "0.0.2-beta.11"
+    "@pro6pp/infer-core": "0.0.2-beta.13"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",