@servicetitan/startup-utils 27.4.0-canary.0

package/dist/get-exposed-dependencies.d.ts

@@ -0,0 +1,3 @@
+import { ExposedDependencies } from './types';
+export declare function getExposedDependencies(sharedDependencies: Record<string, string>, getVersion: (dependency: string) => string): ExposedDependencies;
+//# sourceMappingURL=get-exposed-dependencies.d.ts.map

package/dist/get-exposed-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-exposed-dependencies.d.ts","sourceRoot":"","sources":["../src/get-exposed-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,wBAAgB,sBAAsB,CAClC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,uBAS7C"}

package/dist/get-exposed-dependencies.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExposedDependencies = getExposedDependencies;
+function getExposedDependencies(sharedDependencies, getVersion) {
+    return Object.entries(sharedDependencies).reduce((result, [dependency, variable]) => ({
+        ...result,
+        [dependency]: { version: getVersion(dependency), variable },
+    }), {});
+}
+//# sourceMappingURL=get-exposed-dependencies.js.map

package/dist/get-exposed-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-exposed-dependencies.js","sourceRoot":"","sources":["../src/get-exposed-dependencies.ts"],"names":[],"mappings":";;AAEA,wDAWC;AAXD,SAAgB,sBAAsB,CAClC,kBAA0C,EAC1C,UAA0C;IAE1C,OAAO,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAC5C,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,MAAM;QACT,CAAC,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE;KAC9D,CAAC,EACF,EAAyB,CAC5B,CAAC;AACN,CAAC"}

package/dist/get-version-mismatches.d.ts

@@ -0,0 +1,6 @@
+import { ExposedDependencies } from './types';
+export declare const getVersionMismatches: (exposedDependencies: ExposedDependencies, dependencies: Record<string, string>, sharedDependencies: Record<string, string>) => Record<string, {
+    host: string;
+    package: string;
+}>;
+//# sourceMappingURL=get-version-mismatches.d.ts.map

package/dist/get-version-mismatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-version-mismatches.d.ts","sourceRoot":"","sources":["../src/get-version-mismatches.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,oBAAoB,wBACR,mBAAmB,gBAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,sBAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;UAeT,MAAM;aAAW,MAAM;EAc3D,CAAC"}

package/dist/get-version-mismatches.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionMismatches = void 0;
+const is_compatible_1 = require("./is-compatible");
+const getVersionMismatches = (exposedDependencies, dependencies, sharedDependencies) => {
+    const mismatch = Object.entries(exposedDependencies).reduce((result, [dependency, { version: hostVersion }]) => {
+        const packageVersion = dependencies[dependency];
+        if (packageVersion &&
+            !!sharedDependencies[dependency] &&
+            !(0, is_compatible_1.isCompatible)(hostVersion, packageVersion)) {
+            result[dependency] = { host: hostVersion, package: packageVersion };
+        }
+        return result;
+    }, {});
+    for (const [dependency, variable] of Object.entries(sharedDependencies)) {
+        const packageVersion = dependencies[dependency];
+        if (!exposedDependencies[dependency]) {
+            mismatch[dependency] = { host: 'missing', package: packageVersion };
+        }
+        else if (exposedDependencies[dependency].variable !== variable) {
+            mismatch[dependency] = { host: 'wrong global variable', package: packageVersion };
+        }
+    }
+    return mismatch;
+};
+exports.getVersionMismatches = getVersionMismatches;
+//# sourceMappingURL=get-version-mismatches.js.map

package/dist/get-version-mismatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-version-mismatches.js","sourceRoot":"","sources":["../src/get-version-mismatches.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAGxC,MAAM,oBAAoB,GAAG,CAChC,mBAAwC,EACxC,YAAoC,EACpC,kBAA0C,EAC5C,EAAE;IACA,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,MAAM,CACvD,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE;QAC/C,MAAM,cAAc,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAChD,IACI,cAAc;YACd,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC;YAChC,CAAC,IAAA,4BAAY,EAAC,WAAW,EAAE,cAAc,CAAC,EAC5C,CAAC;YACC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QACxE,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,EACD,EAAuD,CAC1D,CAAC;IAEF,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtE,MAAM,cAAc,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QAEhD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QACxE,CAAC;aAAM,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/D,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QACtF,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC,CAAC;AAhCW,QAAA,oBAAoB,wBAgC/B"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-exposed-dependencies';
+export * from './get-version-mismatches';
+export * from './is-compatible';
+export * from './load-shared-dependencies';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./get-exposed-dependencies"), exports);
+__exportStar(require("./get-version-mismatches"), exports);
+__exportStar(require("./is-compatible"), exports);
+__exportStar(require("./load-shared-dependencies"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,2DAAyC;AACzC,kDAAgC;AAChC,6DAA2C"}

package/dist/is-compatible.d.ts

@@ -0,0 +1,2 @@
+export declare function isCompatible(hostVersion: string, packageVersion: string): boolean;
+//# sourceMappingURL=is-compatible.d.ts.map

package/dist/is-compatible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-compatible.d.ts","sourceRoot":"","sources":["../src/is-compatible.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAkCvE"}

package/dist/is-compatible.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCompatible = isCompatible;
+const semver_1 = __importDefault(require("semver"));
+function isCompatible(hostVersion, packageVersion) {
+    if (hostVersion === packageVersion) {
+        return true;
+    }
+    if (hostVersion === '*') {
+        return false;
+    }
+    if (packageVersion === '*') {
+        return true;
+    }
+    // host and package have exact non-equal versions
+    if (semver_1.default.valid(hostVersion) && semver_1.default.valid(packageVersion)) {
+        return false;
+    }
+    // exact package version couldn't be compatible with host range
+    if (semver_1.default.validRange(hostVersion) && semver_1.default.valid(packageVersion)) {
+        return false;
+    }
+    // exact host version must be in package range
+    if (semver_1.default.valid(hostVersion) && semver_1.default.validRange(packageVersion)) {
+        return semver_1.default.satisfies(hostVersion, packageVersion);
+    }
+    // host range must be fully included in package range
+    if (semver_1.default.validRange(hostVersion) && semver_1.default.validRange(packageVersion)) {
+        return semver_1.default.subset(hostVersion, packageVersion);
+    }
+    return false;
+}
+//# sourceMappingURL=is-compatible.js.map

package/dist/is-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-compatible.js","sourceRoot":"","sources":["../src/is-compatible.ts"],"names":[],"mappings":";;;;;AAEA,oCAkCC;AApCD,oDAA4B;AAE5B,SAAgB,YAAY,CAAC,WAAmB,EAAE,cAAsB;IACpE,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,WAAW,KAAK,GAAG,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,cAAc,KAAK,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,iDAAiD;IACjD,IAAI,gBAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,gBAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,+DAA+D;IAC/D,IAAI,gBAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,gBAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,8CAA8C;IAC9C,IAAI,gBAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,gBAAM,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACjE,OAAO,gBAAM,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACzD,CAAC;IAED,qDAAqD;IACrD,IAAI,gBAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,gBAAM,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACtE,OAAO,gBAAM,CAAC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/load-shared-dependencies.d.ts

@@ -0,0 +1,2 @@
+export declare function loadSharedDependencies(dependencies: Record<string, string> | undefined, sharedDependencies: Record<string, string> | undefined): Record<string, string>;
+//# sourceMappingURL=load-shared-dependencies.d.ts.map

package/dist/load-shared-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-shared-dependencies.d.ts","sourceRoot":"","sources":["../src/load-shared-dependencies.ts"],"names":[],"mappings":"AAaA,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAChD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACvD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB"}

package/dist/load-shared-dependencies.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSharedDependencies = loadSharedDependencies;
+const getDefaultSharedDependencies = () => ({
+    '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+    '@servicetitan/anvil2': 'SharedDependencies.ServiceTitan.Anvil2',
+    'classnames': 'SharedDependencies.ClassNames',
+    'formstate': 'SharedDependencies.FormState',
+    'mobx': 'SharedDependencies.MobX',
+    'mobx-react': 'SharedDependencies.MobXReact',
+    'mobx-utils': 'SharedDependencies.MobXUtils',
+    'react': 'SharedDependencies.React',
+    'react-dom': 'SharedDependencies.ReactDOM',
+});
+const defaultsKey = 'defaults';
+function loadSharedDependencies(dependencies, sharedDependencies) {
+    if (!dependencies) {
+        return {};
+    }
+    const out = {
+        ...(!sharedDependencies || sharedDependencies[defaultsKey] !== undefined
+            ? getDefaultSharedDependencies()
+            : {}),
+        ...(sharedDependencies !== null && sharedDependencies !== void 0 ? sharedDependencies : {}),
+    };
+    delete out[defaultsKey];
+    for (const [dependency, value] of Object.entries(out)) {
+        if (!value || !dependencies[dependency]) {
+            delete out[dependency];
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=load-shared-dependencies.js.map

package/dist/load-shared-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-shared-dependencies.js","sourceRoot":"","sources":["../src/load-shared-dependencies.ts"],"names":[],"mappings":";;AAaA,wDAwBC;AArCD,MAAM,4BAA4B,GAAG,GAAG,EAAE,CAAC,CAAC;IACxC,6BAA6B,EAAE,8CAA8C;IAC7E,sBAAsB,EAAE,wCAAwC;IAChE,YAAY,EAAE,+BAA+B;IAC7C,WAAW,EAAE,8BAA8B;IAC3C,MAAM,EAAE,yBAAyB;IACjC,YAAY,EAAE,8BAA8B;IAC5C,YAAY,EAAE,8BAA8B;IAC5C,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,6BAA6B;CAC7C,CAAC,CAAC;AACH,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B,SAAgB,sBAAsB,CAClC,YAAgD,EAChD,kBAAsD;IAEtD,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAA2B;QAChC,GAAG,CAAC,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,WAAW,CAAC,KAAK,SAAS;YACpE,CAAC,CAAC,4BAA4B,EAAE;YAChC,CAAC,CAAC,EAAE,CAAC;QACT,GAAG,CAAC,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,EAAE,CAAC;KAChC,CAAC;IAEF,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;IAExB,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export interface ExposedDependency {
+    version: string;
+    variable: string;
+}
+export type ExposedDependencies = Record<string, ExposedDependency>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+    "name": "@servicetitan/startup-utils",
+    "version": "27.4.0-canary.0",
+    "description": "",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/servicetitan/uikit.git",
+        "directory": "packages/startup-utils"
+    },
+    "main": "./dist/index.js",
+    "typings": "./dist/index.d.ts",
+    "files": [
+        "dist",
+        "src"
+    ],
+    "dependencies": {
+        "semver": "^7.6.3"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "cli": {
+        "webpack": false
+    }
+}

package/src/__tests__/get-version-mismatches.test.ts

@@ -0,0 +1,86 @@
+import { getVersionMismatches } from '../get-version-mismatches';
+import { ExposedDependencies } from '../types';
+
+describe(`[web-components] ${getVersionMismatches.name}`, () => {
+    let sharedDependencies: Record<string, string> = {};
+    let dependencies: Record<string, string> = {};
+    let exposedDependencies: ExposedDependencies = {};
+
+    beforeEach(() => {
+        sharedDependencies = {
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+        };
+
+        dependencies = {
+            '@servicetitan/design-system': '~11.8.0',
+        };
+
+        exposedDependencies = {
+            '@servicetitan/design-system': {
+                version: '~11.8.0',
+                variable: 'SharedDependencies.ServiceTitan.DesignSystem',
+            },
+        };
+    });
+
+    function itReturnsNoMismatches() {
+        test('returns no mismatches', () => {
+            expect(
+                getVersionMismatches(exposedDependencies, dependencies, sharedDependencies)
+            ).toEqual({});
+        });
+    }
+
+    itReturnsNoMismatches();
+
+    describe('when there is a versions mismatch', () => {
+        beforeEach(() => (dependencies['@servicetitan/design-system'] = '~12.0.0'));
+
+        test('returns the mismatch', () => {
+            expect(
+                getVersionMismatches(exposedDependencies, dependencies, sharedDependencies)
+            ).toEqual({
+                '@servicetitan/design-system': {
+                    host: '~11.8.0',
+                    package: '~12.0.0',
+                },
+            });
+        });
+
+        describe('when the mismatch is not a shared dependency', () => {
+            beforeEach(() => (sharedDependencies = {}));
+
+            itReturnsNoMismatches();
+        });
+    });
+
+    describe('when a dependency is missing from exposed dependencies', () => {
+        beforeEach(() => delete exposedDependencies['@servicetitan/design-system']);
+
+        test('returns an object citing the dependency is missing from the host', () => {
+            expect(
+                getVersionMismatches(exposedDependencies, dependencies, sharedDependencies)
+            ).toEqual({
+                '@servicetitan/design-system': {
+                    host: 'missing',
+                    package: '~11.8.0',
+                },
+            });
+        });
+    });
+
+    describe('when a variable does not match', () => {
+        beforeEach(() => (exposedDependencies['@servicetitan/design-system'].variable = 'foo'));
+
+        test('returns an object citing the variable is wrong', () => {
+            expect(
+                getVersionMismatches(exposedDependencies, dependencies, sharedDependencies)
+            ).toEqual({
+                '@servicetitan/design-system': {
+                    host: 'wrong global variable',
+                    package: '~11.8.0',
+                },
+            });
+        });
+    });
+});

package/src/__tests__/is-compatible.test.ts

@@ -0,0 +1,91 @@
+import { isCompatible } from '../is-compatible';
+
+describe(`[web-components] ${isCompatible.name}`, () => {
+    let hostVersion: string;
+    let packageVersion: string;
+
+    beforeEach(() => {
+        hostVersion = 'foo';
+        packageVersion = 'bar';
+    });
+
+    function returnsFalse() {
+        test('returns false', () => {
+            expect(isCompatible(hostVersion, packageVersion)).toBe(false);
+        });
+    }
+
+    function returnsTrue() {
+        test('returns true', () => {
+            expect(isCompatible(hostVersion, packageVersion)).toBe(true);
+        });
+    }
+
+    returnsFalse();
+
+    describe('when versions are equal', () => {
+        beforeEach(() => {
+            hostVersion = '1.0.0';
+            packageVersion = '1.0.0';
+        });
+        returnsTrue();
+    });
+
+    describe("when hostVersion is '*'", () => {
+        beforeEach(() => (hostVersion = '*'));
+        returnsFalse();
+    });
+
+    describe("when packageVersion is '*'", () => {
+        beforeEach(() => (packageVersion = '*'));
+        returnsTrue();
+    });
+
+    describe('when versions are both exact SemVers and not equal', () => {
+        beforeEach(() => {
+            hostVersion = '1.0.0';
+            packageVersion = '1.2.0';
+        });
+        returnsFalse();
+    });
+
+    describe('when hostVersion is a SemVer range and packageVersion is an exact SemVer', () => {
+        beforeEach(() => {
+            hostVersion = '^1.0.0';
+            packageVersion = '1.2.0';
+        });
+        returnsFalse();
+    });
+
+    describe('when hostVersion is an exact SemVer that falls within the packageVersion SemVer range', () => {
+        beforeEach(() => {
+            hostVersion = '1.2.0';
+            packageVersion = '^1.0.0';
+        });
+        returnsTrue();
+    });
+
+    describe('when hostVersion is an exact SemVer that does not fall within the packageVersion SemVer range', () => {
+        beforeEach(() => {
+            hostVersion = '1.2.0';
+            packageVersion = '~1.0.0';
+        });
+        returnsFalse();
+    });
+
+    describe('when hostVersion is a SemVer range that falls within the packageVersion  SemVer range', () => {
+        beforeEach(() => {
+            hostVersion = '~1.2.0';
+            packageVersion = '^1.0.0';
+        });
+        returnsTrue();
+    });
+
+    describe('when hostVersion is an exact SemVer that does not fall within the packageVersion SemVer range', () => {
+        beforeEach(() => {
+            hostVersion = '^1.2.0';
+            packageVersion = '~1.0.0';
+        });
+        returnsFalse();
+    });
+});

package/src/__tests__/load-shared-dependencies.test.ts

@@ -0,0 +1,114 @@
+import { loadSharedDependencies } from '../load-shared-dependencies';
+
+describe('[Startup] utils:loadSharedDependencies', () => {
+    const getPackageDependencies = (...excluded: string[]) =>
+        Object.entries({
+            '@servicetitan/confirm': '^0.0.0',
+            '@servicetitan/design-system': '^0.0.0',
+            'classnames': '^0.0.0',
+            'formstate': '^0.0.0',
+            'mobx': '^0.0.0',
+            'mobx-react': '^0.0.0',
+            'mobx-utils': '^0.0.0',
+            'react': '^0.0.0',
+            'react-dom': '^0.0.0',
+            'react-input-mask': '^0.0.0',
+        }).reduce(
+            (out, [d, v]) => ({
+                ...out,
+                ...(excluded.includes(d) ? {} : { [d]: v }),
+            }),
+            {}
+        );
+
+    test('return default dependencies when manual are not configured', () => {
+        expect(loadSharedDependencies(getPackageDependencies(), undefined)).toEqual({
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+            'classnames': 'SharedDependencies.ClassNames',
+            'formstate': 'SharedDependencies.FormState',
+            'mobx': 'SharedDependencies.MobX',
+            'mobx-react': 'SharedDependencies.MobXReact',
+            'mobx-utils': 'SharedDependencies.MobXUtils',
+            'react': 'SharedDependencies.React',
+            'react-dom': 'SharedDependencies.ReactDOM',
+        });
+    });
+
+    test('return default dependencies except not used when manual are not configured', () => {
+        expect(loadSharedDependencies(getPackageDependencies('mobx-utils'), undefined)).toEqual({
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+            'classnames': 'SharedDependencies.ClassNames',
+            'formstate': 'SharedDependencies.FormState',
+            'mobx': 'SharedDependencies.MobX',
+            'mobx-react': 'SharedDependencies.MobXReact',
+            'react': 'SharedDependencies.React',
+            'react-dom': 'SharedDependencies.ReactDOM',
+        });
+    });
+
+    test('return manual dependencies if set', () => {
+        expect(
+            loadSharedDependencies(getPackageDependencies(), {
+                '@servicetitan/confirm': 'SharedDependencies.ServiceTitan.Confirm',
+                'react-input-mask': 'SharedDependencies.ReactInputMask',
+            })
+        ).toEqual({
+            '@servicetitan/confirm': 'SharedDependencies.ServiceTitan.Confirm',
+            'react-input-mask': 'SharedDependencies.ReactInputMask',
+        });
+    });
+
+    test('return default dependencies within manual', () => {
+        expect(
+            loadSharedDependencies(getPackageDependencies(), {
+                defaults: '',
+            })
+        ).toEqual({
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+            'classnames': 'SharedDependencies.ClassNames',
+            'formstate': 'SharedDependencies.FormState',
+            'mobx': 'SharedDependencies.MobX',
+            'mobx-react': 'SharedDependencies.MobXReact',
+            'mobx-utils': 'SharedDependencies.MobXUtils',
+            'react': 'SharedDependencies.React',
+            'react-dom': 'SharedDependencies.ReactDOM',
+        });
+    });
+
+    test('clear default dependencies when configured', () => {
+        expect(
+            loadSharedDependencies(getPackageDependencies(), {
+                'defaults': '',
+                'mobx-utils': '',
+            })
+        ).toEqual({
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+            'classnames': 'SharedDependencies.ClassNames',
+            'formstate': 'SharedDependencies.FormState',
+            'mobx': 'SharedDependencies.MobX',
+            'mobx-react': 'SharedDependencies.MobXReact',
+            'react': 'SharedDependencies.React',
+            'react-dom': 'SharedDependencies.ReactDOM',
+        });
+    });
+
+    test('mixes default dependencies and configured', () => {
+        expect(
+            loadSharedDependencies(getPackageDependencies(), {
+                'defaults': '',
+                'mobx-utils': '',
+                'react-input-mask': 'SharedDependencies.ReactInputMask',
+                'react-something': 'SharedDependencies.ReactSomething',
+            })
+        ).toEqual({
+            '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+            'classnames': 'SharedDependencies.ClassNames',
+            'formstate': 'SharedDependencies.FormState',
+            'mobx': 'SharedDependencies.MobX',
+            'mobx-react': 'SharedDependencies.MobXReact',
+            'react': 'SharedDependencies.React',
+            'react-dom': 'SharedDependencies.ReactDOM',
+            'react-input-mask': 'SharedDependencies.ReactInputMask',
+        });
+    });
+});

package/src/get-exposed-dependencies.ts

@@ -0,0 +1,14 @@
+import { ExposedDependencies } from './types';
+
+export function getExposedDependencies(
+    sharedDependencies: Record<string, string>,
+    getVersion: (dependency: string) => string
+) {
+    return Object.entries(sharedDependencies).reduce(
+        (result, [dependency, variable]) => ({
+            ...result,
+            [dependency]: { version: getVersion(dependency), variable },
+        }),
+        {} as ExposedDependencies
+    );
+}

package/src/get-version-mismatches.ts

@@ -0,0 +1,36 @@
+import { isCompatible } from './is-compatible';
+import { ExposedDependencies } from './types';
+
+export const getVersionMismatches = (
+    exposedDependencies: ExposedDependencies,
+    dependencies: Record<string, string>,
+    sharedDependencies: Record<string, string>
+) => {
+    const mismatch = Object.entries(exposedDependencies).reduce(
+        (result, [dependency, { version: hostVersion }]) => {
+            const packageVersion = dependencies[dependency];
+            if (
+                packageVersion &&
+                !!sharedDependencies[dependency] &&
+                !isCompatible(hostVersion, packageVersion)
+            ) {
+                result[dependency] = { host: hostVersion, package: packageVersion };
+            }
+
+            return result;
+        },
+        {} as Record<string, { host: string; package: string }>
+    );
+
+    for (const [dependency, variable] of Object.entries(sharedDependencies)) {
+        const packageVersion = dependencies[dependency];
+
+        if (!exposedDependencies[dependency]) {
+            mismatch[dependency] = { host: 'missing', package: packageVersion };
+        } else if (exposedDependencies[dependency].variable !== variable) {
+            mismatch[dependency] = { host: 'wrong global variable', package: packageVersion };
+        }
+    }
+
+    return mismatch;
+};

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './get-exposed-dependencies';
+export * from './get-version-mismatches';
+export * from './is-compatible';
+export * from './load-shared-dependencies';

package/src/is-compatible.ts

@@ -0,0 +1,37 @@
+import semver from 'semver';
+
+export function isCompatible(hostVersion: string, packageVersion: string) {
+    if (hostVersion === packageVersion) {
+        return true;
+    }
+
+    if (hostVersion === '*') {
+        return false;
+    }
+
+    if (packageVersion === '*') {
+        return true;
+    }
+
+    // host and package have exact non-equal versions
+    if (semver.valid(hostVersion) && semver.valid(packageVersion)) {
+        return false;
+    }
+
+    // exact package version couldn't be compatible with host range
+    if (semver.validRange(hostVersion) && semver.valid(packageVersion)) {
+        return false;
+    }
+
+    // exact host version must be in package range
+    if (semver.valid(hostVersion) && semver.validRange(packageVersion)) {
+        return semver.satisfies(hostVersion, packageVersion);
+    }
+
+    // host range must be fully included in package range
+    if (semver.validRange(hostVersion) && semver.validRange(packageVersion)) {
+        return semver.subset(hostVersion, packageVersion);
+    }
+
+    return false;
+}

package/src/load-shared-dependencies.ts

@@ -0,0 +1,38 @@
+const getDefaultSharedDependencies = () => ({
+    '@servicetitan/design-system': 'SharedDependencies.ServiceTitan.DesignSystem',
+    '@servicetitan/anvil2': 'SharedDependencies.ServiceTitan.Anvil2',
+    'classnames': 'SharedDependencies.ClassNames',
+    'formstate': 'SharedDependencies.FormState',
+    'mobx': 'SharedDependencies.MobX',
+    'mobx-react': 'SharedDependencies.MobXReact',
+    'mobx-utils': 'SharedDependencies.MobXUtils',
+    'react': 'SharedDependencies.React',
+    'react-dom': 'SharedDependencies.ReactDOM',
+});
+const defaultsKey = 'defaults';
+
+export function loadSharedDependencies(
+    dependencies: Record<string, string> | undefined,
+    sharedDependencies: Record<string, string> | undefined
+): Record<string, string> {
+    if (!dependencies) {
+        return {};
+    }
+
+    const out: Record<string, string> = {
+        ...(!sharedDependencies || sharedDependencies[defaultsKey] !== undefined
+            ? getDefaultSharedDependencies()
+            : {}),
+        ...(sharedDependencies ?? {}),
+    };
+
+    delete out[defaultsKey];
+
+    for (const [dependency, value] of Object.entries(out)) {
+        if (!value || !dependencies[dependency]) {
+            delete out[dependency];
+        }
+    }
+
+    return out;
+}

package/src/types.ts

@@ -0,0 +1,6 @@
+export interface ExposedDependency {
+    version: string;
+    variable: string;
+}
+
+export type ExposedDependencies = Record<string, ExposedDependency>;