@conduction/nextcloud-vue 2.61.0 → 2.63.0

package/dist/esm/components/CnResourceSelect/CnResourceSelect.vue3.js.map

@@ -1 +1 @@
-{"version":3,"file":"CnResourceSelect.vue3.js","sources":["../../../../src/components/CnResourceSelect/CnResourceSelect.vue?vue&type=template&id=37b7ff6f&lang.js"],"sourcesContent":["<!--\n  - SPDX-FileCopyrightText: 2026 Conduction B.V.\n  - SPDX-License-Identifier: EUPL-1.2\n-->\n<template>\n\t<NcSelect\n\t\t:inputId=\"inputId\"\n\t\t:inputLabel=\"inputLabel\"\n\t\t:modelValue=\"selectedOption\"\n\t\t:options=\"displayOptions\"\n\t\t:loading=\"loading\"\n\t\t:clearable=\"clearable\"\n\t\t:disabled=\"disabled\"\n\t\t:placeholder=\"placeholder\"\n\t\t:filterable=\"false\"\n\t\tlabel=\"label\"\n\t\t@search=\"onSearch\"\n\t\t@update:modelValue=\"onInput\">\n\t\t<template #option=\"{ label: optLabel, __create }\">\n\t\t\t<span v-if=\"__create\" class=\"cn-resource-select__create\">\n\t\t\t\t<Plus :size=\"16\" />\n\t\t\t\t{{ createLabelFor(optLabel) }}\n\t\t\t</span>\n\t\t\t<span v-else>{{ optLabel }}</span>\n\t\t</template>\n\t</NcSelect>\n</template>\n\n<script>\nimport { translate as t } from '@nextcloud/l10n'\nimport { NcSelect } from '@nextcloud/vue'\nimport Plus from 'vue-material-design-icons/Plus.vue'\nimport { useObjectStore } from '../../store/index.js'\n\n/**\n * CnResourceSelect — an OpenRegister object picker that can CREATE from the\n * search term.\n *\n * Searches a `register` + `schema` for objects matching the typed text and\n * renders them as options. When the typed term matches no existing object, a\n * synthetic **\"Create '<term>'\"** option appears at the bottom; choosing it\n * persists a new object (via `useObjectStore().saveObject`, writing the term to\n * `labelField`) and selects it — so an agent who can't find a client just types\n * the name and makes one inline, never hitting a dead \"no results\" end.\n *\n * Emits `update:modelValue` (the selected object's id) and `create` (the\n * freshly-created object). The label of each option comes from `labelField`\n * (default `name`), the value from the object's id.\n *\n * Backwards-compatible, self-contained: it owns its own search + create flow,\n * so a consumer only needs to pass `register` + `schema` and bind `modelValue`.\n *\n * Three opt-in props cover the cases a plain object picker cannot:\n *\n *  - `filters` SCOPES the options to a parent selection, which is what makes a\n *    cascading pair work (pick a client, then only that client's contacts are\n *    offered). Changing the scope clears a now-invalid selection.\n *  - `preload` fetches a first page on mount so the field can be BROWSED, not\n *    only searched — the behaviour a user expects from a select.\n *  - `createHandler` replaces the built-in save. Creating from a bare term only\n *    works while the term is enough to satisfy the schema; the moment a\n *    required field must come from somewhere else (a server-minted key, a value\n *    worth collecting in a full dialog) the consumer owns the create and\n *    resolves the finished object back.\n *\n * Example:\n * ```vue\n * <CnResourceSelect\n *   register=\"pipelinq\"\n *   schema=\"client\"\n *   label-field=\"name\"\n *   :model-value=\"clientId\"\n *   :input-label=\"t('pipelinq', 'Client')\"\n *   @update:modelValue=\"clientId = $event\"\n *   @create=\"onClientCreated\" />\n * ```\n */\nexport default {\n\tname: 'CnResourceSelect',\n\n\tcomponents: { NcSelect, Plus },\n\n\tprops: {\n\t\t/** OpenRegister register slug to search/create in. */\n\t\tregister: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** OpenRegister schema slug to search/create in. */\n\t\tschema: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** Currently-selected object id (v-model). */\n\t\tmodelValue: {\n\t\t\ttype: [String, Number],\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Object field used as the option label AND written on create. */\n\t\tlabelField: {\n\t\t\ttype: String,\n\t\t\tdefault: 'name',\n\t\t},\n\n\t\t/** Accessible input label for the underlying NcSelect. */\n\t\tinputLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** DOM id for the input (a11y association). */\n\t\tinputId: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Whether the selection can be cleared. */\n\t\tclearable: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: true,\n\t\t},\n\n\t\t/** Minimum characters before searching / offering create. */\n\t\tminChars: {\n\t\t\ttype: Number,\n\t\t\tdefault: 2,\n\t\t},\n\n\t\t/**\n\t\t * Whether to offer the inline \"Create '<term>'\" option when the search\n\t\t * yields no exact match. Off → behaves like a plain async object select.\n\t\t */\n\t\tallowCreate: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: true,\n\t\t},\n\n\t\t/**\n\t\t * Extra fields merged into the payload when creating a new object (e.g.\n\t\t * a fixed `type` or `status`). The `labelField` is always set to the term.\n\t\t *\n\t\t * @type {object}\n\t\t */\n\t\tcreateDefaults: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/**\n\t\t * Field filters merged into the search query, so the option list can be\n\t\t * SCOPED to a parent selection — the cascading-select case (pick a\n\t\t * client, then only that client's contacts are offered). Changing this\n\t\t * reloads the options and clears a selection that no longer belongs to\n\t\t * the new scope.\n\t\t *\n\t\t * Example: `:filters=\"{ client: form.client }\"`.\n\t\t *\n\t\t * @type {object}\n\t\t */\n\t\tfilters: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/**\n\t\t * Load a first page of options on mount (and whenever `filters`\n\t\t * change) instead of waiting for `minChars` of typing. Lets the field\n\t\t * be BROWSED like a plain select while still searching server-side once\n\t\t * the user types. Off by default so existing consumers keep their\n\t\t * search-only behaviour and issue no extra request.\n\t\t */\n\t\tpreload: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\n\t\t/**\n\t\t * Disable the input — e.g. a dependent select waiting on its parent.\n\t\t */\n\t\tdisabled: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\n\t\t/** Placeholder text for the underlying NcSelect. */\n\t\tplaceholder: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/**\n\t\t * Override how a new object is created from the typed term. Receives\n\t\t * `(term, payload)` and MUST resolve to the created object (or a falsy\n\t\t * value to abort, e.g. the user cancelled a dialog).\n\t\t *\n\t\t * Without it the component posts `payload` straight to\n\t\t * `objectStore.saveObject`, which is wrong whenever the schema requires\n\t\t * a field the term cannot supply — a server-minted foreign key, say, or\n\t\t * anything the consumer would rather collect in a full create dialog.\n\t\t *\n\t\t * @type {((term: string, payload: object) => Promise<object|null>)|null}\n\t\t */\n\t\tcreateHandler: {\n\t\t\ttype: Function,\n\t\t\tdefault: null,\n\t\t},\n\t},\n\n\temits: ['update:modelValue', 'create'],\n\n\tdata() {\n\t\treturn {\n\t\t\tsearch: '',\n\t\t\tloading: false,\n\t\t\toptions: [],\n\t\t\t// The selected option object kept locally so the label shows even\n\t\t\t// before/without a matching search result (e.g. a pre-set modelValue).\n\t\t\tlocalSelected: null,\n\t\t}\n\t},\n\n\tcomputed: {\n\t\t/** Pinia object store handle (resolved lazily so a Pinia-less test still mounts). */\n\t\tobjectStore() {\n\t\t\ttry {\n\t\t\t\treturn useObjectStore()\n\t\t\t} catch {\n\t\t\t\treturn null\n\t\t\t}\n\t\t},\n\n\t\t/** The `${register}-${schema}` object-type slug used by the store. */\n\t\ttypeSlug() {\n\t\t\treturn `${this.register}-${this.schema}`\n\t\t},\n\n\t\t/** The currently-selected option, for NcSelect's model-value. */\n\t\tselectedOption() {\n\t\t\tif (this.localSelected && this.localSelected.value === this.modelValue) {\n\t\t\t\treturn this.localSelected\n\t\t\t}\n\t\t\treturn this.options.find((o) => o.value === this.modelValue) || null\n\t\t},\n\n\t\t/**\n\t\t * The option list shown in the dropdown — the search results, plus a\n\t\t * synthetic \"Create '<term>'\" entry when create is allowed and the term\n\t\t * is long enough and matches no existing option label exactly.\n\t\t *\n\t\t * @return {Array<object>}\n\t\t */\n\t\tdisplayOptions() {\n\t\t\tconst opts = [...this.options]\n\t\t\tconst term = this.search.trim()\n\t\t\tif (this.allowCreate && term.length >= this.minChars) {\n\t\t\t\tconst exact = opts.some((o) => (o.label || '').toLowerCase() === term.toLowerCase())\n\t\t\t\tif (!exact) {\n\t\t\t\t\topts.push({ value: '__create__', label: term, __create: true })\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn opts\n\t\t},\n\n\t\t/**\n\t\t * Stable string identity for `filters`. Watching the object itself\n\t\t * would re-fire on every parent re-render (a fresh object literal is a\n\t\t * new identity even when the values are unchanged), reloading options\n\t\t * and clobbering the selection in a loop.\n\t\t *\n\t\t * @return {string}\n\t\t */\n\t\tfiltersKey() {\n\t\t\treturn JSON.stringify(this.filters || {})\n\t\t},\n\n\t\t/**\n\t\t * `filters` with empty entries dropped. A parent that has not been\n\t\t * chosen yet holds `null`, and forwarding `client=` as a query param\n\t\t * asks the API for objects whose client is the empty string — which\n\t\t * matches nothing and reads as \"no results\" rather than \"not scoped\".\n\t\t *\n\t\t * @return {object}\n\t\t */\n\t\tactiveFilters() {\n\t\t\tconst out = {}\n\t\t\tfor (const [key, value] of Object.entries(this.filters || {})) {\n\t\t\t\tif (value !== null && value !== undefined && value !== '') {\n\t\t\t\t\tout[key] = value\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn out\n\t\t},\n\t},\n\n\twatch: {\n\t\tmodelValue: {\n\t\t\timmediate: true,\n\t\t\thandler() {\n\t\t\t\tthis.ensureSelectedLoaded()\n\t\t\t},\n\t\t},\n\n\t\tfiltersKey(next, prev) {\n\t\t\tif (next === prev) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\t// The scope moved, so anything already selected may no longer be\n\t\t\t// in it. Drop the stale options + selection, then re-seed.\n\t\t\tthis.options = []\n\t\t\tif (this.modelValue) {\n\t\t\t\tthis.localSelected = null\n\t\t\t\tthis.$emit('update:modelValue', '')\n\t\t\t}\n\t\t\tif (this.search.trim().length >= this.minChars) {\n\t\t\t\tthis.onSearch(this.search)\n\t\t\t} else {\n\t\t\t\tthis.loadInitialOptions()\n\t\t\t}\n\t\t},\n\t},\n\n\tcreated() {\n\t\tthis.loadInitialOptions()\n\t},\n\n\tmethods: {\n\t\t/**\n\t\t * Seed the dropdown with a first page of options so the field can be\n\t\t * browsed without typing. No-op unless `preload` is set.\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync loadInitialOptions() {\n\t\t\tif (!this.preload || !this.objectStore) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tconst collection = await this.objectStore.fetchCollectionForOptions(this.typeSlug, {\n\t\t\t\t\t...this.activeFilters,\n\t\t\t\t\t_limit: 20,\n\t\t\t\t})\n\t\t\t\tconst items = Array.isArray(collection)\n\t\t\t\t\t? collection\n\t\t\t\t\t: (this.objectStore.collections[this.typeSlug] || [])\n\t\t\t\tthis.options = items.map((o) => this.toOption(o))\n\t\t\t} catch {\n\t\t\t\tthis.options = []\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * The translated \"Create 'X'\" label for the synthetic option.\n\t\t *\n\t\t * @param {string} term The typed term.\n\t\t * @return {string}\n\t\t */\n\t\tcreateLabelFor(term) {\n\t\t\treturn t('nextcloud-vue', 'Create \"{term}\"', { term })\n\t\t},\n\n\t\t/**\n\t\t * Run an object search (debounced via NcSelect's own throttling) for the\n\t\t * typed term. Failures degrade to an empty option list.\n\t\t *\n\t\t * @param {string} term The search term from NcSelect.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync onSearch(term) {\n\t\t\tthis.search = term || ''\n\t\t\tif (!this.objectStore || this.search.trim().length < this.minChars) {\n\t\t\t\t// Below the search threshold: fall back to the browsable first\n\t\t\t\t// page when preloading, rather than blanking the list.\n\t\t\t\tthis.options = []\n\t\t\t\tthis.loadInitialOptions()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tconst collection = await this.objectStore.fetchCollectionForOptions(this.typeSlug, {\n\t\t\t\t\t...this.activeFilters,\n\t\t\t\t\t_search: this.search.trim(),\n\t\t\t\t\t_limit: 20,\n\t\t\t\t})\n\t\t\t\tconst items = Array.isArray(collection)\n\t\t\t\t\t? collection\n\t\t\t\t\t: (this.objectStore.collections[this.typeSlug] || [])\n\t\t\t\tthis.options = items.map((o) => this.toOption(o))\n\t\t\t} catch {\n\t\t\t\tthis.options = []\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Handle a selection. A real option emits its id; the synthetic create\n\t\t * option triggers object creation.\n\t\t *\n\t\t * @param {object|null} option The chosen option (or null on clear).\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync onInput(option) {\n\t\t\tif (!option) {\n\t\t\t\tthis.localSelected = null\n\t\t\t\t/**\n\t\t\t\t * @event update:modelValue The selected (or newly-created) object id, or '' when cleared.\n\t\t\t\t * @type {string}\n\t\t\t\t */\n\t\t\t\tthis.$emit('update:modelValue', '')\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (option.__create) {\n\t\t\t\tawait this.createFromTerm(option.label)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.localSelected = option\n\t\t\tthis.$emit('update:modelValue', option.value)\n\t\t},\n\n\t\t/**\n\t\t * Create a new object from the typed term and select it.\n\t\t *\n\t\t * @param {string} term The term to write to `labelField`.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync createFromTerm(term) {\n\t\t\tif (!this.objectStore && !this.createHandler) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst name = (term || '').trim()\n\t\t\tif (!name) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\t// The active scope is part of the new object's identity: a\n\t\t\t\t// contact created while the list is filtered to one client\n\t\t\t\t// belongs to that client. An explicit createDefaults entry\n\t\t\t\t// still wins.\n\t\t\t\tconst payload = { ...this.activeFilters, ...this.createDefaults, [this.labelField]: name }\n\t\t\t\tlet created\n\t\t\t\tif (this.createHandler) {\n\t\t\t\t\t// A falsy resolve means the consumer aborted (cancelled\n\t\t\t\t\t// dialog) — leave the selection untouched.\n\t\t\t\t\tcreated = await this.createHandler(name, payload)\n\t\t\t\t} else {\n\t\t\t\t\tthis.ensureRegistered()\n\t\t\t\t\tcreated = await this.objectStore.saveObject(this.typeSlug, payload)\n\t\t\t\t}\n\t\t\t\tif (!created) {\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tconst option = this.toOption(created)\n\t\t\t\tthis.options = [option, ...this.options.filter((o) => o.value !== option.value)]\n\t\t\t\tthis.localSelected = option\n\t\t\t\tthis.$emit('update:modelValue', option.value)\n\t\t\t\t/**\n\t\t\t\t * @event create A new object was created from the search term.\n\t\t\t\t * @type {object} The created OpenRegister object.\n\t\t\t\t */\n\t\t\t\tthis.$emit('create', created)\n\t\t\t} catch (e) {\n\t\t\t\t// eslint-disable-next-line no-console\n\t\t\t\tconsole.warn('[CnResourceSelect] create failed', e)\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Map an OpenRegister object to an option `{ value, label }`.\n\t\t *\n\t\t * @param {object} obj The object.\n\t\t * @return {{value: string, label: string}}\n\t\t */\n\t\ttoOption(obj) {\n\t\t\tconst id = String(obj.id || (obj['@self'] && obj['@self'].id) || '')\n\t\t\tconst label = obj[this.labelField] || obj.name || obj.title || id\n\t\t\treturn { value: id, label }\n\t\t},\n\n\t\t/**\n\t\t * Register the object type with the store (idempotent) so search/create\n\t\t * route to the right register+schema.\n\t\t */\n\t\tensureRegistered() {\n\t\t\tif (this.objectStore && typeof this.objectStore.registerObjectType === 'function') {\n\t\t\t\ttry {\n\t\t\t\t\tthis.objectStore.registerObjectType(this.typeSlug, this.schema, this.register)\n\t\t\t\t} catch {\n\t\t\t\t\t// Already registered or store not ready — non-fatal.\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * When a `modelValue` is set but no matching option is loaded, fetch the\n\t\t * single object so its label renders (e.g. a pre-filled client id).\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync ensureSelectedLoaded() {\n\t\t\tif (!this.modelValue || this.selectedOption || !this.objectStore) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tif (typeof this.objectStore.fetchObject !== 'function') {\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tconst obj = await this.objectStore.fetchObject(this.typeSlug, String(this.modelValue))\n\t\t\t\tif (obj) {\n\t\t\t\t\tthis.localSelected = this.toOption(obj)\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Leave the id un-labelled rather than crash.\n\t\t\t}\n\t\t},\n\t},\n}\n</script>\n\n<style scoped>\n.cn-resource-select__create {\n\tdisplay: inline-flex;\n\talign-items: center;\n\tgap: 6px;\n\tcolor: var(--color-primary-element);\n\tfont-weight: 600;\n}\n</style>\n"],"names":["_withCtx","_openBlock","_createElementBlock","_createVNode","_toDisplayString"],"mappings":";;;;AAuByB,EAAA,KAAK,EAAC,4BAAK;;;;;;;;;AAbjC,IAAA,OAAO,EAAE,MAAO,CAAA,OAAA;AAChB,IAAA,UAAU,EAAE,MAAQ,CAAA,UAAA;AACpB,IAAA,UAAU,EAAE,QAAM,CAAA,cAAA;AAClB,IAAA,OAAO,EAAE,QAAc,CAAA,cAAA;AACvB,IAAA,OAAO,EAAE,KAAO,CAAA,OAAA;AAChB,IAAA,SAAS,EAAE,MAAA,CAAA,SAAA;AACX,IAAA,QAAQ,EAAE,MAAM,CAAA,QAAA;AAChB,IAAA,WAAW,EAAE,MAAW,CAAA,WAAA;AACxB,IAAA,UAAU,EAAE,KAAK;SACb,EAAE,OAAM;AACX,IAAA,QAAI,EAAG,QAAQ,CAAA,QAAA;yBACC,EAAE,QAAO,CAAA,OAAA;;AACpB,IAAA,MAAA,EACNA,OAAA,CAAA,GADM,KAAA,EAAA,QAAA,EAAA,QAAA,EAAA,KAAA;MACM,QAAQ;AAApB,WAAAC,SAAA,EAAA,EAAAC,kBAAA,SAAA;YACCC,WAAQ,CAAA,eAAA,EAAA,EAAD,IAAC,EAAA,EAAA,EAAA,CAAA;4BAAA,GACR,GAAAC,eAAA,CAAG,QAAI,CAAA,cAAA,CAAA,QAAA,CAAA,CAAA,EAAA,CAAA,YAAA;;;;;;;;;;"}
+{"version":3,"file":"CnResourceSelect.vue3.js","sources":["../../../../src/components/CnResourceSelect/CnResourceSelect.vue?vue&type=template&id=37b7ff6f&lang.js"],"sourcesContent":["<!--\n  - SPDX-FileCopyrightText: 2026 Conduction B.V.\n  - SPDX-License-Identifier: EUPL-1.2\n-->\n<template>\n\t<NcSelect\n\t\t:inputId=\"inputId\"\n\t\t:inputLabel=\"inputLabel\"\n\t\t:modelValue=\"selectedOption\"\n\t\t:options=\"displayOptions\"\n\t\t:loading=\"loading\"\n\t\t:clearable=\"clearable\"\n\t\t:disabled=\"disabled\"\n\t\t:placeholder=\"placeholder\"\n\t\t:filterable=\"false\"\n\t\t:multiple=\"multiple\"\n\t\t:keepOpen=\"multiple\"\n\t\tlabel=\"label\"\n\t\t@search=\"onSearch\"\n\t\t@update:modelValue=\"onInput\">\n\t\t<template #option=\"{ label: optLabel, __create }\">\n\t\t\t<span v-if=\"__create\" class=\"cn-resource-select__create\">\n\t\t\t\t<Plus :size=\"16\" />\n\t\t\t\t{{ createLabelFor(optLabel) }}\n\t\t\t</span>\n\t\t\t<span v-else>{{ optLabel }}</span>\n\t\t</template>\n\t</NcSelect>\n</template>\n\n<script>\nimport { translate as t } from '@nextcloud/l10n'\nimport { NcSelect } from '@nextcloud/vue'\nimport Plus from 'vue-material-design-icons/Plus.vue'\nimport { useObjectStore } from '../../store/index.js'\n\n/**\n * CnResourceSelect — an OpenRegister object picker that can CREATE from the\n * search term.\n *\n * Searches a `register` + `schema` for objects matching the typed text and\n * renders them as options. When the typed term matches no existing object, a\n * synthetic **\"Create '<term>'\"** option appears at the bottom; choosing it\n * persists a new object (via `useObjectStore().saveObject`, writing the term to\n * `labelField`) and selects it — so an agent who can't find a client just types\n * the name and makes one inline, never hitting a dead \"no results\" end.\n *\n * Emits `update:modelValue` (the selected object's id) and `create` (the\n * freshly-created object). The label of each option comes from `labelField`\n * (default `name`), the value from the object's id.\n *\n * Backwards-compatible, self-contained: it owns its own search + create flow,\n * so a consumer only needs to pass `register` + `schema` and bind `modelValue`.\n *\n * Three opt-in props cover the cases a plain object picker cannot:\n *\n *  - `filters` SCOPES the options to a parent selection, which is what makes a\n *    cascading pair work (pick a client, then only that client's contacts are\n *    offered). Changing the scope clears a now-invalid selection.\n *  - `preload` fetches a first page on mount so the field can be BROWSED, not\n *    only searched — the behaviour a user expects from a select.\n *  - `createHandler` replaces the built-in save. Creating from a bare term only\n *    works while the term is enough to satisfy the schema; the moment a\n *    required field must come from somewhere else (a server-minted key, a value\n *    worth collecting in a full dialog) the consumer owns the create and\n *    resolves the finished object back.\n *\n * Example:\n * ```vue\n * <CnResourceSelect\n *   register=\"pipelinq\"\n *   schema=\"client\"\n *   label-field=\"name\"\n *   :model-value=\"clientId\"\n *   :input-label=\"t('pipelinq', 'Client')\"\n *   @update:modelValue=\"clientId = $event\"\n *   @create=\"onClientCreated\" />\n * ```\n */\nexport default {\n\tname: 'CnResourceSelect',\n\n\tcomponents: { NcSelect, Plus },\n\n\tprops: {\n\t\t/** OpenRegister register slug to search/create in. */\n\t\tregister: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** OpenRegister schema slug to search/create in. */\n\t\tschema: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** Currently-selected object id (v-model), or an array of ids when `multiple`. */\n\t\tmodelValue: {\n\t\t\ttype: [String, Number, Array],\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/**\n\t\t * Pick several objects. `modelValue` is then an array of ids, and a\n\t\t * create adds the new object to the selection.\n\t\t */\n\t\tmultiple: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\n\t\t/** Object field used as the option label AND written on create. */\n\t\tlabelField: {\n\t\t\ttype: String,\n\t\t\tdefault: 'name',\n\t\t},\n\n\t\t/** Accessible input label for the underlying NcSelect. */\n\t\tinputLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** DOM id for the input (a11y association). */\n\t\tinputId: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Whether the selection can be cleared. */\n\t\tclearable: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: true,\n\t\t},\n\n\t\t/** Minimum characters before searching / offering create. */\n\t\tminChars: {\n\t\t\ttype: Number,\n\t\t\tdefault: 2,\n\t\t},\n\n\t\t/**\n\t\t * Whether to offer the inline \"Create '<term>'\" option when the search\n\t\t * yields no exact match. Off → behaves like a plain async object select.\n\t\t */\n\t\tallowCreate: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: true,\n\t\t},\n\n\t\t/**\n\t\t * Extra fields merged into the payload when creating a new object (e.g.\n\t\t * a fixed `type` or `status`). The `labelField` is always set to the term.\n\t\t *\n\t\t * @type {object}\n\t\t */\n\t\tcreateDefaults: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/**\n\t\t * Field filters merged into the search query, so the option list can be\n\t\t * SCOPED to a parent selection — the cascading-select case (pick a\n\t\t * client, then only that client's contacts are offered). Changing this\n\t\t * reloads the options and clears a selection that no longer belongs to\n\t\t * the new scope.\n\t\t *\n\t\t * Example: `:filters=\"{ client: form.client }\"`.\n\t\t *\n\t\t * @type {object}\n\t\t */\n\t\tfilters: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/**\n\t\t * Load a first page of options on mount (and whenever `filters`\n\t\t * change) instead of waiting for `minChars` of typing. Lets the field\n\t\t * be BROWSED like a plain select while still searching server-side once\n\t\t * the user types. Off by default so existing consumers keep their\n\t\t * search-only behaviour and issue no extra request.\n\t\t */\n\t\tpreload: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\n\t\t/**\n\t\t * Disable the input — e.g. a dependent select waiting on its parent.\n\t\t */\n\t\tdisabled: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\n\t\t/** Placeholder text for the underlying NcSelect. */\n\t\tplaceholder: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/**\n\t\t * Override how a new object is created from the typed term. Receives\n\t\t * `(term, payload)` and MUST resolve to the created object (or a falsy\n\t\t * value to abort, e.g. the user cancelled a dialog).\n\t\t *\n\t\t * Without it the component posts `payload` straight to\n\t\t * `objectStore.saveObject`, which is wrong whenever the schema requires\n\t\t * a field the term cannot supply — a server-minted foreign key, say, or\n\t\t * anything the consumer would rather collect in a full create dialog.\n\t\t *\n\t\t * @type {((term: string, payload: object) => Promise<object|null>)|null}\n\t\t */\n\t\tcreateHandler: {\n\t\t\ttype: Function,\n\t\t\tdefault: null,\n\t\t},\n\t},\n\n\temits: ['update:modelValue', 'create'],\n\n\tdata() {\n\t\treturn {\n\t\t\tsearch: '',\n\t\t\tloading: false,\n\t\t\toptions: [],\n\t\t\t// The selected option object kept locally so the label shows even\n\t\t\t// before/without a matching search result (e.g. a pre-set modelValue).\n\t\t\tlocalSelected: null,\n\t\t\t// Options seen so far, keyed by value, so a multiple selection\n\t\t\t// keeps its labels when the search results move on.\n\t\t\tknown: {},\n\t\t}\n\t},\n\n\tcomputed: {\n\t\t/** Pinia object store handle (resolved lazily so a Pinia-less test still mounts). */\n\t\tobjectStore() {\n\t\t\ttry {\n\t\t\t\treturn useObjectStore()\n\t\t\t} catch {\n\t\t\t\treturn null\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * The selected ids as strings (multiple mode).\n\t\t *\n\t\t * @return {string[]}\n\t\t */\n\t\tselectedIds() {\n\t\t\tconst value = this.modelValue\n\t\t\tif (Array.isArray(value)) {\n\t\t\t\treturn value.filter((v) => v !== null && v !== undefined && v !== '').map((v) => String(v))\n\t\t\t}\n\t\t\treturn value ? [String(value)] : []\n\t\t},\n\n\t\t/** The `${register}-${schema}` object-type slug used by the store. */\n\t\ttypeSlug() {\n\t\t\treturn `${this.register}-${this.schema}`\n\t\t},\n\n\t\t/** The currently-selected option, for NcSelect's model-value. */\n\t\tselectedOption() {\n\t\t\tif (this.multiple) {\n\t\t\t\treturn this.selectedIds.map((id) => this.known[id]\n\t\t\t\t\t|| this.options.find((o) => o.value === id)\n\t\t\t\t\t|| { value: id, label: id })\n\t\t\t}\n\t\t\tif (this.localSelected && this.localSelected.value === this.modelValue) {\n\t\t\t\treturn this.localSelected\n\t\t\t}\n\t\t\treturn this.options.find((o) => o.value === this.modelValue) || null\n\t\t},\n\n\t\t/**\n\t\t * The option list shown in the dropdown — the search results, plus a\n\t\t * synthetic \"Create '<term>'\" entry when create is allowed and the term\n\t\t * is long enough and matches no existing option label exactly.\n\t\t *\n\t\t * @return {Array<object>}\n\t\t */\n\t\tdisplayOptions() {\n\t\t\tconst opts = [...this.options]\n\t\t\tconst term = this.search.trim()\n\t\t\tif (this.allowCreate && term.length >= this.minChars) {\n\t\t\t\tconst exact = opts.some((o) => (o.label || '').toLowerCase() === term.toLowerCase())\n\t\t\t\tif (!exact) {\n\t\t\t\t\topts.push({ value: '__create__', label: term, __create: true })\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn opts\n\t\t},\n\n\t\t/**\n\t\t * Stable string identity for `filters`. Watching the object itself\n\t\t * would re-fire on every parent re-render (a fresh object literal is a\n\t\t * new identity even when the values are unchanged), reloading options\n\t\t * and clobbering the selection in a loop.\n\t\t *\n\t\t * @return {string}\n\t\t */\n\t\tfiltersKey() {\n\t\t\treturn JSON.stringify(this.filters || {})\n\t\t},\n\n\t\t/**\n\t\t * `filters` with empty entries dropped. A parent that has not been\n\t\t * chosen yet holds `null`, and forwarding `client=` as a query param\n\t\t * asks the API for objects whose client is the empty string — which\n\t\t * matches nothing and reads as \"no results\" rather than \"not scoped\".\n\t\t *\n\t\t * @return {object}\n\t\t */\n\t\tactiveFilters() {\n\t\t\tconst out = {}\n\t\t\tfor (const [key, value] of Object.entries(this.filters || {})) {\n\t\t\t\tif (value !== null && value !== undefined && value !== '') {\n\t\t\t\t\tout[key] = value\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn out\n\t\t},\n\t},\n\n\twatch: {\n\t\tmodelValue: {\n\t\t\timmediate: true,\n\t\t\thandler() {\n\t\t\t\tthis.ensureSelectedLoaded()\n\t\t\t},\n\t\t},\n\n\t\tfiltersKey(next, prev) {\n\t\t\tif (next === prev) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\t// The scope moved, so anything already selected may no longer be\n\t\t\t// in it. Drop the stale options + selection, then re-seed.\n\t\t\tthis.options = []\n\t\t\tif (this.selectedIds.length > 0) {\n\t\t\t\tthis.localSelected = null\n\t\t\t\tthis.$emit('update:modelValue', this.multiple ? [] : '')\n\t\t\t}\n\t\t\tif (this.search.trim().length >= this.minChars) {\n\t\t\t\tthis.onSearch(this.search)\n\t\t\t} else {\n\t\t\t\tthis.loadInitialOptions()\n\t\t\t}\n\t\t},\n\t},\n\n\tcreated() {\n\t\tthis.loadInitialOptions()\n\t},\n\n\tmethods: {\n\t\t/**\n\t\t * Seed the dropdown with a first page of options so the field can be\n\t\t * browsed without typing. No-op unless `preload` is set.\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync loadInitialOptions() {\n\t\t\tif (!this.preload || !this.objectStore) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tconst collection = await this.objectStore.fetchCollectionForOptions(this.typeSlug, {\n\t\t\t\t\t...this.activeFilters,\n\t\t\t\t\t_limit: 20,\n\t\t\t\t})\n\t\t\t\tconst items = Array.isArray(collection)\n\t\t\t\t\t? collection\n\t\t\t\t\t: (this.objectStore.collections[this.typeSlug] || [])\n\t\t\t\tthis.options = this.remember(items.map((o) => this.toOption(o)))\n\t\t\t} catch {\n\t\t\t\tthis.options = []\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * The translated \"Create 'X'\" label for the synthetic option.\n\t\t *\n\t\t * @param {string} term The typed term.\n\t\t * @return {string}\n\t\t */\n\t\tcreateLabelFor(term) {\n\t\t\treturn t('nextcloud-vue', 'Create \"{term}\"', { term })\n\t\t},\n\n\t\t/**\n\t\t * Run an object search (debounced via NcSelect's own throttling) for the\n\t\t * typed term. Failures degrade to an empty option list.\n\t\t *\n\t\t * @param {string} term The search term from NcSelect.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync onSearch(term) {\n\t\t\tthis.search = term || ''\n\t\t\tif (!this.objectStore || this.search.trim().length < this.minChars) {\n\t\t\t\t// Below the search threshold: fall back to the browsable first\n\t\t\t\t// page when preloading, rather than blanking the list.\n\t\t\t\tthis.options = []\n\t\t\t\tthis.loadInitialOptions()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tconst collection = await this.objectStore.fetchCollectionForOptions(this.typeSlug, {\n\t\t\t\t\t...this.activeFilters,\n\t\t\t\t\t_search: this.search.trim(),\n\t\t\t\t\t_limit: 20,\n\t\t\t\t})\n\t\t\t\tconst items = Array.isArray(collection)\n\t\t\t\t\t? collection\n\t\t\t\t\t: (this.objectStore.collections[this.typeSlug] || [])\n\t\t\t\tthis.options = this.remember(items.map((o) => this.toOption(o)))\n\t\t\t} catch {\n\t\t\t\tthis.options = []\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Handle a selection. A real option emits its id; the synthetic create\n\t\t * option triggers object creation.\n\t\t *\n\t\t * @param {object|null} option The chosen option (or null on clear).\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync onInput(option) {\n\t\t\tif (this.multiple) {\n\t\t\t\tawait this.onMultipleInput(Array.isArray(option) ? option : (option ? [option] : []))\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!option) {\n\t\t\t\tthis.localSelected = null\n\t\t\t\t/**\n\t\t\t\t * @event update:modelValue The selected (or newly-created) object id, or '' when cleared.\n\t\t\t\t * @type {string}\n\t\t\t\t */\n\t\t\t\tthis.$emit('update:modelValue', '')\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (option.__create) {\n\t\t\t\tawait this.createFromTerm(option.label)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.localSelected = option\n\t\t\tthis.$emit('update:modelValue', option.value)\n\t\t},\n\n\t\t/**\n\t\t * Handle a change of a multiple selection. A synthetic create option\n\t\t * creates the object and adds it; the rest emit their ids.\n\t\t *\n\t\t * @param {Array<object>} chosen The selected options.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync onMultipleInput(chosen) {\n\t\t\tconst createOption = chosen.find((o) => o && o.__create)\n\t\t\tconst ids = chosen.filter((o) => o && !o.__create).map((o) => String(o.value))\n\t\t\tthis.remember(chosen.filter((o) => o && !o.__create))\n\t\t\tif (!createOption) {\n\t\t\t\tthis.$emit('update:modelValue', ids)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst created = await this.createFromTerm(createOption.label, ids)\n\t\t\tif (!created) {\n\t\t\t\tthis.$emit('update:modelValue', ids)\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Cache options by value so their labels survive a new search.\n\t\t *\n\t\t * @param {Array<object>} options Options to remember.\n\t\t * @return {Array<object>} The same options.\n\t\t */\n\t\tremember(options) {\n\t\t\tconst next = { ...this.known }\n\t\t\tfor (const o of options) {\n\t\t\t\tif (o && o.value) {\n\t\t\t\t\tnext[o.value] = o\n\t\t\t\t}\n\t\t\t}\n\t\t\tthis.known = next\n\t\t\treturn options\n\t\t},\n\n\t\t/**\n\t\t * Create a new object from the typed term and select it.\n\t\t *\n\t\t * @param {string} term The term to write to `labelField`.\n\t\t * @param {string[]} [keep] Multiple mode: the ids already selected, which the new id joins.\n\t\t * @return {Promise<object|null>} The created object, or null.\n\t\t */\n\t\tasync createFromTerm(term, keep = []) {\n\t\t\tif (!this.objectStore && !this.createHandler) {\n\t\t\t\treturn null\n\t\t\t}\n\t\t\tconst name = (term || '').trim()\n\t\t\tif (!name) {\n\t\t\t\treturn null\n\t\t\t}\n\t\t\tthis.loading = true\n\t\t\ttry {\n\t\t\t\t// The active scope is part of the new object's identity: a\n\t\t\t\t// contact created while the list is filtered to one client\n\t\t\t\t// belongs to that client. An explicit createDefaults entry\n\t\t\t\t// still wins.\n\t\t\t\tconst payload = { ...this.activeFilters, ...this.createDefaults, [this.labelField]: name }\n\t\t\t\tlet created\n\t\t\t\tif (this.createHandler) {\n\t\t\t\t\t// A falsy resolve means the consumer aborted (cancelled\n\t\t\t\t\t// dialog) — leave the selection untouched.\n\t\t\t\t\tcreated = await this.createHandler(name, payload)\n\t\t\t\t} else {\n\t\t\t\t\tthis.ensureRegistered()\n\t\t\t\t\tcreated = await this.objectStore.saveObject(this.typeSlug, payload)\n\t\t\t\t}\n\t\t\t\tif (!created) {\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t\tconst option = this.toOption(created)\n\t\t\t\tthis.remember([option])\n\t\t\t\tthis.options = [option, ...this.options.filter((o) => o.value !== option.value)]\n\t\t\t\tthis.localSelected = option\n\t\t\t\tthis.search = ''\n\t\t\t\tthis.$emit('update:modelValue', this.multiple\n\t\t\t\t\t? [...keep.filter((id) => id !== option.value), option.value]\n\t\t\t\t\t: option.value)\n\t\t\t\t/**\n\t\t\t\t * @event create A new object was created from the search term.\n\t\t\t\t * @type {object} The created OpenRegister object.\n\t\t\t\t */\n\t\t\t\tthis.$emit('create', created)\n\t\t\t\treturn created\n\t\t\t} catch (e) {\n\t\t\t\t// eslint-disable-next-line no-console\n\t\t\t\tconsole.warn('[CnResourceSelect] create failed', e)\n\t\t\t\treturn null\n\t\t\t} finally {\n\t\t\t\tthis.loading = false\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Map an OpenRegister object to an option `{ value, label }`.\n\t\t *\n\t\t * @param {object} obj The object.\n\t\t * @return {{value: string, label: string}}\n\t\t */\n\t\ttoOption(obj) {\n\t\t\tconst id = String(obj.id || (obj['@self'] && obj['@self'].id) || '')\n\t\t\tconst label = obj[this.labelField] || obj.name || obj.title || id\n\t\t\treturn { value: id, label }\n\t\t},\n\n\t\t/**\n\t\t * Register the object type with the store (idempotent) so search/create\n\t\t * route to the right register+schema.\n\t\t */\n\t\tensureRegistered() {\n\t\t\tif (this.objectStore && typeof this.objectStore.registerObjectType === 'function') {\n\t\t\t\ttry {\n\t\t\t\t\tthis.objectStore.registerObjectType(this.typeSlug, this.schema, this.register)\n\t\t\t\t} catch {\n\t\t\t\t\t// Already registered or store not ready — non-fatal.\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * When a `modelValue` is set but no matching option is loaded, fetch the\n\t\t * single object so its label renders (e.g. a pre-filled client id).\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync ensureSelectedLoaded() {\n\t\t\tif (this.multiple) {\n\t\t\t\tawait this.ensureManyLoaded()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!this.modelValue || this.selectedOption || !this.objectStore) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tthis.ensureRegistered()\n\t\t\t\tif (typeof this.objectStore.fetchObject !== 'function') {\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tconst obj = await this.objectStore.fetchObject(this.typeSlug, String(this.modelValue))\n\t\t\t\tif (obj) {\n\t\t\t\t\tthis.localSelected = this.toOption(obj)\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Leave the id un-labelled rather than crash.\n\t\t\t}\n\t\t},\n\n\t\t/**\n\t\t * Multiple mode: fetch each selected id whose label is not known yet.\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tasync ensureManyLoaded() {\n\t\t\tif (!this.objectStore || typeof this.objectStore.fetchObject !== 'function') {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst missing = this.selectedIds.filter((id) => !this.known[id] && !this.options.some((o) => o.value === id))\n\t\t\tif (missing.length === 0) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.ensureRegistered()\n\t\t\tfor (const id of missing) {\n\t\t\t\ttry {\n\t\t\t\t\tconst obj = await this.objectStore.fetchObject(this.typeSlug, id)\n\t\t\t\t\tif (obj) {\n\t\t\t\t\t\tthis.remember([this.toOption(obj)])\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Leave the id un-labelled rather than crash.\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t},\n}\n</script>\n\n<style scoped>\n.cn-resource-select__create {\n\tdisplay: inline-flex;\n\talign-items: center;\n\tgap: 6px;\n\tcolor: var(--color-primary-element);\n\tfont-weight: 600;\n}\n</style>\n"],"names":["_withCtx","_openBlock","_createElementBlock","_createVNode","_toDisplayString"],"mappings":";;;;AAyByB,EAAA,KAAK,EAAC,4BAAK;;;;;;;;;AAfjC,IAAA,OAAO,EAAE,MAAO,CAAA,OAAA;AAChB,IAAA,UAAU,EAAE,MAAQ,CAAA,UAAA;AACpB,IAAA,UAAU,EAAE,QAAM,CAAA,cAAA;AAClB,IAAA,OAAO,EAAE,QAAc,CAAA,cAAA;AACvB,IAAA,OAAO,EAAE,KAAO,CAAA,OAAA;AAChB,IAAA,SAAS,EAAE,MAAO,CAAA,SAAA;AAClB,IAAA,QAAQ,EAAE,MAAQ,CAAA,QAAA;AAClB,IAAA,WAAW,EAAA,MAAA,CAAA,WAAA;AACX,IAAA,UAAU,EAAE,KAAI;AAChB,IAAA,QAAQ,EAAE,MAAQ,CAAA,QAAA;AAClB,IAAA,QAAS,EAAC,MAAQ,CAAA,QAAA;SACd,EAAE,OAAM;AACX,IAAA,QAAI,EAAG,QAAQ,CAAA,QAAA;yBACC,EAAE,QAAO,CAAA,OAAA;;AACpB,IAAA,MAAA,EACNA,OAAA,CAAA,GADM,KAAA,EAAA,QAAA,EAAA,QAAA,EAAA,KAAA;MACM,QAAQ;AAApB,WAAAC,SAAA,EAAA,EAAAC,kBAAA,SAAA;YACCC,WAAQ,CAAA,eAAA,EAAA,EAAD,IAAC,EAAA,EAAA,EAAA,CAAA;4BAAA,GACR,GAAAC,eAAA,CAAG,QAAI,CAAA,cAAA,CAAA,QAAA,CAAA,CAAA,EAAA,CAAA,YAAA;;;;;;;;;;"}

package/dist/esm/components/CnSetupWizard/CnSetupWizard.vue2.js

@@ -1,10 +1,20 @@
+import { getCurrentUser } from '@nextcloud/auth';
+import { loadState } from '@nextcloud/initial-state';
 import { translate } from '@nextcloud/l10n';
 import { NcButton, NcNoteCard, NcSelect, NcTextField, NcCheckboxRadioSwitch, NcLoadingIcon } from '@nextcloud/vue';
 import __sfc_main$1 from '../CnChoiceCards/CnChoiceCards.vue.js';
+import __sfc_main$2 from '../CnLeafDependencySettings/CnLeafDependencySettings.vue.js';
 import __sfc_main from '../CnWizardDialog/CnWizardDialog.vue.js';
+import { checkDependencies, isDependencyResolved } from '../../composables/useDependencyCheck.js';
 import { useSetupStatus } from '../../composables/useSetupStatus.js';
 import { fieldsFromSchema } from '../../utils/schema.js';
 
+/** Id of the synthetic step shown while a required app is missing. */
+const DEPENDENCY_STEP_ID = 'cn-setup-dependencies';
+
+/** The dataset value that means "seed nothing"; it never gets a Load button. */
+const NONE_DATASET = 'none';
+
 /**
  * CnSetupWizard — abstract, manifest-driven first-time setup wizard (ADR-042).
  *
@@ -34,6 +44,7 @@ var script = {
 	components: {
 		CnWizardDialog: __sfc_main,
 		CnChoiceCards: __sfc_main$1,
+		CnLeafDependencySettings: __sfc_main$2,
 		NcButton,
 		NcNoteCard,
 		NcSelect,
@@ -52,6 +63,11 @@ var script = {
 		 * standalone (no CnAppRoot ancestor).
 		 */
 		cnTranslate: { default: () => (key) => key },
+		/**
+		 * The app manifest, provided by CnAppRoot. Read only for its
+		 * `dependencies` when the `dependencies` prop is empty.
+		 */
+		cnManifest: { default: null },
 	},
 
 	props: {
@@ -161,6 +177,33 @@ var script = {
 			type: Array,
 			default: () => [],
 		},
+
+		/**
+		 * The app's dependencies, in the manifest's own shape (app-id strings
+		 * or `{ id, name?, required? }`). Falls back to the injected manifest's
+		 * `dependencies`. A missing REQUIRED one replaces every step with the
+		 * dependency list and disables Next; a missing optional one is listed
+		 * on the first step and does not block.
+		 *
+		 * @type {Array<string|object>}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-the-wizard-checks-dependencies-before-any-step
+		 */
+		dependencies: {
+			type: Array,
+			default: () => [],
+		},
+
+		/** Load button label on a dataset card (`loadAction`). */
+		loadLabel: {
+			type: String,
+			default: () => translate('nextcloud-vue', 'Load'),
+		},
+
+		/** Load button label once that dataset loaded in this session. */
+		reloadLabel: {
+			type: String,
+			default: () => translate('nextcloud-vue', 'Load again'),
+		},
 	},
 
 	emits: ['complete', 'close', 'step-change', 'action-result'],
@@ -196,6 +239,9 @@ var script = {
 			actionResult: {},
 			localDone: {},
 			userTouched: {},
+			// Per-card load state for `loadAction` steps, keyed by `loadKey()`.
+			datasetRunning: {},
+			datasetResult: {},
 		}
 	},
 
@@ -213,11 +259,150 @@ var script = {
 				: this.dialogTitle
 		},
 
-		setupSteps() {
+		/**
+		 * Every well-formed step, before `requires` is applied.
+		 *
+		 * @return {Array<object>}
+		 */
+		declaredSteps() {
 			return (this.steps || []).filter((s) => s && s.id && s.type)
 		},
 
+		/**
+		 * Steps that declare `requires` on an app that is not installed and
+		 * enabled. They are not offered; the summary names them as skipped.
+		 *
+		 * @return {Array<{ step: object, missing: Array<string> }>}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-the-wizard-checks-dependencies-before-any-step
+		 */
+		skippedSteps() {
+			return this.declaredSteps
+				.filter((s) => Array.isArray(s.requires) && s.requires.length > 0)
+				.map((step) => {
+					const known = Object.fromEntries(this.dependencyRows.map((d) => [d.id, d]));
+					const missing = checkDependencies(step.requires, this.serverAppStatuses)
+						.map((row) => known[row.id] || row)
+						.filter((row) => !isDependencyResolved(row))
+						.map((row) => row.name || row.id);
+					return { step, missing }
+				})
+				.filter((entry) => entry.missing.length > 0)
+		},
+
+		setupSteps() {
+			const skipped = new Set(this.skippedSteps.map((entry) => entry.step.id));
+			return this.declaredSteps.filter((s) => !skipped.has(s.id))
+		},
+
+		/**
+		 * Id of the first offered step: where the optional-apps note shows.
+		 *
+		 * @return {string}
+		 */
+		firstStepId() {
+			return this.setupSteps.length > 0 ? this.setupSteps[0].id : ''
+		},
+
+		/**
+		 * The dependency declarations to check: the prop, else the manifest's.
+		 *
+		 * @return {Array<string|object>}
+		 */
+		dependencyEntries() {
+			if (Array.isArray(this.dependencies) && this.dependencies.length > 0) {
+				return this.dependencies
+			}
+			const fromManifest = this.cnManifest && this.cnManifest.dependencies;
+			return Array.isArray(fromManifest) ? fromManifest : []
+		},
+
+		/**
+		 * The `dependency_statuses` initial state an app may inject from PHP.
+		 * Same source CnAppRoot reads; `{}` when the app injects none.
+		 *
+		 * @return {object}
+		 */
+		serverAppStatuses() {
+			try {
+				return loadState(this.appId, 'dependency_statuses', {}) || {}
+			} catch {
+				return {}
+			}
+		},
+
+		/**
+		 * The declared dependencies with their live status.
+		 *
+		 * @return {Array<object>}
+		 */
+		dependencyRows() {
+			return checkDependencies(this.dependencyEntries, this.serverAppStatuses)
+		},
+
+		/** @return {Array<object>} Required dependencies that are missing or disabled. */
+		missingRequired() {
+			return this.dependencyRows.filter((d) => d.required && !isDependencyResolved(d))
+		},
+
+		/** @return {Array<object>} Optional dependencies that are missing or disabled. */
+		missingOptional() {
+			return this.dependencyRows.filter((d) => !d.required && !isDependencyResolved(d))
+		},
+
+		/**
+		 * Whether a required app is missing, so the wizard shows the
+		 * dependency list instead of its steps and refuses to continue.
+		 *
+		 * @return {boolean}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-the-wizard-checks-dependencies-before-any-step
+		 */
+		dependencyBlocked() {
+			return this.missingRequired.length > 0
+		},
+
+		dependencyStepSlot() {
+			return 'step-' + DEPENDENCY_STEP_ID
+		},
+
+		dependencySectionName() {
+			return translate('nextcloud-vue', 'Apps this app needs')
+		},
+
+		dependencyBlockedText() {
+			return translate('nextcloud-vue', 'Setup can start once these apps are installed and enabled: {apps}.', {
+				apps: this.missingRequired.map((d) => d.name).join(', '),
+			})
+		},
+
+		optionalMissingText() {
+			return translate('nextcloud-vue', 'Optional, not installed: {apps}. You can add them later.', {
+				apps: this.missingOptional.map((d) => d.name).join(', '),
+			})
+		},
+
+		/**
+		 * Whether the current user is a Nextcloud admin; only admins get the
+		 * install and enable buttons.
+		 *
+		 * @return {boolean}
+		 */
+		isAdmin() {
+			try {
+				const user = getCurrentUser();
+				return !!(user && user.isAdmin)
+			} catch {
+				return false
+			}
+		},
+
 		wizardSteps() {
+			if (this.dependencyBlocked) {
+				return [{
+					id: DEPENDENCY_STEP_ID,
+					label: translate('nextcloud-vue', 'Required apps'),
+					optional: false,
+				}]
+			}
 			return this.setupSteps.map((s) => ({
 				id: s.id,
 				label: this.stepTitle(s),
@@ -241,6 +426,15 @@ var script = {
 		 * @return {Array<{ id: string, title: string, value: string, done: boolean, notRun: boolean }>}
 		 */
 		summaryItems() {
+			const skipped = this.skippedSteps
+				.filter((entry) => entry.step.type !== 'summary' && entry.step.type !== 'info')
+				.map((entry) => ({
+					id: entry.step.id,
+					title: this.stepTitle(entry.step),
+					value: translate('nextcloud-vue', 'Skipped, needs {apps}', { apps: entry.missing.join(', ') }),
+					done: false,
+					notRun: true,
+				}));
 			return this.setupSteps
 				.filter((s) => s.type !== 'summary')
 				.map((step) => {
@@ -277,6 +471,7 @@ var script = {
 					}
 					return { id: step.id, title: this.stepTitle(step), value, done, notRun: false }
 				})
+				.concat(skipped)
 		},
 
 		/**
@@ -337,6 +532,11 @@ var script = {
 		 * @return {void}
 		 */
 		maybeAutoRunStep(stepId) {
+			// Nothing runs while a required app is missing: every action
+			// would fail with an error that does not name the app.
+			if (this.dependencyBlocked) {
+				return
+			}
 			const step = this.setupSteps.find((s) => s.id === stepId);
 			if (step && step.type === 'run-action' && !this.isOnDemand(step) && !this.isStepDone(step.id) && !this.running[step.id]) {
 				this.runAction(step);
@@ -719,6 +919,131 @@ var script = {
 			}
 		},
 
+		/**
+		 * Key for one card's load state.
+		 *
+		 * @param {object} step The choice step.
+		 * @param {object} option The card's option.
+		 * @return {string}
+		 */
+		loadKey(step, option) {
+			return step.id + '::' + String(option && option.value)
+		},
+
+		/**
+		 * Whether a card gets a Load button: the step declares `loadAction`
+		 * and the option is not the "seed nothing" answer.
+		 *
+		 * @param {object} step The choice step.
+		 * @param {object} option The card's option.
+		 * @return {boolean}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-a-dataset-card-loads-itself
+		 */
+		isLoadableOption(step, option) {
+			return !!(step && step.loadAction) && !!option && String(option.value) !== NONE_DATASET
+		},
+
+		isDatasetLoading(step, option) {
+			return this.datasetRunning[this.loadKey(step, option)] === true
+		},
+
+		datasetResultFor(step, option) {
+			return this.datasetResult[this.loadKey(step, option)] || null
+		},
+
+		loadButtonLabel(step, option) {
+			if (this.isDatasetLoading(step, option)) {
+				return this.runningLabel
+			}
+			const result = this.datasetResultFor(step, option);
+			return (result && result.success) ? this.reloadLabel : this.loadLabel
+		},
+
+		loadAriaLabel(option) {
+			return translate('nextcloud-vue', 'Load {name}', { name: option.label })
+		},
+
+		/**
+		 * Load one dataset from its card: POST `{ dataset }` to the step's
+		 * `loadAction`, spinner on the button while it runs, the result on the
+		 * card after. A successful load also selects the card, so the summary
+		 * and the stored choice name what was loaded.
+		 *
+		 * @param {object} step The choice step declaring `loadAction`.
+		 * @param {object} option The card's option.
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-a-dataset-card-loads-itself
+		 */
+		async loadDataset(step, option) {
+			if (!this.isLoadableOption(step, option) || this.isDatasetLoading(step, option)) {
+				return
+			}
+			const key = this.loadKey(step, option);
+			this.datasetRunning[key] = true;
+			this.datasetResult[key] = null;
+			let result;
+			try {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([
+					import('@nextcloud/axios'),
+					import('@nextcloud/router'),
+				]);
+				const { data } = await axios.post(
+					generateUrl(`/apps/${this.appId}/api/setup/action/${step.loadAction}`),
+					{ dataset: option.value },
+				);
+				result = {
+					success: !!data && data.success !== false,
+					message: (data && data.message) || translate('nextcloud-vue', 'Loaded.'),
+				};
+			} catch (err) {
+				result = { success: false, message: this.errorMessage(err) };
+			} finally {
+				this.datasetRunning[key] = false;
+			}
+			this.datasetResult[key] = result;
+			if (result.success) {
+				this.selectLoadedOption(step, option);
+				this.localDone[step.id] = true;
+			}
+			this.$emit('action-result', {
+				stepId: step.id,
+				action: step.loadAction,
+				dataset: option.value,
+				...result,
+			});
+		},
+
+		/**
+		 * Select a card that just loaded, adding to (never replacing) the
+		 * selection of a `multiple` step.
+		 *
+		 * @param {object} step The choice step.
+		 * @param {object} option The loaded option.
+		 * @return {void}
+		 */
+		selectLoadedOption(step, option) {
+			if (step.multiple === true) {
+				const current = this.cardModel(step);
+				if (current.some((v) => String(v) === String(option.value))) {
+					return
+				}
+				this.onChoice(step, current.concat([option.value]));
+				return
+			}
+			this.onChoice(step, option.value);
+		},
+
+		/**
+		 * A required app was installed from the dependency list. A new app's
+		 * scripts and its `OC.appswebroots` entry exist only after a full page
+		 * load, and `useAppStatus` caches per page, so reload.
+		 *
+		 * @return {void}
+		 */
+		onDependencyInstalled() {
+			window.location.reload();
+		},
+
 		/**
 		 * Whether a step is marked on-demand (`onDemand: true`): it runs only
 		 * when the user asks, never automatically, and the summary ticks it