legal-markdown-js 0.1.0

package/dist/helpers/date-helpers.js

@@ -0,0 +1,402 @@
+"use strict";
+/**
+ * @fileoverview Date Manipulation and Formatting Helpers
+ *
+ * This module provides comprehensive date manipulation and formatting utilities
+ * specifically designed for legal documents. It includes functions for date
+ * arithmetic, parsing, and formatting with legal-specific date formats.
+ *
+ * Features:
+ * - Date arithmetic (add years, months, days)
+ * - Flexible date formatting with multiple format options
+ * - Legal-specific date formats (formal, ordinal, etc.)
+ * - Date parsing with format detection
+ * - Comprehensive error handling for invalid dates
+ *
+ * @example
+ * ```typescript
+ * import { formatDate, addYears, DateFormats } from './date-helpers';
+ *
+ * // Format a date for legal documents
+ * const legalDate = formatDate(new Date(), DateFormats.LEGAL);
+ * // Result: "16th day of July, 2025"
+ *
+ * // Add years to a contract date
+ * const expiryDate = addYears('2025-01-01', 5);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateFormats = void 0;
+exports.addYears = addYears;
+exports.addDays = addDays;
+exports.addMonths = addMonths;
+exports.formatDate = formatDate;
+exports.parseDate = parseDate;
+/**
+ * Adds a specified number of years to a date
+ *
+ * This function handles both Date objects and ISO date strings, making it
+ * useful for contract calculations and legal document date processing.
+ *
+ * @param {Date | string} date - The base date as a Date object or ISO string
+ * @param {number} years - The number of years to add (can be negative)
+ * @returns {Date} A new Date object with the years added
+ * @throws {Error} If the input date is invalid
+ *
+ * @example
+ * ```typescript
+ * // Add 5 years to a contract start date
+ * const startDate = new Date('2025-01-01');
+ * const endDate = addYears(startDate, 5);
+ * // Result: Date object for 2030-01-01
+ *
+ * // Using with string input
+ * const futureDate = addYears('2025-07-16', 2);
+ * // Result: Date object for 2027-07-16
+ *
+ * // Subtract years (negative input)
+ * const pastDate = addYears(new Date(), -3);
+ * ```
+ */
+function addYears(date, years) {
+    if (!date) {
+        throw new Error('Date is required for addYears');
+    }
+    const d = typeof date === 'string' ? new Date(date) : new Date(date);
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid date: ${date}`);
+    }
+    d.setFullYear(d.getFullYear() + years);
+    return d;
+}
+/**
+ * Adds a specified number of days to a date
+ *
+ * Useful for calculating deadlines, notice periods, and other time-sensitive
+ * legal requirements in contracts and legal documents.
+ *
+ * @param {Date | string} date - The base date as a Date object or ISO string
+ * @param {number} days - The number of days to add (can be negative)
+ * @returns {Date} A new Date object with the days added
+ * @throws {Error} If the input date is invalid
+ *
+ * @example
+ * ```typescript
+ * // Add 30 days for a notice period
+ * const noticeDate = addDays(new Date(), 30);
+ *
+ * // Calculate deadline from string date
+ * const deadline = addDays('2025-07-16', 14);
+ * // Result: Date object for 2025-07-30
+ *
+ * // Go back in time (negative days)
+ * const pastDate = addDays(new Date(), -7);
+ * ```
+ */
+function addDays(date, days) {
+    if (!date) {
+        throw new Error('Date is required for addDays');
+    }
+    const d = typeof date === 'string' ? new Date(date) : new Date(date);
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid date: ${date}`);
+    }
+    d.setDate(d.getDate() + days);
+    return d;
+}
+/**
+ * Adds a specified number of months to a date
+ *
+ * Handles month boundaries intelligently, useful for calculating quarterly
+ * reports, monthly payments, and other periodic legal obligations.
+ *
+ * @param {Date | string} date - The base date as a Date object or ISO string
+ * @param {number} months - The number of months to add (can be negative)
+ * @returns {Date} A new Date object with the months added
+ * @throws {Error} If the input date is invalid
+ *
+ * @example
+ * ```typescript
+ * // Add 6 months for a review period
+ * const reviewDate = addMonths(new Date('2025-01-31'), 6);
+ * // Result: Date object for 2025-07-31
+ *
+ * // Calculate quarterly dates
+ * const quarterlyDate = addMonths('2025-01-01', 3);
+ * // Result: Date object for 2025-04-01
+ *
+ * // Previous months (negative input)
+ * const previousQuarter = addMonths(new Date(), -3);
+ * ```
+ */
+function addMonths(date, months) {
+    if (!date) {
+        throw new Error('Date is required for addMonths');
+    }
+    const d = typeof date === 'string' ? new Date(date) : new Date(date);
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid date: ${date}`);
+    }
+    d.setMonth(d.getMonth() + months);
+    return d;
+}
+/**
+ * Formats a date using customizable format strings
+ *
+ * Provides flexible date formatting with support for multiple format tokens.
+ * Particularly useful for legal documents that require specific date formats
+ * for different jurisdictions and document types.
+ *
+ * @param {Date | string} date - The date to format as a Date object or ISO string
+ * @param {string} format - The format string (default: 'YYYY-MM-DD')
+ * @returns {string} The formatted date string
+ * @throws {Error} If the input date is invalid
+ *
+ * Format tokens:
+ * - YYYY: 4-digit year (2025)
+ * - YY: 2-digit year (25)
+ * - MMMM: Full month name (January)
+ * - MMM: Abbreviated month name (Jan)
+ * - MM: 2-digit month (01)
+ * - M: Month number (1)
+ * - DD: 2-digit day (01)
+ * - D: Day number (1)
+ * - Do: Ordinal day (1st, 2nd, 3rd)
+ * - dddd: Full day name (Monday)
+ * - ddd: Abbreviated day name (Mon)
+ *
+ * @example
+ * ```typescript
+ * const date = new Date('2025-07-16');
+ *
+ * // Standard formats
+ * formatDate(date, 'YYYY-MM-DD');        // "2025-07-16"
+ * formatDate(date, 'MM/DD/YYYY');        // "07/16/2025"
+ * formatDate(date, 'DD/MM/YYYY');        // "16/07/2025"
+ *
+ * // Legal document formats
+ * formatDate(date, DateFormats.LEGAL);   // "16th day of July, 2025"
+ * formatDate(date, DateFormats.FORMAL);  // "Wednesday, July 16th, 2025"
+ *
+ * // Custom format
+ * formatDate(date, 'MMMM Do, YYYY');     // "July 16th, 2025"
+ * ```
+ */
+function formatDate(date, format = 'YYYY-MM-DD') {
+    if (!date) {
+        throw new Error('Date is required for formatting');
+    }
+    const d = typeof date === 'string' ? new Date(date) : date;
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid date: ${date}`);
+    }
+    const year = d.getFullYear();
+    const month = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    const monthNames = [
+        'January',
+        'February',
+        'March',
+        'April',
+        'May',
+        'June',
+        'July',
+        'August',
+        'September',
+        'October',
+        'November',
+        'December',
+    ];
+    const monthNamesShort = [
+        'Jan',
+        'Feb',
+        'Mar',
+        'Apr',
+        'May',
+        'Jun',
+        'Jul',
+        'Aug',
+        'Sep',
+        'Oct',
+        'Nov',
+        'Dec',
+    ];
+    const dayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+    const dayNamesShort = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+    // Common date format replacements
+    const replacements = {
+        YYYY: String(year),
+        YY: String(year).slice(-2),
+        MM: month,
+        M: String(d.getMonth() + 1),
+        DD: day,
+        D: String(d.getDate()),
+        MMMM: monthNames[d.getMonth()],
+        MMM: monthNamesShort[d.getMonth()],
+        dddd: dayNames[d.getDay()],
+        ddd: dayNamesShort[d.getDay()],
+        Do: day + getOrdinalSuffix(d.getDate()),
+    };
+    // Replace tokens in order of length (longest first) to avoid partial replacements
+    // Use a single pass approach where we process tokens by length to prevent overlaps
+    let formatted = format;
+    // Helper function to check if a token is standalone (not part of a longer token)
+    function isStandaloneToken(str, token) {
+        let pos = 0;
+        while (pos <= str.length - token.length) {
+            const idx = str.indexOf(token, pos);
+            if (idx === -1)
+                break;
+            // Check if this occurrence is standalone (not part of a longer token)
+            const beforeChar = idx > 0 ? str[idx - 1] : '';
+            const afterChar = idx + token.length < str.length ? str[idx + token.length] : '';
+            // For format tokens, check if it's surrounded by non-token characters
+            if (beforeChar !== token[0] && afterChar !== token[0]) {
+                return true;
+            }
+            pos = idx + 1;
+        }
+        return false;
+    }
+    // Define tokens in explicit order of replacement to avoid conflicts
+    const orderedTokens = [
+        'dddd',
+        'ddd', // Day names (must come before DD/D)
+        'MMMM',
+        'MMM', // Month names (must come before MM/M)
+        'YYYY',
+        'YY', // Years
+        'Do', // Ordinal days (must come before DD/D)
+        'DD',
+        'MM', // Two-digit day/month
+        'D',
+        'M', // Single-digit day/month (must come last)
+    ];
+    for (const token of orderedTokens) {
+        if (replacements[token] && isStandaloneToken(format, token)) {
+            // Replace all occurrences of this token at once
+            formatted = formatted.split(token).join(replacements[token]);
+        }
+    }
+    return formatted;
+}
+/**
+ * Gets the ordinal suffix for a number (1st, 2nd, 3rd, etc.)
+ *
+ * Internal helper function used by formatDate to add ordinal suffixes
+ * to day numbers in formatted dates.
+ *
+ * @private
+ * @param {number} n - The number to get the ordinal suffix for
+ * @returns {string} The ordinal suffix ('st', 'nd', 'rd', or 'th')
+ *
+ * @example
+ * ```typescript
+ * getOrdinalSuffix(1);  // 'st'
+ * getOrdinalSuffix(2);  // 'nd'
+ * getOrdinalSuffix(3);  // 'rd'
+ * getOrdinalSuffix(4);  // 'th'
+ * getOrdinalSuffix(21); // 'st'
+ * ```
+ */
+function getOrdinalSuffix(n) {
+    const s = ['th', 'st', 'nd', 'rd'];
+    const v = n % 100;
+    return s[(v - 20) % 10] || s[v] || s[0];
+}
+/**
+ * Predefined date format constants for common legal document formats
+ *
+ * This object provides commonly used date formats in legal documents,
+ * making it easy to maintain consistency across different document types.
+ *
+ * @constant {Object} DateFormats
+ * @example
+ * ```typescript
+ * import { formatDate, DateFormats } from './date-helpers';
+ *
+ * const date = new Date('2025-07-16');
+ *
+ * // Use predefined formats
+ * formatDate(date, DateFormats.LEGAL);   // "16th day of July, 2025"
+ * formatDate(date, DateFormats.FORMAL);  // "Wednesday, July 16th, 2025"
+ * formatDate(date, DateFormats.US);      // "07/16/2025"
+ * formatDate(date, DateFormats.EU);      // "16/07/2025"
+ * ```
+ */
+exports.DateFormats = {
+    ISO: 'YYYY-MM-DD',
+    US: 'MM/DD/YYYY',
+    EU: 'DD/MM/YYYY',
+    UK: 'DD/MM/YYYY',
+    FULL: 'MMMM Do, YYYY',
+    FULL_US: 'MMMM D, YYYY',
+    SHORT: 'MMM D, YYYY',
+    LEGAL: 'Do day of MMMM, YYYY',
+    FORMAL: 'dddd, MMMM Do, YYYY',
+};
+/**
+ * Parses date strings in various formats and returns a Date object
+ *
+ * Attempts to parse date strings in multiple common formats with intelligent
+ * format detection. Useful for processing user input or parsing dates from
+ * various document formats.
+ *
+ * @param {string} dateStr - The date string to parse
+ * @returns {Date | null} The parsed Date object, or null if parsing fails
+ *
+ * Supported formats:
+ * - ISO format: YYYY-MM-DD
+ * - US format: MM/DD/YYYY
+ * - European format: DD/MM/YYYY
+ * - Alternative separators: MM-DD-YYYY, DD-MM-YYYY
+ * - Natural language formats (via Date constructor)
+ *
+ * @example
+ * ```typescript
+ * // ISO format
+ * const date1 = parseDate('2025-07-16');
+ * // Result: Date object for July 16, 2025
+ *
+ * // US format (MM/DD/YYYY)
+ * const date2 = parseDate('07/16/2025');
+ * // Result: Date object for July 16, 2025
+ *
+ * // European format (DD/MM/YYYY)
+ * const date3 = parseDate('16/07/2025');
+ * // Result: Date object for July 16, 2025
+ *
+ * // Invalid date
+ * const invalid = parseDate('not a date');
+ * // Result: null
+ * ```
+ */
+function parseDate(dateStr) {
+    // Try various formats
+    const formats = [
+        /^\d{4}-\d{2}-\d{2}$/, // YYYY-MM-DD
+        /^\d{2}\/\d{2}\/\d{4}$/, // MM/DD/YYYY or DD/MM/YYYY
+        /^\d{2}-\d{2}-\d{4}$/, // MM-DD-YYYY or DD-MM-YYYY
+    ];
+    // Direct parsing attempt
+    const parsed = new Date(dateStr);
+    if (!isNaN(parsed.getTime())) {
+        return parsed;
+    }
+    // Try parsing with format detection
+    if (formats[0].test(dateStr)) {
+        return new Date(dateStr);
+    }
+    if (formats[1].test(dateStr) || formats[2].test(dateStr)) {
+        const separator = dateStr.includes('/') ? '/' : '-';
+        const parts = dateStr.split(separator).map(Number);
+        // Assume MM/DD/YYYY for US format if month <= 12
+        if (parts[0] <= 12) {
+            return new Date(parts[2], parts[0] - 1, parts[1]);
+        }
+        // Otherwise assume DD/MM/YYYY
+        return new Date(parts[2], parts[1] - 1, parts[0]);
+    }
+    return null;
+}
+//# sourceMappingURL=date-helpers.js.map

package/dist/helpers/date-helpers.js.map

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

package/dist/helpers/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Legal Markdown Helpers Module
+ *
+ * This module provides a comprehensive collection of utility functions for formatting
+ * and manipulating dates, numbers, and strings in legal documents. It serves as the
+ * central hub for all helper functions used throughout the Legal Markdown system.
+ *
+ * Features:
+ * - Date manipulation and formatting with legal-specific formats
+ * - Number formatting with currency, percentage, and word conversion
+ * - String manipulation with case conversion and text processing
+ * - Template helper registry for use in document processing
+ * - Convenient re-exports for easy access to all helper functions
+ *
+ * @example
+ * ```typescript
+ * import { formatDate, formatCurrency, capitalize } from './helpers';
+ *
+ * // Date formatting
+ * const date = formatDate(new Date(), 'MMMM Do, YYYY');
+ *
+ * // Currency formatting
+ * const price = formatCurrency(1234.56, 'USD');
+ *
+ * // String manipulation
+ * const title = capitalize('legal document');
+ * ```
+ */
+export * from './date-helpers';
+export * from './number-helpers';
+export * from './string-helpers';
+import { addYears, addMonths, addDays, formatDate, DateFormats } from './date-helpers';
+import { formatInteger, formatPercent, formatCurrency, formatEuro, formatDollar, formatPound, numberToWords } from './number-helpers';
+import { capitalize, capitalizeWords, upper, lower, titleCase, clean, pluralize } from './string-helpers';
+export { addYears, addMonths, addDays, formatDate, DateFormats, formatInteger, formatPercent, formatCurrency, formatEuro, formatDollar, formatPound, numberToWords, capitalize, capitalizeWords, upper, lower, titleCase, clean, pluralize, };
+import * as numberHelpers from './number-helpers';
+import * as stringHelpers from './string-helpers';
+/**
+ * Registry of helper functions for use in template processing
+ *
+ * This object provides a centralized collection of all helper functions
+ * organized by category for easy access during template processing and
+ * document generation.
+ *
+ * @constant {Object} helpers
+ * @example
+ * ```typescript
+ * import { helpers } from './helpers';
+ *
+ * // Use in template processing
+ * const result = helpers.formatDate(new Date(), 'YYYY-MM-DD');
+ * const currency = helpers.formatEuro(1234.56);
+ * const title = helpers.titleCase('legal document title');
+ * ```
+ */
+export declare const helpers: {
+    addYears: typeof addYears;
+    addMonths: typeof addMonths;
+    addDays: typeof addDays;
+    formatDate: typeof formatDate;
+    formatInteger: typeof formatInteger;
+    formatPercent: typeof formatPercent;
+    formatCurrency: typeof formatCurrency;
+    formatEuro: typeof formatEuro;
+    formatDollar: typeof formatDollar;
+    formatPound: typeof formatPound;
+    numberToWords: typeof numberToWords;
+    round: typeof numberHelpers.round;
+    capitalize: typeof capitalize;
+    capitalizeWords: typeof capitalizeWords;
+    upper: typeof upper;
+    lower: typeof lower;
+    titleCase: typeof titleCase;
+    kebabCase: typeof stringHelpers.kebabCase;
+    snakeCase: typeof stringHelpers.snakeCase;
+    camelCase: typeof stringHelpers.camelCase;
+    pascalCase: typeof stringHelpers.pascalCase;
+    truncate: typeof stringHelpers.truncate;
+    clean: typeof clean;
+    pluralize: typeof pluralize;
+    padStart: typeof stringHelpers.padStart;
+    padEnd: typeof stringHelpers.padEnd;
+    contains: typeof stringHelpers.contains;
+    replaceAll: typeof stringHelpers.replaceAll;
+    initials: typeof stringHelpers.initials;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEvF,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,eAAe,EACf,KAAK,EACL,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,WAAW,EAGX,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EAGb,UAAU,EACV,eAAe,EACf,KAAK,EACL,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,GACV,CAAC;AAGF,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCnB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @fileoverview Legal Markdown Helpers Module
+ *
+ * This module provides a comprehensive collection of utility functions for formatting
+ * and manipulating dates, numbers, and strings in legal documents. It serves as the
+ * central hub for all helper functions used throughout the Legal Markdown system.
+ *
+ * Features:
+ * - Date manipulation and formatting with legal-specific formats
+ * - Number formatting with currency, percentage, and word conversion
+ * - String manipulation with case conversion and text processing
+ * - Template helper registry for use in document processing
+ * - Convenient re-exports for easy access to all helper functions
+ *
+ * @example
+ * ```typescript
+ * import { formatDate, formatCurrency, capitalize } from './helpers';
+ *
+ * // Date formatting
+ * const date = formatDate(new Date(), 'MMMM Do, YYYY');
+ *
+ * // Currency formatting
+ * const price = formatCurrency(1234.56, 'USD');
+ *
+ * // String manipulation
+ * const title = capitalize('legal document');
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpers = exports.pluralize = exports.clean = exports.titleCase = exports.lower = exports.upper = exports.capitalizeWords = exports.capitalize = exports.numberToWords = exports.formatPound = exports.formatDollar = exports.formatEuro = exports.formatCurrency = exports.formatPercent = exports.formatInteger = exports.DateFormats = exports.formatDate = exports.addDays = exports.addMonths = exports.addYears = void 0;
+__exportStar(require("./date-helpers"), exports);
+__exportStar(require("./number-helpers"), exports);
+__exportStar(require("./string-helpers"), exports);
+// Individual imports for re-export
+const date_helpers_1 = require("./date-helpers");
+Object.defineProperty(exports, "addYears", { enumerable: true, get: function () { return date_helpers_1.addYears; } });
+Object.defineProperty(exports, "addMonths", { enumerable: true, get: function () { return date_helpers_1.addMonths; } });
+Object.defineProperty(exports, "addDays", { enumerable: true, get: function () { return date_helpers_1.addDays; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return date_helpers_1.formatDate; } });
+Object.defineProperty(exports, "DateFormats", { enumerable: true, get: function () { return date_helpers_1.DateFormats; } });
+const number_helpers_1 = require("./number-helpers");
+Object.defineProperty(exports, "formatInteger", { enumerable: true, get: function () { return number_helpers_1.formatInteger; } });
+Object.defineProperty(exports, "formatPercent", { enumerable: true, get: function () { return number_helpers_1.formatPercent; } });
+Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return number_helpers_1.formatCurrency; } });
+Object.defineProperty(exports, "formatEuro", { enumerable: true, get: function () { return number_helpers_1.formatEuro; } });
+Object.defineProperty(exports, "formatDollar", { enumerable: true, get: function () { return number_helpers_1.formatDollar; } });
+Object.defineProperty(exports, "formatPound", { enumerable: true, get: function () { return number_helpers_1.formatPound; } });
+Object.defineProperty(exports, "numberToWords", { enumerable: true, get: function () { return number_helpers_1.numberToWords; } });
+const string_helpers_1 = require("./string-helpers");
+Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return string_helpers_1.capitalize; } });
+Object.defineProperty(exports, "capitalizeWords", { enumerable: true, get: function () { return string_helpers_1.capitalizeWords; } });
+Object.defineProperty(exports, "upper", { enumerable: true, get: function () { return string_helpers_1.upper; } });
+Object.defineProperty(exports, "lower", { enumerable: true, get: function () { return string_helpers_1.lower; } });
+Object.defineProperty(exports, "titleCase", { enumerable: true, get: function () { return string_helpers_1.titleCase; } });
+Object.defineProperty(exports, "clean", { enumerable: true, get: function () { return string_helpers_1.clean; } });
+Object.defineProperty(exports, "pluralize", { enumerable: true, get: function () { return string_helpers_1.pluralize; } });
+const dateHelpers = __importStar(require("./date-helpers"));
+const numberHelpers = __importStar(require("./number-helpers"));
+const stringHelpers = __importStar(require("./string-helpers"));
+/**
+ * Registry of helper functions for use in template processing
+ *
+ * This object provides a centralized collection of all helper functions
+ * organized by category for easy access during template processing and
+ * document generation.
+ *
+ * @constant {Object} helpers
+ * @example
+ * ```typescript
+ * import { helpers } from './helpers';
+ *
+ * // Use in template processing
+ * const result = helpers.formatDate(new Date(), 'YYYY-MM-DD');
+ * const currency = helpers.formatEuro(1234.56);
+ * const title = helpers.titleCase('legal document title');
+ * ```
+ */
+exports.helpers = {
+    // Date helpers
+    addYears: dateHelpers.addYears,
+    addMonths: dateHelpers.addMonths,
+    addDays: dateHelpers.addDays,
+    formatDate: dateHelpers.formatDate,
+    // Number helpers
+    formatInteger: numberHelpers.formatInteger,
+    formatPercent: numberHelpers.formatPercent,
+    formatCurrency: numberHelpers.formatCurrency,
+    formatEuro: numberHelpers.formatEuro,
+    formatDollar: numberHelpers.formatDollar,
+    formatPound: numberHelpers.formatPound,
+    numberToWords: numberHelpers.numberToWords,
+    round: numberHelpers.round,
+    // String helpers
+    capitalize: stringHelpers.capitalize,
+    capitalizeWords: stringHelpers.capitalizeWords,
+    upper: stringHelpers.upper,
+    lower: stringHelpers.lower,
+    titleCase: stringHelpers.titleCase,
+    kebabCase: stringHelpers.kebabCase,
+    snakeCase: stringHelpers.snakeCase,
+    camelCase: stringHelpers.camelCase,
+    pascalCase: stringHelpers.pascalCase,
+    truncate: stringHelpers.truncate,
+    clean: stringHelpers.clean,
+    pluralize: stringHelpers.pluralize,
+    padStart: stringHelpers.padStart,
+    padEnd: stringHelpers.padEnd,
+    contains: stringHelpers.contains,
+    replaceAll: stringHelpers.replaceAll,
+    initials: stringHelpers.initials,
+};
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,mDAAiC;AACjC,mDAAiC;AAEjC,mCAAmC;AACnC,iDAAuF;AAyBrF,yFAzBO,uBAAQ,OAyBP;AACR,0FA1BiB,wBAAS,OA0BjB;AACT,wFA3B4B,sBAAO,OA2B5B;AACP,2FA5BqC,yBAAU,OA4BrC;AACV,4FA7BiD,0BAAW,OA6BjD;AA3Bb,qDAQ0B;AAsBxB,8FA7BA,8BAAa,OA6BA;AACb,8FA7BA,8BAAa,OA6BA;AACb,+FA7BA,+BAAc,OA6BA;AACd,2FA7BA,2BAAU,OA6BA;AACV,6FA7BA,6BAAY,OA6BA;AACZ,4FA7BA,4BAAW,OA6BA;AACX,8FA7BA,8BAAa,OA6BA;AA1Bf,qDAQ0B;AAqBxB,2FA5BA,2BAAU,OA4BA;AACV,gGA5BA,gCAAe,OA4BA;AACf,sFA5BA,sBAAK,OA4BA;AACL,sFA5BA,sBAAK,OA4BA;AACL,0FA5BA,0BAAS,OA4BA;AACT,sFA5BA,sBAAK,OA4BA;AACL,0FA5BA,0BAAS,OA4BA;AAGX,4DAA8C;AAC9C,gEAAkD;AAClD,gEAAkD;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,OAAO,GAAG;IACrB,eAAe;IACf,QAAQ,EAAE,WAAW,CAAC,QAAQ;IAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;IAChC,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;IAElC,iBAAiB;IACjB,aAAa,EAAE,aAAa,CAAC,aAAa;IAC1C,aAAa,EAAE,aAAa,CAAC,aAAa;IAC1C,cAAc,EAAE,aAAa,CAAC,cAAc;IAC5C,UAAU,EAAE,aAAa,CAAC,UAAU;IACpC,YAAY,EAAE,aAAa,CAAC,YAAY;IACxC,WAAW,EAAE,aAAa,CAAC,WAAW;IACtC,aAAa,EAAE,aAAa,CAAC,aAAa;IAC1C,KAAK,EAAE,aAAa,CAAC,KAAK;IAE1B,iBAAiB;IACjB,UAAU,EAAE,aAAa,CAAC,UAAU;IACpC,eAAe,EAAE,aAAa,CAAC,eAAe;IAC9C,KAAK,EAAE,aAAa,CAAC,KAAK;IAC1B,KAAK,EAAE,aAAa,CAAC,KAAK;IAC1B,SAAS,EAAE,aAAa,CAAC,SAAS;IAClC,SAAS,EAAE,aAAa,CAAC,SAAS;IAClC,SAAS,EAAE,aAAa,CAAC,SAAS;IAClC,SAAS,EAAE,aAAa,CAAC,SAAS;IAClC,UAAU,EAAE,aAAa,CAAC,UAAU;IACpC,QAAQ,EAAE,aAAa,CAAC,QAAQ;IAChC,KAAK,EAAE,aAAa,CAAC,KAAK;IAC1B,SAAS,EAAE,aAAa,CAAC,SAAS;IAClC,QAAQ,EAAE,aAAa,CAAC,QAAQ;IAChC,MAAM,EAAE,aAAa,CAAC,MAAM;IAC5B,QAAQ,EAAE,aAAa,CAAC,QAAQ;IAChC,UAAU,EAAE,aAAa,CAAC,UAAU;IACpC,QAAQ,EAAE,aAAa,CAAC,QAAQ;CACjC,CAAC"}