closure-rs 0.0.1-alpha.0 → 0.0.1-alpha.1

package/LICENSES/THIRD_PARTY_RUST.md

@@ -13,8 +13,10 @@ Generated by `python3 scripts/third_party_licenses.py` from `Cargo.lock`; do not
 | hashbrown | 0.17.1 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT` |
 | indexmap | 2.14.0 | Apache-2.0 OR MIT | `LICENSE-APACHE`, `LICENSE-MIT` |
 | itoa | 1.0.18 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT` |
+| libmimalloc-sys | 0.1.49 | MIT | `LICENSE.txt`, `c_src/mimalloc/v2/LICENSE` |
 | libz-sys | 1.1.29 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT`, `src/zlib/LICENSE` |
 | memchr | 2.8.3 | Unlicense OR MIT | `COPYING`, `LICENSE-MIT`, `UNLICENSE` |
+| mimalloc | 0.1.52 | MIT | `LICENSE.txt` |
 | num-bigint | 0.4.8 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT` |
 | num-integer | 0.1.47 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT` |
 | num-traits | 0.2.19 | MIT OR Apache-2.0 | `LICENSE-APACHE`, `LICENSE-MIT` |
@@ -981,6 +983,67 @@ IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 DEALINGS IN THE SOFTWARE.
 ```
 
+## libmimalloc-sys 0.1.49
+
+License: MIT.
+Source: <https://crates.io/crates/libmimalloc-sys/0.1.49>.
+
+### `LICENSE.txt`
+
+```text
+Copyright 2019 Octavian Oncescu
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+```
+
+### `c_src/mimalloc/v2/LICENSE`: mimalloc (bundled C sources, Microsoft Corporation)
+
+```text
+MIT License
+
+Copyright (c) 2018-2025 Microsoft Corporation, Daan Leijen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## libz-sys 1.1.29
 
 License: MIT OR Apache-2.0.
@@ -1065,6 +1128,15 @@ Identical to `LICENSE-MIT` of aho-corasick 1.1.5 above.
 
 Identical to `UNLICENSE` of aho-corasick 1.1.5 above.
 
+## mimalloc 0.1.52
+
+License: MIT.
+Source: <https://crates.io/crates/mimalloc/0.1.52>.
+
+### `LICENSE.txt`
+
+Identical to `LICENSE.txt` of libmimalloc-sys 0.1.49 above.
+
 ## num-bigint 0.4.8
 
 License: MIT OR Apache-2.0.

package/LICENSES/headers.tsv

@@ -37,6 +37,7 @@ crates/cli/tests/command_line_runner_test.rs	59c1e91738bdc9a4	Apache-2.0	closure
 crates/cli/tests/common/mod.rs	322fc2ba37b98b96	Apache-2.0	-
 crates/cli/tests/compiler_define_test.rs	bb58833d12a9d166	Apache-2.0	closure:test/com/google/javascript/jscomp/CompilerTest.java
 crates/cli/tests/exception_golden_test.rs	322fc2ba37b98b96	Apache-2.0	-
+crates/cli/tests/fuzz_regression_test.rs	322fc2ba37b98b96	Apache-2.0	-
 crates/cli/tests/glob_golden_test.rs	322fc2ba37b98b96	Apache-2.0	-
 crates/cli/tests/java_io_test.rs	322fc2ba37b98b96	Apache-2.0	-
 crates/cli/tests/json_golden_test.rs	322fc2ba37b98b96	Apache-2.0	-
@@ -1309,7 +1310,7 @@ crates/testing/src/unit_recorder.rs	a5264e7469d2cb8d	Apache-2.0	own:UnitRecorder
 crates/testing/src/unit_test_utils.rs	a72f34ee1aa52ac8	Apache-2.0	closure:src/com/google/javascript/jscomp/testing/TestExternsBuilder.java; closure:test/com/google/javascript/jscomp/UnitTestUtils.java
 crates/testing/src/value.rs	322fc2ba37b98b96	Apache-2.0	-
 crates/testing/tests/access_controls_records.rs	afb9e4e6a8c42f31	Apache-2.0	own:oracle/replay/src/com/google/javascript/jscomp/ReplayMain.java; closure:test/com/google/javascript/jscomp/CheckAccessControlsTest.java; closure:test/com/google/javascript/jscomp/CheckAccessControlsOldSyntaxTest.java; closure:test/com/google/javascript/jscomp/ImplicitNullabilityCheckTest.java; closure:test/com/google/javascript/jscomp/lint/CheckNestedNamesTest.java; closure:test/com/google/javascript/jscomp/lint/CheckArrayWithGoogObjectTest.java
-crates/testing/tests/alpha_integration_records.rs	205944c4d803c7aa	Apache-2.0	own:oracle/replay/src/com/google/javascript/jscomp/ReplayMain.java; closure:test/com/google/javascript/jscomp/ClosureUnawarePhaseOptimizerTest.java; closure:test/com/google/javascript/jscomp/ProcessClosureProvidesAndRequiresTest.java; closure:test/com/google/javascript/jscomp/integration/ClosurePrimitivesIntegrationTest.java; closure:test/com/google/javascript/jscomp/MultiPassTest.java; closure:test/com/google/javascript/jscomp/integration/IntegrationTest.java; closure:test/com/google/javascript/jscomp/integration/CommonJSIntegrationTest.java
+crates/testing/tests/alpha_integration_records.rs	d6f209fe12d47b30	Apache-2.0	own:oracle/replay/src/com/google/javascript/jscomp/ReplayMain.java; closure:test/com/google/javascript/jscomp/integration/IntegrationTest.java; closure:test/com/google/javascript/jscomp/integration/AdvancedOptimizationsIntegrationTest.java; closure:test/com/google/javascript/jscomp/integration/ClosureIntegrationTest.java; closure:test/com/google/javascript/jscomp/integration/GetterAndSetterIntegrationTest.java; closure:test/com/google/javascript/jscomp/integration/ClosurePrimitivesIntegrationTest.java; closure:test/com/google/javascript/jscomp/MultiPassTest.java; closure:test/com/google/javascript/jscomp/TranspileAndOptimizeClosureUnawareTest.java; closure:test/com/google/javascript/jscomp/integration/ClosureUnawareCodeIntegrationTest.java; closure:test/com/google/javascript/jscomp/ClosureUnawarePhaseOptimizerTest.java; closure:test/com/google/javascript/jscomp/ProcessClosureProvidesAndRequiresTest.java; closure:test/com/google/javascript/jscomp/integration/CommonJSIntegrationTest.java
 crates/testing/tests/check_goog_js_import_test.rs	71079790fbb43f4e	Apache-2.0	closure:test/com/google/javascript/jscomp/CheckGoogJsImportTest.java; own:oracle/replay/src/com/google/javascript/jscomp/ReplayDsl.java
 crates/testing/tests/closure_optimizations_records.rs	243e5cf4a7ef5dd1	Apache-2.0	own:oracle/replay/src/com/google/javascript/jscomp/ReplayMain.java; closure:test/com/google/javascript/jscomp/ReplaceTogglesTest.java; closure:test/com/google/javascript/jscomp/ClosureOptimizePrimitivesTest.java; closure:test/com/google/javascript/jscomp/AngularPassTest.java; closure:test/com/google/javascript/jscomp/GenerateExportsTest.java; closure:test/com/google/javascript/jscomp/ReplaceIdGeneratorsTest.java; closure:test/com/google/javascript/jscomp/ClosureCodeRemovalTest.java; closure:test/com/google/javascript/jscomp/ReplaceCssNamesTest.java; closure:test/com/google/javascript/jscomp/ProcessDefinesTest.java
 crates/testing/tests/closure_rewrite_module_records.rs	8a7b69628265810e	Apache-2.0	own:oracle/replay/src/com/google/javascript/jscomp/ReplayMain.java; closure:test/com/google/javascript/jscomp/CheckGoogJsImportTest.java; closure:test/com/google/javascript/jscomp/RewriteGoogJsImportsTest.java; closure:test/com/google/javascript/jscomp/MissingProvideTest.java; closure:test/com/google/javascript/jscomp/CheckMissingRequiresTest.java; closure:test/com/google/javascript/jscomp/ClosureRewriteModuleTest.java

package/NOTICE

@@ -216,7 +216,9 @@ Binary distributions
 
   The closure-rs executable also contains Rust crates from crates.io (Cargo.lock) and the Rust
   standard library, each under its own license (MIT, Apache-2.0, Unlicense, Zlib), which the
-  binary distribution reproduces with the files above: LICENSES/THIRD_PARTY_RUST.md
-  (THIRD_PARTY_RUST.md in the npm platform packages) lists every linked crate with its version,
+  binary distribution reproduces with the files above: LICENSES/THIRD_PARTY_RUST.md (also in
+  the npm package) lists every linked crate with its version,
   license and full license texts, including zlib's for the copy libz-sys builds from source when
-  no system zlib is used. scripts/third_party_licenses.py writes it from Cargo.lock.
+  no system zlib is used, and the MIT notice of Microsoft's mimalloc allocator, whose C sources
+  libmimalloc-sys compiles into the binary. scripts/third_party_licenses.py writes it from
+  Cargo.lock.

package/README.md

@@ -5,8 +5,8 @@ A Rust port of the [Closure Compiler](https://github.com/google/closure-compiler
 [`google-closure-compiler`](https://www.npmjs.com/package/google-closure-compiler) package
 (matched against version 20261005.0.0). Not affiliated with or published by Google.
 
-The compiler is a native binary. npm installs the one for your system from an optional
-dependency (`closure-rs-linux-x64` or `closure-rs-win32-x64` for now); no Java is needed.
+The compiler is a native binary. The package carries one per supported system (Linux x64 and
+Windows x64 for now, under `bin/<platform>-<arch>/`) and runs the one for yours; no Java is needed.
 
 ## Switching from google-closure-compiler
 
@@ -14,7 +14,7 @@ Change only `package.json`:
 
 ```json
 "devDependencies": {
-  "google-closure-compiler": "npm:closure-rs@0.0.1-alpha.0"
+  "google-closure-compiler": "npm:closure-rs@alpha"
 }
 ```
 
@@ -89,8 +89,9 @@ The wrapper runs, in this order:
 
 1. the file named by the environment variable `CLOSURE_RS_BINARY`, if set (for testing a local
    build);
-2. `bin/closure-rs` from the optional package `closure-rs-<platform>-<arch>`;
-3. `closure-rs` on `PATH`.
+2. the binary bundled in this package, `bin/<platform>-<arch>/closure-rs[.exe]`;
+3. `bin/closure-rs` from a separate package `closure-rs-<platform>-<arch>`, if installed;
+4. `closure-rs` on `PATH`.
 
 ### Java-only parts
 

package/index.d.cts

@@ -390,14 +390,14 @@ export interface CompilerFlags {
    * File where the encoded parameters created by Production Instrumentation are mapped to their pre-encoded values. The %outname% placeholder will expand to the name of the output file that the source map corresponds to. Must be used in tandem with --instrument_for_coverage_option=PRODUCTION
    *
    * `--instrument_mapping_report`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   instrument_mapping_report?: string;
   /**
    * File where the encoded parameters created by Production Instrumentation are mapped to their pre-encoded values. The %outname% placeholder will expand to the name of the output file that the source map corresponds to. Must be used in tandem with --instrument_for_coverage_option=PRODUCTION
    *
    * `--instrument_mapping_report`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `instrument_mapping_report`.
    */
   instrumentMappingReport?: string;
@@ -786,14 +786,14 @@ export interface CompilerFlags {
    * Sets file to output in-progress typedAST format. DO NOT USE!
    *
    * `--typed_ast_output_file`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: usage says "DO NOT USE").
+   * Outside the closure-rs port scope (docs/PORTING.md §2: usage says "DO NOT USE").
    */
   typed_ast_output_file?: string;
   /**
    * Sets file to output in-progress typedAST format. DO NOT USE!
    *
    * `--typed_ast_output_file`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: usage says "DO NOT USE").
+   * Outside the closure-rs port scope (docs/PORTING.md §2: usage says "DO NOT USE").
    * Same flag as `typed_ast_output_file`.
    */
   typedAstOutputFile?: string;
@@ -888,14 +888,14 @@ export interface CompilerFlags {
    * Which version of Polymer is being used (1 or 2).
    *
    * `--polymer_version`. Category: Library and Framework Specific.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
    */
   polymer_version?: IntFlag;
   /**
    * Which version of Polymer is being used (1 or 2).
    *
    * `--polymer_version`. Category: Library and Framework Specific.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
    * Same flag as `polymer_version`.
    */
   polymerVersion?: IntFlag;
@@ -903,14 +903,14 @@ export interface CompilerFlags {
    * Enable Chrome-specific options for handling cr.* functions.
    *
    * `--chrome_pass`. Default: `false`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
    */
   chrome_pass?: BooleanFlag;
   /**
    * Enable Chrome-specific options for handling cr.* functions.
    *
    * `--chrome_pass`. Default: `false`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
    * Same flag as `chrome_pass`.
    */
   chromePass?: BooleanFlag;
@@ -918,14 +918,14 @@ export interface CompilerFlags {
    * Rewrite J2CL output to be compiler-friendly if enabled (ON or AUTO). Options:OFF, ON, AUTO(default)
    *
    * `--j2cl_pass`. Default: `AUTO`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    */
   j2cl_pass?: string;
   /**
    * Rewrite J2CL output to be compiler-friendly if enabled (ON or AUTO). Options:OFF, ON, AUTO(default)
    *
    * `--j2cl_pass`. Default: `AUTO`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    * Same flag as `j2cl_pass`.
    */
   j2clPass?: string;
@@ -934,7 +934,7 @@ export interface CompilerFlags {
    *
    * `--remove_j2cl_asserts`. Default: `true`. Hidden in --help.
    * Takes no value: pass null to emit the bare flag.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    */
   remove_j2cl_asserts?: null;
   /**
@@ -942,7 +942,7 @@ export interface CompilerFlags {
    *
    * `--remove_j2cl_asserts`. Default: `true`. Hidden in --help.
    * Takes no value: pass null to emit the bare flag.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    * Same flag as `remove_j2cl_asserts`.
    */
   removeJ2clAsserts?: null;
@@ -1350,14 +1350,14 @@ export interface CompilerFlags {
    * Enable code instrumentation to perform code coverage analysis. Options are: 1. NONE (default) 2. LINE - Instrument code by line. 3. BRANCH - Instrument code by branch. 4. PRODUCTION - Function Instrumentation on compiled JS code.
    *
    * `--instrument_for_coverage_option`. Default: `NONE`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   instrument_for_coverage_option?: string;
   /**
    * Enable code instrumentation to perform code coverage analysis. Options are: 1. NONE (default) 2. LINE - Instrument code by line. 3. BRANCH - Instrument code by branch. 4. PRODUCTION - Function Instrumentation on compiled JS code.
    *
    * `--instrument_for_coverage_option`. Default: `NONE`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `instrument_for_coverage_option`.
    */
   instrumentForCoverageOption?: string;
@@ -1365,14 +1365,14 @@ export interface CompilerFlags {
    * Name of the global array used by production instrumentation. The array name should be declared as an extern so it is not renamed by the compiler. A function that parses the global array should also be included. This flag is to be used in tandem with --instrument_code=PRODUCTION
    *
    * `--production_instrumentation_array_name`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   production_instrumentation_array_name?: string;
   /**
    * Name of the global array used by production instrumentation. The array name should be declared as an extern so it is not renamed by the compiler. A function that parses the global array should also be included. This flag is to be used in tandem with --instrument_code=PRODUCTION
    *
    * `--production_instrumentation_array_name`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `production_instrumentation_array_name`.
    */
   productionInstrumentationArrayName?: string;

package/index.d.ts

@@ -390,14 +390,14 @@ export interface CompilerFlags {
    * File where the encoded parameters created by Production Instrumentation are mapped to their pre-encoded values. The %outname% placeholder will expand to the name of the output file that the source map corresponds to. Must be used in tandem with --instrument_for_coverage_option=PRODUCTION
    *
    * `--instrument_mapping_report`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   instrument_mapping_report?: string;
   /**
    * File where the encoded parameters created by Production Instrumentation are mapped to their pre-encoded values. The %outname% placeholder will expand to the name of the output file that the source map corresponds to. Must be used in tandem with --instrument_for_coverage_option=PRODUCTION
    *
    * `--instrument_mapping_report`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `instrument_mapping_report`.
    */
   instrumentMappingReport?: string;
@@ -786,14 +786,14 @@ export interface CompilerFlags {
    * Sets file to output in-progress typedAST format. DO NOT USE!
    *
    * `--typed_ast_output_file`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: usage says "DO NOT USE").
+   * Outside the closure-rs port scope (docs/PORTING.md §2: usage says "DO NOT USE").
    */
   typed_ast_output_file?: string;
   /**
    * Sets file to output in-progress typedAST format. DO NOT USE!
    *
    * `--typed_ast_output_file`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: usage says "DO NOT USE").
+   * Outside the closure-rs port scope (docs/PORTING.md §2: usage says "DO NOT USE").
    * Same flag as `typed_ast_output_file`.
    */
   typedAstOutputFile?: string;
@@ -888,14 +888,14 @@ export interface CompilerFlags {
    * Which version of Polymer is being used (1 or 2).
    *
    * `--polymer_version`. Category: Library and Framework Specific.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
    */
   polymer_version?: IntFlag;
   /**
    * Which version of Polymer is being used (1 or 2).
    *
    * `--polymer_version`. Category: Library and Framework Specific.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Polymer area; configures the Polymer passes (PolymerPass and friends)).
    * Same flag as `polymer_version`.
    */
   polymerVersion?: IntFlag;
@@ -903,14 +903,14 @@ export interface CompilerFlags {
    * Enable Chrome-specific options for handling cr.* functions.
    *
    * `--chrome_pass`. Default: `false`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
    */
   chrome_pass?: BooleanFlag;
   /**
    * Enable Chrome-specific options for handling cr.* functions.
    *
    * `--chrome_pass`. Default: `false`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: Chrome area; configures the Chrome-specific passes (ChromePass)).
    * Same flag as `chrome_pass`.
    */
   chromePass?: BooleanFlag;
@@ -918,14 +918,14 @@ export interface CompilerFlags {
    * Rewrite J2CL output to be compiler-friendly if enabled (ON or AUTO). Options:OFF, ON, AUTO(default)
    *
    * `--j2cl_pass`. Default: `AUTO`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    */
   j2cl_pass?: string;
   /**
    * Rewrite J2CL output to be compiler-friendly if enabled (ON or AUTO). Options:OFF, ON, AUTO(default)
    *
    * `--j2cl_pass`. Default: `AUTO`. Hidden in --help.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    * Same flag as `j2cl_pass`.
    */
   j2clPass?: string;
@@ -934,7 +934,7 @@ export interface CompilerFlags {
    *
    * `--remove_j2cl_asserts`. Default: `true`. Hidden in --help.
    * Takes no value: pass null to emit the bare flag.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    */
   remove_j2cl_asserts?: null;
   /**
@@ -942,7 +942,7 @@ export interface CompilerFlags {
    *
    * `--remove_j2cl_asserts`. Default: `true`. Hidden in --help.
    * Takes no value: pass null to emit the bare flag.
-   * Outside the closure-rs port scope (PORT_SPEC §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: J2CL area; configures the J2CL passes (J2clPass, J2clAssertRemovalPass, ...)).
    * Same flag as `remove_j2cl_asserts`.
    */
   removeJ2clAsserts?: null;
@@ -1350,14 +1350,14 @@ export interface CompilerFlags {
    * Enable code instrumentation to perform code coverage analysis. Options are: 1. NONE (default) 2. LINE - Instrument code by line. 3. BRANCH - Instrument code by branch. 4. PRODUCTION - Function Instrumentation on compiled JS code.
    *
    * `--instrument_for_coverage_option`. Default: `NONE`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   instrument_for_coverage_option?: string;
   /**
    * Enable code instrumentation to perform code coverage analysis. Options are: 1. NONE (default) 2. LINE - Instrument code by line. 3. BRANCH - Instrument code by branch. 4. PRODUCTION - Function Instrumentation on compiled JS code.
    *
    * `--instrument_for_coverage_option`. Default: `NONE`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `instrument_for_coverage_option`.
    */
   instrumentForCoverageOption?: string;
@@ -1365,14 +1365,14 @@ export interface CompilerFlags {
    * Name of the global array used by production instrumentation. The array name should be declared as an extern so it is not renamed by the compiler. A function that parses the global array should also be included. This flag is to be used in tandem with --instrument_code=PRODUCTION
    *
    * `--production_instrumentation_array_name`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    */
   production_instrumentation_array_name?: string;
   /**
    * Name of the global array used by production instrumentation. The array name should be declared as an extern so it is not renamed by the compiler. A function that parses the global array should also be included. This flag is to be used in tandem with --instrument_code=PRODUCTION
    *
    * `--production_instrumentation_array_name`.
-   * Outside the closure-rs port scope (PORT_SPEC §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
+   * Outside the closure-rs port scope (docs/PORTING.md §2: instrumentation area; configures code instrumentation (jscomp/instrumentation/: CoverageInstrumentationPass, ProductionCoverageInstrumentationCallback)).
    * Same flag as `production_instrumentation_array_name`.
    */
   productionInstrumentationArrayName?: string;

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "closure-rs",
-  "version": "0.0.1-alpha.0",
+  "version": "0.0.1-alpha.1",
   "description": "Rust port of the Closure Compiler CLI. Not affiliated with or published by Google.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Smrtnyk/closure-rs.git",
+    "directory": "npm/closure-rs"
+  },
+  "homepage": "https://github.com/Smrtnyk/closure-rs#readme",
+  "bugs": {
+    "url": "https://github.com/Smrtnyk/closure-rs#bugs-and-issues"
+  },
   "license": "Apache-2.0 AND (MPL-1.1 OR GPL-2.0-or-later) AND GPL-2.0-only WITH Classpath-exception-2.0 AND BSD-3-Clause AND MIT AND Unicode-DFS-2016 AND dtoa",
   "type": "module",
   "main": "index.js",