Populate repo

Author: amcasey

.gitignore

@@ -0,0 +1,6 @@
+*.js
+*.map
+*.d.ts
+node_modules
+*.tsbuildinfo
+*.tgz

.npmignore

@@ -0,0 +1,5 @@
+src
+package-lock.json
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
+*.map

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Building
+
+To build, run `npm ci` to download the required packages and `npm run build` to compile.

README.md

@@ -1,33 +1,23 @@
-# Project
+# @typescript/analyze-trace
+Tool for analyzing the output of `tsc --generateTrace` automatically, rather than following the steps [here](https://github.com/microsoft/TypeScript/wiki/Performance-Tracing).
 
-> This repo has been populated by an initial template to help get you started. Please
-> make sure to update the content to build a great experience for community-building.
+Note: The goal is to identify clear-cut hot-spots and provide enough context to extract a small repro.
+The repro can then be used as the basis of a bug report or a starting point for manual code inspection or profiling.
 
-As the maintainer of this project, please make a few updates:
+## Usage
 
-- Improving this README.MD file to provide a great experience
-- Updating SUPPORT.MD with content about this project's support experience
-- Understanding the security reporting process in SECURITY.MD
-- Remove this section from the README
+First, build your project with `--generateTrace traceDir`
 
-## Contributing
+For a sorted list of compilation hot-spots, run `npx analyze-trace traceDir`
 
-This project welcomes contributions and suggestions. Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+For a simplified view of a types file (useful when investigating an individual trace), run `npx simplify-trace-types traceDir\types.json output_path`
 
-When you submit a pull request, a CLA bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
-
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+To pretty-print individual types from a types file (faster than processing the entire file), run `npx print-types traceDir\types.json id+`
 
 ## Trademarks
 
-This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
-trademarks or logos is subject to and must follow 
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
+trademarks or logos is subject to and must follow
 [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 Any use of third-party trademarks or logos are subject to those third-party's policies.

SUPPORT.md

@@ -1,25 +1,11 @@
-# TODO: The maintainer of this repo has not yet edited this file
-
-**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
-
-- **No CSS support:** Fill out this template with information about how to file issues and get help.
-- **Yes CSS support:** Fill out an intake form at [aka.ms/spot](https://aka.ms/spot). CSS will work with/help you to determine next steps. More details also available at [aka.ms/onboardsupport](https://aka.ms/onboardsupport).
-- **Not sure?** Fill out a SPOT intake as though the answer were "Yes". CSS will help you decide.
-
-*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
-
 # Support
 
-## How to file issues and get help 
+## How to file issues and get help
 
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
-issues before filing new issues to avoid duplicates. For new issues, file your bug or 
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing
+issues before filing new issues to avoid duplicates. For new issues, file your bug or
 feature request as a new Issue.
 
-For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
-FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
-CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
-
-## Microsoft Support Policy 
+## Microsoft Support Policy
 
 Support for this **PROJECT or PRODUCT** is limited to the resources listed above.

azure-pipelines.yml

@@ -0,0 +1,29 @@
+pr:
+- main
+
+pool:
+ name: VSEngSS-MicroBuild2019-1ES
+
+variables:
+ TeamName: TypeScript
+
+steps:
+- task: NuGetToolInstaller@1
+ inputs:
+ versionSpec: '5.x'
+- task: CredScan@3
+- task: PoliCheck@2
+- task: AntiMalware@4
+- task: PublishSecurityAnalysisLogs@3
+- task: PostAnalysis@2
+
+- task: NodeTool@0
+ inputs:
+ versionSpec: '14.x'
+ displayName: 'Install Node.js'
+- script: |
+ npm ci
+ npm run build
+ displayName: 'npm install and build'
+
+- task: MicroBuildCleanup@1

bin/analyze-trace

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/analyze-trace-dir.js')

bin/print-trace-types

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/print-types.js')

bin/simplify-trace-types

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/simplify-types-file.js')