Document Schema

Marking a document root with @document, and how schemas merge per namespace.

§ 1Composing document schemas

Several @document schemas can govern the same namespace, and they merge: a top-level field or block is legal if any of them declares it. This lets you import a library that ships its own @document and still add your own top-level tags.

import <wdoc.wcl>            // brings in wdoc's library @document

@document
type ProjectDoc {           // your own root schema — merges with wdoc's
  @children("project_meta") metas: list<ProjectMeta>
}

@block("project_meta")
type ProjectMeta { @inline(0) id: identifier  owner: utf8 }

project_meta info { owner = "Wil" }   // your tag, alongside wdoc pages
page index { text { span "Hello" {} } }

Imported (library) @document schemas merge silently. Only a second root-authored @document in the same namespace is an error — you get one root schema, which composes with whatever the imports provide.