@knpkv/atlassian-common 0.2.0

package/dist/ast/InlineNode.js

@@ -0,0 +1,268 @@
+/**
+ * Inline-level AST nodes for text content (emphasis, links, mentions, etc.).
+ *
+ * **Mental model**
+ *
+ * - **Leaf and recursive nodes**: `Text`, `InlineCode`, `LineBreak` are leaves;
+ *   `Strong`, `Emphasis`, `Highlight` contain nested `InlineNode` children via `Schema.suspend`.
+ * - **Unsupported preservation**: {@link UnsupportedInline} captures raw content that can't be
+ *   mapped, enabling non-destructive roundtrips.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Optional raw source HTML for exact roundtrip preservation.
+ *
+ * @category InlineNode
+ */
+export const RawSource = Schema.optional(Schema.String);
+/**
+ * Plain text content.
+ *
+ * @example
+ * ```typescript
+ * import { Text } from "@knpkv/atlassian-common/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/atlassian-common/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/atlassian-common/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/atlassian-common/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", "adf")
+}) {
+}
+/**
+ * Emoticon/emoji element.
+ *
+ * @example
+ * ```typescript
+ * import { Emoticon } from "@knpkv/atlassian-common/ast"
+ *
+ * const emoji = new Emoticon({
+ *   shortname: ":grinning:",
+ *   emojiId: "1f600",
+ *   fallback: "grinning"
+ * })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Emoticon extends Schema.TaggedClass()("Emoticon", {
+    shortname: Schema.String,
+    emojiId: Schema.String,
+    fallback: Schema.String,
+    rawSource: RawSource
+}) {
+}
+/**
+ * User mention element.
+ *
+ * @example
+ * ```typescript
+ * import { UserMention } from "@knpkv/atlassian-common/ast"
+ *
+ * const mention = new UserMention({ accountId: "557058:..." })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class UserMention extends Schema.TaggedClass()("UserMention", {
+    accountId: Schema.String,
+    rawSource: RawSource
+}) {
+}
+/**
+ * Date/time element.
+ *
+ * @example
+ * ```typescript
+ * import { DateTime } from "@knpkv/atlassian-common/ast"
+ *
+ * const date = new DateTime({ datetime: "2026-01-01" })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class DateTime extends Schema.TaggedClass()("DateTime", {
+    datetime: Schema.String,
+    rawSource: RawSource
+}) {
+}
+/**
+ * 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
+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/atlassian-common/ast"
+ *
+ * const bold = new Strong({ children: [new Text({ value: "important" })] })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Strong extends Schema.TaggedClass()("Strong", {
+    children: Schema.suspend(() => Schema.Array(InlineNode))
+}) {
+}
+/**
+ * Emphasized/italic text.
+ *
+ * @example
+ * ```typescript
+ * import { Emphasis, Text } from "@knpkv/atlassian-common/ast"
+ *
+ * const italic = new Emphasis({ children: [new Text({ value: "emphasized" })] })
+ * ```
+ *
+ * @category InlineNode
+ */
+export class Emphasis extends Schema.TaggedClass()("Emphasis", {
+    children: Schema.suspend(() => Schema.Array(InlineNode))
+}) {
+}
+/**
+ * Hyperlink with optional title.
+ *
+ * @example
+ * ```typescript
+ * import { Link, Text } from "@knpkv/atlassian-common/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.suspend(() => Schema.Array(InlineNode)),
+    rawSource: RawSource
+}) {
+}
+/**
+ * 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,214 @@
+/**
+ * Confluence macro AST nodes (panels, expand, TOC, code, status).
+ *
+ * **Mental model**
+ *
+ * - **Macro = structured metadata + block children**: Each macro wraps Confluence-specific
+ *   semantics (panel type, code language, status color) around standard block content.
+ * - **Serialization-friendly**: Macros carry enough metadata for Markdown comment encoding
+ *   and ADF reconstruction.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Supported panel type names.
+ *
+ * @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.
+ *
+ * @example
+ * ```typescript
+ * import { InfoPanel, Paragraph, Text } from "@knpkv/atlassian-common/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 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]>>;
+    rawSource: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for InfoPanel.
+ *
+ * @category Types
+ */
+export type InfoPanel = Schema.Schema.Type<typeof InfoPanel>;
+/**
+ * Expand/collapse macro.
+ *
+ * @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 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]>>;
+    rawSource: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for ExpandMacro.
+ *
+ * @category Types
+ */
+export type ExpandMacro = Schema.Schema.Type<typeof ExpandMacro>;
+/**
+ * Table of contents macro.
+ *
+ * @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>;
+    rawSource: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for TocMacro.
+ *
+ * @category Types
+ */
+export type TocMacro = Schema.Schema.Type<typeof TocMacro>;
+/**
+ * Code macro with syntax highlighting.
+ *
+ * @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>;
+    rawSource: Schema.optional<typeof Schema.String>;
+}>;
+/**
+ * Type for CodeMacro.
+ *
+ * @category Types
+ */
+export type CodeMacro = Schema.Schema.Type<typeof CodeMacro>;
+/**
+ * Status macro (colored label).
+ *
+ * @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"]>;
+    rawSource: 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 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]>>;
+    rawSource: 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]>>;
+    rawSource: 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>;
+    rawSource: 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>;
+    rawSource: 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"]>;
+    rawSource: 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;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;;GAIG;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;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;EAOpB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAA;AAE5D;;;;GAIG;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,QAAQ;;;;;;;;EAMnB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;EAUpB,CAAA;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,CAAA;AAE5D;;;;GAIG;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,110 @@
+/**
+ * Confluence macro AST nodes (panels, expand, TOC, code, status).
+ *
+ * **Mental model**
+ *
+ * - **Macro = structured metadata + block children**: Each macro wraps Confluence-specific
+ *   semantics (panel type, code language, status color) around standard block content.
+ * - **Serialization-friendly**: Macros carry enough metadata for Markdown comment encoding
+ *   and ADF reconstruction.
+ *
+ * @module
+ */
+import * as Schema from "effect/Schema";
+import { RawSource, SchemaVersion, SimpleBlockNode } from "./BlockNode.js";
+/**
+ * Supported panel type names.
+ *
+ * @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.
+ *
+ * @example
+ * ```typescript
+ * import { InfoPanel, Paragraph, Text } from "@knpkv/atlassian-common/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),
+    rawSource: RawSource
+});
+/**
+ * Expand/collapse macro.
+ *
+ * @category MacroNode
+ */
+export const ExpandMacro = Schema.Struct({
+    _tag: Schema.Literal("ExpandMacro"),
+    version: SchemaVersion,
+    title: Schema.optional(Schema.String),
+    children: Schema.Array(SimpleBlockNode),
+    rawSource: RawSource
+});
+/**
+ * Table of contents macro.
+ *
+ * @category MacroNode
+ */
+export const TocMacro = Schema.Struct({
+    _tag: Schema.Literal("TocMacro"),
+    version: SchemaVersion,
+    minLevel: Schema.optional(Schema.Number),
+    maxLevel: Schema.optional(Schema.Number),
+    rawSource: RawSource
+});
+/**
+ * Code macro with syntax highlighting.
+ *
+ * @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),
+    rawSource: RawSource
+});
+/**
+ * Status macro (colored label).
+ *
+ * @category MacroNode
+ */
+export const StatusMacro = Schema.Struct({
+    _tag: Schema.Literal("StatusMacro"),
+    version: SchemaVersion,
+    text: Schema.String,
+    color: Schema.Literal("Grey", "Red", "Yellow", "Green", "Blue"),
+    rawSource: RawSource
+});
+/**
+ * Union of all macro node types.
+ *
+ * @category MacroNode
+ */
+export const MacroNode = Schema.Union(InfoPanel, ExpandMacro, TocMacro, CodeMacro, StatusMacro);
+//# sourceMappingURL=MacroNode.js.map

package/dist/ast/MacroNode.js.map

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

package/dist/ast/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Barrel export for Atlassian AST node types and constructors.
+ *
+ * @module
+ */
+export { ColoredText, DateTime, Emoticon, Emphasis, Highlight, InlineCode, InlineNode, type InlineNode as InlineNodeType, InlineNodeChildren, LineBreak, Link, RawSource as InlineRawSource, Strikethrough, Strong, Subscript, Superscript, Text, Underline, UnsupportedInline, UserMention } from "./InlineNode.js";
+export { BlockNode, type BlockNode as BlockNodeType, BlockQuote, CodeBlock, Heading, Image, ImageAttachment, type ImageAttachment as ImageAttachmentType, List, ListItem, Paragraph, RawSource, SchemaVersion, SimpleBlockNode, Table, TableCell, TableRow, TaskItem, type TaskItem as TaskItemType, TaskList, type TaskList as TaskListType, TextAlignment, type TextAlignment as TextAlignmentValue, ThematicBreak, UnsupportedBlock } from "./BlockNode.js";
+export { CodeMacro, type CodeMacro as CodeMacroType, ExpandMacro, type ExpandMacro as ExpandMacroType, InfoPanel, type InfoPanel as InfoPanelType, MacroNode, type MacroNode as MacroNodeType, PanelType, type PanelType as PanelTypeValue, PanelTypes, StatusMacro, type StatusMacro as StatusMacroType, TocMacro, type TocMacro as TocMacroType } from "./MacroNode.js";
+export { Document, type Document as DocumentType, DocumentNode, type DocumentNode as DocumentNodeType, isDocument, makeDocument } from "./Document.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ast/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,KAAK,UAAU,IAAI,cAAc,EACjC,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,SAAS,IAAI,eAAe,EAC5B,aAAa,EACb,MAAM,EACN,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACZ,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,SAAS,EACT,KAAK,SAAS,IAAI,aAAa,EAC/B,UAAU,EACV,SAAS,EACT,OAAO,EACP,KAAK,EACL,eAAe,EACf,KAAK,eAAe,IAAI,mBAAmB,EAC3C,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACb,eAAe,EACf,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,KAAK,QAAQ,IAAI,YAAY,EAC7B,QAAQ,EACR,KAAK,QAAQ,IAAI,YAAY,EAC7B,aAAa,EACb,KAAK,aAAa,IAAI,kBAAkB,EACxC,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,SAAS,EACT,KAAK,SAAS,IAAI,aAAa,EAC/B,WAAW,EACX,KAAK,WAAW,IAAI,eAAe,EACnC,SAAS,EACT,KAAK,SAAS,IAAI,aAAa,EAC/B,SAAS,EACT,KAAK,SAAS,IAAI,aAAa,EAC/B,SAAS,EACT,KAAK,SAAS,IAAI,cAAc,EAChC,UAAU,EACV,WAAW,EACX,KAAK,WAAW,IAAI,eAAe,EACnC,QAAQ,EACR,KAAK,QAAQ,IAAI,YAAY,EAC9B,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,QAAQ,EACR,KAAK,QAAQ,IAAI,YAAY,EAC7B,YAAY,EACZ,KAAK,YAAY,IAAI,gBAAgB,EACrC,UAAU,EACV,YAAY,EACb,MAAM,eAAe,CAAA"}

package/dist/ast/index.js

@@ -0,0 +1,14 @@
+/**
+ * Barrel export for Atlassian AST node types and constructors.
+ *
+ * @module
+ */
+// Inline nodes
+export { ColoredText, DateTime, Emoticon, Emphasis, Highlight, InlineCode, InlineNode, InlineNodeChildren, LineBreak, Link, RawSource as InlineRawSource, Strikethrough, Strong, Subscript, Superscript, Text, Underline, UnsupportedInline, UserMention } from "./InlineNode.js";
+// Block nodes
+export { BlockNode, BlockQuote, CodeBlock, Heading, Image, ImageAttachment, List, ListItem, Paragraph, RawSource, SchemaVersion, SimpleBlockNode, Table, TableCell, TableRow, TaskItem, TaskList, TextAlignment, ThematicBreak, UnsupportedBlock } from "./BlockNode.js";
+// Macro nodes
+export { CodeMacro, ExpandMacro, InfoPanel, MacroNode, PanelType, PanelTypes, StatusMacro, TocMacro } from "./MacroNode.js";
+// Document
+export { Document, DocumentNode, isDocument, makeDocument } from "./Document.js";
+//# sourceMappingURL=index.js.map

package/dist/ast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ast/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EAEV,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,SAAS,IAAI,eAAe,EAC5B,aAAa,EACb,MAAM,EACN,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACZ,MAAM,iBAAiB,CAAA;AAExB,cAAc;AACd,OAAO,EACL,SAAS,EAET,UAAU,EACV,SAAS,EACT,OAAO,EACP,KAAK,EACL,eAAe,EAEf,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,aAAa,EACb,eAAe,EACf,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EAER,QAAQ,EAER,aAAa,EAEb,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AAEvB,cAAc;AACd,OAAO,EACL,SAAS,EAET,WAAW,EAEX,SAAS,EAET,SAAS,EAET,SAAS,EAET,UAAU,EACV,WAAW,EAEX,QAAQ,EAET,MAAM,gBAAgB,CAAA;AAEvB,WAAW;AACX,OAAO,EACL,QAAQ,EAER,YAAY,EAEZ,UAAU,EACV,YAAY,EACb,MAAM,eAAe,CAAA"}