Repository navigation
test: pin helper output and extension output in the rendered document - #12
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>
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>
User story 2 is a property of the seam, so these cases exist to fail if a future refactor reintroduces HTML post-processing. - DocumentViewRendererTest: the child renderer is asked once, for exactly the document's children; the body reaches the template byte for byte; an empty child result still produces a rendered document - DocumentViewRenderingTest: a body template calling a stateful Laminas helper renders that helper's markup inside the body; a table, contributed by the installed table extension, reaches the output; the converter is the library's own MarkdownConverter and the library's document renderer still sits behind the view renderer at the lower priority Covers T028, T029 and T030. Signed-off-by: Joey Smith <jsmith@webinertia.net>
tyrsson
force-pushed
the
tyrsson-render-04-helper-output
branch
from
November 13, 2026 01:45
625acc7 to
be0ee43
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 4 of
specs/001-document-view-render/tasks.md: T028 to T030, User Story 2. The implementation is the delegation call and the view render that Phase 3 landed; these tasks pin the guarantee so a refactor that reintroduces HTML post-processing fails.Tasks
test/unit/DocumentViewRendererTest.php: delegation casestest/integration/DocumentViewRenderingTest.php: helper casetest/integration/DocumentViewRenderingTest.php: extension case and the untouched library typesWhat is pinned
renderNodesis called exactly once, with exactly$node->children(), through a mock withexpects($this->once()).ConverterInterfacestill resolves toLeague\CommonMark\MarkdownConverteritself, and the library's own document renderer is still registered for the document node behind the view renderer at priority 10. Nothing is subclassed or replaced.Notes
The helper case asserts
helper.cssandrel="stylesheet"rather than the rawhref, becauseHeadLinkURI-escapes the slash in the attribute value.Gates
mago format: applied,--checkcleanmago lint: no issuesmago analyze: no issues, no new baseline entriesmago guard: no issues