UOR Type System

IRI
https://uor.foundation/type/
Prefix
type:
Space
user
Comment
Runtime type declarations that parameterize the resolution pipeline. Types are declared by Prism applications and resolved to partitions of the ring.

This is a user-space namespace in the Apply stage of the PRISM pipeline. It provides the application layer — types, morphisms, and state that parameterize the resolution pipeline.

Learn more: Pipeline Overview · Site Bundle Semantics

Class hierarchy
Class hierarchy for UOR Type System namespace TypeDefinition PrimitiveType ProductType SumType ConstrainedTyp Constraint ResidueConstra CarryConstrain DepthConstrain CompositeConst HammingConstra SiteConstraint AffineConstrai MetricAxis CompleteType CompletenessCa CompletenessWi TypeSynthesisG TypeSynthesisR SynthesizedTyp MinimalConstra WittLift LiftObstructio TwistedType FlatType SuperposedSite ForbiddenSigna CollapsedSiteS LiftChain ObstructionCha ModuliSpace HolonomyStratu DeformationFam VersalDeformat ModuliTowerMap GaloisConnecti TypeInclusion VarianceAnnota SubtypingLatti

Imports

Classes

NameSubclass OfDisjoint WithComment
TypeDefinitionThingConstraint, MetricAxisA runtime type declaration. The root class for all UOR types. Each TypeDefinition, when resolved, produces a partition of the ring at the specified quantum level.
PrimitiveTypeTypeDefinitionA primitive type defined by a fixed bit width. The carrier is the entire ring Z/(2^n)Z at the specified quantum level.
ProductTypeTypeDefinitionA product (Cartesian) type formed from multiple component types. The carrier is the product of the component carriers.
SumTypeTypeDefinitionA sum (disjoint union) type formed from multiple variant types. The carrier is the disjoint union of the variant carriers.
ConstrainedTypeTypeDefinitionA type formed by constraining a base type with a predicate. The carrier is the subset of the base carrier satisfying the constraint.
ConstraintThingTypeDefinition, MetricAxisA composable predicate that refines a type by pinning one or more site coordinates. Constraints are the parameterization mechanism for ConstrainedType.
ResidueConstraintConstraintCarryConstraint, DepthConstraint, CompositeConstraint, HammingConstraint, SiteConstraint, AffineConstraintA constraint based on residue class membership: x ≡ r (mod m). Pins sites corresponding to the residue pattern.
CarryConstraintConstraintResidueConstraint, DepthConstraint, CompositeConstraint, HammingConstraint, SiteConstraint, AffineConstraintA constraint based on carry propagation patterns in ring arithmetic. Pins sites corresponding to carry positions.
DepthConstraintConstraintResidueConstraint, CarryConstraint, CompositeConstraint, HammingConstraint, SiteConstraint, AffineConstraintA constraint on factorization depth: the minimum and maximum number of irreducible factors. Pins sites by bounding the factorization tree depth.
CompositeConstraintConstraintResidueConstraint, CarryConstraint, DepthConstraint, HammingConstraint, SiteConstraint, AffineConstraintA constraint formed by composing two or more simpler constraints. The composite pins the union of sites pinned by its components.
HammingConstraintConstraintResidueConstraint, CarryConstraint, DepthConstraint, CompositeConstraint, SiteConstraint, AffineConstraintPins the Hamming weight of the Datum to at most the bound. The horizontal axis of the tri-metric.
SiteConstraintConstraintResidueConstraint, CarryConstraint, DepthConstraint, CompositeConstraint, HammingConstraint, AffineConstraintPins a single site coordinate to 0 or 1. The atomic unit of the site budget.
AffineConstraintConstraintResidueConstraint, CarryConstraint, DepthConstraint, CompositeConstraint, HammingConstraint, SiteConstraintPins the Datum to an affine subspace specified by an offset and a set of generators.
MetricAxisThingTypeDefinition, ConstraintA classification axis for constraints by their geometric effect. The three axes — vertical (ring/additive), horizontal (Hamming/bitwise), diagonal (incompatibility) — form the tri-metric coordinate system of UOR.
CompleteTypeTypeDefinitionA TypeDefinition certified to satisfy the UOR completeness criterion (IT_7d): its constraint nerve N(C) has Euler characteristic χ = n and all Betti numbers β_k = 0. A CompleteType guarantees that resolution closes the site budget in O(1) — no iterative refinement is required. Completeness is attested by a cert:CompletenessCertificate linked via cert:certifiedType. This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
CompletenessCandidateConstrainedTypeCompleteTypeA ConstrainedType actively undergoing the completeness certification pipeline. Links to the resolver:ResolutionState tracking the current iteration and to the resolver:CechNerve being computed. Disjoint from CompleteType (which is already certified). This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
CompletenessWitnessThingA record of a single site-closing event: one constraint application that reduced the FreeRank deficit. Carries the applied constraint and the sitesClosed count. Forms the ordered audit trail between ConstrainedType and CompleteType.
TypeSynthesisGoalThingA specification of the desired topological properties of a type to be synthesised. Carries a target Euler characteristic (targetEulerCharacteristic) and a target Betti profile (zero or more targetBettiNumber assertions). The minimal goal for O(1) resolution is: targetEulerCharacteristic = n and all targetBettiNumber = 0 — the IT_7d profile.
TypeSynthesisResultThingThe output of a TypeSynthesisResolver run. Contains the SynthesizedType, the realised topological signature (as a SynthesisSignature), and the SynthesisTrace recording the construction steps.
SynthesizedTypeConstrainedTypeA ConstrainedType produced by the TypeSynthesisResolver. Distinguished from a hand-authored ConstrainedType by the presence of a type:synthesisResult link. May or may not be a CompleteType, depending on the synthesis goal. This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
MinimalConstraintBasisThingThe minimal set of constraints in the SynthesizedType's constraint set that is sufficient to realise the target topological signature. The minimality criterion is that removing any single member changes the realised signature.
WittLiftThingA ConstrainedType T' over R_{n+1} obtained by extending a ConstrainedType T over R_n. Carries a link to the base type (liftBase), the quantum level it lifts to (liftTargetLevel), and the LiftObstruction (if the lift fails to transfer completeness). A WittLift is a CompleteType iff its LiftObstruction is trivial.
LiftObstructionThingThe algebraic obstruction to a WittLift inheriting the completeness of its base type. Computed as the image of the spectral sequence differential d_2. If trivial (zero), the base type's completeness lifts. If non-trivial, at least one additional constraint is needed at the new quantum level.
TwistedTypeConstrainedTypeFlatTypeA ConstrainedType whose HolonomyGroup is non-trivial — at least one closed constraint path produces a non-identity dihedral element. A TwistedType may still be a CompleteType (IT_7d is a homological, not holonomic, criterion), but its resolution paths require tracking dihedral accumulation. This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
FlatTypeConstrainedTypeTwistedTypeA ConstrainedType whose HolonomyGroup is trivial — all closed constraint paths have identity monodromy. The constraint configuration is topologically flat: resolution is path-independent. This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
SuperposedSiteStateTypeDefinitionA type representing a superposition of site states where sites carry complex amplitudes rather than binary pinned/free assignments. Ontological realisation of RC_5 (Amendment 32). This class is not addressable from a type-expr position in the term language; references from term-language positions are rejected by the resolver.
ForbiddenSignatureThingA topological signature (χ, β_k) that is formally impossible to achieve for any ConstrainedType. Witnessed by an ImpossibilityWitness in proof/.
CollapsedSiteStateThingA site state that has undergone projective collapse from a SuperposedSiteState to a definitive classical value. Topologically equivalent to a classically pinned site (QM_2).
LiftChainThingAn ordered composition of WittLift steps from liftSourceLevel (Q_j) to liftTargetLevel (Q_k) for any j < k. The canonical object certifying type completeness at arbitrary Q_k.
ObstructionChainThingThe complete ordered sequence of LiftObstruction records encountered and resolved along a LiftChain. An empty ObstructionChain means the tower is flat.
ModuliSpaceThingThe space of all CompleteTypes over R_n at a given quantum level.
HolonomyStratumThingA stratum indexed by a conjugacy class of subgroups of D_{2^n}.
DeformationFamilyThingA one-parameter family of constraint configurations parameterizing a path.
VersalDeformationThingThe versal deformation of a CompleteType T.
ModuliTowerMapThingThe map induced by WittLift from one moduli space to the next.
GaloisConnectionThingThe adjunction between the type lattice and the site lattice. The upper adjoint is type closure; the lower adjoint is site interior. σ = lower adjoint evaluation; r = complement of upper adjoint image.
TypeInclusionTransformA morphism T₁ → T₂ witnessing that T₁ is a subtype of T₂: the constraint set of T₁ is a superset of the constraint set of T₂.
VarianceAnnotationThingThe variance of a structural type position under operad composition. One of Covariant, Contravariant, Invariant, or Bivariant.
SubtypingLatticeThingThe partial order on types induced by TypeInclusion. The top element is PrimitiveType (no constraints); the bottom elements are CompleteTypes (all sites pinned).

Properties

NameKindFunctionalDomainRangeComment
bitWidthDatatypetruePrimitiveTypepositiveIntegerThe bit width of a primitive type (the quantum level n). The carrier is Z/(2^n)Z.
componentObjectfalseProductTypeTypeDefinitionA component type in a product type.
baseTypeObjecttrueConstrainedTypeTypeDefinitionThe base type that a constrained type restricts.
contentAddressObjecttrueTypeDefinitionElementThe content-derived address of this type definition, uniquely identifying the type in the UOR address space.
hasConstraintObjectfalseConstrainedTypeConstraintA typed constraint object applied to this constrained type. Replaces the deprecated string-based type:constraint property.
modulusDatatypetrueResidueConstraintpositiveIntegerThe modulus m of a residue constraint: x ≡ r (mod m).
residueDatatypetrueResidueConstraintnonNegativeIntegerThe residue value r of a residue constraint: x ≡ r (mod m).
carryPatternObjecttrueCarryConstraintDatumThe carry propagation pattern of a carry constraint, expressed as a Datum at the appropriate quantum level.
minDepthDatatypetrueDepthConstraintnonNegativeIntegerThe minimum factorization depth required by a depth constraint.
maxDepthDatatypetrueDepthConstraintnonNegativeIntegerThe maximum factorization depth allowed by a depth constraint.
composedFromObjectfalseCompositeConstraintConstraintA component constraint of this composite constraint.
hammingBoundDatatypetrueHammingConstraintnonNegativeIntegerUpper bound on the Hamming weight of the Datum.
siteIndexDatatypetrueSiteConstraintnonNegativeIntegerZero-based index of the pinned site coordinate.
siteValueObjecttrueSiteConstraintDatumThe value the pinned site coordinate must equal (a Datum in the set {0, 1}).
affineOffsetObjecttrueAffineConstraintDatumConstant offset defining the affine subspace.
affineGeneratorObjectfalseAffineConstraintDatumA generator of the affine subspace. Non-functional: multiple generators span the subspace.
metricAxisObjecttrueConstraintMetricAxisThe metric axis along which this constraint operates: vertical (ring), horizontal (Hamming), or diagonal (incompatibility).
pinsSitesObjectfalseConstraintSiteIndexA site coordinate that this constraint pins when applied.
affectsAxisObjectfalseOperationMetricAxisThe metric axis that this operation affects. Replaces the string-valued type:axisSignature property with a typed reference to MetricAxis individuals. Non-functional: an operation may affect multiple axes.
crossingCostDatatypetrueConstraintnonNegativeIntegerThe cost of applying this constraint in terms of axis crossings: the number of metric boundaries that must be traversed.
completenessCandidateObjectfalseCompletenessCandidateConstrainedTypeThe ConstrainedType being evaluated for completeness by this CompletenessCandidate.
candidateNerveObjecttrueCompletenessCandidateCechNerveThe constraint nerve being computed for this candidate. The CompletenessResolver reads χ(N(C)) from this nerve at each iteration via resolver:nerveEulerCharacteristic.
witnessConstraintObjecttrueCompletenessWitnessConstraintThe constraint applied in this witness step.
sitesClosedDatatypetrueCompletenessWitnessnonNegativeIntegerNumber of sites closed by this witness step.
targetEulerCharacteristicDatatypetrueTypeSynthesisGoalintegerThe target χ(N(C)) value. For O(1) resolution: set equal to n (the quantum level).
targetBettiNumberDatatypefalseTypeSynthesisGoalnonNegativeIntegerNon-functional. Each assertion specifies a target Betti number value for a given homological degree. Multiple assertions permitted, one per degree.
synthesisResultObjecttrueSynthesizedTypeTypeSynthesisResultLinks a SynthesizedType back to the synthesis run that produced it.
basisConstraintObjectfalseMinimalConstraintBasisConstraintNon-functional. One assertion per constraint in the minimal basis.
basisSizeDatatypetrueMinimalConstraintBasisnonNegativeIntegerThe cardinality of the minimal basis. The theoretical lower bound is n (one constraint per site).
liftBaseObjecttrueWittLiftConstrainedTypeThe base type being lifted to the next quantum level.
liftTargetLevelObjecttrueWittLiftWittLevelThe quantum level this lift targets.
liftObstructionObjecttrueWittLiftLiftObstructionThe LiftObstruction for this lift. Trivial (zero class) iff the lift inherits completeness.
obstructionTrivialDatatypetrueLiftObstructionbooleanTrue iff the obstruction class is zero — the base type's completeness transfers to the lifted quantum level without additional constraints.
obstructionSiteObjecttrueLiftObstructionSiteIndexThe site at the new quantum level where the obstruction is located. Ranges over the new bit position introduced at Q_{n+1}.
holonomyGroupObjecttrueConstrainedTypeHolonomyGroupThe HolonomyGroup of this type. Computed by the MonodromyResolver.
monodromyClassObjecttrueConstrainedTypeMonodromyClassThe MonodromyClass classifying this type as flat or twisted.
amplitudeDatatypetrueSuperposedSiteStatedecimalThe amplitude coefficient for this superposed site state.
targetForbiddenDatatypetrueTypeSynthesisGoalbooleanWhether the target signature of this TypeSynthesisGoal is a ForbiddenSignature. If true, synthesis is provably impossible.
collapsedFromObjecttrueCollapsedSiteStateSuperposedSiteStateThe SuperposedSiteState from which this CollapsedSiteState was produced by projective measurement.
survivingAmplitudeDatatypetrueCollapsedSiteStatedecimalThe amplitude of the surviving branch after projective collapse. |α|² is the probability of this outcome under the Born rule.
normalizationVerifiedDatatypetrueSuperposedSiteStatebooleanWhether the amplitude vector of this SuperposedSiteState satisfies the normalization condition Σ|αᵢ|² = 1 (QM_5). Set by the SuperpositionResolver after verification.
holonomyClassifiedDatatypetrueConstrainedTypebooleanWhether this ConstrainedType has been classified as FlatType or TwistedType by the MonodromyResolver. The MN_8 identity guarantees this is a bivalent classification: holonomyClassified(T) iff isFlatType(T) xor isTwistedType(T).
liftSourceLevelObjecttrueLiftChainWittLevelThe quantum level at the base of the chain.
chainLengthDatatypetrueLiftChainnonNegativeIntegerThe number of WittLift steps in the chain (k - j).
chainStepObjectfalseLiftChainWittLiftA WittLift step in this chain. Non-functional: one per step.
chainObstructionProfileObjecttrueLiftChainObstructionChainThe full obstruction history of this chain.
resolvedBasisSizeDatatypetrueLiftChainnonNegativeIntegerThe basis size of the CompleteType at the chain target level.
obstructionAtObjectfalseObstructionChainLiftObstructionA non-trivial LiftObstruction in this chain. Non-functional.
obstructionCountDatatypetrueObstructionChainnonNegativeIntegerTotal number of non-trivial LiftObstruction records.
isFlatDatatypetrueObstructionChainbooleanTrue iff obstructionCount = 0 (flat tower).
moduliWittLevelObjecttrueModuliSpaceWittLevelThe quantum level at which this moduli space is defined.
moduliPointObjectfalseModuliSpaceCompleteTypeA CompleteType that is a point of this moduli space.
moduliDimensionDatatypetrueModuliSpacenonNegativeIntegerThe dimension of this moduli space.
stratumHolonomyClassObjecttrueHolonomyStratumMonodromyClassThe MonodromyClass indexing this stratum.
stratumCodimensionDatatypetrueHolonomyStratumnonNegativeIntegerThe codimension of this stratum within the moduli space.
stratumModuliObjecttrueHolonomyStratumModuliSpaceThe moduli space containing this stratum.
familyParameterObjectfalseDeformationFamilyCompleteTypeA CompleteType along the deformation path.
familyPreservesCompletenessDatatypetrueDeformationFamilybooleanWhether every member of this deformation family remains a CompleteType.
versalBaseObjecttrueVersalDeformationCompleteTypeThe CompleteType at the base of this versal deformation.
versalDimensionDatatypetrueVersalDeformationnonNegativeIntegerThe dimension of the versal deformation space.
towerMapSourceObjecttrueModuliTowerMapModuliSpaceThe source moduli space of this tower map.
upperAdjointObjecttrueGaloisConnectionTermExpressionThe upper adjoint (type closure) of the Galois connection, expressed as a symbolic formula string.
lowerAdjointObjecttrueGaloisConnectionTermExpressionThe lower adjoint (site interior) of the Galois connection, expressed as a symbolic formula string.
fixpointConditionObjecttrueGaloisConnectionTermExpressionThe fixpoint condition for the Galois connection: when upper(lower(T)) = T, the type is complete.
refinementDirectionDatatypetrueGaloisConnectionnonNegativeIntegerDescription of the refinement direction: ascending in type lattice corresponds to descending in site freedom.
structuralSiteCountAnnotationtruestringFormula or description of the site count for a structural type individual.
structuralGroundingAnnotationtruestringDescription of the grounding rule that maps values of this structural type onto the UOR ring.
structuralConstraintAnnotationtruestringDescription of the constraint characterizing this structural type, if applicable.
galoisClosurePropertyObjecttrueGaloisConnectionTermExpressionThe closure property of a Galois connection.
galoisInteriorPropertyObjecttrueGaloisConnectionTermExpressionThe interior property of a Galois connection.
groundingMapRefObjecttrueGroundingMapReference to the grounding map used for this type.
compositionLawObjecttrueTermExpressionThe algebraic composition law governing this type.
siteOrderingConstraintObjecttrueTermExpressionConstraint on the ordering of sites for this type.
backboneThresholdDatatypetruenonNegativeIntegerThe threshold for backbone inclusion in the type lattice.
permutationGroupObjecttrueGroupThe permutation group acting on sites of this type.
acyclicityWitnessDatatypetruebooleanWitness certifying acyclicity of the type dependency graph.
connectivityWitnessDatatypetruebooleanWitness certifying connectivity of the type graph.
schemaConstraintObjecttrueTermExpressionConstraint imposed by the schema on this type.
alphabetSizeAnnotationtruenonNegativeIntegerThe size of the alphabet for symbol-based types.
quantizationRangeObjecttrueTermExpressionThe range specification for quantized types.
elementTypeRefObjecttrueTypeDefinitionReference to the element type within a composite type.
inclusionSourceObjecttrueTypeInclusionConstrainedTypeThe subtype (more constraints).
inclusionTargetObjecttrueTypeInclusionConstrainedTypeThe supertype (fewer constraints).
positionVarianceObjecttrueStructuralOperadVarianceAnnotationThe variance of each operand position.
inclusionWitnessDatatypetrueTypeInclusionbooleanTrue iff constraints(source) ⊇ constraints(target). Computed, not asserted.
latticeDepthDatatypetrueSubtypingLatticenonNegativeIntegerMaximum chain length from PrimitiveType (top) to any CompleteType (bottom). Equals the site budget n at quantum level Q_k.

Named Individuals

NameTypeComment
verticalAxisMetricAxisThe vertical (ring/additive) metric axis. Constraints on this axis operate through ring arithmetic: residue classes, divisibility, and additive structure.
horizontalAxisMetricAxisThe horizontal (Hamming/bitwise) metric axis. Constraints on this axis operate through bitwise structure: carry patterns, bit positions, and Hamming distance.
diagonalAxisMetricAxisThe diagonal (incompatibility) metric axis. Constraints on this axis measure the gap between ring and Hamming metrics — the curvature of UOR geometry.
ScalarTypePrimitiveTypeA single value from an ordered domain. siteCount = n (quantization bits).
  • structuralSiteCount: n (quantization bits)
  • structuralGrounding: quantize(value, range, bits) produces ring element where d_R reflects value proximity
SymbolTypePrimitiveTypeA value from a finite unordered set. siteCount = ceil(log2(|alphabet|)).
  • structuralSiteCount: ceil(log2(|alphabet|))
  • structuralGrounding: argmin_{encoding} sum d_delta over observed pairs (CY_5)
SequenceTypeProductTypeAn ordered list of elements with backbone constraint. The free monoid on the element type.
  • structuralSiteCount: sum of element site counts
  • structuralGrounding: free monoid on element type, backbone constraint
  • structuralConstraint: backbone ordering: elements indexed by position
TupleTypeProductTypeA fixed collection of named fields.
  • structuralSiteCount: sum of field site counts
  • structuralGrounding: site ordering follows CY_6 (optimal site ordering)
GraphTypeConstrainedTypeNodes with edge constraints. Constraint nerve = graph topology.
  • structuralSiteCount: sum of node site counts + edge overhead
  • structuralGrounding: constraint nerve = graph nerve, beta_k equality
  • structuralConstraint: edge constraints: adjacency preserved under grounding
SetTypeConstrainedTypeUnordered collection. d_delta is permutation-invariant.
  • structuralSiteCount: sum of element site counts
  • structuralGrounding: d_delta invariant under element permutation, D_{2n} symmetry
  • structuralConstraint: permutation invariance: encoding is order-independent
TreeTypeConstrainedTypeHierarchical structure. beta_1=0 (acyclic), beta_0=1 (connected).
  • structuralSiteCount: sum of node site counts
  • structuralGrounding: parent-child encoding with acyclicity constraint
  • structuralConstraint: beta_1=0 (acyclic), beta_0=1 (connected)
TableTypeProductTypeCollection of tuples sharing a schema = Sequence(Tuple(S)). Functorial decomposition.
  • structuralSiteCount: row_count * tuple_site_count
  • structuralGrounding: Sequence(Tuple(S)), functorial decomposition
  • structuralConstraint: shared schema: all rows conform to tuple type S
CovariantVarianceAnnotationThe structural position preserves TypeInclusion: if T₁ ≤ T₂, then F(T₁) ≤ F(T₂).
  • enumVariant: Covariant
ContravariantVarianceAnnotationThe structural position reverses TypeInclusion: if T₁ ≤ T₂, then F(T₂) ≤ F(T₁).
  • enumVariant: Contravariant
InvariantVarianceAnnotationThe structural position requires exact type equality: F(T₁) ≤ F(T₂) only if T₁ = T₂.
  • enumVariant: Invariant
BivariantVarianceAnnotationThe structural position ignores the type parameter: F(T₁) ≤ F(T₂) for all T₁, T₂.
  • enumVariant: Bivariant
EitherTypeSumTypeThe canonical binary disjoint union type whose carrier is L + R.
OptionTypeSumTypeThe canonical A + Unit idiom for optional values.