@codeperfect/eslint-plugin 1.0.0 → 2.1.0

package/dist/domain/docs/require-example-language/fixes.js

@@ -0,0 +1,182 @@
+import { parseFenceLine, removeEmptyFences } from "./empty-fence-fixes.js";
+/**
+ * Applies a language to a fence line when needed.
+ * @param context Fence state and line data.
+ * @returns Updated line and fence state.
+ * @example
+ * ```typescript
+ * const result = applyFenceLanguage({ inFence: false, line: " * ```" });
+ * ```
+ */
+function applyFenceLanguage(context) {
+    const { inFence, line } = context;
+    const fenceInfo = parseFenceLine(line);
+    if (fenceInfo === void 0) {
+        return { inFence, line };
+    }
+    const shouldAddLanguage = !inFence && fenceInfo.language.length === 0;
+    const nextLine = shouldAddLanguage
+        ? `${fenceInfo.leading}\`\`\`typescript`
+        : line;
+    return { inFence: !inFence, line: nextLine };
+}
+/**
+ * Builds a full example with a fenced block when missing entirely.
+ * @param example Example metadata.
+ * @returns Example text with a fenced block.
+ * @example
+ * ```typescript
+ * const text = buildMissingFenceFix(example);
+ * ```
+ */
+function buildMissingFenceFix(example) {
+    const contentLines = normalizeContentLines({
+        content: example.content,
+        prefix: example.prefix,
+    });
+    return [
+        `${example.prefix}@example`,
+        `${example.prefix}\`\`\`typescript`,
+        ...contentLines.map((contentLine) => contentLine.length > 0
+            ? `${example.prefix} ${contentLine}`
+            : example.prefix),
+        `${example.prefix}\`\`\``,
+    ].join("\n");
+}
+/**
+ * Adds missing languages to existing fenced blocks.
+ * @param original Original comment text.
+ * @returns Updated comment text when changes are made.
+ * @example
+ * ```typescript
+ * const updated = buildMissingLanguageFix("* ```\n* ok\n* ```");
+ * ```
+ */
+function buildMissingLanguageFix(original) {
+    const lineBreak = original.includes("\r\n") ? "\r\n" : "\n";
+    const lines = original.split(/\r?\n/u);
+    let inFence = false;
+    const updatedLines = lines.map((line) => {
+        const { inFence: nextInFence, line: nextLine } = applyFenceLanguage({
+            inFence,
+            line,
+        });
+        inFence = nextInFence;
+        return nextLine;
+    });
+    const updated = updatedLines.join(lineBreak);
+    return updated === original ? void 0 : updated;
+}
+/**
+ * Builds a fixer function for the report.
+ * @param context Fixer context details.
+ * @returns Fixer function for ESLint.
+ * @example
+ * ```typescript
+ * const fixer = createFixer(context);
+ * ```
+ */
+function createFixer(context) {
+    const { absoluteEnd, absoluteStart } = context;
+    return (fixer) => {
+        const updated = getUpdatedExampleText(context);
+        if (updated === void 0) {
+            return void 0;
+        }
+        return fixer.replaceTextRange([absoluteStart, absoluteEnd], updated);
+    };
+}
+/**
+ * Extracts trailing whitespace from the original example range.
+ * @param original Original example text.
+ * @returns Trailing whitespace to preserve.
+ * @example
+ * ```typescript
+ * const suffix = getTrailingWhitespace("* @example ok\n ");
+ * ```
+ */
+function getTrailingWhitespace(original) {
+    const trailingMatch = /(?:\r?\n[ \t]*)$/u.exec(original);
+    return trailingMatch?.[0] ?? "";
+}
+/**
+ * Resolves the updated text for an example.
+ * @param context Fixer context details.
+ * @returns Fixed example text when a change is required.
+ * @example
+ * ```typescript
+ * const text = getUpdatedExampleText(context);
+ * ```
+ */
+function getUpdatedExampleText(context) {
+    const { absoluteEnd, absoluteStart, example, hasOtherExamples, problem, sourceText, } = context;
+    const original = sourceText.slice(absoluteStart, absoluteEnd);
+    if (problem === "missingLanguage") {
+        return buildMissingLanguageFix(original);
+    }
+    if (problem === "emptyExample") {
+        return resolveEmptyExampleFix({ example, hasOtherExamples, original });
+    }
+    const fixed = buildMissingFenceFix(example);
+    const trailingWhitespace = getTrailingWhitespace(original);
+    return trailingWhitespace.length > 0
+        ? `${fixed}${trailingWhitespace}`
+        : fixed;
+}
+/**
+ * Normalizes raw example content lines before fence wrapping.
+ * @param context Prefix and raw content.
+ * @returns Content lines safe to wrap in a fenced block.
+ * @example
+ * ```typescript
+ * const lines = normalizeContentLines({ content: "a\n * b", prefix: " * " });
+ * ```
+ */
+function normalizeContentLines(context) {
+    const { content, prefix } = context;
+    const lines = content.length > 0 ? content.split(/\r?\n/u) : [];
+    return lines
+        .map((line) => stripContentPrefix({ line, prefix }))
+        .map((line) => line.replace(/\s*\*\/[ \t]*$/u, ""));
+}
+/**
+ * Resolves the appropriate fix for empty examples.
+ * @param context Empty example fix details.
+ * @returns Fixed example text when a change is required.
+ * @example
+ * ```typescript
+ * const text = resolveEmptyExampleFix(context);
+ * ```
+ */
+function resolveEmptyExampleFix(context) {
+    const { example, hasOtherExamples, original } = context;
+    const cleaned = removeEmptyFences(original);
+    if (cleaned !== void 0) {
+        return cleaned;
+    }
+    if (hasOtherExamples) {
+        return "";
+    }
+    if (original.includes("```")) {
+        return void 0;
+    }
+    return buildMissingFenceFix(example);
+}
+/**
+ * Removes JSDoc line prefixes from example content.
+ * @param context Prefix and source line.
+ * @returns Cleaned content line.
+ * @example
+ * ```typescript
+ * const line = stripContentPrefix({ line: " * value", prefix: " * " });
+ * ```
+ */
+function stripContentPrefix(context) {
+    const { line, prefix } = context;
+    if (line.startsWith(prefix)) {
+        return line.slice(prefix.length);
+    }
+    return line.replace(/^\s*\*\s?/u, "");
+}
+export { buildMissingFenceFix, buildMissingLanguageFix, createFixer };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZml4ZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvZG9tYWluL2RvY3MvcmVxdWlyZS1leGFtcGxlLWxhbmd1YWdlL2ZpeGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUlBLE9BQU8sRUFBRSxjQUFjLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQTREeEU7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFTLGtCQUFrQixDQUFDLE9BQTZCO0lBQ3ZELE1BQU0sRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQ2xDLE1BQU0sU0FBUyxHQUFHLGNBQWMsQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUV2QyxJQUFJLFNBQVMsS0FBSyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3pCLE9BQU8sRUFBRSxPQUFPLEVBQUUsSUFBSSxFQUFFLENBQUM7SUFDM0IsQ0FBQztJQUVELE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxPQUFPLElBQUksU0FBUyxDQUFDLFFBQVEsQ0FBQyxNQUFNLEtBQUssQ0FBQyxDQUFDO0lBQ3RFLE1BQU0sUUFBUSxHQUFHLGlCQUFpQjtRQUNoQyxDQUFDLENBQUMsR0FBRyxTQUFTLENBQUMsT0FBTyxrQkFBa0I7UUFDeEMsQ0FBQyxDQUFDLElBQUksQ0FBQztJQUVULE9BQU8sRUFBRSxPQUFPLEVBQUUsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxDQUFDO0FBQy9DLENBQUM7QUFFRDs7Ozs7Ozs7R0FRRztBQUNILFNBQVMsb0JBQW9CLENBQUMsT0FBZ0I7SUFDNUMsTUFBTSxZQUFZLEdBQUcscUJBQXFCLENBQUM7UUFDekMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxPQUFPO1FBQ3hCLE1BQU0sRUFBRSxPQUFPLENBQUMsTUFBTTtLQUN2QixDQUFDLENBQUM7SUFFSCxPQUFPO1FBQ0wsR0FBRyxPQUFPLENBQUMsTUFBTSxVQUFVO1FBQzNCLEdBQUcsT0FBTyxD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RUFBRSxDQUFDO0lBQ1osQ0FBQztJQUVELElBQUksUUFBUSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQzdCLE9BQU8sS0FBSyxDQUFDLENBQUM7SUFDaEIsQ0FBQztJQUVELE9BQU8sb0JBQW9CLENBQUMsT0FBTyxDQUFDLENBQUM7QUFDdkMsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxrQkFBa0IsQ0FBQyxPQUFrQztJQUM1RCxNQUFNLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQztJQUVqQyxJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUM1QixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ25DLENBQUM7SUFFRCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsWUFBWSxFQUFFLEVBQUUsQ0FBQyxDQUFDO0FBQ3hDLENBQUM7QUFFRCxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsdUJBQXVCLEVBQUUsV0FBVyxFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IFJ1bGUgfSBmcm9tIFwiZXNsaW50XCI7XG5cbmltcG9ydCB0eXBlIHsgRXhhbXBsZSwgUHJvYmxlbSB9IGZyb20gXCIuL3R5cGVzXCI7XG5cbmltcG9ydCB7IHBhcnNlRmVuY2VMaW5lLCByZW1vdmVFbXB0eUZlbmNlcyB9IGZyb20gXCIuL2VtcHR5LWZlbmNlLWZpeGVzXCI7XG5cbi8qKiBUeXBlIGRlZmluaXRpb24gZm9yIHJ1bGUgZGF0YS4gKi9cbmludGVyZmFjZSBFbXB0eUV4YW1wbGVGaXhDb250ZXh0IHtcbiAgLyoqIEV4YW1wbGUgZmllbGQgdmFsdWUuICovXG4gIGV4YW1wbGU6IEV4YW1wbGU7XG4gIC8qKiBIYXNPdGhlckV4YW1wbGVzIGZpZWxkIHZhbHVlLiAqL1xuICBoYXNPdGhlckV4YW1wbGVzOiBib29sZWFuO1xuICAvKiogT3JpZ2luYWwgZmllbGQgdmFsdWUuICovXG4gIG9yaWdpbmFsOiBzdHJpbmc7XG59XG5cbi8qKiBUeXBlIGRlZmluaXRpb24gZm9yIHJ1bGUgZGF0YS4gKi9cbmludGVyZmFjZSBGZW5jZUxhbmd1YWdlQ29udGV4dCB7XG4gIC8qKiBJbkZlbmNlIGZpZWxkIHZhbHVlLiAqL1xuICBpbkZlbmNlOiBib29sZWFuO1xuICAvKiogTGluZSBmaWVsZCB2YWx1ZS4gKi9cbiAgbGluZTogc3RyaW5nO1xufVxuXG4vKiogVHlwZSBkZWZpbml0aW9uIGZvciBydWxlIGRhdGEuICovXG5pbnRlcmZhY2UgRmVuY2VSZXN1bHQge1xuICAvKiogSW5GZW5jZSBmaWVsZCB2YWx1ZS4gKi9cbiAgaW5GZW5jZTogYm9vbGVhbjtcbiAgLyoqIExpbmUgZmllbGQgdmFsdWUuICovXG4gIGxpbmU6IHN0cmluZztcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEZpeGVyQ29udGV4dCB7XG4gIC8qKiBBYnNvbHV0ZUVuZCBmaWVsZCB2YWx1ZS4gKi9cbiAgYWJzb2x1dGVFbmQ6IG51bWJlcjtcbiAgLyoqIEFic29sdXRlU3RhcnQgZmllbGQgdmFsdWUuICovXG4gIGFic29sdXRlU3RhcnQ6IG51bWJlcjtcbiAgLyoqIEV4YW1wbGUgZmllbGQgdmFsdWUuICovXG4gIGV4YW1wbGU6IEV4YW1wbGU7XG4gIC8qKiBIYXNPdGhlckV4YW1wbGVzIGZpZWxkIHZhbHVlLiAqL1xuICBoYXNPdGhlckV4YW1wbGVzOiBib29sZWFuO1xuICAvKiogUHJvYmxlbSBmaWVsZCB2YWx1ZS4gKi9cbiAgcHJvYmxlbTogUHJvYmxlbTtcbiAgLyoqIFNvdXJjZVRleHQgZmllbGQgdmFsdWUuICovXG4gIHNvdXJjZVRleHQ6IHN0cmluZztcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIE5vcm1hbGl6ZUNvbnRlbnRMaW5lc0NvbnRleHQge1xuICAvKiogQ29udGVudCBmaWVsZCB2YWx1ZS4gKi9cbiAgY29udGVudDogc3RyaW5nO1xuICAvKiogUHJlZml4IGZpZWxkIHZhbHVlLiAqL1xuICBwcmVmaXg6IHN0cmluZztcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIFN0cmlwQ29udGVudFByZWZpeENvbnRleHQge1xuICAvKiogTGluZSBmaWVsZCB2YWx1ZS4gKi9cbiAgbGluZTogc3RyaW5nO1xuICAvKiogUHJlZml4IGZpZWxkIHZhbHVlLiAqL1xuICBwcmVmaXg6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBcHBsaWVzIGEgbGFuZ3VhZ2UgdG8gYSBmZW5jZSBsaW5lIHdoZW4gbmVlZGVkLlxuICogQHBhcmFtIGNvbnRleHQgRmVuY2Ugc3RhdGUgYW5kIGxpbmUgZGF0YS5cbiAqIEByZXR1cm5zIFVwZGF0ZWQgbGluZSBhbmQgZmVuY2Ugc3RhdGUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgcmVzdWx0ID0gYXBwbHlGZW5jZUxhbmd1YWdlKHsgaW5GZW5jZTogZmFsc2UsIGxpbmU6IFwiICogYGBgXCIgfSk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gYXBwbHlGZW5jZUxhbmd1YWdlKGNvbnRleHQ6IEZlbmNlTGFuZ3VhZ2VDb250ZXh0KTogRmVuY2VSZXN1bHQge1xuICBjb25zdCB7IGluRmVuY2UsIGxpbmUgfSA9IGNvbnRleHQ7XG4gIGNvbnN0IGZlbmNlSW5mbyA9IHBhcnNlRmVuY2VMaW5lKGxpbmUpO1xuXG4gIGlmIChmZW5jZUluZm8gPT09IHZvaWQgMCkge1xuICAgIHJldHVybiB7IGluRmVuY2UsIGxpbmUgfTtcbiAgfVxuXG4gIGNvbnN0IHNob3VsZEFkZExhbmd1YWdlID0gIWluRmVuY2UgJiYgZmVuY2VJbmZvLmxhbmd1YWdlLmxlbmd0aCA9PT0gMDtcbiAgY29uc3QgbmV4dExpbmUgPSBzaG91bGRBZGRMYW5ndWFnZVxuICAgID8gYCR7ZmVuY2VJbmZvLmxlYWRpbmd9XFxgXFxgXFxgdHlwZXNjcmlwdGBcbiAgICA6IGxpbmU7XG5cbiAgcmV0dXJuIHsgaW5GZW5jZTogIWluRmVuY2UsIGxpbmU6IG5leHRMaW5lIH07XG59XG5cbi8qKlxuICogQnVpbGRzIGEgZnVsbCBleGFtcGxlIHdpdGggYSBmZW5jZWQgYmxvY2sgd2hlbiBtaXNzaW5nIGVudGlyZWx5LlxuICogQHBhcmFtIGV4YW1wbGUgRXhhbXBsZSBtZXRhZGF0YS5cbiAqIEByZXR1cm5zIEV4YW1wbGUgdGV4dCB3aXRoIGEgZmVuY2VkIGJsb2NrLlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IHRleHQgPSBidWlsZE1pc3NpbmdGZW5jZUZpeChleGFtcGxlKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBidWlsZE1pc3NpbmdGZW5jZUZpeChleGFtcGxlOiBFeGFtcGxlKTogc3RyaW5nIHtcbiAgY29uc3QgY29udGVudExpbmVzID0gbm9ybWFsaXplQ29udGVudExpbmVzKHtcbiAgICBjb250ZW50OiBleGFtcGxlLmNvbnRlbnQsXG4gICAgcHJlZml4OiBleGFtcGxlLnByZWZpeCxcbiAgfSk7XG5cbiAgcmV0dXJuIFtcbiAgICBgJHtleGFtcGxlLnByZWZpeH1AZXhhbXBsZWAsXG4gICAgYCR7ZXhhbXBsZS5wcmVmaXh9XFxgXFxgXFxgdHlwZXNjcmlwdGAsXG4gICAgLi4uY29udGVudExpbmVzLm1hcCgoY29udGVudExpbmUpID0+XG4gICAgICBjb250ZW50TGluZS5sZW5ndGggPiAwXG4gICAgICAgID8gYCR7ZXhhbXBsZS5wcmVmaXh9ICR7Y29udGVudExpbmV9YFxuICAgICAgICA6IGV4YW1wbGUucHJlZml4LFxuICAgICksXG4gICAgYCR7ZXhhbXBsZS5wcmVmaXh9XFxgXFxgXFxgYCxcbiAgXS5qb2luKFwiXFxuXCIpO1xufVxuXG4vKipcbiAqIEFkZHMgbWlzc2luZyBsYW5ndWFnZXMgdG8gZXhpc3RpbmcgZmVuY2VkIGJsb2Nrcy5cbiAqIEBwYXJhbSBvcmlnaW5hbCBPcmlnaW5hbCBjb21tZW50IHRleHQuXG4gKiBAcmV0dXJucyBVcGRhdGVkIGNvbW1lbnQgdGV4dCB3aGVuIGNoYW5nZXMgYXJlIG1hZGUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgdXBkYXRlZCA9IGJ1aWxkTWlzc2luZ0xhbmd1YWdlRml4KFwiKiBgYGBcXG4qIG9rXFxuKiBgYGBcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gYnVpbGRNaXNzaW5nTGFuZ3VhZ2VGaXgob3JpZ2luYWw6IHN0cmluZyk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IGxpbmVCcmVhayA9IG9yaWdpbmFsLmluY2x1ZGVzKFwiXFxyXFxuXCIpID8gXCJcXHJcXG5cIiA6IFwiXFxuXCI7XG4gIGNvbnN0IGxpbmVzID0gb3JpZ2luYWwuc3BsaXQoL1xccj9cXG4vdSk7XG4gIGxldCBpbkZlbmNlID0gZmFsc2U7XG5cbiAgY29uc3QgdXBkYXRlZExpbmVzID0gbGluZXMubWFwKChsaW5lKSA9PiB7XG4gICAgY29uc3QgeyBpbkZlbmNlOiBuZXh0SW5GZW5jZSwgbGluZTogbmV4dExpbmUgfSA9IGFwcGx5RmVuY2VMYW5ndWFnZSh7XG4gICAgICBpbkZlbmNlLFxuICAgICAgbGluZSxcbiAgICB9KTtcbiAgICBpbkZlbmNlID0gbmV4dEluRmVuY2U7XG4gICAgcmV0dXJuIG5leHRMaW5lO1xuICB9KTtcblxuICBjb25zdCB1cGRhdGVkID0gdXBkYXRlZExpbmVzLmpvaW4obGluZUJyZWFrKTtcblxuICByZXR1cm4gdXBkYXRlZCA9PT0gb3JpZ2luYWwgPyB2b2lkIDAgOiB1cGRhdGVkO1xufVxuXG4vKipcbiAqIEJ1aWxkcyBhIGZpeGVyIGZ1bmN0aW9uIGZvciB0aGUgcmVwb3J0LlxuICogQHBhcmFtIGNvbnRleHQgRml4ZXIgY29udGV4dCBkZXRhaWxzLlxuICogQHJldHVybnMgRml4ZXIgZnVuY3Rpb24gZm9yIEVTTGludC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBmaXhlciA9IGNyZWF0ZUZpeGVyKGNvbnRleHQpO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIGNyZWF0ZUZpeGVyKFxuICBjb250ZXh0OiBGaXhlckNvbnRleHQsXG4pOiAoZml4ZXI6IFJ1bGUuUnVsZUZpeGVyKSA9PiBSdWxlLkZpeCB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IHsgYWJzb2x1dGVFbmQsIGFic29sdXRlU3RhcnQgfSA9IGNvbnRleHQ7XG5cbiAgcmV0dXJuIChmaXhlcjogUnVsZS5SdWxlRml4ZXIpOiBSdWxlLkZpeCB8IHVuZGVmaW5lZCA9PiB7XG4gICAgY29uc3QgdXBkYXRlZCA9IGdldFVwZGF0ZWRFeGFtcGxlVGV4dChjb250ZXh0KTtcblxuICAgIGlmICh1cGRhdGVkID09PSB2b2lkIDApIHtcbiAgICAgIHJldHVybiB2b2lkIDA7XG4gICAgfVxuXG4gICAgcmV0dXJuIGZpeGVyLnJlcGxhY2VUZXh0UmFuZ2UoW2Fic29sdXRlU3RhcnQsIGFic29sdXRlRW5kXSwgdXBkYXRlZCk7XG4gIH07XG59XG5cbi8qKlxuICogRXh0cmFjdHMgdHJhaWxpbmcgd2hpdGVzcGFjZSBmcm9tIHRoZSBvcmlnaW5hbCBleGFtcGxlIHJhbmdlLlxuICogQHBhcmFtIG9yaWdpbmFsIE9yaWdpbmFsIGV4YW1wbGUgdGV4dC5cbiAqIEByZXR1cm5zIFRyYWlsaW5nIHdoaXRlc3BhY2UgdG8gcHJlc2VydmUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3Qgc3VmZml4ID0gZ2V0VHJhaWxpbmdXaGl0ZXNwYWNlKFwiKiBAZXhhbXBsZSBva1xcbiBcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gZ2V0VHJhaWxpbmdXaGl0ZXNwYWNlKG9yaWdpbmFsOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCB0cmFpbGluZ01hdGNoID0gLyg/Olxccj9cXG5bIFxcdF0qKSQvdS5leGVjKG9yaWdpbmFsKTtcblxuICByZXR1cm4gdHJhaWxpbmdNYXRjaD8uWzBdID8/IFwiXCI7XG59XG5cbi8qKlxuICogUmVzb2x2ZXMgdGhlIHVwZGF0ZWQgdGV4dCBmb3IgYW4gZXhhbXBsZS5cbiAqIEBwYXJhbSBjb250ZXh0IEZpeGVyIGNvbnRleHQgZGV0YWlscy5cbiAqIEByZXR1cm5zIEZpeGVkIGV4YW1wbGUgdGV4dCB3aGVuIGEgY2hhbmdlIGlzIHJlcXVpcmVkLlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IHRleHQgPSBnZXRVcGRhdGVkRXhhbXBsZVRleHQoY29udGV4dCk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gZ2V0VXBkYXRlZEV4YW1wbGVUZXh0KGNvbnRleHQ6IEZpeGVyQ29udGV4dCk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IHtcbiAgICBhYnNvbHV0ZUVuZCxcbiAgICBhYnNvbHV0ZVN0YXJ0LFxuICAgIGV4YW1wbGUsXG4gICAgaGFzT3RoZXJFeGFtcGxlcyxcbiAgICBwcm9ibGVtLFxuICAgIHNvdXJjZVRleHQsXG4gIH0gPSBjb250ZXh0O1xuICBjb25zdCBvcmlnaW5hbCA9IHNvdXJjZVRleHQuc2xpY2UoYWJzb2x1dGVTdGFydCwgYWJzb2x1dGVFbmQpO1xuXG4gIGlmIChwcm9ibGVtID09PSBcIm1pc3NpbmdMYW5ndWFnZVwiKSB7XG4gICAgcmV0dXJuIGJ1aWxkTWlzc2luZ0xhbmd1YWdlRml4KG9yaWdpbmFsKTtcbiAgfVxuXG4gIGlmIChwcm9ibGVtID09PSBcImVtcHR5RXhhbXBsZVwiKSB7XG4gICAgcmV0dXJuIHJlc29sdmVFbXB0eUV4YW1wbGVGaXgoeyBleGFtcGxlLCBoYXNPdGhlckV4YW1wbGVzLCBvcmlnaW5hbCB9KTtcbiAgfVxuXG4gIGNvbnN0IGZpeGVkID0gYnVpbGRNaXNzaW5nRmVuY2VGaXgoZXhhbXBsZSk7XG4gIGNvbnN0IHRyYWlsaW5nV2hpdGVzcGFjZSA9IGdldFRyYWlsaW5nV2hpdGVzcGFjZShvcmlnaW5hbCk7XG5cbiAgcmV0dXJuIHRyYWlsaW5nV2hpdGVzcGFjZS5sZW5ndGggPiAwXG4gICAgPyBgJHtmaXhlZH0ke3RyYWlsaW5nV2hpdGVzcGFjZX1gXG4gICAgOiBmaXhlZDtcbn1cblxuLyoqXG4gKiBOb3JtYWxpemVzIHJhdyBleGFtcGxlIGNvbnRlbnQgbGluZXMgYmVmb3JlIGZlbmNlIHdyYXBwaW5nLlxuICogQHBhcmFtIGNvbnRleHQgUHJlZml4IGFuZCByYXcgY29udGVudC5cbiAqIEByZXR1cm5zIENvbnRlbnQgbGluZXMgc2FmZSB0byB3cmFwIGluIGEgZmVuY2VkIGJsb2NrLlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IGxpbmVzID0gbm9ybWFsaXplQ29udGVudExpbmVzKHsgY29udGVudDogXCJhXFxuICogYlwiLCBwcmVmaXg6IFwiICogXCIgfSk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gbm9ybWFsaXplQ29udGVudExpbmVzKFxuICBjb250ZXh0OiBOb3JtYWxpemVDb250ZW50TGluZXNDb250ZXh0LFxuKTogc3RyaW5nW10ge1xuICBjb25zdCB7IGNvbnRlbnQsIHByZWZpeCB9ID0gY29udGV4dDtcbiAgY29uc3QgbGluZXMgPSBjb250ZW50Lmxlbmd0aCA+IDAgPyBjb250ZW50LnNwbGl0KC9cXHI/XFxuL3UpIDogW107XG5cbiAgcmV0dXJuIGxpbmVzXG4gICAgLm1hcCgobGluZSkgPT4gc3RyaXBDb250ZW50UHJlZml4KHsgbGluZSwgcHJlZml4IH0pKVxuICAgIC5tYXAoKGxpbmUpID0+IGxpbmUucmVwbGFjZSgvXFxzKlxcKlxcL1sgXFx0XSokL3UsIFwiXCIpKTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlcyB0aGUgYXBwcm9wcmlhdGUgZml4IGZvciBlbXB0eSBleGFtcGxlcy5cbiAqIEBwYXJhbSBjb250ZXh0IEVtcHR5IGV4YW1wbGUgZml4IGRldGFpbHMuXG4gKiBAcmV0dXJucyBGaXhlZCBleGFtcGxlIHRleHQgd2hlbiBhIGNoYW5nZSBpcyByZXF1aXJlZC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB0ZXh0ID0gcmVzb2x2ZUVtcHR5RXhhbXBsZUZpeChjb250ZXh0KTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiByZXNvbHZlRW1wdHlFeGFtcGxlRml4KFxuICBjb250ZXh0OiBFbXB0eUV4YW1wbGVGaXhDb250ZXh0LFxuKTogc3RyaW5nIHwgdW5kZWZpbmVkIHtcbiAgY29uc3QgeyBleGFtcGxlLCBoYXNPdGhlckV4YW1wbGVzLCBvcmlnaW5hbCB9ID0gY29udGV4dDtcbiAgY29uc3QgY2xlYW5lZCA9IHJlbW92ZUVtcHR5RmVuY2VzKG9yaWdpbmFsKTtcblxuICBpZiAoY2xlYW5lZCAhPT0gdm9pZCAwKSB7XG4gICAgcmV0dXJuIGNsZWFuZWQ7XG4gIH1cblxuICBpZiAoaGFzT3RoZXJFeGFtcGxlcykge1xuICAgIHJldHVybiBcIlwiO1xuICB9XG5cbiAgaWYgKG9yaWdpbmFsLmluY2x1ZGVzKFwiYGBgXCIpKSB7XG4gICAgcmV0dXJuIHZvaWQgMDtcbiAgfVxuXG4gIHJldHVybiBidWlsZE1pc3NpbmdGZW5jZUZpeChleGFtcGxlKTtcbn1cblxuLyoqXG4gKiBSZW1vdmVzIEpTRG9jIGxpbmUgcHJlZml4ZXMgZnJvbSBleGFtcGxlIGNvbnRlbnQuXG4gKiBAcGFyYW0gY29udGV4dCBQcmVmaXggYW5kIHNvdXJjZSBsaW5lLlxuICogQHJldHVybnMgQ2xlYW5lZCBjb250ZW50IGxpbmUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgbGluZSA9IHN0cmlwQ29udGVudFByZWZpeCh7IGxpbmU6IFwiICogdmFsdWVcIiwgcHJlZml4OiBcIiAqIFwiIH0pO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIHN0cmlwQ29udGVudFByZWZpeChjb250ZXh0OiBTdHJpcENvbnRlbnRQcmVmaXhDb250ZXh0KTogc3RyaW5nIHtcbiAgY29uc3QgeyBsaW5lLCBwcmVmaXggfSA9IGNvbnRleHQ7XG5cbiAgaWYgKGxpbmUuc3RhcnRzV2l0aChwcmVmaXgpKSB7XG4gICAgcmV0dXJuIGxpbmUuc2xpY2UocHJlZml4Lmxlbmd0aCk7XG4gIH1cblxuICByZXR1cm4gbGluZS5yZXBsYWNlKC9eXFxzKlxcKlxccz8vdSwgXCJcIik7XG59XG5cbmV4cG9ydCB7IGJ1aWxkTWlzc2luZ0ZlbmNlRml4LCBidWlsZE1pc3NpbmdMYW5ndWFnZUZpeCwgY3JlYXRlRml4ZXIgfTtcbiJdfQ==

package/dist/domain/docs/require-example-language/index.d.ts

@@ -0,0 +1,3 @@
+export { requireExampleLanguageRule } from "./rule.js";
+export type { Comment, Example, Problem } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/docs/require-example-language/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/require-example-language/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,QAAQ,CAAC;AACpD,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC"}

package/dist/domain/docs/require-example-language/index.js

@@ -0,0 +1,2 @@
+export { requireExampleLanguageRule } from "./rule.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvZG9tYWluL2RvY3MvcmVxdWlyZS1leGFtcGxlLWxhbmd1YWdlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSwwQkFBMEIsRUFBRSxNQUFNLFFBQVEsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCB7IHJlcXVpcmVFeGFtcGxlTGFuZ3VhZ2VSdWxlIH0gZnJvbSBcIi4vcnVsZVwiO1xuZXhwb3J0IHR5cGUgeyBDb21tZW50LCBFeGFtcGxlLCBQcm9ibGVtIH0gZnJvbSBcIi4vdHlwZXNcIjtcbiJdfQ==

package/dist/{docs → domain/docs}/require-example-language/reporting.d.ts

@@ -1,5 +1,5 @@
 import type { Rule } from "eslint";
-import type { Comment, Example, Problem } from "./types";
+import type { Comment, Example, Problem } from "./types.js";
 /** Type definition for rule data. */
 interface ReportDescriptorContext {
     /** Comment field value. */

package/dist/domain/docs/require-example-language/reporting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/require-example-language/reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAuBzD,qCAAqC;AACrC,UAAU,uBAAuB;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAE1B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED,qCAAqC;AACrC,UAAU,oBAAoB;IAC5B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,2BAA2B;IAC3B,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC;IAE1B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAuBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,qBAAqB,CAC5B,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAAC,gBAAgB,CA6BvB;AA0FD;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAiB1D;AAED,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,CAAC"}

package/dist/domain/docs/require-example-language/reporting.js

@@ -0,0 +1,148 @@
+import { checkExampleContent } from "./examples.js";
+import { createFixer } from "./fixes.js";
+/**
+ * Build a report descriptor for a single example problem.
+ * @param context Input context value.
+ * @returns Return value output.
+ * @example
+ * ```typescript
+ * const descriptor = buildReportDescriptor({
+ *   comment: { type: "Block", value: "*" } as Comment,
+ *   example: {
+ *     content: "",
+ *     endIndex: 0,
+ *     endOffset: 0,
+ *     lineIndex: 0,
+ *     prefix: " * ",
+ *     startOffset: 0,
+ *   },
+ *   hasOtherExamples: false,
+ *   problem: "missingFence",
+ *   sourceCode: {} as Rule.SourceCode,
+ * });
+ * ```
+ */
+function buildReportDescriptor(context) {
+    const { comment, example, hasOtherExamples, problem, sourceCode } = context;
+    const fix = getFixerForExample({
+        comment,
+        example,
+        hasOtherExamples,
+        problem,
+        sourceCode,
+    });
+    const reportFix = fix === void 0
+        ? void 0
+        : (fixer) => fix(fixer) ?? [];
+    const loc = getReportLocation(comment, example);
+    if (loc !== void 0) {
+        return {
+            fix: reportFix,
+            loc,
+            messageId: problem,
+        };
+    }
+    return {
+        fix: reportFix,
+        messageId: problem,
+        node: sourceCode.ast,
+    };
+}
+/**
+ * Resolve a fixer for the report when ranges are available.
+ * @param context Input context value.
+ * @returns Return value output.
+ * @example
+ * ```typescript
+ * const fixer = getFixerForExample({
+ *   comment: { type: "Block", value: "*" } as Comment,
+ *   example: {
+ *     content: "",
+ *     endIndex: 0,
+ *     endOffset: 0,
+ *     lineIndex: 0,
+ *     prefix: " * ",
+ *     startOffset: 0,
+ *   },
+ *   hasOtherExamples: false,
+ *   problem: "missingLanguage",
+ *   sourceCode: {} as Rule.SourceCode,
+ * });
+ * ```
+ */
+function getFixerForExample(context) {
+    const { comment, example, hasOtherExamples, problem, sourceCode } = context;
+    const commentOffset = comment.range?.[0];
+    const commentValueOffset = typeof commentOffset === "number" ? commentOffset + 2 : void 0;
+    const absoluteStart = typeof commentValueOffset === "number"
+        ? commentValueOffset + example.startOffset
+        : void 0;
+    const absoluteEnd = typeof commentValueOffset === "number"
+        ? commentValueOffset + example.endOffset
+        : void 0;
+    if (typeof absoluteStart !== "number" || typeof absoluteEnd !== "number") {
+        return void 0;
+    }
+    return createFixer({
+        absoluteEnd,
+        absoluteStart,
+        example,
+        hasOtherExamples,
+        problem,
+        sourceText: sourceCode.text,
+    });
+}
+/**
+ * Resolve the report location for a matched example.
+ * @param comment Comment node containing the example.
+ * @param example Example metadata.
+ * @returns Report location when available.
+ * @example
+ * ```typescript
+ * const loc = getReportLocation({} as Comment, {
+ *    content: "",
+ *    endIndex: 0,
+ *    endOffset: 0,
+ *    lineIndex: 0,
+ *    prefix: "",
+ *    startOffset: 0,
+ * });
+ * ```
+ */
+function getReportLocation(comment, example) {
+    const line = typeof comment.loc?.start.line === "number"
+        ? comment.loc.start.line + example.lineIndex
+        : void 0;
+    if (line === void 0) {
+        return void 0;
+    }
+    return {
+        end: { column: 1, line },
+        start: { column: 0, line },
+    };
+}
+/**
+ * Reports a single example when it violates the rule.
+ * @param context Report details for this example.
+ * @example
+ * ```typescript
+ * reportExample(context);
+ * ```
+ */
+function reportExample(context) {
+    const { comment, context: ruleContext, example, hasOtherExamples } = context;
+    const problem = checkExampleContent(example.content);
+    if (problem === void 0) {
+        return;
+    }
+    const descriptor = buildReportDescriptor({
+        comment,
+        example,
+        hasOtherExamples,
+        problem,
+        sourceCode: ruleContext.sourceCode,
+    });
+    ruleContext.report(descriptor);
+}
+export { buildReportDescriptor, reportExample };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVwb3J0aW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2RvbWFpbi9kb2NzL3JlcXVpcmUtZXhhbXBsZS1sYW5ndWFnZS9yZXBvcnRpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBSUEsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxTQUFTLENBQUM7QUEwRXRDOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FxQkc7QUFDSCxTQUFTLHFCQUFxQixDQUM1QixPQUFnQztJQUVoQyxNQUFNLEVBQUUsT0FBTyxFQUFFLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQzVFLE1BQU0sR0FBRyxHQUFHLGtCQUFrQixDQUFDO1FBQzdCLE9BQU87UUFDUCxPQUFPO1FBQ1AsZ0JBQWdCO1FBQ2hCLE9BQU87UUFDUCxVQUFVO0tBQ1gsQ0FBQyxDQUFDO0lBQ0gsTUFBTSxTQUFTLEdBQ2IsR0FBRyxLQUFLLEtBQUssQ0FBQztRQUNaLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDUixDQUFDLENBQUMsQ0FBQyxLQUFxQixFQUFpQyxFQUFFLENBQ3ZELEdBQUcsQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDekIsTUFBTSxHQUFHLEdBQUcsaUJBQWlCLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBRWhELElBQUksR0FBRyxLQUFLLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDbkIsT0FBTztZQUNMLEdBQUcsRUFBRSxTQUFTO1lBQ2QsR0FBRztZQUNILFNBQVMsRUFBRSxPQUFPO1NBQ25CLENBQUM7SUFDSixDQUFDO0lBRUQsT0FBTztRQUNMLEdBQUcsRUFBRSxTQUFTO1FBQ2QsU0FBUyxFQUFFLE9BQU87UUFDbEIsSUFBSSxFQUFFLFVBQVUsQ0FBQyxHQUFHO0tBQ3JCLENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXFCRztBQUNILFNBQVMsa0JBQWtCLENBQ3pCLE9BQTJCO0lBRTNCLE1BQU0sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsR0FBRyxPQUFPLENBQUM7SUFDNUUsTUFBTSxhQUFhLEdBQUcsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3pDLE1BQU0sa0JBQWtCLEdBQ3RCLE9BQU8sYUFBYSxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsYUFBYSxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDakUsTUFBTSxhQUFhLEdBQ2pCLE9BQU8sa0JBQWtCLEtBQUssUUFBUTtRQUNwQyxDQUFDLENBQUMsa0JBQWtCLEdBQUcsT0FBTyxDQUFDLFdBQVc7UUFDMUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ2IsTUFBTSxXQUFXLEdBQ2YsT0FBTyxrQkFBa0IsS0FBSyxRQUFRO1FBQ3BDLENBQUMsQ0FBQyxrQkFBa0IsR0FBRyxPQUFPLENBQUMsU0FBUztRQUN4QyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7SUFFYixJQUFJLE9BQU8sYUFBYSxLQUFLLFFBQVEsSUFBSSxPQUFPLFdBQVcsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUN6RSxPQUFPLEtBQUssQ0FBQyxDQUFDO0lBQ2hCLENBQUM7SUFFRCxPQUFPLFdBQVcsQ0FBQztRQUNqQixXQUFXO1FBQ1gsYUFBYTtRQUNiLE9BQU87UUFDUCxnQkFBZ0I7UUFDaEIsT0FBTztRQUNQLFVBQVUsRUFBRSxVQUFVLENBQUMsSUFBSTtLQUM1QixDQUFDLENBQUM7QUFDTCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxTQUFTLGlCQUFpQixDQUN4QixPQUFnQixFQUNoQixPQUFnQjtJQUVoQixNQUFNLElBQUksR0FDUixPQUFPLE9BQU8sQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksS0FBSyxRQUFRO1FBQ3pDLENBQUMsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLEdBQUcsT0FBTyxDQUFDLFNBQVM7UUFDNUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBRWIsSUFBSSxJQUFJLEtBQUssS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUNwQixPQUFPLEtBQUssQ0FBQyxDQUFDO0lBQ2hCLENBQUM7SUFFRCxPQUFPO1FBQ0wsR0FBRyxFQUFFLEVBQUUsTUFBTSxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUU7UUFDeEIsS0FBSyxFQUFFLEVBQUUsTUFBTSxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUU7S0FDM0IsQ0FBQztBQUNKLENBQUM7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsU0FBUyxhQUFhLENBQUMsT0FBNkI7SUFDbEQsTUFBTSxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxHQUFHLE9BQU8sQ0FBQztJQUM3RSxNQUFNLE9BQU8sR0FBRyxtQkFBbUIsQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLENBQUM7SUFFckQsSUFBSSxPQUFPLEtBQUssS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUN2QixPQUFPO0lBQ1QsQ0FBQztJQUVELE1BQU0sVUFBVSxHQUFHLHFCQUFxQixDQUFDO1FBQ3ZDLE9BQU87UUFDUCxPQUFPO1FBQ1AsZ0JBQWdCO1FBQ2hCLE9BQU87UUFDUCxVQUFVLEVBQUUsV0FBVyxDQUFDLFVBQVU7S0FDbkMsQ0FBQyxDQUFDO0lBRUgsV0FBVyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQztBQUNqQyxDQUFDO0FBRUQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLGFBQWEsRUFBRSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBSdWxlIH0gZnJvbSBcImVzbGludFwiO1xuXG5pbXBvcnQgdHlwZSB7IENvbW1lbnQsIEV4YW1wbGUsIFByb2JsZW0gfSBmcm9tIFwiLi90eXBlc1wiO1xuXG5pbXBvcnQgeyBjaGVja0V4YW1wbGVDb250ZW50IH0gZnJvbSBcIi4vZXhhbXBsZXNcIjtcbmltcG9ydCB7IGNyZWF0ZUZpeGVyIH0gZnJvbSBcIi4vZml4ZXNcIjtcblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEZpeGVyTG9va3VwQ29udGV4dCB7XG4gIC8qKiBDb21tZW50IGZpZWxkIHZhbHVlLiAqL1xuICBjb21tZW50OiBDb21tZW50O1xuXG4gIC8qKiBFeGFtcGxlIGZpZWxkIHZhbHVlLiAqL1xuICBleGFtcGxlOiBFeGFtcGxlO1xuXG4gIC8qKiBIYXNPdGhlckV4YW1wbGVzIGZpZWxkIHZhbHVlLiAqL1xuICBoYXNPdGhlckV4YW1wbGVzOiBib29sZWFuO1xuXG4gIC8qKiBQcm9ibGVtIGZpZWxkIHZhbHVlLiAqL1xuICBwcm9ibGVtOiBQcm9ibGVtO1xuXG4gIC8qKiBTb3VyY2VDb2RlIGZpZWxkIHZhbHVlLiAqL1xuICBzb3VyY2VDb2RlOiBSdWxlLlJ1bGVDb250ZXh0W1wic291cmNlQ29kZVwiXTtcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIFJlcG9ydERlc2NyaXB0b3JDb250ZXh0IHtcbiAgLyoqIENvbW1lbnQgZmllbGQgdmFsdWUuICovXG4gIGNvbW1lbnQ6IENvbW1lbnQ7XG5cbiAgLyoqIEV4YW1wbGUgZmllbGQgdmFsdWUuICovXG4gIGV4YW1wbGU6IEV4YW1wbGU7XG5cbiAgLyoqIEhhc090aGVyRXhhbXBsZXMgZmllbGQgdmFsdWUuICovXG4gIGhhc090aGVyRXhhbXBsZXM6IGJvb2xlYW47XG5cbiAgLyoqIFByb2JsZW0gZmllbGQgdmFsdWUuICovXG4gIHByb2JsZW06IFByb2JsZW07XG5cbiAgLyoqIFNvdXJjZUNvZGUgZmllbGQgdmFsdWUuICovXG4gIHNvdXJjZUNvZGU6IFJ1bGUuUnVsZUNvbnRleHRbXCJzb3VyY2VDb2RlXCJdO1xufVxuXG4vKiogVHlwZSBkZWZpbml0aW9uIGZvciBydWxlIGRhdGEuICovXG5pbnRlcmZhY2UgUmVwb3J0RXhhbXBsZUNvbnRleHQge1xuICAvKiogQ29tbWVudCBmaWVsZCB2YWx1ZS4gKi9cbiAgY29tbWVudDogQ29tbWVudDtcblxuICAvKiogQ29udGV4dCBmaWVsZCB2YWx1ZS4gKi9cbiAgY29udGV4dDogUnVsZS5SdWxlQ29udGV4dDtcblxuICAvKiogRXhhbXBsZSBmaWVsZCB2YWx1ZS4gKi9cbiAgZXhhbXBsZTogRXhhbXBsZTtcblxuICAvKiogSGFzT3RoZXJFeGFtcGxlcyBmaWVsZCB2YWx1ZS4gKi9cbiAgaGFzT3RoZXJFeGFtcGxlczogYm9vbGVhbjtcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIFJlcG9ydExvY2F0aW9uIHtcbiAgLyoqIEVuZCBmaWVsZCB2YWx1ZS4gKi9cbiAgZW5kOiB7XG4gICAgLyoqIENvbHVtbiBmaWVsZCB2YWx1ZS4gKi9cbiAgICBjb2x1bW46IG51bWJlcjtcblxuICAgIC8qKiBMaW5lIGZpZWxkIHZhbHVlLiAqL1xuICAgIGxpbmU6IG51bWJlcjtcbiAgfTtcblxuICAvKiogU3RhcnQgZmllbGQgdmFsdWUuICovXG4gIHN0YXJ0OiB7XG4gICAgLyoqIENvbHVtbiBmaWVsZCB2YWx1ZS4gKi9cbiAgICBjb2x1bW46IG51bWJlcjtcblxuICAgIC8qKiBMaW5lIGZpZWxkIHZhbHVlLiAqL1xuICAgIGxpbmU6IG51bWJlcjtcbiAgfTtcbn1cblxuLyoqXG4gKiBCdWlsZCBhIHJlcG9ydCBkZXNjcmlwdG9yIGZvciBhIHNpbmdsZSBleGFtcGxlIHByb2JsZW0uXG4gKiBAcGFyYW0gY29udGV4dCBJbnB1dCBjb250ZXh0IHZhbHVlLlxuICogQHJldHVybnMgUmV0dXJuIHZhbHVlIG91dHB1dC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBkZXNjcmlwdG9yID0gYnVpbGRSZXBvcnREZXNjcmlwdG9yKHtcbiAqICAgY29tbWVudDogeyB0eXBlOiBcIkJsb2NrXCIsIHZhbHVlOiBcIipcIiB9IGFzIENvbW1lbnQsXG4gKiAgIGV4YW1wbGU6IHtcbiAqICAgICBjb250ZW50OiBcIlwiLFxuICogICAgIGVuZEluZGV4OiAwLFxuICogICAgIGVuZE9mZnNldDogMCxcbiAqICAgICBsaW5lSW5kZXg6IDAsXG4gKiAgICAgcHJlZml4OiBcIiAqIFwiLFxuICogICAgIHN0YXJ0T2Zmc2V0OiAwLFxuICogICB9LFxuICogICBoYXNPdGhlckV4YW1wbGVzOiBmYWxzZSxcbiAqICAgcHJvYmxlbTogXCJtaXNzaW5nRmVuY2VcIixcbiAqICAgc291cmNlQ29kZToge30gYXMgUnVsZS5Tb3VyY2VDb2RlLFxuICogfSk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gYnVpbGRSZXBvcnREZXNjcmlwdG9yKFxuICBjb250ZXh0OiBSZXBvcnREZXNjcmlwdG9yQ29udGV4dCxcbik6IFJ1bGUuUmVwb3J0RGVzY3JpcHRvciB7XG4gIGNvbnN0IHsgY29tbWVudCwgZXhhbXBsZSwgaGFzT3RoZXJFeGFtcGxlcywgcHJvYmxlbSwgc291cmNlQ29kZSB9ID0gY29udGV4dDtcbiAgY29uc3QgZml4ID0gZ2V0Rml4ZXJGb3JFeGFtcGxlKHtcbiAgICBjb21tZW50LFxuICAgIGV4YW1wbGUsXG4gICAgaGFzT3RoZXJFeGFtcGxlcyxcbiAgICBwcm9ibGVtLFxuICAgIHNvdXJjZUNvZGUsXG4gIH0pO1xuICBjb25zdCByZXBvcnRGaXggPVxuICAgIGZpeCA9PT0gdm9pZCAwXG4gICAgICA/IHZvaWQgMFxuICAgICAgOiAoZml4ZXI6IFJ1bGUuUnVsZUZpeGVyKTogSXRlcmFibGU8UnVsZS5GaXg+IHwgUnVsZS5GaXggPT5cbiAgICAgICAgICBmaXgoZml4ZXIpID8/IFtdO1xuICBjb25zdCBsb2MgPSBnZXRSZXBvcnRMb2NhdGlvbihjb21tZW50LCBleGFtcGxlKTtcblxuICBpZiAobG9jICE9PSB2b2lkIDApIHtcbiAgICByZXR1cm4ge1xuICAgICAgZml4OiByZXBvcnRGaXgsXG4gICAgICBsb2MsXG4gICAgICBtZXNzYWdlSWQ6IHByb2JsZW0sXG4gICAgfTtcbiAgfVxuXG4gIHJldHVybiB7XG4gICAgZml4OiByZXBvcnRGaXgsXG4gICAgbWVzc2FnZUlkOiBwcm9ibGVtLFxuICAgIG5vZGU6IHNvdXJjZUNvZGUuYXN0LFxuICB9O1xufVxuXG4vKipcbiAqIFJlc29sdmUgYSBmaXhlciBmb3IgdGhlIHJlcG9ydCB3aGVuIHJhbmdlcyBhcmUgYXZhaWxhYmxlLlxuICogQHBhcmFtIGNvbnRleHQgSW5wdXQgY29udGV4dCB2YWx1ZS5cbiAqIEByZXR1cm5zIFJldHVybiB2YWx1ZSBvdXRwdXQuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgZml4ZXIgPSBnZXRGaXhlckZvckV4YW1wbGUoe1xuICogICBjb21tZW50OiB7IHR5cGU6IFwiQmxvY2tcIiwgdmFsdWU6IFwiKlwiIH0gYXMgQ29tbWVudCxcbiAqICAgZXhhbXBsZToge1xuICogICAgIGNvbnRlbnQ6IFwiXCIsXG4gKiAgICAgZW5kSW5kZXg6IDAsXG4gKiAgICAgZW5kT2Zmc2V0OiAwLFxuICogICAgIGxpbmVJbmRleDogMCxcbiAqICAgICBwcmVmaXg6IFwiICogXCIsXG4gKiAgICAgc3RhcnRPZmZzZXQ6IDAsXG4gKiAgIH0sXG4gKiAgIGhhc090aGVyRXhhbXBsZXM6IGZhbHNlLFxuICogICBwcm9ibGVtOiBcIm1pc3NpbmdMYW5ndWFnZVwiLFxuICogICBzb3VyY2VDb2RlOiB7fSBhcyBSdWxlLlNvdXJjZUNvZGUsXG4gKiB9KTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBnZXRGaXhlckZvckV4YW1wbGUoXG4gIGNvbnRleHQ6IEZpeGVyTG9va3VwQ29udGV4dCxcbik6ICgoZml4ZXI6IFJ1bGUuUnVsZUZpeGVyKSA9PiBSdWxlLkZpeCB8IHVuZGVmaW5lZCkgfCB1bmRlZmluZWQge1xuICBjb25zdCB7IGNvbW1lbnQsIGV4YW1wbGUsIGhhc090aGVyRXhhbXBsZXMsIHByb2JsZW0sIHNvdXJjZUNvZGUgfSA9IGNvbnRleHQ7XG4gIGNvbnN0IGNvbW1lbnRPZmZzZXQgPSBjb21tZW50LnJhbmdlPy5bMF07XG4gIGNvbnN0IGNvbW1lbnRWYWx1ZU9mZnNldCA9XG4gICAgdHlwZW9mIGNvbW1lbnRPZmZzZXQgPT09IFwibnVtYmVyXCIgPyBjb21tZW50T2Zmc2V0ICsgMiA6IHZvaWQgMDtcbiAgY29uc3QgYWJzb2x1dGVTdGFydCA9XG4gICAgdHlwZW9mIGNvbW1lbnRWYWx1ZU9mZnNldCA9PT0gXCJudW1iZXJcIlxuICAgICAgPyBjb21tZW50VmFsdWVPZmZzZXQgKyBleGFtcGxlLnN0YXJ0T2Zmc2V0XG4gICAgICA6IHZvaWQgMDtcbiAgY29uc3QgYWJzb2x1dGVFbmQgPVxuICAgIHR5cGVvZiBjb21tZW50VmFsdWVPZmZzZXQgPT09IFwibnVtYmVyXCJcbiAgICAgID8gY29tbWVudFZhbHVlT2Zmc2V0ICsgZXhhbXBsZS5lbmRPZmZzZXRcbiAgICAgIDogdm9pZCAwO1xuXG4gIGlmICh0eXBlb2YgYWJzb2x1dGVTdGFydCAhPT0gXCJudW1iZXJcIiB8fCB0eXBlb2YgYWJzb2x1dGVFbmQgIT09IFwibnVtYmVyXCIpIHtcbiAgICByZXR1cm4gdm9pZCAwO1xuICB9XG5cbiAgcmV0dXJuIGNyZWF0ZUZpeGVyKHtcbiAgICBhYnNvbHV0ZUVuZCxcbiAgICBhYnNvbHV0ZVN0YXJ0LFxuICAgIGV4YW1wbGUsXG4gICAgaGFzT3RoZXJFeGFtcGxlcyxcbiAgICBwcm9ibGVtLFxuICAgIHNvdXJjZVRleHQ6IHNvdXJjZUNvZGUudGV4dCxcbiAgfSk7XG59XG5cbi8qKlxuICogUmVzb2x2ZSB0aGUgcmVwb3J0IGxvY2F0aW9uIGZvciBhIG1hdGNoZWQgZXhhbXBsZS5cbiAqIEBwYXJhbSBjb21tZW50IENvbW1lbnQgbm9kZSBjb250YWluaW5nIHRoZSBleGFtcGxlLlxuICogQHBhcmFtIGV4YW1wbGUgRXhhbXBsZSBtZXRhZGF0YS5cbiAqIEByZXR1cm5zIFJlcG9ydCBsb2NhdGlvbiB3aGVuIGF2YWlsYWJsZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBsb2MgPSBnZXRSZXBvcnRMb2NhdGlvbih7fSBhcyBDb21tZW50LCB7XG4gKiAgICBjb250ZW50OiBcIlwiLFxuICogICAgZW5kSW5kZXg6IDAsXG4gKiAgICBlbmRPZmZzZXQ6IDAsXG4gKiAgICBsaW5lSW5kZXg6IDAsXG4gKiAgICBwcmVmaXg6IFwiXCIsXG4gKiAgICBzdGFydE9mZnNldDogMCxcbiAqIH0pO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIGdldFJlcG9ydExvY2F0aW9uKFxuICBjb21tZW50OiBDb21tZW50LFxuICBleGFtcGxlOiBFeGFtcGxlLFxuKTogUmVwb3J0TG9jYXRpb24gfCB1bmRlZmluZWQge1xuICBjb25zdCBsaW5lID1cbiAgICB0eXBlb2YgY29tbWVudC5sb2M/LnN0YXJ0LmxpbmUgPT09IFwibnVtYmVyXCJcbiAgICAgID8gY29tbWVudC5sb2Muc3RhcnQubGluZSArIGV4YW1wbGUubGluZUluZGV4XG4gICAgICA6IHZvaWQgMDtcblxuICBpZiAobGluZSA9PT0gdm9pZCAwKSB7XG4gICAgcmV0dXJuIHZvaWQgMDtcbiAgfVxuXG4gIHJldHVybiB7XG4gICAgZW5kOiB7IGNvbHVtbjogMSwgbGluZSB9LFxuICAgIHN0YXJ0OiB7IGNvbHVtbjogMCwgbGluZSB9LFxuICB9O1xufVxuXG4vKipcbiAqIFJlcG9ydHMgYSBzaW5nbGUgZXhhbXBsZSB3aGVuIGl0IHZpb2xhdGVzIHRoZSBydWxlLlxuICogQHBhcmFtIGNvbnRleHQgUmVwb3J0IGRldGFpbHMgZm9yIHRoaXMgZXhhbXBsZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiByZXBvcnRFeGFtcGxlKGNvbnRleHQpO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIHJlcG9ydEV4YW1wbGUoY29udGV4dDogUmVwb3J0RXhhbXBsZUNvbnRleHQpOiB2b2lkIHtcbiAgY29uc3QgeyBjb21tZW50LCBjb250ZXh0OiBydWxlQ29udGV4dCwgZXhhbXBsZSwgaGFzT3RoZXJFeGFtcGxlcyB9ID0gY29udGV4dDtcbiAgY29uc3QgcHJvYmxlbSA9IGNoZWNrRXhhbXBsZUNvbnRlbnQoZXhhbXBsZS5jb250ZW50KTtcblxuICBpZiAocHJvYmxlbSA9PT0gdm9pZCAwKSB7XG4gICAgcmV0dXJuO1xuICB9XG5cbiAgY29uc3QgZGVzY3JpcHRvciA9IGJ1aWxkUmVwb3J0RGVzY3JpcHRvcih7XG4gICAgY29tbWVudCxcbiAgICBleGFtcGxlLFxuICAgIGhhc090aGVyRXhhbXBsZXMsXG4gICAgcHJvYmxlbSxcbiAgICBzb3VyY2VDb2RlOiBydWxlQ29udGV4dC5zb3VyY2VDb2RlLFxuICB9KTtcblxuICBydWxlQ29udGV4dC5yZXBvcnQoZGVzY3JpcHRvcik7XG59XG5cbmV4cG9ydCB7IGJ1aWxkUmVwb3J0RGVzY3JpcHRvciwgcmVwb3J0RXhhbXBsZSB9O1xuIl19

package/dist/domain/docs/require-example-language/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/require-example-language/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAKnC;;GAEG;AACH,QAAA,MAAM,0BAA0B,EAAE,IAAI,CAAC,UAoCtC,CAAC;AAEF,OAAO,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/domain/docs/require-example-language/rule.js

@@ -0,0 +1,37 @@
+import { getExamples } from "./examples.js";
+import { reportExample } from "./reporting.js";
+/**
+ * ESLint rule requiring \@example tags to use fenced code blocks with a language.
+ */
+const requireExampleLanguageRule = {
+    create(context) {
+        const { sourceCode } = context;
+        for (const comment of sourceCode.getAllComments()) {
+            if (comment.type === "Block" && comment.value.startsWith("*")) {
+                const examples = getExamples(comment.value);
+                const hasOtherExamples = examples.length > 1;
+                for (const example of examples) {
+                    reportExample({ comment, context, example, hasOtherExamples });
+                }
+            }
+        }
+        return {};
+    },
+    meta: {
+        docs: {
+            description: "Require @example tags to use fenced code blocks with a language.",
+            recommended: false,
+            url: "https://github.com/parloti/eslint-plugin/blob/main/docs/rules/require-example-language.md",
+        },
+        fixable: "code",
+        messages: {
+            emptyExample: "@example must include example content.",
+            missingFence: "@example must include a fenced code block with a language (e.g. ```typescript).",
+            missingLanguage: "@example fenced code blocks must specify a language (e.g. ```typescript).",
+        },
+        schema: [],
+        type: "problem",
+    },
+};
+export { requireExampleLanguageRule };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9kb21haW4vZG9jcy9yZXF1aXJlLWV4YW1wbGUtbGFuZ3VhZ2UvcnVsZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ3pDLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFNUM7O0dBRUc7QUFDSCxNQUFNLDBCQUEwQixHQUFvQjtJQUNsRCxNQUFNLENBQUMsT0FBeUI7UUFDOUIsTUFBTSxFQUFFLFVBQVUsRUFBRSxHQUFHLE9BQU8sQ0FBQztRQUUvQixLQUFLLE1BQU0sT0FBTyxJQUFJLFVBQVUsQ0FBQyxjQUFjLEVBQUUsRUFBRSxDQUFDO1lBQ2xELElBQUksT0FBTyxDQUFDLElBQUksS0FBSyxPQUFPLElBQUksT0FBTyxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztnQkFDOUQsTUFBTSxRQUFRLEdBQUcsV0FBVyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQztnQkFFNUMsTUFBTSxnQkFBZ0IsR0FBRyxRQUFRLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQztnQkFFN0MsS0FBSyxNQUFNLE9BQU8sSUFBSSxRQUFRLEVBQUUsQ0FBQztvQkFDL0IsYUFBYSxDQUFDLEVBQUUsT0FBTyxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsQ0FBQyxDQUFDO2dCQUNqRSxDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7UUFFRCxPQUFPLEVBQUUsQ0FBQztJQUNaLENBQUM7SUFDRCxJQUFJLEVBQUU7UUFDSixJQUFJLEVBQUU7WUFDSixXQUFXLEVBQ1Qsa0VBQWtFO1lBQ3BFLFdBQVcsRUFBRSxLQUFLO1lBQ2xCLEdBQUcsRUFBRSwyRkFBMkY7U0FDakc7UUFDRCxPQUFPLEVBQUUsTUFBTTtRQUNmLFFBQVEsRUFBRTtZQUNSLFlBQVksRUFBRSx3Q0FBd0M7WUFDdEQsWUFBWSxFQUNWLGlGQUFpRjtZQUNuRixlQUFlLEVBQ2IsMkVBQTJFO1NBQzlFO1FBQ0QsTUFBTSxFQUFFLEVBQUU7UUFDVixJQUFJLEVBQUUsU0FBUztLQUNoQjtDQUNGLENBQUM7QUFFRixPQUFPLEVBQUUsMEJBQTBCLEVBQUUsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgUnVsZSB9IGZyb20gXCJlc2xpbnRcIjtcblxuaW1wb3J0IHsgZ2V0RXhhbXBsZXMgfSBmcm9tIFwiLi9leGFtcGxlc1wiO1xuaW1wb3J0IHsgcmVwb3J0RXhhbXBsZSB9IGZyb20gXCIuL3JlcG9ydGluZ1wiO1xuXG4vKipcbiAqIEVTTGludCBydWxlIHJlcXVpcmluZyBcXEBleGFtcGxlIHRhZ3MgdG8gdXNlIGZlbmNlZCBjb2RlIGJsb2NrcyB3aXRoIGEgbGFuZ3VhZ2UuXG4gKi9cbmNvbnN0IHJlcXVpcmVFeGFtcGxlTGFuZ3VhZ2VSdWxlOiBSdWxlLlJ1bGVNb2R1bGUgPSB7XG4gIGNyZWF0ZShjb250ZXh0OiBSdWxlLlJ1bGVDb250ZXh0KTogUnVsZS5SdWxlTGlzdGVuZXIge1xuICAgIGNvbnN0IHsgc291cmNlQ29kZSB9ID0gY29udGV4dDtcblxuICAgIGZvciAoY29uc3QgY29tbWVudCBvZiBzb3VyY2VDb2RlLmdldEFsbENvbW1lbnRzKCkpIHtcbiAgICAgIGlmIChjb21tZW50LnR5cGUgPT09IFwiQmxvY2tcIiAmJiBjb21tZW50LnZhbHVlLnN0YXJ0c1dpdGgoXCIqXCIpKSB7XG4gICAgICAgIGNvbnN0IGV4YW1wbGVzID0gZ2V0RXhhbXBsZXMoY29tbWVudC52YWx1ZSk7XG5cbiAgICAgICAgY29uc3QgaGFzT3RoZXJFeGFtcGxlcyA9IGV4YW1wbGVzLmxlbmd0aCA+IDE7XG5cbiAgICAgICAgZm9yIChjb25zdCBleGFtcGxlIG9mIGV4YW1wbGVzKSB7XG4gICAgICAgICAgcmVwb3J0RXhhbXBsZSh7IGNvbW1lbnQsIGNvbnRleHQsIGV4YW1wbGUsIGhhc090aGVyRXhhbXBsZXMgfSk7XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4ge307XG4gIH0sXG4gIG1ldGE6IHtcbiAgICBkb2NzOiB7XG4gICAgICBkZXNjcmlwdGlvbjpcbiAgICAgICAgXCJSZXF1aXJlIEBleGFtcGxlIHRhZ3MgdG8gdXNlIGZlbmNlZCBjb2RlIGJsb2NrcyB3aXRoIGEgbGFuZ3VhZ2UuXCIsXG4gICAgICByZWNvbW1lbmRlZDogZmFsc2UsXG4gICAgICB1cmw6IFwiaHR0cHM6Ly9naXRodWIuY29tL3BhcmxvdGkvZXNsaW50LXBsdWdpbi9ibG9iL21haW4vZG9jcy9ydWxlcy9yZXF1aXJlLWV4YW1wbGUtbGFuZ3VhZ2UubWRcIixcbiAgICB9LFxuICAgIGZpeGFibGU6IFwiY29kZVwiLFxuICAgIG1lc3NhZ2VzOiB7XG4gICAgICBlbXB0eUV4YW1wbGU6IFwiQGV4YW1wbGUgbXVzdCBpbmNsdWRlIGV4YW1wbGUgY29udGVudC5cIixcbiAgICAgIG1pc3NpbmdGZW5jZTpcbiAgICAgICAgXCJAZXhhbXBsZSBtdXN0IGluY2x1ZGUgYSBmZW5jZWQgY29kZSBibG9jayB3aXRoIGEgbGFuZ3VhZ2UgKGUuZy4gYGBgdHlwZXNjcmlwdCkuXCIsXG4gICAgICBtaXNzaW5nTGFuZ3VhZ2U6XG4gICAgICAgIFwiQGV4YW1wbGUgZmVuY2VkIGNvZGUgYmxvY2tzIG11c3Qgc3BlY2lmeSBhIGxhbmd1YWdlIChlLmcuIGBgYHR5cGVzY3JpcHQpLlwiLFxuICAgIH0sXG4gICAgc2NoZW1hOiBbXSxcbiAgICB0eXBlOiBcInByb2JsZW1cIixcbiAgfSxcbn07XG5cbmV4cG9ydCB7IHJlcXVpcmVFeGFtcGxlTGFuZ3VhZ2VSdWxlIH07XG4iXX0=

package/dist/domain/docs/require-example-language/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/require-example-language/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,qCAAqC;AACrC,KAAK,OAAO,GAAG,UAAU,CACvB,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,gBAAgB,CAAC,CACjD,CAAC,MAAM,CAAC,CAAC;AAEV,qCAAqC;AACrC,UAAU,OAAO;IACf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IAEf,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qCAAqC;AACrC,KAAK,OAAO,GAAG,cAAc,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAEnE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/domain/docs/require-example-language/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvZG9tYWluL2RvY3MvcmVxdWlyZS1leGFtcGxlLWxhbmd1YWdlL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IFJ1bGUgfSBmcm9tIFwiZXNsaW50XCI7XG5cbi8qKiBUeXBlIGRlZmluaXRpb24gZm9yIHJ1bGUgZGF0YS4gKi9cbnR5cGUgQ29tbWVudCA9IFJldHVyblR5cGU8XG4gIFJ1bGUuUnVsZUNvbnRleHRbXCJzb3VyY2VDb2RlXCJdW1wiZ2V0QWxsQ29tbWVudHNcIl1cbj5bbnVtYmVyXTtcblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEV4YW1wbGUge1xuICAvKiogQ29udGVudCBmaWVsZCB2YWx1ZS4gKi9cbiAgY29udGVudDogc3RyaW5nO1xuXG4gIC8qKiBFbmRJbmRleCBmaWVsZCB2YWx1ZS4gKi9cbiAgZW5kSW5kZXg6IG51bWJlcjtcblxuICAvKiogRW5kT2Zmc2V0IGZpZWxkIHZhbHVlLiAqL1xuICBlbmRPZmZzZXQ6IG51bWJlcjtcblxuICAvKiogTGluZUluZGV4IGZpZWxkIHZhbHVlLiAqL1xuICBsaW5lSW5kZXg6IG51bWJlcjtcblxuICAvKiogUHJlZml4IGZpZWxkIHZhbHVlLiAqL1xuICBwcmVmaXg6IHN0cmluZztcblxuICAvKiogU3RhcnRPZmZzZXQgZmllbGQgdmFsdWUuICovXG4gIHN0YXJ0T2Zmc2V0OiBudW1iZXI7XG59XG5cbi8qKiBUeXBlIGRlZmluaXRpb24gZm9yIHJ1bGUgZGF0YS4gKi9cbnR5cGUgUHJvYmxlbSA9IFwiZW1wdHlFeGFtcGxlXCIgfCBcIm1pc3NpbmdGZW5jZVwiIHwgXCJtaXNzaW5nTGFuZ3VhZ2VcIjtcblxuZXhwb3J0IHR5cGUgeyBDb21tZW50LCBFeGFtcGxlLCBQcm9ibGVtIH07XG4iXX0=

package/dist/domain/docs/single-line-jsdoc/index.d.ts

@@ -0,0 +1,2 @@
+export { singleLineJsdocRule } from "./rule.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/docs/single-line-jsdoc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/single-line-jsdoc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/domain/docs/single-line-jsdoc/index.js

@@ -0,0 +1,2 @@
+export { singleLineJsdocRule } from "./rule.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvZG9tYWluL2RvY3Mvc2luZ2xlLWxpbmUtanNkb2MvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sUUFBUSxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IHsgc2luZ2xlTGluZUpzZG9jUnVsZSB9IGZyb20gXCIuL3J1bGVcIjtcbiJdfQ==

package/dist/domain/docs/single-line-jsdoc/rule.d.ts

@@ -0,0 +1,4 @@
+import type { Rule } from "eslint";
+/** Rule module enforcing single-line JSDoc when it fits. */
+export declare const singleLineJsdocRule: Rule.RuleModule;
+//# sourceMappingURL=rule.d.ts.map

package/dist/domain/docs/single-line-jsdoc/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/single-line-jsdoc/rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAiQnC,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,EAAE,IAAI,CAAC,UAyCtC,CAAC"}

package/dist/domain/docs/single-line-jsdoc/rule.edge-cases.d.ts

@@ -0,0 +1,4 @@
+/** Companion module for single-line-jsdoc edge-case tests. */
+declare const singleLineJsdocRuleEdgeCases: import("eslint").Rule.RuleModule;
+export { singleLineJsdocRuleEdgeCases };
+//# sourceMappingURL=rule.edge-cases.d.ts.map

package/dist/domain/docs/single-line-jsdoc/rule.edge-cases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.edge-cases.d.ts","sourceRoot":"","sources":["../../../../src/domain/docs/single-line-jsdoc/rule.edge-cases.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,QAAA,MAAM,4BAA4B,kCAAsB,CAAC;AAEzD,OAAO,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/domain/docs/single-line-jsdoc/rule.edge-cases.js

@@ -0,0 +1,5 @@
+import { singleLineJsdocRule } from "./rule.js";
+/** Companion module for single-line-jsdoc edge-case tests. */
+const singleLineJsdocRuleEdgeCases = singleLineJsdocRule;
+export { singleLineJsdocRuleEdgeCases };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVsZS5lZGdlLWNhc2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2RvbWFpbi9kb2NzL3NpbmdsZS1saW5lLWpzZG9jL3J1bGUuZWRnZS1jYXNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFFN0MsOERBQThEO0FBQzlELE1BQU0sNEJBQTRCLEdBQUcsbUJBQW1CLENBQUM7QUFFekQsT0FBTyxFQUFFLDRCQUE0QixFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBzaW5nbGVMaW5lSnNkb2NSdWxlIH0gZnJvbSBcIi4vcnVsZVwiO1xyXG5cclxuLyoqIENvbXBhbmlvbiBtb2R1bGUgZm9yIHNpbmdsZS1saW5lLWpzZG9jIGVkZ2UtY2FzZSB0ZXN0cy4gKi9cclxuY29uc3Qgc2luZ2xlTGluZUpzZG9jUnVsZUVkZ2VDYXNlcyA9IHNpbmdsZUxpbmVKc2RvY1J1bGU7XHJcblxyXG5leHBvcnQgeyBzaW5nbGVMaW5lSnNkb2NSdWxlRWRnZUNhc2VzIH07XHJcbiJdfQ==