@luquimbo/bi-superpowers 1.0.0

package/library/snippets/excel-formulas/dynamic-arrays.md

@@ -0,0 +1,314 @@
+# Dynamic Array Formulas (Excel 365+)
+
+Modern Excel formulas that return multiple values.
+
+## FILTER Function
+
+### Basic Filter
+```excel
+=FILTER(tbl_Sales, tbl_Sales[Region]="North")
+```
+
+### Filter with Multiple Criteria (AND)
+```excel
+=FILTER(tbl_Sales, (tbl_Sales[Region]="North")*(tbl_Sales[Amount]>1000))
+```
+
+### Filter with Multiple Criteria (OR)
+```excel
+=FILTER(tbl_Sales, (tbl_Sales[Region]="North")+(tbl_Sales[Region]="South"))
+```
+
+### Filter with Default Value
+```excel
+=FILTER(tbl_Sales, tbl_Sales[Product]=A2, "No results found")
+```
+
+### Filter Specific Columns
+```excel
+=FILTER(CHOOSECOLS(tbl_Sales, 1, 3, 5), tbl_Sales[Status]="Active")
+```
+
+### Top N with Filter
+```excel
+=FILTER(tbl_Sales, tbl_Sales[Amount]>=LARGE(tbl_Sales[Amount], 5))
+```
+
+## SORT Function
+
+### Basic Sort (Ascending)
+```excel
+=SORT(tbl_Sales)
+```
+
+### Sort by Specific Column
+```excel
+=SORT(tbl_Sales, 3, -1)
+```
+- `3` = column index
+- `-1` = descending, `1` = ascending
+
+### Sort by Multiple Columns
+```excel
+=SORT(tbl_Sales, {1, 3}, {1, -1})
+```
+- First by column 1 ascending, then column 3 descending
+
+### Combined Filter and Sort
+```excel
+=SORT(FILTER(tbl_Sales, tbl_Sales[Region]="North"), 3, -1)
+```
+
+## SORTBY Function
+
+### Sort by Another Column
+```excel
+=SORTBY(tbl_Products[Name], tbl_Products[Sales], -1)
+```
+
+### Sort by Multiple Criteria
+```excel
+=SORTBY(tbl_Data, tbl_Data[Category], 1, tbl_Data[Amount], -1)
+```
+
+### Sort by External Range
+```excel
+=SORTBY(A2:C10, D2:D10, -1)
+```
+
+## UNIQUE Function
+
+### Unique Values
+```excel
+=UNIQUE(tbl_Sales[Customer])
+```
+
+### Unique Rows
+```excel
+=UNIQUE(tbl_Sales)
+```
+
+### Unique Values that Appear Once
+```excel
+=UNIQUE(tbl_Sales[Customer], FALSE, TRUE)
+```
+- Second parameter: by column (TRUE) or row (FALSE)
+- Third parameter: exactly once (TRUE)
+
+### Unique Combinations
+```excel
+=UNIQUE(CHOOSECOLS(tbl_Sales, 1, 3))
+```
+
+## SEQUENCE Function
+
+### Simple Sequence
+```excel
+=SEQUENCE(10)
+```
+Results: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
+
+### Rows and Columns
+```excel
+=SEQUENCE(5, 3)
+```
+Creates 5 rows x 3 columns matrix
+
+### Custom Start and Step
+```excel
+=SEQUENCE(10, 1, 0, 5)
+```
+Results: 0, 5, 10, 15, 20, 25, 30, 35, 40, 45
+
+### Date Sequence
+```excel
+=SEQUENCE(12, 1, DATE(2024,1,1), 30)
+```
+Creates monthly dates (approximately)
+
+### Weekly Dates
+```excel
+=SEQUENCE(52, 1, DATE(2024,1,1), 7)
+```
+
+## RANDARRAY Function
+
+### Random Numbers
+```excel
+=RANDARRAY(5, 3)
+```
+5 rows x 3 columns of random decimals
+
+### Random Integers
+```excel
+=RANDARRAY(10, 1, 1, 100, TRUE)
+```
+10 random integers between 1 and 100
+
+### Random Sample
+```excel
+=INDEX(tbl_Products, RANDARRAY(5, 1, 1, ROWS(tbl_Products), TRUE), 0)
+```
+5 random rows from table
+
+## LET Function
+
+### Basic LET (Named Variables)
+```excel
+=LET(
+    sales, SUM(tbl_Sales[Amount]),
+    target, 100000,
+    variance, sales - target,
+    IF(variance >= 0, "Above Target", "Below Target")
+)
+```
+
+### LET with Complex Calculations
+```excel
+=LET(
+    data, FILTER(tbl_Sales, tbl_Sales[Year]=2024),
+    total, SUM(INDEX(data, , 3)),
+    count, ROWS(data),
+    average, total/count,
+    "Total: " & total & " | Avg: " & ROUND(average, 2)
+)
+```
+
+### Reusing Calculated Values
+```excel
+=LET(
+    filtered, FILTER(tbl_Sales, tbl_Sales[Status]="Active"),
+    sorted, SORT(filtered, 3, -1),
+    top5, TAKE(sorted, 5),
+    top5
+)
+```
+
+## TAKE and DROP Functions (Excel 365+)
+
+### Take First N Rows
+```excel
+=TAKE(tbl_Sales, 10)
+```
+
+### Take Last N Rows
+```excel
+=TAKE(tbl_Sales, -10)
+```
+
+### Take First N Columns
+```excel
+=TAKE(tbl_Sales, , 3)
+```
+
+### Drop First N Rows
+```excel
+=DROP(tbl_Sales, 1)
+```
+
+### Combine for Middle Section
+```excel
+=DROP(TAKE(tbl_Sales, 20), 10)
+```
+Rows 11-20
+
+## CHOOSECOLS and CHOOSEROWS
+
+### Select Specific Columns
+```excel
+=CHOOSECOLS(tbl_Sales, 1, 3, 5)
+```
+
+### Select Specific Rows
+```excel
+=CHOOSEROWS(tbl_Sales, 1, 5, 10)
+```
+
+### Reorder Columns
+```excel
+=CHOOSECOLS(tbl_Sales, 3, 1, 2)
+```
+
+## EXPAND Function
+
+### Expand Array with Default
+```excel
+=EXPAND(A1:C3, 5, 5, 0)
+```
+Expands to 5x5, filling with 0
+
+### Create Padded Table
+```excel
+=EXPAND(FILTER(tbl_Sales, tbl_Sales[Region]="North"), 10, , "")
+```
+Ensures at least 10 rows
+
+## VSTACK and HSTACK
+
+### Stack Vertically
+```excel
+=VSTACK(tbl_Sales2023, tbl_Sales2024)
+```
+
+### Stack Horizontally
+```excel
+=HSTACK(tbl_Info, tbl_Stats)
+```
+
+### Create Header Row
+```excel
+=VSTACK({"Name", "Amount", "Date"}, FILTER(tbl_Sales, tbl_Sales[Amount]>1000))
+```
+
+## TEXTSPLIT and TEXTJOIN
+
+### Split Text to Columns
+```excel
+=TEXTSPLIT(A2, ",")
+```
+
+### Split to Rows and Columns
+```excel
+=TEXTSPLIT(A2, ",", ";")
+```
+- First delimiter: columns
+- Second delimiter: rows
+
+### Join Array to Text
+```excel
+=TEXTJOIN(", ", TRUE, FILTER(tbl_Products[Name], tbl_Products[Active]=TRUE))
+```
+
+## Practical Examples
+
+### Dynamic Top 10 Report
+```excel
+=LET(
+    sorted, SORT(tbl_Sales, 3, -1),
+    top10, TAKE(sorted, 10),
+    VSTACK({"Product", "Region", "Amount"}, CHOOSECOLS(top10, 1, 2, 3))
+)
+```
+
+### Pivot-like Summary
+```excel
+=LET(
+    regions, UNIQUE(tbl_Sales[Region]),
+    totals, MAP(regions, LAMBDA(r, SUMIF(tbl_Sales[Region], r, tbl_Sales[Amount]))),
+    HSTACK(regions, totals)
+)
+```
+
+### Dynamic Validation List
+```excel
+=SORT(UNIQUE(FILTER(tbl_Products[Name], tbl_Products[Category]=A1)))
+```
+
+## Usage Notes
+
+- Dynamic arrays spill automatically to adjacent cells
+- Use `@` operator to get single value: `=@SORT(A:A)`
+- Reference spill range with `#`: `=SUM(A1#)`
+- LET improves readability and performance
+- Combine functions for powerful one-formula solutions
+- Test with empty results and large datasets

package/library/snippets/excel-formulas/lookups.md

@@ -0,0 +1,169 @@
+# Excel Lookup Formulas
+
+Reusable patterns for data lookups in Excel.
+
+## XLOOKUP (Excel 365+)
+
+### Basic XLOOKUP
+```excel
+=XLOOKUP(A2, tbl_Products[ID], tbl_Products[Name])
+```
+
+### XLOOKUP with Default Value
+```excel
+=XLOOKUP(A2, tbl_Products[ID], tbl_Products[Name], "Not Found")
+```
+
+### XLOOKUP Return Multiple Columns
+```excel
+=XLOOKUP(A2, tbl_Products[ID], tbl_Products[Name]:tbl_Products[Price])
+```
+
+### XLOOKUP Approximate Match (Closest)
+```excel
+=XLOOKUP(A2, tbl_Brackets[Min], tbl_Brackets[Rate], , 1)
+```
+- `-1`: Exact match or next smaller
+- `1`: Exact match or next larger
+
+### XLOOKUP from Right to Left
+```excel
+=XLOOKUP(A2, tbl_Data[Email], tbl_Data[Name], , 0, -1)
+```
+- Last parameter `-1` searches from last to first
+
+### Nested XLOOKUP (Two-Dimensional)
+```excel
+=XLOOKUP(B1, tbl_Matrix[Header], XLOOKUP(A2, tbl_Matrix[RowHeader], tbl_Matrix[Data]))
+```
+
+## VLOOKUP / HLOOKUP
+
+### Basic VLOOKUP
+```excel
+=VLOOKUP(A2, tbl_Products, 3, FALSE)
+```
+
+### VLOOKUP with MATCH for Dynamic Column
+```excel
+=VLOOKUP(A2, tbl_Products, MATCH(B1, tbl_Products[#Headers], 0), FALSE)
+```
+
+### HLOOKUP
+```excel
+=HLOOKUP(A1, tbl_Monthly, 3, FALSE)
+```
+
+## INDEX/MATCH
+
+### Basic INDEX/MATCH
+```excel
+=INDEX(tbl_Products[Name], MATCH(A2, tbl_Products[ID], 0))
+```
+
+### INDEX/MATCH with Multiple Criteria
+```excel
+=INDEX(tbl_Sales[Amount], MATCH(1, (tbl_Sales[Product]=A2)*(tbl_Sales[Region]=B2), 0))
+```
+Note: Enter as array formula (Ctrl+Shift+Enter) in older Excel
+
+### Two-Way INDEX/MATCH
+```excel
+=INDEX(tbl_Matrix, MATCH(A2, tbl_Matrix[RowHeader], 0), MATCH(B1, tbl_Matrix[#Headers], 0))
+```
+
+### INDEX/MATCH Return Multiple Columns
+```excel
+=INDEX(tbl_Products, MATCH(A2, tbl_Products[ID], 0), 0)
+```
+- Column `0` returns entire row
+
+## Multiple Criteria Lookups
+
+### XLOOKUP with Concatenated Key
+```excel
+=XLOOKUP(A2&B2, tbl_Data[Product]&tbl_Data[Region], tbl_Data[Sales], "Not Found")
+```
+
+### SUMIFS for Sum with Criteria
+```excel
+=SUMIFS(tbl_Sales[Amount], tbl_Sales[Product], A2, tbl_Sales[Region], B2)
+```
+
+### FILTER for Multiple Results
+```excel
+=FILTER(tbl_Sales, (tbl_Sales[Product]=A2)*(tbl_Sales[Amount]>1000), "No results")
+```
+
+## Approximate Match Lookups
+
+### XLOOKUP Approximate (Tax Brackets)
+```excel
+=XLOOKUP(A2, tbl_TaxBrackets[MinIncome], tbl_TaxBrackets[Rate], 0, -1)
+```
+
+### VLOOKUP Approximate
+```excel
+=VLOOKUP(A2, tbl_Grades, 2, TRUE)
+```
+Note: Data must be sorted ascending
+
+### Grading with IFS
+```excel
+=IFS(A2>=90, "A", A2>=80, "B", A2>=70, "C", A2>=60, "D", TRUE, "F")
+```
+
+## Error Handling
+
+### XLOOKUP with IFERROR (Legacy Compatibility)
+```excel
+=IFERROR(XLOOKUP(A2, Range1, Range2), "Not Found")
+```
+
+### VLOOKUP with IFERROR
+```excel
+=IFERROR(VLOOKUP(A2, tbl_Products, 3, FALSE), "Not Found")
+```
+
+### Check if Value Exists
+```excel
+=IF(ISNA(MATCH(A2, tbl_Products[ID], 0)), "Not Found", "Found")
+```
+
+## Fuzzy Matching
+
+### Partial Match with Wildcards
+```excel
+=XLOOKUP("*"&A2&"*", tbl_Products[Name], tbl_Products[ID], "Not Found", 2)
+```
+
+### First Word Match
+```excel
+=XLOOKUP(LEFT(A2, FIND(" ", A2)-1)&"*", tbl_Products[Name], tbl_Products[ID], "Not Found", 2)
+```
+
+## Dynamic Arrays
+
+### Return All Matches
+```excel
+=FILTER(tbl_Sales, tbl_Sales[Product]=A2)
+```
+
+### Unique Values from Lookup
+```excel
+=UNIQUE(FILTER(tbl_Sales[Customer], tbl_Sales[Product]=A2))
+```
+
+### Sorted Lookup Results
+```excel
+=SORT(FILTER(tbl_Sales, tbl_Sales[Region]=A2), 1, 1)
+```
+
+## Usage Notes
+
+- Prefer XLOOKUP over VLOOKUP for new spreadsheets
+- Use structured references (Table[Column]) for clarity
+- XLOOKUP handles #N/A with built-in default value
+- INDEX/MATCH is more flexible than VLOOKUP
+- Consider FILTER for returning multiple matches
+- Test with edge cases: blank cells, duplicates, not found