@plasmicapp/cli 0.1.166 → 0.1.170

package/dist/__mocks__/api.js

@@ -249,7 +249,10 @@ class PlasmicApi {
                     iconChecksums: [],
                     globalVariantChecksums: [],
                     projectCssChecksum: "",
+                    globalContextsChecksum: "",
                 },
+                usedNpmPackages: [],
+                externalCssImports: [],
             };
             return result;
         });
@@ -274,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/__tests__/project-api-token-spec.js

@@ -51,20 +51,20 @@ describe("Project API tokens", () => {
         fixtures_1.tmpRepo.writePlasmicJson(Object.assign(Object.assign({}, fixtures_1.defaultPlasmicJson), { projects: [Object.assign(Object.assign({}, fixtures_1.project1Config), { projectApiToken: "blah" })] }));
         yield expect(sync_1.sync(fixtures_1.opts)).resolves.toBeUndefined();
         fixtures_1.expectProject1Components();
-        fixtures_1.expectProject1PlasmicJson();
+        fixtures_1.expectProject1PlasmicJson({ projectApiToken: true });
         // Re-run, this time with no auth.
         removeAuth();
-        yield expect(sync_1.sync(fixtures_1.opts)).resolves.toBeUndefined();
+        yield expect(sync_1.sync(fixtures_1.opts)).rejects.toThrow("No user+token, and project API tokens don't match");
     }));
     test("is filled in by auth'd user if project exists but token was initially missing", () => __awaiter(void 0, void 0, void 0, function* () {
         fixtures_1.opts.projects = ["projectId1"];
         fixtures_1.tmpRepo.writePlasmicJson(Object.assign(Object.assign({}, fixtures_1.defaultPlasmicJson), { projects: [fixtures_1.project1Config] }));
         yield expect(sync_1.sync(fixtures_1.opts)).resolves.toBeUndefined();
         fixtures_1.expectProject1Components();
-        fixtures_1.expectProject1PlasmicJson();
+        fixtures_1.expectProject1PlasmicJson({ projectApiToken: true });
         // Re-run, this time with no auth.
         removeAuth();
-        yield expect(sync_1.sync(fixtures_1.opts)).resolves.toBeUndefined();
+        yield expect(sync_1.sync(fixtures_1.opts)).rejects.toThrow("Unable to authenticate Plasmic. Please run 'plasmic auth' or check the projectApiTokens in your plasmic.json, and try again.");
     }));
     test("when not available, should prompt for auth", () => __awaiter(void 0, void 0, void 0, function* () {
         fixtures_1.opts.projects = ["projectId1"];

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();
@@ -208,13 +209,15 @@ function sync(opts, metadataDefaults) {
             ...versionResolution.dependencies,
         ].map((p) => lodash_1.default.pick(p, "projectId", "projectApiToken"));
         context.api.attachProjectIdsAndTokens(projectIdsAndTokens);
+        const externalNpmPackages = new Set();
+        const externalCssImports = new Set();
         // Perform the actual sync
         yield file_utils_1.withBufferedFs(() => __awaiter(this, void 0, void 0, function* () {
             var _b;
             // Sync in sequence (no parallelism)
             // going in reverse to get leaves of the dependency tree first
             for (const projectMeta of projectsToSync) {
-                yield syncProject(context, opts, projectIdsAndTokens, projectMeta.projectId, projectMeta.componentIds, projectMeta.version, projectMeta.dependencies, summary, pendingMerge, projectMeta.indirect, metadataDefaults);
+                yield syncProject(context, opts, projectIdsAndTokens, projectMeta.projectId, projectMeta.componentIds, projectMeta.version, projectMeta.dependencies, summary, pendingMerge, projectMeta.indirect, externalNpmPackages, externalCssImports, metadataDefaults);
             }
             // Materialize scheme into each component config.
             context.config.projects.forEach((p) => p.components.forEach((c) => {
@@ -255,9 +258,22 @@ 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);
         }));
+        yield checkExternalPkgs(context, baseDir, opts, Array.from(externalNpmPackages.keys()));
+        if (!opts.quiet && externalCssImports.size > 0) {
+            deps_1.logger.info(`This project uses external packages and styles. Make sure to import the following global CSS: ` +
+                Array.from(externalCssImports.keys())
+                    .map((stmt) => `"${stmt}"`)
+                    .join(", "));
+        }
         // Post-sync commands
         if (!opts.ignorePostSync) {
             for (const cmd of context.config.postSyncCommands || []) {
@@ -272,6 +288,20 @@ function sync(opts, metadataDefaults) {
     });
 }
 exports.sync = sync;
+function checkExternalPkgs(context, baseDir, opts, pkgs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const missingPkgs = pkgs.filter((pkg) => {
+            const installedPkg = npm_utils_1.findInstalledVersion(context, baseDir, pkg);
+            return !installedPkg;
+        });
+        if (missingPkgs.length > 0) {
+            const upgrade = yield user_utils_1.confirmWithUser(`The following packages aren't installed but are required by some projects, would you like to install them? ${missingPkgs.join(", ")}`, opts.yes);
+            if (upgrade) {
+                npm_utils_1.installUpgrade(missingPkgs.join(" "), baseDir);
+            }
+        }
+    });
+}
 function maybeRenamePathExt(context, path, ext) {
     if (!path) {
         return path;
@@ -292,7 +322,7 @@ function fixFileExtension(context) {
         });
     });
 }
-function syncProject(context, opts, projectIdsAndTokens, projectId, componentIds, projectVersion, dependencies, summary, pendingMerge, indirect, metadataDefaults) {
+function syncProject(context, opts, projectIdsAndTokens, projectId, componentIds, projectVersion, dependencies, summary, pendingMerge, indirect, externalNpmPackages, externalCssImports, metadataDefaults) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
         const newComponentScheme = opts.newComponentScheme || context.config.code.scheme;
@@ -336,6 +366,8 @@ function syncProject(context, opts, projectIdsAndTokens, projectId, componentIds
         yield sync_styles_1.upsertStyleTokens(context, projectBundle.usedTokens);
         yield sync_icons_1.syncProjectIconAssets(context, projectId, projectVersion, projectBundle.iconAssets, projectBundle.checksums, opts.baseDir);
         yield sync_images_1.syncProjectImageAssets(context, projectId, projectVersion, projectBundle.imageAssets, projectBundle.checksums);
+        (projectBundle.usedNpmPackages || []).forEach((pkg) => externalNpmPackages.add(pkg));
+        (projectBundle.externalCssImports || []).forEach((css) => externalCssImports.add(css));
     });
 }
 function syncStyleConfig(context, response) {
@@ -365,7 +397,6 @@ function syncProjectConfig(context, projectBundle, projectApiToken, version, dep
         if (!projectConfig.cssFilePath) {
             projectConfig.cssFilePath = defaultCssFilePath;
         }
-        projectConfig.projectApiToken = projectApiToken;
         // plasmic.lock
         const projectLock = config_utils_1.getOrAddProjectLock(context, projectConfig.projectId);
         projectLock.version = version;
@@ -414,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;
@@ -80,6 +85,8 @@ export interface ProjectBundle {
     iconAssets: IconBundle[];
     imageAssets: ImageBundle[];
     checksums: ChecksumBundle;
+    usedNpmPackages: string[];
+    externalCssImports: string[];
 }
 export declare type ProjectMeta = Omit<ProjectBundle, "projectConfig">;
 export interface StyleConfigResponse {
@@ -109,6 +116,7 @@ export interface ChecksumBundle {
     iconChecksums: Array<[string, string]>;
     globalVariantChecksums: Array<[string, string]>;
     projectCssChecksum: string;
+    globalContextsChecksum: string;
 }
 export interface CodeComponentMeta {
     id: string;
@@ -125,6 +133,7 @@ export interface ProjectIdAndToken {
 }
 export declare class PlasmicApi {
     private auth;
+    private codegenVersion?;
     constructor(auth: AuthConfig);
     genStyleConfig(styleOpts?: StyleConfig): Promise<StyleConfigResponse>;
     /**
@@ -144,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/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.d.ts

@@ -9,5 +9,7 @@ export declare function standardTestSetup(includeDep?: boolean): void;
 export declare function standardTestTeardown(): void;
 export declare function expectProject1Components(): void;
 export declare const project1Config: ProjectConfig;
-export declare function expectProject1PlasmicJson(): void;
+export declare function expectProject1PlasmicJson(optional?: {
+    [k in keyof ProjectConfig]?: boolean;
+}): void;
 export declare function expectProjectAndDepPlasmicJson(): void;

package/dist/test-common/fixtures.js

@@ -139,12 +139,15 @@ exports.project1Config = {
     images: [],
     jsBundleThemes: [],
     indirect: false,
+    globalContextsFilePath: "",
 };
-function expectProject1PlasmicJson() {
+function expectProject1PlasmicJson(optional) {
     const plasmicJson = exports.tmpRepo.readPlasmicJson();
     expect(plasmicJson.projects.length).toEqual(1);
     const projectConfig = plasmicJson.projects[0];
-    expect(projectConfig.projectApiToken).toBe("abc");
+    if (!(optional === null || optional === void 0 ? void 0 : optional.projectApiToken)) {
+        expect(projectConfig.projectApiToken).toBe("abc");
+    }
     expect(projectConfig.components.length).toEqual(2);
     const componentNames = projectConfig.components.map((c) => c.name);
     expect(componentNames).toContain("Button");

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,6 +343,7 @@ function fixAllImportStatements(context, baseDir, summary) {
                 }
             }
         }
+        fixGlobalContextImportStatements(context, fixImportContext, baseDir);
     });
 }
 exports.fixAllImportStatements = fixAllImportStatements;
@@ -455,3 +458,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.js

@@ -188,6 +188,7 @@ function getAllPaths(context) {
     };
     const pushProject = (proj) => {
         pushPath(proj, "cssFilePath");
+        pushPath(proj, "globalContextsFilePath");
         for (const component of proj.components) {
             pushComponent(component);
         }

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.166",
+  "version": "0.1.170",
   "description": "plasmic cli for syncing local code with Plasmic designs",
   "engines": {
     "node": ">=12"

package/src/__mocks__/api.ts

@@ -339,7 +339,10 @@ class PlasmicApi {
         iconChecksums: [],
         globalVariantChecksums: [],
         projectCssChecksum: "",
+        globalContextsChecksum: "",
       } as ChecksumBundle,
+      usedNpmPackages: [],
+      externalCssImports: [],
     };
     return result;
   }
@@ -370,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/__tests__/project-api-token-spec.ts

@@ -71,11 +71,13 @@ describe("Project API tokens", () => {
 
     expectProject1Components();
 
-    expectProject1PlasmicJson();
+    expectProject1PlasmicJson({ projectApiToken: true });
 
     // Re-run, this time with no auth.
     removeAuth();
-    await expect(sync(opts)).resolves.toBeUndefined();
+    await expect(sync(opts)).rejects.toThrow(
+      "No user+token, and project API tokens don't match"
+    );
   });
 
   test("is filled in by auth'd user if project exists but token was initially missing", async () => {
@@ -88,11 +90,13 @@ describe("Project API tokens", () => {
 
     expectProject1Components();
 
-    expectProject1PlasmicJson();
+    expectProject1PlasmicJson({ projectApiToken: true });
 
     // Re-run, this time with no auth.
     removeAuth();
-    await expect(sync(opts)).resolves.toBeUndefined();
+    await expect(sync(opts)).rejects.toThrow(
+      "Unable to authenticate Plasmic. Please run 'plasmic auth' or check the projectApiTokens in your plasmic.json, and try again."
+    );
   });
 
   test("when not available, should prompt for auth", async () => {

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[];
@@ -315,6 +316,8 @@ export async function sync(
   ].map((p) => L.pick(p, "projectId", "projectApiToken"));
 
   context.api.attachProjectIdsAndTokens(projectIdsAndTokens);
+  const externalNpmPackages = new Set<string>();
+  const externalCssImports = new Set<string>();
 
   // Perform the actual sync
   await withBufferedFs(async () => {
@@ -332,6 +335,8 @@ export async function sync(
         summary,
         pendingMerge,
         projectMeta.indirect,
+        externalNpmPackages,
+        externalCssImports,
         metadataDefaults
       );
     }
@@ -412,10 +417,36 @@ 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);
   });
 
+  await checkExternalPkgs(
+    context,
+    baseDir,
+    opts,
+    Array.from(externalNpmPackages.keys())
+  );
+
+  if (!opts.quiet && externalCssImports.size > 0) {
+    logger.info(
+      `This project uses external packages and styles. Make sure to import the following global CSS: ` +
+        Array.from(externalCssImports.keys())
+          .map((stmt) => `"${stmt}"`)
+          .join(", ")
+    );
+  }
+
   // Post-sync commands
   if (!opts.ignorePostSync) {
     for (const cmd of context.config.postSyncCommands || []) {
@@ -430,6 +461,30 @@ export async function sync(
   }
 }
 
+async function checkExternalPkgs(
+  context: PlasmicContext,
+  baseDir: string,
+  opts: SyncArgs,
+  pkgs: string[]
+) {
+  const missingPkgs = pkgs.filter((pkg) => {
+    const installedPkg = findInstalledVersion(context, baseDir, pkg);
+    return !installedPkg;
+  });
+  if (missingPkgs.length > 0) {
+    const upgrade = await confirmWithUser(
+      `The following packages aren't installed but are required by some projects, would you like to install them? ${missingPkgs.join(
+        ", "
+      )}`,
+      opts.yes
+    );
+
+    if (upgrade) {
+      installUpgrade(missingPkgs.join(" "), baseDir);
+    }
+  }
+}
+
 function maybeRenamePathExt(
   context: PlasmicContext,
   path: string,
@@ -480,6 +535,8 @@ async function syncProject(
   summary: Map<string, ComponentUpdateSummary>,
   pendingMerge: ComponentPendingMerge[],
   indirect: boolean,
+  externalNpmPackages: Set<string>,
+  externalCssImports: Set<string>,
   metadataDefaults?: Metadata
 ): Promise<void> {
   const newComponentScheme =
@@ -602,6 +659,12 @@ async function syncProject(
     projectBundle.imageAssets,
     projectBundle.checksums
   );
+  (projectBundle.usedNpmPackages || []).forEach((pkg) =>
+    externalNpmPackages.add(pkg)
+  );
+  (projectBundle.externalCssImports || []).forEach((css) =>
+    externalCssImports.add(css)
+  );
 }
 
 async function syncStyleConfig(
@@ -662,7 +725,6 @@ async function syncProjectConfig(
   if (!projectConfig.cssFilePath) {
     projectConfig.cssFilePath = defaultCssFilePath;
   }
-  projectConfig.projectApiToken = projectApiToken;
 
   // plasmic.lock
   const projectLock = getOrAddProjectLock(context, projectConfig.projectId);
@@ -730,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 {
@@ -101,6 +107,8 @@ export interface ProjectBundle {
   iconAssets: IconBundle[];
   imageAssets: ImageBundle[];
   checksums: ChecksumBundle;
+  usedNpmPackages: string[];
+  externalCssImports: string[];
 }
 
 export type ProjectMeta = Omit<ProjectBundle, "projectConfig">;
@@ -140,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 {
@@ -159,6 +169,7 @@ export interface ProjectIdAndToken {
 }
 
 export class PlasmicApi {
+  private codegenVersion?: string;
   constructor(private auth: AuthConfig) {}
 
   async genStyleConfig(styleOpts?: StyleConfig): Promise<StyleConfigResponse> {
@@ -211,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,13 +148,18 @@ export const project1Config: ProjectConfig = {
   images: [],
   jsBundleThemes: [],
   indirect: false,
+  globalContextsFilePath: "",
 };
 
-export function expectProject1PlasmicJson() {
+export function expectProject1PlasmicJson(
+  optional?: { [k in keyof ProjectConfig]?: boolean }
+) {
   const plasmicJson = tmpRepo.readPlasmicJson();
   expect(plasmicJson.projects.length).toEqual(1);
   const projectConfig = plasmicJson.projects[0];
-  expect(projectConfig.projectApiToken).toBe("abc");
+  if (!optional?.projectApiToken) {
+    expect(projectConfig.projectApiToken).toBe("abc");
+  }
   expect(projectConfig.components.length).toEqual(2);
   const componentNames = projectConfig.components.map((c) => c.name);
   expect(componentNames).toContain("Button");

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(
@@ -654,3 +657,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

@@ -242,6 +242,7 @@ function getAllPaths(context: PlasmicContext): BundleKeyPair[] {
 
   const pushProject = (proj: ProjectConfig) => {
     pushPath(proj, "cssFilePath");
+    pushPath(proj, "globalContextsFilePath");
     for (const component of proj.components) {
       pushComponent(component);
     }
@@ -282,7 +283,10 @@ function getAllPaths(context: PlasmicContext): BundleKeyPair[] {
  * Fixes all src-relative file paths in PlasmicConfig by detecting file
  * movement on disk.
  */
-export async function fixAllFilePaths(context: PlasmicContext, baseDir: string) {
+export async function fixAllFilePaths(
+  context: PlasmicContext,
+  baseDir: string
+) {
   const baseNameToFiles = buildBaseNameToFiles(context);
   let changed = false;
 

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;
+  }
 }
 
 /**