@hypercard-ai/hyper-jump 1.0.1 → 1.1.0

package/README.md

@@ -10,7 +10,7 @@ Renderers are opt-in — only bundle what you use.
 
 ## Features
 
-- **Pluggable renderers** — import only the file types you need (PDF, video, and more coming soon)
+- **Pluggable renderers** — import only the file types you need (PDF, video, markdown, and more coming soon)
 - Virtualized rendering via `react-window` for smooth viewing of large PDFs
 - Unified `jump()` API for instant navigation to cited content across all file types
 - Zoom controls with preset levels and automatic fit-to-width
@@ -23,6 +23,9 @@ Renderers are opt-in — only bundle what you use.
 # Core + PDF renderer
 npm install @hypercard-ai/hyper-jump react-pdf react-window
 
+# Core + Markdown renderer
+npm install @hypercard-ai/hyper-jump react-markdown
+
 # Core + Video renderer (no extra dependencies needed)
 npm install @hypercard-ai/hyper-jump
 ```
@@ -47,7 +50,7 @@ function App() {
 
 ### Open at a specific position
 
-Pass `initialPosition` to start at a specific location when the file loads. The meaning depends on the renderer — page index for PDF, seconds for video:
+Pass `initialPosition` to start at a specific location when the file loads. The meaning depends on the renderer — page index for PDF, seconds for video, pixel offset for markdown:
 
 ```tsx
 // PDF: open at page 4 (0-indexed)
@@ -55,6 +58,9 @@ Pass `initialPosition` to start at a specific location when the file loads. The
 
 // Video: start at 30 seconds
 <HyperJumpViewer url="/clip.mp4" renderers={[VideoRenderer]} initialPosition={30} />
+
+// Markdown: start at 200px scroll offset
+<HyperJumpViewer url="/doc.md" renderers={[MarkdownRenderer]} initialPosition={200} />
 ```
 
 ### Jump to a position imperatively
@@ -96,7 +102,7 @@ The core component. It detects the file type from the URL extension (or an expli
 | `renderers` | `FileRenderer[]` | Yes | Renderers the viewer can use (first match wins) |
 | `type` | `string` | No | Explicit file type override (e.g. `"pdf"`). If omitted, detected from URL extension |
 | `ref` | `Ref<HyperJumpAPI>` | No | Forwarded to the active renderer for the `jump()` API |
-| `initialPosition` | `number` | No | Position to start at when the file loads (page index for PDF, seconds for video) |
+| `initialPosition` | `number` | No | Position to start at when the file loads (page index for PDF, seconds for video, pixel offset for markdown) |
 | `onPositionChange` | `(position: number) => void` | No | Called when the current position changes |
 | `rendererProps` | `T` | No | Additional props forwarded to the matched renderer (generic, typed per renderer) |
 
@@ -106,7 +112,7 @@ All renderers expose the same imperative API:
 
 | Method | Description |
 | --- | --- |
-| `jump(position: number)` | Jump to a position. Page index for PDF (0-indexed, clamped), seconds for video. |
+| `jump(position: number)` | Jump to a position. Page index for PDF (0-indexed, clamped), seconds for video, pixel offset for markdown. |
 
 ### PDF Renderer
 
@@ -118,6 +124,26 @@ Imported from `@hypercard-ai/hyper-jump/pdf`. Requires `react-pdf` and `react-wi
 | --- | --- | --- | --- |
 | `scrollBehavior` | `"auto" \| "instant" \| "smooth"` | No | Scroll behavior when navigating between pages (default: `"instant"`) |
 
+### Markdown Renderer
+
+Imported from `@hypercard-ai/hyper-jump/markdown`. Requires `react-markdown` as a peer dependency. Fetches the markdown file from the URL and renders it with GitHub-flavored styling.
+
+```tsx
+import { HyperJumpViewer } from "@hypercard-ai/hyper-jump";
+import { MarkdownRenderer } from "@hypercard-ai/hyper-jump/markdown";
+import "@hypercard-ai/hyper-jump/styles.css";
+import "@hypercard-ai/hyper-jump/markdown/styles.css";
+
+function App() {
+  return (
+    <HyperJumpViewer
+      url="/path/to/document.md"
+      renderers={[MarkdownRenderer]}
+    />
+  );
+}
+```
+
 ### Video Renderer
 
 Imported from `@hypercard-ai/hyper-jump/video`. Uses the native HTML `<video>` element — no extra dependencies required.
@@ -165,6 +191,14 @@ function App() {
 | `HyperJumpPdfViewerProps` | Type | Full props for the PDF renderer |
 | `ScrollBehavior` | Type | Scroll behavior union type |
 
+#### `@hypercard-ai/hyper-jump/markdown`
+
+| Export | Type | Description |
+| --- | --- | --- |
+| `MarkdownRenderer` | `FileRenderer` | Renderer descriptor for markdown files |
+| `HyperJumpMarkdownViewerAPI` | Type | Alias for `HyperJumpAPI` |
+| `HyperJumpMarkdownViewerProps` | Type | Full props for the markdown renderer |
+
 #### `@hypercard-ai/hyper-jump/video`
 
 | Export | Type | Description |
@@ -196,6 +230,7 @@ const MyVideoRenderer: FileRenderer = {
 - React 19+
 - react-pdf 10+ (when using `PdfRenderer`)
 - react-window 2+ (when using `PdfRenderer`)
+- react-markdown 9+ (when using `MarkdownRenderer`)
 
 ## Development
 

package/dist/index.d.ts

@@ -1,23 +1,4 @@
-import { F as FileRenderer, H as HyperJumpAPI } from './types-Ce3M8ej7.js';
-export { R as RendererProps, Z as ZoomConfig } from './types-Ce3M8ej7.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-
-interface HyperJumpViewerProps<T extends Record<string, unknown> = Record<string, unknown>> {
-    /** URL of the file to display */
-    url: string;
-    /** Explicit file type override (e.g. "pdf", "video"). If omitted, detected from URL extension. */
-    type?: string;
-    /** Renderers that this viewer can use. The first matching renderer wins. */
-    renderers: FileRenderer[];
-    /** Ref forwarded to the active renderer (e.g. for imperative APIs like jump). */
-    ref?: React.Ref<HyperJumpAPI>;
-    /** Initial position to show when the content first loads. Meaning depends on renderer (page index for PDF, seconds for video). */
-    initialPosition?: number;
-    /** Called when the current position changes. Meaning depends on renderer (page index for PDF, seconds for video). */
-    onPositionChange?: (position: number) => void;
-    /** Additional props forwarded to the matched renderer. */
-    rendererProps?: T;
-}
-declare function HyperJumpViewer<T extends Record<string, unknown> = Record<string, unknown>>(props: HyperJumpViewerProps<T>): react_jsx_runtime.JSX.Element;
-
-export { FileRenderer, HyperJumpAPI, HyperJumpViewer, type HyperJumpViewerProps };
+export type { FileRenderer, HyperJumpAPI, RendererProps, ZoomConfig, } from "./lib/types";
+export type { HyperJumpViewerProps } from "./viewer/viewer";
+export { HyperJumpViewer } from "./viewer/viewer";
+//# 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":"AAAA,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,GACV,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/{types-Ce3M8ej7.d.ts → lib/types.d.ts}

@@ -1,10 +1,10 @@
 type ZoomMode = "automatic" | "page-width" | "manual";
-interface ZoomConfig {
+export interface ZoomConfig {
     mode: ZoomMode;
     value: number;
 }
 /** Props that the core viewer passes to every renderer. */
-interface RendererProps {
+export interface RendererProps {
     url: string;
     containerWidth: number;
     containerHeight: number;
@@ -14,12 +14,12 @@ interface RendererProps {
     onPositionChange?: (position: number) => void;
 }
 /** Imperative API shared by all renderers. Exposed via ref on HyperJumpViewer. */
-interface HyperJumpAPI {
+export interface HyperJumpAPI {
     /** Jump to a position. Meaning depends on renderer (page index for PDF, seconds for video). */
     jump: (position: number) => void;
 }
 /** A renderer descriptor that tells the core viewer how to handle a file type. */
-interface FileRenderer {
+export interface FileRenderer {
     /** Unique identifier for this renderer type (e.g. "pdf", "video"). */
     type: string;
     /** File extensions this renderer handles, without dots (e.g. ["pdf"]). */
@@ -27,5 +27,5 @@ interface FileRenderer {
     /** The component that renders the file. */
     Component: React.ComponentType<RendererProps & Record<string, unknown>>;
 }
-
-export type { FileRenderer as F, HyperJumpAPI as H, RendererProps as R, ZoomConfig as Z };
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,kIAAkI;IAClI,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qHAAqH;IACrH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC5B,+FAA+F;IAC/F,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC5B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxE"}

package/dist/lib/use-element-size.d.ts

@@ -0,0 +1,6 @@
+export declare function useElementSize<T extends HTMLElement = HTMLDivElement>(): {
+    ref: (node: T | null) => void;
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=use-element-size.d.ts.map

package/dist/lib/use-element-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-element-size.d.ts","sourceRoot":"","sources":["../../src/lib/use-element-size.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc;gBAIrC,CAAC,GAAG,IAAI;;;EAoBvC"}

package/dist/markdown/index.css

@@ -0,0 +1,137 @@
+/* src/markdown/markdown-viewer.css */
+.hj-markdown {
+  height: 100%;
+  width: 100%;
+  overflow-y: auto;
+  padding: 24px 32px;
+  box-sizing: border-box;
+  font-family:
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    Helvetica,
+    Arial,
+    sans-serif;
+  font-size: 16px;
+  line-height: 1.6;
+  color: #1f2328;
+  word-wrap: break-word;
+}
+.hj-markdown--loading,
+.hj-markdown--error {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.hj-markdown h1,
+.hj-markdown h2,
+.hj-markdown h3,
+.hj-markdown h4,
+.hj-markdown h5,
+.hj-markdown h6 {
+  margin-top: 24px;
+  margin-bottom: 16px;
+  font-weight: 600;
+  line-height: 1.25;
+}
+.hj-markdown h1 {
+  font-size: 2em;
+  padding-bottom: 0.3em;
+  border-bottom: 1px solid #d1d9e0;
+}
+.hj-markdown h2 {
+  font-size: 1.5em;
+  padding-bottom: 0.3em;
+  border-bottom: 1px solid #d1d9e0;
+}
+.hj-markdown h3 {
+  font-size: 1.25em;
+}
+.hj-markdown p {
+  margin-top: 0;
+  margin-bottom: 16px;
+}
+.hj-markdown a {
+  color: #0969da;
+  text-decoration: none;
+}
+.hj-markdown a:hover {
+  text-decoration: underline;
+}
+.hj-markdown code {
+  padding: 0.2em 0.4em;
+  margin: 0;
+  font-size: 85%;
+  background-color: rgba(175, 184, 193, 0.2);
+  border-radius: 6px;
+  font-family:
+    ui-monospace,
+    SFMono-Regular,
+    "SF Mono",
+    Menlo,
+    Consolas,
+    "Liberation Mono",
+    monospace;
+}
+.hj-markdown pre {
+  padding: 16px;
+  overflow: auto;
+  font-size: 85%;
+  line-height: 1.45;
+  background-color: #f6f8fa;
+  border-radius: 6px;
+  margin-bottom: 16px;
+}
+.hj-markdown pre code {
+  padding: 0;
+  background-color: transparent;
+  border-radius: 0;
+  font-size: 100%;
+}
+.hj-markdown blockquote {
+  padding: 0 1em;
+  color: #656d76;
+  border-left: 0.25em solid #d1d9e0;
+  margin: 0 0 16px 0;
+}
+.hj-markdown ul,
+.hj-markdown ol {
+  padding-left: 2em;
+  margin-top: 0;
+  margin-bottom: 16px;
+}
+.hj-markdown li + li {
+  margin-top: 0.25em;
+}
+.hj-markdown hr {
+  height: 0.25em;
+  padding: 0;
+  margin: 24px 0;
+  background-color: #d1d9e0;
+  border: 0;
+}
+.hj-markdown img {
+  max-width: 100%;
+  height: auto;
+}
+.hj-markdown table {
+  border-spacing: 0;
+  border-collapse: collapse;
+  margin-bottom: 16px;
+  width: max-content;
+  max-width: 100%;
+  overflow: auto;
+}
+.hj-markdown table th,
+.hj-markdown table td {
+  padding: 6px 13px;
+  border: 1px solid #d1d9e0;
+}
+.hj-markdown table th {
+  font-weight: 600;
+  background-color: #f6f8fa;
+}
+.hj-markdown table tr:nth-child(2n) {
+  background-color: #f6f8fa;
+}
+/*# sourceMappingURL=index.css.map */

package/dist/markdown/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/markdown/markdown-viewer.css"],"sourcesContent":[".hj-markdown {\n\theight: 100%;\n\twidth: 100%;\n\toverflow-y: auto;\n\tpadding: 24px 32px;\n\tbox-sizing: border-box;\n\tfont-family:\n\t\t-apple-system, BlinkMacSystemFont, \"Segoe UI\", Helvetica, Arial, sans-serif;\n\tfont-size: 16px;\n\tline-height: 1.6;\n\tcolor: #1f2328;\n\tword-wrap: break-word;\n}\n\n.hj-markdown--loading,\n.hj-markdown--error {\n\tdisplay: flex;\n\talign-items: center;\n\tjustify-content: center;\n}\n\n.hj-markdown h1,\n.hj-markdown h2,\n.hj-markdown h3,\n.hj-markdown h4,\n.hj-markdown h5,\n.hj-markdown h6 {\n\tmargin-top: 24px;\n\tmargin-bottom: 16px;\n\tfont-weight: 600;\n\tline-height: 1.25;\n}\n\n.hj-markdown h1 {\n\tfont-size: 2em;\n\tpadding-bottom: 0.3em;\n\tborder-bottom: 1px solid #d1d9e0;\n}\n\n.hj-markdown h2 {\n\tfont-size: 1.5em;\n\tpadding-bottom: 0.3em;\n\tborder-bottom: 1px solid #d1d9e0;\n}\n\n.hj-markdown h3 {\n\tfont-size: 1.25em;\n}\n\n.hj-markdown p {\n\tmargin-top: 0;\n\tmargin-bottom: 16px;\n}\n\n.hj-markdown a {\n\tcolor: #0969da;\n\ttext-decoration: none;\n}\n\n.hj-markdown a:hover {\n\ttext-decoration: underline;\n}\n\n.hj-markdown code {\n\tpadding: 0.2em 0.4em;\n\tmargin: 0;\n\tfont-size: 85%;\n\tbackground-color: rgba(175, 184, 193, 0.2);\n\tborder-radius: 6px;\n\tfont-family:\n\t\tui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\",\n\t\tmonospace;\n}\n\n.hj-markdown pre {\n\tpadding: 16px;\n\toverflow: auto;\n\tfont-size: 85%;\n\tline-height: 1.45;\n\tbackground-color: #f6f8fa;\n\tborder-radius: 6px;\n\tmargin-bottom: 16px;\n}\n\n.hj-markdown pre code {\n\tpadding: 0;\n\tbackground-color: transparent;\n\tborder-radius: 0;\n\tfont-size: 100%;\n}\n\n.hj-markdown blockquote {\n\tpadding: 0 1em;\n\tcolor: #656d76;\n\tborder-left: 0.25em solid #d1d9e0;\n\tmargin: 0 0 16px 0;\n}\n\n.hj-markdown ul,\n.hj-markdown ol {\n\tpadding-left: 2em;\n\tmargin-top: 0;\n\tmargin-bottom: 16px;\n}\n\n.hj-markdown li + li {\n\tmargin-top: 0.25em;\n}\n\n.hj-markdown hr {\n\theight: 0.25em;\n\tpadding: 0;\n\tmargin: 24px 0;\n\tbackground-color: #d1d9e0;\n\tborder: 0;\n}\n\n.hj-markdown img {\n\tmax-width: 100%;\n\theight: auto;\n}\n\n.hj-markdown table {\n\tborder-spacing: 0;\n\tborder-collapse: collapse;\n\tmargin-bottom: 16px;\n\twidth: max-content;\n\tmax-width: 100%;\n\toverflow: auto;\n}\n\n.hj-markdown table th,\n.hj-markdown table td {\n\tpadding: 6px 13px;\n\tborder: 1px solid #d1d9e0;\n}\n\n.hj-markdown table th {\n\tfont-weight: 600;\n\tbackground-color: #f6f8fa;\n}\n\n.hj-markdown table tr:nth-child(2n) {\n\tbackground-color: #f6f8fa;\n}\n"],"mappings":";AAAA,CAAC;AACA,UAAQ;AACR,SAAO;AACP,cAAY;AACZ,WAAS,KAAK;AACd,cAAY;AACZ;AAAA,IACC,aAAa;AAAA,IAAE,kBAAkB;AAAA,IAAE,UAAU;AAAA,IAAE,SAAS;AAAA,IAAE,KAAK;AAAA,IAAE;AAClE,aAAW;AACX,eAAa;AACb,SAAO;AACP,aAAW;AACZ;AAEA,CAAC;AACD,CAAC;AACA,WAAS;AACT,eAAa;AACb,mBAAiB;AAClB;AAEA,CArBC,YAqBY;AACb,CAtBC,YAsBY;AACb,CAvBC,YAuBY;AACb,CAxBC,YAwBY;AACb,CAzBC,YAyBY;AACb,CA1BC,YA0BY;AACZ,cAAY;AACZ,iBAAe;AACf,eAAa;AACb,eAAa;AACd;AAEA,CAjCC,YAiCY;AACZ,aAAW;AACX,kBAAgB;AAChB,iBAAe,IAAI,MAAM;AAC1B;AAEA,CAvCC,YAuCY;AACZ,aAAW;AACX,kBAAgB;AAChB,iBAAe,IAAI,MAAM;AAC1B;AAEA,CA7CC,YA6CY;AACZ,aAAW;AACZ;AAEA,CAjDC,YAiDY;AACZ,cAAY;AACZ,iBAAe;AAChB;AAEA,CAtDC,YAsDY;AACZ,SAAO;AACP,mBAAiB;AAClB;AAEA,CA3DC,YA2DY,CAAC;AACb,mBAAiB;AAClB;AAEA,CA/DC,YA+DY;AACZ,WAAS,MAAM;AACf,UAAQ;AACR,aAAW;AACX,oBAAkB,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;AACtC,iBAAe;AACf;AAAA,IACC,YAAY;AAAA,IAAE,cAAc;AAAA,IAAE,SAAS;AAAA,IAAE,KAAK;AAAA,IAAE,QAAQ;AAAA,IAAE,iBAAiB;AAAA,IAC3E;AACF;AAEA,CA1EC,YA0EY;AACZ,WAAS;AACT,YAAU;AACV,aAAW;AACX,eAAa;AACb,oBAAkB;AAClB,iBAAe;AACf,iBAAe;AAChB;AAEA,CApFC,YAoFY,IAAI;AAChB,WAAS;AACT,oBAAkB;AAClB,iBAAe;AACf,aAAW;AACZ;AAEA,CA3FC,YA2FY;AACZ,WAAS,EAAE;AACX,SAAO;AACP,eAAa,OAAO,MAAM;AAC1B,UAAQ,EAAE,EAAE,KAAK;AAClB;AAEA,CAlGC,YAkGY;AACb,CAnGC,YAmGY;AACZ,gBAAc;AACd,cAAY;AACZ,iBAAe;AAChB;AAEA,CAzGC,YAyGY,GAAG,EAAE;AACjB,cAAY;AACb;AAEA,CA7GC,YA6GY;AACZ,UAAQ;AACR,WAAS;AACT,UAAQ,KAAK;AACb,oBAAkB;AAClB,UAAQ;AACT;AAEA,CArHC,YAqHY;AACZ,aAAW;AACX,UAAQ;AACT;AAEA,CA1HC,YA0HY;AACZ,kBAAgB;AAChB,mBAAiB;AACjB,iBAAe;AACf,SAAO;AACP,aAAW;AACX,YAAU;AACX;AAEA,CAnIC,YAmIY,MAAM;AACnB,CApIC,YAoIY,MAAM;AAClB,WAAS,IAAI;AACb,UAAQ,IAAI,MAAM;AACnB;AAEA,CAzIC,YAyIY,MAAM;AAClB,eAAa;AACb,oBAAkB;AACnB;AAEA,CA9IC,YA8IY,MAAM,EAAE;AACpB,oBAAkB;AACnB;","names":[]}

package/dist/markdown/index.d.ts

@@ -0,0 +1,3 @@
+export type { HyperJumpMarkdownViewerAPI, HyperJumpMarkdownViewerProps, } from "./markdown-viewer";
+export { MarkdownRenderer } from "./markdown-viewer";
+//# sourceMappingURL=index.d.ts.map

package/dist/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/markdown/index.js

@@ -0,0 +1,73 @@
+// src/markdown/markdown-viewer.tsx
+import {
+  forwardRef,
+  useCallback,
+  useEffect,
+  useImperativeHandle,
+  useRef,
+  useState
+} from "react";
+import Markdown from "react-markdown";
+import { jsx } from "react/jsx-runtime";
+var MarkdownViewerComponent = forwardRef(function MarkdownViewerComponent2(props, ref) {
+  const { url, initialPosition, onPositionChange } = props;
+  const containerRef = useRef(null);
+  const hasAppliedInitialPosition = useRef(false);
+  const [content, setContent] = useState(null);
+  const [error, setError] = useState(null);
+  useImperativeHandle(
+    ref,
+    () => ({
+      jump: (position) => {
+        if (containerRef.current) {
+          containerRef.current.scrollTop = position;
+        }
+      }
+    }),
+    []
+  );
+  useEffect(() => {
+    let cancelled = false;
+    setContent(null);
+    setError(null);
+    hasAppliedInitialPosition.current = false;
+    fetch(url).then((res) => {
+      if (!res.ok) throw new Error(`Failed to fetch: ${res.status}`);
+      return res.text();
+    }).then((text) => {
+      if (!cancelled) setContent(text);
+    }).catch((err) => {
+      if (!cancelled) setError(err.message);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [url]);
+  useEffect(() => {
+    if (!hasAppliedInitialPosition.current && initialPosition !== void 0 && content !== null && containerRef.current) {
+      hasAppliedInitialPosition.current = true;
+      containerRef.current.scrollTop = initialPosition;
+    }
+  }, [initialPosition, content]);
+  const handleScroll = useCallback(() => {
+    if (containerRef.current) {
+      onPositionChange?.(containerRef.current.scrollTop);
+    }
+  }, [onPositionChange]);
+  if (error) {
+    return /* @__PURE__ */ jsx("div", { className: "hj-markdown hj-markdown--error", children: error });
+  }
+  if (content === null) {
+    return /* @__PURE__ */ jsx("div", { className: "hj-markdown hj-markdown--loading", children: "Loading\u2026" });
+  }
+  return /* @__PURE__ */ jsx("div", { className: "hj-markdown", ref: containerRef, onScroll: handleScroll, children: /* @__PURE__ */ jsx(Markdown, { children: content }) });
+});
+var MarkdownRenderer = {
+  type: "markdown",
+  extensions: ["md", "markdown"],
+  Component: MarkdownViewerComponent
+};
+export {
+  MarkdownRenderer
+};
+//# sourceMappingURL=index.js.map

package/dist/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/markdown/markdown-viewer.tsx"],"sourcesContent":["import {\n\tforwardRef,\n\tuseCallback,\n\tuseEffect,\n\tuseImperativeHandle,\n\tuseRef,\n\tuseState,\n} from \"react\";\nimport Markdown from \"react-markdown\";\nimport type { FileRenderer, HyperJumpAPI, RendererProps } from \"../lib/types\";\nimport \"./markdown-viewer.css\";\n\nexport type HyperJumpMarkdownViewerAPI = HyperJumpAPI;\n\nexport interface HyperJumpMarkdownViewerProps extends RendererProps {}\n\nconst MarkdownViewerComponent = forwardRef<\n\tHyperJumpMarkdownViewerAPI,\n\tHyperJumpMarkdownViewerProps\n>(function MarkdownViewerComponent(props, ref) {\n\tconst { url, initialPosition, onPositionChange } = props;\n\tconst containerRef = useRef<HTMLDivElement>(null);\n\tconst hasAppliedInitialPosition = useRef(false);\n\tconst [content, setContent] = useState<string | null>(null);\n\tconst [error, setError] = useState<string | null>(null);\n\n\tuseImperativeHandle(\n\t\tref,\n\t\t() => ({\n\t\t\tjump: (position: number) => {\n\t\t\t\tif (containerRef.current) {\n\t\t\t\t\tcontainerRef.current.scrollTop = position;\n\t\t\t\t}\n\t\t\t},\n\t\t}),\n\t\t[],\n\t);\n\n\tuseEffect(() => {\n\t\tlet cancelled = false;\n\t\tsetContent(null);\n\t\tsetError(null);\n\t\thasAppliedInitialPosition.current = false;\n\n\t\tfetch(url)\n\t\t\t.then((res) => {\n\t\t\t\tif (!res.ok) throw new Error(`Failed to fetch: ${res.status}`);\n\t\t\t\treturn res.text();\n\t\t\t})\n\t\t\t.then((text) => {\n\t\t\t\tif (!cancelled) setContent(text);\n\t\t\t})\n\t\t\t.catch((err) => {\n\t\t\t\tif (!cancelled) setError(err.message);\n\t\t\t});\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [url]);\n\n\tuseEffect(() => {\n\t\tif (\n\t\t\t!hasAppliedInitialPosition.current &&\n\t\t\tinitialPosition !== undefined &&\n\t\t\tcontent !== null &&\n\t\t\tcontainerRef.current\n\t\t) {\n\t\t\thasAppliedInitialPosition.current = true;\n\t\t\tcontainerRef.current.scrollTop = initialPosition;\n\t\t}\n\t}, [initialPosition, content]);\n\n\tconst handleScroll = useCallback(() => {\n\t\tif (containerRef.current) {\n\t\t\tonPositionChange?.(containerRef.current.scrollTop);\n\t\t}\n\t}, [onPositionChange]);\n\n\tif (error) {\n\t\treturn <div className=\"hj-markdown hj-markdown--error\">{error}</div>;\n\t}\n\n\tif (content === null) {\n\t\treturn <div className=\"hj-markdown hj-markdown--loading\">Loading…</div>;\n\t}\n\n\treturn (\n\t\t<div className=\"hj-markdown\" ref={containerRef} onScroll={handleScroll}>\n\t\t\t<Markdown>{content}</Markdown>\n\t\t</div>\n\t);\n});\n\nexport const MarkdownRenderer: FileRenderer = {\n\ttype: \"markdown\",\n\textensions: [\"md\", \"markdown\"],\n\tComponent: MarkdownViewerComponent as React.ComponentType<\n\t\tRendererProps & Record<string, unknown>\n\t>,\n};\n"],"mappings":";AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;AACP,OAAO,cAAc;AAwEZ;AAhET,IAAM,0BAA0B,WAG9B,SAASA,yBAAwB,OAAO,KAAK;AAC9C,QAAM,EAAE,KAAK,iBAAiB,iBAAiB,IAAI;AACnD,QAAM,eAAe,OAAuB,IAAI;AAChD,QAAM,4BAA4B,OAAO,KAAK;AAC9C,QAAM,CAAC,SAAS,UAAU,IAAI,SAAwB,IAAI;AAC1D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD;AAAA,IACC;AAAA,IACA,OAAO;AAAA,MACN,MAAM,CAAC,aAAqB;AAC3B,YAAI,aAAa,SAAS;AACzB,uBAAa,QAAQ,YAAY;AAAA,QAClC;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAC;AAAA,EACF;AAEA,YAAU,MAAM;AACf,QAAI,YAAY;AAChB,eAAW,IAAI;AACf,aAAS,IAAI;AACb,8BAA0B,UAAU;AAEpC,UAAM,GAAG,EACP,KAAK,CAAC,QAAQ;AACd,UAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,oBAAoB,IAAI,MAAM,EAAE;AAC7D,aAAO,IAAI,KAAK;AAAA,IACjB,CAAC,EACA,KAAK,CAAC,SAAS;AACf,UAAI,CAAC,UAAW,YAAW,IAAI;AAAA,IAChC,CAAC,EACA,MAAM,CAAC,QAAQ;AACf,UAAI,CAAC,UAAW,UAAS,IAAI,OAAO;AAAA,IACrC,CAAC;AAEF,WAAO,MAAM;AACZ,kBAAY;AAAA,IACb;AAAA,EACD,GAAG,CAAC,GAAG,CAAC;AAER,YAAU,MAAM;AACf,QACC,CAAC,0BAA0B,WAC3B,oBAAoB,UACpB,YAAY,QACZ,aAAa,SACZ;AACD,gCAA0B,UAAU;AACpC,mBAAa,QAAQ,YAAY;AAAA,IAClC;AAAA,EACD,GAAG,CAAC,iBAAiB,OAAO,CAAC;AAE7B,QAAM,eAAe,YAAY,MAAM;AACtC,QAAI,aAAa,SAAS;AACzB,yBAAmB,aAAa,QAAQ,SAAS;AAAA,IAClD;AAAA,EACD,GAAG,CAAC,gBAAgB,CAAC;AAErB,MAAI,OAAO;AACV,WAAO,oBAAC,SAAI,WAAU,kCAAkC,iBAAM;AAAA,EAC/D;AAEA,MAAI,YAAY,MAAM;AACrB,WAAO,oBAAC,SAAI,WAAU,oCAAmC,2BAAQ;AAAA,EAClE;AAEA,SACC,oBAAC,SAAI,WAAU,eAAc,KAAK,cAAc,UAAU,cACzD,8BAAC,YAAU,mBAAQ,GACpB;AAEF,CAAC;AAEM,IAAM,mBAAiC;AAAA,EAC7C,MAAM;AAAA,EACN,YAAY,CAAC,MAAM,UAAU;AAAA,EAC7B,WAAW;AAGZ;","names":["MarkdownViewerComponent"]}

package/dist/markdown/markdown-viewer.d.ts

@@ -0,0 +1,7 @@
+import type { FileRenderer, HyperJumpAPI, RendererProps } from "../lib/types";
+import "./markdown-viewer.css";
+export type HyperJumpMarkdownViewerAPI = HyperJumpAPI;
+export interface HyperJumpMarkdownViewerProps extends RendererProps {
+}
+export declare const MarkdownRenderer: FileRenderer;
+//# sourceMappingURL=markdown-viewer.d.ts.map

package/dist/markdown/markdown-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-viewer.d.ts","sourceRoot":"","sources":["../../src/markdown/markdown-viewer.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,uBAAuB,CAAC;AAE/B,MAAM,MAAM,0BAA0B,GAAG,YAAY,CAAC;AAEtD,MAAM,WAAW,4BAA6B,SAAQ,aAAa;CAAG;AAgFtE,eAAO,MAAM,gBAAgB,EAAE,YAM9B,CAAC"}

package/dist/pdf/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const PAGE_HEIGHT = 842;
+export declare const PAGE_WIDTH = 595;
+//# sourceMappingURL=constants.d.ts.map

package/dist/pdf/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/pdf/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,UAAU,MAAM,CAAC"}

package/dist/pdf/controls.d.ts

@@ -0,0 +1,13 @@
+import "./controls.css";
+import type { ZoomConfig } from "../lib/types";
+interface IProps {
+    onChangeZoom(value: string): void;
+    pageIndex: number;
+    numPages: number;
+    zoomConfig: ZoomConfig;
+    onNextPage(): void;
+    onPrevPage(): void;
+}
+export default function PDFViewerControls(props: IProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=controls.d.ts.map

package/dist/pdf/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../src/pdf/controls.tsx"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc/C,UAAU,MAAM;IACf,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,IAAI,IAAI,CAAC;IACnB,UAAU,IAAI,IAAI,CAAC;CACnB;AAsCD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,KAAK,EAAE,MAAM,2CAyDtD"}

package/dist/pdf/error-page.d.ts

@@ -0,0 +1,3 @@
+import "./error-page.css";
+export default function PDFErrorPage(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=error-page.d.ts.map

package/dist/pdf/error-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-page.d.ts","sourceRoot":"","sources":["../../src/pdf/error-page.tsx"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,MAAM,CAAC,OAAO,UAAU,YAAY,4CAEnC"}

package/dist/pdf/index.d.ts

@@ -1,12 +1,3 @@
-import { H as HyperJumpAPI, R as RendererProps, F as FileRenderer } from '../types-Ce3M8ej7.js';
-
-type HyperJumpPdfViewerAPI = HyperJumpAPI;
-type ScrollBehavior = "auto" | "instant" | "smooth";
-interface HyperJumpPdfViewerProps extends RendererProps {
-    /** Scroll behavior when navigating between pages (default: "instant") */
-    scrollBehavior?: ScrollBehavior;
-}
-/** Renderer descriptor for PDF files. Pass this to HyperJumpViewer's `renderers` prop. */
-declare const PdfRenderer: FileRenderer;
-
-export { type HyperJumpPdfViewerAPI, type HyperJumpPdfViewerProps, PdfRenderer, type ScrollBehavior };
+export type { HyperJumpPdfViewerAPI, HyperJumpPdfViewerProps, ScrollBehavior, } from "./pdf-viewer";
+export { PdfRenderer } from "./pdf-viewer";
+//# sourceMappingURL=index.d.ts.map

package/dist/pdf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pdf/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/pdf/loading-page.d.ts

@@ -0,0 +1,3 @@
+import "./loading-page.css";
+export default function PDFLoadingPage(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=loading-page.d.ts.map

package/dist/pdf/loading-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-page.d.ts","sourceRoot":"","sources":["../../src/pdf/loading-page.tsx"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAE5B,MAAM,CAAC,OAAO,UAAU,cAAc,4CAMrC"}

package/dist/pdf/pdf-viewer.d.ts

@@ -0,0 +1,13 @@
+import "react-pdf/dist/Page/AnnotationLayer.css";
+import "react-pdf/dist/Page/TextLayer.css";
+import type { FileRenderer, HyperJumpAPI, RendererProps } from "../lib/types";
+import "./pdf-viewer.css";
+export type HyperJumpPdfViewerAPI = HyperJumpAPI;
+export type ScrollBehavior = "auto" | "instant" | "smooth";
+export interface HyperJumpPdfViewerProps extends RendererProps {
+    /** Scroll behavior when navigating between pages (default: "instant") */
+    scrollBehavior?: ScrollBehavior;
+}
+/** Renderer descriptor for PDF files. Pass this to HyperJumpViewer's `renderers` prop. */
+export declare const PdfRenderer: FileRenderer;
+//# sourceMappingURL=pdf-viewer.d.ts.map

package/dist/pdf/pdf-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-viewer.d.ts","sourceRoot":"","sources":["../../src/pdf/pdf-viewer.tsx"],"names":[],"mappings":"AAWA,OAAO,yCAAyC,CAAC;AACjD,OAAO,mCAAmC,CAAC;AAG3C,OAAO,KAAK,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EAEb,MAAM,cAAc,CAAC;AAItB,OAAO,kBAAkB,CAAC;AAQ1B,MAAM,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC7D,yEAAyE;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC;AAwKD,0FAA0F;AAC1F,eAAO,MAAM,WAAW,EAAE,YAMzB,CAAC"}

package/dist/pdf/renderer.d.ts

@@ -0,0 +1,8 @@
+import type { RowComponentProps } from "react-window";
+import "./renderer.css";
+interface RowProps {
+    scale: number;
+}
+export default function PDFPageRenderer(props: RowComponentProps<RowProps>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=renderer.d.ts.map

package/dist/pdf/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/pdf/renderer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,gBAAgB,CAAC;AAExB,UAAU,QAAQ;IACjB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,2CAOzE"}

package/dist/pdf/utils.d.ts

@@ -0,0 +1,6 @@
+import type { PDFDocumentProxy } from "pdfjs-dist";
+export declare function getPageDimensions(document: PDFDocumentProxy, scale: number): Promise<{
+    height: number;
+    width: number;
+}[]>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/pdf/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/pdf/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM;;;KAkBb"}

package/dist/pdf/viewer.stories.d.ts

@@ -0,0 +1,11 @@
+import type { StoryObj } from "@storybook/react";
+import { HyperJumpViewer } from "../viewer/viewer";
+declare const meta: {
+    title: string;
+    component: typeof HyperJumpViewer;
+};
+export default meta;
+export declare const CitationJumps: StoryObj<typeof meta>;
+export declare const Loading: StoryObj<typeof meta>;
+export declare const ErrorState: StoryObj<typeof meta>;
+//# sourceMappingURL=viewer.stories.d.ts.map

package/dist/pdf/viewer.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.stories.d.ts","sourceRoot":"","sources":["../../src/pdf/viewer.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKnD,QAAA,MAAM,IAAI;;;CAG8B,CAAC;AAEzC,eAAe,IAAI,CAAC;AAwEpB,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,OAAO,IAAI,CAyL/C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,CASzC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,OAAO,IAAI,CAS5C,CAAC"}

package/dist/video/index.d.ts

@@ -1,11 +1,3 @@
-import { H as HyperJumpAPI, R as RendererProps, F as FileRenderer } from '../types-Ce3M8ej7.js';
-
-type HyperJumpVideoViewerAPI = HyperJumpAPI;
-interface HyperJumpVideoViewerProps extends RendererProps {
-    /** Whether the video should autoplay (default: false). */
-    autoPlay?: boolean;
-}
-/** Renderer descriptor for video files. Pass this to HyperJumpViewer's `renderers` prop. */
-declare const VideoRenderer: FileRenderer;
-
-export { type HyperJumpVideoViewerAPI, type HyperJumpVideoViewerProps, VideoRenderer };
+export type { HyperJumpVideoViewerAPI, HyperJumpVideoViewerProps, } from "./video-viewer";
+export { VideoRenderer } from "./video-viewer";
+//# sourceMappingURL=index.d.ts.map

package/dist/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/video/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,uBAAuB,EACvB,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/video/video-viewer.d.ts

@@ -0,0 +1,10 @@
+import type { FileRenderer, HyperJumpAPI, RendererProps } from "../lib/types";
+import "./video-viewer.css";
+export type HyperJumpVideoViewerAPI = HyperJumpAPI;
+export interface HyperJumpVideoViewerProps extends RendererProps {
+    /** Whether the video should autoplay (default: false). */
+    autoPlay?: boolean;
+}
+/** Renderer descriptor for video files. Pass this to HyperJumpViewer's `renderers` prop. */
+export declare const VideoRenderer: FileRenderer;
+//# sourceMappingURL=video-viewer.d.ts.map

package/dist/video/video-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-viewer.d.ts","sourceRoot":"","sources":["../../src/video/video-viewer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,oBAAoB,CAAC;AAE5B,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC/D,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAmDD,4FAA4F;AAC5F,eAAO,MAAM,aAAa,EAAE,YAM3B,CAAC"}

package/dist/video/viewer.stories.d.ts

@@ -0,0 +1,9 @@
+import type { StoryObj } from "@storybook/react";
+import { HyperJumpViewer } from "../viewer/viewer";
+declare const meta: {
+    title: string;
+    component: typeof HyperJumpViewer;
+};
+export default meta;
+export declare const Playground: StoryObj<typeof meta>;
+//# sourceMappingURL=viewer.stories.d.ts.map

package/dist/video/viewer.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.stories.d.ts","sourceRoot":"","sources":["../../src/video/viewer.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,QAAA,MAAM,IAAI;;;CAG8B,CAAC;AAEzC,eAAe,IAAI,CAAC;AAapB,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,OAAO,IAAI,CAyI5C,CAAC"}

package/dist/viewer/viewer.d.ts

@@ -0,0 +1,20 @@
+import type { FileRenderer, HyperJumpAPI } from "../lib/types";
+import "./viewer.css";
+export interface HyperJumpViewerProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** URL of the file to display */
+    url: string;
+    /** Explicit file type override (e.g. "pdf", "video"). If omitted, detected from URL extension. */
+    type?: string;
+    /** Renderers that this viewer can use. The first matching renderer wins. */
+    renderers: FileRenderer[];
+    /** Ref forwarded to the active renderer (e.g. for imperative APIs like jump). */
+    ref?: React.Ref<HyperJumpAPI>;
+    /** Initial position to show when the content first loads. Meaning depends on renderer (page index for PDF, seconds for video). */
+    initialPosition?: number;
+    /** Called when the current position changes. Meaning depends on renderer (page index for PDF, seconds for video). */
+    onPositionChange?: (position: number) => void;
+    /** Additional props forwarded to the matched renderer. */
+    rendererProps?: T;
+}
+export declare function HyperJumpViewer<T extends Record<string, unknown> = Record<string, unknown>>(props: HyperJumpViewerProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/viewer/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/viewer/viewer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,oBAAoB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3D,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,iFAAiF;IACjF,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC9B,kIAAkI;IAClI,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qHAAqH;IACrH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,0DAA0D;IAC1D,aAAa,CAAC,EAAE,CAAC,CAAC;CAClB;AAaD,wBAAgB,eAAe,CAC9B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,2CAwC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hypercard-ai/hyper-jump",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"description": "Document viewer built for RAG",
 	"license": "MIT",
 	"author": "HyperCard AI",
@@ -13,6 +13,7 @@
 		"url": "https://github.com/hypercard-ai/hyper-jump/issues"
 	},
 	"keywords": [
+		"markdown",
 		"pdf",
 		"video",
 		"viewer",
@@ -38,7 +39,12 @@
 			"types": "./dist/video/index.d.ts",
 			"default": "./dist/video/index.js"
 		},
-		"./video/styles.css": "./dist/video/index.css"
+		"./video/styles.css": "./dist/video/index.css",
+		"./markdown": {
+			"types": "./dist/markdown/index.d.ts",
+			"default": "./dist/markdown/index.js"
+		},
+		"./markdown/styles.css": "./dist/markdown/index.css"
 	},
 	"files": [
 		"dist",
@@ -52,7 +58,7 @@
 		"access": "public"
 	},
 	"scripts": {
-		"build": "tsup",
+		"build": "tsup && tsc --emitDeclarationOnly --outDir dist",
 		"dev": "tsup --watch",
 		"test": "vitest run",
 		"test:watch": "vitest",
@@ -67,12 +73,16 @@
 		"react": ">=19.0.0",
 		"react-dom": ">=19.0.0",
 		"react-pdf": ">=10.0.0",
+		"react-markdown": ">=9.0.0",
 		"react-window": ">=2.0.0"
 	},
 	"peerDependenciesMeta": {
 		"react-pdf": {
 			"optional": true
 		},
+		"react-markdown": {
+			"optional": true
+		},
 		"react-window": {
 			"optional": true
 		}
@@ -88,6 +98,7 @@
 		"jsdom": "^28.0.0",
 		"react": "^19.2.4",
 		"react-dom": "^19.2.4",
+		"react-markdown": "^9.0.0",
 		"react-pdf": "10.3.0",
 		"react-window": "^2.2.7",
 		"storybook": "^10.2.8",