@unrdf/kgn 5.0.1

package/src/base/macro-templates.js

@@ -0,0 +1,298 @@
+/**
+ * KGEN Macro Templates - Reusable template components (Fixed)
+ *
+ * Provides a library of pre-built macros for common template patterns
+ * All macros are deterministic and compatible with KGEN template engine
+ */
+
+export class KGenMacroTemplates {
+  constructor(options = {}) {
+    this.options = {
+      deterministicMode: options.deterministicMode !== false,
+      staticBuildTime: options.staticBuildTime || '2024-01-01T00:00:00.000Z',
+      namespace: options.namespace || 'kgen',
+      ...options
+    };
+
+    this.macros = new Map();
+    this.initializeMacros();
+  }
+
+  /**
+   * Initialize built-in macro templates
+   */
+  initializeMacros() {
+    // Document structure macros
+    this.registerMacro('document_header', `{%- macro document_header(title, author, version='1.0.0') -%}
+/**
+ * {{ title }}
+ *
+ * @author {{ author | default('KGEN Generator') }}
+ * @version {{ version }}
+ * @generated {{ __kgen.renderTime }}
+ * @hash {{ (title + author + version) | hash | shortHash(8) }}
+ */
+{%- endmacro -%}`);
+
+    this.registerMacro('code_block', `{%- macro code_block(content, language='javascript') -%}
+\\u0060\\u0060\\u0060{{ language }}
+{{ content }}
+\\u0060\\u0060\\u0060
+{%- endmacro -%}`);
+
+    // HTML/Web macros
+    this.registerMacro('html_form', `{%- macro html_form(fields, action='#', method='POST', cssClass='kgen-form') -%}
+<form action="{{ action }}" method="{{ method }}" class="{{ cssClass }}">
+{%- for field in fields %}
+  <div class="form-group">
+    {%- if field.label %}
+    <label for="{{ field.name }}">{{ field.label }}</label>
+    {%- endif %}
+    <input
+      type="{{ field.type | default('text') }}"
+      name="{{ field.name }}"
+      id="{{ field.name }}"
+      {%- if field.required %} required{% endif %}
+      {%- if field.placeholder %} placeholder="{{ field.placeholder }}"{% endif %}
+      {%- if field.value %} value="{{ field.value }}"{% endif %}
+      class="form-control"
+    >
+  </div>
+{%- endfor %}
+  <button type="submit" class="btn btn-primary">Submit</button>
+</form>
+{%- endmacro -%}`);
+
+    // Code generation macros
+    this.registerMacro('js_class', `{%- macro js_class(className, methods=[], imports=[], exports=true) -%}
+{%- if imports | length > 0 %}
+{%- for import in imports %}
+import {{ import.name }}{{ import.from ? ' from \\'' + import.from + '\\'' : '' }};
+{%- endfor %}
+
+{%- endif %}
+{%- if exports %}export {% endif %}class {{ className }} {
+  constructor(options = {}) {
+    this.options = { ...options };
+  }
+{%- for method in methods %}
+
+  {{ method.name }}({{ method.params | default('') }}) {
+    {{ method.body | default('// Method implementation') }}
+  }
+{%- endfor %}
+}
+{%- if exports %}
+
+export default {{ className }};
+{%- endif %}
+{%- endmacro -%}`);
+
+    this.registerMacro('js_function', `{%- macro js_function(name, params=[], body='', isAsync=false, isExport=false) -%}
+{%- if isExport %}export {% endif %}{%- if isAsync %}async {% endif %}function {{ name }}({{ params | join(', ') }}) {
+  {{ body }}
+}
+{%- endmacro -%}`);
+
+    // Configuration macros
+    this.registerMacro('config_json', `{%- macro config_json(config, indent=2) -%}
+{
+{%- for key, value in config.items() %}
+{{ ' '.repeat(indent) }}"{{ key }}": {{ value | json }}{%- if not loop.last %},{% endif %}
+{%- endfor %}
+}
+{%- endmacro -%}`);
+
+    this.registerMacro('env_file', `{%- macro env_file(vars) -%}
+# Environment Configuration
+# Generated {{ __kgen.renderTime }}
+
+{%- for key, value in vars.items() %}
+{{ key }}={{ value }}
+{%- endfor %}
+{%- endmacro -%}`);
+
+    // Testing macros
+    this.registerMacro('test_suite', `{%- macro test_suite(name, tests=[], setup='', teardown='') -%}
+describe('{{ name }}', () => {
+{%- if setup %}
+  beforeEach(() => {
+    {{ setup }}
+  });
+{%- endif %}
+
+{%- for test in tests %}
+  it('{{ test.description }}', {{ 'async ' if test.async }}() => {
+    {{ test.body }}
+  });
+{%- endfor %}
+
+{%- if teardown %}
+  afterEach(() => {
+    {{ teardown }}
+  });
+{%- endif %}
+});
+{%- endmacro -%}`);
+
+    // Utility macros
+    this.registerMacro('copyright_notice', `{%- macro copyright_notice(year, holder, license='MIT') -%}
+/**
+ * Copyright (c) {{ year }} {{ holder }}
+ *
+ * Licensed under the {{ license }} License
+ * Generated by KGEN {{ __kgen.renderTime }}
+ */
+{%- endmacro -%}`);
+
+    this.registerMacro('version_info', `{%- macro version_info(version, date, changes=[]) -%}
+/**
+ * Version: {{ version }}
+ * Date: {{ date }}
+ * {%- if changes | length > 0 %}
+ * Changes:
+ {%- for change in changes %}
+ *   - {{ change }}
+ {%- endfor %}
+ * {%- endif %}
+ */
+{%- endmacro -%}`);
+  }
+
+  /**
+   * Register a macro template
+   */
+  registerMacro(name, template, metadata = {}) {
+    this.macros.set(name, {
+      template,
+      metadata: {
+        name,
+        registered: this.options.staticBuildTime,
+        namespace: this.options.namespace,
+        deterministic: true,
+        ...metadata
+      }
+    });
+  }
+
+  /**
+   * Get macro template by name
+   */
+  getMacro(name) {
+    return this.macros.get(name);
+  }
+
+  /**
+   * Get all macro names
+   */
+  getMacroNames() {
+    return Array.from(this.macros.keys()).sort();
+  }
+
+  /**
+   * Generate macro library as template content
+   */
+  generateMacroLibrary(macroNames = []) {
+    const macrosToInclude = macroNames.length > 0
+      ? macroNames.filter(name => this.macros.has(name))
+      : Array.from(this.macros.keys());
+
+    const content = [];
+
+    content.push('{% comment %}');
+    content.push('KGEN Macro Library');
+    content.push(`Generated: ${this.options.staticBuildTime}`);
+    content.push(`Macros: ${macrosToInclude.length}`);
+    content.push('{% endcomment %}');
+    content.push('');
+
+    for (const name of macrosToInclude.sort()) {
+      const macro = this.macros.get(name);
+      if (macro) {
+        content.push(`{% comment %} Macro: ${name} {% endcomment %}`);
+        content.push(macro.template);
+        content.push('');
+      }
+    }
+
+    return content.join('\\n');
+  }
+
+  /**
+   * Export macros for external use
+   */
+  exportMacros(format = 'kgen') {
+    const exported = {
+      format,
+      generated: this.options.staticBuildTime,
+      namespace: this.options.namespace,
+      macros: {}
+    };
+
+    for (const [name, macro] of this.macros) {
+      exported.macros[name] = {
+        template: macro.template,
+        metadata: macro.metadata
+      };
+    }
+
+    return exported;
+  }
+
+  /**
+   * Validate macro template syntax
+   */
+  validateMacro(name) {
+    const macro = this.macros.get(name);
+    if (!macro) {
+      throw new Error(`Macro '${name}' not found`);
+    }
+
+    // Basic syntax validation
+    const template = macro.template;
+    const errors = [];
+
+    // Check for balanced tags
+    const macroStart = template.match(/{%-?\\s*macro\\s+/g) || [];
+    const macroEnd = template.match(/{%-?\\s*endmacro\\s*-?%}/g) || [];
+
+    if (macroStart.length !== macroEnd.length) {
+      errors.push('Unbalanced macro tags');
+    }
+
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+
+  /**
+   * Get macro statistics
+   */
+  getStats() {
+    const stats = {
+      total: this.macros.size,
+      categories: {},
+      imported: 0,
+      invalid: 0
+    };
+
+    for (const [name, macro] of this.macros) {
+      const category = macro.metadata.category || 'general';
+      stats.categories[category] = (stats.categories[category] || 0) + 1;
+
+      if (macro.metadata.imported) {
+        stats.imported++;
+      }
+
+      const validation = this.validateMacro(name);
+      if (!validation.valid) {
+        stats.invalid++;
+      }
+    }
+
+    return stats;
+  }
+}
+
+export default KGenMacroTemplates;