HomeSoul v0.2.1 — Beta
Part of the HomeSuiteHome suite by Blodwedd Mallory
===============================================================================

QUICK START
-----------
1. Mark tab: name your mark, choose a type (Emote, Toy, Consumable, or Chain).
2. Set your timing mode (Loop, Timer, or Once).
3. Click Start Mark, walk to the spot in your house, click Place Here.
4. Soul tab: your mark is live. Pause, clone, or delete any time.


MARK TYPES
----------
EMOTE MARKS — gold square on the Soul tab.
Choose an emote from the dropdown (sleep, drink, dance, etc.). Fires
automatically when you walk into the mark radius.

TOY MARKS — green square on the Soul tab.
Choose a toy from your collection. On zone entry a prompt appears:
Use [Toy Name]? Click Yes to fire it. WoW requires a direct player
click for toy use — HomeSoul cannot fire toys automatically.
The prompt auto-dismisses in 10s and is suppressed if the toy is
on cooldown.

CONSUMABLE MARKS — orange square on the Soul tab.
Like toy marks, but for food, drinks, and other usable items.
Prompts on zone entry the same way toy marks do.

CHAIN MARKS — purple square on the Soul tab.
A sequence of emotes, toys, or consumables with configurable delays
between each step. Use chains for complex multi-action sequences
like a full meal routine or an arrival ritual.


TIMING MODES
------------
LOOP    Holds one pose continuously — sleeping in a bed, sitting in a chair.
        Fires every 30 seconds while you stay in the zone.

TIMER   Repeats on a clock — fires N times, X seconds apart, then stops
        until next zone entry. Use for multi-emote bursts.

ONCE    Fires once per zone visit. Re-triggers each time you leave and
        re-enter the zone radius.


AREAS TAB — ROOM BOUNDARIES
----------------------------
Areas define the rooms of your house. Marks are grouped by area in the
Soul tab, and zones live inside areas.

Adding an area: type a name and click Add.

Drawing a boundary:
  Polygon — walk each corner of the room and click Add Point (minimum 3).
             Click Close Polygon when done.
  Radius  — stand at the room center, click Set Center. Walk to the nearest
             wall, click Set Edge Point. Click Save.

Floor assignment:
  Select the floor your room is on. Click + Add Floor to add floors beyond
  the default two. The floor setting is required for accurate boundary
  detection in multi-floor houses.

Boundaries are shown as subnotes under each area name:
  "No boundary defined"
  "Polygon - 6 points, Floor 1"
  "Radius - 4.4 yds, Floor 1"

To edit a boundary, click Edit on the area and redraw it.

Delete: clicking Delete shows a Sure? confirmation before removing the area.
  Deleting an area is permanent — zones assigned to it revert to Freestanding
  and marks lose their area assignment.

Areas are scoped to the house where they were created. Switching houses
shows only that house's areas and zones.

Note: area detection (marks firing only when inside a boundary) is coming
in the next update. Boundaries set now will activate automatically when
the feature ships.


ZONES TAB — SUB-REGIONS
------------------------
Zones let you name and map sub-regions inside your house — a dance floor,
a quiet corner, the bar. Each zone belongs to a parent area.

Adding a zone: type a name, assign a parent area and floor, then click Add.

Drawing a boundary:
  Same tools as areas — Polygon (walk the corners) or Radius (center + edge).

Pause/enable: the checkbox pauses a zone without deleting it. A paused zone
dims in the list and its boundary is inactive.

Delete: clicking Delete shows a Sure? confirmation before the zone is removed.

Note: zone triggers — ambient effects that fire for any player who enters —
are coming soon. Boundaries set now will activate automatically when
the feature ships.


SOUL TAB — MANAGING YOUR MARKS
-------------------------------
The Soul tab is your mark list, organized by area. Each row shows the
mark name, type swatch, and timing mode.

Checkbox:  Pause a mark without deleting it. Paused marks stay saved
           but won't fire until re-enabled.

Edit:      Opens the mark form to change name, type, timing, or area.

Clone:     Duplicates a mark. Re-place it at a new location.

Del:       Permanently removes the mark.

Move & Re-place: Moves the mark's trigger position to your current location.
           Use this if a mark stops firing after moving furniture or if the
           mark was placed in a different housing session.


FLAVOR TEXT
-----------
Optional /me text that fires alongside the mark trigger.
Works for emote, toy, and consumable marks.
By default fires once per zone entry even if Fires > 1.
Check Repeat to send flavor text with every fire in a burst.


TOY PICKER
----------
Favorites Only (Options tab): shows only toys you have starred in
your Toy Box.
If the list is empty: open your Toy Box, star the toys you want,
then re-open the picker. Uncheck Favorites Only to see all.

CONSUMABLE PICKER
-----------------
Shows items currently in your bags. If a consumable mark fires and
the item is not in your inventory, the prompt will still appear but
the item cannot be used.


TROUBLESHOOTING
---------------
Marks not firing:
  Confirm you are in your own home instance. HomeSoul only fires
  marks when you are the housing owner.
  If yo