@wildo-ai/framework-knowledge 1.1.0

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 (922) hide show
  1. package/LICENSE +34 -0
  2. package/dist/esm/.builder.pid +9 -0
  3. package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
  4. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
  5. package/dist/esm/framework-knowledge.definitions.js +1571 -0
  6. package/dist/esm/framework-knowledge.definitions.js.map +1 -0
  7. package/dist/esm/framework-knowledge.loader.d.ts +72 -0
  8. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
  9. package/dist/esm/framework-knowledge.loader.js +258 -0
  10. package/dist/esm/framework-knowledge.loader.js.map +1 -0
  11. package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
  12. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
  13. package/dist/esm/framework-knowledge.schemas.js +23 -0
  14. package/dist/esm/framework-knowledge.schemas.js.map +1 -0
  15. package/dist/esm/index.d.ts +4 -0
  16. package/dist/esm/index.d.ts.map +1 -0
  17. package/dist/esm/index.js +4 -0
  18. package/dist/esm/index.js.map +1 -0
  19. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
  20. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
  21. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
  22. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
  23. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
  24. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
  25. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
  26. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
  27. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
  28. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
  29. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
  30. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
  31. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
  32. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
  33. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
  34. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
  35. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
  36. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
  37. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
  38. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
  39. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
  40. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
  41. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
  42. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
  43. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
  44. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
  45. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
  46. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
  47. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
  48. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
  49. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
  50. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
  51. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
  52. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
  53. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
  54. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
  55. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
  56. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
  57. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
  58. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
  59. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
  60. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
  61. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
  62. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
  63. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
  64. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
  65. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
  66. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
  67. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
  68. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
  69. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
  70. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
  71. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
  72. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
  73. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
  74. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
  75. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
  76. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
  77. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
  78. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
  79. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
  80. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
  81. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
  82. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
  83. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
  84. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
  85. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
  86. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
  87. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
  88. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
  89. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
  90. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
  91. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
  92. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
  93. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
  94. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
  95. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
  96. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
  97. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
  98. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
  99. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
  100. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
  101. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
  102. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
  103. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
  104. package/dist/knowledge/manifest.json +45 -0
  105. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
  106. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
  107. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
  108. package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
  109. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
  110. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
  111. package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
  112. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
  113. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
  114. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
  115. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
  116. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
  117. package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
  118. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
  119. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
  120. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
  121. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
  122. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
  123. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
  124. package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
  125. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
  126. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
  127. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
  128. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
  129. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
  130. package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
  131. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
  132. package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
  133. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
  134. package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
  135. package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
  136. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
  137. package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
  138. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
  139. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
  140. package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
  141. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
  142. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
  143. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
  144. package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
  145. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
  146. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
  147. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
  148. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
  149. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
  150. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
  151. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
  152. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
  153. package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
  154. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
  155. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
  156. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
  157. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
  158. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
  159. package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
  160. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
  161. package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
  162. package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
  163. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
  164. package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
  165. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
  166. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
  167. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
  168. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
  169. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
  170. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
  171. package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
  172. package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
  173. package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
  174. package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
  175. package/dist/knowledge/references/assertions.references.conventions.md +92 -0
  176. package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
  177. package/dist/knowledge/references/assertions.specification.config.md +287 -0
  178. package/dist/knowledge/references/brand.asset.config.md +167 -0
  179. package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
  180. package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
  181. package/dist/knowledge/references/brand.name.config.md +46 -0
  182. package/dist/knowledge/references/brand.snapshot.config.md +76 -0
  183. package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
  184. package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
  185. package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
  186. package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
  187. package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
  188. package/dist/knowledge/references/business-model.references.conventions.md +99 -0
  189. package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
  190. package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
  191. package/dist/knowledge/references/cli.market.generate-command.md +230 -0
  192. package/dist/knowledge/references/cli.market.utils.md +147 -0
  193. package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
  194. package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
  195. package/dist/knowledge/references/companion.market.generation-service.md +270 -0
  196. package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
  197. package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
  198. package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
  199. package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
  200. package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
  201. package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
  202. package/dist/knowledge/references/engine.saas-website.config.md +331 -0
  203. package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
  204. package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
  205. package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
  206. package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
  207. package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
  208. package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
  209. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
  210. package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
  211. package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
  212. package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
  213. package/dist/knowledge/references/example.config.design-system.full.md +162 -0
  214. package/dist/knowledge/references/example.config.navigation.full.md +71 -0
  215. package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
  216. package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
  217. package/dist/knowledge/references/example.email.template.minimal.md +54 -0
  218. package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
  219. package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
  220. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
  221. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
  222. package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
  223. package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
  224. package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
  225. package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
  226. package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
  227. package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
  228. package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
  229. package/dist/knowledge/references/example.market.category.config.md +71 -0
  230. package/dist/knowledge/references/example.market.channel.community.md +39 -0
  231. package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
  232. package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
  233. package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
  234. package/dist/knowledge/references/example.market.icp.individual.md +82 -0
  235. package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
  236. package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
  237. package/dist/knowledge/references/example.market.job.emotional.md +27 -0
  238. package/dist/knowledge/references/example.market.job.functional.md +28 -0
  239. package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
  240. package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
  241. package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
  242. package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
  243. package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
  244. package/dist/knowledge/references/example.market.proof.metric.md +39 -0
  245. package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
  246. package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
  247. package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
  248. package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
  249. package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
  250. package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
  251. package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
  252. package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
  253. package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
  254. package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
  255. package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
  256. package/dist/knowledge/references/example.module.registration.shared.md +16 -0
  257. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
  258. package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
  259. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
  260. package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
  261. package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
  262. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
  263. package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
  264. package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
  265. package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
  266. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
  267. package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
  268. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
  269. package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
  270. package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
  271. package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
  272. package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
  273. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
  274. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
  275. package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
  276. package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
  277. package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
  278. package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
  279. package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
  280. package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
  281. package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
  282. package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
  283. package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
  284. package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
  285. package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
  286. package/dist/knowledge/references/market.alternative.config.md +68 -0
  287. package/dist/knowledge/references/market.alternative.kind.md +32 -0
  288. package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
  289. package/dist/knowledge/references/market.buying-journey.config.md +43 -0
  290. package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
  291. package/dist/knowledge/references/market.category.config.md +63 -0
  292. package/dist/knowledge/references/market.channel.config.md +59 -0
  293. package/dist/knowledge/references/market.channel.kind.md +49 -0
  294. package/dist/knowledge/references/market.context-block.builder.md +544 -0
  295. package/dist/knowledge/references/market.context-block.response.md +57 -0
  296. package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
  297. package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
  298. package/dist/knowledge/references/market.gain.config.md +50 -0
  299. package/dist/knowledge/references/market.generation.response.md +108 -0
  300. package/dist/knowledge/references/market.icp.config.md +162 -0
  301. package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
  302. package/dist/knowledge/references/market.inherit-from.md +74 -0
  303. package/dist/knowledge/references/market.is-benefit-available.md +58 -0
  304. package/dist/knowledge/references/market.job.config.md +48 -0
  305. package/dist/knowledge/references/market.message-template.config.md +86 -0
  306. package/dist/knowledge/references/market.objection.config.md +56 -0
  307. package/dist/knowledge/references/market.objection.kind.md +34 -0
  308. package/dist/knowledge/references/market.pain.config.md +50 -0
  309. package/dist/knowledge/references/market.persona.config.md +64 -0
  310. package/dist/knowledge/references/market.positioning.config.md +84 -0
  311. package/dist/knowledge/references/market.proof.config.md +48 -0
  312. package/dist/knowledge/references/market.proof.kind.md +34 -0
  313. package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
  314. package/dist/knowledge/references/market.scoring.fit.md +215 -0
  315. package/dist/knowledge/references/market.snapshot.config.md +34 -0
  316. package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
  317. package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
  318. package/dist/knowledge/references/market.trigger.config.md +45 -0
  319. package/dist/knowledge/references/market.trigger.kind.md +35 -0
  320. package/dist/knowledge/references/placement-plan.config.md +330 -0
  321. package/dist/knowledge/references/platform.config.application-database.md +74 -0
  322. package/dist/knowledge/references/platform.config.application-modules.md +30 -0
  323. package/dist/knowledge/references/platform.config.backing-services.md +266 -0
  324. package/dist/knowledge/references/platform.config.cdn.md +167 -0
  325. package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
  326. package/dist/knowledge/references/platform.config.saas.md +405 -0
  327. package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
  328. package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
  329. package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
  330. package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
  331. package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
  332. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
  333. package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
  334. package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
  335. package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
  336. package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
  337. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
  338. package/dist/knowledge/references/requirements.references.conventions.md +125 -0
  339. package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
  340. package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
  341. package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
  342. package/dist/knowledge/references/roadmap.phase.config.md +149 -0
  343. package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
  344. package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
  345. package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
  346. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
  347. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
  348. package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
  349. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
  350. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
  351. package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
  352. package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
  353. package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
  355. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
  358. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
  359. package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
  360. package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
  361. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
  362. package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
  363. package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
  364. package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
  365. package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
  366. package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
  367. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
  368. package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
  369. package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
  370. package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
  371. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
  372. package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
  373. package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
  374. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
  375. package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
  376. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
  377. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
  378. package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
  379. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
  380. package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
  381. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
  382. package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
  383. package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
  384. package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
  385. package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
  386. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
  387. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
  388. package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
  389. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
  391. package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
  392. package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
  393. package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
  395. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
  396. package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
  397. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
  398. package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
  399. package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
  400. package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
  401. package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
  402. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
  403. package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
  404. package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
  405. package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
  406. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
  407. package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
  408. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
  409. package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
  410. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
  411. package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
  412. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
  413. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
  414. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
  415. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
  416. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
  417. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
  418. package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
  419. package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
  420. package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
  421. package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
  422. package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
  423. package/dist/knowledge/references/saas.models.error-type.md +45 -0
  424. package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
  425. package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
  429. package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
  430. package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
  431. package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
  432. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
  433. package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
  434. package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
  435. package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
  436. package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
  437. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
  438. package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
  439. package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
  440. package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
  441. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
  442. package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
  443. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
  444. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
  445. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
  446. package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
  447. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
  448. package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
  449. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
  450. package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
  451. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
  452. package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
  453. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
  454. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
  455. package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
  456. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
  457. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
  458. package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
  459. package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
  460. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
  461. package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
  462. package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
  463. package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
  464. package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
  465. package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
  466. package/dist/knowledge/references/saas.models.resource-type.md +24 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
  468. package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
  469. package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
  470. package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
  471. package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
  472. package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
  474. package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
  475. package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
  476. package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
  477. package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
  478. package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
  479. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
  480. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
  481. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
  482. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
  483. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
  484. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
  485. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
  486. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
  487. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
  488. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
  489. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
  490. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
  491. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
  492. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
  493. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
  494. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
  495. package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
  496. package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
  497. package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
  498. package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
  499. package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
  500. package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
  501. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
  502. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
  503. package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
  504. package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
  505. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
  506. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
  507. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
  508. package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
  509. package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
  510. package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
  511. package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
  512. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
  513. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
  514. package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
  515. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
  516. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
  517. package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
  518. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
  519. package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
  520. package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
  521. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
  522. package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
  523. package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
  524. package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
  525. package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
  526. package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
  527. package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
  528. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
  529. package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
  530. package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
  531. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
  532. package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
  533. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
  534. package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
  535. package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
  536. package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
  537. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
  538. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
  539. package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
  540. package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
  541. package/dist/knowledge/references/saas.website.page.context.md +57 -0
  542. package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
  543. package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
  544. package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
  545. package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
  546. package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
  547. package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
  548. package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
  549. package/dist/knowledge/references/saas.website.refs.page.md +56 -0
  550. package/dist/knowledge/references/saas.website.refs.section.md +57 -0
  551. package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
  552. package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
  553. package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
  554. package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
  555. package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
  556. package/dist/knowledge/references/saas.website.section.component.md +138 -0
  557. package/dist/knowledge/references/saas.website.section.context.md +63 -0
  558. package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
  559. package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
  560. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
  561. package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
  562. package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
  563. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
  564. package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
  565. package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
  566. package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
  567. package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
  568. package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
  569. package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
  570. package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
  571. package/dist/knowledge/references/vision.constraint.config.md +66 -0
  572. package/dist/knowledge/references/vision.idea.config.md +45 -0
  573. package/dist/knowledge/references/vision.mission.config.md +46 -0
  574. package/dist/knowledge/references/vision.problem.config.md +51 -0
  575. package/dist/knowledge/references/vision.references.conventions.md +115 -0
  576. package/dist/knowledge/references/vision.snapshot.config.md +85 -0
  577. package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
  578. package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
  579. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
  580. package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
  581. package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
  582. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
  583. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
  584. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
  585. package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
  586. package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
  587. package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
  588. package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
  589. package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
  590. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
  591. package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
  592. package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
  593. package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
  594. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
  595. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
  596. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
  597. package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
  598. package/dist/knowledge/references/zod.factories.code.md +127 -0
  599. package/dist/knowledge/references/zod.factories.duration.md +246 -0
  600. package/dist/knowledge/references/zod.factories.money.md +166 -0
  601. package/dist/knowledge/references/zod.factories.phone.md +88 -0
  602. package/dist/knowledge/references/zod.factories.range.md +174 -0
  603. package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
  604. package/dist/knowledge/registries/framework-topics.json +5212 -0
  605. package/dist/knowledge/registries/playbooks.json +488 -0
  606. package/dist/knowledge/registries/source-tags.json +7664 -0
  607. package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
  608. package/dist/knowledge/skills/INDEX.md +349 -0
  609. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
  610. package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
  611. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
  612. package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
  613. package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
  614. package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
  615. package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
  616. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  617. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
  618. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
  619. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
  620. package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
  621. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
  622. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
  623. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
  624. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
  625. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
  626. package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
  627. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
  628. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
  629. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
  630. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
  631. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
  632. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
  633. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
  634. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
  635. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
  636. package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
  637. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
  638. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
  639. package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
  640. package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
  641. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
  642. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
  643. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
  644. package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
  645. package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
  646. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
  647. package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
  648. package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
  649. package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
  650. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
  651. package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
  652. package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
  653. package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
  654. package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
  655. package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
  656. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
  657. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
  658. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
  659. package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
  660. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
  661. package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
  662. package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
  663. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
  664. package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
  665. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
  666. package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
  667. package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
  668. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
  669. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
  670. package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
  671. package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
  672. package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
  673. package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
  674. package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
  675. package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
  676. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
  677. package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
  678. package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
  679. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
  680. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
  681. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
  682. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
  683. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
  684. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
  685. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
  686. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
  687. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
  688. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
  689. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
  690. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
  691. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
  692. package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
  693. package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
  694. package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
  695. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
  696. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
  697. package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
  698. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
  699. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
  700. package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
  701. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
  702. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
  703. package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
  704. package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
  705. package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
  706. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
  707. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
  708. package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
  709. package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
  710. package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
  711. package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
  712. package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
  713. package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
  714. package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
  715. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
  716. package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
  717. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
  718. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
  719. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
  720. package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
  721. package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
  722. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
  723. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
  724. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
  725. package/dist/knowledge/skills/market-category/SKILL.md +290 -0
  726. package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
  727. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
  728. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
  729. package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
  730. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
  731. package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
  732. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
  733. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
  734. package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
  735. package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
  736. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
  737. package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
  738. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
  739. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
  740. package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
  741. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
  742. package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
  743. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
  744. package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
  745. package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
  746. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
  747. package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
  748. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
  749. package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
  750. package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
  751. package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
  752. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
  753. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
  754. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
  755. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
  756. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
  757. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
  758. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
  759. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
  760. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
  761. package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
  762. package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
  763. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
  764. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
  765. package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
  766. package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
  767. package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
  768. package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
  769. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
  770. package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
  771. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
  772. package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
  773. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
  774. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
  775. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
  776. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
  777. package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
  778. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
  779. package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
  780. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
  781. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
  782. package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
  783. package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
  784. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
  785. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
  786. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
  787. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
  788. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
  789. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
  790. package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
  791. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
  792. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
  793. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
  794. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
  795. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
  796. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
  797. package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
  798. package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
  799. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
  800. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
  801. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
  802. package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
  803. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
  804. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
  805. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
  806. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
  807. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
  808. package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
  809. package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
  810. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
  811. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
  812. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
  813. package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
  814. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
  815. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
  816. package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
  817. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
  818. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
  819. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
  820. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
  821. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
  822. package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
  823. package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
  824. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
  825. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
  826. package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
  827. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
  828. package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
  829. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
  830. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
  831. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
  832. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
  833. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
  834. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
  835. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
  836. package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
  837. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
  838. package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
  839. package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
  840. package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
  841. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
  842. package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
  843. package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
  844. package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
  845. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
  846. package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
  847. package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
  848. package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
  849. package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
  850. package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
  851. package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
  852. package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
  853. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
  854. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
  855. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
  856. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
  857. package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
  858. package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
  859. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
  860. package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
  861. package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
  862. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
  863. package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
  864. package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
  865. package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
  866. package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
  867. package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
  868. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
  869. package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
  870. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
  871. package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
  872. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
  873. package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
  874. package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
  875. package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
  876. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
  877. package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
  878. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
  879. package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
  880. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
  881. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
  882. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
  883. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
  884. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
  885. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
  886. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
  887. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
  888. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
  889. package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
  890. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
  891. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
  892. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
  893. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
  894. package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
  895. package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
  896. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
  897. package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
  898. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
  899. package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
  900. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
  901. package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
  902. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
  903. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
  904. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
  905. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
  906. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
  907. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
  908. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
  909. package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
  910. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
  911. package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
  912. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
  913. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
  914. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
  915. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
  916. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
  917. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
  918. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
  919. package/dist/knowledge/topic-index.json +17510 -0
  920. package/dist/tsconfig.build.tsbuildinfo +1 -0
  921. package/dist/tsconfig.tsbuildinfo +1 -0
  922. package/package.json +49 -0
@@ -0,0 +1,934 @@
1
+ ---
2
+ name: website-section-pricing
3
+ description: Author a Pricing section using `defineWebsiteSection({ category: WebsiteSectionCategory.PRICING, … })` with first-class `Product` + `Offer` (or `AggregateOffer`) JSON-LD. Use when the user says "add a pricing section", "compose pricing tiers", "wire pricing JSON-LD for SEO", or "customize the pricing comparison layout".
4
+ ---
5
+
6
+ # Website Section: Pricing
7
+
8
+ ### Target Application Framing
9
+
10
+ This knowledge is for configuring behavior in the target application.
11
+ Wildo is the framework surface being used, not the product being built.
12
+
13
+ Read and apply these patterns from the application-developer point of view:
14
+
15
+ - how the application should configure the relevant app-level file
16
+ - how the application should use framework-provided factories, enums, and helpers
17
+ - how the application should avoid mixing frontend, backend, and infrastructure concerns
18
+
19
+
20
+ # Website Section — Authoring API (source-backed)
21
+
22
+ Shared API excerpts for every `website_section_<category>` skill. The
23
+ contract is identical across categories; the per-category guidance lives
24
+ in each skill's own `SKILL.md`.
25
+
26
+ ## Category vocabulary (closed enum)
27
+
28
+ The `category` field on `defineWebsiteSection` is a closed enum, not a
29
+ free string. Adding a new value requires seeding a matching
30
+ `website_section_<value>` skill folder (1:1 invariant).
31
+
32
+ ## Import Origins
33
+
34
+ - `@wildo-ai/saas-website`
35
+
36
+ ## Source Excerpts
37
+
38
+ ### Origin Package: `@wildo-ai/saas-website`
39
+
40
+ ```typescript
41
+ *
42
+ * `WebsiteSectionCategory` — closed vocabulary tagging the **structural
43
+ * intent** of a section.
44
+ *
45
+ * The category is NOT a layout-shape constraint and NOT a CSS class; the
46
+ * framework ships zero concrete sections and never inspects
47
+ * the category at render time. The category exists for three orthogonal
48
+ * non-render concerns:
49
+ *
50
+ * 1. **Structured-data dispatch**: the
51
+ * SEO library reads `WebsiteSectionDefinition.category` to decide
52
+ * which JSON-LD vocabulary the section's `getStructuredData()` hook
53
+ * is allowed to emit. e.g. `PRICING` may emit `Product` /
54
+ * `AggregateOffer`; `FAQ` may emit `FAQPage`; `HERO` may emit
55
+ * `Organization` / `WebSite`. Mismatches are surfaced as build-time
56
+ * warnings.
57
+ * 2. **Authoring guidance**: each value has matching application-builder
58
+ * guidance. When introducing a new category, provide its public authoring
59
+ * method before asking an application to use it.
60
+ * 3. **Analytics labelling**: the runtime emits
61
+ * `data-section-category="…"` on the `<WebsiteSection>` wrapper so
62
+ * analytics tooling can group section impressions
63
+ * without parsing className conventions.
64
+ *
65
+ * **Closed vocabulary on purpose**: a free-string `category` would
66
+ * defeat the skill-mapping and SEO-dispatch contracts. Consumers who
67
+ * need a wholly-novel section shape use the `RAW` advanced path
68
+ * (`website-factory-advanced` skill) which bypasses the category
69
+ * vocabulary entirely.
70
+ *
71
+ * **Adding a value**: requires (a) a new entry here, (b) a matching
72
+ * `website_section_<value>` skill stub, (c) (optionally) a
73
+ * structured-data dispatch entry in the SEO library. Removing a value
74
+ * is a labelled rename — every consumer's
75
+ * `defineWebsiteSection({ category: … })` declaration breaks at compile
76
+ * time, which is the desired loud failure.
77
+ */
78
+ export enum WebsiteSectionCategory {
79
+ HERO = 'hero',
80
+ CTA = 'cta',
81
+ FEATURE_BENEFIT_SUMMARY = 'feature-benefit-summary',
82
+ FEATURE_DETAIL = 'feature-detail',
83
+ PRICING = 'pricing',
84
+ CONTACT = 'contact',
85
+ SOCIAL_PROOF = 'social-proof',
86
+ FAQ = 'faq',
87
+ FOOTER_CTA = 'footer-cta',
88
+ /**
89
+ * Escape hatch for sections that don't fit any standard category
90
+ * (third-party widgets, custom one-off marketing pieces). Skips the
91
+ * SEO-dispatch contract — the section's `getStructuredData()` may
92
+ * return any vocabulary, no validation. Authors should prefer a
93
+ * concrete category whenever possible; using `RAW` opts the section
94
+ * out of the framework's structured-data safety net.
95
+ */
96
+ RAW = 'raw',
97
+ }
98
+
99
+ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCategory> =
100
+ z.enum(WebsiteSectionCategory);
101
+ ```
102
+
103
+ ## Section definition (the contract `defineWebsiteSection` produces)
104
+
105
+ The schema declares the **observable contract** the page-manifest
106
+ registration, label-pack validator, and SEO dispatcher depend on. The
107
+ factory layer adds type-preserving generics on top so JSX usage keeps
108
+ compile-time prop checking.
109
+
110
+ ## Import Origins
111
+
112
+ - `@wildo-ai/saas-website`
113
+
114
+ ## Source Excerpts
115
+
116
+ ### Origin Package: `@wildo-ai/saas-website`
117
+
118
+ ```typescript
119
+ *
120
+ * `WebsiteSectionDefinition` — the runtime contract returned by the
121
+ * `defineWebsiteSection({ … })` factory (authored as a separate
122
+ * `core/define-website-section.tsx` module in Phase 2 because it carries
123
+ * React types in its inputs). The shape is declared in `schemas/`
124
+ * because it is the **observable contract** the page-manifest
125
+ * registration, label-pack validator, and SEO dispatcher depend on.
126
+ *
127
+ * **Shape rationale** (each field carries semantic weight — see
128
+ * `design-philosophy.mdc`):
129
+ *
130
+ * - `sectionRef` — the section's identity inside its hosting page.
131
+ * Uniqueness is enforced **per page** at manifest registration time
132
+ * (a section can be reused with the same `sectionRef` across pages
133
+ * when its label-key root is intentionally shared).
134
+ * - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
135
+ * for SEO-dispatch, skill-mapping, and analytics labelling.
136
+ * - `expectedLabelKeys` — the **fully-composed** label keys the section
137
+ * commits to consuming. The plan originally proposed leaf-relative
138
+ * keys (`'headline'`) resolved at runtime against the
139
+ * page+section context, but storing the fully-composed key on the
140
+ * definition has three concrete benefits:
141
+ * 1. The label-pack validator (`validateLabelPackAgainstManifest`)
142
+ * runs as a pure function with no need to walk the JSX tree at
143
+ * build time to discover the leaf-to-key resolution.
144
+ * 2. The contract is auditable from outside the React render
145
+ * graph — `wildo website audit` can list a page's required keys
146
+ * without booting React.
147
+ * 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
148
+ * survive in Phase 2 — the hook composes the leaf with the
149
+ * page+section context and validates the result against
150
+ * `expectedLabelKeys`.
151
+ * - `Component` — the React component that renders the section. Typed
152
+ * as `ComponentType<unknown>` here because schema-layer cannot lock
153
+ * the component's prop shape (props vary per section). The factory
154
+ * function (`defineWebsiteSection<TProps>(…)`) preserves the precise
155
+ * prop type at the consumer call site via generics; this schema only
156
+ * guards the runtime shape of "is callable as a React component".
157
+ * - `getStructuredData?` — optional pure function the SEO/AEO/GEO
158
+ * builder library invokes at static-build time to materialize JSON-LD
159
+ * for the section. The return type is intentionally `unknown` here;
160
+ * the SEO library narrows by `category` (e.g. `PRICING` →
161
+ * `Product | AggregateOffer`).
162
+ *
163
+ * **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
164
+ * cannot meaningfully validate "is a React component" beyond
165
+ * `typeof === 'function'`, and the false-positive cost (any function
166
+ * passes) is too high for the value (none — the consumer either
167
+ * imports a real component or fails at JSX render time with a clearer
168
+ * error). Using `z.unknown()` + a TS-side type cast keeps the runtime
169
+ * cost zero and the type-safety contract entirely on the TS side
170
+ * (where it actually has teeth via the factory's generic).
171
+ */
172
+ const _WebsiteSectionDefinitionSchema = z.object({
173
+ sectionRef: WebsiteSectionRefSchema,
174
+ category: WebsiteSectionCategorySchema,
175
+ expectedLabelKeys: z.array(WebsiteLabelKeySchema).readonly(),
176
+ Component: z.unknown(),
177
+ getStructuredData: z.unknown().optional(),
178
+ });
179
+
180
+ export const WebsiteSectionDefinitionSchema: typeof _WebsiteSectionDefinitionSchema =
181
+ _WebsiteSectionDefinitionSchema;
182
+
183
+ /**
184
+ * Runtime shape of `WebsiteSectionDefinition`. Note: `Component` and
185
+ * `getStructuredData` are typed precisely on the factory return type
186
+ * (`defineWebsiteSection<TProps>` in Phase 2); the schema-inferred
187
+ * type is the lowest common denominator used at the persistence /
188
+ * validation boundary only.
189
+ *
190
+ * **Why `ComponentType<any>` and NOT `ComponentType<unknown>`**:
191
+ * React component props are CONTRAVARIANT in `ComponentType<T>` —
192
+ * a narrower `ComponentType<{ foo: string }>` is NOT assignable to
193
+ * `ComponentType<unknown>` (because a caller could pass an `unknown`
194
+ * the narrower component cannot accept). This made every consumer
195
+ * who built sections via `defineWebsiteSection<TProps>(…)` unable
196
+ * to feed the resulting `TypedWebsiteSectionDefinition<TProps>` to
197
+ * helpers typed against the bare `WebsiteSectionDefinition` —
198
+ * collectors, validators, and registries. Using `any` here is the
199
+ * exact escape hatch the React typings themselves use for
200
+ * heterogeneous component containers (`React.forwardRef`,
201
+ * `React.lazy`'s internal component slot, etc.) and matches the
202
+ * runtime contract: the framework NEVER instantiates these
203
+ * components directly with arbitrary props — the consumer's JSX
204
+ * supplies the right props at the call site.
205
+ */
206
+ export interface WebsiteSectionDefinition extends z.infer<typeof _WebsiteSectionDefinitionSchema> {
207
+ Component: ComponentType<any>;
208
+ /**
209
+ * Optional pure function the SEO/AEO/GEO renderer invokes at
210
+ * static-build time to materialize JSON-LD for the section.
211
+ *
212
+ * **Why typed as `WebsiteStructuredDataReturn` (not `unknown`)** —
213
+ * a typed return shape gives section authors autocomplete on
214
+ * `@type` / `@id` / `@context` (the framework-owned fields) while
215
+ * keeping all other fields free-form (Schema.org has hundreds of
216
+ * optional fields per entity; locking them in TS would be both
217
+ * impractical and brittle as Schema.org evolves). The companion
218
+ * catalog reconciliation surface catches missing-required and
219
+ * deprecated-field-used at the SEMANTIC layer (warning-only per
220
+ * D-AG4), so the runtime type stays loose.
221
+ *
222
+ * Returns `null`, `undefined`, or `[]` when the section has no
223
+ * structured-data contribution for the current state — the
224
+ * renderer short-circuits all three.
225
+ */
226
+ getStructuredData?: () => WebsiteStructuredDataReturn;
227
+ }
228
+ ```
229
+
230
+ ## `defineWebsiteSection<TProps>` factory
231
+
232
+ Always use the factory — never build a `WebsiteSectionDefinition`
233
+ literal by hand. The factory parses inputs through the schema (single
234
+ audited validation chokepoint) AND preserves the caller's `TProps` so
235
+ JSX composition stays strongly typed.
236
+
237
+ ## Import Origins
238
+
239
+ - `@wildo-ai/saas-website`
240
+
241
+ ## Source Excerpts
242
+
243
+ ### Origin Package: `@wildo-ai/saas-website`
244
+
245
+ ```typescript
246
+ *
247
+ * Input shape consumed by `defineWebsiteSection<TProps>`. Mirrors
248
+ * `WebsiteSectionDefinition` but keeps `Component` typed against the
249
+ * caller-supplied generic so the precise prop shape survives end-to-end
250
+ * (the consumer's `<HeroSection />` JSX can keep its strongly-typed
251
+ * props after going through the factory).
252
+ *
253
+ * **String inputs vs. branded inputs**: `sectionRef` and
254
+ * `expectedLabelKeys` accept raw strings as well as already-branded
255
+ * values. The factory parses them through the underlying schemas, so
256
+ * either path is safe — accepting strings directly removes the
257
+ * ergonomic drag of forcing every section author to remember to call
258
+ * `WebsiteSectionRefSchema.parse(...)` in their definition.
259
+ */
260
+ export interface DefineWebsiteSectionInput<TProps> {
261
+ sectionRef: WebsiteSectionRef | string;
262
+ category: WebsiteSectionCategory;
263
+ expectedLabelKeys: readonly (WebsiteLabelKey | string)[];
264
+ Component: ComponentType<TProps>;
265
+ /**
266
+ * See `WebsiteSectionDefinition.getStructuredData?` JSDoc for the
267
+ * full authoring contract. The factory passes the function through
268
+ * unchanged; the framework invokes it at static-build time and
269
+ * forwards the return value to `renderPageStructuredData()`.
270
+ */
271
+ getStructuredData?: () => WebsiteStructuredDataReturn;
272
+ }
273
+
274
+ /**
275
+ * Return shape of `defineWebsiteSection<TProps>`. Identical to
276
+ * `WebsiteSectionDefinition` except `Component` retains the
277
+ * caller-supplied generic prop shape rather than the schema's
278
+ * lowest-common-denominator `ComponentType<unknown>`.
279
+ *
280
+ * **Why this matters**: a consumer's `pageComponent` JSX composes
281
+ * sections like `<HERO_SECTION.Component {...heroProps} />`. Without
282
+ * preserving `TProps`, the spread would be untyped and a renamed prop
283
+ * would silently miss the type system. With `TProps` preserved, the
284
+ * call site fails to compile the moment the prop contract drifts.
285
+ */
286
+ export interface TypedWebsiteSectionDefinition<TProps>
287
+ extends Omit<WebsiteSectionDefinition, 'Component' | 'getStructuredData'> {
288
+ Component: ComponentType<TProps>;
289
+ getStructuredData?: () => WebsiteStructuredDataReturn;
290
+ }
291
+
292
+ /**
293
+ * `defineWebsiteSection<TProps>` — factory that materializes a
294
+ * `WebsiteSectionDefinition` from authored input.
295
+ *
296
+ * **Two responsibilities**, one entry point:
297
+ * 1. Runtime validation — parses the input through
298
+ * `WebsiteSectionDefinitionSchema` so brand checks, regex
299
+ * validations, and array refinements run at module load time
300
+ * (not at render time, not at build-output time).
301
+ * 2. Type preservation — returns an object whose `Component` field
302
+ * keeps the caller-supplied `TProps`, so JSX usage of the
303
+ * returned section retains compile-time prop checking.
304
+ *
305
+ * **Why a factory instead of constructing the literal directly**:
306
+ * - Consumers don't have to remember to parse refs / keys
307
+ * themselves before assembling the literal.
308
+ * - The schema parse provides a single audited validation chokepoint
309
+ * so `wildo website audit` (Phase 7) can re-validate definitions
310
+ * without re-entering the React graph.
311
+ * - The factory is the documented authoring API the
312
+ * `website_factory_authoring` skill targets — keeping the
313
+ * authoring surface narrow lets the framework evolve the
314
+ * internal schema (add fields, refinements) without churning
315
+ * every section definition in every consumer app.
316
+ *
317
+ * @param input section authoring input (see `DefineWebsiteSectionInput`).
318
+ * @returns a `TypedWebsiteSectionDefinition<TProps>` with `Component`
319
+ * preserved at the precise prop type.
320
+ *
321
+ * @example
322
+ * interface HeroProps {
323
+ * headlineKey: WebsiteLabelKey;
324
+ * subheadlineKey: WebsiteLabelKey;
325
+ * }
326
+ * function HeroSection({ headlineKey, subheadlineKey }: HeroProps) {
327
+ * // …
328
+ * }
329
+ * export const HERO_SECTION = defineWebsiteSection<HeroProps>({
330
+ * sectionRef: 'hero',
331
+ * category: WebsiteSectionCategory.HERO,
332
+ * expectedLabelKeys: [
333
+ * 'website.landing.hero.headline',
334
+ * 'website.landing.hero.subheadline',
335
+ * ],
336
+ * Component: HeroSection,
337
+ * });
338
+ */
339
+ export function defineWebsiteSection<TProps>(
340
+ input: DefineWebsiteSectionInput<TProps>,
341
+ ): TypedWebsiteSectionDefinition<TProps> {
342
+ const parsed = WebsiteSectionDefinitionSchema.parse({
343
+ sectionRef: input.sectionRef,
344
+ category: input.category,
345
+ expectedLabelKeys: input.expectedLabelKeys,
346
+ Component: input.Component,
347
+ getStructuredData: input.getStructuredData,
348
+ });
349
+ /**
350
+ * Re-attach `Component` and `getStructuredData` from the original
351
+ * input so the precise generic types survive — `parsed.Component`
352
+ * is `unknown` per the schema's `z.unknown()` contract.
353
+ */
354
+ return {
355
+ sectionRef: parsed.sectionRef,
356
+ category: parsed.category,
357
+ expectedLabelKeys: parsed.expectedLabelKeys,
358
+ Component: input.Component,
359
+ ...(input.getStructuredData ? { getStructuredData: input.getStructuredData } : {}),
360
+ };
361
+ }
362
+ ```
363
+
364
+ ## Runtime label hook (leaf-relative; resolved against page+section context)
365
+
366
+ Inside the section's React component, always read labels via
367
+ `useWebsiteLabel('<leaf>')`. The hook composes the leaf with the
368
+ ambient page+section context to produce the fully-qualified
369
+ `WebsiteLabelKey` and validates it against the section's
370
+ `expectedLabelKeys` declaration.
371
+
372
+ ## Import Origins
373
+
374
+ - `@wildo-ai/saas-website`
375
+
376
+ ## Source Excerpts
377
+
378
+ ### Origin Package: `@wildo-ai/saas-website`
379
+
380
+ ```typescript
381
+ *
382
+ * `useWebsiteLabel(slotPath)` — leaf-relative label resolution.
383
+ *
384
+ * Composes the slot leaf with the active page+section context to
385
+ * derive the full `WebsiteLabelKey` (`website.{pageRef}.{sectionRef}.{slotPath}`),
386
+ * looks it up in the active locale's label pack, and returns the
387
+ * resolved string.
388
+ *
389
+ * **Author ergonomics**: section authors call
390
+ * `useWebsiteLabel('headline')` from inside their section component
391
+ * without ever typing the page or section ref — the hook reads them
392
+ * from context. This keeps section components portable across pages
393
+ * (the same `<HeroSection />` can be reused on `landing` and on a
394
+ * dedicated `/about` page; only the surrounding `<WebsiteSection
395
+ * sectionRef="hero">` differs, and the label keys re-root accordingly).
396
+ *
397
+ * **Fail-loud diagnostics** for missing keys: returns the composed key
398
+ * itself (visible in the rendered DOM as e.g. `website.landing.hero.headline`)
399
+ * AND emits a `console.warn`. The visible-key fallback is preferred
400
+ * over an empty string or a thrown error because:
401
+ * - empty string silently breaks layout (zero-height heading) and
402
+ * leaks past visual review,
403
+ * - throwing would crash the entire page on a single missing label
404
+ * while the SEO crawler indexes a 500 page,
405
+ * - the rendered key is a clear authoring signal ("ship the missing
406
+ * pack entry") that designers and copywriters can spot without
407
+ * opening DevTools.
408
+ *
409
+ * **Hard guards** (each enforced by the underlying context hooks):
410
+ * - MUST be called inside `<WebsiteRuntimeContextProvider>`,
411
+ * - MUST be called inside `<WebsitePageLayout>`,
412
+ * - MUST be called inside `<WebsiteSection>`.
413
+ *
414
+ * @param slotPath leaf identifier (eg. `'headline'`, `'cta.primary'`,
415
+ * `'tiers[0].name'`). Anything that survives the slot
416
+ * portion of `WebsiteLabelKeySchema`'s regex.
417
+ * @returns the resolved label string, or the composed key itself when
418
+ * the pack lacks an entry (with a `console.warn`).
419
+ */
420
+ export function useWebsiteLabel(slotPath: string): string {
421
+ const { labelPack } = useWebsiteRuntime();
422
+ const { pageRef } = useWebsitePage();
423
+ const { sectionRef } = useWebsiteSection();
424
+
425
+ /**
426
+ * Compose + parse memoized on the three identity inputs. The parse
427
+ * itself is cheap (regex + brand) but executing it on every render
428
+ * of every label-bound primitive in a section adds up across a
429
+ * 12-section landing page.
430
+ */
431
+ const fullKey = useMemo<WebsiteLabelKey>(
432
+ () =>
433
+ composeWebsiteLabelKey({
434
+ pageRef: pageRef as unknown as string,
435
+ sectionRef: sectionRef as unknown as string,
436
+ slotPath,
437
+ }),
438
+ [pageRef, sectionRef, slotPath],
439
+ );
440
+
441
+ const resolved = labelPack[fullKey as unknown as string];
442
+ if (resolved === undefined) {
443
+ console.warn(
444
+ `[useWebsiteLabel] Missing label for key "${fullKey as unknown as string}". ` +
445
+ `Add it to the active locale's pack (or remove the section's claim on this slot).`,
446
+ );
447
+ return fullKey as unknown as string;
448
+ }
449
+ return resolved;
450
+ }
451
+ ```
452
+
453
+ ## Section wrapper (provides section context, emits semantic landmark + analytics attrs)
454
+
455
+ The framework's `<WebsiteSection>` wrapper is what the page composition
456
+ mounts to host a section's component. It provides
457
+ `WebsiteSectionContext`, renders a semantic `<section>` with
458
+ `data-section-ref` and `data-section-category`, and forwards a11y
459
+ pass-throughs (`aria-labelledby`, `role`, etc.).
460
+
461
+ ## Import Origins
462
+
463
+ - `@wildo-ai/saas-website`
464
+
465
+ ## Source Excerpts
466
+
467
+ ### Origin Package: `@wildo-ai/saas-website`
468
+
469
+ ```tsx
470
+ *
471
+ * `WebsiteSection` — the per-section structural primitive.
472
+ *
473
+ * **Three responsibilities** (semantic-weight discipline):
474
+ *
475
+ * 1. **Provides `WebsiteSectionContext`** — registers the active
476
+ * sectionRef + category so leaf primitives (`useWebsiteLabel`,
477
+ * analytics overlays, structured-data emitters) can derive
478
+ * keys / metadata without re-typing the section's identity.
479
+ * 2. **Renders a semantic `<section>` landmark** — emits
480
+ * `data-section-ref` and `data-section-category` attributes so
481
+ * analytics tooling and SEO crawlers can identify and group
482
+ * sections without parsing className conventions. Optional
483
+ * `id` prop wires up anchor-link navigation
484
+ * (`<a href="#pricing">`).
485
+ * 3. **Provides a styling seam** — `className` is forwarded to the
486
+ * `<section>` element so designers can apply utility-class
487
+ * decorations (background, padding, max-width container) without
488
+ * having to compose multiple wrappers.
489
+ *
490
+ * **Why NOT render a `<div>` instead of `<section>`**: marketing
491
+ * pages benefit from semantic landmarks for SEO scoring and
492
+ * accessibility (screen-reader section navigation). A `<section>`
493
+ * with `data-section-category="hero"` is structurally meaningful;
494
+ * a `<div>` with the same data-attribute carries the same metadata
495
+ * but loses the landmark benefit.
496
+ *
497
+ * **Why expose `as` is NOT a prop**: switching the rendered tag
498
+ * (`<article>` for blog post bodies, `<aside>` for sidebar widgets)
499
+ * is legitimate but rare enough to be worth a separate primitive
500
+ * (Phase 4: `<WebsiteAside>`, `<WebsiteArticle>`). Keeping
501
+ * `WebsiteSection` rendered as a literal `<section>` removes a
502
+ * rarely-used prop from the section-author API and keeps the SEO
503
+ * landmark contract guaranteed at the type level.
504
+ */
505
+ export interface WebsiteSectionProps {
506
+ /**
507
+ * The section's ref. Accepts an already-branded `WebsiteSectionRef`
508
+ * or a raw string — the layout parses through
509
+ * `WebsiteSectionRefSchema` so a malformed ref fails loud at
510
+ * render. Typically sourced from the page manifest's
511
+ * `sectionRefs[]` (eg. `<WebsiteSection sectionRef="hero" …>`).
512
+ */
513
+ sectionRef: WebsiteSectionRef | string;
514
+ /**
515
+ * The section's structural intent (see `WebsiteSectionCategory`).
516
+ * Required at the wrapper level (rather than only on the section
517
+ * definition) because the wrapper emits `data-section-category`
518
+ * for analytics, and asking the wrapper to look up the category
519
+ * on a separate manifest registry would re-introduce the runtime
520
+ * coupling the per-section context exists to avoid.
521
+ */
522
+ category: WebsiteSectionCategory;
523
+ /**
524
+ * Optional DOM id. Wires anchor-link navigation
525
+ * (`<a href="#pricing">`). When omitted, the section has no DOM
526
+ * id — by design; not every section is an anchor target.
527
+ */
528
+ id?: string;
529
+ /**
530
+ * Optional className applied to the `<section>` element. Used by
531
+ * designers for layout / spacing utilities. Section components
532
+ * themselves should NOT pass className through to this wrapper —
533
+ * keep the styling responsibility at the page-composition level.
534
+ */
535
+ className?: string;
536
+ /**
537
+ * The section's body. Typically a single section component
538
+ * (`<HeroSection {…heroProps} />`). May be plain JSX for one-off
539
+ * sections that don't justify a `defineWebsiteSection` factory call.
540
+ */
541
+ children: ReactNode;
542
+ /**
543
+ * Pass-through `aria-*` / `role` attributes for sections that need
544
+ * to refine their landmark semantics (eg. `aria-label="Featured
545
+ * customer logos"` on a logo wall).
546
+ */
547
+ ariaLabel?: string;
548
+ ariaLabelledBy?: string;
549
+ }
550
+
551
+ export function WebsiteSection({
552
+ sectionRef,
553
+ category,
554
+ id,
555
+ className,
556
+ children,
557
+ ariaLabel,
558
+ ariaLabelledBy,
559
+ }: WebsiteSectionProps): ReactNode {
560
+ const safeSectionRef = useMemo<WebsiteSectionRef>(
561
+ () => WebsiteSectionRefSchema.parse(sectionRef),
562
+ [sectionRef],
563
+ );
564
+
565
+ const sectionContextValue = useMemo<WebsiteSectionContextValue>(
566
+ () => ({ sectionRef: safeSectionRef, category }),
567
+ [safeSectionRef, category],
568
+ );
569
+
570
+ /**
571
+ * Build the `<section>` attribute set imperatively to keep
572
+ * `aria-*` props off the element when omitted (rendering
573
+ * `aria-label={undefined}` still emits the attribute in some
574
+ * React versions — explicit absence is cleaner).
575
+ */
576
+ const sectionAttrs: HTMLAttributes<HTMLElement> = {
577
+ className,
578
+ };
579
+ if (id !== undefined) sectionAttrs.id = id;
580
+ if (ariaLabel !== undefined) sectionAttrs['aria-label'] = ariaLabel;
581
+ if (ariaLabelledBy !== undefined) sectionAttrs['aria-labelledby'] = ariaLabelledBy;
582
+
583
+ return (
584
+ <WebsiteSectionContextProvider value={sectionContextValue}>
585
+ <section
586
+ data-section-ref={safeSectionRef as unknown as string}
587
+ data-section-category={category}
588
+ {...sectionAttrs}
589
+ >
590
+ {children}
591
+ </section>
592
+ </WebsiteSectionContextProvider>
593
+ );
594
+ }
595
+ WebsiteSection.displayName = 'WebsiteSection';
596
+ ```
597
+
598
+
599
+ > **Framework rule**: the installed `@wildo-ai/saas-website` package ships **no concrete
600
+ > Pricing component**. This skill documents the
601
+ > `defineWebsiteSection<TProps>` authoring pattern with first-class
602
+ > `Product` + `Offer` JSON-LD emission via `getStructuredData()`.
603
+
604
+ ## Overview
605
+
606
+ A Pricing section displays N comparable tiers (typically 2–4). Each
607
+ tier carries a name, a price expression, a pitch line, a bullet list
608
+ of included capabilities, and a CTA (sign up, contact sales, etc.).
609
+
610
+ The pricing section is one of the few categories where **structured
611
+ data emission is mandatory in practice**: emitting `Product` + `Offer`
612
+ (or `AggregateOffer` when the tier is a price range) materially
613
+ improves SERP rendering AND lets answer-engine LLMs cite pricing
614
+ without hallucinating.
615
+
616
+ The category drives:
617
+
618
+ 1. **SEO/AEO/GEO dispatch** — `category: PRICING` allows `Product`,
619
+ `Offer`, `AggregateOffer`. Other vocabularies are rejected.
620
+ 2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.PRICING`.
621
+ 3. **Analytics labelling** — `data-section-category="pricing"` is the
622
+ funnel-step grouping for tier-impression tracking.
623
+
624
+ ## App Paths
625
+
626
+ | Surface | Glob (relative to app root) |
627
+ |---|---|
628
+ | Section component + factory call | `website/src/sections/pricing.section.tsx` |
629
+ | Page composition | `website/src/pages-impl/pricing.page.tsx` |
630
+ | Label pack (per locale) | `website/src/i18n/<locale>.json` |
631
+ | Tier configuration (currency-aware, locale-neutral) | `website/src/sections/pricing.config.ts` |
632
+
633
+ ## When to Use
634
+
635
+ - Surfacing comparable plan tiers with a primary "buy" / "start"
636
+ action per tier.
637
+ - Pricing is locale-stable (currency may differ; copy is per-locale).
638
+ - Search engines should index the price points (yes — almost always
639
+ the right answer for SaaS).
640
+
641
+ ## When NOT to Use
642
+
643
+ - Pricing requires a sales conversation (no published tiers) → use a
644
+ CTA section pointing at `book-demo` instead.
645
+ - Single price (no tiers) → still use this section but with a
646
+ one-tier configuration; the JSON-LD becomes a single `Offer` rather
647
+ than `AggregateOffer`.
648
+
649
+ ## Workflow
650
+
651
+ ### Step 1: Author the locale-neutral tier configuration
652
+
653
+ Tier names, currencies, and bullet identifiers are stable across
654
+ locales; only the human-readable copy varies. Keep the configuration
655
+ in a typed module (`pricing.config.ts`) and reference label keys for
656
+ the copy.
657
+
658
+ ### Step 2: Author the component
659
+
660
+ Render the tiers as a grid (or table for >3 tiers). Read all copy
661
+ through `useWebsiteLabel('<leaf>')`; read structured numbers
662
+ (currency, amount) from the typed configuration.
663
+
664
+ ### Step 3: Implement `getStructuredData`
665
+
666
+ Return a `Product` with one `Offer` per tier (or `AggregateOffer`
667
+ with `lowPrice` / `highPrice` when more useful). The function is
668
+ pure and runs at static-build time — no React hooks inside.
669
+
670
+ ### Step 4: Compose into the pricing page
671
+
672
+ Typically the only major section on `/pricing`, often paired with an
673
+ FAQ section below it.
674
+
675
+ **Stop** after the pricing tiers render and `Product` / `Offer`
676
+ JSON-LD validates in Google's Rich Results test; if the
677
+ structured-data builder warns about missing `priceCurrency` or
678
+ `price`, **return to Step 3** — `getStructuredData()` must mirror
679
+ the visible per-tier price shape verbatim (the structured-data
680
+ audit catches divergence before AEO ingest).
681
+
682
+ ## Structured data (AEO)
683
+
684
+ Pricing sections own the commercial entity graph: `Product` plus either
685
+ child `Offer` entries or one `AggregateOffer`.
686
+
687
+ - **What earns its place**: a real purchasable plan surface, visible
688
+ pricing, stable tier naming, and truthful currency semantics.
689
+ - **What is NOT in this block**: hidden sales-only tiers, promo-only
690
+ pricing not visible on the page, or made-up ranges.
691
+ - **Verification grep**:
692
+ `rg -n "getStructuredData|priceCurrency|AggregateOffer|Offer" website/src/sections/pricing.section.tsx`
693
+ (must return `>= 1` for the pricing emitter).
694
+
695
+ ## Contribution to `llms.txt`
696
+
697
+ Pricing authoring contributes the monetization summary for the pricing
698
+ page entry in `website/src/content/llms.txt`.
699
+
700
+ - Include the canonical pricing page link and a concise summary of the
701
+ plan structure or purchase model.
702
+ - Mention only stable pricing facts worth citation; if prices or tier
703
+ names change, update `llms.txt` in the same edit.
704
+ - Do not include temporary promotions, coupon copy, or locale-specific
705
+ price tables in the file.
706
+
707
+ ## Worked Example
708
+
709
+ <!-- TIER C WAIVER: This `PRICING_TIERS` config IS the locale-neutral source-of-truth Verification check #2 names ("Tier configuration lives in a separate locale-neutral module — numbers + tier refs only"); the `ref: 'starter' | 'team' | 'enterprise'` literal union IS the stable contract Common Rationalization #2 protects ("the `ref` ... is the stable contract that flows into URLs, analytics, and JSON-LD"); and the typed `amountMonthlyUSD` / `amountAnnualUSD` / `bulletCount` shape lets `getStructuredData()` build `AggregateOffer` from the same array the JSX renders. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
710
+ ```tsx
711
+ // website/src/sections/pricing.config.ts
712
+ export interface PricingTierConfig {
713
+ ref: 'starter' | 'team' | 'enterprise';
714
+ amountMonthlyUSD: number;
715
+ amountAnnualUSD: number;
716
+ bulletCount: 3 | 4 | 5;
717
+ }
718
+
719
+ export const PRICING_TIERS: readonly PricingTierConfig[] = [
720
+ { ref: 'starter', amountMonthlyUSD: 0, amountAnnualUSD: 0, bulletCount: 3 },
721
+ { ref: 'team', amountMonthlyUSD: 12, amountAnnualUSD: 120, bulletCount: 5 },
722
+ { ref: 'enterprise', amountMonthlyUSD: 49, amountAnnualUSD: 490, bulletCount: 5 },
723
+ ] as const;
724
+ ```
725
+
726
+ <!-- TIER C WAIVER: This block IS the canonical Pricing contract — the per-tier `useWebsiteLabel('tier-${ref}.name|.pitch|.cta')` leaf-relative pattern composing `expectedLabelKeys` from the same `PRICING_TIERS` array; the typed `tierHrefs` prop carrying cross-frontend handoff URLs Verification check #5 enforces; and the `getStructuredData()` `Product` + `AggregateOffer` shape with explicit `priceCurrency` that grep invariants 3+4 guard. The `useWebsiteLabel('tier-${tier.ref}.name')` template-string call is intentional here (the refs come from a `as const` literal union the TS narrows) and is the contract `name`/`pitch`/`cta` per tier compose. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
727
+ ```tsx
728
+ // website/src/sections/pricing.section.tsx
729
+ import {
730
+ defineWebsiteSection,
731
+ useWebsiteLabel,
732
+ WebsiteButton,
733
+ WebsiteHeading,
734
+ WebsiteSectionCategory,
735
+ WebsiteText,
736
+ } from '@wildo-ai/saas-website';
737
+ import { PRICING_TIERS } from './pricing.config';
738
+
739
+ interface PricingSectionProps {
740
+ /** Where each tier's CTA points (cross-frontend handoff URL). */
741
+ tierHrefs: Record<'starter' | 'team' | 'enterprise', string>;
742
+ }
743
+
744
+ function PricingSectionComponent({ tierHrefs }: PricingSectionProps) {
745
+ const sectionTitle = useWebsiteLabel('title');
746
+ const sectionSub = useWebsiteLabel('subtitle');
747
+
748
+ return (
749
+ <div className="pricing">
750
+ <WebsiteHeading level={2} variant="title">{sectionTitle}</WebsiteHeading>
751
+ <WebsiteText variant="lead">{sectionSub}</WebsiteText>
752
+ <ul className="pricing__tiers">
753
+ {PRICING_TIERS.map((tier) => (
754
+ <PricingTier
755
+ key={tier.ref}
756
+ tier={tier}
757
+ href={tierHrefs[tier.ref]}
758
+ />
759
+ ))}
760
+ </ul>
761
+ </div>
762
+ );
763
+ }
764
+
765
+ function PricingTier({ tier, href }: { tier: typeof PRICING_TIERS[number]; href: string }) {
766
+ const name = useWebsiteLabel(`tier-${tier.ref}.name`);
767
+ const pitch = useWebsiteLabel(`tier-${tier.ref}.pitch`);
768
+ const cta = useWebsiteLabel(`tier-${tier.ref}.cta`);
769
+ return (
770
+ <li className="pricing__tier">
771
+ <WebsiteHeading level={3} variant="card-title">{name}</WebsiteHeading>
772
+ <p className="pricing__price">
773
+ ${tier.amountMonthlyUSD}<span>/mo</span>
774
+ </p>
775
+ <WebsiteText>{pitch}</WebsiteText>
776
+ <WebsiteButton href={href} variant="primary">{cta}</WebsiteButton>
777
+ </li>
778
+ );
779
+ }
780
+
781
+ export const PRICING_SECTION = defineWebsiteSection<PricingSectionProps>({
782
+ sectionRef: 'tiers',
783
+ category: WebsiteSectionCategory.PRICING,
784
+ expectedLabelKeys: [
785
+ 'website.pricing.tiers.title',
786
+ 'website.pricing.tiers.subtitle',
787
+ ...PRICING_TIERS.flatMap((tier) => [
788
+ `website.pricing.tiers.tier-${tier.ref}.name`,
789
+ `website.pricing.tiers.tier-${tier.ref}.pitch`,
790
+ `website.pricing.tiers.tier-${tier.ref}.cta`,
791
+ ]),
792
+ ],
793
+ Component: PricingSectionComponent,
794
+ getStructuredData: () => ({
795
+ '@context': 'https://schema.org',
796
+ '@type': 'Product',
797
+ name: 'Example Application',
798
+ offers: {
799
+ '@type': 'AggregateOffer',
800
+ priceCurrency: 'USD',
801
+ lowPrice: Math.min(...PRICING_TIERS.map((t) => t.amountMonthlyUSD)),
802
+ highPrice: Math.max(...PRICING_TIERS.map((t) => t.amountMonthlyUSD)),
803
+ offerCount: PRICING_TIERS.length,
804
+ offers: PRICING_TIERS.map((tier) => ({
805
+ '@type': 'Offer',
806
+ name: tier.ref,
807
+ price: tier.amountMonthlyUSD,
808
+ priceCurrency: 'USD',
809
+ url: `https://app.example.com/pricing#${tier.ref}`,
810
+ })),
811
+ },
812
+ }),
813
+ });
814
+ ```
815
+
816
+ ## Structured-data contract
817
+
818
+ Allowed JSON-LD vocabularies for `category: PRICING`:
819
+
820
+ - `Product` (with nested `offers: Offer | AggregateOffer`).
821
+ - `Offer` (single tier).
822
+ - `AggregateOffer` (multi-tier — recommended pattern for SaaS).
823
+
824
+ Disallowed (the SEO dispatcher will warn):
825
+
826
+ - `FAQPage` → emit from a sibling FAQ section
827
+ (`website-section-faq`).
828
+ - `Organization` / `WebSite` → emit from `website-section-hero`
829
+ on the landing page only.
830
+
831
+ ## Catalog integration (AEO)
832
+
833
+ The pricing section emits a TUPLE of `Product` + `AggregateOffer`
834
+ payloads, both declared by the installed Schema.org catalog contract:
835
+
836
+ - `PRODUCT_CATALOG_ENTRY` (required: `name`, `description`).
837
+ - `AGGREGATE_OFFER_CATALOG_ENTRY` (required: `lowPrice`,
838
+ `priceCurrency`, `offerCount`; `recommendOptionals: true` so
839
+ missing `highPrice` triggers a "consider adding" warning).
840
+ - For single-tier pricing, swap `AggregateOffer` for a single
841
+ `Offer` (`OFFER_CATALOG_ENTRY`; required: `price` +
842
+ `priceCurrency`).
843
+
844
+ The page shell wires emission through the installed structured-data contract —
845
+ the section returns a tuple `[Product, AggregateOffer]` and the renderer
846
+ emits one `<script type="application/ld+json">` block per payload
847
+ (NOT a single `@graph`, see the renderer's preamble). The companion's
848
+ reconciliation surface validates each payload against the catalog and
849
+ warns on drift (warning-only per D-AG4).
850
+
851
+ **What earns its place in this section's emission**:
852
+
853
+ - A `Product` payload with `name` + `description` (required) and the
854
+ pricing surface's `brand` / `category` when known.
855
+ - An `AggregateOffer` payload referencing the `Product` via `@id` and
856
+ declaring `lowPrice` / `priceCurrency` / `offerCount` (and
857
+ `highPrice` when more than one tier is sold).
858
+ - Per-tier `Offer` payloads inside `AggregateOffer.offers[]` when the
859
+ pricing page surfaces full tier detail (price + name + URL per tier).
860
+
861
+ **What is NOT in this emission**:
862
+
863
+ - Page-level entities (`WebSite`, `Organization`) — emitted once by
864
+ the hero / page-shell.
865
+ - App overrides of `Product` (e.g. requiring `gtin`) — those live in
866
+ the app's `_catalogs/schema-org/product.catalog-spec.ts`, NOT in the
867
+ section's emission.
868
+ - For SaaS sites, prefer the app-side `SoftwareApplication` extension
869
+ (canonical application example) — emit `SoftwareApplication +
870
+ AggregateOffer` instead of `Product + AggregateOffer`.
871
+
872
+ **Verification grep** (run from the app root):
873
+
874
+ | Invariant | Command |
875
+ |---|---|
876
+ | Section emits structured data | `rg -n "getStructuredData" website/src/sections/pricing.section.tsx` (must return 1) |
877
+ | Both `@type`s present | `rg -n "'Product'\|'AggregateOffer'" website/src/sections/pricing.section.tsx` (must return ≥2) |
878
+
879
+ ## References
880
+
881
+ - `references/define-website-section-api.md` — source-backed factory + schema + section wrapper + label hook contracts.
882
+
883
+ ## Verification
884
+
885
+ - [ ] `category: WebsiteSectionCategory.PRICING` (typed enum).
886
+ - [ ] Tier configuration lives in a separate locale-neutral module
887
+ (numbers + tier refs only).
888
+ - [ ] All copy comes from `useWebsiteLabel`.
889
+ - [ ] `getStructuredData()` returns a `Product` (or
890
+ `AggregateOffer`) — pure function, no React hooks.
891
+ - [ ] Every tier's CTA `href` flows through the cross-frontend
892
+ handoff carrier (see `website-anonymous-session`).
893
+ - [ ] `priceCurrency` is set explicitly (the absence of a currency
894
+ breaks Google's pricing rich result).
895
+
896
+ ### Grep invariants
897
+
898
+ | Invariant | Command |
899
+ |---|---|
900
+ | Factory used | `rg -n "defineWebsiteSection<" website/src/sections/pricing.section.tsx` (must return 1) |
901
+ | `getStructuredData` defined | `rg -n "getStructuredData:" website/src/sections/pricing.section.tsx` (must return 1) |
902
+ | Currency declared | `rg -n "priceCurrency" website/src/sections/pricing.section.tsx` (must return ≥1) |
903
+ | Allowed vocabulary only | `rg -n "@type" website/src/sections/pricing.section.tsx` (only `Product` / `Offer` / `AggregateOffer`) |
904
+
905
+ ## Common Rationalizations
906
+
907
+ | Rationalization | Reality |
908
+ |---|---|
909
+ | "I'll skip JSON-LD; we don't care about SEO yet" | Pricing JSON-LD is a 10-minute investment with disproportionate SERP / AEO upside. Ship it from day one. |
910
+ | "Tier names can be label keys" | The `ref` (`starter`, `team`, `enterprise`) is the stable contract that flows into URLs, analytics, and JSON-LD. Display name is a label; ref is not. |
911
+ | "Currency is implicit (USD)" | Google's pricing rich result requires `priceCurrency`. Declare it explicitly; never omit. |
912
+ | "Each tier should be its own `defineWebsiteSection` instance" | A pricing band is intentionally ONE section that renders N tiers from `PRICING_TIERS`. Per-tier sections fragment the analytics funnel-step grouping (`data-section-category="pricing"` would appear N times), fragment JSON-LD into N `Product` payloads instead of one `AggregateOffer`, and force the page manifest to enumerate. Single section, typed-array config, derived `expectedLabelKeys`. |
913
+
914
+ ## Red Flags
915
+
916
+ - Hardcoded prices in JSX (`$12/mo`) — break the JSON-LD/UI parity.
917
+ Source from the typed config in both places.
918
+ - Tier CTAs pointing directly at `app.example.com/signup?plan=team`
919
+ with no anonymous-session handoff — first-touch + plan attribution
920
+ is lost.
921
+ - A `getStructuredData()` that calls `useWebsiteLabel()` — hooks must
922
+ not run inside the structured-data builder; it's a pure function
923
+ invoked outside the React graph at build time.
924
+
925
+ ## Related Skills
926
+
927
+ - `website-page-authoring` — composing this section into the pricing
928
+ page manifest.
929
+ - `website-label-pack` — authoring tier copy across locales.
930
+ - `website-section-faq` — the standard FAQ companion section
931
+ (questions about pricing, billing, plan changes).
932
+ - `website-anonymous-session` — handoff carrier for tier CTAs.
933
+ - `website-seo-aeo-geo` — broader SEO / AEO / GEO posture, including
934
+ page-level meta + canonical.