@optique/core 1.0.0-dev.1866 → 1.0.0-dev.1868

package/dist/annotations.cjs

@@ -87,9 +87,9 @@ function defineProtectedDataProperty(context, target, key, descriptor) {
 		set: () => throwReadonlyAnnotationMutation()
 	});
 }
-function copyOwnProperties(source, target, transformValue, excludedKeys) {
+function copyOwnProperties(source, target, transformValue, excludedKeys, syncPrototype = true) {
 	const sourcePrototype = Object.getPrototypeOf(source);
-	if (Object.getPrototypeOf(target) !== sourcePrototype) Object.setPrototypeOf(target, sourcePrototype);
+	if (syncPrototype && Object.getPrototypeOf(target) !== sourcePrototype) Object.setPrototypeOf(target, sourcePrototype);
 	for (const key of Reflect.ownKeys(source)) {
 		if (excludedKeys?.has(key) === true) continue;
 		const descriptor = Object.getOwnPropertyDescriptor(source, key);
@@ -107,60 +107,146 @@ function copyOwnProperties(source, target, transformValue, excludedKeys) {
 function normalizeProtectedCollectionItem(value, context) {
 	return context.rewrapProtectedViews && isProtectedAnnotationView(value) ? unwrapProtectedAnnotationTarget(value) : value;
 }
-function getProtectedProxyFallbackValue(target, key, context) {
-	const ownDescriptor = Reflect.getOwnPropertyDescriptor(target, key);
-	if (ownDescriptor != null && "value" in ownDescriptor) {
-		if (ownDescriptor.configurable === false && ownDescriptor.writable === false) return ownDescriptor.value;
-		const value$1 = ownDescriptor.value;
-		return typeof value$1 === "function" ? value$1.bind(target) : protectAnnotationValue(value$1, context);
+function resolveCloneConstructor(source) {
+	const constructorValue = source.constructor;
+	if (typeof constructorValue !== "function") return void 0;
+	const species = Reflect.get(constructorValue, Symbol.species);
+	const cloneConstructor = species == null ? constructorValue : species;
+	return typeof cloneConstructor === "function" ? cloneConstructor : void 0;
+}
+function hasBuiltInSubclassPrototype(target, basePrototype) {
+	return Object.getPrototypeOf(target) !== basePrototype;
+}
+function tryCloneMapSubclass(source, entries) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(entries);
+		return cloned instanceof Map ? cloned : void 0;
+	} catch {
+		return void 0;
 	}
-	const value = Reflect.get(target, key, target);
-	return typeof value === "function" ? value.bind(target) : protectAnnotationValue(value, context);
 }
-function getProtectedProxyOwnPropertyDescriptor(target, key, context) {
-	const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
-	if (descriptor == null || !("value" in descriptor)) return descriptor;
-	if (descriptor.configurable === false && descriptor.writable === false) return descriptor;
-	const value = protectAnnotationValue(descriptor.value, context);
-	return value === descriptor.value ? descriptor : {
-		...descriptor,
-		value
-	};
+function tryCloneSetSubclass(source, values) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(values);
+		return cloned instanceof Set ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function resolveProtectedMapLookup(target, lookup) {
-	if (target.has(lookup)) return {
-		found: true,
-		value: target.get(lookup)
-	};
-	const rawLookup = unwrapProtectedAnnotationTarget(lookup);
-	if (rawLookup !== lookup && target.has(rawLookup)) return {
-		found: true,
-		value: target.get(rawLookup)
-	};
-	for (const [entryKey, entryValue] of target.entries()) if (unwrapProtectedAnnotationTarget(entryKey) === rawLookup) return {
-		found: true,
-		value: entryValue
-	};
-	return { found: false };
+function tryCloneDateSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.getTime());
+		return cloned instanceof Date ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function hasProtectedSetLookup(target, lookup) {
-	if (target.has(lookup)) return true;
-	const rawLookup = unwrapProtectedAnnotationTarget(lookup);
-	if (rawLookup !== lookup && target.has(rawLookup)) return true;
-	for (const value of target.values()) if (unwrapProtectedAnnotationTarget(value) === rawLookup) return true;
-	return false;
+function tryCloneRegExpSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.source, source.flags);
+		return cloned instanceof RegExp ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function usesSubclassProxyFallback(target, basePrototype) {
-	return Object.getPrototypeOf(target) !== basePrototype;
+function tryCloneURLSearchParamsSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source);
+		return cloned instanceof URLSearchParams ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
+}
+function tryCloneURLSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.href);
+		return cloned instanceof URL ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
 const regExpExcludedKeys = new Set(["lastIndex"]);
-function copyRegExpMetadata(source, target, transformValue) {
-	copyOwnProperties(source, target, transformValue, regExpExcludedKeys);
+const mapMutationMethodKeys = [
+	"set",
+	"delete",
+	"clear"
+];
+const setMutationMethodKeys = [
+	"add",
+	"delete",
+	"clear"
+];
+const urlSearchParamsMutationMethodKeys = [
+	"append",
+	"delete",
+	"set",
+	"sort"
+];
+const urlMutationPropertyKeys = [
+	"hash",
+	"host",
+	"hostname",
+	"href",
+	"password",
+	"pathname",
+	"port",
+	"protocol",
+	"search",
+	"username"
+];
+const dateMutationMethodKeys = Object.getOwnPropertyNames(Date.prototype).filter((key) => key.startsWith("set"));
+function installReadonlyMutationMethodGuards(target, keys) {
+	for (const key of keys) {
+		const descriptor = Object.getOwnPropertyDescriptor(target, key);
+		if (descriptor?.configurable === false) continue;
+		Object.defineProperty(target, key, {
+			configurable: true,
+			enumerable: false,
+			writable: true,
+			value: (..._args) => throwReadonlyAnnotationMutation()
+		});
+	}
+}
+function installReadonlyURLGuards(target, context) {
+	const searchParams = target.searchParams;
+	const searchParamsDescriptor = Object.getOwnPropertyDescriptor(target, "searchParams");
+	if (searchParamsDescriptor?.configurable !== false) Object.defineProperty(target, "searchParams", {
+		configurable: true,
+		enumerable: false,
+		get: () => protectAnnotationValue(searchParams, context),
+		set: () => throwReadonlyAnnotationMutation()
+	});
+	for (const key of urlMutationPropertyKeys) {
+		const descriptor = Object.getOwnPropertyDescriptor(target, key);
+		if (descriptor?.configurable === false) continue;
+		Object.defineProperty(target, key, {
+			configurable: true,
+			enumerable: false,
+			get: () => Reflect.get(URL.prototype, key, target),
+			set: () => throwReadonlyAnnotationMutation()
+		});
+	}
+}
+function copyRegExpMetadata(source, target, transformValue, syncPrototype = true) {
+	copyOwnProperties(source, target, transformValue, regExpExcludedKeys, syncPrototype);
 	target.lastIndex = source.lastIndex;
 }
 function cloneRegExpShape(source) {
-	const cloned = new RegExp(source);
-	copyRegExpMetadata(source, cloned);
+	const syncPrototype = !hasBuiltInSubclassPrototype(source, RegExp.prototype);
+	const cloned = syncPrototype ? new RegExp(source) : tryCloneRegExpSubclass(source) ?? new RegExp(source);
+	copyRegExpMetadata(source, cloned, void 0, syncPrototype);
 	return cloned;
 }
 function createProtectedObjectView(target, context) {
@@ -204,56 +290,10 @@ function createProtectedObjectView(target, context) {
 	return Object.freeze(view);
 }
 function createProtectedMapView(target, context) {
-	if (usesSubclassProxyFallback(target, Map.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "size") return target$1.size;
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "set" || key === "delete" || key === "clear") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "get") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => {
-					const resolved = resolveProtectedMapLookup(target$1, lookup);
-					return resolved.found ? protectAnnotationValue(resolved.value, context) : void 0;
-				});
-				if (key === "has") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => resolveProtectedMapLookup(target$1, lookup).found);
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value, mapKey) => {
-					callback.call(thisArg, protectAnnotationValue(value, context), protectAnnotationValue(mapKey, context), view$1);
-				}));
-				if (key === "keys") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.keys()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "values") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "entries" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const [entryKey, entryValue] of target$1.entries()) yield [protectAnnotationValue(entryKey, context), protectAnnotationValue(entryValue, context)];
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Map.prototype);
+	const entries = [...target.entries()].map(([entryKey, entryValue]) => [normalizeProtectedCollectionItem(entryKey, context), normalizeProtectedCollectionItem(entryValue, context)]);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = /* @__PURE__ */ new Map();
-	for (const [entryKey, entryValue] of target.entries()) cloned.set(normalizeProtectedCollectionItem(entryKey, context), normalizeProtectedCollectionItem(entryValue, context));
+	const cloned = syncPrototype ? new Map(entries) : tryCloneMapSubclass(target, entries) ?? new Map(entries);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "size") return clonedTarget.size;
@@ -297,57 +337,15 @@ function createProtectedMapView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, mapMutationMethodKeys);
 	return view;
 }
 function createProtectedSetView(target, context) {
-	if (usesSubclassProxyFallback(target, Set.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "size") return target$1.size;
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "add" || key === "delete" || key === "clear") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "has") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => hasProtectedSetLookup(target$1, lookup));
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value) => {
-					const protectedValue = protectAnnotationValue(value, context);
-					callback.call(thisArg, protectedValue, protectedValue, view$1);
-				}));
-				if (key === "keys" || key === "values" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "entries") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) {
-						const protectedValue = protectAnnotationValue(value, context);
-						yield [protectedValue, protectedValue];
-					}
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Set.prototype);
+	const values = [...target.values()].map((value) => normalizeProtectedCollectionItem(value, context));
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = /* @__PURE__ */ new Set();
-	for (const value of target.values()) cloned.add(normalizeProtectedCollectionItem(value, context));
+	const cloned = syncPrototype ? new Set(values) : tryCloneSetSubclass(target, values) ?? new Set(values);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "size") return clonedTarget.size;
@@ -388,40 +386,14 @@ function createProtectedSetView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, setMutationMethodKeys);
 	return view;
 }
 function createProtectedDateView(target, context) {
-	if (usesSubclassProxyFallback(target, Date.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (typeof key === "string" && key.startsWith("set")) return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Date.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new Date(target.getTime());
+	const cloned = syncPrototype ? new Date(target.getTime()) : tryCloneDateSubclass(target) ?? new Date(target.getTime());
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			const value = Reflect.get(clonedTarget, key, clonedTarget);
@@ -446,12 +418,14 @@ function createProtectedDateView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, dateMutationMethodKeys);
 	return view;
 }
 function createProtectedRegExpView(target, context) {
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, RegExp.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new RegExp(target);
+	const cloned = syncPrototype ? new RegExp(target) : tryCloneRegExpSubclass(target) ?? new RegExp(target);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "compile") return cacheProtectedMethod(methodCache, key, () => (..._args) => throwReadonlyAnnotationMutation());
@@ -479,51 +453,13 @@ function createProtectedRegExpView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyRegExpMetadata(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyRegExpMetadata(target, cloned, (value) => protectAnnotationValue(value, context), syncPrototype);
 	return view;
 }
 function createProtectedURLSearchParamsView(target, context) {
-	if (usesSubclassProxyFallback(target, URLSearchParams.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "append" || key === "delete" || key === "set" || key === "sort") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value, name) => {
-					callback.call(thisArg, value, name, view$1);
-				}));
-				if (key === "keys" || key === "values") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					const iterator = key === "keys" ? target$1.keys() : target$1.values();
-					for (const value of iterator) yield value;
-				});
-				if (key === "entries" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const entry of target$1.entries()) yield entry;
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, URLSearchParams.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new URLSearchParams(target);
+	const cloned = syncPrototype ? new URLSearchParams(target) : tryCloneURLSearchParamsSubclass(target) ?? new URLSearchParams(target);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "append" || key === "delete" || key === "set" || key === "sort") return cacheProtectedMethod(methodCache, key, () => (..._args) => throwReadonlyAnnotationMutation());
@@ -559,40 +495,13 @@ function createProtectedURLSearchParamsView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, urlSearchParamsMutationMethodKeys);
 	return view;
 }
 function createProtectedURLView(target, context) {
-	if (usesSubclassProxyFallback(target, URL.prototype)) {
-		const methodCache = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "valueOf") return cacheProtectedMethod(methodCache, key, () => () => view$1);
-				if (key === "searchParams") return protectAnnotationValue(target$1.searchParams, context);
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
-	const cloned = new URL(target.href);
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, URL.prototype);
+	const cloned = syncPrototype ? new URL(target.href) : tryCloneURLSubclass(target) ?? new URL(target.href);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "valueOf") return () => view;
@@ -618,7 +527,8 @@ function createProtectedURLView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyURLGuards(cloned, context);
 	return view;
 }
 function protectAnnotationValue(value, context) {

package/dist/annotations.js

@@ -86,9 +86,9 @@ function defineProtectedDataProperty(context, target, key, descriptor) {
 		set: () => throwReadonlyAnnotationMutation()
 	});
 }
-function copyOwnProperties(source, target, transformValue, excludedKeys) {
+function copyOwnProperties(source, target, transformValue, excludedKeys, syncPrototype = true) {
 	const sourcePrototype = Object.getPrototypeOf(source);
-	if (Object.getPrototypeOf(target) !== sourcePrototype) Object.setPrototypeOf(target, sourcePrototype);
+	if (syncPrototype && Object.getPrototypeOf(target) !== sourcePrototype) Object.setPrototypeOf(target, sourcePrototype);
 	for (const key of Reflect.ownKeys(source)) {
 		if (excludedKeys?.has(key) === true) continue;
 		const descriptor = Object.getOwnPropertyDescriptor(source, key);
@@ -106,60 +106,146 @@ function copyOwnProperties(source, target, transformValue, excludedKeys) {
 function normalizeProtectedCollectionItem(value, context) {
 	return context.rewrapProtectedViews && isProtectedAnnotationView(value) ? unwrapProtectedAnnotationTarget(value) : value;
 }
-function getProtectedProxyFallbackValue(target, key, context) {
-	const ownDescriptor = Reflect.getOwnPropertyDescriptor(target, key);
-	if (ownDescriptor != null && "value" in ownDescriptor) {
-		if (ownDescriptor.configurable === false && ownDescriptor.writable === false) return ownDescriptor.value;
-		const value$1 = ownDescriptor.value;
-		return typeof value$1 === "function" ? value$1.bind(target) : protectAnnotationValue(value$1, context);
+function resolveCloneConstructor(source) {
+	const constructorValue = source.constructor;
+	if (typeof constructorValue !== "function") return void 0;
+	const species = Reflect.get(constructorValue, Symbol.species);
+	const cloneConstructor = species == null ? constructorValue : species;
+	return typeof cloneConstructor === "function" ? cloneConstructor : void 0;
+}
+function hasBuiltInSubclassPrototype(target, basePrototype) {
+	return Object.getPrototypeOf(target) !== basePrototype;
+}
+function tryCloneMapSubclass(source, entries) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(entries);
+		return cloned instanceof Map ? cloned : void 0;
+	} catch {
+		return void 0;
 	}
-	const value = Reflect.get(target, key, target);
-	return typeof value === "function" ? value.bind(target) : protectAnnotationValue(value, context);
 }
-function getProtectedProxyOwnPropertyDescriptor(target, key, context) {
-	const descriptor = Reflect.getOwnPropertyDescriptor(target, key);
-	if (descriptor == null || !("value" in descriptor)) return descriptor;
-	if (descriptor.configurable === false && descriptor.writable === false) return descriptor;
-	const value = protectAnnotationValue(descriptor.value, context);
-	return value === descriptor.value ? descriptor : {
-		...descriptor,
-		value
-	};
+function tryCloneSetSubclass(source, values) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(values);
+		return cloned instanceof Set ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function resolveProtectedMapLookup(target, lookup) {
-	if (target.has(lookup)) return {
-		found: true,
-		value: target.get(lookup)
-	};
-	const rawLookup = unwrapProtectedAnnotationTarget(lookup);
-	if (rawLookup !== lookup && target.has(rawLookup)) return {
-		found: true,
-		value: target.get(rawLookup)
-	};
-	for (const [entryKey, entryValue] of target.entries()) if (unwrapProtectedAnnotationTarget(entryKey) === rawLookup) return {
-		found: true,
-		value: entryValue
-	};
-	return { found: false };
+function tryCloneDateSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.getTime());
+		return cloned instanceof Date ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function hasProtectedSetLookup(target, lookup) {
-	if (target.has(lookup)) return true;
-	const rawLookup = unwrapProtectedAnnotationTarget(lookup);
-	if (rawLookup !== lookup && target.has(rawLookup)) return true;
-	for (const value of target.values()) if (unwrapProtectedAnnotationTarget(value) === rawLookup) return true;
-	return false;
+function tryCloneRegExpSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.source, source.flags);
+		return cloned instanceof RegExp ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
-function usesSubclassProxyFallback(target, basePrototype) {
-	return Object.getPrototypeOf(target) !== basePrototype;
+function tryCloneURLSearchParamsSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source);
+		return cloned instanceof URLSearchParams ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
+}
+function tryCloneURLSubclass(source) {
+	const cloneConstructor = resolveCloneConstructor(source);
+	if (cloneConstructor == null) return void 0;
+	try {
+		const cloned = new cloneConstructor(source.href);
+		return cloned instanceof URL ? cloned : void 0;
+	} catch {
+		return void 0;
+	}
 }
 const regExpExcludedKeys = new Set(["lastIndex"]);
-function copyRegExpMetadata(source, target, transformValue) {
-	copyOwnProperties(source, target, transformValue, regExpExcludedKeys);
+const mapMutationMethodKeys = [
+	"set",
+	"delete",
+	"clear"
+];
+const setMutationMethodKeys = [
+	"add",
+	"delete",
+	"clear"
+];
+const urlSearchParamsMutationMethodKeys = [
+	"append",
+	"delete",
+	"set",
+	"sort"
+];
+const urlMutationPropertyKeys = [
+	"hash",
+	"host",
+	"hostname",
+	"href",
+	"password",
+	"pathname",
+	"port",
+	"protocol",
+	"search",
+	"username"
+];
+const dateMutationMethodKeys = Object.getOwnPropertyNames(Date.prototype).filter((key) => key.startsWith("set"));
+function installReadonlyMutationMethodGuards(target, keys) {
+	for (const key of keys) {
+		const descriptor = Object.getOwnPropertyDescriptor(target, key);
+		if (descriptor?.configurable === false) continue;
+		Object.defineProperty(target, key, {
+			configurable: true,
+			enumerable: false,
+			writable: true,
+			value: (..._args) => throwReadonlyAnnotationMutation()
+		});
+	}
+}
+function installReadonlyURLGuards(target, context) {
+	const searchParams = target.searchParams;
+	const searchParamsDescriptor = Object.getOwnPropertyDescriptor(target, "searchParams");
+	if (searchParamsDescriptor?.configurable !== false) Object.defineProperty(target, "searchParams", {
+		configurable: true,
+		enumerable: false,
+		get: () => protectAnnotationValue(searchParams, context),
+		set: () => throwReadonlyAnnotationMutation()
+	});
+	for (const key of urlMutationPropertyKeys) {
+		const descriptor = Object.getOwnPropertyDescriptor(target, key);
+		if (descriptor?.configurable === false) continue;
+		Object.defineProperty(target, key, {
+			configurable: true,
+			enumerable: false,
+			get: () => Reflect.get(URL.prototype, key, target),
+			set: () => throwReadonlyAnnotationMutation()
+		});
+	}
+}
+function copyRegExpMetadata(source, target, transformValue, syncPrototype = true) {
+	copyOwnProperties(source, target, transformValue, regExpExcludedKeys, syncPrototype);
 	target.lastIndex = source.lastIndex;
 }
 function cloneRegExpShape(source) {
-	const cloned = new RegExp(source);
-	copyRegExpMetadata(source, cloned);
+	const syncPrototype = !hasBuiltInSubclassPrototype(source, RegExp.prototype);
+	const cloned = syncPrototype ? new RegExp(source) : tryCloneRegExpSubclass(source) ?? new RegExp(source);
+	copyRegExpMetadata(source, cloned, void 0, syncPrototype);
 	return cloned;
 }
 function createProtectedObjectView(target, context) {
@@ -203,56 +289,10 @@ function createProtectedObjectView(target, context) {
 	return Object.freeze(view);
 }
 function createProtectedMapView(target, context) {
-	if (usesSubclassProxyFallback(target, Map.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "size") return target$1.size;
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "set" || key === "delete" || key === "clear") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "get") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => {
-					const resolved = resolveProtectedMapLookup(target$1, lookup);
-					return resolved.found ? protectAnnotationValue(resolved.value, context) : void 0;
-				});
-				if (key === "has") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => resolveProtectedMapLookup(target$1, lookup).found);
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value, mapKey) => {
-					callback.call(thisArg, protectAnnotationValue(value, context), protectAnnotationValue(mapKey, context), view$1);
-				}));
-				if (key === "keys") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.keys()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "values") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "entries" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const [entryKey, entryValue] of target$1.entries()) yield [protectAnnotationValue(entryKey, context), protectAnnotationValue(entryValue, context)];
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Map.prototype);
+	const entries = [...target.entries()].map(([entryKey, entryValue]) => [normalizeProtectedCollectionItem(entryKey, context), normalizeProtectedCollectionItem(entryValue, context)]);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = /* @__PURE__ */ new Map();
-	for (const [entryKey, entryValue] of target.entries()) cloned.set(normalizeProtectedCollectionItem(entryKey, context), normalizeProtectedCollectionItem(entryValue, context));
+	const cloned = syncPrototype ? new Map(entries) : tryCloneMapSubclass(target, entries) ?? new Map(entries);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "size") return clonedTarget.size;
@@ -296,57 +336,15 @@ function createProtectedMapView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, mapMutationMethodKeys);
 	return view;
 }
 function createProtectedSetView(target, context) {
-	if (usesSubclassProxyFallback(target, Set.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "size") return target$1.size;
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "add" || key === "delete" || key === "clear") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "has") return cacheProtectedMethod(methodCache$1, key, () => (lookup) => hasProtectedSetLookup(target$1, lookup));
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value) => {
-					const protectedValue = protectAnnotationValue(value, context);
-					callback.call(thisArg, protectedValue, protectedValue, view$1);
-				}));
-				if (key === "keys" || key === "values" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) yield protectAnnotationValue(value, context);
-				});
-				if (key === "entries") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const value of target$1.values()) {
-						const protectedValue = protectAnnotationValue(value, context);
-						yield [protectedValue, protectedValue];
-					}
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Set.prototype);
+	const values = [...target.values()].map((value) => normalizeProtectedCollectionItem(value, context));
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = /* @__PURE__ */ new Set();
-	for (const value of target.values()) cloned.add(normalizeProtectedCollectionItem(value, context));
+	const cloned = syncPrototype ? new Set(values) : tryCloneSetSubclass(target, values) ?? new Set(values);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "size") return clonedTarget.size;
@@ -387,40 +385,14 @@ function createProtectedSetView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, setMutationMethodKeys);
 	return view;
 }
 function createProtectedDateView(target, context) {
-	if (usesSubclassProxyFallback(target, Date.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (typeof key === "string" && key.startsWith("set")) return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, Date.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new Date(target.getTime());
+	const cloned = syncPrototype ? new Date(target.getTime()) : tryCloneDateSubclass(target) ?? new Date(target.getTime());
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			const value = Reflect.get(clonedTarget, key, clonedTarget);
@@ -445,12 +417,14 @@ function createProtectedDateView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, dateMutationMethodKeys);
 	return view;
 }
 function createProtectedRegExpView(target, context) {
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, RegExp.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new RegExp(target);
+	const cloned = syncPrototype ? new RegExp(target) : tryCloneRegExpSubclass(target) ?? new RegExp(target);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "compile") return cacheProtectedMethod(methodCache, key, () => (..._args) => throwReadonlyAnnotationMutation());
@@ -478,51 +452,13 @@ function createProtectedRegExpView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyRegExpMetadata(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyRegExpMetadata(target, cloned, (value) => protectAnnotationValue(value, context), syncPrototype);
 	return view;
 }
 function createProtectedURLSearchParamsView(target, context) {
-	if (usesSubclassProxyFallback(target, URLSearchParams.prototype)) {
-		const methodCache$1 = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "append" || key === "delete" || key === "set" || key === "sort") return cacheProtectedMethod(methodCache$1, key, () => (..._args) => throwReadonlyAnnotationMutation());
-				if (key === "valueOf") return cacheProtectedMethod(methodCache$1, key, () => () => view$1);
-				if (key === "forEach") return cacheProtectedMethod(methodCache$1, key, () => (callback, thisArg) => target$1.forEach((value, name) => {
-					callback.call(thisArg, value, name, view$1);
-				}));
-				if (key === "keys" || key === "values") return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					const iterator = key === "keys" ? target$1.keys() : target$1.values();
-					for (const value of iterator) yield value;
-				});
-				if (key === "entries" || key === Symbol.iterator) return cacheProtectedMethod(methodCache$1, key, () => function* () {
-					for (const entry of target$1.entries()) yield entry;
-				});
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, URLSearchParams.prototype);
 	const methodCache = /* @__PURE__ */ new Map();
-	const cloned = new URLSearchParams(target);
+	const cloned = syncPrototype ? new URLSearchParams(target) : tryCloneURLSearchParamsSubclass(target) ?? new URLSearchParams(target);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "append" || key === "delete" || key === "set" || key === "sort") return cacheProtectedMethod(methodCache, key, () => (..._args) => throwReadonlyAnnotationMutation());
@@ -558,40 +494,13 @@ function createProtectedURLSearchParamsView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyMutationMethodGuards(cloned, urlSearchParamsMutationMethodKeys);
 	return view;
 }
 function createProtectedURLView(target, context) {
-	if (usesSubclassProxyFallback(target, URL.prototype)) {
-		const methodCache = /* @__PURE__ */ new Map();
-		const view$1 = new Proxy(target, {
-			get(target$1, key) {
-				if (key === "valueOf") return cacheProtectedMethod(methodCache, key, () => () => view$1);
-				if (key === "searchParams") return protectAnnotationValue(target$1.searchParams, context);
-				return getProtectedProxyFallbackValue(target$1, key, context);
-			},
-			getOwnPropertyDescriptor(target$1, key) {
-				return getProtectedProxyOwnPropertyDescriptor(target$1, key, context);
-			},
-			set() {
-				throwReadonlyAnnotationMutation();
-			},
-			defineProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			deleteProperty() {
-				throwReadonlyAnnotationMutation();
-			},
-			setPrototypeOf() {
-				throwReadonlyAnnotationMutation();
-			},
-			preventExtensions() {
-				throwReadonlyAnnotationMutation();
-			}
-		});
-		return registerProtectedAnnotationView(context, target, view$1);
-	}
-	const cloned = new URL(target.href);
+	const syncPrototype = !hasBuiltInSubclassPrototype(target, URL.prototype);
+	const cloned = syncPrototype ? new URL(target.href) : tryCloneURLSubclass(target) ?? new URL(target.href);
 	const view = new Proxy(cloned, {
 		get(clonedTarget, key) {
 			if (key === "valueOf") return () => view;
@@ -617,7 +526,8 @@ function createProtectedURLView(target, context) {
 	});
 	registerProtectedAnnotationView(context, target, view);
 	cacheProtectedAnnotationViewAlias(context, cloned, view);
-	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context));
+	copyOwnProperties(target, cloned, (value) => protectAnnotationValue(value, context), void 0, syncPrototype);
+	installReadonlyURLGuards(cloned, context);
 	return view;
 }
 function protectAnnotationValue(value, context) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1866+7ab2516f",
+  "version": "1.0.0-dev.1868+54bdb27a",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",