Versioning fixes and prebuilding APIs, temporary disabled minify

Author: rislaed

.gitignore

@@ -5,6 +5,7 @@ node_modules/
 /build
 /innercore*-docs.pdf
 /static/declarations
+/api_versioned_docs/version-latest
 
 # Generated files
 .docusaurus

api/docusaurus-plugin/src/index.ts

@@ -164,17 +164,25 @@ export default function typedocApiPlugin(
 
 					// Load info from `package.json`s
 					packageConfigs.forEach((cfg) => {
-						const { packageJson } = loadPackageJsonAndDocs(
+						const packageData = loadPackageJsonAndDocs(
 							path.join(options.projectRoot, cfg.packagePath),
 							options.packageJsonName,
 							options.readmeName,
 							options.changelogName,
 						);
 
-						// eslint-disable-next-line no-param-reassign
-						cfg.packageName = packageJson.name;
-						// eslint-disable-next-line no-param-reassign
-						cfg.packageVersion = packageJson.version;
+						if (packageData) {
+							// eslint-disable-next-line no-param-reassign
+							cfg.packageName = packageData.packageJson.name;
+							// eslint-disable-next-line no-param-reassign
+							cfg.packageVersion = packageData.packageJson.version;
+						} else {
+							const packageName = cfg.packageSlug ?? path.basename(cfg.packagePath);
+							// eslint-disable-next-line no-param-reassign
+							cfg.packageName = packageName.substring(packageName.lastIndexOf('/') + 1);
+							// eslint-disable-next-line no-param-reassign
+							cfg.packageVersion = 'latest';
+						}
 					});
 
 					await fs.promises.writeFile(

api/docusaurus-plugin/src/plugin/data.ts

@@ -438,7 +438,7 @@ export function flattenAndGroupPackages(
 					) ?? {
 						packageJson: {
 							name: mod.name.substring(mod.name.lastIndexOf('/') + 1),
-							version: '1'
+							version: 'latest'
 						},
 						readmePath: '',
 						changelogPath: ''

api/docusaurus-plugin/src/plugin/version.ts

@@ -94,6 +94,7 @@ export async function readVersionsMetadata(
 		disableVersioning: options.disableVersioning ?? false,
 		id: options.id ?? 'default',
 		includeCurrentVersion: options.includeCurrentVersion ?? true,
+		path: (options as any).path ?? options.projectRoot ?? 'api',
 	});
 	const versionNames = filterVersions(versionNamesUnfiltered, {
 		...specialOptions,

api_versions.json

@@ -0,0 +1 @@
+["latest"]

docusaurus.config.ts

@@ -114,6 +114,7 @@ export default {
 		[
 			'@nernar/docusaurus-plugin-typedoc',
 			{
+				id: 'api',
 				projectRoot: 'api',
 				packageJsonName: 'typedoc.json',
 				sortPackages: (left, right) =>
@@ -158,7 +159,14 @@ export default {
 						// TODO: Page groups like in typedoc-github-theme.
 					// ]
 				},
-				remarkPlugins: [remarkAuthors]
+				remarkPlugins: [remarkAuthors],
+				includeCurrentVersion: false,
+				lastVersion: 'latest',
+				versions: {
+					latest: {
+						path: ''
+					}
+				}
 			} satisfies Typedoc.Options
 		]
 	],

package.json

@@ -24,10 +24,10 @@
   "scripts": {
     "start": "docusaurus start --no-open --no-minify",
     "start-ru": "docusaurus start --locale ru --no-open --no-minify",
-    "build-docs": "docusaurus build",
-    "build-docs-ci": "node --max-old-space-size=6144 ./node_modules/.bin/docusaurus build",
-    "build": "npm run prebuild-plugin && npm run prebuild-declarations && npm run build-docs",
-    "build-ci": "npm run prebuild-plugin && npm run prebuild-declarations && npm run build-docs-ci",
+    "build-docs": "docusaurus build --no-minify",
+    "build-docs-ci": "node --max-old-space-size=6144 ./node_modules/.bin/docusaurus build --no-minify",
+    "build": "npm run prebuild-plugin && npm run prebuild-declarations && npm run prebuild-api && npm run build-docs",
+    "build-ci": "npm run prebuild-plugin && npm run prebuild-declarations && npm run prebuild-api && npm run build-docs-ci",
     "serve": "docusaurus serve --no-open",
     "build-serve": "npm run build && npm run serve",
     "write-translations": "docusaurus write-translations --locale ru",
@@ -36,6 +36,7 @@
     "clear": "docusaurus clear",
     "prebuild-declarations": "npx dts-generator --project api/core-engine --out static/declarations/core-engine.d.ts --extern ./android.d.ts --exclude **/node_modules/**/*.d.ts --exclude **/declarations/android.d.ts",
     "prebuild-plugin": "npm run --prefix api/docusaurus-plugin build",
+    "prebuild-api": "docusaurus api:version:api latest",
     "deploy-pdf": "tsx tools/generate-pdf.ts --initialDocURLs=https://nernar.github.io/docs/intro --outputPDFFilename=innercore-docs.pdf --excludeSelectors=\".margin-vert--xl a\"",
     "deploy-pdf-ru": "tsx tools/generate-pdf.ts --initialDocURLs=https://nernar.github.io/ru/docs/intro --outputPDFFilename=innercore-russian-docs.pdf --excludeSelectors=\".margin-vert--xl a\"",
     "deploy-libraries-pdf": "tsx tools/generate-pdf.ts --initialDocURLs=https://nernar.github.io/libraries/BackpackAPI --outputPDFFilename=innercore-libraries-docs.pdf --excludeSelectors=\".margin-vert--xl a\"",