This document specifies VTwindoc, a VDoc extension which specifies an isomorphism and synchronization transformations between VDoc documents and valospace resources.

More specifically VTwindoc allows for the serialization and deserialization of an arbitrary selection of valospace resources into a VDoc document array and back even if the source resources are not a representation of a VDoc document nor use any VDoc core or extension ontologies.

This document has not been reviewed. This is a draft document and may be updated, replaced or obsoleted by other documents at any time.

This document is part of the ValOS kernel specification.

The extension is specified and supported by @valos/twindoc npm package.

VTwindoc provides both full isomorphic synchronization as well as incremental, additive updates between VDoc documents and valospace resources. The fully isomoprhic extraction and emission transformations to valospace resources provide lossless roundtrips to both directions:

1. emit + extract: a roundtrip starting from VDocState into valospace back into VDocState

2. extract + emit: a roundtrip starting from valospace into VDocState back into valospace

VTwindoc also specifies incremental transformations which are given a diff base in addition to the source and which compute a diffset and then merge the resulting diffset to the pre-existing transformation target. This not only gives performance advantages but also makes it possible to have the final document be a combination of several partial primary sources.

'VTwindoc' namespace provides vocabulary for defining hypertwin mappings and configurations; actual hypertwin content is represented using the valos core ontologies and possible extension content ontologies.