@wildo-ai/framework-knowledge 1.1.8 → 1.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (480) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +9 -2
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +21 -0
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +121 -0
  7. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  8. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +31 -5
  9. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  10. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +29 -2
  11. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +69 -24
  12. package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +10 -0
  13. package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +21 -5
  14. package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +31 -5
  15. package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +2 -0
  16. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +20 -4
  17. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  18. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  19. package/dist/esm/framework-knowledge.definitions.js +95 -5
  20. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  21. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  22. package/dist/esm/index.d.ts.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +11 -11
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +29 -22
  30. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +41 -3
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +175 -14
  34. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -3
  38. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
  40. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -1
  41. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
  45. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +4 -2
  47. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +90 -13
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +4 -3
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +4 -3
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +8 -0
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +12 -4
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  59. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  61. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +4 -1
  63. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +2 -1
  65. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  68. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  69. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  71. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  72. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +13 -1
  74. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  76. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +25 -27
  78. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  79. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +91 -43
  80. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +41 -0
  82. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -0
  83. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +43 -0
  84. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -0
  85. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +200 -0
  86. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -0
  87. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +203 -0
  88. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -0
  89. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +81 -0
  90. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -0
  91. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +93 -0
  92. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -0
  93. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +3 -1
  94. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  95. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +27 -18
  96. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  97. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  98. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +11 -1
  99. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +11 -11
  101. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -0
  103. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  104. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +3 -1
  105. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  106. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  107. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +2 -0
  108. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  109. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +3 -1
  110. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  111. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  112. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +5 -2
  113. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -4
  115. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
  117. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +32 -12
  119. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  121. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  123. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  124. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  125. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +13 -5
  127. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +7 -3
  129. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  130. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +71 -2
  131. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  132. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  133. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  134. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  135. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  136. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +7 -1
  137. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  138. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +4 -2
  139. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  140. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +9 -3
  141. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +3 -3
  143. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  144. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  145. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +35 -2
  146. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  147. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +41 -17
  148. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  149. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  150. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  151. package/dist/knowledge/manifest.json +8 -8
  152. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +22 -7
  153. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  154. package/dist/knowledge/playbooks/bottom_up.build/method.md +17 -15
  155. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +4 -3
  156. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  157. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  158. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +261 -34
  159. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +42 -4
  160. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +188 -59
  161. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  162. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +169 -276
  163. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -2
  164. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +8 -1
  165. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -1
  166. package/dist/knowledge/playbooks/bottom_up.conception/method.md +3 -2
  167. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
  168. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  169. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  170. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +129 -17
  171. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +7 -4
  172. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
  173. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
  174. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +13 -5
  175. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
  176. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  177. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
  178. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
  179. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +7 -3
  180. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  181. package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
  182. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
  183. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  184. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
  185. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  186. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  187. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +75 -37
  188. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +35 -38
  189. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +145 -0
  190. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +57 -0
  191. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -0
  192. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -0
  193. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +99 -0
  194. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +65 -0
  195. package/dist/knowledge/playbooks/top_down.brand-naming/method.md +56 -0
  196. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +76 -0
  197. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  198. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  199. package/dist/knowledge/playbooks/top_down.business-model/method.md +60 -6
  200. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +15 -10
  201. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  202. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
  203. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +30 -10
  204. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +3 -1
  205. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +4 -1
  206. package/dist/knowledge/playbooks/top_down.definition/method.md +8 -3
  207. package/dist/knowledge/playbooks/top_down.definition/playbook.json +6 -4
  208. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
  209. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  210. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
  211. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  212. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  213. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  214. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +4 -2
  215. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  216. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  217. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +11 -1
  218. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  219. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  220. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  221. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  222. package/dist/knowledge/playbooks/top_down.risk-register/method.md +21 -0
  223. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +8 -2
  224. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +4 -2
  225. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +29 -0
  226. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +58 -17
  227. package/dist/knowledge/references/brand.name-choice.config.md +144 -0
  228. package/dist/knowledge/references/brand.name-screening.config.md +308 -0
  229. package/dist/knowledge/references/build-plan.task-graph.config.md +119 -11
  230. package/dist/knowledge/references/business-model.pricing-plan.config.md +16 -0
  231. package/dist/knowledge/references/business-model.snapshot.config.md +64 -0
  232. package/dist/knowledge/references/business-model.snapshot.validation.md +68 -4
  233. package/dist/knowledge/references/capability-composition.config.md +67 -4
  234. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  235. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  236. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  237. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +258 -0
  238. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  239. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +107 -0
  240. package/dist/knowledge/references/example.data-seeding.minimal.md +39 -10
  241. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  242. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  243. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  244. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  245. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  246. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  247. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  248. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
  249. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  250. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  251. package/dist/knowledge/references/experience-plan.config.md +60 -7
  252. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  253. package/dist/knowledge/references/market.snapshot.validation.md +1 -1
  254. package/dist/knowledge/references/placement-plan.config.md +43 -0
  255. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  256. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  257. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  258. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  259. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  260. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  261. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  262. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  263. package/dist/knowledge/references/saas.backend.email.send.md +77 -0
  264. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  265. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +7 -1
  266. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  267. package/dist/knowledge/references/saas.data-seeding.definition-input.md +14 -2
  268. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  269. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +124 -0
  270. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
  271. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
  272. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
  273. package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
  274. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
  275. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
  276. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  277. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
  278. package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
  279. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
  280. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +81 -2
  281. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -0
  282. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  283. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  284. package/dist/knowledge/references/saas.public-runtime.contract.md +26 -0
  285. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +10 -0
  286. package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
  287. package/dist/knowledge/references/saas.website.astro.label-loader.md +12 -0
  288. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  289. package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
  290. package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
  291. package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
  292. package/dist/knowledge/references/saas.website.factories.define-section.md +4 -0
  293. package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
  294. package/dist/knowledge/references/saas.website.page-manifest.schema.md +12 -3
  295. package/dist/knowledge/references/saas.website.page-sections.component.md +72 -0
  296. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  297. package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
  298. package/dist/knowledge/references/saas.website.sections.definition-schema.md +11 -0
  299. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  300. package/dist/knowledge/references/website-plan.config.md +26 -0
  301. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
  302. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
  303. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  304. package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
  305. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
  306. package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
  307. package/dist/knowledge/references/zod.factories.code.md +1 -0
  308. package/dist/knowledge/references/zod.factories.duration.md +1 -0
  309. package/dist/knowledge/references/zod.factories.money.md +1 -0
  310. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  311. package/dist/knowledge/registries/framework-topics.json +374 -1
  312. package/dist/knowledge/registries/playbooks.json +76 -28
  313. package/dist/knowledge/registries/source-tags.json +1513 -898
  314. package/dist/knowledge/rules/live-context-door.md +5 -2
  315. package/dist/knowledge/skills/INDEX.md +5 -2
  316. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  317. package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
  318. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  319. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  320. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  321. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +6 -1
  322. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
  323. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  324. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
  325. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -0
  326. package/dist/knowledge/skills/brand-name-screening/SKILL.md +178 -0
  327. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +466 -0
  328. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +87 -0
  329. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +7 -3
  330. package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
  331. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
  332. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
  333. package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
  334. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  335. package/dist/knowledge/skills/config-saas/SKILL.md +56 -15
  336. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +65 -2
  337. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
  338. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +81 -2
  339. package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
  340. package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
  341. package/dist/knowledge/skills/email-add-template/SKILL.md +28 -6
  342. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  343. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +128 -0
  344. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  345. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  346. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  347. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -2
  348. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
  349. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
  350. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
  351. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
  352. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
  353. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
  354. package/dist/knowledge/skills/inbound-channels/SKILL.md +2 -2
  355. package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
  356. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +17 -2
  357. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +122 -0
  358. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +11 -0
  359. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +9 -2
  360. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  361. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  362. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  363. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  364. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  365. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +22 -4
  366. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +12 -2
  367. package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
  368. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
  369. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  370. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  371. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  372. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
  373. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  374. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  375. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  376. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  377. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -4
  378. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1 -1
  379. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  380. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +26 -0
  381. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  382. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +10 -0
  383. package/dist/knowledge/skills/module-relationships/SKILL.md +37 -8
  384. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  385. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
  386. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
  387. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
  388. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
  389. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  390. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
  391. package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
  392. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
  393. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
  394. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
  395. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
  396. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -0
  397. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  398. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +26 -0
  399. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
  400. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  401. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
  402. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
  403. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
  404. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
  405. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
  406. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  407. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
  408. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
  409. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
  410. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -0
  411. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  412. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  413. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  414. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +30 -4
  415. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
  416. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
  417. package/dist/knowledge/skills/seeding-authoring/SKILL.md +202 -39
  418. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  419. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +154 -4
  420. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  421. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +7 -1
  422. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
  423. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
  424. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  425. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +10 -0
  426. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  427. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
  428. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  429. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  430. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  431. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  432. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  433. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
  434. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
  435. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  436. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  437. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +221 -37
  438. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
  439. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
  440. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
  441. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
  442. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
  443. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
  444. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
  445. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +14 -2
  446. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
  447. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
  448. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
  449. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
  450. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
  451. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
  452. package/dist/knowledge/skills/website-page-authoring/SKILL.md +100 -8
  453. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
  454. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
  455. package/dist/knowledge/skills/website-section-contact/SKILL.md +15 -0
  456. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +15 -0
  457. package/dist/knowledge/skills/website-section-cta/SKILL.md +15 -0
  458. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +15 -0
  459. package/dist/knowledge/skills/website-section-faq/SKILL.md +21 -1
  460. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +15 -0
  461. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +21 -1
  462. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +15 -0
  463. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +25 -2
  464. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +15 -0
  465. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +15 -0
  466. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +15 -0
  467. package/dist/knowledge/skills/website-section-hero/SKILL.md +33 -10
  468. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +15 -0
  469. package/dist/knowledge/skills/website-section-pricing/SKILL.md +21 -1
  470. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +15 -0
  471. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +27 -2
  472. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +15 -0
  473. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +16 -4
  474. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +11 -0
  475. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
  476. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
  477. package/dist/knowledge/topic-index.json +1590 -292
  478. package/dist/tsconfig.build.tsbuildinfo +1 -1
  479. package/dist/tsconfig.tsbuildinfo +1 -1
  480. package/package.json +4 -4
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };
@@ -913,7 +928,12 @@ D-AG4).
913
928
  |---|---|
914
929
  | Factory used | `rg -n "defineWebsiteSection" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
915
930
  | FAQPage emitted | `rg -n "'FAQPage'" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
916
- | Anchor + JSON-LD ref consistency | `rg -oN "faq-[a-z-]+" website/src/sections/<page>.sections.tsx \| sort -u` (count must equal `FAQ_QUESTIONS.length`) |
931
+ | Anchor + JSON-LD ref consistency | see the commands below the table (count must equal `FAQ_QUESTIONS.length`) |
932
+
933
+ ```bash
934
+ # Anchor + JSON-LD ref consistency
935
+ rg -oN "faq-[a-z-]+" website/src/sections/<page>.sections.tsx | sort -u
936
+ ```
917
937
 
918
938
  ## Common Rationalizations
919
939
 
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };
@@ -848,9 +863,14 @@ that an `ItemList` emission would currently trigger (until
848
863
  |---|---|
849
864
  | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
850
865
  | Category enum (no string literal) | `rg -n "FEATURE_BENEFIT_SUMMARY" website/src/sections/<page>.sections.tsx` (must return ≥1) |
851
- | Cell count consistent | `rg -oN "cell-\\d" website/src/sections/<page>.sections.tsx \| sort -u` (count must match section's documented arity) |
866
+ | Cell count consistent | see the commands below the table (count must match section's documented arity) |
852
867
  | Static label refs only | `rg -n "useWebsiteLabel\\(\`" website/src/sections/<page>.sections.tsx` (must return empty — dynamic refs hide from `expectedLabelKeys` audit) |
853
868
 
869
+ ```bash
870
+ # Cell count consistent
871
+ rg -oN "cell-\\d" website/src/sections/<page>.sections.tsx | sort -u
872
+ ```
873
+
854
874
  ## Common Rationalizations
855
875
 
856
876
  | Rationalization | Reality |
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };
@@ -865,8 +880,16 @@ will emit a `catalog-miss` warning. The right resolution is to
865
880
  |---|---|
866
881
  | Factory used for each instance | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` |
867
882
  | Category enum | `rg -n "FEATURE_DETAIL" website/src/sections/<page>.sections.tsx` (must return ≥1 per instance) |
868
- | Image dimensions present | `rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx \| rg -n "width=\|height="` (each `WebsiteImage` must have both) |
869
- | Bullet leaves declared = consumed | `diff <(rg -oN "bullet-\\d" website/src/sections/<page>.sections.tsx \| sort -u) <(rg -oN "\`\\$\\{root\\}\\.bullet-\\d\`" website/src/sections/<page>.sections.tsx \| sed 's/.*\\.//;s/\`//' \| sort -u)` (must return empty — no orphan / missing bullet leaves) |
883
+ | Image dimensions present | see the commands below the table (each `WebsiteImage` must have both) |
884
+ | Bullet leaves declared = consumed | see the commands below the table (must return empty — no orphan / missing bullet leaves) |
885
+
886
+ ```bash
887
+ # Image dimensions present
888
+ rg -n "WebsiteImage" -A 3 website/src/sections/<page>.sections.tsx | rg -n "width=|height="
889
+
890
+ # Bullet leaves declared = consumed
891
+ diff <(rg -oN "bullet-\d" website/src/sections/<page>.sections.tsx | sort -u) <(rg -oN '`\$\{root\}\.bullet-\d`' website/src/sections/<page>.sections.tsx | sed 's/.*\.//;s/`//' | sort -u)
892
+ ```
870
893
 
871
894
  ## Common Rationalizations
872
895
 
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };
@@ -155,6 +155,14 @@ compile-time prop checking.
155
155
  * and is caught by nothing until a reviewer reads the page. The
156
156
  * build and `wildo website audit` check the pack against the
157
157
  * DECLARED keys, so declare every slot the component reads.
158
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
159
+ * can target it. Belongs to the DEFINITION because a page renders its
160
+ * sections list through `WebsitePageSections`, which places every
161
+ * section itself: an anchor a page author would otherwise write on a
162
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
163
+ * valid HTML id that is also URL-fragment-safe: a letter, then
164
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
165
+ * to keep, like the id attribute it becomes.
158
166
  * - `Component` — the React component that renders the section. Typed
159
167
  * as `ComponentType<unknown>` here because schema-layer cannot lock
160
168
  * the component's prop shape (props vary per section). The factory
@@ -181,6 +189,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
181
189
  sectionRef: WebsiteSectionRefSchema,
182
190
  category: WebsiteSectionCategorySchema,
183
191
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
192
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
193
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
194
+ }).optional(),
184
195
  Component: z.unknown(),
185
196
  getStructuredData: z.unknown().optional(),
186
197
  });
@@ -269,6 +280,8 @@ export interface DefineWebsiteSectionInput<TProps> {
269
280
  sectionRef: WebsiteSectionRef | string;
270
281
  category: WebsiteSectionCategory;
271
282
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
283
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
284
+ anchorId?: string;
272
285
  Component: ComponentType<TProps>;
273
286
  /**
274
287
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -351,6 +364,7 @@ export function defineWebsiteSection<TProps>(
351
364
  sectionRef: input.sectionRef,
352
365
  category: input.category,
353
366
  expectedLabelKeys: input.expectedLabelKeys,
367
+ anchorId: input.anchorId,
354
368
  Component: input.Component,
355
369
  getStructuredData: input.getStructuredData,
356
370
  });
@@ -363,6 +377,7 @@ export function defineWebsiteSection<TProps>(
363
377
  sectionRef: parsed.sectionRef,
364
378
  category: parsed.category,
365
379
  expectedLabelKeys: parsed.expectedLabelKeys,
380
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
366
381
  Component: input.Component,
367
382
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
368
383
  };
@@ -137,6 +137,14 @@ compile-time prop checking.
137
137
  * and is caught by nothing until a reviewer reads the page. The
138
138
  * build and `wildo website audit` check the pack against the
139
139
  * DECLARED keys, so declare every slot the component reads.
140
+ * - `anchorId?` — the section's DOM id, so a link (`<a href="#tiers">`)
141
+ * can target it. Belongs to the DEFINITION because a page renders its
142
+ * sections list through `WebsitePageSections`, which places every
143
+ * section itself: an anchor a page author would otherwise write on a
144
+ * hand-placed `<WebsiteSection id=…>` has nowhere else to live. A
145
+ * valid HTML id that is also URL-fragment-safe: a letter, then
146
+ * letters, digits, `-` or `_`. Uniqueness on a page is the author's
147
+ * to keep, like the id attribute it becomes.
140
148
  * - `Component` — the React component that renders the section. Typed
141
149
  * as `ComponentType<unknown>` here because schema-layer cannot lock
142
150
  * the component's prop shape (props vary per section). The factory
@@ -163,6 +171,9 @@ const _WebsiteSectionDefinitionSchema = z.object({
163
171
  sectionRef: WebsiteSectionRefSchema,
164
172
  category: WebsiteSectionCategorySchema,
165
173
  expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
174
+ anchorId: z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, {
175
+ error: 'A section anchorId must start with a letter and contain only letters, digits, "-" or "_"',
176
+ }).optional(),
166
177
  Component: z.unknown(),
167
178
  getStructuredData: z.unknown().optional(),
168
179
  });
@@ -251,6 +262,8 @@ export interface DefineWebsiteSectionInput<TProps> {
251
262
  sectionRef: WebsiteSectionRef | string;
252
263
  category: WebsiteSectionCategory;
253
264
  expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
265
+ /** The section's DOM id, so a link can target it (`<a href="#tiers">`). See `WebsiteSectionDefinition.anchorId`. */
266
+ anchorId?: string;
254
267
  Component: ComponentType<TProps>;
255
268
  /**
256
269
  * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
@@ -333,6 +346,7 @@ export function defineWebsiteSection<TProps>(
333
346
  sectionRef: input.sectionRef,
334
347
  category: input.category,
335
348
  expectedLabelKeys: input.expectedLabelKeys,
349
+ anchorId: input.anchorId,
336
350
  Component: input.Component,
337
351
  getStructuredData: input.getStructuredData,
338
352
  });
@@ -345,6 +359,7 @@ export function defineWebsiteSection<TProps>(
345
359
  sectionRef: parsed.sectionRef,
346
360
  category: parsed.category,
347
361
  expectedLabelKeys: parsed.expectedLabelKeys,
362
+ ...(parsed.anchorId !== undefined ? { anchorId: parsed.anchorId } : {}),
348
363
  Component: input.Component,
349
364
  ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
350
365
  };