From 18a03816e6bbd7c18a1ca9c77f47028ab1971c08 Mon Sep 17 00:00:00 2001
From: Claude A data grid whose rows, formulas, totals, sorting, filtering and grouping all run in WebAssembly on the watershed engine.
- Every cell is a node, so a change recalculates only the cells and totals that depend on it. The same table in Solid.Watershed Grid in React
Rust → WebAssembly · React
+ {text}
+
+ >
+ );
+}
+
+function Cookbook() {
+ return (
+ + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, and charts that follow the table. Each one runs + here, and the code under it is the file that runs. Back to the grid. +
+
+ The packages are on GitHub Packages. Put this .npmrc beside your package.json, with a GitHub token that can read packages (a
+ classic token with read:packages):
+
{install.npmrc}
+ {install.react}
+
+ The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
+
{install.vite}
+ {install.css}
+
+ Every method and option is in the READMEs: @surefold/grid (the table and the
+ grid), @surefold/grid-react. For a million rows, put the table in a
+ worker with WorkerTable; the grid page does, and{" "}
+ its source shows streaming, looking back and adding columns as it
+ runs.
+
A data grid whose rows, formulas, totals, sorting, filtering and grouping all run in WebAssembly on the watershed engine. - Every cell is a node, so a change recalculates only the cells and totals that depend on it. The same table in React.
+ Every cell is a node, so a change recalculates only the cells and totals that depend on it. The same table in React. Cookbook: how to use it. diff --git a/web/grid/src/cookbook/cookbook.css b/web/grid/src/cookbook/cookbook.css new file mode 100644 index 0000000..28dab48 --- /dev/null +++ b/web/grid/src/cookbook/cookbook.css @@ -0,0 +1,66 @@ +/* The cookbook pages, Solid (web/grid/cookbook) and React (web/grid-react/cookbook). + The grid's own styles are @surefold/grid/grid.css; with no theme chosen it + takes these colours. */ +:root { + --paper: #f2f5f4; --surface: #ffffff; --ink: #13242c; --muted: #56676e; --rule: #d3dcdc; + --water: #1d6c88; --bad: #b9541f; --code: #f7f9f9; + --display: "Bricolage Grotesque", "Segoe UI", system-ui, sans-serif; + --body: "Figtree", "Segoe UI", system-ui, sans-serif; + --mono: "JetBrains Mono", ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace; + color-scheme: light; +} +@media (prefers-color-scheme: dark) { + :root { + --paper: #0e161a; --surface: #142026; --ink: #e2eaeb; --muted: #94a4a9; --rule: #2a3c43; + --water: #63b4d0; --bad: #f0894a; --code: #101b20; + color-scheme: dark; + } +} +* { box-sizing: border-box; } +body { margin: 0; background: var(--paper); color: var(--ink); font: 15px/1.6 var(--body); } +a { color: var(--water); } +code, pre { font-family: var(--mono); font-size: 0.86em; font-variant-ligatures: none; } +:not(pre) > code { background: color-mix(in srgb, var(--ink) 7%, transparent); padding: 1px 5px; border-radius: 5px; } + +.page { max-width: 1060px; margin: 0 auto; padding: 28px 16px 64px; } +header { display: grid; gap: 6px; margin-bottom: 18px; } +h1 { font: 700 2rem/1.1 var(--display); letter-spacing: -0.02em; margin: 0; } +h1 span { color: var(--water); } +header p { margin: 0; color: var(--muted); max-width: 72ch; } +.switch { display: inline-flex; gap: 2px; padding: 3px; border-radius: 999px; background: color-mix(in srgb, var(--ink) 7%, transparent); width: max-content; margin-top: 6px; } +.switch a, .switch span { padding: 4px 14px; border-radius: 999px; text-decoration: none; font: 600 13px/1.4 var(--body); color: var(--muted); } +.switch span { background: var(--surface); color: var(--ink); box-shadow: 0 1px 2px color-mix(in srgb, var(--ink) 15%, transparent); } + +nav.toc { display: flex; flex-wrap: wrap; gap: 6px 18px; padding: 12px 0 18px; border-bottom: 1px solid var(--rule); margin-bottom: 8px; font-size: 14px; } + +section { padding: 26px 0 8px; border-bottom: 1px solid var(--rule); } +h2 { font: 700 1.35rem/1.2 var(--display); letter-spacing: -0.01em; margin: 0 0 8px; } +h2 a { color: inherit; text-decoration: none; } +h2 a:hover::after { content: " #"; color: var(--muted); } +section > p { margin: 0 0 10px; max-width: 78ch; } +section ul { margin: 6px 0 12px; padding-left: 20px; max-width: 80ch; color: var(--muted); font-size: 14px; } +section li { margin: 4px 0; } + +pre { margin: 10px 0; padding: 14px 16px; background: var(--code); border: 1px solid var(--rule); border-radius: 10px; overflow: auto; line-height: 1.5; tab-size: 2; } +.file + pre { max-height: 560px; } +details { margin: 8px 0; } +details > summary { cursor: pointer; font-weight: 600; font-size: 14px; color: var(--water); } +.file { display: flex; justify-content: space-between; align-items: center; gap: 8px; margin-top: 12px; font: 600 12px/1 var(--mono); color: var(--muted); } +.file button { font: 600 12px/1 var(--body); } + +/* The recipe running, in a card. */ +.live { margin: 14px 0 6px; padding: 12px; background: var(--surface); border: 1px solid var(--rule); border-radius: 12px; display: grid; gap: 10px; } +.live .bar { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; font-size: 14px; } +.live .bar .grow { flex: 1; } +.live .bad { color: var(--bad); } +.live .muted { color: var(--muted); } +.live b { font-variant-numeric: tabular-nums; } +.live .grid { height: 260px; } +.live .charts { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 12px; } +.live .charts > div { min-height: 200px; border: 1px solid var(--rule); border-radius: 10px; padding: 10px; } +.live .bars { display: block; width: 100%; max-width: 340px; height: auto; } +.live .bars text { fill: var(--ink); font: 12px var(--body); } +.live .bars rect { fill: var(--water); } +button { font: 600 13px/1 var(--body); padding: 7px 12px; border-radius: 8px; border: 1px solid var(--rule); background: var(--surface); color: var(--ink); cursor: pointer; } +button:hover:not(:disabled) { border-color: var(--water); } +button:disabled { opacity: 0.5; cursor: default; } diff --git a/web/grid/src/cookbook/main.tsx b/web/grid/src/cookbook/main.tsx new file mode 100644 index 0000000..9d5f3d7 --- /dev/null +++ b/web/grid/src/cookbook/main.tsx @@ -0,0 +1,107 @@ +// The cookbook page in Solid: each recipe running, with its source beside it. +// The source shown is the file itself, so what you read is what runs. + +import { For, type JSX } from "solid-js"; +import { render } from "solid-js/web"; +import "@surefold/grid/grid.css"; +import "./cookbook.css"; +import { install, recipes } from "./text"; +import { FirstGrid } from "./recipes/FirstGrid"; +import { FromAnApi } from "./recipes/FromAnApi"; +import { PagedApi } from "./recipes/PagedApi"; +import { Charts } from "./recipes/Charts"; + +const sources = import.meta.glob
+ {text}
+
+ >
+ );
+}
+
+function Cookbook() {
+ return (
+ + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, and charts that follow the table. Each one runs + here, and the code under it is the file that runs. Back to the grid. +
+
+ The packages are on GitHub Packages. Put this .npmrc beside your package.json, with a GitHub token that can read packages (a
+ classic token with read:packages):
+
{install.npmrc}
+ {install.solid}
+
+ The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
+
{install.vite}
+ {install.css}
+
+ Every method and option is in the READMEs: @surefold/grid (the table and the
+ grid), @surefold/grid-solid. For a million rows, put the table in a
+ worker with WorkerTable; the grid page does, and its source shows streaming, looking back and adding columns as it runs.
+
Table holds the rows and works out the formulas and totals. The <Grid> component only draws it. " +
+ "So rows never go through props or component state: change them on the table, and the grid and anything that reads a total follow.",
+ "Click a cell to edit it, or use the buttons, which change the table from code.",
+ ],
+ notes: [
+ "put needs every field, of its kind, and TypeScript checks the names: set(\"o-1\", \"qyt\", 5) does not compile.",
+ "Writes are gathered up and recalculated once, at the end of the current task. Only the cells and totals that depend on what changed are worked out again.",
+ "The grid fills the element it is given, so give it a height.",
+ ],
+ },
+ {
+ id: "fetch",
+ title: "Rows from an API",
+ intro: [
+ "Fetch, then hand the rows to the table. putMany takes them a column at a time and is the fastest way in; " +
+ "put one row at a time works too. Rows are found by key, so fetching again replaces the rows that came before rather than adding copies, " +
+ "and only the cells whose values moved are recalculated.",
+ "This one reads DummyJSON's products (a free API, no key needed) and works out each product's sale price and stock value with formulas.",
+ ],
+ notes: [
+ "The API's names do not have to be the table's: map them as you put the rows (discountPercentage becomes discount here).",
+ "If rows can disappear between fetches, drop(key) the ones that are gone, inside batch(() => …) with the new rows so it is one recalculation.",
+ "To keep it current, call the same function on a timer, or on each message from a WebSocket: set or patch the rows a message names.",
+ "Abort the fetch when the component goes, so a late answer does not write to a table that has been freed.",
+ ],
+ },
+ {
+ id: "paged",
+ title: "Load pages as you scroll",
+ intro: [
+ "For an API that pages, give the grid loadMore. It is called as the person nears the last row: put the next page into the table, " +
+ "and resolve to whether there may be more. The first page is asked for once the grid is drawn, through the view's fetchMore().",
+ "Scroll down: each page is twenty more products from the same API.",
+ ],
+ notes: [
+ "If loadMore throws, the grid says so through onError and stops asking. Here a failed page is caught and reported, and loadMore resolves to true, so scrolling asks for it again.",
+ "Sorting, filtering and grouping work over the rows loaded so far, and totals are of those rows.",
+ ],
+ },
+ {
+ id: "charts",
+ title: "Charts from the table",
+ intro: [
+ "A chart reads the table, the way the grid does, and draws again after each recalculation. " +
+ "Group the rows (table.group(\"category\"), or from a column's ⋮ menu in the grid) and table.groups() gives each group's row count and totals.",
+ "The first chart is the package's own GroupChart. The second is a few lines of SVG drawn from groups(): " +
+ "put any charting library in its place. Edit a price or stock in the grid, or press the button, and both follow.",
+ ],
+ notes: [
+ "With history set on the table, totalTrend(column) gives how a total moved over recent recalculations, for a line or sparkline.",
+ "groups() follows the grid's filters and group order: filter the grid and the bars are of the rows that pass.",
+ "In React, useReading wants a value that compares with ===, so a list such as groups() is read as a string and parsed. In Solid, createReading follows any value.",
+ ],
+ },
+];
+
+export const install = {
+ npmrc: "@surefold:registry=https://npm.pkg.github.com\n//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}",
+ solid: "npm install @surefold/grid @surefold/grid-solid",
+ react: "npm install @surefold/grid @surefold/grid-react",
+ vite: `// vite.config.ts
+import { defineConfig } from "vite";
+
+export default defineConfig({
+ plugins: [/* solid() or react() */],
+ worker: { format: "es" }, // only for WorkerTable
+ build: { target: "es2022" },
+ optimizeDeps: { esbuildOptions: { target: "es2022" } },
+});`,
+ css: `import "@surefold/grid/grid.css"; // once, anywhere in the app`,
+};
diff --git a/web/grid/vite.config.ts b/web/grid/vite.config.ts
index 7b6314c..71d5a0b 100644
--- a/web/grid/vite.config.ts
+++ b/web/grid/vite.config.ts
@@ -1,3 +1,4 @@
+import { resolve } from "node:path";
import { defaultClientConditions, defineConfig } from "vite";
import solid from "vite-plugin-solid";
@@ -9,7 +10,13 @@ export default defineConfig({
plugins: [solid()],
// The table's worker is a module, with a top-level await for its engine.
worker: { format: "es" },
- build: { target: "es2022", outDir: "../dist/grid", emptyOutDir: false },
+ build: {
+ target: "es2022",
+ outDir: "../dist/grid",
+ emptyOutDir: false,
+ // The page, and the cookbook under it.
+ rollupOptions: { input: { main: resolve(__dirname, "index.html"), cookbook: resolve(__dirname, "cookbook/index.html") } },
+ },
esbuild: { target: "es2022" },
optimizeDeps: { esbuildOptions: { target: "es2022" } },
});
From cf40346db70b59b598a34c127a0149c8fbbf06cf Mon Sep 17 00:00:00 2001
From: Claude
- The packages are on GitHub Packages. Put this .npmrc beside your package.json, with a GitHub token that can read packages (a
+ The packages are on GitHub Packages. Put this .npmrc beside your package.json (npm and Bun both read it), with a GitHub token that can read packages (a
classic token with read:packages):
{install.npmrc}
{install.react}
+
+ Bun reads the same .npmrc. If your project keeps its settings in bunfig.toml instead:
+
{install.bunfig}
The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
- The packages are on GitHub Packages. Put this .npmrc beside your package.json, with a GitHub token that can read packages (a
+ The packages are on GitHub Packages. Put this .npmrc beside your package.json (npm and Bun both read it), with a GitHub token that can read packages (a
classic token with read:packages):
{install.npmrc}
{install.solid}
+
+ Bun reads the same .npmrc. If your project keeps its settings in bunfig.toml instead:
+
{install.bunfig}
The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
- Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, and charts that follow the table. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
Every method and option is in the READMEs: @surefold/grid (the table and the
- grid), @surefold/grid-react. For a million rows, put the table in a
- worker with WorkerTable; the grid page does, and{" "}
+ grid), @surefold/grid-react. The grid page streams prices into a
+ WorkerTable, and{" "}
its source shows streaming, looking back and adding columns as it
runs.
- Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, and charts that follow the table. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
Every method and option is in the READMEs: @surefold/grid (the table and the
- grid), @surefold/grid-solid. For a million rows, put the table in a
- worker with WorkerTable; the grid page does, and its source shows streaming, looking back and adding columns as it runs.
+ grid), @surefold/grid-solid. The grid page streams prices into a
+ WorkerTable, and its source shows streaming, looking back and adding columns as it runs.
useReading wants a value that compares with ===, so a list such as groups() is read as a string and parsed. In Solid, createReading follows any value.",
],
},
+ {
+ id: "worker",
+ title: "A large table in a worker",
+ intro: [
+ "A WorkerTable is a table whose engine runs in a Web Worker. Loading and every recalculation happen there, so a large load never stops the page. " +
+ "It takes the same spec as a Table, and the grid and the totals draw it the same way. It is made with await WorkerTable.create(spec), because the worker has to start first.",
+ "Press the button to load 300,000 rows in blocks of 50,000. Scroll and sort while they load, then move a thousand prices at once.",
+ ],
+ notes: [
+ "Writes (put, putMany, set, batch) are messages to the worker, run in order. Each returns a promise, which you can ignore or wait for. It resolves once the worker has taken the write; the totals it changes come a moment later, with the recalculation's snapshot, so read them in watch, createTotal or useTotal.",
+ "size, total, groups and columns read the snapshot the worker sends after each recalculation, so they answer at once. get, why and csv ask the worker, so they return promises.",
+ "With Vite, set worker: { format: \"es\" } in the config: the worker is a module. Webpack 5 and Rollup bundle it as they are.",
+ "dispose() stops the worker. A table made in a component should be disposed when the component goes, and promises still waiting on it reject.",
+ "A row costs about 2 KB, and a page's WebAssembly memory stops at 4 GB, so a worker holds about 1.5 million rows of a table like this one.",
+ ],
+ },
];
export const install = {
From 456cdfa44a2cdf2ddd43b189a3704b40737757c8 Mon Sep 17 00:00:00 2001
From: Claude - Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, charts that follow the table, and a large table in a worker. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
- Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, charts that follow the table, and a large table in a worker. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
set the cell it names, and the table recalculates what that cell feeds. " +
+ "Messages can come faster than the screen draws, so gather them as they come and write them once a frame, inside batch: one recalculation, and one redraw, however many came.",
+ "This one subscribes to Coinbase's public ticker (no key needed). Each coin's row is added with its first price, and its gain is worked out from there. Press Connect.",
+ ],
+ notes: [
+ "Only the latest price of each coin is kept between frames, so a burst of messages costs one set a coin.",
+ "With history on the table, a column's trend draws how each cell moved, here the last 120 recalculations of each price.",
+ "Close the socket when the component goes. A real app would also reconnect after a dropped connection, waiting a little longer each time.",
+ ],
+ },
+ {
+ id: "sse",
+ title: "Events over SSE",
+ intro: [
+ "Server-sent events come through the browser's EventSource, a message at a time. Here each message is a new row: they are gathered and put once a frame, in a batch that also drops the oldest rows, so the table keeps the latest 2,000.",
+ "This one reads Wikimedia's stream of recent changes: every edit to every Wikimedia wiki, as it happens. The rows are grouped by wiki, so each group's row counts its edits and adds up the bytes they changed. Press Connect.",
+ ],
+ notes: [
+ "EventSource reconnects by itself after a dropped connection; onerror says when it is trying.",
+ "The grouping, sorting and filters are the table's, so they hold while rows come and go. Open a group, or sort by bytes, while it streams.",
+ "Browsers stop calling requestAnimationFrame in a hidden tab, so edits gather until the tab is shown again; only the latest 2,000 of them are written.",
+ ],
+ },
{
id: "charts",
title: "Charts from the table",
From 31f4254942ea27269dfcb72acad59aa4930df091 Mon Sep 17 00:00:00 2001
From: Claude - Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, edits saved back to an API, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
+ {log.map((line, k) => (
+ {line}
+ ))}
+
+ )}
+ >
+ );
+}
diff --git a/web/grid/cookbook/index.html b/web/grid/cookbook/index.html
index 0c79d2f..60dc74f 100644
--- a/web/grid/cookbook/index.html
+++ b/web/grid/cookbook/index.html
@@ -4,7 +4,7 @@
- Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs + Small, whole examples of the grid in an app: a first table, rows from an API, pages loaded as you scroll, edits saved back to an API, live updates over a WebSocket or SSE, charts that follow the table, and a large table in a worker. Each one runs here, and the code under it is the file that runs. Back to the grid.
++{(line) => +{line}}
PATCH a changed row, with only its changed fields. Edit some titles, prices or stock, then save. DummyJSON answers as if it had saved, but keeps nothing.",
+ ],
+ notes: [
+ "watch says what each recalculation did. inputsChanged is more than 0 when cells were set, so sorting and filtering do not start a compare.",
+ "Comparing every row costs a get a row: right for hundreds of rows. For many thousands, compare only the rows on screen, or keep the keys your own code and the server touch.",
+ "A row that fails to save stays unsaved, so pressing Save again retries it. An edit made while a save is on its way also stays unsaved, because only what was sent is marked as saved.",
+ "To save as people type, call the same save from watch, after a pause of a second or so with no edits.",
+ "New rows (POST) and deleted rows (DELETE) work the same way: a key in the table but not in what was saved is new, and a saved key no longer in the table was deleted.",
+ ],
+ },
{
id: "websocket",
title: "Prices over a WebSocket",
From 8638fc550298c1db66ef0e0780290caf483e5f43 Mon Sep 17 00:00:00 2001
From: Claude
+
+
+ );
+}
+
function Source({ file }: { file: string }) {
const text = sources[`./recipes/${file}`] ?? "";
return (
@@ -40,7 +50,7 @@ function Source({ file }: { file: string }) {
-> ); @@ -80,17 +90,17 @@ function Cookbook() { The packages are on GitHub Packages. Put this{text}+
.npmrc beside your package.json (npm and Bun both read it), with a GitHub token that can read packages (a
classic token with read:packages):
- {install.npmrc}
- {install.react}
+
+
Bun reads the same .npmrc. If your project keeps its settings in bunfig.toml instead:
{install.bunfig}
+
The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
{install.vite}
- {install.css}
+
+
{recipes.map((r) => {
diff --git a/web/grid/package.json b/web/grid/package.json
index e8d33a8..5de669c 100644
--- a/web/grid/package.json
+++ b/web/grid/package.json
@@ -10,9 +10,11 @@
"dependencies": {
"@surefold/grid": "0.3.0",
"@surefold/grid-solid": "0.3.0",
+ "prismjs": "^1.30.0",
"solid-js": "^1.9.0"
},
"devDependencies": {
+ "@types/prismjs": "^1.26.5",
"typescript": "^5.8.0",
"vite": "^6.3.0",
"vite-plugin-solid": "^2.11.0"
diff --git a/web/grid/src/cookbook/cookbook.css b/web/grid/src/cookbook/cookbook.css
index 2a3b2d8..b77cb8e 100644
--- a/web/grid/src/cookbook/cookbook.css
+++ b/web/grid/src/cookbook/cookbook.css
@@ -4,6 +4,8 @@
:root {
--paper: #f2f5f4; --surface: #ffffff; --ink: #13242c; --muted: #56676e; --rule: #d3dcdc;
--water: #1d6c88; --bad: #b9541f; --code: #f7f9f9;
+ /* Code tokens. */
+ --tk-comment: #6a7a80; --tk-keyword: #8a3ab9; --tk-string: #2b7a3d; --tk-number: #b0521a; --tk-func: #1d6c88; --tk-type: #9a6700; --tk-tag: #b42d4f; --tk-attr: #6f4ac0; --tk-punct: #56676e;
--display: "Bricolage Grotesque", "Segoe UI", system-ui, sans-serif;
--body: "Figtree", "Segoe UI", system-ui, sans-serif;
--mono: "JetBrains Mono", ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
@@ -13,6 +15,7 @@
:root {
--paper: #0e161a; --surface: #142026; --ink: #e2eaeb; --muted: #94a4a9; --rule: #2a3c43;
--water: #63b4d0; --bad: #f0894a; --code: #101b20;
+ --tk-comment: #7d8f95; --tk-keyword: #d19af5; --tk-string: #8fd49e; --tk-number: #f5a46b; --tk-func: #6fc3e0; --tk-type: #e7c06a; --tk-tag: #f58aa6; --tk-attr: #b9a3f5; --tk-punct: #94a4a9;
color-scheme: dark;
}
}
@@ -66,3 +69,15 @@ button:hover:not(:disabled) { border-color: var(--water); }
button:disabled { opacity: 0.5; cursor: default; }
/* What a recipe sent to its API, newest first. */
.live pre.log { margin: 0; max-height: 140px; font-size: 12px; color: var(--muted); }
+
+/* Syntax highlighting: Prism's token classes. */
+pre .token.comment, pre .token.prolog { color: var(--tk-comment); font-style: italic; }
+pre .token.keyword, pre .token.boolean, pre .token.builtin { color: var(--tk-keyword); }
+pre .token.string, pre .token.template-string, pre .token.attr-value, pre .token.char { color: var(--tk-string); }
+pre .token.number, pre .token.constant { color: var(--tk-number); }
+pre .token.function, pre .token.method { color: var(--tk-func); }
+pre .token.class-name, pre .token.maybe-class-name, pre .token.table, pre .token.section { color: var(--tk-type); }
+pre .token.tag { color: var(--tk-tag); }
+pre .token.attr-name, pre .token.property, pre .token.key { color: var(--tk-attr); }
+pre .token.punctuation, pre .token.operator { color: var(--tk-punct); }
+pre .token.template-punctuation, pre .token.interpolation-punctuation { color: var(--tk-keyword); }
diff --git a/web/grid/src/cookbook/highlight.ts b/web/grid/src/cookbook/highlight.ts
new file mode 100644
index 0000000..6f4f2c2
--- /dev/null
+++ b/web/grid/src/cookbook/highlight.ts
@@ -0,0 +1,19 @@
+// Syntax highlighting for the cookbook's code, shared by the Solid and React
+// pages. Prism turns code into HTML with a span for each token; the colours
+// are in cookbook.css, for light and dark.
+
+import Prism from "prismjs";
+// Each grammar extends the ones before it, so the order matters.
+import "prismjs/components/prism-typescript";
+import "prismjs/components/prism-jsx";
+import "prismjs/components/prism-tsx";
+import "prismjs/components/prism-bash";
+import "prismjs/components/prism-ini";
+import "prismjs/components/prism-toml";
+
+export type Language = "tsx" | "typescript" | "bash" | "ini" | "toml";
+
+/** The code as HTML, its tokens in spans. Prism escapes the code itself. */
+export function highlight(code: string, language: Language): string {
+ return Prism.highlight(code, Prism.languages[language], language);
+}
diff --git a/web/grid/src/cookbook/main.tsx b/web/grid/src/cookbook/main.tsx
index 13131cd..6e7ccee 100644
--- a/web/grid/src/cookbook/main.tsx
+++ b/web/grid/src/cookbook/main.tsx
@@ -6,6 +6,7 @@ import { render } from "solid-js/web";
import "@surefold/grid/grid.css";
import "./cookbook.css";
import { install, recipes } from "./text";
+import { highlight, type Language } from "./highlight";
import { FirstGrid } from "./recipes/FirstGrid";
import { FromAnApi } from "./recipes/FromAnApi";
import { PagedApi } from "./recipes/PagedApi";
@@ -30,6 +31,15 @@ const live: Record
+
+
+ );
+}
+
function Source(props: { file: string }) {
const text = sources[`./recipes/${props.file}`] ?? "";
return (
@@ -39,7 +49,7 @@ function Source(props: { file: string }) {
-> ); @@ -75,17 +85,17 @@ function Cookbook() { The packages are on GitHub Packages. Put this{text}+
.npmrc beside your package.json (npm and Bun both read it), with a GitHub token that can read packages (a
classic token with read:packages):
- {install.npmrc}
- {install.solid}
+
+
Bun reads the same .npmrc. If your project keeps its settings in bunfig.toml instead:
{install.bunfig}
+
The engine is WebAssembly, loaded with a top-level await, so build for ES2022. With Vite:
{install.vite}
- {install.css}
+
+
{log.map((line, k) => (
diff --git a/web/grid/src/cookbook/recipes/EditAndSave.tsx b/web/grid/src/cookbook/recipes/EditAndSave.tsx
index f1d5462..540d852 100644
--- a/web/grid/src/cookbook/recipes/EditAndSave.tsx
+++ b/web/grid/src/cookbook/recipes/EditAndSave.tsx
@@ -1,16 +1,11 @@
import { createSignal, For, onCleanup, Show } from "solid-js";
-import { Table } from "@surefold/grid";
+import { Table, type Edits } from "@surefold/grid";
import { Grid } from "@surefold/grid-solid";
// DummyJSON answers a PATCH as if it had saved it, but keeps nothing: fetch again and the old values are back.
const API = "https://dummyjson.com/products";
-const FIELDS = ["title", "price", "stock"] as const;
type Product = { title: string; price: number; stock: number };
-
-/** What changed in a row since it was last saved: only the fields that differ. */
-function changes(now: Product, saved: Product): Partial {
- return Object.fromEntries(FIELDS.filter((f) => now[f] !== saved[f]).map((f) => [f, now[f]]));
-}
+type Field = keyof Product;
export function EditAndSave() {
const products = new Table({
@@ -18,72 +13,77 @@ export function EditAndSave() {
formulas: { value: "price * stock" },
totals: { stock: "sum", value: "sum" },
});
- // The rows as the server last had them, by key (the product's id).
+ onCleanup(() => products.dispose());
+ // The rows as the server last had them, and the fields people changed since, by key (the product's id).
const saved = new Map();
+ const changed = new Map>();
const [unsaved, setUnsaved] = createSignal<[string, Partial][]>([]);
const [saving, setSaving] = createSignal(false);
const [log, setLog] = createSignal([]);
const say = (line: string) => setLog((l) => [line, ...l].slice(0, 6));
+ const show = () => setUnsaved([...changed].map(([key, fields]) => [key, { ...fields }]));
- // After each recalculation that changed an input (a person typing, pasting,
- // filling a block or undoing), compare every row with what the server has.
- // Undoing back to the saved value makes a row clean again.
- function compare() {
- const dirty: [string, Partial][] = [];
- for (const [key, before] of saved) {
- const row = products.get(key);
- if (!row) continue;
- const diff = changes(row, before);
- if (Object.keys(diff).length) dirty.push([key, diff]);
+ // The grid says what a person changed: typing, pasting, filling a block,
+ // undoing. Changes made from code (loading, discarding) are not reported.
+ function onEdit(edits: Edits) {
+ for (const { key, column, after } of edits.cells) {
+ const field = column as Field; // only fields can be edited, never formulas
+ const fields = changed.get(key) ?? {};
+ // Back to what the server has (undone, or typed back): nothing to save.
+ if (after === saved.get(key)?.[field]) delete fields[field];
+ else Object.assign(fields, { [field]: after });
+ if (Object.keys(fields).length) changed.set(key, fields);
+ else changed.delete(key);
}
- setUnsaved(dirty);
+ show();
}
- const stop = products.watch((change) => change.inputsChanged && compare());
- onCleanup(() => {
- stop();
- products.dispose();
- });
async function load() {
const response = await fetch(`${API}?limit=12&select=title,price,stock`);
const { products: list } = (await response.json()) as { products: (Product & { id: number })[] };
for (const { id, title, price, stock } of list) {
- saved.set(String(id), { title, price, stock }); // first, so the rows are clean when they arrive
+ saved.set(String(id), { title, price, stock });
products.put(String(id), { title, price, stock });
}
}
load().catch((e: Error) => say(`Could not load: ${e.message}`));
- // One PATCH a changed row, with only its changed fields. A row that saves is
- // clean from then on; one that fails stays unsaved, to try again.
+ // One PATCH a changed row, with only its changed fields. A row that fails
+ // stays unsaved, to try again; a field changed again while saving stays too.
async function save() {
setSaving(true);
await Promise.all(
- unsaved().map(async ([key, diff]) => {
+ [...changed].map(async ([key, fields]) => {
+ const sent = { ...fields };
try {
const response = await fetch(`${API}/${key}`, {
method: "PATCH",
headers: { "Content-Type": "application/json" },
- body: JSON.stringify(diff),
+ body: JSON.stringify(sent),
});
if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
- // What was sent is now the server's. (An edit made while saving stays unsaved.)
- saved.set(key, { ...saved.get(key)!, ...diff });
- say(`PATCH /products/${key} ${JSON.stringify(diff)} → saved`);
+ saved.set(key, { ...saved.get(key)!, ...sent });
+ const now = changed.get(key) ?? {};
+ for (const field of Object.keys(sent) as Field[]) if (now[field] === sent[field]) delete now[field];
+ if (!Object.keys(now).length) changed.delete(key);
+ say(`PATCH /products/${key} ${JSON.stringify(sent)} → saved`);
} catch (e) {
say(`PATCH /products/${key} failed (${(e as Error).message}); still unsaved`);
}
}),
);
setSaving(false);
- compare();
+ show();
}
- // Put the server's values back, as one batch: one recalculation, one step to undo.
+ // Put the server's values back, as one batch. Changes from code are not
+ // reported to onEdit, so forget the unsaved ones here.
function discard() {
products.batch(() => {
- for (const [key] of unsaved()) products.put(key, saved.get(key)!);
+ for (const key of changed.keys()) products.put(key, saved.get(key)!);
});
+ changed.clear();
+ show();
}
return (
@@ -97,11 +97,17 @@ export function EditAndSave() {
- Unsaved: {unsaved().map(([key, diff]) => `#${key} ${Object.keys(diff).join(", ")}`).join(" · ")}
+ Unsaved: {unsaved().map(([key, fields]) => `#${key} ${Object.keys(fields).join(", ")}`).join(" · ")}
{(line) => {line}}
diff --git a/web/grid/src/cookbook/text.ts b/web/grid/src/cookbook/text.ts
index 3ea6a3d..bb91717 100644
--- a/web/grid/src/cookbook/text.ts
+++ b/web/grid/src/cookbook/text.ts
@@ -61,16 +61,17 @@ export const recipes: Recipe[] = [
id: "save",
title: "Edit and save back to an API",
intro: [
- "People edit in the grid itself: double-click a cell or press Enter, paste from a spreadsheet, fill a block with ⌘Enter, and undo with ⌘Z. Each edit goes to the table and recalculates what it feeds. " +
- "To save, keep what the server last had, and after each recalculation that changed an input, compare the rows with it. What differs is unsaved, however it was edited, and undoing back to the saved value makes a row clean again.",
- "Saving sends one PATCH a changed row, with only its changed fields. Edit some titles, prices or stock, then save. DummyJSON answers as if it had saved, but keeps nothing.",
+ "People edit in the grid itself: double-click a cell or press Enter, paste from a spreadsheet, fill a block with ⌘Enter, and undo with ⌘Z. " +
+ "The grid's onEdit says what they changed: each cell, with what it held before and after, and whether it was typed, pasted, filled, undone or deleted. " +
+ "Changes made from code (put, set, loading, discarding) are not reported, so what onEdit hears is what needs saving.",
+ "Keep what the server last had, so an edit undone or typed back to it stops counting. Saving sends one PATCH a changed row, with only its changed fields. Edit some titles, prices or stock, then save. DummyJSON answers as if it had saved, but keeps nothing.",
],
notes: [
- "watch says what each recalculation did. inputsChanged is more than 0 when cells were set, so sorting and filtering do not start a compare.",
- "Comparing every row costs a get a row: right for hundreds of rows. For many thousands, compare only the rows on screen, or keep the keys your own code and the server touch.",
- "A row that fails to save stays unsaved, so pressing Save again retries it. An edit made while a save is on its way also stays unsaved, because only what was sent is marked as saved.",
- "To save as people type, call the same save from watch, after a pause of a second or so with no edits.",
- "New rows (POST) and deleted rows (DELETE) work the same way: a key in the table but not in what was saved is new, and a saved key no longer in the table was deleted.",
+ "onEdit gets { cause, cells, removed }: cause is \"edit\", \"paste\", \"fill\", \"undo\", \"redo\" or \"delete\"; each cell is { key, column, before, after }; removed is the keys of deleted rows.",
+ "It costs only what was edited, so it suits a table of any size, in the page or in a worker. With a WorkerTable it is called once the worker has made the change.",
+ "A row that fails to save stays unsaved, so pressing Save again retries it. A field changed again while a save is on its way also stays unsaved, because only what was sent is marked as saved.",
+ "To save as people type, call the same save from onEdit, after a pause of a second or so with no edits.",
+ "Deleted rows come in removed, for a DELETE each; new rows are ones your code puts, so it knows to POST them.",
],
},
{
From f78d39cf5817fc561919e0cf5c5bf3279c6c8d72 Mon Sep 17 00:00:00 2001
From: Claude
Date: Mon, 16 Nov 2026 09:26:57 +0000
Subject: [PATCH 08/13] Grid packages 0.4.0
@surefold/grid, grid-solid and grid-react at 0.4.0, for the tag that
publishes them: the grid's onEdit says what a person edited (cells with
their values before and after, and deleted rows), and RemoteEngine.setCells
gives way to RemoteEngine.sequence.
Co-Authored-By: Claude Opus 5.5
Claude-Session: https://claude.ai/code/session_01AdzBXcxXfE7iKtPMVoTTfr
---
package-lock.json | 18 +++++++++---------
packages/grid-react/package.json | 4 ++--
packages/grid-solid/package.json | 4 ++--
packages/grid/package.json | 2 +-
web/grid-react/package.json | 4 ++--
web/grid/package.json | 4 ++--
6 files changed, 18 insertions(+), 18 deletions(-)
diff --git a/package-lock.json b/package-lock.json
index 65cd5db..a99b0be 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -2082,15 +2082,15 @@
},
"packages/grid": {
"name": "@surefold/grid",
- "version": "0.3.0",
+ "version": "0.4.0",
"license": "Apache-2.0"
},
"packages/grid-react": {
"name": "@surefold/grid-react",
- "version": "0.3.0",
+ "version": "0.4.0",
"license": "Apache-2.0",
"dependencies": {
- "@surefold/grid": "^0.3.0"
+ "@surefold/grid": "^0.4.0"
},
"peerDependencies": {
"react": "^18.2 || ^19"
@@ -2098,10 +2098,10 @@
},
"packages/grid-solid": {
"name": "@surefold/grid-solid",
- "version": "0.3.0",
+ "version": "0.4.0",
"license": "Apache-2.0",
"dependencies": {
- "@surefold/grid": "^0.3.0"
+ "@surefold/grid": "^0.4.0"
},
"peerDependencies": {
"solid-js": "^1.8"
@@ -2110,8 +2110,8 @@
"web/grid": {
"name": "watershed-grid-site",
"dependencies": {
- "@surefold/grid": "0.3.0",
- "@surefold/grid-solid": "0.3.0",
+ "@surefold/grid": "0.4.0",
+ "@surefold/grid-solid": "0.4.0",
"prismjs": "^1.30.0",
"solid-js": "^1.9.0"
},
@@ -2125,8 +2125,8 @@
"web/grid-react": {
"name": "watershed-grid-react-example",
"dependencies": {
- "@surefold/grid": "0.3.0",
- "@surefold/grid-react": "0.3.0",
+ "@surefold/grid": "0.4.0",
+ "@surefold/grid-react": "0.4.0",
"prismjs": "^1.30.0",
"react": "^19.1.0",
"react-dom": "^19.1.0"
diff --git a/packages/grid-react/package.json b/packages/grid-react/package.json
index 3671300..9129a8e 100644
--- a/packages/grid-react/package.json
+++ b/packages/grid-react/package.json
@@ -1,6 +1,6 @@
{
"name": "@surefold/grid-react",
- "version": "0.3.0",
+ "version": "0.4.0",
"description": "The watershed grid as a React component, and hooks that follow its totals.",
"license": "Apache-2.0",
"homepage": "https://surefold.dev/watershed/grid/",
@@ -28,7 +28,7 @@
"react": "^18.2 || ^19"
},
"dependencies": {
- "@surefold/grid": "^0.3.0"
+ "@surefold/grid": "^0.4.0"
},
"scripts": {
"build": "rm -rf dist && tsc -p tsconfig.build.json",
diff --git a/packages/grid-solid/package.json b/packages/grid-solid/package.json
index b8cccd6..3aeeb0e 100644
--- a/packages/grid-solid/package.json
+++ b/packages/grid-solid/package.json
@@ -1,6 +1,6 @@
{
"name": "@surefold/grid-solid",
- "version": "0.3.0",
+ "version": "0.4.0",
"description": "The watershed grid as a Solid component, and its totals as signals.",
"license": "Apache-2.0",
"homepage": "https://surefold.dev/watershed/grid/",
@@ -28,7 +28,7 @@
"solid-js": "^1.8"
},
"dependencies": {
- "@surefold/grid": "^0.3.0"
+ "@surefold/grid": "^0.4.0"
},
"scripts": {
"build": "rm -rf dist && tsc -p tsconfig.build.json",
diff --git a/packages/grid/package.json b/packages/grid/package.json
index f62ff46..17070f0 100644
--- a/packages/grid/package.json
+++ b/packages/grid/package.json
@@ -1,6 +1,6 @@
{
"name": "@surefold/grid",
- "version": "0.3.0",
+ "version": "0.4.0",
"description": "A data grid whose rows, formulas and totals are worked out incrementally by the watershed engine, in WebAssembly.",
"license": "Apache-2.0",
"homepage": "https://surefold.dev/watershed/grid/",
diff --git a/web/grid-react/package.json b/web/grid-react/package.json
index 416d0eb..15a5f8b 100644
--- a/web/grid-react/package.json
+++ b/web/grid-react/package.json
@@ -8,8 +8,8 @@
"check": "tsc --noEmit -p ."
},
"dependencies": {
- "@surefold/grid": "0.3.0",
- "@surefold/grid-react": "0.3.0",
+ "@surefold/grid": "0.4.0",
+ "@surefold/grid-react": "0.4.0",
"prismjs": "^1.30.0",
"react": "^19.1.0",
"react-dom": "^19.1.0"
diff --git a/web/grid/package.json b/web/grid/package.json
index 5de669c..c758512 100644
--- a/web/grid/package.json
+++ b/web/grid/package.json
@@ -8,8 +8,8 @@
"check": "tsc --noEmit -p ."
},
"dependencies": {
- "@surefold/grid": "0.3.0",
- "@surefold/grid-solid": "0.3.0",
+ "@surefold/grid": "0.4.0",
+ "@surefold/grid-solid": "0.4.0",
"prismjs": "^1.30.0",
"solid-js": "^1.9.0"
},
From 7aa79ad9262426ef1a48b5c62fd8b4d220608e82 Mon Sep 17 00:00:00 2001
From: Claude
Date: Mon, 16 Nov 2026 09:45:37 +0000
Subject: [PATCH 09/13] The cookbook pages' heading is in their HTML
Each cookbook page's header (its one h1, the intro and the Solid/React
switch) is now in the page's HTML rather than drawn by its script, which
renders the recipes under it. So the heading shows before the script runs,
and the page passes surefold.dev's site checker, which reads the HTML for
one h1, a title, a language and a description.
Co-Authored-By: Claude Opus 5.5
Claude-Session: https://claude.ai/code/session_01AdzBXcxXfE7iKtPMVoTTfr
---
charts-dark.png | Bin 0 -> 118960 bytes
charts-light.png | Bin 0 -> 117715 bytes
mobile.png | Bin 0 -> 92486 bytes
top-dark.png | Bin 0 -> 132517 bytes
top-light.png | Bin 0 -> 131812 bytes
web/grid-react/cookbook/index.html | 12 +++++++++++-
web/grid-react/src/cookbook/main.tsx | 20 ++++----------------
web/grid/cookbook/index.html | 11 +++++++++++
web/grid/src/cookbook/main.tsx | 20 ++++----------------
9 files changed, 30 insertions(+), 33 deletions(-)
create mode 100644 charts-dark.png
create mode 100644 charts-light.png
create mode 100644 mobile.png
create mode 100644 top-dark.png
create mode 100644 top-light.png
diff --git a/charts-dark.png b/charts-dark.png
new file mode 100644
index 0000000000000000000000000000000000000000..15fe4df16e27b028b063df53fc44e3247d8ab174
GIT binary patch
literal 118960
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