@plasmicapp/cli 0.1.167 → 0.1.171

package/dist/__mocks__/api.js

@@ -249,6 +249,7 @@ class PlasmicApi {
                     iconChecksums: [],
                     globalVariantChecksums: [],
                     projectCssChecksum: "",
+                    globalContextsChecksum: "",
                 },
                 usedNpmPackages: [],
                 externalCssImports: [],
@@ -276,6 +277,11 @@ class PlasmicApi {
             throw new Error("Unimplemented");
         });
     }
+    latestCodegenVersion() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return "0.0.1";
+        });
+    }
     requiredPackages() {
         return __awaiter(this, void 0, void 0, function* () {
             return {

package/dist/actions/fix-imports.js

@@ -11,14 +11,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fixImports = void 0;
 const code_utils_1 = require("../utils/code-utils");
-const file_utils_1 = require("../utils/file-utils");
+const config_utils_1 = require("../utils/config-utils");
 const get_context_1 = require("../utils/get-context");
 function fixImports(opts) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!opts.baseDir)
             opts.baseDir = process.cwd();
         const context = yield get_context_1.getContext(opts, { enableSkipAuth: true });
-        yield file_utils_1.fixAllFilePaths(context, opts.baseDir);
+        yield config_utils_1.updateConfig(context, context.config, opts.baseDir);
         yield code_utils_1.fixAllImportStatements(context, opts.baseDir);
     });
 }

package/dist/actions/info.d.ts

@@ -0,0 +1,5 @@
+import { CommonArgs } from "..";
+export interface InfoArgs extends CommonArgs {
+    projects: readonly string[];
+}
+export declare function printProjectInfo(opts: InfoArgs): Promise<void>;

package/dist/actions/info.js

@@ -0,0 +1,27 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printProjectInfo = void 0;
+const deps_1 = require("../deps");
+const get_context_1 = require("../utils/get-context");
+function printProjectInfo(opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let context = yield get_context_1.getContext(opts);
+        const results = yield Promise.all(opts.projects.map((p) => __awaiter(this, void 0, void 0, function* () { return yield context.api.projectMeta(p); })));
+        for (const meta of results) {
+            deps_1.logger.info(`Id: ${meta.id}`);
+            deps_1.logger.info(`Name: ${meta.name}`);
+            deps_1.logger.info(`Host URL: ${meta.hostUrl}`);
+            deps_1.logger.info(`Last published version: ${meta.lastPublishedVersion}`);
+        }
+    });
+}
+exports.printProjectInfo = printProjectInfo;

package/dist/actions/sync-global-contexts.d.ts

@@ -0,0 +1,4 @@
+import { ChecksumBundle, ProjectMetaBundle } from "../api";
+import { PlasmicContext, ProjectConfig, ProjectLock } from "../utils/config-utils";
+export declare function syncGlobalContexts(context: PlasmicContext, projectMeta: ProjectMetaBundle, projectConfig: ProjectConfig, projectLock: ProjectLock, checksums: ChecksumBundle, baseDir: string): Promise<void>;
+export declare function getGlobalContextsResourcePath(context: PlasmicContext, projectConfig: ProjectConfig): string;

package/dist/actions/sync-global-contexts.js

@@ -0,0 +1,61 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalContextsResourcePath = exports.syncGlobalContexts = void 0;
+const deps_1 = require("../deps");
+const code_utils_1 = require("../utils/code-utils");
+const lodash_1 = __importDefault(require("lodash"));
+const file_utils_1 = require("../utils/file-utils");
+const COMPONENT_NAME = "PlasmicGlobalContextsProvider";
+function syncGlobalContexts(context, projectMeta, projectConfig, projectLock, checksums, baseDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const resourcePath = getGlobalContextsResourcePath(context, projectConfig);
+        if (checksums.globalContextsChecksum && projectMeta.globalContextBundle) {
+            if (context.cliArgs.quiet !== true) {
+                deps_1.logger.info(`Syncing component: ${COMPONENT_NAME}@${projectLock.version}\t['${projectConfig.projectName}' ${projectConfig.projectId} ${projectConfig.version}]`);
+            }
+            if (context.config.code.lang === "js") {
+                projectMeta.globalContextBundle.contextModule = code_utils_1.formatScript(code_utils_1.tsxToJsx(projectMeta.globalContextBundle.contextModule), baseDir);
+            }
+            file_utils_1.writeFileContent(context, resourcePath, projectMeta.globalContextBundle.contextModule, { force: false });
+            projectConfig.globalContextsFilePath = resourcePath;
+            const fl = projectLock.fileLocks.find((fl) => fl.assetId === projectConfig.projectId && fl.type === "globalContexts");
+            if (fl) {
+                fl.checksum = checksums.globalContextsChecksum;
+            }
+            else {
+                projectLock.fileLocks.push({
+                    assetId: projectConfig.projectId,
+                    checksum: checksums.globalContextsChecksum,
+                    type: "globalContexts",
+                });
+            }
+        }
+        else if (!checksums.globalContextsChecksum &&
+            !projectMeta.globalContextBundle) {
+            if (file_utils_1.fileExists(context, resourcePath)) {
+                file_utils_1.deleteFile(context, resourcePath);
+            }
+            projectConfig.globalContextsFilePath = "";
+            lodash_1.default.remove(projectLock.fileLocks, (fl) => fl.assetId === projectConfig.projectId && fl.type === "globalContexts");
+        }
+    });
+}
+exports.syncGlobalContexts = syncGlobalContexts;
+function getGlobalContextsResourcePath(context, projectConfig) {
+    return projectConfig.globalContextsFilePath !== ""
+        ? projectConfig.globalContextsFilePath
+        : file_utils_1.defaultResourcePath(context, projectConfig, `${COMPONENT_NAME}.${context.config.code.lang === "ts" ? "tsx" : "jsx"}`);
+}
+exports.getGlobalContextsResourcePath = getGlobalContextsResourcePath;

package/dist/actions/sync.js

@@ -54,6 +54,7 @@ const sync_global_variants_1 = require("./sync-global-variants");
 const sync_icons_1 = require("./sync-icons");
 const sync_images_1 = require("./sync-images");
 const sync_styles_1 = require("./sync-styles");
+const sync_global_contexts_1 = require("./sync-global-contexts");
 function ensureRequiredPackages(context, baseDir, yes) {
     return __awaiter(this, void 0, void 0, function* () {
         const requireds = yield context.api.requiredPackages();
@@ -257,6 +258,12 @@ function sync(opts, metadataDefaults) {
                 const config = Object.assign(Object.assign({}, loaderConfig), { projects: lodash_1.default.sortBy(lodash_1.default.uniqBy([...freshIdsAndTokens, ...((_b = loaderConfig === null || loaderConfig === void 0 ? void 0 : loaderConfig.projects) !== null && _b !== void 0 ? _b : [])], (p) => p.projectId), (p) => p.projectId) });
                 writeLoaderConfig(opts, config);
             }
+            const codegenVersion = yield context.api.latestCodegenVersion();
+            context.lock.projects.forEach((p) => {
+                if (projectsToSync.some((syncedProject) => syncedProject.projectId === p.projectId)) {
+                    p.codegenVersion = codegenVersion;
+                }
+            });
             // Write the new ComponentConfigs to disk
             yield config_utils_1.updateConfig(context, context.config, baseDir);
         }));
@@ -438,6 +445,7 @@ function syncProjectConfig(context, projectBundle, projectApiToken, version, dep
             projectConfig.jsBundleThemes.length === 0) {
             delete projectConfig.jsBundleThemes;
         }
+        yield sync_global_contexts_1.syncGlobalContexts(context, projectBundle, projectConfig, projectLock, checksums, baseDir);
         // Write out components
         yield sync_components_1.syncProjectComponents(context, projectConfig, version, componentBundles, forceOverwrite, appendJsxOnMissingBase, summary, pendingMerge, projectLock, checksums, baseDir);
     });

package/dist/api.d.ts

@@ -25,6 +25,10 @@ export interface GlobalVariantBundle {
     contextModule: string;
     contextFileName: string;
 }
+export interface GlobalContextBundle {
+    id: string;
+    contextModule: string;
+}
 export interface JsBundleTheme {
     themeFileName: string;
     themeModule: string;
@@ -36,6 +40,7 @@ export interface ProjectMetaBundle {
     cssFileName: string;
     cssRules: string;
     jsBundleThemes?: JsBundleTheme[];
+    globalContextBundle?: GlobalContextBundle;
 }
 export interface IconBundle {
     id: string;
@@ -111,6 +116,7 @@ export interface ChecksumBundle {
     iconChecksums: Array<[string, string]>;
     globalVariantChecksums: Array<[string, string]>;
     projectCssChecksum: string;
+    globalContextsChecksum: string;
 }
 export interface CodeComponentMeta {
     id: string;
@@ -127,6 +133,7 @@ export interface ProjectIdAndToken {
 }
 export declare class PlasmicApi {
     private auth;
+    private codegenVersion?;
     constructor(auth: AuthConfig);
     genStyleConfig(styleOpts?: StyleConfig): Promise<StyleConfigResponse>;
     /**
@@ -146,6 +153,7 @@ export declare class PlasmicApi {
     }[], recursive?: boolean): Promise<VersionResolution>;
     getCurrentUser(): Promise<import("axios").AxiosResponse<any>>;
     requiredPackages(): Promise<RequiredPackages>;
+    latestCodegenVersion(): Promise<string>;
     /**
      * Code-gen endpoint.
      * This will fetch components at an exact specified version.

package/dist/api.js

@@ -66,6 +66,15 @@ class PlasmicApi {
             return Object.assign({}, resp.data);
         });
     }
+    latestCodegenVersion() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.codegenVersion) {
+                const resp = yield this.post(`${this.codegenHost}/api/v1/code/latest-codegen-version`);
+                this.codegenVersion = resp.data;
+            }
+            return this.codegenVersion;
+        });
+    }
     /**
      * Code-gen endpoint.
      * This will fetch components at an exact specified version.

package/dist/migrations/0.1.143-ensureImportModuleType.d.ts

@@ -0,0 +1,2 @@
+import { PlasmicConfig } from "../utils/config-utils";
+export declare function ensureImportModuleType(config: PlasmicConfig): PlasmicConfig;

package/dist/migrations/0.1.143-ensureImportModuleType.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureImportModuleType = void 0;
+function ensureImportModuleType(config) {
+    for (const project of config.projects) {
+        for (const component of project.components) {
+            component.importSpec.moduleType = "local";
+        }
+    }
+    return config;
+}
+exports.ensureImportModuleType = ensureImportModuleType;

package/dist/plasmic.schema.json

@@ -282,6 +282,10 @@
                     "description": "File location for the project-wide css styles. Relative to srcDir",
                     "type": "string"
                 },
+                "globalContextsFilePath": {
+                    "description": "File location for the project-wide global contexts. Relative to srcDir",
+                    "type": "string"
+                },
                 "icons": {
                     "description": "Metadata for each synced icon in this project",
                     "items": {
@@ -326,6 +330,7 @@
             "required": [
                 "components",
                 "cssFilePath",
+                "globalContextsFilePath",
                 "icons",
                 "images",
                 "indirect",

package/dist/test-common/fixtures.js

@@ -139,6 +139,7 @@ exports.project1Config = {
     images: [],
     jsBundleThemes: [],
     indirect: false,
+    globalContextsFilePath: "",
 };
 function expectProject1PlasmicJson(optional) {
     const plasmicJson = exports.tmpRepo.readPlasmicJson();

package/dist/utils/checksum.js

@@ -13,6 +13,7 @@ function getChecksums(context, opts, projectId, componentIds) {
             cssRulesChecksums: [],
             globalVariantChecksums: [],
             projectCssChecksum: "",
+            globalContextsChecksum: "",
         };
     }
     const fileLocks = projectLock.fileLocks;
@@ -51,6 +52,11 @@ function getChecksums(context, opts, projectId, componentIds) {
     const projectCssChecksums = fileLocks.filter((fileLock) => fileLock.type === "projectCss");
     lang_utils_1.assert(projectCssChecksums.length < 2);
     const projectCssChecksum = projectCssChecksums.length > 0 ? projectCssChecksums[0].checksum : "";
+    const globalContextsChecksums = fileLocks.filter((fileLock) => fileLock.type === "globalContexts" && fileLock.assetId === projectId);
+    lang_utils_1.assert(globalContextsChecksums.length < 2);
+    const globalContextsChecksum = globalContextsChecksums.length > 0
+        ? globalContextsChecksums[0].checksum
+        : "";
     return {
         imageChecksums,
         iconChecksums,
@@ -58,6 +64,7 @@ function getChecksums(context, opts, projectId, componentIds) {
         cssRulesChecksums,
         globalVariantChecksums,
         projectCssChecksum,
+        globalContextsChecksum,
     };
 }
 exports.getChecksums = getChecksums;

package/dist/utils/code-utils.js

@@ -41,9 +41,11 @@ const Prettier = __importStar(require("prettier"));
 const prettier_1 = require("prettier");
 const ts = __importStar(require("typescript"));
 const upath_1 = __importDefault(require("upath"));
+const sync_global_contexts_1 = require("../actions/sync-global-contexts");
 const sync_images_1 = require("../actions/sync-images");
 const deps_1 = require("../deps");
 const error_1 = require("../utils/error");
+const config_utils_1 = require("./config-utils");
 const file_utils_1 = require("./file-utils");
 const lang_utils_1 = require("./lang-utils");
 exports.formatAsLocal = (content, filePath, baseDir, defaultOpts = {}) => {
@@ -341,13 +343,15 @@ function fixAllImportStatements(context, baseDir, summary) {
                 }
             }
         }
+        fixGlobalContextImportStatements(context, fixImportContext, baseDir);
     });
 }
 exports.fixAllImportStatements = fixAllImportStatements;
 function fixComponentImportStatements(context, compConfig, fixImportContext, fixSkeletonModule, baseDir) {
     return __awaiter(this, void 0, void 0, function* () {
         // If ComponentConfig.importPath is still a local file, we best-effort also fix up the import statements there.
-        if (isLocalModulePath(compConfig.importSpec.modulePath) &&
+        if (compConfig.type !== "mapped" &&
+            isLocalModulePath(compConfig.importSpec.modulePath) &&
             fixSkeletonModule) {
             yield fixFileImportStatements(context, compConfig.importSpec.modulePath, fixImportContext, true, baseDir);
         }
@@ -455,3 +459,26 @@ exports.formatScript = (code, baseDir) => {
         useTabs: false,
     });
 };
+function fixGlobalContextImportStatements(context, fixImportContext, baseDir) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const project of context.config.projects) {
+            if (!project.globalContextsFilePath)
+                continue;
+            const resourcePath = sync_global_contexts_1.getGlobalContextsResourcePath(context, project);
+            let prevContent;
+            try {
+                prevContent = file_utils_1.readFileText(file_utils_1.makeFilePath(context, resourcePath)).toString();
+            }
+            catch (e) {
+                deps_1.logger.warn(`${resourcePath} is missing. If you deleted this component, remember to remove the component from ${config_utils_1.CONFIG_FILE_NAME}`);
+                throw e;
+            }
+            const newContent = replaceImports(context, prevContent, resourcePath, fixImportContext, false, baseDir, true);
+            if (prevContent !== newContent) {
+                yield file_utils_1.writeFileContent(context, resourcePath, newContent, {
+                    force: true,
+                });
+            }
+        }
+    });
+}

package/dist/utils/config-utils.d.ts

@@ -118,6 +118,8 @@ export interface ProjectConfig {
     version: string;
     /** File location for the project-wide css styles. Relative to srcDir */
     cssFilePath: string;
+    /** File location for the project-wide global contexts. Relative to srcDir */
+    globalContextsFilePath: string;
     jsBundleThemes?: JsBundleThemeConfig[];
     codeComponents?: CodeComponentConfig[];
     /** Metadata for each synced component in this project. */
@@ -213,7 +215,7 @@ export interface GlobalVariantGroupConfig {
     contextFilePath: string;
 }
 export interface FileLock {
-    type: "renderModule" | "cssRules" | "icon" | "image" | "projectCss" | "globalVariant";
+    type: "renderModule" | "cssRules" | "icon" | "image" | "projectCss" | "globalVariant" | "globalContexts";
     checksum: string;
     assetId: string;
 }
@@ -225,6 +227,7 @@ export interface ProjectLock {
     };
     lang: "ts" | "js";
     fileLocks: FileLock[];
+    codegenVersion?: string;
 }
 export interface PlasmicLock {
     projects: ProjectLock[];

package/dist/utils/config-utils.js

@@ -40,6 +40,7 @@ function createProjectConfig(base) {
         icons: [],
         images: [],
         indirect: base.indirect,
+        globalContextsFilePath: "",
     };
 }
 exports.createProjectConfig = createProjectConfig;
@@ -150,6 +151,7 @@ function getOrAddProjectConfig(context, projectId, base // if one doesn't exist,
                 images: [],
                 jsBundleThemes: [],
                 indirect: false,
+                globalContextsFilePath: "",
             };
         context.config.projects.push(project);
     }

package/dist/utils/file-utils.d.ts

@@ -45,11 +45,6 @@ export declare function findSrcDirPath(absoluteSrcDir: string, expectedPath: str
 export declare function findFile(dir: string, pred: (name: string) => boolean, opts: {
     traverseParents?: boolean;
 }): string | undefined;
-/**
- * Fixes all src-relative file paths in PlasmicConfig by detecting file
- * movement on disk.
- */
-export declare function fixAllFilePaths(context: PlasmicContext, baseDir: string): Promise<void>;
 /**
  * Throws an error if some file in PlasmicConfig is not inside the root
  * directory (i.e., the directory containing plasmic.json).

package/dist/utils/file-utils.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.existsBuffered = exports.deleteFileBuffered = exports.renameFileBuffered = exports.readFileText = exports.writeFileText = exports.withBufferedFs = exports.assertAllPathsInRootDir = exports.fixAllFilePaths = exports.findFile = exports.findSrcDirPath = exports.buildBaseNameToFiles = exports.renameFile = exports.makeFilePath = exports.fileExists = exports.deleteFile = exports.readFileContent = exports.writeFileContent = exports.defaultPagePath = exports.defaultPublicResourcePath = exports.defaultResourcePath = exports.writeFileContentRaw = exports.stripExtension = void 0;
+exports.existsBuffered = exports.deleteFileBuffered = exports.renameFileBuffered = exports.readFileText = exports.writeFileText = exports.withBufferedFs = exports.assertAllPathsInRootDir = exports.findFile = exports.findSrcDirPath = exports.buildBaseNameToFiles = exports.renameFile = exports.makeFilePath = exports.fileExists = exports.deleteFile = exports.readFileContent = exports.writeFileContent = exports.defaultPagePath = exports.defaultPublicResourcePath = exports.defaultResourcePath = exports.writeFileContentRaw = exports.stripExtension = void 0;
 const fs_1 = __importDefault(require("fs"));
 const glob_1 = __importDefault(require("glob"));
 const lodash_1 = __importDefault(require("lodash"));
@@ -188,6 +188,7 @@ function getAllPaths(context) {
     };
     const pushProject = (proj) => {
         pushPath(proj, "cssFilePath");
+        pushPath(proj, "globalContextsFilePath");
         for (const component of proj.components) {
             pushComponent(component);
         }
@@ -218,37 +219,6 @@ function getAllPaths(context) {
     }
     return pairs;
 }
-/**
- * Fixes all src-relative file paths in PlasmicConfig by detecting file
- * movement on disk.
- */
-function fixAllFilePaths(context, baseDir) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const baseNameToFiles = buildBaseNameToFiles(context);
-        let changed = false;
-        const paths = getAllPaths(context);
-        for (const { bundle, key } of paths) {
-            const known = bundle[key];
-            // Check null and undefined
-            if (known == null) {
-                throw new error_1.HandledError(`"${key} is required, but missing in ${config_utils_1.CONFIG_FILE_NAME}. Please restore the file or delete from ${config_utils_1.CONFIG_FILE_NAME} and run plasmic sync: ${bundle}"`);
-            }
-            // Check falsey values (e.g. "")
-            if (!known) {
-                continue;
-            }
-            const found = findSrcDirPath(context.absoluteSrcDir, known, baseNameToFiles);
-            if (known !== found) {
-                bundle[key] = found;
-                changed = true;
-            }
-        }
-        if (changed) {
-            yield config_utils_1.updateConfig(context, context.config, baseDir);
-        }
-    });
-}
-exports.fixAllFilePaths = fixAllFilePaths;
 /**
  * Throws an error if some file in PlasmicConfig is not inside the root
  * directory (i.e., the directory containing plasmic.json).

package/dist/utils/get-context.js

@@ -81,10 +81,7 @@ function removeMissingFilesFromLock(context, config, lock) {
             image.id,
             image,
         ]));
-        const knownIcons = Object.fromEntries(knownProjects[project.projectId].icons.map((icons) => [
-            icons.id,
-            icons,
-        ]));
+        const knownIcons = Object.fromEntries(knownProjects[project.projectId].icons.map((icons) => [icons.id, icons]));
         project.fileLocks = project.fileLocks.filter((lock) => {
             switch (lock.type) {
                 default:
@@ -100,6 +97,8 @@ function removeMissingFilesFromLock(context, config, lock) {
                     return knownImages[lock.assetId];
                 case "icon":
                     return knownIcons[lock.assetId];
+                case "globalContexts":
+                    return knownProjects[project.projectId].globalContextsFilePath;
             }
         });
         return project;
@@ -169,6 +168,11 @@ function resolveMissingFilesInConfig(context, config) {
         for (const project of config.projects) {
             project.cssFilePath =
                 (yield attemptToRestoreFilePath(context, project.cssFilePath, baseNameToFiles)) || "";
+            if (!project.globalContextsFilePath) {
+                project.globalContextsFilePath = "";
+            }
+            project.globalContextsFilePath =
+                (yield attemptToRestoreFilePath(context, project.globalContextsFilePath, baseNameToFiles)) || "";
             project.images = yield filterFiles(project.images, "filePath");
             project.icons = yield filterFiles(project.icons, "moduleFilePath");
             project.jsBundleThemes = yield filterFiles(project.jsBundleThemes || [], "themeFilePath");

package/dist/utils/resolve-utils.js

@@ -75,6 +75,15 @@ function checkProjectMeta(meta, root, context, opts) {
         const projectName = meta.projectName;
         const newVersion = meta.version;
         const indirect = meta.indirect;
+        // If the codegen version on-disk is invalid, we will sync again the project.
+        const checkCodegenVersion = () => __awaiter(this, void 0, void 0, function* () {
+            const projectLock = context.lock.projects.find((p) => p.projectId === projectId);
+            if (!!(projectLock === null || projectLock === void 0 ? void 0 : projectLock.codegenVersion) && semver.gte(projectLock.codegenVersion, yield context.api.latestCodegenVersion())) {
+                return false;
+            }
+            return true;
+        });
+        const isOnDiskCodeInvalid = yield checkCodegenVersion();
         // Checks newVersion against plasmic.lock
         const checkVersionLock = () => __awaiter(this, void 0, void 0, function* () {
             const projectLock = context.lock.projects.find((p) => p.projectId === projectId);
@@ -88,7 +97,9 @@ function checkProjectMeta(meta, root, context, opts) {
                 meta !== root) {
                 // If this is a dependency (not root), and we're dealing with latest dep version
                 // just skip, it's confusing
-                deps_1.logger.warn(`'${root.projectName}' depends on ${projectName}@${newVersion}. To update this project, explicitly specify this project for sync. Skipping...`);
+                if (!isOnDiskCodeInvalid) {
+                    deps_1.logger.warn(`'${root.projectName}' depends on ${projectName}@${newVersion}. To update this project, explicitly specify this project for sync. Skipping...`);
+                }
                 return false;
             }
             if (semver.isLatest(newVersion)) {
@@ -106,7 +117,9 @@ function checkProjectMeta(meta, root, context, opts) {
                     return true;
                 }
                 else {
-                    deps_1.logger.info(`Project '${projectName}'@${newVersion} is already up to date; skipping. (To force an update, run again with "--force")`);
+                    if (!isOnDiskCodeInvalid) {
+                        deps_1.logger.info(`Project '${projectName}'@${newVersion} is already up to date; skipping. (To force an update, run again with "--force")`);
+                    }
                     return false;
                 }
             }
@@ -164,9 +177,24 @@ function checkProjectMeta(meta, root, context, opts) {
             // we should always sync it, even if nothing has changed
             return true;
         }
-        return ((yield checkVersionLock()) &&
+        const checkedVersion = (yield checkVersionLock()) &&
             (yield checkVersionRange()) &&
-            (yield checkIndirect()));
+            (yield checkIndirect());
+        if (!checkedVersion && isOnDiskCodeInvalid) {
+            // sync, but try to keep the current version on disk
+            const projectLock = context.lock.projects.find((p) => p.projectId === projectId);
+            const versionOnDisk = projectLock === null || projectLock === void 0 ? void 0 : projectLock.version;
+            deps_1.logger.warn(`Project '${projectName}' was synced by an incompatible version of Plasmic Codegen. Syncing again on the same version ${projectName}@${versionOnDisk}`);
+            meta.version = versionOnDisk !== null && versionOnDisk !== void 0 ? versionOnDisk : meta.version;
+            return true;
+        }
+        else if (checkedVersion) {
+            // sync and upgrade the version
+            return true;
+        }
+        else {
+            return false;
+        }
     });
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasmicapp/cli",
-  "version": "0.1.167",
+  "version": "0.1.171",
   "description": "plasmic cli for syncing local code with Plasmic designs",
   "engines": {
     "node": ">=12"
@@ -20,7 +20,7 @@
   },
   "devDependencies": {
     "@babel/preset-typescript": "^7.12.1",
-    "@plasmicapp/react-web": "^0.2.18",
+    "@plasmicapp/react-web": "^0.2.91",
     "@types/findup-sync": "^2.0.2",
     "@types/glob": "^7.1.3",
     "@types/inquirer": "^6.5.0",

package/src/__mocks__/api.ts

@@ -339,6 +339,7 @@ class PlasmicApi {
         iconChecksums: [],
         globalVariantChecksums: [],
         projectCssChecksum: "",
+        globalContextsChecksum: "",
       } as ChecksumBundle,
       usedNpmPackages: [],
       externalCssImports: [],
@@ -372,6 +373,10 @@ class PlasmicApi {
     throw new Error("Unimplemented");
   }
 
+  async latestCodegenVersion(): Promise<string> {
+    return "0.0.1";
+  }
+
   async requiredPackages(): Promise<RequiredPackages> {
     return {
       "@plasmicapp/loader": "0.0.1",

package/src/actions/fix-imports.ts

@@ -1,13 +1,12 @@
 import { CommonArgs } from "..";
 import { fixAllImportStatements } from "../utils/code-utils";
-import { fixAllFilePaths } from "../utils/file-utils";
+import { updateConfig } from "../utils/config-utils";
 import { getContext } from "../utils/get-context";
 
 export interface FixImportsArgs extends CommonArgs {}
 export async function fixImports(opts: FixImportsArgs) {
   if (!opts.baseDir) opts.baseDir = process.cwd();
   const context = await getContext(opts, { enableSkipAuth: true });
-
-  await fixAllFilePaths(context, opts.baseDir);
+  await updateConfig(context, context.config, opts.baseDir);
   await fixAllImportStatements(context, opts.baseDir);
 }

package/src/actions/sync-global-contexts.ts

@@ -0,0 +1,87 @@
+import { ChecksumBundle, ProjectMetaBundle } from "../api";
+import { logger } from "../deps";
+import { formatScript, tsxToJsx } from "../utils/code-utils";
+import L from "lodash";
+import {
+  PlasmicContext,
+  ProjectConfig,
+  ProjectLock,
+} from "../utils/config-utils";
+import {
+  defaultResourcePath,
+  deleteFile,
+  fileExists,
+  writeFileContent,
+} from "../utils/file-utils";
+
+const COMPONENT_NAME = "PlasmicGlobalContextsProvider";
+
+export async function syncGlobalContexts(
+  context: PlasmicContext,
+  projectMeta: ProjectMetaBundle,
+  projectConfig: ProjectConfig,
+  projectLock: ProjectLock,
+  checksums: ChecksumBundle,
+  baseDir: string
+) {
+  const resourcePath = getGlobalContextsResourcePath(context, projectConfig);
+  if (checksums.globalContextsChecksum && projectMeta.globalContextBundle) {
+    if (context.cliArgs.quiet !== true) {
+      logger.info(
+        `Syncing component: ${COMPONENT_NAME}@${projectLock.version}\t['${projectConfig.projectName}' ${projectConfig.projectId} ${projectConfig.version}]`
+      );
+    }
+    if (context.config.code.lang === "js") {
+      projectMeta.globalContextBundle.contextModule = formatScript(
+        tsxToJsx(projectMeta.globalContextBundle.contextModule),
+        baseDir
+      );
+    }
+    writeFileContent(
+      context,
+      resourcePath,
+      projectMeta.globalContextBundle.contextModule,
+      { force: false }
+    );
+    projectConfig.globalContextsFilePath = resourcePath;
+    const fl = projectLock.fileLocks.find(
+      (fl) =>
+        fl.assetId === projectConfig.projectId && fl.type === "globalContexts"
+    );
+    if (fl) {
+      fl.checksum = checksums.globalContextsChecksum;
+    } else {
+      projectLock.fileLocks.push({
+        assetId: projectConfig.projectId,
+        checksum: checksums.globalContextsChecksum,
+        type: "globalContexts",
+      });
+    }
+  } else if (
+    !checksums.globalContextsChecksum &&
+    !projectMeta.globalContextBundle
+  ) {
+    if (fileExists(context, resourcePath)) {
+      deleteFile(context, resourcePath);
+    }
+    projectConfig.globalContextsFilePath = "";
+    L.remove(
+      projectLock.fileLocks,
+      (fl) =>
+        fl.assetId === projectConfig.projectId && fl.type === "globalContexts"
+    );
+  }
+}
+
+export function getGlobalContextsResourcePath(
+  context: PlasmicContext,
+  projectConfig: ProjectConfig
+) {
+  return projectConfig.globalContextsFilePath !== ""
+    ? projectConfig.globalContextsFilePath
+    : defaultResourcePath(
+        context,
+        projectConfig,
+        `${COMPONENT_NAME}.${context.config.code.lang === "ts" ? "tsx" : "jsx"}`
+      );
+}

package/src/actions/sync.ts

@@ -64,6 +64,7 @@ import { syncGlobalVariants } from "./sync-global-variants";
 import { syncProjectIconAssets } from "./sync-icons";
 import { syncProjectImageAssets } from "./sync-images";
 import { upsertStyleTokens } from "./sync-styles";
+import { syncGlobalContexts } from "./sync-global-contexts";
 
 export interface SyncArgs extends CommonArgs {
   projects: readonly string[];
@@ -416,6 +417,16 @@ export async function sync(
       writeLoaderConfig(opts, config);
     }
 
+    const codegenVersion = await context.api.latestCodegenVersion();
+    context.lock.projects.forEach((p) => {
+      if (
+        projectsToSync.some(
+          (syncedProject) => syncedProject.projectId === p.projectId
+        )
+      ) {
+        p.codegenVersion = codegenVersion;
+      }
+    });
     // Write the new ComponentConfigs to disk
     await updateConfig(context, context.config, baseDir);
   });
@@ -781,6 +792,15 @@ async function syncProjectConfig(
     delete projectConfig.jsBundleThemes;
   }
 
+  await syncGlobalContexts(
+    context,
+    projectBundle,
+    projectConfig,
+    projectLock,
+    checksums,
+    baseDir
+  );
+
   // Write out components
   await syncProjectComponents(
     context,

package/src/api.ts

@@ -39,6 +39,11 @@ export interface GlobalVariantBundle {
   contextFileName: string;
 }
 
+export interface GlobalContextBundle {
+  id: string;
+  contextModule: string;
+}
+
 export interface JsBundleTheme {
   themeFileName: string;
   themeModule: string;
@@ -51,6 +56,7 @@ export interface ProjectMetaBundle {
   cssFileName: string;
   cssRules: string;
   jsBundleThemes?: JsBundleTheme[];
+  globalContextBundle?: GlobalContextBundle;
 }
 
 export interface IconBundle {
@@ -142,6 +148,8 @@ export interface ChecksumBundle {
   globalVariantChecksums: Array<[string, string]>;
   // Checksum of projectCss file
   projectCssChecksum: string;
+  // Checksum of project global contexts
+  globalContextsChecksum: string;
 }
 
 export interface CodeComponentMeta {
@@ -161,6 +169,7 @@ export interface ProjectIdAndToken {
 }
 
 export class PlasmicApi {
+  private codegenVersion?: string;
   constructor(private auth: AuthConfig) {}
 
   async genStyleConfig(styleOpts?: StyleConfig): Promise<StyleConfigResponse> {
@@ -213,6 +222,16 @@ export class PlasmicApi {
     return { ...resp.data } as RequiredPackages;
   }
 
+  async latestCodegenVersion(): Promise<string> {
+    if (!this.codegenVersion) {
+      const resp = await this.post(
+        `${this.codegenHost}/api/v1/code/latest-codegen-version`
+      );
+      this.codegenVersion = resp.data as string;
+    }
+    return this.codegenVersion;
+  }
+
   /**
    * Code-gen endpoint.
    * This will fetch components at an exact specified version.

package/src/test-common/fixtures.ts

@@ -148,6 +148,7 @@ export const project1Config: ProjectConfig = {
   images: [],
   jsBundleThemes: [],
   indirect: false,
+  globalContextsFilePath: "",
 };
 
 export function expectProject1PlasmicJson(

package/src/utils/checksum.ts

@@ -25,6 +25,7 @@ export function getChecksums(
       cssRulesChecksums: [],
       globalVariantChecksums: [],
       projectCssChecksum: "",
+      globalContextsChecksum: "",
     };
   }
 
@@ -95,6 +96,16 @@ export function getChecksums(
   const projectCssChecksum =
     projectCssChecksums.length > 0 ? projectCssChecksums[0].checksum : "";
 
+  const globalContextsChecksums = fileLocks.filter(
+    (fileLock) =>
+      fileLock.type === "globalContexts" && fileLock.assetId === projectId
+  );
+  assert(globalContextsChecksums.length < 2);
+  const globalContextsChecksum =
+    globalContextsChecksums.length > 0
+      ? globalContextsChecksums[0].checksum
+      : "";
+
   return {
     imageChecksums,
     iconChecksums,
@@ -102,5 +113,6 @@ export function getChecksums(
     cssRulesChecksums,
     globalVariantChecksums,
     projectCssChecksum,
+    globalContextsChecksum,
   };
 }

package/src/utils/code-utils.ts

@@ -8,6 +8,7 @@ import * as Prettier from "prettier";
 import { Options, resolveConfig } from "prettier";
 import * as ts from "typescript";
 import path from "upath";
+import { getGlobalContextsResourcePath } from "../actions/sync-global-contexts";
 import {
   fixComponentCssReferences,
   fixComponentImagesReferences,
@@ -17,6 +18,7 @@ import { HandledError } from "../utils/error";
 import {
   CodeComponentConfig,
   ComponentConfig,
+  CONFIG_FILE_NAME,
   GlobalVariantGroupConfig,
   IconConfig,
   ImageConfig,
@@ -473,6 +475,7 @@ export async function fixAllImportStatements(
       }
     }
   }
+  fixGlobalContextImportStatements(context, fixImportContext, baseDir);
 }
 
 async function fixComponentImportStatements(
@@ -484,6 +487,7 @@ async function fixComponentImportStatements(
 ) {
   // If ComponentConfig.importPath is still a local file, we best-effort also fix up the import statements there.
   if (
+    compConfig.type !== "mapped" &&
     isLocalModulePath(compConfig.importSpec.modulePath) &&
     fixSkeletonModule
   ) {
@@ -654,3 +658,42 @@ export const formatScript = (code: string, baseDir: string) => {
     useTabs: false,
   });
 };
+
+async function fixGlobalContextImportStatements(
+  context: PlasmicContext,
+  fixImportContext: FixImportContext,
+  baseDir: string
+) {
+  for (const project of context.config.projects) {
+    if (!project.globalContextsFilePath) continue;
+    const resourcePath = getGlobalContextsResourcePath(context, project);
+
+    let prevContent: string;
+    try {
+      prevContent = readFileText(
+        makeFilePath(context, resourcePath)
+      ).toString();
+    } catch (e) {
+      logger.warn(
+        `${resourcePath} is missing. If you deleted this component, remember to remove the component from ${CONFIG_FILE_NAME}`
+      );
+      throw e;
+    }
+
+    const newContent = replaceImports(
+      context,
+      prevContent,
+      resourcePath,
+      fixImportContext,
+      false,
+      baseDir,
+      true
+    );
+
+    if (prevContent !== newContent) {
+      await writeFileContent(context, resourcePath, newContent, {
+        force: true,
+      });
+    }
+  }
+}

package/src/utils/config-utils.ts

@@ -159,6 +159,8 @@ export interface ProjectConfig {
   version: string;
   /** File location for the project-wide css styles. Relative to srcDir */
   cssFilePath: string;
+  /** File location for the project-wide global contexts. Relative to srcDir */
+  globalContextsFilePath: string;
 
   // Code-component-related fields can be treated as optional not to be shown
   // to the users nor appear to be missing in the documentation.
@@ -197,6 +199,7 @@ export function createProjectConfig(base: {
     icons: [],
     images: [],
     indirect: base.indirect,
+    globalContextsFilePath: "",
   };
 }
 
@@ -299,7 +302,8 @@ export interface FileLock {
     | "icon"
     | "image"
     | "projectCss"
-    | "globalVariant";
+    | "globalVariant"
+    | "globalContexts";
   // The checksum value for the file
   checksum: string;
   // The component id, or the image asset id
@@ -318,6 +322,8 @@ export interface ProjectLock {
   lang: "ts" | "js";
   // One for each file whose checksum is computed
   fileLocks: FileLock[];
+  // The version of Codegen when this project was written
+  codegenVersion?: string;
 }
 
 export interface PlasmicLock {
@@ -528,6 +534,7 @@ export function getOrAddProjectConfig(
           images: [],
           jsBundleThemes: [],
           indirect: false,
+          globalContextsFilePath: "",
         };
     context.config.projects.push(project);
   }

package/src/utils/file-utils.ts

@@ -11,7 +11,6 @@ import {
   CONFIG_FILE_NAME,
   PlasmicContext,
   ProjectConfig,
-  updateConfig,
 } from "./config-utils";
 import { ensureString } from "./lang-utils";
 import { confirmWithUser } from "./user-utils";
@@ -242,6 +241,7 @@ function getAllPaths(context: PlasmicContext): BundleKeyPair[] {
 
   const pushProject = (proj: ProjectConfig) => {
     pushPath(proj, "cssFilePath");
+    pushPath(proj, "globalContextsFilePath");
     for (const component of proj.components) {
       pushComponent(component);
     }
@@ -278,43 +278,6 @@ function getAllPaths(context: PlasmicContext): BundleKeyPair[] {
   return pairs;
 }
 
-/**
- * Fixes all src-relative file paths in PlasmicConfig by detecting file
- * movement on disk.
- */
-export async function fixAllFilePaths(context: PlasmicContext, baseDir: string) {
-  const baseNameToFiles = buildBaseNameToFiles(context);
-  let changed = false;
-
-  const paths = getAllPaths(context);
-  for (const { bundle, key } of paths) {
-    const known = bundle[key];
-    // Check null and undefined
-    if (known == null) {
-      throw new HandledError(
-        `"${key} is required, but missing in ${CONFIG_FILE_NAME}. Please restore the file or delete from ${CONFIG_FILE_NAME} and run plasmic sync: ${bundle}"`
-      );
-    }
-    // Check falsey values (e.g. "")
-    if (!known) {
-      continue;
-    }
-    const found = findSrcDirPath(
-      context.absoluteSrcDir,
-      known,
-      baseNameToFiles
-    );
-    if (known !== found) {
-      bundle[key] = found;
-      changed = true;
-    }
-  }
-
-  if (changed) {
-    await updateConfig(context, context.config, baseDir);
-  }
-}
-
 /**
  * Throws an error if some file in PlasmicConfig is not inside the root
  * directory (i.e., the directory containing plasmic.json).

package/src/utils/get-context.ts

@@ -79,10 +79,7 @@ function removeMissingFilesFromLock(
         ])
       );
       const knownIcons = Object.fromEntries(
-        knownProjects[project.projectId].icons.map((icons) => [
-          icons.id,
-          icons,
-        ])
+        knownProjects[project.projectId].icons.map((icons) => [icons.id, icons])
       );
 
       project.fileLocks = project.fileLocks.filter((lock) => {
@@ -100,6 +97,8 @@ function removeMissingFilesFromLock(
             return knownImages[lock.assetId];
           case "icon":
             return knownIcons[lock.assetId];
+          case "globalContexts":
+            return knownProjects[project.projectId].globalContextsFilePath;
         }
       });
 
@@ -209,6 +208,16 @@ async function resolveMissingFilesInConfig(
         baseNameToFiles
       )) || "";
 
+    if (!project.globalContextsFilePath) {
+      project.globalContextsFilePath = "";
+    }
+    project.globalContextsFilePath =
+      (await attemptToRestoreFilePath(
+        context,
+        project.globalContextsFilePath,
+        baseNameToFiles
+      )) || "";
+
     project.images = await filterFiles(project.images, "filePath");
     project.icons = await filterFiles(project.icons, "moduleFilePath");
     project.jsBundleThemes = await filterFiles(

package/src/utils/resolve-utils.ts

@@ -68,6 +68,21 @@ async function checkProjectMeta(
   const newVersion = meta.version;
   const indirect = meta.indirect;
 
+  // If the codegen version on-disk is invalid, we will sync again the project.
+  const checkCodegenVersion = async (): Promise<boolean> => {
+    const projectLock = context.lock.projects.find(
+      (p) => p.projectId === projectId
+    );
+
+    if (!!projectLock?.codegenVersion && semver.gte(projectLock.codegenVersion, await context.api.latestCodegenVersion())) {
+      return false;
+    }
+
+    return true;
+  };
+
+  const isOnDiskCodeInvalid = await checkCodegenVersion();
+
   // Checks newVersion against plasmic.lock
   const checkVersionLock = async (): Promise<boolean> => {
     const projectLock = context.lock.projects.find(
@@ -87,9 +102,11 @@ async function checkProjectMeta(
     ) {
       // If this is a dependency (not root), and we're dealing with latest dep version
       // just skip, it's confusing
-      logger.warn(
-        `'${root.projectName}' depends on ${projectName}@${newVersion}. To update this project, explicitly specify this project for sync. Skipping...`
-      );
+      if (!isOnDiskCodeInvalid) {
+        logger.warn(
+          `'${root.projectName}' depends on ${projectName}@${newVersion}. To update this project, explicitly specify this project for sync. Skipping...`
+        );
+      }
       return false;
     }
 
@@ -111,9 +128,11 @@ async function checkProjectMeta(
         );
         return true;
       } else {
-        logger.info(
-          `Project '${projectName}'@${newVersion} is already up to date; skipping. (To force an update, run again with "--force")`
-        );
+        if (!isOnDiskCodeInvalid) { 
+          logger.info(
+            `Project '${projectName}'@${newVersion} is already up to date; skipping. (To force an update, run again with "--force")`
+          );
+        }
         return false;
       }
     }
@@ -211,12 +230,29 @@ async function checkProjectMeta(
     // we should always sync it, even if nothing has changed
     return true;
   }
-
-  return (
+  const checkedVersion = 
     (await checkVersionLock()) &&
     (await checkVersionRange()) &&
-    (await checkIndirect())
-  );
+    (await checkIndirect());
+
+ if(!checkedVersion && isOnDiskCodeInvalid) {
+    // sync, but try to keep the current version on disk
+    const projectLock = context.lock.projects.find(
+      (p) => p.projectId === projectId
+    );
+    const versionOnDisk = projectLock?.version;
+    logger.warn(
+      `Project '${projectName}' was synced by an incompatible version of Plasmic Codegen. Syncing again on the same version ${projectName}@${versionOnDisk}`
+    );
+    
+    meta.version = versionOnDisk ?? meta.version;
+    return true;
+  } else if (checkedVersion) {
+    // sync and upgrade the version
+    return true;
+  } else {
+    return false;
+  }
 }
 
 /**