@shival99/z-ui 2.3.9 → 2.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shival99/z-ui",
-  "version": "2.3.9",
+  "version": "2.3.11",
   "description": "Z-UI: Modern Angular UI Component Library - A comprehensive, high-performance design system built with Angular 22, featuring 40+ customizable components with dark mode, accessibility, and enterprise-ready features.",
   "keywords": [
     "angular",
@@ -36,6 +36,7 @@
     "url": "https://github.com/vuboi/z-ui/issues"
   },
   "peerDependencies": {
+    "@aiden0z/pptx-renderer": ">=1.2.4",
     "@angular/cdk": ">=22.0.0 <23.0.0",
     "@angular/common": ">=22.0.0 <23.0.0",
     "@angular/core": ">=22.0.0 <23.0.0",
@@ -53,6 +54,8 @@
     "@ng-icons/phosphor-icons": ">=33.0.0",
     "@ng-icons/tabler-icons": ">=33.0.0",
     "@ngx-translate/core": ">=17.0.0",
+    "@univerjs/preset-sheets-core": ">=0.25.1",
+    "@univerjs/presets": ">=0.25.1",
     "@tanstack/angular-virtual": ">=6.0.2",
     "@shival99/ngx-sonner": ">=3.0.0",
     "@tanstack/angular-table": ">=9.1.0",
@@ -74,6 +77,7 @@
     "class-variance-authority": ">=0.7.0",
     "clsx": ">=2.0.0",
     "dompurify": ">=3.0.0",
+    "docx-preview": ">=0.4.0",
     "echarts": ">=5.0.0",
     "exceljs": "^4.4.0",
     "file-saver": "^2.0.5",
@@ -92,9 +96,18 @@
     "xlsx": "^0.18.5"
   },
   "peerDependenciesMeta": {
+    "@aiden0z/pptx-renderer": {
+      "optional": true
+    },
     "@dayflow/blossom-color-picker-angular": {
       "optional": true
     },
+    "@univerjs/preset-sheets-core": {
+      "optional": true
+    },
+    "@univerjs/presets": {
+      "optional": true
+    },
     "@tanstack/angular-virtual": {
       "optional": true
     },
@@ -149,6 +162,9 @@
     "boneyard-js": {
       "optional": true
     },
+    "docx-preview": {
+      "optional": true
+    },
     "mammoth": {
       "optional": true
     },
@@ -183,6 +199,10 @@
       "types": "./types/shival99-z-ui-components-z-accordion.d.ts",
       "default": "./fesm2022/shival99-z-ui-components-z-accordion.mjs"
     },
+    "./components/z-audio-player": {
+      "types": "./types/shival99-z-ui-components-z-audio-player.d.ts",
+      "default": "./fesm2022/shival99-z-ui-components-z-audio-player.mjs"
+    },
     "./components/z-autocomplete": {
       "types": "./types/shival99-z-ui-components-z-autocomplete.d.ts",
       "default": "./fesm2022/shival99-z-ui-components-z-autocomplete.mjs"

package/types/shival99-z-ui-components-z-audio-player.d.ts

@@ -0,0 +1,46 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+
+declare class ZAudioPlayerComponent {
+    private readonly _destroyRef;
+    private _animationFrameId;
+    private _isSeeking;
+    constructor();
+    readonly zSrc: _angular_core.InputSignal<string>;
+    readonly zTitle: _angular_core.InputSignal<string>;
+    readonly zTags: _angular_core.InputSignal<readonly string[]>;
+    readonly zDownload: _angular_core.InputSignal<boolean>;
+    readonly zLoaded: _angular_core.OutputEmitterRef<void>;
+    readonly zError: _angular_core.OutputEmitterRef<Error>;
+    readonly zPlay: _angular_core.OutputEmitterRef<boolean>;
+    protected readonly audio: _angular_core.Signal<ElementRef<HTMLAudioElement>>;
+    protected readonly isPlaying: _angular_core.WritableSignal<boolean>;
+    protected readonly currentTime: _angular_core.WritableSignal<number>;
+    protected readonly duration: _angular_core.WritableSignal<number>;
+    protected readonly waveform: readonly [28, 42, 34, 56, 38, 66, 45, 32, 52, 72, 46, 58, 36, 78, 48, 64, 40, 30, 54, 70, 44, 60, 35, 50, 76, 42, 58, 38, 68, 46, 34, 56, 74, 40, 62, 36, 52, 70, 44, 30, 48, 64, 38, 58, 76, 42, 54, 34, 66, 46, 72, 40, 56, 32, 68, 48, 60, 36, 74, 44, 52, 30, 64, 42, 78, 46, 58, 34, 70, 40, 54, 32, 66, 48, 62, 38, 72, 44, 56, 30, 68, 42, 60, 36, 76, 46, 54, 34, 64, 40, 70, 48, 58, 32, 66, 44, 74, 38, 52, 30, 62, 46, 68, 36, 56, 78, 42, 60, 34, 72, 48, 54, 38, 66, 44, 76, 40, 58, 32, 70, 46, 62, 36, 74, 48, 56, 30, 64, 42, 68, 38, 52, 72, 44, 60, 34, 76, 46, 54, 32, 66, 40, 58, 74, 36, 62, 48, 70, 42, 56, 30, 68, 44, 60, 38, 74, 46, 54, 32, 66, 40, 58, 72, 36, 62, 48, 70, 42, 56, 34, 76, 44, 60, 38, 68, 46, 52, 30, 64, 42, 74, 36, 58, 48, 70, 40, 54, 32, 66, 44, 60, 38, 76, 46, 56, 34, 68, 42, 72, 48, 58];
+    protected readonly title: _angular_core.InputSignal<string>;
+    protected readonly tags: _angular_core.InputSignal<readonly string[]>;
+    protected readonly progress: _angular_core.Signal<number>;
+    protected readonly currentTimeLabel: _angular_core.Signal<string>;
+    protected readonly durationLabel: _angular_core.Signal<string>;
+    protected togglePlay(): Promise<void>;
+    protected onWaveformPointerDown(event: PointerEvent): void;
+    protected onWaveformPointerMove(event: PointerEvent): void;
+    protected onWaveformPointerUp(event: PointerEvent): void;
+    private _seekToPointerPosition;
+    protected onWaveformKeydown(event: KeyboardEvent): void;
+    protected onLoadedMetadata(): void;
+    protected onLoadStart(): void;
+    protected onTimeUpdate(): void;
+    protected onEnded(): void;
+    protected onError(): void;
+    protected onPlayStateChange(isPlaying: boolean): void;
+    private _seekToTime;
+    private _startPlaybackFrame;
+    private _stopPlaybackFrame;
+    private _formatTime;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZAudioPlayerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZAudioPlayerComponent, "z-audio-player", never, { "zSrc": { "alias": "zSrc"; "required": true; "isSignal": true; }; "zTitle": { "alias": "zTitle"; "required": false; "isSignal": true; }; "zTags": { "alias": "zTags"; "required": false; "isSignal": true; }; "zDownload": { "alias": "zDownload"; "required": false; "isSignal": true; }; }, { "zLoaded": "zLoaded"; "zError": "zError"; "zPlay": "zPlay"; }, never, never, true, never>;
+}
+
+export { ZAudioPlayerComponent };

package/types/shival99-z-ui-components-z-gallery.d.ts

@@ -4,8 +4,9 @@ import { ZIcon } from '@shival99/z-ui/components/z-icon';
 import { ClassValue } from 'clsx';
 import { LayoutConfig, ThemeConfig, ControlVisibilityConfig, GroupVisibilityConfig, AutoActionConfig, ViewerConfig, PdfJsViewerComponent } from 'ng2-pdfjs-viewer';
 import * as _shival99_z_ui_components_z_gallery from '@shival99/z-ui/components/z-gallery';
-import { SafeHtml } from '@angular/platform-browser';
-import { ZOverlayRef } from '@shival99/z-ui/components/z-overlay';
+import { BundledLanguage } from 'shiki';
+import { ZDynamicRef } from '@shival99/z-ui/services';
+export { ZGalleryOfficeRenderResult } from '@shival99/z-ui/services';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 
@@ -17,6 +18,7 @@ type ZGalleryPdfViewerCursor = 'select' | 'hand' | 'zoom';
 type ZGalleryPdfViewerScroll = 'vertical' | 'horizontal' | 'wrapped' | 'page';
 type ZGalleryPdfViewerSpread = 'none' | 'odd' | 'even';
 type ZGalleryPdfViewerPageMode = 'none' | 'thumbs' | 'bookmarks' | 'attachments';
+type ZGalleryDocumentPreviewKind = 'word' | 'excel' | 'powerpoint';
 interface ZGalleryPdfViewerConfig {
     viewerFolder?: string;
     locale?: string;
@@ -92,7 +94,6 @@ interface ZFileCategoryStyle {
     label: string;
     icon: string;
 }
-declare const FILE_CATEGORY_STYLES: Record<ZFileCategory, ZFileCategoryStyle>;
 interface ZGalleryControl {
     setMode: (mode: ZGalleryMode) => void;
     getMode: () => ZGalleryMode;
@@ -212,6 +213,22 @@ declare class ZGalleryComponent implements AfterViewInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryComponent, "z-gallery", ["zGallery"], { "zFiles": { "alias": "zFiles"; "required": false; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zColumns": { "alias": "zColumns"; "required": false; "isSignal": true; }; "zItemWidth": { "alias": "zItemWidth"; "required": false; "isSignal": true; }; "zLoading": { "alias": "zLoading"; "required": false; "isSignal": true; }; "zSkeletonRows": { "alias": "zSkeletonRows"; "required": false; "isSignal": true; }; "zSkeletonItems": { "alias": "zSkeletonItems"; "required": false; "isSignal": true; }; "zShowDownload": { "alias": "zShowDownload"; "required": false; "isSignal": true; }; "zShowPreview": { "alias": "zShowPreview"; "required": false; "isSignal": true; }; "zShowRemove": { "alias": "zShowRemove"; "required": false; "isSignal": true; }; "zPdfViewerConfig": { "alias": "zPdfViewerConfig"; "required": false; "isSignal": true; }; "zTrustedResourceOrigins": { "alias": "zTrustedResourceOrigins"; "required": false; "isSignal": true; }; "zShowModeToggle": { "alias": "zShowModeToggle"; "required": false; "isSignal": true; }; "zShowSearch": { "alias": "zShowSearch"; "required": false; "isSignal": true; }; "zServerSearch": { "alias": "zServerSearch"; "required": false; "isSignal": true; }; "zSearchDebounce": { "alias": "zSearchDebounce"; "required": false; "isSignal": true; }; "zSearchPlaceholder": { "alias": "zSearchPlaceholder"; "required": false; "isSignal": true; }; "zToggleSize": { "alias": "zToggleSize"; "required": false; "isSignal": true; }; "zTitle": { "alias": "zTitle"; "required": false; "isSignal": true; }; "zEmptyText": { "alias": "zEmptyText"; "required": false; "isSignal": true; }; "zEmptyIcon": { "alias": "zEmptyIcon"; "required": false; "isSignal": true; }; "zClass": { "alias": "zClass"; "required": false; "isSignal": true; }; "zSelectable": { "alias": "zSelectable"; "required": false; "isSignal": true; }; "zSelectedFiles": { "alias": "zSelectedFiles"; "required": false; "isSignal": true; }; }, { "zMode": "zModeChange"; "zSelectedFiles": "zSelectedFilesChange"; "zOnDownload": "zOnDownload"; "zOnPreview": "zOnPreview"; "zOnRemove": "zOnRemove"; "zSearchChange": "zSearchChange"; "zControl": "zControl"; "zSelectionChange": "zSelectionChange"; "zOnAction": "zOnAction"; }, never, never, true, never>;
 }
 
+declare class ZGalleryFileIconComponent {
+    readonly file: _angular_core.InputSignal<ZGalleryFile>;
+    readonly zSize: _angular_core.InputSignal<ZGallerySize>;
+    readonly zMode: _angular_core.InputSignal<ZGalleryMode>;
+    protected readonly imageError: _angular_core.WritableSignal<boolean>;
+    protected readonly isLoading: _angular_core.WritableSignal<boolean>;
+    protected readonly category: _angular_core.Signal<ZFileCategory>;
+    protected readonly style: _angular_core.Signal<_shival99_z_ui_components_z_gallery.ZFileCategoryStyle>;
+    protected readonly showThumbnail: _angular_core.Signal<boolean | "" | undefined>;
+    protected readonly containerClasses: _angular_core.Signal<string>;
+    protected onImageLoad(): void;
+    protected onImageError(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZGalleryFileIconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryFileIconComponent, "z-gallery-file-icon", never, { "file": { "alias": "file"; "required": true; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class ZGalleryItemComponent {
     readonly file: _angular_core.InputSignal<ZGalleryFile>;
     readonly zMode: _angular_core.InputSignal<ZGalleryMode>;
@@ -251,22 +268,6 @@ declare class ZGalleryItemComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryItemComponent, "z-gallery-item", never, { "file": { "alias": "file"; "required": true; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zShowDownload": { "alias": "zShowDownload"; "required": false; "isSignal": true; }; "zShowPreview": { "alias": "zShowPreview"; "required": false; "isSignal": true; }; "zShowRemove": { "alias": "zShowRemove"; "required": false; "isSignal": true; }; "zSelectable": { "alias": "zSelectable"; "required": false; "isSignal": true; }; "zSelected": { "alias": "zSelected"; "required": false; "isSignal": true; }; }, { "zOnDownload": "zOnDownload"; "zOnPreview": "zOnPreview"; "zOnRemove": "zOnRemove"; "zOnSelect": "zOnSelect"; }, never, never, true, never>;
 }
 
-declare class ZGalleryFileIconComponent {
-    readonly file: _angular_core.InputSignal<ZGalleryFile>;
-    readonly zSize: _angular_core.InputSignal<ZGallerySize>;
-    readonly zMode: _angular_core.InputSignal<ZGalleryMode>;
-    protected readonly imageError: _angular_core.WritableSignal<boolean>;
-    protected readonly isLoading: _angular_core.WritableSignal<boolean>;
-    protected readonly category: _angular_core.Signal<ZFileCategory>;
-    protected readonly style: _angular_core.Signal<_shival99_z_ui_components_z_gallery.ZFileCategoryStyle>;
-    protected readonly showThumbnail: _angular_core.Signal<boolean | "" | undefined>;
-    protected readonly containerClasses: _angular_core.Signal<string>;
-    protected onImageLoad(): void;
-    protected onImageError(event: Event): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZGalleryFileIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryFileIconComponent, "z-gallery-file-icon", never, { "file": { "alias": "file"; "required": true; "isSignal": true; }; "zSize": { "alias": "zSize"; "required": false; "isSignal": true; }; "zMode": { "alias": "zMode"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 declare class ZGalleryPreviewItemDirective {
     readonly zGalleryPreviewItem: _angular_core.InputSignal<ZGalleryFile>;
     readonly zGalleryPreviewFiles: _angular_core.InputSignal<ZGalleryFile[] | null>;
@@ -286,7 +287,6 @@ declare class ZGalleryPreviewItemDirective {
 
 declare class ZGalleryPreviewComponent {
     private readonly _document;
-    private readonly _sanitizer;
     readonly file: _angular_core.InputSignal<ZGalleryFile>;
     readonly files: _angular_core.InputSignal<ZGalleryFile[]>;
     readonly zShowRemove: _angular_core.InputSignal<boolean>;
@@ -302,7 +302,7 @@ declare class ZGalleryPreviewComponent {
     protected readonly isConverting: _angular_core.WritableSignal<boolean>;
     protected readonly conversionError: _angular_core.WritableSignal<string | null>;
     protected readonly previewError: _angular_core.WritableSignal<boolean>;
-    protected readonly docHtmlContent: _angular_core.WritableSignal<SafeHtml | null>;
+    protected readonly officeSource: _angular_core.WritableSignal<Blob | null>;
     protected readonly textContent: _angular_core.WritableSignal<string>;
     protected readonly pdfViewer: _angular_core.Signal<PdfJsViewerComponent | undefined>;
     private readonly _mediaLoaded;
@@ -310,8 +310,6 @@ declare class ZGalleryPreviewComponent {
     private readonly _minLoadingTime;
     constructor();
     private _loadFileContent;
-    private _loadDocx;
-    private _loadExcel;
     private _loadText;
     private _assertSuccessfulResponse;
     private _completeLoading;
@@ -325,9 +323,16 @@ declare class ZGalleryPreviewComponent {
     protected readonly pdfViewerConfig: _angular_core.Signal<ZGalleryPdfViewerConfig>;
     private _mergePdfViewerCss;
     protected readonly isVideo: _angular_core.Signal<boolean>;
+    protected readonly isAudio: _angular_core.Signal<boolean>;
     protected readonly isWordFile: _angular_core.Signal<boolean>;
     protected readonly isExcelFile: _angular_core.Signal<boolean>;
+    protected readonly isPowerpointFile: _angular_core.Signal<boolean>;
+    protected readonly documentPreviewKind: _angular_core.Signal<ZGalleryDocumentPreviewKind>;
+    protected readonly mediaUrl: _angular_core.Signal<string | null>;
     protected readonly isTextFile: _angular_core.Signal<boolean>;
+    protected readonly isCodeFile: _angular_core.Signal<boolean>;
+    protected readonly fileExtension: _angular_core.Signal<string>;
+    protected readonly codeLanguage: _angular_core.Signal<BundledLanguage>;
     protected readonly canPreview: _angular_core.Signal<boolean>;
     protected readonly formattedSize: _angular_core.Signal<string>;
     protected readonly imageTransform: _angular_core.Signal<string>;
@@ -343,6 +348,8 @@ declare class ZGalleryPreviewComponent {
     protected rotateRight(): void;
     protected onImageLoad(): void;
     protected onVideoLoad(): void;
+    protected onOfficeLoad(): void;
+    protected onOfficeError(message: string): void;
     protected onPdfLoad(): void;
     protected onMediaError(): void;
     protected download(): void;
@@ -354,29 +361,51 @@ declare class ZGalleryPreviewComponent {
 }
 
 declare class ZGalleryPreviewRef {
-    private readonly _overlayRef;
+    private readonly _dynamicRef;
     private _closed;
     componentInstance: ZGalleryPreviewComponent | null;
     readonly zAfterClose: EventEmitter<void>;
-    constructor(_overlayRef: ZOverlayRef | null);
+    constructor(_dynamicRef: ZDynamicRef<ZGalleryPreviewComponent> | null);
     close(): void;
+    markClosed(): void;
 }
 
 declare class ZGalleryPreviewService {
     private readonly _document;
-    private readonly _injector;
-    private readonly _overlayService;
-    private readonly _platformId;
-    private readonly _zIndexService;
+    private readonly _dynamicService;
     open(file: ZGalleryFile, options?: Omit<ZGalleryPreviewOptions, 'file'>): ZGalleryPreviewRef;
     open(options: ZGalleryPreviewOptions): ZGalleryPreviewRef;
-    private _createOverlay;
     private _normalizeOptions;
     private _handleDownload;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZGalleryPreviewService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ZGalleryPreviewService>;
 }
 
+declare class ZGalleryOfficePreviewComponent {
+    private readonly _destroyRef;
+    private readonly _renderService;
+    readonly zSource: _angular_core.InputSignal<Blob>;
+    readonly zKind: _angular_core.InputSignal<ZGalleryDocumentPreviewKind>;
+    readonly zLoaded: _angular_core.OutputEmitterRef<void>;
+    readonly zError: _angular_core.OutputEmitterRef<string>;
+    private readonly _host;
+    private _render;
+    private _renderedSource;
+    constructor();
+    private _render$;
+    private _dispose;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZGalleryOfficePreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryOfficePreviewComponent, "z-gallery-office-preview", never, { "zSource": { "alias": "zSource"; "required": true; "isSignal": true; }; "zKind": { "alias": "zKind"; "required": true; "isSignal": true; }; }, { "zLoaded": "zLoaded"; "zError": "zError"; }, never, never, true, never>;
+}
+
+declare class ZGalleryTextPreviewComponent {
+    readonly zContent: _angular_core.InputSignal<string>;
+    readonly zLanguage: _angular_core.InputSignal<string>;
+    protected readonly lines: _angular_core.Signal<string[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZGalleryTextPreviewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZGalleryTextPreviewComponent, "z-gallery-text-preview", never, { "zContent": { "alias": "zContent"; "required": true; "isSignal": true; }; "zLanguage": { "alias": "zLanguage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare const getFileCategory: (file: ZGalleryFile) => ZFileCategory;
 declare const formatFileSize: (bytes: number) => string;
 declare const isPreviewable: (file: ZGalleryFile) => boolean;
@@ -397,5 +426,7 @@ declare const zGalleryFileIconVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ZGalleryFileIconVariants = VariantProps<typeof zGalleryFileIconVariants>;
 
-export { FILE_CATEGORY_STYLES, ZGalleryComponent, ZGalleryFileIconComponent, ZGalleryItemComponent, ZGalleryPreviewComponent, ZGalleryPreviewItemDirective, ZGalleryPreviewRef, ZGalleryPreviewService, formatFileSize, getFileCategory, isImage, isPreviewable, zGalleryFileIconVariants, zGalleryItemVariants, zGalleryVariants };
-export type { ZFileCategory, ZFileCategoryStyle, ZGalleryActionEvent, ZGalleryActionType, ZGalleryControl, ZGalleryFile, ZGalleryFileIconVariants, ZGalleryItemVariants, ZGalleryMode, ZGalleryPdfViewerConfig, ZGalleryPdfViewerCursor, ZGalleryPdfViewerPageMode, ZGalleryPdfViewerScroll, ZGalleryPdfViewerSpread, ZGalleryPdfViewerZoom, ZGalleryPreviewItemOptions, ZGalleryPreviewOptions, ZGallerySelectionChange, ZGallerySize, ZGalleryToggleSize, ZGalleryVariants };
+declare const FILE_CATEGORY_STYLES: Record<ZFileCategory, ZFileCategoryStyle>;
+
+export { FILE_CATEGORY_STYLES, ZGalleryComponent, ZGalleryFileIconComponent, ZGalleryItemComponent, ZGalleryOfficePreviewComponent, ZGalleryPreviewComponent, ZGalleryPreviewItemDirective, ZGalleryPreviewRef, ZGalleryPreviewService, ZGalleryTextPreviewComponent, formatFileSize, getFileCategory, isImage, isPreviewable, zGalleryFileIconVariants, zGalleryItemVariants, zGalleryVariants };
+export type { ZFileCategory, ZFileCategoryStyle, ZGalleryActionEvent, ZGalleryActionType, ZGalleryControl, ZGalleryDocumentPreviewKind, ZGalleryFile, ZGalleryFileIconVariants, ZGalleryItemVariants, ZGalleryMode, ZGalleryPdfViewerConfig, ZGalleryPdfViewerCursor, ZGalleryPdfViewerPageMode, ZGalleryPdfViewerScroll, ZGalleryPdfViewerSpread, ZGalleryPdfViewerZoom, ZGalleryPreviewItemOptions, ZGalleryPreviewOptions, ZGallerySelectionChange, ZGallerySize, ZGalleryToggleSize, ZGalleryVariants };

package/types/shival99-z-ui-components-z-media-player.d.ts

@@ -1,7 +1,15 @@
+import * as _angular_platform_browser from '@angular/platform-browser';
 import * as _angular_core from '@angular/core';
 import { OnDestroy, ElementRef } from '@angular/core';
 import { ClassValue } from 'clsx';
+import { VariantProps } from 'class-variance-authority';
+import * as class_variance_authority_types from 'class-variance-authority/types';
 
+declare const zMediaPlayerVariants: (props?: ({
+    zLayout?: "default" | "theater" | "fullscreen" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type ZMediaPlayerVariants = VariantProps<typeof zMediaPlayerVariants>;
 interface ZMediaPlayerSubtitleTrack {
     label: string;
     src: string;
@@ -16,10 +24,45 @@ interface ZMediaPlayerPlaybackSpeed {
     label: string;
     value: number;
 }
-
+interface ZWebkitHTMLVideoElement extends HTMLVideoElement {
+    webkitSupportsPresentationMode?(mode: 'inline' | 'picture-in-picture'): boolean;
+    webkitPresentationMode?: 'inline' | 'picture-in-picture';
+    webkitSetPresentationMode?(mode: 'inline' | 'picture-in-picture'): void;
+}
+interface ZDocumentWithPiP extends Document {
+    pictureInPictureEnabled: boolean;
+    pictureInPictureElement: Element | null;
+    exitPictureInPicture(): Promise<void>;
+}
 type ZMediaPlayerSettingsPanel = 'main' | 'quality' | 'speed';
+/** One cue parsed from a WebVTT storyboard file (`00:00:00.000 --> 00:00:02.000` + `sprite.jpg#xywh=x,y,w,h`). */
+interface ZMediaPlayerThumbnailCue {
+    start: number;
+    end: number;
+    src: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Toggles which control bar groups are rendered. All default to `true`. */
+interface ZMediaPlayerControls {
+    play: boolean;
+    volume: boolean;
+    skip: boolean;
+    time: boolean;
+    timeline: boolean;
+    subtitles: boolean;
+    settings: boolean;
+    pip: boolean;
+    theater: boolean;
+    fullscreen: boolean;
+}
+
 declare class ZMediaPlayerComponent implements OnDestroy {
     private readonly _elementRef;
+    private readonly _ngZone;
+    private readonly _sanitizer;
     readonly class: _angular_core.InputSignal<ClassValue>;
     readonly zSrc: _angular_core.InputSignal<string>;
     readonly zSources: _angular_core.InputSignal<ZMediaPlayerSource[]>;
@@ -29,6 +72,12 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     readonly zMuted: _angular_core.InputSignal<boolean>;
     readonly zVolume: _angular_core.InputSignal<number>;
     readonly zSubtitles: _angular_core.InputSignal<ZMediaPlayerSubtitleTrack[]>;
+    /** URL to a WebVTT storyboard file powering the YouTube-style timeline hover preview. */
+    readonly zThumbnailsVtt: _angular_core.InputSignal<string>;
+    /** Toggles which control bar groups render. Unset groups default to visible. */
+    readonly zControls: _angular_core.InputSignal<Partial<ZMediaPlayerControls>>;
+    readonly zLoaded: _angular_core.OutputEmitterRef<void>;
+    readonly zError: _angular_core.OutputEmitterRef<Error | null>;
     readonly zPlay: _angular_core.OutputEmitterRef<boolean>;
     readonly zTimeUpdate: _angular_core.OutputEmitterRef<number>;
     readonly zVolumeChange: _angular_core.OutputEmitterRef<number>;
@@ -38,6 +87,7 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     readonly zQualityChange: _angular_core.OutputEmitterRef<ZMediaPlayerSource>;
     readonly videoElement: _angular_core.Signal<ElementRef<HTMLVideoElement> | undefined>;
     readonly timelineContainer: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
+    private readonly _settingsPopover;
     protected readonly isPlaying: _angular_core.WritableSignal<boolean>;
     protected readonly currentTime: _angular_core.WritableSignal<number>;
     protected readonly duration: _angular_core.WritableSignal<number>;
@@ -45,9 +95,13 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     protected readonly isMuted: _angular_core.WritableSignal<boolean>;
     protected readonly playbackSpeed: _angular_core.WritableSignal<number>;
     protected readonly activeSourceSrc: _angular_core.WritableSignal<string | null>;
+    private readonly _activeQualitySourceLabel;
     protected readonly showControls: _angular_core.WritableSignal<boolean>;
+    protected readonly isPointerOver: _angular_core.WritableSignal<boolean>;
     protected readonly isBuffering: _angular_core.WritableSignal<boolean>;
     protected readonly captionsEnabled: _angular_core.WritableSignal<boolean>;
+    protected readonly subtitleText: _angular_core.WritableSignal<string>;
+    protected readonly hasSubtitles: _angular_core.Signal<boolean>;
     protected readonly isTheaterMode: _angular_core.WritableSignal<boolean>;
     protected readonly isFullscreen: _angular_core.WritableSignal<boolean>;
     protected readonly isMiniplayer: _angular_core.WritableSignal<boolean>;
@@ -55,10 +109,13 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     protected readonly settingsPanel: _angular_core.WritableSignal<ZMediaPlayerSettingsPanel>;
     protected readonly isDragging: _angular_core.WritableSignal<boolean>;
     protected readonly bufferedProgress: _angular_core.WritableSignal<number>;
-    protected readonly progress: _angular_core.Signal<number>;
+    protected readonly progress: _angular_core.WritableSignal<number>;
     protected readonly playPauseFlash: _angular_core.WritableSignal<"play" | "pause" | null>;
     protected readonly hoverTimeLabel: _angular_core.WritableSignal<string | null>;
+    protected readonly hoverTime: _angular_core.WritableSignal<number | null>;
     protected readonly hoverX: _angular_core.WritableSignal<number>;
+    private readonly _thumbnailCues;
+    private readonly _positionedSubtitleTracks;
     protected readonly skipOverlayDirection: _angular_core.WritableSignal<"left" | "right" | null>;
     protected readonly skipOverlayValue: _angular_core.WritableSignal<number>;
     protected readonly skipOverlayPulse: _angular_core.WritableSignal<number>;
@@ -67,14 +124,23 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     private _controlsTimeout;
     private _flashTimeout;
     private _skipOverlayTimeout;
-    private _clickTimeout;
+    private _bufferAnimationFrame;
+    private _playbackAnimationFrame;
+    private _mouseMoveCleanup;
+    private _lastMouseMoveAt;
+    private _bufferedTarget;
     private _accumulatedSkip;
     protected readonly zClasses: _angular_core.Signal<string>;
     protected readonly currentTimeLabel: _angular_core.Signal<string>;
     protected readonly durationLabel: _angular_core.Signal<string>;
+    protected readonly controls: _angular_core.Signal<ZMediaPlayerControls>;
     protected readonly effectiveSrc: _angular_core.Signal<string>;
     protected readonly qualitySources: _angular_core.Signal<ZMediaPlayerSource[]>;
     protected readonly activeQualityLabel: _angular_core.Signal<string>;
+    protected readonly youtubeVideoId: _angular_core.Signal<string | null>;
+    protected readonly isYouTube: _angular_core.Signal<boolean>;
+    protected readonly youtubeEmbedUrl: _angular_core.Signal<_angular_platform_browser.SafeResourceUrl | null>;
+    protected readonly hoverThumbnailCue: _angular_core.Signal<ZMediaPlayerThumbnailCue | null>;
     constructor();
     ngOnDestroy(): void;
     private _initializeVideoState;
@@ -97,28 +163,38 @@ declare class ZMediaPlayerComponent implements OnDestroy {
     protected onLeavePiP(): void;
     protected onWebkitPresentationModeChanged(): void;
     protected toggleSubtitles(): void;
+    private _positionSubtitleCues;
+    private _updateSubtitleText;
     protected onPlayStateChange(playing: boolean): void;
     protected onTimeUpdate(): void;
     protected onDurationChange(): void;
+    protected onLoadedData(): void;
+    protected onVideoError(): void;
     protected onSeeking(seeking: boolean): void;
     protected updateBufferedProgress(): void;
+    private _setBufferedTarget;
+    private _startPlaybackProgressLoop;
+    private _stopPlaybackProgressLoop;
+    private _syncPlaybackProgress;
     protected onTimelineDragStart(event: MouseEvent): void;
     protected onTimelineHover(event: MouseEvent): void;
     protected onTimelineHoverEnd(): void;
+    private _loadThumbnailVtt;
+    private _parseThumbnailVtt;
+    private _parseVttTimestamp;
     private _updateTimeFromCoords;
     protected onMouseMove(): void;
     protected onMouseLeave(): void;
     private _resetControlsTimer;
-    protected onVideoClick(event: MouseEvent): void;
-    private _handleVideoDoubleClick;
+    protected onVideoClick(): void;
     protected triggerSkip(seconds: number, direction: 'left' | 'right'): void;
     private _triggerSkipOverlay;
     protected onKeyDown(event: KeyboardEvent): void;
     protected toggleSettings(): void;
     private _formatTime;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ZMediaPlayerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZMediaPlayerComponent, "z-media-player", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zSrc": { "alias": "zSrc"; "required": true; "isSignal": true; }; "zSources": { "alias": "zSources"; "required": false; "isSignal": true; }; "zPoster": { "alias": "zPoster"; "required": false; "isSignal": true; }; "zAutoplay": { "alias": "zAutoplay"; "required": false; "isSignal": true; }; "zLoop": { "alias": "zLoop"; "required": false; "isSignal": true; }; "zMuted": { "alias": "zMuted"; "required": false; "isSignal": true; }; "zVolume": { "alias": "zVolume"; "required": false; "isSignal": true; }; "zSubtitles": { "alias": "zSubtitles"; "required": false; "isSignal": true; }; }, { "zPlay": "zPlay"; "zTimeUpdate": "zTimeUpdate"; "zVolumeChange": "zVolumeChange"; "zFullscreenChange": "zFullscreenChange"; "zTheaterModeChange": "zTheaterModeChange"; "zMiniplayerChange": "zMiniplayerChange"; "zQualityChange": "zQualityChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ZMediaPlayerComponent, "z-media-player", never, { "class": { "alias": "class"; "required": false; "isSignal": true; }; "zSrc": { "alias": "zSrc"; "required": true; "isSignal": true; }; "zSources": { "alias": "zSources"; "required": false; "isSignal": true; }; "zPoster": { "alias": "zPoster"; "required": false; "isSignal": true; }; "zAutoplay": { "alias": "zAutoplay"; "required": false; "isSignal": true; }; "zLoop": { "alias": "zLoop"; "required": false; "isSignal": true; }; "zMuted": { "alias": "zMuted"; "required": false; "isSignal": true; }; "zVolume": { "alias": "zVolume"; "required": false; "isSignal": true; }; "zSubtitles": { "alias": "zSubtitles"; "required": false; "isSignal": true; }; "zThumbnailsVtt": { "alias": "zThumbnailsVtt"; "required": false; "isSignal": true; }; "zControls": { "alias": "zControls"; "required": false; "isSignal": true; }; }, { "zLoaded": "zLoaded"; "zError": "zError"; "zPlay": "zPlay"; "zTimeUpdate": "zTimeUpdate"; "zVolumeChange": "zVolumeChange"; "zFullscreenChange": "zFullscreenChange"; "zTheaterModeChange": "zTheaterModeChange"; "zMiniplayerChange": "zMiniplayerChange"; "zQualityChange": "zQualityChange"; }, never, never, true, never>;
 }
 
 export { ZMediaPlayerComponent };
-export type { ZMediaPlayerPlaybackSpeed, ZMediaPlayerSource, ZMediaPlayerSubtitleTrack };
+export type { ZDocumentWithPiP, ZMediaPlayerControls, ZMediaPlayerPlaybackSpeed, ZMediaPlayerSettingsPanel, ZMediaPlayerSource, ZMediaPlayerSubtitleTrack, ZMediaPlayerThumbnailCue, ZMediaPlayerVariants, ZWebkitHTMLVideoElement };

package/types/shival99-z-ui-components-z-overlay.d.ts

@@ -172,21 +172,16 @@ declare class ZOverlayService {
  * Khoá scroll trang khi overlay toàn màn hình (modal/drawer) mở — thay cho
  * `scrollStrategies.block()` của CDK. Đếm tham chiếu để modal-trong-modal không mở khoá sớm.
  *
- * Chống layout shift theo hai bước:
- *
- * 1. Nếu trang vốn đã dành chỗ cho scrollbar (`html` hẹp hơn `window.innerWidth`), khoá kèm
- *    `scrollbar-gutter: stable` để chỗ đó KHÔNG bị nhả ra. Cách này giữ đúng chiều rộng layout
- *    cho cả nội dung trong flow lẫn element `position: fixed` (backdrop, drawer, toast...),
- *    nên không cần bù padding và không có gì dịch chuyển.
- * 2. Nếu trình duyệt vẫn nhả chỗ đó (không hỗ trợ `scrollbar-gutter`), ĐO đúng hiệu số chiều
- *    rộng của `<html>` trước/sau khi khoá rồi bù vào `padding-right` của body.
+ * Chống layout shift bằng cách đo gutter thật của `<html>` rồi bù vào body trước khi khoá overflow.
+ * Không giữ `scrollbar-gutter: stable` trong lúc overlay mở: fixed backdrop/panel khi đó bị giới
+ * hạn theo layout viewport và hở một dải scrollbar ở mép phải trên Windows.
  *
  * Lưu ý: phải đo bằng `getBoundingClientRect()` của `<html>`, không dùng `documentElement.clientWidth`
  * — với root element thuộc tính đó trả về kích thước viewport nên luôn cộng thêm chiều rộng scrollbar
  * khi `overflow: hidden`, dẫn tới bù thừa và làm UI co lại đúng bằng chiều rộng scrollbar.
  *
- * Hiệu số còn được ghi ra biến CSS `--z-scroll-lock-gutter` (0px khi không nhả) để app bù thêm cho
- * element `position: fixed` của riêng mình trong trường hợp 2.
+ * Hiệu số được ghi ra biến CSS `--z-scroll-lock-gutter` để app bù thêm cho element `position: fixed`
+ * của riêng mình nếu cần.
  *
  * Vị trí scroll vẫn được lưu để khôi phục nếu ứng dụng thay đổi scroll programmatically trong lúc khoá.
  */

package/types/shival99-z-ui-services.d.ts

@@ -60,6 +60,8 @@ interface ZDynamicTemplateContext<TData, TResult> {
 interface ZDynamicOptions<TData = unknown> {
     /** Data injected into a component or exposed in a template context. */
     data?: TData;
+    /** Initial signal inputs applied before the first component change detection. */
+    inputs?: Record<string, unknown>;
     /** View container used as the logical parent of the attached portal. */
     viewContainerRef?: ViewContainerRef;
     /** Whether the overlay renders a backdrop. Defaults to `true`. */
@@ -70,6 +72,8 @@ interface ZDynamicOptions<TData = unknown> {
     panelClass?: string;
     /** Locks page scroll while the overlay is open. Defaults to `true`. */
     scrollLock?: boolean;
+    /** Whether the overlay pane itself can scroll. Defaults to `true`. */
+    scrollable?: boolean;
     /** Close when the backdrop is clicked. Defaults to `true`. */
     closeOnBackdropClick?: boolean;
     /** Close when Escape is pressed. Defaults to `true`. */
@@ -115,6 +119,7 @@ declare class ZDynamicRef<T = unknown, TResult = unknown> {
     isClosed(): boolean;
     /** Closes the overlay and emits the optional result exactly once. */
     close(result?: TResult): void;
+    private _getContentElements;
     /**
      * @deprecated Không còn tác dụng — overlay tự do giờ luôn dùng vị trí toàn cục (global),
      * tự canh giữa bằng CSS, không còn "chiến lược định vị" nào cần cập nhật lại. Giữ lại method
@@ -123,6 +128,8 @@ declare class ZDynamicRef<T = unknown, TResult = unknown> {
     updatePosition(): void;
     /** Updates the overlay pane dimensions. */
     updateSize(width?: string, height?: string): void;
+    /** Applies an input after the component has been attached. */
+    setInput(name: string, value: unknown): void;
     /** @internal Used by the service after attaching a component portal. */
     attachComponentRef(componentRef: ComponentRef<T>): void;
 }
@@ -325,6 +332,21 @@ declare class ZExcelService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ZExcelService>;
 }
 
+interface ZGalleryOfficeRenderResult {
+    dispose: () => void;
+}
+
+declare class ZGalleryOfficeRenderService {
+    renderDoc(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    renderSheet(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    renderSlide(container: HTMLElement, blob: Blob): Promise<ZGalleryOfficeRenderResult>;
+    private _toUniverWorkbook;
+    private _toUniverCellData;
+    private _observeDocxZoom;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ZGalleryOfficeRenderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ZGalleryOfficeRenderService>;
+}
+
 type ZHttpParamsType<T> = {
     [K in keyof T]: string | number | boolean | ReadonlyArray<string | number | boolean>;
 };
@@ -728,6 +750,7 @@ declare function zStripLegacyScopedCacheKey(key: string): string;
 
 /** Injection token for data passed to a dynamic component or template. */
 declare const Z_DYNAMIC_DATA: InjectionToken<unknown>;
+declare const Z_DYNAMIC_ANIMATION_DURATION = 150;
 
 declare const Z_EXCEL_COLORS: {
     readonly 'green-50': "FFF0FDF4";
@@ -807,5 +830,5 @@ interface ZTranslateI18nConfig {
 }
 declare const Z_LANG_CACHE_KEY = "Z_LANGUAGE";
 
-export { ZCacheService, ZDynamicRef, ZDynamicService, ZExcelService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_CACHE_DEFAULT_PREFIX, Z_CACHE_SCOPE_SEPARATOR, Z_DB_SCOPE_SEPARATOR, Z_DEFAULT_THEME, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_STORAGE_SCOPE_FALLBACK, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildLegacyScopedCacheKey, zBuildLegacyScopedDbName, zBuildScopedCacheKey, zBuildScopedDbName, zConfigureStorageAppName, zGetStorageAppName, zNormalizeStorageAppName, zStripLegacyScopedCacheKey, zStripScopedCacheKey };
-export type { ZCacheConfig, ZCacheEntry, ZDynamicContent, ZDynamicOptions, ZDynamicResult, ZDynamicTemplateContext, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbGetOptions, ZIndexDbSetOptions, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZThemePreferences, ZTranslateConfig, ZTranslateI18nConfig };
+export { ZCacheService, ZDynamicRef, ZDynamicService, ZExcelService, ZGalleryOfficeRenderService, ZHttpAbstractService, ZIndexDbService, ZOverlayContainerService, ZOverlayZIndexService, ZSubjectService, ZThemeService, ZTranslateService, Z_CACHE_DEFAULT_PREFIX, Z_CACHE_SCOPE_SEPARATOR, Z_DB_SCOPE_SEPARATOR, Z_DEFAULT_THEME, Z_DYNAMIC_ANIMATION_DURATION, Z_DYNAMIC_DATA, Z_EXCEL_BORDER_THIN, Z_EXCEL_CHAR_WIDTH_MAP, Z_EXCEL_COLORS, Z_EXCEL_DEFAULT_CONFIG, Z_EXCEL_FONT_MULTIPLIERS, Z_EXCEL_WIDTH_LIMITS, Z_HTTP_DEFAULT_CONFIG, Z_INDEXDB_BATCH_SIZE, Z_INDEXDB_DEFAULT_CONFIG, Z_INDEXDB_MAX_VERSION, Z_LANG_CACHE_KEY, Z_LANG_TO_LOCALE, Z_STORAGE_SCOPE_FALLBACK, Z_THEME_CONFIG, Z_THEME_CSS_MAP, Z_THEME_PREFERENCES_CACHE_KEY, zBuildLegacyScopedCacheKey, zBuildLegacyScopedDbName, zBuildScopedCacheKey, zBuildScopedDbName, zConfigureStorageAppName, zGetStorageAppName, zNormalizeStorageAppName, zStripLegacyScopedCacheKey, zStripScopedCacheKey };
+export type { ZCacheConfig, ZCacheEntry, ZDynamicContent, ZDynamicOptions, ZDynamicResult, ZDynamicTemplateContext, ZExcelAlign, ZExcelCell, ZExcelCellContext, ZExcelColumnConfig, ZExcelConfig, ZExcelDefaultConfig, ZExcelExportOptions, ZExcelExportResult, ZExcelFontConfig, ZExcelFromTableConfig, ZExcelHeaderColors, ZExcelHeaderContext, ZExcelSheetSource, ZExcelTableColumnConfig, ZExcelTableHeaderConfig, ZExcelToastHandler, ZGalleryOfficeRenderResult, ZHttpBaseOptions, ZHttpCacheEntry, ZHttpConfig, ZHttpContentType, ZHttpError, ZHttpNetworkCheck, ZHttpOptions, ZHttpParamsType, ZIndexDbConfig, ZIndexDbGetOptions, ZIndexDbSetOptions, ZIndexDbStoreConfig, ZTableToExcelColumn, ZThemeConfig, ZThemeName, ZThemePreferences, ZTranslateConfig, ZTranslateI18nConfig };