@mapbox/mcp-server 0.9.0 → 0.11.0

package/dist/esm/tools/destination-tool/DestinationTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EAExB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,eAAgB,SAAQ,QAAQ,CAC3C,OAAO,sBAAsB,EAC7B,OAAO,uBAAuB,CAC/B;IACC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,SAKiB;IAErC,QAAQ,CAAC,WAAW;;;;;;MAMlB;;IASI,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CA2DtD"}

package/dist/esm/tools/destination-tool/DestinationTool.input.schema.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const DestinationInputSchema: z.ZodObject<{
+    origin: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    distance: z.ZodNumber;
+    bearing: z.ZodNumber;
+    units: z.ZodDefault<z.ZodEnum<["kilometers", "miles", "meters", "feet"]>>;
+}, "strip", z.ZodTypeAny, {
+    units: "kilometers" | "miles" | "meters" | "feet";
+    distance: number;
+    origin: {
+        longitude: number;
+        latitude: number;
+    };
+    bearing: number;
+}, {
+    distance: number;
+    origin: {
+        longitude: number;
+        latitude: number;
+    };
+    bearing: number;
+    units?: "kilometers" | "miles" | "meters" | "feet" | undefined;
+}>;
+export type DestinationInput = z.infer<typeof DestinationInputSchema>;
+//# sourceMappingURL=DestinationTool.input.schema.d.ts.map

package/dist/esm/tools/destination-tool/DestinationTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/esm/tools/destination-tool/DestinationTool.input.schema.js

@@ -0,0 +1,22 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+export const DestinationInputSchema = z.object({
+    origin: z
+        .object({
+        longitude: z.number().min(-180).max(180),
+        latitude: z.number().min(-90).max(90)
+    })
+        .describe('Starting point'),
+    distance: z.number().positive().describe('Distance to travel'),
+    bearing: z
+        .number()
+        .min(-180)
+        .max(180)
+        .describe('Direction of travel in degrees (0=north, 90=east, -90=west, 180=south)'),
+    units: z
+        .enum(['kilometers', 'miles', 'meters', 'feet'])
+        .default('meters')
+        .describe('Units for the distance')
+});
+//# sourceMappingURL=DestinationTool.input.schema.js.map

package/dist/esm/tools/destination-tool/DestinationTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;KACtC,CAAC;SACD,QAAQ,CAAC,gBAAgB,CAAC;IAE7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAE9D,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,GAAG,CAAC;SACT,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,wEAAwE,CACzE;IAEH,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;SAC/C,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,wBAAwB,CAAC;CACtC,CAAC,CAAC"}

package/dist/esm/tools/destination-tool/DestinationTool.js

@@ -0,0 +1,79 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { destination, point } from '@turf/turf';
+import { context, SpanStatusCode, trace } from '@opentelemetry/api';
+import { createLocalToolExecutionContext } from '../../utils/tracing.js';
+import { BaseTool } from '../BaseTool.js';
+import { DestinationInputSchema } from './DestinationTool.input.schema.js';
+import { DestinationOutputSchema } from './DestinationTool.output.schema.js';
+export class DestinationTool extends BaseTool {
+    name = 'destination_tool';
+    description = 'Calculate a destination point given a starting point, bearing, and distance using geodesic (great-circle) straight-line offset. ' +
+        'Useful for "find a point 5km north of X", constructing search offsets, or computing waypoints. ' +
+        'Bearing: 0=north, 90=east, 180/-180=south, -90=west. ' +
+        'Note: this calculates a straight-line geographic offset, not road-network distance. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Calculate Destination',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({
+            inputSchema: DestinationInputSchema,
+            outputSchema: DestinationOutputSchema
+        });
+    }
+    async run(rawInput) {
+        const toolContext = createLocalToolExecutionContext(this.name, 0);
+        return await context.with(trace.setSpan(context.active(), toolContext.span), async () => {
+            try {
+                const input = DestinationInputSchema.parse(rawInput);
+                const origin = point([input.origin.longitude, input.origin.latitude]);
+                const result = destination(origin, input.distance, input.bearing, {
+                    units: input.units
+                });
+                const output = {
+                    destination: {
+                        longitude: result.geometry.coordinates[0],
+                        latitude: result.geometry.coordinates[1]
+                    },
+                    distance: input.distance,
+                    bearing: input.bearing,
+                    units: input.units
+                };
+                const validated = this.validateOutput(output);
+                const text = `Destination: [${validated.destination.longitude}, ${validated.destination.latitude}]\n` +
+                    `From: [${input.origin.longitude}, ${input.origin.latitude}]\n` +
+                    `Distance: ${validated.distance} ${validated.units} at bearing ${validated.bearing}°`;
+                toolContext.span.setStatus({ code: SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `DestinationTool: ${errorMessage}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=DestinationTool.js.map

package/dist/esm/tools/destination-tool/DestinationTool.js.map

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

package/dist/esm/tools/destination-tool/DestinationTool.output.schema.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const DestinationOutputSchema: z.ZodObject<{
+    destination: z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>;
+    distance: z.ZodNumber;
+    bearing: z.ZodNumber;
+    units: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    units: string;
+    distance: number;
+    bearing: number;
+    destination: {
+        longitude: number;
+        latitude: number;
+    };
+}, {
+    units: string;
+    distance: number;
+    bearing: number;
+    destination: {
+        longitude: number;
+        latitude: number;
+    };
+}>;
+export type DestinationOutput = z.infer<typeof DestinationOutputSchema>;
+//# sourceMappingURL=DestinationTool.output.schema.d.ts.map

package/dist/esm/tools/destination-tool/DestinationTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/tools/destination-tool/DestinationTool.output.schema.js

@@ -0,0 +1,15 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+export const DestinationOutputSchema = z.object({
+    destination: z
+        .object({
+        longitude: z.number(),
+        latitude: z.number()
+    })
+        .describe('The calculated destination point'),
+    distance: z.number().describe('Distance traveled'),
+    bearing: z.number().describe('Bearing used'),
+    units: z.string().describe('Distance units')
+});
+//# sourceMappingURL=DestinationTool.output.schema.js.map

package/dist/esm/tools/destination-tool/DestinationTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/destination-tool/DestinationTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;SACD,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CAC7C,CAAC,CAAC"}

package/dist/esm/tools/difference-tool/DifferenceTool.d.ts

@@ -0,0 +1,18 @@
+import { BaseTool } from '../BaseTool.js';
+import { DifferenceInputSchema } from './DifferenceTool.input.schema.js';
+import { DifferenceOutputSchema } from './DifferenceTool.output.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare class DifferenceTool extends BaseTool<typeof DifferenceInputSchema, typeof DifferenceOutputSchema> {
+    readonly name = "difference_tool";
+    readonly description: string;
+    readonly annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    constructor();
+    run(rawInput: unknown): Promise<CallToolResult>;
+}
+//# sourceMappingURL=DifferenceTool.d.ts.map

package/dist/esm/tools/difference-tool/DifferenceTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,sBAAsB,EAEvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qBAAa,cAAe,SAAQ,QAAQ,CAC1C,OAAO,qBAAqB,EAC5B,OAAO,sBAAsB,CAC9B;IACC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAIiB;IAErC,QAAQ,CAAC,WAAW;;;;;;MAMlB;;IASI,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CAmDtD"}

package/dist/esm/tools/difference-tool/DifferenceTool.input.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const DifferenceInputSchema: z.ZodObject<{
+    polygon1: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber, "many">, "many">, "many">;
+    polygon2: z.ZodArray<z.ZodArray<z.ZodArray<z.ZodNumber, "many">, "many">, "many">;
+}, "strip", z.ZodTypeAny, {
+    polygon1: number[][][];
+    polygon2: number[][][];
+}, {
+    polygon1: number[][][];
+    polygon2: number[][][];
+}>;
+export type DifferenceInput = z.infer<typeof DifferenceInputSchema>;
+//# sourceMappingURL=DifferenceTool.input.schema.d.ts.map

package/dist/esm/tools/difference-tool/DifferenceTool.input.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.input.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.input.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/esm/tools/difference-tool/DifferenceTool.input.schema.js

@@ -0,0 +1,9 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+import { PolygonSchema } from '../shared/polygonSchema.js';
+export const DifferenceInputSchema = z.object({
+    polygon1: PolygonSchema.describe('The polygon to subtract from'),
+    polygon2: PolygonSchema.describe('The polygon to subtract')
+});
+//# sourceMappingURL=DifferenceTool.input.schema.js.map

package/dist/esm/tools/difference-tool/DifferenceTool.input.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.input.schema.js","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.input.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAChE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC5D,CAAC,CAAC"}

package/dist/esm/tools/difference-tool/DifferenceTool.js

@@ -0,0 +1,71 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { difference, polygon, featureCollection } from '@turf/turf';
+import { context, SpanStatusCode, trace } from '@opentelemetry/api';
+import { createLocalToolExecutionContext } from '../../utils/tracing.js';
+import { BaseTool } from '../BaseTool.js';
+import { DifferenceInputSchema } from './DifferenceTool.input.schema.js';
+import { DifferenceOutputSchema } from './DifferenceTool.output.schema.js';
+export class DifferenceTool extends BaseTool {
+    name = 'difference_tool';
+    description = 'Subtract one polygon from another, returning the area in polygon1 that is not covered by polygon2. ' +
+        'Useful for computing exclusion zones, finding uncovered service areas, or "what is in zone A but not zone B?". ' +
+        'Returns null geometry if polygon2 fully covers polygon1. ' +
+        'Works offline without API calls.';
+    annotations = {
+        title: 'Difference of Polygons',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    };
+    constructor() {
+        super({
+            inputSchema: DifferenceInputSchema,
+            outputSchema: DifferenceOutputSchema
+        });
+    }
+    async run(rawInput) {
+        const toolContext = createLocalToolExecutionContext(this.name, 0);
+        return await context.with(trace.setSpan(context.active(), toolContext.span), async () => {
+            try {
+                const input = DifferenceInputSchema.parse(rawInput);
+                const poly1 = polygon(input.polygon1);
+                const poly2 = polygon(input.polygon2);
+                const result = difference(featureCollection([poly1, poly2]));
+                const output = {
+                    has_difference: result !== null,
+                    geometry: result
+                        ? result.geometry
+                        : null
+                };
+                const validated = this.validateOutput(output);
+                const text = validated.has_difference
+                    ? `Difference computed (area in polygon1 not covered by polygon2).\nGeometry:\n${JSON.stringify(validated.geometry, null, 2)}`
+                    : 'No difference: polygon2 fully covers polygon1.';
+                toolContext.span.setStatus({ code: SpanStatusCode.OK });
+                toolContext.span.end();
+                return {
+                    content: [{ type: 'text', text }],
+                    structuredContent: validated,
+                    isError: false
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                toolContext.span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+                return {
+                    content: [
+                        { type: 'text', text: `DifferenceTool: ${errorMessage}` }
+                    ],
+                    isError: true
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=DifferenceTool.js.map

package/dist/esm/tools/difference-tool/DifferenceTool.js.map

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

package/dist/esm/tools/difference-tool/DifferenceTool.output.schema.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const DifferenceOutputSchema: z.ZodObject<{
+    has_difference: z.ZodBoolean;
+    geometry: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    geometry: Record<string, unknown> | null;
+    has_difference: boolean;
+}, {
+    geometry: Record<string, unknown> | null;
+    has_difference: boolean;
+}>;
+export type DifferenceOutput = z.infer<typeof DifferenceOutputSchema>;
+//# sourceMappingURL=DifferenceTool.output.schema.d.ts.map

package/dist/esm/tools/difference-tool/DifferenceTool.output.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.output.schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.output.schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;EAYjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/esm/tools/difference-tool/DifferenceTool.output.schema.js

@@ -0,0 +1,13 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { z } from 'zod';
+export const DifferenceOutputSchema = z.object({
+    has_difference: z
+        .boolean()
+        .describe('Whether any area remains after subtracting polygon2 from polygon1'),
+    geometry: z
+        .record(z.unknown())
+        .nullable()
+        .describe('GeoJSON geometry of the remaining area (polygon1 minus polygon2), or null if polygon2 fully covers polygon1')
+});
+//# sourceMappingURL=DifferenceTool.output.schema.js.map

package/dist/esm/tools/difference-tool/DifferenceTool.output.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DifferenceTool.output.schema.js","sourceRoot":"","sources":["../../../../src/tools/difference-tool/DifferenceTool.output.schema.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,CACP,mEAAmE,CACpE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,6GAA6G,CAC9G;CACJ,CAAC,CAAC"}