@nikovirtala/projen-constructs 0.1.4 → 0.1.6
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/.jsii +223 -203
- package/API.md +52 -28
- package/lib/components/mise.js +4 -2
- package/lib/components/vitest.js +1 -1
- package/lib/config.d.ts +20 -7
- package/lib/config.js +28 -16
- package/lib/errors.d.ts +20 -0
- package/lib/errors.js +36 -0
- package/lib/projects/awscdk-construct-library-options.generated.d.ts +7 -7
- package/lib/projects/awscdk-construct-library-options.generated.js +1 -1
- package/lib/projects/{awscdk-construct-library.d.ts → awscdk-construct-library.generated.d.ts} +8 -0
- package/lib/projects/awscdk-construct-library.generated.js +33 -0
- package/lib/projects/awscdk-typescript-app-options.generated.d.ts +31 -31
- package/lib/projects/awscdk-typescript-app-options.generated.js +1 -1
- package/lib/projects/{awscdk-typescript-app.d.ts → awscdk-typescript-app.generated.d.ts} +8 -0
- package/lib/projects/awscdk-typescript-app.generated.js +33 -0
- package/lib/projects/index.d.ts +4 -4
- package/lib/projects/index.js +5 -5
- package/lib/projects/jsii-options.generated.d.ts +7 -7
- package/lib/projects/jsii-options.generated.js +1 -1
- package/lib/projects/{jsii.d.ts → jsii.generated.d.ts} +8 -0
- package/lib/projects/jsii.generated.js +33 -0
- package/lib/projects/typescript-options.generated.d.ts +7 -7
- package/lib/projects/typescript-options.generated.js +1 -1
- package/lib/projects/{typescript.d.ts → typescript.generated.d.ts} +8 -0
- package/lib/projects/typescript.generated.js +33 -0
- package/lib/projen-project-generator.d.ts +173 -0
- package/lib/projen-project-generator.js +509 -0
- package/package.json +1 -1
- package/lib/projects/awscdk-app-options.generated.d.ts +0 -1098
- package/lib/projects/awscdk-app-options.generated.js +0 -3
- package/lib/projects/awscdk-construct-library.js +0 -19
- package/lib/projects/awscdk-typescript-app.js +0 -19
- package/lib/projects/jsii.js +0 -19
- package/lib/projects/typescript.js +0 -19
|
@@ -1,1098 +0,0 @@
|
|
|
1
|
-
import type { awscdk, github, GitOptions, GroupRunnerOptions, IgnoreFileOptions, javascript, LoggerOptions, Project, ProjenrcJsonOptions, ReleasableCommits, release, RenovatebotOptions, SampleReadmeProps, typescript } from 'projen';
|
|
2
|
-
import type { VitestOptions } from '../';
|
|
3
|
-
/**
|
|
4
|
-
* AwsCdkTypeScriptAppProjectOptions
|
|
5
|
-
*/
|
|
6
|
-
export interface AwsCdkTypeScriptAppProjectOptions {
|
|
7
|
-
/**
|
|
8
|
-
* Common options for all AWS Lambda functions.
|
|
9
|
-
* @default - default options
|
|
10
|
-
* @stability experimental
|
|
11
|
-
*/
|
|
12
|
-
readonly lambdaOptions?: awscdk.LambdaFunctionCommonOptions;
|
|
13
|
-
/**
|
|
14
|
-
* Automatically adds an `awscdk.LambdaExtension` for each `.lambda-extension.ts` entrypoint in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
|
|
15
|
-
* @default true
|
|
16
|
-
* @stability experimental
|
|
17
|
-
*/
|
|
18
|
-
readonly lambdaExtensionAutoDiscover?: boolean;
|
|
19
|
-
/**
|
|
20
|
-
* Automatically adds an `awscdk.LambdaFunction` for each `.lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
|
|
21
|
-
* @default true
|
|
22
|
-
* @stability experimental
|
|
23
|
-
*/
|
|
24
|
-
readonly lambdaAutoDiscover?: boolean;
|
|
25
|
-
/**
|
|
26
|
-
* Automatically discovers and creates integration tests for each `.integ.ts` file in under your test directory.
|
|
27
|
-
* @default true
|
|
28
|
-
* @stability experimental
|
|
29
|
-
*/
|
|
30
|
-
readonly integrationTestAutoDiscover?: boolean;
|
|
31
|
-
/**
|
|
32
|
-
* Enable experimental support for the AWS CDK integ-runner.
|
|
33
|
-
* @default false
|
|
34
|
-
* @stability experimental
|
|
35
|
-
*/
|
|
36
|
-
readonly experimentalIntegRunner?: boolean;
|
|
37
|
-
/**
|
|
38
|
-
* Automatically adds an `cloudfront.experimental.EdgeFunction` for each `.edge-lambda.ts` handler in your source tree. If this is disabled, you can manually add an `awscdk.AutoDiscover` component to your project.
|
|
39
|
-
* @default true
|
|
40
|
-
* @stability experimental
|
|
41
|
-
*/
|
|
42
|
-
readonly edgeLambdaAutoDiscover?: boolean;
|
|
43
|
-
/**
|
|
44
|
-
* The CDK app's entrypoint (relative to the source directory, which is "src" by default).
|
|
45
|
-
* @default "main.ts"
|
|
46
|
-
* @stability experimental
|
|
47
|
-
*/
|
|
48
|
-
readonly appEntrypoint?: string;
|
|
49
|
-
/**
|
|
50
|
-
* The command line to execute in order to synthesize the CDK application (language specific).
|
|
51
|
-
* @stability experimental
|
|
52
|
-
*/
|
|
53
|
-
readonly app?: string;
|
|
54
|
-
/**
|
|
55
|
-
* Minimum version of the `constructs` library to depend on.
|
|
56
|
-
* @default - for CDK 1.x the default is "3.2.27", for CDK 2.x the default is
|
|
57
|
-
"10.0.5".
|
|
58
|
-
* @stability experimental
|
|
59
|
-
*/
|
|
60
|
-
readonly constructsVersion?: string;
|
|
61
|
-
/**
|
|
62
|
-
* Use pinned version instead of caret version for CDK.
|
|
63
|
-
* You can use this to prevent mixed versions for your CDK dependencies and to prevent auto-updates.
|
|
64
|
-
* If you use experimental features this will let you define the moment you include breaking changes.
|
|
65
|
-
* @stability experimental
|
|
66
|
-
*/
|
|
67
|
-
readonly cdkVersionPinning?: boolean;
|
|
68
|
-
/**
|
|
69
|
-
* Version range of the AWS CDK CLI to depend on.
|
|
70
|
-
* Can be either a specific version, or an NPM version range.
|
|
71
|
-
*
|
|
72
|
-
* By default, the latest 2.x version will be installed; you can use this
|
|
73
|
-
* option to restrict it to a specific version or version range.
|
|
74
|
-
* @default "^2"
|
|
75
|
-
* @stability experimental
|
|
76
|
-
*/
|
|
77
|
-
readonly cdkCliVersion?: string;
|
|
78
|
-
/**
|
|
79
|
-
* Install the assertions library?
|
|
80
|
-
* Only needed for CDK 1.x. If using CDK 2.x then
|
|
81
|
-
* assertions is already included in 'aws-cdk-lib'
|
|
82
|
-
* @default - will be included by default for AWS CDK >= 1.111.0 < 2.0.0
|
|
83
|
-
* @stability experimental
|
|
84
|
-
*/
|
|
85
|
-
readonly cdkAssertions?: boolean;
|
|
86
|
-
/**
|
|
87
|
-
* Minimum version of the AWS CDK to depend on.
|
|
88
|
-
* @default "2.1.0"
|
|
89
|
-
* @stability experimental
|
|
90
|
-
*/
|
|
91
|
-
readonly cdkVersion: string;
|
|
92
|
-
/**
|
|
93
|
-
* Glob patterns to include in `cdk watch`.
|
|
94
|
-
* @default []
|
|
95
|
-
* @stability experimental
|
|
96
|
-
*/
|
|
97
|
-
readonly watchIncludes?: Array<string>;
|
|
98
|
-
/**
|
|
99
|
-
* Glob patterns to exclude from `cdk watch`.
|
|
100
|
-
* @default []
|
|
101
|
-
* @stability experimental
|
|
102
|
-
*/
|
|
103
|
-
readonly watchExcludes?: Array<string>;
|
|
104
|
-
/**
|
|
105
|
-
* To protect you against unintended changes that affect your security posture, the AWS CDK Toolkit prompts you to approve security-related changes before deploying them.
|
|
106
|
-
* @default ApprovalLevel.BROADENING
|
|
107
|
-
* @stability experimental
|
|
108
|
-
*/
|
|
109
|
-
readonly requireApproval?: awscdk.ApprovalLevel;
|
|
110
|
-
/**
|
|
111
|
-
* Feature flags that should be enabled in `cdk.json`.
|
|
112
|
-
* Make sure to double-check any changes to feature flags in `cdk.json` before deploying.
|
|
113
|
-
* Unexpected changes may cause breaking changes in your CDK app.
|
|
114
|
-
* You can overwrite any feature flag by passing it into the context field.
|
|
115
|
-
* @default - no feature flags are enabled by default
|
|
116
|
-
* @stability experimental
|
|
117
|
-
*/
|
|
118
|
-
readonly featureFlags?: awscdk.ICdkFeatureFlags;
|
|
119
|
-
/**
|
|
120
|
-
* Additional context to include in `cdk.json`.
|
|
121
|
-
* @default - no additional context
|
|
122
|
-
* @stability experimental
|
|
123
|
-
*/
|
|
124
|
-
readonly context?: Record<string, any>;
|
|
125
|
-
/**
|
|
126
|
-
* cdk.out directory.
|
|
127
|
-
* @default "cdk.out"
|
|
128
|
-
* @stability experimental
|
|
129
|
-
*/
|
|
130
|
-
readonly cdkout?: string;
|
|
131
|
-
/**
|
|
132
|
-
* A command to execute before synthesis.
|
|
133
|
-
* This command will be called when
|
|
134
|
-
* running `cdk synth` or when `cdk watch` identifies a change in your source
|
|
135
|
-
* code before redeployment.
|
|
136
|
-
* @default - no build command
|
|
137
|
-
* @stability experimental
|
|
138
|
-
*/
|
|
139
|
-
readonly buildCommand?: string;
|
|
140
|
-
/**
|
|
141
|
-
* TypeScript version to use.
|
|
142
|
-
* NOTE: Typescript is not semantically versioned and should remain on the
|
|
143
|
-
* same minor, so we recommend using a `~` dependency (e.g. `~1.2.3`).
|
|
144
|
-
* @default "latest"
|
|
145
|
-
* @stability experimental
|
|
146
|
-
*/
|
|
147
|
-
readonly typescriptVersion?: string;
|
|
148
|
-
/**
|
|
149
|
-
* The name of the development tsconfig.json file.
|
|
150
|
-
* @default "tsconfig.dev.json"
|
|
151
|
-
* @stability experimental
|
|
152
|
-
*/
|
|
153
|
-
readonly tsconfigDevFile?: string;
|
|
154
|
-
/**
|
|
155
|
-
* Custom tsconfig options for the development tsconfig.json file (used for testing).
|
|
156
|
-
* @default - use the production tsconfig options
|
|
157
|
-
* @stability experimental
|
|
158
|
-
*/
|
|
159
|
-
readonly tsconfigDev?: javascript.TypescriptConfigOptions;
|
|
160
|
-
/**
|
|
161
|
-
* Custom TSConfig.
|
|
162
|
-
* @default - default options
|
|
163
|
-
* @stability experimental
|
|
164
|
-
*/
|
|
165
|
-
readonly tsconfig?: javascript.TypescriptConfigOptions;
|
|
166
|
-
/**
|
|
167
|
-
* Jest tests directory. Tests files should be named `xxx.test.ts`.
|
|
168
|
-
* If this directory is under `srcdir` (e.g. `src/test`, `src/__tests__`),
|
|
169
|
-
* then tests are going to be compiled into `lib/` and executed as javascript.
|
|
170
|
-
* If the test directory is outside of `src`, then we configure jest to
|
|
171
|
-
* compile the code in-memory.
|
|
172
|
-
* @default "test"
|
|
173
|
-
* @stability experimental
|
|
174
|
-
*/
|
|
175
|
-
readonly testdir?: string;
|
|
176
|
-
/**
|
|
177
|
-
* Typescript sources directory.
|
|
178
|
-
* @default "src"
|
|
179
|
-
* @stability experimental
|
|
180
|
-
*/
|
|
181
|
-
readonly srcdir?: string;
|
|
182
|
-
/**
|
|
183
|
-
* Options for .projenrc.ts.
|
|
184
|
-
* @stability experimental
|
|
185
|
-
*/
|
|
186
|
-
readonly projenrcTsOptions?: typescript.ProjenrcOptions;
|
|
187
|
-
/**
|
|
188
|
-
* Use TypeScript for your projenrc file (`.projenrc.ts`).
|
|
189
|
-
* @default false
|
|
190
|
-
* @stability experimental
|
|
191
|
-
* @pjnew true
|
|
192
|
-
*/
|
|
193
|
-
readonly projenrcTs?: boolean;
|
|
194
|
-
/**
|
|
195
|
-
* Typescript artifacts output directory.
|
|
196
|
-
* @default "lib"
|
|
197
|
-
* @stability experimental
|
|
198
|
-
*/
|
|
199
|
-
readonly libdir?: string;
|
|
200
|
-
/**
|
|
201
|
-
* The .d.ts file that includes the type declarations for this module.
|
|
202
|
-
* @default - .d.ts file derived from the project's entrypoint (usually lib/index.d.ts)
|
|
203
|
-
* @stability experimental
|
|
204
|
-
*/
|
|
205
|
-
readonly entrypointTypes?: string;
|
|
206
|
-
/**
|
|
207
|
-
* Docs directory.
|
|
208
|
-
* @default "docs"
|
|
209
|
-
* @stability experimental
|
|
210
|
-
*/
|
|
211
|
-
readonly docsDirectory?: string;
|
|
212
|
-
/**
|
|
213
|
-
* Docgen by Typedoc.
|
|
214
|
-
* @default false
|
|
215
|
-
* @stability experimental
|
|
216
|
-
*/
|
|
217
|
-
readonly docgen?: boolean;
|
|
218
|
-
/**
|
|
219
|
-
* Do not generate a `tsconfig.dev.json` file.
|
|
220
|
-
* @default false
|
|
221
|
-
* @stability experimental
|
|
222
|
-
*/
|
|
223
|
-
readonly disableTsconfigDev?: boolean;
|
|
224
|
-
/**
|
|
225
|
-
* Do not generate a `tsconfig.json` file (used by jsii projects since tsconfig.json is generated by the jsii compiler).
|
|
226
|
-
* @default false
|
|
227
|
-
* @stability experimental
|
|
228
|
-
*/
|
|
229
|
-
readonly disableTsconfig?: boolean;
|
|
230
|
-
/**
|
|
231
|
-
* Enable Node.js package cache in GitHub workflows.
|
|
232
|
-
* @default false
|
|
233
|
-
* @stability experimental
|
|
234
|
-
*/
|
|
235
|
-
readonly workflowPackageCache?: boolean;
|
|
236
|
-
/**
|
|
237
|
-
* The node version used in GitHub Actions workflows.
|
|
238
|
-
* Always use this option if your GitHub Actions workflows require a specific to run.
|
|
239
|
-
* @default - `minNodeVersion` if set, otherwise `lts/*`.
|
|
240
|
-
* @stability experimental
|
|
241
|
-
*/
|
|
242
|
-
readonly workflowNodeVersion?: string;
|
|
243
|
-
/**
|
|
244
|
-
* The git identity to use in workflows.
|
|
245
|
-
* @default - default GitHub Actions user
|
|
246
|
-
* @stability experimental
|
|
247
|
-
*/
|
|
248
|
-
readonly workflowGitIdentity?: github.GitIdentity;
|
|
249
|
-
/**
|
|
250
|
-
* Workflow steps to use in order to bootstrap this repo.
|
|
251
|
-
* @default "yarn install --frozen-lockfile && yarn projen"
|
|
252
|
-
* @stability experimental
|
|
253
|
-
*/
|
|
254
|
-
readonly workflowBootstrapSteps?: Array<github.workflows.JobStep>;
|
|
255
|
-
/**
|
|
256
|
-
* Automatically release to npm when new versions are introduced.
|
|
257
|
-
* @default false
|
|
258
|
-
* @stability experimental
|
|
259
|
-
*/
|
|
260
|
-
readonly releaseToNpm?: boolean;
|
|
261
|
-
/**
|
|
262
|
-
* Add release management to this project.
|
|
263
|
-
* @default - true (false for subprojects)
|
|
264
|
-
* @stability experimental
|
|
265
|
-
*/
|
|
266
|
-
readonly release?: boolean;
|
|
267
|
-
/**
|
|
268
|
-
* The contents of the pull request template.
|
|
269
|
-
* @default - default content
|
|
270
|
-
* @stability experimental
|
|
271
|
-
*/
|
|
272
|
-
readonly pullRequestTemplateContents?: Array<string>;
|
|
273
|
-
/**
|
|
274
|
-
* Include a GitHub pull request template.
|
|
275
|
-
* @default true
|
|
276
|
-
* @stability experimental
|
|
277
|
-
*/
|
|
278
|
-
readonly pullRequestTemplate?: boolean;
|
|
279
|
-
/**
|
|
280
|
-
* Version of projen to install.
|
|
281
|
-
* @default - Defaults to the latest version.
|
|
282
|
-
* @stability experimental
|
|
283
|
-
*/
|
|
284
|
-
readonly projenVersion?: string;
|
|
285
|
-
/**
|
|
286
|
-
* Options for .projenrc.js.
|
|
287
|
-
* @default - default options
|
|
288
|
-
* @stability experimental
|
|
289
|
-
*/
|
|
290
|
-
readonly projenrcJsOptions?: javascript.ProjenrcOptions;
|
|
291
|
-
/**
|
|
292
|
-
* Generate (once) .projenrc.js (in JavaScript). Set to `false` in order to disable .projenrc.js generation.
|
|
293
|
-
* @default - true if projenrcJson is false
|
|
294
|
-
* @stability experimental
|
|
295
|
-
*/
|
|
296
|
-
readonly projenrcJs?: boolean;
|
|
297
|
-
/**
|
|
298
|
-
* Indicates of "projen" should be installed as a devDependency.
|
|
299
|
-
* @default - true if not a subproject
|
|
300
|
-
* @stability experimental
|
|
301
|
-
*/
|
|
302
|
-
readonly projenDevDependency?: boolean;
|
|
303
|
-
/**
|
|
304
|
-
* Defines a `package` task that will produce an npm tarball under the artifacts directory (e.g. `dist`).
|
|
305
|
-
* @default true
|
|
306
|
-
* @stability experimental
|
|
307
|
-
*/
|
|
308
|
-
readonly package?: boolean;
|
|
309
|
-
/**
|
|
310
|
-
* Configuration options for .npmignore file.
|
|
311
|
-
* @stability experimental
|
|
312
|
-
*/
|
|
313
|
-
readonly npmIgnoreOptions?: IgnoreFileOptions;
|
|
314
|
-
/**
|
|
315
|
-
* Defines an .npmignore file. Normally this is only needed for libraries that are packaged as tarballs.
|
|
316
|
-
* @default true
|
|
317
|
-
* @stability experimental
|
|
318
|
-
*/
|
|
319
|
-
readonly npmignoreEnabled?: boolean;
|
|
320
|
-
/**
|
|
321
|
-
* Additional entries to .gitignore.
|
|
322
|
-
* @stability experimental
|
|
323
|
-
*/
|
|
324
|
-
readonly gitignore?: Array<string>;
|
|
325
|
-
/**
|
|
326
|
-
* Options for `UpgradeDependencies`.
|
|
327
|
-
* @default - default options
|
|
328
|
-
* @stability experimental
|
|
329
|
-
*/
|
|
330
|
-
readonly depsUpgradeOptions?: javascript.UpgradeDependenciesOptions;
|
|
331
|
-
/**
|
|
332
|
-
* Use tasks and github workflows to handle dependency upgrades.
|
|
333
|
-
* Cannot be used in conjunction with `dependabot`.
|
|
334
|
-
* @default true
|
|
335
|
-
* @stability experimental
|
|
336
|
-
*/
|
|
337
|
-
readonly depsUpgrade?: boolean;
|
|
338
|
-
/**
|
|
339
|
-
* Options for dependabot.
|
|
340
|
-
* @default - default options
|
|
341
|
-
* @stability experimental
|
|
342
|
-
*/
|
|
343
|
-
readonly dependabotOptions?: github.DependabotOptions;
|
|
344
|
-
/**
|
|
345
|
-
* Use dependabot to handle dependency upgrades.
|
|
346
|
-
* Cannot be used in conjunction with `depsUpgrade`.
|
|
347
|
-
* @default false
|
|
348
|
-
* @stability experimental
|
|
349
|
-
*/
|
|
350
|
-
readonly dependabot?: boolean;
|
|
351
|
-
/**
|
|
352
|
-
* The copyright years to put in the LICENSE file.
|
|
353
|
-
* @default - current year
|
|
354
|
-
* @stability experimental
|
|
355
|
-
*/
|
|
356
|
-
readonly copyrightPeriod?: string;
|
|
357
|
-
/**
|
|
358
|
-
* License copyright owner.
|
|
359
|
-
* @default - defaults to the value of authorName or "" if `authorName` is undefined.
|
|
360
|
-
* @stability experimental
|
|
361
|
-
*/
|
|
362
|
-
readonly copyrightOwner?: string;
|
|
363
|
-
/**
|
|
364
|
-
* Define the secret name for a specified https://codecov.io/ token.
|
|
365
|
-
* @default - OIDC auth is used
|
|
366
|
-
* @stability experimental
|
|
367
|
-
*/
|
|
368
|
-
readonly codeCovTokenSecret?: string;
|
|
369
|
-
/**
|
|
370
|
-
* Define a GitHub workflow step for sending code coverage metrics to https://codecov.io/ Uses codecov/codecov-action@v5 By default, OIDC auth is used. Alternatively a token can be provided via `codeCovTokenSecret`.
|
|
371
|
-
* @default false
|
|
372
|
-
* @stability experimental
|
|
373
|
-
*/
|
|
374
|
-
readonly codeCov?: boolean;
|
|
375
|
-
/**
|
|
376
|
-
* Configure which licenses should be deemed acceptable for use by dependencies.
|
|
377
|
-
* This setting will cause the build to fail, if any prohibited or not allowed licenses ares encountered.
|
|
378
|
-
* @default - no license checks are run during the build and all licenses will be accepted
|
|
379
|
-
* @stability experimental
|
|
380
|
-
*/
|
|
381
|
-
readonly checkLicenses?: javascript.LicenseCheckerOptions;
|
|
382
|
-
/**
|
|
383
|
-
* Options for `Bundler`.
|
|
384
|
-
* @stability experimental
|
|
385
|
-
*/
|
|
386
|
-
readonly bundlerOptions?: javascript.BundlerOptions;
|
|
387
|
-
/**
|
|
388
|
-
* Options for PR build workflow.
|
|
389
|
-
* @stability experimental
|
|
390
|
-
*/
|
|
391
|
-
readonly buildWorkflowOptions?: javascript.BuildWorkflowOptions;
|
|
392
|
-
/**
|
|
393
|
-
* Define a GitHub workflow for building PRs.
|
|
394
|
-
* @default - true if not a subproject
|
|
395
|
-
* @stability experimental
|
|
396
|
-
*/
|
|
397
|
-
readonly buildWorkflow?: boolean;
|
|
398
|
-
/**
|
|
399
|
-
* Biome options.
|
|
400
|
-
* @default - default options
|
|
401
|
-
* @stability experimental
|
|
402
|
-
*/
|
|
403
|
-
readonly biomeOptions?: javascript.BiomeOptions;
|
|
404
|
-
/**
|
|
405
|
-
* Setup Biome.
|
|
406
|
-
* @default false
|
|
407
|
-
* @stability experimental
|
|
408
|
-
*/
|
|
409
|
-
readonly biome?: boolean;
|
|
410
|
-
/**
|
|
411
|
-
* Automatically approve deps upgrade PRs, allowing them to be merged by mergify (if configued).
|
|
412
|
-
* Throw if set to true but `autoApproveOptions` are not defined.
|
|
413
|
-
* @default - true
|
|
414
|
-
* @stability experimental
|
|
415
|
-
*/
|
|
416
|
-
readonly autoApproveUpgrades?: boolean;
|
|
417
|
-
/**
|
|
418
|
-
* Security audit options.
|
|
419
|
-
* @default - default options
|
|
420
|
-
* @stability experimental
|
|
421
|
-
*/
|
|
422
|
-
readonly auditDepsOptions?: javascript.AuditOptions;
|
|
423
|
-
/**
|
|
424
|
-
* Run security audit on dependencies.
|
|
425
|
-
* When enabled, creates an "audit" task that checks for known security vulnerabilities
|
|
426
|
-
* in dependencies. By default, runs during every build and checks for "high" severity
|
|
427
|
-
* vulnerabilities or above in all dependencies (including dev dependencies).
|
|
428
|
-
* @default false
|
|
429
|
-
* @stability experimental
|
|
430
|
-
*/
|
|
431
|
-
readonly auditDeps?: boolean;
|
|
432
|
-
/**
|
|
433
|
-
* A directory which will contain build artifacts.
|
|
434
|
-
* @default "dist"
|
|
435
|
-
* @stability experimental
|
|
436
|
-
*/
|
|
437
|
-
readonly artifactsDirectory?: string;
|
|
438
|
-
/**
|
|
439
|
-
* The name of the main release branch.
|
|
440
|
-
* @default "main"
|
|
441
|
-
* @stability experimental
|
|
442
|
-
*/
|
|
443
|
-
readonly defaultReleaseBranch: string;
|
|
444
|
-
/**
|
|
445
|
-
* Github Runner Group selection options.
|
|
446
|
-
* @stability experimental
|
|
447
|
-
* @description Defines a target Runner Group by name and/or labels
|
|
448
|
-
* @throws {Error} if both `runsOn` and `runsOnGroup` are specified
|
|
449
|
-
*/
|
|
450
|
-
readonly workflowRunsOnGroup?: GroupRunnerOptions;
|
|
451
|
-
/**
|
|
452
|
-
* Github Runner selection labels.
|
|
453
|
-
* @default ["ubuntu-latest"]
|
|
454
|
-
* @stability experimental
|
|
455
|
-
* @description Defines a target Runner by labels
|
|
456
|
-
* @throws {Error} if both `runsOn` and `runsOnGroup` are specified
|
|
457
|
-
*/
|
|
458
|
-
readonly workflowRunsOn?: Array<string>;
|
|
459
|
-
/**
|
|
460
|
-
* Container image to use for GitHub workflows.
|
|
461
|
-
* @default - default image
|
|
462
|
-
* @stability experimental
|
|
463
|
-
*/
|
|
464
|
-
readonly workflowContainerImage?: string;
|
|
465
|
-
/**
|
|
466
|
-
* Custom configuration used when creating changelog with commit-and-tag-version package.
|
|
467
|
-
* Given values either append to default configuration or overwrite values in it.
|
|
468
|
-
* @default - standard configuration applicable for GitHub repositories
|
|
469
|
-
* @stability experimental
|
|
470
|
-
*/
|
|
471
|
-
readonly versionrcOptions?: Record<string, any>;
|
|
472
|
-
/**
|
|
473
|
-
* A set of workflow steps to execute in order to setup the workflow container.
|
|
474
|
-
* @stability experimental
|
|
475
|
-
*/
|
|
476
|
-
readonly releaseWorkflowSetupSteps?: Array<github.workflows.JobStep>;
|
|
477
|
-
/**
|
|
478
|
-
* The name of the default release workflow.
|
|
479
|
-
* @default "release"
|
|
480
|
-
* @stability experimental
|
|
481
|
-
*/
|
|
482
|
-
readonly releaseWorkflowName?: string;
|
|
483
|
-
/**
|
|
484
|
-
* Build environment variables for release workflows.
|
|
485
|
-
* @default {}
|
|
486
|
-
* @stability experimental
|
|
487
|
-
*/
|
|
488
|
-
readonly releaseWorkflowEnv?: Record<string, string>;
|
|
489
|
-
/**
|
|
490
|
-
* The release trigger to use.
|
|
491
|
-
* @default - Continuous releases (`ReleaseTrigger.continuous()`)
|
|
492
|
-
* @stability experimental
|
|
493
|
-
*/
|
|
494
|
-
readonly releaseTrigger?: release.ReleaseTrigger;
|
|
495
|
-
/**
|
|
496
|
-
* Automatically add the given prefix to release tags. Useful if you are releasing on multiple branches with overlapping version numbers.
|
|
497
|
-
* Note: this prefix is used to detect the latest tagged version
|
|
498
|
-
* when bumping, so if you change this on a project with an existing version
|
|
499
|
-
* history, you may need to manually tag your latest release
|
|
500
|
-
* with the new prefix.
|
|
501
|
-
* @default "v"
|
|
502
|
-
* @stability experimental
|
|
503
|
-
*/
|
|
504
|
-
readonly releaseTagPrefix?: string;
|
|
505
|
-
/**
|
|
506
|
-
* The label to apply to issues indicating publish failures.
|
|
507
|
-
* Only applies if `releaseFailureIssue` is true.
|
|
508
|
-
* @default "failed-release"
|
|
509
|
-
* @stability experimental
|
|
510
|
-
*/
|
|
511
|
-
readonly releaseFailureIssueLabel?: string;
|
|
512
|
-
/**
|
|
513
|
-
* Create a github issue on every failed publishing task.
|
|
514
|
-
* @default false
|
|
515
|
-
* @stability experimental
|
|
516
|
-
*/
|
|
517
|
-
readonly releaseFailureIssue?: boolean;
|
|
518
|
-
/**
|
|
519
|
-
* The GitHub Actions environment used for the release.
|
|
520
|
-
* This can be used to add an explicit approval step to the release
|
|
521
|
-
* or limit who can initiate a release through environment protection rules.
|
|
522
|
-
*
|
|
523
|
-
* When multiple artifacts are released, the environment can be overwritten
|
|
524
|
-
* on a per artifact basis.
|
|
525
|
-
* @default - no environment used, unless set at the artifact level
|
|
526
|
-
* @stability experimental
|
|
527
|
-
*/
|
|
528
|
-
readonly releaseEnvironment?: string;
|
|
529
|
-
/**
|
|
530
|
-
* Defines additional release branches.
|
|
531
|
-
* A workflow will be created for each
|
|
532
|
-
* release branch which will publish releases from commits in this branch.
|
|
533
|
-
* Each release branch _must_ be assigned a major version number which is used
|
|
534
|
-
* to enforce that versions published from that branch always use that major
|
|
535
|
-
* version. If multiple branches are used, the `majorVersion` field must also
|
|
536
|
-
* be provided for the default branch.
|
|
537
|
-
* @default - no additional branches are used for release. you can use
|
|
538
|
-
`addBranch()` to add additional branches.
|
|
539
|
-
* @stability experimental
|
|
540
|
-
*/
|
|
541
|
-
readonly releaseBranches?: Record<string, release.BranchOptions>;
|
|
542
|
-
/**
|
|
543
|
-
* Find commits that should be considered releasable Used to decide if a release is required.
|
|
544
|
-
* @default ReleasableCommits.everyCommit()
|
|
545
|
-
* @stability experimental
|
|
546
|
-
*/
|
|
547
|
-
readonly releasableCommits?: ReleasableCommits;
|
|
548
|
-
/**
|
|
549
|
-
* Define publishing tasks that can be executed manually as well as workflows.
|
|
550
|
-
* Normally, publishing only happens within automated workflows. Enable this
|
|
551
|
-
* in order to create a publishing task for each publishing activity.
|
|
552
|
-
* @default false
|
|
553
|
-
* @stability experimental
|
|
554
|
-
*/
|
|
555
|
-
readonly publishTasks?: boolean;
|
|
556
|
-
/**
|
|
557
|
-
* Instead of actually publishing to package managers, just print the publishing command.
|
|
558
|
-
* @default false
|
|
559
|
-
* @stability experimental
|
|
560
|
-
*/
|
|
561
|
-
readonly publishDryRun?: boolean;
|
|
562
|
-
/**
|
|
563
|
-
* Bump versions from the default branch as pre-releases (e.g. "beta", "alpha", "pre").
|
|
564
|
-
* @default - normal semantic versions
|
|
565
|
-
* @stability experimental
|
|
566
|
-
*/
|
|
567
|
-
readonly prerelease?: string;
|
|
568
|
-
/**
|
|
569
|
-
* Steps to execute after build as part of the release workflow.
|
|
570
|
-
* @default []
|
|
571
|
-
* @stability experimental
|
|
572
|
-
*/
|
|
573
|
-
readonly postBuildSteps?: Array<github.workflows.JobStep>;
|
|
574
|
-
/**
|
|
575
|
-
* The npmDistTag to use when publishing from the default branch.
|
|
576
|
-
* To set the npm dist-tag for release branches, set the `npmDistTag` property
|
|
577
|
-
* for each branch.
|
|
578
|
-
* @default "latest"
|
|
579
|
-
* @stability experimental
|
|
580
|
-
*/
|
|
581
|
-
readonly npmDistTag?: string;
|
|
582
|
-
/**
|
|
583
|
-
* A shell command to control the next version to release.
|
|
584
|
-
* If present, this shell command will be run before the bump is executed, and
|
|
585
|
-
* it determines what version to release. It will be executed in the following
|
|
586
|
-
* environment:
|
|
587
|
-
*
|
|
588
|
-
* - Working directory: the project directory.
|
|
589
|
-
* - `$VERSION`: the current version. Looks like `1.2.3`.
|
|
590
|
-
* - `$LATEST_TAG`: the most recent tag. Looks like `prefix-v1.2.3`, or may be unset.
|
|
591
|
-
* - `$SUGGESTED_BUMP`: the suggested bump action based on commits. One of `major|minor|patch|none`.
|
|
592
|
-
*
|
|
593
|
-
* The command should print one of the following to `stdout`:
|
|
594
|
-
*
|
|
595
|
-
* - Nothing: the next version number will be determined based on commit history.
|
|
596
|
-
* - `x.y.z`: the next version number will be `x.y.z`.
|
|
597
|
-
* - `major|minor|patch`: the next version number will be the current version number
|
|
598
|
-
* with the indicated component bumped.
|
|
599
|
-
*
|
|
600
|
-
* This setting cannot be specified together with `minMajorVersion`; the invoked
|
|
601
|
-
* script can be used to achieve the effects of `minMajorVersion`.
|
|
602
|
-
* @default - The next version will be determined based on the commit history and project settings.
|
|
603
|
-
* @stability experimental
|
|
604
|
-
*/
|
|
605
|
-
readonly nextVersionCommand?: string;
|
|
606
|
-
/**
|
|
607
|
-
* Minimal Major version to release.
|
|
608
|
-
* This can be useful to set to 1, as breaking changes before the 1.x major
|
|
609
|
-
* release are not incrementing the major version number.
|
|
610
|
-
*
|
|
611
|
-
* Can not be set together with `majorVersion`.
|
|
612
|
-
* @default - No minimum version is being enforced
|
|
613
|
-
* @stability experimental
|
|
614
|
-
*/
|
|
615
|
-
readonly minMajorVersion?: number;
|
|
616
|
-
/**
|
|
617
|
-
* Major version to release from the default branch.
|
|
618
|
-
* If this is specified, we bump the latest version of this major version line.
|
|
619
|
-
* If not specified, we bump the global latest version.
|
|
620
|
-
* @default - Major version is not enforced.
|
|
621
|
-
* @stability experimental
|
|
622
|
-
*/
|
|
623
|
-
readonly majorVersion?: number;
|
|
624
|
-
/**
|
|
625
|
-
* Version requirement of `publib` which is used to publish modules to npm.
|
|
626
|
-
* @default "latest"
|
|
627
|
-
* @stability experimental
|
|
628
|
-
*/
|
|
629
|
-
readonly jsiiReleaseVersion?: string;
|
|
630
|
-
/**
|
|
631
|
-
* The `commit-and-tag-version` compatible package used to bump the package version, as a dependency string.
|
|
632
|
-
* This can be any compatible package version, including the deprecated `standard-version@9`.
|
|
633
|
-
* @default - A recent version of "commit-and-tag-version"
|
|
634
|
-
* @stability experimental
|
|
635
|
-
*/
|
|
636
|
-
readonly bumpPackage?: string;
|
|
637
|
-
/**
|
|
638
|
-
* Options for Yarn Berry.
|
|
639
|
-
* @default - Yarn Berry v4 with all default options
|
|
640
|
-
* @stability experimental
|
|
641
|
-
*/
|
|
642
|
-
readonly yarnBerryOptions?: javascript.YarnBerryOptions;
|
|
643
|
-
/**
|
|
644
|
-
* Package's Stability.
|
|
645
|
-
* @stability experimental
|
|
646
|
-
*/
|
|
647
|
-
readonly stability?: string;
|
|
648
|
-
/**
|
|
649
|
-
* Options for privately hosted scoped packages.
|
|
650
|
-
* @default - fetch all scoped packages from the public npm registry
|
|
651
|
-
* @stability experimental
|
|
652
|
-
*/
|
|
653
|
-
readonly scopedPackagesOptions?: Array<javascript.ScopedPackagesOptions>;
|
|
654
|
-
/**
|
|
655
|
-
* If the package.json for your package is not in the root directory (for example if it is part of a monorepo), you can specify the directory in which it lives.
|
|
656
|
-
* @stability experimental
|
|
657
|
-
*/
|
|
658
|
-
readonly repositoryDirectory?: string;
|
|
659
|
-
/**
|
|
660
|
-
* The repository is the location where the actual code for your package lives.
|
|
661
|
-
* See https://classic.yarnpkg.com/en/docs/package-json/#toc-repository
|
|
662
|
-
* @stability experimental
|
|
663
|
-
*/
|
|
664
|
-
readonly repository?: string;
|
|
665
|
-
/**
|
|
666
|
-
* The version of PNPM to use if using PNPM as a package manager.
|
|
667
|
-
* @default "9"
|
|
668
|
-
* @stability experimental
|
|
669
|
-
*/
|
|
670
|
-
readonly pnpmVersion?: string;
|
|
671
|
-
/**
|
|
672
|
-
* Peer dependencies for this module.
|
|
673
|
-
* Dependencies listed here are required to
|
|
674
|
-
* be installed (and satisfied) by the _consumer_ of this library. Using peer
|
|
675
|
-
* dependencies allows you to ensure that only a single module of a certain
|
|
676
|
-
* library exists in the `node_modules` tree of your consumers.
|
|
677
|
-
*
|
|
678
|
-
* Note that prior to npm@7, peer dependencies are _not_ automatically
|
|
679
|
-
* installed, which means that adding peer dependencies to a library will be a
|
|
680
|
-
* breaking change for your customers.
|
|
681
|
-
*
|
|
682
|
-
* Unless `peerDependencyOptions.pinnedDevDependency` is disabled (it is
|
|
683
|
-
* enabled by default), projen will automatically add a dev dependency with a
|
|
684
|
-
* pinned version for each peer dependency. This will ensure that you build &
|
|
685
|
-
* test your module against the lowest peer version required.
|
|
686
|
-
* @default []
|
|
687
|
-
* @stability experimental
|
|
688
|
-
*/
|
|
689
|
-
readonly peerDeps?: Array<string>;
|
|
690
|
-
/**
|
|
691
|
-
* Options for `peerDeps`.
|
|
692
|
-
* @stability experimental
|
|
693
|
-
*/
|
|
694
|
-
readonly peerDependencyOptions?: javascript.PeerDependencyOptions;
|
|
695
|
-
/**
|
|
696
|
-
* The "name" in package.json.
|
|
697
|
-
* @default - defaults to project name
|
|
698
|
-
* @stability experimental
|
|
699
|
-
* @featured true
|
|
700
|
-
*/
|
|
701
|
-
readonly packageName?: string;
|
|
702
|
-
/**
|
|
703
|
-
* The Node Package Manager used to execute scripts.
|
|
704
|
-
* @default NodePackageManager.YARN_CLASSIC
|
|
705
|
-
* @stability experimental
|
|
706
|
-
*/
|
|
707
|
-
readonly packageManager?: javascript.NodePackageManager;
|
|
708
|
-
/**
|
|
709
|
-
* Use trusted publishing for publishing to npmjs.com Needs to be pre-configured on npm.js to work.
|
|
710
|
-
* @default - false
|
|
711
|
-
* @stability experimental
|
|
712
|
-
*/
|
|
713
|
-
readonly npmTrustedPublishing?: boolean;
|
|
714
|
-
/**
|
|
715
|
-
* GitHub secret which contains the NPM token to use when publishing packages.
|
|
716
|
-
* @default "NPM_TOKEN"
|
|
717
|
-
* @stability experimental
|
|
718
|
-
*/
|
|
719
|
-
readonly npmTokenSecret?: string;
|
|
720
|
-
/**
|
|
721
|
-
* The base URL of the npm package registry.
|
|
722
|
-
* Must be a URL (e.g. start with "https://" or "http://")
|
|
723
|
-
* @default "https://registry.npmjs.org"
|
|
724
|
-
* @stability experimental
|
|
725
|
-
*/
|
|
726
|
-
readonly npmRegistryUrl?: string;
|
|
727
|
-
/**
|
|
728
|
-
* Should provenance statements be generated when the package is published.
|
|
729
|
-
* A supported package manager is required to publish a package with npm provenance statements and
|
|
730
|
-
* you will need to use a supported CI/CD provider.
|
|
731
|
-
*
|
|
732
|
-
* Note that the projen `Release` and `Publisher` components are using `publib` to publish packages,
|
|
733
|
-
* which is using npm internally and supports provenance statements independently of the package manager used.
|
|
734
|
-
* @default - true for public packages, false otherwise
|
|
735
|
-
* @stability experimental
|
|
736
|
-
*/
|
|
737
|
-
readonly npmProvenance?: boolean;
|
|
738
|
-
/**
|
|
739
|
-
* Access level of the npm package.
|
|
740
|
-
* @default - for scoped packages (e.g. `foo@bar`), the default is
|
|
741
|
-
`NpmAccess.RESTRICTED`, for non-scoped packages, the default is
|
|
742
|
-
`NpmAccess.PUBLIC`.
|
|
743
|
-
* @stability experimental
|
|
744
|
-
*/
|
|
745
|
-
readonly npmAccess?: javascript.NpmAccess;
|
|
746
|
-
/**
|
|
747
|
-
* The minimum node version required by this package to function. Most projects should not use this option.
|
|
748
|
-
* The value indicates that the package is incompatible with any older versions of node.
|
|
749
|
-
* This requirement is enforced via the engines field.
|
|
750
|
-
*
|
|
751
|
-
* You will normally not need to set this option, even if your package is incompatible with EOL versions of node.
|
|
752
|
-
* Consider this option only if your package depends on a specific feature, that is not available in other LTS versions.
|
|
753
|
-
* Setting this option has very high impact on the consumers of your package,
|
|
754
|
-
* as package managers will actively prevent usage with node versions you have marked as incompatible.
|
|
755
|
-
*
|
|
756
|
-
* To change the node version of your CI/CD workflows, use `workflowNodeVersion`.
|
|
757
|
-
* @default - no minimum version is enforced
|
|
758
|
-
* @stability experimental
|
|
759
|
-
*/
|
|
760
|
-
readonly minNodeVersion?: string;
|
|
761
|
-
/**
|
|
762
|
-
* The maximum node version supported by this package. Most projects should not use this option.
|
|
763
|
-
* The value indicates that the package is incompatible with any newer versions of node.
|
|
764
|
-
* This requirement is enforced via the engines field.
|
|
765
|
-
*
|
|
766
|
-
* You will normally not need to set this option.
|
|
767
|
-
* Consider this option only if your package is known to not function with newer versions of node.
|
|
768
|
-
* @default - no maximum version is enforced
|
|
769
|
-
* @stability experimental
|
|
770
|
-
*/
|
|
771
|
-
readonly maxNodeVersion?: string;
|
|
772
|
-
/**
|
|
773
|
-
* Indicates if a license should be added.
|
|
774
|
-
* @default true
|
|
775
|
-
* @stability experimental
|
|
776
|
-
*/
|
|
777
|
-
readonly licensed?: boolean;
|
|
778
|
-
/**
|
|
779
|
-
* License's SPDX identifier.
|
|
780
|
-
* See https://github.com/projen/projen/tree/main/license-text for a list of supported licenses.
|
|
781
|
-
* Use the `licensed` option if you want to no license to be specified.
|
|
782
|
-
* @default "Apache-2.0"
|
|
783
|
-
* @stability experimental
|
|
784
|
-
*/
|
|
785
|
-
readonly license?: string;
|
|
786
|
-
/**
|
|
787
|
-
* Keywords to include in `package.json`.
|
|
788
|
-
* @stability experimental
|
|
789
|
-
*/
|
|
790
|
-
readonly keywords?: Array<string>;
|
|
791
|
-
/**
|
|
792
|
-
* Package's Homepage / Website.
|
|
793
|
-
* @stability experimental
|
|
794
|
-
*/
|
|
795
|
-
readonly homepage?: string;
|
|
796
|
-
/**
|
|
797
|
-
* Module entrypoint (`main` in `package.json`).
|
|
798
|
-
* Set to an empty string to not include `main` in your package.json
|
|
799
|
-
* @default "lib/index.js"
|
|
800
|
-
* @stability experimental
|
|
801
|
-
*/
|
|
802
|
-
readonly entrypoint?: string;
|
|
803
|
-
/**
|
|
804
|
-
* Build dependencies for this module.
|
|
805
|
-
* These dependencies will only be
|
|
806
|
-
* available in your build environment but will not be fetched when this
|
|
807
|
-
* module is consumed.
|
|
808
|
-
*
|
|
809
|
-
* The recommendation is to only specify the module name here (e.g.
|
|
810
|
-
* `express`). This will behave similar to `yarn add` or `npm install` in the
|
|
811
|
-
* sense that it will add the module as a dependency to your `package.json`
|
|
812
|
-
* file with the latest version (`^`). You can specify semver requirements in
|
|
813
|
-
* the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
814
|
-
* this will be what you `package.json` will eventually include.
|
|
815
|
-
* @default []
|
|
816
|
-
* @stability experimental
|
|
817
|
-
* @featured true
|
|
818
|
-
*/
|
|
819
|
-
readonly devDeps?: Array<string>;
|
|
820
|
-
/**
|
|
821
|
-
* The description is just a string that helps people understand the purpose of the package.
|
|
822
|
-
* It can be used when searching for packages in a package manager as well.
|
|
823
|
-
* See https://classic.yarnpkg.com/en/docs/package-json/#toc-description
|
|
824
|
-
* @stability experimental
|
|
825
|
-
* @featured true
|
|
826
|
-
*/
|
|
827
|
-
readonly description?: string;
|
|
828
|
-
/**
|
|
829
|
-
* Runtime dependencies of this module.
|
|
830
|
-
* The recommendation is to only specify the module name here (e.g.
|
|
831
|
-
* `express`). This will behave similar to `yarn add` or `npm install` in the
|
|
832
|
-
* sense that it will add the module as a dependency to your `package.json`
|
|
833
|
-
* file with the latest version (`^`). You can specify semver requirements in
|
|
834
|
-
* the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
835
|
-
* this will be what you `package.json` will eventually include.
|
|
836
|
-
* @default []
|
|
837
|
-
* @stability experimental
|
|
838
|
-
* @featured true
|
|
839
|
-
*/
|
|
840
|
-
readonly deps?: Array<string>;
|
|
841
|
-
/**
|
|
842
|
-
* Options for npm packages using AWS CodeArtifact.
|
|
843
|
-
* This is required if publishing packages to, or installing scoped packages from AWS CodeArtifact
|
|
844
|
-
* @default - undefined
|
|
845
|
-
* @stability experimental
|
|
846
|
-
*/
|
|
847
|
-
readonly codeArtifactOptions?: javascript.CodeArtifactOptions;
|
|
848
|
-
/**
|
|
849
|
-
* The version of Bun to use if using Bun as a package manager.
|
|
850
|
-
* @default "latest"
|
|
851
|
-
* @stability experimental
|
|
852
|
-
*/
|
|
853
|
-
readonly bunVersion?: string;
|
|
854
|
-
/**
|
|
855
|
-
* List of dependencies to bundle into this module.
|
|
856
|
-
* These modules will be
|
|
857
|
-
* added both to the `dependencies` section and `bundledDependencies` section of
|
|
858
|
-
* your `package.json`.
|
|
859
|
-
*
|
|
860
|
-
* The recommendation is to only specify the module name here (e.g.
|
|
861
|
-
* `express`). This will behave similar to `yarn add` or `npm install` in the
|
|
862
|
-
* sense that it will add the module as a dependency to your `package.json`
|
|
863
|
-
* file with the latest version (`^`). You can specify semver requirements in
|
|
864
|
-
* the same syntax passed to `npm i` or `yarn add` (e.g. `express@^2`) and
|
|
865
|
-
* this will be what you `package.json` will eventually include.
|
|
866
|
-
* @stability experimental
|
|
867
|
-
*/
|
|
868
|
-
readonly bundledDeps?: Array<string>;
|
|
869
|
-
/**
|
|
870
|
-
* The url to your project's issue tracker.
|
|
871
|
-
* @stability experimental
|
|
872
|
-
*/
|
|
873
|
-
readonly bugsUrl?: string;
|
|
874
|
-
/**
|
|
875
|
-
* The email address to which issues should be reported.
|
|
876
|
-
* @stability experimental
|
|
877
|
-
*/
|
|
878
|
-
readonly bugsEmail?: string;
|
|
879
|
-
/**
|
|
880
|
-
* Binary programs vended with your module.
|
|
881
|
-
* You can use this option to add/customize how binaries are represented in
|
|
882
|
-
* your `package.json`, but unless `autoDetectBin` is `false`, every
|
|
883
|
-
* executable file under `bin` will automatically be added to this section.
|
|
884
|
-
* @stability experimental
|
|
885
|
-
*/
|
|
886
|
-
readonly bin?: Record<string, string>;
|
|
887
|
-
/**
|
|
888
|
-
* Automatically add all executables under the `bin` directory to your `package.json` file under the `bin` section.
|
|
889
|
-
* @default true
|
|
890
|
-
* @stability experimental
|
|
891
|
-
*/
|
|
892
|
-
readonly autoDetectBin?: boolean;
|
|
893
|
-
/**
|
|
894
|
-
* Author's URL / Website.
|
|
895
|
-
* @stability experimental
|
|
896
|
-
*/
|
|
897
|
-
readonly authorUrl?: string;
|
|
898
|
-
/**
|
|
899
|
-
* Is the author an organization.
|
|
900
|
-
* @stability experimental
|
|
901
|
-
*/
|
|
902
|
-
readonly authorOrganization?: boolean;
|
|
903
|
-
/**
|
|
904
|
-
* Author's name.
|
|
905
|
-
* @stability experimental
|
|
906
|
-
*/
|
|
907
|
-
readonly authorName?: string;
|
|
908
|
-
/**
|
|
909
|
-
* Author's e-mail.
|
|
910
|
-
* @stability experimental
|
|
911
|
-
*/
|
|
912
|
-
readonly authorEmail?: string;
|
|
913
|
-
/**
|
|
914
|
-
* Allow the project to include `peerDependencies` and `bundledDependencies`.
|
|
915
|
-
* This is normally only allowed for libraries. For apps, there's no meaning
|
|
916
|
-
* for specifying these.
|
|
917
|
-
* @default true
|
|
918
|
-
* @stability experimental
|
|
919
|
-
*/
|
|
920
|
-
readonly allowLibraryDependencies?: boolean;
|
|
921
|
-
/**
|
|
922
|
-
* Enable VSCode integration.
|
|
923
|
-
* Enabled by default for root projects. Disabled for non-root projects.
|
|
924
|
-
* @default true
|
|
925
|
-
* @stability experimental
|
|
926
|
-
*/
|
|
927
|
-
readonly vscode?: boolean;
|
|
928
|
-
/**
|
|
929
|
-
* Auto-close stale issues and pull requests.
|
|
930
|
-
* To disable set `stale` to `false`.
|
|
931
|
-
* @default - see defaults in `StaleOptions`
|
|
932
|
-
* @stability experimental
|
|
933
|
-
*/
|
|
934
|
-
readonly staleOptions?: github.StaleOptions;
|
|
935
|
-
/**
|
|
936
|
-
* Auto-close of stale issues and pull request.
|
|
937
|
-
* See `staleOptions` for options.
|
|
938
|
-
* @default false
|
|
939
|
-
* @stability experimental
|
|
940
|
-
*/
|
|
941
|
-
readonly stale?: boolean;
|
|
942
|
-
/**
|
|
943
|
-
* The README setup.
|
|
944
|
-
* @default - { filename: 'README.md', contents: '# replace this' }
|
|
945
|
-
* @stability experimental
|
|
946
|
-
*/
|
|
947
|
-
readonly readme?: SampleReadmeProps;
|
|
948
|
-
/**
|
|
949
|
-
* Choose a method of providing GitHub API access for projen workflows.
|
|
950
|
-
* @default - use a personal access token named PROJEN_GITHUB_TOKEN
|
|
951
|
-
* @stability experimental
|
|
952
|
-
*/
|
|
953
|
-
readonly projenCredentials?: github.GithubCredentials;
|
|
954
|
-
/**
|
|
955
|
-
* Add a Gitpod development environment.
|
|
956
|
-
* @default false
|
|
957
|
-
* @stability experimental
|
|
958
|
-
*/
|
|
959
|
-
readonly gitpod?: boolean;
|
|
960
|
-
/**
|
|
961
|
-
* Options for GitHub integration.
|
|
962
|
-
* @default - see GitHubOptions
|
|
963
|
-
* @stability experimental
|
|
964
|
-
*/
|
|
965
|
-
readonly githubOptions?: github.GitHubOptions;
|
|
966
|
-
/**
|
|
967
|
-
* Enable GitHub integration.
|
|
968
|
-
* Enabled by default for root projects. Disabled for non-root projects.
|
|
969
|
-
* @default true
|
|
970
|
-
* @stability experimental
|
|
971
|
-
*/
|
|
972
|
-
readonly github?: boolean;
|
|
973
|
-
/**
|
|
974
|
-
* Add a VSCode development environment (used for GitHub Codespaces).
|
|
975
|
-
* @default false
|
|
976
|
-
* @stability experimental
|
|
977
|
-
*/
|
|
978
|
-
readonly devContainer?: boolean;
|
|
979
|
-
/**
|
|
980
|
-
* Add a `clobber` task which resets the repo to origin.
|
|
981
|
-
* @default - true, but false for subprojects
|
|
982
|
-
* @stability experimental
|
|
983
|
-
*/
|
|
984
|
-
readonly clobber?: boolean;
|
|
985
|
-
/**
|
|
986
|
-
* Configure options for automatic merging on GitHub.
|
|
987
|
-
* Has no effect if
|
|
988
|
-
* `github.mergify` or `autoMerge` is set to false.
|
|
989
|
-
* @default - see defaults in `AutoMergeOptions`
|
|
990
|
-
* @stability experimental
|
|
991
|
-
*/
|
|
992
|
-
readonly autoMergeOptions?: github.AutoMergeOptions;
|
|
993
|
-
/**
|
|
994
|
-
* Enable automatic merging on GitHub.
|
|
995
|
-
* Has no effect if `github.mergify`
|
|
996
|
-
* is set to false.
|
|
997
|
-
* @default true
|
|
998
|
-
* @stability experimental
|
|
999
|
-
*/
|
|
1000
|
-
readonly autoMerge?: boolean;
|
|
1001
|
-
/**
|
|
1002
|
-
* Enable and configure the 'auto approve' workflow.
|
|
1003
|
-
* @default - auto approve is disabled
|
|
1004
|
-
* @stability experimental
|
|
1005
|
-
*/
|
|
1006
|
-
readonly autoApproveOptions?: github.AutoApproveOptions;
|
|
1007
|
-
/**
|
|
1008
|
-
* Options for renovatebot.
|
|
1009
|
-
* @default - default options
|
|
1010
|
-
* @stability experimental
|
|
1011
|
-
*/
|
|
1012
|
-
readonly renovatebotOptions?: RenovatebotOptions;
|
|
1013
|
-
/**
|
|
1014
|
-
* Use renovatebot to handle dependency upgrades.
|
|
1015
|
-
* @default false
|
|
1016
|
-
* @stability experimental
|
|
1017
|
-
*/
|
|
1018
|
-
readonly renovatebot?: boolean;
|
|
1019
|
-
/**
|
|
1020
|
-
* Options for .projenrc.json.
|
|
1021
|
-
* @default - default options
|
|
1022
|
-
* @stability experimental
|
|
1023
|
-
*/
|
|
1024
|
-
readonly projenrcJsonOptions?: ProjenrcJsonOptions;
|
|
1025
|
-
/**
|
|
1026
|
-
* Generate (once) .projenrc.json (in JSON). Set to `false` in order to disable .projenrc.json generation.
|
|
1027
|
-
* @default false
|
|
1028
|
-
* @stability experimental
|
|
1029
|
-
*/
|
|
1030
|
-
readonly projenrcJson?: boolean;
|
|
1031
|
-
/**
|
|
1032
|
-
* The shell command to use in order to run the projen CLI.
|
|
1033
|
-
* Can be used to customize in special environments.
|
|
1034
|
-
* @default "npx projen"
|
|
1035
|
-
* @stability experimental
|
|
1036
|
-
*/
|
|
1037
|
-
readonly projenCommand?: string;
|
|
1038
|
-
/**
|
|
1039
|
-
* The parent project, if this project is part of a bigger project.
|
|
1040
|
-
* @stability experimental
|
|
1041
|
-
*/
|
|
1042
|
-
readonly parent?: Project;
|
|
1043
|
-
/**
|
|
1044
|
-
* The root directory of the project.
|
|
1045
|
-
* Relative to this directory, all files are synthesized.
|
|
1046
|
-
*
|
|
1047
|
-
* If this project has a parent, this directory is relative to the parent
|
|
1048
|
-
* directory and it cannot be the same as the parent or any of it's other
|
|
1049
|
-
* subprojects.
|
|
1050
|
-
* @default "."
|
|
1051
|
-
* @stability experimental
|
|
1052
|
-
*/
|
|
1053
|
-
readonly outdir?: string;
|
|
1054
|
-
/**
|
|
1055
|
-
* Configure logging options such as verbosity.
|
|
1056
|
-
* @default {}
|
|
1057
|
-
* @stability experimental
|
|
1058
|
-
*/
|
|
1059
|
-
readonly logging?: LoggerOptions;
|
|
1060
|
-
/**
|
|
1061
|
-
* Configuration options for git.
|
|
1062
|
-
* @stability experimental
|
|
1063
|
-
*/
|
|
1064
|
-
readonly gitOptions?: GitOptions;
|
|
1065
|
-
/**
|
|
1066
|
-
* Configuration options for .gitignore file.
|
|
1067
|
-
* @stability experimental
|
|
1068
|
-
*/
|
|
1069
|
-
readonly gitIgnoreOptions?: IgnoreFileOptions;
|
|
1070
|
-
/**
|
|
1071
|
-
* Whether to commit the managed files by default.
|
|
1072
|
-
* @default true
|
|
1073
|
-
* @stability experimental
|
|
1074
|
-
*/
|
|
1075
|
-
readonly commitGenerated?: boolean;
|
|
1076
|
-
/**
|
|
1077
|
-
* This is the name of your project.
|
|
1078
|
-
* @default $BASEDIR
|
|
1079
|
-
* @stability experimental
|
|
1080
|
-
* @featured true
|
|
1081
|
-
*/
|
|
1082
|
-
readonly name: string;
|
|
1083
|
-
/**
|
|
1084
|
-
* The Vitest configuration (when enabled).
|
|
1085
|
-
* @default - default Vitest configuration
|
|
1086
|
-
*/
|
|
1087
|
-
readonly vitestOptions?: VitestOptions;
|
|
1088
|
-
/**
|
|
1089
|
-
* Enable testing with Vitest.
|
|
1090
|
-
* @default true
|
|
1091
|
-
*/
|
|
1092
|
-
readonly vitest?: boolean;
|
|
1093
|
-
/**
|
|
1094
|
-
* Create mise.toml with project Node.js version
|
|
1095
|
-
* @default true
|
|
1096
|
-
*/
|
|
1097
|
-
readonly mise?: boolean;
|
|
1098
|
-
}
|