Skip to content

A view's rail is a tree at any depth, with signs, a pulse, folds and a key (0.7.0) - #25

Merged
pierg merged 3 commits into
mainfrom
lab-states-and-tree-rail
Nov 15, 2026
Merged

pierg merged 3 commits into
mainfrom
lab-states-and-tree-rail

Conversation

@pierg

@pierg pierg commented Nov 15, 2026 •

Copy link
Copy Markdown
Owner

What

A view provider's rail can now be a tree of any depth, which lab-kit 1.6.0 uses to draw goals, then questions, then steps.

  • An entry with items is a group at any depth. Every group that holds the page being read opens, so the page shows in its place.
  • New optional keys on an entry: id (short id before the title), mark (a letter for its kind), sign (a character in its tone's colour), pulse (live, pulses; off under reduced motion), gone (struck through).
  • A group may carry summary (counts per state, shown while closed) and fold (drawn quietly, for what was set aside).
  • Two new tones: ink and gone. An entry with legend is drawn last as a closed key.
  • A provider that sends none of these renders as before.

Version 0.7.0, since 0.6.0 (pinned pages) is already released.

Gate

python -m pytest -q: 375 passed, 2 skipped. cd docs && folio check: 0 errors.

Order

lab-kit 1.6.0 (pierg/lab-kit#34) requires folio-kb>=0.7.0, so this lands and is released first.

…a key

A provider's rail entry may now hold entries at any depth, carry a short id, a
mark for its kind, a sign coloured by its tone (ink and gone join the tones), a
pulse for what is live, a dimmed look for what is gone, per-state counts for a
closed group, a fold for what is set aside, and a key. A group opens when it holds
the page being read.
@pierg

pierg commented Nov 15, 2026

Copy link
Copy Markdown
Owner Author

Review by a fresh reader who did not write the change: pass. The gate passed (375 passed, 2 skipped; folio check 0 errors). Providers that send none of the new keys draw as before, and the library rail and pinned pages are untouched.

Addressed in 4cad352:

  • The deeper nested indent applied to the library rail's section lists too. It now applies only to a view's tree, through .f-vgroup.
  • The 0.7.0 changelog heading now has its date.

Left as minor follow-ups:

  • A group with no url draws a plain button, without its id, mark or sign.
  • Two url-less groups with the same title share a storage key.
  • There is no gone colour for a sign, only for a dot.
  • The caret's aria-label includes the sign characters.

Generated by Claude Code

@pierg
pierg marked this pull request as ready for review November 15, 2026 18:56
…-usvia7

# Conflicts:
#	CHANGELOG.md
#	pyproject.toml
#	src/folio/__init__.py
@pierg
pierg merged commit 8c0758f into main Nov 15, 2026
4 checks passed
@pierg
pierg deleted the lab-states-and-tree-rail branch November 15, 2026 19:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant