contentitem/chart.proto

§Raw schema

syntax = "proto3";

package eddocu.chart.v3;

enum ChartType {
  CHART_UNKNOWN = 0;
  CHART_BAR = 1;
  CHART_LINE = 2;
  CHART_PIE = 3;
  CHART_SCATTER = 4;
  CHART_AREA = 5;
  CHART_DOUGHNUT = 6;
  CHART_RADAR = 7;
  CHART_BUBBLE = 8;
  CHART_BAR_3D = 9;
  CHART_LINE_3D = 10;
  CHART_PIE_3D = 11;
  CHART_AREA_3D = 12;
  CHART_COMBO = 13;
  CHART_STOCK = 14;      // High-Low-Open-Close / volume-HLC
  CHART_SURFACE = 15;    // 2D wireframe surface
  CHART_SURFACE_3D = 16; // 3D surface mesh
  CHART_OF_PIE = 17;     // pie-of-pie / bar-of-pie
}

enum LineDash {
  LINE_DASH_UNKNOWN = 0;
  LINE_DASH_SOLID = 1;
  LINE_DASH_DOT = 2;
  LINE_DASH_DASH = 3;
  LINE_DASH_LARGE_DASH = 4;
  LINE_DASH_DASH_DOT = 5;
  LINE_DASH_LARGE_DASH_DOT = 6;
  LINE_DASH_LARGE_DASH_DOT_DOT = 7;
  LINE_DASH_SYS_DASH = 8;
  LINE_DASH_SYS_DOT = 9;
  LINE_DASH_SYS_DASH_DOT = 10;
  LINE_DASH_SYS_DASH_DOT_DOT = 11;
}

enum MarkerStyle {
  MARKER_UNKNOWN = 0;
  MARKER_NONE = 1;
  MARKER_CIRCLE = 2;
  MARKER_SQUARE = 3;
  MARKER_DIAMOND = 4;
  MARKER_TRIANGLE = 5;
  MARKER_X = 6;
  MARKER_STAR = 7;
  MARKER_PLUS = 8;
  MARKER_DASH = 9;
  MARKER_DOT = 10;
  MARKER_PICTURE = 11;
  MARKER_AUTO = 12;
}

enum LegendPosition {
  LEGEND_POS_UNKNOWN = 0;
  LEGEND_POS_NONE = 1;
  LEGEND_POS_RIGHT = 2;
  LEGEND_POS_TOP = 3;
  LEGEND_POS_LEFT = 4;
  LEGEND_POS_BOTTOM = 5;
  LEGEND_POS_TOP_RIGHT = 6;
}

// How a series' values combine across categories. For bar/col/line/area.
enum Grouping {
  GROUPING_UNKNOWN = 0;
  GROUPING_CLUSTERED = 1;      // side-by-side
  GROUPING_STACKED = 2;        // absolute stack
  GROUPING_PERCENT_STACKED = 3;// 100% stack
  GROUPING_STANDARD = 4;       // line/area default
}

// Orientation for bar/col charts.
enum BarDirection {
  BAR_DIR_UNKNOWN = 0;
  BAR_DIR_COL = 1;  // vertical (default)
  BAR_DIR_BAR = 2;  // horizontal
}

// Axis tick-mark style.
enum TickMark {
  TICK_MARK_UNKNOWN = 0;
  TICK_MARK_NONE = 1;
  TICK_MARK_IN = 2;
  TICK_MARK_OUT = 3;
  TICK_MARK_CROSS = 4;
}

// Where axis tick labels render.
enum TickLabelPos {
  TICK_LBL_POS_UNKNOWN = 0;
  TICK_LBL_POS_NONE = 1;
  TICK_LBL_POS_LOW = 2;
  TICK_LBL_POS_HIGH = 3;
  TICK_LBL_POS_NEXT_TO = 4; // default — next to the axis
}

// Scatter-chart sub-style.
enum ScatterStyle {
  SCATTER_STYLE_UNKNOWN = 0;
  SCATTER_STYLE_LINE = 1;
  SCATTER_STYLE_LINE_MARKER = 2;
  SCATTER_STYLE_MARKER = 3;
  SCATTER_STYLE_SMOOTH = 4;
  SCATTER_STYLE_SMOOTH_MARKER = 5;
  SCATTER_STYLE_NONE = 6;
}

// Radar-chart sub-style.
enum RadarStyle {
  RADAR_STYLE_UNKNOWN = 0;
  RADAR_STYLE_STANDARD = 1;
  RADAR_STYLE_MARKER = 2;
  RADAR_STYLE_FILLED = 3;
}

// How to treat empty cells in the chart data range.
enum DispBlanksAs {
  DISP_BLANKS_UNKNOWN = 0;
  DISP_BLANKS_GAP = 1;   // leave a gap (default)
  DISP_BLANKS_ZERO = 2;  // treat as zero
  DISP_BLANKS_SPAN = 3;  // connect data points across the gap
}

// Axis crossing behavior — where the perpendicular axis crosses this one.
enum AxisCrosses {
  AXIS_CROSSES_UNKNOWN = 0;
  AXIS_CROSSES_AUTO_ZERO = 1; // default — cross at 0 / first category
  AXIS_CROSSES_MIN = 2;       // cross at axis minimum
  AXIS_CROSSES_MAX = 3;       // cross at axis maximum
  AXIS_CROSSES_CUSTOM = 4;    // cross at AxisConfig.crosses_at value
}

// Axis display-units scaling — divides tick labels by a power of 10.
enum DispUnits {
  DISP_UNITS_UNKNOWN = 0;
  DISP_UNITS_NONE = 1;
  DISP_UNITS_HUNDREDS = 2;
  DISP_UNITS_THOUSANDS = 3;
  DISP_UNITS_TEN_THOUSANDS = 4;
  DISP_UNITS_HUNDRED_THOUSANDS = 5;
  DISP_UNITS_MILLIONS = 6;
  DISP_UNITS_TEN_MILLIONS = 7;
  DISP_UNITS_HUNDRED_MILLIONS = 8;
  DISP_UNITS_BILLIONS = 9;
  DISP_UNITS_TRILLIONS = 10;
}

// Of-pie sub-chart type and split rule (for CHART_OF_PIE).
enum OfPieType {
  OF_PIE_TYPE_UNKNOWN = 0;
  OF_PIE_TYPE_PIE = 1;   // second chart is a pie
  OF_PIE_TYPE_BAR = 2;   // second chart is a bar
}
enum OfPieSplit {
  OF_PIE_SPLIT_UNKNOWN = 0;
  OF_PIE_SPLIT_AUTO = 1;
  OF_PIE_SPLIT_POS = 2;     // split by position (last N)
  OF_PIE_SPLIT_VAL = 3;     // split by value threshold
  OF_PIE_SPLIT_PERCENT = 4; // split by percentage threshold
  OF_PIE_SPLIT_CUSTOM = 5;  // explicit per-point flags
}

message DataPoint {
  double value = 1;
  optional string label = 2;
  optional uint32 override_color_rgba = 3;

  // For scatter/bubble: one point carries its own X and, for bubble, a
  // size. Line/bar/pie charts ignore these and use `value` as Y.
  optional double x_value = 4;
  optional double bubble_size = 5;

  // Per-point overrides (rare; fall back to series-level when unset).
  optional Marker marker = 6;               // per-point marker style
  optional LineStyle line = 7;              // per-point line stroke (for dPt.spPr.ln)
  optional double explosion = 8;            // per-slice pull for pie/doughnut
  optional string custom_text = 9;          // c:dLbl > c:tx > c:rich override text
  optional bool bubble_3d = 10;             // per-bubble 3D flag

  // For stock charts: which of the OHLC roles this point represents.
  // 0=unset (default), 1=open, 2=high, 3=low, 4=close, 5=volume.
  optional int32 ohlc_role = 11;

  // Reserved for forward extensibility.
}

// Reusable shape styling — shared by chart area, plot area, and other
// rectangular frame decorations. Any omitted field means "inherit from
// the surrounding style (theme, preset, parent frame)".
message FrameStyle {
  optional uint32 fill_color_rgba = 1;
  optional uint32 border_color_rgba = 2;
  optional int32  border_width_mpx = 3;
  optional LineDash border_dash = 4;

  // Opacity of the frame fill (0..1000, 1000 = opaque). Frame border is
  // always opaque; use the dedicated color field for transparency there.
  optional int32 fill_opacity = 5;

  // Border corner radius in milli-pixels (0 = square).
  optional int32 border_radius_mpx = 6;

  // Serialized rich fill (gradient/pattern/image) as a CSS-ish descriptor.
  // When present, `fill_color_rgba` is the solid-color fallback.
  optional string fill_desc = 7;

}

// Reusable text styling — used for axis labels, data labels, chart title.
// Field semantics match the DrawingML a:defRPr / a:rPr pair.
message TextStyle {
  optional string font_family = 1;
  optional int32  size_hundredths_pt = 2; // sz attribute (100 == 1pt)
  optional uint32 color_rgba = 3;
  optional bool   bold = 4;
  optional bool   italic = 5;

  optional bool   underline = 6;
  optional bool   strikethrough = 7;
  // Rotation in 1/60000 of a degree (matches DrawingML a:bodyPr @rot).
  // Positive = clockwise. Keeps full OOXML precision without float.
  optional int32  rotation_60k = 8;
  // Text fill as gradient / pattern descriptor (rare for chart text).
  optional string fill_desc = 9;

}

// Placement of data labels relative to the data point / bar / slice.
enum DLblPos {
  DLBL_POS_UNKNOWN = 0;
  DLBL_POS_CTR = 1;      // centered
  DLBL_POS_IN_END = 2;   // bar/col: top-inside of bar
  DLBL_POS_OUT_END = 3;  // bar/col: outside top
  DLBL_POS_IN_BASE = 4;  // bar/col: inside base
  DLBL_POS_BEST_FIT = 5; // pie: auto-fit
  DLBL_POS_TOP = 6;
  DLBL_POS_BOTTOM = 7;
  DLBL_POS_LEFT = 8;
  DLBL_POS_RIGHT = 9;
}

message Trendline {
  enum Type {
    TRENDLINE_UNKNOWN = 0;
    TRENDLINE_LINEAR = 1;
    TRENDLINE_LOG = 2;
    TRENDLINE_POLY = 3;
    TRENDLINE_POWER = 4;
    TRENDLINE_EXP = 5;
    TRENDLINE_MOVING_AVG = 6;
  }
  Type type = 1;
  optional int32 order = 2;      // poly degree (2..6)
  optional string name = 3;
  optional bool display_equation = 4;
  optional bool display_r_squared = 5;
  optional LineStyle line = 6;
  optional double forward = 7;   // extrapolate forward N units
  optional double backward = 8;  // extrapolate backward N units
  optional double intercept = 9; // force a Y-intercept value

  // Moving-average period (c:period) — only for TRENDLINE_MOVING_AVG.
  // When type == TRENDLINE_POLY use `order` instead.
  optional int32 period = 10;

}

message ErrorBars {
  enum ValType {
    ERR_VAL_UNKNOWN = 0;
    ERR_VAL_FIXED = 1;
    ERR_VAL_PERCENTAGE = 2;
    ERR_VAL_STDDEV = 3;
    ERR_VAL_STDERR = 4;
    ERR_VAL_CUST = 5;
  }
  enum ErrDir {
    ERR_DIR_UNKNOWN = 0;
    ERR_DIR_X = 1;
    ERR_DIR_Y = 2;
  }
  enum ErrBarType {
    ERR_BAR_UNKNOWN = 0;
    ERR_BAR_BOTH = 1;
    ERR_BAR_MINUS = 2;
    ERR_BAR_PLUS = 3;
  }
  ValType val_type = 1;
  ErrDir  direction = 2;
  ErrBarType bar_type = 3;
  optional double value = 4;
  optional bool no_end_cap = 5;
  optional LineStyle line = 6;

  // Asymmetric error values (c:plus / c:minus). When present, `value` is
  // ignored in favor of these explicit bounds. For ERR_VAL_CUST with
  // per-point arrays, use `plus_values` / `minus_values` packed arrays.
  optional double plus_value = 7;
  optional double minus_value = 8;
  repeated double plus_values = 9 [packed=true];
  repeated double minus_values = 10 [packed=true];

}

message LineStyle {
  optional uint32 color_rgba = 1;
  optional int32  width_mpx = 2;   // 1000 = 1px
  optional LineDash dash = 3;
  optional bool smooth = 4;         // Bezier smoothing

  // Line cap: 0=unset (flat), 1=flat/butt, 2=round, 3=square.
  optional int32 cap = 5;
  // Line compound: 0=single, 1=double, 2=thickThin, 3=thinThick, 4=triple.
  optional int32 compound = 6;
  // Line join: 0=unset (miter), 1=miter, 2=round, 3=bevel.
  optional int32 join = 7;
  // Custom dash as alternating mpx segments (when dash == LINE_DASH_UNKNOWN
  // but the user supplied a bespoke pattern). Empty → use `dash` enum.
  repeated int32 custom_dash_mpx = 8 [packed=true];

}

message Marker {
  MarkerStyle style = 1;
  optional int32 size_mpx = 2;      // 1000 = 1px
  optional uint32 color_rgba = 3;

  // Marker stroke (border around marker glyph). Falls back to series line.
  optional LineStyle stroke = 4;
  // For MARKER_PICTURE — image filename ref in the asset sidecar registry.
  optional string picture_src = 5;

}

message DataLabels {
  bool show_value = 1;
  bool show_category_name = 2;
  bool show_series_name = 3;
  bool show_percentage = 4;
  bool show_legend_key = 5;
  optional string number_format = 6;
  optional DLblPos position = 7;
  optional TextStyle text_style = 8;

  // Extensions.
  optional bool show_bubble_size = 9;        // c:showBubbleSize
  optional string separator = 10;            // text between label parts (e.g. "\n" or ", ")
  optional bool show_leader_lines = 11;      // pie/doughnut only
  optional LineStyle leader_line_style = 12; // stroke of the leader connector
  optional FrameStyle fill_style = 13;       // background rect of the label

}

message Legend {
  LegendPosition position = 1;
  bool overlay = 2;

  // Styling of the legend frame + entry text (rare but OOXML allows it).
  optional FrameStyle frame_style = 3;
  optional TextStyle text_style = 4;

}

message Series {
  optional string name = 1;
  repeated DataPoint points = 2;
  optional uint32 color_rgba = 3;

  optional LineStyle line = 4;
  optional Marker marker = 5;
  optional DataLabels data_labels = 6;

  // Combo-chart support: the series' own chart-type (bar vs line etc.)
  // and whether it plots against the secondary value axis.
  optional ChartType chart_type = 7;
  optional bool on_secondary_axis = 8;

  // Series-level rendering tweaks.
  optional bool smooth = 9;                 // line/scatter Bezier smoothing
  optional bool invert_if_negative = 10;    // bar/col flip color for negative
  optional double explosion = 11;           // pie slice pull, 0.0 .. 1.0 (or raw %)

  repeated Trendline trendlines = 12;
  repeated ErrorBars error_bars = 13;

  // Data source expressions (c:f formula strings) — opaque to the renderer
  // but preserved so an editor can re-bind the series to a spreadsheet
  // cell range.
  optional string value_formula = 14;       // c:val/c:yVal/c:numRef/c:f
  optional string category_formula = 15;    // c:cat/c:xVal/c:strRef or numRef/c:f
  optional string bubble_size_formula = 16; // c:bubbleSize/c:numRef/c:f
  optional string name_formula = 17;        // c:tx/c:strRef/c:f

  // Fill that's a gradient / pattern / image rather than a solid color.
  // When present, `color_rgba` is the fallback (first stop / fg color)
  // and the renderer should prefer this field. Serialized as a compact
  // CSS-ish descriptor string; full structured fill is stored via the
  // shared Fill primitive on page.proto. Kept as string here to avoid
  // a cross-proto dependency inside the chart sidecar.
  optional string fill_desc = 18;

  // Leader-line style (pie/doughnut) — inherits from chart-level
  // DataLabels.leader_line_style when unset.
  optional LineStyle leader_line_style = 19;

  // Picture-fill options for bar/column series with an image fill:
  // 0=stretch, 1=stack, 2=stackScale.
  optional int32 picture_options = 20;

  // Hidden/deleted series flag (c:hidden or c:spPr > a:noFill + empty values).
  // Series stays in data model so axis scale is preserved but renderer hides it.
  optional bool hidden = 21;

}

// Manual layout override (c:layout > c:manualLayout) for chart frame
// subregions (title / legend / plot area). Coordinates are fractions of
// the parent chart-area bounding box in the 0.0 .. 1.0 range (mirrors
// OOXML's 0..1 ST_LayoutMode="factor" semantics). Missing fields mean
// "auto-lay-out this dimension".
message ManualLayout {
  optional double x = 1;       // left, fraction of parent width
  optional double y = 2;       // top,  fraction of parent height
  optional double width = 3;   // fraction of parent width
  optional double height = 4;  // fraction of parent height

  // When present, selects between "factor" (fraction of parent bbox) and
  // "edge" (absolute offset from top-left) semantics per axis.
  // 0 = unspecified (factor), 1 = edge, 2 = factor.
  optional int32 x_mode = 5;
  optional int32 y_mode = 6;
  optional int32 w_mode = 7;
  optional int32 h_mode = 8;

}

// Up/Down bars for line + stock charts (c:upDownBars).
message UpDownBars {
  optional int32 gap_width_pct = 1;   // c:gapWidth (default 150)
  optional FrameStyle up_style = 2;   // up bars (when close > open)
  optional FrameStyle down_style = 3; // down bars (when close < open)
}

// Hi-Low lines for line/stock charts (c:hiLowLines) — vertical lines
// connecting the highest and lowest series at each category.
message HiLowLines {
  optional LineStyle line = 1;
}

// Drop lines for line/area charts (c:dropLines) — vertical lines from
// each data point down to the category axis.
message DropLines {
  optional LineStyle line = 1;
}

// Of-pie secondary chart configuration (c:ofPieChart).
message OfPieConfig {
  OfPieType of_pie_type = 1;
  OfPieSplit split_type = 2;
  optional double split_pos = 3;       // threshold value when split_type != AUTO
  repeated int32 custom_split = 4 [packed=true]; // per-point 0/1 assignment
  optional int32 second_pie_size_pct = 5; // size of the secondary chart (5..200)
  optional int32 gap_width_pct = 6;    // c:gapWidth between primary and secondary
  optional LineStyle series_line = 7;  // line connecting the two pies
}

// Theme context snapshot — the slide-master/theme values resolved at
// extract time so the chart renders identically even when detached from
// the page or its theme is later edited. All fields optional; the
// renderer falls back to built-in defaults for anything absent.
message ThemeContext {
  repeated uint32 accent_rgba = 1 [packed=true];    // accent1..accent6 RGBA
  optional string major_font_family = 2;            // theme +mj-lt / mj-ea / mj-cs latin
  optional string minor_font_family = 3;            // theme +mn-lt / mn-ea / mn-cs latin
  optional int32  default_font_size_mpx = 4;        // body text size in mpx (1000 = 1px)
  optional uint32 text_primary_rgba = 5;            // primary text color (lt1/dk1 resolved)
  optional uint32 background_rgba = 6;              // slide bg resolved color
  optional uint32 hyperlink_rgba = 7;
  optional uint32 followed_hyperlink_rgba = 8;

  // Format scheme (fillStyleLst / lnStyleLst) default line weights in mpx —
  // index 0 = first subtle, 1 = moderate, 2 = intense. Used when a chart
  // references a style_id that expects theme line widths.
  repeated int32 line_width_mpx = 9 [packed=true];

}

message AxisConfig {
  optional string title = 1;
  optional double min_val = 2;
  optional double max_val = 3;

  optional string number_format = 4;
  optional bool show_gridlines = 5;       // major gridlines
  optional int32 label_rotation_deg = 6;
  optional bool log_scale = 7;
  optional int32 log_base = 8;

  // Visual axis style.
  optional bool show_minor_gridlines = 9;
  optional TickMark major_tick_mark = 10;
  optional TickMark minor_tick_mark = 11;
  optional TickLabelPos tick_label_pos = 12;

  // Axis scale steps.
  optional double major_unit = 13;
  optional double minor_unit = 14;

  // Axis line color/width, drawn with the tick marks.
  optional uint32 line_color_rgba = 15;
  optional int32  line_width_mpx = 16;

  // Axis label text styling (font / size / color / bold / italic).
  optional TextStyle label_style = 17;

  // Date axis (when the category axis is a c:dateAx): base unit for
  // formatting, plus majorUnit / minorUnit time-unit expressed as a
  // string ("days" | "months" | "years") because the numeric major_unit
  // above is unit-agnostic.
  optional string base_time_unit = 18;
  optional string major_time_unit = 19;
  optional string minor_time_unit = 20;

  // Crossing behavior — where the perpendicular axis crosses this one.
  optional AxisCrosses crosses = 21;
  optional double crosses_at = 22;       // used when crosses == CUSTOM

  // Label offset (c:lblOffset) — 0..1000 as 1/1000 of a percentage.
  // Default 100 in OOXML.
  optional int32 label_offset_pct = 23;
  // Label alignment on category axis: "ctr"/"l"/"r" → 0=unset,1=ctr,2=l,3=r.
  optional int32 label_alignment = 24;
  // Skip every N tick labels (c:tickLblSkip). 1 = show every label.
  optional int32 tick_label_skip = 25;
  // Skip every N tick marks (c:tickMarkSkip). 1 = show every tick.
  optional int32 tick_mark_skip = 26;

  // Display-units scaling and label (c:dispUnits).
  optional DispUnits display_units = 27;
  optional bool     show_display_units_label = 28;
  optional string   display_units_label = 29;

  // Axis position on chart frame: 0=unset, 1=b(bottom), 2=t(top),
  // 3=l(left), 4=r(right). Mirrors c:axPos.
  optional int32 axis_position = 30;

  // Axis deletion — c:delete. When true, hides the axis line and ticks
  // but keeps the axis in the scale calculation.
  optional bool delete_axis = 31;

  // Reversed plot order (c:scaling > c:orientation val="maxMin").
  optional bool reversed = 32;

  // Auto-scaling flag (c:auto) — when true, min/max are computed from
  // data rather than taken from min_val/max_val above.
  optional bool auto_scale = 33;

}

message ChartData {
  int32 slide_index = 1;
  int32 chart_index = 2;
  ChartType type = 3;

  repeated string categories = 4;
  repeated Series series = 5;

  optional AxisConfig category_axis = 6;
  optional AxisConfig value_axis = 7;

  optional string title = 8;

  // Position on slide (milli-pixels): [left, top, width, height, z]
  repeated int32 bounds = 9 [packed=true];

  optional Legend legend = 10;
  optional DataLabels data_labels = 11;

  // Second value axis for dual-scale / combo charts. Series with
  // on_secondary_axis=true plot against this axis.
  optional AxisConfig secondary_value_axis = 12;

  // Chart-type-specific modifiers.
  optional Grouping grouping = 13;       // bar/col/line/area grouping
  optional BarDirection bar_direction = 14; // bar/col orientation
  optional int32 bar_gap_width = 15;     // between category groups, percent (150 = 150%)
  optional int32 bar_overlap = 16;       // between bars within a group, -100..100 percent
  optional int32 first_slice_angle = 17; // pie: start angle in degrees
  optional int32 doughnut_hole_size = 18;// doughnut hole size, percent 10..90
  optional ScatterStyle scatter_style = 19;
  optional RadarStyle radar_style = 20;
  optional DispBlanksAs disp_blanks_as = 21;
  optional bool plot_visible_only = 22;  // plotVisOnly flag

  // 3D-chart view angles (valid for bar3D/line3D/pie3D/area3D).
  optional int32 view3d_rot_x_deg = 23;  // -90..90
  optional int32 view3d_rot_y_deg = 24;  // 0..359
  optional int32 view3d_depth_pct = 25;
  optional int32 view3d_perspective = 26;// 0..100

  // Chart framing — the two rectangular regions every chart has:
  //   chart_area = the entire chart bounding box
  //   plot_area  = the inner area where series are drawn
  optional FrameStyle chart_area_style = 27;
  optional FrameStyle plot_area_style = 28;

  // Font for the chart title (text comes from `title` above).
  optional TextStyle title_style = 29;

  // Bubble-chart modifiers (when type == CHART_BUBBLE).
  optional int32 bubble_scale_pct = 30;       // 0..300 (% of default)
  optional bool  bubble_size_represents_width = 31; // false = area (default)
  optional bool  show_neg_bubbles = 32;
  optional bool  bubble_3d = 33;

  // Title auto-deletion flag — when true, renderer must not auto-generate
  // a title from the single-series name even if `title` is empty.
  optional bool auto_title_deleted = 34;

  // 1904 epoch for date-axis numeric values. Default (false) = 1900 epoch.
  optional bool date_1904 = 35;

  // Additional 3D view angles.
  optional int32 view3d_h_pct = 36;       // height % (5..500)
  optional bool  view3d_r_ang_ax = 37;    // right-angle axes (no perspective distortion)

  // Manual layout overrides for chart frame subregions.
  optional ManualLayout title_layout = 38;
  optional ManualLayout legend_layout = 39;
  optional ManualLayout plot_layout = 40;

  // Theme context snapshot — baked at extract time so rendering is
  // independent of live theme state. Renderer uses this to assign
  // default series colors (accent1..6 cycle) and default fonts.
  optional ThemeContext theme_context = 41;

  // Line/stock chart drop-shadow overlays.
  optional UpDownBars up_down_bars = 42;
  optional HiLowLines hi_low_lines = 43;
  optional DropLines  drop_lines = 44;

  // CHART_OF_PIE specific configuration. Only meaningful when type == CHART_OF_PIE.
  optional OfPieConfig of_pie = 45;

  // ChartEx style catalog reference (c:style val="N" for 2007-2013,
  // cs:chartStyle @styleId for 2016+). 0 = no style, 1..48 = built-in
  // catalog entry. The renderer consults its baked-in style catalog
  // to resolve fills, strokes, fonts in the absence of inline overrides.
  optional int32 style_id = 46;

  // Axis label text and styling for the secondary value axis legend
  // entry (c:legendEntry > c:delete per-entry hide, rare).
  repeated int32 hidden_legend_entries = 47 [packed=true];

  // ChartEx style variant — some decks declare `c:clrMapOvr` overriding
  // the slide theme's color map inside the chart. Stored as an array of
  // 8 mapping ints (bg1,tx1,bg2,tx2,accent1..6 each resolved to theme
  // slot index). Empty array = no override.
  repeated int32 clr_map_override = 48 [packed=true];

  // Chart-level default marker (c:marker under chart type group) applied
  // when series don't set their own.
  optional Marker default_marker = 49;

  // Owning page ContentItem id. Page order and placement stay in page.pb;
  // chart.pb remains the cold/native chart model for that visible item.
  optional uint32 content_item_id = 50;

  // Forward-compatible extension bytes. Unknown future extensions can be
  // round-tripped without schema changes.
  optional bytes unknown_ext = 100;
}

message Charts {
  repeated ChartData charts = 1;

  // Schema version — increment on incompatible layout changes so the
  // renderer can fall back to a migration path.
  optional int32 schema_version = 2;

  // Deck-level theme context — when every chart shares a single theme
  // (common case), this is populated once and per-chart `theme_context`
  // is left unset to save bytes. Renderer merges deck-level with
  // per-chart (per-chart wins on collision).
  optional ThemeContext deck_theme_context = 3;

}