mage-obsidian 1.1.2 → 2.0.0

package/src/core/generateJsconfig.ts

@@ -0,0 +1,168 @@
+import path from "node:path";
+import moduleResolver from "./moduleResolver.ts";
+
+// Map of `from=>to[,from2=>to2]` prefixes, read from the environment. It rewrites
+// the absolute paths baked into the generated jsconfig so go-to-definition and
+// npm resolution land on files where the editor actually runs. This matters when
+// the build runs in a container but the editor opens the same files at a
+// different mount (e.g. theme sources served at /var/www/html in the container
+// but edited at the host bind-mount). An empty map is the identity — correct
+// when the build and editor share a filesystem.
+function parsePathMap(raw?: string): Array<[string, string]> {
+    if (!raw) return [];
+    return (
+        raw
+            .split(",")
+            .map((pair) => pair.split("=>").map((part) => part.trim()))
+            .filter(
+                (parts): parts is [string, string] =>
+                    parts.length === 2 && !!parts[0] && !!parts[1],
+            )
+            .map(([from, to]) => [from, to] as [string, string])
+            // Longest `from` first so a more specific mount (e.g. the vite harness
+            // overlaid at /var/www/html/vite) wins over a broader one
+            // (/var/www/html) regardless of declaration order.
+            .sort((a, b) => b[0].length - a[0].length)
+    );
+}
+
+function remapPath(filePath: string, map: Array<[string, string]>): string {
+    for (const [from, to] of map) {
+        if (filePath.startsWith(from)) return to + filePath.slice(from.length);
+    }
+    return filePath;
+}
+
+// The Vite harness install (the `vite/` dir is the cwd during a build) is where
+// the build resolves bare npm specifiers, so point the editor at the same place.
+// Wildcard so `vue`, `@heroicons/vue/...`, `pinia` and friends all resolve.
+function nodeModulesWildcard(map: Array<[string, string]>): string {
+    return path.join(remapPath(path.resolve(process.cwd(), "node_modules"), map), "*");
+}
+
+// Engine subpath imports (`mage-obsidian/runtime/*`, `/service/*`, …) route
+// through the package's `exports` (`./runtime/*` → `./src/runtime/*`), which the
+// bare `"*"` wildcard's literal substitution would miss — it would look under the
+// package root, not `src/`. A more-specific `mage-obsidian/*` → `src/*` pattern
+// resolves them (TS prefers the longer match over `"*"`).
+function engineSrcWildcard(map: Array<[string, string]>): string {
+    return path.join(
+        remapPath(path.resolve(process.cwd(), "node_modules", "mage-obsidian", "src"), map),
+        "*",
+    );
+}
+
+/**
+ * Build the `compilerOptions.paths` map that makes the framework's
+ * `Vendor_Module::` import specifiers first-class for the editor: each maps
+ * directly to its real source file, so Ctrl+click jumps straight there and a
+ * typo surfaces as an unresolved import. Derived from the same inheritance cache
+ * the resolver uses, so the declared set matches exactly what the build resolves
+ * (`.ts`/`.js`/`.vue` — assets are not in the cache). A `"*"` wildcard adds npm
+ * package resolution from the harness node_modules.
+ */
+export default async function generateJsconfigPaths(
+    themeName: string,
+    options: { remap?: boolean } = {},
+): Promise<Record<string, string[]>> {
+    const files = (await moduleResolver.getAllJsVueFilesWithInheritance(themeName)) as Record<
+        string,
+        string
+    >;
+    // The editor jsconfig remaps container paths to the host mount so go-to-def
+    // lands on the files the editor opens. The typecheck gate runs where the build
+    // runs (same filesystem as the sources), so it opts out and keeps real paths.
+    const map =
+        options.remap === false ? [] : parsePathMap(process.env.MAGE_OBSIDIAN_TYPES_PATH_MAP);
+
+    const paths: Record<string, string[]> = {
+        "mage-obsidian/*": [engineSrcWildcard(map)],
+        "*": [nodeModulesWildcard(map)],
+    };
+
+    for (const [key, absolutePath] of Object.entries(files)) {
+        const slash = key.indexOf("/");
+        if (slash === -1) continue;
+        const namespace = key.slice(0, slash);
+        const rest = key.slice(slash + 1);
+        const target = remapPath(absolutePath, map);
+
+        paths[`${namespace}::${rest}`] = [target];
+        if (rest.startsWith("components/")) {
+            // The resolver accepts the shorthand without the `components/` prefix.
+            paths[`${namespace}::${rest.slice("components/".length)}`] = [target];
+        }
+    }
+
+    return paths;
+}
+
+const GENERATED_MARKER = "// Generated by mage-obsidian";
+
+/**
+ * Wrap a `paths` map in the full theme jsconfig the editor consumes. `allowJs`
+ * is required or the theme's `.js`/`.vue` sources never join the TS program (so
+ * nothing resolves); `baseUrl` is deliberately omitted — it is deprecated and a
+ * hard config error in TS 7.0, which makes the editor discard the whole config.
+ * The leading marker comment lets the build tell its own output apart from a
+ * hand-written jsconfig and refuse to clobber the latter.
+ */
+function buildThemeJsconfig(paths: Record<string, string[]>): string {
+    const jsconfig = {
+        compilerOptions: {
+            allowJs: true,
+            checkJs: false,
+            module: "esnext",
+            moduleResolution: "bundler",
+            paths,
+        },
+        include: ["**/*.ts", "**/*.js", "**/*.vue"],
+        exclude: ["**/generated/**", "node_modules"],
+    };
+    const header = `${GENERATED_MARKER} — do not edit. Refreshed on every build and live in dev.\n`;
+    return `${header}${JSON.stringify(jsconfig, null, 4)}\n`;
+}
+
+/**
+ * Wrap a `paths` map in the theme's typecheck tsconfig — the CI/build gate run by
+ * `vue-tsc --noEmit`. Distinct from the editor `jsconfig.json` (same dir) on
+ * purpose: it is NOT named `tsconfig.json`, so the editor's auto-discovery keeps
+ * using the jsconfig while this file is consumed only via an explicit `-p`. It is
+ * the one context where every `Vendor_Module::` resolves to its real source (the
+ * `paths` are the same map the build resolves through), so cross-module type
+ * seams are actually verified.
+ *
+ * `allowImportingTsExtensions` is required because engine imports use explicit
+ * `.ts` specifiers; it in turn requires `noEmit`. `allowJs`/`checkJs:false` keep
+ * not-yet-migrated `.js` in the graph (resolvable) without type-checking them, so
+ * a half-migrated tree still passes. `lib` carries DOM because the storefront
+ * code touches `document`/`window`/`fetch`/`localStorage`.
+ *
+ * `files` is the exact assembled set the build bundles (the inheritance-resolved
+ * absolute paths), not a recursive theme-relative glob: module sources live
+ * outside the theme dir, so such a glob would silently check nothing. Listing
+ * them explicitly is what makes the gate type-check every module/override file.
+ */
+function buildThemeTsconfig(paths: Record<string, string[]>, files: string[]): string {
+    const tsconfig = {
+        compilerOptions: {
+            noEmit: true,
+            allowImportingTsExtensions: true,
+            module: "esnext",
+            moduleResolution: "bundler",
+            target: "esnext",
+            lib: ["ESNext", "DOM", "DOM.Iterable"],
+            allowJs: true,
+            checkJs: false,
+            skipLibCheck: true,
+            strict: false,
+            paths,
+        },
+        files,
+        exclude: ["**/generated/**", "node_modules"],
+    };
+    const header = `${GENERATED_MARKER} — typecheck gate (vue-tsc). Build-managed; do not edit.\n`;
+    return `${header}${JSON.stringify(tsconfig, null, 4)}\n`;
+}
+
+export { buildThemeJsconfig, buildThemeTsconfig, GENERATED_MARKER };

package/src/{service/moduleResolver.js → core/moduleResolver.ts}

@@ -1,41 +1,49 @@
 import path from "path";
-import configResolver from "./configResolver.js";
+import configResolver from "./configResolver.ts";
 import {
     ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME,
     MODULE_WEB_PATH,
     PRECOMPILED_FOLDER,
-    THEME_MODULE_WEB_PATH
-} from "../config/default.js";
-import getFilesFromFolders from '../utils/findComponents.js'
+    THEME_MODULE_WEB_PATH,
+} from "../config/default.ts";
+import getFilesFromFolders from "../utils/findComponents.ts";
 import fs from "fs";
 import deepmerge from "deepmerge";
 
 const defaultFoldersToMap = [
     {
         src: configResolver.getMagentoConfig().VUE_COMPONENTS_PATH,
-        ext: [
-            'vue',
-            'js'
-        ]
+        ext: ["vue", "ts", "js"],
     },
     {
         src: configResolver.getMagentoConfig().JS_PATH,
-        ext: [
-            'js'
-        ]
-    }
+        ext: ["ts", "js"],
+    },
 ];
 
-const cachedModulesByTheme = {};
+// Keyed by `${theme}\0${contractHash}` so a changed module/theme set (new hash)
+// recomputes instead of returning a result keyed only by theme name.
+const cachedModulesByTheme = new Map();
+
+// NUL separator: theme names and the hex hash never contain it, so the parts
+// can't collide. Shared with invalidateTheme so its prefix match stays in
+// lock-step with the key format (a plain space here silently broke the match).
+const CACHE_KEY_SEP = "\0";
+const cacheKey = (themeName) => `${themeName}${CACHE_KEY_SEP}${configResolver.getContractHash()}`;
+
+// Caches the persisted inheritance map keyed by theme, invalidated by the file's
+// mtime so a rebuilt .precompiled JSON (watch mode, regeneration) is picked up
+// instead of serving a stale in-memory copy.
+const precompiledFileCache = new Map();
 
 async function getAllJsVueFilesFromActiveModules() {
-    let result = {};
+    const result = {};
     for (const entry of configResolver.getModulesConfigArray()) {
         const [moduleName, moduleConfig] = entry;
         const moduleResult = await getFilesFromFolders(
             moduleName,
             path.resolve(moduleConfig.src, MODULE_WEB_PATH),
-            defaultFoldersToMap
+            defaultFoldersToMap,
         );
         Object.assign(result, moduleResult);
     }
@@ -46,59 +54,77 @@ async function getAllJsVueFilesFromTheme(themeName) {
     let result = {};
     const theme = configResolver.getMagentoConfig().themes[themeName];
     if (!theme) {
-        return {}
+        return {};
     }
 
     if (theme.parent) {
-        result = await getAllJsVueFilesFromTheme(theme.parent)
+        result = await getAllJsVueFilesFromTheme(theme.parent);
     }
 
     for (const moduleName of configResolver.getAllMagentoModulesEnabled()) {
         const modulePath = path.resolve(theme.src, moduleName, THEME_MODULE_WEB_PATH);
-        const moduleResult = await getFilesFromFolders(
-            moduleName,
-            modulePath,
-            defaultFoldersToMap
-        );
+        const moduleResult = await getFilesFromFolders(moduleName, modulePath, defaultFoldersToMap);
         if (moduleResult) {
             result = deepmerge(result, moduleResult);
         }
     }
     const moduleResult = await getFilesFromFolders(
-        'Theme',
+        configResolver.getMagentoConfig().THEME_FILES_PATH,
         path.resolve(theme.src, THEME_MODULE_WEB_PATH),
-        defaultFoldersToMap
+        defaultFoldersToMap,
     );
     result = deepmerge(result, moduleResult);
     return result;
 }
 
-
-function getAllJsVueFilesWithInheritanceCached(themeName) {
+function getAllJsVueFilesWithInheritanceCached(themeName?) {
     themeName = themeName ?? process.env.CURRENT_THEME;
-    if (cachedModulesByTheme[themeName]) {
-        return cachedModulesByTheme[themeName];
+    const filePath = path.join(
+        PRECOMPILED_FOLDER,
+        themeName,
+        ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME,
+    );
+    const { mtimeMs } = fs.statSync(filePath);
+    const cached = precompiledFileCache.get(themeName);
+    if (cached && cached.mtimeMs === mtimeMs) {
+        return cached.data;
     }
-    const filePath = path.join(PRECOMPILED_FOLDER, themeName, ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME);
-    const fileContent = fs.readFileSync(filePath, "utf-8");
-    const data = JSON.parse(fileContent);
-    cachedModulesByTheme[themeName] = data;
+    const data = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    precompiledFileCache.set(themeName, { mtimeMs, data });
     return data;
 }
 
-async function getAllJsVueFilesWithInheritance(themeName) {
+async function getAllJsVueFilesWithInheritance(themeName?) {
     themeName = themeName ?? process.env.CURRENT_THEME;
-    if (cachedModulesByTheme[themeName]) {
-        return cachedModulesByTheme[themeName];
+    const key = cacheKey(themeName);
+    if (cachedModulesByTheme.has(key)) {
+        return cachedModulesByTheme.get(key);
     }
     const allJsVueFilesFromModules = await getAllJsVueFilesFromActiveModules();
     const allJsVueFilesFromThemes = await getAllJsVueFilesFromTheme(themeName);
-    cachedModulesByTheme[themeName] = deepmerge(allJsVueFilesFromModules, allJsVueFilesFromThemes);
-    return cachedModulesByTheme[themeName];
+    const merged = deepmerge(allJsVueFilesFromModules, allJsVueFilesFromThemes);
+    cachedModulesByTheme.set(key, merged);
+    return merged;
 }
 
 const moduleConfigByThemeCache = new Map();
 
+// Drop every cached entry for a theme so the next resolution recomputes from
+// disk. Adding or removing a component/js source changes neither the contract
+// nor its hash, so the (theme, hash)-keyed caches would otherwise serve a stale
+// map; the dev-server watcher calls this before regenerating on a source change.
+function invalidateTheme(themeName?) {
+    themeName = themeName ?? process.env.CURRENT_THEME;
+    const prefix = `${themeName}${CACHE_KEY_SEP}`;
+    for (const key of cachedModulesByTheme.keys()) {
+        if (key.startsWith(prefix)) cachedModulesByTheme.delete(key);
+    }
+    for (const key of moduleConfigByThemeCache.keys()) {
+        if (key.startsWith(prefix)) moduleConfigByThemeCache.delete(key);
+    }
+    precompiledFileCache.delete(themeName);
+}
+
 const MODULE_CONFIG_FILE = configResolver.getMagentoConfig().MODULE_CONFIG_FILE;
 
 /**
@@ -107,12 +133,12 @@ const MODULE_CONFIG_FILE = configResolver.getMagentoConfig().MODULE_CONFIG_FILE;
  * @returns {string} Full path to the configuration file.
  */
 function getModuleConfigPath(moduleSrc) {
-    return path.join(moduleSrc, 'view/frontend/web/', MODULE_CONFIG_FILE);
+    return path.join(moduleSrc, "view/frontend/web/", MODULE_CONFIG_FILE);
 }
 
 function resolveFileByTheme(themeName, moduleName, filePath) {
     const theme = configResolver.getMagentoConfig().themes[themeName];
-    const fullFilePath = path.join(theme.src, moduleName, 'web', filePath);
+    const fullFilePath = path.join(theme.src, moduleName, "web", filePath);
     if (fs.existsSync(fullFilePath)) {
         return fullFilePath;
     }
@@ -150,20 +176,21 @@ async function resolveModuleConfig(moduleName, themeName) {
  * @returns {object|null} Tailwind configuration object.
  */
 async function getModuleConfigByThemeConfig(themeName, themeConfig) {
-    if (moduleConfigByThemeCache.has(themeName)) {
-        return moduleConfigByThemeCache.get(themeName);
+    const key = cacheKey(themeName);
+    if (moduleConfigByThemeCache.has(key)) {
+        return moduleConfigByThemeCache.get(key);
     }
     if (!themeConfig) return null;
     const modules = configResolver.getAllMagentoModulesEnabled();
     let modulesConfig = {};
 
     for (const moduleName of modules) {
-        let moduleConfig = await resolveModuleConfig(moduleName, themeName);
+        const moduleConfig = await resolveModuleConfig(moduleName, themeName);
         if (!moduleConfig) continue;
         modulesConfig = deepmerge(modulesConfig, moduleConfig);
     }
 
-    moduleConfigByThemeCache.set(themeName, modulesConfig);
+    moduleConfigByThemeCache.set(key, modulesConfig);
     return modulesConfig;
 }
 
@@ -171,8 +198,14 @@ export default {
     getAllJsVueFilesWithInheritance,
     getAllJsVueFilesWithInheritanceCached,
     getModuleConfigByThemeConfig,
-    resolveFileByTheme
+    resolveFileByTheme,
+    invalidateTheme,
 };
 
-export { getModuleConfigByThemeConfig, resolveFileByTheme, getAllJsVueFilesWithInheritance, getAllJsVueFilesWithInheritanceCached };
-
+export {
+    getModuleConfigByThemeConfig,
+    resolveFileByTheme,
+    getAllJsVueFilesWithInheritance,
+    getAllJsVueFilesWithInheritanceCached,
+    invalidateTheme,
+};

package/src/core/preCompileFiles.ts

@@ -0,0 +1,105 @@
+import path from "path";
+import fs from "fs/promises";
+import moduleResolver from "./moduleResolver.ts";
+import {
+    PRECOMPILED_FOLDER,
+    ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME,
+} from "../config/default.ts";
+import getCssImports from "./cssResolver.ts";
+import configResolver from "./configResolver.ts";
+import generateJsconfigPaths, {
+    buildThemeJsconfig,
+    buildThemeTsconfig,
+    GENERATED_MARKER,
+} from "./generateJsconfig.ts";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+async function writeToFile(outputPath, content) {
+    await fs.mkdir(path.dirname(outputPath), { recursive: true });
+    await fs.writeFile(outputPath, content, "utf-8");
+}
+
+async function precompileCss(themeName) {
+    const cssContent = await getCssImports(themeName);
+    const outputPath = path.resolve(PRECOMPILED_FOLDER, themeName, "precompiled.css");
+    await writeToFile(outputPath, cssContent);
+}
+
+async function precompileJs(themeName) {
+    const baseJsPath = path.resolve(__dirname, "../templates/base_main_js_file.js");
+    const jsOutputPath = path.resolve(PRECOMPILED_FOLDER, themeName, "precompiled.js");
+    await fs.copyFile(baseJsPath, jsOutputPath);
+
+    const vueFilesOutputPath = path.join(
+        PRECOMPILED_FOLDER,
+        themeName,
+        ALL_JS_VUE_FILES_WITH_INHERITANCE_FILE_NAME,
+    );
+    const vueFiles = await moduleResolver.getAllJsVueFilesWithInheritance(themeName);
+    await writeToFile(vueFilesOutputPath, JSON.stringify(vueFiles));
+}
+
+// Write a build-managed config into the theme src, refusing to clobber a
+// hand-written one: only (re)writes a file carrying our generated marker, or
+// creates one when absent. Write-if-changed so an unchanged file keeps its mtime
+// (no needless TS-server reload).
+async function writeManagedConfig(outputPath, content, manages) {
+    let existing;
+    try {
+        existing = await fs.readFile(outputPath, "utf-8");
+    } catch {
+        existing = null;
+    }
+    if (existing !== null && !existing.startsWith(GENERATED_MARKER)) {
+        console.warn(
+            `[mage-obsidian] ${outputPath} is not generated by mage-obsidian; leaving it untouched. ` +
+                `Remove it to let the build manage ${manages}.`,
+        );
+        return;
+    }
+    if (existing === content) return;
+    await writeToFile(outputPath, content);
+}
+
+// The theme's jsconfig.json (gitignored) so the author's editor — which opens the
+// theme sources directly — resolves the framework's `Vendor_Module::` specifiers
+// and npm packages via `paths`. Skipped silently if the theme has no src.
+async function precompileJsconfig(themeName) {
+    const themeDefinition = configResolver.getThemeDefinition(themeName);
+    if (!themeDefinition?.src) return;
+    const paths = await generateJsconfigPaths(themeName);
+    await writeManagedConfig(
+        path.join(themeDefinition.src, "jsconfig.json"),
+        buildThemeJsconfig(paths),
+        "Vendor_Module:: import resolution",
+    );
+}
+
+// The theme's tsconfig.typecheck.json (gitignored) — the assembled `vue-tsc`
+// gate. Same `paths` the build resolves through, so every `Vendor_Module::`
+// resolves and cross-module type seams are actually checked. Not named
+// `tsconfig.json`, so it never shadows the editor jsconfig.
+async function precompileTsconfig(themeName) {
+    const themeDefinition = configResolver.getThemeDefinition(themeName);
+    if (!themeDefinition?.src) return;
+    const paths = await generateJsconfigPaths(themeName, { remap: false });
+    // The assembled file set to check: every resolved target from the literal
+    // `Vendor_Module::` keys, deduped (shorthands point at the same file). Wildcard
+    // keys (`*`, `mage-obsidian/*`) are resolution patterns, not source files.
+    const files = [
+        ...new Set(
+            Object.entries(paths)
+                .filter(([key]) => !key.includes("*"))
+                .flatMap(([, targets]) => targets),
+        ),
+    ];
+    await writeManagedConfig(
+        path.join(themeDefinition.src, "tsconfig.typecheck.json"),
+        buildThemeTsconfig(paths, files),
+        "the vue-tsc typecheck gate",
+    );
+}
+
+export { precompileCss, precompileJs, precompileJsconfig, precompileTsconfig };

package/src/core/preCompileMagentoFiles.ts

@@ -0,0 +1,34 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import {
+    precompileCss,
+    precompileJs,
+    precompileJsconfig,
+    precompileTsconfig,
+} from "./preCompileFiles.ts";
+import configResolver from "./configResolver.ts";
+import { PRECOMPILED_FOLDER } from "../config/default.ts";
+
+// Guard per (theme, contract hash): repeated calls within one process (Vite
+// re-invokes the config) skip the work, while a different theme — or the same
+// theme after the contract changed (e.g. a module enabled/disabled mid dev
+// server) — re-precompiles. Keying on the hash, not just the theme name, makes
+// the invalidation dimension explicit instead of relying on process isolation.
+const precompiledByTheme = new Map();
+
+export default async (themeName) => {
+    const contractHash = configResolver.getContractHash();
+    if (precompiledByTheme.get(themeName) === contractHash) {
+        return;
+    }
+    const themeDir = path.resolve(PRECOMPILED_FOLDER, themeName);
+    // Clean only this theme's output. The old `rm -rf .precompiled/*` wiped
+    // every theme, which would corrupt a concurrent or sibling-theme build.
+    await fs.rm(themeDir, { recursive: true, force: true });
+    await fs.mkdir(themeDir, { recursive: true });
+    await precompileJs(themeName);
+    await precompileCss(themeName);
+    await precompileJsconfig(themeName);
+    await precompileTsconfig(themeName);
+    precompiledByTheme.set(themeName, contractHash);
+};

package/src/core/themeResolverSync.ts

@@ -0,0 +1,66 @@
+import path from "path";
+import fs from "fs";
+import deepmerge from "deepmerge";
+import { THEME_MODULE_WEB_PATH } from "../config/default.ts";
+import configResolver from "./configResolver.ts";
+
+const themeConfigCache = new Map();
+const themeConfigPlainCache = new Map();
+
+function getThemeConfigPath(themeSrc) {
+    return path.join(
+        themeSrc,
+        THEME_MODULE_WEB_PATH,
+        configResolver.getMagentoConfig().THEME_CONFIG_FILE,
+    );
+}
+
+async function loadThemeConfig(themeDefinition, themeName) {
+    if (!themeDefinition) return null;
+    if (themeConfigPlainCache.has(themeName)) return themeConfigPlainCache.get(themeName);
+
+    try {
+        const configPath = getThemeConfigPath(themeDefinition.src);
+        fs.accessSync(configPath, fs.constants.F_OK);
+
+        let themeConfig = await import(pathToFileUrl(configPath));
+        themeConfig = themeConfig.default ?? themeConfig;
+
+        themeConfigPlainCache.set(themeName, themeConfig);
+        return deepmerge({}, themeConfig);
+    } catch (error) {
+        console.error(`Failed to load configuration for theme "${themeName}":`, error.message);
+        return null;
+    }
+}
+
+function pathToFileUrl(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    const fileUrl = new URL(`file://${resolvedPath}`);
+    return fileUrl.href;
+}
+
+export async function getThemeConfig(themeName) {
+    if (themeConfigCache.has(themeName)) return themeConfigCache.get(themeName);
+
+    const themeDefinition = configResolver.getMagentoConfig().themes[themeName];
+    if (!themeDefinition) return null;
+
+    let themeConfig = await loadThemeConfig(themeDefinition, themeName);
+    if (!themeConfig) return null;
+
+    themeConfig.includeCssSourceFromParentThemes ??= true;
+    themeConfig.ignoredCssFromModules ??= [];
+    themeConfig.exposeNpmPackages ??= [];
+    if (themeDefinition.parent) {
+        const parentConfig = await getThemeConfig(themeDefinition.parent);
+        themeConfig = deepmerge(parentConfig || {}, themeConfig);
+    }
+    themeConfigCache.set(themeName, themeConfig);
+    return themeConfig;
+}
+
+// Export default con todo
+export default {
+    getThemeConfig,
+};