@luquimbo/bi-superpowers 1.0.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 (193) hide show
  1. package/.claude-plugin/plugin.json +8 -0
  2. package/.mcp.json +25 -0
  3. package/AGENTS.md +244 -0
  4. package/CHANGELOG.md +265 -0
  5. package/LICENSE +21 -0
  6. package/README.md +211 -0
  7. package/bin/build-plugin.js +30 -0
  8. package/bin/cli.js +1064 -0
  9. package/bin/commands/add.js +533 -0
  10. package/bin/commands/add.test.js +77 -0
  11. package/bin/commands/build-desktop.js +166 -0
  12. package/bin/commands/changelog.js +443 -0
  13. package/bin/commands/diff.js +325 -0
  14. package/bin/commands/lint.js +419 -0
  15. package/bin/commands/lint.test.js +103 -0
  16. package/bin/commands/mcp-setup.js +246 -0
  17. package/bin/commands/pull.js +287 -0
  18. package/bin/commands/pull.test.js +36 -0
  19. package/bin/commands/push.js +231 -0
  20. package/bin/commands/push.test.js +14 -0
  21. package/bin/commands/search.js +344 -0
  22. package/bin/commands/search.test.js +115 -0
  23. package/bin/commands/setup.js +545 -0
  24. package/bin/commands/setup.test.js +46 -0
  25. package/bin/commands/sync-profile.js +405 -0
  26. package/bin/commands/sync-profile.test.js +14 -0
  27. package/bin/commands/sync-source.js +418 -0
  28. package/bin/commands/sync-source.test.js +14 -0
  29. package/bin/commands/watch.js +206 -0
  30. package/bin/lib/generators/claude-plugin.js +266 -0
  31. package/bin/lib/generators/claude-plugin.test.js +110 -0
  32. package/bin/lib/generators/index.js +116 -0
  33. package/bin/lib/generators/shared.js +282 -0
  34. package/bin/lib/licensing/index.js +35 -0
  35. package/bin/lib/licensing/storage.js +364 -0
  36. package/bin/lib/licensing/storage.test.js +55 -0
  37. package/bin/lib/licensing/validator.js +213 -0
  38. package/bin/lib/licensing/validator.test.js +137 -0
  39. package/bin/lib/microsoft-mcp.js +176 -0
  40. package/bin/lib/microsoft-mcp.test.js +106 -0
  41. package/bin/lib/skills.js +84 -0
  42. package/bin/mcp/powerbi-modeling-launcher.js +38 -0
  43. package/bin/postinstall.js +44 -0
  44. package/bin/utils/errors.js +159 -0
  45. package/bin/utils/git.js +298 -0
  46. package/bin/utils/logger.js +142 -0
  47. package/bin/utils/mcp-detect.js +274 -0
  48. package/bin/utils/mcp-detect.test.js +105 -0
  49. package/bin/utils/pbix.js +305 -0
  50. package/bin/utils/pbix.test.js +37 -0
  51. package/bin/utils/profiles.js +312 -0
  52. package/bin/utils/projects.js +168 -0
  53. package/bin/utils/readline.js +206 -0
  54. package/bin/utils/readline.test.js +47 -0
  55. package/bin/utils/tui.js +314 -0
  56. package/bin/utils/tui.test.js +127 -0
  57. package/commands/contributions.md +265 -0
  58. package/commands/data-model-design.md +468 -0
  59. package/commands/dax-doctor.md +248 -0
  60. package/commands/fabric-scripts.md +452 -0
  61. package/commands/migration-assistant.md +290 -0
  62. package/commands/model-documenter.md +242 -0
  63. package/commands/pbi-connect.md +239 -0
  64. package/commands/project-kickoff.md +905 -0
  65. package/commands/report-layout.md +296 -0
  66. package/commands/rls-design.md +533 -0
  67. package/commands/theme-tweaker.md +624 -0
  68. package/config.example.json +23 -0
  69. package/config.json +23 -0
  70. package/desktop-extension/manifest.json +37 -0
  71. package/desktop-extension/package.json +10 -0
  72. package/desktop-extension/server.js +95 -0
  73. package/docs/openrouter-free-models.md +92 -0
  74. package/library/examples/README.md +151 -0
  75. package/library/examples/finance-reporting/README.md +351 -0
  76. package/library/examples/finance-reporting/data-model.md +267 -0
  77. package/library/examples/finance-reporting/measures.dax +557 -0
  78. package/library/examples/hr-analytics/README.md +371 -0
  79. package/library/examples/hr-analytics/data-model.md +315 -0
  80. package/library/examples/hr-analytics/measures.dax +460 -0
  81. package/library/examples/marketing-analytics/README.md +37 -0
  82. package/library/examples/marketing-analytics/data-model.md +62 -0
  83. package/library/examples/marketing-analytics/measures.dax +110 -0
  84. package/library/examples/retail-analytics/README.md +439 -0
  85. package/library/examples/retail-analytics/data-model.md +288 -0
  86. package/library/examples/retail-analytics/measures.dax +481 -0
  87. package/library/examples/supply-chain/README.md +37 -0
  88. package/library/examples/supply-chain/data-model.md +69 -0
  89. package/library/examples/supply-chain/measures.dax +77 -0
  90. package/library/examples/udf-library/README.md +228 -0
  91. package/library/examples/udf-library/functions.dax +571 -0
  92. package/library/snippets/dax/README.md +292 -0
  93. package/library/snippets/dax/business-domains.md +576 -0
  94. package/library/snippets/dax/calculate-patterns.md +276 -0
  95. package/library/snippets/dax/calculation-groups.md +489 -0
  96. package/library/snippets/dax/error-handling.md +495 -0
  97. package/library/snippets/dax/iterators-and-aggregations.md +474 -0
  98. package/library/snippets/dax/kpis-and-metrics.md +293 -0
  99. package/library/snippets/dax/rankings-and-topn.md +235 -0
  100. package/library/snippets/dax/security-patterns.md +413 -0
  101. package/library/snippets/dax/text-and-formatting.md +316 -0
  102. package/library/snippets/dax/time-intelligence.md +196 -0
  103. package/library/snippets/dax/user-defined-functions.md +477 -0
  104. package/library/snippets/dax/virtual-tables.md +546 -0
  105. package/library/snippets/excel-formulas/README.md +84 -0
  106. package/library/snippets/excel-formulas/aggregations.md +330 -0
  107. package/library/snippets/excel-formulas/dates-and-times.md +361 -0
  108. package/library/snippets/excel-formulas/dynamic-arrays.md +314 -0
  109. package/library/snippets/excel-formulas/lookups.md +169 -0
  110. package/library/snippets/excel-formulas/text-functions.md +363 -0
  111. package/library/snippets/governance/naming-conventions.md +97 -0
  112. package/library/snippets/governance/review-checklists.md +107 -0
  113. package/library/snippets/power-query/README.md +389 -0
  114. package/library/snippets/power-query/api-integration.md +707 -0
  115. package/library/snippets/power-query/connections.md +434 -0
  116. package/library/snippets/power-query/data-cleaning.md +298 -0
  117. package/library/snippets/power-query/error-handling.md +526 -0
  118. package/library/snippets/power-query/parameters.md +350 -0
  119. package/library/snippets/power-query/performance.md +506 -0
  120. package/library/snippets/power-query/transformations.md +330 -0
  121. package/library/snippets/report-design/accessibility.md +78 -0
  122. package/library/snippets/report-design/chart-selection.md +54 -0
  123. package/library/snippets/report-design/layout-patterns.md +87 -0
  124. package/library/templates/data-models/README.md +93 -0
  125. package/library/templates/data-models/finance-model.md +627 -0
  126. package/library/templates/data-models/retail-star-schema.md +473 -0
  127. package/library/templates/excel/README.md +83 -0
  128. package/library/templates/excel/budget-tracker.md +432 -0
  129. package/library/templates/excel/data-entry-form.md +533 -0
  130. package/library/templates/power-bi/README.md +72 -0
  131. package/library/templates/power-bi/finance-report.md +449 -0
  132. package/library/templates/power-bi/kpi-scorecard.md +461 -0
  133. package/library/templates/power-bi/sales-dashboard.md +281 -0
  134. package/library/themes/excel/README.md +436 -0
  135. package/library/themes/power-bi/README.md +271 -0
  136. package/library/themes/power-bi/accessible.json +307 -0
  137. package/library/themes/power-bi/bi-superpowers-default.json +858 -0
  138. package/library/themes/power-bi/corporate-blue.json +291 -0
  139. package/library/themes/power-bi/dark-mode.json +291 -0
  140. package/library/themes/power-bi/minimal.json +292 -0
  141. package/library/themes/power-bi/print-friendly.json +309 -0
  142. package/package.json +93 -0
  143. package/skills/contributions/SKILL.md +267 -0
  144. package/skills/data-model-design/SKILL.md +470 -0
  145. package/skills/data-modeling/SKILL.md +254 -0
  146. package/skills/data-quality/SKILL.md +664 -0
  147. package/skills/dax/SKILL.md +708 -0
  148. package/skills/dax-doctor/SKILL.md +250 -0
  149. package/skills/dax-udf/SKILL.md +489 -0
  150. package/skills/deployment/SKILL.md +320 -0
  151. package/skills/excel-formulas/SKILL.md +463 -0
  152. package/skills/fabric-scripts/SKILL.md +454 -0
  153. package/skills/fast-standard/SKILL.md +509 -0
  154. package/skills/governance/SKILL.md +205 -0
  155. package/skills/migration-assistant/SKILL.md +292 -0
  156. package/skills/model-documenter/SKILL.md +244 -0
  157. package/skills/pbi-connect/SKILL.md +241 -0
  158. package/skills/power-query/SKILL.md +406 -0
  159. package/skills/project-kickoff/SKILL.md +907 -0
  160. package/skills/query-performance/SKILL.md +480 -0
  161. package/skills/report-design/SKILL.md +207 -0
  162. package/skills/report-layout/SKILL.md +298 -0
  163. package/skills/rls-design/SKILL.md +535 -0
  164. package/skills/semantic-model/SKILL.md +237 -0
  165. package/skills/testing-validation/SKILL.md +643 -0
  166. package/skills/theme-tweaker/SKILL.md +626 -0
  167. package/src/content/base.md +237 -0
  168. package/src/content/mcp-requirements.json +69 -0
  169. package/src/content/routing.md +203 -0
  170. package/src/content/skills/contributions.md +259 -0
  171. package/src/content/skills/data-model-design.md +462 -0
  172. package/src/content/skills/data-modeling.md +246 -0
  173. package/src/content/skills/data-quality.md +656 -0
  174. package/src/content/skills/dax-doctor.md +242 -0
  175. package/src/content/skills/dax-udf.md +481 -0
  176. package/src/content/skills/dax.md +700 -0
  177. package/src/content/skills/deployment.md +312 -0
  178. package/src/content/skills/excel-formulas.md +455 -0
  179. package/src/content/skills/fabric-scripts.md +446 -0
  180. package/src/content/skills/fast-standard.md +501 -0
  181. package/src/content/skills/governance.md +197 -0
  182. package/src/content/skills/migration-assistant.md +284 -0
  183. package/src/content/skills/model-documenter.md +236 -0
  184. package/src/content/skills/pbi-connect.md +233 -0
  185. package/src/content/skills/power-query.md +398 -0
  186. package/src/content/skills/project-kickoff.md +899 -0
  187. package/src/content/skills/query-performance.md +472 -0
  188. package/src/content/skills/report-design.md +199 -0
  189. package/src/content/skills/report-layout.md +290 -0
  190. package/src/content/skills/rls-design.md +527 -0
  191. package/src/content/skills/semantic-model.md +229 -0
  192. package/src/content/skills/testing-validation.md +635 -0
  193. package/src/content/skills/theme-tweaker.md +618 -0
@@ -0,0 +1,276 @@
1
+ # CALCULATE Patterns in DAX
2
+
3
+ Essential CALCULATE patterns for filtering and context modification.
4
+
5
+ ## Basic Filter Patterns
6
+
7
+ ### Simple Filter
8
+ ```dax
9
+ Sales_HighValue =
10
+ CALCULATE(
11
+ SUM(Sales[Amount]),
12
+ Sales[Amount] > 1000
13
+ )
14
+ ```
15
+
16
+ ### Multiple Filters (AND logic)
17
+ ```dax
18
+ Sales_HighValue_2024 =
19
+ CALCULATE(
20
+ SUM(Sales[Amount]),
21
+ Sales[Amount] > 1000,
22
+ 'Date'[Year] = 2024
23
+ )
24
+ ```
25
+
26
+ ### Filter on Related Table
27
+ ```dax
28
+ Sales_Electronics =
29
+ CALCULATE(
30
+ SUM(Sales[Amount]),
31
+ Products[Category] = "Electronics"
32
+ )
33
+ ```
34
+
35
+ ## ALL Function Patterns
36
+
37
+ ### Remove All Filters
38
+ ```dax
39
+ TotalSales_All =
40
+ CALCULATE(
41
+ SUM(Sales[Amount]),
42
+ ALL(Sales)
43
+ )
44
+ ```
45
+
46
+ ### Remove Filter from One Column
47
+ ```dax
48
+ Sales_AllProducts =
49
+ CALCULATE(
50
+ SUM(Sales[Amount]),
51
+ ALL(Products[ProductName])
52
+ )
53
+ ```
54
+
55
+ ### Remove Filter but Keep Others (ALLEXCEPT)
56
+ ```dax
57
+ Sales_KeepCategory =
58
+ CALCULATE(
59
+ SUM(Sales[Amount]),
60
+ ALLEXCEPT(Products, Products[Category])
61
+ )
62
+ ```
63
+
64
+ ### Percentage of Total
65
+ ```dax
66
+ Pct_of_Total =
67
+ DIVIDE(
68
+ SUM(Sales[Amount]),
69
+ CALCULATE(
70
+ SUM(Sales[Amount]),
71
+ ALL(Sales)
72
+ )
73
+ )
74
+ ```
75
+
76
+ ### Percentage of Category
77
+ ```dax
78
+ Pct_of_Category =
79
+ DIVIDE(
80
+ SUM(Sales[Amount]),
81
+ CALCULATE(
82
+ SUM(Sales[Amount]),
83
+ ALLEXCEPT(Products, Products[Category])
84
+ )
85
+ )
86
+ ```
87
+
88
+ ## FILTER Function Patterns
89
+
90
+ ### Complex Filter Logic
91
+ ```dax
92
+ Sales_TopCategories =
93
+ CALCULATE(
94
+ SUM(Sales[Amount]),
95
+ FILTER(
96
+ ALL(Products[Category]),
97
+ [CategorySales] > 100000
98
+ )
99
+ )
100
+ ```
101
+
102
+ ### Filter with OR Logic
103
+ ```dax
104
+ Sales_SelectedRegions =
105
+ CALCULATE(
106
+ SUM(Sales[Amount]),
107
+ FILTER(
108
+ ALL(Geography[Region]),
109
+ Geography[Region] IN {"North", "South", "West"}
110
+ )
111
+ )
112
+ ```
113
+
114
+ ### Filter on Measure Result
115
+ ```dax
116
+ Sales_ProfitableProducts =
117
+ CALCULATE(
118
+ SUM(Sales[Amount]),
119
+ FILTER(
120
+ ALL(Products[ProductName]),
121
+ [ProfitMargin] > 0.20
122
+ )
123
+ )
124
+ ```
125
+
126
+ ## KEEPFILTERS Pattern
127
+
128
+ ### Add Filter Without Replacing
129
+ ```dax
130
+ Sales_Premium_KeepFilters =
131
+ CALCULATE(
132
+ SUM(Sales[Amount]),
133
+ KEEPFILTERS(Products[Tier] = "Premium")
134
+ )
135
+ ```
136
+
137
+ ### Intersection of Filters
138
+ ```dax
139
+ Sales_Filtered_Intersection =
140
+ CALCULATE(
141
+ SUM(Sales[Amount]),
142
+ KEEPFILTERS(
143
+ FILTER(
144
+ ALL(Products[Category]),
145
+ Products[Category] IN {"Electronics", "Clothing"}
146
+ )
147
+ )
148
+ )
149
+ ```
150
+
151
+ ## REMOVEFILTERS Pattern (DAX 2019+)
152
+
153
+ ### Clear Specific Filters
154
+ ```dax
155
+ Sales_NoProductFilter =
156
+ CALCULATE(
157
+ SUM(Sales[Amount]),
158
+ REMOVEFILTERS(Products)
159
+ )
160
+ ```
161
+
162
+ ### Clear Column Filter
163
+ ```dax
164
+ Sales_NoYearFilter =
165
+ CALCULATE(
166
+ SUM(Sales[Amount]),
167
+ REMOVEFILTERS('Date'[Year])
168
+ )
169
+ ```
170
+
171
+ ## USERELATIONSHIP Pattern
172
+
173
+ ### Activate Inactive Relationship
174
+ ```dax
175
+ Sales_ByShipDate =
176
+ CALCULATE(
177
+ SUM(Sales[Amount]),
178
+ USERELATIONSHIP(Sales[ShipDate], 'Date'[Date])
179
+ )
180
+ ```
181
+
182
+ ### Compare Order vs Ship Date
183
+ ```dax
184
+ Sales_Variance_OrderVsShip =
185
+ VAR _ByOrderDate = SUM(Sales[Amount])
186
+ VAR _ByShipDate =
187
+ CALCULATE(
188
+ SUM(Sales[Amount]),
189
+ USERELATIONSHIP(Sales[ShipDate], 'Date'[Date])
190
+ )
191
+ RETURN
192
+ _ByOrderDate - _ByShipDate
193
+ ```
194
+
195
+ ## CROSSFILTER Pattern
196
+
197
+ ### Change Filter Direction
198
+ ```dax
199
+ ProductCount_BySales =
200
+ CALCULATE(
201
+ DISTINCTCOUNT(Products[ProductID]),
202
+ CROSSFILTER(Sales[ProductID], Products[ProductID], BOTH)
203
+ )
204
+ ```
205
+
206
+ ### Disable Relationship
207
+ ```dax
208
+ Sales_IgnoreProductRelation =
209
+ CALCULATE(
210
+ SUM(Sales[Amount]),
211
+ CROSSFILTER(Sales[ProductID], Products[ProductID], NONE)
212
+ )
213
+ ```
214
+
215
+ ## Context Transition
216
+
217
+ ### Row Context to Filter Context
218
+ ```dax
219
+ -- In a calculated column or iterator
220
+ SalesForThisProduct =
221
+ CALCULATE(SUM(Sales[Amount]))
222
+ -- Converts current row context to filter context
223
+ ```
224
+
225
+ ### EARLIER for Nested Row Context
226
+ ```dax
227
+ -- In a calculated column
228
+ RunningTotal =
229
+ CALCULATE(
230
+ SUM(Sales[Amount]),
231
+ FILTER(
232
+ ALL(Sales),
233
+ Sales[Date] <= EARLIER(Sales[Date])
234
+ )
235
+ )
236
+ ```
237
+
238
+ ## Virtual Tables
239
+
240
+ ### CALCULATE with SUMMARIZE
241
+ ```dax
242
+ Sales_TopMonths =
243
+ CALCULATE(
244
+ SUM(Sales[Amount]),
245
+ TOPN(
246
+ 3,
247
+ SUMMARIZE(
248
+ Sales,
249
+ 'Date'[MonthYear],
250
+ "@MonthlySales", SUM(Sales[Amount])
251
+ ),
252
+ [@MonthlySales],
253
+ DESC
254
+ )
255
+ )
256
+ ```
257
+
258
+ ### CALCULATE with TREATAS
259
+ ```dax
260
+ Sales_MatchingProducts =
261
+ CALCULATE(
262
+ SUM(Sales[Amount]),
263
+ TREATAS(
264
+ VALUES(BudgetProducts[ProductID]),
265
+ Products[ProductID]
266
+ )
267
+ )
268
+ ```
269
+
270
+ ## Usage Notes
271
+
272
+ - CALCULATE is the most important DAX function
273
+ - Always prefer simple column filters over FILTER when possible (better performance)
274
+ - Use FILTER for complex conditions or when filtering on measures
275
+ - ALL removes filters; REMOVEFILTERS is more explicit (same result)
276
+ - KEEPFILTERS intersects filters instead of replacing them