Skip to content

0.5.0

Choose a tag to compare

@uchimata2 uchimata2 released this 20 Aug 15:48
· 220 commits to master since this release

Most of this release came from watching somebody else build a deck with 0.4.0 in their own project,
reading the whole session back afterwards, and writing down everything that got in their way. Four
of the defects that came out of it were in the published plugin, which is why this is a minor
release rather than a patch.

The commands in the instructions now run

Every command this plugin documents was written against ${CLAUDE_PLUGIN_ROOT}. Claude Code
interpolates that into a plugin's manifest files. It does not put it into a shell, so the commands
expanded to python /tools/deck/check.py and failed. The build that found this read the documents
in full, never used the variable once, and hardcoded a version-pinned path into its own home
directory 87 times instead, in a session that had updated the plugin an hour earlier.

SKILL.md now opens with a section that resolves the plugin directory by looking for it.

Controls answer the hand

Pressing the back or forward arrow used to take most of half a second to show anything, because the
pager borrowed its timing from a slide reveal. The back arrow never showed anything at all: the rule
that gives it its correct lean carried one more class than the rule for the press, so it won, and
the press never rendered. Every deck this project has ever shipped had that, and no check here could
see it, because nothing here can watch an animation play.

There are now two short bands for a control, separate from the timings the slides move on, and a
check that reads the cascade rather than the declarations.

Every slide says what it is about

The line above the headline used to repeat the slide number and the section name, both of which the
bar along the bottom was already showing. Now it names the thing on the slide, so a presenter
glancing up learns something they could not get from the chrome. Two of the three example decks here
had the old habit across 23 slides, and both are rewritten.

A deck can open on a lobby

The slide an audience looks at while the room fills: the topic, who is presenting, what the occasion
is, and nothing from the argument. It is optional, exactly as the sources page at the end is, and
neither of them counts towards the slide numbers any more. They are covers, not content.

Smaller things

A quoted source reads like a document now rather than like a slide. Its headings had been smaller
than its own body text.

A failing check names what failed. Two rules used to report how many icons were dead or how many
elements were too wide while holding the list of them, so the only way forward was to read this
project's source, which the build that reported it did seven times.

shell.py icons --help printed a traceback. render.py shots 12 rendered slide 13.

spec.py could not express a figure worked out from two documents, which is exactly what a deck
comparing two documents is made of.

Upgrading

Version What it newly required What newly fails The smallest edit
0.5.0 Four theme tokens and one rule about copy. --afford-dur, --afford-ease, --press-dur and --press-ease are required declarations, the band a control's answer to the hand runs in (DS-240). DS-241 is new and it is about words, which is the first requirement here that an adopter cannot settle with a command: every eyebrow must name its slide's subject rather than the position, the stage or the headline's own words. The shared shell moved in components.css and deck.js. data-stage gains a third non-index value, front, which is additive: a deck using no lobby is unaffected. render.py shots counts slides from one. check.py on every deck built before this release: DS-013, four tokens not declared; DS-229, three motion rows now naming --afford-*; DS-240, the pager's press outranked by its hover, which is a real defect every shipped deck carried; and DS-241 on any slide whose eyebrow reads 02 · Why now. Also shell.py check, where COMPONENTS and SCRIPT differ. Measured on a real outside deck before the tag, which is where three of the four came from. python tools/deck/shell.py tokens <deck> --write, then sync <deck> --write, settles DS-013, DS-229, DS-240 and the shell rows. DS-241 is the one that needs a person: one line of copy per slide, naming what is on it.

One thing worth saying about the checks

Three of the checks written for this release found nothing on their first run and were wrong to.
Two matched on the wrong relation and one had an assertion that could not fail. All three were
caught the same way, by putting the defect back and watching the check go red before believing the
green.