qapp chart region kind (proposed)

dsldraft owner: philip · updated 2026-11-14

relates: admin-console

qapp chart region kind (proposed)

Adds a chart: region kind to the .qapp grammar so analytics data renders as graphs, not just tables.

File shape

• One region per line, same as existing kinds: chart:<name>:<source>:<type>

Line grammar

• chart:<region-name>:<ref>:<type>[:<options>]
• type ∈ line | bar | funnel | pie
• <ref> is a GET ref resolving to bucketed series data (analytics module shape)
• <options> comma-separated k=v (e.g. x=date,y=count,color=#1f77b4)

Reserved words

• chart — region kind marker.

Validation rules

• Unknown type rejected at compile time.
• Ref must resolve to a GET endpoint; non-2xx renders an error region, not a blank.

Implementation status

• proposed — renderer + grammar change not yet built; tables (table:, stats:, list:) are implemented.

Sources

• factory/forms/form-engine/QAPP.md
• factory/analytics/README.md