mage-obsidian 1.1.2 → 2.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Jeanmarcos
+Copyright (c) 2024 Jeanmarcos Juarez
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,4 +1,5 @@
 [![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Q5Q816Z9WN)
+
 # MageObsidian JS Utils
 
 [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)

package/dist/cli/buildThemes.d.ts

@@ -0,0 +1,3 @@
+#! /usr/bin/env node
+export {};
+//# sourceMappingURL=buildThemes.d.ts.map

package/dist/cli/buildThemes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildThemes.d.ts","sourceRoot":"","sources":["../../src/cli/buildThemes.ts"],"names":[],"mappings":""}

package/dist/cli/buildThemes.js

@@ -0,0 +1,219 @@
+#! /usr/bin/env node
+import { Command } from "commander";
+import { execSync, spawn } from "child_process";
+import os from "os";
+import readlineSync from "readline-sync";
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import configResolver from "../core/configResolver.js";
+import preCompileMagentoFiles from "../core/preCompileMagentoFiles.js";
+import runWithConcurrency from "../utils/runWithConcurrency.js";
+import dotenv from "dotenv";
+dotenv.config();
+const program = new Command();
+program
+    .option("--theme <theme>", "Specify the active theme")
+    .option("--dev-server", "Run the development server for a specific theme")
+    .option("--typecheck", "Type-check theme sources with vue-tsc instead of building");
+program.parse(process.argv);
+const options = program.opts();
+const themesConfig = configResolver.getMagentoConfig().themes;
+if (options.devServer && !options.theme) {
+    console.error(chalk.red("Error: The --theme option is required when using --dev-server."));
+    process.exit(1);
+}
+const theme = options.theme || "all";
+const executeCommand = (command) => {
+    try {
+        execSync(command, { stdio: "inherit" });
+    }
+    catch (error) {
+        console.error(chalk.red(`Command failed: ${command}`), error);
+        process.exit(1);
+    }
+};
+function tryCreateEnvFile() {
+    const defaultEnvVars = {
+        VITE_SERVER_HOST: "phpfpm",
+        VITE_SERVER_PORT: "5173",
+        VITE_SERVER_SECURE: "true",
+        VITE_HMR_PATH: "/__vite_ping",
+        MAGENTO_HOST: "magento.test",
+        VITE_SERVER_ALLOWED_HOSTS: "magento.test,localhost",
+    };
+    console.log(chalk.blue("Creating `.env` file with default or user-provided values..."));
+    const envFilePath = path.resolve(process.cwd(), ".env");
+    if (fs.existsSync(envFilePath)) {
+        console.log(chalk.green(".env file already exists."));
+        return;
+    }
+    let envContent = "";
+    for (const [key, defaultValue] of Object.entries(defaultEnvVars)) {
+        const userInput = readlineSync.question(chalk.yellow(`Enter value for ${key} (default: ${defaultValue}): `), {
+            defaultInput: defaultValue,
+        });
+        envContent += `${key}=${userInput || defaultValue}\n`;
+    }
+    fs.writeFileSync(envFilePath, envContent);
+    console.log(chalk.green(".env file created successfully."));
+}
+function validateEnv() {
+    const requiredEnvVars = [
+        "VITE_SERVER_HOST",
+        "VITE_SERVER_PORT",
+        "VITE_SERVER_SECURE",
+        "VITE_HMR_PATH",
+        "MAGENTO_HOST",
+        "VITE_SERVER_ALLOWED_HOSTS",
+    ];
+    const missingEnvVars = [];
+    for (const envVar of requiredEnvVars) {
+        if (!process.env[envVar]) {
+            missingEnvVars.push(envVar);
+        }
+    }
+    if (missingEnvVars.length > 0) {
+        console.error(chalk.red(`Missing required environment variables: ${missingEnvVars.join(", ")}`));
+        tryCreateEnvFile();
+        console.log(chalk.green("Please restart the script after setting up the .env file."));
+        process.exit(1);
+    }
+}
+/**
+ * Build a single theme in its own child process. Each child gets its own
+ * CURRENT_THEME env so several themes can build concurrently without sharing
+ * in-process state. Output is buffered and printed as a labeled block on exit
+ * to keep parallel logs readable. Never rejects — failures surface via the
+ * returned exit code so sibling builds aren't aborted.
+ *
+ * @param {string} themeName
+ * @returns {Promise<{ themeName: string, code: number }>}
+ */
+const spawnBuild = (themeName) => new Promise((resolve) => {
+    const child = spawn("vite build", {
+        shell: true,
+        env: { ...process.env, CURRENT_THEME: themeName },
+    });
+    const chunks = [];
+    child.stdout.on("data", (data) => chunks.push(data));
+    child.stderr.on("data", (data) => chunks.push(data));
+    const finish = (code) => {
+        console.log(chalk.cyan(`\n=== ${themeName} ===`));
+        process.stdout.write(Buffer.concat(chunks).toString());
+        if (code === 0) {
+            console.log(chalk.green(`✓ ${themeName} built`));
+        }
+        else {
+            console.error(chalk.red(`✗ ${themeName} failed (exit ${code})`));
+        }
+        resolve({ themeName, code });
+    };
+    child.on("close", finish);
+    child.on("error", (error) => {
+        chunks.push(Buffer.from(String(error?.stack ?? error)));
+        finish(1);
+    });
+});
+const buildThemes = async (themeNames) => {
+    const cores = os.cpus()?.length ?? 2;
+    const limit = Math.max(1, Math.min(themeNames.length, cores - 1));
+    console.log(chalk.cyan(`Building ${themeNames.length} theme(s) (concurrency ${limit}): ${themeNames.join(", ")}`));
+    const results = await runWithConcurrency(themeNames, (themeName) => spawnBuild(themeName), limit);
+    const failed = results.filter((result) => result.code !== 0);
+    if (failed.length > 0) {
+        console.error(chalk.red(`Build failed for: ${failed.map((result) => result.themeName).join(", ")}`));
+        process.exit(1);
+    }
+};
+/**
+ * Type-check one assembled theme with vue-tsc. The theme's generated
+ * tsconfig.typecheck.json (materialized by precompile) carries the full
+ * `Vendor_Module::` paths, so every cross-module seam resolves. vue-tsc (not
+ * plain tsc) is required to check inside `<script setup lang="ts">` SFCs. Output
+ * is buffered and printed as a labeled block; never rejects — failures surface
+ * via the exit code so sibling themes still run.
+ *
+ * @param {string} themeName
+ * @returns {Promise<{ themeName: string, code: number }>}
+ */
+const spawnTypecheck = (themeName) => new Promise((resolve) => {
+    const themeDefinition = configResolver.getThemeDefinition(themeName);
+    const tsconfigPath = path.join(themeDefinition.src, "tsconfig.typecheck.json");
+    const child = spawn(`vue-tsc --noEmit -p "${tsconfigPath}"`, {
+        shell: true,
+        env: { ...process.env, CURRENT_THEME: themeName },
+    });
+    const chunks = [];
+    child.stdout.on("data", (data) => chunks.push(data));
+    child.stderr.on("data", (data) => chunks.push(data));
+    const finish = (code) => {
+        console.log(chalk.cyan(`\n=== ${themeName} (typecheck) ===`));
+        process.stdout.write(Buffer.concat(chunks).toString());
+        if (code === 0) {
+            console.log(chalk.green(`✓ ${themeName} type-checks`));
+        }
+        else {
+            console.error(chalk.red(`✗ ${themeName} has type errors (exit ${code})`));
+        }
+        resolve({ themeName, code });
+    };
+    child.on("close", finish);
+    child.on("error", (error) => {
+        chunks.push(Buffer.from(String(error?.stack ?? error)));
+        finish(1);
+    });
+});
+const typecheckThemes = async (themeNames) => {
+    // Materialize each theme's tsconfig.typecheck.json + inheritance map in-process
+    // (idempotent, cached by contract hash) before spawning vue-tsc against it.
+    for (const themeName of themeNames) {
+        await preCompileMagentoFiles(themeName);
+    }
+    console.log(chalk.cyan(`Type-checking ${themeNames.length} theme(s): ${themeNames.join(", ")}`));
+    const results = await runWithConcurrency(themeNames, (themeName) => spawnTypecheck(themeName), 1);
+    const failed = results.filter((result) => result.code !== 0);
+    if (failed.length > 0) {
+        console.error(chalk.red(`Type check failed for: ${failed.map((r) => r.themeName).join(", ")}`));
+        process.exit(1);
+    }
+};
+const runDevServer = (themeName) => {
+    console.log(chalk.cyan(`Starting development server for theme: ${themeName}`));
+    try {
+        const theme = themesConfig[themeName];
+        if (!theme) {
+            console.error(chalk.red(`Theme "${themeName}" does not exist.`));
+            process.exit(1);
+        }
+        process.env.CURRENT_THEME = themeName;
+        executeCommand("vite");
+    }
+    catch (error) {
+        console.error(chalk.red(`Failed to start development server for theme "${themeName}":`), error);
+    }
+};
+validateEnv();
+if (options.devServer) {
+    runDevServer(theme);
+}
+else {
+    let themeNames;
+    if (theme === "all") {
+        themeNames = Object.keys(themesConfig);
+    }
+    else if (themesConfig[theme]) {
+        themeNames = [theme];
+    }
+    else {
+        console.error(chalk.red(`Theme "${theme}" does not exist.`));
+        process.exit(1);
+    }
+    if (options.typecheck) {
+        await typecheckThemes(themeNames);
+    }
+    else {
+        await buildThemes(themeNames);
+    }
+}
+//# sourceMappingURL=buildThemes.js.map

package/dist/cli/buildThemes.js.map

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

package/dist/config/default.d.ts

@@ -0,0 +1,16 @@
+export declare const MAGENTO_ROOT: string;
+export declare const DEPENDENCY_CONFIG_FILENAME = "mage_obsidian_frontend_modules.json";
+export declare const MAGENTO_CONFIG_RELATIVE_PATH = "app/etc/";
+export declare const DEPENDENCY_CONFIG_FILE_PATH: string;
+export declare const MODULE_WEB_PATH = "view/frontend/web/";
+export declare const MODULE_TEMPLATES_PATH = "view/frontend/templates";
+export declare const THEME_MODULE_WEB_PATH = "web/";
+export declare const MODULE_CSS_FOLDER = "css";
+export declare const THEME_CSS_FOLDER = "css";
+export declare const OUTPUT_THEME_DIR = "web/generated";
+export declare const OUTPUT_JS_DIR = "js/";
+export declare const OUTPUT_CSS_DIR = "css/";
+export declare const PRECOMPILED_FOLDER = ".precompiled";
+export declare const INTERCEPTORS_FOLDER = "interceptors";
+export declare const ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME = "allJsVueFilesWithInheritance.json";
+//# sourceMappingURL=default.d.ts.map

package/dist/config/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/config/default.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,QAEc,CAAC;AAExC,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAChF,eAAO,MAAM,4BAA4B,aAAa,CAAC;AACvD,eAAO,MAAM,2BAA2B,QAIvC,CAAC;AAEF,eAAO,MAAM,eAAe,uBAAuB,CAAC;AACpD,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,eAAO,MAAM,2CAA2C,sCAAsC,CAAC"}

package/dist/config/default.js

@@ -0,0 +1,22 @@
+import path from "node:path";
+// The Vite harness runs from the `vite/` dir one level below the Magento root.
+// Allow an explicit root override so the engine is not tied to that cwd layout
+// (e.g. when invoked from elsewhere or in tests).
+export const MAGENTO_ROOT = process.env.MAGE_OBSIDIAN_MAGENTO_ROOT
+    ? path.resolve(process.env.MAGE_OBSIDIAN_MAGENTO_ROOT)
+    : path.resolve(process.cwd(), "..");
+export const DEPENDENCY_CONFIG_FILENAME = "mage_obsidian_frontend_modules.json";
+export const MAGENTO_CONFIG_RELATIVE_PATH = "app/etc/";
+export const DEPENDENCY_CONFIG_FILE_PATH = path.resolve(MAGENTO_ROOT, MAGENTO_CONFIG_RELATIVE_PATH, DEPENDENCY_CONFIG_FILENAME);
+export const MODULE_WEB_PATH = "view/frontend/web/";
+export const MODULE_TEMPLATES_PATH = "view/frontend/templates";
+export const THEME_MODULE_WEB_PATH = "web/";
+export const MODULE_CSS_FOLDER = "css";
+export const THEME_CSS_FOLDER = "css";
+export const OUTPUT_THEME_DIR = "web/generated";
+export const OUTPUT_JS_DIR = "js/";
+export const OUTPUT_CSS_DIR = "css/";
+export const PRECOMPILED_FOLDER = ".precompiled";
+export const INTERCEPTORS_FOLDER = "interceptors";
+export const ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME = "allJsVueFilesWithInheritance.json";
+//# sourceMappingURL=default.js.map

package/dist/config/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/config/default.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,+EAA+E;AAC/E,+EAA+E;AAC/E,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B;IAC9D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAExC,MAAM,CAAC,MAAM,0BAA0B,GAAG,qCAAqC,CAAC;AAChF,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC,OAAO,CACnD,YAAY,EACZ,4BAA4B,EAC5B,0BAA0B,CAC7B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,2CAA2C,GAAG,mCAAmC,CAAC"}

package/dist/config/eslint.js

@@ -0,0 +1,60 @@
+import js from "@eslint/js";
+import globals from "globals";
+import pluginVue from "eslint-plugin-vue";
+import tseslint from "typescript-eslint";
+import prettier from "eslint-config-prettier/flat";
+
+/**
+ * Shared flat ESLint preset for the MageObsidian stack. Consumers spread the
+ * default export and add their own `files`/`ignores`. Every plugin is imported
+ * here (inside the mage-obsidian package), so a consuming repo only needs
+ * `eslint` itself installed — the plugins resolve relative to this file.
+ *
+ * JS today, TypeScript after the engine migration: the TS rules are scoped to
+ * `*.ts*` and the Vue `<script>` parser is already the TS parser, so `.vue`
+ * files lint whether their script block is JS or TS.
+ */
+const unusedVarsOptions = {
+    argsIgnorePattern: "^_",
+    varsIgnorePattern: "^_",
+    caughtErrors: "none",
+};
+
+export default tseslint.config(
+    js.configs.recommended,
+    {
+        languageOptions: {
+            ecmaVersion: "latest",
+            sourceType: "module",
+            globals: { ...globals.node, ...globals.browser },
+        },
+    },
+    {
+        // Plain JS (author code, engine bits not yet migrated): the base rule.
+        files: ["**/*.{js,mjs,cjs}"],
+        rules: {
+            "no-unused-vars": ["error", unusedVarsOptions],
+        },
+    },
+    {
+        files: ["**/*.{ts,mts,cts,tsx}"],
+        extends: [tseslint.configs.recommended],
+        rules: {
+            // tseslint disables the base rule for TS; use the TS-aware one so
+            // labels in function-type annotations aren't flagged as unused.
+            "@typescript-eslint/no-unused-vars": ["error", unusedVarsOptions],
+            // Lenient migration baseline: the engine is typed progressively, so
+            // explicit `any` is allowed but surfaced as a warning (ratchet
+            // target, alongside tsconfig `strict`).
+            "@typescript-eslint/no-explicit-any": "warn",
+        },
+    },
+    {
+        files: ["**/*.vue"],
+        extends: [pluginVue.configs["flat/recommended"]],
+        languageOptions: {
+            parserOptions: { parser: tseslint.parser },
+        },
+    },
+    prettier,
+);

package/dist/core/configResolver.d.ts

@@ -0,0 +1,38 @@
+interface ModuleDefinition {
+    src: string;
+    [key: string]: any;
+}
+interface ThemeDefinition {
+    src: string;
+    parent?: string;
+    [key: string]: any;
+}
+export declare const getMagentoConfig: () => any;
+export declare const getContractHash: () => any;
+export declare const getModulesConfigArray: () => [string, ModuleDefinition][];
+export declare const getThemesConfigArray: () => [string, ThemeDefinition][];
+export declare const getAllMagentoModulesEnabled: () => any;
+export declare const isDev: () => boolean;
+export declare const getOutputDirFromTheme: (themePath: any) => string;
+export declare const getModuleDefinition: (moduleName: any) => ModuleDefinition;
+export declare const getThemeDefinition: (themeName: any) => ThemeDefinition;
+export declare const MODE: string;
+export declare function resolveLibPath(lib: any): string;
+export declare function resolveNodePath(packageName: any): string;
+export declare function resolveLibRealPath(lib: any): any;
+declare const _default: {
+    getMagentoConfig: () => any;
+    getContractHash: () => any;
+    getModulesConfigArray: () => [string, ModuleDefinition][];
+    getThemesConfigArray: () => [string, ThemeDefinition][];
+    getAllMagentoModulesEnabled: () => any;
+    isDev: () => boolean;
+    getOutputDirFromTheme: (themePath: any) => string;
+    getModuleDefinition: (moduleName: any) => ModuleDefinition;
+    getThemeDefinition: (themeName: any) => ThemeDefinition;
+    resolveLibPath: typeof resolveLibPath;
+    resolveNodePath: typeof resolveNodePath;
+    resolveLibRealPath: typeof resolveLibRealPath;
+};
+export default _default;
+//# sourceMappingURL=configResolver.d.ts.map

package/dist/core/configResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configResolver.d.ts","sourceRoot":"","sources":["../../src/core/configResolver.ts"],"names":[],"mappings":"AAYA,UAAU,gBAAgB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,UAAU,eAAe;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAmED,eAAO,MAAM,gBAAgB,WAAsB,CAAC;AACpD,eAAO,MAAM,eAAe,WAG3B,CAAC;AACF,eAAO,MAAM,qBAAqB,QACW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC;AAC1E,eAAO,MAAM,oBAAoB,QACW,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC;AACxE,eAAO,MAAM,2BAA2B,WAAiC,CAAC;AAC1E,eAAO,MAAM,KAAK,eAA4C,CAAC;AAE/D,eAAO,MAAM,qBAAqB,GAAI,cAAS,WAA8C,CAAC;AAE9F,eAAO,MAAM,mBAAmB,GAAI,eAAU,KAAG,gBACZ,CAAC;AAEtC,eAAO,MAAM,kBAAkB,GAAI,cAAS,KAAG,eAAkD,CAAC;AAElG,eAAO,MAAM,IAAI,QAAuB,CAAC;AAEzC,wBAAgB,cAAc,CAAC,GAAG,KAAA,UAEjC;AAED,wBAAgB,eAAe,CAAC,WAAW,KAAA,UAQ1C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,KAAA,OAErC;;;;iCA/B4C,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE;gCAE7B,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE;;;;8CAMtB,gBAAgB;4CAGlB,eAAe;;;;;AAsB9D,wBAaE"}

package/dist/core/configResolver.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { DEPENDENCY_CONFIG_FILE_PATH, OUTPUT_THEME_DIR } from "../config/default.js";
+import { validateContract } from "./contractValidator.js";
+const REGENERATE_HINT = "Try running `bin/magento mage-obsidian:frontend:config --generate` to generate the configuration file.";
+// Cached contract, invalidated by the file's mtime. A per-process `const` read
+// at import time never picked up a regenerated contract (e.g. a module enabled
+// while a long-lived dev server runs), so caches keyed only by theme served
+// stale results. Reloading on mtime change makes the contract — and the hash
+// derived from it — track the file.
+let cached = null; // { mtimeMs, config, hash }
+function fail(message, extra = []) {
+    console.error(message);
+    extra.forEach((line) => console.error(line));
+    console.error(REGENERATE_HINT);
+    process.exit(1);
+}
+function loadContract() {
+    let stats;
+    try {
+        stats = fs.statSync(DEPENDENCY_CONFIG_FILE_PATH);
+    }
+    catch (error) {
+        fail(`Error reading configuration file at ${DEPENDENCY_CONFIG_FILE_PATH}: ${error.message}`);
+    }
+    if (cached && cached.mtimeMs === stats.mtimeMs) {
+        return cached.config;
+    }
+    let config;
+    try {
+        config = JSON.parse(fs.readFileSync(DEPENDENCY_CONFIG_FILE_PATH, "utf-8"));
+    }
+    catch (error) {
+        fail(`Error reading or parsing configuration file at ${DEPENDENCY_CONFIG_FILE_PATH}: ${error.message}`);
+    }
+    const validation = validateContract(config);
+    if (!validation.ok) {
+        fail(`Invalid MageObsidian frontend contract at ${DEPENDENCY_CONFIG_FILE_PATH}:`, [
+            ...validation.errors.map((message) => `  - ${message}`),
+            "If the version differs, the PHP module and JS engine are out of sync — align their versions, then regenerate.",
+        ]);
+    }
+    // Hash the parts that change the build graph (which modules/themes exist and
+    // their resolution). Caches downstream key on this so a changed module set
+    // invalidates them, rather than serving a result keyed only by theme name.
+    const hash = crypto
+        .createHash("sha1")
+        .update(JSON.stringify({
+        modules: config.modules,
+        themes: config.themes,
+        allModules: config.allModules,
+    }))
+        .digest("hex");
+    cached = { mtimeMs: stats.mtimeMs, config, hash };
+    return config;
+}
+const getContract = () => loadContract();
+export const getMagentoConfig = () => getContract();
+export const getContractHash = () => {
+    getContract();
+    return cached.hash;
+};
+export const getModulesConfigArray = () => Object.entries(getContract().modules);
+export const getThemesConfigArray = () => Object.entries(getContract().themes);
+export const getAllMagentoModulesEnabled = () => getContract().allModules;
+export const isDev = () => getContract().mode !== "production";
+export const getOutputDirFromTheme = (themePath) => path.resolve(themePath, OUTPUT_THEME_DIR);
+export const getModuleDefinition = (moduleName) => getContract().modules[moduleName];
+export const getThemeDefinition = (themeName) => getContract().themes[themeName];
+export const MODE = process.env.NODE_ENV;
+export function resolveLibPath(lib) {
+    return path.join(getContract().LIB_PATH, lib);
+}
+export function resolveNodePath(packageName) {
+    try {
+        const resolvedPath = import.meta.resolve(packageName);
+        return resolvedPath.replace("file://", "");
+    }
+    catch (error) {
+        console.error(`The package ${packageName} can't be resolved.`);
+        throw error;
+    }
+}
+export function resolveLibRealPath(lib) {
+    return MODE === "production" ? lib : resolveNodePath(lib);
+}
+export default {
+    getMagentoConfig,
+    getContractHash,
+    getModulesConfigArray,
+    getThemesConfigArray,
+    getAllMagentoModulesEnabled,
+    isDev,
+    getOutputDirFromTheme,
+    getModuleDefinition,
+    getThemeDefinition,
+    resolveLibPath,
+    resolveNodePath,
+    resolveLibRealPath,
+};
+//# sourceMappingURL=configResolver.js.map

package/dist/core/configResolver.js.map

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

package/dist/core/contractValidator.d.ts

@@ -0,0 +1,16 @@
+export declare const EXPECTED_SCHEMA_VERSION = "1.0.0";
+export declare const REQUIRED_CONTRACT_KEYS: string[];
+/**
+ * Validate the parsed frontend contract.
+ *
+ * Pure: no IO, no process exit. The caller decides how to react to errors.
+ *
+ * @param {unknown} config Parsed contract object.
+ * @param {string} [expectedVersion] Schema version the caller expects.
+ * @returns {{ ok: boolean, errors: string[] }}
+ */
+export declare function validateContract(config: any, expectedVersion?: string): {
+    ok: boolean;
+    errors: any[];
+};
+//# sourceMappingURL=contractValidator.d.ts.map

package/dist/core/contractValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractValidator.d.ts","sourceRoot":"","sources":["../../src/core/contractValidator.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAI/C,eAAO,MAAM,sBAAsB,UAgBlC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,KAAA,EAAE,eAAe,SAA0B;;;EAqBjF"}

package/dist/core/contractValidator.js

@@ -0,0 +1,49 @@
+// Contract version this build engine understands. Must match
+// ConfigInterface::SCHEMA_VERSION on the PHP side; a mismatch means the module
+// and the JS engine are out of sync and the contract cannot be trusted.
+export const EXPECTED_SCHEMA_VERSION = "1.0.0";
+// Top-level keys the engine reads off the generated contract. Kept in step with
+// the JSON schema in module-modern-frontend/src/etc.
+export const REQUIRED_CONTRACT_KEYS = [
+    "schema_version",
+    "mode",
+    "modules",
+    "themes",
+    "allModules",
+    "VUE_COMPONENTS_PATH",
+    "JS_PATH",
+    "FOLDERS_TO_WATCH",
+    "ALLOWED_EXTENSIONS",
+    "MODULE_CSS_EXTEND_FILE",
+    "MODULE_CONFIG_FILE",
+    "THEME_CONFIG_FILE",
+    "THEME_CSS_SOURCE_FILE",
+    "THEME_FILES_PATH",
+    "LIB_PATH",
+];
+/**
+ * Validate the parsed frontend contract.
+ *
+ * Pure: no IO, no process exit. The caller decides how to react to errors.
+ *
+ * @param {unknown} config Parsed contract object.
+ * @param {string} [expectedVersion] Schema version the caller expects.
+ * @returns {{ ok: boolean, errors: string[] }}
+ */
+export function validateContract(config, expectedVersion = EXPECTED_SCHEMA_VERSION) {
+    if (config === null || typeof config !== "object" || Array.isArray(config)) {
+        return { ok: false, errors: ["Contract is not a JSON object."] };
+    }
+    const errors = [];
+    if (config.schema_version !== expectedVersion) {
+        errors.push(`Schema version mismatch: this build engine expects "${expectedVersion}" ` +
+            `but the contract is "${config.schema_version ?? "(missing)"}".`);
+    }
+    for (const key of REQUIRED_CONTRACT_KEYS) {
+        if (!Object.prototype.hasOwnProperty.call(config, key)) {
+            errors.push(`Missing required key "${key}".`);
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}
+//# sourceMappingURL=contractValidator.js.map

package/dist/core/contractValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contractValidator.js","sourceRoot":"","sources":["../../src/core/contractValidator.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,+EAA+E;AAC/E,wEAAwE;AACxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,gFAAgF;AAChF,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,gBAAgB;IAChB,MAAM;IACN,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,qBAAqB;IACrB,SAAS;IACT,kBAAkB;IAClB,oBAAoB;IACpB,wBAAwB;IACxB,oBAAoB;IACpB,mBAAmB;IACnB,uBAAuB;IACvB,kBAAkB;IAClB,UAAU;CACb,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB;IAC9E,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,gCAAgC,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,IAAI,MAAM,CAAC,cAAc,KAAK,eAAe,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CACP,uDAAuD,eAAe,IAAI;YACtE,wBAAwB,MAAM,CAAC,cAAc,IAAI,WAAW,IAAI,CACvE,CAAC;IACN,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC/C,CAAC"}

package/dist/core/cssResolver.d.ts

@@ -0,0 +1,5 @@
+declare function getTemplateSources(themeName: any): Promise<string>;
+declare function getCssImports(themeName: any): Promise<string>;
+export default getCssImports;
+export { getTemplateSources };
+//# sourceMappingURL=cssResolver.d.ts.map

package/dist/core/cssResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssResolver.d.ts","sourceRoot":"","sources":["../../src/core/cssResolver.ts"],"names":[],"mappings":"AAsFA,iBAAe,kBAAkB,CAAC,SAAS,KAAA,mBAmB1C;AAkBD,iBAAe,aAAa,CAAC,SAAS,KAAA,mBA0BrC;AAED,eAAe,aAAa,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC"}