chrome-devtools-mcp 0.0.1 → 0.0.2

package/build/node_modules/chrome-devtools-frontend/front_end/third_party/source-map-scopes-codec/LICENSE

@@ -0,0 +1,26 @@
+Copyright 2025 The Chromium Authors
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/build/node_modules/chrome-devtools-frontend/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);
+    }
+}

package/build/node_modules/chrome-devtools-frontend/front_end/third_party/source-map-scopes-codec/package/src/builder/safe_builder.js

@@ -0,0 +1,226 @@
+// 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}`);
+                    }
+                }
+            }
+        }
+    }
+}

package/build/node_modules/chrome-devtools-frontend/front_end/third_party/source-map-scopes-codec/package/src/codec.js

@@ -0,0 +1,4 @@
+// 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 {};