Skip to content

0.8.0 - a space says which way it is bounded

Choose a tag to compare

@corderro-artz corderro-artz released this 08 Sep 08:47
· 635 commits to main since this release

A counted DNA space now says which direction it is bounded in

UniqueSpace carried a bool IsExact, and three different outcomes shared its false branch — so every surface rendered all three the same way, "more than N". Two of them really are floors. The third is the opposite: when a recipe has rules and more combinations than the enumeration budget, the walk is skipped, and the count reported the budget. A book whose rules exclude all but four hundred selections announced "more than 1,000,000".

SpaceCertainty names the direction — Exact, AtLeast, AtMost, Unknown:

  • the skipped-walk case reports the unconstrained product as at most N, a fact about the book rather than about the counter;
  • it reports nothing when the color buckets that product was built from were themselves under-counted, because a product built on an under-count bounds the truth in neither direction;
  • summing spaces goes through UniqueSpace.Combine, not an &= — a floor plus a ceiling is Unknown, the case a bool cannot express.

Large figures are readable

Generation/SpaceText.cs is now the one place a DNA-space figure is worded, for the CLI and the GUI both. Numbers are thousands-separated and invariant, so two people diffing a report see the same text on any machine.

The CookBook card's UNIQUE DNA tile prints every digit below a billion and a named magnitude above it (2.82 billion) — degrade only when you must — with the exact value on the tooltip. Scientific notation was the alternative and is the wrong register for a card an artist reads while sizing a collection. The cookbar keeps the full figure: it exists to compare an intended supply against the space, and comparing a rounded number with an exact one is not a comparison.

Fixed

  • Unique DNA space: 615600 → Unique DNA space: 615,600 in stats and inspect.
  • UniqueSpaceExhaustedException carries Certainty instead of IsExact, and its message has four forms rather than two — it no longer tells you a book allows "more than" a number it may never reach.
  • Generator no longer keeps its own copy of the saturating add and the certainty fold.

Breaking (library): RecipeSpace, UniqueSpaceCount and UniqueSpaceExhaustedException take a SpaceCertainty where they took a bool. IsExact survives as a derived property and still means exactly one thing: nothing gave up.

Downloads

Archive Needs
single-file-net10 .NET 10 runtime installed — smallest
framework-dependent .NET 10 runtime installed
single-file nothing — one self-contained .exe
portable nothing — a folder you can copy