Repository navigation
feat: render documents through the view renderer seam - #11
Merged
Merged
Conversation
…straint The document view seam imports Mezzio\Template\TemplateRendererInterface directly, so the package that provides it becomes a direct requirement instead of an accident of webware-theme's tree. The php constraint now covers 8.6 while config.platform.php stays pinned at 8.4.99. Baseline gates recorded before any code change: mago format --check, lint, analyze and guard exit zero, 43 unit tests and 8 integration tests pass. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Signed-off-by: Joey Smith <jsmith@webinertia.net>
Page implements Laminas\View\Model\ModelInterface for the state a template reads, never for a position in the render tree: it is final readonly and every mutator throws, because LaminasViewRenderer writes to the model it renders and walks children through beforeRender(). PageContext holds the current page for one conversion. PageContextListener copies it into the document data under commondoc.page on DocumentPreRenderEvent, so the renderer reads the page from the document it belongs to and a document built outside a build simply has no entry. Both factories are registered in ConfigProvider, and the aliases docblock now says interface-string because its only key is an interface. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Signed-off-by: Joey Smith <jsmith@webinertia.net>
tyrsson
force-pushed
the
tyrsson-render-03-seam
branch
from
November 13, 2026 01:39
e314a6d to
8a3e1fe
Compare
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Page implements ModelInterface and returns an ArrayIterator, so the IteratorAggregate import was never referenced. Mago reports it as no-redundant-use on both supported PHP versions, which fails the lint gate and skips the suites behind it. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add DocumentViewRenderer, registered for the document node at priority 10, so a converted document is rendered as a view instead of as finished HTML. The body comes from the injected child renderer and is handed to the template renderer once, which keeps the layout wrap, the view helpers and the helper state reset with the framework. - src/View/DocumentViewRenderer.php, src/Container/DocumentViewRendererFactory.php - templates/commondoc/layout.phtml as the shell, templates/commondoc/document.phtml rewritten as the body template reading documentBody and the optional page - ConfigProvider: templates.map for commondoc::document and commondoc::layout, templates.layout, renderer factory entry, middleware pipeline entry removed - EnvironmentFactory: renderer at priority 10 and the page context listener on the pre-render event - LayoutWrappingMiddleware, its factory and both tests deleted (owner approved) - config/autoload/commonmark.global.php: external_link.noFollow was 'none', which the CommonMark extension rejects; it is now '' (apply to none) Tests cover T015 to T027: renderer and factory units, layout and body templates, the provider wiring, the environment factory registrations and a real container render asserting the site override, the packaged body with the layout wrap and the template-not-found failure. Signed-off-by: Joey Smith <jsmith@webinertia.net>
tyrsson
force-pushed
the
tyrsson-render-03-seam
branch
from
November 13, 2026 01:45
8a3e1fe to
8d04f86
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Scope
Phase 3 of
specs/001-document-view-render/tasks.md: T015 to T027, User Story 1, the rendering seam.DocumentViewRendererimplementsLeague\CommonMark\Renderer\NodeRendererInterfaceand is registered forLeague\CommonMark\Node\Block\Documentat priority 10 inEnvironmentFactory. The body is obtained once from the injectedChildNodeRendererInterfaceand handed toLaminasViewRenderer, so the layout wrap, the view helpers and the helper state reset all stay with the framework.HtmlRenderer,MarkdownConverterandMarkdownConverterInterfaceare untouched.Tasks
test/unit/DocumentViewRendererTest.phptest/unit/DocumentViewRendererFactoryTest.phptemplates/commondoc/layout.phtmlsrc/View/DocumentViewRenderer.phpsrc/Container/DocumentViewRendererFactory.phpsrc/ConfigProvider.phpview config, factories and bus pipelinesrc/Container/EnvironmentFactory.phprenderer and pre-render listenertemplates/commondoc/document.phtmlas the body templateLayoutWrappingMiddleware, its factory and both unit tests deletedtest/unit/ConfigProviderTest.phptest/integration/ConfigProviderWiringTest.php,test/integration/ContainerBootTest.phptest/unit/EnvironmentFactoryTest.phptest/integration/DocumentViewRenderingTest.phpBehaviour
commondoc::document, receivesdocumentBody, and never setscontent.pagearrives on the render root, so a render with no page still works; the template reads it behind a null check.templates.mapholds both addresses, so a site overrides the body by adding the same address to its own map, with no code change. Resolution order is unchanged: theme 100, map 50, path stack 1.view_manager.template_path_stackkey is gone from the provider.Defect found while testing
config/autoload/commonmark.global.phpsetexternal_link.nofollowto'none', which the CommonMark external link extension rejects; the no-apply value is the empty string. It surfaced only when a document was actually parsed, which nothing did before this phase. Corrected to''with the comment alongside it.Gates
mago format --check: cleanmago lint: no issuesmago analyze: no issues, no new baseline entriesmago guard: no issuesInfection is left to CI on push, as agreed.