Skip to content

Preserve direct HTML description lists through a companion block - #695

Merged
chubes4 merged 1 commit into
trunkfrom
feat/694-description-list-companion
Jul 26, 2026
Merged

Preserve direct HTML description lists through a companion block#695
chubes4 merged 1 commit into
trunkfrom
feat/694-description-list-companion

Conversation

@chubes4

@chubes4 chubes4 commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • convert RichText-safe direct <dl>/<dt>/<dd> structures into a typed blocks-engine/description-list companion block
  • preserve terms, descriptions, nested supported inline markup, classes, and exact inline CSS in editor and saved semantic markup
  • retain the existing conservative fallback for malformed ordering, wrappers, block-level descriptions, and inline attributes Gutenberg RichText cannot round-trip
  • aggregate one generated block definition and one Gutenberg-gap report across multi-page artifacts
  • link diagnostics and implementation context to Gutenberg #4880 and stalled Gutenberg PR #20760

Closes #694.

Compatibility

This is an additive companion-block/result-report capability. Existing malformed or editor-unsafe description lists keep their prior fallback conversion. The companion contract is intentionally narrow so imported blocks can migrate to a native core Description List block if Gutenberg lands one.

Testing

  • composer --working-dir=php-transformer test
  • 29 Description List assertions
  • 248 parity fixtures
  • canonical contracts and all PHP transformer unit suites
  • package-install proof
  • generated index.js syntax check with Node
  • git diff --check

Homeboy run agent-task-c386f13f-31e5-488e-b4fa-72b283e47e11 produced the isolated candidate. Its promotion gates lacked nested Composer hydration; that infrastructure gap is tracked in Extra-Chill/homeboy#10143. The same gate commands pass in the hydrated DMC worktree.

AI assistance

  • Models: OpenAI GPT-5.6 Terra and OpenAI GPT-5.6 Sol
  • Tools: Homeboy and OpenCode
  • Used for: isolated implementation, dependency analysis, code review, editor-save correction, test execution, and upstream Gutenberg linkage with Chris Huber.

@chubes4
chubes4 merged commit e484f49 into trunk Jul 26, 2026
4 checks passed
@chubes4
chubes4 deleted the feat/694-description-list-companion branch July 26, 2026 16:07
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.

Preserve direct HTML description lists through a companion block

1 participant