@figma/code-connect 1.1.0 → 1.1.2

package/README.md

@@ -1,3 +1,103 @@
-See the [main README](../README.md) for Code Connect documentation.
+# Code Connect
 
-This file gets replaced with the [main README](../README.md) when publishing to npm, so that users see those docs on the npm package page.
+Code Connect is a tool for connecting your design system components in code with your design system in Figma. When using Code Connect, Figma's Dev Mode will display true-to-production code snippets from your design system instead of autogenerated code examples. In addition to connecting component definitions, Code Connect also supports mapping properties from code to Figma enabling dynamic and correct examples. This can be useful for when you have an existing design system and are looking to drive consistent and correct adoption of that design system across design and engineering.
+
+Code Connect is easy to set up, easy to maintain, type-safe, and extensible. Out of the box Code Connect comes with support for React (and React Native), Storybook, HTML (e.g. Web Components, Angular and Vue), SwiftUI and Jetpack Compose.
+
+![image](https://static.figma.com/uploads/d98e747613e01685d6a0f9dd3e2dcd022ff289c0.png)
+
+> [!NOTE]
+> Code Connect is available on Organization and Enterprise plans and requires a full Design or Dev Mode seat to use.
+
+## CLI installation
+
+To install Code Connect locally to a React project, you can follow the instructions in the [React README](https://github.com/figma/code-connect/blob/main/cli/README.md#installation).
+
+For other platforms, you first need to have Node.js v16 or newer installed on your computer. You can check if you already have Node.js installed and which version by running `node -v`. If you need to install Node.js, instructions for all platforms can be found [on the Node.js website](https://nodejs.org/en/download/package-manager).
+
+Once you have Node.js installed, you can install Code Connect globally, so it can be run from anywhere on your machine, by running:
+
+`npm install --global @figma/code-connect`
+
+We hope to provide a way to install Code Connect without requiring Node.js soon.
+
+## Setup
+
+To learn how to implement Code Connect for your platform, please navigate to the platform-specific API usage and documentation.
+
+- [React (or React Native)](https://github.com/figma/code-connect/blob/main/docs/react.md)
+- [HTML (Web Components, Angular, Vue, etc.)](https://github.com/figma/code-connect/blob/main/docs/html.md)
+- [SwiftUI](https://github.com/figma/code-connect/blob/main/docs/swiftui.md)
+- [Jetpack Compose](https://github.com/figma/code-connect/blob/main/docs/compose.md)
+
+## General configuration
+
+Code Connect can be configured with a `figma.config.json` file, which must be located in your project root (e.g. alongside the `package.json` or `.xcodeproj` file).
+
+Every platform supports some common configuration options, in addition to any platform-specific options.
+
+### `include` and `exclude`
+
+`include` and `exclude` are lists of globs for where to parse Code Connect files, and for where to search for your component code when using the [interactive setup](https://github.com/figma/code-connect/blob/main/cli/README.md#interactive-setup). `include` and `exclude` paths must be relative to the location of the config file.
+
+```jsonp
+{
+  "codeConnect": {
+    "include": [],
+    "exclude": ["test/**", "docs/**", "build/**"]
+  }
+}
+```
+
+### `parser`
+
+Code Connect will attempt to determine your project type by looking the first ancestor of the working directory which matches one of the following:
+
+- If a `package.json` containing `react` is found, your project is detected as React
+- If a `package.json` is found not containing `react`, your project is detected as HTML
+- If a file matching `Package.swift` or `*.xcodeproj` is found, your project is detected as Swift
+- If a file matching `build.gradle.kts` is found, your project is detected as Jetpack Compose
+
+In case this does not correctly work for your project, you can override the project type by using the `parser` configuration key. Valid values are `react`, `html`, `swift` and `compose`.
+
+```jsonp
+{
+  "codeConnect": {
+    "parser": "react"
+  }
+}
+```
+
+### `label`
+
+`label` allows you to specify the label used in Figma for your Code Connect docs. This defaults to the type of your project (e.g. `React`). You can override this to show a different name in the UI, which can be useful for e.g. showing different versions of the code.
+
+### `documentUrlSubstitutions`
+
+`documentUrlSubstitutions` allows you to specify a set of substitutions which will be run on the `figmaNode` URLs when parsing or publishing documents.
+
+This allows you to use different config files to switch publishing Code Connect between different files, without having to modify every Code Connect file (e.g. if you have a test version of your document you want to publish to). The substitutions are specified as an object, where the key is the string to be replaced, and the value is the string to replace that with.
+
+For example, the config:
+
+```
+{
+  "codeConnect": {
+    "documentUrlSubstitutions": {
+      "https://figma.com/design/1234abcd/File-1": "https://figma.com/design/5678dcba/File-2"
+    }
+  }
+}
+```
+
+would change Figma node URLs like `https://figma.com/design/1234abcd/File-1/?node-id=12:345` to `https://figma.com/design/5678dbca/File-2/?node-id=12:345`.
+
+## Common issues
+
+### Connectivity issues due to proxies or network security software
+
+Some proxies or network security software can prevent Code Connect from communicating with Figma's servers. If you encounter issues, you may need to explicitly allow connections to `https://api.figma.com/`. Please reach out to [Figma support](https://help.figma.com/hc/en-us/requests/new) if you are still unable to use Code Connect.
+
+### 413 errors due to too large uploads
+
+Please rerun with the `--batch-size` parameter. This will upload the Code Connect in batches of documents of batch_size length. We suggest starting with 50 and decreasing until converging on a size that works for your Code Connect.

package/dist/connect/index_common.js

@@ -15,7 +15,7 @@ exports.getClient = void 0;
 function getClient() {
     let client = {};
     if (typeof process !== 'undefined' && process.versions && process.versions.node) {
-        client = require('./client/external');
+        client = require('../client/external');
     }
     return client;
 }

package/dist/connect/index_common.js.map

@@ -1 +1 @@
-{"version":3,"file":"index_common.js","sourceRoot":"","sources":["../../src/connect/index_common.ts"],"names":[],"mappings":";;;AAEA,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,kCAAkC;AAClC,EAAE;AACF,+EAA+E;AAC/E,0CAA0C;AAE1C,SAAgB,SAAS;IACvB,IAAI,MAAM,GAAuB,EAAS,CAAA;IAC1C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChF,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAND,8BAMC"}
+{"version":3,"file":"index_common.js","sourceRoot":"","sources":["../../src/connect/index_common.ts"],"names":[],"mappings":";;;AAEA,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,kCAAkC;AAClC,EAAE;AACF,+EAA+E;AAC/E,0CAA0C;AAE1C,SAAgB,SAAS;IACvB,IAAI,MAAM,GAAuB,EAAS,CAAA;IAC1C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChF,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAND,8BAMC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figma/code-connect",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A tool for connecting your design system components in code with your design system in Figma",
   "keywords": [],
   "author": "Figma",
@@ -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 && 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 && 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:npm-readme:prepare": "mv README.md ../cli-README.md.bak && cp ../README.md . && npx ts-node ../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",
@@ -56,6 +56,7 @@
     "bundle:cli:mac": "npm run bundle:cli -- -o bundle-cli/figma-mac --target node18-mac-x64,node18-mac-arm64",
     "bundle:cli:mac:arm64": "npm run bundle:cli -- -o bundle-cli/figma-mac-arm64 --target node18-mac-arm64",
     "bundle:cli:win": "npm run bundle:cli -- -o bundle-cli/figma-win --target node18-win-x64",
+    "publish:npm": "npm install && npm run build && npm run bundle:npm-readme:prepare && npm publish --access public; npm run bundle:npm-readme:restore",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {

package/dist/common/__test__/project.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=project.test.d.ts.map

package/dist/common/__test__/project.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.test.d.ts","sourceRoot":"","sources":["../../../src/common/__test__/project.test.ts"],"names":[],"mappings":""}

package/dist/common/__test__/project.test.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const project_1 = require("../../connect/project");
-describe('project functions', () => {
-    describe('getRemoteFileUrl', () => {
-        it('handles git repo urls', () => {
-            expect((0, project_1.getRemoteFileUrl)('/path/file.ts', 'git@github.com:myorg/myrepo.git')).toBe('https://github.com/myorg/myrepo/blob/master/path/file.ts');
-        });
-        it('handles https repo urls', () => {
-            expect((0, project_1.getRemoteFileUrl)('/path/file.ts', 'https://github.com/myorg/myrepo.git')).toBe('https://github.com/myorg/myrepo/blob/master/path/file.ts');
-        });
-    });
-});
-//# sourceMappingURL=project.test.js.map

package/dist/common/__test__/project.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"project.test.js","sourceRoot":"","sources":["../../../src/common/__test__/project.test.ts"],"names":[],"mappings":";;AAAA,mDAAwD;AAExD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,IAAA,0BAAgB,EAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAC/E,0DAA0D,CAC3D,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YACjC,MAAM,CAAC,IAAA,0BAAgB,EAAC,eAAe,EAAE,qCAAqC,CAAC,CAAC,CAAC,IAAI,CACnF,0DAA0D,CAC3D,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/common/api.d.ts

@@ -1,224 +0,0 @@
-/// <reference types="react" />
-export type EnumValue = string | boolean | number | symbol | undefined | JSX.Element | Function | Object;
-export interface FigmaConnectAPI {
-    /**
-     * Defines a code snippet that displays in Figma when a component is selected. This function has two signatures:
-     * - When called with a component reference as the first argument, it will infer metadata such as the import statement
-     * and location in source file from the component reference
-     * - When called only with a Figma node URL, this metadata will not be included. This is useful when you want to display a code snippet
-     * for something that isn't a React component, such as a `<button>` element
-     *
-     * @param component A reference to the React component
-     * @param figmaNodeUrl A link to the node in Figma, for example:`https://www.figma.com/file/123abc/My-Component?node-id=123:456`
-     * @param meta {@link FigmaConnectMeta}
-     */
-    connect<P = {}>(component: any, figmaNodeUrl: string, meta?: FigmaConnectMeta<P>): void;
-    /**
-     * Defines a code snippet that displays in Figma when a component is selected. This function has two signatures:
-     * - When called with a component reference as the first argument, it will infer metadata such as the import statement
-     * and location in source file from the component reference
-     * - When called only with a Figma node URL, this metadata will not be included. This is useful when you want to display a code snippet
-     * for something that isn't a React component, such as a `<button>` element
-     *
-     * @param figmaNodeUrl A link to the node in Figma, for example:`https://www.figma.com/file/123abc/My-Component?node-id=123:456`
-     * @param meta {@link FigmaConnectMeta}
-     */
-    connect<P = {}>(figmaNodeUrl: string, meta?: FigmaConnectMeta<P>): void;
-    /**
-     * Maps a Figma property to a boolean value for the connected component. This prop is replaced
-     * with values from the Figma instance when viewed in Dev Mode. For example:
-     * ```ts
-     * props: {
-     *  disabled: figma.boolean('Disabled'),
-     * }
-     * ```
-     * Would show the `disabled` property if the Figma property "Disabled" is true.
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     */
-    boolean(figmaPropName: string): boolean;
-    /**
-     * Maps a Figma boolean property to a set of values for the connected component, providing
-     * a value mapping for `true` and `false`. This prop is replaced with values from the
-     * Figma instance when viewed in Dev Mode. Example:
-     * ```ts
-     * props: {
-     *  label: figma.boolean('Disabled', {
-     *    true: <Label />,
-     *    false: <HiddenLabel />
-     *  }),
-     * }
-     * ```
-     * Would replace `label` with `<Label />` if the Figma property "Disabled" is true.
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     * @param valueMapping A mapping of values for `true` and `false`
-     */
-    boolean<TrueT extends EnumValue, FalseT extends EnumValue>(figmaPropName: string, valueMapping?: {
-        true?: TrueT;
-        false?: FalseT;
-    }): ValueOf<Record<'true' | 'false', TrueT | FalseT>>;
-    /**
-     * Maps a Figma Variant property to a set if values for the connected component. This prop is replaced
-     * with values from the Figma instance when viewed in Dev Mode. For example:
-     * ```ts
-     * props: {
-     *  type: figma.enum('Type', {
-     *    Primary: 'primary',
-     *     Secondary: 'secondary',
-     *  }),
-     * }
-     * ```
-     * Would output "primary" if the Type Variant in Figma is set to "Primary".
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     * @param valueMapping A mapping of values for the Figma Variant
-     */
-    enum<V extends EnumValue>(figmaPropName: string, valueMapping: Record<string, V>): V;
-    /**
-     * Maps a Figma property to a string value for the connected component. This prop is replaced
-     * with values from the Figma instance when viewed in Dev Mode. For example:
-     * ```ts
-     * props: {
-     *  text: figma.string('Text'),
-     * }
-     * ```
-     * Would replace `text` with the text content from the Figma property "Text".
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     */
-    string(figmaPropName: string): string;
-    /**
-     * Maps a Figma instance property for the connected component. This prop is replaced
-     * with values from the Figma instance when viewed in Dev Mode. For example:
-     * ```ts
-     * props: {
-     *  icon: figma.instance('Icon'),
-     * }
-     * ```
-     * Would show the nested examples for the component passed to the "Icon" property in Figma.
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     */
-    instance(figmaPropName: string): JSX.Element;
-    /**
-     * Maps a Figma instance layer to a nested code example. For example:
-     * ```ts
-     * props: {
-     *  icon: figma.children('Icon')
-     * }
-     * ```
-     * Would show the nested code example for the child instance named 'Icon'. This also supports
-     * an array: `tabs: figma.children(['Tab 1', 'Tab 2'])` to map multiple nested examples.
-     *
-     * You can pass a single wildcard '*' character to match partial names. For example:
-     * ```ts
-     * props: {
-     *   icon: figma.children('Icon*')
-     * }
-     * ```
-     * Would show the nested code example for any child instance which name starts with "Icon"
-     *
-     * @param figmaPropName The name of the property on the Figma component
-     */
-    children(layerNames: string | string[]): JSX.Element;
-    /**
-     * Maps nested properties from a Figma instance layer. The first argument
-     * should be the layer name of the nested instance. The mapping object passed
-     * in is in the same format as the `props` object in the `connect` function.
-     * For example:
-     * ```ts
-     * props: {
-     *   nested: figma.nestedProps('Nested', {
-     *     label: figma.string('Text'),
-     *     icon: figma.instance('Icon'),
-     *   }),
-     * }
-     * Which would then allow you to access the nested properties in the `example` function like so:
-     * ```ts
-     * (props) => <Button label={props.nested.label} icon={props.nested.icon} />
-     * ```
-     */
-    nestedProps<V>(layer: string, input: V): V;
-    /**
-     * Creates a className string by joining an array of strings. The argument supports both
-     * string literals and nested functions like `figma.enum` and `figma.boolean` that return
-     * a string. For example:
-     * ```ts
-     * props: {
-     *   className: figma.className([
-     *     'btn-base',
-     *     figma.enum('Size', { Large: 'btn-large' }),
-     *     figma.boolean('Disabled', { true: 'btn-disabled', false: '' }),
-     *   ]),
-     * }
-     *
-     * @param className
-     */
-    className(className: (string | undefined)[]): string;
-    /**
-     * Maps a Figma text layer to a string value representing the text content of that layer.
-     * This function takes the layer name within the original component as its parameter.
-     * For example:
-     * ```ts
-     * props: {
-     *  text: figma.textContent('Text Layer')
-     * }
-     * ```
-     *
-     * @param layer The name of the text layer in the Figma component
-     */
-    textContent(layer: string): string;
-}
-export type ValueOf<T> = T[keyof T];
-export type PropMapping<T> = {
-    [key in keyof T]: T[key];
-};
-export interface FigmaConnectLink {
-    name: string;
-    url: string;
-}
-export interface FigmaConnectMeta<T = {}, ExtraExampleT = never> {
-    /**
-     * Restricts this figma connect to any variants that fullfill the given filter.
-     * The filter is a map of Figma variant names to values. Example:
-     * ```ts
-     * {
-     *  variant: { "Has Icon": true }
-     * }
-     */
-    variant?: Record<string, string | boolean | number>;
-    /**
-     * Prop mappings for the connected component. This is used to map the values of the component's props
-     * to the values that are used in Figma, using helper functions like `Figma.boolean`. For example:
-     * ```ts
-     * props: {
-     *   disabled: figma.boolean('Disabled'),
-     *   text: figma.string('Text'),
-     *   size: figma.enum('Size', {
-     *     slim: 'slim',
-     *     medium: 'medium',
-     *     large: 'large',
-     *   }),
-     * }
-     */
-    props?: T;
-    /**
-     * The code example to display in Figma. Any mapped `props` is passed to the component,
-     * where those values will be replaced with the mapped value when inspecting that instance in Figma.
-     * @param props
-     * @returns
-     */
-    example?: ((props: T) => React.Component | JSX.Element) | ExtraExampleT;
-    /**
-     * A list of import statements that will render in the Code Snippet in Figma.
-     * This overrides the auto-generated imports for the component. When this is specified,
-     * the `importPaths` option in the config file is also ignored.
-     */
-    imports?: string[];
-    /**
-     * A list of links that will display in Figma along with the examples
-     */
-    links?: FigmaConnectLink[];
-}
-//# sourceMappingURL=api.d.ts.map

package/dist/common/api.d.ts.map

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

package/dist/common/api.js

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

package/dist/common/api.js.map

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

package/dist/common/external.d.ts

@@ -1,14 +0,0 @@
-import { FigmaConnectMeta, PropMapping, ValueOf, EnumValue } from './api';
-import * as React from 'react';
-declare function connectType<P = {}>(_figmaNodeUrl: string, _meta?: FigmaConnectMeta<P>): void;
-declare function connectType<P = {}>(_component: any, _figmaNodeUrl: string, _meta?: FigmaConnectMeta<P>): void;
-declare function booleanType(_figmaPropName: string): boolean;
-declare function enumType<V extends EnumValue>(_figmaPropName: string, _valueMapping: PropMapping<Record<string, V>>): ValueOf<Record<string, V>>;
-declare function stringType(_figmaPropName: string): string;
-declare function instanceType(_figmaPropName: string): React.DetailedReactHTMLElement<React.HTMLAttributes<HTMLElement>, HTMLElement>;
-declare function childrenType(_layers: string | string[]): React.DetailedReactHTMLElement<React.HTMLAttributes<HTMLElement>, HTMLElement>;
-declare function nestedPropsType<T>(_layer: string, props: T): T;
-declare function classNameType(_className: (string | undefined)[]): string;
-declare function textContentType(_layer: string): string;
-export { connectType as connect, booleanType as boolean, enumType as enum, stringType as string, instanceType as instance, childrenType as children, nestedPropsType as nestedProps, classNameType as className, textContentType as textContent, };
-//# sourceMappingURL=external.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/common/external.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACzE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,iBAAS,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;AACtF,iBAAS,WAAW,CAAC,CAAC,GAAG,EAAE,EACzB,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,IAAI,CAAA;AAGP,iBAAS,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAA;AAWrD,iBAAS,QAAQ,CAAC,CAAC,SAAS,SAAS,EACnC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAE5B;AAED,iBAAS,UAAU,CAAC,cAAc,EAAE,MAAM,UAEzC;AAED,iBAAS,YAAY,CAAC,cAAc,EAAE,MAAM,kFAE3C;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,kFAE/C;AAED,iBAAS,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAEnD;AAED,iBAAS,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,UAExD;AAED,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,UAEtC;AAED,OAAO,EACL,WAAW,IAAI,OAAO,EACtB,WAAW,IAAI,OAAO,EACtB,QAAQ,IAAI,IAAI,EAChB,UAAU,IAAI,MAAM,EACpB,YAAY,IAAI,QAAQ,EACxB,YAAY,IAAI,QAAQ,EACxB,eAAe,IAAI,WAAW,EAC9B,aAAa,IAAI,SAAS,EAC1B,eAAe,IAAI,WAAW,GAC/B,CAAA"}

package/dist/common/external.js

@@ -1,65 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.textContent = exports.className = exports.nestedProps = exports.children = exports.instance = exports.string = exports.enum = exports.boolean = exports.connect = void 0;
-const React = __importStar(require("react"));
-function connectType(_component, _figmaNodeUrl, _meta) { }
-exports.connect = connectType;
-function booleanType(_figmaPropName, _valueMapping) {
-    if (_valueMapping) {
-        return enumType(_figmaPropName, _valueMapping);
-    }
-    return true;
-}
-exports.boolean = booleanType;
-function enumType(_figmaPropName, _valueMapping) {
-    return Object.values(_valueMapping)[0];
-}
-exports.enum = enumType;
-function stringType(_figmaPropName) {
-    return '';
-}
-exports.string = stringType;
-function instanceType(_figmaPropName) {
-    return React.createElement('div');
-}
-exports.instance = instanceType;
-function childrenType(_layers) {
-    return React.createElement('div');
-}
-exports.children = childrenType;
-function nestedPropsType(_layer, props) {
-    return props;
-}
-exports.nestedProps = nestedPropsType;
-function classNameType(_className) {
-    return '';
-}
-exports.className = classNameType;
-function textContentType(_layer) {
-    return '';
-}
-exports.textContent = textContentType;
-//# sourceMappingURL=external.js.map

package/dist/common/external.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/common/external.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,6CAA8B;AAQ9B,SAAS,WAAW,CAAC,UAAmB,EAAE,aAAsB,EAAE,KAAe,IAAS,CAAC;AA6C1E,8BAAO;AA1CxB,SAAS,WAAW,CAClB,cAAsB,EACtB,aAA2C;IAE3C,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,QAAQ,CAAI,cAAc,EAAE,aAAa,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAmCgB,8BAAO;AAjCxB,SAAS,QAAQ,CACf,cAAsB,EACtB,aAA6C;IAE7C,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAA+B,CAAA;AACtE,CAAC;AA6Ba,wBAAI;AA3BlB,SAAS,UAAU,CAAC,cAAsB;IACxC,OAAO,EAAE,CAAA;AACX,CAAC;AA0Be,4BAAM;AAxBtB,SAAS,YAAY,CAAC,cAAsB;IAC1C,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC;AAuBiB,gCAAQ;AArB1B,SAAS,YAAY,CAAC,OAA0B;IAC9C,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC;AAoBiB,gCAAQ;AAlB1B,SAAS,eAAe,CAAI,MAAc,EAAE,KAAQ;IAClD,OAAO,KAAK,CAAA;AACd,CAAC;AAiBoB,sCAAW;AAfhC,SAAS,aAAa,CAAC,UAAkC;IACvD,OAAO,EAAE,CAAA;AACX,CAAC;AAckB,kCAAS;AAZ5B,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,EAAE,CAAA;AACX,CAAC;AAWoB,sCAAW"}

package/dist/common/figma_connect.d.ts

@@ -1,26 +0,0 @@
-import { FigmaConnectLink } from './api';
-import { Intrinsic } from './intrinsics';
-export type BaseCodeConnectObject = {
-    figmaNode: string;
-    component?: string;
-    variant?: Record<string, any>;
-    template: string;
-    templateData: {
-        props?: Record<string, Intrinsic>;
-        imports?: string[];
-        nestable?: boolean;
-    };
-    language: string;
-    label: string;
-    links?: FigmaConnectLink[];
-    source?: string;
-    sourceLocation?: {
-        line: number;
-    };
-};
-export type CodeConnectJSON = BaseCodeConnectObject & {
-    metadata: {
-        cliVersion: string;
-    };
-};
-//# sourceMappingURL=figma_connect.d.ts.map

package/dist/common/figma_connect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"figma_connect.d.ts","sourceRoot":"","sources":["../../src/common/figma_connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG;IACpD,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;CACF,CAAA"}

package/dist/common/figma_connect.js

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

package/dist/common/figma_connect.js.map

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

package/dist/common/intrinsics.d.ts

@@ -1,93 +0,0 @@
-import * as ts from 'typescript';
-import { ParserContext } from '../react/parser';
-import { FCCValue } from '../react/parser_template_helpers';
-export declare const API_PREFIX = "figma";
-export declare const FIGMA_CONNECT_CALL = "figma.connect";
-export declare enum IntrinsicKind {
-    Enum = "enum",
-    String = "string",
-    Boolean = "boolean",
-    Instance = "instance",
-    Children = "children",
-    NestedProps = "nested-props",
-    ClassName = "className",
-    TextContent = "text-content"
-}
-export interface IntrinsicBase {
-    kind: IntrinsicKind;
-    args: {};
-}
-export type ValueMappingKind = FCCValue | Intrinsic;
-export interface FigmaBoolean extends IntrinsicBase {
-    kind: IntrinsicKind.Boolean;
-    args: {
-        figmaPropName: string;
-        valueMapping?: Record<'true' | 'false', ValueMappingKind>;
-    };
-}
-export interface FigmaEnum extends IntrinsicBase {
-    kind: IntrinsicKind.Enum;
-    args: {
-        figmaPropName: string;
-        valueMapping: Record<string, ValueMappingKind>;
-    };
-}
-export interface FigmaString extends IntrinsicBase {
-    kind: IntrinsicKind.String;
-    args: {
-        figmaPropName: string;
-    };
-}
-export interface FigmaInstance extends IntrinsicBase {
-    kind: IntrinsicKind.Instance;
-    args: {
-        figmaPropName: string;
-    };
-}
-export interface FigmaChildren extends IntrinsicBase {
-    kind: IntrinsicKind.Children;
-    args: {
-        layers: string[];
-    };
-}
-export interface FigmaNestedProps extends IntrinsicBase {
-    kind: IntrinsicKind.NestedProps;
-    args: {
-        layer: string;
-        props: Record<string, Intrinsic>;
-    };
-}
-export interface FigmaClassName extends IntrinsicBase {
-    kind: IntrinsicKind.ClassName;
-    args: {
-        className: (string | Intrinsic)[];
-    };
-}
-export interface FigmaTextContent extends IntrinsicBase {
-    kind: IntrinsicKind.TextContent;
-    args: {
-        layer: string;
-    };
-}
-export type Intrinsic = FigmaBoolean | FigmaEnum | FigmaString | FigmaInstance | FigmaChildren | FigmaNestedProps | FigmaClassName | FigmaTextContent;
-/**
- * Parses a call expression to an intrinsic
- *
- * @param exp Expression to parse
- * @param parserContext parser context
- * @returns
- */
-export declare function parseIntrinsic(exp: ts.CallExpression, parserContext: ParserContext): Intrinsic;
-export declare function valueMappingToString(valueMapping: Record<string, ValueMappingKind>, childLayer?: string): string;
-export declare function intrinsicToString({ kind, args }: Intrinsic, childLayer?: string): string;
-/**
- * Parses the `props` field in a `figma.connect()` call, returning a mapping of
- * prop names to their respective intrinsic types
- *
- * @param objectLiteral An object literal expression
- * @param parserContext Parser context
- * @returns
- */
-export declare function parsePropsObject(objectLiteral: ts.ObjectLiteralExpression, parserContext: ParserContext): PropMappings;
-export type PropMappings = Record<string, Intrinsic>;
-//# sourceMappingURL=intrinsics.d.ts.map

package/dist/common/intrinsics.d.ts.map

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