Package-level declarations

Represents the environment (variable bindings and context) used when rendering a KbTemplate.

DSL receiver passed to the configure lambda of KbEnvironment.create for registering transforms and properties on the environment under construction.

A caller-supplied observer that is notified of soft failures during a KbTemplate render.

Base class for all kBars runtime exceptions.

Thrown by KbTemplate.render when the template source cannot be parsed.

A caller-supplied loader that resolves a partial key to the KbTemplate to render in place of a {{> key }} tag.

Thrown by KbTemplate.render when the template source parses successfully but a fatal error occurs at render time.

A structured description of a single soft failure that occurred while rendering a KbTemplate.

The position of a failing expression within the template source.

Represents a compiled kBars template ready for rendering.

Identifies which template a KbSourceLocation was captured from.

A pluggable transformation applied to a KpaElement inside an expression chain (e.g. {{ foo | upcase }}).

A value that flows through the kBars transform chain. A KbTransformable wraps a KpaElement or — in the future — other scalar types like DateTime. This separates transform-chain results from the base data model.

The receiver scope inside a KbTransform lambda. Exposes coercion helpers and the active KpaElementFactory so transforms can read inputs as Kotlin types and produce typed KpaElement results without hard-coding an adapter family.

Extracts the wrapped kotlin.time.Instant from value, or null when value is not a KbTransformable.DateTime.

Extracts the wrapped KpaElement from value, or null when value is null.

Coerces element to an Int by routing through asString then toIntOrNull, returning null when the string is not a valid integer representation.

Extracts the wrapped KpaList from value, or null when value is null or wraps a non-list element.

Coerces element to a Double when it wraps a numeric primitive or a numeric-string primitive; null otherwise.

Coerces value to its rendered string form using the same rule as {{ identifier }}.

Wraps value as a boolean KbTransformable.

Wraps value as a KbTransformable.DateTime.

Null-safely wraps value as a KbTransformable, returning null when value is null.

Wraps items as a list KbTransformable using the active KbTransformScope.factory.

Wraps value as a numeric KbTransformable.

Wraps value as a string KbTransformable.