@canofold/markdown 0.2.1 → 0.3.1

package/dist/compiler/analyze.d.ts

@@ -10,6 +10,16 @@ export interface MarkdownCodeExample {
     meta?: string;
     code: string;
 }
+export interface MarkdownDirective {
+    name: string;
+    type: 'containerDirective' | 'leafDirective' | 'textDirective';
+    label: string;
+    attributes: Record<string, string>;
+    line?: number;
+    column?: number;
+    offset?: number;
+    endOffset?: number;
+}
 export interface MarkdownAnalysis {
     text: string;
     headings: MarkdownHeading[];
@@ -17,6 +27,7 @@ export interface MarkdownAnalysis {
     links: string[];
     images: string[];
     missingCodeBlockLanguages: number;
+    directives: MarkdownDirective[];
     directiveIssues: MarkdownDirectiveIssue[];
 }
 export interface AnalyzeMarkdownOptions {

package/dist/compiler/fenceMetadata.d.ts

@@ -0,0 +1,7 @@
+import type { MarkdownCodeOverflow } from './types';
+export interface MarkdownFenceMetadata {
+    filename?: string;
+    overflow?: MarkdownCodeOverflow;
+}
+/** Parse the shared metadata understood by Markdown and MDX code fences. */
+export declare function parseFenceMetadata(meta: string): MarkdownFenceMetadata;

package/dist/compiler/normalizeOptions.d.ts

@@ -1,5 +1,5 @@
 import type { LanguageInput, ThemeRegistration } from '@shikijs/types';
-import type { MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownPlugin, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './types';
+import type { MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownCodeOverflow, MarkdownPlugin, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './types';
 export interface NormalizedMarkdownOptions {
     htmlPolicy: MarkdownHtmlPolicy;
     codeThemes: {
@@ -7,6 +7,7 @@ export interface NormalizedMarkdownOptions {
         dark: string | ThemeRegistration;
     };
     fallbackLanguage: string;
+    codeOverflow: MarkdownCodeOverflow;
     codeLanguages: Readonly<Record<string, LanguageInput>>;
     unknownLanguage: MarkdownUnknownLanguagePolicy;
     features: Required<MarkdownFeatureOptions>;

package/dist/compiler/plugins/code.d.ts

@@ -13,4 +13,4 @@ export declare const rehypeRichFences: (assets: MarkdownAssetCollector, options:
 /** Convert rich fences into React components for the MDX recma pipeline. */
 export declare const remarkMdxRichBlocks: (assets: MarkdownAssetCollector, options: NormalizedMarkdownOptions) => (tree: MdastRoot) => void;
 /** Wrap each highlighted code block with a file/language label and copy action. */
-export declare const rehypeCodeBlocks: (assets: MarkdownAssetCollector, labels: NormalizedMarkdownOptions["labels"], excludedLanguages?: ReadonlySet<string>) => (tree: HastRoot) => void;
+export declare const rehypeCodeBlocks: (assets: MarkdownAssetCollector, options: Pick<NormalizedMarkdownOptions, "labels" | "codeOverflow">, excludedLanguages?: ReadonlySet<string>) => (tree: HastRoot) => void;

package/dist/compiler/plugins.d.ts

@@ -20,5 +20,7 @@ export declare function defineMarkdownPlugin(plugin: MarkdownPlugin): MarkdownPl
 export declare function activeMarkdownPlugins(plugins: readonly MarkdownPlugin[], context: MarkdownPluginContext): readonly MarkdownPlugin[];
 /** Collect normalized fenced-code labels owned by the active plugins. */
 export declare function markdownPluginFenceLanguages(plugins: readonly MarkdownPlugin[]): ReadonlySet<string>;
+/** Collect code languages generated by active plugin transforms. */
+export declare function markdownPluginHighlightLanguages(plugins: readonly MarkdownPlugin[]): readonly string[];
 /** Collect normalized directive names owned by the active plugins. */
 export declare function markdownPluginDirectiveNames(plugins: readonly MarkdownPlugin[]): ReadonlySet<string>;

package/dist/compiler/prepareMarkdown.d.ts

@@ -1,6 +1,6 @@
 import type { PreparedMarkdown, RenderMarkdownOptions } from './types';
 export type { MarkdownAssets } from './assets';
-export type { MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownPlugin, MarkdownPluginBrowserCompiler, MarkdownPluginCacheValue, MarkdownPluginClientAsset, MarkdownPluginClientResource, MarkdownPluginClientResourceDirectory, MarkdownPluginContext, MarkdownPluginStyleAsset, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './types';
+export type { MarkdownCodeOverflow, MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownPlugin, MarkdownPluginBrowserCompiler, MarkdownPluginCacheValue, MarkdownPluginClientAsset, MarkdownPluginClientResource, MarkdownPluginClientResourceDirectory, MarkdownPluginContext, MarkdownPluginStyleAsset, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './types';
 export interface MarkdownCompilerContext {
     warnedLanguages: Set<string>;
 }

package/dist/compiler/types.d.ts

@@ -4,6 +4,7 @@ import type { LanguageInput } from '@shikijs/types';
 import type { PluggableList } from 'unified';
 export type MarkdownHtmlPolicy = 'trusted' | 'sanitize' | 'strip';
 export type MarkdownUnknownLanguagePolicy = 'warn' | 'error' | 'plain-text';
+export type MarkdownCodeOverflow = 'wrap' | 'scroll';
 export type MarkdownPluginCacheValue = string | number | boolean | null | MarkdownPluginCacheValue[] | {
     [key: string]: MarkdownPluginCacheValue;
 };
@@ -21,6 +22,8 @@ export interface MarkdownCodeOptions {
         dark?: string;
     };
     fallbackLanguage?: string;
+    /** Default long-line behavior. Individual fences may override it with `wrap` or `scroll` metadata. */
+    overflow?: MarkdownCodeOverflow;
     /**
      * Additional fence-language loaders keyed by the label authors use after
      * the opening fence. Built-in technical-document languages remain enabled.
@@ -99,6 +102,12 @@ export interface MarkdownPlugin {
      * fences as ordinary code or reporting them as unsupported languages.
      */
     fenceLanguages?: readonly string[];
+    /**
+     * Code languages introduced by this plugin's transforms. The compiler loads
+     * these grammars before the plugin runs so generated code blocks use the
+     * same Shiki pipeline as authored Markdown fences.
+     */
+    highlightLanguages?: readonly string[];
     /**
      * Directive names owned by this plugin. Undeclared directive names are
      * rejected so author typos cannot silently degrade to generic HTML.

package/dist/components/blocks/MarkdownCodeBlock.d.ts

@@ -1,10 +1,12 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
+import type { MarkdownCodeOverflow } from '../../compiler/types';
 export interface MarkdownCodeBlockProps extends Omit<HTMLAttributes<HTMLElement>, 'children'> {
     children?: ReactNode;
     language?: string;
     filename?: string;
+    overflow?: MarkdownCodeOverflow;
     source?: string;
     copyLabel?: string;
     copyFailureLabel?: string;
 }
-export declare function MarkdownCodeBlock({ children, source: directSource, language: directLanguage, filename: directFilename, copyLabel: directCopyLabel, copyFailureLabel: directCopyFailureLabel, ...inputProps }: MarkdownCodeBlockProps): import("react").JSX.Element;
+export declare function MarkdownCodeBlock({ children, source: directSource, language: directLanguage, filename: directFilename, overflow: directOverflow, copyLabel: directCopyLabel, copyFailureLabel: directCopyFailureLabel, ...inputProps }: MarkdownCodeBlockProps): import("react").JSX.Element;

package/dist/{directiveValidation-CwXRsn5k.js → directiveValidation-BdVbgcY_.js}

@@ -1,4 +1,4 @@
-import { a as z, s as P, e as _, f as j } from "./plugins-CeQ-Bo89.js";
+import { a as z, s as P, f as _, g as j } from "./plugins-StkCS2su.js";
 import { visit as S } from "unist-util-visit";
 function k(t, a, e) {
   const i = t.find((s) => s.id === a.id);

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export type { MarkdownClassNames, MarkdownComponents, MarkdownIntrinsicComponent
 export type { MarkdownCaptionSlotProps, MarkdownIconName, MarkdownIconSlotProps, MarkdownSlots } from './react/slots';
 export type { MarkdownUrlProperty, MarkdownUrlTransform } from './react/urlTransform';
 export { defineMarkdownPlugin } from './compiler/plugins';
-export type { MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownPlugin, MarkdownPluginBrowserCompiler, MarkdownPluginCacheValue, MarkdownPluginClientAsset, MarkdownPluginClientResource, MarkdownPluginClientResourceDirectory, MarkdownPluginContext, MarkdownPluginStyleAsset, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './compiler/prepareMarkdown';
+export type { MarkdownCodeOverflow, MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownHtmlPolicy, MarkdownLabels, MarkdownPlugin, MarkdownPluginBrowserCompiler, MarkdownPluginCacheValue, MarkdownPluginClientAsset, MarkdownPluginClientResource, MarkdownPluginClientResourceDirectory, MarkdownPluginContext, MarkdownPluginStyleAsset, MarkdownUnknownLanguagePolicy, RenderMarkdownOptions } from './compiler/prepareMarkdown';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { M as a } from "./Markdown-DgolXL7g.js";
-import { d as e } from "./plugins-CeQ-Bo89.js";
+import { M as a } from "./Markdown-CPG2lcO7.js";
+import { d as e } from "./plugins-StkCS2su.js";
 export {
   a as Markdown,
   e as defineMarkdownPlugin

package/dist/{plugins-CeQ-Bo89.js → plugins-StkCS2su.js}

@@ -93,7 +93,7 @@ const w = {
   rust: "source",
   rs: "source"
 };
-function b(e, t = "") {
+function h(e, t = "") {
   const r = e.split(/[\\/]/).pop()?.toLowerCase() || "", n = w[r];
   if (n) return n;
   if (/^\.env(?:\..+)?$/.test(r)) return "environment";
@@ -155,7 +155,7 @@ function j(e, t = "") {
   if (/^\.env(?:\.|$)/.test(n)) return "environment";
   if (n === "tsconfig.json" || n === "jsconfig.json") return "typescript";
   if (/\.(?:jsx|tsx)$/.test(n)) return "react";
-  const o = b(n, t);
+  const o = h(n, t);
   if (o === "config") return "config";
   if (o === "database") return "database";
   if (o === "diff") return "diff";
@@ -193,7 +193,7 @@ function p(e) {
     return;
   }
 }
-const m = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, h = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const m = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, b = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
 function d(e) {
   if (typeof e != "string" || !m.test(e))
     throw new Error(
@@ -209,7 +209,7 @@ function g(e) {
   if (t) {
     if (typeof t.module != "string" || t.module.trim() === "")
       throw new Error(`Markdown plugin "${e.name}" browserCompiler.module must be a non-empty string`);
-    if (typeof t.exportName != "string" || !h.test(t.exportName))
+    if (typeof t.exportName != "string" || !b.test(t.exportName))
       throw new Error(
         `Markdown plugin "${e.name}" browserCompiler.exportName must be a named JavaScript export`
       );
@@ -273,16 +273,26 @@ function z(e) {
   return t;
 }
 function E(e) {
+  const t = /* @__PURE__ */ new Set();
+  for (const r of e)
+    for (const n of r.highlightLanguages ?? []) {
+      const o = n.trim().toLowerCase();
+      o && t.add(o);
+    }
+  return [...t];
+}
+function O(e) {
   return new Set(e.flatMap((t) => f(t)));
 }
 export {
   x as a,
   z as b,
-  v as c,
+  E as c,
   N as d,
-  b as e,
-  j as f,
-  E as m,
+  v as e,
+  h as f,
+  j as g,
+  O as m,
   $ as n,
   p as s
 };