fix: replace backslashes with forward slashes in refs on Windows when splitting (#1903)

* fix: replace backslashes with forward slashes in refs on Windows when splitting

* update tests

* Update .changeset/eighty-dolls-sniff.md

* Update __tests__/smoke/run-smoke.sh

* remove redundant non-null assertion

* improve the build-docs smoke test check

---------

Co-authored-by: Jacek Łękawa <164185257+JLekawa@users.noreply.github.com>

Author: tatomyr

.changeset/eighty-dolls-sniff.md

@@ -0,0 +1,5 @@
+---
+"@redocly/cli": patch
+---
+
+Fixed a problem where the `split` command produced backslashes instead of forward slashes in `$ref`s on Windows.

.github/workflows/smoke-plugins.yaml

@@ -20,7 +20,7 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - name: Prepare Smoke
-        run: bash ./scripts/prepare-smoke-plugins.sh
+        run: bash ./__tests__/smoke-plugins/prepare-smoke-plugins.sh
       - uses: actions/cache@v3
         with:
           path: __tests__/smoke-plugins/

.github/workflows/smoke.yaml

@@ -20,7 +20,7 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - name: Prepare Smoke
-        run: bash ./scripts/prepare-smoke.sh
+        run: bash ./__tests__/smoke/prepare-smoke.sh
       - uses: actions/cache@v3
         with:
           path: __tests__/smoke/
@@ -291,15 +291,23 @@ jobs:
         run: docker build -t redocly/cli:latest .
       - name: Run docker image
         run: |
+          # Prepare
+          cp resources/pets.yaml resources/museum.yaml __tests__/smoke/
           cd __tests__/smoke/
+
+          # Run commands
           docker run --rm redocly/cli:latest --version
           docker run --rm -v $PWD:/spec redocly/cli:latest lint openapi.yaml
           docker run --rm -v $PWD:/spec redocly/cli:latest bundle openapi.yaml --ext json
           docker run --rm -v $PWD:/spec redocly/cli:latest build-docs openapi.yaml
-          # Check for broken styles (related issue: https://github.com/Redocly/redocly-cli/issues/1073) 
-          if [[ "$(wc -l redoc-static.html)" == "324 redoc-static.html" ]]; then
-            echo "Docs built correctly."
-          else
-            echo "Docs built incorrectly. Received lines: $(wc -l redoc-static.html) (expected 324 lines in redoc-static.html)."
-            exit 1
-          fi
+          docker run --rm -v $PWD:/spec redocly/cli:latest split pets.yaml --outDir output/split/petstore && docker run --rm -v $PWD:/spec redocly/cli:latest split museum.yaml --outDir output/split/museum
+
+          # Check for broken styles when building docs (related issue: https://github.com/Redocly/redocly-cli/issues/1073)
+          echo "Checking docs for issues..."
+          diff pre-built/redoc.html redoc-static.html 
+          echo "✅ Docs built correctly."
+
+          # Check for broken $refs (or other issues) in the split files, especially on Windows (it will fail on a difference)
+          echo "Checking split files for issues..."
+          diff -r pre-split output/split
+          echo "✅ Files split correctly."

scripts/prepare-smoke-plugins.sh …_/smoke-plugins/prepare-smoke-plugins.shscripts/prepare-smoke-plugins.sh renamed to __tests__/smoke-plugins/prepare-smoke-plugins.sh scripts/prepare-smoke-plugins.sh renamed to __tests__/smoke-plugins/prepare-smoke-plugins.sh

@@ -8,7 +8,8 @@
     "redocly-version": "redocly --version",
     "redocly-lint": "redocly lint openapi.yaml",
     "redocly-bundle": "redocly bundle openapi.yaml --ext json",
-    "redocly-build-docs": "redocly build-docs openapi.yaml"
+    "redocly-build-docs": "redocly build-docs openapi.yaml",
+    "redocly-split": "redocly split pets.yaml --outDir output/split/petstore && redocly split museum.yaml --outDir output/split/museum"
   },
   "author": "redocly",
   "license": "ISC"

__tests__/smoke/package.json

@@ -0,0 +1,6 @@
+summary: Special event ticket
+value:
+  ticketType: general
+  eventId: dad4bce8-f5cb-4078-a211-995864315e39
+  ticketDate: '2023-09-05'
+  email: todd@example.com

__tests__/smoke/pre-built/redoc.html

@@ -0,0 +1,8 @@
+summary: Special event ticket
+value:
+  message: Museum special event ticket purchased
+  ticketId: b811f723-17b2-44f7-8952-24b03e43d8a9
+  eventName: Mermaid Treasure Identification and Analysis
+  ticketType: event
+  ticketDate: '2023-09-05'
+  confirmationCode: ticket-event-9c55eg-8v82a

__tests__/smoke/pre-split/museum/components/examples/BuyEventTicketsRequestExample.yaml

@@ -0,0 +1,5 @@
+summary: General entry ticket
+value:
+  ticketType: general
+  ticketDate: '2023-09-07'
+  email: todd@example.com

__tests__/smoke/pre-split/museum/components/examples/BuyEventTicketsResponseExample.yaml

@@ -0,0 +1,7 @@
+summary: General entry ticket
+value:
+  message: Museum general entry ticket purchased
+  ticketId: 382c0820-0530-4f4b-99af-13811ad0f17a
+  ticketType: general
+  ticketDate: '2023-09-07'
+  confirmationCode: ticket-general-e5e5c6-dce78