Particle Library 0.2.3

Particle Library 0.2.3 (build 21).

What’s new

• Trend charts now treat PDG Average and PDG Fit as separate selectable series. Measurements such as S033R1 no longer collapse to the three editions that happened to publish only one value.
• Tap or click a trend point to inspect that edition’s value; tapping outside the chart clears the selection. The tooltip works on touch devices, not only on hover.
• The trend value list is newest-first, and the current-edition badge is shortened to Current so the value fits on a phone.
• Includes the 0.2.2 catalog quantum numbers, PDG status marks, inline pdgLive links, PDF search shortcuts and engine updates.

Assets

• macOS 12+ universal: DMG or ZIP. Ad-hoc signed and not notarized; if Gatekeeper blocks the first launch, right-click → Open or use System Settings → Privacy & Security → Open Anyway.
• Android 7.0+ (API 24): arm64-v8a APK, signed with the existing 0.2.x release key.
• SHA256SUMS.txt covers all three binaries.

Particle Library 0.2.2

Particle Library 0.2.2 (build 20).

Highlights

• Catalog entries now show PDG quantum numbers (J^{PC}, I, G, C) and PDG Live status marks.
• pdgLive summaries link reviews and “See also” particles inline, without duplicate chips.
• Catalog rows use one trailing affordance: expand/collapse for rows with children, a details chevron for leaf rows.
• PDF search supports the usual keyboard shortcuts: Cmd/Ctrl+F, Cmd/Ctrl+G, Shift+Cmd/Ctrl+G, F3, Shift+F3, Enter, Shift+Enter, and Esc. The macOS native Find menu is forwarded to the reader.
• Updated PDF and SQLite engines (pdfrx 2.11, sqlite3 3.8).
• Fixed the blank catalog during scrolling and the page-number dialog lifecycle crash.

Assets

• macOS 12+ universal: DMG or ZIP. Ad-hoc signed and not notarized; if Gatekeeper blocks the first launch, right-click → Open or use System Settings → Privacy & Security → Open Anyway.
• Android 7.0+ (API 24): arm64-v8a APK, signed with the existing 0.2.x release key.
• SHA256SUMS.txt covers all three binaries.

Particle Library 0.2.1

Particle Library 0.2.1

Offline full-text search across the PDG Review PDFs, plus a more reliable review download experience.

Highlights

• Search the PDG Reviews: a new Reviews scope searches the text of all 121 PDG Review PDFs (2,163 pages).
  • CG coefficients opens the Clebsch-Gordan review at page 1.
  • hadronic cross sections opens Plots of Cross Sections and Related Quantities at page 5 (Figure 53.2).
  • average hadron multiplicities opens the same review at page 2 (Table 53.1).
  • Results show the review, physical PDF page, section heading and table/figure caption.
• Persistent download progress: opening an uncached review now shows a progress dialog with received/total size and percentage; it no longer disappears before the download finishes.
• Version consistency: the runtime version is generated from pubspec.yaml; About and update checks now report the actual build version.

Downloads

• Particle-Library-0.2.1-macOS-universal.dmg — macOS 12+ universal
• Particle-Library-0.2.1-macOS-universal.zip — portable app bundle
• Particle-Library-0.2.1-Android-arm64-v8a.apk — Android 7.0+ arm64
• SHA256SUMS.txt — checksums for all assets

The macOS build is ad-hoc signed and not notarized; Gatekeeper may show a warning. The Android APK is signed with the existing release key.

iOS 0.2.1 (19) is available through TestFlight.

Notes

• Review search works offline after the bundled index is installed; the first review search copies a ~15 MB text index into the app data directory. Review PDFs remain download-on-demand.
• The CG coefficient tables are vector outlines; their individual coefficients, formula internals and text inside figures are not searchable.
• Review text is English; the surrounding UI remains Chinese/English.
• PDG 2026 content is used under CC BY 4.0 with attribution. This is an independent app, not an official PDG product.
• Export a full backup before reinstalling; normal app updates preserve local notes, favorites and settings.

Checksums

See SHA256SUMS.txt in the assets.

Particle Library 0.2.0

Particle Library 0.2.0

Reader

• Reopening a review restores the saved page and the position within the page
  (works with both Fit width and Fit page).
• One sidebar for Annotations, Contents and Notes, docked, as a drawer or as a
  sheet depending on the window size.
• Back to the previous reading position after an outline or highlight jump.
• Notes split view beside the PDF; a non-modal, draggable PDG lookup window
  whose results open inside the panel.
• Related reviews for each particle, in-PDF text search and annotation tools.

Notes

• Entity notes with anchors, collections, tags and Markdown preview.
• PDF text highlights and region annotations; capture a value or a region into
  a note without losing the text being edited.
• Write notes inside the reader sidebar; appended content is merged, never
  overwritten by a later autosave.

Search

• INSPIRE search with a zotero-inspire style history (inline completion, list
  on click) and a syntax-help sidebar.

Data

• pdgLive was: lines, summaries and citation links shipped as an offline
  patch; related reviews per particle.
• Complex poles are shown in full; limits, ranges and exponents follow the
  stored value fields, with a whole-snapshot display-fidelity test.

Android: new signing key

0.2.0 is signed with a new key, so Android will not install it over 0.1.x.

Before updating: in 0.1.x open Settings → Data → Export full backup.
Then uninstall the old app, install 0.2.0 and import that backup. Android
auto-backup is off, so uninstalling without a backup deletes the local notes.

Only arm64-v8a is built now; 32-bit devices are no longer supported.

macOS

Ad-hoc signed and not notarized. Verify SHA256SUMS.txt; if Gatekeeper blocks
the first launch, use right-click → Open.

iOS/iPadOS

Distributed through the public TestFlight beta (the link is in the README).

Particle Library 0.1.3

Particle Library 0.1.3

Update for macOS and Android. The macOS preview remains ad-hoc signed and is
not notarized.

Navigation

• A persistent top bar now provides Back and Forward across each tab's
  own navigation stack; switching tabs preserves where you were.
• In the Search split view, the detail pane keeps its own history. Back follows
  the topmost visible stack, and Forward restores the stack that last lost a
  page.
• Settings now returns to the page that opened it, including a detail page
  or a page already open in another tab.
• Keyboard shortcuts: ⌘[ / ⌘] on macOS, Alt+← / Alt+→ elsewhere.
  Android/iOS system back is routed through the same stacks.
• Page-level duplicate back arrows were removed for tab pages; the persistent
  top bar is the single navigation control.
• The PDF viewer is immersive on phones: while a review PDF is the top
  route, the global top bar and bottom navigation are hidden, and the viewer
  gets its own compact toolbar with a single overflow menu. A note editor
  opened above the PDF restores the global bar automatically.
• Removed the duplicate status-bar inset that previously pushed the PDF
  toolbar below the global bar.
• Smaller mobile chrome: the compact top bar is 48 px and the bottom
  navigation uses a compact custom bar with no dead space above the icons.
  The bar height follows the system text size (52 px at default, growing
  with larger type). It stays visible on ordinary detail pages and hides only
  while the keyboard is open or a full-screen PDF/Notes editor is active.
• Notes keyboard fix: nested Scaffolds no longer subtract the keyboard
  inset twice, so the note title/body fields stay visible above the keyboard.
• Single Notes header: on compact screens the note editor hides the global
  top bar and uses its own AppBar with back and home actions, removing the
  duplicate header above the title/body fields.
• Summary cards use compact PDG Average / PDG Fit labels and no longer
  repeat the PDG OUR AVERAGE / OUR FIT indicator, so the summary-type chip
  no longer overflows on phones.

Zotero

• Added one-click Add to Zotero for INSPIRE records and PDG reference
  records through zotero-inspire 4.1.0's own save-target picker.
• The app brings Zotero forward for the picker and returns to Particle Library
  after the picker closes.
• Clear setup guidance when Zotero is running but zotero-inspire is missing or
  too old: the exact status is shown in Settings, with an install/update action;
  clicking Zotero at a reference opens an actionable dialog instead of silently
  copying BibTeX.
• The Zotero item cache now lives inside the Zotero integration card, and its
  automatic-update switch starts enabled.
• The Zotero mark is a quiet, theme-aware Z chip rather than a heavy solid
  brand block.

Math and reference titles

• Descriptive titles such as pi ELECTRIC POLARIZABILITY alpha(pi) are no
  longer mistaken for one giant particle subscript.
• Reverse-related measurement formulas now typeset ABS(...) as absolute
  value, Gamma/G as Γ, delta**K as δ^K, numeric coefficients such as
  2pi+, and compact labels such as K*(892)-, K0S, D_10 and D_20.
• PDG compact star/charge forms (D^**0, D^(*)+) are supported in reference
  titles.
• Snapshot titles that end mid-sentence (for example Dalitz Plot Analysis of)
  are completed once from Crossref when possible and cached locally; offline
  they are shown with an explicit ellipsis.
• Reference titles with MathML/JATS markup continue to be cleaned and
  typeset without leaking tags.

UI and fixes

• DOI and INSPIRE actions are now labelled simply DOI and INSPIRE;
  full explanations remain in their tooltips.
• The duplicate Zotero button in the reference action row was removed; the
  top-right Z button is the single entry point.
• Settings shows the installed app version next to Check for updates.
• The reviews page opened from a particle/category no longer pre-fills its
  search box with a related query; category PDF filtering still works.
• Fixed tab-local history after opening global pages, and made Settings return
  to the exact previous page.

Verification

• flutter analyze: clean
• flutter test: 225 passed
• macOS release app built, ad-hoc signed and launched
• Android arm64-v8a and armeabi-v7a release APKs built

Known limitations

• macOS preview is not notarized; first launch may require the documented
  Gatekeeper bypass.
• iOS App Store distribution still requires a paid Apple Developer team.
• Android API 24 and 32-bit devices are not device-tested in this release.

macOS build 14

• Keyboard shortcuts are now configurable in Settings → Keyboard shortcuts:
  record a new combination, disable a command, reset one command, or reset all.
• Defaults preserve the original keys (⌘1–3, ⌘,, ⌘N, ⌘[, ⌘]); conflicting
  combinations are rejected.
• The shortcut editor is macOS-only and uses two columns on wide windows.
• The compact top-bar overflow menu is pinned to the right edge.
• This macOS-only rebuild keeps iOS build 13 unchanged.

Particle Library 0.1.2

Particle Library 0.1.2

Free preview update for macOS and Android. There are no in-app purchases.

New and improved

• Mobile export works — JSON notes, Markdown notes and full ZIP backups open
  the Android/iOS system share sheet. Import works on all platforms.
• Full backup import auto-detects ZIP or JSON, validates the backup version
  and merges notes without deleting current data.
• Capture safety — pressing Enter in the capture search no longer appends to
  the first unrelated note.
• Cleaner search results — global note hits use the current UI language and
  the same title/fallback rules as the Notes page.
• MathML title search — cleaned reference titles are searched when raw SQL
  cannot match text split across MathML nodes.
• Full catalog everywhere — desktop top bar and compact overflow menu.
• iOS App Store update mode — iOS builds never link to GitHub for updates;
  Settings reports that the App Store delivers updates.

Fixed

• Highlight anchor removal persists; saved highlight ranges no longer clobber
  custom titles.
• Tapping a highlight opens its range handles directly; range save has error
  handling, desktop handles are enabled, and deletion asks for confirmation.
• Review anchor chips open the correct PDF page.
• Nested K_{\ell4} scripts, PDG Live-style multi-quark subscript spacing,
  quote-bearing default titles and incoming note-to-note backlinks are fixed.
• Spaced exotic-particle names stay whole; prose suffixes are not swallowed;
  neutral charge-zero shorthand is a superscript; ~ masses, decay
  multiplicities and text-only arrow tokens render correctly.
• Reference titles strip MathML/JATS markup safely, including pretty-printed
  MathML and literal comparison signs.
• No in-app purchases or Android Billing permission.

Archive DOI

• Concept DOI (latest): 10.5281/zenodo.23460981
• This version (0.1.2): 10.5281/zenodo.23464237

Verification

• flutter test: 199 passed
• flutter analyze: clean
• CI: GitHub Actions analyze/test jobs pass.
• iOS Release compiles with --no-codesign.
• Android arm64-v8a APK tested on a physical device; API 24 and armeabi-v7a
  are built but not device-tested here.
• macOS preview is ad-hoc signed and not notarized.

Known limitations

• iOS App Store distribution still needs a paid Apple Developer team and
  TestFlight/App Review.
• Android API 24 and 32-bit devices are not device-tested here.
• Very large full backups depend on available device storage.

Particle Library 0.1.1

Particle Library 0.1.1

Follow-up preview for macOS and Android.

New

• Full backup / import — one ZIP with settings, favorites, notes, highlight
  anchors and cached review PDFs. Import auto-detects the backup, merges notes
  without deleting current data, and preserves the Apple Supporter entitlement.
  Export is available on desktop; mobile builds can import.
• Full catalog everywhere — the catalog is reachable from every primary tab
  (top bar on desktop, overflow menu on compact layouts).
• Apple-only Supporter UI — a $0.99 non-consumable supporter badge prepared
  for App Store builds. It is hidden on Android and in the ad-hoc macOS build
  until an App Store product exists. Core features stay free.
• Editable highlight ranges — tapping a highlight selects it and exposes
  the two drag handles directly; save with the check button. Renamed highlight
  titles survive range edits.
• Better update checks — jsDelivr/raw GitHub manifest fallback for networks
  where the GitHub API is blocked, with update.json as the release manifest.

Fixed

• Spaced exotic-particle descriptions such as T_c c cbar cbar(6600) stay one
  math unit; prose suffixes such as MASS/MEAN LIFE are no longer swallowed
  into subscripts.
• Neutral charge-zero shorthand (B_s0, Xi_c0, Lambda_b0, …) renders as a
  superscript, consistent with particle-symbol rendering.
• Reference titles clean JATS/MathML/MathML-namespaced markup, including
  pretty-printed MathML, square roots, fractions and superscripts; literal
  comparison signs such as <sqrt(s)< are preserved.
• Approximate masses use \sim; decay multiplicities no longer gain a comma;
  text-only decay tokens containing arrows are preserved.
• PDF highlight notes use the human review title in generated titles and bodies;
  comment/range edits no longer revert to the PDF filename.
• Anchor removal is persisted immediately and on close.
• Deleting a highlight asks for confirmation; desktop selection handles are
  enabled.
• Full catalog entry, title clamping/identifier-first defaults and several
  reference-title surfaces no longer show raw MathML/HTML.
• Android manifest no longer requests the Billing permission (Supporter is
  Apple-only).

Verification

• flutter test: 198 tests passed
• flutter analyze: clean
• macOS DMG/ZIP rebuilt from this tag; Android arm64-v8a and armeabi-v7a APKs
  rebuilt with the same snapshot.

Known limitations

• macOS preview is ad-hoc signed, not notarized.
• iOS is development-signed only; App Store distribution needs a paid Apple
  Developer team and a configured Supporter product.
• Android API 24 and 32-bit devices are built but not device-tested in this
  release.
• Full-backup export requires the desktop file picker; mobile can import.
• Supporter purchase is hidden until the App Store Connect product exists.

Particle Library 0.1.0

Particle Library 0.1.0

Particle Library is an offline app for the Particle Data Group Review of
Particle Physics, with notes, references, PDF reviews and annotations.

This is the first public source, macOS and Android preview release.

Downloads

All assets show their exact filenames on GitHub; no custom labels are used.

• Particle-Library-0.1.0-macOS-universal.dmg — macOS installer (recommended).
• Particle-Library-0.1.0-macOS-universal.zip — macOS app archive.
• Particle-Library-0.1.0-Android-arm64-v8a.apk — recommended for modern Android phones.
• Particle-Library-0.1.0-Android-armeabi-v7a.apk — older 32-bit Android devices.
• SHA256SUMS.txt — verify every download before running it.

Android APKs require Android 7.0+ (API 24). Enable installation from the browser
or file manager you use, then open the APK. The package id is
io.github.fkguo.particlelibrary.

The macOS app is ad-hoc signed, not Developer ID signed or notarized. On
first launch, right-click → Open, or approve it in System Settings → Privacy &
Security.

PDG data

The app bundles the PDG 2026 snapshot. Source builders can download the
authoritative file from the official PDG API page:

https://pdg.lbl.gov/2026/api/index.html

It is not redistributed in this release.

Platform status

• macOS: universal arm64 + x86_64; built and manually tested.
• Android: two signed release APKs (arm64-v8a for modern phones, armeabi-v7a
  for older 32-bit phones); the arm64 release was installed and launched on an
  Android 15 emulator, with offline search and math rendering checked.
• iPhone/iPad: source and development-signed builds are tested; there is no
  public IPA/TestFlight build in this release.
• Windows/Linux/web: not built.

Known limitations

• macOS is unsigned/not notarized.
• Android is a preview APK, not a Google Play release; no Play Store listing.
• iOS public distribution needs a paid Apple Developer team.
• Android signing key is local and must be backed up; future APKs need the same
  key for in-place updates.

Verification

• flutter analyze clean.
• 187 tests passing locally with the PDG 2026 snapshot.
• macOS: codesign --verify --deep --strict passed.
• Android: APK signature verified; package id and app label checked on the
  emulator.
• Second macOS launch activates the existing window and exits.

Built over a weekend using DeepSeek Harness and DeepSeek-V4.1-Flash-1017.