Add attributes list page

Author: roxblnfk

.vitepress/config.mts

@@ -104,6 +104,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Guide',
               items: [
+                { text: 'All Attributes', link: '/docs/attributes.md' },
                 { text: 'CLI Reference', link: '/docs/cli-reference.md' },
                 { text: 'AI Agents', link: '/docs/ai-agents.md' },
               ],
@@ -168,6 +169,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Руководство',
               items: [
+                { text: 'Все атрибуты', link: '/ru/docs/attributes.md' },
                 { text: 'CLI справка', link: '/ru/docs/cli-reference.md' },
                 { text: 'AI-агенты', link: '/ru/docs/ai-agents.md' },
               ],

.vitepress/plugin-block.ts

@@ -73,6 +73,15 @@ export function getPluginEntry(localeCode: string, name: string): PluginRegistry
   return registry.get(localeCode)?.get(name.toLowerCase())
 }
 
+export function getPluginByPagePath(localeCode: string, pagePath: string): PluginRegistryEntry | undefined {
+  const map = registry.get(localeCode)
+  if (!map) return undefined
+  for (const entry of map.values()) {
+    if (entry.pagePath === pagePath) return entry
+  }
+  return undefined
+}
+
 // ─── Pre-scan ────────────────────────────────────────────
 
 /**

.vitepress/signature-registry.ts

@@ -254,6 +254,14 @@ export function preScanSignatures(srcDir: string): void {
   }
 }
 
+/**
+ * Return all attribute entries for a locale.
+ */
+export function getAllAttrEntries(localeCode: string): RegistryEntry[] {
+  const map = attrRegistry.get(localeCode)
+  return map ? [...map.values()] : []
+}
+
 /**
  * Look up a function signature entry by FQN and locale.
  */

.vitepress/signature.ts

@@ -12,8 +12,8 @@ import type MarkdownIt from 'markdown-it'
 import type StateInline from 'markdown-it/lib/rules_inline/state_inline.mjs'
 import type StateBlock from 'markdown-it/lib/rules_block/state_block.mjs'
 import { getLocaleByPath, type LocaleConfig } from './locales'
-import { getEntry, getAttrEntry, getClassEntry, getEnumCaseEntry } from './signature-registry'
-import { getPluginEntry } from './plugin-block'
+import { getEntry, getAttrEntry, getClassEntry, getEnumCaseEntry, getAllAttrEntries, type RegistryEntry } from './signature-registry'
+import { getPluginEntry, getPluginByPagePath } from './plugin-block'
 
 interface Param {
   name: string
@@ -377,6 +377,28 @@ export function funcBlockPlugin(md: MarkdownIt) {
     return renderEnumRefHtml(md, rawFqn, locale)
   })
 
+  // ── <attributes-list /> block rule ──
+
+  md.block.ruler.before('html_block', 'attributes_list', (state, startLine, _endLine, silent) => {
+    const pos = state.bMarks[startLine] + state.tShift[startLine]
+    const max = state.eMarks[startLine]
+    const line = state.src.slice(pos, max).trim()
+
+    if (line !== '<attributes-list />' && line !== '<attributes-list/>') return false
+    if (silent) return true
+
+    const token = state.push('attributes_list', '', 0)
+    const relativePath = state.env?.relativePath || ''
+    token.meta = { locale: getLocaleByPath('/' + relativePath) }
+    state.line = startLine + 1
+    return true
+  })
+
+  md.renderer.rules['attributes_list'] = (tokens, idx) => {
+    const locale = tokens[idx].meta?.locale
+    return renderAttributesList(md, locale)
+  }
+
   // ── <signature> block rule (multi-line) ──
 
   md.block.ruler.before('html_block', 'func_block', (state, startLine, endLine, silent) => {
@@ -756,3 +778,58 @@ function renderEnumBlock(md: MarkdownIt, data: EnumRenderData, env?: any): strin
   html += '</div>\n'
   return html
 }
+
+// ─── <attributes-list /> renderer ───────────────────────
+
+function renderAttributesList(md: MarkdownIt, locale?: LocaleConfig): string {
+  const localeCode = locale?.code ?? 'en'
+  const entries = getAllAttrEntries(localeCode)
+
+  if (entries.length === 0) return ''
+
+  // Group by pagePath
+  const groups = new Map<string, RegistryEntry[]>()
+  for (const entry of entries) {
+    const list = groups.get(entry.pagePath) || []
+    list.push(entry)
+    groups.set(entry.pagePath, list)
+  }
+
+  const tableLabels: Record<string, { attr: string; desc: string }> = {
+    en: { attr: 'Attribute', desc: 'Description' },
+    ru: { attr: 'Атрибут', desc: 'Описание' },
+  }
+  const l = tableLabels[localeCode] ?? tableLabels.en
+
+  // Sort groups by plugin name
+  const sortedGroups = [...groups.entries()].sort((a, b) => {
+    const nameA = getPluginByPagePath(localeCode, a[0])?.name ?? a[0]
+    const nameB = getPluginByPagePath(localeCode, b[0])?.name ?? b[0]
+    return nameA.localeCompare(nameB)
+  })
+
+  let html = ''
+
+  for (const [pagePath, attrs] of sortedGroups) {
+    const plugin = getPluginByPagePath(localeCode, pagePath)
+    const groupName = plugin?.name ?? pagePath.split('/').pop() ?? 'Unknown'
+    const slug = 'attrs-' + groupName.toLowerCase().replace(/\s+/g, '-')
+
+    if (plugin) {
+      const pluginHtml = renderPluginRefHtml(plugin.name, locale)
+      html += `<h2 id="${escapeHtml(slug)}">${pluginHtml}</h2>\n`
+    } else {
+      html += `<h2 id="${escapeHtml(slug)}">${escapeHtml(groupName)}</h2>\n`
+    }
+
+    html += `<table>\n<thead><tr><th>${escapeHtml(l.attr)}</th><th>${escapeHtml(l.desc)}</th></tr></thead>\n<tbody>\n`
+    for (const attr of attrs) {
+      const attrHtml = renderAttrRefHtml(md, attr.fqn, locale)
+      const shortHtml = attr.short ? md.renderInline(attr.short) : ''
+      html += `<tr><td>${attrHtml}</td><td>${shortHtml}</td></tr>\n`
+    }
+    html += '</tbody>\n</table>\n'
+  }
+
+  return html
+}

docs/attributes.md

@@ -0,0 +1,9 @@
+---
+llms_description: "Complete reference of all PHP attributes in Testo: #[Test], #[Retry], #[Bench], lifecycle hooks (#[BeforeTest], #[AfterTest], #[BeforeClass], #[AfterClass]), data providers (#[DataSet], #[DataProvider], #[DataZip], #[DataCross], #[DataUnion]), #[TestInline], coverage (#[Covers], #[CoversNothing])."
+---
+
+# All Attributes
+
+Testo uses PHP attributes to configure tests, lifecycle hooks, data providers, and more. This page lists all available attributes grouped by plugin. Click any attribute name for full documentation with parameters and examples.
+
+<attributes-list />

docs/plugins/data.md

@@ -6,6 +6,8 @@ llms_description: "Parameterized tests with data providers. #[DataSet] for inlin
 
 Data providers let you run one test with different sets of input data. Each set runs as a separate test.
 
+<plugin-info name="Data" />
+
 <signature h="2" name="#[\Testo\Data\DataSet(array $arguments, ?string $name = null)]">
 <short>Declares a set of arguments for a parameterized test. Can be used multiple times — each attribute creates a separate test run.</short>
 <param name="$arguments">Array of values passed to the test method.</param>

ru/docs/attributes.md

@@ -0,0 +1,5 @@
+# Все атрибуты
+
+Testo использует PHP-атрибуты для настройки тестов, хуков жизненного цикла, провайдеров данных и многого другого. На этой странице собраны все доступные атрибуты, сгруппированные по плагинам. Нажмите на название атрибута, чтобы перейти к полной документации с параметрами и примерами.
+
+<attributes-list />