@optique/core 1.0.0-dev.1884 → 1.0.0-dev.1886

package/dist/annotations.d.cts

@@ -50,32 +50,6 @@ declare const annotationWrapperKey: unique symbol;
  * @since 0.10.0
  */
 type Annotations = Record<symbol, unknown>;
-/**
- * Read-only annotation view returned from parser state.
- *
- * Top-level annotation records are exposed as read-only objects, and supported
- * nested container values (plain objects, arrays, `Map`, `Set`, `Date`,
- * `RegExp`, `URL`, and `URLSearchParams`) are surfaced through protected
- * views that throw on ordinary mutation attempts.
- *
- * Opaque live objects and functions remain reference-preserving.
- *
- * @since 1.0.0
- */
-type ReadonlyAnnotations = Readonly<Annotations>;
-type AnnotationInput = Annotations | ReadonlyAnnotations;
-/**
- * Normalizes annotation input for a fresh parse run.
- *
- * When callers feed a protected annotation view returned by `getAnnotations()`
- * back into a new parse entrypoint, Optique unwraps it to the caller-owned
- * record first so the new run gets its own protected views.
- *
- * @param annotations The caller-supplied annotations input.
- * @returns The raw annotation record to inject for the new run.
- * @internal
- */
-declare function normalizeRunAnnotationInput(annotations: AnnotationInput): AnnotationInput;
 /**
  * Options for parse functions.
  * @since 0.10.0
@@ -84,21 +58,15 @@ interface ParseOptions {
   /**
    * Annotations to attach to the parsing session.
    * Parsers can access these annotations via getAnnotations(state).
-   *
-   * Optique treats these values as immutable input and exposes them back to
-   * parsers only through protected read-only views.
    */
-  readonly annotations?: Annotations | ReadonlyAnnotations;
+  annotations?: Annotations;
 }
 /**
  * Extracts annotations from parser state.
  *
  * @param state Parser state that may contain annotations
- * @returns Read-only annotations view or undefined if no annotations are
- *          present
+ * @returns Annotations object or undefined if no annotations are present
  * @since 0.10.0
- * @since 1.0.0 Returns protected read-only annotation views instead of
- *              caller-owned objects.
  *
  * @example
  * ```typescript
@@ -106,7 +74,7 @@ interface ParseOptions {
  * const myData = annotations?.[myDataKey];
  * ```
  */
-declare function getAnnotations(state: unknown): ReadonlyAnnotations | undefined;
+declare function getAnnotations(state: unknown): Annotations | undefined;
 /**
  * Reattaches annotations to a freshly created array state.
  *
@@ -144,7 +112,7 @@ declare function inheritAnnotations<T>(source: unknown, target: T): T;
  * @returns `true` when the record has at least one own symbol key.
  * @internal
  */
-declare function hasMeaningfulAnnotations(annotations: AnnotationInput | null | undefined): annotations is AnnotationInput;
+declare function hasMeaningfulAnnotations(annotations: Annotations | null | undefined): annotations is Annotations;
 /**
  * Injects annotations into parser state while preserving state shape.
  *
@@ -161,19 +129,7 @@ declare function hasMeaningfulAnnotations(annotations: AnnotationInput | null |
  * @returns Annotated state.
  * @internal
  */
-declare function injectAnnotations<TState>(state: TState, annotations: AnnotationInput): TState;
-/**
- * Injects annotations for a fresh parse run.
- *
- * This path re-wraps protected views from previous runs so stateful container
- * internals remain isolated across parse entrypoints.
- *
- * @param state The parser state to annotate.
- * @param annotations The annotations to inject.
- * @returns Annotated state for the fresh run.
- * @internal
- */
-declare function injectFreshRunAnnotations<TState>(state: TState, annotations: AnnotationInput): TState;
+declare function injectAnnotations<TState>(state: TState, annotations: Annotations): TState;
 /**
  * Unwraps a primitive-state annotation wrapper injected by Optique internals.
  *
@@ -193,4 +149,4 @@ declare function unwrapInjectedAnnotationWrapper<T>(value: T): T;
  */
 declare function isInjectedAnnotationWrapper(value: unknown): boolean;
 //#endregion
-export { Annotations, ParseOptions, ReadonlyAnnotations, annotateFreshArray, annotationKey, annotationStateValueKey, annotationWrapperKey, firstPassAnnotationKey, getAnnotations, hasMeaningfulAnnotations, inheritAnnotations, injectAnnotations, injectFreshRunAnnotations, isInjectedAnnotationWrapper, normalizeRunAnnotationInput, unwrapInjectedAnnotationWrapper };
+export { Annotations, ParseOptions, annotateFreshArray, annotationKey, annotationStateValueKey, annotationWrapperKey, firstPassAnnotationKey, getAnnotations, hasMeaningfulAnnotations, inheritAnnotations, injectAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotationWrapper };

package/dist/annotations.d.ts

@@ -50,32 +50,6 @@ declare const annotationWrapperKey: unique symbol;
  * @since 0.10.0
  */
 type Annotations = Record<symbol, unknown>;
-/**
- * Read-only annotation view returned from parser state.
- *
- * Top-level annotation records are exposed as read-only objects, and supported
- * nested container values (plain objects, arrays, `Map`, `Set`, `Date`,
- * `RegExp`, `URL`, and `URLSearchParams`) are surfaced through protected
- * views that throw on ordinary mutation attempts.
- *
- * Opaque live objects and functions remain reference-preserving.
- *
- * @since 1.0.0
- */
-type ReadonlyAnnotations = Readonly<Annotations>;
-type AnnotationInput = Annotations | ReadonlyAnnotations;
-/**
- * Normalizes annotation input for a fresh parse run.
- *
- * When callers feed a protected annotation view returned by `getAnnotations()`
- * back into a new parse entrypoint, Optique unwraps it to the caller-owned
- * record first so the new run gets its own protected views.
- *
- * @param annotations The caller-supplied annotations input.
- * @returns The raw annotation record to inject for the new run.
- * @internal
- */
-declare function normalizeRunAnnotationInput(annotations: AnnotationInput): AnnotationInput;
 /**
  * Options for parse functions.
  * @since 0.10.0
@@ -84,21 +58,15 @@ interface ParseOptions {
   /**
    * Annotations to attach to the parsing session.
    * Parsers can access these annotations via getAnnotations(state).
-   *
-   * Optique treats these values as immutable input and exposes them back to
-   * parsers only through protected read-only views.
    */
-  readonly annotations?: Annotations | ReadonlyAnnotations;
+  annotations?: Annotations;
 }
 /**
  * Extracts annotations from parser state.
  *
  * @param state Parser state that may contain annotations
- * @returns Read-only annotations view or undefined if no annotations are
- *          present
+ * @returns Annotations object or undefined if no annotations are present
  * @since 0.10.0
- * @since 1.0.0 Returns protected read-only annotation views instead of
- *              caller-owned objects.
  *
  * @example
  * ```typescript
@@ -106,7 +74,7 @@ interface ParseOptions {
  * const myData = annotations?.[myDataKey];
  * ```
  */
-declare function getAnnotations(state: unknown): ReadonlyAnnotations | undefined;
+declare function getAnnotations(state: unknown): Annotations | undefined;
 /**
  * Reattaches annotations to a freshly created array state.
  *
@@ -144,7 +112,7 @@ declare function inheritAnnotations<T>(source: unknown, target: T): T;
  * @returns `true` when the record has at least one own symbol key.
  * @internal
  */
-declare function hasMeaningfulAnnotations(annotations: AnnotationInput | null | undefined): annotations is AnnotationInput;
+declare function hasMeaningfulAnnotations(annotations: Annotations | null | undefined): annotations is Annotations;
 /**
  * Injects annotations into parser state while preserving state shape.
  *
@@ -161,19 +129,7 @@ declare function hasMeaningfulAnnotations(annotations: AnnotationInput | null |
  * @returns Annotated state.
  * @internal
  */
-declare function injectAnnotations<TState>(state: TState, annotations: AnnotationInput): TState;
-/**
- * Injects annotations for a fresh parse run.
- *
- * This path re-wraps protected views from previous runs so stateful container
- * internals remain isolated across parse entrypoints.
- *
- * @param state The parser state to annotate.
- * @param annotations The annotations to inject.
- * @returns Annotated state for the fresh run.
- * @internal
- */
-declare function injectFreshRunAnnotations<TState>(state: TState, annotations: AnnotationInput): TState;
+declare function injectAnnotations<TState>(state: TState, annotations: Annotations): TState;
 /**
  * Unwraps a primitive-state annotation wrapper injected by Optique internals.
  *
@@ -193,4 +149,4 @@ declare function unwrapInjectedAnnotationWrapper<T>(value: T): T;
  */
 declare function isInjectedAnnotationWrapper(value: unknown): boolean;
 //#endregion
-export { Annotations, ParseOptions, ReadonlyAnnotations, annotateFreshArray, annotationKey, annotationStateValueKey, annotationWrapperKey, firstPassAnnotationKey, getAnnotations, hasMeaningfulAnnotations, inheritAnnotations, injectAnnotations, injectFreshRunAnnotations, isInjectedAnnotationWrapper, normalizeRunAnnotationInput, unwrapInjectedAnnotationWrapper };
+export { Annotations, ParseOptions, annotateFreshArray, annotationKey, annotationStateValueKey, annotationWrapperKey, firstPassAnnotationKey, getAnnotations, hasMeaningfulAnnotations, inheritAnnotations, injectAnnotations, isInjectedAnnotationWrapper, unwrapInjectedAnnotationWrapper };