@powerhousedao/academy 4.1.0-dev.2 → 4.1.0-dev.21

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 (8) hide show
  1. package/CHANGELOG.md +158 -0
  2. package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/01-BuildingDocumentEditors.md +23 -0
  3. package/docs/academy/02-MasteryTrack/04-WorkWithData/03-UsingSubgraphs.md +72 -419
  4. package/docs/academy/02-MasteryTrack/04-WorkWithData/05-RelationalDbProcessor.md +36 -33
  5. package/docs/academy/04-APIReferences/00-PowerhouseCLI.md +31 -23
  6. package/docs/academy/04-APIReferences/01-ReactHooks.md +612 -152
  7. package/docs/academy/TUTORIAL_VERIFICATION_ARCHITECTURE +325 -0
  8. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,3 +1,161 @@
1
+ ## 4.1.0-dev.21 (2025-08-15)
2
+
3
+ ### 🚀 Features
4
+
5
+ - **vetra:** update manifest when new module is added ([#1766](https://github.com/powerhouse-inc/powerhouse/pull/1766))
6
+ - **academy:** hooks documentation ([a517eadce](https://github.com/powerhouse-inc/powerhouse/commit/a517eadce))
7
+
8
+ ### 🩹 Fixes
9
+
10
+ - **academy:** subgraphs documentation update ([4f3a024ab](https://github.com/powerhouse-inc/powerhouse/commit/4f3a024ab))
11
+ - fixed debug launch configuration now that source maps are in the proper locations ([c75d793ed](https://github.com/powerhouse-inc/powerhouse/commit/c75d793ed))
12
+
13
+ ### ❤️ Thank You
14
+
15
+ - Benjamin Jordan (@thegoldenmule)
16
+ - Callme-T
17
+ - Guillermo Puente Sandoval @gpuente
18
+
19
+ ## 4.1.0-dev.20 (2025-08-15)
20
+
21
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
22
+
23
+ ## 4.1.0-dev.19 (2025-08-14)
24
+
25
+ ### 🩹 Fixes
26
+
27
+ - **academy:** subgraph example ([ae3e24458](https://github.com/powerhouse-inc/powerhouse/commit/ae3e24458))
28
+
29
+ ### ❤️ Thank You
30
+
31
+ - Frank
32
+
33
+ ## 4.1.0-dev.18 (2025-08-14)
34
+
35
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
36
+
37
+ ## 4.1.0-dev.17 (2025-08-12)
38
+
39
+ ### 🚀 Features
40
+
41
+ - refactor vetra command and remove vetra deps in connect and reactor ([#1753](https://github.com/powerhouse-inc/powerhouse/pull/1753))
42
+
43
+ ### ❤️ Thank You
44
+
45
+ - Guillermo Puente Sandoval @gpuente
46
+
47
+ ## 4.1.0-dev.16 (2025-08-12)
48
+
49
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
50
+
51
+ ## 4.1.0-dev.15 (2025-08-12)
52
+
53
+ ### 🚀 Features
54
+
55
+ - **reactor-mcp,reactor-api,reactor-local,switchboard,ph-cli:** run mcp on express app ([d51fa590e](https://github.com/powerhouse-inc/powerhouse/commit/d51fa590e))
56
+
57
+ ### ❤️ Thank You
58
+
59
+ - acaldas @acaldas
60
+
61
+ ## 4.1.0-dev.14 (2025-08-11)
62
+
63
+ ### 🚀 Features
64
+
65
+ - update document engineering dep ([54dcee90d](https://github.com/powerhouse-inc/powerhouse/commit/54dcee90d))
66
+
67
+ ### ❤️ Thank You
68
+
69
+ - acaldas @acaldas
70
+
71
+ ## 4.1.0-dev.13 (2025-08-09)
72
+
73
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
74
+
75
+ ## 4.1.0-dev.12 (2025-08-08)
76
+
77
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
78
+
79
+ ## 4.1.0-dev.11 (2025-08-07)
80
+
81
+ ### 🚀 Features
82
+
83
+ - **switchboard,reactor-local,reactor-api:** moved vite loader to reactor-api package ([c84f0a2a3](https://github.com/powerhouse-inc/powerhouse/commit/c84f0a2a3))
84
+ - vetra package documents and app integration ([0e4053302](https://github.com/powerhouse-inc/powerhouse/commit/0e4053302))
85
+ - **vetra:** added vetra drive editor ([4ebafd143](https://github.com/powerhouse-inc/powerhouse/commit/4ebafd143))
86
+ - **ph-cli:** added verbose option to vetra command ([7310ec06c](https://github.com/powerhouse-inc/powerhouse/commit/7310ec06c))
87
+ - integrate package documents into reactor system ([939fe8e80](https://github.com/powerhouse-inc/powerhouse/commit/939fe8e80))
88
+ - **connect:** integrate Vetra package documents and editors ([2ecb9bd15](https://github.com/powerhouse-inc/powerhouse/commit/2ecb9bd15))
89
+
90
+ ### ❤️ Thank You
91
+
92
+ - acaldas @acaldas
93
+ - Guillermo Puente @gpuente
94
+ - Guillermo Puente Sandoval @gpuente
95
+
96
+ ## 4.1.0-dev.10 (2025-08-07)
97
+
98
+ ### 🚀 Features
99
+
100
+ - **builder-tools,codegen,design-system,reactor-api:** updated document-engineering version ([e74068b43](https://github.com/powerhouse-inc/powerhouse/commit/e74068b43))
101
+
102
+ ### ❤️ Thank You
103
+
104
+ - acaldas @acaldas
105
+
106
+ ## 4.1.0-dev.9 (2025-08-07)
107
+
108
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
109
+
110
+ ## 4.1.0-dev.8 (2025-08-06)
111
+
112
+ ### 🚀 Features
113
+
114
+ - **switchboard,config,reactor-api:** handle auth in reactor-api ([f33c921ee](https://github.com/powerhouse-inc/powerhouse/commit/f33c921ee))
115
+
116
+ ### ❤️ Thank You
117
+
118
+ - acaldas @acaldas
119
+
120
+ ## 4.1.0-dev.7 (2025-08-06)
121
+
122
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
123
+
124
+ ## 4.1.0-dev.6 (2025-08-06)
125
+
126
+ ### 🚀 Features
127
+
128
+ - **reactor-mcp:** load local document models and reload when they change ([0408a017c](https://github.com/powerhouse-inc/powerhouse/commit/0408a017c))
129
+ - **reactor-local,reactor-api,document-drive:** reload local document models when they change ([5d9af3951](https://github.com/powerhouse-inc/powerhouse/commit/5d9af3951))
130
+
131
+ ### ❤️ Thank You
132
+
133
+ - acaldas @acaldas
134
+
135
+ ## 4.1.0-dev.5 (2025-08-05)
136
+
137
+ This was a version bump only for @powerhousedao/academy to align it with other projects, there were no code changes.
138
+
139
+ ## 4.1.0-dev.4 (2025-08-02)
140
+
141
+ ### 🚀 Features
142
+
143
+ - ts morph integration ([#1729](https://github.com/powerhouse-inc/powerhouse/pull/1729))
144
+
145
+ ### ❤️ Thank You
146
+
147
+ - Guillermo Puente Sandoval @gpuente
148
+
149
+ ## 4.1.0-dev.3 (2025-08-01)
150
+
151
+ ### 🚀 Features
152
+
153
+ - **reactor-mcp:** setup of modular reactor tools ([ceab98b08](https://github.com/powerhouse-inc/powerhouse/commit/ceab98b08))
154
+
155
+ ### ❤️ Thank You
156
+
157
+ - acaldas @acaldas
158
+
1
159
  ## 4.1.0-dev.2 (2025-07-31)
2
160
 
3
161
  ### 🚀 Features
package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/01-BuildingDocumentEditors.md CHANGED
@@ -74,6 +74,29 @@ You have several options for styling your editor components:
74
74
 
75
75
  Choose the method or combination of methods that best suits your project needs and team preferences. Connect Studio (`ph connect`) will allow you to see your styles applied in real-time.
76
76
 
77
+ :::warning **Best practices for consistent reliable styles**
78
+
79
+ In any package the styles are being generated through the styles.css file with the help of the tailwindcss/cli package.
80
+
81
+ **1. Centralize style imports**
82
+
83
+ - Do not import styles directly in .tsx files.
84
+ - This works in development mode but will not be picked up in static production builds.
85
+ - Move all style imports into your main styles.css file.
86
+
87
+ **2. Use file imports instead of URL imports**
88
+
89
+ - @import url("...") → **Incorrect**, Ignored by tailwindcss/cli
90
+ - @import "..." → **Correct**, resolves from local files or node_modules
91
+ - Always prefer the file import syntax.
92
+
93
+ **Using `ph install` includes package styles automatically**
94
+
95
+ - When installing a package with `ph install` on any instance, package styles are automatically added to styles.css. This ensures production builds always include the required package styles.
96
+ :::
97
+
98
+
99
+
77
100
  ### State management in editors
78
101
 
79
102
  When you build an editor in Powerhouse, your main editor component receives `EditorProps`. These props are crucial for interacting with the document: