@storm-software/workspace-tools 1.16.3 → 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 +7 -0
- package/README.md +148 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,10 @@
|
|
|
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
|
+
|
|
1
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)
|
|
2
9
|
|
|
3
10
|
|
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/package.json
CHANGED