Skip to content

test: pin helper output and extension output in the rendered document - #12

Merged
tyrsson merged 5 commits into
1.0.xfrom
tyrsson-render-04-helper-output
Nov 13, 2026
Merged

tyrsson merged 5 commits into
1.0.xfrom
tyrsson-render-04-helper-output

Conversation

@tyrsson

@tyrsson tyrsson commented Nov 13, 2026

Copy link
Copy Markdown
Member

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

Task Change
T028 test/unit/DocumentViewRendererTest.php: delegation cases
T029 test/integration/DocumentViewRenderingTest.php: helper case
T030 test/integration/DocumentViewRenderingTest.php: extension case and the untouched library types

What is pinned

  • renderNodes is called exactly once, with exactly $node->children(), through a mock with expects($this->once()).
  • The body handed to the template is the child renderer's string byte for byte, and an empty string still renders.
  • A body template that appends to a stateful Laminas helper renders that helper's markup, because the body runs inside a real view render rather than string concatenation.
  • A table contributed by the installed table extension reaches the output.
  • ConverterInterface still resolves to League\CommonMark\MarkdownConverter itself, 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.css and rel="stylesheet" rather than the raw href, because HeadLink URI-escapes the slash in the attribute value.

Gates

  • mago format: applied, --check clean
  • mago lint: no issues
  • mago analyze: no issues, no new baseline entries
  • mago guard: no issues
  • PHPUnit: 98 tests, 174 assertions, all passing

tyrsson and others added 2 commits November 12, 2026 19:23
…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

codecov Bot commented Nov 13, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

tyrsson and others added 3 commits November 12, 2026 19:45
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
tyrsson force-pushed the tyrsson-render-04-helper-output branch from 625acc7 to be0ee43 Compare November 13, 2026 01:45
@tyrsson
tyrsson merged commit 2fcb4b0 into 1.0.x Nov 13, 2026
12 checks passed
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