@xpack/doxygen2docusaurus 2.0.0 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +2 -1
- package/bin/doxygen2docusaurus.js +1 -1
- package/dist/cli/main.d.ts +0 -14
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +0 -34
- package/dist/cli/main.js.map +1 -1
- package/dist/docusaurus/cli-options.d.ts +3 -292
- package/dist/docusaurus/cli-options.d.ts.map +1 -1
- package/dist/docusaurus/cli-options.js +6 -290
- package/dist/docusaurus/cli-options.js.map +1 -1
- package/dist/docusaurus/generator.d.ts +0 -172
- package/dist/docusaurus/generator.d.ts.map +1 -1
- package/dist/docusaurus/generator.js +20 -280
- package/dist/docusaurus/generator.js.map +1 -1
- package/dist/docusaurus/renderers/descriptiontype.d.ts +0 -417
- package/dist/docusaurus/renderers/descriptiontype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/descriptiontype.js +11 -555
- package/dist/docusaurus/renderers/descriptiontype.js.map +1 -1
- package/dist/docusaurus/renderers/docinternalstype.d.ts +0 -132
- package/dist/docusaurus/renderers/docinternalstype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/docinternalstype.js +0 -156
- package/dist/docusaurus/renderers/docinternalstype.js.map +1 -1
- package/dist/docusaurus/renderers/doclisttype.d.ts +0 -22
- package/dist/docusaurus/renderers/doclisttype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/doclisttype.js +0 -42
- package/dist/docusaurus/renderers/doclisttype.js.map +1 -1
- package/dist/docusaurus/renderers/doctabletype.d.ts +0 -88
- package/dist/docusaurus/renderers/doctabletype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/doctabletype.js +1 -113
- package/dist/docusaurus/renderers/doctabletype.js.map +1 -1
- package/dist/docusaurus/renderers/doctitletype.d.ts +0 -22
- package/dist/docusaurus/renderers/doctitletype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/doctitletype.js +0 -42
- package/dist/docusaurus/renderers/doctitletype.js.map +1 -1
- package/dist/docusaurus/renderers/docvariablelisttype.d.ts +0 -44
- package/dist/docusaurus/renderers/docvariablelisttype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/docvariablelisttype.js +1 -69
- package/dist/docusaurus/renderers/docvariablelisttype.js.map +1 -1
- package/dist/docusaurus/renderers/docxrefsecttype.d.ts +0 -22
- package/dist/docusaurus/renderers/docxrefsecttype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/docxrefsecttype.js +0 -38
- package/dist/docusaurus/renderers/docxrefsecttype.js.map +1 -1
- package/dist/docusaurus/renderers/element-renderer-base.d.ts +0 -74
- package/dist/docusaurus/renderers/element-renderer-base.d.ts.map +1 -1
- package/dist/docusaurus/renderers/element-renderer-base.js +0 -64
- package/dist/docusaurus/renderers/element-renderer-base.js.map +1 -1
- package/dist/docusaurus/renderers/inctype.d.ts +0 -23
- package/dist/docusaurus/renderers/inctype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/inctype.js +0 -41
- package/dist/docusaurus/renderers/inctype.js.map +1 -1
- package/dist/docusaurus/renderers/linkedtexttype.d.ts +0 -22
- package/dist/docusaurus/renderers/linkedtexttype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/linkedtexttype.js +0 -45
- package/dist/docusaurus/renderers/linkedtexttype.js.map +1 -1
- package/dist/docusaurus/renderers/listingtype.d.ts +0 -52
- package/dist/docusaurus/renderers/listingtype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/listingtype.js +1 -88
- package/dist/docusaurus/renderers/listingtype.js.map +1 -1
- package/dist/docusaurus/renderers/paramtype.d.ts +0 -22
- package/dist/docusaurus/renderers/paramtype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/paramtype.js +2 -51
- package/dist/docusaurus/renderers/paramtype.js.map +1 -1
- package/dist/docusaurus/renderers/referencetype.d.ts +0 -23
- package/dist/docusaurus/renderers/referencetype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/referencetype.js +0 -38
- package/dist/docusaurus/renderers/referencetype.js.map +1 -1
- package/dist/docusaurus/renderers/reftexttype.d.ts +0 -22
- package/dist/docusaurus/renderers/reftexttype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/reftexttype.js +0 -38
- package/dist/docusaurus/renderers/reftexttype.js.map +1 -1
- package/dist/docusaurus/renderers/reftype.d.ts +0 -22
- package/dist/docusaurus/renderers/reftype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/reftype.js +0 -38
- package/dist/docusaurus/renderers/reftype.js.map +1 -1
- package/dist/docusaurus/renderers/renderers.d.ts +0 -151
- package/dist/docusaurus/renderers/renderers.d.ts.map +1 -1
- package/dist/docusaurus/renderers/renderers.js +4 -184
- package/dist/docusaurus/renderers/renderers.js.map +1 -1
- package/dist/docusaurus/renderers/substringtype.d.ts +0 -22
- package/dist/docusaurus/renderers/substringtype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/substringtype.js +0 -39
- package/dist/docusaurus/renderers/substringtype.js.map +1 -1
- package/dist/docusaurus/renderers/tableofcontentstype.d.ts +0 -22
- package/dist/docusaurus/renderers/tableofcontentstype.d.ts.map +1 -1
- package/dist/docusaurus/renderers/tableofcontentstype.js +0 -39
- package/dist/docusaurus/renderers/tableofcontentstype.js.map +1 -1
- package/dist/docusaurus/types.d.ts +0 -110
- package/dist/docusaurus/types.d.ts.map +1 -1
- package/dist/docusaurus/types.js +0 -11
- package/dist/docusaurus/types.js.map +1 -1
- package/dist/docusaurus/utils.d.ts +0 -214
- package/dist/docusaurus/utils.d.ts.map +1 -1
- package/dist/docusaurus/utils.js +0 -296
- package/dist/docusaurus/utils.js.map +1 -1
- package/dist/docusaurus/view-model/classes-vm.d.ts +0 -137
- package/dist/docusaurus/view-model/classes-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/classes-vm.js +9 -225
- package/dist/docusaurus/view-model/classes-vm.js.map +1 -1
- package/dist/docusaurus/view-model/collection-base.d.ts +0 -120
- package/dist/docusaurus/view-model/collection-base.d.ts.map +1 -1
- package/dist/docusaurus/view-model/collection-base.js +11 -101
- package/dist/docusaurus/view-model/collection-base.js.map +1 -1
- package/dist/docusaurus/view-model/compound-base-vm.d.ts +2 -147
- package/dist/docusaurus/view-model/compound-base-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/compound-base-vm.js +47 -225
- package/dist/docusaurus/view-model/compound-base-vm.js.map +1 -1
- package/dist/docusaurus/view-model/concepts-vm.d.ts +26 -0
- package/dist/docusaurus/view-model/concepts-vm.d.ts.map +1 -0
- package/dist/docusaurus/view-model/concepts-vm.js +329 -0
- package/dist/docusaurus/view-model/concepts-vm.js.map +1 -0
- package/dist/docusaurus/view-model/description-anchors.d.ts +0 -58
- package/dist/docusaurus/view-model/description-anchors.d.ts.map +1 -1
- package/dist/docusaurus/view-model/description-anchors.js +0 -71
- package/dist/docusaurus/view-model/description-anchors.js.map +1 -1
- package/dist/docusaurus/view-model/files-and-folders-vm.d.ts +0 -247
- package/dist/docusaurus/view-model/files-and-folders-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/files-and-folders-vm.js +61 -353
- package/dist/docusaurus/view-model/files-and-folders-vm.js.map +1 -1
- package/dist/docusaurus/view-model/groups-vm.d.ts +0 -148
- package/dist/docusaurus/view-model/groups-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/groups-vm.js +2 -223
- package/dist/docusaurus/view-model/groups-vm.js.map +1 -1
- package/dist/docusaurus/view-model/members-vm.d.ts +0 -552
- package/dist/docusaurus/view-model/members-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/members-vm.js +17 -702
- package/dist/docusaurus/view-model/members-vm.js.map +1 -1
- package/dist/docusaurus/view-model/namespaces-vm.d.ts +4 -199
- package/dist/docusaurus/view-model/namespaces-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/namespaces-vm.js +79 -284
- package/dist/docusaurus/view-model/namespaces-vm.js.map +1 -1
- package/dist/docusaurus/view-model/options.d.ts +0 -43
- package/dist/docusaurus/view-model/options.d.ts.map +1 -1
- package/dist/docusaurus/view-model/options.js +0 -57
- package/dist/docusaurus/view-model/options.js.map +1 -1
- package/dist/docusaurus/view-model/pages-vm.d.ts +0 -115
- package/dist/docusaurus/view-model/pages-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/pages-vm.js +0 -162
- package/dist/docusaurus/view-model/pages-vm.js.map +1 -1
- package/dist/docusaurus/view-model/tree-entries-vm.d.ts +8 -142
- package/dist/docusaurus/view-model/tree-entries-vm.d.ts.map +1 -1
- package/dist/docusaurus/view-model/tree-entries-vm.js +54 -174
- package/dist/docusaurus/view-model/tree-entries-vm.js.map +1 -1
- package/dist/docusaurus/view-model/view-model.d.ts +0 -125
- package/dist/docusaurus/view-model/view-model.d.ts.map +1 -1
- package/dist/docusaurus/view-model/view-model.js +20 -182
- package/dist/docusaurus/view-model/view-model.js.map +1 -1
- package/dist/docusaurus/workspace.d.ts +1 -126
- package/dist/docusaurus/workspace.d.ts.map +1 -1
- package/dist/docusaurus/workspace.js +8 -221
- package/dist/docusaurus/workspace.js.map +1 -1
- package/dist/doxygen/data-model/compounds/compounddef-dm.d.ts +5 -492
- package/dist/doxygen/data-model/compounds/compounddef-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/compounddef-dm.js +23 -672
- package/dist/doxygen/data-model/compounds/compounddef-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/compoundreftype-dm.d.ts +0 -129
- package/dist/doxygen/data-model/compounds/compoundreftype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/compoundreftype-dm.js +1 -145
- package/dist/doxygen/data-model/compounds/compoundreftype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/descriptiontype-dm.d.ts +104 -2848
- package/dist/doxygen/data-model/compounds/descriptiontype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/descriptiontype-dm.js +73 -3975
- package/dist/doxygen/data-model/compounds/descriptiontype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/docvarlistentrytype-dm.d.ts +0 -165
- package/dist/doxygen/data-model/compounds/docvarlistentrytype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/docvarlistentrytype-dm.js +0 -229
- package/dist/doxygen/data-model/compounds/docvarlistentrytype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/doxygentype-dm.d.ts +0 -70
- package/dist/doxygen/data-model/compounds/doxygentype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/doxygentype-dm.js +0 -105
- package/dist/doxygen/data-model/compounds/doxygentype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/enumvaluetype-dm.d.ts +0 -84
- package/dist/doxygen/data-model/compounds/enumvaluetype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/enumvaluetype-dm.js +1 -122
- package/dist/doxygen/data-model/compounds/enumvaluetype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/inctype-dm.d.ts +0 -116
- package/dist/doxygen/data-model/compounds/inctype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/inctype-dm.js +3 -155
- package/dist/doxygen/data-model/compounds/inctype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/linkedtexttype-dm.d.ts +3 -138
- package/dist/doxygen/data-model/compounds/linkedtexttype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/linkedtexttype-dm.js +5 -180
- package/dist/doxygen/data-model/compounds/linkedtexttype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/listofallmemberstype-dm.d.ts +0 -76
- package/dist/doxygen/data-model/compounds/listofallmemberstype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/listofallmemberstype-dm.js +0 -107
- package/dist/doxygen/data-model/compounds/listofallmemberstype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/locationtype-dm.d.ts +0 -162
- package/dist/doxygen/data-model/compounds/locationtype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/locationtype-dm.js +4 -203
- package/dist/doxygen/data-model/compounds/locationtype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/memberdeftype-dm.d.ts +2 -443
- package/dist/doxygen/data-model/compounds/memberdeftype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/memberdeftype-dm.js +19 -475
- package/dist/doxygen/data-model/compounds/memberdeftype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/memberreftype-dm.d.ts +0 -141
- package/dist/doxygen/data-model/compounds/memberreftype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/memberreftype-dm.js +0 -176
- package/dist/doxygen/data-model/compounds/memberreftype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/membertype-dm.d.ts +0 -101
- package/dist/doxygen/data-model/compounds/membertype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/membertype-dm.js +0 -115
- package/dist/doxygen/data-model/compounds/membertype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/paramtype-dm.d.ts +0 -164
- package/dist/doxygen/data-model/compounds/paramtype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/paramtype-dm.js +0 -208
- package/dist/doxygen/data-model/compounds/paramtype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/referencetype-dm.d.ts +0 -139
- package/dist/doxygen/data-model/compounds/referencetype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/referencetype-dm.js +2 -175
- package/dist/doxygen/data-model/compounds/referencetype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/reftexttype-dm.d.ts +0 -120
- package/dist/doxygen/data-model/compounds/reftexttype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/reftexttype-dm.js +2 -141
- package/dist/doxygen/data-model/compounds/reftexttype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/reftype-dm.d.ts +0 -268
- package/dist/doxygen/data-model/compounds/reftype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/reftype-dm.js +4 -326
- package/dist/doxygen/data-model/compounds/reftype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/reimplementtype-dm.d.ts +0 -105
- package/dist/doxygen/data-model/compounds/reimplementtype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/reimplementtype-dm.js +1 -139
- package/dist/doxygen/data-model/compounds/reimplementtype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/sectiondeftype-dm.d.ts +0 -168
- package/dist/doxygen/data-model/compounds/sectiondeftype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/sectiondeftype-dm.js +0 -209
- package/dist/doxygen/data-model/compounds/sectiondeftype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/tableofcontentstype-dm.d.ts +0 -267
- package/dist/doxygen/data-model/compounds/tableofcontentstype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/tableofcontentstype-dm.js +0 -354
- package/dist/doxygen/data-model/compounds/tableofcontentstype-dm.js.map +1 -1
- package/dist/doxygen/data-model/compounds/templateparamlisttype-dm.d.ts +0 -66
- package/dist/doxygen/data-model/compounds/templateparamlisttype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/compounds/templateparamlisttype-dm.js +0 -97
- package/dist/doxygen/data-model/compounds/templateparamlisttype-dm.js.map +1 -1
- package/dist/doxygen/data-model/data-model.d.ts +0 -149
- package/dist/doxygen/data-model/data-model.d.ts.map +1 -1
- package/dist/doxygen/data-model/data-model.js +4 -197
- package/dist/doxygen/data-model/data-model.js.map +1 -1
- package/dist/doxygen/data-model/doxyfile/doxyfileoptiontype-dm.d.ts +0 -115
- package/dist/doxygen/data-model/doxyfile/doxyfileoptiontype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/doxyfile/doxyfileoptiontype-dm.js +4 -129
- package/dist/doxygen/data-model/doxyfile/doxyfileoptiontype-dm.js.map +1 -1
- package/dist/doxygen/data-model/doxyfile/doxyfiletype-dm.d.ts +0 -87
- package/dist/doxygen/data-model/doxyfile/doxyfiletype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/doxyfile/doxyfiletype-dm.js +0 -118
- package/dist/doxygen/data-model/doxyfile/doxyfiletype-dm.js.map +1 -1
- package/dist/doxygen/data-model/doxygen-xml-parser.d.ts +0 -253
- package/dist/doxygen/data-model/doxygen-xml-parser.d.ts.map +1 -1
- package/dist/doxygen/data-model/doxygen-xml-parser.js +0 -291
- package/dist/doxygen/data-model/doxygen-xml-parser.js.map +1 -1
- package/dist/doxygen/data-model/index/indexcompoundtype-dm.d.ts +0 -98
- package/dist/doxygen/data-model/index/indexcompoundtype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/index/indexcompoundtype-dm.js +2 -122
- package/dist/doxygen/data-model/index/indexcompoundtype-dm.js.map +1 -1
- package/dist/doxygen/data-model/index/indexdoxygentype-dm.d.ts +0 -82
- package/dist/doxygen/data-model/index/indexdoxygentype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/index/indexdoxygentype-dm.js +0 -114
- package/dist/doxygen/data-model/index/indexdoxygentype-dm.js.map +1 -1
- package/dist/doxygen/data-model/index/indexmembertype-dm.d.ts +0 -85
- package/dist/doxygen/data-model/index/indexmembertype-dm.d.ts.map +1 -1
- package/dist/doxygen/data-model/index/indexmembertype-dm.js +1 -107
- package/dist/doxygen/data-model/index/indexmembertype-dm.js.map +1 -1
- package/dist/doxygen/data-model/types.d.ts +0 -104
- package/dist/doxygen/data-model/types.d.ts.map +1 -1
- package/dist/doxygen/data-model/types.js +0 -52
- package/dist/doxygen/data-model/types.js.map +1 -1
- package/dist/index.d.ts +4 -16
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -42
- package/dist/index.js.map +1 -1
- package/package.json +45 -51
- package/src/cli/main.ts +122 -0
- package/src/docusaurus/cli-options.ts +560 -0
- package/src/docusaurus/generator.ts +788 -0
- package/src/docusaurus/renderers/descriptiontype.ts +1299 -0
- package/src/docusaurus/renderers/docinternalstype.ts +354 -0
- package/src/docusaurus/renderers/doclisttype.ts +134 -0
- package/src/docusaurus/renderers/doctabletype.ts +220 -0
- package/src/docusaurus/renderers/doctitletype.ts +77 -0
- package/src/docusaurus/renderers/docvariablelisttype.ts +123 -0
- package/src/docusaurus/renderers/docxrefsecttype.ts +84 -0
- package/src/docusaurus/renderers/element-renderer-base.ts +112 -0
- package/src/docusaurus/renderers/inctype.ts +75 -0
- package/src/docusaurus/renderers/linkedtexttype.ts +64 -0
- package/src/docusaurus/renderers/listingtype.ts +235 -0
- package/src/docusaurus/renderers/paramtype.ts +116 -0
- package/src/docusaurus/renderers/referencetype.ts +83 -0
- package/src/docusaurus/renderers/reftexttype.ts +81 -0
- package/src/docusaurus/renderers/reftype.ts +77 -0
- package/src/docusaurus/renderers/renderers.ts +756 -0
- package/src/docusaurus/renderers/substringtype.ts +53 -0
- package/src/docusaurus/renderers/tableofcontentstype.ts +74 -0
- package/src/docusaurus/types.ts +187 -0
- package/src/docusaurus/utils.ts +409 -0
- package/src/docusaurus/view-model/README.md +12 -0
- package/src/docusaurus/view-model/classes-vm.ts +1088 -0
- package/src/docusaurus/view-model/collection-base.ts +352 -0
- package/src/docusaurus/view-model/compound-base-vm.ts +1340 -0
- package/src/docusaurus/view-model/concepts-vm.ts +719 -0
- package/src/docusaurus/view-model/description-anchors.ts +107 -0
- package/src/docusaurus/view-model/files-and-folders-vm.ts +1293 -0
- package/src/docusaurus/view-model/groups-vm.ts +548 -0
- package/src/docusaurus/view-model/members-vm.ts +1943 -0
- package/src/docusaurus/view-model/namespaces-vm.ts +1018 -0
- package/src/docusaurus/view-model/options.ts +95 -0
- package/src/docusaurus/view-model/pages-vm.ts +342 -0
- package/src/docusaurus/view-model/tree-entries-vm.ts +376 -0
- package/src/docusaurus/view-model/view-model.ts +513 -0
- package/src/docusaurus/workspace.ts +588 -0
- package/src/doxygen/data-model/README.md +13 -0
- package/src/doxygen/data-model/compounds/compounddef-dm.ts +1156 -0
- package/src/doxygen/data-model/compounds/compoundreftype-dm.ts +266 -0
- package/src/doxygen/data-model/compounds/descriptiontype-dm.ts +10107 -0
- package/src/doxygen/data-model/compounds/docvarlistentrytype-dm.ts +354 -0
- package/src/doxygen/data-model/compounds/doxygentype-dm.ts +187 -0
- package/src/doxygen/data-model/compounds/enumvaluetype-dm.ts +218 -0
- package/src/doxygen/data-model/compounds/inctype-dm.ts +217 -0
- package/src/doxygen/data-model/compounds/linkedtexttype-dm.ts +288 -0
- package/src/doxygen/data-model/compounds/listofallmemberstype-dm.ts +160 -0
- package/src/doxygen/data-model/compounds/locationtype-dm.ts +284 -0
- package/src/doxygen/data-model/compounds/memberdeftype-dm.ts +874 -0
- package/src/doxygen/data-model/compounds/memberreftype-dm.ts +270 -0
- package/src/doxygen/data-model/compounds/membertype-dm.ts +239 -0
- package/src/doxygen/data-model/compounds/paramtype-dm.ts +302 -0
- package/src/doxygen/data-model/compounds/referencetype-dm.ts +248 -0
- package/src/doxygen/data-model/compounds/reftexttype-dm.ts +234 -0
- package/src/doxygen/data-model/compounds/reftype-dm.ts +430 -0
- package/src/doxygen/data-model/compounds/reimplementtype-dm.ts +201 -0
- package/src/doxygen/data-model/compounds/sectiondeftype-dm.ts +330 -0
- package/src/doxygen/data-model/compounds/tableofcontentstype-dm.ts +563 -0
- package/src/doxygen/data-model/compounds/templateparamlisttype-dm.ts +150 -0
- package/src/doxygen/data-model/data-model.ts +377 -0
- package/src/doxygen/data-model/doxyfile/doxyfileoptiontype-dm.ts +271 -0
- package/src/doxygen/data-model/doxyfile/doxyfiletype-dm.ts +200 -0
- package/src/doxygen/data-model/doxygen-xml-parser.ts +522 -0
- package/src/doxygen/data-model/index/indexcompoundtype-dm.ts +256 -0
- package/src/doxygen/data-model/index/indexdoxygentype-dm.ts +196 -0
- package/src/doxygen/data-model/index/indexmembertype-dm.ts +230 -0
- package/src/doxygen/data-model/types.ts +175 -0
- package/src/doxygen/data-model/xsds/README.md +6 -0
- package/src/doxygen/data-model/xsds/compound.xsd +1699 -0
- package/src/doxygen/data-model/xsds/doxyfile.xsd +355 -0
- package/src/doxygen/data-model/xsds/index.xsd +72 -0
- package/src/doxygen/data-model/xsds/xml.xsd +23 -0
- package/src/index.ts +261 -0
- package/src/tsconfig.json +10 -0
- package/dist/doxygen2docusaurus.d.ts +0 -4774
- package/dist/tsconfig.tsbuildinfo +0 -1
- package/dist/tsdoc-metadata.json +0 -11
|
@@ -1,14 +1,3 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* This file is part of the xPack project (http://xpack.github.io).
|
|
3
|
-
* Copyright (c) 2025 Liviu Ionescu. All rights reserved.
|
|
4
|
-
*
|
|
5
|
-
* Permission to use, copy, modify, and/or distribute this software
|
|
6
|
-
* for any purpose is hereby granted, under the terms of the MIT license.
|
|
7
|
-
*
|
|
8
|
-
* If a copy of the license was not distributed with this file, it can
|
|
9
|
-
* be obtained from https://opensource.org/licenses/MIT.
|
|
10
|
-
*/
|
|
11
|
-
// ----------------------------------------------------------------------------
|
|
12
1
|
import assert from 'node:assert';
|
|
13
2
|
import { AbstractCompoundDefType } from '../../doxygen/data-model/compounds/compounddef-dm.js';
|
|
14
3
|
import { TocItemDataModel, TocListDataModel, } from '../../doxygen/data-model/compounds/tableofcontentstype-dm.js';
|
|
@@ -22,68 +11,25 @@ import { Namespaces } from './namespaces-vm.js';
|
|
|
22
11
|
import { Pages } from './pages-vm.js';
|
|
23
12
|
import { AbstractDocAnchorType, AbstractDocSectType, } from '../../doxygen/data-model/compounds/descriptiontype-dm.js';
|
|
24
13
|
import { stripPermalinkHexAnchor } from '../utils.js';
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* View model that organises data for documentation generation.
|
|
28
|
-
*
|
|
29
|
-
* @remarks
|
|
30
|
-
* The ViewModel class transforms the raw Doxygen data model into structured
|
|
31
|
-
* collections suitable for generating Docusaurus documentation, including
|
|
32
|
-
* classes, files, namespaces, and other compound types. It coordinates the
|
|
33
|
-
* entire view model creation process, from object instantiation through
|
|
34
|
-
* hierarchy establishment to cross-reference resolution.
|
|
35
|
-
*
|
|
36
|
-
* @public
|
|
37
|
-
*/
|
|
14
|
+
import { Concepts } from './concepts-vm.js';
|
|
38
15
|
export class ViewModel {
|
|
39
|
-
/** Configuration options controlling the view model behaviour. */
|
|
40
16
|
options;
|
|
41
|
-
/** Reference to the parent workspace containing the data model. */
|
|
42
17
|
workspace;
|
|
43
|
-
/** Map of collection names to their corresponding collection objects. */
|
|
44
|
-
// The key is one of the above collection names.
|
|
45
|
-
// groups, classes, namespaces, files, pages.
|
|
46
18
|
collections;
|
|
47
|
-
/** Map of compound identifiers to their view model objects. */
|
|
48
|
-
// View model objects.
|
|
49
19
|
compoundsById = new Map();
|
|
50
|
-
/** Map of member identifiers to their view model objects. */
|
|
51
20
|
membersById = new Map();
|
|
52
|
-
/** Array of description table of contents lists for navigation. */
|
|
53
21
|
descriptionTocLists = [];
|
|
54
|
-
/** Map of TOC item identifiers to their corresponding objects. */
|
|
55
22
|
descriptionTocItemsById = new Map();
|
|
56
|
-
/** Map of description anchor identifiers to their objects. */
|
|
57
23
|
descriptionAnchorsById = new Map();
|
|
58
|
-
/**
|
|
59
|
-
* Constructs a new ViewModel instance.
|
|
60
|
-
*
|
|
61
|
-
* @remarks
|
|
62
|
-
* Initialises the view model with a reference to the parent workspace
|
|
63
|
-
* and sets up the collection mapping structure. This constructor prepares
|
|
64
|
-
* the foundation for transforming raw Doxygen data into organised
|
|
65
|
-
* documentation structures suitable for Docusaurus generation.
|
|
66
|
-
*
|
|
67
|
-
* @param workspace - The parent workspace containing the data model.
|
|
68
|
-
*/
|
|
69
24
|
constructor(workspace) {
|
|
70
25
|
this.workspace = workspace;
|
|
71
26
|
this.options = workspace.options;
|
|
72
27
|
this.collections = new Map();
|
|
73
28
|
}
|
|
74
|
-
/**
|
|
75
|
-
* Creates and populates all view model collections and objects.
|
|
76
|
-
*
|
|
77
|
-
* @remarks
|
|
78
|
-
* Orchestrates the complete view model creation process including
|
|
79
|
-
* collection instantiation, object creation, and hierarchy establishment.
|
|
80
|
-
* This method coordinates all phases of view model construction to ensure
|
|
81
|
-
* proper dependencies and cross-references are established between
|
|
82
|
-
* documentation elements.
|
|
83
|
-
*/
|
|
84
29
|
create() {
|
|
85
30
|
this.collections.set('groups', new Groups(this.workspace));
|
|
86
31
|
this.collections.set('namespaces', new Namespaces(this.workspace));
|
|
32
|
+
this.collections.set('concepts', new Concepts(this.workspace));
|
|
87
33
|
this.collections.set('classes', new Classes(this.workspace));
|
|
88
34
|
this.collections.set('files', new FilesAndFolders(this.workspace));
|
|
89
35
|
this.collections.set('pages', new Pages(this.workspace));
|
|
@@ -95,17 +41,6 @@ export class ViewModel {
|
|
|
95
41
|
this.validatePermalinks();
|
|
96
42
|
this.cleanups();
|
|
97
43
|
}
|
|
98
|
-
// --------------------------------------------------------------------------
|
|
99
|
-
/**
|
|
100
|
-
* Creates view model objects from the parsed Doxygen compound definitions.
|
|
101
|
-
*
|
|
102
|
-
* @remarks
|
|
103
|
-
* Iterates through all compound definitions from the data model and creates
|
|
104
|
-
* corresponding view model objects, organising them into appropriate
|
|
105
|
-
* collections and establishing identifier mappings. This method also
|
|
106
|
-
* processes detailed descriptions to extract navigation elements and
|
|
107
|
-
* cross-reference anchors for comprehensive documentation structure.
|
|
108
|
-
*/
|
|
109
44
|
createVieModelObjects() {
|
|
110
45
|
console.log('Creating view model objects...');
|
|
111
46
|
for (const compoundDefDataModel of this.workspace.dataModel.compoundDefs) {
|
|
@@ -114,14 +49,11 @@ export class ViewModel {
|
|
|
114
49
|
const collectionName = this.workspace.collectionNamesByKind[kind];
|
|
115
50
|
const collection = this.collections.get(collectionName);
|
|
116
51
|
if (collection !== undefined) {
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
// )
|
|
52
|
+
if (this.options.debug) {
|
|
53
|
+
console.log(compoundDefDataModel.kind, compoundDefDataModel.compoundName);
|
|
54
|
+
}
|
|
121
55
|
compound = collection.addChild(compoundDefDataModel);
|
|
122
|
-
// Also add it to the global compounds map.
|
|
123
56
|
this.compoundsById.set(compound.id, compound);
|
|
124
|
-
// console.log('compoundsById.set', compound.kind, compound.id)
|
|
125
57
|
}
|
|
126
58
|
if (compound !== undefined) {
|
|
127
59
|
if (compoundDefDataModel instanceof AbstractCompoundDefType &&
|
|
@@ -130,39 +62,20 @@ export class ViewModel {
|
|
|
130
62
|
}
|
|
131
63
|
}
|
|
132
64
|
else {
|
|
133
|
-
// console.error(
|
|
134
|
-
// util.inspect(compoundDefDataModel, { compact: false, depth: 999 })
|
|
135
|
-
// )
|
|
136
65
|
console.error('compoundDefDataModel', compoundDefDataModel.kind, 'not implemented yet in', this.constructor.name, 'createVieModelObjects');
|
|
137
66
|
}
|
|
138
67
|
}
|
|
139
68
|
if (this.options.verbose) {
|
|
140
69
|
console.log(this.compoundsById.size, 'compound definitions');
|
|
141
70
|
}
|
|
142
|
-
// console.log(this.descriptionTocLists)
|
|
143
71
|
}
|
|
144
|
-
/**
|
|
145
|
-
* Recursively finds and processes description identifiers within elements.
|
|
146
|
-
*
|
|
147
|
-
* @remarks
|
|
148
|
-
* Traverses the element hierarchy to locate table of contents items,
|
|
149
|
-
* document sections, and anchors, creating appropriate view model
|
|
150
|
-
* structures for navigation and cross-referencing. This recursive processing
|
|
151
|
-
* ensures comprehensive extraction of all navigational elements from
|
|
152
|
-
* complex documentation structures.
|
|
153
|
-
*
|
|
154
|
-
* @param compound - The compound containing the description elements.
|
|
155
|
-
* @param element - The data model element to process recursively.
|
|
156
|
-
*/
|
|
157
72
|
findDescriptionIdsRecursively(compound, element) {
|
|
158
|
-
// console.log(compound.id, typeof element)
|
|
159
73
|
if (element.children === undefined) {
|
|
160
74
|
return;
|
|
161
75
|
}
|
|
162
76
|
for (const childDataModel of element.children) {
|
|
163
77
|
if (childDataModel instanceof TocListDataModel) {
|
|
164
78
|
const tocList = new DescriptionTocList(compound);
|
|
165
|
-
// console.log(elementChild)
|
|
166
79
|
assert(childDataModel.tocItems !== undefined);
|
|
167
80
|
for (const tocItemDataModel of childDataModel.tocItems) {
|
|
168
81
|
if (tocItemDataModel instanceof TocItemDataModel) {
|
|
@@ -181,55 +94,31 @@ export class ViewModel {
|
|
|
181
94
|
this.findDescriptionIdsRecursively(compound, childDataModel);
|
|
182
95
|
}
|
|
183
96
|
else if (childDataModel instanceof AbstractDocAnchorType) {
|
|
184
|
-
// console.log(childDataModel)
|
|
185
97
|
if (childDataModel.id.length > 0) {
|
|
186
98
|
const section = new DescriptionAnchor(compound, childDataModel.id);
|
|
187
99
|
this.descriptionAnchorsById.set(section.id, section);
|
|
188
100
|
}
|
|
189
101
|
}
|
|
190
102
|
else if (childDataModel instanceof AbstractDataModelBase) {
|
|
191
|
-
// if (childDataModel instanceof AbstractDocEntryType) {
|
|
192
|
-
// console.log(childDataModel)
|
|
193
|
-
// }
|
|
194
103
|
this.findDescriptionIdsRecursively(compound, childDataModel);
|
|
195
104
|
}
|
|
196
105
|
}
|
|
197
106
|
}
|
|
198
|
-
// --------------------------------------------------------------------------
|
|
199
|
-
/**
|
|
200
|
-
* Establishes hierarchical relationships between compound objects.
|
|
201
|
-
*
|
|
202
|
-
* @remarks
|
|
203
|
-
* Delegates to each collection to create parent-child relationships
|
|
204
|
-
* and other hierarchical structures within the compound objects. This
|
|
205
|
-
* phase is essential for building proper navigation trees and inheritance
|
|
206
|
-
* relationships that reflect the original code structure.
|
|
207
|
-
*/
|
|
208
107
|
createCompoundsHierarchies() {
|
|
108
|
+
if (this.options.verbose) {
|
|
109
|
+
console.log();
|
|
110
|
+
}
|
|
209
111
|
console.log('Creating compounds hierarchies...');
|
|
210
|
-
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
|
211
112
|
for (const [collectionName, collection] of this.collections) {
|
|
212
|
-
// console.log('createHierarchies:', collectionName)
|
|
213
113
|
collection.createCompoundsHierarchies();
|
|
214
114
|
}
|
|
215
115
|
}
|
|
216
|
-
// --------------------------------------------------------------------------
|
|
217
|
-
/**
|
|
218
|
-
* Performs late initialisation of compound objects.
|
|
219
|
-
*
|
|
220
|
-
* @remarks
|
|
221
|
-
* Executes initialisation tasks that require all objects to be created
|
|
222
|
-
* first, allowing for proper cross-reference resolution and relationship
|
|
223
|
-
* establishment between compounds. This phase ensures that complex
|
|
224
|
-
* inter-compound dependencies are properly resolved after the initial
|
|
225
|
-
* object creation phase.
|
|
226
|
-
*/
|
|
227
|
-
// Required since references can be resolved only after all objects are in.
|
|
228
116
|
initializeCompoundsLate() {
|
|
117
|
+
if (this.options.verbose) {
|
|
118
|
+
console.log();
|
|
119
|
+
}
|
|
229
120
|
console.log('Performing compounds late initializations...');
|
|
230
|
-
// eslint-disable-next-line @typescript-eslint/no-unused-vars
|
|
231
121
|
for (const [collectionName, collection] of this.collections) {
|
|
232
|
-
// console.log('createHierarchies:', collectionName)
|
|
233
122
|
for (const [, compound] of collection.collectionCompoundsById) {
|
|
234
123
|
if (this.options.debug) {
|
|
235
124
|
console.log(compound.kind, compound.compoundName);
|
|
@@ -238,35 +127,19 @@ export class ViewModel {
|
|
|
238
127
|
}
|
|
239
128
|
}
|
|
240
129
|
}
|
|
241
|
-
// --------------------------------------------------------------------------
|
|
242
|
-
/**
|
|
243
|
-
* Creates a comprehensive map of all member definitions.
|
|
244
|
-
*
|
|
245
|
-
* @remarks
|
|
246
|
-
* Iterates through all compounds and their sections to build a complete
|
|
247
|
-
* mapping of member identifiers to their objects, enabling efficient
|
|
248
|
-
* member lookup and cross-referencing. This method handles member
|
|
249
|
-
* deduplication and ensures that members are properly associated with
|
|
250
|
-
* their containing compounds.
|
|
251
|
-
*/
|
|
252
130
|
createMembersMap() {
|
|
131
|
+
if (this.options.verbose) {
|
|
132
|
+
console.log();
|
|
133
|
+
}
|
|
253
134
|
console.log('Creating member definitions map...');
|
|
254
135
|
for (const [, compound] of this.compoundsById) {
|
|
255
|
-
// console.log(compound.kind, compound.compoundName, compound.id)
|
|
256
136
|
for (const section of compound.sections) {
|
|
257
|
-
// console.log(' ', sectionDef.kind)
|
|
258
137
|
for (const member of section.indexMembers) {
|
|
259
138
|
if (member instanceof Member) {
|
|
260
139
|
const memberCompoundId = stripPermalinkHexAnchor(member.id);
|
|
261
140
|
if (memberCompoundId !== compound.id) {
|
|
262
|
-
// Skip member definitions from different compounds.
|
|
263
|
-
// Hopefully they are defined properly there.
|
|
264
|
-
// console.log(
|
|
265
|
-
// 'member from another compound', compoundId, 'skipped'
|
|
266
|
-
// )
|
|
267
141
|
}
|
|
268
142
|
else {
|
|
269
|
-
// console.log(' ', memberDef.kind, memberDef.id)
|
|
270
143
|
if (this.membersById.has(member.id)) {
|
|
271
144
|
if (this.options.verbose) {
|
|
272
145
|
console.warn('member already in map', member.id, 'in', this.membersById.get(member.id)?.name);
|
|
@@ -284,19 +157,10 @@ export class ViewModel {
|
|
|
284
157
|
console.log(this.membersById.size, 'member definitions');
|
|
285
158
|
}
|
|
286
159
|
}
|
|
287
|
-
// --------------------------------------------------------------------------
|
|
288
|
-
/**
|
|
289
|
-
* Performs late initialisation of member objects.
|
|
290
|
-
*
|
|
291
|
-
* @remarks
|
|
292
|
-
* Executes member initialisation tasks that depend on all objects being
|
|
293
|
-
* created, ensuring proper cross-references and relationships are
|
|
294
|
-
* established between members and their containing compounds. This phase
|
|
295
|
-
* completes the member setup process after all structural relationships
|
|
296
|
-
* have been established.
|
|
297
|
-
*/
|
|
298
|
-
// Required since references can be resolved only after all objects are in.
|
|
299
160
|
initializeMemberLate() {
|
|
161
|
+
if (this.options.verbose) {
|
|
162
|
+
console.log();
|
|
163
|
+
}
|
|
300
164
|
console.log('Performing members late initializations...');
|
|
301
165
|
for (const [, compound] of this.compoundsById) {
|
|
302
166
|
if (this.options.debug) {
|
|
@@ -318,27 +182,14 @@ export class ViewModel {
|
|
|
318
182
|
}
|
|
319
183
|
}
|
|
320
184
|
}
|
|
321
|
-
// --------------------------------------------------------------------------
|
|
322
|
-
/**
|
|
323
|
-
* Validates and resolves permalink uniqueness across all compounds.
|
|
324
|
-
*
|
|
325
|
-
* @remarks
|
|
326
|
-
* Ensures that all generated permalinks are unique by detecting conflicts
|
|
327
|
-
* and automatically appending suffixes to duplicate permalinks, maintaining
|
|
328
|
-
* proper navigation and linking functionality. This validation process is
|
|
329
|
-
* crucial for preventing URL conflicts in the generated documentation site.
|
|
330
|
-
*/
|
|
331
|
-
/**
|
|
332
|
-
* @brief Validate the uniqueness of permalinks.
|
|
333
|
-
*/
|
|
334
185
|
validatePermalinks() {
|
|
186
|
+
if (this.options.verbose) {
|
|
187
|
+
console.log();
|
|
188
|
+
}
|
|
335
189
|
console.log('Validating permalinks...');
|
|
336
190
|
const pagePermalinksById = new Map();
|
|
337
191
|
const compoundsByPermalink = new Map();
|
|
338
192
|
for (const compoundDefDataModel of this.workspace.dataModel.compoundDefs) {
|
|
339
|
-
// console.log(
|
|
340
|
-
// compoundDefDataModel.kind, compoundDefDataModel.compoundName
|
|
341
|
-
// )
|
|
342
193
|
const { id } = compoundDefDataModel;
|
|
343
194
|
if (pagePermalinksById.has(id)) {
|
|
344
195
|
console.warn('Duplicate id', id);
|
|
@@ -350,7 +201,6 @@ export class ViewModel {
|
|
|
350
201
|
}
|
|
351
202
|
const permalink = compound.relativePermalink;
|
|
352
203
|
if (permalink !== undefined) {
|
|
353
|
-
// console.log('permalink:', permalink)
|
|
354
204
|
let compoundsMap = compoundsByPermalink.get(permalink);
|
|
355
205
|
if (compoundsMap === undefined) {
|
|
356
206
|
compoundsMap = new Map();
|
|
@@ -382,22 +232,10 @@ export class ViewModel {
|
|
|
382
232
|
}
|
|
383
233
|
}
|
|
384
234
|
}
|
|
385
|
-
// --------------------------------------------------------------------------
|
|
386
|
-
/**
|
|
387
|
-
* Performs cleanup operations on view model objects.
|
|
388
|
-
*
|
|
389
|
-
* @remarks
|
|
390
|
-
* Removes references to the original compound definition data models
|
|
391
|
-
* to free memory and prevent potential circular references after
|
|
392
|
-
* the view model creation is complete. This cleanup phase optimises
|
|
393
|
-
* memory usage by removing unnecessary data model references that
|
|
394
|
-
* are no longer needed for documentation generation.
|
|
395
|
-
*/
|
|
396
235
|
cleanups() {
|
|
397
236
|
for (const [, compound] of this.compoundsById) {
|
|
398
237
|
compound._private._compoundDef = undefined;
|
|
399
238
|
}
|
|
400
239
|
}
|
|
401
240
|
}
|
|
402
|
-
// ----------------------------------------------------------------------------
|
|
403
241
|
//# sourceMappingURL=view-model.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"view-model.js","sourceRoot":"","sources":["../../../src/docusaurus/view-model/view-model.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"view-model.js","sourceRoot":"","sources":["../../../src/docusaurus/view-model/view-model.ts"],"names":[],"mappings":"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"}
|
|
@@ -7,101 +7,26 @@ import { type File } from './view-model/files-and-folders-vm.js';
|
|
|
7
7
|
import { DoxygenFileOptions } from './view-model/options.js';
|
|
8
8
|
import { type Page } from './view-model/pages-vm.js';
|
|
9
9
|
import { ViewModel } from './view-model/view-model.js';
|
|
10
|
-
/**
|
|
11
|
-
* Central workspace that coordinates the conversion process.
|
|
12
|
-
*
|
|
13
|
-
* @remarks
|
|
14
|
-
* The Workspace class serves as the primary orchestrator for transforming
|
|
15
|
-
* Doxygen XML data into Docusaurus-compatible documentation. It manages
|
|
16
|
-
* the data model, view model, rendering system, and output generation whilst
|
|
17
|
-
* providing centralised configuration and URL management for consistent
|
|
18
|
-
* documentation structure across all generated content.
|
|
19
|
-
*
|
|
20
|
-
* @public
|
|
21
|
-
*/
|
|
22
10
|
export declare class Workspace extends Renderers {
|
|
23
|
-
/** Configuration options controlling the conversion process. */
|
|
24
11
|
options: CliOptions;
|
|
25
|
-
/** The parsed Doxygen data model containing all source information. */
|
|
26
12
|
dataModel: DataModel;
|
|
27
|
-
/** The view model that structures data for documentation generation. */
|
|
28
13
|
viewModel: ViewModel;
|
|
29
|
-
/** The absolute path to the doxygen2docusaurus project directory. */
|
|
30
14
|
projectPath: string;
|
|
31
|
-
/** Doxygen configuration options from the original build process. */
|
|
32
15
|
doxygenOptions: DoxygenFileOptions;
|
|
33
|
-
/** The absolute base URL for the generated documentation site. */
|
|
34
16
|
absoluteBaseUrl: string;
|
|
35
|
-
/** The page base URL for individual documentation pages. */
|
|
36
17
|
pageBaseUrl: string;
|
|
37
|
-
/** The slug base URL for Docusaurus routing. */
|
|
38
18
|
slugBaseUrl: string;
|
|
39
|
-
/** The menu base URL for navigation elements. */
|
|
40
19
|
menuBaseUrl: string;
|
|
41
|
-
/** The output folder path for generated Markdown files. */
|
|
42
20
|
outputFolderPath: string;
|
|
43
|
-
/** The sidebar base identifier for navigation structure. */
|
|
44
21
|
sidebarBaseId: string;
|
|
45
|
-
/** The main page compound, if one exists in the documentation. */
|
|
46
22
|
mainPage: Page | undefined;
|
|
47
|
-
/** Map of file paths to their corresponding File objects. */
|
|
48
23
|
filesByPath: Map<string, File>;
|
|
49
|
-
/**
|
|
50
|
-
* @brief Map to keep track of indices that have content.
|
|
51
|
-
*
|
|
52
|
-
* @details
|
|
53
|
-
* The map keys are:
|
|
54
|
-
* - classes
|
|
55
|
-
* - namespaces
|
|
56
|
-
* - files
|
|
57
|
-
*
|
|
58
|
-
* and the Set may include:
|
|
59
|
-
* - all
|
|
60
|
-
* - classes
|
|
61
|
-
* - namespaces
|
|
62
|
-
* - functions
|
|
63
|
-
* - variables
|
|
64
|
-
* - typedefs
|
|
65
|
-
* - enums
|
|
66
|
-
* - enumvalues
|
|
67
|
-
*/
|
|
68
24
|
indicesMaps: Map<string, Set<string>>;
|
|
69
|
-
/** Counter for the total number of Markdown files written. */
|
|
70
25
|
writtenMdFilesCounter: number;
|
|
71
|
-
/** Counter for the total number of HTML redirect files written. */
|
|
72
26
|
writtenHtmlFilesCounter: number;
|
|
73
|
-
/** Mapping of Doxygen compound kinds to collection names. */
|
|
74
27
|
collectionNamesByKind: Record<string, string>;
|
|
75
|
-
/** Defines the order of entries in the sidebar and top menu dropdown. */
|
|
76
28
|
sidebarCollectionNames: string[];
|
|
77
|
-
/**
|
|
78
|
-
* Constructs a new Workspace instance.
|
|
79
|
-
*
|
|
80
|
-
* @remarks
|
|
81
|
-
* Initialises the workspace with the provided data model and sets up
|
|
82
|
-
* the necessary paths, URLs, and configuration for documentation generation.
|
|
83
|
-
* This includes configuring base URLs, output paths, sidebar identifiers,
|
|
84
|
-
* and establishing the view model for structured documentation creation.
|
|
85
|
-
*
|
|
86
|
-
* @param dataModel - The parsed Doxygen data model.
|
|
87
|
-
*/
|
|
88
29
|
constructor(dataModel: DataModel);
|
|
89
|
-
/**
|
|
90
|
-
* Writes a Markdown output file with proper front matter and formatting.
|
|
91
|
-
*
|
|
92
|
-
* @remarks
|
|
93
|
-
* Creates a complete Docusaurus-compatible Markdown file including YAML
|
|
94
|
-
* front matter, content body, and generated footer information. The method
|
|
95
|
-
* handles permalink processing, emoji prevention, and proper file structure
|
|
96
|
-
* to ensure optimal integration with Docusaurus documentation sites.
|
|
97
|
-
*
|
|
98
|
-
* @param filePath - The output file path for the Markdown file.
|
|
99
|
-
* @param bodyLines - Array of content lines for the file body.
|
|
100
|
-
* @param frontMatter - YAML front matter configuration object.
|
|
101
|
-
* @param frontMatterCodeLines - Optional additional front matter code.
|
|
102
|
-
* @param title - Optional page title if not specified in front matter.
|
|
103
|
-
* @param pagePermalink - Optional page permalink for anchor processing.
|
|
104
|
-
*/
|
|
105
30
|
writeOutputMdFile({ filePath, bodyLines, frontMatter, frontMatterCodeLines, title, pagePermalink, }: {
|
|
106
31
|
filePath: string;
|
|
107
32
|
bodyLines: string[];
|
|
@@ -110,62 +35,12 @@ export declare class Workspace extends Renderers {
|
|
|
110
35
|
title?: string;
|
|
111
36
|
pagePermalink?: string;
|
|
112
37
|
}): Promise<void>;
|
|
113
|
-
/**
|
|
114
|
-
* Marks paragraph elements to be skipped during rendering.
|
|
115
|
-
*
|
|
116
|
-
* @remarks
|
|
117
|
-
* Processes an array of elements and sets the skipPara flag on any
|
|
118
|
-
* ParaDataModel instances to prevent them from being rendered. This
|
|
119
|
-
* functionality is essential for controlling paragraph output in contexts
|
|
120
|
-
* where specific formatting requirements must be maintained.
|
|
121
|
-
*
|
|
122
|
-
* @param elements - Array of elements to process for paragraph skipping.
|
|
123
|
-
*/
|
|
124
38
|
skipElementsPara(elements: (AbstractDataModelBase | string)[] | undefined): void;
|
|
125
|
-
/**
|
|
126
|
-
* Resolves a reference identifier to its corresponding permalink URL.
|
|
127
|
-
*
|
|
128
|
-
* @remarks
|
|
129
|
-
* Determines the appropriate permalink for a given reference based on
|
|
130
|
-
* the reference type (compound, member, or xrefsect) and constructs
|
|
131
|
-
* the full URL including anchors where applicable. This method handles
|
|
132
|
-
* complex reference resolution including table of contents items and
|
|
133
|
-
* description sections for comprehensive cross-referencing capabilities.
|
|
134
|
-
*
|
|
135
|
-
* @param refid - The reference identifier to resolve.
|
|
136
|
-
* @param kindref - The kind of reference ('compound', 'member', 'xrefsect').
|
|
137
|
-
* @returns The resolved permalink URL, or undefined if not found.
|
|
138
|
-
*/
|
|
139
39
|
getPermalink({ refid, kindref, }: {
|
|
140
|
-
refid: string;
|
|
40
|
+
refid: string | undefined;
|
|
141
41
|
kindref: string;
|
|
142
42
|
}): string | undefined;
|
|
143
|
-
/**
|
|
144
|
-
* Retrieves the permalink URL for a specific page by reference identifier.
|
|
145
|
-
*
|
|
146
|
-
* @remarks
|
|
147
|
-
* Looks up a compound by its reference identifier and constructs the
|
|
148
|
-
* complete page permalink URL for linking purposes. The method includes
|
|
149
|
-
* comprehensive error handling and optional warning suppression for
|
|
150
|
-
* cases where references may not be resolvable during processing.
|
|
151
|
-
*
|
|
152
|
-
* @param refid - The reference identifier of the compound.
|
|
153
|
-
* @param noWarn - Whether to suppress warning messages for missing compounds.
|
|
154
|
-
* @returns The complete page permalink URL, or undefined if not found.
|
|
155
|
-
*/
|
|
156
43
|
getPagePermalink(refid: string, noWarn?: boolean): string | undefined;
|
|
157
|
-
/**
|
|
158
|
-
* Constructs a cross-reference permalink for documentation pages.
|
|
159
|
-
*
|
|
160
|
-
* @remarks
|
|
161
|
-
* Generates a permalink URL for cross-references by extracting the page
|
|
162
|
-
* and anchor components from the identifier and constructing the
|
|
163
|
-
* appropriate URL structure. This method specifically handles the pages
|
|
164
|
-
* collection format for cross-reference navigation within the documentation.
|
|
165
|
-
*
|
|
166
|
-
* @param id - The cross-reference identifier to process.
|
|
167
|
-
* @returns The constructed cross-reference permalink URL.
|
|
168
|
-
*/
|
|
169
44
|
getXrefPermalink(id: string): string;
|
|
170
45
|
}
|
|
171
46
|
//# sourceMappingURL=workspace.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/docusaurus/workspace.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,sCAAsC,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAMpD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;
|
|
1
|
+
{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/docusaurus/workspace.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qCAAqC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,sCAAsC,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAMpD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAuCtD,qBAAa,SAAU,SAAQ,SAAS;IAGtC,OAAO,EAAE,UAAU,CAAA;IAInB,SAAS,EAAE,SAAS,CAAA;IAGpB,SAAS,EAAE,SAAS,CAAA;IAIpB,WAAW,EAAE,MAAM,CAAA;IAInB,cAAc,EAAE,kBAAkB,CAAA;IAIlC,eAAe,EAAE,MAAM,CAAA;IAIvB,WAAW,EAAE,MAAM,CAAA;IAInB,WAAW,EAAE,MAAM,CAAA;IAInB,WAAW,EAAE,MAAM,CAAA;IAInB,gBAAgB,EAAE,MAAM,CAAA;IAIxB,aAAa,EAAE,MAAM,CAAA;IAGrB,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAA;IAG1B,WAAW,oBAA0B;IAqBrC,WAAW,2BAAiC;IAG5C,qBAAqB,SAAI;IAGzB,uBAAuB,SAAI;IAG3B,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB5C;IAID,sBAAsB,EAAE,MAAM,EAAE,CAO/B;gBAeW,SAAS,EAAE,SAAS;IAqE1B,iBAAiB,CAAC,EACtB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,KAAK,EACL,aAAa,GACd,EAAE;QACD,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,WAAW,EAAE,WAAW,CAAA;QACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2GjB,gBAAgB,CACd,QAAQ,EAAE,CAAC,qBAAqB,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,GACvD,IAAI;IA4BP,YAAY,CAAC,EACX,KAAK,EACL,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,OAAO,EAAE,MAAM,CAAA;KAChB,GAAG,MAAM,GAAG,SAAS;IAoHtB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,GAAG,SAAS;IAiCnE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;CAcrC"}
|