feat(docs): 677 — demo page for custom path atoms (yyyy-mm-dd, name.ext)

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).

[randomdevpete]

Summary

Adds a new /demos/complex-routing page demonstrating custom single-segment path atoms built directly on routeAtom (not staticRouteAtom/paramRouteAtom):

• yyyy-mm-dd archive-date segment parsed to {year, month, day} and validated against real calendar dates via validateAtom, showing a valid leap-year date (2024-02-29) and an invalid one (2023-02-29) to demonstrate validation rejection.
• name.ext filename segment parsed to {name, ext}, including a file with a dot in the base name to show the regex correctly splits only on the last dot.

Implementation

Both custom atoms are self-contained factories demonstrating the pattern for single-segment parsing. Registry edits (routes.ts) are purely additive, allowing ticket 678 to stack cleanly. SSG/SSR paths only include valid calendar dates to ensure the build succeeds.

Notes

One exception to CODING-STYLE.md section 2: dateSegmentRouteAtom has a multi-line docblock despite being an internal function. This is justified as teaching material on a public docs site where clarity warrants the exception.

Stacked on PR #96 (task-676-demo-page-cancel-navigation-dirty-edits).