Skip to main content

Module manifold_identity_v2

Module manifold_identity_v2 

Source
Expand description

Version-2 manifold identity and typed scientific/presentation field manifest. .10d v2 manifold identity and typed-field manifest codec.

The MID2 section is integrated with the v2 outer .10d section table and sits beside independently versioned mesh, node, topology, material, and field payloads. Existing v1 containers remain readable and are never rewritten unless a caller explicitly opts into the v2 section.

The identity record keeps three concepts distinct:

  • StableEntityId is an opaque stored continuity handle. This codec does not verify its issuer or global uniqueness and never derives it from content. Qualified referent resolution belongs to native graph/authority mechanisms.
  • Tensor10D coordinates are explicit identity-bearing address/state under the declared profile, domain, and coordinate convention. Their fixed order is [q, v, w, x, y, z, t, α, μ, σ], matching Tensor10D.
  • IntegrityIndexDigest is an optional external digest/index hint. It is not an entity identifier, is not computed here, and is not used to resolve identity.

Field records are typed references into other sections of the enclosing container. Built-in field kinds include electromagnetic field (EMF) as one peer among scalar, vector, tensor, and spectral fields. Extension encoding and decoding both require an explicit allow-list; unknown kinds fail closed. The owning field schema validates kind-specific payload semantics after this envelope layer checks section identity and byte ranges. Encoding is little-endian, deterministic, caller-buffered, allocation-free, and requires field records in ascending stable field_id order.

Structs§

IntegrityIndexDigest
Optional externally computed digest/index aid. It is kept in a distinct type and field so it cannot become the entity identity by codec convention.
ManifoldIdentityV2
Manifold identity/profile declaration for one stable entity.
StableEntityId
Opaque stored continuity identifier. Issuer and uniqueness are not verified by this codec. Its bytes are never interpreted as a digest.
TypedFieldRecord
Typed reference to a payload in another section of the outer .10d envelope. A zero payload_section_id is allowed only for an empty declaration that has no attached sample payload yet.

Enums§

ManifestV2Error

Constants§

BUILTIN_FIELD_KINDS
BUILTIN_FIELD_KIND_NAMES
Canonical (kind, name) table for built-in MID2 field kinds.
FIELD_KIND_ELECTROMAGNETIC
Electromagnetic field data. This is a typed field kind, not a manifold or container format of its own.
FIELD_KIND_GEOMETRY_TOPOLOGY_COMPLEX
POET Geometry-Topology Complex (GTOP: PoetGeometryHeader + M HarbouredGraphHeaders).
FIELD_KIND_MORPH_TARGETS
Existing MRP1 mixed-schema morph targets in a FieldSidecar range. unit_id=0: position deltas inherit mesh coordinates; normal/tangent deltas are unitless.
FIELD_KIND_SCALAR
FIELD_KIND_SPECTRAL
FIELD_KIND_SURFACE_FRAMES
Existing NRM1/FRM1 per-vertex surface frames, unitless FieldSidecar range.
FIELD_KIND_TENSOR
FIELD_KIND_VECTOR
MANIFOLD_IDENTITY_V2_AXIS_ORDER
Exact axis order for the ten coordinates lanes in this section version.
MANIFOLD_IDENTITY_V2_FIELD_RECORD_SIZE
MANIFOLD_IDENTITY_V2_HEADER_SIZE
MANIFOLD_IDENTITY_V2_MAGIC
MANIFOLD_IDENTITY_V2_MAX_BYTES
MANIFOLD_IDENTITY_V2_MAX_FIELDS
MANIFOLD_IDENTITY_V2_VERSION

Functions§

decode_manifold_identity_v2
Decode a v2 manifest without allocating. Parsed field records are copied to caller storage only after the entire section has passed validation. Built-in kinds are always recognized; extensions require explicit allow-list entries.
encode_manifold_identity_v2
Encode built-in field kinds into a caller-owned buffer. Extension kinds require the explicit allow-list form so successful writes are readable by the same registered schema.
encode_manifold_identity_v2_with_extensions
Encode with an explicit extension-kind allow-list. Inputs must already use canonical ascending field_id order; sorting is intentionally not performed because this boundary must not allocate or rewrite caller data. Validation and size checks finish before output is modified.
encoded_len
Checked exact encoded length, bounded by the v2 manifest’s field limit.