plan

type Anchor struct {
	Kind  string // comment, suggestion, image, footnote
	ID    string
	Start int64
	End   int64
	Text  string
}

type Border struct {
	Clear     bool
	Color     string
	WidthPt   float64
	DashStyle string
}

type BorderSpec struct {
	Raw string
}

type CellLoc struct {
	Table Loc // the table's start index
	Row   int
	Col   int
}

type CellStyleSpec struct {
	Background string // #rrggbb or none
	Align      string // TOP, MIDDLE, BOTTOM (contentAlignment)
	// PaddingPt sets every side; the four below override one side each.
	PaddingPt       *float64
	PaddingTopPt    *float64
	PaddingBottomPt *float64
	PaddingLeftPt   *float64
	PaddingRightPt  *float64
	// Borders take the same shorthand as a paragraph's, minus padding:
	// "1pt solid #cccccc", or "none". Border sets all four sides.
	Border       string
	BorderTop    string
	BorderBottom string
	BorderLeft   string
	BorderRight  string
}

type Compiled struct {
	Requests []json.RawMessage
	Text     string
	Length   int64 // UTF-16 units inserted
	// Start and End bound the inserted content (excluding the prefix
	// newline, including the suffix newline).
	Start int64
	End   int64
}

type DateSpec struct {
	Timestamp  string // RFC 3339
	TimeZoneID string // CLDR id such as Europe/Copenhagen; default UTC
	DateFormat string // a DateFormats key; "" for the API default
	TimeFormat string // TIME_FORMAT_* enum
}

type Edit struct {
	Pos    int64
	Delete int64 // units to delete at Pos, 0 for pure insert
	Insert string
}

type FragmentOptions struct {
	// Prefix puts a newline before the fragment: used when inserting
	// before a segment's final newline (append at end).
	Prefix bool
	// Suffix puts a newline after the fragment: used when inserting at a
	// block boundary so the following block stays separate.
	Suffix bool
	// NearBullet says the paragraph at the insertion point is a list
	// item; inserted non-list paragraphs then explicitly drop the bullet
	// they would inherit.
	NearBullet bool
	// Inline says the insertion point is inside an existing paragraph:
	// the first fragment paragraph merges into it and keeps its style.
	Inline bool
	// Fill says the paragraph at an inline insertion point is empty, so
	// the first fragment paragraph takes its own style instead.
	Fill bool
}

type Group int

type KindInfo struct {
	Tool    Tool
	Shape   Shape
	Content bool // carries a markdown fragment
	// Deletes says the op removes existing content, which the overwrite
	// guard inspects.
	Deletes bool
	Group   Group
	// Structural says the op changes a table's grid, which renumbers rows
	// or columns; at most one per table per batch.
	Structural bool
	// Followup says the op may create something (a segment, a table)
	// whose content lands in a second batch once it exists.
	Followup bool
	// SuggestRefused names the request kind the API refuses in SUGGEST
	// mode, when the op compiles to one.
	SuggestRefused string
	// Reply names the batchUpdate reply an op that creates a segment
	// comes back in; the reply carries the new segment's id.
	Reply string
	// Noun is what the op works on, for messages: "header", "footer",
	// "footnote", "table".
	Noun string
}

type Loc struct {
	Index     int64
	SegmentID string
	TabID     string
}

type Mode string

type NamedRangeParams struct {
	// Name is the range's name. Several ranges may share one, and every
	// one of them is deleted or filled together.
	Name string
	// ID names exactly one range instead, as a read reports it.
	ID string
	// Text is the plain text replace_named_range writes over the range.
	Text string
}

type NamedStyleSpec struct {
	Style string // NORMAL_TEXT, TITLE, SUBTITLE, HEADING_1..6
	Text  TextStyleSpec
	Para  ParagraphStyleSpec
}

type ObjectParams struct {
	Kind     string // image, person, rich_link, date
	URL      string
	WidthPt  float64
	HeightPt float64
	Name     string
	Email    string
	Title    string
	Date     DateSpec
	// ID names the object replace_image and delete_object work on, and
	// Positioned says it floats: a positioned object has no range, so it
	// is removed by id rather than by deleting the text it sits in.
	ID         string
	Positioned bool
	// Crop asks Google to centre-crop the new image into the old one's
	// size instead of resizing the frame.
	Crop bool
}

type Op struct {
	Seq         int
	Kind        OpKind
	Seg         Segment
	Description string
	Params

	// Target is the affected range for replace, delete and formatting.
	Target *Rng
	// TargetIsBlock says Target covers whole blocks including the trailing newline.
	TargetIsBlock bool
	// TargetText is the current text of Target (inline view, no trailing newline).
	TargetText string
	// TargetAligned is TargetText with every non-text element (chips,
	// images, footnote references, breaks) replaced by U+FFFC per UTF-16
	// unit, so its offsets line up with the index space. Empty when the
	// service could not build it; the minimal diff then needs TargetText
	// to be exact.
	TargetAligned string

	// Insert is the insertion point for insert, append, breaks and footnotes.
	Insert *Loc
	// AtEnd says the insertion point is the segment's final newline (append form).
	AtEnd bool
	// Inline says the insertion point is inside a paragraph: the first
	// fragment paragraph merges into it and no boundary newline is added.
	Inline bool
	// Fill says that paragraph is blank, so the first fragment paragraph
	// styles it rather than inheriting its style. ClearTo, when greater
	// than the insertion point, is the whitespace the fill replaces.
	Fill    bool
	ClearTo int64
	// NearBullet says the paragraph at the insertion point is a list item.
	NearBullet bool

	Fragment *markdown.Fragment

	// CommentAnchor is where a comment-mode proposal attaches. Defaults to Target.
	CommentAnchor *Rng
	Anchors       []Anchor

	// TableAt is the start of the table a table op works on.
	TableAt *Loc
	Table   TableParams
	Object  ObjectParams
	// SegmentRef names the header or footer a delete_header/delete_footer removes.
	SegmentRef string

	// Page, Section and NamedStyle carry the layout ops' specs.
	Page       PageSpec
	Section    SectionSpec
	NamedStyle NamedStyleSpec
	// SectionType is what a section_break starts.
	SectionType string
	// NamedRange names the range a named-range op works on.
	NamedRange NamedRangeParams
}

type OpKind string

type OpSummary struct {
	Seq         int    `json:"op"`
	Kind        OpKind `json:"kind"`
	Description string `json:"target"`
	Requests    int    `json:"requests"`
	Minimal     bool   `json:"minimal_diff,omitempty"`
}

type Options struct {
	Mode  Mode
	Force bool
}

type PageMargins struct {
	TopPt    *float64
	BottomPt *float64
	LeftPt   *float64
	RightPt  *float64
}

type PageSpec struct {
	WidthPt  float64
	HeightPt float64
	PageMargins
	MarginHeaderPt        *float64
	MarginFooterPt        *float64
	Background            string
	PageNumberStart       *int
	Landscape             *bool
	FirstPageHeaderFooter *bool
	EvenPageHeaderFooter  *bool
}

type ParagraphStyleSpec struct {
	NamedStyle      string // NORMAL_TEXT, HEADING_1..6, TITLE, SUBTITLE
	Alignment       string // START, CENTER, END, JUSTIFIED
	Direction       string // LEFT_TO_RIGHT, RIGHT_TO_LEFT
	SpacingMode     string // NEVER_COLLAPSE, COLLAPSE_LISTS
	LineSpacing     float64
	SpaceAbovePt    *float64
	SpaceBelowPt    *float64
	IndentStartPt   *float64
	IndentEndPt     *float64
	IndentFirstLine *float64
	KeepWithNext    *bool
	// Shading is the paragraph background, #rrggbb or "none".
	Shading string
	// Borders are the shorthand strings; Border replaces every side.
	Border              string
	BorderTop           string
	BorderBottom        string
	BorderLeft          string
	BorderRight         string
	BorderBetween       string
	BorderPaddingPt     *float64
	KeepLinesTogether   *bool
	AvoidWidowAndOrphan *bool
	PageBreakBefore     *bool
}

type Params struct {
	Find      string
	Replace   string
	MatchCase bool
	Text      TextStyleSpec
	Para      ParagraphStyleSpec
	Bullets   string // bullet, numbered, checkbox, none
}

type Proposal struct {
	Seq     int
	Content string
	Range   Rng
	Quote   string
}

type Result struct {
	Requests  []json.RawMessage
	Proposals []Proposal
	// Followups are the ops whose content lands in a second batch once
	// the first has created its home: a new header, footer or footnote
	// (the reply names the segment) or a table inserted with a data grid
	// (found again by the handle its position predicts).
	Followups []*Op
	Warnings  []string
	Summary   []OpSummary
}

type Rng struct {
	Start     int64
	End       int64
	SegmentID string
	TabID     string
}

type SectionSpec struct {
	PageMargins
	Columns               int
	ColumnGapPt           *float64
	ColumnSeparator       string // none or between
	ContentDirection      string // LEFT_TO_RIGHT or RIGHT_TO_LEFT
	PageNumberStart       *int
	Landscape             *bool
	FirstPageHeaderFooter *bool
}

type Segment struct {
	ID    string
	TabID string
	Start int64
	End   int64
}

type Shape int

type TabProperties struct {
	Title    string
	Index    *int
	ParentID string
	Emoji    string
}

type TableParams struct {
	Rows, Cols int // insert_table size; table size for other ops
	Row, Col   int // reference cell
	Count      int
	Before     bool  // insert above / to the left
	Indices    []int // rows or columns to delete
	RowSpan    int
	ColSpan    int
	Cell       CellStyleSpec
	HeaderRows int
	// Data is the grid an insert_table fills after the table exists.
	Data [][]string
	// WidthPt and Even size the columns style_columns names; Even
	// distributes them and takes no width.
	WidthPt *float64
	Even    bool
	// MinHeightPt and PreventOverflow style the rows style_rows names.
	MinHeightPt     *float64
	PreventOverflow *bool
}

type TextStyleSpec struct {
	Bold          *bool
	Italic        *bool
	Underline     *bool
	Strikethrough *bool
	SmallCaps     *bool
	Font          string
	SizePt        float64
	Foreground    string
	Background    string
	Link          string
	Baseline      string // SUPERSCRIPT, SUBSCRIPT, NONE
}

type Tool string