spaday-regular-table 0.0.0__tar.gz → 0.2.0__tar.gz

spaday_regular_table-0.2.0/.gitignore

@@ -0,0 +1,157 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.a
+*.o
+*.dSYM
+*.so
+*.obj
+*.dll
+*.exp
+*.lib
+
+# Rust
+target
+target-capi
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+junit.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# Airspeed Velocity
+.asv
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Documentation
+/site
+index.md
+docs/_build/
+docs/api
+docs/html
+docs/index.md
+docs/jupyter_execute
+docs/src/_build/
+docs/superpowers
+index.md
+
+# JS
+js/coverage
+js/dist
+js/lib
+js/node_modules
+js/test-results
+js/playwright-report
+js/*.tgz
+
+# Jupyter
+.ipynb_checkpoints
+.autoversion
+Untitled*.ipynb
+spaday_regular_table/extension
+spaday_regular_table/nbextension
+spaday_regular_table/labextension
+
+# Emscripten SDK (locally installed)
+emsdk
+
+# Mac
+.DS_Store
+
+# Hydra
+/outputs/
+/multirun/
+
+# AI
+ROADMAP.md
+AGENTS.md
+.github/hooks/sdlc.json
+.superpowers

{spaday_regular_table-0.0.0 → spaday_regular_table-0.2.0}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025, the spaday-regular-table authors
+   Copyright 2025 1kbgz
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

spaday_regular_table-0.2.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: spaday-regular-table
+Version: 0.2.0
+Summary: regular-table for spaday
+Project-URL: Repository, https://github.com/1kbgz/spaday-regular-table
+Project-URL: Homepage, https://github.com/1kbgz/spaday-regular-table
+Author-email: 1kbgz <dev@1kbgz.com>
+License: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.11
+Requires-Dist: spaday>=0.6.0
+Provides-Extra: develop
+Requires-Dist: build; extra == 'develop'
+Requires-Dist: bump-my-version; extra == 'develop'
+Requires-Dist: check-dist; extra == 'develop'
+Requires-Dist: codespell; extra == 'develop'
+Requires-Dist: hatch-js; extra == 'develop'
+Requires-Dist: hatchling; extra == 'develop'
+Requires-Dist: httpx; extra == 'develop'
+Requires-Dist: mdformat; extra == 'develop'
+Requires-Dist: mdformat-tables>=1; extra == 'develop'
+Requires-Dist: pytest; extra == 'develop'
+Requires-Dist: pytest-cov; extra == 'develop'
+Requires-Dist: ruff; extra == 'develop'
+Requires-Dist: starlette; extra == 'develop'
+Requires-Dist: twine; extra == 'develop'
+Requires-Dist: ty; extra == 'develop'
+Requires-Dist: uv; extra == 'develop'
+Requires-Dist: uvicorn; extra == 'develop'
+Requires-Dist: wheel; extra == 'develop'
+Provides-Extra: examples
+Requires-Dist: starlette; extra == 'examples'
+Requires-Dist: uvicorn; extra == 'examples'
+Description-Content-Type: text/markdown
+
+# spaday-regular-table
+
+Viewport-virtualized data tables for spaday, powered by `regular-table`.
+
+[![Build Status](https://github.com/1kbgz/spaday-regular-table/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/1kbgz/spaday-regular-table/actions/workflows/build.yaml)
+[![codecov](https://codecov.io/gh/1kbgz/spaday-regular-table/branch/main/graph/badge.svg)](https://codecov.io/gh/1kbgz/spaday-regular-table)
+[![License](https://img.shields.io/github/license/1kbgz/spaday-regular-table)](https://github.com/1kbgz/spaday-regular-table)
+[![PyPI](https://img.shields.io/pypi/v/spaday-regular-table.svg)](https://pypi.python.org/pypi/spaday-regular-table)
+
+## Documentation
+
+- [Build a 100,000-row table](docs/src/tutorial.md) — guided virtual-table example.
+- [Add rich action cells and hot row updates](docs/src/how-to.md) — task-focused Python configuration.
+- [API reference](docs/src/reference.md) — props, events, methods, and metadata.
+- [Why viewport virtualization matters](docs/src/explanation.md) — performance model and tradeoffs.
+
+## Quick example
+
+```python
+from spaday import CallEndpoint, event_value, serve
+from spaday_regular_table import RegularTable
+
+rows = [{"id": i, "symbol": f"SYM{i}", "price": i / 10} for i in range(100_000)]
+
+table = RegularTable(
+    columns=[
+        "id",
+        {
+            "key": "symbol",
+            "label": "Symbol",
+            "cell": {"tag": "button", "class": "symbol-button", "event": "symbol-click"},
+        },
+        {"key": "price", "label": "Last price", "cell": {"format": "number", "digits": 2}},
+    ],
+    rows=rows,
+    row_header="id",
+    style="height: 32rem",
+).on("symbol-click", CallEndpoint("POST", "/api/click", event_value()))
+
+serve(table, packages=["regular-table"])
+```
+
+Only cells requested for the current viewport are copied into `regular-table` and rendered. `rows`
+remains a browser-side record array. `columns` accepts keys or `{key, label, cell}` objects and is
+inferred from the first row when omitted. A `cell` descriptor can wrap the displayed value in an HTML
+or custom-element tag, apply classes and attributes, or format numeric values. The wrapper performs
+that work only for visible cells.
+
+For hot server pushes, set `stream_url` to an SSE endpoint whose messages are row patches. You can also
+bind `rowPatch` to `CallEndpoint(result=...)` state for request/response updates. Each patch contains
+revisioned `update`, `insert`, and `remove` operations, so a 100,000-row list is not recopied. The
+browser methods remain available to integration authors, but applications need no JavaScript callback.
+
+`cell-click` exposes `event.detail` with `type`, virtual `x`/`y`, `column`, `value`, and the source `row`, so normal spaday actions can handle interactions. `virtual_mode` supports upstream `both`, `horizontal`, `vertical`, and `none`; keep `both` for large datasets.
+
+## Run the local example
+
+```bash
+python -m pip install -e ".[examples]"
+python -m spaday_regular_table.example
+```
+
+Open `http://127.0.0.1:8014` to inspect the [complete market-blotter example](spaday_regular_table/example.py): 100,000
+virtualized rows, a server row stream, full-width sizing, rich cells, and server-authoritative update,
+insert, remove, and click operations. All interaction is authored in Python; there is no companion
+`example.js`. It passes the local package descriptor directly, so it does not install or resolve the
+integration from GitHub.

spaday_regular_table-0.2.0/README.md

@@ -0,0 +1,67 @@
+# spaday-regular-table
+
+Viewport-virtualized data tables for spaday, powered by `regular-table`.
+
+[![Build Status](https://github.com/1kbgz/spaday-regular-table/actions/workflows/build.yaml/badge.svg?branch=main&event=push)](https://github.com/1kbgz/spaday-regular-table/actions/workflows/build.yaml)
+[![codecov](https://codecov.io/gh/1kbgz/spaday-regular-table/branch/main/graph/badge.svg)](https://codecov.io/gh/1kbgz/spaday-regular-table)
+[![License](https://img.shields.io/github/license/1kbgz/spaday-regular-table)](https://github.com/1kbgz/spaday-regular-table)
+[![PyPI](https://img.shields.io/pypi/v/spaday-regular-table.svg)](https://pypi.python.org/pypi/spaday-regular-table)
+
+## Documentation
+
+- [Build a 100,000-row table](docs/src/tutorial.md) — guided virtual-table example.
+- [Add rich action cells and hot row updates](docs/src/how-to.md) — task-focused Python configuration.
+- [API reference](docs/src/reference.md) — props, events, methods, and metadata.
+- [Why viewport virtualization matters](docs/src/explanation.md) — performance model and tradeoffs.
+
+## Quick example
+
+```python
+from spaday import CallEndpoint, event_value, serve
+from spaday_regular_table import RegularTable
+
+rows = [{"id": i, "symbol": f"SYM{i}", "price": i / 10} for i in range(100_000)]
+
+table = RegularTable(
+    columns=[
+        "id",
+        {
+            "key": "symbol",
+            "label": "Symbol",
+            "cell": {"tag": "button", "class": "symbol-button", "event": "symbol-click"},
+        },
+        {"key": "price", "label": "Last price", "cell": {"format": "number", "digits": 2}},
+    ],
+    rows=rows,
+    row_header="id",
+    style="height: 32rem",
+).on("symbol-click", CallEndpoint("POST", "/api/click", event_value()))
+
+serve(table, packages=["regular-table"])
+```
+
+Only cells requested for the current viewport are copied into `regular-table` and rendered. `rows`
+remains a browser-side record array. `columns` accepts keys or `{key, label, cell}` objects and is
+inferred from the first row when omitted. A `cell` descriptor can wrap the displayed value in an HTML
+or custom-element tag, apply classes and attributes, or format numeric values. The wrapper performs
+that work only for visible cells.
+
+For hot server pushes, set `stream_url` to an SSE endpoint whose messages are row patches. You can also
+bind `rowPatch` to `CallEndpoint(result=...)` state for request/response updates. Each patch contains
+revisioned `update`, `insert`, and `remove` operations, so a 100,000-row list is not recopied. The
+browser methods remain available to integration authors, but applications need no JavaScript callback.
+
+`cell-click` exposes `event.detail` with `type`, virtual `x`/`y`, `column`, `value`, and the source `row`, so normal spaday actions can handle interactions. `virtual_mode` supports upstream `both`, `horizontal`, `vertical`, and `none`; keep `both` for large datasets.
+
+## Run the local example
+
+```bash
+python -m pip install -e ".[examples]"
+python -m spaday_regular_table.example
+```
+
+Open `http://127.0.0.1:8014` to inspect the [complete market-blotter example](spaday_regular_table/example.py): 100,000
+virtualized rows, a server row stream, full-width sizing, rich cells, and server-authoritative update,
+insert, remove, and click operations. All interaction is authored in Python; there is no companion
+`example.js`. It passes the local package descriptor directly, so it does not install or resolve the
+integration from GitHub.

spaday_regular_table-0.2.0/js/.oxfmtrc.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 80,
+  "sortPackageJson": false
+}

spaday_regular_table-0.2.0/js/.oxlintrc.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "browser": true,
+    "es6": true,
+    "node": true
+  },
+  "rules": {
+    "unicorn/no-empty-file": "off"
+  }
+}

spaday_regular_table-0.2.0/js/build.mjs

@@ -0,0 +1,48 @@
+import { bundle } from "./tools/bundle.mjs";
+import { node_modules_external } from "./tools/externals.mjs";
+
+import fs from "fs";
+import cpy from "cpy";
+
+const BUNDLES = [
+  {
+    entryPoints: ["src/ts/index.ts"],
+    plugins: [node_modules_external()],
+    outfile: "dist/esm/index.js",
+  },
+  {
+    entryPoints: ["src/ts/index.ts"],
+    outfile: "dist/cdn/index.js",
+  },
+];
+
+async function build() {
+  fs.rmSync("dist", { recursive: true, force: true });
+  fs.rmSync("../spaday_regular_table/extension", {
+    recursive: true,
+    force: true,
+  });
+
+  // Copy HTML
+  await cpy("src/html/*", "dist/");
+
+  // Copy images
+  fs.mkdirSync("dist/img", { recursive: true });
+  await cpy("src/img/*", "dist/img");
+
+  await cpy("node_modules/regular-table/dist/css/material.css", "dist/css", {
+    flat: true,
+  });
+
+  await Promise.all(BUNDLES.map(bundle)).catch(() => process.exit(1));
+
+  // Copy servable assets to python extension (exclude esm/)
+  fs.mkdirSync("../spaday_regular_table/extension", { recursive: true });
+  await cpy("dist/**/*", "../spaday_regular_table/extension", {
+    filter: (file) =>
+      !file.relativePath.startsWith("esm/") &&
+      !file.relativePath.startsWith("dist/esm/"),
+  });
+}
+
+build();

spaday_regular_table-0.2.0/js/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "spaday-regular-table",
+  "version": "0.2.0",
+  "description": "regular-table for spaday",
+  "repository": "git@github.com:1kbgz/spaday-regular-table.git",
+  "author": "1kbgz <dev@1kbgz.com>",
+  "license": "Apache-2.0",
+  "private": true,
+  "type": "module",
+  "unpkg": "dist/cdn/index.js",
+  "jsdelivr": "dist/cdn/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
+    },
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*",
+    "index.d.ts"
+  ],
+  "types": "./dist/esm/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:debug": "node build.mjs --debug",
+    "build": "node build.mjs",
+    "clean": "rm -rf dist playwright-report ../spaday_regular_table/extension",
+    "dev": "npm-run-all -p start watch",
+    "lint": "oxlint . && oxfmt --check \"src/**/*.{js,ts,jsx,tsx,css}\" \"tests/**/*.{js,ts,jsx,tsx}\" \"*.mjs\" \"*.json\"",
+    "fix": "oxlint --fix . && oxfmt --write \"src/**/*.{js,ts,jsx,tsx,css}\" \"tests/**/*.{js,ts,jsx,tsx}\" \"*.mjs\" \"*.json\"",
+    "preinstall": "npx only-allow pnpm",
+    "prepack": "npm run build",
+    "start": "http-server -p 3000 -o examples/",
+    "start:tests": "http-server -p 3000 ",
+    "test": "TZ=UTC playwright test",
+    "watch": "nodemon --watch src -e ts,css,html --exec \"pnpm build:debug\""
+  },
+  "dependencies": {
+    "regular-table": "^0.9.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.62.0",
+    "cpy": "^13.2.2",
+    "esbuild": "^0.28.1",
+    "http-server": "^14.1.1",
+    "nodemon": "^3.1.10",
+    "npm-run-all": "^4.1.5",
+    "oxfmt": "^0.63.0",
+    "oxlint": "^1.78.0",
+    "typescript": "^7.0.2"
+  }
+}

spaday_regular_table-0.2.0/js/playwright.config.js

@@ -0,0 +1,38 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "tests",
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: [
+    ["line"],
+    ["html", { outputFile: "playwright-report/index.html", open: "never" }],
+    ["junit", { outputFile: "junit.xml" }],
+  ],
+  use: {
+    baseURL: "http://127.0.0.1:3000",
+    trace: "on-first-retry",
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] },
+    },
+  ],
+  webServer: [
+    {
+      command: "pnpm run start:tests",
+      url: "http://127.0.0.1:3000",
+      reuseExistingServer: !process.env.CI,
+      timeout: 120 * 1000,
+    },
+    {
+      command: "python -m spaday_regular_table.example",
+      url: "http://127.0.0.1:8014",
+      reuseExistingServer: !process.env.CI,
+      timeout: 120 * 1000,
+    },
+  ],
+});