@xihan-ui/web-components 1.0.0-alpha.0

package/dist/machine-controller-Bnr5jbhz.js

@@ -0,0 +1,267 @@
+import { createNormalizer } from "@xihan-ui/kernel";
+import { createService } from "@xihan-ui/machine";
+//#region src/dom/normalize.ts
+const wcNormalize = createNormalizer((props) => props);
+/** 元素自身是角色节点，或其子树里有角色节点。 */
+function containsPart(el) {
+	return el.hasAttribute("data-xh-part") || el.querySelector(`[data-xh-part]`) != null;
+}
+function discoverParts(host) {
+	const out = /* @__PURE__ */ new Map();
+	function walk(node) {
+		for (const child of Array.from(node.children)) {
+			if (child.tagName.toLowerCase().startsWith("xh-")) continue;
+			const el = child;
+			const part = el.dataset.xhPart;
+			if (part) {
+				const arr = out.get(part);
+				if (arr) arr.push(el);
+				else out.set(part, [el]);
+			}
+			walk(el);
+		}
+	}
+	walk(host);
+	return out;
+}
+//#endregion
+//#region src/dom/spread.ts
+const BOOLEAN_ATTRS = /* @__PURE__ */ new Set([
+	"disabled",
+	"hidden",
+	"inert",
+	"readonly",
+	"required",
+	"checked",
+	"selected",
+	"open",
+	"multiple"
+]);
+const PROP_KEYS = /* @__PURE__ */ new Set([
+	"value",
+	"checked",
+	"selected"
+]);
+function eventName(key) {
+	if (key.length > 2 && key.startsWith("on") && key[2] >= "A" && key[2] <= "Z") return key.slice(2).toLowerCase();
+	return null;
+}
+function setAttr(node, key, value) {
+	if (node.getAttribute(key) !== value) node.setAttribute(key, value);
+}
+function removeAttr(node, key) {
+	if (node.hasAttribute(key)) node.removeAttribute(key);
+}
+/**
+* 一个角色节点当前归哪台 spreader 管，最后写它的那台就是。
+* 只有仍持有归属的那台交还时才撤属性：两台同类宿主写的属性完全同名，接管后原宿主再撤会把接管方的一起删掉。
+*/
+const owners = /* @__PURE__ */ new WeakMap();
+function createSpreader() {
+	const owner = Symbol("spreader");
+	const state = /* @__PURE__ */ new WeakMap();
+	function spread(node, props) {
+		owners.set(node, owner);
+		let s = state.get(node);
+		if (!s) {
+			s = {
+				listeners: /* @__PURE__ */ new Map(),
+				attrs: /* @__PURE__ */ new Set()
+			};
+			state.set(node, s);
+		}
+		const nextAttrs = /* @__PURE__ */ new Set();
+		const nextEvents = /* @__PURE__ */ new Set();
+		for (const [key, value] of Object.entries(props)) {
+			const ev = eventName(key);
+			if (ev) {
+				nextEvents.add(ev);
+				const prev = s.listeners.get(ev);
+				if (prev) node.removeEventListener(ev, prev);
+				if (typeof value === "function") {
+					node.addEventListener(ev, value);
+					s.listeners.set(ev, value);
+				} else s.listeners.delete(ev);
+				continue;
+			}
+			if (key === "style" && value !== null && typeof value === "object") {
+				Object.assign(node.style, value);
+				continue;
+			}
+			if (value === void 0 || value === null || value === false) {
+				removeAttr(node, key);
+				continue;
+			}
+			nextAttrs.add(key);
+			if (PROP_KEYS.has(key)) {
+				node[key] = value;
+				continue;
+			}
+			if (BOOLEAN_ATTRS.has(key)) {
+				node.toggleAttribute(key, Boolean(value));
+				continue;
+			}
+			setAttr(node, key, String(value));
+		}
+		for (const key of s.attrs) if (!nextAttrs.has(key)) removeAttr(node, key);
+		for (const [ev, fn] of [...s.listeners]) if (!nextEvents.has(ev)) {
+			node.removeEventListener(ev, fn);
+			s.listeners.delete(ev);
+		}
+		s.attrs = nextAttrs;
+	}
+	function release(node) {
+		const s = state.get(node);
+		if (!s) return;
+		for (const [ev, fn] of s.listeners) node.removeEventListener(ev, fn);
+		if (owners.get(node) === owner) {
+			for (const key of s.attrs) node.removeAttribute(key);
+			owners.delete(node);
+		}
+		state.delete(node);
+	}
+	return {
+		spread,
+		release
+	};
+}
+//#endregion
+//#region src/runtime/lit-runtime.ts
+/** flush 最多等这么多轮更新；宿主一直自排新一轮时到此为止，回调照跑不吊死。 */
+const MAX_FLUSH_ROUNDS = 100;
+function createLitRuntime(host) {
+	const mounts = [];
+	const cleanups = [];
+	const trackers = [];
+	let mounted = false;
+	function cell(params) {
+		const p0 = params();
+		const eq = p0.isEqual ?? Object.is;
+		const initial = p0.defaultValue ?? p0.value;
+		let inner = initial;
+		let lastSeen = initial;
+		let version = 0;
+		const isControlled = () => params().value !== void 0;
+		const read = () => isControlled() ? params().value : inner;
+		return {
+			initial,
+			get: read,
+			set(next) {
+				const prev = read();
+				const value = typeof next === "function" ? next(prev) : next;
+				if (eq(value, prev)) return;
+				if (!isControlled()) inner = value;
+				params().onChange?.(value, prev);
+				host.requestUpdate();
+			},
+			notify: () => host.requestUpdate(),
+			version: () => {
+				const cur = read();
+				if (!eq(cur, lastSeen)) {
+					lastSeen = cur;
+					version += 1;
+				}
+				return version;
+			}
+		};
+	}
+	return {
+		name: "wc",
+		isServer: false,
+		cell,
+		track(deps, fn) {
+			trackers.push({
+				deps,
+				fn,
+				last: deps.map((d) => d())
+			});
+		},
+		flush(fn) {
+			(async () => {
+				await null;
+				let rounds = 0;
+				while (!await host.updateComplete && rounds < MAX_FLUSH_ROUNDS) rounds += 1;
+				fn();
+			})();
+		},
+		onMount(fn) {
+			mounts.push(fn);
+			if (mounted) fn();
+		},
+		onCleanup(fn) {
+			cleanups.push(fn);
+		},
+		mount() {
+			if (mounted) return;
+			mounted = true;
+			for (const fn of mounts) fn();
+		},
+		unmount() {
+			if (!mounted) return;
+			mounted = false;
+			for (let i = cleanups.length - 1; i >= 0; i--) cleanups[i]();
+			cleanups.length = 0;
+		},
+		runTrackers() {
+			let errors;
+			for (const t of trackers) {
+				const next = t.deps.map((d) => d());
+				if (!next.some((v, i) => !Object.is(v, t.last[i]))) continue;
+				const prev = t.last;
+				t.last = next;
+				try {
+					t.fn();
+				} catch (error) {
+					t.last = prev;
+					errors ??= [];
+					errors.push(error);
+				}
+			}
+			if (errors !== void 0) throw errors.length === 1 ? errors[0] : new AggregateError(errors, "tracker 抛错");
+		}
+	};
+}
+//#endregion
+//#region src/runtime/machine-controller.ts
+var MachineController = class {
+	host;
+	machine;
+	props;
+	opts;
+	service;
+	runtime;
+	started = false;
+	constructor(host, machine, props, opts = {}) {
+		this.host = host;
+		this.machine = machine;
+		this.props = props;
+		this.opts = opts;
+		host.addController(this);
+	}
+	build() {
+		this.runtime = createLitRuntime(this.host);
+		this.service = createService(this.machine, {
+			props: this.props,
+			runtime: this.runtime,
+			scope: this.opts.scope
+		});
+		this.opts.onBuilt?.(this.service);
+	}
+	hostConnected() {
+		if (!this.started || this.service.getStatus() === "Stopped") {
+			this.build();
+			this.started = true;
+		}
+		this.runtime.mount();
+	}
+	hostUpdate() {
+		this.runtime?.runTrackers();
+	}
+	hostDisconnected() {
+		this.runtime?.unmount();
+	}
+};
+//#endregion
+export { discoverParts as a, containsPart as i, createLitRuntime as n, wcNormalize as o, createSpreader as r, MachineController as t };
+
+//# sourceMappingURL=machine-controller-Bnr5jbhz.js.map

package/dist/machine-controller-Bnr5jbhz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-controller-Bnr5jbhz.js","names":[],"sources":["../src/dom/normalize.ts","../src/dom/parts.ts","../src/dom/spread.ts","../src/runtime/lit-runtime.ts","../src/runtime/machine-controller.ts"],"sourcesContent":["import { createNormalizer } from '@xihan-ui/kernel'\n\n// connect 产出的键已是 DOM 向，恒等透传，落到真实 DOM 由 spread 完成。\nexport const wcNormalize = createNormalizer(props => props)\n","/** 角色节点标记属性。 */\nexport const PART_ATTR = 'data-xh-part'\n\n/** 元素自身是角色节点，或其子树里有角色节点。 */\nexport function containsPart(el: Element): boolean {\n  return el.hasAttribute(PART_ATTR) || el.querySelector(`[${PART_ATTR}]`) != null\n}\n\n// 从宿主向下遍历收集带 data-xh-part 的节点，跳过嵌套 xh-* 子树。\nexport function discoverParts(host: HTMLElement): Map<string, HTMLElement[]> {\n  const out = new Map<string, HTMLElement[]>()\n\n  function walk(node: Element): void {\n    for (const child of Array.from(node.children)) {\n      if (child.tagName.toLowerCase().startsWith('xh-'))\n        continue\n      const el = child as HTMLElement\n      const part = el.dataset.xhPart\n      if (part) {\n        const arr = out.get(part)\n        if (arr)\n          arr.push(el)\n        else\n          out.set(part, [el])\n      }\n      walk(el)\n    }\n  }\n\n  walk(host)\n  return out\n}\n","// 把 connect 产出的 prop 字典打到 Light-DOM 角色节点上；事件每帧移旧加新，不碰 class。\n\nconst BOOLEAN_ATTRS = new Set(['disabled', 'hidden', 'inert', 'readonly', 'required', 'checked', 'selected', 'open', 'multiple'])\nconst PROP_KEYS = new Set(['value', 'checked', 'selected'])\n\ninterface NodeState {\n  listeners: Map<string, EventListener>\n  attrs: Set<string>\n}\n\nfunction eventName(key: string): string | null {\n  if (key.length > 2 && key.startsWith('on') && key[2]! >= 'A' && key[2]! <= 'Z')\n    return key.slice(2).toLowerCase()\n  return null\n}\n\n// 值相同则不写，避免多余的属性变更记录。\nfunction setAttr(node: HTMLElement, key: string, value: string): void {\n  if (node.getAttribute(key) !== value)\n    node.setAttribute(key, value)\n}\n\nfunction removeAttr(node: HTMLElement, key: string): void {\n  if (node.hasAttribute(key))\n    node.removeAttribute(key)\n}\n\nexport interface Spreader {\n  spread: (node: HTMLElement, props: Record<string, unknown>) => void\n  release: (node: HTMLElement) => void\n}\n\n/**\n * 一个角色节点当前归哪台 spreader 管，最后写它的那台就是。\n * 只有仍持有归属的那台交还时才撤属性：两台同类宿主写的属性完全同名，接管后原宿主再撤会把接管方的一起删掉。\n */\nconst owners = new WeakMap<Element, symbol>()\n\nexport function createSpreader(): Spreader {\n  const owner = Symbol('spreader')\n  const state = new WeakMap<Element, NodeState>()\n\n  function spread(node: HTMLElement, props: Record<string, unknown>): void {\n    owners.set(node, owner)\n    let s = state.get(node)\n    if (!s) {\n      s = { listeners: new Map(), attrs: new Set() }\n      state.set(node, s)\n    }\n    const nextAttrs = new Set<string>()\n    const nextEvents = new Set<string>()\n\n    for (const [key, value] of Object.entries(props)) {\n      const ev = eventName(key)\n      if (ev) {\n        nextEvents.add(ev)\n        const prev = s.listeners.get(ev)\n        if (prev)\n          node.removeEventListener(ev, prev)\n        if (typeof value === 'function') {\n          node.addEventListener(ev, value as EventListener)\n          s.listeners.set(ev, value as EventListener)\n        }\n        else {\n          s.listeners.delete(ev)\n        }\n        continue\n      }\n      // style 传对象时逐条写内联样式。\n      if (key === 'style' && value !== null && typeof value === 'object') {\n        Object.assign(node.style, value as Record<string, string>)\n        continue\n      }\n      if (value === undefined || value === null || value === false) {\n        removeAttr(node, key)\n        continue\n      }\n      nextAttrs.add(key)\n      if (PROP_KEYS.has(key)) {\n        (node as unknown as Record<string, unknown>)[key] = value\n        continue\n      }\n      if (BOOLEAN_ATTRS.has(key)) {\n        node.toggleAttribute(key, Boolean(value))\n        continue\n      }\n      setAttr(node, key, String(value))\n    }\n\n    // 移除上一帧写过、这一帧不再写的属性与事件监听器。\n    for (const key of s.attrs) {\n      if (!nextAttrs.has(key))\n        removeAttr(node, key)\n    }\n    for (const [ev, fn] of [...s.listeners]) {\n      if (!nextEvents.has(ev)) {\n        node.removeEventListener(ev, fn)\n        s.listeners.delete(ev)\n      }\n    }\n    s.attrs = nextAttrs\n  }\n\n  function release(node: HTMLElement): void {\n    const s = state.get(node)\n    if (!s)\n      return\n    for (const [ev, fn] of s.listeners) node.removeEventListener(ev, fn)\n    // 节点已被另一台宿主接管时只摘监听器，属性归接管方\n    if (owners.get(node) === owner) {\n      for (const key of s.attrs) node.removeAttribute(key)\n      owners.delete(node)\n    }\n    state.delete(node)\n  }\n\n  return { spread, release }\n}\n","import type { Bindable, CellParams, Dep, ReactiveRuntime } from '@xihan-ui/machine'\nimport type { ReactiveControllerHost } from '../reactive'\n\n// 把机器的 ReactiveRuntime 契约桥到自定义元素基类的 controller 生命周期。\n\nexport interface LitRuntime extends ReactiveRuntime {\n  /** hostConnected 调用，跑排队的 onMount。 */\n  mount: () => void\n  /** hostDisconnected 调用，逆序跑一次 cleanup。 */\n  unmount: () => void\n  /** hostUpdate 调用，逐 tracker 比对依赖、变则触发。 */\n  runTrackers: () => void\n}\n\ninterface Tracker {\n  deps: Dep[]\n  fn: () => void\n  last: unknown[]\n}\n\n/** flush 最多等这么多轮更新；宿主一直自排新一轮时到此为止，回调照跑不吊死。 */\nconst MAX_FLUSH_ROUNDS = 100\n\nexport function createLitRuntime(host: ReactiveControllerHost): LitRuntime {\n  const mounts: Array<() => void> = []\n  const cleanups: Array<() => void> = []\n  const trackers: Tracker[] = []\n  let mounted = false\n\n  function cell<V>(params: () => CellParams<V>): Bindable<V> {\n    const p0 = params()\n    const eq = p0.isEqual ?? Object.is\n    const initial = (p0.defaultValue ?? p0.value) as V\n    let inner = initial\n    let lastSeen = initial\n    let version = 0\n    const isControlled = (): boolean => params().value !== undefined\n    const read = (): V => (isControlled() ? (params().value as V) : inner)\n    return {\n      initial,\n      get: read,\n      set(next) {\n        const prev = read()\n        const value = typeof next === 'function' ? (next as (p: V) => V)(prev) : next\n        if (eq(value, prev))\n          return\n        if (!isControlled())\n          inner = value\n        params().onChange?.(value, prev)\n        host.requestUpdate()\n      },\n      notify: () => host.requestUpdate(),\n      // 版本号按值拉取比对，受控值不经过 set。\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  return {\n    name: 'wc',\n    isServer: false,\n    cell,\n    track(deps, fn) {\n      trackers.push({ deps, fn, last: deps.map(d => d()) })\n    },\n    flush(fn) {\n      void (async () => {\n        // 先让出一次微任务，等这次转移把宿主的更新排上队，再去读 updateComplete\n        await null\n        // updateComplete resolve 成 false 表示更新途中又排了新一轮，DOM 还没落定，接着等下一轮。\n        let rounds = 0\n        while (!(await host.updateComplete) && rounds < MAX_FLUSH_ROUNDS)\n          rounds += 1\n        fn()\n      })()\n    },\n    onMount(fn) {\n      mounts.push(fn)\n      if (mounted)\n        fn()\n    },\n    onCleanup(fn) {\n      cleanups.push(fn)\n    },\n    mount() {\n      if (mounted)\n        return\n      mounted = true\n      for (const fn of mounts) fn()\n    },\n    unmount() {\n      if (!mounted)\n        return\n      mounted = false\n      for (let i = cleanups.length - 1; i >= 0; i--) cleanups[i]!()\n      cleanups.length = 0\n    },\n    runTrackers() {\n      let errors: unknown[] | undefined\n      for (const t of trackers) {\n        const next = t.deps.map(d => d())\n        if (!next.some((v, i) => !Object.is(v, t.last[i])))\n          continue\n        const prev = t.last\n        // 跑之前先推进：fn 内部若又进到 runTrackers，不会拿同一次变化再触发一遍。\n        t.last = next\n        try {\n          t.fn()\n        }\n        catch (error) {\n          // 回滚到未消费，这次变化留给下一轮补跑；错误攒着，先把余下 tracker 跑完。\n          t.last = prev\n          errors ??= []\n          errors.push(error)\n        }\n      }\n      if (errors !== undefined)\n        throw errors.length === 1 ? errors[0] : new AggregateError(errors, 'tracker 抛错')\n    },\n  }\n}\n","import type { Scope } from '@xihan-ui/kernel'\nimport type { MachineConfig, MachineSchema, Service } from '@xihan-ui/machine'\nimport type { ReactiveController, ReactiveControllerHost } from '../reactive'\nimport type { LitRuntime } from './lit-runtime'\nimport { createService } from '@xihan-ui/machine'\nimport { createLitRuntime } from './lit-runtime'\n\nexport interface MachineControllerOptions<T extends MachineSchema> {\n  scope?: Scope\n  /** 每次建机器后回调，用于注入 refs。 */\n  onBuilt?: (service: Service<T>) => void\n}\n\n// 一台机器一个 controller：hostConnected 建机器并 mount、hostUpdate 跑 trackers、hostDisconnected unmount。\nexport class MachineController<T extends MachineSchema> implements ReactiveController {\n  service!: Service<T>\n  private runtime: LitRuntime | undefined\n  private started = false\n\n  constructor(\n    private readonly host: ReactiveControllerHost,\n    private readonly machine: MachineConfig<T>,\n    private readonly props: () => Partial<T['props']>,\n    private readonly opts: MachineControllerOptions<T> = {},\n  ) {\n    host.addController(this)\n    // 延到 hostConnected 再 build，构造期 attribute 尚未反射到 reactive property。\n  }\n\n  private build(): void {\n    this.runtime = createLitRuntime(this.host)\n    this.service = createService(this.machine, { props: this.props, runtime: this.runtime, scope: this.opts.scope })\n    this.opts.onBuilt?.(this.service)\n  }\n\n  hostConnected(): void {\n    // 首次或旧机器已停止时重建，从 initialState 起。\n    if (!this.started || this.service.getStatus() === 'Stopped') {\n      this.build()\n      this.started = true\n    }\n    this.runtime!.mount()\n  }\n\n  hostUpdate(): void {\n    this.runtime?.runTrackers()\n  }\n\n  hostDisconnected(): void {\n    this.runtime?.unmount()\n  }\n}\n"],"mappings":"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"}

package/dist/registry-DR6I2_zF.js

@@ -0,0 +1,25 @@
+//#region src/runtime/registry.ts
+const REGISTRY_KEY = "__XIHAN_UI_WC__";
+function registry() {
+	const g = globalThis;
+	return g[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
+}
+function defineElement(tag, ctor, version) {
+	if (typeof customElements === "undefined") return;
+	const reg = registry();
+	const prev = reg.get(tag);
+	if (prev) {
+		if (prev.version === version) return;
+		throw new Error(`[xihan-ui] ${tag} 已注册版本 ${prev.version}，拒绝以 ${version} 重复注册`);
+	}
+	if (customElements.get(tag)) throw new Error(`[xihan-ui] 标签 ${tag} 已被非 XiHan.UI 代码占用`);
+	reg.set(tag, {
+		version,
+		ctor
+	});
+	customElements.define(tag, ctor);
+}
+//#endregion
+export { defineElement as t };
+
+//# sourceMappingURL=registry-DR6I2_zF.js.map

package/dist/registry-DR6I2_zF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-DR6I2_zF.js","names":[],"sources":["../src/runtime/registry.ts"],"sourcesContent":["// 自定义元素注册表：幂等注册，重复标签或版本冲突时抛错，无 DOM 环境跳过。\nconst REGISTRY_KEY = '__XIHAN_UI_WC__'\n\ninterface Entry {\n  version: string\n  ctor: CustomElementConstructor\n}\n\nfunction registry(): Map<string, Entry> {\n  const g = globalThis as Record<string, unknown>\n  return (g[REGISTRY_KEY] ??= new Map<string, Entry>()) as Map<string, Entry>\n}\n\nexport function defineElement(tag: string, ctor: CustomElementConstructor, version: string): void {\n  // 无 customElements 的环境静默跳过。\n  if (typeof customElements === 'undefined')\n    return\n  const reg = registry()\n  const prev = reg.get(tag)\n  if (prev) {\n    if (prev.version === version)\n      return\n    throw new Error(`[xihan-ui] ${tag} 已注册版本 ${prev.version}，拒绝以 ${version} 重复注册`)\n  }\n  if (customElements.get(tag))\n    throw new Error(`[xihan-ui] 标签 ${tag} 已被非 XiHan.UI 代码占用`)\n  reg.set(tag, { version, ctor })\n  customElements.define(tag, ctor)\n}\n"],"mappings":";AACA,MAAM,eAAe;AAOrB,SAAS,WAA+B;CACtC,MAAM,IAAI;CACV,OAAQ,EAAE,kCAAkB,IAAI,IAAmB;AACrD;AAEA,SAAgB,cAAc,KAAa,MAAgC,SAAuB;CAEhG,IAAI,OAAO,mBAAmB,aAC5B;CACF,MAAM,MAAM,SAAS;CACrB,MAAM,OAAO,IAAI,IAAI,GAAG;CACxB,IAAI,MAAM;EACR,IAAI,KAAK,YAAY,SACnB;EACF,MAAM,IAAI,MAAM,cAAc,IAAI,SAAS,KAAK,QAAQ,OAAO,QAAQ,MAAM;CAC/E;CACA,IAAI,eAAe,IAAI,GAAG,GACxB,MAAM,IAAI,MAAM,iBAAiB,IAAI,mBAAmB;CAC1D,IAAI,IAAI,KAAK;EAAE;EAAS;CAAK,CAAC;CAC9B,eAAe,OAAO,KAAK,IAAI;AACjC"}

package/dist/spread-Ch8ZXZDC.d.ts

@@ -0,0 +1,9 @@
+//#region src/dom/spread.d.ts
+interface Spreader {
+  spread: (node: HTMLElement, props: Record<string, unknown>) => void;
+  release: (node: HTMLElement) => void;
+}
+declare function createSpreader(): Spreader;
+//#endregion
+export { createSpreader as n, Spreader as t };
+//# sourceMappingURL=spread-Ch8ZXZDC.d.ts.map

package/dist/spread-Ch8ZXZDC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spread-Ch8ZXZDC.d.ts","names":[],"sources":["../src/dom/spread.ts"],"mappings":";UA2BiB;EACf,SAAS,MAAM,aAAa,OAAO;EACnC,UAAU,MAAM;;iBASF,kBAAkB"}

package/dist/types-BvWWqMd_.d.ts

@@ -0,0 +1,46 @@
+//#region src/reactive/types.d.ts
+/** 属性字符串 → 字段值。本运行时不做属性回写，故没有 toAttribute。 */
+interface ComplexAttributeConverter<Type = unknown> {
+  fromAttribute?: (value: string | null, type?: unknown) => Type;
+}
+/** 转换器可写成对象，也可直接写成 fromAttribute 函数。 */
+type AttributeConverter<Type = unknown> = ComplexAttributeConverter<Type> | ((value: string | null, type?: unknown) => Type);
+interface PropertyDeclaration<Type = unknown> {
+  /** false=不观察属性；字符串=指定属性名；缺省=字段名转小写（不转短横线）。 */
+  readonly attribute?: boolean | string;
+  /** 没配 converter 时据此选内建转换：Boolean / Number / Object / Array，其余原样取字符串。 */
+  readonly type?: unknown;
+  /** 自定义转换器，配了就盖过 type。 */
+  readonly converter?: AttributeConverter<Type>;
+  /** 未实现：判等固定 Object.is。写了编译期报错，运行期也抛。 */
+  readonly hasChanged?: never;
+  /** 未实现：本运行时不回写属性。写了编译期报错，运行期也抛。 */
+  readonly reflect?: never;
+  /** 未实现：每条声明必装访问器。写了编译期报错，运行期也抛。 */
+  readonly noAccessor?: never;
+  /** 未实现：没有内部状态这一档声明。写了编译期报错，运行期也抛。 */
+  readonly state?: never;
+}
+/** `static properties` 的形状：字段名 → 声明。只支持字符串键，symbol 键在定稿时抛。 */
+interface PropertyDeclarations {
+  readonly [name: string]: PropertyDeclaration;
+}
+/** 一轮更新里变过的字段 → 变更前的值。 */
+type PropertyValues = Map<PropertyKey, unknown>;
+/** 挂在元素上的一段外部逻辑，跟着宿主的连接与更新走。 */
+interface ReactiveController {
+  hostConnected?: () => void;
+  hostUpdate?: () => void;
+  hostUpdated?: () => void;
+  hostDisconnected?: () => void;
+}
+/** 控制器眼中的宿主。 */
+interface ReactiveControllerHost {
+  addController: (controller: ReactiveController) => void;
+  removeController: (controller: ReactiveController) => void;
+  requestUpdate: () => void;
+  readonly updateComplete: Promise<boolean>;
+}
+//#endregion
+export { ReactiveControllerHost as a, ReactiveController as i, PropertyDeclarations as n, PropertyValues as r, PropertyDeclaration as t };
+//# sourceMappingURL=types-BvWWqMd_.d.ts.map

package/dist/types-BvWWqMd_.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BvWWqMd_.d.ts","names":[],"sources":["../src/reactive/types.ts"],"mappings":";;UAGiB,0BAA0B;EACzC,iBAAiB,sBAAsB,mBAAmB;;;KAIhD,mBAAmB,kBACzB,0BAA0B,UACxB,sBAAsB,mBAAmB;UAEhC,oBAAoB;;WAE1B;;WAEA;;WAEA,YAAY,mBAAmB;;WAE/B;;WAEA;;WAEA;;WAEA;;;UAIM;YACL,eAAe;;;KAIf,iBAAiB,IAAI;;UAGhB;EACf;EACA;EACA;EACA;;;UAIe;EACf,gBAAgB,YAAY;EAC5B,mBAAmB,YAAY;EAC/B;WACS,gBAAgB"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@xihan-ui/web-components",
+  "type": "module",
+  "version": "1.0.0-alpha.0",
+  "description": "XiHan.UI Web Components adapter — Light-DOM behavior hosts on XhReactiveElement.",
+  "author": {
+    "name": "XiHanFun",
+    "url": "https://github.com/XiHanFun"
+  },
+  "license": "MIT",
+  "homepage": "https://ui.docs.xihanfun.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XiHanFun/XiHan.UI.git",
+    "directory": "ui/packages/adapters/web-components"
+  },
+  "bugs": {
+    "url": "https://github.com/XiHanFun/XiHan.UI/issues"
+  },
+  "keywords": [
+    "web-components",
+    "custom-elements",
+    "headless-ui",
+    "design-system"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./define": {
+      "types": "./dist/define.d.ts",
+      "import": "./dist/define.js"
+    },
+    "./backgrounds": {
+      "types": "./dist/backgrounds.d.ts",
+      "import": "./dist/backgrounds.js"
+    },
+    "./custom-elements.json": "./custom-elements.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "CHANGELOG.md",
+    "custom-elements.json",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "customElements": "custom-elements.json",
+  "peerDependencies": {
+    "@xihan-ui/backgrounds": "^1.0.0-alpha.0"
+  },
+  "peerDependenciesMeta": {
+    "@xihan-ui/backgrounds": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@xihan-ui/behavior": "^1.0.0-alpha.0",
+    "@xihan-ui/code-highlight": "^1.0.0-alpha.0",
+    "@xihan-ui/headless": "^1.0.0-alpha.0",
+    "@xihan-ui/kernel": "^1.0.0-alpha.0",
+    "@xihan-ui/machine": "^1.0.0-alpha.0",
+    "@xihan-ui/position": "^1.0.0-alpha.0"
+  },
+  "devDependencies": {
+    "@custom-elements-manifest/analyzer": "^0.11.0",
+    "@lit/reactive-element": "2.1.2",
+    "@vitest/browser": "^4.1.10",
+    "@vitest/browser-playwright": "^4.1.10",
+    "jsdom": "^27.0.0",
+    "playwright": "^1.62.0",
+    "vitest": "^4.1.10",
+    "@xihan-ui/backgrounds": "1.0.0-alpha.0",
+    "@xihan-ui/build": "0.0.0",
+    "@xihan-ui/styles": "1.0.0-alpha.0",
+    "@xihan-ui/testing": "0.0.0",
+    "@xihan-ui/tokens": "1.0.0-alpha.0",
+    "@xihan-ui/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "cem": "cem analyze",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:browser": "vitest run --config vitest.browser.config.ts"
+  }
+}