devela 0.29.0

A development substrate of coherence.
Documentation
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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
// devela/src/yard/fragments.rs
//
//! Docs headings for modules across crates and misc. abbreviations.
//
// NOTES
// - `_DOC_*` defines the canonical opening sentence of a public module.
// - Parent-module declaration comments provide local navigation and may paraphrase it.
// - Explicit re-export lists describe the actual forwarded surface when appropriate.
// - Longer explanations remain in each module's source.

#![allow(missing_docs, reason = "hidden internals for the workspace")]

crate::CONST! { hidden macro_export,
    /* abbreviations */

    /// - <https://en.wikipedia.org/wiki/Domain-specific_language>
    _ABBR_DSL  = "<abbr title='Domain-specific Language'>DSL</abbr>";
    /// - <https://www.unicode.org/reports/tr29/#:~:text=An-,extended%20grapheme%20cluster,-is>
    _ABBR_EGC  = "<abbr title='Extended Grapheme Cluster'>EGC</abbr>";
    /// - <https://en.wikipedia.org/wiki/Foreign_function_interface>
    _ABBR_FFI  = "<abbr title='Foreign Function Interface'>FFI</abbr>";
    /// - <https://en.wikipedia.org/wiki/Queue_(abstract_data_type)>
    _ABBR_FIFO = "<abbr title='First-In, First-Out'>FIFO</abbr>."; // queue
    /// - <https://en.wikipedia.org/wiki/Stack_(abstract_data_type)>
    _ABBR_LIFO = "<abbr title='Last-In, First-Out'>LIFO</abbr>."; // stack
    /// - <https://en.wikipedia.org/wiki/Lookup_table>
    _ABBR_LUT  = "<abbr title='Look-up Table'>LUT</abbr>";
    /// - <https://en.wikipedia.org/wiki/Pseudorandom_number_generator>
    _ABBR_PRNG = "<abbr title='Pseudorandom number generator'>PRNG</abbr>";
        /// - <https://en.wikipedia.org/wiki/Linear_congruential_generator>
        _ABBR_LCG  = "<abbr title='Linear congruential generator'>LCG</abbr>";
        /// - <https://en.wikipedia.org/wiki/Permuted_congruential_generator>
        _ABBR_PCG  = "<abbr title='Permuted congruential generator'>PCG</abbr>";

    /* misc. root modules */

    _DOC_ALL  = "All crate items re-exported in a single flat namespace.\n\n
<br/>Every item in this namespace is forwarded upward, as every other public module does.";

    _DOC_ALL_ = "All crate items re-exported, grouped by their root modules.";
    _DOC_ALL_PLUS_ = "\n\nEach root module appears here and provides
its own flat view of all its public children.

Click on the `▽` symbol after the list of submodules to switch to hierarchical view,
and `◉` to switch back to flat view.
";

    /* thematic modules tree */

    // 1. code (the grammar beneath the crate)
    _DOC_CODE            = "Code structure, semantics, and foundational utilities.";
    _DOC_CODE_ANY        = "Dynamic typing, type identity, and type inspection.";
    _DOC_CODE_BUILD      = "Build-process support and integration.";
    _DOC_CODE_CONVERT    = "Type conversion and adaptation.";
    _DOC_CODE_HINT       = "Compiler and execution hints.";
    _DOC_CODE_INIT       = "Default and const-friendly initialization.";
    _DOC_CODE_MARKER     = "Marker types, traits, and macros.";
    _DOC_CODE_OPS        = "Operational syntax, semantics, and composition.";
    _DOC_CODE_OPS_CALL     = "Callability and invocation semantics.";
    _DOC_CODE_OPS_OVERLOAD = "Overloadable operator traits.";
    _DOC_CODE_OPS_RANGE    = "Range bounds, values, and traits.";
    _DOC_CODE_PANIC      = "Panic hooks, unwinding, and abort strategies.";
    _DOC_CODE_RESULT     = "Generic outcome and resolution types.";
    _DOC_CODE_SOURCE     = "Source-code location, provenance, and inclusion.";
    _DOC_CODE_UTIL        = "Cross-cutting code and macro utilities.";
    _DOC_CODE_UTIL_ASSERT = "Assertion utilities.";
    _DOC_CODE_UTIL_CFG    = "Conditional compilation and configuration.";
    _DOC_CODE_UTIL_DEBUG  = "Debugging and diagnostic helpers.";
    _DOC_CODE_UTIL_SYNTH  = "Code synthesis and macro composition..";
    _DOC_CODE_UTIL_TOKEN  = "Macro token, fragment, identifier, and literal utilities.";

    // 2. data (structure before interpretation)
    _DOC_DATA               = "Structural abstractions for organizing and manipulating data.";
    _DOC_DATA_ACCESS         = "Mechanisms of reachability and traversal.";
    _DOC_DATA_ACCESS_ADDRESS = "Addressability and directed reachability.";
    _DOC_DATA_ACCESS_CURSOR  = "Explicit traversal over ordered data.";
    _DOC_DATA_ACCESS_ITER    = "Composable external iteration.";
    _DOC_DATA_ACCESS_ROUTE   = "Segmented access routes.";
    _DOC_DATA_CODEC         = "Transformations and derivations over data representations.";
    _DOC_DATA_CODEC_BIN     = "Binary representation atoms.";
    _DOC_DATA_CODEC_BIN_BIT = "Bit-focused items.";
    _DOC_DATA_CODEC_CRYPTO  = "Cryptographic primitives for encryption, authentication, and hashing.";
    _DOC_DATA_CODEC_ENCODE  = "Composable codecs for reading and writing values.";
    _DOC_DATA_CODEC_FRAME   = "Framing codecs for bounded byte sequences.";
    _DOC_DATA_CODEC_HASH    = "Hash functions and hashers for compact data fingerprints.";
    _DOC_DATA_CODEC_INTEGRITY = "Integrity checks and correction codes.";
    _DOC_DATA_CODEC_PACK    = "Packed data representations.";
    _DOC_DATA_CODEC_SYMBOL  = "Symbolic codes that encode data into visual marks.";
    _DOC_DATA_HISTORY       = "Origins and evolution of data across derivations and change.";
    _DOC_DATA_HISTORY_REL   = "Historical relations between data and its antecedents.";
    _DOC_DATA_ID            = "Identifiers and references for stable and contextual distinction.";
    _DOC_DATA_ID_HANDLE     = "Compact contextual references interpreted and validated by a resolver.";
    _DOC_DATA_ID_LOCAL      = "Locally scoped identities and allocation mechanisms.";
    _DOC_DATA_ID_UUID       = "Standardized portable 128-bit identifiers.";
    _DOC_DATA_LAYOUT        = "Structural arrangement of elements in memory or sequence.";
    _DOC_DATA_LAYOUT_ARRAY  = "Contiguous homogeneous storage with dimensional projections.";
    _DOC_DATA_LAYOUT_BUFFER = "Capacity-managed storage with explicit occupancy state.";
    _DOC_DATA_LAYOUT_DST    = "Dynamically-sized types stored without need of heap allocation.";
    _DOC_DATA_LAYOUT_LINKED = "Homogeneous, sequentially accessed structures.";
    _DOC_DATA_LAYOUT_QUEUE  = concat!["Homogeneous data structures that process elements in ",
        $crate::_ABBR_FIFO!(), " order."];
    _DOC_DATA_LAYOUT_STACK  = concat!["Homogeneous data structures that process elements in ",
        $crate::_ABBR_LIFO!(), " order."];
    _DOC_DATA_LAYOUT_TABLE  = "Tabular structure over rows, columns, and cells.";
    _DOC_DATA_STORE         = "Retained data stores and retrieval semantics.";
    _DOC_DATA_STORE_ARENA   = "Monotonic stores with stable positions and collective reclamation.";
    _DOC_DATA_STORE_DB      = "Persistent queryable stores with schema and transactional semantics.";
    _DOC_DATA_STORE_CACHE   = "Stores that retain values to reduce recomputation or retrieval cost.";
    _DOC_DATA_STORE_INTERN  = "Canonical stores for deduplicated values and shared identity.";
    _DOC_DATA_STORE_KEY     = "Keyed stores and lookup structures.";
    _DOC_DATA_STORE_KEY_MAP = "Key-value maps organized by lookup and storage strategy.";
    _DOC_DATA_STORE_KEY_SET = "Sets organized by membership and storage strategy.";
    _DOC_DATA_STORE_POOL    = "Reusable stores with generational handles and individual reclamation.";
    _DOC_DATA_TOPOL         = "Connectivity and structural relations independent of storage.";
    _DOC_DATA_TOPOL_GRAPH   = "Graph connectivity over indexed vertex domains.";
    _DOC_DATA_TOPOL_LINK    = "Named fixed-arity links over externally interpreted targets.";
    _DOC_DATA_TOPOL_ORD     = "Structural ordering relations and composition.";
    _DOC_DATA_TOPOL_SPATIAL = "Locality, neighborhood, and partitioning over indexed domains.";
    _DOC_DATA_VALUE         = "Semantic value categories and composable data forms.";
    _DOC_DATA_VALUE_SCHEMA  = "Schemas for encoded values.";
    _DOC_DATA_WORD          = "Data words with exact canonical raw representations.";

    // 3. error (where failure becomes explicit)
    _DOC_ERROR        = "Failure types, result aliases, and recovery semantics";
    _DOC_ERROR_KIND   = "Reusable failure categories and error atoms.";
    _DOC_ERROR_DATA   = "Data-related error types and result aliases.";
    _DOC_ERROR_NUM    = "Numeric error types and result aliases.";
    _DOC_ERROR_MEDIA  = "Media-related error types and result aliases.";
    _DOC_ERROR_TEXT   = "Text-related error types and result aliases.";
    _DOC_ERROR_SYS    = "System and backend error boundaries.";

    // 4. geom (the grammar of space)
    _DOC_GEOM              = "Geometric types, operations, and spatial constructs.";
    _DOC_GEOM_AFFINE       = "Structure of space under translation and linear combination.";
    _DOC_GEOM_AFFINE_FRAME = "Affine reference frames and coordinate systems.";
    _DOC_GEOM_AFFINE_MAP   = "Affine maps combining linear transformation and translation.";
    _DOC_GEOM_AFFINE_POINT = "Positions in affine space without metric or unit semantics.";
    _DOC_GEOM_AFFINE_TRANSFORM = "Semantic affine transformations applied to geometric entities.";
    _DOC_GEOM_DIR          = "Direction, orientation, and angular structure of space.";
    _DOC_GEOM_DIR_NAV      = "Spatial navigation and facing semantics.";
    _DOC_GEOM_FIG          = "Concrete geometric figures and objects.";
    _DOC_GEOM_FIG_CURVE    = "Curved geometric primitives and parametric paths.";
    _DOC_GEOM_FIG_FOLD     = "Discrete folded structures and crease patterns.";
    _DOC_GEOM_FIG_LINE     = "Linear geometric primitives such as segments and rays.";
    _DOC_GEOM_FIG_POLY     = "Polygonal and polyhedral geometric figures.";
    _DOC_GEOM_FIG_SET      = "Collections of geometric figures for aggregation and derivation.";
    _DOC_GEOM_METRIC       = "Spatial positions, measures, regions, and traversal.";
    _DOC_GEOM_REL          = "Spatial predicates and semantic relations between geometric entities.";
    _DOC_GEOM_REL_ADJACENCY   = "Neighborhood and reachability relations between entities.";
    _DOC_GEOM_REL_CONTAINMENT = "Inside, outside, and inclusion relations.";
    _DOC_GEOM_REL_INCIDENCE   = "Incidence relations such as touching and crossing.";
    _DOC_GEOM_REL_ORDER       = "Ordering relations such as betweenness and sequence.";
    _DOC_GEOM_REL_SHARE       = "Relations of shared spatial support or overlap.";
    _DOC_GEOM_SPACE        = "Global organization, decomposition, and structure of space.";
    _DOC_GEOM_SPACE_EARTH  = "Terrestrial reference systems, geodesy, projections, and surveying.";
    _DOC_GEOM_SPACE_FIELD  = "Quantities defined over geometric domains and their level sets.";
    _DOC_GEOM_SPACE_GRID   = "Regular spatial frames, guides, modules, and geometric lattices.";
    _DOC_GEOM_SPACE_LAYOUT = "Constraint-driven placement and resolution of spatial elements.";
    _DOC_GEOM_SPACE_MOTION = "Geometric trajectories, velocities, and change through time.";
    _DOC_GEOM_SPACE_PART   = "Decomposition, covering, subdivision, and tessellation of space.";
    _DOC_GEOM_SPACE_TOPOL  = "Incidence, orientation, adjacency, connectivity, and boundaries.";

    // 5. lang (meaning taking form)
    _DOC_LANG               = "Language structure and meaning across domains.";
    _DOC_LANG_DISC          = "Discourse and expression.";
    _DOC_LANG_DISC_NARR     = "Narrative structure.";
    _DOC_LANG_GRAM          = "Shared grammar and parsing machinery.";
    _DOC_LANG_HUM           = "Human linguistics and language theory.";
    _DOC_LANG_HUM_ART       = "Artificial human languages.";
    _DOC_LANG_HUM_CODE      = "Human code systems, signs, ciphers as cultural language.";
    _DOC_LANG_HUM_I18N      = "Internationalization and localization support.";
    _DOC_LANG_HUM_NAT       = "Natural human languages.";
    _DOC_LANG_PROG          = "Languages of computation and execution.";
    _DOC_LANG_PROG_CALC     = "Executable semantic calculus.";
    _DOC_LANG_PROG_DSL      = "Embedded and domain-specific languages.";
    _DOC_LANG_PROG_IR       = "Lowered program representations.";
    _DOC_LANG_PROG_KERNEL        = "Reusable computational language kernels.";
    _DOC_LANG_PROG_KERNEL_ARRAY  = "Array and tacit programming kernels.";
    _DOC_LANG_PROG_KERNEL_CONCAT = "Concatenative program composition kernels.";
    _DOC_LANG_PROG_KERNEL_RULE   = "Rule-based pattern-action program kernels.";
    _DOC_LANG_PROG_KERNEL_SYMB   = "Symbolic program expression kernels.";
    _DOC_LANG_PROG_PHRASE   = "Source-level program phrases before lowering.";
    _DOC_LANG_PROG_SCRIPT       = "Scripting machinery and language forms.";
    _DOC_LANG_PROG_SCRIPT_EMBED = "Host-embedded scripting notation and generators.";
    _DOC_LANG_PROG_SCRIPT_FORM       = "Scripting and programming language forms.";
    _DOC_LANG_PROG_SCRIPT_FORM_SHELL = "Shell command words and quoting.";
    _DOC_LANG_PROG_SCRIPT_MACHINE    = "Resumable scripting execution machinery.";
    _DOC_LANG_PROG_TEMPLATE = "Text substitution and escaping machinery.";
    _DOC_LANG_PROG_FFI      = concat![$crate::_ABBR_FFI!(), " bindings and interoperability."];
    _DOC_LANG_PROG_FFI_C    =
        "<a href='https://en.wikipedia.org/wiki/C_(programming_language)'>C</a> interfacing.";
    _DOC_LANG_REPR             = "Representation languages.";
    _DOC_LANG_REPR_DATA        = "Structured data and configuration languages.";
    _DOC_LANG_REPR_DATA_SCHEMA = "Schema and grammar languages.";
    _DOC_LANG_REPR_MARKUP      = "Tagged document and markup languages.";
    _DOC_LANG_REPR_STYLE       = "Stylesheet and presentation languages.";
    _DOC_LANG_REPR_TEXT        = "Text-authored representation languages.";
    _DOC_LANG_SEM           = "Semantic relations, independent of form and execution.";

    // 6. media (artifacts made perceivable)
    _DOC_MEDIA              = "Media formats, representation, and synthesis";
    _DOC_MEDIA_AUDIO          = "Sound representation and synthesis.";
    _DOC_MEDIA_AUDIO_ACOUSTIC = "Sound propagation and acoustic spaces.";
    _DOC_MEDIA_AUDIO_EFFECT     = "Audio signal transformations and effects.";
    _DOC_MEDIA_AUDIO_FORMAT     = "Encoded audio and music representations.";
    _DOC_MEDIA_AUDIO_INSTRUMENT = "Instruments, sample maps, presets, and sound banks.";
    _DOC_MEDIA_AUDIO_LAYOUT     = "Audio channel roles, arrangements, and sample layouts.";
    _DOC_MEDIA_AUDIO_MUSIC      = "Musical theory, tuning, notation, harmony, and scores.";
    _DOC_MEDIA_AUDIO_PCM        = "Pulse-code modulation samples, buffers, and stream metadata.";
    _DOC_MEDIA_AUDIO_SYNTH      = "Sound synthesis, generators, envelopes, and modulation.";
    _DOC_MEDIA_COMPO        = "Spatial and temporal composition of media elements.";
    _DOC_MEDIA_COMPO_PLOT   = "Structured plotting of data into visual form.";
    _DOC_MEDIA_DOC          = "Structured document layout and generation.";
    _DOC_MEDIA_DOC_PDF      = "PDF document generation.";
    _DOC_MEDIA_FONT         = "Font data, metrics, and shaping systems.";
    _DOC_MEDIA_MOTION       = "Perceptual motion and temporal sequencing.";
    _DOC_MEDIA_VISUAL       = "Visual media representation and processing.";
    _DOC_MEDIA_VISUAL_COLOR = "Color models and chromatic systems.";
    _DOC_MEDIA_VISUAL_DRAW  = "Geometric drawing primitives and composition.";
    _DOC_MEDIA_VISUAL_IMAGE = "Raster image representation and processing.";
    _DOC_MEDIA_VISUAL_IMAGE_FORMAT = "Encoded raster image representations.";
    _DOC_MEDIA_VISUAL_IMAGE_RASTER = "Raster image storage, views, and access traits.";
    _DOC_MEDIA_VISUAL_VIDEO = "Video stream representation and processing.";

    // 7. num (formal relations of magnitude and uncertainty)
    _DOC_NUM             = "Numeric abstractions and formal computation.";
    _DOC_NUM_ALG         = "Algebraic numeric structures and operations.";
    _DOC_NUM_DOM         = "Numeric domains and value representations.";
    _DOC_NUM_DOM_REAL    = "Real-valued numeric domains and representations.";
    _DOC_NUM_DOM_REAL_FLOAT = "Floating point types and operations.";
    _DOC_NUM_DOM_INT     = "Integer types and operations.";
    _DOC_NUM_EXPR        = "Symbolic numeric forms and manipulation.";
    _DOC_NUM_FIN         = "Finite and discrete numeric structures.";
    _DOC_NUM_FIN_BIT     = "Bitwise operations.";
    _DOC_NUM_FIN_LOGIC   = "Truth systems, reachability, constraints.";
    _DOC_NUM_FIN_ORD     = "Algorithms and structures based on relative ordering.";
    _DOC_NUM_GRAIN       = "Structural granularity and representation of numeric values.";
    _DOC_NUM_GRAIN_NICHE = "Specialized numeric types and behaviors.";
    _DOC_NUM_GRAIN_PRIM  = "Primitive numeric types, families, and representations.";
    _DOC_NUM_GRAIN_WIDE  = "Wide numeric types and parallel arithmetic.";
    _DOC_NUM_LEARN       = "Adaptive numeric systems for prediction and training.";
    _DOC_NUM_OPTIM       = "Objective functions, constraints, and numerical optimization.";
    _DOC_NUM_PROB        = "Probability theory and statistical inference.";
    _DOC_NUM_PROB_DIST   = "Probability distributions, sampling, mass, and cumulative structure.";
    _DOC_NUM_PROB_MARKOV = "Finite-state Markov chains and stochastic transition structure.";
    _DOC_NUM_PROB_RAND   = "Random number generation.";
    _DOC_NUM_PROB_RAND_PRNG  = concat!["Concrete ", $crate::_ABBR_PRNG!(), "s"];
    _DOC_NUM_PROB_RAND_NOISE = "Structured deterministic randomness.";
    _DOC_NUM_PROB_STATS  = "Descriptive statistics and summary measures.";
    _DOC_NUM_QUANT       = "Quantification, measurement, and numerical relationships.";
    _DOC_NUM_QUANT_CONT  = "Continuity, calculus.";
    _DOC_NUM_QUANT_SCALE = "Scaling, remapping, and magnitude transformation of numeric values.";
    _DOC_NUM_QUANT_POWER = "Exponentiation, roots, logarithms, and triadic power relations.";
    _DOC_NUM_SIGNAL      = "Numerical signals and value evolution over domains.";

    // 8. org (agency beyond the individual)
    _DOC_ORG         = "Coordination and structure of collective action.";
    _DOC_ORG_AGENT   = "Intentional entities capable of action and coordination.";
    _DOC_ORG_ECON    = "Exchange, incentives, and flows of value within collectives.";
    _DOC_ORG_GOV     = "Governance, authority, and rule-based coordination.";
    _DOC_ORG_INST    = "Enduring organizational forms and institutional structures.";
    _DOC_ORG_MORAL   = "Normative frameworks of responsibility, duty, and judgment.";
    _DOC_ORG_NORM    = "Shared social norms and informal behavioral expectations.";
    _DOC_ORG_ROLE    = "Roles, responsibilities, and positions within coordinated action.";

    // 9. phys (nature made measurable)
    _DOC_PHYS             = "Physical quantities, units, and models of the natural world.";
    _DOC_PHYS_ASTRO       = "Astronomy-related abstractions.";
    _DOC_PHYS_BIO         = "Biology-related abstractions.";
    _DOC_PHYS_CHEM        = "Chemistry-related abstractions.";
    _DOC_PHYS_ELEC        = "Electrical state, fields, transport, and energetic coupling.";
    _DOC_PHYS_GEO         = "Geophysics-related abstractions.";
    _DOC_PHYS_HEAT        = "Thermodynamics and heat transfer.";
    _DOC_PHYS_MECH        = "Mechanical state, response, interaction, and transmission.";
    _DOC_PHYS_MECH_DEFORM = "Deformation measures, rest states, and mechanical response laws.";
    _DOC_PHYS_MECH_INTER  = "Mechanical interactions, constraints, contacts, and joints.";
    _DOC_PHYS_MECH_KINE   = "Mechanical motion states and kinematic relations through time.";
    _DOC_PHYS_MECH_LOAD   = "Applied forces, torques, impulses, and distributed mechanical loads.";
    _DOC_PHYS_MECH_TRANS  = "Mechanical transmission, transformation, and transduction.";
    _DOC_PHYS_OPTIC       = "Optics and light transport in piecewise media.";
    _DOC_PHYS_SUBS        = "Physical substrates, bodies, phases, and material response properties.";
    _DOC_PHYS_TIME        = "Time and calendar types and operations.";
    _DOC_PHYS_TIME_SOURCE = "Time sources.";
    _DOC_PHYS_UNIT        = "Physical units of measure and unit prefixes.";
    _DOC_PHYS_WAVE        = "Wave primitives, wavelets.";

    // 10. run (where execution becomes actual)
    _DOC_RUN               = "Temporal coordination and staging of a running system.";
    _QUO_RUN               = "> Where execution exists, progresses, and becomes concrete.";
    _DOC_RUN_APP           = "Application-level runtime semantics.";
    _DOC_RUN_CYCLE         = "Phases and transitions of a running system.";
    _DOC_RUN_TIME          = "Temporal structure and progression within a run.";
    _DOC_RUN_TIME_LOOP     = "Composed policies for advancing time within a run.";
    _DOC_RUN_PLAN          = "Policies for staging runtime progression.";
    _DOC_RUN_PLAN_SCHED    = "Scheduling of run-level signals, ticks, and staged activity.";
    _DOC_RUN_PLAN_BUDGET   = "Constraints on how much run-level activity may advance in one step.";
    _DOC_RUN_PLAN_LANE     = "Runtime lanes for grouping staged activity by semantic flow.";
    _DOC_RUN_REGIME        = "The committed configuration of a running environment.";
    _DOC_RUN_REGIME_CAP    = "Declared runtime capabilities available to a running system.";
    _DOC_RUN_STATE         = "The mutable state of a running system.";
    _DOC_RUN_STATE_CONTEXT = "Ambient, ephemeral state associated with the current run step.";
    _DOC_RUN_STATE_LOG     = "Sequential records of runtime state evolution.";
    _DOC_RUN_STATE_SCENE   = "A bounded runtime situation defining active state and transitions.";

    // 11. sys (the pact with the host)
    _DOC_SYS             = "System interfaces and hardware abstractions.";
    _DOC_SYS_ARCH        = "Architecture-specific intrinsics.";
    _DOC_SYS_DEVICE      = "Live system device interfaces.";
    _QUO_SYS_DEVICE      = "> Usable system devices exposed to running programs.";
    _DOC_SYS_DEVICE_AUDIO       = "Audio device backends and stream interfaces.";
    _DOC_SYS_DEVICE_DISPLAY     = "Display backends for windows, surfaces, and events.";
    _DOC_SYS_DEVICE_DISPLAY_X11 = "X11 display backend.";
    _DOC_SYS_ENV         = "Process environment inspection and manipulation.";
    _DOC_SYS_FS          = "Filesystem abstractions.";
    _DOC_SYS_FS_PATH     = "Cross-platform path manipulation.";
    _DOC_SYS_HW          = "Low-level hardware and driver-facing system interfaces.";
    _QUO_SYS_HW          = "> Hardware-facing system foundations.";
    _DOC_SYS_IO          = "I/O primitives and stream interfaces.";
    _DOC_SYS_LOG         = "Instrumentation, diagnostics, logging, tracing, and measurement.";
    _DOC_SYS_LOG_BENCH   = "Execution timing, measurement, and benchmark instrumentation.";
    _DOC_SYS_LOG_TRACE   = "Structured diagnostic spans, events, and causality.";
    _DOC_SYS_MEM             = "Memory primitives, layout contracts, and safe access foundations.";
    _QUO_SYS_MEM             = "> How bytes live, move, and are validated.";
    _DOC_SYS_MEM_ALLOC       = "Allocation strategies and ownership-backed storage abstractions.";
    _DOC_SYS_MEM_BOUND       = "Addressing, alignment, and movement constraints over memory.";
    _DOC_SYS_MEM_BOUND_PIN   = "Types that pin data to a location in memory.";
    _DOC_SYS_MEM_BOUND_PTR   = "Manual memory management via raw pointers.";
    _DOC_SYS_MEM_CELL        = "Shareable containers with interior mutability.";
    _DOC_SYS_MEM_LAYOUT      = "Memory layout, bit-validity, and representation invariants.";
    _DOC_SYS_MEM_SIZE        = "Memory size, bit width, and storage accounting.";
    _DOC_SYS_MEM_VIEW        = "Typed and byte-level views over memory.";
    _DOC_SYS_MEM_VIEW_BORROW = "Borrowed data and ownership-relaxed views.";
    _DOC_SYS_MEM_VIEW_SLICE  = "Contiguous views into memory.";
    _DOC_SYS_NET           = "Network connectivity, addressing, routing, and transport.";
    _DOC_SYS_NET_INET      = "Internet-layer addressing, packet delivery, and adaptation.";
    _DOC_SYS_NET_LINK      = "Local-link framing, medium access, and direct connectivity.";
    _DOC_SYS_NET_MESH      = "Multi-hop networking across self-forming local meshes.";
    _DOC_SYS_NET_NAME      = "Network naming, resolution, and service discovery.";
    _DOC_SYS_NET_SECURE    = "Authenticated and encrypted network channels.";
    _DOC_SYS_NET_TRANSPORT = "End-to-end transport for streams, datagrams, and connections.";
    _DOC_SYS_NET_TRANSPORT_QUIC = "Secure multiplexed transport over UDP.";
    _DOC_SYS_NET_TRANSPORT_SCTP = "Message-oriented transport with multistreaming and multihoming.";
    _DOC_SYS_NET_TRANSPORT_TCP  = "Reliable ordered byte-stream transport.";
    _DOC_SYS_NET_TRANSPORT_UDP  = "Connectionless datagram transport.";
    _DOC_SYS_OS             = "Operating systems and supervisors.";
    _DOC_SYS_OS_BROWSER     = "Browser supervisory environment.";
    _DOC_SYS_OS_BROWSER_WEB = "Browser and Web API bindings for `wasm32` targets.";
    _DOC_SYS_OS_FD          = "Unix-like file descriptors.";
    _DOC_SYS_OS_LINUX       = "Linux-specific definitions.";
    _DOC_SYS_OS_TERM        = "Terminal supervisory environment and ANSI/TTY interfacing.";
    _DOC_SYS_OS_TERM_GRID   = "Terminal cell elements, grids, and composition.";
    _DOC_SYS_OS_WINDOWS     = "Windows-specific definitions.";
    _DOC_SYS_SERVICE          = "Application-level protocols for networked services.";
    _DOC_SYS_SERVICE_DEVICE   = "Discovering, describing, and controlling networked devices.";
    _DOC_SYS_SERVICE_EMAIL    = "Electronic-mail transfer, access, and synchronization.";
    _DOC_SYS_SERVICE_FILE     = "Remote file transfer and access.";
    _DOC_SYS_SERVICE_MESSAGE  = "Messaging, publication, subscription, and exchange.";
    _DOC_SYS_SERVICE_REMOTE   = "Remote sessions, command execution, and administration.";
    _DOC_SYS_SERVICE_WEB      = "Web communication and resource-oriented interaction.";
    _DOC_SYS_SERVICE_WEB_HTTP = "The HTTP protocol.";

    // 12. text (cultural symbols held in sequence)
    _DOC_TEXT            = "Symbolic sequences, encodings, and text processing.";
    _DOC_TEXT_ASCII      = "ASCII characters, sets, digit operations, and related data.";
    _DOC_TEXT_CODEC      = "Text codecs, alphabets, and transmission codes.";
    _DOC_TEXT_DRAW       = "Drawing with textual symbols.";
    _DOC_TEXT_FMT        = "Text and string formatting.";
    _DOC_TEXT_GENERATE   = "Procedures that produce text.";
    _DOC_TEXT_LAYOUT     = "Spatial arrangement of text within available extent.";
    _QUO_TEXT_LAYOUT     = "> A negotiation between a symbolic sequence and bounded space.";
    _DOC_TEXT_METRIC     = "Text measures, positions, cursors, and ranges.";
    _DOC_TEXT_PARSE      = "Lightweight parsing over string slices.";
    _DOC_TEXT_STR        = "String types, views, and storage invariants.";
    _DOC_TEXT_TRANSLIT   = "Lossy script, alphabet, and symbol approximations.";
    _DOC_TEXT_UNICODE          = "Unicode text units, properties, and algorithms.";
    _DOC_TEXT_UNICODE_SCALAR   = "Unicode scalar values and operations.";
    _DOC_TEXT_UNICODE_GRAPHEME = concat!["Unicode", $crate::_ABBR_EGC!(), "s."];

    // 13. ui (contact between human and system)
    _DOC_UI = "Interactive surfaces, input semantics, and presentation state.";
    _QUO_UI = "> How humans interact with what exists.";
    _DOC_UI_EVENT    = "Normalized input, control, and presentation-surface events.";
    _DOC_UI_FRAME    = "Frame context, scoped identity, and processing phases";
    _DOC_UI_INTENT   = "Desired UI configuration before capability-bound realization.";
    _DOC_UI_LAYOUT   = "Canonical spatial vocabulary for deterministic arrangement.";
    _DOC_UI_ROUTE    = "Identity-based interaction regions and ownership state.";
    _DOC_UI_SEMANTIC = "Human-facing roles, actions, state, and text.";
    _DOC_UI_TEXT     = "Interactive text editing state.";
    _DOC_UI_VIEW     = "Projection of UI state into concrete presentation forms.";
    _DOC_UI_VIEW_DRAW    = "Backend-neutral spatial draw records produced by UI view projection.";
    _DOC_UI_VIEW_FORM    = "Cell, document, graphic, and message forms of UI projection.";
    _DOC_UI_VIEW_PROFILE = "Presentation profiles for fitting logical views into output space.";
    _DOC_UI_VIEW_SCALE   = "Pixel, density, and text scaling units for view projection.";
    _DOC_UI_WIDGET = "Semantic controls expressed through frame-local authorship.";

    // 14. vita (life as capacity and practice)
    _DOC_VITA       = "Lived practices of embodied beings.";
    _DOC_VITA_BODY  = "Embodied capability, health, and physical limits of living beings.";
    _DOC_VITA_CRAFT = "Practical, learned ways of shaping material reality to support life.";
    _DOC_VITA_HOME  = "Inhabited space, from dwelling to built and shared environments.";
    _DOC_VITA_LOVE  = "Relational life, from kinship and care to intimacy and community.";
    _DOC_VITA_MIND  = "Cognition, memory, meaning, and inner orientation of lived experience.";
    _DOC_VITA_PLAY  = "Expression, play, and shared enjoyment beyond necessity or survival.";
    _DOC_VITA_PLAY_GAME = "Games across cultures.";

    // 15. work (effort given executable form)
    _DOC_WORK              = "Computational work, its coordination, and its execution.";
    _DOC_WORK_EXEC         = "Execution loci that host and run work.";
    _DOC_WORK_EXEC_FIBER   = "User-space suspended execution carriers.";
    _DOC_WORK_EXEC_PROCESS = "Process-based execution of work.";
    _DOC_WORK_EXEC_REMOTE  = "Execution hosted beyond the local process boundary.";
    _DOC_WORK_EXEC_THREAD  = "Thread-based execution of work.";
    _DOC_WORK_EXEC_WORKER  = "Long-lived isolated execution agents that host and control work.";
    _DOC_WORK_FUTURE       = "Rust-style asynchronous computations and polling continuations.";
    _DOC_WORK_PLAN         = "Policies for ordering, admitting, and advancing work.";
    _DOC_WORK_PLAN_BUDGET  = "Constraints on how much work may advance before yielding or stopping.";
    _DOC_WORK_PLAN_SCHED   = "Task scheduling policies and progression control.";
    _DOC_WORK_TASK         = "Schedulable units of work and their control state.";
    _DOC_WORK_TASK_ACTOR   = "State-owning message-driven tasks.";
    _DOC_WORK_TASK_CORO    = "Cooperative tasks that yield and resume explicitly.";
    _DOC_WORK_SYNC         = "Synchronization and communication for concurrent work.";
    _DOC_WORK_SYNC_ATOMIC  = "Atomic coordination primitives.";
    _DOC_WORK_SYNC_MPSC    = "Multi-producer, single-consumer channels.";

    // 16. yard (where the crate tends itself)
    _DOC_YARD       = "Scaffolding, taxonomy, and documentation support.";
    _QUO_YARD       = "> This space exists so the rest can be clean.";
    _DOC_YARD_DEPS  = "Re-exported dependencies.";
}