seroval 1.0.7 → 1.1.0

package/dist/esm/development/index.mjs

@@ -863,6 +863,14 @@ var SerovalUnknownTypedArrayError = class extends Error {
   }
 };
 
+// src/core/opaque-reference.ts
+var OpaqueReference = class {
+  constructor(value, replacement) {
+    this.value = value;
+    this.replacement = replacement;
+  }
+};
+
 // src/core/special-reference.ts
 var ITERATOR = {};
 var ASYNC_ITERATOR = {};
@@ -1503,6 +1511,7 @@ var BaseAsyncParserContext = class extends BaseParserContext {
       })
     );
   }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>
   async parseObject(id, current) {
     if (Array.isArray(current)) {
       return this.parseArray(id, current);
@@ -1510,11 +1519,16 @@ var BaseAsyncParserContext = class extends BaseParserContext {
     if (isStream(current)) {
       return this.parseStream(id, current);
     }
+    const currentClass = current.constructor;
+    if (currentClass === OpaqueReference) {
+      return this.parse(
+        current.replacement
+      );
+    }
     const parsed = await this.parsePlugin(id, current);
     if (parsed) {
       return parsed;
     }
-    const currentClass = current.constructor;
     switch (currentClass) {
       case Object:
         return this.parsePlainObject(
@@ -1626,11 +1640,11 @@ var BaseAsyncParserContext = class extends BaseParserContext {
   }
 };
 
-// src/core/tree/async.ts
-var AsyncParserContext = class extends BaseAsyncParserContext {
+// src/core/cross/async.ts
+var CrossAsyncParserContext = class extends BaseAsyncParserContext {
   constructor() {
     super(...arguments);
-    this.mode = "vanilla";
+    this.mode = "cross";
   }
 };
 
@@ -1970,15 +1984,14 @@ var BaseDeserializerContext = class {
   }
 };
 
-// src/core/tree/deserializer.ts
-var VanillaDeserializerContext = class extends BaseDeserializerContext {
-  constructor(options) {
-    super(options);
-    this.mode = "vanilla";
-    this.marked = new Set(options.markedRefs);
+// src/core/cross/deserializer.ts
+var CrossDeserializerContext = class extends BaseDeserializerContext {
+  constructor() {
+    super(...arguments);
+    this.mode = "cross";
   }
   assignIndexedValue(index, value) {
-    if (this.marked.has(index)) {
+    if (!this.refs.has(index)) {
       this.refs.set(index, value);
     }
     return value;
@@ -2810,89 +2823,34 @@ var BaseSerializerContext = class {
   }
 };
 
-// src/core/utils/get-identifier.ts
-var REF_START_CHARS = "hjkmoquxzABCDEFGHIJKLNPQRTUVWXYZ$_";
-var REF_START_CHARS_LEN = REF_START_CHARS.length;
-var REF_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789$_";
-var REF_CHARS_LEN = REF_CHARS.length;
-function getIdentifier(index) {
-  let mod = index % REF_START_CHARS_LEN;
-  let ref = REF_START_CHARS[mod];
-  index = (index - mod) / REF_START_CHARS_LEN;
-  while (index > 0) {
-    mod = index % REF_CHARS_LEN;
-    ref += REF_CHARS[mod];
-    index = (index - mod) / REF_CHARS_LEN;
-  }
-  return ref;
-}
-
-// src/core/tree/serializer.ts
-var VanillaSerializerContext = class extends BaseSerializerContext {
-  constructor() {
-    super(...arguments);
-    this.mode = "vanilla";
-    /**
-     * Map tree refs to actual refs
-     * @private
-     */
-    this.valid = /* @__PURE__ */ new Map();
-    /**
-     * Variables
-     * @private
-     */
-    this.vars = [];
+// src/core/cross/serializer.ts
+var CrossSerializerContext = class extends BaseSerializerContext {
+  constructor(options) {
+    super(options);
+    this.mode = "cross";
+    this.scopeId = options.scopeId;
   }
-  /**
-   * Creates the reference param (identifier) from the given reference ID
-   * Calling this function means the value has been referenced somewhere
-   */
-  getRefParam(index) {
-    let actualIndex = this.valid.get(index);
-    if (actualIndex == null) {
-      actualIndex = this.valid.size;
-      this.valid.set(index, actualIndex);
-    }
-    let identifier = this.vars[actualIndex];
-    if (identifier == null) {
-      identifier = getIdentifier(actualIndex);
-      this.vars[actualIndex] = identifier;
-    }
-    return identifier;
+  getRefParam(id) {
+    return GLOBAL_CONTEXT_REFERENCES + "[" + id + "]";
   }
   assignIndexedValue(index, value) {
-    if (this.isMarked(index)) {
-      return this.getRefParam(index) + "=" + value;
-    }
-    return value;
-  }
-  serializePromiseConstructor(node) {
-    throw new SerovalUnsupportedNodeError(node);
-  }
-  serializePromiseResolve(node) {
-    throw new SerovalUnsupportedNodeError(node);
-  }
-  serializePromiseReject(node) {
-    throw new SerovalUnsupportedNodeError(node);
+    return this.getRefParam(index) + "=" + value;
   }
   serializeTop(tree) {
     const result = this.serialize(tree);
-    if (tree.i != null && this.vars.length) {
-      const patches = this.resolvePatches();
-      let body = result;
-      if (patches) {
-        const index = this.getRefParam(tree.i);
-        body = result + "," + patches + index;
-        if (!result.startsWith(index + "=")) {
-          body = index + "=" + body;
-        }
-      }
-      return "(" + this.createFunction(this.vars, "(" + body + ")") + ")()";
+    const id = tree.i;
+    if (id == null) {
+      return result;
     }
-    if (tree.t === 10 /* Object */) {
-      return "(" + result + ")";
+    const patches = this.resolvePatches();
+    const ref = this.getRefParam(id);
+    const params = this.scopeId == null ? "" : GLOBAL_CONTEXT_REFERENCES;
+    const body = patches ? result + "," + patches + ref : result;
+    if (params === "") {
+      return patches ? "(" + body + ")" : body;
     }
-    return result;
+    const args = this.scopeId == null ? "()" : "(" + GLOBAL_CONTEXT_REFERENCES + '["' + serializeString(this.scopeId) + '"])';
+    return "(" + this.createFunction([params], body) + ")" + args;
   }
 };
 
@@ -3036,6 +2994,7 @@ var BaseSyncParserContext = class extends BaseParserContext {
   parsePromise(id, _current) {
     return this.createPromiseConstructorNode(id);
   }
+  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: <explanation>
   parseObject(id, current) {
     if (Array.isArray(current)) {
       return this.parseArray(id, current);
@@ -3043,11 +3002,16 @@ var BaseSyncParserContext = class extends BaseParserContext {
     if (isStream(current)) {
       return this.parseStream(id, current);
     }
+    const currentClass = current.constructor;
+    if (currentClass === OpaqueReference) {
+      return this.parse(
+        current.replacement
+      );
+    }
     const parsed = this.parsePlugin(id, current);
     if (parsed) {
       return parsed;
     }
-    const currentClass = current.constructor;
     switch (currentClass) {
       case Object:
         return this.parsePlainObject(
@@ -3159,141 +3123,6 @@ var BaseSyncParserContext = class extends BaseParserContext {
   }
 };
 
-// src/core/tree/sync.ts
-var SyncParserContext = class extends BaseSyncParserContext {
-  constructor() {
-    super(...arguments);
-    this.mode = "vanilla";
-  }
-};
-
-// src/core/tree/index.ts
-function serialize(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new SyncParserContext({
-    plugins,
-    disabledFeatures: options.disabledFeatures
-  });
-  const tree = ctx.parse(source);
-  const serial = new VanillaSerializerContext({
-    plugins,
-    features: ctx.features,
-    markedRefs: ctx.marked
-  });
-  return serial.serializeTop(tree);
-}
-async function serializeAsync(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new AsyncParserContext({
-    plugins,
-    disabledFeatures: options.disabledFeatures
-  });
-  const tree = await ctx.parse(source);
-  const serial = new VanillaSerializerContext({
-    plugins,
-    features: ctx.features,
-    markedRefs: ctx.marked
-  });
-  return serial.serializeTop(tree);
-}
-function deserialize(source) {
-  return (0, eval)(source);
-}
-function toJSON(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new SyncParserContext({
-    plugins,
-    disabledFeatures: options.disabledFeatures
-  });
-  return {
-    t: ctx.parse(source),
-    f: ctx.features,
-    m: Array.from(ctx.marked)
-  };
-}
-async function toJSONAsync(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new AsyncParserContext({
-    plugins,
-    disabledFeatures: options.disabledFeatures
-  });
-  return {
-    t: await ctx.parse(source),
-    f: ctx.features,
-    m: Array.from(ctx.marked)
-  };
-}
-function compileJSON(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new VanillaSerializerContext({
-    plugins,
-    features: source.f,
-    markedRefs: source.m
-  });
-  return ctx.serializeTop(source.t);
-}
-function fromJSON(source, options = {}) {
-  const plugins = resolvePlugins(options.plugins);
-  const ctx = new VanillaDeserializerContext({
-    plugins,
-    markedRefs: source.m
-  });
-  return ctx.deserialize(source.t);
-}
-
-// src/core/cross/async.ts
-var CrossAsyncParserContext = class extends BaseAsyncParserContext {
-  constructor() {
-    super(...arguments);
-    this.mode = "cross";
-  }
-};
-
-// src/core/cross/deserializer.ts
-var CrossDeserializerContext = class extends BaseDeserializerContext {
-  constructor() {
-    super(...arguments);
-    this.mode = "cross";
-  }
-  assignIndexedValue(index, value) {
-    if (!this.refs.has(index)) {
-      this.refs.set(index, value);
-    }
-    return value;
-  }
-};
-
-// src/core/cross/serializer.ts
-var CrossSerializerContext = class extends BaseSerializerContext {
-  constructor(options) {
-    super(options);
-    this.mode = "cross";
-    this.scopeId = options.scopeId;
-  }
-  getRefParam(id) {
-    return GLOBAL_CONTEXT_REFERENCES + "[" + id + "]";
-  }
-  assignIndexedValue(index, value) {
-    return this.getRefParam(index) + "=" + value;
-  }
-  serializeTop(tree) {
-    const result = this.serialize(tree);
-    const id = tree.i;
-    if (id == null) {
-      return result;
-    }
-    const patches = this.resolvePatches();
-    const ref = this.getRefParam(id);
-    const params = this.scopeId == null ? "" : GLOBAL_CONTEXT_REFERENCES;
-    const body = patches ? result + "," + patches + ref : result;
-    if (params === "") {
-      return patches ? "(" + body + ")" : body;
-    }
-    const args = this.scopeId == null ? "()" : "(" + GLOBAL_CONTEXT_REFERENCES + '["' + serializeString(this.scopeId) + '"])';
-    return "(" + this.createFunction([params], body) + ")" + args;
-  }
-};
-
 // src/core/context/parser/stream.ts
 var BaseStreamParserContext = class extends BaseSyncParserContext {
   constructor(options) {
@@ -3665,6 +3494,197 @@ function fromCrossJSON(source, options) {
   return ctx.deserialize(source);
 }
 
+// src/core/tree/async.ts
+var AsyncParserContext = class extends BaseAsyncParserContext {
+  constructor() {
+    super(...arguments);
+    this.mode = "vanilla";
+  }
+};
+
+// src/core/tree/deserializer.ts
+var VanillaDeserializerContext = class extends BaseDeserializerContext {
+  constructor(options) {
+    super(options);
+    this.mode = "vanilla";
+    this.marked = new Set(options.markedRefs);
+  }
+  assignIndexedValue(index, value) {
+    if (this.marked.has(index)) {
+      this.refs.set(index, value);
+    }
+    return value;
+  }
+};
+
+// src/core/utils/get-identifier.ts
+var REF_START_CHARS = "hjkmoquxzABCDEFGHIJKLNPQRTUVWXYZ$_";
+var REF_START_CHARS_LEN = REF_START_CHARS.length;
+var REF_CHARS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789$_";
+var REF_CHARS_LEN = REF_CHARS.length;
+function getIdentifier(index) {
+  let mod = index % REF_START_CHARS_LEN;
+  let ref = REF_START_CHARS[mod];
+  index = (index - mod) / REF_START_CHARS_LEN;
+  while (index > 0) {
+    mod = index % REF_CHARS_LEN;
+    ref += REF_CHARS[mod];
+    index = (index - mod) / REF_CHARS_LEN;
+  }
+  return ref;
+}
+
+// src/core/tree/serializer.ts
+var VanillaSerializerContext = class extends BaseSerializerContext {
+  constructor() {
+    super(...arguments);
+    this.mode = "vanilla";
+    /**
+     * Map tree refs to actual refs
+     * @private
+     */
+    this.valid = /* @__PURE__ */ new Map();
+    /**
+     * Variables
+     * @private
+     */
+    this.vars = [];
+  }
+  /**
+   * Creates the reference param (identifier) from the given reference ID
+   * Calling this function means the value has been referenced somewhere
+   */
+  getRefParam(index) {
+    let actualIndex = this.valid.get(index);
+    if (actualIndex == null) {
+      actualIndex = this.valid.size;
+      this.valid.set(index, actualIndex);
+    }
+    let identifier = this.vars[actualIndex];
+    if (identifier == null) {
+      identifier = getIdentifier(actualIndex);
+      this.vars[actualIndex] = identifier;
+    }
+    return identifier;
+  }
+  assignIndexedValue(index, value) {
+    if (this.isMarked(index)) {
+      return this.getRefParam(index) + "=" + value;
+    }
+    return value;
+  }
+  serializePromiseConstructor(node) {
+    throw new SerovalUnsupportedNodeError(node);
+  }
+  serializePromiseResolve(node) {
+    throw new SerovalUnsupportedNodeError(node);
+  }
+  serializePromiseReject(node) {
+    throw new SerovalUnsupportedNodeError(node);
+  }
+  serializeTop(tree) {
+    const result = this.serialize(tree);
+    if (tree.i != null && this.vars.length) {
+      const patches = this.resolvePatches();
+      let body = result;
+      if (patches) {
+        const index = this.getRefParam(tree.i);
+        body = result + "," + patches + index;
+        if (!result.startsWith(index + "=")) {
+          body = index + "=" + body;
+        }
+      }
+      return "(" + this.createFunction(this.vars, "(" + body + ")") + ")()";
+    }
+    if (tree.t === 10 /* Object */) {
+      return "(" + result + ")";
+    }
+    return result;
+  }
+};
+
+// src/core/tree/sync.ts
+var SyncParserContext = class extends BaseSyncParserContext {
+  constructor() {
+    super(...arguments);
+    this.mode = "vanilla";
+  }
+};
+
+// src/core/tree/index.ts
+function serialize(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new SyncParserContext({
+    plugins,
+    disabledFeatures: options.disabledFeatures
+  });
+  const tree = ctx.parse(source);
+  const serial = new VanillaSerializerContext({
+    plugins,
+    features: ctx.features,
+    markedRefs: ctx.marked
+  });
+  return serial.serializeTop(tree);
+}
+async function serializeAsync(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new AsyncParserContext({
+    plugins,
+    disabledFeatures: options.disabledFeatures
+  });
+  const tree = await ctx.parse(source);
+  const serial = new VanillaSerializerContext({
+    plugins,
+    features: ctx.features,
+    markedRefs: ctx.marked
+  });
+  return serial.serializeTop(tree);
+}
+function deserialize(source) {
+  return (0, eval)(source);
+}
+function toJSON(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new SyncParserContext({
+    plugins,
+    disabledFeatures: options.disabledFeatures
+  });
+  return {
+    t: ctx.parse(source),
+    f: ctx.features,
+    m: Array.from(ctx.marked)
+  };
+}
+async function toJSONAsync(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new AsyncParserContext({
+    plugins,
+    disabledFeatures: options.disabledFeatures
+  });
+  return {
+    t: await ctx.parse(source),
+    f: ctx.features,
+    m: Array.from(ctx.marked)
+  };
+}
+function compileJSON(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new VanillaSerializerContext({
+    plugins,
+    features: source.f,
+    markedRefs: source.m
+  });
+  return ctx.serializeTop(source.t);
+}
+function fromJSON(source, options = {}) {
+  const plugins = resolvePlugins(options.plugins);
+  const ctx = new VanillaDeserializerContext({
+    plugins,
+    markedRefs: source.m
+  });
+  return ctx.deserialize(source.t);
+}
+
 // src/core/Serializer.ts
 var Serializer = class {
   constructor(options) {
@@ -3745,6 +3765,7 @@ var Serializer = class {
 };
 export {
   Feature,
+  OpaqueReference,
   Serializer,
   SerovalDeserializationError,
   SerovalError,