Presets with a designed layout place sections into fixed slots, and they - * chose what goes where by matching the heading against a list of English - * words each kept privately. A CV headed {@code Berufserfahrung} or - * {@code Опыт работы} matched nothing: the section was dropped and the slot - * that wanted it rendered empty. Nothing failed — the CV came out looking - * finished, one job short.
- * - *A module states its {@link SectionRole}, so the routing has an answer - * that does not depend on the language the CV is written in. Every heading - * here is deliberately in Russian and German: if any preset still routes by - * keyword, its slot stays empty and this goes red.
+ *Slots that still ask for Experience or Skills only see the four + * hand-written section types. A {@link ModuleSection} is not a slot claim: + * it stays in document order (or the leftover tail) and draws through + * {@link com.demcha.compose.document.templates.cv.api.CvConstructor}. This + * suite holds that promise for headings no English keyword list contains.
*/ class RoleRoutingTest { - private static StreamHeadings are the fallback because a section that carries no role — - * every hand-written one — has nothing else to be found by. A module that - * did name a role is never claimed by a different slot's - * keywords: it would then render in two places, which is a worse failure - * than the one role routing exists to fix.
+ *A {@link ModuleSection} is never claimed. Runtime modules are + * shapes, not CV meanings, so they stay in {@link #remaining()} and + * draw through the constructor. The {@code role} argument is the + * slot's label for typed sections and does not inspect a module.
* - * @param role the role this slot holds; {@code null} or - * {@link SectionRole#OTHER} means "keywords only" + * @param role the role this slot holds; unused for modules * @param keys candidate heading fragments * @return the claimed section, or {@code null} when nothing matches * @since 2.3.0 */ public CvSection claim(SectionRole role, ListPresets with a designed layout place their sections into fixed slots, - * and they have been choosing what goes where by matching the section's - * heading against a list of English words each preset keeps privately. That - * works for a CV written in English by someone who used the expected - * headings. A CV headed {@code Ausbildung} or {@code Навыки} matches - * nothing and loses the section; so does {@code "Volunteering"}, and so does - * a second section whose heading matched a word the first one took.
+ *Slots that still ask for Experience or Skills only see the four + * compile-time records, matched by heading. A runtime module is a shape, + * not a CV meaning — the template does not know Experience from Projects + * — so {@link #find} never claims one. Modules stay in document order, or + * in {@link SectionAllocation#remaining()}, and draw through + * {@link com.demcha.compose.document.templates.cv.api.CvConstructor}.
* - *A {@link ModuleSection} carries a {@link SectionRole} because the - * author already knew the answer, so the role is asked first and the - * keywords are the fallback for the sections that have no role to give.
- * - *The second half is the shape. These slots are written against a - * particular section type — {@code if (!(section instanceof EntriesSection - * entries)) return;} — because each draws its content its own way, and a - * module reaching one would be dropped by that guard however well it was - * routed. Each finder below therefore lowers a matched module to the type - * its slot expects, so the preset draws it exactly as it draws everything - * else. What that costs is stated per method: a module's description lines - * are joined where the target type holds one string, and a bulleted - * description reads as prose.
- * - *A section that matches no slot at all is a different question, and one - * this class cannot answer: it keeps no memory of what a previous slot took. - * {@link SectionAllocation} does, so a preset that wants to draw the leftovers - * claims through it and reads {@link SectionAllocation#remaining()} — with - * {@link #naturalShape(CvSection)} for the shape those sections have no slot - * to give them.
+ *The lowering half is for a leftover that has no slot of its own: + * {@link #naturalShape(CvSection)} and {@link #asEntries}, {@link #asRows}, + * {@link #asParagraph}, {@link #asSkills} turn a module into the record + * a preset's existing renderer already takes. What that costs is stated + * per method: a module's description lines are joined where the target + * type holds one string, and a bulleted description reads as prose.
* * @since 2.3.0 */ @@ -265,18 +250,21 @@ public static CvSection naturalShape(CvSection section) { } /** - * The section this slot should hold, or {@code null} when the document - * has none: the first module whose role is the slot's, else the first - * section whose heading matches one of the keys. + * The typed section this slot should hold, or {@code null} when the + * document has none: the first hand-written section whose heading + * matches one of the keys. * - *Role first, and only a role the author actually chose — - * {@link SectionRole#OTHER} is what a module carries when the catalogue - * has no name for it, so it never claims a slot and falls through to the - * headings like any other section.
+ *A {@link ModuleSection} is never claimed here. A runtime module is + * a shape, not a CV meaning — the template does not know Experience + * from Projects — so slots that still ask for a {@link SectionRole} + * only see the four compile-time records. Modules stay in document + * order (or in {@link SectionAllocation#remaining()}) and draw through + * {@link com.demcha.compose.document.templates.cv.api.CvConstructor}.
* * @param sections the document's sections for this slot's column - * @param role the role this slot holds - * @param keys heading fragments to fall back on + * @param role unused for modules; kept so existing slot call sites + * compile while they still name a role for typed sections + * @param keys heading fragments to match against typed sections * @return the section, or {@code null} when nothing matches */ public static CvSection find(List