@conduction/nextcloud-vue 2.108.0 → 2.109.0

package/l10n/en.json

@@ -1815,7 +1815,104 @@
     "{name} moved to place {place} of {total}": "{name} moved to place {place} of {total}",
     "The new order could not be saved.": "The new order could not be saved.",
     "{field} is already used; choose another value.": "{field} is already used; choose another value.",
-    "One per line": "One per line"
+    "One per line": "One per line",
+    "This may already exist": "This may already exist",
+    "Why file it anyway": "Why file it anyway",
+    "This cannot be filed twice. Open the one it matches, or ask a coordinator.": "This cannot be filed twice. Open the one it matches, or ask a coordinator.",
+    "File it anyway": "File it anyway",
+    "A record you may not open": "A record you may not open",
+    "Matched on the score, not on a single field": "Matched on the score, not on a single field",
+    "This list could not be read": "This list could not be read",
+    "Try again": "Try again",
+    "Nothing to decide right now.": "Nothing to decide right now.",
+    "Your answer": "Your answer",
+    "Why?": "Why?",
+    "Record this decision": "Record this decision",
+    "This decision was not recorded.": "This decision was not recorded.",
+    "This search could not be read from character {position}.": "This search could not be read from character {position}.",
+    "Correct that character, or search for plain words. AND, OR and NOT work in capitals, and quotes make a phrase.": "Correct that character, or search for plain words. AND, OR and NOT work in capitals, and quotes make a phrase.",
+    "This list could not be read.": "This list could not be read.",
+    "Nothing to show": "Nothing to show",
+    "What happens to this record once it is closed": "What happens to this record once it is closed",
+    "The archival facts are unavailable": "The archival facts are unavailable",
+    "Archived on {at} by {by}. {reason}": "Archived on {at} by {by}. {reason}",
+    "This record and OpenRegister do not agree on whether it is archived.": "This record and OpenRegister do not agree on whether it is archived.",
+    "Nothing could decide what happens to this record.": "Nothing could decide what happens to this record.",
+    "This record has not been closed yet. Its archival future is recorded when it closes.": "This record has not been closed yet. Its archival future is recorded when it closes.",
+    "Handed over as {kind} on {at} by {by}.": "Handed over as {kind} on {at} by {by}.",
+    "Transfer list": "Transfer list",
+    "Recomputing needs the archivist role": "Recomputing needs the archivist role",
+    "Why are you recomputing this?": "Why are you recomputing this?",
+    "This is recorded against {user}.": "This is recorded against {user}.",
+    "Recompute the nomination": "Recompute the nomination",
+    "Selection list row": "Selection list row",
+    "Decided by": "Decided by",
+    "Written on": "Written on",
+    "Decided when it closes": "Decided when it closes",
+    "Not yet": "Not yet",
+    "This widget has no record to read.": "This widget has no record to read.",
+    "The plan is unavailable": "The plan is unavailable",
+    "This record has no plan": "This record has no plan",
+    "You are not allowed to see this plan.": "You are not allowed to see this plan.",
+    "The plan could not be loaded. Try again.": "The plan could not be loaded. Try again.",
+    "Start": "Start",
+    "Stop": "Stop",
+    "Can start": "Can start",
+    "Stopped": "Stopped",
+    "Not needed": "Not needed",
+    "Search an address": "Search an address",
+    "Street, postcode or place": "Street, postcode or place",
+    "Address search is not available right now.": "Address search is not available right now.",
+    "Address": "Address",
+    "Street": "Street",
+    "Place": "Place",
+    "Postcode": "Postcode",
+    "{source} could not be read, so this list is incomplete.": "{source} could not be read, so this list is incomplete.",
+    "This queue could not be read": "This queue could not be read",
+    "Nothing is waiting on you.": "Nothing is waiting on you.",
+    "Hide this group until tomorrow": "Hide this group until tomorrow",
+    "Hide until tomorrow": "Hide until tomorrow",
+    "Covering for {person}": "Covering for {person}",
+    "Hidden until tomorrow": "Hidden until tomorrow",
+    "Show {group} again": "Show {group} again",
+    "the applicant": "the applicant",
+    "a third party": "a third party",
+    "us": "us",
+    "Waiting on {party} for {days} days": "Waiting on {party} for {days} days",
+    "Waiting on {party} for {days} days, chased once": "Waiting on {party} for {days} days, chased once",
+    "Waiting on {party} for {days} days, chased {chases} times": "Waiting on {party} for {days} days, chased {chases} times",
+    "Previous document": "Previous document",
+    "Next document": "Next document",
+    "Record redaction": "Record redaction",
+    "No document here needs redacting.": "No document here needs redacting.",
+    "Document {index} of {count}": "Document {index} of {count}",
+    "Redacted copy recorded": "Redacted copy recorded",
+    "Upload redacted version": "Upload redacted version",
+    "Document without a title": "Document without a title",
+    "Finding the passages to redact…": "Finding the passages to redact…",
+    "No text was extracted from this document.": "No text was extracted from this document.",
+    "Proposal": "Proposal",
+    "Always redacted by rule": "Always redacted by rule",
+    "Verdict for {passage}": "Verdict for {passage}",
+    "Passage type": "Passage type",
+    "Passage text": "Passage text",
+    "Add passage": "Add passage",
+    "Redact: {title}": "Redact: {title}",
+    "Redact documents": "Redact documents",
+    "Agreed": "Agreed",
+    "Adjust": "Adjust",
+    "Do not redact": "Do not redact",
+    "The documents could not be read.": "The documents could not be read.",
+    "The passages of this document could not be found. Upload a redacted version instead.": "The passages of this document could not be found. Upload a redacted version instead.",
+    "The redacted copy could not be made. Upload a redacted version instead.": "The redacted copy could not be made. Upload a redacted version instead.",
+    "The redacted version could not be stored. Try again.": "The redacted version could not be stored. Try again.",
+    "The redacted copy is recorded. Only this copy will be published.": "The redacted copy is recorded. Only this copy will be published.",
+    "Assign": "Assign",
+    "New handler": "New handler",
+    "New team": "New team",
+    "Why it is moving": "Why it is moving",
+    "Use \"{name}\"": "Use \"{name}\"",
+    "It was not handed over.": "It was not handed over."
   },
   "plurals": {
     "{count} member": [
@@ -1937,6 +2034,14 @@
     "{count} open": [
       "{count} open",
       "{count} open"
+    ],
+    "%n existing record looks like this one.": [
+      "%n existing record looks like this one.",
+      "%n existing records look like this one."
+    ],
+    "%n passage found. Review each one.": [
+      "%n passage found. Review each one.",
+      "%n passages found. Review each one."
     ]
   }
 }

package/l10n/nl.json

@@ -2028,7 +2028,103 @@
     "{name} moved to place {place} of {total}": "{name} staat nu op plaats {place} van {total}",
     "The new order could not be saved.": "De nieuwe volgorde kon niet worden opgeslagen.",
     "{field} is already used; choose another value.": "{field} is al in gebruik; kies een andere waarde.",
-    "One per line": "Eén per regel"
+    "One per line": "Eén per regel",
+    "This may already exist": "Dit bestaat mogelijk al",
+    "Why file it anyway": "Waarom toch vastleggen",
+    "This cannot be filed twice. Open the one it matches, or ask a coordinator.": "Dit kan niet twee keer worden vastgelegd. Open het item waarmee het overeenkomt, of vraag een coördinator.",
+    "File it anyway": "Toch vastleggen",
+    "A record you may not open": "Een item dat je niet mag openen",
+    "Matched on the score, not on a single field": "Gevonden op de score, niet op één veld",
+    "This list could not be read": "Deze lijst kon niet worden gelezen",
+    "Nothing to decide right now.": "Er is nu niets te beslissen.",
+    "Your answer": "Je antwoord",
+    "Why?": "Waarom?",
+    "Record this decision": "Dit besluit vastleggen",
+    "This decision was not recorded.": "Dit besluit is niet vastgelegd.",
+    "This search could not be read from character {position}.": "Deze zoekopdracht kon niet worden gelezen vanaf teken {position}.",
+    "Correct that character, or search for plain words. AND, OR and NOT work in capitals, and quotes make a phrase.": "Verbeter dat teken, of zoek op gewone woorden. AND, OR en NOT werken in hoofdletters, en aanhalingstekens maken een zinsdeel.",
+    "This list could not be read.": "Deze lijst kon niet worden gelezen.",
+    "Nothing to show": "Niets om te tonen",
+    "What happens to this record once it is closed": "Wat er met dit item gebeurt als het is afgesloten",
+    "The archival facts are unavailable": "De archiefgegevens zijn niet beschikbaar",
+    "Archived on {at} by {by}. {reason}": "Gearchiveerd op {at} door {by}. {reason}",
+    "This record and OpenRegister do not agree on whether it is archived.": "Dit item en OpenRegister zijn het niet eens over of het gearchiveerd is.",
+    "Nothing could decide what happens to this record.": "Niets kon bepalen wat er met dit item gebeurt.",
+    "This record has not been closed yet. Its archival future is recorded when it closes.": "Dit item is nog niet afgesloten. Wat ermee gebeurt wordt vastgelegd als het sluit.",
+    "Handed over as {kind} on {at} by {by}.": "Overgedragen als {kind} op {at} door {by}.",
+    "Transfer list": "Overbrengingslijst",
+    "Recomputing needs the archivist role": "Opnieuw berekenen vraagt de rol archivaris",
+    "Why are you recomputing this?": "Waarom bereken je dit opnieuw?",
+    "This is recorded against {user}.": "Dit wordt vastgelegd op naam van {user}.",
+    "Recompute the nomination": "Bereken de nominatie opnieuw",
+    "Selection list row": "Selectielijstregel",
+    "Decided by": "Bepaald door",
+    "Written on": "Vastgelegd op",
+    "Decided when it closes": "Bepaald bij afsluiten",
+    "Not yet": "Nog niet",
+    "This widget has no record to read.": "Deze widget heeft geen item om te lezen.",
+    "The plan is unavailable": "Het plan is niet beschikbaar",
+    "This record has no plan": "Dit item heeft geen plan",
+    "You are not allowed to see this plan.": "Je mag dit plan niet zien.",
+    "The plan could not be loaded. Try again.": "Het plan kon niet worden geladen. Probeer het opnieuw.",
+    "Start": "Starten",
+    "Stop": "Stoppen",
+    "Can start": "Kan starten",
+    "Stopped": "Gestopt",
+    "Not needed": "Niet nodig",
+    "Search an address": "Zoek een adres",
+    "Street, postcode or place": "Straat, postcode of plaats",
+    "Address search is not available right now.": "Adres zoeken is nu niet beschikbaar.",
+    "Address": "Adres",
+    "Street": "Straat",
+    "Place": "Plaats",
+    "Postcode": "Postcode",
+    "{source} could not be read, so this list is incomplete.": "{source} kon niet worden gelezen, dus deze lijst is niet compleet.",
+    "This queue could not be read": "Deze wachtrij kon niet worden gelezen",
+    "Nothing is waiting on you.": "Er wacht niets op je.",
+    "Hide this group until tomorrow": "Verberg deze groep tot morgen",
+    "Hide until tomorrow": "Verberg tot morgen",
+    "Covering for {person}": "Waarneming voor {person}",
+    "Hidden until tomorrow": "Verborgen tot morgen",
+    "Show {group} again": "{group} weer tonen",
+    "the applicant": "de aanvrager",
+    "a third party": "een derde",
+    "us": "ons",
+    "Waiting on {party} for {days} days": "Wacht {days} dagen op {party}",
+    "Waiting on {party} for {days} days, chased once": "Wacht {days} dagen op {party}, één keer gerappelleerd",
+    "Waiting on {party} for {days} days, chased {chases} times": "Wacht {days} dagen op {party}, {chases} keer gerappelleerd",
+    "Previous document": "Vorig document",
+    "Next document": "Volgend document",
+    "Record redaction": "Lakken vastleggen",
+    "No document here needs redacting.": "Hier hoeft geen document gelakt te worden.",
+    "Document {index} of {count}": "Document {index} van {count}",
+    "Redacted copy recorded": "Gelakte kopie vastgelegd",
+    "Upload redacted version": "Gelakte versie uploaden",
+    "Document without a title": "Document zonder titel",
+    "Finding the passages to redact…": "De te lakken passages worden gezocht…",
+    "No text was extracted from this document.": "Uit dit document is geen tekst gehaald.",
+    "Proposal": "Voorstel",
+    "Always redacted by rule": "Altijd gelakt volgens regel",
+    "Verdict for {passage}": "Oordeel over {passage}",
+    "Passage type": "Soort passage",
+    "Passage text": "Tekst van de passage",
+    "Add passage": "Passage toevoegen",
+    "Redact: {title}": "Lakken: {title}",
+    "Redact documents": "Documenten lakken",
+    "Agreed": "Akkoord",
+    "Adjust": "Aanpassen",
+    "Do not redact": "Niet lakken",
+    "The documents could not be read.": "De documenten konden niet worden gelezen.",
+    "The passages of this document could not be found. Upload a redacted version instead.": "De passages van dit document konden niet worden gevonden. Upload in plaats daarvan een gelakte versie.",
+    "The redacted copy could not be made. Upload a redacted version instead.": "De gelakte kopie kon niet worden gemaakt. Upload in plaats daarvan een gelakte versie.",
+    "The redacted version could not be stored. Try again.": "De gelakte versie kon niet worden opgeslagen. Probeer het opnieuw.",
+    "The redacted copy is recorded. Only this copy will be published.": "De gelakte kopie is vastgelegd. Alleen deze kopie wordt gepubliceerd.",
+    "Assign": "Toewijzen",
+    "New handler": "Nieuwe behandelaar",
+    "New team": "Nieuw team",
+    "Why it is moving": "Waarom het overgaat",
+    "Use \"{name}\"": "\"{name}\" gebruiken",
+    "It was not handed over.": "Het is niet overgedragen."
   },
   "plurals": {
     "{count} member": [
@@ -2150,6 +2246,14 @@
     "{count} open": [
       "{count} open",
       "{count} open"
+    ],
+    "%n existing record looks like this one.": [
+      "%n bestaand item lijkt hierop.",
+      "%n bestaande items lijken hierop."
+    ],
+    "%n passage found. Review each one.": [
+      "%n passage gevonden. Beoordeel elke passage.",
+      "%n passages gevonden. Beoordeel elke passage."
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.108.0",
+  "version": "2.109.0",
   "description": "Shared Vue component library for Conduction Nextcloud apps — complements @nextcloud/vue with higher-level components, OpenRegister integration, and NL Design System support",
   "homepage": "https://github.com/ConductionNL/nextcloud-vue#readme",
   "bugs": {

package/src/components/CnAddressSearch/CnAddressSearch.vue

@@ -0,0 +1,343 @@
+<!--
+  - SPDX-FileCopyrightText: 2026 Conduction B.V.
+  - SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<div class="cn-address-search" data-testid="cn-address-search">
+		<CnSearchSelect
+			:modelValue="selectedOption ? selectedOption.id : null"
+			:options="shownOptions"
+			:inputLabel="inputLabel || t('nextcloud-vue', 'Search an address')"
+			:labelOutside="labelOutside"
+			:placeholder="placeholder || t('nextcloud-vue', 'Street, postcode or place')"
+			:loading="searching"
+			:filterable="false"
+			:clearable="clearable"
+			:disabled="disabled"
+			@search="onSearch"
+			@update:modelValue="onPick" />
+		<p v-if="unavailable"
+			class="cn-address-search__note"
+			role="status"
+			data-testid="cn-address-search-unavailable">
+			{{ t('nextcloud-vue', 'Address search is not available right now.') }}
+		</p>
+	</div>
+</template>
+
+<script>
+import axios from '@nextcloud/axios'
+import { t } from '@nextcloud/l10n'
+import { generateUrl } from '@nextcloud/router'
+import { prefixUrl } from '../../utils/headers.js'
+import { CnSearchSelect } from '../CnSearchSelect/index.js'
+
+/** How long typing rests before a search runs, in ms. */
+const SEARCH_DELAY = 250
+
+/** The id the current value carries in the option list. */
+const CURRENT_ID = '__cn-address-current'
+
+/**
+ * WGS84 coordinates from a Locatieserver document: a normalised
+ * `location.coordinates` (`[lng, lat]`) or a raw `centroide_ll` WKT point.
+ *
+ * @param {object|null} doc The document.
+ * @return {{lat: number, lng: number}|null} The coordinates, or null.
+ */
+export function addressCoordinates(doc) {
+	if (!doc) {
+		return null
+	}
+	if (Array.isArray(doc.location?.coordinates)) {
+		const [lng, lat] = doc.location.coordinates
+		return { lat, lng }
+	}
+	const match = typeof doc.centroide_ll === 'string' ? doc.centroide_ll.match(/POINT\(([^ ]+) ([^ ]+)\)/) : null
+	return match ? { lng: parseFloat(match[1]), lat: parseFloat(match[2]) } : null
+}
+
+/**
+ * A Locatieserver document's display text.
+ *
+ * @param {object|null} doc The document.
+ * @return {string} The address text.
+ */
+export function addressText(doc) {
+	return doc ? doc.displayName || doc.weergavenaam || doc.display || '' : ''
+}
+
+/**
+ * CnAddressSearch — an address field over the PDOK Locatieserver (BAG
+ * addresses, streets, places and postcodes): suggestions as the user types,
+ * a free-text search when nothing is suggested, and on a pick the full
+ * document with its coordinates. Built on CnSearchSelect.
+ *
+ * Browsers never call api.pdok.nl directly (ADR-022): requests go to a
+ * PDOK proxy with `suggest`, `free` and `lookup/{id}` routes. By default
+ * that is the `/api/pdok` route of the first installed app among
+ * `appCandidates` (integriq, then openconnector); `endpoint` names another
+ * base URL. When the proxy answers 404 or 503 the field says address search
+ * is unavailable and stays usable, so a form around it can still be saved.
+ *
+ * `select` emits `{ result, coordinates, address }`: the looked-up document,
+ * `{ lat, lng }` or null, and the display text. `update:modelValue` emits
+ * the display text, or null when cleared.
+ *
+ * ```vue
+ * <CnAddressSearch v-model="caseObject.address" @select="onAddress" />
+ * ```
+ */
+export default {
+	name: 'CnAddressSearch',
+
+	components: { CnSearchSelect },
+
+	props: {
+		/** The chosen address text. */
+		modelValue: {
+			type: String,
+			default: null,
+		},
+
+		/** Base URL of the PDOK proxy; empty resolves it from `appCandidates`. */
+		endpoint: {
+			type: String,
+			default: '',
+		},
+
+		/** App ids that serve `/api/pdok`, newest first; the first installed one wins. */
+		appCandidates: {
+			type: Array,
+			default: () => ['integriq', 'openconnector'],
+		},
+
+		/** The field's label; defaults to "Search an address". */
+		inputLabel: {
+			type: String,
+			default: '',
+		},
+
+		/** Draw the label above the field. */
+		labelOutside: {
+			type: Boolean,
+			default: false,
+		},
+
+		/** Placeholder; defaults to "Street, postcode or place". */
+		placeholder: {
+			type: String,
+			default: '',
+		},
+
+		/** Offer a clear button. */
+		clearable: {
+			type: Boolean,
+			default: true,
+		},
+
+		/** Disable the field. */
+		disabled: {
+			type: Boolean,
+			default: false,
+		},
+
+		/** The fewest characters a search needs. */
+		minLength: {
+			type: Number,
+			default: 3,
+		},
+
+		/** The most results a free-text search returns. */
+		rows: {
+			type: Number,
+			default: 10,
+		},
+	},
+
+	emits: ['update:modelValue', 'select'],
+
+	data() {
+		return {
+			options: [],
+			searching: false,
+			unavailable: false,
+			timer: null,
+			searchSeq: 0,
+		}
+	},
+
+	computed: {
+		/**
+		 * The current value as an option, so the field shows it.
+		 *
+		 * @return {object|null}
+		 */
+		selectedOption() {
+			return this.modelValue ? { id: CURRENT_ID, label: this.modelValue, icon: 'MapMarkerOutline' } : null
+		},
+
+		/**
+		 * The suggestions, with the current value kept in the list.
+		 *
+		 * @return {Array<object>}
+		 */
+		shownOptions() {
+			return this.selectedOption ? [this.selectedOption, ...this.options] : this.options
+		},
+
+		/**
+		 * The proxy's base URL.
+		 *
+		 * @spec openspec/changes/address-search/specs/address-search/spec.md#requirement-an-address-field-over-the-pdok-locatieserver
+		 * @return {string}
+		 */
+		baseUrl() {
+			if (this.endpoint) {
+				return this.endpoint.replace(/\/+$/, '')
+			}
+			const roots = (typeof window !== 'undefined' && window.OC && window.OC.appswebroots) || {}
+			const app = this.appCandidates.find((id) => Object.hasOwn(roots, id)) || this.appCandidates[0] || 'integriq'
+			return generateUrl(`/apps/${app}/api/pdok`)
+		},
+	},
+
+	beforeUnmount() {
+		clearTimeout(this.timer)
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * A document as a picker option.
+		 *
+		 * @param {object} doc The Locatieserver document.
+		 * @param {number} index Its place in the list, for documents without an id.
+		 * @return {object|null} The option, or null without a text.
+		 */
+		optionOf(doc, index) {
+			const label = addressText(doc)
+			if (!label) {
+				return null
+			}
+			const kinds = {
+				adres: t('nextcloud-vue', 'Address'),
+				address: t('nextcloud-vue', 'Address'),
+				weg: t('nextcloud-vue', 'Street'),
+				woonplaats: t('nextcloud-vue', 'Place'),
+				city: t('nextcloud-vue', 'Place'),
+				postcode: t('nextcloud-vue', 'Postcode'),
+			}
+			const municipality = doc.gemeentenaam && !label.includes(doc.gemeentenaam) ? doc.gemeentenaam : ''
+			return {
+				id: doc.id || `${CURRENT_ID}-${index}`,
+				label,
+				secondary: [kinds[doc.type] || '', municipality].filter(Boolean).join(' · '),
+				icon: 'MapMarkerOutline',
+				doc,
+			}
+		},
+
+		/**
+		 * Call the proxy; 404 or 503 marks search unavailable and yields `fallback`.
+		 *
+		 * @param {string} path The route under the base URL.
+		 * @param {object} params The query parameters.
+		 * @param {Array<object>} fallback What a degraded answer yields.
+		 * @return {Promise<Array<object>>} The documents.
+		 */
+		async request(path, params, fallback) {
+			try {
+				const { data } = await axios.get(prefixUrl(`${this.baseUrl}/${path}`), { params })
+				this.unavailable = false
+				return Array.isArray(data?.docs) ? data.docs : fallback
+			} catch (error) {
+				const status = error?.response?.status
+				if (status === 404 || status === 503) {
+					this.unavailable = true
+				}
+				return fallback
+			}
+		},
+
+		/**
+		 * Search after typing rests.
+		 *
+		 * @param {string} query The typed text.
+		 */
+		onSearch(query) {
+			clearTimeout(this.timer)
+			const term = String(query || '').trim()
+			if (term.length < this.minLength) {
+				this.options = []
+				return
+			}
+			this.timer = setTimeout(() => this.search(term), SEARCH_DELAY)
+		},
+
+		/**
+		 * Suggest addresses for the term; without suggestions, search free text.
+		 *
+		 * @spec openspec/changes/address-search/specs/address-search/spec.md#requirement-an-address-field-over-the-pdok-locatieserver
+		 * @param {string} term The search term.
+		 * @return {Promise<void>}
+		 */
+		async search(term) {
+			const seq = ++this.searchSeq
+			this.searching = true
+			let docs = await this.request('suggest', { q: term }, [])
+			if (!docs.length && !this.unavailable && seq === this.searchSeq) {
+				docs = await this.request('free', { q: term, rows: this.rows }, [])
+			}
+			if (seq !== this.searchSeq) {
+				return
+			}
+			this.options = docs.map((doc, index) => this.optionOf(doc, index)).filter(Boolean)
+			this.searching = false
+		},
+
+		/**
+		 * Take the picked suggestion: look up the full document, then emit it.
+		 *
+		 * @spec openspec/changes/address-search/specs/address-search/spec.md#requirement-an-address-field-over-the-pdok-locatieserver
+		 * @param {string|null} id The picked option's id.
+		 * @return {Promise<void>}
+		 */
+		async onPick(id) {
+			if (id === CURRENT_ID) {
+				return
+			}
+			const option = id === null ? null : this.options.find((o) => String(o.id) === String(id))
+			if (!option) {
+				/** @event update:modelValue The chosen address text, or null when cleared. */
+				this.$emit('update:modelValue', null)
+				/** @event select `{ result, coordinates, address }` for the chosen address, or null when cleared. */
+				this.$emit('select', null)
+				return
+			}
+			let result = option.doc
+			if (option.doc.id) {
+				const [full] = await this.request(`lookup/${encodeURIComponent(option.doc.id)}`, {}, [])
+				result = full || option.doc
+			}
+			const address = addressText(result) || option.label
+			this.options = []
+			this.$emit('update:modelValue', address)
+			this.$emit('select', { result, coordinates: addressCoordinates(result), address })
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-address-search {
+	width: 100%;
+}
+
+.cn-address-search__note {
+	margin: 4px 0 0;
+	color: var(--color-text-maxcontrast);
+	font-size: var(--font-size-small, 13px);
+}
+</style>

package/src/components/CnAddressSearch/index.js

@@ -0,0 +1,12 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnAddressSearch — an address field over the PDOK Locatieserver, through
+ * a PDOK proxy app, that emits the chosen address with its coordinates.
+ */
+
+import CnAddressSearch from './CnAddressSearch.vue'
+
+export { CnAddressSearch }
+export default CnAddressSearch