@pro6pp/infer-core 0.0.2-beta.8 → 0.1.0-beta.17

package/README.md

@@ -7,14 +7,32 @@ Use this package if you are building a custom integration for a framework, or if
 
 ## 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';
 
@@ -22,14 +40,30 @@ const core = new InferCore({
   authKey: 'YOUR_AUTH_KEY',
   country: 'NL',
   onStateChange: (state) => {
-    // suggestions, isLoading, isValid, selectedSuggestionIndex, etc.
+    // suggestions, isLoading, isValid, value, 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

package/dist/index.cjs

@@ -1,23 +1,31 @@
-"use strict";var h=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var w=(a,e,t)=>e in a?h(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var C=(a,e)=>{for(var t in e)h(a,t,{get:e[t],enumerable:!0})},L=(a,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of v(e))!I.call(a,s)&&s!==t&&h(a,s,{get:()=>e[s],enumerable:!(i=y(e,s))||i.enumerable});return a};var T=a=>L(h({},"__esModule",{value:!0}),a);var l=(a,e,t)=>w(a,typeof e!="symbol"?e+"":e,t);var A={};C(A,{DEFAULT_STYLES:()=>S,INITIAL_STATE:()=>g,InferCore:()=>f});module.exports=T(A);var d={API_URL:"https://api.pro6pp.nl/v2",LIMIT:20,DEBOUNCE_MS:150,MIN_DEBOUNCE_MS:50,MAX_RETRIES:0},x={DIGITS_1_3:/^[0-9]{1,3}$/},g={query:"",stage:null,cities:[],streets:[],suggestions:[],isValid:!1,isError:!1,isLoading:!1,hasMore:!1,selectedSuggestionIndex:-1},f=class{constructor(e){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");l(this,"isSelecting",!1);this.country=e.country,this.authKey=e.authKey,this.explicitApiUrl=e.apiUrl,this.baseLimit=e.limit||d.LIMIT,this.currentLimit=this.baseLimit;let t=e.maxRetries!==void 0?e.maxRetries:d.MAX_RETRIES;this.maxRetries=Math.max(0,Math.min(t,10)),this.fetcher=e.fetcher||((r,o)=>fetch(r,o)),this.onStateChange=e.onStateChange||(()=>{}),this.onSelect=e.onSelect||(()=>{}),this.state={...g};let i=e.debounceMs!==void 0?e.debounceMs:d.DEBOUNCE_MS,s=Math.max(i,d.MIN_DEBOUNCE_MS);this.debouncedFetch=this.debounce(r=>this.executeFetch(r),s)}handleInput(e){if(this.isSelecting){this.isSelecting=!1;return}this.currentLimit=this.baseLimit;let t=this.state.stage==="final"&&e!==this.state.query;this.updateState({query:e,isValid:!1,isLoading:!!e.trim(),selectedSuggestionIndex:-1,hasMore:!1}),t&&this.onSelect(null),this.debouncedFetch(e)}loadMore(){this.state.isLoading||(this.currentLimit+=this.baseLimit,this.updateState({isLoading:!0}),this.executeFetch(this.state.query))}handleKeyDown(e){let t=e.target;if(!t)return;let i=this.state.cities.length+this.state.streets.length+this.state.suggestions.length;if(i>0){if(e.key==="ArrowDown"){e.preventDefault();let r=this.state.selectedSuggestionIndex+1;r>=i&&(r=0),this.updateState({selectedSuggestionIndex:r});return}if(e.key==="ArrowUp"){e.preventDefault();let r=this.state.selectedSuggestionIndex-1;r<0&&(r=i-1),this.updateState({selectedSuggestionIndex:r});return}if(e.key==="Enter"&&this.state.selectedSuggestionIndex>=0){e.preventDefault();let o=[...this.state.cities,...this.state.streets,...this.state.suggestions][this.state.selectedSuggestionIndex];o&&(this.selectItem(o),this.updateState({selectedSuggestionIndex:-1}));return}}let s=t.value;if(e.key===" "&&this.shouldAutoInsertComma(s)){e.preventDefault();let r=`${s.trim()}, `;this.updateQueryAndFetch(r)}}selectItem(e){this.debouncedFetch.cancel(),this.abortController&&this.abortController.abort();let t=typeof e=="string"?e:e.label,i=t;typeof e!="string"&&typeof e.value=="string"&&(i=e.value);let s=typeof e!="string"&&typeof e.value=="object"?e.value:void 0,r=!!s&&Object.keys(s).length>0;if(this.isSelecting=!0,this.state.stage==="final"||r){let u=t;if(s&&Object.keys(s).length>0){let{street:p,street_number:n,house_number:c,city:b}=s,m=n||c;p&&m&&b&&(u=`${p} ${m}, ${b}`)}return this.finishSelection(u,s),!0}let o=typeof e!="string"?e.subtitle:null;return this.processSelection(i,o),!1}shouldAutoInsertComma(e){if(!e.includes(",")&&x.DIGITS_1_3.test(e.trim()))return!0;if(this.state.stage==="house_number"){let i=this.getCurrentFragment(e);return x.DIGITS_1_3.test(i)}return!1}finishSelection(e,t){this.updateState({query:e,suggestions:[],cities:[],streets:[],isValid:!0,stage:"final",hasMore:!1}),this.onSelect(t||e)}processSelection(e,t){let{stage:i,query:s}=this.state,r=s;if(t&&(i==="city"||i==="street"||i==="mixed")){if(i==="city")r=`${t}, ${e}, `;else{let n=this.getQueryPrefix(s);r=n?`${n} ${e}, ${t}, `:`${e}, ${t}, `}this.updateQueryAndFetch(r);return}if(i==="direct"||i==="addition"){this.finishSelection(e);return}!s.includes(",")&&(i==="city"||i==="street"||i==="house_number_first")?r=`${e}, `:(r=this.replaceLastSegment(s,e),i!=="house_number"&&(r+=", ")),this.updateQueryAndFetch(r)}executeFetch(e,t=0){let i=(e||"").toString();if(!i.trim()){this.abortController?.abort(),this.resetState();return}t===0&&(this.updateState({isError:!1}),this.abortController&&this.abortController.abort(),this.abortController=new AbortController);let s=this.abortController?.signal,r=this.explicitApiUrl?this.explicitApiUrl:`${d.API_URL}/infer/${this.country.toLowerCase()}`,o=new URLSearchParams({country:this.country.toLowerCase(),query:i,limit:this.currentLimit.toString()});this.authKey&&o.set("authKey",this.authKey);let u=r.includes("?")?"&":"?",p=`${r}${u}${o.toString()}`;this.fetcher(p,{signal:s}).then(n=>{if(!n.ok){if(t<this.maxRetries&&(n.status>=500||n.status===429))return this.retry(e,t,s);throw new Error("Network error")}return n.json()}).then(n=>{n&&this.mapResponseToState(n)}).catch(n=>{if(n.name!=="AbortError"){if(t<this.maxRetries)return this.retry(e,t,s);this.updateState({isError:!0,isLoading:!1})}})}retry(e,t,i){if(i?.aborted)return;let s=Math.pow(2,t)*200;setTimeout(()=>{i?.aborted||this.executeFetch(e,t+1)},s)}mapResponseToState(e){let t={stage:e.stage,isLoading:!1},i=!1,s=null,r=e.suggestions||[],o=[],u=new Set;for(let n of r){let c=`${n.label}|${n.subtitle||""}|${JSON.stringify(n.value||{})}`;u.has(c)||(u.add(c),o.push(n))}let p=o.length+(e.cities?.length||0)+(e.streets?.length||0);if(t.hasMore=p>=this.currentLimit,e.stage==="mixed")t.cities=e.cities||[],t.streets=e.streets||[],t.suggestions=[];else{t.suggestions=o,t.cities=[],t.streets=[];let n=o[0],c=n&&typeof n.value=="object"&&n.value!==null&&Object.keys(n.value).length>0;(e.stage==="final"||c)&&o.length===1&&(i=!0,s=n)}if(t.isValid=e.stage==="final",i&&s){t.query=s.label,t.suggestions=[],t.cities=[],t.streets=[],t.isValid=!0,t.hasMore=!1,this.isSelecting=!0,this.updateState(t);let n=typeof s.value=="object"?s.value:s.label;this.onSelect(n)}else this.updateState(t)}updateQueryAndFetch(e){this.updateState({query:e,suggestions:[],cities:[],streets:[]}),this.updateState({isLoading:!0,isValid:!1,hasMore:!1}),this.debouncedFetch(e)}replaceLastSegment(e,t){let i=e.lastIndexOf(",");return i===-1?t:`${e.slice(0,i+1)} ${t}`.trim()}getQueryPrefix(e){let t=e.lastIndexOf(",");return t===-1?"":e.slice(0,t+1).trimEnd()}getCurrentFragment(e){return(e.split(",").slice(-1)[0]??"").trim()}resetState(){this.updateState({...g,query:this.state.query})}updateState(e){this.state={...this.state,...e},this.onStateChange(this.state)}debounce(e,t){let i,s=(...r)=>{i&&clearTimeout(i),i=setTimeout(()=>e.apply(this,r),t)};return s.cancel=()=>{i&&(clearTimeout(i),i=void 0)},s}};var S=`
+"use strict";var f=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var w=(n,t,e)=>t in n?f(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var A=(n,t)=>{for(var e in t)f(n,e,{get:t[e],enumerable:!0})},E=(n,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of T(t))!L.call(n,r)&&r!==e&&f(n,r,{get:()=>t[r],enumerable:!(i=_(t,r))||i.enumerable});return n};var R=n=>E(f({},"__esModule",{value:!0}),n);var l=(n,t,e)=>w(n,typeof t!="symbol"?t+"":t,e);var U={};A(U,{DEFAULT_STYLES:()=>I,INITIAL_STATE:()=>y,InferCore:()=>S,formatLabelByInputOrder:()=>m,getHighlightSegments:()=>D});module.exports=R(U);function v(n){return n.toLowerCase().trim()}function $(n){return n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function F(n,t){let e=v(n),i=v(t);if(i.includes(" "))return e.indexOf(i);let s=new RegExp(`(?:^|[,\\s])${$(i)}(?:$|[,\\s])`,"g").exec(e);if(s){let o=s.index,p=e[o];return p===","||p===" "?o+1:o}return-1}function M(n,t){let e=[],i=[];t.street&&i.push({value:t.street,type:"street"}),t.city&&i.push({value:t.city,type:"city"}),t.postcode&&i.push({value:t.postcode,type:"postcode"}),t.street_number!==void 0&&t.street_number!==null&&i.push({value:String(t.street_number),type:"street_number"}),t.addition&&i.push({value:t.addition,type:"addition"});for(let r of i){let s=F(n,r.value);s!==-1&&e.push({type:r.type,value:r.value,position:s})}return e.sort((r,s)=>r.position-s.position),e}function m(n,t){if(!t||!n)return"";let e=M(n,t),i=new Set(e.map(o=>o.type)),r=[];for(let o of e)r.push(o.value);let s=["street","street_number","addition","postcode","city"];for(let o of s){if(i.has(o))continue;let p;switch(o){case"street":p=t.street;break;case"city":p=t.city;break;case"street_number":p=t.street_number!==void 0?String(t.street_number):void 0;break;case"postcode":p=t.postcode;break;case"addition":p=t.addition;break}p&&r.push(p)}return r.join(", ")}var g={API_URL:"https://api.pro6pp.nl/v2",LIMIT:20,DEBOUNCE_MS:150,MIN_DEBOUNCE_MS:50,MAX_RETRIES:0},x={DIGITS_1_3:/^[0-9]{1,3}$/,STREET_NUMBER_PREFIX:/^(\d+)\s*,\s*$/},y={query:"",stage:null,cities:[],streets:[],suggestions:[],isValid:!1,value:null,isError:!1,isLoading:!1,hasMore:!1,selectedSuggestionIndex:-1},S=class{constructor(t){l(this,"country");l(this,"authKey");l(this,"explicitApiUrl");l(this,"baseLimit");l(this,"currentLimit");l(this,"maxRetries");l(this,"language");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||g.LIMIT,this.currentLimit=this.baseLimit,this.language=t.language;let e=t.maxRetries!==void 0?t.maxRetries:g.MAX_RETRIES;this.maxRetries=Math.max(0,Math.min(e,10)),this.fetcher=t.fetcher||((s,o)=>fetch(s,o)),this.onStateChange=t.onStateChange||(()=>{}),this.onSelect=t.onSelect||(()=>{}),this.state={...y};let i=t.debounceMs!==void 0?t.debounceMs:g.DEBOUNCE_MS,r=Math.max(i,g.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,value:null,isLoading:!!t.trim(),selectedSuggestionIndex:-1,hasMore:!1,stage:e?null:this.state.stage}),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 o=[...this.state.cities,...this.state.streets,...this.state.suggestions][this.state.selectedSuggestionIndex];o&&(this.selectItem(o),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:c,street_number:a,postcode:d,city:u,addition:h}=r;if(c&&a&&u){let b=h?` ${h}`:"",C=d?`${d}, `:"";p=`${c}, ${a}${b}, ${C}${u}`}}return this.finishSelection(p,r),!0}let o=typeof t!="string"?t.subtitle:null;return this.processSelection(i,o),!1}shouldAutoInsertComma(t){if(!t.includes(",")&&x.DIGITS_1_3.test(t.trim()))return!0;if(this.state.stage==="street_number"){let i=this.getCurrentFragment(t);return x.DIGITS_1_3.test(i)}return!1}finishSelection(t,e){this.updateState({query:t,suggestions:[],cities:[],streets:[],isValid:!0,value:e||null,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 a=this.getQueryPrefix(r),d=!a||!a.includes(e),u=a;if(a&&e){let h=a.match(x.STREET_NUMBER_PREFIX);if(h){let b=h[1];e.startsWith(b)&&(u="")}}d?s=u?`${u} ${t}, ${e}, `:`${t}, ${e}, `:s=u?`${u} ${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:`${g.API_URL}/infer/${this.country.toLowerCase()}`,o=new URLSearchParams({query:i,limit:this.currentLimit.toString()});this.explicitApiUrl&&o.append("country",this.country.toLowerCase()),this.authKey&&o.set("authKey",this.authKey),this.language&&o.set("language",this.language);let p=s.includes("?")?"&":"?",c=`${s}${p}${o.toString()}`;this.fetcher(c,{signal:r}).then(a=>{if(!a.ok){if(e<this.maxRetries&&(a.status>=500||a.status===429))return this.retry(t,e,r);throw new Error("Network error")}return a.json()}).then(a=>{a&&this.mapResponseToState(a)}).catch(a=>{if(a.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 c=`${p.label}|${p.subtitle||""}|${JSON.stringify(p.value||{})}`;if(!s.has(c)){s.add(c);let a=this.reformatSuggestionLabel(p);r.push(a)}}let o=r.length+(t.cities?.length||0)+(t.streets?.length||0);e.hasMore=o>=this.currentLimit,t.stage==="mixed"?(e.cities=t.cities||[],e.streets=t.streets||[],e.cities?.length===0&&e.streets?.length===0?e.suggestions=r: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])}reformatSuggestionLabel(t){if(!t.value||typeof t.value=="string")return t;let e=t.value;if(!e.street||!e.city)return t;let i=m(this.state.query,e);return i?{...t,label:i}:t}updateQueryAndFetch(t){this.updateState({query:t,suggestions:[],cities:[],streets:[],isValid:!1,value:null,isLoading:!0,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({...y,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 k(n){if(n.length===0)return n;let t=[];for(let e of n){let i=t[t.length-1];i&&i.match===e.match?i.text+=e.text:t.push({text:e.text,match:e.match})}return t}function D(n,t){if(!t||!n)return[{text:n,match:!1}];let e=[],i=n.toLowerCase(),r=t.toLowerCase(),s=0,o=0;for(let a=0;a<n.length;a++){if(!(s<t.length&&i[a]===r[s]))continue;a>o&&e.push({text:n.slice(o,a),match:!1}),e.push({text:n[a],match:!0}),s++,o=a+1}return o<n.length&&e.push({text:n.slice(o),match:!1}),s===t.length?k(e):[{text:n,match:!1}]}var I=`
   .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: 10px 12px;
+    padding: 12px 14px;
     padding-right: 48px;
     border: 1px solid #e0e0e0;
-    border-radius: 4px;
+    border-radius: 8px;
     font-size: 16px;
     line-height: 1.5;
+    appearance: none;
     transition: border-color 0.2s, box-shadow 0.2s;
   }
+
+  .pro6pp-input::placeholder {
+    font-size: 16px;
+    color: #a3a3a3;
+  }
+
   .pro6pp-input:focus {
     outline: none;
     border-color: #3b82f6;
@@ -26,12 +34,11 @@
 
   .pro6pp-input-addons {
     position: absolute;
-    right: 6px;
+    right: 4px;
     top: 0;
     bottom: 0;
     display: flex;
     align-items: center;
-    gap: 2px;
     pointer-events: none;
   }
   .pro6pp-input-addons > * {
@@ -41,37 +48,27 @@
   .pro6pp-clear-button {
     background: none;
     border: none;
-    width: 28px;
-    height: 28px;
+    width: 32px;
+    height: 32px;
     cursor: pointer;
     color: #a3a3a3;
     display: flex;
     align-items: center;
     justify-content: center;
     border-radius: 50%;
-    transition: color 0.2s, background-color 0.2s, transform 0.1s;
-  }
-  .pro6pp-clear-button:hover {
-    color: #1f2937;
-    background-color: #f3f4f6;
-  }
-  .pro6pp-clear-button:active {
-    transform: scale(0.92);
+    transition: color 0.2s, background-color 0.2s;
+    touch-action: manipulation;
   }
-  .pro6pp-clear-button svg {
-    width: 18px;
-    height: 18px;
+
+  @media (hover: hover) {
+    .pro6pp-clear-button:hover {
+      color: #1f2937;
+      background-color: #f3f4f6;
+    }
   }
 
-  .pro6pp-loader {
-    width: 18px;
-    height: 18px;
-    margin: 0 4px;
-    border: 2px solid #e0e0e0;
-    border-top-color: #6b7280;
-    border-radius: 50%;
-    animation: pro6pp-spin 0.6s linear infinite;
-    flex-shrink: 0;
+  .pro6pp-clear-button:active {
+    background-color: #f3f4f6;
   }
 
   .pro6pp-dropdown {
@@ -79,80 +76,129 @@
     top: 100%;
     left: 0;
     right: 0;
-    z-index: 9999;
     margin-top: 4px;
-    background: white;
-    border: 1px solid #e0e0e0;
-    border-radius: 4px;
-    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
-    max-height: 300px;
+    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: 280px;
     overflow-y: auto;
     display: flex;
     flex-direction: column;
   }
+
+  @media (max-height: 500px) {
+    .pro6pp-dropdown {
+      max-height: 180px;
+    }
+  }
+
   .pro6pp-list {
-    list-style: none !important;
-    padding: 0 !important;
-    margin: 0 !important;
-    flex-grow: 1;
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    width: 100%;
   }
+
   .pro6pp-item {
-    padding: 12px 16px;
+    padding: 12px 14px;
     cursor: pointer;
     display: flex;
-    flex-direction: row;
     align-items: center;
-    color: #111827;
-    font-size: 14px;
-    line-height: 1.2;
-    white-space: nowrap;
-    overflow: hidden;
+    font-size: 15px;
+    line-height: 1.4;
+    color: #374151;
+    border-bottom: 1px solid #f3f4f6;
+    transition: background-color 0.1s;
+    flex-shrink: 0;
   }
-  .pro6pp-item:hover, .pro6pp-item--active {
-    background-color: #f9fafb;
+
+  .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;
+    font-weight: 400;
+    flex-shrink: 1;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .pro6pp-item__label--match {
+    font-weight: 520;
+  }
+
+  .pro6pp-item__label--unmatched {
+    font-weight: 400;
+    color: #4b5563;
   }
+
   .pro6pp-item__subtitle {
-    font-size: 14px;
     color: #6b7280;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    flex-shrink: 1;
+    flex-shrink: 0;
   }
+
   .pro6pp-item__chevron {
-    margin-left: auto;
+    color: #d1d5db;
     display: flex;
     align-items: center;
-    color: #9ca3af;
+    margin-left: auto;
     padding-left: 8px;
   }
+
   .pro6pp-no-results {
-    padding: 16px;
+    padding: 24px 16px;
     color: #6b7280;
-    font-size: 14px;
+    font-size: 15px;
     text-align: center;
   }
-  .pro6pp-load-more {
-    width: 100%;
-    padding: 10px;
-    background: #f9fafb;
-    border: none;
-    border-top: 1px solid #e0e0e0;
-    color: #3b82f6;
-    font-size: 13px;
-    font-weight: 600;
-    cursor: pointer;
-    transition: background-color 0.2s;
-    flex-shrink: 0;
+
+  .pro6pp-loader-item {
+    padding: 10px 12px;
+    color: #6b7280;
+    font-size: 0.875rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    background-color: #f9fafb;
+    border-top: 1px solid #f3f4f6;
   }
-  .pro6pp-load-more:hover {
-    background-color: #f3f4f6;
+
+  .pro6pp-mini-spinner {
+    width: 14px;
+    height: 14px;
+    border: 2px solid #e5e7eb;
+    border-top-color: #6b7280;
+    border-radius: 50%;
+    animation: pro6pp-spin 0.6s linear infinite;
+  }
+
+  @media (max-width: 640px) {
+    .pro6pp-input {
+      font-size: 16px;
+      padding: 10px 12px;
+    }
+    .pro6pp-item {
+      padding: 10px 12px;
+      font-size: 14px;
+    }
   }
 
   @keyframes pro6pp-spin {
     to { transform: rotate(360deg); }
   }
-`;0&&(module.exports={DEFAULT_STYLES,INITIAL_STATE,InferCore});
+`;0&&(module.exports={DEFAULT_STYLES,INITIAL_STATE,InferCore,formatLabelByInputOrder,getHighlightSegments});

package/dist/index.d.cts

@@ -1,7 +1,11 @@
 /**
  * Supported ISO 3166-1 alpha-2 country codes.
  */
-type CountryCode = 'NL' | 'DE';
+type CountryCode = 'NL' | 'DE' | 'BE' | 'AT' | 'DK' | (string & {});
+/**
+ * Supported language codes for address labels.
+ */
+type LanguageCode = 'nl' | 'fr' | 'de' | (string & {});
 /**
  * The current step in the address inference process.
  * - `empty`: No input yet.
@@ -9,13 +13,13 @@ type CountryCode = 'NL' | 'DE';
  * - `street`: User is selecting a street.
  * - `city`: User is selecting a city.
  * - `postcode`: User is entering a postcode.
- * - `house_number`: User is entering a house number.
- * - `house_number_first`: Specialized mode where number is entered before street.
- * - `addition`: Selecting a house number addition (e.g., 'A', 'III').
+ * - `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' | 'house_number' | 'house_number_first' | 'addition' | 'direct' | 'final';
+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.
  */
@@ -24,15 +28,11 @@ interface AddressValue {
     street: string;
     /** The name of the city/locality. */
     city: string;
-    /** The house number (formatted). */
+    /** The street number. */
     street_number?: string | number;
-    /** The house number (numeric part). */
-    house_number?: string | number;
     /** The postal code. */
     postcode?: string;
-    /** The full postal code including letters (country-specific). */
-    postcode_full?: string;
-    /** The house number addition or suffix. */
+    /** The street number addition or suffix. */
     addition?: string;
     /** Allow for extra fields if API expands. */
     [key: string]: unknown;
@@ -68,6 +68,8 @@ interface InferState {
     suggestions: InferResult[];
     /** Flag indicating if the current selection is a complete, valid address. */
     isValid: boolean;
+    /** The complete address object if valid, otherwise null. */
+    value: AddressValue | null;
     /** Flag indicating if the last API request failed. */
     isError: boolean;
     /** Flag indicating if a network request is currently in progress. */
@@ -126,6 +128,12 @@ interface InferConfig {
      * @default 0
      */
     maxRetries?: number;
+    /**
+     * Language code for response labels.
+     * Affects the language of returned address labels.
+     * Only applicable for BE country code.
+     */
+    language?: LanguageCode;
     /**
      * Callback triggered whenever the internal state (suggestions, loading status, etc.) updates.
      */
@@ -137,6 +145,13 @@ interface InferConfig {
      */
     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.
@@ -153,6 +168,7 @@ declare class InferCore {
     private baseLimit;
     private currentLimit;
     private maxRetries;
+    private language?;
     private fetcher;
     private onStateChange;
     private onSelect;
@@ -163,7 +179,6 @@ declare class InferCore {
     state: InferState;
     private abortController;
     private debouncedFetch;
-    private isSelecting;
     /**
      * Initializes a new instance of the Infer engine.
      * @param config The configuration object including API keys and callbacks.
@@ -184,7 +199,7 @@ declare class InferCore {
      * Supports:
      * - `ArrowUp`/`ArrowDown`: Navigate through the suggestion list.
      * - `Enter`: Select the currently highlighted suggestion.
-     * - `Space`: Automatically inserts a comma if a numeric house number is detected.
+     * - `Space`: Automatically inserts a comma if a numeric street number is detected.
      * @param event The keyboard event from the input element.
      */
     handleKeyDown(event: KeyboardEvent | {
@@ -205,6 +220,12 @@ declare class InferCore {
     private executeFetch;
     private retry;
     private mapResponseToState;
+    /**
+     * Reformats a suggestion's label based on the user's input order.
+     * If the suggestion has a structured value object, we reorder the label
+     * to match how the user typed the components.
+     */
+    private reformatSuggestionLabel;
     private updateQueryAndFetch;
     private replaceLastSegment;
     private getQueryPrefix;
@@ -214,6 +235,23 @@ declare class InferCore {
     private debounce;
 }
 
-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  }\n  .pro6pp-wrapper * {\n    box-sizing: border-box;\n  }\n  .pro6pp-input {\n    width: 100%;\n    padding: 10px 12px;\n    padding-right: 48px;\n    border: 1px solid #e0e0e0;\n    border-radius: 4px;\n    font-size: 16px;\n    line-height: 1.5;\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: 6px;\n    top: 0;\n    bottom: 0;\n    display: flex;\n    align-items: center;\n    gap: 2px;\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: 28px;\n    height: 28px;\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, transform 0.1s;\n  }\n  .pro6pp-clear-button:hover {\n    color: #1f2937;\n    background-color: #f3f4f6;\n  }\n  .pro6pp-clear-button:active {\n    transform: scale(0.92);\n  }\n  .pro6pp-clear-button svg {\n    width: 18px;\n    height: 18px;\n  }\n\n  .pro6pp-loader {\n    width: 18px;\n    height: 18px;\n    margin: 0 4px;\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    z-index: 9999;\n    margin-top: 4px;\n    background: white;\n    border: 1px solid #e0e0e0;\n    border-radius: 4px;\n    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);\n    max-height: 300px;\n    overflow-y: auto;\n    display: flex;\n    flex-direction: column;\n  }\n  .pro6pp-list {\n    list-style: none !important;\n    padding: 0 !important;\n    margin: 0 !important;\n    flex-grow: 1;\n  }\n  .pro6pp-item {\n    padding: 12px 16px;\n    cursor: pointer;\n    display: flex;\n    flex-direction: row;\n    align-items: center;\n    color: #111827;\n    font-size: 14px;\n    line-height: 1.2;\n    white-space: nowrap;\n    overflow: hidden;\n  }\n  .pro6pp-item:hover, .pro6pp-item--active {\n    background-color: #f9fafb;\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    overflow: hidden;\n    text-overflow: ellipsis;\n    flex-shrink: 1;\n  }\n  .pro6pp-item__chevron {\n    margin-left: auto;\n    display: flex;\n    align-items: center;\n    color: #9ca3af;\n    padding-left: 8px;\n  }\n  .pro6pp-no-results {\n    padding: 16px;\n    color: #6b7280;\n    font-size: 14px;\n    text-align: center;\n  }\n  .pro6pp-load-more {\n    width: 100%;\n    padding: 10px;\n    background: #f9fafb;\n    border: none;\n    border-top: 1px solid #e0e0e0;\n    color: #3b82f6;\n    font-size: 13px;\n    font-weight: 600;\n    cursor: pointer;\n    transition: background-color 0.2s;\n    flex-shrink: 0;\n  }\n  .pro6pp-load-more:hover {\n    background-color: #f3f4f6;\n  }\n\n  @keyframes pro6pp-spin {\n    to { transform: rotate(360deg); }\n  }\n";
+/**
+ * Splits text into matched and unmatched segments based on a fuzzy query sequence.
+ * Consecutive matched characters are merged into single segments for cleaner rendering.
+ */
+declare function getHighlightSegments(text: string, query: string): HighlightSegment[];
+
+/**
+ * Formats a label for display based on the user's input order.
+ * Components the user typed appear first (in their order),
+ * followed by components they didn't type (new info from API).
+ *
+ * @param query The user's current query string
+ * @param value The structured address value from the API
+ * @returns A formatted label string
+ */
+declare function formatLabelByInputOrder(query: string, value: AddressValue): string;
+
+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\n  .pro6pp-input::placeholder {\n    font-size: 16px;\n    color: #a3a3a3;\n  }\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: 32px;\n    height: 32px;\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-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: 280px;\n    overflow-y: auto;\n    display: flex;\n    flex-direction: column;\n  }\n\n  @media (max-height: 500px) {\n    .pro6pp-dropdown {\n      max-height: 180px;\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: 15px;\n    line-height: 1.4;\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: 400;\n    flex-shrink: 1;\n    overflow: hidden;\n    text-overflow: ellipsis;\n    white-space: nowrap;\n  }\n\n  .pro6pp-item__label--match {\n    font-weight: 520;\n  }\n\n  .pro6pp-item__label--unmatched {\n    font-weight: 400;\n    color: #4b5563;\n  }\n\n  .pro6pp-item__subtitle {\n    color: #6b7280;\n    flex-shrink: 0;\n  }\n\n  .pro6pp-item__chevron {\n    color: #d1d5db;\n    display: flex;\n    align-items: center;\n    margin-left: auto;\n    padding-left: 8px;\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-loader-item {\n    padding: 10px 12px;\n    color: #6b7280;\n    font-size: 0.875rem;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    gap: 8px;\n    background-color: #f9fafb;\n    border-top: 1px solid #f3f4f6;\n  }\n\n  .pro6pp-mini-spinner {\n    width: 14px;\n    height: 14px;\n    border: 2px solid #e5e7eb;\n    border-top-color: #6b7280;\n    border-radius: 50%;\n    animation: pro6pp-spin 0.6s linear infinite;\n  }\n\n  @media (max-width: 640px) {\n    .pro6pp-input {\n      font-size: 16px;\n      padding: 10px 12px;\n    }\n    .pro6pp-item {\n      padding: 10px 12px;\n      font-size: 14px;\n    }\n  }\n\n  @keyframes pro6pp-spin {\n    to { transform: rotate(360deg); }\n  }\n";
 
-export { type AddressValue, type CountryCode, DEFAULT_STYLES, type Fetcher, INITIAL_STATE, type InferConfig, InferCore, type InferResult, type InferState, type Stage };
+export { type AddressValue, type CountryCode, DEFAULT_STYLES, type Fetcher, type HighlightSegment, INITIAL_STATE, type InferConfig, InferCore, type InferResult, type InferState, type LanguageCode, type Stage, formatLabelByInputOrder, getHighlightSegments };