@figma/code-connect 1.4.0 → 1.4.2

package/dist/storybook/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/storybook/convert.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from 'fs'\nimport {\n  bfsFindNode,\n  convertObjectLiteralToJs,\n  getDefaultExport,\n  parsePropertyOfType,\n} from '../typescript/compiler'\nimport {\n  parseComponentMetadata,\n  parseJSXRenderFunction,\n  getDefaultTemplate,\n  findAndResolveImports,\n} from '../react/parser'\nimport {\n  CodeConnectReactConfig,\n  ReactProjectInfo,\n  getRemoteFileUrl,\n  getStorybookUrl,\n} from '../connect/project'\nimport { logger } from '../common/logging'\nimport { CodeConnectJSON } from '../connect/figma_connect'\nimport { CodeConnectLabel, SyntaxHighlightLanguage } from '../connect/label_language_mapping'\nimport ts from 'typescript'\nimport { FigmaConnectLink, FigmaConnectMeta } from '../connect/api'\nimport { minimatch } from 'minimatch'\nimport { parsePropsObject } from '../connect/intrinsics'\nimport {\n  InternalError,\n  parseImports,\n  parseLinks,\n  ParserContext,\n  ParserError,\n} from '../connect/parser_common'\n\ninterface ConvertStorybookFilesArgs {\n  /**\n   * Optionally override the glob used to find stories. This is currently not\n   * exposed in the config, but is used by the tests\n   */\n  storiesGlob?: string\n\n  /**\n   * Information about the project\n   */\n  projectInfo: ReactProjectInfo\n}\n\n/**\n * Converts all Storyboook files in a directory into Code Connect objects. If a file\n * cannot be converted (e.g. unsupported syntax), it is ignored and an error is\n * logged.\n *\n * @param args\n * @returns An array of Code Connect objects\n */\nexport async function convertStorybookFiles({\n  projectInfo,\n  storiesGlob = '**/*.stories.tsx',\n}: ConvertStorybookFilesArgs): Promise<CodeConnectJSON[]> {\n  const { remoteUrl, config, files, tsProgram } = projectInfo\n\n  const storyFiles = files.filter((file) => minimatch(file, storiesGlob, { matchBase: true }))\n  logger.debug(`Story files found:\\n${storyFiles.map((f) => `- ${f}`).join('\\n')}`)\n\n  return Promise.all(\n    storyFiles.map((path) =>\n      convertStorybookFile({ path, tsProgram, config, remoteUrl, absPath: projectInfo.absPath }),\n    ),\n  )\n    .then((f) => f.filter((x): x is NonNullable<typeof x> => Boolean(x)))\n    .then((f) => f.flat())\n}\n\ninterface FigmaStoryMetadata {\n  type: string\n  url: string\n}\n\ninterface ConvertStorybookFileArgs {\n  path: string\n  tsProgram: ts.Program\n  remoteUrl: string\n  config: CodeConnectReactConfig\n  absPath: string\n}\n\ntype MappedPropType = 'FigmaString' | 'FigmaBoolean' | 'Mapped'\ntype MappedProps = Map<string, { figmaName: string; type: MappedPropType }> | undefined\n\nasync function convertStorybookFile({\n  path,\n  tsProgram,\n  remoteUrl,\n  config,\n  absPath,\n}: ConvertStorybookFileArgs): Promise<CodeConnectJSON[] | undefined> {\n  const checker = tsProgram.getTypeChecker()\n  const sourceFile = tsProgram.getSourceFile(path)\n\n  if (!sourceFile) {\n    throw new InternalError(`Source file not found: ${path}`)\n  }\n\n  const parserContext: ParserContext = {\n    checker,\n    config,\n    sourceFile,\n    absPath,\n    resolvedImports: findAndResolveImports(tsProgram, sourceFile),\n  }\n\n  let source = readFileSync(path).toString()\n  // Replace backticks with ' as csf-tools can't parse dynamic titles\n  source = source.replace(/title: `(.*)`/g, (_, title) => {\n    return `title: '${title}'`\n  })\n\n  logger.debug(`Parsing story ${path}`)\n\n  try {\n    // We need to get the default export, which contains the story file meta,\n    // from the TS Program rather than using `babelNodeToTsSourceFile(csf._metaNode)`,\n    // because we need access to the full Program to parse it for prop types etc.\n    const storyFileMetaNode = getDefaultExport(sourceFile)\n    if (!storyFileMetaNode) {\n      return\n    }\n\n    const parseResult = parseStoryMetadata(storyFileMetaNode, parserContext)\n\n    if (!parseResult) {\n      logger.debug(`Could not parse story metadata for ${path}`)\n      return\n    }\n\n    const { figmaStoryMetadata, componentDeclaration, propMappings, examples, imports, links } =\n      parseResult\n\n    const componentMetadata = await parseComponentMetadata(componentDeclaration, parserContext)\n\n    const codeConnectObjects: CodeConnectJSON[] = []\n    const baseCodeConnect: CodeConnectJSON = {\n      figmaNode: figmaStoryMetadata.url,\n      source: config?.storybook?.url\n        ? getStorybookUrl(componentMetadata.source, config.storybook.url)\n        : getRemoteFileUrl(componentMetadata.source, remoteUrl),\n      sourceLocation: { line: componentMetadata.line },\n      template: '',\n      templateData: {\n        props: propMappings,\n        imports,\n      },\n      links,\n      component: componentMetadata.component,\n      label: CodeConnectLabel.Storybook,\n      language: SyntaxHighlightLanguage.TypeScript,\n      metadata: {\n        cliVersion: require('../../package.json').version,\n      },\n    }\n\n    // If there are no examples, just return a default Code Connect object\n    if (!examples) {\n      codeConnectObjects.push({\n        ...baseCodeConnect,\n        template: getDefaultTemplate(componentMetadata),\n      })\n      return codeConnectObjects\n    }\n\n    for (const statement of sourceFile.statements) {\n      // Find any exported function or variable declarations, which correspond to stories\n      if (!(ts.isFunctionDeclaration(statement) || ts.isVariableStatement(statement))) {\n        continue\n      }\n\n      const name = ts.isFunctionDeclaration(statement)\n        ? statement.name?.text\n        : statement.declarationList.declarations?.[0].name.getText(sourceFile)\n\n      const example = examples?.find((example) => example.example === name)\n      // This story is not in the examples array, so skip it\n      if (examples && !example) {\n        continue\n      }\n\n      let statementToParse: ts.ArrowFunction | ts.FunctionDeclaration | undefined\n\n      if (ts.isFunctionDeclaration(statement)) {\n        statementToParse = statement\n      } else {\n        const initializer = statement.declarationList.declarations[0].initializer\n        if (initializer && ts.isArrowFunction(initializer)) {\n          statementToParse = initializer\n        } else if (initializer && ts.isObjectLiteralExpression(initializer)) {\n          // Handle stories like `export const Primary = { render: () => <Button /> }`\n          const renderProperty = parsePropertyOfType({\n            objectLiteralNode: initializer,\n            propertyName: 'render',\n            predicate: ts.isArrowFunction,\n            parserContext,\n            required: true,\n          })\n\n          if (renderProperty) {\n            statementToParse = renderProperty\n          }\n        }\n      }\n\n      if (!statementToParse) {\n        throw new ParserError(\n          'Expected function declaration, arrow function or render function in story',\n          {\n            sourceFile,\n            node: statement,\n          },\n        )\n      }\n\n      const exampleProps = example?.props ?? propMappings\n\n      let render = parseJSXRenderFunction(statementToParse, parserContext, exampleProps)\n\n      if (!render) {\n        continue\n      }\n\n      const template = render.code ?? `<${componentMetadata.component} />`\n\n      // TODO handle JSDoc on stories\n      codeConnectObjects.push({\n        ...baseCodeConnect,\n        template,\n        variant: example?.variant,\n      })\n    }\n\n    return codeConnectObjects\n  } catch (e) {\n    logger.error(`Error parsing story ${path}: ${e}`)\n    throw e\n  }\n}\n\n/**\n * Get the TS Node representing the component declaration from the story file\n *\n * @param objectLiteralNode Object literal containing the story file metadata\n * @returns TS Node representing the component declaration or undefined\n */\nfunction getComponentDeclaration(\n  objectLiteralNode: ts.ObjectLiteralExpression,\n): ts.Expression | undefined {\n  for (const property of objectLiteralNode.properties) {\n    if (!ts.isPropertyAssignment(property)) continue\n    const propertyName = property.name\n    if (ts.isIdentifier(propertyName) && propertyName.text === 'component') {\n      return property.initializer\n    }\n  }\n  return undefined\n}\n\n/**\n * Validate and returns Figma metadata from the default export of the storybook\n * file\n *\n * @param storyFileMetaNode TS Node containing the story file metadata, i.e. the\n * default export of the file\n * @param sourceFile TS SourceFile representing a single story\n * @returns Figma metadata\n * @throws Error if no Figma metadata is found\n */\nfunction parseStoryMetadata(storyFileMetaNode: ts.Node, parserContext: ParserContext) {\n  const { sourceFile, checker } = parserContext\n  // Find the first object expression under tsSourceFile.statements[0],\n  // which contains the story file metadata. We do it this way to allow syntax\n  // like `export default ({ ... meta ... } as ComponentMeta<...>)`\n  const objectLiteralNode = bfsFindNode(storyFileMetaNode, sourceFile, (node) =>\n    ts.isObjectLiteralExpression(node),\n  )\n\n  if (!objectLiteralNode || !ts.isObjectLiteralExpression(objectLiteralNode)) {\n    logger.debug(`No object literal found in story metadata`)\n    return\n  }\n\n  const componentDeclaration = getComponentDeclaration(objectLiteralNode)\n  if (!componentDeclaration) {\n    logger.debug(`No component declaration found in story metadata`)\n    return\n  }\n\n  const parametersNode = parsePropertyOfType({\n    objectLiteralNode: objectLiteralNode,\n    propertyName: 'parameters',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  // If there's no parameters object, this file shouldn't be imported\n  if (!parametersNode) {\n    logger.debug(`No parameters object found in story metadata`)\n    return\n  }\n\n  const designNode = parsePropertyOfType({\n    objectLiteralNode: parametersNode,\n    propertyName: 'design',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  // If there's no design object, this file shouldn't be imported\n  if (!designNode) {\n    logger.debug(`No design object found in story metadata`)\n    return\n  }\n\n  const typeNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'type',\n    predicate: ts.isStringLiteral,\n    parserContext,\n    errorMessage: '\"type\" property not found in \"design\" object in story metadata',\n    required: false,\n  })\n\n  // If the design is not a Figma design, this file shouldn't be imported\n  if (!typeNode || typeNode.text !== 'figma') {\n    logger.debug(`Design type is not figma`)\n    return\n  }\n\n  const urlNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'url',\n    predicate: ts.isStringLiteral,\n    parserContext,\n    errorMessage: '\"url\" property not found in \"design\" object in story metadata',\n    required: true,\n  })\n\n  const figmaStoryMetadata: FigmaStoryMetadata = {\n    type: typeNode.text,\n    url: urlNode.text,\n  }\n\n  const propMappingNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'props',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  const examplesNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'examples',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  const importsNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'imports',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n    errorMessage: `The 'imports' property must be an array literal. Example usage:\n\\`design: {\n      type: 'figma',\n      url: 'https://www.figma.com/file/123?node-id=1-1',\n      examples: [Button],\n      imports: [\n        'import { Button } from \"./Button\"'\n      ],\n      ...\n})\\``,\n  })\n\n  const linksNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'links',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n    errorMessage: `The 'links' property must be an array literal. Example usage:\n\\`design: {\n      type: 'figma',\n      url: 'https://www.figma.com/file/123?node-id=1-1',\n      examples: [Button],\n      links: [\n        { name: 'Storybook', url: 'https://storybook.com' }\n      ],\n      ...\n})\\``,\n  })\n\n  let links: FigmaConnectLink[] | undefined\n  if (linksNode) {\n    links = parseLinks(linksNode, parserContext)\n  }\n\n  let imports: string[] = []\n  if (importsNode) {\n    imports = parseImports(importsNode, parserContext)\n  }\n\n  let propMappings: {} | undefined\n  let mappedProps: MappedProps\n\n  if (propMappingNode) {\n    mappedProps = new Map()\n    propMappings = parsePropsObject(propMappingNode, parserContext)\n  }\n\n  type Example = {\n    example: string\n    variant?: FigmaConnectMeta['variant']\n    props?: Record<string, any>\n  }\n  let examples: Example[] | undefined\n\n  if (examplesNode) {\n    examples = examplesNode.elements.map((exampleNode) => {\n      if (ts.isStringLiteral(exampleNode) || ts.isIdentifier(exampleNode)) {\n        return { example: exampleNode.text }\n      }\n\n      if (!ts.isObjectLiteralExpression(exampleNode)) {\n        throw new ParserError(\n          `Expected object literal in examples array, got: ${ts.SyntaxKind[exampleNode.kind]}`,\n          {\n            sourceFile,\n            node: exampleNode,\n          },\n        )\n      }\n\n      return convertObjectLiteralToJs(exampleNode, sourceFile, checker, (node) => {\n        if ((node.parent as ts.TypeParameterDeclaration)?.name?.escapedText === 'props') {\n          if (ts.isObjectLiteralExpression(node)) {\n            return parsePropsObject(node, parserContext)\n          }\n        }\n      }) as Example\n    })\n  }\n\n  return {\n    figmaStoryMetadata,\n    componentDeclaration,\n    propMappings,\n    mappedProps,\n    examples,\n    imports,\n    links,\n  }\n}\n"]}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/storybook/convert.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from 'fs'\nimport {\n  bfsFindNode,\n  convertObjectLiteralToJs,\n  getDefaultExport,\n  parsePropertyOfType,\n} from '../typescript/compiler'\nimport {\n  parseComponentMetadata,\n  parseJSXRenderFunction,\n  getDefaultTemplate,\n  findAndResolveImports,\n} from '../react/parser'\nimport {\n  CodeConnectReactConfig,\n  ReactProjectInfo,\n  getRemoteFileUrl,\n  getStorybookUrl,\n} from '../connect/project'\nimport { logger } from '../common/logging'\nimport { CodeConnectJSON } from '../connect/figma_connect'\nimport { CodeConnectLabel, SyntaxHighlightLanguage } from '../connect/label_language_mapping'\nimport ts from 'typescript'\nimport { FigmaConnectLink, FigmaConnectMeta } from '../connect/api'\nimport { minimatch } from 'minimatch'\nimport { parsePropsObject } from '../connect/intrinsics'\nimport {\n  InternalError,\n  parseImports,\n  parseLinks,\n  ParserContext,\n  ParserError,\n} from '../connect/parser_common'\n\ninterface ConvertStorybookFilesArgs {\n  /**\n   * Optionally override the glob used to find stories. This is currently not\n   * exposed in the config, but is used by the tests\n   */\n  storiesGlob?: string\n\n  /**\n   * Information about the project\n   */\n  projectInfo: ReactProjectInfo\n}\n\n/**\n * Converts all Storyboook files in a directory into Code Connect objects. If a file\n * cannot be converted (e.g. unsupported syntax), it is ignored and an error is\n * logged.\n *\n * @param args\n * @returns An array of Code Connect objects\n */\nexport async function convertStorybookFiles({\n  projectInfo,\n  storiesGlob = '**/*.stories.tsx',\n}: ConvertStorybookFilesArgs): Promise<CodeConnectJSON[]> {\n  const { remoteUrl, config, files, tsProgram } = projectInfo\n\n  const storyFiles = files.filter((file) => minimatch(file, storiesGlob, { matchBase: true }))\n  logger.debug(`Story files found:\\n${storyFiles.map((f) => `- ${f}`).join('\\n')}`)\n\n  return Promise.all(\n    storyFiles.map((path) =>\n      convertStorybookFile({ path, tsProgram, config, remoteUrl, absPath: projectInfo.absPath }),\n    ),\n  )\n    .then((f) => f.filter((x): x is NonNullable<typeof x> => Boolean(x)))\n    .then((f) => f.flat())\n}\n\ninterface FigmaStoryMetadata {\n  type: string\n  url: string\n}\n\ninterface ConvertStorybookFileArgs {\n  path: string\n  tsProgram: ts.Program\n  remoteUrl: string\n  config: CodeConnectReactConfig\n  absPath: string\n}\n\ntype MappedPropType = 'FigmaString' | 'FigmaBoolean' | 'Mapped'\ntype MappedProps = Map<string, { figmaName: string; type: MappedPropType }> | undefined\n\nasync function convertStorybookFile({\n  path,\n  tsProgram,\n  remoteUrl,\n  config,\n  absPath,\n}: ConvertStorybookFileArgs): Promise<CodeConnectJSON[] | undefined> {\n  const checker = tsProgram.getTypeChecker()\n  const sourceFile = tsProgram.getSourceFile(path)\n\n  if (!sourceFile) {\n    throw new InternalError(`Source file not found: ${path}`)\n  }\n\n  const parserContext: ParserContext = {\n    checker,\n    config,\n    sourceFile,\n    absPath,\n    resolvedImports: findAndResolveImports(tsProgram, sourceFile),\n  }\n\n  let source = readFileSync(path).toString()\n  // Replace backticks with ' as csf-tools can't parse dynamic titles\n  source = source.replace(/title: `(.*)`/g, (_, title) => {\n    return `title: '${title}'`\n  })\n\n  logger.debug(`Parsing story ${path}`)\n\n  try {\n    // We need to get the default export, which contains the story file meta,\n    // from the TS Program rather than using `babelNodeToTsSourceFile(csf._metaNode)`,\n    // because we need access to the full Program to parse it for prop types etc.\n    const storyFileMetaNode = getDefaultExport(sourceFile)\n    if (!storyFileMetaNode) {\n      return\n    }\n\n    const parseResult = parseStoryMetadata(storyFileMetaNode, parserContext)\n\n    if (!parseResult) {\n      logger.debug(`Could not parse story metadata for ${path}`)\n      return\n    }\n\n    const { figmaStoryMetadata, componentDeclaration, propMappings, examples, imports, links } =\n      parseResult\n\n    const componentMetadata = await parseComponentMetadata(componentDeclaration, parserContext)\n\n    const codeConnectObjects: CodeConnectJSON[] = []\n    const baseCodeConnect: CodeConnectJSON = {\n      figmaNode: figmaStoryMetadata.url,\n      source: config?.storybook?.url\n        ? getStorybookUrl(componentMetadata.source, config.storybook.url)\n        : getRemoteFileUrl(componentMetadata.source, remoteUrl, config?.defaultBranch),\n      sourceLocation: { line: componentMetadata.line },\n      template: '',\n      templateData: {\n        props: propMappings,\n        imports,\n      },\n      links,\n      component: componentMetadata.component,\n      label: CodeConnectLabel.Storybook,\n      language: SyntaxHighlightLanguage.TypeScript,\n      metadata: {\n        cliVersion: require('../../package.json').version,\n      },\n    }\n\n    // If there are no examples, just return a default Code Connect object\n    if (!examples) {\n      codeConnectObjects.push({\n        ...baseCodeConnect,\n        template: getDefaultTemplate(componentMetadata),\n      })\n      return codeConnectObjects\n    }\n\n    for (const statement of sourceFile.statements) {\n      // Find any exported function or variable declarations, which correspond to stories\n      if (!(ts.isFunctionDeclaration(statement) || ts.isVariableStatement(statement))) {\n        continue\n      }\n\n      const name = ts.isFunctionDeclaration(statement)\n        ? statement.name?.text\n        : statement.declarationList.declarations?.[0].name.getText(sourceFile)\n\n      const example = examples?.find((example) => example.example === name)\n      // This story is not in the examples array, so skip it\n      if (examples && !example) {\n        continue\n      }\n\n      let statementToParse: ts.ArrowFunction | ts.FunctionDeclaration | undefined\n\n      if (ts.isFunctionDeclaration(statement)) {\n        statementToParse = statement\n      } else {\n        const initializer = statement.declarationList.declarations[0].initializer\n        if (initializer && ts.isArrowFunction(initializer)) {\n          statementToParse = initializer\n        } else if (initializer && ts.isObjectLiteralExpression(initializer)) {\n          // Handle stories like `export const Primary = { render: () => <Button /> }`\n          const renderProperty = parsePropertyOfType({\n            objectLiteralNode: initializer,\n            propertyName: 'render',\n            predicate: ts.isArrowFunction,\n            parserContext,\n            required: true,\n          })\n\n          if (renderProperty) {\n            statementToParse = renderProperty\n          }\n        }\n      }\n\n      if (!statementToParse) {\n        throw new ParserError(\n          'Expected function declaration, arrow function or render function in story',\n          {\n            sourceFile,\n            node: statement,\n          },\n        )\n      }\n\n      const exampleProps = example?.props ?? propMappings\n\n      let render = parseJSXRenderFunction(statementToParse, parserContext, exampleProps)\n\n      if (!render) {\n        continue\n      }\n\n      const template = render.code ?? `<${componentMetadata.component} />`\n\n      // TODO handle JSDoc on stories\n      codeConnectObjects.push({\n        ...baseCodeConnect,\n        template,\n        variant: example?.variant,\n      })\n    }\n\n    return codeConnectObjects\n  } catch (e) {\n    logger.error(`Error parsing story ${path}: ${e}`)\n    throw e\n  }\n}\n\n/**\n * Get the TS Node representing the component declaration from the story file\n *\n * @param objectLiteralNode Object literal containing the story file metadata\n * @returns TS Node representing the component declaration or undefined\n */\nfunction getComponentDeclaration(\n  objectLiteralNode: ts.ObjectLiteralExpression,\n): ts.Expression | undefined {\n  for (const property of objectLiteralNode.properties) {\n    if (!ts.isPropertyAssignment(property)) continue\n    const propertyName = property.name\n    if (ts.isIdentifier(propertyName) && propertyName.text === 'component') {\n      return property.initializer\n    }\n  }\n  return undefined\n}\n\n/**\n * Validate and returns Figma metadata from the default export of the storybook\n * file\n *\n * @param storyFileMetaNode TS Node containing the story file metadata, i.e. the\n * default export of the file\n * @param sourceFile TS SourceFile representing a single story\n * @returns Figma metadata\n * @throws Error if no Figma metadata is found\n */\nfunction parseStoryMetadata(storyFileMetaNode: ts.Node, parserContext: ParserContext) {\n  const { sourceFile, checker } = parserContext\n  // Find the first object expression under tsSourceFile.statements[0],\n  // which contains the story file metadata. We do it this way to allow syntax\n  // like `export default ({ ... meta ... } as ComponentMeta<...>)`\n  const objectLiteralNode = bfsFindNode(storyFileMetaNode, sourceFile, (node) =>\n    ts.isObjectLiteralExpression(node),\n  )\n\n  if (!objectLiteralNode || !ts.isObjectLiteralExpression(objectLiteralNode)) {\n    logger.debug(`No object literal found in story metadata`)\n    return\n  }\n\n  const componentDeclaration = getComponentDeclaration(objectLiteralNode)\n  if (!componentDeclaration) {\n    logger.debug(`No component declaration found in story metadata`)\n    return\n  }\n\n  const parametersNode = parsePropertyOfType({\n    objectLiteralNode: objectLiteralNode,\n    propertyName: 'parameters',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  // If there's no parameters object, this file shouldn't be imported\n  if (!parametersNode) {\n    logger.debug(`No parameters object found in story metadata`)\n    return\n  }\n\n  const designNode = parsePropertyOfType({\n    objectLiteralNode: parametersNode,\n    propertyName: 'design',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  // If there's no design object, this file shouldn't be imported\n  if (!designNode) {\n    logger.debug(`No design object found in story metadata`)\n    return\n  }\n\n  const typeNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'type',\n    predicate: ts.isStringLiteral,\n    parserContext,\n    errorMessage: '\"type\" property not found in \"design\" object in story metadata',\n    required: false,\n  })\n\n  // If the design is not a Figma design, this file shouldn't be imported\n  if (!typeNode || typeNode.text !== 'figma') {\n    logger.debug(`Design type is not figma`)\n    return\n  }\n\n  const urlNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'url',\n    predicate: ts.isStringLiteral,\n    parserContext,\n    errorMessage: '\"url\" property not found in \"design\" object in story metadata',\n    required: true,\n  })\n\n  const figmaStoryMetadata: FigmaStoryMetadata = {\n    type: typeNode.text,\n    url: urlNode.text,\n  }\n\n  const propMappingNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'props',\n    predicate: ts.isObjectLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  const examplesNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'examples',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n  })\n\n  const importsNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'imports',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n    errorMessage: `The 'imports' property must be an array literal. Example usage:\n\\`design: {\n      type: 'figma',\n      url: 'https://www.figma.com/file/123?node-id=1-1',\n      examples: [Button],\n      imports: [\n        'import { Button } from \"./Button\"'\n      ],\n      ...\n})\\``,\n  })\n\n  const linksNode = parsePropertyOfType({\n    objectLiteralNode: designNode,\n    propertyName: 'links',\n    predicate: ts.isArrayLiteralExpression,\n    parserContext,\n    required: false,\n    errorMessage: `The 'links' property must be an array literal. Example usage:\n\\`design: {\n      type: 'figma',\n      url: 'https://www.figma.com/file/123?node-id=1-1',\n      examples: [Button],\n      links: [\n        { name: 'Storybook', url: 'https://storybook.com' }\n      ],\n      ...\n})\\``,\n  })\n\n  let links: FigmaConnectLink[] | undefined\n  if (linksNode) {\n    links = parseLinks(linksNode, parserContext)\n  }\n\n  let imports: string[] = []\n  if (importsNode) {\n    imports = parseImports(importsNode, parserContext)\n  }\n\n  let propMappings: {} | undefined\n  let mappedProps: MappedProps\n\n  if (propMappingNode) {\n    mappedProps = new Map()\n    propMappings = parsePropsObject(propMappingNode, parserContext)\n  }\n\n  type Example = {\n    example: string\n    variant?: FigmaConnectMeta['variant']\n    props?: Record<string, any>\n  }\n  let examples: Example[] | undefined\n\n  if (examplesNode) {\n    examples = examplesNode.elements.map((exampleNode) => {\n      if (ts.isStringLiteral(exampleNode) || ts.isIdentifier(exampleNode)) {\n        return { example: exampleNode.text }\n      }\n\n      if (!ts.isObjectLiteralExpression(exampleNode)) {\n        throw new ParserError(\n          `Expected object literal in examples array, got: ${ts.SyntaxKind[exampleNode.kind]}`,\n          {\n            sourceFile,\n            node: exampleNode,\n          },\n        )\n      }\n\n      return convertObjectLiteralToJs(exampleNode, sourceFile, checker, (node) => {\n        if ((node.parent as ts.TypeParameterDeclaration)?.name?.escapedText === 'props') {\n          if (ts.isObjectLiteralExpression(node)) {\n            return parsePropsObject(node, parserContext)\n          }\n        }\n      }) as Example\n    })\n  }\n\n  return {\n    figmaStoryMetadata,\n    componentDeclaration,\n    propMappings,\n    mappedProps,\n    examples,\n    imports,\n    links,\n  }\n}\n"]}

package/figma-module.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Type definitions for the `figma` module available in Code Connect template files
+ * (.figma.ts).
+ * Usage: add to your tsconfig.json:
+ *   { "compilerOptions": { "types": ["@figma/code-connect/figma-types"] } }
+ */
+// Declare require() for the 'figma' module so that template files can use
+// `const figma = require('figma')` without needing @types/node installed.
+declare function require(module: 'figma'): typeof import('figma')
+declare function require(module: string): any
+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
+  }
+
+  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
+    __render__(): string
+  }
+
+  export interface TemplateMetadata {
+    nestable?: boolean
+    props?: Record<string, unknown>
+    __props: Record<string, unknown>
+    [key: string]: unknown
+  }
+
+  export interface ErrorHandle {
+    readonly type: 'ERROR'
+    __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 }>
+
+    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 | undefined
+    getSlot(propName: string): ResultSection[] | 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) => 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): ResultSection[] | undefined
+    children(layerNames: string[]): ResultSection[]
+  }
+
+  export type TemplateLiteral = (
+    strings: TemplateStringsArray,
+    ...values: unknown[]
+  ) => TemplateStringResult
+
+  export interface Figma {
+    /** 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[], prefix: string): ResultSection[]
+      }
+      kotlin: {
+        renderChildren(children: ResultSection[], prefix: string): ResultSection[]
+      }
+    }
+  }
+
+  const figma: Figma
+  export = figma
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figma/code-connect",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "A tool for connecting your design system components in code with your design system in Figma",
   "keywords": [],
   "author": "Figma",
@@ -18,6 +18,9 @@
     "./react": {
       "types": "./dist/react/index_react.d.ts",
       "default": "./dist/react/index_react.js"
+    },
+    "./figma-types": {
+      "types": "./figma-module.d.ts"
     }
   },
   "repository": {
@@ -29,7 +32,8 @@
     "figma": "bin/figma"
   },
   "files": [
-    "dist/**/*"
+    "dist/**/*",
+    "figma-module.d.ts"
   ],
   "engines": {
     "node": ">=18"
@@ -83,7 +87,7 @@
     "pkg": "^5.8.1",
     "ts-jest": "^29.2.5",
     "ts-loader": "^9.5.1",
-    "tsx": "^4.11.0",
+    "tsx": "4.21.0",
     "webpack": "5.91.0",
     "webpack-cli": "5.1.4"
   },