@conduction/nextcloud-vue 2.56.0-beta.10 → 2.56.0-beta.11

package/dist/esm/components/CnAdminActionCard/CnAdminActionCard.vue.js

@@ -0,0 +1,10 @@
+import script from './CnAdminActionCard.vue2.js';
+import { render } from './CnAdminActionCard.vue3.js';
+
+script.render = render;
+script.__scopeId = "data-v-57907ee5";
+script.__file = "src/components/CnAdminActionCard/CnAdminActionCard.vue";
+const __sfc_main = script;
+
+export { __sfc_main as default };
+//# sourceMappingURL=CnAdminActionCard.vue.js.map

package/dist/esm/components/CnAdminActionCard/CnAdminActionCard.vue.js.map

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

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

@@ -0,0 +1,189 @@
+import { translate } from '@nextcloud/l10n';
+import { NcButton, NcLoadingIcon, NcNoteCard } from '@nextcloud/vue';
+import __sfc_main from '../CnConfigurationCard/CnConfigurationCard.vue.js';
+
+/**
+ * CnAdminActionCard — one maintenance action on an admin settings page.
+ *
+ * A card with a title, a short explanation and one button. The click POSTs
+ * an app action, the button spins while it runs, and the server's message
+ * shows below it as success or error. Use it for work an admin starts by
+ * hand, such as repairing the register or re-importing schemas. That work
+ * never belongs in the setup wizard.
+ *
+ * By default it posts to the app's setup action contract,
+ * `/apps/{appId}/api/setup/action/{action}`, the same endpoint the setup
+ * wizard uses. Pass `url` to post somewhere else.
+ *
+ * ```vue
+ * <CnAdminActionCard
+ *   app-id="pipelinq"
+ *   action="provision"
+ *   :title="t('pipelinq', 'Repair the register')"
+ *   :description="t('pipelinq', 'Creates missing schemas again. Your data stays as it is.')"
+ *   :button-label="t('pipelinq', 'Repair')" />
+ * ```
+ *
+ * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action
+ */
+var script = {
+	name: 'CnAdminActionCard',
+
+	components: {
+		CnConfigurationCard: __sfc_main,
+		NcButton,
+		NcLoadingIcon,
+		NcNoteCard,
+	},
+
+	props: {
+		/** Card heading. Pass it translated. */
+		title: {
+			type: String,
+			required: true,
+		},
+
+		/** What the action does, in one or two short sentences. Pass it translated. */
+		description: {
+			type: String,
+			default: '',
+		},
+
+		/** The Nextcloud app id; builds the default action URL. */
+		appId: {
+			type: String,
+			default: '',
+		},
+
+		/** The action id, posted to `/apps/{appId}/api/setup/action/{action}`. */
+		action: {
+			type: String,
+			default: '',
+		},
+
+		/**
+		 * An app path to POST to instead of the setup action contract, e.g.
+		 * `/apps/pipelinq/api/settings/repair`. Passed through `generateUrl`.
+		 */
+		url: {
+			type: String,
+			default: '',
+		},
+
+		/** Request body to send with the POST. */
+		payload: {
+			type: Object,
+			default: () => ({}),
+		},
+
+		/** Button label. Defaults to "Run". */
+		buttonLabel: {
+			type: String,
+			default: '',
+		},
+
+		/** Label next to the spinner while the action runs. */
+		runningLabel: {
+			type: String,
+			default: () => translate('nextcloud-vue', 'Running…'),
+		},
+
+		/** NcButton variant for the action button. */
+		buttonVariant: {
+			type: String,
+			default: 'secondary',
+		},
+
+		/** Disable the button, e.g. while a precondition is not met. */
+		disabled: {
+			type: Boolean,
+			default: false,
+		},
+	},
+
+	emits: ['result'],
+
+	data() {
+		return {
+			running: false,
+			/** @type {{ success: boolean, message: string }|null} */
+			result: null,
+		}
+	},
+
+	computed: {
+		resolvedButtonLabel() {
+			return this.buttonLabel || translate('nextcloud-vue', 'Run')
+		},
+
+		/**
+		 * The app path the button posts to: `url` when set, else the setup
+		 * action contract. Empty when neither is configured.
+		 *
+		 * @return {string}
+		 */
+		actionPath() {
+			if (this.url) {
+				return this.url
+			}
+			if (this.appId && this.action) {
+				return `/apps/${this.appId}/api/setup/action/${this.action}`
+			}
+			return ''
+		},
+	},
+
+	methods: {
+		/**
+		 * Run the action: POST, spin while it runs, show the result.
+		 *
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action
+		 */
+		async run() {
+			if (this.running) {
+				return
+			}
+			if (!this.actionPath) {
+				this.result = { success: false, message: translate('nextcloud-vue', 'This action is not configured.') };
+				return
+			}
+			this.running = true;
+			this.result = null;
+			let data;
+			try {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([
+					import('@nextcloud/axios'),
+					import('@nextcloud/router'),
+				]);
+				const response = await axios.post(generateUrl(this.actionPath), this.payload);
+				data = response && response.data;
+				this.result = {
+					success: !!data && data.success !== false,
+					message: (data && data.message) || translate('nextcloud-vue', 'Done.'),
+				};
+			} catch (err) {
+				data = err && err.response ? err.response.data : null;
+				this.result = { success: false, message: this.errorMessage(err) };
+			} finally {
+				this.running = false;
+			}
+			/**
+			 * @event result The action finished.
+			 * @type {{ success: boolean, message: string, data: object|null }}
+			 */
+			this.$emit('result', { ...this.result, data });
+		},
+
+		errorMessage(err) {
+			const data = err && err.response && err.response.data;
+			if (data && (data.message || data.error)) {
+				return data.message || data.error
+			}
+			return (err && err.message) || translate('nextcloud-vue', 'Something went wrong.')
+		},
+	},
+};
+
+export { script as default };
+//# sourceMappingURL=CnAdminActionCard.vue2.js.map

package/dist/esm/components/CnAdminActionCard/CnAdminActionCard.vue2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CnAdminActionCard.vue2.js","sources":["../../../../src/components/CnAdminActionCard/CnAdminActionCard.vue"],"sourcesContent":["<!-- SPDX-License-Identifier: EUPL-1.2 -->\n<!-- SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl> -->\n<template>\n\t<CnConfigurationCard class=\"cn-admin-action-card\" :title=\"title\" data-testid=\"cn-admin-action-card\">\n\t\t<p v-if=\"description\" class=\"cn-admin-action-card__description\">\n\t\t\t{{ description }}\n\t\t</p>\n\t\t<!-- @slot default Extra content between the explanation and the button. -->\n\t\t<slot />\n\t\t<div class=\"cn-admin-action-card__footer\">\n\t\t\t<NcButton\n\t\t\t\t:variant=\"buttonVariant\"\n\t\t\t\t:disabled=\"running || disabled\"\n\t\t\t\tdata-testid=\"cn-admin-action-card-run\"\n\t\t\t\t@click=\"run\">\n\t\t\t\t<template v-if=\"running\" #icon>\n\t\t\t\t\t<NcLoadingIcon :size=\"20\" />\n\t\t\t\t</template>\n\t\t\t\t{{ running ? runningLabel : resolvedButtonLabel }}\n\t\t\t</NcButton>\n\t\t</div>\n\t\t<!-- role=status so a screen reader hears the outcome without moving focus. -->\n\t\t<div role=\"status\" aria-live=\"polite\">\n\t\t\t<NcNoteCard\n\t\t\t\tv-if=\"result\"\n\t\t\t\t:type=\"result.success ? 'success' : 'error'\"\n\t\t\t\tdata-testid=\"cn-admin-action-card-result\">\n\t\t\t\t{{ result.message }}\n\t\t\t</NcNoteCard>\n\t\t</div>\n\t</CnConfigurationCard>\n</template>\n\n<script>\nimport { translate as t } from '@nextcloud/l10n'\nimport { NcButton, NcLoadingIcon, NcNoteCard } from '@nextcloud/vue'\nimport CnConfigurationCard from '../CnConfigurationCard/CnConfigurationCard.vue'\n\n/**\n * CnAdminActionCard — one maintenance action on an admin settings page.\n *\n * A card with a title, a short explanation and one button. The click POSTs\n * an app action, the button spins while it runs, and the server's message\n * shows below it as success or error. Use it for work an admin starts by\n * hand, such as repairing the register or re-importing schemas. That work\n * never belongs in the setup wizard.\n *\n * By default it posts to the app's setup action contract,\n * `/apps/{appId}/api/setup/action/{action}`, the same endpoint the setup\n * wizard uses. Pass `url` to post somewhere else.\n *\n * ```vue\n * <CnAdminActionCard\n *   app-id=\"pipelinq\"\n *   action=\"provision\"\n *   :title=\"t('pipelinq', 'Repair the register')\"\n *   :description=\"t('pipelinq', 'Creates missing schemas again. Your data stays as it is.')\"\n *   :button-label=\"t('pipelinq', 'Repair')\" />\n * ```\n *\n * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action\n */\nexport default {\n\tname: 'CnAdminActionCard',\n\n\tcomponents: {\n\t\tCnConfigurationCard,\n\t\tNcButton,\n\t\tNcLoadingIcon,\n\t\tNcNoteCard,\n\t},\n\n\tprops: {\n\t\t/** Card heading. Pass it translated. */\n\t\ttitle: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** What the action does, in one or two short sentences. Pass it translated. */\n\t\tdescription: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** The Nextcloud app id; builds the default action URL. */\n\t\tappId: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** The action id, posted to `/apps/{appId}/api/setup/action/{action}`. */\n\t\taction: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/**\n\t\t * An app path to POST to instead of the setup action contract, e.g.\n\t\t * `/apps/pipelinq/api/settings/repair`. Passed through `generateUrl`.\n\t\t */\n\t\turl: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Request body to send with the POST. */\n\t\tpayload: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/** Button label. Defaults to \"Run\". */\n\t\tbuttonLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Label next to the spinner while the action runs. */\n\t\trunningLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: () => t('nextcloud-vue', 'Running…'),\n\t\t},\n\n\t\t/** NcButton variant for the action button. */\n\t\tbuttonVariant: {\n\t\t\ttype: String,\n\t\t\tdefault: 'secondary',\n\t\t},\n\n\t\t/** Disable the button, e.g. while a precondition is not met. */\n\t\tdisabled: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\t},\n\n\temits: ['result'],\n\n\tdata() {\n\t\treturn {\n\t\t\trunning: false,\n\t\t\t/** @type {{ success: boolean, message: string }|null} */\n\t\t\tresult: null,\n\t\t}\n\t},\n\n\tcomputed: {\n\t\tresolvedButtonLabel() {\n\t\t\treturn this.buttonLabel || t('nextcloud-vue', 'Run')\n\t\t},\n\n\t\t/**\n\t\t * The app path the button posts to: `url` when set, else the setup\n\t\t * action contract. Empty when neither is configured.\n\t\t *\n\t\t * @return {string}\n\t\t */\n\t\tactionPath() {\n\t\t\tif (this.url) {\n\t\t\t\treturn this.url\n\t\t\t}\n\t\t\tif (this.appId && this.action) {\n\t\t\t\treturn `/apps/${this.appId}/api/setup/action/${this.action}`\n\t\t\t}\n\t\t\treturn ''\n\t\t},\n\t},\n\n\tmethods: {\n\t\t/**\n\t\t * Run the action: POST, spin while it runs, show the result.\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action\n\t\t */\n\t\tasync run() {\n\t\t\tif (this.running) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!this.actionPath) {\n\t\t\t\tthis.result = { success: false, message: t('nextcloud-vue', 'This action is not configured.') }\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.running = true\n\t\t\tthis.result = null\n\t\t\tlet data\n\t\t\ttry {\n\t\t\t\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\t\t\t\timport('@nextcloud/axios'),\n\t\t\t\t\timport('@nextcloud/router'),\n\t\t\t\t])\n\t\t\t\tconst response = await axios.post(generateUrl(this.actionPath), this.payload)\n\t\t\t\tdata = response && response.data\n\t\t\t\tthis.result = {\n\t\t\t\t\tsuccess: !!data && data.success !== false,\n\t\t\t\t\tmessage: (data && data.message) || t('nextcloud-vue', 'Done.'),\n\t\t\t\t}\n\t\t\t} catch (err) {\n\t\t\t\tdata = err && err.response ? err.response.data : null\n\t\t\t\tthis.result = { success: false, message: this.errorMessage(err) }\n\t\t\t} finally {\n\t\t\t\tthis.running = false\n\t\t\t}\n\t\t\t/**\n\t\t\t * @event result The action finished.\n\t\t\t * @type {{ success: boolean, message: string, data: object|null }}\n\t\t\t */\n\t\t\tthis.$emit('result', { ...this.result, data })\n\t\t},\n\n\t\terrorMessage(err) {\n\t\t\tconst data = err && err.response && err.response.data\n\t\t\tif (data && (data.message || data.error)) {\n\t\t\t\treturn data.message || data.error\n\t\t\t}\n\t\t\treturn (err && err.message) || t('nextcloud-vue', 'Something went wrong.')\n\t\t},\n\t},\n}\n</script>\n\n<style scoped>\n.cn-admin-action-card__description {\n\tmargin: 0 0 12px;\n\tcolor: var(--color-text-maxcontrast);\n}\n\n.cn-admin-action-card__footer {\n\tdisplay: flex;\n\tgap: 8px;\n\tmargin-block: 8px;\n}\n</style>\n"],"names":["CnConfigurationCard","t"],"mappings":"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"}

package/dist/esm/components/CnAdminActionCard/CnAdminActionCard.vue3.js

@@ -0,0 +1,72 @@
+import { resolveComponent, openBlock, createBlock, withCtx, createElementBlock, toDisplayString, createCommentVNode, renderSlot, createElementVNode, createVNode, createSlots, createTextVNode } from 'vue';
+
+const _hoisted_1 = {
+  key: 0,
+  class: "cn-admin-action-card__description"
+};
+const _hoisted_2 = { class: "cn-admin-action-card__footer" };
+const _hoisted_3 = {
+  role: "status",
+  "aria-live": "polite"
+};
+
+function render(_ctx, _cache, $props, $setup, $data, $options) {
+  const _component_NcLoadingIcon = resolveComponent("NcLoadingIcon");
+  const _component_NcButton = resolveComponent("NcButton");
+  const _component_NcNoteCard = resolveComponent("NcNoteCard");
+  const _component_CnConfigurationCard = resolveComponent("CnConfigurationCard");
+
+  return (openBlock(), createBlock(_component_CnConfigurationCard, {
+    class: "cn-admin-action-card",
+    title: $props.title,
+    "data-testid": "cn-admin-action-card"
+  }, {
+    default: withCtx(() => [
+      ($props.description)
+        ? (openBlock(), createElementBlock("p", _hoisted_1, toDisplayString($props.description), 1 /* TEXT */))
+        : createCommentVNode("v-if", true),
+      renderSlot(_ctx.$slots, "default"),
+      createElementVNode("div", _hoisted_2, [
+        createVNode(_component_NcButton, {
+          variant: $props.buttonVariant,
+          disabled: $data.running || $props.disabled,
+          "data-testid": "cn-admin-action-card-run",
+          onClick: $options.run
+        }, createSlots({
+          default: withCtx(() => [
+            createTextVNode(" " + toDisplayString($data.running ? $props.runningLabel : $options.resolvedButtonLabel), 1 /* TEXT */)
+          ]),
+          _: 2 /* DYNAMIC */
+        }, [
+          ($data.running)
+            ? {
+                name: "icon",
+                fn: withCtx(() => [
+                  createVNode(_component_NcLoadingIcon, { size: 20 })
+                ]),
+                key: "0"
+              }
+            : undefined
+        ]), 1032 /* PROPS, DYNAMIC_SLOTS */, ["variant", "disabled", "onClick"])
+      ]),
+      createElementVNode("div", _hoisted_3, [
+        ($data.result)
+          ? (openBlock(), createBlock(_component_NcNoteCard, {
+              key: 0,
+              type: $data.result.success ? 'success' : 'error',
+              "data-testid": "cn-admin-action-card-result"
+            }, {
+              default: withCtx(() => [
+                createTextVNode(toDisplayString($data.result.message), 1 /* TEXT */)
+              ]),
+              _: 1 /* STABLE */
+            }, 8 /* PROPS */, ["type"]))
+          : createCommentVNode("v-if", true)
+      ])
+    ]),
+    _: 3 /* FORWARDED */
+  }, 8 /* PROPS */, ["title"]))
+}
+
+export { render };
+//# sourceMappingURL=CnAdminActionCard.vue3.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CnAdminActionCard.vue3.js","sources":["../../../../src/components/CnAdminActionCard/CnAdminActionCard.vue?vue&type=template&id=57907ee5&lang.js"],"sourcesContent":["<!-- SPDX-License-Identifier: EUPL-1.2 -->\n<!-- SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl> -->\n<template>\n\t<CnConfigurationCard class=\"cn-admin-action-card\" :title=\"title\" data-testid=\"cn-admin-action-card\">\n\t\t<p v-if=\"description\" class=\"cn-admin-action-card__description\">\n\t\t\t{{ description }}\n\t\t</p>\n\t\t<!-- @slot default Extra content between the explanation and the button. -->\n\t\t<slot />\n\t\t<div class=\"cn-admin-action-card__footer\">\n\t\t\t<NcButton\n\t\t\t\t:variant=\"buttonVariant\"\n\t\t\t\t:disabled=\"running || disabled\"\n\t\t\t\tdata-testid=\"cn-admin-action-card-run\"\n\t\t\t\t@click=\"run\">\n\t\t\t\t<template v-if=\"running\" #icon>\n\t\t\t\t\t<NcLoadingIcon :size=\"20\" />\n\t\t\t\t</template>\n\t\t\t\t{{ running ? runningLabel : resolvedButtonLabel }}\n\t\t\t</NcButton>\n\t\t</div>\n\t\t<!-- role=status so a screen reader hears the outcome without moving focus. -->\n\t\t<div role=\"status\" aria-live=\"polite\">\n\t\t\t<NcNoteCard\n\t\t\t\tv-if=\"result\"\n\t\t\t\t:type=\"result.success ? 'success' : 'error'\"\n\t\t\t\tdata-testid=\"cn-admin-action-card-result\">\n\t\t\t\t{{ result.message }}\n\t\t\t</NcNoteCard>\n\t\t</div>\n\t</CnConfigurationCard>\n</template>\n\n<script>\nimport { translate as t } from '@nextcloud/l10n'\nimport { NcButton, NcLoadingIcon, NcNoteCard } from '@nextcloud/vue'\nimport CnConfigurationCard from '../CnConfigurationCard/CnConfigurationCard.vue'\n\n/**\n * CnAdminActionCard — one maintenance action on an admin settings page.\n *\n * A card with a title, a short explanation and one button. The click POSTs\n * an app action, the button spins while it runs, and the server's message\n * shows below it as success or error. Use it for work an admin starts by\n * hand, such as repairing the register or re-importing schemas. That work\n * never belongs in the setup wizard.\n *\n * By default it posts to the app's setup action contract,\n * `/apps/{appId}/api/setup/action/{action}`, the same endpoint the setup\n * wizard uses. Pass `url` to post somewhere else.\n *\n * ```vue\n * <CnAdminActionCard\n *   app-id=\"pipelinq\"\n *   action=\"provision\"\n *   :title=\"t('pipelinq', 'Repair the register')\"\n *   :description=\"t('pipelinq', 'Creates missing schemas again. Your data stays as it is.')\"\n *   :button-label=\"t('pipelinq', 'Repair')\" />\n * ```\n *\n * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action\n */\nexport default {\n\tname: 'CnAdminActionCard',\n\n\tcomponents: {\n\t\tCnConfigurationCard,\n\t\tNcButton,\n\t\tNcLoadingIcon,\n\t\tNcNoteCard,\n\t},\n\n\tprops: {\n\t\t/** Card heading. Pass it translated. */\n\t\ttitle: {\n\t\t\ttype: String,\n\t\t\trequired: true,\n\t\t},\n\n\t\t/** What the action does, in one or two short sentences. Pass it translated. */\n\t\tdescription: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** The Nextcloud app id; builds the default action URL. */\n\t\tappId: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** The action id, posted to `/apps/{appId}/api/setup/action/{action}`. */\n\t\taction: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/**\n\t\t * An app path to POST to instead of the setup action contract, e.g.\n\t\t * `/apps/pipelinq/api/settings/repair`. Passed through `generateUrl`.\n\t\t */\n\t\turl: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Request body to send with the POST. */\n\t\tpayload: {\n\t\t\ttype: Object,\n\t\t\tdefault: () => ({}),\n\t\t},\n\n\t\t/** Button label. Defaults to \"Run\". */\n\t\tbuttonLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: '',\n\t\t},\n\n\t\t/** Label next to the spinner while the action runs. */\n\t\trunningLabel: {\n\t\t\ttype: String,\n\t\t\tdefault: () => t('nextcloud-vue', 'Running…'),\n\t\t},\n\n\t\t/** NcButton variant for the action button. */\n\t\tbuttonVariant: {\n\t\t\ttype: String,\n\t\t\tdefault: 'secondary',\n\t\t},\n\n\t\t/** Disable the button, e.g. while a precondition is not met. */\n\t\tdisabled: {\n\t\t\ttype: Boolean,\n\t\t\tdefault: false,\n\t\t},\n\t},\n\n\temits: ['result'],\n\n\tdata() {\n\t\treturn {\n\t\t\trunning: false,\n\t\t\t/** @type {{ success: boolean, message: string }|null} */\n\t\t\tresult: null,\n\t\t}\n\t},\n\n\tcomputed: {\n\t\tresolvedButtonLabel() {\n\t\t\treturn this.buttonLabel || t('nextcloud-vue', 'Run')\n\t\t},\n\n\t\t/**\n\t\t * The app path the button posts to: `url` when set, else the setup\n\t\t * action contract. Empty when neither is configured.\n\t\t *\n\t\t * @return {string}\n\t\t */\n\t\tactionPath() {\n\t\t\tif (this.url) {\n\t\t\t\treturn this.url\n\t\t\t}\n\t\t\tif (this.appId && this.action) {\n\t\t\t\treturn `/apps/${this.appId}/api/setup/action/${this.action}`\n\t\t\t}\n\t\t\treturn ''\n\t\t},\n\t},\n\n\tmethods: {\n\t\t/**\n\t\t * Run the action: POST, spin while it runs, show the result.\n\t\t *\n\t\t * @return {Promise<void>}\n\t\t * @spec openspec/changes/setup-wizard-card-load-and-dependency-gate/specs/cn-setup-wizard/spec.md#requirement-an-admin-action-card-runs-one-server-action\n\t\t */\n\t\tasync run() {\n\t\t\tif (this.running) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (!this.actionPath) {\n\t\t\t\tthis.result = { success: false, message: t('nextcloud-vue', 'This action is not configured.') }\n\t\t\t\treturn\n\t\t\t}\n\t\t\tthis.running = true\n\t\t\tthis.result = null\n\t\t\tlet data\n\t\t\ttry {\n\t\t\t\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\t\t\t\timport('@nextcloud/axios'),\n\t\t\t\t\timport('@nextcloud/router'),\n\t\t\t\t])\n\t\t\t\tconst response = await axios.post(generateUrl(this.actionPath), this.payload)\n\t\t\t\tdata = response && response.data\n\t\t\t\tthis.result = {\n\t\t\t\t\tsuccess: !!data && data.success !== false,\n\t\t\t\t\tmessage: (data && data.message) || t('nextcloud-vue', 'Done.'),\n\t\t\t\t}\n\t\t\t} catch (err) {\n\t\t\t\tdata = err && err.response ? err.response.data : null\n\t\t\t\tthis.result = { success: false, message: this.errorMessage(err) }\n\t\t\t} finally {\n\t\t\t\tthis.running = false\n\t\t\t}\n\t\t\t/**\n\t\t\t * @event result The action finished.\n\t\t\t * @type {{ success: boolean, message: string, data: object|null }}\n\t\t\t */\n\t\t\tthis.$emit('result', { ...this.result, data })\n\t\t},\n\n\t\terrorMessage(err) {\n\t\t\tconst data = err && err.response && err.response.data\n\t\t\tif (data && (data.message || data.error)) {\n\t\t\t\treturn data.message || data.error\n\t\t\t}\n\t\t\treturn (err && err.message) || t('nextcloud-vue', 'Something went wrong.')\n\t\t},\n\t},\n}\n</script>\n\n<style scoped>\n.cn-admin-action-card__description {\n\tmargin: 0 0 12px;\n\tcolor: var(--color-text-maxcontrast);\n}\n\n.cn-admin-action-card__footer {\n\tdisplay: flex;\n\tgap: 8px;\n\tmargin-block: 8px;\n}\n</style>\n"],"names":["_createBlock","_createElementBlock","_toDisplayString","_renderSlot","_createTextVNode","_createVNode"],"mappings":";;;;AAMK,EAAA,KAAA,EAAA,mCAAA;;AAKE,MAAA,UAAA,GAAA,EAAA,KAAK,EAAC,8BAAc,GAAA;;AAapB,EAAA,IAAI,EAAC,QAAI;AAAA,EAAA,WAAA,EAAA,QAAA;;;;;;;;;uBAnBbA;AAAgB,IAAA,KAAA,EAAA,sBAAA;AAAA,IAAA,KAAA,EAAA,MAAA,CAAA,KAAA;AAAA,IAAA,aAAA,EAAA,sBAAA;;qBACjB,MAEI;OAFD,MAAA,CAAA,WAAA;wBAAHC,kBAEI,CAAA,GAAA,EAFJ,UAEI,EAAAC,eAAA,CADC,MAAU,CAAA,WAAA,CAAA,EAAA,CAAA,YAAA;;MAGdC,UAAO,CAAA,IAAA,CAAA,MAAA,EAAA,SAAA,CAAA;yBAYF,iBAAA,EAAA;mBADM,CAAA,mBAAA,EAAA;AART,UAAA,OAAO,EAAE,MAAa,CAAA,aAAA;UACtB,QAAQ,EAAE,KAAC,CAAA,OAAA,IAAA,MAAA,CAAA,QAAA;AACZ,UAAA,aAAW,EAAC,0BAAkB;AAC7B,UAAA,OAAK,EAAE,QAAG,CAAA,GAAA;;2BAGF,MACT;AADS,YAAAC,eAAA,CAAA,GACT,GAAGF,eAAA,CAAA,KAAA,CAAA,OAAA,GAAA,MAAA,CAAA,YAAA,GAAA,QAAA,CAAA,mBAAA,CAAA,EAAA,CAAA,YAAA;;;;WAHO,KAAA,CAAA,OAAA;;sBAAA,MAAA;4BACT,MAA4B;kBAA5BG,WAA4B,CAAA,wBAAA,EAAA,EAAZ,IAAI,EAAE,EAAG,EAAA,CAAA;;;;;;;;SAQpB,KAAM,CAAA,MAAA;0BADZL,WAKY,CAAA,qBAAA,EAAA;;cAHX,IAAI,EAAE,KAAM,CAAA,MAAA,CAAC,OAAK,GAAA,SAAA,GAAA,OAAA;AACnB,cAAA,aAAW,EAAA,6BAAA;;+BACX,MAAG;AAAA,gBAAAI,eAAA,CAAAF,eAAA,CAAA,KAAA,CAAA,MAAA,CAAA,OAAA,CAAA,EAAA,CAAA,YAAA;;;;;;;;;;;;;"}

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

@@ -1,11 +1,13 @@
 import { getCurrentUser } from '@nextcloud/auth';
 import axios__default from '@nextcloud/axios';
 import { loadState } from '@nextcloud/initial-state';
+import { translate } from '@nextcloud/l10n';
 import { generateUrl } from '@nextcloud/router';
 import { NcAppContent, NcAppSettingsDialog, NcAppSettingsSection, NcButton, NcContent, NcEmptyContent, NcLoadingIcon, NcNoteCard } from '@nextcloud/vue';
 import { shallowRef, watch, computed, reactive } from 'vue';
 import DatabaseSearchOutline from 'vue-material-design-icons/DatabaseSearchOutline.vue';
 import OpenInNew from 'vue-material-design-icons/OpenInNew.vue';
+import Play from 'vue-material-design-icons/Play.vue';
 import Restart from 'vue-material-design-icons/Restart.vue';
 import __sfc_main$5 from '../CnAiCompanion/CnAiCompanion.vue.js';
 import __sfc_main$1 from '../CnAppLoading/CnAppLoading.vue.js';
@@ -29,7 +31,7 @@ import { useSetupStatus } from '../../composables/useSetupStatus.js';
 import { useSupportDialog } from '../../composables/useSupportDialog.js';
 import { provideTenantContext } from '../../composables/useTenantContext.js';
 import { useUserPreferences } from '../../composables/useUserPreferences.js';
-import { useWalkthrough, readLocalWalkthroughSeenVersion, loadWalkthroughSeenVersion, normaliseSeenVersion, persistWalkthroughSeenVersion } from '../../composables/useWalkthrough.js';
+import { useWalkthrough, readLocalWalkthroughSeenVersion, readLocalWalkthroughProgress, loadWalkthroughSeenVersion, loadWalkthroughProgress, normaliseSeenVersion, persistWalkthroughSeenVersion, persistWalkthroughProgress } from '../../composables/useWalkthrough.js';
 import { RegistryKindError } from '../../errors/RegistryKindError.js';
 import { isAppInstalled } from '../../utils/appInstalled.js';
 import { BUILT_IN_FORMATTERS } from '../../utils/builtInFormatters.js';
@@ -106,6 +108,7 @@ var script = {
 		NcNoteCard,
 		DatabaseSearchOutline,
 		OpenInNew,
+		Play,
 		Restart,
 		CnAppNav: __sfc_main,
 		CnAppLoading: __sfc_main$1,
@@ -1133,6 +1136,15 @@ var script = {
 			 * @type {string}
 			 */
 			walkthroughSeenVersionValue: readLocalWalkthroughSeenVersion(this.appId),
+			/**
+			 * Where the user is in an unfinished tour (`{ tourId, stepId,
+			 * index, version }`), or null. Seeded from the local mirror, then
+			 * replaced by the per-user `<completionConfigKey>-progress`
+			 * preference. The tour resumes at this step on the next visit.
+			 *
+			 * @type {object|null}
+			 */
+			walkthroughProgressValue: readLocalWalkthroughProgress(this.appId),
 			/**
 			 * Whether `walkthroughSeenVersionValue` is settled. Starts `true`
 			 * when the manifest declares no `completionConfigKey` (the local
@@ -1886,13 +1898,15 @@ var script = {
 			try {
 				const p = new URLSearchParams(window.location.search);
 				const tourId = p.get('cn_resume_tour');
-				if (!tourId) {
-					return null
+				if (tourId) {
+					return { tourId, stepId: p.get('cn_resume_step') || '' }
 				}
-				return { tourId, stepId: p.get('cn_resume_step') || '' }
 			} catch {
-				return null
+				// No URL token; fall through to the remembered progress.
 			}
+			// An unfinished tour continues at the step the user reached.
+			const progress = this.walkthroughProgressValue;
+			return progress ? { tourId: progress.tourId, stepId: progress.stepId } : null
 		},
 
 		phase() {
@@ -2135,6 +2149,24 @@ var script = {
 			return this.translate('Restart walkthrough')
 		},
 
+		/**
+		 * Label for continuing an unfinished tour at the remembered step.
+		 *
+		 * @return {string}
+		 */
+		continueWalkthroughLabel() {
+			return translate('nextcloud-vue', 'Continue where you left off')
+		},
+
+		/**
+		 * Label for restarting an unfinished tour from the first step.
+		 *
+		 * @return {string}
+		 */
+		startOverWalkthroughLabel() {
+			return translate('nextcloud-vue', 'Start over')
+		},
+
 		/**
 		 * Resolve the active modal's Vue component from the registry.
 		 * Returns null when no modal is open or the key no longer resolves.
@@ -2638,10 +2670,12 @@ var script = {
 				return
 			}
 			try {
-				this.walkthroughSeenVersionValue = await loadWalkthroughSeenVersion(
-					this.appId,
-					this.walkthroughConfigKey,
-				);
+				const [seen, progress] = await Promise.all([
+					loadWalkthroughSeenVersion(this.appId, this.walkthroughConfigKey),
+					loadWalkthroughProgress(this.appId, this.walkthroughConfigKey),
+				]);
+				this.walkthroughSeenVersionValue = seen;
+				this.walkthroughProgressValue = progress;
 			} finally {
 				this.walkthroughSeenResolved = true;
 			}
@@ -2665,12 +2699,68 @@ var script = {
 			// Fire-and-forget: the loader never rejects and the local mirror is
 			// already written, so a failed PUT must not surface as an error.
 			persistWalkthroughSeenVersion(this.appId, this.walkthroughConfigKey, v);
+			// A finished or skipped tour has nothing to continue.
+			if (this.walkthroughProgressValue) {
+				this.walkthroughProgressValue = null;
+				persistWalkthroughProgress(this.appId, this.walkthroughConfigKey, null);
+			}
 			/**
 			 * @event walkthrough-complete Emitted when the walkthrough finishes or is dismissed.
 			 */
 			this.$emit('walkthrough-complete');
 		},
 
+		/**
+		 * Remember where the user is in the tour, so a reload or a restart
+		 * entry continues there (local mirror + per-user preference).
+		 *
+		 * @spec openspec/changes/walkthrough-advance-pause-resume/specs/cn-walkthrough/spec.md
+		 * @param {object} progress `{ tourId, stepId, index }` from CnWalkthrough.
+		 * @return {void}
+		 */
+		onWalkthroughProgress(progress) {
+			if (!progress || !progress.tourId) {
+				return
+			}
+			// The first step of a fresh tour is where a restart lands anyway,
+			// so it costs no request.
+			if (progress.index === 0 && !this.walkthroughProgressValue) {
+				return
+			}
+			const value = {
+				tourId: progress.tourId,
+				stepId: progress.stepId || '',
+				index: progress.index || 0,
+				version: String((this.manifest && this.manifest.version) || ''),
+			};
+			this.walkthroughProgressValue = value;
+			persistWalkthroughProgress(this.appId, this.walkthroughConfigKey, value);
+		},
+
+		/**
+		 * Continue an unfinished tour from the user-settings dialog: show a
+		 * paused tour again, or start the remembered tour at its step.
+		 *
+		 * @spec openspec/changes/walkthrough-advance-pause-resume/specs/cn-walkthrough/spec.md
+		 * @return {void}
+		 */
+		continueWalkthroughFromSettings() {
+			this.userSettingsOpen = false;
+			if (!this.walkthroughEnabled) {
+				return
+			}
+			setTimeout(() => {
+				const wt = useWalkthrough(this.appId, this.manifest);
+				if (wt.resumePaused()) {
+					return
+				}
+				const progress = this.walkthroughProgressValue;
+				if (progress) {
+					wt.resumeAt(progress.tourId, progress.stepId);
+				}
+			}, 50);
+		},
+
 		/**
 		 * Replay the product tour from the user-settings dialog. Closes the
 		 * dialog first, then restarts the first declared tour on the next tick