@diplodoc/folding-headings-extension 0.1.3 → 0.2.1

package/build/plugin/index.js

@@ -105,10 +105,10 @@ var headingBlockRule = (state, startLine, _endLine, silent) => {
   return true;
 };
 
+// src/plugin/sectionsCoreRule.ts
+var import_utils = require("@diplodoc/utils");
+
 // src/plugin/utils.ts
-function generateID() {
-  return DATA_KEY + "-" + Math.random().toString(36).substr(2, 8);
-}
 function headingLevel(header) {
   return parseInt(header.charAt(1), 10);
 }
@@ -150,102 +150,110 @@ function dynrequire(module) {
 }
 
 // src/plugin/sectionsCoreRule.ts
-var sectionsCoreRule = (state) => {
-  const Token = state.Token;
-  const tokens = [];
-  const sections = [];
-  let nestedLevel = 0;
-  for (const token of state.tokens) {
-    if (token.type.search(TokenType.Heading) !== 0) {
-      nestedLevel += token.nesting;
+function createSectionsCoreRule(externalGenerateID) {
+  const generateID = externalGenerateID ?? (0, import_utils.createIDGeneratorByStrategy)("random");
+  return (state) => {
+    const Token = state.Token;
+    const tokens = [];
+    const sections = [];
+    let nestedLevel = 0;
+    for (const token of state.tokens) {
+      if (token.type.search(TokenType.Heading) !== 0) {
+        nestedLevel += token.nesting;
+      }
+      if (last(sections) && nestedLevel < last(sections).nesting) {
+        closeSectionsToCurrentNesting(nestedLevel);
+      }
+      const hasFolding = token.markup.endsWith("#+");
+      if (token.type === TokenType.HeadingOpen) {
+        const section = {
+          header: headingLevel(token.tag),
+          nesting: nestedLevel
+        };
+        closeSections(section);
+        if (hasFolding) {
+          tokens.push(openSection());
+          sections.push(section);
+        }
+      }
+      tokens.push(token);
+      if (token.type === TokenType.HeadingClose && hasFolding) {
+        tokens.push(openContent());
+      }
     }
-    if (last(sections) && nestedLevel < last(sections).nesting) {
-      closeSectionsToCurrentNesting(nestedLevel);
+    closeAllSections();
+    if (state.tokens.length !== tokens.length) {
+      state.env ??= {};
+      state.env[ENV_FLAG_NAME] = true;
     }
-    const hasFolding = token.markup.endsWith("#+");
-    if (token.type === TokenType.HeadingOpen) {
-      const section = {
-        header: headingLevel(token.tag),
-        nesting: nestedLevel
-      };
-      closeSections(section);
-      if (hasFolding) {
-        tokens.push(openSection());
-        sections.push(section);
-      }
+    state.tokens = tokens;
+    function openSection() {
+      const t = new Token(TokenType.SectionOpen, "section", 1);
+      t.attrPush(["class", SectionCN.Section]);
+      t.attrPush([SectionAttr.DataKey, DATA_KEY]);
+      t.attrPush([SectionAttr.DataId, generateID(DATA_KEY)]);
+      t.block = true;
+      return t;
     }
-    tokens.push(token);
-    if (token.type === TokenType.HeadingClose && hasFolding) {
-      tokens.push(openContent());
+    function closeSection() {
+      const t = new Token(TokenType.SectionClose, "section", -1);
+      t.block = true;
+      return t;
     }
-  }
-  closeAllSections();
-  if (state.tokens.length !== tokens.length) {
-    state.env ??= {};
-    state.env[ENV_FLAG_NAME] = true;
-  }
-  state.tokens = tokens;
-  function openSection() {
-    const t = new Token(TokenType.SectionOpen, "section", 1);
-    t.attrPush(["class", SectionCN.Section]);
-    t.attrPush([SectionAttr.DataKey, DATA_KEY]);
-    t.attrPush([SectionAttr.DataId, generateID()]);
-    t.block = true;
-    return t;
-  }
-  function closeSection() {
-    const t = new Token(TokenType.SectionClose, "section", -1);
-    t.block = true;
-    return t;
-  }
-  function openContent() {
-    const t = new Token(TokenType.ContentOpen, "div", 1);
-    t.attrPush(["class", SectionCN.Content]);
-    t.block = true;
-    return t;
-  }
-  function closeContent() {
-    const t = new Token(TokenType.ContentClose, "div", -1);
-    t.block = true;
-    return t;
-  }
-  function closeSections(section) {
-    while (last(sections) && // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    section.header <= last(sections).header && // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion
-    section.nesting <= last(sections).nesting) {
-      sections.pop();
-      tokens.push(closeContent());
-      tokens.push(closeSection());
+    function openContent() {
+      const t = new Token(TokenType.ContentOpen, "div", 1);
+      t.attrPush(["class", SectionCN.Content]);
+      t.block = true;
+      return t;
     }
-  }
-  function closeSectionsToCurrentNesting(nesting) {
-    while (last(sections) && nesting < last(sections).nesting) {
-      sections.pop();
-      tokens.push(closeContent());
-      tokens.push(closeSection());
+    function closeContent() {
+      const t = new Token(TokenType.ContentClose, "div", -1);
+      t.block = true;
+      return t;
     }
-  }
-  function closeAllSections() {
-    while (sections.pop()) {
-      tokens.push(closeContent());
-      tokens.push(closeSection());
+    function closeSections(section) {
+      while (last(sections) && // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      section.header <= last(sections).header && // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion
+      section.nesting <= last(sections).nesting) {
+        sections.pop();
+        tokens.push(closeContent());
+        tokens.push(closeSection());
+      }
     }
-  }
-};
+    function closeSectionsToCurrentNesting(nesting) {
+      while (last(sections) && nesting < last(sections).nesting) {
+        sections.pop();
+        tokens.push(closeContent());
+        tokens.push(closeSection());
+      }
+    }
+    function closeAllSections() {
+      while (sections.pop()) {
+        tokens.push(closeContent());
+        tokens.push(closeSection());
+      }
+    }
+  };
+}
 
 // src/plugin/plugin.ts
-var foldingHeadingPlugin = (md) => {
-  md.block.ruler.at("heading", headingBlockRule, { alt: ["paragraph", "reference", "blockquote"] });
-  md.core.ruler.push("heading_sections", sectionsCoreRule);
-};
+function createFoldingHeadingPlugin(generateID) {
+  return (md) => {
+    md.block.ruler.at("heading", headingBlockRule, {
+      alt: ["paragraph", "reference", "blockquote"]
+    });
+    md.core.ruler.push("heading_sections", createSectionsCoreRule(generateID));
+  };
+}
 
 // src/plugin/transform.ts
 var registerTransform = (md, {
   runtime,
   bundle,
-  output
+  output,
+  generateID
 }) => {
-  md.use(foldingHeadingPlugin);
+  md.use(createFoldingHeadingPlugin(generateID));
   md.core.ruler.push("heading_sections_after", ({ env }) => {
     hidden(env, "bundled", /* @__PURE__ */ new Set());
     if (env?.[ENV_FLAG_NAME]) {
@@ -269,11 +277,12 @@ function transform(options = {}) {
     script: "_assets/folding-headings-extension.js",
     style: "_assets/folding-headings-extension.css"
   };
-  const plugin = function(md, { output = "." } = {}) {
+  const plugin = function(md, { output = ".", generateID } = {}) {
     registerTransform(md, {
       runtime,
       bundle,
-      output
+      output,
+      generateID
     });
   };
   Object.assign(plugin, {

package/build/plugin/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/plugin/index.ts", "../../src/common/const.ts", "../../src/plugin/const.ts", "../../src/plugin/headingBlockRule.ts", "../../src/plugin/utils.ts", "../../src/plugin/sectionsCoreRule.ts", "../../src/plugin/plugin.ts", "../../src/plugin/transform.ts"],
-  "sourcesContent": ["export type {TransformOptions} from './transform';\nexport {transform} from './transform';\nexport {TokenType} from './const';\n", "export const DATA_KEY = 'heading-section';\n\nexport const SectionAttr = {\n    DataId: 'data-diplodoc-id',\n    DataKey: 'data-diplodoc-key',\n} as const;\n\nexport const SectionCN = {\n    Section: 'heading-section',\n    Content: 'heading-section-content',\n};\n", "export {SectionCN, DATA_KEY, SectionAttr} from '../common/const';\n\nexport const ENV_FLAG_NAME = 'has-folding-headings';\n\nexport const TokenType = {\n    Heading: 'heading',\n    HeadingOpen: 'heading_open',\n    HeadingClose: 'heading_close',\n    Section: 'heading_section',\n    SectionOpen: 'heading_section_open',\n    SectionClose: 'heading_section_close',\n    Content: 'heading_section_content',\n    ContentOpen: 'heading_section_content_open',\n    ContentClose: 'heading_section_content_close',\n} as const;\n", "import type ParserBlock from 'markdown-it/lib/parser_block';\n\nimport {TokenType} from './const';\n\n// copied from https://github.com/markdown-it/markdown-it/blob/14.1.0/lib/rules_block/heading.mjs\n// modified: support syntax ###+ for folding headings\nexport const headingBlockRule: ParserBlock.RuleBlock = (state, startLine, _endLine, silent) => {\n    const {isSpace} = state.md.utils;\n\n    let pos = state.bMarks[startLine] + state.tShift[startLine];\n    let max = state.eMarks[startLine];\n\n    // if it's indented more than 3 spaces, it should be a code block\n    if (state.sCount[startLine] - state.blkIndent >= 4) {\n        return false;\n    }\n\n    let ch = state.src.charCodeAt(pos);\n\n    if (ch !== 0x23 /* # */ || pos >= max) {\n        return false;\n    }\n\n    // count heading level\n    let level = 1;\n    ch = state.src.charCodeAt(++pos);\n    while (ch === 0x23 /* # */ && pos < max && level <= 6) {\n        level++;\n        ch = state.src.charCodeAt(++pos);\n    }\n\n    let folding = false;\n    if (ch === 0x2b /* + */) {\n        folding = true;\n        ch = state.src.charCodeAt(++pos);\n    }\n\n    if (level > 6 || (pos < max && !isSpace(ch))) {\n        return false;\n    }\n\n    if (silent) {\n        return true;\n    }\n\n    // Let's cut tails like '    ###  ' from the end of string\n\n    max = state.skipSpacesBack(max, pos);\n    const tmp = state.skipCharsBack(max, 0x23, pos); // #\n    if (tmp > pos && isSpace(state.src.charCodeAt(tmp - 1))) {\n        max = tmp;\n    }\n\n    state.line = startLine + 1;\n\n    let token = state.push(TokenType.HeadingOpen, 'h' + String(level), 1);\n    token.markup = '########'.slice(0, level) + (folding ? '+' : '');\n    token.map = [startLine, state.line];\n    if (folding) {\n        token.meta ||= {};\n        token.meta.folding = true;\n    }\n\n    token = state.push('inline', '', 0);\n    token.content = state.src.slice(pos, max).trim();\n    token.map = [startLine, state.line];\n    token.children = [];\n\n    token = state.push(TokenType.HeadingClose, 'h' + String(level), -1);\n    token.markup = '########'.slice(0, level) + (folding ? '+' : '');\n    if (folding) {\n        token.meta ||= {};\n        token.meta.folding = true;\n    }\n\n    return true;\n};\n", "import {DATA_KEY} from './const';\n\nexport function generateID() {\n    return DATA_KEY + '-' + Math.random().toString(36).substr(2, 8);\n}\n\nexport function headingLevel(header: string) {\n    return parseInt(header.charAt(1), 10);\n}\n\nexport function last<T>(arr: T[]): T | undefined {\n    return arr[arr.length - 1];\n}\n\nexport function hidden<B extends Record<string | symbol, unknown>, F extends string | symbol, V>(\n    box: B,\n    field: F,\n    value: V,\n) {\n    if (!(field in box)) {\n        Object.defineProperty(box, field, {\n            enumerable: false,\n            value: value,\n        });\n    }\n\n    return box as B & Record<F, V>;\n}\n\nexport type Runtime = {\n    script: string;\n    style: string;\n};\n\ndeclare const __dirname: string;\nexport function copyRuntime(\n    {runtime, output}: {runtime: Runtime; output: string},\n    cache: Set<string>,\n) {\n    const PATH_TO_RUNTIME = '../runtime';\n    const {join, resolve} = dynrequire('node:path');\n    const runtimeFiles = {\n        'index.js': runtime.script,\n        'index.css': runtime.style,\n    };\n    for (const [originFile, outputFile] of Object.entries(runtimeFiles)) {\n        const file = join(PATH_TO_RUNTIME, originFile);\n        if (!cache.has(file)) {\n            cache.add(file);\n            copy(resolve(__dirname, file), join(output, outputFile));\n        }\n    }\n}\n\nexport function copy(from: string, to: string) {\n    const {mkdirSync, copyFileSync} = dynrequire('node:fs');\n    const {dirname} = dynrequire('node:path');\n\n    mkdirSync(dirname(to), {recursive: true});\n    copyFileSync(from, to);\n}\n\n/*\n * Runtime require hidden for builders.\n * Used for nodejs api\n */\nexport function dynrequire(module: string) {\n    // eslint-disable-next-line no-eval\n    return eval(`require('${module}')`);\n}\n", "import type Core from 'markdown-it/lib/parser_core';\n\nimport {DATA_KEY, ENV_FLAG_NAME, SectionAttr, SectionCN, TokenType} from './const';\nimport {generateID, headingLevel, last} from './utils';\n\ntype Section = {header: number; nesting: number};\n\nexport const sectionsCoreRule: Core.RuleCore = (state) => {\n    const Token = state.Token;\n    const tokens: typeof state.tokens = []; // output\n    const sections: Section[] = [];\n    let nestedLevel = 0;\n\n    for (const token of state.tokens) {\n        // record level of nesting\n        if (token.type.search(TokenType.Heading) !== 0) {\n            nestedLevel += token.nesting;\n        }\n        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n        if (last(sections) && nestedLevel < last(sections)!.nesting) {\n            closeSectionsToCurrentNesting(nestedLevel);\n        }\n\n        const hasFolding = token.markup.endsWith('#+');\n\n        // add sections before headers\n        if (token.type === TokenType.HeadingOpen) {\n            const section: Section = {\n                header: headingLevel(token.tag),\n                nesting: nestedLevel,\n            };\n            closeSections(section);\n            if (hasFolding) {\n                tokens.push(openSection());\n                sections.push(section);\n            }\n        }\n\n        tokens.push(token);\n\n        if (token.type === TokenType.HeadingClose && hasFolding) {\n            tokens.push(openContent());\n        }\n    }\n\n    // end for every token\n    closeAllSections();\n\n    if (state.tokens.length !== tokens.length) {\n        state.env ??= {};\n        state.env[ENV_FLAG_NAME] = true;\n    }\n\n    state.tokens = tokens;\n\n    function openSection() {\n        const t = new Token(TokenType.SectionOpen, 'section', 1);\n        t.attrPush(['class', SectionCN.Section]);\n        t.attrPush([SectionAttr.DataKey, DATA_KEY]);\n        t.attrPush([SectionAttr.DataId, generateID()]);\n        t.block = true;\n        return t;\n    }\n\n    function closeSection() {\n        const t = new Token(TokenType.SectionClose, 'section', -1);\n        t.block = true;\n        return t;\n    }\n\n    function openContent() {\n        const t = new Token(TokenType.ContentOpen, 'div', 1);\n        t.attrPush(['class', SectionCN.Content]);\n        t.block = true;\n        return t;\n    }\n\n    function closeContent() {\n        const t = new Token(TokenType.ContentClose, 'div', -1);\n        t.block = true;\n        return t;\n    }\n\n    function closeSections(section: Section) {\n        while (\n            last(sections) &&\n            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n            section.header <= last(sections)!.header &&\n            // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion\n            section.nesting <= last(sections)!.nesting\n        ) {\n            sections.pop();\n            tokens.push(closeContent());\n            tokens.push(closeSection());\n        }\n    }\n\n    function closeSectionsToCurrentNesting(nesting: number) {\n        // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion\n        while (last(sections) && nesting < last(sections)!.nesting) {\n            sections.pop();\n            tokens.push(closeContent());\n            tokens.push(closeSection());\n        }\n    }\n\n    function closeAllSections() {\n        while (sections.pop()) {\n            tokens.push(closeContent());\n            tokens.push(closeSection());\n        }\n    }\n};\n", "import type {PluginSimple} from 'markdown-it';\n\nimport {headingBlockRule} from './headingBlockRule';\nimport {sectionsCoreRule} from './sectionsCoreRule';\n\nexport const foldingHeadingPlugin: PluginSimple = (md) => {\n    md.block.ruler.at('heading', headingBlockRule, {alt: ['paragraph', 'reference', 'blockquote']});\n    md.core.ruler.push('heading_sections', sectionsCoreRule);\n};\n", "import type MarkdownIt from 'markdown-it';\nimport type {PluginWithOptions} from 'markdown-it';\n\nimport {ENV_FLAG_NAME} from './const';\nimport {foldingHeadingPlugin} from './plugin';\nimport {type Runtime, copyRuntime, dynrequire, hidden} from './utils';\n\nconst registerTransform = (\n    md: MarkdownIt,\n    {\n        runtime,\n        bundle,\n        output,\n    }: Pick<NormalizedPluginOptions, 'bundle' | 'runtime'> & {\n        output: string;\n    },\n) => {\n    md.use(foldingHeadingPlugin);\n    md.core.ruler.push('heading_sections_after', ({env}) => {\n        hidden(env, 'bundled', new Set<string>());\n\n        if (env?.[ENV_FLAG_NAME]) {\n            env.meta = env.meta || {};\n            env.meta.script = env.meta.script || [];\n            env.meta.script.push(runtime.script);\n            env.meta.style = env.meta.style || [];\n            env.meta.style.push(runtime.style);\n\n            if (bundle) {\n                copyRuntime({runtime, output}, env.bundled);\n            }\n        }\n    });\n};\n\ntype NormalizedPluginOptions = Omit<TransformOptions, 'runtime'> & {\n    runtime: Runtime;\n};\n\nexport type TransformOptions = {\n    runtime?:\n        | string\n        | {\n              script: string;\n              style: string;\n          };\n    bundle?: boolean;\n};\n\ntype InputOptions = {\n    destRoot: string;\n};\n\nexport function transform(options: Partial<TransformOptions> = {}) {\n    const {bundle = true} = options;\n\n    if (bundle && typeof options.runtime === 'string') {\n        throw new TypeError('Option `runtime` should be record when `bundle` is enabled.');\n    }\n\n    const runtime: Runtime =\n        typeof options.runtime === 'string'\n            ? {script: options.runtime, style: options.runtime}\n            : options.runtime || {\n                  script: '_assets/folding-headings-extension.js',\n                  style: '_assets/folding-headings-extension.css',\n              };\n\n    const plugin: PluginWithOptions<{output?: string}> = function (\n        md: MarkdownIt,\n        {output = '.'} = {},\n    ) {\n        registerTransform(md, {\n            runtime,\n            bundle,\n            output,\n        });\n    };\n\n    Object.assign(plugin, {\n        collect(input: string, {destRoot = '.'}: InputOptions) {\n            const MdIt = dynrequire('markdown-it');\n            const md = new MdIt().use((md: MarkdownIt) => {\n                registerTransform(md, {\n                    runtime,\n                    bundle,\n                    output: destRoot,\n                });\n            });\n\n            md.parse(input, {});\n        },\n    });\n\n    return plugin;\n}\n"],
-  "mappings": "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",
+  "sources": ["../../src/plugin/index.ts", "../../src/common/const.ts", "../../src/plugin/const.ts", "../../src/plugin/headingBlockRule.ts", "../../src/plugin/sectionsCoreRule.ts", "../../src/plugin/utils.ts", "../../src/plugin/plugin.ts", "../../src/plugin/transform.ts"],
+  "sourcesContent": ["export type {TransformOptions} from './transform';\nexport {transform} from './transform';\nexport {TokenType} from './const';\n", "export const DATA_KEY = 'heading-section';\n\nexport const SectionAttr = {\n    DataId: 'data-diplodoc-id',\n    DataKey: 'data-diplodoc-key',\n} as const;\n\nexport const SectionCN = {\n    Section: 'heading-section',\n    Content: 'heading-section-content',\n};\n", "export {SectionCN, DATA_KEY, SectionAttr} from '../common/const';\n\nexport const ENV_FLAG_NAME = 'has-folding-headings';\n\nexport const TokenType = {\n    Heading: 'heading',\n    HeadingOpen: 'heading_open',\n    HeadingClose: 'heading_close',\n    Section: 'heading_section',\n    SectionOpen: 'heading_section_open',\n    SectionClose: 'heading_section_close',\n    Content: 'heading_section_content',\n    ContentOpen: 'heading_section_content_open',\n    ContentClose: 'heading_section_content_close',\n} as const;\n", "import type ParserBlock from 'markdown-it/lib/parser_block';\n\nimport {TokenType} from './const';\n\n// copied from https://github.com/markdown-it/markdown-it/blob/14.1.0/lib/rules_block/heading.mjs\n// modified: support syntax ###+ for folding headings\nexport const headingBlockRule: ParserBlock.RuleBlock = (state, startLine, _endLine, silent) => {\n    const {isSpace} = state.md.utils;\n\n    let pos = state.bMarks[startLine] + state.tShift[startLine];\n    let max = state.eMarks[startLine];\n\n    // if it's indented more than 3 spaces, it should be a code block\n    if (state.sCount[startLine] - state.blkIndent >= 4) {\n        return false;\n    }\n\n    let ch = state.src.charCodeAt(pos);\n\n    if (ch !== 0x23 /* # */ || pos >= max) {\n        return false;\n    }\n\n    // count heading level\n    let level = 1;\n    ch = state.src.charCodeAt(++pos);\n    while (ch === 0x23 /* # */ && pos < max && level <= 6) {\n        level++;\n        ch = state.src.charCodeAt(++pos);\n    }\n\n    let folding = false;\n    if (ch === 0x2b /* + */) {\n        folding = true;\n        ch = state.src.charCodeAt(++pos);\n    }\n\n    if (level > 6 || (pos < max && !isSpace(ch))) {\n        return false;\n    }\n\n    if (silent) {\n        return true;\n    }\n\n    // Let's cut tails like '    ###  ' from the end of string\n\n    max = state.skipSpacesBack(max, pos);\n    const tmp = state.skipCharsBack(max, 0x23, pos); // #\n    if (tmp > pos && isSpace(state.src.charCodeAt(tmp - 1))) {\n        max = tmp;\n    }\n\n    state.line = startLine + 1;\n\n    let token = state.push(TokenType.HeadingOpen, 'h' + String(level), 1);\n    token.markup = '########'.slice(0, level) + (folding ? '+' : '');\n    token.map = [startLine, state.line];\n    if (folding) {\n        token.meta ||= {};\n        token.meta.folding = true;\n    }\n\n    token = state.push('inline', '', 0);\n    token.content = state.src.slice(pos, max).trim();\n    token.map = [startLine, state.line];\n    token.children = [];\n\n    token = state.push(TokenType.HeadingClose, 'h' + String(level), -1);\n    token.markup = '########'.slice(0, level) + (folding ? '+' : '');\n    if (folding) {\n        token.meta ||= {};\n        token.meta.folding = true;\n    }\n\n    return true;\n};\n", "import type Core from 'markdown-it/lib/parser_core';\nimport type {IDGenerator} from '@diplodoc/utils';\n\nimport {createIDGeneratorByStrategy} from '@diplodoc/utils';\n\nimport {DATA_KEY, ENV_FLAG_NAME, SectionAttr, SectionCN, TokenType} from './const';\nimport {headingLevel, last} from './utils';\n\ntype Section = {header: number; nesting: number};\n\n/**\n * Creates a core rule that wraps folding headings in `<section>` elements with unique IDs.\n * @param externalGenerateID - Optional external ID generator (e.g. from MarkdownItPluginOpts).\n *   When provided, ensures all plugins share the same per-file generator.\n *   When omitted, uses random fallback behavior.\n * @returns Markdown-it core rule that injects section wrapper tokens around folding headings.\n */\nexport function createSectionsCoreRule(externalGenerateID?: IDGenerator): Core.RuleCore {\n    // Use the external generator if provided, otherwise use random fallback.\n    // Random IDs are the default behavior for production builds.\n    const generateID: IDGenerator =\n        externalGenerateID ?? (createIDGeneratorByStrategy('random') as IDGenerator);\n\n    return (state) => {\n        const Token = state.Token;\n        const tokens: typeof state.tokens = []; // output\n        const sections: Section[] = [];\n        let nestedLevel = 0;\n\n        for (const token of state.tokens) {\n            // record level of nesting\n            if (token.type.search(TokenType.Heading) !== 0) {\n                nestedLevel += token.nesting;\n            }\n            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n            if (last(sections) && nestedLevel < last(sections)!.nesting) {\n                closeSectionsToCurrentNesting(nestedLevel);\n            }\n\n            const hasFolding = token.markup.endsWith('#+');\n\n            // add sections before headers\n            if (token.type === TokenType.HeadingOpen) {\n                const section: Section = {\n                    header: headingLevel(token.tag),\n                    nesting: nestedLevel,\n                };\n                closeSections(section);\n                if (hasFolding) {\n                    tokens.push(openSection());\n                    sections.push(section);\n                }\n            }\n\n            tokens.push(token);\n\n            if (token.type === TokenType.HeadingClose && hasFolding) {\n                tokens.push(openContent());\n            }\n        }\n\n        // end for every token\n        closeAllSections();\n\n        if (state.tokens.length !== tokens.length) {\n            state.env ??= {};\n            state.env[ENV_FLAG_NAME] = true;\n        }\n\n        state.tokens = tokens;\n\n        function openSection() {\n            const t = new Token(TokenType.SectionOpen, 'section', 1);\n            t.attrPush(['class', SectionCN.Section]);\n            t.attrPush([SectionAttr.DataKey, DATA_KEY]);\n            t.attrPush([SectionAttr.DataId, generateID(DATA_KEY)]);\n            t.block = true;\n            return t;\n        }\n\n        function closeSection() {\n            const t = new Token(TokenType.SectionClose, 'section', -1);\n            t.block = true;\n            return t;\n        }\n\n        function openContent() {\n            const t = new Token(TokenType.ContentOpen, 'div', 1);\n            t.attrPush(['class', SectionCN.Content]);\n            t.block = true;\n            return t;\n        }\n\n        function closeContent() {\n            const t = new Token(TokenType.ContentClose, 'div', -1);\n            t.block = true;\n            return t;\n        }\n\n        function closeSections(section: Section) {\n            while (\n                last(sections) &&\n                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\n                section.header <= last(sections)!.header &&\n                // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion\n                section.nesting <= last(sections)!.nesting\n            ) {\n                sections.pop();\n                tokens.push(closeContent());\n                tokens.push(closeSection());\n            }\n        }\n\n        function closeSectionsToCurrentNesting(nesting: number) {\n            // eslint-disable-next-line  @typescript-eslint/no-non-null-assertion\n            while (last(sections) && nesting < last(sections)!.nesting) {\n                sections.pop();\n                tokens.push(closeContent());\n                tokens.push(closeSection());\n            }\n        }\n\n        function closeAllSections() {\n            while (sections.pop()) {\n                tokens.push(closeContent());\n                tokens.push(closeSection());\n            }\n        }\n    };\n}\n", "export function headingLevel(header: string) {\n    return parseInt(header.charAt(1), 10);\n}\n\nexport function last<T>(arr: T[]): T | undefined {\n    return arr[arr.length - 1];\n}\n\nexport function hidden<B extends Record<string | symbol, unknown>, F extends string | symbol, V>(\n    box: B,\n    field: F,\n    value: V,\n) {\n    if (!(field in box)) {\n        Object.defineProperty(box, field, {\n            enumerable: false,\n            value: value,\n        });\n    }\n\n    return box as B & Record<F, V>;\n}\n\nexport type Runtime = {\n    script: string;\n    style: string;\n};\n\ndeclare const __dirname: string;\nexport function copyRuntime(\n    {runtime, output}: {runtime: Runtime; output: string},\n    cache: Set<string>,\n) {\n    const PATH_TO_RUNTIME = '../runtime';\n    const {join, resolve} = dynrequire('node:path');\n    const runtimeFiles = {\n        'index.js': runtime.script,\n        'index.css': runtime.style,\n    };\n    for (const [originFile, outputFile] of Object.entries(runtimeFiles)) {\n        const file = join(PATH_TO_RUNTIME, originFile);\n        if (!cache.has(file)) {\n            cache.add(file);\n            copy(resolve(__dirname, file), join(output, outputFile));\n        }\n    }\n}\n\nexport function copy(from: string, to: string) {\n    const {mkdirSync, copyFileSync} = dynrequire('node:fs');\n    const {dirname} = dynrequire('node:path');\n\n    mkdirSync(dirname(to), {recursive: true});\n    copyFileSync(from, to);\n}\n\n/*\n * Runtime require hidden for builders.\n * Used for nodejs api\n */\nexport function dynrequire(module: string) {\n    // eslint-disable-next-line no-eval\n    return eval(`require('${module}')`);\n}\n", "import type MarkdownIt from 'markdown-it';\nimport type {IDGenerator} from '@diplodoc/utils';\n\nimport {headingBlockRule} from './headingBlockRule';\nimport {createSectionsCoreRule} from './sectionsCoreRule';\n\n/**\n * Creates a folding-heading plugin with an optional external ID generator.\n * When `generateID` is provided, all generated section IDs share the same counter\n * as other plugins, ensuring deterministic output regardless of --merge-includes.\n * When omitted, the plugin uses its internal fallback generator.\n *\n * @param generateID - Optional external ID generator shared with the rest of the transform pipeline.\n * @returns Markdown-it plugin that registers folding heading parsing and section wrapping rules.\n */\nexport function createFoldingHeadingPlugin(generateID?: IDGenerator) {\n    return (md: MarkdownIt) => {\n        md.block.ruler.at('heading', headingBlockRule, {\n            alt: ['paragraph', 'reference', 'blockquote'],\n        });\n        md.core.ruler.push('heading_sections', createSectionsCoreRule(generateID));\n    };\n}\n", "import type MarkdownIt from 'markdown-it';\nimport type {PluginWithOptions} from 'markdown-it';\nimport type {IDGenerator} from '@diplodoc/utils';\n\nimport {ENV_FLAG_NAME} from './const';\nimport {createFoldingHeadingPlugin} from './plugin';\nimport {type Runtime, copyRuntime, dynrequire, hidden} from './utils';\n\nconst registerTransform = (\n    md: MarkdownIt,\n    {\n        runtime,\n        bundle,\n        output,\n        generateID,\n    }: Pick<NormalizedPluginOptions, 'bundle' | 'runtime'> & {\n        output: string;\n        generateID?: IDGenerator;\n    },\n) => {\n    md.use(createFoldingHeadingPlugin(generateID));\n    md.core.ruler.push('heading_sections_after', ({env}) => {\n        hidden(env, 'bundled', new Set<string>());\n\n        if (env?.[ENV_FLAG_NAME]) {\n            env.meta = env.meta || {};\n            env.meta.script = env.meta.script || [];\n            env.meta.script.push(runtime.script);\n            env.meta.style = env.meta.style || [];\n            env.meta.style.push(runtime.style);\n\n            if (bundle) {\n                copyRuntime({runtime, output}, env.bundled);\n            }\n        }\n    });\n};\n\ntype NormalizedPluginOptions = Omit<TransformOptions, 'runtime'> & {\n    runtime: Runtime;\n};\n\nexport type TransformOptions = {\n    runtime?:\n        | string\n        | {\n              script: string;\n              style: string;\n          };\n    bundle?: boolean;\n};\n\ntype InputOptions = {\n    destRoot: string;\n};\n\nexport function transform(options: Partial<TransformOptions> = {}) {\n    const {bundle = true} = options;\n\n    if (bundle && typeof options.runtime === 'string') {\n        throw new TypeError('Option `runtime` should be record when `bundle` is enabled.');\n    }\n\n    const runtime: Runtime =\n        typeof options.runtime === 'string'\n            ? {script: options.runtime, style: options.runtime}\n            : options.runtime || {\n                  script: '_assets/folding-headings-extension.js',\n                  style: '_assets/folding-headings-extension.css',\n              };\n\n    const plugin: PluginWithOptions<{output?: string; generateID?: IDGenerator}> = function (\n        md: MarkdownIt,\n        {output = '.', generateID} = {},\n    ) {\n        registerTransform(md, {\n            runtime,\n            bundle,\n            output,\n            generateID,\n        });\n    };\n\n    Object.assign(plugin, {\n        collect(input: string, {destRoot = '.'}: InputOptions) {\n            const MdIt = dynrequire('markdown-it');\n            const md = new MdIt().use((md: MarkdownIt) => {\n                registerTransform(md, {\n                    runtime,\n                    bundle,\n                    output: destRoot,\n                });\n            });\n\n            md.parse(input, {});\n        },\n    });\n\n    return plugin;\n}\n"],
+  "mappings": "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",
   "names": ["md"]
 }

package/build/src/plugin/plugin.d.ts

@@ -1,2 +1,12 @@
-import type { PluginSimple } from 'markdown-it';
-export declare const foldingHeadingPlugin: PluginSimple;
+import type MarkdownIt from 'markdown-it';
+import type { IDGenerator } from '@diplodoc/utils';
+/**
+ * Creates a folding-heading plugin with an optional external ID generator.
+ * When `generateID` is provided, all generated section IDs share the same counter
+ * as other plugins, ensuring deterministic output regardless of --merge-includes.
+ * When omitted, the plugin uses its internal fallback generator.
+ *
+ * @param generateID - Optional external ID generator shared with the rest of the transform pipeline.
+ * @returns Markdown-it plugin that registers folding heading parsing and section wrapping rules.
+ */
+export declare function createFoldingHeadingPlugin(generateID?: IDGenerator): (md: MarkdownIt) => void;

package/build/src/plugin/sectionsCoreRule.d.ts

@@ -1,2 +1,10 @@
 import type Core from 'markdown-it/lib/parser_core';
-export declare const sectionsCoreRule: Core.RuleCore;
+import type { IDGenerator } from '@diplodoc/utils';
+/**
+ * Creates a core rule that wraps folding headings in `<section>` elements with unique IDs.
+ * @param externalGenerateID - Optional external ID generator (e.g. from MarkdownItPluginOpts).
+ *   When provided, ensures all plugins share the same per-file generator.
+ *   When omitted, uses random fallback behavior.
+ * @returns Markdown-it core rule that injects section wrapper tokens around folding headings.
+ */
+export declare function createSectionsCoreRule(externalGenerateID?: IDGenerator): Core.RuleCore;

package/build/src/plugin/transform.d.ts

@@ -1,4 +1,5 @@
 import type MarkdownIt from 'markdown-it';
+import type { IDGenerator } from '@diplodoc/utils';
 export type TransformOptions = {
     runtime?: string | {
         script: string;
@@ -8,4 +9,5 @@ export type TransformOptions = {
 };
 export declare function transform(options?: Partial<TransformOptions>): MarkdownIt.PluginWithOptions<{
     output?: string;
+    generateID?: IDGenerator;
 }>;

package/build/src/plugin/utils.d.ts

@@ -1,4 +1,3 @@
-export declare function generateID(): string;
 export declare function headingLevel(header: string): number;
 export declare function last<T>(arr: T[]): T | undefined;
 export declare function hidden<B extends Record<string | symbol, unknown>, F extends string | symbol, V>(box: B, field: F, value: V): B & Record<F, V>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diplodoc/folding-headings-extension",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Folding headings extension for Diplodoc platform ",
   "main": "build/plugin/index.js",
   "types": "build/plugin/index.d.ts",
@@ -41,19 +41,20 @@
     "test:watch": "vitest --config vitest.config.mjs",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "lint update && lint",
-    "lint:fix": "lint update && lint fix",
-    "pre-commit": "lint update && lint-staged",
-    "prepare": "husky"
+    "lint": "lint",
+    "lint:fix": "lint fix",
+    "pre-commit": "lint-staged",
+    "prepare": "husky || true"
   },
   "devDependencies": {
-    "@diplodoc/lint": "^1.14.1",
     "@diplodoc/tsconfig": "^1.0.2",
+    "@diplodoc/utils": "^2.2.2",
     "@types/markdown-it": "^13.0.9",
     "@vitest/coverage-v8": "^3.2.4",
     "markdown-it": "^13.0.0",
     "npm-run-all": "^4.1.5",
     "typescript": "^5.3.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@diplodoc/infra": "2.0.2"
   }
 }