diff --git a/.githooks/pre-push b/.githooks/pre-push deleted file mode 100755 index c5d59aec..00000000 --- a/.githooks/pre-push +++ /dev/null @@ -1,11 +0,0 @@ -#!/bin/sh -set -e - -echo "Checking clean dependency installation..." -npm run check:clean-install - -echo "Running workspace typecheck..." -npm run typecheck --workspaces --if-present - -echo "Running workspace tests..." -npm run test:ci-like diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6b093902..97f53321 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -15,266 +15,19 @@ permissions: contents: read jobs: - lint: + check: runs-on: ubuntu-latest steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - # Type-aware rules resolve a sibling package through its built types, so ui-vue's imports - # from ui-runtime/core are error-typed without this and no-unsafe-* fires on every one. - - name: Build packages - run: npm run build - - - name: Lint sources, styles, markup, and data - run: npm run lint:all - - - name: Check formatting - run: npm run format:check - - typecheck: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Build packages - run: npm run build - - - name: Typecheck workspaces - run: npm run typecheck - - - name: Typecheck documented examples - run: npm run check:docs:examples - - contracts: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 + - uses: actions/checkout@v7 with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Build packages - run: npm run build - - - name: Check repository contracts - run: npm run check:repository-contracts - - - name: Check CodeMonster UI contracts, accessibility, and visual fixtures - run: npm run test:ui - - - name: Run release preparation tests - run: npm run test:release-prep - - - name: Check that every verify step runs in CI - run: npm run check:verify-coverage - - source-tests: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 + fetch-depth: 0 + - uses: actions/setup-node@v6 with: node-version: 24 cache: npm - - - name: Install dependencies - run: npm ci - - # The suite hides dist itself; the build is still needed for its other output, such as - # generated CSS that some workspaces' own tests read back. - - name: Build packages - run: npm run build - - - name: Run workspace tests without build output - run: npm run test:ci-like - - packaging: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Build packages - run: npm run build - - - name: Check package contracts - run: npm run check:package-contracts - - - name: Check package size budgets - run: npm run check:ui-package-budgets - - - name: Check consumer tree shaking - run: npm run check:consumer-tree-shaking - - - name: Dry-run publish artifacts - run: npm run pack:all:dry-run - - packed-consumers: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Build packages - run: npm run build - - - name: Consume packed tarballs with npm, pnpm, and yarn - run: npm run check:packed-consumers - - hygiene: - runs-on: ubuntu-latest - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Check that a clean install stays clean - run: npm run check:clean-install - - - name: Audit release dependencies - run: npm run audit:release - - visual: - runs-on: macos-26 - env: - CHROME_FOR_TESTING_VERSION: 151.0.7922.138 - - steps: - - name: Checkout - uses: actions/checkout@v7 - - - name: Setup Node.js - uses: actions/setup-node@v6 - with: - node-version: 24 - cache: npm - - - name: Install dependencies - run: npm ci - - - name: Build packages - run: npm run build - - - name: Install pinned Chrome for visual checks - run: | - chrome_for_testing_path="${RUNNER_TEMP}/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing" - curl --fail --location --retry 3 --silent --show-error \ - "https://storage.googleapis.com/chrome-for-testing-public/${CHROME_FOR_TESTING_VERSION}/mac-arm64/chrome-mac-arm64.zip" \ - --output "${RUNNER_TEMP}/chrome-for-testing.zip" - unzip -q "${RUNNER_TEMP}/chrome-for-testing.zip" -d "${RUNNER_TEMP}" - "${chrome_for_testing_path}" --version - - - name: Verify cross-platform adapter visuals + - run: npm ci + - name: Check changed workspaces env: - CROSS_PLATFORM_CAPTURE: ${{ runner.temp }}/codemonster-cross-platform-current - CROSS_PLATFORM_VANILLA_DIFF: ${{ runner.temp }}/codemonster-cross-platform-vanilla-diff - CROSS_PLATFORM_VUE_DIFF: ${{ runner.temp }}/codemonster-cross-platform-vue-diff - run: | - set -euo pipefail - chrome_for_testing_path="${RUNNER_TEMP}/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing" - - npm run visual:cross-platform:serve -- --port=5176 > "${RUNNER_TEMP}/codemonster-cross-platform-vite.log" 2>&1 & - adapter_pid=$! - "${chrome_for_testing_path}" --headless=new --remote-debugging-port=9226 --user-data-dir="${RUNNER_TEMP}/codemonster-showcase-chrome" --disable-gpu --no-first-run --no-default-browser-check about:blank > "${RUNNER_TEMP}/codemonster-showcase-chrome.log" 2>&1 & - chrome_pid=$! - - cleanup() { - kill "${adapter_pid}" "${chrome_pid}" 2>/dev/null || true - } - trap cleanup EXIT - - for attempt in {1..60}; do - if curl --fail --silent 'http://127.0.0.1:5176/?case=button-default&platform=vue&theme=light' >/dev/null && curl --fail --silent http://127.0.0.1:9226/json/version >/dev/null; then - break - fi - if [ "${attempt}" -eq 60 ]; then - cat "${RUNNER_TEMP}/codemonster-cross-platform-vite.log" - cat "${RUNNER_TEMP}/codemonster-showcase-chrome.log" - exit 1 - fi - sleep 1 - done - - npm run visual:cross-platform:capture -- --origin=http://127.0.0.1:5176 --output="${CROSS_PLATFORM_CAPTURE}" --label=ci-actual-adapters - node scripts/visual/compare-showcase.mjs --baseline=visual-baselines/vueforge-cross-platform --current="${CROSS_PLATFORM_CAPTURE}/vue" --diff="${CROSS_PLATFORM_VUE_DIFF}" --threshold=4 - node scripts/visual/compare-showcase.mjs --baseline=visual-baselines/vueforge-cross-platform --current="${CROSS_PLATFORM_CAPTURE}/vanilla" --diff="${CROSS_PLATFORM_VANILLA_DIFF}" --threshold=4 - - CHROME_PATH="${chrome_for_testing_path}" CM_PARITY_REPORT="${RUNNER_TEMP}/codemonster-pair-visual.json" node scripts/visual/check-vanilla-parity.mjs - CHROME_PATH="${chrome_for_testing_path}" CM_PARITY_REPORT="${RUNNER_TEMP}/codemonster-pair-behavior.json" CM_PARITY_BEHAVIOR=1 node scripts/visual/check-vanilla-parity.mjs - - - name: Upload cross-platform visual differences - if: failure() - uses: actions/upload-artifact@v7 - with: - name: codemonster-cross-platform-visual-diff - path: | - ${{ runner.temp }}/codemonster-cross-platform-current - ${{ runner.temp }}/codemonster-cross-platform-vue-diff - ${{ runner.temp }}/codemonster-cross-platform-vanilla-diff - ${{ runner.temp }}/codemonster-pair-*.json - ${{ runner.temp }}/codemonster-cross-platform-vite.log - ${{ runner.temp }}/codemonster-showcase-chrome.log - if-no-files-found: ignore + BASE_SHA: ${{ github.event.pull_request.base.sha || github.event.before }} + run: npm run check -- "$BASE_SHA" --smoke diff --git a/.github/workflows/release-from-tag.yml b/.github/workflows/release-from-tag.yml index 32282bee..ecc593b9 100644 --- a/.github/workflows/release-from-tag.yml +++ b/.github/workflows/release-from-tag.yml @@ -6,60 +6,174 @@ on: - '@*/*@*' permissions: - contents: write - id-token: write + contents: read concurrency: group: codemonster-ui-package-publish cancel-in-progress: false +defaults: + run: + shell: bash + jobs: - publish: + verify: runs-on: ubuntu-latest + outputs: + commit: ${{ steps.commit.outputs.sha }} + package_name: ${{ steps.prep.outputs.package_name }} + package_version: ${{ steps.prep.outputs.package_version }} + dist_tag: ${{ steps.prep.outputs.dist_tag }} + tarball_name: ${{ steps.prep.outputs.tarball_name }} + is_prerelease: ${{ steps.prep.outputs.is_prerelease }} + release_name: ${{ steps.prep.outputs.release_name }} steps: - - name: Checkout - uses: actions/checkout@v7 + - uses: actions/checkout@v7 with: + ref: ${{ github.sha }} fetch-depth: 0 + persist-credentials: false + - name: Check the tagged commit + id: commit + run: | + commit=$(git rev-parse HEAD) + test "$commit" = "$(git rev-parse "$GITHUB_SHA^{commit}")" + test "$commit" = "$(git rev-parse "$GITHUB_REF^{commit}")" + echo "sha=$commit" >> "$GITHUB_OUTPUT" - - name: Setup Node.js - uses: actions/setup-node@v6 + - uses: actions/setup-node@v6 with: node-version: 24 cache: npm - registry-url: https://registry.npmjs.org - - - name: Pin npm - run: npm install --global npm@11.17.0 - - - name: Install dependencies - run: npm ci - + - run: npm install --global npm@11.17.0 + - run: npm ci - name: Resolve release target from tag id: prep + env: + RELEASE_NOTES_PATH: ${{ runner.temp }}/codemonster-release-notes.md run: node scripts/ci/prepare-release-from-tag.mjs - - - name: Verify release graph and packed consumer + - name: Verify packages and consumers run: npm run verify - - name: Pack verified target + - name: Pack and inspect the verified target + env: + PACKAGE_NAME: ${{ steps.prep.outputs.package_name }} + TARBALL_NAME: ${{ steps.prep.outputs.tarball_name }} + RELEASE_NOTES: ${{ steps.prep.outputs.release_notes_path }} + DIST_TAG: ${{ steps.prep.outputs.dist_tag }} + run: | + mkdir -p "$RUNNER_TEMP/release-package" + npm pack -w "$PACKAGE_NAME" --ignore-scripts --pack-destination "$RUNNER_TEMP/release-package" + cd "$RUNNER_TEMP/release-package" + npm publish "./$TARBALL_NAME" --dry-run --ignore-scripts --tag "$DIST_TAG" + cp "$RELEASE_NOTES" release-notes.md + sha256sum "$TARBALL_NAME" release-notes.md > SHA256SUMS + - uses: actions/upload-artifact@v7 + with: + name: release-package + path: ${{ runner.temp }}/release-package/ + if-no-files-found: error + + visual: + runs-on: macos-26 + env: + CHROME_FOR_TESTING_VERSION: 151.0.7922.138 + outputs: + commit: ${{ steps.commit.outputs.sha }} + + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.sha }} + persist-credentials: false + - name: Check the browser test commit + id: commit + run: | + commit=$(git rev-parse HEAD) + test "$commit" = "$(git rev-parse "$GITHUB_SHA^{commit}")" + echo "sha=$commit" >> "$GITHUB_OUTPUT" + - uses: actions/setup-node@v6 + with: + node-version: 24 + cache: npm + - run: npm ci + - run: npm run build + - name: Install pinned Chrome run: | - mkdir -p .release-artifacts - npm pack -w "${{ steps.prep.outputs.package_name }}" --ignore-scripts --pack-destination .release-artifacts - test -f ".release-artifacts/${{ steps.prep.outputs.tarball_name }}" + chrome_path="$RUNNER_TEMP/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing" + curl --fail --location --retry 3 --silent --show-error \ + "https://storage.googleapis.com/chrome-for-testing-public/${CHROME_FOR_TESTING_VERSION}/mac-arm64/chrome-mac-arm64.zip" \ + --output "$RUNNER_TEMP/chrome-for-testing.zip" + unzip -q "$RUNNER_TEMP/chrome-for-testing.zip" -d "$RUNNER_TEMP" + "$chrome_path" --version + echo "CHROME_PATH=$chrome_path" >> "$GITHUB_ENV" + - name: Check browser behavior and strict visual baselines + env: + CM_BROWSER_OUTPUT: ${{ runner.temp }}/codemonster-release-browser + run: bash scripts/visual/run-browser-checks.sh release + - name: Upload browser failures + if: failure() + uses: actions/upload-artifact@v7 + with: + name: codemonster-release-browser + path: | + ${{ runner.temp }}/codemonster-release-browser/capture + ${{ runner.temp }}/codemonster-release-browser/diff-* + ${{ runner.temp }}/codemonster-release-browser/*.json + ${{ runner.temp }}/codemonster-release-browser/*.log + if-no-files-found: ignore + + publish: + needs: [verify, visual] + runs-on: ubuntu-latest + permissions: + contents: write + id-token: write + env: + VERIFIED_COMMIT: ${{ needs.verify.outputs.commit }} + VISUAL_COMMIT: ${{ needs.visual.outputs.commit }} + PACKAGE_NAME: ${{ needs.verify.outputs.package_name }} + PACKAGE_VERSION: ${{ needs.verify.outputs.package_version }} + DIST_TAG: ${{ needs.verify.outputs.dist_tag }} + TARBALL_NAME: ${{ needs.verify.outputs.tarball_name }} - - name: Inspect target tarball - run: npm publish ".release-artifacts/${{ steps.prep.outputs.tarball_name }}" --dry-run --ignore-scripts --tag "${{ steps.prep.outputs.dist_tag }}" + steps: + - uses: actions/checkout@v7 + with: + ref: ${{ github.sha }} + fetch-depth: 0 + persist-credentials: false + - name: Confirm both checks verified the tagged commit + run: | + commit=$(git rev-parse HEAD) + test "$commit" = "$(git rev-parse "$GITHUB_SHA^{commit}")" + test "$commit" = "$(git rev-parse "$GITHUB_REF^{commit}")" + test "$commit" = "$VERIFIED_COMMIT" + test "$commit" = "$VISUAL_COMMIT" + - uses: actions/setup-node@v6 + with: + node-version: 24 + registry-url: https://registry.npmjs.org + package-manager-cache: false + - run: npm install --global npm@11.17.0 + - uses: actions/download-artifact@v8 + with: + name: release-package + path: ${{ runner.temp }}/release-package + - name: Verify the package archive + working-directory: ${{ runner.temp }}/release-package + run: | + sha256sum --check --strict SHA256SUMS + test -f "$TARBALL_NAME" - name: Check existing registry version id: registry + working-directory: ${{ runner.temp }}/release-package run: | - package_spec="${{ steps.prep.outputs.package_name }}@${{ steps.prep.outputs.package_version }}" - tarball=".release-artifacts/${{ steps.prep.outputs.tarball_name }}" - + package_spec="$PACKAGE_NAME@$PACKAGE_VERSION" if npm view "$package_spec" version >/dev/null 2>&1; then - npm diff --diff="$package_spec" --diff="$tarball" --diff-name-only | sed '/^[[:space:]]*$/d' > .release-diff + npm diff --diff="$package_spec" --diff="./$TARBALL_NAME" --diff-name-only | sed '/^[[:space:]]*$/d' > .release-diff if test -s .release-diff; then cat .release-diff exit 1 @@ -71,13 +185,14 @@ jobs: - name: Publish package to npm if: steps.registry.outputs.published != 'true' - run: npm publish ".release-artifacts/${{ steps.prep.outputs.tarball_name }}" --access public --provenance --tag "${{ steps.prep.outputs.dist_tag }}" + working-directory: ${{ runner.temp }}/release-package + run: npm publish "./$TARBALL_NAME" --access public --provenance --tag "$DIST_TAG" - name: Create GitHub release uses: softprops/action-gh-release@v3 with: - name: ${{ steps.prep.outputs.release_name }} - body_path: ${{ steps.prep.outputs.release_notes_path }} - prerelease: ${{ steps.prep.outputs.is_prerelease }} + name: ${{ needs.verify.outputs.release_name }} + body_path: ${{ runner.temp }}/release-package/release-notes.md + prerelease: ${{ needs.verify.outputs.is_prerelease }} tag_name: ${{ github.ref_name }} - target_commitish: ${{ github.sha }} + target_commitish: ${{ needs.verify.outputs.commit }} diff --git a/.markdownlint-cli2.jsonc b/.markdownlint-cli2.jsonc index c3152d47..c68f0b19 100644 --- a/.markdownlint-cli2.jsonc +++ b/.markdownlint-cli2.jsonc @@ -9,6 +9,9 @@ } }, "ignores": [ + "artifacts/**", + "**/.generated/**", + "**/.cache/**", "**/node_modules/**", "**/dist/**", "**/coverage/**", diff --git a/.prettierignore b/.prettierignore index ed96f99d..1fc1e774 100644 --- a/.prettierignore +++ b/.prettierignore @@ -1,3 +1,6 @@ +/artifacts/ +**/.cache +**/.vite **/dist **/.generated **/coverage diff --git a/.stylelintrc.json b/.stylelintrc.json index c1754b0e..d48d71b8 100644 --- a/.stylelintrc.json +++ b/.stylelintrc.json @@ -1,6 +1,14 @@ { "extends": ["stylelint-config-standard", "stylelint-config-html"], - "ignoreFiles": ["**/dist/**", "**/showcase-dist/**", "**/coverage/**", "**/node_modules/**"], + "ignoreFiles": [ + "artifacts/**", + "**/.generated/**", + "**/.cache/**", + "**/dist/**", + "**/showcase-dist/**", + "**/coverage/**", + "**/node_modules/**" + ], "rules": { "import-notation": null, "selector-class-pattern": [ diff --git a/.vscode/tasks.json b/.vscode/tasks.json index c524ace5..ce3c5509 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -90,19 +90,10 @@ "dependsOn": ["monorepo:lint:once", "monorepo:styles-html:once", "monorepo:md-data:once"], "problemMatcher": [] }, - { - "label": "monorepo:diagnostics:watch", - "dependsOrder": "parallel", - "dependsOn": ["monorepo:typecheck:watch", "monorepo:quality:once"], - "runOptions": { - "runOn": "folderOpen" - }, - "problemMatcher": [] - }, { "label": "monorepo:check:once", "type": "shell", - "command": "npm run lint:all && npm run typecheck --workspaces --if-present", + "command": "npm run check", "problemMatcher": "$tsc", "presentation": { "reveal": "always", diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..50fe0779 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,10 @@ +# Development checks + +- For small changes, run the relevant tests and lint or type checks. Use the Vue or Vanilla + development showcase when browser behavior or visual output needs checking. +- For package changes, check the package and its affected published dependants. +- Use the full check for shared contracts, configuration and lockfile changes. +- Let PR CI run the automated check and Chromium smoke for applicable changes. Use the + [release checklist](docs/release-checklist.md) for the full release checks. +- Repeat a successful check when its inputs change or when diagnosing a failure. Summarize + routine checks in the task or PR. Keep standalone verification records for release needs. diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index c5cc7432..736d7aea 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -97,14 +97,8 @@ validate a cross-package invariant. ## Release hygiene -Before release: - -1. Ensure package version bump matches change scope (`patch`/`minor`, avoid unnecessary `major`). -2. Update package `CHANGELOG.md` with user-visible changes. -3. Run package-level `check` for touched packages. -4. Run root `build` and `prepublish:all` before publishing. -5. Avoid committing generated/local-only artifacts unless intentionally part of package contents. -6. Keep local `node_modules`, `.npm-cache`, `.DS_Store`, build output, and test coverage out of Git. +Follow the [release checklist](docs/release-checklist.md) for versioning, package verification, +and publication. See the [development checks](README.md#development-checks) for routine changes. ## Non-goals diff --git a/README.md b/README.md index ecb6fad9..319025e2 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,24 @@ commands are available under the root `package.json` in the VS Code NPM Scripts Use `npm run dev` for the Vue showcase with hot reload. See the [Vanilla guide](./docs/vanilla.md) for the static assets and template integration. +## Development checks + +Run the smallest check that covers the change. For a Vue component, run its source test directly: + +```sh +npm exec -w @codemonster-ru/ui-vue -- vitest run src/components/button/CmButton.test.ts +``` + +Use `npm test -w @codemonster-ru/ui-runtime` for a standalone package test. Check dependent +packages when behavior or an export changes. For a broader change, use +`npm run check -- "$(git rev-parse origin/main)"` to test the changed workspaces and their published +dependants. `npm run check` checks the full graph. Shared contracts, configuration and lockfile +changes select the full graph automatically. + +CI runs on pull requests and pushes to `main`, with a short Chromium smoke for applicable changes. +The tag workflow runs package and strict browser verification before publishing. See the +[release checklist](./docs/release-checklist.md) for release commands and manual checks. + ## VueForge CodeMonster UI succeeds VueForge, the Vue-only design system this project migrated from. VueForge diff --git a/docs/architecture/browser-and-css-support.md b/docs/architecture/browser-and-css-support.md index 8b55f269..dabe9fcc 100644 --- a/docs/architecture/browser-and-css-support.md +++ b/docs/architecture/browser-and-css-support.md @@ -93,9 +93,11 @@ supported build target and do not add a second legacy bundle to shared packages. ## Verification -Continuous integration covers Chromium, Firefox, and WebKit engines for canonical rendering and -interaction cases. Release verification additionally checks representative real Safari and mobile -browser behavior where engine emulation is insufficient. +Pull request CI runs a short headless Chromium interaction smoke for applicable changes. +The release workflow runs the full stored comparisons and cross-platform behavior checks with +pinned Chrome on macOS. Use the repository browser scripts with Firefox and WebKit for +representative release cases. Native Safari, mobile browser and assistive-technology checks +remain part of release verification where browser automation cannot cover the behavior. Tests include: @@ -108,8 +110,7 @@ Tests include: - directly served static assets; - no-JavaScript and progressively enhanced Vanilla pages. -The exact automated browser versions are recorded in CI configuration when `CMUI-016` establishes -workspace conventions. +See the [release workflow](../../.github/workflows/release-from-tag.yml) for the pinned visual renderer. ## Review policy diff --git a/docs/architecture/vueforge-migration-policy.md b/docs/architecture/vueforge-migration-policy.md index 3dd105c5..c0dd1544 100644 --- a/docs/architecture/vueforge-migration-policy.md +++ b/docs/architecture/vueforge-migration-policy.md @@ -105,8 +105,7 @@ migration state, not a permanent compatibility architecture. - Do not ship duplicate `.vf-*` selectors in `ui-css`. - Do not emit both `--vf-*` and `--cm-*` variables from new token packages. - In the Vue adapter, restore a `Vf*` export only after verifying its contract. See the - [historical restoration queue](../verification/historical-restoration.md) and its traceability - records for scope and differences. + [consumer migration guide](../migrate-from-vueforge.md) for scope and differences. - Do not make new adapters depend on VueForge packages. - Do not preserve obsolete API shapes that conflict with canonical HTML or accessibility. - Add a migration transform only when the change is deterministic and safe. diff --git a/docs/codemonster-ui-roadmap-v2.md b/docs/codemonster-ui-roadmap-v2.md index 3ba4edf4..fb16f254 100644 --- a/docs/codemonster-ui-roadmap-v2.md +++ b/docs/codemonster-ui-roadmap-v2.md @@ -1,7 +1,7 @@ # CodeMonster UI maturity roadmap This document continues the completed -[CodeMonster UI 1.0 roadmap](./codemonster-ui-roadmap.md). CodeMonster UI 1.0 proved the shared +[CodeMonster UI 1.0 roadmap](https://github.com/codemonster-ru/ui/blob/857c0e396077a7703a6b0b28c7c731fdb7f7befb/docs/codemonster-ui-roadmap.md). CodeMonster UI 1.0 proved the shared contract, CSS, runtime, Vue, and Annabel Razor architecture. This roadmap closes the remaining functional, migration, and visual-compatibility gaps before another platform adapter is scheduled. @@ -69,33 +69,15 @@ that threshold. There is no design-change tolerance. ## Working rules -- Complete phases in order unless a dependency recorded below permits parallel work. -- Keep every implementation commit buildable and include its relevant tests. Update this roadmap - only when an item changes status, scope, dependency, or a decision changes the delivery plan. -- Reference the stable item identifier in the commit body, for example `Roadmap: CMUI-170`. -- Do not mark an item complete because component files exist on both platforms. -- Record every legacy capability as `supported`, `superseded`, `application-owned`, `retained`, or - `missing`, with evidence for the decision. -- A `supported` capability requires tests at the appropriate contract, adapter, accessibility, - interaction, SSR or server-rendering, and visual layers. -- A visual claim requires rendered screenshot comparison. Generating an HTML fixture matrix without - capturing and comparing pixels is fixture coverage, not visual verification. -- Treat VueForge token source and formulas as the first visual-compatibility input. Compare token - names, aliases, formulas, serialized values, and computed browser values before changing - component or showcase CSS. -- Keep visual corrections in the lowest shared layer that owns the behavior: tokens in - `ui-tokens`, component geometry and states in `ui-css` or the shared component contract, adapter - behavior in the platform adapter, and only application-owned composition in the showcase. -- Do not accept screenshot-driven offsets, selectors, or markup changes as component fixes. A - screenshot diff is a validation signal, not the implementation source of truth; every shared - component change requires canonical Vue and Razor evidence before it can close a visual item. -- Use commit `fd793696f50d3be0fcd3788f0f8f751c63869963` as the frozen VueForge repository, - showcase, token, and component-style reference. Compare equivalent routes, states, themes, and - viewports; do not approve a new design merely because Vue and Razor match each other. -- Do not weaken canonical HTML or accessibility contracts solely to reproduce a VueForge API. -- Record material scope changes in the decision log before changing the numbered checklist. -- Do not use the decision log as an implementation journal. Link routine visual-fix evidence from - the relevant work item, issue, or commit instead. +Follow the [development checks](../README.md#development-checks) for routine changes. Use this +roadmap for the remaining product and migration work. + +- Record changes to legacy capability dispositions with evidence appropriate to the behavior. +- Keep visual changes in the layer that owns the behavior. Use shared tokens for colors and + geometry, shared CSS for component presentation, and adapter code for platform behavior. +- Use the frozen VueForge reference for historical compatibility decisions and + [the checked-in fixture baseline](../visual-baselines/README.md) for release comparisons. +- Preserve canonical HTML and accessibility contracts when reconciling VueForge behavior. ## Progress diff --git a/docs/codemonster-ui-roadmap.md b/docs/codemonster-ui-roadmap.md deleted file mode 100644 index 810ca575..00000000 --- a/docs/codemonster-ui-roadmap.md +++ /dev/null @@ -1,494 +0,0 @@ -# CodeMonster UI roadmap - -This document tracked CodeMonster UI 1.0. The active tracker is the -[maturity roadmap](./codemonster-ui-roadmap-v2.md); this one records how VueForge became a -cross-platform CodeMonster UI design system. The current delivery scope covers the shared design foundation and -the Vue and Annabel Razor adapters. React and Angular adapters are unscheduled future considerations -and do not block the current roadmap or any release. They may enter the active scope only when a -concrete product need is identified. - -The product identity and technical names are approved in -[CodeMonster UI product identity](./architecture/product-identity.md) and -[CodeMonster UI naming and prefixes](./architecture/naming-and-prefixes.md). Supported platform -floors are defined in [CodeMonster UI platform support](./architecture/platform-support.md), and -ownership is defined in [CodeMonster UI package boundaries](./architecture/package-boundaries.md). -Component specifications follow -[CodeMonster UI component contract format](./architecture/component-contract-format.md), and their -rendering follows [CodeMonster UI canonical HTML](./architecture/canonical-html.md). -Public APIs follow -[CodeMonster UI component API conventions](./architecture/component-api-conventions.md). -State representation follows [CodeMonster UI component states](./architecture/component-states.md). -Accessibility follows -[CodeMonster UI accessibility requirements](./architecture/accessibility-requirements.md). -Rendering modes follow [CodeMonster UI rendering strategy](./architecture/rendering-strategy.md). -Escaping and trusted markup follow [CodeMonster UI HTML security](./architecture/html-security.md). -Browser and CSS support follows -[CodeMonster UI browser and CSS support](./architecture/browser-and-css-support.md). -Distribution follows -[CodeMonster UI package topology and releases](./architecture/package-topology-and-releases.md). -Migration follows [VueForge migration policy](./architecture/vueforge-migration-policy.md). -Initial scope follows [CodeMonster UI pilot components](./architecture/pilot-components.md). -Repository layout follows -[CodeMonster UI workspace conventions](./architecture/workspace-conventions.md). -Application shell ownership follows -[CodeMonster UI application shell ownership](./architecture/application-shell-ownership.md). -CodeBlock ownership follows -[CodeMonster UI CodeBlock ownership](./architecture/codeblock-ownership.md). -Playground ownership follows -[CodeMonster UI Playground ownership](./architecture/playground-ownership.md). - -## How to use this roadmap - -- Complete phases in order unless a documented dependency permits parallel work. -- Skip the unscheduled React and Angular adapter phases; after Phase 9, continue with Phase 12. -- Keep every implementation commit buildable and include its tests in the same commit. -- Mark a checklist item complete in the commit that completes the work. -- Write commit subjects in the repository style: concise, imperative, sentence case, and without a - Conventional Commits prefix. -- Reference the stable item identifier in the commit body, for example `Roadmap: CMUI-021`. -- Do not mark an item complete for partial implementation. -- Record material scope or architecture changes in the decision log before changing this plan. -- Record Annabel work with its repository commit SHA in the cross-repository log. -- Do not squash completed roadmap commits when merging the integration branch. - -## Branches - -| Repository | Integration branch | Responsibility | -| ------------------------------- | ----------------------- | --------------------------------------- | -| `codemonster-ru/ui` | `main` | Shared foundation and platform adapters | -| `codemonster-ru/annabel` | `feat/razor-components` | Generic Razor component model | - -Short-lived branches may be created from the relevant integration branch. Merge or rebase them -without squashing so each completed roadmap item remains visible. - -## Definition of done - -An item is complete only when all applicable conditions are satisfied: - -- public behavior and ownership are documented; -- implementation follows the approved component contract; -- unit, contract, SSR, accessibility, and visual tests relevant to the change pass; -- package exports and packed-consumer behavior are verified when distribution changes; -- no unrelated compatibility layer or platform dependency is introduced; -- this roadmap is updated in the same commit. - -## Progress - -- Current phase: Complete — Phase 15 delivered -- Current milestone: M8 — Naming cleanup completed -- Completed milestones: M0 — approved architecture; M1 — framework-independent tokens and CSS; M2 — Button and Card parity; M3 — Input form parity; M4 — Accordion interaction parity; M6 — utilities and stable component cohort; M7 — migration and CodeMonster UI 1.0; M8 — concise repository and Razor package names -- Next item: None; React and Angular remain unscheduled future considerations. - -Post-1.0 component maturity and migration completion continue in the -[CodeMonster UI maturity roadmap](./codemonster-ui-roadmap-v2.md). - -## Milestones - -| Milestone | Outcome | Status | -| --------- | ------------------------------------------------------------------------- | -------------------- | -| M0 | Product name, boundaries, contracts, and migration policy approved | Completed | -| M1 | Framework-independent tokens and CSS packages build and publish correctly | Completed | -| M2 | Button and Card render with parity in Vue and Annabel Razor | Completed | -| M3 | Input supports Vue binding and native Razor form submission | Completed | -| M4 | Accordion proves accessible cross-platform interaction | Completed | -| M5 | React and Angular implement the four pilot contracts | Future consideration | -| M6 | Utility CSS and the first stable component cohort are available | Completed | -| M7 | VueForge migration and CodeMonster UI 1.0 are complete | Completed | -| M8 | Repository and Razor package names are concise and validated | Completed | - -## Phase 0 — Product and architecture decisions - -- [x] `CMUI-001` Approve the product name and repository name. -- [x] `CMUI-002` Approve npm, Composer, CSS, custom-property, and component prefixes. -- [x] `CMUI-003` Define supported platforms and their version floors. -- [x] `CMUI-004` Define shared-kernel and adapter ownership boundaries. -- [x] `CMUI-005` Define the canonical component contract format. -- [x] `CMUI-006` Define canonical HTML and significant DOM parity rules. -- [x] `CMUI-007` Define props, attributes, events, and slots conventions. -- [x] `CMUI-008` Define component states through classes, native attributes, ARIA, and `data-*`. -- [x] `CMUI-009` Define accessibility and keyboard-interaction requirements. -- [x] `CMUI-010` Define SSR, progressive-enhancement, and hydration boundaries. -- [x] `CMUI-011` Define escaping, trusted HTML, and slot security rules. -- [x] `CMUI-012` Define browser support and CSS feature policy. -- [x] `CMUI-013` Define package topology and release ownership. -- [x] `CMUI-014` Decide the VueForge maintenance and migration policy. -- [x] `CMUI-015` Approve the four pilot components: Button, Card, Input, and Accordion. - -### M0 exit gate - -- [x] `CMUI-G000` All phase 0 decisions are approved and recorded as architecture documents. - -## Phase 1 — Repository and contract infrastructure - -- [x] `CMUI-016` Add CodeMonster UI workspace conventions. -- [x] `CMUI-017` Add shared package metadata helpers or validation. -- [x] `CMUI-018` Add the component contract directory structure. -- [x] `CMUI-019` Add canonical HTML fixture infrastructure. -- [x] `CMUI-020` Add normalized DOM comparison utilities. -- [x] `CMUI-021` Add a root contract-test command. -- [x] `CMUI-022` Add cross-platform accessibility test infrastructure. -- [x] `CMUI-023` Add visual parity fixture infrastructure. -- [x] `CMUI-024` Add new packages to root lint, typecheck, test, and build orchestration. -- [x] `CMUI-025` Extend package-contract checks for CodeMonster UI packages. -- [x] `CMUI-026` Add packed-consumer checks for CSS-only consumers. -- [x] `CMUI-027` Add bundle and CSS size budgets for new packages. - -## Phase 2 — Framework-independent tokens - -- [x] `CMUI-028` Scaffold `@codemonster-ru/ui-tokens`. -- [x] `CMUI-029` Move primitive color token ownership into the tokens package. -- [x] `CMUI-030` Move semantic color token ownership into the tokens package. -- [x] `CMUI-031` Move spacing and sizing token ownership into the tokens package. -- [x] `CMUI-032` Move typography token ownership into the tokens package. -- [x] `CMUI-033` Move radius, border, and shadow token ownership into the tokens package. -- [x] `CMUI-034` Move motion token ownership into the tokens package. -- [x] `CMUI-035` Move breakpoint token ownership into the tokens package. -- [x] `CMUI-036` Add the light theme preset. -- [x] `CMUI-037` Add the dark theme preset. -- [x] `CMUI-038` Generate `--cm-*` custom properties. -- [x] `CMUI-039` Generate portable breakpoint CSS. -- [x] `CMUI-040` Expose the framework-independent theme serialization API. -- [x] `CMUI-041` Add token schema and generated CSS contract tests. -- [x] `CMUI-042` Document token and theme consumption. - -## Phase 3 — Framework-independent CSS - -- [x] `CMUI-043` Scaffold `@codemonster-ru/ui-css`. -- [x] `CMUI-044` Add reset and document foundation styles. -- [x] `CMUI-045` Add focus-visible and focus-ring foundations. -- [x] `CMUI-046` Add reduced-motion and forced-colors foundations. -- [x] `CMUI-047` Add shared control primitives. -- [x] `CMUI-048` Add shared surface primitives. -- [x] `CMUI-049` Expose complete and foundation-only stylesheets. -- [x] `CMUI-050` Add CSS subpath export checks. -- [x] `CMUI-051` Add CSS-only packed-consumer smoke tests. -- [x] `CMUI-052` Prevent Vue imports and `vf` selectors in the new CSS package. -- [x] `CMUI-053` Document CSS-only usage. - -### M1 exit gate - -- [x] `CMUI-G001` Tokens and CSS build without Vue and pass packed-consumer verification. - -## Phase 4 — Button vertical slice - -- [x] `CMUI-054` Define the Button component contract. -- [x] `CMUI-055` Add Button canonical fixtures for variants and sizes. -- [x] `CMUI-056` Add Button canonical fixtures for disabled and loading states. -- [x] `CMUI-057` Add Button canonical fixtures for link rendering and icon slots. -- [x] `CMUI-058` Move Button styles into the shared CSS package. -- [x] `CMUI-059` Add Button selector and accessibility contracts. -- [x] `CMUI-060` Scaffold `@codemonster-ru/ui-vue`. -- [x] `CMUI-061` Add Vue attribute forwarding and class utilities. -- [x] `CMUI-062` Add Vue `CmButton`. -- [x] `CMUI-063` Add Vue Button loading and icon-slot rendering. -- [x] `CMUI-064` Add Vue Button link rendering. -- [x] `CMUI-065` Verify Vue Button DOM, events, and SSR output. - -## Phase 5 — Generic Annabel Razor component model - -These items are implemented in `codemonster-ru/annabel`. Each completed item must include its tests -and be recorded in the cross-repository log below. - -- [x] `ARAZOR-001` Approve Razor component syntax and compilation semantics. -- [x] `ARAZOR-002` Add a trusted rendered-HTML value object. -- [x] `ARAZOR-003` Add component, render-context, and resolver contracts. -- [x] `ARAZOR-004` Add the component registry and prefix registration. -- [x] `ARAZOR-005` Parse self-closing component tags. -- [x] `ARAZOR-006` Parse paired component tags. -- [x] `ARAZOR-007` Compile static, expression, and boolean props. -- [x] `ARAZOR-008` Compile default slots. -- [x] `ARAZOR-009` Compile named slots. -- [x] `ARAZOR-010` Support nested components. -- [x] `ARAZOR-011` Render registered components through the resolver. -- [x] `ARAZOR-012` Preserve trusted component output while escaping user values. -- [x] `ARAZOR-013` Add diagnostics for unknown and malformed components. -- [x] `ARAZOR-014` Verify component cache invalidation. -- [x] `ARAZOR-015` Document custom component registration and security. -- [x] `ARAZOR-016` Prepare the Annabel Razor component API release. - -## Phase 6 — CodeMonster UI Annabel Razor adapter - -- [x] `CMUI-066` Scaffold the `codemonster-ru/ui` Composer package. -- [x] `CMUI-067` Add the Annabel UI component provider and `cm` prefix registration. -- [x] `CMUI-068` Add shared prop validation, attribute bags, and class building. -- [x] `CMUI-069` Add the shared asset manifest and publishing API. -- [x] `CMUI-070` Package the exact shared CSS artifacts for PHP consumers. -- [x] `CMUI-071` Add the PHP `CmButton` component. -- [x] `CMUI-072` Add the Button Razor template. -- [x] `CMUI-073` Add Razor Button loading and link rendering. -- [x] `CMUI-074` Verify Razor Button escaping and accessibility. -- [x] `CMUI-075` Compare significant Vue and Razor Button DOM. -- [x] `CMUI-076` Document Button usage in Vue and Razor. - -## Phase 7 — Card and composition - -- [x] `CMUI-077` Define the Card component contract and fixtures. -- [x] `CMUI-078` Move Card styles into the shared CSS package. -- [x] `CMUI-079` Add Vue `CmCard` with header, default, and footer slots. -- [x] `CMUI-080` Verify Vue Card DOM and SSR output. -- [x] `CMUI-081` Add PHP Card and Card section components. -- [x] `CMUI-082` Add Card Razor templates. -- [x] `CMUI-083` Verify nested Razor Card rendering and escaping. -- [x] `CMUI-084` Compare significant Vue and Razor Card DOM. -- [x] `CMUI-085` Document Card composition in Vue and Razor. - -### M2 exit gate - -- [x] `CMUI-G002` Button and Card pass Vue/Razor DOM, SSR, accessibility, and visual parity checks. - -## Phase 8 — Input and native forms - -- [x] `CMUI-086` Define Field and Input contracts and fixtures. -- [x] `CMUI-087` Define native submission and validation behavior. -- [x] `CMUI-088` Move Field and Input styles into the shared CSS package. -- [x] `CMUI-089` Add Vue `CmField`. -- [x] `CMUI-090` Add Vue `CmInput` and model binding. -- [x] `CMUI-091` Verify Vue Field/Input DOM, events, and SSR output. -- [x] `CMUI-092` Add PHP Field and Input components. -- [x] `CMUI-093` Add Field and Input Razor templates. -- [x] `CMUI-094` Preserve submitted values and render validation errors. -- [x] `CMUI-095` Verify native Razor form submission and escaping. -- [x] `CMUI-096` Compare Vue and Razor Field/Input accessibility. -- [x] `CMUI-097` Document Vue and Razor form integration. - -### M3 exit gate - -- [x] `CMUI-G003` Input supports Vue binding and native Razor form submission with parity. - -## Phase 9 — Shared runtime and Accordion - -- [x] `CMUI-098` Scaffold `@codemonster-ru/ui-runtime`. -- [x] `CMUI-099` Add controller lifecycle and component discovery. -- [x] `CMUI-100` Add safe repeated initialization and disposal. -- [x] `CMUI-101` Add optional mutation-observer initialization. -- [x] `CMUI-102` Add shared custom-event helpers. -- [x] `CMUI-103` Define the Accordion rendering and behavior contract. -- [x] `CMUI-104` Move Accordion styles into the shared CSS package. -- [x] `CMUI-105` Add the framework-independent Accordion controller. -- [x] `CMUI-106` Add Accordion ARIA synchronization and keyboard behavior. -- [x] `CMUI-107` Add Vue `CmAccordion`. -- [x] `CMUI-108` Verify Vue Accordion behavior and SSR output. -- [x] `CMUI-109` Add PHP/Razor Accordion rendering. -- [x] `CMUI-110` Verify progressively enhanced Razor Accordion behavior. -- [x] `CMUI-111` Compare cross-platform Accordion state transitions. -- [x] `CMUI-112` Document runtime installation and progressive enhancement. - -### M4 exit gate - -- [x] `CMUI-G004` Accordion proves accessible shared behavior in Vue and Razor consumers. - -## Phase 10 — React adapter (not scheduled) - -This phase is a future consideration outside the active roadmap. It has no target release or start -date and should enter the delivery scope only in response to a concrete product need. - -- [ ] `CMUI-113` Scaffold `@codemonster-ru/ui-react`. -- [ ] `CMUI-114` Add React shared prop and attribute utilities. -- [ ] `CMUI-115` Add and verify React `CmButton`. -- [ ] `CMUI-116` Add and verify React `CmCard`. -- [ ] `CMUI-117` Add and verify React `CmField` and `CmInput`. -- [ ] `CMUI-118` Add and verify React `CmAccordion`. -- [ ] `CMUI-119` Include React in parity and packed-consumer checks. -- [ ] `CMUI-120` Document React installation and pilot components. - -## Phase 11 — Angular adapter (not scheduled) - -This phase is a future consideration outside the active roadmap. It has no target release or start -date and should enter the delivery scope only in response to a concrete product need. - -- [ ] `CMUI-121` Scaffold `@codemonster-ru/ui-angular`. -- [ ] `CMUI-122` Add Angular shared input and attribute utilities. -- [ ] `CMUI-123` Add and verify Angular `CmButton`. -- [ ] `CMUI-124` Add and verify Angular `CmCard`. -- [ ] `CMUI-125` Add and verify Angular `CmField` and `CmInput`. -- [ ] `CMUI-126` Add and verify Angular `CmAccordion`. -- [ ] `CMUI-127` Include Angular in parity and packed-consumer checks. -- [ ] `CMUI-128` Document Angular installation and pilot components. - -### M5 exit gate (not scheduled) - -- [ ] `CMUI-G005` All four adapters implement and verify the pilot component contracts. - -## Phase 12 — Utility CSS - -- [x] `CMUI-129` Approve the initial utility scope and naming contract. -- [x] `CMUI-130` Scaffold `@codemonster-ru/ui-utilities`. -- [x] `CMUI-131` Generate display utilities from the approved contract. -- [x] `CMUI-132` Generate flex and grid utilities. -- [x] `CMUI-133` Generate spacing and sizing utilities from tokens. -- [x] `CMUI-134` Generate typography and color utilities from tokens. -- [x] `CMUI-135` Generate border and radius utilities from tokens. -- [x] `CMUI-136` Add approved responsive variants. -- [x] `CMUI-137` Add token-reference and CSS-size contract tests. -- [x] `CMUI-138` Document utility CSS usage and limitations. - -## Phase 13 — Component expansion - -Each component follows the same sequence: contract, shared CSS, Vue and Annabel Razor adapters, -applicable shared runtime, parity tests, and documentation. Add child checklist items before -starting a cohort. React and Angular implementations are not required unless they are explicitly -added to the active scope in the future. - -- [x] `CMUI-139` Migrate the display cohort: Badge, Alert, Avatar, Divider, and Skeleton. - - [x] `CMUI-139a` Define contracts and canonical fixtures for the display cohort. - - [x] `CMUI-139b` Add shared CSS for the display cohort. - - [x] `CMUI-139c` Add Vue adapters for the display cohort. - - [x] `CMUI-139d` Add Annabel Razor adapters for the display cohort. - - [x] `CMUI-139e` Verify display-cohort parity, accessibility, visual fixtures, and documentation. -- [x] `CMUI-140` Migrate the form cohort: Checkbox, Radio, Textarea, and Switch. - - [x] `CMUI-140a` Define contracts, native form semantics, and fixtures for the form cohort. - - [x] `CMUI-140b` Add shared CSS for Checkbox, Radio, Textarea, and Switch. - - [x] `CMUI-140c` Add Vue form adapters and binding verification. - - [x] `CMUI-140d` Add Annabel Razor form adapters and submission verification. - - [x] `CMUI-140e` Verify form-cohort DOM, accessibility, interaction, and documentation parity. -- [x] `CMUI-141` Migrate the navigation cohort: Link, Breadcrumbs, Tabs, Dropdown, and Menu. - - [x] `CMUI-141a` Define navigation contracts, canonical fixtures, and keyboard behavior. - - [x] `CMUI-141b` Add shared CSS for Link, Breadcrumbs, Tabs, Dropdown, and Menu. - - [x] `CMUI-141c` Add shared progressive-enhancement runtime for interactive navigation. - - [x] `CMUI-141d` Add Vue navigation adapters and controlled-state verification. - - [x] `CMUI-141e` Add Annabel Razor navigation adapters and runtime integration. - - [x] `CMUI-141f` Verify navigation DOM, accessibility, interaction, visual, and documentation parity. -- [x] `CMUI-142` Migrate the overlay cohort: Dialog, Drawer, Popover, and Tooltip. - - [x] `CMUI-142a` Define overlay contracts, canonical fixtures, focus management, and dismissal behavior. - - [x] `CMUI-142b` Add shared CSS for Dialog, Drawer, Popover, and Tooltip. - - [x] `CMUI-142c` Add shared progressive-enhancement runtime for overlay interaction. - - [x] `CMUI-142d` Add Vue overlay adapters and controlled-state verification. - - [x] `CMUI-142e` Add Annabel Razor overlay adapters and runtime integration. - - [x] `CMUI-142f` Verify overlay DOM, accessibility, interaction, visual, and documentation parity. -- [x] `CMUI-143` Migrate the advanced-input cohort: Select, DatePicker, and CommandPalette. - - [x] `CMUI-143a` Define advanced-input contracts, canonical fixtures, and keyboard behavior. - - [x] `CMUI-143b` Add shared CSS for Select, DatePicker, and CommandPalette. - - [x] `CMUI-143c` Add shared progressive-enhancement runtime for interactive advanced inputs. - - [x] `CMUI-143d` Add Vue advanced-input adapters and binding verification. - - [x] `CMUI-143e` Add Annabel Razor advanced-input adapters and submission integration. - - [x] `CMUI-143f` Verify advanced-input DOM, accessibility, interaction, visual, and documentation parity. -- [x] `CMUI-144` Migrate the data-display cohort: Table and DataTable. - - [x] `CMUI-144a` Define Table and DataTable contracts, canonical fixtures, and interaction behavior. - - [x] `CMUI-144b` Add shared CSS for Table and DataTable. - - [x] `CMUI-144c` Add shared progressive-enhancement runtime for interactive DataTable behavior. - - [x] `CMUI-144d` Add Vue Table and DataTable adapters and controlled-state verification. - - [x] `CMUI-144e` Add Annabel Razor Table and DataTable adapters and runtime integration. - - [x] `CMUI-144f` Verify data-table DOM, accessibility, interaction, visual, and documentation parity. -- [x] `CMUI-145` Migrate layout primitives. - - [x] `CMUI-145a` Define Container, Stack, Inline, Section, and Grid contracts and canonical fixtures. - - [x] `CMUI-145b` Add shared CSS for the layout primitives. - - [x] `CMUI-145c` Add Vue layout primitive adapters and SSR verification. - - [x] `CMUI-145d` Add Annabel Razor layout primitive adapters and trusted composition. - - [x] `CMUI-145e` Verify layout primitive DOM, accessibility, visual, and documentation parity. -- [x] `CMUI-146` Review application shells for platform-independent ownership. -- [x] `CMUI-147` Decide and implement CodeBlock ownership. -- [x] `CMUI-148` Decide and implement Playground ownership. - -### M6 exit gate - -- [x] `CMUI-G006` Utilities and the approved stable component cohort pass the Vue and Razor gates. - -## Phase 14 — VueForge migration and release - -- [x] `CMUI-149` Freeze the final VueForge feature baseline. -- [x] `CMUI-150` Publish the VueForge-to-CodeMonster UI package mapping. -- [x] `CMUI-151` Add a read-only migration checker. -- [x] `CMUI-152` Add deterministic codemods for approved renames. -- [x] `CMUI-153` Migrate the repository examples to CodeMonster UI. -- [x] `CMUI-154` Migrate the documentation site to CodeMonster UI. -- [x] `CMUI-155` Run complete npm packed-consumer verification. -- [x] `CMUI-156` Run complete Composer packed-consumer verification. -- [x] `CMUI-157` Run Vue/Razor accessibility and visual verification. -- [x] `CMUI-158` Publish CodeMonster UI prereleases. - - [x] Publish the five active npm prereleases with the `next` tag and trusted publishing. - - [x] Publish `codemonster-ru/ui@1.0.0-rc.1` from a Composer package repository. -- [x] `CMUI-159` Validate real Vue admin and Razor CMS template consumers with local prerelease archives. - - [x] `CMUI-159a` Repeat real-consumer validation against registry prereleases after publication resumes. - - [x] Repeat the Annabel CMS npm installation, production builds, tests, analysis, and audits against exact registry prereleases. - - [x] Repeat the Composer installation against the Packagist prerelease. -- [x] `CMUI-160` Resolve local prerelease contract feedback. -- [x] `CMUI-161` Publish CodeMonster UI 1.0 migration notes. - - [x] `CMUI-161a` Prepare and verify the migration notes locally. -- [x] `CMUI-162` Publish CodeMonster UI 1.0. -- [x] `CMUI-163` Move VueForge packages to the approved maintenance state. -- [x] `CMUI-164` Rename the repository only after migration gates pass. - -### M7 exit gate - -- [x] `CMUI-G007` CodeMonster UI 1.0 is published and validated by real consumers. - -## Phase 15 — Concise repository and Razor package names - -- [x] `CMUI-165` Approve `codemonster-ru/ui` for the monorepo and `ui-razor` for the Razor distribution. -- [x] `CMUI-166` Move the Composer split repository to `codemonster-ru/ui-razor`. -- [x] `CMUI-167` Publish `codemonster-ru/ui-razor` and mark `codemonster-ru/ui` replaced. -- [x] `CMUI-168` Migrate Annabel to the Razor-specific Composer package. -- [x] `CMUI-169` Move the monorepo to `codemonster-ru/ui` and update trusted publishers. - -### M8 exit gate - -- [x] `CMUI-G008` Canonical repository, registry metadata, and real consumers use the concise names. - -## Decision log - -Add decisions chronologically. Do not rewrite old entries; supersede them with a new entry. - -| Date | Decision | Reason | Affected items | -| ---------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | -| 2026-08-11 | Track the migration in this repository with stable checklist identifiers. | Preserve context and make progress reviewable across sessions. | All | -| 2026-08-11 | Name the product CodeMonster UI and target repository `codemonster-ui`. | Establish a platform-neutral identity under the existing CodeMonster organization. | `CMUI-001`, `CMUI-164` | -| 2026-08-11 | Use `ui-*` distribution names and the `cm` technical prefix. | Keep platform ownership explicit while unifying CSS, HTML, and component naming. | `CMUI-002` | -| 2026-08-11 | Start from Vue 3.5, React 19.2, Angular 22, Annabel Razor 2, and PHP 8.2. | Target maintained platform lines while retaining an adoption path for current Annabel applications. | `CMUI-003` | -| 2026-08-11 | Separate focused shared packages from thin platform adapters without a generic core package. | Preserve framework independence and keep public ownership explicit. | `CMUI-004` | -| 2026-08-11 | Describe components with normative prose, JSON manifests, render cases, canonical HTML, and behavior scenarios. | Provide enforceable parity without introducing a cross-platform source generator. | `CMUI-005` | -| 2026-08-11 | Compare significant semantic DOM instead of byte-identical framework output. | Enforce one HTML contract while ignoring serialization and compiler details. | `CMUI-006` | -| 2026-08-11 | Share semantic component APIs while mapping binding and events to native platform conventions. | Preserve recognizable parity without fighting each framework's programming model. | `CMUI-007` | -| 2026-08-11 | Prefer native and ARIA state, reserve `data-cm-state` for shared non-native state, and use modifiers for visual configuration. | Avoid duplicate state hooks and keep browser semantics authoritative. | `CMUI-008` | -| 2026-08-11 | Target WCAG 2.2 AA with native HTML first and shared keyboard, focus, and accessibility scenarios. | Make accessibility part of every component contract and adapter parity gate. | `CMUI-009` | -| 2026-08-11 | Separate CSS-only, server-rendered, progressively enhanced, and framework-hydrated modes. | Keep Razor framework-independent while preserving native framework hydration. | `CMUI-010` | -| 2026-08-11 | Escape ordinary values contextually and compose rendered components and slots only through a trusted-markup type. | Preserve Razor composition without turning strings or raw interpolation into an XSS boundary. | `CMUI-011`, `ARAZOR-002`, `ARAZOR-012` | -| 2026-08-11 | Target maintained evergreen browsers and ship standards-based CSS without a legacy build. | Give CSS-only and framework consumers one modern, testable browser contract. | `CMUI-012` | -| 2026-08-11 | Keep shared packages and adapters in one monorepo with independent SemVer and topological releases. | Coordinate contracts across npm and Composer without publishing unchanged packages. | `CMUI-013` | -| 2026-08-11 | Launch a clean CodeMonster UI package line and retain VueForge through verified consumer migration. | Avoid misleading in-place renames and permanent compatibility layers. | `CMUI-014`, `CMUI-149`–`CMUI-164` | -| 2026-08-11 | Prove the architecture with Button, Card, Input, and Accordion before expanding platforms or components. | Cover props, composition, forms, and interaction with the smallest representative set. | `CMUI-015`, M2–M4 | -| 2026-08-11 | Complete M0 and begin repository and contract infrastructure work. | All product and architecture decisions passed their documented phase gate. | `CMUI-G000`, M0 | -| 2026-08-12 | Leave React and Angular adapters unscheduled until a concrete product need appears. | Keep implementation focused on Vue and Annabel Razor without committing future releases to adapters that have no current consumers. | M5, `CMUI-113`–`CMUI-128`, `CMUI-G005` | -| 2026-08-13 | Keep application shells out of the stable cross-platform component catalog. | Shell landmark, navigation, responsive state, and workflow policies remain application-specific; portable layout is covered by the approved primitives. | `CMUI-146`, `CMUI-151` | -| 2026-08-13 | Retain CodeBlock as a separately maintained VueForge composed product. | Highlighting, trusted generated markup, Vue SSR, theme observation, and clipboard behavior do not yet have a real shared Vue/Razor contract. | `CMUI-147`, `CMUI-151`, `CMUI-154` | -| 2026-08-13 | Retain Playground core, Vue UI, and Vite integration as a separate VueForge product family. | Source compilation, executable iframe policy, workers, and virtual modules are product infrastructure rather than design-system component responsibilities. | `CMUI-148`, `CMUI-151`, `CMUI-153` | -| 2026-08-13 | Pause all registry and public-release actions while continuing local Vue and Annabel Razor work. | Complete implementation and real-consumer validation without requiring npm/Composer credentials or creating public artifacts before they are needed. | `CMUI-158`, `CMUI-159a`, `CMUI-161`–`CMUI-164`, `CMUI-G007` | -| 2026-08-13 | Resume registry and public-release actions after completing local verification. | Proceed with the approved prerelease, registry-consumer, and stable-release sequence now that both integration branches pass their local release gates. | `CMUI-158`, `CMUI-159a`, `CMUI-161`–`CMUI-164`, `CMUI-G007` | -| 2026-08-14 | Move VueForge design-system foundations to maintenance without blanket deprecation or unpublishing. | Direct new shared UI work to CodeMonster UI while retaining unsupported and separately maintained VueForge product families. | `CMUI-163` | -| 2026-08-14 | Rename the repository to `codemonster-ru/codemonster-ui` after all migration and release gates passed. | Complete the platform-neutral identity while preserving Git history, redirects, releases, package identities, and trusted publishing. | `CMUI-164`, M7 | -| 2026-08-14 | Use `codemonster-ru/ui` for the monorepo and `ui-razor` for the Razor split and Composer package. | Avoid repeating the organization name and make the platform-specific Composer boundary explicit. | `CMUI-165`–`CMUI-169`, M8 | - -## Cross-repository log - -Record Annabel work here when it completes a cross-repository roadmap item. - -| Item | Annabel commit | CodeMonster UI tracking commit | Notes | -| ------------ | -------------- | ------------------------------ | ----------------------------------- | -| `ARAZOR-001` | `720f2b8` | This row | Component syntax and semantics ADR. | -| `ARAZOR-002` | `ce6fe86` | This row | Trusted rendered-HTML value object. | -| `ARAZOR-003` | `9eaa7e0` | This row | Component and resolver contracts. | -| `ARAZOR-004` | `7f63002` | This row | Component registry and providers. | -| `ARAZOR-005` | `68e2287` | This row | Self-closing component parser. | -| `ARAZOR-006` | `06d7459` | This row | Paired and nested tag parsing. | -| `ARAZOR-007` | `9c800a2` | This row | Static, expression, boolean props. | -| `ARAZOR-008` | `2b70ebe` | This row | Lazy default-slot compilation. | -| `ARAZOR-009` | `ce32bc8` | This row | Direct named-slot compilation. | -| `ARAZOR-010` | `cebf892` | This row | Recursive nested compilation. | -| `ARAZOR-011` | `1ec5b97` | This row | Resolver-backed component runtime. | -| `ARAZOR-012` | `ff7711e` | This row | Trusted composition boundary. | -| `ARAZOR-013` | `0bea332` | This row | Component compiler diagnostics. | -| `ARAZOR-014` | `d5cf5cf` | This row | Registration cache invalidation. | -| `ARAZOR-015` | `e617b7d` | This row | Registration and security guide. | -| `ARAZOR-016` | `e36724a` | This row | Razor 2.1 component API release. | -| `CMUI-159a` | `a1ce832` | This row | Registry npm consumer validation. | -| `CMUI-159a` | `2b01e3f` | This row | Packagist consumer validation. | -| `CMUI-162` | `2216f5a` | This row | Stable registry validation. | -| `CMUI-168` | `b23a367` | This row | Razor-specific package migration. | - -## Scope-change log - -Record additions, removals, splits, and reordered dependencies before editing the numbered checklist. - -| Date | Change | Reason | Decision reference | -| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | -------------------------- | -| 2026-08-12 | Removed React and Angular from the active delivery sequence and all release gates; retained their existing items as unscheduled future considerations. | Focus implementation on Vue and Annabel Razor while preserving stable roadmap identifiers in case a concrete need appears. | 2026-08-12 scope decision | -| 2026-08-14 | Added a final naming-cleanup phase for the monorepo, Composer split, and Razor package. | Remove the redundant repository slug and expose the Razor platform boundary in Composer. | 2026-08-14 naming decision | diff --git a/docs/migrate-from-vueforge.md b/docs/migrate-from-vueforge.md index ef1392df..ff442eee 100644 --- a/docs/migrate-from-vueforge.md +++ b/docs/migrate-from-vueforge.md @@ -87,6 +87,14 @@ the same shared styles as the current subpaths. Package roots, stylesheets, foun and unknown paths continue through the usual resolver. Use the current specifiers for Node imports outside Vite and for TypeScript to resolve the current declarations directly. +## Compatibility limits + +Keep the archived packages for applications using their package-level registrations or raw theme +preset engine. The current MenuBar uses in-flow compact menus. Validate any workflows that relied +on historical horizontal overflow controls. Native Dialog and Drawer release focus and modality +during dismissal, and DatePicker uses native time selects. Refer to the component contract traces +when adapting custom focus, motion or layout behavior. + ## Vue components and composables Use the `Cm*` components for new templates. Some restored names, including `VfButton`, `VfField`, and diff --git a/docs/release-checklist.md b/docs/release-checklist.md index d836cf51..1bdb1ce1 100644 --- a/docs/release-checklist.md +++ b/docs/release-checklist.md @@ -3,18 +3,6 @@ Run this checklist for CodeMonster UI npm releases from the repository root, on the exact commit that will receive the package tags. VueForge releases belong to the archived project. -## Internal CodeMonster UI 2.0 candidate - -Use the [draft 2.0 changelog](./codemonster-ui-2.0-release-notes.md) for the seven-package -`2.0.0-rc.2` cohort. For an internal handoff, complete sections 1–5 and retain the seven `.tgz` -files with SHA-256 digests and the product commit SHA. Run the Vanilla production build and the -showcase browser regressions against both built sites. Attach results by browser engine, adapter, -theme, and viewport. Record native Safari, VoiceOver and NVDA separately from automated checks. - -Keep sections 6–9 pending for an authorized publication. Before publication, record the hosted CI -result for the exact product commit, including its stored visual comparison. Record any pending -manual checks or residual defects in the candidate's risk register. - ## 1. Choose the release channel - Stable versions publish to npm tag `latest`. @@ -33,86 +21,37 @@ The tag preparation script derives `next` whenever the version contains a prerel - Confirm the packages in scope use the target release versions and all other package versions remain unchanged. - Confirm every package in scope has a non-empty matching section in its `CHANGELOG.md` file. -- Confirm the root `overrides` entry still resolves `js-beautify` to `2.0.3`, replacing the - vulnerable `1.x` formatter dependency that `@vue/test-utils` declares. - Review the [2.0 draft changelog](./codemonster-ui-2.0-release-notes.md). - Confirm npm Trusted Publishing is configured for `.github/workflows/release-from-tag.yml`. -- Confirm the workflow has only `contents: write` and `id-token: write` permissions. - -## 3. Run the complete verification sequence - -Run every requested command even where `verify` repeats an earlier or later gate: - -```bash -npm test -npm run audit:release -npm run verify -npm run typecheck -npm run lint:all -npm run build -npm run check:packed-consumers -npm run build:demo -npm run build:vanilla -npm run prepublish:all -``` - -All commands must pass on the release commit. Also confirm: - -- Metadata, export and consumer contracts pass for all seven active packages. -- The production dependency graph has no known vulnerabilities, and no high/critical development - advisory remains accepted. -- `npm ls --all` reports a valid dependency graph after the clean lockfile installation. -- ESM, CommonJS, Node ESM, SSR, and declaration-resolution smokes pass. -- Tree-shaking and deferred-runtime budgets pass. -- `git diff --check` reports no whitespace errors. -- `git status --short` contains only reviewed release changes before the release commit, and is empty - after that commit. - -## 4. Inspect tarballs - -`npm run prepublish:all` builds and runs dry-run packs for every npm package. For a CodeMonster UI -only train, `npm run prepublish:ui` provides the focused build and dry run. Dry runs print proposed -archive contents but do not create `.tgz` files. Review those file lists and inspect each target -explicitly when release metadata changes: - -```bash -npm pack --workspace @codemonster-ru/ui-tokens --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-icons --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-runtime --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-css --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-utilities --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-vue --dry-run --ignore-scripts -npm pack --workspace @codemonster-ru/ui-layouts --dry-run --ignore-scripts -``` - -For every proposed archive and generated consumer tarball, verify: +- Confirm only the publish job has `contents: write` and `id-token: write` permissions. -- every declared `exports` target exists, including JavaScript, declarations, and CSS; -- no source-only tests, examples, caches, or unrelated monorepo files are present; -- declaration files do not resolve through workspace-only aliases; -- package metadata, license, repository directory, engine, and peer ranges are correct; -- browser auto-CSS files and CSS-free Node artifacts are both present where declared. +## 3. Verify the release commit -## 5. Repeat clean consumer verification +The tag workflow installs from the lockfile and runs `npm run verify` on the exact release +commit. This command checks the dependency graph and advisories, builds all seven packages, +runs source, integration, SSR and accessibility tests, and checks types, lint, documentation, +exports, package contents, size and tree shaking. It also installs real tarballs into isolated +npm, pnpm and Yarn consumers for browser builds, ESM and CommonJS SSR, TypeScript resolution +and CSS imports. Use `npm ci` followed by `npm run verify` to reproduce the package checks locally. -`npm run check:packed-consumers`, run explicitly in section 3, creates real tarballs in isolated -temporary directories and installs only those archives into fresh npm, pnpm, and Yarn consumers. It -must pass without workspace links or source aliases. +## 4. Check browser behavior and accessibility -Required scenarios: +The tag workflow runs the full behavior and stored visual checks with pinned Chrome on macOS +in parallel with package verification. Publication requires both jobs to pass on the tagged commit. -- npm, pnpm, and Yarn installation with Vue 3.5; -- Vite browser build and TypeScript `NodeNext`/bundler resolution; -- Node ESM and CommonJS SSR without `document` shims; -- full CSS and component-subpath auto CSS; -- all explicit shared CSS exports and representative browser auto-CSS entries; -- one-component packed tree shaking with required CSS retained and unrelated CSS removed. +Before tagging, check representative cases in Firefox, WebKit, native Safari and mobile browsers +where applicable. Check keyboard navigation, focus and announcements with native VoiceOver and +NVDA. Record results and unresolved risks for the exact commit in the release issue. Include +narrow or enlarged-text DatePicker layout, edge placement of overlays, and showcase landmark, +scroll-region and contrast findings where still applicable. See the +[accessibility requirements](./architecture/accessibility-requirements.md) and the +[RC.2 manual scenarios](./verification/codemonster-ui-2.0-rc.2.md#manual-assistive-technology-acceptance). -The separate `npm run check:consumer-tree-shaking` gate covers one-component, multi-component, and -full-namespace imports for Vue and Layouts against the built workspace packages. +## 5. Check the release package set -Repeat these consumers from the registry after publication to catch registry-only dependency or -tarball failures. +Confirm the intended package versions and their published dependency ranges. For an internal +2.0 handoff, use the [draft changelog](./codemonster-ui-2.0-release-notes.md) and retain the +candidate tarballs with SHA-256 digests and the source commit SHA. ## 6. Publish in topological order @@ -127,7 +66,9 @@ Historical aggregate `ui/vX.Y.Z` tags do not trigger the publication workflow. The workflow treats the packed archive as immutable: after verification builds the package, it packs the target once with lifecycle scripts disabled, dry-runs publication of that exact `.tgz`, and then publishes the same file. No workspace or package-directory publish may replace the final tarball -publish, and no rebuild may occur between packing, inspection, and publication. +publish, and no rebuild may occur between packing, inspection, and publication. The publish job +compares the verified SHA from both checks with the tag and validates SHA-256 on the downloaded +archive before using it. For each package: diff --git a/docs/verification/DESIGN-EXCELLENCE.md b/docs/verification/DESIGN-EXCELLENCE.md deleted file mode 100644 index 3ce0d819..00000000 --- a/docs/verification/DESIGN-EXCELLENCE.md +++ /dev/null @@ -1,85 +0,0 @@ -# Design excellence: showcase and documentation - -The starting revision is `63a6fb2d`. Its [product quality record](product-quality.md) and -[historical restoration acceptance](historical-restoration.md) describe the existing package -and visual contracts. This increment changes the private Vue and standalone Vanilla showcases -and developer guides. The published runtime, adapters, shared CSS, and tokens remain the -reference for the examples. - -## Findings and implementation register - -| Priority | Category | Before | Change and evidence | -| -------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| P1 | Showcase usability | On mobile, Vue's scrollable top navigation clipped route links. Core opened on theme controls without a route to find a specific component. | Align the two headers and wrap the route links; add a Core entry point and section shortcuts. Verify visible, keyboard reachable links and direct URLs. | -| P1 | Documentation usability | The component inventory, guides, and working examples were spread across grouped showcases and repository files. | Add searchable component URLs with contract previews, API and usage links, plus a developer index organized by component. | -| P1 | Documentation accuracy | A new user had to assemble the Vanilla quick start from separate markup and runtime examples. Installation and packed use had different prerequisites. | Provide executable quick starts, direct guides, and explicit built archive, TypeScript, SSR, and enhancement lifecycle instructions. Validate examples against the current exports. | -| P2 | Accessibility | A keyboard user had to pass the top navigation each time. Typography specimens competed with page headings. | Add a skip link to the main landmark, add page titles, and keep demonstration glyphs out of the document outline. Check keyboard focus and target sizes. | -| P2 | Visual consistency | The headers used different mobile navigation behaviors and their content did not align with the demos on a wide screen. | Use one responsive, token-based shell and page metadata. Use explicit current-page and theme-control states and reflow on smaller screens. | -| P2 | Showcase usability | Individual examples illustrated API coverage but did not show how an application could combine them. | Add a release workspace on both adapters with tabs, a dashboard, a searchable filtered table, a release form, settings, and sample sign-in. | -| P3 | Optional aesthetics | Changing global typography, geometry, colors, or motion would affect the accepted rendering across unrelated applications. | Keep those tokens and published styles stable. Revisit only with a demonstrated component defect or a separately reviewed design proposal. | - -No critical usability defect was reproduced in the route baseline. The initial Chrome audit -covered 60 views across both adapters, both themes, and 360, 768, and 1,440 CSS pixels. None had -document-wide horizontal overflow or script errors. Vue's top navigation clipped links in all -12 mobile views. Inspection also covered the existing component contracts and their state -matrices. The paired fixture checks below exercise shared rendering separately from page layout. - -The navigation uses short labels, a visible current page, and labeled landmarks in line with -[USWDS header guidance](https://designsystem.digital.gov/components/header/). The keyboard review -checks the skip link, focus after following it, and reflow against the relevant -[W3C focus and target size criteria](https://www.w3.org/WAI/standards-guidelines/wcag/new-in-22/). -These checks are limited to the tested interactions. - -## Delivered - -- **Showcase:** Core introduces the library and links to the visual matrices, Reference, and - Examples. The shared header wraps on phones, indicates the current route, and controls color - mode. Core still offers system mode. Colors, Layouts, Icons, and the Vue-specific CodeBlock - and Playground routes remain available. -- **Reference:** Each showcase has 62 component detail routes and two entries for compositions. - The component pages use the existing fixtures for previews and variants. They show copyable - Vue and Vanilla examples, contract API details, and direct guide links. Theme Provider and - Confirm Dialog link to their integration recipes and existing examples. -- **Application examples:** The release workspace composes tabs, buttons, filters, a compact table, - form controls and validation, status feedback, workspace settings, and sample sign-in. The demo - state is local to the page. There is no account or network integration. -- **Developer documentation:** [Start here](../getting-started.md), then use the - [component index](../components/index.md), [integration guide](../integration.md), and - [design tokens guide](../tokens/getting-started.md). The guides distinguish the stable release - from the local 2.0 package cohort and cover TypeScript, SSR, forms, overlays, and Vue and Vanilla - lifecycle ownership. -- **Consistency:** Both showcases use the same shell styles and page names. The Core matrices - use clearer headings, a labeled Avatar, and progress feedback outside a fill that can be too - narrow for text. The Vanilla Core Card uses the shared Button styling for its action. The - typography overflow specimen can receive keyboard focus. None of these corrections change the - published components or the historical fixture inputs. - -## Verification - -| Gate | Evidence | -| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Render and reflow | Chrome 157 rendered 108 production views across both themes and 360, 768, and 1,440 CSS pixels. No clipped header links, document-wide overflow, unnamed frames, or console errors were observed. The [v1 snapshot set](../../visual-baselines/showcase-excellence-v1/README.md) is a separate, versioned baseline. | -| Component reference | All 128 detail URLs loaded. Search and empty results, trusted keyboard Copy, DatePicker calendar and time controls, and Escape/focus restoration for Dialog passed on both adapters. An independent check compiled and SSR-rendered all 62 primary Vue snippets and initialized all 62 Vanilla snippets against public entries. | -| Application examples | 64 Chrome layout and axe checks covered all four workspace views at 320, 360, 768, and 1,280 pixels in both themes and adapters. The full filter, validation, release creation, preferences, and sample sign-in flows passed at mobile and desktop widths. All four tabs stayed visible and at least 44 pixels high at the tested widths. | -| Accessibility | 32 top-level axe scans at 320 and 1,440 pixels found no violations on the checked new pages. The baseline comparison confirmed that remaining Core findings predate this work. Trusted keyboard checks covered skip-link focus, section jumps, direct hash links and persisted theme. The contract suite also passed all 181 canonical accessibility cases. | -| Historical visuals and behavior | 362 Vue/Vanilla pixel pairs matched and all 144 behavioral runs passed with equal motion signatures. All 96 canonical captures matched the equivalent local accepted captures at threshold zero. The strict stored comparison still reports the [known local glyph residual](stored-visual-renderer.md) in 44 of 48 frames per adapter. The approved snapshots and thresholds are unchanged. | -| Engineering and distribution | Full lint in a clean source copy, cold workspace tests, types, formatting, documentation checks (including 73 compiled example fixtures), package contracts, production builds, clean install, and all seven package dry runs passed. Packed consumer checks passed with npm, pnpm, and Yarn. All seven package budgets passed; runtime was 79.98/80 KiB, and the tree-shaking gates stayed within 59.98/60 KiB for the Vue namespace and 80.58/81 KiB for its historical namespace. These sizes use the official Node 24.19.0 build. | -| Independent review | A second agent reviewed mobile and desktop before/after images and the reference and shell code, checked guide targets, and tested the snippets. Follow-up review verified the repaired mobile tab layout and the complete DatePicker preview. | - -## Remaining work and acceptance - -The showcase and documentation increment is locally verified within the scope above. The -broader product release remains pending. Hosted CI was not run on this candidate; there was no -push or publication. The production dependency audit found zero advisories, and the development -dependency audit reported low and moderate advisories below the repository's high-severity gate. - -Some existing Core matrices still expose duplicate landmark names, scrollable table regions -without focus targets, and compact clear/password controls below the automated target-size -threshold. Those issues need focused changes against the accepted component contract and should -be tracked separately. Automated checks do not establish screen reader behavior or full WCAG -conformance. Non-Chromium and manual assistive-technology testing are still outstanding. - -No package migration is needed. Vue production hosting must continue to rewrite showcase routes -to the application entry; Vanilla detail pages are directory indexes. GitHub guide links track the -project's `main` branch and will show repository documentation added here after the revision is -published. diff --git a/docs/verification/SHOWCASE-UX-REFINEMENT.md b/docs/verification/SHOWCASE-UX-REFINEMENT.md deleted file mode 100644 index 84ae34b0..00000000 --- a/docs/verification/SHOWCASE-UX-REFINEMENT.md +++ /dev/null @@ -1,64 +0,0 @@ -# Showcase and documentation UX refinement - -Start: `ebbb0b9d` on `main`. The supplied visual review and ZIP were already untracked and -remain in place. The ZIP integrity check passed. Product references `e4ff3dea` and `1733d1f8` -and the historical Vue reference `d9879116` were inspected. This change is scoped to the private -showcases and their guides; published package source, exports, tokens, CSS, contract fixtures, -and approved visual baselines are unchanged. - -| Priority | Work | Result | -| -------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| P1 | Inspect the visual review and live production builds | Confirmed multirow mobile navigation (133 CSS pixels at 360), catalog names without descriptions, an unintegrated documentation experience, and Core calendar, tooltip, and form layout defects. | -| P1 | Shared navigation and discovery | Four primary links, grouped resources, a one-row mobile header, visible active sections, an accessible disclosure, and one keyboard-operable search for components, guide headings, and showcase pages. | -| P1 | Catalog and references | Category and purpose filtering, descriptive cards, breadcrumbs, an in-page outline, real previews, Vue and Vanilla snippet tabs with Copy, readable contract entries, and links to accessibility guidance and related components. | -| P1 | Integrated guides | Compile 67 authoritative Markdown sources at build time, with raw HTML disabled and internal links rewritten. Vue loads the selected guide; Vanilla serves full HTML. Both builds emit directory indexes and one search index. | -| P1 | Narrow layout | Keep calendar popups above adjacent controls, let edge tooltips use the existing portal option, and contain Core form controls, typography, and readable reference previews. | -| P2 | Release Workspace | Move status to a dedicated summary, align filters with deployment results, and give release creation a clear entry point. The same four views and local interactions remain available. | -| P1 | Review, verification, and evidence | See the checks below and the [versioned before/after captures](../../visual-baselines/showcase-excellence-v2/README.md). | - -The server only needs directory index support for known routes. Vanilla can also be hosted -under a subdirectory. The Markdown parser is a build dependency; the code blocks show language -and filename and copy the unmodified source. No client parser, syntax grammar, data service, or -second website is needed. Package consumers need no migration. - -## Verification - -- **Production and routes:** built the component packages and both production showcases. A static - server with no SPA fallback returned HTTP 200 for 139 Vue and 137 Vanilla routes, including - Vanilla under `/kit/`. All 128 component detail URLs loaded in Chrome. Checked 1,287 links and - fragments between the 67 guides and compiled 73 existing documentation examples. -- **Integrated browser matrix:** 128 route, viewport and theme combinations across Vue and - Vanilla at 360, 390, 768 and 1440 CSS pixels with reduced motion. 24 axe scans of the catalog, - component detail, guides, workspace and search found no violations. Checked the skip link, - keyboard and touch operation of navigation, active states, search ranking and empty state, - Escape from a filled search field and focus restoration, direct fragments, reload, and - back/forward. Rechecked seven representative routes per adapter at 360 pixels and 200% text. -- **Focused browser checks:** filtered the catalogs by name, purpose, and category; switched - snippet tabs with the keyboard and compared pasted source. Checked 50 Core calendar openings, - 28 narrow overlay interactions and focus restorations, 16 form-card layouts, and 64 workspace - axe scans with four complete workspace flows. All 124 primary fixture frames fit the narrow - viewport horizontally. Nav Menu has room for its full menu, and the five tested viewport-height - Vanilla layouts keep a stable height. Eight other Vue previews scroll vertically by 4–23 px on - narrow screens; keyboard scrolling can reach the content. The guide review covered 80 real page renders - and checked larger text on a dense guide. An independent reviewer checked screenshots, route - semantics, search ordering and keyboard behavior; the findings were addressed before handoff. -- **Engineering:** all 678 workspace tests passed. Type checking, docs and package contracts, - all 181 canonical accessibility cases, seven bundle budgets, consumer tree shaking, and - packed consumer checks with npm, pnpm and Yarn passed. All 62 Vue primary snippets compiled - and rendered through SSR, and all 62 Vanilla snippets initialized with public package imports. - Workspace, style, HTML, tracked data and scoped Markdown lint passed. Unscoped Markdown lint - found one MD041 in the untracked review notes; unscoped data lint flagged generated review JSON - and an ignored local settings file. Those inputs were left unchanged. -- **Canonical visuals:** 96 captures with the pinned Chrome for Testing matched the prior local - accepted-revision captures byte for byte. The comparison with the hosted stored PNGs still - shows the [known local glyph drift](stored-visual-renderer.md) in 44 of 48 frames per adapter. - All 362 paired adapter comparisons had zero differing pixels, and all 144 behavioral runs - passed with matching motion signatures. Baselines and thresholds were not changed. - -## Acceptance boundaries - -Local Chrome and automated accessibility checks cover the cases listed above. No manual screen -reader, other browser engine, hosted CI, push, or publication was performed. The established Core -matrix has pre-existing accessibility findings outside the refined pages; this change does not -claim full WCAG conformance. The unrelated input gallery remains the only pre-existing untracked -material in the checkout. diff --git a/docs/verification/historical-restoration.md b/docs/verification/historical-restoration.md deleted file mode 100644 index 398f52bb..00000000 --- a/docs/verification/historical-restoration.md +++ /dev/null @@ -1,482 +0,0 @@ -# Historical restoration queue - -The acceptance reference is `d987911604a770aec4fff5311b2e43c46ae40afe`. Work started on clean -`main` at `49574d25057270f158cb43f567a15e2a7ebe813d`, one local commit ahead of the remote tracking -branch. Preserve that commit and all existing work. Do not publish or push as part of this queue. - -The current release line distributes tokens, CSS, utilities, icon data, runtime, Vue components, -and Vue layouts. Keep those package identities. CSS and tokens are shared; the Vue adapter owns -its rendering and reactivity; the Vanilla runtime enhances canonical HTML. Either platform can -use pure rules from `ui-runtime/core`. Existing names and paths from VueForge must be traced to -the current API or to the original published package. Record any difference that still needs a -migration, including behavioral or visual differences. Do not claim parity from matching names. - -| Status | Work and acceptance evidence | -| --- | --- | -| DONE | Repository preflight: clean tree, both commits present, npm workspaces and eight CI jobs inspected. | -| DONE | [Vue core contract trace](historical-vue-core.md) reconciles all 46 historical component names across the root and opt-in entries. The [migration guide](../migrate-from-vueforge.md) maps the published packages and documents import, CSS and theme changes. | -| DONE | [Layout and icon trace](historical-vue-ecosystem.md) records shell, icon and static layout restoration (`172297ec`, `f6781197`), theme provider and responsive composables. | -| DONE | Restored the Playground section through the historical published releases (`vueforge-playground@3.0.1`, runtime `2.1.0`, Vite plugin `1.0.0`). The private showcase builds against real package entry points. Chrome verified both script-sandboxed frames, the direct Vue preview, both Vite modules, source tabs, console output, theme and mobile width. | -| DONE | Added a [standalone Vanilla Playground](../recipes/playground.md) for editing and running HTML, CSS and JavaScript (`4a4473d1`). Chrome tested no-script fallback, keyboard Run and Reset, iframe origin separation, and the documented limits on resource requests and top navigation at 390 and 1280 px. | -| DONE | Restored the CodeBlock section with the published `vueforge-codeblock@4.0.1` package and all 20 historical examples. Vue showcase lint, typecheck, and production build passed. Chrome verified the direct route at 390 px, highlighting, 1,000 line numbers, copy, dark theme, and loading replay. | -| DONE | [Vanilla contract trace](historical-vanilla.md) records canonical markup, CSS, controller coverage and framework-specific exceptions. Standalone packed CSS-only and CSS+JS consumers passed without resolving a rendering framework. | -| DONE | Added the Vanilla ColumnChooser enhancement and its contract trace. Runtime checks passed 209 tests. Chromium verified default light and dark visual parity with Vue and both chooser behavior scenarios. | -| DONE | Restored `VfDataTableColumnChooser` with its gear trigger, authored trigger scope, body portal, and ordered model updates (`679b43e5`). All 49 built package/canonical/behavior tests passed. Pinned Chrome passed six behavior runs and exact light/dark fixtures in both adapters; production Vue passed 390 and 1280 px keyboard, focus and table visibility checks. | -| DONE | Fixed Vanilla runtime observation of transient removals, cross-root moves and attribute changes. Runtime lint, typecheck, build and 206 tests passed on Node 24. | -| DONE | Fixed mixed-page ownership during SSR hydration in Vue and standalone Vanilla (`f647d6a6`), scoped nested HTML shell controls (`c8db7e48`), and returned focus when an open Vue modal unmounts (`4693aab3`). Pinned Chrome exercised hydration handoff, nested Escape and modal teardown. | -| DONE | Added a [standalone Vanilla CodeBlock recipe](../recipes/code-block.md) with semantic no-script output and optional copy feedback (`d26e3cb0`). Three enhancement tests and the Vanilla build passed. The Chrome check covered light/dark, 390/1280 px, keyboard scrolling and clipboard responses stubbed at the browser API boundary. | -| DONE | Vanilla table of contents (`7f5c3bbe`), GroupBox (`f6781197`), native Input clear/reset (`217155af`), and disabled selection form submission (`27ccb81b`) passed targeted interaction and form checks. | -| DONE | Built `d9879116` in isolation, compared both themes and viewports against the current showcases, and traced the visual differences. These full-view reports are separate from the strict stored fixture gate. | -| DONE | The shared showcase shell and native composition demos built and passed the Chrome interaction check. It exercised mobile navigation, keyboard theme toggling and persistence in both adapters, and Vue confirmation focus restoration, GroupBox and SkeletonGate. | -| DONE | Restored DatePicker keyboard, locale, multiple/range selection, native reset, month/year precision, and timezone-free minute selection in both adapters (`5b3f5403`, `454f9d0b`, `b86bd276`, `9fa2361a`, `e53dc22f`). Added calendar portals and placement (`6fd91b5f`). Chrome exercised selection, pagination, focus, clock bounds and value serialization. | -| DONE | Exposed `VfDatePicker` with the historical locale, Monday-first calendar and body portal defaults (`62df67a1`). Focused Vue, native-picker and built SSR/advanced input tests passed. The trace records differences in post-selection display, native time inputs and scoped Field IDs. | -| DONE | Restored top/bottom Drawer, native open/close synchronization, ProgressBar stripes and height, and Field floating labels (`f6bfddf7`, `55a5f7c2`, `0916b9cc`, `3c3057c9`). Chrome exercised both adapters, including backdrop modality, Escape, native dialog form close, reduced motion and label focus. | -| DONE | Restored NavMenu and MenuBar pills plus MenuBar roving focus (`823edcaa`). Their paired light/dark browser fixture screenshots matched exactly; both adapters passed the expanded keyboard and selection scenarios. | -| DONE | Restored Dropdown pills and scoped actions (`2a104970`), IconButton tones and name-based icons (`4d3850a1`), historical Input and Select (`79bd0800`, `4334b223`), and authored Tooltip triggers, delays and portals (`f26a5679`). Chrome checked canonical contracts, Select portal geometry, resize, and native dialog focus, and Tooltip focus and Escape in both adapters. | -| DONE | Anchored Dropdown, Select and DatePicker to viewport collision bounds while preserving their inline markup. Vue Dropdown also supports a portal. Chrome verified matched popup bounds at the lower-right edge in both adapters, native modal Escape, and exact light/dark Dropdown fixtures. | -| DONE | Restored CommandPalette host-ranked results, query submission, scoped content and historical result-object selection (`7cc28fec`). Pinned Chrome passed eight scenario runs across both adapters; a production mobile check exercised literal match highlighting, selecting a result with the keyboard, and restoring opener focus. Authored palette Teleport destination remains outside this implementation. | -| DONE | The icons catalogue is a neutral metadata entry (`be8ee84f`) and both showcases use it (`c4928bb1`). A fresh Vue consumer and the gallery browser check verified its metadata, all 116 icons, keyword search and unique SVG definitions. Loading Core does not fetch the icon catalogue. | -| DONE | Vanilla Layouts and both Icons galleries restored historical top-of-page geometry and order (`25825971`, `446f94f5`). See [layout and icon measurements](historical-vue-ecosystem.md) for viewport comparisons and browser interaction results. | -| DONE | Restored Colors page rhythm in the shared guide. Production Chrome matched hero, text, first palette and swatch geometry to `d9879116`; both adapters passed contrast calculation and code copy. | -| DONE | Restored historical named Alert and Avatar icons, default Alert tone and role, warning alias and icon visibility (`dde06d37`). The opt-in entry passed 11 pinned-browser assertions and the main consumer import guards. | -| DONE | Restored the lead Core theme and typography examples (`fa166db5`). Chrome observed all nine variants, Space activation, accessible state and persistence, and matched section geometry at both widths. | -| DONE | `VfThemeProvider` again reads the historical preference and publishes its resolved attribute (`7d9f093e`). In a built-package Chrome run, stored dark survived hydration, system mode followed media changes, and a modern provider used its own cookie. | -| DONE | Restored DataTable column resize (`ec5958dc`). Keyboard, pointer and autosize produced the same widths in both adapters, kept the table width fixed, and exposed the width on the accessible separator. Raw row keys, multi-sort, pinning and drag ordering remain separate. | -| DONE | Restored historical Badge, Tag and ProgressSpinner options (`9ba8ada4`), routed NavMenu bindings (`d232e084`), and Stepper bindings and placement (`8ff4cecf`). Targeted packaged and browser checks passed for each slice. | -| DONE | Restored Popover portal, placement, focus and close policies (`f784b486`), and authored Vue triggers in the historical Dropdown and Popover entry points. Pinned Chrome passed eight Popover behavior runs and eight paired fixture comparisons. The built example verified the body portal and focus restoration around one authored button. | -| DONE | Restored Dialog and Drawer initial state, naming and dismissal independently. Drawer adds fixed physical sides in RTL and LTR plus offset and padding. Both adapters passed all four native geometry/dismissal runs, six pinned behavior runs, and eight exact paired screenshots. | -| DONE | Restored Tabs custom IDs and scoped content (`1cb29a1f`), NavMenu named icons and compact mode (`62c48b06`), and DataTable column pinning (`06d2ca4a`). Chrome checked panel focus, compact accessible names, and sticky geometry after scrolling and resize at 390 px. | -| DONE | Vue DataTable accepts host records and stable string/path or numeric keys (`a9a9df93`); native events retain the current string ID contract. Built TypeScript consumers verified typed row scopes, and Chrome verified selection survives client sorting. `VfTable` restores `compact` with SSR-equivalent native markup (`d82fa231`). | -| DONE | Historical Switch, Checkbox and Radio expose the original model event payloads and slots (`08061eaf`, `28a555a9`). Chrome verified keyboard and native form behavior, checked and mixed accessibility state, and a Checkbox runtime-to-Vue hydration handoff. | -| DONE | Restored the historical single Accordion's model, scoped trigger/content, height and opacity motion, and focus return. Chrome measured the same 36 px trigger and 49 px open panel as the isolated reference at both 390 and 1280 px. Source and packaged SSR tests passed. | -| DONE | Restored labelled MenuBar groups and route leaves and the historical original-item event. Pinned Chrome passed six keyboard runs and six exact light/dark comparisons. The built Vue demo reached the real Layouts guide with Enter at both widths. The native import measures 5.38 KiB gzip without the named icon catalogue. | -| DONE | Restored historical DataTable typed keys and controlled selection, original cell and expansion scopes, and ordered sort models. Chrome verified the published Vue example at both widths: priority, tie order, one primary ARIA sort and reset to page one. The direct compatibility import measures 12.56 KiB gzip and carries no Vanilla controllers. | -| DONE | Vanilla DataTable expands authored detail rows (`0924c05a`), scopes events to the nearest table, and leaves sorting, selection and paging independent. Chrome exercised keyboard expansion and focus in both adapters. | -| DONE | Native modals now prevent background scrolling (`f0591f37`). Pinned Chrome verified classic and overlay scrollbars, internal scrolling, nested Escape and original page position in Vue, Vanilla, and a mixed pair. | -| DONE | Stepper markers and progress now use the shared package CSS. Chrome matched the historical 34 px markers, 2 px rail, progress and placement in the Vue showcase at both widths. Both adapters passed six exact fixture comparisons, four behavior runs and reduced-motion keyboard checks in LTR and RTL. | -| DONE | Aligned Vue Layouts with the shared guide (`f47727a5`): changed pixels against the pinned historical views fell from 11.96–18.05% to 1.09–3.20%. Controls and responsive previews passed at both widths and in both themes. | -| DONE | Restored the Vue showcase's narrow navigation controls without shifting content when the system draws scrollbars. Shortened the shared Colors introduction to restore its mobile text rhythm. Pinned Chrome passed overflow, active-route and keyboard checks at 390 and 1280 px. | -| DONE | Historical DataTable supports numbered pages and localized summaries (`f9a1961c`) and pointer/keyboard column reordering (`6febe9c3`). Chrome verified retained focus, pinned boundaries and both viewport widths. | -| DONE | Restored the public historical composables, including floating placement, scroll locking, focus trapping and reactive breakpoints. The opt-in theme plugin (`1efe29de`) supplies app-scoped theme defaults; raw legacy theme presets migrate to shared CSS tokens. | -| DONE | Tabs overflow controls and the moving selection indicator share measurement and CSS between adapters (`44629f01`, `a1d9c685`). Chrome checked selection, focus, LTR, RTL and reduced motion. | -| DONE | Dropdown and Popover share viewport placement and arrow styling (`15edc15c`). Chrome passed 16 cases for flipped and unflipped geometry, trigger alignment, LTR/RTL and restoration of authored inline values. | -| DONE | A running Vanilla runtime can hand off an enhanced SSR Tabs instance before Vue compares attributes (`11285758`). Chrome reproduced two attribute warnings before the fix and found zero afterward. The mixed overlay handoff also passed. | -| DONE | Restored the historical DataTable action labels (`79985f24`), including row selection and expansion, the next sort action and resize. Chrome verified the packaged component's accessible names before and after hydration and keyboard operation at 390 and 1280 px. | -| DONE | The cross-platform DataTable fixture now exercises detail visibility and expansion notifications in both adapters (`0a86edee`). | -| DONE | Default authored Tabs now get the same moving indicator after Vanilla enhancement (`d549c92a`). Four pinned pointer and keyboard runs had equal motion, and ten reduced-motion theme comparisons were pixel-identical. | -| DONE | Compact MenuBar items wrap and open in-flow branches without clipping (`34649ac4`). Chrome exercised pointer, keyboard, no-runtime links, and unchanged wide cascade geometry. Both 390 px Core pages fit after the change. | -| DONE | The exact package candidate passed 20 checks, including 964 cold tests, 181 axe cases, both production builds, and packed npm, pnpm and Yarn consumers. | -| DONE | Independent acceptance reviewed the Vue upgrade, standalone HTML consumption and future adapter boundary. The findings, fixes and remaining differences are recorded below. | -| UNVERIFIED | The required stored visual gate has not run on hosted `macos-26` for this candidate. Complete local PNGs match the starting revision's local run. | - -## Resume point - -Use the repository's Node 24 toolchain. `d9879116` and `fd793696` have the same complete Git tree -(`474626a33d7479a199ba1d5b8028af29a8c98064`); keep the existing fixture screenshots and their real -capture provenance. The exact `d9879116` archive passed offline dependency installation and -both package and showcase builds. The starting revision passed current package, Vue showcase and -Vanilla showcase builds. Compare the actual showcases in the browser separately from the fixture -gate; matching reference trees does not establish parity with the current checkout. - -The starting showcase comparison captured 48 top-of-page frames (historical Vue, current Vue, -Vanilla; Core, Colors, Layouts and Icons; light and dark; 390 and 1280 px). Chrome reported no -uncaught JavaScript exceptions or horizontal page overflow. Against the historical frames at a -channel threshold of 4, all 16 Vue frames differed (1.2–24.6% of pixels), as did all 16 Vanilla -frames (32.4–69.7%). Review section geometry, mobile header placement, and Vanilla presentation; -these figures do not qualify as visual acceptance. - -The revised capture used the same 16 frames per platform and the same threshold. Vue's mean -changed-pixel rate fell from 12.77% to 11.71% and Vanilla's from 46.75% to 42.15%. All frames still -differed. Vue Colors had a larger mean difference (9.78% to 11.50%) and remains a priority for -visual review. The revised comparison reported no uncaught JavaScript errors. -Local screenshots and reports are in `/private/tmp/cmui-acceptance.Uyf8RO` under `initial` and -`refined`. The reference is an isolated archive at `/private/tmp/cmui-d9879116.h4bqCs`. - -The `palettes` capture followed the shared Colors rewrite (`08865a87`). At the same threshold, the -mean changed-pixel rate across 16 frames was 12.52% for Vue and 31.63% for Vanilla. All frames -still differed from the historical capture. The current Colors pages matched each other in -mobile hero and palette geometry, group order and all 12 displayed contrast ratios. Code copying -worked on both pages. These checks do not establish exact historical visuals or general WCAG -conformance. - -The built `colors-built` capture matched the historical geometry of the hero, typography, and -first palette at both sizes and in both themes. Changed-pixel ratios were 3.62–3.72% at 390 px -and 0.89–0.95% at 1280 px across both adapters, down from 22.84–22.95% and 6.42–6.51%. -The product name, mobile top bar and related copy remain visible differences. See -`/private/tmp/cmui-acceptance.Uyf8RO/{colors-before,colors-built}`. - -The pinned browser with classic scrollbars exposed an 11 px height increase in Vue's narrow -navigation, and the longer Colors text wrapped to an extra line. The 48 captures before and -after those fixes used the same capture settings; neither run reported script errors or -horizontal page overflow. Across 16 comparisons per adapter at threshold 4, Vue's mean fell -from 13.20% to 1.91% (worst frame: 36.01% to 3.50%), and Vanilla's fell from 3.98% to 1.86% -(worst: 20.67% to 3.44%). All frames still have nonzero differences. Viewport evidence: -`/private/tmp/cmui-browser-checkpoint.7GfdFS/showcase` and -`/private/tmp/cmui-browser-checkpoint.Acuv2H/showcase`. The Vue navigation keyboard log is -`/private/tmp/cmui-shell-mobile-smoke.log`. - -## Verification checkpoints - -- In pinned Chrome for Testing `151.0.7922.138`, all 96 fixture screenshots were byte-identical - between the original `49574d25` and restored `4d3850a1` archives. Both local captures still - fail the stored-baseline check: 44 of 48 changed per adapter at threshold 4, or - 520 of 559,172 pixels per adapter (0.093%). Independent text-mask recapture placed every - above-threshold difference inside glyph paint, with unchanged screenshot dimensions. The - hosted `macos-26` result and exact render-stack cause remain unverified; baseline images - were left intact. Evidence: `/private/tmp/cmui-original-pinned.L9JYfo` and - `/private/tmp/cmui-ci-visual.1xCWmT`. The 122 browser behavior runs at `4d3850a1` passed. -- `90815175`, fresh copy at `/private/tmp/cmui-verify.MEtWOJ`: all 20 executed checks passed, - including lint, format, typecheck, cold tests, contracts, accessibility fixtures, tree - shaking, both production showcases, and packed npm, pnpm and Yarn consumers. The release - audit returned zero production findings and 20 low/moderate development findings. This - snapshot precedes the latest showcase and overlay slices. -- `97ad5a07`, fresh copy at `/private/tmp/cmui-verify.qMbtuH`: all of the 18 offline checks - except the cold suite passed, including 162 axe fixture cases. Cold testing found the Tooltip - portal arrow's physical CSS rules and a test that sent a synthetic non-bubbling focus event. - Both were corrected in `e3029077`. The isolated rerun with those two changes passed 810 tests; - four pinned-browser LTR/RTL arrow captures matched exactly. Logs: `/private/tmp/cmui-tooltip-cold.rVDaue`. -- `8ff4cecf`, fresh copy at `/private/tmp/cmui-verify.k73jZi`: lint, format, typecheck, documented - tests, 170 axe fixture cases, production builds, package installation with npm/pnpm/Yarn, and - the release audit passed. Cold parity lacked two NavMenu target mappings; the exact harness - fix is `f8990ccc`. The full runtime measured 72.64 KiB gzip after new overlay placement and - column resizing; aggregate budget now reflects the measured expansion. Retain all individual - import and pure-core limits. -- `62c48b06`, fresh copy at `/private/tmp/cmui-verify.b0ISig`: all 18 offline checks passed, - including the cold suite and both production builds. An independent Dialog-focused cold retry - also passed 839 tests; see `/private/tmp/cmui-dialog-policy.8m5f0G/cold-final.log`. -- `7d00e647`, fresh copy at `/private/tmp/cmui-verify.tU1ZdM`: 17 of 18 offline checks passed, - including the cold tests, both builds, type checks, package and accessibility gates. Lint found - two misaligned cells in the historical Vue trace; `28a555a9` fixed those cells and passed the - trace lint. Run a fresh archive after the active component slices. -- `905ed0ec`, fresh copy at `/private/tmp/cmui-verify.W516XM`: all 20 checks passed, including - cold tests, 176 canonical accessibility fixtures, production builds, packed npm/pnpm/Yarn - consumers and the release audit (zero production findings; 20 low or moderate development). - Pinned Chrome passed all 138 behavior runs and 352 paired theme comparisons without pixel or - motion differences between Vue and Vanilla. Its 48 production viewport frames had no script - errors or horizontal page overflow; the worst strict historical comparison was 3.46% in Vue - and 3.43% in Vanilla. A clean fixture recapture produced all 96 images byte-for-byte identical - to the starting revision's local capture; the stored-baseline comparison still counts 44 of - 48 changes per adapter. Evidence: `/private/tmp/cmui-browser-checkpoint.jmvofA` and - `/private/tmp/cmui-fixture-recapture.0urDel`. -- `1aef7bfd`, fresh copy at `/private/tmp/cmui-verify.BSTJH2`: all 20 checks passed, including - 936 cold tests, both production showcases, accessibility for 178 authored cases, dependency - audits, and fresh packed consumers with npm, pnpm and Yarn. A direct historical DataTable - import was 12.56 KiB gzip. This checkpoint precedes the Stepper and later slices. -- `15edc15c`, fresh copy at `/private/tmp/cmui-verify.Xq9PWo`: 19 of 20 checks passed. The cold - suite identified an obsolete assertion against decorative `pointer-events: none` on Tabs; - the focused correction is `7e2c5d42`. Packed consumers and the release audit passed. - Pinned Chrome recaptured all 96 stored fixtures byte-for-byte against the starting revision's - local run. The whole-showcase check found that the Vue Core MenuBar pills demo overflowed at - 390 px in both themes. Browser behavior also found missing targets in both DataTable fixture - runs and a difference in the standalone Tabs indicator motion. Evidence: - `/private/tmp/cmui-browser-checkpoint.r6C9N6`. -- The pinned browser ran 132 behavior scenarios across both adapters at `8ff4cecf` without failures - or motion mismatches. The separate 48-frame showcase run reported no JavaScript errors and no - horizontal page overflow. Vue Layouts was the largest remaining viewport difference in this run - and was corrected afterward. Evidence: `/private/tmp/cmui-browser-checkpoint.kiEdef` and - `/private/tmp/cmui-browser-checkpoint.XZHnOm`. - -- `a9083071`, fresh copy at `/private/tmp/cmui-verify.Kvb8Dd`: installation, builds, typecheck, - contracts, accessibility fixtures, package budgets and tree shaking passed. Cold workspace - verification exposed canonical DataTable, dependency order, and export inventory defects. - Registry-backed npm, pnpm and Yarn tarball consumers passed after the intentionally offline - install could not resolve metadata in their empty consumer caches. The release audit found zero - production vulnerabilities and no high or critical development findings; 19 low/moderate - development findings were reported. The initial failures and reruns are retained in the logs. -- `3936ebf5` plus the five exact cold gate changes later committed in `c7207dfd`: clean install and - all cold workspace tests passed, including 189 built Vue tests. Log: - `/tmp/cm-layout-cold.c1hsdL/cold-verification.log`. -- `3c3057c9`, fresh copy at `/private/tmp/cmui-verify.hJF9nl`: full lint, cold workspace tests, - contracts, package checks and builds passed. The typecheck reported an index export from an - in-progress MenuBar change; its type is present in `823edcaa`. Format check reported only - `CmDataTable.vue`. Re-run from a coherent committed candidate after these corrections. - -## Acceptance at 0a93f598 - -**Status: PARTIAL.** The clean package and local paired browser gates passed. Historical package -and behavior differences are documented, and the hosted stored-fixture gate is unverified. - -Product and browser snapshot: `34649ac4148a28efe5857e0698259894da1d3d63`. Independent review -checked upgrading Vue consumers, standalone server-rendered HTML consumers, and dependency -direction for future adapters. It reproduced and rechecked the Tabs hydration issue and -animation mismatch. It also reviewed overlay hydration, DataTable labels, and MenuBar sizing. -No consequential defect remains known in the reviewed scope. - -The package snapshot is `77bc8a659b85295a8d55859ceae721ee4bff7b6d`. The only difference from -the browser snapshot is one test runner assertion for DataTable visibility. All 20 checks -passed, including 964 cold tests, 181 canonical accessibility cases and fresh packed npm, -pnpm and Yarn consumers. The release audit found zero production vulnerabilities; the 20 -development findings were all low or moderate. The evidence is in `/private/tmp/cmui-verify.SAM6tG`. - -Pinned Chrome for Testing `151.0.7922.138` passed 144 behavior runs with equal motion in both -adapters. All 362 Vue/Vanilla fixture and theme pairs had zero differing pixels and no motion -mismatch. The historical reference and the two independent production builds produced 48 whole -showcase frames with no script errors or horizontal overflow. At a threshold of four RGB levels, -the largest changed areas among these comparisons were 3.50% in Vue and 3.44% in Vanilla. The -evidence is in `/private/tmp/cmui-browser-checkpoint.UGFHA9`. - -The first stored-fixture sweep timed out on one case. A fresh profile completed all 96 captures -at the same revision and all PNGs matched the starting revision's local capture byte for byte. -Both adapters still show 44 of 48 differences when compared against the stored images. The -starting run has the same residual, isolated to glyph paint. The stored images were not -changed. The strict hosted `macos-26` result remains **UNVERIFIED**. Complete local recapture: -`/private/tmp/cmui-fixture-recapture.WkOzXA`. - -The [migration guide](../migrate-from-vueforge.md) and contract traces record the package and -behavior differences. The current release uses ESM and explicit shared styles. The historical -package import paths, automatic style loading, CommonJS and raw runtime theme presets require -migration or the old release. Overlay transitions, MenuBar hover and portals, and DataTable -column motion and resize guides differ. In Vanilla the server or application owns table rows, -including any multi-column ordering and dedicated column reorder UI. These are explicit limits -of the current adapter contracts. - -The next gate is the `visual` job from [CI](../../.github/workflows/ci.yml) on an authorized -`macos-26` runner at the same revision, using the pinned Chrome and the existing stored images. -Record the renderer and the exact result before changing the hosted visual status. This gate -compares the 12 stored component cases; it is separate from both the whole showcase comparison -and the paired Vue/Vanilla visuals. - -## Continuation from 0a93f598 - -**Status remains PARTIAL.** Local package, browser behavior and adapter parity checks passed. -The affected components and the stored fixture set were recaptured from the final product source. -The exact hosted gate remains unverified, and the compatibility differences below remain open. - -- Vue and Layouts share ESM and CommonJS component instances on supported Node versions - (`8cae4010`). The 63 historical deep entries (`dc88b534`) load shared foundation and - component CSS in browser bundlers. Node keeps these imports CSS-free. Packed npm, pnpm, - and Yarn consumers, Node 22 and 24 SSR, and the pinned browser consumer passed. - [Migration guide](../migrate-from-vueforge.md) -- Historical Dialog and Drawer accept authored portals (`65e81268`). Drawer accepts a - custom scroll region or explicit lock opt-out (`5cd4173b`). Chrome verified live portal - moves, native top-layer state, Escape and form dismissal, wheel locking, and focus return. - Historical CommandPalette restores the body default and authored destinations (`23b86438`). - A live move preserves the active query, focus, and native modality. - The shared anchored control lookup falls back inline for malformed or self-referential - destinations (`d333261f`). -- Historical DatePicker displays and submits only the host-accepted model (`67accda2`). In - both adapters, the DataTable guide spans the table body during resize (`ca385dde`). Pointer - checks confirmed the guide in LTR and RTL and verified that the active marker clears on release. -- The shared document foundation follows system and explicit light or dark preferences for - native controls (`27b60bfe`). Pinned Chrome inspected all six historical and starting Vue - showcase routes at 390 and 1280 px. The CodeBlock replay now keeps all 20 examples and - preserves the long sample's scroll position (`05eb5804`, `f1d36874`). At both widths the - heading uses the historical 23 px size and the first placeholder matches its 521 px height. - The route keeps its page-level heading and uses the shared compact replay control. -- The renderer audit reproduced all 520 changed glyph pixels with exact `d9879116` on this - Mac and matched its 48 font-normalized PNGs byte for byte to each current adapter. The - capture lineage and older passing hosted job exclude a restoration regression and stale - fixture dimensions for the verified matrix. The precise text rasterization difference is - unresolved. [Stored visual renderer evidence](stored-visual-renderer.md) - -The full local browser matrix at `5cd4173b` passed 144 behavior runs and 362 adapter fixture -pairs with no pixel or motion differences. It had zero script errors or overflow in 48 whole -showcase frames. Compared with the historical showcase at the four-level RGB threshold, the -largest changed areas were 3.50% in Vue and 3.44% in Vanilla. The same run captured all 96 -stored fixtures and matched the starting revision's local output byte for byte. The complete -package gate also passed on that revision. Package and browser evidence lives at -`/private/tmp/cmui-verify.ouEZHK` and `/private/tmp/cmui-browser-checkpoint.cfsizN`. - -The final product checkpoint is `23b86438378abd8394c7d40ed2b4bb9ae0cb7fd4`. All 20 clean package -checks passed, including 973 cold tests, 181 accessibility cases, both production builds, and -fresh npm, pnpm, and Yarn tarball installs. The production release audit found no vulnerabilities. -The historical namespace meets the unchanged 82,944-byte gzip limit. The exact package archive -is `/private/tmp/cmui-verify.kD2jpO`. - -The final modal changes passed 22 focused behavior runs with equal motion, and 32 paired -fixture and theme comparisons with zero differing pixels. On the production Core route, the -historical palette accepted a query and returned focus to the launcher on Escape at both 390 -and 1280 px. All 96 strict local fixture captures matched the starting revision again. Compared -with the stored set, each adapter has the same 44 of 48 differences and no missing images. The -browser evidence is `/private/tmp/cmui-final-restoration-browser.skV7MI`. - -### Remaining compatibility differences - -- The original package names and raw preset engine remain in the archived releases. The new - paths preserve the component subpaths, browser styles, and Node loading conditions. Applications - can use shared token overrides for current Vue and Vanilla styles. Old `.vf-*` selectors and - theme tokens are tied to the archived component markup. [Migration guide](../migrate-from-vueforge.md) -- MenuBar uses a compact in-flow layout and a wide inline cascade. The historical portal and - horizontal controls depend on a different layout strategy. An isolated hover and close-delay - trial passed its interaction tests. The combined implementation exceeded the unchanged - historical bundle limit, so the existing keyboard and click behavior remains in the release. -- Native overlay dismissal, close animations, and some presentation details differ from the - reference. Native modal components use the top layer and manage focus immediately on close. - DatePicker uses native clock selects. DataTable restores reordering and its resize guide, with - current reorder motion. [Vue contract trace](historical-vue-core.md) - -The next external action for the **UNVERIFIED** hosted gate is to publish an authorized -verification ref at the final SHA. Dispatch it with `gh workflow run ci.yml --ref `. -Confirm that the `visual` job checked out that SHA on `macos-26`. Record the runner image, pinned -Chrome version and both strict comparisons against the existing stored images. -[CI workflow](../../.github/workflows/ci.yml) - -## Continuation from f7471f59 - -**PARTIAL.** The product revision passed the local package and adapter parity suites and all -hosted gates. Historical navigation, overlay dismissal and package differences remain. - -- The historical Vue MenuBar switches open branches on hover and closes after the original - 120 ms leave delay. Wide submenus use a positioned portal within the navigation landmark. - Compact and server-rendered menus remain inline. Browser checks covered pointer and keyboard - handoff, nested focus, clipping and live resizing (`170088ec`). Vue and Vanilla share the - historical 320 ms submenu reveal (`08c6f8fb`). -- Dropdown, Popover and Tooltip restore the historical 320 ms fade, 4 px rise and 0.97 scale - (`b4394b4e`). Native Dialog and Drawer restore their matching 220 ms fade and rise or 320 ms - edge slide with backdrop fade (`beefa9fa`). Entry motion respects reduced motion. Native - dismissal immediately releases modality and restores focus. A modal containing an anchored - overlay fades in place so fixed panels stay aligned with their triggers (`c11d8460`). - Independent Chrome verification passed 24 cases covering viewport placement, focus, reduced - motion and dismissal before the fade ends. Four standalone Vanilla viewport and motion - combinations also passed for inline Dropdown and portaled Tooltip. The Tooltip's own reveal - left a horizontal offset under 1.4 px in this probe. -- The historical DataTable animates header and body cells during keyboard and pointer reorder - (`d077fd73`). Pinned Chrome ran 30 scenarios across the current build and `d9879116`. Both - used the same 220 ms timing, kept pinned columns fixed, rolled back on Escape, and skipped - animations with reduced motion or more than 200 cells. The current build also kept header focus. -- Compact generated icon data and fixed regular glyph imports make room for the restored - behavior inside the existing bundle limits (`36c3e38a`). The generator reproduced all 116 - icon geometries from the frozen source with identical decoded data. -- A generated Vite alias list preserves the 63 original Core and Layouts component subpaths - during browser and bundled SSR migration (`756fe45c`). The browser receives the same CSS as - the current package paths. Root package imports, the Layouts plugin and the raw runtime - preset engine still require the archived releases or migration to shared tokens. - [Migration guide](../migrate-from-vueforge.md) - -The historical horizontal MenuBar controls require overflow navigation that keeps compact items -reachable with keyboard and touch. Restoring overlay exit motion requires retaining the closing -paint and portal position while releasing pointer, focus and accessibility ownership immediately. -Consumers of the raw preset engine and root package registrations can keep the pinned archived -packages until they migrate to the current entries and shared tokens. [Vue contract trace](historical-vue-core.md) - -### Exact product candidate - -Product revision `084d19ea0244e86813875fc4a744f9878e8d285b` passed all 20 clean package checks, -including 982 cold tests, 181 canonical accessibility cases, both production showcases and fresh -npm, pnpm and Yarn tarball installs. The production audit found zero vulnerabilities. The -development audit reported three low and 17 moderate findings. The native Vue and historical -aggregates measured 59.60 KiB and 79.43 KiB against their existing 60 and 81 KiB gzip limits. -Shared CSS measured 51,183 of 51,200 allowed gzip bytes. Package evidence is in -`/private/tmp/cmui-verify.v9FnLQ`. - -In Chrome for Testing `151.0.7922.138` on macOS 27.2.1, all 96 stored-fixture captures matched -the corresponding `d9879116` Inter-injected captures byte for byte. The strict local stored -comparison again reported 44 of 48 differences per adapter, with zero missing or unexpected -images. The frozen reference reproduces the same 520 changed glyph pixels. Approved PNGs, the -rendering configuration and the comparison threshold are unchanged. [Renderer evidence](stored-visual-renderer.md) - -Pinned Chrome passed all 144 behavior runs. All 362 Vue and Vanilla fixture pairs had zero -differing pixels and equal motion signatures. The historical, Vue and independent Vanilla -production showcases produced 48 viewport captures with zero script errors or horizontal -overflow. Against the historical showcase, the largest changed areas were 3.50% for Vue and -3.44% for Vanilla at the four-level RGB threshold. The Vanilla build includes 62 components -and 369 contract examples and variants. Browser evidence is in -`/private/tmp/cmui-browser-checkpoint.JtBwQZ`. - -### First hosted run - -GitHub Actions built `c11d8460` on `macos-26-arm64` image `20261102.0473.1`, macOS 26.7.2 -(`25G332`), with Chrome for Testing `151.0.7922.138`. The two strict stored comparisons each -reported 48 captures with zero changed, missing or unexpected images. Six broader paired -comparisons failed across the two themes of `dropdown-composed`, `dropdown-open` and -`dropdown-pills`, so the hosted behavior step did not run. The seven other CI jobs passed. -[Hosted visual job](https://github.com/codemonster-ru/ui/actions/runs/43715133866/job/132814912035) - -Pinned Chrome reproduced the paired failure with 6× CPU throttling and reduced motion. The -reduced-motion foundation rule gave all matching elements a nonzero transition duration. This -started a padding transition on the fixture container even though it declared no transition. -Vue measured the anchor at the viewport origin and retained that placement after the container -settled. Vanilla measured later. `084d19ea` disables CSS transitions in reduced-motion mode and -retains the shortened duration for animations. All 12 paired retests at 1×, 6× and 10× CPU -throttling matched at capture and again after settling. Independent traces are in -`/private/tmp/cmui-hosted-dropdown.nNE9Zy`. The paired stress results are in -`/private/tmp/cmui-drawer-slice.eY9Pwm/dropdown-c11-no-reduced-transitions.log`. Six further -paired captures against the committed build at 1× and 6× also matched at both checkpoints. -Committed-build stress evidence is in `/private/tmp/cmui-dropdown-084d19ea-stress.log`. - -### Final hosted result - -All eight GitHub Actions jobs passed at `084d19ea0244e86813875fc4a744f9878e8d285b` on -`codex/restoration-visual-c11d8460`. The `visual` job checked out that SHA on `macos-26-arm64` -image `20261102.0473.1`, macOS 26.7.2 (`25G332`), and installed Chrome for Testing -`151.0.7922.138`. It captured 96 screenshots and reported 48 comparisons per adapter with zero -changed, missing or unexpected images. All 362 paired fixtures matched in pixels and motion. -All 144 behavior runs passed with equal motion signatures. -[Hosted visual job](https://github.com/codemonster-ru/ui/actions/runs/43716556197/job/132819264193) - -## Continuation from a019c059 - -**PASS for this continuation.** The restored behaviors passed the local checks and all eight -hosted jobs. The package migration and browser fallback boundaries are documented below. - -- The CSS build removes authoring comments from distribution copies while retaining license - notices and the original stylesheet entry paths (`6f1ae7cf`). With the baseline component - sources this freed 4,626 gzip bytes. The shared scroll controls preserve the existing Tabs - markup and styles (`47b92039`). Four pinned Chrome Tabs pairs matched in both themes. -- NodeNext now resolves the relative declarations exported by the Vue and Layouts packages - (`ca60f755`). The packed consumer checks that `createVueForgeCore()` with `app.use()` accepts - supported theme preferences, and that TypeScript rejects an old preset object and invalid - layout props. Current layouts render through component imports and shared styles. Archived - package roots and runtime preset configuration remain intentional migration boundaries. - [Migration guide](../migrate-from-vueforge.md) -- Historical Vue MenuBar restores overflow controls with logical edges (`e4ff3dea`). At a - 390 px viewport, pinned Chrome matched the 215 px `d9879116` scroll step in LTR and RTL. - The current component also passed touch swipes, wheel scrolling, grouped and nested keyboard - traversal, disabled-item skipping, and focus retention during resize and hydration. Compact - submenus stay reachable below the scroller. Server-rendered content wraps until hydration. - Nine Vue regression tests, eight canonical interaction runs, and eight paired screenshots - passed. Browser evidence is in `/private/tmp/cmui-menubar-overflow.R3Eudy`. -- Dropdown, Popover, Tooltip, Select, DatePicker, and MenuBar restore 320 ms exit motion - (`11ce136a`, `e4ff3dea`). Closing panels are inert while their paint and placement persist. - Pinned Chrome passed 20 Vue and Vanilla cases covering trusted pointer input, the accessibility - tree, focus release, reduced motion and portal cleanup. The five frozen overlay controls used - the same duration and easing. Evidence is in `/private/tmp/cmui-floating-exit.qmz0Uy`. -- Native Dialog, ConfirmDialog, CommandPalette, and Drawer restore their historical panel and - backdrop exit (`11ce136a`). Chrome compared 28 current and `d9879116` cases at 390 and 1280 px. - Dialog and ConfirmDialog faded with a 12 px downward shift over 220 ms. CommandPalette faded - with an 8 px upward shift over 220 ms, and Drawer slid toward its edge over 320 ms. The stacked - check kept the outer modal interactive, restored opener focus, and reported only that modal in the - accessibility tree while the inner panel faded. Six adapter behavior runs verify native - state, focus, hit testing, scroll release, and reduced-motion dismissal. Evidence is in - `/private/tmp/cmui-modal-exit.bWViyn`. - -Reduced motion and browsers without the required discrete transitions and CSS inertness use -immediate hiding. On direct native `dialog.close()` or form dismissal without an opener, the -browser can report the previous `activeElement` until its close event. The panel releases input -and keyboard trapping immediately, and adapter-managed dismissal also clears focus synchronously. -[Vue contract trace](historical-vue-core.md) - -### Local verification - -The exact product revision `e4ff3dea14ea7bc3a47a60abc9ae1a7be9377f25` passed all 20 clean quality -checks. They included 988 cold tests, 181 accessibility cases, both production builds, fresh -npm, pnpm and Yarn tarball installs, and the release audit. The audit reported zero production -vulnerabilities, with three low and 17 moderate development findings. The native Vue bundle -measured 59.97 of 60 KiB gzip and the historical entry measured 80.39 of 81 KiB. Runtime measured -79.85 of 80 KiB and shared CSS measured 47,474 of 51,200 bytes. Evidence is in -`/private/tmp/cmui-verify.6vvIwG`. - -Pinned Chrome passed all 144 interaction runs and all 362 Vue/Vanilla fixture pairs, including -matching motion signatures. The three production showcases produced 48 captures with zero -script errors or horizontal overflow. The largest changed areas against the historical showcase -were 3.46% in Vue and 3.43% in Vanilla at the four-level RGB threshold. The Vanilla showcase -builds independently with 62 components and 369 contract examples and variants. - -The local browser run used archive `68fbeae4`. The only later change before the final product -revision resolves an optional submenu ID in the Vue regression test. Both builds produced -byte-identical runtime assets for the two showcases and their packages. The 96 local captures -matched each other across adapters and matched the font-injected `d9879116` and prior `084d19ea` -captures byte for byte. The same 44 local stored-image differences per adapter come from the -documented glyph paint residual. The approved images, font configuration and thresholds -remain the same. Browser evidence is in `/private/tmp/cmui-browser-checkpoint.9XuT4u`. -[Renderer evidence](stored-visual-renderer.md) - -### Hosted verification - -All eight GitHub Actions jobs passed at `e4ff3dea14ea7bc3a47a60abc9ae1a7be9377f25` on the -dedicated verification branch. The visual job checked out that SHA on `macos-26-arm64` image -`20261102.0473.1`, macOS 26.7.2 (`25G332`), with Chrome for Testing `151.0.7922.138`. Both -48-image stored comparisons reported zero changed, missing or unexpected images. The same job -verified 362 pixel-identical Vue/Vanilla pairs with matching motion and 144 interaction runs -with zero failures or motion mismatches. -[Hosted visual job](https://github.com/codemonster-ru/ui/actions/runs/43729547790/job/132858739350) diff --git a/docs/verification/historical-vanilla.md b/docs/verification/historical-vanilla.md index 7669e516..e5d377a1 100644 --- a/docs/verification/historical-vanilla.md +++ b/docs/verification/historical-vanilla.md @@ -87,6 +87,4 @@ and registered the TableOfContents factory. Type checking passed with the packag `ColumnChooserVisibleColumnsChangeDetail` declaration. The browser bundle contained CSS, ESM JavaScript, and all four bundled Inter font assets. -The [restoration queue](historical-restoration.md) gives the exact browser, accessibility, and -package checkpoints and distinguishes canonical markup checks from comparisons against the -historical showcase and the stored fixture baseline. +See the [release checklist](../release-checklist.md) for current package, browser and accessibility checks. diff --git a/docs/verification/historical-vue-core.md b/docs/verification/historical-vue-core.md index 6494802b..781ea0aa 100644 --- a/docs/verification/historical-vue-core.md +++ b/docs/verification/historical-vue-core.md @@ -128,6 +128,4 @@ CommonJS, and explicit shared stylesheet and token imports for aggregate entries reachability check. Historical component styles use VueForge selectors and tokens. The new counterparts use the existing shared CodeMonster selectors and tokens. CSS class name and custom property migration for legacy consumers remains open. -- The [restoration queue](historical-restoration.md) records the separate historical showcase, - stored fixture, paired adapter and accessibility checks. Any remaining differences are scoped - in the corresponding contract rows above. +- See the [release checklist](../release-checklist.md) for current browser and accessibility checks. diff --git a/docs/verification/product-quality.md b/docs/verification/product-quality.md index c67c8777..48518c6a 100644 --- a/docs/verification/product-quality.md +++ b/docs/verification/product-quality.md @@ -1,7 +1,7 @@ # Product quality and developer experience The starting point is `c908b006`, whose product sources match the accepted `e4ff3dea` revision. -The historical design reference is `d9879116`. See [historical restoration](historical-restoration.md) +The historical design reference is `d9879116`. See [historical restoration checkpoints](https://github.com/codemonster-ru/ui/blob/857c0e396077a7703a6b0b28c7c731fdb7f7befb/docs/verification/historical-restoration.md) for the earlier acceptance and [stored visual renderer](stored-visual-renderer.md) for the limits of local pixel comparisons. diff --git a/docs/verification/vue-razor-accessibility-visual.md b/docs/verification/vue-razor-accessibility-visual.md deleted file mode 100644 index 7f625446..00000000 --- a/docs/verification/vue-razor-accessibility-visual.md +++ /dev/null @@ -1,32 +0,0 @@ -# Vue and Razor accessibility and visual verification - -Verification date: 2026-08-13. - -`CMUI-157` passed on the same repository state with Node.js 24.15.0 and the `annabel-php` image: - -```bash -npm run test:ui -npm run check:ui-packages -npm run check:composer-packed-consumer -``` - -The shared contract gate validated 87 canonical component cases, 44 interaction scenarios, and 348 -visual fixture documents across light/dark themes and mobile/desktop viewports. Axe reported no -violations in the canonical cases; repository checks also rejected duplicate IDs, unresolved ARIA -relationships, positive tab order, missing accessible names, selector drift, and missing reduced -motion or forced-colors hooks. - -Vue passed 62 DOM interaction tests and 105 SSR/package tests, including significant-DOM comparison -with every applicable canonical case and shared behavior scenarios. The framework-independent -runtime passed 58 tests, including keyboard navigation, focus containment and restoration, -disclosure dismissal, controlled state events, and progressive-enhancement scenarios. - -Annabel Razor passed PHPStan and 133 tests with 305 assertions. Its parity tests rendered the same -canonical cases through Razor, while the packed consumer verified the exact Composer archive, -provider registration, component rendering, and integrity-checked shared styles. - -The visual gate validates deterministic fixture documents, selectors, theme/viewport coverage, -shared CSS, and adapter DOM parity. It is not a pixel-diff baseline and does not replace manual -browser, zoom/reflow, or assistive-technology review in a real application. Those application-level -checks remain part of prerelease consumer validation rather than being misrepresented as automated -coverage here. diff --git a/package.json b/package.json index 5e67d7eb..5e819e0f 100644 --- a/package.json +++ b/package.json @@ -13,11 +13,11 @@ "scripts": { "audit:release": "npm audit --omit=dev && npm audit --audit-level=high", "build": "npm run build:ui", - "build:vanilla": "npm run build -w @codemonster-ru/ui-tokens && npm run build -w @codemonster-ru/ui-css && npm run build -w @codemonster-ru/ui-runtime && npm run build -w @codemonster-ru/ui-icons && node ./scripts/build/build-vanilla.mjs", "build:demo": "npm run build -w @codemonster-ru/ui-showcase-example", "build:ui": "node ./scripts/ci/run-code-monster-ui-workspaces.mjs build", - "check": "npm run check:docs && npm run check:ui-packages", - "check:clean-install": "node ./scripts/ci/check-clean-install.mjs", + "build:vanilla": "npm run build -w @codemonster-ru/ui-tokens && npm run build -w @codemonster-ru/ui-css && npm run build -w @codemonster-ru/ui-runtime && npm run build -w @codemonster-ru/ui-icons && npm run build:vanilla:prepared", + "build:vanilla:prepared": "node ./scripts/build/build-vanilla.mjs", + "check": "node ./scripts/ci/check-changed-workspaces.mjs", "check:component-documentation": "node --test ./scripts/ci/component-documentation.test.mjs && node ./scripts/ci/check-component-documentation.mjs", "check:consumer-tree-shaking": "node ./scripts/ci/check-consumer-tree-shaking.mjs", "check:css-token-references": "node --test ./scripts/ci/css-token-references.test.mjs", @@ -36,36 +36,30 @@ "check:ui-controller-coverage": "node --test ./scripts/contracts/controller-coverage.test.mjs && node ./scripts/contracts/check-controller-coverage.mjs", "check:ui-package-budgets": "node --test ./scripts/ci/code-monster-ui-package-budgets.test.mjs && node ./scripts/ci/check-code-monster-ui-package-budgets.mjs", "check:ui-package-metadata": "node --test ./scripts/ci/code-monster-ui-package-metadata.test.mjs ./scripts/ci/code-monster-ui-workspaces.test.mjs && node ./scripts/ci/check-code-monster-ui-package-metadata.mjs", - "check:ui-packages": "node ./scripts/ci/run-code-monster-ui-workspaces.mjs check", "check:ui-registry-consumer": "node ./scripts/ci/check-code-monster-ui-registry-consumer.mjs", "check:ui-significant-dom": "node --test ./scripts/contracts/significant-dom.test.mjs ./scripts/contracts/significant-dom-conformance.test.mjs", - "check:ui-visual-fixtures": "node --test ./scripts/visual/code-monster-ui-fixtures.test.mjs ./scripts/visual/compare-showcase.test.mjs ./scripts/visual/cross-platform-baselines.test.mjs ./scripts/visual/cross-platform-browser.test.mjs && node ./scripts/ci/check-code-monster-ui-visual-fixtures.mjs", - "check:verify-coverage": "node --test ./scripts/ci/verify-coverage.test.mjs && node ./scripts/ci/check-verify-coverage.mjs", + "check:ui-visual-fixtures": "node --test ./scripts/visual/code-monster-ui-fixtures.test.mjs ./scripts/visual/compare-showcase.test.mjs ./scripts/visual/cross-platform-baselines.test.mjs && node ./scripts/ci/check-code-monster-ui-visual-fixtures.mjs", "dev": "npm run build && npm run dev -w @codemonster-ru/ui-showcase-example", "dev:demo": "npm run dev -w @codemonster-ru/ui-showcase-example", "format": "npm run format --workspaces --if-present --include-workspace-root=false", "format:check": "npm run format:check --workspaces --if-present --include-workspace-root=false", - "hooks:install": "git config core.hooksPath .githooks", "lint": "npm run lint --workspaces --if-present --include-workspace-root=false", "lint:all": "npm run lint && npm run lint:styles && npm run lint:html && npm run lint:md && npm run lint:data", "lint:data": "prettier --check \"**/*.{json,yml,yaml}\"", - "lint:html": "htmlhint \"**/*.html\" --format unix --nocolor", + "lint:html": "htmlhint \"**/*.html\" --ignore \"artifacts/**,**/.generated/**,**/.cache/**,**/coverage/**,**/dist/**\" --format unix --nocolor", "lint:md": "markdownlint-cli2 \"**/*.md\"", - "lint:styles": "stylelint \"**/*.{css,scss,sass,vue}\" --allow-empty-input --formatter unix", + "lint:styles": "stylelint \"{examples,scripts/visual,packages/vue,packages/layouts}/**/*.{css,scss,sass,vue}\" --allow-empty-input --formatter unix", "pack:all:dry-run": "npm run pack:ui:dry-run", "pack:ui:dry-run": "node ./scripts/ci/run-code-monster-ui-workspaces.mjs pack:dry-run", - "prepare": "npm run hooks:install", - "prepublish:all": "npm run build && npm run pack:all:dry-run", - "prepublish:ui": "npm run build:ui && npm run pack:ui:dry-run", "preview": "npm run preview -w @codemonster-ru/ui-showcase-example", "preview:vanilla": "npm run build:vanilla && npm exec -w @codemonster-ru/ui-showcase-example -- vite preview --outDir ../vanilla/dist --port 4174 --open", - "test": "npm run build && npm run test --workspaces --if-present --include-workspace-root=false && npm run test:ui", - "test:ci-like": "scripts/ci/test-without-dist.sh", - "test:release-prep": "node --test ./scripts/ci/prepare-release-from-tag.test.mjs ./scripts/ci/verify-chain.test.mjs", + "test": "npm run build && npm run test:built && npm run test:ui", + "test:built": "npm run test:built --workspaces --if-present --include-workspace-root=false", + "test:release-prep": "node --test ./scripts/ci/prepare-release-from-tag.test.mjs", "test:ui": "npm run check:ui-contracts && npm run check:ui-accessibility && npm run check:ui-visual-fixtures", "test:ui-css-packed-consumer": "node --test ./scripts/ci/code-monster-ui-css-consumer.test.mjs", "typecheck": "npm run typecheck --workspaces --if-present --include-workspace-root=false", - "verify": "npm run check:clean-install && npm run audit:release && npm run build && npm run lint:all && npm run format:check && npm run typecheck && npm run check:repository-contracts && npm run check:verify-coverage && npm run test:ui && npm run test:ci-like && npm run check:docs:examples && npm run test:release-prep && npm run check:package-contracts && npm run check:ui-package-budgets && npm run check:packed-consumers && npm run check:consumer-tree-shaking && npm run pack:all:dry-run", + "verify": "npm ls --all --json > /dev/null && npm run audit:release && npm run build && npm run build:demo && npm run build:vanilla:prepared && npm run lint:all && npm run format:check && npm run typecheck && npm run test:built && npm run test:ui && npm run check:docs && npm run check:docs:examples && npm run test:release-prep && npm run check:package-contracts && npm run check:ui-package-budgets && npm run check:packed-consumers && npm run check:consumer-tree-shaking && npm run pack:all:dry-run", "visual:cross-platform:capture": "node ./scripts/visual/capture-cross-platform-cases.mjs", "visual:cross-platform:serve": "node ./scripts/visual/serve-cross-platform-cases.mjs" }, diff --git a/packages/css/package.json b/packages/css/package.json index a7ea5a43..f8415482 100644 --- a/packages/css/package.json +++ b/packages/css/package.json @@ -95,7 +95,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint . && stylelint \"src/**/*.css\"", "prepack": "npm run build", - "test": "npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "node --test ./__tests__/*.test.mjs", "typecheck": "node --check ./scripts/build.mjs" }, "keywords": [ diff --git a/packages/icons/package.json b/packages/icons/package.json index 98d6e9b1..57dabd1b 100644 --- a/packages/icons/package.json +++ b/packages/icons/package.json @@ -29,7 +29,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint .", "prepack": "npm run build", - "test": "npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "node --test ./__tests__/*.test.mjs", "typecheck": "tsc -p tsconfig.json --noEmit" }, "engines": { diff --git a/packages/layouts/package.json b/packages/layouts/package.json index 5b418ea5..4b7d3968 100644 --- a/packages/layouts/package.json +++ b/packages/layouts/package.json @@ -46,7 +46,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint .", "prepack": "npm run build", - "test": "vitest run src --passWithNoTests && npm run build", + "test": "npm run build && npm run test:built", + "test:built": "vitest run src", "typecheck": "vue-tsc -p tsconfig.json --noEmit" }, "keywords": [ diff --git a/packages/runtime/package.json b/packages/runtime/package.json index a3fa6288..3e14baca 100644 --- a/packages/runtime/package.json +++ b/packages/runtime/package.json @@ -56,7 +56,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint .", "prepack": "npm run build", - "test": "npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "node --test ./__tests__/*.test.mjs", "typecheck": "tsc -p tsconfig.json --noEmit" }, "keywords": [ diff --git a/packages/tokens/package.json b/packages/tokens/package.json index ff52a240..2ad0fcb5 100644 --- a/packages/tokens/package.json +++ b/packages/tokens/package.json @@ -40,7 +40,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint .", "prepack": "npm run build", - "test": "npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "node --test ./__tests__/*.test.mjs", "typecheck": "tsc -p tsconfig.json --noEmit" }, "keywords": [ diff --git a/packages/utilities/package.json b/packages/utilities/package.json index 4b053135..54d7e1ca 100644 --- a/packages/utilities/package.json +++ b/packages/utilities/package.json @@ -35,7 +35,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint . && stylelint \"src/**/*.css\"", "prepack": "npm run build", - "test": "npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "node --test ./__tests__/*.test.mjs", "typecheck": "node --check ./scripts/build.mjs && node --check ./src/contract.mjs" }, "keywords": [ diff --git a/packages/vue/package.json b/packages/vue/package.json index 9c4b21ff..69afa43c 100644 --- a/packages/vue/package.json +++ b/packages/vue/package.json @@ -51,7 +51,8 @@ "format:check": "prettier --ignore-path ../../.prettierignore --check .", "lint": "eslint .", "prepack": "npm run build", - "test": "vitest run src && npm run build && node --test ./__tests__/*.test.mjs", + "test": "npm run build && npm run test:built", + "test:built": "vitest run src && node --test ./__tests__/*.test.mjs", "typecheck": "vue-tsc -p tsconfig.json --noEmit" }, "keywords": [ diff --git a/packages/vue/src/components/display-components.test.ts b/packages/vue/src/components/display-components.test.ts index 42cd6adf..5bc5c856 100644 --- a/packages/vue/src/components/display-components.test.ts +++ b/packages/vue/src/components/display-components.test.ts @@ -68,4 +68,18 @@ describe('display components', () => { ); expect(unsafe.attributes('style')).toBeUndefined(); }); + + it('keeps the Skeleton element when the minimum height is added or removed', async () => { + const wrapper = mount(CmSkeleton); + const element = wrapper.get('div').element; + expect(wrapper.attributes('style')).toBeUndefined(); + + await wrapper.setProps({ minHeight: 48 }); + expect(wrapper.get('div').element).toBe(element); + expect(wrapper.attributes('style')).toContain('min-height: 48px'); + + await wrapper.setProps({ minHeight: null }); + expect(wrapper.get('div').element).toBe(element); + expect(wrapper.attributes('style')).toBeUndefined(); + }); }); diff --git a/packages/vue/src/components/skeleton/CmSkeleton.vue b/packages/vue/src/components/skeleton/CmSkeleton.vue index 340e27d5..ccfe3a6e 100644 --- a/packages/vue/src/components/skeleton/CmSkeleton.vue +++ b/packages/vue/src/components/skeleton/CmSkeleton.vue @@ -1,5 +1,5 @@ diff --git a/scripts/ci/check-changed-workspaces.mjs b/scripts/ci/check-changed-workspaces.mjs new file mode 100644 index 00000000..4c300ea3 --- /dev/null +++ b/scripts/ci/check-changed-workspaces.mjs @@ -0,0 +1,94 @@ +import { execFileSync } from 'node:child_process'; +import { existsSync, readFileSync } from 'node:fs'; +import { resolve } from 'node:path'; +import { discoverCodeMonsterUiWorkspaces, selectWorkspaceChecks } from './code-monster-ui-workspaces.mjs'; + +const root = resolve(import.meta.dirname, '../..'); +const args = process.argv.slice(2); +const smoke = args.includes('--smoke'); +const [base, ...extra] = args.filter((argument) => argument !== '--smoke'); +if (extra.length || (base && !/^[0-9a-f]{40}$/u.test(base))) { + throw new Error('Usage: npm run check -- [base commit SHA] [--smoke]'); +} + +function readWorkspace(path) { + const manifest = JSON.parse(readFileSync(resolve(root, path, 'package.json'), 'utf8')); + return { + name: manifest.name, + path, + private: Boolean(manifest.private), + scripts: manifest.scripts, + dependencies: Object.keys({ ...manifest.dependencies, ...manifest.peerDependencies, ...manifest.devDependencies }), + }; +} + +const packages = discoverCodeMonsterUiWorkspaces(resolve(root, 'packages')).map(({ directory }) => + readWorkspace(`packages/${directory}`), +); +const vanilla = { + name: 'vanilla', + path: 'examples/vanilla', + private: true, + scripts: {}, + dependencies: ['css', 'icons', 'runtime', 'tokens'].map((name) => `@codemonster-ru/ui-${name}`), +}; +const examples = [readWorkspace('examples/ui-showcase'), vanilla]; +function gitPaths(...args) { + return execFileSync('git', args, { cwd: root, encoding: 'utf8' }).split('\0').filter(Boolean); +} + +let diff; +if (base && !/^0+$/u.test(base)) { + try { + execFileSync('git', ['cat-file', '-e', `${base}^{commit}`], { cwd: root, stdio: 'ignore' }); + diff = [ + ...gitPaths('diff', '--name-only', '--no-renames', '-z', base, '--'), + ...gitPaths('ls-files', '--others', '--exclude-standard', '-z'), + ]; + } catch { + console.log('The change range is unavailable. Checking the full workspace graph.'); + } +} +const { builds, tests, full, browser } = selectWorkspaceChecks(packages, examples, diff, smoke); + +function npm(...arguments_) { + execFileSync('npm', arguments_, { cwd: root, stdio: 'inherit' }); +} + +for (const workspace of builds) { + if (workspace === vanilla) npm('run', 'build:vanilla:prepared'); + else npm('run', 'build', '-w', workspace.name); +} + +if (full) { + for (const script of ['lint:all', 'format:check', 'typecheck', 'check:docs:examples', 'test:release-prep']) { + npm('run', script); + } +} else { + for (const script of ['lint', 'typecheck', 'format:check']) { + const workspaces = tests.filter(({ scripts }) => scripts[script]); + if (workspaces.length) npm('run', script, ...workspaces.flatMap(({ name }) => ['-w', name])); + } + const files = [...new Set(diff)].filter((path) => existsSync(resolve(root, path))); + const styles = files.filter( + (path) => /\.(?:css|scss|sass|vue)$/u.test(path) && !/^packages\/(?:css|utilities)\/src\//u.test(path), + ); + const markup = files.filter((path) => path.endsWith('.html')); + const markdown = files.filter((path) => path.endsWith('.md')); + if (styles.length) npm('exec', '--offline', '--', 'stylelint', ...styles); + if (markup.length) npm('exec', '--offline', '--', 'htmlhint', ...markup); + if (markdown.length) npm('exec', '--offline', '--', 'markdownlint-cli2', ...markdown); +} + +const testWorkspaces = tests.filter(({ scripts }) => scripts['test:built']); +if (testWorkspaces.length) { + npm('run', 'test:built', ...testWorkspaces.flatMap(({ name }) => ['-w', name])); +} +if (tests.length) npm('run', 'test:ui'); +npm('run', 'check:docs'); + +if (smoke && browser) + execFileSync('bash', ['scripts/visual/run-browser-checks.sh', 'smoke'], { + cwd: root, + stdio: 'inherit', + }); diff --git a/scripts/ci/check-clean-install.mjs b/scripts/ci/check-clean-install.mjs deleted file mode 100644 index 3cb5a882..00000000 --- a/scripts/ci/check-clean-install.mjs +++ /dev/null @@ -1,43 +0,0 @@ -import { execFileSync } from 'node:child_process'; -import { cpSync, mkdtempSync, rmSync } from 'node:fs'; -import { tmpdir } from 'node:os'; -import { join, relative, sep } from 'node:path'; - -const repositoryRoot = process.cwd(); -const temporaryDirectory = mkdtempSync(join(tmpdir(), 'vueforge-clean-install-')); -const temporaryRepository = join(temporaryDirectory, 'repository'); -const ignoredDirectoryNames = new Set(['.git', '.npm-cache', 'coverage', 'dist', 'node_modules']); - -function shouldCopy(source) { - const sourceRelativePath = relative(repositoryRoot, source); - - return !sourceRelativePath.split(sep).some((pathSegment) => ignoredDirectoryNames.has(pathSegment)); -} - -function validateDependencyGraph(cwd) { - try { - execFileSync('npm', ['ls', '--all'], { - cwd, - stdio: ['ignore', 'pipe', 'pipe'], - }); - } catch (error) { - if (error.stdout) { - process.stderr.write(error.stdout); - } - if (error.stderr) { - process.stderr.write(error.stderr); - } - throw new Error('Clean install produced an invalid dependency graph.', { cause: error }); - } -} - -try { - cpSync(repositoryRoot, temporaryRepository, { filter: shouldCopy, recursive: true }); - execFileSync('npm', ['ci', '--ignore-scripts', '--no-audit', '--no-fund'], { - cwd: temporaryRepository, - stdio: 'inherit', - }); - validateDependencyGraph(temporaryRepository); -} finally { - rmSync(temporaryDirectory, { force: true, recursive: true }); -} diff --git a/scripts/ci/check-documentation-contracts.mjs b/scripts/ci/check-documentation-contracts.mjs index 181484bc..4f486ee7 100644 --- a/scripts/ci/check-documentation-contracts.mjs +++ b/scripts/ci/check-documentation-contracts.mjs @@ -9,7 +9,21 @@ import { historicalComponentEntries, historicalComponentPattern } from '../build import { isDocumentationScriptLanguage } from './documentation-fences.mjs'; const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..'); -const ignoredDirectoryNames = new Set(['.git', '.npm-cache', 'build', 'coverage', 'dist', 'node_modules', 'vendor']); +const ignoredDirectoryNames = new Set([ + '.cache', + '.generated', + '.git', + '.npm-cache', + '.release-artifacts', + '.vite', + 'artifacts', + 'build', + 'coverage', + 'dist', + 'node_modules', + 'showcase-dist', + 'vendor', +]); // These archived releases were verified separately for applications that rely on the old layout // plugin, presets, and entry points. Keep the exception scoped to the pinned install example. const archivedLayoutDependencies = new Set([ diff --git a/scripts/ci/check-documentation-examples.mjs b/scripts/ci/check-documentation-examples.mjs index 40be1f15..fdaa28e7 100644 --- a/scripts/ci/check-documentation-examples.mjs +++ b/scripts/ci/check-documentation-examples.mjs @@ -8,7 +8,21 @@ import ts from 'typescript'; import { resolveContainedPath, resolveVirtualFilePath } from './documentation-example-paths.mjs'; const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..'); -const ignoredDirectoryNames = new Set(['.git', '.npm-cache', 'build', 'coverage', 'dist', 'node_modules']); +const ignoredDirectoryNames = new Set([ + '.cache', + '.generated', + '.git', + '.npm-cache', + '.release-artifacts', + '.vite', + 'artifacts', + 'build', + 'coverage', + 'dist', + 'node_modules', + 'showcase-dist', + 'vendor', +]); const temporaryRoot = path.join(repositoryRoot, '.npm-cache'); mkdirSync(temporaryRoot, { recursive: true }); const temporaryDirectory = mkdtempSync(path.join(temporaryRoot, 'vueforge-documentation-examples-')); diff --git a/scripts/ci/check-verify-coverage.mjs b/scripts/ci/check-verify-coverage.mjs deleted file mode 100644 index 67b07ee8..00000000 --- a/scripts/ci/check-verify-coverage.mjs +++ /dev/null @@ -1,84 +0,0 @@ -import { readFileSync } from 'node:fs'; -import { resolve } from 'node:path'; -import { load as parseYaml } from 'js-yaml'; -import { - findStaleCiOnlyDeclarations, - findUncoveredJobs, - findUncoveredVerifySteps, - findVerifyGaps, - parseVerifySteps, -} from './verify-coverage.mjs'; - -/** - * CI steps `verify` deliberately does not run, each with the reason it cannot. - * - * Anything CI runs that is not here and not in `verify` is reported, because "verify passed" is - * what everyone reads as "this branch is good" — and twice now that reading was wrong. - */ -const ciOnlyJobs = { - visual: - 'downloads a pinned Chrome build and captures against live servers; a different browser reports differences that are not real', -}; - -const ciOnlySteps = { - 'visual:cross-platform:capture': - 'drives a pinned Chrome build against the live fixture server; a different browser reports differences that are not real', - 'visual:cross-platform:serve': 'serves the cross-platform cases for a pinned browser to capture', -}; - -const repositoryRoot = resolve(import.meta.dirname, '../..'); -const workflowPath = resolve(repositoryRoot, '.github/workflows/ci.yml'); -const manifest = JSON.parse(readFileSync(resolve(repositoryRoot, 'package.json'), 'utf8')); -const verifyScript = manifest.scripts?.verify; - -if (typeof verifyScript !== 'string' || verifyScript.trim() === '') { - console.error('[verify-coverage] The root package.json must define a verify script.'); - process.exit(1); -} - -const workflowText = readFileSync(workflowPath, 'utf8'); -const uncovered = findUncoveredVerifySteps(verifyScript, workflowText); -const gaps = findVerifyGaps(verifyScript, workflowText, ciOnlySteps); -const uncoveredJobs = findUncoveredJobs(verifyScript, parseYaml(workflowText).jobs ?? {}, ciOnlyJobs); - -if (uncoveredJobs.length > 0) { - console.error('[verify-coverage] A CI job runs nothing verify runs, and is not declared CI-only:'); - for (const job of uncoveredJobs) { - console.error(`[verify-coverage] ${job}`); - } - process.exit(1); -} -const stale = findStaleCiOnlyDeclarations(verifyScript, workflowText, ciOnlySteps); - -if (gaps.length > 0) { - console.error('[verify-coverage] CI runs steps verify does not, and none of them is declared CI-only.'); - for (const step of gaps) { - console.error(`[verify-coverage] only CI runs: npm run ${step}`); - } - console.error('[verify-coverage] Add it to verify, or declare it in ciOnlySteps with the reason it cannot run.'); - process.exit(1); -} - -if (stale.length > 0) { - console.error('[verify-coverage] A declared CI-only step no longer needs the exception:'); - for (const step of stale) { - console.error(`[verify-coverage] ${step}`); - } - process.exit(1); -} - -if (uncovered.length > 0) { - console.error( - '[verify-coverage] CI splits verify across jobs, so every verify step must run in some job.', - ); - for (const step of uncovered) { - console.error(`[verify-coverage] no job runs: npm run ${step}`); - } - console.error('[verify-coverage] Add the step to a job in .github/workflows/ci.yml.'); - process.exit(1); -} - -console.log( - `[verify-coverage] OK: all ${parseVerifySteps(verifyScript).length} verify step(s) run in CI, and the ` + - `${Object.keys(ciOnlySteps).length} step(s) and ${Object.keys(ciOnlyJobs).length} job(s) only CI runs are declared with a reason.`, -); diff --git a/scripts/ci/code-monster-ui-workspaces.mjs b/scripts/ci/code-monster-ui-workspaces.mjs index f498eae7..efa15126 100644 --- a/scripts/ci/code-monster-ui-workspaces.mjs +++ b/scripts/ci/code-monster-ui-workspaces.mjs @@ -44,3 +44,47 @@ export function discoverCodeMonsterUiWorkspaces(packagesDirectory) { (left, right) => left.releaseOrder - right.releaseOrder || left.name.localeCompare(right.name), ); } + +// Include published dependants in tests and build the prerequisites of everything selected. +export function selectWorkspaceChecks(packages, examples, changedPaths, smoke = false) { + const all = [...packages, ...examples]; + const markdownOnly = /^(?:docs\/.*\.md|AGENTS\.md|ARCHITECTURE\.md|README\.md)$/u; + const sharedShowcase = 'examples/shared/'; + const owners = changedPaths?.filter((path) => !markdownOnly.test(path)); + const full = + !owners || + owners.some((path) => !path.startsWith(sharedShowcase) && !all.some(({ path: dir }) => path.startsWith(dir + '/'))); + const affected = new Set( + all.filter( + ({ path, private: example }) => + full || owners.some((file) => file.startsWith(path + '/') || (example && file.startsWith(sharedShowcase))), + ), + ); + + for (const workspace of affected) { + for (const candidate of packages) { + if (candidate.dependencies.includes(workspace.name)) affected.add(candidate); + } + } + + // The shared browser fixture imports every component package except Utilities. + const browser = full || [...affected].some(({ path }) => path !== 'packages/utilities'); + const builds = new Set(affected); + if (smoke && browser) { + for (const workspace of packages) { + if (workspace.path !== 'packages/utilities') builds.add(workspace); + } + } + for (const workspace of builds) { + for (const dependency of packages) { + if (workspace.dependencies.includes(dependency.name)) builds.add(dependency); + } + } + + return { + full, + tests: all.filter((workspace) => affected.has(workspace)), + builds: all.filter((workspace) => builds.has(workspace)), + browser, + }; +} diff --git a/scripts/ci/code-monster-ui-workspaces.test.mjs b/scripts/ci/code-monster-ui-workspaces.test.mjs index 1a9a1de7..e2a913a2 100644 --- a/scripts/ci/code-monster-ui-workspaces.test.mjs +++ b/scripts/ci/code-monster-ui-workspaces.test.mjs @@ -3,7 +3,7 @@ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'; import { tmpdir } from 'node:os'; import { join } from 'node:path'; import test from 'node:test'; -import { discoverCodeMonsterUiWorkspaces } from './code-monster-ui-workspaces.mjs'; +import { discoverCodeMonsterUiWorkspaces, selectWorkspaceChecks } from './code-monster-ui-workspaces.mjs'; function createPackages(manifests) { const packagesDirectory = mkdtempSync(join(tmpdir(), 'codemonster-ui-workspaces-')); @@ -51,3 +51,50 @@ test('rejects an unregistered CodeMonster UI workspace', (context) => { /is not registered in the CodeMonster UI package catalog/, ); }); + +const packages = [ + { name: 'tokens', path: 'packages/tokens', dependencies: [] }, + { name: 'runtime', path: 'packages/runtime', dependencies: [] }, + { name: 'icons', path: 'packages/icons', dependencies: [] }, + { name: 'utilities', path: 'packages/utilities', dependencies: ['tokens'] }, + { name: 'vue', path: 'packages/vue', dependencies: ['icons', 'runtime', 'tokens'] }, + { name: 'layouts', path: 'packages/layouts', dependencies: ['vue'] }, +]; +const examples = [ + { name: 'showcase', path: 'examples/ui-showcase', private: true, dependencies: ['layouts', 'utilities'] }, + { name: 'vanilla', path: 'examples/vanilla', private: true, dependencies: ['runtime'] }, +]; +const names = (workspaces) => workspaces.map(({ name }) => name); + +test('tests changed packages and their dependants while only building prerequisites', () => { + const plan = selectWorkspaceChecks(packages, examples, ['packages/runtime/src/index.ts']); + assert.equal(plan.full, false); + assert.deepEqual(names(plan.tests), ['runtime', 'vue', 'layouts']); + assert.deepEqual(names(plan.builds), ['tokens', 'runtime', 'icons', 'vue', 'layouts']); +}); + +test('adds component fixture prerequisites only when browser smoke needs them', () => { + const utilities = selectWorkspaceChecks(packages, examples, ['packages/utilities/src/index.css'], true); + assert.equal(utilities.browser, false); + assert.deepEqual(names(utilities.builds), ['tokens', 'utilities']); + + const vanilla = selectWorkspaceChecks(packages, examples, ['examples/vanilla/index.html'], true); + assert.equal(vanilla.browser, true); + assert.deepEqual(names(vanilla.tests), ['vanilla']); + assert.deepEqual(names(vanilla.builds), ['tokens', 'runtime', 'icons', 'vue', 'layouts', 'vanilla']); +}); + +test('checks the full graph for shared contracts or configuration and skips builds for docs', () => { + for (const path of ['tsconfig.base.json', 'package-lock.json', 'contracts/button/manifest.json']) { + const plan = selectWorkspaceChecks(packages, examples, [path]); + assert.equal(plan.full, true); + assert.deepEqual(plan.tests, [...packages, ...examples]); + } + const docs = selectWorkspaceChecks(packages, examples, ['README.md', 'docs/vanilla.md'], true); + assert.equal(docs.browser, false); + assert.deepEqual(docs.builds, []); + + const shared = selectWorkspaceChecks(packages, examples, ['examples/shared/showcase.css']); + assert.equal(shared.full, false); + assert.deepEqual(shared.tests, examples); +}); diff --git a/scripts/ci/prepare-release-from-tag.mjs b/scripts/ci/prepare-release-from-tag.mjs index a83bccab..3309499d 100644 --- a/scripts/ci/prepare-release-from-tag.mjs +++ b/scripts/ci/prepare-release-from-tag.mjs @@ -111,7 +111,7 @@ if (!releaseNotes) { fail(`Changelog section for ${versionFromTag} is empty in ${packageDir}/CHANGELOG.md.`); } -const releaseNotesPath = path.join(rootDir, '.release-notes.md'); +const releaseNotesPath = process.env.RELEASE_NOTES_PATH ?? path.join(rootDir, '.release-notes.md'); fs.writeFileSync(releaseNotesPath, `# ${packageName}@${versionFromTag}\n\n## Changes\n\n${releaseNotes}\n`, 'utf8'); const output = [ diff --git a/scripts/ci/run-code-monster-ui-workspaces.mjs b/scripts/ci/run-code-monster-ui-workspaces.mjs index a7fa6525..f54493a2 100644 --- a/scripts/ci/run-code-monster-ui-workspaces.mjs +++ b/scripts/ci/run-code-monster-ui-workspaces.mjs @@ -3,7 +3,7 @@ import { dirname, join } from 'node:path'; import { fileURLToPath } from 'node:url'; import { discoverCodeMonsterUiWorkspaces } from './code-monster-ui-workspaces.mjs'; -const allowedScripts = new Set(['build', 'check', 'pack:dry-run']); +const allowedScripts = new Set(['build', 'pack:dry-run']); const script = process.argv[2]; if (!allowedScripts.has(script)) { diff --git a/scripts/ci/test-without-dist.sh b/scripts/ci/test-without-dist.sh deleted file mode 100755 index 39e8a942..00000000 --- a/scripts/ci/test-without-dist.sh +++ /dev/null @@ -1,47 +0,0 @@ -#!/bin/sh -set -u - -root_dir=$(cd "$(dirname "$0")/../.." && pwd) -tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/vueforge-test-without-dist.XXXXXX") -rc=0 - -restore_dist() { - for workspace_dir in "$root_dir"/packages/* "$root_dir"/examples/*; do - if [ ! -f "$workspace_dir/package.json" ]; then - continue - fi - - relative_dir=${workspace_dir#"$root_dir"/} - if [ -d "$workspace_dir/dist" ]; then - mkdir -p "$tmp_dir/generated/$relative_dir" - mv "$workspace_dir/dist" "$tmp_dir/generated/$relative_dir/dist" - fi - - if [ -d "$tmp_dir/$relative_dir/dist" ]; then - mv "$tmp_dir/$relative_dir/dist" "$workspace_dir/dist" - fi - done - - rm -rf "$tmp_dir" -} - -trap restore_dist EXIT INT TERM - -for workspace_dir in "$root_dir"/packages/* "$root_dir"/examples/*; do - if [ ! -f "$workspace_dir/package.json" ] || [ ! -d "$workspace_dir/dist" ]; then - continue - fi - - relative_dir=${workspace_dir#"$root_dir"/} - mkdir -p "$tmp_dir/$relative_dir" - mv "$workspace_dir/dist" "$tmp_dir/$relative_dir/dist" -done - -cd "$root_dir" || exit 1 - -# A workspace may test a sibling package's built public entry. Rebuild from empty dist directories -# in release order before npm runs the workspace tests in its own order. -npm run build:ui || exit $? -npm run test --workspaces --if-present || rc=$? - -exit "$rc" diff --git a/scripts/ci/verify-chain.test.mjs b/scripts/ci/verify-chain.test.mjs deleted file mode 100644 index 2881d9d7..00000000 --- a/scripts/ci/verify-chain.test.mjs +++ /dev/null @@ -1,18 +0,0 @@ -import assert from 'node:assert/strict'; -import { readFileSync } from 'node:fs'; -import { resolve } from 'node:path'; -import test from 'node:test'; - -const manifest = JSON.parse(readFileSync(resolve(import.meta.dirname, '../../package.json'), 'utf8')); - -test('verifies the contract, accessibility, and visual fixture suites', () => { - // These suites guard the canonical component cases. They ran outside the release chain once and - // collected seventeen selector violations that nothing reported. - const verify = manifest.scripts.verify; - assert.match(verify, /npm run test:ui\b/u); - - const uiSuite = manifest.scripts['test:ui']; - for (const required of ['check:ui-contracts', 'check:ui-accessibility', 'check:ui-visual-fixtures']) { - assert.match(uiSuite, new RegExp(`npm run ${required.replace(':', ':')}\\b`, 'u')); - } -}); diff --git a/scripts/ci/verify-coverage.mjs b/scripts/ci/verify-coverage.mjs deleted file mode 100644 index 6cce2389..00000000 --- a/scripts/ci/verify-coverage.mjs +++ /dev/null @@ -1,87 +0,0 @@ -const npmRunPattern = /npm run ([A-Za-z0-9:_-]+)/gu; - -function collectNpmScripts(source) { - if (typeof source !== 'string') { - return []; - } - - return [...source.matchAll(npmRunPattern)].map((match) => match[1]); -} - -/** - * Reads the ordered `npm run` steps the root `verify` script chains together. - */ -export function parseVerifySteps(verifyScript) { - return [...new Set(collectNpmScripts(verifyScript))]; -} - -/** - * Reads every `npm run` step any workflow job executes. - */ -export function parseWorkflowScripts(workflowText) { - return new Set(collectNpmScripts(workflowText)); -} - -/** - * Reports the `verify` steps no workflow job runs, in `verify` order. - */ -export function findUncoveredVerifySteps(verifyScript, workflowText, coveredElsewhere = {}) { - const workflowScripts = parseWorkflowScripts(workflowText); - const declared = new Set(Object.keys(coveredElsewhere)); - return parseVerifySteps(verifyScript).filter( - (step) => !workflowScripts.has(step) && !declared.has(step), - ); -} - -/** - * Reports the CI steps `verify` does not run, excluding ones declared as CI-only. - * - * This is the direction that actually bites. `verify` passing locally reads as "this branch is - * good", and every step CI runs that `verify` does not is a way for that reading to be wrong. A - * step may legitimately be CI-only — a pinned browser, a container — but that has to be a written - * decision rather than something nobody noticed. - */ -export function findVerifyGaps(verifyScript, workflowText, ciOnlySteps = {}) { - const covered = new Set(parseVerifySteps(verifyScript)); - const declared = new Set(Object.keys(ciOnlySteps)); - - return [...parseWorkflowScripts(workflowText)] - .filter((step) => !covered.has(step) && !declared.has(step)) - .sort(); -} - -/** - * Reports declared CI-only exceptions that no longer describe anything, so the list cannot rot into - * a record of steps that were moved into `verify` years ago. - */ -export function findStaleCiOnlyDeclarations(verifyScript, workflowText, ciOnlySteps = {}) { - const covered = new Set(parseVerifySteps(verifyScript)); - const workflowScripts = parseWorkflowScripts(workflowText); - - return Object.keys(ciOnlySteps) - .filter((step) => !workflowScripts.has(step) || covered.has(step)) - .sort(); -} - -/** - * Reports CI jobs that run no `verify` step at all and are not declared. - * - * A job built entirely from commands that are not `npm run` — a container, a browser download — is - * invisible to the step-level checks above. A container-only job has that shape, which is how - * "verify is green" came to mean less than it looked like it meant. - */ -export function findUncoveredJobs(verifyScript, jobs, ciOnlyJobs = {}) { - const covered = new Set(parseVerifySteps(verifyScript)); - const declared = new Set(Object.keys(ciOnlyJobs)); - - return Object.entries(jobs) - .filter(([name, job]) => { - if (declared.has(name)) return false; - const steps = collectNpmScripts( - (job?.steps ?? []).map((step) => step?.run ?? '').join('\n'), - ); - return !steps.some((step) => covered.has(step)); - }) - .map(([name]) => name) - .sort(); -} diff --git a/scripts/ci/verify-coverage.test.mjs b/scripts/ci/verify-coverage.test.mjs deleted file mode 100644 index afa46305..00000000 --- a/scripts/ci/verify-coverage.test.mjs +++ /dev/null @@ -1,97 +0,0 @@ -import assert from 'node:assert/strict'; -import test from 'node:test'; -import { - findStaleCiOnlyDeclarations, - findUncoveredJobs, - findUncoveredVerifySteps, - findVerifyGaps, - parseVerifySteps, - parseWorkflowScripts, -} from './verify-coverage.mjs'; - -test('reads the chained verify steps in order without duplicates', () => { - const verify = 'npm run lint:all && npm run build && npm run typecheck && npm run build'; - assert.deepEqual(parseVerifySteps(verify), ['lint:all', 'build', 'typecheck']); -}); - -test('reads every npm run step a workflow executes', () => { - const workflow = ` -jobs: - lint: - steps: - - run: npm run lint:all - packaging: - steps: - - run: npm run build - - run: npm run check:package-contracts -`; - assert.deepEqual([...parseWorkflowScripts(workflow)].sort(), [ - 'build', - 'check:package-contracts', - 'lint:all', - ]); -}); - -test('reports verify steps no job runs', () => { - const verify = 'npm run lint:all && npm run typecheck && npm run check:deferred-budgets'; - const workflow = ' - run: npm run lint:all\n'; - assert.deepEqual(findUncoveredVerifySteps(verify, workflow), ['typecheck', 'check:deferred-budgets']); -}); - -test('accepts a workflow that covers every verify step across separate jobs', () => { - const verify = 'npm run lint:all && npm run typecheck'; - const workflow = ` -jobs: - lint: - steps: - - run: npm run lint:all - typecheck: - steps: - - run: npm run typecheck -`; - assert.deepEqual(findUncoveredVerifySteps(verify, workflow), []); -}); - -test('ignores npm run steps a workflow adds beyond verify', () => { - const verify = 'npm run lint:all'; - const workflow = ' - run: npm run lint:all\n - run: npm run check:verify-coverage\n'; - assert.deepEqual(findUncoveredVerifySteps(verify, workflow), []); -}); - -test('reports a CI step verify does not run', () => { - const verify = 'npm run lint:all'; - const workflow = ' - run: npm run lint:all\n - run: npm run pack:all:dry-run\n'; - assert.deepEqual(findVerifyGaps(verify, workflow), ['pack:all:dry-run']); -}); - -test('accepts a CI-only step once it is declared', () => { - const verify = 'npm run lint:all'; - const workflow = ' - run: npm run lint:all\n - run: npm run dev\n'; - assert.deepEqual(findVerifyGaps(verify, workflow, { dev: 'starts a server' }), []); -}); - -test('reports a declared exception that no longer describes anything', () => { - const verify = 'npm run lint:all'; - const workflow = ' - run: npm run lint:all\n'; - assert.deepEqual(findStaleCiOnlyDeclarations(verify, workflow, { gone: 'removed long ago' }), ['gone']); - assert.deepEqual(findStaleCiOnlyDeclarations(verify, workflow, { 'lint:all': 'now in verify' }), ['lint:all']); -}); - -test('reports a job built from commands that are not npm run', () => { - const jobs = { - lint: { steps: [{ run: 'npm run lint:all' }] }, - integration: { steps: [{ run: 'docker run test-runner run-checks' }] }, - }; - assert.deepEqual(findUncoveredJobs('npm run lint:all', jobs), ['integration']); - assert.deepEqual(findUncoveredJobs('npm run lint:all', jobs, { integration: 'runs in a container' }), []); -}); - -test('treats a verify step CI covers by other means as covered', () => { - const verify = 'npm run lint:all && npm run check:integration-package'; - const workflow = ' - run: npm run lint:all\n'; - assert.deepEqual(findUncoveredVerifySteps(verify, workflow), ['check:integration-package']); - assert.deepEqual( - findUncoveredVerifySteps(verify, workflow, { 'check:integration-package': 'a container runs it' }), - [], - ); -}); diff --git a/scripts/visual/check-vanilla-parity.mjs b/scripts/visual/check-vanilla-parity.mjs index 9d8245b6..f77e7105 100644 --- a/scripts/visual/check-vanilla-parity.mjs +++ b/scripts/visual/check-vanilla-parity.mjs @@ -9,6 +9,24 @@ import { collectComponentCases } from '../contracts/component-cases.mjs'; const chromePath = process.env.CHROME_PATH ?? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'; const origin = process.env.CM_PARITY_ORIGIN ?? 'http://127.0.0.1:5176'; +const requested = process.argv.slice(2); +const contractsDirectory = resolve(import.meta.dirname, '../../contracts'); +let behaviorScenarios; +if (process.env.CM_PARITY_BEHAVIOR === '1') { + const { scenarios, errors } = collectBehaviorScenarios(contractsDirectory); + if (errors.length) throw new Error(errors.join('\n')); + const unknown = requested.filter((id) => !scenarios.some(({ data }) => data.id === id)); + if (unknown.length) throw new Error(`Unknown browser behavior scenario(s): ${unknown.join(', ')}`); + behaviorScenarios = scenarios.filter(({ data }) => !requested.length || requested.includes(data.id)); + if (!behaviorScenarios.length) throw new Error('No browser behavior scenarios selected.'); +} +const visualCases = behaviorScenarios ? undefined : collectComponentCases(contractsDirectory); +if (visualCases) { + const { cases, errors } = visualCases; + if (errors.length) throw new Error(errors.join('\n')); + const unknown = requested.filter((id) => !cases.some((componentCase) => componentCase.id === id)); + if (unknown.length) throw new Error(`Unknown browser visual case(s): ${unknown.join(', ')}`); +} const profile = await mkdtemp(join(tmpdir(), 'cm-vanilla-chrome-')); const chrome = spawn( chromePath, @@ -85,12 +103,7 @@ try { await send('Emulation.setLocaleOverride', { locale: 'en-US' }); await send('Emulation.setEmulatedMedia', { features: [{ name: 'prefers-reduced-motion', value: 'reduce' }] }); await send('Emulation.setDeviceMetricsOverride', { width: 360, height: 660, deviceScaleFactor: 1, mobile: false }); - const { cases, errors } = collectComponentCases(resolve(import.meta.dirname, '../../contracts')); - if (process.env.CM_PARITY_BEHAVIOR === '1') { - const { scenarios, errors: scenarioErrors } = collectBehaviorScenarios( - resolve(import.meta.dirname, '../../contracts'), - ); - if (scenarioErrors.length) throw new Error(scenarioErrors.join('\n')); + if (behaviorScenarios) { await send('Emulation.setEmulatedMedia', { features: [{ name: 'prefers-reduced-motion', value: 'no-preference' }], }); @@ -126,9 +139,7 @@ try { observer.observe(dialog, { attributes: true, attributeFilter: ['open'] }); })()`; const result = []; - for (const { componentSlug, data } of scenarios.filter( - ({ data }) => !process.argv[2] || process.argv.slice(2).includes(data.id), - )) { + for (const { componentSlug, data } of behaviorScenarios) { for (const platform of ['vue', 'vanilla']) { const row = { scenario: data.id, platform, failures: [], motion: [] }; result.push(row); @@ -288,11 +299,10 @@ try { ); if (result.some(({ failures }) => failures.length) || motionMismatches.length) process.exitCode = 1; } else { - if (errors.length) throw new Error(errors.join('\n')); - const selected = process.argv.slice(2); + const { cases } = visualCases; const report = []; const animatedCases = new Set(); - for (const componentCase of cases.filter(({ id }) => !selected.length || selected.includes(id))) { + for (const componentCase of cases.filter(({ id }) => !requested.length || requested.includes(id))) { const { id, componentSlug } = componentCase; for (const theme of ['light', 'dark']) { const result = { id, componentSlug, theme }; diff --git a/scripts/visual/cross-platform-baselines.test.mjs b/scripts/visual/cross-platform-baselines.test.mjs index a33a676f..b0ba1d9b 100644 --- a/scripts/visual/cross-platform-baselines.test.mjs +++ b/scripts/visual/cross-platform-baselines.test.mjs @@ -1,4 +1,5 @@ import assert from 'node:assert/strict'; +import { readFileSync, readdirSync } from 'node:fs'; import { resolve } from 'node:path'; import test from 'node:test'; import { collectComponentCases } from '../contracts/component-cases.mjs'; @@ -96,4 +97,12 @@ test('builds the reviewed repository first slice for both adapters', () => { ); assert.deepEqual(new Set(fixtures.map(({ platform }) => platform)), new Set(['vue', 'vanilla'])); assert.equal(new Set(fixtures.map(({ baselineId }) => baselineId)).size, 48); + const stored = resolve(import.meta.dirname, '../../visual-baselines/vueforge-cross-platform'); + const storedManifest = JSON.parse(readFileSync(resolve(stored, 'manifest.json'), 'utf8')); + assert.equal(storedManifest.referenceCommit, fixtures[0].baselineId.split('/')[0]); + assert.deepEqual(new Set(storedManifest.sourceFixture.caseIds), new Set(fixtures.map(({ caseId }) => caseId))); + assert.deepEqual( + new Set(readdirSync(stored).filter((name) => name.endsWith('.png'))), + new Set(fixtures.map(({ snapshotPath }) => snapshotPath.split('/').at(-1))), + ); }); diff --git a/scripts/visual/cross-platform-browser.test.mjs b/scripts/visual/cross-platform-browser.test.mjs deleted file mode 100644 index 7dd3be1f..00000000 --- a/scripts/visual/cross-platform-browser.test.mjs +++ /dev/null @@ -1,69 +0,0 @@ -import assert from 'node:assert/strict'; -import { readdirSync, readFileSync } from 'node:fs'; -import { resolve } from 'node:path'; -import test from 'node:test'; - -const read = (path) => readFileSync(resolve(import.meta.dirname, path), 'utf8'); - -test('mounts the Vue component and enhances canonical HTML with the Vanilla runtime', () => { - const vueFixture = read('cross-platform-fixture/main.ts'); - const server = read('serve-cross-platform-cases.mjs'); - - assert.match(vueFixture, /import \* as UiVue from '@codemonster-ru\/ui-vue';/u); - assert.match(vueFixture, /import\.meta\.glob/u); - assert.match(vueFixture, /createApp\(/u); - assert.match(vueFixture, /\.mount\(root\)/u); - assert.match(vueFixture, /componentCase\.props/u); - assert.match(vueFixture, /componentCase\.slots/u); - assert.match(vueFixture, /createStaticVNode/u); - assert.match(server, /response.end\(componentCase.canonicalHtml\)/u); - assert.match(vueFixture, /createRuntime\(\).start\(root\)/u); - assert.doesNotMatch(vueFixture, /canonicalHtml|default\.html/u); -}); - -test('keeps one baseline filename matrix for both current platforms', () => { - const capture = read('capture-cross-platform-cases.mjs'); - const fixtureCss = read('cross-platform-fixture/fixture.css'); - - assert.match(capture, /const platforms = \['vue', 'vanilla'\];/u); - assert.match(capture, /\$\{caseId\}--\$\{theme\.name\}--\$\{viewport\.name\}\.png/u); - assert.match(capture, /routes: caseIds/u); - // compare-showcase.mjs requires an exact match on referenceCommit between the baseline manifest - // and the current one. Dropping this from the generated manifest passed every local check -- - // verify never runs the live browser capture -- and only failed in CI, against a real baseline. - assert.match(capture, /referenceCommit: config\.reference\.commit/u); - assert.match(fixtureCss, /\.cm-visual-adapter-root \{[^}]*line-height: normal;/su); -}); - -test('checks both platforms against the reviewed fd baseline in macOS visual CI', () => { - const workflow = read('../../.github/workflows/ci.yml'); - const baselineDirectory = resolve(import.meta.dirname, '../../visual-baselines/vueforge-cross-platform'); - const baselineManifest = JSON.parse(readFileSync(resolve(baselineDirectory, 'manifest.json'), 'utf8')); - const screenshots = readdirSync(baselineDirectory).filter((filename) => filename.endsWith('.png')); - - assert.equal(baselineManifest.referenceCommit, 'fd793696f50d3be0fcd3788f0f8f751c63869963'); - assert.deepEqual(baselineManifest.sourceFixture, { - caseIds: [ - 'alert-danger-icon', - 'avatar-label', - 'badge-danger', - 'button-default', - 'card-title', - 'divider-horizontal', - 'link-default', - 'field-help-error', - 'input-enhanced', - 'select-clearable', - 'date-picker-clearable', - 'checkbox-checked', - ], - componentPackage: '@codemonster-ru/vueforge-core', - renderer: 'Vue createApp at the reference commit', - }); - assert.equal(screenshots.length, 48); - assert.match(workflow, /runs-on: macos-26/u); - assert.match(workflow, /visual:cross-platform:serve/u); - assert.match(workflow, /CM_PARITY_BEHAVIOR=1 node scripts\/visual\/check-vanilla-parity.mjs/u); - assert.match(workflow, /current="\$\{CROSS_PLATFORM_CAPTURE\}\/vue"/u); - assert.match(workflow, /current="\$\{CROSS_PLATFORM_CAPTURE\}\/vanilla"/u); -}); diff --git a/scripts/visual/run-browser-checks.sh b/scripts/visual/run-browser-checks.sh new file mode 100644 index 00000000..a0927f9f --- /dev/null +++ b/scripts/visual/run-browser-checks.sh @@ -0,0 +1,70 @@ +#!/usr/bin/env bash +set -euo pipefail + +mode=${1:-smoke} +if [[ "$mode" != smoke && "$mode" != release ]]; then + echo "Usage: $0 [smoke|release]" >&2 + exit 2 +fi + +port=${CM_VISUAL_PORT:-5176} +origin="http://127.0.0.1:${port}" +output=${CM_BROWSER_OUTPUT:-} +keep_output=true +if [[ -z "$output" ]]; then + output=$(mktemp -d) + keep_output=false +fi +mkdir -p "$output" +export CHROME_PATH=${CHROME_PATH:-google-chrome} +export CM_PARITY_ORIGIN="$origin" + +node scripts/visual/serve-cross-platform-cases.mjs --port="$port" > "$output/fixture.log" 2>&1 & +fixture_pid=$! +chrome_pid= +cleanup() { + kill "$fixture_pid" 2>/dev/null || true + if [[ -n "$chrome_pid" ]]; then + kill "$chrome_pid" 2>/dev/null || true + fi + wait "$fixture_pid" 2>/dev/null || true + if [[ -n "$chrome_pid" ]]; then + wait "$chrome_pid" 2>/dev/null || true + fi + if [[ "$keep_output" = false ]]; then + rm -rf "$output" + fi +} +trap cleanup EXIT + +ready() { + for ((attempt=0; attempt<60; attempt++)); do + kill -0 "$1" 2>/dev/null && curl --fail --silent "$2" >/dev/null && return 0 + kill -0 "$1" 2>/dev/null || break + sleep 1 + done + cat "$3" >&2 + return 1 +} +ready "$fixture_pid" "$origin/?case=button-default&platform=vue&theme=light" "$output/fixture.log" + +if [[ "$mode" = smoke ]]; then + CM_PARITY_BEHAVIOR=1 CM_PARITY_REPORT="$output/behavior.json" node scripts/visual/check-vanilla-parity.mjs \ + dialog-focus-trap dialog-escape tabs-focus-navigation date-picker-change-submission + exit +fi + +"$CHROME_PATH" --headless=new --remote-debugging-port=9226 --user-data-dir="$output/chrome-profile" \ + --disable-gpu --no-first-run --no-default-browser-check about:blank > "$output/chrome.log" 2>&1 & +chrome_pid=$! +ready "$chrome_pid" http://127.0.0.1:9226/json/version "$output/chrome.log" + +node scripts/visual/capture-cross-platform-cases.mjs --origin="$origin" --output="$output/capture" --label=release +result=0 +for platform in vue vanilla; do + node scripts/visual/compare-showcase.mjs --baseline=visual-baselines/vueforge-cross-platform \ + --current="$output/capture/$platform" --diff="$output/diff-$platform" --threshold=4 || result=1 +done +CM_PARITY_REPORT="$output/parity.json" node scripts/visual/check-vanilla-parity.mjs || result=1 +CM_PARITY_BEHAVIOR=1 CM_PARITY_REPORT="$output/behavior.json" node scripts/visual/check-vanilla-parity.mjs || result=1 +exit "$result" diff --git a/visual-baselines/README.md b/visual-baselines/README.md index eca75d73..7e9ddca2 100644 --- a/visual-baselines/README.md +++ b/visual-baselines/README.md @@ -53,7 +53,8 @@ pixels were originally captured from, back when this comparison proved the migra reproduced it exactly. That provenance stays accurate and is kept for the record; the comparison itself no longer depends on that commit or on anything being checked out from it. -## Current showcase baseline +## Historical showcase design captures -[Showcase excellence v1](showcase-excellence-v1/README.md) records the intentional showcase -layout and composition changes. It is reviewed separately from the historical component baseline. +The completed [v1](https://github.com/codemonster-ru/ui/tree/857c0e396077a7703a6b0b28c7c731fdb7f7befb/visual-baselines/showcase-excellence-v1) and +[v2](https://github.com/codemonster-ru/ui/tree/857c0e396077a7703a6b0b28c7c731fdb7f7befb/visual-baselines/showcase-excellence-v2) showcase captures are available in +Git history. The release workflow compares the cross-platform component fixtures above. diff --git a/visual-baselines/showcase-excellence-v1/README.md b/visual-baselines/showcase-excellence-v1/README.md deleted file mode 100644 index 7928d00d..00000000 --- a/visual-baselines/showcase-excellence-v1/README.md +++ /dev/null @@ -1,22 +0,0 @@ -# Showcase excellence v1 - -These captures record the intentional design of the private showcase after the navigation, -reference, and application examples update. They are a manual review baseline. The -[approved component snapshots](../vueforge-cross-platform/manifest.json) and their CI comparison -remain separate. - -Chrome `157.0.8103.79` captured both production builds on macOS at device pixel ratio 1, with -English (`en-US`) locale and reduced motion. The capture waits for the page, theme and fonts. -File names identify the adapter, route, viewport width, and theme. Heights are 800 CSS pixels on -mobile and 960 on desktop. - -| Route | Review focus | -| -------------------------- | ------------------------------------------------------------------------------------------------- | -| `/core/` | Product introduction, link hierarchy, visible current page, section links, and mobile navigation. | -| `/components/` | Search label and group readability. | -| `/components/button/` | Preview, example and API hierarchy, code containment, and copying affordance. | -| `/components/date-picker/` | Open calendar stays visible inside each adapter's preview. | -| `/examples/` | Readable metrics and data on desktop, visible tabs and reflow on mobile. | - -See the [design and verification report](../../docs/verification/DESIGN-EXCELLENCE.md) for the -before revision, the wider browser matrix, and known accessibility limitations. diff --git a/visual-baselines/showcase-excellence-v1/vanilla--components--360--light.png b/visual-baselines/showcase-excellence-v1/vanilla--components--360--light.png deleted file mode 100644 index 8c552fa9..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--components--360--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla--components-button--360--dark.png b/visual-baselines/showcase-excellence-v1/vanilla--components-button--360--dark.png deleted file mode 100644 index c4dd63b8..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--components-button--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla--core--1440--light.png b/visual-baselines/showcase-excellence-v1/vanilla--core--1440--light.png deleted file mode 100644 index a8917813..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla--core--360--dark.png b/visual-baselines/showcase-excellence-v1/vanilla--core--360--dark.png deleted file mode 100644 index 5b29ee0e..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla--examples--1440--light.png b/visual-baselines/showcase-excellence-v1/vanilla--examples--1440--light.png deleted file mode 100644 index 2d530efd..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--examples--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla--examples--360--dark.png b/visual-baselines/showcase-excellence-v1/vanilla--examples--360--dark.png deleted file mode 100644 index 61d7c620..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla--examples--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vanilla-date-picker-open-1440-dark.png b/visual-baselines/showcase-excellence-v1/vanilla-date-picker-open-1440-dark.png deleted file mode 100644 index 84ebee76..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vanilla-date-picker-open-1440-dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--components--1440--dark.png b/visual-baselines/showcase-excellence-v1/vue--components--1440--dark.png deleted file mode 100644 index e7f5342d..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--components--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--components-button--1440--light.png b/visual-baselines/showcase-excellence-v1/vue--components-button--1440--light.png deleted file mode 100644 index 3513884a..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--components-button--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--core--1440--light.png b/visual-baselines/showcase-excellence-v1/vue--core--1440--light.png deleted file mode 100644 index df00ac7c..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--core--360--dark.png b/visual-baselines/showcase-excellence-v1/vue--core--360--dark.png deleted file mode 100644 index f98631a0..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--examples--1440--light.png b/visual-baselines/showcase-excellence-v1/vue--examples--1440--light.png deleted file mode 100644 index 4d8a94bd..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--examples--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue--examples--360--dark.png b/visual-baselines/showcase-excellence-v1/vue--examples--360--dark.png deleted file mode 100644 index 568a825c..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue--examples--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v1/vue-date-picker-open-1440-dark.png b/visual-baselines/showcase-excellence-v1/vue-date-picker-open-1440-dark.png deleted file mode 100644 index 025035d7..00000000 Binary files a/visual-baselines/showcase-excellence-v1/vue-date-picker-open-1440-dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/README.md b/visual-baselines/showcase-excellence-v2/README.md deleted file mode 100644 index 59bd06f3..00000000 --- a/visual-baselines/showcase-excellence-v2/README.md +++ /dev/null @@ -1,37 +0,0 @@ -# Showcase excellence v2 - -These are viewport captures for the private developer site. They record intentional layout -changes, separate from the [v1 showcase baseline](../showcase-excellence-v1/README.md) and -[approved component snapshots](../vueforge-cross-platform/manifest.json). - -The paired showcase screens were captured from local production builds on macOS with Chrome -`157.0.8103.79` and Playwright `1.61.1`, at device scale factor 1 with reduced motion. -Before-build revision: `ebbb0b9d`. The before documentation images are the Markdown source -renderer from the supplied visual review, captured with Chrome for Testing `151.0.7922.138`. -There was no existing integrated guide route to pair with those two images. The calendar pair -uses an isolated Core build and a viewport centered on the open calendar. - -| View | Before | After | -| ----------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Desktop overview | [Vue](before/vue--core--1440--light.png) · [Vanilla](before/vanilla--core--1440--light.png) | [Vue](after/vue--core--1440--light.png) · [Vanilla](after/vanilla--core--1440--light.png) | -| Narrow overview | [Vue](before/vue--core--360--dark.png) · [Vanilla](before/vanilla--core--360--dark.png) | [Vue](after/vue--core--360--dark.png) · [Vanilla](after/vanilla--core--360--dark.png) | -| Component catalog | [Vue](before/vue--components--1440--light.png) · [Vanilla](before/vanilla--components--1440--light.png) | [Vue](after/vue--components--1440--light.png) · [Vanilla](after/vanilla--components--1440--light.png) | -| Button reference | [Vue](before/vue--button--390--dark.png) · [Vanilla](before/vanilla--button--390--dark.png) | [Vue](after/vue--button--390--dark.png) · [Vanilla](after/vanilla--button--390--dark.png) | -| Documentation | [Markdown light](before/markdown--docs--1440--light.png) · [Markdown dark](before/markdown--docs--1440--dark.png) | [Desktop light](after/vue--docs--1440--light.png) · [Desktop dark](after/vanilla--docs--1440--dark.png) · [Narrow dark](after/vanilla--docs--360--dark.png) | -| Release Workspace | [Desktop Vue](before/vue--workspace--1440--light.png) · [Narrow Vanilla](before/vanilla--workspace--360--dark.png) | [Desktop Vue](after/vue--workspace--1440--light.png) · [Narrow Vanilla](after/vanilla--workspace--360--dark.png) | -| Inline calendar | [Vue](before/vue--calendar--360--light.png) · [Vanilla](before/vanilla--calendar--360--light.png) | [Vue](after/vue--calendar--360--light.png) · [Vanilla](after/vanilla--calendar--360--light.png) | -| Menu and search | No site drawer or unified search | [Narrow menu](after/vue--menu--360--dark.png) · [Narrow search](after/vanilla--search--360--dark.png) · [Desktop search](after/vue--search--1440--dark.png) | - -The overview now puts installation first and retains direct access to the demos. The mobile header -occupies one row. Component cards add a description and keep their category. Detail pages put the -live preview before copyable code and replace dense API rows with a readable list. The workspace -gives deployment status a distinct place and keeps filters and their results together. - -Reproduce the after set by serving both production outputs and running the -[browser matrix](../../scripts/visual/check-showcase-ux.mjs). Install Playwright in a temporary -directory, set `SHOWCASE_PLAYWRIGHT` to its package path and `SHOWCASE_CHROME` to a Chrome -executable. Set `SHOWCASE_CAPTURE_DIR` to a fresh directory to save screenshots. The matrix -defaults to local ports 4173 and 4174; `SHOWCASE_VUE_URL` and `SHOWCASE_VANILLA_URL` override them. - -See the [verification register](../../docs/verification/SHOWCASE-UX-REFINEMENT.md) for acceptance -and coverage limits. diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--button--390--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--button--390--dark.png deleted file mode 100644 index 0a9ade2b..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--button--390--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--calendar--360--light.png b/visual-baselines/showcase-excellence-v2/after/vanilla--calendar--360--light.png deleted file mode 100644 index 7f529068..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--calendar--360--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--components--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vanilla--components--1440--light.png deleted file mode 100644 index b14a9ad6..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--components--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--core--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vanilla--core--1440--light.png deleted file mode 100644 index 011e3008..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--core--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--core--360--dark.png deleted file mode 100644 index b60c3e0b..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--dark.png deleted file mode 100644 index bd24104d..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--light.png deleted file mode 100644 index 5f467cc4..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--docs--360--dark.png deleted file mode 100644 index 8ec0defa..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--docs--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--menu--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--menu--360--dark.png deleted file mode 100644 index 71f8475b..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--menu--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--search--1440--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--search--1440--dark.png deleted file mode 100644 index b40bae81..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--search--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--search--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--search--360--dark.png deleted file mode 100644 index 947801d8..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--search--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--1440--light.png deleted file mode 100644 index f7529cbb..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--360--dark.png deleted file mode 100644 index c9533a4c..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vanilla--workspace--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--button--390--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--button--390--dark.png deleted file mode 100644 index b37d1a8c..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--button--390--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--calendar--360--light.png b/visual-baselines/showcase-excellence-v2/after/vue--calendar--360--light.png deleted file mode 100644 index e6a8a609..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--calendar--360--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--components--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vue--components--1440--light.png deleted file mode 100644 index 1235b67c..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--components--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--core--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vue--core--1440--light.png deleted file mode 100644 index 8fcc07a8..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--core--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--core--360--dark.png deleted file mode 100644 index 33e6e604..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--dark.png deleted file mode 100644 index 11416d3d..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--light.png deleted file mode 100644 index 021e6f45..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--docs--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--docs--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--docs--360--dark.png deleted file mode 100644 index d1dc5d75..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--docs--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--menu--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--menu--360--dark.png deleted file mode 100644 index b20c07a7..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--menu--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--search--1440--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--search--1440--dark.png deleted file mode 100644 index dbf35cc5..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--search--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--search--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--search--360--dark.png deleted file mode 100644 index daaebb24..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--search--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--workspace--1440--light.png b/visual-baselines/showcase-excellence-v2/after/vue--workspace--1440--light.png deleted file mode 100644 index 20db334e..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--workspace--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/after/vue--workspace--360--dark.png b/visual-baselines/showcase-excellence-v2/after/vue--workspace--360--dark.png deleted file mode 100644 index e7a375b2..00000000 Binary files a/visual-baselines/showcase-excellence-v2/after/vue--workspace--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--dark.png b/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--dark.png deleted file mode 100644 index ce9ca5f7..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--light.png b/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--light.png deleted file mode 100644 index daa2d8aa..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/markdown--docs--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--button--390--dark.png b/visual-baselines/showcase-excellence-v2/before/vanilla--button--390--dark.png deleted file mode 100644 index 20ac1167..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--button--390--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--calendar--360--light.png b/visual-baselines/showcase-excellence-v2/before/vanilla--calendar--360--light.png deleted file mode 100644 index 7351b5f7..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--calendar--360--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--components--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vanilla--components--1440--light.png deleted file mode 100644 index 86e22cce..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--components--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--core--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vanilla--core--1440--light.png deleted file mode 100644 index 2557ed0c..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--core--360--dark.png b/visual-baselines/showcase-excellence-v2/before/vanilla--core--360--dark.png deleted file mode 100644 index 5b29ee0e..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--1440--light.png deleted file mode 100644 index b563cd70..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--360--dark.png b/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--360--dark.png deleted file mode 100644 index 61d7c620..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vanilla--workspace--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--button--390--dark.png b/visual-baselines/showcase-excellence-v2/before/vue--button--390--dark.png deleted file mode 100644 index aa021df5..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--button--390--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--calendar--360--light.png b/visual-baselines/showcase-excellence-v2/before/vue--calendar--360--light.png deleted file mode 100644 index 2eaa96cc..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--calendar--360--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--components--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vue--components--1440--light.png deleted file mode 100644 index 5f119086..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--components--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--core--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vue--core--1440--light.png deleted file mode 100644 index edf8c252..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--core--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--core--360--dark.png b/visual-baselines/showcase-excellence-v2/before/vue--core--360--dark.png deleted file mode 100644 index f98631a0..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--core--360--dark.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--workspace--1440--light.png b/visual-baselines/showcase-excellence-v2/before/vue--workspace--1440--light.png deleted file mode 100644 index bd99c1fb..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--workspace--1440--light.png and /dev/null differ diff --git a/visual-baselines/showcase-excellence-v2/before/vue--workspace--360--dark.png b/visual-baselines/showcase-excellence-v2/before/vue--workspace--360--dark.png deleted file mode 100644 index 568a825c..00000000 Binary files a/visual-baselines/showcase-excellence-v2/before/vue--workspace--360--dark.png and /dev/null differ