Skip to content

feat: add x-render-dependencies, x-renderer fields…for SSR/SSG metadata#148

Open
SisyphusZheng wants to merge 1 commit into
webcomponents:mainfrom
SisyphusZheng:x-render-dependencies
Open

feat: add x-render-dependencies, x-renderer fields…for SSR/SSG metadata#148
SisyphusZheng wants to merge 1 commit into
webcomponents:mainfrom
SisyphusZheng:x-render-dependencies

Conversation

@SisyphusZheng
Copy link
Copy Markdown

Add four x- prefixed fields to CustomElementDeclaration and CustomElementMixinDeclaration schemas, plus TypeScript type definitions and documentation.

Fields:

  • x-render-dependencies: tag names that must be registered before this component can render (enables SSR topological sort)
  • x-layer: SSR capability (server-only / server-hydratable / client-only)
  • x-shadow: DSD template attributes (mode, clonable, delegatesFocus, etc.)
  • x-renderer: template rendering backend (lit / vanilla / generic)

These fields address the gap where SSR/SSG engines cannot automatically discover component rendering capabilities from CEM. Working implementation in LessJS (github.com/lessjs-run/lessjs).

Also adds docs/x-field-conventions.md with naming rules, auto-detection guidance, and deprecation path for x- fields.

… for SSR/SSG metadata

Add four x- prefixed fields to CustomElementDeclaration and
CustomElementMixinDeclaration schemas, plus TypeScript type definitions
and documentation.

Fields:
- x-render-dependencies: tag names that must be registered before
  this component can render (enables SSR topological sort)
- x-layer: SSR capability (server-only / server-hydratable / client-only)
- x-shadow: DSD template attributes (mode, clonable, delegatesFocus, etc.)
- x-renderer: template rendering backend (lit / vanilla / generic)

These fields address the gap where SSR/SSG engines cannot automatically
discover component rendering capabilities from CEM. Working
implementation in LessJS (github.com/lessjs-run/lessjs).

Also adds docs/x-field-conventions.md with naming rules, auto-detection
guidance, and deprecation path for x- fields.
@google-cla
Copy link
Copy Markdown

google-cla Bot commented May 15, 2026

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant