cad-mcp-server 0.1.0

package/dist/query/faces.js

@@ -0,0 +1,309 @@
+import { computeEdgeVexity } from '../kernel/aag-utils.js';
+import { normalizeVector, angleDegreesNormalized } from '../utils/vectors.js';
+import { withStepModel } from '../model-store.js';
+import { normalizePagination, createPagination, createQueryResponse, groupEntities, magnitudeBucketKey, radiusBucketValue, axisDirectionKey, DEFAULT_QUERY_LIMITS, } from './shared.js';
+/**
+ * Query STEP file faces with filtering, sorting, and pagination.
+ */
+export async function queryStepFaces(filePath, input) {
+    return withStepModel(filePath, async (model) => {
+        const includeBodyId = Boolean(input.filter?.body_ids?.length ||
+            input.include?.includes('body_id') ||
+            input.group_by?.includes('body_id'));
+        const allFaces = await model.getFaceEntities(includeBodyId);
+        const { kernel, shape } = await model.getShapeContext('query_step_faces');
+        // Pre-filter by group_ids: resolve which entities belong to requested groups.
+        let preFiltered = allFaces;
+        if (input.filter?.group_ids && input.filter.group_ids.length > 0) {
+            const groupBy = input.group_by;
+            const preGroups = groupFaces(allFaces, groupBy, 0);
+            const groupIdSet = new Set(input.filter.group_ids);
+            const allowedIds = new Set();
+            for (const g of preGroups) {
+                if (groupIdSet.has(g.id)) {
+                    for (const id of g.entity_ids)
+                        allowedIds.add(id);
+                }
+            }
+            preFiltered = allFaces.filter((f) => allowedIds.has(f.id));
+        }
+        // Apply filters.
+        let filtered = applyFaceFilters(preFiltered, input.filter);
+        // Apply sorting.
+        if (input.sort) {
+            filtered = sortFaces(filtered, input.sort);
+        }
+        const resultMode = input.result_mode ?? 'entities';
+        const total_matched = filtered.length;
+        // Grouping (result_mode "groups").
+        const groups = resultMode === 'groups'
+            ? groupFaces(filtered, input.group_by, DEFAULT_QUERY_LIMITS.sample_entity_limit)
+            : [];
+        // Pagination + projection (skipped for summary/groups modes to save tokens).
+        const { limit, offset } = normalizePagination(input.limit, input.offset);
+        const includeEntities = resultMode === 'entities';
+        const paginated = includeEntities ? filtered.slice(offset, offset + limit) : [];
+        // Compute adjacency and closest-face-distance for paginated faces on demand.
+        const faceShapes = kernel.getSubShapes(shape, 'face');
+        const adjacencies = buildFaceAdjacencies(kernel, shape, faceShapes, paginated, input.include);
+        const closestDistances = buildClosestFaceDistances(kernel, faceShapes, paginated, allFaces, input.include);
+        const augmentedFaces = paginated.map((face) => ({
+            ...face,
+            ...(adjacencies ? { adjacent_faces: adjacencies.get(face.id) ?? [] } : {}),
+            ...(closestDistances ? { closest_face_distance: closestDistances.get(face.id) } : {}),
+        }));
+        const entities = augmentedFaces.map((face) => projectFace(face, input.include));
+        const pagination = createPagination(limit, offset, paginated.length, total_matched);
+        return createQueryResponse(filePath, {
+            filter: input.filter ?? {},
+            include: input.include ?? [],
+            group_by: input.group_by ?? null,
+            result_mode: resultMode,
+            sort: input.sort ?? null,
+            limit,
+            offset,
+        }, pagination, entities, {
+            total_faces: allFaces.length,
+            matched_faces: total_matched,
+            surface_types: aggregateSurfaceTypes(filtered),
+            area_range: getAreaRange(filtered),
+        }, groups, [], // warnings
+        [] // limitations
+        );
+    });
+}
+/**
+ * Build adjacency data for paginated faces when requested via include.
+ */
+function buildFaceAdjacencies(kernel, shape, faceShapes, paginated, include) {
+    if (!include?.includes('adjacent_faces'))
+        return undefined;
+    const result = new Map();
+    for (const face of paginated) {
+        const idx = face.index;
+        const faceShape = faceShapes[idx];
+        const adjacent = kernel.adjacentFaces(shape, faceShape);
+        const entries = [];
+        for (const adjFace of adjacent) {
+            const adjIdx = faceShapes.findIndex((s) => kernel.isSame(s, adjFace));
+            if (adjIdx === -1)
+                continue;
+            const sharedEdges = kernel.sharedEdges(faceShape, adjFace);
+            if (sharedEdges.length === 0)
+                continue;
+            const vexityResult = computeEdgeVexity(kernel, faceShape, adjFace, sharedEdges[0]);
+            entries.push({
+                face_id: `face:${adjIdx}`,
+                surface_type: kernel.surfaceType(adjFace),
+                dihedral_angle_deg: vexityResult.dihedralAngleDeg,
+            });
+        }
+        result.set(face.id, entries);
+    }
+    return result;
+}
+/**
+ * Compute closest face distance for each paginated face when requested.
+ */
+function buildClosestFaceDistances(kernel, faceShapes, paginated, allFaces, include) {
+    if (!include?.includes('closest_face_distance'))
+        return undefined;
+    const result = new Map();
+    const allIndices = allFaces.map((f) => f.index);
+    for (const face of paginated) {
+        const idx = face.index;
+        const faceShape = faceShapes[idx];
+        let bestFace = '';
+        let bestDist = Number.POSITIVE_INFINITY;
+        for (const otherIdx of allIndices) {
+            if (otherIdx === idx)
+                continue;
+            const dist = kernel.distanceBetween(faceShape, faceShapes[otherIdx]);
+            if (dist < bestDist) {
+                bestDist = dist;
+                bestFace = `face:${otherIdx}`;
+            }
+        }
+        result.set(face.id, {
+            face_id: bestFace,
+            distance: bestDist === Number.POSITIVE_INFINITY ? -1 : bestDist,
+        });
+    }
+    return result;
+}
+/**
+ * Group faces by the requested dimensions using fixed server-side buckets.
+ */
+function groupFaces(faces, groupBy, sampleLimit) {
+    const dimensions = groupBy ?? ['surface_type'];
+    const limit = sampleLimit ?? DEFAULT_QUERY_LIMITS.sample_entity_limit;
+    return groupEntities(faces, dimensions, (face, dimension) => {
+        switch (dimension) {
+            case 'surface_type':
+                return face.surface_type;
+            case 'normal_direction':
+                return face.normal ? axisDirectionKey(face.normal) : 'undefined';
+            case 'area_range':
+                return magnitudeBucketKey(face.area);
+            case 'radius':
+                return face.radius !== undefined ? radiusBucketValue(face.radius) : null;
+            case 'body_id':
+                return face.body_id ?? 'unknown';
+            default:
+                return null;
+        }
+    }, limit, (members) => ({
+        area_range: getAreaRange(members),
+    }));
+}
+/**
+ * Apply face filters to a set of faces.
+ */
+function applyFaceFilters(faces, filter) {
+    let result = faces;
+    if (filter) {
+        if (filter.entity_ids && filter.entity_ids.length > 0) {
+            const idSet = new Set(filter.entity_ids);
+            result = result.filter((f) => idSet.has(f.id));
+        }
+        if (filter.body_ids && filter.body_ids.length > 0) {
+            const bodySet = new Set(filter.body_ids);
+            result = result.filter((f) => f.body_id !== undefined && bodySet.has(f.body_id));
+        }
+        if (filter.surface_type && filter.surface_type.length > 0) {
+            const typeSet = new Set(filter.surface_type);
+            result = result.filter((f) => typeSet.has(f.surface_type));
+        }
+        if (filter.area_min !== undefined) {
+            result = result.filter((f) => f.area >= filter.area_min);
+        }
+        if (filter.area_max !== undefined) {
+            result = result.filter((f) => f.area <= filter.area_max);
+        }
+        // Normal parallel to filter.
+        if (filter.normal_parallel_to) {
+            const targetNormal = normalizeVector(filter.normal_parallel_to);
+            const tolerance = filter.normal_tolerance_degrees ?? 10;
+            result = result.filter((f) => {
+                if (!f.normal)
+                    return false;
+                const faceNormal = normalizeVector(f.normal);
+                const angle = angleDegreesNormalized(faceNormal, targetNormal);
+                // Allow angle or 180-angle (opposite direction).
+                return Math.min(angle, 180 - angle) <= tolerance;
+            });
+        }
+    }
+    return result;
+}
+/**
+ * Sort faces by the specified criteria.
+ */
+function sortFaces(faces, sort) {
+    const sorted = [...faces];
+    const direction = sort.direction === 'desc' ? -1 : 1;
+    sorted.sort((a, b) => {
+        let cmp = 0;
+        switch (sort.by) {
+            case 'area':
+                cmp = a.area - b.area;
+                break;
+            case 'surface_type':
+                cmp = a.surface_type.localeCompare(b.surface_type);
+                break;
+            case 'center_x':
+                cmp = a.center[0] - b.center[0];
+                break;
+            case 'center_y':
+                cmp = a.center[1] - b.center[1];
+                break;
+            case 'center_z':
+                cmp = a.center[2] - b.center[2];
+                break;
+        }
+        return cmp * direction;
+    });
+    return sorted;
+}
+/**
+ * Project a face to only the requested include fields.
+ */
+function projectFace(face, include) {
+    const fields = include ?? ['id', 'surface_type', 'area', 'bbox', 'center'];
+    const result = {};
+    for (const field of fields) {
+        switch (field) {
+            case 'id':
+                result.id = face.id;
+                break;
+            case 'surface_type':
+                result.surface_type = face.surface_type;
+                break;
+            case 'area':
+                result.area = face.area;
+                break;
+            case 'bbox':
+                result.bbox = face.bbox;
+                break;
+            case 'center':
+                result.bbox_center = face.center;
+                break;
+            case 'normal':
+                if (face.normal !== undefined)
+                    result.normal = face.normal;
+                break;
+            case 'surface_parameters':
+                // Surface-specific parameters like radius for cylinders.
+                result.surface_parameters = face.radius !== undefined ? { radius: face.radius } : {};
+                break;
+            case 'axis':
+                if (face.axis !== undefined)
+                    result.axis = face.axis;
+                break;
+            case 'adjacent_faces':
+                if (face.adjacent_faces !== undefined)
+                    result.adjacent_faces = face.adjacent_faces;
+                break;
+            case 'closest_face_distance':
+                if (face.closest_face_distance !== undefined)
+                    result.closest_face_distance = face.closest_face_distance;
+                break;
+            case 'has_inner_wires':
+                if (face.has_inner_wires !== undefined)
+                    result.has_inner_wires = face.has_inner_wires;
+                break;
+            case 'body_id':
+                if (face.body_id !== undefined)
+                    result.body_id = face.body_id;
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Aggregate surface types in a set of faces.
+ */
+function aggregateSurfaceTypes(faces) {
+    const agg = {};
+    for (const face of faces) {
+        agg[face.surface_type] = (agg[face.surface_type] ?? 0) + 1;
+    }
+    return agg;
+}
+/**
+ * Get area range of faces.
+ */
+function getAreaRange(faces) {
+    if (faces.length === 0)
+        return null;
+    let min = Number.POSITIVE_INFINITY;
+    let max = Number.NEGATIVE_INFINITY;
+    for (const face of faces) {
+        if (face.area < min)
+            min = face.area;
+        if (face.area > max)
+            max = face.area;
+    }
+    return { min, max };
+}
+//# sourceMappingURL=faces.js.map

package/dist/query/faces.js.map

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

package/dist/query/pmi.d.ts

@@ -0,0 +1,3 @@
+import type { QueryStepPmiInput } from '../tools/step-tools.js';
+export declare function queryStepPmi(filePath: string, input: QueryStepPmiInput): Promise<import("../tools/step-tools.js").StepQueryResponse<Record<string, unknown>>>;
+//# sourceMappingURL=pmi.d.ts.map

package/dist/query/pmi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pmi.d.ts","sourceRoot":"","sources":["../../src/query/pmi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAkBhE,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,wFAsK5E"}

package/dist/query/pmi.js

@@ -0,0 +1,141 @@
+import { withStepModel } from '../model-store.js';
+import { normalizePagination, createPagination, createQueryResponse, DEFAULT_QUERY_LIMITS, } from './shared.js';
+export async function queryStepPmi(filePath, input) {
+    return withStepModel(filePath, async (model) => {
+        const full = await model.getPmiEntities();
+        let filtered = [...full.pmi_entities];
+        // Apply filters.
+        if (input.filter?.pmi_types && input.filter.pmi_types.length > 0) {
+            const typeSet = new Set(input.filter.pmi_types);
+            filtered = filtered.filter((e) => typeSet.has(e.type));
+        }
+        if (input.filter?.tolerance_types && input.filter.tolerance_types.length > 0) {
+            const tolSet = new Set(input.filter.tolerance_types);
+            filtered = filtered.filter((e) => e.type === 'geometric_tolerance' &&
+                'tolerance_type' in e &&
+                tolSet.has(e.tolerance_type));
+        }
+        if (input.filter?.value_min !== undefined) {
+            filtered = filtered.filter((e) => 'value' in e && e.value !== null && e.value >= input.filter.value_min);
+        }
+        if (input.filter?.value_max !== undefined) {
+            filtered = filtered.filter((e) => 'value' in e && e.value !== null && e.value <= input.filter.value_max);
+        }
+        // Sorting.
+        if (input.sort) {
+            const dir = input.sort.direction === 'desc' ? -1 : 1;
+            filtered.sort((a, b) => {
+                let cmp = 0;
+                switch (input.sort.by) {
+                    case 'type':
+                        cmp = a.type.localeCompare(b.type);
+                        break;
+                    case 'value':
+                        cmp =
+                            ('value' in a ? (a.value ?? 0) : 0) -
+                                ('value' in b ? (b.value ?? 0) : 0);
+                        break;
+                    case 'tolerance_type': {
+                        const aTol = a.type === 'geometric_tolerance' ? a.tolerance_type : '';
+                        const bTol = b.type === 'geometric_tolerance' ? b.tolerance_type : '';
+                        cmp = aTol.localeCompare(bTol);
+                        break;
+                    }
+                }
+                return cmp * dir;
+            });
+        }
+        // Grouping.
+        const resultMode = input.result_mode ?? 'entities';
+        let groups = [];
+        if (resultMode === 'groups') {
+            const groupBy = input.group_by ?? ['type'];
+            const buckets = new Map();
+            for (const entity of filtered) {
+                const key = {};
+                for (const dim of groupBy) {
+                    switch (dim) {
+                        case 'type':
+                            key.type = entity.type;
+                            break;
+                        case 'tolerance_type':
+                            if (entity.type === 'geometric_tolerance') {
+                                key.tolerance_type = entity.tolerance_type;
+                            }
+                            else {
+                                key.tolerance_type = null;
+                            }
+                            break;
+                        case 'dimension_type':
+                            if (entity.type === 'dimension') {
+                                key.dimension_type = entity.dimension_type;
+                            }
+                            else {
+                                key.dimension_type = null;
+                            }
+                            break;
+                        case 'material_condition':
+                            if (entity.type === 'geometric_tolerance') {
+                                key.material_condition = entity.material_condition;
+                            }
+                            else {
+                                key.material_condition = null;
+                            }
+                            break;
+                    }
+                }
+                const mapKey = JSON.stringify(groupBy.map((d) => key[d]));
+                let bucket = buckets.get(mapKey);
+                if (!bucket) {
+                    bucket = { key, members: [] };
+                    buckets.set(mapKey, bucket);
+                }
+                bucket.members.push(entity);
+            }
+            const sampleLimit = DEFAULT_QUERY_LIMITS.sample_entity_limit;
+            let groupIdx = 0;
+            groups = [...buckets.values()].map((bucket) => {
+                const ids = bucket.members.map((m) => m.step_id);
+                const sampled = ids.slice(0, sampleLimit);
+                const isComplete = ids.length <= sampleLimit;
+                return {
+                    id: `group:${groupIdx++}`,
+                    key: bucket.key,
+                    entity_count: bucket.members.length,
+                    entity_ids: ids,
+                    sample_entity_ids: sampled,
+                    sample_entity_limit: sampleLimit,
+                    sample_is_complete: isComplete,
+                    summary: {},
+                };
+            });
+            groups.sort((a, b) => b.entity_count - a.entity_count);
+        }
+        // Pagination.
+        const { limit, offset } = normalizePagination(input.limit, input.offset);
+        const paginated = resultMode === 'entities' ? filtered.slice(offset, offset + limit) : [];
+        const pagination = createPagination(limit, offset, paginated.length, filtered.length);
+        // Statistics.
+        const byType = {};
+        for (const e of full.pmi_entities) {
+            byType[e.type] = (byType[e.type] ?? 0) + 1;
+        }
+        return createQueryResponse(filePath, {
+            filter: input.filter ?? {},
+            group_by: input.group_by ?? null,
+            sort: input.sort ?? null,
+            result_mode: resultMode,
+            limit,
+            offset,
+        }, pagination, paginated, {
+            total_pmi: full.pmi_entities.length,
+            matched_pmi: filtered.length,
+            ...byType,
+        }, groups, full.pmi_entities.length === 0
+            ? [
+                'No PMI entities found. STEP file may be AP203 (no PMI) or may not contain GD&T annotations.',
+            ]
+            : [], []);
+    });
+}
+//# sourceMappingURL=pmi.js.map

package/dist/query/pmi.js.map

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

package/dist/query/shared.d.ts

@@ -0,0 +1,74 @@
+import type { StepQueryResponse, StepQueryPagination, StepQueryUnits, StepQueryCoordinateSystem } from '../tools/step-tools.js';
+/**
+ * Shared query utilities for pagination, filtering, sorting, and response envelopes.
+ */
+export declare const DEFAULT_QUERY_LIMITS: {
+    readonly limit: 100;
+    readonly offset: 0;
+    readonly sample_entity_limit: 5;
+    readonly max_page_size: 1000;
+};
+/**
+ * Hardcoded bucket widths for continuous-value grouping.
+ * Single source of truth; the model does not control these.
+ */
+export declare const GROUP_BUCKETS: {
+    magnitude_bins: number[];
+    radius_step: number;
+    axis_snap_degrees: number;
+};
+/**
+ * Bucket a continuous magnitude (length, area, depth) into a labelled range
+ * using fixed log-scale bins. Returns a stable string key like "10-100".
+ */
+export declare function magnitudeBucketKey(value: number): string;
+/**
+ * Bucket a radius or diameter by rounding to the nearest fixed step.
+ * Returns the rounded numeric value (used directly as the group key).
+ */
+export declare function radiusBucketValue(value: number): number;
+/**
+ * Snap a direction vector to the nearest principal axis (+X..-Z) when within
+ * the axis-snap tolerance; otherwise return "off-axis". Keys are stable strings.
+ */
+export declare function axisDirectionKey(direction: number[]): string;
+/**
+ * A computed group of entities sharing a key across one or more dimensions.
+ */
+export interface ComputedGroup {
+    id: string;
+    key: Record<string, unknown>;
+    entity_count: number;
+    entity_ids: string[];
+    sample_entity_ids: string[];
+    sample_entity_limit: number;
+    sample_is_complete: boolean;
+    summary: Record<string, unknown>;
+}
+/**
+ * Group entities deterministically by a composite key derived from each
+ * requested dimension. Groups are sorted by descending entity count, then by
+ * key for stable ordering. Each group includes bounded sample entity IDs.
+ */
+export declare function groupEntities<T extends {
+    id: string;
+}>(entities: T[], dimensions: string[], keyOf: (entity: T, dimension: string) => unknown, sampleLimit: number, summarize?: (members: T[]) => Record<string, unknown>): ComputedGroup[];
+export declare function normalizePagination(limit: number | undefined, offset: number | undefined): {
+    limit: number;
+    offset: number;
+};
+export declare function createPagination(limit: number, offset: number, returned: number, total_matched: number): StepQueryPagination;
+export declare const STEP_QUERY_UNITS: StepQueryUnits;
+export declare const STEP_QUERY_COORDINATE_SYSTEM: StepQueryCoordinateSystem;
+/**
+ * Build a query response envelope.
+ */
+export declare function createQueryResponse<T extends Record<string, unknown>>(file_path: string, query: Record<string, unknown>, pagination: StepQueryPagination, entities: T[], statistics?: Record<string, unknown>, groups?: ComputedGroup[], warnings?: unknown[], limitations?: unknown[]): StepQueryResponse<T>;
+/**
+ * Sample entity IDs from a larger set, deterministically.
+ */
+export declare function sampleEntityIds(entity_ids: string[], sample_limit: number): {
+    sampled: string[];
+    is_complete: boolean;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/query/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/query/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AAEH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAU3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAqB5D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACpD,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,EAChD,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpD,aAAa,EAAE,CAsCjB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKnC;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,mBAAmB,CAQrB;AAED,eAAO,MAAM,gBAAgB,EAAE,cAK9B,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,yBAI1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,GAAE,aAAa,EAAO,EAC5B,QAAQ,GAAE,OAAO,EAAO,EACxB,WAAW,GAAE,OAAO,EAAO,GAC1B,iBAAiB,CAAC,CAAC,CAAC,CAsBtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAS7C"}