@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/runtime/as-child.js

@@ -1,66 +1,83 @@
+import { mergePartProps } from "./merge-props.js";
 import { Comment, Fragment, Text, cloneVNode } from "vue";
-import { DIAGNOSTIC_CODES, reportDiagnostic } from "@xihan-ui/kernel";
+import { isEventHandlerKey } from "@xihan-ui/core";
 //#region src/runtime/as-child.ts
 /**
-* asChild：部件不再渲染自己的包裹元素，把该挂的属性合到作者给的那个子节点上。
+* asChild：部件不再渲染自己的包裹元素，把应挂载的属性合并到作者提供的子节点上。
 *
-* 触发器类部件默认渲染 <button>，作者想用自己的按钮当触发器时，只能往 <button> 里再套一个
-* <button>——那是非法嵌套，浏览器会拆开它，事件与焦点都不对。asChild 是唯一的正解。
+* 触发器类部件默认渲染 <button>，作者需要用自己的按钮作为触发器时，只能在 <button> 中再嵌套一个
+* <button>：那是非法嵌套，浏览器会拆开它，事件与焦点都不正确。asChild 是唯一的正确方式。
 */
-/** 滤掉注释与纯文本，片段展开，只留能挂属性的节点。 */
-function attributable(nodes) {
+/** 只忽略注释、空白与空占位；片段内的可见文本同样必须明确拒绝。 */
+function attributable(nodes, scope) {
 	const out = [];
 	for (const node of nodes) {
-		if (node.type === Comment || node.type === Text) continue;
-		if (node.type === Fragment && Array.isArray(node.children)) out.push(...attributable(node.children));
+		if (node == null || typeof node === "boolean") continue;
+		if (Array.isArray(node)) {
+			out.push(...attributable(node, scope));
+			continue;
+		}
+		if (typeof node === "string" || typeof node === "number") {
+			if (typeof node === "string" && node.trim() === "") continue;
+			throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，不能包含非空文本`);
+		}
+		if (node.type === Comment) continue;
+		if (node.type === Text) {
+			if (String(node.children ?? "").trim() === "") continue;
+			throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，不能包含非空文本`);
+		}
+		if (node.type === Fragment && Array.isArray(node.children)) out.push(...attributable(node.children, scope));
 		else out.push(node);
 	}
 	return out;
 }
-/** 子节点已带角色标记：组件节点的根由它自己渲染，元素节点看有没有写 data-scope。 */
+/** 子节点已带角色标记：组件节点的根由它自己渲染，元素节点检查是否写了 data-scope。 */
 function carriesOwnAnatomy(node) {
 	return typeof node.type !== "string" || node.props?.["data-scope"] != null;
 }
 /**
-* 元素 ref 解包：子节点是组件时 ref 拿到的是组件实例，触发器要的是它的根元素。
-* 组件多根时 $el 是占位注释，那种子节点本就不适合当触发器，原样交出去由定位层报错。
+* 角色标记：解剖两位、家族标记（data-xh-*）与随视觉盒走的形态轴（data-variant）。
+* 子节点自带解剖时这些都不该落到它身上：家族标记会在封装自己的视觉盒外再画一层壳，
+* 形态轴会盖掉封装根上作者写的那一档。
+*/
+function isRoleMarker(key) {
+	return key === "data-scope" || key === "data-part" || key === "data-variant" || key.startsWith("data-xh-");
+}
+/**
+* 元素 ref 解包：子节点是组件时 ref 得到的是组件实例，触发器需要的是它的根元素。
+* 组件多根时 $el 是占位注释，该类子节点本就不适合作为触发器，原样交出由定位层报错。
 */
 function unwrapElement(value) {
 	if (value && typeof value === "object" && "$el" in value) return value.$el;
 	return value;
 }
 /**
-* 把部件属性合到作者的子节点上。
+* 把部件属性合并到作者的子节点上。
 * @param nodes 默认插槽产出
 * @param props 部件该挂的属性（含 ref）
 * @param scope 部件所属组件名，只用于诊断文案
-* @returns 合并后的节点；子节点不合规时返回 null，由调用方退回默认渲染
+* @returns 合并后的节点；子节点不合规时抛错
 */
 function mergeIntoChild(nodes, props, scope) {
-	const candidates = attributable(nodes ?? []);
-	if (candidates.length !== 1) {
-		reportDiagnostic({
-			code: DIAGNOSTIC_CODES.warn,
-			level: "warn",
-			scope,
-			message: `asChild 需要恰好一个子节点，实际是 ${candidates.length} 个；已退回默认渲染。`
-		});
-		return null;
-	}
+	const candidates = attributable(nodes ?? [], scope);
+	if (candidates.length !== 1) throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，实际是 ${candidates.length} 个`);
 	const child = candidates[0];
 	const merged = {};
 	const keepAnatomy = !carriesOwnAnatomy(child);
 	for (const [key, value] of Object.entries(props)) {
-		if (!keepAnatomy && (key === "data-scope" || key === "data-part")) continue;
+		if (!keepAnatomy && isRoleMarker(key)) continue;
 		merged[key] = value;
 	}
 	if (typeof merged.ref === "function") {
 		const inner = merged.ref;
 		merged.ref = (value) => inner(unwrapElement(value));
 	}
-	return cloneVNode(child, merged, true);
+	const cloned = cloneVNode(child, merged, true);
+	const events = mergePartProps(merged, child.props ?? {});
+	for (const key of Object.keys(events)) if (isEventHandlerKey(key)) cloned.props[key] = events[key];
+	return cloned;
 }
 //#endregion
-export { carriesOwnAnatomy, mergeIntoChild };
+export { carriesOwnAnatomy, isRoleMarker, mergeIntoChild };
 
 //# sourceMappingURL=as-child.js.map

package/dist/runtime/as-child.js.map

@@ -1 +1 @@
-{"version":3,"file":"as-child.js","names":[],"sources":["../../src/runtime/as-child.ts"],"sourcesContent":["import type { VNode } from 'vue'\nimport { DIAGNOSTIC_CODES, reportDiagnostic } from '@xihan-ui/kernel'\nimport { cloneVNode, Comment, Fragment, Text } from 'vue'\n\n/**\n * asChild：部件不再渲染自己的包裹元素，把该挂的属性合到作者给的那个子节点上。\n *\n * 触发器类部件默认渲染 <button>，作者想用自己的按钮当触发器时，只能往 <button> 里再套一个\n * <button>——那是非法嵌套，浏览器会拆开它，事件与焦点都不对。asChild 是唯一的正解。\n */\n\n/** 滤掉注释与纯文本，片段展开，只留能挂属性的节点。 */\nfunction attributable(nodes: readonly VNode[]): VNode[] {\n  const out: VNode[] = []\n  for (const node of nodes) {\n    if (node.type === Comment || node.type === Text)\n      continue\n    if (node.type === Fragment && Array.isArray(node.children))\n      out.push(...attributable(node.children as VNode[]))\n    else\n      out.push(node)\n  }\n  return out\n}\n\n/** 子节点已带角色标记：组件节点的根由它自己渲染，元素节点看有没有写 data-scope。 */\nexport function carriesOwnAnatomy(node: VNode): boolean {\n  return typeof node.type !== 'string' || node.props?.['data-scope'] != null\n}\n\n/**\n * 元素 ref 解包：子节点是组件时 ref 拿到的是组件实例，触发器要的是它的根元素。\n * 组件多根时 $el 是占位注释，那种子节点本就不适合当触发器，原样交出去由定位层报错。\n */\nfunction unwrapElement(value: unknown): unknown {\n  if (value && typeof value === 'object' && '$el' in value)\n    return (value as { $el: unknown }).$el\n  return value\n}\n\n/**\n * 把部件属性合到作者的子节点上。\n * @param nodes 默认插槽产出\n * @param props 部件该挂的属性（含 ref）\n * @param scope 部件所属组件名，只用于诊断文案\n * @returns 合并后的节点；子节点不合规时返回 null，由调用方退回默认渲染\n */\nexport function mergeIntoChild(nodes: readonly VNode[] | undefined, props: Record<string, unknown>, scope: string): VNode | null {\n  const candidates = attributable(nodes ?? [])\n  if (candidates.length !== 1) {\n    reportDiagnostic({\n      code: DIAGNOSTIC_CODES.warn,\n      level: 'warn',\n      scope,\n      message: `asChild 需要恰好一个子节点，实际是 ${candidates.length} 个；已退回默认渲染。`,\n    })\n    return null\n  }\n  const child = candidates[0]!\n\n  // 子节点自带解剖标记时不覆盖它，只落接线属性；否则整套属性都给它\n  const merged: Record<string, unknown> = {}\n  const keepAnatomy = !carriesOwnAnatomy(child)\n  for (const [key, value] of Object.entries(props)) {\n    if (!keepAnatomy && (key === 'data-scope' || key === 'data-part'))\n      continue\n    merged[key] = value\n  }\n  if (typeof merged.ref === 'function') {\n    const inner = merged.ref as (el: unknown) => void\n    merged.ref = (value: unknown) => inner(unwrapElement(value))\n  }\n  // 第三个参数让两边的 ref 都保留：作者自己的 ref 与部件的 ref 各拿各的\n  return cloneVNode(child, merged, true)\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAS,aAAa,OAAkC;CACtD,MAAM,MAAe,CAAC;CACtB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,KAAK,SAAS,WAAW,KAAK,SAAS,MACzC;EACF,IAAI,KAAK,SAAS,YAAY,MAAM,QAAQ,KAAK,QAAQ,GACvD,IAAI,KAAK,GAAG,aAAa,KAAK,QAAmB,CAAC;OAElD,IAAI,KAAK,IAAI;CACjB;CACA,OAAO;AACT;;AAGA,SAAgB,kBAAkB,MAAsB;CACtD,OAAO,OAAO,KAAK,SAAS,YAAY,KAAK,QAAQ,iBAAiB;AACxE;;;;;AAMA,SAAS,cAAc,OAAyB;CAC9C,IAAI,SAAS,OAAO,UAAU,YAAY,SAAS,OACjD,OAAQ,MAA2B;CACrC,OAAO;AACT;;;;;;;;AASA,SAAgB,eAAe,OAAqC,OAAgC,OAA6B;CAC/H,MAAM,aAAa,aAAa,SAAS,CAAC,CAAC;CAC3C,IAAI,WAAW,WAAW,GAAG;EAC3B,iBAAiB;GACf,MAAM,iBAAiB;GACvB,OAAO;GACP;GACA,SAAS,yBAAyB,WAAW,OAAO;EACtD,CAAC;EACD,OAAO;CACT;CACA,MAAM,QAAQ,WAAW;CAGzB,MAAM,SAAkC,CAAC;CACzC,MAAM,cAAc,CAAC,kBAAkB,KAAK;CAC5C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,CAAC,gBAAgB,QAAQ,gBAAgB,QAAQ,cACnD;EACF,OAAO,OAAO;CAChB;CACA,IAAI,OAAO,OAAO,QAAQ,YAAY;EACpC,MAAM,QAAQ,OAAO;EACrB,OAAO,OAAO,UAAmB,MAAM,cAAc,KAAK,CAAC;CAC7D;CAEA,OAAO,WAAW,OAAO,QAAQ,IAAI;AACvC"}
+{"version":3,"file":"as-child.js","names":[],"sources":["../../src/runtime/as-child.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 as child 相关实现。\n\nimport type { VNode, VNodeChild } from 'vue'\nimport { isEventHandlerKey } from '@xihan-ui/core'\nimport { cloneVNode, Comment, Fragment, Text } from 'vue'\nimport { mergePartProps } from './merge-props'\n\n/**\n * asChild：部件不再渲染自己的包裹元素，把应挂载的属性合并到作者提供的子节点上。\n *\n * 触发器类部件默认渲染 <button>，作者需要用自己的按钮作为触发器时，只能在 <button> 中再嵌套一个\n * <button>：那是非法嵌套，浏览器会拆开它，事件与焦点都不正确。asChild 是唯一的正确方式。\n */\n\n/** 只忽略注释、空白与空占位；片段内的可见文本同样必须明确拒绝。 */\nfunction attributable(nodes: readonly VNodeChild[], scope: string): VNode[] {\n  const out: VNode[] = []\n  for (const node of nodes) {\n    if (node == null || typeof node === 'boolean')\n      continue\n    if (Array.isArray(node)) {\n      out.push(...attributable(node, scope))\n      continue\n    }\n    if (typeof node === 'string' || typeof node === 'number') {\n      if (typeof node === 'string' && node.trim() === '')\n        continue\n      throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，不能包含非空文本`)\n    }\n    if (node.type === Comment)\n      continue\n    if (node.type === Text) {\n      if (String(node.children ?? '').trim() === '')\n        continue\n      throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，不能包含非空文本`)\n    }\n    if (node.type === Fragment && Array.isArray(node.children))\n      out.push(...attributable(node.children as VNodeChild[], scope))\n    else\n      out.push(node)\n  }\n  return out\n}\n\n/** 子节点已带角色标记：组件节点的根由它自己渲染，元素节点检查是否写了 data-scope。 */\nexport function carriesOwnAnatomy(node: VNode): boolean {\n  return typeof node.type !== 'string' || node.props?.['data-scope'] != null\n}\n\n/**\n * 角色标记：解剖两位、家族标记（data-xh-*）与随视觉盒走的形态轴（data-variant）。\n * 子节点自带解剖时这些都不该落到它身上：家族标记会在封装自己的视觉盒外再画一层壳，\n * 形态轴会盖掉封装根上作者写的那一档。\n */\nexport function isRoleMarker(key: string): boolean {\n  return key === 'data-scope' || key === 'data-part' || key === 'data-variant' || key.startsWith('data-xh-')\n}\n\n/**\n * 元素 ref 解包：子节点是组件时 ref 得到的是组件实例，触发器需要的是它的根元素。\n * 组件多根时 $el 是占位注释，该类子节点本就不适合作为触发器，原样交出由定位层报错。\n */\nfunction unwrapElement(value: unknown): unknown {\n  if (value && typeof value === 'object' && '$el' in value)\n    return (value as { $el: unknown }).$el\n  return value\n}\n\n/**\n * 把部件属性合并到作者的子节点上。\n * @param nodes 默认插槽产出\n * @param props 部件该挂的属性（含 ref）\n * @param scope 部件所属组件名，只用于诊断文案\n * @returns 合并后的节点；子节点不合规时抛错\n */\nexport function mergeIntoChild(nodes: readonly VNode[] | undefined, props: Record<string, unknown>, scope: string): VNode {\n  const candidates = attributable(nodes ?? [], scope)\n  if (candidates.length !== 1)\n    throw new Error(`[xh] ${scope} asChild 需要恰好一个可挂载子节点，实际是 ${candidates.length} 个`)\n  const child = candidates[0]!\n\n  // 子节点自带解剖标记时不覆盖它，只落接线属性；否则整套属性都给它\n  const merged: Record<string, unknown> = {}\n  const keepAnatomy = !carriesOwnAnatomy(child)\n  for (const [key, value] of Object.entries(props)) {\n    if (!keepAnatomy && isRoleMarker(key))\n      continue\n    merged[key] = value\n  }\n  if (typeof merged.ref === 'function') {\n    const inner = merged.ref as (el: unknown) => void\n    merged.ref = (value: unknown) => inner(unwrapElement(value))\n  }\n  // 第三个参数让两边的 ref 都保留：作者自己的 ref 与部件的 ref 各拿各的。\n  // cloneVNode 把子节点自己的同名处理器排在传进来这一份的前面，也就是作者先跑、部件后跑；\n  // 传进来的 props 已经把写在部件上的那一份按同一个先后合过（mergePartProps），\n  // 所以写在子节点上还是写在部件上，作者的处理器都在部件之前。\n  const cloned = cloneVNode(child, merged, true)\n  // cloneVNode 默认无条件串接事件；改用作者可取消的部件合并，其他属性和双方 ref 保留。\n  const events = mergePartProps(merged, child.props ?? {})\n  for (const key of Object.keys(events)) {\n    if (isEventHandlerKey(key))\n      cloned.props![key] = events[key]\n  }\n  return cloned\n}\n"],"mappings":";;;;;;;;;;;AAoBA,SAAS,aAAa,OAA8B,OAAwB;CAC1E,MAAM,MAAe,CAAC;CACtB,KAAK,MAAM,QAAQ,OAAO;EACxB,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAClC;EACF,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,IAAI,KAAK,GAAG,aAAa,MAAM,KAAK,CAAC;GACrC;EACF;EACA,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAAU;GACxD,IAAI,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,IAC9C;GACF,MAAM,IAAI,MAAM,QAAQ,MAAM,+BAA+B;EAC/D;EACA,IAAI,KAAK,SAAS,SAChB;EACF,IAAI,KAAK,SAAS,MAAM;GACtB,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,KAAK,MAAM,IACzC;GACF,MAAM,IAAI,MAAM,QAAQ,MAAM,+BAA+B;EAC/D;EACA,IAAI,KAAK,SAAS,YAAY,MAAM,QAAQ,KAAK,QAAQ,GACvD,IAAI,KAAK,GAAG,aAAa,KAAK,UAA0B,KAAK,CAAC;OAE9D,IAAI,KAAK,IAAI;CACjB;CACA,OAAO;AACT;;AAGA,SAAgB,kBAAkB,MAAsB;CACtD,OAAO,OAAO,KAAK,SAAS,YAAY,KAAK,QAAQ,iBAAiB;AACxE;;;;;;AAOA,SAAgB,aAAa,KAAsB;CACjD,OAAO,QAAQ,gBAAgB,QAAQ,eAAe,QAAQ,kBAAkB,IAAI,WAAW,UAAU;AAC3G;;;;;AAMA,SAAS,cAAc,OAAyB;CAC9C,IAAI,SAAS,OAAO,UAAU,YAAY,SAAS,OACjD,OAAQ,MAA2B;CACrC,OAAO;AACT;;;;;;;;AASA,SAAgB,eAAe,OAAqC,OAAgC,OAAsB;CACxH,MAAM,aAAa,aAAa,SAAS,CAAC,GAAG,KAAK;CAClD,IAAI,WAAW,WAAW,GACxB,MAAM,IAAI,MAAM,QAAQ,MAAM,4BAA4B,WAAW,OAAO,GAAG;CACjF,MAAM,QAAQ,WAAW;CAGzB,MAAM,SAAkC,CAAC;CACzC,MAAM,cAAc,CAAC,kBAAkB,KAAK;CAC5C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,CAAC,eAAe,aAAa,GAAG,GAClC;EACF,OAAO,OAAO;CAChB;CACA,IAAI,OAAO,OAAO,QAAQ,YAAY;EACpC,MAAM,QAAQ,OAAO;EACrB,OAAO,OAAO,UAAmB,MAAM,cAAc,KAAK,CAAC;CAC7D;CAKA,MAAM,SAAS,WAAW,OAAO,QAAQ,IAAI;CAE7C,MAAM,SAAS,eAAe,QAAQ,MAAM,SAAS,CAAC,CAAC;CACvD,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,IAAI,kBAAkB,GAAG,GACvB,OAAO,MAAO,OAAO,OAAO;CAEhC,OAAO;AACT"}

package/dist/runtime/attach-form-reset.js

@@ -1,12 +1,11 @@
 import { getCurrentInstance, onBeforeUnmount, onMounted } from "vue";
-import { FORM_RESET_EVENT, declaresFormReset } from "@xihan-ui/machine";
-import { createFormResetBridge } from "@xihan-ui/behavior";
+import { FORM_RESET_EVENT, createFormResetBridge, declaresFormReset } from "@xihan-ui/core";
 //#region src/runtime/attach-form-reset.ts
 /**
-* 认表单重置的机器，挂一座桥把宿主表单的 reset 翻成机器事件。
+* 识别表单重置的状态机，架设一座桥把宿主表单的 reset 转换为状态机事件。
 *
-* 锚点取组件自己渲染出的根元素，传 getter 不传节点：重渲会换掉它。
-* 组合式函数被拿到组件外用时既没有挂载钩子也没有节点，整段让位。
+* 锚点取组件自己渲染出的根元素，传 getter 而不是节点：重渲会替换它。
+* 组合式函数在组件外使用时既没有挂载钩子也没有节点，整段让位。
 */
 function attachFormReset(service) {
 	const instance = getCurrentInstance();
@@ -15,6 +14,7 @@ function attachFormReset(service) {
 	onMounted(() => {
 		bridge = createFormResetBridge({
 			getNode: () => instance.vnode.el,
+			getFormId: () => service.prop("form"),
 			onReset: () => {
 				if (service.getStatus() === "Started") service.send({ type: FORM_RESET_EVENT });
 			}

package/dist/runtime/attach-form-reset.js.map

@@ -1 +1 @@
-{"version":3,"file":"attach-form-reset.js","names":[],"sources":["../../src/runtime/attach-form-reset.ts"],"sourcesContent":["import type { Disposable } from '@xihan-ui/kernel'\nimport type { MachineSchema, Service } from '@xihan-ui/machine'\nimport { createFormResetBridge } from '@xihan-ui/behavior'\nimport { declaresFormReset, FORM_RESET_EVENT } from '@xihan-ui/machine'\nimport { getCurrentInstance, onBeforeUnmount, onMounted } from 'vue'\n\n/**\n * 认表单重置的机器，挂一座桥把宿主表单的 reset 翻成机器事件。\n *\n * 锚点取组件自己渲染出的根元素，传 getter 不传节点：重渲会换掉它。\n * 组合式函数被拿到组件外用时既没有挂载钩子也没有节点，整段让位。\n */\nexport function attachFormReset<T extends MachineSchema>(service: Service<T>): void {\n  const instance = getCurrentInstance()\n  if (!instance || !declaresFormReset(service.machine))\n    return\n\n  let bridge: Disposable | null = null\n  // 注册在 createService 那次 onMounted 之后，因此跑在它之后，status 已经是 Started\n  onMounted(() => {\n    bridge = createFormResetBridge({\n      getNode: () => instance.vnode.el as Node | null,\n      onReset: () => {\n        if (service.getStatus() === 'Started')\n          service.send({ type: FORM_RESET_EVENT } as T['event'])\n      },\n    })\n  })\n  onBeforeUnmount(() => {\n    bridge?.dispose()\n    bridge = null\n  })\n}\n"],"mappings":";;;;;;;;;;AAYA,SAAgB,gBAAyC,SAA2B;CAClF,MAAM,WAAW,mBAAmB;CACpC,IAAI,CAAC,YAAY,CAAC,kBAAkB,QAAQ,OAAO,GACjD;CAEF,IAAI,SAA4B;CAEhC,gBAAgB;EACd,SAAS,sBAAsB;GAC7B,eAAe,SAAS,MAAM;GAC9B,eAAe;IACb,IAAI,QAAQ,UAAU,MAAM,WAC1B,QAAQ,KAAK,EAAE,MAAM,iBAAiB,CAAe;GACzD;EACF,CAAC;CACH,CAAC;CACD,sBAAsB;EACpB,QAAQ,QAAQ;EAChB,SAAS;CACX,CAAC;AACH"}
+{"version":3,"file":"attach-form-reset.js","names":[],"sources":["../../src/runtime/attach-form-reset.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 attach form reset 相关实现。\n\nimport type { Disposable, MachineSchema, Service } from '@xihan-ui/core'\nimport { createFormResetBridge, declaresFormReset, FORM_RESET_EVENT } from '@xihan-ui/core'\nimport { getCurrentInstance, onBeforeUnmount, onMounted } from 'vue'\n\n/**\n * 识别表单重置的状态机，架设一座桥把宿主表单的 reset 转换为状态机事件。\n *\n * 锚点取组件自己渲染出的根元素，传 getter 而不是节点：重渲会替换它。\n * 组合式函数在组件外使用时既没有挂载钩子也没有节点，整段让位。\n */\nexport function attachFormReset<T extends MachineSchema>(service: Service<T>): void {\n  const instance = getCurrentInstance()\n  if (!instance || !declaresFormReset(service.machine))\n    return\n\n  let bridge: Disposable | null = null\n  // 注册在 createService 那次 onMounted 之后，因此跑在它之后，status 已经是 Started\n  onMounted(() => {\n    bridge = createFormResetBridge({\n      getNode: () => instance.vnode.el as Node | null,\n      getFormId: () => service.prop('form') as string | undefined,\n      onReset: () => {\n        if (service.getStatus() === 'Started')\n          service.send({ type: FORM_RESET_EVENT } as T['event'])\n      },\n    })\n  })\n  onBeforeUnmount(() => {\n    bridge?.dispose()\n    bridge = null\n  })\n}\n"],"mappings":";;;;;;;;;AAiBA,SAAgB,gBAAyC,SAA2B;CAClF,MAAM,WAAW,mBAAmB;CACpC,IAAI,CAAC,YAAY,CAAC,kBAAkB,QAAQ,OAAO,GACjD;CAEF,IAAI,SAA4B;CAEhC,gBAAgB;EACd,SAAS,sBAAsB;GAC7B,eAAe,SAAS,MAAM;GAC9B,iBAAiB,QAAQ,KAAK,MAAM;GACpC,eAAe;IACb,IAAI,QAAQ,UAAU,MAAM,WAC1B,QAAQ,KAAK,EAAE,MAAM,iBAAiB,CAAe;GACzD;EACF,CAAC;CACH,CAAC;CACD,sBAAsB;EACpB,QAAQ,QAAQ;EAChB,SAAS;CACX,CAAC;AACH"}

package/dist/runtime/config-defaults.js

@@ -2,8 +2,8 @@ import { useXhConfig } from "../config/config.js";
 import { fillXhConfigDefaults } from "@xihan-ui/headless";
 //#region src/runtime/config-defaults.ts
 /**
-* 把全局配置垫进一份机器 props：locale 与 size 在实例没给时回落全局，
-* translations 按组件名分桶、仍走 withXhConfig。一个都没填时原样返回。
+* 把全局配置合入一份状态机 props：locale 与 size 在实例未提供时回落全局，
+* translations 按组件名分桶、仍经 withXhConfig。全部未填时原样返回。
 */
 function applyXhConfigDefaults(machine, props, config) {
 	return fillXhConfigDefaults(machine, props, config);

package/dist/runtime/config-defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-defaults.js","names":[],"sources":["../../src/runtime/config-defaults.ts"],"sourcesContent":["import type { XhConfig } from '../config/config'\nimport { fillXhConfigDefaults } from '@xihan-ui/headless'\nimport { useXhConfig } from '../config/config'\n\n/**\n * 把全局配置垫进一份机器 props：locale 与 size 在实例没给时回落全局，\n * translations 按组件名分桶、仍走 withXhConfig。一个都没填时原样返回。\n */\nexport function applyXhConfigDefaults<T extends object>(machine: string, props: T, config: XhConfig): T {\n  return fillXhConfigDefaults(machine, props, config)\n}\n\n/** 取当前作用域的配置读取器；只能在 setup 期调用。 */\nexport function useXhConfigDefaults(): () => XhConfig {\n  const config = useXhConfig()\n  return () => config.value\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,sBAAwC,SAAiB,OAAU,QAAqB;CACtG,OAAO,qBAAqB,SAAS,OAAO,MAAM;AACpD;;AAGA,SAAgB,sBAAsC;CACpD,MAAM,SAAS,YAAY;CAC3B,aAAa,OAAO;AACtB"}
+{"version":3,"file":"config-defaults.js","names":[],"sources":["../../src/runtime/config-defaults.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 配置 config defaults。\n\nimport type { XhConfig } from '../config/config'\nimport { fillXhConfigDefaults } from '@xihan-ui/headless'\nimport { useXhConfig } from '../config/config'\n\n/**\n * 把全局配置合入一份状态机 props：locale 与 size 在实例未提供时回落全局，\n * translations 按组件名分桶、仍经 withXhConfig。全部未填时原样返回。\n */\nexport function applyXhConfigDefaults<T extends object>(machine: string, props: T, config: XhConfig): T {\n  return fillXhConfigDefaults(machine, props, config)\n}\n\n/** 取当前作用域的配置读取器；只能在 setup 期调用。 */\nexport function useXhConfigDefaults(): () => XhConfig {\n  const config = useXhConfig()\n  return () => config.value\n}\n"],"mappings":";;;;;;;AAeA,SAAgB,sBAAwC,SAAiB,OAAU,QAAqB;CACtG,OAAO,qBAAqB,SAAS,OAAO,MAAM;AACpD;;AAGA,SAAgB,sBAAsC;CACpD,MAAM,SAAS,YAAY;CAC3B,aAAa,OAAO;AACtB"}

package/dist/runtime/create-vue-runtime.d.ts

@@ -1,6 +1,17 @@
-import { ReactiveRuntime } from "@xihan-ui/machine";
+import { ReactiveRuntime } from "@xihan-ui/core";
 //#region src/runtime/create-vue-runtime.d.ts
-declare function createVueRuntime(): ReactiveRuntime;
+interface VueRuntimeOptions {
+  /**
+   * 机器何时 start。缺省 'mounted'：等宿主组件挂载、节点落定后再进初态，
+   * 组件的机器效应（浮层定位、焦点域）一进初态就读自己的节点。
+   * 'setup' 在 setup 里当场 start，只给没有 DOM 锚点的机器（命令式服务宿主的队列机器）：
+   * 宿主的 mounted 回调排在 Vue 的 post-flush 队列里，从业务组件的 onMounted 懒建宿主时
+   * 会被追加到那条队列的队尾，要等调用方的 onMounted 返回后才跑；而服务端口在 setup 已接上，
+   * 中间发出的命令会撞上 SEND_BEFORE_MOUNT。组件外调用时没有挂载钩子，两种取值都当场 start。
+   */
+  start?: 'mounted' | 'setup';
+}
+declare function createVueRuntime(options?: VueRuntimeOptions): ReactiveRuntime;
 //#endregion
-export { createVueRuntime };
+export { VueRuntimeOptions, createVueRuntime };
 //# sourceMappingURL=create-vue-runtime.d.ts.map

package/dist/runtime/create-vue-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-vue-runtime.d.ts","names":[],"sources":["../../src/runtime/create-vue-runtime.ts"],"mappings":";;iBAIgB,oBAAoB"}
+{"version":3,"file":"create-vue-runtime.d.ts","names":[],"sources":["../../src/runtime/create-vue-runtime.ts"],"mappings":";;UAUiB;;;;;;;;;EASf;;iBAIc,iBAAiB,UAAS,oBAAyB"}

package/dist/runtime/create-vue-runtime.js

@@ -1,6 +1,7 @@
 import { getCurrentInstance, nextTick, onBeforeUnmount, onMounted, shallowRef, triggerRef, watch } from "vue";
 //#region src/runtime/create-vue-runtime.ts
-function createVueRuntime() {
+function createVueRuntime(options = {}) {
+	const startInSetup = options.start === "setup";
 	return {
 		name: "vue",
 		isServer: typeof window === "undefined",
@@ -49,7 +50,7 @@ function createVueRuntime() {
 			nextTick(() => nextTick(fn));
 		},
 		onMount(fn) {
-			if (getCurrentInstance()) onMounted(fn);
+			if (getCurrentInstance() && !startInSetup) onMounted(fn);
 			else fn();
 		},
 		onCleanup(fn) {

package/dist/runtime/create-vue-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-vue-runtime.js","names":[],"sources":["../../src/runtime/create-vue-runtime.ts"],"sourcesContent":["import type { Bindable, CellParams, Dep, ReactiveRuntime } from '@xihan-ui/machine'\nimport { getCurrentInstance, nextTick, onBeforeUnmount, onMounted, shallowRef, triggerRef, watch } from 'vue'\n\n// 用 Vue 响应式实现 machine 的 ReactiveRuntime\nexport function createVueRuntime(): ReactiveRuntime {\n  return {\n    name: 'vue',\n    isServer: typeof window === 'undefined',\n\n    cell<V>(params: () => CellParams<V>): Bindable<V> {\n      const p0 = params()\n      const initial = (p0.defaultValue ?? p0.value) as V\n      const eq = p0.isEqual ?? Object.is\n      const inner = shallowRef<V>(initial)\n      let lastSeen = initial\n      let version = 0\n\n      const isControlled = (): boolean => params().value !== undefined\n      const read = (): V => (isControlled() ? (params().value as V) : inner.value)\n\n      const set = (next: V | ((prev: V) => V)): void => {\n        const prev = read()\n        const value = typeof next === 'function' ? (next as (p: V) => V)(prev) : next\n        if (!isControlled())\n          inner.value = value\n        if (!eq(value, prev))\n          params().onChange?.(value, prev)\n      }\n\n      return {\n        initial,\n        get: read,\n        set,\n        // 落点按当下 props 重算，不用挂载时冻结的 initial：宿主换了 defaultValue\n        // （比如切去编辑另一条记录）就该回到新的那一份\n        reset() {\n          const next = params().defaultValue\n          if (next === undefined)\n            return undefined\n          set(next)\n          return next\n        },\n        notify() {\n          triggerRef(inner)\n        },\n        version() {\n          const cur = read()\n          if (!eq(cur, lastSeen)) {\n            lastSeen = cur\n            version += 1\n          }\n          return version\n        },\n      }\n    },\n\n    track(deps: Dep[], fn) {\n      watch(deps, fn, { flush: 'pre' })\n    },\n    flush(fn) {\n      // 先让出一次微任务，等这次转移把渲染排上队，再等那一轮渲染跑完才回调\n      void nextTick(() => nextTick(fn))\n    },\n    onMount(fn) {\n      if (getCurrentInstance())\n        onMounted(fn)\n      else\n        fn()\n    },\n    onCleanup(fn) {\n      if (getCurrentInstance())\n        onBeforeUnmount(fn)\n    },\n  }\n}\n"],"mappings":";;AAIA,SAAgB,mBAAoC;CAClD,OAAO;EACL,MAAM;EACN,UAAU,OAAO,WAAW;EAE5B,KAAQ,QAA0C;GAChD,MAAM,KAAK,OAAO;GAClB,MAAM,UAAW,GAAG,gBAAgB,GAAG;GACvC,MAAM,KAAK,GAAG,WAAW,OAAO;GAChC,MAAM,QAAQ,WAAc,OAAO;GACnC,IAAI,WAAW;GACf,IAAI,UAAU;GAEd,MAAM,qBAA8B,OAAO,CAAC,CAAC,UAAU,KAAA;GACvD,MAAM,aAAiB,aAAa,IAAK,OAAO,CAAC,CAAC,QAAc,MAAM;GAEtE,MAAM,OAAO,SAAqC;IAChD,MAAM,OAAO,KAAK;IAClB,MAAM,QAAQ,OAAO,SAAS,aAAc,KAAqB,IAAI,IAAI;IACzE,IAAI,CAAC,aAAa,GAChB,MAAM,QAAQ;IAChB,IAAI,CAAC,GAAG,OAAO,IAAI,GACjB,OAAO,CAAC,CAAC,WAAW,OAAO,IAAI;GACnC;GAEA,OAAO;IACL;IACA,KAAK;IACL;IAGA,QAAQ;KACN,MAAM,OAAO,OAAO,CAAC,CAAC;KACtB,IAAI,SAAS,KAAA,GACX,OAAO,KAAA;KACT,IAAI,IAAI;KACR,OAAO;IACT;IACA,SAAS;KACP,WAAW,KAAK;IAClB;IACA,UAAU;KACR,MAAM,MAAM,KAAK;KACjB,IAAI,CAAC,GAAG,KAAK,QAAQ,GAAG;MACtB,WAAW;MACX,WAAW;KACb;KACA,OAAO;IACT;GACF;EACF;EAEA,MAAM,MAAa,IAAI;GACrB,MAAM,MAAM,IAAI,EAAE,OAAO,MAAM,CAAC;EAClC;EACA,MAAM,IAAI;GAER,eAAoB,SAAS,EAAE,CAAC;EAClC;EACA,QAAQ,IAAI;GACV,IAAI,mBAAmB,GACrB,UAAU,EAAE;QAEZ,GAAG;EACP;EACA,UAAU,IAAI;GACZ,IAAI,mBAAmB,GACrB,gBAAgB,EAAE;EACtB;CACF;AACF"}
+{"version":3,"file":"create-vue-runtime.js","names":[],"sources":["../../src/runtime/create-vue-runtime.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 create vue runtime 相关实现。\n\nimport type { Bindable, CellParams, Dep, ReactiveRuntime } from '@xihan-ui/core'\nimport { getCurrentInstance, nextTick, onBeforeUnmount, onMounted, shallowRef, triggerRef, watch } from 'vue'\n\nexport interface VueRuntimeOptions {\n  /**\n   * 机器何时 start。缺省 'mounted'：等宿主组件挂载、节点落定后再进初态，\n   * 组件的机器效应（浮层定位、焦点域）一进初态就读自己的节点。\n   * 'setup' 在 setup 里当场 start，只给没有 DOM 锚点的机器（命令式服务宿主的队列机器）：\n   * 宿主的 mounted 回调排在 Vue 的 post-flush 队列里，从业务组件的 onMounted 懒建宿主时\n   * 会被追加到那条队列的队尾，要等调用方的 onMounted 返回后才跑；而服务端口在 setup 已接上，\n   * 中间发出的命令会撞上 SEND_BEFORE_MOUNT。组件外调用时没有挂载钩子，两种取值都当场 start。\n   */\n  start?: 'mounted' | 'setup'\n}\n\n// 用 Vue 响应式实现 machine 的 ReactiveRuntime\nexport function createVueRuntime(options: VueRuntimeOptions = {}): ReactiveRuntime {\n  const startInSetup = options.start === 'setup'\n  return {\n    name: 'vue',\n    isServer: typeof window === 'undefined',\n\n    cell<V>(params: () => CellParams<V>): Bindable<V> {\n      const p0 = params()\n      const initial = (p0.defaultValue ?? p0.value) as V\n      const eq = p0.isEqual ?? Object.is\n      const inner = shallowRef<V>(initial)\n      let lastSeen = initial\n      let version = 0\n\n      const isControlled = (): boolean => params().value !== undefined\n      const read = (): V => (isControlled() ? (params().value as V) : inner.value)\n\n      const set = (next: V | ((prev: V) => V)): void => {\n        const prev = read()\n        const value = typeof next === 'function' ? (next as (p: V) => V)(prev) : next\n        if (!isControlled())\n          inner.value = value\n        if (!eq(value, prev))\n          params().onChange?.(value, prev)\n      }\n\n      return {\n        initial,\n        get: read,\n        set,\n        // 落点按当下 props 重算，不用挂载时冻结的 initial：宿主换了 defaultValue\n        // （比如切去编辑另一条记录）就该回到新的那一份\n        reset() {\n          const next = params().defaultValue\n          if (next === undefined)\n            return undefined\n          set(next)\n          return next\n        },\n        notify() {\n          triggerRef(inner)\n        },\n        version() {\n          const cur = read()\n          if (!eq(cur, lastSeen)) {\n            lastSeen = cur\n            version += 1\n          }\n          return version\n        },\n      }\n    },\n\n    track(deps: Dep[], fn) {\n      watch(deps, fn, { flush: 'pre' })\n    },\n    flush(fn) {\n      // 先让出一次微任务，等这次转移把渲染排上队，再等那一轮渲染跑完才回调\n      void nextTick(() => nextTick(fn))\n    },\n    onMount(fn) {\n      if (getCurrentInstance() && !startInSetup)\n        onMounted(fn)\n      else\n        fn()\n    },\n    onCleanup(fn) {\n      if (getCurrentInstance())\n        onBeforeUnmount(fn)\n    },\n  }\n}\n"],"mappings":";;AAuBA,SAAgB,iBAAiB,UAA6B,CAAC,GAAoB;CACjF,MAAM,eAAe,QAAQ,UAAU;CACvC,OAAO;EACL,MAAM;EACN,UAAU,OAAO,WAAW;EAE5B,KAAQ,QAA0C;GAChD,MAAM,KAAK,OAAO;GAClB,MAAM,UAAW,GAAG,gBAAgB,GAAG;GACvC,MAAM,KAAK,GAAG,WAAW,OAAO;GAChC,MAAM,QAAQ,WAAc,OAAO;GACnC,IAAI,WAAW;GACf,IAAI,UAAU;GAEd,MAAM,qBAA8B,OAAO,CAAC,CAAC,UAAU,KAAA;GACvD,MAAM,aAAiB,aAAa,IAAK,OAAO,CAAC,CAAC,QAAc,MAAM;GAEtE,MAAM,OAAO,SAAqC;IAChD,MAAM,OAAO,KAAK;IAClB,MAAM,QAAQ,OAAO,SAAS,aAAc,KAAqB,IAAI,IAAI;IACzE,IAAI,CAAC,aAAa,GAChB,MAAM,QAAQ;IAChB,IAAI,CAAC,GAAG,OAAO,IAAI,GACjB,OAAO,CAAC,CAAC,WAAW,OAAO,IAAI;GACnC;GAEA,OAAO;IACL;IACA,KAAK;IACL;IAGA,QAAQ;KACN,MAAM,OAAO,OAAO,CAAC,CAAC;KACtB,IAAI,SAAS,KAAA,GACX,OAAO,KAAA;KACT,IAAI,IAAI;KACR,OAAO;IACT;IACA,SAAS;KACP,WAAW,KAAK;IAClB;IACA,UAAU;KACR,MAAM,MAAM,KAAK;KACjB,IAAI,CAAC,GAAG,KAAK,QAAQ,GAAG;MACtB,WAAW;MACX,WAAW;KACb;KACA,OAAO;IACT;GACF;EACF;EAEA,MAAM,MAAa,IAAI;GACrB,MAAM,MAAM,IAAI,EAAE,OAAO,MAAM,CAAC;EAClC;EACA,MAAM,IAAI;GAER,eAAoB,SAAS,EAAE,CAAC;EAClC;EACA,QAAQ,IAAI;GACV,IAAI,mBAAmB,KAAK,CAAC,cAC3B,UAAU,EAAE;QAEZ,GAAG;EACP;EACA,UAAU,IAAI;GACZ,IAAI,mBAAmB,GACrB,gBAAgB,EAAE;EACtB;CACF;AACF"}

package/dist/runtime/merge-props.js

@@ -0,0 +1,31 @@
+import { mergeProps } from "vue";
+import { isEventHandlerKey } from "@xihan-ui/core";
+//#region src/runtime/merge-props.ts
+/** 摊平为数组：Vue 的直通属性中同名处理器可能已经是一组。 */
+function handlers(value) {
+	if (value == null) return [];
+	return (Array.isArray(value) ? value : [value]).filter((fn) => typeof fn === "function");
+}
+/**
+* 把部件接线与作者写在部件上的属性合并为一份。
+*
+* 同名事件处理器作者的排在前面先运行、部件的后运行，作者因此能在部件动作之前拦截事件；
+* class 与 style 两边都保留，其余普通值以作者的为准。
+*/
+function mergePartProps(part, author) {
+	const merged = mergeProps(part, author);
+	for (const key of Object.keys(merged)) {
+		if (!isEventHandlerKey(key)) continue;
+		const theirs = handlers(author[key]);
+		const ours = handlers(part[key]);
+		if (theirs.length > 0 && ours.length > 0) merged[key] = [...theirs, ...ours.map((handler) => (...args) => {
+			if (args[0]?.defaultPrevented) return;
+			handler(...args);
+		})];
+	}
+	return merged;
+}
+//#endregion
+export { mergePartProps };
+
+//# sourceMappingURL=merge-props.js.map

package/dist/runtime/merge-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-props.js","names":["mergeVueProps"],"sources":["../../src/runtime/merge-props.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 merge props 相关实现。\n\nimport { isEventHandlerKey } from '@xihan-ui/core'\nimport { mergeProps as mergeVueProps } from 'vue'\n\ntype Props = Record<string, unknown>\n\n/** 摊平为数组：Vue 的直通属性中同名处理器可能已经是一组。 */\nfunction handlers(value: unknown): unknown[] {\n  if (value == null)\n    return []\n  const list = Array.isArray(value) ? value : [value]\n  return list.filter(fn => typeof fn === 'function')\n}\n\n/**\n * 把部件接线与作者写在部件上的属性合并为一份。\n *\n * 同名事件处理器作者的排在前面先运行、部件的后运行，作者因此能在部件动作之前拦截事件；\n * class 与 style 两边都保留，其余普通值以作者的为准。\n */\nexport function mergePartProps(part: Props, author: Props): Props {\n  const merged = mergeVueProps(part, author) as Props\n  for (const key of Object.keys(merged)) {\n    if (!isEventHandlerKey(key))\n      continue\n    const theirs = handlers(author[key])\n    const ours = handlers(part[key])\n    if (theirs.length > 0 && ours.length > 0) {\n      // 保留数组形态，让 Vue 继续处理每个回调的异常及 stopImmediatePropagation。\n      merged[key] = [...theirs, ...ours.map(handler => (...args: unknown[]) => {\n        if ((args[0] as { defaultPrevented?: boolean } | null | undefined)?.defaultPrevented)\n          return\n        (handler as (...args: unknown[]) => void)(...args)\n      })]\n    }\n  }\n  return merged\n}\n"],"mappings":";;;;AAaA,SAAS,SAAS,OAA2B;CAC3C,IAAI,SAAS,MACX,OAAO,CAAC;CAEV,QADa,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAA,CACtC,QAAO,OAAM,OAAO,OAAO,UAAU;AACnD;;;;;;;AAQA,SAAgB,eAAe,MAAa,QAAsB;CAChE,MAAM,SAASA,WAAc,MAAM,MAAM;CACzC,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,IAAI,CAAC,kBAAkB,GAAG,GACxB;EACF,MAAM,SAAS,SAAS,OAAO,IAAI;EACnC,MAAM,OAAO,SAAS,KAAK,IAAI;EAC/B,IAAI,OAAO,SAAS,KAAK,KAAK,SAAS,GAErC,OAAO,OAAO,CAAC,GAAG,QAAQ,GAAG,KAAK,KAAI,aAAY,GAAG,SAAoB;GACvE,IAAK,KAAK,EAAE,EAAwD,kBAClE;GACF,QAA0C,GAAG,IAAI;EACnD,CAAC,CAAC;CAEN;CACA,OAAO;AACT"}

package/dist/runtime/normalize-props.d.ts

@@ -1,5 +1,5 @@
 //#region src/runtime/normalize-props.d.ts
-declare const vueNormalize: import("@xihan-ui/kernel").NormalizeProps<import("@xihan-ui/kernel").PropTypes<import("@xihan-ui/kernel").Dict>>;
+declare const vueNormalize: import("@xihan-ui/core").NormalizeProps<import("@xihan-ui/core").PropTypes<import("@xihan-ui/core").Dict>>;
 //#endregion
 export { vueNormalize };
 //# sourceMappingURL=normalize-props.d.ts.map

package/dist/runtime/normalize-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-props.d.ts","names":[],"sources":["../../src/runtime/normalize-props.ts"],"mappings":";cAca,yCAAY,0CAAA,qCAAA"}
+{"version":3,"file":"normalize-props.d.ts","names":[],"sources":["../../src/runtime/normalize-props.ts"],"mappings":";cAqBa,uCAAY,wCAAA,mCAAA"}

package/dist/runtime/normalize-props.js

@@ -1,4 +1,4 @@
-import { createNormalizer } from "@xihan-ui/kernel";
+import { createNormalizer } from "@xihan-ui/core";
 //#region src/runtime/normalize-props.ts
 function normalizeEventKey(key) {
 	if (key.length > 2 && key.startsWith("on") && key[2] >= "A" && key[2] <= "Z") return `on${key[2]}${key.slice(3).toLowerCase()}`;

package/dist/runtime/normalize-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-props.js","names":[],"sources":["../../src/runtime/normalize-props.ts"],"sourcesContent":["import { createNormalizer } from '@xihan-ui/kernel'\n\n// 事件名归一为 on + 首字母大写 + 其余小写（onKeyDown → onKeydown），与 WC 适配器对齐\nfunction normalizeEventKey(key: string): string {\n  if (key.length > 2 && key.startsWith('on') && key[2]! >= 'A' && key[2]! <= 'Z')\n    return `on${key[2]}${key.slice(3).toLowerCase()}`\n  return key\n}\n\n// Vue 内建的布尔属性表里没有 inert，true 会被写成 inert=\"true\"，而 WC 侧走 toggleAttribute\n// 得到的是空串。属性在场即生效，两种写法行为一致，但两个适配器的 DOM 必须逐字一样。\nconst BOOLEAN_ATTRS = new Set(['inert'])\n\n// 其余属性原样透传\nexport const vueNormalize = createNormalizer((props) => {\n  const out: Record<string, unknown> = {}\n  for (const key of Object.keys(props)) {\n    const value = props[key]\n    out[normalizeEventKey(key)] = BOOLEAN_ATTRS.has(key) && value === true ? '' : value\n  }\n  return out\n})\n"],"mappings":";;AAGA,SAAS,kBAAkB,KAAqB;CAC9C,IAAI,IAAI,SAAS,KAAK,IAAI,WAAW,IAAI,KAAK,IAAI,MAAO,OAAO,IAAI,MAAO,KACzE,OAAO,KAAK,IAAI,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY;CAChD,OAAO;AACT;AAIA,MAAM,gCAAgB,IAAI,IAAI,CAAC,OAAO,CAAC;AAGvC,MAAa,eAAe,kBAAkB,UAAU;CACtD,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EACpC,MAAM,QAAQ,MAAM;EACpB,IAAI,kBAAkB,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,UAAU,OAAO,KAAK;CAChF;CACA,OAAO;AACT,CAAC"}
+{"version":3,"file":"normalize-props.js","names":[],"sources":["../../src/runtime/normalize-props.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 normalize props 相关实现。\n\nimport { createNormalizer } from '@xihan-ui/core'\n\n// 事件名归一为 on + 首字母大写 + 其余小写（onKeyDown → onKeydown），与 WC 适配器对齐\nfunction normalizeEventKey(key: string): string {\n  if (key.length > 2 && key.startsWith('on') && key[2]! >= 'A' && key[2]! <= 'Z')\n    return `on${key[2]}${key.slice(3).toLowerCase()}`\n  return key\n}\n\n// Vue 内建的布尔属性表里没有 inert，true 会被写成 inert=\"true\"，而 WC 侧走 toggleAttribute\n// 得到的是空串。属性在场即生效，两种写法行为一致，但两个适配器的 DOM 必须逐字一样。\nconst BOOLEAN_ATTRS = new Set(['inert'])\n\n// 其余属性原样透传\nexport const vueNormalize = createNormalizer((props) => {\n  const out: Record<string, unknown> = {}\n  for (const key of Object.keys(props)) {\n    const value = props[key]\n    out[normalizeEventKey(key)] = BOOLEAN_ATTRS.has(key) && value === true ? '' : value\n  }\n  return out\n})\n"],"mappings":";;AAUA,SAAS,kBAAkB,KAAqB;CAC9C,IAAI,IAAI,SAAS,KAAK,IAAI,WAAW,IAAI,KAAK,IAAI,MAAO,OAAO,IAAI,MAAO,KACzE,OAAO,KAAK,IAAI,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY;CAChD,OAAO;AACT;AAIA,MAAM,gCAAgB,IAAI,IAAI,CAAC,OAAO,CAAC;AAGvC,MAAa,eAAe,kBAAkB,UAAU;CACtD,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,GAAG;EACpC,MAAM,QAAQ,MAAM;EACpB,IAAI,kBAAkB,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,UAAU,OAAO,KAAK;CAChF;CACA,OAAO;AACT,CAAC"}

package/dist/runtime/payload.d.ts

@@ -3,8 +3,8 @@
  * 取某个 headless 回调的载荷类型。
  *
  * 组件的 `emits` 用对象式声明，每个事件都要写出载荷类型。载荷的真源在 headless 的
- * `on*` 回调上，这里直接从那儿取，而不是把 106 个 `*Details` 的名字在适配器里再抄一遍——
- * 抄一遍就多一处会对不上的地方，而这一处 TypeScript 帮不上忙（名字写错只是换了个类型，照样编译）。
+ * `on*` 回调上，这里直接从该处取，而不是把 106 个 `*Details` 的名字在适配器中再抄一遍：
+ * 再抄一遍就多一处可能不一致的地方，而这一处 TypeScript 无法检查（名字写错只是换了个类型，照样编译）。
  *
  * ```ts
  * emits: {

package/dist/runtime/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","names":[],"sources":["../../src/runtime/payload.ts"],"mappings":";;;;;;;;;;;;;;;KAcY,UAAU,GAAG,gBAAgB,KACrC,YAAY,EAAE,iBAAgB,YAAY,iBAAgB"}
+{"version":3,"file":"payload.d.ts","names":[],"sources":["../../src/runtime/payload.ts"],"mappings":";;;;;;;;;;;;;;;KAmBY,UAAU,GAAG,gBAAgB,KACrC,YAAY,EAAE,iBAAgB,YAAY,iBAAgB"}

package/dist/runtime/portal.js

@@ -0,0 +1,65 @@
+import { Teleport, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+import { createPortalVisualBridge } from "@xihan-ui/core";
+//#region src/runtime/portal.ts
+/**
+* Vue 内部 Portal：Teleport 只负责物理搬运，本层为每个实例增加无盒壳并桥接逻辑来源的视觉轴。
+* 不公开成组件家族；所有浮层部件统一经这里走。
+*/
+const XhPortal = defineComponent({
+	name: "XhPortal",
+	props: {
+		to: {
+			type: [String, Object],
+			required: true
+		},
+		/** 客户端来源节点尚未落定时先原地渲染，绑定所属 Document 后再迁移到正式目标。 */
+		disabled: Boolean,
+		/** 已有锚点时直接作为逻辑来源，避免在结构敏感的 ButtonGroup/Toolbar 里增加元素标记。 */
+		source: {
+			type: Object,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const sourceRef = ref(null);
+		const shellRef = ref(null);
+		let bridge = null;
+		const connect = () => {
+			bridge?.dispose();
+			bridge = null;
+			const source = props.source?.value ?? sourceRef.value;
+			const shell = shellRef.value;
+			if (!source || !shell) return;
+			bridge = createPortalVisualBridge({
+				source,
+				shell
+			});
+		};
+		watch([
+			sourceRef,
+			shellRef,
+			() => props.source?.value,
+			() => props.to,
+			() => props.disabled
+		], connect, { flush: "post" });
+		onBeforeUnmount(() => {
+			bridge?.dispose();
+			bridge = null;
+		});
+		return () => [...props.source ? [] : [h("template", {
+			"ref": sourceRef,
+			"data-xh-portal-source": ""
+		})], h(Teleport, {
+			to: props.to,
+			disabled: props.disabled
+		}, [h("div", {
+			"ref": shellRef,
+			"data-xh-portal-shell": "",
+			"style": { display: "contents" }
+		}, slots.default?.())])];
+	}
+});
+//#endregion
+export { XhPortal };
+
+//# sourceMappingURL=portal.js.map

package/dist/runtime/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","names":[],"sources":["../../src/runtime/portal.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 portal 相关实现。\n\nimport type { PortalVisualBridge } from '@xihan-ui/core'\nimport type { PropType, Ref, VNode } from 'vue'\nimport { createPortalVisualBridge } from '@xihan-ui/core'\nimport { defineComponent, h, onBeforeUnmount, ref, Teleport, watch } from 'vue'\n\n/**\n * Vue 内部 Portal：Teleport 只负责物理搬运，本层为每个实例增加无盒壳并桥接逻辑来源的视觉轴。\n * 不公开成组件家族；所有浮层部件统一经这里走。\n */\nexport const XhPortal = defineComponent({\n  name: 'XhPortal',\n  props: {\n    to: { type: [String, Object] as PropType<string | Element>, required: true },\n    /** 客户端来源节点尚未落定时先原地渲染，绑定所属 Document 后再迁移到正式目标。 */\n    disabled: Boolean,\n    /** 已有锚点时直接作为逻辑来源，避免在结构敏感的 ButtonGroup/Toolbar 里增加元素标记。 */\n    source: { type: Object as PropType<Readonly<Ref<HTMLElement | null>>>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const sourceRef = ref<HTMLTemplateElement | null>(null)\n    const shellRef = ref<HTMLElement | null>(null)\n    let bridge: PortalVisualBridge | null = null\n\n    const connect = (): void => {\n      bridge?.dispose()\n      bridge = null\n      const source = props.source?.value ?? sourceRef.value\n      const shell = shellRef.value\n      if (!source || !shell)\n        return\n      bridge = createPortalVisualBridge({ source, shell })\n    }\n\n    watch([sourceRef, shellRef, () => props.source?.value, () => props.to, () => props.disabled], connect, { flush: 'post' })\n    onBeforeUnmount(() => {\n      bridge?.dispose()\n      bridge = null\n    })\n\n    return (): VNode | VNode[] => [\n      ...(props.source ? [] : [h('template', { 'ref': sourceRef, 'data-xh-portal-source': '' })]),\n      h(Teleport, { to: props.to, disabled: props.disabled }, [\n        h('div', {\n          'ref': shellRef,\n          'data-xh-portal-shell': '',\n          'style': { display: 'contents' },\n        }, slots.default?.()),\n      ]),\n    ]\n  },\n})\n"],"mappings":";;;;;;;AAgBA,MAAa,WAAW,gBAAgB;CACtC,MAAM;CACN,OAAO;EACL,IAAI;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAiC,UAAU;EAAK;;EAE3E,UAAU;;EAEV,QAAQ;GAAE,MAAM;GAAuD,SAAS,KAAA;EAAU;CAC5F;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,YAAY,IAAgC,IAAI;EACtD,MAAM,WAAW,IAAwB,IAAI;EAC7C,IAAI,SAAoC;EAExC,MAAM,gBAAsB;GAC1B,QAAQ,QAAQ;GAChB,SAAS;GACT,MAAM,SAAS,MAAM,QAAQ,SAAS,UAAU;GAChD,MAAM,QAAQ,SAAS;GACvB,IAAI,CAAC,UAAU,CAAC,OACd;GACF,SAAS,yBAAyB;IAAE;IAAQ;GAAM,CAAC;EACrD;EAEA,MAAM;GAAC;GAAW;SAAgB,MAAM,QAAQ;SAAa,MAAM;SAAU,MAAM;EAAQ,GAAG,SAAS,EAAE,OAAO,OAAO,CAAC;EACxH,sBAAsB;GACpB,QAAQ,QAAQ;GAChB,SAAS;EACX,CAAC;EAED,aAA8B,CAC5B,GAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY;GAAE,OAAO;GAAW,yBAAyB;EAAG,CAAC,CAAC,GACzF,EAAE,UAAU;GAAE,IAAI,MAAM;GAAI,UAAU,MAAM;EAAS,GAAG,CACtD,EAAE,OAAO;GACP,OAAO;GACP,wBAAwB;GACxB,SAAS,EAAE,SAAS,WAAW;EACjC,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC,CACH;CACF;AACF,CAAC"}

package/dist/runtime/slot-content.js

@@ -1,16 +1,38 @@
 import { Comment, Fragment, Text } from "vue";
 //#region src/runtime/slot-content.ts
 /**
-* 插槽产出里有没有真会画出东西的节点。
+* 插槽产出中是否有真正会渲染出内容的节点。
 *
 * 只看数组长度会判错：`v-if` 为假时假分支仍留下一个注释节点，空的 `v-for` 留下一个没有子节点的片段，
-* 模板里的换行与缩进留下纯空白文本节点——三者都占着数组的位置，一个像素都不画。
-* 所以逐个节点看类型，片段递归到底。
+* 模板中的换行与缩进留下纯空白文本节点：三者都占据数组的位置，但不渲染任何像素。
+* 因此逐个节点检查类型，片段递归到底。
 *
-* 与 field 的 attributable 判的不是一回事：那边挑「能挂属性的节点」，纯文本一律滤掉；
-* 这边问「有没有内容」，非空文本算内容。两者不能互相替代。
+* 与 field 的 attributable 判断的不是同一件事：那边筛选能挂属性的节点，纯文本一律滤除；
+* 这边判断是否有内容，非空文本算内容。两者不能互相替代。
 */
 function slotPaints(nodes) {
+	return paints(nodes);
+}
+/**
+* 插槽产出是否只有纯文本。
+*
+* 注释与空白文本节点一律跳过：它们是模板换行与假分支留下的，不影响判断；
+* 片段递归到底。有一个元素节点就不算纯文本。
+*
+* 用它决定是否替作者补一层承载节点：作者写的是一段文字时，包一层才能应用该层的规则；
+* 作者自己写了节点则一律不动。
+*/
+function slotIsPlainText(nodes) {
+	return paints(nodes) && textual(nodes);
+}
+function textual(nodes) {
+	return (nodes ?? []).every((node) => {
+		if (node.type === Comment || node.type === Text) return true;
+		if (node.type === Fragment) return !Array.isArray(node.children) || textual(node.children);
+		return false;
+	});
+}
+function paints(nodes) {
 	return nodes?.some((node) => {
 		if (node.type === Comment) return false;
 		if (node.type === Text) return String(node.children ?? "").trim() !== "";
@@ -19,6 +41,6 @@ function slotPaints(nodes) {
 	}) ?? false;
 }
 //#endregion
-export { slotPaints };
+export { slotIsPlainText, slotPaints };
 
 //# sourceMappingURL=slot-content.js.map

package/dist/runtime/slot-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"slot-content.js","names":[],"sources":["../../src/runtime/slot-content.ts"],"sourcesContent":["import type { VNode } from 'vue'\nimport { Comment, Fragment, Text } from 'vue'\n\n/**\n * 插槽产出里有没有真会画出东西的节点。\n *\n * 只看数组长度会判错：`v-if` 为假时假分支仍留下一个注释节点，空的 `v-for` 留下一个没有子节点的片段，\n * 模板里的换行与缩进留下纯空白文本节点——三者都占着数组的位置，一个像素都不画。\n * 所以逐个节点看类型，片段递归到底。\n *\n * 与 field 的 attributable 判的不是一回事：那边挑「能挂属性的节点」，纯文本一律滤掉；\n * 这边问「有没有内容」，非空文本算内容。两者不能互相替代。\n */\nexport function slotPaints(nodes: readonly VNode[] | undefined): boolean {\n  return nodes?.some((node) => {\n    if (node.type === Comment)\n      return false\n    if (node.type === Text)\n      return String(node.children ?? '').trim() !== ''\n    if (node.type === Fragment)\n      return Array.isArray(node.children) && slotPaints(node.children as VNode[])\n    return true\n  }) ?? false\n}\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,WAAW,OAA8C;CACvE,OAAO,OAAO,MAAM,SAAS;EAC3B,IAAI,KAAK,SAAS,SAChB,OAAO;EACT,IAAI,KAAK,SAAS,MAChB,OAAO,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,KAAK,MAAM;EAChD,IAAI,KAAK,SAAS,UAChB,OAAO,MAAM,QAAQ,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAmB;EAC5E,OAAO;CACT,CAAC,KAAK;AACR"}
+{"version":3,"file":"slot-content.js","names":[],"sources":["../../src/runtime/slot-content.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 slot content 相关实现。\n\nimport type { VNode } from 'vue'\nimport { Comment, Fragment, Text } from 'vue'\n\n/**\n * 插槽产出中是否有真正会渲染出内容的节点。\n *\n * 只看数组长度会判错：`v-if` 为假时假分支仍留下一个注释节点，空的 `v-for` 留下一个没有子节点的片段，\n * 模板中的换行与缩进留下纯空白文本节点：三者都占据数组的位置，但不渲染任何像素。\n * 因此逐个节点检查类型，片段递归到底。\n *\n * 与 field 的 attributable 判断的不是同一件事：那边筛选能挂属性的节点，纯文本一律滤除；\n * 这边判断是否有内容，非空文本算内容。两者不能互相替代。\n */\nexport function slotPaints(nodes: readonly VNode[] | undefined): boolean {\n  return paints(nodes)\n}\n\n/**\n * 插槽产出是否只有纯文本。\n *\n * 注释与空白文本节点一律跳过：它们是模板换行与假分支留下的，不影响判断；\n * 片段递归到底。有一个元素节点就不算纯文本。\n *\n * 用它决定是否替作者补一层承载节点：作者写的是一段文字时，包一层才能应用该层的规则；\n * 作者自己写了节点则一律不动。\n */\nexport function slotIsPlainText(nodes: readonly VNode[] | undefined): boolean {\n  return paints(nodes) && textual(nodes)\n}\n\nfunction textual(nodes: readonly VNode[] | undefined): boolean {\n  return (nodes ?? []).every((node) => {\n    if (node.type === Comment || node.type === Text)\n      return true\n    if (node.type === Fragment)\n      return !Array.isArray(node.children) || textual(node.children as VNode[])\n    return false\n  })\n}\n\nfunction paints(nodes: readonly VNode[] | undefined): boolean {\n  return nodes?.some((node) => {\n    if (node.type === Comment)\n      return false\n    if (node.type === Text)\n      return String(node.children ?? '').trim() !== ''\n    if (node.type === Fragment)\n      return Array.isArray(node.children) && slotPaints(node.children as VNode[])\n    return true\n  }) ?? false\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,WAAW,OAA8C;CACvE,OAAO,OAAO,KAAK;AACrB;;;;;;;;;;AAWA,SAAgB,gBAAgB,OAA8C;CAC5E,OAAO,OAAO,KAAK,KAAK,QAAQ,KAAK;AACvC;AAEA,SAAS,QAAQ,OAA8C;CAC7D,QAAQ,SAAS,CAAC,EAAA,CAAG,OAAO,SAAS;EACnC,IAAI,KAAK,SAAS,WAAW,KAAK,SAAS,MACzC,OAAO;EACT,IAAI,KAAK,SAAS,UAChB,OAAO,CAAC,MAAM,QAAQ,KAAK,QAAQ,KAAK,QAAQ,KAAK,QAAmB;EAC1E,OAAO;CACT,CAAC;AACH;AAEA,SAAS,OAAO,OAA8C;CAC5D,OAAO,OAAO,MAAM,SAAS;EAC3B,IAAI,KAAK,SAAS,SAChB,OAAO;EACT,IAAI,KAAK,SAAS,MAChB,OAAO,OAAO,KAAK,YAAY,EAAE,CAAC,CAAC,KAAK,MAAM;EAChD,IAAI,KAAK,SAAS,UAChB,OAAO,MAAM,QAAQ,KAAK,QAAQ,KAAK,WAAW,KAAK,QAAmB;EAC5E,OAAO;CACT,CAAC,KAAK;AACR"}

package/dist/runtime/use-machine.d.ts

@@ -1,8 +1,12 @@
+import { VueRuntimeOptions } from "./create-vue-runtime.js";
 import { MaybeRefOrGetter } from "vue";
-import { Scope } from "@xihan-ui/kernel";
-import { MachineConfig, MachineSchema, Service } from "@xihan-ui/machine";
+import { MachineConfig, MachineSchema, Scope, Service } from "@xihan-ui/core";
 //#region src/runtime/use-machine.d.ts
-declare function useMachine<T extends MachineSchema>(machine: MachineConfig<T>, userProps?: MaybeRefOrGetter<Partial<T['props']>>, scope?: Scope): Service<T>;
+interface UseMachineOptions {
+  /** 机器何时 start，见 VueRuntimeOptions.start；组件只用缺省的 'mounted'。 */
+  start?: VueRuntimeOptions['start'];
+}
+declare function useMachine<T extends MachineSchema>(machine: MachineConfig<T>, userProps?: MaybeRefOrGetter<Partial<T['props']>>, scope?: Scope, options?: UseMachineOptions): Service<T>;
 //#endregion
-export { useMachine };
+export { UseMachineOptions, useMachine };
 //# sourceMappingURL=use-machine.d.ts.map

package/dist/runtime/use-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-machine.d.ts","names":[],"sources":["../../src/runtime/use-machine.ts"],"mappings":";;;;iBAkCgB,WAAW,UAAU,eACnC,SAAS,cAAc,IACvB,YAAW,iBAAiB,QAAQ,cACpC,QAAQ,QACP,QAAQ"}
+{"version":3,"file":"use-machine.d.ts","names":[],"sources":["../../src/runtime/use-machine.ts"],"mappings":";;;;UAmCiB;;EAEf,QAAQ;;iBAGM,WAAW,UAAU,eACnC,SAAS,cAAc,IACvB,YAAW,iBAAiB,QAAQ,cACpC,QAAQ,OACR,UAAS,oBACR,QAAQ"}

package/dist/runtime/use-machine.js

@@ -3,9 +3,8 @@ import { attachFormReset } from "./attach-form-reset.js";
 import { applyXhConfigDefaults, useXhConfigDefaults } from "./config-defaults.js";
 import { createVueRuntime } from "./create-vue-runtime.js";
 import { toValue } from "vue";
-import { VERSION, isDev } from "@xihan-ui/kernel";
-import { checkLockstepVersion, printMetadataBannerOnce, registerRuntimeHost } from "@xihan-ui/kernel/metadata";
-import { createService } from "@xihan-ui/machine";
+import { VERSION, createService, isDev } from "@xihan-ui/core";
+import { checkLockstepVersion, printMetadataBannerOnce, registerRuntimeHost } from "@xihan-ui/core/metadata";
 //#region src/runtime/use-machine.ts
 let devChecksStarted = false;
 function ensureDevChecks() {
@@ -17,12 +16,12 @@ function ensureDevChecks() {
 		printMetadataBannerOnce();
 	}
 }
-function useMachine(machine, userProps = {}, scope) {
+function useMachine(machine, userProps = {}, scope, options = {}) {
 	ensureDevChecks();
 	const config = useXhConfigDefaults();
 	const service = createService(machine, {
 		props: () => applyXhConfigDefaults(machine.name, { ...toValue(userProps) }, config()),
-		runtime: createVueRuntime(),
+		runtime: createVueRuntime({ start: options.start }),
 		scope
 	});
 	attachFormReset(service);

package/dist/runtime/use-machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-machine.js","names":["VUE_VERSION","KERNEL_VERSION"],"sources":["../../src/runtime/use-machine.ts"],"sourcesContent":["import type { Scope } from '@xihan-ui/kernel'\nimport type { MachineConfig, MachineSchema, Service } from '@xihan-ui/machine'\nimport type { MaybeRefOrGetter } from 'vue'\nimport { isDev, VERSION as KERNEL_VERSION } from '@xihan-ui/kernel'\nimport { checkLockstepVersion, printMetadataBannerOnce, registerRuntimeHost } from '@xihan-ui/kernel/metadata'\nimport { createService } from '@xihan-ui/machine'\nimport { toValue } from 'vue'\nimport { version as VUE_VERSION } from '../../package.json'\nimport { attachFormReset } from './attach-form-reset'\nimport { applyXhConfigDefaults, useXhConfigDefaults } from './config-defaults'\nimport { createVueRuntime } from './create-vue-runtime'\n\n// 废弃探测与锁步版本检查都只启动一次：第一个组件建机器时借路启动，之后的组件全走这个开关。\n// 生产构建里 isDev() 为 false，跳过；登记表为空时扫描器内部早退，零开销。\nlet devChecksStarted = false\n\nfunction ensureDevChecks(): void {\n  if (devChecksStarted)\n    return\n  devChecksStarted = true\n  // 宿主登记不分 dev/prod:元数据要能报出运行在哪个适配器上\n  registerRuntimeHost('vue', VUE_VERSION)\n  if (isDev()) {\n    checkLockstepVersion('vue', VUE_VERSION, KERNEL_VERSION)\n    // 引用即打印:首个组件建机器时打一次启动横幅(整页一次,生产静默)\n    printMetadataBannerOnce()\n    // 注意:废弃扫描不进 Vue 的组件树摇入口——它每个组件都会带一份(约 1.8 kB gzip),\n    // 组件级体积棘轮量得出来。需要时手动启动:\n    //   import { startDeprecationScan } from '@xihan-ui/kernel/deprecations'\n    //   if (import.meta.env.DEV) startDeprecationScan()\n    // Web Components 侧在 defineXhElements() 里自动启动,那边没有逐组件入口的棘轮。\n  }\n}\n\nexport function useMachine<T extends MachineSchema>(\n  machine: MachineConfig<T>,\n  userProps: MaybeRefOrGetter<Partial<T['props']>> = {} as never,\n  scope?: Scope,\n): Service<T> {\n  ensureDevChecks()\n  // 全局配置在这一处并进来：所有跑机器的组件都从这里取 props，不必逐个接线。\n  // 与 WC 侧 MachineController 里那一处对位，两个适配器的生效面因此一致\n  const config = useXhConfigDefaults()\n  const service = createService(machine, {\n    // 每次展开成新对象，让 machine 的身份缓存失效\n    props: () => applyXhConfigDefaults(machine.name, { ...toValue(userProps) }, config()) as never,\n    runtime: createVueRuntime(),\n    scope,\n  })\n  attachFormReset(service)\n  return service\n}\n"],"mappings":";;;;;;;;;AAcA,IAAI,mBAAmB;AAEvB,SAAS,kBAAwB;CAC/B,IAAI,kBACF;CACF,mBAAmB;CAEnB,oBAAoB,OAAOA,OAAW;CACtC,IAAI,MAAM,GAAG;EACX,qBAAqB,OAAOA,SAAaC,OAAc;EAEvD,wBAAwB;CAM1B;AACF;AAEA,SAAgB,WACd,SACA,YAAmD,CAAC,GACpD,OACY;CACZ,gBAAgB;CAGhB,MAAM,SAAS,oBAAoB;CACnC,MAAM,UAAU,cAAc,SAAS;EAErC,aAAa,sBAAsB,QAAQ,MAAM,EAAE,GAAG,QAAQ,SAAS,EAAE,GAAG,OAAO,CAAC;EACpF,SAAS,iBAAiB;EAC1B;CACF,CAAC;CACD,gBAAgB,OAAO;CACvB,OAAO;AACT"}
+{"version":3,"file":"use-machine.js","names":["VUE_VERSION","CORE_VERSION"],"sources":["../../src/runtime/use-machine.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use machine 相关实现。\n\nimport type { MachineConfig, MachineSchema, Scope, Service } from '@xihan-ui/core'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { VueRuntimeOptions } from './create-vue-runtime'\nimport { VERSION as CORE_VERSION, createService, isDev } from '@xihan-ui/core'\nimport { checkLockstepVersion, printMetadataBannerOnce, registerRuntimeHost } from '@xihan-ui/core/metadata'\nimport { toValue } from 'vue'\nimport { version as VUE_VERSION } from '../../package.json'\nimport { attachFormReset } from './attach-form-reset'\nimport { applyXhConfigDefaults, useXhConfigDefaults } from './config-defaults'\nimport { createVueRuntime } from './create-vue-runtime'\n\n// 锁步版本检查只跑一次：第一个组件建机器时借路启动，之后的组件全走这个开关。\n// 生产构建里 isDev() 为 false，跳过。\nlet devChecksStarted = false\n\nfunction ensureDevChecks(): void {\n  if (devChecksStarted)\n    return\n  devChecksStarted = true\n  // 宿主登记不分 dev/prod:元数据要能报出运行在哪个适配器上\n  registerRuntimeHost('vue', VUE_VERSION)\n  if (isDev()) {\n    checkLockstepVersion('vue', VUE_VERSION, CORE_VERSION)\n    // 引用即打印:首个组件建机器时打一次启动横幅(整页一次,生产静默)\n    printMetadataBannerOnce()\n  }\n}\n\nexport interface UseMachineOptions {\n  /** 机器何时 start，见 VueRuntimeOptions.start；组件只用缺省的 'mounted'。 */\n  start?: VueRuntimeOptions['start']\n}\n\nexport function useMachine<T extends MachineSchema>(\n  machine: MachineConfig<T>,\n  userProps: MaybeRefOrGetter<Partial<T['props']>> = {} as never,\n  scope?: Scope,\n  options: UseMachineOptions = {},\n): Service<T> {\n  ensureDevChecks()\n  // 全局配置在这一处并进来：所有跑机器的组件都从这里取 props，不必逐个接线。\n  // 与 WC 侧 MachineController 里那一处对位，两个适配器的生效面因此一致\n  const config = useXhConfigDefaults()\n  const service = createService(machine, {\n    // 每次展开成新对象，让 machine 的身份缓存失效\n    props: () => applyXhConfigDefaults(machine.name, { ...toValue(userProps) }, config()) as never,\n    runtime: createVueRuntime({ start: options.start }),\n    scope,\n  })\n  attachFormReset(service)\n  return service\n}\n"],"mappings":";;;;;;;;AAoBA,IAAI,mBAAmB;AAEvB,SAAS,kBAAwB;CAC/B,IAAI,kBACF;CACF,mBAAmB;CAEnB,oBAAoB,OAAOA,OAAW;CACtC,IAAI,MAAM,GAAG;EACX,qBAAqB,OAAOA,SAAaC,OAAY;EAErD,wBAAwB;CAC1B;AACF;AAOA,SAAgB,WACd,SACA,YAAmD,CAAC,GACpD,OACA,UAA6B,CAAC,GAClB;CACZ,gBAAgB;CAGhB,MAAM,SAAS,oBAAoB;CACnC,MAAM,UAAU,cAAc,SAAS;EAErC,aAAa,sBAAsB,QAAQ,MAAM,EAAE,GAAG,QAAQ,SAAS,EAAE,GAAG,OAAO,CAAC;EACpF,SAAS,iBAAiB,EAAE,OAAO,QAAQ,MAAM,CAAC;EAClD;CACF,CAAC;CACD,gBAAgB,OAAO;CACvB,OAAO;AACT"}