Documentation
¶
Overview ¶
Package truncate carries the shared cut mechanics for bounded serving (d-tac-qwc): pure functions that cut strings and item slices against byte or count caps, and the Cut accounting record every bound firing produces. Data stays separated from meta — a carrier pairs the payload with its Cut, so consumers render the payload while the cut travels out of band and each surface phrases its notice in its own register. This package carries no notice wording.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Carrier ¶
Carrier pairs a payload with its cut meta. A seam that receives one hands the payload on unchanged and routes the meta out of band.
type Cut ¶
type Cut struct {
// Part names what was cut — a lane, an inject id, a store field. Left to
// the seam that knows the name; producers leave it empty.
Part string
// Dropped and Total count whole items on item cuts; zero on byte cuts.
Dropped, Total int
// KeptBytes and TotalBytes account the byte weight after and before.
KeptBytes, TotalBytes int
// Pull is a ready-to-run expression for the remainder; empty when none
// applies.
Pull string
}
Cut is the accounting record of one bound firing: what remains, what was dropped, and how to pull the remainder. The zero value means clean.
type List ¶
List carries items and their cut meta; templates and projections consume Items, never the meta.
func Head ¶
Head keeps the first maxItems items — the count cut for typed data whose rendered size is unknowable before a template renders it; byte safety comes from measured allowances and the serve-size regression harness. maxItems <= 0 means unbounded.
Source Files