php-transformer.yml

name: PHP Transformer

on:
  workflow_dispatch:
  pull_request:
    types: [opened, reopened, synchronize, ready_for_review]
    paths:
      - ".github/workflows/php-transformer.yml"
      - "php-transformer/**"
      - "scripts/production-acceptance-matrix.php"
      - "tests/contract/production-acceptance-matrix.php"
      - "fixtures/websites/**"
  push:
    branches:
      - trunk
    paths:
      - ".github/workflows/php-transformer.yml"
      - "php-transformer/**"
      - "scripts/production-acceptance-matrix.php"
      - "tests/contract/production-acceptance-matrix.php"
      - "fixtures/websites/**"

jobs:
  validate:
    name: Composer validate and test (PHP ${{ matrix.php-version }})
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        php-version: ["8.3", "8.4", "8.5"]

    defaults:
      run:
        working-directory: php-transformer

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240  # 2.37.2
        with:
          php-version: ${{ matrix.php-version }}
          coverage: none
          tools: composer:v2

      - name: Install dependencies
        run: composer install --no-interaction --prefer-dist --no-progress

      - name: Validate Composer package metadata
        run: composer validate --strict

      - name: Verify library lint correctness and rejection contract
        run: composer lint && composer test:lint

      - name: Run package tests
        run: composer test

      - name: Run repository acceptance matrix contract
        working-directory: .
        run: php tests/contract/production-acceptance-matrix.php

  topology:
    name: Source topology baseline (shard ${{ matrix.shard }}/4)
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        shard: [1, 2, 3, 4]

    defaults:
      run:
        working-directory: php-transformer

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240  # 2.37.2
        with:
          php-version: "8.4"
          coverage: none
          tools: composer:v2

      - name: Install dependencies
        run: composer install --no-interaction --prefer-dist --no-progress

      - name: Compare source and rendered element trees with the baseline
        env:
          COMPOSER_PROCESS_TIMEOUT: 0
        run: composer topology-diff -- --shard ${{ matrix.shard }}/4 --baseline tools/topology-diff/baseline.json --output "$RUNNER_TEMP/topology-shard-${{ matrix.shard }}.json" --top 0

      - name: Upload topology report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: topology-shard-${{ matrix.shard }}
          path: ${{ runner.temp }}/topology-shard-${{ matrix.shard }}.json
          if-no-files-found: ignore

  visual-parity:
    name: Generic visual parity tools
    runs-on: ubuntu-latest

    defaults:
      run:
        working-directory: php-transformer/tools/visual-parity

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: "20"

      - name: Install PHP dependencies
        working-directory: php-transformer
        run: composer install --no-interaction --prefer-dist

      - name: Install dependencies
        run: npm ci

      - name: Verify owned JavaScript correctness
        run: npm run lint

      - name: Install Chromium
        run: npx playwright install --with-deps chromium

      - name: Run visual parity tests
        run: npm test

      - name: Verify layout-table source tracks and authored responsive overrides
        env:
          WORDPRESS_ROOT: ${{ runner.temp }}/wordpress
        run: |
          curl --fail --silent --show-error https://wordpress.org/wordpress-7.0.4.tar.gz | tar -xz -C "$RUNNER_TEMP"
          node tests/layout-media-tracks.mjs
          BE_FIXTURE_VARIANT=responsive node tests/layout-media-tracks.mjs

      - name: Verify native disclosure control presentation
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/details-control-presentation-browser.mjs

      - name: Verify standalone line breaks keep source line spacing
        working-directory: php-transformer
        run: php tests/unit/standalone-break-spacing.php

      - name: Verify block-anchor control bars stay stacked and sized
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/icon-anchor-bar-browser.mjs

      - name: Verify form label required markers and flex gaps
        working-directory: php-transformer
        run: php tests/unit/form-label-marker-gap.php

      - name: Verify decorative search icons and banded input padding
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/search-decorative-icon-browser.mjs

      - name: Verify background paint button signals
        working-directory: php-transformer
        run: php tests/unit/background-paint-button-signal.php

      - name: Verify flattened form marker conditional gaps
        working-directory: php-transformer
        run: php tests/unit/form-marker-conditional-gap.php

      - name: Verify standalone break run geometry
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/standalone-break-runs-browser.mjs

      - name: Verify unreferenced SVG definition carrier footprints
        working-directory: php-transformer
        run: php tests/unit/unreferenced-definitions-svg-footprint.php

      - name: Verify native collection search semantics
        working-directory: php-transformer
        run: |
          php tests/unit/collection-filter-block.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/collection-filter-browser.mjs
          php tests/unit/runtime-dialog-trigger-button.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/runtime-dialog-trigger-button-browser.mjs
          php tests/unit/captured-dialog-dropdown-panel.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/captured-dialog-dropdown-panel-browser.mjs

      - name: Verify native dialog parity with the recognized capture disclosure runtime
        working-directory: php-transformer
        run: |
          php tests/unit/capture-runtime-ancestor-parity.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/capture-runtime-ancestor-parity-browser.mjs
          php tests/unit/capture-runtime-attribute-parity.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/capture-runtime-attribute-parity-browser.mjs
          php tests/unit/captured-dialog-class-hidden-resting-panel.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/captured-dialog-resting-content-browser.mjs

      - name: Verify the editor canvas paints the front end resting state
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/editor-resting-state-browser.mjs

      - name: Verify native button default background neutralization
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/native-button-default-background-browser.mjs

      - name: Verify stretched buttons keep the source box model
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" composer test:stretched-button-box-sizing-browser

      - name: Verify native grid buttons fill their track
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/native-grid-button-stretch-browser.mjs

      - name: Verify sibling link lists preserve stacking and link styles
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" composer test:sibling-link-lists-browser

      - name: Verify orphan list-item marker and pixel preservation
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/orphan-list-item-browser.mjs

      - name: Verify lowered background images keep their position when linked
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$GITHUB_WORKSPACE/php-transformer/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/background-image-position-browser.mjs

      - name: Verify slideshow slides with inline images stack in one stage
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/carousel-inline-image-slides-browser.mjs
      - name: Verify a lowered background image is not restyled as an author figure or img
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/contract/background-image-selector-ownership-browser.mjs
      - name: Verify a height-limited image keeps its ratio after WordPress adds size attributes
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/image-height-clamp-intrinsic-width-browser.mjs
      - name: Verify a linked image that fills its box keeps the source size
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/linked-fill-image-anchor-browser.mjs

      - name: Verify a stylesheet-painted cover keeps the source padding
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/cover-default-padding-browser.mjs

      - name: Verify a linked grid-item image adds no line box
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/linked-grid-item-image-strut-browser.mjs

      - name: Verify hidden control labels stay inside a scrolling rail
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/hidden-label-scroll-overflow-browser.mjs
      - name: Verify a flattened fixed-size button keeps its authored box
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/neutral-button-fixed-height-browser.mjs

      - name: Verify a centred submit carrier keeps its source position
        working-directory: php-transformer
        run: |
          php tests/unit/form-submit-centred-carrier.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/form-submit-centred-carrier-browser.mjs

      - name: Verify a propagated card link keeps its author layout
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/link-wrapper-card-layout-browser.mjs

      - name: Verify a partially padded button keeps zero on its other sides
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/button-partial-padding-browser.mjs

      - name: Verify a social glyph keeps its own paint over Core's color reset
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/social-links-glyph-paint-browser.mjs

      - name: Verify a blockified rich-text layout item keeps its own line box
        working-directory: php-transformer
        env:
          BLOCK_LIBRARY_CSS: ${{ runner.temp }}/wordpress/wp-includes/css/dist/block-library/style.min.css
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/blockified-richtext-item-browser.mjs

      - name: Verify native disclosure paint and label wrapping
        working-directory: php-transformer
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/unit/accordion-presentation-browser.mjs

  wordpress-site-plan:
    name: WordPress site plan integration (PHP ${{ matrix.php-version }})
    runs-on: ubuntu-24.04
    strategy:
      fail-fast: false
      matrix:
        php-version: ["8.3", "8.4", "8.5"]
    services:
      mysql:
        image: mysql:8.0.36
        env:
          MYSQL_DATABASE: wordpress_test
          MYSQL_ALLOW_EMPTY_PASSWORD: "yes"
        ports:
          - 3306:3306
        options: >-
          --health-cmd="mysqladmin ping --silent"
          --health-interval=10s
          --health-timeout=5s
          --health-retries=10
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240  # 2.37.2
        with:
          php-version: ${{ matrix.php-version }}
          extensions: mysqli
          tools: composer:v2
      - name: Install package dependencies
        working-directory: php-transformer
        run: composer install --no-interaction --prefer-dist
      - name: Provision pinned WordPress PHPUnit runtime
        env:
          WORDPRESS_DEVELOP_DIR: ${{ runner.temp }}/wordpress-develop
          WORDPRESS_TEST_DB: wordpress_site_plan_test
        run: |
          git clone --depth=1 --branch 7.0.4 https://github.com/WordPress/wordpress-develop.git "$WORDPRESS_DEVELOP_DIR"
          composer config --working-dir="$WORDPRESS_DEVELOP_DIR" --json policy.advisories.ignore-id '{"PKSA-mh9b-91zm-m1gy":{"on-audit":false,"reason":"Pinned WordPress 7.0.4 test runtime; WPCS is not loaded by the integration test."},"PKSA-kh6k-gs3g-dgr6":{"on-audit":false,"reason":"Pinned WordPress 7.0.4 test runtime; PHPCSUtils is not loaded by the integration test."},"PKSA-rdkp-vv9z-mjkg":{"on-audit":false,"reason":"Pinned WordPress 7.0.4 test runtime; affected build tooling is not loaded by the integration test."},"PKSA-6vdd-n4sx-knhy":{"on-audit":false,"reason":"Pinned WordPress 7.0.4 test runtime; affected build tooling is not loaded by the integration test."}}'
          composer install --working-dir="$WORDPRESS_DEVELOP_DIR" --no-interaction --prefer-dist --no-progress
          for attempt in $(seq 1 30); do
            if mysql --host=127.0.0.1 --port=3306 --user=root --execute='SELECT 1'; then break; fi
            if [ "$attempt" = 30 ]; then exit 1; fi
            sleep 2
          done
          mysql --host=127.0.0.1 --port=3306 --user=root --execute="DROP DATABASE IF EXISTS $WORDPRESS_TEST_DB; CREATE DATABASE $WORDPRESS_TEST_DB;"
          cp "$WORDPRESS_DEVELOP_DIR/wp-tests-config-sample.php" "$WORDPRESS_DEVELOP_DIR/wp-tests-config.php"
          WORDPRESS_DEVELOP_DIR="$WORDPRESS_DEVELOP_DIR" WORDPRESS_TEST_DB="$WORDPRESS_TEST_DB" php -r '$config = file_get_contents(getenv("WORDPRESS_DEVELOP_DIR") . "/wp-tests-config.php"); $config = preg_replace("/define\(\s*\x27DB_NAME\x27\s*,\s*[^)]*\);/", "define( \x27DB_NAME\x27, \x27" . getenv("WORDPRESS_TEST_DB") . "\x27 );", $config); $config = preg_replace("/define\(\s*\x27DB_USER\x27\s*,\s*[^)]*\);/", "define( \x27DB_USER\x27, \x27root\x27 );", $config); $config = preg_replace("/define\(\s*\x27DB_PASSWORD\x27\s*,\s*[^)]*\);/", "define( \x27DB_PASSWORD\x27, \x27\x27 );", $config); $config = preg_replace("/define\(\s*\x27DB_HOST\x27\s*,\s*[^)]*\);/", "define( \x27DB_HOST\x27, \x27127.0.0.1:3306\x27 );", $config); file_put_contents(getenv("WORDPRESS_DEVELOP_DIR") . "/wp-tests-config.php", $config);'
      - name: Run required WordPress site plan integration
        working-directory: php-transformer
        env:
          REQUIRE_WP_TESTS: "1"
          WP_TESTS_DIR: ${{ runner.temp }}/wordpress-develop/tests/phpunit
        run: composer test:wordpress-integration
      - name: Setup Node for native document context proof
        if: matrix.php-version == '8.3'
        uses: actions/setup-node@v4
        with:
          node-version: "20"
      - name: Verify native document ancestor context in Chromium
        if: matrix.php-version == '8.3'
        working-directory: php-transformer
        env:
          BODY_CONTEXT_WORDPRESS_BOOTSTRAP: ${{ runner.temp }}/wordpress-develop/tests/phpunit/includes/bootstrap.php
          BODY_CONTEXT_ARTIFACT: ${{ runner.temp }}/document-body-context.json
          BODY_CONTEXT_EVIDENCE: ${{ runner.temp }}/document-body-context-browser.json
        run: |
          npm ci --prefix tools/visual-parity
          tools/visual-parity/node_modules/.bin/playwright install --with-deps chromium
          php tests/contract/document-body-context.php
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/contract/document-body-context-browser.mjs
      - name: Verify disposable HTTP frontend and Gutenberg save/reload
        if: matrix.php-version == '8.3'
        working-directory: php-transformer
        env:
          BODY_CONTEXT_DISPOSABLE: "1"
          BODY_CONTEXT_PLAN: ${{ runner.temp }}/document-context-http/plan.json
          BODY_CONTEXT_ROUTES: ${{ runner.temp }}/document-context-http/routes.json
          BODY_CONTEXT_EVIDENCE: ${{ runner.temp }}/document-context-http/browser.json
          BODY_CONTEXT_WP_URL: http://127.0.0.1:19006
          BODY_CONTEXT_USER: fixture
          BODY_CONTEXT_PASSWORD: fixture-password
        run: |
          mkdir -p "$RUNNER_TEMP/document-context-http/site"
          curl --fail --silent --show-error https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar -o "$RUNNER_TEMP/document-context-http/wp-cli.phar"
          WP_CLI="$RUNNER_TEMP/document-context-http/wp-cli.phar"
          SITE="$RUNNER_TEMP/document-context-http/site"
          php "$WP_CLI" --path="$SITE" core download --version=7.0.4
          php "$WP_CLI" --path="$SITE" config create --dbname=wordpress_root_context_test --dbuser=root --dbpass='' --dbhost=127.0.0.1:3306
          php "$WP_CLI" --path="$SITE" config set WP_HOME "$BODY_CONTEXT_WP_URL"
          php "$WP_CLI" --path="$SITE" config set WP_SITEURL "$BODY_CONTEXT_WP_URL"
          php "$WP_CLI" --path="$SITE" db create
          php "$WP_CLI" --path="$SITE" core install --url="$BODY_CONTEXT_WP_URL" --title=Root-context-proof --admin_user="$BODY_CONTEXT_USER" --admin_password="$BODY_CONTEXT_PASSWORD" --admin_email=fixture@example.test --skip-email
          BODY_CONTEXT_WORDPRESS_BOOTSTRAP='' php tests/contract/document-body-context.php
          php "$WP_CLI" --path="$SITE" eval "require '$PWD/tests/integration/document-body-context-install.php';"
          php -S 127.0.0.1:19006 -t "$SITE" > "$RUNNER_TEMP/document-context-http/server.log" 2>&1 &
          PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" node tests/integration/document-body-context-browser.mjs
      - name: Verify authored carousel PHP and native save control contract
        if: matrix.php-version == '8.3'
        working-directory: php-transformer
        env:
          BE_EDITOR_WP_URL: http://127.0.0.1:19006
          BE_EDITOR_USER: fixture
          BE_EDITOR_PASSWORD: fixture-password
          BE_EDITOR_EVIDENCE_DIR: ${{ runner.temp }}/document-context-http
        run: |
          SITE="$RUNNER_TEMP/document-context-http/site"
          WP_CLI="$RUNNER_TEMP/document-context-http/wp-cli.phar"
          export BE_TRANSFORMER_ROOT="$PWD"
          php "$WP_CLI" --path="$SITE" eval-file "$PWD/tests/build-carousel-control-acceptance.php" > "$BE_EDITOR_EVIDENCE_DIR/carousel-control-page.json"
          export BE_EDITOR_POST_ID="$(php -r '$x=json_decode(file_get_contents($argv[1]),true); echo $x["post_id"];' "$BE_EDITOR_EVIDENCE_DIR/carousel-control-page.json")"
          node tests/carousel-control-acceptance.mjs
      - name: Retain document context runtime evidence
        if: always() && matrix.php-version == '8.3'
        uses: actions/upload-artifact@v4
        with:
          name: document-context-runtime
          path: |
            ${{ runner.temp }}/document-body-context*.json
            ${{ runner.temp }}/document-context-http/*.json
            ${{ runner.temp }}/document-context-http/server.log

  stylesheet-activation:
    name: WordPress stylesheet activation browser regression
    runs-on: ubuntu-24.04
    defaults:
      run:
        working-directory: php-transformer
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@f3e473d116dcccaddc5834248c87452386958240
        with:
          php-version: "8.3"
          tools: composer:v2
      - uses: actions/setup-node@v4
        with:
          node-version: "20"
      - run: composer install --no-interaction --prefer-dist --no-progress
      - run: npm ci --prefix tools/visual-parity
      - run: npx --prefix tools/visual-parity playwright install --with-deps chromium
      - name: Verify real generated WordPress paint, selection, editor assets and save/reload
        run: PLAYWRIGHT_MODULE="$PWD/tools/visual-parity/node_modules/playwright/index.mjs" bash tests/integration/stylesheet-activation-docker.sh