Editing Module:AbilitySection/docGive feedback

== Overview ==

Lua backend for [[Template:AbilitySection]]. Renders a two-column layout with the ability card on the left and an optional tabbed details panel on the right.

Between the card and the details panel, an interaction-hint rail of small item icons is rendered via [[Module:AbilityHints]] (showing how the ability interacts with items — dispellable, reduced, blocked, etc.). When a rail is present, the card and rail are grouped in a <code>.ability-section-main</code> wrapper so the rail always wraps together with the card rather than onto the details' line; abilities with no interactions keep the flat single-card structure.

Only tabs with non-empty content are shown. If two or more tabs have content, a Show All tab is automatically appended that stacks all content in sequence with section headers between them.

The Notes tab is height-constrained with a scrollbar when content overflows (see [[Template:AbilitySection/styles.css]]). Other tabs are unconstrained.

If no content params are provided, no details panel is rendered at all — only the ability card (and its hint rail, if any).

== Entry point ==

=== <code>p.render(frame)</code> ===
Called via <code><nowiki>{{#invoke:AbilitySection|render}}</nowiki></code>.

{| class="wikitable"
! Argument !! Required !! Description
|-
| <code>hero_name</code> || Yes || Passed through to [[Template:Ability card v2]].
|-
| <code>ability_num</code> || Yes || Passed through to [[Template:Ability card v2]].
|-
| <code>notes</code> || No || Wikitext for the Notes tab.
|-
| <code>interactions</code> || No || Wikitext for the Interactions tab.
|-
| <code>tips</code> || No || Wikitext for the Tips tab.
|}

== Constants ==

=== <code>TABS</code> ===
Defines list of possible tabs. Order here determines display order in the tabber.

<syntaxhighlight lang="lua">
local TABS = {
    { key = 'notes',        label = 'Notes'        },
    { key = 'interactions', label = 'Interactions' },
    { key = 'tips',         label = 'Tips'         },
}
</syntaxhighlight>

== Example ==

<pre>
{{AbilitySection
| hero_name   = Abrams
| ability_num = 1
| notes =
* This is an example of a note.
| interactions =
* This is an example of an interaction.
| tips =
* This is an example of a tip.
}}
</pre>

{{AbilitySection
| hero_name   = Abrams
| ability_num = 1
| notes =
* This is an example of a note.
| interactions =
* This is an example of an interaction.
| tips =
* This is an example of a tip.
}}

== Related pages ==

* [[Template:AbilitySection]] — template that invokes this module
* [[Module:AbilityHints]] — interaction-hint icons rendered beside the card
* [[Template:AbilitySection/styles.css]] — CSS for the layout