@threadlabs/looma 0.30.2 → 0.30.3

package/vue/chunks/_plugin-vue_export-helper.js

@@ -1,5 +1,120 @@
 import { Fragment, computed, defineComponent, getCurrentInstance, h, onBeforeUnmount, onBeforeUpdate, onMounted, onUpdated, shallowRef, useSlots, watch, watchEffect } from "vue";
 //#region .build/vue/host.ts
+var READY_INPUT = {
+	ready: true,
+	pending: false,
+	error: null,
+	stale: false
+};
+/**
+* Each call owns a fresh native cancellation signal. The facade also owns subscriptions created
+* through host.on/effect after an await: retaining a stale host cannot start a new subscription.
+* It shares the instance's state, props, refs and other capabilities rather than copying them.
+*/
+function activateModule(module, host, report = (error) => {
+	queueMicrotask(() => {
+		throw error;
+	});
+}) {
+	const controller = new AbortController();
+	const owned = /* @__PURE__ */ new Set();
+	let cleanup;
+	const dispose = (stop) => {
+		try {
+			stop();
+		} catch (error) {
+			report(error);
+		}
+	};
+	const scoped = Object.create(host);
+	const stop = () => {
+		if (controller.signal.aborted) return;
+		controller.abort();
+		for (const release of owned) release();
+		const release = cleanup;
+		cleanup = void 0;
+		if (release !== void 0) dispose(release);
+	};
+	const failed = (error) => {
+		const cancelled = controller.signal.aborted && error?.name === "AbortError";
+		stop();
+		if (!cancelled) report(error);
+	};
+	const own = (stop) => {
+		let stopped = false;
+		const release = () => {
+			if (stopped) return;
+			stopped = true;
+			owned.delete(release);
+			dispose(stop);
+		};
+		if (controller.signal.aborted) release();
+		else owned.add(release);
+		return release;
+	};
+	for (const name of [
+		"on",
+		"effect",
+		"computed"
+	]) {
+		const method = Reflect.get(host, name);
+		if (typeof method !== "function") continue;
+		Object.defineProperty(scoped, name, { value: (...args) => {
+			if (controller.signal.aborted) {
+				if (name === "computed") return { get: () => {
+					throw controller.signal.reason;
+				} };
+				return () => {};
+			}
+			const result = Reflect.apply(method, host, args);
+			const stop = name === "computed" ? result.stop?.bind(result) : result;
+			if (stop === void 0) return result;
+			const release = own(stop);
+			return name === "computed" ? result : release;
+		} });
+	}
+	const inputKey = Symbol.for("@nextwebwg/html-next.inputs.v1");
+	const inputs = Reflect.get(host, inputKey);
+	if (inputs !== void 0) {
+		const port = Object.create(inputs);
+		Object.defineProperty(port, "watch", { value: (run) => controller.signal.aborted ? () => {} : own(inputs.watch(run)) });
+		const source = Reflect.get(inputs, "source");
+		if (typeof source === "function") Object.defineProperty(port, "source", { value: (...args) => {
+			if (controller.signal.aborted) throw controller.signal.reason;
+			const result = Reflect.apply(source, inputs, args);
+			const capability = Object.create(result);
+			Object.defineProperty(capability, "dispose", { value: own(() => result.dispose()) });
+			return capability;
+		} });
+		Object.defineProperty(scoped, inputKey, { value: port });
+	}
+	const accept = (result) => {
+		if (result === void 0) return;
+		if (typeof result !== "function") {
+			failed(/* @__PURE__ */ new TypeError("A component connect export must return cleanup or undefined."));
+			return;
+		}
+		if (controller.signal.aborted) dispose(result);
+		else cleanup = result;
+	};
+	try {
+		const result = module.connect?.(scoped, { signal: controller.signal });
+		if (result !== void 0 && typeof result !== "function") Promise.resolve(result).then(accept, failed);
+		else accept(result);
+	} catch (error) {
+		failed(error);
+	}
+	return stop;
+}
+/** A fresh copy of a state's declared value at `keys`, or null where it has none. */
+function initialAt(initial, keys) {
+	let value = initial;
+	for (const key of keys) {
+		if (value === null || typeof value !== "object" || !Object.hasOwn(value, key)) return null;
+		value = value[key];
+	}
+	return value === void 0 ? null : value !== null && typeof value === "object" ? structuredClone(value) : value;
+}
 function controllerNamespaces(options, source) {
 	const reported = /* @__PURE__ */ new Set();
 	const nested = /* @__PURE__ */ new WeakMap();
@@ -44,7 +159,7 @@ function controllerNamespaces(options, source) {
 				return wrap(Reflect.get(value, key), name, [...keys, String(key)], readonly);
 			},
 			set: (_target, key, written) => {
-				const next = unwrap(written);
+				const next = unwrap(written) ?? initialAt(options.initials?.[name] ?? null, [...keys, String(key)]);
 				return write(name, [...keys, String(key)], next, readonly, () => {
 					const previous = Reflect.get(value, key);
 					const length = Array.isArray(value) ? value.length : void 0;
@@ -86,37 +201,44 @@ function controllerNamespaces(options, source) {
 		plain.set(proxy, value);
 		return proxy;
 	};
+	const state = new Proxy({}, {
+		get: (_target, name) => {
+			if (typeof name !== "string") return void 0;
+			if (Object.hasOwn(options.state, name)) return wrap(options.state[name].get(), name, [], false);
+			if (Object.hasOwn(options.computed, name)) return wrap(options.computed[name](), name, [], true);
+		},
+		set: (_target, name, value) => write(String(name), [], unwrap(value), typeof name !== "string" || !Object.hasOwn(options.state, name), () => options.state[String(name)].set(unwrap(value) ?? initialAt(options.initials?.[String(name)] ?? null, []))),
+		deleteProperty: (_target, name) => {
+			warn(String(name), true);
+			return true;
+		},
+		defineProperty: (_target, name) => {
+			warn(String(name), true);
+			return false;
+		},
+		has: (_target, name) => typeof name === "string" && (Object.hasOwn(options.state, name) || Object.hasOwn(options.computed, name))
+	});
+	const data = new Proxy({}, {
+		get: (_target, name) => typeof name === "string" && Object.hasOwn(options.data ?? {}, name) ? wrap(options.data[name](), "data." + name, [], true) : void 0,
+		set: (_target, name, value) => write("data." + String(name), [], value, true, () => {}),
+		deleteProperty: (_target, name) => {
+			warn("data." + String(name), true);
+			return true;
+		},
+		defineProperty: (_target, name) => {
+			warn("data." + String(name), true);
+			return false;
+		},
+		has: (_target, name) => typeof name === "string" && Object.hasOwn(options.data ?? {}, name)
+	});
+	const reset = (name) => {
+		if (name !== void 0 && !Object.hasOwn(options.state, name)) throw new TypeError("`" + String(name) + "` is not a state of " + source + ".");
+		for (const each of name === void 0 ? Object.keys(options.state) : [name]) options.state[each].set(initialAt(options.initials?.[each] ?? null, []));
+	};
 	return {
-		state: new Proxy({}, {
-			get: (_target, name) => {
-				if (typeof name !== "string") return void 0;
-				if (Object.hasOwn(options.state, name)) return wrap(options.state[name].get(), name, [], false);
-				if (Object.hasOwn(options.computed, name)) return wrap(options.computed[name](), name, [], true);
-			},
-			set: (_target, name, value) => write(String(name), [], unwrap(value), typeof name !== "string" || !Object.hasOwn(options.state, name), () => options.state[String(name)].set(unwrap(value))),
-			deleteProperty: (_target, name) => {
-				warn(String(name), true);
-				return true;
-			},
-			defineProperty: (_target, name) => {
-				warn(String(name), true);
-				return false;
-			},
-			has: (_target, name) => typeof name === "string" && (Object.hasOwn(options.state, name) || Object.hasOwn(options.computed, name))
-		}),
-		data: new Proxy({}, {
-			get: (_target, name) => typeof name === "string" && Object.hasOwn(options.data ?? {}, name) ? wrap(options.data[name](), "data." + name, [], true) : void 0,
-			set: (_target, name, value) => write("data." + String(name), [], value, true, () => {}),
-			deleteProperty: (_target, name) => {
-				warn("data." + String(name), true);
-				return true;
-			},
-			defineProperty: (_target, name) => {
-				warn("data." + String(name), true);
-				return false;
-			},
-			has: (_target, name) => typeof name === "string" && Object.hasOwn(options.data ?? {}, name)
-		})
+		state,
+		data,
+		reset
 	};
 }
 var requestStateKey = Symbol.for("@nextwebwg/html-next.runtime.v1");
@@ -271,7 +393,7 @@ function useComponentHost(controllerLoader, options) {
 		const edge = options.controllerSource;
 		const source = edge?.definition ? new URL(edge.definition, document.baseURI).href : void 0;
 		const url = new URL(edge?.specifier ?? "", source ?? document.baseURI).href;
-		const message = code === "HJ002" ? "Controller module `" + url + "` must default-export a function." : "Controller module `" + url + "` failed to load: " + (reason instanceof Error ? reason.message : String(reason)) + ".";
+		const message = code === "HJ002" ? options.module ? "Component module `" + url + "` export connect must be a function." : "Controller module `" + url + "` must default-export a function." : "Controller module `" + url + "` failed to load: " + (reason instanceof Error ? reason.message : String(reason)) + ".";
 		return Object.assign(/* @__PURE__ */ new Error((source === void 0 ? "" : source + ": ") + code + ": " + message), {
 			name: "HtmlDiagnosticError",
 			diagnostic: Object.freeze({
@@ -283,7 +405,8 @@ function useComponentHost(controllerLoader, options) {
 	};
 	let controllerModule;
 	const loadControllerModule = () => controllerModule ??= Promise.resolve().then(controllerLoader).then((candidate) => {
-		if (typeof candidate?.default !== "function") throw controllerDiagnostic("HJ002");
+		const loaded = candidate;
+		if (options.module ? loaded === null || typeof loaded !== "object" || loaded.connect !== void 0 && typeof loaded.connect !== "function" : typeof loaded?.default !== "function") throw controllerDiagnostic("HJ002");
 		return candidate;
 	}).catch((error) => {
 		if (error instanceof Error && "diagnostic" in error) throw error;
@@ -335,6 +458,21 @@ function useComponentHost(controllerLoader, options) {
 	}
 	let lastRoot = null;
 	const host = {
+		get [Symbol.for("@nextwebwg/html-next.inputs.v1")]() {
+			return options.inputs?.port({
+				declarations: Object.fromEntries([
+					...Object.keys(state),
+					...Object.keys(computedValues),
+					...Object.keys(context)
+				].map((name) => [name, {
+					read: () => host.state[name],
+					status: () => options.availability?.[name]?.() ?? READY_INPUT
+				}])),
+				track: (name, kind) => options.inputTracking.track(name, kind),
+				watch: (run) => host.effect(run),
+				untracked: (run) => options.inputTracking.untracked(run)
+			});
+		},
 		get element() {
 			return root.value ?? lastRoot;
 		},
@@ -350,7 +488,8 @@ function useComponentHost(controllerLoader, options) {
 			}])),
 			computed: Object.fromEntries([...Object.entries(computedValues), ...Object.entries(context)].map(([name, value]) => [name, () => value.value])),
 			data: Object.fromEntries(Object.entries(data).map(([name, value]) => [name, () => value.value])),
-			...options.acceptsState === void 0 ? {} : { acceptsState: options.acceptsState }
+			...options.acceptsState === void 0 ? {} : { acceptsState: options.acceptsState },
+			...options.initials === void 0 ? {} : { initials: options.initials }
 		}, options.controllerSource?.definition ?? "<component>"),
 		scripts: options.scripts ?? Object.freeze({}),
 		on(type, callback) {
@@ -400,6 +539,8 @@ function useComponentHost(controllerLoader, options) {
 				stop();
 				pause();
 				pauses.delete(dispose);
+				const index = stops.indexOf(dispose);
+				if (index >= 0) stops.splice(index, 1);
 			};
 			pauses.set(dispose, pause);
 			stops.push(dispose);
@@ -466,12 +607,20 @@ function useComponentHost(controllerLoader, options) {
 		}
 		connected.value = true;
 		for (const entry of subscriptions) activate(entry);
-		if (initialized) return;
+		if (initialized && !options.module) return;
 		const current = ++connection;
 		const release = releaseController = holdController(root.value);
 		started = loadControllerModule().then(async (loaded) => {
-			if (!connected.value || current !== connection || initialized) return loaded;
+			if (!connected.value || current !== connection || initialized && !options.module) return loaded;
 			initialized = true;
+			if (options.module) {
+				try {
+					cleanup = activateModule(loaded, host, report);
+				} finally {
+					release();
+				}
+				return loaded;
+			}
 			let invoked;
 			try {
 				invoked = loaded.default(host);

package/vue/chunks/control.js

@@ -1,7 +1,8 @@
-import { Fragment, cloneVNode, createVNode, defineComponent, onMounted, onUpdated } from "vue";
+import { Fragment, cloneVNode, createVNode, defineComponent, onMounted, onUpdated, toRaw } from "vue";
 //#region .build/vue/control.ts
 var connectedControls = /* @__PURE__ */ new WeakSet();
 var boundValues = /* @__PURE__ */ new WeakMap();
+var heldControls = /* @__PURE__ */ new WeakMap();
 var selectOptions = /* @__PURE__ */ new WeakMap();
 var selectBindings = /* @__PURE__ */ new WeakMap();
 var selectWatches = /* @__PURE__ */ new WeakMap();
@@ -60,6 +61,10 @@ function snapshotValue(value) {
 }
 function writeBoundControl(element, binding) {
 	const value = binding.value;
+	if (heldControls.has(element)) {
+		if (sameValue(heldControls.get(element), toRaw(value))) return;
+		heldControls.delete(element);
+	}
 	if (binding.optionalValue && value === void 0) return;
 	if (binding.name === "checked" && element instanceof HTMLInputElement) {
 		const next = Boolean(value);