Add match regex attribute

packages/locales/src/locales/en.json

@@ -48,6 +48,7 @@
   "integer.between": "an integer between %0% and %1%",
   "invalid-key-combination": "Invalid combination of keys %0%",
   "invalid-regex-pattern": "Invalid regex pattern: %0%",
+  "mismatching-regex-pattern": "Value does not match regex: %0%",
   "java-edition.binder.wrong-folder": "Files in the %0% folder are not recognized in loaded version %1%, did you meant to use the %2% folder?",
   "java-edition.binder.wrong-version": "Files in the %0% folder are not recognized in loaded version %1%",
   "java-edition.pack-format.unsupported": "Pack format %0% does not have a corresponding release version. Snapshot versions are unsupported.",

packages/mcdoc/src/runtime/attribute/builtin.ts

@@ -30,6 +30,19 @@ const idValidator = validator.alternatives<IdConfig>(
 	() => ({}),
 )
 
+interface RegexConfig {
+	regex: string
+	error?: string
+}
+
+const regexMatchValidator = validator.alternatives<RegexConfig>(
+	validator.map(validator.string, v => ({ regex: v })),
+	validator.tree({
+		regex: validator.string,
+		error: validator.optional(validator.string),
+	}),
+)
+
 function getResourceLocationOptions(
 	{ registry, tags, definition, path }: IdConfig,
 	requireCanonical: boolean,
@@ -277,4 +290,35 @@ export function registerBuiltinAttributes(meta: core.MetaRegistry) {
 			}
 		},
 	})
+	registerAttribute(meta, 'match_regex', regexMatchValidator, {
+		checker: (config, typeDef, _) => {
+			if (typeDef.kind !== 'literal' || typeDef.value.kind !== 'string') {
+				return undefined
+			}
+			const pattern = config.regex
+			const value = typeDef.value.value
+			return (node, ctx) => {
+				try {
+					const regex = RegExp(pattern)
+					if (!regex.test(value)) {
+						if (config.error) {
+							ctx.err.report(config.error, node, 2)
+						} else {
+							ctx.err.report(
+								localize('mismatching-regex-pattern', typeDef.value.value),
+								node,
+								2,
+							)
+						}
+					}
+				} catch (e) {
+					const message = e instanceof Error ? e.message : `${e}`
+					const error = message
+						.replace(/^Invalid regular expression: /, '')
+						.replace(/^\/.+\/: /, '')
+					ctx.err.report(localize('invalid-regex-pattern', error), node, 2)
+				}
+			}
+		},
+	})
 }