@contractspec/lib.contracts 1.44.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 (528) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +109 -0
  3. package/dist/_virtual/rolldown_runtime.js +37 -0
  4. package/dist/app-config/app-config.feature.d.ts +12 -0
  5. package/dist/app-config/app-config.feature.js +54 -0
  6. package/dist/app-config/branding.d.ts +55 -0
  7. package/dist/app-config/branding.js +0 -0
  8. package/dist/app-config/contracts.d.ts +245 -0
  9. package/dist/app-config/contracts.js +395 -0
  10. package/dist/app-config/docs/app-config.docblock.d.ts +6 -0
  11. package/dist/app-config/docs/app-config.docblock.js +21 -0
  12. package/dist/app-config/events.d.ts +122 -0
  13. package/dist/app-config/events.js +174 -0
  14. package/dist/app-config/index.d.ts +9 -0
  15. package/dist/app-config/index.js +8 -0
  16. package/dist/app-config/lifecycle-contracts.d.ts +273 -0
  17. package/dist/app-config/lifecycle-contracts.js +440 -0
  18. package/dist/app-config/lifecycle.d.ts +27 -0
  19. package/dist/app-config/lifecycle.js +0 -0
  20. package/dist/app-config/runtime.d.ts +120 -0
  21. package/dist/app-config/runtime.js +617 -0
  22. package/dist/app-config/spec.d.ts +173 -0
  23. package/dist/app-config/spec.js +36 -0
  24. package/dist/app-config/validation.d.ts +49 -0
  25. package/dist/app-config/validation.js +538 -0
  26. package/dist/capabilities/capabilities.d.ts +48 -0
  27. package/dist/capabilities/capabilities.js +50 -0
  28. package/dist/capabilities/docs/capabilities.docblock.d.ts +6 -0
  29. package/dist/capabilities/docs/capabilities.docblock.js +21 -0
  30. package/dist/capabilities/index.d.ts +3 -0
  31. package/dist/capabilities/index.js +4 -0
  32. package/dist/capabilities/openbanking.d.ts +10 -0
  33. package/dist/capabilities/openbanking.js +92 -0
  34. package/dist/client/index.d.ts +6 -0
  35. package/dist/client/index.js +9 -0
  36. package/dist/client/react/drivers/rn-reusables.d.ts +22 -0
  37. package/dist/client/react/drivers/rn-reusables.js +21 -0
  38. package/dist/client/react/drivers/shadcn.d.ts +12 -0
  39. package/dist/client/react/drivers/shadcn.js +11 -0
  40. package/dist/client/react/feature-render.d.ts +23 -0
  41. package/dist/client/react/feature-render.js +44 -0
  42. package/dist/client/react/form-render.d.ts +92 -0
  43. package/dist/client/react/form-render.js +298 -0
  44. package/dist/client/react/index.d.ts +5 -0
  45. package/dist/client/react/index.js +8 -0
  46. package/dist/contract-registry/index.d.ts +3 -0
  47. package/dist/contract-registry/index.js +3 -0
  48. package/dist/contract-registry/schemas.d.ts +124 -0
  49. package/dist/contract-registry/schemas.js +61 -0
  50. package/dist/contract-registry/types.d.ts +46 -0
  51. package/dist/contract-registry/types.js +0 -0
  52. package/dist/data-views/data-views.d.ts +5 -0
  53. package/dist/data-views/data-views.js +4 -0
  54. package/dist/data-views/docs/data-views.docblock.d.ts +6 -0
  55. package/dist/data-views/docs/data-views.docblock.js +21 -0
  56. package/dist/data-views/index.d.ts +4 -0
  57. package/dist/data-views/index.js +4 -0
  58. package/dist/data-views/query-generator.d.ts +40 -0
  59. package/dist/data-views/query-generator.js +48 -0
  60. package/dist/data-views/registry.d.ts +51 -0
  61. package/dist/data-views/registry.js +82 -0
  62. package/dist/data-views/runtime.d.ts +28 -0
  63. package/dist/data-views/runtime.js +39 -0
  64. package/dist/data-views/spec.d.ts +32 -0
  65. package/dist/data-views/spec.js +10 -0
  66. package/dist/data-views/types.d.ts +157 -0
  67. package/dist/data-views/types.js +0 -0
  68. package/dist/docs/accessibility_wcag_compliance_specs.docblock.d.ts +6 -0
  69. package/dist/docs/accessibility_wcag_compliance_specs.docblock.js +17 -0
  70. package/dist/docs/index.d.ts +6 -0
  71. package/dist/docs/index.js +29 -0
  72. package/dist/docs/meta.docs.d.ts +6 -0
  73. package/dist/docs/meta.docs.js +29 -0
  74. package/dist/docs/presentations.d.ts +33 -0
  75. package/dist/docs/presentations.js +64 -0
  76. package/dist/docs/registry.d.ts +23 -0
  77. package/dist/docs/registry.js +51 -0
  78. package/dist/docs/tech/auth/better-auth-nextjs.docblock.d.ts +6 -0
  79. package/dist/docs/tech/auth/better-auth-nextjs.docblock.js +81 -0
  80. package/dist/docs/tech/contracts/README.docblock.d.ts +6 -0
  81. package/dist/docs/tech/contracts/README.docblock.js +21 -0
  82. package/dist/docs/tech/contracts/create-subscription.docblock.d.ts +6 -0
  83. package/dist/docs/tech/contracts/create-subscription.docblock.js +21 -0
  84. package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.d.ts +6 -0
  85. package/dist/docs/tech/contracts/graphql-typed-outputs.docblock.js +21 -0
  86. package/dist/docs/tech/contracts/migrations.docblock.d.ts +6 -0
  87. package/dist/docs/tech/contracts/migrations.docblock.js +21 -0
  88. package/dist/docs/tech/contracts/openapi-export.docblock.d.ts +6 -0
  89. package/dist/docs/tech/contracts/openapi-export.docblock.js +58 -0
  90. package/dist/docs/tech/contracts/openapi-import.docblock.d.ts +6 -0
  91. package/dist/docs/tech/contracts/openapi-import.docblock.js +65 -0
  92. package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.d.ts +6 -0
  93. package/dist/docs/tech/contracts/ops-to-presentation-linking.docblock.js +21 -0
  94. package/dist/docs/tech/contracts/overlays.docblock.d.ts +6 -0
  95. package/dist/docs/tech/contracts/overlays.docblock.js +21 -0
  96. package/dist/docs/tech/contracts/tests.docblock.d.ts +6 -0
  97. package/dist/docs/tech/contracts/tests.docblock.js +21 -0
  98. package/dist/docs/tech/contracts/themes.docblock.d.ts +6 -0
  99. package/dist/docs/tech/contracts/themes.docblock.js +21 -0
  100. package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.d.ts +6 -0
  101. package/dist/docs/tech/contracts/vertical-pocket-family-office.docblock.js +21 -0
  102. package/dist/docs/tech/lifecycle-stage-system.docblock.d.ts +6 -0
  103. package/dist/docs/tech/lifecycle-stage-system.docblock.js +17 -0
  104. package/dist/docs/tech/llm/llm-integration.docblock.d.ts +7 -0
  105. package/dist/docs/tech/llm/llm-integration.docblock.js +358 -0
  106. package/dist/docs/tech/mcp-endpoints.docblock.d.ts +6 -0
  107. package/dist/docs/tech/mcp-endpoints.docblock.js +38 -0
  108. package/dist/docs/tech/presentation-runtime.docblock.d.ts +6 -0
  109. package/dist/docs/tech/presentation-runtime.docblock.js +17 -0
  110. package/dist/docs/tech/schema/README.docblock.d.ts +6 -0
  111. package/dist/docs/tech/schema/README.docblock.js +21 -0
  112. package/dist/docs/tech/studio/learning-events.docblock.d.ts +6 -0
  113. package/dist/docs/tech/studio/learning-events.docblock.js +49 -0
  114. package/dist/docs/tech/studio/learning-journeys.docblock.d.ts +6 -0
  115. package/dist/docs/tech/studio/learning-journeys.docblock.js +80 -0
  116. package/dist/docs/tech/studio/platform-admin-panel.docblock.d.ts +6 -0
  117. package/dist/docs/tech/studio/platform-admin-panel.docblock.js +85 -0
  118. package/dist/docs/tech/studio/project-access-teams.docblock.d.ts +6 -0
  119. package/dist/docs/tech/studio/project-access-teams.docblock.js +46 -0
  120. package/dist/docs/tech/studio/project-routing.docblock.d.ts +6 -0
  121. package/dist/docs/tech/studio/project-routing.docblock.js +68 -0
  122. package/dist/docs/tech/studio/sandbox-unlogged.docblock.d.ts +6 -0
  123. package/dist/docs/tech/studio/sandbox-unlogged.docblock.js +41 -0
  124. package/dist/docs/tech/studio/team-invitations.docblock.d.ts +6 -0
  125. package/dist/docs/tech/studio/team-invitations.docblock.js +70 -0
  126. package/dist/docs/tech/studio/workspace-ops.docblock.d.ts +6 -0
  127. package/dist/docs/tech/studio/workspace-ops.docblock.js +48 -0
  128. package/dist/docs/tech/studio/workspaces.docblock.d.ts +6 -0
  129. package/dist/docs/tech/studio/workspaces.docblock.js +63 -0
  130. package/dist/docs/tech/telemetry-ingest.docblock.d.ts +6 -0
  131. package/dist/docs/tech/telemetry-ingest.docblock.js +156 -0
  132. package/dist/docs/tech/templates/runtime.docblock.d.ts +6 -0
  133. package/dist/docs/tech/templates/runtime.docblock.js +21 -0
  134. package/dist/docs/tech/vscode-extension.docblock.d.ts +6 -0
  135. package/dist/docs/tech/vscode-extension.docblock.js +102 -0
  136. package/dist/docs/tech-contracts.docs.d.ts +6 -0
  137. package/dist/docs/tech-contracts.docs.js +96 -0
  138. package/dist/docs/types.d.ts +41 -0
  139. package/dist/docs/types.js +0 -0
  140. package/dist/events.d.ts +47 -0
  141. package/dist/events.js +19 -0
  142. package/dist/experiments/docs/experiments.docblock.d.ts +6 -0
  143. package/dist/experiments/docs/experiments.docblock.js +21 -0
  144. package/dist/experiments/evaluator.d.ts +37 -0
  145. package/dist/experiments/evaluator.js +101 -0
  146. package/dist/experiments/spec-resolver.d.ts +17 -0
  147. package/dist/experiments/spec-resolver.js +0 -0
  148. package/dist/experiments/spec.d.ts +82 -0
  149. package/dist/experiments/spec.js +33 -0
  150. package/dist/features/index.d.ts +5 -0
  151. package/dist/features/index.js +5 -0
  152. package/dist/features/install.d.ts +22 -0
  153. package/dist/features/install.js +36 -0
  154. package/dist/features/registry.d.ts +26 -0
  155. package/dist/features/registry.js +49 -0
  156. package/dist/features/types.d.ts +88 -0
  157. package/dist/features/types.js +0 -0
  158. package/dist/features/validation.d.ts +8 -0
  159. package/dist/features/validation.js +14 -0
  160. package/dist/forms/docs/forms.docblock.d.ts +6 -0
  161. package/dist/forms/docs/forms.docblock.js +21 -0
  162. package/dist/forms/forms.d.ts +266 -0
  163. package/dist/forms/forms.js +146 -0
  164. package/dist/forms/index.d.ts +2 -0
  165. package/dist/forms/index.js +3 -0
  166. package/dist/index.d.ts +147 -0
  167. package/dist/index.js +121 -0
  168. package/dist/install.d.ts +77 -0
  169. package/dist/install.js +40 -0
  170. package/dist/integrations/binding.d.ts +17 -0
  171. package/dist/integrations/binding.js +0 -0
  172. package/dist/integrations/connection.d.ts +51 -0
  173. package/dist/integrations/connection.js +0 -0
  174. package/dist/integrations/docs/integrations.docblock.d.ts +6 -0
  175. package/dist/integrations/docs/integrations.docblock.js +94 -0
  176. package/dist/integrations/health.d.ts +21 -0
  177. package/dist/integrations/health.js +69 -0
  178. package/dist/integrations/index.d.ts +34 -0
  179. package/dist/integrations/index.js +23 -0
  180. package/dist/integrations/integrations.feature.d.ts +12 -0
  181. package/dist/integrations/integrations.feature.js +60 -0
  182. package/dist/integrations/openbanking/contracts/accounts.d.ts +289 -0
  183. package/dist/integrations/openbanking/contracts/accounts.js +236 -0
  184. package/dist/integrations/openbanking/contracts/balances.d.ts +165 -0
  185. package/dist/integrations/openbanking/contracts/balances.js +166 -0
  186. package/dist/integrations/openbanking/contracts/index.d.ts +10 -0
  187. package/dist/integrations/openbanking/contracts/index.js +12 -0
  188. package/dist/integrations/openbanking/contracts/transactions.d.ts +213 -0
  189. package/dist/integrations/openbanking/contracts/transactions.js +217 -0
  190. package/dist/integrations/openbanking/guards.d.ts +12 -0
  191. package/dist/integrations/openbanking/guards.js +33 -0
  192. package/dist/integrations/openbanking/models.d.ts +228 -0
  193. package/dist/integrations/openbanking/models.js +240 -0
  194. package/dist/integrations/openbanking/openbanking.feature.d.ts +12 -0
  195. package/dist/integrations/openbanking/openbanking.feature.js +69 -0
  196. package/dist/integrations/openbanking/telemetry.d.ts +15 -0
  197. package/dist/integrations/openbanking/telemetry.js +39 -0
  198. package/dist/integrations/operations.d.ts +437 -0
  199. package/dist/integrations/operations.js +392 -0
  200. package/dist/integrations/providers/calendar.d.ts +78 -0
  201. package/dist/integrations/providers/calendar.js +0 -0
  202. package/dist/integrations/providers/elevenlabs.d.ts +7 -0
  203. package/dist/integrations/providers/elevenlabs.js +55 -0
  204. package/dist/integrations/providers/email.d.ts +86 -0
  205. package/dist/integrations/providers/email.js +0 -0
  206. package/dist/integrations/providers/embedding.d.ts +24 -0
  207. package/dist/integrations/providers/embedding.js +0 -0
  208. package/dist/integrations/providers/gcs-storage.d.ts +7 -0
  209. package/dist/integrations/providers/gcs-storage.js +78 -0
  210. package/dist/integrations/providers/gmail.d.ts +7 -0
  211. package/dist/integrations/providers/gmail.js +90 -0
  212. package/dist/integrations/providers/google-calendar.d.ts +7 -0
  213. package/dist/integrations/providers/google-calendar.js +69 -0
  214. package/dist/integrations/providers/impls/elevenlabs-voice.d.ts +20 -0
  215. package/dist/integrations/providers/impls/elevenlabs-voice.js +95 -0
  216. package/dist/integrations/providers/impls/gcs-storage.d.ts +24 -0
  217. package/dist/integrations/providers/impls/gcs-storage.js +88 -0
  218. package/dist/integrations/providers/impls/gmail-inbound.d.ts +26 -0
  219. package/dist/integrations/providers/impls/gmail-inbound.js +200 -0
  220. package/dist/integrations/providers/impls/gmail-outbound.d.ts +18 -0
  221. package/dist/integrations/providers/impls/gmail-outbound.js +105 -0
  222. package/dist/integrations/providers/impls/google-calendar.d.ts +23 -0
  223. package/dist/integrations/providers/impls/google-calendar.js +154 -0
  224. package/dist/integrations/providers/impls/index.d.ts +15 -0
  225. package/dist/integrations/providers/impls/index.js +16 -0
  226. package/dist/integrations/providers/impls/mistral-embedding.d.ts +23 -0
  227. package/dist/integrations/providers/impls/mistral-embedding.js +41 -0
  228. package/dist/integrations/providers/impls/mistral-llm.d.ts +31 -0
  229. package/dist/integrations/providers/impls/mistral-llm.js +247 -0
  230. package/dist/integrations/providers/impls/postmark-email.d.ts +19 -0
  231. package/dist/integrations/providers/impls/postmark-email.js +55 -0
  232. package/dist/integrations/providers/impls/powens-client.d.ts +124 -0
  233. package/dist/integrations/providers/impls/powens-client.js +171 -0
  234. package/dist/integrations/providers/impls/powens-openbanking.d.ts +27 -0
  235. package/dist/integrations/providers/impls/powens-openbanking.js +218 -0
  236. package/dist/integrations/providers/impls/provider-factory.d.ts +26 -0
  237. package/dist/integrations/providers/impls/provider-factory.js +145 -0
  238. package/dist/integrations/providers/impls/qdrant-vector.d.ts +24 -0
  239. package/dist/integrations/providers/impls/qdrant-vector.js +69 -0
  240. package/dist/integrations/providers/impls/stripe-payments.d.ts +28 -0
  241. package/dist/integrations/providers/impls/stripe-payments.js +202 -0
  242. package/dist/integrations/providers/impls/twilio-sms.d.ts +20 -0
  243. package/dist/integrations/providers/impls/twilio-sms.js +58 -0
  244. package/dist/integrations/providers/index.d.ts +22 -0
  245. package/dist/integrations/providers/index.js +13 -0
  246. package/dist/integrations/providers/llm.d.ts +82 -0
  247. package/dist/integrations/providers/llm.js +0 -0
  248. package/dist/integrations/providers/mistral.d.ts +7 -0
  249. package/dist/integrations/providers/mistral.js +71 -0
  250. package/dist/integrations/providers/openbanking.d.ts +128 -0
  251. package/dist/integrations/providers/openbanking.js +0 -0
  252. package/dist/integrations/providers/payments.d.ts +109 -0
  253. package/dist/integrations/providers/payments.js +0 -0
  254. package/dist/integrations/providers/postmark.d.ts +7 -0
  255. package/dist/integrations/providers/postmark.js +71 -0
  256. package/dist/integrations/providers/powens.d.ts +7 -0
  257. package/dist/integrations/providers/powens.js +119 -0
  258. package/dist/integrations/providers/qdrant.d.ts +7 -0
  259. package/dist/integrations/providers/qdrant.js +76 -0
  260. package/dist/integrations/providers/registry.d.ts +11 -0
  261. package/dist/integrations/providers/registry.js +34 -0
  262. package/dist/integrations/providers/sms.d.ts +34 -0
  263. package/dist/integrations/providers/sms.js +0 -0
  264. package/dist/integrations/providers/storage.d.ts +60 -0
  265. package/dist/integrations/providers/storage.js +0 -0
  266. package/dist/integrations/providers/stripe.d.ts +7 -0
  267. package/dist/integrations/providers/stripe.js +86 -0
  268. package/dist/integrations/providers/twilio-sms.d.ts +7 -0
  269. package/dist/integrations/providers/twilio-sms.js +64 -0
  270. package/dist/integrations/providers/vector-store.d.ts +43 -0
  271. package/dist/integrations/providers/vector-store.js +0 -0
  272. package/dist/integrations/providers/voice.d.ts +34 -0
  273. package/dist/integrations/providers/voice.js +0 -0
  274. package/dist/integrations/runtime.d.ts +99 -0
  275. package/dist/integrations/runtime.js +186 -0
  276. package/dist/integrations/secrets/aws-secret-manager.d.ts +31 -0
  277. package/dist/integrations/secrets/aws-secret-manager.js +231 -0
  278. package/dist/integrations/secrets/env-secret-provider.d.ts +31 -0
  279. package/dist/integrations/secrets/env-secret-provider.js +81 -0
  280. package/dist/integrations/secrets/gcp-secret-manager.d.ts +32 -0
  281. package/dist/integrations/secrets/gcp-secret-manager.js +229 -0
  282. package/dist/integrations/secrets/index.d.ts +7 -0
  283. package/dist/integrations/secrets/index.js +8 -0
  284. package/dist/integrations/secrets/manager.d.ts +47 -0
  285. package/dist/integrations/secrets/manager.js +103 -0
  286. package/dist/integrations/secrets/provider.d.ts +52 -0
  287. package/dist/integrations/secrets/provider.js +58 -0
  288. package/dist/integrations/secrets/scaleway-secret-manager.d.ts +38 -0
  289. package/dist/integrations/secrets/scaleway-secret-manager.js +247 -0
  290. package/dist/integrations/secrets-types.d.ts +17 -0
  291. package/dist/integrations/secrets-types.js +0 -0
  292. package/dist/integrations/spec.d.ts +75 -0
  293. package/dist/integrations/spec.js +39 -0
  294. package/dist/jobs/define-job.d.ts +18 -0
  295. package/dist/jobs/define-job.js +16 -0
  296. package/dist/jobs/gcp-cloud-tasks.d.ts +41 -0
  297. package/dist/jobs/gcp-cloud-tasks.js +53 -0
  298. package/dist/jobs/gcp-pubsub.d.ts +25 -0
  299. package/dist/jobs/gcp-pubsub.js +39 -0
  300. package/dist/jobs/handlers/gmail-sync-handler.d.ts +9 -0
  301. package/dist/jobs/handlers/gmail-sync-handler.js +9 -0
  302. package/dist/jobs/handlers/index.d.ts +9 -0
  303. package/dist/jobs/handlers/index.js +12 -0
  304. package/dist/jobs/handlers/ping-handler.d.ts +10 -0
  305. package/dist/jobs/handlers/ping-handler.js +15 -0
  306. package/dist/jobs/handlers/storage-document-handler.d.ts +12 -0
  307. package/dist/jobs/handlers/storage-document-handler.js +14 -0
  308. package/dist/jobs/index.d.ts +3 -0
  309. package/dist/jobs/index.js +4 -0
  310. package/dist/jobs/memory-queue.d.ts +18 -0
  311. package/dist/jobs/memory-queue.js +71 -0
  312. package/dist/jobs/queue.d.ts +131 -0
  313. package/dist/jobs/queue.js +33 -0
  314. package/dist/jobs/scaleway-sqs-queue.d.ts +30 -0
  315. package/dist/jobs/scaleway-sqs-queue.js +153 -0
  316. package/dist/jsonschema.d.ts +27 -0
  317. package/dist/jsonschema.js +32 -0
  318. package/dist/knowledge/binding.d.ts +25 -0
  319. package/dist/knowledge/binding.js +0 -0
  320. package/dist/knowledge/docs/knowledge.docblock.d.ts +6 -0
  321. package/dist/knowledge/docs/knowledge.docblock.js +21 -0
  322. package/dist/knowledge/index.d.ts +11 -0
  323. package/dist/knowledge/index.js +10 -0
  324. package/dist/knowledge/ingestion/document-processor.d.ts +24 -0
  325. package/dist/knowledge/ingestion/document-processor.js +54 -0
  326. package/dist/knowledge/ingestion/embedding-service.d.ts +12 -0
  327. package/dist/knowledge/ingestion/embedding-service.js +25 -0
  328. package/dist/knowledge/ingestion/gmail-adapter.d.ts +18 -0
  329. package/dist/knowledge/ingestion/gmail-adapter.js +51 -0
  330. package/dist/knowledge/ingestion/index.d.ts +6 -0
  331. package/dist/knowledge/ingestion/index.js +7 -0
  332. package/dist/knowledge/ingestion/storage-adapter.d.ts +15 -0
  333. package/dist/knowledge/ingestion/storage-adapter.js +26 -0
  334. package/dist/knowledge/ingestion/vector-indexer.d.ts +18 -0
  335. package/dist/knowledge/ingestion/vector-indexer.js +32 -0
  336. package/dist/knowledge/knowledge.feature.d.ts +12 -0
  337. package/dist/knowledge/knowledge.feature.js +61 -0
  338. package/dist/knowledge/operations.d.ts +318 -0
  339. package/dist/knowledge/operations.js +321 -0
  340. package/dist/knowledge/query/index.d.ts +2 -0
  341. package/dist/knowledge/query/index.js +3 -0
  342. package/dist/knowledge/query/service.d.ts +29 -0
  343. package/dist/knowledge/query/service.js +65 -0
  344. package/dist/knowledge/runtime.d.ts +32 -0
  345. package/dist/knowledge/runtime.js +49 -0
  346. package/dist/knowledge/source.d.ts +32 -0
  347. package/dist/knowledge/source.js +0 -0
  348. package/dist/knowledge/spaces/email-threads.d.ts +7 -0
  349. package/dist/knowledge/spaces/email-threads.js +37 -0
  350. package/dist/knowledge/spaces/financial-docs.d.ts +7 -0
  351. package/dist/knowledge/spaces/financial-docs.js +37 -0
  352. package/dist/knowledge/spaces/financial-overview.d.ts +7 -0
  353. package/dist/knowledge/spaces/financial-overview.js +41 -0
  354. package/dist/knowledge/spaces/index.d.ts +7 -0
  355. package/dist/knowledge/spaces/index.js +8 -0
  356. package/dist/knowledge/spaces/product-canon.d.ts +7 -0
  357. package/dist/knowledge/spaces/product-canon.js +37 -0
  358. package/dist/knowledge/spaces/support-faq.d.ts +7 -0
  359. package/dist/knowledge/spaces/support-faq.js +40 -0
  360. package/dist/knowledge/spaces/uploaded-docs.d.ts +7 -0
  361. package/dist/knowledge/spaces/uploaded-docs.js +37 -0
  362. package/dist/knowledge/spec.d.ts +48 -0
  363. package/dist/knowledge/spec.js +39 -0
  364. package/dist/llm/exporters.d.ts +70 -0
  365. package/dist/llm/exporters.js +542 -0
  366. package/dist/llm/index.d.ts +4 -0
  367. package/dist/llm/index.js +4 -0
  368. package/dist/llm/prompts.d.ts +52 -0
  369. package/dist/llm/prompts.js +410 -0
  370. package/dist/llm/types.d.ts +215 -0
  371. package/dist/llm/types.js +0 -0
  372. package/dist/markdown.d.ts +22 -0
  373. package/dist/markdown.js +119 -0
  374. package/dist/migrations.d.ts +52 -0
  375. package/dist/migrations.js +33 -0
  376. package/dist/model-registry.d.ts +13 -0
  377. package/dist/model-registry.js +33 -0
  378. package/dist/onboarding-base.d.ts +138 -0
  379. package/dist/onboarding-base.js +195 -0
  380. package/dist/openapi.d.ts +31 -0
  381. package/dist/openapi.js +75 -0
  382. package/dist/operations/index.d.ts +3 -0
  383. package/dist/operations/index.js +4 -0
  384. package/dist/operations/operation.d.ts +186 -0
  385. package/dist/operations/operation.js +35 -0
  386. package/dist/operations/registry.d.ts +103 -0
  387. package/dist/operations/registry.js +252 -0
  388. package/dist/ownership.d.ts +84 -0
  389. package/dist/ownership.js +38 -0
  390. package/dist/policy/docs/policy.docblock.d.ts +6 -0
  391. package/dist/policy/docs/policy.docblock.js +21 -0
  392. package/dist/policy/engine.d.ts +40 -0
  393. package/dist/policy/engine.js +223 -0
  394. package/dist/policy/index.d.ts +5 -0
  395. package/dist/policy/index.js +5 -0
  396. package/dist/policy/opa-adapter.d.ts +45 -0
  397. package/dist/policy/opa-adapter.js +71 -0
  398. package/dist/policy/registry.d.ts +9 -0
  399. package/dist/policy/registry.js +11 -0
  400. package/dist/policy/spec.d.ts +103 -0
  401. package/dist/policy/spec.js +0 -0
  402. package/dist/presentations/docs/presentations-conventions.docblock.d.ts +6 -0
  403. package/dist/presentations/docs/presentations-conventions.docblock.js +21 -0
  404. package/dist/presentations/index.d.ts +4 -0
  405. package/dist/presentations/index.js +5 -0
  406. package/dist/presentations/presentations.d.ts +50 -0
  407. package/dist/presentations/presentations.js +7 -0
  408. package/dist/presentations/registry.d.ts +10 -0
  409. package/dist/presentations/registry.js +12 -0
  410. package/dist/presentations/transform-engine.d.ts +66 -0
  411. package/dist/presentations/transform-engine.js +282 -0
  412. package/dist/prompt.d.ts +60 -0
  413. package/dist/prompt.js +10 -0
  414. package/dist/promptRegistry.d.ts +15 -0
  415. package/dist/promptRegistry.js +34 -0
  416. package/dist/regenerator/adapters.d.ts +19 -0
  417. package/dist/regenerator/adapters.js +0 -0
  418. package/dist/regenerator/docs/regenerator.docblock.d.ts +6 -0
  419. package/dist/regenerator/docs/regenerator.docblock.js +21 -0
  420. package/dist/regenerator/executor.d.ts +70 -0
  421. package/dist/regenerator/executor.js +86 -0
  422. package/dist/regenerator/index.d.ts +7 -0
  423. package/dist/regenerator/index.js +6 -0
  424. package/dist/regenerator/service.d.ts +33 -0
  425. package/dist/regenerator/service.js +93 -0
  426. package/dist/regenerator/sinks.d.ts +26 -0
  427. package/dist/regenerator/sinks.js +32 -0
  428. package/dist/regenerator/types.d.ts +107 -0
  429. package/dist/regenerator/types.js +0 -0
  430. package/dist/regenerator/utils.d.ts +9 -0
  431. package/dist/regenerator/utils.js +51 -0
  432. package/dist/registry-utils.d.ts +106 -0
  433. package/dist/registry-utils.js +122 -0
  434. package/dist/registry.d.ts +31 -0
  435. package/dist/registry.js +61 -0
  436. package/dist/resources.d.ts +64 -0
  437. package/dist/resources.js +50 -0
  438. package/dist/schema-to-markdown.d.ts +54 -0
  439. package/dist/schema-to-markdown.js +217 -0
  440. package/dist/server/contracts-adapter-hydration.d.ts +15 -0
  441. package/dist/server/contracts-adapter-hydration.js +41 -0
  442. package/dist/server/contracts-adapter-input.d.ts +9 -0
  443. package/dist/server/contracts-adapter-input.js +83 -0
  444. package/dist/server/graphql-pothos.d.ts +31 -0
  445. package/dist/server/graphql-pothos.js +134 -0
  446. package/dist/server/index.d.ts +9 -0
  447. package/dist/server/index.js +10 -0
  448. package/dist/server/mcp/createMcpServer.d.ts +15 -0
  449. package/dist/server/mcp/createMcpServer.js +27 -0
  450. package/dist/server/mcp/mcpTypes.d.ts +27 -0
  451. package/dist/server/mcp/mcpTypes.js +0 -0
  452. package/dist/server/mcp/registerPresentations.d.ts +7 -0
  453. package/dist/server/mcp/registerPresentations.js +63 -0
  454. package/dist/server/mcp/registerPrompts.d.ts +8 -0
  455. package/dist/server/mcp/registerPrompts.js +37 -0
  456. package/dist/server/mcp/registerResources.d.ts +8 -0
  457. package/dist/server/mcp/registerResources.js +35 -0
  458. package/dist/server/mcp/registerTools.d.ts +8 -0
  459. package/dist/server/mcp/registerTools.js +22 -0
  460. package/dist/server/provider-mcp.d.ts +2 -0
  461. package/dist/server/provider-mcp.js +3 -0
  462. package/dist/server/rest-elysia.d.ts +40 -0
  463. package/dist/server/rest-elysia.js +20 -0
  464. package/dist/server/rest-express.d.ts +16 -0
  465. package/dist/server/rest-express.js +36 -0
  466. package/dist/server/rest-generic.d.ts +32 -0
  467. package/dist/server/rest-generic.js +124 -0
  468. package/dist/server/rest-next-app.d.ts +35 -0
  469. package/dist/server/rest-next-app.js +38 -0
  470. package/dist/server/rest-next-mcp.d.ts +11 -0
  471. package/dist/server/rest-next-mcp.js +45 -0
  472. package/dist/server/rest-next-pages.d.ts +9 -0
  473. package/dist/server/rest-next-pages.js +22 -0
  474. package/dist/telemetry/anomaly.d.ts +27 -0
  475. package/dist/telemetry/anomaly.js +48 -0
  476. package/dist/telemetry/docs/telemetry.docblock.d.ts +6 -0
  477. package/dist/telemetry/docs/telemetry.docblock.js +21 -0
  478. package/dist/telemetry/index.d.ts +4 -0
  479. package/dist/telemetry/index.js +5 -0
  480. package/dist/telemetry/spec.d.ts +91 -0
  481. package/dist/telemetry/spec.js +69 -0
  482. package/dist/telemetry/tracker.d.ts +51 -0
  483. package/dist/telemetry/tracker.js +76 -0
  484. package/dist/tests/index.d.ts +3 -0
  485. package/dist/tests/index.js +4 -0
  486. package/dist/tests/runner.d.ts +43 -0
  487. package/dist/tests/runner.js +150 -0
  488. package/dist/tests/spec.d.ts +81 -0
  489. package/dist/tests/spec.js +33 -0
  490. package/dist/themes.d.ts +53 -0
  491. package/dist/themes.js +39 -0
  492. package/dist/translations/catalog.d.ts +28 -0
  493. package/dist/translations/catalog.js +0 -0
  494. package/dist/translations/tenant.d.ts +15 -0
  495. package/dist/translations/tenant.js +0 -0
  496. package/dist/types.d.ts +92 -0
  497. package/dist/types.js +0 -0
  498. package/dist/workflow/adapters/db-adapter.d.ts +46 -0
  499. package/dist/workflow/adapters/db-adapter.js +83 -0
  500. package/dist/workflow/adapters/file-adapter.d.ts +14 -0
  501. package/dist/workflow/adapters/file-adapter.js +11 -0
  502. package/dist/workflow/adapters/index.d.ts +4 -0
  503. package/dist/workflow/adapters/index.js +5 -0
  504. package/dist/workflow/adapters/memory-store.d.ts +18 -0
  505. package/dist/workflow/adapters/memory-store.js +58 -0
  506. package/dist/workflow/expression.d.ts +9 -0
  507. package/dist/workflow/expression.js +99 -0
  508. package/dist/workflow/index.d.ts +10 -0
  509. package/dist/workflow/index.js +9 -0
  510. package/dist/workflow/overview.docblock.d.ts +6 -0
  511. package/dist/workflow/overview.docblock.js +21 -0
  512. package/dist/workflow/runner.d.ts +75 -0
  513. package/dist/workflow/runner.js +337 -0
  514. package/dist/workflow/sla-monitor.d.ts +20 -0
  515. package/dist/workflow/sla-monitor.js +47 -0
  516. package/dist/workflow/spec.d.ts +106 -0
  517. package/dist/workflow/spec.js +55 -0
  518. package/dist/workflow/state.d.ts +35 -0
  519. package/dist/workflow/state.js +0 -0
  520. package/dist/workflow/validation.d.ts +29 -0
  521. package/dist/workflow/validation.js +176 -0
  522. package/dist/workspace-config/contractsrc-schema.d.ts +862 -0
  523. package/dist/workspace-config/contractsrc-schema.js +281 -0
  524. package/dist/workspace-config/index.d.ts +2 -0
  525. package/dist/workspace-config/index.js +3 -0
  526. package/dist/workspace-config/workspace-config.docblock.d.ts +6 -0
  527. package/dist/workspace-config/workspace-config.docblock.js +45 -0
  528. package/package.json +598 -0
@@ -0,0 +1,10 @@
1
+ import { CapabilityRegistry, CapabilitySpec } from "./capabilities.js";
2
+ import "./index.js";
3
+
4
+ //#region src/capabilities/openbanking.d.ts
5
+ declare const openBankingAccountsReadCapability: CapabilitySpec;
6
+ declare const openBankingTransactionsReadCapability: CapabilitySpec;
7
+ declare const openBankingBalancesReadCapability: CapabilitySpec;
8
+ declare function registerOpenBankingCapabilities(registry: CapabilityRegistry): CapabilityRegistry;
9
+ //#endregion
10
+ export { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };
@@ -0,0 +1,92 @@
1
+ import { StabilityEnum } from "../ownership.js";
2
+
3
+ //#region src/capabilities/openbanking.ts
4
+ const OWNERS = ["platform.finance"];
5
+ const TAGS = ["open-banking", "finance"];
6
+ const openBankingAccountsReadCapability = {
7
+ meta: {
8
+ key: "openbanking.accounts.read",
9
+ version: 1,
10
+ kind: "integration",
11
+ title: "Open Banking Accounts (Read)",
12
+ description: "Provides read-only access to linked bank accounts, including account summaries and metadata.",
13
+ domain: "finance",
14
+ owners: [...OWNERS],
15
+ tags: [...TAGS],
16
+ stability: StabilityEnum.Experimental
17
+ },
18
+ provides: [
19
+ {
20
+ surface: "operation",
21
+ key: "openbanking.accounts.list",
22
+ version: 1,
23
+ description: "List bank accounts linked to a Powens open banking connection."
24
+ },
25
+ {
26
+ surface: "operation",
27
+ key: "openbanking.accounts.get",
28
+ version: 1,
29
+ description: "Retrieve the canonical bank account record for a specific account."
30
+ },
31
+ {
32
+ surface: "operation",
33
+ key: "openbanking.accounts.sync",
34
+ version: 1,
35
+ description: "Trigger a refresh of bank account metadata from the open banking provider."
36
+ }
37
+ ]
38
+ };
39
+ const openBankingTransactionsReadCapability = {
40
+ meta: {
41
+ key: "openbanking.transactions.read",
42
+ version: 1,
43
+ kind: "integration",
44
+ title: "Open Banking Transactions (Read)",
45
+ description: "Enables retrieval of transaction history for linked bank accounts via open banking providers.",
46
+ domain: "finance",
47
+ owners: [...OWNERS],
48
+ tags: [...TAGS, "transactions"],
49
+ stability: StabilityEnum.Experimental
50
+ },
51
+ provides: [{
52
+ surface: "operation",
53
+ key: "openbanking.transactions.list",
54
+ version: 1,
55
+ description: "List transactions for a given bank account with optional date filtering."
56
+ }, {
57
+ surface: "operation",
58
+ key: "openbanking.transactions.sync",
59
+ version: 1,
60
+ description: "Synchronise transactions from the open banking provider into the canonical ledger."
61
+ }]
62
+ };
63
+ const openBankingBalancesReadCapability = {
64
+ meta: {
65
+ key: "openbanking.balances.read",
66
+ version: 1,
67
+ kind: "integration",
68
+ title: "Open Banking Balances (Read)",
69
+ description: "Allows querying of current and available balances for linked bank accounts via open banking providers.",
70
+ domain: "finance",
71
+ owners: [...OWNERS],
72
+ tags: [...TAGS, "balances"],
73
+ stability: StabilityEnum.Experimental
74
+ },
75
+ provides: [{
76
+ surface: "operation",
77
+ key: "openbanking.balances.get",
78
+ version: 1,
79
+ description: "Retrieve the latest known balances for a specified bank account."
80
+ }, {
81
+ surface: "operation",
82
+ key: "openbanking.balances.refresh",
83
+ version: 1,
84
+ description: "Force a balance refresh from the open banking provider."
85
+ }]
86
+ };
87
+ function registerOpenBankingCapabilities(registry) {
88
+ return registry.register(openBankingAccountsReadCapability).register(openBankingTransactionsReadCapability).register(openBankingBalancesReadCapability);
89
+ }
90
+
91
+ //#endregion
92
+ export { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };
@@ -0,0 +1,6 @@
1
+ import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./react/feature-render.js";
2
+ import { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer } from "./react/form-render.js";
3
+ import { ShadcnDriver, shadcnDriver } from "./react/drivers/shadcn.js";
4
+ import { RnReusablesDriver, rnReusablesDriver } from "./react/drivers/rn-reusables.js";
5
+ import "./react/index.js";
6
+ export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, RnReusablesDriver, ShadcnDriver, createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };
@@ -0,0 +1,9 @@
1
+ 'use client';
2
+
3
+ import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./react/feature-render.js";
4
+ import { createFormRenderer } from "./react/form-render.js";
5
+ import { shadcnDriver } from "./react/drivers/shadcn.js";
6
+ import { rnReusablesDriver } from "./react/drivers/rn-reusables.js";
7
+ import "./react/index.js";
8
+
9
+ export { createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };
@@ -0,0 +1,22 @@
1
+ import { DriverSlots } from "../form-render.js";
2
+
3
+ //#region src/client/react/drivers/rn-reusables.d.ts
4
+
5
+ /**
6
+ * Create a React Native UI-kit driver by mapping required slots to components.
7
+ * Host apps should import their UI-kit primitives and pass them here.
8
+ *
9
+ * Example usage:
10
+ * ```tsx
11
+ * import { rnReusablesDriver } from '@contractspec/lib.contracts/client/react/drivers/rn-reusables';
12
+ * import { Input, Textarea, Button } from '@contractspec/lib.ui-kit/ui';
13
+ *
14
+ * const driver = rnReusablesDriver({
15
+ * Input, Textarea, Button, // ... other components
16
+ * });
17
+ * ```
18
+ */
19
+ declare function rnReusablesDriver(slots: DriverSlots): DriverSlots;
20
+ type RnReusablesDriver = ReturnType<typeof rnReusablesDriver>;
21
+ //#endregion
22
+ export { RnReusablesDriver, rnReusablesDriver };
@@ -0,0 +1,21 @@
1
+ //#region src/client/react/drivers/rn-reusables.ts
2
+ /**
3
+ * Create a React Native UI-kit driver by mapping required slots to components.
4
+ * Host apps should import their UI-kit primitives and pass them here.
5
+ *
6
+ * Example usage:
7
+ * ```tsx
8
+ * import { rnReusablesDriver } from '@contractspec/lib.contracts/client/react/drivers/rn-reusables';
9
+ * import { Input, Textarea, Button } from '@contractspec/lib.ui-kit/ui';
10
+ *
11
+ * const driver = rnReusablesDriver({
12
+ * Input, Textarea, Button, // ... other components
13
+ * });
14
+ * ```
15
+ */
16
+ function rnReusablesDriver(slots) {
17
+ return slots;
18
+ }
19
+
20
+ //#endregion
21
+ export { rnReusablesDriver };
@@ -0,0 +1,12 @@
1
+ import { DriverSlots } from "../form-render.js";
2
+
3
+ //#region src/client/react/drivers/shadcn.d.ts
4
+
5
+ /**
6
+ * Create a shadcn/ui driver by mapping required slots to components.
7
+ * Host apps should import their shadcn primitives and pass them here.
8
+ */
9
+ declare function shadcnDriver(slots: DriverSlots): DriverSlots;
10
+ type ShadcnDriver = ReturnType<typeof shadcnDriver>;
11
+ //#endregion
12
+ export { ShadcnDriver, shadcnDriver };
@@ -0,0 +1,11 @@
1
+ //#region src/client/react/drivers/shadcn.ts
2
+ /**
3
+ * Create a shadcn/ui driver by mapping required slots to components.
4
+ * Host apps should import their shadcn primitives and pass them here.
5
+ */
6
+ function shadcnDriver(slots) {
7
+ return slots;
8
+ }
9
+
10
+ //#endregion
11
+ export { shadcnDriver };
@@ -0,0 +1,23 @@
1
+ import { PresentationSpec, PresentationTarget } from "../../presentations/presentations.js";
2
+ import { FeatureModuleSpec } from "../../features/types.js";
3
+ import { FeatureRegistry } from "../../features/registry.js";
4
+ import { ComponentMap, TransformEngine } from "../../presentations/transform-engine.js";
5
+ import "../../presentations/index.js";
6
+ import "../../features/index.js";
7
+ import React from "react";
8
+ import { BlockConfig } from "@blocknote/core";
9
+
10
+ //#region src/client/react/feature-render.d.ts
11
+ declare function createEngineWithDefaults(): TransformEngine;
12
+ declare function renderFeaturePresentation(engine: TransformEngine, target: PresentationTarget, desc: PresentationSpec, options?: {
13
+ componentMap?: ComponentMap;
14
+ reactProps?: Record<string, unknown>;
15
+ renderBlockNote?: (docJson: unknown, blockConfig?: BlockConfig) => React.ReactElement;
16
+ }): Promise<React.ReactElement | {
17
+ mimeType: string;
18
+ body: string;
19
+ } | null>;
20
+ declare function createFeatureModule(meta: FeatureModuleSpec['meta'], refs: Partial<Pick<FeatureModuleSpec, 'operations' | 'events' | 'presentations' | 'presentationsTargets'>>): FeatureModuleSpec;
21
+ declare function registerFeature(registry: FeatureRegistry, feature: FeatureModuleSpec): FeatureRegistry;
22
+ //#endregion
23
+ export { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation };
@@ -0,0 +1,44 @@
1
+ import { createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "../../presentations/transform-engine.js";
2
+ import "../../presentations/index.js";
3
+ import React from "react";
4
+
5
+ //#region src/client/react/feature-render.ts
6
+ function createEngineWithDefaults() {
7
+ return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
8
+ }
9
+ async function renderFeaturePresentation(engine, target, desc, options) {
10
+ if (target === "react") {
11
+ const rd = await engine.render("react", desc);
12
+ if (rd.kind === "react_component") {
13
+ const C = (options?.componentMap ?? {})[rd.componentKey];
14
+ if (!C) return null;
15
+ const merged = {
16
+ ...rd.props ?? {},
17
+ ...options?.reactProps ?? {}
18
+ };
19
+ return React.createElement(C, merged);
20
+ }
21
+ if (rd.kind === "blocknotejs") {
22
+ if (options?.renderBlockNote) return options.renderBlockNote(rd.docJson, rd.blockConfig);
23
+ return React.createElement("div", {}, "[BlockNote renderer not configured]");
24
+ }
25
+ return null;
26
+ }
27
+ if (target === "markdown") return engine.render(target, desc);
28
+ if (target === "application/json") return engine.render(target, desc);
29
+ if (target === "application/xml") return engine.render(target, desc);
30
+ return null;
31
+ }
32
+ function createFeatureModule(meta, refs) {
33
+ return {
34
+ meta,
35
+ ...refs
36
+ };
37
+ }
38
+ function registerFeature(registry, feature) {
39
+ registry.register(feature);
40
+ return registry;
41
+ }
42
+
43
+ //#endregion
44
+ export { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation };
@@ -0,0 +1,92 @@
1
+ import { FormOption, FormSpec, FormValuesFor } from "../../forms/forms.js";
2
+ import "../../forms/index.js";
3
+ import { AnySchemaModel } from "@contractspec/lib.schema";
4
+ import React from "react";
5
+ import * as react_jsx_runtime0 from "react/jsx-runtime";
6
+
7
+ //#region src/client/react/form-render.d.ts
8
+ interface DriverSlots {
9
+ Field: React.ComponentType<React.PropsWithChildren<{
10
+ 'data-invalid'?: boolean;
11
+ hidden?: boolean;
12
+ disabled?: boolean;
13
+ }>>;
14
+ FieldLabel: React.ComponentType<React.PropsWithChildren<{
15
+ htmlFor?: string;
16
+ }>>;
17
+ FieldDescription: React.ComponentType<React.PropsWithChildren<{}>>;
18
+ FieldError: React.ComponentType<{
19
+ errors: {
20
+ message?: string;
21
+ }[];
22
+ }>;
23
+ FieldGroup?: React.ComponentType<React.PropsWithChildren<{
24
+ className?: string;
25
+ }>>;
26
+ FieldSet?: React.ComponentType<React.PropsWithChildren<{
27
+ className?: string;
28
+ }>>;
29
+ FieldLegend?: React.ComponentType<React.PropsWithChildren<{
30
+ variant?: 'label' | 'default';
31
+ }>>;
32
+ Input: React.ComponentType<React.InputHTMLAttributes<HTMLInputElement>>;
33
+ Textarea: React.ComponentType<React.TextareaHTMLAttributes<HTMLTextAreaElement>>;
34
+ Select: React.ComponentType<{
35
+ id?: string;
36
+ name?: string;
37
+ value?: unknown;
38
+ onChange?: (v: unknown) => void;
39
+ disabled?: boolean;
40
+ 'aria-invalid'?: boolean;
41
+ options: FormOption[];
42
+ } & Record<string, unknown>>;
43
+ Checkbox: React.ComponentType<{
44
+ id?: string;
45
+ name?: string;
46
+ checked?: boolean;
47
+ onCheckedChange?: (v: boolean) => void;
48
+ disabled?: boolean;
49
+ } & Record<string, unknown>>;
50
+ RadioGroup: React.ComponentType<{
51
+ id?: string;
52
+ name?: string;
53
+ value?: unknown;
54
+ onValueChange?: (v: unknown) => void;
55
+ disabled?: boolean;
56
+ options: FormOption[];
57
+ } & Record<string, unknown>>;
58
+ Switch: React.ComponentType<{
59
+ id?: string;
60
+ name?: string;
61
+ checked?: boolean;
62
+ onCheckedChange?: (v: boolean) => void;
63
+ disabled?: boolean;
64
+ } & Record<string, unknown>>;
65
+ Button: React.ComponentType<React.PropsWithChildren<{
66
+ type?: 'button' | 'submit' | 'reset';
67
+ variant?: string;
68
+ size?: string;
69
+ onClick?: () => void;
70
+ disabled?: boolean;
71
+ }>>;
72
+ }
73
+ type ResolverMap<TValues> = Record<string, (values: TValues, args?: unknown) => Promise<FormOption[]> | FormOption[]>;
74
+ type ComputationMap<TValues> = Record<string, (values: TValues) => unknown>;
75
+ interface CreateRendererOptions<TValues = Record<string, unknown>> {
76
+ driver: DriverSlots;
77
+ formOptions?: Record<string, unknown>;
78
+ onSubmitOverride?: (values: TValues, actionKey: string) => Promise<void> | void;
79
+ activeFlags?: string[];
80
+ resolvers?: ResolverMap<TValues>;
81
+ computations?: ComputationMap<TValues>;
82
+ unmountStrategy?: 'keep' | 'clear';
83
+ }
84
+ interface RenderOptions<TValues = Record<string, unknown>> {
85
+ defaultValues?: Partial<TValues>;
86
+ overrides?: Partial<CreateRendererOptions<TValues>>;
87
+ }
88
+ declare function createFormRenderer<M extends AnySchemaModel = AnySchemaModel>(base: CreateRendererOptions<FormValuesFor<M>>): {
89
+ render: (spec: FormSpec<M>, options?: RenderOptions<FormValuesFor<M>>) => react_jsx_runtime0.JSX.Element;
90
+ };
91
+ //#endregion
92
+ export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer };
@@ -0,0 +1,298 @@
1
+ import { buildZodWithRelations, evalPredicate } from "../../forms/forms.js";
2
+ import React, { useEffect, useMemo, useState } from "react";
3
+ import { Controller, useFieldArray, useForm } from "react-hook-form";
4
+ import { zodResolver } from "@hookform/resolvers/zod";
5
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
+
7
+ //#region src/client/react/form-render.tsx
8
+ function toOptionsArray(src) {
9
+ if (!src) return void 0;
10
+ if (Array.isArray(src)) return {
11
+ kind: "static",
12
+ options: src
13
+ };
14
+ return src;
15
+ }
16
+ function getAtPath(values, path) {
17
+ if (!path) return void 0;
18
+ const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
19
+ let cur = values;
20
+ for (const s of segs) {
21
+ if (cur == null) return void 0;
22
+ cur = cur[s];
23
+ }
24
+ return cur;
25
+ }
26
+ function makeDepsKey(values, deps) {
27
+ if (!deps || deps.length === 0) return "[]";
28
+ try {
29
+ return JSON.stringify(deps.map((d) => getAtPath(values, d)));
30
+ } catch {
31
+ return "[]";
32
+ }
33
+ }
34
+ function useResolvedOptions(values, source, resolvers) {
35
+ const [opts, setOpts] = useState([]);
36
+ useEffect(() => {
37
+ let mounted = true;
38
+ const run = async () => {
39
+ if (!source) return setOpts([]);
40
+ if (source.kind === "static") return setOpts([...source.options ?? []]);
41
+ const fn = resolvers?.[source.resolverKey];
42
+ if (!fn) return setOpts([]);
43
+ const res = await fn(values, source.args);
44
+ if (mounted) setOpts([...res ?? []]);
45
+ };
46
+ run();
47
+ return () => {
48
+ mounted = false;
49
+ };
50
+ }, [useMemo(() => {
51
+ if (!source) return "nil";
52
+ if (source.kind === "static") return JSON.stringify(source.options ?? []);
53
+ return makeDepsKey(values, source.deps);
54
+ }, [source, values]), source && source.kind === "resolver" ? source.resolverKey : void 0]);
55
+ return opts;
56
+ }
57
+ function fieldPath(parent, name, arrayIndex) {
58
+ if (!name) return parent ?? "";
59
+ const child = typeof arrayIndex === "number" ? `${name.replace(/^\$index$/, String(arrayIndex))}` : name;
60
+ return parent ? `${parent}${typeof arrayIndex === "number" ? `.${arrayIndex}` : ""}.${child}`.replace(/\.+/g, ".") : child;
61
+ }
62
+ function createFormRenderer(base) {
63
+ const conf = base;
64
+ const { driver } = conf;
65
+ function InternalForm(props) {
66
+ const { spec, options, merged } = props;
67
+ const baseZod = useMemo(() => buildZodWithRelations(spec), [spec]);
68
+ const form = useForm({
69
+ ...merged.formOptions,
70
+ resolver: zodResolver(baseZod),
71
+ defaultValues: options?.defaultValues
72
+ });
73
+ const values = form.watch();
74
+ const renderOne = (f, parent, arrayIndex) => {
75
+ const DriverField = driver.Field;
76
+ const DriverLabel = driver.FieldLabel;
77
+ const DriverDesc = driver.FieldDescription;
78
+ const DriverError = driver.FieldError;
79
+ const name = fieldPath(parent, f.name, arrayIndex);
80
+ const visible = evalPredicate(values, f.visibleWhen);
81
+ const enabled = evalPredicate(values, f.enabledWhen);
82
+ const invalid = Boolean(form.getFieldState(name)?.invalid);
83
+ if (!visible) return null;
84
+ const id = name?.replace(/\./g, "-");
85
+ const commonWrapProps = {
86
+ "data-invalid": invalid,
87
+ hidden: !visible,
88
+ disabled: !enabled
89
+ };
90
+ const labelNode = f.labelI18n ? /* @__PURE__ */ jsx(DriverLabel, {
91
+ htmlFor: id,
92
+ children: f.labelI18n
93
+ }) : null;
94
+ const descNode = f.descriptionI18n ? /* @__PURE__ */ jsx(DriverDesc, { children: f.descriptionI18n }) : null;
95
+ if (f.kind === "group") {
96
+ const children = f.fields.map((c, i) => /* @__PURE__ */ jsx(React.Fragment, { children: renderOne(c, name, arrayIndex) }, `${name}-${i}`));
97
+ return /* @__PURE__ */ jsxs(DriverField, {
98
+ ...commonWrapProps,
99
+ children: [
100
+ labelNode,
101
+ children,
102
+ descNode
103
+ ]
104
+ });
105
+ }
106
+ if (f.kind === "array") return renderArray(f, parent);
107
+ return /* @__PURE__ */ jsx(Controller, {
108
+ name,
109
+ control: form.control,
110
+ render: ({ field, fieldState }) => {
111
+ const err = fieldState.error ? [fieldState.error] : [];
112
+ const ariaInvalid = fieldState.invalid || void 0;
113
+ if (f.kind === "text") {
114
+ const textField = f;
115
+ const Input = driver.Input;
116
+ return /* @__PURE__ */ jsxs(DriverField, {
117
+ ...commonWrapProps,
118
+ children: [
119
+ labelNode,
120
+ /* @__PURE__ */ jsx(Input, {
121
+ id,
122
+ "aria-invalid": ariaInvalid,
123
+ placeholder: f.placeholderI18n,
124
+ autoComplete: textField.autoComplete,
125
+ inputMode: textField.inputMode,
126
+ maxLength: textField.maxLength,
127
+ minLength: textField.minLength,
128
+ disabled: !enabled,
129
+ ...field,
130
+ ...f.uiProps
131
+ }),
132
+ descNode,
133
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
134
+ ]
135
+ });
136
+ }
137
+ if (f.kind === "textarea") {
138
+ const textareaField = f;
139
+ const Textarea = driver.Textarea;
140
+ return /* @__PURE__ */ jsxs(DriverField, {
141
+ ...commonWrapProps,
142
+ children: [
143
+ labelNode,
144
+ /* @__PURE__ */ jsx(Textarea, {
145
+ id,
146
+ "aria-invalid": ariaInvalid,
147
+ placeholder: f.placeholderI18n,
148
+ rows: textareaField.rows,
149
+ maxLength: textareaField.maxLength,
150
+ disabled: !enabled,
151
+ ...field,
152
+ ...f.uiProps
153
+ }),
154
+ descNode,
155
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
156
+ ]
157
+ });
158
+ }
159
+ if (f.kind === "select") {
160
+ const selectField = f;
161
+ const Select = driver.Select;
162
+ const opts = useResolvedOptions(values, toOptionsArray(selectField.options), merged.resolvers);
163
+ return /* @__PURE__ */ jsxs(DriverField, {
164
+ ...commonWrapProps,
165
+ children: [
166
+ labelNode,
167
+ /* @__PURE__ */ jsx(Select, {
168
+ id,
169
+ name,
170
+ "aria-invalid": ariaInvalid,
171
+ disabled: !enabled,
172
+ value: field.value,
173
+ onChange: (v) => field.onChange(v),
174
+ options: opts,
175
+ ...f.uiProps
176
+ }),
177
+ descNode,
178
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
179
+ ]
180
+ });
181
+ }
182
+ if (f.kind === "checkbox") {
183
+ const Checkbox = driver.Checkbox;
184
+ return /* @__PURE__ */ jsxs(DriverField, {
185
+ ...commonWrapProps,
186
+ children: [
187
+ labelNode,
188
+ /* @__PURE__ */ jsx(Checkbox, {
189
+ id,
190
+ name,
191
+ disabled: !enabled,
192
+ checked: !!field.value,
193
+ onCheckedChange: (v) => field.onChange(v),
194
+ ...f.uiProps
195
+ }),
196
+ descNode,
197
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
198
+ ]
199
+ });
200
+ }
201
+ if (f.kind === "radio") {
202
+ const radioField = f;
203
+ const RadioGroup = driver.RadioGroup;
204
+ const opts = useResolvedOptions(values, toOptionsArray(radioField.options), merged.resolvers);
205
+ return /* @__PURE__ */ jsxs(DriverField, {
206
+ ...commonWrapProps,
207
+ children: [
208
+ labelNode,
209
+ /* @__PURE__ */ jsx(RadioGroup, {
210
+ id,
211
+ name,
212
+ disabled: !enabled,
213
+ value: field.value,
214
+ onValueChange: (v) => field.onChange(v),
215
+ options: opts,
216
+ ...f.uiProps
217
+ }),
218
+ descNode,
219
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
220
+ ]
221
+ });
222
+ }
223
+ if (f.kind === "switch") {
224
+ const Switch = driver.Switch;
225
+ return /* @__PURE__ */ jsxs(DriverField, {
226
+ ...commonWrapProps,
227
+ children: [
228
+ labelNode,
229
+ /* @__PURE__ */ jsx(Switch, {
230
+ id,
231
+ name,
232
+ disabled: !enabled,
233
+ checked: !!field.value,
234
+ onCheckedChange: (v) => field.onChange(v),
235
+ ...f.uiProps
236
+ }),
237
+ descNode,
238
+ fieldState.invalid ? /* @__PURE__ */ jsx(DriverError, { errors: err }) : null
239
+ ]
240
+ });
241
+ }
242
+ return /* @__PURE__ */ jsx(Fragment, {});
243
+ }
244
+ }, name);
245
+ };
246
+ const renderArray = (f, parent) => {
247
+ const name = fieldPath(parent, f.name);
248
+ const { fields, append, remove } = useFieldArray({
249
+ control: form.control,
250
+ name
251
+ });
252
+ const canAdd = f.max == null || fields.length < f.max;
253
+ const canRemove = (idx) => (f.min == null ? fields.length > 0 : fields.length > f.min) && idx >= 0;
254
+ const Button$1 = driver.Button;
255
+ const Label = driver.FieldLabel;
256
+ return /* @__PURE__ */ jsxs("div", { children: [
257
+ f.labelI18n ? /* @__PURE__ */ jsx(Label, { children: f.labelI18n }) : null,
258
+ fields.map((row, idx) => /* @__PURE__ */ jsxs("div", { children: [renderOne(f.of, name, idx), canRemove(idx) ? /* @__PURE__ */ jsx(Button$1, {
259
+ type: "button",
260
+ variant: "ghost",
261
+ size: "sm",
262
+ onClick: () => remove(idx),
263
+ children: "Remove"
264
+ }) : null] }, row.id ?? idx)),
265
+ canAdd ? /* @__PURE__ */ jsx(Button$1, {
266
+ type: "button",
267
+ variant: "outline",
268
+ size: "sm",
269
+ onClick: () => append({}),
270
+ children: "Add"
271
+ }) : null
272
+ ] }, name);
273
+ };
274
+ const onSubmit = async (data) => {
275
+ const actionKey = spec.actions?.[0]?.key ?? "submit";
276
+ if (merged.onSubmitOverride) return merged.onSubmitOverride(data, actionKey);
277
+ };
278
+ const Button = driver.Button;
279
+ return /* @__PURE__ */ jsxs("form", {
280
+ onSubmit: form.handleSubmit(onSubmit),
281
+ children: [(spec.fields || []).map((f, i) => /* @__PURE__ */ jsx(React.Fragment, { children: renderOne(f) }, i)), spec.actions && spec.actions.length ? /* @__PURE__ */ jsx("div", { children: spec.actions.map((a) => /* @__PURE__ */ jsx(Button, {
282
+ type: "submit",
283
+ children: a.labelI18n
284
+ }, a.key)) }) : null]
285
+ });
286
+ }
287
+ return { render: (spec, options) => /* @__PURE__ */ jsx(InternalForm, {
288
+ spec,
289
+ options,
290
+ merged: {
291
+ ...conf,
292
+ ...options?.overrides ?? {}
293
+ }
294
+ }) };
295
+ }
296
+
297
+ //#endregion
298
+ export { createFormRenderer };
@@ -0,0 +1,5 @@
1
+ import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./feature-render.js";
2
+ import { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer } from "./form-render.js";
3
+ import { ShadcnDriver, shadcnDriver } from "./drivers/shadcn.js";
4
+ import { RnReusablesDriver, rnReusablesDriver } from "./drivers/rn-reusables.js";
5
+ export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, RnReusablesDriver, ShadcnDriver, createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };
@@ -0,0 +1,8 @@
1
+ 'use client';
2
+
3
+ import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./feature-render.js";
4
+ import { createFormRenderer } from "./form-render.js";
5
+ import { shadcnDriver } from "./drivers/shadcn.js";
6
+ import { rnReusablesDriver } from "./drivers/rn-reusables.js";
7
+
8
+ export { createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };
@@ -0,0 +1,3 @@
1
+ import { ContractRegistryFile, ContractRegistryItem, ContractRegistryItemType, ContractRegistryManifest, JsonSchema } from "./types.js";
2
+ import { ContractRegistryFileSchema, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestParsed, ContractRegistryManifestSchema } from "./schemas.js";
3
+ export { type ContractRegistryFile, ContractRegistryFileSchema, type ContractRegistryItem, type ContractRegistryItemParsed, ContractRegistryItemSchema, type ContractRegistryItemType, ContractRegistryItemTypeSchema, type ContractRegistryManifest, type ContractRegistryManifestParsed, ContractRegistryManifestSchema, type JsonSchema };
@@ -0,0 +1,3 @@
1
+ import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema } from "./schemas.js";
2
+
3
+ export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema };