@figma/code-connect 0.1.0

package/dist/storybook/convert.js

@@ -0,0 +1,280 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertStorybookFiles = void 0;
+const fs_1 = require("fs");
+const compiler_1 = require("../common/compiler");
+const parser_1 = require("../common/parser");
+const project_1 = require("../common/project");
+const logging_1 = require("../common/logging");
+const typescript_1 = __importDefault(require("typescript"));
+const minimatch_1 = require("minimatch");
+/**
+ * Converts all Storyboook files in a directory into Figmadoc objects. If a file
+ * cannot be converted (e.g. unsupported syntax), it is ignored and an error is
+ * logged.
+ *
+ * @param args
+ * @returns An array of Figmadoc objects
+ */
+async function convertStorybookFiles({ projectInfo, storiesGlob = '**/*.stories.tsx', }) {
+    const { remoteUrl, config, files, tsProgram } = projectInfo;
+    const storyFiles = files.filter((file) => (0, minimatch_1.minimatch)(file, storiesGlob, { matchBase: true }));
+    logging_1.logger.debug(`Story files found:\n${storyFiles.map((f) => `- ${f}`).join('\n')}`);
+    return Promise.all(storyFiles.map((path) => convertStorybookFile({ path, tsProgram, config, remoteUrl })))
+        .then((f) => f.filter((x) => Boolean(x)))
+        .then((f) => f.flat());
+}
+exports.convertStorybookFiles = convertStorybookFiles;
+async function convertStorybookFile({ path, tsProgram, remoteUrl, config, }) {
+    const checker = tsProgram.getTypeChecker();
+    const sourceFile = tsProgram.getSourceFile(path);
+    if (!sourceFile) {
+        throw new parser_1.InternalError(`Source file not found: ${path}`);
+    }
+    const parserContext = {
+        checker,
+        config,
+        sourceFile,
+    };
+    let source = (0, fs_1.readFileSync)(path).toString();
+    // Replace backticks with ' as csf-tools can't parse dynamic titles
+    source = source.replace(/title: `(.*)`/g, (match, title) => {
+        return `title: '${title}'`;
+    });
+    logging_1.logger.debug(`Parsing story ${path}`);
+    try {
+        // We need to get the default export, which contains the story file meta,
+        // from the TS Program rather than using `babelNodeToTsSourceFile(csf._metaNode)`,
+        // because we need access to the full Program to parse it for prop types etc.
+        const storyFileMetaNode = (0, compiler_1.getDefaultExport)(sourceFile);
+        if (!storyFileMetaNode) {
+            return;
+        }
+        const parseResult = parseStoryMetadata(storyFileMetaNode, parserContext);
+        if (!parseResult) {
+            logging_1.logger.debug(`Could not parse story metadata for ${path}`);
+            return;
+        }
+        const { figmaStoryMetadata, componentDeclaration, propMappings, mappedProps, examples } = parseResult;
+        const componentMetadata = await (0, parser_1.parseComponentMetadata)(componentDeclaration, parserContext);
+        const figmadocs = [];
+        const baseFigmadoc = {
+            figmaNode: figmaStoryMetadata.url,
+            source: (0, project_1.getRemoteFileUrl)(componentMetadata.source, remoteUrl),
+            sourceLocation: { line: componentMetadata.line },
+            template: '',
+            templateData: {
+                props: propMappings,
+                imports: [],
+            },
+            component: componentMetadata.component,
+            label: 'Storybook',
+            language: 'typescript',
+            metadata: {
+                cliVersion: require('../../package.json').version,
+            },
+        };
+        // If there are no examples, just return a default Figmadoc
+        if (!examples) {
+            figmadocs.push({
+                ...baseFigmadoc,
+                template: (0, parser_1.getDefaultTemplate)(componentMetadata),
+            });
+            return figmadocs;
+        }
+        for (const statement of sourceFile.statements) {
+            // Find any exported function or variable declarations, which correspond to stories
+            if (!(typescript_1.default.isFunctionDeclaration(statement) || typescript_1.default.isVariableStatement(statement))) {
+                continue;
+            }
+            const name = typescript_1.default.isFunctionDeclaration(statement)
+                ? statement.name?.text
+                : statement.declarationList.declarations?.[0].name.getText(sourceFile);
+            const example = examples?.find((example) => example.example === name);
+            // This story is not in the examples array, so skip it
+            if (examples && !example) {
+                continue;
+            }
+            let statementToParse;
+            if (typescript_1.default.isFunctionDeclaration(statement)) {
+                statementToParse = statement;
+            }
+            else {
+                const initializer = statement.declarationList.declarations[0].initializer;
+                if (initializer && typescript_1.default.isArrowFunction(initializer)) {
+                    statementToParse = initializer;
+                }
+                else if (initializer && typescript_1.default.isObjectLiteralExpression(initializer)) {
+                    // Handle stories like `export const Primary = { render: () => <Button /> }`
+                    const renderProperty = (0, compiler_1.parsePropertyOfType)({
+                        objectLiteralNode: initializer,
+                        propertyName: 'render',
+                        predicate: typescript_1.default.isArrowFunction,
+                        parserContext,
+                        required: true,
+                    });
+                    if (renderProperty) {
+                        statementToParse = renderProperty;
+                    }
+                }
+            }
+            if (!statementToParse) {
+                throw new parser_1.ParserError('Expected function declaration, arrow function or render function in story', {
+                    sourceFile,
+                    node: statement,
+                });
+            }
+            let render = (0, parser_1.parseRenderFunction)(statementToParse, parserContext, propMappings);
+            if (!render) {
+                continue;
+            }
+            const template = render.code ?? `<${componentMetadata.component} />`;
+            // TODO handle JSDoc on stories
+            figmadocs.push({
+                ...baseFigmadoc,
+                template,
+                variant: example?.variant,
+            });
+        }
+        return figmadocs;
+    }
+    catch (e) {
+        logging_1.logger.error(`Error parsing story ${path}: ${e}`);
+        throw e;
+    }
+}
+function isJsxElement(node) {
+    return typescript_1.default.isJsxElement(node) || typescript_1.default.isJsxSelfClosingElement(node) || typescript_1.default.isJsxFragment(node);
+}
+/**
+ * Get the TS Node representing the component declaration from the story file
+ *
+ * @param objectLiteralNode Object literal containing the story file metadata
+ * @returns TS Node representing the component declaration or undefined
+ */
+function getComponentDeclaration(objectLiteralNode) {
+    for (const property of objectLiteralNode.properties) {
+        if (!typescript_1.default.isPropertyAssignment(property))
+            continue;
+        const propertyName = property.name;
+        if (typescript_1.default.isIdentifier(propertyName) && propertyName.text === 'component') {
+            return property.initializer;
+        }
+    }
+    return undefined;
+}
+/**
+ * Validate and returns Figma metadata from the default export of the storybook
+ * file
+ *
+ * @param storyFileMetaNode TS Node containing the story file metadata, i.e. the
+ * default export of the file
+ * @param sourceFile TS SourceFile representing a single story
+ * @returns Figma metadata
+ * @throws Error if no Figma metadata is found
+ */
+function parseStoryMetadata(storyFileMetaNode, parserContext) {
+    const { sourceFile, checker } = parserContext;
+    // Find the first object expression under tsSourceFile.statements[0],
+    // which contains the story file metadata. We do it this way to allow syntax
+    // like `export default ({ ... meta ... } as ComponentMeta<...>)`
+    const objectLiteralNode = (0, compiler_1.bfsFindNode)(storyFileMetaNode, sourceFile, (node) => typescript_1.default.isObjectLiteralExpression(node));
+    if (!objectLiteralNode || !typescript_1.default.isObjectLiteralExpression(objectLiteralNode)) {
+        logging_1.logger.debug(`No object literal found in story metadata`);
+        return;
+    }
+    const componentDeclaration = getComponentDeclaration(objectLiteralNode);
+    if (!componentDeclaration) {
+        logging_1.logger.debug(`No component declaration found in story metadata`);
+        return;
+    }
+    const parametersNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: objectLiteralNode,
+        propertyName: 'parameters',
+        predicate: typescript_1.default.isObjectLiteralExpression,
+        parserContext,
+        required: false,
+    });
+    // If there's no parameters object, this file shouldn't be imported
+    if (!parametersNode) {
+        logging_1.logger.debug(`No parameters object found in story metadata`);
+        return;
+    }
+    const designNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: parametersNode,
+        propertyName: 'design',
+        predicate: typescript_1.default.isObjectLiteralExpression,
+        parserContext,
+        required: false,
+    });
+    // If there's no design object, this file shouldn't be imported
+    if (!designNode) {
+        logging_1.logger.debug(`No design object found in story metadata`);
+        return;
+    }
+    const typeNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: designNode,
+        propertyName: 'type',
+        predicate: typescript_1.default.isStringLiteral,
+        parserContext,
+        errorMessage: '"type" property not found in "design" object in story metadata',
+        required: false,
+    });
+    // If the design is not a Figma design, this file shouldn't be imported
+    if (!typeNode || typeNode.text !== 'figma') {
+        logging_1.logger.debug(`Design type is not figma`);
+        return;
+    }
+    const urlNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: designNode,
+        propertyName: 'url',
+        predicate: typescript_1.default.isStringLiteral,
+        parserContext,
+        errorMessage: '"url" property not found in "design" object in story metadata',
+        required: true,
+    });
+    const figmaStoryMetadata = {
+        type: typeNode.text,
+        url: urlNode.text,
+    };
+    const propMappingNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: designNode,
+        propertyName: 'props',
+        predicate: typescript_1.default.isObjectLiteralExpression,
+        parserContext,
+        required: false,
+    });
+    const examplesNode = (0, compiler_1.parsePropertyOfType)({
+        objectLiteralNode: designNode,
+        propertyName: 'examples',
+        predicate: typescript_1.default.isArrayLiteralExpression,
+        parserContext,
+        required: false,
+    });
+    let propMappings;
+    let mappedProps;
+    if (propMappingNode) {
+        mappedProps = new Map();
+        propMappings = (0, parser_1.parsePropsObject)(propMappingNode, parserContext);
+    }
+    let examples;
+    if (examplesNode) {
+        examples = examplesNode.elements.map((exampleNode) => {
+            if (typescript_1.default.isStringLiteral(exampleNode) || typescript_1.default.isIdentifier(exampleNode)) {
+                return { example: exampleNode.text };
+            }
+            if (!typescript_1.default.isObjectLiteralExpression(exampleNode)) {
+                throw new parser_1.ParserError(`Expected object literal in examples array, got: ${typescript_1.default.SyntaxKind[exampleNode.kind]}`, {
+                    sourceFile,
+                    node: exampleNode,
+                });
+            }
+            return (0, compiler_1.convertObjectLiteralToJs)(exampleNode, sourceFile, checker);
+        });
+    }
+    return { figmaStoryMetadata, componentDeclaration, propMappings, mappedProps, examples };
+}
+//# sourceMappingURL=convert.js.map

package/dist/storybook/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../src/storybook/convert.ts"],"names":[],"mappings":"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"}

package/dist/storybook/external.d.ts

@@ -0,0 +1,32 @@
+import { FigmaConnectMeta } from '../common/api';
+/**
+ * Type for the Storybook `parameters` when using Figma Code Connect. This can
+ * be used in your Storybook default export like:
+ * ```
+ * export default {
+ *   // ...
+ *   parameters: {
+ *     // ...
+ *   } satisfies StoryParameters,
+ * }
+ */
+export type StoryParameters<T = {}> = {
+    design: {
+        type: 'figma';
+        /**
+         * A link to the node in Figma, for example:`https://www.figma.com/file/123abc/My-Component?node-id=123:456`
+         */
+        url: string;
+        /**
+         * Optional array of examples to show in Figma. If none are specified, Figma
+         * will show a default code example.
+         */
+        examples?: (FigmaConnectMeta<T>['example'] | string | ExampleObject<T>)[];
+    } & Pick<FigmaConnectMeta, 'props' | 'links'>;
+};
+type ExampleObject<T> = FigmaConnectMeta<T, string> & {
+    variant?: FigmaConnectMeta['variant'];
+    links?: FigmaConnectMeta['links'];
+};
+export {};
+//# sourceMappingURL=external.d.ts.map

package/dist/storybook/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/storybook/external.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,EAAE,IAAI;IACpC,MAAM,EAAE;QACN,IAAI,EAAE,OAAO,CAAA;QACb;;WAEG;QACH,GAAG,EAAE,MAAM,CAAA;QACX;;;WAGG;QACH,QAAQ,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;KAC1E,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;CAC9C,CAAA;AAED,KAAK,aAAa,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IACpD,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACrC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CAClC,CAAA"}

package/dist/storybook/external.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=external.js.map

package/dist/storybook/external.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/storybook/external.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@figma/code-connect",
+  "version": "0.1.0",
+  "description": "Figma Code Connect",
+  "keywords": [],
+  "author": "Figma",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/figma/code-connect.git"
+  },
+  "homepage": "https://github.com/figma/code-connect#readme",
+  "bin": {
+    "figma": "bin/figma"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "build:web": "pnpm build",
+    "test": "NODE_OPTIONS=--experimental-vm-modules npx jest --coverage",
+    "test-ci": "NODE_OPTIONS=--experimental-vm-modules npx jest --coverage --runInBand",
+    "bundle": "npm run build && npm pack && mkdir -p bundle && mv figma-code-connect*.tgz bundle",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.5",
+    "@types/lodash": "^4.17.0",
+    "@types/node": "^18.17.1",
+    "@types/react": "18.0.26",
+    "jest": "^29.7.0",
+    "pkg": "^5.8.1",
+    "react": "18.2.0",
+    "ts-jest": "^29.1.1",
+    "tsx": "^4.7.0"
+  },
+  "dependencies": {
+    "@babel/core": "^7.23.6",
+    "@babel/generator": "^7.23.6",
+    "@babel/parser": "^7.23.6",
+    "@babel/types": "^7.23.6",
+    "@storybook/csf-tools": "^7.6.7",
+    "axios": "^1.6.0",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.1",
+    "glob": "^10.3.10",
+    "lodash": "^4.17.21",
+    "minimatch": "^9.0.3",
+    "prettier": "^3.2.4",
+    "typescript": "5.4.2"
+  }
+}