Skip to content

Commit 541e55d

Browse files
committed
docs(changelog): close 'Fragment unstyled' limitation; note new CSS
1 parent 807c283 commit 541e55d

1 file changed

Lines changed: 8 additions & 3 deletions

File tree

CHANGELOG.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2424
through it for parity testing.
2525
- `FragmentSurfaceAdapter` translates SurfaceSpec + render context into
2626
a Fragment tree for surfaces with `render: fragment`.
27+
- **Fragment-rendered surfaces are now styled.** New
28+
`components/fragment-primitives.css` provides CSS rules for every class
29+
the Fragment renderer emits for `simple_task.task_list` (Surface,
30+
Heading, Region.kind=list, Text, Table). Surfaces flipped to
31+
`render: fragment` now display with the same visual chrome as the
32+
Jinja path. CSS-presence test in `tests/unit/test_fragment_primitive_css.py`
33+
pins the coverage; new primitives that get flipped in later plans must
34+
add to both the CSS file and the test's `_REQUIRED_CLASSES` tuple.
2735

2836
### Changed
2937
- `simple_task.task_list` surface flipped to `render: fragment`. Visible
@@ -34,9 +42,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3442
and (SurfaceSpec, ctx)-shaped consumers can satisfy it. The dispatcher
3543
knows which signature each registered handler uses.
3644

37-
### Known limitations
38-
- **Fragment-rendered surfaces produce structurally-correct HTML but the framework CSS does not yet style the `dz-surface`/`dz-heading--level-N`/`dz-region--kind-X` classes the Fragment renderer emits.** A surface flipped to `render: fragment` will function (data renders, htmx targets work) but the visual chrome will look bare until Plan 4+ wires CSS rules for these classes. `simple_task.task_list` is the only flipped surface and is a development example; downstream apps should not flip surfaces to `render: fragment` until Plan 4 ships.
39-
4045
## [0.66.37] - 2026-05-06
4146

4247
### Added

0 commit comments

Comments
 (0)