@zinejs/core 0.7.4 → 0.8.2

package/dist/styles-B8fFoYm_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-B8fFoYm_.js","names":[],"sources":["../src/controls/icons.ts","../src/controls/styles.ts"],"sourcesContent":["/**\n * Toolbar glyphs, inlined so the bundle carries no icon-font or sprite dependency.\n *\n * Paths are from Lucide (https://lucide.dev), ISC licensed:\n *   Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part of Feather\n *   (MIT). All other copyright (c) for Lucide are held by Lucide Contributors 2022.\n *\n * Each value is the inner markup of a 24x24 `viewBox` drawn with `stroke=\"currentColor\"`,\n * `fill=\"none\"` and round caps/joins — {@link createIcon} supplies those, so the strings stay to\n * the geometry.\n */\n// Not annotated `Record<string, string>`: that would make every ICONS.foo possibly-undefined\n// under noUncheckedIndexedAccess, even for names written right here. `satisfies` keeps the\n// literal's exact keys while still checking the values are markup strings.\nexport const ICONS = {\n  /** chevron-left */\n  prev: '<path d=\"m15 18-6-6 6-6\"/>',\n  /** chevron-right */\n  next: '<path d=\"m9 18 6-6-6-6\"/>',\n  /** chevrons-left */\n  first: '<path d=\"m11 17-5-5 5-5\"/><path d=\"m18 17-5-5 5-5\"/>',\n  /** chevrons-right */\n  last: '<path d=\"m6 17 5-5-5-5\"/><path d=\"m13 17 5-5-5-5\"/>',\n  /** zoom-in */\n  zoomIn:\n    '<circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/><path d=\"M11 8v6\"/><path d=\"M8 11h6\"/>',\n  /** zoom-out */\n  zoomOut: '<circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/><path d=\"M8 11h6\"/>',\n  /** search */\n  search: '<circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/>',\n  /** share-2 */\n  share:\n    '<circle cx=\"18\" cy=\"5\" r=\"3\"/><circle cx=\"6\" cy=\"12\" r=\"3\"/><circle cx=\"18\" cy=\"19\" r=\"3\"/><path d=\"m8.6 13.5 6.8 4\"/><path d=\"m15.4 6.5-6.8 4\"/>',\n  /** ellipsis-vertical */\n  menu: '<circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"12\" cy=\"5\" r=\"1\"/><circle cx=\"12\" cy=\"19\" r=\"1\"/>',\n  /** maximize */\n  fullscreen:\n    '<path d=\"M8 3H5a2 2 0 0 0-2 2v3\"/><path d=\"M21 8V5a2 2 0 0 0-2-2h-3\"/><path d=\"M3 16v3a2 2 0 0 0 2 2h3\"/><path d=\"M16 21h3a2 2 0 0 0 2-2v-3\"/>',\n  /** minimize */\n  exitFullscreen:\n    '<path d=\"M8 3v3a2 2 0 0 1-2 2H3\"/><path d=\"M21 8h-3a2 2 0 0 1-2-2V3\"/><path d=\"M3 16h3a2 2 0 0 1 2 2v3\"/><path d=\"M16 21v-3a2 2 0 0 1 2-2h3\"/>',\n  /** gallery-vertical-end */\n  thumbnails:\n    '<path d=\"M7 2h10\"/><path d=\"M5 6h14\"/><rect width=\"18\" height=\"12\" x=\"3\" y=\"10\" rx=\"2\"/>',\n  /** list-tree */\n  outline:\n    '<path d=\"M21 12h-8\"/><path d=\"M21 6h-8\"/><path d=\"M21 18h-8\"/><path d=\"M3 6v4c0 1.1.9 2 2 2h3\"/><path d=\"M3 10v6c0 1.1.9 2 2 2h3\"/>',\n  /** book-open: two facing pages */\n  twoPages:\n    '<path d=\"M12 7v14\"/><path d=\"M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z\"/>',\n  /** file: a single page */\n  onePage: '<path d=\"M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z\"/><path d=\"M14 2v5h6\"/>',\n  /** printer */\n  print:\n    '<path d=\"M6 9V2h12v7\"/><path d=\"M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2\"/><rect width=\"12\" height=\"8\" x=\"6\" y=\"14\" rx=\"1\"/>',\n  /** download */\n  download: '<path d=\"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4\"/><path d=\"M7 10l5 5 5-5\"/><path d=\"M12 15V3\"/>',\n  /** x */\n  close: '<path d=\"M18 6 6 18\"/><path d=\"m6 6 12 12\"/>',\n} satisfies Record<string, string>;\n\n/** Build an `<svg>` for one of the {@link ICONS}, or null if the name is unknown. */\nexport function createIcon(doc: Document, markup: string): SVGSVGElement {\n  const svg = doc.createElementNS('http://www.w3.org/2000/svg', 'svg');\n  svg.setAttribute('viewBox', '0 0 24 24');\n  svg.setAttribute('fill', 'none');\n  svg.setAttribute('stroke', 'currentColor');\n  // Slightly under Lucide's default 2: at the toolbar's icon size a full-weight stroke reads\n  // heavy and closes up the tighter shapes.\n  svg.setAttribute('stroke-width', '1.75');\n  svg.setAttribute('stroke-linecap', 'round');\n  svg.setAttribute('stroke-linejoin', 'round');\n  svg.setAttribute('aria-hidden', 'true');\n  svg.setAttribute('focusable', 'false');\n  // Icon markup is library-authored, never consumer input.\n  svg.innerHTML = markup;\n  return svg;\n}\n","/**\n * The toolbar's stylesheet, injected once per document.\n *\n * The rest of the library styles elements inline, but a toolbar needs `:hover`, `:focus-visible`\n * and `:disabled` — states inline styles cannot express — so this is the one place a `<style>`\n * element is warranted. Everything is scoped under `.zine-controls`.\n *\n * Colours come from custom properties so a consumer can retheme without overriding rules. Left\n * unset, each falls back to `light-dark(light, dark)`, which resolves against the element's used\n * `color-scheme`: the toolbar follows the host page's scheme with no configuration, and a host\n * with a theme toggle only has to set `color-scheme` on its root for the controls to match. The\n * `colorScheme` control option can force `light` or `dark` regardless of the page, and a set\n * `--zine-controls-*` token still wins over both.\n */\nconst STYLE_ID = 'zine-controls-style';\n\nexport const CSS = `\n/* Docked mode wraps the book so the bar can sit beside it without shrinking the container,\n   whose measured box the renderer and hit-testing both depend on.\n   The wrapper deliberately does not stretch or grow its children: the container keeps whatever\n   width, aspect-ratio and auto-margins the consumer's own CSS gave it. */\n.zine-controls-wrap { display: flex; }\n/* Stacked: children keep their own width (so a percentage or auto-margin still resolves against\n   the wrapper) and take only the height they ask for. */\n.zine-controls-wrap-top,\n.zine-controls-wrap-bottom { flex-direction: column; align-items: stretch; }\n/* Side by side: the bar is only as wide as its buttons, and both are vertically centred. */\n.zine-controls-wrap-left,\n.zine-controls-wrap-right { flex-direction: row; align-items: center; }\n/* min-height:0 matters as much as min-width here. A flex item's automatic minimum size floors it\n   at its content, so once the canvas has grown for a taller layout the book cannot shrink back —\n   its aspect-ratio is restored but ignored, leaving the extra height behind. */\n.zine-controls-wrap > * { flex: 0 0 auto; min-width: 0; min-height: 0; }\n\n.zine-controls {\n  position: relative;\n  display: flex;\n  gap: 4px;\n  padding: 5px;\n  z-index: 2;\n  box-sizing: border-box;\n  font: 500 12px/1.2 system-ui, sans-serif;\n  color: var(--zine-controls-fg, light-dark(#18181b, #f4f4f5));\n  touch-action: auto;\n  -webkit-user-select: none;\n  user-select: none;\n}\n.zine-controls-docked { flex: 0 0 auto; justify-content: center; align-items: center; }\n.zine-controls-floating {\n  position: absolute;\n  /* Transparent to the book except on the buttons themselves, so gaps stay draggable. */\n  pointer-events: none;\n}\n.zine-controls-bar {\n  display: flex;\n  align-items: center;\n  gap: 1px;\n  padding: 3px;\n  border-radius: 8px;\n  pointer-events: auto;\n  background: var(--zine-controls-bg, light-dark(rgba(255, 255, 255, 0.94), rgba(24, 24, 27, 0.82)));\n  backdrop-filter: blur(8px);\n}\n/* Floating: lifted off the page it covers. Docked: flat, with an outline so it reads as a\n   control strip rather than a shadow hanging in empty space. */\n.zine-controls-floating .zine-controls-bar { box-shadow: 0 2px 12px rgba(0, 0, 0, 0.28); }\n.zine-controls-docked .zine-controls-bar {\n  border: 1px solid var(--zine-controls-hover, light-dark(rgba(0, 0, 0, 0.08), rgba(255, 255, 255, 0.14)));\n}\n.zine-controls-floating.zine-controls-bottom { inset: auto 0 0 0; justify-content: center; }\n.zine-controls-floating.zine-controls-top    { inset: 0 0 auto 0; justify-content: center; }\n.zine-controls-floating.zine-controls-left   { inset: 0 auto 0 0; align-items: center; }\n.zine-controls-floating.zine-controls-right  { inset: 0 0 0 auto; align-items: center; }\n/* A bar on a vertical edge stacks its buttons, docked or floating. */\n.zine-controls-left .zine-controls-bar,\n.zine-controls-right .zine-controls-bar { flex-direction: column; }\n\n.zine-controls-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 26px;\n  height: 26px;\n  padding: 0;\n  border: 0;\n  border-radius: 6px;\n  background: transparent;\n  color: inherit;\n  cursor: pointer;\n  font: inherit;\n}\n.zine-controls-btn svg { width: 15px; height: 15px; }\n.zine-controls-btn:hover:not(:disabled) { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14))); }\n.zine-controls-btn:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: 1px;\n}\n.zine-controls-btn:disabled { opacity: 0.38; cursor: default; }\n/* A button mid-slow-action (fetching a file to save or print): a spinner, kept full-strength\n   rather than dimmed so it reads as \"working\", not \"disabled\". */\n.zine-controls-btn.zine-controls-busy { opacity: 1; cursor: default; position: relative; }\n.zine-controls-btn.zine-controls-busy::after {\n  content: '';\n  box-sizing: border-box;\n  width: 14px;\n  height: 14px;\n  border: 2px solid currentColor;\n  border-top-color: transparent;\n  border-radius: 50%;\n  opacity: 0.7;\n  animation: zine-controls-spin 0.7s linear infinite;\n}\n/* Icon-only bar button: hide the glyph and center the spinner over its place. */\n.zine-controls-btn.zine-controls-busy > svg { visibility: hidden; }\n.zine-controls-btn.zine-controls-busy::after {\n  position: absolute;\n  top: 50%;\n  left: 50%;\n  margin: -7px 0 0 -7px;\n}\n/* Menu item (glyph + label): let the glyph and label stand, and trail the spinner after them. */\n.zine-controls-menu .zine-controls-btn.zine-controls-busy > svg { visibility: visible; }\n.zine-controls-menu .zine-controls-btn.zine-controls-busy::after { position: static; }\n@keyframes zine-controls-spin { to { transform: rotate(360deg); } }\n@media (prefers-reduced-motion: reduce) {\n  .zine-controls-btn.zine-controls-busy::after { animation-duration: 1.6s; }\n}\n/* A custom widget cannot always be disabled itself, so it is marked instead and reads the same. */\n.zine-controls-off { opacity: 0.38; }\n.zine-controls-off[aria-disabled='true'] { pointer-events: none; }\n.zine-controls-btn[aria-pressed=\"true\"],\n.zine-controls-btn[aria-expanded=\"true\"] { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14))); }\n\n.zine-controls-sep {\n  width: 1px;\n  align-self: stretch;\n  margin: 3px 3px;\n  background: currentColor;\n  opacity: 0.22;\n}\n.zine-controls-left .zine-controls-sep,\n.zine-controls-right .zine-controls-sep { width: auto; height: 1px; margin: 3px 3px; }\n\n.zine-controls-page {\n  display: inline-flex;\n  align-items: center;\n  gap: 3px;\n  padding: 0 3px;\n  pointer-events: auto;\n  white-space: nowrap;\n}\n.zine-controls-page input {\n  width: 2.2em;\n  padding: 2px 3px;\n  border: 1px solid var(--zine-controls-hover, light-dark(rgba(0,0,0,0.14), rgba(255,255,255,0.2)));\n  border-radius: 4px;\n  background: light-dark(rgba(0, 0, 0, 0.05), rgba(0, 0, 0, 0.25));\n  color: inherit;\n  font: inherit;\n  text-align: center;\n  -moz-appearance: textfield;\n}\n.zine-controls-page input::-webkit-outer-spin-button,\n.zine-controls-page input::-webkit-inner-spin-button { -webkit-appearance: none; margin: 0; }\n.zine-controls-page input:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: 0;\n}\n\n.zine-controls-menu {\n  position: absolute;\n  display: flex;\n  flex-direction: column;\n  gap: 1px;\n  min-width: 152px;\n  padding: 4px;\n  border-radius: 8px;\n  pointer-events: auto;\n  background: var(--zine-controls-bg, light-dark(rgba(255, 255, 255, 0.94), rgba(24, 24, 27, 0.94)));\n  box-shadow: 0 6px 22px rgba(0, 0, 0, 0.36);\n  backdrop-filter: blur(8px);\n}\n.zine-controls-menu .zine-controls-btn {\n  width: 100%;\n  height: auto;\n  gap: 8px;\n  padding: 6px 8px;\n  justify-content: flex-start;\n}\n\n/* Search shares the rail: a query field pinned at the top over a scrolling list of hits. */\n.zine-search { gap: 0; overflow: hidden; }\n.zine-search-input {\n  flex: 0 0 auto;\n  width: 100%;\n  padding: 6px 8px;\n  border: 1px solid var(--zine-controls-hover, light-dark(rgba(0,0,0,0.14), rgba(255,255,255,0.2)));\n  border-radius: 6px;\n  background: light-dark(rgba(0, 0, 0, 0.05), rgba(0, 0, 0, 0.25));\n  color: inherit;\n  font: inherit;\n  box-sizing: border-box;\n}\n/* Replace the browser's default (white) focus ring with the accent ring the other controls use. */\n.zine-search-input:focus-visible {\n  outline: none;\n  border-color: var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  box-shadow: 0 0 0 1px var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n}\n.zine-search-hits {\n  flex: 1 1 auto;\n  overflow-y: auto;\n  /* Chain overscroll up to the page: once the list is at its end (or too short to scroll at all),\n     a further wheel scrolls the page behind, the same as scrolling over the book itself does. */\n  overscroll-behavior: auto;\n  margin-top: 5px;\n  scrollbar-width: thin;\n}\n.zine-search-hit {\n  display: block;\n  width: 100%;\n  padding: 6px 8px;\n  border: 0;\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n  box-sizing: border-box;\n}\n.zine-search-hit:hover { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14))); }\n.zine-search-hit:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: -2px;\n}\n.zine-search-page { display: block; font-size: 0.9em; opacity: 0.85; }\n.zine-search-hit small {\n  display: block;\n  margin-top: 2px;\n  opacity: 0.62;\n  line-height: 1.35;\n  overflow-wrap: anywhere;\n}\n\n/* Page-turn arrows flanking the book. Like the docked toolbar and the side panels, they sit\n   outside the container so they never shrink the book or intercept its gestures. */\n.zine-arrows-wrap {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  min-width: 0;\n}\n.zine-arrows-wrap > *:not(.zine-arrow) { flex: 1 1 auto; min-width: 0; min-height: 0; }\n.zine-arrow {\n  flex: 0 0 auto;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 44px;\n  height: 44px;\n  padding: 0;\n  border: 0;\n  background: none;\n  /* Light on a light page, dark on a dark one. The shadow below carries the contrast. */\n  color: var(--zine-controls-fg, light-dark(#f4f4f5, #18181b));\n  cursor: pointer;\n  -webkit-user-select: none;\n  user-select: none;\n  /* No grey tap box on touch; the :active tint below is the press feedback instead. */\n  -webkit-tap-highlight-color: transparent;\n}\n.zine-arrow svg {\n  width: 36px;\n  height: 36px;\n  stroke-width: 2.25;\n  /* No backing disc, so a subtle offset shadow keeps the chevron from disappearing into a\n     matching background. It contrasts the fill: a light chevron (light mode) casts a soft dark\n     shadow, a dark chevron (dark mode) a soft light one, offset rather than a glowing halo. */\n  filter: drop-shadow(0 1px 2px light-dark(rgba(0, 0, 0, 0.5), rgba(255, 255, 255, 0.35)));\n}\n/* Feedback intensifies the chevron toward its extreme (white in light mode, black in dark)\n   rather than tinting it, so no new colour is introduced. Not tied to --zine-controls-fg: that\n   sets the resting fill, and hover has to differ from it to read as feedback. :active clears on\n   release, so tap and click feel the same; :hover is behind (hover: hover) so it never sticks on\n   touch. */\n.zine-arrow:active:not(:disabled) { color: light-dark(#ffffff, #000000); }\n@media (hover: hover) {\n  .zine-arrow:hover:not(:disabled) { color: light-dark(#ffffff, #000000); }\n}\n.zine-arrow:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: 2px;\n  border-radius: 8px;\n}\n/* Nothing to turn to: invisible, but still occupying its slot so the book does not slide across\n   as the reader reaches a cover. */\n.zine-arrow-hidden { visibility: hidden; }\n/* Device-scoped arrows (controls.arrows: 'desktop' | 'mobile'). The split follows the same 640px\n   breakpoint as the flank/overlay layouts below, so the arrows appear and disappear live as the\n   window crosses it. */\n@media (max-width: 640px) {\n  .zine-arrows-desktop > .zine-arrow { display: none; }\n}\n@media (min-width: 641px) {\n  .zine-arrows-mobile > .zine-arrow { display: none; }\n}\n/* Too narrow to flank without squeezing the pages, so overlay the arrows on the book's edges\n   instead. The wrap sits outside the container, so painting them over it leaves the container's\n   measured box (which sizes the book and maps taps) untouched. */\n@media (max-width: 640px) {\n  .zine-arrows-wrap { position: relative; }\n  .zine-arrow {\n    position: absolute;\n    top: 50%;\n    transform: translateY(-50%);\n    z-index: 2;\n    /* Sit back over the page so the reader can look at the book. */\n    opacity: 0.7;\n  }\n  .zine-arrow:first-child { left: -2px; }\n  .zine-arrow:last-child { right: -2px; }\n}\n@media (prefers-reduced-motion: no-preference) {\n  .zine-arrow { transition: background 120ms ease; }\n}\n\n/* Side panels (thumbnails, outline, search). The rail wraps the book and its docked toolbar so it\n   sits beside them as a flex sibling. On a wide screen the book shrinks to make room (below); on a\n   narrow one the rail becomes a drawer over the book.\n   align-items:flex-start, not stretch: the book sizes its height from its width through its own\n   aspect-ratio, and that height is 'auto' from flex's point of view, so a stretch would override it\n   and blow the book (and the rail matched to it) up to the flex line's cross size. Left as auto, the\n   book keeps its aspect height and the holder alone stretches down to meet it (below). */\n.zine-panel-wrap { display: flex; align-items: flex-start; gap: 8px; position: relative; }\n\n/* The book-side slot (the bare container, or the docked-toolbar wrapper around it) yields space to\n   the fixed-width rail instead of overflowing: flex-shrink lets it fall below its own width, and\n   min-width:0 removes the automatic content floor that would otherwise stop it. The book only\n   actually shrinks if its width is elastic (a %, max-width, or the demo's min(...) with a % term);\n   a hard-coded pixel width has nothing for the % to resolve smaller against. */\n.zine-panel-wrap > *:not(.zine-panel-holder):not(.zine-panel-scrim) {\n  flex: 0 1 auto;\n  min-width: 0;\n}\n/* With a docked toolbar the book lives inside .zine-controls-wrap, whose children are pinned\n   flex:0 0 auto (so the bar keeps its size). Inside a panel wrap the book child — everything but\n   the bar itself — must instead be allowed to shrink, so left/right docking flanks like the rest.\n   Top/bottom docking already shrinks through the container's own % width. */\n.zine-panel-wrap .zine-controls-wrap > *:not(.zine-controls) {\n  flex: 0 1 auto;\n  min-width: 0;\n  min-height: 0;\n}\n@media (prefers-reduced-motion: no-preference) {\n  .zine-panel-wrap > *:not(.zine-panel-holder):not(.zine-panel-scrim) {\n    transition: flex-basis 160ms ease, width 160ms ease;\n  }\n}\n\n/* The holder stretches to the book's height; the rail is absolutely positioned inside it so a\n   long list scrolls rather than growing the row and running past the bottom of the book. */\n.zine-panel-holder {\n  position: relative;\n  flex: 0 0 auto;\n  align-self: stretch;\n  min-height: 0;\n}\n/* The scrim dims the book behind the narrow-screen drawer. It exists on every screen but only\n   shows under the breakpoint below, so on a wide screen it takes no flex slot and never intercepts\n   a click. */\n.zine-panel-scrim { display: none; }\n.zine-panel {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  overflow-y: auto;\n  /* Chain overscroll up to the page: once the list is at its end (or too short to scroll at all),\n     a further wheel scrolls the page behind, the same as scrolling over the book itself does. */\n  overscroll-behavior: auto;\n  /* Reserve the scrollbar's lane whether or not it is showing, so rows never sit under the bar\n     and the close button (inset past this lane below) has a fixed edge to clear. */\n  scrollbar-gutter: stable;\n  padding: 6px;\n  box-sizing: border-box;\n  border-radius: 8px;\n  background: var(--zine-controls-bg, light-dark(rgba(255, 255, 255, 0.94), rgba(24, 24, 27, 0.82)));\n  color: var(--zine-controls-fg, light-dark(#18181b, #f4f4f5));\n  font: 500 11px/1.2 system-ui, sans-serif;\n  scrollbar-width: thin;\n  touch-action: auto;\n  -webkit-user-select: none;\n  user-select: none;\n}\n/* The rail sits flush against the book's reading-start edge (left, or right in RTL), so its outer\n   corners there would round away from that edge and leave a gap. Square them; keep the interior\n   corners, which face the page, rounded. */\n.zine-panel { border-radius: 0 8px 8px 0; }\n.zine-panel-wrap-rtl .zine-panel { border-radius: 8px 0 0 8px; }\n/* Overlay fallback, used when the container has no parent to wrap. */\n.zine-panel-overlay { position: absolute; inset: 0 auto 0 0; z-index: 3; }\n.zine-panel-active { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.18))); }\n.zine-panel-note { padding: 8px; opacity: 0.66; line-height: 1.4; }\n/* Discoverable dismiss, floated in the rail's trailing-top (interior) corner, away from the book.\n   It sits in the holder above the scrolling list so the list scrolls under it. A translucent\n   backdrop keeps the glyph legible over a thumbnail or a line of text. */\n.zine-panel-close {\n  position: absolute;\n  top: 6px;\n  /* Inset past the reserved scrollbar gutter so the button never overlaps the bar. */\n  right: 12px;\n  z-index: 1;\n  display: inline-flex;\n  width: 24px;\n  height: 24px;\n  align-items: center;\n  justify-content: center;\n  padding: 0;\n  border: 0;\n  border-radius: 6px;\n  /* Opaque so a light thumbnail underneath never shows through and dims the glyph. */\n  background: light-dark(#f4f4f5, #27272a);\n  color: inherit;\n  cursor: pointer;\n}\n.zine-panel-close svg { width: 15px; height: 15px; }\n/* Opaque hover, not the translucent hover token: a see-through backdrop over a light thumbnail\n   would wash the glyph out. Solid neutrals keep the X readable in both themes over anything. */\n.zine-panel-close:hover { background: light-dark(#e4e4e7, #3f3f46); }\n.zine-panel-close:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: -2px;\n}\n.zine-panel-wrap-rtl .zine-panel-close { right: auto; left: 12px; }\n/* End the search field just before the close button rather than running under it, so the two sit\n   side by side and the field's border reads cleanly. The button's inner edge is ~30px from the\n   panel's content edge (24px wide, its right edge 6px in once the reserved scrollbar gutter is\n   accounted for), so 30px leaves them flush with a hair of breathing room. width:auto lets the\n   column's stretch fill the rest, so the margin shortens the field instead of overflowing 100%. */\n.zine-search .zine-search-input { width: auto; align-self: stretch; margin-right: 30px; }\n.zine-panel-wrap-rtl .zine-search .zine-search-input { margin-right: 0; margin-left: 30px; }\n\n/* Overlay panels (outline, search) on a wide screen: float over the book's start edge instead of\n   flanking it, so the book never resizes. The wrap drops to a block, laying the book out exactly as\n   it was before the panel opened; the holder sits absolute over it at full book height, with a\n   shadow so it reads as lifted off the page. thumbnails is not overlaid — it stays a flex flank and\n   shrinks the book only when the two will not otherwise both fit. */\n@media (min-width: 641px) {\n  .zine-panel-wrap-overlay { display: block; }\n  .zine-panel-wrap-overlay .zine-panel-holder {\n    position: absolute;\n    inset: 0 auto 0 0;\n    z-index: 4;\n    box-shadow: 0 0 24px light-dark(rgba(0, 0, 0, 0.22), rgba(0, 0, 0, 0.55));\n  }\n  .zine-panel-wrap-overlay.zine-panel-wrap-rtl .zine-panel-holder { inset: 0 0 0 auto; }\n  /* Opaque over the page it floats on, unlike a flanking rail that sits against empty margin. */\n  .zine-panel-wrap-overlay .zine-panel {\n    background: var(--zine-controls-bg, light-dark(#ffffff, #18181b));\n  }\n  /* A click-away layer over the book, so pressing the page behind the floating rail closes it the\n     way tapping the scrim does on a narrow screen. Transparent here — the wide-screen rail only\n     covers an edge, so there is no need to dim the page the reader is still looking at. It sits\n     under the holder (z-index) so the rail's own rows still take their clicks. */\n  .zine-panel-wrap-overlay .zine-panel-scrim {\n    display: block;\n    position: absolute;\n    inset: 0;\n    z-index: 3;\n    background: transparent;\n  }\n}\n@media (min-width: 641px) and (prefers-reduced-motion: no-preference) {\n  .zine-panel-wrap-overlay .zine-panel-holder { animation: zine-drawer-in 180ms ease; }\n  .zine-panel-wrap-overlay.zine-panel-wrap-rtl .zine-panel-holder { animation-name: zine-drawer-in-rtl; }\n}\n\n/* Narrow screen: no room to flank, so the rail becomes a drawer over the book and the scrim dims\n   the page behind it. The wrap is position:relative, so the absolute holder and scrim below are\n   measured against it — i.e. against the book's own box. */\n@media (max-width: 640px) {\n  /* No flanking here — the rail and scrim both overlay absolutely — so drop the flex row entirely.\n     As a plain block wrap the book keeps the exact box it had before a panel opened (its own width,\n     margin and aspect-ratio height); a flex row would instead re-resolve the book's width and, with\n     it, its aspect-derived height, enlarging the canvas and pushing the page down. */\n  .zine-panel-wrap {\n    display: block;\n  }\n  .zine-panel-holder {\n    position: absolute;\n    inset: 0 auto 0 0;\n    z-index: 4;\n    /* Cap the drawer so it never eats the whole book; its inline width still applies under this. */\n    max-width: 80%;\n    box-shadow: 0 0 24px light-dark(rgba(0, 0, 0, 0.3), rgba(0, 0, 0, 0.6));\n  }\n  /* RTL reads from the right, so the drawer enters from there. */\n  .zine-panel-wrap-rtl .zine-panel-holder { inset: 0 0 0 auto; }\n  /* Opaque over the page, unlike the wide-screen rail which can sit against empty margin. */\n  .zine-panel {\n    background: var(--zine-controls-bg, light-dark(#ffffff, #18181b));\n  }\n  .zine-panel-scrim {\n    display: block;\n    position: absolute;\n    inset: 0;\n    z-index: 3;\n    background: rgba(0, 0, 0, 0.4);\n  }\n}\n@media (max-width: 640px) and (prefers-reduced-motion: no-preference) {\n  .zine-panel-holder { animation: zine-drawer-in 180ms ease; }\n  .zine-panel-wrap-rtl .zine-panel-holder { animation-name: zine-drawer-in-rtl; }\n  .zine-panel-scrim { animation: zine-scrim-in 180ms ease; }\n}\n@keyframes zine-drawer-in { from { transform: translateX(-100%); } to { transform: translateX(0); } }\n@keyframes zine-drawer-in-rtl { from { transform: translateX(100%); } to { transform: translateX(0); } }\n@keyframes zine-scrim-in { from { opacity: 0; } to { opacity: 1; } }\n\n.zine-thumbs { align-items: center; }\n\n.zine-thumbs-row {\n  display: flex;\n  flex-wrap: wrap;\n  justify-content: center;\n  gap: 2px;\n  width: 100%;\n  padding: 4px;\n  border: 0;\n  border-radius: 6px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  cursor: pointer;\n  box-sizing: border-box;\n}\n.zine-thumbs-row:hover { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14))); }\n.zine-thumbs-row:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: -2px;\n}\n.zine-thumbs-row.zine-panel-active .zine-thumbs-cell {\n  outline: 1px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n}\n\n/* Outline: a single column of headings, indented by depth. */\n/* No gap: a hairline between rows is the separator instead, so a title that wraps to two lines\n   still reads as one entry rather than blending into its neighbours. */\n.zine-outline { gap: 0; }\n.zine-outline-row {\n  display: block;\n  width: 100%;\n  padding: 6px 8px;\n  border: 0;\n  border-bottom: 1px solid var(--zine-controls-divider, light-dark(rgba(0, 0, 0, 0.08), rgba(255, 255, 255, 0.1)));\n  border-radius: 5px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  line-height: 1.35;\n  cursor: pointer;\n  box-sizing: border-box;\n  overflow-wrap: anywhere;\n}\n.zine-outline-row:last-child { border-bottom: 0; }\n.zine-outline-row:hover:not(:disabled) {\n  background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14)));\n}\n.zine-outline-row:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: -2px;\n}\n/* A heading whose destination could not be resolved: shown, but nothing to click through to. */\n.zine-outline-row:disabled { opacity: 0.5; cursor: default; }\n\n.zine-thumbs-cell {\n  flex: 1 1 0;\n  min-width: 0;\n  min-height: 24px;\n  display: flex;\n  background: light-dark(rgba(0, 0, 0, 0.08), rgba(0, 0, 0, 0.3));\n  border-radius: 2px;\n  overflow: hidden;\n}\n/* A lone page in a book that pairs elsewhere (a cover, a back page) keeps one page's width and\n   centres, instead of stretching across both columns. */\n.zine-thumbs-row-lone .zine-thumbs-cell { flex: 0 0 calc(50% - 1px); }\n.zine-thumbs-img { display: block; width: 100%; height: auto; }\n.zine-thumbs-caption { flex: 1 0 100%; text-align: center; opacity: 0.7; }\n\n/* Share dialog. Centred over the page rather than in the side rail: a QR and six destinations\n   need more room than the rail gives, and sharing is a brief interruption, not a browsing mode. */\n.zine-share-backdrop {\n  position: fixed;\n  inset: 0;\n  z-index: 2147483000;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 16px;\n  background: rgba(0, 0, 0, 0.55);\n  font: 500 13px/1.4 system-ui, sans-serif;\n  color: var(--zine-controls-fg, light-dark(#18181b, #f4f4f5));\n}\n.zine-share {\n  width: min(320px, 100%);\n  max-height: 100%;\n  overflow-y: auto;\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n  padding: 14px;\n  border-radius: 12px;\n  background: var(--zine-share-bg, light-dark(#ffffff, #1c1c20));\n  box-shadow: 0 18px 50px rgba(0, 0, 0, 0.45);\n  box-sizing: border-box;\n}\n.zine-share-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; }\n.zine-share-head strong { font-size: 15px; }\n.zine-share-close {\n  display: inline-flex;\n  width: 26px;\n  height: 26px;\n  align-items: center;\n  justify-content: center;\n  padding: 0;\n  border: 0;\n  border-radius: 6px;\n  background: transparent;\n  color: inherit;\n  cursor: pointer;\n}\n.zine-share-close svg { width: 16px; height: 16px; }\n.zine-share-close:hover { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.08), rgba(255,255,255,0.14))); }\n\n.zine-share-qr {\n  align-self: center;\n  line-height: 0;\n  padding: 8px;\n  border-radius: 8px;\n  background: #fff;\n}\n.zine-share-qr svg { display: block; }\n\n.zine-share-link { display: flex; gap: 6px; }\n.zine-share-link input {\n  flex: 1 1 auto;\n  min-width: 0;\n  padding: 7px 9px;\n  border: 1px solid var(--zine-controls-hover, light-dark(rgba(0,0,0,0.14), rgba(255,255,255,0.2)));\n  border-radius: 7px;\n  background: light-dark(rgba(0, 0, 0, 0.05), rgba(0, 0, 0, 0.3));\n  color: inherit;\n  font: inherit;\n}\n.zine-share-copy {\n  flex: 0 0 auto;\n  min-width: 74px;\n  padding: 7px 12px;\n  border: 0;\n  border-radius: 7px;\n  background: var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  color: light-dark(#ffffff, #06202c);\n  font: inherit;\n  font-weight: 600;\n  cursor: pointer;\n}\n\n.zine-share-socials { display: flex; flex-wrap: wrap; gap: 6px; justify-content: center; }\n.zine-share-social {\n  display: inline-flex;\n  width: 38px;\n  height: 38px;\n  align-items: center;\n  justify-content: center;\n  border-radius: 8px;\n  background: light-dark(rgba(0, 0, 0, 0.06), rgba(255, 255, 255, 0.08));\n  color: inherit;\n  text-decoration: none;\n}\n.zine-share-social svg { width: 19px; height: 19px; }\n.zine-share-social:hover { background: var(--zine-controls-hover, light-dark(rgba(0,0,0,0.12), rgba(255,255,255,0.18))); }\n.zine-share-close:focus-visible,\n.zine-share-copy:focus-visible,\n.zine-share-social:focus-visible,\n.zine-share-link input:focus-visible {\n  outline: 2px solid var(--zine-controls-accent, light-dark(#0284c7, #7dd3fc));\n  outline-offset: 2px;\n}\n\n@media (prefers-reduced-motion: no-preference) {\n  .zine-controls-btn { transition: background 120ms ease; }\n}\n`;\n\n/** Add the stylesheet to `doc` if it is not already there. */\nexport function ensureStyles(doc: Document): void {\n  if (doc.getElementById(STYLE_ID)) return;\n  const style = doc.createElement('style');\n  style.id = STYLE_ID;\n  style.textContent = CSS;\n  (doc.head ?? doc.documentElement)?.appendChild(style);\n}\n\n/**\n * Pin an element's colour scheme so the `light-dark()` fallbacks resolve to one palette.\n *\n * `'auto'` does nothing: `color-scheme` inherits, so the element keeps the page's used scheme and\n * `light-dark()` follows it. `'light'` / `'dark'` set the property on the element itself, which its\n * themed descendants (buttons, menu, dialog) inherit in turn. An unset `--zine-controls-*` reads\n * the forced palette; a set one still overrides it, since the tokens sit outside `light-dark()`.\n */\nexport function applyColorScheme(el: HTMLElement, scheme: 'light' | 'dark' | 'auto'): void {\n  if (scheme !== 'auto') el.style.colorScheme = scheme;\n}\n"],"mappings":";AAcA,IAAa,IAAQ;CAEnB,MAAM;CAEN,MAAM;CAEN,OAAO;CAEP,MAAM;CAEN,QACE;CAEF,SAAS;CAET,QAAQ;CAER,OACE;CAEF,MAAM;CAEN,YACE;CAEF,gBACE;CAEF,YACE;CAEF,SACE;CAEF,UACE;CAEF,SAAS;CAET,OACE;CAEF,UAAU;CAEV,OAAO;AACT;AAGA,SAAgB,EAAW,GAAe,GAA+B;CACvE,IAAM,IAAM,EAAI,gBAAgB,8BAA8B,KAAK;CAanE,OAZA,EAAI,aAAa,WAAW,WAAW,GACvC,EAAI,aAAa,QAAQ,MAAM,GAC/B,EAAI,aAAa,UAAU,cAAc,GAGzC,EAAI,aAAa,gBAAgB,MAAM,GACvC,EAAI,aAAa,kBAAkB,OAAO,GAC1C,EAAI,aAAa,mBAAmB,OAAO,GAC3C,EAAI,aAAa,eAAe,MAAM,GACtC,EAAI,aAAa,aAAa,OAAO,GAErC,EAAI,YAAY,GACT;AACT;;;AC/DA,IAAM,IAAW,uBAEJ,IAAM;AA2qBnB,SAAgB,EAAa,GAAqB;CAChD,IAAI,EAAI,eAAe,CAAQ,GAAG;CAClC,IAAM,IAAQ,EAAI,cAAc,OAAO;CAGvC,AAFA,EAAM,KAAK,GACX,EAAM,cAAc,IACnB,EAAI,QAAQ,EAAI,gBAAA,EAAkB,YAAY,CAAK;AACtD;AAUA,SAAgB,EAAiB,GAAiB,GAAyC;CACzF,AAAI,MAAW,WAAQ,EAAG,MAAM,cAAc;AAChD"}

package/dist/zine.d.ts

@@ -137,6 +137,18 @@ export declare class Zine {
     getPage(): number;
     /** The element this flipbook was mounted into. */
     get container(): HTMLElement;
+    /**
+     * Where the book is actually painted inside the container, in container pixels: the
+     * aspect-fitted, centred region, which is shorter (or narrower) than the container whenever the
+     * two aspect-ratios do not match. A side rail uses it to stand exactly as tall as the page rather
+     * than the whole container. Null before the first paint, when there is nothing to measure yet.
+     */
+    getPageBox(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
     /**
      * How pages are currently grouped, one entry per spread — the same model the renderer paints,
      * so it already reflects `spreadMode` and the responsive single-page fallback. Useful for
@@ -207,7 +219,14 @@ export declare class Zine {
      * simply by implementing them.
      */
     isDocument(): boolean;
-    /** Whether this book can be printed — true when the source has an original document. */
+    /**
+     * Whether this book can be printed: the source must have an original document, and the browser
+     * must render PDFs inline. {@link print} loads the file into an offscreen iframe and drives it
+     * with `window.print()`, which needs a built-in PDF viewer; Android Chrome has none, so the
+     * frame never lays out and the print silently does nothing. `pdfViewerEnabled` reports exactly
+     * that capability, so hide the control when it is explicitly false. It is only hidden on that
+     * explicit false — a browser too old to report the property (undefined) keeps the button.
+     */
     canPrint(): boolean;
     /**
      * Print the document.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinejs/core",
-  "version": "0.7.4",
+  "version": "0.8.2",
   "description": "Framework-agnostic flipbook engine with CSS and WebGL2 renderers and no dependencies.",
   "type": "module",
   "sideEffects": false,