@figma/code-connect 1.4.7 → 1.4.9

package/dist/parser_scripts/get_swift_parser_dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_swift_parser_dir.js","sourceRoot":"","sources":["../../src/parser_scripts/get_swift_parser_dir.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'child_process'\nimport { exitWithError, logger } from '../common/logging'\nimport { getFileIfExists } from './get_file_if_exists'\nimport path from 'path'\nimport { readdirSync, existsSync } from 'fs'\n\n// Find the location of the Code Connect Swift package on disk, so that we can\n// call `swift run figma-swift` from the correct location. This requires parsing\n// the output of xcodebuild for .xcodeproj projects, or parsing Package.swift\n// for SPM projects.\n//\n// As this is a first party parser, we do this in TypeScript and call it as part\n// of our code. For third party parsers, logic like this would need to be\n// implemented in a script/binary which the user points Code Connect to.\nexport async function getSwiftParserDir(\n  cwd: string,\n  xcodeprojPath?: string,\n  swiftPackagePath?: string,\n  sourcePackagesPath?: string,\n) {\n  let figmaPackageDir: string | undefined\n  let xcodeprojFile: string | undefined\n  let packageSwiftFile: string | undefined\n\n  // // Check for the supported project types giving precedence top the user provided path\n  if (xcodeprojPath) {\n    xcodeprojFile = xcodeprojPath.replace(/\\s/g, '\\\\ ')\n  } else if (swiftPackagePath) {\n    packageSwiftFile = path.dirname(swiftPackagePath).replace(/\\s/g, '\\\\ ')\n  } else {\n    xcodeprojFile = getFileIfExists(cwd, '*.xcodeproj').replace(/\\s/g, '\\\\ ')\n    packageSwiftFile = getFileIfExists(cwd, 'Package.swift').replace(/\\s/g, '\\\\ ')\n  }\n\n  if (!(xcodeprojFile || packageSwiftFile)) {\n    exitWithError(\n      'No supported project found. Supported project types are .xcodeproj or Package.swift. You can specify the location of your .xcodeproj file with the `xcodeprojPath` config option.',\n    )\n  }\n\n  if (xcodeprojFile) {\n    // Use xcodebuild to get the build settings, so we can find where the Code\n    // Connect Swift package is installed\n    const result = spawnSync('xcodebuild', ['-project', xcodeprojFile, '-showBuildSettings'], {\n      cwd,\n      encoding: 'utf-8',\n    })\n\n    if (result.error) {\n      throw result.error\n    }\n\n    const buildSettings = result.stdout\n\n    // Extract the source and version of the Code Connect Swift package from the\n    // xcodebuild output, which can be in any of the following formats depending\n    // on how it is installed:\n    // - Figma: https://github.com/figma/code-connect @ 0.1.2\n    // - Figma: /path/to/code-connect @ local\n    // - Figma: /path/to/code-connect\n    const figmaPackageMatch = buildSettings.match(/\\s+Figma: ([^\\s]*)(?: @ (.*))?/)\n    if (!figmaPackageMatch) {\n      exitWithError(\n        'Code Connect Swift package not found. Please add a dependency to the Code Connect package at https://github.com/figma/code-connect to your project.',\n      )\n    }\n\n    // Find the package's location on disk, to compile and run the parser binary from\n    const [_, figmaPackageSource, figmaPackageVersion] = figmaPackageMatch\n    // The package version is `local` if installed via the \"Add package\" dialog,\n    // or undefined if installed via the \"Frameworks\" section directly (which we\n    // do for our test project, because the dialog won't allow ancestors to be\n    // added)\n    const isLocalFigmaPackage = figmaPackageVersion === 'local' || figmaPackageVersion === undefined\n\n    if (isLocalFigmaPackage) {\n      // If the version is 'local', the package is installed from a local checkout,\n      // and the path on disk is the source output by xcodebuild.\n      figmaPackageDir = figmaPackageSource\n    } else if (sourcePackagesPath) {\n      logger.info(`Using custom DerivedData path: ${sourcePackagesPath}`)\n\n      // If a custom path is supplied, use it.\n      figmaPackageDir = `${sourcePackagesPath}/checkouts/code-connect`\n    } else {\n      // Otherwise the SourcePackages will typically be located in Xcode's DerivedData directory,\n      // at ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, or in the Project's root\n      // at {project}/DerivedData/{project}/SourcePackages (depending on how the user's project is configured).\n      let hasFoundSourcePackagesDir = false\n\n      // 1. First look in the USER_LIBRARY_DIR (e.g. /Users/{username}/Library)\n      const userLibraryDirectoryMatch = buildSettings.match(/\\s+USER_LIBRARY_DIR = (.*)/)\n      const userLibraryDirectory = userLibraryDirectoryMatch\n        ? userLibraryDirectoryMatch[1]\n        : undefined\n\n      logger.info('Finding Code Connect Swift package')\n\n      // Find the project's name using the build settings\n      const projectNameMatch = buildSettings.match(/\\s+PROJECT_NAME = (.*)/)\n      const projectName = projectNameMatch ? projectNameMatch[1] : undefined\n\n      // We can't proceed without the project name (however, this should always exist)\n      if (!projectName) {\n        exitWithError('PROJECT_NAME not found in xcodebuild output')\n      }\n\n      // 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\n      // e.g. project-fbybcbnivxfbfeefownexgukzwxd\n      if (userLibraryDirectory) {\n        // Default to Xcode's default Dervied Data location (e.g. ~/Users/{username}/Library/Developer/Xcode/DerivedData/project-fbybcbnivxfbfeefownexgukzwxd/SourcePackages)\n        const root = `${userLibraryDirectory}/Developer/Xcode/DerivedData`\n\n        const projectFolderRegex = new RegExp(`${projectName}-[a-zA-Z0-9]{28}`)\n        const derivedDataFolders = readdirSync(root)\n        const projectFolder = derivedDataFolders.find((folder: string) =>\n          projectFolderRegex.test(folder),\n        )\n\n        // If the project folder is found, use it to find the Code Connect package\n        if (projectFolder) {\n          figmaPackageDir = `${root}/${projectFolder}/SourcePackages/checkouts/code-connect`\n          hasFoundSourcePackagesDir = true\n        } else {\n          logger.warn('Package not found in user library directory')\n        }\n      }\n\n      // 2. If SourcePackages couldn't be found in ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, attempt\n      // to find it in the project root {project}/DerivedData/{project}/SourcePackages\n      if (!hasFoundSourcePackagesDir) {\n        const rootDir = buildSettings.match(/\\s+LOCROOT = (.*)/)\n\n        if (rootDir) {\n          figmaPackageDir = `${rootDir[1]}/DerivedData/${projectName}/SourcePackages/checkouts/code-connect`\n          hasFoundSourcePackagesDir = true\n        } else {\n          logger.warn('Package not found in project root')\n        }\n      }\n\n      // 3. Otherwise, the package may be installed to\n      // <DerviedData>/SourcePackages/checkouts/code-connect. We find the\n      // DerivedData location from the BUILD_DIR (which points to\n      // <DerivedData>/Build/Products).\n      if (!hasFoundSourcePackagesDir) {\n        const buildDir = buildSettings.match(/\\s+BUILD_DIR = (.*)/)\n\n        if (buildDir) {\n          figmaPackageDir = `${buildDir[1]}/../../SourcePackages/checkouts/code-connect`\n        } else {\n          logger.warn('Package not found in build directory')\n        }\n      }\n    }\n  } else if (packageSwiftFile) {\n    const swiftPackageDir = swiftPackagePath ? path.dirname(swiftPackagePath) : undefined\n    const packageDir = swiftPackageDir || cwd\n    // Use the Swift command to determine if the package is installed locally or from Git\n    try {\n      const result = spawnSync(\n        'swift',\n        ['package', '--package-path', packageDir, 'describe', '--type', 'json'],\n        {\n          cwd,\n          encoding: 'utf-8',\n        },\n      )\n\n      if (result.error) {\n        throw result.error\n      }\n\n      const packageInfo = JSON.parse(result.stdout)\n\n      const codeConnectPackage =\n        packageInfo.dependencies.find((p: any) => p.identity === 'code-connect') ??\n        // Our local directory is called figmadoc, so this is what swift outputs as the identity\n        packageInfo.dependencies.find((p: any) => p.identity === 'figmadoc')\n\n      if (!codeConnectPackage) {\n        exitWithError(\n          'Code Connect Swift package not found in Package.swift. Please add a dependency to https://github.com/figma/code-connect to your Package.swift file.',\n        )\n      }\n\n      // We can run directly from the directory of the package swift file\n      figmaPackageDir = packageDir\n    } catch (e) {\n      exitWithError(`Error calling Swift command: ${e}`)\n    }\n  }\n\n  if (!figmaPackageDir) {\n    exitWithError('Figma package could not be found')\n  }\n\n  // Check if the figmaPackageDir exists, otherwise we can't proceed,\n  // as we require the code-connect package to continue\n  if (!existsSync(figmaPackageDir)) {\n    exitWithError(`Figma package directory not found at ${figmaPackageDir}`)\n  }\n\n  // We need to ensure that the directory is writable, so we can run the swift run command\n  // otherwise an \"invalid access\" error will be thrown by swift.\n  try {\n    const packageFile = path.join(figmaPackageDir, 'Package.resolved')\n\n    const accessCheck = spawnSync('test', ['-w', packageFile])\n    if (accessCheck.status !== 0) {\n      // Directory is not writable, attempt to make it writable\n      spawnSync('chmod', ['-R', '755', packageFile])\n    }\n    logger.info(`Directory enabled for swift run command`)\n  } catch (e) {\n    logger.warn(`Unable to verify or modify directory permissions: ${e}`)\n  }\n\n  logger.info(\n    `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.`,\n  )\n\n  return figmaPackageDir\n}\n"]}
+{"version":3,"file":"get_swift_parser_dir.js","sourceRoot":"","sources":["../../src/parser_scripts/get_swift_parser_dir.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from 'child_process'\nimport { exitWithError, logger } from '../common/logging'\nimport { getFileIfExists } from './get_file_if_exists'\nimport path from 'path'\nimport { readdirSync, existsSync } from 'fs'\n\n// Find the location of the Code Connect Swift package on disk, so that we can\n// call `swift run figma-swift` from the correct location. This requires parsing\n// the output of xcodebuild for .xcodeproj projects, or parsing Package.swift\n// for SPM projects.\n//\n// As this is a first party parser, we do this in TypeScript and call it as part\n// of our code. For third party parsers, logic like this would need to be\n// implemented in a script/binary which the user points Code Connect to.\nexport async function getSwiftParserDir(\n  cwd: string,\n  xcodeprojPath?: string,\n  swiftPackagePath?: string,\n  sourcePackagesPath?: string,\n) {\n  let figmaPackageDir: string | undefined\n  let xcodeprojFile: string | undefined\n  let packageSwiftFile: string | undefined\n\n  // Keep raw paths; argv-form spawn handles spaces without shell escaping.\n  if (xcodeprojPath) {\n    xcodeprojFile = xcodeprojPath\n  } else if (swiftPackagePath) {\n    packageSwiftFile = path.dirname(swiftPackagePath)\n  } else {\n    xcodeprojFile = getFileIfExists(cwd, '*.xcodeproj')\n    packageSwiftFile = getFileIfExists(cwd, 'Package.swift')\n  }\n\n  if (!(xcodeprojFile || packageSwiftFile)) {\n    exitWithError(\n      'No supported project found. Supported project types are .xcodeproj or Package.swift. You can specify the location of your .xcodeproj file with the `xcodeprojPath` config option.',\n    )\n  }\n\n  if (xcodeprojFile) {\n    // Use xcodebuild to get the build settings, so we can find where the Code\n    // Connect Swift package is installed\n    const result = spawnSync('xcodebuild', ['-project', xcodeprojFile, '-showBuildSettings'], {\n      cwd,\n      encoding: 'utf-8',\n    })\n\n    if (result.error) {\n      throw result.error\n    }\n\n    const buildSettings = result.stdout\n\n    // Extract the source and version of the Code Connect Swift package from the\n    // xcodebuild output, which can be in any of the following formats depending\n    // on how it is installed:\n    // - Figma: https://github.com/figma/code-connect @ 0.1.2\n    // - Figma: /path/to/code-connect @ local\n    // - Figma: /path/to/code-connect\n    const figmaPackageMatch = buildSettings.match(/\\s+Figma: ([^\\s]*)(?: @ (.*))?/)\n    if (!figmaPackageMatch) {\n      exitWithError(\n        'Code Connect Swift package not found. Please add a dependency to the Code Connect package at https://github.com/figma/code-connect to your project.',\n      )\n    }\n\n    // Find the package's location on disk, to compile and run the parser binary from\n    const [_, figmaPackageSource, figmaPackageVersion] = figmaPackageMatch\n    // The package version is `local` if installed via the \"Add package\" dialog,\n    // or undefined if installed via the \"Frameworks\" section directly (which we\n    // do for our test project, because the dialog won't allow ancestors to be\n    // added)\n    const isLocalFigmaPackage = figmaPackageVersion === 'local' || figmaPackageVersion === undefined\n\n    if (isLocalFigmaPackage) {\n      // If the version is 'local', the package is installed from a local checkout,\n      // and the path on disk is the source output by xcodebuild.\n      figmaPackageDir = figmaPackageSource\n    } else if (sourcePackagesPath) {\n      logger.info(`Using custom DerivedData path: ${sourcePackagesPath}`)\n\n      // If a custom path is supplied, use it.\n      figmaPackageDir = `${sourcePackagesPath}/checkouts/code-connect`\n    } else {\n      // Otherwise the SourcePackages will typically be located in Xcode's DerivedData directory,\n      // at ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, or in the Project's root\n      // at {project}/DerivedData/{project}/SourcePackages (depending on how the user's project is configured).\n      let hasFoundSourcePackagesDir = false\n\n      // 1. First look in the USER_LIBRARY_DIR (e.g. /Users/{username}/Library)\n      const userLibraryDirectoryMatch = buildSettings.match(/\\s+USER_LIBRARY_DIR = (.*)/)\n      const userLibraryDirectory = userLibraryDirectoryMatch\n        ? userLibraryDirectoryMatch[1]\n        : undefined\n\n      logger.info('Finding Code Connect Swift package')\n\n      // Find the project's name using the build settings\n      const projectNameMatch = buildSettings.match(/\\s+PROJECT_NAME = (.*)/)\n      const projectName = projectNameMatch ? projectNameMatch[1] : undefined\n\n      // We can't proceed without the project name (however, this should always exist)\n      if (!projectName) {\n        exitWithError('PROJECT_NAME not found in xcodebuild output')\n      }\n\n      // 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\n      // e.g. project-fbybcbnivxfbfeefownexgukzwxd\n      if (userLibraryDirectory) {\n        // Default to Xcode's default Dervied Data location (e.g. ~/Users/{username}/Library/Developer/Xcode/DerivedData/project-fbybcbnivxfbfeefownexgukzwxd/SourcePackages)\n        const root = `${userLibraryDirectory}/Developer/Xcode/DerivedData`\n\n        const projectFolderRegex = new RegExp(`${projectName}-[a-zA-Z0-9]{28}`)\n        const derivedDataFolders = readdirSync(root)\n        const projectFolder = derivedDataFolders.find((folder: string) =>\n          projectFolderRegex.test(folder),\n        )\n\n        // If the project folder is found, use it to find the Code Connect package\n        if (projectFolder) {\n          figmaPackageDir = `${root}/${projectFolder}/SourcePackages/checkouts/code-connect`\n          hasFoundSourcePackagesDir = true\n        } else {\n          logger.warn('Package not found in user library directory')\n        }\n      }\n\n      // 2. If SourcePackages couldn't be found in ~/Users/{username}/Library/Developer/Xcode/DerivedData/{project}-{xxx}/SourcePackages, attempt\n      // to find it in the project root {project}/DerivedData/{project}/SourcePackages\n      if (!hasFoundSourcePackagesDir) {\n        const rootDir = buildSettings.match(/\\s+LOCROOT = (.*)/)\n\n        if (rootDir) {\n          figmaPackageDir = `${rootDir[1]}/DerivedData/${projectName}/SourcePackages/checkouts/code-connect`\n          hasFoundSourcePackagesDir = true\n        } else {\n          logger.warn('Package not found in project root')\n        }\n      }\n\n      // 3. Otherwise, the package may be installed to\n      // <DerviedData>/SourcePackages/checkouts/code-connect. We find the\n      // DerivedData location from the BUILD_DIR (which points to\n      // <DerivedData>/Build/Products).\n      if (!hasFoundSourcePackagesDir) {\n        const buildDir = buildSettings.match(/\\s+BUILD_DIR = (.*)/)\n\n        if (buildDir) {\n          figmaPackageDir = `${buildDir[1]}/../../SourcePackages/checkouts/code-connect`\n        } else {\n          logger.warn('Package not found in build directory')\n        }\n      }\n    }\n  } else if (packageSwiftFile) {\n    const swiftPackageDir = swiftPackagePath ? path.dirname(swiftPackagePath) : undefined\n    const packageDir = swiftPackageDir || cwd\n    // Use the Swift command to determine if the package is installed locally or from Git\n    try {\n      const result = spawnSync(\n        'swift',\n        ['package', '--package-path', packageDir, 'describe', '--type', 'json'],\n        {\n          cwd,\n          encoding: 'utf-8',\n        },\n      )\n\n      if (result.error) {\n        throw result.error\n      }\n\n      const packageInfo = JSON.parse(result.stdout)\n\n      const codeConnectPackage =\n        packageInfo.dependencies.find((p: any) => p.identity === 'code-connect') ??\n        // Our local directory is called figmadoc, so this is what swift outputs as the identity\n        packageInfo.dependencies.find((p: any) => p.identity === 'figmadoc')\n\n      if (!codeConnectPackage) {\n        exitWithError(\n          'Code Connect Swift package not found in Package.swift. Please add a dependency to https://github.com/figma/code-connect to your Package.swift file.',\n        )\n      }\n\n      // We can run directly from the directory of the package swift file\n      figmaPackageDir = packageDir\n    } catch (e) {\n      exitWithError(`Error calling Swift command: ${e}`)\n    }\n  }\n\n  if (!figmaPackageDir) {\n    exitWithError('Figma package could not be found')\n  }\n\n  // Check if the figmaPackageDir exists, otherwise we can't proceed,\n  // as we require the code-connect package to continue\n  if (!existsSync(figmaPackageDir)) {\n    exitWithError(`Figma package directory not found at ${figmaPackageDir}`)\n  }\n\n  // We need to ensure that the directory is writable, so we can run the swift run command\n  // otherwise an \"invalid access\" error will be thrown by swift.\n  try {\n    const packageFile = path.join(figmaPackageDir, 'Package.resolved')\n\n    const accessCheck = spawnSync('test', ['-w', packageFile])\n    if (accessCheck.status !== 0) {\n      // Directory is not writable, attempt to make it writable\n      spawnSync('chmod', ['-R', '755', packageFile])\n    }\n    logger.info(`Directory enabled for swift run command`)\n  } catch (e) {\n    logger.warn(`Unable to verify or modify directory permissions: ${e}`)\n  }\n\n  logger.info(\n    `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.`,\n  )\n\n  return figmaPackageDir\n}\n"]}

package/figma-types-no-require.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Type definitions for the `figma` module available in Code Connect template files
+ * (.figma.ts) — variant WITHOUT the global `require('figma')` shim.
+ *
+ * Use this instead of `@figma/code-connect/figma-types` if your project has
+ * @types/node installed. The default entry declares a global `require`, which
+ * overrides Node's `NodeRequire` type and breaks `require.resolve` (and similar)
+ * elsewhere in your project. This variant omits that declaration so the figma
+ * types can be added to your main tsconfig.json without a conflict. It types the
+ * recommended `import figma from 'figma'` syntax; `require('figma')` is typed by
+ * @types/node's own `require`.
+ *   { "compilerOptions": { "types": ["@figma/code-connect/figma-types-no-require"] } }
+ */
+declare module 'figma' {
+  export type CodeSection = { type: 'CODE'; code: string; nestedImports?: string[] }
+  export type InstanceSection = {
+    type: 'INSTANCE'
+    guid: string
+    symbolId: string
+    resultSections?: ResultSection[]
+    nestedImports?: string[]
+  }
+  export type SlotSection = { type: 'SLOT'; guid?: string; propertyName: string }
+  export type ErrorSection = { type: 'ERROR'; message: string; errorObject?: unknown }
+  export type ResultSection = CodeSection | InstanceSection | SlotSection | ErrorSection
+
+  export interface TemplateStringResult {
+    sections: ResultSection[]
+    language: string
+    type: 'SECTIONS'
+  }
+
+  export interface SelectorOptions {
+    path?: string[]
+    traverseInstances?: boolean
+  }
+
+  export type SlotResult = ResultSection[] & {
+    /** Connected instances directly in the slot (shallow). */
+    readonly connectedInstances: InstanceHandle[]
+  }
+
+  type ObjectValue = Record<string, FCCValue>
+
+  export type FCCValue =
+    | string
+    | number
+    | boolean
+    | undefined
+    | { $value: string; $type: 'jsx-element' }
+    | { $value: string; $type: 'function' }
+    | { $value: string; $type: 'identifier' }
+    | { $value: ObjectValue; $type: 'object' }
+    | { $value: string; $type: 'template-string' }
+    | { $value: string; $type: 'react-component' }
+    | { $value: FCCValue[]; $type: 'array' }
+
+  export interface TextHandle {
+    readonly type: 'TEXT'
+    readonly name: string
+    readonly textContent: string
+    readonly __containingSlotName__?: string
+    __render__(): string
+  }
+
+  export interface TemplateMetadata {
+    nestable?: boolean
+    props?: Record<string, unknown>
+    __props: Record<string, unknown>
+    [key: string]: unknown
+  }
+
+  export interface ErrorHandle {
+    readonly type: 'ERROR'
+    readonly __containingSlotName__?: string
+    __render__(): ResultSection[]
+    executeTemplate(): {
+      example: ResultSection[]
+      metadata?: TemplateMetadata
+    }
+  }
+
+  export interface InstanceHandle {
+    readonly type: 'INSTANCE'
+    readonly symbolId: string
+    readonly name: string
+    readonly children: (InstanceHandle | TextHandle | ErrorHandle)[]
+    readonly properties: Record<string, { value: string | boolean }>
+    readonly path?: string[]
+    readonly slots?: Record<string, { guid: string }>
+    /** Internal: the property name of the slot this node is content of, if any. */
+    readonly __containingSlotName__?: string
+
+    codeConnectId(): string | null
+
+    __find__(name: string): InstanceHandle | ErrorHandle | null
+    __findChildWithCriteria__(criteria: {
+      type: 'INSTANCE' | 'TEXT'
+      name: string
+    }): InstanceHandle | TextHandle | ErrorHandle | null
+    __getPropertyValue__(name: string): string | boolean | ErrorHandle
+    __render__(): ResultSection[]
+    __getProps__(): ResultSection[] | Record<string, unknown> | undefined
+    __renderWithFn__(
+      renderFn: (props: Record<string, unknown>) => TemplateStringResult,
+    ): ResultSection[] | ErrorHandle | undefined
+
+    getString(propName: string): string
+    getBoolean(propName: string): boolean
+    getBoolean<O extends Record<string, unknown>>(
+      propName: string,
+      options: O,
+    ): EnumOptionsValues<O>
+    getEnum<O extends Record<string, unknown>>(
+      propName: string,
+      options: O,
+    ): EnumOptionsValues<O> | undefined
+    getInstanceSwap(propName: string): InstanceHandle | ErrorHandle | undefined
+    getSlot(propName: string): SlotResult | undefined
+    hasCodeConnect(): boolean
+    getPropertyValue(name: string): string | boolean | ErrorHandle
+    findInstance(layerName: string, opts?: SelectorOptions): InstanceHandle | ErrorHandle
+    findText(layerName: string, opts?: SelectorOptions): TextHandle | ErrorHandle
+    findConnectedInstance(
+      codeConnectId: string,
+      opts?: SelectorOptions,
+    ): InstanceHandle | ErrorHandle | null
+    findConnectedInstances(
+      selectorFn: (node: InstanceHandle) => boolean,
+      opts?: SelectorOptions,
+    ): (InstanceHandle | ErrorHandle)[]
+    findLayers(
+      selectorFn: (node: InstanceHandle | TextHandle) => boolean,
+      opts?: SelectorOptions,
+    ): (InstanceHandle | TextHandle | ErrorHandle)[]
+    executeTemplate(): {
+      example: ResultSection[]
+      metadata?: TemplateMetadata
+    }
+  }
+
+  export type LayerHandle = InstanceHandle | TextHandle | ErrorHandle
+
+  export type EnumOptionsValues<O extends Record<string, unknown>> = O[keyof O]
+
+  export interface FigmaProperties {
+    string(propName: string): string
+    boolean(propName: string): boolean
+    boolean<O extends Record<string, unknown>>(propName: string, options: O): EnumOptionsValues<O>
+    enum<O extends Record<string, unknown>>(
+      propName: string,
+      options: O,
+    ): EnumOptionsValues<O> | undefined
+    // In error cases the implementation may return string (from TextHandle.__render__)
+    instance(propName: string): ResultSection[] | string | undefined
+    __instance__(
+      propName: string,
+    ): InstanceHandle | TextHandle | ErrorHandle | ResultSection[] | undefined
+    slot(propName: string): SlotResult | undefined
+    children(layerNames: string[]): ResultSection[]
+  }
+
+  export type TemplateLiteral = (
+    strings: TemplateStringsArray,
+    ...values: unknown[]
+  ) => TemplateStringResult
+
+  export interface Figma {
+    /** Per-entry data from a .figma.batch.json file. Available in batch templates. */
+    readonly batch: Record<string, any>
+
+    /** The currently selected component instance */
+    readonly selectedInstance: InstanceHandle & { readonly __properties__: FigmaProperties }
+    /** Alias for selectedInstance */
+    readonly currentLayer: InstanceHandle & { readonly __properties__: FigmaProperties }
+    /** Access component properties via the properties API */
+    readonly properties: FigmaProperties
+
+    /** Template literal tag for custom/plaintext code */
+    code: TemplateLiteral
+    /** Template literal tag for JSX/TSX code */
+    tsx: TemplateLiteral
+    /** Template literal tag for HTML code */
+    html: TemplateLiteral
+    /** Template literal tag for Swift code */
+    swift: TemplateLiteral
+    /** Template literal tag for Kotlin/Compose code */
+    kotlin: TemplateLiteral
+
+    /** Return a raw value (not rendered as a template string) */
+    value(raw: unknown, preview?: unknown): { type: string; value: unknown; preview: unknown }
+
+    helpers: {
+      react: {
+        renderProp(name: string, prop: FCCValue | ResultSection[]): TemplateStringResult | string
+        renderChildren(
+          prop: FCCValue | ResultSection[],
+        ): ResultSection[] | string | number | boolean | TemplateStringResult
+        renderPropValue(
+          prop: FCCValue | ResultSection[],
+        ): string | number | boolean | ResultSection[]
+        stringifyObject(obj: unknown): string
+        jsxElement(value: string): { $value: string; $type: 'jsx-element' }
+        function(value: string): { $value: string; $type: 'function' }
+        identifier(value: string): { $value: string; $type: 'identifier' }
+        object(value: ObjectValue): { $value: ObjectValue; $type: 'object' }
+        templateString(value: string): { $value: string; $type: 'template-string' }
+        reactComponent(value: string): { $value: string; $type: 'react-component' }
+        array(value: FCCValue[]): { $value: FCCValue[]; $type: 'array' }
+        isReactComponentArray(prop: unknown): boolean
+      }
+      swift: {
+        renderChildren(
+          children: ResultSection[] | string | undefined,
+          prefix: string,
+        ): ResultSection[]
+      }
+      kotlin: {
+        renderChildren(
+          children: ResultSection[] | string | undefined,
+          prefix: string,
+        ): ResultSection[]
+      }
+    }
+  }
+
+  const figma: Figma
+  export = figma
+}

package/figma-types.d.ts

@@ -32,6 +32,11 @@ declare module 'figma' {
     traverseInstances?: boolean
   }
 
+  export type SlotResult = ResultSection[] & {
+    /** Connected instances directly in the slot (shallow). */
+    readonly connectedInstances: InstanceHandle[]
+  }
+
   type ObjectValue = Record<string, FCCValue>
 
   export type FCCValue =
@@ -51,6 +56,7 @@ declare module 'figma' {
     readonly type: 'TEXT'
     readonly name: string
     readonly textContent: string
+    readonly __containingSlotName__?: string
     __render__(): string
   }
 
@@ -63,6 +69,7 @@ declare module 'figma' {
 
   export interface ErrorHandle {
     readonly type: 'ERROR'
+    readonly __containingSlotName__?: string
     __render__(): ResultSection[]
     executeTemplate(): {
       example: ResultSection[]
@@ -78,6 +85,8 @@ declare module 'figma' {
     readonly properties: Record<string, { value: string | boolean }>
     readonly path?: string[]
     readonly slots?: Record<string, { guid: string }>
+    /** Internal: the property name of the slot this node is content of, if any. */
+    readonly __containingSlotName__?: string
 
     codeConnectId(): string | null
 
@@ -103,8 +112,8 @@ declare module 'figma' {
       propName: string,
       options: O,
     ): EnumOptionsValues<O> | undefined
-    getInstanceSwap(propName: string): InstanceHandle | undefined
-    getSlot(propName: string): ResultSection[] | undefined
+    getInstanceSwap(propName: string): InstanceHandle | ErrorHandle | undefined
+    getSlot(propName: string): SlotResult | undefined
     hasCodeConnect(): boolean
     getPropertyValue(name: string): string | boolean | ErrorHandle
     findInstance(layerName: string, opts?: SelectorOptions): InstanceHandle | ErrorHandle
@@ -144,7 +153,7 @@ declare module 'figma' {
     __instance__(
       propName: string,
     ): InstanceHandle | TextHandle | ErrorHandle | ResultSection[] | undefined
-    slot(propName: string): ResultSection[] | undefined
+    slot(propName: string): SlotResult | undefined
     children(layerNames: string[]): ResultSection[]
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figma/code-connect",
-  "version": "1.4.7",
+  "version": "1.4.9",
   "description": "A tool for connecting your design system components in code with your design system in Figma",
   "keywords": [],
   "author": "Figma",
@@ -25,6 +25,9 @@
     },
     "./figma-types": {
       "types": "./figma-types.d.ts"
+    },
+    "./figma-types-no-require": {
+      "types": "./figma-types-no-require.d.ts"
     }
   },
   "repository": {
@@ -37,7 +40,8 @@
   },
   "files": [
     "dist/**/*",
-    "figma-types.d.ts"
+    "figma-types.d.ts",
+    "figma-types-no-require.d.ts"
   ],
   "engines": {
     "node": ">=18"
@@ -83,7 +87,7 @@
     "@types/jest": "^29.5.13",
     "@types/jsdom": "^21.1.7",
     "@types/lodash": "4.17.20",
-    "@types/node": "22.17.2",
+    "@types/node": "22.19.21",
     "@types/prettier": "2.7.3",
     "@types/prompts": "^2.4.9",
     "@types/react": "18.3.27",