1import { defineCapability } from '../../capabilities';
2import {
3	DOCS_DOMAIN,
4	DOCS_OWNERS,
5	DOCS_STABILITY,
6	DOCS_TAGS,
7} from '../constants';
8
9export const DocumentationSystemCapability = defineCapability({
10	meta: {
11		key: 'docs.system',
12		version: '1.0.0',
13		kind: 'ui',
14		title: 'Documentation System',
15		description: 'End-to-end docs generation, indexing, and presentation.',
16		domain: DOCS_DOMAIN,
17		owners: DOCS_OWNERS,
18		tags: [...DOCS_TAGS, 'system'],
19		stability: DOCS_STABILITY,
20	},
21	provides: [
22		{
23			surface: 'operation',
24			key: 'docs.generate',
25			version: '1.0.0',
26			description: 'Generate documentation artifacts.',
27		},
28		{
29			surface: 'operation',
30			key: 'docs.publish',
31			version: '1.0.0',
32			description: 'Publish documentation artifacts.',
33		},
34		{
35			surface: 'operation',
36			key: 'docs_search',
37			version: '1.0.0',
38			description: 'Index and search DocBlocks.',
39		},
40		{
41			surface: 'operation',
42			key: 'docs.contract.reference',
43			version: '1.0.0',
44			description: 'Resolve contract references for docs.',
45		},
46		{
47			surface: 'event',
48			key: 'docs.generated',
49			version: '1.0.0',
50			description: 'Docs generation completed.',
51		},
52		{
53			surface: 'event',
54			key: 'docs.published',
55			version: '1.0.0',
56			description: 'Docs publish completed.',
57		},
58		{
59			surface: 'presentation',
60			key: 'docs.layout',
61			version: '1.0.0',
62			description: 'Docs layout presentation.',
63		},
64		{
65			surface: 'presentation',
66			key: 'docs.reference.page',
67			version: '1.0.0',
68			description: 'Docs reference page presentation.',
69		},
70	],
71});