Skip to content

0.6.0

Choose a tag to compare

@uchimata2 uchimata2 released this 22 Aug 19:49
· 185 commits to master since this release

This is the release where the gate stopped taking the deck's word for things. Every check used to
read the file. Now it also opens the file, clicks through every slide, and reports what the browser
actually did.

Seven of those reports are new. The console has to stay clean from the load to the last slide. The
embedded faces have to load, and the text has to come out in them. Nothing may scroll out of its box
or jump when the fonts arrive. Every canvas has to draw, and every slide has to be reachable without
a script error. Reading the file answers none of that.

Diagram labels no longer sit on top of one another. A deck here passed every check while carrying
fifteen chart defects that only people found, and three separate readings each missed some of them.
A tool now measures label against label on the rendered page.

Charts can use a chart engine, if the reader is meant to interrogate them by hovering a series for
its value or brushing a range of it. The deck declares the engine in its own head. A deck that
declares nothing is held to hand-written SVG, which is where every deck stands today.

The motion rules read what a motion says about itself instead of what it is called. One of them was
an allow-list of a single class name, so any looping animation you wrote that was not that one class
failed a gate for a design the rules permit.

Speaker notes have somewhere to live. They go into a presenter build, a second file made from the
same specification. It carries a marker the gate fails on, so it cannot become the file you send.

Upgrading

This is the 0.6.0 row of docs/PUBLISHING.md section 8.1, which is where the repository keeps it.

What it newly required. Seven glitch-free conditions and a collision rule, both decided on the rendered page rather than in the markup. GF-2 to GF-8 (T-041) decompose ../CLAUDE.md rule 2 and are answered from one browser walk: the console clean over the load and one pass; every declared @font-face reporting loaded; text rendered in an embedded face rather than a fallback; no slide's stage scrolling past its own box; no box moving over the font swap; every canvas surface drawing something; every slide reached first to last without a script error. DS-244 (T-204) is new and gates: two diagram labels sharing more than 30% of the smaller one's extent in both axes are a collision. Two declarations a motion makes about itself, both replacing an instrument that read a name instead of a claim: --motion-long, DS-141's licence to run past the 500 ms cap (T-187), and --motion-subject, which is what DS-142 now reads instead of the class name .current (T-214). The shared shell moved in components.css and in neither other region. Two changes require nothing of a deck and this says so rather than leaving it inferred: DS-122 now admits a declared chart engine (T-202) through one <meta name="htmldeck-chart-engine">, and a deck that declares nothing is held to the hand-authored default, which is where every deck today stands; and DS-142's rebinding removes a failure rather than adding one, since a looping motion that was not .current could not pass at all before.

What newly fails. check.py on every deck built before this release, and for the first time the failures need a browser to see. GF-3 and GF-4 on a deck whose faces are linked rather than embedded — which rule 1 forbade from the start and nothing here could measure; GF-6 on a deck whose layout moves over the font swap; GF-8 on a deck with a script error on any slide past the first. DS-244 on any deck whose diagram labels overlap — it is the instrument written after the portfolio-review deck passed every gate here while carrying fifteen chart defects that only people found. DS-141 on a deck's own motion running past 500 ms in a rule declaring no --motion-long: the waiver used to be the declaration reads --pulse-dur or --current-dur, so a deck reusing either token name passed without ever saying why, and now it says why. Also shell.py check — COMPONENTS differs from shell/components.css. GF-7 returns NO SUBJECT on a deck that draws no canvas, which is the gate's third state and is not a pass.

The smallest edit. python tools/deck/shell.py sync <deck> --write settles the shell row and is the only part a command can settle. The rest need the deck opened in a browser, because six of the seven conditions are facts about what the browser did and no markup states them: python tools/deck/check.py <deck> runs the walk and prints GF-2 to GF-8 with what each measured. For DS-244, move the colliding label — the row names both boxes and the slide it is on. For DS-141, add --motion-long:<reason> to the rule from the closed set loop, illustration, emphasis, request; for a motion that loops, add --motion-subject:live beside it.

Twenty tasks closed into this release. The board is in
tasks/README.md.