Changelog

bun add @antikythera/antikythera@latest
# If Bun is unavailable:
pnpm add @antikythera/antikythera@latest

v2.1.0 (24.08.2026)

Sanity and API

• added publish-time pagination route ledgers, guarded publication sequencing, and a dry-run-first backfill command for existing staging and production entries.
• added reusable uploaded-font documents and drag/drop font creation across supported font selectors, with WOFF2/WOFF/OTF/TTF validation, weight/style metadata, and dataset-scoped live refreshes.
• returned normalized fonts metadata and generated fontFaceCss from the settings and full-entry endpoints; the package installs the CSS once at document level.
• added entry-wide tertiary hover/focus reveal and paragraph-start alignment flags, retaining the old click-reveal field as a response fallback.
• added a per-image Invert images on hover option to Sanity media carousels and exposed invertImagesOnHover: true on enabled full-entry media items.
• added Glossary Term annotations, classifier blocks, secondary text, dividers, regular links, and typed annotation references, including compatible HTML serialization.
• added GET /api/v1/annotation/:id and getAnnotation() to resolve linked annotations by slug or Sanity document ID.

Library

• made glossary annotations click-only, dismissible, recursively cross-linkable cards with keyboard-focus arrows.
• made annotation discovery resilient to client-side pagination, same-ID highlights, pre-marked content, and DOM moves while preserving active card state.
• retained smooth scroll entry/exit for regular annotation cards with intersection-based exit checks and a dismissal grace window.
• omitted glossary annotations from expanded commentary and omitted empty entry/Related Articles snap pages.
• expanded dynamic annotation, paginated glossary, mount, formatting, font, and compatibility coverage.

v2.0.5 (27.07.2026)

Fixes

• limited Export Markdown to the current entry so related article PDF cards cannot surface a Markdown download from a different article.
• reduced excess bottom spacing in the desktop About column.

v2.0.4 (23.07.2026)

Stable v2 release

• promoted the v2 redesign from release candidate to stable.
• made expanded cover delivery responsive across viewport and pixel-density changes, with decode-aware readiness shared by the preload and mounted image.
• optimized Sanity-backed expanded images and aligned PDF preview preload/display URLs.
• retried transient API failures without permanently caching rejected requests, while preserving accurate error reporting.
• fixed mobile view restoration, single-annotation scrolling, and expanded sticker clipping at tablet widths.
• kept theme inversion and the 12-column debug grid development-only, backed by checks against both production entry bundles and emitted JavaScript/CSS.
• added related-entry descriptions and Markdown assets to the full Nitro payload; the menu uses those descriptions but keeps related downloads PDF-only.

v2.0.0-beta (17.07.2026)

Major rework of the <antikythera-menu> web component and the entry API payload. The public JS API and component attributes are unchanged.

bun add @antikythera/antikythera@beta

Menu redesign

• rebuilt the minimal and summary views around a new compact sticker with the Antikythera Journal wordmark.
• replaced the Minimize/Expand/Summary nav controls with a More Info / Return to Article primary CTA.
• reworked the fullscreen view into snap-scrolled pages for the entry, Related Articles, and About.
• added an About page fed by the journal document (about text, aside text, contributors).
• added a journal description card with the short description and settings external links.

Entry files

• added a PDF preview download card and an Export Markdown button when the entry has a Markdown file.
• PDF links open in a new tab; markdown downloads use the download attribute.

Related articles

• moved related entries into a dedicated expandable Related Articles section with full article cards and an explore-all-articles button.

Annotations

• unified floating and inline annotation presentation.
• added a desktop attribution toggle ("Annotations by …") that gates annotation cards.

API

• added a top-level about object to GET /api/v1/entries/:id (journal about text, aside text, credits).
• added markdown and formatted pdfPreview fields to the entry and metadata endpoints.
• related entries now include their own pdf and pdfPreview.

Mobile & theming

• sticky section headers, summary folding on article scroll, and improved expanded-layout resizing.
• theme-aware stroke and gray CSS variables; base font size increased to 14px.
• debug keyboard shortcuts: i inverts theme colors, g toggles a layout grid overlay.

v1.5.2 (20.05.2026)

Improvements

• PostHog telemetry improvements.

v1.5.1 (19.05.2026)

Improvements

• added Sanity fields for API background and foreground color overrides.
• returned apiBackgroundColor and apiForegroundColor from the Nitro entry and metadata endpoints.
• added api-background-color and api-foreground-color component attributes for <antikythera-menu> and <antikythera-footer>.
• moved menu and footer theming to shared CSS variables so text, icons, borders, muted text, and overlays inherit the same API color palette.
• normalized plain hex color values and ignored unsafe or invalid CSS color inputs.

v1.5.0 (14.05.2026)

Analytics

• added PostHog browser and Nitro API telemetry.
• defaulted browser analytics to persistent anonymous mode with sanitized URLs and constrained autocapture.
• added PostHog tracing headers so browser pageviews and Nitro API events share stable anonymous distinct IDs and $session_id values.
• added full tracking mode and the ?telemetry debug flag.
• added richer product event properties for annotations, links, sections, downloads, and host domains.

Bug Fixes

• fixed flickering on sticker init with fade-in.
• fixed ReferenceError: withoutSticker call.
• changed folded annotation titles to use safe id lookup and getBoundingClientRect() instead of offsetTop.
• fixed the CommonJS package export path for require().
• guarded custom element registration so repeated Antikythera constructors do not throw.
• removed stray console logs.

Improvements

• Added optional runtime API host override via apiUrl.
• Added support for api-url on <antikythera-menu> and <antikythera-footer>.
• Added API URL normalization and validation; invalid overrides are ignored with a warning.
• Added default API fallback to https://api.antikythera.org.
• Included API host in request memoization cache keys to avoid cross-host cache collisions.
• Added package version logging on Antikythera initialization.
• Improved annotation scanning safety when annotation API responses are missing or malformed.

v1.3.8 (05.05.2025)

Minor fixes:

• force hide antikythera-footer if no annotations && no credits.
• removal of max-view annotation truncation.
• improved removal of annotations after scrolling out of view.
• improved loading transitions for mid titles.

v1.3.7 (03.05.2025)

Minor bug fixes to max view — tablet.

v1.3.6 (03.05.2025)

Minor bug fixes to max view — mobile.

v1.3.5 (01.05.2025)

Minor Version, adjustments to DOI loading, converting and to &.

v1.3.4 (30.04.2025)

Minor Version, small optional footer spacing adjustments.

v1.3.1 (29.04.2025)

Major Version release with bug fixes, updated styling and movement, released for production.

v1.3.0-beta.18 (24-29.04.2025)

Beta of Major Version release with bug fixes, updated styling and movement.

bun add @antikythera/antikythera@beta

v1.2.0 (18.02.2025)

Minor Version release with dynamic article text scanning for Annotation injection and textStyle updates.

v1.1.0 (31.01.2025)

Minor Version release with new tablet breakpoint and adjusted top / left margin spacing.

v1.0.4 (07.11.2024)

Patch release fixing multiple contributor list logic.

v1.0.3 (24.10.2024)

Patch release to inset the sticker slightly on larger screen sizes (1.5rem). Mobile remails at .5rem.

v1.0.2 (22.10.2024)

Patch release to keep 3 lines reserved to avoid jump in card.

v1.0.1 (22.10.2024)

Patch release for expanded mobile font-size scaling for large monitors.

v1.0.0 (21.10.2024)

Production-ready release 🎉.

• updated font loading due to web component @font-face constraints in Chrome and Firefox.