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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
// Copyright 2026 Mark Alan Boykin
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
// SPDX-License-Identifier: MPL-2.0
//! `forme` — workbench arrangement authority.
//!
//! Named for the printing-press *forme*: the locked-up assembly of typeset
//! pieces ready to print. A forme is whatever shape the typesetter locks up
//! — not forced into a tree. forme owns *what a workbench is*; a tree is one
//! projection of it (platen's job), per the composition spine
//! (`design_docs/mere_docs/technical_architecture/2026-05-21_mere_composition_spine.md`).
//!
//! Boundary: **graph truth** (kernel `Graph`) → **forme** (arrangement
//! authority) → **platen** (projects an arrangement into a presentation plan)
//! → the host realizes it (`platen-view` flex DOM under genet + actor
//! textures composited by netrender).
//!
//! ## v1 canonical core (this is the live path)
//!
//! - [`arrangement`] — `Arrangement`: a small, graph-capable, **geometry-free**
//! arrangement (members / tiles / groups + stacked / split / compare /
//! focus-path / mirror relations).
//! - [`forme_document`] — `FormeId` / `FormeRef` / `FormeDocument`: a forme as a
//! durable, session-scoped, graph-bound object.
//!
//! ## Parked (graphshell-era machinery — git-revivable)
//!
//! The modules below are the rich graph-derived-navigation lane (subgraph
//! topology, lenses, reconciliation, pressure, the tree-first `GraphTree` /
//! `TreeTopology`). They are **not** the v1 arrangement core and will be
//! removed from the active crate in a follow-up (kept only as the future
//! `Supernode` / derived-arrangement hook). Do not build new product
//! paths on them.
//!
//! No egui. No iced. No winit. No wgpu. Pure data + pure functions.
// ── v1 canonical core ────────────────────────────────────────────────────────
/// Native on-disk persistence of [`FormeDocument`]s. Gated by incipit's `arrangement-store`
/// feature so portable consumers stay `std::fs`-free; the native host enables
/// it.
pub use ;
pub use ;
// ── Parked graphshell-era machinery (git-revivable; pending removal) ─────────
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
pub use *;
/// Portable rectangle — no framework dependency.
/// Identity of a tree member. Generic so Graphshell uses `NodeKey`,
/// extensions use `Uuid`, tests use `u64`.