@antelopejs/dms-ai 0.8.0 → 0.9.1

package/sidecar/dist/mcp/tools/builder-queries.d.ts

@@ -1,9 +1,38 @@
 import { z } from "zod";
 import { type BuilderRun } from "./builder-expr.js";
+export declare const QUERY_ARGS: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const QUERY_FIELDS: {
+    name: z.ZodString;
+    resource: z.ZodString;
+    template: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    response: z.ZodOptional<z.ZodEnum<{
+        value: "value";
+        items: "items";
+        series: "series";
+        card: "card";
+    }>>;
+    compare: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+};
 export declare function buildQueryTools(run: BuilderRun): (import("../define-tool.js").McpToolDefinition<{
     resourceType: z.ZodOptional<z.ZodString>;
 }> | import("../define-tool.js").McpToolDefinition<{
+    name: z.ZodString;
+    resource: z.ZodString;
+    template: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    response: z.ZodOptional<z.ZodEnum<{
+        value: "value";
+        items: "items";
+        series: "series";
+        card: "card";
+    }>>;
+    compare: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
     page: z.ZodString;
+}> | import("../define-tool.js").McpToolDefinition<{
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     name: z.ZodString;
     resource: z.ZodString;
     template: z.ZodString;
@@ -14,6 +43,7 @@ export declare function buildQueryTools(run: BuilderRun): (import("../define-too
         series: "series";
         card: "card";
     }>>;
+    compare: z.ZodOptional<z.ZodBoolean>;
     endpoint: z.ZodOptional<z.ZodString>;
 }> | import("../define-tool.js").McpToolDefinition<{
     query: z.ZodString;
@@ -27,6 +57,7 @@ export declare function buildQueryTools(run: BuilderRun): (import("../define-too
             series: "series";
             card: "card";
         }>>;
+        compare: z.ZodOptional<z.ZodBoolean>;
         endpoint: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }> | import("../define-tool.js").McpToolDefinition<{

package/sidecar/dist/mcp/tools/builder-queries.js

@@ -13,6 +13,25 @@ const QUERY_PARAMS = z
 const QUERY_RESPONSE = z
     .enum(["series", "card", "value", "items"])
     .describe("How the route arranges a `series` template's points for the block that reads them: `series` (the default) one point per group, for a bare chart such as ChartLine, ChartColumn or ChartBar; `card` a figure above its series, for a ChartCard; `value` a figure and its sparkline, for a KpiCard; `items` ranked entries, for a TopListCard. A block reads only its own arrangement, so match the block. A `count` or `aggregate` query answers `{ value }` whatever you pass.");
+const QUERY_COMPARE = z
+    .boolean()
+    .describe("Also answer the preceding period so a card shows a delta. Only meaningful when the query binds its period with `$param` `from` and `to`.");
+export const QUERY_ARGS = z
+    .record(z.string(), z.unknown())
+    .describe('The values the route would receive, by the name it exposes them under, e.g. `{ "from": "2026-01-01", "to": "2026-03-31" }` for a query binding `$param` `from` and `to`. With `compare`, also `compareFrom` and `compareTo`.');
+export const QUERY_FIELDS = {
+    name: z
+        .string()
+        .describe("camelCase identifier, unique among the page's members. Names the route; the model method it compiles into may differ, since queries wanting the identical chain share one."),
+    resource: z
+        .string()
+        .describe("Resource ref to read, from BuilderListResources."),
+    template: z.string().describe("A template id from BuilderQueryTemplates."),
+    params: QUERY_PARAMS.optional(),
+    response: QUERY_RESPONSE.optional(),
+    compare: QUERY_COMPARE.optional(),
+    endpoint: QUERY_ENDPOINT.optional(),
+};
 export function buildQueryTools(run) {
     return [
         defineTool("BuilderQueryTemplates", note("Lists the query templates BuilderAddQuery can compile, each with its id, what it computes, its `output` kind, and the JSON Schema for its `params`. Call this before adding a query — the schema is the reference for every parameter and value shape."), {
@@ -21,23 +40,20 @@ export function buildQueryTools(run) {
                 .optional()
                 .describe("Filter to templates for one resource type (v1 has only `database-table`). Omit for all."),
         }, ({ resourceType }) => run("ListQueryTemplates", resourceType ? [resourceType] : [])),
-        defineTool("BuilderAddQuery", note("Adds a query — a page-hosted GET route serving a computed number, or one per group, that the DataAPI cannot give you. Compiles the template into a method on the resource's model and a route on the page, atomically. Returns `{ query, route }`; `route` is the full URL to pass as the reading block's `fetchUrl`. A `count` or `aggregate` route serves `{ \"value\": <number> }`; a `series` route serves the arrangement `response` names."), {
+        defineTool("BuilderAddQuery", note("Adds a query — a page-hosted GET route serving a computed number, or one per group, that the DataAPI cannot give you. Compiles the template into a method on the resource's model and a route on the page, atomically. Returns `{ query, route }`; `route` is the full URL to pass as the reading block's `fetchUrl`. A `count` or `aggregate` route serves `{ \"value\": <number> }`; a `series` route serves the arrangement `response` names. Add `compare: true` to a query that binds its period with `$param` `from` and `to` so a card shows a delta. Run BuilderPreviewQuery first to see what the route would answer."), {
             page: z
                 .string()
                 .describe("PageRef the query is served from — the page that displays it, not the resource's page."),
-            name: z
-                .string()
-                .describe("camelCase identifier, unique among the page's members. Names the route; the model method it compiles into may differ, since queries wanting the identical chain share one."),
-            resource: z
-                .string()
-                .describe("Resource ref to read, from BuilderListResources."),
-            template: z
-                .string()
-                .describe("A template id from BuilderQueryTemplates."),
-            params: QUERY_PARAMS.optional(),
-            response: QUERY_RESPONSE.optional(),
-            endpoint: QUERY_ENDPOINT.optional(),
+            ...QUERY_FIELDS,
         }, async ({ page, ...input }) => hasExprSentinel(input) ? exprRefusal() : run("AddQuery", [page, input])),
+        defineTool("BuilderPreviewQuery", note("Runs a query that is not saved and answers what its route would, as `{ body, truncated }`, writing nothing. Takes BuilderAddQuery's query fields (no page) and `args`. An empty `series` or `items` in `body` means the block reading it renders empty: fix the query before wiring its route."), {
+            ...QUERY_FIELDS,
+            args: QUERY_ARGS.optional(),
+        }, async ({ args, ...query }) => hasExprSentinel({ query, args })
+            ? exprRefusal()
+            : run("PreviewQuery", [
+                args === undefined ? { query } : { query, args },
+            ])),
         defineTool("BuilderConfigureQuery", note("Recompiles a query, replacing both its route and its chain. Only the keys you pass change; the rest are re-read from the query. A query BuilderPageStructure reports as `opaque` is refused with opaque_target, leaving the hand-edit intact. Renaming is not supported — remove and re-add. Never affects another page's query, even one sharing the same model method."), {
             query: QUERY_REF,
             patch: z.object({
@@ -45,6 +61,7 @@ export function buildQueryTools(run) {
                 template: z.string().optional(),
                 params: QUERY_PARAMS.optional(),
                 response: QUERY_RESPONSE.optional(),
+                compare: QUERY_COMPARE.optional(),
                 endpoint: QUERY_ENDPOINT.optional(),
             }),
         }, async ({ query, patch }) => hasExprSentinel(patch)

package/sidecar/dist/mcp/tools/builder-queries.js.map

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

package/sidecar/dist/mcp/tools/builder-table-view-schema.d.ts

@@ -0,0 +1,99 @@
+import { z } from "zod";
+export declare const TABLE_VIEW_SETTINGS: {
+    kanban: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        groupBy: z.ZodString;
+        draggable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    grouped: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        groupBy: z.ZodString;
+        by: z.ZodOptional<z.ZodEnum<{
+            value: "value";
+            day: "day";
+            week: "week";
+        }>>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        count: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    cards: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    defaultDisplay: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        table: "table";
+        kanban: "kanban";
+        cards: "cards";
+        grouped: "grouped";
+    }>>>;
+    views: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            count: z.ZodOptional<z.ZodBoolean>;
+            filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                column: z.ZodString;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    is: "is";
+                    is_not: "is_not";
+                    include: "include";
+                    exclude: "exclude";
+                    contains: "contains";
+                    not_contains: "not_contains";
+                    greater_than: "greater_than";
+                    less_than: "less_than";
+                    greater_than_or_equal_to: "greater_than_or_equal_to";
+                    less_than_or_equal_to: "less_than_or_equal_to";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                }>>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>>;
+            search: z.ZodOptional<z.ZodString>;
+            sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                column: z.ZodString;
+                desc: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            columns: z.ZodOptional<z.ZodObject<{
+                visible: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                hidden: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            display: z.ZodOptional<z.ZodEnum<{
+                table: "table";
+                kanban: "kanban";
+                cards: "cards";
+                grouped: "grouped";
+            }>>;
+            density: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                compact: "compact";
+            }>>;
+        }, z.core.$strip>>;
+        layout: z.ZodOptional<z.ZodEnum<{
+            tabs: "tabs";
+            strip: "strip";
+            menu: "menu";
+        }>>;
+        defaultView: z.ZodOptional<z.ZodString>;
+        userViews: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    footer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            op: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            where: z.ZodOptional<z.ZodObject<{
+                column: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notIn: "notIn";
+                }>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+};

package/sidecar/dist/mcp/tools/builder-table-view-schema.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+const COLUMN = z
+    .string()
+    .describe("A column name as BuilderResourceStructure lists it.");
+const DISPLAY = z.enum(["table", "kanban", "cards", "grouped"]);
+const KANBAN = z.object({
+    groupBy: COLUMN.describe("A single-choice column: a select that is not multiple, a boolean or a status."),
+    draggable: z.boolean().optional(),
+});
+const GROUPED = z.object({
+    groupBy: COLUMN.describe("A sortable column; `day` and `week` need a date column."),
+    by: z.enum(["value", "day", "week"]).optional(),
+    collapsible: z.boolean().optional(),
+    count: z.boolean().optional().describe("Needs a filterable groupBy column."),
+});
+const CARDS = z.object({
+    fields: z
+        .array(COLUMN)
+        .optional()
+        .describe("Listable columns shown under the card's title; the first few by default."),
+});
+const VIEW_FILTER = z.object({
+    column: COLUMN.describe("A filterable column."),
+    mode: z
+        .enum([
+        "is",
+        "is_not",
+        "include",
+        "exclude",
+        "contains",
+        "not_contains",
+        "greater_than",
+        "less_than",
+        "greater_than_or_equal_to",
+        "less_than_or_equal_to",
+        "is_empty",
+        "is_not_empty",
+    ])
+        .optional()
+        .describe("`is` by default."),
+    value: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("A list is joined with commas. Tokens: `{{user.id}}`, `{{now}}`, `{{now-7d}}`, `{{now+14d}}`."),
+});
+const VIEW = z.object({
+    id: z.string().describe("Lower-case words joined by dashes: `late-orders`."),
+    label: z.string(),
+    icon: z.string().optional(),
+    count: z.boolean().optional().describe("Shows how many rows the view lists."),
+    filters: z.array(VIEW_FILTER).optional(),
+    search: z.string().optional(),
+    sort: z
+        .array(z.object({
+        column: COLUMN.describe("A sortable column."),
+        desc: z.boolean().optional(),
+    }))
+        .optional(),
+    columns: z
+        .object({
+        visible: z.array(COLUMN).optional(),
+        hidden: z.array(COLUMN).optional(),
+        order: z.array(COLUMN).optional(),
+    })
+        .optional(),
+    display: DISPLAY.optional().describe("One of the displays the table offers."),
+    density: z.enum(["default", "compact"]).optional(),
+});
+const VIEWS = z.object({
+    items: z.array(VIEW),
+    layout: z.enum(["tabs", "strip", "menu"]).optional(),
+    defaultView: z
+        .string()
+        .optional()
+        .describe("The id of the view opened on arrival."),
+    userViews: z.boolean().optional(),
+});
+const FOOTER_SUMMARY = z.object({
+    label: z.string().describe("Shown before the figure: `Revenue`."),
+    op: z.enum(["sum", "count"]),
+    field: COLUMN.optional().describe("The number or price column a `sum` adds up."),
+    where: z
+        .object({
+        column: COLUMN,
+        op: z.enum(["equals", "notEquals", "in", "notIn"]),
+        value: z.union([
+            z.string(),
+            z.number(),
+            z.boolean(),
+            z.array(z.union([z.string(), z.number(), z.boolean()])),
+        ]),
+    })
+        .optional()
+        .describe("Only the rows where the column compares to the value are summed or counted."),
+});
+export const TABLE_VIEW_SETTINGS = {
+    kanban: KANBAN.nullable()
+        .optional()
+        .describe("A board, one column per value; `null` removes it."),
+    grouped: GROUPED.nullable()
+        .optional()
+        .describe("Rows under group headers; `null` removes it."),
+    cards: CARDS.nullable()
+        .optional()
+        .describe("A card per row; `null` stops offering it."),
+    defaultDisplay: DISPLAY.nullable()
+        .optional()
+        .describe("The display shown first, one the table offers; `null` goes back to the first offered."),
+    views: VIEWS.nullable()
+        .optional()
+        .describe("Named views of the table; `null` removes them."),
+    footer: z
+        .object({ summary: z.array(FOOTER_SUMMARY).optional() })
+        .nullable()
+        .optional()
+        .describe("Footer figures; an empty `summary` removes them, `null` removes the footer."),
+};
+//# sourceMappingURL=builder-table-view-schema.js.map

package/sidecar/dist/mcp/tools/builder-table-view-schema.js.map

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

package/sidecar/dist/mcp/tools/builder-table-view.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { type BuilderRun } from "./builder-expr.js";
+export declare function buildTableViewTools(run: BuilderRun): import("../define-tool.js").McpToolDefinition<{
+    kanban: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        groupBy: z.ZodString;
+        draggable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    grouped: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        groupBy: z.ZodString;
+        by: z.ZodOptional<z.ZodEnum<{
+            value: "value";
+            day: "day";
+            week: "week";
+        }>>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        count: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    cards: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    defaultDisplay: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        table: "table";
+        kanban: "kanban";
+        cards: "cards";
+        grouped: "grouped";
+    }>>>;
+    views: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            icon: z.ZodOptional<z.ZodString>;
+            count: z.ZodOptional<z.ZodBoolean>;
+            filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                column: z.ZodString;
+                mode: z.ZodOptional<z.ZodEnum<{
+                    is: "is";
+                    is_not: "is_not";
+                    include: "include";
+                    exclude: "exclude";
+                    contains: "contains";
+                    not_contains: "not_contains";
+                    greater_than: "greater_than";
+                    less_than: "less_than";
+                    greater_than_or_equal_to: "greater_than_or_equal_to";
+                    less_than_or_equal_to: "less_than_or_equal_to";
+                    is_empty: "is_empty";
+                    is_not_empty: "is_not_empty";
+                }>>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+            }, z.core.$strip>>>;
+            search: z.ZodOptional<z.ZodString>;
+            sort: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                column: z.ZodString;
+                desc: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>>;
+            columns: z.ZodOptional<z.ZodObject<{
+                visible: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                hidden: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            display: z.ZodOptional<z.ZodEnum<{
+                table: "table";
+                kanban: "kanban";
+                cards: "cards";
+                grouped: "grouped";
+            }>>;
+            density: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                compact: "compact";
+            }>>;
+        }, z.core.$strip>>;
+        layout: z.ZodOptional<z.ZodEnum<{
+            tabs: "tabs";
+            strip: "strip";
+            menu: "menu";
+        }>>;
+        defaultView: z.ZodOptional<z.ZodString>;
+        userViews: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    footer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            op: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+            }>;
+            field: z.ZodOptional<z.ZodString>;
+            where: z.ZodOptional<z.ZodObject<{
+                column: z.ZodString;
+                op: z.ZodEnum<{
+                    in: "in";
+                    equals: "equals";
+                    notEquals: "notEquals";
+                    notIn: "notIn";
+                }>;
+                value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    pageRef: z.ZodString;
+    block: z.ZodOptional<z.ZodString>;
+}>[];

package/sidecar/dist/mcp/tools/builder-table-view.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { defineTool } from "../define-tool.js";
+import { TABLE_VIEW_SETTINGS } from "./builder-table-view-schema.js";
+import { exprRefusal, hasExprSentinel, note, } from "./builder-expr.js";
+const DESCRIPTION = "Sets displays, named views and footer figures on a table page's TableView, checking every choice against the columns of the table first: a kanban needs a single-choice column, a sum a number or price column, a view's filters filterable columns and its sort sortable ones, the default display one the table offers. A key left out stays as the page has it; `null` removes it. A footer figure also mounts the controller's summary route. Nothing is written when a choice is refused or the page would not typecheck. Read the column names and types with BuilderResourceStructure first. For the page's title, icon, description and order use BuilderConfigurePage.";
+export function buildTableViewTools(run) {
+    return [
+        defineTool("BuilderConfigureTableView", note(DESCRIPTION), {
+            pageRef: z.string(),
+            block: z
+                .string()
+                .optional()
+                .describe("The TableView block's name; only needed when the page holds several."),
+            ...TABLE_VIEW_SETTINGS,
+        }, async ({ pageRef, block, ...settings }) => hasExprSentinel(settings)
+            ? exprRefusal()
+            : run("ConfigureTableView", [
+                pageRef,
+                Object.fromEntries(Object.entries(settings).filter(([, value]) => value !== undefined)),
+                ...(block === undefined ? [] : [{ block }]),
+            ])),
+    ];
+}
+//# sourceMappingURL=builder-table-view.js.map

package/sidecar/dist/mcp/tools/builder-table-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-table-view.js","sourceRoot":"","sources":["../../../src/mcp/tools/builder-table-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAEL,WAAW,EACX,eAAe,EACf,IAAI,GACL,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,GACf,ipBAAipB,CAAC;AAEppB,MAAM,UAAU,mBAAmB,CAAC,GAAe;IACjD,OAAO;QACL,UAAU,CACR,2BAA2B,EAC3B,IAAI,CAAC,WAAW,CAAC,EACjB;YACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,sEAAsE,CACvE;YACH,GAAG,mBAAmB;SACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,CACxC,eAAe,CAAC,QAAQ,CAAC;YACvB,CAAC,CAAC,WAAW,EAAE;YACf,CAAC,CAAC,GAAG,CAAC,oBAAoB,EAAE;gBACxB,OAAO;gBACP,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CACnC,CACF;gBACD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;aAC5C,CAAC,CACT;KACF,CAAC;AACJ,CAAC"}