API Reference
Reified.Constraint
Catalogue
ModuleThe built-in message catalogue, and what a translator must cover.
Constraint
ModuleCreates, executes, composes, and inspects constraints.
BlankDispatcher
TypeNo description available.
CardinalityDispatcher
TypeNo description available.
ContainsDispatcher
TypeNo description available.
DistinctDispatcher
TypeNo description available.
MultipleOfDispatcher
TypeNo description available.
NotContainsDispatcher
TypeNo description available.
OptionalDispatcher
TypeNo description available.
PresentDispatcher
TypeNo description available.
ConstraintAtom
ModuleProjects message keys and default English phrases from expectation values.
ConstraintDSL
ModuleConstraint constructors usable without the Constraint.
ConstraintDescription
ModuleBuilds and traverses constraint descriptions.
ConstraintValue
ModuleBuilds and renders portable constraint values.
ConstraintValueInternals
ModuleThe boxed-value projection behind tryCreate.
MessageDescriptor
ModuleReads and builds message identities.
MessageFormatSpec
ModuleReads and builds catalogue-owned rendering metadata.
Renderer
ModuleBuilds renderers and renders messages through them.
UnsupportedOperation
ModuleProjects message keys and default English phrases from unsupported-operand reports.
Violation
ModuleInspects, traverses, and renders violations.
AtomicViolation
UnionWhy one indivisible constraint failed.
Cardinality
UnionWhat a size rule expects of a text length or collection count.
Constraint<'value>
TypeA reusable description of valid values, coupled to the closures that execute it.
ConstraintAtom
UnionOne interpreted primitive: the complete semantic identity of a built-in constraint.
ConstraintDescription
RecordWhat a constraint says, as inspectable data.
ConstraintExpression
UnionThe logical form of a constraint.
ConstraintValue
UnionThe closed set of operand and actual-value representations a constraint may carry across a description, diagnostic, or localization boundary.
Format
UnionThe built-in text formats.
Membership
UnionWhat a membership rule expects.
MessageDescriptor
RecordA message identity and the operands its template may interpolate.
MessageFormatSpec
RecordA descriptor plus the rendering metadata its owning catalogue holds: the neutral fallback template and the optional plural operand.
MessageFormatSpecError
UnionWhy a message format specification was rejected.
MessageKeyError
UnionWhy a relative message key could not be parsed.
MessageLeaf
UnionOne leaf of a projected message tree.
MessageLookup
TypeThe ordinary resource lookup: an encoded resource key in, a translated template out.
MessageRequest
RecordOne contextual level's request to an advanced resolver.
MessageResolution
UnionWhat an advanced resolver found for one contextual level.
MessageResolver
TypeResolves one contextual level, or declines so Reified continues to a less specific one.
MessageTree
UnionA violation projected for an external localization system, retaining its grouping.
Number
UnionWhat a numeric-property rule expects.
OpaqueConstraint
UnionWhy a constraint is invisible to export and proof.
PortableFloat
RecordAn IEEE double retaining structural self-equality, including NaN and signed zero.
PortableFloat32
RecordAn IEEE single retaining structural self-equality, including NaN and signed zero.
Presence
UnionWhat a presence rule expects of a value's shape.
Relation
UnionWhat an ordering or equality rule expects.
RelationOperator
UnionThe comparison a relation asserts between a value and an operand.
Renderer
TypeRenders localized messages for one document context and attribute.
UnsupportedOperation
UnionA built-in operation that received an operand outside the portable value set.
ValueFormatRequest
RecordA value to format, with the placeholder's format suffix when it carried one.
Violation
UnionWhy a value failed its constraint.
Reified.Data
Data
ModuleNo description available.
DataDSL
ModuleConcise opt-in syntax for literals, immutable edits, cases, and matching.
DataEdit
ModuleNo description available.
DataErgonomicsHelpers
ModuleNo description available.
DataPath
ModuleHelpers for constructing, parsing, and rendering structured data paths.
Data
UnionA portable tree for structured data.
DataCase
RecordA named materialized structured-data case.
DataDifference
RecordOne focused difference between expected and actual structured data.
DataDifferenceCause
UnionThe reason an exact structural comparison differed.
DataDimension
RecordOne independent axis in a bounded Cartesian data matrix.
DataEdit
TypeAn opaque immutable edit applied by Data.tryPatch or Data.patch.
DataExpectation
TypeAn opaque path-based expectation.
DataField
TypeAn opaque object-field instruction shared by data literals and object patterns.
DataMatchException
TypeRaised by matching when one or more expectations fail.
DataMismatch
RecordOne failed selective or recursive data expectation.
DataPatchException
TypeRaised by Data.patch when an edit cannot be applied.
DataPatchFailure
RecordDescribes why one immutable data edit could not be applied.
DataPath
TypeA path that addresses a location in structured data.
DataPathSegment
UnionA segment in a structured data path.
DataPattern
TypeAn opaque recursive expectation used to match structured data.
DataVariation
RecordA named immutable variation from one baseline value.
PatternConversion
TypeNo description available.
Reified.Parse
Parse
ModulePrimitive parsers for untrusted serialized input.
ParseError
UnionPrimitive parse failures returned by Parse helpers.
Reified.Refinements
Refinements
NamespaceNo description available.
Bounded
ModuleOperations over values that carry their permitted range.
BoundedFloat
ModuleOperations over bounded values whose bounds carry a numeric width.
DistinctList
ModuleOperations over lists known to hold no duplicates.
FiniteFloat
ModuleOperations over floats that are known to be neither infinite nor <c>NaN</c>.
FiniteFloat32
ModuleOperations over single-precision floats that are known to be finite.
Interval
ModuleOperations over inclusive ranges of ordered values.
NonBlankString
ModuleOperations over text known to carry non-whitespace content.
NonEmptyArray
ModuleOperations over arrays that carry their non-emptiness in the type.
NonEmptyList
ModuleOperations over lists that carry their non-emptiness in the type.
Refine
ModuleSmart constructors for built-in refined values, and the refinements behind them.
Character
ModuleCharacter predicate helpers.
Choice
ModuleChoice combinators for ordinary fallible conversion functions.
Collection
ModuleCollection refined value constructors and helpers.
Text
ModuleText refined value constructors and helpers.
Refinement
ModuleCreates and applies reusable refinement definitions.
UnitInterval
ModuleOperations over proportions between zero and one.
Bounded<'value>
RecordA value paired with the inclusive interval it is known to lie within.
DateRange
TypeAn inclusive range of instants.
DistinctList<'value>
UnionA list with no duplicate items, preserving first-seen order.
FiniteFloat
UnionA double-precision float that is neither infinite nor NaN.
FiniteFloat32
UnionA single-precision float that is neither infinite nor NaN.
Interval<'value>
RecordAn inclusive range of ordered values where Lower <= Upper.
NonBlankString
UnionA string that is not null, empty, or whitespace.
NonEmptyArray<'value>
UnionAn array that contains at least one item.
NonEmptyList<'value>
UnionA list that contains at least one item.
Refinement<'underlying, 'refined>
TypeAdmission into an invariant-carrying value, and its total reverse projection.
UnitInterval
UnionA finite double between zero and one inclusive.
Reified.Result
ResultDSL
ModuleThe concise result vocabulary: the result { } computation expression, its accumulating result.list { } / result.array { } variants, and the lightweight admission functions (okIf, failIf, require, orError, mapError).
Result
NamespaceNo description available.
Reified.Schema
Contract
Module# `Contract` A schema describes the current model.
EnumCase
ModuleFunctions for defining explicit payload-less enum schema cases.
ExternalFieldName
ModuleFunctions for creating and inspecting external schema field names.
Field
ModuleFunctions for inspecting schema field metadata.
FieldOrder
ModuleFunctions 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
ModuleReady-made schemas for the built-in refined values.
RetainedParseResult
ModuleFunctions 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
ModuleFunctions for running executable value checks against refined and primitive value schemas.
SchemaDSL
ModuleThe concise schema-definition vocabulary: the record computation expression, its field and constructor forms, and the collection-schema operations.
SchemaError
ModuleFunctions for lowering and rendering boundary schema failures.
SchemaErrors
ModuleFunctions for inspecting and rendering accumulated schema failures.
SchemaFormat
ModuleFunctions for creating and inspecting schema value format metadata.
SchemaMessages
ModuleThe message keys Schema's own failures render through.
SchemaPath
ModuleFunctions for building and formatting schema error paths.
SchemaValidation
ModuleMarks the package that owns schema input, diagnostics, validation, and rules interpreters.
UnionCase
ModuleFunctions for defining explicit tagged union schema cases.
UnionRepresentations
ModuleCommon complete representations for recommended authoring and serializer-compatible lifting.
Contract<'model>
RecordA versioned wire contract whose successful result is the current domain model.
ContractBuilder<'model, 'current>
RecordA progressively typed version chain.
ContractError
UnionA failure to select, parse, or migrate a versioned contract.
EnumCase<'enum>
TypeDescribes one payload-less case for Schema.enumOf.
EnumCaseDescription
RecordDescribes one case in a bare-string enum value schema.
EnumDescription
RecordDescribes a bare-string enum value schema.
ExternalFieldName
TypeRepresents the source-facing name of a schema field.
Field<'model, 'value>
TypeDescribes one typed field of a trusted model for schema interpreters.
FieldDescription
RecordDescribes one field of a model schema for inspection interpreters.
FieldOrder
TypeRepresents the zero-based position of a schema field in a model constructor and ordered interpreter output.
IRecordPlanCompiler<'model, 'result>
TypeBuilds an interpreter-specific typed record plan from a model schema's authored shape.
IRecordPlanState<'model, 'constructorIn, 'constructorOut>
TypeHolds an interpreter-specific typed record-plan fragment while compiling a schema.
MigrationError
UnionA failure produced while migrating an older wire representation.
ModelDescription
RecordDescribes a built model schema as an ordered list of field descriptions.
PrimitiveValueKind
UnionIdentifies the intrinsic primitive shape of a schema value.
RetainedParseResult<'value>
RecordA 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
TypeCanonical value-schema resolution for a schema field.
SchemaDescription
RecordDescribes one value schema: its shape, declared format, and portable constraint metadata.
SchemaError
UnionSchema input, checking, and contextual rule failures attached to diagnostics paths.
SchemaErrors
TypeOne or more accumulated schema failures.
SchemaFormat
TypeIdentifies the portable named format of a schema value, such as email.
SchemaIssue
RecordOne schema failure and its complete structural location.
SchemaParseOptions
RecordOptions that customize how structured data is parsed through a schema.
SchemaPath
TypeAn immutable location within structured schema input.
SchemaShape
UnionDescribes the shape of a value schema as inspectable metadata for non-validation interpreters.
Supply
UnionWhether boundary input for a field must be supplied.
UnionCase<'union>
TypeDescribes one tagged union case for Schema.union and its compatibility variants.
UnionCaseDescription
RecordDescribes one case in a union value schema.
UnionCaseShape
UnionDescribes the semantic payload shape of one union case.
UnionDescription
RecordDescribes a tagged union value schema.
UnionPayloadStyle
UnionControls how a case's authored fields are represented inside adjacent or external tagging.
UnionRepresentation
UnionA complete, inspectable union wire representation.
VersionSource
UnionThe explicit source of a contract version.
field<'model, 'target>
TypeDeclares one field inside schema<'model> { }, and configures it when followed by a block.
DerivedSchema
NamespaceNo description available.
AtLeastAttribute
TypeBounds a numeric field's value inclusively from below (>= in the contract grammar).
AtMostAttribute
TypeBounds a numeric field's value inclusively from above (<= in the contract grammar).
DefaultAttribute
TypeSupplies the field's default when the payload omits it.
DeriveSchemaAttribute
TypeMarks a plain record for schema derivation: schemagen generates its permissive schema.
DeriveUnionAttribute
TypeMarks a discriminated union for generated Schema support.
DistinctAttribute
TypeRequires the elements of a list field to be distinct.
EmailAttribute
TypeConstrains a text field to the email format.
FormatAttribute
TypeAdds open format metadata to the field schema.
GreaterThanAttribute
TypeBounds a numeric field's value exclusively from below (> in the contract grammar).
LengthAttribute
TypeRequires the natural length of a text, list, or map field to equal the supplied value.
LengthBetweenAttribute
TypeBounds the natural length of a text, list, or map field inclusively.
LessThanAttribute
TypeBounds a numeric field's value exclusively from above (< in the contract grammar).
MaxAttribute
TypeBounds the natural length of a text, list, or map field from above.
MinAttribute
TypeBounds the natural length of a text, list, or map field from below.
MultipleOfAttribute
TypeConstrains a numeric field's value to whole multiples of the given step.
PatternAttribute
TypeConstrains a text field to the given regular expression.
PresentAttribute
TypeRequires a string, collection, or optional field value to be present.
SchemaConstructorAttribute
TypeMarks the static member the derived schema calls to assemble the record, instead of a record literal.
SchemaNameAttribute
TypeOverrides the external name of one record field or one nullary union case.
SuppliedAttribute
TypeRequires the input payload to supply the field key.
UnionPayloadStyleKind
TypeSelects how generated case fields are nested by adjacent or external representations.
UnionRepresentationKind
TypeSelects 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
NamespaceNo description available.
Emitter
ModuleEmits the checked-in F# for a resolved contract file: one public record, schema, validate, parse, and Fields module per contract, in declaration order.
FieldDecl
ModuleNo description available.
Parser
ModuleParses .contract source text into the contract AST with line-precise diagnostics.
Records
ModuleThe 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
ModuleSemantic validation over parsed contract files: reference resolution, constraint/type compatibility, defaults, and declaration ordering.
Annotation
RecordAn @name literal?
ConstraintDecl
UnionOne portable constraint retained by the shared generation pipeline.
ContractDecl
RecordOne declared contract at one version.
ContractDiagnostic
RecordA line-precise parse or resolution problem.
ContractFile
RecordA parsed contract source file.
ContractRef
RecordA reference to another contract at a pinned version, e.g.
ExternalEnumCase
RecordOne case of a user-owned nullary discriminated union used as an enum field.
ExternalUnionCase
RecordOne case of a user-owned internally tagged union.
ExternalUnionField
RecordOne named field carried directly by a user-owned union case.
ExternalUnionPayload
UnionThe payload shape of one user-owned internally tagged union case.
ExternalUnionRepresentation
UnionNo description available.
FieldDecl
RecordOne declared contract field.
FieldType
UnionA field's declared type.
Literal
UnionA literal value in a contract declaration.
PrimitiveType
UnionThe primitive type heads the grammar knows.
SchemaNaming
UnionHow field names and nullary union case names become external names when no [<SchemaName>] override is present.
UnionCaseDecl
RecordOne case of an inline tagged union block.
Reified.Schema.Json
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.
Json
NamespaceNo description available.
Json
Module# `Json` `Json.compile` interprets a `Schema<'model>` as a reusable `JsonCodec<'model>`.
JsonCodec<'model>
TypeA compiled JSON codec for one schema-described model.
JsonCodecException
TypeThe exception raised when JSON text cannot be decoded through a compiled schema codec.