projen 0.52.21 → 0.52.25

package/lib/gitlab/configuration-model.d.ts

@@ -1,1212 +1,461 @@
 /**
- * (experimental) Cache Definition.
- *
+ * Cache Definition.
  * @see https://docs.gitlab.com/ee/ci/yaml/#cache
- * @experimental
  */
 export interface Cache {
-    /**
-     * (experimental) Defines when to save the cache, based on the status of the job (Default: Job Success).
-     *
-     * @experimental
-     */
+    /** Defines when to save the cache, based on the status of the job (Default: Job Success). */
     readonly when?: CacheWhen;
 }
 /**
- * (experimental) Configure when artifacts are uploaded depended on job status.
- *
+ * Configure when artifacts are uploaded depended on job status.
  * @see https://docs.gitlab.com/ee/ci/yaml/#cachewhen
- * @experimental
  */
 export declare enum CacheWhen {
-    /**
-     * (experimental) Upload artifacts regardless of job status.
-     *
-     * @experimental
-     */
+    /** Upload artifacts regardless of job status. */
     ALWAYS = "always",
-    /**
-     * (experimental) Upload artifacts only when the job fails.
-     *
-     * @experimental
-     */
+    /** Upload artifacts only when the job fails. */
     ON_FAILURE = "on_failure",
-    /**
-     * (experimental) Upload artifacts only when the job succeeds (this is the default).
-     *
-     * @experimental
-     */
+    /** Upload artifacts only when the job succeeds (this is the default). */
     ON_SUCCESS = "on_success"
 }
 /**
- * (experimental) Default settings for the CI Configuration.
- *
- * Jobs that do not define one or more of the listed keywords use the value defined in the default section.
- *
+ * Default settings for the CI Configuration. Jobs that do not define one or more of the listed keywords use the value defined in the default section.
  * @see https://docs.gitlab.com/ee/ci/yaml/#default
- * @experimental
  */
 export interface Default {
-    /**
-     * @experimental
-     */
     readonly afterScript?: string[];
-    /**
-     * @experimental
-     */
     readonly artifacts?: Artifacts;
-    /**
-     * @experimental
-     */
     readonly beforeScript?: string[];
-    /**
-     * @experimental
-     */
     readonly cache?: Cache;
-    /**
-     * @experimental
-     */
     readonly image?: Image;
-    /**
-     * @experimental
-     */
     readonly interruptible?: boolean;
-    /**
-     * @experimental
-     */
     readonly retry?: Retry;
-    /**
-     * @experimental
-     */
     readonly services?: Service[];
-    /**
-     * @experimental
-     */
     readonly tags?: string[];
-    /**
-     * @experimental
-     */
     readonly timeout?: string;
 }
 /**
- * (experimental) Used to specify a list of files and directories that should be attached to the job if it succeeds.
- *
- * Artifacts are sent to Gitlab where they can be downloaded.
- *
+ * Used to specify a list of files and directories that should be attached to the job if it
+ * succeeds. Artifacts are sent to Gitlab where they can be downloaded.
  * @see https://docs.gitlab.com/ee/ci/yaml/#artifacts
- * @experimental
  */
 export interface Artifacts {
-    /**
-     * (experimental) A list of paths to files/folders that should be excluded in the artifact.
-     *
-     * @experimental
-     */
+    /** A list of paths to files/folders that should be excluded in the artifact. */
     readonly exclude?: string[];
-    /**
-     * (experimental) How long artifacts should be kept.
-     *
-     * They are saved 30 days by default. Artifacts that have expired are removed periodically via cron job. Supports a wide variety of formats, e.g. '1 week', '3 mins 4 sec', '2 hrs 20 min', '2h20min', '6 mos 1 day', '47 yrs 6 mos and 4d', '3 weeks and 2 days'.
-     *
-     * @experimental
-     */
+    /** How long artifacts should be kept. They are saved 30 days by default. Artifacts that have expired are removed periodically via cron job. Supports a wide variety of formats, e.g. '1 week', '3 mins 4 sec', '2 hrs 20 min', '2h20min', '6 mos 1 day', '47 yrs 6 mos and 4d', '3 weeks and 2 days'. */
     readonly expireIn?: string;
-    /**
-     * (experimental) Can be used to expose job artifacts in the merge request UI.
-     *
-     * GitLab will add a link <expose_as> to the relevant merge request that points to the artifact.
-     *
-     * @experimental
-     */
+    /** Can be used to expose job artifacts in the merge request UI. GitLab will add a link <expose_as> to the relevant merge request that points to the artifact. */
     readonly exposeAs?: string;
-    /**
-     * (experimental) Name for the archive created on job success.
-     *
-     * Can use variables in the name, e.g. '$CI_JOB_NAME'
-     *
-     * @experimental
-     */
+    /** Name for the archive created on job success. Can use variables in the name, e.g. '$CI_JOB_NAME' */
     readonly name?: string;
-    /**
-     * (experimental) A list of paths to files/folders that should be included in the artifact.
-     *
-     * @experimental
-     */
+    /** A list of paths to files/folders that should be included in the artifact. */
     readonly paths?: string[];
-    /**
-     * (experimental) Reports will be uploaded as artifacts, and often displayed in the Gitlab UI, such as in Merge Requests.
-     *
-     * @experimental
-     */
+    /** Reports will be uploaded as artifacts, and often displayed in the Gitlab UI, such as in Merge Requests.*/
     readonly reports?: Reports;
-    /**
-     * (experimental) Whether to add all untracked files (along with 'artifacts.paths') to the artifact.
-     *
-     * @experimental
-     */
+    /** Whether to add all untracked files (along with 'artifacts.paths') to the artifact.*/
     readonly untracked?: boolean;
-    /**
-     * (experimental) Configure when artifacts are uploaded depended on job status.
-     *
-     * @experimental
-     */
+    /** Configure when artifacts are uploaded depended on job status.*/
     readonly when?: CacheWhen;
 }
 /**
- * (experimental) Reports will be uploaded as artifacts, and often displayed in the Gitlab UI, such as in Merge Requests.
- *
+ * Reports will be uploaded as artifacts, and often displayed in the Gitlab UI, such as in
+ * Merge Requests.
  * @see https://docs.gitlab.com/ee/ci/yaml/#artifactsreports
- * @experimental
  */
 export interface Reports {
-    /**
-     * (experimental) Path for file(s) that should be parsed as Cobertura XML coverage report.
-     *
-     * @experimental
-     */
+    /** Path for file(s) that should be parsed as Cobertura XML coverage report*/
     readonly cobertura?: string[];
-    /**
-     * (experimental) Path to file or list of files with code quality report(s) (such as Code Climate).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with code quality report(s) (such as Code Climate).*/
     readonly codequality?: string[];
-    /**
-     * (experimental) Path to file or list of files with Container scanning vulnerabilities report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with Container scanning vulnerabilities report(s).*/
     readonly containerScanning?: string[];
-    /**
-     * (experimental) Path to file or list of files with DAST vulnerabilities report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with DAST vulnerabilities report(s).*/
     readonly dast?: string[];
-    /**
-     * (experimental) Path to file or list of files with Dependency scanning vulnerabilities report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with Dependency scanning vulnerabilities report(s).*/
     readonly dependencyScanning?: string[];
-    /**
-     * (experimental) Path to file or list of files containing runtime-created variables for this job.
-     *
-     * @experimental
-     */
+    /** Path to file or list of files containing runtime-created variables for this job.*/
     readonly dotenv?: string[];
-    /**
-     * (experimental) Path for file(s) that should be parsed as JUnit XML result.
-     *
-     * @experimental
-     */
+    /** Path for file(s) that should be parsed as JUnit XML result*/
     readonly junit?: string[];
-    /**
-     * (experimental) Deprecated in 12.8: Path to file or list of files with license report(s).
-     *
-     * @experimental
-     */
+    /** Deprecated in 12.8: Path to file or list of files with license report(s).*/
     readonly licenseManagement?: string[];
-    /**
-     * (experimental) Path to file or list of files with license report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with license report(s).*/
     readonly licenseScanning?: string[];
-    /**
-     * (experimental) Path to file or list of files containing code intelligence (Language Server Index Format).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files containing code intelligence (Language Server Index Format).*/
     readonly lsif?: string[];
-    /**
-     * (experimental) Path to file or list of files with custom metrics report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with custom metrics report(s).*/
     readonly metrics?: string[];
-    /**
-     * (experimental) Path to file or list of files with performance metrics report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with performance metrics report(s).*/
     readonly performance?: string[];
-    /**
-     * (experimental) Path to file or list of files with requirements report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with requirements report(s).*/
     readonly requirements?: string[];
-    /**
-     * (experimental) Path to file or list of files with SAST vulnerabilities report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with SAST vulnerabilities report(s).*/
     readonly sast?: string[];
-    /**
-     * (experimental) Path to file or list of files with secret detection report(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with secret detection report(s).*/
     readonly secretDetection?: string[];
-    /**
-     * (experimental) Path to file or list of files with terraform plan(s).
-     *
-     * @experimental
-     */
+    /** Path to file or list of files with terraform plan(s).*/
     readonly terraform?: string[];
 }
 /**
- * (experimental) Specifies the docker image to use for the job or globally for all jobs.
- *
- * Job configuration
+ * Specifies the docker image to use for the job or globally for all jobs. Job configuration
  * takes precedence over global setting. Requires a certain kind of Gitlab runner executor.
- *
  * @see https://docs.gitlab.com/ee/ci/yaml/#image
- * @experimental
  */
 export interface Image {
-    /**
-     * (experimental) Command or script that should be executed as the container's entrypoint.
-     *
-     * It will be translated to Docker's --entrypoint option while creating the container. The syntax is similar to Dockerfile's ENTRYPOINT directive, where each shell token is a separate string in the array.
-     *
-     * @experimental
-     */
+    /** Command or script that should be executed as the container's entrypoint. It will be translated to Docker's --entrypoint option while creating the container. The syntax is similar to Dockerfile's ENTRYPOINT directive, where each shell token is a separate string in the array.*/
     readonly entrypoint?: any[];
-    /**
-     * (experimental) Full name of the image that should be used.
-     *
-     * It should contain the Registry part if needed.
-     *
-     * @experimental
-     */
+    /** Full name of the image that should be used. It should contain the Registry part if needed.*/
     readonly name: string;
 }
 /**
- * (experimental) How many times a job is retried if it fails.
- *
- * If not defined, defaults to 0 and jobs do not retry.
- *
+ * How many times a job is retried if it fails. If not defined, defaults to 0 and jobs do not retry.
  * @see https://docs.gitlab.com/ee/ci/yaml/#retry
- * @experimental
  */
 export interface Retry {
-    /**
-     * (experimental) 0 (default), 1, or 2.
-     *
-     * @experimental
-     */
+    /** 0 (default), 1, or 2.*/
     readonly max?: number;
-    /**
-     * (experimental) Either a single or array of error types to trigger job retry.
-     *
-     * @experimental
-     */
+    /** Either a single or array of error types to trigger job retry.*/
     readonly when?: any;
 }
 /**
- * (experimental) Used to specify an additional Docker image to run scripts in.
- *
- * The service image is linked to the image specified in the @Default image keyword.
- *
+ * Used to specify an additional Docker image to run scripts in. The service image is linked to the image specified in the @Default image keyword.
  * @see https://docs.gitlab.com/ee/ci/yaml/#services
- * @experimental
  */
 export interface Service {
-    /**
-     * (experimental) Additional alias that can be used to access the service from the job's container.
-     *
-     * Read Accessing the services for more information.
-     *
-     * @experimental
-     */
+    /** Additional alias that can be used to access the service from the job's container. Read Accessing the services for more information.*/
     readonly alias?: string;
-    /**
-     * (experimental) Command or script that should be used as the container's command.
-     *
-     * It will be translated to arguments passed to Docker after the image's name. The syntax is similar to Dockerfile's CMD directive, where each shell token is a separate string in the array.
-     *
-     * @experimental
-     */
+    /** Command or script that should be used as the container's command. It will be translated to arguments passed to Docker after the image's name. The syntax is similar to Dockerfile's CMD directive, where each shell token is a separate string in the array.*/
     readonly command?: string[];
-    /**
-     * (experimental) Command or script that should be executed as the container's entrypoint.
-     *
-     * It will be translated to Docker's --entrypoint option while creating the container. The syntax is similar to Dockerfile's ENTRYPOINT directive, where each shell token is a separate string in the array.
-     *
-     * @experimental
-     */
+    /** Command or script that should be executed as the container's entrypoint. It will be translated to Docker's --entrypoint option while creating the container. The syntax is similar to Dockerfile's ENTRYPOINT directive, where each shell token is a separate string in the array.*/
     readonly entrypoint?: string[];
-    /**
-     * (experimental) Full name of the image that should be used.
-     *
-     * It should contain the Registry part if needed.
-     *
-     * @experimental
-     */
+    /** Full name of the image that should be used. It should contain the Registry part if needed.*/
     readonly name: string;
 }
 /**
- * (experimental) An included YAML file.
- *
+ * An included YAML file.
  * @see https://docs.gitlab.com/ee/ci/yaml/#include
- * @experimental
  */
 export interface Include {
-    /**
-     * (experimental) Relative path from local repository root (`/`) to the `yaml`/`yml` file template.
-     *
-     * The file must be on the same branch, and does not work across git submodules.
-     *
-     * @experimental
-     */
+    /** Relative path from local repository root (`/`) to the `yaml`/`yml` file template. The file must be on the same branch, and does not work across git submodules.*/
     readonly local?: string;
-    /**
-     * (experimental) Rules allows for an array of individual rule objects to be evaluated in order, until one matches and dynamically provides attributes to the job.
-     *
-     * @experimental
-     */
+    /**Rules allows for an array of individual rule objects to be evaluated in order, until one matches and dynamically provides attributes to the job. */
     readonly rules?: IncludeRule[];
-    /**
-     * (experimental) Files from another private project on the same GitLab instance.
-     *
-     * You can use `file` in combination with `project` only.
-     *
-     * @experimental
-     */
+    /** Files from another private project on the same GitLab instance. You can use `file` in combination with `project` only. */
     readonly file?: string[];
-    /**
-     * (experimental) Path to the project, e.g. `group/project`, or `group/sub-group/project`.
-     *
-     * @experimental
-     */
+    /** Path to the project, e.g. `group/project`, or `group/sub-group/project`.*/
     readonly project?: string;
-    /**
-     * (experimental) Branch/Tag/Commit-hash for the target project.
-     *
-     * @experimental
-     */
+    /** Branch/Tag/Commit-hash for the target project.*/
     readonly ref?: string;
-    /**
-     * (experimental) Use a `.gitlab-ci.yml` template as a base, e.g. `Nodejs.gitlab-ci.yml`.
-     *
-     * @experimental
-     */
+    /** Use a `.gitlab-ci.yml` template as a base, e.g. `Nodejs.gitlab-ci.yml`.*/
     readonly template?: string;
-    /**
-     * (experimental) URL to a `yaml`/`yml` template file using HTTP/HTTPS.
-     *
-     * @experimental
-     */
+    /** URL to a `yaml`/`yml` template file using HTTP/HTTPS.*/
     readonly remote?: string;
 }
 /**
- * (experimental) Rules allows for an array of individual rule objects to be evaluated in order, until one matches and dynamically provides attributes to the job.
- *
+ * Rules allows for an array of individual rule objects to be evaluated in order, until one
+ * matches and dynamically provides attributes to the job.
  * @see https://docs.gitlab.com/ee/ci/yaml/includes.html#use-rules-with-include
- * @experimental
  */
 export interface IncludeRule {
-    /**
-     * @experimental
-     */
     readonly allowFailure?: boolean | AllowFailure;
-    /**
-     * @experimental
-     */
     readonly changes?: string[];
-    /**
-     * @experimental
-     */
     readonly exists?: string[];
-    /**
-     * @experimental
-     */
     readonly if?: string;
-    /**
-     * @experimental
-     */
     readonly startIn?: string;
-    /**
-     * @experimental
-     */
     readonly variables?: Record<string, number | string>;
-    /**
-     * @experimental
-     */
     readonly when?: JobWhen;
 }
 /**
- * (experimental) Exit code that are not considered failure.
- *
- * The job fails for any other exit code.
+ * Exit code that are not considered failure. The job fails for any other exit code.
  * You can list which exit codes are not considered failures. The job fails for any other
  * exit code.
- *
  * @see https://docs.gitlab.com/ee/ci/yaml/#allow_failure
- * @experimental
  */
 export interface AllowFailure {
-    /**
-     * @experimental
-     */
     readonly exitCodes: number[] | number;
 }
 /**
- * (experimental) Describes the conditions for when to run the job.
- *
- * Defaults to 'on_success'.
- *
+ * Describes the conditions for when to run the job. Defaults to 'on_success'.
  * @see https://docs.gitlab.com/ee/ci/yaml/#when
- * @experimental
  */
 export declare enum JobWhen {
-    /**
-     * @experimental
-     */
     ALWAYS = "always",
-    /**
-     * @experimental
-     */
     DELAYED = "delayed",
-    /**
-     * @experimental
-     */
     MANUAL = "manual",
-    /**
-     * @experimental
-     */
     NEVER = "never",
-    /**
-     * @experimental
-     */
     ON_FAILURE = "on_failure",
-    /**
-     * @experimental
-     */
     ON_SUCCESS = "on_success"
 }
 /**
- * (experimental) Jobs are the most fundamental element of a .gitlab-ci.yml file.
- *
+ * Jobs are the most fundamental element of a .gitlab-ci.yml file.
  * @see https://docs.gitlab.com/ee/ci/jobs/
- * @experimental
  */
 export interface Job {
-    /**
-     * @experimental
-     */
     readonly afterScript?: string[];
-    /**
-     * (experimental) Whether to allow the pipeline to continue running on job failure (Default: false).
-     *
-     * @experimental
-     */
+    /** Whether to allow the pipeline to continue running on job failure (Default: false). */
     readonly allowFailure?: boolean | AllowFailure;
-    /**
-     * @experimental
-     */
     readonly artifacts?: Artifacts;
-    /**
-     * @experimental
-     */
     readonly beforeScript?: string[];
-    /**
-     * @experimental
-     */
     readonly cache?: Cache;
-    /**
-     * (experimental) Must be a regular expression, optionally but recommended to be quoted, and must be surrounded with '/'.
-     *
-     * Example: '/Code coverage: \d+\.\d+/'
-     *
-     * @experimental
-     */
+    /** Must be a regular expression, optionally but recommended to be quoted, and must be surrounded with '/'. Example: '/Code coverage: \d+\.\d+/'*/
     readonly coverage?: string;
-    /**
-     * (experimental) Specify a list of job names from earlier stages from which artifacts should be loaded.
-     *
-     * By default, all previous artifacts are passed. Use an empty array to skip downloading artifacts.
-     *
-     * @experimental
-     */
+    /** Specify a list of job names from earlier stages from which artifacts should be loaded. By default, all previous artifacts are passed. Use an empty array to skip downloading artifacts.*/
     readonly dependencies?: string[];
-    /**
-     * (experimental) Used to associate environment metadata with a deploy.
-     *
-     * Environment can have a name and URL attached to it, and will be displayed under /environments under the project.
-     *
-     * @experimental
-     */
+    /** Used to associate environment metadata with a deploy. Environment can have a name and URL attached to it, and will be displayed under /environments under the project.*/
     readonly environment?: Environment | string;
-    /**
-     * (experimental) Job will run *except* for when these filtering options match.
-     *
-     * @experimental
-     */
+    /** Job will run *except* for when these filtering options match.*/
     readonly except?: string[] | Filter;
-    /**
-     * (experimental) The name of one or more jobs to inherit configuration from.
-     *
-     * @experimental
-     */
+    /** The name of one or more jobs to inherit configuration from.*/
     readonly extends?: string[];
-    /**
-     * @experimental
-     */
     readonly image?: Image;
-    /**
-     * (experimental) Controls inheritance of globally-defined defaults and variables.
-     *
-     * Boolean values control inheritance of all default: or variables: keywords. To inherit only a subset of default: or variables: keywords, specify what you wish to inherit. Anything not listed is not inherited.
-     *
-     * @experimental
-     */
+    /** Controls inheritance of globally-defined defaults and variables. Boolean values control inheritance of all default: or variables: keywords. To inherit only a subset of default: or variables: keywords, specify what you wish to inherit. Anything not listed is not inherited.*/
     readonly inherit?: Inherit;
-    /**
-     * @experimental
-     */
     readonly interruptible?: boolean;
-    /**
-     * (experimental) The list of jobs in previous stages whose sole completion is needed to start the current job.
-     *
-     * @experimental
-     */
+    /** The list of jobs in previous stages whose sole completion is needed to start the current job.*/
     readonly needs?: Array<Need | string>;
-    /**
-     * (experimental) Job will run *only* when these filtering options match.
-     *
-     * @experimental
-     */
+    /** Job will run *only* when these filtering options match.*/
     readonly only?: string[] | Filter;
-    /**
-     * (experimental) Parallel will split up a single job into several, and provide `CI_NODE_INDEX` and `CI_NODE_TOTAL` environment variables for the running jobs.
-     *
-     * @experimental
-     */
+    /** Parallel will split up a single job into several, and provide `CI_NODE_INDEX` and `CI_NODE_TOTAL` environment variables for the running jobs.*/
     readonly parallel?: Parallel | number;
-    /**
-     * (experimental) Indicates that the job creates a Release.
-     *
-     * @experimental
-     */
+    /** Indicates that the job creates a Release.*/
     readonly release?: Release;
-    /**
-     * (experimental) Limit job concurrency.
-     *
-     * Can be used to ensure that the Runner will not run certain jobs simultaneously.
-     *
-     * @experimental
-     */
+    /** Limit job concurrency. Can be used to ensure that the Runner will not run certain jobs simultaneously.*/
     readonly resourceGroup?: string;
-    /**
-     * @experimental
-     */
     readonly retry?: Retry;
-    /**
-     * (experimental) Rules allows for an array of individual rule objects to be evaluated in order, until one matches and dynamically provides attributes to the job.
-     *
-     * @experimental
-     */
+    /**Rules allows for an array of individual rule objects to be evaluated in order, until one matches and dynamically provides attributes to the job. */
     readonly rules?: IncludeRule[];
-    /**
-     * (experimental) Shell scripts executed by the Runner.
-     *
-     * The only required property of jobs. Be careful with special characters (e.g. `:`, `{`, `}`, `&`) and use single or double quotes to avoid issues.
-     *
-     * @experimental
-     */
+    /** Shell scripts executed by the Runner. The only required property of jobs. Be careful with special characters (e.g. `:`, `{`, `}`, `&`) and use single or double quotes to avoid issues.*/
     readonly script?: string[];
-    /**
-     * (experimental) CI/CD secrets.
-     *
-     * @experimental
-     */
+    /** CI/CD secrets */
     readonly secrets?: Record<string, Record<string, Secret>>;
-    /**
-     * @experimental
-     */
     readonly services?: Service[];
-    /**
-     * (experimental) Define what stage the job will run in.
-     *
-     * @experimental
-     */
+    /** Define what stage the job will run in.*/
     readonly stage?: string;
-    /**
-     * @experimental
-     */
     readonly startIn?: string;
-    /**
-     * @experimental
-     */
     readonly tags?: string[];
-    /**
-     * @experimental
-     */
     readonly timeout?: string;
-    /**
-     * (experimental) Trigger allows you to define downstream pipeline trigger.
-     *
-     * When a job created from trigger definition is started by GitLab, a downstream pipeline gets created. Read more: https://docs.gitlab.com/ee/ci/yaml/README.html#trigger
-     *
-     * @experimental
-     */
+    /** Trigger allows you to define downstream pipeline trigger. When a job created from trigger definition is started by GitLab, a downstream pipeline gets created. Read more: https://docs.gitlab.com/ee/ci/yaml/README.html#trigger*/
     readonly trigger?: Trigger | string;
-    /**
-     * (experimental) Configurable values that are passed to the Job.
-     *
-     * @experimental
-     */
+    /** Configurable values that are passed to the Job. */
     readonly variables?: Record<string, number | string>;
-    /**
-     * (experimental) Describes the conditions for when to run the job.
-     *
-     * Defaults to 'on_success'.
-     *
-     * @experimental
-     */
+    /** Describes the conditions for when to run the job. Defaults to 'on_success'. */
     readonly when?: JobWhen;
 }
 /**
- * (experimental) The environment that a job deploys to.
- *
- * @experimental
+ * The environment that a job deploys to.
  */
 export interface Environment {
-    /**
-     * (experimental) Specifies what this job will do.
-     *
-     * 'start' (default) indicates the job will start the deployment. 'prepare' indicates this will not affect the deployment. 'stop' indicates this will stop the deployment.
-     *
-     * @experimental
-     */
+    /** Specifies what this job will do. 'start' (default) indicates the job will start the deployment. 'prepare' indicates this will not affect the deployment. 'stop' indicates this will stop the deployment.*/
     readonly action?: Action;
-    /**
-     * (experimental) The amount of time it should take before Gitlab will automatically stop the environment.
-     *
-     * Supports a wide variety of formats, e.g. '1 week', '3 mins 4 sec', '2 hrs 20 min', '2h20min', '6 mos 1 day', '47 yrs 6 mos and 4d', '3 weeks and 2 days'.
-     *
-     * @experimental
-     */
+    /** The amount of time it should take before Gitlab will automatically stop the environment. Supports a wide variety of formats, e.g. '1 week', '3 mins 4 sec', '2 hrs 20 min', '2h20min', '6 mos 1 day', '47 yrs 6 mos and 4d', '3 weeks and 2 days'.*/
     readonly autoStopIn?: string;
-    /**
-     * (experimental) Explicitly specifies the tier of the deployment environment if non-standard environment name is used.
-     *
-     * @experimental
-     */
+    /** Explicitly specifies the tier of the deployment environment if non-standard environment name is used.*/
     readonly deploymentTier?: DeploymentTier;
-    /**
-     * (experimental) Used to configure the kubernetes deployment for this environment.
-     *
-     * This is currently not supported for kubernetes clusters that are managed by Gitlab.
-     *
-     * @experimental
-     */
+    /** Used to configure the kubernetes deployment for this environment. This is currently not supported for kubernetes clusters that are managed by Gitlab.*/
     readonly kubernetes?: KubernetesConfig;
-    /**
-     * (experimental) The name of the environment, e.g. 'qa', 'staging', 'production'.
-     *
-     * @experimental
-     */
+    /** The name of the environment, e.g. 'qa', 'staging', 'production'.*/
     readonly name: string;
-    /**
-     * (experimental) The name of a job to execute when the environment is about to be stopped.
-     *
-     * @experimental
-     */
+    /** The name of a job to execute when the environment is about to be stopped.*/
     readonly onStop?: string;
-    /**
-     * (experimental) When set, this will expose buttons in various places for the current environment in Gitlab, that will take you to the defined URL.
-     *
-     * @experimental
-     */
+    /** When set, this will expose buttons in various places for the current environment in Gitlab, that will take you to the defined URL.*/
     readonly url?: string;
 }
 /**
- * (experimental) Specifies what this job will do.
- *
- * 'start' (default) indicates the job will start the
+ * Specifies what this job will do. 'start' (default) indicates the job will start the
  * deployment. 'prepare' indicates this will not affect the deployment. 'stop' indicates
  * this will stop the deployment.
- *
- * @experimental
  */
 export declare enum Action {
-    /**
-     * @experimental
-     */
     PREPARE = "prepare",
-    /**
-     * @experimental
-     */
     START = "start",
-    /**
-     * @experimental
-     */
     STOP = "stop"
 }
 /**
- * (experimental) Explicitly specifies the tier of the deployment environment if non-standard environment name is used.
- *
- * @experimental
+ * Explicitly specifies the tier of the deployment environment if non-standard environment
+ * name is used.
  */
 export declare enum DeploymentTier {
-    /**
-     * @experimental
-     */
     DEVELOPMENT = "development",
-    /**
-     * @experimental
-     */
     OTHER = "other",
-    /**
-     * @experimental
-     */
     PRODUCTION = "production",
-    /**
-     * @experimental
-     */
     STAGING = "staging",
-    /**
-     * @experimental
-     */
     TESTING = "testing"
 }
 /**
- * (experimental) Used to configure the kubernetes deployment for this environment.
- *
- * This is currently not
+ * Used to configure the kubernetes deployment for this environment. This is currently not
  * supported for kubernetes clusters that are managed by Gitlab.
- *
- * @experimental
  */
 export interface KubernetesConfig {
-    /**
-     * (experimental) The kubernetes namespace where this environment should be deployed to.
-     *
-     * @experimental
-     */
+    /** The kubernetes namespace where this environment should be deployed to.*/
     readonly namespace?: string;
 }
 /**
- * (experimental) Filtering options for when a job will run.
- *
- * @experimental
+ * Filtering options for when a job will run.
  */
 export interface Filter {
-    /**
-     * (experimental) Filter job creation based on files that were modified in a git push.
-     *
-     * @experimental
-     */
+    /** Filter job creation based on files that were modified in a git push.*/
     readonly changes?: string[];
-    /**
-     * (experimental) Filter job based on if Kubernetes integration is active.
-     *
-     * @experimental
-     */
+    /** Filter job based on if Kubernetes integration is active.*/
     readonly kubernetes?: KubernetesEnum;
-    /**
-     * (experimental) Control when to add jobs to a pipeline based on branch names or pipeline types.
-     *
-     * @experimental
-     */
+    /** Control when to add jobs to a pipeline based on branch names or pipeline types. */
     readonly refs?: string[];
-    /**
-     * (experimental) Filter job by checking comparing values of environment variables.
-     *
-     * Read more about variable expressions: https://docs.gitlab.com/ee/ci/variables/README.html#variables-expressions
-     *
-     * @experimental
-     */
+    /** Filter job by checking comparing values of environment variables. Read more about variable expressions: https://docs.gitlab.com/ee/ci/variables/README.html#variables-expressions*/
     readonly variables?: string[];
 }
 /**
  * Filter job based on if Kubernetes integration is active.
  */
 export declare enum KubernetesEnum {
-    /**
-     * (experimental) Filter job based on if Kubernetes integration is active.
-     *
-     * @experimental
-     */
     ACTIVE = "active"
 }
 /**
- * (experimental) Controls inheritance of globally-defined defaults and variables.
- *
- * Boolean values control
+ * Controls inheritance of globally-defined defaults and variables. Boolean values control
  * inheritance of all default: or variables: keywords. To inherit only a subset of default:
  * or variables: keywords, specify what you wish to inherit. Anything not listed is not
  * inherited.
- *
- * @experimental
  */
 export interface Inherit {
-    /**
-     * (experimental) Whether to inherit all globally-defined defaults or not.
-     *
-     * Or subset of inherited defaults
-     *
-     * @experimental
-     */
+    /** Whether to inherit all globally-defined defaults or not. Or subset of inherited defaults*/
     readonly default?: DefaultElement[] | boolean;
-    /**
-     * (experimental) Whether to inherit all globally-defined variables or not.
-     *
-     * Or subset of inherited variables
-     *
-     * @experimental
-     */
+    /** Whether to inherit all globally-defined variables or not. Or subset of inherited variables*/
     readonly variables?: string[] | boolean;
 }
-/**
- * @experimental
- */
 export declare enum DefaultElement {
-    /**
-     * @experimental
-     */
     AFTER_SCRIPT = "after_script",
-    /**
-     * @experimental
-     */
     ARTIFACTS = "artifacts",
-    /**
-     * @experimental
-     */
     BEFORE_SCRIPT = "before_script",
-    /**
-     * @experimental
-     */
     CACHE = "cache",
-    /**
-     * @experimental
-     */
     IMAGE = "image",
-    /**
-     * @experimental
-     */
     INTERRUPTIBLE = "interruptible",
-    /**
-     * @experimental
-     */
     RETRY = "retry",
-    /**
-     * @experimental
-     */
     SERVICES = "services",
-    /**
-     * @experimental
-     */
     TAGS = "tags",
-    /**
-     * @experimental
-     */
     TIMEOUT = "timeout"
 }
 /**
- * (experimental) A jobs in a previous stage whose sole completion is needed to start the current job.
- *
- * @experimental
+ * A jobs in a previous stage whose sole completion is needed to start the current job.
  */
 export interface Need {
-    /**
-     * @experimental
-     */
     readonly artifacts?: boolean;
-    /**
-     * @experimental
-     */
     readonly job: string;
-    /**
-     * @experimental
-     */
     readonly optional?: boolean;
-    /**
-     * @experimental
-     */
     readonly pipeline?: string;
-    /**
-     * @experimental
-     */
     readonly project?: string;
-    /**
-     * @experimental
-     */
     readonly ref?: string;
 }
 /**
- * (experimental) Used to run a job multiple times in parallel in a single pipeline.
- *
- * @experimental
+ * Used to run a job multiple times in parallel in a single pipeline.
  */
 export interface Parallel {
-    /**
-     * (experimental) Defines different variables for jobs that are running in parallel.
-     *
-     * @experimental
-     */
+    /** Defines different variables for jobs that are running in parallel.*/
     readonly matrix: Record<string, any[]>[];
 }
 /**
- * (experimental) Indicates that the job creates a Release.
- *
- * @experimental
+ * Indicates that the job creates a Release.
  */
 export interface Release {
-    /**
-     * @experimental
-     */
     readonly assets?: Assets;
-    /**
-     * (experimental) Specifies the longer description of the Release.
-     *
-     * @experimental
-     */
+    /** Specifies the longer description of the Release.*/
     readonly description: string;
-    /**
-     * (experimental) The title of each milestone the release is associated with.
-     *
-     * @experimental
-     */
+    /** The title of each milestone the release is associated with.*/
     readonly milestones?: string[];
-    /**
-     * (experimental) The Release name.
-     *
-     * If omitted, it is populated with the value of release: tag_name.
-     *
-     * @experimental
-     */
+    /** The Release name. If omitted, it is populated with the value of release: tag_name.*/
     readonly name?: string;
-    /**
-     * (experimental) If the release: tag_name doesn’t exist yet, the release is created from ref.
-     *
-     * ref can be a commit SHA, another tag name, or a branch name.
-     *
-     * @experimental
-     */
+    /** If the release: tag_name doesn’t exist yet, the release is created from ref. ref can be a commit SHA, another tag name, or a branch name.*/
     readonly ref?: string;
-    /**
-     * (experimental) The date and time when the release is ready.
-     *
-     * Defaults to the current date and time if not defined. Should be enclosed in quotes and expressed in ISO 8601 format.
-     *
-     * @experimental
-     */
+    /** The date and time when the release is ready. Defaults to the current date and time if not defined. Should be enclosed in quotes and expressed in ISO 8601 format.*/
     readonly releasedAt?: string;
-    /**
-     * (experimental) The tag_name must be specified.
-     *
-     * It can refer to an existing Git tag or can be specified by the user.
-     *
-     * @experimental
-     */
+    /** The tag_name must be specified. It can refer to an existing Git tag or can be specified by the user.*/
     readonly tagName: string;
 }
 /**
- * (experimental) Asset configuration for a release.
- *
- * @experimental
+ * Asset configuration for a release.
  */
 export interface Assets {
-    /**
-     * (experimental) Include asset links in the release.
-     *
-     * @experimental
-     */
+    /** Include asset links in the release.*/
     readonly links: Link[];
 }
 /**
- * (experimental) Link configuration for an asset.
- *
- * @experimental
+ * Link configuration for an asset.
  */
 export interface Link {
-    /**
-     * (experimental) The redirect link to the url.
-     *
-     * @experimental
-     */
+    /** The redirect link to the url.*/
     readonly filepath?: string;
-    /**
-     * (experimental) The content kind of what users can download via url.
-     *
-     * @experimental
-     */
+    /** The content kind of what users can download via url.*/
     readonly linkType?: LinkType;
-    /**
-     * (experimental) The name of the link.
-     *
-     * @experimental
-     */
+    /** The name of the link.*/
     readonly name: string;
-    /**
-     * (experimental) The URL to download a file.
-     *
-     * @experimental
-     */
+    /** The URL to download a file.*/
     readonly url: string;
 }
 /**
- * (experimental) The content kind of what users can download via url.
- *
- * @experimental
+ * The content kind of what users can download via url.
  */
 export declare enum LinkType {
-    /**
-     * @experimental
-     */
     IMAGE = "image",
-    /**
-     * @experimental
-     */
     OTHER = "other",
-    /**
-     * @experimental
-     */
     PACKAGE = "package",
-    /**
-     * @experimental
-     */
     RUNBOOK = "runbook"
 }
 /**
- * (experimental) A CI/CD secret.
- *
- * @experimental
+ * A CI/CD secret
  */
 export interface Secret {
-    /**
-     * @experimental
-     */
     readonly vault: VaultConfig;
 }
 /**
- * (experimental) Specification for a secret provided by a HashiCorp Vault.
- *
+ * Specification for a secret provided by a HashiCorp Vault.
  * @see https://www.vaultproject.io/
- * @experimental
  */
 export interface VaultConfig {
-    /**
-     * @experimental
-     */
     readonly engine: Engine;
-    /**
-     * @experimental
-     */
     readonly field: string;
-    /**
-     * (experimental) Path to the secret.
-     *
-     * @experimental
-     */
+    /** Path to the secret. */
     readonly path: string;
 }
 /**
- * (experimental) The engine configuration for a secret.
- *
- * @experimental
+ * The engine configuration for a secret.
  */
 export interface Engine {
-    /**
-     * (experimental) Name of the secrets engine.
-     *
-     * @experimental
-     */
+    /** Name of the secrets engine. */
     readonly name: string;
-    /**
-     * (experimental) Path to the secrets engine.
-     *
-     * @experimental
-     */
+    /** Path to the secrets engine. */
     readonly path: string;
 }
 /**
- * (experimental) Trigger a multi-project or a child pipeline.
- *
- * Read more:
- *
+ * Trigger a multi-project or a child pipeline. Read more:
+ * @see https://docs.gitlab.com/ee/ci/yaml/README.html#simple-trigger-syntax-for-multi-project-pipelines
  * @see https://docs.gitlab.com/ee/ci/yaml/README.html#trigger-syntax-for-child-pipeline
- * @experimental
  */
 export interface Trigger {
-    /**
-     * (experimental) The branch name that a downstream pipeline will use.
-     *
-     * @experimental
-     */
+    /** The branch name that a downstream pipeline will use*/
     readonly branch?: string;
-    /**
-     * (experimental) Path to the project, e.g. `group/project`, or `group/sub-group/project`.
-     *
-     * @experimental
-     */
+    /** Path to the project, e.g. `group/project`, or `group/sub-group/project`.*/
     readonly project?: string;
-    /**
-     * (experimental) You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend.
-     *
-     * @experimental
-     */
+    /** You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend*/
     readonly strategy?: Strategy;
-    /**
-     * (experimental) A list of local files or artifacts from other jobs to define the pipeline.
-     *
-     * @experimental
-     */
+    /** A list of local files or artifacts from other jobs to define the pipeline */
     readonly include?: TriggerInclude[];
 }
 /**
- * (experimental) References a local file or an artifact from another job to define the pipeline configuration.
- *
+ * References a local file or an artifact from another job to define the pipeline
+ * configuration.
  * @see https://docs.gitlab.com/ee/ci/yaml/#triggerinclude
- * @experimental
  */
 export interface TriggerInclude {
-    /**
-     * (experimental) Relative path from local repository root (`/`) to the local YAML file to define the pipeline configuration.
-     *
-     * @experimental
-     */
+    /** Relative path from local repository root (`/`) to the local YAML file to define the pipeline configuration.*/
     readonly local?: string;
-    /**
-     * (experimental) Name of the template YAML file to use in the pipeline configuration.
-     *
-     * @experimental
-     */
+    /** Name of the template YAML file to use in the pipeline configuration.*/
     readonly template?: string;
-    /**
-     * (experimental) Relative path to the generated YAML file which is extracted from the artifacts and used as the configuration for triggering the child pipeline.
-     *
-     * @experimental
-     */
+    /** Relative path to the generated YAML file which is extracted from the artifacts and used as the configuration for triggering the child pipeline.*/
     readonly artifact?: string;
-    /**
-     * (experimental) Job name which generates the artifact.
-     *
-     * @experimental
-     */
+    /** Job name which generates the artifact*/
     readonly job?: string;
-    /**
-     * (experimental) Relative path from repository root (`/`) to the pipeline configuration YAML file.
-     *
-     * @experimental
-     */
+    /** Relative path from repository root (`/`) to the pipeline configuration YAML file.*/
     readonly file?: string;
-    /**
-     * (experimental) Path to another private project under the same GitLab instance, like `group/project` or `group/sub-group/project`.
-     *
-     * @experimental
-     */
+    /** Path to another private project under the same GitLab instance, like `group/project` or `group/sub-group/project`.*/
     readonly project?: string;
-    /**
-     * (experimental) Branch/Tag/Commit hash for the target project.
-     *
-     * @experimental
-     */
+    /** Branch/Tag/Commit hash for the target project.*/
     readonly ref?: string;
 }
 /**
@@ -1215,94 +464,43 @@ export interface TriggerInclude {
  * @see https://docs.gitlab.com/ee/ci/yaml/#triggerstrategy
  */
 export declare enum Strategy {
-    /**
-     * (experimental) You can mirror the pipeline status from the triggered pipeline to the source bridge job by using strategy: depend.
-     *
-     * @see https://docs.gitlab.com/ee/ci/yaml/#triggerstrategy
-     * @experimental
-     */
     DEPEND = "depend"
 }
 /**
- * (experimental) Explains what the global variable is used for, what the acceptable values are.
- *
+ * Explains what the global variable is used for, what the acceptable values are.
  * @see https://docs.gitlab.com/ee/ci/yaml/#variables
- * @experimental
  */
 export interface VariableConfig {
-    /**
-     * (experimental) Define a global variable that is prefilled when running a pipeline manually.
-     *
-     * Must be used with value.
-     *
-     * @experimental
-     */
+    /** Define a global variable that is prefilled when running a pipeline manually. Must be used with value.  */
     readonly description?: string;
-    /**
-     * (experimental) The variable value.
-     *
-     * @experimental
-     */
+    /** The variable value. */
     readonly value?: string;
 }
 /**
- * (experimental) Used to control pipeline behavior.
- *
+ * Used to control pipeline behavior.
  * @see https://docs.gitlab.com/ee/ci/yaml/#workflow
- * @experimental
  */
 export interface Workflow {
-    /**
-     * (experimental) Used to control whether or not a whole pipeline is created.
-     *
-     * @experimental
-     */
+    /** Used to control whether or not a whole pipeline is created. */
     readonly rules?: WorkflowRule[];
 }
 /**
- * (experimental) Used to control whether or not a whole pipeline is created.
- *
+ * Used to control whether or not a whole pipeline is created.
  * @see https://docs.gitlab.com/ee/ci/yaml/#workflowrules
- * @experimental
  */
 export interface WorkflowRule {
-    /**
-     * @experimental
-     */
     readonly changes?: string[];
-    /**
-     * @experimental
-     */
     readonly exists?: string[];
-    /**
-     * @experimental
-     */
     readonly if?: string;
-    /**
-     * @experimental
-     */
     readonly variables?: Record<string, number | string>;
-    /**
-     * @experimental
-     */
     readonly when?: JobWhen;
 }
 /**
- * (experimental) Describes the conditions for when to run the job.
- *
- * Defaults to 'on_success'.
+ * Describes the conditions for when to run the job. Defaults to 'on_success'.
  * The value can only be 'always' or 'never' when used with workflow.
- *
  * @see https://docs.gitlab.com/ee/ci/yaml/#workflowrules
- * @experimental
  */
 export declare enum WorkflowWhen {
-    /**
-     * @experimental
-     */
     ALWAYS = "always",
-    /**
-     * @experimental
-     */
     NEVER = "never"
 }