CONTRIBUTING.md

Design Overview

┌─────────────┐   ┌────────────┐                             ┌────────────┐   ┌─────────────────────┐
│             ├───►            │                             │            ├───►                     │
│ host thread │   │            │                             │            │   │ compilation isolate │
│             ◄───┤            │         write stdin         │            ◄───┤                     │
└─────────────┘   │    ruby    ├─────────────────────────────►    dart    │   └─────────────────────┘
                  │            │      from host threads      │            │
┌─────────────┐   │    sass    │                             │    sass    │   ┌─────────────────────┐
│             ├───►            │                             │            ├───►                     │
│     ...     │   │  embedded  │                             │  embedded  │   │         ...         │
│             ◄───┤            │                             │            ◄───┤                     │
└─────────────┘   │    host    │                             │  compiler  │   └─────────────────────┘
                  │            │         read stdout         │            │
┌─────────────┐   │ dispatcher ◄─────────────────────────────┤ dispatcher │   ┌─────────────────────┐
│             ├───►            │      on polling thread      │            ├───►                     │
│ host thread │   │            │                             │            │   │ compilation isolate │
│             ◄───┤            │                             │            ◄───┤                     │
└─────────────┘   └────────────┘                             │            │   └─────────────────────┘
                                                             │            │
┌─────────────┐                                              │            │
│             │                          read stderr         │            │
│ ruby stderr ◄──────────────────────────────────────────────┤            │
│             │                       on polling thread      │            │
└─────────────┘                                              └────────────┘

Host Dispatcher State Diagram

┌───────────────────┐                                                            ┌─────────┐
│                   │                                                            │         │
│   Initialize...   │                                        ┌───────────────────►  Close  │
│                   │                                        │                   │         │
└─────────┬─────────┘                                        │                   └─────────┘
          │                                              Yes │
          │                                      ┌───────────┴──────────┐        ┌─────────┐
┌─────────▼─────────┐                         No │                      │    Yes │         │
│                   ◄────────────────────────────┤  id == 0xFFFFFFFF ?  ◄────────┤  Idle?  ◄──────────┐
│  id = 0x00000001  │                            │                      │        │         │          │
│                   ├───────────────┐            └──────────────────────┘        └─────────┘          │
└───────────────────┘               │                                                                 │
                       ┌────────────▼─────────�