- commit
- f22c4e22f03e662449a79a8a7dfb62534e08a5b3
- parent
- 1a7238b0aa4c4dd301aaf927490f12c63a6ac713
- parent
- 85d231f3b2f76254018c547a71a4896ae31cbf80
- author
- Dami <dami.etoile@gmail.com>
@@ -7,7 +7,7 @@ GHOSTTY_SRC := $(DEPS)/ghostty-src
77 GHOSTTY_OUT := $(DEPS)/ghostty88 GHOSTTY_STAMP := $(GHOSTTY_OUT)/.built-$(GHOSTTY_COMMIT)99 10-10+1111 1212 build:1313 CGO_ENABLED=0 go build -o bin/012 ./cmd/012@@ -25,13 +25,14 @@ test:
2525 STRESS_DIR=$(DEPS)/stress go test ./...2626 2727 # Everything that must pass before a push: formatting, vet (also with the28-# stress benchmarks), shape limits, unit tests, the excelize oracle and the29-# end-to-end tests in libghostty.28+# stress benchmarks), shape limits, unit tests, the speed gate, the29+# excelize oracle and the end-to-end tests in libghostty.3030 check:3131 @test -z "$$(gofmt -l cmd internal demos e2e oracle)" || { gofmt -l cmd internal demos e2e oracle; echo "gofmt: files above need formatting"; exit 1; }3232 go vet -tags stress ./...3333 $(MAKE) lint3434 STRESS_DIR=$(DEPS)/stress go test ./...35+ $(MAKE) speed3536 $(MAKE) oracle3637 $(MAKE) e2e3738 @@ -40,9 +41,20 @@ lint:
4041 go vet ./...4142 scripts/lint.sh4243 44+# The speed gate: frames and recalculation on mid-sized sheets against45+# internal/ui/testdata/speed.json, in about two seconds, alone so that46+# no other package's tests share the CPU. speed-update rewrites the47+# baseline. See docs/contributing/limits.md#the-speed-gate.48+speed:49+ go test ./internal/ui -run '^TestSpeed$$' -count=1 -speed50+51+speed-update:52+ go test ./internal/ui -run '^TestSpeed$$' -count=1 -speed-update -v53+4354 fuzz:4455 go test ./internal/sheet -run '^$$' -fuzz FuzzParse -fuzztime 60s4556 go test ./internal/sheet -run '^$$' -fuzz FuzzRead -fuzztime 60s57+ go test ./internal/sheet -run '^$$' -fuzz FuzzRandomEdits -fuzztime 60s4658 go test ./internal/fileio -run '^$$' -fuzz FuzzReadDelimited -fuzztime 60s4759 go test ./internal/fileio -run '^$$' -fuzz FuzzReadWK1 -fuzztime 60s4860 go test ./internal/fileio -run '^$$' -fuzz 'FuzzReadXLSX$$' -fuzztime 60s@@ -29,7 +29,9 @@ rest: building from a clone, importing files, `012 serve` and settings.
2929 suggestions and argument hints, pointing at cells with the arrows or the3030 mouse, named ranges, references between sheets, arrays that spill3131 (FILTER, SORT, UNIQUE, LAMBDA), optional decimal32- arithmetic for money, and undo for everything32+ arithmetic for money, undo for everything, and33+ [tracing](docs/formulas/tracing.md) that marks what a formula reads34+ and what reads it and steps through it part by part3335 ([formulas](docs/formulas/README.md)); numbers, dates and formulas3436 typed and shown in a [locale](docs/sheets/locale.md) per file.3537 - **Data tools**: freeze, sort, filter, find and replace, conditional@@ -57,18 +57,14 @@ shared editing in section 3.
5757 5858 | Item | Result | Size |5959 |---|---|---|60-| Files saved by each release kept as fixtures that every later build opens and saves unchanged; the `.012` format written down with a version | Old files keep opening | S |61-| Random sequences of edits, sorts, fills and region runs checked for invariants: undo all restores the start, save and reopen match, a full recalc agrees with the incremental one | Bugs between features found before users hit them | M |6260 | A workbook of formulas where 012 matches Sheets on purpose (dates, text, rounding, errors, spills), results checked once in Sheets and asserted after; differences chosen on purpose listed in the docs | Formula results people rely on stay put | S |63-| Frame time and recalculation checked in `make check` against a baseline with a noise margin | Slowdowns fail the check, not a later benchmark | S |64-| A panic in any session saves the workbook for recovery and writes a short report, tested end to end | A crash loses nothing | S |61+| Cycles found from the formulas as written rather than as evaluation walks them: a cycle behind an error that ends a range read or an IF branch not taken, and arrays and notebook outputs in each other's way, settle the same whatever order they're computed in (`-randedit.seeds=20000` still finds about one sequence in 2,500 that reopens differently, and `randKnown` skips one of the default seeds) | Every workbook reads the same when reopened | M |6562 | A week of real use by the owner, problems triaged into this page | Rough edges found by use | S |6663 6764 ### 5. Around the grid6865 6966 | Item | Result | Size |7067 |---|---|---|71-| Formula tracing: precedents and dependents shown in the grid, a formula evaluated step by step | Finding why a number is wrong | M |7268 | Named tables with structured references (`Sales[Amount]`); notebook regions are tables | Formulas that read by column name | M |7369 | A sheet or chart exported as a static HTML page in 012's look | Sharing a sheet with someone without 012 | S |7470 | Release archives and an install script served from the owner's nzip server | Installing without Go | S |@@ -106,7 +102,8 @@ stream above rather than a design of their own.
106102 107103 - Sheets-structured menus, a command palette and a key for every command: [Keys and mouse](docs/reference/keys.md)108104 - Formula suggestions, argument hints and pointing at cells and sheets: [Building formulas](docs/formulas/building.md)109-- Tracing precedents and dependents, hidden sheets explained: [Building formulas](docs/formulas/building.md)105+- Tracing precedents and dependents, hidden sheets explained: [Tracing formulas](docs/formulas/tracing.md#stepping-through-them)106+- Formula tracing: precedents and dependents marked in the grid as the pointer moves, named ranges, spills, regions and their sources included, listed to go to, and a formula evaluated step by step: [Tracing formulas](docs/formulas/tracing.md)110107 - An optional vim keymap with a `:` command line: [Keys and mouse](docs/reference/keys.md#vim-keys)111108 - Vim `.` repeat, registers, marks, `cc` and `s`, `:` line history and `:w!`: [Keys and mouse](docs/reference/keys.md#vim-keys)112109 @@ -147,6 +144,8 @@ stream above rather than a design of their own.
147144 - Commands for scripts without the screen: `012 get` (text, CSV, TSV, JSON or NUON), `012 set`, `012 recalc` and `012 export`, running notebooks and JEV only behind flags: [Scripts](docs/files/scripts.md)148145 - `012 diff` cell by cell, as git's diff command or textconv, and `012 merge-driver` merging cell by cell with conflicts noted on the cells: [Diff and merge in git](docs/files/git.md)149146 - Following files: a linked region follows a CSV, TSV, JSON lines or NUON file as it grows and any importable file as it's rewritten, keeping every row or the last ones, its rows arriving as the change stream: [Following files](docs/files/following.md)147+- The `.012` format written down with a version, and each release's workbooks kept as fixtures that every later build opens and saves unchanged: [The .012 format](docs/files/format.md#versions), [Releasing](docs/contributing/releasing.md#file-fixtures)148+- A crash keeps unsaved work for recovery, restores the terminal and writes a report, locally and in `012 serve`: [Saving](docs/files/saving.md#if-012-crashes)150149 151150 **Upkeep**152151 @@ -155,3 +154,5 @@ stream above rather than a design of their own.
155154 - `make stress-report` flags regressions against the last release's run, allowing for noise: [Observability](docs/contributing/observability.md#regressions-against-the-last-release)156155 - Grafana: recent traces and a trace view of the nested spans: [Observability](docs/contributing/observability.md#the-stack)157156 - Every overlay, prompts and formula suggestions behind narrow hosts, most in packages of their own with fake-host tests: [Architecture](docs/contributing/architecture.md#the-ui)157+- Random sequences of edits, pastes, fills, sorts, inserts, formats and region runs checked for undo, reopening and full recalculation agreeing: [Testing](docs/contributing/testing.md#unit-tests)158+- Frame time and recalculation held to a checked-in baseline in `make check`: [Bounds of support](docs/contributing/limits.md#the-speed-gate)@@ -0,0 +1,78 @@
1+package main2+3+import (4+ "errors"5+ "fmt"6+ "path/filepath"7+ "strings"8+ "time"9+10+ "github.com/FelineStateMachine/012/internal/config"11+ "github.com/FelineStateMachine/012/internal/fileio"12+ "github.com/FelineStateMachine/012/internal/ui"13+)14+15+// When the UI stops on an internal error (a panic, which ui.Guard16+// catches), the terminal is already restored; what's left is to keep17+// the unsaved work where the next start on that file offers it back,18+// write a report, and say where both are. See docs/files/saving.md.19+20+// recoveryDir is where local sessions keep unsaved work after a crash,21+// <config.Dir>/recovery; "" when there's no config directory.22+func recoveryDir() string {23+ d, err := config.Dir()24+ if err != nil {25+ return ""26+ }27+ return filepath.Join(d, "recovery")28+}29+30+// crashDir is where crash reports go, <config.Dir>/crashes.31+func crashDir() string {32+ d, err := config.Dir()33+ if err != nil {34+ return ""35+ }36+ return filepath.Join(d, "crashes")37+}38+39+// offersKept reports whether a session started on args, reading40+// standard input or not, offers the changes a crash kept: when it opens41+// a .012 file or nothing, not when it imports a file or reads a table.42+func offersKept(args []string, stdin bool) bool {43+ if stdin {44+ return false45+ }46+ if len(args) == 1 {47+ if _, imports := fileio.KindOf(args[0]); imports {48+ return false49+ }50+ }51+ return true52+}53+54+// crashed keeps the unsaved work of the program g ran, writes the55+// report, and returns the error that tells the user where both are.56+func crashed(g *ui.Guarded, c *ui.Crash) error {57+ now := time.Now()58+ m := g.Model()59+ kept, keepErr := g.Keep(now)60+ lines := []string{fmt.Sprintf("stopped on an internal error (a panic in %s: %v)", c.Where, c.Value)}61+ switch {62+ case keepErr != nil:63+ lines = append(lines, "couldn't keep the unsaved changes: "+keepErr.Error())64+ case kept != "" && m.Filename() == "":65+ lines = append(lines, "unsaved changes kept in "+kept+"; start 012 again to restore them")66+ case kept != "":67+ lines = append(lines, "unsaved changes kept in "+kept+"; open "+m.Filename()+" again to restore them")68+ }69+ if dir := crashDir(); dir != "" {70+ report, err := c.Report(dir, buildVersion(), m.Filename(), kept, keepErr, now)71+ if err != nil {72+ lines = append(lines, "couldn't write a report: "+err.Error())73+ } else {74+ lines = append(lines, "a report is in "+report+"; include it when reporting the problem")75+ }76+ }77+ return errors.New(strings.Join(lines, "\n012: "))78+}@@ -144,6 +144,8 @@ func run(args []string, e env) error {
144144 Keys: keyStore(cfg, e),145145 Connect: func(key string) (jev.Client, error) { return jev.NewClient(jevConfig(cfg, key)) },146146 Notes: configNotes(cfg),147+ // Where a crash keeps unsaved work: crash.go.148+ RecoveryDir: recoveryDir(),147149 }148150 client, notes := startJEV(cfg, e, settings.Keys)149151 settings.Notes = append(settings.Notes, notes...)@@ -154,13 +156,20 @@ func run(args []string, e env) error {
154156 if notebook {155157 m.OpenNotebook()156158 }159+ if offersKept(args, pipe.stdin) {160+ m.OfferKept()161+ }157162 setPipe(m, pipe, e.stdin)158163 opts, closeTTY, err := tuiOptions(pipe, e)159164 if err != nil {160165 return err161166 }162- err = e.runTUI(m, opts...)167+ g := ui.Guard(m)168+ err = e.runTUI(g, opts...)163169 closeTTY()170+ if c := g.Finish(err); c != nil {171+ return crashed(g, c)172+ }164173 if err != nil {165174 return err166175 }@@ -0,0 +1,54 @@
1+# Tracing: with precedents and dependents shown, the pointer on North's2+# revenue marks the regions and revenues it reads and the price per unit3+# that reads it; then Evaluate formula steps through the price, into4+# the revenue it reads and back out.5+Output out/tracing.gif6+Source lib/setup.tape7+8+Hide9+Type "../bin/012 data/sales.csv" Enter10+Sleep 2s11+Ctrl+G12+Type "F1" Enter13+Type "North" Enter14+Type@40ms '=SUMIF(A2:A17,"North",D2:D17)' Enter15+Type "Units" Enter16+Type@40ms '=SUMIF(A2:A17,"North",C2:C17)' Enter17+Type "Per unit" Enter18+Type@40ms "=F2/F4" Enter19+Show20+21+Sleep 800ms22+Ctrl+K23+Type@60ms "show precedents"24+Sleep 800ms25+Enter26+Sleep 3s27+Ctrl+G28+Type "F2" Enter29+Sleep 3s30+Screenshot out/stills/tracing-marks.png31+Down@600ms 232+Sleep 1.5s33+Down@600ms 234+Sleep 2s35+Ctrl+K36+Type@60ms "evaluate formula"37+Sleep 800ms38+Enter39+Sleep 1.5s40+Right41+Sleep 1.5s42+Screenshot out/stills/tracing-into.png43+Enter44+Sleep 1.2s45+Left46+Sleep 1.5s47+Screenshot out/stills/tracing-evaluate.png48+Enter49+Sleep 1.2s50+Enter51+Sleep 2s52+Screenshot out/stills/tracing-value.png53+Escape54+Sleep 1s@@ -43,6 +43,7 @@ internal/ui the Bubble Tea model: modes, menus, overlays, rendering
4343 cmdline the : command line and its completions4444 nbview a notebook tab as Jupyter's: its toolbar, cells, outputs, command and edit modes, mouse, the code editor and its language providers4545 findbar find and replace, a bar on the context line46+ evalview Data > Evaluate formula: a formula stepped through part by part4647 themepicker File > Settings > Theme, previewing as it moves4748 rules the conditional formatting and data validation panel4849 sortbar the sort bar: the columns and order to sort a range by@@ -399,8 +400,12 @@ recalculations, so the buffers are made once. See
399400 What stays in the engine is what needs cells or the workbook: the400401 running aggregates' storage and extension (`rangememo.go`), the links a401402 HYPERLINK cell opens (`link.go`), the questions a cell's JEV formulas ask402-(`RemoteCalls`), explaining errors (`explain.go`) and the decimal403-setting (`SetDecimal`, which marks formulas with `functions.Decimalize`).403+(`RemoteCalls`), explaining errors (`explain.go`), tracing precedents404+and dependents through the dependency indexes (`trace.go`,405+`tracedeps.go`), stepping through a formula (`steps.go`, where the406+function library records each part's value where it stands,407+`functions.EvalParts`) and the decimal setting (`SetDecimal`, which408+marks formulas with `functions.Decimalize`).404409 405410 ### Where the engine can grow406411 @@ -476,14 +481,14 @@ draw. The components:
476481 | edit line | `lineedit.Line` | the one-line editor shared by cell entries, prompts and search fields (package `lineedit`) |477482 | cell entry | `entry`, `suggest.List` | typing into a cell, pointing at references, other sheets while pointing (`entry.go`, `assistsheets.go`); formula suggestions and signatures (package `suggest`, with `assist.go`) |478483 | prompt | `prompt` | a question on the context line, typed or pointed at (`prompt.go`) |479-| overlays | `overlay.Overlay` | whatever has taken over input: menus (`menuoverlay.go`), the palette and pickers (package `picker`, with `palette.go`, `names.go`), the command line (package `cmdline`), the theme picker (package `themepicker`), the find bar (package `findbar`), the filter picker (package `filterpick`, with `filter.go`), the sort bar (package `sortbar`, with `sort.go`), choice bars (package `choicebar`, with `dialog.go`), the chart editor and selection (`charteditor.go`, `chartsel.go`), the pivot editor (`pivoteditor.go`, `pivotactions.go`), the rules panel (package `rules`, with `rules.go`), the shortcuts (package `shortcuts`, with `help.go`) |484+| overlays | `overlay.Overlay` | whatever has taken over input: menus (`menuoverlay.go`), the palette and pickers (package `picker`, with `palette.go`, `names.go`), the command line (package `cmdline`), the theme picker (package `themepicker`), the find bar (package `findbar`), the filter picker (package `filterpick`, with `filter.go`), the sort bar (package `sortbar`, with `sort.go`), choice bars (package `choicebar`, with `dialog.go`), the chart editor and selection (`charteditor.go`, `chartsel.go`), the pivot editor (`pivoteditor.go`, `pivotactions.go`), the rules panel (package `rules`, with `rules.go`), the shortcuts (package `shortcuts`, with `help.go`), Evaluate formula (package `evalview`, with `evaluate.go`) |480485 | sheet tabs | `tabstrip.Strip` | where each sheet was left, the tab strip's scroll and layout (package `tabstrip`); what clicks on it do (`tabstrip.go`) |481486 | mouse | `mouseState` | drags, hover, double clicks, the fill handle (`mouse.go`, `fill.go`) |482487 | import | `transfer.Transfer`, `pipeState` | the import in progress, its progress display and cancelling (package `transfer`); choosing and placing imports (`transfer.go`, `importplace.go`); standard input read as a sheet, and what a pipeline gets on quitting (`pipe.go`) |483488 | linked files | `followState` | a source (`live.Source`) for each linked region, polled one poll at a time on a command every `live.Interval` and reconciled with the workbook after every update, so undo, opening a file and unlinking need nothing of their own; trust in files outside a workbook's folder (`follow.go`); Data > Linked file and Import's Follow the file (`linked.go`) |484489 | notebooks | `nbview.View`, `nbState` | a view of each notebook tab, its selection, mode, scroll and editor (package `nbview`); the tab on the screen (`nbscreen.go`); the notebook's commands and keys (`notebook.go`); cells running one at a time in the background, their queue, stale outputs, trust (`nbrun.go`); what a run reads (`nbjob.go`); outputs sent to sheets (`nbsend.go`) |485490 | macros | `recorder`, `macroState` | a recording in progress (`macrorec.go`); a macro running, trust in the file's macros (`macrorun.go`); what scripts act on (`macrohost.go`, `macrohostnav.go`); Data > Macros and the manager (`macro.go`, `macromanage.go`) |486-| others | `clipboard`, `trace`, `chartState`, `jevRunner`, `terminal`, `session` | what Ctrl+V pastes, a trace being shown, chart commands' target, JEV questions in flight, what the terminal supports and the chart images sent to it, what outlasts the file open (the `:` history, whether keys can be held: `keyboard.go`) |491+| others | `clipboard`, `trace`, `traceView`, `chartState`, `jevRunner`, `terminal`, `session` | what Ctrl+V pastes, a trace being stepped through and tracing that stays on (`traceview.go`), chart commands' target, JEV questions in flight, what the terminal supports and the chart images sent to it, what outlasts the file open (the `:` history, whether keys can be held: `keyboard.go`) |487492 488493 Overlays implement `overlay.Overlay` (package `overlay`): an indicator for489494 the mode, `Key` and `Mouse` handlers, a `Layout` of boxes to draw, and@@ -505,6 +510,7 @@ methods off `ui.Model`'s exported API:
505510 | `picker` | `picker.Host` | theme, size, the edit line, close, record the answer to a command's question (5) |506511 | `choicebar` | `choicebar.Host` | theme, close, record the key chosen (3); the choices are closures over the model |507512 | `shortcuts` | `shortcuts.Host` | theme, size, close, the rows, built from the key bindings and the registry (4) |513+| `evalview` | `evalview.Host` | theme, size, close, the locale (4); the formula's steps are the engine's `sheet.Steps` |508514 | `sortbar` | `sortbar.Host` | theme, size, the sheet, close, sort (recorded as the bar's command) (5) |509515 | `filterpick` | `filterpick.Host` | theme, size, the edit line, close, the locale (5); what applying and cancelling do are callbacks, as the sheet's filter and a pivot's differ |510516 | `cmdline` | `cmdline.Host` | theme, size, the edit line, close, the commands to complete, run a line, fail, the session's history (8) |@@ -555,7 +561,7 @@ hints) are what every overlay is drawn with.
555561 **Packages.** `theme`, `rowtext`, `formula`, `overlay` and `lineedit`556562 depend on nothing in `ui`, so they can be tested and measured alone. The557563 components in `picker`, `cmdline`, `nbview`, `themepicker`, `findbar`, `rules`,558-`sortbar`, `filterpick`, `choicebar`, `shortcuts`, `suggest`, `tabstrip`564+`sortbar`, `filterpick`, `choicebar`, `shortcuts`, `evalview`, `suggest`, `tabstrip`559565 and `transfer` build on them and reach the model only through their560566 hosts, with unit tests of their own against fake hosts. A component moves out of package561567 `ui` when its host stays small (about ten methods or fewer); one that@@ -29,6 +29,7 @@ it lags, and past a second it stalls.
2929 | Incremental recalc | A change that makes formulas read under about 500,000 cells in total (fan-out, chains and volatiles of 8192 cells: 1.3 to 1.9 ms); 1000 SUMs over a full column: 0.53 ms; 8192 running totals: 2.7 ms | 60 criteria functions (SUMIF, COUNTIFS, AVERAGEIF) over whole columns of 8192 rows: 29 ms an edit | | About 3 ns per cell read: an index into the column's block |3030 | Full recalc | Any sheet: numbers and text hold their values and cost nothing; 1000 full-column SUMs 0.5 ms; 8192 running totals 1.8 ms | 60 whole-column criteria functions over 8192 rows: 44 ms | | Same as above |3131 | Rendering | Any sheet at up to 200 x 60: 1.3 ms a frame; 400 x 120: 4.2 ms; a color scale on every cell shown adds 0.4 ms at 200 x 60, borders on every cell and wrapped text 0.4 ms | 20 charts at 400 x 120: 6 ms | | View building styled strings, then Bubble Tea parsing and diffing them |32+| Tracing (`BenchmarkTrace`) | An arrow key through to its frame at 200 x 60 with tracing on, on a million cells: a chain of a million formulas 0.66 ms (0.64 off), a million numbers 0.82 ms (0.82 off), a cell read by a million formulas 1.6 ms (0.85 off); off, it costs nothing | | A cell's dependents listed past a thousand: the list says there are more | Finding a cell's links (dependents capped at a thousand), and asking each formula on screen whether it reads the cell |3233 | Selection statistics | Any selection: extending one over all 2.1 M cells of 8192 x 256 costs 0.3 ms a key | | | Per column with data, 1024 or 64 rows at a time from an index on the blocks of filled cells, plus the rows at the selection's ends |3334 | Imports | CSV, SQLite, Parquet: 2 to 4 M cells/s (a million cells in 0.25 to 0.4 s); XLSX numbers or text: 0.8 to 1.4 M cells/s | XLSX with formulas: 0.4 to 0.6 M cells/s | Data past `max-cells` or the grid (dropped, with a note); XLSX files past the reader's limits (refused) | Building cells one at a time; XML decoding; XLSX formula translation |3435 | Undo | One step of any size: undo costs what the edit cost; clearing all ten million cells of a full sheet holds 193 MB | History capped at 100 steps and 256 MB of before-images: 100 whole-column steps hold 15 MB | A step past 1 GB (millions of formulas or long distinct texts at once): asks, and runs without undo if told to | Before-images in the store's form: a slot (20 B) per plain cell, a whole `Cell` per formula |@@ -624,3 +625,48 @@ overhead), `internal/fileio/stress_test.go` (imports and exports),
624625 `internal/stress`, up to `dense-1Mx10`, ten million numbers, the625626 default `max-cells`. Results accumulate in `.deps/stress/results` and, with626627 the observability stack up, in ClickHouse.628+629+### The speed gate630+631+`make speed`, part of `make check`, catches a clear slowdown before a632+push rather than at the next stress run. `TestSpeed`633+(`internal/ui/speed_test.go`) builds mid-sized sheets with634+`internal/stress` and draws frames through the stress benchmarks' fake635+terminal, so it measures what `BenchmarkKeystroke` and `BenchmarkEdit`636+do, on fewer cases and briefly: an arrow key through to its frame at637+200 x 60 (dense, laid out, color scale and chart sheets of 8192 rows),638+single edits (fan-in, a chain, criteria functions, lookups) and full639+recalculations (running totals, arrays). It takes about two seconds.640+641+Each case is held to `internal/ui/testdata/speed.json` two ways:642+643+- **Allocations** an operation, counted with `testing.AllocsPerRun`,644+ so the same code gives the same count on any machine and under any645+ load. A case fails past 1.25 times its baseline plus 16.646+- **Time** relative to a calibration workload (formatting numbers,647+ string map lookups, sorting) timed beside it in the same process,648+ the fastest of seven timings of each, so a slower or busier machine649+ slows both. A case fails past twice its baseline's ratio. Ratios650+ still differ between CPUs, so they are compared only on the651+ baseline's OS and architecture (the file records them); elsewhere652+ only allocations are.653+654+A case over its margin is measured once more before it fails. Runs on655+one machine vary by up to about a third, under load from other tests656+too, well inside the margin; the margins are for regressions of a657+multiple, and finer ones are what `make stress-report` is for.658+659+The gate runs alone (`go test ./...` skips `TestSpeed` without660+`-speed`), and while it times it holds `/tmp/012-bench.lock`, the lock661+other timed runs on the machine take: with flock(2) when the path is a662+file (`flock /tmp/012-bench.lock make stress` where the `flock` command663+exists), and otherwise as a directory it makes and removes, which needs664+no `flock` command. It waits up to ten minutes for a directory someone665+else holds.666+667+When it fails, run `make speed` again on a quiet machine, then look at668+the case with the stress benchmarks (`BENCH='Keystroke|Edit' make669+stress`). A slowdown that is intended, or a new case, is taken into the670+baseline with `make speed-update`, which measures every case and671+rewrites `speed.json` for the machine it runs on; commit it with the672+change that explains it.@@ -21,7 +21,8 @@ flowchart TD
2121 small -->|no| stress[make stress, make stress-report]2222 small -->|yes| xlsx2323 stress -->|the run recorded on the commit| xlsx[XLSX opened in Excel, LibreOffice, Sheets]24- xlsx --> tag[git tag -a, git push]24+ xlsx --> fixtures[this release's file fixtures committed]25+ fixtures --> tag[git tag -a, git push]2526 tag -->|the module proxy| install[go install ...@v1.2.3]2627 tag --> dist[make dist]2728 dist --> archives[dist/: archives, SHA256SUMS]@@ -42,7 +43,9 @@ flowchart TD
4243 Excel, LibreOffice Calc and Google Sheets: it opens without a repair4344 prompt, and values, formulas and formats read as they did in 012. The4445 automated checks read XLSX with excelize and 012's own reader only.45-4. **Tag** with the release notes as the message, what changed since the46+4. **File fixtures**: the workbooks this release saves, committed (see47+ [File fixtures](#file-fixtures)).48+5. **Tag** with the release notes as the message, what changed since the4649 previous tag for a user, with the install line last:4750 4851 ```sh@@ -52,7 +55,36 @@ flowchart TD
5255 5356 The Go module proxy picks the tag up, so `go install5457 github.com/FelineStateMachine/012/cmd/012@v1.2.3` works from then on.55-5. **Binaries**: `make dist VERSION=v1.2.3` on the tagged commit.58+6. **Binaries**: `make dist VERSION=v1.2.3` on the tagged commit.59+60+## File fixtures61+62+`internal/sheet/testdata/fixtures` holds workbooks as each release saved63+them, a folder per release (`v0.2.0/`), and64+`TestFixturesOpenAndSaveUnchanged` opens every one and saves it again,65+failing unless the bytes come back the same. A later build that can't66+open a release's file, or saves it differently, fails `make check`67+([The .012 format](../files/format.md#versions) says what that68+promises).69+70+The workbooks a release saves are the ones in `fixtures/new`, written by71+hand to use everything the format stores: formats, entries that read72+against their format, column and row formats, widths, heights, merges,73+borders, freeze, filters, names, notes, protection, rules and74+validation, charts, pivot tables, a notebook tab's cells and outputs,75+outputs sent to a sheet, linked files, macros, the locale and decimal76+arithmetic. A release that adds to the format adds what it adds there.77+Then, on the commit to be tagged:78+79+```sh80+go test ./internal/sheet -run TestFixtures -fixtures v1.2.381+```82+83+saves them with that build into `fixtures/v1.2.3`, to commit with the84+release. The test refuses a folder that exists. A released folder is85+never edited or replaced: when a later build saves one differently, the86+build is what changes. The folder of a release not yet tagged may be87+deleted and saved again.5688 5789 ## make dist5890 @@ -6,10 +6,11 @@ sidebar_position: 5
66 # Testing77 88 ```sh9-make check # all of the below that must pass before a push: gofmt, vet, lint, test, oracle, e2e9+make check # all of the below that must pass before a push: gofmt, vet, lint, test, speed, oracle, e2e1010 make lint # go vet, staticcheck, cognitive complexity at most 25, Go files at most 500 lines, doclint and doccheck (see Docs below)1111 make test # engine, file formats and UI unit tests12-make fuzz # fuzz the formula parser and the .012, CSV, .wk1, XLSX and NUON readers12+make fuzz # fuzz the formula parser, random edits, and the .012, CSV, .wk1, XLSX and NUON readers13+make speed # frames and recalculation against a checked-in baseline (see limits.md)1314 make oracle # compare formulas and number formats with excelize1415 make e2e # run the real binary in a terminal emulator (needs Zig and pkg-config)1516 make screens # rewrite the golden screens and build the review gallery@@ -22,7 +23,31 @@ make site # build the docs site, failing on broken links (needs Node; see si
2223 The engine is tested directly: parsing, every function, recalculation,2324 undo, reference rewriting, file round trips. `FuzzRead` holds the2425 streaming `.012` reader to encoding/json decoding the whole file: both25-refuse a file or both read it into workbooks that save the same bytes. The UI is tested by sending26+refuse a file or both read it into workbooks that save the same bytes.27+`TestFixturesOpenAndSaveUnchanged` opens the workbooks every release28+saved and saves them again, byte for byte29+([File fixtures](releasing.md#file-fixtures)).30+31+`TestRandomEdits` (`internal/sheet/randedit_test.go`) checks what holds32+between features: from each of a thousand seeds it builds a workbook33+of two sheets and a notebook tab, makes up to 40 edits drawn from the34+seed (entries, pastes, fills, series, sorts, inserted and deleted rows35+and columns, formats, borders, merges, moves, notes, rules, names,36+sheets, frozen panes, filters, notebook cells, and outputs sent to37+sheets, frozen, deleted and sent rows, with tables standing in for38+nushell's), and checks that undoing every step gives back the file and39+the values it started with, redoing gives back the end, saving and40+reopening gives the same file and values (a recalculation from41+scratch), and recalculating everything in place changes no value.42+Outputs' rows come from outside the undo history, so the test sends43+them again after each edit, undo and reopening, as the UI does. A44+failure names the fewest of the seed's edits that still fail. It takes45+about a second; `-randedit.seeds=20000` runs more, and46+`FuzzRandomEdits` (in `make fuzz`) lets the fuzzer choose the edits.47+Seeds that fail for a reason on the roadmap are listed in `randKnown`,48+with it.49+50+The UI is tested by sending2651 Bubble Tea messages (keys, mouse, paste, window size) to the model and2752 reading what `View` renders, without a terminal.2853 @@ -42,7 +67,10 @@ that macros' trust uses are the test's own: sessions that share a
4267 directory are one computer. The binary is built with `-tags4368 fakekeyring`, whose credential store is a file there, so tests never4469 read your config or touch your keychain. Unit tests do the same with45-`ui.Settings` and `keyring.Memory`.70+`ui.Settings` and `keyring.Memory`. The binary is also built with `-tags71+crashtest`, where F12 panics in the update, the view or a command, as72+the session's environment says (`internal/ui/crashtest.go`), so `e2e/crash_test.go` can check that a crash73+restores the terminal and keeps the work; release builds have no such key.4674 4775 `e2e/ssh_test.go` runs `012 serve` and reaches it with the system's4876 `ssh` client inside the same libghostty terminal, so the server path@@ -105,7 +105,8 @@ there.
105105 | Notes | A `▝` in the cell's top-right corner |106106 | Macro recording | `REC` beside the mode indicator |107107 | Mode | The mode indicator's word (`READY`, `ENTER`, `POINT`, `MENU`, and on a notebook `NOTEBOOK`, `EDIT` or `OUTPUT`) |108-| Search matches, traced cells | Reverse video, with a count or the list on the context line |108+| Search matches, traced cells | Reverse video, with a count or the list on the context line; dependents also bold |109+| Evaluate formula | The part computed next underlined and bold, values in its place italic, and `Next` and `Value` in words |109110 | The copied range | A dashed underline |110111 | Dropdowns, checkboxes, active filters | `▾`, or a chip in reverse video between `▐` and `▌`; `[ ]` and `[✓]`; `▼` instead of `▾` |111112 | Data bars, icon sets | Eighth blocks as long as the number, and reverse video under the text they run beneath; the icon's glyph (`↑`, `◑`, `✓`, `▆`) |@@ -44,7 +44,9 @@ file's rows, typed as an import types them. The region is the file's:
4444 - it grows to the right and down as the file does. Where it would write4545 over a cell holding something, its rows aren't shown, and its first4646 cell (`#REF!`) and the context line say which cell is in the way;47- clearing that cell reads the file again;47+ clearing that cell reads the file again. An [array](../formulas/arrays.md)'s48+ cells, blank ones too, are in its way, and an array that needs its49+ cells takes them, whichever came first, as when the file opens;4850 - inserting or deleting rows or columns before it moves it, and it reads4951 the file again there; deleting its first cell's row or column unlinks5052 it.@@ -6,7 +6,9 @@ sidebar_position: 4
66 # The .012 format77 88 `.012` files are JSON with one line per cell, keyed by address, so diffs9-read naturally and files merge reasonably in version control. A cell9+read naturally and files merge reasonably in version control. This page10+is the format at version 5, the newest; [Versions](#versions) says what11+each version adds and what 012 promises about old files. A cell1012 without formatting is just what was typed; a formatted cell is a small1113 object:1214 @@ -48,6 +50,13 @@ spacing, and the case of field names don't matter. A cell given twice
4850 takes its last entry, though an invalid earlier one is refused; the4951 `version` or the `sheets` list given twice around cells is refused.5052 53+012 writes one form of each workbook: the fields in the order this page54+shows them, cells by row and then column, widths and heights by55+position, column and row formats with the whole sheet's first, then56+columns', then rows', names by name, and charts, rules, regions and57+macros in the order they were made. Saving a file 012 wrote, without58+changing it, gives back the same bytes.59+5160 012 reads and writes the file as a stream, each cell straight into or5261 out of its sheet, so opening a file takes about the memory of the5362 workbook however large the file; what that costs, and why there is no@@ -68,6 +77,21 @@ still load.
6877 | 4 | Several sheets, or a formula naming a sheet | `sheets`, a list; see [Several sheets](#several-sheets) |6978 | 5 | A pivot table | a sheet's `pivot`; see [Pivot tables](#pivot-tables) |7079 80+What stays the same from release to release:81+82+- Every file a release saved opens in every later build, and saving it83+ unchanged gives back its bytes. Each release keeps workbooks it saved84+ as fixtures (`internal/sheet/testdata/fixtures/<release>`), which every85+ build's tests open and save again86+ ([Releasing](../contributing/releasing.md#file-fixtures)).87+- Fields are only added, never renamed or given another meaning; the88+ version rises only for a field older builds can't do without, and the89+ rest are listed under [Fields that need no version](#fields-that-need-no-version).90+- An older build ignores a field it doesn't know, but refuses a value it91+ doesn't know in a field it does (a chart type, a rule's condition such92+ as a date period), rather than open the file with the rule or chart93+ quietly changed.94+7195 ## Fields that need no version7296 7397 Builds that don't know these fields ignore them (and drop them if they@@ -77,6 +101,7 @@ save), so they raise no version:
77101 |---|---|---|78102 | `note` | a cell | Its [note](../sheets/notes-protection.md#notes) |79103 | `own` | a cell | `true` when its formatting is its own, not its column's or row's (Automatic in a currency column) |104+| `text` | a cell | How its `input` reads when its `format` would say otherwise: `true` for text typed into a Plain text cell whose format changed since (`{"input":"007","text":true}`), `false` for a number or formula typed before the cell was formatted as Plain text; either stays as typed, as in Sheets. Older builds read the input as the format says |80105 | `wrap`, `borders` | a cell or a line | How its text [wraps](../sheets/formatting.md#wrapping) and its [borders](../sheets/formatting.md#borders); older builds show the text overflowing, without lines |81106 | `valign`, and colors in `borders` | a cell or a line | Where its text sits in a [tall row](../sheets/formatting.md#vertical-alignment), and its borders' colors; older builds show the text at the bottom and the lines in the text's ink |82107 | `lines` | a sheet | [Column and row formats](#column-and-row-formats) |@@ -17,3 +17,35 @@ Under `012 serve`, a session that idles out or is ended by the server
1717 stopping keeps its unsaved changes in `.012-recovery/` in the served1818 directory, and the next session opening that file offers them back: see1919 [Serving over SSH](../terminal/ssh.md#unsaved-work).20+21+## If 012 crashes22+23+An internal error (a bug, a Go panic) stops 012 rather than leaving24+the terminal broken: the screen goes back to what the shell showed,25+and 012 says what happened and where it put things:26+27+```28+012: stopped on an internal error (a panic in update: ...)29+012: unsaved changes kept in ~/.config/012/recovery/%2FUsers%2Fann%2Fbudget-20260929-101112.012; open budget.012 again to restore them30+012: a report is in ~/.config/012/crashes/crash-20260929-101112.txt; include it when reporting the problem31+```32+33+- **Unsaved changes** are written, the whole workbook, to `recovery/`34+ in 012's config directory (the one `012 config path` prints the35+ [config file](../reference/config.md) of, `~/.config/012` on Linux),36+ named after the file's full path. Opening that37+ file again, or starting `012` on nothing for a sheet never saved,38+ asks on the context line: Enter restores them as unsaved changes to39+ the file, D deletes them, Esc leaves them for next time. Saving a40+ restored workbook removes its recovery file. Nothing is kept without41+ unsaved changes, and only the newest three files per name.42+- **The report** goes to `crashes/` beside it: where the error43+ happened, the error, its stack of calls, 012's version, the system,44+ the file's name and where its changes went, never what the workbook45+ holds. The newest ten are kept.46+47+If the error happened while drawing the screen, the terminal also48+shows the stack of calls above those lines. Under `012 serve`, the49+session's changes go to `.012-recovery/` as above, the client is told50+that 012 stopped on an internal error, and the report goes to the51+server's log.@@ -47,7 +47,7 @@ text. Errors use Sheets' codes:
4747 | `#DIV/0!` | division by zero |4848 | `#VALUE!` | the wrong kind of value, e.g. text in arithmetic |4949 | `#NAME?` | an unknown name |50-| `#REF!` | a reference to deleted cells, or a circular reference |50+| `#REF!` | a reference to deleted cells, or a circular reference: every cell of the cycle, even one whose formula catches errors (`IFERROR`) or skips them (`COUNTIF`), as in Sheets |5151 | `#N/A` | not available, e.g. a lookup found nothing |5252 | `#NUM!` | a number out of range, e.g. `SQRT(-1)` |5353 @@ -72,7 +72,8 @@ numbers as numbers.
7272 | Page | For |7373 |---|---|7474 | [References](references.md) | Cells, ranges, names, other sheets, and a range where one value is wanted |75-| [Building formulas](building.md) | Pointing, suggestions, argument hints, tracing |75+| [Building formulas](building.md) | Pointing, suggestions, argument hints |76+| [Tracing formulas](tracing.md) | Precedents and dependents in the grid, and a formula evaluated step by step |7677 | [Arrays and spills](arrays.md) | FILTER, SORT, UNIQUE, SEQUENCE, ARRAYFORMULA, LET and LAMBDA |7778 | [Decimal arithmetic](decimal.md) | Exact decimal math for money |7879 | [JEV functions](jev.md) | Asking a hosted model from formulas |@@ -61,7 +61,12 @@ When a cell in the way of an array isn't empty, the formula shows
6161 `#REF!` and says why, as Sheets does: "Array result was not expanded6262 because it would overwrite data in C3". Clearing that cell lets the6363 array spill. The same goes for an array that would pass the sheet's64-edge, or write more cells than `max-cells` allows.64+edge, or write more cells than `max-cells` allows. When two arrays need65+the same cells, blank ones of theirs included, the one whose formula66+comes first, row by row, spills and the other shows `#REF!`, whichever67+was typed first, so a sheet looks the same when opened again. An array that would68+spill into cells its formula reads, `=SORT(B8:D9)` in A9, is a circular69+dependency and shows `#REF!` too.6570 6671 ## Names in a formula: LET and LAMBDA6772 @@ -15,11 +15,9 @@ sidebar_position: 3
1515 sheets aren't offered, though formulas still read them.1616 - Inside a function's parentheses the context line shows its signature with1717 the current argument marked, e.g. `SUMIF(range, criterion, [sum_range])`.18-- Alt+, and Alt+. trace precedents and dependents: the cells a formula reads19- and the formulas that read a cell. Press again to step through them.20- Cells on hidden sheets are skipped; when that leaves nothing, the21- context line names the hidden sheets ("Reads only Data, a hidden sheet;22- View > Hidden sheets shows it").18+- Alt+; marks what the active cell's formula reads and the formulas that19+ read it, as the pointer moves; Alt+= steps through a formula one part20+ at a time. See [Tracing formulas](tracing.md).2321 - A formula left Automatic shows the format of what it reads: `=B5*2` of2422 a currency cell shows currency, and so does `=SUM(B2:B9)`. A blank cell2523 counts with its column's, row's or sheet's format, and changing those@@ -0,0 +1,88 @@
1+---2+title: "Tracing formulas"3+sidebar_position: 64+---5+6+# Tracing formulas7+8+When a number looks wrong, trace it: the cells its formula reads (its9+precedents), the formulas that read it (its dependents), and what each10+part of the formula computes.11+12+13+14+## Showing precedents and dependents15+16+Data > Formula tracing > Show precedents and dependents (Alt+;) marks them in the grid as17+the pointer moves: the cells the active cell's formula reads in green,18+the formulas that read the active cell in magenta and bold. Without19+color both are in reverse video, dependents bold as well. The context20+line lists them all, those off screen with an arrow toward them and21+those on other sheets with their sheet:22+23+```24+C7 reads B3, Rate, Data!B2:B9; read by D7, A40↓, Summary!B2 +3 more25+```26+27+Alt+; again stops. What counts as a link:28+29+| The active cell | Its precedents | Its dependents |30+|---|---|---|31+| A formula | the cells and ranges it reads, on any sheet; a named range or a region (`nu.sales`) by its name | the formulas that read it through a reference, a range, a named range or a region's name, on any sheet |32+| A formula whose array spills | as any formula | the cells it spills into, and the formulas reading any of them |33+| A value an array spilled | the formula that spilled it | the formulas reading it |34+| A cell of a linked file or of a notebook output sent to the sheet ([regions](../nushell/notebooks.md)) | the file, or the notebook cell | the formulas reading it, `nu.name` included |35+36+Only direct links show; go to one and tracing shows its own, a level37+further. Excel draws arrows between cells; 012 marks the cells and lists38+the rest, which reads the same for a range on another sheet or far off39+screen.40+41+## Going to one42+43+Data > Formula tracing > Go to a precedent or dependent (Alt+') lists44+the active cell's precedents, then its dependents, with what each is45+(`precedent, named range B2:B9`, `dependent, on Summary`). Type to narrow the46+list; Enter goes to one, selecting a range, showing another sheet, or a47+notebook's cell. A cell read by more than a thousand formulas lists the48+first thousand.49+50+## Stepping through them51+52+Alt+, and Alt+. step through the precedents and the dependents, as53+Excel's Ctrl+[ and Ctrl+], which terminals send as Esc: the first press54+marks them all and jumps to the first, each press after to the next,55+and Esc goes back to the cell traced. Cells on hidden sheets are56+skipped; when that leaves nothing, the context line names the hidden57+sheets ("Reads only Data, a hidden sheet; View > Hidden sheets shows58+it").59+60+## Evaluating a formula step by step61+62+Data > Formula tracing > Evaluate formula (Alt+=), after Excel's63+Evaluate Formula, opens a box over the grid with the active cell's64+formula. The part computed next is underlined, and the line under it65+says what it computes:66+67+```68+┌─ Evaluate D1 ────────────────────────────────────────┐69+│ =IF(TRUE,SUM(A2:A3)*2,A3) │70+├──────────────────────────────────────────────────────┤71+│ Next SUM(A2:A3) = 5 │72+└───────────────────────────────────────────── 2 of 5 ─┘73+```74+75+- Enter puts the value in its place, in italic, and underlines the next76+ part, until the formula's value is all that's left; Enter then starts77+ over.78+- → steps into the underlined part when it's a reference to another79+ formula: the box shows that formula, and its title the way in80+ (`Evaluate D1 › B1`). ← or Esc steps back out, the reference's value81+ in its place. Esc at the first formula closes the box.82+83+The values are what the formula computes where each part stands: an84+array where the part is read as one (`SUM(A1:A9*2)` shows the doubled85+column, `{2;4;…}`), names bound inside `LET`, and nothing for the branch86+`IF`, `IFERROR` or `CHOOSE` didn't take, which stays as written. A blank87+cell reads as 0. The formula is written in the88+[locale's](../sheets/locale.md) syntax, spaced as 012 stores it.Binary file.
@@ -97,7 +97,10 @@ The rest of the formats are in the Format menu.
9797 | Ctrl+F, Ctrl+H | Find; find and replace | [Find and replace](../sheets/find-replace.md) |9898 | Alt+Down | Open the active cell's dropdown (type to search, Enter picks); elsewhere, with a filter on (Data > Create a filter), the column's filter (Space checks values, type to search, or pick a condition) | [validation](../sheets/rules.md#data-validation), [filter](../sheets/sort-filter.md#filter) |9999 | Space | Check or uncheck the selected checkboxes (Insert > Checkbox); elsewhere Space starts an entry | [Conditional formatting and data validation](../sheets/rules.md#data-validation) |100-| Alt+, Alt+. | Trace precedents, dependents: highlight the cells a formula reads, or the formulas that read the cell, and jump to the first; again for the next, Esc to go back (Excel's Ctrl+[ and Ctrl+], which terminals send as Esc) | [Building formulas](../formulas/building.md) |100+| Alt+, Alt+. | Trace precedents, dependents: highlight the cells a formula reads, or the formulas that read the cell, and jump to the first; again for the next, Esc to go back (Excel's Ctrl+[ and Ctrl+], which terminals send as Esc) | [Tracing formulas](../formulas/tracing.md#stepping-through-them) |101+| Alt+; | Show precedents and dependents: mark them as the pointer moves and list them on the context line; again to stop | [Tracing formulas](../formulas/tracing.md) |102+| Alt+' | Go to a precedent or dependent, picked from a list | [Tracing formulas](../formulas/tracing.md#going-to-one) |103+| Alt+= | Evaluate formula: step through the active cell's formula one part at a time; Enter evaluates, → steps into a reference, ← steps out | [Tracing formulas](../formulas/tracing.md#evaluating-a-formula-step-by-step) |101104 | Alt+Shift+F | Frequency table of the active column on a new sheet, as VisiData's Shift+F | [Pivot tables](../sheets/pivots.md#frequency-tables) |102105 | Shift+F2 | Add or edit the active cell's note; Alt+Enter or Shift+Enter starts a new line | [Notes and protection](../sheets/notes-protection.md#notes) |103106 @@ -165,8 +165,9 @@ the cell being written; without it, 012's own highlighting answers.
165165 ## Unsaved work166166 167167 A session that ends without the user quitting, because it was idle for168-`--idle-timeout` or because the server is stopping (Ctrl+C, SIGTERM),169-keeps its unsaved changes: the whole workbook is written to168+`--idle-timeout`, because the server is stopping (Ctrl+C, SIGTERM), or169+because 012 [stopped on an internal error](../files/saving.md#if-012-crashes)170+(whose report goes to the server's log), keeps its unsaved changes: the whole workbook is written to170171 `.012-recovery/<name>-<time>.012` in the served directory, and the171172 client's terminal is told where before the connection closes:172173 @@ -0,0 +1,61 @@
1+package e2e2+3+import (4+ "os"5+ "path/filepath"6+ "strings"7+ "testing"8+9+ ghostty "go.mitchellh.com/libghostty"10+)11+12+// A panic stops 012 with the terminal restored (the primary screen, the13+// cursor shown), the unsaved work kept, and a report written, their14+// paths printed. Opening the file again offers the work back. The15+// binary is built with -tags crashtest, where F12 panics where16+// O12_CRASH_TEST says (internal/ui/crashtest.go).17+func TestPanicKeepsWork(t *testing.T) {18+ for _, where := range []string{"update", "command", "view"} {19+ t.Run(where, func(t *testing.T) {20+ dir := t.TempDir()21+ o := options{dir: dir, env: []string{"O12_CRASH_TEST=" + where}}22+ s := startWith(t, o, "budget.012")23+ s.keys("kept", "<enter>")24+ s.waitFor("kept")25+ s.keys("<f12>")26+ s.waitExit()27+ if scr := s.activeScreen(); scr != ghostty.ScreenPrimary {28+ t.Errorf("active screen after the crash = %v, want primary", scr)29+ }30+ s.mu.Lock()31+ visible, _ := s.vt.CursorVisible()32+ s.mu.Unlock()33+ if !visible {34+ t.Error("the cursor is hidden after the crash")35+ }36+ text := strings.ReplaceAll(s.screen(), "\n", "")37+ recovery, _ := filepath.Glob(filepath.Join(dir, ".config", "012", "recovery", "*budget-*.012"))38+ reports, _ := filepath.Glob(filepath.Join(dir, ".config", "012", "crashes", "crash-*.txt"))39+ if len(recovery) != 1 || len(reports) != 1 {40+ t.Fatalf("recovery files %v, reports %v; screen:\n%s", recovery, reports, s.screen())41+ }42+ for _, want := range []string{"012: stopped on an internal error (a panic in " + strings.Replace(where, "command", "a command", 1), "unsaved changes kept in " + recovery[0] + "; open budget.012 again to restore them",43+ "a report is in " + reports[0]} {44+ if !strings.Contains(text, want) {45+ t.Errorf("the screen lacks %q:\n%s", want, s.screen())46+ }47+ }48+ report, _ := os.ReadFile(reports[0])49+ if !strings.Contains(string(report), "Panic: crash test in ") {50+ t.Errorf("report:\n%s", report)51+ }52+53+ r := startWith(t, options{dir: dir, startsOn: "Unsaved changes to budget.012 were kept."}, "budget.012")54+ r.keys("<enter>")55+ r.waitFor("Restored the kept changes")56+ if !strings.Contains(r.line(gridRow1), "kept") {57+ t.Errorf("A1 after restoring: %q", r.line(gridRow1))58+ }59+ })60+ }61+}@@ -28,8 +28,9 @@ func TestMain(m *testing.M) {
2828 }2929 binPath = filepath.Join(dir, "012")3030 // fakekeyring swaps the OS credential store for a file under31- // XDG_CONFIG_HOME, which every session points at a temporary directory.32- build := exec.Command("go", "build", "-tags", "fakekeyring", "-o", binPath, "./cmd/012")31+ // XDG_CONFIG_HOME, which every session points at a temporary32+ // directory; crashtest makes F12 panic (crash_test.go).33+ build := exec.Command("go", "build", "-tags", "fakekeyring,crashtest", "-o", binPath, "./cmd/012")3334 build.Dir = ".."3435 build.Env = append(os.Environ(), "CGO_ENABLED=0")3536 if out, err := build.CombinedOutput(); err != nil {@@ -124,7 +124,7 @@ var namedKeys = map[string]ghostty.Key{
124124 "up": ghostty.KeyArrowUp, "down": ghostty.KeyArrowDown,125125 "left": ghostty.KeyArrowLeft, "right": ghostty.KeyArrowRight,126126 "pgup": ghostty.KeyPageUp, "pgdown": ghostty.KeyPageDown,127- "f1": ghostty.KeyF1, "f2": ghostty.KeyF2, "f5": ghostty.KeyF5, "f9": ghostty.KeyF9, "f10": ghostty.KeyF10, "f11": ghostty.KeyF11,127+ "f1": ghostty.KeyF1, "f2": ghostty.KeyF2, "f5": ghostty.KeyF5, "f9": ghostty.KeyF9, "f10": ghostty.KeyF10, "f11": ghostty.KeyF11, "f12": ghostty.KeyF12,128128 "space": ghostty.KeySpace,129129 }130130 @@ -15,11 +15,9 @@ func TestLayoutDrawsAndSurvivesSave(t *testing.T) {
1515 tripPlan(s)1616 checkTrip := func(s *session) {1717 s.t.Helper()18- screen := s.screen()18+ // The grid may still be drawing its last rows.1919 for _, want := range []string{"Trip to Lisbon", "┏━━━━━━━━━┯", "┣━════════╪", "│Tram 28 ┃", "┃Total │", "┗━━━━━━━━━┷"} {20- if !strings.Contains(screen, want) {21- t.Errorf("no %q in\n%s", want, screen)22- }20+ s.waitFor(want)2321 }2422 }2523 checkTrip(s)@@ -0,0 +1,49 @@
1+package e2e2+3+// Golden screens for formula tracing: precedents and dependents shown as4+// the pointer moves, the list to go to one, and Evaluate formula, on dark5+// and light terminals and in the high-contrast theme.6+7+// traced is the named-range budget with the total read by a quarter8+// beside it and a yearly figure far below, tracing on at the total.9+func traced(s *session) {10+ named(s)11+ s.keys("<ctrl+g>", "B30", "<enter>", "=B7*12", "<enter>")12+ s.keys("<ctrl+g>", "C7", "<enter>", "=B7/4", "<enter>")13+ s.keys("<ctrl+home>", "<down>", "<down>", "<down>", "<down>", "<down>", "<down>", "<right>", "<alt+;>")14+ s.waitFor("B7 reads Expenses; read by C7, B30↓")15+}16+17+// evaluating is Evaluate formula on B8 with two parts computed.18+func evaluating(s *session) {19+ named(s)20+ s.keys("<alt+=>", "<enter>", "<enter>")21+ s.waitFor("2 of 3")22+}23+24+func init() {25+ screens = append(screens,26+ screen{name: "trace-view", setup: traced},27+ screen{name: "trace-view-light", opts: options{light: true}, setup: traced},28+ screen{name: "trace-view-high-contrast", opts: options{config: highContrastConfig}, setup: traced},29+ screen{name: "trace-view-high-contrast-light", opts: options{light: true, config: highContrastConfig}, setup: traced},30+ screen{name: "trace-list", setup: func(s *session) {31+ traced(s)32+ s.keys("<alt+'>")33+ s.waitFor("Precedents and dependents of B7")34+ }},35+ screen{name: "evaluate", setup: evaluating},36+ screen{name: "evaluate-light", opts: options{light: true}, setup: evaluating},37+ screen{name: "evaluate-high-contrast", opts: options{config: highContrastConfig}, setup: evaluating},38+ screen{name: "evaluate-into", setup: func(s *session) {39+ traced(s)40+ s.keys("<right>", "<alt+=>", "<right>")41+ s.waitFor("Evaluate C7 › B7")42+ }},43+ screen{name: "evaluate-narrow", opts: options{cols: 60, rows: 16}, setup: func(s *session) {44+ named(s)45+ s.keys("<alt+=>", "<enter>")46+ s.waitFor("1 of 3")47+ }},48+ )49+}@@ -0,0 +1,30 @@
1+<pre class="screen"><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">F</span><span style="color:#ffffff;background:#1f1f1f">ile</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">E</span><span style="color:#ffffff;background:#1f1f1f">dit</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">V</span><span style="color:#ffffff;background:#1f1f1f">iew</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">I</span><span style="color:#ffffff;background:#1f1f1f">nsert</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">F</span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">o</span><span style="color:#ffffff;background:#1f1f1f">rmat</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">D</span><span style="color:#ffffff;background:#1f1f1f">ata</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">H</span><span style="color:#ffffff;background:#1f1f1f">elp</span><span style="background:#1f1f1f"> </span><span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">EVAL</span><span style="background:#40e0ff"> </span>2+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">B8</span><span style="background:#3a3a3a"> </span><span style="color:#757575;background:#000000">┌─</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000;font-weight:bold">Evaluate</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000;font-weight:bold">B8</span><span style="background:#000000"> </span><span style="color:#757575;background:#000000">──────────────────────────────────────────────────────────────┐</span><span style="background:#000000"> </span>3+<span style="background:#000000"> </span><span style="color:#757575;background:#000000">│</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">=</span><span style="color:#40e0ff;background:#000000;font-weight:bold;font-style:italic;text-decoration:underline">719.466666666667</span><span style="color:#ffffff;background:#000000;font-weight:bold;text-decoration:underline">*</span><span style="color:#40e0ff;background:#000000;font-weight:bold;font-style:italic;text-decoration:underline">4</span><span style="background:#000000"> </span><span style="color:#757575;background:#000000">│</span><span style="background:#000000"> </span>4+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">A</span><span style="color:#757575;background:#000000">├────────────────────────────────────────────────────────────────────────────┤</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">I</span><span style="background:#3a3a3a"> </span>5+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">1</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Hous</span><span style="color:#757575;background:#000000">│</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">Next</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000;font-weight:bold;text-decoration:underline">AVERAGE(Expenses)*C2</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">=</span><span style="background:#000000"> </span><span style="color:#40e0ff;background:#000000;font-style:italic">2877.86666666667</span><span style="background:#000000"> </span><span style="color:#757575;background:#000000">│</span><span style="background:#000000"> </span>6+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">2</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#757575;background:#000000">└───────────────────────────────────────────────────────────────────</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">2</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">of</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">3</span><span style="background:#000000"> </span><span style="color:#757575;background:#000000">─┘</span><span style="background:#000000"> </span>7+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">3</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Rent</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">1450</span><span style="background:#000000"> </span>8+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">4</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Groceries</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">612.4</span><span style="background:#000000"> </span>9+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">5</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Transit</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">96</span><span style="background:#000000"> </span>10+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">6</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Savings</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">r</span><span style="background:#000000"> </span><span style="color:#ff8080;background:#000000;text-decoration:underline wavy #ff8080">#DIV/0!</span><span style="background:#000000"> </span>11+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">7</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Total</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">2158.4</span><span style="background:#000000"> </span>12+<span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">8</span><span style="background:#40e0ff"> </span><span style="background:#000000"> </span><span style="color:#000000;background:#40e0ff">2877.8667</span><span style="background:#40e0ff"> </span><span style="background:#000000"> </span>13+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">9</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>14+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">10</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>15+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">11</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>16+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">12</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>17+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">13</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>18+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">14</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>19+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">15</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>20+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">16</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>21+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">17</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>22+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">18</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>23+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">19</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>24+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">20</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>25+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">21</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>26+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">22</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>27+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">23</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>28+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">24</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>29+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">25</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>30+<span style="color:#ffffff;background:#1f1f1f">The</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">underlined</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">part</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">is</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">computed</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">next</span><span style="background:#1f1f1f"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Enter</span><span style="background:#3a3a3a"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">evaluate</span><span style="background:#1f1f1f"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Esc</span><span style="background:#3a3a3a"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">close</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">EVAL</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">C7</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-8)">┌─</span> <span style="font-weight:bold">Evaluate</span> <span style="font-weight:bold">C7</span> <span style="font-weight:bold">›</span> <span style="font-weight:bold">B7</span> <span style="color:var(--vt-palette-8)">─────────────────────────────────────────────────────────┐</span>3+ <span style="color:var(--vt-palette-8)">│</span> =<span style="font-weight:bold;text-decoration:underline">SUM(B3:B5)</span> <span style="color:var(--vt-palette-8)">│</span>4+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">A</span><span style="color:var(--vt-palette-8)">├────────────────────────────────────────────────────────────────────────────┤</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">I</span><span style="background:var(--vt-palette-8)"> </span>5+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">1</span><span style="background:var(--vt-palette-8)"> </span> Hous<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Next</span> <span style="font-weight:bold;text-decoration:underline">SUM(B3:B5)</span> <span style="color:var(--vt-palette-8)">=</span> <span style="color:var(--vt-palette-6);font-style:italic">2158.4</span> <span style="color:var(--vt-palette-8)">│</span>6+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">2</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">0</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">1</span> <span style="color:var(--vt-palette-8)">─┘</span>7+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">3</span><span style="background:var(--vt-palette-8)"> </span> Rent 14508+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">4</span><span style="background:var(--vt-palette-8)"> </span> Groceries 612.49+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">5</span><span style="background:var(--vt-palette-8)"> </span> Transit 9610+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">6</span><span style="background:var(--vt-palette-8)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">7</span><span style="background:var(--vt-palette-6)"> </span> Total <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">2158.4</span><span style="background:var(--vt-palette-2)"> </span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">539.6</span><span style="background:var(--vt-palette-6)"> </span>12+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">8</span><span style="background:var(--vt-palette-8)"> </span> 2877.866713+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span>14+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>16+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span>18+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>19+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>20+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>21+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span>22+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span>23+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span>24+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span>25+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span>26+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span>27+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span>29+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span>30+The underlined part is computed next <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">evaluate</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">←</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">step</span> <span style="color:var(--vt-palette-8)">out</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">EVAL</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">B8</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-8)">┌─</span> <span style="font-weight:bold">Evaluate</span> <span style="font-weight:bold">B8</span> <span style="color:var(--vt-palette-8)">──────────────────────────────────────────────────────────────┐</span>3+ <span style="color:var(--vt-palette-8)">│</span> =<span style="color:var(--vt-palette-4);font-weight:bold;font-style:italic;text-decoration:underline">719.466666666667</span><span style="font-weight:bold;text-decoration:underline">*</span><span style="color:var(--vt-palette-4);font-weight:bold;font-style:italic;text-decoration:underline">4</span> <span style="color:var(--vt-palette-8)">│</span>4+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">A</span><span style="color:var(--vt-palette-8)">├────────────────────────────────────────────────────────────────────────────┤</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">I</span><span style="background:var(--vt-palette-7)"> </span>5+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">1</span><span style="background:var(--vt-palette-7)"> </span> Hous<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-0)">Next</span> <span style="font-weight:bold;text-decoration:underline">AVERAGE(Expenses)*C2</span> <span style="color:var(--vt-palette-0)">=</span> <span style="color:var(--vt-palette-4);font-style:italic">2877.86666666667</span> <span style="color:var(--vt-palette-8)">│</span>6+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">2</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-0)">2</span> <span style="color:var(--vt-palette-0)">of</span> <span style="color:var(--vt-palette-0)">3</span> <span style="color:var(--vt-palette-8)">─┘</span>7+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">3</span><span style="background:var(--vt-palette-7)"> </span> Rent 14508+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">4</span><span style="background:var(--vt-palette-7)"> </span> Groceries 612.49+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">5</span><span style="background:var(--vt-palette-7)"> </span> Transit 9610+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">6</span><span style="background:var(--vt-palette-7)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">7</span><span style="background:var(--vt-palette-7)"> </span> Total 2158.412+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">8</span><span style="background:var(--vt-palette-6)"> </span> <span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2877.8667</span><span style="background:var(--vt-palette-6)"> </span>13+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">9</span><span style="background:var(--vt-palette-7)"> </span>14+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">10</span><span style="background:var(--vt-palette-7)"> </span>15+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">11</span><span style="background:var(--vt-palette-7)"> </span>16+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">12</span><span style="background:var(--vt-palette-7)"> </span>17+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">13</span><span style="background:var(--vt-palette-7)"> </span>18+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">14</span><span style="background:var(--vt-palette-7)"> </span>19+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">15</span><span style="background:var(--vt-palette-7)"> </span>20+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">16</span><span style="background:var(--vt-palette-7)"> </span>21+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">17</span><span style="background:var(--vt-palette-7)"> </span>22+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">18</span><span style="background:var(--vt-palette-7)"> </span>23+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">19</span><span style="background:var(--vt-palette-7)"> </span>24+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">20</span><span style="background:var(--vt-palette-7)"> </span>25+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">21</span><span style="background:var(--vt-palette-7)"> </span>26+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">22</span><span style="background:var(--vt-palette-7)"> </span>27+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">23</span><span style="background:var(--vt-palette-7)"> </span>28+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span>29+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">25</span><span style="background:var(--vt-palette-7)"> </span>30+The underlined part is computed next <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Enter</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">evaluate</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Esc</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">close</span></pre>\ No newline at end of file@@ -0,0 +1,16 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">EVAL</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="color:var(--vt-palette-8)">┌─</span> <span style="font-weight:bold">Evaluate</span> <span style="font-weight:bold">B8</span> <span style="color:var(--vt-palette-8)">────────────────────────────────────────────┐</span>3+<span style="color:var(--vt-palette-8)">│</span> =<span style="color:var(--vt-palette-6);font-style:italic">719.466666666667</span>*<span style="font-weight:bold;text-decoration:underline">C2</span> <span style="color:var(--vt-palette-8)">│</span>4+<span style="color:var(--vt-palette-8)">├──────────────────────────────────────────────────────────┤</span>5+<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Next</span> <span style="font-weight:bold;text-decoration:underline">C2</span> <span style="color:var(--vt-palette-8)">=</span> <span style="color:var(--vt-palette-6);font-style:italic">4</span> <span style="color:var(--vt-palette-8)">│</span>6+<span style="color:var(--vt-palette-8)">└─────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">3</span> <span style="color:var(--vt-palette-8)">─┘</span>7+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">3</span><span style="background:var(--vt-palette-8)"> </span> Rent 14508+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">4</span><span style="background:var(--vt-palette-8)"> </span> Groceries 612.49+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">5</span><span style="background:var(--vt-palette-8)"> </span> Transit 9610+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">6</span><span style="background:var(--vt-palette-8)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">7</span><span style="background:var(--vt-palette-8)"> </span> Total 2158.412+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">8</span><span style="background:var(--vt-palette-6)"> </span> <span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2877.8667</span><span style="background:var(--vt-palette-6)"> </span>13+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span>14+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>16+The underlined part is comp… <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">evaluate</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">EVAL</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">B8</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-8)">┌─</span> <span style="font-weight:bold">Evaluate</span> <span style="font-weight:bold">B8</span> <span style="color:var(--vt-palette-8)">──────────────────────────────────────────────────────────────┐</span>3+ <span style="color:var(--vt-palette-8)">│</span> =<span style="color:var(--vt-palette-6);font-weight:bold;font-style:italic;text-decoration:underline">719.466666666667</span><span style="font-weight:bold;text-decoration:underline">*</span><span style="color:var(--vt-palette-6);font-weight:bold;font-style:italic;text-decoration:underline">4</span> <span style="color:var(--vt-palette-8)">│</span>4+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">A</span><span style="color:var(--vt-palette-8)">├────────────────────────────────────────────────────────────────────────────┤</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">I</span><span style="background:var(--vt-palette-8)"> </span>5+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">1</span><span style="background:var(--vt-palette-8)"> </span> Hous<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Next</span> <span style="font-weight:bold;text-decoration:underline">AVERAGE(Expenses)*C2</span> <span style="color:var(--vt-palette-8)">=</span> <span style="color:var(--vt-palette-6);font-style:italic">2877.86666666667</span> <span style="color:var(--vt-palette-8)">│</span>6+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">2</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">2</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">3</span> <span style="color:var(--vt-palette-8)">─┘</span>7+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">3</span><span style="background:var(--vt-palette-8)"> </span> Rent 14508+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">4</span><span style="background:var(--vt-palette-8)"> </span> Groceries 612.49+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">5</span><span style="background:var(--vt-palette-8)"> </span> Transit 9610+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">6</span><span style="background:var(--vt-palette-8)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">7</span><span style="background:var(--vt-palette-8)"> </span> Total 2158.412+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">8</span><span style="background:var(--vt-palette-6)"> </span> <span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2877.8667</span><span style="background:var(--vt-palette-6)"> </span>13+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span>14+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>16+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span>18+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>19+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>20+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>21+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span>22+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span>23+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span>24+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span>25+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span>26+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span>27+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span>29+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span>30+The underlined part is computed next <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">evaluate</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -25,6 +25,6 @@
2525 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">21</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Deselect <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Esc</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span>2626 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">22</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Select all <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Ctrl+A</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span>2727 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">23</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Select columns <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Ctrl+Space</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span>28-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-0)">1-25</span> <span style="color:var(--vt-palette-0)">of</span> <span style="color:var(--vt-palette-0)">126</span> <span style="color:var(--vt-palette-8)">─┘</span>28+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-0)">1-25</span> <span style="color:var(--vt-palette-0)">of</span> <span style="color:var(--vt-palette-0)">123</span> <span style="color:var(--vt-palette-8)">─┘</span>2929 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">25</span><span style="background:var(--vt-palette-7)"> </span>3030 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Up/Down</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">scroll</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Esc</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">close</span></pre>\ No newline at end of file@@ -11,6 +11,6 @@
1111 <span style="color:var(--vt-palette-8)">│</span> Last used cell <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+End</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>1212 <span style="color:var(--vt-palette-8)">│</span> Go to <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+G</span><span style="background:var(--vt-palette-8)"> </span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">F5</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>1313 <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">│</span>14-<span style="color:var(--vt-palette-8)">└───────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-11</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">126</span> <span style="color:var(--vt-palette-8)">─┘</span>14+<span style="color:var(--vt-palette-8)">└───────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-11</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">123</span> <span style="color:var(--vt-palette-8)">─┘</span>1515 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>1616 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up/Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">scroll</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -40,6 +40,6 @@
4040 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">36</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Time <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+Shift+2</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>4141 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">37</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="font-weight:bold">Notebooks</span> Bold <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+B</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>4242 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">38</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Move between cells and outputs <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up</span><span style="background:var(--vt-palette-8)"> </span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">j</span><span style="background:var(--vt-palette-8)"> </span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">k</span><span style="background:var(--vt-palette-8)"> </span> Italic <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+I</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>43-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">39</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-40</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">65</span> <span style="color:var(--vt-palette-8)">─┘</span>43+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">39</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-40</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">64</span> <span style="color:var(--vt-palette-8)">─┘</span>4444 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">40</span><span style="background:var(--vt-palette-8)"> </span>4545 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up/Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">scroll</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -25,6 +25,6 @@
2525 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Deselect <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>2626 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Select all <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+A</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>2727 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Select columns <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+Space</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>28-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-25</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">126</span> <span style="color:var(--vt-palette-8)">─┘</span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">1-25</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">123</span> <span style="color:var(--vt-palette-8)">─┘</span>2929 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span>3030 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up/Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">scroll</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -17,14 +17,14 @@
1717 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">13</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Data validation <span style="color:var(--vt-palette-8)">│</span>1818 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">14</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Remove</span> <span style="color:var(--vt-palette-8)">data</span> <span style="color:var(--vt-palette-8)">validation</span> <span style="color:var(--vt-palette-8)">│</span>1919 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">15</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">├────────────────────────────────────────────────┤</span>20-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">16</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Trace precedents <span style="color:var(--vt-palette-8)">┌──────────────────────────────────────────┐</span>21-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">17</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Trace dependents <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Record</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">macro</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span>22-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">18</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span> Record macro with relative references <span style="color:var(--vt-palette-8)">│</span>23-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">19</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Macros</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Stop</span> <span style="color:var(--vt-palette-8)">and</span> <span style="color:var(--vt-palette-8)">save</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>24-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">20</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Shell <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Discard</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>25-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">21</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Linked file <span style="color:var(--vt-palette-8)">├──────────────────────────────────────────┤</span>26-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">22</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span> <span style="color:var(--vt-palette-8)">Run</span> <span style="color:var(--vt-palette-8)">macro</span> <span style="color:var(--vt-palette-8)">│</span>27-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">23</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Ask</span> <span style="color:var(--vt-palette-8)">JEV</span> <span style="color:var(--vt-palette-8)">again</span> <span style="color:var(--vt-palette-8)">│</span> Manage macros <span style="color:var(--vt-palette-8)">│</span>28-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────│</span> Write a macro <span style="color:var(--vt-palette-8)">│</span>20+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">16</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Formula tracing <span style="color:var(--vt-palette-8)">┌──────────────────────────────────────────┐</span>21+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">17</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Record</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">macro</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span>22+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">18</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Macros</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span> Record macro with relative references <span style="color:var(--vt-palette-8)">│</span>23+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">19</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Shell <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Stop</span> <span style="color:var(--vt-palette-8)">and</span> <span style="color:var(--vt-palette-8)">save</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>24+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">20</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Linked file <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Discard</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>25+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">21</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────├──────────────────────────────────────────┤</span>26+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">22</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Ask</span> <span style="color:var(--vt-palette-8)">JEV</span> <span style="color:var(--vt-palette-8)">again</span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Run</span> <span style="color:var(--vt-palette-8)">macro</span> <span style="color:var(--vt-palette-8)">│</span>27+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">23</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────│</span> Manage macros <span style="color:var(--vt-palette-8)">│</span>28+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Write a macro <span style="color:var(--vt-palette-8)">│</span>2929 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">25</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└──────────────────────────────────────────┘</span>3030 Record what you do as a macro that selects the same ce… <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Arrows</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">move</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Enter</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">choose</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Esc</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">close</span></pre>\ No newline at end of file@@ -17,14 +17,14 @@
1717 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Data validation <span style="color:var(--vt-palette-8)">│</span>1818 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Remove</span> <span style="color:var(--vt-palette-8)">data</span> <span style="color:var(--vt-palette-8)">validation</span> <span style="color:var(--vt-palette-8)">│</span>1919 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">├────────────────────────────────────────────────┤</span>20-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Trace precedents <span style="color:var(--vt-palette-8)">┌──────────────────────────────────────────┐</span>21-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Trace dependents <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Record</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">macro</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span>22-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span> Record macro with relative references <span style="color:var(--vt-palette-8)">│</span>23-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Macros</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Stop</span> <span style="color:var(--vt-palette-8)">and</span> <span style="color:var(--vt-palette-8)">save</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>24-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Shell <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Discard</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>25-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Linked file <span style="color:var(--vt-palette-8)">├──────────────────────────────────────────┤</span>26-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span> <span style="color:var(--vt-palette-8)">Run</span> <span style="color:var(--vt-palette-8)">macro</span> <span style="color:var(--vt-palette-8)">│</span>27-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Ask</span> <span style="color:var(--vt-palette-8)">JEV</span> <span style="color:var(--vt-palette-8)">again</span> <span style="color:var(--vt-palette-8)">│</span> Manage macros <span style="color:var(--vt-palette-8)">│</span>28-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────│</span> Write a macro <span style="color:var(--vt-palette-8)">│</span>20+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Formula tracing <span style="color:var(--vt-palette-8)">┌──────────────────────────────────────────┐</span>21+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Record</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">macro</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span>22+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Macros</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span> Record macro with relative references <span style="color:var(--vt-palette-8)">│</span>23+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Shell <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Stop</span> <span style="color:var(--vt-palette-8)">and</span> <span style="color:var(--vt-palette-8)">save</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>24+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Linked file <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Discard</span> <span style="color:var(--vt-palette-8)">recording</span> <span style="color:var(--vt-palette-8)">│</span>25+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">├─────────────────────├──────────────────────────────────────────┤</span>26+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Ask</span> <span style="color:var(--vt-palette-8)">JEV</span> <span style="color:var(--vt-palette-8)">again</span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Run</span> <span style="color:var(--vt-palette-8)">macro</span> <span style="color:var(--vt-palette-8)">│</span>27+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└─────────────────────│</span> Manage macros <span style="color:var(--vt-palette-8)">│</span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Write a macro <span style="color:var(--vt-palette-8)">│</span>2929 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└──────────────────────────────────────────┘</span>3030 Record what you do as a macro that selects the same ce… <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Arrows</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">move</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">choose</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -10,7 +10,7 @@
1010 <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-3);font-weight:bold">S</span>ort range Z to <span style="color:var(--vt-palette-3);font-weight:bold">A</span> <span style="color:var(--vt-palette-8)">│</span>1111 <span style="color:var(--vt-palette-8)">│</span> Sort <span style="color:var(--vt-palette-3);font-weight:bold">s</span>heet <span style="color:var(--vt-palette-3);font-weight:bold">A</span> to Z <span style="color:var(--vt-palette-8)">│</span>1212 <span style="color:var(--vt-palette-8)">│</span> Sort <span style="color:var(--vt-palette-3);font-weight:bold">s</span>heet Z to <span style="color:var(--vt-palette-3);font-weight:bold">A</span> <span style="color:var(--vt-palette-8)">│</span>13+<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Show</span> <span style="color:var(--vt-palette-8)">all</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">the</span> <span style="color:var(--vt-palette-8)">output</span> <span style="color:var(--vt-palette-8)">o</span> <span style="color:var(--vt-palette-8)">│</span>1314 <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Ask</span> <span style="color:var(--vt-palette-8)">JEV</span> <span style="color:var(--vt-palette-8)">again</span> <span style="color:var(--vt-palette-8)">│</span>14-<span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-3);font-weight:bold">S</span>ort r<span style="color:var(--vt-palette-3);font-weight:bold">a</span>nge <span style="color:var(--vt-palette-8)">│</span>15-<span style="color:var(--vt-palette-8)">└──────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">59</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">215</span> <span style="color:var(--vt-palette-8)">─┘</span>15+<span style="color:var(--vt-palette-8)">└──────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">54</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">211</span> <span style="color:var(--vt-palette-8)">─┘</span>1616 Save the sheet u… <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up/Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">move</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">run</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -14,7 +14,7 @@
1414 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">10</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Reset <span style="color:var(--vt-palette-4);font-weight:bold">col</span>umn width <span style="color:var(--vt-palette-0)">Format</span> <span style="color:var(--vt-palette-8)">│</span>1515 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">11</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Insert <span style="color:var(--vt-palette-4);font-weight:bold">col</span>umns right <span style="color:var(--vt-palette-0)">Insert</span> <span style="color:var(--vt-palette-8)">│</span>1616 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">12</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span> Delete rows or <span style="color:var(--vt-palette-4);font-weight:bold">col</span>umns <span style="color:var(--vt-palette-0)">Edit</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Ctrl+Alt+-</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">│</span>17-<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">13</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-0)">43</span> <span style="color:var(--vt-palette-0)">of</span> <span style="color:var(--vt-palette-0)">215</span> <span style="color:var(--vt-palette-8)">─┘</span>17+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">13</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-0)">43</span> <span style="color:var(--vt-palette-0)">of</span> <span style="color:var(--vt-palette-0)">211</span> <span style="color:var(--vt-palette-8)">─┘</span>1818 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">14</span><span style="background:var(--vt-palette-7)"> </span>1919 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">15</span><span style="background:var(--vt-palette-7)"> </span>2020 <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">16</span><span style="background:var(--vt-palette-7)"> </span>@@ -14,7 +14,7 @@
1414 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Reset <span style="color:var(--vt-palette-3);font-weight:bold">col</span>umn width <span style="color:var(--vt-palette-8)">Format</span> <span style="color:var(--vt-palette-8)">│</span>1515 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Insert <span style="color:var(--vt-palette-3);font-weight:bold">col</span>umns right <span style="color:var(--vt-palette-8)">Insert</span> <span style="color:var(--vt-palette-8)">│</span>1616 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Delete rows or <span style="color:var(--vt-palette-3);font-weight:bold">col</span>umns <span style="color:var(--vt-palette-8)">Edit</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+Alt+-</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>17-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">43</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">215</span> <span style="color:var(--vt-palette-8)">─┘</span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">43</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">211</span> <span style="color:var(--vt-palette-8)">─┘</span>1818 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>1919 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>2020 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>@@ -12,9 +12,9 @@
1212 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">8</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> In<span style="color:var(--vt-palette-3);font-weight:bold">se</span>rt columns <span style="color:var(--vt-palette-3);font-weight:bold">l</span>eft <span style="color:var(--vt-palette-8)">Insert</span> <span style="color:var(--vt-palette-8)">│</span>1313 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-3);font-weight:bold">S</span>av<span style="color:var(--vt-palette-3);font-weight:bold">e</span> <span style="color:var(--vt-palette-8)">Fi</span><span style="color:var(--vt-palette-3);font-weight:bold">l</span><span style="color:var(--vt-palette-8)">e</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+S</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span>1414 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-3);font-weight:bold">S</span>av<span style="color:var(--vt-palette-3);font-weight:bold">e</span> as <span style="color:var(--vt-palette-8)">Fi</span><span style="color:var(--vt-palette-3);font-weight:bold">l</span><span style="color:var(--vt-palette-8)">e</span> <span style="color:var(--vt-palette-8)">│</span>15-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Code</span> <span style="color:var(--vt-palette-8)">Data</span> <span style="color:var(--vt-palette-8)">›</span> <span style="color:var(--vt-palette-8)">Shell</span> <span style="color:var(--vt-palette-8)">y</span> <span style="color:var(--vt-palette-8)">│</span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> <span style="color:var(--vt-palette-8)">Paste</span> <span style="color:var(--vt-palette-8)">cell</span> <span style="color:var(--vt-palette-8)">Data</span> <span style="color:var(--vt-palette-8)">›</span> <span style="color:var(--vt-palette-8)">Shell</span> <span style="color:var(--vt-palette-8)">v</span> <span style="color:var(--vt-palette-8)">│</span>1616 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> In<span style="color:var(--vt-palette-3);font-weight:bold">se</span>rt rows be<span style="color:var(--vt-palette-3);font-weight:bold">l</span>ow <span style="color:var(--vt-palette-8)">Insert</span> <span style="color:var(--vt-palette-8)">│</span>17-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">56</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">215</span> <span style="color:var(--vt-palette-8)">─┘</span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└────────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">51</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">211</span> <span style="color:var(--vt-palette-8)">─┘</span>1818 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>1919 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>2020 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>@@ -14,7 +14,7 @@
1414 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Download as JSON <span style="color:var(--vt-palette-8)">File</span> <span style="color:var(--vt-palette-8)">›</span> <span style="color:var(--vt-palette-8)">Download</span> <span style="color:var(--vt-palette-8)">│</span>1515 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Download as NUON <span style="color:var(--vt-palette-8)">File</span> <span style="color:var(--vt-palette-8)">›</span> <span style="color:var(--vt-palette-8)">Download</span> <span style="color:var(--vt-palette-8)">│</span>1616 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> Decimal arithmetic <span style="color:var(--vt-palette-8)">File</span> <span style="color:var(--vt-palette-8)">›</span> <span style="color:var(--vt-palette-8)">Settings</span> <span style="color:var(--vt-palette-8)">│</span>17-<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">215</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">215</span> <span style="color:var(--vt-palette-8)">─┘</span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────────────────────────────────────</span> <span style="color:var(--vt-palette-8)">211</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">211</span> <span style="color:var(--vt-palette-8)">─┘</span>1818 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>1919 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>2020 <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">MENU</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">B7</span><span style="background:var(--vt-palette-8)"> </span> =SUM(B3:B5) <span style="color:var(--vt-palette-8)">┌─</span> <span style="font-weight:bold">Precedents</span> <span style="font-weight:bold">and</span> <span style="font-weight:bold">dependents</span> <span style="font-weight:bold">of</span> <span style="font-weight:bold">B7</span> <span style="color:var(--vt-palette-8)">──────┐</span>3+ <span style="color:var(--vt-palette-8)">│</span> <span style="font-weight:bold">›</span> <span style="color:var(--vt-palette-8)">Type</span> <span style="color:var(--vt-palette-8)">a</span> <span style="color:var(--vt-palette-8)">cell,</span> <span style="color:var(--vt-palette-8)">range</span> <span style="color:var(--vt-palette-8)">or</span> <span style="color:var(--vt-palette-8)">name</span> <span style="color:var(--vt-palette-8)">│</span>4+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">A</span><span style="background:var(--vt-palette-8)"> </span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">B</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-8)">├────────────────────────────────────────┤</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">H</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">I</span><span style="background:var(--vt-palette-8)"> </span>5+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">1</span><span style="background:var(--vt-palette-8)"> </span> Household budget 2026 <span style="color:var(--vt-palette-8)">│</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">Expenses</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">precedent</span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-8)">│</span>6+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">2</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">│</span> C7 <span style="color:var(--vt-palette-8)">dependent</span> <span style="color:var(--vt-palette-8)">│</span>7+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">3</span><span style="background:var(--vt-palette-8)"> </span> Rent <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">1450</span><span style="background:var(--vt-palette-2)"> </span> <span style="color:var(--vt-palette-8)">│</span> B30 <span style="color:var(--vt-palette-8)">dependent</span> <span style="color:var(--vt-palette-8)">│</span>8+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">4</span><span style="background:var(--vt-palette-8)"> </span> Groceries<span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">612.4</span><span style="background:var(--vt-palette-2)"> </span> <span style="color:var(--vt-palette-8)">└───────────────────────────────</span> <span style="color:var(--vt-palette-8)">3</span> <span style="color:var(--vt-palette-8)">of</span> <span style="color:var(--vt-palette-8)">3</span> <span style="color:var(--vt-palette-8)">─┘</span>9+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">5</span><span style="background:var(--vt-palette-8)"> </span> Transit <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">96</span><span style="background:var(--vt-palette-2)"> </span>10+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">6</span><span style="background:var(--vt-palette-8)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">7</span><span style="background:var(--vt-palette-6)"> </span> Total <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2158.4</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-5)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-5);font-weight:bold">539.6</span><span style="background:var(--vt-palette-5)"> </span>12+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">8</span><span style="background:var(--vt-palette-8)"> </span> 2877.866713+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span>14+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>16+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span>18+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>19+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>20+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>21+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span>22+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span>23+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span>24+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span>25+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span>26+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span>27+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span>29+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span>30+Go to Expenses <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Up/Down</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">move</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Enter</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">go</span> <span style="color:var(--vt-palette-8)">to</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Esc</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">close</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">F</span><span style="color:#000000;background:#e0e0e0">ile</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">E</span><span style="color:#000000;background:#e0e0e0">dit</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">V</span><span style="color:#000000;background:#e0e0e0">iew</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">I</span><span style="color:#000000;background:#e0e0e0">nsert</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">F</span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">o</span><span style="color:#000000;background:#e0e0e0">rmat</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">D</span><span style="color:#000000;background:#e0e0e0">ata</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0;text-decoration:underline">H</span><span style="color:#000000;background:#e0e0e0">elp</span><span style="background:#e0e0e0"> </span><span style="background:#a0e8ff"> </span><span style="color:#000000;background:#a0e8ff;font-weight:bold">READY</span><span style="background:#a0e8ff"> </span>2+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">B7</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">=SUM(B3:B5)</span><span style="background:#ffffff"> </span>3+<span style="color:#000000;background:#ffffff">B7</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">reads</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Expenses;</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">read</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">by</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">C7,</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">B30↓</span><span style="background:#ffffff"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">Alt+'</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">list</span><span style="background:#ffffff"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">Alt+;</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">stop</span>4+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">A</span><span style="background:#d0d0d0"> </span><span style="background:#a0e8ff"> </span><span style="color:#000000;background:#a0e8ff;font-weight:bold">B</span><span style="background:#a0e8ff"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">C</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">D</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">E</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">F</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">G</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">H</span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">I</span><span style="background:#d0d0d0"> </span>5+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">1</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Household</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">budget</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">2026</span><span style="background:#ffffff"> </span>6+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">2</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">4</span><span style="background:#ffffff"> </span>7+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">3</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Rent</span><span style="background:#ffffff"> </span><span style="background:#b0f0b0"> </span><span style="color:#000000;background:#b0f0b0">1450</span><span style="background:#b0f0b0"> </span><span style="background:#ffffff"> </span>8+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">4</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Groceries</span><span style="background:#b0f0b0"> </span><span style="color:#000000;background:#b0f0b0">612.4</span><span style="background:#b0f0b0"> </span><span style="background:#ffffff"> </span>9+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">5</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Transit</span><span style="background:#ffffff"> </span><span style="background:#b0f0b0"> </span><span style="color:#000000;background:#b0f0b0">96</span><span style="background:#b0f0b0"> </span><span style="background:#ffffff"> </span>10+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">6</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Savings</span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">r</span><span style="background:#ffffff"> </span><span style="color:#a00000;background:#ffffff;text-decoration:underline wavy #a00000">#DIV/0!</span><span style="background:#ffffff"> </span>11+<span style="background:#a0e8ff"> </span><span style="color:#000000;background:#a0e8ff;font-weight:bold">7</span><span style="background:#a0e8ff"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">Total</span><span style="background:#ffffff"> </span><span style="background:#a0e8ff"> </span><span style="color:#000000;background:#a0e8ff">2158.4</span><span style="background:#a0e8ff"> </span><span style="background:#800080"> </span><span style="color:#dedede;background:#800080;font-weight:bold">539.6</span><span style="background:#800080"> </span><span style="background:#ffffff"> </span>12+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">8</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span><span style="color:#000000;background:#ffffff">2877.8667</span><span style="background:#ffffff"> </span>13+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">9</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>14+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">10</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>15+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">11</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>16+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">12</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>17+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">13</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>18+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">14</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>19+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">15</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>20+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">16</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>21+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">17</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>22+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">18</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>23+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">19</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>24+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">20</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>25+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">21</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>26+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">22</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>27+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">23</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>28+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">24</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>29+<span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">25</span><span style="background:#d0d0d0"> </span><span style="background:#ffffff"> </span>30+<span style="background:#a0e8ff"> </span><span style="color:#000000;background:#a0e8ff;font-weight:bold">Sheet1</span><span style="background:#a0e8ff"> </span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">+</span><span style="background:#e0e0e0"> </span><span style="color:#6a6a6a;background:#e0e0e0">│</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">untitled</span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">modified</span><span style="background:#e0e0e0"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">Ctrl+K</span><span style="background:#d0d0d0"> </span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">search</span><span style="background:#e0e0e0"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">Ctrl+/</span><span style="background:#d0d0d0"> </span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">shortcuts</span><span style="background:#e0e0e0"> </span><span style="background:#d0d0d0"> </span><span style="color:#000000;background:#d0d0d0">F10</span><span style="background:#d0d0d0"> </span><span style="background:#e0e0e0"> </span><span style="color:#000000;background:#e0e0e0">menu</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">F</span><span style="color:#ffffff;background:#1f1f1f">ile</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">E</span><span style="color:#ffffff;background:#1f1f1f">dit</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">V</span><span style="color:#ffffff;background:#1f1f1f">iew</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">I</span><span style="color:#ffffff;background:#1f1f1f">nsert</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">F</span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">o</span><span style="color:#ffffff;background:#1f1f1f">rmat</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">D</span><span style="color:#ffffff;background:#1f1f1f">ata</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f;text-decoration:underline">H</span><span style="color:#ffffff;background:#1f1f1f">elp</span><span style="background:#1f1f1f"> </span><span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">READY</span><span style="background:#40e0ff"> </span>2+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">B7</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">=SUM(B3:B5)</span><span style="background:#000000"> </span>3+<span style="color:#959595;background:#000000">B7</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">reads</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Expenses</span><span style="color:#959595;background:#000000">;</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">read</span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">by</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">C7,</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">B30↓</span><span style="background:#000000"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Alt+'</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">list</span><span style="background:#000000"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Alt+;</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#959595;background:#000000">stop</span>4+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">A</span><span style="background:#3a3a3a"> </span><span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">B</span><span style="background:#40e0ff"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">C</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">D</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">E</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">F</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">G</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">H</span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">I</span><span style="background:#3a3a3a"> </span>5+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">1</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Household</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">budget</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">2026</span><span style="background:#000000"> </span>6+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">2</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">4</span><span style="background:#000000"> </span>7+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">3</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Rent</span><span style="background:#000000"> </span><span style="background:#40e040"> </span><span style="color:#000000;background:#40e040">1450</span><span style="background:#40e040"> </span><span style="background:#000000"> </span>8+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">4</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Groceries</span><span style="background:#40e040"> </span><span style="color:#000000;background:#40e040">612.4</span><span style="background:#40e040"> </span><span style="background:#000000"> </span>9+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">5</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Transit</span><span style="background:#000000"> </span><span style="background:#40e040"> </span><span style="color:#000000;background:#40e040">96</span><span style="background:#40e040"> </span><span style="background:#000000"> </span>10+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">6</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Savings</span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">r</span><span style="background:#000000"> </span><span style="color:#ff8080;background:#000000;text-decoration:underline wavy #ff8080">#DIV/0!</span><span style="background:#000000"> </span>11+<span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">7</span><span style="background:#40e0ff"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">Total</span><span style="background:#000000"> </span><span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff">2158.4</span><span style="background:#40e0ff"> </span><span style="background:#ff80ff"> </span><span style="color:#000000;background:#ff80ff;font-weight:bold">539.6</span><span style="background:#ff80ff"> </span><span style="background:#000000"> </span>12+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">8</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span><span style="color:#ffffff;background:#000000">2877.8667</span><span style="background:#000000"> </span>13+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">9</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>14+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">10</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>15+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">11</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>16+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">12</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>17+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">13</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>18+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">14</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>19+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">15</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>20+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">16</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>21+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">17</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>22+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">18</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>23+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">19</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>24+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">20</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>25+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">21</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>26+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">22</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>27+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">23</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>28+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">24</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>29+<span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">25</span><span style="background:#3a3a3a"> </span><span style="background:#000000"> </span>30+<span style="background:#40e0ff"> </span><span style="color:#000000;background:#40e0ff;font-weight:bold">Sheet1</span><span style="background:#40e0ff"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">+</span><span style="background:#1f1f1f"> </span><span style="color:#757575;background:#1f1f1f">│</span><span style="background:#1f1f1f"> </span><span style="color:#ffffff;background:#1f1f1f">untitled</span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">modified</span><span style="background:#1f1f1f"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Ctrl+K</span><span style="background:#3a3a3a"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">search</span><span style="background:#1f1f1f"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">Ctrl+/</span><span style="background:#3a3a3a"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">shortcuts</span><span style="background:#1f1f1f"> </span><span style="background:#3a3a3a"> </span><span style="color:#ffffff;background:#3a3a3a">F10</span><span style="background:#3a3a3a"> </span><span style="background:#1f1f1f"> </span><span style="color:#959595;background:#1f1f1f">menu</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">READY</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">B7</span><span style="background:var(--vt-palette-7)"> </span> =SUM(B3:B5)3+<span style="color:var(--vt-palette-0)">B7</span> <span style="color:var(--vt-palette-0)">reads</span> Expenses<span style="color:var(--vt-palette-0)">;</span> <span style="color:var(--vt-palette-0)">read</span> <span style="color:var(--vt-palette-0)">by</span> C7, B30↓ <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Alt+'</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">list</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Alt+;</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">stop</span>4+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">A</span><span style="background:var(--vt-palette-7)"> </span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">B</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">C</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">D</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">E</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">F</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">G</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">H</span><span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">I</span><span style="background:var(--vt-palette-7)"> </span>5+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">1</span><span style="background:var(--vt-palette-7)"> </span> Household budget 20266+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">2</span><span style="background:var(--vt-palette-7)"> </span> 47+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">3</span><span style="background:var(--vt-palette-7)"> </span> Rent <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">1450</span><span style="background:var(--vt-palette-2)"> </span>8+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">4</span><span style="background:var(--vt-palette-7)"> </span> Groceries<span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">612.4</span><span style="background:var(--vt-palette-2)"> </span>9+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">5</span><span style="background:var(--vt-palette-7)"> </span> Transit <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">96</span><span style="background:var(--vt-palette-2)"> </span>10+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">6</span><span style="background:var(--vt-palette-7)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">7</span><span style="background:var(--vt-palette-6)"> </span> Total <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2158.4</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-5)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-5);font-weight:bold">539.6</span><span style="background:var(--vt-palette-5)"> </span>12+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">8</span><span style="background:var(--vt-palette-7)"> </span> 2877.866713+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">9</span><span style="background:var(--vt-palette-7)"> </span>14+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">10</span><span style="background:var(--vt-palette-7)"> </span>15+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">11</span><span style="background:var(--vt-palette-7)"> </span>16+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">12</span><span style="background:var(--vt-palette-7)"> </span>17+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">13</span><span style="background:var(--vt-palette-7)"> </span>18+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">14</span><span style="background:var(--vt-palette-7)"> </span>19+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">15</span><span style="background:var(--vt-palette-7)"> </span>20+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">16</span><span style="background:var(--vt-palette-7)"> </span>21+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">17</span><span style="background:var(--vt-palette-7)"> </span>22+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">18</span><span style="background:var(--vt-palette-7)"> </span>23+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">19</span><span style="background:var(--vt-palette-7)"> </span>24+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">20</span><span style="background:var(--vt-palette-7)"> </span>25+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">21</span><span style="background:var(--vt-palette-7)"> </span>26+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">22</span><span style="background:var(--vt-palette-7)"> </span>27+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">23</span><span style="background:var(--vt-palette-7)"> </span>28+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">24</span><span style="background:var(--vt-palette-7)"> </span>29+<span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">25</span><span style="background:var(--vt-palette-7)"> </span>30+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">Sheet1</span><span style="background:var(--vt-palette-6)"> </span> <span style="color:var(--vt-palette-0)">+</span> <span style="color:var(--vt-palette-8)">│</span> untitled <span style="color:var(--vt-palette-0)">modified</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Ctrl+K</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">search</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">Ctrl+/</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">shortcuts</span> <span style="background:var(--vt-palette-7)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-7)">F10</span><span style="background:var(--vt-palette-7)"> </span> <span style="color:var(--vt-palette-0)">menu</span></pre>\ No newline at end of file@@ -0,0 +1,30 @@
1+<pre class="screen"> <span style="text-decoration:underline">F</span>ile <span style="text-decoration:underline">E</span>dit <span style="text-decoration:underline">V</span>iew <span style="text-decoration:underline">I</span>nsert F<span style="text-decoration:underline">o</span>rmat <span style="text-decoration:underline">D</span>ata <span style="text-decoration:underline">H</span>elp <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">READY</span><span style="background:var(--vt-palette-6)"> </span>2+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">B7</span><span style="background:var(--vt-palette-8)"> </span> =SUM(B3:B5)3+<span style="color:var(--vt-palette-8)">B7</span> <span style="color:var(--vt-palette-8)">reads</span> Expenses<span style="color:var(--vt-palette-8)">;</span> <span style="color:var(--vt-palette-8)">read</span> <span style="color:var(--vt-palette-8)">by</span> C7, B30↓ <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Alt+'</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">list</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Alt+;</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">stop</span>4+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">A</span><span style="background:var(--vt-palette-8)"> </span><span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">B</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">C</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">D</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">E</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">F</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">G</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">H</span><span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">I</span><span style="background:var(--vt-palette-8)"> </span>5+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">1</span><span style="background:var(--vt-palette-8)"> </span> Household budget 20266+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">2</span><span style="background:var(--vt-palette-8)"> </span> 47+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">3</span><span style="background:var(--vt-palette-8)"> </span> Rent <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">1450</span><span style="background:var(--vt-palette-2)"> </span>8+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">4</span><span style="background:var(--vt-palette-8)"> </span> Groceries<span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">612.4</span><span style="background:var(--vt-palette-2)"> </span>9+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">5</span><span style="background:var(--vt-palette-8)"> </span> Transit <span style="background:var(--vt-palette-2)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-2)">96</span><span style="background:var(--vt-palette-2)"> </span>10+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">6</span><span style="background:var(--vt-palette-8)"> </span> Savings r <span style="color:var(--vt-palette-1);text-decoration:underline wavy var(--vt-palette-1)">#DIV/0!</span>11+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">7</span><span style="background:var(--vt-palette-6)"> </span> Total <span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6)">2158.4</span><span style="background:var(--vt-palette-6)"> </span><span style="background:var(--vt-palette-5)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-5);font-weight:bold">539.6</span><span style="background:var(--vt-palette-5)"> </span>12+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">8</span><span style="background:var(--vt-palette-8)"> </span> 2877.866713+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">9</span><span style="background:var(--vt-palette-8)"> </span>14+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">10</span><span style="background:var(--vt-palette-8)"> </span>15+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">11</span><span style="background:var(--vt-palette-8)"> </span>16+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">12</span><span style="background:var(--vt-palette-8)"> </span>17+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">13</span><span style="background:var(--vt-palette-8)"> </span>18+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">14</span><span style="background:var(--vt-palette-8)"> </span>19+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">15</span><span style="background:var(--vt-palette-8)"> </span>20+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">16</span><span style="background:var(--vt-palette-8)"> </span>21+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">17</span><span style="background:var(--vt-palette-8)"> </span>22+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">18</span><span style="background:var(--vt-palette-8)"> </span>23+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">19</span><span style="background:var(--vt-palette-8)"> </span>24+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">20</span><span style="background:var(--vt-palette-8)"> </span>25+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">21</span><span style="background:var(--vt-palette-8)"> </span>26+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">22</span><span style="background:var(--vt-palette-8)"> </span>27+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">23</span><span style="background:var(--vt-palette-8)"> </span>28+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">24</span><span style="background:var(--vt-palette-8)"> </span>29+<span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">25</span><span style="background:var(--vt-palette-8)"> </span>30+<span style="background:var(--vt-palette-6)"> </span><span style="color:var(--vt-palette-0);background:var(--vt-palette-6);font-weight:bold">Sheet1</span><span style="background:var(--vt-palette-6)"> </span> <span style="color:var(--vt-palette-8)">+</span> <span style="color:var(--vt-palette-8)">│</span> untitled <span style="color:var(--vt-palette-8)">modified</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+K</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">search</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">Ctrl+/</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">shortcuts</span> <span style="background:var(--vt-palette-8)"> </span><span style="color:var(--vt-palette-15);background:var(--vt-palette-8)">F10</span><span style="background:var(--vt-palette-8)"> </span> <span style="color:var(--vt-palette-8)">menu</span></pre>\ No newline at end of file@@ -0,0 +1,47 @@
1+package e2e2+3+import (4+ "strings"5+ "testing"6+)7+8+// Tracing stays on as the pointer moves, lists what's off screen, goes9+// to one from a list, and Evaluate formula steps into a reference and10+// back out.11+func TestTraceAndEvaluate(t *testing.T) {12+ s := start(t, "")13+ s.keys("<ctrl+g>", "C1", "<enter>")14+ s.keys("2", "<enter>", "=C1*3", "<enter>", "=C2+C1", "<enter>")15+ s.keys("<ctrl+g>", "C40", "<enter>", "=C3", "<enter>")16+ s.keys("<ctrl+g>", "C2", "<enter>")17+ s.waitForBar("C2", "=C1*3")18+19+ s.keys("<alt+;>")20+ s.waitFor("C2 reads C1↑; read by C3")21+ s.keys("<down>")22+ s.waitFor("C3 reads C2, C1↑; read by C40↓")23+24+ // Go to an off-screen dependent from the list.25+ s.keys("<alt+'>")26+ s.waitFor("Precedents and dependents of C3")27+ s.keys("C40", "<enter>")28+ s.waitForName("C40")29+ s.waitFor("C40 reads C3")30+31+ // Evaluate C40: step into C3, compute it, step out.32+ s.keys("<alt+=>")33+ s.waitFor("Evaluate C40")34+ s.waitFor("Next C3 = 8")35+ s.keys("<right>")36+ s.waitFor("Evaluate C40 › C3")37+ s.keys("<enter>", "<enter>", "<enter>")38+ s.waitFor("Value 8")39+ s.keys("<left>")40+ s.waitFor("Value 8")41+ s.eventually("back at C40", func() bool { return !strings.Contains(s.screen(), "›") })42+ s.keys("<esc>")43+ s.eventually("closed", func() bool { return strings.Contains(s.line(0), "READY") })44+45+ s.keys("<alt+;>")46+ s.eventually("tracing off", func() bool { return !strings.Contains(s.line(contextLine), "reads") })47+}@@ -170,10 +170,13 @@ func eval(n Node, get lookup) Value {
170170 }171171 172172 // evalOther evaluates what formulas rarely hold: array literals, names173-// LET and LAMBDA bind, LAMBDA calls, and arguments standing in for174-// arrays being mapped over.173+// LET and LAMBDA bind, LAMBDA calls, arguments standing in for arrays174+// being mapped over, and parts of a formula being stepped through175+// (probe.go).175176 func evalOther(n Node, get lookup) Value {176177 switch n := n.(type) {178+ case probe:179+ return n.eval(get)177180 case formula.Array:178181 return get.literal(n)179182 case formula.Local:@@ -0,0 +1,170 @@
1+package functions2+3+import (4+ "slices"5+6+ "github.com/FelineStateMachine/012/internal/formula"7+)8+9+// Parts of a formula evaluated where they stand, for stepping through it10+// as Excel's Evaluate Formula does (the engine's steps.go). Rather than a11+// second evaluator, the formula is evaluated once as usual with each12+// part wrapped in a probe, which records what the part computed there:13+// in its array context or not, inside LET with its names bound, and not14+// at all in an IF's branch not taken. Only operators, calls and LAMBDA15+// calls are wrapped: functions look at their arguments' nodes only to16+// tell references, ranges, names and literals apart, which stay as they17+// are, so a probe changes nothing a function sees.18+19+// Part is what one part of a formula computed the first time it was20+// computed.21+type Part struct {22+ Value Value23+ // Array holds the first rows and columns of an array the part24+ // computed, with Rows and Cols its whole size; nil otherwise.25+ Array *Array26+ // Lambda is set when the part computed a LAMBDA.27+ Lambda bool28+ // Reached is false for a part the formula never computed.29+ Reached bool30+}31+32+// previewSize is how many rows and columns of an array a Part keeps.33+const previewSize = 834+35+// probe is a part of a formula being recorded (see Part).36+type probe struct {37+ x Node38+ i int39+ parts []Part40+}41+42+// EvalParts evaluates n in the cell at, as EvalCell does, and returns43+// what it computed, with the array it spills, and what each part at44+// paths computed. A path is child45+// indexes from the root, in formula.EachChild's order; the empty path is46+// the whole formula. A path to a reference, name or literal records47+// nothing: those are read where they stand.48+func EvalParts(n Node, paths [][]int, get *Reader, at Addr) (Part, []Part) {49+ parts := make([]Part, len(paths))50+ for i, p := range paths {51+ n = wrapAt(n, p, probe{i: i, parts: parts})52+ }53+ top := Part{Value: EvalCell(n, get, at), Reached: true}54+ if sp := get.Spilled(); sp != nil {55+ top.Array = preview(sp)56+ }57+ return top, parts58+}59+60+// probed reports whether a part of this kind is wrapped in a probe.61+func probed(n Node) bool {62+ switch n.(type) {63+ case formula.Unary, formula.Binary, formula.Call, formula.Invoke, decUnary, decBinary:64+ return true65+ }66+ return false67+}68+69+// ReplaceAt returns a copy of n with the node at path, child indexes in70+// formula.EachChild's order, replaced by what f makes of it. The nodes71+// on the way are copied; n itself is left as it is.72+func ReplaceAt(n Node, path []int, f func(Node) Node) Node {73+ if len(path) == 0 {74+ return f(n)75+ }76+ return withChild(n, path[0], func(k Node) Node { return ReplaceAt(k, path[1:], f) })77+}78+79+// wrapAt returns n with the node at path wrapped in p, when it is one80+// probed.81+func wrapAt(n Node, path []int, p probe) Node {82+ if len(path) == 0 {83+ if !probed(n) {84+ return n85+ }86+ p.x = n87+ return p88+ }89+ return withChild(n, path[0], func(k Node) Node { return wrapAt(k, path[1:], p) })90+}91+92+// withChild returns a copy of n with its child i replaced by f's result,93+// looking through probes already in place.94+func withChild(n Node, i int, f func(Node) Node) Node {95+ switch n := n.(type) {96+ case probe:97+ n.x = withChild(n.x, i, f)98+ return n99+ case formula.Unary:100+ n.X = f(n.X)101+ return n102+ case decUnary:103+ n.X = f(n.X)104+ return n105+ case formula.Binary:106+ n.L, n.R = pick(i, n.L, n.R, f)107+ return n108+ case decBinary:109+ n.L, n.R = pick(i, n.L, n.R, f)110+ return n111+ case formula.Call:112+ n.Args = slices.Clone(n.Args)113+ n.Args[i] = f(n.Args[i])114+ return n115+ case formula.Invoke:116+ if i == 0 {117+ n.Fn = f(n.Fn)118+ return n119+ }120+ n.Args = slices.Clone(n.Args)121+ n.Args[i-1] = f(n.Args[i-1])122+ return n123+ case formula.Array:124+ rows := slices.Clone(n.Rows)125+ for r, row := range rows {126+ if i < len(row) {127+ rows[r] = slices.Clone(row)128+ rows[r][i] = f(row[i])129+ break130+ }131+ i -= len(row)132+ }133+ n.Rows = rows134+ return n135+ }136+ return n137+}138+139+// pick applies f to l or r, by i.140+func pick(i int, l, r Node, f func(Node) Node) (Node, Node) {141+ if i == 0 {142+ return f(l), r143+ }144+ return l, f(r)145+}146+147+// eval computes the part and records it, the first time.148+func (p probe) eval(get lookup) Value {149+ v := eval(p.x, get)150+ if pt := &p.parts[p.i]; !pt.Reached {151+ pt.Value, pt.Reached = v, true152+ if arr := get.arrayOf(v); arr != nil {153+ pt.Array = preview(arr)154+ }155+ pt.Lambda = get.lambdaOf(v) != nil156+ }157+ return v158+}159+160+// preview copies the first rows and columns of a.161+func preview(a *Array) *Array {162+ rows, cols := min(a.Rows, previewSize), min(a.Cols, previewSize)163+ out := &Array{Rows: a.Rows, Cols: a.Cols, DRows: rows, DCols: cols, V: make([]Value, rows*cols), Fill: a.Fill}164+ for r := range rows {165+ for c := range cols {166+ out.V[r*cols+c] = a.At(r, c)167+ }168+ }169+ return out170+}@@ -49,21 +49,23 @@ func (s *Server) fileArg(sess ssh.Session) (string, error) {
4949 5050 // ending is how a session ended, and where its unsaved work was kept.5151 type ending struct {52- idle, stopped bool // it idled out; the server stopped53- kept string // the recovery file, relative to the served directory54- keptFor string // the file name it was kept for, "" for a book never saved55- err error // keeping it failed52+ idle, stopped bool // it idled out; the server stopped53+ crash *ui.Crash // it stopped on an internal error54+ kept string // the recovery file, relative to the served directory55+ keptFor string // the file name it was kept for, "" for a book never saved56+ err error // keeping it failed5657 }5758 58-// keep writes m's unsaved work to a recovery file when the session ended59-// by idling out or by the server stopping; when the user quits, the app60-// has already asked about unsaved changes.61-func (e *ending) keep(m *ui.Model) {62- if !e.idle && !e.stopped || !m.Unsaved() {59+// keep writes the unsaved work of the program g ran to a recovery file60+// when the session ended by idling out, by the server stopping or on an61+// internal error; when the user quits, the app has already asked about62+// unsaved changes.63+func (e *ending) keep(g *ui.Guarded) {64+ if !e.idle && !e.stopped && e.crash == nil {6365 return6466 }65- e.keptFor = m.Filename()66- e.kept, e.err = m.Recover(time.Now())67+ e.keptFor = g.Model().Filename()68+ e.kept, e.err = g.Keep(time.Now())6769 }6870 6971 // tell says on the client's terminal why the session ended and where its@@ -74,6 +76,8 @@ func (e ending) tell(w io.Writer, idle time.Duration, root confine.Root) {
7476 fmt.Fprint(w, "012: the server is stopping\r\n")7577 case e.idle:7678 fmt.Fprintf(w, "012: closed after %v without input\r\n", idle)79+ case e.crash != nil:80+ fmt.Fprint(w, "012: stopped on an internal error; the server's log has a report\r\n")7781 }7882 switch {7983 case e.err != nil:@@ -11,9 +11,12 @@ import (
1111 "testing"1212 "time"1313 14+ tea "charm.land/bubbletea/v2"1415 gossh "golang.org/x/crypto/ssh"1516 17+ "github.com/FelineStateMachine/012/internal/confine"1618 "github.com/FelineStateMachine/012/internal/sheet"19+ "github.com/FelineStateMachine/012/internal/ui"1720 )1821 1922 // openExec starts a session with a terminal and an exec request for@@ -257,3 +260,28 @@ func TestRecoveryOnShutdown(t *testing.T) {
257260 io.WriteString(tm.stdin, "\x11")258261 tm.waitClosed(t)259262 }263+264+// A session that stopped on an internal error keeps its unsaved work,265+// however it ended, and tells the client the report is in the log.266+func TestRecoveryOnCrash(t *testing.T) {267+ dir := t.TempDir()268+ root, err := confine.New(dir)269+ if err != nil {270+ t.Fatal(err)271+ }272+ m := ui.New(sheet.New(), "book.012")273+ m.Serve(root, nil)274+ m.Update(tea.KeyPressMsg{Code: '7', Text: "7"})275+ m.Update(tea.KeyPressMsg{Code: tea.KeyEnter})276+ e := ending{crash: &ui.Crash{Where: "update", Value: "boom"}}277+ e.keep(ui.Guard(m))278+ var out strings.Builder279+ e.tell(&out, time.Minute, root)280+ if e.err != nil || !strings.HasPrefix(e.kept, filepath.Join(".012-recovery", "book-")) {281+ t.Fatalf("kept %q, %v", e.kept, e.err)282+ }283+ if !strings.Contains(out.String(), "stopped on an internal error; the server's log has a report") ||284+ !strings.Contains(out.String(), "open book.012 again to restore them") {285+ t.Errorf("told %q", out.String())286+ }287+}@@ -310,7 +310,8 @@ func (s *Server) run(sess ssh.Session, pty ssh.Pty, winch <-chan ssh.Window, nam
310310 m.EnableJEV(s.jev, jev.NewCache())311311 }312312 in := newActivity(sess)313- p := tea.NewProgram(m, append(bm.MakeOptions(sess), tea.WithInput(in), tea.WithFPS(ui.FrameRate))...)313+ g := ui.Guard(m)314+ p := tea.NewProgram(g, append(bm.MakeOptions(sess), tea.WithInput(in), tea.WithFPS(ui.FrameRate))...)314315 315316 // The connection's context ends when the client goes away; cancel316317 // stops the goroutines below when the program quits first.@@ -333,12 +334,17 @@ func (s *Server) run(sess ssh.Session, pty ssh.Pty, winch <-chan ssh.Window, nam
333334 }334335 }()335336 }336- if _, err := p.Run(); err != nil && !errors.Is(err, tea.ErrProgramKilled) {337+ _, err := p.Run()338+ if err != nil && !errors.Is(err, tea.ErrProgramKilled) {337339 s.log.Error("session", "error", err.Error())338340 }339341 p.Kill()340- end := ending{idle: idled.Load(), stopped: s.stopping()}341- end.keep(m)342+ end := ending{idle: idled.Load(), stopped: s.stopping(), crash: g.Finish(err)}343+ if c := end.crash; c != nil {344+ // The report is the server's log: the operator's to read.345+ s.log.Error("session panic", "where", c.Where, "panic", fmt.Sprint(c.Value), "stack", string(c.Stack))346+ }347+ end.keep(g)342348 return end343349 }344350 @@ -9,7 +9,13 @@ import (
99 // fileCell is a cell with formatting or a note as the file writes it; a1010 // cell with neither is just its input (see fileFormat).1111 type fileCell struct {12- Input string `json:"input,omitempty"`12+ Input string `json:"input,omitempty"`13+ // Text says how the input reads when that isn't what the format14+ // says: true for text typed into a Plain text cell whose format15+ // changed since, false for a number or formula typed before the cell16+ // was formatted as Plain text. It needs no version bump: earlier17+ // builds read the input as the format says.18+ Text *bool `json:"text,omitempty"`1319 Format string `json:"format,omitempty"`1420 Decimals *int `json:"decimals,omitempty"`1521 Pattern string `json:"pattern,omitempty"`@@ -32,11 +38,13 @@ type fileCell struct {
3238 }3339 3440 func encodeCell(c *Cell) (json.RawMessage, error) {35- if c.Format.IsZero() && c.Style.IsZero() && c.Note == "" {41+ text := c.readsAgainstFormat()42+ if c.Format.IsZero() && c.Style.IsZero() && c.Note == "" && text == nil {3643 return json.Marshal(c.Input)3744 }3845 fc := fileCell{3946 Input: c.Input,47+ Text: text,4048 Pattern: c.Format.Pattern,4149 Bold: c.Style.Bold,4250 Italic: c.Style.Italic,@@ -59,25 +67,57 @@ func encodeCell(c *Cell) (json.RawMessage, error) {
5967 return json.Marshal(fc)6068 }6169 70+// readsAgainstFormat is the file's text field for c: whether its entry71+// is text, when its format says otherwise (see fileCell), else nil.72+func (c *Cell) readsAgainstFormat() *bool {73+ text := c.Format.Kind == FmtText74+ switch {75+ case text && c.expr != nil, !text && c.typedText:76+ v := c.typedText77+ return &v78+ }79+ return nil80+}81+6282 // decodeCell reads a cell's entry and formatting, as line formats are6383 // stored too.6484 func decodeCell(raw json.RawMessage) (string, Format, Style, error) {65- input, f, st, _, err := decodeNoted(raw)66- return input, f, st, err85+ e, err := decodeNoted(raw)86+ return e.input, e.f, e.st, err87+}88+89+// fileEntry is a cell as the file has it.90+type fileEntry struct {91+ input string92+ f Format93+ st Style94+ note string95+ text *bool // see fileCell.Text96+}97+98+// cell builds the cell, as newCell does, reading its entry as text or99+// not as the file says.100+func (e fileEntry) cell(implied bool) (*Cell, error) {101+ asText := e.f.Kind == FmtText102+ if e.text != nil {103+ asText = *e.text104+ }105+ c, err := readEntry(e.input, e.f, e.st, implied, asText)106+ return c.withNote(CleanNote(e.note)), err67107 }68108 69-// decodeNoted is decodeCell with the cell's note.70-func decodeNoted(raw json.RawMessage) (string, Format, Style, string, error) {109+// decodeNoted is decodeCell with the cell's note and how it reads.110+func decodeNoted(raw json.RawMessage) (fileEntry, error) {71111 var input string72112 if err := json.Unmarshal(raw, &input); err == nil {73- return input, Format{}, Style{}, "", nil113+ return fileEntry{input: input}, nil74114 }75115 var fc fileCell76116 if err := json.Unmarshal(raw, &fc); err != nil {77- return "", Format{}, Style{}, "", err117+ return fileEntry{}, err78118 }79119 input, f, st, err := decodeFormatted(fc)80- return input, f, st, fc.Note, err120+ return fileEntry{input, f, st, fc.Note, fc.Text}, err81121 }82122 83123 // decodeFormatted reads the entry and formatting of a cell written as an@@ -62,3 +62,30 @@ func TestBatchJoinsFormattingSteps(t *testing.T) {
6262 t.Errorf("C1 format %+v", f)6363 }6464 }65+66+// An entry reads as it was typed until it's typed again: a number or67+// formula formatted as Plain text afterwards keeps computing, and text68+// typed into a Plain text cell stays text in another format or none,69+// in the file too, and a formula that doesn't parse stays text without70+// making the file unreadable.71+func TestPlainTextFormatKeepsEntries(t *testing.T) {72+ s := New()73+ s.Set(at("A1"), "=1+1")74+ s.Set(at("A2"), "5")75+ s.SetFormat(rect("A1:A2"), Format{Kind: FmtText})76+ s.SetFormat(rect("B1:B3"), Format{Kind: FmtText})77+ s.Set(at("B1"), "=1+1")78+ s.Set(at("B2"), "5")79+ s.Set(at("B3"), "=SUM(")80+ s.SetFormat(rect("B1:B1"), Format{Kind: FmtNumber, Decimals: 1})81+ s.ClearFormatting(rect("B2:B3"))82+ want := map[string]Value{"A1": num(2), "A2": num(5),83+ "B1": {Kind: Text, Str: "=1+1"}, "B2": {Kind: Text, Str: "5"}, "B3": {Kind: Text, Str: "=SUM("}}84+ for name, sh := range map[string]*Sheet{"edited": s, "reopened": roundTrip(t, s)} {85+ for a, v := range want {86+ if got := sh.Value(at(a)); got != v {87+ t.Errorf("%s: %s = %+v, want %+v", name, a, got, v)88+ }89+ }90+ }91+}@@ -34,6 +34,14 @@ type tooDeep struct{}
3434 type evaluator struct {3535 w *Workbook3636 pending []loc // cells put off, each needed by the one before37+ // stack holds the formulas being evaluated, outermost first, and38+ // cycle the cells found to be part of a cycle: every formula on the39+ // stack from the cell reached again up. Each of them is #REF!,40+ // whatever its formula makes of the #REF! it read (IFERROR, COUNTIF),41+ // as in Sheets, so a cycle's values don't depend on the order its42+ // cells were evaluated in.43+ stack []loc44+ cycle map[loc]bool3745 }3846 3947 // evaluate computes the cells marked dirty in each sheet's calc. Cells@@ -79,7 +87,10 @@ func (e *evaluator) compute(s *Sheet, a Addr) Value {
7987 return v8088 }8189 switch st := s.calc[a]; {82- case st == visiting, st == deferred:90+ case st == visiting:91+ e.inCycle(loc{s, a})92+ return ErrRef93+ case st == deferred:8394 w.Circular = true8495 return ErrRef8596 case st != dirty:@@ -119,17 +130,38 @@ func (e *evaluator) formula(s *Sheet, a Addr, c *Cell) {
119130 s.calc[a] = visiting120131 w.depth++121132 expr := s.bound(c)122- outer := w.evaluating123- w.evaluating = loc{s, a}133+ outer, l := w.evaluating, loc{s, a}134+ w.evaluating = l135+ e.stack = append(e.stack, l)124136 c.Value = functions.EvalCell(w.arith(expr), s.calcGet.lib, a)125- if s.calcGet.lib.Spilled() != nil || s.spills != nil {126- w.noteSpill(s, a, c)137+ e.stack = e.stack[:len(e.stack)-1]138+ arr := s.calcGet.lib.Spilled()139+ if e.cycle[l] {140+ c.Value, arr = ErrRef, nil141+ }142+ if arr != nil || s.spills != nil {143+ w.noteSpill(s, a, c, arr)127144 }128145 w.evaluating = outer129146 c.auto = functions.InferFormat(expr, s.calcFmt)130147 w.depth--131148 }132149 150+// inCycle notes that the formula at l, being evaluated, was reached151+// again: it and the formulas it led to, up the stack, form a cycle.152+func (e *evaluator) inCycle(l loc) {153+ e.w.Circular = true154+ if e.cycle == nil {155+ e.cycle = map[loc]bool{}156+ }157+ for i := len(e.stack) - 1; i >= 0; i-- {158+ e.cycle[e.stack[i]] = true159+ if e.stack[i] == l {160+ return161+ }162+ }163+}164+133165 // sweep evaluates s's dirty cells, reporting false if it went too deep134166 // and put off a cell.135167 func (e *evaluator) sweep(s *Sheet) (finished bool) {@@ -188,5 +220,6 @@ func (e *evaluator) abandon(finished *bool) {
188220 }189221 e.w.depth = 0190222 e.w.evaluating = loc{}223+ e.stack = e.stack[:0]191224 *finished = false192225 }@@ -101,3 +101,28 @@ func TestFullSheetChain(t *testing.T) {
101101 t.Errorf("IV8192 = %+v, want %v", got, fmt.Sprint(want.Num))102102 }103103 }104+105+// Every cell of a cycle is #REF!, even one whose formula would make106+// something else of the #REF! it reads (COUNTIF skips errors, IFERROR107+// catches them), whichever of its cells is evaluated first: typed in108+// either order, or all at once on opening.109+func TestCycleIsRefWhateverReadsIt(t *testing.T) {110+ for _, reader := range []string{`=COUNTIF(F1:F20,">2")`, "=IFERROR(F13,0)"} {111+ for _, order := range [][2]string{{"C5", "F13"}, {"F13", "C5"}} {112+ s := New()113+ in := map[string]string{"C5": reader, "F13": "=C5+1"}114+ for _, a := range order {115+ s.Set(at(a), in[a])116+ }117+ reopened := roundTrip(t, s)118+ for _, a := range order {119+ if v := s.Value(at(a)); v != ErrRef {120+ t.Errorf("%s typed %v: %s = %v", reader, order, a, v)121+ }122+ if v := reopened.Value(at(a)); v != ErrRef {123+ t.Errorf("%s reopened: %s = %v", reader, a, v)124+ }125+ }126+ }127+ }128+}@@ -332,9 +332,7 @@ func (s *Sheet) readCell(sc *scanner, a Addr, implied bool) error {
332332 if err != nil {333333 return err334334 }335- var input, note string336- var fm Format337- var st Style335+ var e fileEntry338336 if c == '"' {339337 body, plain, err := sc.text()340338 if err != nil {@@ -343,7 +341,7 @@ func (s *Sheet) readCell(sc *scanner, a Addr, implied bool) error {
343341 if plain && s.loadNum(a, body, Format{}, Style{}) {344342 return nil345343 }346- if input, err = unquote(body, plain); err != nil {344+ if e.input, err = unquote(body, plain); err != nil {347345 return err348346 }349347 } else {@@ -351,19 +349,19 @@ func (s *Sheet) readCell(sc *scanner, a Addr, implied bool) error {
351349 if err != nil {352350 return err353351 }354- if input, fm, st, note, err = decodeNoted(raw); err != nil {352+ if e, err = decodeNoted(raw); err != nil {355353 return err356354 }357- if note == "" && s.loadNum(a, []byte(input), fm, st) {355+ if e.note == "" && e.text == nil && s.loadNum(a, []byte(e.input), e.f, e.st) {358356 return nil359357 }360358 }361- cell, err := newCell(input, fm, st, implied)359+ cell, err := e.cell(implied)362360 if err != nil {363361 return err364362 }365363 // An empty entry leaves no cell, even where the key came before.366- if cell = cell.withNote(CleanNote(note)); cell != nil || s.cells.has(a) {364+ if cell != nil || s.cells.has(a) {367365 s.place(a, cell)368366 }369367 return nil@@ -82,15 +82,15 @@ func placeWhole(s *Sheet, cells map[string]json.RawMessage, version int) (ambigu
8282 }8383 ambiguous = ambiguous || seen[a]8484 seen[a] = true85- input, fm, st, note, err := decodeNoted(raw)85+ e, err := decodeNoted(raw)8686 if err != nil {8787 return false, err8888 }89- c, err := newCell(input, fm, st, version < 2)89+ c, err := e.cell(version < 2)9090 if err != nil {9191 return false, err9292 }93- if c = c.withNote(CleanNote(note)); c != nil {93+ if c != nil {9494 s.place(a, c)9595 }9696 }@@ -0,0 +1,140 @@
1+package sheet2+3+import (4+ "bytes"5+ "flag"6+ "fmt"7+ "os"8+ "path/filepath"9+ "regexp"10+ "strings"11+ "testing"12+)13+14+// saveFixtures names a release: go test -run TestFixtures -fixtures15+// v1.2.3 saves the workbooks in testdata/fixtures/new with this build16+// into testdata/fixtures/v1.2.3. See docs/contributing/releasing.md.17+var saveFixtures = flag.String("fixtures", "", "save testdata/fixtures/new into testdata/fixtures/<release>")18+19+var releaseDir = regexp.MustCompile(`^v\d+\.\d+\.\d+$`)20+21+// TestFixturesOpenAndSaveUnchanged opens every workbook a release saved22+// (testdata/fixtures/<release>) and saves it again: the bytes must be23+// the file's own. The writer puts every map in a fixed order (cells by24+// row then column, widths and lines by column, names by name), so byte25+// order never legitimately varies and the comparison is exact.26+// v0.2.0's fixtures were saved by that tag from fixtures/new, less the27+// rule and validation options it refuses (date periods, top values,28+// duplicates, averages, data bars, icon sets, dropdown display and29+// checkbox values).30+func TestFixturesOpenAndSaveUnchanged(t *testing.T) {31+ if *saveFixtures != "" {32+ writeFixtures(t, *saveFixtures)33+ }34+ dirs, err := os.ReadDir("testdata/fixtures")35+ if err != nil {36+ t.Fatal(err)37+ }38+ n := 039+ for _, d := range dirs {40+ if !d.IsDir() || !releaseDir.MatchString(d.Name()) {41+ continue42+ }43+ files, _ := filepath.Glob(filepath.Join("testdata/fixtures", d.Name(), "*.012"))44+ for _, path := range files {45+ n++46+ t.Run(d.Name()+"/"+filepath.Base(path), func(t *testing.T) {47+ want, err := os.ReadFile(path)48+ if err != nil {49+ t.Fatal(err)50+ }51+ if got := resave(t, want); !bytes.Equal(got, want) {52+ t.Errorf("saved differently:\n%s", lineDiff(string(want), string(got)))53+ }54+ })55+ }56+ }57+ if n == 0 {58+ t.Fatal("no fixtures in testdata/fixtures/v*")59+ }60+}61+62+// TestFixtureSourcesStable checks that the workbooks the next release's63+// fixtures are made from open, and that what this build saves of them64+// saves again unchanged, so -fixtures always makes fixtures that pass.65+func TestFixtureSourcesStable(t *testing.T) {66+ files, _ := filepath.Glob("testdata/fixtures/new/*.012")67+ if len(files) == 0 {68+ t.Fatal("no workbooks in testdata/fixtures/new")69+ }70+ for _, path := range files {71+ t.Run(filepath.Base(path), func(t *testing.T) {72+ src, err := os.ReadFile(path)73+ if err != nil {74+ t.Fatal(err)75+ }76+ once := resave(t, src)77+ if twice := resave(t, once); !bytes.Equal(once, twice) {78+ t.Errorf("saved differently the second time:\n%s", lineDiff(string(once), string(twice)))79+ }80+ })81+ }82+}83+84+// resave opens a file and returns what this build saves of it.85+func resave(t *testing.T, data []byte) []byte {86+ t.Helper()87+ wb, err := ReadBook(bytes.NewReader(data))88+ if err != nil {89+ t.Fatalf("open: %v", err)90+ }91+ var out bytes.Buffer92+ if err := wb.Write(&out); err != nil {93+ t.Fatalf("save: %v", err)94+ }95+ return out.Bytes()96+}97+98+// writeFixtures saves testdata/fixtures/new with this build as the99+// fixtures of release, refusing to replace a release's fixtures.100+func writeFixtures(t *testing.T, release string) {101+ if !releaseDir.MatchString(release) {102+ t.Fatalf("-fixtures %q: want a release such as v1.2.3", release)103+ }104+ dir := filepath.Join("testdata/fixtures", release)105+ if _, err := os.Stat(dir); err == nil {106+ t.Fatalf("%s exists: a release's fixtures are never replaced", dir)107+ }108+ if err := os.MkdirAll(dir, 0o755); err != nil {109+ t.Fatal(err)110+ }111+ files, _ := filepath.Glob("testdata/fixtures/new/*.012")112+ for _, path := range files {113+ src, err := os.ReadFile(path)114+ if err != nil {115+ t.Fatal(err)116+ }117+ if err := os.WriteFile(filepath.Join(dir, filepath.Base(path)), resave(t, src), 0o644); err != nil {118+ t.Fatal(err)119+ }120+ }121+}122+123+// lineDiff lists the lines of want and got that differ, by line number.124+func lineDiff(want, got string) string {125+ w, g := strings.Split(want, "\n"), strings.Split(got, "\n")126+ var b strings.Builder127+ for i := range max(len(w), len(g)) {128+ var wl, gl string129+ if i < len(w) {130+ wl = w[i]131+ }132+ if i < len(g) {133+ gl = g[i]134+ }135+ if wl != gl {136+ fmt.Fprintf(&b, "%d:\n want %s\n got %s\n", i+1, wl, gl)137+ }138+ }139+ return b.String()140+}@@ -15,6 +15,12 @@ func (w *Workbook) restore(st *step) (inv *step, changed []loc) {
1515 inv.sheets = w.sheetList()1616 w.setSheets(st.sheets)1717 }18+ for s, r := range st.regions {19+ changed = append(changed, s.emptyMoved(r)...)20+ }21+ for s, img := range st.cells {22+ changed = append(changed, s.emptyUnder(img)...)23+ }1824 for s, img := range st.cells {1925 img.each(func(a Addr, c *Cell) {2026 inv.keep(s, a)@@ -38,3 +38,17 @@ func TestMergeFormattingUndo(t *testing.T) {
3838 t.Errorf("pasted C1 %+v", c)3939 }4040 }41+42+// A merge that deleting rows takes away frees the array it blocked.43+func TestDeletedMergeFreesArray(t *testing.T) {44+ s := New()45+ s.Merge(NewRect(at("B18"), at("C20")), MergeVertically)46+ s.Set(at("B17"), "=SEQUENCE(2)")47+ if v := s.Value(at("B17")); v != ErrRef {48+ t.Fatalf("B17 over a merge = %v", v)49+ }50+ s.DeleteRows(18, 3)51+ if v := s.Value(at("B18")); v != num(2) {52+ t.Errorf("B18 once the merge went = %v", v)53+ }54+}@@ -0,0 +1,322 @@
1+package sheet2+3+import (4+ "fmt"5+ "strings"6+7+ "github.com/FelineStateMachine/012/internal/notebook"8+)9+10+// The edits TestRandomEdits draws from, each one undo step (or none,11+// when it's refused), described for the log.12+var randEdits = []func(r *randBook, e *edits) string{13+ (*randBook).editSet, (*randBook).editSet, (*randBook).editSet,14+ (*randBook).editErase, (*randBook).editPaste, (*randBook).editFill,15+ (*randBook).editSeries, (*randBook).editSort, (*randBook).editInsert,16+ (*randBook).editDelete, (*randBook).editFormat, (*randBook).editStyle,17+ (*randBook).editMerge, (*randBook).editMove, (*randBook).editLayout,18+ (*randBook).editNote, (*randBook).editRule, (*randBook).editRegion,19+ (*randBook).editSheets, (*randBook).editView,20+}21+22+func (r *randBook) edit(e *edits) string {23+ return randEdits[e.n(len(randEdits))](r, e)24+}25+26+// sheet picks one of the grid sheets (not the notebook) to edit.27+func (r *randBook) sheet(e *edits) *Sheet {28+ var grids []*Sheet29+ for _, s := range r.wb.sheets {30+ if !s.IsNotebook() {31+ grids = append(grids, s)32+ }33+ }34+ return grids[e.n(len(grids))]35+}36+37+// input is something to type into a cell: numbers, text, dates and38+// formulas that reach across ranges, sheets, names, regions and spills.39+func (r *randBook) input(e *edits) string {40+ ref := func() string {41+ a := e.addr()42+ if e.n(4) == 0 {43+ return "$" + ColName(a.Col) + "$" + fmt.Sprint(a.Row+1)44+ }45+ return a.String()46+ }47+ rng := func() string { return e.rect().String() }48+ other := []string{"Sheet1", "S2"}[e.n(2)]49+ forms := []func() string{50+ func() string { return fmt.Sprint(e.n(20) - 5) },51+ func() string { return fmt.Sprintf("%d.5", e.n(10)) },52+ func() string { return []string{"a", "b", "x y", "TRUE", "2026-01-05", "10%"}[e.n(6)] },53+ func() string { return "=" + ref() + "+" + ref() },54+ func() string { return "=SUM(" + rng() + ")" },55+ func() string { return "=" + other + "!" + ref() + "*2" },56+ func() string { return "=SUM(" + other + "!" + rng() + ")" },57+ func() string { return "=IFERROR(" + ref() + "/" + ref() + ",0)" },58+ func() string { return `=COUNTIF(` + rng() + `,">2")` },59+ func() string { return "=SEQUENCE(" + fmt.Sprint(1+e.n(3)) + ")" },60+ func() string { return "=SORT(" + rng() + ")" },61+ func() string { return "=VLOOKUP(" + ref() + "," + rng() + ",1,FALSE)" },62+ func() string { return "=SUM(nu.r1)" },63+ func() string { return "=SUM(Total)*2" },64+ func() string { return "=INDEX(" + rng() + ",1,1)" },65+ func() string { return "=MAX(" + ColName(e.n(randCols)) + ":" + ColName(e.n(randCols)) + ")" },66+ func() string { return "=CONCAT(" + ref() + "," + ref() + ")" },67+ func() string { return "=ABS(" + ref() + ")+1" },68+ func() string { return "=" + ref() + "&\"\"" },69+ func() string { return "" },70+ }71+ return forms[e.n(len(forms))]()72+}73+74+func (r *randBook) editSet(e *edits) string {75+ s, a, in := r.sheet(e), e.addr(), r.input(e)76+ err := s.Set(a, in)77+ return fmt.Sprintf("%s!%s = %q (%v)", s.name, a, in, err)78+}79+80+func (r *randBook) editErase(e *edits) string {81+ s, rg := r.sheet(e), e.rect()82+ s.EraseRange(rg)83+ return fmt.Sprintf("erase %s!%s", s.name, rg)84+}85+86+func (r *randBook) editPaste(e *edits) string {87+ src, dst := r.sheet(e), r.sheet(e)88+ from, to := e.rect(), e.rect()89+ values := e.n(3) == 090+ _, err := dst.Paste(src.Copy(from), to, values)91+ return fmt.Sprintf("copy %s!%s, paste (values %v) %s!%s (%v)", src.name, from, values, dst.name, to, err)92+}93+94+func (r *randBook) editFill(e *edits) string {95+ s, rg := r.sheet(e), e.rect()96+ var err error97+ if e.n(2) == 0 {98+ _, err = s.FillDown(rg)99+ return fmt.Sprintf("fill down %s!%s (%v)", s.name, rg, err)100+ }101+ _, err = s.FillRight(rg)102+ return fmt.Sprintf("fill right %s!%s (%v)", s.name, rg, err)103+}104+105+func (r *randBook) editSeries(e *edits) string {106+ s, src := r.sheet(e), e.rect()107+ dst := src108+ if e.n(2) == 0 {109+ dst.To.Row = min(dst.To.Row+1+e.n(6), randRows-1)110+ } else {111+ dst.To.Col = min(dst.To.Col+1+e.n(3), randCols-1)112+ }113+ _, err := s.FillSeries(src, dst)114+ return fmt.Sprintf("series %s!%s to %s (%v)", s.name, src, dst, err)115+}116+117+func (r *randBook) editSort(e *edits) string {118+ s, rg := r.sheet(e), e.rect()119+ keys := []SortKey{{Col: rg.From.Col + e.n(rg.To.Col-rg.From.Col+1), Desc: e.n(2) == 0}}120+ if e.n(2) == 0 {121+ keys = append(keys, SortKey{Col: rg.From.Col + e.n(rg.To.Col-rg.From.Col+1)})122+ }123+ s.SortRange(rg, keys)124+ return fmt.Sprintf("sort %s!%s by %v", s.name, rg, keys)125+}126+127+func (r *randBook) editInsert(e *edits) string {128+ s, at, n := r.sheet(e), e.n(randRows), 1+e.n(3)129+ if e.n(2) == 0 {130+ err := s.InsertRows(at, n)131+ return fmt.Sprintf("insert %d rows at %s!%d (%v)", n, s.name, at+1, err)132+ }133+ at %= randCols134+ err := s.InsertCols(at, n)135+ return fmt.Sprintf("insert %d cols at %s!%s (%v)", n, s.name, ColName(at), err)136+}137+138+func (r *randBook) editDelete(e *edits) string {139+ s, at, n := r.sheet(e), e.n(randRows), 1+e.n(3)140+ if e.n(2) == 0 {141+ s.DeleteRows(at, n)142+ return fmt.Sprintf("delete %d rows at %s!%d", n, s.name, at+1)143+ }144+ at %= randCols145+ s.DeleteCols(at, n)146+ return fmt.Sprintf("delete %d cols at %s!%s", n, s.name, ColName(at))147+}148+149+func (r *randBook) editFormat(e *edits) string {150+ s, rg := r.sheet(e), e.rect()151+ f := Format{Kind: FormatKind(e.n(int(FmtSize) + 1))}152+ if f.Kind.HasDecimals() {153+ f.Decimals = e.n(4)154+ }155+ switch e.n(3) {156+ case 0:157+ rg = colRect(rg.From.Col, rg.To.Col)158+ case 1:159+ rg = rowRect(rg.From.Row, rg.To.Row)160+ }161+ s.SetFormat(rg, f)162+ return fmt.Sprintf("format %s!%s %s", s.name, rg, f.Kind)163+}164+165+func (r *randBook) editStyle(e *edits) string {166+ s, rg := r.sheet(e), e.rect()167+ switch e.n(4) {168+ case 0:169+ s.SetStyle(rg, func(st *Style) { st.Bold = !st.Bold })170+ return fmt.Sprintf("bold %s!%s", s.name, rg)171+ case 1:172+ k, l := BorderKind(e.n(int(BorderNone)+1)), Line(1+e.n(3))173+ s.SetBorders(rg, k, l)174+ return fmt.Sprintf("borders %d %d %s!%s", k, l, s.name, rg)175+ case 2:176+ s.SetStyle(rg, func(st *Style) { st.Wrap = WrapOn })177+ return fmt.Sprintf("wrap %s!%s", s.name, rg)178+ }179+ s.ClearFormatting(rg)180+ return fmt.Sprintf("clear formatting %s!%s", s.name, rg)181+}182+183+func (r *randBook) editMerge(e *edits) string {184+ s, rg := r.sheet(e), e.rect()185+ if e.n(3) == 0 {186+ n := s.Unmerge(rg)187+ return fmt.Sprintf("unmerge %s!%s (%d)", s.name, rg, n)188+ }189+ k := MergeKind(e.n(3))190+ err := s.Merge(rg, k)191+ return fmt.Sprintf("merge %d %s!%s (%v)", k, s.name, rg, err)192+}193+194+func (r *randBook) editMove(e *edits) string {195+ src, dst := r.sheet(e), r.sheet(e)196+ rg, to := e.rect(), e.addr()197+ _, err := src.MoveTo(dst, rg, to)198+ return fmt.Sprintf("move %s!%s to %s!%s (%v)", src.name, rg, dst.name, to, err)199+}200+201+func (r *randBook) editLayout(e *edits) string {202+ s := r.sheet(e)203+ if e.n(2) == 0 {204+ c, w := e.n(randCols), 3+e.n(20)205+ s.SetColWidth(c, w)206+ return fmt.Sprintf("width %s!%s %d", s.name, ColName(c), w)207+ }208+ row, h := e.n(randRows), e.n(4)209+ s.SetRowHeight(row, row, h)210+ return fmt.Sprintf("height %s!%d %d", s.name, row+1, h)211+}212+213+func (r *randBook) editNote(e *edits) string {214+ s, a := r.sheet(e), e.addr()215+ text := []string{"", "note", "another"}[e.n(3)]216+ err := s.SetNote(a, text)217+ return fmt.Sprintf("note %s!%s %q (%v)", s.name, a, text, err)218+}219+220+func (r *randBook) editRule(e *edits) string {221+ s, rg := r.sheet(e), e.rect()222+ switch e.n(3) {223+ case 0:224+ err := s.AddCondFormat(CondFormat{Ranges: []Rect{rg}, Op: RuleGreater, Args: [2]string{fmt.Sprint(e.n(9))}, Style: RuleStyle{Bold: true}})225+ return fmt.Sprintf("conditional format %s!%s (%v)", s.name, rg, err)226+ case 1:227+ err := s.AddValidation(Validation{Ranges: []Rect{rg}, Kind: ValidList, Items: []string{"a", "b"}})228+ return fmt.Sprintf("validation %s!%s (%v)", s.name, rg, err)229+ }230+ s.ClearCondFormats(rg)231+ s.ClearValidations(rg)232+ return fmt.Sprintf("clear rules %s!%s", s.name, rg)233+}234+235+func (r *randBook) editRegion(e *edits) string {236+ _, _, has2 := r.wb.Region("r2")237+ switch e.n(5) {238+ case 0:239+ cells := r.nb.NotebookCells()240+ if len(cells) > 2 {241+ cells = cells[:2]242+ } else {243+ cells = append(cells, notebook.Cell{Source: "r2 = $r1 | first 2"})244+ }245+ r.nb.SetNotebookCells("edit cells", cells)246+ return fmt.Sprintf("notebook cells %d", len(cells))247+ case 1:248+ if has2 {249+ err := r.wb.deleteRegion("r2")250+ return fmt.Sprintf("delete r2 (%v)", err)251+ }252+ s := r.sheet(e)253+ err := r.addOutput(s, "r2", e)254+ return fmt.Sprintf("send r2 to %s (%v)", s.name, err)255+ case 2:256+ if has2 {257+ s, _, _ := r.wb.Region("r2")258+ err := s.FreezeRegion("r2")259+ return fmt.Sprintf("freeze r2 (%v)", err)260+ }261+ }262+ name := "r1"263+ if has2 && e.n(2) == 0 {264+ name = "r2"265+ }266+ r.feed(name, e)267+ return "feed " + name268+}269+270+// deleteRegion deletes the region name, wherever it is.271+func (w *Workbook) deleteRegion(name string) error {272+ s, _, ok := w.Region(name)273+ if !ok {274+ return ErrNoRegion275+ }276+ return s.DeleteRegion(name)277+}278+279+func (r *randBook) editSheets(e *edits) string {280+ s := r.sheet(e)281+ switch e.n(4) {282+ case 0:283+ n, err := r.wb.AddSheet("", e.n(len(r.wb.sheets)+1))284+ if err != nil {285+ return fmt.Sprintf("add sheet (%v)", err)286+ }287+ return "add sheet " + n.name288+ case 1:289+ if s.name == "Sheet1" || s.name == "S2" {290+ return "keep " + s.name291+ }292+ err := r.wb.DeleteSheet(s)293+ return fmt.Sprintf("delete sheet %s (%v)", s.name, err)294+ case 2:295+ name := s.name + "x"296+ if strings.HasPrefix(s.name, "Sheet1") || s.name == "S2" {297+ return "keep the name " + s.name298+ }299+ err := r.wb.RenameSheet(s, name)300+ return fmt.Sprintf("rename %s (%v)", s.name, err)301+ }302+ rg := e.rect()303+ r.wb.DeleteName("Total")304+ err := r.wb.DefineName("Total", s, rg)305+ return fmt.Sprintf("Total = %s!%s (%v)", s.name, rg, err)306+}307+308+func (r *randBook) editView(e *edits) string {309+ s := r.sheet(e)310+ switch e.n(3) {311+ case 0:312+ rows, cols := e.n(3), e.n(3)313+ s.SetFrozen(rows, cols)314+ return fmt.Sprintf("freeze %s %d %d", s.name, rows, cols)315+ case 1:316+ rg := e.rect()317+ s.CreateFilter(rg)318+ return fmt.Sprintf("filter %s!%s", s.name, rg)319+ }320+ s.RemoveFilter()321+ return "remove filter " + s.name322+}@@ -0,0 +1,322 @@
1+package sheet2+3+import (4+ "bytes"5+ "flag"6+ "fmt"7+ "maps"8+ "math"9+ "math/rand/v2"10+ "slices"11+ "strings"12+ "testing"13+14+ "github.com/FelineStateMachine/012/internal/notebook"15+)16+17+// Random edits check invariants that hold between features rather than18+// within one: a sequence of edits, pastes, fills, sorts, inserts and19+// deletes, formats, merges, moves, notes, rules, names, sheets and20+// region runs, drawn from a seed, must leave a workbook that21+//22+// - undoes, step by step, to exactly where it started (the file it23+// saves and every value), and redoes to where it ended;24+// - saves and reopens to the same file and the same values (reopening25+// recalculates everything from scratch, so this is also a full26+// recalculation agreeing with the incremental one);27+// - recalculates in place, everything at once, to the same values.28+//29+// go test runs a fixed set of seeds in a second or two; -randedit.seeds30+// runs more, and FuzzRandomEdits lets the fuzzer choose the edits.31+var (32+ randSeeds = flag.Int("randedit.seeds", 1000, "seeds TestRandomEdits runs")33+ randSteps = flag.Int("randedit.steps", 40, "edits per seed")34+)35+36+func TestRandomEdits(t *testing.T) {37+ seeds := *randSeeds38+ if testing.Short() {39+ seeds = min(seeds, 50)40+ }41+ for seed := range seeds {42+ rng := rand.New(rand.NewPCG(uint64(seed), 12))43+ data := make([]byte, 64+(*randSteps)*8)44+ for i := range data {45+ data[i] = byte(rng.Uint32())46+ }47+ t.Run(fmt.Sprint(seed), func(t *testing.T) {48+ if why, known := randKnown[seed]; known && *randSteps == 40 {49+ t.Skip(why)50+ }51+ checkRandomEdits(t, data, *randSteps)52+ })53+ }54+}55+56+// randKnown are the seeds, of the default 40 edits, whose failures are57+// known and on the roadmap, with why. Dynamic cycle detection finds a58+// cycle only when evaluation walks it: a range read that stops at an59+// error, or an IF branch not taken, hides one that reopening, computing60+// in another order, finds.61+var randKnown = map[int]string{62+ 124: "a cycle hidden behind a range read that stops at an error (roadmap: cycles found from the formulas as written)",63+}64+65+// FuzzRandomEdits reads the edits from the fuzzer's bytes: go test66+// -run '^$' -fuzz FuzzRandomEdits ./internal/sheet.67+func FuzzRandomEdits(f *testing.F) {68+ f.Add([]byte{0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20})69+ f.Fuzz(func(t *testing.T, data []byte) { checkRandomEdits(t, data, 60) })70+}71+72+// edits draws choices from bytes; past their end every choice is 0.73+type edits struct {74+ data []byte75+ i int76+}77+78+func (e *edits) n(k int) int {79+ if k <= 1 || e.i >= len(e.data) {80+ return 081+ }82+ b := int(e.data[e.i])83+ e.i++84+ return b % k85+}86+87+func (e *edits) done() bool { return e.i >= len(e.data) }88+89+// Edits stay in a small corner, so they meet: columns A to H, rows 1 to90+// 20.91+const randCols, randRows = 8, 2092+93+func (e *edits) addr() Addr { return Addr{Col: e.n(randCols), Row: e.n(randRows)} }94+95+func (e *edits) rect() Rect {96+ a := e.addr()97+ return NewRect(a, Addr{Col: min(a.Col+e.n(3), randCols-1), Row: min(a.Row+e.n(5), randRows-1)})98+}99+100+// checkRandomEdits applies up to steps edits from data and checks the101+// invariants. When one fails, it reports the fewest of the edits that102+// still fail, with the log of them.103+func checkRandomEdits(t *testing.T, data []byte, steps int) {104+ t.Helper()105+ msg, log := randomEdits(data, steps)106+ if msg == "" {107+ return108+ }109+ for n := 1; n < len(log); n++ {110+ if m, l := randomEdits(data, n); m != "" {111+ msg, log = m, l112+ break113+ }114+ }115+ t.Fatalf("%s\nafter %d edits:\n %s", msg, len(log), strings.Join(log, "\n "))116+}117+118+// randomEdits builds a workbook, applies up to steps edits from data,119+// and says which invariant fails, if one does, and the edits made.120+//121+// A region's rows come from outside the undo history, as a notebook122+// cell's output or a linked file does: the edits send a region its123+// rows (feed), and after undoing, redoing or reopening, each region is124+// sent the rows its source gave at that point, as the UI would.125+func randomEdits(data []byte, steps int) (string, []string) {126+ e := &edits{data: data}127+ r := newRandBook(e)128+ start, startVals, startFeeds := r.save(), bookValues(r.wb), maps.Clone(r.feeds)129+ var log []string130+ for range steps {131+ if e.done() {132+ break133+ }134+ log = append(log, r.edit(e))135+ r.feedStale()136+ }137+ end, endVals := r.save(), bookValues(r.wb)138+ if d := r.reopenDiff(end, endVals); d != "" {139+ return "reopening differs: " + d, log140+ }141+ undone := 0142+ for r.wb.CanUndo() {143+ r.wb.Undo()144+ undone++145+ }146+ feedAll(r.wb, startFeeds)147+ if got := r.save(); !bytes.Equal(got, start) {148+ return fmt.Sprintf("undoing %d steps saves differently:\n%s", undone, lineDiff(string(start), string(got))), log149+ }150+ if d := diffValues(startVals, bookValues(r.wb)); d != "" {151+ return fmt.Sprintf("undoing %d steps: %s", undone, d), log152+ }153+ for r.wb.CanRedo() {154+ r.wb.Redo()155+ }156+ feedAll(r.wb, r.feeds)157+ if got := r.save(); !bytes.Equal(got, end) {158+ return "redoing saves differently:\n" + lineDiff(string(end), string(got)), log159+ }160+ if d := diffValues(endVals, bookValues(r.wb)); d != "" {161+ return "redoing: " + d, log162+ }163+ r.wb.RecalcAll()164+ r.feedStale()165+ if d := diffValues(endVals, bookValues(r.wb)); d != "" {166+ return "recalculating everything: " + d, log167+ }168+ return "", log169+}170+171+// randBook is the workbook edited, its notebook tab, and the rows each172+// region's source gives now, by region.173+type randBook struct {174+ wb *Workbook175+ nb *Sheet176+ feeds map[string]LiveOp177+}178+179+// newRandBook makes two sheets of values and formulas drawn from e, a180+// named range, a notebook tab of a note and a code cell, the code181+// cell's output sent to S2, then forgets the history, so undoing182+// everything comes back here.183+func newRandBook(e *edits) *randBook {184+ s := New()185+ wb := s.Book()186+ s2, _ := wb.AddSheet("S2", 1)187+ nb, _ := wb.AddNotebook("N", s2)188+ r := &randBook{wb: wb, nb: nb, feeds: map[string]LiveOp{}}189+ for _, sh := range []*Sheet{s, s2} {190+ for range 14 {191+ sh.Set(e.addr(), r.input(e))192+ }193+ }194+ wb.DefineName("Total", s, NewRect(Addr{}, Addr{Col: 1, Row: 9}))195+ nb.SetNotebookCells("add cells", []notebook.Cell{{Kind: notebook.Note, Source: "# Files"}, {Source: "r1 = ls"}})196+ r.addOutput(s2, "r1", e)197+ wb.ClearHistory()198+ return r199+}200+201+// addOutput sends the output of the notebook cell name to s at an empty202+// cell, and gives it rows.203+func (r *randBook) addOutput(s *Sheet, name string, e *edits) error {204+ a := e.addr()205+ for tries := 0; s.Filled(a) && tries < 20; tries++ {206+ a = e.addr()207+ }208+ if err := s.AddRegion(Region{Name: name, At: a, Output: true}); err != nil {209+ return err210+ }211+ r.feed(name, e)212+ return nil213+}214+215+// feed has a region's source give it a random table of numbers under a216+// header, as running its cell would.217+func (r *randBook) feed(name string, e *edits) {218+ rows, cols := e.n(5), 1+e.n(3)219+ op := LiveOp{Region: name, Reset: true}220+ for c := range cols {221+ op.Header = append(op.Header, LiveCell{V: Value{Kind: Text, Str: fmt.Sprintf("c%d", c)}})222+ }223+ for range rows {224+ row := make(LiveRow, cols)225+ for c := range row {226+ row[c] = LiveCell{V: Value{Kind: Number, Num: float64(e.n(20))}}227+ }228+ op.Rows = append(op.Rows, row)229+ }230+ r.feeds[name] = op231+ sendRows(r.wb, op)232+}233+234+// feedStale sends the regions to be sent again (moved, put back by235+// undo) their source's rows, as the UI does after every change.236+func (r *randBook) feedStale() {237+ for _, name := range r.wb.StaleOutputs() {238+ if op, ok := r.feeds[name]; ok {239+ sendRows(r.wb, op)240+ }241+ }242+}243+244+// feedAll sends each region wb holds its source's rows.245+func feedAll(wb *Workbook, feeds map[string]LiveOp) {246+ for _, name := range slices.Sorted(maps.Keys(feeds)) {247+ sendRows(wb, feeds[name])248+ }249+}250+251+// sendRows sends a region its rows. A table widens its columns to its252+// text the first time it shows, outside the undo history as its rows253+// are, so undoing the region leaves them wide; the edits change widths254+// themselves instead.255+func sendRows(wb *Workbook, op LiveOp) {256+ if s, r, ok := wb.Region(op.Region); ok {257+ s.meta(nameKey(r.Name)).fitted = true258+ }259+ wb.ApplyLive(op)260+}261+262+func (r *randBook) save() []byte { return saveBook(r.wb) }263+264+// saveBook is the file wb saves. Saving into memory fails only on a265+// bug, which the test then panics with.266+func saveBook(wb *Workbook) []byte {267+ var b bytes.Buffer268+ if err := wb.Write(&b); err != nil {269+ panic(err)270+ }271+ return b.Bytes()272+}273+274+// reopenDiff reads the saved file, sends its regions their rows again,275+// and says how it differs from the workbook saved.276+func (r *randBook) reopenDiff(file []byte, vals map[string]cellValue) string {277+ wb, err := ReadBook(bytes.NewReader(file))278+ if err != nil {279+ return "reopening: " + err.Error()280+ }281+ if again := saveBook(wb); !bytes.Equal(again, file) {282+ return "saves differently:\n" + lineDiff(string(file), string(again))283+ }284+ feedAll(wb, r.feeds)285+ return diffValues(vals, bookValues(wb))286+}287+288+// cellValue is a cell's value, and what was typed in it to say which.289+type cellValue struct {290+ v Value291+ input string292+}293+294+// bookValues are every filled cell's value, by sheet and address.295+func bookValues(wb *Workbook) map[string]cellValue {296+ out := map[string]cellValue{}297+ for _, s := range wb.sheets {298+ for _, a := range s.Addrs() {299+ out[s.name+"!"+a.String()] = cellValue{s.Value(a), s.Cell(a).Input}300+ }301+ }302+ return out303+}304+305+func diffValues(want, got map[string]cellValue) string {306+ var b strings.Builder307+ for k, w := range want {308+ if g, ok := got[k]; !ok || !sameValue(w.v, g.v) {309+ fmt.Fprintf(&b, "\n %s: want %v (%q), got %v (%q)", k, w.v, w.input, g.v, g.input)310+ }311+ }312+ for k, g := range got {313+ if _, ok := want[k]; !ok {314+ fmt.Fprintf(&b, "\n %s: want nothing, got %v (%q)", k, g.v, g.input)315+ }316+ }317+ return b.String()318+}319+320+func sameValue(a, b Value) bool {321+ return a.Kind == b.Kind && a.Str == b.Str && (a.Num == b.Num || math.IsNaN(a.Num) && math.IsNaN(b.Num))322+}@@ -0,0 +1,58 @@
1+package sheet2+3+// overlapping calls fn with each formula one of whose ranges shares a4+// cell with r, as readers does for one cell; a formula may come more5+// than once. It walks r's columns or the indexed ones, whichever are6+// fewer.7+func (x *rangeIndex) overlapping(r Rect, fn func(Addr)) {8+ if r.From == r.To {9+ x.readers(r.From, fn)10+ return11+ }12+ if r.To.Col-r.From.Col < len(x.byCol) {13+ for c := r.From.Col; c <= r.To.Col; c++ {14+ if iv := x.byCol[c]; iv != nil {15+ iv.overlap(r, fn)16+ }17+ }18+ } else {19+ for c, iv := range x.byCol {20+ if c >= r.From.Col && c <= r.To.Col {21+ iv.overlap(r, fn)22+ }23+ }24+ }25+ x.wide.overlap(r, fn)26+}27+28+// overlap calls fn with the users of every range sharing a cell with r.29+func (iv *intervals) overlap(r Rect, fn func(Addr)) {30+ if len(iv.users) == 0 {31+ return32+ }33+ if iv.sorted == nil {34+ iv.build()35+ }36+ iv.queryRect(0, len(iv.sorted), r, fn)37+}38+39+// queryRect is query for the rows of r rather than one row.40+func (iv *intervals) queryRect(lo, hi int, r Rect, fn func(Addr)) {41+ for lo < hi {42+ mid := (lo + hi) / 243+ if iv.maxEnd[mid] < r.From.Row {44+ return // nothing below reaches r's rows45+ }46+ iv.queryRect(lo, mid, r, fn)47+ g := iv.sorted[mid]48+ if g.From.Row > r.To.Row {49+ return // this and everything after start below r50+ }51+ if _, over := intersectRect(g, r); over {52+ for u := range iv.users[g] {53+ fn(u)54+ }55+ }56+ lo = mid + 157+ }58+}@@ -81,10 +81,9 @@ func (w *Workbook) affected(changed []loc, volatiles bool) int {
8181 // readers marked too, but not those cells: spilling changed what an8282 // anchor shows (spill.go), not its formula.8383 func (w *Workbook) affectedBy(changed, readers []loc, volatiles bool) int {84- m := marking{w: w, queue: append([]loc(nil), changed...), named: w.namedInUse(), byName: map[*Sheet]bool{}}84+ m := marking{readerLookup: w.readerLookup(), queue: append([]loc(nil), changed...)}8585 for _, s := range w.sheets {8686 s.calc = make(map[Addr]int)87- m.byName[s] = w.crossKeys[formula.SheetKey(s.name)] > 08887 if !volatiles {8988 continue9089 }@@ -109,15 +108,28 @@ func (w *Workbook) affectedBy(changed, readers []loc, volatiles bool) int {
109108 return n110109 }111110 112-// marking is the state of affected: the cells still to mark, and what it113-// looks up once rather than for every cell.111+// marking is the state of affected: the cells still to mark.114112 type marking struct {113+ readerLookup114+ queue []loc115+}116+117+// readerLookup finds the formulas that read a cell, with what it looks118+// up once rather than for every cell.119+type readerLookup struct {115120 w *Workbook116- queue []loc117121 named []namedUsers118122 byName map[*Sheet]bool // whether some formula names the sheet119123 }120124 125+func (w *Workbook) readerLookup() readerLookup {126+ r := readerLookup{w: w, named: w.namedInUse(), byName: make(map[*Sheet]bool, len(w.sheets))}127+ for _, s := range w.sheets {128+ r.byName[s] = w.crossKeys[formula.SheetKey(s.name)] > 0129+ }130+ return r131+}132+121133 // namedUsers are the formulas that use a named range, with its cells.122134 type namedUsers struct {123135 s *Sheet@@ -144,27 +156,30 @@ func (m *marking) push(u loc) {
144156 }145157 }146158 147-// readersOf queues the formulas that read the cell l: by reference, by a148-// range over it, through a named range, or by naming its sheet.149-func (m *marking) readersOf(l loc) {159+// readersOf queues the formulas that read the cell l.160+func (m *marking) readersOf(l loc) { m.each(l, m.push) }161+162+// each calls fn with the formulas that read the cell l: by reference, by163+// a range over it, through a named range, or by naming its sheet.164+func (r readerLookup) each(l loc, fn func(loc)) {150165 s, a := l.s, l.a151166 for d := range s.dependents[a] {152- m.push(loc{s, d})167+ fn(loc{s, d})153168 }154- s.rangeUsers.readers(a, func(u Addr) { m.push(loc{s, u}) })155- for _, nu := range m.named {169+ s.rangeUsers.readers(a, func(u Addr) { fn(loc{s, u}) })170+ for _, nu := range r.named {156171 if nu.s == s && nu.r.Contains(a) {157172 for u := range nu.users {158- m.push(u)173+ fn(u)159174 }160175 }161176 }162- if !m.byName[s] {177+ if !r.byName[s] {163178 return // no formula names this sheet164179 }165- for u := range m.w.crossUsers {166- if m.w.crossReads(u, l) {167- m.push(u)180+ for u := range r.w.crossUsers {181+ if r.w.crossReads(u, l) {182+ fn(u)168183 }169184 }170185 }@@ -264,3 +264,38 @@ func (s *Sheet) putRegionsBack(st regionState) {
264264 }265265 s.regions, s.regionsStale = st, true266266 }267+268+// emptyUnder empties the regions holding cells that undo puts contents269+// back in (what a region's table grew over once they left), so the270+// contents come back and the region, sent again, finds them in its way,271+// as before they left.272+func (s *Sheet) emptyUnder(img *image) []loc {273+ if len(s.regions.list) == 0 {274+ return nil275+ }276+ var changed []loc277+ img.each(func(a Addr, c *Cell) {278+ if c == nil || c.Blank() || c.Spilled() {279+ return280+ }281+ if _, me, ok := s.ownerOf(a); ok {282+ changed = append(changed, s.emptyRegion(me)...)283+ }284+ })285+ return changed286+}287+288+// emptyMoved empties the regions that putting st back moves or takes289+// away, outside the undo history, as moving them does, before undo puts290+// cells back: a cell a region holds keeps its value when placed, so291+// what undo brings back where a region moved to would be lost.292+func (s *Sheet) emptyMoved(st regionState) []loc {293+ var changed []loc294+ for _, r := range s.regions.list {295+ i := slices.IndexFunc(st.list, func(x Region) bool { return nameKey(x.Name) == nameKey(r.Name) })296+ if me := s.regionMeta[nameKey(r.Name)]; me != nil && (i < 0 || st.list[i] != r) {297+ changed = append(changed, s.emptyRegion(me)...)298+ }299+ }300+ return changed301+}@@ -49,6 +49,72 @@ func TestSentOutputFollowsRuns(t *testing.T) {
4949 }5050 }5151 52+// Undoing a deleted column puts back the cells a region moved over and53+// was sent again at, rather than keep the region's values there.54+func TestUndoPutsBackCellsARegionMovedOver(t *testing.T) {55+ s := New()56+ w := s.Book()57+ s.Set(at("D19"), "=SEQUENCE(2)")58+ sent(t, s, "r1", "E19")59+ op := LiveOp{Region: "r1", Reset: true, Header: liveRow("n"), Rows: []LiveRow{liveRow("3")}}60+ apply(t, s, op)61+ s.DeleteCols(1, 1)62+ apply(t, s, op) // sent again where it moved, as the UI does63+ wantShown(t, s, map[string]string{"C19": "1", "D19": "n"})64+ w.Undo()65+ apply(t, s, op)66+ wantShown(t, s, map[string]string{"D19": "1", "D20": "2", "E19": "n", "E20": "3"})67+}68+69+// A formula naming a region whose table is blocked reads #REF!, even70+// when the table it showed was only its header, where the region's71+// first cell stays.72+func TestFormulaNamingABlockedRegion(t *testing.T) {73+ s := New()74+ s.Set(at("D1"), "=SUM(nu.r1)")75+ s.Set(at("F12"), "5")76+ sent(t, s, "r1", "E12")77+ apply(t, s, LiveOp{Region: "r1", Reset: true, Header: liveRow("n")})78+ wantShown(t, s, map[string]string{"D1": "0"})79+ apply(t, s, LiveOp{Region: "r1", Reset: true, Header: liveRow("n", "m"), Rows: []LiveRow{liveRow("1", "2")}})80+ wantShown(t, s, map[string]string{"E12": "#REF!", "D1": "#REF!"})81+}82+83+// Undoing a move puts back the cell a region's table grew over once the84+// cell left, and the region, sent again, is blocked by it as before.85+func TestUndoPutsBackCellsARegionGrewOver(t *testing.T) {86+ s := New()87+ w := s.Book()88+ s.Set(at("F14"), "=1+1")89+ sent(t, s, "r1", "E13")90+ op := LiveOp{Region: "r1", Reset: true, Header: liveRow("n", "m"), Rows: []LiveRow{liveRow("1", "2")}}91+ apply(t, s, op)92+ wantShown(t, s, map[string]string{"E13": "#REF!", "F14": "2"})93+ if _, err := s.Move(rect("F14"), at("A1")); err != nil {94+ t.Fatal(err)95+ }96+ apply(t, s, op)97+ wantShown(t, s, map[string]string{"E13": "n", "F14": "2", "A1": "2"})98+ w.Undo()99+ apply(t, s, op)100+ wantShown(t, s, map[string]string{"E13": "#REF!", "F14": "2", "A1": ""})101+ if s.Cell(at("F14")).Input != "=1+1" {102+ t.Errorf("F14 = %q", s.Cell(at("F14")).Input)103+ }104+}105+106+// A region whose column is deleted is gone, and formulas naming it say107+// so, as after reopening.108+func TestFormulaNamingARegionDeleted(t *testing.T) {109+ s := New()110+ s.Set(at("D1"), "=SUM(nu.r1)")111+ sent(t, s, "r1", "H3")112+ apply(t, s, LiveOp{Region: "r1", Reset: true, Header: liveRow("n"), Rows: []LiveRow{liveRow("56")}})113+ wantShown(t, s, map[string]string{"D1": "56"})114+ s.DeleteCols(7, 2)115+ wantShown(t, s, map[string]string{"D1": "#NAME?"})116+}117+52118 func TestSentOutputNames(t *testing.T) {53119 s := New()54120 w := s.Book()@@ -62,13 +62,17 @@ func (w *Workbook) settleRegions() {
6262 }6363 6464 // writeRegions empties the regions that are to be fed again and clears65-// the cells of regions gone, returning the cells that changed.65+// the cells of regions gone, returning the cells that changed and the66+// formulas naming regions gone.6667 func (s *Sheet) writeRegions() []loc {6768 var changed []loc6869 for k, me := range s.regionMeta {6970 if s.regionIndex(k) < 0 {7071 changed = append(changed, s.clearOwned(me, noRect)...)7172 delete(s.regionMeta, k)73+ for u := range s.wb.nameUsers[nameKey(regionPrefix+k)] {74+ changed = append(changed, u) // the name reads nothing now75+ }7276 }7377 }7478 for _, r := range s.regions.list {@@ -94,10 +98,11 @@ func (s *Sheet) emptyRegion(me *regionMeta) []loc {
9498 // nil rows show already. It writes only the cells that differ and9599 // clears the region's cells it no longer needs; when a cell it needs96100 // holds something else, it shows only why. It returns the cells that97-// changed, with the formulas naming the region when its table moved.101+// changed, with the formulas naming the region when its table moved or102+// changed shape.98103 func (s *Sheet) writeTable(r Region, me *regionMeta, header LiveRow, rows []LiveRow, reset bool) []loc {99104 cols, nrows := tableSize(me, header, rows, reset)100- was, had := me.written, me.has105+ was, had, shape := me.written, me.has, [2]int{me.rows, me.cols}101106 need := s.tableArea(r, cols, nrows)102107 me.why = ""103108 switch {@@ -137,7 +142,7 @@ func (s *Sheet) writeTable(r Region, me *regionMeta, header LiveRow, rows []Live
137142 for _, c := range changed {138143 s.freedFor(c.a)139144 }140- if !had || was != me.written {145+ if !had || was != me.written || shape != [2]int{me.rows, me.cols} { // moved, or its table changed shape141146 for u := range s.wb.nameUsers[nameKey(r.FormulaName())] {142147 changed = append(changed, u)143148 }@@ -202,6 +207,16 @@ func (s *Sheet) writeRegionCell(a Addr, c LiveCell, me *regionMeta, changed []lo
202207 // meta me didn't write. Only what the region didn't hold is looked at:203208 // nothing else can be placed in a region's cells.204209 func (s *Sheet) inTheWay(need Rect, me *regionMeta) (Addr, bool) {210+ // An array's cells are in the way even where it spilled blanks, as211+ // another array's are (spill.go).212+ for a, sp := range s.spills {213+ if x, ok := intersectRect(sp.area, need); ok && sp.why == "" {214+ if x.From != a {215+ return x.From, true216+ }217+ return a, true218+ }219+ }205220 for _, part := range fresh(need, me) {206221 for a := range s.cells.anyKeysIn(part) {207222 if s.cells.filledAt(a) && !s.regionOwns(a, me) {@@ -212,6 +227,15 @@ func (s *Sheet) inTheWay(need Rect, me *regionMeta) (Addr, bool) {
212227 return Addr{}, false213228 }214229 230+// regionCell reports whether a region holds the cell at a.231+func (s *Sheet) regionCell(a Addr) bool {232+ if len(s.regions.list) == 0 {233+ return false234+ }235+ _, _, ok := s.ownerOf(a)236+ return ok237+}238+215239 // fresh is the parts of need the region with meta me doesn't hold: all216240 // of it, or when need grows from what it holds, the strips to its right217241 // and below, so rows arriving cost what they add.@@ -233,7 +257,25 @@ func fresh(need Rect, me *regionMeta) []Rect {
233257 // writable reports whether the cell at a is free for the region with234258 // meta me to write.235259 func (s *Sheet) writable(a Addr, me *regionMeta) bool {236- return !s.cells.filledAt(a) || s.regionOwns(a, me)260+ if s.regionOwns(a, me) {261+ return true262+ }263+ _, spilled := s.SpillAnchor(a) // an array's blank cell is its own264+ return !spilled && !s.cells.filledAt(a)265+}266+267+// regionsGiveWay empties the regions whose tables are in area, where an268+// array spills: an array spills over a region's table, whichever came269+// first, as it does when the file opens and arrays spill before regions270+// are sent their rows. Sent again, a region finds the array in its way.271+func (s *Sheet) regionsGiveWay(area Rect) []loc {272+ var changed []loc273+ for _, r := range s.regions.list {274+ if me := s.regionMeta[nameKey(r.Name)]; me != nil && me.has && overlaps(me.written, area) {275+ changed = append(changed, s.emptyRegion(me)...)276+ }277+ }278+ return changed237279 }238280 239281 // regionOwns reports whether the cell at a is one the region with meta@@ -47,6 +47,11 @@ type Cell struct {
4747 volatile bool // expr calls TODAY, NOW, RAND...4848 derived bool // a pivot table's result, owned by the engine: see pivot.go4949 spilled bool // part of an array a formula spills, owned by it: see spill.go50+ // typedText marks text typed into a Plain text cell that would read51+ // as a number or formula, or not at all, typed into a cell of another52+ // format: it stays text when the cell's format changes, as in Sheets,53+ // until it's typed again.54+ typedText bool5055 }5156 5257 // Spilled reports whether the cell shows part of an array another@@ -275,6 +280,13 @@ func (s *Sheet) put(a Addr, input string) error {
275280 // is text. Control characters are dropped so a worksheet file can't276281 // smuggle escape sequences to the terminal.277282 func newCell(input string, f Format, st Style, implied bool) (*Cell, error) {283+ return readEntry(input, f, st, implied, f.Kind == FmtText)284+}285+286+// readEntry is newCell reading the entry as text when asText, and as287+// typed into a cell of another format than Plain text otherwise, as a288+// file says to of an entry typed before its cell's format changed.289+func readEntry(input string, f Format, st Style, implied, asText bool) (*Cell, error) {278290 input = strings.Map(func(r rune) rune {279291 if unicode.IsControl(r) {280292 return -1@@ -285,21 +297,28 @@ func newCell(input string, f Format, st Style, implied bool) (*Cell, error) {
285297 return formattingOnly(f, st), nil286298 }287299 var n Node288- if f.Kind != FmtText {300+ if !asText {289301 var fi Format290302 var err error291303 if n, fi, err = classify(input); err != nil {292304 return nil, err293305 }294- if implied && !fi.IsZero() {306+ if implied && !fi.IsZero() && f.Kind != FmtText {295307 f = fi296308 }297309 }298- c := &Cell{Input: input, Format: f, Style: st}310+ c := &Cell{Input: input, Format: f, Style: st, typedText: asText && readsOtherwise(input)}299311 c.setExpr(n)300312 return c, nil301313 }302314 315+// readsOtherwise reports whether an entry typed as text reads as316+// something else, or not at all, typed into a cell of another format.317+func readsOtherwise(input string) bool {318+ n, _, err := classify(input)319+ return n != nil || err != nil320+}321+303322 // formattingOnly is a blank cell holding formatting, or nil when there is304323 // none.305324 func formattingOnly(f Format, st Style) *Cell {@@ -150,7 +150,7 @@ var noLook look
150150 // strings it uses to the table.151151 func (st *cellStore) plainSlot(c *Cell) (slot, bool) {152152 switch {153- case c.Note != "":153+ case c.Note != "" || c.typedText:154154 return slot{}, false155155 case c.derived || c.spilled:156156 return st.derivedSlot(c)@@ -33,6 +33,9 @@ import (
3333 type spill struct {3434 area Rect // the cells it covers, the anchor first; when blocked, those it needs3535 why string // why the anchor shows #REF! instead, or ""36+ // circular is set when it's blocked by a cycle through its cells37+ // (spillblock.go).38+ circular bool3639 // arr and auto are the array written and its format, so the same3740 // array computed again isn't written again, unless stale says a cell3841 // of area changed since.@@ -55,22 +58,29 @@ type spillWork map[loc]pendingSpill
5558 5659 type pendingSpill struct {5760 arr *functions.Array // nil when the formula computed one value58- v Value // what the formula computed, before spilling61+ v Value // what the anchor showed formulas read meanwhile62+ top Value // what the formula computed, the array's first value5963 }6064 61-// noteSpill records what the formula of c, at a on s, computed, when it62-// spills or did.65+// noteSpill records what the formula of c, at a on s, computed (top,66+// and arr, nil for one value), when it spills or did. An array blocked67+// before keeps showing #REF! until spilling finds it free, so formulas68+// reading it don't see it come and go while it stays blocked.6369 //6470 //go:noinline65-func (w *Workbook) noteSpill(s *Sheet, a Addr, c *Cell) {66- arr, v, l := s.calcGet.lib.Spilled(), c.Value, loc{s, a}67- if arr == nil && s.spills[a] == nil {71+func (w *Workbook) noteSpill(s *Sheet, a Addr, c *Cell, arr *functions.Array) {72+ l, top := loc{s, a}, c.Value73+ sp := s.spills[a]74+ if arr == nil && sp == nil {6875 return6976 }77+ if arr != nil && sp != nil && sp.why != "" {78+ c.Value = ErrRef79+ }7080 if w.spillWork == nil {7181 w.spillWork = spillWork{}7282 }73- w.spillWork[l] = pendingSpill{arr, v}83+ w.spillWork[l] = pendingSpill{arr, c.Value, top}7484 }7585 7686 // settleSpills writes the arrays evaluated, then recalculates what reads@@ -125,22 +135,40 @@ func (s *Sheet) applySpill(a Addr, p pendingSpill) ([]loc, bool) {
125135 if c == nil || !c.IsFormula() || p.arr == nil {126136 return s.dropSpill(a), false127137 }138+ area, why, later := s.spillArea(a, p.arr)139+ var cycle []loc140+ circ := false141+ if why == "" {142+ // Checked each time the anchor is computed: a formula typed since143+ // it spilled may lead from its cells back to it.144+ why, cycle = s.spillsIntoItself(a, area)145+ circ = why != ""146+ }128147 old := s.spills[a]129- if old != nil && old.why == "" && !old.stale && old.auto == c.auto && sameArray(old.arr, p.arr) {148+ if why == "" && len(later) == 0 && old != nil && old.why == "" && !old.stale && old.auto == c.auto && sameArray(old.arr, p.arr) {130149 return nil, false // written already, and nothing has changed in its way131150 }132- area, why := s.spillArea(a, p.arr)151+ var changed []loc152+ if circ != (old != nil && old.circular) {153+ changed = s.wb.recheckArrays(loc{s, a}) // a cycle through arrays began or ended here154+ }133155 if why != "" {134- changed := s.dropSpill(a)135- s.setSpill(a, &spill{area: area, why: why})156+ changed = append(changed, s.dropSpill(a)...)157+ s.setSpill(a, &spill{area: area, why: why, circular: circ})136158 c.Value = ErrRef137- return changed, p.v != ErrRef159+ return append(changed, blockCircular(cycle)...), p.v != ErrRef138160 }139- var changed []loc161+ for _, b := range later {162+ // b's array gives way, and b is computed again to find itself163+ // blocked by this one.164+ changed = append(append(changed, s.dropSpill(b)...), loc{s, b})165+ }166+ changed = append(changed, s.regionsGiveWay(area)...)140167 if old != nil && old.why == "" {141- changed = s.clearSpilled(old.area, area)168+ changed = append(changed, s.clearSpilled(old.area, area)...)142169 }143170 s.setSpill(a, &spill{area: area, arr: p.arr, auto: c.auto})171+ c.Value = p.top144172 for r := range area.To.Row - a.Row + 1 {145173 for col := range area.To.Col - a.Col + 1 {146174 if r == 0 && col == 0 {@@ -152,40 +180,82 @@ func (s *Sheet) applySpill(a Addr, p pendingSpill) ([]loc, bool) {
152180 }153181 }154182 }155- return changed, false183+ return changed, p.v != p.top156184 }157185 158186 // spillArea is where the array computed at a goes, or why it can't: past159187 // the sheet's edge, past max-cells, or over a cell that isn't empty.160188 // Blank entries past the array's data aren't spilled, so a whole column161189 // read as an array spills what it holds.162-func (s *Sheet) spillArea(a Addr, arr *functions.Array) (Rect, string) {190+//191+// When two arrays need the same cells, the one whose anchor comes first,192+// row by row, gets them, whichever spilled first: later lists the193+// anchors whose arrays give way to this one. So what spills doesn't194+// depend on the order formulas were typed or computed in, and a file195+// opens as it was saved.196+func (s *Sheet) spillArea(a Addr, arr *functions.Array) (area Rect, why string, later []Addr) {163197 rows, cols := arr.Rows, arr.Cols164198 if arr.Fill.Kind == Empty {165199 rows, cols = min(rows, max(arr.DRows, 1)), min(cols, max(arr.DCols, 1))166200 }167- area := Rect{From: a, To: Addr{Col: a.Col + cols - 1, Row: a.Row + rows - 1}}201+ area = Rect{From: a, To: Addr{Col: a.Col + cols - 1, Row: a.Row + rows - 1}}168202 switch {169203 case area.To.Row >= MaxRows || area.To.Col >= MaxCols:170204 area.To = Addr{Col: min(area.To.Col, MaxCols-1), Row: min(area.To.Row, MaxRows-1)}171- return area, "Array result was not expanded because it would go past the edge of the sheet"205+ return area, "Array result was not expanded because it would go past the edge of the sheet", nil172206 case rows*cols > MaxCells():173- return area, fmt.Sprintf("Array result was not expanded because it would write more cells than max-cells allows (%d)", MaxCells())207+ return area, fmt.Sprintf("Array result was not expanded because it would write more cells than max-cells allows (%d)", MaxCells()), nil174208 }175209 if ms := s.MergesIn(area); len(ms) > 0 {176- return area, "Array result was not expanded because it would overwrite merged cells in " + ms[0].String()210+ return area, "Array result was not expanded because it would overwrite merged cells in " + ms[0].String(), nil211+ }212+ if at, blocked := s.arraysInTheWay(a, area, &later); blocked {213+ return area, "Array result was not expanded because it would overwrite data in " + at.String(), nil177214 }178215 old := s.spills[a]179216 for at := range s.cells.anyKeysIn(area) {180217 if at == a || !s.cells.filledAt(at) {181218 continue182219 }183- if s.cells.derivedAt(at) == slotSpill && old != nil && old.why == "" && old.area.Contains(at) {184- continue220+ if s.cells.derivedAt(at) == slotSpill {221+ if old != nil && old.why == "" && old.area.Contains(at) {222+ continue223+ }224+ if _, ok := s.SpillAnchor(at); ok || s.regionCell(at) {225+ continue // an array's, found above, or a region's, which gives way226+ }227+ }228+ return area, "Array result was not expanded because it would overwrite data in " + at.String(), nil229+ }230+ return area, "", later231+}232+233+// arraysInTheWay finds the other arrays spilled over area, where the234+// array at a would go, blank cells of theirs included, as Sheets keeps235+// an array's whole range: it reports a cell of one whose anchor comes236+// before a, which blocks it, and adds to later those whose anchors come237+// after.238+func (s *Sheet) arraysInTheWay(a Addr, area Rect, later *[]Addr) (Addr, bool) {239+ if n := len(s.spills); n == 0 || n == 1 && s.spills[a] != nil {240+ return Addr{}, false241+ }242+ var at Addr243+ blocked := false244+ for row := area.From.Row; row <= area.To.Row && !blocked; row++ {245+ for col := area.From.Col; col <= area.To.Col && !blocked; col++ {246+ cell := Addr{Col: col, Row: row}247+ s.spillAt.readers(cell, func(b Addr) {248+ switch sp := s.spills[b]; {249+ case b == a || sp == nil || sp.why != "" || blocked:250+ case b.Row < a.Row || b.Row == a.Row && b.Col < a.Col:251+ at, blocked = cell, true252+ case !slices.Contains(*later, b):253+ *later = append(*later, b)254+ }255+ })185256 }186- return area, "Array result was not expanded because it would overwrite data in " + at.String()187257 }188- return area, ""258+ return at, blocked189259 }190260 191261 // writeSpilled makes the cell at a show v as a spilled cell, keeping its@@ -221,7 +291,7 @@ func (s *Sheet) clearSpilled(area, keep Rect) []loc {
221291 var changed []loc222292 var gone []Addr223293 for at := range s.cells.anyKeysIn(area) {224- if s.cells.derivedAt(at) == slotSpill && !keep.Contains(at) {294+ if s.cells.derivedAt(at) == slotSpill && !keep.Contains(at) && !s.regionCell(at) {225295 gone = append(gone, at)226296 }227297 }@@ -229,7 +299,32 @@ func (s *Sheet) clearSpilled(area, keep Rect) []loc {
229299 s.setDerived(at, s.cells.get(at).leftover())230300 changed = append(changed, loc{s, at})231301 }232- return changed302+ return append(changed, s.wakeBlocked(area, keep)...)303+}304+305+// wakeBlocked returns the anchors of arrays blocked from spilling over306+// the cells of area outside keep, which an array leaving them freed, to307+// compute again, and marks the regions blocked there to be sent again.308+// The cells it left may have been blank, which changing309+// wouldn't find.310+func (s *Sheet) wakeBlocked(area, keep Rect) []loc {311+ var out []loc312+ freed := func(r Rect) bool {313+ x, ok := intersectRect(r, area)314+ return ok && !(keep.Contains(x.From) && keep.Contains(x.To))315+ }316+ for b, sp := range s.spills {317+ if sp.why != "" && freed(sp.area) {318+ sp.stale = true319+ out = append(out, loc{s, b})320+ }321+ }322+ for _, me := range s.regionMeta {323+ if me.why != "" && freed(me.need) {324+ me.stale = true // sent again, as a region blocked by a cell cleared is325+ }326+ }327+ return out233328 }234329 235330 // dropSpill forgets the anchor at a's spill and clears its cells,@@ -204,3 +204,101 @@ func TestSpillRules(t *testing.T) {
204204 t.Errorf("A4's look = %+v, want styled and invalid", l)205205 }206206 }207+208+// When two arrays need the same cells, the one anchored first, row by209+// row, gets them, whichever was typed first, even where the other's210+// cells are blank; reopening the file agrees.211+func TestOverlappingArraysFirstAnchorWins(t *testing.T) {212+ cases := []struct {213+ first, second [2]string214+ win, lose string215+ }{216+ {[2]string{"C9", "=SORT(E4:G8)"}, [2]string{"D8", "=SEQUENCE(2)"}, "D8", "C9"},217+ {[2]string{"D8", "=SEQUENCE(2)"}, [2]string{"C9", "=SORT(E4:G8)"}, "D8", "C9"},218+ {[2]string{"E5", "=SEQUENCE(3,2)"}, [2]string{"F4", "=SEQUENCE(3)"}, "F4", "E5"},219+ {[2]string{"F4", "=SEQUENCE(3)"}, [2]string{"E5", "=SEQUENCE(3,2)"}, "F4", "E5"},220+ }221+ for _, c := range cases {222+ s := sheetOf(t, map[string]string{"E4": "5", "G8": "1"})223+ s.Set(at(c.first[0]), c.first[1])224+ s.Set(at(c.second[0]), c.second[1])225+ for name, sh := range map[string]*Sheet{"typed": s, "reopened": roundTrip(t, s)} {226+ if v := sh.Value(at(c.lose)); v != ErrRef {227+ t.Errorf("%v then %v, %s: %s = %v", c.first, c.second, name, c.lose, v)228+ }229+ if _, ok := sh.SpillArea(at(c.win)); !ok {230+ t.Errorf("%v then %v, %s: %s doesn't spill", c.first, c.second, name, c.win)231+ }232+ }233+ // Taking the second back frees the first to spill.234+ s.Undo()235+ if _, ok := s.SpillArea(at(c.first[0])); !ok {236+ t.Errorf("%v then %v, undone: %s doesn't spill", c.first, c.second, c.first[0])237+ }238+ }239+}240+241+// A formula reading an array blocked by that formula's own cell reads242+// the anchor's #REF!, settling rather than going back and forth as the243+// formula's own array comes and goes.244+func TestReadingABlockedArray(t *testing.T) {245+ s := New()246+ s.Set(at("A18"), "=SORT(A16:C16)")247+ s.Set(at("A16"), "=SEQUENCE(3)")248+ for name, sh := range map[string]*Sheet{"typed": s, "reopened": roundTrip(t, s)} {249+ for _, a := range []string{"A16", "A18"} {250+ if v := sh.Value(at(a)); v != ErrRef {251+ t.Errorf("%s: %s = %v", name, a, v)252+ }253+ }254+ if sh.Book().Circular {255+ t.Errorf("%s: arrays kept moving", name)256+ }257+ }258+}259+260+// An array whose formula reads its own cells through another formula261+// is a circular dependency too: #REF! for it and what reads it, typed,262+// recalculated or opened, without going back and forth.263+func TestSpillIntoItsInputThroughAFormula(t *testing.T) {264+ s := New()265+ s.Set(at("F11"), "=VLOOKUP(F14,C17:D19,1,FALSE)")266+ s.Set(at("C19"), "=SORT(E9:F11)")267+ s.Set(at("H15"), "=MAX(E:C)")268+ check := func(name string, sh *Sheet) {269+ t.Helper()270+ for _, a := range []string{"C19", "H15"} {271+ if v := sh.Value(at(a)); v != ErrRef {272+ t.Errorf("%s: %s = %v", name, a, v)273+ }274+ }275+ if got := sh.ExplainError(at("C19")); !strings.Contains(got, "Circular dependency") {276+ t.Errorf("%s: %q", name, got)277+ }278+ }279+ check("typed", s)280+ check("reopened", roundTrip(t, s))281+ s.RecalcAll()282+ check("recalculated", s)283+ if s.Book().Circular {284+ t.Error("arrays kept moving")285+ }286+}287+288+// An array that would spill into the cells its formula reads is a289+// circular dependency: #REF!, whether typed or opened, rather than a290+// result that depends on what was computed first.291+func TestSpillIntoItsInput(t *testing.T) {292+ s := sheetOf(t, map[string]string{"C8": "3", "A9": "=SORT(B8:D9)"})293+ for name, sh := range map[string]*Sheet{"typed": s, "reopened": roundTrip(t, s)} {294+ if v := sh.Value(at("A9")); v != ErrRef {295+ t.Errorf("%s: A9 = %v", name, v)296+ }297+ if sh.Filled(at("B9")) || sh.Filled(at("B10")) {298+ t.Errorf("%s: spilled into its input", name)299+ }300+ if got := sh.ExplainError(at("A9")); !strings.Contains(got, "Circular dependency") {301+ t.Errorf("%s: %q", name, got)302+ }303+ }304+}@@ -0,0 +1,156 @@
1+package sheet2+3+// spillsIntoItself finds whether the array at a would spill over a cell4+// its formula reads, other than a itself, directly or through other5+// formulas and the arrays they spill: spilling would change what6+// computed it, a circular dependency, whose values would depend on the7+// order cells were computed in. It returns why, or "", and the other8+// arrays on the way, which are part of the cycle and give way too.9+//10+// It walks the formulas that read the area's cells, and those that read11+// them or what they spill, looking for the anchor: the cells a12+// recalculation after the spill would visit anyway. An array blocked by13+// a cycle counts as spilling over the cells it needs, so the arrays of14+// a cycle stay blocked together whichever was computed first.15+func (s *Sheet) spillsIntoItself(a Addr, area Rect) (string, []loc) {16+ if area.From == area.To {17+ return "", nil18+ }19+ w := &spillWalk{look: s.wb.readerLookup(), target: loc{s, a}, seen: map[loc]bool{{s, a}: true}, parent: -1}20+ if w.cells(s, area, a, loc{}, true) {21+ return circular(w.origin), nil22+ }23+ for i := 0; i < len(w.queue); i++ {24+ u := w.queue[i]25+ w.origin, w.parent = w.nodes[i].from, i26+ // An array's cells first, so a cycle through them is found as27+ // one, and the array blocked with it, rather than through the28+ // anchor alone.29+ if sp := u.s.spills[u.a]; sp != nil && (sp.why == "" || sp.circular) {30+ w.cells(u.s, sp.area, u.a, u, false)31+ }32+ if !w.found {33+ w.look.each(u, w.visitVia(loc{}))34+ }35+ if w.found {36+ return circular(w.origin), w.arrays()37+ }38+ }39+ return "", nil40+}41+42+// spillWalk is the state of spillsIntoItself: the formulas reached, in43+// the order found, each with how it was reached.44+type spillWalk struct {45+ look readerLookup46+ target loc47+ seen map[loc]bool48+ queue []loc49+ nodes []walkNode50+ origin Addr // the cell of the area the walk is on51+ parent int // the node the walk is on, -1 at the start52+ via loc // the array whose cells the walk is on, if any53+ found bool54+ last int // the node the target was reached from55+}56+57+// walkNode is how the walk reached a formula: from which cell of the58+// area, from which node, and through the cells of which array.59+type walkNode struct {60+ from Addr61+ parent int62+ via loc63+}64+65+// visitVia returns what the walk does with each formula it reaches66+// through the cells of the array via (none when zero).67+func (w *spillWalk) visitVia(via loc) func(loc) {68+ w.via = via69+ return w.visit70+}71+72+func (w *spillWalk) visit(u loc) {73+ switch {74+ case w.found:75+ case u == w.target:76+ w.found, w.last = true, len(w.nodes)77+ w.nodes = append(w.nodes, walkNode{w.origin, w.parent, w.via})78+ case !w.seen[u]:79+ w.seen[u] = true80+ w.queue = append(w.queue, u)81+ w.nodes = append(w.nodes, walkNode{w.origin, w.parent, w.via})82+ }83+}84+85+// cells visits the formulas reading the cells of area on s other than86+// skip, the cells of the array via, and reports whether one leads to87+// the target. At the start, each cell is its own origin.88+func (w *spillWalk) cells(s *Sheet, area Rect, skip Addr, via loc, start bool) bool {89+ visit := w.visitVia(via)90+ for row := area.From.Row; row <= area.To.Row; row++ {91+ for col := area.From.Col; col <= area.To.Col; col++ {92+ at := Addr{Col: col, Row: row}93+ if at == skip {94+ continue95+ }96+ if start {97+ w.origin = at98+ }99+ if w.look.each(loc{s, at}, visit); w.found {100+ return true101+ }102+ }103+ }104+ return false105+}106+107+// arrays are the arrays whose cells the path to the target went108+// through.109+func (w *spillWalk) arrays() []loc {110+ var out []loc111+ for i := w.last; i >= 0; i = w.nodes[i].parent {112+ if v := w.nodes[i].via; v.s != nil {113+ out = append(out, v)114+ }115+ }116+ return out117+}118+119+func circular(at Addr) string {120+ return "Circular dependency: the array would spill into " + at.String() + ", which its formula reads"121+}122+123+// recheckArrays returns every array's anchor but l's, spilling or124+// blocked by a cycle, to compute again: a cycle through arrays that125+// begins or ends at l may take in or let go of others, which checking126+// each again finds, whichever order they're in.127+func (w *Workbook) recheckArrays(l loc) []loc {128+ var out []loc129+ for _, s := range w.sheets {130+ for b, sp := range s.spills {131+ if (loc{s, b}) != l && (sp.why == "" || sp.circular) {132+ sp.stale = true133+ out = append(out, loc{s, b})134+ }135+ }136+ }137+ return out138+}139+140+// blockCircular blocks the arrays at l, part of a cycle with another,141+// and returns the cells that changed, with the anchors, to compute142+// again, finding the cycle themselves.143+func blockCircular(arrays []loc) []loc {144+ var changed []loc145+ for _, l := range arrays {146+ sp := l.s.spills[l.a]147+ if sp == nil || sp.circular {148+ continue149+ }150+ area := sp.area151+ changed = append(changed, l.s.dropSpill(l.a)...)152+ l.s.setSpill(l.a, &spill{area: area, why: "Circular dependency through another array", circular: true})153+ changed = append(changed, l)154+ }155+ return changed156+}@@ -0,0 +1,219 @@
1+package sheet2+3+import (4+ "slices"5+6+ "github.com/FelineStateMachine/012/internal/formula"7+ "github.com/FelineStateMachine/012/internal/functions"8+)9+10+// Steps is a formula evaluated one part at a time, as Excel's Evaluate11+// Formula: the part computed next is marked in the formula, computing it12+// puts its value in its place, and a reference to another formula can be13+// stepped into. The values come from one evaluation by the function14+// library with each part recorded where it stands (functions.EvalParts),15+// so they are what the formula computes, context and all, and a branch16+// IF didn't take is never computed. References are read as the formula17+// reads them: the cell's value.18+type Steps struct {19+ sheet *Sheet20+ at Addr21+ expr Node // the formula as written, which Text prints22+ parts []part // in the order they're computed: operands first, left to right23+ next int // the part computed next; len(parts) once done24+ top functions.Part25+ index map[string]int // parts by pathKey, while references are read26+}27+28+// part is one part of the formula: an operator, a call or a reference.29+type part struct {30+ path []int31+ node Node // as written32+ functions.Part33+ into loc // a reference to a formula's cell, which can be stepped into34+}35+36+// EvaluateSteps starts evaluating the formula at a step by step, or37+// returns nil when a holds no formula.38+func (s *Sheet) EvaluateSteps(a Addr) *Steps {39+ c, _, _ := s.cells.peek(a)40+ if c == nil || !c.IsFormula() {41+ return nil42+ }43+ st := &Steps{sheet: s, at: a, expr: c.expr}44+ var paths [][]int45+ st.collect(c.expr, nil, func(p []int, n Node) {46+ st.parts = append(st.parts, part{path: p, node: n})47+ paths = append(paths, p)48+ })49+ run := s.wb.arith(s.bound(c))50+ var parts []functions.Part51+ st.top, parts = functions.EvalParts(run, paths, s.wb.values(s).lib, a)52+ for i := range st.parts {53+ st.parts[i].Part = parts[i]54+ }55+ st.index = make(map[string]int, len(st.parts))56+ for i, p := range st.parts {57+ st.index[pathKey(p.path)] = i58+ }59+ st.readRefs()60+ st.index = nil61+ st.parts = slices.DeleteFunc(st.parts, func(p part) bool { return !p.Reached })62+ return st63+}64+65+// collect calls fn with the path of each part of n, operands before66+// what they're operands of: operators, calls, LAMBDA calls, and67+// references to one cell, written or named.68+func (st *Steps) collect(n Node, path []int, fn func([]int, Node)) {69+ i := 070+ formula.EachChild(n, func(k Node) {71+ st.collect(k, append(slices.Clip(path), i), fn)72+ i++73+ })74+ switch n := n.(type) {75+ case formula.Unary, formula.Binary, formula.Call, formula.Invoke, formula.Ref:76+ fn(path, n)77+ case formula.Name:78+ if nm, ok := st.sheet.wb.names[nameKey(n.Name)]; ok && !nm.Gone() && nm.Range.From == nm.Range.To {79+ fn(path, n)80+ }81+ }82+}83+84+// readRefs reads the references among the parts, as the formula reads85+// them, where the formula reached them.86+func (st *Steps) readRefs() {87+ for i := range st.parts {88+ p := &st.parts[i]89+ t, a, ok := st.refCell(p.node)90+ if !ok || !st.reached(p.path) {91+ continue92+ }93+ p.Reached = true94+ if t == nil {95+ p.Value = ErrRef96+ continue97+ }98+ p.Value = t.Value(a)99+ if c, _, _ := t.cells.peek(a); c != nil && c.IsFormula() {100+ p.into = loc{t, a}101+ }102+ }103+}104+105+// refCell is the cell a reference or single-cell name points at, and106+// its sheet (nil for a sheet no sheet has the name of).107+func (st *Steps) refCell(n Node) (*Sheet, Addr, bool) {108+ s := st.sheet109+ switch n := n.(type) {110+ case formula.Ref:111+ return s.wb.resolve(s, n.Sheet), n.Addr, true112+ case formula.Name:113+ nm := s.wb.names[nameKey(n.Name)]114+ return nm.Sheet, nm.Range.From, true115+ }116+ return nil, Addr{}, false117+}118+119+// reached reports whether the formula computed what's at path, a120+// reference: when the part it's in was computed, and, for an argument of121+// IF, IFERROR, IFNA or CHOOSE, when that call took it.122+func (st *Steps) reached(path []int) bool {123+ for up := len(path) - 1; up >= 0; up-- {124+ i, ok := st.index[pathKey(path[:up])]125+ if !ok {126+ continue // an array literal: go on out127+ }128+ o := &st.parts[i]129+ if !o.Reached {130+ return false131+ }132+ if up == len(path)-1 {133+ return st.taken(o, path[up])134+ }135+ return true136+ }137+ return true138+}139+140+// taken reports whether the call o, computed, took its argument arg.141+func (st *Steps) taken(o *part, arg int) bool {142+ call, ok := o.node.(formula.Call)143+ if !ok || arg == 0 {144+ return true145+ }146+ first := st.valueAt(append(slices.Clip(o.path), 0), call.Args[0])147+ switch call.Fn.Signature().Name {148+ case "IF":149+ if first.Kind == Error || first.Kind == Text {150+ return false151+ }152+ return (first.Num != 0) == (arg == 1)153+ case "IFERROR":154+ return first.Kind == Error155+ case "IFNA":156+ return first == ErrNA157+ case "CHOOSE":158+ return first.Kind == Number && int(first.Num) == arg159+ }160+ return true161+}162+163+// valueAt is what the node n at path computed: a part's recorded value,164+// or a literal's own.165+func (st *Steps) valueAt(path []int, n Node) Value {166+ if i, ok := st.index[pathKey(path)]; ok && st.parts[i].Reached {167+ return st.parts[i].Value168+ }169+ if t, a, ok := st.refCell(n); ok && t != nil {170+ return t.Value(a)171+ }172+ return functions.EvalAt(n, st.sheet.wb.values(st.sheet).lib, st.at)173+}174+175+// Cell is the formula's cell.176+func (st *Steps) Cell() (*Sheet, Addr) { return st.sheet, st.at }177+178+// Done reports whether every part is computed.179+func (st *Steps) Done() bool { return st.next >= len(st.parts) }180+181+// Progress is how many parts are computed, of how many.182+func (st *Steps) Progress() (done, total int) { return st.next, len(st.parts) }183+184+// Step computes the next part.185+func (st *Steps) Step() {186+ if !st.Done() {187+ st.next++188+ }189+}190+191+// Restart goes back to the formula as written.192+func (st *Steps) Restart() { st.next = 0 }193+194+// Next is the part computed next, as written, and its value as the195+// formula would write it; ok is false once done.196+func (st *Steps) Next() (expr, value string, ok bool) {197+ if st.Done() {198+ return "", "", false199+ }200+ p := st.parts[st.next]201+ return formula.Expr(p.node), partText(p.Part), true202+}203+204+// Result is the formula's value, an array it spills written whole.205+func (st *Steps) Result() string { return partText(st.top) }206+207+// CanStepIn reports whether the next part is a reference to a formula's208+// cell, which Into steps into.209+func (st *Steps) CanStepIn() bool { return !st.Done() && st.parts[st.next].into.s != nil }210+211+// Into starts stepping through the formula the next part refers to,212+// when it is a reference to a formula's cell; nil otherwise.213+func (st *Steps) Into() *Steps {214+ if !st.CanStepIn() {215+ return nil216+ }217+ l := st.parts[st.next].into218+ return l.s.EvaluateSteps(l.a)219+}@@ -0,0 +1,118 @@
1+package sheet2+3+import (4+ "strings"5+ "testing"6+)7+8+// shown writes what Steps shows: values in [], the next part in _.9+func shown(st *Steps) string {10+ var out strings.Builder11+ in := false12+ for _, sg := range st.Text() {13+ if sg.Next != in {14+ out.WriteByte('_')15+ in = sg.Next16+ }17+ t := sg.Text18+ if sg.Value {19+ t = "[" + t + "]"20+ }21+ out.WriteString(t)22+ }23+ if in {24+ out.WriteByte('_')25+ }26+ return out.String()27+}28+29+// walk steps through the formula at a, returning what it shows before30+// each step and at the end.31+func walk(t *testing.T, s *Sheet, a string) []string {32+ t.Helper()33+ st := s.EvaluateSteps(at(a))34+ if st == nil {35+ t.Fatalf("%s: no steps", a)36+ }37+ var out []string38+ for !st.Done() {39+ out = append(out, shown(st))40+ st.Step()41+ }42+ return append(out, shown(st))43+}44+45+func TestSteps(t *testing.T) {46+ s := sheetOf(t, map[string]string{47+ "A1": "5", "A2": "2", "A3": "x",48+ "B1": "=A1+A2*3",49+ "B2": "=IF(A1>3, A1*2, A2+1)",50+ "B3": "=(A1+A2)*2",51+ "B4": "=SUM(A1:A2*2)",52+ "B5": "=LET(x, A1, x*2)",53+ "B6": "=A3&D9",54+ "B7": "=IFERROR(1/0, A2)",55+ "B8": "=SEQUENCE(2)",56+ })57+ for _, tc := range []struct {58+ cell string59+ want string60+ }{61+ {"B1", "=_A1_+A2*3 | =[5]+_A2_*3 | =[5]+_[2]*3_ | =_[5]+[6]_ | [11]"},62+ // The branch IF doesn't take is never computed.63+ {"B2", "=IF(_A1_>3,A1*2,A2+1) | =IF(_[5]>3_,A1*2,A2+1) | =IF([TRUE],_A1_*2,A2+1) | =IF([TRUE],_[5]*2_,A2+1) | =_IF([TRUE],[10],A2+1)_ | [10]"},64+ // The part computed next keeps its parentheses.65+ {"B3", "=(_A1_+A2)*2 | =([5]+_A2_)*2 | =_([5]+[2])_*2 | =_[7]*2_ | [14]"},66+ // In an array context a part computes an array.67+ {"B4", "=SUM(_A1:A2*2_) | =_SUM([{10;4}])_ | [14]"},68+ {"B5", "=LET(x,_A1_,x*2) | =LET(x,[5],_x*2_) | =_LET(x,[5],[10])_ | [10]"},69+ {"B6", `=_A3_&D9 | =["x"]&_D9_ | =_["x"]&[0]_ | ["x"]`},70+ {"B7", "=IFERROR(_1/0_,A2) | =IFERROR([#DIV/0!],_A2_) | =_IFERROR([#DIV/0!],[2])_ | [2]"},71+ {"B8", "=_SEQUENCE(2)_ | [{1;2}]"},72+ } {73+ if got := strings.Join(walk(t, s, tc.cell), " | "); got != tc.want {74+ t.Errorf("%s:\n got %s\nwant %s", tc.cell, got, tc.want)75+ }76+ }77+ if s.EvaluateSteps(at("A1")) != nil {78+ t.Error("steps for a number")79+ }80+}81+82+func TestStepsDecimal(t *testing.T) {83+ s := sheetOf(t, map[string]string{"A1": "0.1", "B1": "=A1+0.2"})84+ s.SetDecimal(true)85+ if got := strings.Join(walk(t, s, "B1"), " | "); got != "=_A1_+0.2 | =_[0.1]+0.2_ | [0.3]" {86+ t.Errorf("decimal: %s", got)87+ }88+}89+90+func TestStepsInto(t *testing.T) {91+ s := sheetOf(t, map[string]string{"A1": "4", "B1": "=A1*2", "C1": "=B1+Rate"})92+ s.DefineName("Rate", rect("A1"))93+ st := s.EvaluateSteps(at("C1"))94+ if expr, v, _ := st.Next(); expr != "B1" || v != "8" {95+ t.Errorf("next %q = %q", expr, v)96+ }97+ in := st.Into()98+ if in == nil {99+ t.Fatal("no stepping into B1")100+ }101+ if _, a := in.Cell(); a != at("B1") || shown(in) != "=_A1_*2" {102+ t.Errorf("into %v: %s", a, shown(in))103+ }104+ if in.Into() != nil {105+ t.Error("stepped into a number")106+ }107+ st.Step()108+ if expr, v, _ := st.Next(); expr != "Rate" || v != "4" {109+ t.Errorf("a name: %q = %q", expr, v)110+ }111+ if done, total := st.Progress(); done != 1 || total != 3 {112+ t.Errorf("progress %d of %d", done, total)113+ }114+ st.Restart()115+ if shown(st) != "=_B1_+Rate" {116+ t.Errorf("restart: %s", shown(st))117+ }118+}@@ -0,0 +1,149 @@
1+package sheet2+3+import (4+ "slices"5+ "strconv"6+ "strings"7+8+ "github.com/FelineStateMachine/012/internal/formula"9+ "github.com/FelineStateMachine/012/internal/functions"10+)11+12+// How Steps shows the formula: as written, with the parts computed so13+// far written as their values and the part computed next marked. The14+// formula printer writes it, from a copy of the formula in which each15+// value stands as a name made of a marker, so the parentheses come out16+// as they would; the marked part is found by printing the copy twice,17+// once with a marker in its place.18+19+// Segment is a piece of the formula Steps shows.20+type Segment struct {21+ Text string22+ // Value marks a value a part computed, written in its place.23+ Value bool24+ // Next marks the part computed next.25+ Next bool26+}27+28+// Markers in the printed formula: a value, \x01 and its index and \x02,29+// and the part computed next, \x03.30+const (31+ valueOpen = "\x01"32+ valueClose = "\x02"33+ nextMark = "\x03"34+)35+36+// Text is the formula as it stands: "=" and its text, with the parts37+// computed so far as their values and the next part marked, or once38+// every part is computed, the formula's value.39+func (st *Steps) Text() []Segment {40+ if st.Done() {41+ return []Segment{{Text: st.Result(), Value: true}}42+ }43+ shown, values := st.expr, []string(nil)44+ var replaced [][]int45+ for i := st.next - 1; i >= 0; i-- {46+ p := st.parts[i]47+ if inside(p.path, replaced) {48+ continue49+ }50+ replaced = append(replaced, p.path)51+ mark := formula.Name{Name: valueOpen + strconv.Itoa(len(values)) + valueClose}52+ values = append(values, partText(p.Part))53+ shown = functions.ReplaceAt(shown, p.path, func(Node) Node { return mark })54+ }55+ whole := formula.Expr(shown)56+ marked := formula.Expr(functions.ReplaceAt(shown, st.parts[st.next].path, func(Node) Node { return formula.Name{Name: nextMark} }))57+ at := strings.Index(marked, nextMark)58+ after := marked[at+len(nextMark):]59+ end := len(whole) - len(after)60+ out := []Segment{{Text: "="}}61+ out = appendValues(out, whole[:at], values, false)62+ out = appendValues(out, whole[at:end], values, true)63+ return appendValues(out, whole[end:], values, false)64+}65+66+// inside reports whether path is within one of paths.67+func inside(path []int, paths [][]int) bool {68+ for _, p := range paths {69+ if len(p) <= len(path) && slices.Equal(p, path[:len(p)]) {70+ return true71+ }72+ }73+ return false74+}75+76+// appendValues splits text at its value markers into segments.77+func appendValues(out []Segment, text string, values []string, next bool) []Segment {78+ for text != "" {79+ i := strings.Index(text, valueOpen)80+ if i < 0 {81+ return append(out, Segment{Text: text, Next: next})82+ }83+ if i > 0 {84+ out = append(out, Segment{Text: text[:i], Next: next})85+ }86+ j := strings.Index(text, valueClose)87+ k, _ := strconv.Atoi(text[i+len(valueOpen) : j])88+ out = append(out, Segment{Text: values[k], Value: true, Next: next})89+ text = text[j+len(valueClose):]90+ }91+ return out92+}93+94+// partText writes what a part computed as a formula would write it: a95+// number plainly, text in quotes, an array in braces (its first rows and96+// columns, then …). A blank reads as 0, as it does in arithmetic.97+func partText(p functions.Part) string {98+ switch {99+ case p.Lambda:100+ return "LAMBDA"101+ case p.Array != nil:102+ return arrayText(p.Array)103+ }104+ return valueText(p.Value)105+}106+107+func valueText(v Value) string {108+ switch v.Kind {109+ case Empty:110+ return "0"111+ case Text:112+ return `"` + strings.ReplaceAll(v.Str, `"`, `""`) + `"`113+ }114+ return v.String()115+}116+117+func arrayText(a *functions.Array) string {118+ var b strings.Builder119+ b.WriteByte('{')120+ for r := range a.DRows {121+ if r > 0 {122+ b.WriteByte(';')123+ }124+ for c := range a.DCols {125+ if c > 0 {126+ b.WriteByte(',')127+ }128+ b.WriteString(valueText(a.At(r, c)))129+ }130+ if a.Cols > a.DCols {131+ b.WriteString(",…")132+ }133+ }134+ if a.Rows > a.DRows {135+ b.WriteString(";…")136+ }137+ b.WriteByte('}')138+ return b.String()139+}140+141+// pathKey is a path as a map key.142+func pathKey(path []int) string {143+ var b strings.Builder144+ for _, i := range path {145+ b.WriteString(strconv.Itoa(i))146+ b.WriteByte('.')147+ }148+ return b.String()149+}@@ -0,0 +1,21 @@
1+{2+ "version": 3,3+ "name": "Haushalt",4+ "names": {"Miete": "B2"},5+ "arithmetic": "decimal",6+ "locale": "de-DE",7+ "widths": {"A": 16},8+ "freeze": {"cols": 1},9+ "filter": {"range": "A1:B4", "columns": {"A": {"condition": "not_empty"}}},10+ "cells": {11+ "A1": "Posten",12+ "B1": "Betrag",13+ "A2": "Miete",14+ "B2": {"input": "1450.10", "format": "currency", "decimals": 2},15+ "A3": "Strom",16+ "B3": {"input": "0.1", "format": "currency", "decimals": 2},17+ "A4": "Summe",18+ "B4": "=SUM(B2:B3)+0.2",19+ "C4": "=B4=1450.4"20+ }21+}@@ -0,0 +1,161 @@
1+{2+ "version": 5,3+ "names": {"Units": "Sales!C2:C9", "Lost": "#REF!", "Rate": "Lists!B1"},4+ "macroOrigin": "fixture-machine",5+ "macros": [6+ {"name": "Bold header", "key": "1", "api": 1, "source": "select(\"A1:E1\")\nrun(\"format.bold\")\n"},7+ {"name": "Fill totals", "api": 1, "source": "set(\"F2\", \"=SUM(C2:C9)\")\n"}8+ ],9+ "shellHistory": ["ls", "open data.csv | first 3"],10+ "active": 0,11+ "sheets": [12+ {13+ "name": "Sales",14+ "widths": {"A": 12, "B": 10, "E": 14},15+ "heights": {"1": 2, "12": 3},16+ "lines": {"A:XFD": {"italic": true}, "D:D": {"format": "currency", "decimals": 2}, "1:1": {"bold": true, "align": "center", "borders": {"bottom": "double"}}},17+ "freeze": {"rows": 1, "cols": 1},18+ "filter": {"range": "A1:E9", "columns": {"B": {"hidden": ["West"]}, "C": {"condition": "gt", "value": "2"}}},19+ "protected": [{"range": "E2:E9", "description": "Totals"}],20+ "merges": ["A11:C11", "A12:A13"],21+ "cells": {22+ "A1": "Date",23+ "B1": "Region",24+ "C1": "Units",25+ "D1": "Price",26+ "E1": "Total",27+ "A2": {"input": "2026-01-05", "format": "date"},28+ "B2": "North",29+ "C2": "3",30+ "D2": "12.5",31+ "E2": {"input": "=C2*D2", "format": "currency", "decimals": 2, "own": true},32+ "A3": {"input": "2026-01-12", "format": "date"},33+ "B3": {"input": "South", "note": "Includes returns"},34+ "C3": "5",35+ "D3": "9.75",36+ "E3": "=C3*D3",37+ "A4": {"input": "2026-02-02", "format": "date"},38+ "B4": "West",39+ "C4": "1",40+ "D4": "40",41+ "E4": "=C4*D4",42+ "A5": {"input": "2026-02-16", "format": "date"},43+ "B5": "North",44+ "C5": "7",45+ "D5": "12.5",46+ "E5": "=C5*D5",47+ "A6": {"input": "2026-03-01", "format": "date"},48+ "B6": "East",49+ "C6": {"input": "2", "bold": true, "italic": true, "underline": true, "strikethrough": true},50+ "D6": "22",51+ "E6": "=C6*D6",52+ "A7": {"input": "2026-03-09", "format": "date"},53+ "B7": "South",54+ "C7": {"input": "4", "align": "left", "valign": "top"},55+ "D7": "9.75",56+ "E7": "=C7*D7",57+ "A8": {"input": "2026-03-20", "format": "date"},58+ "B8": "East",59+ "C8": {"input": "6", "borders": {"top": "thin", "bottom": "double", "left": "thick", "right": "thin", "bottomColor": "red", "leftColor": "blue"}},60+ "D8": "22",61+ "E8": "=C8*D8",62+ "A9": {"input": "2026-03-31", "format": "date"},63+ "B9": "West",64+ "C9": "8",65+ "D9": "40",66+ "E9": "=C9*D9",67+ "G1": "Share",68+ "G2": {"input": "=C2/SUM(Units)", "format": "percent", "decimals": 1},69+ "G3": {"input": "=C3/SUM(Units)", "format": "custom", "pattern": "0.00%;[Red]-0.00%"},70+ "H1": "Regions",71+ "H2": "=SORT(UNIQUE(B2:B9))",72+ "I1": "Scaled",73+ "I2": "=LET(r, Rate, MAP(C2:C4, LAMBDA(x, x*r)))",74+ "J1": {"input": "007", "text": true},75+ "J2": {"input": "=1+1", "text": false, "format": "text"},76+ "A11": {"input": "A long title merged across three columns", "wrap": "wrap", "align": "center"},77+ "A12": {"input": "Tall", "valign": "middle"},78+ "B12": {"input": "clipped text that does not spill over", "wrap": "clip"},79+ "C12": "TRUE",80+ "D12": "=IFERROR(1/0, \"none\")",81+ "E12": {"input": "=Lists!B1*2", "format": "number", "decimals": 3},82+ "F12": "'00123",83+ "F13": "=HYPERLINK(\"https://example.com\", \"site\")"84+ },85+ "charts": [86+ {"type":"column","data":"A1:C9","at":"K2","width":40,"height":12,"header":true,"labels":true,"title":"Units by date"},87+ {"type":"line","data":"C1:E9","at":"K16","width":36,"height":10,"header":true,"stack":"stacked","trend":true,"min":0,"max":400,"gridlines":false,"legend":"none"},88+ {"type":"pie","data":"B1:C5","at":"K28","width":30,"height":10,"header":true,"labels":true,"legend":"right"},89+ {"type":"scatter","data":"C1:D9","at":"K40","width":30,"height":10,"header":true,"trend":true,"log":true},90+ {"type":"bar","data":"B1:C9","at":"K52","width":30,"height":10,"header":true,"stack":"percent"},91+ {"type":"area","data":"C1:D9","at":"K64","width":30,"height":10,"byRow":true,"header":true}92+ ],93+ "conditionalFormats": [94+ {"ranges":"C2:C9","condition":"gt","values":["5"],"text":"red","bold":true},95+ {"ranges":"B2:B9","condition":"contains","values":["th"],"fill":"yellow","italic":true},96+ {"ranges":"A2:A9","condition":"date_is","values":["this week"],"underline":true},97+ {"ranges":"E2:E9","condition":"formula","values":["=$C2>4"],"text":"green","strikethrough":true},98+ {"ranges":"C2:C9","condition":"between","values":["2","4"],"fill":"cyan"},99+ {"ranges":"C2:C9","condition":"top","values":["3"],"fill":"magenta"},100+ {"ranges":"D2:D9","condition":"duplicate","text":"blue"},101+ {"ranges":"C2:C9","condition":"above_average","bold":true},102+ {"ranges":"D2:D9","scale":[{"type":"min","color":"green"},{"type":"percentile","value":"50","color":"yellow"},{"type":"max","color":"red"}]},103+ {"ranges":"E2:E9","dataBar":{"color":"blue","min":{"type":"min"},"max":{"type":"num","value":"400"},"barOnly":true}},104+ {"ranges":"C2:C9,D2:D9","iconSet":{"icons":"arrows","points":[{"type":"percent","value":"33"},{"type":"percent","value":"67"}],"reverse":true}}105+ ],106+ "validations": [107+ {"ranges":"B2:B9","criteria":"list","items":["North","South","East","West"],"help":"Pick a region","display":"chip"},108+ {"ranges":"C2:C9","criteria":"number","condition":"between","values":["0","80"],"reject":true},109+ {"ranges":"A2:A9","criteria":"date","condition":"gt","values":["2025-12-31"]},110+ {"ranges":"C12","criteria":"checkbox","items":["TRUE","FALSE"]},111+ {"ranges":"F2:F9","criteria":"range","source":"Lists!A1:A4","display":"plain"},112+ {"ranges":"G5:G9","criteria":"length","condition":"le","values":["10"]},113+ {"ranges":"H12","criteria":"formula","values":["=H12<>\"\""]}114+ ]115+ },116+ {117+ "name": "Lists",118+ "hidden": true,119+ "protected": [{"sheet": true}],120+ "cells": {121+ "A1": "North",122+ "A2": "South",123+ "A3": "East",124+ "A4": "West",125+ "B1": {"input": "1.5", "note": "Rate used by Sales!I2"}126+ }127+ },128+ {129+ "name": "Pivot Table 1",130+ "cells": {},131+ "pivot": {"source":"Sales!A1:E9","rows":[{"column":"B"},{"column":"A","order":"desc","sortBy":1}],"columns":[{"column":"C"}],"values":[{"column":"E","summarize":"sum"},{"column":"C","summarize":"counta","showAs":"percent_of_total","name":"Share"}],"filters":[{"column":"B","hidden":["West"]}],"rowTotals":true,"columnTotals":false}132+ },133+ {134+ "name": "Data",135+ "widths": {"A": 20},136+ "cells": {137+ "A20": "=SUM(nu.files)"138+ },139+ "regions": [140+ {"name":"files","at":"A1","output":true},141+ {"name":"big","at":"A8","output":true},142+ {"name":"app","at":"F2","path":"logs/app.csv","window":500},143+ {"name":"db","at":"F20","path":"data.sqlite","format":"SQLite","table":"orders"},144+ {"name":"q","at":"M20","path":"data.sqlite","format":"SQLite","query":"select * from orders limit 5"}145+ ]146+ },147+ {148+ "name": "Notebook",149+ "cells": {},150+ "tab": "notebook",151+ "reactive": true,152+ "notebookCells": [153+ {"kind":"note","source":"# Files\nWhat the folder holds."},154+ {"source":"files = ls","output":"[[name, size]; [go.mod, 812b], [README.md, 4kb]]"},155+ {"source":"big = $files | where size > 1kb","output":"[[name, size]; [README.md, 4kb]]","note":"2 rows left out"},156+ {"source":"$files | nope","error":"Command `nope` not found","detail":"help: check the spelling"},157+ {"source":"ls **/*","unsaved":true}158+ ]159+ }160+ ]161+}@@ -0,0 +1,20 @@
1+{2+ "version": 3,3+ "name": "Haushalt",4+ "widths": {"A": 16},5+ "names": {"Miete": "B2"},6+ "arithmetic": "decimal",7+ "freeze": {"cols":1},8+ "filter": {"range":"A1:B4","columns":{"A":{"condition":"not_empty"}}},9+ "cells": {10+ "A1": "Posten",11+ "B1": "Betrag",12+ "A2": "Miete",13+ "B2": {"input":"1450.10","format":"currency","decimals":2},14+ "A3": "Strom",15+ "B3": {"input":"0.1","format":"currency","decimals":2},16+ "A4": "Summe",17+ "B4": "=SUM(B2:B3)+0.2",18+ "C4": "=B4=1450.4"19+ }20+}@@ -0,0 +1,127 @@
1+{2+ "version": 5,3+ "names": {"Lost": "#REF!", "Rate": "Lists!B1", "Units": "Sales!C2:C9"},4+ "macroOrigin": "fixture-machine",5+ "macros": [6+ {"name": "Bold header", "key": "1", "api": 1, "source": "select(\"A1:E1\")\nrun(\"format.bold\")\n"},7+ {"name": "Fill totals", "api": 1, "source": "set(\"F2\", \"=SUM(C2:C9)\")\n"}8+ ],9+ "sheets": [10+ {11+ "name": "Sales",12+ "widths": {"A": 12, "E": 14},13+ "lines": {"A:XFD": {"italic":true}, "D:D": {"format":"currency","decimals":2}, "1:1": {"bold":true,"align":"center"}},14+ "freeze": {"rows":1,"cols":1},15+ "filter": {"range":"A1:E9","columns":{"B":{"hidden":["West"]},"C":{"condition":"gt","value":"2"}}},16+ "protected": [{"range":"E2:E9","description":"Totals"}],17+ "cells": {18+ "A1": "Date",19+ "B1": "Region",20+ "C1": "Units",21+ "D1": "Price",22+ "E1": "Total",23+ "G1": "Share",24+ "H1": "Regions",25+ "I1": "Scaled",26+ "A2": {"input":"2026-01-05","format":"date"},27+ "B2": "North",28+ "C2": "3",29+ "D2": "12.5",30+ "E2": {"input":"=C2*D2","format":"currency","decimals":2,"own":true},31+ "G2": {"input":"=C2/SUM(Units)","format":"percent","decimals":1},32+ "H2": "=SORT(UNIQUE(B2:B9))",33+ "I2": "=LET(r, Rate, MAP(C2:C4, LAMBDA(x, x*r)))",34+ "A3": {"input":"2026-01-12","format":"date"},35+ "B3": {"input":"South","note":"Includes returns"},36+ "C3": "5",37+ "D3": "9.75",38+ "E3": "=C3*D3",39+ "G3": {"input":"=C3/SUM(Units)","format":"custom","pattern":"0.00%;[Red]-0.00%"},40+ "A4": {"input":"2026-02-02","format":"date"},41+ "B4": "West",42+ "C4": "1",43+ "D4": "40",44+ "E4": "=C4*D4",45+ "A5": {"input":"2026-02-16","format":"date"},46+ "B5": "North",47+ "C5": "7",48+ "D5": "12.5",49+ "E5": "=C5*D5",50+ "A6": {"input":"2026-03-01","format":"date"},51+ "B6": "East",52+ "C6": {"input":"2","bold":true,"italic":true,"underline":true,"strikethrough":true},53+ "D6": "22",54+ "E6": "=C6*D6",55+ "A7": {"input":"2026-03-09","format":"date"},56+ "B7": "South",57+ "C7": {"input":"4","align":"left"},58+ "D7": "9.75",59+ "E7": "=C7*D7",60+ "A8": {"input":"2026-03-20","format":"date"},61+ "B8": "East",62+ "C8": "6",63+ "D8": "22",64+ "E8": "=C8*D8",65+ "A9": {"input":"2026-03-31","format":"date"},66+ "B9": "West",67+ "C9": "8",68+ "D9": "40",69+ "E9": "=C9*D9",70+ "A11": {"input":"A long title merged across three columns","align":"center"},71+ "A12": "Tall",72+ "B12": "clipped text that does not spill over",73+ "C12": "TRUE",74+ "D12": "=IFERROR(1/0, \"none\")",75+ "E12": {"input":"=Lists!B1*2","format":"number","decimals":3},76+ "F12": "'00123",77+ "F13": "=HYPERLINK(\"https://example.com\", \"site\")"78+ },79+ "charts": [80+ {"type":"column","data":"A1:C9","at":"K2","width":40,"height":12,"header":true,"labels":true,"title":"Units by date"},81+ {"type":"line","data":"C1:E9","at":"K16","width":36,"height":10,"header":true,"stack":"stacked","trend":true,"min":0,"max":400,"gridlines":false,"legend":"none"},82+ {"type":"pie","data":"B1:C5","at":"K28","width":30,"height":10,"header":true,"labels":true,"legend":"right"},83+ {"type":"scatter","data":"C1:D9","at":"K40","width":30,"height":10,"header":true,"trend":true,"log":true},84+ {"type":"bar","data":"B1:C9","at":"K52","width":30,"height":10,"header":true,"stack":"percent"},85+ {"type":"area","data":"C1:D9","at":"K64","width":30,"height":10,"byRow":true,"header":true}86+ ],87+ "conditionalFormats": [88+ {"ranges":"C2:C9","condition":"gt","values":["5"],"text":"red","bold":true},89+ {"ranges":"B2:B9","condition":"contains","values":["th"],"fill":"yellow","italic":true},90+ {"ranges":"E2:E9","condition":"formula","values":["=$C2\u003e4"],"text":"green","strikethrough":true},91+ {"ranges":"C2:C9","condition":"between","values":["2","4"],"fill":"cyan"},92+ {"ranges":"D2:D9","scale":[{"type":"min","color":"green"},{"type":"percentile","value":"50","color":"yellow"},{"type":"max","color":"red"}]}93+ ],94+ "validations": [95+ {"ranges":"B2:B9","criteria":"list","items":["North","South","East","West"],"help":"Pick a region"},96+ {"ranges":"C2:C9","criteria":"number","condition":"between","values":["0","80"],"reject":true},97+ {"ranges":"A2:A9","criteria":"date","condition":"gt","values":["2025-12-31"]},98+ {"ranges":"C12","criteria":"checkbox"},99+ {"ranges":"F2:F9","criteria":"range","source":"Lists!A1:A4"},100+ {"ranges":"G5:G9","criteria":"length","condition":"le","values":["10"]},101+ {"ranges":"H12","criteria":"formula","values":["=H12\u003c\u003e\"\""]}102+ ]103+ },104+ {105+ "name": "Lists",106+ "hidden": true,107+ "protected": [{"sheet":true}],108+ "cells": {109+ "A1": "North",110+ "B1": {"input":"1.5","note":"Rate used by Sales!I2"},111+ "A2": "South",112+ "A3": "East",113+ "A4": "West"114+ }115+ },116+ {117+ "name": "Pivot Table 1",118+ "cells": {},119+ "pivot": {"source":"Sales!A1:E9","rows":[{"column":"B"},{"column":"A","order":"desc","sortBy":1}],"columns":[{"column":"C"}],"values":[{"column":"E","summarize":"sum"},{"column":"C","summarize":"counta","showAs":"percent_of_total","name":"Share"}],"filters":[{"column":"B","hidden":["West"]}],"rowTotals":true,"columnTotals":false}120+ },121+ {122+ "name": "Notebook 1",123+ "widths": {"A": 20},124+ "cells": {}125+ }126+ ]127+}@@ -0,0 +1,21 @@
1+{2+ "version": 3,3+ "name": "Haushalt",4+ "widths": {"A": 16},5+ "names": {"Miete": "B2"},6+ "arithmetic": "decimal",7+ "locale": "de-DE",8+ "freeze": {"cols":1},9+ "filter": {"range":"A1:B4","columns":{"A":{"condition":"not_empty"}}},10+ "cells": {11+ "A1": "Posten",12+ "B1": "Betrag",13+ "A2": "Miete",14+ "B2": {"input":"1450.10","format":"currency","decimals":2},15+ "A3": "Strom",16+ "B3": {"input":"0.1","format":"currency","decimals":2},17+ "A4": "Summe",18+ "B4": "=SUM(B2:B3)+0.2",19+ "C4": "=B4=1450.4"20+ }21+}@@ -0,0 +1,159 @@
1+{2+ "version": 5,3+ "names": {"Lost": "#REF!", "Rate": "Lists!B1", "Units": "Sales!C2:C9"},4+ "macroOrigin": "fixture-machine",5+ "macros": [6+ {"name": "Bold header", "key": "1", "api": 1, "source": "select(\"A1:E1\")\nrun(\"format.bold\")\n"},7+ {"name": "Fill totals", "api": 1, "source": "set(\"F2\", \"=SUM(C2:C9)\")\n"}8+ ],9+ "sheets": [10+ {11+ "name": "Sales",12+ "widths": {"A": 12, "E": 14},13+ "heights": {"1": 2, "12": 3},14+ "lines": {"A:XFD": {"italic":true}, "D:D": {"format":"currency","decimals":2}, "1:1": {"bold":true,"align":"center","borders":{"bottom":"double"}}},15+ "freeze": {"rows":1,"cols":1},16+ "filter": {"range":"A1:E9","columns":{"B":{"hidden":["West"]},"C":{"condition":"gt","value":"2"}}},17+ "protected": [{"range":"E2:E9","description":"Totals"}],18+ "merges": ["A11:C11","A12:A13"],19+ "cells": {20+ "A1": "Date",21+ "B1": "Region",22+ "C1": "Units",23+ "D1": "Price",24+ "E1": "Total",25+ "G1": "Share",26+ "H1": "Regions",27+ "I1": "Scaled",28+ "J1": {"input":"007","text":true},29+ "A2": {"input":"2026-01-05","format":"date"},30+ "B2": "North",31+ "C2": "3",32+ "D2": "12.5",33+ "E2": {"input":"=C2*D2","format":"currency","decimals":2,"own":true},34+ "G2": {"input":"=C2/SUM(Units)","format":"percent","decimals":1},35+ "H2": "=SORT(UNIQUE(B2:B9))",36+ "I2": "=LET(r, Rate, MAP(C2:C4, LAMBDA(x, x*r)))",37+ "J2": {"input":"=1+1","text":false,"format":"text"},38+ "A3": {"input":"2026-01-12","format":"date"},39+ "B3": {"input":"South","note":"Includes returns"},40+ "C3": "5",41+ "D3": "9.75",42+ "E3": "=C3*D3",43+ "G3": {"input":"=C3/SUM(Units)","format":"custom","pattern":"0.00%;[Red]-0.00%"},44+ "A4": {"input":"2026-02-02","format":"date"},45+ "B4": "West",46+ "C4": "1",47+ "D4": "40",48+ "E4": "=C4*D4",49+ "A5": {"input":"2026-02-16","format":"date"},50+ "B5": "North",51+ "C5": "7",52+ "D5": "12.5",53+ "E5": "=C5*D5",54+ "A6": {"input":"2026-03-01","format":"date"},55+ "B6": "East",56+ "C6": {"input":"2","bold":true,"italic":true,"underline":true,"strikethrough":true},57+ "D6": "22",58+ "E6": "=C6*D6",59+ "A7": {"input":"2026-03-09","format":"date"},60+ "B7": "South",61+ "C7": {"input":"4","align":"left","valign":"top"},62+ "D7": "9.75",63+ "E7": "=C7*D7",64+ "A8": {"input":"2026-03-20","format":"date"},65+ "B8": "East",66+ "C8": {"input":"6","borders":{"top":"thin","bottom":"double","left":"thick","right":"thin","bottomColor":"red","leftColor":"blue"}},67+ "D8": "22",68+ "E8": "=C8*D8",69+ "A9": {"input":"2026-03-31","format":"date"},70+ "B9": "West",71+ "C9": "8",72+ "D9": "40",73+ "E9": "=C9*D9",74+ "A11": {"input":"A long title merged across three columns","align":"center","wrap":"wrap"},75+ "A12": {"input":"Tall","valign":"middle"},76+ "B12": {"input":"clipped text that does not spill over","wrap":"clip"},77+ "C12": "TRUE",78+ "D12": "=IFERROR(1/0, \"none\")",79+ "E12": {"input":"=Lists!B1*2","format":"number","decimals":3},80+ "F12": "'00123",81+ "F13": "=HYPERLINK(\"https://example.com\", \"site\")"82+ },83+ "charts": [84+ {"type":"column","data":"A1:C9","at":"K2","width":40,"height":12,"header":true,"labels":true,"title":"Units by date"},85+ {"type":"line","data":"C1:E9","at":"K16","width":36,"height":10,"header":true,"stack":"stacked","trend":true,"min":0,"max":400,"gridlines":false,"legend":"none"},86+ {"type":"pie","data":"B1:C5","at":"K28","width":30,"height":10,"header":true,"labels":true,"legend":"right"},87+ {"type":"scatter","data":"C1:D9","at":"K40","width":30,"height":10,"header":true,"trend":true,"log":true},88+ {"type":"bar","data":"B1:C9","at":"K52","width":30,"height":10,"header":true,"stack":"percent"},89+ {"type":"area","data":"C1:D9","at":"K64","width":30,"height":10,"byRow":true,"header":true}90+ ],91+ "conditionalFormats": [92+ {"ranges":"C2:C9","condition":"gt","values":["5"],"text":"red","bold":true},93+ {"ranges":"B2:B9","condition":"contains","values":["th"],"fill":"yellow","italic":true},94+ {"ranges":"A2:A9","condition":"date_is","values":["this week"],"underline":true},95+ {"ranges":"E2:E9","condition":"formula","values":["=$C2\u003e4"],"text":"green","strikethrough":true},96+ {"ranges":"C2:C9","condition":"between","values":["2","4"],"fill":"cyan"},97+ {"ranges":"C2:C9","condition":"top","values":["3"],"fill":"magenta"},98+ {"ranges":"D2:D9","condition":"duplicate","text":"blue"},99+ {"ranges":"C2:C9","condition":"above_average","bold":true},100+ {"ranges":"D2:D9","scale":[{"type":"min","color":"green"},{"type":"percentile","value":"50","color":"yellow"},{"type":"max","color":"red"}]},101+ {"ranges":"E2:E9","dataBar":{"color":"blue","min":{"type":"min"},"max":{"type":"num","value":"400"},"barOnly":true}},102+ {"ranges":"C2:C9,D2:D9","iconSet":{"icons":"arrows","points":[{"type":"percent","value":"33"},{"type":"percent","value":"67"}],"reverse":true}}103+ ],104+ "validations": [105+ {"ranges":"B2:B9","criteria":"list","items":["North","South","East","West"],"help":"Pick a region","display":"chip"},106+ {"ranges":"C2:C9","criteria":"number","condition":"between","values":["0","80"],"reject":true},107+ {"ranges":"A2:A9","criteria":"date","condition":"gt","values":["2025-12-31"]},108+ {"ranges":"C12","criteria":"checkbox","items":["TRUE","FALSE"]},109+ {"ranges":"F2:F9","criteria":"range","source":"Lists!A1:A4","display":"plain"},110+ {"ranges":"G5:G9","criteria":"length","condition":"le","values":["10"]},111+ {"ranges":"H12","criteria":"formula","values":["=H12\u003c\u003e\"\""]}112+ ]113+ },114+ {115+ "name": "Lists",116+ "hidden": true,117+ "protected": [{"sheet":true}],118+ "cells": {119+ "A1": "North",120+ "B1": {"input":"1.5","note":"Rate used by Sales!I2"},121+ "A2": "South",122+ "A3": "East",123+ "A4": "West"124+ }125+ },126+ {127+ "name": "Pivot Table 1",128+ "cells": {},129+ "pivot": {"source":"Sales!A1:E9","rows":[{"column":"B"},{"column":"A","order":"desc","sortBy":1}],"columns":[{"column":"C"}],"values":[{"column":"E","summarize":"sum"},{"column":"C","summarize":"counta","showAs":"percent_of_total","name":"Share"}],"filters":[{"column":"B","hidden":["West"]}],"rowTotals":true,"columnTotals":false}130+ },131+ {132+ "name": "Data",133+ "widths": {"A": 20},134+ "cells": {135+ "A20": "=SUM(nu.files)"136+ },137+ "regions": [138+ {"name":"files","at":"A1","output":true},139+ {"name":"big","at":"A8","output":true},140+ {"name":"app","at":"F2","path":"logs/app.csv","window":500},141+ {"name":"db","at":"F20","path":"data.sqlite","format":"SQLite","table":"orders"},142+ {"name":"q","at":"M20","path":"data.sqlite","format":"SQLite","query":"select * from orders limit 5"}143+ ]144+ },145+ {146+ "name": "Notebook",147+ "cells": {},148+ "tab": "notebook",149+ "reactive": true,150+ "notebookCells": [151+ {"kind":"note","source":"# Files\nWhat the folder holds."},152+ {"source":"files = ls","output":"[[name, size]; [go.mod, 812b], [README.md, 4kb]]"},153+ {"source":"big = $files | where size \u003e 1kb","output":"[[name, size]; [README.md, 4kb]]","note":"2 rows left out"},154+ {"source":"$files | nope","error":"Command `nope` not found","detail":"help: check the spelling"},155+ {"source":"ls **/*","unsaved":true}156+ ]157+ }158+ ]159+}@@ -1,8 +1,8 @@
11 package sheet22 33 import (4- "cmp"54 "slices"5+ "strings"66 77 "github.com/FelineStateMachine/012/internal/formula"88 )@@ -10,7 +10,10 @@ import (
1010 // Tracing, as Excel's Trace Precedents and Trace Dependents: which cells1111 // a formula reads, and which formulas read a cell, on any sheet. Only1212 // direct links are followed; tracing again from a found cell goes a level13-// further.13+// further. The dependency indexes recalculation keeps answer both ways,14+// so tracing costs what it finds, not the sheet: a cell's precedents are15+// its formula's references, and its dependents come from the indexes by16+// cell, by range and by name (tracedeps.go).1417 1518 // Target is a traced cell or range and the sheet it is on.1619 type Target struct {@@ -18,61 +21,134 @@ type Target struct {
1821 Range Rect1922 }2023 24+// LinkKind is how a traced cell is linked to the one traced.25+type LinkKind uint826+27+const (28+ // LinkRef is a reference or range the formula writes out, or a29+ // formula reading the cell through one.30+ LinkRef LinkKind = iota31+ // LinkName is a named range the formula uses: Link.Name is its name.32+ LinkName33+ // LinkRegion is a region's table the formula names, nu.sales:34+ // Link.Name is how the formula names it.35+ LinkRegion36+ // LinkSpill is the array formula whose values the cell shows, among37+ // precedents, or the cells a formula spills into, among dependents.38+ LinkSpill39+ // LinkFile is the linked file a region's cells come from: Link.Name40+ // is its path, and Target the region's cells.41+ LinkFile42+ // LinkOutput is the notebook cell whose output a region shows:43+ // Link.Name is the cell's name, Target.Sheet the notebook tab and44+ // Target.Range.From.Row the cell's index there.45+ LinkOutput46+)47+48+// Link is a precedent or dependent: where it is, and how it's linked.49+type Link struct {50+ Target51+ Kind LinkKind52+ Name string // see LinkKind53+}54+55+// OnGrid reports whether the link is cells of a sheet's grid rather than56+// a notebook cell.57+func (l Link) OnGrid() bool { return !l.Sheet.IsNotebook() }58+2159 // Precedents returns the cells and ranges the formula at a reads, in the22-// order the formula mentions them, with named ranges resolved and23-// repeats dropped. References to sheets that don't exist are left out. It24-// is empty for anything but a formula.25-func (s *Sheet) Precedents(a Addr) []Target {26- c := s.cells.get(a)27- if c == nil || !c.IsFormula() {28- return nil29- }60+// order the formula mentions them; see PrecedentLinks.61+func (s *Sheet) Precedents(a Addr) []Target { return targetsOf(s.PrecedentLinks(a)) }62+63+// Dependents returns the formula cells that read a directly; see64+// DependentLinks.65+func (s *Sheet) Dependents(a Addr) []Target {66+ links, _ := s.DependentLinks(a, 0)67+ return targetsOf(links)68+}69+70+func targetsOf(links []Link) []Target {3071 var out []Target31- add := func(sheet string, r Rect) {32- t := Target{s.wb.resolve(s, sheet), r}33- if t.Sheet != nil && !slices.Contains(out, t) {34- out = append(out, t)72+ for _, l := range links {73+ if l.OnGrid() {74+ out = append(out, l.Target)3575 }3676 }37- formula.WalkRefs(s.bound(c), func(sheet string, a Addr) { add(sheet, Rect{From: a, To: a}) }, add)3877 return out3978 }4079 41-// Dependents returns the formula cells that read a directly, through a42-// reference, a range or a named range: those on this sheet first in43-// row-major order, then those on other sheets in tab order.44-func (s *Sheet) Dependents(a Addr) []Target {45- w := s.wb46- seen := map[loc]bool{}47- for d := range s.dependents[a] {48- seen[loc{s, d}] = true80+// PrecedentLinks returns what the cell at a comes from. For a formula,81+// the cells and ranges it reads in the order it mentions them, named82+// ranges and regions as their cells, with repeats dropped and references83+// to sheets that don't exist left out. For a cell an array spilled into,84+// the formula that spilled it; for a region's cell, the linked file or85+// notebook cell the region shows.86+func (s *Sheet) PrecedentLinks(a Addr) []Link {87+ var out []Link88+ add := func(l Link) {89+ if l.Sheet != nil && !slices.ContainsFunc(out, func(o Link) bool { return o.Target == l.Target && o.Kind == l.Kind }) {90+ out = append(out, l)91+ }92+ }93+ if c, _, _ := s.cells.peek(a); c != nil && c.IsFormula() {94+ s.walkPrecedents(c.expr, add)4995 }50- s.rangeUsers.readers(a, func(u Addr) { seen[loc{s, u}] = true })51- for k, users := range w.nameUsers {52- if n, ok := w.names[k]; ok && !n.Lost && n.Sheet == s && n.Range.Contains(a) {53- for u := range users {54- seen[u] = true96+ if anchor, ok := s.SpillAnchor(a); ok {97+ add(Link{Target: Target{s, Rect{From: anchor, To: anchor}}, Kind: LinkSpill})98+ }99+ if r, ok := s.RegionAt(a); ok {100+ add(s.regionSource(r))101+ }102+ return out103+}104+105+// walkPrecedents calls add with each reference, range and name in n, in106+// the order they're written.107+func (s *Sheet) walkPrecedents(n Node, add func(Link)) {108+ w := s.wb109+ switch n := n.(type) {110+ case formula.Ref:111+ add(Link{Target: Target{w.resolve(s, n.Sheet), Rect{From: n.Addr, To: n.Addr}}})112+ case formula.Range:113+ add(Link{Target: Target{w.resolve(s, n.Sheet), n.Rect}})114+ case formula.Name:115+ if nm, ok := w.names[nameKey(n.Name)]; ok {116+ if !nm.Gone() {117+ add(Link{Target: Target{nm.Sheet, nm.Range}, Kind: LinkName, Name: nm.Name})55118 }119+ return56120 }57- }58- for u := range w.crossUsers {59- if w.crossReads(u, loc{s, a}) {60- seen[u] = true121+ if t, r, ok := w.regionName(nameKey(n.Name)); ok && r != (Rect{}) {122+ add(Link{Target: Target{t, r}, Kind: LinkRegion, Name: s.regionSpelling(n.Name)})61123 }124+ default:125+ formula.EachChild(n, func(k Node) { s.walkPrecedents(k, add) })62126 }63- out := make([]Target, 0, len(seen))64- for l := range seen {65- out = append(out, Target{l.s, Rect{From: l.a, To: l.a}})127+}128+129+// regionSpelling is how formulas name the region a name like NU.SALES130+// finds: nu. and the region's own name.131+func (s *Sheet) regionSpelling(name string) string {132+ if _, r, ok := s.wb.Region(name[len(regionPrefix):]); ok {133+ return r.FormulaName()66134 }67- rank := func(t *Sheet) int {68- if t == s {69- return -1135+ return strings.ToLower(name)136+}137+138+// regionSource is where a region's cells come from: its linked file, or139+// the notebook cell whose output it shows (on the notebook's tab, when140+// there is one; otherwise the region itself).141+func (s *Sheet) regionSource(r Region) Link {142+ area := Target{s, s.covered(r)}143+ if r.Linked() {144+ return Link{Target: area, Kind: LinkFile, Name: r.File.Path}145+ }146+ for _, nb := range s.wb.sheets {147+ for i, c := range nb.regions.cells {148+ if strings.EqualFold(c.Name(), r.Name) {149+ return Link{Target: Target{nb, Rect{From: Addr{Row: i}, To: Addr{Row: i}}}, Kind: LinkOutput, Name: c.Name()}150+ }70151 }71- return w.Index(t)72152 }73- slices.SortFunc(out, func(x, y Target) int {74- return cmp.Or(cmp.Compare(rank(x.Sheet), rank(y.Sheet)),75- cmp.Compare(x.Range.From.Row, y.Range.From.Row), cmp.Compare(x.Range.From.Col, y.Range.From.Col))76- })77- return out153+ return Link{Target: area, Kind: LinkOutput, Name: r.Name}78154 }@@ -0,0 +1,101 @@
1+package sheet2+3+import (4+ "strings"5+ "testing"6+)7+8+// links writes links as they'd be listed: the range, with its sheet when9+// not s, and the kind's name where it isn't a plain reference.10+func links(s *Sheet, ls []Link) string {11+ var out []string12+ for _, l := range ls {13+ ref := l.Range.String()14+ if l.Sheet != s {15+ ref = Qualified(l.Sheet.Name(), l.Range)16+ }17+ switch l.Kind {18+ case LinkName, LinkRegion, LinkFile, LinkOutput:19+ ref = l.Name + "=" + ref20+ case LinkSpill:21+ ref = "spill " + ref22+ }23+ out = append(out, ref)24+ }25+ return strings.Join(out, " ")26+}27+28+func TestPrecedentLinks(t *testing.T) {29+ s := sheetOf(t, map[string]string{30+ "A1": "1", "A2": "2", "B1": "=SEQUENCE(3)", "C1": "=Rate*A1+SUM(B1:B3)", "C2": "=missing!A1+A1",31+ })32+ s.DefineName("Rate", rect("A2"))33+ if got, want := links(s, s.PrecedentLinks(at("C1"))), "Rate=A2 A1 B1:B3"; got != want {34+ t.Errorf("C1 = %q, want %q", got, want)35+ }36+ if got, want := links(s, s.PrecedentLinks(at("C2"))), "A1"; got != want {37+ t.Errorf("an unknown sheet: %q, want %q", got, want)38+ }39+ // A spilled cell comes from its anchor.40+ if got, want := links(s, s.PrecedentLinks(at("B3"))), "spill B1"; got != want {41+ t.Errorf("B3 = %q, want %q", got, want)42+ }43+ if got := s.PrecedentLinks(at("A1")); got != nil {44+ t.Errorf("a number: %v", got)45+ }46+}47+48+func TestDependentLinks(t *testing.T) {49+ s := sheetOf(t, map[string]string{50+ "A1": "=SEQUENCE(3)", "C1": "=A2*2", "C2": "=SUM(A1:A9)", "C3": "=A1", "D5": "=B1",51+ })52+ other, _ := s.Book().AddSheet("Other", 1)53+ other.Set(at("A1"), "=Sheet1!A3")54+ s.DefineName("Mid", rect("A2"))55+ other.Set(at("B1"), "=Mid")56+ // The anchor's dependents read any cell it spills into.57+ got, more := s.DependentLinks(at("A1"), 0)58+ if want := "spill A1:A3 C1 C2 C3 Other!A1 Other!B1"; links(s, got) != want || more {59+ t.Errorf("A1 = %q (more %v), want %q", links(s, got), more, want)60+ }61+ if got, _ := s.DependentLinks(at("A2"), 0); links(s, got) != "C1 C2 Other!B1" {62+ t.Errorf("A2 = %q", links(s, got))63+ }64+ // A cap finds that many and says there are more.65+ got, more = s.DependentLinks(at("A1"), 2)66+ if len(got) != 3 || !more {67+ t.Errorf("capped: %q, more %v", links(s, got), more)68+ }69+ if !s.Reads(at("C2"), s, rect("A3")) || !other.Reads(at("B1"), s, rect("A1:A2")) || s.Reads(at("D5"), s, rect("A1:A3")) {70+ t.Error("Reads")71+ }72+ if s.Reads(at("A2"), s, rect("A1")) {73+ t.Error("a spilled cell reads its anchor")74+ }75+}76+77+func TestTraceRegions(t *testing.T) {78+ s := New()79+ nb := sent(t, s, "files", "B2")80+ s.Set(at("A1"), "=ROWS(nu.files)")81+ apply(t, s, LiveOp{Region: "files", Reset: true, Header: liveRow("n"), Rows: []LiveRow{liveRow("a"), liveRow("b")}})82+ if got, want := links(s, s.PrecedentLinks(at("A1"))), "nu.files=B2:B4"; got != want {83+ t.Errorf("A1 = %q, want %q", got, want)84+ }85+ // The region's cells come from the notebook cell.86+ if got, want := links(s, s.PrecedentLinks(at("B3"))), "files="+Qualified(nb.Name(), rect("A1")); got != want {87+ t.Errorf("B3 = %q, want %q", got, want)88+ }89+ if got, _ := s.DependentLinks(at("B4"), 0); links(s, got) != "A1" {90+ t.Errorf("B4's dependents = %q", links(s, got))91+ }92+ if !s.Reads(at("A1"), s, rect("B3")) {93+ t.Error("Reads through a region")94+ }95+ if _, err := s.AddLinked(at("F1"), LinkSource{Path: "log.csv"}); err != nil {96+ t.Fatal(err)97+ }98+ if got, want := links(s, s.PrecedentLinks(at("F1"))), "log.csv=F1"; got != want {99+ t.Errorf("F1 = %q, want %q", got, want)100+ }101+}@@ -0,0 +1,174 @@
1+package sheet2+3+import (4+ "cmp"5+ "slices"6+)7+8+// Dependents, for tracing (trace.go): the formulas reading a cell, found9+// through the indexes recalculation keeps, and Reads, which asks the10+// same of one formula, so what draws the sheet can mark the dependents it11+// shows without listing them all.12+13+// DependentLinks returns the formulas that read the cell at a directly:14+// through a reference, a range, a named range or a region's name. When15+// the formula at a spills, the cells it spills into come first, and the16+// formulas reading any of them count too. Formulas on this sheet come in17+// row-major order, then those on other sheets in tab order. With max > 018+// at most max formulas are found, and more reports that there were19+// others: a cell read by a million formulas costs what max does.20+func (s *Sheet) DependentLinks(a Addr, max int) (links []Link, more bool) {21+ subject := Rect{From: a, To: a}22+ if area, ok := s.SpillArea(a); ok && area != subject {23+ subject = area24+ links = append(links, Link{Target: Target{s, area}, Kind: LinkSpill})25+ }26+ f := &depFinder{max: max, seen: map[loc]struct{}{}}27+ s.readersOf(subject, f)28+ found := make([]Link, 0, len(f.seen))29+ for l := range f.seen {30+ found = append(found, Link{Target: Target{l.s, Rect{From: l.a, To: l.a}}})31+ }32+ w := s.wb33+ rank := func(t *Sheet) int {34+ if t == s {35+ return -136+ }37+ return w.Index(t)38+ }39+ slices.SortFunc(found, func(x, y Link) int {40+ return cmp.Or(cmp.Compare(rank(x.Sheet), rank(y.Sheet)),41+ cmp.Compare(x.Range.From.Row, y.Range.From.Row), cmp.Compare(x.Range.From.Col, y.Range.From.Col))42+ })43+ return append(links, found...), f.more44+}45+46+// depFinder collects dependents, up to max when it's positive.47+type depFinder struct {48+ max int49+ seen map[loc]struct{}50+ more bool51+}52+53+func (f *depFinder) add(l loc) {54+ if _, ok := f.seen[l]; ok || f.more {55+ return56+ }57+ if f.max > 0 && len(f.seen) >= f.max {58+ f.more = true59+ return60+ }61+ f.seen[l] = struct{}{}62+}63+64+// readersOf adds the formulas that read any cell of r, on s.65+func (s *Sheet) readersOf(r Rect, f *depFinder) {66+ s.refReaders(r, f)67+ s.rangeUsers.overlapping(r, func(u Addr) { f.add(loc{s, u}) })68+ w := s.wb69+ for k, users := range w.nameUsers {70+ if f.more || !w.namesOverlap(k, s, r) {71+ continue72+ }73+ for u := range users {74+ if f.add(u); f.more {75+ break76+ }77+ }78+ }79+ for u := range w.crossUsers {80+ if f.more {81+ return82+ }83+ if c := u.s.cells.get(u.a); c != nil && w.xrefsOverlap(c, s, r) {84+ f.add(u)85+ }86+ }87+}88+89+// refReaders adds the formulas on s with a single-cell reference into90+// r, walking whichever is smaller: r's cells or the cells referenced.91+func (s *Sheet) refReaders(r Rect, f *depFinder) {92+ add := func(users map[Addr]struct{}) {93+ for u := range users {94+ if f.add(loc{s, u}); f.more {95+ return96+ }97+ }98+ }99+ if n := (r.To.Row - r.From.Row + 1) * (r.To.Col - r.From.Col + 1); n <= len(s.dependents) {100+ for row := r.From.Row; row <= r.To.Row && !f.more; row++ {101+ for col := r.From.Col; col <= r.To.Col; col++ {102+ add(s.dependents[Addr{Col: col, Row: row}])103+ }104+ }105+ return106+ }107+ for a, users := range s.dependents {108+ if f.more {109+ return110+ }111+ if r.Contains(a) {112+ add(users)113+ }114+ }115+}116+117+// namesOverlap reports whether the name with key k, a named range or a118+// region's (nu.sales), stands for cells of r on s.119+func (w *Workbook) namesOverlap(k string, s *Sheet, r Rect) bool {120+ if nm, ok := w.names[k]; ok {121+ _, over := intersectRect(nm.Range, r)122+ return !nm.Gone() && nm.Sheet == s && over123+ }124+ t, table, ok := w.regionName(k)125+ if !ok || t != s || table == (Rect{}) {126+ return false127+ }128+ _, over := intersectRect(table, r)129+ return over130+}131+132+// xrefsOverlap reports whether c reads cells of r on s through a133+// reference that names s.134+func (w *Workbook) xrefsOverlap(c *Cell, s *Sheet, r Rect) bool {135+ for _, x := range c.xrefs {136+ if _, over := intersectRect(x.r, r); over && w.byKey[x.key] == s {137+ return true138+ }139+ }140+ return false141+}142+143+// Reads reports whether the formula at u, on s, reads any cell of r on144+// t directly: through a reference, a range, a named range or a region's145+// name. It costs the formula's references, so asking it of every cell146+// on screen is cheap.147+func (s *Sheet) Reads(u Addr, t *Sheet, r Rect) bool {148+ c, _, _ := s.cells.peek(u)149+ if c == nil || !c.IsFormula() {150+ return false151+ }152+ w := s.wb153+ if t == s {154+ for _, a := range c.refs {155+ if r.Contains(a) {156+ return true157+ }158+ }159+ for _, g := range c.ranges {160+ if _, over := intersectRect(g, r); over {161+ return true162+ }163+ }164+ }165+ if w.xrefsOverlap(c, t, r) {166+ return true167+ }168+ for _, k := range c.names {169+ if w.namesOverlap(k, t, r) {170+ return true171+ }172+ }173+ return false174+}@@ -104,28 +104,38 @@ func (s *Sheet) shiftView(rows bool, sp formula.Span) {
104104 }105105 *frozen = min(*frozen, MaxFrozen)106106 }107- if f := v.filter; f != nil {108- _, rng := formula.AxisMaps(rows, sp)109- if r, ok := rng(f.Range); ok {110- nf := &Filter{Range: r, Cols: map[int]Criteria{}}111- for c, cr := range f.Cols {112- if !rows {113- var keep bool114- if c, keep = sp.Point(c); !keep || c < r.From.Col || c > r.To.Col {115- continue116- }117- }118- nf.Cols[c] = cr119- }120- v.filter = nf121- } else {122- v.filter = nil123- }107+ if v.filter != nil {108+ v.filter = shiftFilter(v.filter, rows, sp)124109 }125110 if !v.equal(s.view) {126111 s.recordView()112+ merged := !slices.Equal(v.merges, s.view.merges)127113 s.view = v114+ if merged { // a merge gone may free an array to spill115+ s.respill(Rect{To: Addr{Col: MaxCols - 1, Row: MaxRows - 1}})116+ }117+ }118+}119+120+// shiftFilter is f with rows or columns inserted or deleted, nil once121+// its range is all deleted.122+func shiftFilter(f *Filter, rows bool, sp formula.Span) *Filter {123+ _, rng := formula.AxisMaps(rows, sp)124+ r, ok := rng(f.Range)125+ if !ok {126+ return nil127+ }128+ nf := &Filter{Range: r, Cols: map[int]Criteria{}}129+ for c, cr := range f.Cols {130+ if !rows {131+ var keep bool132+ if c, keep = sp.Point(c); !keep || c < r.From.Col || c > r.To.Col {133+ continue134+ }135+ }136+ nf.Cols[c] = cr128137 }138+ return nf129139 }130140 131141 // fileView is the view state in the file (version 3), e.g.@@ -0,0 +1,246 @@
1+package ui2+3+import (4+ "errors"5+ "fmt"6+ "os"7+ "path/filepath"8+ "runtime"9+ "runtime/debug"10+ "strings"11+ "time"12+13+ tea "charm.land/bubbletea/v2"14+)15+16+// Crashes: a panic anywhere in the model (Update, View, Init, or a17+// command it started) stops the program without taking the terminal18+// down with it. Guard wraps the model for Bubble Tea: it recovers the19+// panic, remembers where it was and what with, and quits, so Bubble Tea20+// restores the terminal as on any quit. View can't return a command to21+// quit with, so a panic there goes on to Bubble Tea, which restores the22+// terminal itself and prints the stack. The caller then keeps the23+// unsaved work for recovery (Keep, recovery.go) and writes a report24+// (Crash.Report). See docs/files/saving.md.25+26+// Crash is a panic Guard caught.27+type Crash struct {28+ Where string // "update", "view", "init" or "a command"29+ Value any // what was panicked with30+ Stack []byte // the panicking goroutine's stack; nil when Bubble Tea caught it31+}32+33+// Guarded is a model run under Guard.34+type Guarded struct {35+ m *Model36+ crash *Crash37+ last tea.View // the last frame drawn, shown until the program quits38+ // viewPanics makes View panic, for crashTest.39+ viewPanics bool40+}41+42+// Guard wraps m so a panic in it stops the program without losing the43+// terminal; see Finish for what's left afterwards.44+func Guard(m *Model) *Guarded {45+ return &Guarded{m: m}46+}47+48+// Model is the model guarded.49+func (g *Guarded) Model() *Model { return g.m }50+51+// crashMsg is a panic caught in a command, brought to Update.52+type crashMsg struct{ crash *Crash }53+54+// caught makes a Crash of a recovered panic.55+func caught(where string, r any) *Crash {56+ return &Crash{Where: where, Value: r, Stack: debug.Stack()}57+}58+59+// Init implements tea.Model.60+func (g *Guarded) Init() (cmd tea.Cmd) {61+ defer func() {62+ if r := recover(); r != nil {63+ g.crash = caught("init", r)64+ cmd = tea.Quit65+ }66+ }()67+ return g.guard(g.m.Init())68+}69+70+// Update implements tea.Model.71+func (g *Guarded) Update(msg tea.Msg) (_ tea.Model, cmd tea.Cmd) {72+ if c, ok := msg.(crashMsg); ok {73+ if g.crash == nil {74+ g.crash = c.crash75+ }76+ return g, tea.Quit77+ }78+ if g.crash != nil {79+ return g, nil // quitting; the model may be broken80+ }81+ defer func() {82+ if r := recover(); r != nil {83+ g.crash = caught("update", r)84+ cmd = tea.Quit85+ }86+ }()87+ if crashTest != nil {88+ if c := g.test(crashTest(msg)); c != nil {89+ return g, c90+ }91+ }92+ next, cmd := g.m.Update(msg)93+ if m, ok := next.(*Model); ok {94+ g.m = m95+ }96+ return g, g.guard(cmd)97+}98+99+// View implements tea.Model. It keeps showing the last frame while the100+// program quits after a crash.101+func (g *Guarded) View() tea.View {102+ if g.crash != nil {103+ return g.last104+ }105+ defer func() {106+ if r := recover(); r != nil {107+ g.crash = caught("view", r)108+ panic(r) // for Bubble Tea to stop the program: see above109+ }110+ }()111+ if g.viewPanics {112+ panic("crash test in view")113+ }114+ g.last = g.m.View()115+ return g.last116+}117+118+// guard wraps cmd so a panic in it comes to Update as a crashMsg, and119+// so do the commands of a batch it returns. A sequence's (tea.Sequence)120+// are run by Bubble Tea itself, which catches their panics: see Finish.121+func (g *Guarded) guard(cmd tea.Cmd) tea.Cmd {122+ if cmd == nil {123+ return nil124+ }125+ return func() (msg tea.Msg) {126+ defer func() {127+ if r := recover(); r != nil {128+ msg = crashMsg{caught("a command", r)}129+ }130+ }()131+ msg = cmd()132+ if batch, ok := msg.(tea.BatchMsg); ok {133+ out := make(tea.BatchMsg, len(batch))134+ for i, c := range batch {135+ out[i] = g.guard(c)136+ }137+ return out138+ }139+ return msg140+ }141+}142+143+// Finish is called once the program has stopped, with what Run144+// returned. It reports the crash that stopped it, if one did: one Guard145+// caught, or one only Bubble Tea caught (a panic in a sequence's146+// command), whose stack it printed on the terminal.147+func (g *Guarded) Finish(runErr error) *Crash {148+ if g.crash == nil && errors.Is(runErr, tea.ErrProgramPanic) {149+ g.crash = &Crash{Where: "a command", Value: "a panic Bubble Tea caught, its stack printed on the terminal"}150+ }151+ return g.crash152+}153+154+// Keep writes the model's unsaved work to a recovery file, returning its155+// name ("" when there was nothing unsaved). A model a panic left too156+// broken to write is reported as an error rather than panicking again.157+func (g *Guarded) Keep(now time.Time) (kept string, err error) {158+ defer func() {159+ if r := recover(); r != nil {160+ kept, err = "", fmt.Errorf("writing the workbook failed too: %v", r)161+ }162+ }()163+ if !g.m.Unsaved() {164+ return "", nil165+ }166+ return g.m.Recover(now)167+}168+169+// crashReportsKept is how many reports Report leaves in its directory;170+// older ones are removed.171+const crashReportsKept = 10172+173+// Report writes a short report of the crash into dir, for the user to174+// send with an issue, and returns its path. It says where the panic was,175+// what with, the stack, the build (version), the system, the file open176+// and where its unsaved work was kept; never the workbook's contents.177+func (c *Crash) Report(dir, version, file, kept string, keepErr error, now time.Time) (string, error) {178+ if err := os.MkdirAll(dir, 0o700); err != nil {179+ return "", err180+ }181+ var b strings.Builder182+ fmt.Fprintf(&b, "012 stopped on an internal error (a panic in %s)\n\n", c.Where)183+ fmt.Fprintf(&b, "Time: %s\n", now.Format(time.RFC3339))184+ fmt.Fprintf(&b, "Version: %s\n", version)185+ fmt.Fprintf(&b, "System: %s/%s, %s\n", runtime.GOOS, runtime.GOARCH, runtime.Version())186+ fmt.Fprintf(&b, "File: %s\n", orNone(file, "(untitled)"))187+ switch {188+ case keepErr != nil:189+ fmt.Fprintf(&b, "Kept: couldn't keep the unsaved changes: %v\n", keepErr)190+ default:191+ fmt.Fprintf(&b, "Kept: %s\n", orNone(kept, "nothing unsaved"))192+ }193+ fmt.Fprintf(&b, "\nPanic: %v\n", c.Value)194+ if len(c.Stack) > 0 {195+ fmt.Fprintf(&b, "\n%s", c.Stack)196+ }197+ path := filepath.Join(dir, "crash-"+now.Format(recoveryStamp)+".txt")198+ f, err := os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0o600)199+ for i := 2; errors.Is(err, os.ErrExist) && i < 100; i++ {200+ path = filepath.Join(dir, fmt.Sprintf("crash-%s-%d.txt", now.Format(recoveryStamp), i))201+ f, err = os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0o600)202+ }203+ if err != nil {204+ return "", err205+ }206+ _, err = f.WriteString(b.String())207+ if cerr := f.Close(); err == nil {208+ err = cerr209+ }210+ pruneReports(dir)211+ return path, err212+}213+214+// pruneReports removes the oldest crash reports in dir beyond215+// crashReportsKept. Their names sort by the time they were written.216+func pruneReports(dir string) {217+ names, _ := filepath.Glob(filepath.Join(dir, "crash-*.txt"))218+ for _, n := range names[:max(0, len(names)-crashReportsKept)] {219+ os.Remove(n)220+ }221+}222+223+func orNone(s, none string) string {224+ if s == "" {225+ return none226+ }227+ return s228+}229+230+// crashTest, when set (only in builds tagged crashtest, for the e2e231+// tests: crashtest.go), says where a message should make the program232+// panic: "update", "view", "command", or "" for nowhere.233+var crashTest func(tea.Msg) string234+235+// test panics where crashTest said, or returns a command that will.236+func (g *Guarded) test(where string) tea.Cmd {237+ switch where {238+ case "update":239+ panic("crash test in update")240+ case "view":241+ g.viewPanics = true242+ case "command":243+ return g.guard(func() tea.Msg { panic("crash test in a command") })244+ }245+ return nil246+}@@ -0,0 +1,200 @@
1+package ui2+3+import (4+ "errors"5+ "fmt"6+ "os"7+ "path/filepath"8+ "strings"9+ "testing"10+ "time"11+12+ tea "charm.land/bubbletea/v2"13+)14+15+// panicOn makes F12 panic where, as the crashtest build does, for the16+// test.17+func panicOn(t *testing.T, where string) {18+ t.Helper()19+ crashTest = func(msg tea.Msg) string {20+ if k, ok := msg.(tea.KeyPressMsg); ok && k.Code == tea.KeyF12 {21+ return where22+ }23+ return ""24+ }25+ t.Cleanup(func() { crashTest = nil })26+}27+28+var f12 = tea.KeyPressMsg{Code: tea.KeyF12}29+30+// isQuit reports whether cmd quits the program.31+func isQuit(cmd tea.Cmd) bool {32+ if cmd == nil {33+ return false34+ }35+ _, ok := cmd().(tea.QuitMsg)36+ return ok37+}38+39+// A panic in Update quits the program, and the crash says where and40+// what with; the model's unsaved work is kept in the recovery directory41+// and offered back when the file is opened again.42+func TestGuardUpdatePanicKeepsWork(t *testing.T) {43+ t.Chdir(t.TempDir())44+ dir := filepath.Join(t.TempDir(), "recovery")45+ panicOn(t, "update")46+ m := newModel()47+ m.prefs.RecoveryDir = dir48+ m.filename = "book.012"49+ press(t, m, "mine", "<enter>")50+ g := Guard(m)51+ if _, cmd := g.Update(f12); !isQuit(cmd) {52+ t.Fatal("a panic in Update didn't quit")53+ }54+ if _, cmd := g.Update(tea.KeyPressMsg{Code: 'x', Text: "x"}); cmd != nil {55+ t.Error("a crashed model took more input")56+ }57+ c := g.Finish(nil)58+ if c == nil || c.Where != "update" || fmt.Sprint(c.Value) != "crash test in update" || !strings.Contains(string(c.Stack), "crash.go") {59+ t.Fatalf("crash %+v", c)60+ }61+ kept, err := g.Keep(time.Now())62+ if err != nil || filepath.Dir(kept) != dir || !strings.Contains(filepath.Base(kept), "book-") {63+ t.Fatalf("kept %q, %v", kept, err)64+ }65+66+ again := New(m.sheet, "book.012") // the file on disk doesn't matter here67+ again.Update(tea.WindowSizeMsg{Width: 80, Height: 20})68+ again.prefs.RecoveryDir = dir69+ again.OfferKept()70+ run(again, again.Init())71+ if !strings.Contains(line(again, contextLine), "Unsaved changes to book.012 were kept.") {72+ t.Fatalf("no offer: %q", line(again, contextLine))73+ }74+ // Another directory's book.012 is another file.75+ other := newModel()76+ other.prefs.RecoveryDir = dir77+ t.Chdir(t.TempDir())78+ other.filename = "book.012"79+ other.OfferKept()80+ run(other, other.Init())81+ if strings.Contains(line(other, contextLine), "were kept") {82+ t.Errorf("offered another directory's book: %q", line(other, contextLine))83+ }84+}85+86+// Nothing unsaved, nothing kept.87+func TestGuardKeepsOnlyUnsaved(t *testing.T) {88+ m := newModel()89+ m.prefs.RecoveryDir = t.TempDir()90+ if kept, err := Guard(m).Keep(time.Now()); kept != "" || err != nil {91+ t.Errorf("kept %q, %v", kept, err)92+ }93+}94+95+// A panic in a command, or in one of a batch it returns, comes back to96+// Update as a crash, which quits.97+func TestGuardCommandPanic(t *testing.T) {98+ panicOn(t, "command")99+ g := Guard(newModel())100+ _, cmd := g.Update(f12)101+ msg := cmd()102+ if _, ok := msg.(crashMsg); !ok {103+ t.Fatalf("got %T", msg)104+ }105+ if _, cmd := g.Update(msg); !isQuit(cmd) {106+ t.Error("a crash didn't quit")107+ }108+ if c := g.Finish(nil); c == nil || c.Where != "a command" {109+ t.Errorf("crash %+v", c)110+ }111+112+ g = Guard(newModel())113+ fine := func() tea.Msg { return nil }114+ boom := func() tea.Msg { panic("in a batch") }115+ batch, ok := g.guard(tea.Batch(fine, boom))().(tea.BatchMsg)116+ if !ok || len(batch) != 2 {117+ t.Fatalf("batch %v", batch)118+ }119+ if c, ok := batch[1]().(crashMsg); !ok || fmt.Sprint(c.crash.Value) != "in a batch" {120+ t.Errorf("a batch's panic: %v", batch[1]())121+ }122+}123+124+// A panic in View goes on to Bubble Tea, to stop the program, once the125+// crash is noted; the last frame is shown after it.126+func TestGuardViewPanic(t *testing.T) {127+ panicOn(t, "view")128+ g := Guard(newModel())129+ before := g.View()130+ g.Update(f12)131+ func() {132+ defer func() {133+ if recover() == nil {134+ t.Error("View didn't panic")135+ }136+ }()137+ g.View()138+ }()139+ if c := g.Finish(errors.Join(tea.ErrProgramKilled, tea.ErrProgramPanic)); c == nil || c.Where != "view" {140+ t.Fatalf("crash %+v", c)141+ }142+ if g.View().Content != before.Content {143+ t.Error("after the crash, View isn't the last frame")144+ }145+}146+147+// A panic only Bubble Tea caught is still a crash.148+func TestGuardFinishBubbleTeaPanic(t *testing.T) {149+ g := Guard(newModel())150+ if c := g.Finish(nil); c != nil {151+ t.Errorf("a clean quit crashed: %+v", c)152+ }153+ if c := g.Finish(tea.ErrProgramPanic); c == nil || c.Where != "a command" {154+ t.Errorf("crash %+v", c)155+ }156+}157+158+// The report says where, what with, the build, the file and where its159+// work went, with the stack; at most crashReportsKept are left.160+func TestCrashReport(t *testing.T) {161+ dir := t.TempDir()162+ c := &Crash{Where: "update", Value: "boom", Stack: []byte("goroutine 1 [running]:\nmain.main()\n")}163+ at := time.Date(2026, 9, 29, 10, 11, 12, 0, time.Local)164+ path, err := c.Report(dir, "v9.9.9", "book.012", "/r/book-1.012", nil, at)165+ if err != nil {166+ t.Fatal(err)167+ }168+ if filepath.Base(path) != "crash-20260929-101112.txt" {169+ t.Errorf("path %s", path)170+ }171+ data, _ := os.ReadFile(path)172+ for _, want := range []string{"a panic in update", "Version: v9.9.9", "File: book.012", "Kept: /r/book-1.012", "Panic: boom", "main.main()"} {173+ if !strings.Contains(string(data), want) {174+ t.Errorf("report lacks %q:\n%s", want, data)175+ }176+ }177+ for i := range crashReportsKept + 3 {178+ if _, err := c.Report(dir, "", "", "", errors.New("disk full"), at.Add(time.Duration(i+1)*time.Second)); err != nil {179+ t.Fatal(err)180+ }181+ }182+ names, _ := filepath.Glob(filepath.Join(dir, "crash-*.txt"))183+ if len(names) != crashReportsKept || filepath.Base(names[0]) != "crash-20260929-101116.txt" {184+ t.Errorf("kept %d reports, first %s", len(names), filepath.Base(names[0]))185+ }186+ data, _ = os.ReadFile(names[0])187+ if !strings.Contains(string(data), "couldn't keep the unsaved changes: disk full") || !strings.Contains(string(data), "(untitled)") {188+ t.Errorf("report:\n%s", data)189+ }190+}191+192+// A path too long for a file name still makes a key that fits, and193+// different long paths make different keys.194+func TestRecoveryKeyLong(t *testing.T) {195+ long := "/" + strings.Repeat("dir/", 80)196+ a, b := recoveryKey(long+"a.012"), recoveryKey(long+"b.012")197+ if len(a) > recoveryKeyMax || a == b || !strings.HasSuffix(a, "a") {198+ t.Errorf("keys %q, %q", a, b)199+ }200+}@@ -0,0 +1,22 @@
1+//go:build crashtest2+3+package ui4+5+import (6+ "os"7+8+ tea "charm.land/bubbletea/v2"9+)10+11+// In builds tagged crashtest (the e2e tests' binary), F12 makes the12+// program panic where O12_CRASH_TEST says: "update", "view" or13+// "command". Release builds have no such key.14+func init() {15+ where := os.Getenv("O12_CRASH_TEST")16+ crashTest = func(msg tea.Msg) string {17+ if k, ok := msg.(tea.KeyPressMsg); ok && k.String() == "f12" {18+ return where19+ }20+ return ""21+ }22+}@@ -0,0 +1,28 @@
1+package ui2+3+import (4+ tea "charm.land/bubbletea/v2"5+6+ "github.com/FelineStateMachine/012/internal/ui/evalview"7+)8+9+// Data > Evaluate formula: the active cell's formula stepped through one10+// part at a time in a box over the grid (package evalview), the values11+// from the engine's sheet.Steps.12+13+func init() {14+ register(&command{id: "data.evaluate", macro: macroView, title: "Evaluate formula",15+ desc: "Step through the active cell's formula one part at a time, each part's value in its place",16+ enabled: func(m *Model) bool {17+ c := m.sheet.Cell(m.cur)18+ return c != nil && c.IsFormula()19+ },20+ run: func(m *Model) tea.Cmd {21+ if st := m.sheet.EvaluateSteps(m.cur); st != nil {22+ m.clearSelection()23+ m.openOverlay(evalview.New(m.host(), st))24+ }25+ return nil26+ }})27+ keymap["alt+="] = "data.evaluate"28+}@@ -0,0 +1,41 @@
1+package ui2+3+import (4+ "strings"5+ "testing"6+7+ tea "charm.land/bubbletea/v2"8+)9+10+func TestEvaluateFormula(t *testing.T) {11+ m := traceModel(t)12+ m.cur = addr("A1")13+ if commands["data.evaluate"].available(m) {14+ t.Error("Evaluate formula on a number")15+ }16+ m.cur = addr("C1")17+ press(t, m, "<alt+=>")18+ if m.mode != modeMenu || !strings.Contains(line(m, menuLine), "EVAL") {19+ t.Fatalf("mode %v:\n%s", m.mode, screen(m))20+ }21+ if scr := screen(m); !strings.Contains(scr, "Evaluate C1") || !strings.Contains(scr, "Next B1 = 6") {22+ t.Errorf("box:\n%s", scr)23+ }24+ press(t, m, "<right>")25+ if scr := screen(m); !strings.Contains(scr, "Evaluate C1 › B1") || !strings.Contains(scr, "=A1+SUM(A2:A3)") {26+ t.Errorf("stepped in:\n%s", scr)27+ }28+ press(t, m, "<left>", "<enter>")29+ if scr := screen(m); !strings.Contains(scr, "Value 12") {30+ t.Errorf("done:\n%s", scr)31+ }32+ // A click outside closes it, as Esc does.33+ send(m, tea.MouseClickMsg{X: 2, Y: m.height - 3, Button: tea.MouseLeft})34+ if m.mode != modeReady || m.overlay != nil {35+ t.Errorf("mode %v after a click outside", m.mode)36+ }37+ press(t, m, "<alt+=>", "<esc>")38+ if m.mode != modeReady {39+ t.Errorf("mode %v after Esc", m.mode)40+ }41+}@@ -0,0 +1,229 @@
1+// Package evalview is Data > Evaluate formula, after Excel's Evaluate2+// Formula: a box over the grid showing the active cell's formula with3+// the part computed next underlined and its value below. Enter puts the4+// value in its place and underlines the next part, until the formula's5+// value is left; → steps into a reference to another formula, ← and Esc6+// step back out. The engine does the evaluating (sheet.Steps); the view7+// draws it. It knows the UI only through Host.8+package evalview9+10+import (11+ "strconv"12+ "strings"13+14+ tea "charm.land/bubbletea/v2"15+ "charm.land/lipgloss/v2"16+ "github.com/charmbracelet/x/ansi"17+18+ "github.com/FelineStateMachine/012/internal/formula"19+ "github.com/FelineStateMachine/012/internal/locale"20+ "github.com/FelineStateMachine/012/internal/sheet"21+ "github.com/FelineStateMachine/012/internal/ui/overlay"22+ "github.com/FelineStateMachine/012/internal/ui/theme"23+)24+25+// Host is what the view needs of the UI.26+type Host interface {27+ Theme() *theme.Theme28+ Size() (width, height int)29+ // Close closes the open overlay.30+ Close()31+ // Locale writes formulas as the user types them.32+ Locale() *locale.Locale33+}34+35+// View is the open Evaluate formula box.36+type View struct {37+ h Host38+ stack []*sheet.Steps // the formula stepped into last on top39+}40+41+// ID identifies the view's box in mouse events.42+const ID = "evaluate"43+44+// maxInner is the widest the box's inside gets.45+const maxInner = 7646+47+// New returns the view of st, a formula about to be stepped through.48+func New(h Host, st *sheet.Steps) *View { return &View{h: h, stack: []*sheet.Steps{st}} }49+50+// Steps is the formula being stepped through: the one stepped into last.51+func (v *View) Steps() *sheet.Steps { return v.stack[len(v.stack)-1] }52+53+// Depth is how many formulas are open, the first one included.54+func (v *View) Depth() int { return len(v.stack) }55+56+func (v *View) Indicator() string { return "EVAL" }57+58+// Key: Enter computes the next part (at the end, restarts, or steps59+// out of a formula stepped into), → steps in, ← steps out, Esc steps60+// out or closes.61+func (v *View) Key(k tea.KeyPressMsg) tea.Cmd {62+ st := v.Steps()63+ switch k.String() {64+ case "enter", "space":65+ switch {66+ case !st.Done():67+ st.Step()68+ case len(v.stack) > 1:69+ v.out()70+ default:71+ st.Restart()72+ }73+ case "right":74+ if in := st.Into(); in != nil {75+ v.stack = append(v.stack, in)76+ }77+ case "left":78+ if len(v.stack) > 1 {79+ v.out()80+ }81+ case "esc":82+ if len(v.stack) > 1 {83+ v.out()84+ return nil85+ }86+ v.h.Close()87+ }88+ return nil89+}90+91+// out steps out of the formula stepped into: the reference to it takes92+// its value in the formula before.93+func (v *View) out() {94+ v.stack = v.stack[:len(v.stack)-1]95+ v.Steps().Step()96+}97+98+// Mouse closes the box on a click outside it.99+func (v *View) Mouse(e overlay.MouseEvent) tea.Cmd {100+ if e.Kind == overlay.MousePress && e.Box != ID {101+ v.h.Close()102+ }103+ return nil104+}105+106+// Status says what the keys do now.107+func (v *View) Status() (string, string) {108+ th, st := v.h.Theme(), v.Steps()109+ var keys []string110+ switch {111+ case !st.Done():112+ keys = append(keys, "Enter", "evaluate")113+ case len(v.stack) > 1:114+ keys = append(keys, "Enter", "step out")115+ default:116+ keys = append(keys, "Enter", "restart")117+ }118+ if st.CanStepIn() {119+ keys = append(keys, "→", "step in")120+ }121+ if len(v.stack) > 1 {122+ keys = append(keys, "←", "step out")123+ }124+ keys = append(keys, "Esc", "close")125+ desc := "The underlined part is computed next"126+ if st.Done() {127+ desc = "Every part is computed"128+ }129+ return desc, th.KeyHints(keys...)130+}131+132+// Layout is the box: the formula, wrapped, then the next part and its133+// value, under the menu bar and centered.134+func (v *View) Layout() []overlay.Box {135+ th := v.h.Theme()136+ width, height := v.h.Size()137+ inner := min(width-2, maxInner)138+ st := v.Steps()139+ text := v.formulaLines(inner-2, max(height-12, 1))140+ rows := make([]string, 0, len(text)+2)141+ for _, l := range text {142+ rows = append(rows, th.MenuBar.Render(" ")+l+th.MenuBar.Render(strings.Repeat(" ", max(inner-1-ansi.StringWidth(l), 0))))143+ }144+ rows = append(rows, theme.SepRow, v.nextRow(inner))145+ done, total := st.Progress()146+ footer := strconv.Itoa(done) + " of " + strconv.Itoa(total)147+ return []overlay.Box{{ID: ID, X: (width - inner - 2) / 2, Y: overlay.MenuLine + 1, Lines: th.Frame(inner, v.title(), footer, rows)}}148+}149+150+// title names the formulas open: Evaluate C1 › B1.151+func (v *View) title() string {152+ first, _ := v.stack[0].Cell()153+ names := make([]string, len(v.stack))154+ for i, st := range v.stack {155+ s, a := st.Cell()156+ names[i] = a.String()157+ if s != first {158+ names[i] = sheet.Qualified(s.Name(), sheet.Rect{From: a, To: a})159+ }160+ }161+ return "Evaluate " + strings.Join(names, " › ")162+}163+164+// nextRow is "Next B1 = 8", or once done "Value 14".165+func (v *View) nextRow(inner int) string {166+ th, st, loc := v.h.Theme(), v.Steps(), v.h.Locale()167+ line := th.Muted.Render(" Value ") + th.Evaluated.Render(formula.Localize(st.Result(), loc))168+ if expr, value, ok := st.Next(); ok {169+ line = th.Muted.Render(" Next ") + th.EvalNext.Render(formula.Localize(expr, loc)) + th.Muted.Render(" = ") + th.Evaluated.Render(formula.Localize(value, loc))170+ }171+ line = ansi.Truncate(line, inner, "…")172+ return line + th.MenuBar.Render(strings.Repeat(" ", max(inner-ansi.StringWidth(line), 0)))173+}174+175+// run is text in one style.176+type run struct {177+ text string178+ style *lipgloss.Style179+}180+181+// formulaLines draws the formula as it stands in lines of w columns, at182+// most max of them: those from the line the next part starts on.183+func (v *View) formulaLines(w, most int) []string {184+ th, loc := v.h.Theme(), v.h.Locale()185+ both := th.Evaluated.Bold(true).Underline(true)186+ var lines [][]run187+ var cur []run188+ col, nextLine := 0, -1189+ for _, sg := range v.Steps().Text() {190+ style := &th.MenuBar191+ switch {192+ case sg.Value && sg.Next:193+ style = &both194+ case sg.Value:195+ style = &th.Evaluated196+ case sg.Next:197+ style = &th.EvalNext198+ }199+ if sg.Next && nextLine < 0 {200+ nextLine = len(lines)201+ }202+ for _, r := range formula.Localize(sg.Text, loc) {203+ rw := ansi.StringWidth(string(r))204+ if col+rw > w && col > 0 {205+ lines, cur, col = append(lines, cur), nil, 0206+ }207+ if n := len(cur); n > 0 && cur[n-1].style == style {208+ cur[n-1].text += string(r)209+ } else {210+ cur = append(cur, run{string(r), style})211+ }212+ col += rw213+ }214+ }215+ lines = append(lines, cur)216+ start := 0217+ if nextLine >= 0 && len(lines) > most {218+ start = min(max(nextLine-1, 0), len(lines)-most)219+ }220+ out := make([]string, 0, min(len(lines), most))221+ for _, l := range lines[start:min(len(lines), start+most)] {222+ var b strings.Builder223+ for _, r := range l {224+ b.WriteString(r.style.Render(r.text))225+ }226+ out = append(out, b.String())227+ }228+ return out229+}@@ -0,0 +1,110 @@
1+package evalview2+3+import (4+ "strings"5+ "testing"6+7+ tea "charm.land/bubbletea/v2"8+ "github.com/charmbracelet/x/ansi"9+10+ "github.com/FelineStateMachine/012/internal/locale"11+ "github.com/FelineStateMachine/012/internal/sheet"12+ "github.com/FelineStateMachine/012/internal/ui/theme"13+)14+15+type fakeHost struct {16+ th theme.Theme17+ loc *locale.Locale18+ w int19+ closed bool20+}21+22+func (h *fakeHost) Theme() *theme.Theme { return &h.th }23+func (h *fakeHost) Size() (int, int) { return h.w, 24 }24+func (h *fakeHost) Close() { h.closed = true }25+func (h *fakeHost) Locale() *locale.Locale { return h.loc }26+func named(code rune) tea.KeyPressMsg { return tea.KeyPressMsg{Code: code} }27+func text(v *View) string { return ansi.Strip(strings.Join(v.Layout()[0].Lines, "\n")) }28+func status(v *View) string { d, k := v.Status(); return ansi.Strip(d + " | " + k) }29+func at(s string) sheet.Addr { a, _ := sheet.ParseAddr(s); return a }30+func newHost(w int, l *locale.Locale) *fakeHost { return &fakeHost{th: theme.New(true), loc: l, w: w} }31+32+func book(t *testing.T) *sheet.Sheet {33+ t.Helper()34+ s := sheet.New()35+ for a, in := range map[string]string{"A1": "1.5", "A2": "2", "B1": "=A1*2", "C1": "=SUM(B1,A2)"} {36+ if err := s.Set(at(a), in); err != nil {37+ t.Fatal(err)38+ }39+ }40+ return s41+}42+43+func TestEvaluate(t *testing.T) {44+ s := book(t)45+ h := newHost(60, locale.Canonical)46+ v := New(h, s.EvaluateSteps(at("C1")))47+ if got := text(v); !strings.Contains(got, "Evaluate C1") || !strings.Contains(got, "=SUM(B1,A2)") ||48+ !strings.Contains(got, "Next B1 = 3") || !strings.Contains(got, "0 of 3") {49+ t.Errorf("first:\n%s", got)50+ }51+ if got := status(v); !strings.Contains(got, "Enter evaluate") || !strings.Contains(got, "→ step in") {52+ t.Errorf("status %q", got)53+ }54+ // Stepping into B1 shows its formula; stepping out puts its value in.55+ v.Key(named(tea.KeyRight))56+ if got := text(v); v.Depth() != 2 || !strings.Contains(got, "Evaluate C1 › B1") || !strings.Contains(got, "=A1*2") {57+ t.Errorf("into B1:\n%s", got)58+ }59+ v.Key(named(tea.KeyEnter))60+ v.Key(named(tea.KeyEnter))61+ if got := text(v); !strings.Contains(got, "Value 3") || !strings.Contains(status(v), "Enter step out") {62+ t.Errorf("B1 done:\n%s", got)63+ }64+ v.Key(named(tea.KeyEnter))65+ if got := text(v); v.Depth() != 1 || !strings.Contains(got, "=SUM(3,A2)") || !strings.Contains(got, "Next A2 = 2") {66+ t.Errorf("back out:\n%s", got)67+ }68+ v.Key(named(tea.KeyEnter))69+ v.Key(named(tea.KeyEnter))70+ if got := text(v); !strings.Contains(got, "Value 5") || !strings.Contains(status(v), "Enter restart") {71+ t.Errorf("done:\n%s", got)72+ }73+ v.Key(named(tea.KeyEnter))74+ if got := text(v); !strings.Contains(got, "0 of 3") {75+ t.Errorf("restart:\n%s", got)76+ }77+ // Esc steps out, then closes.78+ v.Key(named(tea.KeyRight))79+ v.Key(named(tea.KeyEscape))80+ if v.Depth() != 1 || h.closed {81+ t.Error("Esc didn't step out")82+ }83+ v.Key(named(tea.KeyEscape))84+ if !h.closed {85+ t.Error("Esc didn't close")86+ }87+}88+89+// Formulas are written in the locale's syntax, and long ones wrap.90+func TestEvaluateLocaleAndWrap(t *testing.T) {91+ s := book(t)92+ s.Set(at("D1"), "=A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1+A1")93+ de, _ := locale.Lookup("de-DE")94+ v := New(newHost(40, de), s.EvaluateSteps(at("C1")))95+ v.Key(named(tea.KeyRight))96+ v.Key(named(tea.KeyEnter))97+ if got := text(v); !strings.Contains(got, "=1,5*2") {98+ t.Errorf("de-DE:\n%s", got)99+ }100+ v = New(newHost(40, locale.Canonical), s.EvaluateSteps(at("D1")))101+ lines := v.Layout()[0].Lines102+ if len(lines) < 6 {103+ t.Errorf("didn't wrap:\n%s", text(v))104+ }105+ for _, l := range lines {106+ if ansi.StringWidth(l) != ansi.StringWidth(lines[0]) {107+ t.Errorf("ragged box:\n%s", text(v))108+ }109+ }110+}Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.
Not shown: this page already shows 6000 lines of diff.