@codeperfect/eslint-plugin 1.0.0

package/dist/docs/require-example-language/empty-fence-fixes.js

@@ -0,0 +1,169 @@
+/**
+ * Closes a fence and updates the state.
+ * @param state Current fence state.
+ * @param line Fence line being processed.
+ * @returns Updated fence state.
+ * @example
+ * ```typescript
+ * const next = closeFence(state, " * ```");
+ * ```
+ */
+function closeFence(state, line) {
+    const fenceLines = [...state.currentFence, line];
+    const shouldRemove = !state.hasFenceContent;
+    const hasNonEmptyFence = state.hasNonEmptyFence || state.hasFenceContent;
+    const output = shouldRemove ? state.output : [...state.output, ...fenceLines];
+    return {
+        ...state,
+        currentFence: [],
+        hasFenceContent: false,
+        hasNonEmptyFence,
+        inFence: false,
+        output,
+        removed: state.removed || shouldRemove,
+    };
+}
+/**
+ * Finalizes fence output, including any unclosed fences.
+ * @param state Current fence state.
+ * @returns Finalized fence state.
+ * @example
+ * ```typescript
+ * const next = finalizeFenceState(state);
+ * ```
+ */
+function finalizeFenceState(state) {
+    if (state.inFence) {
+        return {
+            ...state,
+            currentFence: [],
+            hasFenceContent: false,
+            hasNonEmptyFence: state.hasNonEmptyFence || state.hasFenceContent,
+            inFence: false,
+            output: [...state.output, ...state.currentFence],
+        };
+    }
+    return state;
+}
+/**
+ * Determines whether a line contains non-empty content.
+ * @param line Line text to check.
+ * @returns True when the line contains content.
+ * @example
+ * ```typescript
+ * const ok = isContentLine(" * const ok = true;");
+ * ```
+ */
+function isContentLine(line) {
+    const trimmed = line.replace(/^\s*\*?\s?/u, "").trim();
+    return trimmed.length > 0;
+}
+/**
+ * Opens a new fenced block.
+ * @param state Current fence state.
+ * @param line Fence line being processed.
+ * @returns Updated fence state.
+ * @example
+ * ```typescript
+ * const next = openFence(state, " * ```typescript");
+ * ```
+ */
+function openFence(state, line) {
+    return {
+        ...state,
+        currentFence: [line],
+        hasFenceContent: false,
+        hasNonEmptyFence: state.hasNonEmptyFence,
+        inFence: true,
+    };
+}
+/**
+ * Parses a fence line for its leading prefix and language.
+ * @param line Fence line to parse.
+ * @returns Parsed fence info when matched.
+ * @example
+ * ```typescript
+ * const info = parseFenceLine(" * ```typescript");
+ * ```
+ */
+function parseFenceLine(line) {
+    const fenceMatch = /^(?<leading>\s*\*?\s*)```(?<lang>[^\s`]+)?[ \t]*$/u.exec(line);
+    if (fenceMatch === null) {
+        return void 0;
+    }
+    const groups = fenceMatch.groups ?? {};
+    const leading = typeof groups["leading"] === "string" ? groups["leading"] : "";
+    const language = typeof groups["lang"] === "string" ? groups["lang"] : "";
+    return { language, leading };
+}
+/**
+ * Removes fenced blocks that contain no content.
+ * @param original Original comment text.
+ * @returns Updated comment text when a fence is removed.
+ * @example
+ * ```typescript
+ * const updated = removeEmptyFences("* ```typescript\n* ```\n* ok");
+ * ```
+ */
+function removeEmptyFences(original) {
+    const lineBreak = original.includes("\r\n") ? "\r\n" : "\n";
+    const lines = original.split(/\r?\n/u);
+    const initialState = {
+        currentFence: [],
+        hasFenceContent: false,
+        hasNonEmptyFence: false,
+        inFence: false,
+        output: [],
+        removed: false,
+    };
+    let state = initialState;
+    for (const line of lines) {
+        const fenceInfo = parseFenceLine(line);
+        state =
+            fenceInfo === void 0
+                ? updateContentState(state, line)
+                : updateFenceState(state, line);
+    }
+    const finalState = finalizeFenceState(state);
+    return finalState.removed && finalState.hasNonEmptyFence
+        ? finalState.output.join(lineBreak)
+        : void 0;
+}
+/**
+ * Updates the state with a non-fence line.
+ * @param state Current fence state.
+ * @param line Line being processed.
+ * @returns Updated fence state.
+ * @example
+ * ```typescript
+ * const next = updateContentState(state, " * const ok = true;");
+ * ```
+ */
+function updateContentState(state, line) {
+    if (state.inFence) {
+        return {
+            ...state,
+            currentFence: [...state.currentFence, line],
+            hasFenceContent: state.hasFenceContent || isContentLine(line),
+        };
+    }
+    return { ...state, output: [...state.output, line] };
+}
+/**
+ * Opens or closes a fence based on the current state.
+ * @param state Current fence state.
+ * @param line Fence line being processed.
+ * @returns Updated fence state.
+ * @example
+ * ```typescript
+ * const next = updateFenceState(state, " * ```");
+ * ```
+ */
+function updateFenceState(state, line) {
+    if (state.inFence) {
+        return closeFence(state, line);
+    }
+    return openFence(state, line);
+}
+export { parseFenceLine, removeEmptyFences };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW1wdHktZmVuY2UtZml4ZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZG9jcy9yZXF1aXJlLWV4YW1wbGUtbGFuZ3VhZ2UvZW1wdHktZmVuY2UtZml4ZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBOEJBOzs7Ozs7Ozs7R0FTRztBQUNILFNBQVMsVUFBVSxDQUFDLEtBQXNCLEVBQUUsSUFBWTtJQUN0RCxNQUFNLFVBQVUsR0FBRyxDQUFDLEdBQUcsS0FBSyxDQUFDLFlBQVksRUFBRSxJQUFJLENBQUMsQ0FBQztJQUNqRCxNQUFNLFlBQVksR0FBRyxDQUFDLEtBQUssQ0FBQyxlQUFlLENBQUM7SUFDNUMsTUFBTSxnQkFBZ0IsR0FBRyxLQUFLLENBQUMsZ0JBQWdCLElBQUksS0FBSyxDQUFDLGVBQWUsQ0FBQztJQUN6RSxNQUFNLE1BQU0sR0FBRyxZQUFZLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLEdBQUcsVUFBVSxDQUFDLENBQUM7SUFFOUUsT0FBTztRQUNMLEdBQUcsS0FBSztRQUNSLFlBQVksRUFBRSxFQUFFO1FBQ2hCLGVBQWUsRUFBRSxLQUFLO1FBQ3RCLGdCQUFnQjtRQUNoQixPQUFPLEVBQUUsS0FBSztRQUNkLE1BQU07UUFDTixPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU8sSUFBSSxZQUFZO0tBQ3ZDLENBQUM7QUFDSixDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFTLGtCQUFrQixDQUFDLEtBQXNCO0lBQ2hELElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ2xCLE9BQU87WUFDTCxHQUFHLEtBQUs7WUFDUixZQUFZLEVBQUUsRUFBRTtZQUNoQixlQUFlLEVBQUUsS0FBSztZQUN0QixnQkFBZ0IsRUFBRSxLQUFLLENBQUMsZ0JBQWdCLElBQUksS0FBSyxDQUFDLGVBQWU7WUFDakUsT0FBTyxF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QUMsQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUNiLENBQUM7QUFFRDs7Ozs7Ozs7O0dBU0c7QUFDSCxTQUFTLGtCQUFrQixDQUN6QixLQUFzQixFQUN0QixJQUFZO0lBRVosSUFBSSxLQUFLLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDbEIsT0FBTztZQUNMLEdBQUcsS0FBSztZQUNSLFlBQVksRUFBRSxDQUFDLEdBQUcsS0FBSyxDQUFDLFlBQVksRUFBRSxJQUFJLENBQUM7WUFDM0MsZUFBZSxFQUFFLEtBQUssQ0FBQyxlQUFlLElBQUksYUFBYSxDQUFDLElBQUksQ0FBQztTQUM5RCxDQUFDO0lBQ0osQ0FBQztJQUVELE9BQU8sRUFBRSxHQUFHLEtBQUssRUFBRSxNQUFNLEVBQUUsQ0FBQyxHQUFHLEtBQUssQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLEVBQUUsQ0FBQztBQUN2RCxDQUFDO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBUyxnQkFBZ0IsQ0FDdkIsS0FBc0IsRUFDdEIsSUFBWTtJQUVaLElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ2xCLE9BQU8sVUFBVSxDQUFDLEtBQUssRUFBRSxJQUFJLENBQUMsQ0FBQztJQUNqQyxDQUFDO0lBRUQsT0FBTyxTQUFTLENBQUMsS0FBSyxFQUFFLElBQUksQ0FBQyxDQUFDO0FBQ2hDLENBQUM7QUFFRCxPQUFPLEVBQUUsY0FBYyxFQUFFLGlCQUFpQixFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKiogVHlwZSBkZWZpbml0aW9uIGZvciBydWxlIGRhdGEuICovXG5pbnRlcmZhY2UgRW1wdHlGZW5jZVN0YXRlIHtcbiAgLyoqIEN1cnJlbnRGZW5jZSBmaWVsZCB2YWx1ZS4gKi9cbiAgY3VycmVudEZlbmNlOiBzdHJpbmdbXTtcblxuICAvKiogSGFzRmVuY2VDb250ZW50IGZpZWxkIHZhbHVlLiAqL1xuICBoYXNGZW5jZUNvbnRlbnQ6IGJvb2xlYW47XG5cbiAgLyoqIEhhc05vbkVtcHR5RmVuY2UgZmllbGQgdmFsdWUuICovXG4gIGhhc05vbkVtcHR5RmVuY2U6IGJvb2xlYW47XG5cbiAgLyoqIEluRmVuY2UgZmllbGQgdmFsdWUuICovXG4gIGluRmVuY2U6IGJvb2xlYW47XG5cbiAgLyoqIE91dHB1dCBmaWVsZCB2YWx1ZS4gKi9cbiAgb3V0cHV0OiBzdHJpbmdbXTtcblxuICAvKiogUmVtb3ZlZCBmaWVsZCB2YWx1ZS4gKi9cbiAgcmVtb3ZlZDogYm9vbGVhbjtcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEZlbmNlTGluZUluZm8ge1xuICAvKiogTGFuZ3VhZ2UgZmllbGQgdmFsdWUuICovXG4gIGxhbmd1YWdlOiBzdHJpbmc7XG5cbiAgLyoqIExlYWRpbmcgZmllbGQgdmFsdWUuICovXG4gIGxlYWRpbmc6IHN0cmluZztcbn1cblxuLyoqXG4gKiBDbG9zZXMgYSBmZW5jZSBhbmQgdXBkYXRlcyB0aGUgc3RhdGUuXG4gKiBAcGFyYW0gc3RhdGUgQ3VycmVudCBmZW5jZSBzdGF0ZS5cbiAqIEBwYXJhbSBsaW5lIEZlbmNlIGxpbmUgYmVpbmcgcHJvY2Vzc2VkLlxuICogQHJldHVybnMgVXBkYXRlZCBmZW5jZSBzdGF0ZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBuZXh0ID0gY2xvc2VGZW5jZShzdGF0ZSwgXCIgKiBgYGBcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gY2xvc2VGZW5jZShzdGF0ZTogRW1wdHlGZW5jZVN0YXRlLCBsaW5lOiBzdHJpbmcpOiBFbXB0eUZlbmNlU3RhdGUge1xuICBjb25zdCBmZW5jZUxpbmVzID0gWy4uLnN0YXRlLmN1cnJlbnRGZW5jZSwgbGluZV07XG4gIGNvbnN0IHNob3VsZFJlbW92ZSA9ICFzdGF0ZS5oYXNGZW5jZUNvbnRlbnQ7XG4gIGNvbnN0IGhhc05vbkVtcHR5RmVuY2UgPSBzdGF0ZS5oYXNOb25FbXB0eUZlbmNlIHx8IHN0YXRlLmhhc0ZlbmNlQ29udGVudDtcbiAgY29uc3Qgb3V0cHV0ID0gc2hvdWxkUmVtb3ZlID8gc3RhdGUub3V0cHV0IDogWy4uLnN0YXRlLm91dHB1dCwgLi4uZmVuY2VMaW5lc107XG5cbiAgcmV0dXJuIHtcbiAgICAuLi5zdGF0ZSxcbiAgICBjdXJyZW50RmVuY2U6IFtdLFxuICAgIGhhc0ZlbmNlQ29udGVudDogZmFsc2UsXG4gICAgaGFzTm9uRW1wdHlGZW5jZSxcbiAgICBpbkZlbmNlOiBmYWxzZSxcbiAgICBvdXRwdXQsXG4gICAgcmVtb3ZlZDogc3RhdGUucmVtb3ZlZCB8fCBzaG91bGRSZW1vdmUsXG4gIH07XG59XG5cbi8qKlxuICogRmluYWxpemVzIGZlbmNlIG91dHB1dCwgaW5jbHVkaW5nIGFueSB1bmNsb3NlZCBmZW5jZXMuXG4gKiBAcGFyYW0gc3RhdGUgQ3VycmVudCBmZW5jZSBzdGF0ZS5cbiAqIEByZXR1cm5zIEZpbmFsaXplZCBmZW5jZSBzdGF0ZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBuZXh0ID0gZmluYWxpemVGZW5jZVN0YXRlKHN0YXRlKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBmaW5hbGl6ZUZlbmNlU3RhdGUoc3RhdGU6IEVtcHR5RmVuY2VTdGF0ZSk6IEVtcHR5RmVuY2VTdGF0ZSB7XG4gIGlmIChzdGF0ZS5pbkZlbmNlKSB7XG4gICAgcmV0dXJuIHtcbiAgICAgIC4uLnN0YXRlLFxuICAgICAgY3VycmVudEZlbmNlOiBbXSxcbiAgICAgIGhhc0ZlbmNlQ29udGVudDogZmFsc2UsXG4gICAgICBoYXNOb25FbXB0eUZlbmNlOiBzdGF0ZS5oYXNOb25FbXB0eUZlbmNlIHx8IHN0YXRlLmhhc0ZlbmNlQ29udGVudCxcbiAgICAgIGluRmVuY2U6IGZhbHNlLFxuICAgICAgb3V0cHV0OiBbLi4uc3RhdGUub3V0cHV0LCAuLi5zdGF0ZS5jdXJyZW50RmVuY2VdLFxuICAgIH07XG4gIH1cblxuICByZXR1cm4gc3RhdGU7XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGV0aGVyIGEgbGluZSBjb250YWlucyBub24tZW1wdHkgY29udGVudC5cbiAqIEBwYXJhbSBsaW5lIExpbmUgdGV4dCB0byBjaGVjay5cbiAqIEByZXR1cm5zIFRydWUgd2hlbiB0aGUgbGluZSBjb250YWlucyBjb250ZW50LlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IG9rID0gaXNDb250ZW50TGluZShcIiAqIGNvbnN0IG9rID0gdHJ1ZTtcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gaXNDb250ZW50TGluZShsaW5lOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgY29uc3QgdHJpbW1lZCA9IGxpbmUucmVwbGFjZSgvXlxccypcXCo/XFxzPy91LCBcIlwiKS50cmltKCk7XG4gIHJldHVybiB0cmltbWVkLmxlbmd0aCA+IDA7XG59XG5cbi8qKlxuICogT3BlbnMgYSBuZXcgZmVuY2VkIGJsb2NrLlxuICogQHBhcmFtIHN0YXRlIEN1cnJlbnQgZmVuY2Ugc3RhdGUuXG4gKiBAcGFyYW0gbGluZSBGZW5jZSBsaW5lIGJlaW5nIHByb2Nlc3NlZC5cbiAqIEByZXR1cm5zIFVwZGF0ZWQgZmVuY2Ugc3RhdGUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgbmV4dCA9IG9wZW5GZW5jZShzdGF0ZSwgXCIgKiBgYGB0eXBlc2NyaXB0XCIpO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIG9wZW5GZW5jZShzdGF0ZTogRW1wdHlGZW5jZVN0YXRlLCBsaW5lOiBzdHJpbmcpOiBFbXB0eUZlbmNlU3RhdGUge1xuICByZXR1cm4ge1xuICAgIC4uLnN0YXRlLFxuICAgIGN1cnJlbnRGZW5jZTogW2xpbmVdLFxuICAgIGhhc0ZlbmNlQ29udGVudDogZmFsc2UsXG4gICAgaGFzTm9uRW1wdHlGZW5jZTogc3RhdGUuaGFzTm9uRW1wdHlGZW5jZSxcbiAgICBpbkZlbmNlOiB0cnVlLFxuICB9O1xufVxuXG4vKipcbiAqIFBhcnNlcyBhIGZlbmNlIGxpbmUgZm9yIGl0cyBsZWFkaW5nIHByZWZpeCBhbmQgbGFuZ3VhZ2UuXG4gKiBAcGFyYW0gbGluZSBGZW5jZSBsaW5lIHRvIHBhcnNlLlxuICogQHJldHVybnMgUGFyc2VkIGZlbmNlIGluZm8gd2hlbiBtYXRjaGVkLlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IGluZm8gPSBwYXJzZUZlbmNlTGluZShcIiAqIGBgYHR5cGVzY3JpcHRcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gcGFyc2VGZW5jZUxpbmUobGluZTogc3RyaW5nKTogRmVuY2VMaW5lSW5mbyB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IGZlbmNlTWF0Y2ggPSAvXig/PGxlYWRpbmc+XFxzKlxcKj9cXHMqKWBgYCg/PGxhbmc+W15cXHNgXSspP1sgXFx0XSokL3UuZXhlYyhcbiAgICBsaW5lLFxuICApO1xuXG4gIGlmIChmZW5jZU1hdGNoID09PSBudWxsKSB7XG4gICAgcmV0dXJuIHZvaWQgMDtcbiAgfVxuXG4gIGNvbnN0IGdyb3VwcyA9IGZlbmNlTWF0Y2guZ3JvdXBzID8/IHt9O1xuICBjb25zdCBsZWFkaW5nID1cbiAgICB0eXBlb2YgZ3JvdXBzW1wibGVhZGluZ1wiXSA9PT0gXCJzdHJpbmdcIiA/IGdyb3Vwc1tcImxlYWRpbmdcIl0gOiBcIlwiO1xuICBjb25zdCBsYW5ndWFnZSA9IHR5cGVvZiBncm91cHNbXCJsYW5nXCJdID09PSBcInN0cmluZ1wiID8gZ3JvdXBzW1wibGFuZ1wiXSA6IFwiXCI7XG5cbiAgcmV0dXJuIHsgbGFuZ3VhZ2UsIGxlYWRpbmcgfTtcbn1cblxuLyoqXG4gKiBSZW1vdmVzIGZlbmNlZCBibG9ja3MgdGhhdCBjb250YWluIG5vIGNvbnRlbnQuXG4gKiBAcGFyYW0gb3JpZ2luYWwgT3JpZ2luYWwgY29tbWVudCB0ZXh0LlxuICogQHJldHVybnMgVXBkYXRlZCBjb21tZW50IHRleHQgd2hlbiBhIGZlbmNlIGlzIHJlbW92ZWQuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgdXBkYXRlZCA9IHJlbW92ZUVtcHR5RmVuY2VzKFwiKiBgYGB0eXBlc2NyaXB0XFxuKiBgYGBcXG4qIG9rXCIpO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIHJlbW92ZUVtcHR5RmVuY2VzKG9yaWdpbmFsOiBzdHJpbmcpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBjb25zdCBsaW5lQnJlYWsgPSBvcmlnaW5hbC5pbmNsdWRlcyhcIlxcclxcblwiKSA/IFwiXFxyXFxuXCIgOiBcIlxcblwiO1xuICBjb25zdCBsaW5lcyA9IG9yaWdpbmFsLnNwbGl0KC9cXHI/XFxuL3UpO1xuICBjb25zdCBpbml0aWFsU3RhdGU6IEVtcHR5RmVuY2VTdGF0ZSA9IHtcbiAgICBjdXJyZW50RmVuY2U6IFtdLFxuICAgIGhhc0ZlbmNlQ29udGVudDogZmFsc2UsXG4gICAgaGFzTm9uRW1wdHlGZW5jZTogZmFsc2UsXG4gICAgaW5GZW5jZTogZmFsc2UsXG4gICAgb3V0cHV0OiBbXSxcbiAgICByZW1vdmVkOiBmYWxzZSxcbiAgfTtcbiAgbGV0IHN0YXRlID0gaW5pdGlhbFN0YXRlO1xuXG4gIGZvciAoY29uc3QgbGluZSBvZiBsaW5lcykge1xuICAgIGNvbnN0IGZlbmNlSW5mbyA9IHBhcnNlRmVuY2VMaW5lKGxpbmUpO1xuICAgIHN0YXRlID1cbiAgICAgIGZlbmNlSW5mbyA9PT0gdm9pZCAwXG4gICAgICAgID8gdXBkYXRlQ29udGVudFN0YXRlKHN0YXRlLCBsaW5lKVxuICAgICAgICA6IHVwZGF0ZUZlbmNlU3RhdGUoc3RhdGUsIGxpbmUpO1xuICB9XG5cbiAgY29uc3QgZmluYWxTdGF0ZSA9IGZpbmFsaXplRmVuY2VTdGF0ZShzdGF0ZSk7XG5cbiAgcmV0dXJuIGZpbmFsU3RhdGUucmVtb3ZlZCAmJiBmaW5hbFN0YXRlLmhhc05vbkVtcHR5RmVuY2VcbiAgICA/IGZpbmFsU3RhdGUub3V0cHV0LmpvaW4obGluZUJyZWFrKVxuICAgIDogdm9pZCAwO1xufVxuXG4vKipcbiAqIFVwZGF0ZXMgdGhlIHN0YXRlIHdpdGggYSBub24tZmVuY2UgbGluZS5cbiAqIEBwYXJhbSBzdGF0ZSBDdXJyZW50IGZlbmNlIHN0YXRlLlxuICogQHBhcmFtIGxpbmUgTGluZSBiZWluZyBwcm9jZXNzZWQuXG4gKiBAcmV0dXJucyBVcGRhdGVkIGZlbmNlIHN0YXRlLlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IG5leHQgPSB1cGRhdGVDb250ZW50U3RhdGUoc3RhdGUsIFwiICogY29uc3Qgb2sgPSB0cnVlO1wiKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiB1cGRhdGVDb250ZW50U3RhdGUoXG4gIHN0YXRlOiBFbXB0eUZlbmNlU3RhdGUsXG4gIGxpbmU6IHN0cmluZyxcbik6IEVtcHR5RmVuY2VTdGF0ZSB7XG4gIGlmIChzdGF0ZS5pbkZlbmNlKSB7XG4gICAgcmV0dXJuIHtcbiAgICAgIC4uLnN0YXRlLFxuICAgICAgY3VycmVudEZlbmNlOiBbLi4uc3RhdGUuY3VycmVudEZlbmNlLCBsaW5lXSxcbiAgICAgIGhhc0ZlbmNlQ29udGVudDogc3RhdGUuaGFzRmVuY2VDb250ZW50IHx8IGlzQ29udGVudExpbmUobGluZSksXG4gICAgfTtcbiAgfVxuXG4gIHJldHVybiB7IC4uLnN0YXRlLCBvdXRwdXQ6IFsuLi5zdGF0ZS5vdXRwdXQsIGxpbmVdIH07XG59XG5cbi8qKlxuICogT3BlbnMgb3IgY2xvc2VzIGEgZmVuY2UgYmFzZWQgb24gdGhlIGN1cnJlbnQgc3RhdGUuXG4gKiBAcGFyYW0gc3RhdGUgQ3VycmVudCBmZW5jZSBzdGF0ZS5cbiAqIEBwYXJhbSBsaW5lIEZlbmNlIGxpbmUgYmVpbmcgcHJvY2Vzc2VkLlxuICogQHJldHVybnMgVXBkYXRlZCBmZW5jZSBzdGF0ZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBuZXh0ID0gdXBkYXRlRmVuY2VTdGF0ZShzdGF0ZSwgXCIgKiBgYGBcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gdXBkYXRlRmVuY2VTdGF0ZShcbiAgc3RhdGU6IEVtcHR5RmVuY2VTdGF0ZSxcbiAgbGluZTogc3RyaW5nLFxuKTogRW1wdHlGZW5jZVN0YXRlIHtcbiAgaWYgKHN0YXRlLmluRmVuY2UpIHtcbiAgICByZXR1cm4gY2xvc2VGZW5jZShzdGF0ZSwgbGluZSk7XG4gIH1cblxuICByZXR1cm4gb3BlbkZlbmNlKHN0YXRlLCBsaW5lKTtcbn1cblxuZXhwb3J0IHsgcGFyc2VGZW5jZUxpbmUsIHJlbW92ZUVtcHR5RmVuY2VzIH07XG4iXX0=

package/dist/docs/require-example-language/example-utilities.d.ts

@@ -0,0 +1,70 @@
+/** Type definition for rule data. */
+interface LineMeta {
+    /** EndIndex field value. */
+    endIndex: number;
+    /** EndOffset field value. */
+    endOffset: number;
+    /** LineIndex field value. */
+    lineIndex: number;
+}
+/** Type definition for rule data. */
+interface LineMetaContext {
+    /** CommentValue field value. */
+    commentValue: string;
+    /** Full field value. */
+    full: string;
+    /** StartOffset field value. */
+    startOffset: number;
+}
+/**
+ * Extracts the language from a fence line when present.
+ * @param line Fence line to inspect.
+ * @returns Language tag when present.
+ * @example
+ * ```typescript
+ * const lang = getFenceLanguage(" * ```typescript");
+ * ```
+ */
+declare function getFenceLanguage(line: string): string | undefined;
+/**
+ * Extracts inline example content from the header line.
+ * @param header Example header line.
+ * @returns Inline example content.
+ * @example
+ * ```typescript
+ * const text = getInlineContent("* @example hello");
+ * ```
+ */
+declare function getInlineContent(header: string): string;
+/**
+ * Computes line metadata from the raw comment value.
+ * @param context Comment metadata context.
+ * @returns Line metadata for the example.
+ * @example
+ * ```typescript
+ * const meta = getLineMeta({ commentValue: "* ok", full: "* ok", startOffset: 0 });
+ * ```
+ */
+declare function getLineMeta(context: LineMetaContext): LineMeta;
+/**
+ * Resolves the leading prefix used by example lines.
+ * @param header Example header line.
+ * @returns The leading prefix string.
+ * @example
+ * ```typescript
+ * const prefix = getPrefix(" * @example");
+ * ```
+ */
+declare function getPrefix(header: string): string;
+/**
+ * Determines whether a content line contains non-empty example text.
+ * @param line Line text to check.
+ * @returns True when the line contains content.
+ * @example
+ * ```typescript
+ * const ok = hasLineContent(" * const value = 1;");
+ * ```
+ */
+declare function hasLineContent(line: string): boolean;
+export { getFenceLanguage, getInlineContent, getLineMeta, getPrefix, hasLineContent, };
+//# sourceMappingURL=example-utilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example-utilities.d.ts","sourceRoot":"","sources":["../../../src/docs/require-example-language/example-utilities.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,UAAU,QAAQ;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,UAAU,eAAe;IACvB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU1D;AAED;;;;;;;;GAQG;AACH,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAQvD;AAED;;;;;;;;GAQG;AACH,iBAAS,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQzC;AAED;;;;;;;;GAQG;AACH,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,cAAc,GACf,CAAC"}

package/dist/docs/require-example-language/example-utilities.js

@@ -0,0 +1,76 @@
+/**
+ * Extracts the language from a fence line when present.
+ * @param line Fence line to inspect.
+ * @returns Language tag when present.
+ * @example
+ * ```typescript
+ * const lang = getFenceLanguage(" * ```typescript");
+ * ```
+ */
+function getFenceLanguage(line) {
+    const fenceMatch = /^(?<leading>\s*\*?\s*)```(?<lang>[^\s`]+)?[ \t]*$/u.exec(line);
+    if (fenceMatch === null) {
+        return void 0;
+    }
+    return fenceMatch.groups?.["lang"] ?? "";
+}
+/**
+ * Extracts inline example content from the header line.
+ * @param header Example header line.
+ * @returns Inline example content.
+ * @example
+ * ```typescript
+ * const text = getInlineContent("* @example hello");
+ * ```
+ */
+function getInlineContent(header) {
+    const inlineMatch = /^.*@example\b\s?(?<c>.*)$/u.exec(header);
+    return inlineMatch?.groups?.["c"] ?? "";
+}
+/**
+ * Computes line metadata from the raw comment value.
+ * @param context Comment metadata context.
+ * @returns Line metadata for the example.
+ * @example
+ * ```typescript
+ * const meta = getLineMeta({ commentValue: "* ok", full: "* ok", startOffset: 0 });
+ * ```
+ */
+function getLineMeta(context) {
+    const { commentValue, full, startOffset } = context;
+    const lineIndex = commentValue.slice(0, startOffset).split(/\r?\n/u).length - 1;
+    const endOffset = startOffset + full.length;
+    const endIndex = lineIndex + full.split(/\r?\n/u).length - 1;
+    return { endIndex, endOffset, lineIndex };
+}
+/**
+ * Resolves the leading prefix used by example lines.
+ * @param header Example header line.
+ * @returns The leading prefix string.
+ * @example
+ * ```typescript
+ * const prefix = getPrefix(" * @example");
+ * ```
+ */
+function getPrefix(header) {
+    const prefixMatch = header.indexOf("@example");
+    if (prefixMatch === -1) {
+        return "";
+    }
+    return header.slice(0, prefixMatch);
+}
+/**
+ * Determines whether a content line contains non-empty example text.
+ * @param line Line text to check.
+ * @returns True when the line contains content.
+ * @example
+ * ```typescript
+ * const ok = hasLineContent(" * const value = 1;");
+ * ```
+ */
+function hasLineContent(line) {
+    const trimmed = line.replace(/^\s*\*?\s?/u, "").trim();
+    return trimmed.length > 0;
+}
+export { getFenceLanguage, getInlineContent, getLineMeta, getPrefix, hasLineContent, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhhbXBsZS11dGlsaXRpZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZG9jcy9yZXF1aXJlLWV4YW1wbGUtbGFuZ3VhZ2UvZXhhbXBsZS11dGlsaXRpZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBd0JBOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxnQkFBZ0IsQ0FBQyxJQUFZO0lBQ3BDLE1BQU0sVUFBVSxHQUFHLG9EQUFvRCxDQUFDLElBQUksQ0FDMUUsSUFBSSxDQUNMLENBQUM7SUFFRixJQUFJLFVBQVUsS0FBSyxJQUFJLEVBQUUsQ0FBQztRQUN4QixPQUFPLEtBQUssQ0FBQyxDQUFDO0lBQ2hCLENBQUM7SUFFRCxPQUFPLFVBQVUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUM7QUFDM0MsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxnQkFBZ0IsQ0FBQyxNQUFjO0lBQ3RDLE1BQU0sV0FBVyxHQUFHLDRCQUE0QixDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUU5RCxPQUFPLFdBQVcsRUFBRSxNQUFNLEVBQUUsQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLENBQUM7QUFDMUMsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxXQUFXLENBQUMsT0FBd0I7SUFDM0MsTUFBTSxFQUFFLFlBQVksRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQ3BELE1BQU0sU0FBUyxHQUNiLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDO0lBQ2hFLE1BQU0sU0FBUyxHQUFHLFdBQVcsR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDO0lBQzVDLE1BQU0sUUFBUSxHQUFHLFNBQVMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7SUFFN0QsT0FBTyxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsU0FBUyxFQUFFLENBQUM7QUFDNUMsQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsU0FBUyxTQUFTLENBQUMsTUFBYztJQUMvQixNQUFNLFdBQVcsR0FBRyxNQUFNLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBRS9DLElBQUksV0FBVyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDdkIsT0FBTyxFQUFFLENBQUM7SUFDWixDQUFDO0lBRUQsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxXQUFXLENBQUMsQ0FBQztBQUN0QyxDQUFDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFTLGNBQWMsQ0FBQyxJQUFZO0lBQ2xDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLEVBQUUsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ3ZELE9BQU8sT0FBTyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7QUFDNUIsQ0FBQztBQUVELE9BQU8sRUFDTCxnQkFBZ0IsRUFDaEIsZ0JBQWdCLEVBQ2hCLFdBQVcsRUFDWCxTQUFTLEVBQ1QsY0FBYyxHQUNmLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKiogVHlwZSBkZWZpbml0aW9uIGZvciBydWxlIGRhdGEuICovXG5pbnRlcmZhY2UgTGluZU1ldGEge1xuICAvKiogRW5kSW5kZXggZmllbGQgdmFsdWUuICovXG4gIGVuZEluZGV4OiBudW1iZXI7XG5cbiAgLyoqIEVuZE9mZnNldCBmaWVsZCB2YWx1ZS4gKi9cbiAgZW5kT2Zmc2V0OiBudW1iZXI7XG5cbiAgLyoqIExpbmVJbmRleCBmaWVsZCB2YWx1ZS4gKi9cbiAgbGluZUluZGV4OiBudW1iZXI7XG59XG5cbi8qKiBUeXBlIGRlZmluaXRpb24gZm9yIHJ1bGUgZGF0YS4gKi9cbmludGVyZmFjZSBMaW5lTWV0YUNvbnRleHQge1xuICAvKiogQ29tbWVudFZhbHVlIGZpZWxkIHZhbHVlLiAqL1xuICBjb21tZW50VmFsdWU6IHN0cmluZztcblxuICAvKiogRnVsbCBmaWVsZCB2YWx1ZS4gKi9cbiAgZnVsbDogc3RyaW5nO1xuXG4gIC8qKiBTdGFydE9mZnNldCBmaWVsZCB2YWx1ZS4gKi9cbiAgc3RhcnRPZmZzZXQ6IG51bWJlcjtcbn1cblxuLyoqXG4gKiBFeHRyYWN0cyB0aGUgbGFuZ3VhZ2UgZnJvbSBhIGZlbmNlIGxpbmUgd2hlbiBwcmVzZW50LlxuICogQHBhcmFtIGxpbmUgRmVuY2UgbGluZSB0byBpbnNwZWN0LlxuICogQHJldHVybnMgTGFuZ3VhZ2UgdGFnIHdoZW4gcHJlc2VudC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBsYW5nID0gZ2V0RmVuY2VMYW5ndWFnZShcIiAqIGBgYHR5cGVzY3JpcHRcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gZ2V0RmVuY2VMYW5ndWFnZShsaW5lOiBzdHJpbmcpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBjb25zdCBmZW5jZU1hdGNoID0gL14oPzxsZWFkaW5nPlxccypcXCo/XFxzKilgYGAoPzxsYW5nPlteXFxzYF0rKT9bIFxcdF0qJC91LmV4ZWMoXG4gICAgbGluZSxcbiAgKTtcblxuICBpZiAoZmVuY2VNYXRjaCA9PT0gbnVsbCkge1xuICAgIHJldHVybiB2b2lkIDA7XG4gIH1cblxuICByZXR1cm4gZmVuY2VNYXRjaC5ncm91cHM/LltcImxhbmdcIl0gPz8gXCJcIjtcbn1cblxuLyoqXG4gKiBFeHRyYWN0cyBpbmxpbmUgZXhhbXBsZSBjb250ZW50IGZyb20gdGhlIGhlYWRlciBsaW5lLlxuICogQHBhcmFtIGhlYWRlciBFeGFtcGxlIGhlYWRlciBsaW5lLlxuICogQHJldHVybnMgSW5saW5lIGV4YW1wbGUgY29udGVudC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB0ZXh0ID0gZ2V0SW5saW5lQ29udGVudChcIiogQGV4YW1wbGUgaGVsbG9cIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gZ2V0SW5saW5lQ29udGVudChoZWFkZXI6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IGlubGluZU1hdGNoID0gL14uKkBleGFtcGxlXFxiXFxzPyg/PGM+LiopJC91LmV4ZWMoaGVhZGVyKTtcblxuICByZXR1cm4gaW5saW5lTWF0Y2g/Lmdyb3Vwcz8uW1wiY1wiXSA/PyBcIlwiO1xufVxuXG4vKipcbiAqIENvbXB1dGVzIGxpbmUgbWV0YWRhdGEgZnJvbSB0aGUgcmF3IGNvbW1lbnQgdmFsdWUuXG4gKiBAcGFyYW0gY29udGV4dCBDb21tZW50IG1ldGFkYXRhIGNvbnRleHQuXG4gKiBAcmV0dXJucyBMaW5lIG1ldGFkYXRhIGZvciB0aGUgZXhhbXBsZS5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBtZXRhID0gZ2V0TGluZU1ldGEoeyBjb21tZW50VmFsdWU6IFwiKiBva1wiLCBmdWxsOiBcIiogb2tcIiwgc3RhcnRPZmZzZXQ6IDAgfSk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gZ2V0TGluZU1ldGEoY29udGV4dDogTGluZU1ldGFDb250ZXh0KTogTGluZU1ldGEge1xuICBjb25zdCB7IGNvbW1lbnRWYWx1ZSwgZnVsbCwgc3RhcnRPZmZzZXQgfSA9IGNvbnRleHQ7XG4gIGNvbnN0IGxpbmVJbmRleCA9XG4gICAgY29tbWVudFZhbHVlLnNsaWNlKDAsIHN0YXJ0T2Zmc2V0KS5zcGxpdCgvXFxyP1xcbi91KS5sZW5ndGggLSAxO1xuICBjb25zdCBlbmRPZmZzZXQgPSBzdGFydE9mZnNldCArIGZ1bGwubGVuZ3RoO1xuICBjb25zdCBlbmRJbmRleCA9IGxpbmVJbmRleCArIGZ1bGwuc3BsaXQoL1xccj9cXG4vdSkubGVuZ3RoIC0gMTtcblxuICByZXR1cm4geyBlbmRJbmRleCwgZW5kT2Zmc2V0LCBsaW5lSW5kZXggfTtcbn1cblxuLyoqXG4gKiBSZXNvbHZlcyB0aGUgbGVhZGluZyBwcmVmaXggdXNlZCBieSBleGFtcGxlIGxpbmVzLlxuICogQHBhcmFtIGhlYWRlciBFeGFtcGxlIGhlYWRlciBsaW5lLlxuICogQHJldHVybnMgVGhlIGxlYWRpbmcgcHJlZml4IHN0cmluZy5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBwcmVmaXggPSBnZXRQcmVmaXgoXCIgKiBAZXhhbXBsZVwiKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBnZXRQcmVmaXgoaGVhZGVyOiBzdHJpbmcpOiBzdHJpbmcge1xuICBjb25zdCBwcmVmaXhNYXRjaCA9IGhlYWRlci5pbmRleE9mKFwiQGV4YW1wbGVcIik7XG5cbiAgaWYgKHByZWZpeE1hdGNoID09PSAtMSkge1xuICAgIHJldHVybiBcIlwiO1xuICB9XG5cbiAgcmV0dXJuIGhlYWRlci5zbGljZSgwLCBwcmVmaXhNYXRjaCk7XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyB3aGV0aGVyIGEgY29udGVudCBsaW5lIGNvbnRhaW5zIG5vbi1lbXB0eSBleGFtcGxlIHRleHQuXG4gKiBAcGFyYW0gbGluZSBMaW5lIHRleHQgdG8gY2hlY2suXG4gKiBAcmV0dXJucyBUcnVlIHdoZW4gdGhlIGxpbmUgY29udGFpbnMgY29udGVudC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBvayA9IGhhc0xpbmVDb250ZW50KFwiICogY29uc3QgdmFsdWUgPSAxO1wiKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBoYXNMaW5lQ29udGVudChsaW5lOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgY29uc3QgdHJpbW1lZCA9IGxpbmUucmVwbGFjZSgvXlxccypcXCo/XFxzPy91LCBcIlwiKS50cmltKCk7XG4gIHJldHVybiB0cmltbWVkLmxlbmd0aCA+IDA7XG59XG5cbmV4cG9ydCB7XG4gIGdldEZlbmNlTGFuZ3VhZ2UsXG4gIGdldElubGluZUNvbnRlbnQsXG4gIGdldExpbmVNZXRhLFxuICBnZXRQcmVmaXgsXG4gIGhhc0xpbmVDb250ZW50LFxufTtcbiJdfQ==

package/dist/docs/require-example-language/examples.d.ts

@@ -0,0 +1,36 @@
+import type { Example, Problem } from "./types";
+/**
+ * Builds an Example from a regex match and raw comment value.
+ * @param match Regex match from the example pattern.
+ * @param commentValue Raw comment value.
+ * @returns Example metadata extracted from the match.
+ * @example
+ * ```typescript
+ * const example = buildExampleFromMatch(match, commentValue);
+ * ```
+ */
+declare function buildExampleFromMatch(match: RegExpMatchArray, commentValue: string): Example;
+/**
+ * Checks example content for required fences and language.
+ * @param content Example content to inspect.
+ * @returns Problem identifier when the content is invalid.
+ * @example
+ * ```typescript
+ * const problem = checkExampleContent("```typescript\nconst ok = true;\n```");
+ * ```
+ */
+declare function checkExampleContent(content: string): Problem | undefined;
+/**
+ * Extracts all `@example` entries from a JSDoc comment value.
+ * Uses a multiline regex to capture the header and following lines
+ * until the next JSDoc tag or the end of the comment.
+ * @param commentValue Raw comment value.
+ * @returns Extracted examples.
+ * @example
+ * ```typescript
+ * const examples = getExamples("* @example\n* ```typescript\n* ok\n* ```");
+ * ```
+ */
+declare function getExamples(commentValue: string): Example[];
+export { buildExampleFromMatch, checkExampleContent, getExamples };
+//# sourceMappingURL=examples.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../src/docs/require-example-language/examples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA6KhD;;;;;;;;;GASG;AACH,iBAAS,qBAAqB,CAC5B,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,GACnB,OAAO,CAqBT;AAED;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAoBjE;AAED;;;;;;;;;;GAUG;AACH,iBAAS,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAQpD;AAED,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC"}

package/dist/docs/require-example-language/examples.js

@@ -0,0 +1,181 @@
+import { getFenceLanguage, getInlineContent, getLineMeta, getPrefix, hasLineContent, } from "./example-utilities";
+/** Captures `@example` headers and bodies for analysis. */
+const examplePattern = /^(?<header>\s*\*?\s*@example\b[^\n]*)(?<body>[\s\S]*?)(?=^\s*\*?\s*@\w+|(?![\s\S]))/gmu;
+/**
+ * Updates fence state based on the detected language.
+ * @param state Current fence tracking state.
+ * @param language Fence language string.
+ * @returns Updated fence tracking state.
+ * @example
+ * ```typescript
+ * const next = updateFenceState(state, "typescript");
+ * ```
+ */
+const updateFenceState = (state, language) => {
+    if (!state.inFence) {
+        if (language.length === 0) {
+            return { ...state, missingLanguage: true, sawFence: true };
+        }
+        return {
+            ...state,
+            currentFenceHasContent: false,
+            inFence: true,
+            missingLanguage: false,
+            sawFence: true,
+        };
+    }
+    return {
+        ...state,
+        currentFenceHasContent: false,
+        hasEmptyFence: state.hasEmptyFence || !state.currentFenceHasContent,
+        inFence: false,
+        missingLanguage: false,
+        sawFence: true,
+    };
+};
+/**
+ * Updates fence tracking for a single example line.
+ * @param state Current fence tracking state.
+ * @param line Example line to inspect.
+ * @returns Updated fence tracking state.
+ * @example
+ * ```typescript
+ * const next = updateFenceStateForLine(state, " * ok");
+ * ```
+ */
+const updateFenceStateForLine = (state, line) => {
+    const language = getFenceLanguage(line);
+    if (language !== void 0) {
+        return updateFenceState(state, language);
+    }
+    if (state.inFence && hasLineContent(line)) {
+        return { ...state, currentFenceHasContent: true };
+    }
+    return state;
+};
+/**
+ * Analyzes fenced code blocks for missing language identifiers.
+ * @param content Example content to analyze.
+ * @returns Fence analysis results.
+ * @example
+ * ```typescript
+ * const analysis = analyzeFenceContent("```typescript\nconst value = 1;\n```");
+ * ```
+ */
+function analyzeFenceContent(content) {
+    const lines = content.split(/\r?\n/u);
+    let state = {
+        currentFenceHasContent: false,
+        hasEmptyFence: false,
+        inFence: false,
+        missingLanguage: false,
+        sawFence: false,
+    };
+    for (const line of lines) {
+        state = updateFenceStateForLine(state, line);
+        if (state.missingLanguage) {
+            break;
+        }
+    }
+    if (state.inFence && !state.currentFenceHasContent) {
+        state = { ...state, hasEmptyFence: true };
+    }
+    return {
+        hasEmptyFence: state.hasEmptyFence,
+        missingLanguage: state.missingLanguage,
+        sawFence: state.sawFence,
+    };
+}
+/**
+ * Builds example content from an inline header and body lines.
+ * @param context Example header and body lines.
+ * @returns Combined example content.
+ * @example
+ * ```typescript
+ * const content = buildExampleContent({ body: "* ok", header: "* @example" });
+ * ```
+ */
+function buildExampleContent(context) {
+    const { body, header } = context;
+    const inlineContent = getInlineContent(header);
+    if (inlineContent.length > 0) {
+        return `${inlineContent}\n${body}`;
+    }
+    return body;
+}
+/**
+ * Builds an Example from a regex match and raw comment value.
+ * @param match Regex match from the example pattern.
+ * @param commentValue Raw comment value.
+ * @returns Example metadata extracted from the match.
+ * @example
+ * ```typescript
+ * const example = buildExampleFromMatch(match, commentValue);
+ * ```
+ */
+function buildExampleFromMatch(match, commentValue) {
+    const [full] = match;
+    const header = match.groups?.["header"] ?? "";
+    const body = match.groups?.["body"] ?? "";
+    const startOffset = match.index ?? 0;
+    const content = buildExampleContent({ body, header });
+    const prefix = getPrefix(header);
+    const { endIndex, endOffset, lineIndex } = getLineMeta({
+        commentValue,
+        full,
+        startOffset,
+    });
+    return {
+        content: content.trim(),
+        endIndex,
+        endOffset,
+        lineIndex,
+        prefix,
+        startOffset,
+    };
+}
+/**
+ * Checks example content for required fences and language.
+ * @param content Example content to inspect.
+ * @returns Problem identifier when the content is invalid.
+ * @example
+ * ```typescript
+ * const problem = checkExampleContent("```typescript\nconst ok = true;\n```");
+ * ```
+ */
+function checkExampleContent(content) {
+    if (content.trim().length === 0) {
+        return "emptyExample";
+    }
+    const { hasEmptyFence, missingLanguage, sawFence } = analyzeFenceContent(content);
+    if (missingLanguage) {
+        return "missingLanguage";
+    }
+    if (sawFence && hasEmptyFence) {
+        return "emptyExample";
+    }
+    if (!sawFence) {
+        return "missingFence";
+    }
+    return void 0;
+}
+/**
+ * Extracts all `@example` entries from a JSDoc comment value.
+ * Uses a multiline regex to capture the header and following lines
+ * until the next JSDoc tag or the end of the comment.
+ * @param commentValue Raw comment value.
+ * @returns Extracted examples.
+ * @example
+ * ```typescript
+ * const examples = getExamples("* @example\n* ```typescript\n* ok\n* ```");
+ * ```
+ */
+function getExamples(commentValue) {
+    const examples = [];
+    for (const match of commentValue.matchAll(examplePattern)) {
+        examples.push(buildExampleFromMatch(match, commentValue));
+    }
+    return examples;
+}
+export { buildExampleFromMatch, checkExampleContent, getExamples };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhhbXBsZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZG9jcy9yZXF1aXJlLWV4YW1wbGUtbGFuZ3VhZ2UvZXhhbXBsZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUNMLGdCQUFnQixFQUNoQixnQkFBZ0IsRUFDaEIsV0FBVyxFQUNYLFNBQVMsRUFDVCxjQUFjLEdBQ2YsTUFBTSxxQkFBcUIsQ0FBQztBQUU3QiwyREFBMkQ7QUFDM0QsTUFBTSxjQUFjLEdBQ2xCLHdGQUF3RixDQUFDO0FBb0IzRjs7Ozs7Ozs7O0dBU0c7QUFDSCxNQUFNLGdCQUFnQixHQUFHLENBQUMsS0FBaUIsRUFBRSxRQUFnQixFQUFjLEVBQUU7SUFDM0UsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUNuQixJQUFJLFFBQVEsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDMUIsT0FBTyxFQUFFLEdBQUcsS0FBSyxFQUFFLGVBQWUsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxDQUFDO1FBQzdELENBQUM7UUFFRCxPQUFPO1lBQ0wsR0FBRyxLQUFLO1lBQ1Isc0JBQXNCLEVBQUUsS0FBSztZQUM3QixPQUFPLEVBQUUsSUFBSTtZQUNiLGVBQWUsRUFBRSxLQUFLO1lBQ3RCLFFBQVEsRUFBRSxJQUFJO1NBQ2YsQ0FBQztJQUNKLENBQUM7SUFFRCxPQUFPO1FBQ0wsR0FBRyxLQUFLO1FBQ1Isc0JBQXNCLEVBQUUsS0FBSztRQUM3QixhQUFhLEVBQUUsS0FBSyxDQUFDLGFBQWEsSUFBSSxDQUFDLEtBQUssQ0FBQyxzQkFBc0I7UUFDbkUsT0FBTyxFQUFFLEtBQUs7UUFDZCxlQUFlLEVBQUUsS0FBSztRQUN0QixRQUFRLEVBQUUsSUFBSTtLQUNmLENBQUM7QUFDSixDQUFDLENBQUM7QUFFRjs7Ozs7Ozs7O0dBU0c7QUFDSCxNQUFNLHVCQUF1QixHQUFHLENBQzlCLEtBQWlCLEVB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XCI7XG5cbmltcG9ydCB7XG4gIGdldEZlbmNlTGFuZ3VhZ2UsXG4gIGdldElubGluZUNvbnRlbnQsXG4gIGdldExpbmVNZXRhLFxuICBnZXRQcmVmaXgsXG4gIGhhc0xpbmVDb250ZW50LFxufSBmcm9tIFwiLi9leGFtcGxlLXV0aWxpdGllc1wiO1xuXG4vKiogQ2FwdHVyZXMgYEBleGFtcGxlYCBoZWFkZXJzIGFuZCBib2RpZXMgZm9yIGFuYWx5c2lzLiAqL1xuY29uc3QgZXhhbXBsZVBhdHRlcm4gPVxuICAvXig/PGhlYWRlcj5cXHMqXFwqP1xccypAZXhhbXBsZVxcYlteXFxuXSopKD88Ym9keT5bXFxzXFxTXSo/KSg/PV5cXHMqXFwqP1xccypAXFx3K3woPyFbXFxzXFxTXSkpL2dtdTtcblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEZlbmNlU3RhdGUge1xuICAvKiogQ3VycmVudEZlbmNlSGFzQ29udGVudCBmaWVsZCB2YWx1ZS4gKi9cbiAgY3VycmVudEZlbmNlSGFzQ29udGVudDogYm9vbGVhbjtcblxuICAvKiogSGFzRW1wdHlGZW5jZSBmaWVsZCB2YWx1ZS4gKi9cbiAgaGFzRW1wdHlGZW5jZTogYm9vbGVhbjtcblxuICAvKiogSW5GZW5jZSBmaWVsZCB2YWx1ZS4gKi9cbiAgaW5GZW5jZTogYm9vbGVhbjtcblxuICAvKiogTWlzc2luZ0xhbmd1YWdlIGZpZWxkIHZhbHVlLiAqL1xuICBtaXNzaW5nTGFuZ3VhZ2U6IGJvb2xlYW47XG5cbiAgLyoqIFNhd0ZlbmNlIGZpZWxkIHZhbHVlLiAqL1xuICBzYXdGZW5jZTogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBVcGRhdGVzIGZlbmNlIHN0YXRlIGJhc2VkIG9uIHRoZSBkZXRlY3RlZCBsYW5ndWFnZS5cbiAqIEBwYXJhbSBzdGF0ZSBDdXJyZW50IGZlbmNlIHRyYWNraW5nIHN0YXRlLlxuICogQHBhcmFtIGxhbmd1YWdlIEZlbmNlIGxhbmd1YWdlIHN0cmluZy5cbiAqIEByZXR1cm5zIFVwZGF0ZWQgZmVuY2UgdHJhY2tpbmcgc3RhdGUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgbmV4dCA9IHVwZGF0ZUZlbmNlU3RhdGUoc3RhdGUsIFwidHlwZXNjcmlwdFwiKTtcbiAqIGBgYFxuICovXG5jb25zdCB1cGRhdGVGZW5jZVN0YXRlID0gKHN0YXRlOiBGZW5jZVN0YXRlLCBsYW5ndWFnZTogc3RyaW5nKTogRmVuY2VTdGF0ZSA9PiB7XG4gIGlmICghc3RhdGUuaW5GZW5jZSkge1xuICAgIGlmIChsYW5ndWFnZS5sZW5ndGggPT09IDApIHtcbiAgICAgIHJldHVybiB7IC4uLnN0YXRlLCBtaXNzaW5nTGFuZ3VhZ2U6IHRydWUsIHNhd0ZlbmNlOiB0cnVlIH07XG4gICAgfVxuXG4gICAgcmV0dXJuIHtcbiAgICAgIC4uLnN0YXRlLFxuICAgICAgY3VycmVudEZlbmNlSGFzQ29udGVudDogZmFsc2UsXG4gICAgICBpbkZlbmNlOiB0cnVlLFxuICAgICAgbWlzc2luZ0xhbmd1YWdlOiBmYWxzZSxcbiAgICAgIHNhd0ZlbmNlOiB0cnVlLFxuICAgIH07XG4gIH1cblxuICByZXR1cm4ge1xuICAgIC4uLnN0YXRlLFxuICAgIGN1cnJlbnRGZW5jZUhhc0NvbnRlbnQ6IGZhbHNlLFxuICAgIGhhc0VtcHR5RmVuY2U6IHN0YXRlLmhhc0VtcHR5RmVuY2UgfHwgIXN0YXRlLmN1cnJlbnRGZW5jZUhhc0NvbnRlbnQsXG4gICAgaW5GZW5jZTogZmFsc2UsXG4gICAgbWlzc2luZ0xhbmd1YWdlOiBmYWxzZSxcbiAgICBzYXdGZW5jZTogdHJ1ZSxcbiAgfTtcbn07XG5cbi8qKlxuICogVXBkYXRlcyBmZW5jZSB0cmFja2luZyBmb3IgYSBzaW5nbGUgZXhhbXBsZSBsaW5lLlxuICogQHBhcmFtIHN0YXRlIEN1cnJlbnQgZmVuY2UgdHJhY2tpbmcgc3RhdGUuXG4gKiBAcGFyYW0gbGluZSBFeGFtcGxlIGxpbmUgdG8gaW5zcGVjdC5cbiAqIEByZXR1cm5zIFVwZGF0ZWQgZmVuY2UgdHJhY2tpbmcgc3RhdGUuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgbmV4dCA9IHVwZGF0ZUZlbmNlU3RhdGVGb3JMaW5lKHN0YXRlLCBcIiAqIG9rXCIpO1xuICogYGBgXG4gKi9cbmNvbnN0IHVwZGF0ZUZlbmNlU3RhdGVGb3JMaW5lID0gKFxuICBzdGF0ZTogRmVuY2VTdGF0ZSxcbiAgbGluZTogc3RyaW5nLFxuKTogRmVuY2VTdGF0ZSA9PiB7XG4gIGNvbnN0IGxhbmd1YWdlID0gZ2V0RmVuY2VMYW5ndWFnZShsaW5lKTtcblxuICBpZiAobGFuZ3VhZ2UgIT09IHZvaWQgMCkge1xuICAgIHJldHVybiB1cGRhdGVGZW5jZVN0YXRlKHN0YXRlLCBsYW5ndWFnZSk7XG4gIH1cblxuICBpZiAoc3RhdGUuaW5GZW5jZSAmJiBoYXNMaW5lQ29udGVudChsaW5lKSkge1xuICAgIHJldHVybiB7IC4uLnN0YXRlLCBjdXJyZW50RmVuY2VIYXNDb250ZW50OiB0cnVlIH07XG4gIH1cblxuICByZXR1cm4gc3RhdGU7XG59O1xuXG4vKiogVHlwZSBkZWZpbml0aW9uIGZvciBydWxlIGRhdGEuICovXG5pbnRlcmZhY2UgRXhhbXBsZUNvbnRlbnRDb250ZXh0IHtcbiAgLyoqIEJvZHkgZmllbGQgdmFsdWUuICovXG4gIGJvZHk6IHN0cmluZztcblxuICAvKiogSGVhZGVyIGZpZWxkIHZhbHVlLiAqL1xuICBoZWFkZXI6IHN0cmluZztcbn1cblxuLyoqIFR5cGUgZGVmaW5pdGlvbiBmb3IgcnVsZSBkYXRhLiAqL1xuaW50ZXJmYWNlIEZlbmNlQW5hbHlzaXMge1xuICAvKiogSGFzRW1wdHlGZW5jZSBmaWVsZCB2YWx1ZS4gKi9cbiAgaGFzRW1wdHlGZW5jZTogYm9vbGVhbjtcblxuICAvKiogTWlzc2luZ0xhbmd1YWdlIGZpZWxkIHZhbHVlLiAqL1xuICBtaXNzaW5nTGFuZ3VhZ2U6IGJvb2xlYW47XG5cbiAgLyoqIFNhd0ZlbmNlIGZpZWxkIHZhbHVlLiAqL1xuICBzYXdGZW5jZTogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBBbmFseXplcyBmZW5jZWQgY29kZSBibG9ja3MgZm9yIG1pc3NpbmcgbGFuZ3VhZ2UgaWRlbnRpZmllcnMuXG4gKiBAcGFyYW0gY29udGVudCBFeGFtcGxlIGNvbnRlbnQgdG8gYW5hbHl6ZS5cbiAqIEByZXR1cm5zIEZlbmNlIGFuYWx5c2lzIHJlc3VsdHMuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgYW5hbHlzaXMgPSBhbmFseXplRmVuY2VDb250ZW50KFwiYGBgdHlwZXNjcmlwdFxcbmNvbnN0IHZhbHVlID0gMTtcXG5gYGBcIik7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gYW5hbHl6ZUZlbmNlQ29udGVudChjb250ZW50OiBzdHJpbmcpOiBGZW5jZUFuYWx5c2lzIHtcbiAgY29uc3QgbGluZXMgPSBjb250ZW50LnNwbGl0KC9cXHI/XFxuL3UpO1xuICBsZXQgc3RhdGU6IEZlbmNlU3RhdGUgPSB7XG4gICAgY3VycmVudEZlbmNlSGFzQ29udGVudDogZmFsc2UsXG4gICAgaGFzRW1wdHlGZW5jZTogZmFsc2UsXG4gICAgaW5GZW5jZTogZmFsc2UsXG4gICAgbWlzc2luZ0xhbmd1YWdlOiBmYWxzZSxcbiAgICBzYXdGZW5jZTogZmFsc2UsXG4gIH07XG5cbiAgZm9yIChjb25zdCBsaW5lIG9mIGxpbmVzKSB7XG4gICAgc3RhdGUgPSB1cGRhdGVGZW5jZVN0YXRlRm9yTGluZShzdGF0ZSwgbGluZSk7XG5cbiAgICBpZiAoc3RhdGUubWlzc2luZ0xhbmd1YWdlKSB7XG4gICAgICBicmVhaztcbiAgICB9XG4gIH1cblxuICBpZiAoc3RhdGUuaW5GZW5jZSAmJiAhc3RhdGUuY3VycmVudEZlbmNlSGFzQ29udGVudCkge1xuICAgIHN0YXRlID0geyAuLi5zdGF0ZSwgaGFzRW1wdHlGZW5jZTogdHJ1ZSB9O1xuICB9XG5cbiAgcmV0dXJuIHtcbiAgICBoYXNFbXB0eUZlbmNlOiBzdGF0ZS5oYXNFbXB0eUZlbmNlLFxuICAgIG1pc3NpbmdMYW5ndWFnZTogc3RhdGUubWlzc2luZ0xhbmd1YWdlLFxuICAgIHNhd0ZlbmNlOiBzdGF0ZS5zYXdGZW5jZSxcbiAgfTtcbn1cblxuLyoqXG4gKiBCdWlsZHMgZXhhbXBsZSBjb250ZW50IGZyb20gYW4gaW5saW5lIGhlYWRlciBhbmQgYm9keSBsaW5lcy5cbiAqIEBwYXJhbSBjb250ZXh0IEV4YW1wbGUgaGVhZGVyIGFuZCBib2R5IGxpbmVzLlxuICogQHJldHVybnMgQ29tYmluZWQgZXhhbXBsZSBjb250ZW50LlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IGNvbnRlbnQgPSBidWlsZEV4YW1wbGVDb250ZW50KHsgYm9keTogXCIqIG9rXCIsIGhlYWRlcjogXCIqIEBleGFtcGxlXCIgfSk7XG4gKiBgYGBcbiAqL1xuZnVuY3Rpb24gYnVpbGRFeGFtcGxlQ29udGVudChjb250ZXh0OiBFeGFtcGxlQ29udGVudENvbnRleHQpOiBzdHJpbmcge1xuICBjb25zdCB7IGJvZHksIGhlYWRlciB9ID0gY29udGV4dDtcbiAgY29uc3QgaW5saW5lQ29udGVudCA9IGdldElubGluZUNvbnRlbnQoaGVhZGVyKTtcblxuICBpZiAoaW5saW5lQ29udGVudC5sZW5ndGggPiAwKSB7XG4gICAgcmV0dXJuIGAke2lubGluZUNvbnRlbnR9XFxuJHtib2R5fWA7XG4gIH1cblxuICByZXR1cm4gYm9keTtcbn1cblxuLyoqXG4gKiBCdWlsZHMgYW4gRXhhbXBsZSBmcm9tIGEgcmVnZXggbWF0Y2ggYW5kIHJhdyBjb21tZW50IHZhbHVlLlxuICogQHBhcmFtIG1hdGNoIFJlZ2V4IG1hdGNoIGZyb20gdGhlIGV4YW1wbGUgcGF0dGVybi5cbiAqIEBwYXJhbSBjb21tZW50VmFsdWUgUmF3IGNvbW1lbnQgdmFsdWUuXG4gKiBAcmV0dXJucyBFeGFtcGxlIG1ldGFkYXRhIGV4dHJhY3RlZCBmcm9tIHRoZSBtYXRjaC5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBleGFtcGxlID0gYnVpbGRFeGFtcGxlRnJvbU1hdGNoKG1hdGNoLCBjb21tZW50VmFsdWUpO1xuICogYGBgXG4gKi9cbmZ1bmN0aW9uIGJ1aWxkRXhhbXBsZUZyb21NYXRjaChcbiAgbWF0Y2g6IFJlZ0V4cE1hdGNoQXJyYXksXG4gIGNvbW1lbnRWYWx1ZTogc3RyaW5nLFxuKTogRXhhbXBsZSB7XG4gIGNvbnN0IFtmdWxsXSA9IG1hdGNoO1xuICBjb25zdCBoZWFkZXIgPSBtYXRjaC5ncm91cHM/LltcImhlYWRlclwiXSA/PyBcIlwiO1xuICBjb25zdCBib2R5ID0gbWF0Y2guZ3JvdXBzPy5bXCJib2R5XCJdID8/IFwiXCI7XG4gIGNvbnN0IHN0YXJ0T2Zmc2V0ID0gbWF0Y2guaW5kZXggPz8gMDtcbiAgY29uc3QgY29udGVudCA9IGJ1aWxkRXhhbXBsZUNvbnRlbnQoeyBib2R5LCBoZWFkZXIgfSk7XG4gIGNvbnN0IHByZWZpeCA9IGdldFByZWZpeChoZWFkZXIpO1xuICBjb25zdCB7IGVuZEluZGV4LCBlbmRPZmZzZXQsIGxpbmVJbmRleCB9ID0gZ2V0TGluZU1ldGEoe1xuICAgIGNvbW1lbnRWYWx1ZSxcbiAgICBmdWxsLFxuICAgIHN0YXJ0T2Zmc2V0LFxuICB9KTtcblxuICByZXR1cm4ge1xuICAgIGNvbnRlbnQ6IGNvbnRlbnQudHJpbSgpLFxuICAgIGVuZEluZGV4LFxuICAgIGVuZE9mZnNldCxcbiAgICBsaW5lSW5kZXgsXG4gICAgcHJlZml4LFxuICAgIHN0YXJ0T2Zmc2V0LFxuICB9O1xufVxuXG4vKipcbiAqIENoZWNrcyBleGFtcGxlIGNvbnRlbnQgZm9yIHJlcXVpcmVkIGZlbmNlcyBhbmQgbGFuZ3VhZ2UuXG4gKiBAcGFyYW0gY29udGVudCBFeGFtcGxlIGNvbnRlbnQgdG8gaW5zcGVjdC5cbiAqIEByZXR1cm5zIFByb2JsZW0gaWRlbnRpZmllciB3aGVuIHRoZSBjb250ZW50IGlzIGludmFsaWQuXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgcHJvYmxlbSA9IGNoZWNrRXhhbXBsZUNvbnRlbnQoXCJgYGB0eXBlc2NyaXB0XFxuY29uc3Qgb2sgPSB0cnVlO1xcbmBgYFwiKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBjaGVja0V4YW1wbGVDb250ZW50KGNvbnRlbnQ6IHN0cmluZyk6IFByb2JsZW0gfCB1bmRlZmluZWQge1xuICBpZiAoY29udGVudC50cmltKCkubGVuZ3RoID09PSAwKSB7XG4gICAgcmV0dXJuIFwiZW1wdHlFeGFtcGxlXCI7XG4gIH1cbiAgY29uc3QgeyBoYXNFbXB0eUZlbmNlLCBtaXNzaW5nTGFuZ3VhZ2UsIHNhd0ZlbmNlIH0gPVxuICAgIGFuYWx5emVGZW5jZUNvbnRlbnQoY29udGVudCk7XG5cbiAgaWYgKG1pc3NpbmdMYW5ndWFnZSkge1xuICAgIHJldHVybiBcIm1pc3NpbmdMYW5ndWFnZVwiO1xuICB9XG5cbiAgaWYgKHNhd0ZlbmNlICYmIGhhc0VtcHR5RmVuY2UpIHtcbiAgICByZXR1cm4gXCJlbXB0eUV4YW1wbGVcIjtcbiAgfVxuXG4gIGlmICghc2F3RmVuY2UpIHtcbiAgICByZXR1cm4gXCJtaXNzaW5nRmVuY2VcIjtcbiAgfVxuXG4gIHJldHVybiB2b2lkIDA7XG59XG5cbi8qKlxuICogRXh0cmFjdHMgYWxsIGBAZXhhbXBsZWAgZW50cmllcyBmcm9tIGEgSlNEb2MgY29tbWVudCB2YWx1ZS5cbiAqIFVzZXMgYSBtdWx0aWxpbmUgcmVnZXggdG8gY2FwdHVyZSB0aGUgaGVhZGVyIGFuZCBmb2xsb3dpbmcgbGluZXNcbiAqIHVudGlsIHRoZSBuZXh0IEpTRG9jIHRhZyBvciB0aGUgZW5kIG9mIHRoZSBjb21tZW50LlxuICogQHBhcmFtIGNvbW1lbnRWYWx1ZSBSYXcgY29tbWVudCB2YWx1ZS5cbiAqIEByZXR1cm5zIEV4dHJhY3RlZCBleGFtcGxlcy5cbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCBleGFtcGxlcyA9IGdldEV4YW1wbGVzKFwiKiBAZXhhbXBsZVxcbiogYGBgdHlwZXNjcmlwdFxcbiogb2tcXG4qIGBgYFwiKTtcbiAqIGBgYFxuICovXG5mdW5jdGlvbiBnZXRFeGFtcGxlcyhjb21tZW50VmFsdWU6IHN0cmluZyk6IEV4YW1wbGVbXSB7XG4gIGNvbnN0IGV4YW1wbGVzOiBFeGFtcGxlW10gPSBbXTtcblxuICBmb3IgKGNvbnN0IG1hdGNoIG9mIGNvbW1lbnRWYWx1ZS5tYXRjaEFsbChleGFtcGxlUGF0dGVybikpIHtcbiAgICBleGFtcGxlcy5wdXNoKGJ1aWxkRXhhbXBsZUZyb21NYXRjaChtYXRjaCwgY29tbWVudFZhbHVlKSk7XG4gIH1cblxuICByZXR1cm4gZXhhbXBsZXM7XG59XG5cbmV4cG9ydCB7IGJ1aWxkRXhhbXBsZUZyb21NYXRjaCwgY2hlY2tFeGFtcGxlQ29udGVudCwgZ2V0RXhhbXBsZXMgfTtcbiJdfQ==

package/dist/docs/require-example-language/fixes.d.ts

@@ -0,0 +1,49 @@
+import type { Rule } from "eslint";
+import type { Example, Problem } from "./types";
+/** Type definition for rule data. */
+interface FixerContext {
+    /** AbsoluteEnd field value. */
+    absoluteEnd: number;
+    /** AbsoluteStart field value. */
+    absoluteStart: number;
+    /** Example field value. */
+    example: Example;
+    /** HasOtherExamples field value. */
+    hasOtherExamples: boolean;
+    /** Problem field value. */
+    problem: Problem;
+    /** SourceText field value. */
+    sourceText: string;
+}
+/**
+ * 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);
+ * ```
+ */
+declare function buildMissingFenceFix(example: Example): string;
+/**
+ * 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* ```");
+ * ```
+ */
+declare function buildMissingLanguageFix(original: string): string | undefined;
+/**
+ * Builds a fixer function for the report.
+ * @param context Fixer context details.
+ * @returns Fixer function for ESLint.
+ * @example
+ * ```typescript
+ * const fixer = createFixer(context);
+ * ```
+ */
+declare function createFixer(context: FixerContext): (fixer: Rule.RuleFixer) => null | Rule.Fix;
+export { buildMissingFenceFix, buildMissingLanguageFix, createFixer };
+//# sourceMappingURL=fixes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../../src/docs/require-example-language/fixes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA8BhD,qCAAqC;AACrC,UAAU,YAAY;IACpB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AA2CD;;;;;;;;GAQG;AACH,iBAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgBtD;AAED;;;;;;;;GAQG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBrE;AAED;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAClB,OAAO,EAAE,YAAY,GACpB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC,GAAG,CAY5C;AAwHD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,WAAW,EAAE,CAAC"}