@minecraft/api-docs-generator 1.0.0

package/lib/changelog.js

@@ -0,0 +1,459 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangelogGenerator = void 0;
+const deep_equal_1 = __importDefault(require("deep-equal"));
+const utils = __importStar(require("./utilities"));
+const TypeDataLayout = {
+    type: 'value',
+    ignoredSubmembers: ['from_module'],
+};
+const VersionDataLayout = {
+    type: 'array',
+    key: 'version',
+};
+const ModuleDependenciesDataLayout = {
+    type: 'array',
+    key: 'name',
+    submembers: {
+        versions: VersionDataLayout,
+        types_only: { type: 'value' },
+    },
+};
+const scriptingDataLayout = {
+    type: 'object',
+    key: 'name',
+    submembers: {
+        dependencies: ModuleDependenciesDataLayout,
+        peer_dependencies: ModuleDependenciesDataLayout,
+        classes: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                properties: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: {
+                        is_read_only: { type: 'value' },
+                        get_privilege: { type: 'array', key: 'name' },
+                        set_privilege: { type: 'array', key: 'name' },
+                        type: TypeDataLayout,
+                    },
+                },
+                functions: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: {
+                        arguments: {
+                            type: 'array',
+                            key: 'name',
+                            submembers: {
+                                type: TypeDataLayout,
+                            },
+                        },
+                        call_privilege: { type: 'array', key: 'name' },
+                        return_type: TypeDataLayout,
+                    },
+                },
+                constants: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: { value: { type: 'value' } },
+                },
+                base_types: { type: 'array', key: 'name' },
+            },
+        },
+        interfaces: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                properties: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: { is_read_only: { type: 'value' }, type: TypeDataLayout },
+                },
+            },
+        },
+        errors: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                properties: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: {
+                        is_read_only: { type: 'value' },
+                        type: TypeDataLayout,
+                        get_privilege: { type: 'array', key: 'name' },
+                        set_privilege: { type: 'array', key: 'name' },
+                    },
+                },
+            },
+        },
+        objects: {
+            type: 'array',
+            key: 'name',
+            submembers: { is_read_only: { type: 'value' }, type: TypeDataLayout },
+        },
+        functions: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                arguments: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: {
+                        type: TypeDataLayout,
+                    },
+                },
+                return_type: TypeDataLayout,
+                call_privilege: { type: 'array', key: 'name' },
+            },
+        },
+        constants: {
+            type: 'array',
+            key: 'name',
+            submembers: { value: { type: 'value' } },
+        },
+        enums: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                constants: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: { value: { type: 'value' } },
+                },
+            },
+        },
+        type_aliases: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                type: TypeDataLayout,
+                mappings: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: { value: { type: 'value' } },
+                },
+            },
+        },
+    },
+};
+const commandsDataLayout = {
+    type: 'object',
+    key: 'name',
+    submembers: {
+        commands: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                aliases: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: { name: { type: 'value' } },
+                },
+                permission_level: { type: 'value' },
+                requires_cheats: { type: 'value' },
+                overloads: {
+                    type: 'array',
+                    key: 'name',
+                    submembers: {
+                        params: {
+                            type: 'array_deep_copy',
+                            key: 'name',
+                            submembers: {
+                                type: { type: 'value' },
+                                is_optional: { type: 'value' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+const afterEventsOrderingDataLayout = {
+    type: 'object',
+    key: 'name',
+    submembers: {
+        name: { type: 'value' },
+        after_events_order_by_version: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                version: { type: 'value' },
+                version_is_prerelease: { type: 'value' },
+                event_order: {
+                    type: 'simple_ordered_array',
+                    key: 'name',
+                },
+            },
+        },
+    },
+};
+const vanillaDataDataLayout = {
+    type: 'object',
+    key: 'name',
+    submembers: {
+        data_items: {
+            type: 'array',
+            key: 'name',
+        },
+    },
+};
+const blockVanillaDataDataLayout = {
+    type: 'object',
+    key: 'name',
+    submembers: {
+        block_properties: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                type: { type: 'value' },
+                values: {
+                    type: 'array_deep_copy',
+                    key: 'name',
+                },
+            },
+        },
+        data_items: {
+            type: 'array',
+            key: 'name',
+            submembers: {
+                properties: {
+                    type: 'array_deep_copy',
+                    key: 'name',
+                },
+            },
+        },
+    },
+};
+const modulesHaveVersionKey = (moduleList, key) => {
+    return moduleList.length !== 0 && key in moduleList[0];
+};
+class ChangelogGenerator {
+    constructor(_config) {
+        this.config = _config;
+    }
+    config;
+    getChangelogForVersion(changelog, version) {
+        const versionKey = this.config.getVersionKey();
+        let changelogVersionIndex = changelog.map(objectData => objectData[versionKey]).indexOf(version);
+        if (changelogVersionIndex === -1) {
+            changelogVersionIndex =
+                changelog.push({
+                    [versionKey]: version,
+                }) - 1;
+        }
+        return changelog[changelogVersionIndex];
+    }
+    compareArray(arrayChangelog, changeLogList, dataLayout, subObjectKey, currentSubobjects, nextSubobjects) {
+        currentSubobjects.forEach(currentSubObjectPropertyData => {
+            const subObjectDataLayout = dataLayout.submembers[subObjectKey];
+            const subObjectDataLayoutAsArray = dataLayout.submembers[subObjectKey];
+            const nextObjectPropertyIndex = nextSubobjects
+                .map(objectData => objectData[subObjectDataLayoutAsArray.key])
+                .indexOf(currentSubObjectPropertyData[subObjectDataLayoutAsArray.key]);
+            if (nextObjectPropertyIndex === -1) {
+                const objectChange = {
+                    [subObjectDataLayoutAsArray.key]: utils.deepCopyJson(currentSubObjectPropertyData[subObjectDataLayoutAsArray.key]),
+                    [changeLogList]: true,
+                    ...currentSubObjectPropertyData,
+                };
+                arrayChangelog.push(objectChange);
+            }
+            else {
+                const nextObjectData = nextSubobjects[nextObjectPropertyIndex];
+                switch (subObjectDataLayout.type) {
+                    case 'array':
+                    case 'array_deep_copy':
+                    case 'simple_ordered_array':
+                    case 'object': {
+                        let changelogIndex = arrayChangelog
+                            .map(objectData => objectData[subObjectDataLayout.key])
+                            .indexOf(currentSubObjectPropertyData[subObjectDataLayout.key]);
+                        if (changelogIndex === -1) {
+                            const currentObjPropData = {
+                                [subObjectDataLayout.key]: currentSubObjectPropertyData[subObjectDataLayout.key],
+                            };
+                            changelogIndex = arrayChangelog.push(currentObjPropData) - 1;
+                        }
+                        const subChangelog = arrayChangelog[changelogIndex];
+                        this.generate(subChangelog, changeLogList, subObjectDataLayout, currentSubObjectPropertyData, nextObjectData);
+                        const propertyNames = Object.getOwnPropertyNames(subChangelog);
+                        if (propertyNames.length === 1 && propertyNames[0] === subObjectDataLayout.key) {
+                            arrayChangelog.splice(changelogIndex, 1);
+                        }
+                        else {
+                            arrayChangelog[changelogIndex] = {
+                                ...currentSubObjectPropertyData,
+                                ...arrayChangelog[changelogIndex],
+                            };
+                        }
+                        break;
+                    }
+                    default:
+                        break;
+                }
+            }
+        });
+    }
+    generate(parentObjectChangelog, changeLogList, dataLayout, currentObjectData, nextObjectData) {
+        for (const subObjectKey in dataLayout.submembers) {
+            const subObjectDataLayout = dataLayout.submembers[subObjectKey];
+            switch (subObjectDataLayout.type) {
+                case 'value': {
+                    const currentObjectValue = currentObjectData[subObjectKey];
+                    const nextObjectValue = nextObjectData[subObjectKey];
+                    const currentObjectValueCopy = utils.deepCopyJson(currentObjectValue);
+                    const nextObjectValueCopy = utils.deepCopyJson(nextObjectValue);
+                    subObjectDataLayout.ignoredSubmembers?.forEach(ignoredSubmember => {
+                        utils.removePropertyRecursive(currentObjectValueCopy, ignoredSubmember);
+                        utils.removePropertyRecursive(nextObjectValueCopy, ignoredSubmember);
+                    });
+                    if (!(0, deep_equal_1.default)(currentObjectValueCopy, nextObjectValueCopy)) {
+                        parentObjectChangelog[subObjectKey] = {
+                            $old: utils.deepCopyJson(currentObjectValue),
+                            $new: utils.deepCopyJson(nextObjectValue),
+                            $changed: true,
+                        };
+                    }
+                    break;
+                }
+                case 'object':
+                case 'array': {
+                    if (parentObjectChangelog[subObjectKey] === undefined) {
+                        parentObjectChangelog[subObjectKey] = [];
+                    }
+                    const currentSubobjects = currentObjectData[subObjectKey] ?? [];
+                    const nextSubobjects = nextObjectData[subObjectKey] ?? [];
+                    this.compareArray(parentObjectChangelog[subObjectKey], changeLogList, dataLayout, subObjectKey, currentSubobjects, nextSubobjects);
+                    break;
+                }
+                case 'array_deep_copy': {
+                    if (parentObjectChangelog[subObjectKey] === undefined) {
+                        parentObjectChangelog[subObjectKey] = [];
+                    }
+                    const currentSubobjects = currentObjectData[subObjectKey] ?? [];
+                    const nextSubobjects = nextObjectData[subObjectKey] ?? [];
+                    if (!(0, deep_equal_1.default)(currentSubobjects, nextSubobjects)) {
+                        const objectCopyKey = `$${subObjectKey}_copy`;
+                        parentObjectChangelog[objectCopyKey] = {
+                            $old: utils.deepCopyJson(currentSubobjects),
+                            $new: utils.deepCopyJson(nextSubobjects),
+                            $changed: true,
+                        };
+                        this.compareArray(parentObjectChangelog[subObjectKey], changeLogList, dataLayout, subObjectKey, currentSubobjects, nextSubobjects);
+                    }
+                    break;
+                }
+                case 'simple_ordered_array': {
+                    if (parentObjectChangelog[subObjectKey] === undefined) {
+                        parentObjectChangelog[subObjectKey] = [];
+                    }
+                    const currentSubobjects = currentObjectData[subObjectKey] ?? [];
+                    const nextSubobjects = nextObjectData[subObjectKey] ?? [];
+                    if (!(0, deep_equal_1.default)(currentSubobjects, nextSubobjects)) {
+                        parentObjectChangelog[subObjectKey] = {
+                            $old: utils.deepCopyJson(currentSubobjects),
+                            $new: utils.deepCopyJson(nextSubobjects),
+                            $changed: true,
+                            $key: subObjectDataLayout.key,
+                        };
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    generateModuleChangeLog(changelog, modulesJson, dataLayout, changeLogList, versionKey, sortComparer, applyToCurrentModule) {
+        const modulesJsonSorted = modulesJson.sort(sortComparer(versionKey));
+        for (let currentModuleIndex = modulesJsonSorted.length - 1; currentModuleIndex > 0; currentModuleIndex--) {
+            const nextModuleIndex = currentModuleIndex - 1;
+            const currentModule = modulesJsonSorted[currentModuleIndex];
+            const nextModule = modulesJsonSorted[nextModuleIndex];
+            const dataChangedVersion = applyToCurrentModule ? currentModule[versionKey] : nextModule[versionKey];
+            const versionChangelog = this.getChangelogForVersion(changelog, dataChangedVersion);
+            this.generate(versionChangelog, changeLogList, dataLayout, currentModule, nextModule);
+        }
+        return changelog;
+    }
+    generateChangelogs(releases) {
+        const moduleGroups = this.config.generateModuleGroups(releases);
+        for (const currentModuleList of moduleGroups) {
+            if (modulesHaveVersionKey(currentModuleList, this.config.getVersionKey())) {
+                const moduleType = currentModuleList[0].module_type;
+                let correctDataLayout;
+                switch (moduleType) {
+                    case 'script': {
+                        correctDataLayout = scriptingDataLayout;
+                        break;
+                    }
+                    case 'commands': {
+                        correctDataLayout = commandsDataLayout;
+                        break;
+                    }
+                    case 'after_events_ordering': {
+                        correctDataLayout = afterEventsOrderingDataLayout;
+                        break;
+                    }
+                    case 'vanilla_data': {
+                        correctDataLayout =
+                            currentModuleList[0].name === 'mojang-block'
+                                ? blockVanillaDataDataLayout
+                                : vanillaDataDataLayout;
+                        break;
+                    }
+                    default: {
+                        continue;
+                    }
+                }
+                const modulesJsonSorted = currentModuleList.sort(utils.semVerSortComparer(this.config.getVersionKey()));
+                const changelogs = [
+                    {
+                        [this.config.getVersionKey()]: modulesJsonSorted[0][this.config.getVersionKey()],
+                        $added: true,
+                        ...utils.deepCopyJson(modulesJsonSorted[0]), // Hacky deep copy
+                    },
+                ];
+                this.generateModuleChangeLog(changelogs, currentModuleList, correctDataLayout, '$added', this.config.getVersionKey(), utils.semVerSortComparer, true);
+                this.generateModuleChangeLog(changelogs, currentModuleList, correctDataLayout, '$removed', this.config.getVersionKey(), utils.reverseSemVerSortComparer, false);
+                const sortedChangelogs = changelogs.sort(utils.reverseSemVerSortComparer(this.config.getVersionKey()));
+                for (const moduleJson of currentModuleList) {
+                    const moduleWithChangelog = moduleJson;
+                    moduleWithChangelog.changelog = utils.deepCopyJson(sortedChangelogs);
+                }
+            }
+        }
+    }
+}
+exports.ChangelogGenerator = ChangelogGenerator;
+//# sourceMappingURL=changelog.js.map

package/lib/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"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"}

package/lib/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/cli.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const semver_1 = __importDefault(require("semver"));
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const Config_1 = require("./Config");
+const Logger_1 = require("./Logger");
+const generator_1 = require("./generator");
+const argv = (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+    .parserConfiguration({
+    'boolean-negation': false,
+})
+    .usage('Usage: minecraft-api-docs-generator [options]')
+    .option('input-directory', {
+    alias: 'i',
+    type: 'string',
+    nargs: 1,
+    desc: 'Directory of the API metadata JSON input files.',
+})
+    .option('output-directory', {
+    alias: 'o',
+    type: 'string',
+    nargs: 1,
+    desc: 'Directory to output generated types and documentation to.',
+})
+    .option('docs-directory', {
+    alias: 'd',
+    type: 'string',
+    nargs: 1,
+    desc: 'Directory of the documentation info.JSON files that provide description strings for API modules.',
+})
+    .option('run-generators', {
+    alias: 'g',
+    type: 'array',
+    string: true,
+    desc: `IDs of markup generators to render output files with. Supports multiple arguments. Examples: '-g ts' or '-g msdocs typedoc'`,
+})
+    .option('changelog-strategy', {
+    type: 'string',
+    nargs: 1,
+    desc: `String ID of the changelog strategy to use when comparing modules. Default: 'module_version'`,
+})
+    .option('minecraft-version', {
+    alias: 'mcv',
+    type: 'string',
+    nargs: 1,
+    desc: `Semantic version string for which version of Minecraft to use for versioning. Examples: '--mcv 1.2.3' or '--mcv 1.2.3-beta.5'`,
+    coerce: (version) => {
+        if (semver_1.default.valid(version)) {
+            return version;
+        }
+        else {
+            throw new Error(`Provided Minecraft release version '${version}' is not a valid semver string.`);
+        }
+    },
+})
+    .option('preexisting-release-versions', {
+    alias: 'prv',
+    type: 'string',
+    nargs: 1,
+    desc: `Path to a JSON file that is a map of module names to arrays of semantic version strings which have been released on NPM. Example JSON: '{"@minecraft/server": ["1.2.3"], "@minecraft/common": ["1.2.3-beta.5"]}'`,
+    coerce: (filePath) => {
+        const preexistingReleasesPath = path_1.default.resolve(filePath);
+        if (fs_1.default.existsSync(preexistingReleasesPath)) {
+            const fileContent = fs_1.default.readFileSync(preexistingReleasesPath);
+            return Config_1.PreexistingModuleReleasesRecord.check(JSON.parse(fileContent.toString()));
+        }
+        else {
+            throw new Error(`No preexisting releases file found at '${preexistingReleasesPath}'.`);
+        }
+    },
+})
+    .option('include-modules', {
+    alias: 'm',
+    type: 'string',
+    nargs: 1,
+    desc: `Mode which determines which input modules should be included in generation. Options: ${Config_1.IncludeModulesModeUnion.alternatives.map(m => m.value).join(',')}. Example: '--include-modules latest'. Default: 'all'`,
+    coerce: (mode) => {
+        return Config_1.IncludeModulesModeUnion.check(mode);
+    },
+})
+    .option('include-base', {
+    alias: 'b',
+    type: 'boolean',
+    desc: 'If set, will include base modules in generation for metadata that would be merged to a parent module. By default, only the merged module will generate output.',
+})
+    .option('skip-merging', {
+    type: 'boolean',
+    desc: 'If set to true, skip module merging so parented modules are not merged with their child modules.',
+    conflicts: ['include-base'],
+})
+    .option('plugin', {
+    alias: 'p',
+    type: 'array',
+    string: true,
+    desc: `Plugin packages to import generators and templates from. Supports multiple arguments. Example: '--plugin @minecraft/markup-generators-plugin'`,
+})
+    .option('config', {
+    alias: 'c',
+    type: 'string',
+    nargs: 1,
+    desc: 'Path to a config file with options.',
+    conflicts: 'no-config',
+    coerce: (filePath) => {
+        const resolvedConfigPath = path_1.default.resolve(filePath);
+        if (fs_1.default.existsSync(resolvedConfigPath)) {
+            return resolvedConfigPath;
+        }
+        else {
+            throw new Error(`No config file found at ${resolvedConfigPath}`);
+        }
+    },
+})
+    .option('no-config', {
+    type: 'boolean',
+    desc: 'If set, will not look for any config files.',
+    conflicts: 'config',
+})
+    .option('log', {
+    alias: 'l',
+    desc: `Logging options. Options: ${Object.keys(Logger_1.LogOptionsRecord.fields).join(', ')}. Usage: '--log.<option> <value>'. Example: '--log.level debug'`,
+    conflicts: 'suppress',
+    coerce: (opts) => {
+        if (!opts || typeof opts !== 'object') {
+            throw new Error(`Expected to receive options for --log. Usage: '--log.<option> <value>'`);
+        }
+        for (const key in opts) {
+            opts[key] = opts[key] === 'true' ? true : opts[key] === 'false' ? false : opts[key];
+        }
+        return Logger_1.LogOptionsRecord.check(opts);
+    },
+})
+    .option('suppress', {
+    alias: 's',
+    type: 'boolean',
+    desc: `If set, will suppress verbose logging and only output errors. Default: false`,
+    conflicts: 'log',
+})
+    .help('help')
+    .alias('help', 'h')
+    .parseSync();
+module.exports = (async () => {
+    if ((!argv.inputDirectory || !argv.outputDirectory) && (!argv.config || argv.noConfig)) {
+        throw new Error(`Must specify both '--input-directory' and '--output-directory' or a config file path with '--config'`);
+    }
+    const logOptions = argv.log ? argv.log : argv.suppress ? { level: 'error' } : undefined;
+    await (0, generator_1.generate)({
+        inputDirectory: argv.inputDirectory,
+        outputDirectory: argv.outputDirectory,
+        documentationDirectory: argv.docsDirectory,
+        generatorsToRun: argv.runGenerators,
+        changelogStrategy: argv.changelogStrategy,
+        minecraftReleaseVersion: argv.minecraftVersion,
+        preexistingModuleReleases: argv.preexistingReleaseVersions,
+        includeModulesMode: argv.includeModules,
+        includeBaseModules: argv.includeBase,
+        plugins: argv.plugin,
+        configPath: argv.config,
+        ignoreConfig: argv.noConfig,
+        log: logOptions,
+        skipMerging: argv.skipMerging,
+    });
+})();
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/lib/filters/CommandFilters.d.ts

@@ -0,0 +1,2 @@
+import { Filter } from './Filters';
+export declare const CommandMarkupFilter: Filter;