@valkyrianlabs/payload-markdown 1.3.1

package/dist/core/plugins/remarkValidateDirectiveThemes.js

@@ -0,0 +1,28 @@
+import { visit } from 'unist-util-visit';
+import { layoutDirectiveRegistry } from '../../directives/registry.js';
+import { hasDirectiveTheme } from '../../directives/themes.js';
+function isContainerDirective(node) {
+    return Boolean(node && typeof node === 'object' && 'type' in node && node.type === 'containerDirective');
+}
+function warnUnknownThemes(node, file, config) {
+    const definition = layoutDirectiveRegistry.get(node.name);
+    if (!definition?.themeAttributes) return;
+    for (const [attribute, groupName] of Object.entries(definition.themeAttributes)){
+        if (!groupName) continue;
+        const value = node.attributes?.[attribute];
+        if (typeof value !== 'string' || !value.trim()) continue;
+        if (hasDirectiveTheme(groupName, value, config.themes)) continue;
+        const label = attribute === 'theme' ? 'theme' : attribute;
+        file.message(`Unknown ${label} "${value}" on "${node.name}". Falling back to "default".`);
+    }
+}
+export const remarkValidateDirectiveThemes = (config = {})=>{
+    return (tree, file)=>{
+        visit(tree, (node)=>{
+            if (!isContainerDirective(node)) return;
+            warnUnknownThemes(node, file, config);
+        });
+    };
+};
+
+//# sourceMappingURL=remarkValidateDirectiveThemes.js.map

package/dist/core/plugins/remarkValidateDirectiveThemes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/plugins/remarkValidateDirectiveThemes.ts"],"sourcesContent":["import type { Root } from 'mdast'\nimport type { ContainerDirective } from 'mdast-util-directive'\nimport type { Plugin } from 'unified'\n\nimport { visit } from 'unist-util-visit'\n\nimport type { MarkdownRenderConfig } from '../../types/core.js'\n\nimport { layoutDirectiveRegistry } from '../../directives/registry.js'\nimport { hasDirectiveTheme } from '../../directives/themes.js'\n\ntype MessageFile = {\n  message: (reason: string) => unknown\n}\n\nfunction isContainerDirective(node: unknown): node is ContainerDirective {\n  return Boolean(\n    node &&\n      typeof node === 'object' &&\n      'type' in node &&\n      (node as { type?: string }).type === 'containerDirective',\n  )\n}\n\nfunction warnUnknownThemes(node: ContainerDirective, file: MessageFile, config: MarkdownRenderConfig) {\n  const definition = layoutDirectiveRegistry.get(node.name)\n  if (!definition?.themeAttributes) return\n\n  for (const [attribute, groupName] of Object.entries(definition.themeAttributes)) {\n    if (!groupName) continue\n\n    const value = node.attributes?.[attribute]\n    if (typeof value !== 'string' || !value.trim()) continue\n    if (hasDirectiveTheme(groupName, value, config.themes)) continue\n\n    const label = attribute === 'theme' ? 'theme' : attribute\n\n    file.message(\n      `Unknown ${label} \"${value}\" on \"${node.name}\". Falling back to \"default\".`,\n    )\n  }\n}\n\nexport const remarkValidateDirectiveThemes: Plugin<[MarkdownRenderConfig?], Root> = (\n  config: MarkdownRenderConfig = {},\n) => {\n  return (tree, file) => {\n    visit(tree, (node) => {\n      if (!isContainerDirective(node)) return\n\n      warnUnknownThemes(node, file, config)\n    })\n  }\n}\n"],"names":["visit","layoutDirectiveRegistry","hasDirectiveTheme","isContainerDirective","node","Boolean","type","warnUnknownThemes","file","config","definition","get","name","themeAttributes","attribute","groupName","Object","entries","value","attributes","trim","themes","label","message","remarkValidateDirectiveThemes","tree"],"mappings":"AAIA,SAASA,KAAK,QAAQ,mBAAkB;AAIxC,SAASC,uBAAuB,QAAQ,+BAA8B;AACtE,SAASC,iBAAiB,QAAQ,6BAA4B;AAM9D,SAASC,qBAAqBC,IAAa;IACzC,OAAOC,QACLD,QACE,OAAOA,SAAS,YAChB,UAAUA,QACV,AAACA,KAA2BE,IAAI,KAAK;AAE3C;AAEA,SAASC,kBAAkBH,IAAwB,EAAEI,IAAiB,EAAEC,MAA4B;IAClG,MAAMC,aAAaT,wBAAwBU,GAAG,CAACP,KAAKQ,IAAI;IACxD,IAAI,CAACF,YAAYG,iBAAiB;IAElC,KAAK,MAAM,CAACC,WAAWC,UAAU,IAAIC,OAAOC,OAAO,CAACP,WAAWG,eAAe,EAAG;QAC/E,IAAI,CAACE,WAAW;QAEhB,MAAMG,QAAQd,KAAKe,UAAU,EAAE,CAACL,UAAU;QAC1C,IAAI,OAAOI,UAAU,YAAY,CAACA,MAAME,IAAI,IAAI;QAChD,IAAIlB,kBAAkBa,WAAWG,OAAOT,OAAOY,MAAM,GAAG;QAExD,MAAMC,QAAQR,cAAc,UAAU,UAAUA;QAEhDN,KAAKe,OAAO,CACV,CAAC,QAAQ,EAAED,MAAM,EAAE,EAAEJ,MAAM,MAAM,EAAEd,KAAKQ,IAAI,CAAC,6BAA6B,CAAC;IAE/E;AACF;AAEA,OAAO,MAAMY,gCAAuE,CAClFf,SAA+B,CAAC,CAAC;IAEjC,OAAO,CAACgB,MAAMjB;QACZR,MAAMyB,MAAM,CAACrB;YACX,IAAI,CAACD,qBAAqBC,OAAO;YAEjCG,kBAAkBH,MAAMI,MAAMC;QAChC;IACF;AACF,EAAC"}

package/dist/core/renderMarkdown.d.ts

@@ -0,0 +1,2 @@
+import type { MarkdownRenderConfig, RenderMarkdownResult } from '../types/core.js';
+export declare function compileMarkdown(markdown: string, config?: MarkdownRenderConfig): Promise<RenderMarkdownResult>;

package/dist/core/renderMarkdown.js

@@ -0,0 +1,270 @@
+import { fromHtml } from 'hast-util-from-html';
+import { toString } from 'hast-util-to-string';
+import rehypeRaw from 'rehype-raw';
+import rehypeSanitize, { defaultSchema } from 'rehype-sanitize';
+import rehypeStringify from 'rehype-stringify';
+import remarkGfm from 'remark-gfm';
+import remarkParse from 'remark-parse';
+import remarkRehype from 'remark-rehype';
+import { unified } from 'unified';
+import { visit } from 'unist-util-visit';
+import { resolveRenderMarkdownOptions } from './codeConfig.js';
+import { codeToHtml } from './codeToHtml.js';
+import { rehypeApplyLayoutClasses } from './plugins/rehypeApplyLayoutClasses.js';
+import { rehypeStripAuthoredInlineStyles } from './plugins/rehypeStripAuthoredInlineStyles.js';
+import { remarkCompileLayouts } from './plugins/remarkCompileLayouts.js';
+import { remarkHeadingAnchorsAndToc } from './plugins/remarkHeadingAnchorsAndToc.js';
+import { remarkLayoutDirectives } from './plugins/remarkLayoutDirectives.js';
+import { remarkLiftLayoutDirectives } from './plugins/remarkLiftLayoutDirectives.js';
+import { remarkValidateDirectiveThemes } from './plugins/remarkValidateDirectiveThemes.js';
+function extractCodeLanguage(className) {
+    const classes = typeof className === 'string' ? className.split(/\s+/) : Array.isArray(className) ? className : [];
+    return classes.find((c)=>typeof c === 'string' && c.startsWith('language-'))?.slice(9);
+}
+function isElement(node) {
+    return node.type === 'element';
+}
+function isPreElement(node) {
+    return isElement(node) && node.tagName === 'pre';
+}
+function hasChildren(node) {
+    return Boolean(node && typeof node === 'object' && 'children' in node);
+}
+function findCodeChild(node) {
+    return node.children.find((child)=>child.type === 'element' && child.tagName === 'code');
+}
+function parseHtmlFragment(html) {
+    const fragment = fromHtml(html, {
+        fragment: true
+    });
+    return fragment.children;
+}
+function rehypeShikiCodeBlocks(options = {}) {
+    return async function transformer(tree) {
+        const work = [];
+        visit(tree, 'element', (node, index, parent)=>{
+            if (typeof index !== 'number' || !hasChildren(parent) || !isPreElement(node)) return;
+            const codeNode = findCodeChild(node);
+            if (!codeNode) return;
+            const code = toString(codeNode);
+            const lang = extractCodeLanguage(codeNode.properties?.className);
+            work.push((async ()=>{
+                const highlighted = await codeToHtml(code, {
+                    ...options,
+                    lang
+                });
+                const replacementNodes = parseHtmlFragment(highlighted);
+                parent.children.splice(index, 1, ...replacementNodes);
+            })());
+        });
+        await Promise.all(work);
+    };
+}
+function getAttributeDefinitions(value) {
+    return value ?? [];
+}
+const sanitizeSchema = {
+    ...defaultSchema,
+    attributes: {
+        ...defaultSchema.attributes ?? {},
+        a: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.a ?? []),
+            'href',
+            'target',
+            'rel',
+            'title'
+        ],
+        article: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.article ?? []),
+            'className',
+            'dataDirective',
+            'dataEyebrow',
+            'dataHref',
+            'dataStepCard',
+            'dataTabPanel',
+            'dataTabValue',
+            'dataTheme',
+            'dataTitle',
+            'dataVlLayout',
+            'hidden',
+            'id',
+            'role',
+            'tabIndex'
+        ],
+        button: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.button ?? []),
+            'ariaControls',
+            'ariaSelected',
+            'className',
+            'dataTabTrigger',
+            'dataTabValue',
+            'disabled',
+            'id',
+            'role',
+            'tabIndex',
+            'type'
+        ],
+        code: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.code ?? []),
+            'className'
+        ],
+        details: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.details ?? []),
+            'dataDirective',
+            'dataTheme',
+            'dataTitle',
+            'dataVlLayout',
+            'open'
+        ],
+        div: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.div ?? []),
+            'dataDirective',
+            'dataDirectiveBody',
+            'dataDirectiveTitle',
+            'dataEyebrow',
+            'dataHref',
+            'dataCellTheme',
+            'dataTabsList',
+            'dataTabPanel',
+            'dataTabTrigger',
+            'dataTabValue',
+            'dataTheme',
+            'dataTitle',
+            'dataVariant',
+            'dataVlLayout',
+            'dataVlCellHeadingDepth',
+            'hidden',
+            'id',
+            'role',
+            'tabIndex'
+        ],
+        h1: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h1 ?? []),
+            'dataDirectiveTitle',
+            'dataHeadingAnchor',
+            'id'
+        ],
+        h2: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h2 ?? []),
+            'dataDirectiveTitle',
+            'dataHeadingAnchor',
+            'id'
+        ],
+        h3: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h3 ?? []),
+            'dataDirectiveTitle',
+            'dataHeadingAnchor',
+            'id'
+        ],
+        h4: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h4 ?? []),
+            'dataHeadingAnchor',
+            'id'
+        ],
+        h5: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h5 ?? []),
+            'dataHeadingAnchor',
+            'id'
+        ],
+        h6: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.h6 ?? []),
+            'dataHeadingAnchor',
+            'id'
+        ],
+        img: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.img ?? []),
+            'src',
+            'alt',
+            'title',
+            'width',
+            'height'
+        ],
+        li: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.li ?? []),
+            'dataStep'
+        ],
+        nav: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.nav ?? []),
+            'ariaLabel',
+            'dataDirective',
+            'dataTheme',
+            'dataTitle',
+            'dataVlLayout'
+        ],
+        p: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.p ?? []),
+            'className',
+            'dataDirectiveEyebrow'
+        ],
+        pre: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.pre ?? []),
+            'className',
+            'tabindex'
+        ],
+        section: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.section ?? []),
+            'dataColumns',
+            'dataCardTheme',
+            'dataCellTheme',
+            'dataDefault',
+            'dataDisabled',
+            'dataDirective',
+            'dataLabel',
+            'dataLayout',
+            'dataNumbered',
+            'dataStepTheme',
+            'dataTabTheme',
+            'dataTabValue',
+            'dataTheme',
+            'dataVariant',
+            'dataValue',
+            'dataVlLayout',
+            'dataVlCellHeadingDepth',
+            'role'
+        ],
+        span: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.span ?? []),
+            'className',
+            'dataStepNumber',
+            'style'
+        ],
+        summary: [
+            ...getAttributeDefinitions(defaultSchema.attributes?.summary ?? []),
+            'className'
+        ]
+    },
+    clobberPrefix: '',
+    tagNames: [
+        ...defaultSchema.tagNames ?? [],
+        'a',
+        'article',
+        'br',
+        'button',
+        'details',
+        'img',
+        'nav',
+        'section',
+        'span',
+        'summary'
+    ]
+};
+export async function compileMarkdown(markdown, config = {}) {
+    const warnings = [];
+    try {
+        const file = await unified().use(remarkParse).use(remarkGfm).use(remarkLiftLayoutDirectives).use(remarkCompileLayouts).use(remarkLayoutDirectives).use(remarkValidateDirectiveThemes, config).use(remarkHeadingAnchorsAndToc).use(remarkRehype, {
+            allowDangerousHtml: true
+        }).use(rehypeRaw).use(rehypeStripAuthoredInlineStyles).use(rehypeShikiCodeBlocks, resolveRenderMarkdownOptions(config)).use(rehypeSanitize, sanitizeSchema).use(rehypeApplyLayoutClasses, config).use(rehypeStringify).process(markdown);
+        return {
+            html: String(file),
+            warnings: file.messages.map((message)=>message.reason)
+        };
+    } catch (error) {
+        warnings.push(error instanceof Error ? error.message : 'Failed to render markdown.');
+        return {
+            html: '<p>Failed to render markdown.</p>',
+            warnings
+        };
+    }
+}
+
+//# sourceMappingURL=renderMarkdown.js.map

package/dist/core/renderMarkdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/renderMarkdown.ts"],"sourcesContent":["import type { Element, Parent, Root, RootContent } from 'hast'\nimport type { Schema } from 'hast-util-sanitize'\n\nimport { fromHtml } from 'hast-util-from-html'\nimport { toString } from 'hast-util-to-string'\nimport rehypeRaw from 'rehype-raw'\nimport rehypeSanitize, { defaultSchema } from 'rehype-sanitize'\nimport rehypeStringify from 'rehype-stringify'\nimport remarkGfm from 'remark-gfm'\nimport remarkParse from 'remark-parse'\nimport remarkRehype from 'remark-rehype'\nimport { unified } from 'unified'\nimport { visit } from 'unist-util-visit'\n\nimport type { MarkdownRenderConfig, RenderMarkdownOptions, RenderMarkdownResult } from '../types/core.js'\n\nimport { resolveRenderMarkdownOptions } from './codeConfig.js'\nimport { codeToHtml } from './codeToHtml.js'\nimport { rehypeApplyLayoutClasses } from './plugins/rehypeApplyLayoutClasses.js'\nimport { rehypeStripAuthoredInlineStyles } from './plugins/rehypeStripAuthoredInlineStyles.js'\nimport { remarkCompileLayouts } from './plugins/remarkCompileLayouts.js'\nimport { remarkHeadingAnchorsAndToc } from './plugins/remarkHeadingAnchorsAndToc.js'\nimport { remarkLayoutDirectives } from './plugins/remarkLayoutDirectives.js'\nimport { remarkLiftLayoutDirectives } from './plugins/remarkLiftLayoutDirectives.js'\nimport { remarkValidateDirectiveThemes } from './plugins/remarkValidateDirectiveThemes.js'\n\nfunction extractCodeLanguage(\n  className?: Array<number | string> | boolean | null | number | string  ,\n): string | undefined {\n  const classes =\n    typeof className === 'string'\n      ? className.split(/\\s+/)\n      : Array.isArray(className)\n        ? className\n        : []\n\n  return classes\n    .find((c): c is string => typeof c === 'string' && c.startsWith('language-'))\n    ?.slice(9)\n}\n\nfunction isElement(node: RootContent): node is Element {\n  return node.type === 'element'\n}\n\nfunction isPreElement(node: RootContent): node is Element {\n  return isElement(node) && node.tagName === 'pre'\n}\n\nfunction hasChildren(node: unknown): node is Parent {\n  return Boolean(node && typeof node === 'object' && 'children' in node)\n}\n\nfunction findCodeChild(node: Element): Element | undefined {\n  return node.children.find(\n    (child): child is Element => child.type === 'element' && child.tagName === 'code',\n  )\n}\n\nfunction parseHtmlFragment(html: string): RootContent[] {\n  const fragment = fromHtml(html, { fragment: true })\n  return fragment.children\n}\n\nfunction rehypeShikiCodeBlocks(options: RenderMarkdownOptions = {}) {\n  return async function transformer(tree: Root): Promise<void> {\n    const work: Array<Promise<void>> = []\n\n    visit(tree, 'element', (node, index, parent) => {\n      if (typeof index !== 'number' || !hasChildren(parent) || !isPreElement(node)) return\n\n      const codeNode = findCodeChild(node)\n      if (!codeNode) return\n\n      const code = toString(codeNode)\n      const lang = extractCodeLanguage(codeNode.properties?.className)\n\n      work.push(\n        (async () => {\n          const highlighted = await codeToHtml(code, {\n            ...options,\n            lang\n          })\n\n          const replacementNodes = parseHtmlFragment(highlighted)\n          parent.children.splice(index, 1, ...replacementNodes)\n        })(),\n      )\n    })\n\n    await Promise.all(work)\n  }\n}\n\ntype SanitizeAttributeValue = boolean | null | number | RegExp | string | undefined\ntype SanitizeAttributeDefinition = [string, ...SanitizeAttributeValue[]] | string\n\nfunction getAttributeDefinitions(\n  value: Schema['attributes'] extends infer A\n    ? A extends Record<string, infer V>\n      ? V\n      : never\n    : never,\n): SanitizeAttributeDefinition[] {\n  return (value as SanitizeAttributeDefinition[] | undefined) ?? []\n}\n\nconst sanitizeSchema: Schema = {\n  ...defaultSchema,\n  attributes: {\n    ...(defaultSchema.attributes ?? {}),\n    a: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.a ?? []),\n      'href',\n      'target',\n      'rel',\n      'title',\n    ],\n    article: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.article ?? []),\n      'className',\n      'dataDirective',\n      'dataEyebrow',\n      'dataHref',\n      'dataStepCard',\n      'dataTabPanel',\n      'dataTabValue',\n      'dataTheme',\n      'dataTitle',\n      'dataVlLayout',\n      'hidden',\n      'id',\n      'role',\n      'tabIndex',\n    ],\n    button: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.button ?? []),\n      'ariaControls',\n      'ariaSelected',\n      'className',\n      'dataTabTrigger',\n      'dataTabValue',\n      'disabled',\n      'id',\n      'role',\n      'tabIndex',\n      'type',\n    ],\n    code: [...getAttributeDefinitions(defaultSchema.attributes?.code ?? []), 'className'],\n    details: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.details ?? []),\n      'dataDirective',\n      'dataTheme',\n      'dataTitle',\n      'dataVlLayout',\n      'open',\n    ],\n    div: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.div ?? []),\n      'dataDirective',\n      'dataDirectiveBody',\n      'dataDirectiveTitle',\n      'dataEyebrow',\n      'dataHref',\n      'dataCellTheme',\n      'dataTabsList',\n      'dataTabPanel',\n      'dataTabTrigger',\n      'dataTabValue',\n      'dataTheme',\n      'dataTitle',\n      'dataVariant',\n      'dataVlLayout',\n      'dataVlCellHeadingDepth',\n      'hidden',\n      'id',\n      'role',\n      'tabIndex',\n    ],\n    h1: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.h1 ?? []),\n      'dataDirectiveTitle',\n      'dataHeadingAnchor',\n      'id',\n    ],\n    h2: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.h2 ?? []),\n      'dataDirectiveTitle',\n      'dataHeadingAnchor',\n      'id',\n    ],\n    h3: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.h3 ?? []),\n      'dataDirectiveTitle',\n      'dataHeadingAnchor',\n      'id',\n    ],\n    h4: [...getAttributeDefinitions(defaultSchema.attributes?.h4 ?? []), 'dataHeadingAnchor', 'id'],\n    h5: [...getAttributeDefinitions(defaultSchema.attributes?.h5 ?? []), 'dataHeadingAnchor', 'id'],\n    h6: [...getAttributeDefinitions(defaultSchema.attributes?.h6 ?? []), 'dataHeadingAnchor', 'id'],\n    img: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.img ?? []),\n      'src',\n      'alt',\n      'title',\n      'width',\n      'height',\n    ],\n    li: [...getAttributeDefinitions(defaultSchema.attributes?.li ?? []), 'dataStep'],\n    nav: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.nav ?? []),\n      'ariaLabel',\n      'dataDirective',\n      'dataTheme',\n      'dataTitle',\n      'dataVlLayout',\n    ],\n    p: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.p ?? []),\n      'className',\n      'dataDirectiveEyebrow',\n    ],\n    pre: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.pre ?? []),\n      'className',\n      'tabindex',\n    ],\n    section: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.section ?? []),\n      'dataColumns',\n      'dataCardTheme',\n      'dataCellTheme',\n      'dataDefault',\n      'dataDisabled',\n      'dataDirective',\n      'dataLabel',\n      'dataLayout',\n      'dataNumbered',\n      'dataStepTheme',\n      'dataTabTheme',\n      'dataTabValue',\n      'dataTheme',\n      'dataVariant',\n      'dataValue',\n      'dataVlLayout',\n      'dataVlCellHeadingDepth',\n      'role',\n    ],\n    span: [\n      ...getAttributeDefinitions(defaultSchema.attributes?.span ?? []),\n      'className',\n      'dataStepNumber',\n      'style',\n    ],\n    summary: [...getAttributeDefinitions(defaultSchema.attributes?.summary ?? []), 'className'],\n  },\n  clobberPrefix: '',\n  tagNames: [\n    ...(defaultSchema.tagNames ?? []),\n    'a',\n    'article',\n    'br',\n    'button',\n    'details',\n    'img',\n    'nav',\n    'section',\n    'span',\n    'summary',\n  ],\n}\n\nexport async function compileMarkdown(\n  markdown: string,\n  config: MarkdownRenderConfig = {},\n): Promise<RenderMarkdownResult> {\n  const warnings: string[] = []\n\n  try {\n    const file = await unified()\n      .use(remarkParse)\n      .use(remarkGfm)\n      .use(remarkLiftLayoutDirectives)\n      .use(remarkCompileLayouts)\n      .use(remarkLayoutDirectives)\n      .use(remarkValidateDirectiveThemes, config)\n      .use(remarkHeadingAnchorsAndToc)\n      .use(remarkRehype, { allowDangerousHtml: true })\n      .use(rehypeRaw)\n      .use(rehypeStripAuthoredInlineStyles)\n      .use(rehypeShikiCodeBlocks, resolveRenderMarkdownOptions(config))\n      .use(rehypeSanitize, sanitizeSchema)\n      .use(rehypeApplyLayoutClasses, config)\n      .use(rehypeStringify)\n      .process(markdown)\n\n    return {\n      html: String(file),\n      warnings: file.messages.map((message) => message.reason),\n    }\n  } catch (error) {\n    warnings.push(error instanceof Error ? error.message : 'Failed to render markdown.')\n\n    return {\n      html: '<p>Failed to render markdown.</p>',\n      warnings,\n    }\n  }\n}\n"],"names":["fromHtml","toString","rehypeRaw","rehypeSanitize","defaultSchema","rehypeStringify","remarkGfm","remarkParse","remarkRehype","unified","visit","resolveRenderMarkdownOptions","codeToHtml","rehypeApplyLayoutClasses","rehypeStripAuthoredInlineStyles","remarkCompileLayouts","remarkHeadingAnchorsAndToc","remarkLayoutDirectives","remarkLiftLayoutDirectives","remarkValidateDirectiveThemes","extractCodeLanguage","className","classes","split","Array","isArray","find","c","startsWith","slice","isElement","node","type","isPreElement","tagName","hasChildren","Boolean","findCodeChild","children","child","parseHtmlFragment","html","fragment","rehypeShikiCodeBlocks","options","transformer","tree","work","index","parent","codeNode","code","lang","properties","push","highlighted","replacementNodes","splice","Promise","all","getAttributeDefinitions","value","sanitizeSchema","attributes","a","article","button","details","div","h1","h2","h3","h4","h5","h6","img","li","nav","p","pre","section","span","summary","clobberPrefix","tagNames","compileMarkdown","markdown","config","warnings","file","use","allowDangerousHtml","process","String","messages","map","message","reason","error","Error"],"mappings":"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"}

package/dist/core/types.d.js

@@ -0,0 +1,7 @@
+/**
+ * @import {} from 'mdast-util-directive'
+ */ /**
+ * Props for the markdown block component wrapper.
+ */ export { };
+
+//# sourceMappingURL=types.d.js.map

package/dist/core/types.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/types.d.ts"],"sourcesContent":["/**\n * @import {} from 'mdast-util-directive'\n */\n\nimport type { JSX, ReactNode } from 'react'\n\nexport type MarkdownRendererScope = 'blocks' | 'field'\n\n/**\n * Options that control how fenced code blocks are rendered inside markdown content.\n *\n * By default, code blocks use the plugin's enhanced rendering mode:\n * - `highlightLines` defaults to `false`\n * - `lineNumbers` defaults to `true`\n * - `prettyCodeBlocks` defaults to `true`\n * - `theme` defaults to `'github-dark'`\n *\n * These options are passed through the markdown rendering pipeline and primarily\n * affect Shiki-rendered code fences.\n */\nexport type RenderMarkdownOptions = {\n  /**\n   * Whether to preserve Shiki-provided per-line background highlighting.\n   *\n   * Defaults to `false`.\n   *\n   * When disabled, background styles are stripped from highlighted lines and token\n   * spans so code blocks integrate more cleanly with the surrounding site design.\n   */\n  highlightLines?: boolean\n\n  /**\n   * Whether to show line numbers for fenced code blocks.\n   *\n   * Defaults to `true`.\n   */\n  lineNumbers?: boolean\n\n  /**\n   * Whether to apply the plugin's enhanced code block formatting.\n   *\n   * Defaults to `true`.\n   *\n   * When enabled, the renderer normalizes Shiki output for better integration with\n   * markdown prose styling. This includes adjustments such as background removal,\n   * spacing cleanup, line layout normalization, and other structural fixes needed\n   * for features like line numbers and consistent empty-line rendering.\n   *\n   * Set this to `false` if you want to preserve raw Shiki block styling as much as\n   * possible.\n   */\n  prettyCodeBlocks?: boolean\n\n  /**\n   * The Shiki theme to use for syntax highlighting.\n   *\n   * Defaults to `'github-dark'`.\n   *\n   * Note that this plugin is optimized around themes that still look good when block\n   * backgrounds are removed or reduced. Some light themes may require additional\n   * customization to maintain good contrast and readability.\n   */\n  theme?: string\n}\n\n/**\n * The result of compiling markdown into sanitized HTML.\n */\nexport type RenderMarkdownResult = {\n  /**\n   * The rendered HTML output.\n   */\n  html: string\n\n  /**\n   * Non-fatal warnings produced during rendering.\n   */\n  warnings: string[]\n}\n\n/**\n * Preset visual styles for rendered markdown content.\n */\nexport type MarkdownVariant = 'blog' | 'compact' | 'docs' | 'unstyled'\n\n/**\n * Preset typography sizes for rendered markdown content.\n */\nexport type MarkdownSize = 'lg' | 'md' | 'sm'\n\n/**\n * Core markdown presentation configuration.\n *\n * This type represents the configurable styling and behavior layer that can be\n * sourced from plugin defaults, globals, collection defaults, or block-level\n * overrides. It intentionally excludes runtime-only renderer props such as\n * `markdown`, `as`, and fallback nodes.\n */\nexport type MarkdownConfig = {\n  /**\n   * Whether to center the rendered markdown container within its wrapper.\n   *\n   * Defaults to `false`.\n   */\n  centered?: boolean\n\n  /**\n   * Additional classes applied to the rendered markdown element itself.\n   */\n  className?: string\n\n  /**\n   * Additional classes applied to column elements within the rendered markdown, if applicable.\n   */\n  columnClassName?: string\n\n  /**\n   * Whether to apply horizontal gutter padding to the outer wrapper.\n   *\n   * Defaults to `false`.\n   */\n  enableGutter?: boolean\n\n  /**\n   * Whether fenced code blocks should extend beyond the normal content width\n   * on larger screens.\n   *\n   * Defaults to `false`.\n   */\n  fullBleedCode?: boolean\n\n  /**\n   * Optional content rendered above the markdown body.\n   */\n  lead?: ReactNode\n\n  /**\n   * Whether heading colors should be slightly muted.\n   *\n   * Defaults to `false`.\n   */\n  mutedHeadings?: boolean\n\n  /**\n   * Options that control fenced code block rendering.\n   */\n  options?: RenderMarkdownOptions\n\n  /**\n   * Additional classes applied to section elements within the rendered markdown, if applicable.\n   */\n  sectionClassName?: string\n\n  /**\n   * Typography size preset for the rendered markdown.\n   *\n   * Defaults to `'lg'`.\n   */\n  size?: MarkdownSize\n\n  /**\n   * Visual style preset for the rendered markdown.\n   *\n   * Defaults to `'blog'`.\n   */\n  variant?: MarkdownVariant\n\n  /**\n   * Additional classes applied to the outer wrapper element.\n   */\n  wrapperClassName?: string\n}\n\n/**\n * Runtime-only props shared by markdown renderer components.\n */\nexport type BaseMarkdownRendererProps = {\n  /**\n   * The HTML tag used for the rendered markdown container.\n   *\n   * Defaults to `'article'`.\n   */\n  as?: keyof JSX.IntrinsicElements\n\n  /**\n   * Content rendered when the markdown input is empty or missing.\n   */\n  emptyFallback?: ReactNode\n\n  /**\n   * Content rendered when markdown compilation fails and a fallback is desired.\n   */\n  errorFallback?: ReactNode\n\n  /**\n   * The markdown source string to render.\n   */\n  markdown?: null | string\n}\n\n/**\n * Props for the main markdown renderer component.\n *\n * This merges persisted/configurable markdown presentation settings with the\n * runtime-only rendering props required by the component itself.\n */\nexport type MarkdownRendererProps = {\n    collectionSlug?: string\n    scope?: MarkdownRendererScope\n  } & BaseMarkdownRendererProps & MarkdownConfig\n\n/**\n * Options available while rendering an individual fenced code block.\n */\nexport interface CodeBlockOptions extends RenderMarkdownOptions {\n  /**\n   * The parsed language identifier for the fenced code block, if present.\n   */\n  lang?: string\n}\n\n/**\n * Stored Payload block data for a markdown block instance.\n */\nexport interface MarkdownBlockData {\n  /**\n   * Optional block display name assigned by Payload.\n   */\n  blockName?: null | string\n\n  /**\n   * The Payload block slug.\n   */\n  blockType: '@valkyrianlabs/markdown-block'\n\n  /**\n   * Markdown source content for this block.\n   */\n  content: string\n\n  /**\n   * Optional Payload-generated block identifier.\n   */\n  id?: null | string\n}\n\n/**\n * Props for the markdown block component wrapper.\n */\nexport interface MarkdownBlockProps {\n  /**\n   * Stored block data from Payload.\n   */\n  block: MarkdownBlockData\n\n  /**\n   * The slug of the collection this block is rendered within, if applicable.\n   */\n  collectionSlug?: string\n\n  /**\n   * Default markdown configuration, typically sourced from global or collection-level settings.\n   */\n  defaults?: MarkdownConfig\n\n  /**\n   * Block-specific markdown configuration overrides.\n   */\n  overrides?: MarkdownConfig\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAoPD;;CAEC,GACD,WAoBC"}

package/dist/core/types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * @import {} from 'mdast-util-directive'
+ */
+import type { JSX, ReactNode } from 'react';
+import 'mdast-util-directive';
+declare module 'mdast-util-directive' {
+    interface ContainerDirectiveData {
+        vlCellHeadingDepth?: number;
+        vlParentHeadingDepth?: number;
+    }
+}
+export type MarkdownRendererScope = 'blocks' | 'field';
+/**
+ * Options that control how fenced code blocks are rendered inside markdown content.
+ *
+ * By default, code blocks use the plugin's enhanced rendering mode:
+ * - `enhancedCodeBlocks` defaults to `true`
+ * - `lineNumbers` defaults to `true`
+ * - `theme` defaults to `'github-dark'`
+ *
+ * When enhanced rendering is enabled, the plugin applies its normalized code block
+ * pipeline on top of Shiki output. This includes layout cleanup, background
+ * normalization, and support for features like line numbers.
+ *
+ * When enhanced rendering is disabled, code blocks are rendered closer to raw
+ * Shiki output and plugin-specific enhancements are bypassed.
+ *
+ * These options are passed through the markdown rendering pipeline and primarily
+ * affect Shiki-rendered code fences.
+ */
+export type RenderMarkdownOptions = {
+    /**
+     * Whether to apply the plugin's enhanced code block rendering pipeline.
+     *
+     * Defaults to `true`.
+     *
+     * When enabled, the renderer performs structural and visual normalization on
+     * Shiki output to produce a consistent, content-focused appearance.
+     *
+     * When disabled, code blocks are rendered closer to raw Shiki output.
+     */
+    enhancedCodeBlocks?: boolean;
+    /**
+     * An optional list of language identifiers to load for Shiki syntax highlighting.
+     *
+     * By default, the plugin loads a core set of popular languages. You can replace
+     * that set entirely or extend it using spread syntax:
+     *
+     * ```ts
+     * options: {
+     *   langs: [...DEFAULT_CODE_LANGS, 'latex']
+     * }
+     * ```
+     */
+    langs?: string[];
+    /**
+     * Whether to show line numbers for fenced code blocks.
+     *
+     * Defaults to `true` when `enhancedCodeBlocks` is enabled.
+     *
+     * Line numbers require the enhanced rendering pipeline and are automatically
+     * disabled when `enhancedCodeBlocks` is set to `false`.
+     */
+    lineNumbers?: boolean;
+    /**
+     * The Shiki theme to use for syntax highlighting.
+     *
+     * Defaults to `'github-dark'`.
+     *
+     * The plugin's enhanced renderer is tuned around its default theme. When using a
+     * non-default theme:
+     *
+     * - `enhancedCodeBlocks: true` opts into the plugin's normalized rendering pipeline
+     * - `enhancedCodeBlocks: false` preserves the theme's native appearance more closely
+     *
+     * This allows you to choose between a more controlled presentation and a more
+     * theme-faithful rendering mode.
+     */
+    theme?: string;
+};
+/**
+ * The result of compiling markdown into sanitized HTML.
+ */
+export type RenderMarkdownResult = {
+    /**
+     * The rendered HTML output.
+     */
+    html: string;
+    /**
+     * Non-fatal warnings produced during rendering.
+     */
+    warnings: string[];
+};
+/**
+ * Preset visual styles for rendered markdown content.
+ */
+export type MarkdownVariant = 'blog' | 'compact' | 'docs' | 'unstyled';
+/**
+ * Preset typography sizes for rendered markdown content.
+ */
+export type MarkdownSize = 'lg' | 'md' | 'sm';
+/**
+ * Core markdown presentation configuration.
+ *
+ * This type represents the configurable styling and behavior layer that can be
+ * sourced from plugin defaults, globals, collection defaults, or block-level
+ * overrides. It intentionally excludes runtime-only renderer props such as
+ * `markdown`, `as`, and fallback nodes.
+ */
+export type MarkdownConfig = {
+    /**
+     * Additional classes applied to the rendered markdown element itself.
+     */
+    className?: string;
+    /**
+     * Additional classes applied to column elements within the rendered markdown, if applicable.
+     */
+    columnClassName?: string;
+    /**
+     * Whether to apply horizontal gutter padding to the outer wrapper.
+     *
+     * Defaults to `false`.
+     */
+    enableGutter?: boolean;
+    /**
+     * Whether fenced code blocks should extend beyond the normal content width
+     * on larger screens.
+     *
+     * Defaults to `false`.
+     */
+    fullBleedCode?: boolean;
+    /**
+     * Optional content rendered above the markdown body.
+     */
+    lead?: ReactNode;
+    /**
+     * Whether heading colors should be slightly muted.
+     *
+     * Defaults to `false`.
+     */
+    mutedHeadings?: boolean;
+    /**
+     * Options that control fenced code block rendering.
+     */
+    options?: RenderMarkdownOptions;
+    /**
+     * Additional classes applied to section elements within the rendered markdown, if applicable.
+     */
+    sectionClassName?: string;
+    /**
+     * Typography size preset for the rendered markdown.
+     *
+     * Defaults to `'lg'`.
+     */
+    size?: MarkdownSize;
+    /**
+     * Visual style preset for the rendered markdown.
+     *
+     * Defaults to `'blog'`.
+     */
+    variant?: MarkdownVariant;
+    /**
+     * Additional classes applied to the outer wrapper element.
+     */
+    wrapperClassName?: string;
+};
+/**
+ * Runtime-only props shared by markdown renderer components.
+ */
+export type BaseMarkdownRendererProps = {
+    /**
+     * The HTML tag used for the rendered markdown container.
+     *
+     * Defaults to `'article'`.
+     */
+    as?: keyof JSX.IntrinsicElements;
+    /**
+     * Content rendered when the markdown input is empty or missing.
+     */
+    emptyFallback?: ReactNode;
+    /**
+     * Content rendered when markdown compilation fails and a fallback is desired.
+     */
+    errorFallback?: ReactNode;
+    /**
+     * The markdown source string to render.
+     */
+    markdown?: null | string;
+};
+/**
+ * Props for the main markdown renderer component.
+ *
+ * This merges persisted/configurable markdown presentation settings with the
+ * runtime-only rendering props required by the component itself.
+ */
+export type MarkdownRendererProps = {
+    collectionSlug?: string;
+    scope?: MarkdownRendererScope;
+} & BaseMarkdownRendererProps & MarkdownConfig;
+/**
+ * Options available while rendering an individual fenced code block.
+ */
+export interface CodeBlockOptions extends RenderMarkdownOptions {
+    /**
+     * The parsed language identifier for the fenced code block, if present.
+     */
+    lang?: string;
+}
+/**
+ * Stored Payload block data for a markdown block instance.
+ */
+export interface MarkdownBlockData {
+    /**
+     * Optional block display name assigned by Payload.
+     */
+    blockName?: null | string;
+    /**
+     * The Payload block slug.
+     */
+    blockType: 'vlMdBlock';
+    /**
+     * Markdown source content for this block.
+     */
+    content: string;
+    /**
+     * Optional Payload-generated block identifier.
+     */
+    id?: null | string;
+}
+/**
+ * Props for the markdown block component wrapper.
+ */
+export interface MarkdownBlockProps extends MarkdownBlockData {
+    /**
+     * The slug of the collection this block is rendered within, if applicable.
+     */
+    collectionSlug?: string;
+}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * @import {} from 'mdast-util-directive'
+ */ import 'mdast-util-directive';
+
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * @import {} from 'mdast-util-directive'\n */\n\nimport type { JSX, ReactNode } from 'react'\n\nimport 'mdast-util-directive'\n\ndeclare module 'mdast-util-directive' {\n  interface ContainerDirectiveData {\n    vlCellHeadingDepth?: number\n    vlParentHeadingDepth?: number\n  }\n}\n\nexport type MarkdownRendererScope = 'blocks' | 'field'\n\n/**\n * Options that control how fenced code blocks are rendered inside markdown content.\n *\n * By default, code blocks use the plugin's enhanced rendering mode:\n * - `enhancedCodeBlocks` defaults to `true`\n * - `lineNumbers` defaults to `true`\n * - `theme` defaults to `'github-dark'`\n *\n * When enhanced rendering is enabled, the plugin applies its normalized code block\n * pipeline on top of Shiki output. This includes layout cleanup, background\n * normalization, and support for features like line numbers.\n *\n * When enhanced rendering is disabled, code blocks are rendered closer to raw\n * Shiki output and plugin-specific enhancements are bypassed.\n *\n * These options are passed through the markdown rendering pipeline and primarily\n * affect Shiki-rendered code fences.\n */\nexport type RenderMarkdownOptions = {\n  /**\n   * Whether to apply the plugin's enhanced code block rendering pipeline.\n   *\n   * Defaults to `true`.\n   *\n   * When enabled, the renderer performs structural and visual normalization on\n   * Shiki output to produce a consistent, content-focused appearance.\n   *\n   * When disabled, code blocks are rendered closer to raw Shiki output.\n   */\n  enhancedCodeBlocks?: boolean\n\n  /**\n   * An optional list of language identifiers to load for Shiki syntax highlighting.\n   *\n   * By default, the plugin loads a core set of popular languages. You can replace\n   * that set entirely or extend it using spread syntax:\n   *\n   * ```ts\n   * options: {\n   *   langs: [...DEFAULT_CODE_LANGS, 'latex']\n   * }\n   * ```\n   */\n  langs?: string[]\n\n  /**\n   * Whether to show line numbers for fenced code blocks.\n   *\n   * Defaults to `true` when `enhancedCodeBlocks` is enabled.\n   *\n   * Line numbers require the enhanced rendering pipeline and are automatically\n   * disabled when `enhancedCodeBlocks` is set to `false`.\n   */\n  lineNumbers?: boolean\n\n  /**\n   * The Shiki theme to use for syntax highlighting.\n   *\n   * Defaults to `'github-dark'`.\n   *\n   * The plugin's enhanced renderer is tuned around its default theme. When using a\n   * non-default theme:\n   *\n   * - `enhancedCodeBlocks: true` opts into the plugin's normalized rendering pipeline\n   * - `enhancedCodeBlocks: false` preserves the theme's native appearance more closely\n   *\n   * This allows you to choose between a more controlled presentation and a more\n   * theme-faithful rendering mode.\n   */\n  theme?: string\n}\n\n/**\n * The result of compiling markdown into sanitized HTML.\n */\nexport type RenderMarkdownResult = {\n  /**\n   * The rendered HTML output.\n   */\n  html: string\n\n  /**\n   * Non-fatal warnings produced during rendering.\n   */\n  warnings: string[]\n}\n\n/**\n * Preset visual styles for rendered markdown content.\n */\nexport type MarkdownVariant = 'blog' | 'compact' | 'docs' | 'unstyled'\n\n/**\n * Preset typography sizes for rendered markdown content.\n */\nexport type MarkdownSize = 'lg' | 'md' | 'sm'\n\n/**\n * Core markdown presentation configuration.\n *\n * This type represents the configurable styling and behavior layer that can be\n * sourced from plugin defaults, globals, collection defaults, or block-level\n * overrides. It intentionally excludes runtime-only renderer props such as\n * `markdown`, `as`, and fallback nodes.\n */\nexport type MarkdownConfig = {\n  /**\n   * Additional classes applied to the rendered markdown element itself.\n   */\n  className?: string\n\n  /**\n   * Additional classes applied to column elements within the rendered markdown, if applicable.\n   */\n  columnClassName?: string\n\n  /**\n   * Whether to apply horizontal gutter padding to the outer wrapper.\n   *\n   * Defaults to `false`.\n   */\n  enableGutter?: boolean\n\n  /**\n   * Whether fenced code blocks should extend beyond the normal content width\n   * on larger screens.\n   *\n   * Defaults to `false`.\n   */\n  fullBleedCode?: boolean\n\n  /**\n   * Optional content rendered above the markdown body.\n   */\n  lead?: ReactNode\n\n  /**\n   * Whether heading colors should be slightly muted.\n   *\n   * Defaults to `false`.\n   */\n  mutedHeadings?: boolean\n\n  /**\n   * Options that control fenced code block rendering.\n   */\n  options?: RenderMarkdownOptions\n\n  /**\n   * Additional classes applied to section elements within the rendered markdown, if applicable.\n   */\n  sectionClassName?: string\n\n  /**\n   * Typography size preset for the rendered markdown.\n   *\n   * Defaults to `'lg'`.\n   */\n  size?: MarkdownSize\n\n  /**\n   * Visual style preset for the rendered markdown.\n   *\n   * Defaults to `'blog'`.\n   */\n  variant?: MarkdownVariant\n\n  /**\n   * Additional classes applied to the outer wrapper element.\n   */\n  wrapperClassName?: string\n}\n\n/**\n * Runtime-only props shared by markdown renderer components.\n */\nexport type BaseMarkdownRendererProps = {\n  /**\n   * The HTML tag used for the rendered markdown container.\n   *\n   * Defaults to `'article'`.\n   */\n  as?: keyof JSX.IntrinsicElements\n\n  /**\n   * Content rendered when the markdown input is empty or missing.\n   */\n  emptyFallback?: ReactNode\n\n  /**\n   * Content rendered when markdown compilation fails and a fallback is desired.\n   */\n  errorFallback?: ReactNode\n\n  /**\n   * The markdown source string to render.\n   */\n  markdown?: null | string\n}\n\n/**\n * Props for the main markdown renderer component.\n *\n * This merges persisted/configurable markdown presentation settings with the\n * runtime-only rendering props required by the component itself.\n */\nexport type MarkdownRendererProps = {\n    collectionSlug?: string\n    scope?: MarkdownRendererScope\n  } & BaseMarkdownRendererProps & MarkdownConfig\n\n/**\n * Options available while rendering an individual fenced code block.\n */\nexport interface CodeBlockOptions extends RenderMarkdownOptions {\n  /**\n   * The parsed language identifier for the fenced code block, if present.\n   */\n  lang?: string\n}\n\n/**\n * Stored Payload block data for a markdown block instance.\n */\nexport interface MarkdownBlockData {\n  /**\n   * Optional block display name assigned by Payload.\n   */\n  blockName?: null | string\n\n  /**\n   * The Payload block slug.\n   */\n  blockType: 'vlMdBlock'\n\n  /**\n   * Markdown source content for this block.\n   */\n  content: string\n\n  /**\n   * Optional Payload-generated block identifier.\n   */\n  id?: null | string\n}\n\n/**\n * Props for the markdown block component wrapper.\n */\nexport interface MarkdownBlockProps extends MarkdownBlockData {\n  /**\n   * The slug of the collection this block is rendered within, if applicable.\n   */\n  collectionSlug?: string\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAID,OAAO,uBAAsB"}

package/dist/directives/attributes.d.ts

@@ -0,0 +1,14 @@
+export type DirectiveAttributeValue = boolean | string;
+export type DirectiveAttributes = Record<string, DirectiveAttributeValue>;
+export type ParsedDirectiveLine = {
+    attributes: DirectiveAttributes;
+    name: string;
+    rawAttributes?: string;
+    warnings: string[];
+};
+export declare function parseDirectiveAttributesDetailed(value?: string): {
+    attributes: DirectiveAttributes;
+    warnings: string[];
+};
+export declare function parseDirectiveAttributes(value?: string): DirectiveAttributes;
+export declare function parseDirectiveLine(text: string): null | ParsedDirectiveLine;