@figma/code-connect 1.3.12 → 1.4.0

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,qDAAsC;AACtC,gDAA+D;AAC/D,sDAAgF;AAEhF,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;AAE1B,KAAK,UAAU,GAAG;IAChB,IAAA,+CAAqC,GAAE,CAAA;IAEvC,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAA;IACrF,OAAO,CAAC,uBAAuB,EAAE,CAAA;IAEjC,IAAA,oCAA0B,EAAC,OAAO,CAAC,CAAA;IAEnC,8EAA8E;IAC9E,sCAAsC;IACtC;;;;;;;MAOE;IAEF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,UAAU,EAAE,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAA"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,qDAAsC;AACtC,gDAA+D;AAC/D,sDAAgF;AAEhF,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;AAE1B,KAAK,UAAU,GAAG;IAChB,IAAA,+CAAqC,GAAE,CAAA;IAEvC,MAAM,OAAO,GAAG,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAA;IACrF,OAAO,CAAC,uBAAuB,EAAE,CAAA;IAEjC,IAAA,oCAA0B,EAAC,OAAO,CAAC,CAAA;IAEnC,8EAA8E;IAC9E,sCAAsC;IACtC;;;;;;;MAOE;IAEF,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,UAAU,EAAE,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAA","sourcesContent":["#!/usr/bin/env node\n\nimport * as commander from 'commander'\nimport { addConnectCommandToProgram } from './commands/connect'\nimport { maybePrefillWizardQuestionsForTesting } from './connect/wizard/helpers'\n\nrequire('dotenv').config()\n\nasync function run() {\n  maybePrefillWizardQuestionsForTesting()\n\n  const program = new commander.Command().version(require('./../package.json').version)\n  program.enablePositionalOptions()\n\n  addConnectCommandToProgram(program)\n\n  // Update command is temporarily disabled until we can show the correct update\n  // command to React vs non-React users\n  /*\n  program\n    .command('update')\n    .description('Updates to the latest version of the Figma CLI')\n    .action(() => {\n      updateCli()\n    })\n  */\n\n  program.parse(process.argv)\n  if (program.args.length < 1) {\n    program.outputHelp()\n    process.exit(1)\n  }\n}\n\nrun()\n"]}

package/dist/client/external.js.map

@@ -1 +1 @@
-{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/client/external.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,6GAAA,aAAa,OAAA"}
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/client/external.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,6GAAA,aAAa,OAAA","sourcesContent":["export { getComponents } from './figma_client'\n"]}

package/dist/client/figma_client.js

@@ -34,7 +34,7 @@ async function getComponents(fileOrNode) {
         fileKey,
         figmaUrl: (0, helpers_1.figmaUrlOfComponent)(component, fileKey),
         componentPropertyDefinitions: component.type === 'COMPONENT_SET'
-            ? Object.keys(component.componentPropertyDefinitions).reduce((result, key) => {
+            ? Object.keys(component.componentPropertyDefinitions || {}).reduce((result, key) => {
                 return {
                     ...result,
                     // this removes the ID prefix from property names e.g #123:name -> name

package/dist/client/figma_client.js.map

@@ -1 +1 @@
-{"version":3,"file":"figma_client.js","sourceRoot":"","sources":["../../src/client/figma_client.ts"],"names":[],"mappings":";;AAwCA,sCAmCC;AA3ED,8DAAgF;AAChF,gDAM2B;AAsB3B,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;AAE1B;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,CAAC,CAAA;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,oBAAoB,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IAC1C,IAAI,MAAM,GAAG,IAAA,0BAAS,EAAC,UAAU,IAAI,EAAE,CAAC,GAAG,UAAU,OAAO,EAAE,CAAA;IAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAA,4BAAW,EAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAErE,sFAAsF;IACtF,gFAAgF;IAChF,OAAO,IAAA,kCAAwB,EAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvD,GAAG,SAAS;QACZ,OAAO;QACP,QAAQ,EAAE,IAAA,6BAAmB,EAAC,SAAS,EAAE,OAAO,CAAC;QACjD,4BAA4B,EAC1B,SAAS,CAAC,IAAI,KAAK,eAAe;YAChC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;gBACzE,OAAO;oBACL,GAAG,MAAM;oBACT,uEAAuE;oBACvE,CAAC,IAAA,2BAAiB,EAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC;iBACtE,CAAA;YACH,CAAC,EAAE,EAAE,CAAC;YACR,CAAC,CAAC,SAAS;KAChB,CAAC,CAAC,CAAA;AACL,CAAC"}
+{"version":3,"file":"figma_client.js","sourceRoot":"","sources":["../../src/client/figma_client.ts"],"names":[],"mappings":";;AAwCA,sCAmCC;AA3ED,8DAAgF;AAChF,gDAM2B;AAsB3B,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;AAE1B;;;;;;;;GAQG;AACI,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,CAAC,CAAA;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,UAAU,oBAAoB,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IAC1C,IAAI,MAAM,GAAG,IAAA,0BAAS,EAAC,UAAU,IAAI,EAAE,CAAC,GAAG,UAAU,OAAO,EAAE,CAAA;IAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAA,4BAAW,EAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAErE,sFAAsF;IACtF,gFAAgF;IAChF,OAAO,IAAA,kCAAwB,EAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACvD,GAAG,SAAS;QACZ,OAAO;QACP,QAAQ,EAAE,IAAA,6BAAmB,EAAC,SAAS,EAAE,OAAO,CAAC;QACjD,4BAA4B,EAC1B,SAAS,CAAC,IAAI,KAAK,eAAe;YAChC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC/E,OAAO;oBACL,GAAG,MAAM;oBACT,uEAAuE;oBACvE,CAAC,IAAA,2BAAiB,EAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,4BAA4B,CAAC,GAAG,CAAC;iBACtE,CAAA;YACH,CAAC,EAAE,EAAE,CAAC;YACR,CAAC,CAAC,SAAS;KAChB,CAAC,CAAC,CAAA;AACL,CAAC","sourcesContent":["import { FigmaRestApi, getApiUrl, getDocument } from '../connect/figma_rest_api'\nimport {\n  figmaUrlOfComponent,\n  findComponentsInDocument,\n  normalizePropName,\n  parseFileKey,\n  parseNodeIds,\n} from '../connect/helpers'\n\nexport interface ComponentInfo {\n  id: string\n  name: string\n  fileKey: string\n  figmaUrl: string\n}\n\nexport interface FigmaConnectClient {\n  /**\n   * Fetches components from a figma file, filtering out components that don't\n   * match the provided function.\n   *\n   * @param fileOrNode figma URL\n   * @param match a function that returns true if the component should be\n   * included\n   * @returns a list of components\n   */\n  getComponents: (fileOrNode: string) => Promise<(FigmaRestApi.Component & ComponentInfo)[]>\n}\n\nrequire('dotenv').config()\n\n/**\n * Fetch components from a figma file. If the `node-id` query parameter is used,\n * only components within those frames will be included. This is useful if your\n * file is very large, as this will speed up the query.\n *\n * @param fileOrNode a figma file URL\n * @param match a function that returns true if the component should be included\n * @returns\n */\nexport async function getComponents(fileOrNode: string) {\n  if (!process.env.FIGMA_ACCESS_TOKEN) {\n    throw new Error('FIGMA_ACCESS_TOKEN is not set')\n  }\n\n  const fileKey = parseFileKey(fileOrNode)\n  if (!fileKey) {\n    throw new Error(`Invalid Figma file URL: ${fileOrNode}, file key missing`)\n  }\n\n  const nodeIds = parseNodeIds([fileOrNode])\n  let apiUrl = getApiUrl(fileOrNode ?? '') + `/files/${fileKey}`\n  if (nodeIds.length > 0) {\n    apiUrl += `?ids=${nodeIds.join(',')}`\n  }\n\n  const doc = await getDocument(apiUrl, process.env.FIGMA_ACCESS_TOKEN)\n\n  // `doc` in this case will only include the top frame(s) passed via `ids`. We omit the\n  // nodeIds arg here because we want to return all components within the frame(s)\n  return findComponentsInDocument(doc).map((component) => ({\n    ...component,\n    fileKey,\n    figmaUrl: figmaUrlOfComponent(component, fileKey),\n    componentPropertyDefinitions:\n      component.type === 'COMPONENT_SET'\n        ? Object.keys(component.componentPropertyDefinitions || {}).reduce((result, key) => {\n            return {\n              ...result,\n              // this removes the ID prefix from property names e.g #123:name -> name\n              [normalizePropName(key)]: component.componentPropertyDefinitions[key],\n            }\n          }, {})\n        : undefined,\n  }))\n}\n"]}

package/dist/commands/connect.d.ts

@@ -1,5 +1,5 @@
 import * as commander from 'commander';
-import { ProjectInfo } from '../connect/project';
+import { CodeConnectConfig, ProjectInfo } from '../connect/project';
 import { CodeConnectJSON } from '../connect/figma_connect';
 export type BaseCommand = commander.Command & {
     token: string;
@@ -12,13 +12,14 @@ export type BaseCommand = commander.Command & {
     jsonFile: string;
     skipUpdateCheck: boolean;
     exitOnUnreadableFiles: boolean;
+    apiUrl?: string;
+    removeProps?: boolean;
 };
 export declare function addConnectCommandToProgram(program: commander.Command): void;
 export declare function getAccessToken(cmd: BaseCommand): string;
 export declare function getDir(cmd: BaseCommand): string;
-export declare function parseRawFile(filePath: string, label: string | undefined): CodeConnectJSON;
+export declare function parseRawFile(filePath: string, label: string | undefined, config?: CodeConnectConfig, dir?: string): CodeConnectJSON;
 export declare function getCodeConnectObjects(cmd: BaseCommand & {
     label?: string;
-    includeTemplateFiles?: boolean;
-}, projectInfo: ProjectInfo, silent?: boolean): Promise<CodeConnectJSON[]>;
+}, projectInfo: ProjectInfo, silent?: boolean, skipTemplateHelpers?: boolean): Promise<CodeConnectJSON[]>;
 //# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAKtC,OAAO,EAIL,WAAW,EAKZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAqB1D,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,OAAO,CAAA;IACxB,qBAAqB,EAAE,OAAO,CAAA;CAC/B,CAAA;AAyBD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,QAsDpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,UAE9C;AAcD,wBAAgB,MAAM,CAAC,GAAG,EAAE,WAAW,UAEtC;AA0CD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAmBzF;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAE,EACrE,WAAW,EAAE,WAAW,EACxB,MAAM,UAAQ,GACb,OAAO,CAAC,eAAe,EAAE,CAAC,CAwF5B"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,WAAW,CAAA;AAKtC,OAAO,EACL,iBAAiB,EAIjB,WAAW,EAKZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AA0B1D,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,OAAO,CAAA;IACxB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AA0BD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,QAiEpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,UAE9C;AAcD,wBAAgB,MAAM,CAAC,GAAG,EAAE,WAAW,UAEtC;AA0CD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,GAAG,CAAC,EAAE,MAAM,GACX,eAAe,CAoEjB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACrC,WAAW,EAAE,WAAW,EACxB,MAAM,UAAQ,EACd,mBAAmB,UAAQ,GAC1B,OAAO,CAAC,eAAe,EAAE,CAAC,CAkH5B"}

package/dist/commands/connect.js

@@ -20,11 +20,16 @@ const run_wizard_1 = require("../connect/wizard/run_wizard");
 const parser_executables_1 = require("../connect/parser_executables");
 const zod_validation_error_1 = require("zod-validation-error");
 const parser_executable_types_1 = require("../connect/parser_executable_types");
+const path_1 = __importDefault(require("path"));
 const updates_1 = require("../common/updates");
 const helpers_1 = require("../connect/helpers");
 const parser_1 = require("../html/parser");
 const parser_common_1 = require("../connect/parser_common");
 const parser_2 = require("../react/parser");
+const label_language_mapping_1 = require("../connect/label_language_mapping");
+const migration_helpers_1 = require("../connect/migration_helpers");
+const run_wizard_2 = require("../connect/wizard/run_wizard");
+const project_2 = require("../connect/project");
 function addBaseCommand(command, name, description) {
     return command
         .command(name)
@@ -36,6 +41,7 @@ function addBaseCommand(command, name, description) {
         .option('-o --outFile <file>', 'specify a file to output generated Code Connect')
         .option('-o --outDir <dir>', 'specify a directory to output generated Code Connect')
         .option('-c --config <path>', 'path to a figma config file')
+        .option('-a --api-url <url>', 'custom Figma API URL to use instead of https://api.figma.com/v1')
         .option('--skip-update-check', 'skips checking for an updated version of the Figma CLI')
         .option('--exit-on-unreadable-files', 'exit if any Code Connect files cannot be parsed. We recommend using this option for CI/CD.')
         .option('--dry-run', 'tests publishing without actually publishing')
@@ -50,7 +56,6 @@ function addConnectCommandToProgram(program) {
         'If no config file is found, this parses the current directory. An optional `--dir` flag can be used to specify a directory to parse.')
         .option('--skip-validation', 'skip validation of Code Connect docs')
         .option('-l --label <label>', 'label to apply to the published files')
-        .option('--include-template-files', 'flag to include any figma.template.js files')
         .option('-b --batch-size <batch_size>', 'optional batch size (in number of documents) to use when uploading. Use this if you hit "request too large" errors. See README for more information.')
         .action((0, updates_1.withUpdateCheck)(handlePublish));
     addBaseCommand(connectCommand, 'unpublish', 'Run to find any files that have figma connections and unpublish them from Figma. ' +
@@ -58,15 +63,19 @@ function addConnectCommandToProgram(program) {
         'If no config file is found, this parses the current directory. An optional `--dir` flag can be used to specify a directory to parse.')
         .option('--node <link_to_node>', 'specify the node to unpublish. This will unpublish for the specified label.')
         .option('-l --label <label>', 'label to unpublish for')
-        .option('--include-template-files', 'flag to include any figma.template.js files')
         .action((0, updates_1.withUpdateCheck)(handleUnpublish));
     addBaseCommand(connectCommand, 'parse', 'Run Code Connect locally to find any files that have figma connections, then converts them to JSON and outputs to stdout.')
         .option('-l --label <label>', 'label to apply to the parsed files')
-        .option('--include-template-files', 'flag to include any figma.template.js files')
         .action((0, updates_1.withUpdateCheck)(handleParse));
     addBaseCommand(connectCommand, 'create', 'Generate a Code Connect file with boilerplate in the current directory for a Figma node URL')
         .argument('<figma-node-url>', 'Figma node URL to create the Code Connect file from')
         .action((0, updates_1.withUpdateCheck)(handleCreate));
+    addBaseCommand(connectCommand, 'migrate', 'Parse Code Connect files and migrate their templates into .figma.js files that can be published directly without parsing.')
+        .argument('[pattern]', 'glob pattern to match files (optional, uses config if not provided)')
+        .option('-l --label <label>', 'label to apply to the migrated templates')
+        .option('--output-dir <dir>', 'directory to write template files (default: same directory as source file)')
+        .option('--remove-props', 'remove __props metadata blocks from migrated templates')
+        .action((0, updates_1.withUpdateCheck)(handleMigrate));
 }
 function getAccessToken(cmd) {
     return cmd.token ?? process.env.FIGMA_ACCESS_TOKEN;
@@ -112,29 +121,75 @@ function transformDocFromParser(doc, remoteUrl, config) {
         figmaNode,
     };
 }
-function parseRawFile(filePath, label) {
+function parseRawFile(filePath, label, config, dir) {
     const fileContent = fs_1.default.readFileSync(filePath, 'utf-8');
-    const [firstLine, ...templateLines] = fileContent.split('\n');
-    const figmaNodeUrl = firstLine.replace(/\/\/\s*url=/, '').trim();
-    const template = templateLines.join('\n');
+    const lines = fileContent.split('\n');
+    const fields = {};
+    let templateStartIndex = 0;
+    // Parse consecutive comment lines at the start of the file
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        // Match pattern: // fieldName=value
+        const match = line.match(/^\/\/\s*(\w+)=(.+)$/);
+        if (match) {
+            const [, fieldName, fieldValue] = match;
+            const normalizedFieldName = fieldName.toLowerCase();
+            if (normalizedFieldName === 'url' ||
+                normalizedFieldName === 'component' ||
+                normalizedFieldName === 'source') {
+                fields[normalizedFieldName] = fieldValue.trim();
+            }
+            templateStartIndex = i + 1;
+        }
+        else if (line === '' || line.startsWith('//')) {
+            // Allow blank lines or other comments, but don't increment template start
+            continue;
+        }
+        else {
+            // First non-comment line found
+            break;
+        }
+    }
+    if (!fields.url) {
+        throw new Error(`Missing required url field in ${filePath}. Please add a // url=... comment to the top of the file.`);
+    }
+    let figmaNodeUrl = fields.url;
+    const template = lines.slice(templateStartIndex).join('\n');
+    // Apply documentUrlSubstitutions if provided
+    if (config?.documentUrlSubstitutions) {
+        Object.entries(config.documentUrlSubstitutions).forEach(([from, to]) => {
+            figmaNodeUrl = figmaNodeUrl.replace(from, to);
+        });
+    }
+    // Determine effective label from parameter, config, or default
+    const effectiveLabel = label || config?.label || label_language_mapping_1.CodeConnectLabel.Code;
+    const language = config?.language || (0, label_language_mapping_1.getInferredLanguageForRaw)(effectiveLabel);
     return {
         figmaNode: figmaNodeUrl,
+        component: fields.component,
         template,
-        // nestable by default unless user specifies otherwise
-        templateData: { nestable: true },
-        language: 'raw',
-        label: label || 'Code',
-        source: '',
+        // nestable by default unless user specifies in template
+        // (templateData.nestable AND template.metadata.nestable need to
+        // be true for instance to be nested)
+        templateData: { nestable: true, isParserless: true },
+        language,
+        label: effectiveLabel,
+        source: fields.source,
         sourceLocation: { line: -1 },
         metadata: {
             cliVersion: require('../../package.json').version,
         },
     };
 }
-async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
+async function getCodeConnectObjects(cmd, projectInfo, silent = false, skipTemplateHelpers = false) {
     if (cmd.jsonFile) {
         try {
-            return JSON.parse(fs_1.default.readFileSync(cmd.jsonFile, 'utf8'));
+            const docsFromJson = JSON.parse(fs_1.default.readFileSync(cmd.jsonFile, 'utf8'));
+            // Strip internal fields from JSON input
+            return docsFromJson.map((doc) => {
+                const { _codeConnectFilePath, ...cleanDoc } = doc;
+                return cleanDoc;
+            });
         }
         catch (e) {
             logging_1.logger.error('Failed to parse JSON file:', e);
@@ -142,7 +197,7 @@ async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
     }
     let codeConnectObjects = [];
     if (projectInfo.config.parser === 'react') {
-        codeConnectObjects = await getReactCodeConnectObjects(projectInfo, cmd, silent);
+        codeConnectObjects = await getReactCodeConnectObjects(projectInfo, cmd, silent, skipTemplateHelpers);
     }
     else if (projectInfo.config.parser === 'html') {
         codeConnectObjects = await getCodeConnectObjectsFromParseFn({
@@ -151,13 +206,14 @@ async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
             projectInfo,
             cmd,
             silent,
+            skipTemplateHelpers,
         });
     }
     else {
         const payload = {
             mode: 'PARSE',
             paths: projectInfo.files,
-            config: projectInfo.config,
+            config: { ...projectInfo.config, skipTemplateHelpers },
             verbose: cmd.verbose,
         };
         try {
@@ -188,9 +244,19 @@ async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
             }
         }
     }
-    if (cmd.includeTemplateFiles) {
-        const rawTemplateFiles = projectInfo.files.filter((f) => f.endsWith('.figma.template.js'));
-        const rawTemplateDocs = rawTemplateFiles.map((file) => parseRawFile(file, cmd.label));
+    const rawTemplateFiles = projectInfo.files.filter((f) => f.endsWith('.figma.js') || f.endsWith('.figma.template.js'));
+    if (rawTemplateFiles.length > 0) {
+        // Resolve the label before parsing so language inference works correctly
+        const resolvedLabel = cmd.label || projectInfo.config.label;
+        const rawTemplateDocs = rawTemplateFiles.map((file) => {
+            const doc = parseRawFile(file, resolvedLabel, projectInfo.config, projectInfo.absPath);
+            // Store the Code Connect file path for migration purposes
+            doc._codeConnectFilePath = file;
+            if (!silent || cmd.verbose) {
+                logging_1.logger.info((0, logging_1.success)(file));
+            }
+            return doc;
+        });
         codeConnectObjects = codeConnectObjects.concat(rawTemplateDocs);
     }
     if (cmd.label || projectInfo.config.label) {
@@ -199,6 +265,12 @@ async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
             doc.label = cmd.label || projectInfo.config.label || doc.label;
         });
     }
+    if (projectInfo.config.language) {
+        logging_1.logger.info(`Using language "${projectInfo.config.language}"`);
+        codeConnectObjects.forEach((doc) => {
+            doc.language = projectInfo.config.language || doc.language;
+        });
+    }
     return codeConnectObjects;
 }
 // React/Storybook and HTML parsers are handled as special cases for now, they
@@ -216,7 +288,9 @@ projectInfo,
 /** The commander command object */
 cmd, 
 /** Silences console output */
-silent = false, }) {
+silent = false, 
+/** Skip template helpers (used for extract command) */
+skipTemplateHelpers = false, }) {
     const codeConnectObjects = [];
     const tsProgram = (0, project_1.getTsProgram)(projectInfo);
     const { files, remoteUrl, config, absPath } = projectInfo;
@@ -233,6 +307,7 @@ silent = false, }) {
                     repoUrl: remoteUrl,
                     debug: cmd.verbose,
                     silent,
+                    skipTemplateHelpers,
                 },
             });
             codeConnectObjects.push(...docs);
@@ -268,7 +343,7 @@ silent = false, }) {
     }
     return codeConnectObjects;
 }
-async function getReactCodeConnectObjects(projectInfo, cmd, silent = false) {
+async function getReactCodeConnectObjects(projectInfo, cmd, silent = false, skipTemplateHelpers = false) {
     const codeConnectObjects = await getCodeConnectObjectsFromParseFn({
         parseFn: parser_2.parseReactDoc,
         resolveImportsFn: parser_2.findAndResolveImports,
@@ -276,6 +351,7 @@ async function getReactCodeConnectObjects(projectInfo, cmd, silent = false) {
         projectInfo,
         cmd,
         silent,
+        skipTemplateHelpers,
     });
     const storybookCodeConnectObjects = await (0, convert_1.convertStorybookFiles)({
         projectInfo: (0, project_1.getReactProjectInfo)(projectInfo),
@@ -303,7 +379,7 @@ async function handlePublish(cmd) {
     else {
         logging_1.logger.info('Validating Code Connect files...');
         var start = new Date().getTime();
-        const valid = await (0, validation_1.validateDocs)(cmd, accessToken, codeConnectObjects);
+        const valid = await (0, validation_1.validateDocs)(cmd, accessToken, codeConnectObjects, cmd.apiUrl || projectInfo.config.apiUrl);
         if (!valid) {
             (0, helpers_1.exitWithFeedbackMessage)(1);
         }
@@ -325,7 +401,13 @@ async function handlePublish(cmd) {
             (0, helpers_1.exitWithFeedbackMessage)(1);
         }
     }
-    (0, upload_1.upload)({ accessToken, docs: codeConnectObjects, batchSize: batchSize, verbose: cmd.verbose });
+    (0, upload_1.upload)({
+        accessToken,
+        docs: codeConnectObjects,
+        batchSize: batchSize,
+        verbose: cmd.verbose,
+        apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,
+    });
 }
 async function handleUnpublish(cmd) {
     setupHandler(cmd);
@@ -334,6 +416,7 @@ async function handleUnpublish(cmd) {
         logging_1.logger.info(`Files that would be unpublished:`);
     }
     let nodesToDeleteRelevantInfo;
+    const projectInfo = await (0, project_1.getProjectInfo)(dir, cmd.config);
     if (cmd.node) {
         if (!cmd.label) {
             (0, logging_1.exitWithError)('Label is required when specifying a node');
@@ -341,7 +424,6 @@ async function handleUnpublish(cmd) {
         nodesToDeleteRelevantInfo = [{ figmaNode: cmd.node, label: cmd.label }];
     }
     else {
-        const projectInfo = await (0, project_1.getProjectInfo)(dir, cmd.config);
         const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo);
         nodesToDeleteRelevantInfo = codeConnectObjects.map((doc) => ({
             figmaNode: doc.figmaNode,
@@ -359,6 +441,7 @@ async function handleUnpublish(cmd) {
     (0, delete_docs_1.delete_docs)({
         accessToken,
         docs: nodesToDeleteRelevantInfo,
+        apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,
     });
 }
 async function handleParse(cmd) {
@@ -399,4 +482,139 @@ async function handleCreate(nodeUrl, cmd) {
         cmd,
     });
 }
+/**
+ * Migrate native parser Code Connect files to parserless. For each found doc:
+ * - Replace helpers with figma.* versions
+ * - Migrate v1 syntax to v2 (equivalent but more readable)
+ * - Format as valid parserless file w/ url="" comment
+ * - Name collisions are skipped, unless file is from migration (in which case add "_1")
+ */
+async function handleMigrate(pattern, cmd) {
+    setupHandler(cmd);
+    const dir = cmd.dir ?? process.cwd();
+    let projectInfo = await (0, project_1.getProjectInfo)(dir, cmd.config);
+    const documentUrlSubstitutions = projectInfo.config.documentUrlSubstitutions;
+    // Clear documentUrlSubstitutions so we preserve original URLs in migrated templates
+    projectInfo = {
+        ...projectInfo,
+        config: {
+            ...projectInfo.config,
+            documentUrlSubstitutions: {},
+        },
+    };
+    // If a glob pattern is provided, override the project files
+    if (pattern) {
+        const { globSync } = require('glob');
+        const files = globSync(pattern, {
+            cwd: dir,
+            absolute: true,
+            nodir: true,
+        });
+        if (files.length === 0) {
+            (0, logging_1.exitWithError)(`No files found matching pattern: ${pattern}`);
+        }
+        logging_1.logger.info(`Found ${files.length} file(s) matching pattern: ${pattern}`);
+        projectInfo = {
+            ...projectInfo,
+            files,
+        };
+    }
+    // Parse the files to get Code Connect objects
+    const allCodeConnectObjects = await getCodeConnectObjects(cmd, projectInfo, false, true);
+    const codeConnectObjectsByFigmaUrl = (0, migration_helpers_1.groupCodeConnectObjectsByFigmaUrl)(allCodeConnectObjects);
+    const totalVariants = Object.values(codeConnectObjectsByFigmaUrl).reduce((acc, obj) => acc + obj.variants.length, 0);
+    // TODO support variants (for now filtering on non-variants)
+    const codeConnectObjects = Object.values(codeConnectObjectsByFigmaUrl).flatMap((obj) => obj.main ? [obj.main] : []);
+    if (codeConnectObjects.length === 0) {
+        (0, logging_1.exitWithError)('No Code Connect objects found to migrate');
+    }
+    logging_1.logger.info(`Found ${codeConnectObjects.length} Code Connect object(s) to migrate`);
+    let migratedCount = 0;
+    let skippedCount = 0;
+    const errors = [];
+    // Track file paths created during this migration run
+    const filePathsCreated = new Set();
+    // Get git root path for converting remote URLs to local paths
+    const gitRootPath = (0, project_2.getGitRepoAbsolutePath)(dir);
+    // Migrate each Code Connect object to a template file
+    for (const doc of codeConnectObjects) {
+        try {
+            // Skip if no template (shouldn't happen, but be safe)
+            if (!doc.template) {
+                logging_1.logger.warn(`Skipping ${doc.figmaNode}: no template found`);
+                skippedCount++;
+                continue;
+            }
+            // Determine local source path for output location
+            let localSourcePath;
+            if (doc._codeConnectFilePath) {
+                // Use the Code Connect file path directly (preferred)
+                localSourcePath = doc._codeConnectFilePath;
+            }
+            else if (doc.source && gitRootPath) {
+                // Fallback: Convert remote file URL to local path
+                const relativePath = (0, run_wizard_2.convertRemoteFileUrlToRelativePath)({
+                    remoteFileUrl: doc.source,
+                    gitRootPath,
+                    dir,
+                });
+                if (relativePath) {
+                    // Convert relative path to absolute path for writeTemplateFile
+                    localSourcePath = path_1.default.resolve(dir, relativePath);
+                }
+            }
+            const { outputPath, skipped } = (0, migration_helpers_1.writeTemplateFile)(doc, cmd.outDir, dir, localSourcePath, filePathsCreated, cmd.removeProps);
+            if (skipped) {
+                logging_1.logger.warn(`Skipping ${outputPath}: file already exists`);
+                skippedCount++;
+            }
+            else {
+                logging_1.logger.info(`${(0, logging_1.success)('✓')} Migrated to ${(0, logging_1.highlight)(outputPath)}`);
+                migratedCount++;
+            }
+        }
+        catch (error) {
+            const errorMsg = `Failed to migrate ${doc.figmaNode}: ${error}`;
+            logging_1.logger.error(errorMsg);
+            errors.push(errorMsg);
+        }
+    }
+    if (migratedCount > 0) {
+        if (cmd.outDir) {
+            const configFilePath = path_1.default.join(cmd.outDir, 'figma.config.json');
+            if (fs_1.default.existsSync(configFilePath)) {
+                logging_1.logger.warn(`Config file already exists at ${(0, logging_1.highlight)(configFilePath)}`);
+            }
+            else {
+                const { language: docLanguage, label } = codeConnectObjects[0];
+                const language = (0, label_language_mapping_1.getInferredLanguageForRaw)(label, docLanguage);
+                const config = {
+                    include: ['**/*.figma.js'],
+                    language,
+                    label,
+                    ...(documentUrlSubstitutions && Object.keys(documentUrlSubstitutions).length > 0
+                        ? { documentUrlSubstitutions }
+                        : {}),
+                };
+                fs_1.default.writeFileSync(configFilePath, JSON.stringify({ codeConnect: config }, null, 2));
+                logging_1.logger.info(`${(0, logging_1.success)('✓')} Wrote Figma config to ${(0, logging_1.highlight)(configFilePath)}`);
+            }
+        }
+    }
+    // Summary
+    console.log('');
+    logging_1.logger.info(`Migration complete: ${(0, logging_1.success)(`${migratedCount} migrated`)}, ${skippedCount} skipped`);
+    if (totalVariants > 0) {
+        logging_1.logger.error(`${(0, logging_1.error)(`${totalVariants} variant restriction(s)`)} found, but not supported by the migration script yet`);
+    }
+    if (errors.length > 0) {
+        console.log('');
+        logging_1.logger.error(`Encountered ${errors.length} error(s):`);
+        errors.forEach((err) => logging_1.logger.error(`  ${err}`));
+        process.exit(1);
+    }
+    if (migratedCount === 0) {
+        (0, logging_1.exitWithError)('No files were migrated');
+    }
+}
 //# sourceMappingURL=connect.js.map