feat(siddur): customize the Koren siddur by hiding sections (POC)

[mickeysefaria]

Description

POC, deployed to the customsiddur cauldron only.

The book TOC of The Koren Shalem Siddur; Ashkenaz gets a Customize button. It opens a modal with a checkbox tree of the whole siddur, all checked. Unchecking a section (e.g. Weekdays › Tallit) or a root (e.g. Shabbat) hides it:

• dropped from the book TOC (full page and reader sidebar);
• skipped by the reader's infinite scroll, both directions;
• skipped by Start Reading.

Weekday sub-sections: the Weekdays nodes also list sub-sections, collapsed by default. Examples: On Waking › Tzitzit, Minha › The Amida › Kedusha, Aleinu. Unchecking one hides just those paragraphs inside the section. Unchecking every sub-section of a node hides the whole node.

Display options at the top of the modal:

• Show instructions (on by default). Off removes the text's <i class="instruction"> elements, and paragraphs that held only instructions disappear.
• Show a note where sections are hidden (off by default). On puts Not showing “Tzitzit”. Customize where hidden paragraphs or skipped sections were. Customize opens the modal right in the reader.

Everything is saved in localStorage (siddur.hiddenSections, siddur.displayOptions), per device, with no account needed. Direct links to a hidden section still open it.

Code Changes

• static/js/sefaria/siddurCustomization.js (new, pure):
  • book allowlist; storage for hidden refs and display options; subscribeCustomization (same tab and cross-tab);
  • schema → tree, plus buildCustomizeTree for sub-sections;
  • resolveHidden, which splits stored refs into whole sections and named paragraph ranges;
  • pruneSchema, isRefHidden, skipHidden, firstVisibleSectionRef;
  • helpers for instructions and notes: stripInstructions, visibleSegments, hintGroups, interleaveHints, hiddenRun, namesFor.
• static/js/sefaria/siddurSubsections.json (new, ~3 KB gzipped): a curated map of the 13 Koren weekday nodes that have sub-sections.
  • It was built from the text's bold heading paragraphs, with nesting (the Amida blessings) and unheaded parts (Ashrei, Aleinu, Elokai Netzor) added.
  • Within each node, the children cover its whole paragraph range.
• static/js/SiddurCustomizeModal.jsx (new): the display toggles; tri-state, collapsible tree; Show All / Cancel / Save.
• static/js/SiddurHiddenHint.jsx (new): the inline note.
• BookPage.jsx: Customize button (shows "N hidden"), the modal, a pruned schema in TextTableOfContents, and the first visible section for Start Reading.
• TextColumn.jsx:
  • neighborRef() replaces raw next/prev for infinite scroll;
  • adds notes between sections for skipped hidden sections;
  • passes the display props to each TextRange;
  • hosts the modal.
• TextRange.jsx: optional hiddenSegments, hideInstructions, showHiddenHints and onSiddurCustomize props.
• common/modal.jsx: optional className.
• s2.css, i18n siddur_customize.* (en/he).
• Jest: siddurCustomization.test.js and siddurCustomizeModal.test.js. The tests include a check that every node's sub-sections cover all of its paragraphs, plus cases for instruction stripping taken from the Koren text.

Notes

• Customization is read after mount only, so SSR output and hydration are unchanged. As a result, on a direct page load, hidden content shows briefly until the client mounts.
• Hidden items are stored as refs: section refs, or paragraph ranges such as …, Weekdays, On Waking 8-12. A ref saved for a section that has since gained sub-sections stands for all of them.
• Full Jest suite passes (41 suites, 636 tests); client and SSR webpack builds pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01G4XFnHB38fPvuMVpc35cMd