@xpack/xpm-lib 3.0.0

package/dist/lib/liquid-build-configurations.d.ts

@@ -0,0 +1,49 @@
+import { Logger } from '@xpack/logger';
+import { XpmLiquidEngine } from './liquid-engine.js';
+import { XpmLiquidSubstitutionsVariables, XpmLiquidSubstitutionsStrings } from './substitutions-variables.js';
+import { JsonBuildConfiguration, JsonBuildConfigurations, JsonDependencies } from './types.js';
+import { XpmLiquidActions } from './liquid-actions.js';
+export declare class XpmLiquidBuildConfigurations {
+    #private;
+    readonly log: Logger;
+    readonly engine: XpmLiquidEngine;
+    readonly substitutionsVariables: XpmLiquidSubstitutionsVariables;
+    readonly jsonBuildConfigurations: JsonBuildConfigurations;
+    constructor({ log, engine, substitutionsVariables, jsonBuildConfigurations, }: {
+        log: Logger;
+        engine: XpmLiquidEngine;
+        substitutionsVariables: XpmLiquidSubstitutionsVariables;
+        jsonBuildConfigurations: JsonBuildConfigurations | undefined;
+    });
+    initialise(): Promise<void>;
+    empty(): boolean;
+    names(): string[];
+    hasJson(buildConfigurationName: string): boolean;
+    getJson(buildConfigurationName: string): JsonBuildConfiguration;
+    isHidden(buildConfigurationName: string): boolean;
+    has(buildConfigurationName: string): boolean;
+    get(buildConfigurationName: string): Promise<XpmLiquidBuildConfiguration>;
+    getJsonName(buildConfigurationName: string): string;
+}
+export declare class XpmLiquidBuildConfiguration {
+    #private;
+    readonly hidden: boolean;
+    readonly jsonBuildConfigurationName: string;
+    readonly jsonBuildConfiguration: JsonBuildConfiguration;
+    substitutionsVariables: XpmLiquidSubstitutionsVariables;
+    properties: XpmLiquidSubstitutionsStrings;
+    jsonDependencies: JsonDependencies;
+    jsonDevDependencies: JsonDependencies;
+    matrixParameters?: XpmLiquidSubstitutionsStrings;
+    constructor({ buildConfigurationName, // The Liquid-processed name.
+    jsonBuildConfigurationName, // The raw name from package.json.
+    parentBuildConfigurations, }: {
+        buildConfigurationName: string;
+        jsonBuildConfigurationName: string;
+        parentBuildConfigurations: XpmLiquidBuildConfigurations;
+    });
+    initialise(): Promise<void>;
+    get actions(): XpmLiquidActions;
+    getBuildFolderRelativePath(): Promise<string>;
+}
+//# sourceMappingURL=liquid-build-configurations.d.ts.map

package/dist/lib/liquid-build-configurations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-build-configurations.d.ts","sourceRoot":"","sources":["../../src/lib/liquid-build-configurations.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;AAErC,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOtD,qBAAa,4BAA4B;;IAIvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,sBAAsB,EAAE,+BAA+B,CAAA;IAChE,QAAQ,CAAC,uBAAuB,EAAE,uBAAuB,CAAA;gBAa7C,EACV,GAAG,EACH,MAAM,EACN,sBAAsB,EACtB,uBAAuB,GACxB,EAAE;QACD,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,eAAe,CAAA;QACvB,sBAAsB,EAAE,+BAA+B,CAAA;QACvD,uBAAuB,EAAE,uBAAuB,GAAG,SAAS,CAAA;KAC7D;IAkBK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC,KAAK,IAAI,OAAO;IAIhB,KAAK,IAAI,MAAM,EAAE;IAYjB,OAAO,CAAC,sBAAsB,EAAE,MAAM,GAAG,OAAO;IAIhD,OAAO,CAAC,sBAAsB,EAAE,MAAM,GAAG,sBAAsB;IAM/D,QAAQ,CAAC,sBAAsB,EAAE,MAAM,GAAG,OAAO;IAOjD,GAAG,CAAC,sBAAsB,EAAE,MAAM,GAAG,OAAO;IAItC,GAAG,CACP,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAAC,2BAA2B,CAAC;IAwBvC,WAAW,CAAC,sBAAsB,EAAE,MAAM,GAAG,MAAM;CAIpD;AAKD,qBAAa,2BAA2B;;IAItC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAGxB,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAA;IAE3C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAA;IAEvD,sBAAsB,EAAE,+BAA+B,CAAA;IAEvD,UAAU,EAAE,6BAA6B,CAAK;IAE9C,gBAAgB,EAAE,gBAAgB,CAAK;IACvC,mBAAmB,EAAE,gBAAgB,CAAK;IAG1C,gBAAgB,CAAC,EAAE,6BAA6B,CAAA;gBAgBpC,EACV,sBAAsB,EAAE,6BAA6B;IACrD,0BAA0B,EAAE,kCAAkC;IAC9D,yBAAyB,GAC1B,EAAE;QACD,sBAAsB,EAAE,MAAM,CAAA;QAC9B,0BAA0B,EAAE,MAAM,CAAA;QAClC,yBAAyB,EAAE,4BAA4B,CAAA;KACxD;IAuBK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkHjC,IAAI,OAAO,IAAI,gBAAgB,CAG9B;IAEK,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;CAiCpD"}

package/dist/lib/liquid-build-configurations.js

@@ -0,0 +1,267 @@
+/*
+ * 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 'node:assert';
+import path from 'node:path';
+import { buildFolderRelativePathPropertyName } from './liquid-package.js';
+import { performSubstitutions } from './functions/perform-substitutions.js';
+import { XpmLiquidActions } from './liquid-actions.js';
+import { isString } from './functions/utils.js';
+import { filterPath } from './functions/utils.js';
+// ----------------------------------------------------------------------------
+// A collection of build configurations.
+export class XpmLiquidBuildConfigurations {
+    // --------------------------------------------------------------------------
+    // Members.
+    log;
+    engine;
+    substitutionsVariables;
+    jsonBuildConfigurations;
+    #buildConfigurationsMap;
+    #jsonBuildConfigurationsNamesMap;
+    #isInitialised = false;
+    // --------------------------------------------------------------------------
+    // Constructor and async initialiser.
+    constructor({ log, engine, substitutionsVariables, jsonBuildConfigurations, }) {
+        log.trace(`${XpmLiquidBuildConfigurations.name}()`);
+        this.log = log;
+        this.engine = engine;
+        this.substitutionsVariables = substitutionsVariables;
+        this.jsonBuildConfigurations = jsonBuildConfigurations ?? {};
+        // Possibly empty if there are no build configurations.
+        this.#buildConfigurationsMap = new Map();
+        this.#jsonBuildConfigurationsNamesMap = new Map();
+        // log.trace('substitutionsVariables => ', this.substitutionsVariables)
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async initialise() {
+        if (this.#isInitialised) {
+            return;
+        }
+        for (const buildConfigurationName of Object.keys(this.jsonBuildConfigurations)) {
+            if (buildConfigurationName.includes('{{')) {
+                // TODO: expand templates and generate multiple build configurations.
+            }
+            else {
+                this.#buildConfigurationsMap.set(buildConfigurationName, undefined);
+                this.#jsonBuildConfigurationsNamesMap.set(buildConfigurationName, buildConfigurationName);
+            }
+        }
+        this.log.trace(`${XpmLiquidBuildConfigurations.name}.initialise() =>`, Array.from(this.#buildConfigurationsMap.keys()));
+        this.#isInitialised = true;
+    }
+    // --------------------------------------------------------------------------
+    // Methods.
+    empty() {
+        return this.#buildConfigurationsMap.size === 0;
+    }
+    names() {
+        const buildConfigurationsNames = Array.from(this.#buildConfigurationsMap.keys());
+        this.log.trace(`${XpmLiquidBuildConfigurations.name}.names() =>`, buildConfigurationsNames);
+        return buildConfigurationsNames;
+    }
+    hasJson(buildConfigurationName) {
+        return this.#jsonBuildConfigurationsNamesMap.has(buildConfigurationName);
+    }
+    getJson(buildConfigurationName) {
+        return this.jsonBuildConfigurations[this.getJsonName(buildConfigurationName)];
+    }
+    isHidden(buildConfigurationName) {
+        return (this.jsonBuildConfigurations[this.getJsonName(buildConfigurationName)]
+            .hidden ?? false);
+    }
+    has(buildConfigurationName) {
+        return this.#buildConfigurationsMap.has(buildConfigurationName);
+    }
+    async get(buildConfigurationName) {
+        let buildConfiguration = this.#buildConfigurationsMap.get(buildConfigurationName);
+        if (buildConfiguration === undefined) {
+            const jsonBuildConfigurationName = 
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            this.#jsonBuildConfigurationsNamesMap.get(buildConfigurationName);
+            buildConfiguration = new XpmLiquidBuildConfiguration({
+                buildConfigurationName,
+                jsonBuildConfigurationName,
+                parentBuildConfigurations: this,
+            });
+            await buildConfiguration.initialise();
+            this.#buildConfigurationsMap.set(buildConfigurationName, buildConfiguration);
+        }
+        return buildConfiguration;
+    }
+    getJsonName(buildConfigurationName) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return this.#jsonBuildConfigurationsNamesMap.get(buildConfigurationName);
+    }
+}
+// ----------------------------------------------------------------------------
+// An individual build configuration.
+export class XpmLiquidBuildConfiguration {
+    // --------------------------------------------------------------------------
+    // Members.
+    hidden;
+    // The actual (un-substituted) name from package.json.
+    jsonBuildConfigurationName;
+    // Points to the actual buildConfiguration in package.json.
+    jsonBuildConfiguration;
+    substitutionsVariables;
+    properties = {};
+    jsonDependencies = {};
+    jsonDevDependencies = {};
+    // For templates, the actual values.
+    matrixParameters;
+    // The name after performing the substitutions.
+    #buildConfigurationName;
+    #parentBuildConfigurations;
+    #actions;
+    #buildFolderRelativePath;
+    #isInitialised = false;
+    // --------------------------------------------------------------------------
+    // Constructor and async initialiser.
+    constructor({ buildConfigurationName, // The Liquid-processed name.
+    jsonBuildConfigurationName, // The raw name from package.json.
+    parentBuildConfigurations, }) {
+        parentBuildConfigurations.log.trace(`${XpmLiquidBuildConfiguration.name}(${buildConfigurationName})`);
+        this.#buildConfigurationName = buildConfigurationName;
+        this.jsonBuildConfigurationName = jsonBuildConfigurationName;
+        this.#parentBuildConfigurations = parentBuildConfigurations;
+        this.jsonBuildConfiguration =
+            parentBuildConfigurations.jsonBuildConfigurations[jsonBuildConfigurationName] ?? {};
+        this.substitutionsVariables = {
+            ...this.#parentBuildConfigurations.substitutionsVariables,
+        };
+        this.hidden = this.jsonBuildConfiguration.hidden ?? false;
+        // The rest of the initialisation is done in the async initialiser.
+    }
+    async initialise() {
+        if (this.#isInitialised) {
+            return;
+        }
+        const log = this.#parentBuildConfigurations.log;
+        const jsonBuildConfiguration = this.jsonBuildConfiguration;
+        // TODO: add matrixParameters
+        // Process both the new 'inherits' and the deprecated 'inherit'.
+        let inherits = [];
+        if (isString(jsonBuildConfiguration.inherits)) {
+            inherits = [jsonBuildConfiguration.inherits];
+        }
+        else if (Array.isArray(jsonBuildConfiguration.inherits)) {
+            inherits = jsonBuildConfiguration.inherit;
+        }
+        else if (isString(jsonBuildConfiguration.inherit)) {
+            inherits = [jsonBuildConfiguration.inherit];
+        }
+        else if (Array.isArray(jsonBuildConfiguration.inherit)) {
+            inherits = jsonBuildConfiguration.inherit;
+        }
+        // Add inherited configuration properties.
+        // TODO: detect circular references.
+        for (const inheritedBuildConfigurationName of inherits) {
+            if (this.#parentBuildConfigurations.hasJson(inheritedBuildConfigurationName)) {
+                const inheritedBuildConfiguration = await this.#parentBuildConfigurations.get(inheritedBuildConfigurationName);
+                this.properties = {
+                    ...this.properties,
+                    ...inheritedBuildConfiguration.properties,
+                };
+                this.jsonDependencies = {
+                    ...this.jsonDependencies,
+                    ...inheritedBuildConfiguration.jsonDependencies,
+                };
+                this.jsonDevDependencies = {
+                    ...this.jsonDevDependencies,
+                    ...inheritedBuildConfiguration.jsonDevDependencies,
+                };
+            }
+            else {
+                log.warn('buildConfiguration', this.#buildConfigurationName, 'inherits from missing', inheritedBuildConfigurationName, '(ignored)');
+            }
+        }
+        this.properties = {
+            ...this.properties,
+            ...jsonBuildConfiguration.properties,
+        };
+        this.jsonDependencies = {
+            ...this.jsonDependencies,
+            ...jsonBuildConfiguration.dependencies,
+        };
+        this.jsonDevDependencies = {
+            ...this.jsonDevDependencies,
+            ...jsonBuildConfiguration.devDependencies,
+        };
+        this.substitutionsVariables = {
+            ...this.#parentBuildConfigurations.substitutionsVariables,
+            properties: {
+                ...this.substitutionsVariables.properties,
+                ...this.properties,
+            },
+            configuration: {
+                ...jsonBuildConfiguration,
+                name: this.#buildConfigurationName,
+            },
+        };
+        // Add the buildFolderRelativePath property.
+        // Note: the async initialiser was needed due to this async operation.
+        const properties = this.substitutionsVariables.properties;
+        properties.buildFolderRelativePath = await this.getBuildFolderRelativePath();
+        // Please note that substitutionsVariables is not fully set at this point;
+        // it will be in the async initialiser after the constructor returns.
+        this.#actions = new XpmLiquidActions({
+            log: this.#parentBuildConfigurations.log,
+            engine: this.#parentBuildConfigurations.engine,
+            substitutionsVariables: this.substitutionsVariables,
+            jsonActions: this.jsonBuildConfiguration.actions,
+        });
+        // Note: this must be done manually by the application.
+        // await this.#actions.initialise()
+        log.trace(`${XpmLiquidBuildConfiguration.name}.initialise() =>`, this.#buildConfigurationName);
+        log.trace('properties => ', this.properties);
+        log.trace('dependencies => ', this.jsonDependencies);
+        log.trace('devDependencies => ', this.jsonDevDependencies);
+        // log.trace('substitutionsVariables => ', this.substitutionsVariables)
+        this.#isInitialised = true;
+    }
+    // --------------------------------------------------------------------------
+    // Methods.
+    get actions() {
+        assert(this.#actions !== undefined);
+        return this.#actions;
+    }
+    async getBuildFolderRelativePath() {
+        this.#buildFolderRelativePath ??= await this.#getBuildFolderRelativePath();
+        return this.#buildFolderRelativePath;
+    }
+    async #getBuildFolderRelativePath() {
+        const log = this.#parentBuildConfigurations.log;
+        let folderPath;
+        if (buildFolderRelativePathPropertyName in
+            this.substitutionsVariables.properties) {
+            folderPath = this.substitutionsVariables.properties[buildFolderRelativePathPropertyName];
+            if (folderPath !== '') {
+                try {
+                    return await performSubstitutions({
+                        log,
+                        engine: this.#parentBuildConfigurations.engine,
+                        input: folderPath,
+                        substitutionsVariables: this.substitutionsVariables,
+                    });
+                }
+                catch (err) {
+                    log.trace(err);
+                }
+            }
+        }
+        // Provide a default value, based on the name.
+        return path.join('build', filterPath(this.#buildConfigurationName));
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=liquid-build-configurations.js.map

package/dist/lib/liquid-build-configurations.js.map

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

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

@@ -0,0 +1,13 @@
+import { Liquid, Context, Drop } from 'liquidjs';
+import { Logger } from '@xpack/logger';
+import { XpmLiquidSubstitutionsStrings } from './substitutions-variables.js';
+export declare class XpmLiquidPropertiesDrop extends Drop {
+    #private;
+    constructor({ log, engine, properties, }: {
+        log: Logger;
+        engine: Liquid;
+        properties: XpmLiquidSubstitutionsStrings;
+    });
+    liquidMethodMissing(key: string, context: Context): Promise<string | string[]>;
+}
+//# sourceMappingURL=liquid-drop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-drop.d.ts","sourceRoot":"","sources":["../../src/lib/liquid-drop.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAA;AAM5E,qBAAa,uBAAwB,SAAQ,IAAI;;gBAWnC,EACV,GAAG,EACH,MAAM,EACN,UAAU,GACX,EAAE;QACD,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,6BAA6B,CAAA;KAC1C;IAac,mBAAmB,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;CAkC9B"}

package/dist/lib/liquid-drop.js

@@ -0,0 +1,56 @@
+/*
+ * 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 } ] */
+// ----------------------------------------------------------------------------
+// https://www.npmjs.com/package/liquidjs
+import { Drop } from 'liquidjs';
+// ----------------------------------------------------------------------------
+// https://liquidjs.com/
+export class XpmLiquidPropertiesDrop extends Drop {
+    // --------------------------------------------------------------------------
+    // Members.
+    #log;
+    #properties;
+    #engine;
+    // --------------------------------------------------------------------------
+    // Constructor.
+    constructor({ log, engine, properties, }) {
+        super();
+        log.trace(`${XpmLiquidPropertiesDrop.name}()`);
+        this.#log = log;
+        this.#engine = engine;
+        this.#properties = properties;
+    }
+    // --------------------------------------------------------------------------
+    // Methods.
+    async liquidMethodMissing(key, context) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (this.#properties[key] === undefined) {
+            throw new Error(`properties have no ${key} key`);
+        }
+        const log = this.#log;
+        const value = this.#properties[key] ?? '';
+        log.trace(`${XpmLiquidPropertiesDrop.name}.liquidMethodMissing('${key}') value = |`, value, '|');
+        let result;
+        const valueString = Array.isArray(value) ? value.join('') : value;
+        if (valueString.includes('{{') || valueString.includes('{%')) {
+            result = (await this.#engine.parseAndRender(valueString, context));
+        }
+        else {
+            result = value;
+        }
+        log.trace(`${XpmLiquidPropertiesDrop.name}.liquidMethodMissing('${key}') ` +
+            `result = |`, result, '|');
+        return result;
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=liquid-drop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-drop.js","sourceRoot":"","sources":["../../src/lib/liquid-drop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,yCAAyC;AACzC,OAAO,EAAmB,IAAI,EAAE,MAAM,UAAU,CAAA;AAOhD,+EAA+E;AAE/E,wBAAwB;AAExB,MAAM,OAAO,uBAAwB,SAAQ,IAAI;IAC/C,6EAA6E;IAC7E,WAAW;IAEF,IAAI,CAAQ;IACZ,WAAW,CAA+B;IAC1C,OAAO,CAAQ;IAExB,6EAA6E;IAC7E,eAAe;IAEf,YAAY,EACV,GAAG,EACH,MAAM,EACN,UAAU,GAKX;QACC,KAAK,EAAE,CAAA;QAEP,GAAG,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,IAAI,IAAI,CAAC,CAAA;QAE9C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QACf,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAA;IAC/B,CAAC;IAED,6EAA6E;IAC7E,WAAW;IAEF,KAAK,CAAC,mBAAmB,CAChC,GAAW,EACX,OAAgB;QAEhB,uEAAuE;QACvE,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,MAAM,CAAC,CAAA;QAClD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAA;QAErB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;QACzC,GAAG,CAAC,KAAK,CACP,GAAG,uBAAuB,CAAC,IAAI,yBAAyB,GAAG,cAAc,EACzE,KAAK,EACL,GAAG,CACJ,CAAA;QAED,IAAI,MAAyB,CAAA;QAE7B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QACjE,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CACzC,WAAW,EACX,OAAO,CACR,CAAW,CAAA;QACd,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,KAAK,CAAA;QAChB,CAAC;QACD,GAAG,CAAC,KAAK,CACP,GAAG,uBAAuB,CAAC,IAAI,yBAAyB,GAAG,KAAK;YAC9D,YAAY,EACd,MAAM,EACN,GAAG,CACJ,CAAA;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAED,+EAA+E"}

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

@@ -0,0 +1,5 @@
+import { Liquid } from 'liquidjs';
+export declare class XpmLiquidEngine extends Liquid {
+    constructor();
+}
+//# sourceMappingURL=liquid-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-engine.d.ts","sourceRoot":"","sources":["../../src/lib/liquid-engine.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAIjC,qBAAa,eAAgB,SAAQ,MAAM;;CA4G1C"}

package/dist/lib/liquid-engine.js

@@ -0,0 +1,85 @@
+/*
+ * 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';
+import * as path from 'node:path';
+import * as util from 'node:util';
+// https://www.npmjs.com/package/liquidjs
+import { Liquid } from 'liquidjs';
+// ----------------------------------------------------------------------------
+export class XpmLiquidEngine extends Liquid {
+    // --------------------------------------------------------------------------
+    // Members.
+    // --------------------------------------------------------------------------
+    // Constructor.
+    constructor() {
+        super({
+            strictFilters: true,
+            strictVariables: true,
+            trimTagLeft: false,
+            trimTagRight: false,
+            trimOutputLeft: false,
+            trimOutputRight: false,
+            greedy: false,
+            lenientIf: true,
+        });
+        // https://liquidjs.com/api/classes/liquid_.liquid.html#registerFilter
+        // https://nodejs.org/dist/latest-v16.x/docs/api/path.html
+        // Add the main path manipulation functions.
+        this.registerFilter('path_basename', (p, ...arg) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        path.basename(p, ...arg));
+        this.registerFilter('path_dirname', (p) => path.dirname(p));
+        this.registerFilter('path_normalize', (p) => path.normalize(p));
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        this.registerFilter('path_join', (p, ...args) => path.join(p, ...args));
+        this.registerFilter('path_relative', (from, to) => path.relative(from, to));
+        this.registerFilter('path_posix_basename', (p, ...arg) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        path.posix.basename(p, ...arg));
+        this.registerFilter('path_posix_dirname', (p) => path.posix.dirname(p));
+        this.registerFilter('path_posix_normalize', (p) => path.posix.normalize(p));
+        this.registerFilter('path_posix_join', (p, ...args) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        path.posix.join(p, ...args));
+        this.registerFilter('path_posix_relative', (from, to) => path.posix.relative(from, to));
+        this.registerFilter('path_win32_basename', (p, ...arg) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        path.win32.basename(p, ...arg));
+        this.registerFilter('path_win32_dirname', (p) => path.win32.dirname(p));
+        this.registerFilter('path_win32_normalize', (p) => path.win32.normalize(p));
+        this.registerFilter('path_win32_join', (p, ...args) => 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        path.win32.join(p, ...args));
+        this.registerFilter('path_win32_relative', (from, to) => path.win32.relative(from, to));
+        // https://nodejs.org/dist/latest-v16.x/docs/api/util.html
+        this.registerFilter('util_format', (format, ...args) => {
+            // console.log([...args])
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+            return util.format(format, ...args);
+        });
+        // Custom action.
+        this.registerFilter('to_filename', 
+        // Replace non alphanumeric chars with dashes to make the paths
+        // comply with filesystem names.
+        (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, '-');
+        });
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=liquid-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-engine.js","sourceRoot":"","sources":["../../src/lib/liquid-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,yCAAyC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,+EAA+E;AAE/E,MAAM,OAAO,eAAgB,SAAQ,MAAM;IACzC,6EAA6E;IAC7E,WAAW;IAEX,6EAA6E;IAC7E,eAAe;IAEf;QACE,KAAK,CAAC;YACJ,aAAa,EAAE,IAAI;YACnB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,KAAK;YACtB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;QAEF,sEAAsE;QACtE,0DAA0D;QAE1D,4CAA4C;QAC5C,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAS,EAAE,GAAG,GAAG,EAAE,EAAE;QACzD,iEAAiE;QACjE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CACzB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QAEnE,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAEvE,iEAAiE;QACjE,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;QAEvE,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CACxB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAS,EAAE,GAAG,GAAG,EAAE,EAAE;QAC/D,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAC/B,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC,CAAS,EAAE,EAAE,CACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACtB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,sBAAsB,EAAE,CAAC,CAAS,EAAE,EAAE,CACxD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CACxB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE;QACpD,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAC5B,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9B,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAS,EAAE,GAAG,GAAG,EAAE,EAAE;QAC/D,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAC/B,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC,CAAS,EAAE,EAAE,CACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACtB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,sBAAsB,EAAE,CAAC,CAAS,EAAE,EAAE,CACxD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CACxB,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE;QACpD,iEAAiE;QACjE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAC5B,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9B,CAAA;QAED,0DAA0D;QAE1D,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE;YACrD,yBAAyB;YACzB,iEAAiE;YACjE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QAEF,iBAAiB;QACjB,IAAI,CAAC,cAAc,CACjB,aAAa;QACb,+DAA+D;QAC/D,gCAAgC;QAChC,CAAC,KAAa,EAAU,EAAE;YACxB,qBAAqB,CAAC,0BAA0B;YAChD,MAAM,KAAK,GACT,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO;gBACvB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;gBACzC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;YAC3C,oBAAoB;YAEpB,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAClC,CAAC,CACF,CAAA;IACH,CAAC;CACF;AAED,+EAA+E"}

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

@@ -0,0 +1,17 @@
+import { Logger } from '@xpack/logger';
+import { XpmLiquidSubstitutionsVariables } from './substitutions-variables.js';
+import { XpmLiquidActions } from './liquid-actions.js';
+import { XpmLiquidBuildConfigurations } from './liquid-build-configurations.js';
+import { JsonXpmPackage } from './types.js';
+export declare const buildFolderRelativePathPropertyName = "buildFolderRelativePath";
+export declare class XpmLiquidPackage {
+    #private;
+    readonly topLiquidSubstitutionsVariables: XpmLiquidSubstitutionsVariables;
+    readonly topActions: XpmLiquidActions;
+    readonly buildConfigurations: XpmLiquidBuildConfigurations;
+    constructor({ log, jsonPackage, }: {
+        log: Logger;
+        jsonPackage: JsonXpmPackage;
+    });
+}
+//# sourceMappingURL=liquid-package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-package.d.ts","sourceRoot":"","sources":["../../src/lib/liquid-package.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAGtC,OAAO,EAEL,+BAA+B,EAChC,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAI3C,eAAO,MAAM,mCAAmC,4BAA4B,CAAA;AAI5E,qBAAa,gBAAgB;;IAQ3B,QAAQ,CAAC,+BAA+B,EAAE,+BAA+B,CAAA;IAEzE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,mBAAmB,EAAE,4BAA4B,CAAA;gBAK9C,EACV,GAAG,EACH,WAAW,GACZ,EAAE;QACD,GAAG,EAAE,MAAM,CAAA;QACX,WAAW,EAAE,cAAc,CAAA;KAC5B;CA6CF"}

package/dist/lib/liquid-package.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 assert from 'node:assert';
+import * as os from 'node:os';
+import { isJsonObject } from './functions/utils.js';
+import { xpmLiquidSubstitutionsVariablesBase, } from './substitutions-variables.js';
+import { XpmLiquidEngine } from './liquid-engine.js';
+import { XpmLiquidActions } from './liquid-actions.js';
+import { XpmLiquidBuildConfigurations } from './liquid-build-configurations.js';
+// ----------------------------------------------------------------------------
+export const buildFolderRelativePathPropertyName = 'buildFolderRelativePath';
+// ----------------------------------------------------------------------------
+export class XpmLiquidPackage {
+    // --------------------------------------------------------------------------
+    // Members.
+    #log;
+    #engine;
+    #jsonPackage;
+    topLiquidSubstitutionsVariables;
+    topActions;
+    buildConfigurations;
+    // --------------------------------------------------------------------------
+    // Constructor and async initialiser.
+    constructor({ log, jsonPackage, }) {
+        log.trace(`${XpmLiquidPackage.name}()`);
+        this.#log = log;
+        this.#engine = new XpmLiquidEngine();
+        assert(isJsonObject(jsonPackage.xpack));
+        this.#jsonPackage = jsonPackage;
+        // os.version() available since 12.x
+        assert(typeof os.version === 'function', 'Mandatory os.version available only since 12.x');
+        this.topLiquidSubstitutionsVariables = {
+            ...xpmLiquidSubstitutionsVariablesBase,
+            package: jsonPackage,
+        };
+        if (isJsonObject(jsonPackage.xpack.properties)) {
+            this.topLiquidSubstitutionsVariables.properties = {
+                ...jsonPackage.xpack.properties,
+            };
+        }
+        // Prevent adding/removing properties.
+        Object.seal(this.topLiquidSubstitutionsVariables);
+        // Empty actions.
+        this.topActions = new XpmLiquidActions({
+            log: this.#log,
+            engine: this.#engine,
+            substitutionsVariables: this.topLiquidSubstitutionsVariables,
+            jsonActions: this.#jsonPackage.xpack.actions,
+        });
+        // Empty build configurations.
+        this.buildConfigurations = new XpmLiquidBuildConfigurations({
+            log: this.#log,
+            engine: this.#engine,
+            substitutionsVariables: this.topLiquidSubstitutionsVariables,
+            jsonBuildConfigurations: this.#jsonPackage.xpack.buildConfigurations,
+        });
+    }
+}
+// ----------------------------------------------------------------------------
+//# sourceMappingURL=liquid-package.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-package.js","sourceRoot":"","sources":["../../src/lib/liquid-package.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAM7B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EACL,mCAAmC,GAEpC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAG/E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mCAAmC,GAAG,yBAAyB,CAAA;AAE5E,+EAA+E;AAE/E,MAAM,OAAO,gBAAgB;IAC3B,6EAA6E;IAC7E,WAAW;IAEF,IAAI,CAAQ;IACZ,OAAO,CAAQ;IACf,YAAY,CAAgB;IAE5B,+BAA+B,CAAiC;IAEhE,UAAU,CAAkB;IAC5B,mBAAmB,CAA8B;IAE1D,6EAA6E;IAC7E,qCAAqC;IAErC,YAAY,EACV,GAAG,EACH,WAAW,GAIZ;QACC,GAAG,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,IAAI,IAAI,CAAC,CAAA;QAEvC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;QACf,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAA;QAEpC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;QACvC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAA;QAE/B,oCAAoC;QACpC,MAAM,CACJ,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU,EAChC,gDAAgD,CACjD,CAAA;QAED,IAAI,CAAC,+BAA+B,GAAG;YACrC,GAAG,mCAAmC;YACtC,OAAO,EAAE,WAAW;SACrB,CAAA;QAED,IAAI,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,+BAA+B,CAAC,UAAU,GAAG;gBAChD,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU;aAChC,CAAA;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAA;QAEjD,iBAAiB;QACjB,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC;YACrC,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,sBAAsB,EAAE,IAAI,CAAC,+BAA+B;YAC5D,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO;SAC7C,CAAC,CAAA;QAEF,8BAA8B;QAC9B,IAAI,CAAC,mBAAmB,GAAG,IAAI,4BAA4B,CAAC;YAC1D,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,sBAAsB,EAAE,IAAI,CAAC,+BAA+B;YAC5D,uBAAuB,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,mBAAmB;SACrE,CAAC,CAAA;IACJ,CAAC;CACF;AAED,+EAA+E"}