| Tag                               | Description                                | Details                                                                                           | Example                                                                                                                       |
| :-------------------------------- | :----------------------------------------- | :------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------- |
| **Charts & Visualization**        |                                            |                                                                                                   |                                                                                                                               |
| `# bar_chart`                     | Render data as a bar chart.                | Base tag for bar chart configuration. Axes/series often inferred.                                 | `view: my_view is { # bar_chart ... }`                                                                                        |
| `# bar_chart.stack`               | Stack bars in a series.                    | Boolean property. Use when a `series` field is defined.                                           | `view: my_view is { # bar_chart.stack ... }`                                                                                  |
| `# bar_chart.size`                | Set preset chart size.                     | Values: `spark`, `xs`, `sm`, `md`, `lg`, `xl`, `2xl`.                                             | `view: my_view is { # bar_chart { size=lg } ... }`                                                                            |
| `# bar_chart.size.width`          | Set specific chart width.                  | Value is in pixels. Overrides preset width.                                                       | `view: my_view is { # bar_chart { size.width=450 } ... }`                                                                     |
| `# bar_chart.size.height`         | Set specific chart height.                 | Value is in pixels. Overrides preset height.                                                      | `view: my_view is { # bar_chart { size.height=300 } ... }`                                                                    |
| `# bar_chart.x`                   | Define x-axis field.                       | Assigns a field to the category axis.                                                             | `view: my_view is { # bar_chart { x=category } ... }`                                                                         |
| `# bar_chart.x.limit`             | Limit categories on x-axis.                | Numeric value. Limits bars shown. Auto-calculated if not set.                                     | `view: my_view is { # bar_chart { x.limit=10 } ... }`                                                                         |
| `# bar_chart.x.independent`       | Control x-axis scale sharing.              | Boolean (`true`/`false`). Overrides auto-sharing based on cardinality (default shares if <=20).   | `view: my_nest is { # bar_chart { x.independent } ...}`                                                                       |
| `# bar_chart.y`                   | Define y-axis field(s).                    | Assigns field(s) to the value axis. Use array `['m1', 'm2']` for measure series.                  | `view: my_view is { # bar_chart { y=total_sales } ... }` <br> `view: my_view is { # bar_chart { y=['Sales', 'Cost'] } ... }`  |
| `# bar_chart.y.independent`       | Control y-axis scale sharing.              | Boolean (`true`/`false`). Default is shared. Use `true` for independent scales in nested charts.  | `view: my_nest is { # bar_chart { y.independent } ... }`                                                                      |
| `# bar_chart.series`              | Define series field.                       | Assigns a field for grouping/coloring bars.                                                       | `view: my_view is { # bar_chart { series=department } ... }`                                                                  |
| `# bar_chart.series.limit`        | Limit number of series shown.              | Numeric value or `auto`. Default `auto` uses 20. Series ranked by sum of Y-values.               | `view: my_view is { # bar_chart { series.limit=5 } ... }` <br> `view: my_view is { # bar_chart { series.limit=auto } ... }`    |
| `# bar_chart.series.independent`  | Control series legend/color sharing.       | Boolean (`true`/`false`). Overrides auto-sharing based on cardinality (default shares if <=20).   | `view: my_nest is { # bar_chart { series.independent } ... }`                                                                 |
| `# bar_chart.title`               | Set chart title.                           | String value.                                                                                     | `view: my_view is { # bar_chart { title='Sales Distribution' } ... }`                                                         |
| `# bar_chart.subtitle`            | Set chart subtitle.                        | String value.                                                                                     | `view: my_view is { # bar_chart { subtitle='Q1 Data' } ... }`                                                                 |
| `# line_chart`                    | Render data as a line chart.               | Base tag for line chart configuration. Axes/series often inferred.                                | `view: my_view is { # line_chart ... }`                                                                                       |
| `# line_chart.zero_baseline`      | Control if y-axis includes zero.           | Boolean (`true`/`false`). Default `false` (unlike bar charts). `true` forces axis to start at zero. | `view: my_view is { # line_chart { zero_baseline=true } ... }`                                                                |
| `# line_chart.size`               | Set preset chart size.                     | Values: `spark`, `xs`...`2xl`.                                                                    | `view: my_view is { # line_chart { size=spark } ... }`                                                                        |
| `# line_chart.interpolate`        | Set line interpolation mode.               | E.g., `step`.                                                                                     | `view: my_view is { # line_chart { interpolate=step } ... }`                                                                  |
| `# line_chart.x`                  | Define x-axis field.                       | Assigns a field (often time-based) to the x-axis.                                                 | `view: my_view is { # line_chart { x=sale_date } ... }`                                                                       |
| `# line_chart.x.independent`      | Control x-axis scale sharing.              | Boolean (`true`/`false`). Overrides auto-sharing (default shares if <=20).                        | `view: my_nest is { # line_chart { x.independent } ... }`                                                                     |
| `# line_chart.y`                  | Define y-axis field(s).                    | Assigns field(s) to the value axis. Use array `['m1', 'm2']` for multiple lines from measures.    | `view: my_view is { # line_chart { y=value } ... }` <br> `view: my_view is { # line_chart { y=['MetricA', 'MetricB'] } ... }` |
| `# line_chart.y.independent`      | Control y-axis scale sharing.              | Boolean (`true`/`false`). Default is shared, unless `series.limit` is used.                       | `view: my_nest is { # line_chart { y.independent } ... }`                                                                     |
| `# line_chart.series`             | Define series field.                       | Assigns a field for multiple lines.                                                               | `view: my_view is { # line_chart { series=category } ... }`                                                                   |
| `# line_chart.series.limit`       | Limit number of series lines.              | Numeric value or `auto`. Default `auto` uses 12. Series ranked by sum of Y-values. Implies `y.independent=true`. | `view: my_view is { # line_chart { series.limit=5 } ... }` <br> `view: my_view is { # line_chart { series.limit=auto } ... }` |
| `# line_chart.series.independent` | Control series legend/color sharing.       | Boolean (`true`/`false`). Overrides auto-sharing (default shares if <=20).                        | `view: my_nest is { # line_chart { series.independent } ... }`                                                                |
| `# line_chart.title`              | Set chart title.                           | String value.                                                                                     | `view: my_view is { # line_chart { title='Trend Over Time' } ... }`                                                           |
| `# line_chart.subtitle`           | Set chart subtitle.                        | String value.                                                                                     | `view: my_view is { # line_chart { subtitle='Daily Values' } ... }`                                                           |
| `# scatter_chart`                 | Render as scatter plot.                    | Legacy renderer. Uses field order (x, y, color, size, shape).                                     | `view: my_view is { # scatter_chart ... }`                                                                                    |
| **Layout & Structure**            |                                            |                                                                                                   |                                                                                                                               |
| `# dashboard`                     | Render nested views as a dashboard.        | Base tag for dashboard layout.                                                                    | `view: my_dashboard is { # dashboard nest: ... }`                                                                             |
| `# dashboard.table.max_height`    | Set max height for tables in dashboard.    | Numeric pixel value or `'none'`.                                                                  | `view: my_dashboard is { # dashboard { table.max_height=400 } ... }`                                                          |
| `# dashboard.columns`             | Columns mode: N equal-width columns.       | Integer. A tile takes one column by default; tiles wrap onto new rows. Use `# colspan` to widen a tile.          | `view: my_dashboard is { # dashboard { columns=3 } nest: ... }`                                                              |
| `# dashboard.gap`                 | Spacing between tiles (pixels).            | Applies in flex mode and columns mode. Default 16.                                                | `view: my_dashboard is { # dashboard { gap=24 } nest: ... }`                                                                 |
| `# colspan`                       | Tile width in columns mode (in columns).   | Applied to a `nest:`. Makes the tile span N columns (one by default); ignored in flex mode.       | `view: my_dashboard is { # dashboard { columns=12 } # colspan=8 nest: a is {...} # colspan=4 nest: b is {...} }`             |
| `# break`                         | Start a new row in a dashboard.          | Applied to a `nest:` definition. Tiles after it begin a fresh row.                                               | `view: my_dashboard is { nest: chart1 is {...} # break nest: chart2 is {...} }`                                               |
| `# table`                         | Render data as a table.                    | Often the default for nested data.                                                                | `view: my_table is { # table ... }`                                                                                           |
| `# table.pivot`                   | Pivot table dimensions into columns.       | Use `# pivot` for automatic, or `# pivot { dimensions=["d1"] }` for specific dimensions.          | `nest: my_pivot is { # pivot ... }` <br> `nest: my_pivot is { # pivot { dimensions=["country"] } ... }`                       |
| `# table.flatten`                 | Flatten nested record into columns.        | Applied to a `nest:` definition. Nested query must not have `group_by`.                           | `nest: metrics is { # flatten ... }`                                                                                          |
| `# table.size=fill`               | Make table fill container width.           | Boolean property applied via value.                                                               | `view: full_width_table is { # table.size=fill ... }`                                                                         |
| `# table.column.width`            | Set specific column width.                 | Apply to a field. Value: `xs`, `sm`, `md`, `lg`, `xl`, `2xl` or pixels.                           | `dimension: my_col is ... # column { width=lg }` <br> `dimension: my_col is ... # column { width=150 }`                       |
| `# table.column.height`           | Set specific row height for column cells.  | Apply to a field. Value in pixels.                                                                | `dimension: my_col is ... # column { height=50 }`                                                                             |
| `# table.column.word_break`       | Control word breaking in cells.            | Value: `break_all`. Apply to a field.                                                             | `dimension: long_text is ... # column { word_break=break_all }`                                                               |
| `# list`                          | Render first field as list.                | Comma-separated values from the first non-hidden field of a nest.                                 | `nest: top_items is { # list ... }`                                                                                           |
| `# list_detail`                   | Render first two fields as list.           | Comma-separated `value (detail)` from first two non-hidden fields.                                | `nest: item_details is { # list_detail ... }`                                                                                 |
| `# transpose`                     | Transpose table rows/columns.              | Applied at the view level. Default limit of 20 columns; use `.limit=N` to increase.               | `view: metrics_row is { # transpose ... }` <br> `# transpose.limit=100`                                                      |
| **Field Formatting/Rendering**    |                                            |                                                                                                   |                                                                                                                               |
| `# currency`                      | Format number as currency.                 | Default is USD ($). Specify units like `euro` or `pound`.                                         | `measure: revenue is ... # currency` <br> `measure: revenue_eur is ... # currency=euro`                                       |
| `# percent`                       | Format number as percentage.               | Multiplies by 100, adds '%'.                                                                      | `measure: margin is ... # percent`                                                                                            |
| `# number`                        | Format number with `ssf` string.           | Provide format string as value.                                                                   | `measure: my_num is ... # number="#,##0.0"`                                                                                   |
| `# duration`                      | Format number as duration.                 | Default input unit: `seconds`. Specify units (`nanoseconds`..`days`).                             | `measure: avg_time is ... # duration` <br> `measure: compute is ... # duration=milliseconds`                                  |
| `# duration.terse`                | Use abbreviated duration units.            | E.g., `ns`, `s`, `m`, `h`, `d`.                                                                   | `measure: short_time is ... # duration.terse`                                                                                 |
| `# duration.number`               | Format numeric parts of duration.          | Uses `ssf` format string.                                                                         | `measure: precise_duration is ... # duration { number="0.00" }`                                                               |
| `# image`                         | Render string as image URL.                | Applied to a string field containing a URL.                                                       | `dimension: logo_url is ... # image`                                                                                          |
| `# image.height`                  | Set image height.                          | CSS value (e.g., `40px`).                                                                         | `dimension: logo_url is ... # image { height=40px }`                                                                          |
| `# image.width`                   | Set image width.                           | CSS value (e.g., `100px`).                                                                        | `dimension: logo_url is ... # image { width=100px }`                                                                          |
| `# image.alt`                     | Set image alt text.                        | Literal string value.                                                                             | `dimension: logo_url is ... # image { alt='Company Logo' }`                                                                   |
| `# image.alt.field`               | Use another field for alt text.            | Value is relative path to field (e.g., `field_name`, `'../parent_field'`).                        | `dimension: logo_url is ... # image { alt.field=product_name }`                                                               |
| `# link`                          | Render field as hyperlink.                 | Applied to a field whose value is the link text.                                                  | `dimension: url is ... # link`                                                                                                |
| `# link.url_template`             | Template for link href.                    | String where `$$` is replaced by value (from this field or `.field`). Appends if `$$` is missing. | `dimension: name is ... # link { url_template="https://example.com/$$" }`                                                     |
| `# link.field`                    | Use another field's value for href.        | Value is relative path to the field containing the href data.                                     | `dimension: link_text is 'Search' # link { field=query_term url_template="https://google.com/search?q=$$" }`                  |
| **Utilities & Configuration**     |                                            |                                                                                                   |                                                                                                                               |
| `# hidden`                        | Hide field from rendering.                 | Field remains in data, just not displayed in tables/dashboards.                                   | `dimension: internal_id is ... # hidden`                                                                                      |
| `# label`                         | Override display name/title.               | String value. Applied to fields or dashboard items.                                               | `measure: total_revenue is ... # label="Total Sales ($)"`                                                                     |
| `# tooltip`                       | Include nested view in tooltip.            | Applied to a `nest:`. Can contain render hints for the tooltip itself.                            | `nest: details is { # tooltip ... }` <br> `nest: chart_tip is { # tooltip bar_chart.size=xs ... }`                            |
| `# size`                          | Set preset size (legacy).                  | Prefer `.size` on specific renderer tags. Values: `spark`, `xs`...`2xl`. Applied to view/nest.    | `view: my_view is { # size=lg ... }`                                                                                          |
| `# theme`                         | Apply theme style overrides (View level).  | Contains CSS-like properties (e.g., `tableBodyColor`, `tableRowHeight`).                          | `view: my_view is { # theme { tableBodyColor=red } ... }`                                                                     |
| `## theme`                        | Apply theme style overrides (Model level). | Contains CSS-like properties. Sets defaults for the model.                                        | `## theme { tableBodyColor=blue }`                                                                                            |
| `## renderer_legacy`              | Use legacy HTML renderer for model.        | Model-level tag. No properties.                                                                   | `## renderer_legacy`                                                                                                          |
