2 Commits

Include renames

Author	SHA1	Message	Date
dtourolleandClaude Opus 5	23f0c4b76a	Let a declared node ask for a widget, and write down how ... Two gaps in the control vocabulary, both found by reading back what 0a331c7 actually shipped against what it claimed. **`kind: enum` worked and was undocumented.** The whole point of that kind is that a node author can declare a control without touching the interface, and ops/README.md is where a node author looks. A kind absent from the table is one nobody will use. It is now in the table, with the property that makes it cheap spelled out: the value is the chosen index carried as an `f32` like every other parameter, so a uniform expression can read it, the sidecar stores it unchanged, and nothing along the way needed a second kind of value. **A declared node could not ask for a widget at all.** `Presentation` gained an ordered preference list and a demand, and `tone_curve` and `framing` use them — but both are hand-written Rust. A YAML node had no way to say that several of its parameters form one control, so the generated half of the pipeline was locked out of the half of FR-DEV-3a that makes widgets extensible. Nodes now take a `presentation:` block: presentation: widgets: [colour_wheel] demand: { two_dimensional: true } params: [hue, strength] `demand` carries exactly two flags and there is deliberately no key for a pixel width, a breakpoint or a platform name — those are the frontend's to decide, and ARCH §4.3a is explicit that a core reasoning about them will eventually be wrong about a display it never saw. Widget names are spelled in the YAML the way `WidgetKind` spells them, so a declaration and descriptor.rs cannot drift into two vocabularies for one idea, and an unknown one is a build error listing the six that exist. `params:` is checked against the node's own parameters: the widget claims what it names and the generic path skips what was claimed, so a typo would silently drop a parameter out of *both* — the one mistake here that produces no error and no control. Verified by declaring a presentation on a node, confirming the generated `fn presentation` matched, and confirming both error paths report the file and the key; then reverted, since no node in the chain wants a widget yet. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-16 23:54:10 +02:00
dtourolleandClaude Opus 5	7c57f490fe	Declare a develop operation in YAML, and generate the rest ... An operation was, in the overwhelming majority of cases, four facts: what its parameters are, what uniforms they compute, what WGSL those uniforms drive, and where it sits in the chain. Written in Rust those four facts arrived wrapped in ninety lines of trait implementation — a match on parameter id to a struct field, another match back, an is_active comparing each field to its default, a Vec<Uniform> built by hand. All mechanical, and each one a place to make a silent mistake: a param() arm returning the wrong field reads perfectly and breaks the sidecar round-trip. So the four facts are the file now. core/dr-pipeline/ops/<id>.yaml is a node, build.rs compiles it into the same Operation impl as before, and the result lands in OUT_DIR — the same reasoning as style.yaml -> theme.slint, including why it does not land beside the sources it would look exactly like. Nothing downstream can tell a declared node from a hand-written one: same &'static OpDescriptor, same fused-shader composition, same sidecar. Nine nodes moved: exposure, white_balance, contrast, highlights_shadows, blacks_whites, brilliance, vibrance, saturation, and the shared WGSL helper registry. Their prose came with them, and so did their tests — set/expect/expect_active/expect_wgsl in the declaration compile to real #[test]s, so a node file carries its own proof rather than leaving it behind in a file that no longer exists. Two stayed in Rust and say so with `rust:`. The tone curve's neutral is a relationship between five interpolated points rather than a set of values; the colour mixer generates thirty-six faceted parameters from twelve computed hue bands. A schema stretched to cover either would be a worse language than Rust aimed at one caller. They still declare their position here, because the chain's *order* is the one thing a reader comes to this directory to learn, and an order written half in YAML and half in Rust would be worse than either alone. default_chain() is generated from it. Uniforms are derived by a small expression language — exp2(exposure), blacks / 100 * 0.02 — compiled to Rust rather than interpreted, so an unknown name or a wrong arity is a build error naming the file and the key and the arithmetic costs nothing at runtime. The build script refuses a duplicate order, a filename disagreeing with its id, a default outside its own range, a test value the graph would clamp before the node saw it, a helper that does not define the function it names, and a declared node colliding with a file in src/ops. Verified by adding a scratch node and removing it again: one file, no other edit, and it joined the chain at its declared order with its test running. 237 tests pass in dr-pipeline, clippy and fmt clean. .yaml joins the traceability tool's scanned suffixes, because a node's Rust now lives in OUT_DIR where a tag could never be linked from the report. Coverage 47.7% -> 48.3%. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-16 21:08:16 +02:00