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:
StableEntityIdis 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, α, μ, σ], matchingTensor10D. IntegrityIndexDigestis 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§
- Integrity
Index Digest - 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.
- Manifold
Identity V2 - Manifold identity/profile declaration for one stable entity.
- Stable
Entity Id - Opaque stored continuity identifier. Issuer and uniqueness are not verified by this codec. Its bytes are never interpreted as a digest.
- Typed
Field Record - Typed reference to a payload in another section of the outer
.10denvelope. A zeropayload_section_idis allowed only for an empty declaration that has no attached sample payload yet.
Enums§
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+MHarbouredGraphHeaders). - 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
coordinateslanes 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_idorder; 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.