chrome-devtools-frontend 1.0.1506453 → 1.0.1510180

package/scripts/build/devtools_plugin.js

@@ -1,164 +0,0 @@
-// Copyright 2022 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.
-
-// @ts-check
-
-const path = require('path');
-
-/**
- * `path.dirname` does not include trailing slashes. If we would always
- * use `path.dirname` and then later perform comparisons on the paths that
- * it returns, we could run into false positives. For example, given the
- * the following two paths:
- *
- *     front_end/timeline_model/TimelineModel.js
- *     front_end/timeline/Timeline.js
- *
- * And that would have the following values for `path.dirname`:
- *
- *     front_end/timeline_model
- *     front_end/timeline
- *
- * If we would do a simple `.startswith` on the `path.dirname` of both of
- * these paths, then the first path would start with the dirname of the
- * second. However, they *are* part of different folders. To fix that problem,
- * we need to force a path separator after each folder. That makes sure we
- * and up with the following comparison of path dirnames:
- *
- *     front_end/timeline_model/
- *     front_end/timeline/
- *
- * Now, the first path does *not* start with the second one, as expected.
- *
- * @param file
- * @returns
- */
-function dirnameWithSeparator(file) {
-  return path.dirname(file) + path.sep;
-}
-
-function devtoolsPlugin(source, importer) {
-  if (!importer) {
-    return null;
-  }
-
-  if (source === '../../lib/codemirror' || !source.startsWith('.')) {
-    // These are imported via require(...), but we don't use
-    // @rollup/plugin-commonjs. So this check is not necessary for rollup. But
-    // need to have this for esbuild as it doesn't ignore require(...).
-    return {
-      id: source,
-      external: true,
-    };
-  }
-
-  const currentDirectory = path.normalize(dirnameWithSeparator(importer));
-  const importedFilelocation = path.normalize(path.join(currentDirectory, source));
-  const importedFileDirectory = dirnameWithSeparator(importedFilelocation);
-
-  // Generated files are part of other directories, as they are only imported once
-  if (path.basename(importedFileDirectory) === 'generated') {
-    return null;
-  }
-
-  // An import is considered external (and therefore a separate
-  // bundle) if its filename matches its immediate parent's folder
-  // name (without the extension). For example:
-  // `import * as Components from './components/components.js'` = external
-  // `import * as UI from '../ui/ui.js'` = external
-  // `import * as Lit from '../third_party/lit/lit.js'` = external
-  // `import {DataGrid} from './components/DataGrid.js'` = not external
-  // `import * as Components from './components/foo.js'` = not external
-
-  // Note that we can't do a simple check for only `third_party`, as in Chromium
-  // our full path is `third_party/devtools-frontend/src/`, which thus *always*
-  // includes third_party. It also not possible to use the current directory
-  // as a check for the import, as the import will be different in Chromium and
-  // would therefore not match the path of `__dirname`.
-  // These should be removed because the new heuristic _should_ deal with these
-  // e.g. it'll pick up third_party/lit/lit.js is its own entrypoint
-
-  // The CodeMirror addons look like bundles (addon/comment/comment.js) but are not.
-  if (importedFileDirectory.includes(path.join('front_end', 'third_party', 'codemirror', 'package'))) {
-    return null;
-  }
-
-  // The LightHouse bundle shouldn't be processed by `terser` again, as it is uniquely built
-  if (importedFilelocation.includes(path.join('front_end', 'third_party', 'lighthouse', 'lighthouse-dt-bundle.js'))) {
-    return {
-      id: importedFilelocation,
-      external: true,
-    };
-  }
-
-  if (importedFileDirectory.includes(path.join('front_end', 'third_party', 'puppeteer', 'package'))) {
-    // Ignore possible dynamic imports from the Node folder.
-    if (importedFileDirectory.includes(path.join('front_end', 'third_party', 'puppeteer', 'package', 'lib', 'esm', 'puppeteer', 'node'))) {
-      return {
-        id: importedFilelocation,
-        external: true,
-      };
-    }
-    return {
-      id: importedFilelocation,
-      external: false,
-    };
-  }
-
-  if (importedFileDirectory.includes(path.join('front_end', 'third_party', 'puppeteer-replay', 'package'))) {
-    return {
-      id: importedFilelocation,
-      external: false,
-    };
-  }
-
-  if (importedFileDirectory.includes(path.join('front_end', 'third_party', 'source-map-scopes-codec', 'package'))) {
-    return {
-      id: importedFilelocation,
-      external: false,
-    };
-  }
-
-  const importedFileName = path.basename(importedFilelocation, '.js');
-  const importedFileParentDirectory = path.basename(path.dirname(importedFilelocation));
-  const isExternal = importedFileName === importedFileParentDirectory;
-
-  return {
-    id: importedFilelocation,
-    external: isExternal,
-  };
-}
-
-function esbuildPlugin(outdir) {
-  return args => {
-    // args.importer is absolute path in esbuild.
-    const res = devtoolsPlugin(args.path, args.importer);
-    if (!res) {
-      return null;
-    }
-
-    if (res.external) {
-      // res.id can be both of absolutized local JavaScript path or node's
-      // builtin module (e.g. 'fs', 'path'), and only relativize the path in
-      // former case.
-      if (path.isAbsolute(res.id)) {
-        res.id = './' + path.relative(outdir, res.id);
-      }
-
-      return {
-        external: res.external,
-        path: res.id,
-      };
-    }
-
-    return {
-      path: res.id,
-    };
-  };
-}
-
-module.exports = {
-  devtoolsPlugin,
-  esbuildPlugin
-};

package/scripts/build/efficiently_recompile.py

@@ -1,29 +0,0 @@
-#!/usr/bin/env vpython3
-#
-# Copyright 2019 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.
-"""
-Run unit tests on a pinned version of chrome after automatically compiling the required files
-"""
-
-import argparse
-import subprocess
-import sys
-import os
-from os import path
-
-ROOT_DIRECTORY = path.join(path.dirname(path.abspath(__file__)), '..', '..')
-
-
-def recompile(ninja_build_name, ninja_target_name):
-    ninja_proc = subprocess.Popen([
-        'autoninja.bat' if os.name == 'nt' else 'autoninja', '-C',
-        'out/{}'.format(ninja_build_name), ninja_target_name
-    ],
-                                  cwd=ROOT_DIRECTORY)
-
-    ninja_proc.communicate()
-
-    if ninja_proc.returncode != 0:
-        sys.exit(ninja_proc.returncode)

package/scripts/build/esbuild.js

@@ -1,56 +0,0 @@
-// Copyright 2022 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.
-
-// @ts-check
-
-const os = require('os');
-const path = require('path');
-
-const {devtoolsRootPath} = require('../devtools_paths.js');
-
-const {esbuildPlugin} = require('./devtools_plugin.js');
-
-// esbuild module uses binary in this path.
-const binaryName = os.type() === 'Windows_NT' ? 'esbuild.exe' : 'esbuild';
-process.env.ESBUILD_BINARY_PATH = path.join(
-    devtoolsRootPath(),
-    'third_party',
-    'esbuild',
-    binaryName,
-);
-// This needs to be after the ESBUILD_BINARY_PATH is set
-// eslint-disable-next-line import/order
-const esbuild = require('esbuild');
-
-const entryPoints = [process.argv[2]];
-const outfile = process.argv[3];
-const useSourceMaps = process.argv.slice(4).includes('--configSourcemaps');
-
-const outdir = path.dirname(outfile);
-
-const plugin = {
-  name: 'devtools-plugin',
-  setup(build) {
-    // https://esbuild.github.io/plugins/#on-resolve
-    build.onResolve({filter: /.*/}, esbuildPlugin(outdir));
-  },
-};
-
-esbuild
-    .build({
-      entryPoints,
-      outfile,
-      bundle: true,
-      format: 'esm',
-      platform: 'browser',
-      plugins: [plugin],
-      sourcemap: useSourceMaps,
-    })
-    .catch(err => {
-      console.error('Failed to run esbuild:', err);
-      console.error(
-          '\nIf error includes `Host version "X" does not match binary version "Y", you need to run `gclient sync`',
-      );
-      process.exit(1);
-    });

package/scripts/build/generate_aria.py

@@ -1,36 +0,0 @@
-#!/usr/bin/env vpython3
-#
-# Copyright 2018 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 datetime
-import json
-import os
-import sys
-from os import path
-
-PYJSON5_DIR = os.path.join(os.path.dirname(__file__), '..', '..', 'third_party', 'pyjson5', 'src')
-sys.path.append(PYJSON5_DIR)
-
-import json5  # pylint: disable=import-error
-
-ROOT_DIRECTORY = path.join(path.dirname(__file__), '..', '..')
-GENERATED_LOCATION = path.join(ROOT_DIRECTORY, 'front_end', 'generated', 'ARIAProperties.js')
-READ_LOCATION = path.join(ROOT_DIRECTORY, 'third_party', 'blink', 'renderer', 'core', 'html', 'aria_properties.json5')
-
-def properties_from_file(file_name):
-    with open(os.path.abspath(file_name)) as json5_file:
-        properties = json5.loads(json5_file.read())
-        return properties
-
-
-ARIA_PROPERTIES = properties_from_file(READ_LOCATION)
-now = datetime.datetime.now()
-with open(GENERATED_LOCATION, "w+") as f:
-    f.write('// Copyright %d The Chromium Authors. All rights reserved.\n' % now.year)
-    f.write('// Use of this source code is governed by a BSD-style license that can be\n')
-    f.write('// found in the LICENSE file.\n')
-    f.write('\n')
-    f.write("export const config = %s;\n" %
-            json.dumps(ARIA_PROPERTIES, sort_keys=True, indent=1))

package/scripts/build/generate_css_js_files.js

@@ -1,83 +0,0 @@
-// Copyright 2021 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.
-const cssnano = require('cssnano');
-const cssnanoPresetLite = require('cssnano-preset-lite');
-const fs = require('fs');
-const path = require('path');
-const postcss = require('postcss');
-
-const {writeIfChanged} = require('./ninja/write-if-changed.js');
-
-async function runCSSMinification(input, fileName) {
-  // postcss needs to be given a fileName, even though it doesn't read from it nor write to it.
-  // So we pass in the correct name, even though it has no impact on the resulting code.
-  const result = await postcss([
-                   cssnano({preset: cssnanoPresetLite}),
-                 ]).process(input, {from: fileName});
-  return result.css;
-}
-
-async function codeForFile({fileName, input, isDebug, buildTimestamp}) {
-  input = input.replace(/\`/g, '\\\'');
-  input = input.replace(/\\/g, '\\\\');
-
-  const stylesheetContents = isDebug ? input : await runCSSMinification(input, fileName);
-
-  const year = new Date(Number(buildTimestamp) * 1000).getUTCFullYear();
-  return `// Copyright ${year} 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.
-// IMPORTANT: this file is auto generated. Please do not edit this file.
-/* istanbul ignore file */
-export default \`${stylesheetContents}
-/*# sourceURL=\${import.meta.resolve('./${fileName}')} */\`;`;
-}
-
-// Exported only so it can be unit tested.
-exports.codeForFile = codeForFile;
-
-async function runMain() {
-  const [, , buildTimestamp, isDebugString, targetName, srcDir, targetGenDir, files, ] = process.argv;
-
-  const filenames = files.split(',');
-  const configFiles = [];
-  const isDebug = isDebugString === 'true';
-
-  for (const fileName of filenames) {
-    const contents = fs.readFileSync(path.join(srcDir, fileName), {
-      encoding: 'utf8',
-      flag: 'r',
-    });
-    const newContents = await codeForFile({
-      fileName,
-      isDebug,
-      input: contents,
-      buildTimestamp,
-    });
-    const generatedFileName = `${fileName}.js`;
-    const generatedFileLocation = path.join(targetGenDir, generatedFileName);
-
-    writeIfChanged(generatedFileLocation, newContents);
-
-    configFiles.push(`\"${generatedFileName}\"`);
-  }
-
-  writeIfChanged(
-      path.join(targetGenDir, `${targetName}-tsconfig.json`),
-      `{
-    "compilerOptions": {
-        "composite": true,
-        "outDir": "."
-    },
-    "files": [
-        ${configFiles.join(',\n        ')}
-    ]
-}
-`,
-  );
-}
-
-if (require.main === module) {
-  runMain();
-}

package/scripts/build/generate_deprecations.py

@@ -1,99 +0,0 @@
-#!/usr/bin/env vpython3
-#
-# Copyright 2023 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.
-
-# This file generates a TypeScript-ified version of blink's "deprecation.json5".
-# We do this in order to get tyep-saftey of the JSON's content vs the
-# deprecations defined in CDP.
-
-import datetime
-import json
-import os
-import sys
-from os import path
-
-PYJSON5_DIR = path.join(os.path.dirname(__file__), '..', '..', 'third_party',
-                        'pyjson5', 'src')
-sys.path.append(PYJSON5_DIR)
-
-import json5  # pylint: disable=import-error
-
-ROOT_DIRECTORY = path.join(path.dirname(__file__), '..', '..')
-GENERATED_LOCATION = path.join(ROOT_DIRECTORY, 'front_end', 'generated',
-                               'Deprecation.ts')
-READ_LOCATION = path.join(ROOT_DIRECTORY, 'third_party', 'blink', 'renderer',
-                          'core', 'frame', 'deprecation', 'deprecation.json5')
-
-# Deprecations in this list are exempt from code generation as they are not
-# dispatched to the DevTools.
-EXEMPTED_FROM_DEVTOOLS_GENERATION = {
-}
-
-
-def deprecations_from_file(file_name):
-    with open(file_name) as json5_file:
-        doc = json5.loads(json5_file.read())
-
-    # We turn the list of deprecations into two maps, both keyed by the deprecation name.
-    # One contains the message + translation note.
-    # The other contains the metadata such as milestone and chrome feature.
-    meta = {}
-    ui_strings = {}
-    for entry in doc["data"]:
-        if "obsolete_to_be_removed_after_milestone" in entry:
-            continue
-
-        name = entry["name"]
-
-        if name in EXEMPTED_FROM_DEVTOOLS_GENERATION:
-            continue
-
-        meta_for_entry = {}
-        if "milestone" in entry:
-            meta_for_entry["milestone"] = entry["milestone"]
-        if "chrome_status_feature" in entry:
-            meta_for_entry["chromeStatusFeature"] = entry[
-                "chrome_status_feature"]
-        if len(meta_for_entry): meta[name] = meta_for_entry
-
-        ui_strings[name] = {
-            "message": entry["message"],
-            "note": entry["translation_note"],
-        }
-
-    return meta, ui_strings
-
-
-meta, ui_strings = deprecations_from_file(READ_LOCATION)
-now = datetime.datetime.now()
-with open(GENERATED_LOCATION, mode="w+") as f:
-    f.write("// Copyright %d The Chromium Authors. All rights reserved.\n" %
-            now.year)
-    f.write(
-        "// Use of this source code is governed by a BSD-style license that can be\n"
-    )
-    f.write("// found in the LICENSE file.\n")
-    f.write("\n")
-    f.write("// This file is auto-generated, do not edit manually.\n")
-    f.write("// Re-generate with: npm run generate-protocol-resources\n")
-    f.write("\n")
-    f.write("export const UIStrings = {\n")
-    for name, ui_string in ui_strings.items():
-        message = ui_string["message"]
-        note = ui_string["note"]
-        f.write("  /**\n")
-        f.write("   * @description %s\n" % note)
-        f.write("   */\n")
-        f.write("  %s: %s,\n" % (name, json.dumps(message)))
-    f.write("} as const;\n")
-    f.write("\n")
-    f.write("export interface DeprecationDescriptor {\n")
-    f.write("  milestone?: number;\n")
-    f.write("  chromeStatusFeature?: number;\n")
-    f.write("}\n")
-    f.write("\n")
-    f.write(
-        "export const DEPRECATIONS_METADATA: Partial<Record<string, DeprecationDescriptor>> = %s;\n"
-        % json.dumps(meta, sort_keys=True, indent=2))

package/scripts/build/generate_devtools_grd.py

@@ -1,123 +0,0 @@
-#!/usr/bin/env vpython3
-#
-# Copyright (C) 2011 Google Inc. All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are
-# met:
-#
-#         * Redistributions of source code must retain the above copyright
-# notice, this list of conditions and the following disclaimer.
-#         * 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.
-#         * Neither the name of Google Inc. 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
-# OWNER 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.
-"""Creates a grd file for packaging the inspector files."""
-
-
-import os
-import shlex
-import sys
-from xml.dom import minidom
-
-kDevToolsResourcePrefix = 'IDR_DEVTOOLS_'
-kGrdTemplate = '''<?xml version="1.0" encoding="UTF-8"?>
-<grit latest_public_release="0" current_release="1">
-  <outputs>
-    <output filename="grit/devtools_resources.h" type="rc_header">
-      <emit emit_type='prepend'></emit>
-    </output>
-    <output filename="grit/devtools_resources_map.cc" type="resource_file_map_source" />
-    <output filename="grit/devtools_resources_map.h" type="resource_map_header" />
-
-    <output filename="devtools_resources.pak" type="data_package" />
-  </outputs>
-  <release seq="1">
-    <includes>
-      <include name="COMPRESSED_PROTOCOL_JSON" file="${protocol_file}" use_base_dir="false" compress="brotli" type="BINDATA" skip_in_resource_map = "true"/>
-    </includes>
-  </release>
-</grit>
-'''
-
-
-class ParsedArgs:
-
-    def __init__(self, file_list, output_filename, compress):
-        self.file_list = file_list
-        file_list_file = open(file_list, 'r')
-        file_list_contents = file_list_file.read()
-        self.source_files = shlex.split(file_list_contents)
-        self.output_filename = output_filename
-        self.compress = compress
-
-
-def parse_args(argv):
-    # The arguments are of the format:
-    #   --file_list <input_file_list>
-    #   --output <output_file>
-    #   --compress
-    file_list_position = argv.index('--file_list')
-    output_position = argv.index('--output')
-    file_list = argv[file_list_position + 1]
-    compress = argv.count('--compress') > 0
-    return ParsedArgs(file_list, argv[output_position + 1], compress)
-
-
-def make_name_from_filename(filename):
-    return (filename.replace('/', '_').replace('\\', '_').replace('-', '_').replace('.', '_')).upper()
-
-
-def add_file_to_grd(grd_doc, relative_filename, compress):
-    includes_node = grd_doc.getElementsByTagName('includes')[0]
-    includes_node.appendChild(grd_doc.createTextNode('\n      '))
-
-    ext = os.path.splitext(relative_filename)[1]
-    new_include_node = grd_doc.createElement('include')
-    if compress and ext in ['.css', '.html', '.js', '.svg', '.json', '.md']:
-        new_include_node.setAttribute('file',
-                                      relative_filename + '.compressed')
-    else:
-        new_include_node.setAttribute('file', relative_filename)
-
-    new_include_node.setAttribute('name', make_name_from_filename(relative_filename))
-    new_include_node.setAttribute('resource_path', relative_filename)
-    new_include_node.setAttribute('type', 'BINDATA')
-    new_include_node.setAttribute('compress', 'false')
-    includes_node.appendChild(new_include_node)
-
-
-def main(argv):
-    parsed_args = parse_args(argv[1:])
-
-    doc = minidom.parseString(kGrdTemplate)
-
-    written_filenames = set()
-    for filename in parsed_args.source_files:
-        # Avoid writing duplicate relative filenames.
-        if filename in written_filenames:
-            raise Exception("Duplicate file detected: %s" % filename)
-        written_filenames.add(filename)
-        add_file_to_grd(doc, filename, parsed_args.compress)
-
-    with open(parsed_args.output_filename, 'wb') as output_file:
-        output_file.write(doc.toxml(encoding='UTF-8'))
-
-
-if __name__ == '__main__':
-    sys.exit(main(sys.argv))

package/scripts/build/generate_devtools_json.js

@@ -1,27 +0,0 @@
-// 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.
-
-const path = require('path');
-const {v5} = require('uuid');
-
-const {writeIfChanged} = require('./ninja/write-if-changed.js');
-
-const [, , outputLocation] = process.argv;
-
-const root = path.join(path.dirname(path.dirname(__dirname)), 'front_end');
-
-// We use a pre-generated v4 UUID for the namespace
-const NAMESPACE = '2ba62548-f4e9-11ef-9cd2-0242ac120002';
-
-// Generate a v5 UUID with the root path as name.
-const uuid = v5(root, NAMESPACE);
-
-// Construct and write the `devtools.json`.
-const devtools = {
-  workspace: {
-    root,
-    uuid,
-  },
-};
-writeIfChanged(outputLocation, JSON.stringify(devtools, null, 2));

package/scripts/build/generate_html_entrypoint.js

@@ -1,49 +0,0 @@
-// Copyright 2020 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.
-
-const fs = require('fs');
-const path = require('path');
-const yargs = require('yargs');
-const {hideBin} = require('yargs/helpers');
-
-const {writeIfChanged} = require('./ninja/write-if-changed.js');
-
-const {
-  template,
-  outDirectory,
-  entrypoints,
-} = yargs(hideBin(process.argv)).parseSync();
-
-if (!template) {
-  throw new Error(
-      'Must specify --template location with the location of the HTML entrypoint template.',
-  );
-}
-
-if (!outDirectory) {
-  throw new Error(
-      'Must specify --out-directory location where the outputs must live.',
-  );
-}
-
-if (!entrypoints) {
-  throw new Error('Must specify at least one entrypoint name.');
-}
-
-if (!Array.isArray(entrypoints)) {
-  throw new Error('Must specify multiple entrypoints as array');
-}
-
-const templateContent = fs.readFileSync(template, 'utf-8');
-
-for (const entrypoint of entrypoints) {
-  const rewrittenTemplateContent = templateContent.replace(
-      new RegExp('%ENTRYPOINT_NAME%', 'g'),
-      entrypoint,
-  );
-  writeIfChanged(
-      path.join(outDirectory, `${entrypoint}.html`),
-      rewrittenTemplateContent,
-  );
-}