Skip to content

Preserve authored controls and documentation layouts - #1545

Merged
chubes4 merged 7 commits into
trunkfrom
fix/runtime-authored-input
Sep 3, 2026
Merged

Preserve authored controls and documentation layouts#1545
chubes4 merged 7 commits into
trunkfrom
fix/runtime-authored-input

Conversation

@chubes4

@chubes4 chubes4 commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Summary

  • preserve runtime-targeted authored inputs as editable native blocks without dropping source attributes
  • retain structured documentation navigation, breadcrumb flow, inline formatting geometry, syntax token styles, and native code/grid defaults
  • recognize direct-anchor and list-based native navigation in semantic parity reporting
  • add contract, unit, and visual parity fixtures covering each repaired conversion path

Verification

  • composer test
  • all 297 visual parity fixtures pass
  • packaged this exact branch head with Static Site Importer 05d574f5 and imported fixture 83-startup-docs-hub through Studio PR Use slim Static Site Importer 1.9.5 studio#4757
  • import validation: 70 native blocks; zero fallback, core/html, freeform, invalid, content-loss, empty-conversion, SVG, runtime-dependency-parity, or semantic-parity failures
  • Playwright desktop comparison: 0 mismatched pixels out of 1,584,000
  • Playwright mobile comparison: 0 mismatched pixels out of 329,160
  • Gutenberg: 70 valid blocks, 3 authored inputs, search input independently selectable, editor remains clean
  • runtime search behavior works without browser errors

AI Assistance

OpenAI gpt-5.6-sol was used through OpenCode to investigate fixture failures, implement and test the repairs, run end-to-end Studio/Gutenberg verification, and prepare this pull request. All changes and evidence were reviewed and orchestrated by Chris Huber.

@chubes4
chubes4 merged commit f01e80d into trunk Sep 3, 2026
10 checks passed
@chubes4
chubes4 deleted the fix/runtime-authored-input branch September 3, 2026 18:36
chubes4 added a commit to Automattic/studio that referenced this pull request Sep 5, 2026
## Summary

Update the default Static Site Importer release used by `studio create
--from` from the full `v1.8.5` package to the `v1.9.5`
`html-site-import` package.

The slim package is self-contained for Studio's portable HTML import
path: it includes Static Site Importer and PHP Transformer `0.9.3`,
while excluding unused Figma, Markdown/MDX, and Composer runtime
dependencies.

Release:
https://github.com/Automattic/static-site-importer/releases/tag/v1.9.5

Published asset: `static-site-importer-html-site-import.zip`

- Size: `1303735` bytes
- SHA-256:
`156e24b7e0805a32c3003d66d60b286a837c2048c63dfa9eb952dcf277d5b8c9`

### Why 1.9.5 rather than 1.9.3

This PR originally pinned `v1.9.3`, which vendors PHP Transformer
`0.9.1`. That predates Automattic/blocks-engine#1545, so the pinned
runtime did not contain the authored-input, documentation-navigation,
breadcrumb-flow, syntax-token, or native code and grid conversion fixes.
The pin was advanced through a full release chain so the Studio default
carries them:

1. blocks-engine `php-transformer-v0.9.3`
2. Static Site Importer Automattic/static-site-importer#1520, then
`v1.9.5`
3. This Studio pin

## Testing

- Built this branch's CLI and ran native `site create --from` against
the Blocks Engine `83-startup-docs-hub` fixture using the default
published URL, without a local package override.
- Source-of-truth manifest records SSI `1.9.5`, PHP Transformer `0.9.3`,
and no Figma Transformer.
- Front page ID 5 is published with 70 native blocks and zero fallback,
`core/html`, freeform, invalid, content-loss, or empty-conversion
blocks.
- Import validation passed every quality gate, including asset
materialization, runtime dependency parity, and semantic parity; the
served front end returns HTTP 200 with the runtime search control and
native navigation present.
- Verified the downloaded release asset hashes to the SHA-256 above and
that its vendored transformer contains the blocks-engine#1545 navigation
fix, so the pin demonstrably carries the intended code rather than only
a newer version string.
- `89-static-site-importer-architecture` is covered by the solved-site
promotion gate, which passed against PHP Transformer `0.9.3` on
Automattic/static-site-importer#1520.
- Studio CI is green on this commit, including Lint, Unit Tests, E2E
Tests, CLI E2E Tests, Performance Metrics, CodeQL, and Data Liberation.

## AI assistance

OpenAI GPT-5.6 Sol via OpenCode diagnosed that the released pin predated
blocks-engine#1545, orchestrated the blocks-engine and Static Site
Importer releases through Homeboy, updated the Studio pin to the slim
`v1.9.5` runtime, and verified the result through the built Studio CLI
and published release artifact. Chris Huber directed and approved the
work.

---------

Co-authored-by: Wojtek Naruniec <wojtek.naruniec@automattic.com>
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