devtools-tracing 1.0.1 → 1.1.0

package/lib/front_end/third_party/source-map-scopes-codec/package/src/builder/safe_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe_builder.js","sources":["./safe_builder.ts"],"names":[],"mappings":"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"}

package/lib/front_end/third_party/source-map-scopes-codec/package/src/builder/safe_builder.ts

@@ -0,0 +1,359 @@
+// Copyright 2025 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import type {
+  Binding,
+  OriginalPosition,
+  OriginalScope,
+  Position,
+  ScopeInfo,
+} from "../scopes.d.ts";
+import { comparePositions } from "../util.js";
+import { ScopeInfoBuilder, type ScopeKey } from "./builder.js";
+
+/**
+ * Similar to `ScopeInfoBuilder`, but with checks that scopes/ranges are well
+ * nested and don't partially overlap.
+ */
+export class SafeScopeInfoBuilder extends ScopeInfoBuilder {
+  override addNullScope(): this {
+    this.#verifyEmptyScopeStack("add null scope");
+    this.#verifyEmptyRangeStack("add null scope");
+
+    super.addNullScope();
+    return this;
+  }
+
+  override startScope(
+    line: number,
+    column: number,
+    options?: {
+      name?: string;
+      kind?: string;
+      isStackFrame?: boolean;
+      variables?: string[];
+      key?: ScopeKey;
+    },
+  ): this {
+    this.#verifyEmptyRangeStack("start scope");
+
+    const parent = this.scopeStack.at(-1);
+
+    if (parent && comparePositions(parent.start, { line, column }) > 0) {
+      throw new Error(
+        `Scope start (${line}, ${column}) must not precede parent start (${parent.start.line}, ${parent.start.column})`,
+      );
+    }
+
+    const precedingSibling = parent?.children.at(-1);
+    if (
+      precedingSibling &&
+      comparePositions(precedingSibling.end, { line, column }) > 0
+    ) {
+      throw new Error(
+        `Scope start (${line}, ${column}) must not precede preceding siblings' end (${precedingSibling
+          .end.line,
+          precedingSibling.end.column})`,
+      );
+    }
+
+    super.startScope(line, column, options);
+    return this;
+  }
+
+  override setScopeName(name: string): this {
+    this.#verifyScopePresent("setScopeName");
+    this.#verifyEmptyRangeStack("setScopeName");
+
+    super.setScopeName(name);
+    return this;
+  }
+
+  override setScopeKind(kind: string): this {
+    this.#verifyScopePresent("setScopeKind");
+    this.#verifyEmptyRangeStack("setScopeKind");
+
+    super.setScopeKind(kind);
+    return this;
+  }
+
+  override setScopeStackFrame(isStackFrame: boolean): this {
+    this.#verifyScopePresent("setScopeStackFrame");
+    this.#verifyEmptyRangeStack("setScopeStackFrame");
+
+    super.setScopeStackFrame(isStackFrame);
+    return this;
+  }
+
+  override setScopeVariables(variables: string[]): this {
+    this.#verifyScopePresent("setScopeVariables");
+    this.#verifyEmptyRangeStack("setScopeVariables");
+
+    super.setScopeVariables(variables);
+    return this;
+  }
+
+  override endScope(line: number, column: number): this {
+    this.#verifyEmptyRangeStack("end scope");
+
+    if (this.scopeStack.length === 0) {
+      throw new Error("No scope to end");
+    }
+
+    const scope = this.scopeStack.at(-1) as OriginalScope;
+    if (comparePositions(scope.start, { line, column }) > 0) {
+      throw new Error(
+        `Scope end (${line}, ${column}) must not precede scope start (${scope.start.line}, ${scope.start.column})`,
+      );
+    }
+
+    super.endScope(line, column);
+    return this;
+  }
+
+  override startRange(
+    line: number,
+    column: number,
+    options?: {
+      scope?: OriginalScope;
+      scopeKey?: ScopeKey;
+      isStackFrame?: boolean;
+      isHidden?: boolean;
+      values?: Binding[];
+      callSite?: OriginalPosition;
+    },
+  ): this {
+    this.#verifyEmptyScopeStack("starRange");
+
+    const parent = this.rangeStack.at(-1);
+    if (parent && comparePositions(parent.start, { line, column }) > 0) {
+      throw new Error(
+        `Range start (${line}, ${column}) must not precede parent start (${parent.start.line}, ${parent.start.column})`,
+      );
+    }
+
+    const precedingSibling = parent?.children.at(-1);
+    if (
+      precedingSibling &&
+      comparePositions(precedingSibling.end, { line, column }) > 0
+    ) {
+      throw new Error(
+        `Range start (${line}, ${column}) must not precede preceding siblings' end (${precedingSibling
+          .end.line,
+          precedingSibling.end.column})`,
+      );
+    }
+
+    if (
+      options?.scopeKey !== undefined &&
+      !this.isValidScopeKey(options.scopeKey)
+    ) {
+      throw new Error(
+        `${options.scopeKey} does not reference a valid OriginalScope`,
+      );
+    }
+    if (options?.scope && !this.isKnownScope(options.scope)) {
+      throw new Error(
+        "The provided definition scope was not produced by this builder!",
+      );
+    }
+
+    if (
+      options?.values?.length && options?.scope === undefined &&
+      options?.scopeKey === undefined
+    ) {
+      throw new Error("Provided bindings without providing an OriginalScope");
+    } else if (
+      options?.values?.length && options?.scope &&
+      options.values.length !== options.scope.variables.length
+    ) {
+      throw new Error(
+        "Provided bindings don't match up with OriginalScope.variables",
+      );
+    } else if (options?.values?.length && options?.scopeKey !== undefined) {
+      const scope = this.getScopeByValidKey(options.scopeKey);
+      if (options.values.length !== scope.variables.length) {
+        throw new Error(
+          "Provided bindings don't match up with OriginalScope.variables",
+        );
+      }
+    }
+
+    super.startRange(line, column, options);
+    return this;
+  }
+
+  override setRangeDefinitionScope(scope: OriginalScope): this {
+    this.#verifyEmptyScopeStack("setRangeDefinitionScope");
+    this.#verifyRangePresent("setRangeDefinitionScope");
+
+    if (!this.isKnownScope(scope)) {
+      throw new Error(
+        "The provided definition scope was not produced by this builder!",
+      );
+    }
+
+    super.setRangeDefinitionScope(scope);
+    return this;
+  }
+
+  override setRangeDefinitionScopeKey(scopeKey: ScopeKey): this {
+    this.#verifyEmptyScopeStack("setRangeDefinitionScope");
+    this.#verifyRangePresent("setRangeDefinitionScope");
+
+    if (!this.isValidScopeKey(scopeKey)) {
+      throw new Error(
+        `The provided scope key ${scopeKey} is not know nto the builder!`,
+      );
+    }
+
+    super.setRangeDefinitionScopeKey(scopeKey);
+    return this;
+  }
+
+  override setRangeStackFrame(isStackFrame: boolean): this {
+    this.#verifyEmptyScopeStack("setRangeStackFrame");
+    this.#verifyRangePresent("setRangeStackFrame");
+
+    super.setRangeStackFrame(isStackFrame);
+    return this;
+  }
+
+  override setRangeHidden(isHidden: boolean): this {
+    this.#verifyEmptyScopeStack("setRangeHidden");
+    this.#verifyRangePresent("setRangeHidden");
+
+    super.setRangeHidden(isHidden);
+    return this;
+  }
+
+  override setRangeValues(values: Binding[]): this {
+    this.#verifyEmptyScopeStack("setRangeValues");
+    this.#verifyRangePresent("setRangeValues");
+
+    const range = this.rangeStack.at(-1)!;
+    if (!range.originalScope) {
+      throw new Error(
+        "Setting an OriginalScope for a range is required before value bindings can be provided!",
+      );
+    } else if (range.originalScope.variables.length !== values.length) {
+      throw new Error(
+        "Provided bindings don't match up with OriginalScope.variables",
+      );
+    }
+
+    super.setRangeValues(values);
+    return this;
+  }
+
+  override setRangeCallSite(callSite: OriginalPosition): this {
+    this.#verifyEmptyScopeStack("setRangeCallSite");
+    this.#verifyRangePresent("setRangeCallSite");
+
+    super.setRangeCallSite(callSite);
+    return this;
+  }
+
+  override endRange(line: number, column: number): this {
+    this.#verifyEmptyScopeStack("endRange");
+
+    if (this.rangeStack.length === 0) {
+      throw new Error("No range to end");
+    }
+
+    const range = this.rangeStack.at(-1)!;
+    if (comparePositions(range.start, { line, column }) > 0) {
+      throw new Error(
+        `Range end (${line}, ${column}) must not precede range start (${range.start.line}, ${range.start.column})`,
+      );
+    }
+
+    this.#verifyRangeValues(range, { line, column });
+    super.endRange(line, column);
+    return this;
+  }
+
+  override build(): ScopeInfo {
+    if (this.scopeStack.length > 0) {
+      throw new Error(
+        "Can't build ScopeInfo while an OriginalScope is unclosed.",
+      );
+    }
+    this.#verifyEmptyRangeStack("build ScopeInfo");
+
+    return super.build();
+  }
+
+  #verifyEmptyScopeStack(op: string): void {
+    if (this.scopeStack.length > 0) {
+      throw new Error(`Can't ${op} while a OriginalScope is unclosed.`);
+    }
+  }
+
+  #verifyEmptyRangeStack(op: string): void {
+    if (this.rangeStack.length > 0) {
+      throw new Error(`Can't ${op} while a GeneratedRange is unclosed.`);
+    }
+  }
+
+  #verifyScopePresent(op: string): void {
+    if (this.scopeStack.length === 0) {
+      throw new Error(`Can't ${op} while no OriginalScope is on the stack.`);
+    }
+  }
+
+  #verifyRangePresent(op: string): void {
+    if (this.rangeStack.length === 0) {
+      throw new Error(`Can't ${op} while no GeneratedRange is on the stack.`);
+    }
+  }
+
+  #verifyRangeValues(
+    range: { start: Position; values: Binding[] },
+    end: Position,
+  ): void {
+    for (const value of range.values) {
+      if (!Array.isArray(value)) {
+        continue;
+      }
+
+      const subRanges = value;
+      if (subRanges.length === 0) {
+        continue;
+      }
+
+      const first = subRanges.at(0)!;
+      if (comparePositions(first.from, range.start) !== 0) {
+        throw new Error(
+          `Sub-range bindings must start at the generated range's start. Expected ${range.start.line}:${range.start.column}, but got ${first.from.line}:${first.from.column}`,
+        );
+      }
+
+      const last = subRanges.at(-1)!;
+      if (comparePositions(last.to, end) !== 0) {
+        throw new Error(
+          `Sub-range bindings must end at the generated range's end. Expected ${end.line}:${end.column}, but got ${last.to.line}:${last.to.column}`,
+        );
+      }
+
+      for (let i = 0; i < subRanges.length; ++i) {
+        const current = subRanges[i];
+        if (comparePositions(current.from, current.to) >= 0) {
+          throw new Error(
+            `Sub-range binding 'from' (${current.from.line}:${current.from.column}) must precede 'to' (${current.to.line}:${current.to.column})`,
+          );
+        }
+
+        if (i > 0) {
+          const prev = subRanges[i - 1];
+          if (comparePositions(prev.to, current.from) !== 0) {
+            throw new Error(
+              `Sub-range bindings must be sorted and not overlap. Found gap between ${prev.to.line}:${prev.to.column} and ${current.from.line}:${current.from.column}`,
+            );
+          }
+        }
+      }
+    }
+  }
+}

package/lib/front_end/third_party/source-map-scopes-codec/package/src/codec.js

@@ -0,0 +1,39 @@
+// Copyright 2025 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+export var Tag = /*#__PURE__*/ function(Tag) {
+  Tag[Tag["ORIGINAL_SCOPE_START"] = 1] = "ORIGINAL_SCOPE_START";
+  Tag[Tag["ORIGINAL_SCOPE_END"] = 2] = "ORIGINAL_SCOPE_END";
+  Tag[Tag["ORIGINAL_SCOPE_VARIABLES"] = 3] = "ORIGINAL_SCOPE_VARIABLES";
+  Tag[Tag["GENERATED_RANGE_START"] = 4] = "GENERATED_RANGE_START";
+  Tag[Tag["GENERATED_RANGE_END"] = 5] = "GENERATED_RANGE_END";
+  Tag[Tag["GENERATED_RANGE_BINDINGS"] = 6] = "GENERATED_RANGE_BINDINGS";
+  Tag[Tag["GENERATED_RANGE_SUBRANGE_BINDING"] = 7] = "GENERATED_RANGE_SUBRANGE_BINDING";
+  Tag[Tag["GENERATED_RANGE_CALL_SITE"] = 8] = "GENERATED_RANGE_CALL_SITE";
+  return Tag;
+}({});
+export var EncodedTag = /*#__PURE__*/ function(EncodedTag) {
+  EncodedTag["ORIGINAL_SCOPE_START"] = "B";
+  EncodedTag["ORIGINAL_SCOPE_END"] = "C";
+  EncodedTag["ORIGINAL_SCOPE_VARIABLES"] = "D";
+  EncodedTag["GENERATED_RANGE_START"] = "E";
+  EncodedTag["GENERATED_RANGE_END"] = "F";
+  EncodedTag["GENERATED_RANGE_BINDINGS"] = "G";
+  EncodedTag["GENERATED_RANGE_SUBRANGE_BINDING"] = "H";
+  EncodedTag["GENERATED_RANGE_CALL_SITE"] = "I";
+  return EncodedTag;
+}({});
+export var OriginalScopeFlags = /*#__PURE__*/ function(OriginalScopeFlags) {
+  OriginalScopeFlags[OriginalScopeFlags["HAS_NAME"] = 1] = "HAS_NAME";
+  OriginalScopeFlags[OriginalScopeFlags["HAS_KIND"] = 2] = "HAS_KIND";
+  OriginalScopeFlags[OriginalScopeFlags["IS_STACK_FRAME"] = 4] = "IS_STACK_FRAME";
+  return OriginalScopeFlags;
+}({});
+export var GeneratedRangeFlags = /*#__PURE__*/ function(GeneratedRangeFlags) {
+  GeneratedRangeFlags[GeneratedRangeFlags["HAS_LINE"] = 1] = "HAS_LINE";
+  GeneratedRangeFlags[GeneratedRangeFlags["HAS_DEFINITION"] = 2] = "HAS_DEFINITION";
+  GeneratedRangeFlags[GeneratedRangeFlags["IS_STACK_FRAME"] = 4] = "IS_STACK_FRAME";
+  GeneratedRangeFlags[GeneratedRangeFlags["IS_HIDDEN"] = 8] = "IS_HIDDEN";
+  return GeneratedRangeFlags;
+}({});
+//# sourceMappingURL=codec.js.map

package/lib/front_end/third_party/source-map-scopes-codec/package/src/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sources":["./codec.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,IAAA,AAAW,6BAAA;;;;;;;;;SAAA;MASjB;AAED,OAAO,IAAA,AAAW,oCAAA;;;;;;;;;SAAA;MASjB;AAED,OAAO,IAAA,AAAW,4CAAA;;;;SAAA;MAIjB;AAED,OAAO,IAAA,AAAW,6CAAA;;;;;SAAA;MAKjB"}

package/lib/front_end/third_party/source-map-scopes-codec/package/src/codec.ts

@@ -0,0 +1,53 @@
+// Copyright 2025 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+export const enum Tag {
+  ORIGINAL_SCOPE_START = 0x1,
+  ORIGINAL_SCOPE_END = 0x2,
+  ORIGINAL_SCOPE_VARIABLES = 0x3,
+  GENERATED_RANGE_START = 0x4,
+  GENERATED_RANGE_END = 0x5,
+  GENERATED_RANGE_BINDINGS = 0x6,
+  GENERATED_RANGE_SUBRANGE_BINDING = 0x7,
+  GENERATED_RANGE_CALL_SITE = 0x8,
+}
+
+export const enum EncodedTag {
+  ORIGINAL_SCOPE_START = "B", // 0x1
+  ORIGINAL_SCOPE_END = "C", // 0x2
+  ORIGINAL_SCOPE_VARIABLES = "D", // 0x3
+  GENERATED_RANGE_START = "E", // 0x4
+  GENERATED_RANGE_END = "F", // 0x5
+  GENERATED_RANGE_BINDINGS = "G", // 0x6
+  GENERATED_RANGE_SUBRANGE_BINDING = "H", // 0x7
+  GENERATED_RANGE_CALL_SITE = "I", // 0x8
+}
+
+export const enum OriginalScopeFlags {
+  HAS_NAME = 0x1,
+  HAS_KIND = 0x2,
+  IS_STACK_FRAME = 0x4,
+}
+
+export const enum GeneratedRangeFlags {
+  HAS_LINE = 0x1,
+  HAS_DEFINITION = 0x2,
+  IS_STACK_FRAME = 0x4,
+  IS_HIDDEN = 0x8,
+}
+
+export interface OriginalScopeStartItem {
+  flags: number;
+  line: number;
+  column: number;
+  nameIdx?: number;
+  kindIdx?: number;
+}
+
+export interface GeneratedRangeStartItem {
+  flags: number;
+  line?: number;
+  column: number;
+  definitionIdx?: number;
+}