ntable

type BatchDelta struct {
	OperationID   string             `json:"operation_id"`
	Digest        string             `json:"digest"`
	Actor         string             `json:"actor"`
	SelectedCount int                `json:"selected_count"`
	GuardCount    int                `json:"guard_count"`
	ChangedCount  int                `json:"changed_count"`
	Members       []BatchMemberDelta `json:"members"`
	// Props are the table's properties the batch changed, name -> new value
	// (L1 contract amendment, table properties).
	Props map[string]string `json:"props,omitempty"`
}

type BatchManifest struct {
	Schema                int                `json:"schema"`
	Table                 string             `json:"table"`
	Epoch                 string             `json:"epoch"`
	ExpectedTableRevision string             `json:"expected_table_revision"`
	OperationID           string             `json:"operation_id"`
	Actor                 string             `json:"actor,omitempty"`
	Members               []BatchMemberEntry `json:"members"`
	// Props are the table's properties the batch sets, PropExpect the ones it
	// expects present with a value and PropAbsent the ones it expects absent,
	// checked before any write and applied in the same atomic call as the
	// members (L1 contract amendment, table properties, section 4).
	Props      map[string]string `json:"props,omitempty"`
	PropExpect map[string]string `json:"prop_expect,omitempty"`
	PropAbsent []string          `json:"prop_absent,omitempty"`
}

type BatchMemberDelta struct {
	ID          string `json:"id"`
	BeforePlace string `json:"before_place"`
	AfterPlace  string `json:"after_place"`
	// BeforeScore and AfterScore are the scores parsed; BeforeScoreText and
	// AfterScoreText are the exact decimal strings the store holds, which two
	// different scores never share. Nil is no score (unplaced).
	BeforeScore     *float64               `json:"-"`
	AfterScore      *float64               `json:"-"`
	BeforeScoreText *string                `json:"before_score"`
	AfterScoreText  *string                `json:"after_score"`
	BeforeRev       string                 `json:"before_rev"`
	AfterRev        string                 `json:"after_rev"`
	FieldsSet       map[string]string      `json:"fields_set"`
	FieldsUnset     []string               `json:"fields_unset"`
	Fields          map[string]FieldChange `json:"fields"`
}

type BatchMemberEntry struct {
	ID     string            `json:"id"`
	Expect *MemberExpect     `json:"expect,omitempty"`
	Create *MemberCreateOp   `json:"create,omitempty"`
	Move   *MemberMoveOp     `json:"move,omitempty"`
	Remove bool              `json:"remove,omitempty"`
	Set    map[string]string `json:"set,omitempty"`
	Unset  []string          `json:"unset,omitempty"`
}

type BoundError struct{ Table, Row, Col, Key, Owner string }

type Cell struct {
	Key     string
	Bound   bool
	Count   int64
	Members []Member
	Unread  bool
	// UnreadWhy says why the set did not come back: the key and the type found
	// ("key K is string, expected zset"), or the store's error.
	UnreadWhy string
}

type CellSelection struct {
	Row string `json:"row"`
	Col string `json:"col"`
}

type CellsCmd struct {
	// contains filtered or unexported fields
}

type CheckReport = typedrec.TableCheck

type Column struct {
	Name       string
	Label      string
	Projection string
	Fold       string
	Width      int
}

type CountCmd struct {
	// contains filtered or unexported fields
}

type FieldChange struct {
	Before      *string `json:"before"`
	After       *string `json:"after"`
	BeforeBytes int     `json:"before_bytes,omitempty"`
	BeforeSHA1  string  `json:"before_sha1,omitempty"`
	AfterBytes  int     `json:"after_bytes,omitempty"`
	AfterSHA1   string  `json:"after_sha1,omitempty"`
}

type FieldGuard struct {
	Equals *string  `json:"equals,omitempty"`
	Absent *bool    `json:"absent,omitempty"`
	OneOf  []string `json:"one_of,omitempty"`
}

type Formula struct {
	Sum  bool
	Part string
	Over []string
}

type LimitError struct {
	Name            string
	Bound, Observed int
	Member          string
	// AtLeast says the call stopped counting when it passed the bound: the true
	// size is at least Observed.
	AtLeast bool
}

type ManifestError struct {
	Where, Msg string
}

type Member struct {
	Member string
	Score  float64
}

type MemberCreateOp struct {
	Row   string  `json:"row"`
	Col   string  `json:"col"`
	Score float64 `json:"score"`
}

type MemberExpect struct {
	Absent   bool                  `json:"absent,omitempty"`
	Revision string                `json:"revision,omitempty"`
	Place    *PlaceExpect          `json:"place,omitempty"`
	Fields   map[string]FieldGuard `json:"fields,omitempty"`
}

type MemberLocation = typedrec.TableMember

type MemberMoveOp struct {
	Row   string   `json:"row"`
	Col   string   `json:"col"`
	Score *float64 `json:"score,omitempty"`
}

type Place struct {
	Where string // first, last, before, after
	Ref   string // the neighbour, for before and after
}

type PlaceExpect struct {
	Row string `json:"row"`
	Col string `json:"col"`
}

type ReadCmd struct {
	// contains filtered or unexported fields
}

type ReadSetCmd struct {
	// contains filtered or unexported fields
}

type ReadSetMember struct {
	ID       string
	Revision uint64
	Placed   bool
	Row      string
	Col      string
	Score    float64
	// ScoreText is the score exactly as the store holds it.
	ScoreText string
	Fields    map[string]string
}

type ReadSetResult struct {
	Table    string
	Epoch    uint64
	Revision uint64
	Members  []ReadSetMember
	Missing  []string
}

type ReadSetScope struct {
	Members   []string        `json:"members,omitempty"`
	Selection []CellSelection `json:"selection,omitempty"`
}

type Reader struct{ Name string }

type Receipt struct {
	ID                   string
	Epoch, Before, After uint64
	Outcome              string
	BatchDelta           *BatchDelta
	// Replay is true when ApplyBatch returned the receipt recorded for an
	// operation it had already applied, and wrote nothing.
	Replay bool
}

type Refusal struct {
	Code     string // the store's refusal code: NOTMEMBER, LIMIT, MEMBERREVISION, ...
	Location string // the operation: table "demo" batch "op-1" member "a"
	Sentence string // what was expected against what was found
	Next     string // a command that runs when pasted
	Guarded  bool   // a batch or a read set: it wrote nothing, and says so
	// contains filtered or unexported fields
}

type RenderOpts struct {
	// Widths fixes a column's width by name (a minimum: a longer cell is
	// not cut), over the column's own Width; 0 leaves it as wide as its
	// widest cell.
	Widths map[string]int
	// LabelWidth fixes the row-label column's width the same way (the
	// sprint's stream block keeps its names 25 wide); 0 fits the labels.
	LabelWidth int
	// Title is the table's name, printed in the top-left cell, the header
	// of the row-label column (the owner 2026-09-27: "tables need a title";
	// "the title goes where 'row' is currently").
	Title string
}

type Reorder struct {
	Item string
	Place
}

type Row struct {
	Key     string
	Label   string
	Exclude string
	Owner   string
	Cells   []Cell
	Texts   map[string]string // a text column's value for this row (row set <col>=<value>), else blank
	Hidden  bool              // kept and counted in the folds, not drawn (row hide)
}

type RowSpec struct {
	Label   string            `json:"label"`
	Exclude string            `json:"exclude"`
	Owner   string            `json:"owner"`
	Binds   map[string]string `json:"binds,omitempty"`
}

type RuleError struct {
	Code   string // the store's refusal code for the same rule
	Member string // the member at fault, if one is
	Msg    string // the sentence, naming the member
	Detail string // the sentence without the member
	// contains filtered or unexported fields
}

type SetOpts struct {
	Footer     *string
	Rename     string
	Columns    []Column
	Hidden     *[]string
	Hide, Show []string // atomic deltas to the hidden column list
	Visible    *bool
	// One column added (at the end, or where At says), removed (refused
	// while it holds members or text) or moved; the other columns stand.
	ColAdd  *Column
	ColAt   *Place // where ColAdd enters; nil is last
	ColDel  string
	ColMove *Reorder
	// The rows' order: all sorted, then the named rows first, then one row
	// moved, in that order when several are given. A standing sort refuses
	// RowOrder and RowMove unless RowSort clears it in the same call.
	RowSort  *Sort
	RowOrder []string
	RowMove  *Reorder
}

type Sort struct {
	By     string
	Desc   bool
	Keep   bool
	Manual bool
}

type Summary struct {
	Name          string
	Columns, Rows int64
}

type Table struct {
	// EpochKey/Field bind this table to a shared epoch domain. An empty key
	// means epoch zero permanently; the default field for a key is "n".
	EpochKey     string
	EpochField   string
	MemberPrefix string
	// Epoch and Revision describe the snapshot returned by the store.
	Epoch       uint64
	Revision    uint64
	Name        string
	Columns     []Column
	FooterLabel string
	Hidden      []string // columns kept, read and used by formulas, but not drawn (set --hide)
	HiddenTable bool     // the whole table kept and read, not drawn by watch (set --hidden / --visible)
	Sort        string   // the standing row sort (row sort --keep): name, -name, label, -label; empty is by hand
	Rows        []Row
	// Props are the table's properties at the snapshot's epoch, name -> value
	// (nil when it has none): values a batch writes with its members, such as
	// a rolling index (L1 contract amendment, table properties).
	Props map[string]string
}

type View struct {
	Name    string
	Tables  []string
	Title   string
	Summary string // the count column of the first table the summary line counts as done ("" for no line)
	// State, when set, is the summary line, alone, in place of the counts:
	// the state of whatever fills the view ("STOPPED"). ViewState writes it;
	// ViewSet leaves it as it is.
	State string
}

type WriteOptions struct {
	Epoch uint64
	Actor string
	Fence string
	Idem  string
	// Receipt receives the committed event without another store exchange.
	Receipt *Receipt
}