{"_id":"@connectiv-ms/conflux","_rev":"7-9b7bc712f36bf163b048a882875d695c","name":"@connectiv-ms/conflux","dist-tags":{"beta":"1.2.6-rc.0","latest":"1.2.13"},"versions":{"1.2.4-rc.0":{"name":"@connectiv-ms/conflux","version":"1.2.4-rc.0","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.4-rc.0","_nodeVersion":"18.14.1","_npmVersion":"9.3.1","dist":{"integrity":"sha512-FBYREIGl6qOI38HkYZDXxEiaE7j5Wosa14hW3sjLr32Esg39kB4A9fHfvIthU9JoGpG+BFP3b5xzsXLNx/LYYw==","shasum":"db46ec1148467b76ca477c95c6e0fa0c25a23368","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.4-rc.0.tgz","fileCount":41,"unpackedSize":2996807,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHO8BUTLHwTG8r8Iq5HjxRHGuTQZCXg0fgeENzlb2ki1AiA0v+Sajo+Hbi5CMMV8FmnZHUmmvAExf6Y/RB1EexWptA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj/jkCACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoUrw//fYbxqNhEFmDM6CVgpdROL108vGbvIugS4xIUSb2XcS1ve58M\r\nAT62wH1T0Smy9Qk1mJoaSS39MuBulBhYpSxlOmR0vWAEoJc04w9WXHn1Nkr0\r\nGh+IyZmiK3zJUM7vmFcUVAyzWmK3Vv50C2LKfgZBdK13tVtW6NAkkOQJQfsm\r\npyggZlsK3uYz+rOfLSb94iWR+28oc9vQOpyGAMRVVqlUrU5OCZ7GJ0/pLFvC\r\nOSTW6gecSZVcxUYMpXSn7OsGHE9t2qWvqRHPYPy05eufA6GanDdunBoEwy7u\r\ngoHihdlgQdXGOZxfL55EoFmD/dzuxWOFGwt8a4unsoKTbiH8i8K9qopuvIhn\r\ny52+CgfEgGywIrkt0WDTtfEE3CvUCNlmILpiEejnv8B/KXfSx2v15zef3+09\r\nbvz3HQR513U8E0XlAGnaiAhkC9mfwsP8P0kKwT0nf3ZV6vP6eeZ4FJWB14aG\r\nH9lFyDbp2YPRAAr3/KVosziOH8ln35tbqB2Ndb0i2l7Npj7C06o0JsqnFSQg\r\nJvrSIDMsuihZETyLBMPhAb2DdYuy8jIf84Fxr/9ljLEcINBKUBrntiPLSaCz\r\nawUMTDvZkOB7b0GLppskTxgdEVElxkMYJBO7IMrFLLCYfkz9EBVqyXFzHbFT\r\ngZJpdCMUtR/La6/to9auU51CpQcSRNMnJG0=\r\n=EAF8\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.4-rc.0_1677605122319_0.6339190763377667"},"_hasShrinkwrap":false},"1.2.5-rc.0":{"name":"@connectiv-ms/conflux","version":"1.2.5-rc.0","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"readme":"# JavaScriptMerger\r\n\r\n## Table of Contents\r\n- [JavaScriptMerger](#javascriptmerger)\r\n  - [Table of Contents](#table-of-contents)\r\n  - [Usage](#usage)\r\n    - [Declaring Dependencies](#declaring-dependencies)\r\n    - [Executing the Tool](#executing-the-tool)\r\n      - [Arguments](#arguments)\r\n      - [Options](#options)\r\n  - [Installation](#installation)\r\n\r\n## Usage\r\n\r\nThe JavaScriptMerger is the first tool in the legacy JS Buildchain at connectiv.\r\nIt will make sure, that all of the source files end up in the right output\r\ndirectory and resolve all valid [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) in JS files that it\r\nfinds along the way.\r\n\r\nThe merging is required to avoid issues with the unordered loading of webresources\r\nin dynamics. Scripts that rely on their dependencies to be loaded before they\r\nfirst may run into issues if the dependencies are not yet fetched. To counteract\r\nthis, all dependencies are bundled together with the script in a single file.\r\n\r\nThe JavaScriptMerger also handles *.htm*, *.html* and *.css* files, also these\r\nare simply copied to the output directory.\r\n\r\n### Declaring Dependencies\r\n\r\nInside of JS files, you can use [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) like this:\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\"/>\r\n```\r\n\r\nIf you need to include a triple-slash directive that does not need merging, \r\nyou can add an `ignoreMerge=\"true\"` attribute to the reference.\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\" ignoreMerge=\"true\"/>\r\n```\r\n\r\nBe aware, that there are a couple of caveats:\r\n- You can only link to other JS files.\r\n- References will only be resolved in your root script, meaning that if you declare\r\n  a reference inside of a script that is a dependency, it will not be resolved.\r\n  There is an option (`-recursiveResolution`) to change this behavior after version 1.1.\r\n- Reference paths will by default be resolved according to the `<SourceDirectory>`.\r\n  This behavior can be overridden with the option `-relativeReferences`. This may\r\n  become the default going forward, after it has been proven, that this behavior does not \r\n  cause unwanted breaking side-effects in legacy projects.\r\n\r\n### Executing the Tool\r\n\r\nYou can run the tool through a terminal using the following syntax\r\n>`Connectiv.JavaScriptMerger.exe <SourceDirectory> <OutputDirectory> [Options]`\r\n\r\nYou may use arguments and options to alter the default behavior.\r\n>`Connectiv.JavaScriptMerger.exe ./Scripts/src ./Scripts/bin/ -v -recursiveResolution -relativeReferences`\r\n\r\n>`Connectiv.JavaScriptMerger.exe -legacy`\r\n\r\n\r\n#### Arguments\r\n\r\n| Argument | Position | Required | Description | Default |\r\n| - | - | - | - | - |\r\n| ```<SourceDirectory>``` | 1 | Optional | Path to folder where the script files are located.<br> *Only files in this folder are taken into account.<br>Files in nested folders can only be addressed through references.* | `Scripts` |\r\n| ```<OutputDirectory>``` | 2 | Optional | Path to the folder where the output files should be placed.<br>*Be aware that using this argument makes the arguments with a lower position required.* | `Scripts/bin/Debug/Debug` |\r\n\r\n#### Options\r\n\r\nThe tool does not necessarily need options to run, but if you need to override\r\nthe default behavior, you can do so by supplying the options described in the\r\ntable below. Some options offer a shorthand, which can be used via \r\n`-x <value>`. The full option name can be supplied via `-fullName <value>`. For\r\nboolean options, the value can be omitted.\r\n\r\n| Option | Shorthand | Type | Description | Default |\r\n| - | - | - | - | - |\r\n| `verbose` | `v` | `boolean` | Will print detailed information for each processed file. | `false` |\r\n| `legacy` |  | `boolean` | In case the new version causes any issues, you can run the legacy v1.0 version instead. | `false` |\r\n| `recursiveResolution` |  | `boolean` | By default, dependencies are only resolved for the top-level scripts. This enables the resolution of dependencies of dependencies. | `false` |\r\n| `relativeReferences` |  | `boolean` | By default, dependencies are always resolved according to the `<SourceDirectory>`. Passing this flag, will base the resolution on the path of the currently processed file.<br>**This might change to default behavior if it can be proven that due to the single-level resolution this problem will never occur.** | `false` |\r\n\r\n## Installation\r\n\r\n### Nuget\r\n### dotnet tool\r\n### NPM","readmeFilename":"README.md","_id":"@connectiv-ms/conflux@1.2.5-rc.0","_nodeVersion":"18.14.1","_npmVersion":"9.3.1","dist":{"integrity":"sha512-6TrB3zi6xzHRLyBmPcBczAGTDZ9pJiiIkMxthkHJt+Rr3GoYBfFgSRskvg3McnioHlWBe5BZKjJlrrwVPraAvQ==","shasum":"e08ebef140b94589f59bbf828b9e4d27dc3aefc6","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.5-rc.0.tgz","fileCount":41,"unpackedSize":2996807,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDCh8TQ9pRTBfTFYh6INCE7yza+Gl7p8052VxRtmUQVXwIhAPLOWbiH4ElmllgkXRg+lC/KFAorPxiBdw+wg6xnbTmE"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj/ynsACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp1DQ//e/uGzLk1nCLuq62qZSITeqZWGqjwDnGDiBOIvZc4x1lqB9fN\r\nAEspGxMiQ0V0XuAVbtEV1X4drOR7//DPchyTeh1V2y7buSI9RhxqVZ9CiHDK\r\nh6pAktZHKOIEAuWLdtmLwb4MTGd76YorMXUeBhrYW49y7R2p6FT4muYS1ljh\r\nH1KXzuEfxHul0+7tx5MJSO11F3iQTXLrjO0gkrSvCzS1nHjrn1HZYM7Fb6xW\r\nyKOR0iUumaoXMJj6Y+E6VOkyOHBU6o9ZmnrBJ4DrOtQuodBmLnOsAB1ayKJO\r\nMvDRumX6KEaGzf0ng0f1zT+glut97UoZWfPNc8Zx3fRHhkCuy3uWS1u0vtZn\r\nTGBEqVh2nrMbOnwO0vFUoGecSxcCqefLNUj5i7dyv/iFqetpw4yWoaWAjd1B\r\nph9OTQsTIny3wNBF+SSRdyPC/IGvkUzchBNfgSmTl/Adw9M5X7CYYKGWzKpJ\r\nF9MKdyUwyJ82hxIJRHg7ORZ/twUHF/oPL+o8F9zZ0SmkCyuWw3Pyv8quAp3P\r\nesNmrV3+aNdts7znydsX1NYKz1nRhNir/uVoifTEfRR88PgV6YqXUStBBu8r\r\nvwFUDeeeHuufPzyInPhemPFw6S6iqKKvS31vwDMFer3wrNXcs6yjoTawJCsE\r\n4qyzDH5fvAV6yp3sRmgoY71hmw9eNI7l6ew=\r\n=XWmE\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.5-rc.0_1677666796502_0.3522015727125769"},"_hasShrinkwrap":false},"1.2.6-rc.0":{"name":"@connectiv-ms/conflux","version":"1.2.6-rc.0","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"readme":"# JavaScriptMerger\r\n\r\n## Table of Contents\r\n- [JavaScriptMerger](#javascriptmerger)\r\n  - [Table of Contents](#table-of-contents)\r\n  - [Usage](#usage)\r\n    - [Declaring Dependencies](#declaring-dependencies)\r\n    - [Executing the Tool](#executing-the-tool)\r\n      - [Arguments](#arguments)\r\n      - [Options](#options)\r\n  - [Installation](#installation)\r\n\r\n## Usage\r\n\r\nThe JavaScriptMerger is the first tool in the legacy JS Buildchain at connectiv.\r\nIt will make sure, that all of the source files end up in the right output\r\ndirectory and resolve all valid [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) in JS files that it\r\nfinds along the way.\r\n\r\nThe merging is required to avoid issues with the unordered loading of webresources\r\nin dynamics. Scripts that rely on their dependencies to be loaded before they\r\nfirst may run into issues if the dependencies are not yet fetched. To counteract\r\nthis, all dependencies are bundled together with the script in a single file.\r\n\r\nThe JavaScriptMerger also handles *.htm*, *.html* and *.css* files, also these\r\nare simply copied to the output directory.\r\n\r\n### Declaring Dependencies\r\n\r\nInside of JS files, you can use [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) like this:\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\"/>\r\n```\r\n\r\nIf you need to include a triple-slash directive that does not need merging, \r\nyou can add an `ignoreMerge=\"true\"` attribute to the reference.\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\" ignoreMerge=\"true\"/>\r\n```\r\n\r\nBe aware, that there are a couple of caveats:\r\n- You can only link to other JS files.\r\n- References will only be resolved in your root script, meaning that if you declare\r\n  a reference inside of a script that is a dependency, it will not be resolved.\r\n  There is an option (`-recursiveResolution`) to change this behavior after version 1.1.\r\n- Reference paths will by default be resolved according to the `<SourceDirectory>`.\r\n  This behavior can be overridden with the option `-relativeReferences`. This may\r\n  become the default going forward, after it has been proven, that this behavior does not \r\n  cause unwanted breaking side-effects in legacy projects.\r\n\r\n### Executing the Tool\r\n\r\nYou can run the tool through a terminal using the following syntax\r\n>`Connectiv.JavaScriptMerger.exe <SourceDirectory> <OutputDirectory> [Options]`\r\n\r\nYou may use arguments and options to alter the default behavior.\r\n>`Connectiv.JavaScriptMerger.exe ./Scripts/src ./Scripts/bin/ -v -recursiveResolution -relativeReferences`\r\n\r\n>`Connectiv.JavaScriptMerger.exe -legacy`\r\n\r\n\r\n#### Arguments\r\n\r\n| Argument | Position | Required | Description | Default |\r\n| - | - | - | - | - |\r\n| ```<SourceDirectory>``` | 1 | Optional | Path to folder where the script files are located.<br> *Only files in this folder are taken into account.<br>Files in nested folders can only be addressed through references.* | `Scripts` |\r\n| ```<OutputDirectory>``` | 2 | Optional | Path to the folder where the output files should be placed.<br>*Be aware that using this argument makes the arguments with a lower position required.* | `Scripts/bin/Debug/Debug` |\r\n\r\n#### Options\r\n\r\nThe tool does not necessarily need options to run, but if you need to override\r\nthe default behavior, you can do so by supplying the options described in the\r\ntable below. Some options offer a shorthand, which can be used via \r\n`-x <value>`. The full option name can be supplied via `-fullName <value>`. For\r\nboolean options, the value can be omitted.\r\n\r\n| Option | Shorthand | Type | Description | Default |\r\n| - | - | - | - | - |\r\n| `verbose` | `v` | `boolean` | Will print detailed information for each processed file. | `false` |\r\n| `legacy` |  | `boolean` | In case the new version causes any issues, you can run the legacy v1.0 version instead. | `false` |\r\n| `recursiveResolution` |  | `boolean` | By default, dependencies are only resolved for the top-level scripts. This enables the resolution of dependencies of dependencies. | `false` |\r\n| `relativeReferences` |  | `boolean` | By default, dependencies are always resolved according to the `<SourceDirectory>`. Passing this flag, will base the resolution on the path of the currently processed file.<br>**This might change to default behavior if it can be proven that due to the single-level resolution this problem will never occur.** | `false` |\r\n\r\n## Installation\r\n\r\n### Nuget\r\n### dotnet tool\r\n### NPM","readmeFilename":"README.md","_id":"@connectiv-ms/conflux@1.2.6-rc.0","_nodeVersion":"18.14.1","_npmVersion":"9.3.1","dist":{"integrity":"sha512-A6g3vz8G00oT6GxPKFwaiyJBdnJowPKgfBKr0oxoF3WcmbkH/wPyDZb1K9aWOmy7Tkd0wzQuQ3uF7HGU2jOuQQ==","shasum":"58d74fffc3cf9454dc8623c0fcf4a8c628327eee","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.6-rc.0.tgz","fileCount":41,"unpackedSize":2996807,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDaejspsDRv2gObkjQtbzbF5k+Gf/GUOkoM+8Iwv44O+AIgel/1qfHk/aL2Meo2j6vurLRKEsGKvBh9gK9wEy1Benk="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj/yy6ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoEgw//acbzLLlgIZ4zmngbJOvqWaVr/94Tyfawg8dwMYO/hGsil2db\r\npJa+/LJfWMWd/SpiExMphCpGRGrHr3ldcpmjN4sfog1cqxScdQCjWviziTT8\r\niM2pxp6QCA03m9IeYAH5I6/s3BCsunx3Krfmqh8rICWbDDz9yqO6vvxjNrF1\r\ng6h9pA1xlhE2GGVI/AfY06SCSdMYpfDaPffA8m7WnqqxIr+or7NxsGu+sEEf\r\naSG7hN8EOzX7j0QG6IQY3o7Kk/AekmfKRanzlaB1mGqR8kqJOGpSuKhRM8lj\r\nw2AnAn/Y9i5CcyYsmEgy3rwtTvD2xvvPASBqcCNdDMXNue7h8jw4mhnNqGL9\r\nC9kSgcshKQ4hCqtg9muy8T/b2+DMLOoqP4dl5CuAs3OhK8c77jDnKh2QRKzz\r\nWgW5dY3MTaTL605koqftoiUNA7uok8+2Nt7Wbo9WlnzKgy9OEAyhVGWg3hLn\r\nKu6DwS6/fZViQ5fLemTe/lO/3jt6zYtBUVQlfO7x5j54StYj6XKbfYzI4w8R\r\n/FTJBnJ/PloAZNZp7V74+BSpVhyQhpQ62Vqe55b2Xvcn8IypUg8t/fPD+HL5\r\nuSsCDOfR9lHD3m0M92uWi1uW+HbBpXmEOOzYssZSgq8zjMxLjUO91aagUVdc\r\n1IkWsyEYyNa7jqIbzytAs0nvmgIB6c5/zXE=\r\n=rgB2\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.6-rc.0_1677667514648_0.45211814435912"},"_hasShrinkwrap":false},"1.2.9":{"name":"@connectiv-ms/conflux","version":"1.2.9","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.9","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-qfNPUZLx1hcGNDP7fJ+KeaqpEEcnGKidmGolh6Ksrv73Pt8/RNTtLhnyPgJD9OeBXThu240bJ1Toqvk6P1b74Q==","shasum":"75bd1952cd9dd0608c86770c4354b128f09ae029","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.9.tgz","fileCount":45,"unpackedSize":5364172,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC1ZZLDPrXhbvkjNUsstgQ21zF8x8fCnCsshznOJfyUtQIhAOrWpHsQmm2i/2pwAbYZy39DtPIzUta5tSXNMhqpuOnq"}]},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.9_1687261258658_0.3842636091238927"},"_hasShrinkwrap":false},"1.2.10":{"name":"@connectiv-ms/conflux","version":"1.2.10","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.10","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-zunJT+SUgtqHmOXfYHVJ6Tf54bFQZdFLyKU4+yIWPNi2mA2hGGbn+b35XnwxKHR2VgoCg3/xOUk4Dgz4okpOaw==","shasum":"342f28a8a034eb10c200aac25279a491c8e93a55","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.10.tgz","fileCount":44,"unpackedSize":5337179,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIAmSI7cId0LXuWaGSJnpKNVPGw+gQvKo5i+ceY/7ooi8AiEAtDk6bhFiwRzXrCh3fyoiZ7qXzElMYw2YHxBO6DkewOE="}]},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.10_1687265412417_0.14125256610264625"},"_hasShrinkwrap":false},"1.2.11":{"name":"@connectiv-ms/conflux","version":"1.2.11","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.11","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-ClqSlE1GAKVgm1YOnsfwMccFzEeGj7QLKmXQ8Du7ju/B/Fxjl4fo8vcSmQ+1CuPbchtdT7D6GiIxXovC1kW1pg==","shasum":"fbc9d6f00d2e59abaa9d67b3e58bde4509ca40c6","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.11.tgz","fileCount":44,"unpackedSize":5337179,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCgCsQqlDFyIZS3up0h62eTn+mlR15sLVfxGlnDB+LUpQIhAMXYCDzOqEDXAzXQnvNl/3Chz7VQv+A9mDq1cnNkBxYD"}]},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.11_1687266095735_0.26609494383383314"},"_hasShrinkwrap":false},"1.2.12":{"name":"@connectiv-ms/conflux","version":"1.2.12","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.12","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-ZXUEF51/v3nuOKaSIoK50ggd9epvcFY0sVTnRQKpUDM+fQtpLcrFCb7RbP/75lf6HjugXofsp2ob895CIIcRTA==","shasum":"b78c7c28bf6222ed19019bc6b1905d5d7f20ebb6","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.12.tgz","fileCount":44,"unpackedSize":5337179,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEmVgWoqRVgHPJs8RC/rNHRuLAD48t/xF+ikLatHRO2WAiAgeOTROWAXk1pP7CBG6JgxqdD1hum70S+rabhHj2QrEA=="}]},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.12_1687267138058_0.07248942612715359"},"_hasShrinkwrap":false},"1.2.13":{"name":"@connectiv-ms/conflux","version":"1.2.13","description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","main":"cli.js","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","scripts":{"copy-markdown":"cp ../Conflux.Cli/*.md .","prepublish":"npm run copy-markdown"},"bin":{"conflux":"lib/cli.js"},"_id":"@connectiv-ms/conflux@1.2.13","_nodeVersion":"18.16.0","_npmVersion":"9.5.1","dist":{"integrity":"sha512-lmLJFZj/4dFHEE11v6K/Pu8UcdGj5hyCdJUVToHpozK9lHs+2GNA76rE1FelqI81L4Ss/kqn7/FJlNR4X5rELg==","shasum":"d5cc0d13131256abd6aabea37d80e39bd7d4db0a","tarball":"https://registry.npmjs.org/@connectiv-ms/conflux/-/conflux-1.2.13.tgz","fileCount":44,"unpackedSize":5337183,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCkfBMjuWC6OQBFIaRqymv8Ha2eFRzz5TP9My3FAmMfUwIgXF9SXcN4/M+m0cfb1FLiWcbu6R94G1+V7jjQwb9J0x8="}]},"_npmUser":{"name":"connectiv_admin","email":"operations@connectiv.de"},"directories":{},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/conflux_1.2.13_1687269385679_0.15882422523601658"},"_hasShrinkwrap":false}},"time":{"created":"2023-02-28T17:25:22.228Z","1.2.4-rc.0":"2023-02-28T17:25:22.561Z","modified":"2023-06-20T13:56:26.125Z","1.2.5-rc.0":"2023-03-01T10:33:16.749Z","1.2.6-rc.0":"2023-03-01T10:45:14.878Z","1.2.9":"2023-06-20T11:40:58.855Z","1.2.10":"2023-06-20T12:50:12.701Z","1.2.11":"2023-06-20T13:01:35.976Z","1.2.12":"2023-06-20T13:18:58.343Z","1.2.13":"2023-06-20T13:56:25.932Z"},"maintainers":[{"name":"christian-schulte","email":"schulte@connectiv.de"},{"name":"connectiv_admin","email":"operations@connectiv.de"},{"name":"oliver-tressler","email":"oliver.tressler@connectiv.de"}],"description":"Preprocess webresource files before upload. Merge JS files using triple-slash references.","author":{"name":"Oliver Tressler","email":"oliver.tressler@connectiv.de"},"license":"ISC","readme":"# conFlux\r\n\r\n> _A convergence or moving gathering of forces, people, or things._ [[1]](https://en.wiktionary.org/wiki/conflux)\r\n\r\n## Table of Contents\r\n- [conFlux](#conflux)\r\n  - [Table of Contents](#table-of-contents)\r\n  - [Usage](#usage)\r\n    - [Declaring Dependencies](#declaring-dependencies)\r\n    - [Executing the Tool](#executing-the-tool)\r\n      - [Arguments](#arguments)\r\n      - [Options](#options)\r\n  - [Installation](#installation)\r\n    - [dotnet tool](#dotnet-tool)\r\n    - [NPM](#npm)\r\n\r\n## Usage\r\n\r\nconFlux is the first tool in the legacy JS Buildchain at connectiv. It will make sure, that all of the source files end up in the right output directory and resolve all valid [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) in JS files that it finds along the way.\r\n\r\nMerging is required to avoid issues with the unordered loading of webresources in dynamics. Scripts that require their dependencies to be loaded before they are executed may run into issues if the dependencies are not yet fetched. To counteract this, all dependencies are bundled together with the script in a single file.\r\n\r\nThe JavaScriptMerger also handles other webresource filetypes (e.g. `.htm`, `.html` and `.css`), which are simply copied to the output directory.\r\n\r\n### Declaring Dependencies\r\n\r\nInside of JS files, you can use [Triple-Slash Directives](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) like this:\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\"/>\r\n```\r\n\r\nIf you need to include a triple-slash directive that does not need merging, you can add an `ignoreMerge=\"true\"` attribute to the reference.\r\n\r\n```xml\r\n/// <reference path=\"path/to/your/dependency.js\" ignoreMerge=\"true\"/>\r\n```\r\n\r\nBe aware, that there are a couple of caveats:\r\n- You can only link to other JS files.\r\n- References will only be resolved in your root script, meaning that if you declare\r\n  a reference inside of a script that is a dependency, it will not be resolved.\r\n  There is an option (`-recursiveResolution`) to change this behavior after version 1.1.\r\n- Reference paths will by default be resolved according to the `<SourceDirectory>`.\r\n  This behavior can be overridden with the option `-relativeReferences`. This may\r\n  become the default going forward, after it has been proven, that this behavior does not \r\n  cause unwanted breaking side-effects in legacy projects.\r\n\r\n### Executing the Tool\r\n\r\nYou can run the tool through a terminal using the following syntax\r\n>`conflux <SourceDirectory> <OutputDirectory> [Options]`\r\n\r\nYou may use arguments and options to alter the default behavior.\r\n>`conflux ./Scripts/src ./Scripts/bin/ -v --recursiveResolution --relativeReferences`\r\n\r\n>`conflux --legacy`\r\n\r\nFor using this tool in a script, direct execution via npm is recommended.\r\n>`npx @connectiv-ms/conflux <SourceDirectory> <OutputDirectory> [Options]`\r\n\r\n#### Arguments\r\n\r\n| Argument                | Position | Required | Description                                                                                                                                                                     | Default                   |\r\n| ----------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |\r\n| ```<SourceDirectory>``` | 1        | Optional | Path to folder where the script files are located.<br> *Only files in this folder are taken into account.<br>Files in nested folders can only be addressed through references.* | `Scripts`                 |\r\n| ```<OutputDirectory>``` | 2        | Optional | Path to the folder where the output files should be placed.<br>*Be aware that using this argument makes the arguments with a lower position required.*                          | `Scripts/bin/Debug/Debug` |\r\n\r\n#### Options\r\n\r\nThe tool does not necessarily need options to run, but if you need to override\r\nthe default behavior, you can do so by supplying the options described in the\r\ntable below. Some options offer a shorthand, which can be used via \r\n`-x <value>`. The full option name can be supplied via `--fullName <value>`. For\r\nboolean options, the value can be omitted.\r\n\r\n| Option                | Shorthand | Type      | Description                                                                                                                                                                                                                                                                                                         | Default |\r\n| --------------------- | --------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |\r\n| `verbose`             | `v`       | `boolean` | Will print detailed information for each processed file if available.                                                                                                                                                                                                                                                            | `false` |\r\n| `legacy`              |           | `boolean` | In case the new version causes any issues, you can run the legacy v1.0 version instead.                                                                                                                                                                                                                             | `false` |\r\n| `recursiveResolution` |           | `boolean` | By default, dependencies are only resolved for the top-level scripts. This flag enables the recursive resolution of dependencies.                                                                                                                                                                                  | `false` |\r\n| `relativeReferences`  |           | `boolean` | By default, dependencies are always resolved according to the `<SourceDirectory>`. Passing this flag, will base the resolution on the path of the currently processed file.<br>**This might change to default behavior if it can be proven that due to the single-level resolution this problem will never occur.** | `false` |\r\n\r\n## Installation\r\n\r\nThis tool can either be installed as a dotnet tool or as an NPM package. **Please make sure that you only install it via one of these two methods**.\r\n\r\n### dotnet tool\r\n\r\nThis tool can be installed as a dotnet tool from the [ConNuget Artifacts Feed](https://dev.azure.com/connectiv-ms/Lohmann%20und%20Rauscher/_artifacts/feed/ConNuget/Npm/@connectiv-ms%2Fconflux/overview/) via the following command:\r\n\r\n```bash\r\ndotnet tool install -g conflux\r\n```\r\n\r\n### NPM\r\n\r\nThis tool can be installed as an NPM package via the following command:\r\n\r\n```bash\r\nnpm install -g conflux\r\n```","readmeFilename":"README.md"}