@xpack/xpm-lib 3.0.0

package/dist/lib/functions/utils.d.ts

@@ -0,0 +1,30 @@
+export declare function isPrimitive(value: unknown): boolean;
+export declare function isJsonObject(value: unknown): boolean;
+export declare function isJsonArray(value: unknown): boolean;
+export declare function isNonEmptyJsonObject(value: unknown): boolean;
+export declare function isString(value: unknown): value is string;
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export declare function filterPath(input: string): string;
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with Posix filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export declare function filterPosixPath(input: string): string;
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with Windows filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export declare function filterWin32Path(input: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/functions/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/functions/utils.ts"],"names":[],"mappings":"AAmBA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAInD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/lib/functions/utils.js

@@ -0,0 +1,70 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/license/mit.
+ */
+/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
+// ----------------------------------------------------------------------------
+import * as os from 'node:os';
+// ----------------------------------------------------------------------------
+export function isPrimitive(value) {
+    return ((typeof value !== 'object' && typeof value !== 'function') || value === null);
+}
+export function isJsonObject(value) {
+    return value !== undefined && !isPrimitive(value) && !Array.isArray(value);
+}
+export function isJsonArray(value) {
+    return value !== undefined && Array.isArray(value);
+}
+export function isNonEmptyJsonObject(value) {
+    return isJsonObject(value) && Object.keys(value).length > 0;
+}
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export function filterPath(input) {
+    /* c8 ignore start */ /* istanbul ignore next */
+    const fixed = os.platform() === 'win32'
+        ? input.replace(/[^a-zA-Z0-9\\:]+/g, '-')
+        : input.replace(/[^a-zA-Z0-9/]+/g, '-');
+    /* c8 ignore stop */
+    return fixed.replace(/--/g, '-');
+}
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with Posix filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export function filterPosixPath(input) {
+    /* istanbul ignore next */
+    const fixed = input.replace(/[^a-zA-Z0-9/]+/g, '-');
+    return fixed.replace(/--/g, '-');
+}
+/**
+ * Replace non alphanumeric chars with dashes to make the paths
+ * comply with Windows filesystem names.
+ *
+ * @param {string} input A path candidate.
+ * @returns {string} A validated path.
+ */
+export function filterWin32Path(input) {
+    /* istanbul ignore next */
+    const fixed = input.replace(/[^a-zA-Z0-9\\:]+/g, '-');
+    return fixed.replace(/--/g, '-');
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=utils.js.map

package/dist/lib/functions/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/functions/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAE7B,+EAA+E;AAE/E,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI,CAC7E,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,qBAAqB,CAAC,0BAA0B;IAChD,MAAM,KAAK,GACT,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO;QACvB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;QACzC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;IAC3C,oBAAoB;IAEpB,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,0BAA0B;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;IAEnD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,0BAA0B;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;IAErD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAClC,CAAC;AAED,+EAA+E"}

package/dist/lib/init-template-base.d.ts

@@ -0,0 +1,46 @@
+import { Liquid } from 'liquidjs';
+import { Logger } from '@xpack/logger';
+import { XpmContext } from './types.js';
+export type XpmInitTemplatePropertiesDefinitions = Record<string, XpmInitTemplatePropertiesDefinition>;
+export interface XpmInitTemplatePropertiesDefinition {
+    label: string;
+    description: string;
+    type: 'select' | 'string' | 'number' | 'boolean';
+    items: Record<string, string | XpmInitTemplateItemValue>;
+    isMandatory?: boolean;
+    default?: string | number | boolean;
+}
+export type XpmInitTemplatePlatform = 'linux' | 'linux-x64' | 'linux-arm64' | 'win32' | 'darwin' | 'darwin-x64' | 'darwin-arm64';
+export interface XpmInitTemplateItemValue {
+    platforms: XpmInitTemplatePlatform[];
+    message: string;
+}
+export interface XpmInitTemplateSubstitutionsVariables {
+    properties: Record<string, string | boolean | number>;
+    [key: string]: unknown;
+}
+export declare abstract class XpmInitTemplateBase {
+    context: XpmContext;
+    log: Logger;
+    propertiesDefinitions: XpmInitTemplatePropertiesDefinitions;
+    __dirname: string;
+    templatesPath: string;
+    engine: Liquid;
+    substitutionsVariables?: XpmInitTemplateSubstitutionsVariables;
+    constructor({ context, propertiesDefinitions, __dirname, templatesPath, }: {
+        context: XpmContext;
+        propertiesDefinitions: XpmInitTemplatePropertiesDefinitions;
+        __dirname: string;
+        templatesPath: string;
+    });
+    run(): Promise<void>;
+    abstract generate(isInteractive: boolean): Promise<void>;
+    validateValue(name: string, value: string): string | boolean | number;
+    askForMoreValues(): Promise<void>;
+    isPlatformSupported(platforms: string[] | undefined): boolean;
+    copyFile(sourceFileRelativePath: string, destinationFilePath?: string): Promise<void>;
+    copyFolder(source: string, destination?: string): Promise<void>;
+    copyFolderRecursive(sourceFolderPath: string, destinationFolderPath: string): Promise<void>;
+    render(inputFileRelativePath: string, outputFileRelativePath: string, substitutionsVariables?: XpmInitTemplateSubstitutionsVariables): Promise<void>;
+}
+//# sourceMappingURL=init-template-base.d.ts.map

package/dist/lib/init-template-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-template-base.d.ts","sourceRoot":"","sources":["../../src/lib/init-template-base.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAMvC,MAAM,MAAM,oCAAoC,GAAG,MAAM,CACvD,MAAM,EACN,mCAAmC,CACpC,CAAA;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAAC,CAAA;IACxD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACpC;AAED,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,WAAW,GACX,aAAa,GACb,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,cAAc,CAAA;AAElB,MAAM,WAAW,wBAAwB;IAEvC,SAAS,EAAE,uBAAuB,EAAE,CAAA;IACpC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,qCAAqC;IACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAA;IACrD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAID,8BAAsB,mBAAmB;IAIvC,OAAO,EAAE,UAAU,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IAEX,qBAAqB,EAAE,oCAAoC,CAAK;IAChE,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB,CAAC,EAAE,qCAAqC,CAAA;gBAKlD,EACV,OAAO,EACP,qBAAqB,EACrB,SAAS,EACT,aAAa,GACd,EAAE;QACD,OAAO,EAAE,UAAU,CAAA;QACnB,qBAAqB,EAAE,oCAAoC,CAAA;QAC3D,SAAS,EAAE,MAAM,CAAA;QACjB,aAAa,EAAE,MAAM,CAAA;KACtB;IAmBK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA6E1B,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAExD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM;IAkC/D,gBAAgB;IAqEtB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO;IAgBvD,QAAQ,CACZ,sBAAsB,EAAE,MAAM,EAC9B,mBAAmB,SAAyB,GAC3C,OAAO,CAAC,IAAI,CAAC;IAaV,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D,mBAAmB,CACvB,gBAAgB,EAAE,MAAM,EACxB,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,IAAI,CAAC;IA0BV,MAAM,CACV,qBAAqB,EAAE,MAAM,EAC7B,sBAAsB,EAAE,MAAM,EAE9B,sBAAsB,wCAA+B,GACpD,OAAO,CAAC,IAAI,CAAC;CAsBjB"}

package/dist/lib/init-template-base.js

@@ -0,0 +1,275 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/license/mit.
+ */
+/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
+// ----------------------------------------------------------------------------
+import * as util from 'node:util';
+import * as readline from 'node:readline/promises';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+// https://www.npmjs.com/package/make-dir
+import { makeDirectory } from 'make-dir';
+// https://www.npmjs.com/package/cp-file
+import { copyFile } from 'cp-file';
+// https://www.npmjs.com/package/liquidjs
+import { Liquid } from 'liquidjs';
+import { XpmOutputError, XpmSyntaxError } from './errors.js';
+import assert from 'node:assert';
+// ----------------------------------------------------------------------------
+export class XpmInitTemplateBase {
+    // --------------------------------------------------------------------------
+    // Members.
+    context;
+    log;
+    propertiesDefinitions = {};
+    __dirname;
+    templatesPath;
+    engine;
+    substitutionsVariables;
+    // --------------------------------------------------------------------------
+    // Constructor.
+    constructor({ context, propertiesDefinitions, __dirname, templatesPath, }) {
+        this.context = context;
+        this.log = context.log;
+        this.propertiesDefinitions = propertiesDefinitions;
+        this.__dirname = __dirname;
+        this.templatesPath = templatesPath;
+        // https://liquidjs.com
+        this.engine = new Liquid({
+            root: this.templatesPath,
+            cache: false,
+            strictFilters: true, // default: false
+            strictVariables: true, // default: false
+            trimTagRight: false, // default: false
+            trimTagLeft: false, // default: false
+            greedy: false,
+        });
+    }
+    async run() {
+        const log = this.log;
+        log.trace(`${this.constructor.name}.run()`);
+        log.info();
+        const context = this.context;
+        const config = context.config;
+        assert(config.properties);
+        let isError = false;
+        for (const [key, val] of Object.entries(config.properties)) {
+            try {
+                config.properties[key] = this.validateValue(key, val);
+            }
+            catch (err) {
+                if (err instanceof Error) {
+                    log.error(err.message);
+                }
+                isError = true;
+            }
+        }
+        if (isError) {
+            throw new XpmSyntaxError();
+        }
+        // Properties set by `--property name=value` are in `config.properties`.
+        // If there is at least one mandatory property without an explicit value,
+        // enter the interactive mode and ask for the missing values.
+        const mustAsk = Object.keys(this.propertiesDefinitions).some((key) => {
+            return (this.propertiesDefinitions[key].isMandatory && !config.properties?.[key]);
+        });
+        let isInteractive;
+        if (mustAsk) {
+            // Need to ask for more values.
+            if (!(process.stdin.isTTY && process.stdout.isTTY)) {
+                throw new XpmSyntaxError('Interactive mode not possible without a TTY.');
+            }
+            await this.askForMoreValues();
+            log.trace(util.inspect(config.properties));
+            // Reset start time to skip interactive time.
+            context.startTime = Date.now();
+            isInteractive = true;
+        }
+        else {
+            // Properties without explicit values get their defaults.
+            Object.entries(this.propertiesDefinitions).forEach(([key, val]) => {
+                assert(config.properties);
+                if (!config.properties[key] && val.default) {
+                    config.properties[key] = val.default;
+                }
+            });
+            isInteractive = false;
+        }
+        const currentTime = new Date();
+        const substitutionsVariables = {
+            // Spread all config properties.
+            ...config.properties,
+            // Also pass the properties grouped.
+            properties: config.properties,
+            propertiesNames: Object.keys(config.properties),
+            projectName: config.projectName,
+            year: currentTime.getFullYear().toString(),
+        };
+        this.substitutionsVariables = substitutionsVariables;
+        await this.generate(isInteractive);
+    }
+    validateValue(name, value) {
+        const propDef = this.propertiesDefinitions[name];
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (propDef === undefined) {
+            throw new Error(`Unsupported property '${name}'`);
+        }
+        if (propDef.type === 'select') {
+            if (propDef.items[value]) {
+                if (typeof propDef.items[value] === 'string') {
+                    return value;
+                }
+                else if (typeof propDef.items[value] === 'object' &&
+                    this.isPlatformSupported(propDef.items[value].platforms)) {
+                    return value;
+                }
+            }
+        }
+        else if (propDef.type === 'boolean') {
+            if (value === 'true') {
+                return true;
+            }
+            else if (value === 'false') {
+                return false;
+            }
+        }
+        else if (propDef.type === 'number') {
+            return Number(value);
+        }
+        if (value === '' && propDef.default !== undefined) {
+            return propDef.default;
+        }
+        throw new Error(`Unsupported value '${value}' for property '${name}'`);
+    }
+    async askForMoreValues() {
+        const context = this.context;
+        const config = context.config;
+        assert(config.properties);
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        for (const name of Object.keys(this.propertiesDefinitions)) {
+            if (config.properties[name]) {
+                continue;
+            }
+            const definition = this.propertiesDefinitions[name];
+            let prompt = `${definition.label}?`;
+            if (definition.type === 'select') {
+                prompt += ' (';
+                const validItems = [];
+                for (const [ikey, ival] of Object.entries(definition.items)) {
+                    if (typeof ival === 'string') {
+                        validItems.push(ikey);
+                    }
+                    else if (typeof ival === 'object' &&
+                        this.isPlatformSupported(ival.platforms)) {
+                        validItems.push(ikey);
+                    }
+                }
+                prompt += validItems.join(', ');
+                prompt += ', ?)';
+            }
+            else if (definition.type === 'boolean') {
+                prompt += ' (true, false, ?)';
+            }
+            if (definition.default !== undefined) {
+                prompt += ` [${String(definition.default)}]`;
+            }
+            prompt += ': ';
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            while (true) {
+                const answer = (await rl.question(prompt)).trim();
+                try {
+                    const value = this.validateValue(name, answer);
+                    config.properties[name] = value;
+                    break;
+                }
+                catch (err) {
+                    if (err instanceof Error) {
+                        this.log.trace(err.message);
+                    }
+                    console.log(definition.description);
+                    if (definition.type === 'select') {
+                        for (const [ikey, ival] of Object.entries(definition.items)) {
+                            if (typeof ival === 'string') {
+                                console.log(`- ${ikey}: ${ival}`);
+                            }
+                            else if (typeof ival === 'object' &&
+                                this.isPlatformSupported(ival.platforms)) {
+                                console.log(`- ${ikey}: ${ival.message}`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    isPlatformSupported(platforms) {
+        if (!platforms || platforms.length === 0) {
+            return false;
+        }
+        if (platforms.includes(`${process.platform}-${process.arch}`)) {
+            return true;
+        }
+        if (platforms.includes(process.platform)) {
+            return true;
+        }
+        return false;
+    }
+    async copyFile(sourceFileRelativePath, destinationFilePath = sourceFileRelativePath) {
+        const log = this.log;
+        await makeDirectory(path.dirname(destinationFilePath));
+        const sourceFileAbsolutePath = path.resolve(this.templatesPath, sourceFileRelativePath);
+        await copyFile(sourceFileAbsolutePath, destinationFilePath);
+        log.info(`File '${destinationFilePath}' copied.`);
+    }
+    async copyFolder(source, destination = source) {
+        const log = this.log;
+        await this.copyFolderRecursive(path.resolve(this.templatesPath, source), path.resolve(destination));
+        log.info(`Folder '${destination}' copied.`);
+    }
+    async copyFolderRecursive(sourceFolderPath, destinationFolderPath) {
+        // const log = this.log
+        await makeDirectory(path.dirname(destinationFolderPath));
+        const dirents = await fs.readdir(sourceFolderPath, {
+            withFileTypes: true,
+        });
+        for (const dirent of dirents) {
+            // log.trace(dirent.name)
+            if (dirent.isDirectory()) {
+                await this.copyFolderRecursive(path.join(sourceFolderPath, dirent.name), path.join(destinationFolderPath, dirent.name));
+            }
+            else {
+                await copyFile(path.join(sourceFolderPath, dirent.name), path.join(destinationFolderPath, dirent.name));
+            }
+        }
+    }
+    async render(inputFileRelativePath, outputFileRelativePath, 
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    substitutionsVariables = this.substitutionsVariables) {
+        const log = this.log;
+        log.trace(`render(${inputFileRelativePath}, ${outputFileRelativePath})`);
+        await makeDirectory(path.dirname(outputFileRelativePath));
+        // const headerPath = path.resolve(codePath, `${pnam}.h`)
+        try {
+            const fileContent = (await this.engine.renderFile(inputFileRelativePath, substitutionsVariables));
+            await fs.writeFile(outputFileRelativePath, fileContent, 'utf8');
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw new XpmOutputError(err.message);
+            }
+        }
+        log.info(`File '${outputFileRelativePath}' generated.`);
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=init-template-base.js.map

package/dist/lib/init-template-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-template-base.js","sourceRoot":"","sources":["../../src/lib/init-template-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAEtC,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElC,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAKjC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,MAAM,MAAM,aAAa,CAAA;AAsChC,+EAA+E;AAE/E,MAAM,OAAgB,mBAAmB;IACvC,6EAA6E;IAC7E,WAAW;IAEX,OAAO,CAAY;IACnB,GAAG,CAAQ;IAEX,qBAAqB,GAAyC,EAAE,CAAA;IAChE,SAAS,CAAQ;IACjB,aAAa,CAAQ;IACrB,MAAM,CAAQ;IACd,sBAAsB,CAAwC;IAE9D,6EAA6E;IAC7E,eAAe;IAEf,YAAY,EACV,OAAO,EACP,qBAAqB,EACrB,SAAS,EACT,aAAa,GAMd;QACC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;QACtB,IAAI,CAAC,qBAAqB,GAAG,qBAAqB,CAAA;QAClD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAElC,uBAAuB;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,KAAK,EAAE,KAAK;YACZ,aAAa,EAAE,IAAI,EAAE,iBAAiB;YACtC,eAAe,EAAE,IAAI,EAAE,iBAAiB;YACxC,YAAY,EAAE,KAAK,EAAE,iBAAiB;YACtC,WAAW,EAAE,KAAK,EAAE,iBAAiB;YACrC,MAAM,EAAE,KAAK;SACd,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QACpB,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,CAAA;QAE3C,GAAG,CAAC,IAAI,EAAE,CAAA;QAEV,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAE7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAEzB,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAa,CAAC,CAAA;YACjE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;oBACzB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACxB,CAAC;gBACD,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,cAAc,EAAE,CAAA;QAC5B,CAAC;QAED,wEAAwE;QAExE,yEAAyE;QACzE,6DAA6D;QAE7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACnE,OAAO,CACL,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CACzE,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,aAAa,CAAA;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,+BAA+B;YAC/B,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,cAAc,CAAC,8CAA8C,CAAC,CAAA;YAC1E,CAAC;YAED,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;YAC7B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAA;YAE1C,6CAA6C;YAC7C,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC9B,aAAa,GAAG,IAAI,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE;gBAChE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;gBACzB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC3C,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,CAAA;gBACtC,CAAC;YACH,CAAC,CAAC,CAAA;YACF,aAAa,GAAG,KAAK,CAAA;QACvB,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;QAE9B,MAAM,sBAAsB,GAA0C;YACpE,gCAAgC;YAChC,GAAG,MAAM,CAAC,UAAU;YACpB,oCAAoC;YACpC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;YAC/C,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;SAC3C,CAAA;QAED,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAA;QACpD,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;IACpC,CAAC;IAID,aAAa,CAAC,IAAY,EAAE,KAAa;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;QAChD,uEAAuE;QACvE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,GAAG,CAAC,CAAA;QACnD,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC7C,OAAO,KAAK,CAAA;gBACd,CAAC;qBAAM,IACL,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;oBACxC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EACxD,CAAC;oBACD,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAA;YACb,CAAC;iBAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC7B,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;QAED,IAAI,KAAK,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAA;QACxB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,mBAAmB,IAAI,GAAG,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAE7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAEzB,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAA;QAEF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,CAAC;YAC3D,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,SAAQ;YACV,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;YACnD,IAAI,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,GAAG,CAAA;YACnC,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,IAAI,CAAA;gBACd,MAAM,UAAU,GAAG,EAAE,CAAA;gBACrB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;wBAC7B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACvB,CAAC;yBAAM,IACL,OAAO,IAAI,KAAK,QAAQ;wBACxB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,EACxC,CAAC;wBACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACvB,CAAC;gBACH,CAAC;gBACD,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC/B,MAAM,IAAI,MAAM,CAAA;YAClB,CAAC;iBAAM,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,IAAI,mBAAmB,CAAA;YAC/B,CAAC;YACD,IAAI,UAAU,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAA;YAC9C,CAAC;YACD,MAAM,IAAI,IAAI,CAAA;YAEd,uEAAuE;YACvE,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;gBACjD,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;oBAC9C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;oBAC/B,MAAK;gBACP,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;wBACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;oBAC7B,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;oBACnC,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACjC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gCAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,IAAI,EAAE,CAAC,CAAA;4BACnC,CAAC;iCAAM,IACL,OAAO,IAAI,KAAK,QAAQ;gCACxB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,EACxC,CAAC;gCACD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;4BAC3C,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,mBAAmB,CAAC,SAA+B;QACjD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,sBAA8B,EAC9B,mBAAmB,GAAG,sBAAsB;QAE5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAEpB,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAA;QAEtD,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CACzC,IAAI,CAAC,aAAa,EAClB,sBAAsB,CACvB,CAAA;QACD,MAAM,QAAQ,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAA;QAC3D,GAAG,CAAC,IAAI,CAAC,SAAS,mBAAmB,WAAW,CAAC,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,WAAW,GAAG,MAAM;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAEpB,MAAM,IAAI,CAAC,mBAAmB,CAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,EACxC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAC1B,CAAA;QACD,GAAG,CAAC,IAAI,CAAC,WAAW,WAAW,WAAW,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,gBAAwB,EACxB,qBAA6B;QAE7B,uBAAuB;QAEvB,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAA;QAExD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACjD,aAAa,EAAE,IAAI;SACpB,CAAC,CAAA;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,yBAAyB;YAEzB,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,mBAAmB,CAC5B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,EACxC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,CAC9C,CAAA;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CACZ,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,EACxC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,CAC9C,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,qBAA6B,EAC7B,sBAA8B;IAC9B,oEAAoE;IACpE,yBAAyB,IAAI,CAAC,sBAAuB;QAErD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAEpB,GAAG,CAAC,KAAK,CAAC,UAAU,qBAAqB,KAAK,sBAAsB,GAAG,CAAC,CAAA;QAExE,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAA;QAEzD,yDAAyD;QACzD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAC/C,qBAAqB,EACrB,sBAAsB,CACvB,CAAW,CAAA;YAEZ,MAAM,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACvC,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,SAAS,sBAAsB,cAAc,CAAC,CAAA;IACzD,CAAC;CACF;AAED,+EAA+E"}

package/dist/lib/liquid-actions.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from '@xpack/logger';
+import { XpmLiquidEngine } from './liquid-engine.js';
+import { XpmLiquidSubstitutionsVariables, XpmLiquidSubstitutionsStrings } from './substitutions-variables.js';
+import { JsonActions } from './types.js';
+export declare class XpmLiquidActions {
+    #private;
+    readonly log: Logger;
+    readonly engine: XpmLiquidEngine;
+    readonly substitutionsVariables: XpmLiquidSubstitutionsVariables;
+    readonly jsonActions: JsonActions;
+    constructor({ log, engine, substitutionsVariables, jsonActions, }: {
+        log: Logger;
+        engine: XpmLiquidEngine;
+        substitutionsVariables: XpmLiquidSubstitutionsVariables;
+        jsonActions: JsonActions | undefined;
+    });
+    initialise(): Promise<void>;
+    empty(): boolean;
+    names(): string[];
+    has(actionName: string): boolean;
+    get(actionName: string): XpmLiquidAction;
+}
+export declare class XpmLiquidAction {
+    #private;
+    matrixParameters?: XpmLiquidSubstitutionsStrings;
+    constructor({ actionName, parentActions, }: {
+        actionName: string;
+        parentActions: XpmLiquidActions;
+    });
+    getCommands(): Promise<string[]>;
+}
+//# sourceMappingURL=liquid-actions.d.ts.map

package/dist/lib/liquid-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-actions.d.ts","sourceRoot":"","sources":["../../src/lib/liquid-actions.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC9B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAMxC,qBAAa,gBAAgB;;IAI3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,sBAAsB,EAAE,+BAA+B,CAAA;IAChE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;gBASrB,EACV,GAAG,EACH,MAAM,EACN,sBAAsB,EACtB,WAAW,GACZ,EAAE;QACD,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,eAAe,CAAA;QACvB,sBAAsB,EAAE,+BAA+B,CAAA;QACvD,WAAW,EAAE,WAAW,GAAG,SAAS,CAAA;KACrC;IAgBK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC,KAAK,IAAI,OAAO;IAIhB,KAAK,IAAI,MAAM,EAAE;IAOjB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIhC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;CASzC;AAKD,qBAAa,eAAe;;IAQ1B,gBAAgB,CAAC,EAAE,6BAA6B,CAAA;gBAMpC,EACV,UAAU,EACV,aAAa,GACd,EAAE;QACD,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,gBAAgB,CAAA;KAChC;IAUK,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAwBvC"}

package/dist/lib/liquid-actions.js

@@ -0,0 +1,113 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/license/mit.
+ */
+/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
+// ----------------------------------------------------------------------------
+// import assert from 'assert'
+import os from 'node:os';
+import { performSubstitutions } from './functions/perform-substitutions.js';
+// ----------------------------------------------------------------------------
+// A collection of actions.
+export class XpmLiquidActions {
+    // --------------------------------------------------------------------------
+    // Members.
+    log;
+    engine;
+    substitutionsVariables;
+    jsonActions;
+    #map;
+    #isInitialised = false;
+    // --------------------------------------------------------------------------
+    // Constructor and async initialiser.
+    constructor({ log, engine, substitutionsVariables, jsonActions, }) {
+        log.trace(`${XpmLiquidActions.name}()`);
+        this.log = log;
+        this.engine = engine;
+        this.substitutionsVariables = substitutionsVariables;
+        this.jsonActions = jsonActions ?? {};
+        // Possibly empty if there are no actions.
+        this.#map = new Map();
+        // log.trace('substitutionsVariables => ', this.substitutionsVariables)
+        // The rest of the initialisation is done in the async initialiser.
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async initialise() {
+        if (this.#isInitialised) {
+            return;
+        }
+        for (const actionName of Object.keys(this.jsonActions)) {
+            // TODO: expand templates in names
+            this.#map.set(actionName, undefined);
+        }
+        this.log.trace(`${XpmLiquidActions.name}.initialise() =>`, Array.from(this.#map.keys()));
+        this.#isInitialised = true;
+    }
+    // --------------------------------------------------------------------------
+    // Methods.
+    empty() {
+        return this.#map.size === 0;
+    }
+    names() {
+        const actionNames = Array.from(this.#map.keys());
+        this.log.trace(`${XpmLiquidActions.name}.names() =>`, actionNames);
+        return actionNames;
+    }
+    has(actionName) {
+        return this.#map.has(actionName);
+    }
+    get(actionName) {
+        let action = this.#map.get(actionName);
+        if (action === undefined) {
+            action = new XpmLiquidAction({ actionName, parentActions: this });
+            this.#map.set(actionName, action);
+        }
+        return action;
+    }
+}
+// ----------------------------------------------------------------------------
+// An individual action.
+export class XpmLiquidAction {
+    // --------------------------------------------------------------------------
+    // Members.
+    #actionName;
+    #parentActions;
+    // For templates, the actual values.
+    matrixParameters;
+    #commands;
+    // --------------------------------------------------------------------------
+    // Constructor.
+    constructor({ actionName, parentActions, }) {
+        parentActions.log.trace(`${XpmLiquidAction.name}(${actionName})`);
+        this.#actionName = actionName;
+        this.#parentActions = parentActions;
+    }
+    // --------------------------------------------------------------------------
+    // Methods.
+    async getCommands() {
+        if (this.#commands === undefined) {
+            // Silently accept empty or non-existing actions.
+            const jsonAction = this.#parentActions.jsonActions[this.#actionName] ?? '';
+            const input = Array.isArray(jsonAction)
+                ? jsonAction.join(os.EOL)
+                : jsonAction;
+            const substituted = await performSubstitutions({
+                input,
+                engine: this.#parentActions.engine,
+                substitutionsVariables: this.#parentActions.substitutionsVariables,
+                log: this.#parentActions.log,
+            });
+            this.#commands = substituted.split(os.EOL);
+        }
+        this.#parentActions.log.trace(`${XpmLiquidAction.name}.commands() =>`, this.#commands);
+        return this.#commands;
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=liquid-actions.js.map

package/dist/lib/liquid-actions.js.map

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