@pro6pp/infer-react 0.0.2-beta.9 → 0.1.0-beta.19

package/dist/index.d.cts

@@ -1,14 +1,23 @@
 import React from 'react';
-import { InferConfig, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
-export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, Stage } from '@pro6pp/infer-core';
+import { InferConfig, AddressValue, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
+export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, LanguageCode, 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. */
-    selectItem: (item: InferResult | string) => void;
-    /** Function to load more results. */
+    /** Manually select a specific suggestion. */
+    selectItem: (item: InferResult | string) => boolean;
+    /** 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. */
@@ -47,10 +58,10 @@ interface Pro6PPInferProps extends InferConfig {
      * @default 'No results found'
      */
     noResultsText?: string;
-    /** * The text to show on the load more button.
-     * @default 'Show more results...'
+    /** * The text to show on the bottom loading indicator.
+     * @default 'Loading more...'
      */
-    loadMoreText?: string;
+    loadingText?: string;
     /** A custom render function for the "no results" state. */
     renderNoResults?: (state: InferState) => React.ReactNode;
     /**
@@ -63,6 +74,6 @@ interface Pro6PPInferProps extends InferConfig {
  * A styled React component for Pro6PP Infer API.
  * Includes styling, keyboard navigation, and loading states.
  */
-declare const Pro6PPInfer: React.FC<Pro6PPInferProps>;
+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';
-export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, Stage } from '@pro6pp/infer-core';
+import { InferConfig, AddressValue, InferState, InferCore, InferResult } from '@pro6pp/infer-core';
+export { AddressValue, CountryCode, Fetcher, InferConfig, InferResult, InferState, LanguageCode, 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. */
-    selectItem: (item: InferResult | string) => void;
-    /** Function to load more results. */
+    /** Manually select a specific suggestion. */
+    selectItem: (item: InferResult | string) => boolean;
+    /** 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. */
@@ -47,10 +58,10 @@ interface Pro6PPInferProps extends InferConfig {
      * @default 'No results found'
      */
     noResultsText?: string;
-    /** * The text to show on the load more button.
-     * @default 'Show more results...'
+    /** * The text to show on the bottom loading indicator.
+     * @default 'Loading more...'
      */
-    loadMoreText?: string;
+    loadingText?: string;
     /** A custom render function for the "no results" state. */
     renderNoResults?: (state: InferState) => React.ReactNode;
     /**
@@ -63,6 +74,6 @@ interface Pro6PPInferProps extends InferConfig {
  * A styled React component for Pro6PP Infer API.
  * Includes styling, keyboard navigation, and loading states.
  */
-declare const Pro6PPInfer: React.FC<Pro6PPInferProps>;
+declare const Pro6PPInfer: React.ForwardRefExoticComponent<Pro6PPInferProps & React.RefAttributes<HTMLInputElement>>;
 
-export { Pro6PPInfer, type Pro6PPInferProps, useInfer };
+export { Pro6PPInfer, type Pro6PPInferProps, type UseInferConfig, useInfer };