Skip to content

Add backend render-source metadata for a11y agent #36265

Description

@fmontes

Description

Add the backend/API support needed by the a11y agent to identify editable render sources for a page. This includes exposing theme files through /_render-sources, adding file extension metadata, supporting opt-in Sass source maps, and ensuring theme asset rendering respects the requested page mode.

Tracked PR: #36264

Todo

  • Expand /_render-sources to return theme files beyond VTL-only refs.
  • Replace VtlFileRefView with generic FileRefView.
  • Add extension metadata to render-source file refs.
  • Add opt-in inline Sass source maps with ?sourcemap=true.
  • Keep normal stylesheet responses unchanged when source maps are not requested.
  • Make theme CSS/template asset rendering respect the requested page mode.
  • Update OpenAPI metadata and language entries.
  • Add integration test coverage for render-source and source-map behavior.

Acceptance Criteria

  • /_render-sources returns theme file metadata the a11y agent can filter by extension.
  • Compiled Sass requests can opt into inline source maps with ?sourcemap=true without changing normal stylesheet responses.
  • Theme CSS/template assets respect the requested page mode for backend-user scans.
  • OpenAPI and integration test coverage are updated.

Priority

Medium

Additional Context

This is the backend slice of the broader a11y-agent work, separated for easier review and QA.

Activity

  1. added theissue type on Jun 22, 2026
  2. github-actions commented on Jun 22, 2026

    @github-actions
    Contributor
  3. added a commit that references this issue on Jul 16, 2026
    5c5e371
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions