@weapp-vite/web 1.3.36 → 1.4.0

package/dist/runtime/component/observers.mjs

@@ -0,0 +1,36 @@
+//#region src/runtime/component/observers.ts
+function normalizeObserverPattern(pattern) {
+	return pattern.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function hasOwn(value, key) {
+	return Object.prototype.hasOwnProperty.call(value, key);
+}
+function resolveObservedValue(instance, pattern) {
+	if (pattern === "**") return {
+		...instance.properties,
+		...instance.data
+	};
+	const [root, ...rest] = pattern.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let current = hasOwn(instance.properties, root) ? instance.properties[root] : instance.data[root];
+	for (const segment of rest) current = current?.[segment];
+	return current;
+}
+function matchesObserverPattern(pattern, changedKeys) {
+	if (pattern === "**") return changedKeys.length > 0;
+	return normalizeObserverPattern(pattern).some((observedKey) => {
+		if (observedKey === "**") return true;
+		return changedKeys.some((changedKey) => changedKey === observedKey || changedKey.startsWith(`${observedKey}.`) || changedKey.startsWith(`${observedKey}[`));
+	});
+}
+function runComponentObservers(component, instance, changedKeys, previousProperties = {}) {
+	if (!changedKeys.length) return;
+	for (const changedKey of changedKeys) (component.properties?.[changedKey])?.observer?.call(instance, instance.properties[changedKey], previousProperties[changedKey]);
+	for (const [pattern, observer] of Object.entries(component.observers ?? {})) {
+		if (typeof observer !== "function" || !matchesObserverPattern(pattern, changedKeys)) continue;
+		observer.call(instance, ...normalizeObserverPattern(pattern).map((item) => resolveObservedValue(instance, item)));
+	}
+}
+
+//#endregion
+export { runComponentObservers };
+//# sourceMappingURL=observers.mjs.map

package/dist/runtime/component/observers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.mjs","names":[],"sources":["../../../src/runtime/component/observers.ts"],"sourcesContent":["import type {\n  ComponentPublicInstance,\n  DataRecord,\n  NormalizedComponentOptions,\n} from './types'\n\nfunction normalizeObserverPattern(pattern: string) {\n  return pattern.split(',').map(item => item.trim()).filter(Boolean)\n}\n\nfunction hasOwn(value: object, key: PropertyKey) {\n  return Object.prototype.hasOwnProperty.call(value, key)\n}\n\nfunction resolveObservedValue(instance: ComponentPublicInstance, pattern: string) {\n  if (pattern === '**') {\n    return {\n      ...instance.properties,\n      ...instance.data,\n    }\n  }\n\n  const segments = pattern\n    .replace(/\\[(\\d+)\\]/g, '.$1')\n    .split('.')\n    .filter(Boolean)\n  const [root, ...rest] = segments as [string, ...string[]]\n  let current = hasOwn(instance.properties, root)\n    ? instance.properties[root]\n    : instance.data[root]\n  for (const segment of rest) {\n    current = current?.[segment]\n  }\n  return current\n}\n\nfunction matchesObserverPattern(pattern: string, changedKeys: string[]) {\n  if (pattern === '**') {\n    return changedKeys.length > 0\n  }\n  return normalizeObserverPattern(pattern).some((observedKey) => {\n    if (observedKey === '**') {\n      return true\n    }\n    return changedKeys.some(changedKey => (\n      changedKey === observedKey\n      || changedKey.startsWith(`${observedKey}.`)\n      || changedKey.startsWith(`${observedKey}[`)\n    ))\n  })\n}\n\nexport function runComponentObservers(\n  component: NormalizedComponentOptions,\n  instance: ComponentPublicInstance,\n  changedKeys: string[],\n  previousProperties: DataRecord = {},\n) {\n  if (!changedKeys.length) {\n    return\n  }\n\n  for (const changedKey of changedKeys) {\n    const option = component.properties?.[changedKey]\n    option?.observer?.call(\n      instance,\n      instance.properties[changedKey],\n      previousProperties[changedKey],\n    )\n  }\n\n  for (const [pattern, observer] of Object.entries(component.observers ?? {})) {\n    if (typeof observer !== 'function' || !matchesObserverPattern(pattern, changedKeys)) {\n      continue\n    }\n    observer.call(\n      instance,\n      ...normalizeObserverPattern(pattern).map(item => resolveObservedValue(instance, item)),\n    )\n  }\n}\n"],"mappings":";AAMA,SAAS,yBAAyB,SAAiB;CACjD,OAAO,QAAQ,MAAM,GAAG,CAAC,CAAC,KAAI,SAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,OAAO;AACnE;AAEA,SAAS,OAAO,OAAe,KAAkB;CAC/C,OAAO,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG;AACxD;AAEA,SAAS,qBAAqB,UAAmC,SAAiB;CAChF,IAAI,YAAY,MACd,OAAO;EACL,GAAG,SAAS;EACZ,GAAG,SAAS;CACd;CAOF,MAAM,CAAC,MAAM,GAAG,QAJC,QACd,QAAQ,cAAc,KAAK,CAAC,CAC5B,MAAM,GAAG,CAAC,CACV,OAAO,OACqB;CAC/B,IAAI,UAAU,OAAO,SAAS,YAAY,IAAI,IAC1C,SAAS,WAAW,QACpB,SAAS,KAAK;CAClB,KAAK,MAAM,WAAW,MACpB,UAAU,UAAU;CAEtB,OAAO;AACT;AAEA,SAAS,uBAAuB,SAAiB,aAAuB;CACtE,IAAI,YAAY,MACd,OAAO,YAAY,SAAS;CAE9B,OAAO,yBAAyB,OAAO,CAAC,CAAC,MAAM,gBAAgB;EAC7D,IAAI,gBAAgB,MAClB,OAAO;EAET,OAAO,YAAY,MAAK,eACtB,eAAe,eACZ,WAAW,WAAW,GAAG,YAAY,EAAE,KACvC,WAAW,WAAW,GAAG,YAAY,EAAE,CAC3C;CACH,CAAC;AACH;AAEA,SAAgB,sBACd,WACA,UACA,aACA,qBAAiC,CAAC,GAClC;CACA,IAAI,CAAC,YAAY,QACf;CAGF,KAAK,MAAM,cAAc,aAEvB,CADe,UAAU,aAAa,YAChC,EAAE,UAAU,KAChB,UACA,SAAS,WAAW,aACpB,mBAAmB,WACrB;CAGF,KAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,UAAU,aAAa,CAAC,CAAC,GAAG;EAC3E,IAAI,OAAO,aAAa,cAAc,CAAC,uBAAuB,SAAS,WAAW,GAChF;EAEF,SAAS,KACP,UACA,GAAG,yBAAyB,OAAO,CAAC,CAAC,KAAI,SAAQ,qBAAqB,UAAU,IAAI,CAAC,CACvF;CACF;AACF"}

package/dist/runtime/component/publicInstance.mjs

@@ -0,0 +1,48 @@
+//#region src/runtime/component/publicInstance.ts
+const componentPublicInstanceTargets = /* @__PURE__ */ new WeakMap();
+function resolveComponentPublicInstanceTarget(value) {
+	if (!value || typeof value !== "object") return;
+	return componentPublicInstanceTargets.get(value);
+}
+function createComponentPublicInstance(target, runtimePrototype, resolveComponentMethod) {
+	const runtimeMethods = /* @__PURE__ */ new Map();
+	const publicInstance = new Proxy(target, {
+		get(instance, key) {
+			if (Reflect.getOwnPropertyDescriptor(instance, key)) return Reflect.get(instance, key, instance);
+			if (Reflect.getOwnPropertyDescriptor(runtimePrototype, key)) {
+				const value = Reflect.get(instance, key, instance);
+				if (typeof value !== "function") return value;
+				const cached = runtimeMethods.get(key);
+				if (cached && cached.source === value) return cached.bound;
+				const bound = value.bind(instance);
+				runtimeMethods.set(key, {
+					source: value,
+					bound
+				});
+				return bound;
+			}
+			const componentMethod = resolveComponentMethod?.(key);
+			if (typeof componentMethod === "function") return componentMethod;
+			return typeof key === "symbol" ? Reflect.get(instance, key, instance) : void 0;
+		},
+		set(instance, key, value) {
+			if (Reflect.getOwnPropertyDescriptor(instance, key) || typeof key === "symbol") return Reflect.set(instance, key, value, instance);
+			Reflect.defineProperty(instance, key, {
+				configurable: true,
+				enumerable: true,
+				writable: true,
+				value
+			});
+			return true;
+		},
+		has(instance, key) {
+			return Reflect.getOwnPropertyDescriptor(instance, key) !== void 0 || Reflect.getOwnPropertyDescriptor(runtimePrototype, key) !== void 0 || typeof resolveComponentMethod?.(key) === "function" || typeof key === "symbol" && Reflect.has(instance, key);
+		}
+	});
+	componentPublicInstanceTargets.set(publicInstance, target);
+	return publicInstance;
+}
+
+//#endregion
+export { createComponentPublicInstance, resolveComponentPublicInstanceTarget };
+//# sourceMappingURL=publicInstance.mjs.map

package/dist/runtime/component/publicInstance.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicInstance.mjs","names":[],"sources":["../../../src/runtime/component/publicInstance.ts"],"sourcesContent":["import type { ComponentPublicInstance } from './types'\n\nconst componentPublicInstanceTargets = new WeakMap<object, ComponentPublicInstance>()\n\nexport function resolveComponentPublicInstanceTarget(value: unknown) {\n  if (!value || typeof value !== 'object') {\n    return undefined\n  }\n  return componentPublicInstanceTargets.get(value)\n}\n\nexport function createComponentPublicInstance(\n  target: ComponentPublicInstance,\n  runtimePrototype: object,\n  resolveComponentMethod?: (key: PropertyKey) => unknown,\n): ComponentPublicInstance {\n  type RuntimeMethod = (...args: any[]) => unknown\n  const runtimeMethods = new Map<PropertyKey, { source: RuntimeMethod, bound: RuntimeMethod }>()\n\n  const publicInstance = new Proxy(target, {\n    get(instance, key) {\n      const ownDescriptor = Reflect.getOwnPropertyDescriptor(instance, key)\n      if (ownDescriptor) {\n        return Reflect.get(instance, key, instance)\n      }\n      const runtimeDescriptor = Reflect.getOwnPropertyDescriptor(runtimePrototype, key)\n      if (runtimeDescriptor) {\n        const value = Reflect.get(instance, key, instance)\n        if (typeof value !== 'function') {\n          return value\n        }\n        const cached = runtimeMethods.get(key)\n        if (cached && cached.source === value) {\n          return cached.bound\n        }\n        const bound = value.bind(instance)\n        runtimeMethods.set(key, { source: value, bound })\n        return bound\n      }\n      const componentMethod = resolveComponentMethod?.(key)\n      if (typeof componentMethod === 'function') {\n        return componentMethod\n      }\n      return typeof key === 'symbol' ? Reflect.get(instance, key, instance) : undefined\n    },\n    set(instance, key, value) {\n      if (Reflect.getOwnPropertyDescriptor(instance, key) || typeof key === 'symbol') {\n        return Reflect.set(instance, key, value, instance)\n      }\n      Reflect.defineProperty(instance, key, {\n        configurable: true,\n        enumerable: true,\n        writable: true,\n        value,\n      })\n      return true\n    },\n    has(instance, key) {\n      return Reflect.getOwnPropertyDescriptor(instance, key) !== undefined\n        || Reflect.getOwnPropertyDescriptor(runtimePrototype, key) !== undefined\n        || typeof resolveComponentMethod?.(key) === 'function'\n        || (typeof key === 'symbol' && Reflect.has(instance, key))\n    },\n  })\n  componentPublicInstanceTargets.set(publicInstance, target)\n  return publicInstance\n}\n"],"mappings":";AAEA,MAAM,iDAAiC,IAAI,QAAyC;AAEpF,SAAgB,qCAAqC,OAAgB;CACnE,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B;CAEF,OAAO,+BAA+B,IAAI,KAAK;AACjD;AAEA,SAAgB,8BACd,QACA,kBACA,wBACyB;CAEzB,MAAM,iCAAiB,IAAI,IAAkE;CAE7F,MAAM,iBAAiB,IAAI,MAAM,QAAQ;EACvC,IAAI,UAAU,KAAK;GAEjB,IADsB,QAAQ,yBAAyB,UAAU,GACjD,GACd,OAAO,QAAQ,IAAI,UAAU,KAAK,QAAQ;GAG5C,IAD0B,QAAQ,yBAAyB,kBAAkB,GACzD,GAAG;IACrB,MAAM,QAAQ,QAAQ,IAAI,UAAU,KAAK,QAAQ;IACjD,IAAI,OAAO,UAAU,YACnB,OAAO;IAET,MAAM,SAAS,eAAe,IAAI,GAAG;IACrC,IAAI,UAAU,OAAO,WAAW,OAC9B,OAAO,OAAO;IAEhB,MAAM,QAAQ,MAAM,KAAK,QAAQ;IACjC,eAAe,IAAI,KAAK;KAAE,QAAQ;KAAO;IAAM,CAAC;IAChD,OAAO;GACT;GACA,MAAM,kBAAkB,yBAAyB,GAAG;GACpD,IAAI,OAAO,oBAAoB,YAC7B,OAAO;GAET,OAAO,OAAO,QAAQ,WAAW,QAAQ,IAAI,UAAU,KAAK,QAAQ,IAAI;EAC1E;EACA,IAAI,UAAU,KAAK,OAAO;GACxB,IAAI,QAAQ,yBAAyB,UAAU,GAAG,KAAK,OAAO,QAAQ,UACpE,OAAO,QAAQ,IAAI,UAAU,KAAK,OAAO,QAAQ;GAEnD,QAAQ,eAAe,UAAU,KAAK;IACpC,cAAc;IACd,YAAY;IACZ,UAAU;IACV;GACF,CAAC;GACD,OAAO;EACT;EACA,IAAI,UAAU,KAAK;GACjB,OAAO,QAAQ,yBAAyB,UAAU,GAAG,MAAM,UACtD,QAAQ,yBAAyB,kBAAkB,GAAG,MAAM,UAC5D,OAAO,yBAAyB,GAAG,MAAM,cACxC,OAAO,QAAQ,YAAY,QAAQ,IAAI,UAAU,GAAG;EAC5D;CACF,CAAC;CACD,+BAA+B,IAAI,gBAAgB,MAAM;CACzD,OAAO;AACT"}

package/dist/runtime/component/relations.mjs

@@ -0,0 +1,35 @@
+import { slugify } from "../../shared/slugify.mjs";
+import { posix } from "pathe";
+
+//#region src/runtime/component/relations.ts
+function resolveComposedParent(node) {
+	const assignedSlot = node.assignedSlot;
+	if (assignedSlot) return assignedSlot;
+	if (node.parentNode) return node.parentNode;
+	const root = node.getRootNode?.();
+	return root instanceof ShadowRoot ? root.host : void 0;
+}
+function resolveRelationTag(componentId, relationPath) {
+	if (!relationPath.startsWith(".")) return;
+	return slugify(posix.normalize(posix.join(posix.dirname(componentId), relationPath)), "wv-component");
+}
+function resolveRelationNodes(instance, componentId, relationPath, type) {
+	if (!componentId) return [];
+	const tag = resolveRelationTag(componentId, relationPath);
+	if (!tag) return [];
+	if (type === "child" || type === "descendant") {
+		const matches = Array.from(instance.querySelectorAll(tag));
+		return type === "descendant" ? matches : matches.filter((node) => resolveComposedParent(node) === instance);
+	}
+	let current = resolveComposedParent(instance);
+	while (current) {
+		if (current.tagName?.toLowerCase() === tag) return [current];
+		if (type === "parent") return [];
+		current = resolveComposedParent(current);
+	}
+	return [];
+}
+
+//#endregion
+export { resolveRelationNodes };
+//# sourceMappingURL=relations.mjs.map

package/dist/runtime/component/relations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.mjs","names":[],"sources":["../../../src/runtime/component/relations.ts"],"sourcesContent":["import type { ComponentPublicInstance, RelationType } from './types'\nimport { posix } from 'pathe'\nimport { slugify } from '../../shared/slugify'\n\nfunction resolveComposedParent(node: Node): Node | undefined {\n  const assignedSlot = (node as Element).assignedSlot\n  if (assignedSlot) {\n    return assignedSlot\n  }\n  if (node.parentNode) {\n    return node.parentNode\n  }\n  const root = node.getRootNode?.()\n  return root instanceof ShadowRoot ? root.host : undefined\n}\n\nfunction resolveRelationTag(componentId: string, relationPath: string) {\n  if (!relationPath.startsWith('.')) {\n    return undefined\n  }\n  const targetId = posix.normalize(posix.join(posix.dirname(componentId), relationPath))\n  return slugify(targetId, 'wv-component')\n}\n\nexport function resolveRelationNodes(\n  instance: ComponentPublicInstance,\n  componentId: string | undefined,\n  relationPath: string,\n  type: RelationType,\n): ComponentPublicInstance[] {\n  if (!componentId) {\n    return []\n  }\n  const tag = resolveRelationTag(componentId, relationPath)\n  if (!tag) {\n    return []\n  }\n  if (type === 'child' || type === 'descendant') {\n    const matches = Array.from(instance.querySelectorAll(tag)) as ComponentPublicInstance[]\n    return type === 'descendant'\n      ? matches\n      : matches.filter(node => resolveComposedParent(node) === instance)\n  }\n\n  let current = resolveComposedParent(instance)\n  while (current) {\n    if ((current as Element).tagName?.toLowerCase() === tag) {\n      return [current as ComponentPublicInstance]\n    }\n    if (type === 'parent') {\n      return []\n    }\n    current = resolveComposedParent(current)\n  }\n  return []\n}\n"],"mappings":";;;;AAIA,SAAS,sBAAsB,MAA8B;CAC3D,MAAM,eAAgB,KAAiB;CACvC,IAAI,cACF,OAAO;CAET,IAAI,KAAK,YACP,OAAO,KAAK;CAEd,MAAM,OAAO,KAAK,cAAc;CAChC,OAAO,gBAAgB,aAAa,KAAK,OAAO;AAClD;AAEA,SAAS,mBAAmB,aAAqB,cAAsB;CACrE,IAAI,CAAC,aAAa,WAAW,GAAG,GAC9B;CAGF,OAAO,QADU,MAAM,UAAU,MAAM,KAAK,MAAM,QAAQ,WAAW,GAAG,YAAY,CAC9D,GAAG,cAAc;AACzC;AAEA,SAAgB,qBACd,UACA,aACA,cACA,MAC2B;CAC3B,IAAI,CAAC,aACH,OAAO,CAAC;CAEV,MAAM,MAAM,mBAAmB,aAAa,YAAY;CACxD,IAAI,CAAC,KACH,OAAO,CAAC;CAEV,IAAI,SAAS,WAAW,SAAS,cAAc;EAC7C,MAAM,UAAU,MAAM,KAAK,SAAS,iBAAiB,GAAG,CAAC;EACzD,OAAO,SAAS,eACZ,UACA,QAAQ,QAAO,SAAQ,sBAAsB,IAAI,MAAM,QAAQ;CACrE;CAEA,IAAI,UAAU,sBAAsB,QAAQ;CAC5C,OAAO,SAAS;EACd,IAAK,QAAoB,SAAS,YAAY,MAAM,KAClD,OAAO,CAAC,OAAkC;EAE5C,IAAI,SAAS,UACX,OAAO,CAAC;EAEV,UAAU,sBAAsB,OAAO;CACzC;CACA,OAAO,CAAC;AACV"}

package/dist/runtime/component/slots.mjs

@@ -0,0 +1,24 @@
+//#region src/runtime/component/slots.ts
+function resolveSlotNames(value) {
+	if (Array.isArray(value)) return new Set(value.filter((name) => typeof name === "string" && name.length > 0));
+	if (!value || typeof value !== "object") return /* @__PURE__ */ new Set();
+	return new Set(Object.entries(value).filter(([, enabled]) => Boolean(enabled)).map(([name]) => name));
+}
+function createWebSlotsProxy(resolveValue) {
+	const hasSlot = (key) => typeof key === "string" && resolveSlotNames(resolveValue()).has(key);
+	return new Proxy(Object.create(null), {
+		get: (_target, key) => hasSlot(key) ? true : void 0,
+		has: (_target, key) => hasSlot(key),
+		ownKeys: () => Array.from(resolveSlotNames(resolveValue())),
+		getOwnPropertyDescriptor: (_target, key) => hasSlot(key) ? {
+			configurable: true,
+			enumerable: true,
+			value: true
+		} : void 0,
+		set: () => false
+	});
+}
+
+//#endregion
+export { createWebSlotsProxy };
+//# sourceMappingURL=slots.mjs.map

package/dist/runtime/component/slots.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.mjs","names":[],"sources":["../../../src/runtime/component/slots.ts"],"sourcesContent":["function resolveSlotNames(value: unknown) {\n  if (Array.isArray(value)) {\n    return new Set(value.filter((name): name is string => typeof name === 'string' && name.length > 0))\n  }\n  if (!value || typeof value !== 'object') {\n    return new Set<string>()\n  }\n  return new Set(\n    Object.entries(value)\n      .filter(([, enabled]) => Boolean(enabled))\n      .map(([name]) => name),\n  )\n}\n\nexport function createWebSlotsProxy(resolveValue: () => unknown) {\n  const hasSlot = (key: PropertyKey) => typeof key === 'string' && resolveSlotNames(resolveValue()).has(key)\n  return new Proxy(Object.create(null) as Record<string, true>, {\n    get: (_target, key) => hasSlot(key) ? true : undefined,\n    has: (_target, key) => hasSlot(key),\n    ownKeys: () => Array.from(resolveSlotNames(resolveValue())),\n    getOwnPropertyDescriptor: (_target, key) => hasSlot(key)\n      ? { configurable: true, enumerable: true, value: true }\n      : undefined,\n    set: () => false,\n  })\n}\n"],"mappings":";AAAA,SAAS,iBAAiB,OAAgB;CACxC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,IAAI,MAAM,QAAQ,SAAyB,OAAO,SAAS,YAAY,KAAK,SAAS,CAAC,CAAC;CAEpG,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,uBAAO,IAAI,IAAY;CAEzB,OAAO,IAAI,IACT,OAAO,QAAQ,KAAK,CAAC,CAClB,QAAQ,GAAG,aAAa,QAAQ,OAAO,CAAC,CAAC,CACzC,KAAK,CAAC,UAAU,IAAI,CACzB;AACF;AAEA,SAAgB,oBAAoB,cAA6B;CAC/D,MAAM,WAAW,QAAqB,OAAO,QAAQ,YAAY,iBAAiB,aAAa,CAAC,CAAC,CAAC,IAAI,GAAG;CACzG,OAAO,IAAI,MAAM,OAAO,OAAO,IAAI,GAA2B;EAC5D,MAAM,SAAS,QAAQ,QAAQ,GAAG,IAAI,OAAO;EAC7C,MAAM,SAAS,QAAQ,QAAQ,GAAG;EAClC,eAAe,MAAM,KAAK,iBAAiB,aAAa,CAAC,CAAC;EAC1D,2BAA2B,SAAS,QAAQ,QAAQ,GAAG,IACnD;GAAE,cAAc;GAAM,YAAY;GAAM,OAAO;EAAK,IACpD;EACJ,WAAW;CACb,CAAC;AACH"}

package/dist/runtime/component/state.mjs

@@ -3,22 +3,30 @@ import { cloneValue, hyphenate } from "./utils.mjs";
 import { normalizeBehaviors } from "./behavior.mjs";
 
 //#region src/runtime/component/state.ts
+function normalizePropertyDeclaration(declaration) {
+	if (declaration === null || typeof declaration === "function") return { type: declaration };
+	return declaration;
+}
 function resolveNormalizedComponent(component) {
 	const normalized = normalizeBehaviors(component);
+	const resolved = normalized.component;
 	return {
 		warnings: normalized.warnings,
-		component: normalized.component ?? component ?? {}
+		component: {
+			...resolved,
+			properties: Object.fromEntries(Object.entries(resolved.properties ?? {}).map(([name, declaration]) => [name, normalizePropertyDeclaration(declaration)]))
+		}
 	};
 }
 function createDefaultPropertyValues(propertyEntries) {
 	return propertyEntries.reduce((acc, [name, prop]) => {
-		if (hasOwn(prop, "value")) acc[name] = cloneValue(prop.value);
+		if (prop !== null && typeof prop === "object" && hasOwn(prop, "value")) acc[name] = cloneValue(prop.value);
 		else acc[name] = void 0;
 		return acc;
 	}, {});
 }
 function createPropertyEntries(component) {
-	return Object.entries(component.properties ?? {});
+	return Object.entries(component.properties);
 }
 function createObservedAttributes(propertyEntries) {
 	return propertyEntries.map(([name]) => hyphenate(name));
@@ -28,6 +36,7 @@ function createComponentRuntimeState(options) {
 	const propertyEntries = createPropertyEntries(component);
 	return {
 		state: {
+			id: options.id,
 			templateRef: options.template,
 			styleRef: options.style ?? "",
 			componentRef: component,
@@ -45,6 +54,7 @@ function updateComponentRuntimeState(state, options) {
 	const { component, warnings } = resolveNormalizedComponent(options.component ?? {});
 	const propertyEntries = createPropertyEntries(component);
 	state.templateRef = options.template;
+	state.id = options.id;
 	state.styleRef = options.style ?? "";
 	state.componentRef = component;
 	state.observerInitEnabled = Boolean(options.observerInit);

package/dist/runtime/component/state.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"state.mjs","names":[],"sources":["../../../src/runtime/component/state.ts"],"sourcesContent":["import type {\n  ComponentOptions,\n  DataRecord,\n  DefineComponentOptions,\n  LifeTimeHooks,\n  PageLifeTimeHooks,\n  PropertyOption,\n} from './types'\nimport { hasOwn } from '../utils/object'\nimport { normalizeBehaviors } from './behavior'\nimport { cloneValue, hyphenate } from './utils'\n\ntype PropertyEntry = [string, PropertyOption]\n\nexport interface ComponentRuntimeState {\n  templateRef: DefineComponentOptions['template']\n  styleRef: string\n  componentRef: ComponentOptions\n  observerInitEnabled: boolean\n  propertyEntries: PropertyEntry[]\n  observedAttributes: string[]\n  defaultPropertyValues: DataRecord\n  lifetimes: LifeTimeHooks\n  pageLifetimes: PageLifeTimeHooks\n}\n\nfunction resolveNormalizedComponent(component: ComponentOptions | undefined) {\n  const normalized = normalizeBehaviors(component)\n  return {\n    warnings: normalized.warnings,\n    component: normalized.component ?? component ?? {},\n  }\n}\n\nfunction createDefaultPropertyValues(propertyEntries: PropertyEntry[]) {\n  return propertyEntries.reduce<DataRecord>((acc, [name, prop]) => {\n    if (hasOwn(prop, 'value')) {\n      acc[name] = cloneValue(prop.value)\n    }\n    else {\n      acc[name] = undefined\n    }\n    return acc\n  }, {})\n}\n\nfunction createPropertyEntries(component: ComponentOptions): PropertyEntry[] {\n  return Object.entries(component.properties ?? {})\n}\n\nfunction createObservedAttributes(propertyEntries: PropertyEntry[]) {\n  return propertyEntries.map(([name]) => hyphenate(name))\n}\n\nexport function createComponentRuntimeState(options: DefineComponentOptions) {\n  const { component, warnings } = resolveNormalizedComponent(options.component ?? {})\n  const propertyEntries = createPropertyEntries(component)\n  const state: ComponentRuntimeState = {\n    templateRef: options.template,\n    styleRef: options.style ?? '',\n    componentRef: component,\n    observerInitEnabled: Boolean(options.observerInit),\n    propertyEntries,\n    observedAttributes: createObservedAttributes(propertyEntries),\n    defaultPropertyValues: createDefaultPropertyValues(propertyEntries),\n    lifetimes: component.lifetimes ?? {},\n    pageLifetimes: component.pageLifetimes ?? {},\n  }\n  return {\n    state,\n    warnings,\n  }\n}\n\nexport function updateComponentRuntimeState(state: ComponentRuntimeState, options: DefineComponentOptions) {\n  const { component, warnings } = resolveNormalizedComponent(options.component ?? {})\n  const propertyEntries = createPropertyEntries(component)\n  state.templateRef = options.template\n  state.styleRef = options.style ?? ''\n  state.componentRef = component\n  state.observerInitEnabled = Boolean(options.observerInit)\n  state.lifetimes = component.lifetimes ?? {}\n  state.pageLifetimes = component.pageLifetimes ?? {}\n  state.propertyEntries = propertyEntries\n  state.observedAttributes = createObservedAttributes(propertyEntries)\n  state.defaultPropertyValues = createDefaultPropertyValues(propertyEntries)\n  return {\n    warnings,\n    nextMethods: component.methods ?? {},\n  }\n}\n"],"mappings":";;;;;AA0BA,SAAS,2BAA2B,WAAyC;CAC3E,MAAM,aAAa,mBAAmB,SAAS;CAC/C,OAAO;EACL,UAAU,WAAW;EACrB,WAAW,WAAW,aAAa,aAAa,CAAC;CACnD;AACF;AAEA,SAAS,4BAA4B,iBAAkC;CACrE,OAAO,gBAAgB,QAAoB,KAAK,CAAC,MAAM,UAAU;EAC/D,IAAI,OAAO,MAAM,OAAO,GACtB,IAAI,QAAQ,WAAW,KAAK,KAAK;OAGjC,IAAI,QAAQ;EAEd,OAAO;CACT,GAAG,CAAC,CAAC;AACP;AAEA,SAAS,sBAAsB,WAA8C;CAC3E,OAAO,OAAO,QAAQ,UAAU,cAAc,CAAC,CAAC;AAClD;AAEA,SAAS,yBAAyB,iBAAkC;CAClE,OAAO,gBAAgB,KAAK,CAAC,UAAU,UAAU,IAAI,CAAC;AACxD;AAEA,SAAgB,4BAA4B,SAAiC;CAC3E,MAAM,EAAE,WAAW,aAAa,2BAA2B,QAAQ,aAAa,CAAC,CAAC;CAClF,MAAM,kBAAkB,sBAAsB,SAAS;CAYvD,OAAO;EACL;GAXA,aAAa,QAAQ;GACrB,UAAU,QAAQ,SAAS;GAC3B,cAAc;GACd,qBAAqB,QAAQ,QAAQ,YAAY;GACjD;GACA,oBAAoB,yBAAyB,eAAe;GAC5D,uBAAuB,4BAA4B,eAAe;GAClE,WAAW,UAAU,aAAa,CAAC;GACnC,eAAe,UAAU,iBAAiB,CAAC;EAGvC;EACJ;CACF;AACF;AAEA,SAAgB,4BAA4B,OAA8B,SAAiC;CACzG,MAAM,EAAE,WAAW,aAAa,2BAA2B,QAAQ,aAAa,CAAC,CAAC;CAClF,MAAM,kBAAkB,sBAAsB,SAAS;CACvD,MAAM,cAAc,QAAQ;CAC5B,MAAM,WAAW,QAAQ,SAAS;CAClC,MAAM,eAAe;CACrB,MAAM,sBAAsB,QAAQ,QAAQ,YAAY;CACxD,MAAM,YAAY,UAAU,aAAa,CAAC;CAC1C,MAAM,gBAAgB,UAAU,iBAAiB,CAAC;CAClD,MAAM,kBAAkB;CACxB,MAAM,qBAAqB,yBAAyB,eAAe;CACnE,MAAM,wBAAwB,4BAA4B,eAAe;CACzE,OAAO;EACL;EACA,aAAa,UAAU,WAAW,CAAC;CACrC;AACF"}
+{"version":3,"file":"state.mjs","names":[],"sources":["../../../src/runtime/component/state.ts"],"sourcesContent":["import type {\n  ComponentOptions,\n  DataRecord,\n  DefineComponentOptions,\n  LifeTimeHooks,\n  NormalizedComponentOptions,\n  PageLifeTimeHooks,\n  PropertyDeclaration,\n  PropertyOption,\n} from './types'\nimport { hasOwn } from '../utils/object'\nimport { normalizeBehaviors } from './behavior'\nimport { cloneValue, hyphenate } from './utils'\n\ntype PropertyEntry = [string, PropertyOption]\n\nexport interface ComponentRuntimeState {\n  id?: string\n  templateRef: DefineComponentOptions['template']\n  styleRef: string\n  componentRef: NormalizedComponentOptions\n  observerInitEnabled: boolean\n  propertyEntries: PropertyEntry[]\n  observedAttributes: string[]\n  defaultPropertyValues: DataRecord\n  lifetimes: LifeTimeHooks\n  pageLifetimes: PageLifeTimeHooks\n}\n\nfunction normalizePropertyDeclaration(declaration: PropertyDeclaration): PropertyOption {\n  if (declaration === null || typeof declaration === 'function') {\n    return { type: declaration }\n  }\n  return declaration\n}\n\nfunction resolveNormalizedComponent(component: ComponentOptions) {\n  const normalized = normalizeBehaviors(component)\n  const resolved = normalized.component!\n  return {\n    warnings: normalized.warnings,\n    component: {\n      ...resolved,\n      properties: Object.fromEntries(\n        Object.entries(resolved.properties ?? {}).map(([name, declaration]) => [\n          name,\n          normalizePropertyDeclaration(declaration),\n        ]),\n      ),\n    } satisfies NormalizedComponentOptions,\n  }\n}\n\nfunction createDefaultPropertyValues(propertyEntries: PropertyEntry[]) {\n  return propertyEntries.reduce<DataRecord>((acc, [name, prop]) => {\n    if (prop !== null && typeof prop === 'object' && hasOwn(prop, 'value')) {\n      acc[name] = cloneValue(prop.value)\n    }\n    else {\n      acc[name] = undefined\n    }\n    return acc\n  }, {})\n}\n\nfunction createPropertyEntries(component: NormalizedComponentOptions): PropertyEntry[] {\n  return Object.entries(component.properties)\n}\n\nfunction createObservedAttributes(propertyEntries: PropertyEntry[]) {\n  return propertyEntries.map(([name]) => hyphenate(name))\n}\n\nexport function createComponentRuntimeState(options: DefineComponentOptions) {\n  const { component, warnings } = resolveNormalizedComponent(options.component ?? {})\n  const propertyEntries = createPropertyEntries(component)\n  const state: ComponentRuntimeState = {\n    id: options.id,\n    templateRef: options.template,\n    styleRef: options.style ?? '',\n    componentRef: component,\n    observerInitEnabled: Boolean(options.observerInit),\n    propertyEntries,\n    observedAttributes: createObservedAttributes(propertyEntries),\n    defaultPropertyValues: createDefaultPropertyValues(propertyEntries),\n    lifetimes: component.lifetimes ?? {},\n    pageLifetimes: component.pageLifetimes ?? {},\n  }\n  return {\n    state,\n    warnings,\n  }\n}\n\nexport function updateComponentRuntimeState(state: ComponentRuntimeState, options: DefineComponentOptions) {\n  const { component, warnings } = resolveNormalizedComponent(options.component ?? {})\n  const propertyEntries = createPropertyEntries(component)\n  state.templateRef = options.template\n  state.id = options.id\n  state.styleRef = options.style ?? ''\n  state.componentRef = component\n  state.observerInitEnabled = Boolean(options.observerInit)\n  state.lifetimes = component.lifetimes ?? {}\n  state.pageLifetimes = component.pageLifetimes ?? {}\n  state.propertyEntries = propertyEntries\n  state.observedAttributes = createObservedAttributes(propertyEntries)\n  state.defaultPropertyValues = createDefaultPropertyValues(propertyEntries)\n  return {\n    warnings,\n    nextMethods: component.methods ?? {},\n  }\n}\n"],"mappings":";;;;;AA6BA,SAAS,6BAA6B,aAAkD;CACtF,IAAI,gBAAgB,QAAQ,OAAO,gBAAgB,YACjD,OAAO,EAAE,MAAM,YAAY;CAE7B,OAAO;AACT;AAEA,SAAS,2BAA2B,WAA6B;CAC/D,MAAM,aAAa,mBAAmB,SAAS;CAC/C,MAAM,WAAW,WAAW;CAC5B,OAAO;EACL,UAAU,WAAW;EACrB,WAAW;GACT,GAAG;GACH,YAAY,OAAO,YACjB,OAAO,QAAQ,SAAS,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,iBAAiB,CACrE,MACA,6BAA6B,WAAW,CAC1C,CAAC,CACH;EACF;CACF;AACF;AAEA,SAAS,4BAA4B,iBAAkC;CACrE,OAAO,gBAAgB,QAAoB,KAAK,CAAC,MAAM,UAAU;EAC/D,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,OAAO,MAAM,OAAO,GACnE,IAAI,QAAQ,WAAW,KAAK,KAAK;OAGjC,IAAI,QAAQ;EAEd,OAAO;CACT,GAAG,CAAC,CAAC;AACP;AAEA,SAAS,sBAAsB,WAAwD;CACrF,OAAO,OAAO,QAAQ,UAAU,UAAU;AAC5C;AAEA,SAAS,yBAAyB,iBAAkC;CAClE,OAAO,gBAAgB,KAAK,CAAC,UAAU,UAAU,IAAI,CAAC;AACxD;AAEA,SAAgB,4BAA4B,SAAiC;CAC3E,MAAM,EAAE,WAAW,aAAa,2BAA2B,QAAQ,aAAa,CAAC,CAAC;CAClF,MAAM,kBAAkB,sBAAsB,SAAS;CAavD,OAAO;EACL;GAZA,IAAI,QAAQ;GACZ,aAAa,QAAQ;GACrB,UAAU,QAAQ,SAAS;GAC3B,cAAc;GACd,qBAAqB,QAAQ,QAAQ,YAAY;GACjD;GACA,oBAAoB,yBAAyB,eAAe;GAC5D,uBAAuB,4BAA4B,eAAe;GAClE,WAAW,UAAU,aAAa,CAAC;GACnC,eAAe,UAAU,iBAAiB,CAAC;EAGvC;EACJ;CACF;AACF;AAEA,SAAgB,4BAA4B,OAA8B,SAAiC;CACzG,MAAM,EAAE,WAAW,aAAa,2BAA2B,QAAQ,aAAa,CAAC,CAAC;CAClF,MAAM,kBAAkB,sBAAsB,SAAS;CACvD,MAAM,cAAc,QAAQ;CAC5B,MAAM,KAAK,QAAQ;CACnB,MAAM,WAAW,QAAQ,SAAS;CAClC,MAAM,eAAe;CACrB,MAAM,sBAAsB,QAAQ,QAAQ,YAAY;CACxD,MAAM,YAAY,UAAU,aAAa,CAAC;CAC1C,MAAM,gBAAgB,UAAU,iBAAiB,CAAC;CAClD,MAAM,kBAAkB;CACxB,MAAM,qBAAqB,yBAAyB,eAAe;CACnE,MAAM,wBAAwB,4BAA4B,eAAe;CACzE,OAAO;EACL;EACA,aAAa,UAAU,WAAW,CAAC;CACrC;AACF"}

package/dist/runtime/component/types.d.mts

@@ -3,9 +3,11 @@ import { TemplateRenderer } from "../template.mjs";
 type DataRecord = Record<string, any>;
 interface PropertyOption {
   type?: StringConstructor | NumberConstructor | BooleanConstructor | ObjectConstructor | ArrayConstructor | null;
+  optionalTypes?: Array<StringConstructor | NumberConstructor | BooleanConstructor | ObjectConstructor | ArrayConstructor>;
   value?: any;
   observer?: (this: ComponentPublicInstance, newValue: any, oldValue: any) => void;
 }
+type PropertyDeclaration = PropertyOption | StringConstructor | NumberConstructor | BooleanConstructor | ObjectConstructor | ArrayConstructor | null;
 interface LifeTimeHooks {
   created?: (this: ComponentPublicInstance) => void;
   attached?: (this: ComponentPublicInstance) => void;
@@ -17,32 +19,55 @@ interface PageLifeTimeHooks {
   hide?: (this: ComponentPublicInstance) => void;
   resize?: (this: ComponentPublicInstance) => void;
 }
+type RelationType = 'parent' | 'child' | 'ancestor' | 'descendant';
+interface RelationOption {
+  type: RelationType;
+  linked?: (this: ComponentPublicInstance, target: ComponentPublicInstance) => void;
+  linkChanged?: (this: ComponentPublicInstance, target: ComponentPublicInstance) => void;
+  unlinked?: (this: ComponentPublicInstance, target: ComponentPublicInstance) => void;
+}
+interface ComponentBehaviorOptions {
+  addGlobalClass?: boolean;
+  styleIsolation?: 'isolated' | 'apply-shared' | 'shared';
+  virtualHost?: boolean;
+  [key: string]: unknown;
+}
 interface ComponentOptions {
-  properties?: Record<string, PropertyOption>;
+  properties?: Record<string, PropertyDeclaration>;
   data?: DataRecord | (() => DataRecord);
   methods?: Record<string, (this: ComponentPublicInstance, event: any) => any>;
+  observers?: Record<string, (this: ComponentPublicInstance, ...values: any[]) => void>;
   lifetimes?: LifeTimeHooks;
   pageLifetimes?: PageLifeTimeHooks;
+  relations?: Record<string, RelationOption>;
   behaviors?: ComponentOptions[];
+  options?: ComponentBehaviorOptions;
 }
 interface DefineComponentOptions {
+  id?: string;
   template: TemplateRenderer;
   style?: string;
   component?: ComponentOptions;
   observerInit?: boolean;
 }
+interface TriggerEventOptions {
+  bubbles?: boolean;
+  composed?: boolean;
+  capturePhase?: boolean;
+}
 interface ComponentPublicInstance extends HTMLElement {
   readonly data: DataRecord;
   readonly properties: DataRecord;
-  setData: (patch: DataRecord) => void;
-  triggerEvent: (name: string, detail?: any) => void;
+  setData: (patch: DataRecord, callback?: () => void) => void | Promise<void>;
+  triggerEvent: (name: string, detail?: any, options?: TriggerEventOptions) => void;
   createSelectorQuery: () => any;
   selectComponent: (selector: string) => ComponentPublicInstance | null;
   selectAllComponents: (selector: string) => ComponentPublicInstance[];
+  getRelationNodes: (relationPath: string) => ComponentPublicInstance[];
 }
 type ComponentConstructor = CustomElementConstructor & {
   __weappUpdate?: (options: DefineComponentOptions) => void;
 };
 //#endregion
-export { ComponentConstructor, ComponentOptions, ComponentPublicInstance, DataRecord, DefineComponentOptions, LifeTimeHooks, PageLifeTimeHooks, PropertyOption };
+export { ComponentBehaviorOptions, ComponentConstructor, ComponentOptions, ComponentPublicInstance, DataRecord, DefineComponentOptions, LifeTimeHooks, PageLifeTimeHooks, PropertyDeclaration, PropertyOption, RelationOption, RelationType, TriggerEventOptions };
 //# sourceMappingURL=types.d.mts.map

package/dist/runtime/component/virtualHost.mjs

@@ -0,0 +1,83 @@
+//#region src/runtime/component/virtualHost.ts
+function parseClassTokens(value) {
+	return new Set((value ?? "").split(/\s+/).filter(Boolean));
+}
+function writeTokens(element, name, tokens) {
+	const value = Array.from(tokens).join(" ");
+	if (value) {
+		if (element.getAttribute(name) !== value) element.setAttribute(name, value);
+	} else if (element.getAttribute(name) !== null) element.removeAttribute(name);
+}
+function isClassAttributeElement(value) {
+	return Boolean(value && typeof value === "object" && typeof value.getAttribute === "function" && typeof value.setAttribute === "function");
+}
+function resolveVirtualRootElement(root) {
+	for (const child of Array.from(root.childNodes ?? [])) {
+		if (!isClassAttributeElement(child)) continue;
+		if (child.tagName?.toLowerCase() === "style") continue;
+		return child;
+	}
+}
+/**
+* 将 virtualHost 根节点的 class 暴露到 Web 自定义元素宿主。
+*
+* 微信的虚拟宿主不会形成样式边界，父组件可以通过 external class
+* 和 deep 选择器命中子组件根节点。Web 仍使用 Shadow DOM 保留 slot
+* 投影，因此需要把根节点的 class token 同步到宿主来还原该选择器语义。
+*/
+function syncVirtualHostClasses(host, root, ownedRuntimeTokens) {
+	const nextRuntimeTokens = parseClassTokens(resolveVirtualRootElement(root)?.getAttribute("class"));
+	const hostTokens = parseClassTokens(host.getAttribute("class"));
+	for (const token of ownedRuntimeTokens) hostTokens.delete(token);
+	ownedRuntimeTokens.clear();
+	for (const token of nextRuntimeTokens) {
+		if (!hostTokens.has(token)) ownedRuntimeTokens.add(token);
+		hostTokens.add(token);
+	}
+	writeTokens(host, "class", hostTokens);
+}
+/**
+* 移除 runtime 为 virtualHost 同步的 class，并保留调用方宿主 class。
+*/
+function clearVirtualHostClasses(host, ownedRuntimeTokens) {
+	if (ownedRuntimeTokens.size === 0) return;
+	const hostTokens = parseClassTokens(host.getAttribute("class"));
+	for (const token of ownedRuntimeTokens) hostTokens.delete(token);
+	writeTokens(host, "class", hostTokens);
+	ownedRuntimeTokens.clear();
+}
+/**
+* 清除 runtime 暴露的 CSS part，并保留组件模板声明的 part。
+*/
+function clearVirtualHostParts(rootElement, ownedPartTokens) {
+	if (!rootElement || ownedPartTokens.size === 0) return;
+	const partTokens = parseClassTokens(rootElement.getAttribute("part"));
+	for (const token of ownedPartTokens) partTokens.delete(token);
+	writeTokens(rootElement, "part", partTokens);
+	ownedPartTokens.clear();
+}
+/**
+* 将 virtualHost 根 class 同步为 CSS part，使父组件可以跨 Shadow DOM
+* 对子组件根节点应用 deep 样式。
+*/
+function syncVirtualHostParts(root, previousRootElement, ownedPartTokens) {
+	const rootElement = resolveVirtualRootElement(root);
+	if (previousRootElement && previousRootElement !== rootElement) clearVirtualHostParts(previousRootElement, ownedPartTokens);
+	if (!rootElement) {
+		ownedPartTokens.clear();
+		return;
+	}
+	const partTokens = parseClassTokens(rootElement.getAttribute("part"));
+	for (const token of ownedPartTokens) partTokens.delete(token);
+	ownedPartTokens.clear();
+	for (const token of parseClassTokens(rootElement.getAttribute("class"))) {
+		if (!partTokens.has(token)) ownedPartTokens.add(token);
+		partTokens.add(token);
+	}
+	writeTokens(rootElement, "part", partTokens);
+	return rootElement;
+}
+
+//#endregion
+export { clearVirtualHostClasses, clearVirtualHostParts, syncVirtualHostClasses, syncVirtualHostParts };
+//# sourceMappingURL=virtualHost.mjs.map

package/dist/runtime/component/virtualHost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualHost.mjs","names":[],"sources":["../../../src/runtime/component/virtualHost.ts"],"sourcesContent":["export interface ClassAttributeElement {\n  getAttribute: (name: string) => string | null\n  removeAttribute: (name: string) => void\n  setAttribute: (name: string, value: string) => void\n}\n\ninterface RenderRootLike {\n  childNodes?: ArrayLike<unknown>\n}\n\nfunction parseClassTokens(value: string | null | undefined) {\n  return new Set((value ?? '').split(/\\s+/).filter(Boolean))\n}\n\nfunction writeTokens(element: ClassAttributeElement, name: string, tokens: Set<string>) {\n  const value = Array.from(tokens).join(' ')\n  if (value) {\n    if (element.getAttribute(name) !== value) {\n      element.setAttribute(name, value)\n    }\n  }\n  else if (element.getAttribute(name) !== null) {\n    element.removeAttribute(name)\n  }\n}\n\nfunction isClassAttributeElement(value: unknown): value is ClassAttributeElement & { tagName?: string } {\n  return Boolean(\n    value\n    && typeof value === 'object'\n    && typeof (value as ClassAttributeElement).getAttribute === 'function'\n    && typeof (value as ClassAttributeElement).setAttribute === 'function',\n  )\n}\n\nfunction resolveVirtualRootElement(root: RenderRootLike) {\n  for (const child of Array.from(root.childNodes ?? [])) {\n    if (!isClassAttributeElement(child)) {\n      continue\n    }\n    if (child.tagName?.toLowerCase() === 'style') {\n      continue\n    }\n    return child\n  }\n  return undefined\n}\n\n/**\n * 将 virtualHost 根节点的 class 暴露到 Web 自定义元素宿主。\n *\n * 微信的虚拟宿主不会形成样式边界，父组件可以通过 external class\n * 和 deep 选择器命中子组件根节点。Web 仍使用 Shadow DOM 保留 slot\n * 投影，因此需要把根节点的 class token 同步到宿主来还原该选择器语义。\n */\nexport function syncVirtualHostClasses(\n  host: ClassAttributeElement,\n  root: RenderRootLike,\n  ownedRuntimeTokens: Set<string>,\n) {\n  const rootElement = resolveVirtualRootElement(root)\n  const nextRuntimeTokens = parseClassTokens(rootElement?.getAttribute('class'))\n  const hostTokens = parseClassTokens(host.getAttribute('class'))\n\n  for (const token of ownedRuntimeTokens) {\n    hostTokens.delete(token)\n  }\n  ownedRuntimeTokens.clear()\n  for (const token of nextRuntimeTokens) {\n    if (!hostTokens.has(token)) {\n      ownedRuntimeTokens.add(token)\n    }\n    hostTokens.add(token)\n  }\n\n  writeTokens(host, 'class', hostTokens)\n}\n\n/**\n * 移除 runtime 为 virtualHost 同步的 class，并保留调用方宿主 class。\n */\nexport function clearVirtualHostClasses(\n  host: ClassAttributeElement,\n  ownedRuntimeTokens: Set<string>,\n) {\n  if (ownedRuntimeTokens.size === 0) {\n    return\n  }\n  const hostTokens = parseClassTokens(host.getAttribute('class'))\n  for (const token of ownedRuntimeTokens) {\n    hostTokens.delete(token)\n  }\n  writeTokens(host, 'class', hostTokens)\n  ownedRuntimeTokens.clear()\n}\n\n/**\n * 清除 runtime 暴露的 CSS part，并保留组件模板声明的 part。\n */\nexport function clearVirtualHostParts(\n  rootElement: ClassAttributeElement | undefined,\n  ownedPartTokens: Set<string>,\n) {\n  if (!rootElement || ownedPartTokens.size === 0) {\n    return\n  }\n  const partTokens = parseClassTokens(rootElement.getAttribute('part'))\n  for (const token of ownedPartTokens) {\n    partTokens.delete(token)\n  }\n  writeTokens(rootElement, 'part', partTokens)\n  ownedPartTokens.clear()\n}\n\n/**\n * 将 virtualHost 根 class 同步为 CSS part，使父组件可以跨 Shadow DOM\n * 对子组件根节点应用 deep 样式。\n */\nexport function syncVirtualHostParts(\n  root: RenderRootLike,\n  previousRootElement: ClassAttributeElement | undefined,\n  ownedPartTokens: Set<string>,\n) {\n  const rootElement = resolveVirtualRootElement(root)\n  if (previousRootElement && previousRootElement !== rootElement) {\n    clearVirtualHostParts(previousRootElement, ownedPartTokens)\n  }\n  if (!rootElement) {\n    ownedPartTokens.clear()\n    return undefined\n  }\n\n  const partTokens = parseClassTokens(rootElement.getAttribute('part'))\n  for (const token of ownedPartTokens) {\n    partTokens.delete(token)\n  }\n  ownedPartTokens.clear()\n  for (const token of parseClassTokens(rootElement.getAttribute('class'))) {\n    if (!partTokens.has(token)) {\n      ownedPartTokens.add(token)\n    }\n    partTokens.add(token)\n  }\n  writeTokens(rootElement, 'part', partTokens)\n  return rootElement\n}\n"],"mappings":";AAUA,SAAS,iBAAiB,OAAkC;CAC1D,OAAO,IAAI,KAAK,SAAS,GAAE,CAAE,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC;AAC3D;AAEA,SAAS,YAAY,SAAgC,MAAc,QAAqB;CACtF,MAAM,QAAQ,MAAM,KAAK,MAAM,CAAC,CAAC,KAAK,GAAG;CACzC,IAAI,OACF;MAAI,QAAQ,aAAa,IAAI,MAAM,OACjC,QAAQ,aAAa,MAAM,KAAK;CAClC,OAEG,IAAI,QAAQ,aAAa,IAAI,MAAM,MACtC,QAAQ,gBAAgB,IAAI;AAEhC;AAEA,SAAS,wBAAwB,OAAuE;CACtG,OAAO,QACL,SACG,OAAO,UAAU,YACjB,OAAQ,MAAgC,iBAAiB,cACzD,OAAQ,MAAgC,iBAAiB,UAC9D;AACF;AAEA,SAAS,0BAA0B,MAAsB;CACvD,KAAK,MAAM,SAAS,MAAM,KAAK,KAAK,cAAc,CAAC,CAAC,GAAG;EACrD,IAAI,CAAC,wBAAwB,KAAK,GAChC;EAEF,IAAI,MAAM,SAAS,YAAY,MAAM,SACnC;EAEF,OAAO;CACT;AAEF;;;;;;;;AASA,SAAgB,uBACd,MACA,MACA,oBACA;CAEA,MAAM,oBAAoB,iBADN,0BAA0B,IACO,CAAC,EAAE,aAAa,OAAO,CAAC;CAC7E,MAAM,aAAa,iBAAiB,KAAK,aAAa,OAAO,CAAC;CAE9D,KAAK,MAAM,SAAS,oBAClB,WAAW,OAAO,KAAK;CAEzB,mBAAmB,MAAM;CACzB,KAAK,MAAM,SAAS,mBAAmB;EACrC,IAAI,CAAC,WAAW,IAAI,KAAK,GACvB,mBAAmB,IAAI,KAAK;EAE9B,WAAW,IAAI,KAAK;CACtB;CAEA,YAAY,MAAM,SAAS,UAAU;AACvC;;;;AAKA,SAAgB,wBACd,MACA,oBACA;CACA,IAAI,mBAAmB,SAAS,GAC9B;CAEF,MAAM,aAAa,iBAAiB,KAAK,aAAa,OAAO,CAAC;CAC9D,KAAK,MAAM,SAAS,oBAClB,WAAW,OAAO,KAAK;CAEzB,YAAY,MAAM,SAAS,UAAU;CACrC,mBAAmB,MAAM;AAC3B;;;;AAKA,SAAgB,sBACd,aACA,iBACA;CACA,IAAI,CAAC,eAAe,gBAAgB,SAAS,GAC3C;CAEF,MAAM,aAAa,iBAAiB,YAAY,aAAa,MAAM,CAAC;CACpE,KAAK,MAAM,SAAS,iBAClB,WAAW,OAAO,KAAK;CAEzB,YAAY,aAAa,QAAQ,UAAU;CAC3C,gBAAgB,MAAM;AACxB;;;;;AAMA,SAAgB,qBACd,MACA,qBACA,iBACA;CACA,MAAM,cAAc,0BAA0B,IAAI;CAClD,IAAI,uBAAuB,wBAAwB,aACjD,sBAAsB,qBAAqB,eAAe;CAE5D,IAAI,CAAC,aAAa;EAChB,gBAAgB,MAAM;EACtB;CACF;CAEA,MAAM,aAAa,iBAAiB,YAAY,aAAa,MAAM,CAAC;CACpE,KAAK,MAAM,SAAS,iBAClB,WAAW,OAAO,KAAK;CAEzB,gBAAgB,MAAM;CACtB,KAAK,MAAM,SAAS,iBAAiB,YAAY,aAAa,OAAO,CAAC,GAAG;EACvE,IAAI,CAAC,WAAW,IAAI,KAAK,GACvB,gBAAgB,IAAI,KAAK;EAE3B,WAAW,IAAI,KAAK;CACtB;CACA,YAAY,aAAa,QAAQ,UAAU;CAC3C,OAAO;AACT"}

package/dist/runtime/host/index.d.mts

@@ -0,0 +1,13 @@
+import { WebRuntimeClipboard, WebRuntimeDialogs, WebRuntimeHost, WebRuntimeStorage } from "./types.mjs";
+//#region src/runtime/host/index.d.ts
+declare function getWebRuntimeHost(): Readonly<WebRuntimeHost>;
+declare function setWebRuntimeHost(host?: WebRuntimeHost): void;
+declare function resetWebRuntimeHost(): void;
+declare function getRuntimeFetch(): ((input: RequestInfo | URL, init?: RequestInit) => Promise<Response>) | undefined;
+declare function getRuntimeStorage(): WebRuntimeStorage | undefined;
+declare function getRuntimeClipboard(): WebRuntimeClipboard | undefined;
+declare function getRuntimeDialogs(): WebRuntimeDialogs;
+declare function openRuntimeUrl(url?: string, target?: string, features?: string): unknown;
+//#endregion
+export { type WebRuntimeClipboard, type WebRuntimeDialogs, type WebRuntimeHost, type WebRuntimeStorage, getRuntimeClipboard, getRuntimeDialogs, getRuntimeFetch, getRuntimeStorage, getWebRuntimeHost, openRuntimeUrl, resetWebRuntimeHost, setWebRuntimeHost };
+//# sourceMappingURL=index.d.mts.map

package/dist/runtime/host/index.mjs

@@ -0,0 +1,47 @@
+//#region src/runtime/host/index.ts
+let runtimeHost = {};
+function getWebRuntimeHost() {
+	return runtimeHost;
+}
+function setWebRuntimeHost(host) {
+	runtimeHost = host ? { ...host } : {};
+}
+function resetWebRuntimeHost() {
+	runtimeHost = {};
+}
+function getRuntimeFetch() {
+	if (typeof runtimeHost.fetch === "function") return runtimeHost.fetch;
+	const runtimeGlobal = globalThis;
+	return typeof runtimeGlobal.fetch === "function" ? runtimeGlobal.fetch : void 0;
+}
+function getRuntimeStorage() {
+	if (runtimeHost.storage) return runtimeHost.storage;
+	return globalThis.localStorage;
+}
+function getRuntimeClipboard() {
+	if (runtimeHost.clipboard) return runtimeHost.clipboard;
+	return globalThis.navigator?.clipboard;
+}
+function getRuntimeDialogs() {
+	if (runtimeHost.dialogs) return runtimeHost.dialogs;
+	const runtimeGlobal = globalThis;
+	return {
+		alert: runtimeGlobal.alert,
+		confirm: runtimeGlobal.confirm,
+		prompt: runtimeGlobal.prompt
+	};
+}
+function openRuntimeUrl(url, target, features) {
+	if (typeof runtimeHost.open === "function") {
+		if (features === void 0) return runtimeHost.open(url, target);
+		return runtimeHost.open(url, target, features);
+	}
+	const runtimeGlobal = globalThis;
+	const runtimeOpen = runtimeGlobal.window?.open ?? runtimeGlobal.open;
+	if (features === void 0) return runtimeOpen?.(url, target);
+	return runtimeOpen?.(url, target, features);
+}
+
+//#endregion
+export { getRuntimeClipboard, getRuntimeDialogs, getRuntimeFetch, getRuntimeStorage, getWebRuntimeHost, openRuntimeUrl, resetWebRuntimeHost, setWebRuntimeHost };
+//# sourceMappingURL=index.mjs.map

package/dist/runtime/host/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["runtimeGlobal"],"sources":["../../../src/runtime/host/index.ts"],"sourcesContent":["import type { WebRuntimeDialogs, WebRuntimeHost } from './types'\n\nlet runtimeHost: WebRuntimeHost = {}\n\nexport function getWebRuntimeHost(): Readonly<WebRuntimeHost> {\n  return runtimeHost\n}\n\nexport function setWebRuntimeHost(host?: WebRuntimeHost): void {\n  runtimeHost = host ? { ...host } : {}\n}\n\nexport function resetWebRuntimeHost(): void {\n  runtimeHost = {}\n}\n\nexport function getRuntimeFetch() {\n  if (typeof runtimeHost.fetch === 'function') {\n    return runtimeHost.fetch\n  }\n  const runtimeGlobal = globalThis as { fetch?: WebRuntimeHost['fetch'] }\n  return typeof runtimeGlobal.fetch === 'function' ? runtimeGlobal.fetch : undefined\n}\n\nexport function getRuntimeStorage() {\n  if (runtimeHost.storage) {\n    return runtimeHost.storage\n  }\n  const runtimeGlobal = globalThis as { localStorage?: WebRuntimeHost['storage'] }\n  return runtimeGlobal.localStorage\n}\n\nexport function getRuntimeClipboard() {\n  if (runtimeHost.clipboard) {\n    return runtimeHost.clipboard\n  }\n  const runtimeGlobal = globalThis as { navigator?: { clipboard?: WebRuntimeHost['clipboard'] } }\n  return runtimeGlobal.navigator?.clipboard\n}\n\nexport function getRuntimeDialogs() {\n  if (runtimeHost.dialogs) {\n    return runtimeHost.dialogs\n  }\n  const runtimeGlobal = globalThis as WebRuntimeDialogs\n  return {\n    alert: runtimeGlobal.alert,\n    confirm: runtimeGlobal.confirm,\n    prompt: runtimeGlobal.prompt,\n  }\n}\n\nexport function openRuntimeUrl(url?: string, target?: string, features?: string) {\n  if (typeof runtimeHost.open === 'function') {\n    if (features === undefined) {\n      return runtimeHost.open(url, target)\n    }\n    return runtimeHost.open(url, target, features)\n  }\n  const runtimeGlobal = globalThis as {\n    open?: WebRuntimeHost['open']\n    window?: { open?: WebRuntimeHost['open'] }\n  }\n  const runtimeOpen = runtimeGlobal.window?.open ?? runtimeGlobal.open\n  if (features === undefined) {\n    return runtimeOpen?.(url, target)\n  }\n  return runtimeOpen?.(url, target, features)\n}\n\nexport type { WebRuntimeClipboard, WebRuntimeDialogs, WebRuntimeHost, WebRuntimeStorage } from './types'\n"],"mappings":";AAEA,IAAI,cAA8B,CAAC;AAEnC,SAAgB,oBAA8C;CAC5D,OAAO;AACT;AAEA,SAAgB,kBAAkB,MAA6B;CAC7D,cAAc,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;AACtC;AAEA,SAAgB,sBAA4B;CAC1C,cAAc,CAAC;AACjB;AAEA,SAAgB,kBAAkB;CAChC,IAAI,OAAO,YAAY,UAAU,YAC/B,OAAO,YAAY;CAErB,MAAM,gBAAgB;CACtB,OAAO,OAAO,cAAc,UAAU,aAAa,cAAc,QAAQ;AAC3E;AAEA,SAAgB,oBAAoB;CAClC,IAAI,YAAY,SACd,OAAO,YAAY;CAGrB,OAAOA,WAAc;AACvB;AAEA,SAAgB,sBAAsB;CACpC,IAAI,YAAY,WACd,OAAO,YAAY;CAGrB,OAAOA,WAAc,WAAW;AAClC;AAEA,SAAgB,oBAAoB;CAClC,IAAI,YAAY,SACd,OAAO,YAAY;CAErB,MAAM,gBAAgB;CACtB,OAAO;EACL,OAAO,cAAc;EACrB,SAAS,cAAc;EACvB,QAAQ,cAAc;CACxB;AACF;AAEA,SAAgB,eAAe,KAAc,QAAiB,UAAmB;CAC/E,IAAI,OAAO,YAAY,SAAS,YAAY;EAC1C,IAAI,aAAa,QACf,OAAO,YAAY,KAAK,KAAK,MAAM;EAErC,OAAO,YAAY,KAAK,KAAK,QAAQ,QAAQ;CAC/C;CACA,MAAM,gBAAgB;CAItB,MAAM,cAAc,cAAc,QAAQ,QAAQ,cAAc;CAChE,IAAI,aAAa,QACf,OAAO,cAAc,KAAK,MAAM;CAElC,OAAO,cAAc,KAAK,QAAQ,QAAQ;AAC5C"}

package/dist/runtime/host/types.d.mts

@@ -0,0 +1,28 @@
+//#region src/runtime/host/types.d.ts
+interface WebRuntimeStorage {
+  readonly length: number;
+  clear: () => void;
+  getItem: (key: string) => string | null;
+  key: (index: number) => string | null;
+  removeItem: (key: string) => void;
+  setItem: (key: string, value: string) => void;
+}
+interface WebRuntimeClipboard {
+  readText: () => string | Promise<string>;
+  writeText: (value: string) => void | Promise<void>;
+}
+interface WebRuntimeDialogs {
+  alert?: (message?: string) => void;
+  confirm?: (message?: string) => boolean;
+  prompt?: (message?: string, defaultValue?: string) => string | null;
+}
+interface WebRuntimeHost {
+  clipboard?: WebRuntimeClipboard;
+  dialogs?: WebRuntimeDialogs;
+  fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+  open?: (url?: string, target?: string, features?: string) => unknown;
+  storage?: WebRuntimeStorage;
+}
+//#endregion
+export { WebRuntimeClipboard, WebRuntimeDialogs, WebRuntimeHost, WebRuntimeStorage };
+//# sourceMappingURL=types.d.mts.map

package/dist/runtime/hostGlobals.d.mts

@@ -0,0 +1,9 @@
+//#region src/runtime/hostGlobals.d.ts
+type HostGlobalsTarget = Record<PropertyKey, any>;
+/**
+ * 安装第三方库在模块求值阶段可能读取的小程序宿主全局。
+ */
+declare function installWebHostGlobals(target?: HostGlobalsTarget): void;
+//#endregion
+export { installWebHostGlobals };
+//# sourceMappingURL=hostGlobals.d.mts.map

package/dist/runtime/hostGlobals.mjs

@@ -0,0 +1,39 @@
+import { emitRuntimeWarning } from "./warning.mjs";
+
+//#region src/runtime/hostGlobals.ts
+const IDENTITY_CONSTRUCTORS = [
+	"App",
+	"Page",
+	"Component"
+];
+const COMPILE_TIME_MACROS = [
+	"defineAppJson",
+	"defineComponentJson",
+	"definePageJson",
+	"definePageMeta",
+	"defineSitemapJson",
+	"defineThemeJson"
+];
+const PLUGIN_METHOD_RE = /^(?:add|can|choose|clear|close|create|delete|get|has|hide|is|load|navigate|off|on|open|remove|request|save|say|set|show|start|stop|update|upload)/i;
+function createUnsupportedPlugin() {
+	return new Proxy(Object.create(null), { get(_target, property) {
+		if (property === "then") return;
+		if (typeof property === "string" && PLUGIN_METHOD_RE.test(property)) return () => void 0;
+	} });
+}
+/**
+* 安装第三方库在模块求值阶段可能读取的小程序宿主全局。
+*/
+function installWebHostGlobals(target = globalThis) {
+	for (const name of IDENTITY_CONSTRUCTORS) if (typeof target[name] !== "function") target[name] = (options) => options;
+	for (const name of COMPILE_TIME_MACROS) if (typeof target[name] !== "function") target[name] = (options) => options;
+	if (typeof target.Behavior !== "function") target.Behavior = (options) => options;
+	if (typeof target.requirePlugin !== "function") target.requirePlugin = (pluginName) => {
+		emitRuntimeWarning(`[@weapp-vite/web] 插件 ${JSON.stringify(pluginName)} 暂无 Web 运行时实现，当前使用空代理降级。`, { key: `unsupported-plugin:${pluginName}` });
+		return createUnsupportedPlugin();
+	};
+}
+
+//#endregion
+export { installWebHostGlobals };
+//# sourceMappingURL=hostGlobals.mjs.map

package/dist/runtime/hostGlobals.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostGlobals.mjs","names":[],"sources":["../../src/runtime/hostGlobals.ts"],"sourcesContent":["import { emitRuntimeWarning } from './warning'\n\ntype HostGlobalsTarget = Record<PropertyKey, any>\n\nconst IDENTITY_CONSTRUCTORS = ['App', 'Page', 'Component'] as const\nconst COMPILE_TIME_MACROS = [\n  'defineAppJson',\n  'defineComponentJson',\n  'definePageJson',\n  'definePageMeta',\n  'defineSitemapJson',\n  'defineThemeJson',\n] as const\n\nconst PLUGIN_METHOD_RE = /^(?:add|can|choose|clear|close|create|delete|get|has|hide|is|load|navigate|off|on|open|remove|request|save|say|set|show|start|stop|update|upload)/i\n\nfunction createUnsupportedPlugin() {\n  return new Proxy(Object.create(null) as Record<PropertyKey, unknown>, {\n    get(_target, property) {\n      if (property === 'then') {\n        return undefined\n      }\n      if (typeof property === 'string' && PLUGIN_METHOD_RE.test(property)) {\n        return () => undefined\n      }\n      return undefined\n    },\n  })\n}\n\n/**\n * 安装第三方库在模块求值阶段可能读取的小程序宿主全局。\n */\nexport function installWebHostGlobals(target: HostGlobalsTarget = globalThis): void {\n  for (const name of IDENTITY_CONSTRUCTORS) {\n    if (typeof target[name] !== 'function') {\n      target[name] = (options: Record<string, any>) => options\n    }\n  }\n  for (const name of COMPILE_TIME_MACROS) {\n    if (typeof target[name] !== 'function') {\n      target[name] = (options: unknown) => options\n    }\n  }\n  if (typeof target.Behavior !== 'function') {\n    target.Behavior = (options: Record<string, any>) => options\n  }\n  if (typeof target.requirePlugin !== 'function') {\n    target.requirePlugin = (pluginName: string) => {\n      emitRuntimeWarning(`[@weapp-vite/web] 插件 ${JSON.stringify(pluginName)} 暂无 Web 运行时实现，当前使用空代理降级。`, {\n        key: `unsupported-plugin:${pluginName}`,\n      })\n      return createUnsupportedPlugin()\n    }\n  }\n}\n"],"mappings":";;;AAIA,MAAM,wBAAwB;CAAC;CAAO;CAAQ;AAAW;AACzD,MAAM,sBAAsB;CAC1B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,mBAAmB;AAEzB,SAAS,0BAA0B;CACjC,OAAO,IAAI,MAAM,OAAO,OAAO,IAAI,GAAmC,EACpE,IAAI,SAAS,UAAU;EACrB,IAAI,aAAa,QACf;EAEF,IAAI,OAAO,aAAa,YAAY,iBAAiB,KAAK,QAAQ,GAChE,aAAa;CAGjB,EACF,CAAC;AACH;;;;AAKA,SAAgB,sBAAsB,SAA4B,YAAkB;CAClF,KAAK,MAAM,QAAQ,uBACjB,IAAI,OAAO,OAAO,UAAU,YAC1B,OAAO,SAAS,YAAiC;CAGrD,KAAK,MAAM,QAAQ,qBACjB,IAAI,OAAO,OAAO,UAAU,YAC1B,OAAO,SAAS,YAAqB;CAGzC,IAAI,OAAO,OAAO,aAAa,YAC7B,OAAO,YAAY,YAAiC;CAEtD,IAAI,OAAO,OAAO,kBAAkB,YAClC,OAAO,iBAAiB,eAAuB;EAC7C,mBAAmB,wBAAwB,KAAK,UAAU,UAAU,EAAE,2BAA2B,EAC/F,KAAK,sBAAsB,aAC7B,CAAC;EACD,OAAO,wBAAwB;CACjC;AAEJ"}