taleem-player 0.7.3-rc → 1.0.1

package/README.md

@@ -5,11 +5,12 @@
      alt="Taleem Player — JSON to Web Presentations"
      width="100%" />
 
-**Taleem Player** converts **JSON slide data** into **web-based presentations**.
+**Taleem Player** converts **Taleem JSON slide data** into **web-based presentations**.
 
-It renders the *same JSON* in multiple ways using different display modes.
+It renders the *same taleem JSON* in multiple ways using different display modes.
 
-> ⚠️ Work in progress — expect minor bugs, **no API breakages**.
+> **Stable 1.0 — API frozen.**  
+> Internal improvements may continue without breaking public contracts.
 
 ---
 
@@ -93,21 +94,30 @@ player.renderAt(12.5);
 | Use case        | Preview / Edit | Playback       |
 
 > ⚠️ Player Mode requires **valid, ordered timings**.
-> The library does not auto-correct or guess timings.
+> The library does not auto-correct or guess timing errors.
 
 ---
 
 ## Utilities (Runtime-safe)
 
+
+These **Utilities (Runtime-safe)** are exported :
+
 ```js
-import { assignMockTimings, resolveAssetPaths } from "taleem-player";
+import {
+  assignMockTimings,
+  resolveAssetPaths,
+  resolveBackground,
+  getDeckEndTime
+} from "taleem-player";
 ```
 
 * `assignMockTimings(deck, seconds)`
 * `resolveAssetPaths(deck, basePath)`
 * `resolveBackground(deck, basePath)`
+* `getDeckEndTime(deck)`
 
-These helpers prepare decks for real usage.
+These helpers prepare decks for real usage and runtime playback.
 
 ---
 
@@ -120,7 +130,7 @@ import "taleem-player/css/light";
 import "taleem-player/css/paper";
 ```
 
-CSS controls layout and visual behavior.
+CSS must be imported explicitly by the host app.
 All modes share the same styling system.
 
 ---
@@ -129,17 +139,17 @@ All modes share the same styling system.
 
 * create slides
 * edit JSON
-* manage playback or time
-* handle audio / narration
-* validate automatically
+* manage clocks or media playback
+* handle audio or narration
+* auto-validate or repair data
 
-Those belong to the **application layer**.
+Those responsibilities belong to the **application layer**.
 
 ---
 
 ## Status
 
-**Release Candidate — API stable**
+**Stable — Version 1.0**
 
 ---
 

package/dist/taleem-player.esm.js

@@ -785,10 +785,19 @@ function resolveBackground2(deck, ASSET_BASE) {
   }
   return deck;
 }
+
+// src/utils/getDeckEndTime.js
+function getDeckEndTime(deck) {
+  if (!deck || !deck.deck || deck.deck.length === 0) {
+    return 0;
+  }
+  return deck.deck[deck.deck.length - 1].end;
+}
 export {
   assignMockTimings,
   createTaleemBrowser,
   createTaleemPlayer,
+  getDeckEndTime,
   resolveAssetPaths,
   resolveBackground2 as resolveBackground
 };

package/dist/taleem-player.umd.js

@@ -23,6 +23,7 @@ var TaleemPlayer = (() => {
     assignMockTimings: () => assignMockTimings,
     createTaleemBrowser: () => createTaleemBrowser,
     createTaleemPlayer: () => createTaleemPlayer,
+    getDeckEndTime: () => getDeckEndTime,
     resolveAssetPaths: () => resolveAssetPaths,
     resolveBackground: () => resolveBackground2
   });
@@ -814,5 +815,13 @@ var TaleemPlayer = (() => {
     }
     return deck;
   }
+
+  // src/utils/getDeckEndTime.js
+  function getDeckEndTime(deck) {
+    if (!deck || !deck.deck || deck.deck.length === 0) {
+      return 0;
+    }
+    return deck.deck[deck.deck.length - 1].end;
+  }
   return __toCommonJS(index_exports);
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taleem-player",
-  "version": "0.7.3-rc",
+  "version": "1.0.1",
   "type": "module",
   "main": "./dist/taleem-player.umd.js",
   "module": "./dist/taleem-player.esm.js",
@@ -12,7 +12,6 @@
     "./validate": {
       "import": "./dist/validation/validateDeckV1.js"
     },
-
     "./schema": {
       "import": "./dist/validation/zodDeckV1.js"
     },