projen 0.71.13 → 0.71.15

package/lib/.types-compat/ts3.9/lib/javascript/typescript-config.d.ts

@@ -1,403 +0,0 @@
-import { Component } from "../component";
-import { JsonFile } from "../json";
-import { Project } from "../project";
-export interface TypescriptConfigOptions {
-    /**
-     * @default "tsconfig.json"
-     */
-    readonly fileName?: string;
-    /**
-     * Specifies a list of glob patterns that match TypeScript files to be included in compilation.
-     *
-     * @default - all .ts files recursively
-     */
-    readonly include?: string[];
-    /**
-     * Filters results from the "include" option.
-     *
-     * @default - node_modules is excluded by default
-     */
-    readonly exclude?: string[];
-    /**
-     * Compiler options to use.
-     */
-    readonly compilerOptions: TypeScriptCompilerOptions;
-}
-/**
- * Determines how modules get resolved.
- *
- * @see https://www.typescriptlang.org/docs/handbook/module-resolution.html
- */
-export declare enum TypeScriptModuleResolution {
-    /**
-     * TypeScript's former default resolution strategy.
-     *
-     * @see https://www.typescriptlang.org/docs/handbook/module-resolution.html#classic
-     */
-    CLASSIC = "classic",
-    /**
-     * Resolution strategy which attempts to mimic the Node.js module resolution strategy at runtime.
-     *
-     * @see https://www.typescriptlang.org/docs/handbook/module-resolution.html#node
-     */
-    NODE = "node",
-    /**
-     * Node.js’ ECMAScript Module Support from TypeScript 4.7 onwards
-     *
-     * @see https://www.typescriptlang.org/tsconfig#moduleResolution
-     */
-    NODE16 = "node16",
-    /**
-     * Node.js’ ECMAScript Module Support from TypeScript 4.7 onwards
-     *
-     * @see https://www.typescriptlang.org/tsconfig#moduleResolution
-     */
-    NODE_NEXT = "nodenext"
-}
-/**
- * This flag controls how `import` works, there are 3 different options.
- *
- * @see https://www.typescriptlang.org/tsconfig#importsNotUsedAsValues
- */
-export declare enum TypeScriptImportsNotUsedAsValues {
-    /**
-     * The default behavior of dropping `import` statements which only reference types.
-     */
-    REMOVE = "remove",
-    /**
-     * Preserves all `import` statements whose values or types are never used. This can cause imports/side-effects to be preserved.
-     */
-    PRESERVE = "preserve",
-    /**
-     * This preserves all imports (the same as the preserve option), but will error when a value import is only used as a type.
-     * This might be useful if you want to ensure no values are being accidentally imported, but still make side-effect imports explicit.
-     */
-    ERROR = "error"
-}
-/**
- * Determines how JSX should get transformed into valid JavaScript.
- *
- * @see https://www.typescriptlang.org/docs/handbook/jsx.html
- */
-export declare enum TypeScriptJsxMode {
-    /**
-     * Keeps the JSX as part of the output to be further consumed by another transform step (e.g. Babel).
-     */
-    PRESERVE = "preserve",
-    /**
-     * Converts JSX syntax into React.createElement, does not need to go through a JSX transformation before use, and the output will have a .js file extension.
-     */
-    REACT = "react",
-    /**
-     * Keeps all JSX like 'preserve' mode, but output will have a .js extension.
-     */
-    REACT_NATIVE = "react-native",
-    /**
-     * Passes `key` separately from props and always passes `children` as props (since React 17).
-     *
-     * @see https://www.typescriptlang.org/docs/handbook/release-notes/typescript-4-1.html#react-17-jsx-factories
-     */
-    REACT_JSX = "react-jsx",
-    /**
-     * Same as `REACT_JSX` with additional debug data.
-     */
-    REACT_JSXDEV = "react-jsxdev"
-}
-export interface TypeScriptCompilerOptions {
-    /**
-     * Allow JavaScript files to be compiled.
-     *
-     * @default false
-     */
-    readonly allowJs?: boolean;
-    /**
-     * Ensures that your files are parsed in the ECMAScript strict mode, and emit “use strict”
-     * for each source file.
-     *
-     * @default true
-     */
-    readonly alwaysStrict?: boolean;
-    /**
-     * Offers a way to configure the root directory for where declaration files are emitted.
-     *
-     */
-    readonly declarationDir?: string;
-    /**
-     * To be specified along with the above
-     *
-     */
-    readonly declaration?: boolean;
-    /**
-     * Emit __importStar and __importDefault helpers for runtime babel
-     * ecosystem compatibility and enable --allowSyntheticDefaultImports for
-     * typesystem compatibility.
-     *
-     * @default false
-     */
-    readonly esModuleInterop?: boolean;
-    /**
-     * Enables experimental support for decorators, which is in stage 2 of the TC39 standardization process.
-     *
-     * @default true
-     */
-    readonly experimentalDecorators?: boolean;
-    /**
-     * Enables experimental support for decorators, which is in stage 2 of the TC39 standardization process.
-     * Decorators are a language feature which hasn’t yet been fully ratified into the JavaScript specification.
-     * This means that the implementation version in TypeScript may differ from the implementation in JavaScript when it it decided by TC39.
-     * You can find out more about decorator support in TypeScript in the handbook.
-     *
-     * @see https://www.typescriptlang.org/docs/handbook/decorators.html
-     * @default undefined
-     */
-    readonly emitDecoratorMetadata?: boolean;
-    /**
-     * Disallow inconsistently-cased references to the same file.
-     *
-     * @default false
-     */
-    readonly forceConsistentCasingInFileNames?: boolean;
-    /**
-     * This flag works because you can use `import type` to explicitly create an `import` statement which should never be emitted into JavaScript.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#importsNotUsedAsValues
-     * @default "remove"
-     */
-    readonly importsNotUsedAsValues?: TypeScriptImportsNotUsedAsValues;
-    /**
-     * When set, instead of writing out a .js.map file to provide source maps,
-     * TypeScript will embed the source map content in the .js files.
-     *
-     * @default true
-     */
-    readonly inlineSourceMap?: boolean;
-    /**
-     * When set, TypeScript will include the original content of the .ts file as an embedded
-     * string in the source map. This is often useful in the same cases as inlineSourceMap.
-     *
-     * @default true
-     */
-    readonly inlineSources?: boolean;
-    /**
-     * Enables the generation of sourcemap files.
-     *
-     * @default undefined
-     */
-    readonly sourceMap?: boolean;
-    /**
-     * Specify the location where a debugger should locate TypeScript files
-     * instead of relative source locations.
-     *
-     * @default undefined
-     */
-    readonly sourceRoot?: string;
-    /**
-     * Perform additional checks to ensure that separate compilation (such as
-     * with transpileModule or @babel/plugin-transform-typescript) would be safe.
-     *
-     * @default false
-     */
-    readonly isolatedModules?: boolean;
-    /**
-     * Support JSX in .tsx files: "react", "preserve", "react-native" etc.
-     *
-     * @default undefined
-     */
-    readonly jsx?: TypeScriptJsxMode;
-    /**
-     * Declares the module specifier to be used for importing the jsx and jsxs factory functions when using jsx.
-     *
-     * @default undefined
-     */
-    readonly jsxImportSource?: string;
-    /**
-     * Reference for type definitions / libraries to use (eg. ES2016, ES5, ES2018).
-     *
-     * @default [ "es2018" ]
-     */
-    readonly lib?: string[];
-    /**
-     * Sets the module system for the program.
-     * See https://www.typescriptlang.org/docs/handbook/modules.html#ambient-modules.
-     *
-     * @default "CommonJS"
-     */
-    readonly module?: string;
-    /**
-     * Determine how modules get resolved. Either "Node" for Node.js/io.js style resolution, or "Classic".
-     *
-     * @default "node"
-     */
-    readonly moduleResolution?: TypeScriptModuleResolution;
-    /**
-     * Do not emit outputs.
-     *
-     * @default false
-     */
-    readonly noEmit?: boolean;
-    /**
-     * Only emit .d.ts files; do not emit .js files.
-     *
-     * @default false
-     */
-    readonly emitDeclarationOnly?: true;
-    /**
-     * Do not emit compiler output files like JavaScript source code, source-maps or
-     * declarations if any errors were reported.
-     *
-     * @default true
-     */
-    readonly noEmitOnError?: boolean;
-    /**
-     * Report errors for fallthrough cases in switch statements. Ensures that any non-empty
-     * case inside a switch statement includes either break or return. This means you won’t
-     * accidentally ship a case fallthrough bug.
-     *
-     * @default true
-     */
-    readonly noFallthroughCasesInSwitch?: boolean;
-    /**
-     * In some cases where no type annotations are present, TypeScript will fall back to a
-     * type of any for a variable when it cannot infer the type.
-     *
-     * @default true
-     */
-    readonly noImplicitAny?: boolean;
-    /**
-     * Using `noImplicitOverride`, you can ensure that sub-classes never go out of sync as
-     * they are required to explicitly declare that they are overriding a member using the
-     * `override` keyword. This also improves readability of the programmer's intent.
-     *
-     * Available with TypeScript 4.3 and newer.
-     *
-     * @default false
-     */
-    readonly noImplicitOverride?: boolean;
-    /**
-     * When enabled, TypeScript will check all code paths in a function to ensure they
-     * return a value.
-     *
-     * @default true
-     */
-    readonly noImplicitReturns?: boolean;
-    /**
-     * Raise error on ‘this’ expressions with an implied ‘any’ type.
-     *
-     * @default true
-     */
-    readonly noImplicitThis?: boolean;
-    /**
-     * Raise error on use of the dot syntax to access fields which are not defined.
-     *
-     * @default true
-     */
-    readonly noPropertyAccessFromIndexSignature?: boolean;
-    /**
-     * Raise error when accessing indexes on objects with unknown keys defined in index signatures.
-     *
-     * @default true
-     */
-    readonly noUncheckedIndexedAccess?: boolean;
-    /**
-     * Report errors on unused local variables.
-     *
-     * @default true
-     */
-    readonly noUnusedLocals?: boolean;
-    /**
-     * Report errors on unused parameters in functions.
-     *
-     * @default true
-     */
-    readonly noUnusedParameters?: boolean;
-    /**
-     * Allows importing modules with a ‘.json’ extension, which is a common practice
-     * in node projects. This includes generating a type for the import based on the static JSON shape.
-     *
-     * @default true
-     */
-    readonly resolveJsonModule?: boolean;
-    /**
-     * Skip type checking of all declaration files (*.d.ts).
-     *
-     * @default false
-     */
-    readonly skipLibCheck?: boolean;
-    /**
-     * The strict flag enables a wide range of type checking behavior that results in stronger guarantees
-     * of program correctness. Turning this on is equivalent to enabling all of the strict mode family
-     * options, which are outlined below. You can then turn off individual strict mode family checks as
-     * needed.
-     *
-     * @default true
-     */
-    readonly strict?: boolean;
-    /**
-     * When strictNullChecks is false, null and undefined are effectively ignored by the language.
-     * This can lead to unexpected errors at runtime.
-     * When strictNullChecks is true, null and undefined have their own distinct types and you’ll
-     * get a type error if you try to use them where a concrete value is expected.
-     *
-     * @default true
-     */
-    readonly strictNullChecks?: boolean;
-    /**
-     * When set to true, TypeScript will raise an error when a class property was declared but
-     * not set in the constructor.
-     *
-     * @default true
-     */
-    readonly strictPropertyInitialization?: boolean;
-    /**
-     * Do not emit declarations for code that has an @internal annotation in it’s JSDoc comment.
-     *
-     * @default true
-     */
-    readonly stripInternal?: boolean;
-    /**
-     * Modern browsers support all ES6 features, so ES6 is a good choice. You might choose to set
-     * a lower target if your code is deployed to older environments, or a higher target if your
-     * code is guaranteed to run in newer environments.
-     *
-     * @default "ES2018"
-     */
-    readonly target?: string;
-    /**
-     * Output directory for the compiled files.
-     */
-    readonly outDir?: string;
-    /**
-     * Specifies the root directory of input files.
-     *
-     * Only use to control the output directory structure with `outDir`.
-     */
-    readonly rootDir?: string;
-    /**
-     * Allow default imports from modules with no default export. This does not affect code emit, just typechecking.
-     */
-    readonly allowSyntheticDefaultImports?: boolean;
-    /**
-     * Lets you set a base directory to resolve non-absolute module names.
-     *
-     * You can define a root folder where you can do absolute file resolution.
-     */
-    readonly baseUrl?: string;
-    /**
-     * A series of entries which re-map imports to lookup locations relative to the baseUrl, there is a larger coverage of paths in the handbook.
-     *
-     * paths lets you declare how TypeScript should resolve an import in your require/imports.
-     */
-    readonly paths?: {
-        [key: string]: string[];
-    };
-}
-export declare class TypescriptConfig extends Component {
-    readonly compilerOptions: TypeScriptCompilerOptions;
-    readonly include: string[];
-    readonly exclude: string[];
-    readonly fileName: string;
-    readonly file: JsonFile;
-    constructor(project: Project, options: TypescriptConfigOptions);
-    addInclude(pattern: string): void;
-    addExclude(pattern: string): void;
-}

package/lib/.types-compat/ts3.9/lib/javascript/upgrade-dependencies.d.ts

@@ -1,188 +0,0 @@
-import { Component } from "../component";
-import { GithubCredentials, GithubWorkflow, GitIdentity, workflows } from "../github";
-import { ContainerOptions, JobStep, JobPermissions } from "../github/workflows-model";
-import { NodeProject } from "../javascript";
-import { Task } from "../task";
-/**
- * Options for `UpgradeDependencies`.
- */
-export interface UpgradeDependenciesOptions {
-    /**
-     * List of package names to exclude during the upgrade.
-     *
-     * @default - Nothing is excluded.
-     */
-    readonly exclude?: string[];
-    /**
-     * List of package names to include during the upgrade.
-     *
-     * @default - Everything is included.
-     */
-    readonly include?: string[];
-    /**
-     * Include a github workflow for creating PR's that upgrades the
-     * required dependencies, either by manual dispatch, or by a schedule.
-     *
-     * If this is `false`, only a local projen task is created, which can be executed manually to
-     * upgrade the dependencies.
-     *
-     * @default - true for root projects, false for sub-projects.
-     */
-    readonly workflow?: boolean;
-    /**
-     * Options for the github workflow. Only applies if `workflow` is true.
-     *
-     * @default - default options.
-     */
-    readonly workflowOptions?: UpgradeDependenciesWorkflowOptions;
-    /**
-     * The name of the task that will be created.
-     * This will also be the workflow name.
-     *
-     * @default "upgrade".
-     */
-    readonly taskName?: string;
-    /**
-     * Title of the pull request to use (should be all lower-case).
-     *
-     * @default "upgrade dependencies"
-     */
-    readonly pullRequestTitle?: string;
-    /**
-     * Add Signed-off-by line by the committer at the end of the commit log message.
-     *
-     * @default true
-     */
-    readonly signoff?: boolean;
-}
-/**
- * Upgrade node project dependencies.
- */
-export declare class UpgradeDependencies extends Component {
-    /**
-     * The workflows that execute the upgrades. One workflow per branch.
-     */
-    readonly workflows: GithubWorkflow[];
-    private readonly options;
-    private readonly _project;
-    private readonly pullRequestTitle;
-    /**
-     * Container definitions for the upgrade workflow.
-     */
-    containerOptions?: ContainerOptions;
-    /**
-     * The upgrade task.
-     */
-    readonly upgradeTask: Task;
-    /**
-     * A task run after the upgrade task.
-     */
-    readonly postUpgradeTask: Task;
-    private readonly gitIdentity;
-    private readonly postBuildSteps;
-    private readonly permissions;
-    constructor(project: NodeProject, options?: UpgradeDependenciesOptions);
-    /**
-     * Add steps to execute a successful build.
-     * @param steps workflow steps
-     */
-    addPostBuildSteps(...steps: JobStep[]): void;
-    private renderTaskSteps;
-    private createWorkflow;
-    private createUpgrade;
-    private createPr;
-}
-/**
- * Options for `UpgradeDependencies.workflowOptions`.
- */
-export interface UpgradeDependenciesWorkflowOptions {
-    /**
-     * Schedule to run on.
-     *
-     * @default UpgradeDependenciesSchedule.DAILY
-     */
-    readonly schedule?: UpgradeDependenciesSchedule;
-    /**
-     * Choose a method for authenticating with GitHub for creating the PR.
-     *
-     * When using the default github token, PR's created by this workflow
-     * will not trigger any subsequent workflows (i.e the build workflow), so
-     * projen requires API access to be provided through e.g. a personal
-     * access token or other method.
-     *
-     * @see https://github.com/peter-evans/create-pull-request/issues/48
-     * @default - personal access token named PROJEN_GITHUB_TOKEN
-     */
-    readonly projenCredentials?: GithubCredentials;
-    /**
-     * Labels to apply on the PR.
-     *
-     * @default - no labels.
-     */
-    readonly labels?: string[];
-    /**
-     * Assignees to add on the PR.
-     *
-     * @default - no assignees
-     */
-    readonly assignees?: string[];
-    /**
-     * Job container options.
-     *
-     * @default - defaults
-     */
-    readonly container?: workflows.ContainerOptions;
-    /**
-     * List of branches to create PR's for.
-     *
-     * @default - All release branches configured for the project.
-     */
-    readonly branches?: string[];
-    /**
-     * The git identity to use for commits.
-     * @default "github-actions@github.com"
-     */
-    readonly gitIdentity?: GitIdentity;
-    /**
-     * Github Runner selection labels
-     * @default ["ubuntu-latest"]
-     */
-    readonly runsOn?: string[];
-    /**
-     * Permissions granted to the upgrade job
-     * To limit job permissions for `contents`, the desired permissions have to be explicitly set, e.g.: `{ contents: JobPermission.NONE }`
-     * @default `{ contents: JobPermission.READ }`
-     */
-    readonly permissions?: JobPermissions;
-}
-/**
- * How often to check for new versions and raise pull requests for version upgrades.
- */
-export declare class UpgradeDependenciesSchedule {
-    readonly cron: string[];
-    /**
-     * Disables automatic upgrades.
-     */
-    static readonly NEVER: UpgradeDependenciesSchedule;
-    /**
-     * At 00:00.
-     */
-    static readonly DAILY: UpgradeDependenciesSchedule;
-    /**
-     * At 00:00 on every day-of-week from Monday through Friday.
-     */
-    static readonly WEEKDAY: UpgradeDependenciesSchedule;
-    /**
-     * At 00:00 on Monday.
-     */
-    static readonly WEEKLY: UpgradeDependenciesSchedule;
-    /**
-     * At 00:00 on day-of-month 1.
-     */
-    static readonly MONTHLY: UpgradeDependenciesSchedule;
-    /**
-     * Create a schedule from a raw cron expression.
-     */
-    static expressions(cron: string[]): UpgradeDependenciesSchedule;
-    private constructor();
-}

package/lib/.types-compat/ts3.9/lib/javascript/util.d.ts

@@ -1,19 +0,0 @@
-export declare function renderBundleName(entrypoint: string): string;
-/**
- * Regex for AWS CodeArtifact registry
- */
-export declare const codeArtifactRegex: RegExp;
-/**
- * gets AWS details from the Code Artifact registry URL
- * throws exception if not matching expected pattern
- * @param registryUrl Code Artifact registry URL
- * @returns object containing the (domain, accountId, region, repository)
- */
-export declare function extractCodeArtifactDetails(registryUrl: string): {
-    domain: string;
-    accountId: string;
-    region: string;
-    repository: string;
-    registry: string;
-};
-export declare function minVersion(version: string): string | undefined;

package/lib/.types-compat/ts3.9/lib/json-patch.d.ts

@@ -1,75 +0,0 @@
-/**
- * Utility for applying RFC-6902 JSON-Patch to a document.
- *
- * Use the the `JsonPatch.apply(doc, ...ops)` function to apply a set of
- * operations to a JSON document and return the result.
- *
- * Operations can be created using the factory methods `JsonPatch.add()`,
- * `JsonPatch.remove()`, etc.
- *
- * @example
- *
- *const output = JsonPatch.apply(input,
- *  JsonPatch.replace('/world/hi/there', 'goodbye'),
- *  JsonPatch.add('/world/foo/', 'boom'),
- *  JsonPatch.remove('/hello'));
- *
- */
-export declare class JsonPatch {
-    private readonly operation;
-    /**
-     * Applies a set of JSON-Patch (RFC-6902) operations to `document` and returns the result.
-     * @param document The document to patch
-     * @param ops The operations to apply
-     * @returns The result document
-     */
-    static apply(document: any, ...ops: JsonPatch[]): any;
-    /**
-     * Adds a value to an object or inserts it into an array. In the case of an
-     * array, the value is inserted before the given index. The - character can be
-     * used instead of an index to insert at the end of an array.
-     *
-     * @example JsonPatch.add('/biscuits/1', { "name": "Ginger Nut" })
-     */
-    static add(path: string, value: any): JsonPatch;
-    /**
-     * Removes a value from an object or array.
-     *
-     * @example JsonPatch.remove('/biscuits')
-     * @example JsonPatch.remove('/biscuits/0')
-     */
-    static remove(path: string): JsonPatch;
-    /**
-     * Replaces a value. Equivalent to a “remove” followed by an “add”.
-     *
-     * @example JsonPatch.replace('/biscuits/0/name', 'Chocolate Digestive')
-     */
-    static replace(path: string, value: any): JsonPatch;
-    /**
-     * Copies a value from one location to another within the JSON document. Both
-     * from and path are JSON Pointers.
-     *
-     * @example JsonPatch.copy('/biscuits/0', '/best_biscuit')
-     */
-    static copy(from: string, path: string): JsonPatch;
-    /**
-     * Moves a value from one location to the other. Both from and path are JSON Pointers.
-     *
-     * @example JsonPatch.move('/biscuits', '/cookies')
-     */
-    static move(from: string, path: string): JsonPatch;
-    /**
-     * Tests that the specified value is set in the document. If the test fails,
-     * then the patch as a whole should not apply.
-     *
-     * @example JsonPatch.test('/best_biscuit/name', 'Choco Leibniz')
-     */
-    static test(path: string, value: any): JsonPatch;
-    private constructor();
-    /**
-     * Returns the JSON representation of this JSON patch operation.
-     *
-     * @internal
-     */
-    _toJson(): any;
-}