@poveste/plugin-vue 0.20.0 → 0.21.0

package/README.md

@@ -37,6 +37,13 @@ import MyButton from './MyButton.vue'
 
 `<Story>` and `<Variant>` are registered globally — no import needed.
 
+Each story's **Docs** tab shows a props, slots and events table for the `.vue`
+components it imports, read from their types with `vue-component-meta`: descriptions
+and tags from JSDoc, defaults from `withDefaults`, slots from `defineSlots` and events
+from `defineEmits`. It needs `typescript` 6 or earlier in the project
+(`npm i -D typescript@6`); without it, or with 7, it turns itself off and says so once.
+Set `autoDocs: false` in the config to turn it off.
+
 Coming from histoire? The Vue API is unchanged: swap the dependency and your existing
 `.story.vue` files keep working.
 

package/dist/bundled/client/app/Story.js

@@ -1,11 +1,11 @@
 import { implicitStateContext as e, storyContext as t } from "./context.js";
 import { useRenderContext as n } from "./render-context.js";
-import { isWritableBinding as r, useInstance as i } from "./util.js";
-import a from "./Variant.js";
-import { cloneVNode as o, computed as s, defineComponent as c, h as l, isRef as u, reactive as d, useAttrs as f } from "vue";
-import { omitInheritStoryProps as p } from "@poveste/shared";
+import { holdsVueApp as r, isComponentBinding as i, isWritableBinding as a, useInstance as o } from "./util.js";
+import s from "./Variant.js";
+import { cloneVNode as c, computed as l, defineComponent as u, h as d, isRef as f, reactive as p, useAttrs as m } from "vue";
+import { omitInheritStoryProps as h } from "@poveste/shared";
 //#region src/client/app/Story.ts
-var m = c({
+var g = u({
 	name: "Story",
 	__povesteType: "story",
 	inheritAttrs: !1,
@@ -17,87 +17,99 @@ var m = c({
 		meta: {
 			type: Object,
 			default: void 0
+		},
+		autoDocs: {
+			type: [Boolean, Array],
+			default: void 0
+		},
+		component: {
+			type: [
+				Object,
+				Function,
+				Array
+			],
+			default: void 0
 		}
 	},
-	setup(a) {
-		let c = i("Story"), l = f(), m = n(), h = s(() => l.story);
-		t.provide(h);
-		let g = c.parent, _ = d({});
-		Object.defineProperty(_, "$data", {
+	setup(s) {
+		let u = o("Story"), d = m(), g = n(), _ = l(() => d.story);
+		t.provide(_);
+		let v = u.parent, y = p({});
+		Object.defineProperty(y, "$data", {
 			enumerable: !0,
 			configurable: !0,
-			get: () => g.data,
+			get: () => v.data,
 			set: (e) => {
-				Object.assign(g.data, e);
+				Object.assign(v.data, e);
 			}
 		});
-		function v(e, t) {
+		function b(e, t) {
 			let n = e[t];
-			typeof n == "function" || n?.__file || typeof n?.render == "function" || typeof n?.setup == "function" || r(n) && Object.defineProperty(_, t, {
+			i(n) || r(n) || a(n) && Object.defineProperty(y, t, {
 				enumerable: !0,
 				configurable: !0,
 				get: () => {
 					let n = e[t];
-					return u(n) ? n.value : n;
+					return f(n) ? n.value : n;
 				},
 				set: (n) => {
 					let r = e[t];
-					u(r) ? r.value = n : r && typeof r == "object" && n && typeof n == "object" ? Object.assign(r, n) : e[t] = n;
+					f(r) ? r.value = n : r && typeof r == "object" && n && typeof n == "object" ? Object.assign(r, n) : e[t] = n;
 				}
 			});
 		}
-		for (let e in g.exposed) v(g.exposed, e);
-		for (let e in g.devtoolsRawSetupState) v(g.devtoolsRawSetupState, e);
-		for (let e in g.data) v(g.data, e);
-		e.provide(() => _);
-		function y() {
-			a.meta && (l.story.meta || (l.story.meta = {}), Object.assign(l.story.meta, a.meta)), Object.assign(l.story, { slots: () => c.slots });
+		for (let e in v.exposed) b(v.exposed, e);
+		for (let e in v.devtoolsRawSetupState) b(v.devtoolsRawSetupState, e);
+		for (let e in v.data) b(v.data, e);
+		e.provide(() => y);
+		function x() {
+			s.meta && (d.story.meta || (d.story.meta = {}), Object.assign(d.story.meta, s.meta)), Object.assign(d.story, { slots: () => u.slots });
 		}
 		return {
-			renderContext: m,
-			story: h,
-			renderMountStory: x,
-			renderPreviewStory: C,
-			updateStory: y
+			renderContext: g,
+			story: _,
+			renderMountStory: C,
+			renderPreviewStory: T,
+			updateStory: x
 		};
-		function b(e) {
+		function S(e) {
 			let t = {};
-			for (let n in c.attrs) e.props?.[n] === void 0 && (t[n] = c.attrs[n]);
-			for (let n in l.story) !p.includes(n) && e.props?.[n] === void 0 && (t[n] = Reflect.get(l.story, n));
+			for (let n in u.attrs) e.props?.[n] === void 0 && (t[n] = u.attrs[n]);
+			for (let n in d.story) !h.includes(n) && e.props?.[n] === void 0 && (t[n] = Reflect.get(d.story, n));
 			return t;
 		}
-		function x() {
-			let e = 0, t = m?.targetVariantId, n = t ? l.story.variants.findIndex((e) => e.id === t) : -1, r = (t) => {
+		function C() {
+			let e = 0, t = g?.targetVariantId, n = t ? d.story.variants.findIndex((e) => e.id === t) : -1, r = (t) => {
 				let i = [];
-				for (let s of t) if (s.type?.__povesteType === "variant") {
-					let t = l.story.variants[e];
+				for (let a of t) if (a.type?.__povesteType === "variant") {
+					let t = d.story.variants[e];
 					if (e++, !t || n !== -1 && e - 1 !== n) continue;
 					let r = { variant: t };
-					s.key ?? (r.key = t.id), !s.props?.initState && !s.props?.["init-state"] && (r.initState = a.initState), Object.assign(r, b(s)), i.push(o(s, r));
-				} else Array.isArray(s.children) && (s.children = r(s.children)), i.push(s);
+					a.key ?? (r.key = t.id), !a.props?.initState && !a.props?.["init-state"] && (r.initState = s.initState), Object.assign(r, S(a)), i.push(c(a, r));
+				} else Array.isArray(a.children) && (a.children = r(a.children)), i.push(a);
 				return i;
 			};
-			return r(c.slots.default?.() ?? []);
+			return r(u.slots.default?.() ?? []);
 		}
-		function S(e) {
+		function w(e) {
 			let t = 0;
-			for (let n of e) n?.type?.__povesteType === "variant" ? t++ : Array.isArray(n?.children) && (t += S(n.children));
+			for (let n of e) n?.type?.__povesteType === "variant" ? t++ : Array.isArray(n?.children) && (t += w(n.children));
 			return t;
 		}
-		function C(e) {
+		function T(e) {
 			e.nextVariantIndex.value = 0;
 			let t = { state: e.externalState }, n = [];
-			e.slotName === "controls" && n.push(...c.slots.controls?.(t) ?? []), (e.slotName === "default" || l.story.meta?.hasVariantChildComponents) && n.push(...c.slots.default?.(t) ?? []);
+			e.slotName === "controls" && n.push(...u.slots.controls?.(t) ?? []), (e.slotName === "default" || d.story.meta?.hasVariantChildComponents) && n.push(...u.slots.default?.(t) ?? []);
 			let r = e.currentVariant;
-			if (e.slotName === "default" && r && S(n) === l.story.variants.length) {
-				let t = l.story.variants.findIndex((e) => e.id === r.id);
+			if (e.slotName === "default" && r && w(n) === d.story.variants.length) {
+				let t = d.story.variants.findIndex((e) => e.id === r.id);
 				if (t !== -1) {
 					let r = 0, i = !1, a = (e) => {
 						let n = [];
-						for (let s of e) s?.type?.__povesteType === "variant" ? (r === t && (n.push(o(s, b(s))), i = !0), r++) : (Array.isArray(s?.children) && s.children.length && (s.children = a(s.children)), n.push(s));
+						for (let o of e) o?.type?.__povesteType === "variant" ? (r === t && (n.push(c(o, S(o))), i = !0), r++) : (Array.isArray(o?.children) && o.children.length && (o.children = a(o.children)), n.push(o));
 						return n;
-					}, s = a(n);
-					if (i) return e.nextVariantIndex.value = t, s;
+					}, o = a(n);
+					if (i) return e.nextVariantIndex.value = t, o;
 				}
 			}
 			return n;
@@ -106,7 +118,7 @@ var m = c({
 	render() {
 		this.updateStory();
 		let [e] = this.story.variants;
-		if (e?.id === "_default") return l(a, {
+		if (e?.id === "_default") return d(s, {
 			variant: e,
 			...this.initState ? { initState: this.initState } : {},
 			implicit: !0,
@@ -117,4 +129,4 @@ var m = c({
 	}
 });
 //#endregion
-export { m as default };
+export { g as default };

package/dist/bundled/client/app/global-components.js

@@ -5,10 +5,12 @@ import { defineComponent as a, h as o, onBeforeUnmount as s, onBeforeUpdate as c
 import { components as f } from "@poveste/controls";
 //#region src/client/app/global-components.ts
 function p(n) {
-	n.component("Story", t), n.component("Variant", e);
-	for (let [e, t] of Object.entries(f)) n.component(e, m(t));
+	n.component("Story", t), n.component("Variant", e), m(n);
 }
 function m(e) {
+	for (let [t, n] of Object.entries(f)) e.component(t, h(n));
+}
+function h(e) {
 	let t = e;
 	return a({
 		...e.name ? { name: e.name } : {},
@@ -63,4 +65,4 @@ function m(e) {
 	});
 }
 //#endregion
-export { p as registerGlobalComponents };
+export { m as registerControlComponents, p as registerGlobalComponents };

package/dist/bundled/client/app/host.js

@@ -28,7 +28,7 @@ function m(e) {
 	let t = null, o = null;
 	async function c() {
 		let c = [];
-		o = document.createElement("div"), e.el.appendChild(o), t = a({
+		if (o = document.createElement("div"), e.el.appendChild(o), t = a({
 			name: e.name,
 			render: () => {
 				let t = s(p, {
@@ -42,21 +42,25 @@ function m(e) {
 						variant: e.getVariant()
 					}, () => r);
 				}
-				return e.wrapInDiv && (t = s("div", t)), s(i, {}, t);
+				return e.wrapInDiv && (t = s("div", t)), s(i, e.onResolve ? { onResolve: e.onResolve } : {}, t);
 			}
 		}), t.config.errorHandler = (t) => {
 			l(t, {
 				storyId: e.getStory()?.id,
 				variantId: e.getVariant()?.id
-			}), console.error(t);
-		}, d && t.use(d), n(t), t.component("RouterLink", r), await h({
+			}), e.onError ? e.onError(t) : console.error(t);
+		}, e.onWarn) {
+			let n = e.onWarn;
+			t.config.warnHandler = (e, t, r) => n(e, r);
+		}
+		d && t.use(d), n(t), t.component("RouterLink", r), await h({
 			app: t,
 			story: e.getStory(),
 			variant: e.getVariant() ?? void 0,
 			addWrapper: (e) => {
 				c.unshift(e);
 			}
-		}), t.mount(o);
+		}), e.configureApp?.(t), t.mount(o);
 	}
 	function u() {
 		t?.unmount(), t = null, o &&= (o.parentNode?.removeChild(o), null);

package/dist/bundled/client/app/util.js

@@ -73,13 +73,22 @@ function x(e) {
 	return !(o(e) && a(e));
 }
 function S(e) {
+	return typeof e == "function" ? !0 : m(e) ? "__file" in e && !!e.__file || "render" in e && typeof e.render == "function" || "setup" in e && typeof e.setup == "function" : !1;
+}
+function C(e) {
+	return m(e) && "_context" in e && "_component" in e && "mount" in e;
+}
+function w(e) {
+	return m(e) ? C(e) ? !0 : Object.values(Object.getOwnPropertyDescriptors(e)).some((e) => "value" in e && C(e.value)) : !1;
+}
+function T(e) {
 	let t = i();
 	if (!t) throw Error(`[poveste] <${e}> can only be set up inside a component`);
 	return t;
 }
-var C = !1;
-function w(t) {
-	C || e() || (C = !0, console.warn(`[poveste] ${t} was rendered by a copy of Vue other than \`@poveste/vendors/vue\`, so it renders nothing. Poveste's client components are built against that copy: create the app with \`createApp\` from \`@poveste/vendors/vue\`, not from \`vue\`.`));
+var E = !1;
+function D(t) {
+	E || e() || (E = !0, console.warn(`[poveste] ${t} was rendered by a copy of Vue other than \`@poveste/vendors/vue\`, so it renders nothing. Poveste's client components are built against that copy: create the app with \`createApp\` from \`@poveste/vendors/vue\`, not from \`vue\`.`));
 }
 //#endregion
-export { _ as _toRawDeep, x as isWritableBinding, b as syncStateBundledAndExternal, h as toRawDeep, S as useInstance, w as warnIfForeignVue };
+export { _ as _toRawDeep, w as holdsVueApp, S as isComponentBinding, x as isWritableBinding, b as syncStateBundledAndExternal, h as toRawDeep, T as useInstance, D as warnIfForeignVue };

package/dist/bundled/client/server/Story.js

@@ -34,6 +34,18 @@ var s = a({
 			type: Boolean,
 			default: !1
 		},
+		autoDocs: {
+			type: [Boolean, Array],
+			default: void 0
+		},
+		component: {
+			type: [
+				Object,
+				Function,
+				Array
+			],
+			default: void 0
+		},
 		meta: {
 			type: Object,
 			default: void 0
@@ -50,6 +62,7 @@ var s = a({
 			icon: i.icon,
 			iconColor: i.iconColor,
 			docsOnly: i.docsOnly,
+			...i.autoDocs === void 0 ? {} : { autoDocs: i.autoDocs },
 			meta: i.meta,
 			variants: []
 		};

package/dist/bundled/client/server/collect.js

@@ -0,0 +1,41 @@
+import { VUE_SETUP_HOOK_NAMES as e } from "../../setup-hooks.js";
+import { addStoryContext as t, storyFileContext as n } from "./context.js";
+import r from "./Story.js";
+import i from "./Variant.js";
+import { createApp as a, h as o } from "vue";
+import { getSetupHook as s } from "@poveste/shared";
+import * as c from "virtual:$poveste-generated-global-setup";
+import * as l from "virtual:$poveste-setup";
+//#region src/client/server/collect.ts
+async function u(u, { file: d, storyData: f, el: p }, m = {}) {
+	let h = a({
+		setup() {
+			t.provide((e) => {
+				f.push(e);
+			}), n.provide(d);
+		},
+		render() {
+			return o(u);
+		}
+	});
+	h.component("Story", r), h.component("Variant", i), m.beforeSetup?.(h);
+	let g = {
+		app: h,
+		story: void 0,
+		variant: void 0,
+		addWrapper: () => {}
+	}, _ = s(c, e);
+	_ && await _(g);
+	let v = s(l, e);
+	if (v && await v(g), m.afterSetup?.(h), h.mount(p), u.doc) {
+		let e = document.createElement("div");
+		e.innerHTML = u.doc;
+		let t = e.textContent;
+		f.forEach((e) => {
+			e.docsText = t;
+		});
+	}
+	h.unmount();
+}
+//#endregion
+export { u as collectComponent };

package/dist/bundled/client/server/run.js

@@ -1,44 +1,15 @@
-import { VUE_SETUP_HOOK_NAMES as e } from "../../setup-hooks.js";
-import { addStoryContext as t, storyFileContext as n } from "./context.js";
-import r from "./Story.js";
-import i from "./Variant.js";
-import { createApp as a, h as o } from "vue";
-import { getSetupHook as s } from "@poveste/shared";
-import * as c from "virtual:$poveste-generated-global-setup";
-import * as l from "virtual:$poveste-setup";
+import { collectComponent as e } from "./collect.js";
 //#region src/client/server/run.ts
-async function u({ file: u, storyData: d, el: f }) {
-	let { default: p } = await import(/* @vite-ignore */
+async function t({ file: t, storyData: n, el: r }) {
+	let { default: i } = await import(/* @vite-ignore */
 		/* @vite-ignore */
-		u.moduleId
-	), m = a({
-		setup() {
-			t.provide((e) => {
-				d.push(e);
-			}), n.provide(u);
-		},
-		render() {
-			return o(p);
-		}
+		t.moduleId
+	);
+	await e(i, {
+		file: t,
+		storyData: n,
+		el: r
 	});
-	m.component("Story", r), m.component("Variant", i);
-	let h = {
-		app: m,
-		story: void 0,
-		variant: void 0,
-		addWrapper: () => {}
-	}, g = s(c, e);
-	g && await g(h);
-	let _ = s(l, e);
-	if (_ && await _(h), m.mount(f), p.doc) {
-		let e = document.createElement("div");
-		e.innerHTML = p.doc;
-		let t = e.textContent;
-		d.forEach((e) => {
-			e.docsText = t;
-		});
-	}
-	m.unmount();
 }
 //#endregion
-export { u as run };
+export { t as run };

package/dist/bundled/testing/index.js

@@ -0,0 +1,168 @@
+import { syncStateBundledAndExternal as e } from "../client/app/util.js";
+import { registerControlComponents as t } from "../client/app/global-components.js";
+import { createPreviewHost as n } from "../client/app/host.js";
+import { collectComponent as r } from "../client/server/collect.js";
+import { markRaw as i, nextTick as a, reactive as o } from "vue";
+import { environmentApp as s, environmentReady as c } from "virtual:$poveste-testing-environment";
+import { describe as l, it as u } from "vitest";
+//#region src/testing/index.ts
+function d(e, t = {}) {
+	let n = t.name ?? x(e.__file) ?? "stories", r = t.timeout ?? 5e3;
+	l(n, async () => {
+		await c();
+		let { stories: t, problems: i } = await f(e, n);
+		if (i.length || !t.length) u("collects", () => {
+			throw y(`collecting ${n}`, i.length ? i : ["it has no <Story>"]);
+		});
+		else for (let e of t) l(e.title, () => {
+			for (let t of e.variants) u(t.title, async () => {
+				let n = await m(e, t, r);
+				if (n.length) throw y(`${e.title} › ${t.title}`, n);
+			});
+		});
+	});
+}
+async function f(e, t) {
+	let n = e.__file ?? t, a = x(n) ?? t, o = {
+		id: t.replace(/\W+/g, "-").toLowerCase(),
+		path: n,
+		moduleId: n,
+		fileName: a.includes(".") ? a.slice(0, a.indexOf(".")) : a
+	}, s = [], c = [], l = document.createElement("div");
+	try {
+		await r(e, {
+			file: o,
+			storyData: s,
+			el: l
+		}, {
+			beforeSetup(e) {
+				e.config.errorHandler = (e) => {
+					c.push(e);
+				}, e.config.warnHandler = (e, t, n) => {
+					c.push(b(e, n));
+				};
+			},
+			afterSetup(e) {
+				_(e._context.components, h()), g(e);
+			}
+		});
+	} catch (e) {
+		c.push(e);
+	}
+	let u = {
+		id: o.id,
+		supportPluginId: "vue3",
+		component: i(e),
+		path: [],
+		filePath: o.path,
+		source: async () => ({ default: "" })
+	};
+	return {
+		stories: s.map((e) => {
+			let t = {
+				...e,
+				file: i(u),
+				variants: e.variants.map((e) => p(e)),
+				slots: () => ({})
+			};
+			return u.story = t, t;
+		}),
+		problems: c
+	};
+}
+function p(e) {
+	return {
+		...e,
+		state: o({
+			_hPropState: {},
+			_hPropDefs: {}
+		}),
+		setupApp: void 0,
+		slots: () => ({}),
+		previewReady: !1
+	};
+}
+async function m(t, r, i) {
+	let a = [], s = (e) => {
+		a.push(e);
+	}, c = (e, t) => {
+		a.push(b(e, t));
+	}, l = !1, u = document.createElement("div");
+	document.body.appendChild(u);
+	let d = n({
+		name: "StoryTestMount",
+		el: u,
+		getStory: () => t,
+		getVariant: () => null,
+		renderContext: o({
+			mode: "mount",
+			slotName: "default",
+			currentVariant: null,
+			targetVariantId: r.id,
+			externalState: null,
+			nextVariantIndex: { value: 0 }
+		}),
+		onError: s,
+		onWarn: c,
+		configureApp: g
+	}), f = o({}), p = e(r.state, f), m = n({
+		name: "StoryTestRender",
+		el: u,
+		getStory: () => t,
+		getVariant: () => r,
+		renderContext: o({
+			mode: "render",
+			slotName: "default",
+			currentVariant: r,
+			externalState: f,
+			nextVariantIndex: { value: 0 }
+		}),
+		wrapInDiv: !0,
+		onError: s,
+		onWarn: c,
+		onResolve: () => {
+			l = !0;
+		},
+		configureApp: g
+	});
+	try {
+		await d.mount(), await v(() => !!r.configReady || a.length > 0, i) || a.push(/* @__PURE__ */ Error(`its setup did not settle within ${i} ms`)), a.length || (await m.mount(), await v(() => l || a.length > 0, i) || a.push(/* @__PURE__ */ Error(`its render did not settle within ${i} ms`)));
+	} catch (e) {
+		a.push(e);
+	} finally {
+		m.unmount(), d.unmount(), p.stop(), u.remove();
+	}
+	return a;
+}
+function h() {
+	let e = {};
+	return t({ component: (t, n) => {
+		e[t] = n;
+	} }), e;
+}
+function g(e) {
+	let t = s();
+	t && (_(e, t), _(e._context.provides, t._context.provides), _(e.config.globalProperties, t.config.globalProperties), _(e._context.components, t._context.components), _(e._context.directives, t._context.directives));
+}
+function _(e, t) {
+	for (let n of Reflect.ownKeys(t)) n in e || Object.defineProperty(e, n, Object.getOwnPropertyDescriptor(t, n));
+}
+async function v(e, t) {
+	let n = Date.now() + t;
+	do
+		if (await a(), await new Promise((e) => setTimeout(e)), e()) return !0;
+	while (Date.now() < n);
+	return e();
+}
+function y(e, t) {
+	let n = t[0], r = t.map((e) => e instanceof Error ? e.stack ?? e.message : String(e)), i = /* @__PURE__ */ Error(`${e}: ${t.length === 1 ? "one problem" : `${t.length} problems`}\n\n${r.join("\n\n")}`);
+	return n instanceof Error && (i.cause = n), i;
+}
+function b(e, t) {
+	return `[Vue warn]: ${e}${t ? `\n${t}` : ""}`;
+}
+function x(e) {
+	return e?.split(/[\\/]/).pop();
+}
+//#endregion
+export { d as testStories };

package/dist/client/app/Story.d.ts

@@ -1,5 +1,5 @@
 import type { Story } from '@poveste/shared';
-import type { PropType, VNode } from 'vue';
+import type { Component, PropType, VNode } from 'vue';
 import type { PreviewRenderContext } from './render-context.js';
 declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     initState: {
@@ -10,6 +10,14 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: PropType<Story["meta"]>;
         default: undefined;
     };
+    autoDocs: {
+        type: PropType<Story["autoDocs"]>;
+        default: undefined;
+    };
+    component: {
+        type: PropType<Component | Component[]>;
+        default: undefined;
+    };
 }>, {
     renderContext: PreviewRenderContext | null;
     story: import("vue").ComputedRef<Story>;
@@ -29,8 +37,18 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: PropType<Story["meta"]>;
         default: undefined;
     };
+    autoDocs: {
+        type: PropType<Story["autoDocs"]>;
+        default: undefined;
+    };
+    component: {
+        type: PropType<Component | Component[]>;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
+    component: Component | Component[];
     meta: import("poveste").StoryMeta | undefined;
+    autoDocs: boolean | import("poveste").AutoDocsSection[] | undefined;
     initState: () => any | Promise<any>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/client/app/Variant.d.ts

@@ -69,11 +69,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     };
 }>> & Readonly<{}>, {
     meta: import("poveste").VariantMeta | undefined;
-    initState: () => any | Promise<any>;
+    setupApp: Function;
     source: string;
     responsiveDisabled: boolean;
     autoPropsDisabled: boolean;
-    setupApp: Function;
+    initState: () => any | Promise<any>;
     implicit: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/client/app/global-components.d.ts

@@ -1,2 +1,3 @@
 import type { App } from 'vue';
 export declare function registerGlobalComponents(app: App): void;
+export declare function registerControlComponents(app: App): void;

package/dist/client/app/host.d.ts

@@ -1,4 +1,5 @@
 import type { Story, Variant } from '@poveste/shared';
+import type { App } from 'vue';
 import type { PreviewRenderContext } from './render-context.js';
 interface PreviewHostOptions {
     name: string;
@@ -7,6 +8,13 @@ interface PreviewHostOptions {
     getVariant: () => Variant | null;
     renderContext: PreviewRenderContext;
     wrapInDiv?: boolean;
+    /** A story test's: what the app would only log, it fails on. */
+    onError?: (err: unknown) => void;
+    onWarn?: (message: string, trace: string) => void;
+    /** A story test's: when the render's async setups have settled. */
+    onResolve?: () => void;
+    /** A story test's, run after the app's own registrations and setup hooks. */
+    configureApp?: (app: App) => void;
 }
 export declare function createPreviewHost(options: PreviewHostOptions): {
     mount: () => Promise<void>;

package/dist/client/app/util.d.ts

@@ -49,6 +49,22 @@ export declare function syncStateBundledAndExternal(bundledState: Record<string,
  * it appeared in the panel and warned when written.
  */
 export declare function isWritableBinding(value: unknown): boolean;
+/**
+ * A component a story holds in its setup, which implicit state skips.
+ *
+ * Each key is asked with `in` before it is read. Nuxt's runtime config is, in
+ * dev, a proxy that warns on any key it does not carry, and reading `__file`,
+ * `render` and `setup` off it printed `NUXT_E1003` three times a mount (#1454).
+ */
+export declare function isComponentBinding(value: unknown): boolean;
+/**
+ * A Vue app, or an object holding one in a data property of its own, as the
+ * Nuxt app `useNuxtApp()` returns does. Implicit state skips it: the state sync
+ * deep-watches what it holds, so it walked the whole app on every sync, as far
+ * as the dev-only `app.config.compilerOptions` getter that warns when read
+ * (#1457). Read through descriptors, so no getter runs to find out.
+ */
+export declare function holdsVueApp(value: unknown): boolean;
 export declare function useInstance(name: string): ComponentInternalInstance;
 /**
  * Warns, once, when a component built against `@poveste/vendors/vue` is