Epic: Ts.ED Schema Functional API — Typed Inference & Roadmap (Phase II/III)

[Romakita]

Epic: Ts.ED Schema Functional API — Typed Inference & Roadmap (Phase II/III)

Objective

This Epic tracks the ongoing development and planned improvements for the functional API's type inference in @tsed/schema, following the initial rollout (Phase I) as described in the proposal.

Summary of the Plan

• Leverage JsonSchema<T> generics for strong type inference in the functional API, similar to Zod.
• Provide utilities such as s.infer for type extraction.
• Typed builder signatures and chainable methods.
• Compatibility and migration: additive, with no breaking changes.
• Maintain runtime compatibility.

Roadmap (Phase II/III): Axes d'amélioration

This Epic covers the following areas for future improvement (see sub-stories):

1. Date type override (configurable)
2. Literal narrowing enhancements
3. Branded primitives
4. Deep helpers on object schemas
5. additionalProperties typing ergonomics
6. patternProperties key typing
7. Union/intersection expressiveness
8. any() ergonomics
9. Schema generics and parameterization
10. Type emission performance
11. DX and error messages
12. Interop and adapters
13. Testing strategy
14. Documentation and recipes
15. Tooling guardrails

Each of these axes will be detailed in a dedicated story linked to this Epic.

---

Reference: Proposal & Plan

This Epic is for tracking only. Implementation should be split across the detailed stories.