@knpkv/confluence-to-markdown 0.2.0 → 0.4.1

package/dist/ast/InlineNode.js

@@ -0,0 +1,263 @@
+/**
+ * Inline AST node types for text-level content.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Optional raw Confluence HTML for exact roundtrip preservation.
+ * When present, the Confluence serializer will output this instead of reconstructing.
+ *
+ * @category InlineNode
+ */
+export const RawConfluence = Schema.optional(Schema.String);
+/**
+ * Plain text content.
+ *
+ * @example
+ * ```typescript
+ * import { Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const text = new Text({ value: "Hello world" })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Text extends Schema.TaggedClass()("Text", {
+    value: Schema.String
+}) {
+}
+/**
+ * Inline code span.
+ *
+ * @example
+ * ```typescript
+ * import { InlineCode } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const code = new InlineCode({ value: "const x = 1" })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class InlineCode extends Schema.TaggedClass()("InlineCode", {
+    value: Schema.String
+}) {
+}
+/**
+ * Line break element.
+ *
+ * @example
+ * ```typescript
+ * import { LineBreak } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const br = new LineBreak({})
+ * ```
+ *
+ * @category InlineNode
+ */
+export class LineBreak extends Schema.TaggedClass()("LineBreak", {}) {
+}
+/**
+ * Unsupported inline element - preserves raw content for round-tripping.
+ *
+ * @example
+ * ```typescript
+ * import { UnsupportedInline } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const unknown = new UnsupportedInline({
+ *   raw: "<custom-tag>content</custom-tag>",
+ *   source: "confluence"
+ * })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class UnsupportedInline extends Schema.TaggedClass()("UnsupportedInline", {
+    raw: Schema.String,
+    source: Schema.Literal("confluence", "markdown")
+}) {
+}
+/**
+ * Emoticon/emoji element.
+ *
+ * @example
+ * ```typescript
+ * import { Emoticon } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const emoji = new Emoticon({
+ *   shortname: ":grinning:",
+ *   emojiId: "1f600",
+ *   fallback: "😀"
+ * })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Emoticon extends Schema.TaggedClass()("Emoticon", {
+    shortname: Schema.String,
+    emojiId: Schema.String,
+    fallback: Schema.String,
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * User mention element.
+ *
+ * @example
+ * ```typescript
+ * import { UserMention } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const mention = new UserMention({ accountId: "557058:..." })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class UserMention extends Schema.TaggedClass()("UserMention", {
+    accountId: Schema.String,
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Date/time element.
+ *
+ * @example
+ * ```typescript
+ * import { DateTime } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const date = new DateTime({ datetime: "2026-01-01" })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class DateTime extends Schema.TaggedClass()("DateTime", {
+    datetime: Schema.String,
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Underlined text.
+ *
+ * @category InlineNode
+ */
+export class Underline extends Schema.TaggedClass()("Underline", {
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+/**
+ * Subscript text.
+ *
+ * @category InlineNode
+ */
+export class Subscript extends Schema.TaggedClass()("Subscript", {
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+/**
+ * Superscript text.
+ *
+ * @category InlineNode
+ */
+export class Superscript extends Schema.TaggedClass()("Superscript", {
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+/**
+ * Strikethrough text.
+ *
+ * @category InlineNode
+ */
+export class Strikethrough extends Schema.TaggedClass()("Strikethrough", {
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+/**
+ * Colored text with CSS color value.
+ *
+ * @category InlineNode
+ */
+export class ColoredText extends Schema.TaggedClass()("ColoredText", {
+    color: Schema.String,
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+/**
+ * Highlighted text with background color.
+ *
+ * @category InlineNode
+ */
+export class Highlight extends Schema.TaggedClass()("Highlight", {
+    backgroundColor: Schema.String,
+    children: Schema.suspend(() => Schema.Array(InlineNodeBase))
+}) {
+}
+// Forward declaration for recursive types
+// Define InlineNode union schema first (without recursive types)
+const InlineNodeBase = Schema.Union(Text, InlineCode, LineBreak, Emoticon, UserMention, DateTime, UnsupportedInline);
+/**
+ * Inline node children schema - use this for recursive inline content.
+ *
+ * @category InlineNode
+ */
+export const InlineNodeChildren = Schema.suspend(() => Schema.Array(InlineNode));
+/**
+ * Strong/bold text.
+ *
+ * @example
+ * ```typescript
+ * import { Strong, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const bold = new Strong({ children: [new Text({ value: "important" })] })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Strong extends Schema.TaggedClass()("Strong", {
+    children: Schema.Array(InlineNodeBase)
+}) {
+}
+/**
+ * Emphasized/italic text.
+ *
+ * @example
+ * ```typescript
+ * import { Emphasis, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const italic = new Emphasis({ children: [new Text({ value: "emphasized" })] })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Emphasis extends Schema.TaggedClass()("Emphasis", {
+    children: Schema.Array(InlineNodeBase)
+}) {
+}
+/**
+ * Hyperlink with optional title.
+ *
+ * @example
+ * ```typescript
+ * import { Link, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const link = new Link({
+ *   href: "https://example.com",
+ *   title: "Example",
+ *   children: [new Text({ value: "Click here" })]
+ * })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Link extends Schema.TaggedClass()("Link", {
+    href: Schema.String,
+    title: Schema.optional(Schema.String),
+    children: Schema.Array(InlineNodeBase),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Union of all inline node types.
+ *
+ * @category InlineNode
+ */
+export const InlineNode = Schema.Union(Text, Strong, Emphasis, InlineCode, Link, LineBreak, Emoticon, UserMention, DateTime, Underline, Subscript, Superscript, Strikethrough, ColoredText, Highlight, UnsupportedInline);
+//# sourceMappingURL=InlineNode.js.map

package/dist/ast/InlineNode.js.map

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

package/dist/ast/MacroNode.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Confluence macro AST node types.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { CodeBlock, Heading, Image, Paragraph, Table, ThematicBreak, UnsupportedBlock } from "./BlockNode.js";
+/**
+ * Supported panel type names.
+ * Single source of truth for all panel macros.
+ *
+ * @category MacroNode
+ */
+export declare const PanelTypes: readonly ["info", "warning", "note", "tip", "error", "panel"];
+/**
+ * Panel type for info/warning/note macros.
+ *
+ * @category MacroNode
+ */
+export declare const PanelType: Schema.Literal<["info", "warning", "note", "tip", "error", "panel"]>;
+/**
+ * Type for panel type.
+ *
+ * @category Types
+ */
+export type PanelType = Schema.Schema.Type<typeof PanelType>;
+/**
+ * Info/Warning/Note panel macro.
+ *
+ * Represents Confluence info, warning, note, tip, and error panels.
+ * In Markdown, rendered as `:::info`, `:::warning`, etc. container syntax.
+ *
+ * @example
+ * ```typescript
+ * import { InfoPanel, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const panel = {
+ *   _tag: "InfoPanel" as const,
+ *   panelType: "warning" as const,
+ *   title: "Important",
+ *   children: [new Paragraph({ children: [new Text({ value: "Be careful!" })] })]
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export declare const InfoPanel: Schema.Struct<{
+    _tag: Schema.Literal<["InfoPanel"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    panelType: Schema.Literal<["info", "warning", "note", "tip", "error", "panel"]>;
+    title: Schema.optional<typeof Schema.String>;
+    children: Schema.Array$<Schema.Union<[typeof Heading, typeof Paragraph, typeof CodeBlock, typeof ThematicBreak, typeof Image, typeof Table, typeof UnsupportedBlock]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for InfoPanel.
+ *
+ * @category Types
+ */
+export type InfoPanel = Schema.Schema.Type<typeof InfoPanel>;
+/**
+ * Expand/collapse macro.
+ *
+ * Represents Confluence expand macro for collapsible content.
+ * In Markdown, rendered as `:::details` container syntax.
+ *
+ * @example
+ * ```typescript
+ * import { ExpandMacro, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const expand = {
+ *   _tag: "ExpandMacro" as const,
+ *   title: "Click to expand",
+ *   children: [new Paragraph({ children: [new Text({ value: "Hidden content" })] })]
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export declare const ExpandMacro: Schema.Struct<{
+    _tag: Schema.Literal<["ExpandMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    title: Schema.optional<typeof Schema.String>;
+    children: Schema.Array$<Schema.Union<[typeof Heading, typeof Paragraph, typeof CodeBlock, typeof ThematicBreak, typeof Image, typeof Table, typeof UnsupportedBlock]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for ExpandMacro.
+ *
+ * @category Types
+ */
+export type ExpandMacro = Schema.Schema.Type<typeof ExpandMacro>;
+/**
+ * Table of contents macro.
+ *
+ * Represents Confluence TOC macro for auto-generated table of contents.
+ * In Markdown, rendered as `[[toc]]` or similar marker.
+ *
+ * @example
+ * ```typescript
+ * import { TocMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const toc = {
+ *   _tag: "TocMacro" as const,
+ *   minLevel: 2,
+ *   maxLevel: 4
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export declare const TocMacro: Schema.Struct<{
+    _tag: Schema.Literal<["TocMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    minLevel: Schema.optional<typeof Schema.Number>;
+    maxLevel: Schema.optional<typeof Schema.Number>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for TocMacro.
+ *
+ * @category Types
+ */
+export type TocMacro = Schema.Schema.Type<typeof TocMacro>;
+/**
+ * Code macro with syntax highlighting.
+ *
+ * Represents Confluence code macro with language and options.
+ * Different from CodeBlock in that it preserves Confluence-specific options.
+ *
+ * @example
+ * ```typescript
+ * import { CodeMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const code = {
+ *   _tag: "CodeMacro" as const,
+ *   language: "typescript",
+ *   title: "Example",
+ *   code: "const x = 1",
+ *   lineNumbers: true
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export declare const CodeMacro: Schema.Struct<{
+    _tag: Schema.Literal<["CodeMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    language: Schema.optional<typeof Schema.String>;
+    title: Schema.optional<typeof Schema.String>;
+    code: typeof Schema.String;
+    lineNumbers: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+    }>;
+    collapse: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+    }>;
+    firstLine: Schema.optional<typeof Schema.Number>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for CodeMacro.
+ *
+ * @category Types
+ */
+export type CodeMacro = Schema.Schema.Type<typeof CodeMacro>;
+/**
+ * Status macro (colored label).
+ *
+ * @example
+ * ```typescript
+ * import { StatusMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const status = {
+ *   _tag: "StatusMacro" as const,
+ *   text: "In Progress",
+ *   color: "Blue"
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export declare const StatusMacro: Schema.Struct<{
+    _tag: Schema.Literal<["StatusMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    text: typeof Schema.String;
+    color: Schema.Literal<["Grey", "Red", "Yellow", "Green", "Blue"]>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for StatusMacro.
+ *
+ * @category Types
+ */
+export type StatusMacro = Schema.Schema.Type<typeof StatusMacro>;
+/**
+ * Union of all macro node types.
+ *
+ * @category MacroNode
+ */
+export declare const MacroNode: Schema.Union<[Schema.Struct<{
+    _tag: Schema.Literal<["InfoPanel"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    panelType: Schema.Literal<["info", "warning", "note", "tip", "error", "panel"]>;
+    title: Schema.optional<typeof Schema.String>;
+    children: Schema.Array$<Schema.Union<[typeof Heading, typeof Paragraph, typeof CodeBlock, typeof ThematicBreak, typeof Image, typeof Table, typeof UnsupportedBlock]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["ExpandMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    title: Schema.optional<typeof Schema.String>;
+    children: Schema.Array$<Schema.Union<[typeof Heading, typeof Paragraph, typeof CodeBlock, typeof ThematicBreak, typeof Image, typeof Table, typeof UnsupportedBlock]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["TocMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    minLevel: Schema.optional<typeof Schema.Number>;
+    maxLevel: Schema.optional<typeof Schema.Number>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["CodeMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    language: Schema.optional<typeof Schema.String>;
+    title: Schema.optional<typeof Schema.String>;
+    code: typeof Schema.String;
+    lineNumbers: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+    }>;
+    collapse: Schema.optionalWith<typeof Schema.Boolean, {
+        default: () => false;
+    }>;
+    firstLine: Schema.optional<typeof Schema.Number>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["StatusMacro"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    text: typeof Schema.String;
+    color: Schema.Literal<["Grey", "Red", "Yellow", "Green", "Blue"]>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>]>;
+/**
+ * Type for macro nodes.
+ *
+ * @category Types
+ */
+export type MacroNode = InfoPanel | ExpandMacro | TocMacro | CodeMacro | StatusMacro;
+//# sourceMappingURL=MacroNode.d.ts.map

package/dist/ast/MacroNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MacroNode.d.ts","sourceRoot":"","sources":["../../src/ast/MacroNode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EACL,SAAS,EACT,OAAO,EACP,KAAK,EACL,SAAS,EAGT,KAAK,EACL,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AAavB;;;;;GAKG;AACH,eAAO,MAAM,UAAU,+DAAgE,CAAA;AAEvF;;;;GAIG;AACH,eAAO,MAAM,SAAS,sEAAgC,CAAA;AAEtD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;EAOpB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAA;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW;;;;;;;;EAMtB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;EAMnB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;EAUpB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW;;;;;;;;EAMtB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,CAAA;AAEhE;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMrB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA"}

package/dist/ast/MacroNode.js

@@ -0,0 +1,164 @@
+/**
+ * Confluence macro AST node types.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { CodeBlock, Heading, Image, Paragraph, RawConfluence, SchemaVersion, Table, ThematicBreak, UnsupportedBlock } from "./BlockNode.js";
+// Reuse SimpleBlockNode for macro children
+const SimpleBlockNode = Schema.Union(Heading, Paragraph, CodeBlock, ThematicBreak, Image, Table, UnsupportedBlock);
+/**
+ * Supported panel type names.
+ * Single source of truth for all panel macros.
+ *
+ * @category MacroNode
+ */
+export const PanelTypes = ["info", "warning", "note", "tip", "error", "panel"];
+/**
+ * Panel type for info/warning/note macros.
+ *
+ * @category MacroNode
+ */
+export const PanelType = Schema.Literal(...PanelTypes);
+/**
+ * Info/Warning/Note panel macro.
+ *
+ * Represents Confluence info, warning, note, tip, and error panels.
+ * In Markdown, rendered as `:::info`, `:::warning`, etc. container syntax.
+ *
+ * @example
+ * ```typescript
+ * import { InfoPanel, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const panel = {
+ *   _tag: "InfoPanel" as const,
+ *   panelType: "warning" as const,
+ *   title: "Important",
+ *   children: [new Paragraph({ children: [new Text({ value: "Be careful!" })] })]
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export const InfoPanel = Schema.Struct({
+    _tag: Schema.Literal("InfoPanel"),
+    version: SchemaVersion,
+    panelType: PanelType,
+    title: Schema.optional(Schema.String),
+    children: Schema.Array(SimpleBlockNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * Expand/collapse macro.
+ *
+ * Represents Confluence expand macro for collapsible content.
+ * In Markdown, rendered as `:::details` container syntax.
+ *
+ * @example
+ * ```typescript
+ * import { ExpandMacro, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const expand = {
+ *   _tag: "ExpandMacro" as const,
+ *   title: "Click to expand",
+ *   children: [new Paragraph({ children: [new Text({ value: "Hidden content" })] })]
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export const ExpandMacro = Schema.Struct({
+    _tag: Schema.Literal("ExpandMacro"),
+    version: SchemaVersion,
+    title: Schema.optional(Schema.String),
+    children: Schema.Array(SimpleBlockNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * Table of contents macro.
+ *
+ * Represents Confluence TOC macro for auto-generated table of contents.
+ * In Markdown, rendered as `[[toc]]` or similar marker.
+ *
+ * @example
+ * ```typescript
+ * import { TocMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const toc = {
+ *   _tag: "TocMacro" as const,
+ *   minLevel: 2,
+ *   maxLevel: 4
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export const TocMacro = Schema.Struct({
+    _tag: Schema.Literal("TocMacro"),
+    version: SchemaVersion,
+    minLevel: Schema.optional(Schema.Number),
+    maxLevel: Schema.optional(Schema.Number),
+    rawConfluence: RawConfluence
+});
+/**
+ * Code macro with syntax highlighting.
+ *
+ * Represents Confluence code macro with language and options.
+ * Different from CodeBlock in that it preserves Confluence-specific options.
+ *
+ * @example
+ * ```typescript
+ * import { CodeMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const code = {
+ *   _tag: "CodeMacro" as const,
+ *   language: "typescript",
+ *   title: "Example",
+ *   code: "const x = 1",
+ *   lineNumbers: true
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export const CodeMacro = Schema.Struct({
+    _tag: Schema.Literal("CodeMacro"),
+    version: SchemaVersion,
+    language: Schema.optional(Schema.String),
+    title: Schema.optional(Schema.String),
+    code: Schema.String,
+    lineNumbers: Schema.optionalWith(Schema.Boolean, { default: () => false }),
+    collapse: Schema.optionalWith(Schema.Boolean, { default: () => false }),
+    firstLine: Schema.optional(Schema.Number),
+    rawConfluence: RawConfluence
+});
+/**
+ * Status macro (colored label).
+ *
+ * @example
+ * ```typescript
+ * import { StatusMacro } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const status = {
+ *   _tag: "StatusMacro" as const,
+ *   text: "In Progress",
+ *   color: "Blue"
+ * }
+ * ```
+ *
+ * @category MacroNode
+ */
+export const StatusMacro = Schema.Struct({
+    _tag: Schema.Literal("StatusMacro"),
+    version: SchemaVersion,
+    text: Schema.String,
+    color: Schema.Literal("Grey", "Red", "Yellow", "Green", "Blue"),
+    rawConfluence: RawConfluence
+});
+/**
+ * Union of all macro node types.
+ *
+ * @category MacroNode
+ */
+export const MacroNode = Schema.Union(InfoPanel, ExpandMacro, TocMacro, CodeMacro, StatusMacro);
+//# sourceMappingURL=MacroNode.js.map