src/content.py

"""Page copy: how-to, positioning, worked example, rules refresher, FAQs.

One H1 lives in the hero; every heading here is rendered as an H2 by
section_html. The primary keyword appears in the first paragraph and in
the "Why This DnD Initiative Tracker Is Turn Order Only" H2.
"""

_TABLE_STYLE = (
    "width:100%;border-collapse:collapse;margin:0.75rem 0;"
)
_CELL_STYLE = (
    "border:1px solid rgba(212,175,55,0.35);padding:0.55rem 0.8rem;"
    "text-align:left;color:rgba(242,230,206,0.85);vertical-align:top;"
)
_CODE_STYLE = (
    "background:var(--lf-panel-deep);color:var(--lf-gold);border-radius:4px;"
    "padding:0.1rem 0.4rem;font-family:monospace;"
)
_PRE_STYLE = (
    "background:var(--lf-panel-deep);color:var(--lf-cream);border:1px solid "
    "rgba(212,175,55,0.35);border-radius:8px;padding:1rem 1.25rem;"
    "overflow-x:auto;line-height:1.6;font-size:0.95rem;"
)


def _code(text: str) -> str:
    return f'<code style="{_CODE_STYLE}">{text}</code>'


HOW_TO_HTML = f"""
<p>This free <strong>DnD initiative tracker</strong> does exactly one job: it gets
your combat's turn order on screen and moving in seconds. No accounts, no encounter
prep, no stat blocks to fill in — type names into one box, let the tool roll for the
monsters, and hit Next until the fight is over. It runs entirely on this page and
remembers your order in your browser between visits.</p>
<ol>
<li><strong>Paste or type everyone into the quick-add box</strong>, one combatant per
line. Players who already rolled get their number; monsters get a modifier and the
tool rolls for them.</li>
<li><strong>Hit Add to Order.</strong> The list sorts itself highest-first instantly,
and the roll log shows exactly what was rolled for whom.</li>
<li><strong>Run the fight with Next.</strong> The current combatant is highlighted
with a gold border; when the last turn ends, the round counter ticks up
automatically. Back undoes an accidental click.</li>
<li><strong>Fix ties or surprises by hand.</strong> Select any combatant and use Move
Up / Move Down, or Remove them when they drop out. Copy Order exports the whole
list as plain text for your notes.</li>
</ol>
<p>The quick-add box understands a tiny syntax so one paste can set up a whole
encounter:</p>
<table style="{_TABLE_STYLE}">
<tr>
<th style="{_CELL_STYLE}color:var(--lf-gold);">You type</th>
<th style="{_CELL_STYLE}color:var(--lf-gold);">What happens</th>
</tr>
<tr><td style="{_CELL_STYLE}">{_code('Kira 18')}</td>
<td style="{_CELL_STYLE}">Adds Kira with initiative 18 — use this when a player
calls out the total they rolled. Entries added this way are tagged as PCs in the
list.</td></tr>
<tr><td style="{_CELL_STYLE}">{_code('Goblin x3 +2')}</td>
<td style="{_CELL_STYLE}">Creates Goblin 1, Goblin 2, and Goblin 3, and rolls a
separate d20+2 for each one. Any {_code('+N')} or {_code('-N')} ending is treated
as an initiative modifier, so {_code('Owlbear +1')} rolls d20+1 for a single
owlbear.</td></tr>
<tr><td style="{_CELL_STYLE}">{_code('Shadow')}</td>
<td style="{_CELL_STYLE}">A bare name. With "Roll d20 for names without a number"
checked (the default), the tool rolls a straight d20; unchecked, it adds the
combatant at 0 so you can fill the roll in later by removing and re-adding.</td></tr>
</table>
<p>Every roll is reported in the log under the button — "Goblin 2 rolled 14
(d20+2)" — so your table can see the dice were honest.</p>
"""

WHY_HTML = """
<p>Most initiative tools want to run your whole encounter: hit points, conditions,
death saves, legendary actions, monster stat blocks. That power costs setup time,
and setup time is exactly what kills the momentum of "roll initiative!" at a real
table. This tracker deliberately refuses all of it.</p>
<p>Turn order is the one thing every combat needs within thirty seconds of the
words being spoken. By tracking only names, numbers, and whose turn it is, this
tool stays fast enough to set up <em>after</em> initiative has already been rolled —
one paste, one click, fighting. There is nothing to configure, nothing to import,
and nothing on screen that isn't the answer to "who's next?"</p>
<p>If you want the heavier machinery — hit points ticking down, conditions with
round counts, the full battlefield ledger — we build that too: our combat tracker
(linked in the tools section below) runs the whole battle. Use that one for the
boss fight you prepped; use this one for the ambush you didn't.</p>
"""

EXAMPLE_HTML = f"""
<p>Say your party of two meets an owlbear and some goblins in the dark. The players
call out their totals, and you paste this into the quick-add box:</p>
<pre style="{_PRE_STYLE}">Kira 18
Torvin 12
Goblin x3 +2
Owlbear +1
Shadow</pre>
<p>The tool rolls five dice (three goblins, the owlbear, and the shadow), reports
each roll in the log, and produces an order like this — yours will differ because
the d20s are real rolls:</p>
<pre style="{_PRE_STYLE}">Initiative Order — Round 1
&gt; 1. Kira — 18 (PC)
  2. Owlbear — 15
  3. Goblin 2 — 14
  4. Torvin — 12 (PC)
  5. Shadow — 9
  6. Goblin 1 — 7
  7. Goblin 3 — 4</pre>
<p>Kira is highlighted as the current turn. From here the whole fight is the Next
button: seven clicks per round, the round counter climbs on its own, and when
Goblin 2 dies you select it and hit Remove without disturbing whose turn it is.</p>
"""

RULES_HTML = """
<p>A quick refresher on how initiative works by the book, and how this tool maps
onto it:</p>
<ul>
<li><strong>The roll.</strong> When combat starts, every creature makes a Dexterity
check: d20 plus their Dexterity modifier. The order runs highest to lowest and
repeats every round. That modifier is exactly what the quick-add
<em>+N</em> syntax expects — a goblin's DEX modifier is +2, so <em>Goblin x3
+2</em> rolls initiative for three goblins by the rules.</li>
<li><strong>Ties.</strong> By the rules, the DM decides ties between monsters and
players (the common convention is higher Dexterity score wins), and players decide
ties among themselves. This tracker doesn't guess for you: when a tie needs a
specific order, select a combatant and use Move Up or Move Down to set it. The
manual order sticks as you cycle turns.</li>
<li><strong>Surprise.</strong> Fifth edition has no separate "surprise round":
surprised creatures roll initiative normally but can't move or act on their first
turn (in the 2024 rules, being surprised instead gives disadvantage on the
initiative roll). Either way, the order itself is tracked exactly the same —
add everyone and skip or adjust as your table rules.</li>
<li><strong>Groups.</strong> Many DMs roll once for a whole group of identical
monsters to save time. This tool supports both styles: <em>Goblin x3 +2</em> rolls
each goblin separately, while typing <em>Goblins 14</em> puts the whole pack on one
count.</li>
</ul>
"""

FAQS = [
    (
        "How does initiative work in D&D 5e?",
        "When combat begins, every participant rolls a d20 and adds their Dexterity "
        "modifier. Turns then proceed from the highest total to the lowest, and the "
        "sequence repeats each round until the fight ends. This tracker automates "
        "the bookkeeping half: enter each combatant's total (or a modifier to roll "
        "for them), and it sorts the order and advances turns and rounds for you.",
    ),
    (
        "Who goes first on a tie?",
        "By the rules, the DM chooses how to break ties involving monsters — the "
        "common convention is that the creature with the higher Dexterity score "
        "goes first — and tied players decide the order among themselves. When "
        "you've settled it, select a combatant here and use Move Up or Move Down "
        "to lock in the order; it stays put as turns cycle.",
    ),
    (
        "How do DMs speed up initiative?",
        "Three habits do most of the work: have players roll the moment combat "
        "looks likely and call out totals instead of rolls; pre-roll or group-roll "
        "monsters; and keep the order somewhere everyone can see so nobody asks "
        "\"am I up?\" This tool is built around exactly those habits — one pasted "
        "block sets up the whole encounter, the modifier syntax rolls the monsters "
        "for you, and the highlighted current turn answers the question before "
        "it's asked.",
    ),
    (
        "Can my players see this screen?",
        "Yes — that's the recommended way to use it. Project the page, share your "
        "screen in your VTT call, or prop a tablet in the middle of the table. "
        "Since the tracker shows only names and numbers (no monster HP or secrets), "
        "there's nothing on screen you need to hide from players.",
    ),
    (
        "Does it save my order?",
        "Yes. The current order, round, and turn are stored in your browser's "
        "localStorage, so refreshing the page or coming back mid-session picks up "
        "exactly where you left off. Nothing is uploaded anywhere — the data never "
        "leaves your browser, which also means a different device starts fresh.",
    ),
    (
        "How is this different from the combat tracker?",
        "This tool is turn order only, built for speed: names, initiative numbers, "
        "whose turn it is, and what round you're on. Our combat tracker adds hit "
        "points, conditions, and the rest of the battlefield bookkeeping. If your "
        "fight needs HP tracking, use the combat tracker (linked below); if you "
        "just need the order moving right now, this one gets you fighting faster.",
    ),
    (
        "Can it roll initiative for monsters automatically?",
        "Yes. End a line with a modifier instead of a total — \"Owlbear +1\" rolls "
        "d20+1 for the owlbear, and \"Goblin x3 +2\" creates three goblins and "
        "rolls d20+2 separately for each. The roll log under the button shows "
        "every result, like \"Goblin 2 rolled 14 (d20+2)\", so the rolls are "
        "transparent to the table.",
    ),
]

DISCLAIMER_HTML = (
    '<p class="lf-disclaimer">'
    "This is an unofficial fan tool. Dungeons &amp; Dragons and D&amp;D are "
    "trademarks of Wizards of the Coast LLC. This tool is not affiliated with, "
    "endorsed, or sponsored by Wizards of the Coast. The tracker is deterministic "
    "— the only randomness is the d20 rolls you ask it to make — and your order "
    "is stored only in your own browser. This tool is built and maintained by "
    '<a href="https://loreify.ai">Loreify</a>, an AI session-notes app for '
    "D&amp;D campaigns.</p>"
)