ixbrl

type Context struct {
	ID        string
	Start     time.Time
	End       time.Time
	EntityCIK string // raw identifier text, e.g. "0000320193"
	Segments  []Segment
}

type Fact struct {
	// Concept is the taxonomy name, e.g. "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax".
	Concept string
	// ContextRef is the context ID the value is reported against.
	ContextRef string
	// UnitRef is the unit ID for numeric facts (e.g. "usd", "shares"); empty for text facts.
	UnitRef string
	// Numeric distinguishes ix:nonFraction (true) from ix:nonNumeric (false).
	Numeric bool
	// Raw is the fact's text content as it appeared in the document, before
	// decoration stripping or scaling.
	Raw string
	// Value is the parsed, scaled, signed numeric value. Meaningful only when Numeric is true.
	Value float64
	// Scale is the power of ten applied to the source digits (scale="6" → ×10^6).
	Scale int
	// Decimals is the source decimals attribute — informational precision, not magnitude.
	Decimals string
	// Negative records whether the value was negated (sign="-" or surrounding parentheses).
	Negative bool
	// Unparsed marks a numeric fact whose content could not be resolved to a
	// number — typically an exotic iXBRL transform (spelled-out words, dates)
	// on a narrative custom concept. Raw is preserved; Value is 0. Financial
	// statement values use the common dot/comma/dash transforms and parse cleanly.
	Unparsed bool
	// ID is the fact's id attribute (e.g. "f-66"). golang.org/x/net/html exposes
	// no line/column, so this is the fact's source locator for debugging.
	ID string
}

type LinkbaseRole struct {
	// RoleURI identifies the statement, e.g.
	// "http://www.apple.com/role/CONSOLIDATEDSTATEMENTSOFOPERATIONS".
	RoleURI string
	// Title is the human-readable statement name from the schema's role
	// definition (e.g. "CONSOLIDATED STATEMENTS OF OPERATIONS"); when the schema
	// is unavailable it is derived from the role URI's final path segment.
	Title string
	// Concepts is the ordered concept list for the statement.
	Concepts []RoleConcept
}

type RoleConcept struct {
	// Name is the taxonomy concept in prefix:Local form, e.g. "us-gaap:GrossProfit".
	Name string
	// Label is the resolved display text for this concept under its preferred
	// label role — the filing's own wording ("Net sales", "Total operating
	// expenses"), not the generic taxonomy label.
	Label string
	// PreferredLabel is the label-role URI the presentation arc requested, or ""
	// for a root (which has no incoming arc).
	PreferredLabel string
	// Depth is the nesting level in the presentation tree (root = 0).
	Depth int
	// HasChildren is true when the concept is a parent in the tree.
	HasChildren bool
	// Structural marks abstract and dimensional grouping nodes (Abstract, Table,
	// Axis, Domain, Member, LineItems) that organise the statement but never
	// carry a fact. Projection keeps them for structure but omits them as rows.
	Structural bool
}

type Segment struct {
	Dimension string // e.g. us-gaap:StatementClassOfStockAxis
	Member    string // e.g. aapl:A1.625NotesDue2026Member
}