@zmdb/web 1.0.0-beta.1

package/dist/openapi/__fixtures__/openapi-tools.fixture.js

@@ -0,0 +1,172 @@
+import { assert } from '@zmdb/validator';
+export const listUsersTool = {
+    spec: {
+        name: 'list_users',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    request: {
+        method: 'GET',
+        path: '/users',
+        pathParameters: [],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const postUsersTool = {
+    spec: {
+        name: 'post_users',
+        parameters: {
+            type: 'object',
+            properties: {
+                createdAt: {
+                    format: 'date-time',
+                    type: 'string',
+                },
+                email: {
+                    maxLength: 255,
+                    type: 'string',
+                },
+            },
+            required: ['email'],
+        },
+    },
+    request: {
+        method: 'POST',
+        path: '/users',
+        pathParameters: [],
+        queryParameters: [],
+        bodyParameters: ['createdAt', 'email'],
+        hasBody: true,
+    },
+    validate: (input) => assert(input),
+};
+export const getUsersHealthTool = {
+    spec: {
+        name: 'get_users_health',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    request: {
+        method: 'GET',
+        path: '/users/health',
+        pathParameters: [],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const deleteUsersIdTool = {
+    spec: {
+        name: 'delete_users_id',
+        parameters: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    request: {
+        method: 'DELETE',
+        path: '/users/{id}',
+        pathParameters: ['id'],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const getUsersIdTool = {
+    spec: {
+        name: 'get_users_id',
+        parameters: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    request: {
+        method: 'GET',
+        path: '/users/{id}',
+        pathParameters: ['id'],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const postUsersIdRolesTool = {
+    spec: {
+        name: 'post_users_id_roles',
+        parameters: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    request: {
+        method: 'POST',
+        path: '/users/{id}/roles',
+        pathParameters: ['id'],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const putUsersIdRolesRoleIdTool = {
+    spec: {
+        name: 'put_users_id_roles_roleId',
+        parameters: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                },
+                roleId: {
+                    type: 'string',
+                },
+            },
+            required: ['id', 'roleId'],
+        },
+    },
+    request: {
+        method: 'PUT',
+        path: '/users/{id}/roles/{roleId}',
+        pathParameters: ['id', 'roleId'],
+        queryParameters: [],
+        bodyParameters: [],
+        hasBody: false,
+    },
+    validate: (input) => assert(input),
+};
+export const openApiTools = {
+    list_users: listUsersTool,
+    post_users: postUsersTool,
+    get_users_health: getUsersHealthTool,
+    delete_users_id: deleteUsersIdTool,
+    get_users_id: getUsersIdTool,
+    post_users_id_roles: postUsersIdRolesTool,
+    put_users_id_roles_roleId: putUsersIdRolesRoleIdTool,
+};
+//# sourceMappingURL=openapi-tools.fixture.js.map

package/dist/openapi/__fixtures__/openapi-tools.fixture.js.map

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

package/dist/openapi/__fixtures__/route-schemas.d.ts

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

package/dist/openapi/__fixtures__/route-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-schemas.d.ts","sourceRoot":"","sources":["../../../src/openapi/__fixtures__/route-schemas.ts"],"names":[],"mappings":""}

package/dist/openapi/__fixtures__/route-schemas.js

@@ -0,0 +1,17 @@
+// One operation's request and response documents, asked for by type.
+//
+// `generated-schemas.spec.ts` runs the build transform over this file and puts the
+// resulting documents into one method-specific HttpContractIR operation. The OpenAPI
+// renderer receives only that IR; it never sees this declaration or reflects the types.
+//
+// `documents` is declared rather than defined so assignability is checked while the
+// emitted values stay available to the spec, which supplies the function at evaluation.
+import {} from '@zmdb/schema/derive';
+import { toJsonSchema } from '@zmdb/schema/openapi';
+documents({
+    // The create body: no `id`, because the database makes it, and `createdAt` optional,
+    // because it has a default. Both facts come from the type.
+    body: toJsonSchema(),
+    response: toJsonSchema(),
+});
+//# sourceMappingURL=route-schemas.js.map

package/dist/openapi/__fixtures__/route-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-schemas.js","sourceRoot":"","sources":["../../../src/openapi/__fixtures__/route-schemas.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,mFAAmF;AACnF,qFAAqF;AACrF,wFAAwF;AACxF,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AAExF,OAAO,EAAgC,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAyB,MAAM,sBAAsB,CAAC;AAW3E,SAAS,CAAC;IACR,qFAAqF;IACrF,2DAA2D;IAC3D,IAAI,EAAE,YAAY,EAAmB;IACrC,QAAQ,EAAE,YAAY,EAAiB;CACxC,CAAC,CAAC"}

package/dist/openapi/index.d.ts

@@ -0,0 +1,61 @@
+import type { HttpContractIR, JsonValue, SecurityRequirement, SecurityScheme } from '../contract/index.js';
+export type { AuthorizationCodeFlow, ClientCredentialsFlow, ImplicitFlow, OAuthFlow, OAuthFlows, PasswordFlow, SecurityRequirement, SecurityScheme, } from '../contract/index.js';
+export type JsonSchema = Readonly<Record<string, JsonValue>>;
+export interface OpenApiRenderOptions {
+    readonly info?: {
+        readonly title: string;
+        readonly version: string;
+    };
+}
+interface OpenApiParameter {
+    readonly name: string;
+    readonly in: 'path' | 'query' | 'header' | 'cookie';
+    readonly required: boolean;
+    readonly style: 'simple' | 'form';
+    readonly explode: boolean;
+    readonly allowReserved?: false;
+    readonly schema: JsonSchema;
+}
+interface OpenApiHeader {
+    readonly required: boolean;
+    readonly schema: JsonSchema;
+    readonly description?: string;
+}
+interface OpenApiMedia {
+    readonly schema: JsonSchema;
+}
+type OpenApiContent = Record<string, OpenApiMedia>;
+interface OpenApiResponse {
+    readonly description: string;
+    readonly headers?: Record<string, OpenApiHeader>;
+    readonly content?: OpenApiContent;
+}
+interface OpenApiRequestBody {
+    readonly required: boolean;
+    readonly content: OpenApiContent;
+}
+interface OpenApiOperation {
+    readonly operationId: string;
+    readonly parameters?: readonly OpenApiParameter[];
+    readonly requestBody?: OpenApiRequestBody;
+    readonly responses: Record<string, OpenApiResponse>;
+    readonly security: readonly SecurityRequirement[];
+    readonly deprecated?: true;
+}
+type PathItem = Record<string, OpenApiOperation>;
+export interface OpenApiDocument {
+    readonly openapi: '3.1.0';
+    readonly info: {
+        readonly title: string;
+        readonly version: string;
+    };
+    readonly paths: Record<string, PathItem>;
+    readonly components?: {
+        readonly securitySchemes: Readonly<Record<string, SecurityScheme>>;
+    };
+}
+/** Project one serialisable HTTP contract into an OpenAPI 3.1 document. */
+export declare function toOpenApi(contract: HttpContractIR, options?: OpenApiRenderOptions): OpenApiDocument;
+/** Return a handler that serves one prebuilt document by identity. */
+export declare function serveOpenApi(doc: OpenApiDocument): () => OpenApiDocument;
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/index.d.ts.map

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

package/dist/openapi/index.js

@@ -0,0 +1,314 @@
+// @zmdb/web/openapi — deterministic HttpContractIR to OpenAPI 3.1 projection.
+//
+// Contract collection and TypeIR projection happen in @zmdb/web/contract/compiler.
+// This module reads only serialisable operation data and the precomputed `openApi`
+// documents attached to type IDs.
+const METHODS = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+const FIXED_BODY_SCHEMAS = {
+    text: { type: 'string' },
+    bytes: { type: 'string', format: 'binary' },
+    stream: { type: 'string', format: 'binary' },
+};
+function contractError(field, problem) {
+    return new Error(`OpenAPI contract at ${field}: ${problem}`);
+}
+function operationError(operationId, field, problem) {
+    return new Error(`OpenAPI contract ${operationId} at ${field}: ${problem}`);
+}
+function openApiPath(path) {
+    const parameters = [];
+    const value = path.replace(/:([^/]+)/g, (_match, name) => {
+        parameters.push(name);
+        return `{${name}}`;
+    });
+    return { value, parameters };
+}
+function sameStrings(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function sameStringSets(left, right) {
+    if (left.length !== right.length)
+        return false;
+    const expected = right.toSorted();
+    return left.toSorted().every((value, index) => value === expected[index]);
+}
+function schemaFor(contract, operation, field, typeId) {
+    const schema = contract.types[typeId]?.openApi;
+    if (schema === undefined) {
+        throw operationError(operation.operationId, field, `references missing typeId "${typeId}"`);
+    }
+    return schema;
+}
+function schemaForBody(contract, operation, field, body) {
+    if ('typeId' in body) {
+        return schemaFor(contract, operation, `${field}.typeId`, body.typeId);
+    }
+    return FIXED_BODY_SCHEMAS[body.kind];
+}
+function parameterFor(contract, operation, parameter, index) {
+    const field = `parameters.${String(index)}`;
+    const schema = schemaFor(contract, operation, `${field}.typeId`, parameter.typeId);
+    switch (parameter.in) {
+        case 'path':
+            if (!parameter.required) {
+                throw operationError(operation.operationId, `${field}.required`, 'a path parameter must be required');
+            }
+            return {
+                name: parameter.name,
+                in: 'path',
+                required: true,
+                style: 'simple',
+                explode: false,
+                allowReserved: false,
+                schema,
+            };
+        case 'query':
+            return {
+                name: parameter.name,
+                in: 'query',
+                required: parameter.required,
+                style: 'form',
+                explode: true,
+                allowReserved: false,
+                schema,
+            };
+        case 'header':
+            return {
+                name: parameter.name,
+                in: 'header',
+                required: parameter.required,
+                style: 'simple',
+                explode: false,
+                schema,
+            };
+        case 'cookie':
+            return {
+                name: parameter.name,
+                in: 'cookie',
+                required: parameter.required,
+                style: 'form',
+                explode: true,
+                schema,
+            };
+    }
+}
+function assertVersionValues(operation) {
+    const version = operation.version;
+    if (version.kind !== 'header' && version.kind !== 'media-type')
+        return;
+    if (version.values.length === 0) {
+        throw operationError(operation.operationId, 'version.values', 'must contain at least one version');
+    }
+    if (new Set(version.values).size !== version.values.length) {
+        throw operationError(operation.operationId, 'version.values', 'contains a duplicate version');
+    }
+    if (!version.values.includes(version.default)) {
+        throw operationError(operation.operationId, 'version.default', `"${version.default}" is not one of the declared values`);
+    }
+}
+function versionParameter(operation) {
+    const version = operation.version;
+    if (version.kind !== 'header')
+        return undefined;
+    return {
+        name: version.name,
+        in: 'header',
+        required: false,
+        style: 'simple',
+        explode: false,
+        schema: { type: 'string', enum: [...version.values], default: version.default },
+    };
+}
+function contentForBody(contract, operation, field, body) {
+    if (body.kind === 'empty')
+        return undefined;
+    return { [body.mediaType]: { schema: schemaForBody(contract, operation, field, body) } };
+}
+function contentForResponse(contract, operation, response, field) {
+    if (operation.version.kind !== 'media-type') {
+        if (response.versions !== undefined) {
+            throw operationError(operation.operationId, `${field}.versions`, 'is present on a response that does not use media-type versioning');
+        }
+        return contentForBody(contract, operation, `${field}.body`, response.body);
+    }
+    const versions = response.versions;
+    if (versions !== undefined && !sameStringSets(Object.keys(versions), operation.version.values)) {
+        throw operationError(operation.operationId, `${field}.versions`, `must declare exactly [${operation.version.values.join(', ')}]`);
+    }
+    const content = {};
+    for (const value of operation.version.values) {
+        const body = versions?.[value] ?? response.body;
+        if (body.kind === 'empty')
+            continue;
+        const mediaType = `${body.mediaType}; ${operation.version.key}=${value}`;
+        if (content[mediaType] !== undefined) {
+            throw operationError(operation.operationId, `${field}.versions.${value}`, `duplicates media type "${mediaType}"`);
+        }
+        content[mediaType] = {
+            schema: schemaForBody(contract, operation, `${field}.versions.${value}`, body),
+        };
+    }
+    return Object.keys(content).length === 0 ? undefined : content;
+}
+function responseFor(contract, operation, response, index) {
+    const field = `responses.${String(index)}`;
+    if (!Number.isInteger(response.status) || response.status < 200 || response.status > 599) {
+        throw operationError(operation.operationId, `${field}.status`, 'must be an integer from 200 through 599');
+    }
+    const names = new Set();
+    const headers = {};
+    for (const [headerIndex, header] of response.headers.entries()) {
+        const key = header.name.toLowerCase();
+        if (names.has(key)) {
+            throw operationError(operation.operationId, `${field}.headers.${String(headerIndex)}.name`, `duplicates response header "${header.name}"`);
+        }
+        names.add(key);
+        headers[header.name] = {
+            required: header.required,
+            schema: schemaFor(contract, operation, `${field}.headers.${String(headerIndex)}.typeId`, header.typeId),
+            ...(header.description === undefined ? {} : { description: header.description }),
+        };
+    }
+    const content = contentForResponse(contract, operation, response, field);
+    return {
+        description: response.description,
+        ...(Object.keys(headers).length === 0 ? {} : { headers }),
+        ...(content === undefined ? {} : { content }),
+    };
+}
+function securityFor(contract, operation) {
+    return operation.security.map((requirement, index) => {
+        const canonical = {};
+        for (const scheme of Object.keys(requirement).toSorted()) {
+            if (contract.securitySchemes[scheme] === undefined) {
+                throw operationError(operation.operationId, `security.${String(index)}.${scheme}`, 'references an undeclared scheme');
+            }
+            canonical[scheme] = [...(requirement[scheme] ?? [])];
+        }
+        return canonical;
+    });
+}
+function projectOperation(contract, operation) {
+    if (operation.operationId.length === 0) {
+        throw operationError('<empty>', 'operationId', 'must not be empty');
+    }
+    if (!METHODS.has(operation.method)) {
+        throw operationError(operation.operationId, 'method', `"${operation.method}" is not supported`);
+    }
+    if (!operation.path.startsWith('/')) {
+        throw operationError(operation.operationId, 'path', 'must start with "/"');
+    }
+    if (operation.responses.length === 0) {
+        throw operationError(operation.operationId, 'responses', 'must contain at least one exact status');
+    }
+    assertVersionValues(operation);
+    const projectedPath = openApiPath(operation.path);
+    const pathParameters = operation.parameters
+        .filter(parameter => parameter.in === 'path')
+        .map(parameter => parameter.name);
+    if (!sameStrings(projectedPath.parameters, pathParameters)) {
+        throw operationError(operation.operationId, 'path', `placeholders [${projectedPath.parameters.join(', ')}] do not match path parameters ` +
+            `[${pathParameters.join(', ')}]`);
+    }
+    const wireNames = new Set();
+    const parameters = operation.parameters.map((parameter, index) => {
+        const wireKey = `${parameter.in}\u0000${parameter.in === 'header' ? parameter.name.toLowerCase() : parameter.name}`;
+        if (wireNames.has(wireKey)) {
+            throw operationError(operation.operationId, `parameters.${String(index)}.name`, `duplicates ${parameter.in} parameter "${parameter.name}"`);
+        }
+        wireNames.add(wireKey);
+        return parameterFor(contract, operation, parameter, index);
+    });
+    const version = versionParameter(operation);
+    if (version !== undefined) {
+        const wireKey = `header\u0000${version.name.toLowerCase()}`;
+        if (wireNames.has(wireKey)) {
+            throw operationError(operation.operationId, 'version.name', `duplicates header parameter "${version.name}"`);
+        }
+        parameters.push(version);
+    }
+    let requestBody;
+    if (operation.requestBody !== undefined) {
+        const content = contentForBody(contract, operation, 'requestBody', operation.requestBody);
+        if (content === undefined) {
+            throw operationError(operation.operationId, 'requestBody.kind', 'cannot be empty');
+        }
+        requestBody = { required: operation.requestBody.required, content };
+    }
+    const responses = {};
+    for (const [index, response] of operation.responses.toSorted((left, right) => left.status - right.status).entries()) {
+        const status = String(response.status);
+        if (responses[status] !== undefined) {
+            throw operationError(operation.operationId, `responses.${String(index)}.status`, `duplicates status ${status}`);
+        }
+        responses[status] = responseFor(contract, operation, response, index);
+    }
+    return {
+        operationId: operation.operationId,
+        path: projectedPath.value,
+        method: operation.method.toLowerCase(),
+        value: {
+            operationId: operation.operationId,
+            ...(parameters.length === 0 ? {} : { parameters }),
+            ...(requestBody === undefined ? {} : { requestBody }),
+            responses,
+            security: securityFor(contract, operation),
+            ...(operation.deprecated ? { deprecated: true } : {}),
+        },
+    };
+}
+function sortedSecuritySchemes(schemes) {
+    const sorted = {};
+    for (const name of Object.keys(schemes).toSorted()) {
+        const scheme = schemes[name];
+        if (scheme !== undefined)
+            sorted[name] = scheme;
+    }
+    return sorted;
+}
+/** Project one serialisable HTTP contract into an OpenAPI 3.1 document. */
+export function toOpenApi(contract, options = {}) {
+    if (contract.format !== 1) {
+        throw contractError('format', `unsupported HttpContractIR format ${String(contract.format)}`);
+    }
+    if (!Array.isArray(contract.operations)) {
+        throw contractError('operations', 'must be an array');
+    }
+    const projected = contract.operations
+        .map(operation => projectOperation(contract, operation))
+        .toSorted((left, right) => {
+        if (left.path !== right.path)
+            return left.path.localeCompare(right.path);
+        if (left.method !== right.method)
+            return left.method.localeCompare(right.method);
+        return left.operationId.localeCompare(right.operationId);
+    });
+    const operationIds = new Set();
+    const routes = new Map();
+    const paths = {};
+    for (const operation of projected) {
+        if (operationIds.has(operation.operationId)) {
+            throw operationError(operation.operationId, 'operationId', 'appears more than once');
+        }
+        operationIds.add(operation.operationId);
+        const routeKey = `${operation.method}\u0000${operation.path}`;
+        const previous = routes.get(routeKey);
+        if (previous !== undefined) {
+            throw operationError(operation.operationId, 'method/path', `${operation.method.toUpperCase()} ${operation.path} overlaps operation ${previous}`);
+        }
+        routes.set(routeKey, operation.operationId);
+        const item = paths[operation.path] ?? {};
+        item[operation.method] = operation.value;
+        paths[operation.path] = item;
+    }
+    const info = options.info ?? { title: '@zmdb/web API', version: '0.0.0' };
+    const securitySchemes = sortedSecuritySchemes(contract.securitySchemes);
+    return Object.keys(securitySchemes).length === 0
+        ? { openapi: '3.1.0', info, paths }
+        : { openapi: '3.1.0', info, paths, components: { securitySchemes } };
+}
+/** Return a handler that serves one prebuilt document by identity. */
+export function serveOpenApi(doc) {
+    return () => doc;
+}
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

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

package/dist/pipeline/guards.d.ts

@@ -0,0 +1,9 @@
+import type { Guard } from '../middleware/index.js';
+/** Guard instances applied before every route, or every route on one controller. */
+export interface GuardRegistry {
+    readonly app?: readonly Guard[];
+    readonly controllers?: Readonly<Record<string, readonly Guard[]>>;
+}
+/** Resolve the effective guard chain in runtime order: app, controller, route. */
+export declare function resolveGuards(registry: GuardRegistry | undefined, controllerName: string, routeGuards?: readonly Guard[]): readonly Guard[];
+//# sourceMappingURL=guards.d.ts.map

package/dist/pipeline/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/pipeline/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC;CACnE;AAID,kFAAkF;AAClF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,SAAS,KAAK,EAAc,GACxC,SAAS,KAAK,EAAE,CAOlB"}

package/dist/pipeline/guards.js

@@ -0,0 +1,11 @@
+const NO_GUARDS = [];
+/** Resolve the effective guard chain in runtime order: app, controller, route. */
+export function resolveGuards(registry, controllerName, routeGuards = NO_GUARDS) {
+    const appGuards = registry?.app ?? NO_GUARDS;
+    const controllerGuards = registry?.controllers?.[controllerName] ?? NO_GUARDS;
+    if (appGuards.length === 0 && controllerGuards.length === 0) {
+        return routeGuards;
+    }
+    return [...appGuards, ...controllerGuards, ...routeGuards];
+}
+//# sourceMappingURL=guards.js.map

package/dist/pipeline/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/pipeline/guards.ts"],"names":[],"mappings":"AAQA,MAAM,SAAS,GAAqB,EAAE,CAAC;AAEvC,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAC3B,QAAmC,EACnC,cAAsB,EACtB,WAAW,GAAqB,SAAS;IAEzC,MAAM,SAAS,GAAG,QAAQ,EAAE,GAAG,IAAI,SAAS,CAAC;IAC7C,MAAM,gBAAgB,GAAG,QAAQ,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IAC9E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,gBAAgB,EAAE,GAAG,WAAW,CAAC,CAAC;AAC7D,CAAC"}