@minecraft/markup-generators-plugin 1.0.0

package/lib/generators/index.js

@@ -0,0 +1,26 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ChangelogJSONGenerator"), exports);
+__exportStar(require("./ChangelogMDGenerator"), exports);
+__exportStar(require("./MSDocsMarkdownGenerator"), exports);
+__exportStar(require("./NPMModuleGenerator"), exports);
+__exportStar(require("./TypeDocGenerator"), exports);
+__exportStar(require("./TypeScriptDefinitionGenerator"), exports);
+__exportStar(require("./TypeScriptGenerator"), exports);
+//# sourceMappingURL=index.js.map

package/lib/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;;;;;;;;;;;;;;AAElC,2DAAyC;AACzC,yDAAuC;AACvC,4DAA0C;AAC1C,uDAAqC;AACrC,qDAAmC;AACnC,kEAAgD;AAChD,wDAAsC"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from '@minecraft/api-docs-generator';
+declare const MarkupGeneratorsPlugin: Plugin;
+export default MarkupGeneratorsPlugin;

package/lib/index.js

@@ -0,0 +1,30 @@
+"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 path_1 = __importDefault(require("path"));
+const generators_1 = require("./generators");
+const templatesRoot = path_1.default.resolve(__dirname, '..', 'templates');
+const MarkupGeneratorsPlugin = {
+    generators: [
+        new generators_1.ChangelogJSONGenerator(),
+        new generators_1.ChangelogMDGenerator(),
+        new generators_1.MSDocsMarkdownGenerator(),
+        new generators_1.NPMModuleGenerator(),
+        new generators_1.TypeDocGenerator(),
+        new generators_1.TypeScriptDefinitionGenerator(),
+        new generators_1.TypeScriptGenerator(),
+    ],
+    templates: {
+        msdocs: path_1.default.join(templatesRoot, 'msdocs'),
+        npm: path_1.default.join(templatesRoot, 'npm'),
+        ts: path_1.default.join(templatesRoot, 'ts'),
+        tsdef: path_1.default.join(templatesRoot, 'tsdef'),
+        txt: path_1.default.join(templatesRoot, 'txt'),
+    },
+};
+exports.default = MarkupGeneratorsPlugin;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;;;AAElC,gDAAwB;AAIxB,6CAQsB;AAEtB,MAAM,aAAa,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAEjE,MAAM,sBAAsB,GAAW;IACnC,UAAU,EAAE;QACR,IAAI,mCAAsB,EAAE;QAC5B,IAAI,iCAAoB,EAAE;QAC1B,IAAI,oCAAuB,EAAE;QAC7B,IAAI,+BAAkB,EAAE;QACxB,IAAI,6BAAgB,EAAE;QACtB,IAAI,0CAA6B,EAAE;QACnC,IAAI,gCAAmB,EAAE;KAC5B;IACD,SAAS,EAAE;QACP,MAAM,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC;QAC1C,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;QACpC,EAAE,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;QAClC,KAAK,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC;QACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;KACvC;CACJ,CAAC;AAEF,kBAAe,sBAAsB,CAAC"}

package/lib/msdocsGeneratorUnitTests.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/msdocsGeneratorUnitTests.spec.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const api_docs_generator_1 = require("@minecraft/api-docs-generator");
+const generators_1 = require("./generators");
+(0, vitest_1.describe)('MSDocsMarkdownGenerator Unit Tests', () => {
+    (0, vitest_1.it)('Returns correctly sorted modules', () => {
+        const gen = new generators_1.MSDocsMarkdownGenerator();
+        const release = new api_docs_generator_1.MinecraftRelease('0.1.0');
+        const makeServerType = (version) => {
+            const module_type = 'script';
+            return {
+                name: '@minecraft/server',
+                uuid: '1234',
+                version: version,
+                minecraft_version: '0.1.0',
+                module_type: module_type,
+            };
+        };
+        const makeServerUIType = (version) => {
+            const module_type = 'script';
+            return {
+                name: '@minecraft/server-ui',
+                uuid: '12345',
+                version: version,
+                minecraft_version: '0.1.0',
+                module_type: module_type,
+            };
+        };
+        release.script_modules = [
+            makeServerType('1.0.0'),
+            makeServerType('1.3.0'),
+            makeServerType('1.4.0'),
+            makeServerUIType('2.0.0'),
+            makeServerUIType('2.1.0'),
+            makeServerUIType('2.2.0'),
+            makeServerUIType('3.0.0'),
+            makeServerUIType('3.1.0-beta'),
+            makeServerType('1.1.0'),
+            makeServerType('2.0.0'),
+            makeServerType('2.1.0'),
+            makeServerType('3.0.0'),
+            makeServerType('3.1.0'),
+            makeServerType('3.2.0-beta'),
+            makeServerUIType('1.0.0'),
+            makeServerUIType('1.1.0'),
+        ];
+        const { latest, prior } = gen.getSortedModules(release);
+        (0, vitest_1.expect)(latest.length).toEqual(2);
+        (0, vitest_1.expect)(latest[0].name).toEqual('@minecraft/server');
+        (0, vitest_1.expect)(latest[0].version).toEqual('3.2.0-beta');
+        (0, vitest_1.expect)(latest[1].name).toEqual('@minecraft/server-ui');
+        (0, vitest_1.expect)(latest[1].version).toEqual('3.1.0-beta');
+        (0, vitest_1.expect)(prior.length).toEqual(4);
+        (0, vitest_1.expect)(prior[0].name).toEqual('@minecraft/server');
+        (0, vitest_1.expect)(prior[0].version).toEqual('2.1.0');
+        (0, vitest_1.expect)(prior[1].name).toEqual('@minecraft/server');
+        (0, vitest_1.expect)(prior[1].version).toEqual('1.4.0');
+        (0, vitest_1.expect)(prior[2].name).toEqual('@minecraft/server-ui');
+        (0, vitest_1.expect)(prior[2].version).toEqual('2.2.0');
+        (0, vitest_1.expect)(prior[3].name).toEqual('@minecraft/server-ui');
+        (0, vitest_1.expect)(prior[3].version).toEqual('1.1.0');
+    });
+});
+//# sourceMappingURL=msdocsGeneratorUnitTests.spec.js.map

package/lib/msdocsGeneratorUnitTests.spec.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@minecraft/markup-generators-plugin",
+  "version": "1.0.0",
+  "description": "Plugin for @minecraft/api-docs-generator containing core markup generators and template files",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "author": "Jake Shirley (jashir@mojang.com)",
+  "contributors": [
+    {
+      "name": "Raphael Landaverde",
+      "email": "rlanda@microsoft.com"
+    },
+    {
+      "name": "Zach Campbell",
+      "email": "zachary.campbell@skyboxlabs.com"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Mojang/minecraft-scripting-libraries.git",
+    "directory": "tools/markup-generators-plugin"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "just build",
+    "clean": "just clean",
+    "lint": "just lint",
+    "test": "just test",
+    "package": "just package",
+    "postpublish": "just postpublish"
+  },
+  "files": [
+    "lib/",
+    "!lib/**/*.{spec,test}.ts",
+    "templates/",
+    "README.md",
+    "CHANGELOG.*"
+  ],
+  "devDependencies": {
+    "@minecraft/api-docs-generator": "^1.0.0",
+    "@minecraft/core-build-tasks": "*",
+    "@types/mustache": "^4.2.2",
+    "@types/node": "^22.0.0",
+    "@types/semver": "^7.3.12",
+    "eslint": "^9.17.0",
+    "eslint-config-minecraft-scripting": "*",
+    "just-scripts": "^2.3.3",
+    "ts-node": "^10.9.2",
+    "vitest": "^3.0.8"
+  },
+  "dependencies": {
+    "@rushstack/node-core-library": "^5.13.0",
+    "esbuild": "^0.25.0",
+    "mustache": "^4.2.0",
+    "prettier": "^3.5.3",
+    "semver": "^7.3.5",
+    "typedoc": "~0.26.11",
+    "typescript": "~5.6.0"
+  },
+  "peerDependencies": {
+    "@minecraft/api-docs-generator": "^1.0.0"
+  }
+}

package/templates/msdocs/blocks/block.mustache

@@ -0,0 +1,18 @@
+---
+{{ >default_metadata }}
+title: {{{block_name}}} Block
+description: Description of the {{{block_name}}} block
+---
+# {{{block_name}}} Block
+{{#block_description}}
+{{{.}}}
+
+{{/block_description}}
+## Properties:
+{{#properties}}
+* {{{name}}}
+{{#property_description}}
+{{{.}}}
+
+{{/property_description}}
+{{/properties}}

package/templates/msdocs/blocks/block_property.mustache

@@ -0,0 +1,26 @@
+---
+{{ >default_metadata }}
+title: {{{property_name}}} Block Property
+description: Description and usage of the {{{property_name}}} block property
+---
+# {{{property_name}}} Block Property
+{{#property_description}}
+{{{.}}}
+
+{{/property_description}}
+{{^int_value_display_as_range}}
+## Values:
+Type: {{{type}}}
+
+{{#values}}
+* {{{value}}}
+{{#value_description}}
+{{{.}}}
+
+{{/value_description}}
+{{/values}}
+{{/int_value_display_as_range}}
+{{#int_value_display_as_range}}
+Value Type: int
+Value Range: {{{min_value}}} - {{{max_value}}}
+{{/int_value_display_as_range}}

package/templates/msdocs/blocks/default_metadata.mustache

@@ -0,0 +1,4 @@
+# DO NOT TOUCH — This file was automatically generated by @minecraft/api-docs-generator, to report problems file an issue at https://github.com/Mojang/minecraft-scripting-libraries
+author: jakeshirley
+ms.author: jashir
+ms.service: minecraft-bedrock-edition

package/templates/msdocs/commands/command.mustache

@@ -0,0 +1,52 @@
+---
+{{ >default_metadata }}
+title: {{{command_name}}} Command
+description: Description and usage of the {{{command_name}}} command
+---
+# `/{{{command_name}}}` Command
+{{#command_description}}
+{{{.}}}
+
+{{/command_description}}
+{{^command_description}}
+{{{description}}}
+
+{{/command_description}}
+<table>
+{{#aliases.length}}
+  <tr>
+    <th>Aliases</th>
+    <td>{{#aliases}}/{{{name}}}{{^is_last}}, {{/is_last}}{{/aliases}}</td>
+  </tr>
+{{/aliases.length}}
+  <tr>
+    <th>Permission Level</th>
+    <td>{{permission_level_name}}</td>
+  </tr>
+  <tr>
+    <th>Requires Cheats?</th>
+    <td>{{#requires_cheats}}Yes{{/requires_cheats}}{{^requires_cheats}}No{{/requires_cheats}}</td>
+  </tr>
+</table>
+
+## Usage
+{{#overloads}}
+{{> overload}}
+{{/overloads}}
+{{#arguments.length}}
+
+## Arguments
+{{#arguments}}
+- `{{{param_name}}}{{#type.syntax}}: {{{.}}}{{/type.syntax}}`: {{#type.has_link}}[{{{type.name}}}]{{#type.is_enum}}(../enums/{{{type.name}}}.md){{/type.is_enum}}{{^type.is_enum}}(../types/{{{type.name}}}.md){{/type.is_enum}}{{/type.has_link}}{{^type.has_link}}{{{type.name}}}{{/type.has_link}}
+{{#argument_description}}
+{{{.}}}
+{{/argument_description}}
+{{/arguments}}
+{{/arguments.length}}
+{{#command_enums.length}}
+
+## Enums
+{{#command_enums}}
+{{> inline_enum}}
+{{/command_enums}}
+{{/command_enums.length}}

package/templates/msdocs/commands/default_metadata.mustache

@@ -0,0 +1,4 @@
+# DO NOT TOUCH — This file was automatically generated by @minecraft/api-docs-generator, to report problems file an issue at https://github.com/Mojang/minecraft-scripting-libraries
+author: jakeshirley
+ms.author: jashir
+ms.service: minecraft-bedrock-edition

package/templates/msdocs/commands/enum.mustache

@@ -0,0 +1,25 @@
+---
+{{ >default_metadata }}
+title: {{{enum_name}}} Enum
+description: Description and values of the {{{enum_name}}} enum
+---
+# `{{{enum_name}}}` Enum
+{{#enum_description}}
+{{{.}}}
+{{/enum_description}}
+
+## Values
+{{#values}}
+- `{{{value}}}`
+{{#value_description}}
+{{{.}}}
+{{/value_description}}
+{{/values}}
+
+{{#command_references.length}}
+## References
+The following commands reference this enum:
+{{#command_references}}
+- [{{{command_name}}}](../commands/{{{command_name}}}.md)
+{{/command_references}}
+{{/command_references.length}}

package/templates/msdocs/commands/inline_enum.mustache

@@ -0,0 +1,15 @@
+### `{{{enum_name}}}`
+{{#enum_description}}
+{{{.}}}
+{{/enum_description}}
+
+#### Values
+{{#values}}
+- `{{{value}}}`
+{{#value_description}}
+{{{.}}}
+{{/value_description}}
+{{/values}}
+{{^is_last}}
+
+{{/is_last}}

package/templates/msdocs/commands/overload.mustache

@@ -0,0 +1,11 @@
+### {{^overload_header}}`/{{{command_name}}}{{#params}} {{> parameter}}{{/params}}`{{/overload_header}}{{#overload_header}}{{{.}}}{{/overload_header}}
+{{#overload_header}}
+`/{{{command_name}}}{{#params}} {{> parameter}}{{/params}}`
+
+{{/overload_header}}
+{{#overload_description}}
+{{{.}}}
+{{/overload_description}}
+{{^is_last}}
+
+{{/is_last}}

package/templates/msdocs/commands/parameter.mustache

@@ -0,0 +1 @@
+{{^type.is_keyword}}{{#is_optional}}[{{/is_optional}}{{^is_optional}}<{{/is_optional}}{{{param_name}}}: {{^type.syntax}}{{{type.name}}}{{/type.syntax}}{{#type.syntax}}{{{type.syntax}}}{{/type.syntax}}{{#is_optional}}]{{/is_optional}}{{^is_optional}}>{{/is_optional}}{{/type.is_keyword}}{{#type.is_keyword}}{{#is_optional}}[{{/is_optional}}{{{type.keyword_name}}}{{#is_optional}}: {{{type.name}}}]{{/is_optional}}{{/type.is_keyword}}

package/templates/msdocs/commands/summary.mustache

@@ -0,0 +1,21 @@
+---
+{{ >default_metadata }}
+title: Minecraft Commands
+description: List and descriptions of Minecraft commands and enums
+---
+# List and summary of commands:
+|Command   |Description   |Required Permission Level  | Requires Cheats Enabled |
+|----------|-----------|-----------|-----------|
+{{#commands}}
+| [`/{{{name}}}`](./commands/{{{name}}}.md) | {{^command_description}}{{description}}{{/command_description}}{{#command_description}}{{.}}{{/command_description}} | {{permission_level_name}} | {{#requires_cheats}}Yes{{/requires_cheats}}{{^requires_cheats}}No{{/requires_cheats}} |
+{{/commands}}
+
+# List and summary of command argument types and enums:
+|Type   |Description   |Is Enum?   |
+|----------|-----------|-----------|
+{{#command_types}}
+| {{{name}}} | {{type_description}} |   |
+{{/command_types}}
+{{#command_enums}}
+| [`{{{name}}}`](./enums/{{{name}}}.md) | {{enum_description}} | Yes |
+{{/command_enums}}

package/templates/msdocs/commands/toc.mustache

@@ -0,0 +1,6 @@
+- name: List of commands
+  href: commands.md
+{{#commands}}
+- name: {{{name}}}
+  href: commands/{{{name}}}.md
+{{/commands}}

package/templates/msdocs/script/class.mustache

@@ -0,0 +1,162 @@
+---
+{{ >default_metadata }}
+title: {{{from_module.filepath_name}}}.{{{name}}} {{#is_interface}}Interface{{/is_interface}}{{^is_interface}}Class{{/is_interface}}
+description: Contents of the {{{from_module.name}}}.{{{name}}} class{{#from_module.prior_version}} (Version {{.}}){{/from_module.prior_version}}.
+{{#is_prerelease}}
+monikerRange: "=minecraft-bedrock-experimental"
+{{/is_prerelease}}
+---
+# {{{class_name}}} {{#is_interface}}Interface{{/is_interface}}{{^is_interface}}Class{{/is_interface}}{{#from_module.prior_version}} (Version {{.}}){{/from_module.prior_version}}
+{{#show_prior_warning}}
+
+> [!IMPORTANT]
+> This documentation is for an older version of this module.{{#prior_link}} Go to the latest documentation [*here*]({{{.}}}).{{/prior_link}}
+{{/show_prior_warning}}
+{{#is_prerelease}}
+
+> [!CAUTION]
+> This {{#is_interface}}interface{{/is_interface}}{{^is_interface}}class{{/is_interface}} is still in pre-release.  Its signature may change or it may be removed in future releases.
+{{/is_prerelease}}
+{{#is_deprecated}}
+
+> [!CAUTION]
+> This {{#is_interface}}interface{{/is_interface}}{{^is_interface}}class{{/is_interface}} is deprecated and will be removed in {{{deprecated_version}}}.
+  {{#deprecated_description_md}}
+> 
+> {{{.}}}
+  {{/deprecated_description_md}}
+{{/is_deprecated}}
+{{#has_runtime_conditions}}
+ 
+## Required Experiments
+  {{#runtime_conditions}} 
+- {{.}}
+  {{/runtime_conditions}}
+
+{{/has_runtime_conditions}}
+{{#base_types.length}}
+
+## Extends
+  {{#base_types}}
+- {{> type_with_links}}
+  {{/base_types}}
+{{/base_types.length}}
+{{#iterator}}
+
+## Implements
+- Iterator<{{> type_with_links}}>
+{{/iterator}}
+{{#derived_types.length}}
+
+## Classes that extend {{{class_name}}}
+  {{#derived_types}}
+- {{> type_with_links}}
+  {{/derived_types}}
+{{/derived_types.length}}
+{{#class_description_md}}
+
+{{{.}}}
+{{/class_description_md}}
+{{#properties.length}}
+
+## Properties
+  {{#properties}}
+
+{{> property}}
+  {{/properties}}
+{{/properties.length}}
+{{#has_member_functions}}
+
+## Methods
+{{! Constructor(s), methods, then static functions}}
+  {{#functions}}
+    {{#is_constructor}}
+      {{#stable_only}}
+::: moniker range="=minecraft-bedrock-stable"
+      {{/stable_only}}
+      {{#is_prerelease}}
+::: moniker range="=minecraft-bedrock-experimental"
+      {{/is_prerelease}}
+- [{{{name}}}](#{{bookmark_name}})
+      {{#is_prerelease}}
+::: moniker-end
+      {{/is_prerelease}}    
+      {{#stable_only}}
+::: moniker-end
+      {{/stable_only}}
+    {{/is_constructor}}
+  {{/functions}}
+  {{#functions}}
+    {{^is_constructor}}
+      {{^is_static}}
+        {{#stable_only}}
+::: moniker range="=minecraft-bedrock-stable"
+        {{/stable_only}}
+        {{#is_prerelease}}
+::: moniker range="=minecraft-bedrock-experimental"
+        {{/is_prerelease}}
+- [{{{name}}}](#{{bookmark_name}})
+        {{#is_prerelease}}
+::: moniker-end
+        {{/is_prerelease}}    
+        {{#stable_only}}
+::: moniker-end
+        {{/stable_only}}   
+      {{/is_static}}
+    {{/is_constructor}}
+  {{/functions}}
+  {{#functions}}
+    {{^is_constructor}}
+      {{#is_static}}
+        {{#stable_only}}
+::: moniker range="=minecraft-bedrock-stable"
+        {{/stable_only}}
+        {{#is_prerelease}}
+::: moniker range="=minecraft-bedrock-experimental"
+        {{/is_prerelease}}
+- [{{{name}}}](#{{bookmark_name}})
+        {{#is_prerelease}}
+::: moniker-end
+        {{/is_prerelease}}    
+        {{#stable_only}}
+::: moniker-end
+        {{/stable_only}}   
+      {{/is_static}}
+    {{/is_constructor}}
+  {{/functions}}
+{{! Constructor(s), methods, then static functions}}
+  {{#functions}}
+    {{#is_constructor}}
+
+{{> function}}
+    {{/is_constructor}}
+  {{/functions}}
+  {{#functions}}
+    {{^is_constructor}}
+      {{^is_static}}
+
+{{> function}}
+      {{/is_static}}
+    {{/is_constructor}}
+  {{/functions}}
+  {{#functions}}
+    {{^is_constructor}}
+      {{#is_static}}
+
+{{> function}}
+      {{/is_static}}
+    {{/is_constructor}}
+  {{/functions}} 
+{{/has_member_functions}}
+{{#has_member_constants}}
+
+## Constants
+  {{#constants}}
+
+{{> property}}
+  {{/constants}}
+{{/has_member_constants}}
+{{#examples.length}}
+
+{{> examples}}
+{{/examples.length}}

package/templates/msdocs/script/default_metadata.mustache

@@ -0,0 +1,5 @@
+# DO NOT TOUCH — This file was automatically generated by @minecraft/api-docs-generator, to report problems file an issue at https://github.com/Mojang/minecraft-scripting-libraries
+author: jakeshirley
+ms.author: jashir
+ms.service: minecraft-bedrock-edition
+ms.date: 02/10/2025

package/templates/msdocs/script/enum.mustache

@@ -0,0 +1,39 @@
+---
+{{ >default_metadata }}
+title: {{{from_module.filepath_name}}}.{{{enum_name}}} Enumeration
+description: Contents of the {{{from_module.name}}}.{{{name}}} enumeration{{#from_module.prior_version}} (Version {{.}}){{/from_module.prior_version}}.
+{{#is_prerelease}}
+monikerRange: "=minecraft-bedrock-experimental"
+{{/is_prerelease}}
+---
+# {{{enum_name}}} Enumeration{{#from_module.prior_version}} (Version {{.}}){{/from_module.prior_version}}
+{{#show_prior_warning}}
+
+> [!IMPORTANT]
+> This documentation is for an older version of this module.{{#prior_link}} Go to the latest documentation [*here*]({{{.}}}).{{/prior_link}}
+{{/show_prior_warning}}
+{{#is_prerelease}}
+
+> [!CAUTION]
+> This enum is still in pre-release.  Its signature may change or it may be removed in future releases.
+{{/is_prerelease}}
+{{#is_deprecated}}
+
+> [!CAUTION]
+> This enum is deprecated and will be removed in {{{deprecated_version}}}.
+  {{#deprecated_description_md}}
+> 
+> {{{.}}}
+  {{/deprecated_description_md}}
+{{/is_deprecated}}
+{{#enum_description_md}}
+
+{{{.}}}
+{{/enum_description_md}}
+{{#constants.length}}
+
+## Constants
+  {{#constants}}
+{{> property_declaration }}
+  {{/constants}}
+{{/constants.length}}

package/templates/msdocs/script/examples.mustache

@@ -0,0 +1,15 @@
+#### Examples
+{{#examples}}
+
+##### ***{{{name}}}***
+
+```typescript
+  {{#code}}
+    {{#text}}
+{{{ . }}}
+    {{/text}}
+  {{/code}}
+```
+
+(preview) Work with this sample on the [MCTools.dev](https://mctools.dev/?open=gp/{{{name}}}) code sandbox.
+{{/examples}}