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
data/lib/stream_weaver/page_shell.rb ADDED
@@ -0,0 +1,530 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "css"
4
+ require_relative "views"
5
+ require_relative "theme"
6
+
7
+ module StreamWeaver
8
+ # Framework-CSS <head> block, shared by all three renderers that need the
9
+ # same cascade order: the canvas (Canvas::BridgeServer), the reader
10
+ # (Canvas::Reader / reader_layout.erb), and static exports
11
+ # (Export::HtmlExporter). Extracted from BridgeServer#render_canvas_page,
12
+ # which was the correct reference implementation (stream_weaver-oeo fixed
13
+ # its cascade-layer bug: CANVAS_CSS must be layer-wrapped alongside
14
+ # master_theme_css/visual_skills_css, or it silently outranks them) --
15
+ # extracting it here is what lets the other two call the same ordering
16
+ # instead of re-deriving it (stream_weaver-mdc).
17
+ #
18
+ # Deliberately narrow scope: only the framework <style> blocks plus
19
+ # optional user CSS. Body-class computation (session theme overrides,
20
+ # chrome: false, exclusive-layout registry entries), <title>/favicon, CDN
21
+ # scripts, and chrome/widgets all stay with each caller -- this is NOT a
22
+ # canonical replacement for AppView's full standalone shell.
23
+ module PageShell
24
+ # Canvas-specific CSS -- moved verbatim from Canvas::BridgeServer's old
25
+ # SW_STYLES constant when this module was extracted (stream_weaver-39j).
26
+ CANVAS_CSS = <<~CSS
27
+ /* Note: --sw-color and --sw-spacing family tokens are intentionally
28
+ NOT declared at :root here -- they come from AppView.master_theme_css's
29
+ body.sw-theme-{name} block, which is always rendered alongside this
30
+ constant (see render_canvas_page). A :root-level declaration would be
31
+ visible to getComputedStyle(document.documentElement), shadowing the
32
+ body-scoped theme-aware value (and its dark variant) that things like
33
+ sw-mermaid-zoom.js's getThemeVariables() read directly off <html>. */
34
+
35
+ /* Base styles */
36
+ *, *::before, *::after { box-sizing: border-box; }
37
+ body {
38
+ font-family: 'Source Sans 3', system-ui, sans-serif;
39
+ font-size: 17px;
40
+ line-height: 1.7;
41
+ margin: 0;
42
+ padding: var(--sw-spacing-md);
43
+ background: var(--sw-color-bg);
44
+ color: var(--sw-color-text);
45
+ }
46
+ #app-container {
47
+ margin: 0 auto;
48
+ background: var(--sw-color-bg-card);
49
+ border-radius: var(--sw-radius-md);
50
+ padding: var(--sw-spacing-lg);
51
+ box-shadow: var(--sw-shadow-sm);
52
+ }
53
+ body.sw-layout-default #app-container { max-width: 900px; }
54
+ body.sw-layout-wide #app-container { max-width: 1100px; }
55
+ body.sw-layout-full #app-container { max-width: 1400px; }
56
+ body.sw-layout-fluid #app-container { max-width: 100%; }
57
+ h1, h2, h3, h4, h5, h6 { margin: 0 0 var(--sw-spacing-md) 0; line-height: 1.3; }
58
+ h1 { font-size: 2rem; }
59
+ h2 { font-size: 1.5rem; }
60
+ h3 { font-size: 1.25rem; }
61
+ p { margin: 0 0 var(--sw-spacing-md) 0; }
62
+ hr { border: none; border-top: 1px solid var(--sw-color-border); margin: var(--sw-spacing-lg) 0; }
63
+
64
+ /* Card component */
65
+ .card {
66
+ background: var(--sw-color-bg-card);
67
+ border: 1px solid var(--sw-color-border);
68
+ border-left: var(--sw-card-border-left);
69
+ border-radius: var(--sw-radius-md);
70
+ padding: var(--sw-spacing-lg);
71
+ margin-bottom: var(--sw-spacing-md);
72
+ box-shadow: var(--sw-shadow-sm);
73
+ }
74
+ .card h3 {
75
+ margin-top: 0;
76
+ margin-bottom: var(--sw-spacing-sm);
77
+ color: var(--sw-color-text);
78
+ }
79
+ .card-header {
80
+ padding-bottom: var(--sw-spacing-sm);
81
+ margin-bottom: var(--sw-spacing-md);
82
+ border-bottom: 1px solid var(--sw-color-border);
83
+ }
84
+ .card-header h1, .card-header h2, .card-header h3,
85
+ .card-header h4, .card-header h5, .card-header h6 { margin: 0; }
86
+ .card-body > *:first-child { margin-top: 0; }
87
+ .card-body > *:last-child { margin-bottom: 0; }
88
+ .card-footer {
89
+ padding-top: var(--sw-spacing-sm);
90
+ margin-top: var(--sw-spacing-md);
91
+ border-top: 1px solid var(--sw-color-border);
92
+ display: flex;
93
+ justify-content: flex-end;
94
+ gap: var(--sw-spacing-sm);
95
+ }
96
+ .card-footer button { margin: 0; }
97
+
98
+ /* Columns layout */
99
+ .sw-columns {
100
+ display: flex;
101
+ gap: var(--sw-spacing-lg);
102
+ margin-bottom: var(--sw-spacing-md);
103
+ }
104
+ .sw-column { flex: 1; min-width: 0; }
105
+ @media (max-width: 768px) {
106
+ .sw-columns { flex-direction: column; }
107
+ }
108
+
109
+ /* Buttons */
110
+ .btn {
111
+ display: inline-block;
112
+ padding: 10px 20px;
113
+ border: none;
114
+ border-radius: var(--sw-radius-md);
115
+ cursor: pointer;
116
+ font-size: 16px;
117
+ font-weight: 500;
118
+ transition: background-color 150ms ease;
119
+ }
120
+ .btn:hover { filter: brightness(0.95); }
121
+ .btn-primary {
122
+ background: var(--sw-color-primary);
123
+ color: white;
124
+ }
125
+ .btn-primary:hover { background: var(--sw-color-primary-hover); }
126
+ .btn-secondary {
127
+ background: #e5e5e5;
128
+ color: var(--sw-color-text);
129
+ }
130
+ .btn-secondary:hover { background: #d5d5d5; }
131
+
132
+ /* Form elements */
133
+ .radio-group { display: flex; flex-direction: column; gap: 8px; margin-bottom: var(--sw-spacing-md); }
134
+ .radio-option { display: flex; align-items: center; gap: 8px; cursor: pointer; }
135
+ .checkbox-wrapper { display: flex; align-items: flex-start; gap: 8px; margin-bottom: var(--sw-spacing-sm); }
136
+ .checkbox-wrapper input[type="checkbox"] {
137
+ width: 18px;
138
+ height: 18px;
139
+ margin: 2px 0 0 0;
140
+ cursor: pointer;
141
+ }
142
+ .checkbox-wrapper label { cursor: pointer; flex: 1; }
143
+ input[type="text"], textarea {
144
+ width: 100%;
145
+ padding: 10px;
146
+ border: 1px solid var(--sw-color-border);
147
+ border-radius: var(--sw-radius-md);
148
+ font-size: 16px;
149
+ box-sizing: border-box;
150
+ }
151
+ input[type="text"]:focus, textarea:focus {
152
+ outline: none;
153
+ border-color: var(--sw-color-primary);
154
+ box-shadow: 0 0 0 2px var(--sw-color-primary-light);
155
+ }
156
+
157
+ /* Markdown rendering */
158
+ strong, b { font-weight: 600; }
159
+ code {
160
+ background: var(--sw-color-bg-elevated);
161
+ padding: 2px 6px;
162
+ border-radius: var(--sw-radius-sm);
163
+ font-size: 0.9em;
164
+ }
165
+
166
+ /* Canvas waiting state */
167
+ .sw-canvas-waiting {
168
+ text-align: center;
169
+ padding: 60px 40px;
170
+ color: #666;
171
+ }
172
+ .sw-canvas-logo {
173
+ color: var(--sw-color-primary);
174
+ margin-bottom: 16px;
175
+ }
176
+ .sw-canvas-waiting h1 {
177
+ font-size: 24px;
178
+ font-weight: 600;
179
+ color: var(--sw-color-text);
180
+ margin-bottom: 24px;
181
+ }
182
+ .sw-canvas-spinner {
183
+ width: 40px;
184
+ height: 40px;
185
+ border: 3px solid #e0e0e0;
186
+ border-top-color: var(--sw-color-primary);
187
+ border-radius: 50%;
188
+ margin: 0 auto 20px;
189
+ animation: sw-spin 1s linear infinite;
190
+ }
191
+ @keyframes sw-spin {
192
+ to { transform: rotate(360deg); }
193
+ }
194
+ @keyframes sw-toast-in {
195
+ from { opacity: 0; transform: translateX(-50%) translateY(-20px); }
196
+ to { opacity: 1; transform: translateX(-50%) translateY(0); }
197
+ }
198
+ .sw-canvas-status {
199
+ font-size: 18px;
200
+ color: #444;
201
+ margin-bottom: 24px;
202
+ }
203
+ .sw-canvas-info { margin-bottom: 32px; }
204
+ .sw-canvas-session code {
205
+ background: #f0f0f0;
206
+ padding: 4px 12px;
207
+ border-radius: 4px;
208
+ font-size: 14px;
209
+ font-weight: 500;
210
+ }
211
+ .sw-canvas-ready {
212
+ font-size: 14px;
213
+ color: #888;
214
+ margin-top: 8px;
215
+ }
216
+ .sw-canvas-tip {
217
+ background: #f8f8f8;
218
+ border-radius: 8px;
219
+ padding: 16px;
220
+ margin-top: 24px;
221
+ }
222
+ .sw-canvas-tip p {
223
+ margin: 0 0 8px 0;
224
+ font-size: 14px;
225
+ color: #666;
226
+ }
227
+ .sw-canvas-tip code {
228
+ display: block;
229
+ background: #fff;
230
+ border: 1px solid #e0e0e0;
231
+ padding: 8px 12px;
232
+ border-radius: 4px;
233
+ font-size: 13px;
234
+ color: #333;
235
+ }
236
+
237
+ /* Progress bar */
238
+ .sw-progress {
239
+ width: 100%;
240
+ height: 20px;
241
+ background: #e5e7eb;
242
+ border-radius: 10px;
243
+ overflow: hidden;
244
+ position: relative;
245
+ margin-bottom: var(--sw-spacing-md);
246
+ }
247
+ .sw-progress-bar {
248
+ height: 100%;
249
+ background: var(--sw-color-primary);
250
+ border-radius: 10px;
251
+ transition: width 0.3s ease;
252
+ }
253
+ .sw-progress-label {
254
+ position: absolute;
255
+ top: 50%;
256
+ left: 50%;
257
+ transform: translate(-50%, -50%);
258
+ font-size: 12px;
259
+ font-weight: 600;
260
+ color: #333;
261
+ }
262
+ .sw-progress-success .sw-progress-bar { background: #10b981; }
263
+ .sw-progress-warning .sw-progress-bar { background: #f59e0b; }
264
+ .sw-progress-error .sw-progress-bar { background: #ef4444; }
265
+ .sw-progress-animated .sw-progress-bar {
266
+ background-image: linear-gradient(
267
+ 45deg, rgba(255,255,255,0.15) 25%, transparent 25%,
268
+ transparent 50%, rgba(255,255,255,0.15) 50%,
269
+ rgba(255,255,255,0.15) 75%, transparent 75%, transparent
270
+ );
271
+ background-size: 1rem 1rem;
272
+ animation: sw-progress-stripes 1s linear infinite;
273
+ }
274
+ @keyframes sw-progress-stripes {
275
+ from { background-position: 1rem 0; }
276
+ to { background-position: 0 0; }
277
+ }
278
+
279
+ /* Spinner */
280
+ .sw-spinner-container {
281
+ display: flex;
282
+ align-items: center;
283
+ gap: 8px;
284
+ margin-bottom: var(--sw-spacing-sm);
285
+ }
286
+ .sw-spinner {
287
+ border: 2px solid #e0e0e0;
288
+ border-top-color: var(--sw-color-primary);
289
+ border-radius: 50%;
290
+ animation: sw-spin 0.8s linear infinite;
291
+ }
292
+ .sw-spinner-sm { width: 16px; height: 16px; }
293
+ .sw-spinner-md { width: 24px; height: 24px; }
294
+ .sw-spinner-lg { width: 40px; height: 40px; border-width: 3px; }
295
+ .sw-spinner-label {
296
+ font-size: 14px;
297
+ color: var(--sw-color-text-muted);
298
+ }
299
+
300
+ /* Status dots */
301
+ .sw-status-dot {
302
+ display: inline-block;
303
+ border-radius: 50%;
304
+ flex-shrink: 0;
305
+ }
306
+ .sw-status-dot-sm { width: 6px; height: 6px; }
307
+ .sw-status-dot-md { width: 10px; height: 10px; }
308
+ .sw-status-dot-lg { width: 14px; height: 14px; }
309
+ .sw-status-dot-red { background: #ef4444; box-shadow: 0 0 6px rgba(239, 68, 68, 0.5); }
310
+ .sw-status-dot-yellow { background: #f59e0b; box-shadow: 0 0 6px rgba(245, 158, 11, 0.5); }
311
+ .sw-status-dot-green { background: #10b981; box-shadow: 0 0 6px rgba(16, 185, 129, 0.5); }
312
+ .sw-status-dot-gray { background: #9ca3af; }
313
+ .sw-status-dot-pulse { animation: sw-pulse 1.5s ease-in-out infinite; }
314
+ @keyframes sw-pulse {
315
+ 0%, 100% { opacity: 1; transform: scale(1); }
316
+ 50% { opacity: 0.6; transform: scale(1.1); }
317
+ }
318
+
319
+ /* Status dot with label wrapper */
320
+ .sw-status-dot-wrapper {
321
+ display: flex;
322
+ flex-direction: column;
323
+ align-items: center;
324
+ gap: 4px;
325
+ }
326
+ .sw-status-dot-label {
327
+ font-size: 12px;
328
+ color: var(--sw-color-text-muted);
329
+ }
330
+
331
+ /* Activity items */
332
+ .sw-activity-item {
333
+ display: flex;
334
+ gap: 12px;
335
+ padding: 8px 0;
336
+ border-bottom: 1px solid var(--sw-color-border);
337
+ }
338
+ .sw-activity-item:last-child { border-bottom: none; }
339
+ .sw-activity-time {
340
+ font-size: 12px;
341
+ color: var(--sw-color-text-muted);
342
+ min-width: 40px;
343
+ }
344
+ .sw-activity-content { flex: 1; }
345
+ .sw-activity-title { font-weight: 500; }
346
+
347
+ /* Alerts */
348
+ .sw-alert {
349
+ padding: var(--sw-spacing-md);
350
+ border-radius: var(--sw-radius-md);
351
+ margin-bottom: var(--sw-spacing-md);
352
+ border-left: 4px solid;
353
+ }
354
+ .sw-alert-info { background: #eff6ff; border-color: #3b82f6; }
355
+ .sw-alert-success { background: #f0fdf4; border-color: #10b981; }
356
+ .sw-alert-warning { background: #fffbeb; border-color: #f59e0b; }
357
+ .sw-alert-error { background: #fef2f2; border-color: #ef4444; }
358
+ .sw-alert-title {
359
+ font-weight: 600;
360
+ margin-bottom: 4px;
361
+ }
362
+
363
+ /* Badges */
364
+ .sw-badge {
365
+ display: inline-flex;
366
+ align-items: center;
367
+ justify-content: center;
368
+ padding: 2px 8px;
369
+ border-radius: 12px;
370
+ font-size: 12px;
371
+ font-weight: 600;
372
+ }
373
+ .sw-badge-default { background: #e5e7eb; color: #374151; }
374
+ .sw-badge-info { background: #dbeafe; color: #1d4ed8; }
375
+ .sw-badge-success { background: #d1fae5; color: #047857; }
376
+ .sw-badge-warning { background: #fef3c7; color: #b45309; }
377
+ .sw-badge-danger { background: #fee2e2; color: #b91c1c; }
378
+
379
+ /* Collapsible */
380
+ .sw-collapsible { margin-bottom: var(--sw-spacing-md); }
381
+ .sw-collapsible-trigger {
382
+ display: flex;
383
+ align-items: center;
384
+ gap: 8px;
385
+ cursor: pointer;
386
+ padding: 8px;
387
+ background: var(--sw-color-bg-elevated);
388
+ border-radius: var(--sw-radius-md);
389
+ font-weight: 500;
390
+ }
391
+ .sw-collapsible-trigger:hover { background: #e5e5e5; }
392
+ .sw-collapsible-content {
393
+ padding: var(--sw-spacing-md);
394
+ border: 1px solid var(--sw-color-border);
395
+ border-top: none;
396
+ border-radius: 0 0 var(--sw-radius-md) var(--sw-radius-md);
397
+ }
398
+
399
+ /* HStack/VStack */
400
+ .sw-hstack {
401
+ display: flex;
402
+ flex-wrap: wrap;
403
+ align-items: center;
404
+ }
405
+ .sw-hstack-xs { gap: 4px; }
406
+ .sw-hstack-sm { gap: 8px; }
407
+ .sw-hstack-md { gap: 16px; }
408
+ .sw-hstack-lg { gap: 24px; }
409
+ .sw-hstack-xl { gap: 32px; }
410
+ .sw-vstack {
411
+ display: flex;
412
+ flex-direction: column;
413
+ }
414
+ .sw-vstack-none { gap: 0; }
415
+ .sw-vstack-xs { gap: 4px; }
416
+ .sw-vstack-sm { gap: 8px; }
417
+ .sw-vstack-md { gap: 16px; }
418
+
419
+ /* Table */
420
+ .sw-table {
421
+ width: 100%;
422
+ border-collapse: collapse;
423
+ margin-bottom: var(--sw-spacing-md);
424
+ }
425
+ .sw-table th, .sw-table td {
426
+ padding: 10px 12px;
427
+ text-align: left;
428
+ border-bottom: 1px solid var(--sw-color-border);
429
+ }
430
+ .sw-table th {
431
+ font-weight: 600;
432
+ background: var(--sw-color-bg-elevated);
433
+ }
434
+ .sw-table-striped tr:nth-child(even) td {
435
+ background: var(--sw-color-bg-elevated);
436
+ }
437
+ .sw-table-sortable th {
438
+ cursor: pointer;
439
+ }
440
+ .sw-table-sortable th:hover {
441
+ background: #e0e0e0;
442
+ }
443
+
444
+ /* Toast notifications */
445
+ .sw-toast {
446
+ position: fixed;
447
+ top: 20px;
448
+ left: 50%;
449
+ transform: translateX(-50%);
450
+ padding: 12px 40px 12px 16px;
451
+ border-radius: var(--sw-radius-md);
452
+ font-size: 14px;
453
+ font-weight: 500;
454
+ box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
455
+ z-index: 10000;
456
+ animation: sw-toast-in 0.3s ease-out;
457
+ max-width: 90%;
458
+ }
459
+ .sw-toast-message { display: inline; }
460
+ .sw-toast-close {
461
+ position: absolute;
462
+ right: 8px;
463
+ top: 50%;
464
+ transform: translateY(-50%);
465
+ background: none;
466
+ border: none;
467
+ font-size: 20px;
468
+ cursor: pointer;
469
+ opacity: 0.7;
470
+ padding: 4px 8px;
471
+ line-height: 1;
472
+ }
473
+ .sw-toast-close:hover { opacity: 1; }
474
+ .sw-toast-info {
475
+ background: #dbeafe;
476
+ color: #1e40af;
477
+ border: 1px solid #93c5fd;
478
+ }
479
+ .sw-toast-success {
480
+ background: #d1fae5;
481
+ color: #065f46;
482
+ border: 1px solid #6ee7b7;
483
+ }
484
+ .sw-toast-warning {
485
+ background: #fef3c7;
486
+ color: #92400e;
487
+ border: 1px solid #fcd34d;
488
+ }
489
+ .sw-toast-error {
490
+ background: #fee2e2;
491
+ color: #991b1b;
492
+ border: 1px solid #fca5a5;
493
+ }
494
+ CSS
495
+
496
+ class << self
497
+ # The framework <style> blocks, in the cascade order that matters:
498
+ # layer pin first, then CANVAS_CSS/master_theme_css/visual_skills_css
499
+ # all sharing that layer so unlayered user CSS (see #user_css_html)
500
+ # always wins regardless of specificity or document order.
501
+ #
502
+ # @param extra_layers [Array<String>] layer names pinned after
503
+ # "stream-weaver" (still below unlayered user CSS, but lets a caller
504
+ # add its own higher-priority-than-framework layer -- concretely,
505
+ # the reader's chrome styling in stream_weaver-csf, the next commit
506
+ # to call this).
507
+ # @return [String] HTML <style> tags
508
+ def framework_css_html(extra_layers: [])
509
+ layers = [StreamWeaver::CSS::LAYER_NAME, *extra_layers].join(", ")
510
+ <<~HTML
511
+ <style>@layer #{layers};</style>
512
+ <style>#{StreamWeaver::CSS.layer_wrap(CANVAS_CSS)}</style>
513
+ <style>#{StreamWeaver::CSS.layer_wrap(StreamWeaver::Views::AppView.master_theme_css)}</style>
514
+ <style>#{StreamWeaver::CSS.layer_wrap(StreamWeaver::Theme.visual_skills_css)}</style>
515
+ HTML
516
+ end
517
+
518
+ # User-authored inline CSS, always UNLAYERED so it outranks every
519
+ # framework rule regardless of specificity or document order (the
520
+ # cascade-layers contract StreamWeaver::CSS::LAYER_NAME documents).
521
+ # Emit this after #framework_css_html.
522
+ #
523
+ # @param inline_stylesheets [Array<String>] raw CSS content
524
+ # @return [String] HTML <style> tags
525
+ def user_css_html(inline_stylesheets: [])
526
+ inline_stylesheets.map { |css| "<style>#{css}</style>" }.join("\n")
527
+ end
528
+ end
529
+ end
530
+ end
data/lib/stream_weaver/portfile.rb ADDED
@@ -0,0 +1,79 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'fileutils'
4
+
5
+ module StreamWeaver
6
+ # Portfile-based discovery for running StreamWeaver apps.
7
+ # Apps write a portfile on startup; feed scripts read them to connect.
8
+ #
9
+ # Location: ~/.streamweaver/apps/<sanitized_name>.port
10
+ # Format: url=http://127.0.0.1:4567\npid=12345\nname=My App\n
11
+ module Portfile
12
+ DIR = File.expand_path("~/.streamweaver/apps")
13
+
14
+ def self.sanitize(name)
15
+ name.downcase.gsub(/[^a-z0-9_-]/, "_")
16
+ end
17
+
18
+ def self.path_for(name)
19
+ File.join(DIR, "#{sanitize(name)}.port")
20
+ end
21
+
22
+ def self.write(name, url:, pid:)
23
+ FileUtils.mkdir_p(DIR)
24
+ File.write(path_for(name), "url=#{url}\npid=#{pid}\nname=#{name}\n")
25
+ end
26
+
27
+ def self.delete(name)
28
+ path = path_for(name)
29
+ FileUtils.rm_f(path)
30
+ end
31
+
32
+ def self.read(name)
33
+ path = path_for(name)
34
+ raise Error, "No portfile for '#{name}' at #{path}. Is the app running?" unless File.exist?(path)
35
+ parse_and_validate(path, name)
36
+ end
37
+
38
+ def self.discover_single
39
+ FileUtils.mkdir_p(DIR)
40
+ clean_stale!
41
+ files = Dir.glob(File.join(DIR, "*.port"))
42
+ case files.size
43
+ when 0 then raise Error, "No StreamWeaver apps running (no portfiles in #{DIR})"
44
+ when 1 then parse_and_validate(files.first)
45
+ else raise Error, "Multiple apps running. Specify name: StreamWeaver.connect('App Name')"
46
+ end
47
+ end
48
+
49
+ def self.clean_stale!
50
+ return unless Dir.exist?(DIR)
51
+ Dir.glob(File.join(DIR, "*.port")).each do |path|
52
+ pid = File.read(path)[/^pid=(\d+)$/, 1]&.to_i
53
+ next unless pid
54
+ FileUtils.rm_f(path) unless process_alive?(pid)
55
+ end
56
+ end
57
+
58
+ def self.process_alive?(pid)
59
+ Process.kill(0, pid)
60
+ true
61
+ rescue Errno::ESRCH, Errno::EPERM
62
+ false
63
+ end
64
+
65
+ def self.parse_and_validate(path, display_name = nil)
66
+ data = File.read(path)
67
+ url = data[/^url=(.+)$/, 1]
68
+ pid = data[/^pid=(\d+)$/, 1]&.to_i
69
+ display_name ||= data[/^name=(.+)$/, 1] || File.basename(path, ".port")
70
+
71
+ if pid && !process_alive?(pid)
72
+ FileUtils.rm_f(path)
73
+ raise Error, "App '#{display_name}' is no longer running (stale portfile cleaned up)"
74
+ end
75
+
76
+ url or raise Error, "Malformed portfile at #{path}"
77
+ end
78
+ end
79
+ end
data/lib/stream_weaver/pushable.rb ADDED
@@ -0,0 +1,42 @@
1
+ # frozen_string_literal: true
2
+
3
+ module StreamWeaver
4
+ # Shared interface for pushing targeted DOM updates.
5
+ # Included by Feed (HTTP push) and Streamer (SSE broadcast).
6
+ # Implementors provide `push_update(action:, target:, html:)`.
7
+ module Pushable
8
+ def replace(target, html = nil, state: nil, &block)
9
+ html ||= render_components(state, &block) if block
10
+ push_update(action: :replace, target: target, html: html)
11
+ end
12
+
13
+ def append(target, html = nil, state: nil, &block)
14
+ html ||= render_components(state, &block) if block
15
+ push_update(action: :append, target: target, html: html)
16
+ end
17
+
18
+ def prepend(target, html = nil, state: nil, &block)
19
+ html ||= render_components(state, &block) if block
20
+ push_update(action: :prepend, target: target, html: html)
21
+ end
22
+
23
+ def remove(target)
24
+ push_update(action: :remove, target: target, html: "")
25
+ end
26
+
27
+ def add_class(target, class_name)
28
+ push_update(action: :add_class, target: target, value: class_name)
29
+ end
30
+
31
+ def remove_class(target, class_name)
32
+ push_update(action: :remove_class, target: target, value: class_name)
33
+ end
34
+
35
+ private
36
+
37
+ def render_components(state = nil, &block)
38
+ components = FeedBuilder.build(state, &block)
39
+ ComponentRenderer.render_html(StreamWeaver.default_adapter, components)
40
+ end
41
+ end
42
+ end