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

package/dist/index.js

@@ -1,228 +1,180 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  INITIAL_STATE: () => INITIAL_STATE,
-  InferCore: () => InferCore
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/core.ts
-var DEFAULTS = {
-  API_URL: "https://api.pro6pp.nl/v2",
-  LIMIT: 1e3,
-  DEBOUNCE_MS: 300
-};
-var PATTERNS = {
-  DIGITS_1_3: /^[0-9]{1,3}$/
-};
-var INITIAL_STATE = {
-  query: "",
-  stage: null,
-  cities: [],
-  streets: [],
-  suggestions: [],
-  isValid: false,
-  isError: false,
-  isLoading: false
-};
-var InferCore = class {
-  constructor(config) {
-    __publicField(this, "country");
-    __publicField(this, "authKey");
-    __publicField(this, "apiUrl");
-    __publicField(this, "limit");
-    __publicField(this, "fetcher");
-    __publicField(this, "onStateChange");
-    __publicField(this, "onSelect");
-    __publicField(this, "state");
-    __publicField(this, "abortController", null);
-    __publicField(this, "debouncedFetch");
-    this.country = config.country;
-    this.authKey = config.authKey;
-    this.apiUrl = config.apiUrl || DEFAULTS.API_URL;
-    this.limit = config.limit || DEFAULTS.LIMIT;
-    this.fetcher = config.fetcher || ((url, init) => fetch(url, init));
-    this.onStateChange = config.onStateChange || (() => {
-    });
-    this.onSelect = config.onSelect || (() => {
-    });
-    this.state = { ...INITIAL_STATE };
-    this.debouncedFetch = this.debounce(
-      (val) => this.executeFetch(val),
-      DEFAULTS.DEBOUNCE_MS
-    );
-  }
-  handleInput(value) {
-    this.updateState({
-      query: value,
-      isValid: false,
-      isLoading: !!value.trim()
-    });
-    if (this.state.stage === "final") {
-      this.onSelect(null);
-    }
-    this.debouncedFetch(value);
-  }
-  handleKeyDown(event) {
-    const target = event.target;
-    const val = target.value;
-    if (event.key === " " && this.shouldAutoInsertComma(val)) {
-      event.preventDefault();
-      const next = `${val.trim()}, `;
-      this.updateQueryAndFetch(next);
-    }
+var x=Object.defineProperty;var S=(a,t,e)=>t in a?x(a,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):a[t]=e;var l=(a,t,e)=>S(a,typeof t!="symbol"?t+"":t,e);var c={API_URL:"https://api.pro6pp.nl/v2",LIMIT:20,DEBOUNCE_MS:150,MIN_DEBOUNCE_MS:50,MAX_RETRIES:0},g={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||((r,o)=>fetch(r,o)),this.onStateChange=t.onStateChange||(()=>{}),this.onSelect=t.onSelect||(()=>{}),this.state={...f};let i=t.debounceMs!==void 0?t.debounceMs:c.DEBOUNCE_MS,s=Math.max(i,c.MIN_DEBOUNCE_MS);this.debouncedFetch=this.debounce(r=>this.executeFetch(r),s)}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 r=this.state.selectedSuggestionIndex+1;r>=i&&(r=0),this.updateState({selectedSuggestionIndex:r});return}if(t.key==="ArrowUp"){t.preventDefault();let r=this.state.selectedSuggestionIndex-1;r<0&&(r=i-1),this.updateState({selectedSuggestionIndex:r});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 s=e.value;if(t.key===" "&&this.shouldAutoInsertComma(s)){t.preventDefault();let r=`${s.trim()}, `;this.updateQueryAndFetch(r)}}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 s=typeof t!="string"&&typeof t.value=="object"?t.value:void 0,r=!!s&&Object.keys(s).length>0;if(this.state.stage==="final"||r){let p=e;if(s&&Object.keys(s).length>0){let{street:u,street_number:n,city:d,addition:h}=s;if(u&&n&&d){let b=h?` ${h}`:"";p=`${u} ${n}${b}, ${d}`}}return this.finishSelection(p,s),!0}let o=typeof t!="string"?t.subtitle:null;return this.processSelection(i,o),!1}shouldAutoInsertComma(t){if(!t.includes(",")&&g.DIGITS_1_3.test(t.trim()))return!0;if(this.state.stage==="street_number"){let i=this.getCurrentFragment(t);return g.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:s}=this.state,r=s;if(e&&(i==="city"||i==="street"||i==="mixed")){if(i==="city")r=`${e}, ${t}, `;else{let n=this.getQueryPrefix(s);!n||!n.includes(e)?r=n?`${n} ${t}, ${e}, `:`${t}, ${e}, `:r=n?`${n} ${t}, `:`${t}, `}this.updateQueryAndFetch(r);return}if(i==="direct"||i==="addition"){this.finishSelection(t);return}!s.includes(",")&&(i==="city"||i==="street"||i==="street_number_first")?r=`${t}, `:(r=this.replaceLastSegment(s,t),i!=="street_number"&&(r+=", ")),this.updateQueryAndFetch(r)}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 s=this.abortController?.signal,r=this.explicitApiUrl?this.explicitApiUrl:`${c.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 p=r.includes("?")?"&":"?",u=`${r}${p}${o.toString()}`;this.fetcher(u,{signal:s}).then(n=>{if(!n.ok){if(e<this.maxRetries&&(n.status>=500||n.status===429))return this.retry(t,e,s);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,s);this.updateState({isError:!0,isLoading:!1})}})}retry(t,e,i){if(i?.aborted)return;let s=Math.pow(2,e)*200;setTimeout(()=>{i?.aborted||this.executeFetch(t,e+1)},s)}mapResponseToState(t){let e={stage:t.stage,isLoading:!1},i=t.suggestions||[],s=[],r=new Set;for(let p of i){let u=`${p.label}|${p.subtitle||""}|${JSON.stringify(p.value||{})}`;r.has(u)||(r.add(u),s.push(p))}let o=s.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.suggestions=[]):(e.suggestions=s,e.cities=[],e.streets=[]),e.isValid=t.stage==="final",this.updateState(e),e.isValid&&s.length===1&&this.selectItem(s[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,s=(...r)=>{i&&clearTimeout(i),i=setTimeout(()=>t.apply(this,r),e)};return s.cancel=()=>{i&&(clearTimeout(i),i=void 0)},s}};function T(a,t){if(!t||!a)return[{text:a,match:!1}];let e=[],i=a.toLowerCase(),s=t.toLowerCase(),r=0,o=0;for(let n=0;n<a.length;n++){if(!(r<t.length&&i[n]===s[r]))continue;n>o&&e.push({text:a.slice(o,n),match:!1}),e.push({text:a[n],match:!0}),r++,o=n+1}return o<a.length&&e.push({text:a.slice(o),match:!1}),r===t.length?e:[{text:a,match:!1}]}var y=`
+  .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);
   }
-  selectItem(item) {
-    const label = typeof item === "string" ? item : item.label;
-    const value = typeof item !== "string" ? item.value : void 0;
-    const subtitle = typeof item !== "string" ? item.subtitle : null;
-    if (this.state.stage === "final") {
-      this.finishSelection(label, value);
-      return;
-    }
-    this.processSelection(label, subtitle);
-  }
-  shouldAutoInsertComma(currentVal) {
-    const isStartOfSegmentAndNumeric = !currentVal.includes(",") && PATTERNS.DIGITS_1_3.test(currentVal.trim());
-    if (isStartOfSegmentAndNumeric) return true;
-    if (this.state.stage === "house_number") {
-      const currentFragment = this.getCurrentFragment(currentVal);
-      return PATTERNS.DIGITS_1_3.test(currentFragment);
-    }
-    return false;
-  }
-  finishSelection(label, value) {
-    this.updateState({ query: label, suggestions: [], cities: [], streets: [], isValid: true });
-    this.onSelect(value || label);
-  }
-  processSelection(label, subtitle) {
-    const { stage, query } = this.state;
-    let nextQuery = query;
-    const isContextualSelection = subtitle && (stage === "city" || stage === "street" || stage === "mixed");
-    if (isContextualSelection) {
-      if (stage === "city") {
-        nextQuery = `${subtitle}, ${label}, `;
-      } else {
-        const prefix = this.getQueryPrefix(query);
-        nextQuery = prefix ? `${prefix} ${label}, ${subtitle}, ` : `${label}, ${subtitle}, `;
-      }
-      this.updateQueryAndFetch(nextQuery);
-      return;
-    }
-    if (stage === "direct" || stage === "addition") {
-      this.finishSelection(label);
-      this.handleInput(label);
-      return;
-    }
-    const hasComma = query.includes(",");
-    const isFirstSegment = !hasComma && (stage === "city" || stage === "street" || stage === "house_number_first");
-    if (isFirstSegment) {
-      nextQuery = `${label}, `;
-    } else {
-      nextQuery = this.replaceLastSegment(query, label);
-      if (stage !== "house_number") {
-        nextQuery += ", ";
-      }
+
+  .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;
     }
-    this.updateQueryAndFetch(nextQuery);
-  }
-  executeFetch(val) {
-    const text = (val || "").toString();
-    if (!text.trim()) {
-      this.abortController?.abort();
-      this.resetState();
-      return;
+  }
+
+  .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;
     }
-    this.updateState({ isError: false });
-    if (this.abortController) this.abortController.abort();
-    this.abortController = new AbortController();
-    const url = new URL(`${this.apiUrl}/infer/${this.country.toLowerCase()}`);
-    const params = {
-      authKey: this.authKey,
-      query: text,
-      limit: this.limit.toString()
-    };
-    url.search = new URLSearchParams(params).toString();
-    this.fetcher(url.toString(), { signal: this.abortController.signal }).then((res) => {
-      if (!res.ok) throw new Error("Network error");
-      return res.json();
-    }).then((data) => this.mapResponseToState(data)).catch((e) => {
-      if (e.name !== "AbortError") {
-        this.updateState({ isError: true, isLoading: false });
-      }
-    });
-  }
-  mapResponseToState(data) {
-    const newState = {
-      stage: data.stage,
-      isLoading: false
-    };
-    if (data.stage === "mixed") {
-      newState.cities = data.cities || [];
-      newState.streets = data.streets || [];
-      newState.suggestions = [];
-    } else {
-      newState.suggestions = data.suggestions || [];
-      newState.cities = [];
-      newState.streets = [];
+  }
+
+  .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;
     }
-    newState.isValid = data.stage === "final";
-    this.updateState(newState);
-  }
-  updateQueryAndFetch(nextQuery) {
-    this.updateState({ query: nextQuery, suggestions: [], cities: [], streets: [] });
-    this.handleInput(nextQuery);
-  }
-  replaceLastSegment(fullText, newSegment) {
-    const lastCommaIndex = fullText.lastIndexOf(",");
-    if (lastCommaIndex === -1) return newSegment;
-    return `${fullText.slice(0, lastCommaIndex + 1)} ${newSegment}`.trim();
-  }
-  getQueryPrefix(q) {
-    const lastComma = q.lastIndexOf(",");
-    return lastComma === -1 ? "" : q.slice(0, lastComma + 1).trimEnd();
-  }
-  getCurrentFragment(q) {
-    return (q.split(",").slice(-1)[0] ?? "").trim();
-  }
-  resetState() {
-    this.updateState({ ...INITIAL_STATE, query: this.state.query });
-  }
-  updateState(updates) {
-    this.state = { ...this.state, ...updates };
-    this.onStateChange(this.state);
-  }
-  debounce(func, wait) {
-    let timeout;
-    return (...args) => {
-      if (timeout) clearTimeout(timeout);
-      timeout = setTimeout(() => func.apply(this, args), wait);
-    };
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  INITIAL_STATE,
-  InferCore
-});
+  }
+
+  .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); }
+  }
+`;export{y as DEFAULT_STYLES,f as INITIAL_STATE,m as InferCore,T as getHighlightSegments};

package/package.json

@@ -1,14 +1,39 @@
 {
   "name": "@pro6pp/infer-core",
-  "version": "0.0.2-beta.0",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
+  "type": "module",
+  "description": "Core logic and client for the Pro6PP Infer API.",
+  "homepage": "https://github.com/pro6pp/infer-sdk/tree/main/packages/core",
+  "keywords": [
+    "pro6pp",
+    "infer-api",
+    "sdk",
+    "core",
+    "headless",
+    "address",
+    "autocomplete",
+    "validation",
+    "postal-code",
+    "netherlands",
+    "germany",
+    "api-client",
+    "typescript"
+  ],
+  "bugs": {
+    "url": "https://github.com/pro6pp/infer-sdk/issues"
+  },
+  "sideEffects": false,
+  "version": "0.0.2-beta.10",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.global.js",
+  "jsdelivr": "./dist/index.global.js",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "script": "./dist/index.global.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
@@ -16,9 +41,11 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "type-check": "tsc --noEmit"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -30,6 +57,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://gitlab.d-centralize.nl/dc/pro6pp/pro6pp-infer-sdk"
+    "url": "git+https://github.com/pro6pp/infer-sdk.git",
+    "directory": "packages/core"
   }
 }

package/dist/index.d.mts

@@ -1,130 +0,0 @@
-/**
- * Supported ISO 3166-1 alpha-2 country codes.
- */
-type CountryCode = 'NL' | 'DE';
-/**
- * The current step in the address inference process.
- */
-type Stage = 'empty' | 'mixed' | 'street' | 'city' | 'postcode' | 'house_number' | 'house_number_first' | 'addition' | 'direct' | 'final';
-/**
- * The standardized address object returned upon selection.
- */
-interface AddressValue {
-    street: string;
-    city: string;
-    street_number?: string | number;
-    house_number?: string | number;
-    postcode?: string;
-    postcode_full?: string;
-    addition?: string;
-    /** Allow for extra fields if API expands. */
-    [key: string]: unknown;
-}
-/**
- * A single item in the dropdown list.
- */
-interface InferResult {
-    /** The text to display in the UI (e.g. "Amsterdam"). */
-    label: string;
-    /** The actual address data. Only present if this result completes an address. */
-    value?: AddressValue;
-    /** Helper text. */
-    subtitle?: string | null;
-    /** Number of underlying results (optional). */
-    count?: number | string;
-}
-/**
- * The complete state returned by the `useInfer` hook.
- */
-interface InferState {
-    /** The current value of the input field. */
-    query: string;
-    /** The current inference stage. */
-    stage: Stage | null;
-    /** List of cities to display, specific to `mixed` mode. */
-    cities: InferResult[];
-    /** List of streets to display, specific to `mixed` mode. */
-    streets: InferResult[];
-    /** General suggestions to display. */
-    suggestions: InferResult[];
-    /** True if a full, valid address has been selected. */
-    isValid: boolean;
-    /** True if the last network request failed. */
-    isError: boolean;
-    /** True if a network request is currently active. */
-    isLoading: boolean;
-}
-/**
- * Custom fetch implementation, compatible with `window.fetch`.
- * Useful for server-side usage or testing.
- */
-type Fetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-/**
- * Configuration for Infer Core.
- */
-interface InferConfig {
-    /**
-     * Pro6PP Authorization Key.
-     */
-    authKey: string;
-    /**
-     * Country to search addresses in.
-     */
-    country: CountryCode;
-    /**
-     * Base URL for the Pro6PP API.
-     * Useful for proxying requests through your own backend.
-     * @default 'https://api.pro6pp.nl/v2'
-     */
-    apiUrl?: string;
-    /**
-     * Custom fetch implementation.
-     * Useful for server-side usage or testing.
-     */
-    fetcher?: Fetcher;
-    /**
-     * Maximum number of results to return.
-     * @default 1000
-     */
-    limit?: number;
-    /**
-     * Callback fired when the internal state changes.
-     */
-    onStateChange?: (state: InferState) => void;
-    /**
-     * Callback fired when a user selects a full valid address.
-     */
-    onSelect?: (selection: AddressValue | string | null) => void;
-}
-
-declare const INITIAL_STATE: InferState;
-declare class InferCore {
-    private country;
-    private authKey;
-    private apiUrl;
-    private limit;
-    private fetcher;
-    private onStateChange;
-    private onSelect;
-    state: InferState;
-    private abortController;
-    private debouncedFetch;
-    constructor(config: InferConfig);
-    handleInput(value: string): void;
-    handleKeyDown(event: KeyboardEvent | React.KeyboardEvent<HTMLInputElement>): void;
-    selectItem(item: InferResult | string): void;
-    private shouldAutoInsertComma;
-    private finishSelection;
-    private processSelection;
-    private executeFetch;
-    private mapResponseToState;
-    private updateQueryAndFetch;
-    private replaceLastSegment;
-    private getQueryPrefix;
-    private getCurrentFragment;
-    private resetState;
-    private updateState;
-    private debounce;
-}
-
-export { type AddressValue, type CountryCode, type Fetcher, INITIAL_STATE, type InferConfig, InferCore, type InferResult, type InferState, type Stage };