@conduction/nextcloud-vue 2.65.0 → 2.67.0

package/dist/esm/composables/useSetupStatus.js

@@ -1,4 +1,5 @@
 import { ref, computed } from 'vue';
+import { readServerAppStatuses, missingRequiredApps } from './useDependencyCheck.js';
 
 /**
  * SPDX-FileCopyrightText: 2026 Conduction B.V.
@@ -28,6 +29,14 @@ const cache = new Map();
  * every non-admin user of an app with a `setup` block met a wizard they had no
  * permission to complete instead of the app itself.
  *
+ * A step that declares `requires: [appId, ...]` is **not applicable** while any
+ * of those apps is not installed and enabled: it is neither met nor unmet, so
+ * it never lands in `requiredUnmet` or `optionalUnmet`. `CnSetupWizard` skips
+ * such a step, and counting it as unmet kept the wizard reopening (optional
+ * step) or gating the app (required step) for a step it would never show. App
+ * status is resolved exactly as the wizard does it: the `dependency_statuses`
+ * initial state first, then `useAppStatus`.
+ *
  * @param {string} appId Nextcloud app id (e.g. `"procest"`).
  * @param {object} manifest The app manifest (reads `manifest.setup`).
  * @return {{
@@ -36,6 +45,7 @@ const cache = new Map();
  *   requiredUnmet: import('vue').ComputedRef<Array<object>>,
  *   optionalUnmet: import('vue').ComputedRef<Array<object>>,
  *   optionalUnmetReported: import('vue').ComputedRef<Array<object>>,
+ *   notApplicable: import('vue').ComputedRef<Array<object>>,
  *   completed: import('vue').ComputedRef<boolean>,
  *   enabled: boolean,
  *   loading: import('vue').Ref<boolean>,
@@ -46,6 +56,7 @@ const cache = new Map();
  *
  * @example
  * const { requiredUnmet, completed, loading } = useSetupStatus('procest', manifest)
+ * @spec openspec/changes/optional-step-requires/specs/cn-setup-wizard/spec.md#requirement-a-step-whose-required-apps-are-absent-is-not-applicable
  */
 function useSetupStatus(appId, manifest) {
 	const setup = (manifest && manifest.setup) || {};
@@ -69,6 +80,9 @@ function useSetupStatus(appId, manifest) {
 		cache.set(appId, entry);
 	}
 	const { status, loading, error, forbidden } = entry;
+	// Same source the wizard's dependency gate reads. Initial state is fixed
+	// for the page lifetime, so one read per call is enough.
+	const serverAppStatuses = readServerAppStatuses(appId);
 
 	const steps = computed(() => stepDefs.map((s) => {
 		const bag = status.value.steps || {};
@@ -82,7 +96,12 @@ function useSetupStatus(appId, manifest) {
 		// that act on an unmet step — CnAppRoot auto-opening the non-gating
 		// wizard — must act only on steps the server actually reported, or an
 		// unknowable step parks the wizard over the app for ever.
-		return { ...s, done: st.done === true, reported, detail: st.detail }
+		//
+		// `applicable` is false when the step `requires` an app that is not
+		// installed and enabled. The wizard skips such a step, so it can never
+		// be done here; it is not applicable rather than unmet.
+		const missingApps = missingRequiredApps(s.requires, serverAppStatuses).map((row) => row.id);
+		return { ...s, done: st.done === true, reported, detail: st.detail, applicable: missingApps.length === 0, missingApps }
 	}));
 	// Presentational step types carry no work, so the server never reports a
 	// `done` flag for them. Counting them as "unmet" made `optionalUnmet`
@@ -90,7 +109,9 @@ function useSetupStatus(appId, manifest) {
 	// which kept CnAppRoot's non-gating setup wizard auto-opening over the
 	// app on every fresh browser profile no matter how complete setup was.
 	// Only actionable steps can be unmet.
-	const isActionable = (s) => s.type !== 'info' && s.type !== 'summary';
+	// A step whose required apps are absent is skipped by the wizard, so it
+	// is neither met nor unmet (see `applicable` above).
+	const isActionable = (s) => s.type !== 'info' && s.type !== 'summary' && s.applicable !== false;
 	// `forbidden` empties BOTH lists, and that is what actually suppresses the
 	// wizard: CnAppRoot gates on `requiredUnmet.length > 0` (blocking) and on
 	// `requiredUnmet.length === 0 && optionalUnmet.length > 0` (auto-open) —
@@ -111,6 +132,8 @@ function useSetupStatus(appId, manifest) {
 	// suppressing it is what left dossiq's `seed` step (and with it the app's
 	// only demo-data affordance) permanently unreachable.
 	const optionalUnmetReported = computed(() => optionalUnmet.value.filter((s) => s.reported === true));
+	// Steps the wizard skips because an app in their `requires` is absent.
+	const notApplicable = computed(() => steps.value.filter((s) => s.applicable === false));
 	const completed = computed(() => {
 		if (!enabled) {
 			return true
@@ -171,7 +194,7 @@ function useSetupStatus(appId, manifest) {
 		refresh();
 	}
 
-	return { steps, status, requiredUnmet, optionalUnmet, optionalUnmetReported, completed, enabled, loading, error, forbidden, refresh }
+	return { steps, status, requiredUnmet, optionalUnmet, optionalUnmetReported, notApplicable, completed, enabled, loading, error, forbidden, refresh }
 }
 
 export { useSetupStatus };

package/dist/esm/composables/useSetupStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSetupStatus.js","sources":["../../../src/composables/useSetupStatus.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\nimport { computed, ref } from 'vue'\n\n/**\n * Per-`appId` cache of setup-status results. The Vue refs are stored so all\n * consumers of the same app share one fetch + reactive state for the page\n * lifetime (mirrors useAppStatus).\n */\nconst cache = new Map()\n\n/**\n * Composable that reports an app's first-time-setup status (ADR-042).\n *\n * Fetches `GET /apps/{appId}/api/setup/status` → `{ version, completed, steps:\n * { <id>: { done, detail } } }`, then cross-references the manifest's\n * `setup.steps[].required` flags so `CnAppRoot` can gate on required-unmet and\n * the wizard can drive itself. On error it falls back to \"nothing done\" so a\n * failed lookup never crashes the shell — the wizard simply shows the steps.\n *\n * One error is treated as an answer rather than a failure: a **401/403** means\n * the caller may not read setup state (setup endpoints are admin-only), so\n * `completed` reports `true` and the wizard stays out of the way. Without that,\n * every non-admin user of an app with a `setup` block met a wizard they had no\n * permission to complete instead of the app itself.\n *\n * @param {string} appId Nextcloud app id (e.g. `\"procest\"`).\n * @param {object} manifest The app manifest (reads `manifest.setup`).\n * @return {{\n *   steps: import('vue').ComputedRef<Array<object>>,\n *   status: import('vue').Ref<object>,\n *   requiredUnmet: import('vue').ComputedRef<Array<object>>,\n *   optionalUnmet: import('vue').ComputedRef<Array<object>>,\n *   optionalUnmetReported: import('vue').ComputedRef<Array<object>>,\n *   completed: import('vue').ComputedRef<boolean>,\n *   enabled: boolean,\n *   loading: import('vue').Ref<boolean>,\n *   error: import('vue').Ref<Error|null>,\n *   forbidden: import('vue').Ref<boolean>,\n *   refresh: () => Promise<void>\n * }}\n *\n * @example\n * const { requiredUnmet, completed, loading } = useSetupStatus('procest', manifest)\n */\nexport function useSetupStatus(appId, manifest) {\n\tconst setup = (manifest && manifest.setup) || {}\n\tconst enabled = setup.enabled !== false && Array.isArray(setup.steps) && setup.steps.length > 0\n\tconst stepDefs = Array.isArray(setup.steps) ? setup.steps : []\n\tconst requiredById = Object.create(null)\n\tfor (const s of stepDefs) {\n\t\trequiredById[s.id] = s.required === true\n\t}\n\n\tlet entry = cache.get(appId)\n\tif (!entry) {\n\t\tentry = {\n\t\t\tstatus: ref({ version: null, completed: false, steps: {} }),\n\t\t\tloading: ref(enabled),\n\t\t\terror: ref(null),\n\t\t\t// Set when the server answers 401/403 — see `completed` below.\n\t\t\tforbidden: ref(false),\n\t\t\tfetched: false,\n\t\t}\n\t\tcache.set(appId, entry)\n\t}\n\tconst { status, loading, error, forbidden } = entry\n\n\tconst steps = computed(() => stepDefs.map((s) => {\n\t\tconst bag = status.value.steps || {}\n\t\tconst reported = Object.hasOwn(bag, s.id)\n\t\tconst st = bag[s.id] || {}\n\t\t// `reported` separates \"the server says this step is NOT done\" from \"the\n\t\t// server never mentioned this step at all\". Both used to flatten into\n\t\t// `done: false`, and that conflation is load-bearing: a manifest may\n\t\t// declare an optional step its SetupController has no status key for\n\t\t// (pipelinq's `demo-data`), which is UNKNOWN, not outstanding. Callers\n\t\t// that act on an unmet step — CnAppRoot auto-opening the non-gating\n\t\t// wizard — must act only on steps the server actually reported, or an\n\t\t// unknowable step parks the wizard over the app for ever.\n\t\treturn { ...s, done: st.done === true, reported, detail: st.detail }\n\t}))\n\t// Presentational step types carry no work, so the server never reports a\n\t// `done` flag for them. Counting them as \"unmet\" made `optionalUnmet`\n\t// permanently non-empty for any manifest with a welcome/summary step,\n\t// which kept CnAppRoot's non-gating setup wizard auto-opening over the\n\t// app on every fresh browser profile no matter how complete setup was.\n\t// Only actionable steps can be unmet.\n\tconst isActionable = (s) => s.type !== 'info' && s.type !== 'summary'\n\t// `forbidden` empties BOTH lists, and that is what actually suppresses the\n\t// wizard: CnAppRoot gates on `requiredUnmet.length > 0` (blocking) and on\n\t// `requiredUnmet.length === 0 && optionalUnmet.length > 0` (auto-open) —\n\t// it never reads `completed`. A caller who may not READ setup state has no\n\t// unmet setup work *of their own*, so reporting steps as unmet to them\n\t// described work they could neither see nor do.\n\tconst requiredUnmet = computed(() => (forbidden.value === true\n\t\t? []\n\t\t: steps.value.filter((s) => isActionable(s) && requiredById[s.id] && !s.done)))\n\tconst optionalUnmet = computed(() => (forbidden.value === true\n\t\t? []\n\t\t: steps.value.filter((s) => isActionable(s) && !requiredById[s.id] && !s.done)))\n\t// The subset of `optionalUnmet` the server positively reported as not done.\n\t// This — not `optionalUnmet` — is what may auto-open the non-gating wizard:\n\t// a step with no status key is unknown, and prompting on unknown is what\n\t// parked the wizard over pipelinq on every fresh browser profile. A step\n\t// the server DID report as `{done: false}` is genuinely outstanding, and\n\t// suppressing it is what left dossiq's `seed` step (and with it the app's\n\t// only demo-data affordance) permanently unreachable.\n\tconst optionalUnmetReported = computed(() => optionalUnmet.value.filter((s) => s.reported === true))\n\tconst completed = computed(() => {\n\t\tif (!enabled) {\n\t\t\treturn true\n\t\t}\n\t\t// A 401/403 means the caller may not READ setup state — first-time setup\n\t\t// is admin-only. That is not \"setup is unfinished\"; it is \"not this\n\t\t// user's concern\". Reporting incomplete here put every non-admin in\n\t\t// front of a setup wizard they cannot complete, INSTEAD of the app:\n\t\t// `/api/setup/status` answers 200 {completed:true} to an admin and 403\n\t\t// to everyone else, and the generic error path below then left status at\n\t\t// its \"nothing done\" default. Measured on openbuild, where it made the\n\t\t// app unusable for every non-admin as soon as they could see it at all.\n\t\tif (forbidden.value === true) {\n\t\t\treturn true\n\t\t}\n\t\t// Authoritative server flag, but never report complete while a required\n\t\t// step is still unmet (defends against a stale completion flag).\n\t\treturn status.value.completed === true && requiredUnmet.value.length === 0\n\t})\n\n\t/**\n\t * (Re)fetch the setup status from the server.\n\t *\n\t * @return {Promise<void>}\n\t */\n\tasync function refresh() {\n\t\tif (!enabled) {\n\t\t\tloading.value = false\n\t\t\tentry.fetched = true\n\t\t\treturn\n\t\t}\n\t\tloading.value = true\n\t\terror.value = null\n\t\ttry {\n\t\t\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\t\t\timport('@nextcloud/axios'),\n\t\t\t\timport('@nextcloud/router'),\n\t\t\t])\n\t\t\tconst { data } = await axios.get(generateUrl(`/apps/${appId}/api/setup/status`))\n\t\t\tstatus.value = (data && typeof data === 'object') ? data : { steps: {} }\n\t\t\tforbidden.value = false\n\t\t} catch (err) {\n\t\t\terror.value = err\n\t\t\t// 401/403 is a DIFFERENT outcome from a failed lookup: the server\n\t\t\t// answered, and its answer was \"you may not see this\". Setup is\n\t\t\t// admin-only, so for everyone else it is settled, not unknown.\n\t\t\t// Anything else (network error, 500) stays unknown and falls back to\n\t\t\t// \"nothing done\" so the wizard is still reachable for an admin.\n\t\t\tconst httpStatus = err && err.response && err.response.status\n\t\t\tforbidden.value = (httpStatus === 401 || httpStatus === 403)\n\t\t} finally {\n\t\t\tloading.value = false\n\t\t\tentry.fetched = true\n\t\t}\n\t}\n\n\tif (!entry.fetched) {\n\t\trefresh()\n\t}\n\n\treturn { steps, status, requiredUnmet, optionalUnmet, optionalUnmetReported, completed, enabled, loading, error, forbidden, refresh }\n}\n\n/**\n * Test-only helper to reset the per-`appId` cache.\n *\n * @internal\n */\nexport function __resetSetupStatusCacheForTests() {\n\tcache.clear()\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"useSetupStatus.js","sources":["../../../src/composables/useSetupStatus.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\nimport { computed, ref } from 'vue'\nimport { missingRequiredApps, readServerAppStatuses } from './useDependencyCheck.js'\n\n/**\n * Per-`appId` cache of setup-status results. The Vue refs are stored so all\n * consumers of the same app share one fetch + reactive state for the page\n * lifetime (mirrors useAppStatus).\n */\nconst cache = new Map()\n\n/**\n * Composable that reports an app's first-time-setup status (ADR-042).\n *\n * Fetches `GET /apps/{appId}/api/setup/status` → `{ version, completed, steps:\n * { <id>: { done, detail } } }`, then cross-references the manifest's\n * `setup.steps[].required` flags so `CnAppRoot` can gate on required-unmet and\n * the wizard can drive itself. On error it falls back to \"nothing done\" so a\n * failed lookup never crashes the shell — the wizard simply shows the steps.\n *\n * One error is treated as an answer rather than a failure: a **401/403** means\n * the caller may not read setup state (setup endpoints are admin-only), so\n * `completed` reports `true` and the wizard stays out of the way. Without that,\n * every non-admin user of an app with a `setup` block met a wizard they had no\n * permission to complete instead of the app itself.\n *\n * A step that declares `requires: [appId, ...]` is **not applicable** while any\n * of those apps is not installed and enabled: it is neither met nor unmet, so\n * it never lands in `requiredUnmet` or `optionalUnmet`. `CnSetupWizard` skips\n * such a step, and counting it as unmet kept the wizard reopening (optional\n * step) or gating the app (required step) for a step it would never show. App\n * status is resolved exactly as the wizard does it: the `dependency_statuses`\n * initial state first, then `useAppStatus`.\n *\n * @param {string} appId Nextcloud app id (e.g. `\"procest\"`).\n * @param {object} manifest The app manifest (reads `manifest.setup`).\n * @return {{\n *   steps: import('vue').ComputedRef<Array<object>>,\n *   status: import('vue').Ref<object>,\n *   requiredUnmet: import('vue').ComputedRef<Array<object>>,\n *   optionalUnmet: import('vue').ComputedRef<Array<object>>,\n *   optionalUnmetReported: import('vue').ComputedRef<Array<object>>,\n *   notApplicable: import('vue').ComputedRef<Array<object>>,\n *   completed: import('vue').ComputedRef<boolean>,\n *   enabled: boolean,\n *   loading: import('vue').Ref<boolean>,\n *   error: import('vue').Ref<Error|null>,\n *   forbidden: import('vue').Ref<boolean>,\n *   refresh: () => Promise<void>\n * }}\n *\n * @example\n * const { requiredUnmet, completed, loading } = useSetupStatus('procest', manifest)\n * @spec openspec/changes/optional-step-requires/specs/cn-setup-wizard/spec.md#requirement-a-step-whose-required-apps-are-absent-is-not-applicable\n */\nexport function useSetupStatus(appId, manifest) {\n\tconst setup = (manifest && manifest.setup) || {}\n\tconst enabled = setup.enabled !== false && Array.isArray(setup.steps) && setup.steps.length > 0\n\tconst stepDefs = Array.isArray(setup.steps) ? setup.steps : []\n\tconst requiredById = Object.create(null)\n\tfor (const s of stepDefs) {\n\t\trequiredById[s.id] = s.required === true\n\t}\n\n\tlet entry = cache.get(appId)\n\tif (!entry) {\n\t\tentry = {\n\t\t\tstatus: ref({ version: null, completed: false, steps: {} }),\n\t\t\tloading: ref(enabled),\n\t\t\terror: ref(null),\n\t\t\t// Set when the server answers 401/403 — see `completed` below.\n\t\t\tforbidden: ref(false),\n\t\t\tfetched: false,\n\t\t}\n\t\tcache.set(appId, entry)\n\t}\n\tconst { status, loading, error, forbidden } = entry\n\t// Same source the wizard's dependency gate reads. Initial state is fixed\n\t// for the page lifetime, so one read per call is enough.\n\tconst serverAppStatuses = readServerAppStatuses(appId)\n\n\tconst steps = computed(() => stepDefs.map((s) => {\n\t\tconst bag = status.value.steps || {}\n\t\tconst reported = Object.hasOwn(bag, s.id)\n\t\tconst st = bag[s.id] || {}\n\t\t// `reported` separates \"the server says this step is NOT done\" from \"the\n\t\t// server never mentioned this step at all\". Both used to flatten into\n\t\t// `done: false`, and that conflation is load-bearing: a manifest may\n\t\t// declare an optional step its SetupController has no status key for\n\t\t// (pipelinq's `demo-data`), which is UNKNOWN, not outstanding. Callers\n\t\t// that act on an unmet step — CnAppRoot auto-opening the non-gating\n\t\t// wizard — must act only on steps the server actually reported, or an\n\t\t// unknowable step parks the wizard over the app for ever.\n\t\t//\n\t\t// `applicable` is false when the step `requires` an app that is not\n\t\t// installed and enabled. The wizard skips such a step, so it can never\n\t\t// be done here; it is not applicable rather than unmet.\n\t\tconst missingApps = missingRequiredApps(s.requires, serverAppStatuses).map((row) => row.id)\n\t\treturn { ...s, done: st.done === true, reported, detail: st.detail, applicable: missingApps.length === 0, missingApps }\n\t}))\n\t// Presentational step types carry no work, so the server never reports a\n\t// `done` flag for them. Counting them as \"unmet\" made `optionalUnmet`\n\t// permanently non-empty for any manifest with a welcome/summary step,\n\t// which kept CnAppRoot's non-gating setup wizard auto-opening over the\n\t// app on every fresh browser profile no matter how complete setup was.\n\t// Only actionable steps can be unmet.\n\t// A step whose required apps are absent is skipped by the wizard, so it\n\t// is neither met nor unmet (see `applicable` above).\n\tconst isActionable = (s) => s.type !== 'info' && s.type !== 'summary' && s.applicable !== false\n\t// `forbidden` empties BOTH lists, and that is what actually suppresses the\n\t// wizard: CnAppRoot gates on `requiredUnmet.length > 0` (blocking) and on\n\t// `requiredUnmet.length === 0 && optionalUnmet.length > 0` (auto-open) —\n\t// it never reads `completed`. A caller who may not READ setup state has no\n\t// unmet setup work *of their own*, so reporting steps as unmet to them\n\t// described work they could neither see nor do.\n\tconst requiredUnmet = computed(() => (forbidden.value === true\n\t\t? []\n\t\t: steps.value.filter((s) => isActionable(s) && requiredById[s.id] && !s.done)))\n\tconst optionalUnmet = computed(() => (forbidden.value === true\n\t\t? []\n\t\t: steps.value.filter((s) => isActionable(s) && !requiredById[s.id] && !s.done)))\n\t// The subset of `optionalUnmet` the server positively reported as not done.\n\t// This — not `optionalUnmet` — is what may auto-open the non-gating wizard:\n\t// a step with no status key is unknown, and prompting on unknown is what\n\t// parked the wizard over pipelinq on every fresh browser profile. A step\n\t// the server DID report as `{done: false}` is genuinely outstanding, and\n\t// suppressing it is what left dossiq's `seed` step (and with it the app's\n\t// only demo-data affordance) permanently unreachable.\n\tconst optionalUnmetReported = computed(() => optionalUnmet.value.filter((s) => s.reported === true))\n\t// Steps the wizard skips because an app in their `requires` is absent.\n\tconst notApplicable = computed(() => steps.value.filter((s) => s.applicable === false))\n\tconst completed = computed(() => {\n\t\tif (!enabled) {\n\t\t\treturn true\n\t\t}\n\t\t// A 401/403 means the caller may not READ setup state — first-time setup\n\t\t// is admin-only. That is not \"setup is unfinished\"; it is \"not this\n\t\t// user's concern\". Reporting incomplete here put every non-admin in\n\t\t// front of a setup wizard they cannot complete, INSTEAD of the app:\n\t\t// `/api/setup/status` answers 200 {completed:true} to an admin and 403\n\t\t// to everyone else, and the generic error path below then left status at\n\t\t// its \"nothing done\" default. Measured on openbuild, where it made the\n\t\t// app unusable for every non-admin as soon as they could see it at all.\n\t\tif (forbidden.value === true) {\n\t\t\treturn true\n\t\t}\n\t\t// Authoritative server flag, but never report complete while a required\n\t\t// step is still unmet (defends against a stale completion flag).\n\t\treturn status.value.completed === true && requiredUnmet.value.length === 0\n\t})\n\n\t/**\n\t * (Re)fetch the setup status from the server.\n\t *\n\t * @return {Promise<void>}\n\t */\n\tasync function refresh() {\n\t\tif (!enabled) {\n\t\t\tloading.value = false\n\t\t\tentry.fetched = true\n\t\t\treturn\n\t\t}\n\t\tloading.value = true\n\t\terror.value = null\n\t\ttry {\n\t\t\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\t\t\timport('@nextcloud/axios'),\n\t\t\t\timport('@nextcloud/router'),\n\t\t\t])\n\t\t\tconst { data } = await axios.get(generateUrl(`/apps/${appId}/api/setup/status`))\n\t\t\tstatus.value = (data && typeof data === 'object') ? data : { steps: {} }\n\t\t\tforbidden.value = false\n\t\t} catch (err) {\n\t\t\terror.value = err\n\t\t\t// 401/403 is a DIFFERENT outcome from a failed lookup: the server\n\t\t\t// answered, and its answer was \"you may not see this\". Setup is\n\t\t\t// admin-only, so for everyone else it is settled, not unknown.\n\t\t\t// Anything else (network error, 500) stays unknown and falls back to\n\t\t\t// \"nothing done\" so the wizard is still reachable for an admin.\n\t\t\tconst httpStatus = err && err.response && err.response.status\n\t\t\tforbidden.value = (httpStatus === 401 || httpStatus === 403)\n\t\t} finally {\n\t\t\tloading.value = false\n\t\t\tentry.fetched = true\n\t\t}\n\t}\n\n\tif (!entry.fetched) {\n\t\trefresh()\n\t}\n\n\treturn { steps, status, requiredUnmet, optionalUnmet, optionalUnmetReported, notApplicable, completed, enabled, loading, error, forbidden, refresh }\n}\n\n/**\n * Test-only helper to reset the per-`appId` cache.\n *\n * @internal\n */\nexport function __resetSetupStatusCacheForTests() {\n\tcache.clear()\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/l10n/en.json.js

@@ -1,4 +1,5 @@
 var translations = {
+	Advanced: "Advanced",
 	"The item could not be created.": "The item could not be created.",
 	"Start over": "Start over",
 	"Continue where you left off": "Continue where you left off",
@@ -48,6 +49,7 @@ var translations = {
 	"This integration is not available.": "This integration is not available.",
 	Integrations: "Integrations",
 	View: "View",
+	Views: "Views",
 	"current step": "current step",
 	"{app} not available": "{app} not available",
 	"{app} not configured": "{app} not configured",
@@ -404,6 +406,7 @@ var translations = {
 	Any: "Any",
 	To: "To",
 	Equals: "Equals",
+	Contains: "Contains",
 	Clear: "Clear",
 	Apply: "Apply",
 	"This column cannot list its objects.": "This column cannot list its objects.",
@@ -1072,6 +1075,7 @@ var translations = {
 	"The actions of an attention card are declared in the manifest.": "The actions of an attention card are declared in the manifest.",
 	"An attention card needs a title": "An attention card needs a title",
 	"Good morning, {name}": "Good morning, {name}",
+	"This view has no widgets yet.": "This view has no widgets yet.",
 	"Good morning": "Good morning",
 	"Good afternoon, {name}": "Good afternoon, {name}",
 	"Good afternoon": "Good afternoon",
@@ -1081,7 +1085,9 @@ var translations = {
 	"Show the date of today above the heading": "Show the date of today above the heading",
 	"Plain header without a coloured background": "Plain header without a coloured background",
 	"Loading…": "Loading…",
-	"A register and schema are required": "A register and schema are required"
+	"A register and schema are required": "A register and schema are required",
+	"Change the search or try again.": "Change the search or try again.",
+	"Try again later.": "Try again later."
 };
 var plurals = {
 	"%n year": [

package/dist/esm/l10n/en.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"en.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"en.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/l10n/nl.json.js

@@ -1,4 +1,5 @@
 var translations = {
+	Advanced: "Geavanceerd",
 	"The item could not be created.": "Het item kon niet worden aangemaakt.",
 	"Start over": "Opnieuw beginnen",
 	"Continue where you left off": "Ga verder waar je was",
@@ -48,6 +49,7 @@ var translations = {
 	"This integration is not available.": "Deze integratie is niet beschikbaar.",
 	Integrations: "Integraties",
 	View: "Bekijken",
+	Views: "Weergaven",
 	"current step": "huidige stap",
 	"{app} not available": "{app} niet beschikbaar",
 	"{app} not configured": "{app} niet geconfigureerd",
@@ -404,6 +406,7 @@ var translations = {
 	Any: "Alle",
 	To: "Tot",
 	Equals: "Is gelijk aan",
+	Contains: "Bevat",
 	Clear: "Wissen",
 	Apply: "Toepassen",
 	"This column cannot list its objects.": "Deze kolom kan zijn objecten niet tonen.",
@@ -1124,6 +1127,7 @@ var translations = {
 	"The actions of an attention card are declared in the manifest.": "De acties van een aandachtskaart staan in het manifest.",
 	"An attention card needs a title": "Een aandachtskaart heeft een titel nodig",
 	"Good morning, {name}": "Goedemorgen, {name}",
+	"This view has no widgets yet.": "Deze weergave heeft nog geen widgets.",
 	"Good morning": "Goedemorgen",
 	"Good afternoon, {name}": "Goedemiddag, {name}",
 	"Good afternoon": "Goedemiddag",
@@ -1133,7 +1137,9 @@ var translations = {
 	"Show the date of today above the heading": "Toon de datum van vandaag boven de kop",
 	"Plain header without a coloured background": "Eenvoudige kop zonder gekleurde achtergrond",
 	"Loading…": "Laden…",
-	"A register and schema are required": "Een register en schema zijn verplicht"
+	"A register and schema are required": "Een register en schema zijn verplicht",
+	"Change the search or try again.": "Pas de zoekopdracht aan of probeer het opnieuw.",
+	"Try again later.": "Probeer het later opnieuw."
 };
 var plurals = {
 	"%n year": [

package/dist/esm/l10n/nl.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"nl.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"nl.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/mixins/pageViews.js

@@ -0,0 +1,400 @@
+import { translate } from '@nextcloud/l10n';
+import { readUserPreference, writeUserPreference, USER_PREFERENCE_STORAGE_PREFIX } from '../composables/useUserPreferences.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Page views: a few views of one page, each its own widget grid, behind one
+ * segmented control ("My work | My team").
+ *
+ * A page that mixes this in accepts `views` (each `{ id, label, icon?,
+ * widgets, layout, emptyText? }`), `defaultView` and `viewsLabel`. It keeps
+ * the chosen view, writes it to the address (`?view=<id>`) and to the
+ * user's preferences (the server, mirrored in the browser), and provides `cnPageViews` so a greeting header widget on
+ * the page can draw the switch instead of the page.
+ *
+ * Which view opens: the address, then the stored view, then `defaultView`,
+ * then the first view. An id that names no view is ignored at every step.
+ *
+ * Used by CnDashboardPage and CnDetailPage. Each renders the chosen view's
+ * `layout` with its own grid, so a view looks exactly like the page's own
+ * grid.
+ *
+ * @mixin pageViews
+ * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-a-page-declares-views-that-each-hold-a-widget-grid
+ */
+
+/** The query parameter that carries the chosen view. */
+const PAGE_VIEW_QUERY_KEY = 'view';
+
+/** Prefix of the user-preference key; the page id follows it. */
+const PAGE_VIEW_PREFERENCE_PREFIX = 'cn_page_view:';
+
+let regionSeq = 0;
+
+/**
+ * Read the browser mirror of a user preference synchronously, so the stored
+ * view is on screen from the first frame. Errors read as nothing stored.
+ *
+ * @param {string} appId The app id.
+ * @param {string} key The preference key.
+ * @return {string|null} The stored id, or null.
+ * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-the-chosen-view-is-linkable-and-remembered
+ */
+function readStoredViewMirror(appId, key) {
+	try {
+		if (typeof localStorage === 'undefined') {
+			return null
+		}
+		const raw = localStorage.getItem(`${USER_PREFERENCE_STORAGE_PREFIX}${appId}:${key}`);
+		if (raw === null || raw === undefined) {
+			return null
+		}
+		const value = JSON.parse(raw);
+		return typeof value === 'string' && value !== '' ? value : null
+	} catch {
+		return null
+	}
+}
+
+const pageViews = {
+	inject: {
+		/** The host app id, provided by CnAppRoot; keys the stored view. */
+		cnPageViewsAppId: { from: 'cnAppId', default: '' },
+	},
+
+	props: {
+		/**
+		 * Views of this page, each its own widget grid behind one segmented
+		 * control. Each is `{ id, label, icon?, widgets, layout, emptyText? }`:
+		 * `widgets` and `layout` have the same shape as the page's own. The
+		 * chosen view renders in a region below the page's own grid. Empty
+		 * (the default) draws no switch and no region.
+		 *
+		 * @type {Array<{id: string, label: string, icon?: string, widgets?: Array<object>, layout?: Array<object>, emptyText?: string}>}
+		 */
+		views: {
+			type: Array,
+			default: () => [],
+		},
+
+		/**
+		 * The id of the view chosen when neither the address nor the browser
+		 * store names one. Empty chooses the first view.
+		 *
+		 * @type {string}
+		 */
+		defaultView: {
+			type: String,
+			default: '',
+		},
+
+		/**
+		 * Accessible name of the view switch (through the host translate
+		 * function). Empty reads "View".
+		 *
+		 * @type {string}
+		 */
+		viewsLabel: {
+			type: String,
+			default: '',
+		},
+	},
+
+	data() {
+		regionSeq += 1;
+		return {
+			/** The view the user chose in this session, or the stored one. */
+			selectedViewId: null,
+			/** Whether the user chose a view in this session (a late server read then leaves it alone). */
+			viewChosen: false,
+			/** Id of the view region, the target of the options' `aria-controls`. */
+			viewRegionId: `cn-page-view-region-${regionSeq}`,
+		}
+	},
+
+	/**
+	 * Provide the views to descendants, so a greeting header widget in the
+	 * page's grid can draw the switch. Getters keep it reactive.
+	 *
+	 * @return {object} The provided `cnPageViews`.
+	 */
+	provide() {
+		const vm = this;
+		return {
+			cnPageViews: {
+				get views() { return vm.normalizedViews },
+				get activeId() { return vm.activeViewId },
+				get regionId() { return vm.viewRegionId },
+				select: (id) => vm.selectView(id),
+			},
+		}
+	},
+
+	computed: {
+		/**
+		 * The declared views in one shape, labels translated. Entries without
+		 * an id or a label are dropped, as are repeated ids.
+		 *
+		 * @return {Array<{id: string, label: string, icon: string, widgets: Array<object>, layout: Array<object>, emptyText: string}>}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-a-page-declares-views-that-each-hold-a-widget-grid
+		 */
+		normalizedViews() {
+			const translate = typeof this.cnTranslate === 'function' ? this.cnTranslate : (key) => key;
+			const seen = new Set();
+			return (Array.isArray(this.views) ? this.views : [])
+				.filter((view) => {
+					if (!view || typeof view !== 'object' || view.id === undefined || view.id === null || view.id === '') {
+						return false
+					}
+					if (typeof view.label !== 'string' || view.label === '' || seen.has(String(view.id))) {
+						return false
+					}
+					seen.add(String(view.id));
+					return true
+				})
+				.map((view) => ({
+					id: String(view.id),
+					label: translate(view.label),
+					icon: typeof view.icon === 'string' ? view.icon : '',
+					widgets: Array.isArray(view.widgets) ? view.widgets : [],
+					layout: Array.isArray(view.layout) ? view.layout : [],
+					emptyText: typeof view.emptyText === 'string' && view.emptyText !== '' ? translate(view.emptyText) : '',
+				}))
+		},
+
+		/**
+		 * Whether this page has views.
+		 *
+		 * @return {boolean}
+		 */
+		hasViews() {
+			return this.normalizedViews.length > 0
+		},
+
+		/**
+		 * The chosen view's id: the address, then this session's or the
+		 * stored choice, then `defaultView`, then the first view.
+		 *
+		 * @return {string|null} The id, or null without views.
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-the-chosen-view-is-linkable-and-remembered
+		 */
+		activeViewId() {
+			const views = this.normalizedViews;
+			if (views.length === 0) {
+				return null
+			}
+			const known = (id) => id !== null && id !== undefined && views.some((view) => view.id === String(id));
+			const fromAddress = this.$route && this.$route.query ? this.$route.query[PAGE_VIEW_QUERY_KEY] : undefined;
+			if (known(fromAddress)) {
+				return String(fromAddress)
+			}
+			if (known(this.selectedViewId)) {
+				return String(this.selectedViewId)
+			}
+			if (known(this.defaultView)) {
+				return this.defaultView
+			}
+			return views[0].id
+		},
+
+		/**
+		 * The chosen view, or null without views.
+		 *
+		 * @return {object|null}
+		 */
+		activeView() {
+			return this.normalizedViews.find((view) => view.id === this.activeViewId) || null
+		},
+
+		/**
+		 * The switch's options, for CnSegmentedControl.
+		 *
+		 * @return {Array<{value: string, label: string}>}
+		 */
+		viewSwitchOptions() {
+			return this.normalizedViews.map((view) => ({ value: view.id, label: view.label }))
+		},
+
+		/**
+		 * The switch's accessible name: `viewsLabel` translated, else "View".
+		 *
+		 * @return {string}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-the-view-switch-is-accessible
+		 */
+		viewSwitchLabel() {
+			const translate$1 = typeof this.cnTranslate === 'function' ? this.cnTranslate : (key) => key;
+			return this.viewsLabel ? translate$1(this.viewsLabel) : translate('nextcloud-vue', 'Views')
+		},
+
+		/**
+		 * Whether a greeting header in the page's own widgets draws the
+		 * switch (an option with a `view`), so the page draws none.
+		 *
+		 * @return {boolean}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-a-greeting-header-can-switch-the-pages-views
+		 */
+		viewSwitchInHeaderWidget() {
+			const widgets = Array.isArray(this.widgets) ? this.widgets : [];
+			return widgets.some((def) => {
+				const options = def && def.content && def.content.views && def.content.views.options;
+				return Array.isArray(options) && options.some((option) => option && typeof option.view === 'string' && option.view !== '')
+			})
+		},
+
+		/**
+		 * Whether the page draws the switch itself.
+		 *
+		 * @return {boolean}
+		 */
+		showsPageViewSwitch() {
+			return this.hasViews && !this.viewSwitchInHeaderWidget
+		},
+
+		/**
+		 * The user-preference key for this page's chosen view.
+		 *
+		 * @return {string}
+		 */
+		viewPreferenceKey() {
+			// The page id, else the route name: a detail page's fallback id is
+			// its record's title, which would remember a view per record.
+			const id = this.pageId || (this.$route && this.$route.name) || this.resolvedPageId || 'page';
+			return `${PAGE_VIEW_PREFERENCE_PREFIX}${id}`
+		},
+
+		/**
+		 * The app id the stored view is kept under: the page's `appId` prop
+		 * when it has one, else the app root's.
+		 *
+		 * @return {string}
+		 */
+		viewPreferenceAppId() {
+			const own = typeof this.appId === 'string' ? this.appId : '';
+			return own || (typeof this.cnPageViewsAppId === 'string' ? this.cnPageViewsAppId : '')
+		},
+
+		/**
+		 * The message of the chosen view's empty state.
+		 *
+		 * @return {string}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-a-view-with-nothing-to-draw-says-so
+		 */
+		viewEmptyText() {
+			if (this.activeView && this.activeView.emptyText) {
+				return this.activeView.emptyText
+			}
+			return translate('nextcloud-vue', 'This view has no widgets yet.')
+		},
+	},
+
+	created() {
+		this.loadStoredView();
+	},
+
+	methods: {
+		/**
+		 * Read the stored view: the browser mirror at once, then the user
+		 * preference on the server, which wins unless the user already chose.
+		 *
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-the-chosen-view-is-linkable-and-remembered
+		 */
+		async loadStoredView() {
+			if (!this.hasViews) {
+				return
+			}
+			const appId = this.viewPreferenceAppId;
+			const key = this.viewPreferenceKey;
+			this.selectedViewId = readStoredViewMirror(appId, key);
+			if (!appId) {
+				return
+			}
+			const stored = await readUserPreference(appId, key, null);
+			if (!this.viewChosen && typeof stored === 'string' && stored !== '') {
+				this.selectedViewId = stored;
+			}
+		},
+
+		/**
+		 * Choose a view: keep it, store it, and write it to the address
+		 * (replacing the history entry, keeping the other query keys).
+		 *
+		 * @param {string} id The view id.
+		 * @return {void}
+		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-the-chosen-view-is-linkable-and-remembered
+		 */
+		selectView(id) {
+			const view = this.normalizedViews.find((candidate) => candidate.id === String(id));
+			if (!view) {
+				return
+			}
+			this.selectedViewId = view.id;
+			this.viewChosen = true;
+			writeUserPreference(this.viewPreferenceAppId, this.viewPreferenceKey, view.id);
+			if (!this.$router || !this.$route) {
+				return
+			}
+			const query = this.$route.query || {};
+			if (query[PAGE_VIEW_QUERY_KEY] === view.id) {
+				return
+			}
+			const result = this.$router.replace({ query: { ...query, [PAGE_VIEW_QUERY_KEY]: view.id } });
+			if (result && typeof result.catch === 'function') {
+				result.catch(() => {});
+			}
+		},
+
+		/**
+		 * Look a widget definition up in the views, for a layout item of the
+		 * chosen view.
+		 *
+		 * @param {string} widgetId The widget id.
+		 * @return {object|null} The definition, or null.
+		 */
+		findViewWidget(widgetId) {
+			const view = this.activeView;
+			if (!view) {
+				return null
+			}
+			return view.widgets.find((def) => def && def.id === widgetId) || null
+		},
+
+		/**
+		 * Write a drag or resize in the chosen view's grid back onto its
+		 * layout items in place, as the page does for its own layout, so the
+		 * in-app manifest editor sees it.
+		 *
+		 * @param {Array<object>} updated The layout from the grid.
+		 * @return {void}
+		 */
+		onViewLayoutChange(updated) {
+			const view = this.activeView;
+			if (!view || !Array.isArray(updated)) {
+				return
+			}
+			for (const u of updated) {
+				const item = view.layout.find((l) => String(l.id) === String(u.id));
+				if (!item) {
+					continue
+				}
+				for (const key of ['gridX', 'gridY', 'gridWidth', 'gridHeight']) {
+					if (u[key] !== undefined) {
+						item[key] = u[key];
+					}
+				}
+			}
+			/**
+			 * Emitted when a widget in a view's grid is dragged or resized.
+			 *
+			 * @event view-layout-change
+			 * @type {{view: string, layout: Array<object>}}
+			 */
+			this.$emit('view-layout-change', { view: view.id, layout: view.layout });
+		},
+	},
+};
+
+export { PAGE_VIEW_PREFERENCE_PREFIX, PAGE_VIEW_QUERY_KEY, pageViews };
+//# sourceMappingURL=pageViews.js.map