@cyberismo/data-handler 0.0.7 → 0.0.9

package/dist/macros/include/index.js

@@ -0,0 +1,97 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+import { evaluateMacros, validateMacroContent } from '../index.js';
+import macroMetadata from './metadata.js';
+import BaseMacro from '../base-macro.js';
+import { MAX_LEVEL_OFFSET } from '../../utils/constants.js';
+export default class IncludeMacro extends BaseMacro {
+    constructor(tasksQueue) {
+        super(macroMetadata, tasksQueue);
+    }
+    handleValidate = (input) => {
+        this.validate(input);
+    };
+    handleStatic = async (context, input) => {
+        const options = this.validate(input);
+        if (!options.title) {
+            options.title = 'include';
+        }
+        if (!options.pageTitles) {
+            options.pageTitles = 'normal';
+        }
+        const card = await context.project.cardDetailsById(options.cardKey, {
+            content: true,
+            metadata: true,
+        });
+        if (!card) {
+            throw new Error(`Card key ${options.cardKey} not found`);
+        }
+        const newContext = {
+            ...context,
+            cardKey: options.cardKey,
+        };
+        const anchor = this.generateAnchor(options);
+        const title = this.generateTitle(options, card.metadata?.title);
+        const cardContent = await this.generateCardContent(options, card.content, newContext);
+        const content = `\n\n${anchor}${title}${cardContent}`;
+        let levelOffset = 0;
+        if (options.levelOffset) {
+            levelOffset = parseInt(options.levelOffset, 10);
+            if (isNaN(levelOffset)) {
+                throw new Error(`Invalid level offset: ${options.levelOffset}`);
+            }
+            levelOffset = Math.min(Math.max(levelOffset, -MAX_LEVEL_OFFSET), MAX_LEVEL_OFFSET);
+        }
+        const adjustedContent = this.adjustTitles(content, levelOffset, options.pageTitles === 'discrete');
+        return adjustedContent;
+    };
+    handleInject = async (context, input) => {
+        return this.handleStatic(context, input);
+    };
+    validate(input) {
+        return validateMacroContent(this.metadata, input);
+    }
+    generateAnchor(options) {
+        return options.title !== 'exclude' && options.pageTitles === 'normal'
+            ? `[[${options.cardKey}]]\n`
+            : '';
+    }
+    generateTitle(options, cardTitle) {
+        if (options.title === 'only' || options.title === 'include') {
+            return `= ${cardTitle}\n\n`;
+        }
+        return '';
+    }
+    async generateCardContent(options, cardContent, context) {
+        if (options.title !== 'only') {
+            return await evaluateMacros(cardContent ?? '', context, true);
+        }
+        return '';
+    }
+    // Adjust asciidoc titles to match the level offset
+    adjustTitles(content, levelOffset, discrete) {
+        const lines = content.split('\n');
+        const adjustedLines = lines.map((line) => {
+            const match = line.match(/^(\s*)([=#]+)(.*?)\s*$/);
+            if (match) {
+                const currentLevel = match[2].length;
+                const newLevel = Math.min(Math.max(1, currentLevel + levelOffset), MAX_LEVEL_OFFSET + 1);
+                const equals = '='.repeat(newLevel);
+                return `${discrete ? '[discrete]\n' : ''}${match[1]}${equals} ${match[3].trim()}`;
+            }
+            return line;
+        });
+        return adjustedLines.join('\n');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/macros/include/index.js.map

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

package/dist/macros/include/metadata.d.ts

@@ -0,0 +1,15 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+import type { MacroMetadata } from '../../interfaces/macros.js';
+declare const macroMetadata: MacroMetadata;
+export default macroMetadata;

package/dist/macros/include/metadata.js

@@ -0,0 +1,19 @@
+/**
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2025
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+const macroMetadata = {
+    name: 'include',
+    tagName: 'include',
+    schema: 'includeMacroSchema',
+};
+export default macroMetadata;
+//# sourceMappingURL=metadata.js.map

package/dist/macros/include/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/macros/include/metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAIF,MAAM,aAAa,GAAkB;IACnC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,oBAAoB;CAC7B,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/macros/index.d.ts

@@ -1,21 +1,21 @@
 /**
-    Cyberismo
-    Copyright © Cyberismo Ltd and contributors 2024
-
-    This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.
-
-    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
-
-    You should have received a copy of the GNU Affero General Public
-    License along with this program.  If not, see <https://www.gnu.org/licenses/>.
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2024
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 import Handlebars from 'handlebars';
 import type { AdmonitionType } from '../interfaces/adoc.js';
-import type { Validator } from 'jsonschema';
 import type { MacroGenerationContext, MacroMetadata, MacroName } from '../interfaces/macros.js';
 import type BaseMacro from './base-macro.js';
 import TaskQueue from './task-queue.js';
-import type { Calculate } from '../commands/index.js';
+import type { Schema } from 'jsonschema';
 /**
  * Constructor for all macros except report macros
  */
@@ -26,7 +26,7 @@ export interface SimpleMacroConstructor {
  * Constructor for report macros
  */
 export interface ReportMacroConstructor {
-    new (tasks: TaskQueue, calculate: Calculate): BaseMacro;
+    new (tasks: TaskQueue): BaseMacro;
 }
 /**
  * Constructor for all macros
@@ -39,15 +39,14 @@ export declare const macros: {
  * Validates the content inside a macro
  * @param macro - The macro to validate the content of
  * @param data - The data to validate
- * @param validator - The validator to use
  * @returns The validated data
  */
-export declare function validateMacroContent<T>(macro: MacroMetadata, data: unknown, validator?: Validator): T;
+export declare function validateMacroContent<T>(macro: MacroMetadata, data: unknown, schema?: Schema): T;
 /**
  * Registers the macros with Handlebars
  * @param {Mode} mode - The mode to register the macros in
  */
-export declare function registerMacros(instance: typeof Handlebars, context: MacroGenerationContext, tasks: TaskQueue, calculate: Calculate): BaseMacro[];
+export declare function registerMacros(instance: typeof Handlebars, context: MacroGenerationContext, tasks: TaskQueue): BaseMacro[];
 /**
  * Calculate amount of handlebars templates inside a string
  * @param input
@@ -63,9 +62,11 @@ export declare function registerEmptyMacros(instance: typeof Handlebars): void;
 /**
  * Handle the macros in the content
  * @param content - The content to handle the macros in
- * @param mode - The mode to handle the macros in. Inject mode will generate injectable placeholders for the macros while static mode will generate valid adoc. Validate mode will only validate the macros syntax and throw errors in case of issues.
+ * @param context - The context for macro generation
+ * @param calculate - The calculate function
+ * @param preserveRawBlocks - If true, don't unescape raw blocks at the end (for nested evaluations)
  */
-export declare function evaluateMacros(content: string, context: MacroGenerationContext, calculate: Calculate, maxTries?: number): Promise<string>;
+export declare function evaluateMacros(content: string, context: MacroGenerationContext, preserveRawBlocks?: boolean): Promise<string>;
 /**
  * This function assumes that tasks, which were started by macros, are complete.
  * It replaces the placeholders of the tasks with the actual results
@@ -83,20 +84,14 @@ export declare function applyMacroResults(input: string, tasks: TaskQueue, conte
  * @returns The error message that is valid adoc
  */
 export declare function handleMacroError(error: unknown, macro: string, context: MacroGenerationContext): string;
-type Value = string | number | boolean | undefined;
-/**
- * Macro options can be a flat object or a nested object
- * The nested object will be flattened into dot notation attributes
- */
-export type MacroOptions = {
-    [key: string]: Value | MacroOptions;
-};
 /**
- * Creates an injectable placeholder for a macro
- * @param macro - The macro to create the placeholder for
- * @param options - Options will be passed to the html element as attributes
+ * Creates a placeholder for a macro
+ * Options are encoded as base64
+ * @param macro - The macro to create a placeholder for
+ * @param options - The options for the macro
+ * @returns The placeholder for the macro
  */
-export declare function createHtmlPlaceholder(macro: MacroMetadata, options: MacroOptions): string;
+export declare function createHtmlPlaceholder(macro: MacroMetadata, options: unknown): string;
 /**
  * Creates an adoc admonition
  * @param type - The type of admonition
@@ -105,10 +100,23 @@ export declare function createHtmlPlaceholder(macro: MacroMetadata, options: Mac
  * @returns The adoc admonition as a string
  */
 export declare function createAdmonition(type: AdmonitionType, label: string, content: string): string;
+/**
+ * Creates a code block
+ * @param content - The content of the code block
+ * @returns The code block as a string
+ */
+export declare function createCodeBlock(content: string): string;
 /**
  * Helper function for including base64 encoded images for now
  * @param image base64 encoded image
  * @returns valid asciidoc with the image
  */
-export declare function createImage(image: string): string;
-export {};
+export declare function createImage(image: string, controls?: boolean): string;
+/**
+ * Creates a Handlebars macro block string with the given macro name and options.
+ *
+ * @param macro - The name of the macro to create (e.g., 'scoreCard', 'include').
+ * @param options - The options object to be stringified and inserted as macro content.
+ * @returns The Handlebars macro block as a string, e.g. {{#macro}}...{{/macro}}
+ */
+export declare function createMacro(macro: MacroName, options: unknown): string;

package/dist/macros/index.js

@@ -1,45 +1,128 @@
 /**
-    Cyberismo
-    Copyright © Cyberismo Ltd and contributors 2024
-
-    This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License version 3 as published by the Free Software Foundation.
-
-    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
-
-    You should have received a copy of the GNU Affero General Public
-    License along with this program.  If not, see <https://www.gnu.org/licenses/>.
+  Cyberismo
+  Copyright © Cyberismo Ltd and contributors 2024
+  This program is free software: you can redistribute it and/or modify it under
+  the terms of the GNU Affero General Public License version 3 as published by
+  the Free Software Foundation.
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+  details. You should have received a copy of the GNU Affero General Public
+  License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 import Handlebars from 'handlebars';
 import createCards from './createCards/index.js';
 import graph from './graph/index.js';
+import image from './image/index.js';
+import include from './include/index.js';
 import report from './report/index.js';
 import scoreCard from './scoreCard/index.js';
+import xref from './xref/index.js';
+import percentage from './percentage/index.js';
+import vega from './vega/index.js';
+import vegaLite from './vegalite/index.js';
 import { validateJson } from '../utils/validate.js';
-import { DHValidationError } from '../exceptions/index.js';
+import { DHValidationError, MacroError } from '../exceptions/index.js';
 import TaskQueue from './task-queue.js';
+import { ClingoError } from '@cyberismo/node-clingo';
 const CURLY_LEFT = '&#123;';
 const CURLY_RIGHT = '&#125;';
+const RAW_BLOCK_OPEN = '{{#raw}}';
+const RAW_BLOCK_CLOSE = '{{/raw}}';
+/**
+ * Pre-processes the content to handle {{#raw}} blocks by escaping all handlebars syntax inside them
+ * @param content The template content to process
+ * @returns The processed content with raw blocks escaped
+ * @throws Error if nested raw blocks are found or if a raw block is not properly closed
+ */
+function preprocessRawBlocks(content) {
+    const result = [];
+    let i = 0;
+    // Helper function to check if a target string matches at a given position without creating substrings
+    const matchesAt = (pos, target) => {
+        if (pos + target.length > content.length)
+            return false;
+        for (let k = 0; k < target.length; k++) {
+            if (content[pos + k] !== target[k])
+                return false;
+        }
+        return true;
+    };
+    // Helper function to get line number at position
+    const getLineNumber = (pos) => {
+        let lineNum = 1;
+        for (let k = 0; k < pos; k++) {
+            if (content[k] === '\n') {
+                lineNum++;
+            }
+        }
+        return lineNum;
+    };
+    while (i < content.length) {
+        // Check for {{#raw}}
+        if (matchesAt(i, RAW_BLOCK_OPEN)) {
+            const openingLine = getLineNumber(i);
+            // Find the matching {{/raw}} - no nesting allowed
+            let j = i + RAW_BLOCK_OPEN.length;
+            while (j < content.length) {
+                if (matchesAt(j, RAW_BLOCK_OPEN)) {
+                    // Found nested raw block - not supported
+                    const nestedLine = getLineNumber(j);
+                    throw new Error(`Nested ${RAW_BLOCK_OPEN} blocks are not supported. Found nested raw block inside another raw block on line ${nestedLine} (original raw block started on line ${openingLine}).`);
+                }
+                else if (matchesAt(j, RAW_BLOCK_CLOSE)) {
+                    // Found matching closing tag
+                    const rawContent = content.slice(i + RAW_BLOCK_OPEN.length, j);
+                    const escapedContent = rawContent
+                        .replaceAll('{', CURLY_LEFT)
+                        .replaceAll('}', CURLY_RIGHT);
+                    result.push(escapedContent);
+                    i = j + RAW_BLOCK_CLOSE.length;
+                    break;
+                }
+                else {
+                    j++;
+                }
+            }
+            // If we reached the end without finding a closing tag
+            if (j >= content.length) {
+                throw new Error(`Unclosed ${RAW_BLOCK_OPEN} block found on line ${openingLine}. Every ${RAW_BLOCK_OPEN} must have a matching ${RAW_BLOCK_CLOSE}.`);
+            }
+        }
+        else {
+            // Not a raw block, keep as-is
+            result.push(content[i]);
+            i++;
+        }
+    }
+    return result.join('');
+}
 export const macros = {
     createCards,
     graph,
+    image,
+    include,
     report,
     scoreCard,
+    xref,
+    percentage,
+    vega,
+    vegaLite,
 };
 /**
  * Validates the content inside a macro
  * @param macro - The macro to validate the content of
  * @param data - The data to validate
- * @param validator - The validator to use
  * @returns The validated data
  */
-export function validateMacroContent(macro, data, validator) {
+export function validateMacroContent(macro, data, schema) {
     if (!macro.schema) {
         throw new Error(`Macro ${macro.name} does not have a schema`);
     }
     try {
         return validateJson(data, {
             schemaId: macro.schema,
-            validator,
+            schema,
         });
     }
     catch (error) {
@@ -54,28 +137,16 @@ export function validateMacroContent(macro, data, validator) {
  * Registers the macros with Handlebars
  * @param {Mode} mode - The mode to register the macros in
  */
-export function registerMacros(instance, context, tasks, calculate) {
+export function registerMacros(instance, context, tasks) {
     const macroInstances = [];
     for (const macro of Object.keys(macros)) {
         const MacroClass = macros[macro];
-        const macroInstance = new MacroClass(tasks, calculate);
+        const macroInstance = new MacroClass(tasks);
         instance.registerHelper(macro, function (options) {
-            if (this != null &&
-                typeof this === 'object' &&
-                '__isRaw' in this &&
-                this.__isRaw) {
-                // we use escaped chars so that they will not be re-run
-                return `${CURLY_LEFT}${CURLY_LEFT}#${macro}${CURLY_RIGHT}${CURLY_RIGHT}${options.fn(this)}${CURLY_LEFT}${CURLY_LEFT}/${macro}${CURLY_RIGHT}${CURLY_RIGHT}`;
-            }
             return macroInstance.invokeMacro(context, options);
         });
         macroInstances.push(macroInstance);
     }
-    instance.registerHelper('raw', function (options) {
-        return options.fn({
-            __isRaw: true,
-        });
-    });
     return macroInstances;
 }
 /**
@@ -103,20 +174,22 @@ export function registerEmptyMacros(instance) {
 /**
  * Handle the macros in the content
  * @param content - The content to handle the macros in
- * @param mode - The mode to handle the macros in. Inject mode will generate injectable placeholders for the macros while static mode will generate valid adoc. Validate mode will only validate the macros syntax and throw errors in case of issues.
+ * @param context - The context for macro generation
+ * @param calculate - The calculate function
+ * @param preserveRawBlocks - If true, don't unescape raw blocks at the end (for nested evaluations)
  */
-export async function evaluateMacros(content, context, calculate, maxTries = 10) {
+export async function evaluateMacros(content, context, preserveRawBlocks = false) {
     const handlebars = Handlebars.create();
     const tasks = new TaskQueue();
-    registerMacros(handlebars, context, tasks, calculate);
+    registerMacros(handlebars, context, tasks);
     let result = content;
-    while (maxTries-- > 0) {
+    while ((context.maxTries ?? 10) > 0) {
         tasks.reset();
-        const compiled = handlebars.compile(result, {
-            strict: true,
-        });
         try {
-            result = compiled({});
+            const compiled = handlebars.compile(preprocessRawBlocks(result), {
+                strict: true,
+            });
+            result = compiled({ cardKey: context.cardKey });
             await tasks.waitAll();
             result = applyMacroResults(result, tasks, context);
             if (macroCount(result) === 0) {
@@ -131,7 +204,10 @@ export async function evaluateMacros(content, context, calculate, maxTries = 10)
     if (macroCount(result) !== 0) {
         return handleMacroError(new Error(`Too many recursive macro evaluations.`), '', context);
     }
-    return result.replaceAll(CURLY_LEFT, '{').replaceAll(CURLY_RIGHT, '}');
+    // Only unescape raw blocks if we're not preserving them for nested evaluations
+    return preserveRawBlocks
+        ? result
+        : result.replaceAll(CURLY_LEFT, '{').replaceAll(CURLY_RIGHT, '}');
 }
 /**
  * This function assumes that tasks, which were started by macros, are complete.
@@ -144,7 +220,11 @@ export async function evaluateMacros(content, context, calculate, maxTries = 10)
  */
 export function applyMacroResults(input, tasks, context) {
     for (const item of tasks) {
-        if (item.promiseResult === null) {
+        if (item.error) {
+            input = input.replace(item.placeholder, handleMacroError(item.error, item.macro, context));
+        } // It should not be possible that promiseResult is null if there never was an error
+        // Unless the function itself returns null / undefined
+        else if (item.promiseResult == null) {
             input = handleMacroError(new Error(`Tried to access result before it was resolved for ${item.placeholder}`), item.macro, context);
         }
         else {
@@ -164,6 +244,16 @@ export function handleMacroError(error, macro, context) {
     if (error instanceof DHValidationError) {
         message = `Check json syntax of macro ${macro}: ${error.errors?.map((e) => e.message).join(', ')}`;
     }
+    else if (error instanceof MacroError) {
+        const { cardKey, macroName, dependency } = error.context;
+        message = `Macro error in card '${cardKey}' in macro '${macroName}':\n\n${error.message}.`;
+        if (dependency) {
+            message += `\n\nParameters:\n\n${context.mode === 'validate' ? dependency.parameters : createCodeBlock(dependency.parameters)}.\n\n${dependency.output ? `Output:\n\n${context.mode === 'validate' ? dependency.output : createCodeBlock(dependency.output)}` : ''}`;
+        }
+    }
+    else if (error instanceof ClingoError) {
+        message = `Error running logic program in macro '${macro}':${error.details.errors.join('\n')}`;
+    }
     if (typeof error === 'object' &&
         error != null &&
         'lineNumber' in error &&
@@ -180,38 +270,19 @@ export function handleMacroError(error, macro, context) {
 // This is used to generate unique keys for macros
 // There might be a better way to do this
 let macroCounter = 0;
+function objectToBase64(obj) {
+    return Buffer.from(JSON.stringify(obj), 'utf-8').toString('base64');
+}
 /**
- * Creates an injectable placeholder for a macro
- * @param macro - The macro to create the placeholder for
- * @param options - Options will be passed to the html element as attributes
+ * Creates a placeholder for a macro
+ * Options are encoded as base64
+ * @param macro - The macro to create a placeholder for
+ * @param options - The options for the macro
+ * @returns The placeholder for the macro
  */
 export function createHtmlPlaceholder(macro, options) {
-    // Flatten nested objects into dot notation attributes
-    const flattenedOptions = {};
-    // Helper function to flatten nested objects
-    const flatten = (obj, prefix = '') => {
-        Object.entries(obj).forEach(([key, value]) => {
-            const newKey = prefix ? `${prefix}.${key}` : key;
-            if (value !== null &&
-                typeof value === 'object' &&
-                !Array.isArray(value)) {
-                // Recursively flatten nested objects
-                flatten(value, newKey);
-            }
-            else {
-                // Add leaf values to flattened options
-                flattenedOptions[newKey] = value;
-            }
-        });
-    };
-    flatten(options);
-    // Convert flattened options to attribute strings
-    const attributeStrings = Object.entries(flattenedOptions)
-        .filter(([, value]) => value !== undefined)
-        .map(([key, value]) => `${key}="${value}"`);
-    const optionString = attributeStrings.join(' ');
-    // start with a line change to ensure that inline passthrough +++ is on its own line
-    return `\n+++\n<${macro.tagName}${optionString ? ` ${optionString}` : ''} key="macro-${macroCounter++}"></${macro.tagName}>\n+++\n`;
+    const optionsBase64 = objectToBase64(options);
+    return `\n\n++++\n<${macro.tagName} options="${optionsBase64}" key="macro-${macroCounter++}"></${macro.tagName}>\n++++\n\n`;
 }
 /**
  * Creates an adoc admonition
@@ -223,22 +294,45 @@ export function createHtmlPlaceholder(macro, options) {
 export function createAdmonition(type, label, content) {
     return `[${type}]\n.${label}\n====\n${content}\n====\n\n`;
 }
+/**
+ * Creates a code block
+ * @param content - The content of the code block
+ * @returns The code block as a string
+ */
+export function createCodeBlock(content) {
+    return `\n\n----\n${content}\n----\n\n`;
+}
 /**
  * Helper function for including base64 encoded images for now
  * @param image base64 encoded image
  * @returns valid asciidoc with the image
  */
-export function createImage(image) {
+export function createImage(image, controls = true) {
     if (process.env.EXPORT_FORMAT) {
         return `image::data:image/svg+xml;base64,${image}[]\n`;
     }
     else {
-        return `++++
-<div class="cyberismo-svg-wrapper" data-type="cyberismo-svg-wrapper">
-${Buffer.from(image, 'base64').toString('utf-8')}
-</div>
-++++
-`;
+        const svg = Buffer.from(image, 'base64').toString('utf-8');
+        if (controls) {
+            return `++++\n<div class="cyberismo-svg-wrapper" data-type="cyberismo-svg-wrapper">\n${svg}\n</div>\n++++\n`;
+        }
+        else {
+            return `++++\n${svg}\n++++\n`;
+        }
+    }
+}
+/**
+ * Creates a Handlebars macro block string with the given macro name and options.
+ *
+ * @param macro - The name of the macro to create (e.g., 'scoreCard', 'include').
+ * @param options - The options object to be stringified and inserted as macro content.
+ * @returns The Handlebars macro block as a string, e.g. {{#macro}}...{{/macro}}
+ */
+export function createMacro(macro, options) {
+    let optionsString = JSON.stringify(options, null, 0);
+    if (optionsString.length > 1) {
+        optionsString = optionsString.slice(1, -1);
     }
+    return `{{#${macro}}}${optionsString}{{/${macro}}}`;
 }
 //# sourceMappingURL=index.js.map