@prozilla-os/media-viewer 1.1.18 → 1.1.21

package/dist/main.d.ts

@@ -1,6 +1,253 @@
-import { App } from '@prozilla-os/core';
-import { VirtualFile } from '@prozilla-os/core';
-import { WindowProps } from '@prozilla-os/core';
+import { FC } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { Skin } from '@prozilla-os/skins';
+import { UaEventOptions } from 'react-ga4/types/ga4';
+
+/**
+ * An application that can be ran by ProzillaOS.
+ *
+ * Applications can be installed by adding them to {@link AppsConfig.apps}.
+ * @typeParam AppProps - The props of the {@link windowContent} of this app.
+ */
+declare class App<AppProps extends WindowProps = WindowProps> {
+    /**
+     * The display name of this application.
+     */
+    name: string;
+    /**
+     * The unique ID of this application.
+     */
+    id: string;
+    /**
+     * Main component that renders this app inside a window.
+     */
+    windowContent: FC<AppProps> | null;
+    /**
+     * Default options that get passed to the {@link App.windowContent} component.
+     */
+    windowOptions?: Partial<AppProps> & DefaultWindowOptions;
+    /**
+     * Description of this application.
+     */
+    description: string | null;
+    /**
+     * URL of the icon of this application.
+     */
+    iconUrl: string | null;
+    /**
+     * Defines what the app can handle and how it can be used elsewhere in the system.
+     */
+    role: string | null;
+    /**
+     * An array of file extensions that this application can interpret.
+     */
+    associatedExtensions: string[];
+    /**
+     * Determines whether the app is pinned by default.
+     * @default true
+     */
+    pinnedByDefault: boolean;
+    /**
+     * Determines whether the app is launched at startup.
+     * @default false
+     */
+    launchAtStartup: boolean;
+    /**
+     * The category the app belongs to.
+     */
+    category: typeof APP_CATEGORIES[number] | null;
+    /**
+     * Metadata of the app's package.
+     */
+    metadata: AppMetadata | null;
+    /**
+     * Determines whether a desktop icon is added to the default data.
+     * @default false
+     */
+    showDesktopIcon: boolean;
+    isActive: boolean;
+    isPinned?: boolean;
+    isInstalled: boolean;
+    constructor(name: App["name"], id: App["id"], windowContent: App<AppProps>["windowContent"], windowOptions?: Partial<AppProps> & DefaultWindowOptions);
+    /**
+     * Returns the component that renders the content of a window for this app.
+     */
+    WindowContent: (props: AppProps) => JSX_2.Element | null;
+    /**
+     * Sets the display name of this application.
+     */
+    setName(name: string): this;
+    /**
+     * Sets the description of this application.
+     */
+    setDescription(description: App["description"]): this;
+    /**
+     * Sets the URL of the icon of this application.
+     */
+    setIconUrl(iconUrl: App["iconUrl"]): this;
+    /**
+     * Sets the role of this application.
+     */
+    setRole(role: string | null): this;
+    /**
+     * Sets the associated extensions of this application.
+     */
+    setAssociatedExtensions(extensions: string[] | null): this;
+    /**
+     * Changes whether this application is pinned by default or not.
+     */
+    setPinnedByDefault(pinnedByDefault: boolean): this;
+    /**
+     * Changes whether this application is launched at startup or not.
+     */
+    setLaunchAtStartup(launchAtStartup: boolean): this;
+    /**
+     * Changes whether this application is installed by default or not.
+     */
+    setInstalled(installed: boolean): this;
+    /**
+     * Sets the category this application belongs to.
+     */
+    setCategory(category: typeof APP_CATEGORIES[number] | null): this;
+    /**
+     * Sets the metadata for this application.
+     */
+    setMetadata(metadata: AppMetadata | null): this;
+    /**
+     * Changes whether this application has a desktop icon in the default data.
+     */
+    setShowDesktopIcon(showDesktopIcon: boolean): this;
+    /**
+     * Sets the default options for the {@link App.windowContent} component.
+     */
+    setWindowOptions(windowOptions: Partial<AppProps> & DefaultWindowOptions): this;
+}
+
+declare const APP_CATEGORIES: readonly ["Business", "Developer tools", "Education", "Entertainment", "Food & dining", "Health & fitness", "Kids & family", "Lifestyle", "Media", "Medical", "Multimedia design", "Music", "Navigation & maps", "News & weather", "Personal finance", "Personalization", "Photo & video", "Productivity", "Security", "Shopping", "Social", "Sports", "Travel", "Utilities & tools"];
+
+declare interface AppMetadata {
+    name: string;
+    version: `${number}.${number}.${number}`;
+    author: string;
+}
+
+declare class AppsConfig {
+    apps: AppsConfigOptions["apps"];
+    static APP_ROLES: {
+        fileExplorer: string;
+        terminal: string;
+        textEditor: string;
+        settings: string;
+        mediaViewer: string;
+        browser: string;
+    };
+    constructor(options?: Partial<AppsConfigOptions>);
+    get installedApps(): App<WindowProps>[];
+    /**
+     * @param id - The ID of the app.
+     * @param includeUninstalled - Include apps that are not currently installed.
+     */
+    getAppById(id: string, includeUninstalled?: boolean): App | null;
+    /**
+     * Get the app associated with a file extension.
+     */
+    getAppByFileExtension(fileExtension: string): App | null;
+    /**
+     * Get the app with a specific role.
+     */
+    getAppByRole(role: string): App | null;
+    /**
+     * Get all applications (including uninstalled apps) that belong to a category.
+     */
+    getAppsByCategory(category: typeof APP_CATEGORIES[number]): App[];
+}
+
+declare interface AppsConfigOptions {
+    /**
+     * An array of applications.
+     */
+    apps: App<WindowProps>[];
+}
+
+/**
+ * A function that handles an event asynchronously.
+ * @typeParam T - A record of all events.
+ * @typeParam K - The event this function handles.
+ */
+declare type AsyncListener<T extends Record<keyof T, unknown[]>, K extends keyof T> = (...args: T[K]) => Promise<void>;
+
+declare interface DefaultWindowOptions {
+    size?: Vector2;
+    [key: string]: unknown;
+}
+
+declare class DesktopConfig {
+    defaultIconSize: DesktopConfigOptions["defaultIconSize"];
+    defaultIconDirection: DesktopConfigOptions["defaultIconDirection"];
+    constructor(options?: Partial<DesktopConfigOptions>);
+}
+
+declare interface DesktopConfigOptions {
+    /**
+     * The default size of the icons.
+     * @default 1
+     */
+    defaultIconSize: 0 | 1 | 2;
+    /**
+     * The defailt direction of the icons
+     * 0: vertical, 1: horizontal.
+     * @default 0
+     * */
+    defaultIconDirection: 0 | 1;
+}
+
+/**
+ * A simple event emitter.
+ * @typeParam T - A record of all events.
+ */
+declare class EventEmitter<T extends Record<keyof T, unknown[]>> {
+    #private;
+    /**
+     * Starts listening to an event.
+     * @param event - The event to listen to.
+     * @param listener - The function to call when the event is emitted.
+     * @returns The listener.
+     */
+    on<K extends keyof T>(event: K, listener: Listener<T, K>): Listener<T, K>;
+    /**
+     * Registers an event listener that is automatically removed when called.
+     * @param event - The event to listen to.
+     * @param listener - The function to call once the event is emitted.
+     * @returns The wrapped listener.
+     */
+    once<K extends keyof T>(event: K, listener: Listener<T, K>): Listener<T, K>;
+    /**
+     * Starts listening to an event.
+     * @param event - The event to listen to.
+     * @param listener - The function to call when the event is emitted.
+     * @returns The wrapped listener.
+     */
+    onAsync<K extends keyof T>(event: K, listener: AsyncListener<T, K>, onRejected?: Parameters<Promise<void>["catch"]>[0]): Listener<T, K>;
+    /**
+     * Removes an event listener.
+     * @param event - The event to remove the listener from.
+     * @param listener - The listener to remove.
+     */
+    off<K extends keyof T>(event: K, listener: Listener<T, K>): void;
+    /**
+     * Emits an event to all its listeners.
+     * @param event - The event to emit.
+     * @param args - The arguments to pass to the listeners.
+     */
+    emit<K extends keyof T>(event: K, ...args: T[K]): void;
+}
+
+/**
+ * A function that handles an event.
+ * @typeParam T - A record of all events.
+ * @typeParam K - The event this function handles.
+ */
+declare type Listener<T extends Record<keyof T, unknown[]>, K extends keyof T> = (...args: T[K]) => void;
 
 export declare const mediaViewer: App<MediaViewerProps>;
 
@@ -8,4 +255,773 @@ declare interface MediaViewerProps extends WindowProps {
     file?: VirtualFile;
 }
 
+declare class MiscConfig {
+    doubleClickDelay: MiscConfigOptions["doubleClickDelay"];
+    constructor(options?: Partial<MiscConfigOptions>);
+}
+
+declare interface MiscConfigOptions {
+    /**
+     * The maximum time between two clicks to register as a double click (in ms).
+     * @default 250
+     * */
+    doubleClickDelay: number;
+}
+
+declare class ModalsConfig {
+    defaultDialogSize: ModalsConfigOptions["defaultDialogSize"];
+    defaultFileSelectorSize: ModalsConfigOptions["defaultFileSelectorSize"];
+    static DIALOG_CONTENT_TYPES: {
+        closeButton: number;
+    };
+    constructor(options?: Partial<ModalsConfigOptions>);
+}
+
+declare interface ModalsConfigOptions {
+    /**
+     * Default size of a dialog box.
+     * @default new Vector2(400, 200)
+     */
+    defaultDialogSize: Vector2;
+    /**
+     * Default size of a file selector.
+     * @default new Vector2(700, 400)
+     */
+    defaultFileSelectorSize: Vector2;
+}
+
+declare type OptionalStringProperty = string | null | undefined;
+
+/**
+ * A wrapper for {@link localStorage} with additional functionality like compression and a size limit.
+ */
+declare class Storage_2 {
+    /**
+     * Enables compression of values stored in this storage.
+     * @default false
+     */
+    enableCompression: boolean;
+    /**
+     * The prefix to prepend to keys.
+     * @default undefined
+     */
+    prefix: string | undefined;
+    /**
+     * The maximum amount of bytes of a value in this storage.
+     */
+    static readonly MAX_BYTES = 5000000;
+    static readonly COMPRESSED_PREFIX = "\uE000";
+    static readonly UNCOMPRESSED_PREFIX = "\uE001";
+    /**
+     * Stores a key and value pair in this storage.
+     * @param key - The key to store.
+     * @param value - The value to store.
+     */
+    store(key: string, value: string): void;
+    /**
+     * Loads a value associated with the given key.
+     * @param key - The key of the item.
+     * @returns The value of the item.
+     */
+    load(key: string): string | null;
+    /**
+     * Replaces the key of an item if it exists.
+     * @param oldKey - The key to replace.
+     * @param newKey - The new key.
+     */
+    rename(oldKey: string, newKey: string): this;
+    /**
+     * Removes the item with the given key from this storage.
+     * @param key - The key of the item.
+     */
+    remove(key: string): this;
+    /**
+     * Clears all items stored in this storage.
+     */
+    clear(): this;
+    /**
+     * Returns the byte size of a key and value pair.
+     * @param key - The key of the item.
+     * @param value - The value of the item.
+     */
+    getItemByteSize(key: string, value: string): number;
+    getEncodedByteSize(string: string | null): number;
+    encode(string: string): {
+        result: string;
+        size: number;
+    };
+    decode(string: string): string;
+    setPrefix(prefix?: string): this;
+    static getByteSize(string: string | null): number;
+    static byteToKilobyte(bytes: number): number;
+}
+
+declare class SystemManager {
+    #private;
+    /** The name of the system. */
+    readonly systemName: string;
+    /** The tagline/short description of the system. */
+    readonly tagLine: string;
+    readonly skin: Skin;
+    readonly appsConfig: AppsConfig;
+    readonly desktopConfig: DesktopConfig;
+    readonly miscConfig: MiscConfig;
+    readonly modalsConfig: ModalsConfig;
+    readonly taskbarConfig: TaskbarConfig;
+    readonly trackingConfig: TrackingConfig;
+    readonly windowsConfig: WindowsConfig;
+    readonly virtualDriveConfig: VirtualDriveConfig;
+    readonly storage: Storage_2;
+    constructor({ systemName, tagLine, skin, desktopConfig, appsConfig, miscConfig, modalsConfig, taskbarConfig, trackingConfig, windowsConfig, virtualDriveConfig, }: SystemManagerParams);
+    private loadSkin;
+    getUptime(precision?: number): string;
+}
+
+declare interface SystemManagerParams {
+    systemName: SystemManager["systemName"] | null;
+    tagLine: SystemManager["tagLine"] | null;
+    skin?: SystemManager["skin"];
+    desktopConfig: DesktopConfig;
+    appsConfig: AppsConfig;
+    miscConfig: MiscConfig;
+    modalsConfig: ModalsConfig;
+    taskbarConfig: TaskbarConfig;
+    trackingConfig: TrackingConfig;
+    windowsConfig: WindowsConfig;
+    virtualDriveConfig: VirtualDriveConfig;
+}
+
+declare class TaskbarConfig {
+    height: TaskbarConfigOptions["height"];
+    constructor(options?: Partial<TaskbarConfigOptions>);
+}
+
+declare interface TaskbarConfigOptions {
+    /**
+     * Height of the taskbar in CSS pixels.
+     * @default 3 * 16
+     */
+    height: number;
+}
+
+declare class TrackingConfig {
+    enabled: TrackingConfigOptions["enabled"];
+    googleAnalyticsMeasurementId: TrackingConfigOptions["GAMeasurementId"];
+    constructor(options?: Partial<TrackingConfigOptions>);
+}
+
+declare interface TrackingConfigOptions {
+    /**
+     * Enable tracking.
+     * @default true
+     */
+    enabled: boolean;
+    /** Google Analytics measurement ID. */
+    GAMeasurementId: string;
+}
+
+declare class TrackingManager {
+    #private;
+    measurementId?: string | null;
+    constructor(systemManager: SystemManager);
+    init(): this;
+    event(options: UaEventOptions | string): void;
+}
+
+declare class Vector2 {
+    x: number;
+    y: number;
+    constructor(xy: number);
+    constructor(x: number, y?: number);
+    static get ZERO(): Vector2;
+    get clone(): Vector2;
+    get magnitude(): number;
+    setX(x: number): this;
+    setY(y: number): this;
+    set(x: number, y: number): this;
+    round(): this;
+    normalize(): this;
+    scale(scalar: number): this;
+    getDistanceSquared(x: number, y?: number): number;
+    getDistanceSquared(vector2: Vector2): number;
+    getDistance(x: number, y?: number): number;
+    getDistance(vector2: Vector2): number;
+    add(x: number, y?: number): this;
+    add(vector2: Vector2): this;
+    subtract(x: number, y?: number): this;
+    subtract(vector2: Vector2): this;
+    multiply(x: number, y?: number): this;
+    multiply(vector2: Vector2): this;
+    divide(x: number, y?: number): this;
+    divide(vector2: Vector2): this;
+    lerp(vector2: Vector2, t: number): this;
+    static sum(vector2A: Vector2, vector2B: Vector2): Vector2;
+    static difference(vector2A: Vector2, vector2B: Vector2): Vector2;
+    static product(vector2A: Vector2, vector2B: Vector2): Vector2;
+    static division(vector2A: Vector2, vector2B: Vector2): Vector2;
+    static scale(vector2: Vector2, scalar: number): Vector2;
+    static normalize(vector2: Vector2): Vector2;
+    static lerp(vector2A: Vector2, vector2B: Vector2, t: number): Vector2;
+    static from({ x, y }: {
+        x: number;
+        y: number;
+    }): Vector2;
+    static parseVector(x: number | Vector2, y?: number): {
+        x: number;
+        y: number;
+    };
+}
+
+declare class VirtualBase<E extends VirtualBaseEvents = VirtualBaseEvents> extends EventEmitter<E & Record<keyof E, unknown[]>> {
+    /** The name of this item. */
+    name: string;
+    /** The alias of this item. */
+    alias: string | undefined | null;
+    /** The folder this item is in. */
+    parent: VirtualFolder | undefined | null;
+    /** Whether this item is protected from changes. */
+    isProtected: boolean | undefined | null;
+    /** The URL of the icon of this item. */
+    iconUrl: string | undefined | null;
+    /** The file this item links to. */
+    linkedFile: VirtualFile | undefined | null;
+    /** The folder this item links to. */
+    linkedFolder: VirtualFolder | undefined | null;
+    /** Whether this item has been edited by the user. */
+    editedByUser: boolean | undefined | null;
+    /** Whether this item is the root folder. */
+    isRoot: boolean | undefined | null;
+    /** The root folder. */
+    root: VirtualRoot | undefined | null;
+    /** Whether this item has been deleted. */
+    isDeleted: boolean;
+    static readonly UPDATE_EVENT = "update";
+    constructor(name: string);
+    get id(): string;
+    setName(name: string): this;
+    setAlias(alias: string): this;
+    setParent(parent: VirtualFolder): this;
+    setProtected(value: boolean): this;
+    setIconUrl(iconUrl: string | null): this;
+    getIconUrl(): string;
+    getType(): string;
+    /**
+     * Tries to delete this item.
+     */
+    delete(): void;
+    confirmChanges(root?: VirtualRoot): void;
+    /**
+     * Opens this item in the appropriate application.
+     */
+    open(..._args: unknown[]): unknown;
+    /**
+     * Returns the path of this item.
+     */
+    get path(): string;
+    /**
+     * Returns path without using this item's alias.
+     */
+    get displayPath(): string;
+    /**
+     * Returns path without using any aliases.
+     */
+    get absolutePath(): string;
+    /**
+     * Returns whether this can be edited in its current state.
+     */
+    get canBeEdited(): boolean;
+    /**
+     * Returns the root folder.
+     */
+    getRoot(): VirtualRoot;
+    isFile(): this is VirtualFile;
+    isFolder(): this is VirtualFolder;
+    toJSON(): VirtualBaseJson | null;
+    toString(): string | null;
+}
+
+declare interface VirtualBaseEvents {
+    update: [];
+}
+
+declare interface VirtualBaseJson {
+    nam: string;
+    ico?: string;
+}
+
+declare class VirtualDriveConfig {
+    saveData: VirtualDriveConfigOptions["saveData"];
+    defaultData: VirtualDriveConfigOptions["defaultData"];
+    constructor(options?: Partial<VirtualDriveConfigOptions>);
+}
+
+declare interface VirtualDriveConfigOptions {
+    /**
+     * Enables persistent storage of the virtual drive.
+     * @default {
+     enableCompression: true,
+     prefix: "pos-"
+     }
+     */
+    saveData: false | {
+        /**
+         * Enables compression of stored items.
+         * @default false
+         */
+        enableCompression: boolean;
+        /**
+         * The prefix to prepend to stored keys.
+         * @default "pos-"
+         */
+        prefix?: string;
+        /**
+         * An array of tuples of old and new keys to migrate.
+         * @default [["data", VirtualDriveStorage.KEY]]
+         */
+        migrations?: [string, string][];
+    };
+    /**
+     * Configure the data that is loaded initially when ProzillaOS is opened.
+     */
+    defaultData: {
+        /**
+         * Include pictures folder in default data.
+         * @default true
+         */
+        includePicturesFolder?: boolean;
+        /**
+         * Include documents folder in default data.
+         * @default true
+         */
+        includeDocumentsFolder?: boolean;
+        /**
+         * Include desktop folder in default data.
+         * @default true
+         */
+        includeDesktopFolder?: boolean;
+        /**
+         * Include source tree folder in default data.
+         * @default true
+         */
+        includeSourceTree?: boolean;
+        /**
+         * Include apps folder in default data.
+         * @default true
+         */
+        includeAppsFolder?: boolean;
+        loadData?: (virtualRoot: VirtualRoot) => void;
+    };
+}
+
+declare class VirtualDriveStorage extends Storage_2 {
+    virtualDriveConfig: VirtualDriveConfig;
+    static readonly KEY = "drive";
+    constructor(virtualDriveConfig: VirtualDriveConfig);
+    load(key: string): string | null;
+    store(key: string, value: string): void;
+    synchronize(): void;
+}
+
+/**
+ * A virtual file that can be stored inside a folder.
+ */
+declare class VirtualFile extends VirtualBase<VirtualFileEvents> {
+    /** The extension of this file. */
+    extension: OptionalStringProperty;
+    /** The URL of the source of this file. */
+    source: OptionalStringProperty;
+    /** The content of this file. */
+    content: OptionalStringProperty;
+    static NON_TEXT_EXTENSIONS: string[];
+    static readonly CONTENT_CHANGE_EVENT = "contentChange";
+    constructor(name: string, extension?: string);
+    setAlias(alias: string): this;
+    /**
+     * Sets the source of this file and removes the content.
+     */
+    setSource(source: string): this;
+    /**
+     * Sets the content of this file and removes the source.
+     */
+    setContent(content: string | string[]): this;
+    get id(): string;
+    static splitId(id: string): {
+        name: string;
+        extension: OptionalStringProperty;
+    };
+    /**
+     * Opens this file in an app associated with its extension.
+     */
+    open(windowsManager: WindowsManager): object | null;
+    read(): Promise<OptionalStringProperty | undefined>;
+    isFile(): this is VirtualFile;
+    getIconUrl(): string;
+    getType(): string;
+    download(): void;
+    isDownloadable(): boolean;
+    toJSON(): VirtualFileJson | null;
+    static removeFileScheme(source: string): string;
+}
+
+declare interface VirtualFileEvents extends VirtualBaseEvents {
+    contentChange: [VirtualFile];
+}
+
+declare interface VirtualFileJson extends VirtualBaseJson {
+    ext?: string;
+    cnt?: string;
+    src?: string;
+}
+
+/**
+ * A link that points to a virtual file.
+ */
+declare class VirtualFileLink extends VirtualFile {
+    linkedPath?: string;
+    constructor(name: string, linkedFile?: VirtualFile);
+    setLinkedFile(file: VirtualFile | null): VirtualFileLink;
+    setLinkedPath(path: string): VirtualFileLink;
+    isValid(): boolean;
+    toJSON(): VirtualFileLinkJson | null;
+    setAlias(...args: Parameters<VirtualFile["setAlias"]>): this;
+    setSource(...args: Parameters<VirtualFile["setSource"]>): this;
+    setContent(...args: Parameters<VirtualFile["setContent"]>): this;
+    get id(): string;
+    open(...args: Parameters<VirtualFile["open"]>): ReturnType<VirtualFile["open"]>;
+    read(...args: Parameters<VirtualFile["read"]>): Promise<string | null | undefined>;
+    getIconUrl(...args: Parameters<VirtualFile["getIconUrl"]>): ReturnType<VirtualFile["getIconUrl"]>;
+}
+
+declare interface VirtualFileLinkJson extends VirtualFileJson {
+    lnk: string;
+}
+
+/**
+ * A virtual folder that can contains files and sub-folders.
+ */
+declare class VirtualFolder<E extends VirtualBaseEvents = VirtualBaseEvents> extends VirtualBase<E> {
+    /** The folders inside this folder. */
+    subFolders: (VirtualFolder | VirtualFolderLink)[];
+    /** The files inside this folder. */
+    files: (VirtualFile | VirtualFileLink)[];
+    /**
+     * The type of this folder.
+     * @default VirtualFolder.TYPE.general
+     */
+    type: number | undefined;
+    static TYPE: {
+        general: number;
+        media: number;
+    };
+    constructor(name: string, type?: number);
+    setAlias(alias: string): this;
+    /**
+     * Returns true if this folder contains a file matching a name and extension.
+     */
+    hasFile(name: string, extension?: string): boolean;
+    /**
+     * Returns true if this folder contains a folder matching a name.
+     */
+    hasFolder(name: string): boolean;
+    /**
+     * Finds and returns a file inside this folder matching a name and extension.
+     */
+    findFile(name: string, extension?: string | null): VirtualFile | VirtualFileLink | null;
+    /**
+     * Finds and returns a folder inside this folder matching a name.
+     */
+    findSubFolder(name: string): VirtualFolder | VirtualFolderLink | null;
+    addFile(file: VirtualFile, confirmChanges?: boolean): this;
+    /**
+     * Creates a file with a name and extension.
+     */
+    createFile(name: string, extension?: string, callback?: (newFile: VirtualFile | VirtualFileLink) => void): this;
+    /**
+     * Creates files based on an array of objects with file names and extensions.
+     */
+    createFiles(files: {
+        name: string;
+        extension: string;
+    }[]): this;
+    /**
+     * Creates a file link with a name.
+     */
+    createFileLink(name: string, callback?: (newFileLink: VirtualFileLink | VirtualFile) => void): this;
+    /**
+     * Creates file links based on an array of objects with file names and extensions.
+     */
+    createFileLinks(fileLinks: {
+        name: string;
+    }[]): this;
+    addFolder(folder: VirtualFolder, confirmChanges?: boolean): this;
+    /**
+     * Creates a folder with a name.
+     */
+    createFolder(name: string, callback?: (newFolder: VirtualFolder) => void): this;
+    /**
+     * Creates folders based on an array of folder names.
+     */
+    createFolders(names: string[]): this;
+    /**
+     * Creates a folder link with a name.
+     */
+    createFolderLink(name: string, callback?: (newFolderLink: VirtualFolderLink | VirtualFolder) => void): this;
+    /**
+     * Creates folder links based on an array of folder names.
+     */
+    createFolderLinks(names: string[]): this;
+    /**
+     * Removes a file or folder from this folder.
+     */
+    remove(child: VirtualFile | VirtualFileLink | VirtualFolder | VirtualFolderLink): this;
+    /**
+     * Returns the file or folder at a relative path or null if it doesn't exist.
+     */
+    navigate(relativePath: string): VirtualFile | VirtualFolder | null;
+    navigateToFolder(relativePath: string): VirtualFolder | null;
+    navigateToFile(relativePath: string): VirtualFile | null;
+    /**
+     * Opens this folder in file explorer.
+     */
+    open(windowsManager: WindowsManager): object | null | undefined;
+    /**
+     * Deletes this folder and all its files and sub-folders recursively.
+     */
+    delete(): void;
+    /**
+     * Returns all files inside this folder.
+     * @param showHidden - Whether to include hidden files.
+     */
+    getFiles(showHidden?: boolean): VirtualFile[];
+    /**
+     * Returns all sub-folders inside this folder.
+     * @param showHidden - Whether to include hidden folders.
+     */
+    getSubFolders(showHidden?: boolean): VirtualFolder[];
+    /**
+     * Returns the amount of files and sub-folders inside this folder.
+     * @param includeHidden - Whether to include hidden files and folders in the count.
+     */
+    getItemCount(includeHidden?: boolean): number;
+    isFolder(): this is VirtualFolder;
+    getIconUrl(): string;
+    toJSON(): VirtualFolderJson | null;
+}
+
+declare interface VirtualFolderJson extends VirtualBaseJson {
+    fls?: VirtualFileJson[];
+    fds?: VirtualFolderJson[];
+}
+
+/**
+ * A link that points to a virtual folder.
+ */
+declare class VirtualFolderLink extends VirtualFolder {
+    linkedPath?: string;
+    constructor(name: string, linkedFolder?: VirtualFolder);
+    setLinkedFolder(folder: VirtualFolder | null): VirtualFolderLink;
+    setLinkedPath(path: string): VirtualFolderLink;
+    isValid(): boolean;
+    getIconUrl(): string;
+    toJSON(): VirtualFolderLinkJson | null;
+    setAlias(...args: Parameters<VirtualFolder["setAlias"]>): this;
+    createFile(...args: Parameters<VirtualFolder["createFile"]>): this;
+    createFiles(...args: Parameters<VirtualFolder["createFiles"]>): this;
+    createFolder(...args: Parameters<VirtualFolder["createFolder"]>): this;
+    createFolders(...args: Parameters<VirtualFolder["createFolders"]>): this;
+    hasFile(...args: Parameters<VirtualFolder["hasFile"]>): ReturnType<VirtualFolder["hasFile"]>;
+    hasFolder(...args: Parameters<VirtualFolder["hasFolder"]>): ReturnType<VirtualFolder["hasFolder"]>;
+    findFile(...args: Parameters<VirtualFolder["findFile"]>): ReturnType<VirtualFolder["findFile"]>;
+    findSubFolder(...args: Parameters<VirtualFolder["findSubFolder"]>): ReturnType<VirtualFolder["findSubFolder"]>;
+    getFiles(...args: Parameters<VirtualFolder["getFiles"]>): ReturnType<VirtualFolder["getFiles"]>;
+    getSubFolders(...args: Parameters<VirtualFolder["getSubFolders"]>): ReturnType<VirtualFolder["getSubFolders"]>;
+    open(...args: Parameters<VirtualFolder["open"]>): ReturnType<VirtualFolder["open"]>;
+    getItemCount(...args: Parameters<VirtualFolder["getItemCount"]>): ReturnType<VirtualFolder["getItemCount"]>;
+}
+
+declare interface VirtualFolderLinkJson extends VirtualFolderJson {
+    lnk: string;
+}
+
+/**
+ * A virtual folder that serves as the root folder.
+ */
+declare class VirtualRoot extends VirtualFolder<VirtualRootEvents> {
+    /** Aliases for files and folders. */
+    shortcuts: Record<string, VirtualFile | VirtualFileLink | VirtualFolder | VirtualFolderLink>;
+    initiated: boolean;
+    loadedDefaultData: boolean;
+    systemManager: SystemManager;
+    storage: VirtualDriveStorage;
+    static readonly ERROR_EVENT = "error";
+    constructor(systemManager: SystemManager);
+    loadDefaultData(): void;
+    loadData(): void;
+    /**
+     * Calls the storage manager's store function with this root's data as a string.
+     */
+    saveData(): void;
+    /**
+     * Initializes this root by loading the default data and then the user's data on top.
+     */
+    init(): VirtualRoot;
+    /**
+     * Adds a shortcut to a file or folder.
+     */
+    addShortcut(name: string, destination: VirtualFile | VirtualFileLink | VirtualFolder | VirtualFolderLink): this;
+    /**
+     * Tells the storage manager to clear all data and reloads the window.
+     */
+    reset(): void;
+    static isValidName(_name: string): boolean;
+    static isValidFileName(_name: string): boolean;
+    static isValidFolderName(_name: string): boolean;
+    get path(): string;
+    get displayPath(): string;
+    toJSON(): VirtualRootJson | null;
+    toString(): string | null;
+}
+
+declare interface VirtualRootEvents extends VirtualBaseEvents {
+    error: [{
+        message: string;
+    }];
+}
+
+declare interface VirtualRootJson extends VirtualFolderJson {
+    scs: Record<string, string>;
+}
+
+declare interface WindowOptions {
+    /** The ID of the window. */
+    id?: string;
+    /** The app associated with the window. */
+    app?: App;
+    /**
+     * The size of the window.
+     * @default new Vector2(700, 400)
+     */
+    size?: Vector2;
+    /** The position of the window. */
+    position?: Vector2;
+    fullscreen?: boolean | string;
+    options?: object;
+    isFocused?: boolean;
+    lastInteraction?: number;
+    minimized?: boolean;
+    [key: string]: unknown;
+}
+
+declare interface WindowProps extends WindowOptions {
+    /**
+     * Whether to start the window in fullscreen mode.
+     * @default false
+     */
+    fullscreen?: boolean;
+    /** Function that sets the title of the window. */
+    setTitle?: React.Dispatch<React.SetStateAction<string>>;
+    /** Function that sets the icon URL of the window. */
+    setIconUrl?: React.Dispatch<React.SetStateAction<string>>;
+    /** Function that closes the window. */
+    close?: (event?: Event | React.UIEvent<HTMLElement>) => void;
+    /** Function that brings the window in focus. */
+    focus?: (event?: Event | React.UIEvent<HTMLElement>, force?: boolean) => void;
+    /** Whether the window is currently focused and should allow interactions. */
+    active?: boolean;
+    /** Whether to start the window in minimized mode. */
+    minimized?: boolean;
+    /** Function that toggles the minimized mode of the window. */
+    toggleMinimized?: (event?: Event) => void;
+    /** The depth value of the window. */
+    index?: number;
+    /** Whether the window is in standalone mode. */
+    standalone?: boolean;
+}
+
+declare class WindowsConfig {
+    screenMargin: WindowsConfigOptions["screenMargin"];
+    titleSeparator: WindowsConfigOptions["titleSeparator"];
+    minScreenSize: WindowsConfigOptions["minScreenSize"];
+    constructor(options?: Partial<WindowsConfigOptions>);
+}
+
+declare interface WindowsConfigOptions {
+    /**
+     * The margin around windows that are not maximized, in pixels.
+     * @default 32
+     */
+    screenMargin: number;
+    /**
+     * The separator to use in window titles.
+     * @default "-"
+     */
+    titleSeparator: string;
+    /**
+     * If the user's screen is smaller than these values, windows will always be maximized.
+     * @default new Vector2(350, 350)
+     */
+    minScreenSize: Vector2;
+}
+
+/**
+ * Manages the states of windows.
+ */
+declare class WindowsManager {
+    #private;
+    windows: {
+        [id: string]: WindowOptions;
+    };
+    /** Function that handles changes to the open windows. */
+    updateWindows: (window: WindowsManager["windows"]) => void;
+    startupComplete: boolean;
+    constructor(systemManager: SystemManager, trackingManager: TrackingManager);
+    /**
+     * Opens a window for an application.
+     * @param appId - The ID of the app.
+     */
+    open(appId: string, options?: WindowOptions | null): object | null;
+    /**
+     * Opens a file with the associated app or by a method specified by the file scheme.
+     * @returns Opened window.
+     */
+    openFile(file: VirtualFile, options?: object): object | null;
+    /**
+     * Close a window.
+     */
+    close(windowId: string): void;
+    /**
+     * Focus on a specific window.
+     */
+    focus(windowId: string): void;
+    /**
+     * Check whether a window is focused.
+     */
+    isFocused(windowId: string): boolean | undefined;
+    /**
+     * Check if any window is focused.
+     */
+    isAnyFocused(): boolean;
+    /**
+     * Change the minimized state of a window.
+     * @param windowId - The ID of the window.
+     * @param minimized - Leave as undefined to toggle the window's minimization state.
+     */
+    setMinimized(windowId: string, minimized?: boolean): void;
+    /**
+     * Minimize all windows.
+     */
+    minimizeAll(): void;
+    /**
+     * Check if an app has an open window.
+     */
+    isAppActive(appId: string): boolean;
+    /**
+     * Get an opened window of a certain app.
+     */
+    getAppWindowId(appId: string): string | null;
+    setUpdateWindows(updateWindows: WindowsManager["updateWindows"]): void;
+    startup(appIds: string[], options: Record<string, unknown>): void;
+    get windowIds(): string[];
+}
+
 export { }

package/dist/main.js

@@ -1,31 +1,31 @@
 (function(){"use strict";try{if(typeof document<"u"){var e=document.createElement("style");e.appendChild(document.createTextNode("._MediaViewer_vkowo_1{display:flex;justify-content:center;align-items:center;width:100%;height:100%;padding:2rem}._MediaViewer_vkowo_1 img{width:100%;height:100%;object-fit:contain}._VideoViewer_vkowo_16,._AudioViewer_vkowo_16{display:flex;flex-direction:column;align-items:center;justify-content:center;width:100%;height:100%}._VideoViewer_vkowo_16 h3{margin:0}._VideoViewer_vkowo_16>*{width:100%;height:100%;border:none;background:transparent}")),document.head.appendChild(e)}}catch(i){console.error("vite-plugin-css-injected-by-js",i)}})();
-import { useSystemManager as x, useWindowsManager as E, AUDIO_EXTENSIONS as a, VIDEO_EXTENSIONS as d, AppsConfig as m, MEDIA_EXTENSIONS as V, IMAGE_EXTENSIONS as _, App as h } from "@prozilla-os/core";
-import { jsx as r, jsxs as l } from "react/jsx-runtime";
-import { useRef as p, useEffect as w } from "react";
-const y = "_MediaViewer_vkowo_1", A = "_VideoViewer_vkowo_16", N = "_AudioViewer_vkowo_16", n = {
-  MediaViewer: y,
-  VideoViewer: A,
-  AudioViewer: N
+import { useSystemManager as x, useWindowsManager as E, AUDIO_EXTENSIONS as c, VIDEO_EXTENSIONS as u, AppsConfig as p, MEDIA_EXTENSIONS as w, IMAGE_EXTENSIONS as g, App as _ } from "@prozilla-os/core";
+import { jsx as r, jsxs as a } from "react/jsx-runtime";
+import { useRef as d, useEffect as l } from "react";
+const h = "_MediaViewer_vkowo_1", y = "_VideoViewer_vkowo_16", A = "_AudioViewer_vkowo_16", n = {
+  MediaViewer: h,
+  VideoViewer: y,
+  AudioViewer: A
 };
-function g({ file: e, close: t, setTitle: s }) {
-  const { appsConfig: v } = x(), u = E(), o = p(null), i = p(null);
-  if (w(() => {
-    e != null && (s == null || s(e.id));
-  }, [e, s]), w(() => {
+function N({ file: e, close: m, setTitle: s }) {
+  const { appsConfig: V } = x(), v = E(), o = d(null), i = d(null);
+  if (l(() => {
+    e != null && s?.(e.id);
+  }, [e, s]), l(() => {
     if (!(e == null || e.source == null))
-      return e.extension && a.includes(e.extension) && o.current && (o.current.src = e.source, o.current.play()), e.extension && d.includes(e.extension) && i.current && (i.current.src = e.source, i.current.play()), () => {
+      return e.extension && c.includes(e.extension) && o.current && (o.current.src = e.source, o.current.play()), e.extension && u.includes(e.extension) && i.current && (i.current.src = e.source, i.current.play()), () => {
         o.current && (o.current.pause(), o.current.currentTime = 0), i.current && (i.current.pause(), i.current.currentTime = 0);
       };
   }, [e]), e == null) {
-    const c = v.getAppByRole(m.APP_ROLES.fileExplorer);
+    const t = V.getAppByRole(p.APP_ROLES.fileExplorer);
     return setTimeout(() => {
-      c != null && (u == null || u.open(c.id, { path: "~/Pictures" })), t == null || t();
+      t != null && v?.open(t.id, { path: "~/Pictures" }), m?.();
     }, 10), null;
   }
-  return e.extension == null || !V.includes(e.extension) ? /* @__PURE__ */ r("p", { children: "Invalid file format." }) : e.source == null ? /* @__PURE__ */ r("p", { children: "File failed to load." }) : _.includes(e.extension) ? /* @__PURE__ */ r("div", { className: n.MediaViewer, children: /* @__PURE__ */ r("img", { src: e.source, alt: e.id, draggable: "false" }) }) : a.includes(e.extension) ? /* @__PURE__ */ r("div", { className: n.AudioViewer, children: /* @__PURE__ */ l("audio", { ref: o, controls: !0, children: [
+  return e.extension == null || !w.includes(e.extension) ? /* @__PURE__ */ r("p", { children: "Invalid file format." }) : e.source == null ? /* @__PURE__ */ r("p", { children: "File failed to load." }) : g.includes(e.extension) ? /* @__PURE__ */ r("div", { className: n.MediaViewer, children: /* @__PURE__ */ r("img", { src: e.source, alt: e.id, draggable: "false" }) }) : c.includes(e.extension) ? /* @__PURE__ */ r("div", { className: n.AudioViewer, children: /* @__PURE__ */ a("audio", { ref: o, controls: !0, children: [
     /* @__PURE__ */ r("source", { src: e.source, type: `video/${e.extension}` }),
     "Your browser does not support audio."
-  ] }) }) : d.includes(e.extension) ? e.extension === "yt" ? /* @__PURE__ */ r("div", { className: n.VideoViewer, children: /* @__PURE__ */ r(
+  ] }) }) : u.includes(e.extension) ? e.extension === "yt" ? /* @__PURE__ */ r("div", { className: n.VideoViewer, children: /* @__PURE__ */ r(
     "iframe",
     {
       src: e.source.replace("watch?v=", "embed/"),
@@ -34,14 +34,14 @@ function g({ file: e, close: t, setTitle: s }) {
       allowFullScreen: !0,
       allowTransparency: !0
     }
-  ) }) : /* @__PURE__ */ r("div", { className: n.VideoViewer, children: /* @__PURE__ */ l("video", { ref: i, controls: !0, className: n.VideoPlayer, children: [
+  ) }) : /* @__PURE__ */ r("div", { className: n.VideoViewer, children: /* @__PURE__ */ a("video", { ref: i, controls: !0, className: n.VideoPlayer, children: [
     /* @__PURE__ */ r("source", { src: e.source, type: `video/${e.extension}` }),
     "Your browser does not support videos."
   ] }) }) : /* @__PURE__ */ r("div", { className: n.MediaViewer, children: /* @__PURE__ */ r("img", { src: e.source, alt: e.id, draggable: "false" }) });
 }
-const S = new h("Media Viewer", "media-viewer", g).setIconUrl("https://os.prozilla.dev/assets/apps/icons/media-viewer.svg").setRole(m.APP_ROLES.mediaViewer).setAssociatedExtensions(V).setCategory("Photo & video");
-S.setMetadata({ name: "@prozilla-os/media-viewer", version: "1.1.17", author: "Prozilla" });
+const M = new _("Media Viewer", "media-viewer", N).setIconUrl("https://os.prozilla.dev/assets/apps/icons/media-viewer.svg").setRole(p.APP_ROLES.mediaViewer).setAssociatedExtensions(w).setCategory("Photo & video");
+M.setMetadata({ name: "@prozilla-os/media-viewer", version: "1.1.19", author: "Prozilla" });
 export {
-  S as mediaViewer
+  M as mediaViewer
 };
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sources":["../src/components/MediaViewer.tsx","../src/main.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport styles from \"./MediaViewer.module.css\";\nimport { AppsConfig, IMAGE_EXTENSIONS, VIDEO_EXTENSIONS, AUDIO_EXTENSIONS, useSystemManager, useWindowsManager, VirtualFile, WindowProps, MEDIA_EXTENSIONS } from \"@prozilla-os/core\";\n\nexport interface MediaViewerProps extends WindowProps {\n\tfile?: VirtualFile;\n}\n\nexport function MediaViewer({ file, close, setTitle }: MediaViewerProps) {\n\tconst { appsConfig } = useSystemManager();\n\tconst windowsManager = useWindowsManager();\n\tconst audioRef = useRef<HTMLAudioElement | null>(null);\n\tconst videoRef = useRef<HTMLVideoElement | null>(null);\n\n\tuseEffect(() => {\n\t\tif (file != null)\n\t\t\tsetTitle?.(file.id);\n\t}, [file, setTitle]);\n\n\tuseEffect(() => {\n\t\tif (file == null || file.source == null)\n\t\t\treturn;\n\n\t\tif (file.extension && AUDIO_EXTENSIONS.includes(file.extension)) {\n\t\t\tif (audioRef.current) {\n\t\t\t\taudioRef.current.src = file.source;\n\t\t\t\tvoid audioRef.current.play();\n\t\t\t}\n\t\t}\n\n\t\tif (file.extension && VIDEO_EXTENSIONS.includes(file.extension)) {\n\t\t\tif (videoRef.current) {\n\t\t\t\tvideoRef.current.src = file.source;\n\t\t\t\tvoid videoRef.current.play();\n\t\t\t}\n\t\t}\n\n\t\treturn () => {\n\t\t\tif (audioRef.current) {\n\t\t\t\taudioRef.current.pause();\n\t\t\t\taudioRef.current.currentTime = 0;\n\t\t\t}\n\t\t\tif (videoRef.current) {\n\t\t\t\tvideoRef.current.pause();\n\t\t\t\tvideoRef.current.currentTime = 0;\n\t\t\t}\n\t\t};\n\t}, [file]);\n\n\tif (file == null) {\n\t\tconst fileExplorerApp = appsConfig.getAppByRole(AppsConfig.APP_ROLES.fileExplorer);\n\n\t\tsetTimeout(() => {\n\t\t\tif (fileExplorerApp != null)\n\t\t\t\twindowsManager?.open(fileExplorerApp.id, { path: \"~/Pictures\" });\n\t\t\tclose?.();\n\t\t}, 10);\n\t\treturn null;\n\t}\n\n\tif (file.extension == null || !MEDIA_EXTENSIONS.includes(file.extension)) {\n\t\treturn <p>Invalid file format.</p>;\n\t}\n\n\tif (file.source == null)\n\t\treturn <p>File failed to load.</p>;\n\n\tif (IMAGE_EXTENSIONS.includes(file.extension)) {\n\t\treturn <div className={styles.MediaViewer}>\n\t\t\t<img src={file.source} alt={file.id} draggable=\"false\" />\n\t\t</div>;\n\t} else if (AUDIO_EXTENSIONS.includes(file.extension)) {\n\t\treturn <div className={styles.AudioViewer}>\n\t\t\t<audio ref={audioRef} controls>\n\t\t\t\t<source src={file.source} type={`video/${file.extension}`}/>\n\t\t\t\tYour browser does not support audio.\n\t\t\t</audio> \n\t\t</div>;\n\t} else if (VIDEO_EXTENSIONS.includes(file.extension)) {\n\t\tif (file.extension === \"yt\") {\n\t\t\treturn <div className={styles.VideoViewer}>\n\t\t\t\t<iframe\n\t\t\t\t\tsrc={file.source.replace(\"watch?v=\", \"embed/\")}\n\t\t\t\t\ttitle={file.id}\n\t\t\t\t\tallow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\"\n\t\t\t\t\tallowFullScreen\n\t\t\t\t\tallowTransparency={true}\n\t\t\t\t/>\n\t\t\t</div>;\n\t\t} else {\n\t\t\treturn <div className={styles.VideoViewer}>\n\t\t\t\t<video ref={videoRef} controls className={styles.VideoPlayer}>\n\t\t\t\t\t<source src={file.source} type={`video/${file.extension}`} />\n\t\t\t\t\tYour browser does not support videos.\n\t\t\t\t</video>\n\t\t\t</div>;\n\t\t}\n\t}\n\n\treturn <div className={styles.MediaViewer}>\n\t\t<img src={file.source} alt={file.id} draggable=\"false\"/>\n\t</div>;\n}","import { App, AppsConfig, MEDIA_EXTENSIONS } from \"@prozilla-os/core\";\nimport { MediaViewer, MediaViewerProps } from \"./components/MediaViewer\";\n\nconst mediaViewer = new App<MediaViewerProps>(\"Media Viewer\", \"media-viewer\", MediaViewer)\n\t.setIconUrl(\"https://os.prozilla.dev/assets/apps/icons/media-viewer.svg\")\n\t.setRole(AppsConfig.APP_ROLES.mediaViewer)\n\t.setAssociatedExtensions(MEDIA_EXTENSIONS)\n\t.setCategory(\"Photo & video\");\nmediaViewer.setMetadata({ name: \"@prozilla-os/media-viewer\", version: \"1.1.17\", author: \"Prozilla\" });\n\n\nexport { mediaViewer };"],"names":["MediaViewer","file","close","setTitle","appsConfig","useSystemManager","windowsManager","useWindowsManager","audioRef","useRef","videoRef","useEffect","AUDIO_EXTENSIONS","VIDEO_EXTENSIONS","fileExplorerApp","AppsConfig","MEDIA_EXTENSIONS","jsx","IMAGE_EXTENSIONS","styles","jsxs","mediaViewer","App"],"mappings":"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"}
+{"version":3,"file":"main.js","sources":["../src/components/MediaViewer.tsx","../src/main.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport styles from \"./MediaViewer.module.css\";\nimport { AppsConfig, IMAGE_EXTENSIONS, VIDEO_EXTENSIONS, AUDIO_EXTENSIONS, useSystemManager, useWindowsManager, VirtualFile, WindowProps, MEDIA_EXTENSIONS } from \"@prozilla-os/core\";\n\nexport interface MediaViewerProps extends WindowProps {\n\tfile?: VirtualFile;\n}\n\nexport function MediaViewer({ file, close, setTitle }: MediaViewerProps) {\n\tconst { appsConfig } = useSystemManager();\n\tconst windowsManager = useWindowsManager();\n\tconst audioRef = useRef<HTMLAudioElement | null>(null);\n\tconst videoRef = useRef<HTMLVideoElement | null>(null);\n\n\tuseEffect(() => {\n\t\tif (file != null)\n\t\t\tsetTitle?.(file.id);\n\t}, [file, setTitle]);\n\n\tuseEffect(() => {\n\t\tif (file == null || file.source == null)\n\t\t\treturn;\n\n\t\tif (file.extension && AUDIO_EXTENSIONS.includes(file.extension)) {\n\t\t\tif (audioRef.current) {\n\t\t\t\taudioRef.current.src = file.source;\n\t\t\t\tvoid audioRef.current.play();\n\t\t\t}\n\t\t}\n\n\t\tif (file.extension && VIDEO_EXTENSIONS.includes(file.extension)) {\n\t\t\tif (videoRef.current) {\n\t\t\t\tvideoRef.current.src = file.source;\n\t\t\t\tvoid videoRef.current.play();\n\t\t\t}\n\t\t}\n\n\t\treturn () => {\n\t\t\tif (audioRef.current) {\n\t\t\t\taudioRef.current.pause();\n\t\t\t\taudioRef.current.currentTime = 0;\n\t\t\t}\n\t\t\tif (videoRef.current) {\n\t\t\t\tvideoRef.current.pause();\n\t\t\t\tvideoRef.current.currentTime = 0;\n\t\t\t}\n\t\t};\n\t}, [file]);\n\n\tif (file == null) {\n\t\tconst fileExplorerApp = appsConfig.getAppByRole(AppsConfig.APP_ROLES.fileExplorer);\n\n\t\tsetTimeout(() => {\n\t\t\tif (fileExplorerApp != null)\n\t\t\t\twindowsManager?.open(fileExplorerApp.id, { path: \"~/Pictures\" });\n\t\t\tclose?.();\n\t\t}, 10);\n\t\treturn null;\n\t}\n\n\tif (file.extension == null || !MEDIA_EXTENSIONS.includes(file.extension)) {\n\t\treturn <p>Invalid file format.</p>;\n\t}\n\n\tif (file.source == null)\n\t\treturn <p>File failed to load.</p>;\n\n\tif (IMAGE_EXTENSIONS.includes(file.extension)) {\n\t\treturn <div className={styles.MediaViewer}>\n\t\t\t<img src={file.source} alt={file.id} draggable=\"false\" />\n\t\t</div>;\n\t} else if (AUDIO_EXTENSIONS.includes(file.extension)) {\n\t\treturn <div className={styles.AudioViewer}>\n\t\t\t<audio ref={audioRef} controls>\n\t\t\t\t<source src={file.source} type={`video/${file.extension}`}/>\n\t\t\t\tYour browser does not support audio.\n\t\t\t</audio> \n\t\t</div>;\n\t} else if (VIDEO_EXTENSIONS.includes(file.extension)) {\n\t\tif (file.extension === \"yt\") {\n\t\t\treturn <div className={styles.VideoViewer}>\n\t\t\t\t<iframe\n\t\t\t\t\tsrc={file.source.replace(\"watch?v=\", \"embed/\")}\n\t\t\t\t\ttitle={file.id}\n\t\t\t\t\tallow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\"\n\t\t\t\t\tallowFullScreen\n\t\t\t\t\tallowTransparency={true}\n\t\t\t\t/>\n\t\t\t</div>;\n\t\t} else {\n\t\t\treturn <div className={styles.VideoViewer}>\n\t\t\t\t<video ref={videoRef} controls className={styles.VideoPlayer}>\n\t\t\t\t\t<source src={file.source} type={`video/${file.extension}`} />\n\t\t\t\t\tYour browser does not support videos.\n\t\t\t\t</video>\n\t\t\t</div>;\n\t\t}\n\t}\n\n\treturn <div className={styles.MediaViewer}>\n\t\t<img src={file.source} alt={file.id} draggable=\"false\"/>\n\t</div>;\n}","import { App, AppsConfig, MEDIA_EXTENSIONS } from \"@prozilla-os/core\";\nimport { MediaViewer, MediaViewerProps } from \"./components/MediaViewer\";\n\nconst mediaViewer = new App<MediaViewerProps>(\"Media Viewer\", \"media-viewer\", MediaViewer)\n\t.setIconUrl(\"https://os.prozilla.dev/assets/apps/icons/media-viewer.svg\")\n\t.setRole(AppsConfig.APP_ROLES.mediaViewer)\n\t.setAssociatedExtensions(MEDIA_EXTENSIONS)\n\t.setCategory(\"Photo & video\");\n\nexport { mediaViewer };"],"names":["MediaViewer","file","close","setTitle","appsConfig","useSystemManager","windowsManager","useWindowsManager","audioRef","useRef","videoRef","useEffect","AUDIO_EXTENSIONS","VIDEO_EXTENSIONS","fileExplorerApp","AppsConfig","MEDIA_EXTENSIONS","jsx","IMAGE_EXTENSIONS","styles","jsxs","mediaViewer","App"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prozilla-os/media-viewer",
   "description": "A ProzillaOS application for viewing different kinds of media.",
-  "version": "1.1.18",
+  "version": "1.1.21",
   "homepage": "https://os.prozilla.dev/media-viewer",
   "author": {
     "name": "Prozilla",
@@ -20,17 +20,19 @@
   "license": "MIT",
   "dependencies": {
     "react": "^18.3.1",
-    "@prozilla-os/core": "1.3.13"
+    "@prozilla-os/core": "2.0.1",
+    "@prozilla-os/skins": "1.1.9",
+    "@prozilla-os/shared": "1.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.5",
-    "@types/react": "^18.3.3",
+    "@types/react": "^18.3.27",
     "@vitejs/plugin-react-swc": "^3.7.0",
     "typescript": "^5.5.4",
-    "vite": "^5.4.8",
-    "vite-plugin-dts": "^3.9.1",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
     "vite-plugin-lib-inject-css": "^2.1.1",
-    "@prozilla-os/dev-tools": "1.1.10"
+    "@prozilla-os/dev-tools": "1.1.13"
   },
   "files": [
     "dist"