Brummel
19dc42f5ca
The first formal-links milestone shipped clause-5 + 8 links across the
existing file layout. Browsing surfaced that file-only granularity is
only as precise as the file boundaries — three files mixed two or
three navigation targets under one address, so the 8 links could not
multiply without ambiguity. This commit fixes the substrate, then
applies the sweep the original milestone deferred.
Splits (each extracts an already-self-contained section into its own
file so links land on the topic, not the parent doc's TOC):
contracts/typeclasses.md
→ +contracts/prelude-classes.md (Eq/Ord/Show ships, polymorphic `print`)
→ +contracts/method-dispatch.md (5-step dispatch rule, candidate index)
contracts/memory-model.md
→ +contracts/language-constraints.md (the 4 binding constraints
making RC sound without a
cycle collector)
models/authoring-surface.md
→ +models/prose-projection.md (Form-B / `ail prose` / merge-prose)
Each new file enters design/INDEX.md as its own row (three contracts
share show_no_instance_e2e.rs / uniqueness.rs as ratifying tests;
prose-projection is a model). Two pre-existing links rebind to the
new topic-files (memory-model.md → method-dispatch.md;
float-semantics.md → prelude-classes.md).
Link sweep: 8 → 88 formal Markdown links over 23 files. Every file
in design/contracts/ + design/models/ now has at least one outgoing
link; the tree is fully connected. Links are file-relative
`[label](path)` per the established convention, fenced code blocks
are skipped (a `](` inside ```jsonc``` is literal text), the durable
tier (design/ + crates/ + runtime/) is enforced by clause-5.
Tests:
- design_index_pin.rs (5/5 clauses): clean-cut, INDEX resolution,
ratifying-test resolution, no decision-record prose in contracts/,
body links durable + resolving.
- docs_honesty_pin.rs (5/5): one assertion rebinds from typeclasses.md
to prelude-classes.md (where the gated sentence now lives);
design_corpus widens to include the 4 new files so the Wunschdenken
/ doc-archaeology sweeps continue to cover everything that used to
live in the parents.
No spec/plan/journal for this batch — interactive collaboration after
the milestone closed; the user gated the splits explicitly before the
sweep.
1.7 KiB
Prelude (built-in) classes
Prelude (built-in) classes
The prelude ships the Ordering ADT, the Eq and Ord
classes, primitive Eq Int/Bool/Str and
Ord Int/Bool/Str instances, and the five polymorphic free-fn
helpers ne/lt/le/gt/ge. Float has neither Eq nor Ord
instance per Float semantics; a polymorphic
helper invoked at Float fires NoInstance at typecheck with a
Float-aware diagnostic cross-referencing this section. The lookup
machinery that turns a show x call site into the right monomorphic
instance is documented in method dispatch.
The prelude ships class Show a where show : (a borrow) -> Str and
primitive Show Int, Show Bool, Show Str, Show Float
instances. Float is included in Show (unlike Eq/Ord) — IEEE-754
makes structural equality and total ordering semantically dubious,
but textual representation of a Float is well-defined modulo the
NaN-spelling caveat in Float semantics. Each
Show <T> instance body is a single-application lambda invoking the
corresponding runtime primitive (int_to_str, bool_to_str,
str_clone, float_to_str; see Str ABI for the
heap-Str primitives); no codegen intercept is required. The
polymorphic helper print : forall a. Show a => a -> () !IO has body
\x -> let s = show x in do io/print_str s (explicit let-binder for
heap-Str RC discipline per eob.1 Str carve-out). The let-binder is
structurally pinned by crates/ail/tests/print_mono_body_shape.rs.
Routing through print is the path for non-Str primitives;
io/print_str is the only built-in direct-output effect-op.
Ratified by: crates/ail/tests/show_no_instance_e2e.rs.