API Reference

Reified.Constraint

Catalogue

Module

The built-in message catalogue, and what a translator must cover.

Constraint

Module

Creates, executes, composes, and inspects constraints.

ConstraintAtom

Module

Projects message keys and default English phrases from expectation values.

ConstraintDSL

Module

Constraint constructors usable without the Constraint.

ConstraintDescription

Module

Builds and traverses constraint descriptions.

ConstraintValue

Module

Builds and renders portable constraint values.

ConstraintValueInternals

Module

The boxed-value projection behind tryCreate.

MessageDescriptor

Module

Reads and builds message identities.

MessageFormatSpec

Module

Reads and builds catalogue-owned rendering metadata.

Renderer

Module

Builds renderers and renders messages through them.

UnsupportedOperation

Module

Projects message keys and default English phrases from unsupported-operand reports.

Violation

Module

Inspects, traverses, and renders violations.

AtomicViolation

Union

Why one indivisible constraint failed.

Cardinality

Union

What a size rule expects of a text length or collection count.

Constraint<'value>

Type

A reusable description of valid values, coupled to the closures that execute it.

ConstraintAtom

Union

One interpreted primitive: the complete semantic identity of a built-in constraint.

ConstraintDescription

Record

What a constraint says, as inspectable data.

ConstraintExpression

Union

The logical form of a constraint.

ConstraintValue

Union

The closed set of operand and actual-value representations a constraint may carry across a description, diagnostic, or localization boundary.

Format

Union

The built-in text formats.

Membership

Union

What a membership rule expects.

MessageDescriptor

Record

A message identity and the operands its template may interpolate.

MessageFormatSpec

Record

A descriptor plus the rendering metadata its owning catalogue holds: the neutral fallback template and the optional plural operand.

MessageFormatSpecError

Union

Why a message format specification was rejected.

MessageKeyError

Union

Why a relative message key could not be parsed.

MessageLeaf

Union

One leaf of a projected message tree.

MessageLookup

Type

The ordinary resource lookup: an encoded resource key in, a translated template out.

MessageRequest

Record

One contextual level's request to an advanced resolver.

MessageResolution

Union

What an advanced resolver found for one contextual level.

MessageResolver

Type

Resolves one contextual level, or declines so Reified continues to a less specific one.

MessageTree

Union

A violation projected for an external localization system, retaining its grouping.

Number

Union

What a numeric-property rule expects.

OpaqueConstraint

Union

Why a constraint is invisible to export and proof.

PortableFloat

Record

An IEEE double retaining structural self-equality, including NaN and signed zero.

PortableFloat32

Record

An IEEE single retaining structural self-equality, including NaN and signed zero.

Presence

Union

What a presence rule expects of a value's shape.

Relation

Union

What an ordering or equality rule expects.

RelationOperator

Union

The comparison a relation asserts between a value and an operand.

Renderer

Type

Renders localized messages for one document context and attribute.

UnsupportedOperation

Union

A built-in operation that received an operand outside the portable value set.

ValueFormatRequest

Record

A value to format, with the placeholder's format suffix when it carried one.

Violation

Union

Why a value failed its constraint.

Reified.Data

Data

Module

No description available.

DataDSL

Module

Concise opt-in syntax for literals, immutable edits, cases, and matching.

DataEdit

Module

No description available.

DataErgonomicsHelpers

Module

No description available.

DataPath

Module

Helpers for constructing, parsing, and rendering structured data paths.

Data

Union

A portable tree for structured data.

DataCase

Record

A named materialized structured-data case.

DataDifference

Record

One focused difference between expected and actual structured data.

DataDifferenceCause

Union

The reason an exact structural comparison differed.

DataDimension

Record

One independent axis in a bounded Cartesian data matrix.

DataEdit

Type

An opaque immutable edit applied by Data.tryPatch or Data.patch.

DataExpectation

Type

An opaque path-based expectation.

DataField

Type

An opaque object-field instruction shared by data literals and object patterns.

DataMatchException

Type

Raised by matching when one or more expectations fail.

DataMismatch

Record

One failed selective or recursive data expectation.

DataPatchException

Type

Raised by Data.patch when an edit cannot be applied.

DataPatchFailure

Record

Describes why one immutable data edit could not be applied.

DataPath

Type

A path that addresses a location in structured data.

DataPathSegment

Union

A segment in a structured data path.

DataPattern

Type

An opaque recursive expectation used to match structured data.

DataVariation

Record

A named immutable variation from one baseline value.

PatternConversion

Type

No description available.

Reified.Parse

Reified.Refinements

Refinements

Namespace

No description available.

Bounded

Module

Operations over values that carry their permitted range.

BoundedFloat

Module

Operations over bounded values whose bounds carry a numeric width.

DistinctList

Module

Operations over lists known to hold no duplicates.

FiniteFloat

Module

Operations over floats that are known to be neither infinite nor <c>NaN</c>.

FiniteFloat32

Module

Operations over single-precision floats that are known to be finite.

Interval

Module

Operations over inclusive ranges of ordered values.

NonBlankString

Module

Operations over text known to carry non-whitespace content.

NonEmptyArray

Module

Operations over arrays that carry their non-emptiness in the type.

NonEmptyList

Module

Operations over lists that carry their non-emptiness in the type.

Refine

Module

Smart constructors for built-in refined values, and the refinements behind them.

Character

Module

Character predicate helpers.

Choice

Module

Choice combinators for ordinary fallible conversion functions.

Collection

Module

Collection refined value constructors and helpers.

Text

Module

Text refined value constructors and helpers.

Refinement

Module

Creates and applies reusable refinement definitions.

UnitInterval

Module

Operations over proportions between zero and one.

Bounded<'value>

Record

A value paired with the inclusive interval it is known to lie within.

DateRange

Type

An inclusive range of instants.

DistinctList<'value>

Union

A list with no duplicate items, preserving first-seen order.

FiniteFloat

Union

A double-precision float that is neither infinite nor NaN.

FiniteFloat32

Union

A single-precision float that is neither infinite nor NaN.

Interval<'value>

Record

An inclusive range of ordered values where Lower <= Upper.

NonBlankString

Union

A string that is not null, empty, or whitespace.

NonEmptyArray<'value>

Union

An array that contains at least one item.

NonEmptyList<'value>

Union

A list that contains at least one item.

Refinement<'underlying, 'refined>

Type

Admission into an invariant-carrying value, and its total reverse projection.

UnitInterval

Union

A finite double between zero and one inclusive.

Reified.Result

Reified.Schema

Contract

Module

# `Contract` A schema describes the current model.

EnumCase

Module

Functions for defining explicit payload-less enum schema cases.

ExternalFieldName

Module

Functions for creating and inspecting external schema field names.

Field

Module

Functions for inspecting schema field metadata.

FieldOrder

Module

Functions for creating and inspecting schema field order metadata.

Inspect

Module

# `Inspect` `Inspect.model` turns a schema into finite metadata without parsing input or running application code.

JsonSchema

Module

# `JsonSchema` `JsonSchema.generate` publishes a schema as JSON Schema Draft 2020-12.

RefinedSchemas

Module

Ready-made schemas for the built-in refined values.

RetainedParseResult

Module

Functions for creating and rendering retained schema parse results.

Schema

Module

# `Schema` The `Schema` module contains primitive schemas, collection and recursion combinators, union constructors, and the operations that parse or check a completed declaration.

SchemaCheck

Module

Functions for running executable value checks against refined and primitive value schemas.

SchemaDSL

Module

The concise schema-definition vocabulary: the record computation expression, its field and constructor forms, and the collection-schema operations.

SchemaError

Module

Functions for lowering and rendering boundary schema failures.

SchemaErrors

Module

Functions for inspecting and rendering accumulated schema failures.

SchemaFormat

Module

Functions for creating and inspecting schema value format metadata.

SchemaMessages

Module

The message keys Schema's own failures render through.

SchemaPath

Module

Functions for building and formatting schema error paths.

SchemaValidation

Module

Marks the package that owns schema input, diagnostics, validation, and rules interpreters.

UnionCase

Module

Functions for defining explicit tagged union schema cases.

UnionRepresentations

Module

Common complete representations for recommended authoring and serializer-compatible lifting.

Contract<'model>

Record

A versioned wire contract whose successful result is the current domain model.

ContractBuilder<'model, 'current>

Record

A progressively typed version chain.

ContractError

Union

A failure to select, parse, or migrate a versioned contract.

EnumCase<'enum>

Type

Describes one payload-less case for Schema.enumOf.

EnumCaseDescription

Record

Describes one case in a bare-string enum value schema.

EnumDescription

Record

Describes a bare-string enum value schema.

ExternalFieldName

Type

Represents the source-facing name of a schema field.

Field<'model, 'value>

Type

Describes one typed field of a trusted model for schema interpreters.

FieldDescription

Record

Describes one field of a model schema for inspection interpreters.

FieldOrder

Type

Represents the zero-based position of a schema field in a model constructor and ordered interpreter output.

IRecordPlanCompiler<'model, 'result>

Type

Builds an interpreter-specific typed record plan from a model schema's authored shape.

IRecordPlanState<'model, 'constructorIn, 'constructorOut>

Type

Holds an interpreter-specific typed record-plan fragment while compiling a schema.

MigrationError

Union

A failure produced while migrating an older wire representation.

ModelDescription

Record

Describes a built model schema as an ordered list of field descriptions.

PrimitiveValueKind

Union

Identifies the intrinsic primitive shape of a schema value.

RetainedParseResult<'value>

Record

A schema parse result that retains its original structured input.

Schema<'model>

Type

# `Schema<'model>` A `Schema<'model>` is a reusable declaration of a structured boundary.

SchemaDefaults

Type

Canonical value-schema resolution for a schema field.

SchemaDescription

Record

Describes one value schema: its shape, declared format, and portable constraint metadata.

SchemaError

Union

Schema input, checking, and contextual rule failures attached to diagnostics paths.

SchemaErrors

Type

One or more accumulated schema failures.

SchemaFormat

Type

Identifies the portable named format of a schema value, such as email.

SchemaIssue

Record

One schema failure and its complete structural location.

SchemaParseOptions

Record

Options that customize how structured data is parsed through a schema.

SchemaPath

Type

An immutable location within structured schema input.

SchemaShape

Union

Describes the shape of a value schema as inspectable metadata for non-validation interpreters.

Supply

Union

Whether boundary input for a field must be supplied.

UnionCase<'union>

Type

Describes one tagged union case for Schema.union and its compatibility variants.

UnionCaseDescription

Record

Describes one case in a union value schema.

UnionCaseShape

Union

Describes the semantic payload shape of one union case.

UnionDescription

Record

Describes a tagged union value schema.

UnionPayloadStyle

Union

Controls how a case's authored fields are represented inside adjacent or external tagging.

UnionRepresentation

Union

A complete, inspectable union wire representation.

VersionSource

Union

The explicit source of a contract version.

field<'model, 'target>

Type

Declares one field inside schema<'model> { }, and configures it when followed by a block.

DerivedSchema

Namespace

No description available.

AtLeastAttribute

Type

Bounds a numeric field's value inclusively from below (>= in the contract grammar).

AtMostAttribute

Type

Bounds a numeric field's value inclusively from above (<= in the contract grammar).

DefaultAttribute

Type

Supplies the field's default when the payload omits it.

DeriveSchemaAttribute

Type

Marks a plain record for schema derivation: schemagen generates its permissive schema.

DeriveUnionAttribute

Type

Marks a discriminated union for generated Schema support.

DistinctAttribute

Type

Requires the elements of a list field to be distinct.

EmailAttribute

Type

Constrains a text field to the email format.

FormatAttribute

Type

Adds open format metadata to the field schema.

GreaterThanAttribute

Type

Bounds a numeric field's value exclusively from below (> in the contract grammar).

LengthAttribute

Type

Requires the natural length of a text, list, or map field to equal the supplied value.

LengthBetweenAttribute

Type

Bounds the natural length of a text, list, or map field inclusively.

LessThanAttribute

Type

Bounds a numeric field's value exclusively from above (< in the contract grammar).

MaxAttribute

Type

Bounds the natural length of a text, list, or map field from above.

MinAttribute

Type

Bounds the natural length of a text, list, or map field from below.

MultipleOfAttribute

Type

Constrains a numeric field's value to whole multiples of the given step.

PatternAttribute

Type

Constrains a text field to the given regular expression.

PresentAttribute

Type

Requires a string, collection, or optional field value to be present.

SchemaConstructorAttribute

Type

Marks the static member the derived schema calls to assemble the record, instead of a record literal.

SchemaNameAttribute

Type

Overrides the external name of one record field or one nullary union case.

SuppliedAttribute

Type

Requires the input payload to supply the field key.

UnionPayloadStyleKind

Type

Selects how generated case fields are nested by adjacent or external representations.

UnionRepresentationKind

Type

Selects a complete generated union wire representation.

Reified.Schema.Contracts

Schema

Module

# `Schema` The `Schema` module contains primitive schemas, collection and recursion combinators, union constructors, and the operations that parse or check a completed declaration.

Contracts

Namespace

No description available.

Emitter

Module

Emits the checked-in F# for a resolved contract file: one public record, schema, validate, parse, and Fields module per contract, in declaration order.

FieldDecl

Module

No description available.

Parser

Module

Parses .contract source text into the contract AST with line-precise diagnostics.

Records

Module

The record frontend: parses F# source with the F# compiler's syntax tree (no type checking) and lowers [<DeriveSchema>]-marked records into the same ContractDecl AST the .contract parser produces, so both entry points share the resolver and emitter.

Resolver

Module

Semantic validation over parsed contract files: reference resolution, constraint/type compatibility, defaults, and declaration ordering.

Annotation

Record

An @name literal?

ConstraintDecl

Union

One portable constraint retained by the shared generation pipeline.

ContractDecl

Record

One declared contract at one version.

ContractDiagnostic

Record

A line-precise parse or resolution problem.

ContractFile

Record

A parsed contract source file.

ContractRef

Record

A reference to another contract at a pinned version, e.g.

ExternalEnumCase

Record

One case of a user-owned nullary discriminated union used as an enum field.

ExternalUnionCase

Record

One case of a user-owned internally tagged union.

ExternalUnionField

Record

One named field carried directly by a user-owned union case.

ExternalUnionPayload

Union

The payload shape of one user-owned internally tagged union case.

ExternalUnionRepresentation

Union

No description available.

FieldDecl

Record

One declared contract field.

FieldType

Union

A field's declared type.

Literal

Union

A literal value in a contract declaration.

PrimitiveType

Union

The primitive type heads the grammar knows.

SchemaNaming

Union

How field names and nullary union case names become external names when no [<SchemaName>] override is present.

UnionCaseDecl

Record

One case of an inline tagged union block.

Reified.Schema.Json

Reified.Schema.Testing