api

class MarvelousDesignerHost(HostBase, IWorkfileHost, ILoadHost, IPublishHost):
    """Host class for Marvelous Designer integration with AYON pipeline.

    This class provides the main interface between AYON and Marvelous Designer,
    implementing workfile operations, loading, and publishing functionality.

    Attributes:
        name (str): The host name identifier.
        _has_been_setup (bool): Flag indicating if the host has been
        initialized.
        callbacks (list): List of registered callbacks.
        shelves (list): List of UI shelves.
    """
    name = "marvelousdesigner"

    def __init__(self):
        """Initialize the Marvelous Designer host with default settings."""
        super().__init__()
        self._has_been_setup = False
        self.callbacks = []
        self.shelves = []

    @staticmethod
    def show_tools_dialog() -> None:
        """Show tools dialog with actions leading to show other tools."""
        show_tools_dialog()

    def install(self) -> None:
        """Install and register the MD host with Ayon pipeline."""
        pyblish.api.register_host("marvelousdesigner")

        pyblish.api.register_plugin_path(str(PUBLISH_PATH))
        register_loader_plugin_path(str(LOAD_PATH))
        register_creator_plugin_path(str(CREATE_PATH))

        self._has_been_setup = True

    def workfile_has_unsaved_changes(self) -> bool:  # noqa: PLR6301
        """Check if the current workfile has unsaved changes.

        Returns:
            bool: True if there are unsaved changes, False otherwise.
        """
        # API not supported for the check
        return utility_api.CheckZPRJForUnsavedChanges()

    def get_workfile_extensions(self) -> list[str]:  # noqa: PLR6301
        """Get the list of supported workfile extensions.

        Returns:
            list[str]: List of supported workfile extensions.
        """
        return [".zprj"]

    def save_workfile(self, dst_path: str | None = None) -> str | None:  # noqa: PLR6301
        """Save the current workfile to the specified destination path.

        Args:
            dst_path (str | None, optional): Destination path to save
                the workfile. Defaults to None.

        Returns:
            str | None: The path where the workfile was saved, or None
            if saving failed.
        """
        save_workfile(dst_path)
        return dst_path

    def open_workfile(self, filepath: str) -> None:  # noqa: PLR6301
        """Open a workfile from the specified file path."""
        open_workfile(filepath)

    def get_current_workfile(self) -> str:  # noqa: PLR6301
        """Get the current workfile path from the host.

        Returns:
            str: The current workfile path.
        """
        return utility_api.GetProjectFilePath()

    def get_containers(self) -> list:  # noqa: PLR6301
        """Get the list of containers in the current scene.

        Returns:
            list: List of container metadata dictionaries.
        """
        return ls()

    def update_context_data(self, data: dict, changes: dict) -> None:  # noqa : PLR6301
        """Update the context data in the current file metadata."""
        # Note: 'changes' parameter is part of the interface but not used in MD
        _ = changes  # Explicitly ignore the unused parameter
        set_metadata(AYON_CONTEXT_DATA, data)

    def get_context_data(self) -> dict:  # noqa: PLR6301
        """Get the context data from the current file metadata.

        Returns:
            dict: Context data dictionary.
        """
        metadata = get_ayon_metadata() or {}
        return metadata.get(AYON_CONTEXT_DATA, {})