stream_weaver 0.3.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 (381) hide show
  1. checksums.yaml +7 -0
  2. data/.beads/.gitignore +77 -0
  3. data/.beads/README.md +81 -0
  4. data/.beads/config.yaml +54 -0
  5. data/.beads/metadata.json +7 -0
  6. data/.rspec +3 -0
  7. data/AGENTS.md +91 -0
  8. data/CHANGELOG.md +294 -0
  9. data/CLAUDE.md +67 -0
  10. data/LICENSE.txt +21 -0
  11. data/README.md +565 -0
  12. data/Rakefile +13 -0
  13. data/assets/streamweaver-hero.jpg +0 -0
  14. data/bench/baselines/ledger.rb +58 -0
  15. data/bench/baselines/warroom.rb +51 -0
  16. data/bench/fixtures/ledger.rb +76 -0
  17. data/bench/fixtures/warroom.rb +60 -0
  18. data/bench/results/6daf8b8.md +102 -0
  19. data/bench/results/c8d749b.md +102 -0
  20. data/bench/results/eb06ab9.md +102 -0
  21. data/bench/run.rb +151 -0
  22. data/bench/support.rb +84 -0
  23. data/copy_this/dto_run_sample_run_7631.html +220 -0
  24. data/docs/SERVICE_MODE.md +302 -0
  25. data/docs/architecture/how_streamweaver_works.md +772 -0
  26. data/docs/blog/2026-01-16-streamweaver-introduction.md +515 -0
  27. data/docs/bug-2026-08-31-canvas-bridge-socket-collision.md +83 -0
  28. data/docs/canvas-ipc-session-summary.md +127 -0
  29. data/docs/canvas-panel-workflow.md +172 -0
  30. data/docs/canvas-read.md +147 -0
  31. data/docs/canvas-roadmap.md +275 -0
  32. data/docs/case-studies/2026-09-03-didx-canvas-read-shelf.md +147 -0
  33. data/docs/claude-code-companion-skill-spec.md +567 -0
  34. data/docs/components_reference.md +1223 -0
  35. data/docs/crud-patterns.md +265 -0
  36. data/docs/endpoints.md +122 -0
  37. data/docs/for_llms.md +1 -0
  38. data/docs/form-patterns.md +165 -0
  39. data/docs/frontend-only.md +169 -0
  40. data/docs/html-artifact-audit.md +238 -0
  41. data/docs/ideas/2025-01-01-as-a-service.md +203 -0
  42. data/docs/ideas/2026-01-16-charm-tui-exploration.md +542 -0
  43. data/docs/ideas/2026-08-27-static-doc-shelf-export.md +153 -0
  44. data/docs/ideas/dhh-review-future-refactors.md +142 -0
  45. data/docs/opal-jamstack.md +47 -0
  46. data/docs/opal-npm-direction.md +184 -0
  47. data/docs/opal-spike-findings.md +194 -0
  48. data/docs/plans/2025-12-16-form-blocks-design.md +124 -0
  49. data/docs/plans/2025-12-30-examples-browser-design.md +152 -0
  50. data/docs/plans/2026-01-02-charts-design.md +288 -0
  51. data/docs/plans/2026-01-10-canvas-ipc-design.md +247 -0
  52. data/docs/plans/2026-01-19-cabinet-control-components.md +176 -0
  53. data/docs/plans/2026-01-26-gem-release-and-panel.md +140 -0
  54. data/docs/plans/canvas-claude-project-design.md +238 -0
  55. data/docs/plans/canvas-doc-location-and-discovery.md +32 -0
  56. data/docs/plans/org-doc-preview-surfaces.md +293 -0
  57. data/docs/plans/shadcn-polish-plan.md +417 -0
  58. data/docs/porting-artifacts.md +252 -0
  59. data/docs/reference/agent-skills-comparison.md +369 -0
  60. data/docs/reference/travel-state-prd.artifact.html +780 -0
  61. data/docs/research/2026-08-17-hotwire-alike-landscape.md +268 -0
  62. data/docs/research/2026-08-17-hotwire-concept-map.md +404 -0
  63. data/docs/research/2026-08-22-lazy-fragments-trigger-decision.md +246 -0
  64. data/docs/research/2026-08-22-learnhotwire-syllabus-coverage.md +239 -0
  65. data/docs/research/frontend-only-matrix.md +278 -0
  66. data/docs/research/streamweaver-way-spike-findings.md +529 -0
  67. data/docs/resource-dsl.md +342 -0
  68. data/docs/routing.md +302 -0
  69. data/docs/ruby-ui-comparison.md +319 -0
  70. data/docs/shared-dsl-fragments.md +356 -0
  71. data/docs/streamweaver-for-ai-agents.md +401 -0
  72. data/docs/streamweaver-frontend-vision.md +123 -0
  73. data/docs/streamweaver_canvas/glimmer_initial_final_layer.rb +77 -0
  74. data/docs/streamweaver_canvas/save_example.rb +9 -0
  75. data/docs/templates.md +213 -0
  76. data/docs/testing.md +155 -0
  77. data/docs/theming-hooks.md +281 -0
  78. data/docs/tutorials/the-streamweaver-way.md +882 -0
  79. data/docs/university/capability-inventory.md +137 -0
  80. data/docs/university/dependency-survey.md +114 -0
  81. data/docs/university/design-spec.md +217 -0
  82. data/docs/university/mockups/code-block-doc-theme-dark.png +0 -0
  83. data/docs/university/mockups/code-block-doc-theme-light.png +0 -0
  84. data/docs/university/mockups/course-list-dark.png +0 -0
  85. data/docs/university/mockups/course-list-light.png +0 -0
  86. data/docs/university/mockups/course_canvas_mockup.rb +741 -0
  87. data/docs/university/mockups/step-screen-dark.png +0 -0
  88. data/docs/university/mockups/step-screen-light.png +0 -0
  89. data/docs/university/roadmap.md +72 -0
  90. data/docs/university/send-to-coworker.md +77 -0
  91. data/docs/university/worker-session-mining.md +109 -0
  92. data/docs/visual/browser-rendering-spike.md +173 -0
  93. data/docs/visual/builder-visual-plan-analysis.md +378 -0
  94. data/docs/visual/sw-plan-format-exploration.md +511 -0
  95. data/docs/visual/sw-plan-rendering-deep-dive.md +453 -0
  96. data/docs/visual-skills/PROGRESS.md +60 -0
  97. data/docs/visual-skills/SESSION-CONTEXT.md +207 -0
  98. data/docs/visual-skills/analysis/components.md +317 -0
  99. data/docs/visual-skills/analysis/overlap.md +360 -0
  100. data/docs/visual-skills/analysis/pi-design-deck.md +1102 -0
  101. data/docs/visual-skills/analysis/streamweaver-inventory.md +93 -0
  102. data/docs/visual-skills/analysis/unified-specs.feature +1003 -0
  103. data/docs/visual-skills/analysis/visual-explainer.md +964 -0
  104. data/docs/visual-skills/blog/blog-series-outline.md +39 -0
  105. data/docs/visual-skills/blog/token-efficiency.md +73 -0
  106. data/docs/visual-skills/design/architecture.md +1725 -0
  107. data/docs/visual-skills/design/codex-review.md +340 -0
  108. data/docs/visual-skills/design/dhh-review.md +209 -0
  109. data/docs/visual-skills/design/evolution.md +100 -0
  110. data/docs/visual-skills/design/gemini-review.md +55 -0
  111. data/docs/visual-skills/design/review-synthesis.md +149 -0
  112. data/docs/visual-skills/implementation/STATE.md +22 -0
  113. data/docs/visual-skills/implementation/plan.md +347 -0
  114. data/docs/visual-skills/implementation/spike-findings.md +237 -0
  115. data/docs/visual-skills/implementation/tasks.md +702 -0
  116. data/docs/visual-skills/lessons-learned/process.md +145 -0
  117. data/examples/README.md +96 -0
  118. data/examples/advanced/all_components.rb +177 -0
  119. data/examples/advanced/examples_browser.rb +394 -0
  120. data/examples/advanced/teachables_browser.rb +261 -0
  121. data/examples/advanced/theme_tweaker.rb +366 -0
  122. data/examples/advanced/tutorial.rb +1528 -0
  123. data/examples/agentic/agentic_form.rb +30 -0
  124. data/examples/agentic/agentic_form_autoclose.rb +30 -0
  125. data/examples/agentic/cultivation_tracker.rb +69 -0
  126. data/examples/basic/hello_world.rb +22 -0
  127. data/examples/basic/opal_tabs_table.rb +44 -0
  128. data/examples/basic/todo_list.rb +39 -0
  129. data/examples/button_loading_test.rb +36 -0
  130. data/examples/canvas/mermaid_canvas_demo.sh +151 -0
  131. data/examples/charts/bar_chart_demo.rb +57 -0
  132. data/examples/charts/line_chart_demo.rb +73 -0
  133. data/examples/charts/pie_area_demo.rb +87 -0
  134. data/examples/charts/stacked_bar_chart_demo.rb +69 -0
  135. data/examples/claude_code/README.md +85 -0
  136. data/examples/claude_code/codebreaker/.claude/commands/infiltrate.md +632 -0
  137. data/examples/claude_code/codebreaker/.claude/settings.json +11 -0
  138. data/examples/claude_code/codebreaker/.claude/settings.local.json +17 -0
  139. data/examples/claude_code/codebreaker/.claude/skills/infiltrate.md +0 -0
  140. data/examples/claude_code/codebreaker/README.md +213 -0
  141. data/examples/claude_code/tutorial/.claude/commands/learn.md +453 -0
  142. data/examples/claude_code/tutorial/README.md +102 -0
  143. data/examples/claude_code/verification_flow/.claude/commands/verify.md +171 -0
  144. data/examples/claude_code/verification_flow/README.md +126 -0
  145. data/examples/components/annotated_code_demo.rb +54 -0
  146. data/examples/components/callout_demo.rb +33 -0
  147. data/examples/components/checkbox_group_demo.rb +46 -0
  148. data/examples/components/design_review.css +468 -0
  149. data/examples/components/design_review_demo.rb +44 -0
  150. data/examples/components/design_review_dsl.rb +300 -0
  151. data/examples/components/diff_block_demo.rb +112 -0
  152. data/examples/components/events_demo.rb +184 -0
  153. data/examples/components/form_demo.rb +62 -0
  154. data/examples/components/lesson_demo.rb +53 -0
  155. data/examples/components/markdown_demo.rb +110 -0
  156. data/examples/components/mermaid_demo.rb +166 -0
  157. data/examples/components/pareto_set.rb +64 -0
  158. data/examples/components/prd_demo.rb +21 -0
  159. data/examples/components/prd_dsl.rb +385 -0
  160. data/examples/components/quiz_demo.rb +47 -0
  161. data/examples/components/run_viewer_demo.rb +100 -0
  162. data/examples/components/score_and_collapsible_demo.rb +82 -0
  163. data/examples/components/select_stale_value_smoke_test.rb +39 -0
  164. data/examples/components/table_demo.rb +247 -0
  165. data/examples/components/timer_with_state_demo.rb +58 -0
  166. data/examples/components/todo_due_dates.rb +63 -0
  167. data/examples/components/uat_gaps_demo.rb +112 -0
  168. data/examples/dashboard/feed_simulator.rb +60 -0
  169. data/examples/dashboard/live_dashboard.rb +80 -0
  170. data/examples/dashboard_components.rb +108 -0
  171. data/examples/deferred_fragments_demo.rb +62 -0
  172. data/examples/generate_more_spike/README.md +63 -0
  173. data/examples/generate_more_spike/app.rb +441 -0
  174. data/examples/git_health.sh +401 -0
  175. data/examples/layout/layout_components_demo.rb +174 -0
  176. data/examples/layout/modal_demo.rb +215 -0
  177. data/examples/layout/navigation_demo.rb +227 -0
  178. data/examples/layout/route_tabs_demo.rb +52 -0
  179. data/examples/layout/routing_demo.rb +52 -0
  180. data/examples/layout/scroll_box_demo.rb +154 -0
  181. data/examples/lazy_fragments_demo.rb +151 -0
  182. data/examples/my_todos/README.md +29 -0
  183. data/examples/my_todos/my_todos.rb +312 -0
  184. data/examples/my_todos/store.rb +86 -0
  185. data/examples/opal/reactive_demo.rb +62 -0
  186. data/examples/opal/scenarios/s1_counter.rb +15 -0
  187. data/examples/opal/scenarios/s2_search_filter.rb +17 -0
  188. data/examples/opal/scenarios/s3_sibling_tabs.rb +25 -0
  189. data/examples/opal/scenarios/s4_shopping_cart.rb +34 -0
  190. data/examples/opal/scenarios/s5_watch.rb +39 -0
  191. data/examples/opal/scenarios/s6_on_start.rb +20 -0
  192. data/examples/opal/scenarios/s7_wizard.rb +33 -0
  193. data/examples/opal/scenarios/s8_loan_calculator.rb +21 -0
  194. data/examples/opal/scenarios/s9_dashboard.rb +27 -0
  195. data/examples/operations_dashboard_demo.rb +167 -0
  196. data/examples/panel_demo.sh +447 -0
  197. data/examples/parity/assets/tyrion_slice.css +86 -0
  198. data/examples/parity/rivet_people_slice.rb +182 -0
  199. data/examples/parity/tyrion_components.css +777 -0
  200. data/examples/parity/tyrion_warroom_components.rb +414 -0
  201. data/examples/parity/tyrion_warroom_slice.rb +549 -0
  202. data/examples/puma_dev/README.md +124 -0
  203. data/examples/puma_dev/config.ru +34 -0
  204. data/examples/puma_dev/standalone_app.rb +34 -0
  205. data/examples/scaffolding/blog.rb +49 -0
  206. data/examples/scaffolding/utf_lite.rb +105 -0
  207. data/examples/styling/feedback_demo.rb +229 -0
  208. data/examples/styling/style_showcase.rb +172 -0
  209. data/examples/styling/theme_demo.rb +508 -0
  210. data/examples/timer_health_checker.rb +111 -0
  211. data/examples/timer_showcase.rb +131 -0
  212. data/examples/tutorials/render_markdown.rb +112 -0
  213. data/examples/tutorials/streamweaver_way_tutorial.rb +44 -0
  214. data/examples/tutorials/tutorial_content.rb +1082 -0
  215. data/examples/visual_skills/design_deck_demo.rb +314 -0
  216. data/examples/visual_skills/explainer_demo.rb +499 -0
  217. data/exe/streamweaver +9 -0
  218. data/gsd/ROADMAP-1.0.md +167 -0
  219. data/gsd/STATE.md +13 -0
  220. data/gsd/research/market-positioning-research.md +139 -0
  221. data/gsd/research/production-patterns-research.md +270 -0
  222. data/gsd/research/repo-audit-1.0.md +274 -0
  223. data/lib/stream_weaver/action_token.rb +58 -0
  224. data/lib/stream_weaver/adapter/alpinejs.rb +8249 -0
  225. data/lib/stream_weaver/adapter/base.rb +591 -0
  226. data/lib/stream_weaver/adapter/opal.rb +334 -0
  227. data/lib/stream_weaver/adapter/static.rb +1118 -0
  228. data/lib/stream_weaver/admin.rb +176 -0
  229. data/lib/stream_weaver/app.rb +1821 -0
  230. data/lib/stream_weaver/assets/js/sw-copy.js +50 -0
  231. data/lib/stream_weaver/assets/js/sw-heredoc-rewrite.js +68 -0
  232. data/lib/stream_weaver/assets/js/sw-keyboard.js +165 -0
  233. data/lib/stream_weaver/assets/js/sw-mermaid-zoom.js +621 -0
  234. data/lib/stream_weaver/assets/js/sw-route-tabs.js +53 -0
  235. data/lib/stream_weaver/assets/js/sw-sidebar-toc.js +116 -0
  236. data/lib/stream_weaver/assets/js/sw-slide-nav.js +103 -0
  237. data/lib/stream_weaver/canvas/bridge.rb +239 -0
  238. data/lib/stream_weaver/canvas/bridge_server.rb +646 -0
  239. data/lib/stream_weaver/canvas/client.rb +298 -0
  240. data/lib/stream_weaver/canvas/doc_roots.rb +233 -0
  241. data/lib/stream_weaver/canvas/doc_store.rb +252 -0
  242. data/lib/stream_weaver/canvas/gist_publisher.rb +264 -0
  243. data/lib/stream_weaver/canvas/gist_save_handler.rb +89 -0
  244. data/lib/stream_weaver/canvas/gist_store.rb +135 -0
  245. data/lib/stream_weaver/canvas/helpers.rb +109 -0
  246. data/lib/stream_weaver/canvas/history.rb +90 -0
  247. data/lib/stream_weaver/canvas/protocol.rb +86 -0
  248. data/lib/stream_weaver/canvas/reader.rb +853 -0
  249. data/lib/stream_weaver/canvas/save_doc_widget.rb +457 -0
  250. data/lib/stream_weaver/canvas/scroll_top_hint.rb +21 -0
  251. data/lib/stream_weaver/canvas/session.rb +132 -0
  252. data/lib/stream_weaver/cli.rb +3235 -0
  253. data/lib/stream_weaver/component_assets.rb +70 -0
  254. data/lib/stream_weaver/component_registry.rb +67 -0
  255. data/lib/stream_weaver/component_renderer.rb +48 -0
  256. data/lib/stream_weaver/components/annotated_code.rb +53 -0
  257. data/lib/stream_weaver/components/api_endpoint.rb +42 -0
  258. data/lib/stream_weaver/components/callout.rb +59 -0
  259. data/lib/stream_weaver/components/chart.rb +84 -0
  260. data/lib/stream_weaver/components/code_block.rb +77 -0
  261. data/lib/stream_weaver/components/comparison.rb +39 -0
  262. data/lib/stream_weaver/components/decision.rb +38 -0
  263. data/lib/stream_weaver/components/deck/close_overlay.rb +84 -0
  264. data/lib/stream_weaver/components/deck/confirmation_bar.rb +60 -0
  265. data/lib/stream_weaver/components/deck/deck_option.rb +61 -0
  266. data/lib/stream_weaver/components/deck/deck_slide.rb +77 -0
  267. data/lib/stream_weaver/components/deck/deck_state.rb +469 -0
  268. data/lib/stream_weaver/components/deck/deck_summary.rb +73 -0
  269. data/lib/stream_weaver/components/deck/design_deck.rb +60 -0
  270. data/lib/stream_weaver/components/deck/generate_more_controls.rb +84 -0
  271. data/lib/stream_weaver/components/deck/model_selector.rb +84 -0
  272. data/lib/stream_weaver/components/deck/skeleton_placeholder.rb +36 -0
  273. data/lib/stream_weaver/components/diff_block.rb +125 -0
  274. data/lib/stream_weaver/components/doc_header.rb +57 -0
  275. data/lib/stream_weaver/components/image_block.rb +70 -0
  276. data/lib/stream_weaver/components/implementation_map.rb +33 -0
  277. data/lib/stream_weaver/components/keyboard_shortcuts.rb +94 -0
  278. data/lib/stream_weaver/components/kpi_dashboard.rb +78 -0
  279. data/lib/stream_weaver/components/mermaid.rb +79 -0
  280. data/lib/stream_weaver/components/pipeline.rb +63 -0
  281. data/lib/stream_weaver/components/sidebar_toc.rb +46 -0
  282. data/lib/stream_weaver/components/slide_container.rb +141 -0
  283. data/lib/stream_weaver/components/timeline_event.rb +58 -0
  284. data/lib/stream_weaver/components/wireframe.rb +29 -0
  285. data/lib/stream_weaver/components/wireframe_block.rb +34 -0
  286. data/lib/stream_weaver/components.rb +2711 -0
  287. data/lib/stream_weaver/css.rb +230 -0
  288. data/lib/stream_weaver/dev_fallback_overlay.rb +61 -0
  289. data/lib/stream_weaver/display_dsl.rb +1004 -0
  290. data/lib/stream_weaver/export/html_exporter.rb +478 -0
  291. data/lib/stream_weaver/feed.rb +34 -0
  292. data/lib/stream_weaver/feed_builder.rb +31 -0
  293. data/lib/stream_weaver/fonts.rb +33 -0
  294. data/lib/stream_weaver/interaction_runner.rb +487 -0
  295. data/lib/stream_weaver/iterm.rb +460 -0
  296. data/lib/stream_weaver/layout_registry.rb +92 -0
  297. data/lib/stream_weaver/opal/bridge.rb +52 -0
  298. data/lib/stream_weaver/opal/builder.rb +193 -0
  299. data/lib/stream_weaver/opal/env.rb +29 -0
  300. data/lib/stream_weaver/opal/reactive_state.rb +75 -0
  301. data/lib/stream_weaver/opal/regexp_anchor_patch.rb +62 -0
  302. data/lib/stream_weaver/opal/renderer.rb +77 -0
  303. data/lib/stream_weaver/opal/runtime.rb +250 -0
  304. data/lib/stream_weaver/opal/shell.rb +145 -0
  305. data/lib/stream_weaver/opal/string_bridge.rb +50 -0
  306. data/lib/stream_weaver/opal/stubs/diff.min.js +1 -0
  307. data/lib/stream_weaver/opal/stubs/digest.rb +15 -0
  308. data/lib/stream_weaver/opal/stubs/marked.umd.js +79 -0
  309. data/lib/stream_weaver/opal/stubs/md5.rb +3 -0
  310. data/lib/stream_weaver/opal/stubs/morphdom.min.js +775 -0
  311. data/lib/stream_weaver/opal/stubs/prism-tomorrow.min.css +1 -0
  312. data/lib/stream_weaver/opal/stubs/prism.min.js +1967 -0
  313. data/lib/stream_weaver/opal_entry.rb +136 -0
  314. data/lib/stream_weaver/org/inline.rb +95 -0
  315. data/lib/stream_weaver/org/reader.rb +561 -0
  316. data/lib/stream_weaver/org/recording_context.rb +86 -0
  317. data/lib/stream_weaver/org/source_splitter.rb +63 -0
  318. data/lib/stream_weaver/org/writer.rb +300 -0
  319. data/lib/stream_weaver/page_shell.rb +530 -0
  320. data/lib/stream_weaver/portfile.rb +79 -0
  321. data/lib/stream_weaver/pushable.rb +42 -0
  322. data/lib/stream_weaver/resource/default_views.rb +111 -0
  323. data/lib/stream_weaver/resource/field_input.rb +25 -0
  324. data/lib/stream_weaver/resource/state_keys.rb +16 -0
  325. data/lib/stream_weaver/resource/store.rb +18 -0
  326. data/lib/stream_weaver/resource.rb +104 -0
  327. data/lib/stream_weaver/server.rb +1471 -0
  328. data/lib/stream_weaver/service.rb +1240 -0
  329. data/lib/stream_weaver/service_client.rb +104 -0
  330. data/lib/stream_weaver/session_store.rb +186 -0
  331. data/lib/stream_weaver/skills/streamweaver-canvas-safe/SKILL.md +66 -0
  332. data/lib/stream_weaver/skills/streamweaver-canvas-safe/examples/canvas-safe-showcase.rb +98 -0
  333. data/lib/stream_weaver/skills/streamweaver-canvas-safe/references/actions-and-buttons.md +47 -0
  334. data/lib/stream_weaver/skills/streamweaver-canvas-safe/references/charts-and-diagrams.md +38 -0
  335. data/lib/stream_weaver/skills/streamweaver-canvas-safe/references/deck.md +32 -0
  336. data/lib/stream_weaver/skills/streamweaver-canvas-safe/references/inputs-and-forms.md +65 -0
  337. data/lib/stream_weaver/skills/streamweaver-canvas-safe/references/tabs-and-navigation.md +53 -0
  338. data/lib/stream_weaver/skills/streamweaver-doc-builder/SKILL.md +298 -0
  339. data/lib/stream_weaver/skills/streamweaver-visual-companion/SKILL.md +130 -0
  340. data/lib/stream_weaver/skills/streamweaver-visual-companion/examples/design-review-example.css +468 -0
  341. data/lib/stream_weaver/skills/streamweaver-visual-companion/examples/design-review-example.rb +39 -0
  342. data/lib/stream_weaver/skills/streamweaver-visual-companion/examples/design-review-example_dsl.rb +300 -0
  343. data/lib/stream_weaver/skills/streamweaver-visual-companion/examples/doc-parity-example.rb +24 -0
  344. data/lib/stream_weaver/skills/streamweaver-visual-companion/examples/doc-parity-example_dsl.rb +385 -0
  345. data/lib/stream_weaver/skills/streamweaver-visual-companion/references/checkpoints-and-forms.md +28 -0
  346. data/lib/stream_weaver/skills/streamweaver-visual-companion/references/cleanup-and-panel.md +44 -0
  347. data/lib/stream_weaver/skills/streamweaver-visual-companion/references/example-gallery.md +8 -0
  348. data/lib/stream_weaver/skills/streamweaver-visual-companion/references/persistence.md +58 -0
  349. data/lib/stream_weaver/skills/streamweaver-way/SKILL.md +396 -0
  350. data/lib/stream_weaver/skills/visual-plan/SKILL.md +201 -0
  351. data/lib/stream_weaver/skills/visual-recap/SKILL.md +244 -0
  352. data/lib/stream_weaver/streamer.rb +63 -0
  353. data/lib/stream_weaver/templates/choices.rb +149 -0
  354. data/lib/stream_weaver/templates/code.rb +157 -0
  355. data/lib/stream_weaver/templates/confirm.rb +110 -0
  356. data/lib/stream_weaver/templates/diff.rb +195 -0
  357. data/lib/stream_weaver/templates/info.rb +142 -0
  358. data/lib/stream_weaver/templates/table.rb +169 -0
  359. data/lib/stream_weaver/templates/wizard.rb +271 -0
  360. data/lib/stream_weaver/theme/auto_mode.rb +116 -0
  361. data/lib/stream_weaver/theme/presets.rb +555 -0
  362. data/lib/stream_weaver/theme.rb +639 -0
  363. data/lib/stream_weaver/university/canvas.rb +924 -0
  364. data/lib/stream_weaver/university/course.rb +699 -0
  365. data/lib/stream_weaver/university/demos/counter.rb +33 -0
  366. data/lib/stream_weaver/university/demos/dashboard.rb +147 -0
  367. data/lib/stream_weaver/university/demos/decision_form.rb +143 -0
  368. data/lib/stream_weaver/university/demos.rb +50 -0
  369. data/lib/stream_weaver/university/listener.rb +467 -0
  370. data/lib/stream_weaver/university/progress.rb +201 -0
  371. data/lib/stream_weaver/university/runner.rb +138 -0
  372. data/lib/stream_weaver/university/scripts/growing_doc.rb +609 -0
  373. data/lib/stream_weaver/university/scripts/growing_doc_state.rb +91 -0
  374. data/lib/stream_weaver/utils.rb +31 -0
  375. data/lib/stream_weaver/version.rb +5 -0
  376. data/lib/stream_weaver/views/canvas/reader_layout.erb +800 -0
  377. data/lib/stream_weaver/views.rb +3940 -0
  378. data/lib/stream_weaver.rb +122 -0
  379. data/llms.txt +1269 -0
  380. data/sig/stream_weaver.rbs +4 -0
  381. metadata +598 -0
@@ -0,0 +1,366 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative '../../lib/stream_weaver'
4
+
5
+ # StreamWeaver Theme Tweaker
6
+ # A visual editor for creating and customizing themes
7
+ #
8
+ # Note: Edit values in the controls, then click "Update Preview" to see changes.
9
+ # This avoids flashing from constant re-renders on every keystroke.
10
+
11
+ app = StreamWeaver::App.new("StreamWeaver Theme Tweaker", layout: :fluid, theme: :dashboard) do
12
+ # Initialize state
13
+ state[:theme_name] ||= "my_custom_theme"
14
+ state[:base_theme] ||= "default"
15
+ state[:export_format] ||= "ruby"
16
+ state[:show_export] ||= false
17
+
18
+ # Preview values (what's currently shown in preview)
19
+ # These only update when "Update Preview" is clicked
20
+ state[:preview] ||= {
21
+ font_family: "'Source Sans 3', system-ui, sans-serif",
22
+ font_size_base: "17px",
23
+ line_height: "1.7",
24
+ color_primary: "#c2410c",
25
+ color_primary_hover: "#9a3412",
26
+ color_text: "#111111",
27
+ color_text_muted: "#444444",
28
+ color_bg: "#f8f8f8",
29
+ color_bg_card: "#ffffff",
30
+ color_border: "#e0e0e0",
31
+ spacing_md: "1.25rem",
32
+ radius_md: "6px",
33
+ card_border_left: "3px solid #c2410c"
34
+ }
35
+
36
+ # Form values (what's being edited)
37
+ state[:font_family] ||= state[:preview][:font_family]
38
+ state[:font_size_base] ||= state[:preview][:font_size_base]
39
+ state[:line_height] ||= state[:preview][:line_height]
40
+ state[:color_primary] ||= state[:preview][:color_primary]
41
+ state[:color_primary_hover] ||= state[:preview][:color_primary_hover]
42
+ state[:color_text] ||= state[:preview][:color_text]
43
+ state[:color_text_muted] ||= state[:preview][:color_text_muted]
44
+ state[:color_bg] ||= state[:preview][:color_bg]
45
+ state[:color_bg_card] ||= state[:preview][:color_bg_card]
46
+ state[:color_border] ||= state[:preview][:color_border]
47
+ state[:spacing_md] ||= state[:preview][:spacing_md]
48
+ state[:radius_md] ||= state[:preview][:radius_md]
49
+ state[:card_border_left] ||= state[:preview][:card_border_left]
50
+
51
+ hstack(justify: :between, align: :center) do
52
+ header1 "Theme Tweaker"
53
+ button "Update Preview" do |s|
54
+ # Copy form values to preview
55
+ s[:preview] = {
56
+ font_family: s[:font_family],
57
+ font_size_base: s[:font_size_base],
58
+ line_height: s[:line_height],
59
+ color_primary: s[:color_primary],
60
+ color_primary_hover: s[:color_primary_hover],
61
+ color_text: s[:color_text],
62
+ color_text_muted: s[:color_text_muted],
63
+ color_bg: s[:color_bg],
64
+ color_bg_card: s[:color_bg_card],
65
+ color_border: s[:color_border],
66
+ spacing_md: s[:spacing_md],
67
+ radius_md: s[:radius_md],
68
+ card_border_left: s[:card_border_left]
69
+ }
70
+ end
71
+ end
72
+
73
+ text "Edit theme values below, then click 'Update Preview' to see changes. Export when ready."
74
+
75
+ columns widths: ["340px", "1fr"] do
76
+ # Left column: Controls
77
+ column do
78
+ card do
79
+ card_header "Theme Settings"
80
+ card_body do
81
+ text "Theme Name"
82
+ text_field :theme_name, placeholder: "my_custom_theme"
83
+
84
+ text "Base Theme"
85
+ select :base_theme, %w[default dashboard document]
86
+
87
+ hstack do
88
+ button "Load Base Theme", style: :secondary do |s|
89
+ # Reset to base theme defaults (convert to string for comparison)
90
+ base = s[:base_theme].to_s
91
+ case base
92
+ when "default"
93
+ s[:font_family] = "'Source Sans 3', system-ui, sans-serif"
94
+ s[:font_size_base] = "17px"
95
+ s[:line_height] = "1.7"
96
+ s[:color_primary] = "#c2410c"
97
+ s[:color_primary_hover] = "#9a3412"
98
+ s[:color_text] = "#111111"
99
+ s[:color_text_muted] = "#444444"
100
+ s[:color_bg] = "#f8f8f8"
101
+ s[:color_bg_card] = "#ffffff"
102
+ s[:color_border] = "#e0e0e0"
103
+ s[:spacing_md] = "1.25rem"
104
+ s[:radius_md] = "6px"
105
+ s[:card_border_left] = "3px solid #c2410c"
106
+ when "dashboard"
107
+ s[:font_family] = "'Source Sans 3', system-ui, sans-serif"
108
+ s[:font_size_base] = "15px"
109
+ s[:line_height] = "1.5"
110
+ s[:color_primary] = "#c2410c"
111
+ s[:color_primary_hover] = "#9a3412"
112
+ s[:color_text] = "#111111"
113
+ s[:color_text_muted] = "#555555"
114
+ s[:color_bg] = "#fafafa"
115
+ s[:color_bg_card] = "#ffffff"
116
+ s[:color_border] = "#e5e5e5"
117
+ s[:spacing_md] = "0.875rem"
118
+ s[:radius_md] = "4px"
119
+ s[:card_border_left] = "1px solid #e5e5e5"
120
+ when "document"
121
+ s[:font_family] = "'Crimson Pro', Georgia, serif"
122
+ s[:font_size_base] = "19px"
123
+ s[:line_height] = "1.85"
124
+ s[:color_primary] = "#6b7280"
125
+ s[:color_primary_hover] = "#4b5563"
126
+ s[:color_text] = "#1a1a1a"
127
+ s[:color_text_muted] = "#4a4a4a"
128
+ s[:color_bg] = "#faf8f5"
129
+ s[:color_bg_card] = "#ffffff"
130
+ s[:color_border] = "#e8e4df"
131
+ s[:spacing_md] = "1.5rem"
132
+ s[:radius_md] = "8px"
133
+ s[:card_border_left] = "none"
134
+ end
135
+ # Also update preview immediately
136
+ s[:preview] = {
137
+ font_family: s[:font_family],
138
+ font_size_base: s[:font_size_base],
139
+ line_height: s[:line_height],
140
+ color_primary: s[:color_primary],
141
+ color_primary_hover: s[:color_primary_hover],
142
+ color_text: s[:color_text],
143
+ color_text_muted: s[:color_text_muted],
144
+ color_bg: s[:color_bg],
145
+ color_bg_card: s[:color_bg_card],
146
+ color_border: s[:color_border],
147
+ spacing_md: s[:spacing_md],
148
+ radius_md: s[:radius_md],
149
+ card_border_left: s[:card_border_left]
150
+ }
151
+ end
152
+ end
153
+ end
154
+ end
155
+
156
+ collapsible "Typography", expanded: true do
157
+ text "Font Family"
158
+ text_field :font_family, placeholder: "'Source Sans 3', system-ui, sans-serif", submit: false
159
+
160
+ text "Base Font Size"
161
+ text_field :font_size_base, placeholder: "17px", submit: false
162
+
163
+ text "Line Height"
164
+ text_field :line_height, placeholder: "1.7", submit: false
165
+ end
166
+
167
+ collapsible "Colors", expanded: true do
168
+ text "Primary Color"
169
+ text_field :color_primary, placeholder: "#c2410c", submit: false
170
+
171
+ text "Primary Hover"
172
+ text_field :color_primary_hover, placeholder: "#9a3412", submit: false
173
+
174
+ text "Text Color"
175
+ text_field :color_text, placeholder: "#111111", submit: false
176
+
177
+ text "Muted Text"
178
+ text_field :color_text_muted, placeholder: "#444444", submit: false
179
+
180
+ text "Background"
181
+ text_field :color_bg, placeholder: "#f8f8f8", submit: false
182
+
183
+ text "Card Background"
184
+ text_field :color_bg_card, placeholder: "#ffffff", submit: false
185
+
186
+ text "Border Color"
187
+ text_field :color_border, placeholder: "#e0e0e0", submit: false
188
+ end
189
+
190
+ collapsible "Spacing & Borders" do
191
+ text "Spacing (md)"
192
+ text_field :spacing_md, placeholder: "1.25rem", submit: false
193
+
194
+ text "Border Radius (md)"
195
+ text_field :radius_md, placeholder: "6px", submit: false
196
+
197
+ text "Card Left Border"
198
+ text_field :card_border_left, placeholder: "3px solid #c2410c", submit: false
199
+ end
200
+
201
+ card do
202
+ card_header "Export"
203
+ card_body do
204
+ select :export_format, %w[ruby json]
205
+
206
+ button "Generate Export" do |s|
207
+ s[:show_export] = true
208
+ end
209
+ end
210
+ end
211
+ end
212
+
213
+ # Right column: Preview
214
+ column do
215
+ # Get preview values
216
+ pv = state[:preview]
217
+
218
+ # Build inline style string with CSS variable overrides
219
+ preview_style = [
220
+ "--sw-font-family: #{pv[:font_family]}",
221
+ "--sw-font-body: #{pv[:font_family]}",
222
+ "--sw-font-size-base: #{pv[:font_size_base]}",
223
+ "--sw-line-height: #{pv[:line_height]}",
224
+ "--sw-color-primary: #{pv[:color_primary]}",
225
+ "--sw-color-primary-hover: #{pv[:color_primary_hover]}",
226
+ "--sw-color-text: #{pv[:color_text]}",
227
+ "--sw-color-text-muted: #{pv[:color_text_muted]}",
228
+ "--sw-color-bg: #{pv[:color_bg]}",
229
+ "--sw-color-bg-card: #{pv[:color_bg_card]}",
230
+ "--sw-color-border: #{pv[:color_border]}",
231
+ "--sw-spacing-md: #{pv[:spacing_md]}",
232
+ "--sw-radius-md: #{pv[:radius_md]}",
233
+ "--sw-card-border-left: #{pv[:card_border_left]}",
234
+ "padding: 1.5rem",
235
+ "background: #{pv[:color_bg]}",
236
+ "border-radius: 8px",
237
+ "border: 1px solid #{pv[:color_border]}"
238
+ ].join("; ")
239
+
240
+ # Preview container with CSS variable overrides
241
+ div(style: preview_style) do
242
+ header2 "Live Preview"
243
+
244
+ text "Compare spacing, font size, and density between themes."
245
+
246
+ # Data metrics row - shows density differences
247
+ header3 "Data Metrics"
248
+ grid cols: 3 do
249
+ card do
250
+ card_body do
251
+ text "Users"
252
+ header3 "1,234"
253
+ text "+12% from last week"
254
+ end
255
+ end
256
+ card do
257
+ card_body do
258
+ text "Revenue"
259
+ header3 "$45.6K"
260
+ text "+8% from last week"
261
+ end
262
+ end
263
+ card do
264
+ card_body do
265
+ text "Orders"
266
+ header3 "892"
267
+ text "+23% from last week"
268
+ end
269
+ end
270
+ end
271
+
272
+ # Typography comparison
273
+ header3 "Typography & Spacing"
274
+ text "Regular paragraph text. Notice how font size and line height affect readability and density."
275
+ text "A second paragraph shows vertical spacing between text blocks. Dashboard theme uses tighter spacing for data scanning."
276
+
277
+ # Cards with different content
278
+ header3 "Card Borders"
279
+ hstack do
280
+ card do
281
+ card_header "Card with Header"
282
+ card_body do
283
+ text "Notice the left border accent style."
284
+ end
285
+ end
286
+ card do
287
+ card_body do
288
+ text "Card without header, just body content with padding."
289
+ end
290
+ end
291
+ end
292
+
293
+ # Form elements stacked to show spacing (submit: false to prevent HTMX flashing)
294
+ header3 "Form Elements"
295
+ vstack do
296
+ text_field :preview_name, placeholder: "Name", submit: false
297
+ text_field :preview_email, placeholder: "Email", submit: false
298
+ select :preview_role, %w[Admin User Guest], submit: false
299
+ checkbox :preview_active, "Active account", submit: false
300
+ hstack do
301
+ button "Submit", submit: false
302
+ button "Cancel", style: :secondary, submit: false
303
+ end
304
+ end
305
+
306
+ # Alerts stacked
307
+ header3 "Alerts"
308
+ alert(variant: :info) { text "Info message" }
309
+ alert(variant: :success) { text "Success message" }
310
+ alert(variant: :warning) { text "Warning message" }
311
+
312
+ header3 "Progress"
313
+ progress_bar value: 65, show_label: true
314
+ progress_bar value: 30, variant: :success
315
+ end
316
+
317
+ # Export code display
318
+ if state[:show_export]
319
+ header3 "Export Code"
320
+
321
+ variables = {
322
+ font_family: state[:font_family],
323
+ font_size_base: state[:font_size_base],
324
+ line_height: state[:line_height],
325
+ color_primary: state[:color_primary],
326
+ color_primary_hover: state[:color_primary_hover],
327
+ color_text: state[:color_text],
328
+ color_text_muted: state[:color_text_muted],
329
+ color_bg: state[:color_bg],
330
+ color_bg_card: state[:color_bg_card],
331
+ color_border: state[:color_border],
332
+ spacing_md: state[:spacing_md],
333
+ radius_md: state[:radius_md],
334
+ card_border_left: state[:card_border_left]
335
+ }
336
+
337
+ export_code = if state[:export_format] == "ruby"
338
+ vars = variables.map { |k, v| " #{k}: #{v.inspect}" }.join(",\n")
339
+ <<~RUBY
340
+ # Add this to your app file before creating the app
341
+ StreamWeaver.register_theme :#{state[:theme_name]}, {
342
+ #{vars}
343
+ }, base: :#{state[:base_theme]}, label: "#{state[:theme_name].split('_').map(&:capitalize).join(' ')}", description: "Custom theme"
344
+
345
+ # Then use it in your app:
346
+ app "My App", theme: :#{state[:theme_name]} do
347
+ # ...
348
+ end
349
+ RUBY
350
+ else
351
+ JSON.pretty_generate({
352
+ name: state[:theme_name],
353
+ label: state[:theme_name].split('_').map(&:capitalize).join(' '),
354
+ description: "Custom theme",
355
+ base_theme: state[:base_theme],
356
+ variables: variables
357
+ })
358
+ end
359
+
360
+ text_area :export_output, rows: 18, default: export_code
361
+ end
362
+ end
363
+ end
364
+ end
365
+
366
+ app.generate.run!