@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-settings/lib/client.js

@@ -5,39 +5,979 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let _nomix_ai_cordis = require("@nomix-ai/cordis");
-		let _nomix_ai_nomix_client_schema_form = require("@nomix-ai/nomix-client-schema-form");
 		let _nomix_ai_nomix_client_runtime_client = require("@nomix-ai/nomix-client-runtime/client");
+		//#region ../../../vendor/cosmokit/src/misc.ts
+		/** Return true when a value is `null` or `undefined`. */
+		function isNullable(value) {
+			return value === null || value === void 0;
+		}
+		/** Return true for non-array object values. */
+		function isPlainObject(data) {
+			return data && typeof data === "object" && !Array.isArray(data);
+		}
+		/** Filter object entries and return a new object. */
+		function filterKeys(object, filter) {
+			return Object.fromEntries(Object.entries(object).filter(([key, value]) => filter(key, value)));
+		}
+		/** Map object values while preserving the original key set. */
+		function mapValues(object, transform) {
+			return Object.fromEntries(Object.entries(object).map(([key, value]) => [key, transform(value, key)]));
+		}
+		/** Pick selected keys from an object, optionally including `undefined` values. */
+		function pick(source, keys, forced) {
+			if (!keys) return { ...source };
+			const result = {};
+			for (const key of keys) if (forced || source[key] !== void 0) result[key] = source[key];
+			return result;
+		}
+		//#endregion
+		//#region ../../../vendor/cosmokit/src/types.ts
+		/** Test values using `instanceof` with a `toStringTag` fallback. */
+		function is(type, value) {
+			if (arguments.length === 1) return (value) => is(type, value);
+			return type in globalThis && value instanceof globalThis[type] || Object.prototype.toString.call(value).slice(8, -1) === type;
+		}
+		function isArrayBufferLike(value) {
+			return is("ArrayBuffer", value) || is("SharedArrayBuffer", value);
+		}
+		function isArrayBufferSource(value) {
+			return isArrayBufferLike(value) || ArrayBuffer.isView(value);
+		}
+		let Binary;
+		(function(_Binary) {
+			_Binary.is = isArrayBufferLike;
+			_Binary.isSource = isArrayBufferSource;
+			function fromSource(source) {
+				if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+				else return source;
+			}
+			_Binary.fromSource = fromSource;
+			function toBase64(source) {
+				source = fromSource(source);
+				if (typeof Buffer !== "undefined") return Buffer.from(source).toString("base64");
+				let binary = "";
+				const bytes = new Uint8Array(source);
+				for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
+				return btoa(binary);
+			}
+			_Binary.toBase64 = toBase64;
+			function fromBase64(source) {
+				if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "base64"));
+				return Uint8Array.from(atob(source), (c) => c.charCodeAt(0));
+			}
+			_Binary.fromBase64 = fromBase64;
+			function toHex(source) {
+				source = fromSource(source);
+				if (typeof Buffer !== "undefined") return Buffer.from(source).toString("hex");
+				return Array.from(new Uint8Array(source), (byte) => byte.toString(16).padStart(2, "0")).join("");
+			}
+			_Binary.toHex = toHex;
+			function fromHex(source) {
+				if (typeof Buffer !== "undefined") return fromSource(Buffer.from(source, "hex"));
+				const hex = source.length % 2 === 0 ? source : source.slice(0, source.length - 1);
+				const buffer = [];
+				for (let i = 0; i < hex.length; i += 2) buffer.push(parseInt(`${hex[i]}${hex[i + 1]}`, 16));
+				return Uint8Array.from(buffer).buffer;
+			}
+			_Binary.fromHex = fromHex;
+		})(Binary || (Binary = {}));
+		Binary.fromBase64;
+		Binary.toBase64;
+		Binary.fromHex;
+		Binary.toHex;
+		/** Deep-clone common JavaScript values while preserving prototypes and cycles. */
+		function clone(source, refs = /* @__PURE__ */ new Map()) {
+			if (!source || typeof source !== "object") return source;
+			if (is("Date", source)) return new Date(source.valueOf());
+			if (is("RegExp", source)) return new RegExp(source.source, source.flags);
+			if (isArrayBufferLike(source)) return source.slice(0);
+			if (ArrayBuffer.isView(source)) return source.buffer.slice(source.byteOffset, source.byteOffset + source.byteLength);
+			const cached = refs.get(source);
+			if (cached) return cached;
+			if (Array.isArray(source)) {
+				const result = [];
+				refs.set(source, result);
+				source.forEach((value, index) => {
+					result[index] = Reflect.apply(clone, null, [value, refs]);
+				});
+				return result;
+			}
+			const result = Object.create(Object.getPrototypeOf(source));
+			refs.set(source, result);
+			for (const key of Reflect.ownKeys(source)) {
+				const descriptor = { ...Reflect.getOwnPropertyDescriptor(source, key) };
+				if ("value" in descriptor) descriptor.value = Reflect.apply(clone, null, [descriptor.value, refs]);
+				Reflect.defineProperty(result, key, descriptor);
+			}
+			return result;
+		}
+		/** Deeply compare arrays, dates, regexps, buffers, and plain object fields. */
+		function deepEqual(a, b, strict) {
+			if (a === b) return true;
+			if (!strict && isNullable(a) && isNullable(b)) return true;
+			if (typeof a !== typeof b) return false;
+			if (typeof a !== "object") return false;
+			if (!a || !b) return false;
+			function check(test, then) {
+				return test(a) ? test(b) ? then(a, b) : false : test(b) ? false : void 0;
+			}
+			return check(Array.isArray, (a, b) => a.length === b.length && a.every((item, index) => deepEqual(item, b[index]))) ?? check(is("Date"), (a, b) => a.valueOf() === b.valueOf()) ?? check(is("RegExp"), (a, b) => a.source === b.source && a.flags === b.flags) ?? check(isArrayBufferLike, (a, b) => {
+				if (a.byteLength !== b.byteLength) return false;
+				const viewA = new Uint8Array(a);
+				const viewB = new Uint8Array(b);
+				for (let i = 0; i < viewA.length; i++) if (viewA[i] !== viewB[i]) return false;
+				return true;
+			}) ?? Object.keys({
+				...a,
+				...b
+			}).every((key) => deepEqual(a[key], b[key], strict));
+		}
+		//#endregion
+		//#region ../../../vendor/cosmokit/src/time.ts
+		let Time;
+		(function(_Time) {
+			_Time.millisecond = 1;
+			const second = _Time.second = 1e3;
+			const minute = _Time.minute = second * 60;
+			const hour = _Time.hour = minute * 60;
+			const day = _Time.day = hour * 24;
+			const week = _Time.week = day * 7;
+			let timezoneOffset = (/* @__PURE__ */ new Date()).getTimezoneOffset();
+			function setTimezoneOffset(offset) {
+				timezoneOffset = offset;
+			}
+			_Time.setTimezoneOffset = setTimezoneOffset;
+			function getTimezoneOffset() {
+				return timezoneOffset;
+			}
+			_Time.getTimezoneOffset = getTimezoneOffset;
+			function getDateNumber(date = /* @__PURE__ */ new Date(), offset) {
+				if (typeof date === "number") date = new Date(date);
+				if (offset === void 0) offset = timezoneOffset;
+				return Math.floor((date.valueOf() / minute - offset) / 1440);
+			}
+			_Time.getDateNumber = getDateNumber;
+			function fromDateNumber(value, offset) {
+				const date = new Date(value * day);
+				if (offset === void 0) offset = timezoneOffset;
+				return new Date(+date + offset * minute);
+			}
+			_Time.fromDateNumber = fromDateNumber;
+			const numeric = /\d+(?:\.\d+)?/.source;
+			const timeRegExp = new RegExp(`^${[
+				"w(?:eek(?:s)?)?",
+				"d(?:ay(?:s)?)?",
+				"h(?:our(?:s)?)?",
+				"m(?:in(?:ute)?(?:s)?)?",
+				"s(?:ec(?:ond)?(?:s)?)?"
+			].map((unit) => `(${numeric}${unit})?`).join("")}$`);
+			function parseTime(source) {
+				const capture = timeRegExp.exec(source);
+				if (!capture) return 0;
+				return (parseFloat(capture[1]) * week || 0) + (parseFloat(capture[2]) * day || 0) + (parseFloat(capture[3]) * hour || 0) + (parseFloat(capture[4]) * minute || 0) + (parseFloat(capture[5]) * second || 0);
+			}
+			_Time.parseTime = parseTime;
+			function parseDate(date) {
+				const parsed = parseTime(date);
+				if (parsed) date = Date.now() + parsed;
+				else if (/^\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).toLocaleDateString()}-${date}`;
+				else if (/^\d{1,2}-\d{1,2}-\d{1,2}(:\d{1,2}){1,2}$/.test(date)) date = `${(/* @__PURE__ */ new Date()).getFullYear()}-${date}`;
+				return date ? new Date(date) : /* @__PURE__ */ new Date();
+			}
+			_Time.parseDate = parseDate;
+			function format(ms) {
+				const abs = Math.abs(ms);
+				if (abs >= day - hour / 2) return Math.round(ms / day) + "d";
+				else if (abs >= hour - minute / 2) return Math.round(ms / hour) + "h";
+				else if (abs >= minute - second / 2) return Math.round(ms / minute) + "m";
+				else if (abs >= second) return Math.round(ms / second) + "s";
+				return ms + "ms";
+			}
+			_Time.format = format;
+			function toDigits(source, length = 2) {
+				return source.toString().padStart(length, "0");
+			}
+			_Time.toDigits = toDigits;
+			function template(template, time = /* @__PURE__ */ new Date()) {
+				return template.replace("yyyy", time.getFullYear().toString()).replace("yy", time.getFullYear().toString().slice(2)).replace("MM", toDigits(time.getMonth() + 1)).replace("dd", toDigits(time.getDate())).replace("hh", toDigits(time.getHours())).replace("mm", toDigits(time.getMinutes())).replace("ss", toDigits(time.getSeconds())).replace("SSS", toDigits(time.getMilliseconds(), 3));
+			}
+			_Time.template = template;
+		})(Time || (Time = {}));
+		//#endregion
+		//#region ../../../vendor/schemastery/src/index.ts
+		const kSchema = Symbol.for("schemastery");
+		const kValidationError = Symbol.for("ValidationError");
+		globalThis.__schemastery_index__ ??= 0;
+		globalThis.__schemastery_refs__ = void 0;
+		var ValidationError = class extends TypeError {
+			options;
+			name = "ValidationError";
+			constructor(message, options) {
+				let prefix = "$";
+				for (const segment of options.path || []) if (typeof segment === "string") prefix += "." + segment;
+				else if (typeof segment === "number") prefix += "[" + segment + "]";
+				else if (typeof segment === "symbol") prefix += `[Symbol(${segment.toString()})]`;
+				if (prefix.startsWith(".")) prefix = prefix.slice(1);
+				super((prefix === "$" ? "" : `${prefix} `) + message);
+				this.options = options;
+			}
+			static is(error) {
+				return !!error?.[kValidationError];
+			}
+		};
+		Object.defineProperty(ValidationError.prototype, kValidationError, { value: true });
+		const Schema = function(options) {
+			const schema = function(data, options = {}) {
+				return Schema.resolve(data, schema, options)[0];
+			};
+			if (options.refs) {
+				const refs = mapValues(options.refs, (options) => new Schema(options));
+				const getRef = (uid) => refs[uid];
+				for (const key in refs) {
+					const options = refs[key];
+					options.sKey = getRef(options.sKey);
+					options.inner = getRef(options.inner);
+					options.list = options.list && options.list.map(getRef);
+					options.dict = options.dict && mapValues(options.dict, getRef);
+				}
+				return refs[options.uid];
+			}
+			Object.assign(schema, options);
+			if (typeof schema.callback === "string") try {
+				schema.callback = new Function("return " + schema.callback)();
+			} catch {}
+			Object.defineProperty(schema, "uid", { value: globalThis.__schemastery_index__++ });
+			Object.setPrototypeOf(schema, Schema.prototype);
+			schema.meta ||= {};
+			schema.toString = schema.toString.bind(schema);
+			return schema;
+		};
+		Schema.prototype = Object.create(Function.prototype);
+		Schema.prototype[kSchema] = true;
+		Object.defineProperty(Schema.prototype, "~standard", { get() {
+			return {
+				version: 1,
+				vendor: "schemastery",
+				validate: (value) => {
+					try {
+						return { value: Schema.resolve(value, this, {})[0] };
+					} catch (error) {
+						if (ValidationError.is(error)) return { issues: [{
+							message: error.message,
+							path: error.options.path
+						}] };
+						throw error;
+					}
+				}
+			};
+		} });
+		Schema.ValidationError = ValidationError;
+		Schema.prototype.toJSON = function toJSON() {
+			if (globalThis.__schemastery_refs__) {
+				globalThis.__schemastery_refs__[this.uid] ??= JSON.parse(JSON.stringify({ ...this }));
+				return this.uid;
+			}
+			globalThis.__schemastery_refs__ = { [this.uid]: { ...this } };
+			globalThis.__schemastery_refs__[this.uid] = JSON.parse(JSON.stringify({ ...this }));
+			const result = {
+				uid: this.uid,
+				refs: globalThis.__schemastery_refs__
+			};
+			globalThis.__schemastery_refs__ = void 0;
+			return result;
+		};
+		Schema.prototype.set = function set(key, value) {
+			this.dict[key] = value;
+			return this;
+		};
+		Schema.prototype.push = function push(value) {
+			this.list.push(value);
+			return this;
+		};
+		function mergeDesc(original, messages) {
+			const result = typeof original === "string" ? { "": original } : { ...original };
+			for (const locale in messages) {
+				const value = messages[locale];
+				if (value?.$description || value?.$desc) result[locale] = value.$description || value.$desc;
+				else if (typeof value === "string") result[locale] = value;
+			}
+			return result;
+		}
+		function getInner(value) {
+			return value?.$value ?? value?.$inner;
+		}
+		function extractKeys(data) {
+			return filterKeys(data ?? {}, (key) => !key.startsWith("$"));
+		}
+		Schema.prototype.i18n = function i18n(messages) {
+			const schema = Schema(this);
+			const desc = mergeDesc(schema.meta.description, messages);
+			if (Object.keys(desc).length) schema.meta.description = desc;
+			if (schema.dict) schema.dict = mapValues(schema.dict, (inner, key) => {
+				return inner.i18n(mapValues(messages, (data) => getInner(data)?.[key] ?? data?.[key]));
+			});
+			if (schema.list) schema.list = schema.list.map((inner, index) => {
+				return inner.i18n(mapValues(messages, (data = {}) => {
+					if (Array.isArray(getInner(data))) return getInner(data)[index];
+					if (Array.isArray(data)) return data[index];
+					return extractKeys(data);
+				}));
+			});
+			if (schema.inner) schema.inner = schema.inner.i18n(mapValues(messages, (data) => {
+				if (getInner(data)) return getInner(data);
+				return extractKeys(data);
+			}));
+			if (schema.sKey) schema.sKey = schema.sKey.i18n(mapValues(messages, (data) => data?.$key));
+			return schema;
+		};
+		Schema.prototype.extra = function extra(key, value) {
+			const schema = Schema(this);
+			schema.meta = {
+				...schema.meta,
+				[key]: value
+			};
+			return schema;
+		};
+		for (const key of [
+			"required",
+			"disabled",
+			"collapse",
+			"hidden",
+			"loose"
+		]) Object.assign(Schema.prototype, { [key](value = true) {
+			const schema = Schema(this);
+			schema.meta = {
+				...schema.meta,
+				[key]: value
+			};
+			return schema;
+		} });
+		Schema.prototype.deprecated = function deprecated() {
+			const schema = Schema(this);
+			schema.meta.badges ||= [];
+			schema.meta.badges.push({
+				text: "deprecated",
+				type: "danger"
+			});
+			return schema;
+		};
+		Schema.prototype.experimental = function experimental() {
+			const schema = Schema(this);
+			schema.meta.badges ||= [];
+			schema.meta.badges.push({
+				text: "experimental",
+				type: "warning"
+			});
+			return schema;
+		};
+		Schema.prototype.pattern = function pattern(regexp) {
+			const schema = Schema(this);
+			const pattern = pick(regexp, ["source", "flags"]);
+			schema.meta = {
+				...schema.meta,
+				pattern
+			};
+			return schema;
+		};
+		Schema.prototype.simplify = function simplify(value) {
+			if (deepEqual(value, this.meta.default, this.type === "dict")) return null;
+			if (isNullable(value)) return value;
+			if (this.type === "object" || this.type === "dict") {
+				const result = {};
+				for (const key in value) {
+					const item = (this.type === "object" ? this.dict[key] : this.inner)?.simplify(value[key]);
+					if (this.type === "dict" || !isNullable(item)) result[key] = item;
+				}
+				if (deepEqual(result, this.meta.default, this.type === "dict")) return null;
+				return result;
+			} else if (this.type === "array" || this.type === "tuple") {
+				const result = [];
+				value.forEach((value, index) => {
+					const schema = this.type === "array" ? this.inner : this.list[index];
+					const item = schema ? schema.simplify(value) : value;
+					result.push(item);
+				});
+				return result;
+			} else if (this.type === "intersect") {
+				const result = {};
+				for (const item of this.list) Object.assign(result, item.simplify(value));
+				return result;
+			} else if (this.type === "union") for (const schema of this.list) try {
+				Schema.resolve(value, schema, {});
+				return schema.simplify(value);
+			} catch {}
+			return value;
+		};
+		Schema.prototype.toString = function toString(inline) {
+			return formatters[this.type]?.(this, inline) ?? `Schema<${this.type}>`;
+		};
+		Schema.prototype.role = function role(role, extra) {
+			const schema = Schema(this);
+			schema.meta = {
+				...schema.meta,
+				role,
+				extra
+			};
+			return schema;
+		};
+		for (const key of [
+			"default",
+			"link",
+			"comment",
+			"description",
+			"max",
+			"min",
+			"step"
+		]) Object.assign(Schema.prototype, { [key](value) {
+			const schema = Schema(this);
+			schema.meta = {
+				...schema.meta,
+				[key]: value
+			};
+			return schema;
+		} });
+		const resolvers = {};
+		Schema.extend = function extend(type, resolve) {
+			resolvers[type] = resolve;
+		};
+		Schema.resolve = function resolve(data, schema, options = {}, strict = false) {
+			if (!schema) return [data];
+			if (options.ignore?.(data, schema)) return [data];
+			if (isNullable(data) && schema.type !== "lazy") {
+				if (schema.meta.required) throw new ValidationError(`missing required value`, options);
+				let current = schema;
+				let fallback = schema.meta.default;
+				while (current?.type === "intersect" && isNullable(fallback)) {
+					current = current.list[0];
+					fallback = current?.meta.default;
+				}
+				if (isNullable(fallback)) return [data];
+				data = clone(fallback);
+			}
+			const callback = resolvers[schema.type];
+			if (!callback) throw new ValidationError(`unsupported type "${schema.type}"`, options);
+			try {
+				return callback(data, schema, options, strict);
+			} catch (error) {
+				if (!schema.meta.loose) throw error;
+				return [schema.meta.default];
+			}
+		};
+		Schema.from = function from(source) {
+			if (isNullable(source)) return Schema.any();
+			else if ([
+				"string",
+				"number",
+				"boolean"
+			].includes(typeof source)) return Schema.const(source).required();
+			else if (source[kSchema]) return source;
+			else if (typeof source === "function") switch (source) {
+				case String: return Schema.string().required();
+				case Number: return Schema.number().required();
+				case Boolean: return Schema.boolean().required();
+				case Function: return Schema.function().required();
+				default: return Schema.is(source).required();
+			}
+			else throw new TypeError(`cannot infer schema from ${source}`);
+		};
+		Schema.lazy = function lazy(builder) {
+			const toJSON = () => {
+				if (!schema.inner[kSchema]) {
+					schema.inner = schema.builder();
+					schema.inner.meta = {
+						...schema.meta,
+						...schema.inner.meta
+					};
+				}
+				return schema.inner.toJSON();
+			};
+			const schema = new Schema({
+				type: "lazy",
+				builder,
+				inner: { toJSON }
+			});
+			return schema;
+		};
+		Schema.natural = function natural() {
+			return Schema.number().step(1).min(0);
+		};
+		Schema.percent = function percent() {
+			return Schema.number().step(.01).min(0).max(1).role("slider");
+		};
+		Schema.date = function date() {
+			return Schema.union([Schema.is(Date), Schema.transform(Schema.string().role("datetime"), (value, options) => {
+				const date = new Date(value);
+				if (isNaN(+date)) throw new ValidationError(`invalid date "${value}"`, options);
+				return date;
+			}, true)]);
+		};
+		Schema.regExp = function regExp(flag = "") {
+			return Schema.union([Schema.is(RegExp), Schema.transform(Schema.string().role("regexp", { flag }), (value, options) => {
+				try {
+					return new RegExp(value, flag);
+				} catch (e) {
+					throw new ValidationError(e.message, options);
+				}
+			}, true)]);
+		};
+		Schema.arrayBuffer = function arrayBuffer(encoding) {
+			return Schema.union([
+				Schema.is(ArrayBuffer),
+				Schema.is(SharedArrayBuffer),
+				Schema.transform(Schema.any(), (value, options) => {
+					if (Binary.isSource(value)) return Binary.fromSource(value);
+					throw new ValidationError(`expected ArrayBufferSource but got ${value}`, options);
+				}, true),
+				...encoding ? [Schema.transform(Schema.string(), (value, options) => {
+					try {
+						return encoding === "base64" ? Binary.fromBase64(value) : Binary.fromHex(value);
+					} catch (e) {
+						throw new ValidationError(e.message, options);
+					}
+				}, true)] : []
+			]);
+		};
+		Schema.extend("lazy", (data, schema, options, strict) => {
+			if (!schema.inner[kSchema]) {
+				schema.inner = schema.builder();
+				schema.inner.meta = {
+					...schema.meta,
+					...schema.inner.meta
+				};
+			}
+			return Schema.resolve(data, schema.inner, options, strict);
+		});
+		Schema.extend("any", (data) => {
+			return [data];
+		});
+		Schema.extend("never", (data, _, options) => {
+			throw new ValidationError(`expected nullable but got ${data}`, options);
+		});
+		Schema.extend("const", (data, { value }, options) => {
+			if (deepEqual(data, value)) return [value];
+			throw new ValidationError(`expected ${value} but got ${data}`, options);
+		});
+		function checkWithinRange(data, meta, description, options, skipMin = false) {
+			const { max = Infinity, min = -Infinity } = meta;
+			if (data > max) throw new ValidationError(`expected ${description} <= ${max} but got ${data}`, options);
+			if (data < min && !skipMin) throw new ValidationError(`expected ${description} >= ${min} but got ${data}`, options);
+		}
+		Schema.extend("string", (data, { meta }, options) => {
+			if (typeof data !== "string") throw new ValidationError(`expected string but got ${data}`, options);
+			if (meta.pattern) {
+				const regexp = new RegExp(meta.pattern.source, meta.pattern.flags);
+				if (!regexp.test(data)) throw new ValidationError(`expect string to match regexp ${regexp}`, options);
+			}
+			checkWithinRange(data.length, meta, "string length", options);
+			return [data];
+		});
+		function decimalShift(data, digits) {
+			const str = data.toString();
+			if (str.includes("e")) return data * Math.pow(10, digits);
+			const index = str.indexOf(".");
+			if (index === -1) return data * Math.pow(10, digits);
+			const frac = str.slice(index + 1);
+			const integer = str.slice(0, index);
+			if (frac.length <= digits) return +(integer + frac.padEnd(digits, "0"));
+			return +(integer + frac.slice(0, digits) + "." + frac.slice(digits));
+		}
+		function isMultipleOf(data, min, step) {
+			step = Math.abs(step);
+			if (!/^\d+\.\d+$/.test(step.toString())) return (data - min) % step === 0;
+			const index = step.toString().indexOf(".");
+			const digits = step.toString().slice(index + 1).length;
+			return Math.abs(decimalShift(data, digits) - decimalShift(min, digits)) % decimalShift(step, digits) === 0;
+		}
+		Schema.extend("number", (data, { meta }, options) => {
+			if (typeof data !== "number") throw new ValidationError(`expected number but got ${data}`, options);
+			checkWithinRange(data, meta, "number", options);
+			const { step } = meta;
+			if (step && !isMultipleOf(data, meta.min ?? 0, step)) throw new ValidationError(`expected number multiple of ${step} but got ${data}`, options);
+			return [data];
+		});
+		Schema.extend("boolean", (data, _, options) => {
+			if (typeof data === "boolean") return [data];
+			throw new ValidationError(`expected boolean but got ${data}`, options);
+		});
+		Schema.extend("bitset", (data, { bits, meta }, options) => {
+			let value = 0, keys = [];
+			if (typeof data === "number") {
+				value = data;
+				for (const key in bits) if (data & bits[key]) keys.push(key);
+			} else if (Array.isArray(data)) {
+				keys = data;
+				for (const key of keys) {
+					if (typeof key !== "string") throw new ValidationError(`expected string but got ${key}`, options);
+					if (key in bits) value |= bits[key];
+				}
+			} else throw new ValidationError(`expected number or array but got ${data}`, options);
+			if (value === meta.default) return [value];
+			return [value, keys];
+		});
+		Schema.extend("function", (data, _, options) => {
+			if (typeof data === "function") return [data];
+			throw new ValidationError(`expected function but got ${data}`, options);
+		});
+		Schema.extend("is", (data, { constructor }, options) => {
+			if (typeof constructor === "function") {
+				if (data instanceof constructor) return [data];
+				throw new ValidationError(`expected ${constructor.name} but got ${data}`, options);
+			} else {
+				if (isNullable(data)) throw new ValidationError(`expected ${constructor} but got ${data}`, options);
+				let prototype = Object.getPrototypeOf(data);
+				while (prototype) {
+					if (prototype.constructor?.name === constructor) return [data];
+					prototype = Object.getPrototypeOf(prototype);
+				}
+				throw new ValidationError(`expected ${constructor} but got ${data}`, options);
+			}
+		});
+		function property(data, key, schema, options) {
+			try {
+				const [value, adapted] = Schema.resolve(data[key], schema, {
+					...options,
+					path: [...options.path || [], key]
+				});
+				if (adapted !== void 0) data[key] = adapted;
+				return value;
+			} catch (e) {
+				if (!options?.autofix) throw e;
+				delete data[key];
+				return schema.meta.default;
+			}
+		}
+		Schema.extend("array", (data, { inner, meta }, options) => {
+			if (!Array.isArray(data)) throw new ValidationError(`expected array but got ${data}`, options);
+			checkWithinRange(data.length, meta, "array length", options, !isNullable(inner.meta.default));
+			return [data.map((_, index) => property(data, index, inner, options))];
+		});
+		Schema.extend("dict", (data, { inner, sKey }, options, strict) => {
+			if (!isPlainObject(data)) throw new ValidationError(`expected object but got ${data}`, options);
+			const result = {};
+			for (const key in data) {
+				let rKey;
+				try {
+					rKey = Schema.resolve(key, sKey, options)[0];
+				} catch (error) {
+					if (strict) continue;
+					throw error;
+				}
+				result[rKey] = property(data, key, inner, options);
+				data[rKey] = data[key];
+				if (key !== rKey) delete data[key];
+			}
+			return [result];
+		});
+		Schema.extend("tuple", (data, { list }, options, strict) => {
+			if (!Array.isArray(data)) throw new ValidationError(`expected array but got ${data}`, options);
+			const result = list.map((inner, index) => property(data, index, inner, options));
+			if (strict) return [result];
+			result.push(...data.slice(list.length));
+			return [result];
+		});
+		function merge(result, data) {
+			for (const key in data) {
+				if (key in result) continue;
+				result[key] = data[key];
+			}
+		}
+		Schema.extend("object", (data, { dict }, options, strict) => {
+			if (!isPlainObject(data)) throw new ValidationError(`expected object but got ${data}`, options);
+			const result = {};
+			for (const key in dict) {
+				const value = property(data, key, dict[key], options);
+				if (!isNullable(value) || key in data) result[key] = value;
+			}
+			if (!strict) merge(result, data);
+			return [result];
+		});
+		Schema.extend("union", (data, { list, toString }, options, strict) => {
+			const messages = [];
+			for (const inner of list) try {
+				return Schema.resolve(data, inner, options, strict);
+			} catch (error) {
+				messages.push(error);
+			}
+			throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+		});
+		Schema.extend("intersect", (data, { list, toString }, options, strict) => {
+			if (!list.length) return [data];
+			let result;
+			for (const inner of list) {
+				const value = Schema.resolve(data, inner, options, true)[0];
+				if (isNullable(value)) continue;
+				if (isNullable(result)) result = value;
+				else if (typeof result !== typeof value) throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+				else if (typeof value === "object") merge(result ??= {}, value);
+				else if (result !== value) throw new ValidationError(`expected ${toString()} but got ${JSON.stringify(data)}`, options);
+			}
+			if (!strict && isPlainObject(data)) merge(result, data);
+			return [result];
+		});
+		Schema.extend("transform", (data, { inner, callback, preserve }, options) => {
+			const [result, adapted = data] = Schema.resolve(data, inner, options, true);
+			if (preserve) return [callback(result)];
+			else return [callback(result), callback(adapted)];
+		});
+		const formatters = {};
+		function defineMethod(name, keys, format) {
+			formatters[name] = format;
+			Object.assign(Schema, { [name](...args) {
+				const schema = new Schema({ type: name });
+				keys.forEach((key, index) => {
+					switch (key) {
+						case "sKey":
+							schema.sKey = args[index] ?? Schema.string();
+							break;
+						case "inner":
+							schema.inner = Schema.from(args[index]);
+							break;
+						case "list":
+							schema.list = args[index].map(Schema.from);
+							break;
+						case "dict":
+							schema.dict = mapValues(args[index], Schema.from);
+							break;
+						case "bits":
+							schema.bits = {};
+							for (const key in args[index]) {
+								if (typeof args[index][key] !== "number") continue;
+								schema.bits[key] = args[index][key];
+							}
+							break;
+						case "callback": {
+							const callback = schema.callback = args[index];
+							callback["toJSON"] ||= () => callback.toString();
+							break;
+						}
+						case "constructor": {
+							const constructor = schema.constructor = args[index];
+							if (typeof constructor === "function") constructor["toJSON"] ||= () => constructor["name"];
+							break;
+						}
+						default: schema[key] = args[index];
+					}
+				});
+				if (name === "object" || name === "dict") schema.meta.default = {};
+				else if (name === "array" || name === "tuple") schema.meta.default = [];
+				else if (name === "bitset") schema.meta.default = 0;
+				return schema;
+			} });
+		}
+		defineMethod("is", ["constructor"], ({ constructor }) => {
+			if (typeof constructor === "function") return constructor.name;
+			else return constructor;
+		});
+		defineMethod("any", [], () => "any");
+		defineMethod("never", [], () => "never");
+		defineMethod("const", ["value"], ({ value }) => typeof value === "string" ? JSON.stringify(value) : value);
+		defineMethod("string", [], () => "string");
+		defineMethod("number", [], () => "number");
+		defineMethod("boolean", [], () => "boolean");
+		defineMethod("bitset", ["bits"], () => "bitset");
+		defineMethod("function", [], () => "function");
+		defineMethod("array", ["inner"], ({ inner }) => `${inner.toString(true)}[]`);
+		defineMethod("dict", ["inner", "sKey"], ({ inner, sKey }) => `{ [key: ${sKey.toString()}]: ${inner.toString()} }`);
+		defineMethod("tuple", ["list"], ({ list }) => `[${list.map((inner) => inner.toString()).join(", ")}]`);
+		defineMethod("object", ["dict"], ({ dict }) => {
+			if (Object.keys(dict).length === 0) return "{}";
+			return `{ ${Object.entries(dict).map(([key, inner]) => {
+				return `${key}${inner.meta.required ? "" : "?"}: ${inner.toString()}`;
+			}).join(", ")} }`;
+		});
+		defineMethod("union", ["list"], ({ list }, inline) => {
+			const result = list.map(({ toString: format }) => format()).join(" | ");
+			return inline ? `(${result})` : result;
+		});
+		defineMethod("intersect", ["list"], ({ list }) => {
+			return `${list.map((inner) => inner.toString(true)).join(" & ")}`;
+		});
+		defineMethod("transform", [
+			"inner",
+			"callback",
+			"preserve"
+		], ({ inner }, isInner) => inner.toString(isInner));
+		//#endregion
+		//#region lib/types/client/schema.js
+		/** Synchronous schema introspection and immutable settings-draft edits. */
+		function cloneContainer(container, key) {
+			if (Array.isArray(container)) return [...container];
+			if (typeof container === "object" && container !== null) return { ...container };
+			return /^\d+$/.test(key) ? [] : {};
+		}
+		function cloneSpine(root, path) {
+			const result = { ...root };
+			let target = result;
+			for (let index = 0; index < path.length - 1; index++) {
+				const key = path[index];
+				const child = cloneContainer(Array.isArray(target) ? target[Number(key)] : target[key], path[index + 1]);
+				if (Array.isArray(target)) target[Number(key)] = child;
+				else target[key] = child;
+				target = child;
+			}
+			return {
+				result,
+				parent: target,
+				leaf: path[path.length - 1]
+			};
+		}
+		/**
+		* Settings-owned synchronous schema service. Dynamic client plugins receive
+		* this Cordis entity instead of importing executable helpers from one another.
+		*/
+		var SettingsSchemaService = class extends _nomix_ai_cordis.Service {
+			/** @param ctx - providing ui-settings context. */
+			constructor(ctx) {
+				super(ctx, "settingsSchema");
+			}
+			/**
+			* Rehydrate one serialized `schema.toJSON()` envelope.
+			* @param serialized - serialized Schemastery node.
+			* @returns live schema node.
+			*/
+			rehydrate(serialized) {
+				return new Schema(serialized);
+			}
+			/**
+			* Validate a settings draft.
+			* @param schema - live schema node.
+			* @param draft - candidate settings value.
+			* @returns validation failure text, or `undefined` when valid.
+			*/
+			validate(schema, draft) {
+				try {
+					schema(draft);
+					return;
+				} catch (error) {
+					return error instanceof Error ? error.message : String(error);
+				}
+			}
+			/**
+			* Resolve an object, dict, or array schema node at a settings path.
+			* @param root - schema node to traverse.
+			* @param path - object keys or array indexes.
+			* @returns the resolved node, or `undefined` when the path is absent.
+			*/
+			nodeAtPath(root, path) {
+				let node = root;
+				for (const key of path) {
+					if (node === void 0) return void 0;
+					if (node.type === "object") node = node.dict?.[key];
+					else if (node.type === "dict" || node.type === "array") node = node.inner;
+					else return void 0;
+				}
+				return node;
+			}
+			/**
+			* Read a nested value by a string-key or array-index path.
+			* @param value - value to traverse.
+			* @param path - object keys or array indexes.
+			* @returns the resolved value, or `undefined` when the path is absent.
+			*/
+			getPath(value, path) {
+				let current = value;
+				for (const key of path) {
+					if (Array.isArray(current)) {
+						current = current[Number(key)];
+						continue;
+					}
+					if (typeof current !== "object" || current === null) return void 0;
+					current = current[key];
+				}
+				return current;
+			}
+			/**
+			* Report whether the final path key exists independently of its value.
+			* @param value - value to traverse.
+			* @param path - object keys or array indexes.
+			* @returns whether the path exists.
+			*/
+			hasPath(value, path) {
+				if (path.length === 0) return value !== void 0;
+				const parent = this.getPath(value, path.slice(0, -1));
+				const key = path[path.length - 1];
+				if (Array.isArray(parent)) return Number(key) < parent.length;
+				if (typeof parent !== "object" || parent === null) return false;
+				return key in parent;
+			}
+			/**
+			* Immutably set a nested value, materializing missing containers.
+			* @param root - settings object to copy.
+			* @param path - non-empty object-key or array-index path.
+			* @param value - replacement value.
+			* @returns copied root containing the replacement.
+			* @throws when `path` is empty.
+			*/
+			setPath(root, path, value) {
+				if (path.length === 0) throw new Error("ui-settings: setPath needs a non-empty path");
+				const { result, parent, leaf } = cloneSpine(root, path);
+				if (Array.isArray(parent)) parent[Number(leaf)] = value;
+				else parent[leaf] = value;
+				return result;
+			}
+			/**
+			* Immutably remove a nested key, preserving an unchanged missing root.
+			* @param root - settings object to copy.
+			* @param path - non-empty object-key or array-index path.
+			* @returns copied root without the key, or `root` when the path is absent.
+			* @throws when `path` is empty.
+			*/
+			deletePath(root, path) {
+				if (path.length === 0) throw new Error("ui-settings: deletePath needs a non-empty path");
+				if (!this.hasPath(root, path)) return root;
+				const { result, parent, leaf } = cloneSpine(root, path);
+				if (Array.isArray(parent)) parent.splice(Number(leaf), 1);
+				else Reflect.deleteProperty(parent, leaf);
+				return result;
+			}
+		};
+		//#endregion
 		//#region lib/types/client/settings-scope.js
 		/**
 		* Host transport for the settings-namespace scope contract. The contract types
 		* live in `nomix-client-runtime` (the common dependency of every feature that
-		* owns a preference); this file owns the wire behavior and the invalidation
-		* subscription, both of which are Settings-surface concerns.
+		* owns a preference); this file owns the per-namespace derivation over the
+		* shared {@link SettingsDescribeMirror} and the serialized write path, both of
+		* which are Settings-surface concerns. Reads never touch the wire here: the
+		* mirror is the one `settings.describe` reader, and every scope is a selector
+		* over its snapshot.
 		*/
 		/**
-		* Serializes one namespace's Host reads and writes behind a snapshot store.
-		* Reads never block plugin activation; writes carry the latest known
-		* namespace revision and teardown waits for the operation already crossing
-		* the wire.
+		* One namespace's derived view over the shared describe mirror, plus that
+		* namespace's serialized Host writes. Writes carry the latest known namespace
+		* revision, fold their answers back into the mirror, and teardown waits for
+		* the operation already crossing the wire.
 		*/
 		var SettingsScopeController = class {
 			api;
 			spec;
+			mirror;
 			persistence;
+			schema;
 			store;
 			tail = Promise.resolve();
-			readGeneration = 0;
 			writeGeneration = 0;
 			disposed = false;
+			unsubscribe;
 			/**
-			* @param api - settings wire face.
+			* Revision answered by a superseded write still ahead of the mirror: the
+			* mirror only folds the LATEST settlement in, so a queued successor takes
+			* its fence from here first.
+			*/
+			pendingRevision;
+			/**
+			* @param api - settings wire face (writes only; reads ride the mirror).
 			* @param spec - namespace identity and optional narrowing decoder.
+			* @param mirror - the shared describe mirror this scope derives from.
 			* @param persistence - remote browsers remain process-local because settings RPCs are loopback-only.
+			* @param schema - settings-owned schema operations.
 			*/
-			constructor(api, spec, persistence = "host") {
+			constructor(api, spec, mirror, persistence, schema) {
 				this.api = api;
 				this.spec = spec;
+				this.mirror = mirror;
 				this.persistence = persistence;
+				this.schema = schema;
 				this.store = (0, _nomix_ai_nomix_client_runtime_client.createSnapshotStore)({
 					status: persistence === "host" ? "loading" : "unavailable",
 					value: void 0,
@@ -47,6 +987,12 @@ window.__ModuleLoader__.load({
 					writable: false,
 					mode: persistence
 				});
+				if (persistence === "host") {
+					this.unsubscribe = mirror.subscribe(() => {
+						this.derive();
+					});
+					this.derive();
+				}
 			}
 			/** @returns the current sync snapshot (stable reference until the next change). */
 			getSnapshot() {
@@ -61,14 +1007,6 @@ window.__ModuleLoader__.load({
 				return this.store.subscribe(listener);
 			}
 			/**
-			* Queue a Host refresh; a newer read or user write suppresses stale publication.
-			* @returns settlement after the queued read completes or is skipped.
-			*/
-			load() {
-				const generation = ++this.readGeneration;
-				return this.enqueue(() => this.read(generation));
-			}
-			/**
 			* Queue one field write; see {@link SettingsScope.set} for the ordering,
 			* revision, and recovery contract.
 			* @param field - scalar field inside the namespace section.
@@ -95,10 +1033,9 @@ window.__ModuleLoader__.load({
 				});
 			}
 			write(op) {
-				this.readGeneration += 1;
 				const generation = ++this.writeGeneration;
 				return this.enqueue(async () => {
-					const revision = this.getSnapshot().revision;
+					const revision = this.pendingRevision ?? this.getSnapshot().revision;
 					let response;
 					try {
 						response = await this.api.settings.mutate({
@@ -107,24 +1044,35 @@ window.__ModuleLoader__.load({
 							...revision === void 0 ? {} : { expectedRevision: revision }
 						});
 					} catch (_settingsWriteFailure) {
-						if (!this.disposed && generation === this.writeGeneration) await this.read(++this.readGeneration);
+						await this.recover(generation);
 						return;
 					}
 					if (!response.result.ok) {
-						if (!this.disposed && generation === this.writeGeneration) await this.read(++this.readGeneration);
+						await this.recover(generation);
 						return;
 					}
-					this.accept(response.result.value, generation === this.writeGeneration);
+					if (this.disposed) return;
+					if (generation === this.writeGeneration) {
+						this.pendingRevision = void 0;
+						this.mirror.acceptView(response.result.value);
+					} else this.pendingRevision = response.result.value.revision;
 				});
 			}
+			/** Reload Host state for the latest failed write; superseded failures leave recovery to it. */
+			async recover(generation) {
+				if (this.disposed || generation !== this.writeGeneration) return;
+				this.pendingRevision = void 0;
+				await this.mirror.load();
+			}
 			/**
-			* Stop queued operations and wait for the current wire call to settle.
+			* Stop queued operations, stop deriving, and wait for the current wire call
+			* to settle.
 			* @returns settlement after the controller reaches quiescence.
 			*/
 			async dispose() {
 				this.disposed = true;
-				this.readGeneration += 1;
 				this.writeGeneration += 1;
+				this.unsubscribe?.();
 				await this.tail;
 			}
 			enqueue(operation) {
@@ -136,33 +1084,25 @@ window.__ModuleLoader__.load({
 				this.tail = task.catch(() => {});
 				return task;
 			}
-			async read(generation) {
-				let response;
-				try {
-					response = await this.api.settings.describe({});
-				} catch (_settingsReadFailure) {
-					return;
-				}
-				if (!response.result.ok || this.disposed) return;
-				const { namespaces, writable } = response.result.value;
-				const view = namespaces.find((candidate) => candidate.ns === this.spec.namespace);
-				const publish = generation === this.readGeneration;
+			derive() {
+				if (this.disposed) return;
+				const mirrored = this.mirror.getSnapshot();
+				if (mirrored.view === void 0) return;
+				const { writable } = mirrored.view;
+				const view = mirrored.view.namespaces.find((candidate) => candidate.ns === this.spec.namespace);
 				if (view === void 0) {
-					if (publish) this.store.update((draft) => {
+					this.store.update((draft) => {
 						draft.status = "unavailable";
 						draft.writable = writable;
 					});
 					return;
 				}
-				this.accept(view, publish, writable);
-			}
-			accept(view, publish, writable) {
-				const decoded = publish ? this.decode(view) : void 0;
+				const decoded = this.decode(view);
 				this.store.update((draft) => {
 					draft.revision = view.revision;
 					draft.base = view.base;
 					draft.user = view.user;
-					if (writable !== void 0) draft.writable = writable;
+					draft.writable = writable;
 					if (decoded === void 0) return;
 					draft.status = "ready";
 					draft.value = decoded;
@@ -173,7 +1113,7 @@ window.__ModuleLoader__.load({
 				if (typeof view.value !== "object" || view.value === null || Array.isArray(view.value)) return void 0;
 				let failure;
 				try {
-					failure = (0, _nomix_ai_nomix_client_schema_form.validateDraft)((0, _nomix_ai_nomix_client_schema_form.rehydrateSchema)(view.schema), view.value);
+					failure = this.schema.validate(this.schema.rehydrate(view.schema), view.value);
 				} catch (_malformedSchemaEnvelope) {
 					return;
 				}
@@ -188,37 +1128,45 @@ window.__ModuleLoader__.load({
 		* (`packages/client/tsdown.client.ts`).
 		*/
 		var SettingsScopeBinder = class extends _nomix_ai_cordis.Service {
+			mirror;
+			schema;
 			/**
 			* @param ctx - the providing plugin's context.
+			* @param config - the shared describe mirror every bound scope derives from,
+			* plus the settings-owned schema operations.
 			*/
-			constructor(ctx) {
+			constructor(ctx, config) {
 				super(ctx, "settingsScope");
+				this.mirror = config.mirror;
+				this.schema = config.schema;
+			}
+			/**
+			* The shared mirror's read/fold face for cross-namespace surfaces (schema
+			* introspection, the served-namespace directory). Per-namespace consumers
+			* use {@link bind}; both derive from the same snapshot, so they can never
+			* disagree about the document.
+			* @returns the describe face over the shared mirror.
+			*/
+			describe() {
+				return this.mirror;
 			}
 			/**
-			* Bind one namespace scope to settings and connection invalidations on the
-			* CALLER's plugin lifecycle — the service proxy binds `this.ctx` to the
-			* caller at call time, so the scope's disposer belongs to the calling fiber.
-			* Listeners exist before the initial background read starts, so activation
-			* never blocks on the settings transport. The caller injects `connection`
-			* for the transport and `remote` for the forwarded settings invalidation.
+			* Bind one namespace scope on the CALLER's plugin lifecycle — the service
+			* proxy binds `this.ctx` to the caller at call time, so the scope's disposer
+			* belongs to the calling fiber. The scope derives from the shared mirror
+			* (whose invalidation subscriptions live with the providing plugin), so
+			* binding adds no wire read of its own and activation never blocks on the
+			* settings transport.
 			* @param spec - domain-owned namespace contract.
 			* @returns the bound scope consumed by the domain's services and rows.
 			*/
 			bind(spec) {
 				const ctx = this.ctx;
 				const connection = ctx.get("connection");
-				const controller = new SettingsScopeController(connection.api, spec, connection.isLoopback ? "host" : "memory");
+				const controller = new SettingsScopeController(connection.api, spec, this.mirror, connection.isLoopback ? "host" : "memory", this.schema);
 				ctx.effect(() => {
-					const refresh = (namespace) => {
-						if (namespace !== void 0 && namespace !== spec.namespace) return;
-						controller.load();
-					};
-					const disposers = [ctx.get("remote").$on("settings/document-updated", refresh), ctx.on("connection/reset", () => {
-						refresh();
-					})];
-					controller.load();
+					this.mirror.ensure();
 					return async () => {
-						for (const dispose of disposers) dispose();
 						await controller.dispose();
 					};
 				}, `ui-settings: ${spec.namespace} settings scope`);
@@ -226,25 +1174,187 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region lib/types/client/settings-mirror.js
+		/**
+		* Client mirror of the Host settings document: the one `settings.describe`
+		* reader in the browser. Every settings consumer derives from this store —
+		* per-namespace scopes through `SettingsScopeBinder.bind`, cross-namespace
+		* surfaces through the binder's shared describe face — so startup cost and
+		* freshness are properties of this class, not of how many features own a
+		* preference. The Host stays the fact source: the mirror re-reads on the
+		* invalidations its owning plugin subscribes to and folds write answers in
+		* through {@link SettingsDescribeMirror.acceptView}.
+		*/
+		/**
+		* Serializes every Host `settings.describe` read behind one snapshot store.
+		* Concurrent {@link load} calls fold into the in-flight read plus one rerun,
+		* so an invalidation arriving mid-read is never lost and never duplicated.
+		*/
+		var SettingsDescribeMirror = class {
+			api;
+			persistence;
+			store;
+			inFlight;
+			rerun = false;
+			generation = 0;
+			/**
+			* @param api - settings wire face.
+			* @param persistence - remote browsers stay process-local because settings RPCs are loopback-only.
+			*/
+			constructor(api, persistence = "host") {
+				this.api = api;
+				this.persistence = persistence;
+				this.store = (0, _nomix_ai_nomix_client_runtime_client.createSnapshotStore)({
+					status: persistence === "host" ? "idle" : "unavailable",
+					view: void 0,
+					error: null
+				});
+			}
+			/** @returns the current sync snapshot (stable reference until the next change). */
+			getSnapshot() {
+				return this.store.getSnapshot();
+			}
+			/**
+			* Observe snapshot replacements.
+			* @param listener - invoked after each snapshot change.
+			* @returns the disposer removing this listener.
+			*/
+			subscribe(listener) {
+				return this.store.subscribe(listener);
+			}
+			/**
+			* Refresh from the Host. A call during an in-flight read marks one rerun
+			* after it settles instead of racing a second wire read.
+			* @returns settlement after this call's freshness is reflected.
+			*/
+			load() {
+				if (this.persistence === "memory") return Promise.resolve();
+				if (this.inFlight !== void 0) {
+					this.rerun = true;
+					return this.inFlight;
+				}
+				const run = Promise.resolve().then(() => this.run());
+				this.inFlight = run;
+				return run;
+			}
+			/**
+			* Resolve once an answer is held (or the mirror is terminally unavailable),
+			* reading only from `idle`. The cheap idempotent entry for surfaces that
+			* render on first use.
+			* @returns settlement of the current or newly started read, if any.
+			*/
+			ensure() {
+				if (this.persistence === "memory") return Promise.resolve();
+				if (this.inFlight !== void 0) return this.inFlight;
+				if (this.getSnapshot().status === "idle") return this.load();
+				return Promise.resolve();
+			}
+			/**
+			* Fold one write answer's namespace view into the held view without a wire
+			* read, and invalidate any read still in flight. With no held document, the
+			* answer is not published as a partial document; an in-flight read reruns so
+			* it cannot publish a document fetched before the write committed.
+			* @param view - the namespace view a settings write answered with.
+			*/
+			acceptView(view) {
+				const before = this.store.getSnapshot();
+				this.generation += 1;
+				if (this.inFlight !== void 0) this.rerun = true;
+				if (before.view === void 0) return;
+				const namespaces = before.view.namespaces.some((row) => row.ns === view.ns) ? before.view.namespaces.map((row) => row.ns === view.ns ? view : row) : [...before.view.namespaces, view];
+				this.store.set({
+					...before,
+					view: {
+						...before.view,
+						namespaces
+					}
+				});
+			}
+			/**
+			* Convenience row lookup on the held view.
+			* @param ns - namespace identity.
+			* @returns the namespace view, or undefined while unanswered or unregistered.
+			*/
+			namespace(ns) {
+				return this.store.getSnapshot().view?.namespaces.find((row) => row.ns === ns);
+			}
+			async run() {
+				try {
+					do {
+						const before = this.store.getSnapshot();
+						if (before.status === "idle") this.store.set({
+							...before,
+							status: "loading"
+						});
+						this.rerun = false;
+						const generation = ++this.generation;
+						let outcome;
+						try {
+							const response = await this.api.settings.describe({});
+							outcome = response.result.ok ? { view: response.result.value } : { failure: response.result.error.message };
+						} catch (error) {
+							outcome = { failure: error instanceof Error ? error.message : String(error) };
+						}
+						if (generation !== this.generation) continue;
+						if ("view" in outcome) this.store.set({
+							status: "ready",
+							view: outcome.view,
+							error: null
+						});
+						else {
+							const held = this.store.getSnapshot();
+							this.store.set({
+								status: held.view === void 0 ? "idle" : "ready",
+								view: held.view,
+								error: outcome.failure
+							});
+						}
+					} while (this.shouldRerun());
+				} finally {
+					this.inFlight = void 0;
+				}
+			}
+			shouldRerun() {
+				return this.rerun;
+			}
+		};
+		//#endregion
 		//#region lib/types/client/index.js
 		/**
-		* Required services: none. The transport is resolved per caller through
-		* `this.ctx` at `bind` time, so this plugin waits for nothing.
+		* Required services: the wire handle for the mirror's reads and the forwarded
+		* settings invalidation the mirror refreshes on.
 		*/
-		const inject = [];
+		const inject = ["connection", "remote"];
 		/**
-		* Provide the settings-namespace scope service.
+		* Provide the settings-namespace scope service over one shared describe
+		* mirror, and keep that mirror fresh on the two signals that can move the
+		* settings document: a document commit and a (re)connect.
 		*
 		* Constructing the service in this plugin's fiber keeps its traced methods
 		* bound to each consuming plugin's context.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
-			new SettingsScopeBinder(ctx);
+			const schema = new SettingsSchemaService(ctx);
+			const connection = ctx.get("connection");
+			const mirror = new SettingsDescribeMirror(connection.api, connection.isLoopback ? "host" : "memory");
+			ctx.effect(() => {
+				const disposers = [ctx.get("remote").$on("settings/document-updated", () => {
+					mirror.load();
+				}), ctx.on("connection/reset", () => {
+					mirror.load();
+				})];
+				mirror.ensure();
+				return () => {
+					for (const dispose of disposers) dispose();
+				};
+			}, "ui-settings: describe mirror invalidations");
+			new SettingsScopeBinder(ctx, {
+				mirror,
+				schema
+			});
 		}
 		//#endregion
-		exports.SettingsScopeBinder = SettingsScopeBinder;
-		exports.SettingsScopeController = SettingsScopeController;
 		exports.apply = apply;
 		exports.inject = inject;
 		return module.exports;