markdown-to-adf 0.2.1

package/dist/markdown/parser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Markdown-it parser configuration used by the converter.
+ */
+import MarkdownIt from 'markdown-it';
+/**
+ * Creates a configured markdown-it instance for parsing markdown to tokens.
+ *
+ * @internal
+ */
+export declare function createMarkdownParser(): MarkdownIt;
+//# sourceMappingURL=parser.d.ts.map

package/dist/markdown/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/markdown/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,UAAU,MAAM,aAAa,CAAC;AAGrC;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAIjD"}

package/dist/markdown/parser.js

@@ -0,0 +1,16 @@
+/**
+ * Markdown-it parser configuration used by the converter.
+ */
+import MarkdownIt from 'markdown-it';
+import markdownItTaskLists from 'markdown-it-task-lists';
+/**
+ * Creates a configured markdown-it instance for parsing markdown to tokens.
+ *
+ * @internal
+ */
+export function createMarkdownParser() {
+    return new MarkdownIt({ html: false, breaks: false, linkify: true })
+        .enable(['table', 'strikethrough'])
+        .use(markdownItTaskLists, { enabled: true });
+}
+//# sourceMappingURL=parser.js.map

package/dist/markdown/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/markdown/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,mBAAmB,MAAM,wBAAwB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;SAClC,GAAG,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/presets/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Predefined conversion presets for common Jira contexts.
+ */
+import type { ConversionOptions, ContextPreset } from '../types/options.js';
+/**
+ * Resolves a preset name to its full configuration.
+ *
+ * @param preset - The preset name to resolve
+ * @returns The full configuration for the preset
+ *
+ * @internal
+ */
+export declare function resolvePreset(preset: ContextPreset): Required<Omit<ConversionOptions, 'preset'>>;
+/**
+ * Merges user options with preset configuration.
+ *
+ * @param options - User-provided options
+ * @returns Fully resolved options with all defaults applied
+ *
+ * @internal
+ */
+export declare function resolveOptions(options?: ConversionOptions): Required<Omit<ConversionOptions, 'preset'>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA6D5E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAEhG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,iBAAsB,GAC9B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC,CAY7C"}

package/dist/presets/index.js

@@ -0,0 +1,90 @@
+/**
+ * Predefined conversion presets for common Jira contexts.
+ */
+/**
+ * Configuration for each context preset.
+ *
+ * @internal
+ */
+const PRESET_CONFIGS = {
+    /**
+     * Default preset - works in most contexts.
+     * Conservative settings that avoid unsupported features.
+     */
+    default: {
+        useHeadings: false,
+        maxHeadingLevel: 6,
+        preserveLineBreaks: false,
+        strictMode: false,
+        warnOnRiskyNodes: false,
+        defaultCodeLanguage: 'text',
+    },
+    /**
+     * Comment preset - for Jira issue comments.
+     * Most restrictive: no headings, converts to bold paragraphs.
+     */
+    comment: {
+        useHeadings: false,
+        maxHeadingLevel: 6,
+        preserveLineBreaks: false,
+        strictMode: false,
+        warnOnRiskyNodes: true,
+        defaultCodeLanguage: 'text',
+    },
+    /**
+     * Task preset - for Task-type Jira issues.
+     * No heading support, converts headings to bold paragraphs.
+     */
+    task: {
+        useHeadings: false,
+        maxHeadingLevel: 6,
+        preserveLineBreaks: false,
+        strictMode: false,
+        warnOnRiskyNodes: false,
+        defaultCodeLanguage: 'text',
+    },
+    /**
+     * Story preset - for Story/Epic Jira issues.
+     * Full ADF support including actual heading nodes.
+     */
+    story: {
+        useHeadings: true,
+        maxHeadingLevel: 6,
+        preserveLineBreaks: false,
+        strictMode: false,
+        warnOnRiskyNodes: false,
+        defaultCodeLanguage: 'text',
+    },
+};
+/**
+ * Resolves a preset name to its full configuration.
+ *
+ * @param preset - The preset name to resolve
+ * @returns The full configuration for the preset
+ *
+ * @internal
+ */
+export function resolvePreset(preset) {
+    return PRESET_CONFIGS[preset];
+}
+/**
+ * Merges user options with preset configuration.
+ *
+ * @param options - User-provided options
+ * @returns Fully resolved options with all defaults applied
+ *
+ * @internal
+ */
+export function resolveOptions(options = {}) {
+    const preset = options.preset ?? 'default';
+    const presetConfig = resolvePreset(preset);
+    return {
+        useHeadings: options.useHeadings ?? presetConfig.useHeadings,
+        maxHeadingLevel: options.maxHeadingLevel ?? presetConfig.maxHeadingLevel,
+        preserveLineBreaks: options.preserveLineBreaks ?? presetConfig.preserveLineBreaks,
+        strictMode: options.strictMode ?? presetConfig.strictMode,
+        warnOnRiskyNodes: options.warnOnRiskyNodes ?? presetConfig.warnOnRiskyNodes,
+        defaultCodeLanguage: options.defaultCodeLanguage ?? presetConfig.defaultCodeLanguage,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,MAAM,cAAc,GAAuE;IACzF;;;OAGG;IACH,OAAO,EAAE;QACP,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,KAAK;QACzB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,MAAM;KAC5B;IAED;;;OAGG;IACH,OAAO,EAAE;QACP,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,KAAK;QACzB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,MAAM;KAC5B;IAED;;;OAGG;IACH,IAAI,EAAE;QACJ,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,KAAK;QACzB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,MAAM;KAC5B;IAED;;;OAGG;IACH,KAAK,EAAE;QACL,WAAW,EAAE,IAAI;QACjB,eAAe,EAAE,CAAC;QAClB,kBAAkB,EAAE,KAAK;QACzB,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,MAAM;KAC5B;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,UAA6B,EAAE;IAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;IAC3C,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,WAAW;QAC5D,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,YAAY,CAAC,eAAe;QACxE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,YAAY,CAAC,kBAAkB;QACjF,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,YAAY,CAAC,UAAU;QACzD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,YAAY,CAAC,gBAAgB;QAC3E,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,YAAY,CAAC,mBAAmB;KACrF,CAAC;AACJ,CAAC"}

package/dist/types/adf.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Atlassian Document Format (ADF) type definitions.
+ *
+ * @see https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/
+ */
+/**
+ * The root ADF document node.
+ * All ADF documents must start with this node type.
+ */
+export interface ADFDocument {
+    readonly type: 'doc';
+    readonly version: 1;
+    readonly content: ReadonlyArray<ADFBlockNode>;
+}
+/**
+ * Block-level nodes that can appear in a document.
+ * These define the structural elements like paragraphs, headings, lists, etc.
+ */
+export type ADFBlockNode = ADFParagraph | ADFHeading | ADFBulletList | ADFOrderedList | ADFTaskList | ADFCodeBlock | ADFBlockQuote | ADFRule | ADFPanel | ADFTable;
+/**
+ * Inline nodes that can appear within block nodes.
+ * These contain the actual content like text, links, emojis, etc.
+ */
+export type ADFInlineNode = ADFText | ADFHardBreak | ADFInlineCard | ADFMention | ADFEmoji;
+/**
+ * A paragraph node containing inline content.
+ */
+export interface ADFParagraph {
+    readonly type: 'paragraph';
+    readonly content?: ReadonlyArray<ADFInlineNode>;
+}
+/**
+ * A heading node with configurable level (1-6).
+ *
+ * @remarks
+ * Headings are not supported in all Jira issue types.
+ * Use the `comment` or `task` presets to convert headings to bold text.
+ */
+export interface ADFHeading {
+    readonly type: 'heading';
+    readonly attrs: {
+        readonly level: 1 | 2 | 3 | 4 | 5 | 6;
+    };
+    readonly content: ReadonlyArray<ADFInlineNode>;
+}
+/**
+ * An unordered (bullet) list.
+ */
+export interface ADFBulletList {
+    readonly type: 'bulletList';
+    readonly content: ReadonlyArray<ADFListItem>;
+}
+/**
+ * An ordered (numbered) list.
+ */
+export interface ADFOrderedList {
+    readonly type: 'orderedList';
+    readonly content: ReadonlyArray<ADFListItem>;
+}
+/**
+ * A task list (checkbox list).
+ */
+export interface ADFTaskList {
+    readonly type: 'taskList';
+    readonly attrs: {
+        readonly localId: string;
+    };
+    readonly content: ReadonlyArray<ADFTaskItem>;
+}
+/**
+ * A task list item with checkbox state.
+ */
+export interface ADFTaskItem {
+    readonly type: 'taskItem';
+    readonly attrs: {
+        readonly localId: string;
+        readonly state: 'TODO' | 'DONE';
+    };
+    readonly content: ReadonlyArray<ADFInlineNode>;
+}
+/**
+ * A list item that can contain paragraphs or nested lists.
+ */
+export interface ADFListItem {
+    readonly type: 'listItem';
+    readonly content: ReadonlyArray<ADFParagraph | ADFBulletList | ADFOrderedList>;
+}
+/**
+ * A code block with optional syntax highlighting.
+ */
+export interface ADFCodeBlock {
+    readonly type: 'codeBlock';
+    readonly attrs?: {
+        readonly language?: string;
+    };
+    readonly content: ReadonlyArray<ADFText>;
+}
+/**
+ * A block quote containing other block nodes.
+ */
+export interface ADFBlockQuote {
+    readonly type: 'blockQuote';
+    readonly content: ReadonlyArray<ADFBlockNode>;
+}
+/**
+ * A horizontal rule (divider).
+ */
+export interface ADFRule {
+    readonly type: 'rule';
+}
+/**
+ * A panel (callout) with different styles.
+ */
+export interface ADFPanel {
+    readonly type: 'panel';
+    readonly attrs: {
+        readonly panelType: 'info' | 'note' | 'warning' | 'error' | 'success';
+    };
+    readonly content: ReadonlyArray<ADFBlockNode>;
+}
+/**
+ * Text content with optional formatting marks.
+ */
+export interface ADFText {
+    readonly type: 'text';
+    readonly text: string;
+    readonly marks?: ReadonlyArray<ADFMark>;
+}
+/**
+ * A hard line break (like Shift+Enter).
+ */
+export interface ADFHardBreak {
+    readonly type: 'hardBreak';
+}
+/**
+ * An inline card (preview of a URL).
+ */
+export interface ADFInlineCard {
+    readonly type: 'inlineCard';
+    readonly attrs: {
+        readonly url: string;
+    };
+}
+/**
+ * A mention of a user or entity.
+ */
+export interface ADFMention {
+    readonly type: 'mention';
+    readonly attrs: {
+        readonly id: string;
+        readonly text?: string;
+    };
+}
+/**
+ * An emoji reference.
+ */
+export interface ADFEmoji {
+    readonly type: 'emoji';
+    readonly attrs: {
+        readonly shortName: string;
+        readonly id?: string;
+        readonly text?: string;
+    };
+}
+/**
+ * Text formatting marks that can be applied to text nodes.
+ */
+export type ADFMark = ADFStrongMark | ADFEmMark | ADFCodeMark | ADFStrikeMark | ADFUnderlineMark | ADFLinkMark | ADFTextColorMark;
+/**
+ * Bold text formatting.
+ */
+export interface ADFStrongMark {
+    readonly type: 'strong';
+}
+/**
+ * Italic text formatting.
+ */
+export interface ADFEmMark {
+    readonly type: 'em';
+}
+/**
+ * Inline code formatting.
+ */
+export interface ADFCodeMark {
+    readonly type: 'code';
+}
+/**
+ * Strikethrough text formatting.
+ */
+export interface ADFStrikeMark {
+    readonly type: 'strike';
+}
+/**
+ * Underlined text formatting.
+ */
+export interface ADFUnderlineMark {
+    readonly type: 'underline';
+}
+/**
+ * Hyperlink with URL and optional title.
+ */
+export interface ADFLinkMark {
+    readonly type: 'link';
+    readonly attrs: {
+        readonly href: string;
+        readonly title?: string;
+    };
+}
+/**
+ * Text color formatting.
+ */
+export interface ADFTextColorMark {
+    readonly type: 'textColor';
+    readonly attrs: {
+        readonly color: string;
+    };
+}
+/**
+ * A table node containing rows.
+ */
+export interface ADFTable {
+    readonly type: 'table';
+    readonly attrs?: {
+        readonly isNumberColumnEnabled?: boolean;
+        readonly layout?: 'default' | 'wide' | 'full-width';
+    };
+    readonly content: ReadonlyArray<ADFTableRow>;
+}
+/**
+ * A table row containing cells.
+ */
+export interface ADFTableRow {
+    readonly type: 'tableRow';
+    readonly content: ReadonlyArray<ADFTableCell | ADFTableHeader>;
+}
+/**
+ * A table header cell.
+ */
+export interface ADFTableHeader {
+    readonly type: 'tableHeader';
+    readonly attrs?: Record<string, unknown>;
+    readonly content: ReadonlyArray<ADFParagraph>;
+}
+/**
+ * A table data cell.
+ */
+export interface ADFTableCell {
+    readonly type: 'tableCell';
+    readonly attrs?: Record<string, unknown>;
+    readonly content: ReadonlyArray<ADFParagraph>;
+}
+//# sourceMappingURL=adf.d.ts.map

package/dist/types/adf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf.d.ts","sourceRoot":"","sources":["../../src/types/adf.ts"],"names":[],"mappings":"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"}

package/dist/types/adf.js

@@ -0,0 +1,7 @@
+/**
+ * Atlassian Document Format (ADF) type definitions.
+ *
+ * @see https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/
+ */
+export {};
+//# sourceMappingURL=adf.js.map

package/dist/types/adf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf.js","sourceRoot":"","sources":["../../src/types/adf.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public type exports for markdown-to-adf.
+ */
+export type { ADFDocument, ADFBlockNode, ADFInlineNode, ADFParagraph, ADFHeading, ADFBulletList, ADFOrderedList, ADFListItem, ADFCodeBlock, ADFBlockQuote, ADFRule, ADFPanel, ADFText, ADFHardBreak, ADFInlineCard, ADFMention, ADFEmoji, ADFMark, ADFStrongMark, ADFEmMark, ADFCodeMark, ADFStrikeMark, ADFUnderlineMark, ADFLinkMark, ADFTextColorMark, } from './adf.js';
+export type { ContextPreset, ConversionOptions, ConversionResult, ConversionWarning, } from './options.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,OAAO,EACP,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,SAAS,EACT,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Public type exports for markdown-to-adf.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/options.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Configuration options for markdown to ADF conversion.
+ */
+import type { ADFDocument } from './adf.js';
+/**
+ * Predefined context presets for common Jira use cases.
+ *
+ * @remarks
+ * Different Jira contexts support different ADF features:
+ * - `comment`: Restrictive schema, no headings, suitable for issue comments
+ * - `task`: No headings (headings convert to bold), suitable for Task-type issues
+ * - `story`: Full ADF support including headings, suitable for Story/Epic issues
+ * - `default`: Balanced preset that works in most contexts
+ */
+export type ContextPreset = 'comment' | 'task' | 'story' | 'default';
+/**
+ * Options for customizing markdown to ADF conversion behavior.
+ */
+export interface ConversionOptions {
+    /**
+     * Use a predefined preset optimized for a specific Jira context.
+     *
+     * @defaultValue 'default'
+     *
+     * @example
+     * ```ts
+     * // For issue comments (no headings)
+     * markdownToAdf(markdown, { preset: 'comment' });
+     *
+     * // For Task-type issues (headings convert to bold)
+     * markdownToAdf(markdown, { preset: 'task' });
+     *
+     * // For Story/Epic issues (full heading support)
+     * markdownToAdf(markdown, { preset: 'story' });
+     * ```
+     */
+    preset?: ContextPreset;
+    /**
+     * Whether to use actual heading nodes (h1-h6) in the ADF output.
+     *
+     * @remarks
+     * Headings are not supported in all Jira contexts:
+     * - ❌ Issue comments
+     * - ❌ Task-type issues
+     * - ✅ Story/Epic issues (and some others)
+     *
+     * When `false`, markdown headings (##) are converted to bold paragraphs.
+     *
+     * @defaultValue false
+     */
+    useHeadings?: boolean;
+    /**
+     * Maximum heading level to allow (1-6).
+     * Headings deeper than this will be converted to bold paragraphs.
+     *
+     * @defaultValue 6
+     *
+     * @example
+     * ```ts
+     * // Only allow h1 and h2
+     * markdownToAdf(markdown, { maxHeadingLevel: 2 });
+     * ```
+     */
+    maxHeadingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Whether to preserve line breaks as hard breaks in paragraphs.
+     *
+     * @remarks
+     * When `true`, single line breaks become `<hardBreak>` nodes.
+     * When `false`, consecutive lines are merged into a single paragraph.
+     *
+     * @defaultValue false
+     */
+    preserveLineBreaks?: boolean;
+    /**
+     * Whether to throw errors on unsupported markdown syntax.
+     *
+     * @remarks
+     * When `true`, throws an error if markdown contains features incompatible
+     * with the selected preset (e.g., headings in comments).
+     * When `false`, silently ignores or converts unsupported features to plain text.
+     *
+     * @defaultValue false
+     */
+    strictMode?: boolean;
+    /**
+     * Whether to emit warnings for nodes that are technically valid but known to be flaky.
+     *
+     * @remarks
+     * Useful for Jira contexts where some nodes are inconsistently supported.
+     *
+     * @defaultValue false
+     */
+    warnOnRiskyNodes?: boolean;
+    /**
+     * Default language for code blocks without a language specifier.
+     *
+     * @defaultValue 'text'
+     *
+     * @example
+     * ```ts
+     * markdownToAdf(markdown, { defaultCodeLanguage: 'javascript' });
+     * ```
+     */
+    defaultCodeLanguage?: string;
+}
+/**
+ * Result of a markdown to ADF conversion.
+ */
+export interface ConversionResult {
+    /**
+     * The generated ADF document.
+     */
+    adf: ADFDocument;
+    /**
+     * Warnings generated during conversion (e.g., unsupported features).
+     */
+    warnings: readonly ConversionWarning[];
+}
+/**
+ * A warning about potentially lossy or unsupported conversion.
+ */
+export interface ConversionWarning {
+    /**
+     * The type of warning.
+     */
+    type: 'unsupported_feature' | 'lossy_conversion' | 'invalid_syntax' | 'risky_feature';
+    /**
+     * Human-readable warning message.
+     */
+    message: string;
+    /**
+     * Line number where the warning occurred (1-indexed), if available.
+     */
+    line?: number;
+    /**
+     * The original markdown that triggered the warning.
+     */
+    markdown?: string;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAExC;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAEtF;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/options.js

@@ -0,0 +1,5 @@
+/**
+ * Configuration options for markdown to ADF conversion.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/inline-parser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utilities for parsing inline markdown-it tokens into ADF inline nodes.
+ */
+import type { Token } from 'markdown-it';
+import type { ADFInlineNode } from '../types/adf.js';
+interface InlineParseOptions {
+    preserveLineBreaks: boolean;
+    stripTaskCheckbox?: boolean;
+}
+interface InlineParseResult {
+    nodes: ADFInlineNode[];
+    taskChecked: boolean;
+}
+export declare function parseInlineTokens(tokens: readonly Token[] | null | undefined, options: InlineParseOptions): InlineParseResult;
+export {};
+//# sourceMappingURL=inline-parser.d.ts.map

package/dist/utils/inline-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-parser.d.ts","sourceRoot":"","sources":["../../src/utils/inline-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAW,MAAM,iBAAiB,CAAC;AAI9D,UAAU,kBAAkB;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,EAAE,kBAAkB,GAC1B,iBAAiB,CA4GnB"}