@sheetpane/grid 0.0.0-stage → 0.1.0

package/dist/llms.txt

@@ -0,0 +1,111 @@
+# sheetpane
+
+> View, edit and review .xlsx and .csv files inside any web page: two web components — <sheetpane-excel> (the sheet, View or Edit) and <sheetpane-errors> (the review list) — kept in sync through one in-memory workbook per `pane`, an export that writes every change into a copy of the upload, eight optional plugins, column rules and a JSON rules file. Nothing is uploaded. Version 0.1.0.
+
+Every rule lives in one standing record; READMEs and skills point to them. The full text of everything below is in llms-full.txt.
+
+## Start
+- [sheetpane](https://github.com/arpitarya/sheetpane/blob/v0.1.0/README.md): what it is, the packages, try it
+- [@sheetpane/grid](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/README.md): the elements: attributes, properties, events, column rules, rules file, React hooks, styling
+- [Architecture](https://github.com/arpitarya/sheetpane/blob/v0.1.0/docs/ARCHITECTURE.md): packages, elements, the one workbook, the flows
+- [Changelog](https://github.com/arpitarya/sheetpane/blob/v0.1.0/CHANGELOG.md): what changed, breaking changes first
+
+## Try it
+- [Live playground](https://arpitarya.github.io/sheetpane/): the plugin gallery in plain HTML; `/react/` in React (deployed from each release)
+- [Starters](https://github.com/arpitarya/sheetpane/blob/v0.1.0/examples/starters/README.md): each create-sheetpane template, with an Open in StackBlitz link
+- [create-sheetpane](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/create-sheetpane/README.md): `npm create sheetpane@latest`: a working app in one command
+
+## Elements
+- [SR-GRID](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0105_GRID.md): the sheet, the store, the plugin host, events, rules, test hooks
+- [SR-ERRORS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0106_ERRORS.md): the error list and the New error form
+- [custom-elements.json](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/custom-elements.json): both elements as a Custom Elements Manifest: attributes, properties, methods, events with payload types, slots, parts, --sp-* properties
+- [Vue, Svelte, Solid, Angular](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/README.md#vue-svelte-solid-angular): the elements in each framework; typings @sheetpane/grid/jsx, /vue, /svelte, /solid
+- [@sheetpane/import](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/import/README.md): read .xlsx / .csv into a JavaScript workbook
+- [@sheetpane/export](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/export/README.md): write .xlsx / .csv, patch the original, download()
+
+## Plugins
+- [@sheetpane/numfmt](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/numfmt/README.md): Excel number formats for sheetpane — currency, dates, fractions, elapsed time, conditional sections, locales — as a plugin on the `format` hook.
+- [@sheetpane/formulas](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/formulas/README.md): Formula recalculation for sheetpane — edit a cell and every dependent formula updates — as a plugin on the `derive` hook, backed by IronCalc (WASM, lazy-loaded).
+- [@sheetpane/styles](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/styles/README.md): Cell styles for sheetpane — fill, bold, italic, underline, strikethrough, colour, size, borders, alignment, wrap — as a plugin on the `decorate` hook. Never a font family (SR-LAW-5): the host's font is the font.
+- [@sheetpane/validation](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/validation/README.md): The workbook's own data-validation rules, checked when the file loads and after every edit. Each cell that breaks a rule shows up as a warning in `<sheetpane-errors>`.
+- [@sheetpane/condfmt](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/condfmt/README.md): Conditional formatting for sheetpane — the file's own `<conditionalFormatting>` rules drawn as Excel draws them: value and text rules, duplicates, top / bottom, averages, colour scales, data bars and formula rules — as a plugin on the `decorate` hook, after `@sheetpane/styles`. Render only: nothing here writes a rule.
+- [@sheetpane/images](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/images/README.md): Images for sheetpane — pictures anchored in the sheet drawn in sheet space through the `overlay` hook; view only, kept on export.
+- [@sheetpane/charts](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/charts/README.md): Charts for sheetpane — each chart in a workbook shown at its anchor: a frame with its title, type, series count and Show source cells (stage 1), drawn as our own SVG for bar, column, line, pie and scatter (stage 2) — through the `overlay` hook.
+- [@sheetpane/comments](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/comments/README.md): Excel's comments and sheetpane's errors, in both directions. When a file loads, its notes and threaded comments show up in `<sheetpane-errors>`. When you export, every error in the review goes into the file as an Excel threaded comment on its cell.
+- [@sheetpane/visibility](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/visibility/README.md): Hide and unhide rows, columns and sheets in `<sheetpane-excel>` — as changes, written into the download.
+
+## Rules and errors
+- [Column rules](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/README.md#column-rules): checks by column title in code
+- [Rules file](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/README.md#rules-file): valid and invalid values as JSON, rules-src, flagging="off"
+- [rules.schema.json](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/grid/rules.schema.json): the rules file's JSON Schema
+- [Error codes](https://github.com/arpitarya/sheetpane/blob/v0.1.0/docs/ERRORS.md): every SP-xxxx code: meaning, cause, fix
+
+## Testing and tooling
+- [@sheetpane/testing](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/testing/README.md): Playwright and Vitest helpers for host apps
+- [@sheetpane/fixtures](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/fixtures/README.md): known workbooks with a manifest
+- [create-sheetpane](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/create-sheetpane/README.md): npm create sheetpane — a working app in vanilla, React, Next.js, Vue, Angular or Svelte
+
+## Skills
+- [@sheetpane/skills](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/README.md): npx sheetpane-skills install — skills for Claude Code, Kiro and Codex
+- [@sheetpane/mcp](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/mcp/README.md): npx -y @sheetpane/mcp — an MCP server: describe the API, inspect a workbook, draft and check a rules file, explain an SP code, find a skill
+- [sheetpane](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane/SKILL.md): Use first for any sheetpane task in a host app - a decision table pointing to the right sheetpane skill (embedding, loading, errors, events, rules, plugins, theming, testing, frameworks, troubleshooting). Not needed once you know which skill applies.
+- [sheetpane-a11y](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-a11y/SKILL.md): Use when making a host's sheetpane page accessible - the grid's keyboard contract, labelling the host tab or dialog, focus when the pop-up closes, colour never alone. Not for the grid's own internals.
+- [sheetpane-backend](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-backend/SKILL.md): Use when a host saves the reviewed file and the review on a server and restores them later - the exported blob, getErrors()/setErrors() JSON, restoring after sheetpane-load, a file that changed since. Not for client-only use.
+- [sheetpane-column-rules](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-column-rules/SKILL.md): Use when the host checks what users type by column title in code - columns, validate(ctx, signal), on-invalid flag or block, header-row. Not for rules shipped as a JSON file (sheetpane-rules-file) or the workbook's own validation (sheetpane-plugins).
+- [sheetpane-embed](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-embed/SKILL.md): Use when placing <sheetpane-excel> and <sheetpane-errors> on a page - tab or pop-up, linking them by pane, giving the sheet a height, the host's font. Not for React specifics (sheetpane-react) or loading and saving files (sheetpane-load-export).
+- [sheetpane-errors](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-errors/SKILL.md): Use for the review list - <sheetpane-errors>, the SheetpaneError schema, getErrors()/setErrors(), sheetpane-errors and sheetpane-reveal, error types. Not for rule-made errors (sheetpane-column-rules) or server storage (sheetpane-backend).
+- [sheetpane-events](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-events/SKILL.md): Use when a host reacts to what the user does in the sheet - selection, typing, saving, cancelling, refusing a value with sheetpane-beforechange, or switching sheets. Not for column checks (sheetpane-column-rules) or the error list (sheetpane-errors).
+- [sheetpane-file-work-item](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-file-work-item/SKILL.md): Use when contributing to the sheetpane repo and filing a new work item W-nn - the next free id, the item file, its OPEN-WORK row and ball, the worklog and NOW. Not for host apps that use sheetpane.
+- [sheetpane-frameworks](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-frameworks/SKILL.md): Use when embedding sheetpane in Vue, Svelte, Solid, Angular, Next.js or plain HTML with typed props and events - the custom-element setup, @sheetpane/grid/vue|svelte|solid typings, editor data. Not for React (sheetpane-react).
+- [sheetpane-load-export](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-load-export/SKILL.md): Use when opening a file in the sheet (src, file, load()) or getting it back (the Download button, export(), sheetpane-export, download()). Not for saving the review (sheetpane-errors, sheetpane-backend) or no-UI read/write (sheetpane-setup).
+- [sheetpane-migrate](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-migrate/SKILL.md): Use when replacing SheetJS, Handsontable or AG Grid with sheetpane - their concepts mapped to sheetpane's elements, events and plugins, and what has no equivalent. Not for a fresh project (sheetpane-setup).
+- [sheetpane-performance](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-performance/SKILL.md): Use when a host deals with large workbooks - what loads fast, how rule checks are sliced, lazy-mounting several sheets, what to measure on your own machine and data. Not for small files, which need nothing special.
+- [sheetpane-plugin-author](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-plugin-author/SKILL.md): Use when writing a sheetpane plugin - the six hooks, the slots and control descriptors, exportOptions, registerPlugin, what a plugin may never do. Not for choosing among the shipped plugins (sheetpane-plugins).
+- [sheetpane-plugins](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-plugins/SKILL.md): Use when a host needs more than review - number formats, live formulas, cell styles, data validation, conditional formats, pictures, charts or comments - and must pick and enable plugins. Not for writing a plugin (sheetpane-plugin-author).
+- [sheetpane-react](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-react/SKILL.md): Use when sheetpane is used from React 18 or 19 - props and onsheetpane-* events on the custom elements, refs, the copy-in hook recipes, JSX typing. Not for plain HTML (sheetpane-embed) or Vue, Angular, Svelte, Next.js (sheetpane-frameworks).
+- [sheetpane-records](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-records/SKILL.md): Use when contributing to the sheetpane repo and a change touches a rule - finding the record that owns a module, the laws, the commit guard, where a rule lives, archive-is-not-evidence. Not for host apps.
+- [sheetpane-rules](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-rules/SKILL.md): The /sheetpane-rules [workbook or rules file] command - drafts a rules file for a workbook, or fixes one, then runs sheetpane-skills check-rules until it is clean. Not for learning the format (sheetpane-rules-file) or rules in code.
+- [sheetpane-rules-file](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-rules-file/SKILL.md): Use when valid and invalid values ship as a JSON file per sheet, column or cell, checked on load and listed only in the errors panel - rules / rules-src, its JSON Schema, flagging="off". Not for rules written in code (sheetpane-column-rules).
+- [sheetpane-security](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-security/SKILL.md): Use when sheetpane handles untrusted uploads or runs under a strict CSP - what the grid reads and never sends, regexes in rules, CSV formula injection, sandboxed iframes, styles in shadow DOM. Not for general web security.
+- [sheetpane-setup](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-setup/SKILL.md): Use when adding sheetpane to a project - which @sheetpane packages to install, a bundler import or a plain-HTML import map, one version for all. Not for placing the elements (sheetpane-embed) or choosing plugins (sheetpane-plugins).
+- [sheetpane-test](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-test/SKILL.md): The /sheetpane-test [workbook] command - writes one end-to-end test for a host page with sheetpane - load the .xlsx or .csv (or a fixture), edit a cell, read the download. Not for the testing techniques themselves (sheetpane-testing).
+- [sheetpane-testing](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-testing/SKILL.md): Use when writing end-to-end or browser tests for a host app that embeds sheetpane - reaching cells in shadow DOM, waiting for sheetpane-load, editing, reading a downloaded .xlsx back, known fixture files. Not for testing sheetpane itself.
+- [sheetpane-theming](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-theming/SKILL.md): Use when matching sheetpane to a host's look - dark mode via theme, the --sp-* colour tokens, style.css, why no font is set. Not for a workbook's own colours (sheetpane-plugins - styles, condfmt).
+- [sheetpane-troubleshoot](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-troubleshoot/SKILL.md): Use when sheetpane misbehaves in a host - a blank grid, a file refused, an SP-xxxx code in the console, SSR crashes, CORS on src, copy not working, rules errors that look wrong. Not for designing a feature.
+- [sheetpane-upgrade](https://github.com/arpitarya/sheetpane/blob/v0.1.0/packages/skills/skills/sheetpane-upgrade/SKILL.md): Use when moving a host to a newer sheetpane version - reading CHANGELOG.md, the lockstep version rule, removed or renamed controls and events, re-checking a host's tests. Not for first-time setup (sheetpane-setup).
+
+## Records
+- [The register](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/README.md): every record, its state and what it owns
+- [SR-LAWS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0001_LAWS.md): Assigns the handles L0, L1, … and routes each to the record that states it. This record states no law itself.
+- [SR-LAW-0](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0002_LAW-0-authority.md): Every rule is stated in exactly one record; every other artifact links to it; Law records outrank every other record; a Law changes only on the decider's ruling.
+- [SR-LAW-1](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0003_LAW-1-retired-records-archived.md): A retired record moves to archive/records/ in the same change, with a map row, status archived and a dated banner; from then on it is named, never cited.
+- [SR-LAW-2](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0004_LAW-2-foss-dependencies.md): Every dependency sheetpane declares or pulls in — runtime, peer, optional, dev and transitive — is released under a free and open source licence.
+- [SR-LAW-3](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0005_LAW-3-xlsx-and-csv-only.md): sheetpane opens, views, edits and saves exactly two file formats — XLSX and CSV; every other spreadsheet format is out of scope until the decider rules otherwise.
+- [SR-LAW-4](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0006_LAW-4-web-component.md): sheetpane ships as a standards-based web component — a custom element any framework, or none, can use — and is never tied to one framework.
+- [SR-LAW-5](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0007_LAW-5-host-font.md): sheetpane ships no font of its own: by default it renders in the browser's default font, and when the host application sets a font, every part of sheetpane uses it.
+- [SR-LAW-6](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0008_LAW-6-edits-in-memory-export-with-changes.md): Once a workbook is loaded, every change made to it is held in memory, and an export produces the workbook with every change applied.
+- [SR-LAW-7](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0009_LAW-7-surfaces-always-in-sync.md): The view, edit and error components always show the same workbook: a change in any one appears in the others at once, with no refresh or save.
+- [SR-LAW-8](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0010_LAW-8-npm-package.md): sheetpane is distributed as an npm package: published to the npm registry, installed with npm or any npm-compatible client, and imported as a module.
+- [SR-LAW-9](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0011_LAW-9-memory-is-a-javascript-object.md): Wherever a record says memory, it means JavaScript objects held in the page; no browser storage or database is memory, until the decider rules otherwise.
+- [SR-DOWNLOAD](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0101_DOWNLOAD.md): One function, download(data, filename, options?), turns what @sheetpane/export produces into a file the browser saves — .xlsx or .csv only, bytes unchanged, errors never silent.
+- [SR-BUILD](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0102_BUILD.md): How the monorepo installs, type-checks, builds, tests, runs in CI and publishes every package under packages/ at one version.
+- [SR-EXPORT](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0103_EXPORT.md): A plain Workbook object in, .xlsx bytes or .csv text out; patchXlsx rewrites only the changed cells of the uploaded file; no runtime dependencies.
+- [SR-IMPORT](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0104_IMPORT.md): The reader: extension and magic bytes checked, .xlsx through the ZIP walk and DOMParser, .csv through a state machine; raw values beside display text; the parsed tables plugins read.
+- [SR-GRID](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0105_GRID.md): One in-memory workbook per pane that every element reads and writes; the sheet element that views and edits it; six hooks and six slots for plugins; one undo stack per pane; freeze panes in the core grid.
+- [SR-ERRORS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0106_ERRORS.md): The error component reads and writes the pane's one workbook: a filterable list, the form Flag issue opens, Show in sheet, read-only sign-off — no private copy, no linked chip, no export footer.
+- [SR-IMAGES](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0107_IMAGES.md): A view-only plugin that draws each picture a sheet's drawing anchors at its place in the grid, decoding media lazily from the package, with the anchor arithmetic @sheetpane/charts reuses.
+- [SR-VALIDATION](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0108_VALIDATION.md): A plugin on the validate hook that checks the workbook's <dataValidations> on load and after every edit, writing one workbook-authored warning per failing cell, with a list arrow for list rules.
+- [SR-NUMFMT](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0109_NUMFMT.md): A plugin on the format hook that shows every numeric cell as Excel would — every built-in and custom code, locales, 1904 — with a format dropdown in Edit and the new formats written back on export.
+- [SR-STYLES](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0110_STYLES.md): A plugin on the decorate hook that draws each cell's fill, font weight, style, size, colour, decoration, borders and alignment from the workbook — never a font family — with a format row in Edit and the changes written into styles.xml on export.
+- [SR-FORMULAS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0111_FORMULAS.md): A plugin on the derive and exportPatch hooks that recalculates formulas with IronCalc (WASM, loaded on the first formula), marks the cells it changed, and writes typed formulas and new cached values on export.
+- [SR-COMMENTS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0112_COMMENTS.md): A plugin on the validate and exportPatch hooks: a workbook's notes and threaded comments arrive as read-only file errors, and an export writes every review error as an Excel threaded comment (with its legacy note and VML) at its cell — on by default, switchable off.
+- [SR-CHARTS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0113_CHARTS.md): An overlay plugin that shows every chart at its anchor — a frame with title, type, series and Show source cells, then an SVG drawing for bar, column, line, pie, doughnut and scatter — from the chart's cached values, or the live cells when a formula plugin is installed; export copies charts untouched.
+- [SR-CONDFMT](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0114_CONDFMT.md): A decorate plugin, ordered after styles, that draws the conditional formats a workbook carries — cell rules, text rules, duplicates, top/bottom, averages, colour scales, data bars and expressions — live as cells change; render only, with a hover legend and a rule count.
+- [SR-FIXTURES](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0115_FIXTURES.md): A dependency-free package of hand-built test workbooks — the showcase, its rules sample, edge cases, CSV dialects — with a manifest of what each holds and url / path / bytes to reach them from any runner.
+- [SR-SKILLS](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0116_SKILLS.md): A leaf package of 23 Markdown skills, entry files and a no-dependency installer that copies them where each coding agent looks; every sheetpane package depends on it; a drift check keeps the skills true to the code.
+- [SR-CODES](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0117_CODES.md): Every throw, console warning, rules-engine note, refused load and blocked edit carries a permanent SP-xxxx code from one registry in @sheetpane/export, with an entry in docs/ERRORS.md; a test fails on any message without one.
+- [SR-TESTING](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0118_TESTING.md): One driver API for Playwright and Vitest browser mode — locators, actions, Download read back as values, matchers — built only on the grid's committed test hooks.
+- [SR-MCP](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0119_MCP.md): A stdio MCP server, hand-written, tools only: describe the API, inspect a workbook, draft and check a rules file, explain an SP code, find a skill — deterministic and read-only.
+- [SR-CREATE](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0120_CREATE.md): npm create sheetpane — six framework templates with the grid, the errors panel, the showcase and its rules file, one test, the skills and the MCP server; checked end to end in CI.
+- [SR-VISIBILITY](https://github.com/arpitarya/sheetpane/blob/v0.1.0/records/0121_VISIBILITY.md): The plugin that lets an editor hide and unhide rows, columns and sheets and group outlines — menus, Google Sheets' keys, a marker click — written into the download. Seeing the file's hiding is core (SR-GRID 21c).
+

package/dist/pane/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/pane/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pane/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/pane/index.js

@@ -0,0 +1,3 @@
+// pane — the shared in-memory workbook; not built yet. Spec: work/open/W-01-sheetpane-excel.md
+export {};
+//# sourceMappingURL=index.js.map

package/dist/pane/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pane/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,CAAC"}

package/dist/pane/registry.d.ts

@@ -0,0 +1,33 @@
+import { type WorkbookStore } from './store.js';
+/**
+ * The store for a pane id, created on first use; the elements call it when they connect
+ * (SR-GRID decision 1). A later caller naming other plugins gets a console warning (SP-3011).
+ * @param id - The `pane` attribute's value.
+ * @param el - The element taking a hold on the store; {@link releasePane} drops it.
+ * @param plugins - Registered plugin ids; they apply only when this call creates the store — the set is fixed per pane.
+ * @returns The pane's store.
+ */
+export declare function acquirePane(id: string, el: Element, plugins: readonly string[]): WorkbookStore;
+/**
+ * Drops an element's hold on a pane; the store goes when the last element releases it.
+ * @param id - The pane id.
+ * @param el - The element that acquired it.
+ */
+export declare function releasePane(id: string, el: Element): void;
+/**
+ * The live store of a pane, if any element holds it — for a host or a test to read or drive.
+ * @param id - The `pane` attribute's value.
+ * @returns The pane's store, or undefined when no connected element names that pane.
+ * @example
+ * ```ts
+ * import { paneStore } from '@sheetpane/grid';
+ * const book = paneStore('q3');
+ * if (book) console.log(book.changeCount, book.getErrors().length);
+ * ```
+ */
+export declare function paneStore(id: string): WorkbookStore | undefined;
+/** Elements attached to a store, in connection order: events nobody owns go out on the first sheet, else the first element. */
+export declare function attach(store: WorkbookStore, el: Element): void;
+export declare function detach(store: WorkbookStore, el: Element): void;
+export declare function isPrimary(store: WorkbookStore, el: Element): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/pane/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/pane/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAU9F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAKzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE/D;AAED,+HAA+H;AAC/H,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAI9D;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAG9D;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAIpE"}

package/dist/pane/registry.js

@@ -0,0 +1,73 @@
+// One store per `pane` id, shared by every element that names it (contract
+// verdict decision 1): created by the first element that asks, released when
+// the last one disconnects. Elements without a pane get a private store.
+import { spMessage } from '@sheetpane/export';
+import { pluginsFromIds } from '../plugins/host.js';
+import { createWorkbook } from './store.js';
+const panes = new Map();
+const attached = new WeakMap();
+/**
+ * The store for a pane id, created on first use; the elements call it when they connect
+ * (SR-GRID decision 1). A later caller naming other plugins gets a console warning (SP-3011).
+ * @param id - The `pane` attribute's value.
+ * @param el - The element taking a hold on the store; {@link releasePane} drops it.
+ * @param plugins - Registered plugin ids; they apply only when this call creates the store — the set is fixed per pane.
+ * @returns The pane's store.
+ */
+export function acquirePane(id, el, plugins) {
+    let e = panes.get(id);
+    if (!e) {
+        e = { store: createWorkbook({ plugins: pluginsFromIds(plugins) }), users: new Set(), plugins: plugins.join(' ') };
+        panes.set(id, e);
+    }
+    else if (plugins.length && plugins.join(' ') !== e.plugins) {
+        console.warn(spMessage('SP-3011', `sheetpane: pane "${id}" already runs plugins "${e.plugins}"; "${plugins.join(' ')}" on a later element is ignored (the set is fixed per pane)`));
+    }
+    e.users.add(el);
+    return e.store;
+}
+/**
+ * Drops an element's hold on a pane; the store goes when the last element releases it.
+ * @param id - The pane id.
+ * @param el - The element that acquired it.
+ */
+export function releasePane(id, el) {
+    const e = panes.get(id);
+    if (!e)
+        return;
+    e.users.delete(el);
+    if (!e.users.size)
+        panes.delete(id);
+}
+/**
+ * The live store of a pane, if any element holds it — for a host or a test to read or drive.
+ * @param id - The `pane` attribute's value.
+ * @returns The pane's store, or undefined when no connected element names that pane.
+ * @example
+ * ```ts
+ * import { paneStore } from '@sheetpane/grid';
+ * const book = paneStore('q3');
+ * if (book) console.log(book.changeCount, book.getErrors().length);
+ * ```
+ */
+export function paneStore(id) {
+    return panes.get(id)?.store;
+}
+/** Elements attached to a store, in connection order: events nobody owns go out on the first sheet, else the first element. */
+export function attach(store, el) {
+    const l = attached.get(store) ?? [];
+    if (!l.includes(el))
+        l.push(el);
+    attached.set(store, l);
+}
+export function detach(store, el) {
+    const l = attached.get(store);
+    if (l)
+        attached.set(store, l.filter((x) => x !== el));
+}
+export function isPrimary(store, el) {
+    const l = attached.get(store) ?? [];
+    const first = l.find((x) => x.localName === 'sheetpane-excel') ?? l[0];
+    return first === el;
+}
+//# sourceMappingURL=registry.js.map

package/dist/pane/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/pane/registry.ts"],"names":[],"mappings":"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"}

package/dist/pane/rules.d.ts

@@ -0,0 +1,231 @@
+import { type SpCode } from '@sheetpane/export';
+import type { Cell } from '@sheetpane/import';
+import type { Plugin } from '../plugins/types.js';
+import type { Severity } from './types.js';
+/** One rule, as plain JSON: for a column (by title) or for a cell or range (rules file). */
+export interface ColumnRule {
+    required?: boolean;
+    type?: 'text' | 'number' | 'integer' | 'date' | 'boolean';
+    /** A number, or for `type: 'date'` an ISO date (`2026-01-31`) or a serial. */
+    min?: number | string;
+    max?: number | string;
+    minLength?: number;
+    maxLength?: number;
+    /** A regular expression source, tested against the cell's text (values over 10,000 characters are not tested). */
+    pattern?: string;
+    /** The valid values. */
+    oneOf?: readonly (string | number | boolean)[];
+    /** Values that are never valid (W-33). */
+    noneOf?: readonly (string | number | boolean)[];
+    /** The one valid value (W-33); a blank cell fails it. */
+    equals?: string | number | boolean;
+    unique?: boolean;
+    /** Replaces the generated message. */
+    message?: string;
+    /** Free text for whoever maintains the rules; never shown as the message (W-33). */
+    note?: string;
+    severity?: Severity;
+    onInvalid?: OnInvalid;
+}
+/** Column rules keyed by column title (or, in a rules file's `cells`, by A1 cell or range). */
+export type ColumnRules = Readonly<Record<string, ColumnRule>>;
+/** What a failing rule does on commit: `flag` stores the value and adds an error; `block` refuses it. */
+export type OnInvalid = 'flag' | 'block';
+/** When a rule runs: while typing (`input`), on commit, or over every row when a file loads. */
+export type RulePhase = 'input' | 'commit' | 'load';
+/** The rules file (W-33), version 1: rules per sheet (`"*"` for every sheet), by column title and by cell or range. */
+export interface RulesDocument {
+    $schema?: string;
+    version: 1;
+    sheets: Readonly<Record<string, {
+        headerRow?: number;
+        columns?: ColumnRules;
+        cells?: ColumnRules;
+    }>>;
+}
+/** What `validate(ctx, signal)` is told (verdict decision 6). */
+export interface RuleContext {
+    phase: RulePhase;
+    sheet: string;
+    ref: string;
+    /** Zero-based. */
+    row: number;
+    column: {
+        index: number;
+        letter: string;
+        header: string;
+    };
+    value: Cell;
+    was: Cell;
+    original: Cell;
+    /** The row's values keyed by column title. */
+    rowValues: Readonly<Record<string, Cell>>;
+}
+/** A failure a host `validate` function reports; `null` or `undefined` means the cell passes. */
+export interface RuleResult {
+    severity?: Severity;
+    message: string;
+    expected?: string;
+}
+/** The host's own check for each cell of a titled column; `signal` aborts when a newer check of the cell starts. */
+export type ValidateFn = (ctx: RuleContext, signal: AbortSignal) => RuleResult | null | undefined | Promise<RuleResult | null | undefined>;
+/** The pane's column rules (SR-GRID decision 22): set by the element or `store.setColumnRules()`. */
+export interface ColumnRulesConfig {
+    columns?: ColumnRules;
+    validate?: ValidateFn | undefined;
+    /** The default for every rule and for `validate` (decision 9: `flag`). */
+    onInvalid?: OnInvalid;
+    /** The row holding the titles, 1-based (decision 11: 1). A rules file's sheet may set its own. */
+    headerRow?: number;
+    /** A rules file (W-33), checked as given: its problems become `note` errors, never a throw. */
+    document?: unknown;
+}
+/** A failure, before it becomes an error. */
+export interface RuleOutcome {
+    severity: Severity;
+    message: string;
+    expected: string;
+    onInvalid: OnInvalid;
+}
+/** What the rules need from the store (kept narrow, so this module stays testable). */
+export interface RulesHost {
+    bookSheets(): readonly {
+        name: string;
+        rows: readonly (readonly Cell[])[];
+    }[] | undefined;
+    date1904(): boolean;
+    value(sheet: string, ref: string): Cell;
+    /** The same by position, without building a ref (the load phase reads every cell). */
+    valueAt(sheet: string, row: number, col: number): Cell;
+    text(sheet: string, ref: string): string;
+    original(sheet: string, ref: string): {
+        value: Cell;
+        text: string;
+    };
+    /** Re-run `validate` for these sheets (findings changed). */
+    revalidate(sheets: string[]): void;
+    /** Drop host errors no longer produced (rules changed, decision 12). */
+    prune(providerId: string, produced: ReadonlySet<string>): void;
+    /** The load phase's progress changed. */
+    progress(): void;
+}
+export declare const RULES_PROVIDER_ID = "host-rules";
+/** The error `type` of a column rule's finding. */
+export declare const RULE_TYPE = "column-rule";
+/** The error `type` of a rules file's cell rule finding. */
+export declare const CELL_RULE_TYPE = "cell-rule";
+/** One problem found in a rules file: a `note`, never a throw; `code` is its SP code (W-40). */
+export interface DocProblem {
+    code: SpCode;
+    sheet?: string;
+    found: string;
+    message: string;
+}
+interface DocSheet {
+    headerRow?: number;
+    columns: Record<string, ColumnRule>;
+    cells: Record<string, ColumnRule>;
+}
+export declare class HostRules {
+    private readonly host;
+    private cfg;
+    /** The element's patterns, compiled (an invalid one throws at `configure`). */
+    private patterns;
+    /** The rules file, checked: per sheet (`*` and named), and the problems found in it. */
+    private doc;
+    private sheetRules;
+    /** Per sheet, per column: the rule its title resolves to (resolved once per load, not per cell). */
+    private colRules;
+    /** Per sheet: title (normalised) → column; the titles by column. */
+    private headers;
+    private notes;
+    /** Per sheet, per cell: the column rule's failure. */
+    private json;
+    /** Per sheet, per cell: a cell rule's failure (rules file). */
+    private cellJson;
+    /** Per sheet, per cell: the function's latest result. */
+    private fn;
+    /** Per sheet and column: normalised value → its row, or its rows once it repeats (for `unique`; a Set per distinct value would be 250,000 Sets). */
+    private uniq;
+    private inflight;
+    private gen;
+    /** The load phase: rows checked of rows to check; undefined when idle. */
+    progress: {
+        done: number;
+        total: number;
+    } | undefined;
+    readonly provider: Plugin;
+    constructor(host: RulesHost);
+    get active(): boolean;
+    get config(): Readonly<ColumnRulesConfig>;
+    /** Whether a rules file is in force (its errors are labelled "Rules file"). */
+    get hasDocument(): boolean;
+    /** Rules may change after a workbook is loaded (decision 12): every row is checked again and stale host errors go. */
+    configure(c: ColumnRulesConfig): void;
+    /** A new workbook: forget everything and check it (`load`). */
+    reset(): void;
+    private drafts;
+    private compileSheet;
+    private readHeaders;
+    /** A `note` error about the rules themselves; it carries its SP code (W-40). */
+    private note;
+    /** The rule for a title on a sheet (matched trimmed and case-insensitive; an exact title wins). */
+    private ruleFor;
+    private headerRow;
+    /** The column's title on a sheet, when the column is the first of its title. */
+    private headerAt;
+    private context;
+    /** A rule's first failing constraint for a value, or null. `label` names what is checked (a column's title or a cell). */
+    /** A rule's first failing constraint for a value, or null. `label` names what is checked (a column's title or a cell).
+     *  `at` is where the value sits (its shown text is read only when a constraint needs it — reading fills the store's
+     *  text cache) or, for a draft, the text itself. No closure is made per call: the load phase checks a million cells. */
+    private checkRule;
+    private fail;
+    private shownText;
+    private trimmed;
+    /** The column rule's verdict for a cell, or null. `at` is the cell's place, or a draft's text. */
+    private checkJson;
+    /** The first failing cell rule (rules file) for a cell, or null. */
+    private checkCells;
+    private dateMs;
+    private boundMs;
+    private toDraft;
+    /** Is this cell a data cell in a titled column of a sheet with rules? */
+    private inScope;
+    private inCellRule;
+    private setJson;
+    private setCell;
+    /** Calls the host's function for one cell; a sync result lands now, an async one later (unless superseded). */
+    private callFn;
+    /** `load` (decision 7): every row of every sheet with titles, then every cell a cell rule names, in time slices; progress is shown. */
+    private loadPhase;
+    /** `commit` (decision 7): cells changed by an edit, a paste or undo. */
+    touch(cells: readonly {
+        sheet: string;
+        ref: string;
+    }[]): void;
+    private reindexUnique;
+    /** `input` (decision 7): the draft checked as typed — nothing is stored. */
+    checkInput(sheet: string, ref: string, value: Cell, text: string, signal: AbortSignal): Promise<RuleOutcome | null>;
+    /** The `block` check at commit (decision 9): a failing rule set to block refuses the value. Async results can only flag. */
+    blocked(sheet: string, ref: string, value: Cell, text: string): RuleOutcome | null;
+}
+/**
+ * Checks a rules file (W-33) by hand — no schema library at run time. Every problem
+ * is named (an unknown key, version or word, a bad ref or pattern) and the rest
+ * still applies; nothing throws (SR-GRID decision 22d).
+ * @param doc - The parsed JSON, as given.
+ * @returns The usable rules per sheet, and one problem per thing wrong.
+ */
+export declare function checkDocument(doc: unknown): {
+    sheets: Map<string, DocSheet>;
+    problems: DocProblem[];
+};
+/**
+ * A rule in words, for an error's `expected`: "a whole number from 18 to 99", "one of Active, Inactive".
+ * @param r - The rule.
+ * @returns The rule as a phrase.
+ */
+export declare function describeRule(r: ColumnRule): string;
+export {};
+//# sourceMappingURL=rules.d.ts.map

package/dist/pane/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/pane/rules.ts"],"names":[],"mappings":"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"}