@conduction/nextcloud-vue 2.108.0 → 2.110.0

package/dist/esm/utils/libraryWidgetKeys.js

@@ -60,6 +60,7 @@ const BUILT_IN_WIDGET_KEYS = Object.freeze([
 	'form-renderer',
 	'map-viewer',
 	'notice',
+	'decision-list',
 	'object-geo',
 	'card-grid',
 	'nav-card-grid',
@@ -135,10 +136,12 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'object-table',
 	'party-actions',
 	'people',
+	'plan',
 	'quicklinks',
 	'radio-cards',
 	'record-list',
 	'related',
+	'retention',
 	'saved-view',
 	'saved-views',
 	'sections',
@@ -160,6 +163,7 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'video',
 	'week-strip',
 	'working-calendar',
+	'work-queue',
 	'workspace-filter',
 ]);
 

package/dist/esm/utils/libraryWidgetKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"libraryWidgetKeys.js","sources":["../../../src/utils/libraryWidgetKeys.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * libraryWidgetKeys — the one vocabulary of widget keys the LIBRARY itself\n * renders, and the only list `validateManifestV2` is allowed to consult.\n *\n * WHY THIS MODULE EXISTS\n * ----------------------\n * The validator used to carry its own hand-written array of \"library built-in\n * widget keys\", with a comment instructing whoever added a built-in to append\n * it \"in the same PR\". That instruction was followed for five keys and missed\n * for six, so the validator knew 11 keys while the library actually rendered\n * 45. Nothing failed when the two disagreed, because the only consumer is an\n * exemption: a key the validator does not recognise is treated as a CUSTOM\n * registry component, which makes a legitimate single-widget library dashboard\n * fail the ADR-036 Decision 1 anti-pattern rule with advice (\"declare it as\n * type:'custom'\") that is wrong for a library widget.\n *\n * A comment cannot enforce anything, so the array moved here and\n * `tests/utils/libraryWidgetKeys.spec.js` now binds it to the two registries\n * that actually resolve a key at runtime:\n *\n *   1. `BUILT_IN_WIDGETS` (components/CnWidgetGrid/builtInWidgets.js) — the v2\n *      manifest widget set `CnWidgetGrid` resolves a `widgetKey` against.\n *   2. The dashboard widget catalog (`dashboardWidgetRegistry`), populated by\n *      `registerDashboardWidgets.js`. `CnWidgetGrid` falls back to it (third in\n *      the chain, after the consumer registry and `BUILT_IN_WIDGETS`), so a\n *      catalog key renders on a v2 page exactly like a `BUILT_IN_WIDGETS` one.\n *\n * The test asserts SET EQUALITY in both directions against the live registries,\n * so adding a widget to either registry without touching this file fails CI,\n * and deleting one without removing it here fails too. The lists below are the\n * validator's view; the registries are the truth the test holds them to.\n *\n * THE CATALOG IS NOT LEGACY. It is a live half of the same vocabulary, and the\n * old array already conceded the point by exempting `chart` and `stats-block`,\n * which are catalog-only keys that `BUILT_IN_WIDGETS` has never held. What it\n * got wrong was doing that for two keys and not the other thirty-seven.\n * `widgetDispatch.js` unified the two resolution paths for the same reason: a\n * widget authored against one vocabulary was invisible to the other and said\n * nothing about why (101 of 236 detail widgets on hrmq).\n *\n * @module utils/libraryWidgetKeys\n */\n\nimport { WIDGET_TYPE_ALIASES } from './widgetTypeAliases.js'\n\n/**\n * Keys of `BUILT_IN_WIDGETS` — the v2 manifest widget set.\n *\n * Kept in the registry's own declaration order so a diff against\n * `builtInWidgets.js` reads straight down.\n *\n * @type {string[]} Frozen.\n */\nexport const BUILT_IN_WIDGET_KEYS = Object.freeze([\n\t'object-table',\n\t'form-renderer',\n\t'map-viewer',\n\t'notice',\n\t'object-geo',\n\t'card-grid',\n\t'nav-card-grid',\n\t'data',\n\t'metadata',\n\t'related',\n\t'integration',\n\t'banner',\n\t'audit-trail',\n\t'timeline',\n\t'header',\n\t'text',\n\t'divider',\n\t'saved-view-alert',\n\t'exports',\n])\n\n/**\n * Widget types the LIBRARY registers into the dashboard catalog at import time\n * (`registerDashboardWidgets.js` and the widget `index.js` modules it pulls in).\n *\n * Deliberately a static list rather than a read of `dashboardWidgetRegistry`:\n * that object is mutable and consumer-extensible, so deriving the exemption\n * from it at call time would let an app register its own full-page component in\n * the catalog and walk straight through the ADR-036 Decision 1 rule the\n * exemption exists to enforce. Only keys the library itself ships are exempt.\n *\n * Sorted, because unlike `BUILT_IN_WIDGETS` these registrations are spread over\n * ~30 files and have no meaningful declaration order.\n *\n * @type {string[]} Frozen.\n */\nexport const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'checklist-run',\n\t'chips-field',\n\t'choice-picker',\n\t'container',\n\t'conversation',\n\t'countdown',\n\t'data',\n\t'delta',\n\t'device-frames',\n\t'divider',\n\t'document-review',\n\t'facts',\n\t'field-list',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'grouped-cards',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'links',\n\t'mail',\n\t'map',\n\t'markdown',\n\t'menu',\n\t'nc-widget',\n\t'next-step',\n\t'notepad',\n\t// `news` was here until the widget moved to LaunchPad, which owns the feed\n\t// fetching. An app that renders one now gets it from LaunchPad's registry.\n\t'object-geo',\n\t'object-list',\n\t'object-table',\n\t'party-actions',\n\t'people',\n\t'quicklinks',\n\t'radio-cards',\n\t'record-list',\n\t'related',\n\t'saved-view',\n\t'saved-views',\n\t'sections',\n\t'settings-form',\n\t'spend-analytics',\n\t'stacked-bar',\n\t'stages',\n\t'stat',\n\t'stats-block',\n\t'switch-rows',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'team-workload',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'toggle-table',\n\t'video',\n\t'week-strip',\n\t'working-calendar',\n\t'workspace-filter',\n])\n\n/**\n * Expand a key set over `WIDGET_TYPE_ALIASES` so both spellings of an aliased\n * widget are present whenever either one is.\n *\n * `CnWidgetGrid` resolves a key and its canonical form (`object-table` ⇄\n * `table`, `map-viewer` ⇄ `map`), so both spellings render and both must be\n * exempt. Today each registry happens to hold one side of each pair, which is\n * exactly the accident that would silently stop being true when the next alias\n * lands.\n *\n * @param {Set<string>} keys The key set to expand, mutated in place.\n * @return {Set<string>} The same set.\n */\nfunction expandAliases(keys) {\n\tfor (const [alias, canonical] of Object.entries(WIDGET_TYPE_ALIASES)) {\n\t\tif (keys.has(alias) || keys.has(canonical)) {\n\t\t\tkeys.add(alias)\n\t\t\tkeys.add(canonical)\n\t\t}\n\t}\n\treturn keys\n}\n\n/**\n * Every widget key the library renders itself: both registries, plus both\n * spellings of every alias.\n *\n * A `widgetKey` in this list is served by a library `Cn*` SFC and does NOT\n * count as a custom registry component for the single-12×12-widget dashboard\n * rule (ADR-036 Decision 1).\n *\n * @type {string[]} Frozen.\n */\nexport const LIBRARY_WIDGET_KEYS = Object.freeze([\n\t...expandAliases(new Set([\n\t\t...BUILT_IN_WIDGET_KEYS,\n\t\t...DASHBOARD_CATALOG_WIDGET_KEYS,\n\t])),\n])\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAClD,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,YAAY;AACb,CAAC,QAAQ;AACT,CAAC,YAAY;AACb,CAAC,WAAW;AACZ,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,SAAS;AACV,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,SAAS;AACV,CAAC,kBAAkB;AACnB,CAAC,SAAS;AACV,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;AAC3D,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,UAAU;AACX,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,aAAa;AACd,CAAC,eAAe;AAChB,CAAC,WAAW;AACZ,CAAC,cAAc;AACf,CAAC,WAAW;AACZ,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,SAAS;AACV,CAAC,iBAAiB;AAClB,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,OAAO;AACR,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,QAAQ;AACT,CAAC,OAAO;AACR,CAAC,kBAAkB;AACnB,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,KAAK;AACN,CAAC,UAAU;AACX,CAAC,MAAM;AACP,CAAC,WAAW;AACZ,CAAC,WAAW;AACZ,CAAC,SAAS;AACV;AACA;AACA,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,QAAQ;AACT,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,SAAS;AACV,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,eAAe;AAChB,CAAC,iBAAiB;AAClB,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,cAAc;AACf,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,kBAAkB;AACnB,CAAC,kBAAkB;AACnB,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAE;AAC7B,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;AACvE,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AAC9C,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC;AAClB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAC;AACtB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,IAAI;AACZ,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC;AAC1B,EAAE,GAAG,oBAAoB;AACzB,EAAE,GAAG,6BAA6B;AAClC,EAAE,CAAC,CAAC;AACJ,CAAC;;;;"}
+{"version":3,"file":"libraryWidgetKeys.js","sources":["../../../src/utils/libraryWidgetKeys.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * libraryWidgetKeys — the one vocabulary of widget keys the LIBRARY itself\n * renders, and the only list `validateManifestV2` is allowed to consult.\n *\n * WHY THIS MODULE EXISTS\n * ----------------------\n * The validator used to carry its own hand-written array of \"library built-in\n * widget keys\", with a comment instructing whoever added a built-in to append\n * it \"in the same PR\". That instruction was followed for five keys and missed\n * for six, so the validator knew 11 keys while the library actually rendered\n * 45. Nothing failed when the two disagreed, because the only consumer is an\n * exemption: a key the validator does not recognise is treated as a CUSTOM\n * registry component, which makes a legitimate single-widget library dashboard\n * fail the ADR-036 Decision 1 anti-pattern rule with advice (\"declare it as\n * type:'custom'\") that is wrong for a library widget.\n *\n * A comment cannot enforce anything, so the array moved here and\n * `tests/utils/libraryWidgetKeys.spec.js` now binds it to the two registries\n * that actually resolve a key at runtime:\n *\n *   1. `BUILT_IN_WIDGETS` (components/CnWidgetGrid/builtInWidgets.js) — the v2\n *      manifest widget set `CnWidgetGrid` resolves a `widgetKey` against.\n *   2. The dashboard widget catalog (`dashboardWidgetRegistry`), populated by\n *      `registerDashboardWidgets.js`. `CnWidgetGrid` falls back to it (third in\n *      the chain, after the consumer registry and `BUILT_IN_WIDGETS`), so a\n *      catalog key renders on a v2 page exactly like a `BUILT_IN_WIDGETS` one.\n *\n * The test asserts SET EQUALITY in both directions against the live registries,\n * so adding a widget to either registry without touching this file fails CI,\n * and deleting one without removing it here fails too. The lists below are the\n * validator's view; the registries are the truth the test holds them to.\n *\n * THE CATALOG IS NOT LEGACY. It is a live half of the same vocabulary, and the\n * old array already conceded the point by exempting `chart` and `stats-block`,\n * which are catalog-only keys that `BUILT_IN_WIDGETS` has never held. What it\n * got wrong was doing that for two keys and not the other thirty-seven.\n * `widgetDispatch.js` unified the two resolution paths for the same reason: a\n * widget authored against one vocabulary was invisible to the other and said\n * nothing about why (101 of 236 detail widgets on hrmq).\n *\n * @module utils/libraryWidgetKeys\n */\n\nimport { WIDGET_TYPE_ALIASES } from './widgetTypeAliases.js'\n\n/**\n * Keys of `BUILT_IN_WIDGETS` — the v2 manifest widget set.\n *\n * Kept in the registry's own declaration order so a diff against\n * `builtInWidgets.js` reads straight down.\n *\n * @type {string[]} Frozen.\n */\nexport const BUILT_IN_WIDGET_KEYS = Object.freeze([\n\t'object-table',\n\t'form-renderer',\n\t'map-viewer',\n\t'notice',\n\t'decision-list',\n\t'object-geo',\n\t'card-grid',\n\t'nav-card-grid',\n\t'data',\n\t'metadata',\n\t'related',\n\t'integration',\n\t'banner',\n\t'audit-trail',\n\t'timeline',\n\t'header',\n\t'text',\n\t'divider',\n\t'saved-view-alert',\n\t'exports',\n])\n\n/**\n * Widget types the LIBRARY registers into the dashboard catalog at import time\n * (`registerDashboardWidgets.js` and the widget `index.js` modules it pulls in).\n *\n * Deliberately a static list rather than a read of `dashboardWidgetRegistry`:\n * that object is mutable and consumer-extensible, so deriving the exemption\n * from it at call time would let an app register its own full-page component in\n * the catalog and walk straight through the ADR-036 Decision 1 rule the\n * exemption exists to enforce. Only keys the library itself ships are exempt.\n *\n * Sorted, because unlike `BUILT_IN_WIDGETS` these registrations are spread over\n * ~30 files and have no meaningful declaration order.\n *\n * @type {string[]} Frozen.\n */\nexport const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'checklist-run',\n\t'chips-field',\n\t'choice-picker',\n\t'container',\n\t'conversation',\n\t'countdown',\n\t'data',\n\t'delta',\n\t'device-frames',\n\t'divider',\n\t'document-review',\n\t'facts',\n\t'field-list',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'grouped-cards',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'links',\n\t'mail',\n\t'map',\n\t'markdown',\n\t'menu',\n\t'nc-widget',\n\t'next-step',\n\t'notepad',\n\t// `news` was here until the widget moved to LaunchPad, which owns the feed\n\t// fetching. An app that renders one now gets it from LaunchPad's registry.\n\t'object-geo',\n\t'object-list',\n\t'object-table',\n\t'party-actions',\n\t'people',\n\t'plan',\n\t'quicklinks',\n\t'radio-cards',\n\t'record-list',\n\t'related',\n\t'retention',\n\t'saved-view',\n\t'saved-views',\n\t'sections',\n\t'settings-form',\n\t'spend-analytics',\n\t'stacked-bar',\n\t'stages',\n\t'stat',\n\t'stats-block',\n\t'switch-rows',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'team-workload',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'toggle-table',\n\t'video',\n\t'week-strip',\n\t'working-calendar',\n\t'work-queue',\n\t'workspace-filter',\n])\n\n/**\n * Expand a key set over `WIDGET_TYPE_ALIASES` so both spellings of an aliased\n * widget are present whenever either one is.\n *\n * `CnWidgetGrid` resolves a key and its canonical form (`object-table` ⇄\n * `table`, `map-viewer` ⇄ `map`), so both spellings render and both must be\n * exempt. Today each registry happens to hold one side of each pair, which is\n * exactly the accident that would silently stop being true when the next alias\n * lands.\n *\n * @param {Set<string>} keys The key set to expand, mutated in place.\n * @return {Set<string>} The same set.\n */\nfunction expandAliases(keys) {\n\tfor (const [alias, canonical] of Object.entries(WIDGET_TYPE_ALIASES)) {\n\t\tif (keys.has(alias) || keys.has(canonical)) {\n\t\t\tkeys.add(alias)\n\t\t\tkeys.add(canonical)\n\t\t}\n\t}\n\treturn keys\n}\n\n/**\n * Every widget key the library renders itself: both registries, plus both\n * spellings of every alias.\n *\n * A `widgetKey` in this list is served by a library `Cn*` SFC and does NOT\n * count as a custom registry component for the single-12×12-widget dashboard\n * rule (ADR-036 Decision 1).\n *\n * @type {string[]} Frozen.\n */\nexport const LIBRARY_WIDGET_KEYS = Object.freeze([\n\t...expandAliases(new Set([\n\t\t...BUILT_IN_WIDGET_KEYS,\n\t\t...DASHBOARD_CATALOG_WIDGET_KEYS,\n\t])),\n])\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAClD,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,YAAY;AACb,CAAC,QAAQ;AACT,CAAC,eAAe;AAChB,CAAC,YAAY;AACb,CAAC,WAAW;AACZ,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,SAAS;AACV,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,SAAS;AACV,CAAC,kBAAkB;AACnB,CAAC,SAAS;AACV,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;AAC3D,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,UAAU;AACX,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,aAAa;AACd,CAAC,eAAe;AAChB,CAAC,WAAW;AACZ,CAAC,cAAc;AACf,CAAC,WAAW;AACZ,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,SAAS;AACV,CAAC,iBAAiB;AAClB,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,OAAO;AACR,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,QAAQ;AACT,CAAC,OAAO;AACR,CAAC,kBAAkB;AACnB,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,KAAK;AACN,CAAC,UAAU;AACX,CAAC,MAAM;AACP,CAAC,WAAW;AACZ,CAAC,WAAW;AACZ,CAAC,SAAS;AACV;AACA;AACA,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,SAAS;AACV,CAAC,WAAW;AACZ,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,eAAe;AAChB,CAAC,iBAAiB;AAClB,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,cAAc;AACf,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,kBAAkB;AACnB,CAAC,YAAY;AACb,CAAC,kBAAkB;AACnB,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAE;AAC7B,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;AACvE,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AAC9C,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC;AAClB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAC;AACtB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,IAAI;AACZ,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC;AAC1B,EAAE,GAAG,oBAAoB;AACzB,EAAE,GAAG,6BAA6B;AAClC,EAAE,CAAC,CAAC;AACJ,CAAC;;;;"}

package/dist/esm/utils/openDuplicateWarning.js

@@ -0,0 +1,39 @@
+import { createApp } from 'vue';
+import __sfc_main from '../components/CnDuplicateWarning/CnDuplicateWarning.vue.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Open CnDuplicateWarning from code (a create override, a store action) and
+ * wait for the user's answer.
+ *
+ * @module utils/openDuplicateWarning
+ */
+
+
+/**
+ * Mount the warning on the page and resolve with the decision: `{ reason,
+ * over }` when the user files anyway, null when they cancel.
+ *
+ * @spec openspec/changes/duplicate-warning/specs/duplicate-warning/spec.md#requirement-a-generic-duplicate-warning
+ * @param {object} props CnDuplicateWarning's props (`matches`, `records`, `policy`, `mayOverride`, ...).
+ * @return {Promise<{reason: string, over: Array<string>}|null>} The decision.
+ */
+function openDuplicateWarning(props) {
+	return new Promise((resolve) => {
+		const host = document.createElement('div');
+		document.body.appendChild(host);
+		let app = null;
+		const finish = (decision) => {
+			app.unmount();
+			host.remove();
+			resolve(decision);
+		};
+		app = createApp(__sfc_main, { ...(props || {}), onClose: () => finish(null), onFile: (decision) => finish(decision) });
+		app.mount(host);
+	})
+}
+
+export { openDuplicateWarning };
+//# sourceMappingURL=openDuplicateWarning.js.map

package/dist/esm/utils/openDuplicateWarning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openDuplicateWarning.js","sources":["../../../src/utils/openDuplicateWarning.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Open CnDuplicateWarning from code (a create override, a store action) and\n * wait for the user's answer.\n *\n * @module utils/openDuplicateWarning\n */\n\nimport { createApp } from 'vue'\nimport CnDuplicateWarning from '../components/CnDuplicateWarning/CnDuplicateWarning.vue'\n\n/**\n * Mount the warning on the page and resolve with the decision: `{ reason,\n * over }` when the user files anyway, null when they cancel.\n *\n * @spec openspec/changes/duplicate-warning/specs/duplicate-warning/spec.md#requirement-a-generic-duplicate-warning\n * @param {object} props CnDuplicateWarning's props (`matches`, `records`, `policy`, `mayOverride`, ...).\n * @return {Promise<{reason: string, over: Array<string>}|null>} The decision.\n */\nexport function openDuplicateWarning(props) {\n\treturn new Promise((resolve) => {\n\t\tconst host = document.createElement('div')\n\t\tdocument.body.appendChild(host)\n\t\tlet app = null\n\t\tconst finish = (decision) => {\n\t\t\tapp.unmount()\n\t\t\thost.remove()\n\t\t\tresolve(decision)\n\t\t}\n\t\tapp = createApp(CnDuplicateWarning, { ...(props || {}), onClose: () => finish(null), onFile: (decision) => finish(decision) })\n\t\tapp.mount(host)\n\t})\n}\n"],"names":["CnDuplicateWarning"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,KAAK,EAAE;AAC5C,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK;AACjC,EAAE,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAC;AAC5C,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAC;AACjC,EAAE,IAAI,GAAG,GAAG,KAAI;AAChB,EAAE,MAAM,MAAM,GAAG,CAAC,QAAQ,KAAK;AAC/B,GAAG,GAAG,CAAC,OAAO,GAAE;AAChB,GAAG,IAAI,CAAC,MAAM,GAAE;AAChB,GAAG,OAAO,CAAC,QAAQ,EAAC;AACpB,IAAG;AACH,EAAE,GAAG,GAAG,SAAS,CAACA,UAAkB,EAAE,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAC;AAChI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAC;AACjB,EAAE,CAAC;AACH;;;;"}

package/dist/esm/utils/optionsFrom.js

@@ -114,7 +114,7 @@ async function loadOptionsFrom(from, ctx = {}) {
 		return []
 	}
 	const data = await fetchEndpointSource(source, ctx, { force: true });
-	const rows = Array.isArray(data) ? data : [];
+	const rows = narrowRows(Array.isArray(data) ? data : [], from);
 	const seen = new Set();
 	const out = [];
 	for (const row of rows) {
@@ -132,6 +132,73 @@ async function loadOptionsFrom(from, ctx = {}) {
 	return out
 }
 
+/**
+ * The rows a source answers, narrowed: `where` keeps the rows whose fields
+ * equal its values (`{ type: 'string' }`), and `itemsPath` replaces each
+ * remaining row by the list at that path (the formats of one property type).
+ *
+ * @param {Array<unknown>} rows The rows.
+ * @param {{where?: object, itemsPath?: string}} from The `optionsFrom` block.
+ * @return {Array<unknown>} The rows the options are read from.
+ */
+function narrowRows(rows, from) {
+	let out = rows;
+	if (isPlainObject(from.where)) {
+		out = out.filter((row) => row && typeof row === 'object' && Object.entries(from.where).every(([key, value]) => String(readPath(row, key)) === String(value)));
+	}
+	if (typeof from.itemsPath === 'string' && from.itemsPath !== '') {
+		out = out.flatMap((row) => {
+			const items = readPath(row, from.itemsPath);
+			return Array.isArray(items) ? items : []
+		});
+	}
+	return out
+}
+
+/**
+ * An `optionsFrom` block with every `@answer.<key>` string replaced by that
+ * form value, so a source can depend on another field (`where: { type:
+ * '@answer.propertyType' }`). A value the form does not hold becomes ''.
+ *
+ * @param {unknown} value The block, or a part of it.
+ * @param {object} formData The form values.
+ * @return {unknown} The block with the form values filled in.
+ */
+function resolveFormTokens(value, formData) {
+	if (typeof value === 'string' && value.startsWith('@answer.')) {
+		const held = (formData || {})[value.slice('@answer.'.length)];
+		return held === undefined || held === null ? '' : held
+	}
+	if (Array.isArray(value)) {
+		return value.map((v) => resolveFormTokens(v, formData))
+	}
+	if (isPlainObject(value)) {
+		return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolveFormTokens(v, formData)]))
+	}
+	return value
+}
+
+/**
+ * The form fields an `optionsFrom` block reads through `@answer.<key>`.
+ *
+ * @param {unknown} from The block.
+ * @return {Array<string>} The keys.
+ */
+function formTokenKeys(from) {
+	const keys = new Set();
+	const walk = (v) => {
+		if (typeof v === 'string' && v.startsWith('@answer.')) {
+			keys.add(v.slice('@answer.'.length));
+		} else if (Array.isArray(v)) {
+			v.forEach(walk);
+		} else if (isPlainObject(v)) {
+			Object.values(v).forEach(walk);
+		}
+	};
+	walk(from);
+	return [...keys]
+}
+
 /**
  * The options whose label holds the query, ignoring case. An empty query
  * keeps them all.
@@ -164,5 +231,5 @@ function fieldWithOptionsFrom(field) {
 	return field.widget === widget ? field : { ...field, widget }
 }
 
-export { OPTIONS_FROM_LIMIT, fieldWithOptionsFrom, filterOptions, isOptionsFrom, loadOptionsFrom, optionFromRow, optionsFromSource };
+export { OPTIONS_FROM_LIMIT, fieldWithOptionsFrom, filterOptions, formTokenKeys, isOptionsFrom, loadOptionsFrom, optionFromRow, optionsFromSource, resolveFormTokens };
 //# sourceMappingURL=optionsFrom.js.map

package/dist/esm/utils/optionsFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"optionsFrom.js","sources":["../../../src/utils/optionsFrom.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Select options read from a source (`optionsFrom`), the shape a dashboard\n * page filter and a form field share:\n *\n * - `{ url, params?, responsePath? }`: rows from an app endpoint;\n * - `{ register, schema, filter? }`: OpenRegister objects of that schema;\n *\n * each with `valueField` (default `id`, else the object's uuid),\n * `labelField` (default `title`, else `name`, else the value) and an optional\n * `groupField` that groups the options, all dot-paths.\n *\n * @module utils/optionsFrom\n * @spec openspec/changes/form-field-options-from/specs/form-dialog/spec.md#requirement-a-select-field-can-read-its-options-from-a-source\n */\n\nimport { fetchEndpointSource } from '../composables/useEndpointSource.js'\nimport { readPath } from './readPath.js'\n\n/** How many objects a `{ register, schema }` source reads. */\nexport const OPTIONS_FROM_LIMIT = 500\n\nconst isPlainObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)\n\n/**\n * Whether a value is a usable `optionsFrom` block.\n *\n * @param {unknown} from The block.\n * @return {boolean} True for an endpoint or a register and schema.\n */\nexport function isOptionsFrom(from) {\n\tif (!isPlainObject(from)) {\n\t\treturn false\n\t}\n\tconst endpoint = typeof from.url === 'string' && from.url !== ''\n\tconst objects = typeof from.register === 'string' && from.register !== '' && typeof from.schema === 'string' && from.schema !== ''\n\treturn endpoint || objects\n}\n\n/**\n * The endpoint source an `optionsFrom` block reads, in the `endpointSource`\n * shape `fetchEndpointSource` takes.\n *\n * @param {object} from The `optionsFrom` block.\n * @return {{url: string, params?: object, responsePath?: string}|null} The source, or null when unusable.\n */\nexport function optionsFromSource(from) {\n\tif (!isOptionsFrom(from)) {\n\t\treturn null\n\t}\n\tif (typeof from.url === 'string' && from.url !== '') {\n\t\treturn {\n\t\t\turl: from.url,\n\t\t\t...(isPlainObject(from.params) ? { params: from.params } : {}),\n\t\t\t...(typeof from.responsePath === 'string' && from.responsePath !== '' ? { responsePath: from.responsePath } : {}),\n\t\t}\n\t}\n\treturn {\n\t\turl: `/apps/openregister/api/objects/${encodeURIComponent(from.register)}/${encodeURIComponent(from.schema)}`,\n\t\tparams: { _limit: OPTIONS_FROM_LIMIT, ...(isPlainObject(from.filter) ? from.filter : {}) },\n\t\tresponsePath: 'results',\n\t}\n}\n\n/**\n * One row as an `{ id, label }` option, or null for a row without a value.\n * A plain string or number is its own value and label.\n *\n * @param {unknown} row The row.\n * @param {{valueField?: string, labelField?: string}} [from] The `optionsFrom` block.\n * @return {{id: (string|number), label: string}|null} The option.\n */\nexport function optionFromRow(row, from = {}) {\n\tif (row === null || row === undefined) {\n\t\treturn null\n\t}\n\tif (typeof row !== 'object') {\n\t\treturn row === '' ? null : { id: row, label: String(row) }\n\t}\n\tconst id = typeof from.valueField === 'string' && from.valueField !== ''\n\t\t? readPath(row, from.valueField)\n\t\t: (row.id ?? row['@self']?.id ?? row.uuid)\n\tif (id === null || id === undefined || id === '' || typeof id === 'object') {\n\t\treturn null\n\t}\n\tconst label = typeof from.labelField === 'string' && from.labelField !== ''\n\t\t? readPath(row, from.labelField)\n\t\t: (row.title || row.name)\n\tconst option = { id, label: label === null || label === undefined || label === '' ? String(id) : String(label) }\n\t// `groupField`: the option's group, which keeps options of one group together.\n\tif (typeof from.groupField === 'string' && from.groupField !== '') {\n\t\tconst group = readPath(row, from.groupField)\n\t\tif (group !== null && group !== undefined && group !== '') {\n\t\t\toption.group = String(group)\n\t\t}\n\t}\n\treturn option\n}\n\n/**\n * Read the options of an `optionsFrom` block. A failed or empty read gives\n * no options; the caller decides how to show that.\n *\n * @param {object} from The `optionsFrom` block.\n * @param {object} [ctx] The token context for the params (see `fetchEndpointSource`).\n * @return {Promise<Array<{id: (string|number), label: string}>>} The options, in the source's order.\n */\nexport async function loadOptionsFrom(from, ctx = {}) {\n\tconst source = optionsFromSource(from)\n\tif (!source) {\n\t\treturn []\n\t}\n\tconst data = await fetchEndpointSource(source, ctx, { force: true })\n\tconst rows = Array.isArray(data) ? data : []\n\tconst seen = new Set()\n\tconst out = []\n\tfor (const row of rows) {\n\t\tconst option = optionFromRow(row, from)\n\t\tif (option && !seen.has(String(option.id))) {\n\t\t\tseen.add(String(option.id))\n\t\t\tout.push(option)\n\t\t}\n\t}\n\tif (typeof from.groupField === 'string' && from.groupField !== '') {\n\t\t// Groups in the order they first appear, each option keeping its place within its group.\n\t\tconst order = [...new Set(out.map((o) => o.group || ''))]\n\t\treturn order.flatMap((group) => out.filter((o) => (o.group || '') === group))\n\t}\n\treturn out\n}\n\n/**\n * The options whose label holds the query, ignoring case. An empty query\n * keeps them all.\n *\n * @param {Array<{id: (string|number), label: string}>} options The options.\n * @param {string} [query] The search text.\n * @return {Array<{id: (string|number), label: string}>} The matching options.\n */\nexport function filterOptions(options, query = '') {\n\tconst q = typeof query === 'string' ? query.trim().toLowerCase() : ''\n\tif (q === '') {\n\t\treturn options\n\t}\n\treturn options.filter((o) => o.label.toLowerCase().includes(q) || String(o.id).toLowerCase().includes(q))\n}\n\n/**\n * A form field that reads its options (`optionsFrom`) drawn as a select: a\n * single select, or a multiselect for an array field. Any other field is\n * returned as it is.\n *\n * @param {object} field The field definition.\n * @return {object} The field.\n */\nexport function fieldWithOptionsFrom(field) {\n\tif (!field || !isOptionsFrom(field.optionsFrom)) {\n\t\treturn field\n\t}\n\tconst widget = field.type === 'array' ? 'multiselect' : 'select'\n\treturn field.widget === widget ? field : { ...field, widget }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"optionsFrom.js","sources":["../../../src/utils/optionsFrom.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Select options read from a source (`optionsFrom`), the shape a dashboard\n * page filter and a form field share:\n *\n * - `{ url, params?, responsePath? }`: rows from an app endpoint;\n * - `{ register, schema, filter? }`: OpenRegister objects of that schema;\n *\n * each with `valueField` (default `id`, else the object's uuid),\n * `labelField` (default `title`, else `name`, else the value) and an optional\n * `groupField` that groups the options, all dot-paths.\n *\n * @module utils/optionsFrom\n * @spec openspec/changes/form-field-options-from/specs/form-dialog/spec.md#requirement-a-select-field-can-read-its-options-from-a-source\n */\n\nimport { fetchEndpointSource } from '../composables/useEndpointSource.js'\nimport { readPath } from './readPath.js'\n\n/** How many objects a `{ register, schema }` source reads. */\nexport const OPTIONS_FROM_LIMIT = 500\n\nconst isPlainObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)\n\n/**\n * Whether a value is a usable `optionsFrom` block.\n *\n * @param {unknown} from The block.\n * @return {boolean} True for an endpoint or a register and schema.\n */\nexport function isOptionsFrom(from) {\n\tif (!isPlainObject(from)) {\n\t\treturn false\n\t}\n\tconst endpoint = typeof from.url === 'string' && from.url !== ''\n\tconst objects = typeof from.register === 'string' && from.register !== '' && typeof from.schema === 'string' && from.schema !== ''\n\treturn endpoint || objects\n}\n\n/**\n * The endpoint source an `optionsFrom` block reads, in the `endpointSource`\n * shape `fetchEndpointSource` takes.\n *\n * @param {object} from The `optionsFrom` block.\n * @return {{url: string, params?: object, responsePath?: string}|null} The source, or null when unusable.\n */\nexport function optionsFromSource(from) {\n\tif (!isOptionsFrom(from)) {\n\t\treturn null\n\t}\n\tif (typeof from.url === 'string' && from.url !== '') {\n\t\treturn {\n\t\t\turl: from.url,\n\t\t\t...(isPlainObject(from.params) ? { params: from.params } : {}),\n\t\t\t...(typeof from.responsePath === 'string' && from.responsePath !== '' ? { responsePath: from.responsePath } : {}),\n\t\t}\n\t}\n\treturn {\n\t\turl: `/apps/openregister/api/objects/${encodeURIComponent(from.register)}/${encodeURIComponent(from.schema)}`,\n\t\tparams: { _limit: OPTIONS_FROM_LIMIT, ...(isPlainObject(from.filter) ? from.filter : {}) },\n\t\tresponsePath: 'results',\n\t}\n}\n\n/**\n * One row as an `{ id, label }` option, or null for a row without a value.\n * A plain string or number is its own value and label.\n *\n * @param {unknown} row The row.\n * @param {{valueField?: string, labelField?: string}} [from] The `optionsFrom` block.\n * @return {{id: (string|number), label: string}|null} The option.\n */\nexport function optionFromRow(row, from = {}) {\n\tif (row === null || row === undefined) {\n\t\treturn null\n\t}\n\tif (typeof row !== 'object') {\n\t\treturn row === '' ? null : { id: row, label: String(row) }\n\t}\n\tconst id = typeof from.valueField === 'string' && from.valueField !== ''\n\t\t? readPath(row, from.valueField)\n\t\t: (row.id ?? row['@self']?.id ?? row.uuid)\n\tif (id === null || id === undefined || id === '' || typeof id === 'object') {\n\t\treturn null\n\t}\n\tconst label = typeof from.labelField === 'string' && from.labelField !== ''\n\t\t? readPath(row, from.labelField)\n\t\t: (row.title || row.name)\n\tconst option = { id, label: label === null || label === undefined || label === '' ? String(id) : String(label) }\n\t// `groupField`: the option's group, which keeps options of one group together.\n\tif (typeof from.groupField === 'string' && from.groupField !== '') {\n\t\tconst group = readPath(row, from.groupField)\n\t\tif (group !== null && group !== undefined && group !== '') {\n\t\t\toption.group = String(group)\n\t\t}\n\t}\n\treturn option\n}\n\n/**\n * Read the options of an `optionsFrom` block. A failed or empty read gives\n * no options; the caller decides how to show that.\n *\n * @param {object} from The `optionsFrom` block.\n * @param {object} [ctx] The token context for the params (see `fetchEndpointSource`).\n * @return {Promise<Array<{id: (string|number), label: string}>>} The options, in the source's order.\n */\nexport async function loadOptionsFrom(from, ctx = {}) {\n\tconst source = optionsFromSource(from)\n\tif (!source) {\n\t\treturn []\n\t}\n\tconst data = await fetchEndpointSource(source, ctx, { force: true })\n\tconst rows = narrowRows(Array.isArray(data) ? data : [], from)\n\tconst seen = new Set()\n\tconst out = []\n\tfor (const row of rows) {\n\t\tconst option = optionFromRow(row, from)\n\t\tif (option && !seen.has(String(option.id))) {\n\t\t\tseen.add(String(option.id))\n\t\t\tout.push(option)\n\t\t}\n\t}\n\tif (typeof from.groupField === 'string' && from.groupField !== '') {\n\t\t// Groups in the order they first appear, each option keeping its place within its group.\n\t\tconst order = [...new Set(out.map((o) => o.group || ''))]\n\t\treturn order.flatMap((group) => out.filter((o) => (o.group || '') === group))\n\t}\n\treturn out\n}\n\n/**\n * The rows a source answers, narrowed: `where` keeps the rows whose fields\n * equal its values (`{ type: 'string' }`), and `itemsPath` replaces each\n * remaining row by the list at that path (the formats of one property type).\n *\n * @param {Array<unknown>} rows The rows.\n * @param {{where?: object, itemsPath?: string}} from The `optionsFrom` block.\n * @return {Array<unknown>} The rows the options are read from.\n */\nfunction narrowRows(rows, from) {\n\tlet out = rows\n\tif (isPlainObject(from.where)) {\n\t\tout = out.filter((row) => row && typeof row === 'object' && Object.entries(from.where).every(([key, value]) => String(readPath(row, key)) === String(value)))\n\t}\n\tif (typeof from.itemsPath === 'string' && from.itemsPath !== '') {\n\t\tout = out.flatMap((row) => {\n\t\t\tconst items = readPath(row, from.itemsPath)\n\t\t\treturn Array.isArray(items) ? items : []\n\t\t})\n\t}\n\treturn out\n}\n\n/**\n * An `optionsFrom` block with every `@answer.<key>` string replaced by that\n * form value, so a source can depend on another field (`where: { type:\n * '@answer.propertyType' }`). A value the form does not hold becomes ''.\n *\n * @param {unknown} value The block, or a part of it.\n * @param {object} formData The form values.\n * @return {unknown} The block with the form values filled in.\n */\nexport function resolveFormTokens(value, formData) {\n\tif (typeof value === 'string' && value.startsWith('@answer.')) {\n\t\tconst held = (formData || {})[value.slice('@answer.'.length)]\n\t\treturn held === undefined || held === null ? '' : held\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value.map((v) => resolveFormTokens(v, formData))\n\t}\n\tif (isPlainObject(value)) {\n\t\treturn Object.fromEntries(Object.entries(value).map(([k, v]) => [k, resolveFormTokens(v, formData)]))\n\t}\n\treturn value\n}\n\n/**\n * The form fields an `optionsFrom` block reads through `@answer.<key>`.\n *\n * @param {unknown} from The block.\n * @return {Array<string>} The keys.\n */\nexport function formTokenKeys(from) {\n\tconst keys = new Set()\n\tconst walk = (v) => {\n\t\tif (typeof v === 'string' && v.startsWith('@answer.')) {\n\t\t\tkeys.add(v.slice('@answer.'.length))\n\t\t} else if (Array.isArray(v)) {\n\t\t\tv.forEach(walk)\n\t\t} else if (isPlainObject(v)) {\n\t\t\tObject.values(v).forEach(walk)\n\t\t}\n\t}\n\twalk(from)\n\treturn [...keys]\n}\n\n/**\n * The options whose label holds the query, ignoring case. An empty query\n * keeps them all.\n *\n * @param {Array<{id: (string|number), label: string}>} options The options.\n * @param {string} [query] The search text.\n * @return {Array<{id: (string|number), label: string}>} The matching options.\n */\nexport function filterOptions(options, query = '') {\n\tconst q = typeof query === 'string' ? query.trim().toLowerCase() : ''\n\tif (q === '') {\n\t\treturn options\n\t}\n\treturn options.filter((o) => o.label.toLowerCase().includes(q) || String(o.id).toLowerCase().includes(q))\n}\n\n/**\n * A form field that reads its options (`optionsFrom`) drawn as a select: a\n * single select, or a multiselect for an array field. Any other field is\n * returned as it is.\n *\n * @param {object} field The field definition.\n * @return {object} The field.\n */\nexport function fieldWithOptionsFrom(field) {\n\tif (!field || !isOptionsFrom(field.optionsFrom)) {\n\t\treturn field\n\t}\n\tconst widget = field.type === 'array' ? 'multiselect' : 'select'\n\treturn field.widget === widget ? field : { ...field, widget }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/planTree.js

@@ -0,0 +1,57 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The plan rows of OpenRegister's case layer as a tree, and the moves a
+ * user may ask for on one item. The moves are advisory: OpenRegister decides.
+ *
+ * @module utils/planTree
+ */
+
+/** Plan item states after which nothing more can happen. */
+const TERMINAL_STATES = ['completed', 'terminated', 'disabled'];
+
+/**
+ * The plan rows as a tree: stages with their items, each level by position.
+ *
+ * @param {Array<object>} items The plan rows (`id`, `parentItemId`, `position`).
+ * @return {Array<object>} The roots, each with `children`.
+ */
+function planTree(items) {
+	const rows = Array.isArray(items) ? items : [];
+	const byId = new Map(rows.map((row) => [row.id, { ...row, children: [] }]));
+	const roots = [];
+	for (const row of rows) {
+		const node = byId.get(row.id);
+		const parent = row.parentItemId === null || row.parentItemId === undefined ? undefined : byId.get(row.parentItemId);
+		if (parent === undefined) {
+			roots.push(node);
+		} else {
+			parent.children.push(node);
+		}
+	}
+	const byPosition = (a, b) => (a.position ?? 0) - (b.position ?? 0);
+	for (const node of byId.values()) {
+		node.children.sort(byPosition);
+	}
+	return roots.sort(byPosition)
+}
+
+/**
+ * The target states a user may ask for. Advisory only: OpenRegister decides.
+ *
+ * @param {object} item The plan item.
+ * @return {string[]} The targets.
+ */
+function offeredTransitions(item) {
+	if (!item || TERMINAL_STATES.includes(item.state)) {
+		return []
+	}
+	if (item.type === 'milestone') {
+		return item.state === 'available' ? ['completed', 'terminated'] : []
+	}
+	return item.state === 'active' ? ['completed', 'terminated'] : ['terminated']
+}
+
+export { TERMINAL_STATES, offeredTransitions, planTree };
+//# sourceMappingURL=planTree.js.map

package/dist/esm/utils/planTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planTree.js","sources":["../../../src/utils/planTree.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The plan rows of OpenRegister's case layer as a tree, and the moves a\n * user may ask for on one item. The moves are advisory: OpenRegister decides.\n *\n * @module utils/planTree\n */\n\n/** Plan item states after which nothing more can happen. */\nexport const TERMINAL_STATES = ['completed', 'terminated', 'disabled']\n\n/**\n * The plan rows as a tree: stages with their items, each level by position.\n *\n * @param {Array<object>} items The plan rows (`id`, `parentItemId`, `position`).\n * @return {Array<object>} The roots, each with `children`.\n */\nexport function planTree(items) {\n\tconst rows = Array.isArray(items) ? items : []\n\tconst byId = new Map(rows.map((row) => [row.id, { ...row, children: [] }]))\n\tconst roots = []\n\tfor (const row of rows) {\n\t\tconst node = byId.get(row.id)\n\t\tconst parent = row.parentItemId === null || row.parentItemId === undefined ? undefined : byId.get(row.parentItemId)\n\t\tif (parent === undefined) {\n\t\t\troots.push(node)\n\t\t} else {\n\t\t\tparent.children.push(node)\n\t\t}\n\t}\n\tconst byPosition = (a, b) => (a.position ?? 0) - (b.position ?? 0)\n\tfor (const node of byId.values()) {\n\t\tnode.children.sort(byPosition)\n\t}\n\treturn roots.sort(byPosition)\n}\n\n/**\n * The target states a user may ask for. Advisory only: OpenRegister decides.\n *\n * @param {object} item The plan item.\n * @return {string[]} The targets.\n */\nexport function offeredTransitions(item) {\n\tif (!item || TERMINAL_STATES.includes(item.state)) {\n\t\treturn []\n\t}\n\tif (item.type === 'milestone') {\n\t\treturn item.state === 'available' ? ['completed', 'terminated'] : []\n\t}\n\treturn item.state === 'active' ? ['completed', 'terminated'] : ['terminated']\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,eAAe,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAC;AACtE;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,QAAQ,CAAC,KAAK,EAAE;AAChC,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,GAAE;AAC/C,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC;AAC5E,CAAC,MAAM,KAAK,GAAG,GAAE;AACjB,CAAC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;AACzB,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAC;AAC/B,EAAE,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,IAAI,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,EAAC;AACrH,EAAE,IAAI,MAAM,KAAK,SAAS,EAAE;AAC5B,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAC;AACnB,GAAG,MAAM;AACT,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAC;AAC7B,GAAG;AACH,EAAE;AACF,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAC;AACnE,CAAC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;AACnC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAC;AAChC,EAAE;AACF,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;AAC9B,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,IAAI,EAAE;AACzC,CAAC,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;AACpD,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE;AAChC,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,WAAW,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,EAAE;AACtE,EAAE;AACF,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC;AAC9E;;;;"}

package/dist/esm/utils/redactionSegments.js

@@ -0,0 +1,53 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * A document text cut into plain and marked segments, for the redaction
+ * editor to draw the passages in place.
+ *
+ * @module utils/redactionSegments
+ */
+
+/**
+ * The text as segments: plain ones and marked ones carrying the passage's
+ * verdict (`open` before it has one). Where passages overlap the longest wins,
+ * and every occurrence of a passage is marked.
+ *
+ * @param {string} text The document text.
+ * @param {Array<{value: string, verdict: (string|null)}>} passages The passages.
+ * @return {Array<{text: string, verdict: (string|null)}>} The segments.
+ */
+function redactionSegments(text, passages) {
+	const source = String(text || '');
+	const ranges = [];
+	const ordered = (Array.isArray(passages) ? passages : [])
+		.filter((passage) => passage && String(passage.value || '') !== '')
+		.sort((left, right) => right.value.length - left.value.length);
+	for (const passage of ordered) {
+		let from = source.indexOf(passage.value);
+		while (from !== -1) {
+			const to = from + passage.value.length;
+			if (ranges.every((range) => to <= range.from || from >= range.to)) {
+				ranges.push({ from, to, verdict: passage.verdict || 'open' });
+			}
+			from = source.indexOf(passage.value, to);
+		}
+	}
+	ranges.sort((left, right) => left.from - right.from);
+	const segments = [];
+	let at = 0;
+	for (const range of ranges) {
+		if (range.from > at) {
+			segments.push({ text: source.slice(at, range.from), verdict: null });
+		}
+		segments.push({ text: source.slice(range.from, range.to), verdict: range.verdict });
+		at = range.to;
+	}
+	if (at < source.length) {
+		segments.push({ text: source.slice(at), verdict: null });
+	}
+	return segments
+}
+
+export { redactionSegments };
+//# sourceMappingURL=redactionSegments.js.map

package/dist/esm/utils/redactionSegments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactionSegments.js","sources":["../../../src/utils/redactionSegments.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * A document text cut into plain and marked segments, for the redaction\n * editor to draw the passages in place.\n *\n * @module utils/redactionSegments\n */\n\n/**\n * The text as segments: plain ones and marked ones carrying the passage's\n * verdict (`open` before it has one). Where passages overlap the longest wins,\n * and every occurrence of a passage is marked.\n *\n * @param {string} text The document text.\n * @param {Array<{value: string, verdict: (string|null)}>} passages The passages.\n * @return {Array<{text: string, verdict: (string|null)}>} The segments.\n */\nexport function redactionSegments(text, passages) {\n\tconst source = String(text || '')\n\tconst ranges = []\n\tconst ordered = (Array.isArray(passages) ? passages : [])\n\t\t.filter((passage) => passage && String(passage.value || '') !== '')\n\t\t.sort((left, right) => right.value.length - left.value.length)\n\tfor (const passage of ordered) {\n\t\tlet from = source.indexOf(passage.value)\n\t\twhile (from !== -1) {\n\t\t\tconst to = from + passage.value.length\n\t\t\tif (ranges.every((range) => to <= range.from || from >= range.to)) {\n\t\t\t\tranges.push({ from, to, verdict: passage.verdict || 'open' })\n\t\t\t}\n\t\t\tfrom = source.indexOf(passage.value, to)\n\t\t}\n\t}\n\tranges.sort((left, right) => left.from - right.from)\n\tconst segments = []\n\tlet at = 0\n\tfor (const range of ranges) {\n\t\tif (range.from > at) {\n\t\t\tsegments.push({ text: source.slice(at, range.from), verdict: null })\n\t\t}\n\t\tsegments.push({ text: source.slice(range.from, range.to), verdict: range.verdict })\n\t\tat = range.to\n\t}\n\tif (at < source.length) {\n\t\tsegments.push({ text: source.slice(at), verdict: null })\n\t}\n\treturn segments\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE;AAClD,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,EAAC;AAClC,CAAC,MAAM,MAAM,GAAG,GAAE;AAClB,CAAC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,EAAE;AACzD,GAAG,MAAM,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;AACrE,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAC;AAChE,CAAC,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE;AAChC,EAAE,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAC;AAC1C,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC,EAAE;AACtB,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAM;AACzC,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE;AACtE,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,EAAE,EAAC;AACjE,IAAI;AACJ,GAAG,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAC;AAC3C,GAAG;AACH,EAAE;AACF,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAC;AACrD,CAAC,MAAM,QAAQ,GAAG,GAAE;AACpB,CAAC,IAAI,EAAE,GAAG,EAAC;AACX,CAAC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC7B,EAAE,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE;AACvB,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAC;AACvE,GAAG;AACH,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAC;AACrF,EAAE,EAAE,GAAG,KAAK,CAAC,GAAE;AACf,EAAE;AACF,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;AACzB,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAC;AAC1D,EAAE;AACF,CAAC,OAAO,QAAQ;AAChB;;;;"}

package/dist/esm/utils/registerNcDashboardWidgets.js

@@ -0,0 +1,61 @@
+import { translate } from '@nextcloud/l10n';
+import { createApp } from 'vue';
+import __sfc_main from '../components/CnNcDashboardList/CnNcDashboardList.vue.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Register an app's Nextcloud Dashboard widgets from configuration.
+ *
+ * @module utils/registerNcDashboardWidgets
+ */
+
+
+/**
+ * Register each widget with `OCA.Dashboard.register(id, …)`. A widget mounts
+ * CnNcDashboardList with its `config`, or its own `component` with `props`
+ * and the widget's `title`, as its own Vue app with the app's translate provided as `cnTranslate`. The
+ * Dashboard host draws the widget's title, so the component must not.
+ *
+ * The widget ids are the ones the app's PHP `IWidget::getId()` returns; the
+ * server side stays the app's.
+ *
+ * @spec openspec/changes/nc-dashboard-widgets/specs/nc-dashboard-widgets/spec.md#requirement-dashboard-widgets-are-configuration
+ * @param {Array<{id: string, config?: object, component?: object, props?: object}>} widgets The widgets.
+ * @param {object} options Options.
+ * @param {string} options.appId The app id, for its translations.
+ * @param {(app: object) => void} [options.setup] Called on each widget's Vue app before mounting (to `use` a pinia, say).
+ * @param {object} [options.dashboard] The `OCA.Dashboard` registry (default `window.OCA.Dashboard`).
+ * @return {string[]} The ids registered; none when the Dashboard is absent.
+ */
+function registerNcDashboardWidgets(widgets, options = {}) {
+	const dashboard = options.dashboard || (typeof window !== 'undefined' && window.OCA && window.OCA.Dashboard) || null;
+	if (!dashboard || typeof dashboard.register !== 'function' || !Array.isArray(widgets)) {
+		return []
+	}
+	const appId = options.appId || 'nextcloud-vue';
+	const cnTranslate = (key, vars) => translate(appId, key, vars);
+	const registered = [];
+	for (const widget of widgets) {
+		if (!widget || typeof widget.id !== 'string' || widget.id === '') {
+			continue
+		}
+		dashboard.register(widget.id, (el, context = {}) => {
+			const title = context.widget && context.widget.title ? context.widget.title : '';
+			const app = widget.component
+				? createApp(widget.component, { ...(widget.props || {}), title })
+				: createApp(__sfc_main, { config: widget.config || {} });
+			app.provide('cnTranslate', cnTranslate);
+			if (typeof options.setup === 'function') {
+				options.setup(app);
+			}
+			app.mount(el);
+		});
+		registered.push(widget.id);
+	}
+	return registered
+}
+
+export { registerNcDashboardWidgets };
+//# sourceMappingURL=registerNcDashboardWidgets.js.map

package/dist/esm/utils/registerNcDashboardWidgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerNcDashboardWidgets.js","sources":["../../../src/utils/registerNcDashboardWidgets.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Register an app's Nextcloud Dashboard widgets from configuration.\n *\n * @module utils/registerNcDashboardWidgets\n */\n\nimport { translate } from '@nextcloud/l10n'\nimport { createApp } from 'vue'\nimport CnNcDashboardList from '../components/CnNcDashboardList/CnNcDashboardList.vue'\n\n/**\n * Register each widget with `OCA.Dashboard.register(id, …)`. A widget mounts\n * CnNcDashboardList with its `config`, or its own `component` with `props`\n * and the widget's `title`, as its own Vue app with the app's translate provided as `cnTranslate`. The\n * Dashboard host draws the widget's title, so the component must not.\n *\n * The widget ids are the ones the app's PHP `IWidget::getId()` returns; the\n * server side stays the app's.\n *\n * @spec openspec/changes/nc-dashboard-widgets/specs/nc-dashboard-widgets/spec.md#requirement-dashboard-widgets-are-configuration\n * @param {Array<{id: string, config?: object, component?: object, props?: object}>} widgets The widgets.\n * @param {object} options Options.\n * @param {string} options.appId The app id, for its translations.\n * @param {(app: object) => void} [options.setup] Called on each widget's Vue app before mounting (to `use` a pinia, say).\n * @param {object} [options.dashboard] The `OCA.Dashboard` registry (default `window.OCA.Dashboard`).\n * @return {string[]} The ids registered; none when the Dashboard is absent.\n */\nexport function registerNcDashboardWidgets(widgets, options = {}) {\n\tconst dashboard = options.dashboard || (typeof window !== 'undefined' && window.OCA && window.OCA.Dashboard) || null\n\tif (!dashboard || typeof dashboard.register !== 'function' || !Array.isArray(widgets)) {\n\t\treturn []\n\t}\n\tconst appId = options.appId || 'nextcloud-vue'\n\tconst cnTranslate = (key, vars) => translate(appId, key, vars)\n\tconst registered = []\n\tfor (const widget of widgets) {\n\t\tif (!widget || typeof widget.id !== 'string' || widget.id === '') {\n\t\t\tcontinue\n\t\t}\n\t\tdashboard.register(widget.id, (el, context = {}) => {\n\t\t\tconst title = context.widget && context.widget.title ? context.widget.title : ''\n\t\t\tconst app = widget.component\n\t\t\t\t? createApp(widget.component, { ...(widget.props || {}), title })\n\t\t\t\t: createApp(CnNcDashboardList, { config: widget.config || {} })\n\t\t\tapp.provide('cnTranslate', cnTranslate)\n\t\t\tif (typeof options.setup === 'function') {\n\t\t\t\toptions.setup(app)\n\t\t\t}\n\t\t\tapp.mount(el)\n\t\t})\n\t\tregistered.push(widget.id)\n\t}\n\treturn registered\n}\n"],"names":["CnNcDashboardList"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE;AAClE,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAI;AACrH,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AACxF,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAe;AAC/C,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,IAAI,KAAK,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAC;AAC/D,CAAC,MAAM,UAAU,GAAG,GAAE;AACtB,CAAC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;AAC/B,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE;AACpE,GAAG,QAAQ;AACX,GAAG;AACH,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,KAAK;AACtD,GAAG,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,GAAE;AACnF,GAAG,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS;AAC/B,MAAM,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;AACrE,MAAM,SAAS,CAACA,UAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,EAAC;AACnE,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,EAAC;AAC1C,GAAG,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE;AAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,EAAC;AACtB,IAAI;AACJ,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAC;AAChB,GAAG,EAAC;AACJ,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAC;AAC5B,EAAE;AACF,CAAC,OAAO,UAAU;AAClB;;;;"}

package/dist/esm/utils/searchRefusal.js

@@ -0,0 +1,62 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * A refused search, said where it was typed. OpenRegister refuses a `_search`
+ * term it cannot parse (an unclosed bracket or quote) with `400 { error,
+ * position, term }` rather than running it as a literal, which would return
+ * nothing and read as an honest empty result.
+ *
+ * @module utils/searchRefusal
+ */
+
+/** `<reason> at position <n>.`, the shape OpenRegister builds the message in. */
+const POSITION_IN_MESSAGE = /\bat position (\d+)\.?\s*$/;
+
+/**
+ * The 1-based character a refusal points at, or null.
+ *
+ * @param {object} error The ApiError.
+ * @return {number|null}
+ */
+function positionOf(error) {
+	const carried = error.position ?? (error.details && typeof error.details === 'object' ? error.details.position : undefined);
+	if (Number.isInteger(carried) && carried > 0) {
+		return carried
+	}
+	const match = POSITION_IN_MESSAGE.exec(String(error.message || ''));
+	const parsed = match ? Number(match[1]) : 0;
+	return parsed > 0 ? parsed : null
+}
+
+/**
+ * A search refusal, or null when this failure is not one: not a 400, no term
+ * typed, or no position to point at (then it is a plain failed fetch).
+ *
+ * @spec openspec/changes/index-search-refusal/specs/index-search-refusal/spec.md#requirement-a-refused-search-is-said-where-it-was-typed
+ * @param {object|null} error The ApiError the store recorded.
+ * @param {string} term The term the user typed.
+ * @return {{message: string, position: number, term: string, before: string, at: string, after: string}|null}
+ */
+function readSearchRefusal(error, term) {
+	const typed = typeof term === 'string' ? term : '';
+	if (!error || typed.trim() === '' || Number(error.status) !== 400) {
+		return null
+	}
+	const position = positionOf(error);
+	if (position === null) {
+		return null
+	}
+	const index = Math.min(position - 1, typed.length);
+	return {
+		message: String(error.message || ''),
+		position,
+		term: typed,
+		before: typed.slice(0, index),
+		at: typed.slice(index, index + 1),
+		after: typed.slice(index + 1),
+	}
+}
+
+export { readSearchRefusal };
+//# sourceMappingURL=searchRefusal.js.map

package/dist/esm/utils/searchRefusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchRefusal.js","sources":["../../../src/utils/searchRefusal.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * A refused search, said where it was typed. OpenRegister refuses a `_search`\n * term it cannot parse (an unclosed bracket or quote) with `400 { error,\n * position, term }` rather than running it as a literal, which would return\n * nothing and read as an honest empty result.\n *\n * @module utils/searchRefusal\n */\n\n/** `<reason> at position <n>.`, the shape OpenRegister builds the message in. */\nconst POSITION_IN_MESSAGE = /\\bat position (\\d+)\\.?\\s*$/\n\n/**\n * The 1-based character a refusal points at, or null.\n *\n * @param {object} error The ApiError.\n * @return {number|null}\n */\nfunction positionOf(error) {\n\tconst carried = error.position ?? (error.details && typeof error.details === 'object' ? error.details.position : undefined)\n\tif (Number.isInteger(carried) && carried > 0) {\n\t\treturn carried\n\t}\n\tconst match = POSITION_IN_MESSAGE.exec(String(error.message || ''))\n\tconst parsed = match ? Number(match[1]) : 0\n\treturn parsed > 0 ? parsed : null\n}\n\n/**\n * A search refusal, or null when this failure is not one: not a 400, no term\n * typed, or no position to point at (then it is a plain failed fetch).\n *\n * @spec openspec/changes/index-search-refusal/specs/index-search-refusal/spec.md#requirement-a-refused-search-is-said-where-it-was-typed\n * @param {object|null} error The ApiError the store recorded.\n * @param {string} term The term the user typed.\n * @return {{message: string, position: number, term: string, before: string, at: string, after: string}|null}\n */\nexport function readSearchRefusal(error, term) {\n\tconst typed = typeof term === 'string' ? term : ''\n\tif (!error || typed.trim() === '' || Number(error.status) !== 400) {\n\t\treturn null\n\t}\n\tconst position = positionOf(error)\n\tif (position === null) {\n\t\treturn null\n\t}\n\tconst index = Math.min(position - 1, typed.length)\n\treturn {\n\t\tmessage: String(error.message || ''),\n\t\tposition,\n\t\tterm: typed,\n\t\tbefore: typed.slice(0, index),\n\t\tat: typed.slice(index, index + 1),\n\t\tafter: typed.slice(index + 1),\n\t}\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG,6BAA4B;AACxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,UAAU,CAAC,KAAK,EAAE;AAC3B,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,SAAS,EAAC;AAC5H,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE;AAC/C,EAAE,OAAO,OAAO;AAChB,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAC;AACpE,CAAC,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAC;AAC5C,CAAC,OAAO,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,IAAI;AAClC,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE;AAC/C,CAAC,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,GAAG,IAAI,GAAG,GAAE;AACnD,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE;AACpE,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,EAAC;AACnC,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE;AACxB,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,EAAC;AACnD,CAAC,OAAO;AACR,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;AACtC,EAAE,QAAQ;AACV,EAAE,IAAI,EAAE,KAAK;AACb,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;AAC/B,EAAE,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;AACnC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAC/B,EAAE;AACF;;;;"}