# stellrvr/stellrs-asl-combo-gestures architecture

> Architecture diagram of the GitHub repository stellrvr/stellrs-asl-combo-gestures, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stellrvr/stellrs-asl-combo-gestures
- Repository: https://github.com/stellrvr/stellrs-asl-combo-gestures

## Overview

##### Main Components
- Unity Package – Representing the overall package that will be imported into a Unity project.
- Gestures Animator Controller – The central module that controls the animations.
- Avatar Descriptor Integration – The point where the Gestures Animator Controller is dragged into the avatar’s descriptor slot.
- Avatar Expression Parameters – The two required boolean parameters ("CopyGesture" and "SignToggle") that control the behavior of the gestures.
- Expressions Menu – Where “Copy Gesture” and “Sign Toggle” options are added as toggles for the user.
- (Optional) External Animations/Setup – Indicate that some animations and scripts (credited to SaikoArt_Finn) are also part of the overall solution.

##### Highlighting Architectural Patterns or Design Principles
- Reuse and Modularity: The separation between animations and the controller makes it easy to swap or modify animations.
- Configuration by Convention: The integration with standard Unity features (avatar descriptor, expression parameters, and menu toggles) follows common practices.

##### Incorporating Relevant Technologies and Frameworks
- Unity Engine – as the runtime and development environment.
- Unity Animator Controller – which is a built-in component managing state transitions based on boolean parameters.
- The package leverages Unity’s asset and component system.

- Modularity and clear integration points so that another developer can quickly understand where and how to modify or debug each component.

## Diagram (Mermaid)

```mermaid
flowchart TD
    engine("Unity Engine"):::engine

    subgraph "Unity Package"
        pkgInfo("Unity Package"):::package
        controller("Gestures Animator Controller"):::controller
        animFolder("Animations Folder"):::folder
        external("External Animations/Setup (SaikoArt_Finn)"):::external
        pkgInfo --> controller
        controller -->|"fetches"| animFolder
        controller -->|"integrates"| external
    end

    engine -->|"hosts"| pkgInfo

    descriptor("Avatar Descriptor Integration"):::integration
    controller -->|"drag-drop"| descriptor

    paramCopy("Avatar Expression Parameter: CopyGesture"):::parameter
    paramToggle("Avatar Expression Parameter: SignToggle"):::parameter
    descriptor -->|"configures"| paramCopy
    descriptor -->|"configures"| paramToggle

    menu("Expressions Menu"):::menu
    paramCopy -->|"controls"| menu
    paramToggle -->|"controls"| menu

    click pkgInfo "https://github.com/stellrvr/stellrs-asl-combo-gestures/blob/main/README.md"

    classDef engine fill:#ffcc00,stroke:#000,stroke-width:2px;
    classDef package fill:#bbdef0,stroke:#000,stroke-width:2px;
    classDef controller fill:#90caf9,stroke:#000,stroke-width:2px;
    classDef folder fill:#a5d6a7,stroke:#000,stroke-width:2px;
    classDef external fill:#ce93d8,stroke:#000,stroke-width:2px;
    classDef integration fill:#d7ccc8,stroke:#000,stroke-width:2px;
    classDef parameter fill:#ef9a9a,stroke:#000,stroke-width:2px;
    classDef menu fill:#f48fb1,stroke:#000,stroke-width:2px;
```
