@xiboplayer/schedule 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiboplayer/schedule",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Complete scheduling solution: campaigns, dayparting, interrupts, and overlays",
   "type": "module",
   "main": "./src/index.js",
@@ -12,7 +12,7 @@
     "./overlays": "./src/overlays.js"
   },
   "dependencies": {
-    "@xiboplayer/utils": "0.7.0"
+    "@xiboplayer/utils": "0.7.1"
   },
   "devDependencies": {
     "vitest": "^2.0.0"

package/src/index.d.ts

@@ -17,5 +17,6 @@ export class ScheduleManager {
 export const scheduleManager: ScheduleManager;
 
 export function calculateTimeline(queue: Array<{layoutId: string, duration: number}>, queuePosition: number, options?: any): any[];
+export function parseLayoutFile(f: string | number): number;
 export function parseLayoutDuration(xlf: string, videoDurations?: Map<string, number> | null): { duration: number; isDynamic: boolean };
 export function buildScheduleQueue(schedule: any, durations: Map<string, number>): any[];

package/src/index.js

@@ -27,4 +27,4 @@ export { OverlayScheduler } from './overlays.js';
  * Offline timeline calculator — duration parser + timeline simulator
  * @module @xiboplayer/schedule/timeline
  */
-export { calculateTimeline, parseLayoutDuration, buildScheduleQueue } from './timeline.js';
+export { calculateTimeline, parseLayoutDuration, parseLayoutFile, buildScheduleQueue } from './timeline.js';

package/src/schedule.js

@@ -6,7 +6,7 @@
 
 import { createLogger } from '@xiboplayer/utils';
 import { evaluateCriteria } from './criteria.js';
-import { buildScheduleQueue } from './timeline.js';
+import { buildScheduleQueue, parseLayoutFile } from './timeline.js';
 
 const log = createLogger('Schedule');
 
@@ -63,7 +63,7 @@ export class ScheduleManager {
     const globalDeps = this.schedule.dependants || [];
 
     const addLayout = (layout) => {
-      const id = parseInt(String(layout.file || layout.id).replace('.xlf', ''), 10);
+      const id = parseLayoutFile(layout.file || layout.id);
       const deps = [...globalDeps, ...(layout.dependants || [])];
       if (deps.length > 0) map.set(id, deps);
     };
@@ -691,6 +691,31 @@ export class ScheduleManager {
    * @param {Object} [options]
    * @returns {{ layoutId: string, duration: number } | null}
    */
+  /**
+   * Get current queue position.
+   * @returns {number}
+   */
+  getQueuePosition() {
+    return this._queuePosition;
+  }
+
+  /**
+   * Rewind the queue by N positions (wraps around).
+   * Used by advanceToPreviousLayout to go back in the schedule.
+   * @param {number} steps - Number of positions to rewind
+   * @param {Map<string, number>} durations
+   * @param {Object} [options]
+   * @returns {{ layoutId: string, duration: number } | null}
+   */
+  rewindQueue(steps, durations, options = {}) {
+    const { queue } = this.getScheduleQueue(durations, options);
+    if (queue.length === 0) return null;
+    this._queuePosition = (this._queuePosition - steps + queue.length * steps) % queue.length;
+    const entry = queue[this._queuePosition];
+    this._queuePosition = (this._queuePosition + 1) % queue.length;
+    return entry;
+  }
+
   peekNextInQueue(durations, options = {}) {
     const { queue } = this.getScheduleQueue(durations, options);
     if (queue.length === 0) return null;

package/src/timeline.js

@@ -27,6 +27,15 @@
  * @param {Map<string, number>|null} [videoDurations=null] - Optional map of fileId → probed duration in seconds
  * @returns {{ duration: number, isDynamic: boolean }} Duration in seconds and whether any widget has useDuration=0
  */
+/**
+ * Extract numeric layout ID from a schedule filename like "123.xlf" or "123"
+ * @param {string|number} f - Layout file reference
+ * @returns {number}
+ */
+export function parseLayoutFile(f) {
+  return parseInt(String(f).replace('.xlf', ''), 10);
+}
+
 export function parseLayoutDuration(xlfXml, videoDurations = null) {
   const doc = new DOMParser().parseFromString(xlfXml, 'text/xml');
   const layoutEl = doc.querySelector('layout');