hemx/work/slices/SLICE-0014-html-examples-per-example-pages.md

id, type, status, parent, title, refs

id	type	status	parent	title	refs
SLICE-0014	slice	ready	NS-0004	Split implemented html_examples into focused per-example pages	AGENTS.md REQUIREMENTS.md examples/html_examples/README.md examples/html_examples/src/main.rs examples/html_examples/templates/app_shell.heml examples/html_examples/templates/gallery.heml hemx-xtask/src/main.rs

Objective

Give each currently implemented html_examples pattern a focused page/route so contributors can open, copy, and test one pattern at a time while preserving generated-resource, server-owned-state behavior.

Authority

• AGENTS.md says examples/html_examples is the copy-paste HTML pattern gallery for htmx-style examples and should keep exact htmx slugs visible without HTMX syntax, selector targeting, or user-authored browser JavaScript. req: htmx_equivalents/001 req: htmx_equivalents/005 req: examples/007
• REQUIREMENTS.md page swap and navigation rows preserve real anchors/history semantics and progressive enhancement boundaries. req: page_swap/007 req: page_swap/008
• Existing generated templates and handlers in examples/html_examples/src/main.rs own the implemented dynamic behavior.

Close when

• Implemented README rows have stable same-origin pages with exact slug names visible in the URL or page heading: click-to-edit, click-to-load, delete-row, edit-row, lazy-load, inline-validation, active-search, progress-bar, value-select, reset-user-input, update-other-content where represented by existing behavior, and infinite-scroll owned by SLICE-0015.
• Each page renders only the relevant example content plus minimal navigation back to the index/neighboring examples.
• Existing handlers continue to use generated forms/resources and server-owned Rust state; route splitting must not introduce selector-targeted swaps, user-authored browser JavaScript, or duplicated app state truth.
• Existing implemented interactions continue to work without full-page reload during the interaction itself.

Allowed files

• examples/html_examples/src/main.rs
• examples/html_examples/templates/app_shell.heml
• Existing or new .heml templates under examples/html_examples/templates/
• Existing partial templates under examples/html_examples/templates/partials/ only if moving markup requires local template boundaries
• examples/html_examples/README.md for updated route/page documentation
• hemx-xtask/src/main.rs for focused smoke route coverage
• REQUIREMENTS.md only if route/page behavior changes durable obligations

Verification

• cargo test -p hemx-html-examples
• cargo test -p hemx-xtask
• cargo run -p hemx-xtask -- html-examples-smoke
• redgate health --strict && redgate lint if REQUIREMENTS.md changes
• Manual spot check if needed: from /, open several example links directly and verify their heading/slug and dynamic behavior.

Non-goals

• Do not implement deferred examples such as bulk-update, modal-custom, or tabs-hateoas.
• Do not replace axum routes with a framework-owned router abstraction.
• Do not combine click-triggered click-to-load semantics with scroll-triggered infinite-scroll; keep their page behavior distinct.

Evidence

Ready; no implementation evidence yet.