devtools-tracing 1.0.1 → 1.1.1

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

@@ -0,0 +1,196 @@
+// 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.
+/**
+ * Small utility class to build scope and range trees.
+ *
+ * This class allows construction of scope/range trees that will be rejected by the encoder.
+ * Use this class if you guarantee proper nesting yourself and don't want to pay for the
+ * checks, otherwise use the `SafeScopeInfoBuilder`.
+ *
+ * This class will also silently ignore calls that would fail otherwise. E.g. calling
+ * `end*` without a matching `start*`.
+ */ export class ScopeInfoBuilder {
+  #scopes = [];
+  #ranges = [];
+  #scopeStack = [];
+  #rangeStack = [];
+  #knownScopes = new Set();
+  #keyToScope = new Map();
+  #lastScope = null;
+  addNullScope() {
+    this.#scopes.push(null);
+    return this;
+  }
+  startScope(line, column, options) {
+    const scope = {
+      start: {
+        line,
+        column
+      },
+      end: {
+        line,
+        column
+      },
+      variables: options?.variables?.slice(0) ?? [],
+      children: [],
+      isStackFrame: Boolean(options?.isStackFrame)
+    };
+    if (options?.name !== undefined) scope.name = options.name;
+    if (options?.kind !== undefined) scope.kind = options.kind;
+    if (this.#scopeStack.length > 0) {
+      scope.parent = this.#scopeStack.at(-1);
+    }
+    this.#scopeStack.push(scope);
+    this.#knownScopes.add(scope);
+    if (options?.key !== undefined) this.#keyToScope.set(options.key, scope);
+    return this;
+  }
+  setScopeName(name) {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.name = name;
+    return this;
+  }
+  setScopeKind(kind) {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.kind = kind;
+    return this;
+  }
+  setScopeStackFrame(isStackFrame) {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.isStackFrame = isStackFrame;
+    return this;
+  }
+  setScopeVariables(variables) {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.variables = variables.slice(0);
+    return this;
+  }
+  endScope(line, column) {
+    const scope = this.#scopeStack.pop();
+    if (!scope) return this;
+    scope.end = {
+      line,
+      column
+    };
+    if (this.#scopeStack.length === 0) {
+      this.#scopes.push(scope);
+    } else {
+      this.#scopeStack.at(-1).children.push(scope);
+    }
+    this.#lastScope = scope;
+    return this;
+  }
+  /**
+   * @returns The OriginalScope opened with the most recent `startScope` call, but not yet closed.
+   */ currentScope() {
+    return this.#scopeStack.at(-1) ?? null;
+  }
+  /**
+   * @returns The most recent OriginalScope closed with `endScope`.
+   */ lastScope() {
+    return this.#lastScope;
+  }
+  /**
+   * @param option The definition 'scope' of this range can either be the "OriginalScope" directly
+   * (produced by this builder) or the scope's key set while building the scope.
+   */ startRange(line, column, options) {
+    const range = {
+      start: {
+        line,
+        column
+      },
+      end: {
+        line,
+        column
+      },
+      isStackFrame: Boolean(options?.isStackFrame),
+      isHidden: Boolean(options?.isHidden),
+      values: options?.values ?? [],
+      children: []
+    };
+    if (this.#rangeStack.length > 0) {
+      range.parent = this.#rangeStack.at(-1);
+    }
+    if (options?.scope !== undefined) {
+      range.originalScope = options.scope;
+    } else if (options?.scopeKey !== undefined) {
+      range.originalScope = this.#keyToScope.get(options.scopeKey);
+    }
+    if (options?.callSite) {
+      range.callSite = options.callSite;
+    }
+    this.#rangeStack.push(range);
+    return this;
+  }
+  setRangeDefinitionScope(scope) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.originalScope = scope;
+    return this;
+  }
+  setRangeDefinitionScopeKey(scopeKey) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.originalScope = this.#keyToScope.get(scopeKey);
+    return this;
+  }
+  setRangeStackFrame(isStackFrame) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.isStackFrame = isStackFrame;
+    return this;
+  }
+  setRangeHidden(isHidden) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.isHidden = isHidden;
+    return this;
+  }
+  setRangeValues(values) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.values = values;
+    return this;
+  }
+  setRangeCallSite(callSite) {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.callSite = callSite;
+    return this;
+  }
+  endRange(line, column) {
+    const range = this.#rangeStack.pop();
+    if (!range) return this;
+    range.end = {
+      line,
+      column
+    };
+    if (this.#rangeStack.length === 0) {
+      this.#ranges.push(range);
+    } else {
+      this.#rangeStack.at(-1).children.push(range);
+    }
+    return this;
+  }
+  build() {
+    const info = {
+      scopes: this.#scopes,
+      ranges: this.#ranges
+    };
+    this.#scopes = [];
+    this.#ranges = [];
+    this.#knownScopes.clear();
+    return info;
+  }
+  get scopeStack() {
+    return this.#scopeStack;
+  }
+  get rangeStack() {
+    return this.#rangeStack;
+  }
+  isKnownScope(scope) {
+    return this.#knownScopes.has(scope);
+  }
+  isValidScopeKey(key) {
+    return this.#keyToScope.has(key);
+  }
+  getScopeByValidKey(key) {
+    return this.#keyToScope.get(key);
+  }
+}
+//# sourceMappingURL=builder.js.map

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

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

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

@@ -0,0 +1,262 @@
+// 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,
+  GeneratedRange,
+  OriginalPosition,
+  OriginalScope,
+  ScopeInfo,
+} from "../scopes.d.ts";
+
+/**
+ * Small utility class to build scope and range trees.
+ *
+ * This class allows construction of scope/range trees that will be rejected by the encoder.
+ * Use this class if you guarantee proper nesting yourself and don't want to pay for the
+ * checks, otherwise use the `SafeScopeInfoBuilder`.
+ *
+ * This class will also silently ignore calls that would fail otherwise. E.g. calling
+ * `end*` without a matching `start*`.
+ */
+export class ScopeInfoBuilder {
+  #scopes: (OriginalScope | null)[] = [];
+  #ranges: GeneratedRange[] = [];
+
+  #scopeStack: OriginalScope[] = [];
+  #rangeStack: GeneratedRange[] = [];
+
+  #knownScopes = new Set<OriginalScope>();
+  #keyToScope = new Map<ScopeKey, OriginalScope>();
+  #lastScope: OriginalScope | null = null;
+
+  addNullScope(): this {
+    this.#scopes.push(null);
+    return this;
+  }
+
+  startScope(
+    line: number,
+    column: number,
+    options?: {
+      name?: string;
+      kind?: string;
+      isStackFrame?: boolean;
+      variables?: string[];
+      key?: ScopeKey;
+    },
+  ): this {
+    const scope: OriginalScope = {
+      start: { line, column },
+      end: { line, column },
+      variables: options?.variables?.slice(0) ?? [],
+      children: [],
+      isStackFrame: Boolean(options?.isStackFrame),
+    };
+
+    if (options?.name !== undefined) scope.name = options.name;
+    if (options?.kind !== undefined) scope.kind = options.kind;
+
+    if (this.#scopeStack.length > 0) {
+      scope.parent = this.#scopeStack.at(-1);
+    }
+    this.#scopeStack.push(scope);
+    this.#knownScopes.add(scope);
+    if (options?.key !== undefined) this.#keyToScope.set(options.key, scope);
+
+    return this;
+  }
+
+  setScopeName(name: string): this {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.name = name;
+    return this;
+  }
+
+  setScopeKind(kind: string): this {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.kind = kind;
+    return this;
+  }
+
+  setScopeStackFrame(isStackFrame: boolean): this {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.isStackFrame = isStackFrame;
+    return this;
+  }
+
+  setScopeVariables(variables: string[]): this {
+    const scope = this.#scopeStack.at(-1);
+    if (scope) scope.variables = variables.slice(0);
+
+    return this;
+  }
+
+  endScope(line: number, column: number): this {
+    const scope = this.#scopeStack.pop();
+    if (!scope) return this;
+
+    scope.end = { line, column };
+
+    if (this.#scopeStack.length === 0) {
+      this.#scopes.push(scope);
+    } else {
+      this.#scopeStack.at(-1)!.children.push(scope);
+    }
+    this.#lastScope = scope;
+
+    return this;
+  }
+
+  /**
+   * @returns The OriginalScope opened with the most recent `startScope` call, but not yet closed.
+   */
+  currentScope(): OriginalScope | null {
+    return this.#scopeStack.at(-1) ?? null;
+  }
+
+  /**
+   * @returns The most recent OriginalScope closed with `endScope`.
+   */
+  lastScope(): OriginalScope | null {
+    return this.#lastScope;
+  }
+
+  /**
+   * @param option The definition 'scope' of this range can either be the "OriginalScope" directly
+   * (produced by this builder) or the scope's key set while building the scope.
+   */
+  startRange(
+    line: number,
+    column: number,
+    options?: {
+      scope?: OriginalScope;
+      scopeKey?: ScopeKey;
+      isStackFrame?: boolean;
+      isHidden?: boolean;
+      values?: Binding[];
+      callSite?: OriginalPosition;
+    },
+  ): this {
+    const range: GeneratedRange = {
+      start: { line, column },
+      end: { line, column },
+      isStackFrame: Boolean(options?.isStackFrame),
+      isHidden: Boolean(options?.isHidden),
+      values: options?.values ?? [],
+      children: [],
+    };
+
+    if (this.#rangeStack.length > 0) {
+      range.parent = this.#rangeStack.at(-1);
+    }
+
+    if (options?.scope !== undefined) {
+      range.originalScope = options.scope;
+    } else if (options?.scopeKey !== undefined) {
+      range.originalScope = this.#keyToScope.get(options.scopeKey);
+    }
+
+    if (options?.callSite) {
+      range.callSite = options.callSite;
+    }
+
+    this.#rangeStack.push(range);
+
+    return this;
+  }
+
+  setRangeDefinitionScope(scope: OriginalScope): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.originalScope = scope;
+    return this;
+  }
+
+  setRangeDefinitionScopeKey(scopeKey: ScopeKey): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.originalScope = this.#keyToScope.get(scopeKey);
+    return this;
+  }
+
+  setRangeStackFrame(isStackFrame: boolean): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.isStackFrame = isStackFrame;
+
+    return this;
+  }
+
+  setRangeHidden(isHidden: boolean): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.isHidden = isHidden;
+
+    return this;
+  }
+
+  setRangeValues(values: Binding[]): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.values = values;
+
+    return this;
+  }
+
+  setRangeCallSite(callSite: OriginalPosition): this {
+    const range = this.#rangeStack.at(-1);
+    if (range) range.callSite = callSite;
+
+    return this;
+  }
+
+  endRange(line: number, column: number): this {
+    const range = this.#rangeStack.pop();
+    if (!range) return this;
+
+    range.end = { line, column };
+
+    if (this.#rangeStack.length === 0) {
+      this.#ranges.push(range);
+    } else {
+      this.#rangeStack.at(-1)!.children.push(range);
+    }
+
+    return this;
+  }
+
+  build(): ScopeInfo {
+    const info: ScopeInfo = { scopes: this.#scopes, ranges: this.#ranges };
+
+    this.#scopes = [];
+    this.#ranges = [];
+    this.#knownScopes.clear();
+
+    return info;
+  }
+
+  protected get scopeStack(): ReadonlyArray<OriginalScope> {
+    return this.#scopeStack;
+  }
+
+  protected get rangeStack(): ReadonlyArray<GeneratedRange> {
+    return this.#rangeStack;
+  }
+
+  protected isKnownScope(scope: OriginalScope): boolean {
+    return this.#knownScopes.has(scope);
+  }
+
+  protected isValidScopeKey(key: ScopeKey): boolean {
+    return this.#keyToScope.has(key);
+  }
+
+  protected getScopeByValidKey(key: ScopeKey): OriginalScope {
+    return this.#keyToScope.get(key)!;
+  }
+}
+
+/**
+ * Users of the {@link ScopeInfoBuilder} can provide their own keys to uniquely identify a scope,
+ * and use the key later when building the corresponding range to connect them.
+ *
+ * The only requirement for ScopeKey is that it can be used as a key in a `Map`.
+ */
+export type ScopeKey = unknown;

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

@@ -0,0 +1,235 @@
+// 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 { comparePositions } from "../util.js";
+import { ScopeInfoBuilder } 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 {
+  addNullScope() {
+    this.#verifyEmptyScopeStack("add null scope");
+    this.#verifyEmptyRangeStack("add null scope");
+    super.addNullScope();
+    return this;
+  }
+  startScope(line, column, options) {
+    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;
+  }
+  setScopeName(name) {
+    this.#verifyScopePresent("setScopeName");
+    this.#verifyEmptyRangeStack("setScopeName");
+    super.setScopeName(name);
+    return this;
+  }
+  setScopeKind(kind) {
+    this.#verifyScopePresent("setScopeKind");
+    this.#verifyEmptyRangeStack("setScopeKind");
+    super.setScopeKind(kind);
+    return this;
+  }
+  setScopeStackFrame(isStackFrame) {
+    this.#verifyScopePresent("setScopeStackFrame");
+    this.#verifyEmptyRangeStack("setScopeStackFrame");
+    super.setScopeStackFrame(isStackFrame);
+    return this;
+  }
+  setScopeVariables(variables) {
+    this.#verifyScopePresent("setScopeVariables");
+    this.#verifyEmptyRangeStack("setScopeVariables");
+    super.setScopeVariables(variables);
+    return this;
+  }
+  endScope(line, column) {
+    this.#verifyEmptyRangeStack("end scope");
+    if (this.scopeStack.length === 0) {
+      throw new Error("No scope to end");
+    }
+    const scope = this.scopeStack.at(-1);
+    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;
+  }
+  startRange(line, column, options) {
+    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;
+  }
+  setRangeDefinitionScope(scope) {
+    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;
+  }
+  setRangeDefinitionScopeKey(scopeKey) {
+    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;
+  }
+  setRangeStackFrame(isStackFrame) {
+    this.#verifyEmptyScopeStack("setRangeStackFrame");
+    this.#verifyRangePresent("setRangeStackFrame");
+    super.setRangeStackFrame(isStackFrame);
+    return this;
+  }
+  setRangeHidden(isHidden) {
+    this.#verifyEmptyScopeStack("setRangeHidden");
+    this.#verifyRangePresent("setRangeHidden");
+    super.setRangeHidden(isHidden);
+    return this;
+  }
+  setRangeValues(values) {
+    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;
+  }
+  setRangeCallSite(callSite) {
+    this.#verifyEmptyScopeStack("setRangeCallSite");
+    this.#verifyRangePresent("setRangeCallSite");
+    super.setRangeCallSite(callSite);
+    return this;
+  }
+  endRange(line, column) {
+    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;
+  }
+  build() {
+    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) {
+    if (this.scopeStack.length > 0) {
+      throw new Error(`Can't ${op} while a OriginalScope is unclosed.`);
+    }
+  }
+  #verifyEmptyRangeStack(op) {
+    if (this.rangeStack.length > 0) {
+      throw new Error(`Can't ${op} while a GeneratedRange is unclosed.`);
+    }
+  }
+  #verifyScopePresent(op) {
+    if (this.scopeStack.length === 0) {
+      throw new Error(`Can't ${op} while no OriginalScope is on the stack.`);
+    }
+  }
+  #verifyRangePresent(op) {
+    if (this.rangeStack.length === 0) {
+      throw new Error(`Can't ${op} while no GeneratedRange is on the stack.`);
+    }
+  }
+  #verifyRangeValues(range, end) {
+    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}`);
+          }
+        }
+      }
+    }
+  }
+}
+//# sourceMappingURL=safe_builder.js.map