taleem-player 0.0.1

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "taleem-player",
+  "version": "0.0.1",
+  "description": "",
+  "main": "index.js",
+  "directories": {
+    "test": "tests"
+  },
+  "scripts": {
+    "test": "vitest"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "vitest": "^4.0.16"
+  }
+}

package/src/Player.js

@@ -0,0 +1,52 @@
+import { slideTemplates } from "./templates/index.js";
+
+export class Player {
+  constructor(deck) {
+    this.deck = deck;
+    this.slides = deck.deck;
+  }
+
+  // ===== OLD (kept for later timeline mode)
+  getSlideAt(time) {
+    return this.slides.find(
+      s => time >= s.start && time <= s.end
+    );
+  }
+
+  getFrame(time) {
+    const slide = this.getSlideAt(time);
+    if (!slide) return null;
+
+    return this._buildFrame(slide, time);
+  }
+
+  // ===== NEW (for manual navigation)
+  getFrameByIndex(index) {
+    const slide = this.slides[index];
+    if (!slide) return null;
+
+    // use slide.start to reveal everything
+    return this._buildFrame(slide, slide.end);
+  }
+
+  // ===== shared internal logic
+  _buildFrame(slide, time) {
+    const template = slideTemplates[slide.type];
+    if (!template) {
+      throw new Error(`Unsupported slide type: ${slide.type}`);
+    }
+
+    const visibleData = slide.data.filter(
+      item => item.showAt === undefined || item.showAt <= time
+    );
+
+    return {
+      type: slide.type,
+      regions: template.group(visibleData),
+      meta: {
+        start: slide.start,
+        end: slide.end
+      }
+    };
+  }
+}

package/src/index.js

@@ -0,0 +1 @@
+export { Player } from "./Player.js";

package/src/templates/barChart.js

@@ -0,0 +1,14 @@
+export const barChart = {
+    group(data) {
+      return {
+        title: data.find(d => d.name === "title")?.content ?? "",
+        bars: data
+          .filter(d => d.name === "bar")
+          .map(d => ({
+            label: d.label,
+            value: d.value
+          }))
+      };
+    }
+  };
+  

package/src/templates/bulletList.js

@@ -0,0 +1,10 @@
+export const bulletList = {
+    group(data) {
+      return {
+        bullets: data
+          .filter(d => d.name === "bullet")
+          .map(d => d.content)
+      };
+    }
+  };
+  

package/src/templates/eq.js

@@ -0,0 +1,26 @@
+
+export const eq = {
+    group(data) {
+      const lines = [];
+      let current = null;
+  
+      for (const item of data) {
+        if (!item.type.startsWith("sp")) {
+          current = {
+            type: item.type,
+            content: item.content,
+            spItems: []
+          };
+          lines.push(current);
+        } else if (current) {
+          current.spItems.push({
+            type: item.type,
+            content: item.content
+          });
+        }
+      }
+  
+      return { lines };
+    }
+  };
+  

package/src/templates/imageSlide.js

@@ -0,0 +1,10 @@
+
+export const imageSlide = {
+    group(data) {
+      const img = data.find(d => d.name === "image");
+      return {
+        image: img?.content ?? null
+      };
+    }
+  };
+  

package/src/templates/index.js

@@ -0,0 +1,16 @@
+
+import { titleSlide } from "./titleSlide.js";
+import { barChart } from "./barChart.js";
+import { bulletList } from "./bulletList.js";
+import { twoColumnText } from "./twoColumnText.js";
+import { eq } from "./eq.js";
+import { imageSlide } from "./imageSlide.js";
+
+export const slideTemplates = {
+  titleSlide,
+  bulletList,
+  twoColumnText,
+  eq,
+  barChart,
+  imageSlide
+};

package/src/templates/titleSlide.js

@@ -0,0 +1,8 @@
+export const titleSlide = {
+    group(data) {
+      return {
+        title: data.find(d => d.name === "title")?.content ?? ""
+      };
+    }
+  };
+  

package/src/templates/twoColumnText.js

@@ -0,0 +1,11 @@
+
+export const twoColumnText = {
+    group(data) {
+      return {
+        title: data.find(d => d.name === "title")?.content ?? "",
+        left: data.filter(d => d.name === "left").map(d => d.content),
+        right: data.filter(d => d.name === "right").map(d => d.content)
+      };
+    }
+  };
+  

package/tests/fixtures/demoDeck.json

@@ -0,0 +1,22 @@
+{
+  "version": "deck-v1",
+  "name": "demo-minimal",
+  "deck": [
+    {
+      "start": 0,
+      "end": 10,
+      "type": "titleSlide",
+      "data": [
+        { "name": "title", "content": "Angles and Transversals", "showAt": 0 }
+      ]
+    },
+    {
+      "start": 10,
+      "end": 20,
+      "type": "titleSlide",
+      "data": [
+        { "name": "title", "content": "Parallel Lines and Transversals", "showAt": 0 }
+      ]
+    }
+  ]
+}

package/tests/player.basic.test.js

@@ -0,0 +1,13 @@
+import { describe, it, expect } from "vitest";
+import { Player } from "../src/Player.js";
+import demoDeck from "./fixtures/demoDeck.json";
+
+describe("Player basic behavior", () => {
+  it("renders first slide by index", () => {
+    const player = new Player(demoDeck);
+    const frame = player.getFrameByIndex(0);
+
+    expect(frame.type).toBe("titleSlide");
+    expect(frame.regions.title).toBe("Angles and Transversals");
+  });
+});

package/tests/player.eq.test.js

@@ -0,0 +1,28 @@
+import { describe, it, expect } from "vitest";
+import { Player } from "../src/Player.js";
+
+const eqDeck = {
+  version: "deck-v1",
+  deck: [
+    {
+      start: 0,
+      end: 10,
+      type: "eq",
+      data: [
+        { type: "math", content: "E = mc^2", showAt: 0 },
+        { type: "spText", content: "Einstein" },
+        { type: "text", content: "Final", showAt: 5 }
+      ]
+    }
+  ]
+};
+
+describe("EQ grouping", () => {
+  it("attaches spItems to previous line", () => {
+    const player = new Player(eqDeck);
+    const frame = player.getFrameByIndex(0);
+
+    expect(frame.regions.lines.length).toBe(2);
+    expect(frame.regions.lines[0].spItems.length).toBe(1);
+  });
+});