@dogsbay/plugin-image-zoom 0.2.0-beta.81

package/README.md

@@ -0,0 +1,55 @@
+# @dogsbay/plugin-image-zoom
+
+Click-to-zoom for docs images. Drop-in for any Dogsbay site.
+
+## Install
+
+```bash
+pnpm add @dogsbay/plugin-image-zoom
+```
+
+## Use
+
+```yaml
+# dogsbay.config.yml
+plugins:
+  - "@dogsbay/plugin-image-zoom"
+```
+
+With options:
+
+```yaml
+plugins:
+  - name: "@dogsbay/plugin-image-zoom"
+    options:
+      background: "rgba(0,0,0,0.92)"
+      margin: 32
+```
+
+## Options
+
+| Option | Default | Description |
+|---|---|---|
+| `selector` | `"article img"` | CSS selector for which images get the zoom UX. |
+| `background` | `"rgba(0,0,0,0.85)"` | Overlay backdrop. |
+| `margin` | `20` | Pixels of margin around the zoomed image. |
+| `scrollOffset` | `40` | Scroll-to-close threshold. |
+| `excludeInsideLinks` | `true` | Skip images inside `<a>` (the link is the click target). |
+
+## How it works
+
+1. **Build time** — the plugin walks every page's TreeNode AST and
+   adds `data-zoomable="true"` to images that aren't inside `<a>`
+   links.
+2. **Run time** — a small client module attaches
+   [medium-zoom](https://github.com/francoischalifour/medium-zoom)
+   handlers to every `[data-zoomable]` element. The handlers are
+   re-bound on every `astro:page-load` so view transitions don't
+   leave stale state.
+
+The runtime only attaches handlers to pre-tagged elements — no DOM
+scan, no observer, nothing past the click handler itself.
+
+## License
+
+MIT.

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":""}

package/dist/client.js

@@ -0,0 +1,49 @@
+/**
+ * Client runtime for `@dogsbay/plugin-image-zoom`.
+ *
+ * Imported via the auto-generated `src/lib/plugin-runtime.ts`
+ * entry point in the user's Astro project. The build-time walker
+ * has already tagged article images with `data-zoomable="true"`,
+ * so this module only needs to (re)bind medium-zoom on every
+ * navigation event.
+ *
+ * Astro view transitions: every `astro:page-load` event causes a
+ * detach + reattach. `astro:before-swap` detaches before the new
+ * DOM lands so we don't carry stale references.
+ */
+import mediumZoom from "medium-zoom";
+// Vite alias — emitted by `dogsbay site build` via
+// `astro.config.plugins.mjs`. Resolves at build time to the
+// JSON-serialized options the plugin baked in.
+// @ts-expect-error: virtual module resolved by Vite alias.
+import config from "virtual:dogsbay-plugin-config/@dogsbay/plugin-image-zoom";
+const runtimeConfig = config;
+let zoom = null;
+function attach() {
+    if (zoom) {
+        zoom.detach();
+        zoom = null;
+    }
+    zoom = mediumZoom("[data-zoomable]", {
+        background: runtimeConfig.background,
+        margin: runtimeConfig.margin,
+        scrollOffset: runtimeConfig.scrollOffset,
+    });
+}
+function detach() {
+    if (zoom) {
+        zoom.detach();
+        zoom = null;
+    }
+}
+if (typeof document !== "undefined") {
+    if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", attach);
+    }
+    else {
+        attach();
+    }
+    document.addEventListener("astro:page-load", attach);
+    document.addEventListener("astro:before-swap", detach);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,mDAAmD;AACnD,4DAA4D;AAC5D,+CAA+C;AAC/C,2DAA2D;AAC3D,OAAO,MAAM,MAAM,0DAA0D,CAAC;AAQ9E,MAAM,aAAa,GAAkB,MAAuB,CAAC;AAE7D,IAAI,IAAI,GAAyC,IAAI,CAAC;AAEtD,SAAS,MAAM;IACb,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,UAAU,CAAC,iBAAiB,EAAE;QACnC,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,YAAY,EAAE,aAAa,CAAC,YAAY;KACzC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM;IACb,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;IACpC,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC;IACX,CAAC;IACD,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { DogsbayPlugin } from "@dogsbay/types";
+import { type ImageZoomOptions } from "./schema.js";
+export type { ImageZoomOptions } from "./schema.js";
+export default function imageZoom(input?: ImageZoomOptions): DogsbayPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAclE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,aAAa,CA+BzE"}

package/dist/index.js

@@ -0,0 +1,63 @@
+/**
+ * `@dogsbay/plugin-image-zoom` — adds click-to-enlarge to docs
+ * images. Build-time TreeNode walk tags `<img>` nodes; runtime
+ * client module attaches medium-zoom handlers to the tagged
+ * elements. View-transition aware (rebinds on `astro:page-load`).
+ *
+ * Usage:
+ *
+ *   # dogsbay.config.yml
+ *   plugins:
+ *     - "@dogsbay/plugin-image-zoom"
+ *
+ *   # or with options
+ *   plugins:
+ *     - name: "@dogsbay/plugin-image-zoom"
+ *       options:
+ *         background: "rgba(0,0,0,0.92)"
+ *         margin: 32
+ *
+ * See plans/plugin-api.md for the API contract.
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseOptions } from "./schema.js";
+import { tagImagesInTree } from "./walker.js";
+// __dirname equivalent for an ESM-published package. Resolves the
+// directory the built `dist/index.js` lives in so we can hand
+// absolute paths to the Dogsbay plugin runtime.
+const PLUGIN_DIR = path.dirname(fileURLToPath(import.meta.url));
+// __dirname is `dist/`; the runtime emits absolute paths to the
+// built `client.js` and the (un-built) `styles.css` shipped at the
+// package root under `src/styles.css`.
+const PACKAGE_ROOT = path.resolve(PLUGIN_DIR, "..");
+const CLIENT_PATH = path.join(PLUGIN_DIR, "client.js");
+const STYLES_PATH = path.join(PACKAGE_ROOT, "src", "styles.css");
+export default function imageZoom(input) {
+    const opts = parseOptions(input);
+    return {
+        name: "@dogsbay/plugin-image-zoom",
+        onContentImported(pages, nav) {
+            const tagged = pages.map((page) => ({
+                ...page,
+                tree: tagImagesInTree(page.tree, opts),
+            }));
+            return { pages: tagged, nav };
+        },
+        clientModules() {
+            return [CLIENT_PATH];
+        },
+        styles() {
+            return [STYLES_PATH];
+        },
+        defineClientConfig() {
+            // Only the runtime-relevant subset. JSON-safe.
+            return {
+                background: opts.background,
+                margin: opts.margin,
+                scrollOffset: opts.scrollOffset,
+            };
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,kEAAkE;AAClE,8DAA8D;AAC9D,gDAAgD;AAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,gEAAgE;AAChE,mEAAmE;AACnE,uCAAuC;AACvC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACpD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAIjE,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,KAAwB;IACxD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEjC,OAAO;QACL,IAAI,EAAE,4BAA4B;QAElC,iBAAiB,CAAC,KAAmB,EAAE,GAAc;YACnD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAClC,GAAG,IAAI;gBACP,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;aACvC,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAChC,CAAC;QAED,aAAa;YACX,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;QAED,MAAM;YACJ,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;QAED,kBAAkB;YAChB,+CAA+C;YAC/C,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Options schema for `@dogsbay/plugin-image-zoom`.
+ *
+ * Validation is hand-rolled to avoid a Zod dep — the option set is
+ * small enough that the boilerplate is in noise. The `parseOptions`
+ * function returns a fully-resolved options object with every field
+ * set to either the user value or the documented default.
+ */
+export interface ImageZoomOptions {
+    /**
+     * CSS selector matched against TreeNode image nodes during the
+     * build-time walk. The walker tags matching `<img>` elements
+     * with `data-zoomable="true"` so the runtime doesn't need to
+     * scan the DOM. Default: every `<img>` inside `<article>`.
+     *
+     * NOTE: Currently informational — the build-time walker tags
+     * every image node that isn't inside a link. The selector
+     * primarily documents intent and may drive a future
+     * predicate-based filter. Use `excludeInsideLinks` and the
+     * runtime selector to control the runtime side.
+     */
+    selector?: string;
+    /** Background colour of the zoom overlay. Default rgba(0,0,0,.85). */
+    background?: string;
+    /** Pixels of margin around the zoomed image. Default 20. */
+    margin?: number;
+    /** Pixels of scroll before the overlay closes. Default 40. */
+    scrollOffset?: number;
+    /**
+     * When true (default), images inside `<a>` links are not
+     * tagged — the click already navigates somewhere. Setting to
+     * false zooms every image regardless.
+     */
+    excludeInsideLinks?: boolean;
+}
+export interface ResolvedImageZoomOptions {
+    selector: string;
+    background: string;
+    margin: number;
+    scrollOffset: number;
+    excludeInsideLinks: boolean;
+}
+/**
+ * Validate + resolve user options. Throws structured errors with
+ * the offending field path so users see "options.margin must be a
+ * non-negative integer" rather than a cryptic stack.
+ */
+export declare function parseOptions(input: unknown): ResolvedImageZoomOptions;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAUD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAyDrE"}

package/dist/schema.js

@@ -0,0 +1,70 @@
+/**
+ * Options schema for `@dogsbay/plugin-image-zoom`.
+ *
+ * Validation is hand-rolled to avoid a Zod dep — the option set is
+ * small enough that the boilerplate is in noise. The `parseOptions`
+ * function returns a fully-resolved options object with every field
+ * set to either the user value or the documented default.
+ */
+const DEFAULTS = {
+    selector: "article img",
+    background: "rgba(0, 0, 0, 0.85)",
+    margin: 20,
+    scrollOffset: 40,
+    excludeInsideLinks: true,
+};
+/**
+ * Validate + resolve user options. Throws structured errors with
+ * the offending field path so users see "options.margin must be a
+ * non-negative integer" rather than a cryptic stack.
+ */
+export function parseOptions(input) {
+    if (input === undefined || input === null)
+        return { ...DEFAULTS };
+    if (typeof input !== "object" || Array.isArray(input)) {
+        throw new Error(`@dogsbay/plugin-image-zoom: options must be an object, got ${describe(input)}.`);
+    }
+    const opts = input;
+    const out = { ...DEFAULTS };
+    if (opts.selector !== undefined) {
+        if (typeof opts.selector !== "string" || opts.selector.trim() === "") {
+            throw new Error(`@dogsbay/plugin-image-zoom: options.selector must be a non-empty string.`);
+        }
+        out.selector = opts.selector;
+    }
+    if (opts.background !== undefined) {
+        if (typeof opts.background !== "string" || opts.background.trim() === "") {
+            throw new Error(`@dogsbay/plugin-image-zoom: options.background must be a non-empty string.`);
+        }
+        out.background = opts.background;
+    }
+    if (opts.margin !== undefined) {
+        if (typeof opts.margin !== "number" || !Number.isInteger(opts.margin) || opts.margin < 0) {
+            throw new Error(`@dogsbay/plugin-image-zoom: options.margin must be a non-negative integer.`);
+        }
+        out.margin = opts.margin;
+    }
+    if (opts.scrollOffset !== undefined) {
+        if (typeof opts.scrollOffset !== "number" ||
+            !Number.isInteger(opts.scrollOffset) ||
+            opts.scrollOffset < 0) {
+            throw new Error(`@dogsbay/plugin-image-zoom: options.scrollOffset must be a non-negative integer.`);
+        }
+        out.scrollOffset = opts.scrollOffset;
+    }
+    if (opts.excludeInsideLinks !== undefined) {
+        if (typeof opts.excludeInsideLinks !== "boolean") {
+            throw new Error(`@dogsbay/plugin-image-zoom: options.excludeInsideLinks must be a boolean.`);
+        }
+        out.excludeInsideLinks = opts.excludeInsideLinks;
+    }
+    return out;
+}
+function describe(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/walker.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Build-time TreeNode walker — tags every page image with
+ * `data-zoomable="true"` so the runtime can skip its own DOM
+ * scan and bind handlers only to pre-marked elements.
+ *
+ * Skips images inside link nodes when `excludeInsideLinks` is on
+ * (the link click already does something — zooming would be
+ * surprising).
+ *
+ * Tolerates the cross-format TreeNode shape variations:
+ *   - inline images attached to a paragraph via `inline: [{type: "image"}]`
+ *   - block-level images as `{type: "image"}` children
+ *   - `link` nodes by either `type: "link"` or `type: "a"`
+ */
+import type { TreeNode } from "@dogsbay/types";
+import type { ResolvedImageZoomOptions } from "./schema.js";
+export declare function tagImagesInTree(nodes: TreeNode[], opts: ResolvedImageZoomOptions): TreeNode[];
+//# sourceMappingURL=walker.d.ts.map

package/dist/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,wBAAwB,GAC7B,QAAQ,EAAE,CAEZ"}

package/dist/walker.js

@@ -0,0 +1,71 @@
+export function tagImagesInTree(nodes, opts) {
+    return nodes.map((n) => walkNode(n, opts, false));
+}
+function walkNode(node, opts, insideLink) {
+    const isLink = node.type === "link" || node.type === "a";
+    const recurseInsideLink = insideLink || isLink;
+    // Block-level image — tag it.
+    if (node.type === "image") {
+        if (insideLink && opts.excludeInsideLinks)
+            return node;
+        return {
+            ...node,
+            props: { ...(node.props ?? {}), "data-zoomable": "true" },
+        };
+    }
+    let next = node;
+    // Recurse into block children.
+    if (node.children?.length) {
+        next = {
+            ...next,
+            children: node.children.map((c) => walkNode(c, opts, recurseInsideLink)),
+        };
+    }
+    // Recurse into inline children. Inline images live as an entry in
+    // the inline array; tag them via an inline-side helper.
+    if (node.inline?.length) {
+        next = {
+            ...next,
+            inline: walkInline(node.inline, opts, recurseInsideLink),
+        };
+    }
+    // Special-case the "paragraph with only one inline image" shape
+    // — the format-astro serializer emits a single <BlockImage /> for
+    // that. We tag the paragraph itself so BlockImage emission can
+    // forward `data-zoomable`.
+    if (next.type === "paragraph" && next.inline?.length) {
+        const meaningful = next.inline.filter((n) => !(n.type === "text" && !("text" in n && n.text.trim())));
+        if (meaningful.length === 1 &&
+            meaningful[0].type === "image" &&
+            !(insideLink && opts.excludeInsideLinks)) {
+            next = {
+                ...next,
+                props: { ...(next.props ?? {}), "data-zoomable": "true" },
+            };
+        }
+    }
+    return next;
+}
+function walkInline(nodes, opts, insideLink) {
+    return nodes.map((n) => {
+        if (n.type === "image") {
+            if (insideLink && opts.excludeInsideLinks)
+                return n;
+            // InlineImage doesn't have a typed `data-*` slot; we attach
+            // via a meta-style cast. The astro serializer reads the
+            // resulting attribute when emitting the <img> element.
+            return {
+                ...n,
+                // The serializer maps unknown extra props onto the <img>
+                // tag — see packages/format-astro/src/serialize.ts. Casting
+                // through unknown to keep the InlineNode union types clean.
+                ...{ "data-zoomable": "true" },
+            };
+        }
+        if (n.type === "link" && n.children?.length) {
+            return { ...n, children: walkInline(n.children, opts, true) };
+        }
+        return n;
+    });
+}
+//# sourceMappingURL=walker.js.map

package/dist/walker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.js","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,eAAe,CAC7B,KAAiB,EACjB,IAA8B;IAE9B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CACf,IAAc,EACd,IAA8B,EAC9B,UAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC;IACzD,MAAM,iBAAiB,GAAG,UAAU,IAAI,MAAM,CAAC;IAE/C,8BAA8B;IAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,IAAI,UAAU,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,GAAa,IAAI,CAAC;IAE1B,+BAA+B;IAC/B,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1B,IAAI,GAAG;YACL,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,wDAAwD;IACxD,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,GAAG;YACL,GAAG,IAAI;YACP,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,kEAAkE;IAClE,+DAA+D;IAC/D,2BAA2B;IAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAC/D,CAAC;QACF,IACE,UAAU,CAAC,MAAM,KAAK,CAAC;YACvB,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO;YAC9B,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,kBAAkB,CAAC,EACxC,CAAC;YACD,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE;aAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CACjB,KAAmB,EACnB,IAA8B,EAC9B,UAAmB;IAEnB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,IAAI,UAAU,IAAI,IAAI,CAAC,kBAAkB;gBAAE,OAAO,CAAC,CAAC;YACpD,4DAA4D;YAC5D,wDAAwD;YACxD,uDAAuD;YACvD,OAAO;gBACL,GAAG,CAAC;gBACJ,yDAAyD;gBACzD,4DAA4D;gBAC5D,4DAA4D;gBAC5D,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE;aACjB,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC5C,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dogsbay/plugin-image-zoom",
+  "version": "0.2.0-beta.81",
+  "description": "Click-to-zoom for images in Dogsbay docs sites.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": "./dist/client.js",
+    "./styles.css": "./src/styles.css"
+  },
+  "files": [
+    "dist",
+    "src/styles.css",
+    "src/client.ts",
+    "README.md"
+  ],
+  "dependencies": {
+    "medium-zoom": "^1.1.0",
+    "@dogsbay/types": "0.2.0-beta.81"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "dogsbay",
+    "dogsbay-plugin",
+    "documentation",
+    "image-zoom"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dogsbay/dogsbay.git",
+    "directory": "packages/plugin-image-zoom"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/client.ts

@@ -0,0 +1,58 @@
+/**
+ * Client runtime for `@dogsbay/plugin-image-zoom`.
+ *
+ * Imported via the auto-generated `src/lib/plugin-runtime.ts`
+ * entry point in the user's Astro project. The build-time walker
+ * has already tagged article images with `data-zoomable="true"`,
+ * so this module only needs to (re)bind medium-zoom on every
+ * navigation event.
+ *
+ * Astro view transitions: every `astro:page-load` event causes a
+ * detach + reattach. `astro:before-swap` detaches before the new
+ * DOM lands so we don't carry stale references.
+ */
+import mediumZoom from "medium-zoom";
+// Vite alias — emitted by `dogsbay site build` via
+// `astro.config.plugins.mjs`. Resolves at build time to the
+// JSON-serialized options the plugin baked in.
+// @ts-expect-error: virtual module resolved by Vite alias.
+import config from "virtual:dogsbay-plugin-config/@dogsbay/plugin-image-zoom";
+
+interface RuntimeConfig {
+  background: string;
+  margin: number;
+  scrollOffset: number;
+}
+
+const runtimeConfig: RuntimeConfig = config as RuntimeConfig;
+
+let zoom: ReturnType<typeof mediumZoom> | null = null;
+
+function attach(): void {
+  if (zoom) {
+    zoom.detach();
+    zoom = null;
+  }
+  zoom = mediumZoom("[data-zoomable]", {
+    background: runtimeConfig.background,
+    margin: runtimeConfig.margin,
+    scrollOffset: runtimeConfig.scrollOffset,
+  });
+}
+
+function detach(): void {
+  if (zoom) {
+    zoom.detach();
+    zoom = null;
+  }
+}
+
+if (typeof document !== "undefined") {
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", attach);
+  } else {
+    attach();
+  }
+  document.addEventListener("astro:page-load", attach);
+  document.addEventListener("astro:before-swap", detach);
+}

package/src/styles.css

@@ -0,0 +1,24 @@
+/**
+ * Styles shipped by @dogsbay/plugin-image-zoom.
+ *
+ * Imported into the user's `src/styles/global.css` by `dogsbay
+ * site build` via the plugin runtime emitter.
+ */
+
+[data-zoomable] {
+  cursor: zoom-in;
+  transition: transform 200ms ease;
+}
+
+.medium-zoom-overlay {
+  z-index: 100;
+}
+
+.medium-zoom-image {
+  cursor: zoom-out;
+  z-index: 101;
+}
+
+.medium-zoom--opened [data-zoomable] {
+  cursor: default;
+}