@knpkv/confluence-to-markdown 0.2.0 → 0.4.1

package/dist/ast/BlockNode.js

@@ -0,0 +1,319 @@
+/**
+ * Block-level AST node types for structural content.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { InlineNode } from "./InlineNode.js";
+/**
+ * Schema version for migration support.
+ *
+ * @category Version
+ */
+export const SchemaVersion = Schema.Number.pipe(Schema.int(), Schema.positive(), Schema.optionalWith({ default: () => 1 }));
+/**
+ * Optional raw Confluence HTML for exact roundtrip preservation.
+ * When present, the Confluence serializer will output this instead of reconstructing.
+ *
+ * @category BlockNode
+ */
+export const RawConfluence = Schema.optional(Schema.String);
+/**
+ * Heading element (h1-h6).
+ *
+ * @example
+ * ```typescript
+ * import { Heading, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const h1 = new Heading({
+ *   level: 1,
+ *   children: [new Text({ value: "Introduction" })]
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class Heading extends Schema.TaggedClass()("Heading", {
+    version: SchemaVersion,
+    level: Schema.Literal(1, 2, 3, 4, 5, 6),
+    children: Schema.Array(InlineNode),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Text alignment options.
+ *
+ * @category BlockNode
+ */
+export const TextAlignment = Schema.Literal("left", "center", "right");
+/**
+ * Paragraph element with optional alignment and indentation.
+ *
+ * @example
+ * ```typescript
+ * import { Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const para = new Paragraph({
+ *   children: [new Text({ value: "Hello world" })]
+ * })
+ *
+ * // With alignment
+ * const centered = new Paragraph({
+ *   alignment: "center",
+ *   children: [new Text({ value: "Centered text" })]
+ * })
+ *
+ * // With indentation (in pixels)
+ * const indented = new Paragraph({
+ *   indent: 30,
+ *   children: [new Text({ value: "Indented text" })]
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class Paragraph extends Schema.TaggedClass()("Paragraph", {
+    version: SchemaVersion,
+    alignment: Schema.optional(TextAlignment),
+    indent: Schema.optional(Schema.Number),
+    children: Schema.Array(InlineNode),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Code block with optional language.
+ *
+ * @example
+ * ```typescript
+ * import { CodeBlock } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const code = new CodeBlock({
+ *   language: "typescript",
+ *   code: "const x = 1"
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class CodeBlock extends Schema.TaggedClass()("CodeBlock", {
+    version: SchemaVersion,
+    language: Schema.optional(Schema.String),
+    code: Schema.String,
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Thematic break / horizontal rule.
+ *
+ * @example
+ * ```typescript
+ * import { ThematicBreak } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const hr = new ThematicBreak({})
+ * ```
+ *
+ * @category BlockNode
+ */
+export class ThematicBreak extends Schema.TaggedClass()("ThematicBreak", {
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Attachment reference for images stored in Confluence.
+ *
+ * @category BlockNode
+ */
+export const ImageAttachment = Schema.Struct({
+    filename: Schema.String,
+    version: Schema.optional(Schema.Number)
+});
+/**
+ * Image element with support for both URL and Confluence attachments.
+ *
+ * @example
+ * ```typescript
+ * import { Image } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * // URL-based image
+ * const img = new Image({
+ *   src: "https://example.com/image.png",
+ *   alt: "Example image"
+ * })
+ *
+ * // Confluence attachment
+ * const attachment = new Image({
+ *   attachment: { filename: "logo.svg" },
+ *   align: "center",
+ *   width: 250
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class Image extends Schema.TaggedClass()("Image", {
+    version: SchemaVersion,
+    src: Schema.optional(Schema.String),
+    attachment: Schema.optional(ImageAttachment),
+    alt: Schema.optional(Schema.String),
+    title: Schema.optional(Schema.String),
+    align: Schema.optional(Schema.String),
+    width: Schema.optional(Schema.Number),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Table cell element.
+ *
+ * @example
+ * ```typescript
+ * import { TableCell, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const cell = new TableCell({
+ *   isHeader: true,
+ *   children: [new Text({ value: "Header" })]
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class TableCell extends Schema.TaggedClass()("TableCell", {
+    isHeader: Schema.optionalWith(Schema.Boolean, { default: () => false }),
+    children: Schema.Array(InlineNode),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Table row element.
+ *
+ * @example
+ * ```typescript
+ * import { TableRow, TableCell, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const row = new TableRow({
+ *   cells: [
+ *     new TableCell({ children: [new Text({ value: "A" })] }),
+ *     new TableCell({ children: [new Text({ value: "B" })] })
+ *   ]
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class TableRow extends Schema.TaggedClass()("TableRow", {
+    cells: Schema.Array(TableCell),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Table element with optional header row.
+ *
+ * @example
+ * ```typescript
+ * import { Table, TableRow, TableCell, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const table = new Table({
+ *   header: new TableRow({
+ *     cells: [new TableCell({ isHeader: true, children: [new Text({ value: "Col" })] })]
+ *   }),
+ *   rows: []
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class Table extends Schema.TaggedClass()("Table", {
+    version: SchemaVersion,
+    header: Schema.optional(TableRow),
+    rows: Schema.Array(TableRow),
+    rawConfluence: RawConfluence
+}) {
+}
+/**
+ * Unsupported block element - preserves raw content for round-tripping.
+ *
+ * @example
+ * ```typescript
+ * import { UnsupportedBlock } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const unknown = new UnsupportedBlock({
+ *   rawHtml: "<custom-block>content</custom-block>",
+ *   source: "confluence"
+ * })
+ * ```
+ *
+ * @category BlockNode
+ */
+export class UnsupportedBlock extends Schema.TaggedClass()("UnsupportedBlock", {
+    rawHtml: Schema.optional(Schema.String),
+    rawMarkdown: Schema.optional(Schema.String),
+    source: Schema.Literal("confluence", "markdown")
+}) {
+}
+// Non-recursive block nodes
+const SimpleBlockNode = Schema.Union(Heading, Paragraph, CodeBlock, ThematicBreak, Image, Table, UnsupportedBlock);
+/**
+ * Block quote element with nested block content.
+ *
+ * @category BlockNode
+ */
+export const BlockQuote = Schema.Struct({
+    _tag: Schema.Literal("BlockQuote"),
+    version: SchemaVersion,
+    children: Schema.Array(SimpleBlockNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * List item with nested block content.
+ *
+ * @category BlockNode
+ */
+export const ListItem = Schema.Struct({
+    _tag: Schema.Literal("ListItem"),
+    checked: Schema.optional(Schema.Boolean),
+    children: Schema.Array(SimpleBlockNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * List element (ordered or unordered).
+ *
+ * @category BlockNode
+ */
+export const List = Schema.Struct({
+    _tag: Schema.Literal("List"),
+    version: SchemaVersion,
+    ordered: Schema.Boolean,
+    start: Schema.optional(Schema.Number),
+    children: Schema.Array(ListItem),
+    rawConfluence: RawConfluence
+});
+/**
+ * Task item with status for Confluence task lists.
+ *
+ * @category BlockNode
+ */
+export const TaskItem = Schema.Struct({
+    _tag: Schema.Literal("TaskItem"),
+    id: Schema.String,
+    uuid: Schema.String,
+    status: Schema.Literal("incomplete", "complete"),
+    body: Schema.Array(InlineNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * Task list (Confluence action items).
+ *
+ * @category BlockNode
+ */
+export const TaskList = Schema.Struct({
+    _tag: Schema.Literal("TaskList"),
+    version: SchemaVersion,
+    children: Schema.Array(TaskItem),
+    rawConfluence: RawConfluence
+});
+/**
+ * Union of all block node types.
+ *
+ * @category BlockNode
+ */
+export const BlockNode = Schema.Union(Heading, Paragraph, CodeBlock, ThematicBreak, BlockQuote, Image, Table, List, TaskList, UnsupportedBlock);
+//# sourceMappingURL=BlockNode.js.map

package/dist/ast/BlockNode.js.map

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

package/dist/ast/Document.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Document AST node - the root of the AST tree.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { type BlockNode as BlockNodeType } from "./BlockNode.js";
+import { type MacroNode as MacroNodeType } from "./MacroNode.js";
+/**
+ * Document node - represents a Block or Macro node.
+ *
+ * @category Document
+ */
+export declare const DocumentNode: Schema.Union<[Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, Schema.Struct<{
+    _tag: Schema.Literal<["BlockQuote"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    children: Schema.Array$<Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").UnsupportedBlock]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, Schema.Struct<{
+    _tag: Schema.Literal<["List"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    ordered: typeof Schema.Boolean;
+    start: Schema.optional<typeof Schema.Number>;
+    children: Schema.Array$<Schema.Struct<{
+        _tag: Schema.Literal<["ListItem"]>;
+        checked: Schema.optional<typeof Schema.Boolean>;
+        children: Schema.Array$<Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").UnsupportedBlock]>>;
+        rawConfluence: Schema.optional<typeof Schema.String>;
+    }>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, Schema.Struct<{
+    _tag: Schema.Literal<["TaskList"]>;
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    children: Schema.Array$<Schema.Struct<{
+        _tag: Schema.Literal<["TaskItem"]>;
+        id: typeof Schema.String;
+        uuid: typeof Schema.String;
+        status: Schema.Literal<["incomplete", "complete"]>;
+        body: Schema.Array$<Schema.Union<[typeof import("./InlineNode.js").Text, typeof import("./InlineNode.js").Strong, typeof import("./InlineNode.js").Emphasis, typeof import("./InlineNode.js").InlineCode, typeof import("./InlineNode.js").Link, typeof import("./InlineNode.js").LineBreak, typeof import("./InlineNode.js").Emoticon, typeof import("./InlineNode.js").UserMention, typeof import("./InlineNode.js").DateTime, typeof import("./InlineNode.js").Underline, typeof import("./InlineNode.js").Subscript, typeof import("./InlineNode.js").Superscript, typeof import("./InlineNode.js").Strikethrough, typeof import("./InlineNode.js").ColoredText, typeof import("./InlineNode.js").Highlight, typeof import("./InlineNode.js").UnsupportedInline]>>;
+        rawConfluence: Schema.optional<typeof Schema.String>;
+    }>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>, typeof import("./BlockNode.js").UnsupportedBlock]>, 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 import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").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 import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").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 document nodes.
+ *
+ * @category Types
+ */
+export type DocumentNode = BlockNodeType | MacroNodeType;
+/**
+ * Document schema - the root AST node.
+ *
+ * @example
+ * ```typescript
+ * import { Document, Heading, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ * import * as Schema from "effect/Schema"
+ *
+ * const doc = {
+ *   version: 1,
+ *   children: [
+ *     new Heading({ level: 1, children: [new Text({ value: "Title" })] }),
+ *     new Paragraph({ children: [new Text({ value: "Content" })] })
+ *   ]
+ * }
+ *
+ * const validated = Schema.decodeUnknownSync(Document)(doc)
+ * ```
+ *
+ * @category Document
+ */
+export declare const Document: Schema.Struct<{
+    version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+        default: () => number;
+    }>;
+    children: Schema.Array$<Schema.Union<[Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, Schema.Struct<{
+        _tag: Schema.Literal<["BlockQuote"]>;
+        version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+            default: () => number;
+        }>;
+        children: Schema.Array$<Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").UnsupportedBlock]>>;
+        rawConfluence: Schema.optional<typeof Schema.String>;
+    }>, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, Schema.Struct<{
+        _tag: Schema.Literal<["List"]>;
+        version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+            default: () => number;
+        }>;
+        ordered: typeof Schema.Boolean;
+        start: Schema.optional<typeof Schema.Number>;
+        children: Schema.Array$<Schema.Struct<{
+            _tag: Schema.Literal<["ListItem"]>;
+            checked: Schema.optional<typeof Schema.Boolean>;
+            children: Schema.Array$<Schema.Union<[typeof import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").UnsupportedBlock]>>;
+            rawConfluence: Schema.optional<typeof Schema.String>;
+        }>>;
+        rawConfluence: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        _tag: Schema.Literal<["TaskList"]>;
+        version: Schema.optionalWith<Schema.filter<Schema.filter<typeof Schema.Number>>, {
+            default: () => number;
+        }>;
+        children: Schema.Array$<Schema.Struct<{
+            _tag: Schema.Literal<["TaskItem"]>;
+            id: typeof Schema.String;
+            uuid: typeof Schema.String;
+            status: Schema.Literal<["incomplete", "complete"]>;
+            body: Schema.Array$<Schema.Union<[typeof import("./InlineNode.js").Text, typeof import("./InlineNode.js").Strong, typeof import("./InlineNode.js").Emphasis, typeof import("./InlineNode.js").InlineCode, typeof import("./InlineNode.js").Link, typeof import("./InlineNode.js").LineBreak, typeof import("./InlineNode.js").Emoticon, typeof import("./InlineNode.js").UserMention, typeof import("./InlineNode.js").DateTime, typeof import("./InlineNode.js").Underline, typeof import("./InlineNode.js").Subscript, typeof import("./InlineNode.js").Superscript, typeof import("./InlineNode.js").Strikethrough, typeof import("./InlineNode.js").ColoredText, typeof import("./InlineNode.js").Highlight, typeof import("./InlineNode.js").UnsupportedInline]>>;
+            rawConfluence: Schema.optional<typeof Schema.String>;
+        }>>;
+        rawConfluence: Schema.optional<typeof Schema.String>;
+    }>, typeof import("./BlockNode.js").UnsupportedBlock]>, 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 import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").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 import("./BlockNode.js").Heading, typeof import("./BlockNode.js").Paragraph, typeof import("./BlockNode.js").CodeBlock, typeof import("./BlockNode.js").ThematicBreak, typeof import("./BlockNode.js").Image, typeof import("./BlockNode.js").Table, typeof import("./BlockNode.js").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>;
+    }>]>]>>;
+    rawConfluence: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for Document.
+ *
+ * @category Types
+ */
+export type Document = Schema.Schema.Type<typeof Document>;
+/**
+ * Create a new Document with default version.
+ *
+ * @example
+ * ```typescript
+ * import { makeDocument, Heading, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const doc = makeDocument([
+ *   new Heading({ level: 1, children: [new Text({ value: "Hello" })] })
+ * ])
+ * ```
+ *
+ * @category Constructors
+ */
+export declare const makeDocument: (children: ReadonlyArray<DocumentNode>, rawConfluence?: string) => Document;
+/**
+ * Check if a node is a Document.
+ *
+ * @category Guards
+ */
+export declare const isDocument: (value: unknown) => value is Document;
+//# sourceMappingURL=Document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Document.d.ts","sourceRoot":"","sources":["../../src/ast/Document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAa,KAAK,SAAS,IAAI,aAAa,EAAgC,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAa,KAAK,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAqC,CAAA;AAE9D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAInB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,aAAa,CAAC,YAAY,CAAC,EACrC,gBAAgB,MAAM,KACrB,QAID,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,QAIR,CAAA"}

package/dist/ast/Document.js

@@ -0,0 +1,69 @@
+/**
+ * Document AST node - the root of the AST tree.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { BlockNode, RawConfluence, SchemaVersion } from "./BlockNode.js";
+import { MacroNode } from "./MacroNode.js";
+/**
+ * Document node - represents a Block or Macro node.
+ *
+ * @category Document
+ */
+export const DocumentNode = Schema.Union(BlockNode, MacroNode);
+/**
+ * Document schema - the root AST node.
+ *
+ * @example
+ * ```typescript
+ * import { Document, Heading, Paragraph, Text } from "@knpkv/confluence-to-markdown/ast"
+ * import * as Schema from "effect/Schema"
+ *
+ * const doc = {
+ *   version: 1,
+ *   children: [
+ *     new Heading({ level: 1, children: [new Text({ value: "Title" })] }),
+ *     new Paragraph({ children: [new Text({ value: "Content" })] })
+ *   ]
+ * }
+ *
+ * const validated = Schema.decodeUnknownSync(Document)(doc)
+ * ```
+ *
+ * @category Document
+ */
+export const Document = Schema.Struct({
+    version: SchemaVersion,
+    children: Schema.Array(DocumentNode),
+    rawConfluence: RawConfluence
+});
+/**
+ * Create a new Document with default version.
+ *
+ * @example
+ * ```typescript
+ * import { makeDocument, Heading, Text } from "@knpkv/confluence-to-markdown/ast"
+ *
+ * const doc = makeDocument([
+ *   new Heading({ level: 1, children: [new Text({ value: "Hello" })] })
+ * ])
+ * ```
+ *
+ * @category Constructors
+ */
+export const makeDocument = (children, rawConfluence) => ({
+    version: 1,
+    children,
+    ...(rawConfluence !== undefined ? { rawConfluence } : {})
+});
+/**
+ * Check if a node is a Document.
+ *
+ * @category Guards
+ */
+export const isDocument = (value) => typeof value === "object" &&
+    value !== null &&
+    "children" in value &&
+    Array.isArray(value.children);
+//# sourceMappingURL=Document.js.map

package/dist/ast/Document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Document.js","sourceRoot":"","sources":["../../src/ast/Document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,SAAS,EAAmC,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACzG,OAAO,EAAE,SAAS,EAAmC,MAAM,gBAAgB,CAAA;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;AAS9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;IACpC,aAAa,EAAE,aAAa;CAC7B,CAAC,CAAA;AASF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,QAAqC,EACrC,aAAsB,EACZ,EAAE,CAAC,CAAC;IACd,OAAO,EAAE,CAAC;IACV,QAAQ;IACR,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CAC9D,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,UAAU,IAAI,KAAK;IACnB,KAAK,CAAC,OAAO,CAAE,KAAkB,CAAC,QAAQ,CAAC,CAAA"}