1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
//! The catalog document: [`BunsenCatalog`] and its entries, with the
//! keyed form they are read from and written to (YAML or JSON).
//!
//! The document is the namespace tree. **Every key the catalog language
//! defines starts with `$`; a bare key is a name.**
//!
//! ```yaml
//! $description: "Qwen3 chat models."
//! qwen: # an entry, keyed by its segment
//! $kind: namespace
//! $merge: update
//! qwen3-0.6b: # a child: a map with `$kind`
//! $kind: build
//! $description: "Qwen3-0.6B."
//! $template_class: qwen3/hybrid
//! parameters: 600000000 # a tag
//! checkpoint: {$kind: resource, $file: model.safetensors, $format: safetensors, $sources: []}
//! ```
//!
//! - **An entry** is a map with `$kind`, keyed by its segment. Its name is its
//! path of keys: nesting is the only placement.
//! - **Bare keys under an entry:** under a namespace or a contract, children;
//! under a template class, tags; under a build, a child when the value is a
//! map with `$kind`, and a tag otherwise. Other kinds have none.
//! - **`$contracts`**, at the root of the base catalog only, holds the
//! contracts and their `type` entries: the interfaces bunsen's loaders
//! implement. A build names its contract with `$contract`.
//! - **`$presets`** holds `$common`, `$axes` (keyed by the axis), `$default`,
//! and the presets, keyed by name.
//! - **Foreign documents are data:** a preset's `$patch` and `$common` keep the
//! model's keys.
//! - **Refused:** a `$` word the kind doesn't define, a child without `$kind`,
//! a bare key where the kind has none, and a repeated key.
//! - **Order is the file's:** `entries`, children, presets and axis uses keep
//! the order they are written in.
//!
//! A reference to another entry ([`CatalogRef`](super::name::CatalogRef))
//! resolves relative to the entry it is written in, climbing the namespace to
//! the root; a leading `/` resolves from the root only.
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use OrderedNode;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;