@xiboplayer/renderer 0.5.16 → 0.5.18

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@xiboplayer/renderer",
-  "version": "0.5.16",
+  "version": "0.5.18",
   "description": "RendererLite - Fast, efficient XLF layout rendering engine",
   "type": "module",
   "main": "./src/index.js",
+  "types": "./src/index.d.ts",
   "exports": {
     ".": "./src/index.js",
     "./renderer-lite": "./src/renderer-lite.js",
@@ -12,8 +13,8 @@
   "dependencies": {
     "nanoevents": "^9.1.0",
     "pdfjs-dist": "^4.10.38",
-    "@xiboplayer/cache": "0.5.16",
-    "@xiboplayer/utils": "0.5.16"
+    "@xiboplayer/utils": "0.5.18",
+    "@xiboplayer/cache": "0.5.18"
   },
   "devDependencies": {
     "vitest": "^2.0.0",

package/src/index.d.ts

@@ -0,0 +1,74 @@
+export const VERSION: string;
+
+export interface RendererConfig {
+  cmsUrl: string;
+  hardwareKey: string;
+}
+
+export interface RendererOptions {
+  getMediaUrl?: (fileId: number) => Promise<string>;
+  getWidgetHtml?: (widget: any) => Promise<string | { url: string; fallback?: string }>;
+  logLevel?: string;
+}
+
+export class LayoutPool {
+  layouts: Map<number, any>;
+  maxSize: number;
+  hotLayoutId: number | null;
+  has(layoutId: number): boolean;
+  get(layoutId: number): any | undefined;
+  add(layoutId: number, entry: any): void;
+  clearWarmNotIn(keepIds: Set<number>): number;
+  makeHot(layoutId: number): void;
+  remove(layoutId: number): void;
+  clear(): void;
+}
+
+export class RendererLite {
+  constructor(config: RendererConfig, container: HTMLElement, options?: RendererOptions);
+
+  config: RendererConfig;
+  container: HTMLElement;
+  options: RendererOptions;
+  currentLayout: any;
+  currentLayoutId: number | null;
+  regions: Map<string, any>;
+  layoutPool: LayoutPool;
+  activeOverlays: Map<number, any>;
+  scaleFactor: number;
+  offsetX: number;
+  offsetY: number;
+
+  on(event: string, callback: (...args: any[]) => void): () => void;
+  emit(event: string, ...args: any[]): void;
+
+  renderLayout(xlfXml: string, layoutId: number): Promise<void>;
+  stopCurrentLayout(): void;
+  preloadLayout(xlfXml: string, layoutId: number): Promise<boolean>;
+  hasPreloadedLayout(layoutId: number): boolean;
+
+  renderOverlay(xlfXml: string, layoutId: number, priority?: number): Promise<void>;
+  stopOverlay(layoutId: number): void;
+  stopAllOverlays(): void;
+  getActiveOverlays(): number[];
+
+  navigateToWidget(targetWidgetId: string): void;
+  nextWidget(regionId?: string): void;
+  previousWidget(regionId?: string): void;
+
+  pause(): void;
+  resume(): void;
+  isPaused(): boolean;
+  resumeRegionMedia?(regionId: string): void;
+
+  parseXlf(xlfXml: string): any;
+  parseWidget(mediaEl: Element): any;
+
+  calculateScale(layout: any): void;
+  rescaleRegions(): void;
+
+  updateLayoutDuration(): void;
+  checkLayoutComplete(): void;
+
+  cleanup(): void;
+}

package/src/renderer-lite.js

@@ -1766,6 +1766,9 @@ export class RendererLite {
       return;
     }
 
+    // Don't start next widget if layout has already ended (race with layout timer)
+    if (this.layoutEndEmitted) return;
+
     region.currentIndex = nextIndex;
     playNext();
   }
@@ -2440,6 +2443,10 @@ export class RendererLite {
    * @param {number} layoutId - Layout ID
    * @returns {Promise<boolean>} true if preload succeeded, false on failure
    */
+  hasPreloadedLayout(layoutId) {
+    return this.layoutPool.has(layoutId);
+  }
+
   async preloadLayout(xlfXml, layoutId) {
     // Don't preload if already in pool
     if (this.layoutPool.has(layoutId)) {
@@ -2757,8 +2764,10 @@ export class RendererLite {
     // Wait for widgets to be ready then start layout timer
     this.startLayoutTimerWhenReady(layoutId, preloaded.layout);
 
-    // Schedule next preload
-    this._scheduleNextLayoutPreload(preloaded.layout);
+    // Schedule next preload (unless updateLayoutDuration already did it)
+    if (!this.preloadTimer) {
+      this._scheduleNextLayoutPreload(preloaded.layout);
+    }
 
     this.log.info(`Swapped to preloaded layout ${layoutId} (instant transition)`);
   }