@commerce-klaus/typescript-sfcc 0.0.0

package/README.md

@@ -0,0 +1,40 @@
+[![NPM version][npm-image]][npm-url] [![Downloads][npm-downloads-image]][npm-url]
+
+# @commerce-klaus/typescript-sfcc
+
+TypeScript tooling for Salesforce Commerce Cloud cartridge projects.
+
+The package currently ships two main entry points:
+
+- a tsserver plugin that resolves SFCC-specific module patterns such as `~/...`, `*/...`, cartridge aliases, and `module.superModule`
+- a CLI that typechecks cartridge projects with the same resolution behavior
+
+## Install
+
+```bash
+pnpm add -D @commerce-klaus/typescript-sfcc typescript
+```
+
+## tsserver Plugin
+
+Add the plugin to your cartridge `jsconfig.json` or `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "plugins": [{ "name": "@commerce-klaus/typescript-sfcc" }]
+  }
+}
+```
+
+## CLI
+
+Run the cartridge typecheck from your project root:
+
+```bash
+pnpm exec sfcc-ts-typecheck --project cartridges/jsconfig.json
+```
+
+[npm-url]: https://www.npmjs.com/package/@commerce-klaus/typescript-sfcc
+[npm-image]: https://badgen.net/npm/v/@commerce-klaus/typescript-sfcc
+[npm-downloads-image]: https://badgen.net/npm/dw/@commerce-klaus/typescript-sfcc

package/dist/index.cjs

@@ -0,0 +1,25 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./shared-tI7NsvoF.cjs");
+const require_typecheck = require("./typecheck.cjs");
+//#region src/index.ts
+require_shared.init_shared();
+//#endregion
+exports.SUPER_MODULE_TOKEN = require_shared.SUPER_MODULE_TOKEN;
+exports.SUPPORTED_RUNTIME_EXTENSIONS = require_shared.SUPPORTED_RUNTIME_EXTENSIONS;
+exports.createFormatHost = require_typecheck.createFormatHost;
+exports.createSfccModuleResolver = require_shared.createSfccModuleResolver;
+exports.createSfccPaths = require_shared.createSfccPaths;
+exports.findCartridgesDir = require_shared.findCartridgesDir;
+exports.findContainingCartridgeRoot = require_shared.findContainingCartridgeRoot;
+exports.formatDiagnostics = require_typecheck.formatDiagnostics;
+exports.inferCartridgeOrder = require_shared.inferCartridgeOrder;
+exports.injectTopLevelStatement = require_shared.injectTopLevelStatement;
+exports.parseConfigFile = require_typecheck.parseConfigFile;
+exports.readSolutionReferences = require_shared.readSolutionReferences;
+exports.resolveCandidateFile = require_shared.resolveCandidateFile;
+exports.resolveSuperModuleSpecifier = require_shared.resolveSuperModuleSpecifier;
+exports.runProjectTypecheck = require_typecheck.runProjectTypecheck;
+exports.stripExt = require_shared.stripExt;
+exports.toPosixPath = require_shared.toPosixPath;
+exports.transformSuperModuleSource = require_shared.transformSuperModuleSource;
+exports.typecheckSolutionProjects = require_typecheck.typecheckSolutionProjects;

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+import { createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects } from "./typecheck.cjs";
+
+//#region src/shared.d.ts
+declare const SUPPORTED_RUNTIME_EXTENSIONS: readonly ["js", "ds", "json"];
+declare const SUPER_MODULE_TOKEN = "__sfcc_superModule__";
+declare function findCartridgesDir(startDirectory: string): string | undefined;
+declare function readSolutionReferences(solutionConfigPath: string): string[];
+declare function inferCartridgeOrder(cartridgesDir: string, solutionConfigPath?: string): string[];
+declare function findContainingCartridgeRoot(filePath: string, cartridgeRoots: string[]): string | undefined;
+declare function stripExt(filePath: string): string;
+declare function toPosixPath(filePath: string): string;
+declare function resolveCandidateFile(basePath: string, moduleName: string): string | undefined;
+declare function createSfccPaths(configPath: string, cartridgeRoots: string[]): Record<string, string[]>;
+declare function createSfccModuleResolver(cartridgeRoots: string[]): (moduleName: string, containingFile: string) => string | undefined;
+declare function resolveSuperModuleSpecifier(filePath: string, cartridgeRoots: string[]): string | undefined;
+declare function injectTopLevelStatement(sourceCode: string, statement: string): string;
+declare function transformSuperModuleSource(sourceCode: string, filePath: string, cartridgeRoots: string[]): string;
+//#endregion
+export { SUPER_MODULE_TOKEN, SUPPORTED_RUNTIME_EXTENSIONS, createFormatHost, createSfccModuleResolver, createSfccPaths, findCartridgesDir, findContainingCartridgeRoot, formatDiagnostics, inferCartridgeOrder, injectTopLevelStatement, parseConfigFile, readSolutionReferences, resolveCandidateFile, resolveSuperModuleSpecifier, runProjectTypecheck, stripExt, toPosixPath, transformSuperModuleSource, typecheckSolutionProjects };

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects } from "./typecheck.mjs";
+
+//#region src/shared.d.ts
+declare const SUPPORTED_RUNTIME_EXTENSIONS: readonly ["js", "ds", "json"];
+declare const SUPER_MODULE_TOKEN = "__sfcc_superModule__";
+declare function findCartridgesDir(startDirectory: string): string | undefined;
+declare function readSolutionReferences(solutionConfigPath: string): string[];
+declare function inferCartridgeOrder(cartridgesDir: string, solutionConfigPath?: string): string[];
+declare function findContainingCartridgeRoot(filePath: string, cartridgeRoots: string[]): string | undefined;
+declare function stripExt(filePath: string): string;
+declare function toPosixPath(filePath: string): string;
+declare function resolveCandidateFile(basePath: string, moduleName: string): string | undefined;
+declare function createSfccPaths(configPath: string, cartridgeRoots: string[]): Record<string, string[]>;
+declare function createSfccModuleResolver(cartridgeRoots: string[]): (moduleName: string, containingFile: string) => string | undefined;
+declare function resolveSuperModuleSpecifier(filePath: string, cartridgeRoots: string[]): string | undefined;
+declare function injectTopLevelStatement(sourceCode: string, statement: string): string;
+declare function transformSuperModuleSource(sourceCode: string, filePath: string, cartridgeRoots: string[]): string;
+//#endregion
+export { SUPER_MODULE_TOKEN, SUPPORTED_RUNTIME_EXTENSIONS, createFormatHost, createSfccModuleResolver, createSfccPaths, findCartridgesDir, findContainingCartridgeRoot, formatDiagnostics, inferCartridgeOrder, injectTopLevelStatement, parseConfigFile, readSolutionReferences, resolveCandidateFile, resolveSuperModuleSpecifier, runProjectTypecheck, stripExt, toPosixPath, transformSuperModuleSource, typecheckSolutionProjects };

package/dist/index.mjs

@@ -0,0 +1,6 @@
+import { a as findCartridgesDir, c as init_shared, d as resolveCandidateFile, f as resolveSuperModuleSpecifier, g as transformSuperModuleSource, h as toPosixPath, i as createSfccPaths, l as injectTopLevelStatement, m as stripExt, n as SUPPORTED_RUNTIME_EXTENSIONS, o as findContainingCartridgeRoot, r as createSfccModuleResolver, s as inferCartridgeOrder, t as SUPER_MODULE_TOKEN, u as readSolutionReferences } from "./shared-j82Y0_wL.mjs";
+import { createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects } from "./typecheck.mjs";
+//#region src/index.ts
+init_shared();
+//#endregion
+export { SUPER_MODULE_TOKEN, SUPPORTED_RUNTIME_EXTENSIONS, createFormatHost, createSfccModuleResolver, createSfccPaths, findCartridgesDir, findContainingCartridgeRoot, formatDiagnostics, inferCartridgeOrder, injectTopLevelStatement, parseConfigFile, readSolutionReferences, resolveCandidateFile, resolveSuperModuleSpecifier, runProjectTypecheck, stripExt, toPosixPath, transformSuperModuleSource, typecheckSolutionProjects };

package/dist/shared-j82Y0_wL.mjs

@@ -0,0 +1,200 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+//#endregion
+//#region src/shared.ts
+var shared_exports = /* @__PURE__ */ __exportAll({
+	SUPER_MODULE_TOKEN: () => SUPER_MODULE_TOKEN,
+	SUPPORTED_RUNTIME_EXTENSIONS: () => SUPPORTED_RUNTIME_EXTENSIONS,
+	createSfccModuleResolver: () => createSfccModuleResolver,
+	createSfccPaths: () => createSfccPaths,
+	findCartridgesDir: () => findCartridgesDir,
+	findContainingCartridgeRoot: () => findContainingCartridgeRoot,
+	inferCartridgeOrder: () => inferCartridgeOrder,
+	injectTopLevelStatement: () => injectTopLevelStatement,
+	readSolutionReferences: () => readSolutionReferences,
+	resolveCandidateFile: () => resolveCandidateFile,
+	resolveSuperModuleSpecifier: () => resolveSuperModuleSpecifier,
+	stripExt: () => stripExt,
+	toPosixPath: () => toPosixPath,
+	transformSuperModuleSource: () => transformSuperModuleSource
+});
+function findCartridgesDir(startDirectory) {
+	let current = path.resolve(startDirectory);
+	while (true) {
+		if (path.basename(current) === "cartridges") return current;
+		const parent = path.dirname(current);
+		if (parent === current) return;
+		current = parent;
+	}
+}
+function readSolutionReferences(solutionConfigPath) {
+	const raw = fs.readFileSync(solutionConfigPath, "utf8");
+	const parsed = JSON.parse(raw);
+	return (Array.isArray(parsed.references) ? parsed.references : []).map((reference) => {
+		const absoluteReference = path.resolve(path.dirname(solutionConfigPath), reference.path ?? "");
+		if (absoluteReference.endsWith(".json")) return absoluteReference;
+		return path.join(absoluteReference, "jsconfig.json");
+	});
+}
+function inferCartridgeOrder(cartridgesDir, solutionConfigPath = path.join(cartridgesDir, "jsconfig.json")) {
+	const configured = process.env.SFCC_CARTRIDGE_PATH;
+	if (configured?.trim()) return configured.split(":").map((entry) => entry.trim()).filter(Boolean).map((entry) => path.join(cartridgesDir, entry)).filter((entry) => fs.existsSync(entry));
+	let fromReferences = [];
+	try {
+		fromReferences = readSolutionReferences(solutionConfigPath).map((configPath) => path.basename(path.dirname(configPath))).map((name) => path.join(cartridgesDir, name)).filter((cartridgeRoot) => fs.existsSync(cartridgeRoot));
+	} catch {
+		fromReferences = [];
+	}
+	const fromFilesystem = fs.readdirSync(cartridgesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => path.join(cartridgesDir, entry.name)).sort((left, right) => left.localeCompare(right));
+	if (fromReferences.length === 0) return fromFilesystem;
+	const seen = new Set(fromReferences);
+	for (const cartridgeRoot of fromFilesystem) if (!seen.has(cartridgeRoot)) {
+		fromReferences.push(cartridgeRoot);
+		seen.add(cartridgeRoot);
+	}
+	return fromReferences;
+}
+function findContainingCartridgeRoot(filePath, cartridgeRoots) {
+	const normalizedPath = path.resolve(filePath);
+	return cartridgeRoots.find((cartridgeRoot) => normalizedPath.startsWith(`${cartridgeRoot}${path.sep}`));
+}
+function stripExt(filePath) {
+	return filePath.replace(/\.[^.]+$/u, "");
+}
+function toPosixPath(filePath) {
+	return filePath.split(path.sep).join("/");
+}
+function resolveCandidateFile(basePath, moduleName) {
+	const candidates = [];
+	const extension = path.extname(basePath);
+	if (extension) {
+		candidates.push(basePath);
+		if (extension === ".ds") candidates.push(`${basePath.slice(0, -3)}.js`);
+	} else {
+		candidates.push(basePath);
+		for (const runtimeExt of SUPPORTED_RUNTIME_EXTENSIONS) candidates.push(`${basePath}.${runtimeExt}`);
+		candidates.push(`${basePath}.d.ts`);
+		for (const runtimeExt of SUPPORTED_RUNTIME_EXTENSIONS) candidates.push(path.join(basePath, `index.${runtimeExt}`));
+		candidates.push(path.join(basePath, "index.d.ts"));
+		if (moduleName.endsWith(".ds")) candidates.push(`${basePath.slice(0, -3)}.js`);
+	}
+	for (const candidate of candidates) if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) return candidate;
+}
+function createSfccPaths(configPath, cartridgeRoots) {
+	const configDir = path.dirname(configPath);
+	const paths = {
+		"dw/*": ["../../node_modules/sfcc-dts/@types/sfcc/dw/*"],
+		"~/*": ["./*"]
+	};
+	for (const cartridgeRoot of cartridgeRoots) {
+		const alias = path.basename(cartridgeRoot);
+		const relative = path.relative(configDir, cartridgeRoot).replaceAll("\\", "/");
+		paths[`${alias}/*`] = [relative ? `${relative}/*` : "./*"];
+	}
+	const modulesRoot = cartridgeRoots.find((cartridgeRoot) => path.basename(cartridgeRoot) === "modules");
+	if (modulesRoot) {
+		const base = path.relative(configDir, modulesRoot).replaceAll("\\", "/") || ".";
+		paths.server = [`${base}/server`];
+		paths["server/*"] = [`${base}/server/*`];
+	}
+	const intNapaliRoot = cartridgeRoots.find((cartridgeRoot) => path.basename(cartridgeRoot) === "int_napali");
+	if (intNapaliRoot) {
+		const relative = path.relative(configDir, intNapaliRoot).replaceAll("\\", "/");
+		paths["bc_napali/*"] = [relative ? `${relative}/*` : "./*"];
+	}
+	return paths;
+}
+function createSfccModuleResolver(cartridgeRoots) {
+	const byAlias = new Map(cartridgeRoots.map((rootPath) => [path.basename(rootPath), rootPath]));
+	const modulesRoot = byAlias.get("modules");
+	return function resolveSfccModule(moduleName, containingFile) {
+		const containingCartridgeRoot = findContainingCartridgeRoot(containingFile, cartridgeRoots);
+		if (moduleName === "server" && modulesRoot) return resolveCandidateFile(path.join(modulesRoot, "server"), moduleName);
+		if (moduleName.startsWith("server/") && modulesRoot) return resolveCandidateFile(path.join(modulesRoot, moduleName), moduleName);
+		if (moduleName.startsWith("~/")) {
+			if (!containingCartridgeRoot) return;
+			return resolveCandidateFile(path.join(containingCartridgeRoot, moduleName.slice(2)), moduleName);
+		}
+		if (moduleName.startsWith("*/")) {
+			const relativeToCartridge = moduleName.slice(2);
+			if (!relativeToCartridge) return;
+			for (const cartridgeRoot of cartridgeRoots) {
+				const resolved = resolveCandidateFile(path.join(cartridgeRoot, relativeToCartridge), moduleName);
+				if (resolved) return resolved;
+			}
+		}
+		const aliasMatch = /^([A-Za-z0-9_-]+)\/(cartridge\/.*)$/u.exec(moduleName);
+		if (aliasMatch) {
+			const cartridgeRoot = byAlias.get(aliasMatch[1]);
+			if (!cartridgeRoot) return;
+			return resolveCandidateFile(path.join(cartridgeRoot, aliasMatch[2]), moduleName);
+		}
+	};
+}
+function resolveSuperModuleSpecifier(filePath, cartridgeRoots) {
+	const containingCartridgeRoot = findContainingCartridgeRoot(filePath, cartridgeRoots);
+	if (!containingCartridgeRoot) return;
+	const relativeModulePath = stripExt(path.relative(containingCartridgeRoot, filePath));
+	const ownCartridgeName = path.basename(containingCartridgeRoot);
+	const ownCartridgeIndex = cartridgeRoots.findIndex((cartridgeRoot) => path.basename(cartridgeRoot) === ownCartridgeName);
+	if (ownCartridgeIndex === -1) return;
+	const nextCartridges = cartridgeRoots.slice(ownCartridgeIndex + 1);
+	for (const nextCartridgeRoot of nextCartridges) {
+		if (!resolveCandidateFile(path.join(nextCartridgeRoot, relativeModulePath), relativeModulePath)) continue;
+		return `${path.basename(nextCartridgeRoot)}/${toPosixPath(relativeModulePath)}`;
+	}
+}
+function injectTopLevelStatement(sourceCode, statement) {
+	if (sourceCode.startsWith("#!")) {
+		const firstNewline = sourceCode.indexOf("\n");
+		if (firstNewline === -1) return `${sourceCode}\n${statement}\n`;
+		return `${sourceCode.slice(0, firstNewline + 1)}${injectTopLevelStatement(sourceCode.slice(firstNewline + 1), statement)}`;
+	}
+	const useStrictMatch = sourceCode.match(/^(\s*['"]use strict['"];?\s*\r?\n)/u);
+	if (useStrictMatch) return `${useStrictMatch[1]}${statement}\n${sourceCode.slice(useStrictMatch[1].length)}`;
+	return `${statement}\n${sourceCode}`;
+}
+function transformSuperModuleSource(sourceCode, filePath, cartridgeRoots) {
+	if (!sourceCode.includes("module.superModule")) return sourceCode;
+	const superModuleSpecifier = resolveSuperModuleSpecifier(filePath, cartridgeRoots);
+	if (!superModuleSpecifier) return sourceCode.replaceAll(/\bmodule\.superModule\b/gu, "undefined");
+	return injectTopLevelStatement(sourceCode.replaceAll(/\bmodule\.superModule\b/gu, SUPER_MODULE_TOKEN), `const ${SUPER_MODULE_TOKEN} = require(${JSON.stringify(superModuleSpecifier)});`);
+}
+var SUPPORTED_RUNTIME_EXTENSIONS, SUPER_MODULE_TOKEN;
+var init_shared = __esmMin((() => {
+	SUPPORTED_RUNTIME_EXTENSIONS = [
+		"js",
+		"ds",
+		"json"
+	];
+	SUPER_MODULE_TOKEN = "__sfcc_superModule__";
+}));
+//#endregion
+export { __commonJSMin as _, findCartridgesDir as a, init_shared as c, resolveCandidateFile as d, resolveSuperModuleSpecifier as f, transformSuperModuleSource as g, toPosixPath as h, createSfccPaths as i, injectTopLevelStatement as l, stripExt as m, SUPPORTED_RUNTIME_EXTENSIONS as n, findContainingCartridgeRoot as o, shared_exports as p, createSfccModuleResolver as r, inferCartridgeOrder as s, SUPER_MODULE_TOKEN as t, readSolutionReferences as u, __toCommonJS as v };

package/dist/shared-tI7NsvoF.cjs

@@ -0,0 +1,314 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+//#endregion
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+//#region src/shared.ts
+var shared_exports = /* @__PURE__ */ __exportAll({
+	SUPER_MODULE_TOKEN: () => SUPER_MODULE_TOKEN,
+	SUPPORTED_RUNTIME_EXTENSIONS: () => SUPPORTED_RUNTIME_EXTENSIONS,
+	createSfccModuleResolver: () => createSfccModuleResolver,
+	createSfccPaths: () => createSfccPaths,
+	findCartridgesDir: () => findCartridgesDir,
+	findContainingCartridgeRoot: () => findContainingCartridgeRoot,
+	inferCartridgeOrder: () => inferCartridgeOrder,
+	injectTopLevelStatement: () => injectTopLevelStatement,
+	readSolutionReferences: () => readSolutionReferences,
+	resolveCandidateFile: () => resolveCandidateFile,
+	resolveSuperModuleSpecifier: () => resolveSuperModuleSpecifier,
+	stripExt: () => stripExt,
+	toPosixPath: () => toPosixPath,
+	transformSuperModuleSource: () => transformSuperModuleSource
+});
+function findCartridgesDir(startDirectory) {
+	let current = node_path.default.resolve(startDirectory);
+	while (true) {
+		if (node_path.default.basename(current) === "cartridges") return current;
+		const parent = node_path.default.dirname(current);
+		if (parent === current) return;
+		current = parent;
+	}
+}
+function readSolutionReferences(solutionConfigPath) {
+	const raw = node_fs.default.readFileSync(solutionConfigPath, "utf8");
+	const parsed = JSON.parse(raw);
+	return (Array.isArray(parsed.references) ? parsed.references : []).map((reference) => {
+		const absoluteReference = node_path.default.resolve(node_path.default.dirname(solutionConfigPath), reference.path ?? "");
+		if (absoluteReference.endsWith(".json")) return absoluteReference;
+		return node_path.default.join(absoluteReference, "jsconfig.json");
+	});
+}
+function inferCartridgeOrder(cartridgesDir, solutionConfigPath = node_path.default.join(cartridgesDir, "jsconfig.json")) {
+	const configured = process.env.SFCC_CARTRIDGE_PATH;
+	if (configured?.trim()) return configured.split(":").map((entry) => entry.trim()).filter(Boolean).map((entry) => node_path.default.join(cartridgesDir, entry)).filter((entry) => node_fs.default.existsSync(entry));
+	let fromReferences = [];
+	try {
+		fromReferences = readSolutionReferences(solutionConfigPath).map((configPath) => node_path.default.basename(node_path.default.dirname(configPath))).map((name) => node_path.default.join(cartridgesDir, name)).filter((cartridgeRoot) => node_fs.default.existsSync(cartridgeRoot));
+	} catch {
+		fromReferences = [];
+	}
+	const fromFilesystem = node_fs.default.readdirSync(cartridgesDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => node_path.default.join(cartridgesDir, entry.name)).sort((left, right) => left.localeCompare(right));
+	if (fromReferences.length === 0) return fromFilesystem;
+	const seen = new Set(fromReferences);
+	for (const cartridgeRoot of fromFilesystem) if (!seen.has(cartridgeRoot)) {
+		fromReferences.push(cartridgeRoot);
+		seen.add(cartridgeRoot);
+	}
+	return fromReferences;
+}
+function findContainingCartridgeRoot(filePath, cartridgeRoots) {
+	const normalizedPath = node_path.default.resolve(filePath);
+	return cartridgeRoots.find((cartridgeRoot) => normalizedPath.startsWith(`${cartridgeRoot}${node_path.default.sep}`));
+}
+function stripExt(filePath) {
+	return filePath.replace(/\.[^.]+$/u, "");
+}
+function toPosixPath(filePath) {
+	return filePath.split(node_path.default.sep).join("/");
+}
+function resolveCandidateFile(basePath, moduleName) {
+	const candidates = [];
+	const extension = node_path.default.extname(basePath);
+	if (extension) {
+		candidates.push(basePath);
+		if (extension === ".ds") candidates.push(`${basePath.slice(0, -3)}.js`);
+	} else {
+		candidates.push(basePath);
+		for (const runtimeExt of SUPPORTED_RUNTIME_EXTENSIONS) candidates.push(`${basePath}.${runtimeExt}`);
+		candidates.push(`${basePath}.d.ts`);
+		for (const runtimeExt of SUPPORTED_RUNTIME_EXTENSIONS) candidates.push(node_path.default.join(basePath, `index.${runtimeExt}`));
+		candidates.push(node_path.default.join(basePath, "index.d.ts"));
+		if (moduleName.endsWith(".ds")) candidates.push(`${basePath.slice(0, -3)}.js`);
+	}
+	for (const candidate of candidates) if (node_fs.default.existsSync(candidate) && node_fs.default.statSync(candidate).isFile()) return candidate;
+}
+function createSfccPaths(configPath, cartridgeRoots) {
+	const configDir = node_path.default.dirname(configPath);
+	const paths = {
+		"dw/*": ["../../node_modules/sfcc-dts/@types/sfcc/dw/*"],
+		"~/*": ["./*"]
+	};
+	for (const cartridgeRoot of cartridgeRoots) {
+		const alias = node_path.default.basename(cartridgeRoot);
+		const relative = node_path.default.relative(configDir, cartridgeRoot).replaceAll("\\", "/");
+		paths[`${alias}/*`] = [relative ? `${relative}/*` : "./*"];
+	}
+	const modulesRoot = cartridgeRoots.find((cartridgeRoot) => node_path.default.basename(cartridgeRoot) === "modules");
+	if (modulesRoot) {
+		const base = node_path.default.relative(configDir, modulesRoot).replaceAll("\\", "/") || ".";
+		paths.server = [`${base}/server`];
+		paths["server/*"] = [`${base}/server/*`];
+	}
+	const intNapaliRoot = cartridgeRoots.find((cartridgeRoot) => node_path.default.basename(cartridgeRoot) === "int_napali");
+	if (intNapaliRoot) {
+		const relative = node_path.default.relative(configDir, intNapaliRoot).replaceAll("\\", "/");
+		paths["bc_napali/*"] = [relative ? `${relative}/*` : "./*"];
+	}
+	return paths;
+}
+function createSfccModuleResolver(cartridgeRoots) {
+	const byAlias = new Map(cartridgeRoots.map((rootPath) => [node_path.default.basename(rootPath), rootPath]));
+	const modulesRoot = byAlias.get("modules");
+	return function resolveSfccModule(moduleName, containingFile) {
+		const containingCartridgeRoot = findContainingCartridgeRoot(containingFile, cartridgeRoots);
+		if (moduleName === "server" && modulesRoot) return resolveCandidateFile(node_path.default.join(modulesRoot, "server"), moduleName);
+		if (moduleName.startsWith("server/") && modulesRoot) return resolveCandidateFile(node_path.default.join(modulesRoot, moduleName), moduleName);
+		if (moduleName.startsWith("~/")) {
+			if (!containingCartridgeRoot) return;
+			return resolveCandidateFile(node_path.default.join(containingCartridgeRoot, moduleName.slice(2)), moduleName);
+		}
+		if (moduleName.startsWith("*/")) {
+			const relativeToCartridge = moduleName.slice(2);
+			if (!relativeToCartridge) return;
+			for (const cartridgeRoot of cartridgeRoots) {
+				const resolved = resolveCandidateFile(node_path.default.join(cartridgeRoot, relativeToCartridge), moduleName);
+				if (resolved) return resolved;
+			}
+		}
+		const aliasMatch = /^([A-Za-z0-9_-]+)\/(cartridge\/.*)$/u.exec(moduleName);
+		if (aliasMatch) {
+			const cartridgeRoot = byAlias.get(aliasMatch[1]);
+			if (!cartridgeRoot) return;
+			return resolveCandidateFile(node_path.default.join(cartridgeRoot, aliasMatch[2]), moduleName);
+		}
+	};
+}
+function resolveSuperModuleSpecifier(filePath, cartridgeRoots) {
+	const containingCartridgeRoot = findContainingCartridgeRoot(filePath, cartridgeRoots);
+	if (!containingCartridgeRoot) return;
+	const relativeModulePath = stripExt(node_path.default.relative(containingCartridgeRoot, filePath));
+	const ownCartridgeName = node_path.default.basename(containingCartridgeRoot);
+	const ownCartridgeIndex = cartridgeRoots.findIndex((cartridgeRoot) => node_path.default.basename(cartridgeRoot) === ownCartridgeName);
+	if (ownCartridgeIndex === -1) return;
+	const nextCartridges = cartridgeRoots.slice(ownCartridgeIndex + 1);
+	for (const nextCartridgeRoot of nextCartridges) {
+		if (!resolveCandidateFile(node_path.default.join(nextCartridgeRoot, relativeModulePath), relativeModulePath)) continue;
+		return `${node_path.default.basename(nextCartridgeRoot)}/${toPosixPath(relativeModulePath)}`;
+	}
+}
+function injectTopLevelStatement(sourceCode, statement) {
+	if (sourceCode.startsWith("#!")) {
+		const firstNewline = sourceCode.indexOf("\n");
+		if (firstNewline === -1) return `${sourceCode}\n${statement}\n`;
+		return `${sourceCode.slice(0, firstNewline + 1)}${injectTopLevelStatement(sourceCode.slice(firstNewline + 1), statement)}`;
+	}
+	const useStrictMatch = sourceCode.match(/^(\s*['"]use strict['"];?\s*\r?\n)/u);
+	if (useStrictMatch) return `${useStrictMatch[1]}${statement}\n${sourceCode.slice(useStrictMatch[1].length)}`;
+	return `${statement}\n${sourceCode}`;
+}
+function transformSuperModuleSource(sourceCode, filePath, cartridgeRoots) {
+	if (!sourceCode.includes("module.superModule")) return sourceCode;
+	const superModuleSpecifier = resolveSuperModuleSpecifier(filePath, cartridgeRoots);
+	if (!superModuleSpecifier) return sourceCode.replaceAll(/\bmodule\.superModule\b/gu, "undefined");
+	return injectTopLevelStatement(sourceCode.replaceAll(/\bmodule\.superModule\b/gu, SUPER_MODULE_TOKEN), `const ${SUPER_MODULE_TOKEN} = require(${JSON.stringify(superModuleSpecifier)});`);
+}
+var SUPPORTED_RUNTIME_EXTENSIONS, SUPER_MODULE_TOKEN;
+var init_shared = __esmMin((() => {
+	SUPPORTED_RUNTIME_EXTENSIONS = [
+		"js",
+		"ds",
+		"json"
+	];
+	SUPER_MODULE_TOKEN = "__sfcc_superModule__";
+}));
+//#endregion
+Object.defineProperty(exports, "SUPER_MODULE_TOKEN", {
+	enumerable: true,
+	get: function() {
+		return SUPER_MODULE_TOKEN;
+	}
+});
+Object.defineProperty(exports, "SUPPORTED_RUNTIME_EXTENSIONS", {
+	enumerable: true,
+	get: function() {
+		return SUPPORTED_RUNTIME_EXTENSIONS;
+	}
+});
+Object.defineProperty(exports, "__toCommonJS", {
+	enumerable: true,
+	get: function() {
+		return __toCommonJS;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "createSfccModuleResolver", {
+	enumerable: true,
+	get: function() {
+		return createSfccModuleResolver;
+	}
+});
+Object.defineProperty(exports, "createSfccPaths", {
+	enumerable: true,
+	get: function() {
+		return createSfccPaths;
+	}
+});
+Object.defineProperty(exports, "findCartridgesDir", {
+	enumerable: true,
+	get: function() {
+		return findCartridgesDir;
+	}
+});
+Object.defineProperty(exports, "findContainingCartridgeRoot", {
+	enumerable: true,
+	get: function() {
+		return findContainingCartridgeRoot;
+	}
+});
+Object.defineProperty(exports, "inferCartridgeOrder", {
+	enumerable: true,
+	get: function() {
+		return inferCartridgeOrder;
+	}
+});
+Object.defineProperty(exports, "init_shared", {
+	enumerable: true,
+	get: function() {
+		return init_shared;
+	}
+});
+Object.defineProperty(exports, "injectTopLevelStatement", {
+	enumerable: true,
+	get: function() {
+		return injectTopLevelStatement;
+	}
+});
+Object.defineProperty(exports, "readSolutionReferences", {
+	enumerable: true,
+	get: function() {
+		return readSolutionReferences;
+	}
+});
+Object.defineProperty(exports, "resolveCandidateFile", {
+	enumerable: true,
+	get: function() {
+		return resolveCandidateFile;
+	}
+});
+Object.defineProperty(exports, "resolveSuperModuleSpecifier", {
+	enumerable: true,
+	get: function() {
+		return resolveSuperModuleSpecifier;
+	}
+});
+Object.defineProperty(exports, "shared_exports", {
+	enumerable: true,
+	get: function() {
+		return shared_exports;
+	}
+});
+Object.defineProperty(exports, "stripExt", {
+	enumerable: true,
+	get: function() {
+		return stripExt;
+	}
+});
+Object.defineProperty(exports, "toPosixPath", {
+	enumerable: true,
+	get: function() {
+		return toPosixPath;
+	}
+});
+Object.defineProperty(exports, "transformSuperModuleSource", {
+	enumerable: true,
+	get: function() {
+		return transformSuperModuleSource;
+	}
+});

package/dist/tsserver-plugin.cjs

@@ -0,0 +1,56 @@
+const require_shared = require("./shared-tI7NsvoF.cjs");
+//#region src/tsserver-plugin.cts
+const { createSfccModuleResolver, findCartridgesDir, inferCartridgeOrder, transformSuperModuleSource } = (require_shared.init_shared(), require_shared.__toCommonJS(require_shared.shared_exports));
+function init(modules) {
+	const ts = modules.typescript;
+	function create(info) {
+		const cartridgesDir = findCartridgesDir(info.project.getCurrentDirectory());
+		const cartridgeRoots = cartridgesDir ? inferCartridgeOrder(cartridgesDir) : [];
+		const resolveSfccModule = createSfccModuleResolver(cartridgeRoots);
+		const host = info.languageServiceHost;
+		const compilerOptions = info.project.getCompilationSettings();
+		const originalGetScriptSnapshot = host.getScriptSnapshot?.bind(host);
+		const originalResolveModuleNames = host.resolveModuleNames?.bind(host);
+		const originalResolveModuleNameLiterals = host.resolveModuleNameLiterals?.bind(host);
+		host.getScriptSnapshot = (fileName) => {
+			const snapshot = originalGetScriptSnapshot?.(fileName);
+			if (!snapshot || !fileName.endsWith(".js") || cartridgeRoots.length === 0) return snapshot;
+			const sourceCode = snapshot.getText(0, snapshot.getLength());
+			const transformedSource = transformSuperModuleSource(sourceCode, fileName, cartridgeRoots);
+			if (transformedSource === sourceCode) return snapshot;
+			return ts.ScriptSnapshot.fromString(transformedSource);
+		};
+		host.resolveModuleNames = (moduleNames, containingFile, reusedNames, redirectedReference) => {
+			const defaultResolved = originalResolveModuleNames ? originalResolveModuleNames(moduleNames, containingFile, reusedNames, redirectedReference) : moduleNames.map((moduleName) => ts.resolveModuleName(moduleName, containingFile, compilerOptions, ts.sys).resolvedModule);
+			return moduleNames.map((moduleName, index) => {
+				const sfccResolved = resolveSfccModule(moduleName, containingFile);
+				if (sfccResolved) return toResolvedModule(sfccResolved);
+				return defaultResolved[index];
+			});
+		};
+		host.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options, containingSourceFile, reusedNames) => {
+			const defaultResolved = originalResolveModuleNameLiterals ? originalResolveModuleNameLiterals(moduleLiterals, containingFile, redirectedReference, options, containingSourceFile, reusedNames) : moduleLiterals.map((literal) => ({ resolvedModule: ts.resolveModuleName(literal.text, containingFile, compilerOptions, ts.sys).resolvedModule }));
+			return moduleLiterals.map((literal, index) => {
+				const sfccResolved = resolveSfccModule(literal.text, containingFile);
+				if (sfccResolved) return { resolvedModule: toResolvedModule(sfccResolved) };
+				return defaultResolved[index];
+			});
+		};
+		return info.languageService;
+	}
+	function toResolvedModule(filePath) {
+		let extension = ts.Extension.Js;
+		if (filePath.endsWith(".d.ts")) extension = ts.Extension.Dts;
+		else if (filePath.endsWith(".ts")) extension = ts.Extension.Ts;
+		else if (filePath.endsWith(".tsx")) extension = ts.Extension.Tsx;
+		else if (filePath.endsWith(".jsx")) extension = ts.Extension.Jsx;
+		return {
+			resolvedFileName: filePath,
+			extension,
+			isExternalLibraryImport: false
+		};
+	}
+	return { create };
+}
+module.exports = init;
+//#endregion

package/dist/tsserver-plugin.d.cts

@@ -0,0 +1,18 @@
+//#region src/tsserver-plugin.d.cts
+declare function init(modules: {
+  typescript: typeof import("typescript");
+}): {
+  create: (info: {
+    project: {
+      getCurrentDirectory(): string;
+      getCompilationSettings(): import("typescript").CompilerOptions;
+    };
+    languageServiceHost: {
+      getScriptSnapshot?(fileName: string): import("typescript").IScriptSnapshot | undefined;
+      resolveModuleNames?(moduleNames: string[], containingFile: string, reusedNames?: string[], redirectedReference?: import("typescript").ResolvedProjectReference): Array<import("typescript").ResolvedModule | undefined>;
+      resolveModuleNameLiterals?(moduleLiterals: ReadonlyArray<import("typescript").StringLiteralLike>, containingFile: string, redirectedReference: import("typescript").ResolvedProjectReference | undefined, options: import("typescript").CompilerOptions, containingSourceFile: import("typescript").SourceFile | undefined, reusedNames: string[] | undefined): import("typescript").ResolvedModuleWithFailedLookupLocations[];
+    };
+    languageService: unknown;
+  }) => unknown;
+};
+export = init;

package/dist/tsserver-plugin.d.mts

@@ -0,0 +1,19 @@
+//#region src/tsserver-plugin.d.cts
+declare function init(modules: {
+  typescript: typeof import("typescript");
+}): {
+  create: (info: {
+    project: {
+      getCurrentDirectory(): string;
+      getCompilationSettings(): import("typescript").CompilerOptions;
+    };
+    languageServiceHost: {
+      getScriptSnapshot?(fileName: string): import("typescript").IScriptSnapshot | undefined;
+      resolveModuleNames?(moduleNames: string[], containingFile: string, reusedNames?: string[], redirectedReference?: import("typescript").ResolvedProjectReference): Array<import("typescript").ResolvedModule | undefined>;
+      resolveModuleNameLiterals?(moduleLiterals: ReadonlyArray<import("typescript").StringLiteralLike>, containingFile: string, redirectedReference: import("typescript").ResolvedProjectReference | undefined, options: import("typescript").CompilerOptions, containingSourceFile: import("typescript").SourceFile | undefined, reusedNames: string[] | undefined): import("typescript").ResolvedModuleWithFailedLookupLocations[];
+    };
+    languageService: unknown;
+  }) => unknown;
+};
+//#endregion
+export { init as default };

package/dist/tsserver-plugin.mjs

@@ -0,0 +1,60 @@
+import { _ as __commonJSMin, c as init_shared, p as shared_exports, v as __toCommonJS } from "./shared-j82Y0_wL.mjs";
+//#region src/tsserver-plugin.cts
+var require_tsserver_plugin = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	const { createSfccModuleResolver, findCartridgesDir, inferCartridgeOrder, transformSuperModuleSource } = (init_shared(), __toCommonJS(shared_exports));
+	function init(modules) {
+		const ts = modules.typescript;
+		function create(info) {
+			const cartridgesDir = findCartridgesDir(info.project.getCurrentDirectory());
+			const cartridgeRoots = cartridgesDir ? inferCartridgeOrder(cartridgesDir) : [];
+			const resolveSfccModule = createSfccModuleResolver(cartridgeRoots);
+			const host = info.languageServiceHost;
+			const compilerOptions = info.project.getCompilationSettings();
+			const originalGetScriptSnapshot = host.getScriptSnapshot?.bind(host);
+			const originalResolveModuleNames = host.resolveModuleNames?.bind(host);
+			const originalResolveModuleNameLiterals = host.resolveModuleNameLiterals?.bind(host);
+			host.getScriptSnapshot = (fileName) => {
+				const snapshot = originalGetScriptSnapshot?.(fileName);
+				if (!snapshot || !fileName.endsWith(".js") || cartridgeRoots.length === 0) return snapshot;
+				const sourceCode = snapshot.getText(0, snapshot.getLength());
+				const transformedSource = transformSuperModuleSource(sourceCode, fileName, cartridgeRoots);
+				if (transformedSource === sourceCode) return snapshot;
+				return ts.ScriptSnapshot.fromString(transformedSource);
+			};
+			host.resolveModuleNames = (moduleNames, containingFile, reusedNames, redirectedReference) => {
+				const defaultResolved = originalResolveModuleNames ? originalResolveModuleNames(moduleNames, containingFile, reusedNames, redirectedReference) : moduleNames.map((moduleName) => ts.resolveModuleName(moduleName, containingFile, compilerOptions, ts.sys).resolvedModule);
+				return moduleNames.map((moduleName, index) => {
+					const sfccResolved = resolveSfccModule(moduleName, containingFile);
+					if (sfccResolved) return toResolvedModule(sfccResolved);
+					return defaultResolved[index];
+				});
+			};
+			host.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options, containingSourceFile, reusedNames) => {
+				const defaultResolved = originalResolveModuleNameLiterals ? originalResolveModuleNameLiterals(moduleLiterals, containingFile, redirectedReference, options, containingSourceFile, reusedNames) : moduleLiterals.map((literal) => ({ resolvedModule: ts.resolveModuleName(literal.text, containingFile, compilerOptions, ts.sys).resolvedModule }));
+				return moduleLiterals.map((literal, index) => {
+					const sfccResolved = resolveSfccModule(literal.text, containingFile);
+					if (sfccResolved) return { resolvedModule: toResolvedModule(sfccResolved) };
+					return defaultResolved[index];
+				});
+			};
+			return info.languageService;
+		}
+		function toResolvedModule(filePath) {
+			let extension = ts.Extension.Js;
+			if (filePath.endsWith(".d.ts")) extension = ts.Extension.Dts;
+			else if (filePath.endsWith(".ts")) extension = ts.Extension.Ts;
+			else if (filePath.endsWith(".tsx")) extension = ts.Extension.Tsx;
+			else if (filePath.endsWith(".jsx")) extension = ts.Extension.Jsx;
+			return {
+				resolvedFileName: filePath,
+				extension,
+				isExternalLibraryImport: false
+			};
+		}
+		return { create };
+	}
+	module.exports = init;
+}));
+//#endregion
+export default require_tsserver_plugin();
+export {};

package/dist/typecheck-cartridges.cjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./shared-tI7NsvoF.cjs");
+const require_typecheck = require("./typecheck.cjs");
+let node_path = require("node:path");
+node_path = require_shared.__toESM(node_path, 1);
+let node_url = require("node:url");
+//#region src/typecheck-cartridges.ts
+function runCli(args, options = {}) {
+	const currentDirectory = options.currentDirectory ?? process.cwd();
+	const writeStdout = options.writeStdout ?? ((text) => process.stdout.write(text));
+	const { solutionConfigPath, cartridgesDir } = parseArguments(args, currentDirectory);
+	const diagnostics = require_typecheck.typecheckSolutionProjects({
+		solutionConfigPath,
+		cartridgesDir
+	});
+	const formatted = require_typecheck.formatDiagnostics(diagnostics, currentDirectory);
+	if (formatted) writeStdout(formatted);
+	return diagnostics.length > 0 ? 2 : 0;
+}
+function parseArguments(args, currentDirectory) {
+	let solutionConfigPath = node_path.default.resolve(currentDirectory, "cartridges", "jsconfig.json");
+	let cartridgesDir;
+	for (let index = 0; index < args.length; index += 1) {
+		const arg = args[index];
+		if ((arg === "--project" || arg === "-p") && args[index + 1]) {
+			solutionConfigPath = node_path.default.resolve(currentDirectory, args[index + 1]);
+			index += 1;
+			continue;
+		}
+		if (arg === "--cartridges-dir" && args[index + 1]) {
+			cartridgesDir = node_path.default.resolve(currentDirectory, args[index + 1]);
+			index += 1;
+		}
+	}
+	return {
+		solutionConfigPath,
+		cartridgesDir
+	};
+}
+function main(args = process.argv.slice(2), options = {}) {
+	const writeStderr = options.writeStderr ?? ((text) => process.stderr.write(text));
+	try {
+		return runCli(args, options);
+	} catch (error) {
+		writeStderr(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+		return 1;
+	}
+}
+function isDirectExecution() {
+	const executedPath = process.argv[1];
+	if (!executedPath) return false;
+	return node_path.default.resolve(executedPath) === node_path.default.resolve((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+}
+if (isDirectExecution()) process.exit(main());
+//#endregion
+exports.main = main;
+exports.parseArguments = parseArguments;
+exports.runCli = runCli;

package/dist/typecheck-cartridges.d.cts

@@ -0,0 +1,14 @@
+//#region src/typecheck-cartridges.d.ts
+interface CliRunOptions {
+  currentDirectory?: string;
+  writeStdout?: (text: string) => void;
+  writeStderr?: (text: string) => void;
+}
+declare function runCli(args: string[], options?: CliRunOptions): number;
+declare function parseArguments(args: string[], currentDirectory: string): {
+  solutionConfigPath: string;
+  cartridgesDir?: string;
+};
+declare function main(args?: string[], options?: CliRunOptions): number;
+//#endregion
+export { CliRunOptions, main, parseArguments, runCli };

package/dist/typecheck-cartridges.d.mts

@@ -0,0 +1,14 @@
+//#region src/typecheck-cartridges.d.ts
+interface CliRunOptions {
+  currentDirectory?: string;
+  writeStdout?: (text: string) => void;
+  writeStderr?: (text: string) => void;
+}
+declare function runCli(args: string[], options?: CliRunOptions): number;
+declare function parseArguments(args: string[], currentDirectory: string): {
+  solutionConfigPath: string;
+  cartridgesDir?: string;
+};
+declare function main(args?: string[], options?: CliRunOptions): number;
+//#endregion
+export { CliRunOptions, main, parseArguments, runCli };

package/dist/typecheck-cartridges.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { formatDiagnostics, typecheckSolutionProjects } from "./typecheck.mjs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/typecheck-cartridges.ts
+function runCli(args, options = {}) {
+	const currentDirectory = options.currentDirectory ?? process.cwd();
+	const writeStdout = options.writeStdout ?? ((text) => process.stdout.write(text));
+	const { solutionConfigPath, cartridgesDir } = parseArguments(args, currentDirectory);
+	const diagnostics = typecheckSolutionProjects({
+		solutionConfigPath,
+		cartridgesDir
+	});
+	const formatted = formatDiagnostics(diagnostics, currentDirectory);
+	if (formatted) writeStdout(formatted);
+	return diagnostics.length > 0 ? 2 : 0;
+}
+function parseArguments(args, currentDirectory) {
+	let solutionConfigPath = path.resolve(currentDirectory, "cartridges", "jsconfig.json");
+	let cartridgesDir;
+	for (let index = 0; index < args.length; index += 1) {
+		const arg = args[index];
+		if ((arg === "--project" || arg === "-p") && args[index + 1]) {
+			solutionConfigPath = path.resolve(currentDirectory, args[index + 1]);
+			index += 1;
+			continue;
+		}
+		if (arg === "--cartridges-dir" && args[index + 1]) {
+			cartridgesDir = path.resolve(currentDirectory, args[index + 1]);
+			index += 1;
+		}
+	}
+	return {
+		solutionConfigPath,
+		cartridgesDir
+	};
+}
+function main(args = process.argv.slice(2), options = {}) {
+	const writeStderr = options.writeStderr ?? ((text) => process.stderr.write(text));
+	try {
+		return runCli(args, options);
+	} catch (error) {
+		writeStderr(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+		return 1;
+	}
+}
+function isDirectExecution() {
+	const executedPath = process.argv[1];
+	if (!executedPath) return false;
+	return path.resolve(executedPath) === path.resolve(fileURLToPath(import.meta.url));
+}
+if (isDirectExecution()) process.exit(main());
+//#endregion
+export { main, parseArguments, runCli };

package/dist/typecheck.cjs

@@ -0,0 +1,95 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared = require("./shared-tI7NsvoF.cjs");
+let node_path = require("node:path");
+node_path = require_shared.__toESM(node_path, 1);
+let typescript = require("typescript");
+typescript = require_shared.__toESM(typescript, 1);
+//#region src/typecheck.ts
+require_shared.init_shared();
+function createFormatHost(currentDirectory) {
+	return {
+		getCanonicalFileName: (fileName) => fileName,
+		getCurrentDirectory: () => currentDirectory,
+		getNewLine: () => typescript.default.sys.newLine
+	};
+}
+function parseConfigFile(configPath, currentDirectory) {
+	const configParseHost = {
+		...typescript.default.sys,
+		onUnRecoverableConfigFileDiagnostic: (diagnostic) => {
+			throw new Error(typescript.default.formatDiagnosticsWithColorAndContext([diagnostic], createFormatHost(currentDirectory)));
+		}
+	};
+	const parsedConfig = typescript.default.getParsedCommandLineOfConfigFile(configPath, {}, configParseHost);
+	if (!parsedConfig) throw new Error(`Could not parse TypeScript config at ${configPath}`);
+	return parsedConfig;
+}
+function runProjectTypecheck(configPath, cartridgeRoots, currentDirectory) {
+	const parsedConfig = parseConfigFile(configPath, currentDirectory);
+	parsedConfig.options.paths = require_shared.createSfccPaths(configPath, cartridgeRoots);
+	const configFilePath = parsedConfig.options.configFilePath;
+	const moduleResolutionCache = typescript.default.createModuleResolutionCache(typeof configFilePath === "string" ? node_path.default.dirname(configFilePath) : currentDirectory, (fileName) => fileName, parsedConfig.options);
+	const host = typescript.default.createCompilerHost(parsedConfig.options, true);
+	const resolveSfccModule = require_shared.createSfccModuleResolver(cartridgeRoots);
+	const hostReadFile = host.readFile?.bind(host);
+	const originalReadFile = hostReadFile ? (fileName) => hostReadFile(fileName) : (fileName) => typescript.default.sys.readFile(fileName);
+	host.readFile = (fileName) => {
+		const fileContent = originalReadFile(fileName);
+		if (typeof fileContent !== "string" || !fileName.endsWith(".js")) return fileContent;
+		return require_shared.transformSuperModuleSource(fileContent, fileName, cartridgeRoots);
+	};
+	host.resolveModuleNames = (moduleNames, containingFile, _reusedNames, redirectedReference, options) => {
+		return moduleNames.map((moduleName) => {
+			const sfccResolved = resolveSfccModule(moduleName, containingFile);
+			if (sfccResolved) return {
+				resolvedFileName: sfccResolved,
+				extension: pathToExtension(sfccResolved),
+				isExternalLibraryImport: false
+			};
+			return typescript.default.resolveModuleName(moduleName, containingFile, options ?? parsedConfig.options, host, moduleResolutionCache, redirectedReference).resolvedModule;
+		});
+	};
+	host.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options, _containingSourceFile, _reusedNames) => {
+		return moduleLiterals.map((literal) => {
+			const moduleName = typeof literal === "string" ? literal : literal.text;
+			const sfccResolved = resolveSfccModule(moduleName, containingFile);
+			if (sfccResolved) return { resolvedModule: {
+				resolvedFileName: sfccResolved,
+				extension: pathToExtension(sfccResolved),
+				isExternalLibraryImport: false
+			} };
+			return { resolvedModule: typescript.default.resolveModuleName(moduleName, containingFile, options ?? parsedConfig.options, host, moduleResolutionCache, redirectedReference).resolvedModule };
+		});
+	};
+	const program = typescript.default.createProgram({
+		options: parsedConfig.options,
+		rootNames: parsedConfig.fileNames,
+		projectReferences: parsedConfig.projectReferences,
+		host
+	});
+	return typescript.default.getPreEmitDiagnostics(program);
+}
+function typecheckSolutionProjects({ solutionConfigPath, cartridgesDir }) {
+	const resolvedSolutionConfigPath = node_path.default.resolve(solutionConfigPath);
+	const resolvedCartridgesDir = cartridgesDir ? node_path.default.resolve(cartridgesDir) : node_path.default.dirname(resolvedSolutionConfigPath);
+	const configPaths = require_shared.readSolutionReferences(resolvedSolutionConfigPath);
+	const cartridgeRoots = require_shared.inferCartridgeOrder(resolvedCartridgesDir, resolvedSolutionConfigPath);
+	const currentDirectory = node_path.default.dirname(resolvedCartridgesDir);
+	return configPaths.flatMap((configPath) => runProjectTypecheck(configPath, cartridgeRoots, currentDirectory));
+}
+function formatDiagnostics(diagnostics, currentDirectory) {
+	return typescript.default.formatDiagnosticsWithColorAndContext(diagnostics, createFormatHost(currentDirectory));
+}
+function pathToExtension(filePath) {
+	if (filePath.endsWith(".d.ts")) return typescript.default.Extension.Dts;
+	if (filePath.endsWith(".tsx")) return typescript.default.Extension.Tsx;
+	if (filePath.endsWith(".ts")) return typescript.default.Extension.Ts;
+	if (filePath.endsWith(".jsx")) return typescript.default.Extension.Jsx;
+	return typescript.default.Extension.Js;
+}
+//#endregion
+exports.createFormatHost = createFormatHost;
+exports.formatDiagnostics = formatDiagnostics;
+exports.parseConfigFile = parseConfigFile;
+exports.runProjectTypecheck = runProjectTypecheck;
+exports.typecheckSolutionProjects = typecheckSolutionProjects;

package/dist/typecheck.d.cts

@@ -0,0 +1,17 @@
+import ts from "typescript";
+
+//#region src/typecheck.d.ts
+interface TypecheckOptions {
+  solutionConfigPath: string;
+  cartridgesDir?: string;
+}
+declare function createFormatHost(currentDirectory: string): ts.FormatDiagnosticsHost;
+declare function parseConfigFile(configPath: string, currentDirectory: string): ts.ParsedCommandLine;
+declare function runProjectTypecheck(configPath: string, cartridgeRoots: string[], currentDirectory: string): readonly ts.Diagnostic[];
+declare function typecheckSolutionProjects({
+  solutionConfigPath,
+  cartridgesDir
+}: TypecheckOptions): ts.Diagnostic[];
+declare function formatDiagnostics(diagnostics: ts.Diagnostic[], currentDirectory: string): string;
+//#endregion
+export { TypecheckOptions, createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects };

package/dist/typecheck.d.mts

@@ -0,0 +1,17 @@
+import ts from "typescript";
+
+//#region src/typecheck.d.ts
+interface TypecheckOptions {
+  solutionConfigPath: string;
+  cartridgesDir?: string;
+}
+declare function createFormatHost(currentDirectory: string): ts.FormatDiagnosticsHost;
+declare function parseConfigFile(configPath: string, currentDirectory: string): ts.ParsedCommandLine;
+declare function runProjectTypecheck(configPath: string, cartridgeRoots: string[], currentDirectory: string): readonly ts.Diagnostic[];
+declare function typecheckSolutionProjects({
+  solutionConfigPath,
+  cartridgesDir
+}: TypecheckOptions): ts.Diagnostic[];
+declare function formatDiagnostics(diagnostics: ts.Diagnostic[], currentDirectory: string): string;
+//#endregion
+export { TypecheckOptions, createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects };

package/dist/typecheck.mjs

@@ -0,0 +1,88 @@
+import { c as init_shared, g as transformSuperModuleSource, i as createSfccPaths, r as createSfccModuleResolver, s as inferCartridgeOrder, u as readSolutionReferences } from "./shared-j82Y0_wL.mjs";
+import path from "node:path";
+import ts from "typescript";
+//#region src/typecheck.ts
+init_shared();
+function createFormatHost(currentDirectory) {
+	return {
+		getCanonicalFileName: (fileName) => fileName,
+		getCurrentDirectory: () => currentDirectory,
+		getNewLine: () => ts.sys.newLine
+	};
+}
+function parseConfigFile(configPath, currentDirectory) {
+	const configParseHost = {
+		...ts.sys,
+		onUnRecoverableConfigFileDiagnostic: (diagnostic) => {
+			throw new Error(ts.formatDiagnosticsWithColorAndContext([diagnostic], createFormatHost(currentDirectory)));
+		}
+	};
+	const parsedConfig = ts.getParsedCommandLineOfConfigFile(configPath, {}, configParseHost);
+	if (!parsedConfig) throw new Error(`Could not parse TypeScript config at ${configPath}`);
+	return parsedConfig;
+}
+function runProjectTypecheck(configPath, cartridgeRoots, currentDirectory) {
+	const parsedConfig = parseConfigFile(configPath, currentDirectory);
+	parsedConfig.options.paths = createSfccPaths(configPath, cartridgeRoots);
+	const configFilePath = parsedConfig.options.configFilePath;
+	const moduleResolutionCache = ts.createModuleResolutionCache(typeof configFilePath === "string" ? path.dirname(configFilePath) : currentDirectory, (fileName) => fileName, parsedConfig.options);
+	const host = ts.createCompilerHost(parsedConfig.options, true);
+	const resolveSfccModule = createSfccModuleResolver(cartridgeRoots);
+	const hostReadFile = host.readFile?.bind(host);
+	const originalReadFile = hostReadFile ? (fileName) => hostReadFile(fileName) : (fileName) => ts.sys.readFile(fileName);
+	host.readFile = (fileName) => {
+		const fileContent = originalReadFile(fileName);
+		if (typeof fileContent !== "string" || !fileName.endsWith(".js")) return fileContent;
+		return transformSuperModuleSource(fileContent, fileName, cartridgeRoots);
+	};
+	host.resolveModuleNames = (moduleNames, containingFile, _reusedNames, redirectedReference, options) => {
+		return moduleNames.map((moduleName) => {
+			const sfccResolved = resolveSfccModule(moduleName, containingFile);
+			if (sfccResolved) return {
+				resolvedFileName: sfccResolved,
+				extension: pathToExtension(sfccResolved),
+				isExternalLibraryImport: false
+			};
+			return ts.resolveModuleName(moduleName, containingFile, options ?? parsedConfig.options, host, moduleResolutionCache, redirectedReference).resolvedModule;
+		});
+	};
+	host.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options, _containingSourceFile, _reusedNames) => {
+		return moduleLiterals.map((literal) => {
+			const moduleName = typeof literal === "string" ? literal : literal.text;
+			const sfccResolved = resolveSfccModule(moduleName, containingFile);
+			if (sfccResolved) return { resolvedModule: {
+				resolvedFileName: sfccResolved,
+				extension: pathToExtension(sfccResolved),
+				isExternalLibraryImport: false
+			} };
+			return { resolvedModule: ts.resolveModuleName(moduleName, containingFile, options ?? parsedConfig.options, host, moduleResolutionCache, redirectedReference).resolvedModule };
+		});
+	};
+	const program = ts.createProgram({
+		options: parsedConfig.options,
+		rootNames: parsedConfig.fileNames,
+		projectReferences: parsedConfig.projectReferences,
+		host
+	});
+	return ts.getPreEmitDiagnostics(program);
+}
+function typecheckSolutionProjects({ solutionConfigPath, cartridgesDir }) {
+	const resolvedSolutionConfigPath = path.resolve(solutionConfigPath);
+	const resolvedCartridgesDir = cartridgesDir ? path.resolve(cartridgesDir) : path.dirname(resolvedSolutionConfigPath);
+	const configPaths = readSolutionReferences(resolvedSolutionConfigPath);
+	const cartridgeRoots = inferCartridgeOrder(resolvedCartridgesDir, resolvedSolutionConfigPath);
+	const currentDirectory = path.dirname(resolvedCartridgesDir);
+	return configPaths.flatMap((configPath) => runProjectTypecheck(configPath, cartridgeRoots, currentDirectory));
+}
+function formatDiagnostics(diagnostics, currentDirectory) {
+	return ts.formatDiagnosticsWithColorAndContext(diagnostics, createFormatHost(currentDirectory));
+}
+function pathToExtension(filePath) {
+	if (filePath.endsWith(".d.ts")) return ts.Extension.Dts;
+	if (filePath.endsWith(".tsx")) return ts.Extension.Tsx;
+	if (filePath.endsWith(".ts")) return ts.Extension.Ts;
+	if (filePath.endsWith(".jsx")) return ts.Extension.Jsx;
+	return ts.Extension.Js;
+}
+//#endregion
+export { createFormatHost, formatDiagnostics, parseConfigFile, runProjectTypecheck, typecheckSolutionProjects };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@commerce-klaus/typescript-sfcc",
+  "version": "0.0.0",
+  "description": "TypeScript tooling for Salesforce Commerce Cloud cartridge projects",
+  "keywords": [
+    "commercecloud",
+    "demandware",
+    "salesforce",
+    "sfcc",
+    "tsserver",
+    "typescript"
+  ],
+  "homepage": "https://github.com/commerce-klaus/commerce-klaus/tree/main/packages/sfcc-ts-tooling#readme",
+  "bugs": {
+    "url": "https://github.com/commerce-klaus/commerce-klaus/issues"
+  },
+  "license": "MIT",
+  "author": "Jens Simon <https://github.com/jenssimon>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/commerce-klaus/commerce-klaus",
+    "directory": "packages/sfcc-ts-tooling"
+  },
+  "bin": {
+    "sfcc-ts-typecheck": "./dist/typecheck-cartridges.cjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/tsserver-plugin.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/tsserver-plugin.cjs"
+    },
+    "./tsserver-plugin": {
+      "types": "./dist/tsserver-plugin.d.cts",
+      "import": "./dist/tsserver-plugin.mjs",
+      "require": "./dist/tsserver-plugin.cjs"
+    },
+    "./typecheck": {
+      "types": "./dist/typecheck.d.mts",
+      "import": "./dist/typecheck.mjs",
+      "require": "./dist/typecheck.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "test": "vp test",
+    "check": "vp check",
+    "prepublishOnly": "vp run build"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "typescript": "catalog:",
+    "vite-plus": "catalog:"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.5.0"
+  },
+  "packageManager": "pnpm@11.9.0"
+}