Add support for artifacts.reports.annotations property with string | string[] type.

Author: noxify

.changeset/annotations-support.md

@@ -0,0 +1,5 @@
+---
+"@noxify/gitlab-ci-builder": patch
+---
+
+Add support for `artifacts.reports.annotations` property with `string | string[]` type. Import now intelligently normalizes single-element arrays to strings for cleaner generated code.

.changeset/fancy-socks-watch.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-string support for `extends`
+Add support for `extends` as both `string` and `string[]`. Single extends are optimized to string format in generated code for better readability.

.changeset/floppy-ants-tell.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-exclude anchor definitions without a valid job definition
+Improve YAML anchor handling by filtering out anchor definitions that don't contain valid job objects. This prevents type errors when importing GitLab CI files with pure anchor arrays.

.changeset/gentle-olives-retire.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-support `string` and `string[]` in `artifacts.reports.dotenv`
+Add support for `artifacts.reports.dotenv` property with `string | string[]` type. Import now intelligently normalizes single-element arrays to strings for cleaner generated code.

.changeset/lovely-showers-film.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-support also `string[]` in `rules.exists`
+Add support for `rules.exists` property with `string | string[]` type to match GitLab CI specification.

.changeset/plenty-tigers-cheat.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-fixed issue in the generated ts code for the importer
+Fix import code generation to properly handle single-element arrays for properties like `extends`, optimizing output format for better code readability.

.changeset/tough-rings-laugh.md

@@ -2,4 +2,4 @@
 "@noxify/gitlab-ci-builder": patch
 ---
 
-add missing `optional` prop for `needs:`
+Add missing `optional` property to `needs` definitions (both job and pipeline needs) to match GitLab CI specification.

src/import.ts

@@ -178,8 +178,10 @@ function formatValue(value: unknown, indentLevel: number): string {
     const props = entries.map(([k, v]) => {
       const key = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(k) ? k : JSON.stringify(k)
 
-      // Special handling for extends: if it's an array with single element, format as string
-      if (k === "extends" && Array.isArray(v) && v.length === 1) {
+      // Special handling for properties that should be strings but might be single-element arrays
+      // These properties accept string | string[] but single values are more common
+      const singleValueProperties = ["extends", "annotations", "dotenv"]
+      if (singleValueProperties.includes(k) && Array.isArray(v) && v.length === 1) {
         return `${indent}${key}: ${formatValue(v[0], indentLevel + 1)}`
       }
 

src/types/artifacts.ts

@@ -38,6 +38,10 @@ interface ArtifactsDefinition {
      * @see https://docs.gitlab.com/ee/ci/pipelines/job_artifacts.html#artifactsreportsdotenv
      */
     dotenv?: string | string[]
+    /**
+     * @see https://docs.gitlab.com/ee/ci/yaml/artifacts_reports.html#artifactsreportsannotations
+     */
+    annotations?: string | string[]
     /**
      * @see https://docs.gitlab.com/ee/ci/pipelines/job_artifacts.html#artifactsreportscobertura
      */

tests/import.test.ts

@@ -426,5 +426,44 @@ deploy:
       expect(ts).toContain("optional: true")
       expect(ts).toContain('job: "unit_tests"')
     })
+
+    it("should handle artifacts.reports.annotations as single string", () => {
+      const yaml = `
+test:
+  script:
+    - npm test
+  artifacts:
+    reports:
+      annotations:
+        - branding.json
+`
+
+      const ts = fromYaml(yaml)
+
+      expect(ts).toContain('config.job("test",')
+      expect(ts).toContain("artifacts:")
+      expect(ts).toContain("reports:")
+      expect(ts).toContain('annotations: "branding.json"')
+    })
+
+    it("should handle artifacts.reports.annotations as array", () => {
+      const yaml = `
+test:
+  script:
+    - npm test
+  artifacts:
+    reports:
+      annotations:
+        - file1.json
+        - file2.json
+`
+
+      const ts = fromYaml(yaml)
+
+      expect(ts).toContain('config.job("test",')
+      expect(ts).toContain("artifacts:")
+      expect(ts).toContain("reports:")
+      expect(ts).toContain('annotations: ["file1.json", "file2.json"]')
+    })
   })
 })