@figma/code-connect 0.1.0

package/dist/common/intrinsics.js

@@ -0,0 +1,239 @@
+"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.intrinsicToString = exports.valueMappingToString = exports.parseIntrinsic = exports.IntrinsicKind = exports.FIGMA_CONNECT_CALL = exports.API_PREFIX = void 0;
+const ts = __importStar(require("typescript"));
+const parser_1 = require("./parser");
+const compiler_1 = require("./compiler");
+const compiler_2 = require("./compiler");
+const compiler_3 = require("./compiler");
+exports.API_PREFIX = 'figma';
+exports.FIGMA_CONNECT_CALL = `${exports.API_PREFIX}.connect`;
+var IntrinsicKind;
+(function (IntrinsicKind) {
+    IntrinsicKind["Enum"] = "enum";
+    IntrinsicKind["String"] = "string";
+    IntrinsicKind["Boolean"] = "boolean";
+    IntrinsicKind["Instance"] = "instance";
+    IntrinsicKind["Children"] = "children";
+})(IntrinsicKind || (exports.IntrinsicKind = IntrinsicKind = {}));
+const Intrinsics = {};
+/**
+ * These functions are used to convert "intrinsic" parser types (which are calls to helper functions
+ * like `Figma.boolean() in code)` to an object representing that intrinsic that we can serialize to JSON.
+ *
+ * Each call to `makeIntrinsic` should take a function from the {@link FigmaConnectAPI},
+ * ensuring that the name of the intrinsic that we're parsing matches the name of the function
+ *
+ * @param staticFunctionMember
+ * @param obj
+ */
+function makeIntrinsic(intrinsicName, obj) {
+    const name = `${exports.API_PREFIX}.${intrinsicName}`;
+    Intrinsics[name] = {
+        match: (exp) => ts.isCallExpression(exp) && exp.getText().includes(name),
+        ...obj(name),
+    };
+}
+makeIntrinsic('boolean', (name) => {
+    return {
+        parse: (exp, ctx) => {
+            const figmaPropNameIdentifier = exp.arguments?.[0];
+            (0, compiler_1.assertIsStringLiteral)(figmaPropNameIdentifier, ctx.sourceFile, `${name} takes at least one argument, which is the Figma property name`);
+            const valueMappingArg = exp.arguments?.[1];
+            let valueMapping;
+            if (valueMappingArg) {
+                (0, compiler_3.assertIsObjectLiteralExpression)(valueMappingArg, ctx.sourceFile, `${name} second argument should be an object literal, that sets values for 'true' and 'false'`);
+                valueMapping = (0, compiler_2.convertObjectLiteralToJs)(valueMappingArg, ctx.sourceFile, ctx.checker, (valueNode) => {
+                    if (ts.isCallExpression(valueNode)) {
+                        return parseIntrinsic(valueNode, ctx);
+                    }
+                });
+            }
+            return {
+                kind: IntrinsicKind.Boolean,
+                args: {
+                    figmaPropName: (0, compiler_1.stripQuotes)(figmaPropNameIdentifier),
+                    valueMapping,
+                },
+            };
+        },
+    };
+});
+makeIntrinsic('enum', (name) => {
+    return {
+        parse: (exp, ctx) => {
+            const { sourceFile, checker } = ctx;
+            const figmaPropNameIdentifier = exp.arguments?.[0];
+            (0, compiler_1.assertIsStringLiteral)(figmaPropNameIdentifier, sourceFile, `${name} takes at least one argument, which is the Figma property name`);
+            const valueMapping = exp.arguments?.[1];
+            (0, compiler_3.assertIsObjectLiteralExpression)(valueMapping, sourceFile, `${name} second argument should be an object literal, that maps Figma prop values to code`);
+            return {
+                kind: IntrinsicKind.Enum,
+                args: {
+                    figmaPropName: (0, compiler_1.stripQuotes)(figmaPropNameIdentifier),
+                    valueMapping: (0, compiler_2.convertObjectLiteralToJs)(valueMapping, sourceFile, checker, (valueNode) => {
+                        if (ts.isCallExpression(valueNode)) {
+                            return parseIntrinsic(valueNode, ctx);
+                        }
+                    }),
+                },
+            };
+        },
+    };
+});
+makeIntrinsic('string', (name) => {
+    return {
+        parse: (exp, ctx) => {
+            const { sourceFile } = ctx;
+            const figmaPropNameIdentifier = exp.arguments?.[0];
+            (0, compiler_1.assertIsStringLiteral)(figmaPropNameIdentifier, sourceFile, `${name} takes at least one argument, which is the Figma property name`);
+            return {
+                kind: IntrinsicKind.String,
+                args: {
+                    figmaPropName: (0, compiler_1.stripQuotes)(figmaPropNameIdentifier),
+                },
+            };
+        },
+    };
+});
+makeIntrinsic('instance', (name) => {
+    return {
+        parse: (exp, ctx) => {
+            const { sourceFile } = ctx;
+            const figmaPropNameIdentifier = exp.arguments?.[0];
+            (0, compiler_1.assertIsStringLiteral)(figmaPropNameIdentifier, sourceFile, `${name} takes at least one argument, which is the Figma property name`);
+            return {
+                kind: IntrinsicKind.Instance,
+                args: {
+                    figmaPropName: (0, compiler_1.stripQuotes)(figmaPropNameIdentifier),
+                },
+            };
+        },
+    };
+});
+makeIntrinsic('children', (name) => {
+    return {
+        parse: (exp, ctx) => {
+            const { sourceFile } = ctx;
+            const layerName = exp.arguments?.[0];
+            const layers = [];
+            if (ts.isStringLiteral(layerName)) {
+                layers.push((0, compiler_1.stripQuotes)(layerName));
+            }
+            else if (ts.isArrayLiteralExpression(layerName) && layerName.elements.length > 0) {
+                layerName.elements.forEach((el) => {
+                    (0, compiler_1.assertIsStringLiteral)(el, sourceFile);
+                    layers.push((0, compiler_1.stripQuotes)(el));
+                });
+            }
+            else {
+                throw new parser_1.ParserError(`Invalid argument to ${name}, should be a string literal or an array of strings`, {
+                    node: layerName,
+                    sourceFile,
+                });
+            }
+            return {
+                kind: IntrinsicKind.Children,
+                args: {
+                    layers,
+                },
+            };
+        },
+    };
+});
+/**
+ * Parses a call expression to an intrinsic
+ *
+ * @param exp Expression to parse
+ * @param parserContext parser context
+ * @returns
+ */
+function parseIntrinsic(exp, parserContext) {
+    for (const key in Intrinsics) {
+        if (Intrinsics[key].match(exp)) {
+            return Intrinsics[key].parse(exp, parserContext);
+        }
+    }
+    throw new parser_1.ParserError(`Unknown intrinsic: ${exp.getText()}`, {
+        node: exp,
+        sourceFile: parserContext.sourceFile,
+    });
+}
+exports.parseIntrinsic = parseIntrinsic;
+function valueMappingToString(valueMapping) {
+    // For enums (and booleans with a valueMapping provided), convert the
+    // value mapping to an object.
+    return ('{\n' +
+        Object.entries(valueMapping)
+            .map(([key, value]) => {
+            if (typeof value === 'object' && 'kind' in value) {
+                // Mappings can be nested, e.g. an enum value can be figma.instance(...)
+                return `"${key}": ${intrinsicToString(value)}`;
+            }
+            else if (typeof value === 'boolean' || typeof value === 'undefined') {
+                return `"${key}": ${value}`;
+            }
+            else {
+                return `"${key}": '${value}'`;
+            }
+        })
+            .join(',\n') +
+        '}');
+}
+exports.valueMappingToString = valueMappingToString;
+function intrinsicToString({ kind, args }) {
+    switch (kind) {
+        case IntrinsicKind.String:
+        case IntrinsicKind.Instance: {
+            // Outputs:
+            // `const propName = figma.properties.string('propName')`, or
+            // `const propName = figma.properties.boolean('propName')`, or
+            // `const propName = figma.properties.instance('propName')`
+            return `figma.properties.${kind}('${args.figmaPropName}')`;
+        }
+        case IntrinsicKind.Boolean: {
+            if (args.valueMapping) {
+                const mappingString = valueMappingToString(args.valueMapping);
+                // Outputs: `const propName = figma.properties.boolean('propName', { ... mapping object from above ... })`
+                return `figma.properties.boolean('${args.figmaPropName}', ${mappingString})`;
+            }
+            return `figma.properties.boolean('${args.figmaPropName}')`;
+        }
+        case IntrinsicKind.Enum: {
+            const mappingString = valueMappingToString(args.valueMapping);
+            // Outputs: `const propName = figma.properties.enum('propName', { ... mapping object from above ... })`
+            return `figma.properties.enum('${args.figmaPropName}', ${mappingString})`;
+        }
+        case IntrinsicKind.Children: {
+            // Outputs: `const propName = figma.properties.children(["Layer 1", "Layer 2"])`
+            return `figma.properties.children([${args.layers.map((layerName) => `"${layerName}"`).join(',')}])`;
+        }
+        default:
+            throw new parser_1.InternalError(`Unknown intrinsic: ${kind}`);
+    }
+}
+exports.intrinsicToString = intrinsicToString;
+//# sourceMappingURL=intrinsics.js.map

package/dist/common/intrinsics.js.map

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

package/dist/common/logging.d.ts

@@ -0,0 +1,25 @@
+import chalk from 'chalk';
+export declare const error: chalk.Chalk;
+export declare const success: chalk.Chalk;
+export declare const info: chalk.Chalk;
+export declare const warn: chalk.Chalk;
+export declare const debug: chalk.Chalk;
+export declare const verbose: chalk.Chalk;
+export declare const highlight: chalk.Chalk;
+export declare const reset: chalk.Chalk;
+export declare const underline: chalk.Chalk;
+export declare enum LogLevel {
+    Nothing = 0,
+    Error = 1,
+    Warn = 2,
+    Info = 3,
+    Debug = 4
+}
+export declare const logger: {
+    setLogLevel: (level: LogLevel) => void;
+    error: (...msgs: unknown[]) => void;
+    warn: (...msgs: unknown[]) => void;
+    info: (...msgs: unknown[]) => void;
+    debug: (...msgs: unknown[]) => void;
+};
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/common/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,eAAO,MAAM,KAAK,aAAY,CAAA;AAC9B,eAAO,MAAM,OAAO,aAAc,CAAA;AAClC,eAAO,MAAM,IAAI,aAAc,CAAA;AAC/B,eAAO,MAAM,IAAI,aAAe,CAAA;AAChC,eAAO,MAAM,KAAK,aAAa,CAAA;AAC/B,eAAO,MAAM,OAAO,aAAa,CAAA;AACjC,eAAO,MAAM,SAAS,aAAa,CAAA;AACnC,eAAO,MAAM,KAAK,aAAc,CAAA;AAChC,eAAO,MAAM,SAAS,aAAkB,CAAA;AAExC,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAID,eAAO,MAAM,MAAM;yBACI,QAAQ;qBAGZ,OAAO,EAAE;oBAGV,OAAO,EAAE;oBAGT,OAAO,EAAE;qBAGR,OAAO,EAAE;CAG3B,CAAA"}

package/dist/common/logging.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.LogLevel = exports.underline = exports.reset = exports.highlight = exports.verbose = exports.debug = exports.warn = exports.info = exports.success = exports.error = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+exports.error = chalk_1.default.red;
+exports.success = chalk_1.default.green;
+exports.info = chalk_1.default.white;
+exports.warn = chalk_1.default.yellow;
+exports.debug = chalk_1.default.gray;
+exports.verbose = chalk_1.default.cyan;
+exports.highlight = chalk_1.default.bold;
+exports.reset = chalk_1.default.reset;
+exports.underline = chalk_1.default.underline;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Nothing"] = 0] = "Nothing";
+    LogLevel[LogLevel["Error"] = 1] = "Error";
+    LogLevel[LogLevel["Warn"] = 2] = "Warn";
+    LogLevel[LogLevel["Info"] = 3] = "Info";
+    LogLevel[LogLevel["Debug"] = 4] = "Debug";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+let logLevel = LogLevel.Info;
+exports.logger = {
+    setLogLevel: (level) => {
+        logLevel = level;
+    },
+    error: (...msgs) => {
+        if (logLevel >= LogLevel.Error)
+            console.error((0, exports.error)(...msgs));
+    },
+    warn: (...msgs) => {
+        if (logLevel >= LogLevel.Warn)
+            console.warn((0, exports.warn)(...msgs));
+    },
+    info: (...msgs) => {
+        if (logLevel >= LogLevel.Info)
+            console.info((0, exports.info)(...msgs));
+    },
+    debug: (...msgs) => {
+        if (logLevel >= LogLevel.Debug)
+            console.debug((0, exports.debug)(...msgs));
+    },
+};
+//# sourceMappingURL=logging.js.map

package/dist/common/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/common/logging.ts"],"names":[],"mappings":";;;;;;AAAA,kDAAyB;AAEZ,QAAA,KAAK,GAAG,eAAK,CAAC,GAAG,CAAA;AACjB,QAAA,OAAO,GAAG,eAAK,CAAC,KAAK,CAAA;AACrB,QAAA,IAAI,GAAG,eAAK,CAAC,KAAK,CAAA;AAClB,QAAA,IAAI,GAAG,eAAK,CAAC,MAAM,CAAA;AACnB,QAAA,KAAK,GAAG,eAAK,CAAC,IAAI,CAAA;AAClB,QAAA,OAAO,GAAG,eAAK,CAAC,IAAI,CAAA;AACpB,QAAA,SAAS,GAAG,eAAK,CAAC,IAAI,CAAA;AACtB,QAAA,KAAK,GAAG,eAAK,CAAC,KAAK,CAAA;AACnB,QAAA,SAAS,GAAG,eAAK,CAAC,SAAS,CAAA;AAExC,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAED,IAAI,QAAQ,GAAa,QAAQ,CAAC,IAAI,CAAA;AAEzB,QAAA,MAAM,GAAG;IACpB,WAAW,EAAE,CAAC,KAAe,EAAE,EAAE;QAC/B,QAAQ,GAAG,KAAK,CAAA;IAClB,CAAC;IACD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,IAAA,aAAK,EAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC3B,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,IAAA,YAAI,EAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAC5D,CAAC;IACD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC3B,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,IAAA,YAAI,EAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAC5D,CAAC;IACD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,IAAI,QAAQ,IAAI,QAAQ,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,IAAA,aAAK,EAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAC/D,CAAC;CACF,CAAA"}

package/dist/common/parser.d.ts

@@ -0,0 +1,77 @@
+import ts from 'typescript';
+import { FigmaConnectConfig } from './project';
+import { Intrinsic } from './intrinsics';
+interface ParserErrorContext {
+    sourceFile: ts.SourceFile;
+    node: ts.Node | undefined;
+}
+export declare class ParserError extends Error {
+    sourceFilePosition: ts.LineAndCharacter | null;
+    sourceFileName: string;
+    constructor(message: string, context?: ParserErrorContext);
+    toString(): string;
+    toDebugString(): string;
+}
+export declare class InternalError extends ParserError {
+    constructor(message: string);
+}
+export interface ParserContext {
+    checker: ts.TypeChecker;
+    sourceFile: ts.SourceFile;
+    config: FigmaConnectConfig | undefined;
+}
+/**
+ * Parsers the `props` field of 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>;
+/**
+ * Extract metadata about the referenced React component. Used by both the
+ * Figmadoc and Storybook commands.
+ *
+ * @param parserContext Parser context
+ * @param componentSymbol The ts.Symbol from the metadata referencing the
+ * component being documented
+ * @param node The node being parsed. Used for error logging.
+ * @returns Metadata object
+ */
+export declare function parseComponentMetadata(node: ts.PropertyAccessExpression | ts.Identifier | ts.Expression, { checker, sourceFile }: ParserContext): Promise<{
+    source: string;
+    line: number;
+    component: string;
+}>;
+/**
+ * Checks if a file contains figmadoc by looking for the `Figma.connect()` function call
+ *
+ * @param program
+ * @param file
+ * @returns
+ */
+export declare function isFigmaConnectFile(program: ts.Program, file: string): boolean;
+/**
+ * Parses the render function passed to `Figma.connect()`, extracting the code and
+ * any import statements matching the JSX elements used in the function body
+ *
+ * @param exp A function or arrow function expression
+ * @param parserContext Parser context
+ * @param propMappings Prop mappings object as returned by parseProps
+ *
+ * @returns The code of the render function and a list of imports
+ */
+export declare function parseRenderFunction(exp: ts.ArrowFunction | ts.FunctionExpression | ts.FunctionDeclaration, parserContext: ParserContext, propMappings?: PropMappings): {
+    code: string;
+    imports: {
+        statement: string;
+        file: string;
+    }[];
+    nestable: boolean;
+};
+export declare function getDefaultTemplate(componentMetadata: Awaited<ReturnType<typeof parseComponentMetadata>>): string;
+export declare function parse(program: ts.Program, file: string, repoUrl?: string, config?: FigmaConnectConfig, debug?: boolean): Promise<any[]>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/common/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAE,kBAAkB,EAAuC,MAAM,WAAW,CAAA;AAYnF,OAAO,EAEL,SAAS,EAKV,MAAM,cAAc,CAAA;AAKrB,UAAU,kBAAkB;IAC1B,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;IACzB,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,CAAA;CAC1B;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,kBAAkB,EAAE,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAAA;IAC9C,cAAc,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAUzD,QAAQ;IAQR,aAAa;CAGd;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,EAAE,CAAC,WAAW,CAAA;IACvB,UAAU,EAAE,EAAE,CAAC,UAAU,CAAA;IACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAA;CACvC;AAwID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,EAAE,CAAC,uBAAuB,EACzC,aAAa,EAAE,aAAa,GAC3B,YAAY,CAOd;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAEpD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,EAAE,CAAC,wBAAwB,GAAG,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU,EACjE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,aAAa;;;;GAwGvC;AAeD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,WAmBnE;AAgED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,GAAG,EAAE,CAAC,mBAAmB,EACtE,aAAa,EAAE,aAAa,EAC5B,YAAY,CAAC,EAAE,YAAY;;;;;;;EAyN5B;AAwJD,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,UAItE;AA4FD,wBAAsB,KAAK,CACzB,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,kBAAkB,EAC3B,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,EAAE,CAAC,CAkChB"}