@plasmicapp/cli 0.1.313 → 0.1.314

package/dist/api.d.ts

@@ -1,5 +1,5 @@
 import { Socket } from "socket.io-client";
-import { AuthConfig, CodeConfig, I18NConfig, ImagesConfig, StyleConfig } from "./utils/config-utils";
+import { AuthConfig, CodeConfig, CustomFunctionConfig, I18NConfig, ImagesConfig, StyleConfig } from "./utils/config-utils";
 import { Metadata } from "./utils/get-context";
 export declare class AppServerError extends Error {
     constructor(message: string);
@@ -88,6 +88,7 @@ export interface ProjectMetaInfo {
 export interface ProjectBundle {
     components: ComponentBundle[];
     codeComponentMetas: CodeComponentMeta[];
+    customFunctionMetas: CustomFunctionConfig[];
     projectConfig: ProjectMetaBundle;
     globalVariants: GlobalVariantBundle[];
     usedTokens: StyleTokensMap;

package/dist/index.js

@@ -498381,6 +498381,30 @@ function ensureImportSpecifierWithAlias(decl, imported, alias) {
     );
   }
 }
+var validJsIdentifierChars = [
+  "\\u0621-\\u064A",
+  // arabic
+  "\\u3400-\\u4DB5",
+  // chinese
+  "\\u4E00-\\u9FCC",
+  // chinese
+  "\\u0400-\\u04FF",
+  // cyrillic
+  "\\u0370-\\u03ff",
+  // greek
+  "\\u1f00-\\u1fff",
+  // greek
+  "\\u0900-\\u097F",
+  // hindi
+  "\\u3041-\\u3094",
+  // japanese
+  "\\u30A1-\\u30FB",
+  // japanese
+  "\\u0E00-\\u0E7F",
+  // thai
+  "\\w",
+  "-_"
+];
 function tryParsePlasmicImportSpec(node) {
   var _a;
   const c = (_a = node.trailingComments) == null ? void 0 : _a[0];
@@ -498388,7 +498412,14 @@ function tryParsePlasmicImportSpec(node) {
     return void 0;
   }
   const m = c.value.match(
-    /plasmic-import:\s+([\w-]+)(?:\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext))?/
+    new RegExp(
+      [
+        "plasmic-import:\\s+([",
+        ...validJsIdentifierChars,
+        "\\.",
+        "]+)(?:\\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext|customFunction))?"
+      ].join("")
+    )
   );
   if (m) {
     return { id: m[1], type: m[2] };
@@ -498567,6 +498598,21 @@ function replaceImports(context, code, fromPath, fixImportContext, removeImportD
         true
       );
       stmt.source.value = realPath;
+    } else if (type === "customFunction") {
+      const meta = fixImportContext.customFunctionMetas[uuid];
+      if (!(meta == null ? void 0 : meta.importPath)) {
+        throw new HandledError(
+          `Encountered custom function "${uuid}" that was not registered with an importPath, so we don't know where to import this function from. Please see https://docs.plasmic.app/learn/code-components-ref/`
+        );
+      }
+      if (meta.importPath[0] === ".") {
+        const toPath = import_upath2.default.join(context.rootDir, meta.importPath);
+        assert(import_upath2.default.isAbsolute(toPath));
+        const realPath = makeImportPath(context, fromPath, toPath, true, true);
+        stmt.source.value = realPath;
+      } else {
+        stmt.source.value = meta.importPath;
+      }
     }
   });
   if (!changed) {
@@ -498611,7 +498657,15 @@ var mkFixImportContext = (config) => {
     config.projects,
     (p) => p.codeComponents || []
   );
+  const allCustomFunctions = flatMap(
+    config.projects,
+    (p) => {
+      var _a;
+      return (_a = p.customFunctions) != null ? _a : [];
+    }
+  );
   const codeComponentMetas = import_lodash4.default.keyBy(allCodeComponents, (c) => c.id);
+  const customFunctionMetas = import_lodash4.default.keyBy(allCustomFunctions, (fn) => fn.id);
   const globalVariants = import_lodash4.default.keyBy(
     config.globalVariants.variantGroups,
     (c) => c.id
@@ -498629,6 +498683,7 @@ var mkFixImportContext = (config) => {
     config,
     components,
     codeComponentMetas,
+    customFunctionMetas,
     globalVariants,
     icons,
     images,
@@ -502411,6 +502466,11 @@ async function syncProject(context, opts, projectIdsAndTokens, projectId, branch
     indirect
   );
   syncCodeComponentsMeta(context, projectId, projectBundle.codeComponentMetas);
+  await syncCustomFunctionsMeta(
+    context,
+    projectId,
+    projectBundle.customFunctionMetas
+  );
   await upsertStyleTokens(
     context,
     projectBundle.usedTokens,
@@ -502544,6 +502604,19 @@ function syncCodeComponentsMeta(context, projectId, codeComponentBundles) {
     } : {}
   }));
 }
+function syncCustomFunctionsMeta(context, projectId, customFunctionBundles) {
+  const projectConfig = getOrAddProjectConfig(context, projectId);
+  projectConfig.customFunctions = customFunctionBundles.map((meta) => {
+    var _a;
+    return {
+      defaultExport: meta.defaultExport,
+      id: meta.id,
+      importPath: meta.importPath,
+      name: meta.name,
+      namespace: (_a = meta.namespace) != null ? _a : null
+    };
+  });
+}
 
 // src/actions/upload-bundle.ts
 var import_pako = __toESM(require_pako());
@@ -502781,6 +502854,7 @@ async function exportProjectsCli(opts) {
           })
         },
         projects: result.map((bundle) => {
+          var _a2;
           const projectName = (0, import_lodash19.snakeCase)(bundle.projectConfig.projectName);
           return {
             projectId: bundle.projectConfig.projectId,
@@ -502809,6 +502883,18 @@ async function exportProjectsCli(opts) {
               componentImportPath: comp.importPath,
               helper: comp.helper
             })),
+            customFunctionMetas: ((_a2 = bundle.customFunctionMetas) != null ? _a2 : []).map(
+              (meta) => {
+                var _a3;
+                return {
+                  id: meta.id,
+                  name: meta.name,
+                  importPath: meta.importPath,
+                  defaultExport: meta.defaultExport,
+                  namespace: (_a3 = meta.namespace) != null ? _a3 : null
+                };
+              }
+            ),
             icons: bundle.iconAssets.map((icon) => ({
               id: icon.id,
               name: icon.name,

package/dist/lib.js

@@ -493723,6 +493723,30 @@ function ensureImportSpecifierWithAlias(decl, imported, alias) {
     );
   }
 }
+var validJsIdentifierChars = [
+  "\\u0621-\\u064A",
+  // arabic
+  "\\u3400-\\u4DB5",
+  // chinese
+  "\\u4E00-\\u9FCC",
+  // chinese
+  "\\u0400-\\u04FF",
+  // cyrillic
+  "\\u0370-\\u03ff",
+  // greek
+  "\\u1f00-\\u1fff",
+  // greek
+  "\\u0900-\\u097F",
+  // hindi
+  "\\u3041-\\u3094",
+  // japanese
+  "\\u30A1-\\u30FB",
+  // japanese
+  "\\u0E00-\\u0E7F",
+  // thai
+  "\\w",
+  "-_"
+];
 function tryParsePlasmicImportSpec(node) {
   var _a;
   const c = (_a = node.trailingComments) == null ? void 0 : _a[0];
@@ -493730,7 +493754,14 @@ function tryParsePlasmicImportSpec(node) {
     return void 0;
   }
   const m = c.value.match(
-    /plasmic-import:\s+([\w-]+)(?:\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext))?/
+    new RegExp(
+      [
+        "plasmic-import:\\s+([",
+        ...validJsIdentifierChars,
+        "\\.",
+        "]+)(?:\\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext|customFunction))?"
+      ].join("")
+    )
   );
   if (m) {
     return { id: m[1], type: m[2] };
@@ -493909,6 +493940,21 @@ function replaceImports(context, code, fromPath, fixImportContext, removeImportD
         true
       );
       stmt.source.value = realPath;
+    } else if (type === "customFunction") {
+      const meta = fixImportContext.customFunctionMetas[uuid];
+      if (!(meta == null ? void 0 : meta.importPath)) {
+        throw new HandledError(
+          `Encountered custom function "${uuid}" that was not registered with an importPath, so we don't know where to import this function from. Please see https://docs.plasmic.app/learn/code-components-ref/`
+        );
+      }
+      if (meta.importPath[0] === ".") {
+        const toPath = import_upath2.default.join(context.rootDir, meta.importPath);
+        assert(import_upath2.default.isAbsolute(toPath));
+        const realPath = makeImportPath(context, fromPath, toPath, true, true);
+        stmt.source.value = realPath;
+      } else {
+        stmt.source.value = meta.importPath;
+      }
     }
   });
   if (!changed) {
@@ -493953,7 +493999,15 @@ var mkFixImportContext = (config) => {
     config.projects,
     (p) => p.codeComponents || []
   );
+  const allCustomFunctions = flatMap(
+    config.projects,
+    (p) => {
+      var _a;
+      return (_a = p.customFunctions) != null ? _a : [];
+    }
+  );
   const codeComponentMetas = import_lodash4.default.keyBy(allCodeComponents, (c) => c.id);
+  const customFunctionMetas = import_lodash4.default.keyBy(allCustomFunctions, (fn) => fn.id);
   const globalVariants = import_lodash4.default.keyBy(
     config.globalVariants.variantGroups,
     (c) => c.id
@@ -493971,6 +494025,7 @@ var mkFixImportContext = (config) => {
     config,
     components,
     codeComponentMetas,
+    customFunctionMetas,
     globalVariants,
     icons,
     images,
@@ -497709,6 +497764,11 @@ async function syncProject(context, opts, projectIdsAndTokens, projectId, branch
     indirect
   );
   syncCodeComponentsMeta(context, projectId, projectBundle.codeComponentMetas);
+  await syncCustomFunctionsMeta(
+    context,
+    projectId,
+    projectBundle.customFunctionMetas
+  );
   await upsertStyleTokens(
     context,
     projectBundle.usedTokens,
@@ -497842,6 +497902,19 @@ function syncCodeComponentsMeta(context, projectId, codeComponentBundles) {
     } : {}
   }));
 }
+function syncCustomFunctionsMeta(context, projectId, customFunctionBundles) {
+  const projectConfig = getOrAddProjectConfig(context, projectId);
+  projectConfig.customFunctions = customFunctionBundles.map((meta) => {
+    var _a;
+    return {
+      defaultExport: meta.defaultExport,
+      id: meta.id,
+      importPath: meta.importPath,
+      name: meta.name,
+      namespace: (_a = meta.namespace) != null ? _a : null
+    };
+  });
+}
 
 // src/actions/upload-bundle.ts
 var import_pako = __toESM(require_pako());
@@ -498174,6 +498247,7 @@ async function exportProjectsCli(opts) {
           })
         },
         projects: result.map((bundle) => {
+          var _a2;
           const projectName = (0, import_lodash20.snakeCase)(bundle.projectConfig.projectName);
           return {
             projectId: bundle.projectConfig.projectId,
@@ -498202,6 +498276,18 @@ async function exportProjectsCli(opts) {
               componentImportPath: comp.importPath,
               helper: comp.helper
             })),
+            customFunctionMetas: ((_a2 = bundle.customFunctionMetas) != null ? _a2 : []).map(
+              (meta) => {
+                var _a3;
+                return {
+                  id: meta.id,
+                  name: meta.name,
+                  importPath: meta.importPath,
+                  defaultExport: meta.defaultExport,
+                  namespace: (_a3 = meta.namespace) != null ? _a3 : null
+                };
+              }
+            ),
             icons: bundle.iconAssets.map((icon) => ({
               id: icon.id,
               name: icon.name,

package/dist/plasmic.schema.json

@@ -142,6 +142,35 @@
             ],
             "type": "object"
         },
+        "CustomFunctionConfig": {
+            "properties": {
+                "defaultExport": {
+                    "type": "boolean"
+                },
+                "id": {
+                    "type": "string"
+                },
+                "importPath": {
+                    "type": "string"
+                },
+                "name": {
+                    "type": "string"
+                },
+                "namespace": {
+                    "type": [
+                        "null",
+                        "string"
+                    ]
+                }
+            },
+            "required": [
+                "defaultExport",
+                "id",
+                "importPath",
+                "name"
+            ],
+            "type": "object"
+        },
         "GlobalVariantGroupConfig": {
             "properties": {
                 "contextFilePath": {
@@ -325,6 +354,12 @@
                     "description": "File location for the project-wide css styles. Relative to srcDir",
                     "type": "string"
                 },
+                "customFunctions": {
+                    "items": {
+                        "$ref": "#/definitions/CustomFunctionConfig"
+                    },
+                    "type": "array"
+                },
                 "globalContextsFilePath": {
                     "description": "File location for the project-wide global contexts. Relative to srcDir",
                     "type": "string"

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

@@ -1,7 +1,6 @@
 import { ImportDeclaration } from "@babel/types";
-import L from "lodash";
 import { Options } from "prettier";
-import { CodeComponentConfig, ComponentConfig, GlobalVariantGroupConfig, IconConfig, ImageConfig, PlasmicConfig, PlasmicContext, ProjectConfig } from "./config-utils";
+import { CodeComponentConfig, ComponentConfig, CustomFunctionConfig, GlobalVariantGroupConfig, IconConfig, ImageConfig, PlasmicConfig, PlasmicContext, ProjectConfig } from "./config-utils";
 export declare const formatAsLocal: (content: string, filePath: string, baseDir: string, defaultOpts?: Options) => string;
 export declare function ensureImportSpecifierWithAlias(decl: ImportDeclaration, imported: string, alias: string): void;
 export declare function ensureImportDefaultSpecifier(decl: ImportDeclaration, defaultExport: string): void;
@@ -22,20 +21,13 @@ export interface FixImportContext {
     config: PlasmicConfig;
     components: Record<string, ComponentConfig>;
     codeComponentMetas: Record<string, CodeComponentConfig>;
+    customFunctionMetas: Record<string, CustomFunctionConfig>;
     globalVariants: Record<string, GlobalVariantGroupConfig>;
     icons: Record<string, IconConfig>;
     images: Record<string, ImageConfig>;
     projects: Record<string, ProjectConfig>;
 }
-export declare const mkFixImportContext: (config: PlasmicConfig) => {
-    config: PlasmicConfig;
-    components: L.Dictionary<ComponentConfig>;
-    codeComponentMetas: L.Dictionary<CodeComponentConfig>;
-    globalVariants: L.Dictionary<GlobalVariantGroupConfig>;
-    icons: L.Dictionary<IconConfig>;
-    images: L.Dictionary<ImageConfig>;
-    projects: L.Dictionary<ProjectConfig>;
-};
+export declare const mkFixImportContext: (config: PlasmicConfig) => FixImportContext;
 /**
  * Assuming that all the files referenced in PlasmicConfig are correct, fixes import statements using PlasmicConfig
  * file locations as the source of truth.

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

@@ -108,6 +108,13 @@ export interface CodeComponentConfig {
         importPath: string;
     };
 }
+export interface CustomFunctionConfig {
+    id: string;
+    name: string;
+    namespace?: string | null;
+    importPath: string;
+    defaultExport: boolean;
+}
 export interface ProjectConfig {
     /** Project ID */
     projectId: string;
@@ -130,6 +137,7 @@ export interface ProjectConfig {
     globalContextsFilePath: string;
     jsBundleThemes?: JsBundleThemeConfig[];
     codeComponents?: CodeComponentConfig[];
+    customFunctions?: CustomFunctionConfig[];
     /** Metadata for each synced component in this project. */
     components: ComponentConfig[];
     /** Metadata for each synced icon in this project */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasmicapp/cli",
-  "version": "0.1.313",
+  "version": "0.1.314",
   "description": "plasmic cli for syncing local code with Plasmic designs",
   "engines": {
     "node": ">=12"
@@ -78,5 +78,5 @@
     "wrap-ansi": "^7.0.0",
     "yargs": "^15.4.1"
   },
-  "gitHead": "388b5829f67de3782fe8afdad0d153b5c6d0aac0"
+  "gitHead": "6e966ef24adb9af472b56a5051faf2b8e6e04f12"
 }

package/src/__mocks__/api.ts

@@ -341,6 +341,7 @@ class PlasmicApi {
     const result = {
       components,
       codeComponentMetas: [],
+      customFunctionMetas: [],
       projectConfig: genProjectMetaBundle(projectId),
       globalVariants: [],
       usedTokens: genEmptyStyleTokensMap(),

package/src/actions/export.ts

@@ -10,11 +10,11 @@ import {
 } from "../utils/code-utils";
 import {
   CodeConfig,
+  findConfigFile,
   I18NConfig,
   ImagesConfig,
   PlasmicConfig,
   StyleConfig,
-  findConfigFile,
 } from "../utils/config-utils";
 import { getContext, getCurrentOrDefaultAuth } from "../utils/get-context";
 import { tuple } from "../utils/lang-utils";
@@ -200,6 +200,15 @@ export async function exportProjectsCli(opts: ExportArgs): Promise<void> {
               componentImportPath: comp.importPath,
               helper: comp.helper,
             })),
+            customFunctionMetas: (bundle.customFunctionMetas ?? []).map(
+              (meta) => ({
+                id: meta.id,
+                name: meta.name,
+                importPath: meta.importPath,
+                defaultExport: meta.defaultExport,
+                namespace: meta.namespace ?? null,
+              })
+            ),
             icons: bundle.iconAssets.map((icon) => ({
               id: icon.id,
               name: icon.name,

package/src/actions/sync.ts

@@ -22,25 +22,23 @@ import {
 } from "../utils/code-utils";
 import {
   CONFIG_FILE_NAME,
-  PlasmicContext,
   createProjectConfig,
+  CustomFunctionConfig,
   getOrAddProjectConfig,
   getOrAddProjectLock,
+  PlasmicContext,
   updateConfig,
 } from "../utils/config-utils";
 import { HandledError } from "../utils/error";
 import {
   assertAllPathsInRootDir,
   defaultResourcePath,
-  existsBuffered,
-  readFileText,
   renameFile,
   stripExtension,
   withBufferedFs,
   writeFileContent,
-  writeFileText,
 } from "../utils/file-utils";
-import { Metadata, generateMetadata, getContext } from "../utils/get-context";
+import { generateMetadata, getContext, Metadata } from "../utils/get-context";
 import { printFirstSyncInfo } from "../utils/help";
 import { ensure, tuple } from "../utils/lang-utils";
 import {
@@ -604,6 +602,11 @@ async function syncProject(
     indirect
   );
   syncCodeComponentsMeta(context, projectId, projectBundle.codeComponentMetas);
+  await syncCustomFunctionsMeta(
+    context,
+    projectId,
+    projectBundle.customFunctionMetas
+  );
   await upsertStyleTokens(
     context,
     projectBundle.usedTokens,
@@ -807,3 +810,18 @@ function syncCodeComponentsMeta(
       : {}),
   }));
 }
+
+function syncCustomFunctionsMeta(
+  context: PlasmicContext,
+  projectId: string,
+  customFunctionBundles: CustomFunctionConfig[]
+) {
+  const projectConfig = getOrAddProjectConfig(context, projectId);
+  projectConfig.customFunctions = customFunctionBundles.map((meta) => ({
+    defaultExport: meta.defaultExport,
+    id: meta.id,
+    importPath: meta.importPath,
+    name: meta.name,
+    namespace: meta.namespace ?? null,
+  }));
+}

package/src/api.ts

@@ -3,6 +3,7 @@ import socketio, { Socket } from "socket.io-client";
 import {
   AuthConfig,
   CodeConfig,
+  CustomFunctionConfig,
   DEFAULT_HOST,
   I18NConfig,
   ImagesConfig,
@@ -112,6 +113,7 @@ export interface ProjectMetaInfo {
 export interface ProjectBundle {
   components: ComponentBundle[];
   codeComponentMetas: CodeComponentMeta[];
+  customFunctionMetas: CustomFunctionConfig[];
   projectConfig: ProjectMetaBundle;
   globalVariants: GlobalVariantBundle[];
   usedTokens: StyleTokensMap;

package/src/utils/code-utils.ts

@@ -5,7 +5,7 @@ import traverse, { Node } from "@babel/traverse";
 import { ImportDeclaration } from "@babel/types";
 import L from "lodash";
 import * as Prettier from "prettier";
-import { Options, resolveConfig } from "prettier";
+import { Options } from "prettier";
 import * as ts from "typescript";
 import path from "upath";
 import { getGlobalContextsResourcePath } from "../actions/sync-global-contexts";
@@ -14,11 +14,13 @@ import {
   fixComponentImagesReferences,
 } from "../actions/sync-images";
 import { logger } from "../deps";
+import { GLOBAL_SETTINGS } from "../globals";
 import { HandledError } from "../utils/error";
 import {
   CodeComponentConfig,
   ComponentConfig,
   CONFIG_FILE_NAME,
+  CustomFunctionConfig,
   GlobalVariantGroupConfig,
   IconConfig,
   ImageConfig,
@@ -34,7 +36,6 @@ import {
   writeFileContent,
 } from "./file-utils";
 import { assert, flatMap } from "./lang-utils";
-import { GLOBAL_SETTINGS } from "../globals";
 
 export const formatAsLocal = (
   content: string,
@@ -169,15 +170,38 @@ type PlasmicImportType =
   | "codeComponent"
   | "codeComponentHelper"
   | "globalContext"
+  | "customFunction"
   | undefined;
 
+const validJsIdentifierChars = [
+  "\\u0621-\\u064A", // arabic
+  "\\u3400-\\u4DB5", // chinese
+  "\\u4E00-\\u9FCC", // chinese
+  "\\u0400-\\u04FF", // cyrillic
+  "\\u0370-\\u03ff", // greek
+  "\\u1f00-\\u1fff", // greek
+  "\\u0900-\\u097F", // hindi
+  "\\u3041-\\u3094", // japanese
+  "\\u30A1-\\u30FB", // japanese
+  "\\u0E00-\\u0E7F", // thai
+  "\\w",
+  "-_",
+];
+
 function tryParsePlasmicImportSpec(node: ImportDeclaration) {
   const c = node.trailingComments?.[0];
   if (!c) {
     return undefined;
   }
   const m = c.value.match(
-    /plasmic-import:\s+([\w-]+)(?:\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext))?/
+    new RegExp(
+      [
+        "plasmic-import:\\s+([",
+        ...validJsIdentifierChars,
+        "\\.",
+        "]+)(?:\\/(component|css|render|globalVariant|projectcss|defaultcss|icon|picture|jsBundle|codeComponent|globalContext|customFunction))?",
+      ].join("")
+    )
   );
   if (m) {
     return { id: m[1], type: m[2] as PlasmicImportType } as PlasmicImportSpec;
@@ -384,6 +408,23 @@ export function replaceImports(
         true
       );
       stmt.source.value = realPath;
+    } else if (type === "customFunction") {
+      const meta = fixImportContext.customFunctionMetas[uuid];
+      if (!meta?.importPath) {
+        throw new HandledError(
+          `Encountered custom function "${uuid}" that was not registered with an importPath, so we don't know where to import this function from. Please see https://docs.plasmic.app/learn/code-components-ref/`
+        );
+      }
+      if (meta.importPath[0] === ".") {
+        // Relative path from the project root
+        const toPath = path.join(context.rootDir, meta.importPath);
+        assert(path.isAbsolute(toPath));
+        const realPath = makeImportPath(context, fromPath, toPath, true, true);
+        stmt.source.value = realPath;
+      } else {
+        // npm package
+        stmt.source.value = meta.importPath;
+      }
     }
   });
 
@@ -454,20 +495,26 @@ export interface FixImportContext {
   config: PlasmicConfig;
   components: Record<string, ComponentConfig>;
   codeComponentMetas: Record<string, CodeComponentConfig>;
+  customFunctionMetas: Record<string, CustomFunctionConfig>;
   globalVariants: Record<string, GlobalVariantGroupConfig>;
   icons: Record<string, IconConfig>;
   images: Record<string, ImageConfig>;
   projects: Record<string, ProjectConfig>;
 }
 
-export const mkFixImportContext = (config: PlasmicConfig) => {
+export const mkFixImportContext = (config: PlasmicConfig): FixImportContext => {
   const allComponents = flatMap(config.projects, (p) => p.components);
   const components = L.keyBy(allComponents, (c) => c.id);
   const allCodeComponents = flatMap(
     config.projects,
     (p) => p.codeComponents || []
   );
+  const allCustomFunctions = flatMap(
+    config.projects,
+    (p) => p.customFunctions ?? []
+  );
   const codeComponentMetas = L.keyBy(allCodeComponents, (c) => c.id);
+  const customFunctionMetas = L.keyBy(allCustomFunctions, (fn) => fn.id);
   const globalVariants = L.keyBy(
     config.globalVariants.variantGroups,
     (c) => c.id
@@ -485,6 +532,7 @@ export const mkFixImportContext = (config: PlasmicConfig) => {
     config,
     components,
     codeComponentMetas,
+    customFunctionMetas,
     globalVariants,
     icons,
     images,

package/src/utils/config-utils.ts

@@ -1,6 +1,6 @@
 import L from "lodash";
 import { DeepPartial } from "utility-types";
-import { PlasmicApi, ProjectIdAndToken } from "../api";
+import { PlasmicApi } from "../api";
 import { logger } from "../deps";
 import { HandledError } from "../utils/error";
 import { formatAsLocal } from "./code-utils";
@@ -152,6 +152,14 @@ export interface CodeComponentConfig {
   };
 }
 
+export interface CustomFunctionConfig {
+  id: string;
+  name: string;
+  namespace?: string | null;
+  importPath: string;
+  defaultExport: boolean;
+}
+
 export interface ProjectConfig {
   /** Project ID */
   projectId: string;
@@ -177,6 +185,7 @@ export interface ProjectConfig {
   // to the users nor appear to be missing in the documentation.
   jsBundleThemes?: JsBundleThemeConfig[];
   codeComponents?: CodeComponentConfig[];
+  customFunctions?: CustomFunctionConfig[];
 
   /** Metadata for each synced component in this project. */
   components: ComponentConfig[];