legal-markdown-js 0.1.0

package/dist/core/processors/date-processor.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Date Processing Module for Legal Markdown Documents
+ *
+ * This module provides comprehensive date processing functionality for Legal Markdown
+ * documents, supporting the @today syntax with various formatting options. It handles
+ * different date formats, timezones, locales, and provides specialized formatting
+ * for legal documents including ordinal suffixes and custom format patterns.
+ *
+ * Features:
+ * - @today syntax for current date insertion
+ * - Format override support: @today[format]
+ * - Multiple predefined formats (ISO, US, European, legal, etc.)
+ * - Custom format pattern parsing (YYYY-MM-DD, etc.)
+ * - Timezone and locale support
+ * - Ordinal suffix generation for legal formats
+ * - Graceful error handling with fallback formatting
+ * - Integration with metadata for default settings
+ *
+ * @example
+ * ```typescript
+ * import { processDateReferences } from './date-processor';
+ *
+ * const content = `
+ * This document is dated @today.
+ * Contract effective date: @today[long]
+ * Expiration: @today[YYYY-MM-DD]
+ * Legal format: @today[legal]
+ * `;
+ *
+ * const metadata = {
+ *   'date-format': 'ISO',
+ *   'timezone': 'America/New_York',
+ *   'locale': 'en-US'
+ * };
+ *
+ * const processed = processDateReferences(content, metadata);
+ * console.log(processed);
+ * // Output:
+ * // This document is dated 2024-01-15.
+ * // Contract effective date: January 15, 2024
+ * // Expiration: 2024-01-15
+ * // Legal format: January 15th, 2024
+ * ```
+ */
+import { LegalMarkdownOptions } from '@types';
+/**
+ * Date format options that can be specified in YAML front matter
+ *
+ * @interface DateFormatOptions
+ */
+export interface DateFormatOptions {
+    /** Default date format to use (ISO, US, European, legal, long, medium, short, or custom pattern) */
+    dateFormat?: string;
+    /** Timezone identifier (e.g., 'America/New_York', 'Europe/London', 'UTC') */
+    timezone?: string;
+    /** Locale identifier for formatting (e.g., 'en-US', 'en-GB', 'de-DE') */
+    locale?: string;
+}
+/**
+ * Processes special date references in legal documents
+ *
+ * This is the main function that processes @today references in Legal Markdown
+ * documents. It supports format overrides and uses metadata settings for
+ * default formatting, timezone, and locale preferences.
+ *
+ * @param {string} content - The document content containing @today references
+ * @param {Record<string, any>} metadata - Document metadata with date formatting options
+ * @param {LegalMarkdownOptions} [options={}] - Additional processing options
+ * @returns {string} Processed content with @today references replaced by formatted dates
+ * @example
+ * ```typescript
+ * // Basic usage with default format
+ * const content1 = "Document dated @today";
+ * const result1 = processDateReferences(content1, {});
+ * // Output: "Document dated 2024-01-15"
+ *
+ * // Format override
+ * const content2 = "Contract effective @today[long]";
+ * const result2 = processDateReferences(content2, {});
+ * // Output: "Contract effective January 15, 2024"
+ *
+ * // Using metadata settings
+ * const content3 = "Generated @today";
+ * const metadata = { 'date-format': 'legal', 'timezone': 'America/New_York' };
+ * const result3 = processDateReferences(content3, metadata);
+ * // Output: "Generated January 15th, 2024"
+ * ```
+ */
+export declare function processDateReferences(content: string, metadata: Record<string, any>, options?: LegalMarkdownOptions): string;
+//# sourceMappingURL=date-processor.d.ts.map

package/dist/core/processors/date-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-processor.d.ts","sourceRoot":"","sources":["../../../src/core/processors/date-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,oGAAoG;IACpG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAeR"}

package/dist/core/processors/date-processor.js

@@ -0,0 +1,336 @@
+"use strict";
+/**
+ * @fileoverview Date Processing Module for Legal Markdown Documents
+ *
+ * This module provides comprehensive date processing functionality for Legal Markdown
+ * documents, supporting the @today syntax with various formatting options. It handles
+ * different date formats, timezones, locales, and provides specialized formatting
+ * for legal documents including ordinal suffixes and custom format patterns.
+ *
+ * Features:
+ * - @today syntax for current date insertion
+ * - Format override support: @today[format]
+ * - Multiple predefined formats (ISO, US, European, legal, etc.)
+ * - Custom format pattern parsing (YYYY-MM-DD, etc.)
+ * - Timezone and locale support
+ * - Ordinal suffix generation for legal formats
+ * - Graceful error handling with fallback formatting
+ * - Integration with metadata for default settings
+ *
+ * @example
+ * ```typescript
+ * import { processDateReferences } from './date-processor';
+ *
+ * const content = `
+ * This document is dated @today.
+ * Contract effective date: @today[long]
+ * Expiration: @today[YYYY-MM-DD]
+ * Legal format: @today[legal]
+ * `;
+ *
+ * const metadata = {
+ *   'date-format': 'ISO',
+ *   'timezone': 'America/New_York',
+ *   'locale': 'en-US'
+ * };
+ *
+ * const processed = processDateReferences(content, metadata);
+ * console.log(processed);
+ * // Output:
+ * // This document is dated 2024-01-15.
+ * // Contract effective date: January 15, 2024
+ * // Expiration: 2024-01-15
+ * // Legal format: January 15th, 2024
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processDateReferences = processDateReferences;
+/**
+ * Processes special date references in legal documents
+ *
+ * This is the main function that processes @today references in Legal Markdown
+ * documents. It supports format overrides and uses metadata settings for
+ * default formatting, timezone, and locale preferences.
+ *
+ * @param {string} content - The document content containing @today references
+ * @param {Record<string, any>} metadata - Document metadata with date formatting options
+ * @param {LegalMarkdownOptions} [options={}] - Additional processing options
+ * @returns {string} Processed content with @today references replaced by formatted dates
+ * @example
+ * ```typescript
+ * // Basic usage with default format
+ * const content1 = "Document dated @today";
+ * const result1 = processDateReferences(content1, {});
+ * // Output: "Document dated 2024-01-15"
+ *
+ * // Format override
+ * const content2 = "Contract effective @today[long]";
+ * const result2 = processDateReferences(content2, {});
+ * // Output: "Contract effective January 15, 2024"
+ *
+ * // Using metadata settings
+ * const content3 = "Generated @today";
+ * const metadata = { 'date-format': 'legal', 'timezone': 'America/New_York' };
+ * const result3 = processDateReferences(content3, metadata);
+ * // Output: "Generated January 15th, 2024"
+ * ```
+ */
+function processDateReferences(content, metadata, options = {}) {
+    // Extract date format options from metadata
+    const dateOptions = extractDateOptions(metadata);
+    // Regular expression to match @today references
+    const todayPattern = /@today(?:\[([^\]]+)\])?/g;
+    return content.replace(todayPattern, (match, formatOverride) => {
+        // Use format override if provided, otherwise use metadata format, otherwise use default
+        const format = formatOverride || dateOptions.dateFormat || 'YYYY-MM-DD';
+        const timezone = dateOptions.timezone || 'UTC';
+        const locale = dateOptions.locale || 'en-US';
+        return formatDate(new Date(), format, timezone, locale);
+    });
+}
+/**
+ * Extracts date formatting options from metadata
+ *
+ * Parses document metadata to extract date formatting configuration,
+ * supporting both hyphenated and camelCase property names for flexibility.
+ *
+ * @private
+ * @param {Record<string, any>} metadata - Document metadata containing date options
+ * @returns {DateFormatOptions} Extracted date formatting options
+ * @example
+ * ```typescript
+ * const metadata = {
+ *   'date-format': 'legal',
+ *   'timezone': 'America/New_York',
+ *   'locale': 'en-US'
+ * };
+ *
+ * const options = extractDateOptions(metadata);
+ * // Returns: { dateFormat: 'legal', timezone: 'America/New_York', locale: 'en-US' }
+ * ```
+ */
+function extractDateOptions(metadata) {
+    return {
+        dateFormat: metadata['date-format'] || metadata.dateFormat,
+        timezone: metadata['timezone'] || metadata.tz,
+        locale: metadata['locale'] || metadata.lang,
+    };
+}
+/**
+ * Formats a date according to the specified format, timezone, and locale
+ *
+ * Converts a Date object to a formatted string using various predefined formats
+ * or custom format patterns. Supports timezone conversion and locale-specific
+ * formatting with fallback to ISO format on errors.
+ *
+ * @private
+ * @param {Date} date - The date to format
+ * @param {string} format - Format specification (ISO, US, European, legal, long, etc.)
+ * @param {string} timezone - Timezone identifier (e.g., 'America/New_York')
+ * @param {string} locale - Locale identifier (e.g., 'en-US')
+ * @returns {string} Formatted date string
+ * @example
+ * ```typescript
+ * const date = new Date('2024-01-15');
+ *
+ * console.log(formatDate(date, 'ISO', 'UTC', 'en-US'));        // '2024-01-15'
+ * console.log(formatDate(date, 'US', 'UTC', 'en-US'));         // '01/15/2024'
+ * console.log(formatDate(date, 'legal', 'UTC', 'en-US'));      // 'January 15th, 2024'
+ * console.log(formatDate(date, 'YYYY-MM-DD', 'UTC', 'en-US')); // '2024-01-15'
+ * ```
+ */
+function formatDate(date, format, timezone, locale) {
+    try {
+        // Create a new date in the specified timezone
+        const options = {
+            timeZone: timezone,
+        };
+        // Handle different format patterns
+        switch (format.toLowerCase()) {
+            case 'iso':
+            case 'yyyy-mm-dd':
+                options.year = 'numeric';
+                options.month = '2-digit';
+                options.day = '2-digit';
+                return new Intl.DateTimeFormat('en-CA', options).format(date);
+            case 'us':
+            case 'mm/dd/yyyy':
+                options.year = 'numeric';
+                options.month = '2-digit';
+                options.day = '2-digit';
+                return new Intl.DateTimeFormat('en-US', options).format(date);
+            case 'european':
+            case 'dd/mm/yyyy':
+                options.year = 'numeric';
+                options.month = '2-digit';
+                options.day = '2-digit';
+                return new Intl.DateTimeFormat('en-GB', options).format(date);
+            case 'long':
+                options.year = 'numeric';
+                options.month = 'long';
+                options.day = 'numeric';
+                return new Intl.DateTimeFormat(locale, options).format(date);
+            case 'medium':
+                options.year = 'numeric';
+                options.month = 'short';
+                options.day = 'numeric';
+                return new Intl.DateTimeFormat(locale, options).format(date);
+            case 'short':
+                options.year = '2-digit';
+                options.month = 'short';
+                options.day = 'numeric';
+                return new Intl.DateTimeFormat(locale, options).format(date);
+            case 'legal': {
+                // Legal format: "January 1st, 2024"
+                options.year = 'numeric';
+                options.month = 'long';
+                options.day = 'numeric';
+                const formatted = new Intl.DateTimeFormat(locale, options).format(date);
+                return addOrdinalSuffix(formatted, date.getDate());
+            }
+            default:
+                // Try to parse custom format patterns
+                try {
+                    return parseCustomFormat(date, format, timezone, locale);
+                }
+                catch (error) {
+                    // If custom format parsing fails, fallback to ISO
+                    return date.toISOString().split('T')[0];
+                }
+        }
+    }
+    catch (error) {
+        // Fallback to ISO format if there's an error
+        return date.toISOString().split('T')[0];
+    }
+}
+/**
+ * Adds ordinal suffix to legal format (1st, 2nd, 3rd, etc.)
+ *
+ * Modifies a formatted date string to include ordinal suffixes for the day,
+ * used specifically in legal document formatting.
+ *
+ * @private
+ * @param {string} formatted - The formatted date string
+ * @param {number} day - The day number to add ordinal suffix to
+ * @returns {string} Date string with ordinal suffix
+ * @example
+ * ```typescript
+ * const formatted = addOrdinalSuffix('January 1, 2024', 1);
+ * // Returns: 'January 1st, 2024'
+ * ```
+ */
+function addOrdinalSuffix(formatted, day) {
+    const suffix = getOrdinalSuffix(day);
+    return formatted.replace(/\b\d+\b/, `${day}${suffix}`);
+}
+/**
+ * Gets ordinal suffix for a number
+ *
+ * Determines the appropriate ordinal suffix (st, nd, rd, th) for a given number
+ * following English ordinal number rules.
+ *
+ * @private
+ * @param {number} num - The number to get ordinal suffix for
+ * @returns {string} The ordinal suffix (st, nd, rd, or th)
+ * @example
+ * ```typescript
+ * console.log(getOrdinalSuffix(1));  // 'st'
+ * console.log(getOrdinalSuffix(2));  // 'nd'
+ * console.log(getOrdinalSuffix(3));  // 'rd'
+ * console.log(getOrdinalSuffix(4));  // 'th'
+ * console.log(getOrdinalSuffix(11)); // 'th'
+ * console.log(getOrdinalSuffix(21)); // 'st'
+ * ```
+ */
+function getOrdinalSuffix(num) {
+    const lastDigit = num % 10;
+    const lastTwoDigits = num % 100;
+    if (lastTwoDigits >= 11 && lastTwoDigits <= 13) {
+        return 'th';
+    }
+    switch (lastDigit) {
+        case 1:
+            return 'st';
+        case 2:
+            return 'nd';
+        case 3:
+            return 'rd';
+        default:
+            return 'th';
+    }
+}
+/**
+ * Parses custom date format patterns
+ *
+ * Processes custom date format strings using token replacement patterns.
+ * Supports various tokens like YYYY, MM, DD, etc., and throws an error
+ * for invalid or unrecognized format patterns.
+ *
+ * @private
+ * @param {Date} date - The date to format
+ * @param {string} format - Custom format pattern string
+ * @param {string} timezone - Timezone identifier
+ * @param {string} locale - Locale identifier
+ * @returns {string} Formatted date string
+ * @throws {Error} When format pattern is invalid or contains unrecognized tokens
+ * @example
+ * ```typescript
+ * const date = new Date('2024-01-15');
+ *
+ * console.log(parseCustomFormat(date, 'YYYY-MM-DD', 'UTC', 'en-US')); // '2024-01-15'
+ * console.log(parseCustomFormat(date, 'DD/MM/YYYY', 'UTC', 'en-US')); // '15/01/2024'
+ * console.log(parseCustomFormat(date, 'MMMM D, YYYY', 'UTC', 'en-US')); // 'January 15, 2024'
+ * ```
+ */
+function parseCustomFormat(date, format, timezone, locale) {
+    const options = {
+        timeZone: timezone,
+    };
+    // Define token patterns and their formatters
+    const tokenPatterns = [
+        {
+            pattern: /YYYY/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, year: 'numeric' }).format(date),
+        },
+        {
+            pattern: /YY/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, year: '2-digit' }).format(date),
+        },
+        {
+            pattern: /MMMM/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, month: 'long' }).format(date),
+        },
+        {
+            pattern: /MMM/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, month: 'short' }).format(date),
+        },
+        {
+            pattern: /MM/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, month: '2-digit' }).format(date),
+        },
+        {
+            pattern: /\bM\b/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, month: 'numeric' }).format(date),
+        },
+        {
+            pattern: /DD/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, day: '2-digit' }).format(date),
+        },
+        {
+            pattern: /\bD\b/g,
+            formatter: () => new Intl.DateTimeFormat(locale, { ...options, day: 'numeric' }).format(date),
+        },
+    ];
+    // Apply token replacements
+    let result = format;
+    for (const { pattern, formatter } of tokenPatterns) {
+        result = result.replace(pattern, formatter());
+    }
+    // If result still contains unreplaced tokens of our pattern, it's an invalid format
+    if (result.match(/\b[YMDH]+\b/) || result === format) {
+        throw new Error('Invalid format pattern');
+    }
+    return result;
+}
+//# sourceMappingURL=date-processor.js.map

package/dist/core/processors/date-processor.js.map

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

package/dist/core/processors/header-processor.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Header Processing Module for Legal Markdown Documents
+ *
+ * This module provides comprehensive header processing functionality for Legal Markdown
+ * documents, supporting both traditional (l., ll., lll.) and alternative (lfunction extractHeaderOptions(
+  metadata: Record<string, any>,
+  processingOptions: {
+    noReset?: boolean;
+    noIndent?: boolean;
+    enableFieldTracking?: boolean;
+  }
+): HeaderOptions {l2., l3.)
+ * header syntax. It handles complex numbering schemes, hierarchical structures, and
+ * various formatting options including Roman numerals, alphabetic labels, and custom
+ * indentation patterns.
+ *
+ * Features:
+ * - Dual header syntax support (traditional and alternative)
+ * - Complex hierarchical numbering with automatic level management
+ * - Roman numeral and alphabetic label generation
+ * - Customizable header formatting templates
+ * - Academic and legal document formatting patterns
+ * - Automatic indentation and spacing control
+ * - Continuous numbering and reset control options
+ * - Level-specific formatting with placeholder substitution
+ *
+ * @example
+ * ```typescript
+ * import { processHeaders } from './header-processor';
+ *
+ * const content = `l. Introduction
+ * ll. Terms and Conditions
+ * lll. Payment Terms
+ * l2. Liability`;
+ *
+ * const metadata = {
+ *   'level-one': 'Article %n.',
+ *   'level-two': 'Section %n.',
+ *   'level-three': '(%n)'
+ * };
+ *
+ * const processed = processHeaders(content, metadata);
+ * console.log(processed);
+ * // Output:
+ * // Article 1. Introduction
+ * //   Section 1. Terms and Conditions
+ * //     (1) Payment Terms
+ * //   Section 2. Liability
+ * ```
+ */
+/**
+ * Processes structured headers in a LegalMarkdown document
+ *
+ * This is the main function that processes both traditional (l., ll., lll.) and
+ * alternative (l1., l2., l3.) header syntax. It maintains proper hierarchical
+ * numbering, applies custom formatting templates, and handles complex academic
+ * and legal document structures.
+ *
+ * @param {string} content - The document content containing headers to process
+ * @param {Record<string, any>} metadata - Document metadata with potential header formatting options
+ * @param {Object} [processingOptions={}] - Additional processing options
+ * @param {boolean} [processingOptions.noReset] - Disable header numbering reset (continuous numbering)
+ * @param {boolean} [processingOptions.noIndent] - Disable header indentation (flat formatting)
+ * @returns {string} Processed content with formatted headers
+ * @example
+ * ```typescript
+ * // Basic header processing
+ * const content = `l. First Article
+ * ll. First Section
+ * lll. Subsection A
+ * ll. Second Section
+ * l. Second Article`;
+ *
+ * const metadata = {
+ *   'level-one': 'Article %n.',
+ *   'level-two': 'Section %n.',
+ *   'level-three': '(%c)'
+ * };
+ *
+ * const result = processHeaders(content, metadata);
+ * // Output:
+ * // Article 1. First Article
+ * //   Section 1. First Section
+ * //     (a) Subsection A
+ * //   Section 2. Second Section
+ * // Article 2. Second Article
+ *
+ * // Alternative syntax
+ * const altContent = `l1. Introduction
+ * l2. Background
+ * l3. Technical Details
+ * l2. Implementation
+ * l1. Conclusion`;
+ *
+ * const altResult = processHeaders(altContent, metadata);
+ * // Produces similar hierarchical numbering
+ * ```
+ */
+export declare function processHeaders(content: string, metadata: Record<string, any>, processingOptions?: {
+    noReset?: boolean;
+    noIndent?: boolean;
+    enableFieldTracking?: boolean;
+}): string;
+//# sourceMappingURL=header-processor.d.ts.map

package/dist/core/processors/header-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-processor.d.ts","sourceRoot":"","sources":["../../../src/core/processors/header-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,iBAAiB,GAAE;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,MAAM,CAsGR"}