codeply-cli 0.5.6 → 0.6.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 (429) hide show
  1. package/LICENSE +21 -21
  2. package/THIRD_PARTY_NOTICES.md +65 -65
  3. package/bin/codeply.js +8 -3
  4. package/lib/agent.mjs +2596 -2268
  5. package/lib/ai.js +135 -27
  6. package/lib/ai.mjs +6 -6
  7. package/lib/apply-patch.js +217 -217
  8. package/lib/arity-table.json +138 -138
  9. package/lib/arity.js +70 -70
  10. package/lib/auth.mjs +6 -6
  11. package/lib/autopilot.js +84 -0
  12. package/lib/bot-mail.js +46 -0
  13. package/lib/bots.js +142 -15
  14. package/lib/brain.js +914 -0
  15. package/lib/call-assist.js +120 -0
  16. package/lib/chatgpt.js +282 -282
  17. package/lib/cloud-browser.mjs +143 -143
  18. package/lib/cloud.mjs +1396 -1320
  19. package/lib/commands.js +103 -103
  20. package/lib/computer.js +136 -0
  21. package/lib/design-library/assemble-artifact.mjs +21 -21
  22. package/lib/design-library/cleanup.mjs +45 -45
  23. package/lib/design-library/index.json +22379 -22379
  24. package/lib/design-library/make-table-data.mjs +39 -39
  25. package/lib/design-tools.mjs +173 -0
  26. package/lib/diagnostics.js +192 -192
  27. package/lib/dsh-acp.mjs +444 -0
  28. package/lib/edit-engine.js +364 -364
  29. package/lib/github-agent.mjs +326 -326
  30. package/lib/handoff.mjs +245 -0
  31. package/lib/history.js +78 -75
  32. package/lib/life-sources.js +319 -0
  33. package/lib/life-store.js +356 -0
  34. package/lib/life-triggers.js +286 -0
  35. package/lib/life.js +487 -0
  36. package/lib/mail-watch.js +3 -3
  37. package/lib/mcp.js +258 -258
  38. package/lib/native-tools.mjs +17 -5
  39. package/lib/oauth-connectors.js +76 -21
  40. package/lib/permissions.js +109 -109
  41. package/lib/plugins.js +356 -353
  42. package/lib/reach.js +67 -67
  43. package/lib/render-md.mjs +647 -617
  44. package/lib/screen.js +77 -0
  45. package/lib/server.mjs +458 -457
  46. package/lib/session-db.js +220 -220
  47. package/lib/share.js +208 -168
  48. package/lib/skills.js +4 -1
  49. package/lib/snapshot.js +146 -146
  50. package/lib/subagents.js +4 -2
  51. package/lib/telemetry.js +105 -105
  52. package/lib/terminal-hints.js +154 -154
  53. package/lib/textarea.mjs +264 -258
  54. package/lib/tools.mjs +326 -40
  55. package/lib/tui.mjs +1459 -1086
  56. package/lib/typecheck-worker.js +147 -147
  57. package/lib/web-tools.js +209 -209
  58. package/package.json +1 -1
  59. package/skills/SOURCE.md +58 -58
  60. package/skills/accessibility/SKILL.md +147 -147
  61. package/skills/agent-architecture-audit/SKILL.md +257 -257
  62. package/skills/agent-eval/SKILL.md +147 -147
  63. package/skills/agent-harness-construction/SKILL.md +74 -74
  64. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  65. package/skills/agent-payment-x402/SKILL.md +225 -225
  66. package/skills/agent-self-evaluation/SKILL.md +182 -182
  67. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  68. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  69. package/skills/agent-sort/SKILL.md +216 -216
  70. package/skills/agentic-engineering/SKILL.md +64 -64
  71. package/skills/agentic-os/SKILL.md +388 -388
  72. package/skills/ai-first-engineering/SKILL.md +52 -52
  73. package/skills/ai-regression-testing/SKILL.md +386 -386
  74. package/skills/android-clean-architecture/SKILL.md +340 -340
  75. package/skills/angular-developer/SKILL.md +155 -155
  76. package/skills/angular-developer/references/angular-animations.md +160 -160
  77. package/skills/angular-developer/references/angular-aria.md +410 -410
  78. package/skills/angular-developer/references/cli.md +86 -86
  79. package/skills/angular-developer/references/component-harnesses.md +59 -59
  80. package/skills/angular-developer/references/component-styling.md +91 -91
  81. package/skills/angular-developer/references/components.md +117 -117
  82. package/skills/angular-developer/references/creating-services.md +97 -97
  83. package/skills/angular-developer/references/data-resolvers.md +69 -69
  84. package/skills/angular-developer/references/define-routes.md +67 -67
  85. package/skills/angular-developer/references/defining-providers.md +72 -72
  86. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  87. package/skills/angular-developer/references/e2e-testing.md +56 -56
  88. package/skills/angular-developer/references/effects.md +83 -83
  89. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  90. package/skills/angular-developer/references/host-elements.md +80 -80
  91. package/skills/angular-developer/references/injection-context.md +63 -63
  92. package/skills/angular-developer/references/inputs.md +101 -101
  93. package/skills/angular-developer/references/linked-signal.md +59 -59
  94. package/skills/angular-developer/references/loading-strategies.md +61 -61
  95. package/skills/angular-developer/references/mcp.md +108 -108
  96. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  97. package/skills/angular-developer/references/outputs.md +86 -86
  98. package/skills/angular-developer/references/reactive-forms.md +122 -122
  99. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  100. package/skills/angular-developer/references/resource.md +77 -77
  101. package/skills/angular-developer/references/route-animations.md +56 -56
  102. package/skills/angular-developer/references/route-guards.md +52 -52
  103. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  104. package/skills/angular-developer/references/router-testing.md +87 -87
  105. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  106. package/skills/angular-developer/references/signal-forms.md +795 -795
  107. package/skills/angular-developer/references/signals-overview.md +94 -94
  108. package/skills/angular-developer/references/tailwind-css.md +69 -69
  109. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  110. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  111. package/skills/api-connector-builder/SKILL.md +121 -121
  112. package/skills/api-design/SKILL.md +524 -524
  113. package/skills/architecture-decision-records/SKILL.md +180 -180
  114. package/skills/article-writing/SKILL.md +80 -80
  115. package/skills/automation-audit-ops/SKILL.md +143 -143
  116. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  117. package/skills/autonomous-loops/SKILL.md +611 -611
  118. package/skills/backend-patterns/SKILL.md +562 -562
  119. package/skills/benchmark/SKILL.md +95 -95
  120. package/skills/benchmark-methodology/SKILL.md +191 -191
  121. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  122. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  123. package/skills/blueprint/SKILL.md +106 -106
  124. package/skills/brand-discovery/SKILL.md +145 -145
  125. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  126. package/skills/brand-discovery/references/20_positioning.md +44 -44
  127. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  128. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  129. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  130. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  131. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  132. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  133. package/skills/brand-voice/SKILL.md +98 -98
  134. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  135. package/skills/browser-qa/SKILL.md +105 -105
  136. package/skills/bun-runtime/SKILL.md +85 -85
  137. package/skills/canary-watch/SKILL.md +108 -108
  138. package/skills/carrier-relationship-management/SKILL.md +212 -212
  139. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  140. package/skills/ck/SKILL.md +148 -148
  141. package/skills/claude-devfleet/SKILL.md +112 -112
  142. package/skills/click-path-audit/SKILL.md +245 -245
  143. package/skills/clickhouse-io/SKILL.md +445 -445
  144. package/skills/code-tour/SKILL.md +254 -254
  145. package/skills/codebase-onboarding/SKILL.md +234 -234
  146. package/skills/codehealth-mcp/SKILL.md +167 -167
  147. package/skills/codeply-taste/LICENSE +21 -0
  148. package/skills/codeply-taste/SKILL.md +100 -0
  149. package/skills/codeply-taste/SOURCE.md +10 -0
  150. package/skills/codeply-taste/assets/base.css +100 -0
  151. package/skills/codeply-taste/assets/base.js +37 -0
  152. package/skills/codeply-taste/library/directions.json +1078 -0
  153. package/skills/codeply-taste/library/heroes.json +894 -0
  154. package/skills/codeply-taste/library/motions.json +57 -0
  155. package/skills/codeply-taste/library/palettes.json +1485 -0
  156. package/skills/codeply-taste/library/photos.json +7240 -0
  157. package/skills/codeply-taste/library/sections.json +4136 -0
  158. package/skills/codeply-taste/library/sites.json +7274 -0
  159. package/skills/codeply-taste/library/type.json +2024 -0
  160. package/skills/codeply-taste/references/colour.md +141 -0
  161. package/skills/codeply-taste/references/copy.md +177 -0
  162. package/skills/codeply-taste/references/critique.md +171 -0
  163. package/skills/codeply-taste/references/imagery.md +377 -0
  164. package/skills/codeply-taste/references/layout.md +178 -0
  165. package/skills/codeply-taste/references/motion.md +292 -0
  166. package/skills/codeply-taste/references/research.md +306 -0
  167. package/skills/codeply-taste/references/tells.md +115 -0
  168. package/skills/codeply-taste/references/type.md +170 -0
  169. package/skills/codeply-taste/scripts/assets.mjs +865 -0
  170. package/skills/codeply-taste/scripts/draw.mjs +525 -0
  171. package/skills/codeply-taste/scripts/inspect.mjs +205 -0
  172. package/skills/codeply-taste/scripts/lib/cdp.mjs +205 -0
  173. package/skills/codeply-taste/scripts/lib/probe.mjs +569 -0
  174. package/skills/codeply-taste/scripts/lib/rules.mjs +137 -0
  175. package/skills/codeply-taste/scripts/lint.mjs +108 -0
  176. package/skills/coding-standards/SKILL.md +551 -551
  177. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  178. package/skills/competitive-report-structure/SKILL.md +162 -162
  179. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  180. package/skills/config-gc/SKILL.md +120 -120
  181. package/skills/configure-ecc/SKILL.md +385 -385
  182. package/skills/connections-optimizer/SKILL.md +190 -190
  183. package/skills/content-engine/SKILL.md +132 -132
  184. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  185. package/skills/context-budget/SKILL.md +136 -136
  186. package/skills/continuous-agent-loop/SKILL.md +46 -46
  187. package/skills/continuous-learning/SKILL.md +132 -132
  188. package/skills/continuous-learning-v2/SKILL.md +361 -361
  189. package/skills/contract-first/SKILL.md +287 -287
  190. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  191. package/skills/cost-tracking/SKILL.md +97 -97
  192. package/skills/council/SKILL.md +204 -204
  193. package/skills/cpp-coding-standards/SKILL.md +724 -724
  194. package/skills/cpp-testing/SKILL.md +325 -325
  195. package/skills/crosspost/SKILL.md +112 -112
  196. package/skills/csharp-testing/SKILL.md +322 -322
  197. package/skills/customer-billing-ops/SKILL.md +141 -141
  198. package/skills/customs-trade-compliance/SKILL.md +263 -263
  199. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  200. package/skills/dashboard-builder/SKILL.md +109 -109
  201. package/skills/data-scraper-agent/SKILL.md +765 -765
  202. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  203. package/skills/database-migrations/SKILL.md +430 -430
  204. package/skills/deep-research/SKILL.md +160 -160
  205. package/skills/defi-amm-security/SKILL.md +167 -167
  206. package/skills/delivery-gate/SKILL.md +126 -126
  207. package/skills/deployment-patterns/SKILL.md +428 -428
  208. package/skills/design-system/SKILL.md +83 -83
  209. package/skills/django-celery/SKILL.md +458 -458
  210. package/skills/django-patterns/SKILL.md +735 -735
  211. package/skills/django-security/SKILL.md +644 -644
  212. package/skills/django-tdd/SKILL.md +730 -730
  213. package/skills/django-verification/SKILL.md +470 -470
  214. package/skills/dmux-workflows/SKILL.md +192 -192
  215. package/skills/docker-patterns/SKILL.md +365 -365
  216. package/skills/documentation-lookup/SKILL.md +91 -91
  217. package/skills/dotnet-patterns/SKILL.md +322 -322
  218. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  219. package/skills/e2e-testing/SKILL.md +327 -327
  220. package/skills/ecc-guide/SKILL.md +190 -190
  221. package/skills/ecc-recipes/SKILL.md +149 -149
  222. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  223. package/skills/email-ops/SKILL.md +122 -122
  224. package/skills/energy-procurement/SKILL.md +228 -228
  225. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  226. package/skills/error-handling/SKILL.md +377 -377
  227. package/skills/eval-harness/SKILL.md +271 -271
  228. package/skills/evm-token-decimals/SKILL.md +131 -131
  229. package/skills/exa-search/SKILL.md +108 -108
  230. package/skills/fal-ai-media/SKILL.md +289 -289
  231. package/skills/fastapi-patterns/SKILL.md +514 -514
  232. package/skills/finance-billing-ops/SKILL.md +128 -128
  233. package/skills/flox-environments/SKILL.md +497 -497
  234. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  235. package/skills/foundation-models-on-device/SKILL.md +243 -243
  236. package/skills/frontend-a11y/SKILL.md +446 -446
  237. package/skills/frontend-design-direction/SKILL.md +93 -93
  238. package/skills/frontend-patterns/SKILL.md +657 -657
  239. package/skills/frontend-slides/SKILL.md +185 -185
  240. package/skills/fsharp-testing/SKILL.md +281 -281
  241. package/skills/gan-style-harness/SKILL.md +279 -279
  242. package/skills/gateguard/SKILL.md +133 -133
  243. package/skills/generating-python-installer/SKILL.md +820 -820
  244. package/skills/git-workflow/SKILL.md +716 -716
  245. package/skills/github-ops/SKILL.md +145 -145
  246. package/skills/golang-patterns/SKILL.md +676 -676
  247. package/skills/golang-testing/SKILL.md +721 -721
  248. package/skills/google-workspace-ops/SKILL.md +96 -96
  249. package/skills/growth-log/SKILL.md +128 -128
  250. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  251. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  252. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  253. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  254. package/skills/hermes-imports/SKILL.md +89 -89
  255. package/skills/hexagonal-architecture/SKILL.md +277 -277
  256. package/skills/hipaa-compliance/SKILL.md +79 -79
  257. package/skills/homelab-network-readiness/SKILL.md +170 -170
  258. package/skills/homelab-network-setup/SKILL.md +130 -130
  259. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  260. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  261. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  262. package/skills/hookify-rules/SKILL.md +128 -128
  263. package/skills/inherit-legacy-style/SKILL.md +157 -157
  264. package/skills/intent-driven-development/SKILL.md +360 -360
  265. package/skills/inventory-demand-planning/SKILL.md +247 -247
  266. package/skills/investor-materials/SKILL.md +97 -97
  267. package/skills/investor-outreach/SKILL.md +92 -92
  268. package/skills/ios-icon-gen/SKILL.md +158 -158
  269. package/skills/iterative-retrieval/SKILL.md +212 -212
  270. package/skills/ito-basket-compare/SKILL.md +64 -64
  271. package/skills/ito-compute/SKILL.md +129 -129
  272. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  273. package/skills/ito-market-intelligence/SKILL.md +61 -61
  274. package/skills/ito-trade-planner/SKILL.md +68 -68
  275. package/skills/java-coding-standards/SKILL.md +384 -384
  276. package/skills/jira-integration/SKILL.md +303 -303
  277. package/skills/jpa-patterns/SKILL.md +152 -152
  278. package/skills/knowledge-ops/SKILL.md +155 -155
  279. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  280. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  281. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  282. package/skills/kotlin-patterns/SKILL.md +712 -712
  283. package/skills/kotlin-testing/SKILL.md +825 -825
  284. package/skills/kubernetes-patterns/SKILL.md +756 -756
  285. package/skills/laravel-patterns/SKILL.md +416 -416
  286. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  287. package/skills/laravel-security/SKILL.md +948 -948
  288. package/skills/laravel-tdd/SKILL.md +675 -675
  289. package/skills/laravel-verification/SKILL.md +180 -180
  290. package/skills/latency-critical-systems/SKILL.md +75 -75
  291. package/skills/lead-intelligence/SKILL.md +322 -322
  292. package/skills/liquid-glass-design/SKILL.md +279 -279
  293. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  294. package/skills/logistics-exception-management/SKILL.md +222 -222
  295. package/skills/loop-design-check/SKILL.md +143 -143
  296. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  297. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  298. package/skills/manim-video/SKILL.md +90 -90
  299. package/skills/market-research/SKILL.md +76 -76
  300. package/skills/marketing-campaign/SKILL.md +114 -114
  301. package/skills/mcp-server-patterns/SKILL.md +70 -70
  302. package/skills/messages-ops/SKILL.md +105 -105
  303. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  304. package/skills/mle-workflow/SKILL.md +348 -348
  305. package/skills/motion-advanced/SKILL.md +596 -596
  306. package/skills/motion-foundations/SKILL.md +299 -299
  307. package/skills/motion-patterns/SKILL.md +434 -434
  308. package/skills/motion-ui/SKILL.md +576 -576
  309. package/skills/mysql-patterns/SKILL.md +413 -413
  310. package/skills/nanoclaw-repl/SKILL.md +34 -34
  311. package/skills/nestjs-patterns/SKILL.md +231 -231
  312. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  313. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  314. package/skills/network-config-validation/SKILL.md +211 -211
  315. package/skills/network-interface-health/SKILL.md +153 -153
  316. package/skills/nextjs-turbopack/SKILL.md +58 -58
  317. package/skills/nodejs-keccak256/SKILL.md +103 -103
  318. package/skills/nutrient-document-processing/SKILL.md +168 -168
  319. package/skills/nuxt4-patterns/SKILL.md +101 -101
  320. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  321. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  322. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  323. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  324. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  325. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  326. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  327. package/skills/opensource-pipeline/SKILL.md +256 -256
  328. package/skills/orch-add-feature/SKILL.md +45 -45
  329. package/skills/orch-build-mvp/SKILL.md +49 -49
  330. package/skills/orch-change-feature/SKILL.md +43 -43
  331. package/skills/orch-fix-defect/SKILL.md +43 -43
  332. package/skills/orch-pipeline/SKILL.md +121 -121
  333. package/skills/orch-refine-code/SKILL.md +44 -44
  334. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  335. package/skills/perl-patterns/SKILL.md +505 -505
  336. package/skills/perl-security/SKILL.md +504 -504
  337. package/skills/perl-testing/SKILL.md +476 -476
  338. package/skills/plan-canvas/SKILL.md +153 -153
  339. package/skills/plan-orchestrate/SKILL.md +263 -263
  340. package/skills/plankton-code-quality/SKILL.md +237 -237
  341. package/skills/postgres-patterns/SKILL.md +148 -148
  342. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  343. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  344. package/skills/premium-web-design/SKILL.md +154 -154
  345. package/skills/prisma-patterns/SKILL.md +401 -401
  346. package/skills/product-capability/SKILL.md +142 -142
  347. package/skills/product-lens/SKILL.md +93 -93
  348. package/skills/production-audit/SKILL.md +207 -207
  349. package/skills/production-scheduling/SKILL.md +238 -238
  350. package/skills/project-flow-ops/SKILL.md +112 -112
  351. package/skills/prompt-optimizer/SKILL.md +398 -398
  352. package/skills/python-patterns/SKILL.md +751 -751
  353. package/skills/python-testing/SKILL.md +817 -817
  354. package/skills/pytorch-patterns/SKILL.md +397 -397
  355. package/skills/quality-nonconformance/SKILL.md +260 -260
  356. package/skills/quarkus-patterns/SKILL.md +723 -723
  357. package/skills/quarkus-security/SKILL.md +468 -468
  358. package/skills/quarkus-tdd/SKILL.md +812 -812
  359. package/skills/quarkus-verification/SKILL.md +480 -480
  360. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  361. package/skills/react-native-patterns/SKILL.md +326 -326
  362. package/skills/react-patterns/SKILL.md +342 -342
  363. package/skills/react-performance/SKILL.md +575 -575
  364. package/skills/react-testing/SKILL.md +424 -424
  365. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  366. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  367. package/skills/redis-patterns/SKILL.md +404 -404
  368. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  369. package/skills/remotion-video-creation/SKILL.md +43 -43
  370. package/skills/repo-scan/SKILL.md +79 -79
  371. package/skills/research-ops/SKILL.md +113 -113
  372. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  373. package/skills/rules-distill/SKILL.md +265 -265
  374. package/skills/rust-patterns/SKILL.md +500 -500
  375. package/skills/rust-testing/SKILL.md +501 -501
  376. package/skills/safety-guard/SKILL.md +76 -76
  377. package/skills/santa-method/SKILL.md +307 -307
  378. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  379. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  380. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  381. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  382. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  383. package/skills/search-first/SKILL.md +183 -183
  384. package/skills/security-bounty-hunter/SKILL.md +100 -100
  385. package/skills/security-review/SKILL.md +504 -504
  386. package/skills/security-scan/SKILL.md +166 -166
  387. package/skills/seo/SKILL.md +155 -155
  388. package/skills/skill-comply/SKILL.md +59 -59
  389. package/skills/skill-scout/SKILL.md +141 -141
  390. package/skills/skill-stocktake/SKILL.md +195 -195
  391. package/skills/social-graph-ranker/SKILL.md +155 -155
  392. package/skills/social-publisher/SKILL.md +130 -130
  393. package/skills/springboot-patterns/SKILL.md +315 -315
  394. package/skills/springboot-security/SKILL.md +273 -273
  395. package/skills/springboot-tdd/SKILL.md +159 -159
  396. package/skills/springboot-verification/SKILL.md +232 -232
  397. package/skills/strategic-compact/SKILL.md +142 -142
  398. package/skills/swift-actor-persistence/SKILL.md +144 -144
  399. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  400. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  401. package/skills/swiftui-patterns/SKILL.md +259 -259
  402. package/skills/taste/SKILL.md +264 -264
  403. package/skills/taste/references/genre-taxonomy.md +87 -87
  404. package/skills/tdd-workflow/SKILL.md +583 -583
  405. package/skills/team-agent-orchestration/SKILL.md +111 -111
  406. package/skills/team-builder/SKILL.md +169 -169
  407. package/skills/terminal-ops/SKILL.md +110 -110
  408. package/skills/tinystruct-patterns/SKILL.md +279 -279
  409. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  410. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  411. package/skills/tinystruct-patterns/references/database.md +99 -99
  412. package/skills/tinystruct-patterns/references/routing.md +64 -64
  413. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  414. package/skills/tinystruct-patterns/references/testing.md +72 -72
  415. package/skills/token-budget-advisor/SKILL.md +134 -134
  416. package/skills/ui-demo/SKILL.md +466 -466
  417. package/skills/ui-to-vue/SKILL.md +135 -135
  418. package/skills/uncloud/SKILL.md +344 -344
  419. package/skills/unified-memory/SKILL.md +170 -170
  420. package/skills/unified-notifications-ops/SKILL.md +188 -188
  421. package/skills/verification-loop/SKILL.md +129 -129
  422. package/skills/video-editing/SKILL.md +311 -311
  423. package/skills/videodb/SKILL.md +375 -375
  424. package/skills/visa-doc-translate/SKILL.md +117 -117
  425. package/skills/vite-patterns/SKILL.md +450 -450
  426. package/skills/vue-patterns/SKILL.md +471 -471
  427. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  428. package/skills/workspace-surface-audit/SKILL.md +126 -126
  429. package/skills/x-api/SKILL.md +235 -235
package/lib/render-md.mjs CHANGED
@@ -1,617 +1,647 @@
1
- /**
2
- * Codeply TUI - Markdown renderer for AI responses.
3
- * Parses markdown into Ink-compatible React elements with syntax coloring.
4
- */
5
- import React from 'react';
6
- import { Box, Text } from 'ink';
7
-
8
- const G = {
9
- blue: '#4285F4',
10
- red: '#EA4335',
11
- yellow: '#FBBC05',
12
- green: '#34A853',
13
- };
14
-
15
- // Minimal syntax highlighter for code blocks
16
- function highlightCode(code, lang) {
17
- const lines = code.split('\n');
18
- return lines.map((line) => {
19
- let colored = line;
20
-
21
- // Comments
22
- if (/^\s*\/\//.test(line) || /^\s*#/.test(line) || /^\s*\/\*/.test(line) || /^\s*\*/.test(line) || /^\s*<!--/.test(line)) {
23
- return [{ text: line, color: '#5f6368' }];
24
- }
25
-
26
- // Strings (basic)
27
- const parts = [];
28
- let remaining = line;
29
- // Match strings, keywords, tags, numbers, properties
30
- const regex = /("[^"]*"|'[^']*'|`[^`]*`)|(\b(?:function|const|let|var|if|else|return|for|while|do|switch|case|break|continue|new|this|class|extends|import|export|from|default|async|await|try|catch|throw|typeof|instanceof|in|of|void|delete|null|undefined|true|false)\b)|(<\/?[a-zA-Z][a-zA-Z0-9]*(?:\s[^>]*)?>?)|(\b\d+\.?\d*\b)|(#[0-9a-fA-F]{3,8})|(\b(?:style|color|display|margin|padding|border|background|width|height|font|position|top|left|right|bottom|text|align|overflow|flex|grid|gap|opacity|transform|transition|animation|content|justify|items|center|none|block|inline|relative|absolute|fixed|solid|dashed|hidden|auto|inherit|initial|unset)\b)/g;
31
-
32
- let lastIdx = 0;
33
- let match;
34
- const result = [];
35
-
36
- while ((match = regex.exec(remaining)) !== null) {
37
- // Text before match
38
- if (match.index > lastIdx) {
39
- result.push({ text: remaining.slice(lastIdx, match.index), color: '#e8eaed' });
40
- }
41
-
42
- if (match[1]) {
43
- // String
44
- result.push({ text: match[0], color: '#34A853' });
45
- } else if (match[2]) {
46
- // Keyword
47
- result.push({ text: match[0], color: '#4285F4' });
48
- } else if (match[3]) {
49
- // HTML tag
50
- result.push({ text: match[0], color: '#EA4335' });
51
- } else if (match[4]) {
52
- // Number
53
- result.push({ text: match[0], color: '#FBBC05' });
54
- } else if (match[5]) {
55
- // Hex color
56
- result.push({ text: match[0], color: '#FBBC05' });
57
- } else if (match[6]) {
58
- // CSS property
59
- result.push({ text: match[0], color: '#e8eaed' });
60
- } else {
61
- result.push({ text: match[0], color: '#e8eaed' });
62
- }
63
- lastIdx = match.index + match[0].length;
64
- }
65
-
66
- if (lastIdx < remaining.length) {
67
- result.push({ text: remaining.slice(lastIdx), color: '#e8eaed' });
68
- }
69
-
70
- return result.length ? result : [{ text: line, color: '#e8eaed' }];
71
- });
72
- }
73
-
74
- // Convert hex color to ANSI escape sequence
75
- function hexToAnsi(hex) {
76
- if (!hex) return '';
77
- const h = hex.replace('#', '');
78
- const r = parseInt(h.substring(0, 2), 16);
79
- const g = parseInt(h.substring(2, 4), 16);
80
- const b = parseInt(h.substring(4, 6), 16);
81
- return `\x1b[38;2;${r};${g};${b}m`;
82
- }
83
-
84
- /** Background counterpart of hexToAnsi. */
85
- function hexToAnsiBg(hex) {
86
- if (!hex) return '';
87
- const h = hex.replace('#', '');
88
- const r = parseInt(h.substring(0, 2), 16);
89
- const g = parseInt(h.substring(2, 4), 16);
90
- const b = parseInt(h.substring(4, 6), 16);
91
- return `\x1b[48;2;${r};${g};${b}m`;
92
- }
93
-
94
- const ANSI_RESET = '\x1b[0m';
95
- const ANSI_BOLD = '\x1b[1m';
96
- const ANSI_DIM = '\x1b[2m';
97
- const ANSI_ITALIC = '\x1b[3m';
98
- const ANSI_BG_CODE = '\x1b[48;2;45;46;48m'; // #2d2e30
99
-
100
- // Surface colours for filled blocks. Ink 5's <Box> has no backgroundColor, so
101
- // every filled row is built by hand: set the bg, emit the content, pad out to
102
- // the panel width so the fill reaches the right edge, then reset. Padding has
103
- // to be measured on the *visible* text, which is why widths are tracked
104
- // explicitly rather than using String#padEnd on an ANSI-laden string.
105
- const SURFACE = {
106
- codeHeader: '#20242b',
107
- codeBody: '#15181c',
108
- gutter: '#1b1f24',
109
- plan: '#161b22',
110
- planHeader: '#1d2530',
111
- diffAdd: '#0e2417',
112
- diffDel: '#2a1418',
113
- };
114
-
115
- const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
116
- const visibleLength = (s) => s.replace(ANSI_PATTERN, '').length;
117
-
118
- /**
119
- * Render coloured segments clipped to `width`, returning the ANSI string and
120
- * how many visible columns it used. Clipping happens per segment so a cut never
121
- * lands inside an escape sequence.
122
- */
123
- function clipSegments(segments, width) {
124
- let out = '';
125
- let used = 0;
126
- for (const seg of segments) {
127
- if (used >= width) break;
128
- const room = width - used;
129
- const text = seg.text.length > room ? seg.text.slice(0, room) : seg.text;
130
- if (!text) continue;
131
- out += (seg.color ? hexToAnsi(seg.color) : '') + text;
132
- used += text.length;
133
- }
134
- return { text: out, used };
135
- }
136
-
137
- /** One full-width row of a filled panel. */
138
- function fillRow(content, usedWidth, width, bg) {
139
- const pad = Math.max(0, width - usedWidth);
140
- return hexToAnsiBg(bg) + content + ' '.repeat(pad) + ANSI_RESET;
141
- }
142
-
143
- function InlineText({ segments }) {
144
- // Build a single string with ANSI escape codes for styling.
145
- // This avoids creating multiple <Text> elements which Ink wraps independently.
146
- let flat = '';
147
- for (const seg of segments) {
148
- let prefix = '';
149
- let suffix = '';
150
- if (seg.bold) prefix += ANSI_BOLD;
151
- if (seg.italic) prefix += ANSI_ITALIC;
152
- if (seg.code) {
153
- prefix += hexToAnsi(G.yellow) + ANSI_BG_CODE;
154
- suffix = ANSI_RESET;
155
- flat += prefix + ` ${seg.text} ` + suffix;
156
- } else if (seg.color) {
157
- prefix += hexToAnsi(seg.color);
158
- suffix = ANSI_RESET;
159
- flat += prefix + seg.text + suffix;
160
- } else {
161
- flat += seg.text;
162
- }
163
- }
164
- return React.createElement(Text, { wrap: 'wrap' }, flat);
165
- }
166
-
167
- function parseInline(text) {
168
- const segments = [];
169
- let remaining = text;
170
-
171
- while (remaining.length > 0) {
172
- // Bold: **text** or __text__
173
- let match = remaining.match(/^(.*?)\*\*(.+?)\*\*/s);
174
- if (!match) match = remaining.match(/^(.*?)__(.+?)__/s);
175
- if (match && match[1].length < remaining.length) {
176
- if (match[1]) segments.push({ text: match[1] });
177
- segments.push({ text: match[2], bold: true });
178
- remaining = remaining.slice(match[0].length);
179
- continue;
180
- }
181
-
182
- // Italic: *text* or _text_
183
- match = remaining.match(/^(.*?)\*(.+?)\*/s);
184
- if (!match) match = remaining.match(/^(.*?)_(.+?)_/s);
185
- if (match && match[1].length < remaining.length) {
186
- if (match[1]) segments.push({ text: match[1] });
187
- segments.push({ text: match[2], italic: true });
188
- remaining = remaining.slice(match[0].length);
189
- continue;
190
- }
191
-
192
- // Inline code: `text`
193
- match = remaining.match(/^(.*?)`(.+?)`/s);
194
- if (match && match[1].length < remaining.length) {
195
- if (match[1]) segments.push({ text: match[1] });
196
- segments.push({ text: match[2], code: true });
197
- remaining = remaining.slice(match[0].length);
198
- continue;
199
- }
200
-
201
- // No more formatting
202
- segments.push({ text: remaining });
203
- break;
204
- }
205
-
206
- return segments;
207
- }
208
-
209
- const MAX_VISIBLE_LINES = 30;
210
- const DEFAULT_PANEL_WIDTH = 76;
211
-
212
- /**
213
- * A fenced block with no language that is plainly prose, not code.
214
- *
215
- * Models routinely wrap their closing summary in a bare ``` fence. Rendering
216
- * that as a code panel - line numbers, syntax colours, "15 lines" - is actively
217
- * misleading, so it gets rendered as markdown instead. Kept deliberately
218
- * conservative: any whiff of real code and it stays a code block.
219
- */
220
- function looksLikeProse(lang, code) {
221
- if (lang) return false;
222
- const lines = code.split('\n').filter((l) => l.trim());
223
- if (lines.length === 0) return false;
224
-
225
- const codeish = lines.filter((l) =>
226
- /[;{}]\s*$/.test(l) ||
227
- /^\s*(?:const|let|var|function|import|export|class|def|return|if|for|while|#include)\b/.test(l) ||
228
- /^\s*<\/?[a-zA-Z]/.test(l) ||
229
- /^\s*[\w-]+\s*:\s*[^\s].*;/.test(l)
230
- ).length;
231
- if (codeish > 0) return false;
232
-
233
- const proseish = lines.filter((l) =>
234
- /\*\*[^*]+\*\*/.test(l) || // bold
235
- /^\s*#{1,6}\s+\S/.test(l) || // heading
236
- /^\s*[-*]\s+\S/.test(l) || // bullet
237
- /^\s*\d+\.\s+\S/.test(l) // numbered
238
- ).length;
239
-
240
- return proseish / lines.length >= 0.4;
241
- }
242
-
243
- function CodeBlock({ lang, code, truncated, width }) {
244
- const allLines = code.split('\n');
245
- const totalLines = allLines.length;
246
- const shouldTruncate = truncated !== false && totalLines > MAX_VISIBLE_LINES;
247
- const visibleLines = shouldTruncate ? allLines.slice(0, MAX_VISIBLE_LINES) : allLines;
248
- const highlighted = highlightCode(visibleLines.join('\n'), lang);
249
- const langLabel = lang || 'code';
250
-
251
- const panelWidth = Math.max(24, Math.min(width || DEFAULT_PANEL_WIDTH, 120));
252
- const gutterWidth = String(visibleLines.length).length + 1;
253
- const bodyWidth = panelWidth - gutterWidth - 2;
254
-
255
- const countLabel = shouldTruncate
256
- ? `${totalLines} lines · first ${MAX_VISIBLE_LINES}`
257
- : `${totalLines} line${totalLines === 1 ? '' : 's'}`;
258
-
259
- // Header: language on the left, line count pushed to the right edge.
260
- const headLeft = ' ' + langLabel;
261
- const headGap = Math.max(1, panelWidth - headLeft.length - countLabel.length - 1);
262
- const header = fillRow(
263
- hexToAnsi(G.blue) + ANSI_BOLD + headLeft + ANSI_RESET + hexToAnsiBg(SURFACE.codeHeader) +
264
- ' '.repeat(headGap) + hexToAnsi('#6b7280') + countLabel + ' ',
265
- headLeft.length + headGap + countLabel.length + 1,
266
- panelWidth,
267
- SURFACE.codeHeader
268
- );
269
-
270
- const rows = highlighted.map((segments, i) => {
271
- const raw = visibleLines[i] ?? '';
272
- // Diff hunks get a tinted row so +/- reads at a glance.
273
- const isAdd = /^\+(?!\+)/.test(raw);
274
- const isDel = /^-(?!-)/.test(raw);
275
- const bg = isAdd ? SURFACE.diffAdd : isDel ? SURFACE.diffDel : SURFACE.codeBody;
276
-
277
- const num = String(i + 1).padStart(gutterWidth - 1);
278
- const gutter = hexToAnsiBg(SURFACE.gutter) + hexToAnsi('#4b5563') + ' ' + num + ANSI_RESET;
279
- const { text, used } = clipSegments(segments, bodyWidth);
280
- const body = hexToAnsiBg(bg) + ' ' + text;
281
-
282
- return React.createElement(
283
- Text,
284
- { key: i },
285
- gutter + fillRow(body, used + 1, panelWidth - gutterWidth, bg)
286
- );
287
- });
288
-
289
- return React.createElement(
290
- Box,
291
- { flexDirection: 'column', marginBottom: 1 },
292
- React.createElement(Text, null, header),
293
- // One <Text> per line, pre-flattened to ANSI. Ink allocates a Yoga layout
294
- // node per element, so per-token <Text> nodes make long blocks crawl.
295
- ...rows,
296
- shouldTruncate && React.createElement(
297
- Text,
298
- null,
299
- fillRow(
300
- hexToAnsiBg(SURFACE.codeHeader) + hexToAnsi('#6b7280') +
301
- ` ⋯ ${totalLines - MAX_VISIBLE_LINES} more lines`,
302
- ` ⋯ ${totalLines - MAX_VISIBLE_LINES} more lines`.length,
303
- panelWidth,
304
- SURFACE.codeHeader
305
- )
306
- )
307
- );
308
- }
309
-
310
- const ANSI_BOLD_OFF = '\x1b[22m';
311
- const ANSI_ITALIC_OFF = '\x1b[23m';
312
-
313
- /**
314
- * Style one segment without ever emitting a full reset.
315
- * ANSI_RESET would clear the panel's background mid-row and punch a hole in the
316
- * fill, so attributes are turned off individually instead.
317
- */
318
- function styleSegment(seg, defaultColor) {
319
- let out = '';
320
- if (seg.bold) out += ANSI_BOLD;
321
- if (seg.italic) out += ANSI_ITALIC;
322
- out += hexToAnsi(seg.color || defaultColor);
323
- out += seg.text;
324
- if (seg.italic) out += ANSI_ITALIC_OFF;
325
- if (seg.bold) out += ANSI_BOLD_OFF;
326
- return out;
327
- }
328
-
329
- /**
330
- * Word-wrap styled segments to `width`, returning rows of segments.
331
- * Wrapping happens on words rather than characters, and a word longer than the
332
- * whole width is hard-split so it can never overflow the panel.
333
- */
334
- function wrapStyledSegments(segments, width, nextWidth = width) {
335
- const rows = [];
336
- let row = [];
337
- let used = 0;
338
- // Continuation rows carry a hanging indent, so they have less room than the
339
- // first. Wrapping every row at the first row's width overflows the panel by
340
- // exactly the indent.
341
- let limit = width;
342
- const flush = () => { rows.push(row); row = []; used = 0; limit = nextWidth; };
343
-
344
- for (const seg of segments) {
345
- for (const word of seg.text.split(/(\s+)/)) {
346
- if (!word) continue;
347
- const isSpace = /^\s+$/.test(word);
348
- if (isSpace && used === 0) continue; // no leading space on a wrapped row
349
- if (used + word.length <= limit) {
350
- row.push({ ...seg, text: word });
351
- used += word.length;
352
- continue;
353
- }
354
- if (isSpace) { flush(); continue; } // break at the space itself
355
- if (used > 0) flush();
356
- let rest = word;
357
- while (rest.length > limit) { // pathologically long token
358
- row.push({ ...seg, text: rest.slice(0, limit) });
359
- used = limit;
360
- flush();
361
- rest = rest.slice(limit);
362
- }
363
- if (rest) { row.push({ ...seg, text: rest }); used += rest.length; }
364
- }
365
- }
366
- if (row.length || rows.length === 0) flush();
367
- return rows;
368
- }
369
-
370
- /** Turn one raw markdown line into an indent + styled segments. */
371
- function formatPanelLine(raw) {
372
- const indentMatch = raw.match(/^(\s*)/);
373
- const indent = Math.min(indentMatch ? indentMatch[1].length : 0, 12);
374
- const line = raw.slice(indent);
375
-
376
- const heading = line.match(/^(#{1,6})\s+(.*)$/);
377
- if (heading) {
378
- const level = heading[1].length;
379
- const color = level <= 2 ? G.blue : level === 3 ? G.green : G.yellow;
380
- return {
381
- indent,
382
- hanging: 0,
383
- segments: parseInline(heading[2]).map((s) => ({ ...s, bold: true, color })),
384
- };
385
- }
386
-
387
- if (/^[-*_]{3,}\s*$/.test(line)) {
388
- return { indent, hanging: 0, rule: true, segments: [] };
389
- }
390
-
391
- const bullet = line.match(/^([-*])\s+(.*)$/);
392
- if (bullet) {
393
- return {
394
- indent,
395
- hanging: 2,
396
- segments: [{ text: '• ', color: G.blue }, ...parseInline(bullet[2])],
397
- };
398
- }
399
-
400
- const numbered = line.match(/^(\d+)\.\s+(.*)$/);
401
- if (numbered) {
402
- const marker = `${numbered[1]}. `;
403
- return {
404
- indent,
405
- hanging: marker.length,
406
- segments: [{ text: marker, color: G.blue }, ...parseInline(numbered[2])],
407
- };
408
- }
409
-
410
- return { indent, hanging: 0, segments: parseInline(line) };
411
- }
412
-
413
- /**
414
- * Filled panel for a plan / reasoning block - same visual family as CodeBlock
415
- * so the transcript reads as one system, but without the line-number gutter
416
- * since prose is not addressed by line.
417
- *
418
- * Content is wrapped, never clipped: a plan is meant to be read, so losing the
419
- * end of every long sentence defeats the point.
420
- */
421
- function Panel({ title, lines, width, accent = G.yellow, bg = SURFACE.plan, headerBg = SURFACE.planHeader }) {
422
- const panelWidth = Math.max(24, Math.min(width || DEFAULT_PANEL_WIDTH, 120));
423
- const textColor = '#d5d9df';
424
-
425
- const head = ' ' + title;
426
- const header = fillRow(
427
- hexToAnsi(accent) + ANSI_BOLD + head + ANSI_BOLD_OFF,
428
- head.length,
429
- panelWidth,
430
- headerBg
431
- );
432
-
433
- const rendered = [];
434
- for (const raw of lines) {
435
- const { indent, hanging, segments, rule } = formatPanelLine(raw);
436
-
437
- if (rule) {
438
- const dash = '─'.repeat(Math.max(4, panelWidth - 4));
439
- rendered.push(hexToAnsiBg(bg) + ' ' + hexToAnsi('#3a4048') + dash);
440
- continue;
441
- }
442
- if (segments.length === 0) {
443
- rendered.push(hexToAnsiBg(bg) + ' ');
444
- continue;
445
- }
446
-
447
- const avail = Math.max(8, panelWidth - 2 - indent);
448
- const rows = wrapStyledSegments(segments, avail, Math.max(4, avail - hanging));
449
- rows.forEach((row, i) => {
450
- // Continuation rows line up under the text, not under the bullet.
451
- const pad = ' '.repeat(indent + (i > 0 ? hanging : 0));
452
- const body = row.map((s) => styleSegment(s, textColor)).join('');
453
- rendered.push(hexToAnsiBg(bg) + ' ' + pad + body);
454
- });
455
- }
456
-
457
- return React.createElement(
458
- Box,
459
- { flexDirection: 'column', marginBottom: 1 },
460
- React.createElement(Text, { key: 'h' }, header),
461
- ...rendered.map((content, i) => {
462
- const used = visibleLength(content);
463
- return React.createElement(
464
- Text,
465
- { key: i },
466
- hexToAnsiBg(bg) + content + ' '.repeat(Math.max(0, panelWidth - used)) + ANSI_RESET
467
- );
468
- })
469
- );
470
- }
471
-
472
- function Heading({ level, children }) {
473
- const color = level === 1 ? G.blue : level === 2 ? G.green : G.yellow;
474
- return React.createElement(
475
- Box,
476
- { marginBottom: 1, marginTop: level <= 2 ? 1 : 0 },
477
- React.createElement(Text, { color, bold: level <= 2, wrap: 'wrap' }, children)
478
- );
479
- }
480
-
481
- function ListItem({ children, ordered, index }) {
482
- const bullet = ordered ? `${index}. ` : ' • ';
483
- const bulletColored = hexToAnsi(G.blue) + bullet + ANSI_RESET;
484
- const segments = parseInline(children);
485
- let content = '';
486
- for (const seg of segments) {
487
- let prefix = '';
488
- if (seg.bold) prefix += ANSI_BOLD;
489
- if (seg.italic) prefix += ANSI_ITALIC;
490
- if (seg.color) prefix += hexToAnsi(seg.color);
491
- content += prefix + seg.text + (prefix ? ANSI_RESET : '');
492
- }
493
- return React.createElement(Text, { wrap: 'wrap' }, ' ' + bulletColored + content);
494
- }
495
-
496
- function HorizontalRule({ width }) {
497
- return React.createElement(
498
- Box,
499
- { marginY: 1 },
500
- React.createElement(Text, { color: '#3c4043' }, '─'.repeat(Math.max(8, Math.min(width || 50, 72))))
501
- );
502
- }
503
-
504
- function Blockquote({ children }) {
505
- return React.createElement(
506
- Box,
507
- {
508
- borderStyle: 'bold',
509
- borderTop: false,
510
- borderRight: false,
511
- borderBottom: false,
512
- borderLeftColor: G.blue,
513
- paddingLeft: 1,
514
- marginBottom: 1,
515
- },
516
- React.createElement(Text, { color: '#9aa0a6', italic: true, wrap: 'wrap' }, children)
517
- );
518
- }
519
-
520
- function renderMarkdown(md, width) {
521
- const elements = [];
522
- const lines = md.split('\n');
523
- let i = 0;
524
-
525
- while (i < lines.length) {
526
- const line = lines[i];
527
-
528
- // Code block: ```lang ... ```
529
- if (line.trim().startsWith('```')) {
530
- const lang = line.trim().slice(3).trim();
531
- const codeLines = [];
532
- i++;
533
- while (i < lines.length && !lines[i].trim().startsWith('```')) {
534
- codeLines.push(lines[i]);
535
- i++;
536
- }
537
- i++; // skip closing ```
538
- const body = codeLines.join('\n');
539
- if (looksLikeProse(lang, body)) {
540
- // A bare fence around a written summary - render it as what it is.
541
- for (const el of renderMarkdown(body, width)) {
542
- elements.push(React.cloneElement(el, { key: `fenced-${elements.length}-${el.key}` }));
543
- }
544
- } else {
545
- elements.push(React.createElement(CodeBlock, {
546
- key: `code-${elements.length}`, lang, code: body, width,
547
- }));
548
- }
549
- continue;
550
- }
551
-
552
- // Heading: # ## ###
553
- const headingMatch = line.match(/^(#{1,6})\s+(.+)/);
554
- if (headingMatch) {
555
- elements.push(React.createElement(Heading, { key: `h-${elements.length}`, level: headingMatch[1].length }, headingMatch[2]));
556
- i++;
557
- continue;
558
- }
559
-
560
- // Horizontal rule: --- or *** or ___
561
- if (/^[-*_]{3,}\s*$/.test(line.trim())) {
562
- elements.push(React.createElement(HorizontalRule, { key: `hr-${elements.length}`, width }));
563
- i++;
564
- continue;
565
- }
566
-
567
- // Blockquote: > text
568
- if (line.trim().startsWith('>')) {
569
- elements.push(React.createElement(Blockquote, { key: `bq-${elements.length}`, children: line.trim().slice(1).trim() }));
570
- i++;
571
- continue;
572
- }
573
-
574
- // Unordered list: - or * text
575
- const listMatch = line.match(/^(\s*)([-*])\s+(.+)/);
576
- if (listMatch) {
577
- elements.push(React.createElement(ListItem, { key: `li-${elements.length}`, children: listMatch[3] }));
578
- i++;
579
- continue;
580
- }
581
-
582
- // Ordered list: 1. text
583
- const olMatch = line.match(/^(\s*)(\d+)\.\s+(.+)/);
584
- if (olMatch) {
585
- elements.push(React.createElement(ListItem, { key: `oli-${elements.length}`, children: olMatch[3], ordered: true, index: parseInt(olMatch[2]) }));
586
- i++;
587
- continue;
588
- }
589
-
590
- // Empty line
591
- if (line.trim() === '') {
592
- i++;
593
- continue;
594
- }
595
-
596
- // Paragraph: collect consecutive non-empty lines
597
- const paraLines = [];
598
- while (i < lines.length && lines[i].trim() !== '' && !lines[i].trim().startsWith('```') && !lines[i].trim().startsWith('#') && !lines[i].trim().startsWith('>') && !/^[-*]\s/.test(lines[i].trim()) && !/^\d+\.\s/.test(lines[i].trim()) && !/^[-*_]{3,}\s*$/.test(lines[i].trim())) {
599
- paraLines.push(lines[i]);
600
- i++;
601
- }
602
- if (paraLines.length) {
603
- elements.push(
604
- React.createElement(InlineText, { key: `p-${elements.length}`, segments: parseInline(paraLines.join(' ')) })
605
- );
606
- }
607
- }
608
-
609
- return elements;
610
- }
611
-
612
- export {
613
- renderMarkdown, CodeBlock, Panel, parseInline, looksLikeProse,
614
- hexToAnsi, hexToAnsiBg, fillRow, clipSegments, visibleLength, SURFACE,
615
- ANSI_RESET, ANSI_BOLD, ANSI_DIM, ANSI_ITALIC,
616
- };
617
- export default renderMarkdown;
1
+ /**
2
+ * Codeply TUI - Markdown renderer for AI responses.
3
+ *
4
+ * Turns a reply into Ink elements, one pre-flattened ANSI string per row
5
+ * wherever possible (Ink allocates a layout node per element, so per-token
6
+ * <Text> nodes make long replies crawl).
7
+ *
8
+ * Code blocks are printed without line numbers or filled backgrounds on
9
+ * purpose: people select code straight out of the terminal, and a gutter or
10
+ * trailing fill comes along with every copy.
11
+ */
12
+ import React from 'react';
13
+ import { Box, Text } from 'ink';
14
+ import { createRequire } from 'module';
15
+
16
+ const require = createRequire(import.meta.url);
17
+
18
+ const G = {
19
+ blue: '#4285F4',
20
+ red: '#EA4335',
21
+ yellow: '#FBBC05',
22
+ green: '#34A853',
23
+ };
24
+
25
+ // Reading colours for the transcript, shared with tui.mjs.
26
+ const INK = {
27
+ text: '#e3e3e3',
28
+ secondary: '#a8adb3',
29
+ dim: '#80868b',
30
+ faint: '#5f6368',
31
+ code: '#8ab4f8',
32
+ link: '#8ab4f8',
33
+ bullet: '#8ab4f8',
34
+ };
35
+
36
+ // ─── Syntax highlighting ────────────────────────────────────────────────────
37
+ //
38
+ // highlight.js ships with the CLI (it comes in through marked-terminal), and
39
+ // knows every language a model is likely to fence. It is loaded lazily and
40
+ // optionally: if it is ever missing, the small regex highlighter below takes
41
+ // over instead of the reply failing to render.
42
+
43
+ const SYNTAX = {
44
+ keyword: '#c586c0',
45
+ built_in: '#4ec9b0',
46
+ type: '#4ec9b0',
47
+ literal: '#569cd6',
48
+ number: '#b5cea8',
49
+ string: '#ce9178',
50
+ regexp: '#d16969',
51
+ comment: '#6a9955',
52
+ title: '#dcdcaa',
53
+ function: '#dcdcaa',
54
+ params: '#9cdcfe',
55
+ attr: '#9cdcfe',
56
+ attribute: '#9cdcfe',
57
+ property: '#9cdcfe',
58
+ variable: '#9cdcfe',
59
+ tag: '#569cd6',
60
+ name: '#569cd6',
61
+ 'selector-tag': '#d7ba7d',
62
+ 'selector-class': '#d7ba7d',
63
+ 'selector-id': '#d7ba7d',
64
+ meta: '#9b9b9b',
65
+ symbol: '#b5cea8',
66
+ addition: '#89d185',
67
+ deletion: '#f48771',
68
+ section: '#569cd6',
69
+ bullet: '#569cd6',
70
+ };
71
+ const CODE_TEXT = '#d4d4d4';
72
+
73
+ let hljs;
74
+ function loadHljs() {
75
+ if (hljs !== undefined) return hljs;
76
+ try { hljs = require('highlight.js'); } catch { hljs = null; }
77
+ return hljs;
78
+ }
79
+
80
+ const ENTITIES = { '&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&#x27;': "'", '&#39;': "'" };
81
+ const decode = (s) => s.replace(/&(?:amp|lt|gt|quot|#x27|#39);/g, (m) => ENTITIES[m]);
82
+
83
+ /** highlight.js HTML → rows of {text, color} segments. */
84
+ function hljsRows(code, lang) {
85
+ const h = loadHljs();
86
+ if (!h || !lang || !h.getLanguage(lang)) return null;
87
+ let html;
88
+ try { html = h.highlight(code, { language: lang, ignoreIllegals: true }).value; } catch { return null; }
89
+ const rows = [[]];
90
+ const stack = [];
91
+ const re = /<span class="([^"]+)">|<\/span>|([^<]+)/g;
92
+ let m;
93
+ while ((m = re.exec(html)) !== null) {
94
+ if (m[1]) {
95
+ const cls = m[1].split(/\s+/).map((c) => c.replace(/^hljs-/, '')).find((c) => SYNTAX[c]);
96
+ stack.push(cls ? SYNTAX[cls] : stack[stack.length - 1] || null);
97
+ } else if (m[0] === '</span>') {
98
+ stack.pop();
99
+ } else {
100
+ const color = stack[stack.length - 1] || CODE_TEXT;
101
+ const parts = decode(m[2]).split('\n');
102
+ parts.forEach((p, i) => {
103
+ if (i > 0) rows.push([]);
104
+ if (p) rows[rows.length - 1].push({ text: p, color });
105
+ });
106
+ }
107
+ }
108
+ return rows;
109
+ }
110
+
111
+ /** Fallback highlighter for when highlight.js is unavailable or the language unknown. */
112
+ function highlightCode(code, lang) {
113
+ const fromHljs = hljsRows(code, lang);
114
+ if (fromHljs) return fromHljs;
115
+ if (!lang) return code.split('\n').map((line) => [{ text: line, color: CODE_TEXT }]);
116
+ return code.split('\n').map((line) => {
117
+ if (/^\s*(\/\/|#|\/\*|\*|<!--)/.test(line)) return [{ text: line, color: SYNTAX.comment }];
118
+ const regex = /("[^"]*"|'[^']*'|`[^`]*`)|(\b(?:function|const|let|var|if|else|return|for|while|do|switch|case|break|continue|new|this|class|extends|import|export|from|default|async|await|try|catch|throw|typeof|instanceof|in|of|void|delete|def|fn|pub|use|struct|impl)\b)|(\b(?:null|undefined|true|false|None|True|False)\b)|(\b\d+\.?\d*\b)/g;
119
+ const out = [];
120
+ let last = 0;
121
+ let match;
122
+ while ((match = regex.exec(line)) !== null) {
123
+ if (match.index > last) out.push({ text: line.slice(last, match.index), color: CODE_TEXT });
124
+ const color = match[1] ? SYNTAX.string : match[2] ? SYNTAX.keyword : match[3] ? SYNTAX.literal : SYNTAX.number;
125
+ out.push({ text: match[0], color });
126
+ last = match.index + match[0].length;
127
+ }
128
+ if (last < line.length) out.push({ text: line.slice(last), color: CODE_TEXT });
129
+ return out.length ? out : [{ text: line, color: CODE_TEXT }];
130
+ });
131
+ }
132
+
133
+ // ─── ANSI helpers ───────────────────────────────────────────────────────────
134
+
135
+ function hexToAnsi(hex) {
136
+ if (!hex) return '';
137
+ const h = hex.replace('#', '');
138
+ const r = parseInt(h.substring(0, 2), 16);
139
+ const g = parseInt(h.substring(2, 4), 16);
140
+ const b = parseInt(h.substring(4, 6), 16);
141
+ return `\x1b[38;2;${r};${g};${b}m`;
142
+ }
143
+
144
+ /** Background counterpart of hexToAnsi. */
145
+ function hexToAnsiBg(hex) {
146
+ if (!hex) return '';
147
+ const h = hex.replace('#', '');
148
+ const r = parseInt(h.substring(0, 2), 16);
149
+ const g = parseInt(h.substring(2, 4), 16);
150
+ const b = parseInt(h.substring(4, 6), 16);
151
+ return `\x1b[48;2;${r};${g};${b}m`;
152
+ }
153
+
154
+ const ANSI_RESET = '\x1b[0m';
155
+ const ANSI_BOLD = '\x1b[1m';
156
+ const ANSI_DIM = '\x1b[2m';
157
+ const ANSI_ITALIC = '\x1b[3m';
158
+ const ANSI_UNDERLINE = '\x1b[4m';
159
+ const ANSI_STRIKE = '\x1b[9m';
160
+ const ANSI_BOLD_OFF = '\x1b[22m';
161
+ const ANSI_ITALIC_OFF = '\x1b[23m';
162
+
163
+ // Surface colours for filled blocks. Ink 5's <Box> has no backgroundColor, so
164
+ // every filled row is built by hand: set the bg, emit the content, pad out to
165
+ // the panel width so the fill reaches the right edge, then reset.
166
+ const SURFACE = {
167
+ plan: '#161b22',
168
+ planHeader: '#1d2530',
169
+ diffAdd: '#173a24',
170
+ diffDel: '#45191e',
171
+ diffAddWord: '#22603a',
172
+ diffDelWord: '#7a2a33',
173
+ };
174
+
175
+ const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
176
+ const visibleLength = (s) => s.replace(ANSI_PATTERN, '').length;
177
+
178
+ /**
179
+ * Render coloured segments clipped to `width`, returning the ANSI string and
180
+ * how many visible columns it used. Clipping happens per segment so a cut never
181
+ * lands inside an escape sequence.
182
+ */
183
+ function clipSegments(segments, width) {
184
+ let out = '';
185
+ let used = 0;
186
+ for (const seg of segments) {
187
+ if (used >= width) break;
188
+ const room = width - used;
189
+ const text = seg.text.length > room ? seg.text.slice(0, room) : seg.text;
190
+ if (!text) continue;
191
+ out += (seg.color ? hexToAnsi(seg.color) : '') + text;
192
+ used += text.length;
193
+ }
194
+ return { text: out, used };
195
+ }
196
+
197
+ /** One full-width row of a filled panel. */
198
+ function fillRow(content, usedWidth, width, bg) {
199
+ const pad = Math.max(0, width - usedWidth);
200
+ return hexToAnsiBg(bg) + content + ' '.repeat(pad) + ANSI_RESET;
201
+ }
202
+
203
+ // ─── Inline markdown ────────────────────────────────────────────────────────
204
+
205
+ /**
206
+ * Split a line into styled segments.
207
+ *
208
+ * Scans for whichever marker comes FIRST, so `code` before a **bold** run is
209
+ * still code (the old pattern-by-pattern pass swallowed it as plain text).
210
+ * Underscore emphasis needs a word boundary on both sides so snake_case
211
+ * identifiers in prose stay intact.
212
+ */
213
+ function parseInline(text) {
214
+ const segments = [];
215
+ const re = /(`+)([^`]+?)\1|\*\*(.+?)\*\*|__(.+?)__|~~(.+?)~~|\[([^\]]+)\]\(([^)\s]+)\)|(?<![\w*])\*(?![\s*])(.+?)(?<![\s*])\*(?![\w*])|(?<![\w])_(?![\s_])(.+?)(?<![\s_])_(?![\w])/g;
216
+ let last = 0;
217
+ let m;
218
+ while ((m = re.exec(text)) !== null) {
219
+ if (m.index > last) segments.push({ text: text.slice(last, m.index) });
220
+ if (m[2] != null) segments.push({ text: m[2], code: true });
221
+ else if (m[3] != null) segments.push(...parseInline(m[3]).map((s) => ({ ...s, bold: true })));
222
+ else if (m[4] != null) segments.push(...parseInline(m[4]).map((s) => ({ ...s, bold: true })));
223
+ else if (m[5] != null) segments.push({ text: m[5], strike: true });
224
+ else if (m[6] != null) {
225
+ segments.push({ text: m[6], link: true });
226
+ if (m[7] !== m[6]) segments.push({ text: ` (${m[7]})`, color: INK.faint });
227
+ } else if (m[8] != null) segments.push(...parseInline(m[8]).map((s) => ({ ...s, italic: true })));
228
+ else if (m[9] != null) segments.push(...parseInline(m[9]).map((s) => ({ ...s, italic: true })));
229
+ last = m.index + m[0].length;
230
+ }
231
+ if (last < text.length) segments.push({ text: text.slice(last) });
232
+ return segments;
233
+ }
234
+
235
+ /** Segments → one ANSI string, every run closed with a full reset. */
236
+ function inlineAnsi(segments, baseColor = INK.text) {
237
+ let out = '';
238
+ for (const seg of segments) {
239
+ let pre = hexToAnsi(seg.code ? INK.code : seg.link ? INK.link : seg.color || baseColor);
240
+ if (seg.bold) pre += ANSI_BOLD;
241
+ if (seg.italic) pre += ANSI_ITALIC;
242
+ if (seg.strike) pre += ANSI_STRIKE;
243
+ if (seg.link) pre += ANSI_UNDERLINE;
244
+ out += pre + seg.text + ANSI_RESET;
245
+ }
246
+ return out;
247
+ }
248
+
249
+ function InlineText({ segments, color }) {
250
+ return React.createElement(Text, { wrap: 'wrap' }, inlineAnsi(segments, color));
251
+ }
252
+
253
+ // ─── Blocks ─────────────────────────────────────────────────────────────────
254
+
255
+ const MAX_VISIBLE_LINES = 80;
256
+ const DEFAULT_PANEL_WIDTH = 76;
257
+
258
+ /**
259
+ * A fenced block with no language that is plainly prose, not code.
260
+ *
261
+ * Models routinely wrap their closing summary in a bare ``` fence. Rendering
262
+ * that as code is actively misleading, so it gets rendered as markdown
263
+ * instead. Kept deliberately conservative: any whiff of real code and it stays
264
+ * a code block.
265
+ */
266
+ function looksLikeProse(lang, code) {
267
+ if (lang) return false;
268
+ const lines = code.split('\n').filter((l) => l.trim());
269
+ if (lines.length === 0) return false;
270
+
271
+ const codeish = lines.filter((l) =>
272
+ /[;{}]\s*$/.test(l) ||
273
+ /^\s*(?:const|let|var|function|import|export|class|def|return|if|for|while|#include)\b/.test(l) ||
274
+ /^\s*<\/?[a-zA-Z]/.test(l) ||
275
+ /^\s*[\w-]+\s*:\s*[^\s].*;/.test(l)
276
+ ).length;
277
+ if (codeish > 0) return false;
278
+
279
+ const proseish = lines.filter((l) =>
280
+ /\*\*[^*]+\*\*/.test(l) ||
281
+ /^\s*#{1,6}\s+\S/.test(l) ||
282
+ /^\s*[-*]\s+\S/.test(l) ||
283
+ /^\s*\d+\.\s+\S/.test(l)
284
+ ).length;
285
+
286
+ return proseish / lines.length >= 0.4;
287
+ }
288
+
289
+ function CodeBlock({ lang, code, truncated, width }) {
290
+ const allLines = code.replace(/\s+$/, '').split('\n');
291
+ const totalLines = allLines.length;
292
+ const shouldTruncate = truncated !== false && totalLines > MAX_VISIBLE_LINES;
293
+ const visibleLines = shouldTruncate ? allLines.slice(0, MAX_VISIBLE_LINES) : allLines;
294
+ const isDiff = lang === 'diff' || lang === 'patch';
295
+ const rows = isDiff ? null : highlightCode(visibleLines.join('\n'), lang);
296
+
297
+ const lines = visibleLines.map((raw, i) => {
298
+ if (isDiff) {
299
+ const color = /^\+(?!\+\+)/.test(raw) ? SYNTAX.addition
300
+ : /^-(?!--)/.test(raw) ? SYNTAX.deletion
301
+ : /^@@/.test(raw) ? SYNTAX.literal : CODE_TEXT;
302
+ return ' ' + hexToAnsi(color) + raw + ANSI_RESET;
303
+ }
304
+ const segs = rows[i] || [];
305
+ return ' ' + segs.map((s) => hexToAnsi(s.color) + s.text).join('') + ANSI_RESET;
306
+ });
307
+
308
+ return React.createElement(
309
+ Box,
310
+ { flexDirection: 'column', width },
311
+ ...lines.map((l, i) => React.createElement(Text, { key: i, wrap: 'wrap' }, l || ' ')),
312
+ shouldTruncate && React.createElement(
313
+ Text,
314
+ { key: 'more' },
315
+ hexToAnsi(INK.faint) + ` … ${totalLines - MAX_VISIBLE_LINES} more lines` + ANSI_RESET
316
+ )
317
+ );
318
+ }
319
+
320
+ /**
321
+ * Style one segment without ever emitting a full reset.
322
+ * ANSI_RESET would clear the panel's background mid-row and punch a hole in the
323
+ * fill, so attributes are turned off individually instead.
324
+ */
325
+ function styleSegment(seg, defaultColor) {
326
+ let out = '';
327
+ if (seg.bold) out += ANSI_BOLD;
328
+ if (seg.italic) out += ANSI_ITALIC;
329
+ out += hexToAnsi(seg.code ? INK.code : seg.color || defaultColor);
330
+ out += seg.text;
331
+ if (seg.italic) out += ANSI_ITALIC_OFF;
332
+ if (seg.bold) out += ANSI_BOLD_OFF;
333
+ return out;
334
+ }
335
+
336
+ /**
337
+ * Word-wrap styled segments to `width`, returning rows of segments.
338
+ * Wrapping happens on words rather than characters, and a word longer than the
339
+ * whole width is hard-split so it can never overflow the panel.
340
+ */
341
+ function wrapStyledSegments(segments, width, nextWidth = width) {
342
+ const rows = [];
343
+ let row = [];
344
+ let used = 0;
345
+ // Continuation rows carry a hanging indent, so they have less room than the
346
+ // first. Wrapping every row at the first row's width overflows the panel by
347
+ // exactly the indent.
348
+ let limit = width;
349
+ const flush = () => { rows.push(row); row = []; used = 0; limit = nextWidth; };
350
+
351
+ for (const seg of segments) {
352
+ for (const word of seg.text.split(/(\s+)/)) {
353
+ if (!word) continue;
354
+ const isSpace = /^\s+$/.test(word);
355
+ if (isSpace && used === 0) continue;
356
+ if (used + word.length <= limit) {
357
+ row.push({ ...seg, text: word });
358
+ used += word.length;
359
+ continue;
360
+ }
361
+ if (isSpace) { flush(); continue; }
362
+ if (used > 0) flush();
363
+ let rest = word;
364
+ while (rest.length > limit) {
365
+ row.push({ ...seg, text: rest.slice(0, limit) });
366
+ used = limit;
367
+ flush();
368
+ rest = rest.slice(limit);
369
+ }
370
+ if (rest) { row.push({ ...seg, text: rest }); used += rest.length; }
371
+ }
372
+ }
373
+ if (row.length || rows.length === 0) flush();
374
+ return rows;
375
+ }
376
+
377
+ /** Turn one raw markdown line into an indent + styled segments. */
378
+ function formatPanelLine(raw) {
379
+ const indentMatch = raw.match(/^(\s*)/);
380
+ const indent = Math.min(indentMatch ? indentMatch[1].length : 0, 12);
381
+ const line = raw.slice(indent);
382
+
383
+ const heading = line.match(/^(#{1,6})\s+(.*)$/);
384
+ if (heading) {
385
+ return {
386
+ indent,
387
+ hanging: 0,
388
+ segments: parseInline(heading[2]).map((s) => ({ ...s, bold: true, color: heading[1].length <= 2 ? INK.text : INK.secondary })),
389
+ };
390
+ }
391
+
392
+ if (/^[-*_]{3,}\s*$/.test(line)) {
393
+ return { indent, hanging: 0, rule: true, segments: [] };
394
+ }
395
+
396
+ const bullet = line.match(/^([-*])\s+(.*)$/);
397
+ if (bullet) {
398
+ return { indent, hanging: 2, segments: [{ text: '• ', color: INK.bullet }, ...parseInline(bullet[2])] };
399
+ }
400
+
401
+ const numbered = line.match(/^(\d+)\.\s+(.*)$/);
402
+ if (numbered) {
403
+ const marker = `${numbered[1]}. `;
404
+ return { indent, hanging: marker.length, segments: [{ text: marker, color: INK.bullet }, ...parseInline(numbered[2])] };
405
+ }
406
+
407
+ return { indent, hanging: 0, segments: parseInline(line) };
408
+ }
409
+
410
+ /**
411
+ * Filled panel for a plan. Content is wrapped, never clipped: a plan is meant
412
+ * to be read, so losing the end of every long sentence defeats the point.
413
+ */
414
+ function Panel({ title, lines, width, accent = G.yellow, bg = SURFACE.plan, headerBg = SURFACE.planHeader }) {
415
+ const panelWidth = Math.max(24, Math.min(width || DEFAULT_PANEL_WIDTH, 120));
416
+ const textColor = '#d5d9df';
417
+
418
+ const head = ' ' + title;
419
+ const header = fillRow(hexToAnsi(accent) + ANSI_BOLD + head + ANSI_BOLD_OFF, head.length, panelWidth, headerBg);
420
+
421
+ const rendered = [];
422
+ for (const raw of lines) {
423
+ const { indent, hanging, segments, rule } = formatPanelLine(raw);
424
+
425
+ if (rule) {
426
+ rendered.push(hexToAnsiBg(bg) + ' ' + hexToAnsi('#3a4048') + '─'.repeat(Math.max(4, panelWidth - 4)));
427
+ continue;
428
+ }
429
+ if (segments.length === 0) {
430
+ rendered.push(hexToAnsiBg(bg) + ' ');
431
+ continue;
432
+ }
433
+
434
+ const avail = Math.max(8, panelWidth - 2 - indent);
435
+ const rows = wrapStyledSegments(segments, avail, Math.max(4, avail - hanging));
436
+ rows.forEach((row, i) => {
437
+ const pad = ' '.repeat(indent + (i > 0 ? hanging : 0));
438
+ rendered.push(hexToAnsiBg(bg) + ' ' + pad + row.map((s) => styleSegment(s, textColor)).join(''));
439
+ });
440
+ }
441
+
442
+ return React.createElement(
443
+ Box,
444
+ { flexDirection: 'column' },
445
+ React.createElement(Text, { key: 'h' }, header),
446
+ ...rendered.map((content, i) => React.createElement(
447
+ Text,
448
+ { key: i },
449
+ hexToAnsiBg(bg) + content + ' '.repeat(Math.max(0, panelWidth - visibleLength(content))) + ANSI_RESET
450
+ ))
451
+ );
452
+ }
453
+
454
+ function Heading({ level, children }) {
455
+ const color = level <= 2 ? INK.text : INK.secondary;
456
+ const segs = parseInline(children).map((s) => ({ ...s, bold: true, color: s.code ? undefined : color }));
457
+ return React.createElement(Text, { wrap: 'wrap' }, (level === 1 ? ANSI_UNDERLINE : '') + inlineAnsi(segs, color));
458
+ }
459
+
460
+ /** A list item with a hanging indent, so wrapped lines sit under the text. */
461
+ function ListItem({ children, ordered, index, depth = 0 }) {
462
+ const marker = ordered ? `${index}. ` : depth > 0 ? '· ' : '• ';
463
+ return React.createElement(
464
+ Box,
465
+ { flexDirection: 'row', paddingLeft: depth * 2 },
466
+ React.createElement(Text, null, hexToAnsi(INK.bullet) + marker + ANSI_RESET),
467
+ React.createElement(Box, { flexGrow: 1, flexShrink: 1 }, React.createElement(InlineText, { segments: parseInline(children) }))
468
+ );
469
+ }
470
+
471
+ function HorizontalRule({ width }) {
472
+ return React.createElement(Text, null, hexToAnsi('#3c4043') + '─'.repeat(Math.max(8, Math.min(width || 50, 72))) + ANSI_RESET);
473
+ }
474
+
475
+ function Blockquote({ children }) {
476
+ return React.createElement(
477
+ Box,
478
+ { flexDirection: 'row' },
479
+ React.createElement(Text, null, hexToAnsi(INK.faint) + '│ ' + ANSI_RESET),
480
+ React.createElement(Box, { flexGrow: 1, flexShrink: 1 }, React.createElement(InlineText, {
481
+ segments: parseInline(children).map((s) => ({ ...s, italic: true })),
482
+ color: INK.secondary,
483
+ }))
484
+ );
485
+ }
486
+
487
+ // ─── Tables ─────────────────────────────────────────────────────────────────
488
+
489
+ const splitRow = (line) => line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.trim());
490
+ const isTableSep = (line) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/.test(line || '');
491
+ const plainLength = (cell) => parseInline(cell).reduce((n, s) => n + s.text.length, 0);
492
+
493
+ /** Fit a cell to `w` columns, keeping its inline styling. */
494
+ function fitCell(cell, w) {
495
+ const segs = parseInline(cell);
496
+ const out = [];
497
+ let used = 0;
498
+ for (const s of segs) {
499
+ if (used >= w) break;
500
+ let t = s.text;
501
+ if (used + t.length > w) t = t.slice(0, Math.max(0, w - used - 1)) + '…';
502
+ out.push({ ...s, text: t });
503
+ used += t.length;
504
+ }
505
+ return inlineAnsi(out) + ' '.repeat(Math.max(0, w - used));
506
+ }
507
+
508
+ function Table({ header, rows, width }) {
509
+ const cols = header.length;
510
+ const all = [header, ...rows].map((r) => Array.from({ length: cols }, (_, i) => r[i] ?? ''));
511
+ let widths = Array.from({ length: cols }, (_, i) => Math.max(3, ...all.map((r) => plainLength(r[i]))));
512
+ // Shrink the widest columns until the table fits: 3 columns of chrome per cell.
513
+ const budget = Math.max(cols * 4, (width || 80) - (cols * 3 + 1));
514
+ while (widths.reduce((a, b) => a + b, 0) > budget) {
515
+ const max = Math.max(...widths);
516
+ if (max <= 4) break;
517
+ widths = widths.map((w) => (w === max ? w - 1 : w));
518
+ }
519
+ const line = (l, m, r) => hexToAnsi(INK.faint) + l + widths.map((w) => '─'.repeat(w + 2)).join(m) + r + ANSI_RESET;
520
+ const bar = hexToAnsi(INK.faint) + '│' + ANSI_RESET;
521
+ const row = (cells, bold) => bar + cells.map((c, i) => ' ' + (bold ? ANSI_BOLD : '') + fitCell(c, widths[i]) + ' ').join(bar) + bar;
522
+ return React.createElement(
523
+ Box,
524
+ { flexDirection: 'column' },
525
+ React.createElement(Text, { key: 't' }, line('┌', '┬', '┐')),
526
+ React.createElement(Text, { key: 'h' }, row(all[0], true)),
527
+ React.createElement(Text, { key: 's' }, line('├', '┼', '┤')),
528
+ ...all.slice(1).map((r, i) => React.createElement(Text, { key: `r${i}` }, row(r, false))),
529
+ React.createElement(Text, { key: 'b' }, line('└', '┴', '┘'))
530
+ );
531
+ }
532
+
533
+ // ─── Document ───────────────────────────────────────────────────────────────
534
+
535
+ const Spacer = ({ k }) => React.createElement(Text, { key: k }, ' ');
536
+
537
+ function renderMarkdown(md, width) {
538
+ const elements = [];
539
+ const lines = String(md || '').replace(/\r\n?/g, '\n').split('\n');
540
+ let i = 0;
541
+ let gap = false; // a blank source line was seen since the last block
542
+
543
+ const add = (el) => {
544
+ if (gap && elements.length) elements.push(Spacer({ k: `sp-${elements.length}` }));
545
+ gap = false;
546
+ elements.push(el);
547
+ };
548
+
549
+ while (i < lines.length) {
550
+ const line = lines[i];
551
+ const trimmed = line.trim();
552
+
553
+ if (trimmed.startsWith('```') || trimmed.startsWith('~~~')) {
554
+ const fence = trimmed.slice(0, 3);
555
+ const lang = trimmed.slice(3).trim().split(/\s+/)[0].toLowerCase();
556
+ const codeLines = [];
557
+ i++;
558
+ while (i < lines.length && !lines[i].trim().startsWith(fence)) {
559
+ codeLines.push(lines[i]);
560
+ i++;
561
+ }
562
+ i++;
563
+ const body = codeLines.join('\n');
564
+ if (looksLikeProse(lang, body)) {
565
+ for (const el of renderMarkdown(body, width)) add(React.cloneElement(el, { key: `fenced-${elements.length}-${el.key}` }));
566
+ } else {
567
+ add(React.createElement(CodeBlock, { key: `code-${elements.length}`, lang, code: body, width }));
568
+ }
569
+ continue;
570
+ }
571
+
572
+ if (trimmed === '') { gap = true; i++; continue; }
573
+
574
+ const headingMatch = line.match(/^\s*(#{1,6})\s+(.+)/);
575
+ if (headingMatch) {
576
+ if (elements.length) gap = true;
577
+ add(React.createElement(Heading, { key: `h-${elements.length}`, level: headingMatch[1].length }, headingMatch[2].replace(/\s+#+\s*$/, '')));
578
+ i++;
579
+ continue;
580
+ }
581
+
582
+ if (/^[-*_]{3,}$/.test(trimmed.replace(/\s/g, ''))) {
583
+ add(React.createElement(HorizontalRule, { key: `hr-${elements.length}`, width }));
584
+ i++;
585
+ continue;
586
+ }
587
+
588
+ if (trimmed.startsWith('|') && isTableSep(lines[i + 1])) {
589
+ const header = splitRow(line);
590
+ const rows = [];
591
+ i += 2;
592
+ while (i < lines.length && lines[i].trim().startsWith('|')) { rows.push(splitRow(lines[i])); i++; }
593
+ add(React.createElement(Table, { key: `tb-${elements.length}`, header, rows, width }));
594
+ continue;
595
+ }
596
+
597
+ if (trimmed.startsWith('>')) {
598
+ add(React.createElement(Blockquote, { key: `bq-${elements.length}`, children: trimmed.replace(/^>\s?/, '') }));
599
+ i++;
600
+ continue;
601
+ }
602
+
603
+ const listMatch = line.match(/^(\s*)([-*+])\s+(.+)/);
604
+ if (listMatch) {
605
+ const task = listMatch[3].match(/^\[([ xX])\]\s+(.*)/);
606
+ const text = task ? (task[1] === ' ' ? '☐ ' : '☒ ') + task[2] : listMatch[3];
607
+ add(React.createElement(ListItem, { key: `li-${elements.length}`, children: text, depth: Math.min(3, Math.floor(listMatch[1].length / 2)) }));
608
+ i++;
609
+ continue;
610
+ }
611
+
612
+ const olMatch = line.match(/^(\s*)(\d+)[.)]\s+(.+)/);
613
+ if (olMatch) {
614
+ add(React.createElement(ListItem, {
615
+ key: `oli-${elements.length}`, children: olMatch[3], ordered: true, index: parseInt(olMatch[2], 10),
616
+ depth: Math.min(3, Math.floor(olMatch[1].length / 2)),
617
+ }));
618
+ i++;
619
+ continue;
620
+ }
621
+
622
+ // Paragraph: consecutive plain lines, joined like markdown does.
623
+ const paraLines = [];
624
+ while (i < lines.length) {
625
+ const t = lines[i].trim();
626
+ if (!t || t.startsWith('```') || t.startsWith('~~~') || /^#{1,6}\s/.test(t) || t.startsWith('>') ||
627
+ /^[-*+]\s/.test(t) || /^\d+[.)]\s/.test(t) || /^[-*_]{3,}$/.test(t.replace(/\s/g, '')) ||
628
+ (t.startsWith('|') && isTableSep(lines[i + 1]))) break;
629
+ paraLines.push(t);
630
+ i++;
631
+ }
632
+ if (paraLines.length) {
633
+ add(React.createElement(InlineText, { key: `p-${elements.length}`, segments: parseInline(paraLines.join(' ')) }));
634
+ } else {
635
+ i++;
636
+ }
637
+ }
638
+
639
+ return elements;
640
+ }
641
+
642
+ export {
643
+ renderMarkdown, CodeBlock, Panel, parseInline, inlineAnsi, looksLikeProse, highlightCode,
644
+ hexToAnsi, hexToAnsiBg, fillRow, clipSegments, visibleLength, SURFACE, INK,
645
+ ANSI_RESET, ANSI_BOLD, ANSI_DIM, ANSI_ITALIC, ANSI_STRIKE,
646
+ };
647
+ export default renderMarkdown;