WORK-488
ID:WORK-488Status:ready

data rune — docs page

The author-facing documentation for SPEC-103: the data rune with CSV + JSON examples, the chart/datatable composition story, and the build-time-vs-runtime distinction so authors reach for the right layer.

Priority:mediumComplexity:simpleMilestone:v0.27.0Source:SPEC-103
changeset-release/main View source

Criteria completion

Criteria completion: 0 of 3 (0%) checked; tracking started on Jun 26, no incremental history yet0%25%50%75%100%Jun 26Jul 11

Tracking started Jun 26 — check back for trends.

Relationships

Implements 1
Related 4
Branches 3
changeset-release/main current ready
claude/spec-103-data-rune donemain doneclaude/v0-27-0-planning-sgq68k ready
History 2
  1. 340475d
    Created (ready)by github-actions[bot]
  2. 4eab338
    Content editedby Claude
    plan: accept SPEC-103 + SPEC-113, break into v0.27.0 work items

Scope

  • Reference — all knobs (src, format, delimiter, header, root, orient, key-column, columns, where, sort, limit/offset, numeric/text), grouped core / csv-tsv / json / shared.
  • Examples — CSV → chart, nested JSON → table (plucked + filtered + sorted), object-map JSON → datatable (the SPEC-103 worked examples).
  • Composition + build-time/runtime line — data shapes at build time (deterministic, defines the no-JS table); datatable filters at runtime. Draw the line so authors don't reach for the wrong layer. Note data-value is the typed channel both chart and datatable honour.
  • Cross-link the SQLite later-tier note (deferred) and the SPEC-113 sandbox / ProjectFiles boundary.

Acceptance Criteria

  • A data docs page documents all knobs with CSV + JSON examples and the chart/datatable composition story.
  • The build-time-vs-runtime distinction (vs datatable) is explained.
  • SQLite is documented as a later adapter tier with its read-only / no-extension / no-ATTACH sandbox requirements (implementation deferred to its own work item).

Dependencies

  • WORK-417, WORK-486 — the rune + adapters the docs describe.

References

  • SPEC-103 — knobs, worked examples, composition, SQLite later-tier.