@michaelyagi/shoji 0.1.0-beta.3 → 0.1.0-beta.6

package/README.md

@@ -3,9 +3,9 @@
 [![CI](https://github.com/MichaelYagi/shoji/actions/workflows/ci.yml/badge.svg)](https://github.com/MichaelYagi/shoji/actions/workflows/ci.yml)
 [![npm (beta)](https://img.shields.io/npm/v/%40michaelyagi%2Fshoji/beta.svg)](https://www.npmjs.com/package/@michaelyagi/shoji)
 
-A zero-dependency, plugin-first TypeScript lightbox/gallery. Drop in two `<script>`/`<link>` tags, or install from npm — everything beyond the minimal lightbox, including every official plugin, is opt-in.
+> **AI-authored.** 100% of the code was written by Claude (Anthropic); I shaped the architecture, scope, and every decision, and did all the testing.
 
-> **Status: beta.** The API is still settling — expect breaking changes between `0.x` releases.
+A zero-dependency, plugin-first TypeScript lightbox/gallery. Drop in two `<script>`/`<link>` tags, or install from npm — everything beyond the minimal lightbox, including every official plugin, is opt-in.
 
 ## Features
 
@@ -14,7 +14,7 @@ A zero-dependency, plugin-first TypeScript lightbox/gallery. Drop in two `<scrip
 - **Plugin system** — zoom (pinch/pan/wheel), fullscreen, rotate/flip, autoplay/slideshow, active-thumbnail sync, YouTube video embeds, and a grid/masonry/justified layout engine, each independently opt-in.
 - **Accessibility is not a plugin** — keyboard nav, focus trapping, ARIA roles, and screen-reader announcements live in core.
 - **Themeable via CSS custom properties** — no hardcoded colors/sizes in JS.
-- **Single-file distribution** — `dist/shoji.js` + `dist/shoji.css` (core + every official plugin, self-registering) for zero-setup `<script>` tag use, plus tree-shakable per-plugin ESM entries for bundler users.
+- **Three distributions** — single-file (`dist/shoji.js` + `dist/shoji.css`, core + every plugin, self-registering) for zero-setup `<script>` tag use; core + individual plugin files (`dist/core/shoji-core.(min.)js` + `dist/plugins/{name}.(min.)js`) for `<script>`-tag consumers who want to pick exactly which plugins ship; and tree-shakable per-plugin ESM entries for bundler users.
 - Size-budgeted and CI-enforced: core ≤ 21 kB, each plugin ≤ 8 kB, full bundle ≤ 90 kB (all min+gzip).
 
 ## Install

package/dist/core/shoji-core.js

@@ -14,6 +14,9 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
   let styleObserver = null;
   let intentionalScrollOccurred = false;
   const LIGHTBOX_SELECTOR = ".shoji-outer";
+  function markIntentionalScroll() {
+    intentionalScrollOccurred = true;
+  }
   function isRtl() {
     return getComputedStyle(document.documentElement).direction === "rtl";
   }
@@ -531,8 +534,16 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
     const translateY = to.top + to.height / 2 - (from.top + from.height / 2);
     return `translate3d(${translateX}px, ${translateY}px, 0) scale3d(${scale}, ${scale}, 1)`;
   }
+  function effectiveOriginBox(origin) {
+    const img = origin.querySelector("img");
+    if (img) {
+      const rect = img.getBoundingClientRect();
+      if (rect.width > 0 && rect.height > 0) return rect;
+    }
+    return origin.getBoundingClientRect();
+  }
   function computeTransform(origin, target, aspectRatio, naturalSize) {
-    const originRect = origin.getBoundingClientRect();
+    const originRect = effectiveOriginBox(origin);
     const targetRect = effectiveTargetBox(target, aspectRatio, naturalSize);
     if (targetRect.width === 0 || targetRect.height === 0 || originRect.width === 0 || originRect.height === 0) {
       return null;
@@ -2579,6 +2590,10 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       }
       return this.scannedElements[index] ?? null;
     }
+    /** Lets a plugin's background-page `scrollIntoView()` survive `close()`'s scroll restore, routed through this shared instance rather than importing `bodyScrollLock` directly — required for the standalone core+plugins distribution, where a direct import would get its own disconnected module copy (DESIGN.md §4.2/§10). Same reasoning `getOriginElement`/`getActiveMedia` were made public for. */
+    markIntentionalScroll() {
+      markIntentionalScroll();
+    }
     scheduleAutoHide() {
       if (this.autoHideTimer !== null) {
         clearTimeout(this.autoHideTimer);