Code Connect v1.3.5

Author: figma-bot

CHANGELOG.md

@@ -1,8 +1,23 @@
+# Code Connect v1.3.5 (4th September 2025)
+
+## Fixed
+
+### General
+
+- Fixed "Failed to fetch embeddings" error if empty payload in interactive setup
+- Retain the temporary file and directory when `--verbose` is enabled for improved debugging. 
+
+### SwiftUI
+
+- Fixed SourcePackages directory not found.
+- Added optional sourcePackagesPath parameter for when the default derived data folder is not used. 
+- Updated `swift-syntax` to support 601.0.1. 
+
 # Code Connect v1.3.4 (26th June 2025)
 
-### Fixed
+## Fixed
 
-# React
+### React
 
 - Support getProps inside nestedProps
 

Package.swift

@@ -15,7 +15,7 @@ let package = Package(
         .executable(name: "figma-swift", targets: ["CodeConnectCLI"]),
     ],
     dependencies: [
-        .package(url: "https://github.com/swiftlang/swift-syntax", "510.0.3"..."600.0.1"),
+        .package(url: "https://github.com/swiftlang/swift-syntax", "510.0.3"..."601.0.1"),
         .package(url: "https://github.com/apple/swift-argument-parser", from: "1.0.0"),
         .package(url: "https://github.com/nicklockwood/SwiftFormat", from: "0.55.3"),
     ],

cli/.gitignore

@@ -0,0 +1 @@
+dist/

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figma/code-connect",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "A tool for connecting your design system components in code with your design system in Figma",
   "keywords": [],
   "author": "Figma",
@@ -38,7 +38,7 @@
     "dev": "tsx src/cli.ts",
     "build": "rm -rf dist && npm run typecheck && tsc",
     "build:web": "pnpm build",
-    "build:webpack": "cross-env NODE_OPTIONS=\"--max-old-space-size=8196\" webpack --mode production",
+    "build:webpack": "node scripts/resolve-dependencies.js && cross-env NODE_OPTIONS=\"--max-old-space-size=8196\" webpack --mode production",
     "test": "npm run test:no-coverage -- --coverage",
     "test:no-coverage": "cross-env NODE_OPTIONS=\"--experimental-vm-modules --no-deprecation --max-old-space-size=10240\" npx jest --logHeapUsage --workerIdleMemoryLimit=1.5G",
     "test:fast": "npm run test -- --testPathIgnorePatterns=template_rendering.test.ts --testPathIgnorePatterns=e2e_parse_command_swift.test.ts --testPathIgnorePatterns=e2e_wizard_swift.test.ts",
@@ -47,7 +47,7 @@
     "test:swift": "npm run test -- --runInBand --testPathPattern=e2e_parse_command_swift.test.ts --testPathPattern=e2e_wizard_swift.test.ts --testPathPattern=e2e_parse_command_swift_xcodeproj.test.ts",
     "test:non-mac": "npm run test -- --testPathIgnorePatterns=e2e_parse_command_swift.test.ts --testPathIgnorePatterns=e2e_wizard_swift.test.ts --testPathIgnorePatterns=e2e_parse_command_swift_xcodeproj.test.ts",
     "bundle": "npm run build && npm pack && mkdir -p bundle && mv figma-code-connect*.tgz bundle",
-    "bundle:local": "cp package.json package.json.bak && grep -v 'workspace:' package.json > package.json.tmp && mv package.json.tmp package.json && npm run build && npm pack && mkdir -p bundle-local && mv figma-code-connect*.tgz bundle-local; mv package.json.bak package.json",
+    "bundle:local": "cp package.json package.json.bak && node scripts/resolve-dependencies.js && npm run build && npm pack && mkdir -p bundle-local && mv figma-code-connect*.tgz bundle-local; mv package.json.bak package.json",
     "bundle:npm-readme:prepare": "mv README.md ../cli-README.md.bak && cp ../README.md . && npx tsx ../scripts/make_readme_links_absolute.ts",
     "bundle:npm-readme:restore": "mv ../cli-README.md.bak README.md",
     "bundle:npm": "npm run build && npm run bundle:npm-readme:prepare && npm pack && mkdir -p bundle-npm && mv figma-code-connect*.tgz bundle-npm; npm run bundle:npm-readme:restore",

cli/src/connect/__test__/e2e/e2e_parse_command/swift_parser/swift_parser.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -32,7 +32,9 @@ export function testWizardE2e(testCase: {
           // First, we need to ensure the Swift project has been built as we are
           // using a local version. We don't need to build the actual project itself
           // for this to work.
-          stdout.write('Building Swift project, this may take a while the first time...\n')
+          stdout.write(
+            `Building Swift project at ${path.join(__dirname, '..', '..', '..', '..')}, this may take a while the first time...\n`,
+          )
           execSync('swift build -c release', {
             cwd: path.join(__dirname, '..', '..', '..', '..'),
           })
@@ -85,7 +87,8 @@ export function testWizardE2e(testCase: {
 `
         : `{
   "codeConnect": {
-    "include": ${JSON.stringify(testCase.expectedIncludeGlobs)}
+    "include": ${JSON.stringify(testCase.expectedIncludeGlobs)},
+    "interactiveSetupFigmaFileUrl": "https://www.figma.com/design/abc123/my-design-system"
   }
 }
 `

cli/src/connect/__test__/e2e/test_wizard_e2e.ts

@@ -31,7 +31,7 @@ type ParserInfo = {
 const FIRST_PARTY_PARSERS: Record<CodeConnectExecutableParser, ParserInfo> = {
   swift: {
     command: async (cwd, config) => {
-      return `swift run --package-path ${await getSwiftParserDir(cwd, (config as any).xcodeprojPath, (config as any).swiftPackagePath)} figma-swift`
+      return `swift run --package-path ${await getSwiftParserDir(cwd, (config as any).xcodeprojPath, (config as any).swiftPackagePath, (config as any).sourcePackagesPath)} figma-swift`
     },
   },
   compose: {
@@ -87,10 +87,19 @@ export async function callParser(
         ...config,
         verbose: (payload as any).verbose,
       }
+
       const command = await parser.command(cwd, configWithVerbose, payload.mode)
       if (parser.temporaryIOFilePath) {
         fs.mkdirSync(path.dirname(parser.temporaryIOFilePath), { recursive: true })
         fs.writeFileSync(temporaryIOFilePath, JSON.stringify(payload))
+
+        // Write to tmp directory before calling parser if verbose is enabled
+        if ((payload as any).verbose) {
+          const tmpDir = path.join(cwd, 'tmp')
+          fs.mkdirSync(tmpDir, { recursive: true })
+          const tmpFilePath = path.join(tmpDir, 'figma-code-connect-parser-input.json.tmp')
+          fs.writeFileSync(tmpFilePath, JSON.stringify(payload, null, 2))
+        }
       }
       logger.debug(`Running parser: ${command}`)
       const commandSplit = command.split(' ')
@@ -150,11 +159,14 @@ export async function callParser(
           )
         }
         if (parser.temporaryIOFilePath) {
-          fs.unlinkSync(parser.temporaryIOFilePath)
-          // Delete parent directory if empty after removing temp file
-          const parentDir = path.dirname(parser.temporaryIOFilePath)
-          if (fs.readdirSync(parentDir).length === 0) {
-            fs.rmdirSync(parentDir)
+          // Retain temp file and directory when verbose mode is enabled
+          if (!(payload as any).verbose) {
+            fs.unlinkSync(parser.temporaryIOFilePath)
+            // Delete parent directory if empty after removing temp file
+            const parentDir = path.dirname(parser.temporaryIOFilePath)
+            if (fs.readdirSync(parentDir).length === 0) {
+              fs.rmdirSync(parentDir)
+            }
           }
         }
       })

cli/src/connect/parser_executables.ts

@@ -696,7 +696,7 @@ export async function getProjectInfoFromConfig(
     ? ({
         react: ['node_modules/**'],
         html: ['node_modules/**'],
-        swift: [],
+        swift: ['**/__test__/**'],
         compose: [],
         custom: [],
         __unit_test__: [],

cli/src/connect/project.ts

@@ -164,15 +164,18 @@ async function getEmbeddingsMatchResults({
 }) {
   const uniqueMatchableNames = getUniqueMatchableNames(propMappingData)
 
-  const res = mockResponseName
-    ? await getMockEmbeddingsResponse(uniqueMatchableNames, mockResponseName)
-    : await fetchEmbeddings({ uniqueMatchableNames, accessToken, figmaUrl })
-
   const matchableNamesEmbeddings: MatchableNameEmbeddings = {}
 
-  res?.meta.embeddings.forEach((embedding: number[], index: number) => {
-    matchableNamesEmbeddings[uniqueMatchableNames[index]] = embedding
-  })
+  if (uniqueMatchableNames.length > 0) {
+    const res = mockResponseName
+      ? await getMockEmbeddingsResponse(uniqueMatchableNames, mockResponseName)
+      : await fetchEmbeddings({ uniqueMatchableNames, accessToken, figmaUrl })
+
+    res?.meta.embeddings.forEach((embedding: number[], index: number) => {
+      matchableNamesEmbeddings[uniqueMatchableNames[index]] = embedding
+    })
+  }
+
   return buildAllEmbeddingsMatchResults(propMappingData, matchableNamesEmbeddings)
 }
 

cli/src/connect/wizard/prop_mapping_helpers.ts

@@ -2,6 +2,7 @@ import { spawnSync } from 'child_process'
 import { exitWithError, logger } from '../common/logging'
 import { getFileIfExists } from './get_file_if_exists'
 import path from 'path'
+import { readdirSync, existsSync } from 'fs'
 
 // Find the location of the Code Connect Swift package on disk, so that we can
 // call `swift run figma-swift` from the correct location. This requires parsing
@@ -15,6 +16,7 @@ export async function getSwiftParserDir(
   cwd: string,
   xcodeprojPath?: string,
   swiftPackagePath?: string,
+  sourcePackagesPath?: string,
 ) {
   let figmaPackageDir: string | undefined
   let xcodeprojFile: string | undefined
@@ -75,16 +77,81 @@ export async function getSwiftParserDir(
       // If the version is 'local', the package is installed from a local checkout,
       // and the path on disk is the source output by xcodebuild.
       figmaPackageDir = figmaPackageSource
+    } else if (sourcePackagesPath) {
+      logger.info(`Using custom DerivedData path: ${sourcePackagesPath}`)
+
+      // If a custom path is supplied, use it.
+      figmaPackageDir = `${sourcePackagesPath}/checkouts/code-connect`
     } else {
-      // Otherwise, the package will be installed to
+      // Otherwise the SourcePackages will typically be located in Xcode's DerivedData directory,
+      // at ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, or in the Project's root
+      // at {project}/DerivedData/{project}/SourcePackages (depending on how the user's project is configured).
+      let hasFoundSourcePackagesDir = false
+
+      // 1. First look in the USER_LIBRARY_DIR (e.g. /Users/{username}/Library)
+      const userLibraryDirectoryMatch = buildSettings.match(/\s+USER_LIBRARY_DIR = (.*)/)
+      const userLibraryDirectory = userLibraryDirectoryMatch
+        ? userLibraryDirectoryMatch[1]
+        : undefined
+
+      logger.info('Finding Code Connect Swift package')
+
+      // Find the project's name using the build settings
+      const projectNameMatch = buildSettings.match(/\s+PROJECT_NAME = (.*)/)
+      const projectName = projectNameMatch ? projectNameMatch[1] : undefined
+
+      // We can't proceed without the project name (however, this should always exist)
+      if (!projectName) {
+        exitWithError('PROJECT_NAME not found in xcodebuild output')
+      }
+
+      // 1. From the folders in the user library directory use a regex to determine the folder name of the project defined by "ProjectName-" and a 28 character hash
+      // e.g. project-fbybcbnivxfbfeefownexgukzwxd
+      if (userLibraryDirectory) {
+        // Default to Xcode's default Dervied Data location (e.g. ~/Users/{username}/Library/Developer/Xcode/DerivedData/project-fbybcbnivxfbfeefownexgukzwxd/SourcePackages)
+        const root = `${userLibraryDirectory}/Developer/Xcode/DerivedData`
+
+        const projectFolderRegex = new RegExp(`${projectName}-[a-zA-Z0-9]{28}`)
+        const derivedDataFolders = readdirSync(root)
+        const projectFolder = derivedDataFolders.find((folder: string) =>
+          projectFolderRegex.test(folder),
+        )
+
+        // If the project folder is found, use it to find the Code Connect package
+        if (projectFolder) {
+          figmaPackageDir = `${root}/${projectFolder}/SourcePackages/checkouts/code-connect`
+          hasFoundSourcePackagesDir = true
+        } else {
+          logger.warn('Package not found in user library directory')
+        }
+      }
+
+      // 2. If SourcePackages couldn't be found in ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, attempt
+      // to find it in the project root {project}/DerivedData/{project}/SourcePackages
+      if (!hasFoundSourcePackagesDir) {
+        const rootDir = buildSettings.match(/\s+LOCROOT = (.*)/)
+
+        if (rootDir) {
+          figmaPackageDir = `${rootDir[1]}/DerivedData/${projectName}/SourcePackages/checkouts/code-connect`
+          hasFoundSourcePackagesDir = true
+        } else {
+          logger.warn('Package not found in project root')
+        }
+      }
+
+      // 3. Otherwise, the package may be installed to
       // <DerviedData>/SourcePackages/checkouts/code-connect. We find the
       // DerivedData location from the BUILD_DIR (which points to
       // <DerivedData>/Build/Products).
-      const buildDir = buildSettings.match(/\s+BUILD_DIR = (.*)/)
-      if (!buildDir) {
-        exitWithError('BUILD_DIR not found in xcodebuild output')
+      if (!hasFoundSourcePackagesDir) {
+        const buildDir = buildSettings.match(/\s+BUILD_DIR = (.*)/)
+
+        if (buildDir) {
+          figmaPackageDir = `${buildDir[1]}/../../SourcePackages/checkouts/code-connect`
+        } else {
+          logger.warn('Package not found in build directory')
+        }
       }
-      figmaPackageDir = `${buildDir[1]}/../../SourcePackages/checkouts/code-connect`
     }
   } else if (packageSwiftFile) {
     const swiftPackageDir = swiftPackagePath ? path.dirname(swiftPackagePath) : undefined
@@ -128,6 +195,27 @@ export async function getSwiftParserDir(
     exitWithError('Figma package could not be found')
   }
 
+  // Check if the figmaPackageDir exists, otherwise we can't proceed,
+  // as we require the code-connect package to continue
+  if (!existsSync(figmaPackageDir)) {
+    exitWithError(`Figma package directory not found at ${figmaPackageDir}`)
+  }
+
+  // We need to ensure that the directory is writable, so we can run the swift run command
+  // otherwise an "invalid access" error will be thrown by swift.
+  try {
+    const packageFile = path.join(figmaPackageDir, 'Package.resolved')
+
+    const accessCheck = spawnSync('test', ['-w', packageFile])
+    if (accessCheck.status !== 0) {
+      // Directory is not writable, attempt to make it writable
+      spawnSync('chmod', ['-R', '755', packageFile])
+    }
+    logger.info(`Directory enabled for swift run command`)
+  } catch (e) {
+    logger.warn(`Unable to verify or modify directory permissions: ${e}`)
+  }
+
   logger.info(
     `Found Code Connect Swift package at ${figmaPackageDir}, building parser binary. This may take a few minutes if this is the first time you've run Code Connect.`,
   )