@optique/core 1.0.0-dev.1786 → 1.0.0-dev.1787

package/dist/annotation-state.cjs

@@ -0,0 +1,100 @@
+const require_annotations = require('./annotations.cjs');
+const require_parser = require('./parser.cjs');
+
+//#region src/annotation-state.ts
+/**
+* Shared targets for annotation-view proxies.
+*
+* @internal
+*/
+const annotationViewTargets = /* @__PURE__ */ new WeakMap();
+/**
+* Unwraps an annotation-view proxy to its original target object.
+*
+* @internal
+*/
+function unwrapAnnotationView(value) {
+	if (value == null || typeof value !== "object") return value;
+	return annotationViewTargets.get(value) ?? value;
+}
+/**
+* Creates a proxy that exposes annotations without changing the target shape.
+*
+* @internal
+*/
+function withAnnotationView(state, annotations) {
+	const target = unwrapAnnotationView(state);
+	const view = new Proxy(target, {
+		get(target$1, key) {
+			if (key === require_annotations.annotationKey) return annotations;
+			const value = Reflect.get(target$1, key, target$1);
+			return typeof value === "function" ? value.bind(target$1) : value;
+		},
+		has(target$1, key) {
+			return key === require_annotations.annotationKey || Reflect.has(target$1, key);
+		}
+	});
+	annotationViewTargets.set(view, target);
+	return view;
+}
+/**
+* Removes Optique's internal primitive-state annotation wrapper when present.
+*
+* @internal
+*/
+function normalizeInjectedAnnotationState(state) {
+	return require_annotations.unwrapInjectedAnnotationWrapper(state);
+}
+/**
+* Returns whether a state is still the annotation-wrapped initial sentinel.
+*
+* @internal
+*/
+function isAnnotationWrappedInitialState(state) {
+	return normalizeInjectedAnnotationState(state) === void 0;
+}
+/**
+* Propagates parent annotations into a child parse state when the child parser
+* explicitly opts into parent annotation inheritance.
+*
+* @internal
+*/
+function getWrappedChildParseState(parentState, childState, parser) {
+	const annotations = require_annotations.getAnnotations(parentState);
+	const shouldInheritAnnotations = Reflect.get(parser, require_parser.inheritParentAnnotationsKey) === true;
+	if (childState == null) {
+		if (annotations !== void 0 && shouldInheritAnnotations) return require_annotations.injectAnnotations({}, annotations);
+		return childState;
+	}
+	if (annotations === void 0 || typeof childState !== "object" || require_annotations.getAnnotations(childState) === annotations || !shouldInheritAnnotations) return childState;
+	const injectedState = require_annotations.injectAnnotations(childState, annotations);
+	return require_annotations.getAnnotations(injectedState) === annotations ? injectedState : childState;
+}
+/**
+* Propagates parent annotations into a child state while preserving the child
+* state's shape for parsers that do not opt into full wrapper injection.
+*
+* @internal
+*/
+function getWrappedChildState(parentState, childState, parser) {
+	const annotations = require_annotations.getAnnotations(parentState);
+	const shouldInheritAnnotations = Reflect.get(parser, require_parser.inheritParentAnnotationsKey) === true;
+	if (childState == null) {
+		if (annotations !== void 0 && shouldInheritAnnotations) return require_annotations.injectAnnotations({}, annotations);
+		return childState;
+	}
+	if (annotations === void 0 || typeof childState !== "object" || require_annotations.getAnnotations(childState) === annotations) return childState;
+	if (shouldInheritAnnotations) {
+		const injectedState = require_annotations.injectAnnotations(childState, annotations);
+		if (require_annotations.getAnnotations(injectedState) === annotations) return injectedState;
+	}
+	return withAnnotationView(childState, annotations);
+}
+
+//#endregion
+exports.annotationViewTargets = annotationViewTargets;
+exports.getWrappedChildParseState = getWrappedChildParseState;
+exports.getWrappedChildState = getWrappedChildState;
+exports.isAnnotationWrappedInitialState = isAnnotationWrappedInitialState;
+exports.normalizeInjectedAnnotationState = normalizeInjectedAnnotationState;
+exports.unwrapAnnotationView = unwrapAnnotationView;

package/dist/annotation-state.js

@@ -0,0 +1,95 @@
+import { annotationKey, getAnnotations, injectAnnotations, unwrapInjectedAnnotationWrapper } from "./annotations.js";
+import { inheritParentAnnotationsKey } from "./parser.js";
+
+//#region src/annotation-state.ts
+/**
+* Shared targets for annotation-view proxies.
+*
+* @internal
+*/
+const annotationViewTargets = /* @__PURE__ */ new WeakMap();
+/**
+* Unwraps an annotation-view proxy to its original target object.
+*
+* @internal
+*/
+function unwrapAnnotationView(value) {
+	if (value == null || typeof value !== "object") return value;
+	return annotationViewTargets.get(value) ?? value;
+}
+/**
+* Creates a proxy that exposes annotations without changing the target shape.
+*
+* @internal
+*/
+function withAnnotationView(state, annotations) {
+	const target = unwrapAnnotationView(state);
+	const view = new Proxy(target, {
+		get(target$1, key) {
+			if (key === annotationKey) return annotations;
+			const value = Reflect.get(target$1, key, target$1);
+			return typeof value === "function" ? value.bind(target$1) : value;
+		},
+		has(target$1, key) {
+			return key === annotationKey || Reflect.has(target$1, key);
+		}
+	});
+	annotationViewTargets.set(view, target);
+	return view;
+}
+/**
+* Removes Optique's internal primitive-state annotation wrapper when present.
+*
+* @internal
+*/
+function normalizeInjectedAnnotationState(state) {
+	return unwrapInjectedAnnotationWrapper(state);
+}
+/**
+* Returns whether a state is still the annotation-wrapped initial sentinel.
+*
+* @internal
+*/
+function isAnnotationWrappedInitialState(state) {
+	return normalizeInjectedAnnotationState(state) === void 0;
+}
+/**
+* Propagates parent annotations into a child parse state when the child parser
+* explicitly opts into parent annotation inheritance.
+*
+* @internal
+*/
+function getWrappedChildParseState(parentState, childState, parser) {
+	const annotations = getAnnotations(parentState);
+	const shouldInheritAnnotations = Reflect.get(parser, inheritParentAnnotationsKey) === true;
+	if (childState == null) {
+		if (annotations !== void 0 && shouldInheritAnnotations) return injectAnnotations({}, annotations);
+		return childState;
+	}
+	if (annotations === void 0 || typeof childState !== "object" || getAnnotations(childState) === annotations || !shouldInheritAnnotations) return childState;
+	const injectedState = injectAnnotations(childState, annotations);
+	return getAnnotations(injectedState) === annotations ? injectedState : childState;
+}
+/**
+* Propagates parent annotations into a child state while preserving the child
+* state's shape for parsers that do not opt into full wrapper injection.
+*
+* @internal
+*/
+function getWrappedChildState(parentState, childState, parser) {
+	const annotations = getAnnotations(parentState);
+	const shouldInheritAnnotations = Reflect.get(parser, inheritParentAnnotationsKey) === true;
+	if (childState == null) {
+		if (annotations !== void 0 && shouldInheritAnnotations) return injectAnnotations({}, annotations);
+		return childState;
+	}
+	if (annotations === void 0 || typeof childState !== "object" || getAnnotations(childState) === annotations) return childState;
+	if (shouldInheritAnnotations) {
+		const injectedState = injectAnnotations(childState, annotations);
+		if (getAnnotations(injectedState) === annotations) return injectedState;
+	}
+	return withAnnotationView(childState, annotations);
+}
+
+//#endregion
+export { annotationViewTargets, getWrappedChildParseState, getWrappedChildState, isAnnotationWrappedInitialState, normalizeInjectedAnnotationState, unwrapAnnotationView };