Merge remote-tracking branch 'src/main' into sync

Author: michelle192837

.gitignore

@@ -0,0 +1,25 @@
+*.pyc
+*.swp
+*.sublime-project
+*.sublime-workspace
+*~
+/bazel-*
+/_artifacts
+/_output
+node_modules/
+.DS_Store
+# Files generated by JetBrains IDEs, e.g. IntelliJ IDEA
+.idea/
+.ijwb/
+*.iml
+.vscode/*
+/vendor/
+# profiling outputs
+benchmark.test
+mem.out
+cpu.out
+## terraform output
+*.tfvars
+*.terraform/
+prow/oss/terraform/state.tf
+*.terraform.lock.hcl

web/.editorconfig

@@ -0,0 +1,29 @@
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# editorconfig.org
+
+root = true
+
+
+[*]
+
+# Change these settings to your own preference
+indent_style = space
+indent_size = 2
+
+# We recommend you to keep these unchanged
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[*.{html,js,md}]
+block_comment_start = /**
+block_comment = *
+block_comment_end = */

web/.eslintignore

@@ -0,0 +1,27 @@
+## editors
+/.idea
+/.vscode
+
+## system files
+.DS_Store
+
+## npm
+/node_modules/
+/npm-debug.log
+
+## testing
+/coverage/
+
+## temp folders
+/.tmp/
+
+# build
+/_site/
+/dist/
+/out-tsc/
+
+storybook-static
+custom-elements.json
+
+# generated files
+/src/gen/**

web/.gcloudignore

@@ -0,0 +1,6 @@
+.gcloudignore
+.git
+.gitignore
+/node_modules/
+/coverage/
+/out-tsc/

web/.gitignore

@@ -0,0 +1,23 @@
+## editors
+/.idea
+/.vscode
+
+## system files
+.DS_Store
+
+## npm
+/node_modules/
+/npm-debug.log
+
+## testing
+/coverage/
+
+## temp folders
+/.tmp/
+
+# build
+/_site/
+/dist/
+/out-tsc/
+
+storybook-static

web/.storybook/main.js

@@ -0,0 +1,3 @@
+module.exports = {
+  stories: ['../**/out-tsc/stories/*.stories.{js,md,mdx}'],
+};

web/.storybook/server.mjs

@@ -0,0 +1,12 @@
+import { storybookPlugin } from '@web/dev-server-storybook';
+import baseConfig from '../web-dev-server-local.config.mjs';
+
+export default /** @type {import('@web/dev-server').DevServerConfig} */ ({
+  ...baseConfig,
+  open: '/',
+  appIndex: null,
+  plugins: [
+    storybookPlugin({ type: 'web-components' }),
+    ...baseConfig.plugins,
+  ],
+});

web/README.md

@@ -0,0 +1,41 @@
+## TestGrid UI
+
+[![Built with open-wc recommendations](https://img.shields.io/badge/built%20with-open--wc-blue.svg)](https://github.com/open-wc)
+
+Testgrid frontend code uses Lit elements and is written in Typescript. `tsconfig.json` specifies where and how the Typescript will be compiled to Javascript.
+More info about Lit and Typescript can be found in [Lit docs](https://lit.dev/) and [TS docs](https://www.typescriptlang.org/) respectively.
+
+## Development
+Local development is done with the help of [Web Dev Server](https://modern-web.dev/docs/dev-server/overview/). Web dev server configurations are defined in `web-dev-server-{env}.config.mjs` file. Depending on the config, frontend will render from the data from either fake or prod API. 
+
+To see fake data, run `npm run start:local`. To see prod data, run `npm run start:k8s`. More info in the [Scripts](#scripts) section below.
+
+## Testing
+Testing relies on [Web Test Runner](https://modern-web.dev/docs/test-runner/overview/) with the configuration defined in `web-test-runner.config.mjs`. Testing is currently happening across the fake data provided by `json-server`.
+
+To run the tests, run `npm run test`. More info in the [Scripts](#scripts) section below.
+
+## Scripts
+
+Most scripts are in `npm run` commands.
+
+- `start:k8s` runs your app for development, reloading on file changes. Fetches the data from external k8s Testgrid API instance - actual data.
+- `start:local` runs your app for development, reloading on file changes. Spins up a local `json-server` which serves the data from `src/fake-api/data.json` file, which is then rendered in frontend.
+- `start:build` runs your app after it has been built using the build command
+- `build` builds your app and outputs it in your `dist` directory
+- `test` runs your test suite with Web Test Runner. Relies on the fake data provided by `json-server`.
+- `lint` runs the linter for your project
+
+## Pulling from upstream
+
+Upstream proto definitions can be generated by running `pb/bump-protos.sh`
+
+## Configs and files
+- Frontend code is located in `src` dir.
+- Stories for demoing are located in `stories` dir.
+- Tests are located in `test` dir.
+- `package.json` defines all the `npm run ...` commands as well as libraries, dependencies and their versions.
+- `tsconfig.json` defines how and where will the .ts files compile.
+- `web-dev-server-*.config.mjs` defines configuration parameters for the web dev server.
+- `web-test-runner.config.mjs` defined configuration parameters for the web test runner.
+- `rollup.config.js` defines how the code will be built and bundled.

web/WORKSPACE

@@ -0,0 +1 @@
+# TODO(chases2): Build Typescript with Bazel

web/app.yaml

@@ -0,0 +1,10 @@
+runtime: python39
+
+handlers:
+  - url: /
+    static_files: dist/index.html
+    upload: dist/index.html
+
+  - url: /(.*)
+    static_files: dist/\1
+    upload: dist/(.*)