@storm-software/workspace-tools 1.16.2 → 1.16.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/README.md +148 -1
- package/index.js +11 -14
- package/meta.json +1 -1
- package/package.json +1 -1
- package/src/executors/tsup/executor.js +11 -14
- package/src/executors/tsup/get-config.js +11 -14
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,17 @@
|
|
|
1
|
+
## [1.16.3](https://github.com/storm-software/storm-ops/compare/workspace-tools-v1.16.2...workspace-tools-v1.16.3) (2023-11-29)
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
### Bug Fixes
|
|
5
|
+
|
|
6
|
+
* **workspace-tools:** Resolved issue with entry path passed into api-extractor ([b2614e5](https://github.com/storm-software/storm-ops/commit/b2614e5639be0717e747c6bf06b39dc31df393e2))
|
|
7
|
+
|
|
8
|
+
## [1.16.2](https://github.com/storm-software/storm-ops/compare/workspace-tools-v1.16.1...workspace-tools-v1.16.2) (2023-11-29)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* **git-tools:** Resolved various issues with nx documentation for readme-gen ([8067497](https://github.com/storm-software/storm-ops/commit/806749724b520f21622c0c93c8ff4e3c63129480))
|
|
14
|
+
|
|
1
15
|
## [1.16.1](https://github.com/storm-software/storm-ops/compare/workspace-tools-v1.16.0...workspace-tools-v1.16.1) (2023-11-29)
|
|
2
16
|
|
|
3
17
|
|
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
|
|
|
16
16
|
|
|
17
17
|
<h3 align="center">💻 Visit <a href="https://stormsoftware.org" target="_blank">stormsoftware.org</a> to stay up to date with this developer</h3><br />
|
|
18
18
|
|
|
19
|
-
[](https://prettier.io/)
|
|
20
20
|
[](http://nx.dev/) [](https://nextjs.org/) [](http://commitizen.github.io/cz-cli/)  [](https://docusaurus.io/) 
|
|
21
21
|
|
|
22
22
|
<h3 align="center" bold="true">⚠️ <b>Attention</b> ⚠️ This repository, and the apps, libraries, and tools contained within, is still in it's initial development phase. As a result, bugs and issues are expected with it's usage. When the main development phase completes, a proper release will be performed, the packages will be availible through NPM (and other distributions), and this message will be removed. However, in the meantime, please feel free to report any issues you may come across.</h3><br />
|
|
@@ -36,6 +36,54 @@ A package containing tools for managing a Storm workspace. It includes various [
|
|
|
36
36
|
|
|
37
37
|
This library was generated with [Nx](https://nx.dev).
|
|
38
38
|
|
|
39
|
+
<!-- START executors -->
|
|
40
|
+
|
|
41
|
+
## Tsup Builder
|
|
42
|
+
|
|
43
|
+
Run a build on the project using ESBuild with a patched tsup configuration
|
|
44
|
+
|
|
45
|
+
### Example
|
|
46
|
+
|
|
47
|
+
This executor can be used by executing the following in a command line utility:
|
|
48
|
+
|
|
49
|
+
```cmd
|
|
50
|
+
nx run my-project:tsup
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
**Please note:** _The tsup executor should be included in the desired projects's `project.json` file.All required options must be included in the `options` property of the json._
|
|
54
|
+
|
|
55
|
+
### Options
|
|
56
|
+
|
|
57
|
+
The following executor options are available:
|
|
58
|
+
|
|
59
|
+
| Option | Type | Description | Default |
|
|
60
|
+
| ------ | --------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
61
|
+
| entry | `string` | The path to the entry file, relative to project. | "{sourceRoot}/index.ts" |
|
|
62
|
+
| , | outputPath | `string` | The output path of the generated files. | "dist/{projectRoot}" |
|
|
63
|
+
| , | tsConfig\* | `string` | The path to tsconfig file. | "tsconfig.json" |
|
|
64
|
+
| , | additionalEntryPoints | `string[]` | List of additional entry points. | `` |
|
|
65
|
+
| , | external | `string[]` | Mark one or more module as external. Can use \* wildcards, such as '\*.png'. | |
|
|
66
|
+
| , | bundle | `boolean` | Whether to bundle the main entry point and additional entry points. Set to false to keep individual output files. | `true` |
|
|
67
|
+
| , | watch | `boolean` | Enable re-building when files change. | |
|
|
68
|
+
| , | assets | `array` | List of static assets. | `` |
|
|
69
|
+
| , | clean | `boolean` | Remove previous output before build. | `true` |
|
|
70
|
+
| , | includeSrc | `boolean` | Should the source files be added to the distribution folder in an \`src\` directory. | `true` |
|
|
71
|
+
| , | debug | `boolean` | Should output be unminified with source mappings. | |
|
|
72
|
+
| , | platform\* | "browser" \| "neutral" \| "node" \| "worker" | Platform target for outputs. | "neutral" |
|
|
73
|
+
| , | banner\* | `string` | A short heading added to the top of each typescript file added in the output folder's src directory. | "This code was developed by Storm Software (<https://stormsoftware.org>) and is licensed under the Apache License 2.0." |
|
|
74
|
+
| , | verbose | `boolean` | Should write extra log outputs with details from the executor. | |
|
|
75
|
+
| , | define | `object` | Define global constants that can be used in the source code. The value will be converted into a stringified JSON. | |
|
|
76
|
+
| , | env | `object` | Define environment variables that can be used in the source code. The value will be converted into a stringified JSON. | |
|
|
77
|
+
| , | apiReport | `boolean` | Should API Extractor generate an API Report file. | `true` |
|
|
78
|
+
| , | docModel | `boolean` | Should API Extractor generate an Doc Model markdown file. | `true` |
|
|
79
|
+
| , | tsdocMetadata | `boolean` | Should API Extractor generate an TSDoc Metadata file. | `true` |
|
|
80
|
+
| , | options | `object` | Additional options to pass to tsup. See <https://paka.dev/npm/tsup@7.2.0/api#d35d54aca71eb26e>. | |
|
|
81
|
+
| , | plugins | `object[]` | List of ESBuild plugins to use during processing | `` |
|
|
82
|
+
|
|
83
|
+
**Please note:** _Option names followed by \* above are required, and must be provided to run the executor._
|
|
84
|
+
|
|
85
|
+
<!-- END executors -->
|
|
86
|
+
|
|
39
87
|
## Executors
|
|
40
88
|
|
|
41
89
|
The following executors are available in this package to invoke common tasks for the workspace's projects:
|
|
@@ -86,6 +134,105 @@ The following executor options are available:
|
|
|
86
134
|
|
|
87
135
|
The following generators are available with this package to assist in workspace management:
|
|
88
136
|
|
|
137
|
+
<!-- START generators -->
|
|
138
|
+
|
|
139
|
+
## Init Storm Workspace Plugin
|
|
140
|
+
|
|
141
|
+
Init Storm Workspace Plugin.
|
|
142
|
+
|
|
143
|
+
### Options
|
|
144
|
+
|
|
145
|
+
The following executor options are available:
|
|
146
|
+
|
|
147
|
+
| Option | Type | Description | Default |
|
|
148
|
+
| ---------- | --------- | ---------------------- | ------- |
|
|
149
|
+
| skipFormat | `boolean` | Skip formatting files. | |
|
|
150
|
+
|
|
151
|
+
## Workspace Preset
|
|
152
|
+
|
|
153
|
+
Create a Storm workspace with all of the required files and recommended packages installed.
|
|
154
|
+
|
|
155
|
+
### Examples
|
|
156
|
+
|
|
157
|
+
This generator can be used by executing the following examples in a command line utility:
|
|
158
|
+
|
|
159
|
+
Generate a storm workspace with:
|
|
160
|
+
|
|
161
|
+
- name: example-repo
|
|
162
|
+
- namespace: storm-software
|
|
163
|
+
- organization: storm-software
|
|
164
|
+
- repositoryUrl: <https://github.com/storm-software/example-repo>
|
|
165
|
+
|
|
166
|
+
```cmd
|
|
167
|
+
nx g @storm-software/workspace-tools:preset --name 'example-repo'
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Generate a storm workspace with:
|
|
171
|
+
|
|
172
|
+
- name: example-repo
|
|
173
|
+
- namespace: example
|
|
174
|
+
- repositoryUrl: <https://github.com/storm-software/example-repo>
|
|
175
|
+
|
|
176
|
+
```cmd
|
|
177
|
+
nx g @storm-software/workspace-tools:preset --name 'example-repo' --namespace 'example'
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
Generate a storm workspace with:
|
|
181
|
+
|
|
182
|
+
- name: example-repo
|
|
183
|
+
- namespace: example
|
|
184
|
+
- organization: example-org
|
|
185
|
+
- description: An example workspace
|
|
186
|
+
- repositoryUrl: <https://github.com/example-org/example-repo>
|
|
187
|
+
|
|
188
|
+
```cmd
|
|
189
|
+
nx g @storm-software/workspace-tools:preset --name 'example-repo' --namespace 'example' --organization 'example-org' --description 'An example workspace'
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### Options
|
|
193
|
+
|
|
194
|
+
The following executor options are available:
|
|
195
|
+
|
|
196
|
+
| Option | Type | Description | Default |
|
|
197
|
+
| ------ | -------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
|
|
198
|
+
| name\* | `string` | The name of the workspace root. | |
|
|
199
|
+
| , | organization\* | `string` | The organization that owns the workspace. | "storm-software" |
|
|
200
|
+
| , | namespace | `string` | The npm scope used for the workspace. Defaults to the organization name. | |
|
|
201
|
+
| , | includeApps\* | `boolean` | Should a separate \`apps\` folder be created for this workspace (if Yes: \`apps\` and \`libs\` folders will be added, if No: \`packages\` folders will be added)? | |
|
|
202
|
+
| , | description | `string` | The description of the workspace to use in the package.json and README.md files. | |
|
|
203
|
+
| , | repositoryUrl | `string` | The URL of the workspace in GitHub. Defaults to <https://github.com/{organization}/{name}> | |
|
|
204
|
+
| , | nxCloud | `boolean` | Should distributed caching with Nx Cloud be enabled for the workspace? | |
|
|
205
|
+
| , | mode\* | "light" \| "dark" | Which client mode should be used for the Nx Task Runner? | "dark" |
|
|
206
|
+
| , | packageManager | "npm" \| "yarn" \| "pnpm" | What package manager is used for the workspace? | "pnpm" |
|
|
207
|
+
|
|
208
|
+
**Please note:** _Option names followed by \* above are required, and must be provided to run the executor._
|
|
209
|
+
|
|
210
|
+
## Add Node Library
|
|
211
|
+
|
|
212
|
+
Generate a new node library project in the Storm workspace
|
|
213
|
+
|
|
214
|
+
### Options
|
|
215
|
+
|
|
216
|
+
The following executor options are available:
|
|
217
|
+
|
|
218
|
+
| Option | Type | Description | Default |
|
|
219
|
+
| ------ | -------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
|
|
220
|
+
| name\* | `string` | A name for the library. | |
|
|
221
|
+
| , | description | `string` | The library used by Storm Software for building TypeScript applications. | |
|
|
222
|
+
| , | directory\* | `string` | A directory where the lib is placed. | |
|
|
223
|
+
| , | projectNameAndRootFormat\* | "as-provided" \| "derived" | Whether to generate the project name and root directory as provided (\`as-provided\`) or generate them composing their values and taking the configured layout into account (\`derived\`). | |
|
|
224
|
+
| , | tags | `string` | Add tags to the library (used for linting). | |
|
|
225
|
+
| , | strict | `boolean` | Whether to enable tsconfig strict mode or not. | `true` |
|
|
226
|
+
| , | publishable\* | `boolean` | Generate a publishable library. | |
|
|
227
|
+
| , | importPath\* | `string` | The library name used to import it, like @storm-software/my-awesome-lib. Required for publishable library. | |
|
|
228
|
+
| , | buildable\* | `boolean` | Generate a buildable library. | `true` |
|
|
229
|
+
| , | setParserOptionsProject | `boolean` | Whether or not to configure the ESLint \`parserOptions.project\` option. We do not do this by default for lint performance reasons. | |
|
|
230
|
+
| , | rootProject | `boolean` | Is the current project the root project in the workspace. | |
|
|
231
|
+
|
|
232
|
+
**Please note:** _Option names followed by \* above are required, and must be provided to run the executor._
|
|
233
|
+
|
|
234
|
+
<!-- END generators -->
|
|
235
|
+
|
|
89
236
|
## Init Storm Workspace Plugin
|
|
90
237
|
|
|
91
238
|
Init Storm Workspace Plugin.
|
package/index.js
CHANGED
|
@@ -40019,9 +40019,9 @@ var require_brace_expansion2 = __commonJS({
|
|
|
40019
40019
|
}
|
|
40020
40020
|
});
|
|
40021
40021
|
|
|
40022
|
-
// node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40022
|
+
// node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-EPAEWGCP.js
|
|
40023
40023
|
var require_chunk_EPAEWGCP = __commonJS({
|
|
40024
|
-
"node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40024
|
+
"node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-EPAEWGCP.js"(exports) {
|
|
40025
40025
|
"use strict";
|
|
40026
40026
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
40027
40027
|
var version = "8.0.0";
|
|
@@ -40481,9 +40481,9 @@ var require_resolve_from = __commonJS({
|
|
|
40481
40481
|
}
|
|
40482
40482
|
});
|
|
40483
40483
|
|
|
40484
|
-
// node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40484
|
+
// node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-GQ77QZBO.js
|
|
40485
40485
|
var require_chunk_GQ77QZBO = __commonJS({
|
|
40486
|
-
"node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40486
|
+
"node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-GQ77QZBO.js"(exports) {
|
|
40487
40487
|
"use strict";
|
|
40488
40488
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
40489
40489
|
function _interopRequireDefault(obj) {
|
|
@@ -40761,9 +40761,9 @@ var require_chunk_GQ77QZBO = __commonJS({
|
|
|
40761
40761
|
}
|
|
40762
40762
|
});
|
|
40763
40763
|
|
|
40764
|
-
// node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40764
|
+
// node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-UIX4URMV.js
|
|
40765
40765
|
var require_chunk_UIX4URMV = __commonJS({
|
|
40766
|
-
"node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
40766
|
+
"node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-UIX4URMV.js"(exports) {
|
|
40767
40767
|
"use strict";
|
|
40768
40768
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
40769
40769
|
function _interopRequireWildcard(obj) {
|
|
@@ -41697,9 +41697,9 @@ var require_dist2 = __commonJS({
|
|
|
41697
41697
|
}
|
|
41698
41698
|
});
|
|
41699
41699
|
|
|
41700
|
-
// node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
41700
|
+
// node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-7G76EW2R.js
|
|
41701
41701
|
var require_chunk_7G76EW2R = __commonJS({
|
|
41702
|
-
"node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
41702
|
+
"node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/chunk-7G76EW2R.js"(exports) {
|
|
41703
41703
|
"use strict";
|
|
41704
41704
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
41705
41705
|
function _interopRequireDefault(obj) {
|
|
@@ -95505,9 +95505,9 @@ var require_chokidar = __commonJS({
|
|
|
95505
95505
|
}
|
|
95506
95506
|
});
|
|
95507
95507
|
|
|
95508
|
-
// node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
95508
|
+
// node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/index.js
|
|
95509
95509
|
var require_dist5 = __commonJS({
|
|
95510
|
-
"node_modules/.pnpm/tsup@8.0.0_patch_hash=
|
|
95510
|
+
"node_modules/.pnpm/tsup@8.0.0_patch_hash=qacpwkdapepzhvdo4ovtfmkorm_@microsoft+api-extractor@7.38.3_@swc+core@1._oembpat6aoozsu4cx5s52dhrce/node_modules/tsup/dist/index.js"(exports) {
|
|
95511
95511
|
"use strict";
|
|
95512
95512
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
95513
95513
|
function _interopRequireDefault(obj) {
|
|
@@ -97885,10 +97885,7 @@ var require_dist5 = __commonJS({
|
|
|
97885
97885
|
options.projectRoot
|
|
97886
97886
|
).replaceAll("\\", "/");
|
|
97887
97887
|
let configObject = {
|
|
97888
|
-
mainEntryPointFilePath:
|
|
97889
|
-
relativeProjectFolder,
|
|
97890
|
-
inputFilePath.replace(options.workspaceRoot, "")
|
|
97891
|
-
).replaceAll("\\", "/")}`,
|
|
97888
|
+
mainEntryPointFilePath: inputFilePath.includes(options.workspaceRoot) ? inputFilePath : _path2.default.join(options.workspaceRoot, inputFilePath),
|
|
97892
97889
|
apiReport: {
|
|
97893
97890
|
enabled: options.apiReport !== false,
|
|
97894
97891
|
reportFileName: "api-report.md",
|