Operator Library
================

The **Sedaia Rig Interfaces** extension includes a central `operators` submodule that provides utility functions for both the UI and management tools. These operators are designed for efficiency and standard compliance.

Standard Prefixer System
------------------------

To avoid naming conflicts within the Blender environment, all operators follow the **Prefixer** naming system. This includes the major SACR and UI versions in the ID name.

**Example**:
-   Rig Manager Download: `SEDAIA_OT_sacr_7_ui_2_download_rig`
-   Skin Manager Apply: `SEDAIA_OT_sacr_7_ui_2_apply_skin`

Core Utility Operators
----------------------

Several low-level utility operators are available in the `src/operators` module:

File Operations
~~~~~~~~~~~~~~~
*   **OP_file_open**: Opens the operating system's file explorer at a specific path.
*   **OP_open_addon_directory**: Quickly opens the installation directory of the Sedaia extension.

Image Handling
~~~~~~~~~~~~~~
*   **OP_image_pack**: Packages an external image file into the current `.blend` file.
*   **OP_image_reload**: Force reloads an image from disk, useful when updating skin textures externally.

Rigging Tools
~~~~~~~~~~~~~
*   **OP_rig_rename**: A utility to batch rename rig bones or properties according to the Sakura standard.

Security and Guardrails
-----------------------

All operators that perform network-sensitive tasks (like `DownloadRig` or `UpdatePlayer`) include an internal check for `allow_online()`.

**Implementation details**:
-   The operator checks `bpy.app.online_access`.
-   If `False`, it calls `self.report({'WARNING'}, "Online functionality is disabled in Blender settings.")`.
-   The operator then returns `{'CANCELLED'}` to prevent any unapproved network requests.