@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.59z.118

package/dist/office/excel.d.ts

@@ -0,0 +1,110 @@
+/**
+ * F106 office.excel verbs -- cross-platform Excel read/write.
+ *
+ * Uses the `xlsx` package (already in deps for the F45 spreadsheet
+ * intake path). No Windows COM dependency; works the same on
+ * Windows / macOS / Linux.
+ *
+ * Read: parses an .xlsx / .xls / .csv file into a list of rows.
+ * Write: builds a fresh workbook from rows. Refuses to mutate an
+ * existing file unless `overwrite: true` is passed.
+ *
+ * ASCII-only.
+ */
+export interface ExcelReadRequest {
+    /** Absolute or project-relative path. */
+    path: string;
+    /** Sheet name. Default: first sheet. */
+    sheet?: string;
+    /** Cell range e.g. "A1:C20". Default: full used range. */
+    range?: string;
+    /** Treat the first row as header (object output). Default true. */
+    header_row?: boolean;
+}
+export interface ExcelReadOk {
+    ok: true;
+    sheet: string;
+    /** Array of objects (header_row=true) or array-of-arrays. */
+    rows: Array<Record<string, unknown> | unknown[]>;
+    row_count: number;
+    sheet_names: string[];
+}
+export interface ExcelReadErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export type ExcelReadResult = ExcelReadOk | ExcelReadErr;
+export interface ExcelWriteRequest {
+    /** Absolute or project-relative path. Extension drives format. */
+    path: string;
+    /** Sheet name. Default: "Sheet1". */
+    sheet?: string;
+    /** Array of objects -- keys become column headers; or array of
+     *  arrays for raw cell layout. */
+    rows: Array<Record<string, unknown>> | unknown[][];
+    /** Refuse to overwrite if file exists. Default false. */
+    overwrite?: boolean;
+}
+export interface ExcelWriteOk {
+    ok: true;
+    path: string;
+    bytes_written: number;
+    row_count: number;
+}
+export interface ExcelWriteErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export type ExcelWriteResult = ExcelWriteOk | ExcelWriteErr;
+export interface ListSheetsResult {
+    ok: true;
+    path: string;
+    sheets: Array<{
+        name: string;
+        row_count: number;
+        col_count: number;
+    }>;
+}
+export interface ListSheetsErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+/**
+ * Quick sheet metadata enumeration -- counts rows + columns per
+ * sheet without materialising every cell. Used by the panel +
+ * brain to decide whether to recommend chunked reads.
+ */
+export declare function listSheets(p: string, projectRoot?: string): Promise<ListSheetsResult | ListSheetsErr>;
+export declare function readExcel(req: ExcelReadRequest, projectRoot?: string): Promise<ExcelReadResult>;
+export interface ExcelAppendSheetRequest {
+    /** Existing workbook path. Must already exist (unlike writeExcel). */
+    path: string;
+    /** New sheet name. If a sheet with this name already exists,
+     *  the behaviour depends on `if_exists`. */
+    sheet: string;
+    /** Cells. Either array-of-objects or array-of-arrays. */
+    rows: Array<Record<string, unknown>> | unknown[][];
+    /** Conflict policy when `sheet` already exists.
+     *  'fail'    -- return ok:false, error:'sheet_exists' (default)
+     *  'replace' -- overwrite the existing sheet in place
+     *  'rename'  -- append " (N)" until the name is unique
+     */
+    if_exists?: 'fail' | 'replace' | 'rename';
+}
+export interface ExcelAppendSheetOk {
+    ok: true;
+    path: string;
+    bytes_written: number;
+    row_count: number;
+    /** Final sheet name (may differ from requested when if_exists='rename'). */
+    sheet: string;
+    /** Number of sheets in the workbook after the append. */
+    sheet_count: number;
+}
+export type ExcelAppendSheetResult = ExcelAppendSheetOk | ExcelWriteErr;
+export declare function appendSheet(req: ExcelAppendSheetRequest, projectRoot?: string): Promise<ExcelAppendSheetResult>;
+export declare function writeExcel(req: ExcelWriteRequest, projectRoot?: string): Promise<ExcelWriteResult>;
+//# sourceMappingURL=excel.d.ts.map

package/dist/office/excel.d.ts.map

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

package/dist/office/excel.js

@@ -0,0 +1,276 @@
+/**
+ * F106 office.excel verbs -- cross-platform Excel read/write.
+ *
+ * Uses the `xlsx` package (already in deps for the F45 spreadsheet
+ * intake path). No Windows COM dependency; works the same on
+ * Windows / macOS / Linux.
+ *
+ * Read: parses an .xlsx / .xls / .csv file into a list of rows.
+ * Write: builds a fresh workbook from rows. Refuses to mutate an
+ * existing file unless `overwrite: true` is passed.
+ *
+ * ASCII-only.
+ */
+import { readFile, writeFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import * as XLSX from 'xlsx';
+const MAX_BYTES_READ = 16 * 1024 * 1024; /* 16 MB. Refuse bigger. */
+const MAX_ROWS_WRITE = 1_000_000;
+const MAX_ROW_FIELDS = 1024;
+function resolveSafePath(p, projectRoot) {
+    /* Allow absolute paths but pin relative ones to project root. */
+    return path.isAbsolute(p) ? p : path.join(projectRoot, p);
+}
+/**
+ * Quick sheet metadata enumeration -- counts rows + columns per
+ * sheet without materialising every cell. Used by the panel +
+ * brain to decide whether to recommend chunked reads.
+ */
+export async function listSheets(p, projectRoot = process.cwd()) {
+    if (!p || typeof p !== 'string')
+        return { ok: false, error: 'invalid_args', detail: 'path is required' };
+    const abs = resolveSafePath(p, projectRoot);
+    let buf;
+    try {
+        const s = await stat(abs);
+        if (!s.isFile())
+            return { ok: false, error: 'not_a_file', detail: abs };
+        if (s.size > MAX_BYTES_READ) {
+            return { ok: false, error: 'file_too_large', detail: s.size + ' > ' + MAX_BYTES_READ };
+        }
+        buf = await readFile(abs);
+    }
+    catch (err) {
+        return { ok: false, error: 'read_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    let wb;
+    try {
+        wb = XLSX.read(buf, { type: 'buffer' });
+    }
+    catch (err) {
+        return { ok: false, error: 'parse_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    const sheets = wb.SheetNames.map((name) => {
+        const ws = wb.Sheets[name];
+        const ref = ws?.['!ref'];
+        if (!ref)
+            return { name, row_count: 0, col_count: 0 };
+        const range = XLSX.utils.decode_range(ref);
+        return {
+            name,
+            row_count: range.e.r - range.s.r + 1,
+            col_count: range.e.c - range.s.c + 1,
+        };
+    });
+    return { ok: true, path: abs, sheets };
+}
+export async function readExcel(req, projectRoot = process.cwd()) {
+    if (!req.path || typeof req.path !== 'string') {
+        return { ok: false, error: 'invalid_args', detail: 'path is required' };
+    }
+    const abs = resolveSafePath(req.path, projectRoot);
+    let buf;
+    try {
+        const s = await stat(abs);
+        if (!s.isFile())
+            return { ok: false, error: 'not_a_file', detail: abs };
+        if (s.size > MAX_BYTES_READ) {
+            return { ok: false, error: 'file_too_large', detail: s.size + ' > ' + MAX_BYTES_READ };
+        }
+        buf = await readFile(abs);
+    }
+    catch (err) {
+        return { ok: false, error: 'read_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    let wb;
+    try {
+        wb = XLSX.read(buf, { type: 'buffer' });
+    }
+    catch (err) {
+        return { ok: false, error: 'parse_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    const sheetNames = wb.SheetNames;
+    const wantSheet = req.sheet ?? sheetNames[0];
+    if (!wantSheet || !sheetNames.includes(wantSheet)) {
+        return { ok: false, error: 'sheet_not_found', detail: 'available: ' + sheetNames.join(', ') };
+    }
+    const ws = wb.Sheets[wantSheet];
+    if (!ws) {
+        return { ok: false, error: 'sheet_not_found', detail: wantSheet };
+    }
+    const useHeader = req.header_row !== false;
+    const opts = useHeader
+        ? { defval: null, range: req.range }
+        : { header: 1, defval: null, range: req.range };
+    const rows = XLSX.utils.sheet_to_json(ws, opts);
+    return {
+        ok: true,
+        sheet: wantSheet,
+        rows,
+        row_count: rows.length,
+        sheet_names: sheetNames,
+    };
+}
+/* L14 -- append a sheet to an existing .xlsx workbook without
+ * rewriting the other sheets. Honours if_exists policy. */
+export async function appendSheet(req, projectRoot = process.cwd()) {
+    if (!req.path || typeof req.path !== 'string') {
+        return { ok: false, error: 'invalid_args', detail: 'path is required' };
+    }
+    if (!req.sheet || typeof req.sheet !== 'string') {
+        return { ok: false, error: 'invalid_args', detail: 'sheet is required' };
+    }
+    if (!Array.isArray(req.rows)) {
+        return { ok: false, error: 'invalid_args', detail: 'rows must be an array' };
+    }
+    if (req.rows.length > MAX_ROWS_WRITE) {
+        return { ok: false, error: 'too_many_rows', detail: req.rows.length + ' > ' + MAX_ROWS_WRITE };
+    }
+    for (const r of req.rows) {
+        const w = Array.isArray(r) ? r.length : Object.keys(r).length;
+        if (w > MAX_ROW_FIELDS) {
+            return { ok: false, error: 'row_too_wide', detail: w + ' > ' + MAX_ROW_FIELDS };
+        }
+    }
+    const abs = resolveSafePath(req.path, projectRoot);
+    let buf;
+    try {
+        buf = await readFile(abs);
+    }
+    catch {
+        return { ok: false, error: 'file_not_found', detail: abs };
+    }
+    let wb;
+    try {
+        wb = XLSX.read(buf, { type: 'buffer' });
+    }
+    catch (err) {
+        return { ok: false, error: 'parse_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    /* Build the new worksheet. */
+    let ws;
+    try {
+        const first = req.rows[0];
+        if (Array.isArray(first)) {
+            ws = XLSX.utils.aoa_to_sheet(req.rows);
+        }
+        else {
+            ws = XLSX.utils.json_to_sheet(req.rows);
+        }
+    }
+    catch (err) {
+        return { ok: false, error: 'build_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    /* Resolve final sheet name + conflict policy. */
+    const policy = req.if_exists ?? 'fail';
+    let finalName = req.sheet;
+    const existing = new Set(wb.SheetNames);
+    if (existing.has(finalName)) {
+        switch (policy) {
+            case 'fail':
+                return { ok: false, error: 'sheet_exists', detail: finalName };
+            case 'replace':
+                /* Remove the existing sheet, then book_append_sheet below. */
+                delete wb.Sheets[finalName];
+                wb.SheetNames = wb.SheetNames.filter((n) => n !== finalName);
+                break;
+            case 'rename': {
+                let i = 2;
+                while (existing.has(finalName + ' (' + i + ')'))
+                    i++;
+                finalName = finalName + ' (' + i + ')';
+                break;
+            }
+        }
+    }
+    XLSX.utils.book_append_sheet(wb, ws, finalName);
+    /* Drive output format from extension. CSV doesn't support
+     *  multi-sheet; refuse rather than silently drop sheets. */
+    const ext = path.extname(abs).toLowerCase();
+    if (ext === '.csv') {
+        return { ok: false, error: 'csv_not_supported', detail: 'append-sheet requires xlsx (csv has no multi-sheet)' };
+    }
+    const bookType = ext === '.xls' ? 'biff8' : 'xlsx';
+    let out;
+    try {
+        out = XLSX.write(wb, { bookType, type: 'buffer' });
+    }
+    catch (err) {
+        return { ok: false, error: 'write_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    try {
+        await writeFile(abs, out);
+    }
+    catch (err) {
+        return { ok: false, error: 'fs_write_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    return {
+        ok: true,
+        path: abs,
+        bytes_written: out.length,
+        row_count: req.rows.length,
+        sheet: finalName,
+        sheet_count: wb.SheetNames.length,
+    };
+}
+export async function writeExcel(req, projectRoot = process.cwd()) {
+    if (!req.path || typeof req.path !== 'string') {
+        return { ok: false, error: 'invalid_args', detail: 'path is required' };
+    }
+    if (!Array.isArray(req.rows)) {
+        return { ok: false, error: 'invalid_args', detail: 'rows must be an array' };
+    }
+    if (req.rows.length > MAX_ROWS_WRITE) {
+        return { ok: false, error: 'too_many_rows', detail: req.rows.length + ' > ' + MAX_ROWS_WRITE };
+    }
+    /* Defensive: refuse super-wide rows. */
+    for (const r of req.rows) {
+        const w = Array.isArray(r) ? r.length : Object.keys(r).length;
+        if (w > MAX_ROW_FIELDS) {
+            return { ok: false, error: 'row_too_wide', detail: w + ' > ' + MAX_ROW_FIELDS };
+        }
+    }
+    const abs = resolveSafePath(req.path, projectRoot);
+    if (!req.overwrite) {
+        try {
+            await stat(abs);
+            return { ok: false, error: 'file_exists', detail: 'pass overwrite=true to replace' };
+        }
+        catch { /* file missing is the expected good path */ }
+    }
+    let ws;
+    try {
+        /* Two shapes: array of objects (use json_to_sheet) or array
+         *  of arrays (use aoa_to_sheet). */
+        const first = req.rows[0];
+        if (Array.isArray(first)) {
+            ws = XLSX.utils.aoa_to_sheet(req.rows);
+        }
+        else {
+            ws = XLSX.utils.json_to_sheet(req.rows);
+        }
+    }
+    catch (err) {
+        return { ok: false, error: 'build_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    const wb = XLSX.utils.book_new();
+    XLSX.utils.book_append_sheet(wb, ws, req.sheet ?? 'Sheet1');
+    /* Drive output format from extension; default xlsx. */
+    const ext = path.extname(abs).toLowerCase();
+    const bookType = ext === '.csv' ? 'csv' : (ext === '.xls' ? 'biff8' : 'xlsx');
+    let out;
+    try {
+        out = XLSX.write(wb, { bookType, type: 'buffer' });
+    }
+    catch (err) {
+        return { ok: false, error: 'write_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    try {
+        await writeFile(abs, out);
+    }
+    catch (err) {
+        return { ok: false, error: 'fs_write_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    return { ok: true, path: abs, bytes_written: out.length, row_count: req.rows.length };
+}
+//# sourceMappingURL=excel.js.map

package/dist/office/excel.js.map

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

package/dist/office/pdf.d.ts

@@ -0,0 +1,35 @@
+/**
+ * F106 office.pdf.read -- cross-platform PDF text extraction.
+ *
+ * Thin wrapper over the existing parser in src/reader/parsers/pdf.ts
+ * (pdfjs-dist). Returns the plain-text body + a page outline so the
+ * brain can quickly answer "what does page 5 say?" without
+ * reloading the file.
+ *
+ * ASCII-only.
+ */
+export interface PdfReadRequest {
+    path: string;
+    /** When true (default), include the per-page text outline. */
+    include_outline?: boolean;
+}
+export interface PdfReadOk {
+    ok: true;
+    title: string;
+    text: string;
+    page_count: number;
+    outline?: Array<{
+        page: number;
+        heading: string;
+        text: string;
+    }>;
+    byte_size: number;
+}
+export interface PdfReadErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export type PdfReadResult = PdfReadOk | PdfReadErr;
+export declare function readPdf(req: PdfReadRequest, projectRoot?: string): Promise<PdfReadResult>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/office/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/office/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAS,IAAI,CAAC;IAChB,KAAK,EAAM,MAAM,CAAC;IAClB,IAAI,EAAO,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAK,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAMnD,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,WAAW,SAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgDtG"}

package/dist/office/pdf.js

@@ -0,0 +1,70 @@
+/**
+ * F106 office.pdf.read -- cross-platform PDF text extraction.
+ *
+ * Thin wrapper over the existing parser in src/reader/parsers/pdf.ts
+ * (pdfjs-dist). Returns the plain-text body + a page outline so the
+ * brain can quickly answer "what does page 5 say?" without
+ * reloading the file.
+ *
+ * ASCII-only.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { parsePdf } from '../reader/parsers/pdf.js';
+const MAX_BYTES = 32 * 1024 * 1024; /* 32 MB read cap. */
+function resolveSafePath(p, projectRoot) {
+    return path.isAbsolute(p) ? p : path.join(projectRoot, p);
+}
+export async function readPdf(req, projectRoot = process.cwd()) {
+    if (!req.path || typeof req.path !== 'string') {
+        return { ok: false, error: 'invalid_args', detail: 'path is required' };
+    }
+    const abs = resolveSafePath(req.path, projectRoot);
+    let buf;
+    try {
+        const s = await stat(abs);
+        if (!s.isFile())
+            return { ok: false, error: 'not_a_file', detail: abs };
+        if (s.size > MAX_BYTES) {
+            return { ok: false, error: 'file_too_large', detail: s.size + ' > ' + MAX_BYTES };
+        }
+        buf = await readFile(abs);
+    }
+    catch (err) {
+        return { ok: false, error: 'read_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    let doc;
+    try {
+        doc = await parsePdf({ buffer: buf, filename: path.basename(abs) });
+    }
+    catch (err) {
+        return { ok: false, error: 'parse_failed', detail: err instanceof Error ? err.message : String(err) };
+    }
+    /* The reader doc is sections-per-page (heading "Pagina N"). Aggregate. */
+    const pageTexts = [];
+    const outline = [];
+    for (const section of doc.sections) {
+        const sectionText = section.blocks
+            .map((b) => 'text' in b ? b.text : '')
+            .filter(Boolean)
+            .join('\n')
+            .trim();
+        pageTexts.push(sectionText);
+        if (req.include_outline !== false) {
+            outline.push({
+                page: pageTexts.length,
+                heading: section.heading || ('Pagina ' + pageTexts.length),
+                text: sectionText.slice(0, 200),
+            });
+        }
+    }
+    return {
+        ok: true,
+        title: doc.title || '',
+        text: pageTexts.join('\n\n'),
+        page_count: pageTexts.length,
+        outline: req.include_outline !== false ? outline : undefined,
+        byte_size: buf.length,
+    };
+}
+//# sourceMappingURL=pdf.js.map

package/dist/office/pdf.js.map

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

package/dist/office/word.d.ts

@@ -0,0 +1,64 @@
+/**
+ * F106 office.word verbs -- cross-platform Word read/write.
+ *
+ * Read: uses `mammoth` (already in deps for the document-reader
+ * pipeline) to extract text + a heading outline from a .docx file.
+ * Write: builds a minimal .docx file by hand (Office Open XML
+ * minimal subset) -- no extra deps. Covers headings + paragraphs.
+ *
+ * This sticks to plain content. Tables / images / styles are out of
+ * scope for the first cut. Adopters that need rich docs can drop
+ * to lower-level docx libs themselves.
+ *
+ * ASCII-only source. The .docx output IS binary (ZIP).
+ */
+export interface WordReadRequest {
+    /** Absolute or project-relative path. */
+    path: string;
+    /** Include the auto-detected heading outline. Default true. */
+    include_outline?: boolean;
+}
+export interface WordReadOk {
+    ok: true;
+    text: string;
+    outline?: Array<{
+        level: number;
+        text: string;
+    }>;
+    warnings: string[];
+    byte_size: number;
+}
+export interface WordReadErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export type WordReadResult = WordReadOk | WordReadErr;
+export interface WordSection {
+    /** 'heading' or 'paragraph'. */
+    kind: 'heading' | 'paragraph';
+    /** 1..6 for headings; ignored for paragraphs. */
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    text: string;
+}
+export interface WordWriteRequest {
+    /** Absolute or project-relative path. Must end in .docx. */
+    path: string;
+    sections: WordSection[];
+    overwrite?: boolean;
+}
+export interface WordWriteOk {
+    ok: true;
+    path: string;
+    bytes_written: number;
+    section_count: number;
+}
+export interface WordWriteErr {
+    ok: false;
+    error: string;
+    detail?: string;
+}
+export type WordWriteResult = WordWriteOk | WordWriteErr;
+export declare function readWord(req: WordReadRequest, projectRoot?: string): Promise<WordReadResult>;
+export declare function writeWord(req: WordWriteRequest, projectRoot?: string): Promise<WordWriteResult>;
+//# sourceMappingURL=word.d.ts.map

package/dist/office/word.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"word.d.ts","sourceRoot":"","sources":["../../src/office/word.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,iDAAiD;IACjD,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC;AAMzD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,SAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwCzG;AA4ID,wBAAsB,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,SAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8C5G"}