@bluefly/openstandardagents 0.2.4 → 0.2.7

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 (511) hide show
  1. package/.cursorrules +84 -0
  2. package/.devfile.yaml +87 -0
  3. package/.env.example +25 -3
  4. package/.github/ISSUE_TEMPLATE/bug_report.yml +63 -0
  5. package/.github/ISSUE_TEMPLATE/feature_request.yml +40 -0
  6. package/.github/workflows/dependabot-comment.yml +34 -0
  7. package/.github/workflows/pr-comment.yml +33 -0
  8. package/.github/workflows/release.yml +1 -1
  9. package/.husky/pre-commit +5 -0
  10. package/.kiro/config.json +21 -0
  11. package/.kiro/settings/mcp.json +61 -0
  12. package/.kiro/specs/scripts-migration-api-first/design.md +883 -0
  13. package/.kiro/specs/scripts-migration-api-first/requirements.md +165 -0
  14. package/.kiro/specs/scripts-migration-api-first/tasks.md +539 -0
  15. package/.kiro/specs/website-brand-identity/design.md +1060 -0
  16. package/.kiro/specs/website-brand-identity/requirements.md +287 -0
  17. package/.kiro/specs/website-brand-identity/tasks.md +981 -0
  18. package/.releaserc.json +5 -4
  19. package/.version.json +6 -0
  20. package/CHANGELOG.md +163 -96
  21. package/CONTRIBUTING.md +23 -5
  22. package/README.md +130 -43
  23. package/bin/ossa +24 -3
  24. package/bin/ossa-dev +42 -0
  25. package/bin/ossa-export +32 -0
  26. package/bin/ossa-generate +60 -0
  27. package/bin/ossa-health +40 -0
  28. package/bin/ossa-init +26 -0
  29. package/bin/ossa-validate-all +55 -0
  30. package/bin/ossa-version +23 -0
  31. package/bin/validate-ossa-0.2.4.ts +244 -0
  32. package/bin/validate-ossa-0.2.5-RC.ts +244 -0
  33. package/bin/validate-ossa.ts +273 -0
  34. package/dist/di-container.d.ts +1 -1
  35. package/dist/di-container.d.ts.map +1 -1
  36. package/dist/di-container.js.map +1 -1
  37. package/dist/repositories/schema.repository.d.ts +17 -2
  38. package/dist/repositories/schema.repository.d.ts.map +1 -1
  39. package/dist/repositories/schema.repository.js +102 -19
  40. package/dist/repositories/schema.repository.js.map +1 -1
  41. package/dist/services/generation.service.d.ts +7 -5
  42. package/dist/services/generation.service.d.ts.map +1 -1
  43. package/dist/services/generation.service.js +92 -44
  44. package/dist/services/generation.service.js.map +1 -1
  45. package/dist/services/github-sync/github-client.d.ts +14 -0
  46. package/dist/services/github-sync/github-client.d.ts.map +1 -0
  47. package/dist/services/github-sync/github-client.js +41 -0
  48. package/dist/services/github-sync/github-client.js.map +1 -0
  49. package/dist/services/github-sync/gitlab-client.d.ts +17 -0
  50. package/dist/services/github-sync/gitlab-client.d.ts.map +1 -0
  51. package/dist/services/github-sync/gitlab-client.js +42 -0
  52. package/dist/services/github-sync/gitlab-client.js.map +1 -0
  53. package/dist/services/github-sync/schemas.d.ts +46 -0
  54. package/dist/services/github-sync/schemas.d.ts.map +1 -0
  55. package/dist/services/github-sync/schemas.js +36 -0
  56. package/dist/services/github-sync/schemas.js.map +1 -0
  57. package/dist/services/github-sync/sync.service.d.ts +27 -0
  58. package/dist/services/github-sync/sync.service.d.ts.map +1 -0
  59. package/dist/services/github-sync/sync.service.js +99 -0
  60. package/dist/services/github-sync/sync.service.js.map +1 -0
  61. package/dist/services/gitlab-agent.service.d.ts +94 -0
  62. package/dist/services/gitlab-agent.service.d.ts.map +1 -0
  63. package/dist/services/gitlab-agent.service.js +162 -0
  64. package/dist/services/gitlab-agent.service.js.map +1 -0
  65. package/dist/services/migration.service.d.ts +3 -3
  66. package/dist/services/migration.service.d.ts.map +1 -1
  67. package/dist/services/migration.service.js +108 -61
  68. package/dist/services/migration.service.js.map +1 -1
  69. package/dist/services/release-automation/base-crud.service.d.ts +93 -0
  70. package/dist/services/release-automation/base-crud.service.d.ts.map +1 -0
  71. package/dist/services/release-automation/base-crud.service.js +68 -0
  72. package/dist/services/release-automation/base-crud.service.js.map +1 -0
  73. package/dist/services/release-automation/index.d.ts +12 -0
  74. package/dist/services/release-automation/index.d.ts.map +1 -0
  75. package/dist/services/release-automation/index.js +12 -0
  76. package/dist/services/release-automation/index.js.map +1 -0
  77. package/dist/services/release-automation/merge-request.service.d.ts +119 -0
  78. package/dist/services/release-automation/merge-request.service.d.ts.map +1 -0
  79. package/dist/services/release-automation/merge-request.service.js +212 -0
  80. package/dist/services/release-automation/merge-request.service.js.map +1 -0
  81. package/dist/services/release-automation/milestone.service.d.ts +104 -0
  82. package/dist/services/release-automation/milestone.service.d.ts.map +1 -0
  83. package/dist/services/release-automation/milestone.service.js +207 -0
  84. package/dist/services/release-automation/milestone.service.js.map +1 -0
  85. package/dist/services/release-automation/release.service.d.ts +118 -0
  86. package/dist/services/release-automation/release.service.d.ts.map +1 -0
  87. package/dist/services/release-automation/release.service.js +207 -0
  88. package/dist/services/release-automation/release.service.js.map +1 -0
  89. package/dist/services/release-automation/schemas/release.schema.d.ts +299 -0
  90. package/dist/services/release-automation/schemas/release.schema.d.ts.map +1 -0
  91. package/dist/services/release-automation/schemas/release.schema.js +269 -0
  92. package/dist/services/release-automation/schemas/release.schema.js.map +1 -0
  93. package/dist/services/release-automation/tag.service.d.ts +99 -0
  94. package/dist/services/release-automation/tag.service.d.ts.map +1 -0
  95. package/dist/services/release-automation/tag.service.js +180 -0
  96. package/dist/services/release-automation/tag.service.js.map +1 -0
  97. package/dist/services/release-automation/webhook.service.d.ts +37 -0
  98. package/dist/services/release-automation/webhook.service.d.ts.map +1 -0
  99. package/dist/services/release-automation/webhook.service.js +173 -0
  100. package/dist/services/release-automation/webhook.service.js.map +1 -0
  101. package/dist/services/runtime/claude/capability-mapper.d.ts +84 -0
  102. package/dist/services/runtime/claude/capability-mapper.d.ts.map +1 -0
  103. package/dist/services/runtime/claude/capability-mapper.js +245 -0
  104. package/dist/services/runtime/claude/capability-mapper.js.map +1 -0
  105. package/dist/services/runtime/claude/claude-adapter.d.ts +80 -0
  106. package/dist/services/runtime/claude/claude-adapter.d.ts.map +1 -0
  107. package/dist/services/runtime/claude/claude-adapter.js +287 -0
  108. package/dist/services/runtime/claude/claude-adapter.js.map +1 -0
  109. package/dist/services/runtime/claude/manifest-parser.d.ts +77 -0
  110. package/dist/services/runtime/claude/manifest-parser.d.ts.map +1 -0
  111. package/dist/services/runtime/claude/manifest-parser.js +169 -0
  112. package/dist/services/runtime/claude/manifest-parser.js.map +1 -0
  113. package/dist/services/runtime/claude/types.d.ts +115 -0
  114. package/dist/services/runtime/claude/types.d.ts.map +1 -0
  115. package/dist/services/runtime/claude/types.js +6 -0
  116. package/dist/services/runtime/claude/types.js.map +1 -0
  117. package/dist/services/runtime/openai.adapter.d.ts.map +1 -1
  118. package/dist/services/runtime/openai.adapter.js.map +1 -1
  119. package/dist/services/validation.service.d.ts.map +1 -1
  120. package/dist/services/validation.service.js +35 -11
  121. package/dist/services/validation.service.js.map +1 -1
  122. package/dist/services/validators/anthropic.validator.d.ts +2 -2
  123. package/dist/services/validators/anthropic.validator.d.ts.map +1 -1
  124. package/dist/services/validators/anthropic.validator.js +14 -9
  125. package/dist/services/validators/anthropic.validator.js.map +1 -1
  126. package/dist/services/validators/autogen.validator.d.ts +2 -2
  127. package/dist/services/validators/autogen.validator.d.ts.map +1 -1
  128. package/dist/services/validators/autogen.validator.js +18 -15
  129. package/dist/services/validators/autogen.validator.js.map +1 -1
  130. package/dist/services/validators/crewai.validator.d.ts +2 -2
  131. package/dist/services/validators/crewai.validator.d.ts.map +1 -1
  132. package/dist/services/validators/crewai.validator.js +18 -17
  133. package/dist/services/validators/crewai.validator.js.map +1 -1
  134. package/dist/services/validators/cursor.validator.d.ts +2 -2
  135. package/dist/services/validators/cursor.validator.d.ts.map +1 -1
  136. package/dist/services/validators/cursor.validator.js +15 -11
  137. package/dist/services/validators/cursor.validator.js.map +1 -1
  138. package/dist/services/validators/langchain.validator.d.ts +2 -2
  139. package/dist/services/validators/langchain.validator.d.ts.map +1 -1
  140. package/dist/services/validators/langchain.validator.js +14 -11
  141. package/dist/services/validators/langchain.validator.js.map +1 -1
  142. package/dist/services/validators/langflow.validator.d.ts +2 -2
  143. package/dist/services/validators/langflow.validator.d.ts.map +1 -1
  144. package/dist/services/validators/langflow.validator.js +14 -9
  145. package/dist/services/validators/langflow.validator.js.map +1 -1
  146. package/dist/services/validators/langgraph.validator.d.ts +2 -2
  147. package/dist/services/validators/langgraph.validator.d.ts.map +1 -1
  148. package/dist/services/validators/langgraph.validator.js +23 -18
  149. package/dist/services/validators/langgraph.validator.js.map +1 -1
  150. package/dist/services/validators/llamaindex.validator.d.ts +2 -2
  151. package/dist/services/validators/llamaindex.validator.d.ts.map +1 -1
  152. package/dist/services/validators/llamaindex.validator.js +19 -16
  153. package/dist/services/validators/llamaindex.validator.js.map +1 -1
  154. package/dist/services/validators/openai.validator.d.ts +2 -2
  155. package/dist/services/validators/openai.validator.d.ts.map +1 -1
  156. package/dist/services/validators/openai.validator.js +20 -16
  157. package/dist/services/validators/openai.validator.js.map +1 -1
  158. package/dist/services/validators/vercel-ai.validator.d.ts +2 -2
  159. package/dist/services/validators/vercel-ai.validator.d.ts.map +1 -1
  160. package/dist/services/validators/vercel-ai.validator.js +16 -15
  161. package/dist/services/validators/vercel-ai.validator.js.map +1 -1
  162. package/dist/spec/v0.2.0/ossa-0.2.0.schema.json +0 -0
  163. package/dist/spec/v0.2.1/ossa-0.2.1.schema.json +555 -0
  164. package/dist/spec/v0.2.3/CHANGELOG.md +7 -7
  165. package/dist/spec/v0.2.3/README.md +9 -9
  166. package/dist/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +18 -18
  167. package/{spec/v0.2.4-dev → dist/spec/v0.2.4}/CHANGELOG.md +8 -8
  168. package/dist/spec/{v0.2.4-dev → v0.2.4}/migrations/v0.2.3-to-v0.2.4.md +10 -10
  169. package/dist/spec/{v0.2.4-dev/ossa-0.2.4-dev.yaml → v0.2.4/ossa-0.2.4.yaml} +1 -1
  170. package/dist/spec/v0.2.5/CHANGELOG.md +401 -0
  171. package/dist/spec/v0.2.5/README.md +72 -0
  172. package/dist/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  173. package/dist/spec/v0.2.5/ossa-0.2.5.schema.json +1696 -0
  174. package/dist/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  175. package/dist/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  176. package/dist/spec/v0.2.5-RC/README.md +72 -0
  177. package/{spec/v0.2.4-dev → dist/spec/v0.2.5-RC}/migrations/v0.2.3-to-v0.2.4.md +10 -10
  178. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  179. package/dist/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  180. package/dist/spec/v0.2.6/CHANGELOG.md +401 -0
  181. package/dist/spec/v0.2.6/README.md +72 -0
  182. package/dist/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  183. package/dist/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  184. package/dist/spec/v0.2.6/ossa-0.2.6.schema.json +1786 -0
  185. package/dist/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  186. package/dist/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  187. package/dist/spec/v0.2.6-dev/README.md +75 -0
  188. package/dist/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  189. package/dist/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  190. package/dist/spec/v0.2.6-dev/ossa-0.2.5.schema.json +1696 -0
  191. package/dist/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  192. package/dist/spec/{v0.2.5-dev/ossa-0.2.5-dev.schema.json → v0.2.6-dev/ossa-0.2.6-dev.schema.json} +323 -359
  193. package/dist/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  194. package/dist/spec/v0.2.7/core/agentgraph.md +324 -0
  195. package/dist/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  196. package/dist/types/index.d.ts +6 -1
  197. package/dist/types/index.d.ts.map +1 -1
  198. package/docs/brand-guide/01-brand-overview.md +37 -0
  199. package/docs/brand-guide/02-logo-usage.md +43 -0
  200. package/docs/brand-guide/03-color-palette.md +70 -0
  201. package/docs/brand-guide/04-typography.md +82 -0
  202. package/docs/brand-guide/05-voice-and-tone.md +108 -0
  203. package/docs/brand-guide/06-visual-elements.md +137 -0
  204. package/docs/brand-guide/07-application-examples.md +153 -0
  205. package/docs/brand-guide/OssaLogo/OssA_Logo.svg +21 -0
  206. package/docs/brand-guide/OssaLogo/brand.af +0 -0
  207. package/docs/brand-guide/README.md +107 -0
  208. package/docs/comparison.md +315 -0
  209. package/docs/operations/automation-roadmap.md +245 -0
  210. package/docs/operations/github-sync-strategy.md +357 -0
  211. package/examples/anthropic/claude-assistant.ossa.json +5 -4
  212. package/examples/autogen/multi-agent.ossa.json +6 -4
  213. package/examples/bridges/Dockerfile.production +1 -1
  214. package/examples/crewai/research-team.ossa.json +14 -5
  215. package/examples/cursor/code-review-agent.ossa.json +21 -6
  216. package/examples/enterprise/agent.yml +1 -1
  217. package/examples/getting-started/hello-world-complete.ossa.yaml +2 -2
  218. package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml +4 -4
  219. package/examples/langchain/chain-agent.ossa.json +21 -5
  220. package/examples/langflow/workflow-agent.ossa.json +2 -3
  221. package/examples/langgraph/state-machine-agent.ossa.json +2 -3
  222. package/examples/llamaindex/rag-agent.ossa.json +2 -3
  223. package/examples/openai/basic-agent.ossa.yaml +61 -0
  224. package/examples/openai/multi-tool-agent.ossa.json +188 -0
  225. package/examples/openai/swarm-agent.ossa.json +18 -5
  226. package/examples/openapi-extensions/README.md +1 -1
  227. package/examples/quickstart/support-agent.ossa.yaml +1 -1
  228. package/examples/vercel/edge-agent.ossa.json +5 -4
  229. package/infrastructure/gitlab-agent/rbac.yaml +126 -0
  230. package/infrastructure/gitlab-agent/values.yaml +150 -0
  231. package/infrastructure/k8s/monitoring/00-namespace.yaml +7 -0
  232. package/infrastructure/k8s/monitoring/01-prometheus.yaml +142 -0
  233. package/infrastructure/k8s/monitoring/02-grafana.yaml +63 -0
  234. package/infrastructure/k8s/monitoring/03-lightweight.yaml +121 -0
  235. package/infrastructure/k8s/monitoring/README.md +73 -0
  236. package/infrastructure/k8s/monitoring/deploy.sh +38 -0
  237. package/openapi/CHANGELOG.md +21 -0
  238. package/openapi/README.md +46 -0
  239. package/openapi/{ossa-core-api.openapi.yaml → core/ossa-core-api.openapi.yaml} +59 -4
  240. package/openapi/{ossa-registry.openapi.yaml → core/ossa-registry.openapi.yaml} +75 -2
  241. package/openapi/{unified-agent-gateway.openapi.yaml → core/unified-agent-gateway.openapi.yaml} +3 -3
  242. package/openapi/github-sync.yaml +115 -0
  243. package/openapi/reference-implementations/aiflow-bridge-api.openapi.yaml +136 -0
  244. package/openapi/reference-implementations/compliance-agent-api.openapi.yaml +192 -0
  245. package/openapi/reference-implementations/crewai-agent-api.openapi.yaml +149 -0
  246. package/openapi/reference-implementations/critic-agent-api.openapi.yaml +151 -0
  247. package/openapi/reference-implementations/document-analyzer-api.openapi.yaml +217 -0
  248. package/openapi/reference-implementations/getting-started-hello-world-api.openapi.yaml +149 -0
  249. package/openapi/reference-implementations/gitlab-ml-recommender-api.openapi.yaml +151 -0
  250. package/openapi/reference-implementations/governor-agent-api.openapi.yaml +193 -0
  251. package/openapi/reference-implementations/integrator-agent-api.openapi.yaml +165 -0
  252. package/openapi/reference-implementations/judge-agent-api.openapi.yaml +148 -0
  253. package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml +167 -0
  254. package/openapi/reference-implementations/langchain-agent-api.openapi.yaml +171 -0
  255. package/openapi/reference-implementations/monitor-agent-api.openapi.yaml +171 -0
  256. package/openapi/reference-implementations/orchestrator-agent-api.openapi.yaml +242 -0
  257. package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml +187 -0
  258. package/openapi/{self-evolving-ecosystem.openapi.yaml → reference-implementations/self-evolving-ecosystem.openapi.yaml} +2 -2
  259. package/openapi/reference-implementations/worker-agent-api.openapi.yaml +208 -0
  260. package/openapi/reference-implementations/workflow-orchestrator-api.openapi.yaml +193 -0
  261. package/package.json +53 -22
  262. package/release.config.js +20 -5
  263. package/scripts/README.md +103 -0
  264. package/scripts/auto-rebase-mrs.ts +106 -0
  265. package/scripts/batch-dependabot.sh +57 -0
  266. package/scripts/bump-version.ts +57 -0
  267. package/scripts/configure-gitlab-branch-protection.ts +95 -0
  268. package/scripts/create-issue-helper.ts +238 -0
  269. package/scripts/create-milestone-issue.ts +73 -0
  270. package/scripts/enhanced-version-manager.ts +257 -0
  271. package/scripts/fix-schema-formats.js +82 -0
  272. package/scripts/gen-types.ts +51 -0
  273. package/scripts/gen-zod.ts +51 -0
  274. package/scripts/generate-agents-catalog.ts +77 -0
  275. package/scripts/generate-api-docs.ts +218 -0
  276. package/scripts/generate-cli-docs.ts +410 -0
  277. package/scripts/generate-config-docs.ts +109 -0
  278. package/scripts/generate-errors-docs.ts +76 -0
  279. package/scripts/generate-examples-docs.ts +99 -0
  280. package/scripts/generate-schema-docs.ts +296 -0
  281. package/scripts/generate-types-docs.ts +48 -0
  282. package/scripts/lib/exec.ts +37 -0
  283. package/scripts/lib/file-ops.ts +58 -0
  284. package/scripts/lib/version.ts +83 -0
  285. package/scripts/lowercase-docs.ts +43 -0
  286. package/scripts/manage-milestone-mrs.ts +279 -0
  287. package/scripts/process-doc-templates.ts +37 -0
  288. package/scripts/rebase-all-mrs.sh +75 -0
  289. package/scripts/schemas/package.schema.ts +75 -0
  290. package/scripts/setup-branch-protection.sh +33 -0
  291. package/scripts/sync-github-pr.sh +48 -0
  292. package/scripts/sync-version.js +40 -0
  293. package/scripts/sync-version.ts +39 -0
  294. package/scripts/sync-versions.ts +488 -0
  295. package/scripts/sync-wiki.sh +50 -0
  296. package/scripts/validate-all.js +127 -0
  297. package/scripts/validate-schema.ts +49 -0
  298. package/spec/v0.2.0/ossa-0.2.0.schema.json +0 -0
  299. package/spec/v0.2.1/ossa-0.2.1.schema.json +555 -0
  300. package/spec/v0.2.3/CHANGELOG.md +7 -7
  301. package/spec/v0.2.3/README.md +9 -9
  302. package/spec/v0.2.3/migrations/v0.2.2-to-v0.2.3.md +18 -18
  303. package/{dist/spec/v0.2.4-dev → spec/v0.2.4}/CHANGELOG.md +8 -8
  304. package/spec/v0.2.4/migrations/v0.2.3-to-v0.2.4.md +599 -0
  305. package/spec/{v0.2.4-dev/ossa-0.2.4-dev.yaml → v0.2.4/ossa-0.2.4.yaml} +1 -1
  306. package/spec/v0.2.5/CHANGELOG.md +401 -0
  307. package/spec/v0.2.5/README.md +72 -0
  308. package/spec/v0.2.5/migrations/v0.2.3-to-v0.2.4.md +599 -0
  309. package/spec/v0.2.5/ossa-0.2.5.schema.json +1696 -0
  310. package/spec/v0.2.5/ossa-0.2.5.yaml +581 -0
  311. package/spec/v0.2.5-RC/CHANGELOG.md +401 -0
  312. package/spec/v0.2.5-RC/README.md +72 -0
  313. package/spec/v0.2.5-RC/migrations/v0.2.3-to-v0.2.4.md +599 -0
  314. package/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json +1696 -0
  315. package/spec/v0.2.5-RC/ossa-0.2.5-RC.yaml +581 -0
  316. package/spec/v0.2.6/CHANGELOG.md +401 -0
  317. package/spec/v0.2.6/README.md +72 -0
  318. package/spec/v0.2.6/migrations/v0.2.3-to-v0.2.4.md +599 -0
  319. package/spec/v0.2.6/migrations/v0.2.5-RC-to-v0.2.6.md +65 -0
  320. package/spec/v0.2.6/ossa-0.2.6.schema.json +1786 -0
  321. package/spec/v0.2.6/ossa-0.2.6.yaml +581 -0
  322. package/spec/v0.2.6-dev/CHANGELOG.md +164 -0
  323. package/spec/v0.2.6-dev/README.md +75 -0
  324. package/spec/v0.2.6-dev/migrations/v0.2.2-to-v0.2.3.md +343 -0
  325. package/spec/v0.2.6-dev/migrations/v0.2.3-to-v0.2.4.md +599 -0
  326. package/spec/v0.2.6-dev/ossa-0.2.5.schema.json +1696 -0
  327. package/spec/v0.2.6-dev/ossa-0.2.5.yaml +581 -0
  328. package/spec/{v0.2.5-dev/ossa-0.2.5-dev.schema.json → v0.2.6-dev/ossa-0.2.6-dev.schema.json} +323 -359
  329. package/spec/v0.2.6-dev/ossa-0.2.6-dev.yaml +448 -0
  330. package/spec/v0.2.7/core/agentgraph.md +324 -0
  331. package/spec/v0.2.7/resources/agentgraph.yaml +135 -0
  332. package/website/{.lighthouserc.js → .lighthouserc.ts} +5 -1
  333. package/website/DESIGN_SYSTEM_IMPLEMENTATION.md +445 -0
  334. package/website/Dockerfile +18 -5
  335. package/website/app/about/page.tsx +60 -51
  336. package/website/app/blog/[slug]/page.tsx +61 -20
  337. package/website/app/blog/page.tsx +120 -33
  338. package/website/app/design-guide/page.tsx +511 -0
  339. package/website/app/docs/[[...slug]]/page.tsx +641 -143
  340. package/website/app/ecosystem/page.tsx +146 -111
  341. package/website/app/examples/page.tsx +51 -41
  342. package/website/app/globals.scss +370 -0
  343. package/website/app/layout.tsx +2 -2
  344. package/website/app/license/page.tsx +183 -0
  345. package/website/app/not-found.tsx +18 -0
  346. package/website/app/page.tsx +513 -236
  347. package/website/app/page.tsx.bak +679 -0
  348. package/website/app/page.tsx.bak2 +649 -0
  349. package/website/app/playground/page.tsx +25 -45
  350. package/website/app/schema/page.tsx +423 -392
  351. package/website/app/specification/page.tsx +245 -169
  352. package/website/components/Logo.tsx +75 -2
  353. package/website/components/docs/DocsSidebar.tsx +40 -3
  354. package/website/components/docs/MarkdownContent.tsx +265 -47
  355. package/website/components/docs/VersionSelector.tsx +64 -8
  356. package/website/components/examples/ExamplesViewer.tsx +2 -2
  357. package/website/components/layout/Footer.tsx +6 -1
  358. package/website/components/layout/Header.tsx +44 -42
  359. package/website/components/schema/SchemaComponentsAccordion.tsx +84 -0
  360. package/website/components/schema/SchemaExplorer.tsx +4 -4
  361. package/website/components/ui/Badge.tsx +82 -0
  362. package/website/components/ui/Button.tsx +116 -0
  363. package/website/components/ui/Card.tsx +167 -0
  364. package/website/components/ui/Checkbox.tsx +141 -0
  365. package/website/components/ui/Input.tsx +169 -0
  366. package/website/components/ui/Radio.tsx +141 -0
  367. package/website/components/ui/Select.tsx +182 -0
  368. package/website/components/ui/Tag.tsx +158 -0
  369. package/website/components/ui/Textarea.tsx +195 -0
  370. package/website/components/ui/index.ts +11 -0
  371. package/website/content/blog/OpenAPI-AI-Agents-Standard.md +276 -276
  372. package/website/content/blog/Why-Formal-Standards-Matter-Now.md +3 -14
  373. package/website/content/blog/gitlab-kubernetes-agent-ecosystem.md +286 -0
  374. package/website/content/blog/introducing-ossa-framework.md +1 -1
  375. package/website/content/blog/ossa-production-results.md +5 -5
  376. package/website/content/blog/welcome-to-ossa.md +2 -2
  377. package/website/content/blog/why-ai-agents-need-open-standard.md +5 -5
  378. package/website/content/docs/{00-HOME.md → 00-home.md} +18 -25
  379. package/website/content/docs/adapters/openai-adapter.md +693 -0
  380. package/website/content/docs/agents/catalog.md +28 -0
  381. package/website/content/docs/aiflow-framework-integration-with-ossa.md +107 -0
  382. package/website/content/docs/api-reference/index.md +38 -0
  383. package/website/content/docs/api-reference/ossa-core-api.md +634 -0
  384. package/website/content/docs/api-reference/ossa-registry-api.md +515 -0
  385. package/website/content/docs/api-reference/unified-agent-gateway.md +599 -0
  386. package/website/content/docs/architecture/execution-flow.md +3 -3
  387. package/website/content/docs/architecture/multi-agent-systems.md +4 -4
  388. package/website/content/docs/architecture/overview.md +4 -4
  389. package/website/content/docs/architecture/stack-integration.md +4 -4
  390. package/website/content/docs/changelog.md +4 -4
  391. package/website/content/docs/cli-reference/index.md +111 -0
  392. package/website/content/docs/cli-reference/ossa-agents.md +70 -0
  393. package/website/content/docs/cli-reference/ossa-export.md +56 -0
  394. package/website/content/docs/cli-reference/ossa-generate.md +66 -0
  395. package/website/content/docs/cli-reference/ossa-gitlab-agent.md +57 -0
  396. package/website/content/docs/cli-reference/ossa-import.md +56 -0
  397. package/website/content/docs/cli-reference/ossa-init.md +57 -0
  398. package/website/content/docs/cli-reference/ossa-migrate.md +62 -0
  399. package/website/content/docs/cli-reference/ossa-run.md +66 -0
  400. package/website/content/docs/cli-reference/ossa-schema.md +57 -0
  401. package/website/content/docs/cli-reference/ossa-setup.md +57 -0
  402. package/website/content/docs/cli-reference/ossa-validate.md +66 -0
  403. package/website/content/docs/configuration/index.md +97 -0
  404. package/website/content/docs/contributing.md +2 -2
  405. package/website/content/docs/deployment/github-mirroring.md +924 -0
  406. package/website/content/docs/documentation.md +100 -0
  407. package/website/content/docs/ecosystem/framework-support.md +551 -11
  408. package/website/content/docs/errors/index.md +10 -0
  409. package/website/content/docs/{AIFlow-Framework-Integration-with-OSSA.md → examples/aiflow-framework-integration-with-ossa.md} +2 -2
  410. package/website/content/docs/examples/catalog.md +300 -0
  411. package/website/content/docs/for-audiences/{Students-Researchers.md → students-researchers.md} +1 -1
  412. package/website/content/docs/getting-started/index.md +92 -0
  413. package/website/content/docs/getting-started/installation.md +7 -7
  414. package/website/content/docs/getting-started/running-agents.md +215 -13
  415. package/{docs → website/content/docs}/getting-started.md +10 -6
  416. package/website/content/docs/integrations/aiflow.md +2 -2
  417. package/website/content/docs/integrations/drupal.md +2 -2
  418. package/website/content/docs/migration-guides/agent-schema-comparison.md +232 -0
  419. package/website/content/docs/migration-guides/anthropic-mcp-to-ossa.md +5 -5
  420. package/website/content/docs/migration-guides/crewai-to-ossa.md +3 -3
  421. package/website/content/docs/migration-guides/drupal-eca-to-ossa.md +11 -11
  422. package/{docs/migration → website/content/docs/migration-guides}/general-agent-schema.yml +1 -9
  423. package/website/content/docs/migration-guides/index.md +1 -1
  424. package/website/content/docs/migration-guides/langchain-to-ossa.md +17 -17
  425. package/website/content/docs/migration-guides/langflow-to-ossa.md +3 -3
  426. package/website/content/docs/migration-guides/openai-to-ossa.md +10 -10
  427. package/website/content/docs/openapi-extensions/examples.md +9 -9
  428. package/website/content/docs/openapi-extensions/index.md +59 -3
  429. package/website/content/docs/openapi-extensions/operation-extensions.md +61 -2
  430. package/website/content/docs/openapi-extensions/root-extensions.md +49 -3
  431. package/{docs/OSSA-COMPLIANT-BADGE.md → website/content/docs/ossa-compliant-badge.md} +18 -15
  432. package/website/content/docs/pre-release/index.md +10 -10
  433. package/website/content/docs/readme.md +35 -0
  434. package/website/content/docs/releases/v0.2.6.md +99 -0
  435. package/website/content/docs/schema-reference/agent-capabilities.md +50 -0
  436. package/website/content/docs/schema-reference/agent-id.md +52 -0
  437. package/website/content/docs/schema-reference/agent-name.md +50 -0
  438. package/website/content/docs/schema-reference/agent-role.md +54 -0
  439. package/website/content/docs/schema-reference/agent-spec.md +2 -2
  440. package/website/content/docs/schema-reference/agent-version.md +50 -0
  441. package/website/content/docs/schema-reference/autonomy.md +5 -5
  442. package/website/content/docs/schema-reference/constraints.md +5 -5
  443. package/website/content/docs/schema-reference/index.md +26 -157
  444. package/website/content/docs/schema-reference/llm-config.md +1 -1
  445. package/website/content/docs/schema-reference/observability.md +5 -5
  446. package/website/content/docs/schema-reference/ossa-manifest.md +6 -6
  447. package/website/content/docs/schema-reference/taxonomy.md +3 -3
  448. package/website/content/docs/types-reference/index.md +105 -0
  449. package/website/content/docs/use-cases/00-index.md +1 -1
  450. package/{docs/VERSIONING.md → website/content/docs/versioning.md} +9 -5
  451. package/website/dev.sh +53 -0
  452. package/website/docker-compose.dev.yml +36 -0
  453. package/website/lib/version.ts +18 -1
  454. package/website/lib/versions.json +103 -0
  455. package/website/next.config.ts +3 -1
  456. package/website/package-lock.json +552 -18
  457. package/website/package.json +11 -5
  458. package/website/postcss.config.mjs +1 -1
  459. package/website/scripts/fetch-versions.js +166 -0
  460. package/website/scripts/generate-examples-index.js +163 -0
  461. package/website/scripts/merge-docs-to-wiki.ts +207 -0
  462. package/website/scripts/sync-version.js +28 -0
  463. package/website/scripts/sync-wiki.ts +64 -3
  464. package/website/scripts/upload-wiki.ts +199 -0
  465. package/website/styles/_spacing.scss +453 -0
  466. package/website/styles/_tokens.scss +245 -0
  467. package/website/styles/_typography.scss +361 -0
  468. package/website/styles/_variables.scss +287 -0
  469. package/website/tailwind.config.ts +127 -22
  470. package/.releaserc.json.disabled +0 -81
  471. package/dist/spec/v0.2.5-dev/CHANGELOG.md +0 -171
  472. package/dist/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +0 -362
  473. package/dist/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +0 -464
  474. package/dist/spec/v0.2.5-dev/examples/research-team.ossa.yaml +0 -440
  475. package/dist/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +0 -317
  476. package/dist/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +0 -409
  477. package/docs/README.md +0 -31
  478. package/docs/agent-openapi-spec.yml +0 -942
  479. package/docs/openapi-extensions.md +0 -930
  480. package/docs/schemas/openapi-extensions.schema.json +0 -486
  481. package/openapi/gitlab-orchestrator.openapi.yaml +0 -330
  482. package/ossa-website-swarm-tasks.json +0 -105
  483. package/spec/v0.2.5-dev/CHANGELOG.md +0 -171
  484. package/spec/v0.2.5-dev/examples/customer-support-graph.ossa.yaml +0 -362
  485. package/spec/v0.2.5-dev/examples/parallel-processors.ossa.yaml +0 -464
  486. package/spec/v0.2.5-dev/examples/research-team.ossa.yaml +0 -440
  487. package/spec/v0.2.5-dev/migrations/v0.2.4-to-v0.2.5.md +0 -317
  488. package/spec/v0.2.5-dev/ossa-0.2.5-dev.yaml +0 -409
  489. package/website/app/api/validate/route.ts +0 -88
  490. package/website/app/globals.css +0 -108
  491. package/website/content/docs/OpenAPI-Extensions.md +0 -498
  492. package/website/content/docs/core-concepts/project-structure.md +0 -348
  493. package/website/content/docs/examples/Migration-Guides.md +0 -214
  494. package/website/content/docs/examples.md +0 -71
  495. package/website/content/docs/for-audiences/Enterprises.md +0 -256
  496. package/website/content/docs/for-audiences/architects.md +0 -224
  497. package/website/content/docs/for-audiences/developers.md +0 -220
  498. package/website/content/docs/getting-started/5-minute-overview.md +0 -85
  499. package/website/content/docs/getting-started/Hello-World.md +0 -184
  500. package/website/content/docs/getting-started/first-agent.md +0 -196
  501. package/website/content/docs/migration-guides/00-index.md +0 -76
  502. package/website/content/docs/migration-guides/README.md +0 -133
  503. package/website/next.config.js +0 -17
  504. package/website/postcss.config.js +0 -7
  505. package/website/tailwind.config.js +0 -58
  506. /package/dist/spec/{v0.2.4-dev/ossa-0.2.4-dev.schema.json → v0.2.4/ossa-0.2.4.schema.json} +0 -0
  507. /package/openapi/{ossa-registry-api.openapi.yaml → core/ossa-registry-api.openapi.yaml} +0 -0
  508. /package/openapi/{drupal-agent-api.openapi.yaml → reference-implementations/drupal-agent-api.openapi.yaml} +0 -0
  509. /package/openapi/{helm-generator.openapi.yaml → reference-implementations/helm-generator.openapi.yaml} +0 -0
  510. /package/spec/{v0.2.4-dev/ossa-0.2.4-dev.schema.json → v0.2.4/ossa-0.2.4.schema.json} +0 -0
  511. /package/{docs/migration → website/content/docs/migration-guides}/migration-manifest.json +0 -0
@@ -0,0 +1,141 @@
1
+ 'use client';
2
+
3
+ import React, { InputHTMLAttributes, forwardRef } from 'react';
4
+
5
+ // Simple className merger utility
6
+ function cn(...classes: (string | undefined | null | false)[]): string {
7
+ return classes.filter(Boolean).join(' ');
8
+ }
9
+
10
+ // ============================================================================
11
+ // CHECKBOX COMPONENT
12
+ // ============================================================================
13
+ // Checkbox with label, error states, and accessibility
14
+ // ============================================================================
15
+
16
+ export interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
17
+ label?: string;
18
+ error?: string;
19
+ helperText?: string;
20
+ }
21
+
22
+ const Checkbox = forwardRef<HTMLInputElement, CheckboxProps>(
23
+ (
24
+ {
25
+ className,
26
+ label,
27
+ error,
28
+ helperText,
29
+ id,
30
+ disabled,
31
+ ...props
32
+ },
33
+ ref
34
+ ) => {
35
+ // Generate ID if not provided
36
+ const checkboxId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
37
+ const errorId = `${checkboxId}-error`;
38
+ const helperId = `${checkboxId}-helper`;
39
+
40
+ // Base checkbox styles
41
+ const baseStyles = [
42
+ 'w-5',
43
+ 'h-5',
44
+ 'rounded',
45
+ 'border-2',
46
+ 'transition-all',
47
+ 'duration-200',
48
+ 'cursor-pointer',
49
+ 'focus:outline-none',
50
+ 'focus:ring-2',
51
+ 'focus:ring-offset-2',
52
+ 'disabled:opacity-50',
53
+ 'disabled:cursor-not-allowed',
54
+ ];
55
+
56
+ // State-based styles
57
+ const stateStyles = error
58
+ ? [
59
+ 'border-error-500',
60
+ 'text-error-600',
61
+ 'focus:ring-error-500',
62
+ ]
63
+ : [
64
+ 'border-gray-300',
65
+ 'text-primary-600',
66
+ 'focus:ring-primary-500',
67
+ 'checked:bg-primary-600',
68
+ 'checked:border-primary-600',
69
+ ];
70
+
71
+ return (
72
+ <div>
73
+ <div className="flex items-start gap-3">
74
+ {/* Checkbox */}
75
+ <input
76
+ ref={ref}
77
+ type="checkbox"
78
+ id={checkboxId}
79
+ className={cn(
80
+ ...baseStyles,
81
+ ...stateStyles,
82
+ className
83
+ )}
84
+ disabled={disabled}
85
+ aria-invalid={error ? 'true' : 'false'}
86
+ aria-describedby={cn(
87
+ error ? errorId : undefined,
88
+ helperText ? helperId : undefined
89
+ )}
90
+ {...props}
91
+ />
92
+
93
+ {/* Label and helper text */}
94
+ {(label || helperText) && (
95
+ <div className="flex-1">
96
+ {label && (
97
+ <label
98
+ htmlFor={checkboxId}
99
+ className={cn(
100
+ 'block',
101
+ 'text-sm',
102
+ 'font-medium',
103
+ 'cursor-pointer',
104
+ error ? 'text-error-700' : 'text-gray-700',
105
+ disabled && 'opacity-50 cursor-not-allowed'
106
+ )}
107
+ >
108
+ {label}
109
+ </label>
110
+ )}
111
+
112
+ {helperText && !error && (
113
+ <p
114
+ id={helperId}
115
+ className="mt-0.5 text-sm text-gray-500"
116
+ >
117
+ {helperText}
118
+ </p>
119
+ )}
120
+ </div>
121
+ )}
122
+ </div>
123
+
124
+ {/* Error message */}
125
+ {error && (
126
+ <p
127
+ id={errorId}
128
+ className="mt-1 ml-8 text-sm text-error-600"
129
+ role="alert"
130
+ >
131
+ {error}
132
+ </p>
133
+ )}
134
+ </div>
135
+ );
136
+ }
137
+ );
138
+
139
+ Checkbox.displayName = 'Checkbox';
140
+
141
+ export { Checkbox };
@@ -0,0 +1,169 @@
1
+ 'use client';
2
+
3
+ import React, { InputHTMLAttributes, forwardRef } from 'react';
4
+
5
+ // Simple className merger utility
6
+ function cn(...classes: (string | undefined | null | false)[]): string {
7
+ return classes.filter(Boolean).join(' ');
8
+ }
9
+
10
+ // ============================================================================
11
+ // INPUT COMPONENT
12
+ // ============================================================================
13
+ // Form input with label, error states, helper text, and accessibility
14
+ // ============================================================================
15
+
16
+ export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
17
+ label?: string;
18
+ error?: string;
19
+ helperText?: string;
20
+ leftIcon?: React.ReactNode;
21
+ rightIcon?: React.ReactNode;
22
+ fullWidth?: boolean;
23
+ }
24
+
25
+ const Input = forwardRef<HTMLInputElement, InputProps>(
26
+ (
27
+ {
28
+ className,
29
+ label,
30
+ error,
31
+ helperText,
32
+ leftIcon,
33
+ rightIcon,
34
+ fullWidth = false,
35
+ id,
36
+ disabled,
37
+ required,
38
+ ...props
39
+ },
40
+ ref
41
+ ) => {
42
+ // Generate ID if not provided
43
+ const inputId = id || `input-${Math.random().toString(36).substr(2, 9)}`;
44
+ const errorId = `${inputId}-error`;
45
+ const helperId = `${inputId}-helper`;
46
+
47
+ // Base input styles
48
+ const baseStyles = [
49
+ 'block',
50
+ 'w-full',
51
+ 'rounded-lg',
52
+ 'border',
53
+ 'px-4',
54
+ 'py-2',
55
+ 'text-base',
56
+ 'transition-colors',
57
+ 'duration-200',
58
+ 'focus:outline-none',
59
+ 'focus:ring-2',
60
+ 'focus:ring-offset-1',
61
+ 'disabled:opacity-50',
62
+ 'disabled:cursor-not-allowed',
63
+ 'disabled:bg-gray-100',
64
+ ];
65
+
66
+ // State-based styles
67
+ const stateStyles = error
68
+ ? [
69
+ 'border-error-500',
70
+ 'text-error-900',
71
+ 'focus:border-error-500',
72
+ 'focus:ring-error-500',
73
+ ]
74
+ : [
75
+ 'border-gray-300',
76
+ 'text-gray-900',
77
+ 'focus:border-primary-500',
78
+ 'focus:ring-primary-500',
79
+ ];
80
+
81
+ // Icon padding adjustments
82
+ const iconPaddingStyles = [];
83
+ if (leftIcon) iconPaddingStyles.push('pl-10');
84
+ if (rightIcon) iconPaddingStyles.push('pr-10');
85
+
86
+ return (
87
+ <div className={cn(fullWidth ? 'w-full' : 'w-auto')}>
88
+ {/* Label */}
89
+ {label && (
90
+ <label
91
+ htmlFor={inputId}
92
+ className={cn(
93
+ 'block',
94
+ 'text-sm',
95
+ 'font-medium',
96
+ 'mb-1',
97
+ error ? 'text-error-700' : 'text-gray-700'
98
+ )}
99
+ >
100
+ {label}
101
+ {required && <span className="text-error-500 ml-1">*</span>}
102
+ </label>
103
+ )}
104
+
105
+ {/* Input wrapper */}
106
+ <div className="relative">
107
+ {/* Left icon */}
108
+ {leftIcon && (
109
+ <div className="absolute left-3 top-1/2 -translate-y-1/2 text-gray-400">
110
+ {leftIcon}
111
+ </div>
112
+ )}
113
+
114
+ {/* Input */}
115
+ <input
116
+ ref={ref}
117
+ id={inputId}
118
+ className={cn(
119
+ ...baseStyles,
120
+ ...stateStyles,
121
+ ...iconPaddingStyles,
122
+ className
123
+ )}
124
+ disabled={disabled}
125
+ required={required}
126
+ aria-invalid={error ? 'true' : 'false'}
127
+ aria-describedby={cn(
128
+ error ? errorId : undefined,
129
+ helperText ? helperId : undefined
130
+ )}
131
+ {...props}
132
+ />
133
+
134
+ {/* Right icon */}
135
+ {rightIcon && (
136
+ <div className="absolute right-3 top-1/2 -translate-y-1/2 text-gray-400">
137
+ {rightIcon}
138
+ </div>
139
+ )}
140
+ </div>
141
+
142
+ {/* Error message */}
143
+ {error && (
144
+ <p
145
+ id={errorId}
146
+ className="mt-1 text-sm text-error-600"
147
+ role="alert"
148
+ >
149
+ {error}
150
+ </p>
151
+ )}
152
+
153
+ {/* Helper text */}
154
+ {helperText && !error && (
155
+ <p
156
+ id={helperId}
157
+ className="mt-1 text-sm text-gray-500"
158
+ >
159
+ {helperText}
160
+ </p>
161
+ )}
162
+ </div>
163
+ );
164
+ }
165
+ );
166
+
167
+ Input.displayName = 'Input';
168
+
169
+ export { Input };
@@ -0,0 +1,141 @@
1
+ 'use client';
2
+
3
+ import React, { InputHTMLAttributes, forwardRef } from 'react';
4
+
5
+ // Simple className merger utility
6
+ function cn(...classes: (string | undefined | null | false)[]): string {
7
+ return classes.filter(Boolean).join(' ');
8
+ }
9
+
10
+ // ============================================================================
11
+ // RADIO COMPONENT
12
+ // ============================================================================
13
+ // Radio button with label, error states, and accessibility
14
+ // ============================================================================
15
+
16
+ export interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
17
+ label?: string;
18
+ error?: string;
19
+ helperText?: string;
20
+ }
21
+
22
+ const Radio = forwardRef<HTMLInputElement, RadioProps>(
23
+ (
24
+ {
25
+ className,
26
+ label,
27
+ error,
28
+ helperText,
29
+ id,
30
+ disabled,
31
+ ...props
32
+ },
33
+ ref
34
+ ) => {
35
+ // Generate ID if not provided
36
+ const radioId = id || `radio-${Math.random().toString(36).substr(2, 9)}`;
37
+ const errorId = `${radioId}-error`;
38
+ const helperId = `${radioId}-helper`;
39
+
40
+ // Base radio styles
41
+ const baseStyles = [
42
+ 'w-5',
43
+ 'h-5',
44
+ 'rounded-full',
45
+ 'border-2',
46
+ 'transition-all',
47
+ 'duration-200',
48
+ 'cursor-pointer',
49
+ 'focus:outline-none',
50
+ 'focus:ring-2',
51
+ 'focus:ring-offset-2',
52
+ 'disabled:opacity-50',
53
+ 'disabled:cursor-not-allowed',
54
+ ];
55
+
56
+ // State-based styles
57
+ const stateStyles = error
58
+ ? [
59
+ 'border-error-500',
60
+ 'text-error-600',
61
+ 'focus:ring-error-500',
62
+ ]
63
+ : [
64
+ 'border-gray-300',
65
+ 'text-primary-600',
66
+ 'focus:ring-primary-500',
67
+ 'checked:bg-primary-600',
68
+ 'checked:border-primary-600',
69
+ ];
70
+
71
+ return (
72
+ <div>
73
+ <div className="flex items-start gap-3">
74
+ {/* Radio */}
75
+ <input
76
+ ref={ref}
77
+ type="radio"
78
+ id={radioId}
79
+ className={cn(
80
+ ...baseStyles,
81
+ ...stateStyles,
82
+ className
83
+ )}
84
+ disabled={disabled}
85
+ aria-invalid={error ? 'true' : 'false'}
86
+ aria-describedby={cn(
87
+ error ? errorId : undefined,
88
+ helperText ? helperId : undefined
89
+ )}
90
+ {...props}
91
+ />
92
+
93
+ {/* Label and helper text */}
94
+ {(label || helperText) && (
95
+ <div className="flex-1">
96
+ {label && (
97
+ <label
98
+ htmlFor={radioId}
99
+ className={cn(
100
+ 'block',
101
+ 'text-sm',
102
+ 'font-medium',
103
+ 'cursor-pointer',
104
+ error ? 'text-error-700' : 'text-gray-700',
105
+ disabled && 'opacity-50 cursor-not-allowed'
106
+ )}
107
+ >
108
+ {label}
109
+ </label>
110
+ )}
111
+
112
+ {helperText && !error && (
113
+ <p
114
+ id={helperId}
115
+ className="mt-0.5 text-sm text-gray-500"
116
+ >
117
+ {helperText}
118
+ </p>
119
+ )}
120
+ </div>
121
+ )}
122
+ </div>
123
+
124
+ {/* Error message */}
125
+ {error && (
126
+ <p
127
+ id={errorId}
128
+ className="mt-1 ml-8 text-sm text-error-600"
129
+ role="alert"
130
+ >
131
+ {error}
132
+ </p>
133
+ )}
134
+ </div>
135
+ );
136
+ }
137
+ );
138
+
139
+ Radio.displayName = 'Radio';
140
+
141
+ export { Radio };
@@ -0,0 +1,182 @@
1
+ 'use client';
2
+
3
+ import React, { SelectHTMLAttributes, forwardRef } from 'react';
4
+
5
+ // Simple className merger utility
6
+ function cn(...classes: (string | undefined | null | false)[]): string {
7
+ return classes.filter(Boolean).join(' ');
8
+ }
9
+
10
+ // ============================================================================
11
+ // SELECT COMPONENT
12
+ // ============================================================================
13
+ // Form select with label, error states, and accessibility
14
+ // ============================================================================
15
+
16
+ export interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
17
+ label?: string;
18
+ error?: string;
19
+ helperText?: string;
20
+ fullWidth?: boolean;
21
+ options?: Array<{ value: string; label: string; disabled?: boolean }>;
22
+ }
23
+
24
+ const Select = forwardRef<HTMLSelectElement, SelectProps>(
25
+ (
26
+ {
27
+ className,
28
+ label,
29
+ error,
30
+ helperText,
31
+ fullWidth = false,
32
+ options,
33
+ id,
34
+ disabled,
35
+ required,
36
+ children,
37
+ ...props
38
+ },
39
+ ref
40
+ ) => {
41
+ // Generate ID if not provided
42
+ const selectId = id || `select-${Math.random().toString(36).substr(2, 9)}`;
43
+ const errorId = `${selectId}-error`;
44
+ const helperId = `${selectId}-helper`;
45
+
46
+ // Base select styles
47
+ const baseStyles = [
48
+ 'block',
49
+ 'w-full',
50
+ 'rounded-lg',
51
+ 'border',
52
+ 'px-4',
53
+ 'py-2',
54
+ 'pr-10',
55
+ 'text-base',
56
+ 'transition-colors',
57
+ 'duration-200',
58
+ 'focus:outline-none',
59
+ 'focus:ring-2',
60
+ 'focus:ring-offset-1',
61
+ 'disabled:opacity-50',
62
+ 'disabled:cursor-not-allowed',
63
+ 'disabled:bg-gray-100',
64
+ 'appearance-none',
65
+ 'bg-white',
66
+ 'cursor-pointer',
67
+ ];
68
+
69
+ // State-based styles
70
+ const stateStyles = error
71
+ ? [
72
+ 'border-error-500',
73
+ 'text-error-900',
74
+ 'focus:border-error-500',
75
+ 'focus:ring-error-500',
76
+ ]
77
+ : [
78
+ 'border-gray-300',
79
+ 'text-gray-900',
80
+ 'focus:border-primary-500',
81
+ 'focus:ring-primary-500',
82
+ ];
83
+
84
+ return (
85
+ <div className={cn(fullWidth ? 'w-full' : 'w-auto')}>
86
+ {/* Label */}
87
+ {label && (
88
+ <label
89
+ htmlFor={selectId}
90
+ className={cn(
91
+ 'block',
92
+ 'text-sm',
93
+ 'font-medium',
94
+ 'mb-1',
95
+ error ? 'text-error-700' : 'text-gray-700'
96
+ )}
97
+ >
98
+ {label}
99
+ {required && <span className="text-error-500 ml-1">*</span>}
100
+ </label>
101
+ )}
102
+
103
+ {/* Select wrapper */}
104
+ <div className="relative">
105
+ {/* Select */}
106
+ <select
107
+ ref={ref}
108
+ id={selectId}
109
+ className={cn(
110
+ ...baseStyles,
111
+ ...stateStyles,
112
+ className
113
+ )}
114
+ disabled={disabled}
115
+ required={required}
116
+ aria-invalid={error ? 'true' : 'false'}
117
+ aria-describedby={cn(
118
+ error ? errorId : undefined,
119
+ helperText ? helperId : undefined
120
+ )}
121
+ {...props}
122
+ >
123
+ {options
124
+ ? options.map((option) => (
125
+ <option
126
+ key={option.value}
127
+ value={option.value}
128
+ disabled={option.disabled}
129
+ >
130
+ {option.label}
131
+ </option>
132
+ ))
133
+ : children}
134
+ </select>
135
+
136
+ {/* Dropdown icon */}
137
+ <div className="absolute right-3 top-1/2 -translate-y-1/2 pointer-events-none text-gray-400">
138
+ <svg
139
+ className="w-5 h-5"
140
+ fill="none"
141
+ stroke="currentColor"
142
+ viewBox="0 0 24 24"
143
+ aria-hidden="true"
144
+ >
145
+ <path
146
+ strokeLinecap="round"
147
+ strokeLinejoin="round"
148
+ strokeWidth={2}
149
+ d="M19 9l-7 7-7-7"
150
+ />
151
+ </svg>
152
+ </div>
153
+ </div>
154
+
155
+ {/* Error message */}
156
+ {error && (
157
+ <p
158
+ id={errorId}
159
+ className="mt-1 text-sm text-error-600"
160
+ role="alert"
161
+ >
162
+ {error}
163
+ </p>
164
+ )}
165
+
166
+ {/* Helper text */}
167
+ {helperText && !error && (
168
+ <p
169
+ id={helperId}
170
+ className="mt-1 text-sm text-gray-500"
171
+ >
172
+ {helperText}
173
+ </p>
174
+ )}
175
+ </div>
176
+ );
177
+ }
178
+ );
179
+
180
+ Select.displayName = 'Select';
181
+
182
+ export { Select };