lattice-grid-dash
A Dash component that renders an editable
Lattice Grid over a pandas DataFrame, with cell edits
and selection surfaced back to Python @callbacks.
Phase C2 of the Lattice Grid Python integration (card BACKLOG-0000972,
release 1.41). Built on the same shared serialization layer as the Jupyter widget
(phase C1): lattice-grid-pandas.
How it works
The component does not re-implement a React binding for the grid. It consumes
the grid's shipped React adapter (@toclocoinc/lattice-grid/modules/react,
grid v1.106.0), which exposes createLatticeGrid({ React, createGrid }). We feed
it Dash's own React (aliased at bundle time to the global the dash-renderer
serves) so there is a single React instance on the page. This is the lowest-risk
path identified in the spike: the grid team owns and versions the adapter.
DataFrame ──dataframe_to_data()──▶ data prop (columnar, from lattice-grid-pandas)
│
LatticeGrid (React adapter → createGrid)
│ manual edit
cellChanged prop ◀──setProps── onCellChanged (adapter callback)
│
Python @callback(Input("grid", "cellChanged"))
Install
pip install lattice-grid-dash
(Editable/dev: pip install -e packages/lattice-grid-dash. The built JS bundle is
committed under lattice_grid_dash/; rebuild it with npm install && npm run build.)
Usage
import pandas as pd
from dash import Dash, Input, Output, callback, html
import lattice_grid_dash
from lattice_grid_dash import dataframe_to_data, apply_cell_edit
df = pd.DataFrame({"name": ["Ada", "Grace"], "score": [91, 88], "active": [True, False]})
app = Dash(__name__)
app.layout = html.Div([
lattice_grid_dash.LatticeGrid(id="grid", data=dataframe_to_data(df)),
html.Pre(id="out"),
])
@callback(Output("out", "children"), Input("grid", "cellChanged"))
def on_edit(edit):
if not edit:
return "no edits yet"
apply_cell_edit(df, edit) # keep the server-side DataFrame in sync, typed
return f"{edit['colId']} @ row {edit['key']} = {edit['value']}"
if __name__ == "__main__":
app.run(debug=True)
See examples/app.py.
Props
| Prop | Direction | Description |
|---|---|---|
data |
in | DataFrame-derived columnar payload from dataframe_to_data(df): {columns, rowKey, columnar}. Rows are reconstructed and virtualized in the browser. |
columns |
in | Optional explicit column defs (overrides data.columns). |
options |
in | Passthrough to createGrid (e.g. {"edit": True, "rowHeight": 32}). |
licence |
in | Lattice Grid licence key. Empty on localhost → free/unwatermarked. |
cellChanged |
out | Last manual edit {key, colId, value, old, ts}. Drives Python callbacks. |
selectedKeys |
in/out | Selected row keys; set by the grid, settable from Python. |
licenceState |
out | Grid's resolved licence state (e.g. "localhost"). |
style, className |
in | Host element styling. |
Licence plumbing
The licence prop is a single opaque string handed straight to
createGrid({ licence }); the grid resolves it client-side (localhost origins
run free, unwatermarked, with no key). The resolved state is surfaced back on the
licenceState prop. This is the same contract as the Jupyter widget — the shared
rules live in lattice_grid_pandas._grid.
Grid delivery: vendored (default) vs CDN
The grid JavaScript can reach the browser two ways. This package implements the vendored path; the CDN path is documented here for operators who prefer it.
Vendored (implemented)
npm run build bundles the grid core + React adapter into
lattice_grid_dash/lattice_grid_dash.min.js (~2.7 MB) via esbuild, and the grid
CSS is vendored as lattice_grid_dash/lattice-grid.min.css. Both are registered
as Dash assets (_js_dist / _css_dist), so the component works fully offline
— no network at render time. This mirrors the C1 widget's offline=True default
and is what the browser smoke test exercises.
Rebuild:
cd packages/lattice-grid-dash
npm install
npm run build # build:js (esbuild) + build:py (dash-generate-components)
CDN (documented alternative)
To ship a thin component bundle that loads the grid from jsDelivr at render time (smaller wheel, needs network + a relaxed CSP):
- In
build.mjs, mark the grid packages external:external: ['react-dom', '@toclocoinc/lattice-grid', '@toclocoinc/lattice-grid/modules/react']. - Before the bundle loads, inject the grid from the CDN, e.g.
https://cdn.jsdelivr.net/npm/@toclocoinc/lattice-grid@1.40.0/lattice-grid.esm.min.jsand.../modules/react.esm.min.js(URLs available fromlattice_grid_pandas.cdn_urls()), and add the stylesheet.../lattice-grid.min.css. - Drop the vendored files from
_js_dist/_css_dist.
The two are mutually exclusive; pick one per build.
Development / build toolchain
npm run build:js—esbuildbundlessrc/lib/bundle.js→lattice_grid_dash/lattice_grid_dash.min.js.reactis aliased to Dash's global React (src/lib/react-shim.js); react/react-dom are never bundled.npm run build:py—dash-generate-components(react-docgen v5) readssrc/lib/components/LatticeGrid.react.jsand generatesLatticeGrid.py,_imports_.py, andmetadata.json.pytest tests/— unit tests for the data bridge, plus a real-browser Playwright smoke test (system Chrome viachannel='chrome').
1 maintainer
Metadata
1 maintainer
Release files for lattice-grid-dash 1.106.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| lattice_grid_dash-1.106.0.0.tar.gz | 773.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lattice_grid_dash-1.106.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.5 MB
Release files / lattice_grid_dash-1.106.0.0.tar.gz
| Download URL | lattice_grid_dash-1.106.0.0.tar.gz |
|---|---|
| Size | 773.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e35099d7f6e9b03320508bf717b4fa622e65c2f2338f8487e6e5b23420dabf4
|
|
BLAKE2b-256 checksum How to use checksums |
c63b4be4d49d023fb34ff171bf13796c981801c570ff00e0d563a821c133c7de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logRelease files / lattice_grid_dash-1.106.0.0-py3-none-any.whl
| Download URL | lattice_grid_dash-1.106.0.0-py3-none-any.whl |
|---|---|
| Size | 771.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
36c4afe7771ea09e9bad9399bd127434d87688369ff26b174fc223afec09ca6d
|
|
BLAKE2b-256 checksum How to use checksums |
96975e5ab77703816e133153c45a93b33e34a77e4bc7265b78c90bf74b22489a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logSecurity for lattice-grid-dash 1.106.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for lattice_grid_dash-1.106.0.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
