legal-markdown-js 0.1.0

package/dist/extensions/template-loops.js

@@ -0,0 +1,418 @@
+"use strict";
+/**
+ * @fileoverview Template Loop Processing Extension for Legal Markdown
+ *
+ * This extension adds support for template loops and conditional blocks using
+ * the {{#variable}}...{{/variable}} syntax. It enables iteration over arrays
+ * and conditional rendering of template sections.
+ *
+ * Features:
+ * - Array iteration: {{#items}}...{{/items}}
+ * - Conditional blocks: {{#loyaltyMember}}...{{/loyaltyMember}}
+ * - Nested loops support
+ * - Context management for loop variables
+ * - Integration with field tracking
+ *
+ * @example
+ * ```typescript
+ * import { processTemplateLoops } from './template-loops';
+ *
+ * const content = `
+ * {{#items}}
+ * - {{name}} {{onSale ? "(ON SALE!)" : ""}} - ${{price}}
+ * {{/items}}
+ * `;
+ *
+ * const metadata = {
+ *   items: [
+ *     { name: "Product A", price: 10.99, onSale: true },
+ *     { name: "Product B", price: 15.50, onSale: false }
+ *   ]
+ * };
+ *
+ * const result = processTemplateLoops(content, metadata);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processTemplateLoops = processTemplateLoops;
+const field_tracker_1 = require("../tracking/field-tracker");
+/**
+ * Escapes HTML attribute values to prevent breaking HTML structure
+ * @param value - The value to escape
+ * @returns Escaped value safe for HTML attributes
+ */
+function escapeHtmlAttribute(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/"/g, '"')
+        .replace(/'/g, ''')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+/**
+ * Processes template loops and conditional blocks in content
+ *
+ * @param content - The template content containing loop patterns
+ * @param metadata - The metadata object containing loop data
+ * @param context - Current loop context for nested loops
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Processed content with loops expanded
+ */
+function processTemplateLoops(content, metadata, context, enableFieldTracking = true) {
+    // Find all loop blocks in the content
+    const loopBlocks = findLoopBlocks(content);
+    if (loopBlocks.length === 0) {
+        return content;
+    }
+    // Process loop blocks from last to first to avoid position shifting
+    let processedContent = content;
+    for (let i = loopBlocks.length - 1; i >= 0; i--) {
+        const loopBlock = loopBlocks[i];
+        const expandedContent = expandLoopBlock(loopBlock, metadata, context, enableFieldTracking);
+        // Replace the loop block with expanded content
+        processedContent =
+            processedContent.slice(0, loopBlock.start) +
+                expandedContent +
+                processedContent.slice(loopBlock.end);
+    }
+    return processedContent;
+}
+/**
+ * Finds all loop blocks in the content using regex pattern matching
+ *
+ * @param content - The content to search for loop blocks
+ * @returns Array of parsed loop blocks
+ */
+function findLoopBlocks(content) {
+    const loopBlocks = [];
+    const loopPattern = /\{\{#(\w+)\}\}([\s\S]*?)\{\{\/\1\}\}/g;
+    let match;
+    while ((match = loopPattern.exec(content)) !== null) {
+        const [fullMatch, variable, loopContent] = match;
+        loopBlocks.push({
+            variable,
+            content: loopContent,
+            start: match.index,
+            end: match.index + fullMatch.length,
+            fullMatch,
+        });
+    }
+    return loopBlocks;
+}
+/**
+ * Expands a single loop block into its final content
+ *
+ * @param loopBlock - The loop block to expand
+ * @param metadata - The metadata object containing loop data
+ * @param parentContext - Parent loop context for nested loops
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Expanded content string
+ */
+function expandLoopBlock(loopBlock, metadata, parentContext, enableFieldTracking = true) {
+    const { variable, content } = loopBlock;
+    // Resolve the loop variable value from metadata or parent context
+    const loopValue = resolveLoopVariable(variable, metadata, parentContext);
+    // Track field usage
+    field_tracker_1.fieldTracker.trackField(variable, {
+        value: loopValue,
+        hasLogic: true,
+        mixinUsed: 'loop',
+    });
+    // Handle different types of loop values
+    if (Array.isArray(loopValue)) {
+        return expandArrayLoop(variable, content, loopValue, metadata, parentContext, enableFieldTracking);
+    }
+    else if (loopValue) {
+        // Conditional block - render if truthy
+        return expandConditionalBlock(variable, content, loopValue, metadata, parentContext, enableFieldTracking);
+    }
+    else {
+        // Falsy value - don't render
+        return '';
+    }
+}
+/**
+ * Expands an array loop, iterating over each item
+ *
+ * @param variable - The loop variable name
+ * @param content - The loop content template
+ * @param items - The array to iterate over
+ * @param metadata - The metadata object
+ * @param parentContext - Parent loop context
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Expanded content for all array items
+ */
+function expandArrayLoop(variable, content, items, metadata, parentContext, enableFieldTracking = true) {
+    const expandedParts = [];
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        // Create loop context for this iteration
+        const loopContext = {
+            variable,
+            item,
+            index: i,
+            total: items.length,
+            parent: parentContext,
+        };
+        // Create enhanced metadata with current item properties
+        const enhancedMetadata = createEnhancedMetadata(metadata, item, loopContext);
+        // Process the content with the enhanced metadata
+        let processedContent = content;
+        // First, process any nested loops
+        processedContent = processTemplateLoops(processedContent, enhancedMetadata, loopContext, enableFieldTracking);
+        // Then process regular mixins in the content
+        processedContent = processItemMixins(processedContent, enhancedMetadata, loopContext, enableFieldTracking);
+        // Convert markdown list items to HTML li elements if content starts with -
+        processedContent = convertMarkdownListToHtml(processedContent);
+        expandedParts.push(processedContent);
+    }
+    return expandedParts.join('\n');
+}
+/**
+ * Expands a conditional block if the condition is truthy
+ *
+ * @param variable - The condition variable name
+ * @param content - The conditional content template
+ * @param value - The condition value
+ * @param metadata - The metadata object
+ * @param parentContext - Parent loop context
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Expanded content if condition is truthy, empty string otherwise
+ */
+function expandConditionalBlock(variable, content, value, metadata, parentContext, enableFieldTracking = true) {
+    // Create enhanced metadata with the condition value
+    const enhancedMetadata = {
+        ...metadata,
+        [variable]: value,
+    };
+    // Process any nested loops first
+    let processedContent = processTemplateLoops(content, enhancedMetadata, parentContext, enableFieldTracking);
+    // Then process regular mixins
+    processedContent = processItemMixins(processedContent, enhancedMetadata, parentContext, enableFieldTracking);
+    return processedContent;
+}
+/**
+ * Resolves a loop variable from metadata or parent context
+ *
+ * @param variable - The variable name to resolve
+ * @param metadata - The metadata object
+ * @param parentContext - Parent loop context
+ * @returns The resolved variable value
+ */
+function resolveLoopVariable(variable, metadata, parentContext) {
+    // First check if it's available in current metadata
+    if (Object.prototype.hasOwnProperty.call(metadata, variable)) {
+        return metadata[variable];
+    }
+    // Then check parent context (for nested loops)
+    if (parentContext &&
+        parentContext.item &&
+        Object.prototype.hasOwnProperty.call(parentContext.item, variable)) {
+        return parentContext.item[variable];
+    }
+    // Check parent context's parent (for deeper nesting)
+    let ctx = parentContext;
+    while (ctx && ctx.parent) {
+        ctx = ctx.parent;
+        if (ctx.item && Object.prototype.hasOwnProperty.call(ctx.item, variable)) {
+            return ctx.item[variable];
+        }
+    }
+    return undefined;
+}
+/**
+ * Creates enhanced metadata by merging current item properties
+ *
+ * @param metadata - Original metadata
+ * @param item - Current loop item
+ * @param context - Loop context
+ * @returns Enhanced metadata object
+ */
+function createEnhancedMetadata(metadata, item, context) {
+    const enhanced = { ...metadata };
+    // Add current item properties if it's an object
+    if (item && typeof item === 'object' && !Array.isArray(item)) {
+        Object.assign(enhanced, item);
+    }
+    // Add loop context variables
+    enhanced['@index'] = context.index;
+    enhanced['@total'] = context.total;
+    enhanced['@first'] = context.index === 0;
+    enhanced['@last'] = context.index === context.total - 1;
+    return enhanced;
+}
+/**
+ * Processes mixins within loop content with enhanced metadata
+ *
+ * @param content - The content to process
+ * @param metadata - Enhanced metadata with loop context
+ * @param context - Loop context
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Processed content with mixins resolved
+ */
+function processItemMixins(content, metadata, context, enableFieldTracking = true) {
+    // Use a simple regex to find and replace mixins
+    const mixinPattern = /\{\{([^}]+)\}\}/g;
+    return content.replace(mixinPattern, (match, variable) => {
+        const trimmedVar = variable.trim();
+        // Handle conditional expressions (ternary operator)
+        if (trimmedVar.includes('?') && trimmedVar.includes(':')) {
+            const result = processConditionalExpression(trimmedVar, metadata, enableFieldTracking);
+            if (enableFieldTracking) {
+                return `<span class="highlight">${result}</span>`;
+            }
+            return result;
+        }
+        // Handle simple variable substitution
+        const value = resolveVariablePath(trimmedVar, metadata, context);
+        if (value === undefined || value === null) {
+            if (enableFieldTracking) {
+                return (`<span class="missing-value" data-field="${escapeHtmlAttribute(trimmedVar)}">` +
+                    `[[${trimmedVar}]]</span>`);
+            }
+            return `{{${trimmedVar}}}`;
+        }
+        if (enableFieldTracking) {
+            return (`<span class="imported-value" data-field="${escapeHtmlAttribute(trimmedVar)}">` +
+                `${String(value)}</span>`);
+        }
+        return String(value);
+    });
+}
+/**
+ * Processes conditional expressions (ternary operator)
+ *
+ * @param expression - The conditional expression
+ * @param metadata - The metadata object
+ * @param enableFieldTracking - Whether to enable field tracking HTML spans
+ * @returns Resolved conditional value
+ */
+function processConditionalExpression(expression, metadata, enableFieldTracking = true) {
+    // Find the question mark and colon, but be careful about quoted strings
+    const questionIndex = findOperatorIndex(expression, '?');
+    const colonIndex = findOperatorIndex(expression, ':', questionIndex);
+    if (questionIndex === -1 || colonIndex === -1) {
+        return expression; // Invalid ternary, return as-is
+    }
+    const condition = expression.substring(0, questionIndex).trim();
+    const truePart = expression.substring(questionIndex + 1, colonIndex).trim();
+    const falsePart = expression.substring(colonIndex + 1).trim();
+    // Resolve condition value
+    const conditionValue = resolveVariablePath(condition, metadata);
+    // Choose appropriate part based on condition
+    const selectedPart = conditionValue ? truePart : falsePart;
+    // Remove quotes if present
+    if ((selectedPart.startsWith('"') && selectedPart.endsWith('"')) ||
+        (selectedPart.startsWith("'") && selectedPart.endsWith("'"))) {
+        const unquotedValue = selectedPart.slice(1, -1);
+        if (enableFieldTracking) {
+            return (`<span class="imported-value" data-field="${escapeHtmlAttribute(expression)}">` +
+                `${unquotedValue}</span>`);
+        }
+        return unquotedValue;
+    }
+    // Process as expression (might contain variables or concatenation)
+    const processedValue = processExpression(selectedPart, metadata);
+    if (enableFieldTracking) {
+        return (`<span class="imported-value" data-field="${escapeHtmlAttribute(expression)}">` +
+            `${processedValue}</span>`);
+    }
+    return processedValue;
+}
+/**
+ * Finds the index of an operator outside of quoted strings
+ *
+ * @param expression - The expression to search
+ * @param operator - The operator to find
+ * @param startIndex - Starting index for the search
+ * @returns The index of the operator or -1 if not found
+ */
+function findOperatorIndex(expression, operator, startIndex = 0) {
+    let inQuotes = false;
+    let quoteChar = '';
+    for (let i = startIndex; i < expression.length; i++) {
+        const char = expression[i];
+        if (!inQuotes && (char === '"' || char === "'")) {
+            inQuotes = true;
+            quoteChar = char;
+        }
+        else if (inQuotes && char === quoteChar) {
+            inQuotes = false;
+            quoteChar = '';
+        }
+        else if (!inQuotes && char === operator) {
+            return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Processes expressions that might contain variables or concatenation
+ *
+ * @param expression - The expression to process
+ * @param metadata - The metadata object
+ * @returns Processed expression result
+ */
+function processExpression(expression, metadata) {
+    // Handle concatenation with +
+    if (expression.includes('+')) {
+        return expression
+            .split('+')
+            .map(part => {
+            const trimmed = part.trim();
+            // Handle quoted strings
+            if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+                (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+                return trimmed.slice(1, -1);
+            }
+            // Handle variables
+            const value = resolveVariablePath(trimmed, metadata);
+            return value !== undefined ? String(value) : trimmed;
+        })
+            .join('');
+    }
+    // Handle single variable
+    const value = resolveVariablePath(expression, metadata);
+    return value !== undefined ? String(value) : expression;
+}
+/**
+ * Resolves a variable path with dot notation support
+ *
+ * @param path - The variable path (e.g., 'item.name')
+ * @param metadata - The metadata object
+ * @param context - Loop context
+ * @returns Resolved variable value
+ */
+function resolveVariablePath(path, metadata, context) {
+    // Split path by dots
+    const parts = path.split('.');
+    let current = metadata;
+    for (const part of parts) {
+        if (current &&
+            typeof current === 'object' &&
+            Object.prototype.hasOwnProperty.call(current, part)) {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Converts markdown list items to HTML li elements
+ *
+ * @param content - The content to convert
+ * @returns Content with markdown list items converted to HTML li elements
+ */
+function convertMarkdownListToHtml(content) {
+    // Check if content starts with markdown list item syntax
+    const trimmedContent = content.trim();
+    if (trimmedContent.startsWith('- ')) {
+        // Convert "- content" to "<li>content</li>"
+        const listItemContent = trimmedContent.substring(2).trim();
+        return `<li>${listItemContent}</li>`;
+    }
+    return content;
+}
+//# sourceMappingURL=template-loops.js.map

package/dist/extensions/template-loops.js.map

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

package/dist/extensions/utilities/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Utility Functions for Legal Document Analysis
+ *
+ * This module provides utility functions for analyzing and extracting information
+ * from Legal Markdown documents. These are extensions beyond the core functionality
+ * that provide insights into document structure, content, and usage patterns.
+ *
+ * Features:
+ * - Document statistics and analysis
+ * - Reference extraction and analysis
+ * - Condition extraction from optional clauses
+ * - Word count and character count metrics
+ * - Header and structure analysis
+ * - Import usage tracking
+ * - Extensions not present in the original legal-markdown
+ *
+ * @example
+ * ```typescript
+ * import { analyzeDocument, extractReferences, extractConditions } from './utilities';
+ *
+ * // Analyze document statistics
+ * const stats = analyzeDocument(content);
+ * console.log(`Document contains ${stats.wordCount} words and ${stats.headerCount} headers`);
+ *
+ * // Extract references
+ * const references = extractReferences(content);
+ * console.log('References used:', references);
+ *
+ * // Extract conditions
+ * const conditions = extractConditions(content);
+ * console.log('Conditions used:', conditions);
+ * ```
+ */
+/**
+ * Analyzes document statistics and structure
+ *
+ * Provides comprehensive analysis of Legal Markdown document content including
+ * word counts, structural elements, and usage patterns. This is an extension
+ * not present in the original legal-markdown specification.
+ *
+ * @function analyzeDocument
+ * @param {string} content - The legal document content to analyze
+ * @returns {Object} Object containing document statistics
+ * @returns {number} returns.wordCount - Total number of words in the document
+ * @returns {number} returns.characterCount - Total number of characters in the document
+ * @returns {number} returns.headerCount - Number of header structures (l., ll., etc.)
+ * @returns {number} returns.optionalClauseCount - Number of optional clauses found
+ * @returns {number} returns.crossReferenceCount - Number of cross-references found
+ * @returns {number} returns.importCount - Number of import statements found
+ * @example
+ * ```typescript
+ * import { analyzeDocument } from './utilities';
+ *
+ * const stats = analyzeDocument(documentContent);
+ * console.log(`Document Analysis:`);
+ * console.log(`- Words: ${stats.wordCount}`);
+ * console.log(`- Characters: ${stats.characterCount}`);
+ * console.log(`- Headers: ${stats.headerCount}`);
+ * console.log(`- Optional Clauses: ${stats.optionalClauseCount}`);
+ * console.log(`- Cross References: ${stats.crossReferenceCount}`);
+ * console.log(`- Imports: ${stats.importCount}`);
+ * ```
+ */
+export declare function analyzeDocument(content: string): {
+    wordCount: number;
+    characterCount: number;
+    headerCount: number;
+    optionalClauseCount: number;
+    crossReferenceCount: number;
+    importCount: number;
+};
+/**
+ * Extracts all references used in a document
+ *
+ * Scans the document content for cross-reference patterns and returns a unique
+ * list of all references found. Useful for understanding document dependencies
+ * and reference usage patterns.
+ *
+ * @function extractReferences
+ * @param {string} content - The legal document content to analyze
+ * @returns {string[]} Array of unique reference names found in the document
+ * @example
+ * ```typescript
+ * import { extractReferences } from './utilities';
+ *
+ * const references = extractReferences(documentContent);
+ * console.log('References used in document:', references);
+ *
+ * // Example output: ['section-1', 'definitions', 'termination-clause']
+ * ```
+ */
+export declare function extractReferences(content: string): string[];
+/**
+ * Extracts all conditions used in optional clauses
+ *
+ * Scans the document content for conditional clause patterns and returns a unique
+ * list of all conditions found. Useful for understanding document logic and
+ * conditional content usage.
+ *
+ * @function extractConditions
+ * @param {string} content - The legal document content to analyze
+ * @returns {string[]} Array of unique condition names found in the document
+ * @example
+ * ```typescript
+ * import { extractConditions } from './utilities';
+ *
+ * const conditions = extractConditions(documentContent);
+ * console.log('Conditions used in document:', conditions);
+ *
+ * // Example output: ['include-warranty', 'corporate-client', 'international-law']
+ * ```
+ */
+export declare function extractConditions(content: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/utilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB,CAeA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D"}