@workingdevshero/olympia-ait-adapter 0.1.0

package/README.md

@@ -0,0 +1,208 @@
+<p align="center">
+  <img src="src/assets/olympia-logo.png" alt="Olympia Fitness & Performance RI" width="400">
+</p>
+
+# olympia-ait-adapter
+
+MCP adapter that converts Olympia Fitness & Performance program XLSX workbooks
+to and from a strict JSON schema. Built for the
+[Automate It](https://automate.it.com) framework so AI agents can author new
+strength-and-conditioning programs from prior client data without ever
+touching XLSX directly.
+
+## Why this exists
+
+Olympia's coaches build client programs in XLSX workbooks — one client per
+file, one sheet per training day, with merged cells, custom borders, an
+embedded logo, and a domain-specific notation (`12E`, `:20E`, `12EL`,
+`x3 Rest :60`, etc.). Asking an LLM to edit XLSX directly is fragile: it
+corrupts merges, loses the logo, and can't reason about the implicit
+6-week / 1A-1B / set-by-set structure encoded in the visual layout.
+
+This package gives the agent a clean structured view of an Olympia program
+and guarantees well-formed output: the LLM reads JSON, reasons about it,
+writes JSON, and the adapter handles all the visual fidelity on the way
+back to XLSX.
+
+## What it does
+
+Two MCP tools, exposed over stdio:
+
+| Tool                     | Direction       | Purpose                                                            |
+| ------------------------ | --------------- | ------------------------------------------------------------------ |
+| `olympia_xlsx_to_json`   | XLSX → JSON     | Parse an Olympia workbook into a typed `Program` document.         |
+| `olympia_json_to_xlsx`   | JSON → XLSX     | Render a `Program` document back to a styled .xlsx on disk.        |
+
+The JSON schema is defined once in `src/schema/program.ts` using Zod and
+surfaces as:
+
+1. The TypeScript type used internally
+2. The runtime validator at each tool boundary
+3. The JSON Schema published as each tool's `inputSchema` so the LLM sees
+   the full typed contract at discovery time
+
+## JSON shape
+
+```ts
+type Program = {
+  client: string;                  // "Bobby Galli"
+  programDate: string;             // "4.26"
+  weekDates?: (string | null)[];   // optional, length 6
+  days: Day[];
+};
+
+type Day = {
+  name: string;                    // "Day 1"
+  sections: Section[];
+  supplementalNotes?: SupplementalNote[];
+};
+
+type Section = {
+  kind: "warmup" | "main" | "sportSpecific" | "supplemental" | "conditioning";
+  exercises: Exercise[];
+};
+
+type Exercise = {
+  name: string;                    // "2DB Alternating Bench Press"
+  groupLabel?: string;             // "1A", "1B", "2A"…  matches /^\d+[A-Z]$/
+  notes?: string;
+  sets: (string | null)[][];       // [setIdx][weekIdx]; inner length 6
+};
+
+type SupplementalNote = {
+  row: number;                     // offset from "Sport Specific/" label row
+  col: string;                     // "C" | "D" | … | "P"
+  value: string;
+};
+```
+
+### Prescription cell grammar
+
+Olympia does **not** prescribe weights. Each `sets[setIdx][weekIdx]` is a
+single opaque string encoding **reps**, **time**, or **breaths**:
+
+| Format                | Meaning                              |
+| --------------------- | ------------------------------------ |
+| `"12"` / `"10E"`      | reps (`E` = each side)               |
+| `":20"` / `":20E"`    | seconds (`E` = each side)            |
+| `"5 breaths"`         | breath count                         |
+| `"12EL"` / `"10ER"`   | reps each side, left or right lead   |
+| free-form strings     | circuit-style instructions, OK too   |
+| `null`                | empty cell                           |
+
+The schema enforces shape (6 weeks per set, group label regex, allowed
+section kinds) but does **not** validate the grammar of each prescription
+string — Olympia's own files include free-form entries in some spots.
+
+### Supplemental area
+
+The bottom of every day sheet is a trainer-managed "Sport Specific /
+Supplemental" area where coaches write athlete-specific instructions that
+don't fit the structured exercise table (conditioning circuits, sport
+drills, recovery work). The adapter:
+
+- **Reads** that area as a sparse list of `{ row, col, value }` entries
+  (master cells only) so the signal is preserved for downstream agents.
+- **Writes** the fixed 10-row template (with "Sport Specific/" and
+  "Supplemental" labels) at the bottom of every day, then layers any
+  supplied `supplementalNotes` on top.
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+The built CLI lives at `dist/server.js`; the `bin` entry registers it as
+`olympia-ait-adapter`.
+
+## Running the MCP server
+
+```bash
+# Dev (TypeScript via tsx)
+npm run dev
+
+# Built (after `npm run build`)
+npm start
+# or
+npx olympia-ait-adapter
+```
+
+The server speaks the Model Context Protocol over stdio. To wire it into
+Claude or another MCP client, add an entry like:
+
+```json
+{
+  "mcpServers": {
+    "olympia-ait-adapter": {
+      "command": "npx",
+      "args": ["olympia-ait-adapter"]
+    }
+  }
+}
+```
+
+Both tools take absolute paths to .xlsx files on the local filesystem.
+
+## Repo layout
+
+```
+src/
+  schema/program.ts          # Zod schema — single source of truth
+  reader/
+    parse-workbook.ts        # Workbook → Program JSON
+    parse-day-sheet.ts       # One sheet, section detection, supplemental capture
+  writer/
+    build-workbook.ts        # Program → ExcelJS workbook
+    layout.ts                # Column widths, row positions, logo anchor
+    styles.ts                # All borders/fonts/fills as constants
+    stamp-exercise.ts        # One exercise block (variable sets, group borders)
+    supplemental-template.ts # Fixed bottom template + supplementalNotes overlay
+  tools/
+    xlsx-to-json.ts          # MCP handler
+    json-to-xlsx.ts          # MCP handler
+  server.ts                  # Bootstrap, registers both tools
+  assets/
+    olympia-logo.png         # Extracted from sample workbooks; embedded in output
+
+samples/                     # Real Olympia .xlsx files used as round-trip fixtures
+scripts/                     # Inspection helpers used during development
+tests/                       # vitest — schema, reader, round-trip, MCP smoke
+```
+
+## Tests
+
+```bash
+npm test                     # one-shot
+npm run test:watch           # vitest watch mode
+npm run typecheck            # tsc --noEmit
+```
+
+Coverage:
+
+- **`schema.test.ts`** — Zod rejects malformed input (week count, group
+  label regex, section kinds, missing fields).
+- **`reader.test.ts`** — All three sample workbooks parse into
+  schema-valid `Program` documents; spot checks on Bobby's first exercise,
+  Giulianna's variable set counts, exercise notes, supplemental notes.
+- **`round-trip.test.ts`** — The primary determinism guarantee: for each
+  sample, `parse → write → parse` produces JSON equal to the original.
+- **`mcp-smoke.test.ts`** — End-to-end MCP server check via the in-memory
+  transport: tool discovery, round-trip via `client.callTool`, schema
+  rejection of malformed input at the SDK boundary.
+
+## Determinism
+
+The writer is fully programmatic — no template `.xlsx` file. Every byte of
+the output is determined by code plus the input JSON, so the same JSON
+produces the same workbook. The Olympia logo is the only binary asset
+(`src/assets/olympia-logo.png`).
+
+This trade-off is intentional: templates introduce hidden state that
+ExcelJS occasionally drops (drawings, theme colors), whereas pure code →
+output gives byte-stable, snapshot-testable results.
+
+## License
+
+Internal — Automate It / Olympia Fitness & Performance RI.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Program, Day, Section, SectionKind, Exercise, SetRow, Cell, SupplementalNote, XlsxToJsonInput, XlsxToJsonOutput, JsonToXlsxInput, JsonToXlsxOutput, } from "./schema/program.js";
+export { createServer } from "./server.js";
+export { parseWorkbook } from "./reader/parse-workbook.js";
+export { buildWorkbook } from "./writer/build-workbook.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,OAAO,EACP,GAAG,EACH,OAAO,EACP,WAAW,EACX,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Programmatic entry point. The package's primary use is the MCP CLI
+// (registered under the `bin` field), but the schema and server factory
+// are also exported for callers that want to embed or compose the adapter.
+export { Program, Day, Section, SectionKind, Exercise, SetRow, Cell, SupplementalNote, XlsxToJsonInput, XlsxToJsonOutput, JsonToXlsxInput, JsonToXlsxOutput, } from "./schema/program.js";
+export { createServer } from "./server.js";
+export { parseWorkbook } from "./reader/parse-workbook.js";
+export { buildWorkbook } from "./writer/build-workbook.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wEAAwE;AACxE,2EAA2E;AAE3E,OAAO,EACL,OAAO,EACP,GAAG,EACH,OAAO,EACP,WAAW,EACX,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/reader/parse-day-sheet.d.ts

@@ -0,0 +1,10 @@
+import ExcelJS from "exceljs";
+import type { SupplementalNote, Day } from "../schema/program.js";
+export interface ParsedDay {
+    sections: Day["sections"];
+    weekDates?: (string | null)[];
+    supplementalNotes?: SupplementalNote[];
+    warnings: string[];
+}
+export declare function parseDaySheet(ws: ExcelJS.Worksheet): ParsedDay;
+//# sourceMappingURL=parse-day-sheet.d.ts.map

package/dist/reader/parse-day-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-day-sheet.d.ts","sourceRoot":"","sources":["../../src/reader/parse-day-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EACV,gBAAgB,EAEhB,GAAG,EAIJ,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAmFD,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAsG9D"}

package/dist/reader/parse-day-sheet.js

@@ -0,0 +1,199 @@
+const FIRST_BODY_ROW = 7;
+const WEEK_COLS = ["D", "F", "H", "J", "L", "N"];
+const SECTION_LABELS = new Map([
+    ["warmup", "warmup"],
+    ["sport specific", "sportSpecific"],
+    ["sport specific/", "sportSpecific"],
+    ["supplemental", "supplemental"],
+    ["conditioning", "conditioning"],
+]);
+const SUPPLEMENTAL_TRIGGER_LABELS = new Set([
+    "sport specific",
+    "sport specific/",
+    "supplemental",
+    "conditioning",
+    "circuit",
+]);
+// Columns scanned for supplementalNotes. Excludes A/B (cosmetic narrow margins)
+// and Q (rarely used).
+const SUPPLEMENTAL_COLS = ["C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P"];
+function isGroupLabel(s) {
+    return /^\d+[A-Z]$/.test(s);
+}
+function cellText(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "object") {
+        if ("richText" in value && Array.isArray(value.richText)) {
+            return value.richText
+                .map((r) => r.text)
+                .join("");
+        }
+        if ("text" in value && typeof value.text === "string") {
+            return value.text;
+        }
+        if ("result" in value) {
+            return cellText(value.result);
+        }
+    }
+    return "";
+}
+function cellOrNull(value) {
+    const t = cellText(value).trim();
+    return t === "" ? null : t;
+}
+function isMergeContinuation(cell) {
+    if (!cell.isMerged)
+        return false;
+    const master = cell.master;
+    return master !== undefined && master.address !== cell.address;
+}
+function readWeekRow(row) {
+    return WEEK_COLS.map((col) => cellOrNull(row.getCell(col).value));
+}
+function readWeekDates(row) {
+    return WEEK_COLS.map((col) => {
+        const t = cellText(row.getCell(col).value).trim();
+        if (t === "" || t.toLowerCase() === "date:")
+            return null;
+        return t;
+    });
+}
+export function parseDaySheet(ws) {
+    const warnings = [];
+    const sections = [];
+    let current = { kind: "main", exercises: [] };
+    let exercise = null;
+    let weekDates;
+    const dateRow = ws.getRow(2);
+    if (dateRow) {
+        const dates = readWeekDates(dateRow);
+        if (dates.some((d) => d !== null))
+            weekDates = dates;
+    }
+    const flushExercise = (groupLabel) => {
+        if (!exercise)
+            return;
+        const ex = {
+            name: exercise.name.trim(),
+            sets: exercise.sets,
+        };
+        if (groupLabel)
+            ex.groupLabel = groupLabel;
+        if (exercise.notes)
+            ex.notes = exercise.notes;
+        current.exercises.push(ex);
+        exercise = null;
+    };
+    const flushSection = () => {
+        flushExercise();
+        sections.push({ kind: current.kind, exercises: current.exercises });
+    };
+    const lastRow = ws.actualRowCount > 0 ? ws.rowCount : 0;
+    let supplementalStartRow;
+    let supplementalNotes;
+    for (let r = FIRST_BODY_ROW; r <= lastRow; r++) {
+        const row = ws.getRow(r);
+        const cCell = row.getCell("C");
+        const cText = cellText(cCell.value).trim();
+        const cLower = cText.toLowerCase();
+        // Trigger label → switch from exercise parsing to supplemental capture.
+        if (SUPPLEMENTAL_TRIGGER_LABELS.has(cLower)) {
+            flushSection();
+            supplementalStartRow = r;
+            supplementalNotes = captureSupplementalNotes(ws, r, lastRow);
+            break;
+        }
+        // Group label terminates an exercise block.
+        if (cText !== "" && isGroupLabel(cText) && !isMergeContinuation(cCell)) {
+            if (!exercise) {
+                warnings.push(`row ${r}: group label "${cText}" without a preceding exercise name`);
+                continue;
+            }
+            exercise.sets.push(readWeekRow(row));
+            const pNote = cellText(row.getCell("P").value).trim();
+            if (pNote && !exercise.notes)
+                exercise.notes = pNote;
+            flushExercise(cText);
+            continue;
+        }
+        // Continuation of a merged exercise name?
+        if (isMergeContinuation(cCell) && exercise) {
+            exercise.sets.push(readWeekRow(row));
+            const pNote = cellText(row.getCell("P").value).trim();
+            if (pNote && !exercise.notes)
+                exercise.notes = pNote;
+            continue;
+        }
+        // New exercise block: non-empty C, not a section/group label, master cell.
+        if (cText !== "") {
+            flushExercise();
+            exercise = {
+                name: cText,
+                sets: [readWeekRow(row)],
+            };
+            const pNote = cellText(row.getCell("P").value).trim();
+            if (pNote)
+                exercise.notes = pNote;
+            continue;
+        }
+    }
+    if (supplementalStartRow === undefined) {
+        flushSection();
+    }
+    const nonEmpty = sections.filter((s) => s.exercises.length > 0);
+    if (nonEmpty.length === 0) {
+        nonEmpty.push({ kind: "main", exercises: [] });
+    }
+    return {
+        sections: nonEmpty,
+        ...(weekDates ? { weekDates } : {}),
+        ...(supplementalNotes && supplementalNotes.length > 0
+            ? { supplementalNotes }
+            : {}),
+        warnings,
+    };
+}
+/**
+ * Capture freeform cells in the supplemental area of a day sheet — the
+ * trainer-managed Sport Specific / Supplemental block below the main
+ * programming. Returns an array of `{ row, col, value }` entries where `row`
+ * is the offset from `supplementalStartRow` (so row 0 = the row containing
+ * the first trigger label).
+ *
+ * Only MASTER cells of merge ranges are captured (so a value that spans
+ * multiple cells appears once). The trigger labels themselves are skipped
+ * since they're added back by the writer's fixed template.
+ */
+function captureSupplementalNotes(ws, supplementalStartRow, lastRow) {
+    const out = [];
+    for (let r = supplementalStartRow; r <= lastRow; r++) {
+        const row = ws.getRow(r);
+        for (const col of SUPPLEMENTAL_COLS) {
+            const cell = row.getCell(col);
+            if (isMergeContinuation(cell))
+                continue;
+            const value = cellText(cell.value).trim();
+            if (value === "")
+                continue;
+            // Skip the static template labels — the writer adds them back.
+            if (col === "C" &&
+                SUPPLEMENTAL_TRIGGER_LABELS.has(value.toLowerCase())) {
+                continue;
+            }
+            out.push({
+                row: r - supplementalStartRow,
+                col,
+                value,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=parse-day-sheet.js.map

package/dist/reader/parse-day-sheet.js.map

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

package/dist/reader/parse-workbook.d.ts

@@ -0,0 +1,3 @@
+import type { XlsxToJsonOutput } from "../schema/program.js";
+export declare function parseWorkbook(xlsxPath: string): Promise<XlsxToJsonOutput>;
+//# sourceMappingURL=parse-workbook.d.ts.map

package/dist/reader/parse-workbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-workbook.d.ts","sourceRoot":"","sources":["../../src/reader/parse-workbook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAyD3B"}

package/dist/reader/parse-workbook.js

@@ -0,0 +1,55 @@
+import ExcelJS from "exceljs";
+import { parseDaySheet } from "./parse-day-sheet.js";
+export async function parseWorkbook(xlsxPath) {
+    const workbook = new ExcelJS.Workbook();
+    await workbook.xlsx.readFile(xlsxPath);
+    const warnings = [];
+    const days = [];
+    let weekDates;
+    for (const ws of workbook.worksheets) {
+        const parsed = parseDaySheet(ws);
+        parsed.warnings.forEach((w) => warnings.push(`[${ws.name}] ${w}`));
+        if (weekDates === undefined && parsed.weekDates !== undefined) {
+            weekDates = parsed.weekDates;
+        }
+        days.push({
+            name: ws.name,
+            sections: parsed.sections,
+            ...(parsed.supplementalNotes
+                ? { supplementalNotes: parsed.supplementalNotes }
+                : {}),
+        });
+    }
+    // Prefer workbook custom properties (set by our own writer); fall back to
+    // filename parsing for source files coming straight from Olympia.
+    let clientName;
+    let programDate;
+    const subject = typeof workbook.subject === "string" ? workbook.subject.trim() : "";
+    const keywords = typeof workbook.keywords === "string" ? workbook.keywords.trim() : "";
+    if (subject && keywords) {
+        clientName = subject;
+        programDate = keywords;
+    }
+    else {
+        const match = xlsxPath.match(/([^/\\]+?)\s+Programs?\s+([\d.]+)\.xlsx$/i);
+        if (match && match[1] !== undefined && match[2] !== undefined) {
+            clientName = match[1];
+            programDate = match[2];
+        }
+        else {
+            clientName = "Unknown";
+            programDate = "";
+            warnings.push(`Could not derive client name or program date from filename or workbook properties: ${xlsxPath}`);
+        }
+    }
+    return {
+        program: {
+            client: clientName,
+            programDate,
+            ...(weekDates ? { weekDates } : {}),
+            days,
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=parse-workbook.js.map

package/dist/reader/parse-workbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-workbook.js","sourceRoot":"","sources":["../../src/reader/parse-workbook.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAwC,EAAE,CAAC;IACrD,IAAI,SAAwC,CAAC;IAE7C,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9D,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,iBAAiB;gBAC1B,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,kEAAkE;IAClE,IAAI,UAA8B,CAAC;IACnC,IAAI,WAA+B,CAAC;IACpC,MAAM,OAAO,GACX,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GACZ,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,UAAU,GAAG,OAAO,CAAC;QACrB,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC1E,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAC9D,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,SAAS,CAAC;YACvB,WAAW,GAAG,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CACX,sFAAsF,QAAQ,EAAE,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,UAAU;YAClB,WAAW;YACX,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,IAAI;SACL;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}