beancount 0.1.0 → 0.2.0

package/build/src/genericParse.d.mts

@@ -1,27 +1,34 @@
-import type { BeancountEntryType, FakeEntryType } from './entryTypeToClass.mjs';
+import type { BeancountDirectiveNodeType, SyntheticNodeType } from './nodeTypeToClass.mjs';
 import { type Metadata } from './utils/parseMetadata.mjs';
 /**
- * The basic result structure from generic parsing of a Beancount entry.
- * Contains the entry type, header line content, and any properties like comments.
+ * The basic result structure from generic parsing of a Beancount directive.
+ * Contains the directive type, header line content, and any properties like comments.
  */
 export interface GenericParseResult {
-    /** The type of Beancount entry (e.g., 'open', 'close', 'balance') */
-    type: BeancountEntryType;
-    /** The main header content from the first line of the entry */
+    /** The type of Beancount directive (e.g., 'open', 'close', 'balance') */
+    type: BeancountDirectiveNodeType;
+    /** The main header content from the first line of the directive */
     header: string;
-    /** Properties extracted from the entry */
+    /** Properties extracted from the directive */
     props: {
         /** Optional comment text following a semicolon */
         comment?: string;
     };
-    fake?: false;
+    synthetic?: false;
 }
-export interface GenericParseResultFakeEntry extends Omit<GenericParseResult, 'fake' | 'type'> {
-    type: FakeEntryType;
-    fake: true;
+/**
+ * Generic parse result for synthetic (non-directive) nodes.
+ * These represent content that doesn't correspond to actual Beancount directives,
+ * such as comments and blank lines, which are preserved to maintain file structure.
+ */
+export interface GenericParseResultSyntheticNode extends Omit<GenericParseResult, 'synthetic' | 'type'> {
+    /** The synthetic node type (e.g., 'comment', 'blankline') */
+    type: SyntheticNodeType;
+    /** Always true to distinguish synthetic nodes from real Beancount directives */
+    synthetic: true;
 }
 /**
- * Generic parse result for entries that include a date field.
+ * Generic parse result for directives that include a date field.
  * Extends the base result with date and metadata properties.
  */
 export interface GenericParseResultWithDate extends GenericParseResult {
@@ -34,7 +41,7 @@ export interface GenericParseResultWithDate extends GenericParseResult {
     };
 }
 /**
- * Generic parse result specifically for transaction entries.
+ * Generic parse result specifically for transaction directives.
  * Extends the dated result with transaction-specific fields like body lines and flags.
  */
 export interface GenericParseResultTransaction extends Omit<GenericParseResultWithDate, 'metadata'> {
@@ -51,16 +58,16 @@ export interface GenericParseResultTransaction extends Omit<GenericParseResultWi
     };
 }
 /**
- * Performs generic parsing on an unparsed entry to extract common fields.
+ * Performs generic parsing on a source fragment to extract common fields.
  *
  * This function:
- * - Detects if the entry has a date (YYYY-MM-DD format)
- * - Identifies the entry type
+ * - Detects if the directive has a date (YYYY-MM-DD format)
+ * - Identifies the directive type
  * - Extracts header content and comments
  * - Handles transaction-specific parsing (flags, body lines)
- * - Parses metadata for dated entries
+ * - Parses metadata for dated directives
  *
- * @param unparsedEntry - Array of string tokens representing a single entry
- * @returns A generic parse result object appropriate for the entry type
+ * @param sourceFragment - Array of strings that should be parsed to a single node
+ * @returns A generic parse result object appropriate for the node type
  */
-export declare const genericParse: (unparsedEntry: string[]) => GenericParseResult | GenericParseResultTransaction | GenericParseResultWithDate | GenericParseResultFakeEntry;
+export declare const genericParse: (sourceFragment: string[]) => GenericParseResult | GenericParseResultTransaction | GenericParseResultWithDate | GenericParseResultSyntheticNode;

package/build/src/genericParse.mjs

@@ -1,68 +1,68 @@
-import { DATED_ENTRY_TYPES, NON_DATED_ENTRY_TYPES } from './entryTypes.mjs';
+import { DATED_DIRECTIVE_TYPES, NON_DATED_DIRECTIVE_TYPES, } from './directiveTypes.mjs';
 import { parseMetadata } from './utils/parseMetadata.mjs';
 /**
- * Compiles a regex pattern that validates both date format AND entry type.
+ * Compiles a regex pattern that validates both date format AND directive type.
  *
  * The generated pattern matches lines starting with:
  * - Date in YYYY-MM-DD format
  * - Followed by one or more whitespace characters
  * - Followed by either:
- *   - A valid dated entry type keyword from {@link DATED_ENTRY_TYPES}
+ *   - A valid dated node type keyword from {@link DATED_DIRECTIVE_TYPES}
  *   - A transaction flag (* or !)
  *   - The transaction alias 'txn'
  * - Followed by a word boundary to prevent partial matches
  *
- * This ensures that only valid Beancount directives with correct entry types
- * are recognized. Invalid entry types will be treated as comments.
+ * This ensures that only valid Beancount directives with correct node types
+ * are recognized. Invalid directive types will be treated as comments.
  *
  * Pattern: `^YYYY-MM-DD\s+(validType|[*!]|txn)\b`
  *
- * @returns A RegExp that validates dated entry lines
+ * @returns A RegExp that validates dated node lines
  */
-function compileEntryRegex() {
-    // Join all non dated entry types with | for regex alternation
-    const nonDatedEntryPattern = NON_DATED_ENTRY_TYPES.join('|');
-    // Join all dated entry types with | for regex alternation
-    const datedEntryTypePattern = [
-        ...DATED_ENTRY_TYPES,
+function compileDirectivePattern() {
+    // Join all non dated directive types with | for regex alternation
+    const nonDatedDirectivesPattern = NON_DATED_DIRECTIVE_TYPES.join('|');
+    // Join all dated directive types with | for regex alternation
+    const datedDirectivesTypePattern = [
+        ...DATED_DIRECTIVE_TYPES,
         'txn',
         '[^ ]' /* flag */,
     ].join('|');
     const datePattern = `\\d{4}-\\d{2}-\\d{2}`;
-    const datedEntryPattern = `${datePattern} +(?:${datedEntryTypePattern})`;
-    const pattern = `^(?:${nonDatedEntryPattern})|(?:^${datedEntryPattern}) `;
+    const datedDirectivesPattern = `${datePattern} +(?:${datedDirectivesTypePattern})`;
+    const pattern = `^(?:${nonDatedDirectivesPattern})|(?:^${datedDirectivesPattern}) `;
     return new RegExp(pattern);
 }
 /**
- * Regex pattern to identify Beancount entries that start with a date.
- * Generated from {@link NON_DATED_ENTRY_TYPES} and {@link DATED_ENTRY_TYPES} to ensure validation of entry types.
+ * Regex pattern to identify Beancount directives that start with a date.
+ * Generated from {@link NON_DATED_DIRECTIVE_TYPES} and {@link DATED_DIRECTIVE_TYPES} to ensure validation of directive types.
  */
-const beanCountEntryRegex = compileEntryRegex();
+const beanCountDirectiveRegex = compileDirectivePattern();
 /**
- * Performs generic parsing on an unparsed entry to extract common fields.
+ * Performs generic parsing on a source fragment to extract common fields.
  *
  * This function:
- * - Detects if the entry has a date (YYYY-MM-DD format)
- * - Identifies the entry type
+ * - Detects if the directive has a date (YYYY-MM-DD format)
+ * - Identifies the directive type
  * - Extracts header content and comments
  * - Handles transaction-specific parsing (flags, body lines)
- * - Parses metadata for dated entries
+ * - Parses metadata for dated directives
  *
- * @param unparsedEntry - Array of string tokens representing a single entry
- * @returns A generic parse result object appropriate for the entry type
+ * @param sourceFragment - Array of strings that should be parsed to a single node
+ * @returns A generic parse result object appropriate for the node type
  */
-export const genericParse = (unparsedEntry) => {
-    const [firstLine, ...rest] = unparsedEntry;
+export const genericParse = (sourceFragment) => {
+    const [firstLine, ...rest] = sourceFragment;
     if (firstLine.trim() === '') {
-        return { type: 'blankline', header: '', props: {}, fake: true };
+        return { type: 'blankline', header: '', props: {}, synthetic: true };
     }
-    if (!beanCountEntryRegex.test(firstLine)) {
-        // not a valid beancount entry, return it as a comment
+    if (!beanCountDirectiveRegex.test(firstLine)) {
+        // not a valid beancount directive, return it as a comment
         return {
             type: 'comment',
-            header: unparsedEntry.join('\n'),
+            header: sourceFragment.join('\n'),
             props: {},
-            fake: true,
+            synthetic: true,
         };
     }
     const splitFirstLine = firstLine.split(' ');

package/build/src/main.d.mts

@@ -3,7 +3,7 @@
  *
  * @remarks
  * The primary function you'll use is {@link parse}, which parses a complete Beancount file
- * and returns a {@link ParseResult} containing all parsed entries.
+ * and returns a {@link ParseResult} containing parsed nodes.
  *
  * @example
  * ```typescript
@@ -17,43 +17,42 @@
  * `
  *
  * const result = parse(beancountContent)
- * console.log(result.entries) // Array of parsed Entry objects
+ * console.log(result.nodes) // Array of parsed Node objects
  * ```
  *
  * @module
  */
-export { parse, parseEntry } from './parse.mjs';
-export { deserializeEntry, deserializeEntryFromString, deserializeEntries, deserializeEntriesFromString, } from './deserialize.mjs';
+export { parse, parseSourceFragment } from './parse.mjs';
+export { deserializeNode, deserializeNodeFromString, deserializeNodes, deserializeNodesFromString, } from './deserialize.mjs';
 export { parseFile, type ParseFileOptions, type FileSystemHelpers, } from './parseFile.mjs';
 export type { GenericParseResult, GenericParseResultWithDate, GenericParseResultTransaction, } from './genericParse.mjs';
 export type { Metadata } from './utils/parseMetadata.mjs';
 export { ParseResult, type ParseResultObj, type FormatOptions, type CalculateCurrencyColumnOptions, } from './classes/ParseResult.mjs';
-export { Entry, assertEntryConstructor } from './classes/Entry.mjs';
-export { DateEntry } from './classes/DateEntry.mjs';
-export type { BeancountDateEntryType } from './classes/DateEntry.mjs';
+export { Node, assertNodeConstructor } from './classes/Node.mjs';
+export { DatedNode } from './classes/DatedNode.mjs';
 export { Value } from './classes/Value.mjs';
 export type { ValueType } from './classes/Value.mjs';
-export { Balance } from './classes/entryTypes/Balance.mjs';
-export { Blankline } from './classes/entryTypes/Blankline.mjs';
-export { Close } from './classes/entryTypes/Close.mjs';
-export { Comment } from './classes/entryTypes/Comment.mjs';
-export { Commodity } from './classes/entryTypes/Commodity.mjs';
-export { Custom } from './classes/entryTypes/Custom.mjs';
-export { Document } from './classes/entryTypes/Document.mjs';
-export { Event } from './classes/entryTypes/Event.mjs';
-export { Include } from './classes/entryTypes/Include.mjs';
-export { Note } from './classes/entryTypes/Note.mjs';
-export { Open } from './classes/entryTypes/Open.mjs';
-export { Option } from './classes/entryTypes/Option.mjs';
-export { Pad } from './classes/entryTypes/Pad.mjs';
-export { Plugin } from './classes/entryTypes/Plugin.mjs';
-export { Poptag } from './classes/entryTypes/Poptag.mjs';
-export { Price } from './classes/entryTypes/Price.mjs';
-export { Pushtag } from './classes/entryTypes/Pushtag.mjs';
-export { Query } from './classes/entryTypes/Query.mjs';
-export { Transaction, type PostingComment, } from './classes/entryTypes/Transaction/index.mjs';
-export { Posting } from './classes/entryTypes/Transaction/Posting.mjs';
-export { Tag } from './classes/entryTypes/Transaction/Tag.mjs';
-export type { BeancountEntryType, EntryType, FakeEntryType, BeancountDatedEntryType, BeancountNonDatedEntryType, } from './entryTypeToClass.mjs';
-export { beancountEntryToClass, entryTypeToClass } from './entryTypeToClass.mjs';
-export { DATED_ENTRY_TYPES, NON_DATED_ENTRY_TYPES } from './entryTypes.mjs';
+export { Balance } from './classes/nodes/Balance.mjs';
+export { Blankline } from './classes/nodes/Blankline.mjs';
+export { Close } from './classes/nodes/Close.mjs';
+export { Comment } from './classes/nodes/Comment.mjs';
+export { Commodity } from './classes/nodes/Commodity.mjs';
+export { Custom } from './classes/nodes/Custom.mjs';
+export { Document } from './classes/nodes/Document.mjs';
+export { Event } from './classes/nodes/Event.mjs';
+export { Include } from './classes/nodes/Include.mjs';
+export { Note } from './classes/nodes/Note.mjs';
+export { Open } from './classes/nodes/Open.mjs';
+export { Option } from './classes/nodes/Option.mjs';
+export { Pad } from './classes/nodes/Pad.mjs';
+export { Plugin } from './classes/nodes/Plugin.mjs';
+export { Poptag } from './classes/nodes/Poptag.mjs';
+export { Price } from './classes/nodes/Price.mjs';
+export { Pushtag } from './classes/nodes/Pushtag.mjs';
+export { Query } from './classes/nodes/Query.mjs';
+export { Transaction, type PostingComment, } from './classes/nodes/Transaction/index.mjs';
+export { Posting } from './classes/nodes/Transaction/Posting.mjs';
+export { Tag } from './classes/nodes/Transaction/Tag.mjs';
+export type { BeancountDirectiveNodeType, NodeType, SyntheticNodeType, DatedDirectiveNodeType, NonDatedDirectiveNodeType, } from './nodeTypeToClass.mjs';
+export { beancountDirectiveNodeTypeToClass, nodeTypeToClass, } from './nodeTypeToClass.mjs';
+export { DATED_DIRECTIVE_TYPES, NON_DATED_DIRECTIVE_TYPES, } from './directiveTypes.mjs';

package/build/src/main.mjs

@@ -3,7 +3,7 @@
  *
  * @remarks
  * The primary function you'll use is {@link parse}, which parses a complete Beancount file
- * and returns a {@link ParseResult} containing all parsed entries.
+ * and returns a {@link ParseResult} containing parsed nodes.
  *
  * @example
  * ```typescript
@@ -17,42 +17,42 @@
  * `
  *
  * const result = parse(beancountContent)
- * console.log(result.entries) // Array of parsed Entry objects
+ * console.log(result.nodes) // Array of parsed Node objects
  * ```
  *
  * @module
  */
 // Primary parsing functionality
-export { parse, parseEntry } from './parse.mjs';
-export { deserializeEntry, deserializeEntryFromString, deserializeEntries, deserializeEntriesFromString, } from './deserialize.mjs';
+export { parse, parseSourceFragment } from './parse.mjs';
+export { deserializeNode, deserializeNodeFromString, deserializeNodes, deserializeNodesFromString, } from './deserialize.mjs';
 export { parseFile, } from './parseFile.mjs';
 // Core classes
 export { ParseResult, } from './classes/ParseResult.mjs';
-export { Entry, assertEntryConstructor } from './classes/Entry.mjs';
-export { DateEntry } from './classes/DateEntry.mjs';
+export { Node, assertNodeConstructor } from './classes/Node.mjs';
+export { DatedNode } from './classes/DatedNode.mjs';
 export { Value } from './classes/Value.mjs';
-// Entry type classes
-export { Balance } from './classes/entryTypes/Balance.mjs';
-export { Blankline } from './classes/entryTypes/Blankline.mjs';
-export { Close } from './classes/entryTypes/Close.mjs';
-export { Comment } from './classes/entryTypes/Comment.mjs';
-export { Commodity } from './classes/entryTypes/Commodity.mjs';
-export { Custom } from './classes/entryTypes/Custom.mjs';
-export { Document } from './classes/entryTypes/Document.mjs';
-export { Event } from './classes/entryTypes/Event.mjs';
-export { Include } from './classes/entryTypes/Include.mjs';
-export { Note } from './classes/entryTypes/Note.mjs';
-export { Open } from './classes/entryTypes/Open.mjs';
-export { Option } from './classes/entryTypes/Option.mjs';
-export { Pad } from './classes/entryTypes/Pad.mjs';
-export { Plugin } from './classes/entryTypes/Plugin.mjs';
-export { Poptag } from './classes/entryTypes/Poptag.mjs';
-export { Price } from './classes/entryTypes/Price.mjs';
-export { Pushtag } from './classes/entryTypes/Pushtag.mjs';
-export { Query } from './classes/entryTypes/Query.mjs';
-export { Transaction, } from './classes/entryTypes/Transaction/index.mjs';
+// Node classes
+export { Balance } from './classes/nodes/Balance.mjs';
+export { Blankline } from './classes/nodes/Blankline.mjs';
+export { Close } from './classes/nodes/Close.mjs';
+export { Comment } from './classes/nodes/Comment.mjs';
+export { Commodity } from './classes/nodes/Commodity.mjs';
+export { Custom } from './classes/nodes/Custom.mjs';
+export { Document } from './classes/nodes/Document.mjs';
+export { Event } from './classes/nodes/Event.mjs';
+export { Include } from './classes/nodes/Include.mjs';
+export { Note } from './classes/nodes/Note.mjs';
+export { Open } from './classes/nodes/Open.mjs';
+export { Option } from './classes/nodes/Option.mjs';
+export { Pad } from './classes/nodes/Pad.mjs';
+export { Plugin } from './classes/nodes/Plugin.mjs';
+export { Poptag } from './classes/nodes/Poptag.mjs';
+export { Price } from './classes/nodes/Price.mjs';
+export { Pushtag } from './classes/nodes/Pushtag.mjs';
+export { Query } from './classes/nodes/Query.mjs';
+export { Transaction, } from './classes/nodes/Transaction/index.mjs';
 // Transaction sub-components
-export { Posting } from './classes/entryTypes/Transaction/Posting.mjs';
-export { Tag } from './classes/entryTypes/Transaction/Tag.mjs';
-export { beancountEntryToClass, entryTypeToClass } from './entryTypeToClass.mjs';
-export { DATED_ENTRY_TYPES, NON_DATED_ENTRY_TYPES } from './entryTypes.mjs';
+export { Posting } from './classes/nodes/Transaction/Posting.mjs';
+export { Tag } from './classes/nodes/Transaction/Tag.mjs';
+export { beancountDirectiveNodeTypeToClass, nodeTypeToClass, } from './nodeTypeToClass.mjs';
+export { DATED_DIRECTIVE_TYPES, NON_DATED_DIRECTIVE_TYPES, } from './directiveTypes.mjs';

package/build/src/nodeTypeToClass.d.mts

@@ -0,0 +1,81 @@
+import { Transaction, Balance, Close, Comment, Commodity, Custom, Document, Event, Include, Note, Open, Option, Pad, Plugin, Poptag, Price, Pushtag, Query, Blankline } from './classes/nodes/index.mjs';
+import type { DATED_DIRECTIVE_TYPES, NON_DATED_DIRECTIVE_TYPES } from './directiveTypes.mjs';
+/**
+ * Union type of all node types that correspond to a Beancount directive that includes a date field.
+ * Derived from {@link DATED_DIRECTIVE_TYPES}.
+ */
+export type DatedDirectiveNodeType = (typeof DATED_DIRECTIVE_TYPES)[number];
+/**
+ * Union type of all node types that correspond to a Beancount directive type that does NOT include
+ * a date field.
+ * Derived from {@link NON_DATED_DIRECTIVE_TYPES}.
+ */
+export type NonDatedDirectiveNodeType = (typeof NON_DATED_DIRECTIVE_TYPES)[number];
+/**
+ * Union type of all node type that corrospond to Beancount directives.
+ * Directive types derived from https://beancount.github.io/docs/beancount_language_syntax.html#directives-1
+ * Node can have additional synthetic types, see {@link SyntheticNodeType}
+ *
+ * Derived from {@link DATED_DIRECTIVE_TYPES} and {@link NON_DATED_DIRECTIVE_TYPES}.
+ */
+export type BeancountDirectiveNodeType = DatedDirectiveNodeType | NonDatedDirectiveNodeType;
+/**
+ * Union type of synthetic node types that are not part of the official Beancount directive syntax.
+ *
+ * These node types are created during parsing to preserve the complete structure of a Beancount file,
+ * enabling lossless round-trip parsing
+ */
+export type SyntheticNodeType = 'comment' | 'blankline';
+/**
+ * Union type of all valid node type names, that being the beancount directive types and the additional
+ * synthetic node types of comment and blankline
+ */
+export type NodeType = BeancountDirectiveNodeType | SyntheticNodeType;
+/**
+ * Mapping of Beancount directive node type names to their corresponding class constructors.
+ * @internal
+ */
+export declare const beancountDirectiveNodeTypeToClass: {
+    transaction: typeof Transaction;
+    balance: typeof Balance;
+    close: typeof Close;
+    commodity: typeof Commodity;
+    custom: typeof Custom;
+    document: typeof Document;
+    event: typeof Event;
+    include: typeof Include;
+    note: typeof Note;
+    open: typeof Open;
+    option: typeof Option;
+    pad: typeof Pad;
+    plugin: typeof Plugin;
+    poptag: typeof Poptag;
+    price: typeof Price;
+    pushtag: typeof Pushtag;
+    query: typeof Query;
+};
+/**
+ * Mapping of all node type names (including synthetic) to their corresponding class constructors.
+ * @internal
+ */
+export declare const nodeTypeToClass: {
+    comment: typeof Comment;
+    blankline: typeof Blankline;
+    transaction: typeof Transaction;
+    balance: typeof Balance;
+    close: typeof Close;
+    commodity: typeof Commodity;
+    custom: typeof Custom;
+    document: typeof Document;
+    event: typeof Event;
+    include: typeof Include;
+    note: typeof Note;
+    open: typeof Open;
+    option: typeof Option;
+    pad: typeof Pad;
+    plugin: typeof Plugin;
+    poptag: typeof Poptag;
+    price: typeof Price;
+    pushtag: typeof Pushtag;
+    query: typeof Query;
+};

package/build/src/nodeTypeToClass.mjs

@@ -0,0 +1,37 @@
+import { Transaction, Balance, Close, Comment, Commodity, Custom, Document, Event, Include, Note, Open, Option, Pad, Plugin, Poptag, Price, Pushtag, Query, Blankline, } from './classes/nodes/index.mjs';
+/**
+ * Mapping of Beancount directive node type names to their corresponding class constructors.
+ * @internal
+ */
+export const beancountDirectiveNodeTypeToClass = {
+    transaction: Transaction,
+    balance: Balance,
+    close: Close,
+    commodity: Commodity,
+    custom: Custom,
+    document: Document,
+    event: Event,
+    include: Include,
+    note: Note,
+    open: Open,
+    option: Option,
+    pad: Pad,
+    plugin: Plugin,
+    poptag: Poptag,
+    price: Price,
+    pushtag: Pushtag,
+    query: Query,
+};
+// Compile-time assertion: beancountDirectiveNodeTypeToClass must have all BeancountDirectiveNodeType keys
+beancountDirectiveNodeTypeToClass;
+/**
+ * Mapping of all node type names (including synthetic) to their corresponding class constructors.
+ * @internal
+ */
+export const nodeTypeToClass = {
+    ...beancountDirectiveNodeTypeToClass,
+    comment: Comment,
+    blankline: Blankline,
+};
+// Compile-time assertion: nodeTypeToClass must have all NodeType keys
+nodeTypeToClass;

package/build/src/parse.d.mts

@@ -1,29 +1,29 @@
 import { ParseResult } from './classes/ParseResult.mjs';
-import { Comment, Blankline } from './classes/entryTypes/index.mjs';
+import { Comment, Blankline } from './classes/nodes/index.mjs';
 /**
- * Parses a single unparsed entry into its corresponding Entry class instance.
+ * Parses a single source fragment into its corresponding Node class instance.
  *
  * This function:
- * - Performs generic parsing to determine entry type
- * - Instantiates the appropriate Entry subclass
+ * - Performs generic parsing to determine node type
+ * - Instantiates the appropriate Node subclass
  * - Handles special cases for comments and blank lines
  *
- * @param unparsedEntry - Array of string tokens representing a single entry
- * @returns An Entry instance
+ * @param sourceFragment - Array of string tokens that should be parsed to a single node
+ * @returns A Node instance
  */
-export declare const parseEntry: (unparsedEntry: string[]) => import("./classes/entryTypes/index.mjs").Transaction | import("./classes/entryTypes/Balance.mjs").Balance | import("./classes/entryTypes/Close.mjs").Close | import("./classes/entryTypes/Commodity.mjs").Commodity | import("./classes/entryTypes/Custom.mjs").Custom | import("./classes/entryTypes/Document.mjs").Document | import("./classes/entryTypes/Event.mjs").Event | import("./classes/entryTypes/Include.mjs").Include | import("./classes/entryTypes/Note.mjs").Note | import("./classes/entryTypes/Open.mjs").Open | import("./classes/entryTypes/Option.mjs").Option | import("./classes/entryTypes/Pad.mjs").Pad | import("./classes/entryTypes/Plugin.mjs").Plugin | import("./classes/entryTypes/Poptag.mjs").Poptag | import("./classes/entryTypes/Price.mjs").Price | import("./classes/entryTypes/Pushtag.mjs").Pushtag | import("./classes/entryTypes/Query.mjs").Query | Comment | Blankline;
+export declare const parseSourceFragment: (sourceFragment: string[]) => import("./classes/nodes/index.mjs").Transaction | import("./classes/nodes/Balance.mjs").Balance | import("./classes/nodes/Close.mjs").Close | import("./classes/nodes/Commodity.mjs").Commodity | import("./classes/nodes/Custom.mjs").Custom | import("./classes/nodes/Document.mjs").Document | import("./classes/nodes/Event.mjs").Event | import("./classes/nodes/Include.mjs").Include | import("./classes/nodes/Note.mjs").Note | import("./classes/nodes/Open.mjs").Open | import("./classes/nodes/Option.mjs").Option | import("./classes/nodes/Pad.mjs").Pad | import("./classes/nodes/Plugin.mjs").Plugin | import("./classes/nodes/Poptag.mjs").Poptag | import("./classes/nodes/Price.mjs").Price | import("./classes/nodes/Pushtag.mjs").Pushtag | import("./classes/nodes/Query.mjs").Query | Comment | Blankline;
 /**
- * Parses a complete Beancount file string into a ParseResult containing Entry objects.
+ * Parses a complete Beancount file string into a ParseResult containing Node objects.
  *
  * This is the main entry point for parsing Beancount files. It handles:
- * - Splitting the input into individual entries
- * - Parsing each entry into its appropriate type
- * - Managing the tag stack for pushtag/poptag directives
+ * - Splitting the source into source fragment
+ * - Parsing each source fragment into its appropriate node
+ * - Managing the tag stack for pushtag/poptag nodes
  * - Applying tags from the stack to transactions
  *
  * @remarks
  * This is the primary function you'll use from this library. It takes a Beancount file
- * as a string and returns a structured ParseResult object containing all parsed entries.
+ * as a string and returns a structured ParseResult object containing the resulting parsed nodes.
  *
  * @example
  * Basic usage:
@@ -38,10 +38,10 @@ export declare const parseEntry: (unparsedEntry: string[]) => import("./classes/
  * `
  *
  * const result = parse(content)
- * // result.entries contains parsed Entry objects
+ * // result.nodes contains parsed Node objects
  * ```
  *
- * @param input - The complete Beancount file content as a string
- * @returns A ParseResult instance containing all parsed entries
+ * @param source - The complete Beancount file content as a string
+ * @returns A ParseResult instance containing all parsed nodes
  */
-export declare const parse: (input: string) => ParseResult;
+export declare const parse: (source: string) => ParseResult;