Rename 'LOOSE' mode to 'LAX' mode

Author: szuend

bench/decode.bench.ts

@@ -25,7 +25,7 @@ const BENCHMARKS = await (async () => {
 
 for (const { name, mapJson, size } of BENCHMARKS) {
   Deno.bench(`${name}, lax, ${format(size)}`, () => {
-    decode(mapJson, { mode: DecodeMode.LOOSE });
+    decode(mapJson, { mode: DecodeMode.LAX });
   });
 
   Deno.bench(`${name}, strict, ${format(size)}`, () => {

src/decode/decode.test.ts

@@ -155,7 +155,7 @@ describe("decode", () => {
     encoder.addUnsignedVLQs(Tag.ORIGINAL_SCOPE_END, 0, 0).finishItem();
     const map = createMap(encoder.encode(), []);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.scopes, []);
   });
@@ -168,12 +168,12 @@ describe("decode", () => {
     assertThrows(() => decode(map, { mode: DecodeMode.STRICT }));
   });
 
-  it("ignores 'open' scopes left at the end in loose mode", () => {
+  it("ignores 'open' scopes left at the end in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.ORIGINAL_SCOPE_START, 0, 0, 0).finishItem();
     const map = createMap(encoder.encode(), []);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.scopes, []);
   });
@@ -187,18 +187,18 @@ describe("decode", () => {
     assertThrows(() => decode(map, { mode: DecodeMode.STRICT }));
   });
 
-  it("ignores GENERATED_RANGE_END items without START in loose mode", () => {
+  it("ignores GENERATED_RANGE_END items without START in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.GENERATED_RANGE_END);
     encoder.addSignedVLQs(42).finishItem();
     const map = createMap(encoder.encode(), []);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.ranges, []);
   });
 
-  it("throws for un-matched GENERATED_RANGE_START at the end in loose mode", () => {
+  it("throws for un-matched GENERATED_RANGE_START at the end in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.GENERATED_RANGE_START, 0);
     encoder.addSignedVLQs(42).finishItem();
@@ -207,13 +207,13 @@ describe("decode", () => {
     assertThrows(() => decode(map, { mode: DecodeMode.STRICT }));
   });
 
-  it("ignores un-matched GENERATED_RANGE_START at the end in loose mode", () => {
+  it("ignores un-matched GENERATED_RANGE_START at the end in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.GENERATED_RANGE_START, 0);
     encoder.addSignedVLQs(42).finishItem();
     const map = createMap(encoder.encode(), []);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.ranges, []);
   });
@@ -227,13 +227,13 @@ describe("decode", () => {
     assertThrows(() => decode(map, { mode: DecodeMode.STRICT }));
   });
 
-  it("ignores free ORIGINAL_SCOPE_VARIABLES items in loose mode", () => {
+  it("ignores free ORIGINAL_SCOPE_VARIABLES items in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.ORIGINAL_SCOPE_VARIABLES);
     encoder.addSignedVLQs(0, 1).finishItem();
     const map = createMap(encoder.encode(), ["foo", "bar"]);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.scopes, []);
   });
@@ -247,13 +247,13 @@ describe("decode", () => {
     assertThrows(() => decode(map, { mode: DecodeMode.STRICT }));
   });
 
-  it("ignores free ORIGINAL_SCOPE_VARIABLES items in loose mode", () => {
+  it("ignores free ORIGINAL_SCOPE_VARIABLES items in lax mode", () => {
     const encoder = new ItemEncoder();
     encoder.addUnsignedVLQs(Tag.GENERATED_RANGE_BINDINGS);
     encoder.addSignedVLQs(0, -1).finishItem();
     const map = createMap(encoder.encode(), ["foo"]);
 
-    const info = decode(map, { mode: DecodeMode.LOOSE });
+    const info = decode(map, { mode: DecodeMode.LAX });
 
     assertEquals(info.scopes, []);
   });

src/decode/decode.ts

@@ -20,7 +20,7 @@ import { TokenIterator } from "../vlq.ts";
 /**
  * The mode decides how well-formed the encoded scopes have to be, to be accepted by the decoder.
  *
- * LOOSE is the default and is much more lenient. It's still best effort though and the decoder doesn't
+ * LAX is the default and is much more lenient. It's still best effort though and the decoder doesn't
  * implement any error recovery: e.g. superfluous "start" items can lead to whole trees being omitted.
  *
  * STRICT mode will throw in the following situations:
@@ -33,7 +33,7 @@ import { TokenIterator } from "../vlq.ts";
  */
 export const enum DecodeMode {
   STRICT = 1,
-  LOOSE = 2,
+  LAX = 2,
 }
 
 export function decode(
@@ -80,7 +80,7 @@ class Decoder {
   constructor(scopes: string, names: string[], options?: { mode: DecodeMode }) {
     this.#encodedScopes = scopes;
     this.#names = names;
-    this.#mode = options?.mode ?? DecodeMode.LOOSE;
+    this.#mode = options?.mode ?? DecodeMode.LAX;
   }
 
   decode(): ScopeInfo {