[BUG] Using `rst-class:: bignums-tip` for bulletpoints nested in tabs outputs the rst-class-tip in rendered documentation

[sbuerk]

Description

Following markup is used to display numbered bulletpoints in a tab using big numbers:

..  tabs::

    ..  group-tab:: Extension Manager

        ..  rst-class:: bignums-tip

        #.  Switch to the module :guilabel:`System > Extensions`.
        #.  Switch to :guilabel:`Get Extensions`
        #.  Search for the extension key :guilabel:`deepltranslate_core`
        #.  Import the extension from the repository.

Expected

• Tab is rendered with the bullet points using big green numbers

Actual

• (expected) Tab is rendered with the bullet points using big green numbers
• (not expected) bignums-tip is also rendered as text above the bullet point list

[ineswillenbrock]

Can confirm the "bignums-tip" on top of the ol. That happens with other rst-class too, eg with .. rst-class:: horizbuttons-attention-m

The styling of the numbers is the same since at least November 2023 (see https://github.com/TYPO3-Documentation/render-guides/blob/main/packages/typo3-docs-theme/assets/sass/components/customClasses/_bignums.scss)

[CybotTM]

Workaround for doc authors (verified locally against current main):

The leak triggers when rst-class has no body (blank line + sibling list). Indent the list so it becomes the directive's body instead of a sibling:

Before (leaks bignums-tip as text):

..  tabs::

    ..  group-tab:: Extension Manager

        ..  rst-class:: bignums-tip

        #.  Switch to the module :guilabel:`Admin Tools > Extensions`.
        #.  Get Extensions.

After (clean):

..  tabs::

    ..  group-tab:: Extension Manager

        ..  rst-class:: bignums-tip

            #.  Switch to the module :guilabel:`Admin Tools > Extensions`.
            #.  Get Extensions.

Rendered tab pane (relevant fragment):

<!-- BEFORE -->
<div class="tab-pane ..." id="extension-manager-tabs-1" ...>
    bignums-tip
<ol class="bignums-tip" type="1">
    <li>Switch to the module ...</li>

<!-- AFTER -->
<div class="tab-pane ..." id="extension-manager-tabs-1" ...>
<ol class="bignums-tip" type="1">
    <li>Switch to the module ...</li>

Both forms produce <ol class="bignums-tip"> — only the sibling form leaks the literal class name into the tab pane.

Why this works: with a body, ClassDirective returns a CollectionNode and never creates the standalone ClassNode whose value text is leaking.

Root cause: phpdocumentor/guides's Bootstrap TabsNode keeps tab children in two parallel arrays ($tabs private cache + $value from CompoundNode). The compiler's ClassNodeTransformer correctly removes the orphan ClassNode from $value, but the bootstrap-theme Twig template iterates the stale $tabs, which still references the pre-shadow-tree tab and its leftover ClassNode.

Upstream status — fix is in code but currently uninstallable:

• The fix landed incidentally via Move tabs/tab directive to rst package phpDocumentor/guides#1316 (commit phpDocumentor/guides@1bdb18c7) — the move of Tabs/Tab directives to guides-restructured-text turned the Bootstrap classes into deprecation shims that no longer carry the dual-storage bug.
• Tagged in phpdocumentor/guides-theme-bootstrap:1.9.7, but that release is uninstallable because it declares phpdocumentor/guides-restructured-text:^1.10 || ^2.0, and no 1.10.x of guides-restructured-text has been published on Packagist yet. composer update fails with a resolver error.
• Filed upstream: guides-theme-bootstrap 1.9.7 is uninstallable: requires unreleased guides-restructured-text ^1.10 phpDocumentor/guides#1341
• Until that's released, the container-form workaround above is the only option for render-guides consumers. Once guides-restructured-text:1.10.x ships, a composer update phpdocumentor/guides-theme-bootstrap in the render-guides repo should resolve this issue.

[CybotTM]

phpDocumentor/guides#1341 is now resovled, an update to the fixed version should now be possible.