@typespec/http-server-js 0.58.0-alpha.10-dev.3

package/dist/src/common/namespace.js

@@ -0,0 +1,184 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+import { getNamespaceFullName } from "@typespec/compiler";
+import { createModule, isModule, } from "../ctx.js";
+import { parseCase } from "../util/case.js";
+import { UnimplementedError } from "../util/error.js";
+import { cat, indent, isIterable } from "../util/iter.js";
+import { emitOperationGroup } from "./interface.js";
+/**
+ * Enqueue all declarations in the namespace to be included in the emit, recursively.
+ *
+ * @param ctx - The emitter context.
+ * @param namespace - The root namespace to begin traversing.
+ */
+export function visitAllTypes(ctx, namespace) {
+    const { enums, interfaces, models, unions, namespaces, scalars, operations } = namespace;
+    for (const type of cat(enums.values(), interfaces.values(), models.values(), unions.values(), scalars.values())) {
+        ctx.typeQueue.add(type);
+    }
+    for (const ns of namespaces.values()) {
+        visitAllTypes(ctx, ns);
+    }
+    if (operations.size > 0) {
+        // If the operation has any floating operations in it, we will synthesize an interface for them in the parent module.
+        // This requires some special handling by other parts of the emitter to ensure that the interface for a namespace's
+        // own operations is properly imported.
+        if (!namespace.namespace) {
+            throw new UnimplementedError("no parent namespace in visitAllTypes");
+        }
+        const parentModule = createOrGetModuleForNamespace(ctx, namespace.namespace);
+        parentModule.declarations.push([
+            // prettier-ignore
+            `/** An interface representing the operations defined in the '${getNamespaceFullName(namespace)}' namespace. */`,
+            `export interface ${parseCase(namespace.name).pascalCase}<Context = unknown> {`,
+            ...indent(emitOperationGroup(ctx, operations.values(), parentModule)),
+            "}",
+        ]);
+    }
+}
+/**
+ * Create a module for a namespace, or get an existing module if one has already been created.
+ *
+ * @param ctx - The emitter context.
+ * @param namespace - The namespace to create a module for.
+ * @returns the module for the namespace.
+ */
+export function createOrGetModuleForNamespace(ctx, namespace, root = ctx.globalNamespaceModule) {
+    if (ctx.namespaceModules.has(namespace)) {
+        return ctx.namespaceModules.get(namespace);
+    }
+    if (!namespace.namespace) {
+        throw new Error("UNREACHABLE: no parent namespace in createOrGetModuleForNamespace");
+    }
+    const parent = namespace.namespace === ctx.globalNamespace
+        ? root
+        : createOrGetModuleForNamespace(ctx, namespace.namespace);
+    const name = namespace.name === "TypeSpec" ? "typespec" : parseCase(namespace.name).kebabCase;
+    const module = createModule(name, parent, namespace);
+    ctx.namespaceModules.set(namespace, module);
+    return module;
+}
+/**
+ * Get a reference to the interface representing the namespace's floating operations.
+ *
+ * This does not check that such an interface actually exists, so it should only be called in situations where it is
+ * known to exist (for example, if an operation comes from the namespace).
+ *
+ * @param ctx - The emitter context.
+ * @param namespace - The namespace to get the interface reference for.
+ * @param module - The module the the reference will be written to.
+ */
+export function emitNamespaceInterfaceReference(ctx, namespace, module) {
+    if (!namespace.namespace) {
+        throw new Error("UNREACHABLE: no parent namespace in emitNamespaceInterfaceReference");
+    }
+    const namespaceName = parseCase(namespace.name).pascalCase;
+    module.imports.push({
+        binder: [namespaceName],
+        from: createOrGetModuleForNamespace(ctx, namespace.namespace),
+    });
+    return namespaceName;
+}
+/**
+ * Emits a single declaration within a module. If the declaration is a module, it is enqueued for later processing.
+ *
+ * @param ctx - The emitter context.
+ * @param decl - The declaration to emit.
+ * @param queue - The queue to add the declaration to if it is a module.
+ */
+function* emitModuleBodyDeclaration(ctx, decl, queue) {
+    if (isIterable(decl)) {
+        yield* decl;
+    }
+    else if (typeof decl === "string") {
+        yield* decl.split(/\r?\n/);
+    }
+    else {
+        if (decl.declarations.length > 0) {
+            queue.add(decl);
+        }
+    }
+}
+/**
+ * Gets a file path from a given module to another module.
+ */
+function computeRelativeFilePath(from, to) {
+    const fromIsIndex = from.declarations.some((d) => isModule(d));
+    const toIsIndex = to.declarations.some((d) => isModule(d));
+    const relativePath = (fromIsIndex ? from.cursor : from.cursor.parent).relativePath(to.cursor);
+    if (relativePath.length === 0 && !toIsIndex)
+        throw new Error("UNREACHABLE: relativePath returned no fragments");
+    if (relativePath.length === 0)
+        return "./index.js";
+    const prefix = relativePath[0] === ".." ? "" : "./";
+    const suffix = toIsIndex ? "/index.js" : ".js";
+    return prefix + relativePath.join("/") + suffix;
+}
+/**
+ * Deduplicates, consolidates, and writes the import statements for a module.
+ */
+function* writeImportsNormalized(ctx, module) {
+    const allTargets = new Set();
+    const importMap = new Map();
+    const starAsMap = new Map();
+    const extraStarAs = [];
+    for (const _import of module.imports) {
+        // check for same module and continue
+        if (_import.from === module)
+            continue;
+        const target = typeof _import.from === "string"
+            ? _import.from
+            : computeRelativeFilePath(module, _import.from);
+        allTargets.add(target);
+        if (typeof _import.binder === "string") {
+            if (starAsMap.has(target)) {
+                extraStarAs.push([_import.binder, target]);
+            }
+            else {
+                starAsMap.set(target, _import.binder);
+            }
+        }
+        else {
+            const binders = importMap.get(target) ?? new Set();
+            for (const binder of _import.binder) {
+                binders.add(binder);
+            }
+            importMap.set(target, binders);
+        }
+    }
+    for (const target of allTargets) {
+        const binders = importMap.get(target);
+        const starAs = starAsMap.get(target);
+        if (binders && starAs) {
+            yield `import ${starAs}, { ${[...binders].join(", ")} } from "${target}";`;
+        }
+        else if (binders) {
+            yield `import { ${[...binders].join(", ")} } from "${target}";`;
+        }
+        else if (starAs) {
+            yield `import ${starAs} from "${target}";`;
+        }
+        yield "";
+    }
+    for (const [binder, target] of extraStarAs) {
+        yield `import ${binder} from "${target}";`;
+    }
+}
+/**
+ * Emits the body of a module file.
+ *
+ * @param ctx - The emitter context.
+ * @param module - The module to emit.
+ * @param queue - The queue to add any submodules to for later processing.
+ */
+export function* emitModuleBody(ctx, module, queue) {
+    yield* writeImportsNormalized(ctx, module);
+    if (module.imports.length > 0)
+        yield "";
+    for (const decl of module.declarations) {
+        yield* emitModuleBodyDeclaration(ctx, decl, queue);
+        yield "";
+    }
+}
+//# sourceMappingURL=namespace.js.map

package/dist/src/common/namespace.js.map

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

package/dist/src/common/reference.d.ts

@@ -0,0 +1,46 @@
+import { DiagnosticTarget, IntrinsicType, LiteralType, Namespace, NoTarget, Type } from "@typespec/compiler";
+import { JsContext, Module } from "../ctx.js";
+export type NamespacedType = Extract<Type, {
+    namespace?: Namespace;
+}>;
+/**
+ * Options for emitting a type reference.
+ */
+export interface EmitTypeReferenceOptions {
+    /**
+     * An optional alternative name to use for the type if it is not named.
+     */
+    altName?: string;
+    /**
+     * Require a declaration for types that may be represented anonymously.
+     */
+    requireDeclaration?: boolean;
+}
+/**
+ * Emits a reference to a host type.
+ *
+ * This function will automatically ensure that the referenced type is included in the emit graph, and will import the
+ * type into the current module if necessary.
+ *
+ * Optionally, a `preferredAlternativeName` may be supplied. This alternative name will be used if a declaration is
+ * required, but the type is anonymous. The alternative name can only be set once. If two callers provide different
+ * alternative names for the same anonymous type, the first one is used in all cases. If a declaration _is_ required,
+ * and no alternative name is supplied (or has been supplied in a prior call to `emitTypeReference`), this function will
+ * throw an error. Callers must be sure to provide an alternative name if the type _may_ have an unknown name. However,
+ * callers may know that they have previously emitted a reference to the type and provided an alternative name in that
+ * call, in which case the alternative name may be safely omitted.
+ *
+ * @param ctx - The emitter context.
+ * @param type - The type to emit a reference to.
+ * @param position - The syntactic position of the reference, for diagnostics.
+ * @param module - The module that the reference is being emitted into.
+ * @param preferredAlternativeName - An optional alternative name to use for the type if it is not named.
+ * @returns a string containing a reference to the TypeScript type that represents the given TypeSpec type.
+ */
+export declare function emitTypeReference(ctx: JsContext, type: Type, position: DiagnosticTarget | typeof NoTarget, module: Module, options?: EmitTypeReferenceOptions): string;
+export declare function escapeUnsafeChars(s: string): string;
+export type JsTypeSpecLiteralType = LiteralType | (IntrinsicType & {
+    name: "null";
+});
+export declare function isValueLiteralType(t: Type): t is JsTypeSpecLiteralType;
+//# sourceMappingURL=reference.d.ts.map

package/dist/src/common/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/common/reference.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,IAAI,EAKL,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAoB,MAAM,WAAW,CAAC;AAShE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,gBAAgB,GAAG,OAAO,QAAQ,EAC5C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAyNR;AAgBD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,UAE1C;AAED,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,CAAC,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,qBAAqB,CAWtE"}

package/dist/src/common/reference.js

@@ -0,0 +1,243 @@
+// Copyright (c) Microsoft Corporation
+// Licensed under the MIT license.
+import { NoTarget, compilerAssert, getEffectiveModelType, getFriendlyName, isArrayModelType, } from "@typespec/compiler";
+import { isImportableType } from "../ctx.js";
+import { reportDiagnostic } from "../lib.js";
+import { parseCase } from "../util/case.js";
+import { asArrayType, getArrayElementName } from "../util/pluralism.js";
+import { emitModelLiteral, emitWellKnownModel, isWellKnownModel } from "./model.js";
+import { createOrGetModuleForNamespace } from "./namespace.js";
+import { getJsScalar } from "./scalar.js";
+import { emitUnionType } from "./union.js";
+/**
+ * Emits a reference to a host type.
+ *
+ * This function will automatically ensure that the referenced type is included in the emit graph, and will import the
+ * type into the current module if necessary.
+ *
+ * Optionally, a `preferredAlternativeName` may be supplied. This alternative name will be used if a declaration is
+ * required, but the type is anonymous. The alternative name can only be set once. If two callers provide different
+ * alternative names for the same anonymous type, the first one is used in all cases. If a declaration _is_ required,
+ * and no alternative name is supplied (or has been supplied in a prior call to `emitTypeReference`), this function will
+ * throw an error. Callers must be sure to provide an alternative name if the type _may_ have an unknown name. However,
+ * callers may know that they have previously emitted a reference to the type and provided an alternative name in that
+ * call, in which case the alternative name may be safely omitted.
+ *
+ * @param ctx - The emitter context.
+ * @param type - The type to emit a reference to.
+ * @param position - The syntactic position of the reference, for diagnostics.
+ * @param module - The module that the reference is being emitted into.
+ * @param preferredAlternativeName - An optional alternative name to use for the type if it is not named.
+ * @returns a string containing a reference to the TypeScript type that represents the given TypeSpec type.
+ */
+export function emitTypeReference(ctx, type, position, module, options = {}) {
+    switch (type.kind) {
+        case "Scalar":
+            // Get the scalar and return it directly, as it is a primitive.
+            return getJsScalar(ctx.program, type, position);
+        case "Model": {
+            // First handle arrays.
+            if (isArrayModelType(ctx.program, type)) {
+                const argumentType = type.indexer.value;
+                const argTypeReference = emitTypeReference(ctx, argumentType, position, module, {
+                    altName: options.altName && getArrayElementName(options.altName),
+                });
+                if (isImportableType(ctx, argumentType) && argumentType.namespace) {
+                    module.imports.push({
+                        binder: [argTypeReference],
+                        from: createOrGetModuleForNamespace(ctx, argumentType.namespace),
+                    });
+                }
+                return asArrayType(argTypeReference);
+            }
+            // Now other well-known models.
+            if (isWellKnownModel(ctx, type)) {
+                return emitWellKnownModel(ctx, type, module, options.altName);
+            }
+            // Try to reduce the model to an effective model if possible.
+            const effectiveModel = getEffectiveModelType(ctx.program, type);
+            if (effectiveModel.name === "") {
+                // We might have seen the model before and synthesized a declaration for it already.
+                if (ctx.syntheticNames.has(effectiveModel)) {
+                    const name = ctx.syntheticNames.get(effectiveModel);
+                    module.imports.push({
+                        binder: [name],
+                        from: ctx.syntheticModule,
+                    });
+                    return name;
+                }
+                // Require preferredAlternativeName at this point, as we have an anonymous model that we have not visited.
+                if (!options.altName) {
+                    return emitModelLiteral(ctx, effectiveModel, module);
+                }
+                // Anonymous model, synthesize a new model with the preferredName
+                ctx.synthetics.push({
+                    kind: "anonymous",
+                    name: options.altName,
+                    underlying: effectiveModel,
+                });
+                module.imports.push({
+                    binder: [options.altName],
+                    from: ctx.syntheticModule,
+                });
+                ctx.syntheticNames.set(effectiveModel, options.altName);
+                return options.altName;
+            }
+            else {
+                // The effective model is good for a declaration, so enqueue it.
+                ctx.typeQueue.add(effectiveModel);
+            }
+            const friendlyName = getFriendlyName(ctx.program, effectiveModel);
+            // The model may be a template instance, so we generate a name for it.
+            const templatedName = parseCase(friendlyName
+                ? friendlyName
+                : effectiveModel.templateMapper
+                    ? effectiveModel
+                        .templateMapper.args.map((a) => ("name" in a ? String(a.name) : ""))
+                        .join("_") + effectiveModel.name
+                    : effectiveModel.name);
+            if (!effectiveModel.namespace) {
+                throw new Error("UNREACHABLE: no parent namespace of named model in emitTypeReference");
+            }
+            const parentModule = createOrGetModuleForNamespace(ctx, effectiveModel.namespace);
+            module.imports.push({
+                binder: [templatedName.pascalCase],
+                from: parentModule,
+            });
+            return templatedName.pascalCase;
+        }
+        case "Union": {
+            if (type.variants.size === 0)
+                return "never";
+            else if (type.variants.size === 1)
+                return emitTypeReference(ctx, [...type.variants.values()][0], position, module, options);
+            if (options.requireDeclaration) {
+                if (type.name) {
+                    const nameCase = parseCase(type.name);
+                    ctx.typeQueue.add(type);
+                    module.imports.push({
+                        binder: [nameCase.pascalCase],
+                        from: createOrGetModuleForNamespace(ctx, type.namespace),
+                    });
+                    return type.name;
+                }
+                else {
+                    const existingSyntheticName = ctx.syntheticNames.get(type);
+                    if (existingSyntheticName) {
+                        module.imports.push({
+                            binder: [existingSyntheticName],
+                            from: ctx.syntheticModule,
+                        });
+                        return existingSyntheticName;
+                    }
+                    else {
+                        const altName = options.altName;
+                        if (!altName) {
+                            throw new Error("UNREACHABLE: anonymous union without preferredAlternativeName");
+                        }
+                        ctx.synthetics.push({
+                            kind: "anonymous",
+                            name: altName,
+                            underlying: type,
+                        });
+                        module.imports.push({
+                            binder: [altName],
+                            from: ctx.syntheticModule,
+                        });
+                        ctx.syntheticNames.set(type, altName);
+                        return altName;
+                    }
+                }
+            }
+            else {
+                return emitUnionType(ctx, [...type.variants.values()], module);
+            }
+        }
+        case "Enum": {
+            ctx.typeQueue.add(type);
+            const name = parseCase(type.name).pascalCase;
+            module.imports.push({
+                binder: [name],
+                from: createOrGetModuleForNamespace(ctx, type.namespace),
+            });
+            return name;
+        }
+        case "String":
+            return escapeUnsafeChars(JSON.stringify(type.value));
+        case "Number":
+        case "Boolean":
+            return String(type.value);
+        case "Intrinsic":
+            switch (type.name) {
+                case "never":
+                    return "never";
+                case "null":
+                    return "null";
+                case "void":
+                    // It's a bit strange to have a void property, but it's possible, and TypeScript allows it. Void is simply
+                    // only assignable from undefined or void itself.
+                    return "void";
+                case "ErrorType":
+                    compilerAssert(false, "ErrorType should not be encountered in emitTypeReference", position === NoTarget ? type : position);
+                    return "unknown";
+                case "unknown":
+                    return "unknown";
+                default:
+                    reportDiagnostic(ctx.program, {
+                        code: "unrecognized-intrinsic",
+                        format: { intrinsic: type.name },
+                        target: position,
+                    });
+                    return "unknown";
+            }
+        case "Interface": {
+            if (type.namespace === undefined) {
+                throw new Error("UNREACHABLE: unparented interface");
+            }
+            const typeName = parseCase(type.name).pascalCase;
+            ctx.typeQueue.add(type);
+            const parentModule = createOrGetModuleForNamespace(ctx, type.namespace);
+            module.imports.push({
+                binder: [typeName],
+                from: parentModule,
+            });
+            return typeName;
+        }
+        case "ModelProperty": {
+            // Forward to underlying type.
+            return emitTypeReference(ctx, type.type, position, module, options);
+        }
+        default:
+            throw new Error(`UNREACHABLE: ${type.kind}`);
+    }
+}
+const UNSAFE_CHAR_MAP = {
+    "<": "\\u003C",
+    ">": "\\u003E",
+    "/": "\\u002F",
+    "\\": "\\\\",
+    "\b": "\\b",
+    "\f": "\\f",
+    "\n": "\\n",
+    "\r": "\\r",
+    "\t": "\\t",
+    "\0": "\\0",
+    "\u2028": "\\u2028",
+    "\u2029": "\\u2029",
+};
+export function escapeUnsafeChars(s) {
+    return s.replace(/[<>/\\\b\f\n\r\t\0\u2028\u2029]/g, (x) => UNSAFE_CHAR_MAP[x]);
+}
+export function isValueLiteralType(t) {
+    switch (t.kind) {
+        case "String":
+        case "Number":
+        case "Boolean":
+            return true;
+        case "Intrinsic":
+            return t.name === "null";
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=reference.js.map

package/dist/src/common/reference.js.map

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

package/dist/src/common/scalar.d.ts

@@ -0,0 +1,50 @@
+import { DiagnosticTarget, NoTarget, Program, Scalar } from "@typespec/compiler";
+import { JsContext } from "../ctx.js";
+/**
+ * Emits a declaration for a scalar type.
+ *
+ * This is rare in TypeScript, as the scalar will ordinarily be used inline, but may be desirable in some cases.
+ *
+ * @param ctx - The emitter context.
+ * @param scalar - The scalar to emit.
+ * @returns a string that declares an alias to the scalar type in TypeScript.
+ */
+export declare function emitScalar(ctx: JsContext, scalar: Scalar): string;
+/**
+ * Get the string parsing template for a given scalar.
+ *
+ * It is common that a scalar type is encoded as a string. For example, in HTTP path parameters or query parameters
+ * where the value may be an integer, but the APIs expose it as a string. In such cases the parse template may be
+ * used to coerce the string value to the correct scalar type.
+ *
+ * The result of this function contains the string "{}" exactly once, which should be replaced with the text of an
+ * expression evaluating to the string representation of the scalar.
+ *
+ * For example, scalars that are represented by JS `number` are parsed with the template `Number({})`, which will
+ * convert the string to a number.
+ *
+ * @param ctx - The emitter context.
+ * @param scalar - The scalar to parse from a string
+ * @returns a template expression string that can be used to parse a string into the scalar type.
+ */
+export declare function parseTemplateForScalar(ctx: JsContext, scalar: Scalar): string;
+/**
+ * Get the string encoding template for a given scalar.
+ * @param ctx
+ * @param scalar
+ */
+export declare function encodeTemplateForScalar(ctx: JsContext, scalar: Scalar): string;
+/**
+ * Gets a TypeScript type that can represent a given TypeSpec scalar.
+ *
+ * Scalar recognition is recursive. If a scalar is not recognized, we will treat it as its parent scalar and try again.
+ *
+ * If no scalar in the chain is recognized, it will be treated as `unknown` and a warning will be issued.
+ *
+ * @param program - The program that contains the scalar
+ * @param scalar - The scalar to get the TypeScript type for
+ * @param diagnosticTarget - Where to report a diagnostic if the scalar is not recognized.
+ * @returns a string containing a TypeScript type that can represent the scalar
+ */
+export declare function getJsScalar(program: Program, scalar: Scalar, diagnosticTarget: DiagnosticTarget | typeof NoTarget): string;
+//# sourceMappingURL=scalar.d.ts.map

package/dist/src/common/scalar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.d.ts","sourceRoot":"","sources":["../../../src/common/scalar.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAoB,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe9E;AAmDD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,QAAQ,GACnD,MAAM,CAwBR"}