pdfjs-reader-core 0.4.3 → 0.5.1

package/dist/index.js

@@ -12996,8 +12996,6 @@ var PAPER = "#faf6ec";
 var ACCENT = "#b04a1a";
 var ACCENT_SOFT = "rgba(176, 74, 26, 0.18)";
 var ACCENT_GLOW = "rgba(176, 74, 26, 0.35)";
-var MARKER = "#e6b422";
-var MARKER_SOFT = "rgba(230, 180, 34, 0.38)";
 var SERIF = "'Iowan Old Style', 'Palatino Linotype', Palatino, 'Book Antiqua', 'EB Garamond', 'Hoefler Text', Georgia, serif";
 var EASE_OUT_EXPO = [0.22, 1, 0.36, 1];
 
@@ -13285,17 +13283,17 @@ function AnimatedUnderline({ bbox, action }) {
 import { useId as useId2 } from "react";
 import { motion as motion4 } from "framer-motion";
 import { jsx as jsx44, jsxs as jsxs37 } from "react/jsx-runtime";
+var WASH = "rgba(230, 180, 34, 0.22)";
 function AnimatedHighlight({ bbox, action }) {
   const [x1, y1, x2, y2] = bbox;
   const h = Math.max(1, y2 - y1);
   const bleed = Math.min(4, h * 0.12);
   const yTop = y1 - bleed;
   const yBot = y2 + bleed;
-  const height = yBot - yTop;
   const duration = action.draw_duration_ms / 1e3;
   const filterId = useId2();
-  const fill = action.color && action.color !== "rgba(250, 204, 21, 0.35)" && action.color !== "rgba(250,204,21,0.35)" ? action.color : MARKER_SOFT;
-  const inner = action.color && action.color !== "rgba(250, 204, 21, 0.35)" && action.color !== "rgba(250,204,21,0.35)" ? action.color : MARKER;
+  const isDefaultColour = !action.color || action.color === "rgba(250, 204, 21, 0.35)" || action.color === "rgba(250,204,21,0.35)";
+  const fill = isDefaultColour ? WASH : action.color;
   const taper = Math.min(6, h * 0.2);
   const pathD = `
     M ${x1 - 2} ${yTop + taper}
@@ -13325,44 +13323,24 @@ function AnimatedHighlight({ bbox, action }) {
             "feTurbulence",
             {
               type: "fractalNoise",
-              baseFrequency: "1.6",
+              baseFrequency: "1.8",
               numOctaves: "1",
               seed: 3,
               result: "noise"
             }
           ),
-          /* @__PURE__ */ jsx44("feDisplacementMap", { in: "SourceGraphic", in2: "noise", scale: 1.4 })
+          /* @__PURE__ */ jsx44("feDisplacementMap", { in: "SourceGraphic", in2: "noise", scale: 1 })
         ] }) }),
-        /* @__PURE__ */ jsxs37(
-          motion4.g,
+        /* @__PURE__ */ jsx44(
+          motion4.path,
           {
+            d: pathD,
+            fill,
             initial: { clipPath: `inset(0 100% 0 0)` },
             animate: { clipPath: `inset(0 0% 0 0)` },
             exit: { opacity: 0 },
-            transition: { duration, ease: EASE_OUT_EXPO },
-            children: [
-              /* @__PURE__ */ jsx44(
-                "path",
-                {
-                  d: pathD,
-                  fill,
-                  opacity: 0.85,
-                  filter: `url(#${filterId})`
-                }
-              ),
-              /* @__PURE__ */ jsx44(
-                "rect",
-                {
-                  x: x1 - 1,
-                  y: y1 - bleed * 0.4,
-                  width: x2 - x1 + 2,
-                  height: height - bleed * 0.8,
-                  fill: inner,
-                  opacity: 0.5,
-                  filter: `url(#${filterId})`
-                }
-              )
-            ]
+            filter: `url(#${filterId})`,
+            transition: { duration, ease: EASE_OUT_EXPO }
           }
         )
       ]
@@ -14925,7 +14903,12 @@ var StoryboardStepSchema = z.object({
 });
 var StoryboardSchema = z.object({
   version: z.literal(1),
-  reasoning: z.string().max(500).default(""),
+  // `reasoning` was required in 0.4.x as a model-generated explanation used
+  // by DebugLog. It carries no visual effect and costs 50–150 output tokens
+  // per call, so from 0.5.1 it's optional (default empty). Consumers who
+  // still send it (from cached prompts or older directors) keep working —
+  // the field is still accepted, just not required.
+  reasoning: z.string().max(500).optional().default(""),
   steps: z.array(StoryboardStepSchema).min(1).max(4)
 });
 function storyboardJsonSchema(opts = {}) {
@@ -15040,7 +15023,10 @@ function storyboardJsonSchema(opts = {}) {
   return {
     type: "object",
     additionalProperties: false,
-    required: ["version", "reasoning", "steps"],
+    // `reasoning` intentionally omitted from `required` — the field is still
+    // accepted when present but the model doesn't need to generate it,
+    // which saves 50–150 output tokens per call. See zod schema above.
+    required: ["version", "steps"],
     properties: {
       version: { type: "integer", enum: [1] },
       reasoning: { type: "string" },
@@ -15079,7 +15065,6 @@ Anchoring rules:
 Output ONLY this JSON, nothing else:
 {
   "version": 1,
-  "reasoning": "<which block(s) you picked, which intent you used, and why \u2014 name the block_id>",
   "steps": [ { "at_ms": <int>, "duration_ms": <int>, "action": <action> }, ... ]
 }
 
@@ -15116,7 +15101,6 @@ When narration fits one of these patterns, emit the corresponding storyboard sha
 Shape: spotlight the term + underline it + drop a label tag. No camera move if the block is already on-screen.
 {
   "version": 1,
-  "reasoning": "define recipe: spotlighting and underlining the term, labeling as 'definition'",
   "steps": [
     { "at_ms":0,   "duration_ms":700, "action": { "type":"spotlight", "target_block":"p1_para0", "dim_opacity":0.6, "feather_px":40, "shape":"rounded" } },
     { "at_ms":200, "duration_ms":800, "action": { "type":"underline", "target_block":"p1_para0", "color":"#FBBF24", "style":"sketch", "draw_duration_ms":700 } },
@@ -15128,7 +15112,6 @@ Shape: spotlight the term + underline it + drop a label tag. No camera move if t
 Shape: gentle camera move + callout arrow from caption to figure + pulse the figure.
 {
   "version": 1,
-  "reasoning": "point_out recipe: drawing attention from caption p1_cap1 to figure p1_fig0",
   "steps": [
     { "at_ms":0,   "duration_ms":600, "action": { "type":"camera", "target_block":"p1_fig0", "scale":1.3, "padding":80, "easing":"ease-out" } },
     { "at_ms":400, "duration_ms":900, "action": { "type":"callout", "from_block":"p1_cap1", "to_block":"p1_fig0", "label":"see here", "curve":"curved" } },
@@ -15140,7 +15123,6 @@ Shape: gentle camera move + callout arrow from caption to figure + pulse the fig
 Shape: box A + box B + callout between them with a relational label.
 {
   "version": 1,
-  "reasoning": "compare recipe: framing fibrous vs synovial joints",
   "steps": [
     { "at_ms":0,   "duration_ms":600, "action": { "type":"box", "target_block":"p1_list5", "color":"#3B82F6", "style":"solid" } },
     { "at_ms":300, "duration_ms":600, "action": { "type":"box", "target_block":"p1_list12", "color":"#F472B6", "style":"solid" } },
@@ -15152,7 +15134,6 @@ Shape: box A + box B + callout between them with a relational label.
 Shape: highlight + pulse. Fast, punchy, no camera.
 {
   "version": 1,
-  "reasoning": "emphasize recipe: highlighting key keyword and pulsing for stress",
   "steps": [
     { "at_ms":0,   "duration_ms":500, "action": { "type":"highlight", "target_block":"p1_list0", "color":"rgba(250,204,21,0.35)", "draw_duration_ms":450 } },
     { "at_ms":350, "duration_ms":800, "action": { "type":"pulse", "target_block":"p1_list0", "count":2, "intensity":"strong" } }
@@ -15459,9 +15440,10 @@ function enforceOverlayPresence(sb) {
   if (!cameraStep || cameraStep.action.type !== "camera") return sb;
   const target = cameraStep.action.target_block;
   if (!target) return sb;
+  const prefix = sb.reasoning ? `${sb.reasoning} ` : "";
   return {
     ...sb,
-    reasoning: `${sb.reasoning} [auto-appended pulse: camera-only storyboards are forbidden]`,
+    reasoning: `${prefix}[auto-appended pulse: camera-only storyboards are forbidden]`,
     steps: [
       ...sb.steps,
       {
@@ -15853,6 +15835,7 @@ function TutorModeContainer({
   backgroundColor = "#ffffff",
   loadingComponent,
   onPageChange,
+  storyboardProvider,
   className
 }) {
   const containerRef = useRef27(null);
@@ -15931,7 +15914,7 @@ function TutorModeContainer({
   const debounceRef = useRef27(null);
   const lastChunkRef = useRef27(null);
   useEffect28(() => {
-    if (!llm) return;
+    if (!storyboardProvider && !llm) return;
     if (!currentChunk || currentChunk === lastChunkRef.current) return;
     if (debounceRef.current) clearTimeout(debounceRef.current);
     debounceRef.current = setTimeout(async () => {
@@ -15952,6 +15935,75 @@ function TutorModeContainer({
       });
       abortRef.current?.abort();
       abortRef.current = new AbortController();
+      if (storyboardProvider) {
+        narrationStore.getState().setLlmStatus("in-flight");
+        narrationStore.getState().appendDebugEvent({
+          kind: "llm-request",
+          summary: `provider (page ${pageNumber}, ${page2.blocks.length} blocks)`,
+          payload: {
+            via: "storyboardProvider",
+            pageNumber,
+            blockCount: page2.blocks.length
+          }
+        });
+        try {
+          const raw = await storyboardProvider({
+            chunk,
+            pageNumber,
+            page: page2,
+            history: narrationStore.getState().chunkHistory,
+            signal: abortRef.current.signal
+          });
+          if (!raw) {
+            narrationStore.getState().setLlmStatus("idle");
+            narrationStore.getState().appendDebugEvent({
+              kind: "note",
+              summary: "provider returned null \u2014 no storyboard for this chunk"
+            });
+            return;
+          }
+          const parsed = StoryboardSchema.safeParse(raw);
+          if (!parsed.success) {
+            narrationStore.getState().setLlmStatus(
+              "failed",
+              parsed.error.message
+            );
+            narrationStore.getState().appendDebugEvent({
+              kind: "llm-error",
+              summary: `provider storyboard rejected by schema: ${parsed.error.issues[0]?.message ?? "unknown"}`,
+              payload: { raw, error: parsed.error.message }
+            });
+            return;
+          }
+          const storyboard = parsed.data;
+          narrationStore.getState().setLlmStatus("idle");
+          narrationStore.getState().appendDebugEvent({
+            kind: "llm-response",
+            summary: summariseStoryboard(storyboard),
+            payload: { via: "storyboardProvider", storyboard }
+          });
+          engineRef.current?.execute(storyboard);
+          narrationStore.getState().appendDebugEvent({
+            kind: "storyboard-execute",
+            summary: `engine executing ${storyboard.steps.length} steps`,
+            payload: storyboard.steps.map((s) => ({
+              at_ms: s.at_ms,
+              type: s.action.type,
+              target: "target_block" in s.action ? s.action.target_block : void 0
+            }))
+          });
+        } catch (e) {
+          if (e.name === "AbortError") return;
+          narrationStore.getState().setLlmStatus("failed", e.message);
+          narrationStore.getState().appendDebugEvent({
+            kind: "llm-error",
+            summary: `provider threw: ${e.message.slice(0, 80)}`,
+            payload: e
+          });
+        }
+        return;
+      }
+      if (!llm) return;
       narrationStore.getState().setLlmStatus("in-flight");
       narrationStore.getState().appendDebugEvent({
         kind: "llm-request",
@@ -15973,7 +16025,7 @@ function TutorModeContainer({
         narrationStore.getState().setLlmStatus("idle");
         narrationStore.getState().appendDebugEvent({
           kind: "llm-response",
-          summary: `storyboard \u2713 ${result.storyboard.steps.length} steps \u2014 ${result.storyboard.reasoning.slice(0, 60)}`,
+          summary: summariseStoryboard(result.storyboard),
           payload: { raw: result.raw, storyboard: result.storyboard }
         });
         engineRef.current?.execute(result.storyboard);
@@ -16016,7 +16068,16 @@ function TutorModeContainer({
     return () => {
       if (debounceRef.current) clearTimeout(debounceRef.current);
     };
-  }, [currentChunk, llm, index, pageNumber, narrationStore, embeddingProvider, llmTimeoutMs]);
+  }, [
+    currentChunk,
+    llm,
+    storyboardProvider,
+    index,
+    pageNumber,
+    narrationStore,
+    embeddingProvider,
+    llmTimeoutMs
+  ]);
   useEffect28(() => {
     if (!currentChunk) return;
     const t = setTimeout(() => {
@@ -16206,6 +16267,15 @@ function TutorLoadingState({
     }
   );
 }
+function summariseStoryboard(sb) {
+  const stepCount = sb.steps.length;
+  const trimmedReasoning = (sb.reasoning ?? "").trim();
+  if (trimmedReasoning) {
+    return `storyboard \u2713 ${stepCount} steps \u2014 ${trimmedReasoning.slice(0, 60)}`;
+  }
+  const kinds = sb.steps.map((s) => s.action.type).join(" \u2192 ");
+  return `storyboard \u2713 ${stepCount} steps \u2014 ${kinds}`;
+}
 
 // src/director/transformers-embedding.ts
 var loaded = null;