@pro6pp/infer-core 0.0.2-beta.0 → 0.0.2-beta.10

package/README.md

@@ -1,21 +1,38 @@
-# @pro6pp/infer-core
+# Pro6PP Infer Core
 
 The headless logic engine behind the Pro6PP Infer SDKs.
 Use this package if you are building a custom integration for a framework, or if you need to run Infer in a non-standard environment.
 
-> **Note:** If you are using React, use [`@pro6pp/infer-react`](../react) instead.
-> If you are using plain HTML/JS, use [`@pro6pp/infer-js`](../js).
+> **Note:** Use [`@pro6pp/infer-react`](https://www.npmjs.com/package/@pro6pp/infer-react) for React applications. For all other frameworks or Vanilla JS, use [`@pro6pp/infer-js`](https://www.npmjs.com/package/@pro6pp/infer-js).
 
 ## Installation
 
+### Package Manager
+
 ```bash
 npm install @pro6pp/infer-core
 ```
 
+### CDN
+
+You can also load the Core SDK directly in the browser via a CDN:
+
+```html
+<script src="https://unpkg.com/@pro6pp/infer-core"></script>
+```
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@pro6pp/infer-core"></script>
+```
+
+When loaded via a script tag, the library is available through the global `Pro6PPCore` object.
+
 ## Usage
 
 The core logic is exposed via the `InferCore` class. It manages the API requests, state and parses input.
 
+### Using ES Modules
+
 ```typescript
 import { InferCore } from '@pro6pp/infer-core';
 
@@ -23,17 +40,44 @@ const core = new InferCore({
   authKey: 'YOUR_AUTH_KEY',
   country: 'NL',
   onStateChange: (state) => {
-    console.log('Current Suggestions:', state.suggestions);
-    console.log('Is Loading:', state.isLoading);
+    // suggestions, isLoading, isValid, selectedSuggestionIndex, etc.
+    console.log('Current State:', state);
   },
   onSelect: (result) => {
     console.log('User selected:', result);
   },
 });
+```
+
+### Using via script tag (global)
+
+```typescript
+const core = new Pro6PPCore.InferCore({
+  authKey: 'YOUR_AUTH_KEY',
+  country: 'NL',
+  onSelect: (result) => console.log(result),
+});
+```
+
+### Event handling
+
+Once initialized, pass your input and keyboard events to the core instance to manage state.
+
+```typescript
+const input = document.querySelector('#my-input');
+
+// pass input events to the core
+input.addEventListener('input', (e) => {
+  core.handleInput(e.target.value);
+});
 
-// feed it input events, e.g. via an <input>
-core.handleInput('Amsterdam');
+// pass keyboard events
+input.addEventListener('keydown', (e) => {
+  core.handleKeyDown(e);
+});
 
-// handle selections when user clicks a suggestion in your dropdown
-core.selectItem(suggestionObject);
+// handle clicks
+function onSuggestionClick(item) {
+  core.selectItem(item);
+}
 ```

package/dist/index.cjs

@@ -0,0 +1,180 @@
+"use strict";var h=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var C=(o,t,e)=>t in o?h(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e;var T=(o,t)=>{for(var e in t)h(o,e,{get:t[e],enumerable:!0})},L=(o,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of v(t))!I.call(o,r)&&r!==e&&h(o,r,{get:()=>t[r],enumerable:!(i=y(t,r))||i.enumerable});return o};var A=o=>L(h({},"__esModule",{value:!0}),o);var l=(o,t,e)=>C(o,typeof t!="symbol"?t+"":t,e);var F={};T(F,{DEFAULT_STYLES:()=>x,INITIAL_STATE:()=>f,InferCore:()=>m,getHighlightSegments:()=>w});module.exports=A(F);var c={API_URL:"https://api.pro6pp.nl/v2",LIMIT:20,DEBOUNCE_MS:150,MIN_DEBOUNCE_MS:50,MAX_RETRIES:0},b={DIGITS_1_3:/^[0-9]{1,3}$/},f={query:"",stage:null,cities:[],streets:[],suggestions:[],isValid:!1,isError:!1,isLoading:!1,hasMore:!1,selectedSuggestionIndex:-1},m=class{constructor(t){l(this,"country");l(this,"authKey");l(this,"explicitApiUrl");l(this,"baseLimit");l(this,"currentLimit");l(this,"maxRetries");l(this,"fetcher");l(this,"onStateChange");l(this,"onSelect");l(this,"state");l(this,"abortController",null);l(this,"debouncedFetch");this.country=t.country,this.authKey=t.authKey,this.explicitApiUrl=t.apiUrl,this.baseLimit=t.limit||c.LIMIT,this.currentLimit=this.baseLimit;let e=t.maxRetries!==void 0?t.maxRetries:c.MAX_RETRIES;this.maxRetries=Math.max(0,Math.min(e,10)),this.fetcher=t.fetcher||((s,a)=>fetch(s,a)),this.onStateChange=t.onStateChange||(()=>{}),this.onSelect=t.onSelect||(()=>{}),this.state={...f};let i=t.debounceMs!==void 0?t.debounceMs:c.DEBOUNCE_MS,r=Math.max(i,c.MIN_DEBOUNCE_MS);this.debouncedFetch=this.debounce(s=>this.executeFetch(s),r)}handleInput(t){this.currentLimit=this.baseLimit;let e=this.state.stage==="final"&&t!==this.state.query;this.updateState({query:t,isValid:!1,isLoading:!!t.trim(),selectedSuggestionIndex:-1,hasMore:!1}),e&&this.onSelect(null),this.debouncedFetch(t)}loadMore(){this.state.isLoading||(this.currentLimit+=this.baseLimit,this.updateState({isLoading:!0}),this.executeFetch(this.state.query))}handleKeyDown(t){let e=t.target;if(!e)return;let i=this.state.cities.length+this.state.streets.length+this.state.suggestions.length;if(i>0){if(t.key==="ArrowDown"){t.preventDefault();let s=this.state.selectedSuggestionIndex+1;s>=i&&(s=0),this.updateState({selectedSuggestionIndex:s});return}if(t.key==="ArrowUp"){t.preventDefault();let s=this.state.selectedSuggestionIndex-1;s<0&&(s=i-1),this.updateState({selectedSuggestionIndex:s});return}if(t.key==="Enter"&&this.state.selectedSuggestionIndex>=0){t.preventDefault();let a=[...this.state.cities,...this.state.streets,...this.state.suggestions][this.state.selectedSuggestionIndex];a&&(this.selectItem(a),this.updateState({selectedSuggestionIndex:-1}));return}}let r=e.value;if(t.key===" "&&this.shouldAutoInsertComma(r)){t.preventDefault();let s=`${r.trim()}, `;this.updateQueryAndFetch(s)}}selectItem(t){this.debouncedFetch.cancel(),this.abortController&&this.abortController.abort();let e=typeof t=="string"?t:t.label,i=e;typeof t!="string"&&typeof t.value=="string"&&(i=t.value);let r=typeof t!="string"&&typeof t.value=="object"?t.value:void 0,s=!!r&&Object.keys(r).length>0;if(this.state.stage==="final"||s){let p=e;if(r&&Object.keys(r).length>0){let{street:u,street_number:n,city:d,addition:g}=r;if(u&&n&&d){let S=g?` ${g}`:"";p=`${u} ${n}${S}, ${d}`}}return this.finishSelection(p,r),!0}let a=typeof t!="string"?t.subtitle:null;return this.processSelection(i,a),!1}shouldAutoInsertComma(t){if(!t.includes(",")&&b.DIGITS_1_3.test(t.trim()))return!0;if(this.state.stage==="street_number"){let i=this.getCurrentFragment(t);return b.DIGITS_1_3.test(i)}return!1}finishSelection(t,e){this.updateState({query:t,suggestions:[],cities:[],streets:[],isValid:!0,stage:"final",hasMore:!1}),this.onSelect(e||t)}processSelection(t,e){let{stage:i,query:r}=this.state,s=r;if(e&&(i==="city"||i==="street"||i==="mixed")){if(i==="city")s=`${e}, ${t}, `;else{let n=this.getQueryPrefix(r);!n||!n.includes(e)?s=n?`${n} ${t}, ${e}, `:`${t}, ${e}, `:s=n?`${n} ${t}, `:`${t}, `}this.updateQueryAndFetch(s);return}if(i==="direct"||i==="addition"){this.finishSelection(t);return}!r.includes(",")&&(i==="city"||i==="street"||i==="street_number_first")?s=`${t}, `:(s=this.replaceLastSegment(r,t),i!=="street_number"&&(s+=", ")),this.updateQueryAndFetch(s)}executeFetch(t,e=0){let i=(t||"").toString();if(!i.trim()){this.abortController?.abort(),this.resetState();return}e===0&&(this.updateState({isError:!1}),this.abortController&&this.abortController.abort(),this.abortController=new AbortController);let r=this.abortController?.signal,s=this.explicitApiUrl?this.explicitApiUrl:`${c.API_URL}/infer/${this.country.toLowerCase()}`,a=new URLSearchParams({country:this.country.toLowerCase(),query:i,limit:this.currentLimit.toString()});this.authKey&&a.set("authKey",this.authKey);let p=s.includes("?")?"&":"?",u=`${s}${p}${a.toString()}`;this.fetcher(u,{signal:r}).then(n=>{if(!n.ok){if(e<this.maxRetries&&(n.status>=500||n.status===429))return this.retry(t,e,r);throw new Error("Network error")}return n.json()}).then(n=>{n&&this.mapResponseToState(n)}).catch(n=>{if(n.name!=="AbortError"){if(e<this.maxRetries)return this.retry(t,e,r);this.updateState({isError:!0,isLoading:!1})}})}retry(t,e,i){if(i?.aborted)return;let r=Math.pow(2,e)*200;setTimeout(()=>{i?.aborted||this.executeFetch(t,e+1)},r)}mapResponseToState(t){let e={stage:t.stage,isLoading:!1},i=t.suggestions||[],r=[],s=new Set;for(let p of i){let u=`${p.label}|${p.subtitle||""}|${JSON.stringify(p.value||{})}`;s.has(u)||(s.add(u),r.push(p))}let a=r.length+(t.cities?.length||0)+(t.streets?.length||0);e.hasMore=a>=this.currentLimit,t.stage==="mixed"?(e.cities=t.cities||[],e.streets=t.streets||[],e.suggestions=[]):(e.suggestions=r,e.cities=[],e.streets=[]),e.isValid=t.stage==="final",this.updateState(e),e.isValid&&r.length===1&&this.selectItem(r[0])}updateQueryAndFetch(t){this.updateState({query:t,suggestions:[],cities:[],streets:[]}),this.updateState({isLoading:!0,isValid:!1,hasMore:!1}),this.debouncedFetch(t)}replaceLastSegment(t,e){let i=t.lastIndexOf(",");return i===-1?e:`${t.slice(0,i+1)} ${e}`.trim()}getQueryPrefix(t){let e=t.lastIndexOf(",");return e===-1?"":t.slice(0,e+1).trimEnd()}getCurrentFragment(t){return(t.split(",").slice(-1)[0]??"").trim()}resetState(){this.updateState({...f,query:this.state.query})}updateState(t){this.state={...this.state,...t},this.onStateChange(this.state)}debounce(t,e){let i,r=(...s)=>{i&&clearTimeout(i),i=setTimeout(()=>t.apply(this,s),e)};return r.cancel=()=>{i&&(clearTimeout(i),i=void 0)},r}};function w(o,t){if(!t||!o)return[{text:o,match:!1}];let e=[],i=o.toLowerCase(),r=t.toLowerCase(),s=0,a=0;for(let n=0;n<o.length;n++){if(!(s<t.length&&i[n]===r[s]))continue;n>a&&e.push({text:o.slice(a,n),match:!1}),e.push({text:o[n],match:!0}),s++,a=n+1}return a<o.length&&e.push({text:o.slice(a),match:!1}),s===t.length?e:[{text:o,match:!1}]}var x=`
+  .pro6pp-wrapper {
+    position: relative;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    box-sizing: border-box;
+    width: 100%;
+    -webkit-tap-highlight-color: transparent;
+  }
+  .pro6pp-wrapper * {
+    box-sizing: border-box;
+  }
+  .pro6pp-input {
+    width: 100%;
+    padding: 12px 14px;
+    padding-right: 48px;
+    border: 1px solid #e0e0e0;
+    border-radius: 8px;
+    font-size: 16px;
+    line-height: 1.5;
+    appearance: none;
+    transition: border-color 0.2s, box-shadow 0.2s;
+  }
+  .pro6pp-input:focus {
+    outline: none;
+    border-color: #3b82f6;
+    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+  }
+
+  .pro6pp-input-addons {
+    position: absolute;
+    right: 4px;
+    top: 0;
+    bottom: 0;
+    display: flex;
+    align-items: center;
+    pointer-events: none;
+  }
+  .pro6pp-input-addons > * {
+    pointer-events: auto;
+  }
+
+  .pro6pp-clear-button {
+    background: none;
+    border: none;
+    width: 40px;
+    height: 40px;
+    cursor: pointer;
+    color: #a3a3a3;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: 50%;
+    transition: color 0.2s, background-color 0.2s;
+    touch-action: manipulation;
+  }
+
+  @media (hover: hover) {
+    .pro6pp-clear-button:hover {
+      color: #1f2937;
+      background-color: #f3f4f6;
+    }
+  }
+
+  .pro6pp-clear-button:active {
+    background-color: #f3f4f6;
+  }
+
+  .pro6pp-loader {
+    width: 20px;
+    height: 20px;
+    margin: 0 8px;
+    border: 2px solid #e0e0e0;
+    border-top-color: #6b7280;
+    border-radius: 50%;
+    animation: pro6pp-spin 0.6s linear infinite;
+    flex-shrink: 0;
+  }
+
+  .pro6pp-dropdown {
+    position: absolute;
+    top: 100%;
+    left: 0;
+    right: 0;
+    margin-top: 4px;
+    background: #ffffff;
+    border: 1px solid #e5e7eb;
+    border-radius: 6px;
+    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+    z-index: 9999;
+    padding: 0;
+    max-height: 260px;
+    overflow-y: auto;
+    display: flex;
+    flex-direction: column;
+  }
+
+  @media (max-height: 500px) {
+    .pro6pp-dropdown {
+      max-height: 140px;
+    }
+  }
+
+  .pro6pp-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    width: 100%;
+  }
+
+  .pro6pp-item {
+    padding: 12px 14px;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    font-size: 14px;
+    color: #374151;
+    border-bottom: 1px solid #f3f4f6;
+    transition: background-color 0.1s;
+    flex-shrink: 0;
+  }
+
+  .pro6pp-item:last-child {
+    border-bottom: none;
+  }
+
+  @media (hover: hover) {
+    .pro6pp-item:hover, .pro6pp-item--active {
+      background-color: #f9fafb;
+    }
+  }
+
+  .pro6pp-item:active {
+    background-color: #f3f4f6;
+  }
+
+  .pro6pp-item__label {
+    font-weight: 500;
+    flex-shrink: 0;
+  }
+  .pro6pp-item__subtitle {
+    font-size: 14px;
+    color: #6b7280;
+    flex-grow: 1;
+  }
+  .pro6pp-item__chevron {
+    color: #d1d5db;
+    display: flex;
+    align-items: center;
+    margin-left: auto;
+  }
+
+  .pro6pp-no-results {
+    padding: 24px 16px;
+    color: #6b7280;
+    font-size: 15px;
+    text-align: center;
+  }
+
+  .pro6pp-load-more {
+    width: 100%;
+    padding: 14px;
+    background: #f9fafb;
+    border: none;
+    border-top: 1px solid #e0e0e0;
+    color: #3b82f6;
+    font-size: 14px;
+    font-weight: 600;
+    cursor: pointer;
+    flex-shrink: 0;
+    touch-action: manipulation;
+  }
+
+  .pro6pp-load-more:active {
+    background-color: #f3f4f6;
+  }
+
+  @keyframes pro6pp-spin {
+    to { transform: rotate(360deg); }
+  }
+`;0&&(module.exports={DEFAULT_STYLES,INITIAL_STATE,InferCore,getHighlightSegments});

package/dist/index.d.cts

@@ -0,0 +1,226 @@
+/**
+ * Supported ISO 3166-1 alpha-2 country codes.
+ */
+type CountryCode = 'NL' | 'DE';
+/**
+ * The current step in the address inference process.
+ * - `empty`: No input yet.
+ * - `mixed`: User is prompted to choose between cities and streets.
+ * - `street`: User is selecting a street.
+ * - `city`: User is selecting a city.
+ * - `postcode`: User is entering a postcode.
+ * - `street_number`: User is entering a street number.
+ * - `street_number_first`: Specialized mode where number is entered before street.
+ * - `addition`: Selecting a street number addition (e.g., 'A', 'III').
+ * - `direct`: Direct address hit (often via postcode).
+ * - `final`: A complete, valid address has been identified.
+ */
+type Stage = 'empty' | 'mixed' | 'street' | 'city' | 'postcode' | 'street_number' | 'street_number_first' | 'addition' | 'direct' | 'final';
+/**
+ * The standardized address object returned upon a successful final selection.
+ */
+interface AddressValue {
+    /** The name of the street. */
+    street: string;
+    /** The name of the city/locality. */
+    city: string;
+    /** The street number. */
+    street_number?: string | number;
+    /** The postal code. */
+    postcode?: string;
+    /** The street number addition or suffix. */
+    addition?: string;
+    /** Allow for extra fields if API expands. */
+    [key: string]: unknown;
+}
+/**
+ * A single item in the suggestion list.
+ */
+interface InferResult {
+    /** The text to display in the UI (e.g. "Main Street"). */
+    label: string;
+    /** The actual address data.
+     * Only present if this result completes an address or represents a specific entity.
+     */
+    value?: AddressValue | string;
+    /** Secondary information (e.g., city name when suggesting a street). */
+    subtitle?: string | null;
+    /** Number of underlying results found for this suggestion. */
+    count?: number | string;
+}
+/**
+ * The complete UI state managed by InferCore.
+ */
+interface InferState {
+    /** The current text value of the search input. */
+    query: string;
+    /** The current logical stage of the address lookup. */
+    stage: Stage | null;
+    /** List of city suggestions (used in `mixed` stage). */
+    cities: InferResult[];
+    /** List of street suggestions (used in `mixed` stage). */
+    streets: InferResult[];
+    /** General list of suggestions for the current stage. */
+    suggestions: InferResult[];
+    /** Flag indicating if the current selection is a complete, valid address. */
+    isValid: boolean;
+    /** Flag indicating if the last API request failed. */
+    isError: boolean;
+    /** Flag indicating if a network request is currently in progress. */
+    isLoading: boolean;
+    /** Flag indicating if more results are available to load. */
+    hasMore: boolean;
+    /**
+     * The index of the currently highlighted suggestion.
+     * - `0` to `n`: An item is highlighted via keyboard navigation.
+     * - `-1`: No item is highlighted.
+     */
+    selectedSuggestionIndex: number;
+}
+/**
+ * Custom fetch implementation, compatible with the Web Fetch API.
+ * Useful for Node.js environments or proxying requests.
+ */
+type Fetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Configuration options for the Infer engine.
+ */
+interface InferConfig {
+    /**
+     * Your Pro6PP Authorization Key.
+     * Optional if using a proxy.
+     */
+    authKey?: string;
+    /**
+     * The country to perform address lookups in.
+     */
+    country: CountryCode;
+    /**
+     * * If provided, this URL is used as the API endpoint (query params will be appended).
+     * * If not provided, the SDK defaults to 'https://api.pro6pp.nl/v2/infer/{country}'.
+     */
+    apiUrl?: string;
+    /**
+     * Custom fetch implementation for network requests.
+     * @default window.fetch
+     */
+    fetcher?: Fetcher;
+    /**
+     * Number of suggestions to request per batch.
+     * @default 20
+     */
+    limit?: number;
+    /**
+     * The delay in milliseconds before performing the API search.
+     * Note: A lower bound of 50ms is enforced to protect API stability.
+     * @default 150
+     */
+    debounceMs?: number;
+    /**
+     * Maximum number of retry attempts for transient network errors.
+     * Valid range: 0 to 10.
+     * @default 0
+     */
+    maxRetries?: number;
+    /**
+     * Callback triggered whenever the internal state (suggestions, loading status, etc.) updates.
+     */
+    onStateChange?: (state: InferState) => void;
+    /**
+     * Callback triggered when a user selects an item.
+     * If the address is complete, returns an `AddressValue` object.
+     * If the selection is partial, returns a `string`.
+     */
+    onSelect?: (selection: AddressValue | string | null) => void;
+}
+/**
+ * Represents a segment of text that should be highlighted or left plain.
+ */
+interface HighlightSegment {
+    text: string;
+    match: boolean;
+}
+
+/**
+ * The initial state of the address inference engine.
+ */
+declare const INITIAL_STATE: InferState;
+/**
+ * The core logic engine for Pro6PP Infer.
+ * Manages API communication, state transitions, and keyboard interaction logic.
+ */
+declare class InferCore {
+    private country;
+    private authKey?;
+    private explicitApiUrl?;
+    private baseLimit;
+    private currentLimit;
+    private maxRetries;
+    private fetcher;
+    private onStateChange;
+    private onSelect;
+    /**
+     * The current read-only state of the engine.
+     * Use `onStateChange` to react to updates.
+     */
+    state: InferState;
+    private abortController;
+    private debouncedFetch;
+    /**
+     * Initializes a new instance of the Infer engine.
+     * @param config The configuration object including API keys and callbacks.
+     */
+    constructor(config: InferConfig);
+    /**
+     * Processes new text input from the user.
+     * Triggers a debounced API request and updates the internal state.
+     * @param value The raw string from the input field.
+     */
+    handleInput(value: string): void;
+    /**
+     * Increases the current limit and re-fetches the query to show more results.
+     */
+    loadMore(): void;
+    /**
+     * Handles keyboard events for the input field.
+     * Supports:
+     * - `ArrowUp`/`ArrowDown`: Navigate through the suggestion list.
+     * - `Enter`: Select the currently highlighted suggestion.
+     * - `Space`: Automatically inserts a comma if a numeric street number is detected.
+     * @param event The keyboard event from the input element.
+     */
+    handleKeyDown(event: KeyboardEvent | {
+        key: string;
+        target: EventTarget | null;
+        preventDefault: () => void;
+    }): void;
+    /**
+     * Manually selects a suggestion or a string value.
+     * This is typically called when a user clicks a suggestion in the UI.
+     * @param item The suggestion object or string to select.
+     * @returns boolean True if the selection is a final address.
+     */
+    selectItem(item: InferResult | string): boolean;
+    private shouldAutoInsertComma;
+    private finishSelection;
+    private processSelection;
+    private executeFetch;
+    private retry;
+    private mapResponseToState;
+    private updateQueryAndFetch;
+    private replaceLastSegment;
+    private getQueryPrefix;
+    private getCurrentFragment;
+    private resetState;
+    private updateState;
+    private debounce;
+}
+
+/**
+ * Splits text into matched and unmatched segments based on a fuzzy query sequence.
+ */
+declare function getHighlightSegments(text: string, query: string): HighlightSegment[];
+
+declare const DEFAULT_STYLES = "\n  .pro6pp-wrapper {\n    position: relative;\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif;\n    box-sizing: border-box;\n    width: 100%;\n    -webkit-tap-highlight-color: transparent;\n  }\n  .pro6pp-wrapper * {\n    box-sizing: border-box;\n  }\n  .pro6pp-input {\n    width: 100%;\n    padding: 12px 14px;\n    padding-right: 48px;\n    border: 1px solid #e0e0e0;\n    border-radius: 8px;\n    font-size: 16px;\n    line-height: 1.5;\n    appearance: none;\n    transition: border-color 0.2s, box-shadow 0.2s;\n  }\n  .pro6pp-input:focus {\n    outline: none;\n    border-color: #3b82f6;\n    box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);\n  }\n\n  .pro6pp-input-addons {\n    position: absolute;\n    right: 4px;\n    top: 0;\n    bottom: 0;\n    display: flex;\n    align-items: center;\n    pointer-events: none;\n  }\n  .pro6pp-input-addons > * {\n    pointer-events: auto;\n  }\n\n  .pro6pp-clear-button {\n    background: none;\n    border: none;\n    width: 40px;\n    height: 40px;\n    cursor: pointer;\n    color: #a3a3a3;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    border-radius: 50%;\n    transition: color 0.2s, background-color 0.2s;\n    touch-action: manipulation;\n  }\n\n  @media (hover: hover) {\n    .pro6pp-clear-button:hover {\n      color: #1f2937;\n      background-color: #f3f4f6;\n    }\n  }\n\n  .pro6pp-clear-button:active {\n    background-color: #f3f4f6;\n  }\n\n  .pro6pp-loader {\n    width: 20px;\n    height: 20px;\n    margin: 0 8px;\n    border: 2px solid #e0e0e0;\n    border-top-color: #6b7280;\n    border-radius: 50%;\n    animation: pro6pp-spin 0.6s linear infinite;\n    flex-shrink: 0;\n  }\n\n  .pro6pp-dropdown {\n    position: absolute;\n    top: 100%;\n    left: 0;\n    right: 0;\n    margin-top: 4px;\n    background: #ffffff;\n    border: 1px solid #e5e7eb;\n    border-radius: 6px;\n    box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);\n    z-index: 9999;\n    padding: 0;\n    max-height: 260px;\n    overflow-y: auto;\n    display: flex;\n    flex-direction: column;\n  }\n\n  @media (max-height: 500px) {\n    .pro6pp-dropdown {\n      max-height: 140px;\n    }\n  }\n\n  .pro6pp-list {\n    list-style: none;\n    margin: 0;\n    padding: 0;\n    width: 100%;\n  }\n\n  .pro6pp-item {\n    padding: 12px 14px;\n    cursor: pointer;\n    display: flex;\n    align-items: center;\n    font-size: 14px;\n    color: #374151;\n    border-bottom: 1px solid #f3f4f6;\n    transition: background-color 0.1s;\n    flex-shrink: 0;\n  }\n\n  .pro6pp-item:last-child {\n    border-bottom: none;\n  }\n\n  @media (hover: hover) {\n    .pro6pp-item:hover, .pro6pp-item--active {\n      background-color: #f9fafb;\n    }\n  }\n\n  .pro6pp-item:active {\n    background-color: #f3f4f6;\n  }\n\n  .pro6pp-item__label {\n    font-weight: 500;\n    flex-shrink: 0;\n  }\n  .pro6pp-item__subtitle {\n    font-size: 14px;\n    color: #6b7280;\n    flex-grow: 1;\n  }\n  .pro6pp-item__chevron {\n    color: #d1d5db;\n    display: flex;\n    align-items: center;\n    margin-left: auto;\n  }\n\n  .pro6pp-no-results {\n    padding: 24px 16px;\n    color: #6b7280;\n    font-size: 15px;\n    text-align: center;\n  }\n\n  .pro6pp-load-more {\n    width: 100%;\n    padding: 14px;\n    background: #f9fafb;\n    border: none;\n    border-top: 1px solid #e0e0e0;\n    color: #3b82f6;\n    font-size: 14px;\n    font-weight: 600;\n    cursor: pointer;\n    flex-shrink: 0;\n    touch-action: manipulation;\n  }\n\n  .pro6pp-load-more:active {\n    background-color: #f3f4f6;\n  }\n\n  @keyframes pro6pp-spin {\n    to { transform: rotate(360deg); }\n  }\n";
+
+export { type AddressValue, type CountryCode, DEFAULT_STYLES, type Fetcher, type HighlightSegment, INITIAL_STATE, type InferConfig, InferCore, type InferResult, type InferState, type Stage, getHighlightSegments };