@figma/code-connect 1.4.3 → 1.4.4

package/dist/commands/connect_template.js

@@ -0,0 +1,324 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCodeConnectCommandsToProgram = addCodeConnectCommandsToProgram;
+const fs_1 = __importDefault(require("fs"));
+const upload_1 = require("../connect/upload");
+const validation_1 = require("../connect/validation");
+const project_1 = require("../connect/project");
+const logging_1 = require("../common/logging");
+const delete_docs_1 = require("../connect/delete_docs");
+const helpers_1 = require("../connect/helpers");
+const raw_templates_1 = require("../connect/raw_templates");
+const batch_templates_1 = require("../connect/batch_templates");
+const filter_project_info_1 = require("./filter_project_info");
+const create_template_1 = require("../connect/create_template");
+function getAccessTokenOrExit(cmd) {
+    const token = cmd.token;
+    if (!token) {
+        (0, logging_1.exitWithError)(cmd.useOAuth
+            ? `Couldn't find a Figma OAuth token. Please re-authenticate.`
+            : `Couldn't find a Figma access token. Please set the FIGMA_ACCESS_TOKEN environment variable`);
+    }
+    return token;
+}
+function setupHandler(cmd) {
+    if (cmd.verbose) {
+        logging_1.logger.setLogLevel(logging_1.LogLevel.Debug);
+    }
+}
+function getDir(cmd) {
+    return cmd.dir ?? process.cwd();
+}
+/**
+ * Returns Code Connect objects from template files (.figma.ts / .figma.js)
+ * only. Native parser paths (react, html, executable) are intentionally
+ * omitted — this entry point is for parserless/template-file workflows.
+ */
+async function getCodeConnectObjects(cmd, projectInfo, silent = false) {
+    const rawTemplateFiles = projectInfo.files.filter((f) => {
+        const isPotentialRawTemplate = f.endsWith('.figma.js') ||
+            f.endsWith('.figma.template.js') ||
+            f.endsWith('.figma.ts') ||
+            f.endsWith('.figma.template.ts');
+        if (!isPotentialRawTemplate)
+            return false;
+        try {
+            return (0, raw_templates_1.isRawTemplate)(fs_1.default.readFileSync(f, 'utf-8'));
+        }
+        catch {
+            return false;
+        }
+    });
+    let codeConnectObjects = [];
+    if (rawTemplateFiles.length > 0) {
+        const resolvedLabel = cmd.label || projectInfo.config.label;
+        const rawTemplateDocs = [];
+        for (const file of rawTemplateFiles) {
+            try {
+                const doc = (0, raw_templates_1.parseRawFile)(file, resolvedLabel, projectInfo.config, projectInfo.absPath);
+                doc._codeConnectFilePath = file;
+                if (!silent || cmd.verbose) {
+                    logging_1.logger.info((0, logging_1.success)(file));
+                }
+                rawTemplateDocs.push(doc);
+            }
+            catch (e) {
+                if (!silent || cmd.verbose) {
+                    logging_1.logger.error(`❌ ${file}`);
+                    if (cmd.verbose) {
+                        console.trace(e);
+                    }
+                    else {
+                        logging_1.logger.error(e instanceof Error ? e.message : String(e));
+                    }
+                }
+                if (cmd.exitOnUnreadableFiles) {
+                    logging_1.logger.info('Exiting due to unreadable files');
+                    process.exit(1);
+                }
+            }
+        }
+        codeConnectObjects = codeConnectObjects.concat(rawTemplateDocs);
+    }
+    // Process batch files (.figma.batch.json)
+    const batchFiles = projectInfo.files.filter((f) => f.endsWith('.figma.batch.json'));
+    if (batchFiles.length > 0) {
+        const resolvedLabel = cmd.label || projectInfo.config.label;
+        for (const file of batchFiles) {
+            try {
+                const docs = (0, batch_templates_1.parseBatchFile)(file, resolvedLabel, projectInfo.config, projectInfo.absPath);
+                docs.forEach((doc) => {
+                    doc._codeConnectFilePath = file;
+                });
+                codeConnectObjects = codeConnectObjects.concat(docs);
+                if (!silent || cmd.verbose) {
+                    logging_1.logger.info((0, logging_1.success)(`${file} (${docs.length} components)`));
+                }
+            }
+            catch (e) {
+                logging_1.logger.error(`${file}: ${e}`);
+                if (cmd.exitOnUnreadableFiles) {
+                    process.exit(1);
+                }
+            }
+        }
+    }
+    if (cmd.label || projectInfo.config.label) {
+        logging_1.logger.info(`Using label "${cmd.label || projectInfo.config.label}"`);
+        codeConnectObjects.forEach((doc) => {
+            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;
+}
+async function handlePublish(cmd) {
+    setupHandler(cmd);
+    let dir = getDir(cmd);
+    const projectInfo = (0, filter_project_info_1.filterProjectInfoByFile)(await (0, project_1.getProjectInfo)(dir, cmd.config, true), cmd.file);
+    const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo);
+    if (codeConnectObjects.length === 0) {
+        logging_1.logger.warn(`No Code Connect files found in ${dir} - Make sure you have configured \`include\` and \`exclude\` in your figma.config.json file correctly, or that you are running in a directory that contains Code Connect files.`);
+        process.exit(0);
+    }
+    if (cmd.dryRun) {
+        logging_1.logger.info(`Files that would be published:`);
+        logging_1.logger.info(codeConnectObjects.map((o) => `- ${o.component} (${o.figmaNode})`).join('\n'));
+    }
+    const accessToken = getAccessTokenOrExit(cmd);
+    if (cmd.skipValidation) {
+        logging_1.logger.info('Validation skipped');
+    }
+    else {
+        logging_1.logger.info('Validating Code Connect files...');
+        const start = new Date().getTime();
+        const valid = await (0, validation_1.validateDocs)(cmd, accessToken, codeConnectObjects, cmd.apiUrl || projectInfo.config.apiUrl, cmd.useOAuth);
+        if (!valid) {
+            (0, helpers_1.exitWithFeedbackMessage)(1);
+        }
+        else {
+            const end = new Date().getTime();
+            const time = end - start;
+            logging_1.logger.info(`All Code Connect files are valid (${time}ms)`);
+        }
+    }
+    if (cmd.dryRun) {
+        logging_1.logger.info(`Dry run complete`);
+        process.exit(0);
+    }
+    let batchSize;
+    if (cmd.batchSize) {
+        batchSize = parseInt(cmd.batchSize, 10);
+        if (isNaN(batchSize)) {
+            logging_1.logger.error('Error: failed to parse batch-size. batch-size passed must be a number');
+            (0, helpers_1.exitWithFeedbackMessage)(1);
+        }
+    }
+    (0, upload_1.upload)({
+        accessToken,
+        useOAuth: cmd.useOAuth,
+        docs: codeConnectObjects,
+        batchSize,
+        verbose: cmd.verbose,
+        apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,
+        force: cmd.force,
+    });
+}
+async function handleUnpublish(cmd) {
+    setupHandler(cmd);
+    let dir = getDir(cmd);
+    if (cmd.dryRun) {
+        logging_1.logger.info(`Files that would be unpublished:`);
+    }
+    let nodesToDeleteRelevantInfo;
+    const projectInfo = (0, filter_project_info_1.filterProjectInfoByFile)(await (0, project_1.getProjectInfo)(dir, cmd.config, true), cmd.file);
+    if (cmd.node) {
+        if (!cmd.label) {
+            (0, logging_1.exitWithError)('Label is required when specifying a node');
+        }
+        nodesToDeleteRelevantInfo = [{ figmaNode: cmd.node, label: cmd.label }];
+    }
+    else {
+        const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo);
+        nodesToDeleteRelevantInfo = codeConnectObjects.map((doc) => ({
+            figmaNode: doc.figmaNode,
+            label: cmd.label || projectInfo.config.label || doc.label,
+        }));
+        if (cmd.label || projectInfo.config.label) {
+            logging_1.logger.info(`Using label ${cmd.label || projectInfo.config.label}`);
+        }
+        if (cmd.dryRun) {
+            logging_1.logger.info(`Dry run complete`);
+            process.exit(0);
+        }
+    }
+    const accessToken = getAccessTokenOrExit(cmd);
+    (0, delete_docs_1.delete_docs)({
+        accessToken,
+        useOAuth: cmd.useOAuth,
+        docs: nodesToDeleteRelevantInfo,
+        apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,
+    });
+}
+async function handleParse(cmd) {
+    setupHandler(cmd);
+    const dir = cmd.dir ?? process.cwd();
+    const projectInfo = (0, filter_project_info_1.filterProjectInfoByFile)(await (0, project_1.getProjectInfo)(dir, cmd.config, true), cmd.file);
+    const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo);
+    if (cmd.dryRun) {
+        logging_1.logger.info(`Dry run complete`);
+        process.exit(0);
+    }
+    if (cmd.outFile) {
+        fs_1.default.writeFileSync(cmd.outFile, JSON.stringify(codeConnectObjects, null, 2));
+        logging_1.logger.info(`Wrote Code Connect JSON to ${(0, logging_1.highlight)(cmd.outFile)}`);
+    }
+    else {
+        console.log(JSON.stringify(codeConnectObjects, undefined, 2));
+    }
+}
+async function handleCreate(nodeUrl, cmd) {
+    setupHandler(cmd);
+    const dir = getDir(cmd);
+    const projectInfo = await (0, project_1.getProjectInfo)(dir, cmd.config, true);
+    const accessToken = getAccessTokenOrExit(cmd);
+    return (0, create_template_1.createCodeConnectFromUrl)({
+        accessToken,
+        figmaNodeUrl: nodeUrl.replace(/\\/g, ''),
+        outFile: cmd.outFile,
+        outDir: cmd.outDir,
+        projectInfo,
+        cmd,
+    });
+}
+/**
+ * Registers Code Connect commands on a commander program, restricted to
+ * template-file workflows only. Intended for use by CLIs that support
+ * Code Connect during a migration period but do not need native parsers.
+ *
+ * Note: does NOT use addBaseCommand internally because that function registers
+ * both `-o --outFile` and `-o --outDir` with the same `-o` short flag.
+ * commander@12+ (used by litmus-cli) throws a conflict error on duplicate flags.
+ */
+function addCodeConnectCommandsToProgram(program, programOptions = {}) {
+    function addBase(parent, name, description) {
+        return parent
+            .command(name)
+            .description(description)
+            .usage('[options]')
+            .option('-r --dir <dir>', 'directory to parse')
+            .option('-f --file <file>', 'path to a single Code Connect file to process')
+            .option('--outFile <file>', 'specify a file to output generated Code Connect')
+            .option('--outDir <dir>', 'specify a directory to output generated Code Connect')
+            .option('-c --config <path>', 'path to a figma config file')
+            .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')
+            .addHelpText('before', 'For feedback or bugs, please raise an issue: https://github.com/figma/code-connect/issues');
+    }
+    function wrapHandler(handler) {
+        return (options, cmd) => {
+            const globalOpts = cmd.optsWithGlobals();
+            // Attempt to get a token from the provided getter (e.g. OAuth store).
+            // If it returns undefined or throws (e.g. no OAuth token stored in CI),
+            // fall back to FIGMA_ACCESS_TOKEN and use PAT headers.
+            let oauthToken;
+            try {
+                oauthToken = programOptions.getToken?.();
+            }
+            catch {
+                // getToken threw (e.g. no OAuth token stored); fall back to PAT below
+            }
+            const token = oauthToken ?? process.env.FIGMA_ACCESS_TOKEN;
+            const useOAuth = oauthToken !== undefined;
+            return handler({
+                ...options,
+                token,
+                useOAuth,
+                verbose: globalOpts.logLevel === 'debug',
+                apiUrl: globalOpts.apiBaseUrl,
+            }).catch((err) => {
+                // Commander v12 catches rejected action promises internally and exits 0.
+                // Commander v11 left them as unhandled rejections, and Node.js 15+ would
+                // exit 1 for those — so exit code 1 on handler errors was previously
+                // accidental. This catch makes it explicit and version-independent.
+                logging_1.logger.error(err.message);
+                process.exitCode = 1;
+            });
+        };
+    }
+    const connectCommand = program
+        .command('connect')
+        .description('Code Connect commands')
+        .addHelpText('before', 'For feedback or bugs, please raise an issue: https://github.com/figma/code-connect/issues');
+    connectCommand.action(() => connectCommand.help());
+    addBase(connectCommand, 'publish', 'Run Code Connect locally to find any files that have figma connections and publish them to Figma. ' +
+        'By default this looks for a config file named "figma.config.json", and uses the `include` and `exclude` fields to determine which files to parse. ' +
+        '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('-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.')
+        .option('--force', 'overwrite existing UI-created Code Connect mappings if they conflict with the files being published')
+        .action(wrapHandler(handlePublish));
+    addBase(connectCommand, 'unpublish', 'Run to find any files that have figma connections and unpublish them from Figma. ' +
+        'By default this looks for a config file named "figma.config.json", and uses the `include` and `exclude` fields to determine which files to parse. ' +
+        'If no config file is found, this parses the current directory. An optional `--dir` flag can be used to specify a directory to parse. ' +
+        'Alternatively, use `--node` and `--label` to unpublish a specific component.')
+        .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')
+        .action(wrapHandler(handleUnpublish));
+    addBase(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')
+        .action(wrapHandler(handleParse));
+    addBase(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((nodeUrl, options, cmd) => wrapHandler((mergedCmd) => handleCreate(nodeUrl, mergedCmd))(options, cmd));
+}
+//# sourceMappingURL=connect_template.js.map

package/dist/commands/connect_template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect_template.js","sourceRoot":"","sources":["../../src/commands/connect_template.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Slim Code Connect entry point template-files-only support.\n */\nimport * as commander from 'commander'\nimport fs from 'fs'\nimport { upload } from '../connect/upload'\nimport { validateDocs } from '../connect/validation'\nimport { ProjectInfo, getProjectInfo } from '../connect/project'\nimport { LogLevel, exitWithError, highlight, logger, success } from '../common/logging'\nimport { CodeConnectJSON } from '../connect/figma_connect'\nimport { delete_docs } from '../connect/delete_docs'\nimport { exitWithFeedbackMessage } from '../connect/helpers'\nimport { isRawTemplate, parseRawFile } from '../connect/raw_templates'\nimport { parseBatchFile } from '../connect/batch_templates'\nimport { filterProjectInfoByFile } from './filter_project_info'\nimport { createCodeConnectFromUrl } from '../connect/create_template'\n\nexport type BaseCommand = commander.Command & {\n  token: string\n  useOAuth: boolean\n  verbose: boolean\n  outFile: string\n  outDir: string\n  config: string\n  dryRun: boolean\n  dir: string\n  file: string\n  jsonFile: string\n  skipUpdateCheck: boolean\n  exitOnUnreadableFiles: boolean\n  apiUrl?: string\n  includeProps?: boolean\n}\n\nfunction getAccessTokenOrExit(cmd: BaseCommand): string {\n  const token = cmd.token\n  if (!token) {\n    exitWithError(\n      cmd.useOAuth\n        ? `Couldn't find a Figma OAuth token. Please re-authenticate.`\n        : `Couldn't find a Figma access token. Please set the FIGMA_ACCESS_TOKEN environment variable`,\n    )\n  }\n  return token\n}\n\nfunction setupHandler(cmd: BaseCommand) {\n  if (cmd.verbose) {\n    logger.setLogLevel(LogLevel.Debug)\n  }\n}\n\nfunction getDir(cmd: BaseCommand) {\n  return cmd.dir ?? process.cwd()\n}\n\n/**\n * Returns Code Connect objects from template files (.figma.ts / .figma.js)\n * only. Native parser paths (react, html, executable) are intentionally\n * omitted — this entry point is for parserless/template-file workflows.\n */\nasync function getCodeConnectObjects(\n  cmd: BaseCommand & { label?: string },\n  projectInfo: ProjectInfo,\n  silent = false,\n): Promise<CodeConnectJSON[]> {\n  const rawTemplateFiles = projectInfo.files.filter((f: string) => {\n    const isPotentialRawTemplate =\n      f.endsWith('.figma.js') ||\n      f.endsWith('.figma.template.js') ||\n      f.endsWith('.figma.ts') ||\n      f.endsWith('.figma.template.ts')\n    if (!isPotentialRawTemplate) return false\n    try {\n      return isRawTemplate(fs.readFileSync(f, 'utf-8'))\n    } catch {\n      return false\n    }\n  })\n\n  let codeConnectObjects: CodeConnectJSON[] = []\n\n  if (rawTemplateFiles.length > 0) {\n    const resolvedLabel = cmd.label || projectInfo.config.label\n    const rawTemplateDocs: CodeConnectJSON[] = []\n    for (const file of rawTemplateFiles) {\n      try {\n        const doc = parseRawFile(file, resolvedLabel, projectInfo.config, projectInfo.absPath)\n        doc._codeConnectFilePath = file\n        if (!silent || cmd.verbose) {\n          logger.info(success(file))\n        }\n        rawTemplateDocs.push(doc)\n      } catch (e) {\n        if (!silent || cmd.verbose) {\n          logger.error(`❌ ${file}`)\n          if (cmd.verbose) {\n            console.trace(e)\n          } else {\n            logger.error(e instanceof Error ? e.message : String(e))\n          }\n        }\n        if (cmd.exitOnUnreadableFiles) {\n          logger.info('Exiting due to unreadable files')\n          process.exit(1)\n        }\n      }\n    }\n    codeConnectObjects = codeConnectObjects.concat(rawTemplateDocs)\n  }\n\n  // Process batch files (.figma.batch.json)\n  const batchFiles = projectInfo.files.filter((f: string) => f.endsWith('.figma.batch.json'))\n\n  if (batchFiles.length > 0) {\n    const resolvedLabel = cmd.label || projectInfo.config.label\n\n    for (const file of batchFiles) {\n      try {\n        const docs = parseBatchFile(file, resolvedLabel, projectInfo.config, projectInfo.absPath)\n        docs.forEach((doc) => {\n          doc._codeConnectFilePath = file\n        })\n        codeConnectObjects = codeConnectObjects.concat(docs)\n        if (!silent || cmd.verbose) {\n          logger.info(success(`${file} (${docs.length} components)`))\n        }\n      } catch (e) {\n        logger.error(`${file}: ${e}`)\n        if (cmd.exitOnUnreadableFiles) {\n          process.exit(1)\n        }\n      }\n    }\n  }\n\n  if (cmd.label || projectInfo.config.label) {\n    logger.info(`Using label \"${cmd.label || projectInfo.config.label}\"`)\n    codeConnectObjects.forEach((doc) => {\n      doc.label = cmd.label || projectInfo.config.label || doc.label\n    })\n  }\n\n  if (projectInfo.config.language) {\n    logger.info(`Using language \"${projectInfo.config.language}\"`)\n    codeConnectObjects.forEach((doc) => {\n      doc.language = projectInfo.config.language || doc.language\n    })\n  }\n\n  return codeConnectObjects\n}\n\nasync function handlePublish(\n  cmd: BaseCommand & {\n    skipValidation: boolean\n    label: string\n    batchSize: string\n    force?: boolean\n  },\n) {\n  setupHandler(cmd)\n\n  let dir = getDir(cmd)\n  const projectInfo = filterProjectInfoByFile(await getProjectInfo(dir, cmd.config, true), cmd.file)\n  const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo)\n\n  if (codeConnectObjects.length === 0) {\n    logger.warn(\n      `No Code Connect files found in ${dir} - Make sure you have configured \\`include\\` and \\`exclude\\` in your figma.config.json file correctly, or that you are running in a directory that contains Code Connect files.`,\n    )\n    process.exit(0)\n  }\n\n  if (cmd.dryRun) {\n    logger.info(`Files that would be published:`)\n    logger.info(codeConnectObjects.map((o) => `- ${o.component} (${o.figmaNode})`).join('\\n'))\n  }\n\n  const accessToken = getAccessTokenOrExit(cmd)\n\n  if (cmd.skipValidation) {\n    logger.info('Validation skipped')\n  } else {\n    logger.info('Validating Code Connect files...')\n    const start = new Date().getTime()\n    const valid = await validateDocs(\n      cmd,\n      accessToken,\n      codeConnectObjects,\n      cmd.apiUrl || projectInfo.config.apiUrl,\n      cmd.useOAuth,\n    )\n    if (!valid) {\n      exitWithFeedbackMessage(1)\n    } else {\n      const end = new Date().getTime()\n      const time = end - start\n      logger.info(`All Code Connect files are valid (${time}ms)`)\n    }\n  }\n\n  if (cmd.dryRun) {\n    logger.info(`Dry run complete`)\n    process.exit(0)\n  }\n\n  let batchSize\n  if (cmd.batchSize) {\n    batchSize = parseInt(cmd.batchSize, 10)\n    if (isNaN(batchSize)) {\n      logger.error('Error: failed to parse batch-size. batch-size passed must be a number')\n      exitWithFeedbackMessage(1)\n    }\n  }\n\n  upload({\n    accessToken,\n    useOAuth: cmd.useOAuth,\n    docs: codeConnectObjects,\n    batchSize,\n    verbose: cmd.verbose,\n    apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,\n    force: cmd.force,\n  })\n}\n\nasync function handleUnpublish(cmd: BaseCommand & { node: string; label: string }) {\n  setupHandler(cmd)\n\n  let dir = getDir(cmd)\n\n  if (cmd.dryRun) {\n    logger.info(`Files that would be unpublished:`)\n  }\n\n  let nodesToDeleteRelevantInfo\n\n  const projectInfo = filterProjectInfoByFile(await getProjectInfo(dir, cmd.config, true), cmd.file)\n\n  if (cmd.node) {\n    if (!cmd.label) {\n      exitWithError('Label is required when specifying a node')\n    }\n    nodesToDeleteRelevantInfo = [{ figmaNode: cmd.node, label: cmd.label }]\n  } else {\n    const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo)\n\n    nodesToDeleteRelevantInfo = codeConnectObjects.map((doc) => ({\n      figmaNode: doc.figmaNode,\n      label: cmd.label || projectInfo.config.label || doc.label,\n    }))\n\n    if (cmd.label || projectInfo.config.label) {\n      logger.info(`Using label ${cmd.label || projectInfo.config.label}`)\n    }\n\n    if (cmd.dryRun) {\n      logger.info(`Dry run complete`)\n      process.exit(0)\n    }\n  }\n\n  const accessToken = getAccessTokenOrExit(cmd)\n\n  delete_docs({\n    accessToken,\n    useOAuth: cmd.useOAuth,\n    docs: nodesToDeleteRelevantInfo,\n    apiUrl: cmd.apiUrl || projectInfo.config.apiUrl,\n  })\n}\n\nasync function handleParse(cmd: BaseCommand & { label: string }) {\n  setupHandler(cmd)\n\n  const dir = cmd.dir ?? process.cwd()\n  const projectInfo = filterProjectInfoByFile(await getProjectInfo(dir, cmd.config, true), cmd.file)\n  const codeConnectObjects = await getCodeConnectObjects(cmd, projectInfo)\n\n  if (cmd.dryRun) {\n    logger.info(`Dry run complete`)\n    process.exit(0)\n  }\n\n  if (cmd.outFile) {\n    fs.writeFileSync(cmd.outFile, JSON.stringify(codeConnectObjects, null, 2))\n    logger.info(`Wrote Code Connect JSON to ${highlight(cmd.outFile)}`)\n  } else {\n    console.log(JSON.stringify(codeConnectObjects, undefined, 2))\n  }\n}\n\nasync function handleCreate(nodeUrl: string, cmd: BaseCommand) {\n  setupHandler(cmd)\n\n  const dir = getDir(cmd)\n  const projectInfo = await getProjectInfo(dir, cmd.config, true)\n\n  const accessToken = getAccessTokenOrExit(cmd)\n\n  return createCodeConnectFromUrl({\n    accessToken,\n    figmaNodeUrl: nodeUrl.replace(/\\\\/g, ''),\n    outFile: cmd.outFile,\n    outDir: cmd.outDir,\n    projectInfo,\n    cmd,\n  })\n}\n\ninterface ProgramOptions {\n  /** Override how the auth token is retrieved. Return undefined to fall back to FIGMA_ACCESS_TOKEN. */\n  getToken?: () => string | undefined\n}\n\n/**\n * Registers Code Connect commands on a commander program, restricted to\n * template-file workflows only. Intended for use by CLIs that support\n * Code Connect during a migration period but do not need native parsers.\n *\n * Note: does NOT use addBaseCommand internally because that function registers\n * both `-o --outFile` and `-o --outDir` with the same `-o` short flag.\n * commander@12+ (used by litmus-cli) throws a conflict error on duplicate flags.\n */\nexport function addCodeConnectCommandsToProgram(\n  program: commander.Command,\n  programOptions: ProgramOptions = {},\n) {\n  function addBase(parent: commander.Command, name: string, description: string) {\n    return parent\n      .command(name)\n      .description(description)\n      .usage('[options]')\n      .option('-r --dir <dir>', 'directory to parse')\n      .option('-f --file <file>', 'path to a single Code Connect file to process')\n      .option('--outFile <file>', 'specify a file to output generated Code Connect')\n      .option('--outDir <dir>', 'specify a directory to output generated Code Connect')\n      .option('-c --config <path>', 'path to a figma config file')\n      .option(\n        '--exit-on-unreadable-files',\n        'exit if any Code Connect files cannot be parsed. We recommend using this option for CI/CD.',\n      )\n      .option('--dry-run', 'tests publishing without actually publishing')\n      .addHelpText(\n        'before',\n        'For feedback or bugs, please raise an issue: https://github.com/figma/code-connect/issues',\n      )\n  }\n\n  function wrapHandler<T extends BaseCommand>(handler: (cmd: T) => Promise<void>) {\n    return (options: unknown, cmd: commander.Command) => {\n      const globalOpts = cmd.optsWithGlobals<{ logLevel?: string; apiBaseUrl?: string }>()\n\n      // Attempt to get a token from the provided getter (e.g. OAuth store).\n      // If it returns undefined or throws (e.g. no OAuth token stored in CI),\n      // fall back to FIGMA_ACCESS_TOKEN and use PAT headers.\n      let oauthToken: string | undefined\n      try {\n        oauthToken = programOptions.getToken?.()\n      } catch {\n        // getToken threw (e.g. no OAuth token stored); fall back to PAT below\n      }\n      const token = oauthToken ?? process.env.FIGMA_ACCESS_TOKEN\n      const useOAuth = oauthToken !== undefined\n\n      return handler({\n        ...(options as object),\n        token,\n        useOAuth,\n        verbose: globalOpts.logLevel === 'debug',\n        apiUrl: globalOpts.apiBaseUrl,\n      } as unknown as T).catch((err: Error) => {\n        // Commander v12 catches rejected action promises internally and exits 0.\n        // Commander v11 left them as unhandled rejections, and Node.js 15+ would\n        // exit 1 for those — so exit code 1 on handler errors was previously\n        // accidental. This catch makes it explicit and version-independent.\n        logger.error(err.message)\n        process.exitCode = 1\n      })\n    }\n  }\n\n  const connectCommand = program\n    .command('connect')\n    .description('Code Connect commands')\n    .addHelpText(\n      'before',\n      'For feedback or bugs, please raise an issue: https://github.com/figma/code-connect/issues',\n    )\n  connectCommand.action(() => connectCommand.help())\n\n  addBase(\n    connectCommand,\n    'publish',\n    'Run Code Connect locally to find any files that have figma connections and publish them to Figma. ' +\n      'By default this looks for a config file named \"figma.config.json\", and uses the `include` and `exclude` fields to determine which files to parse. ' +\n      'If no config file is found, this parses the current directory. An optional `--dir` flag can be used to specify a directory to parse.',\n  )\n    .option('--skip-validation', 'skip validation of Code Connect docs')\n    .option('-l --label <label>', 'label to apply to the published files')\n    .option(\n      '-b --batch-size <batch_size>',\n      '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.',\n    )\n    .option(\n      '--force',\n      'overwrite existing UI-created Code Connect mappings if they conflict with the files being published',\n    )\n    .action(wrapHandler(handlePublish))\n\n  addBase(\n    connectCommand,\n    'unpublish',\n    'Run to find any files that have figma connections and unpublish them from Figma. ' +\n      'By default this looks for a config file named \"figma.config.json\", and uses the `include` and `exclude` fields to determine which files to parse. ' +\n      'If no config file is found, this parses the current directory. An optional `--dir` flag can be used to specify a directory to parse. ' +\n      'Alternatively, use `--node` and `--label` to unpublish a specific component.',\n  )\n    .option(\n      '--node <link_to_node>',\n      'specify the node to unpublish. This will unpublish for the specified label.',\n    )\n    .option('-l --label <label>', 'label to unpublish for')\n    .action(wrapHandler(handleUnpublish))\n\n  addBase(\n    connectCommand,\n    'parse',\n    'Run Code Connect locally to find any files that have figma connections, then converts them to JSON and outputs to stdout.',\n  )\n    .option('-l --label <label>', 'label to apply to the parsed files')\n    .action(wrapHandler(handleParse))\n\n  addBase(\n    connectCommand,\n    'create',\n    'Generate a Code Connect file with boilerplate in the current directory for a Figma node URL',\n  )\n    .argument('<figma-node-url>', 'Figma node URL to create the Code Connect file from')\n    .action((nodeUrl: string, options: unknown, cmd: commander.Command) =>\n      wrapHandler<BaseCommand>((mergedCmd) => handleCreate(nodeUrl, mergedCmd))(options, cmd),\n    )\n}\n"]}

package/dist/commands/preview_utils.d.ts

@@ -0,0 +1,49 @@
+import { BaseCommand } from './connect';
+import { CodeConnectJSON } from '../connect/figma_connect';
+export interface NodeToPreview {
+    fileKey: string;
+    nodeId: string;
+    url: string;
+    filePath: string;
+}
+export interface PreviewResult {
+    url: string;
+    nodeId: string;
+    filePath: string;
+    success: boolean;
+    snippet?: string;
+    language?: string;
+    component?: string;
+    error?: string;
+}
+/**
+ * Collect nodes to preview from file arguments.
+ * Matches by exact path first, then by basename.
+ */
+export declare function collectNodesToPreview(files: string[], allCodeConnectObjects: CodeConnectJSON[], dir: string, cmd: BaseCommand): Promise<NodeToPreview[]>;
+/**
+ * Filter templates to only those matching the requested node IDs.
+ */
+export declare function filterTemplatesForNodes(nodeIds: string[], allTemplates: CodeConnectJSON[]): CodeConnectJSON[];
+export declare function getPrettierParserMap(): Record<string, string>;
+/**
+ * Check if a snippet can be parsed by Prettier.
+ * Returns true for languages without a Prettier parser (nothing to validate).
+ */
+export declare function isPrettierParseable(snippet: string, language?: string): Promise<boolean>;
+/**
+ * Format snippet with Prettier.
+ * Returns the snippet unmodified for languages Prettier doesn't support.
+ */
+export declare function formatSnippet(snippet: string, language?: string): Promise<string>;
+/**
+ * Display results with terminal colors
+ */
+export declare function displayResults(results: PreviewResult[]): void;
+/**
+ * Handle the preview command
+ */
+export declare function handlePreview(files: string[], cmd: BaseCommand & {
+    output?: string;
+}): Promise<void>;
+//# sourceMappingURL=preview_utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview_utils.d.ts","sourceRoot":"","sources":["../../src/commands/preview_utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAA6D,MAAM,WAAW,CAAA;AAElG,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAM1D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EAAE,EACf,qBAAqB,EAAE,eAAe,EAAE,EACxC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAqF1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,eAAe,EAAE,GAC9B,eAAe,EAAE,CAQnB;AAiBD,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB7D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc9F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,CAqC7D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,iBAkK1F"}