netra-artifacts 0.1.0-alpha.0

package/dist-cjs/stream/predictiveHtmlParser.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Predictive HTML parser for streaming AI output.
+ *
+ * The core idea: keep the real streamed HTML as the immutable *truth*, but for
+ * rendering produce a temporary *projection* that predicts the missing closing
+ * tags from the current parser stack. The model can stream
+ *
+ *     <section><div><h2>Hello
+ *
+ * and the renderer receives a valid document:
+ *
+ *     <section><div><h2>Hello</h2></div></section>
+ *
+ * When the real `</h2></div></section>` arrives later, the stack matches them
+ * and nothing is duplicated — predicted closings are never written back into
+ * the committed truth.
+ *
+ * The parser is incremental: feed it chunks with {@link push}; it carries
+ * partial tokens (tags, comments, raw-text close) across chunk boundaries. It
+ * handles void elements, self-closing tags, quoted attributes containing
+ * `<`/`>`, comments, doctype, raw-text elements (`<style>`/`<script>`/… whose
+ * bodies aren't markup), implicit closing (`<li>`, `<td>`, `<p>`, …), and
+ * mis-nested close tags (`<div><p>x</div>` → closes `p` before `div`).
+ *
+ * It is purely structural — it does NOT sanitize or style. Run the output
+ * through the sanitizer before rendering (the iframe pipeline does this).
+ *
+ * Fail-open: malformed input degrades to text rather than throwing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PredictiveHtmlParser = void 0;
+const VOID_TAGS = new Set([
+    "area", "base", "br", "col", "embed", "hr", "img", "input",
+    "link", "meta", "param", "source", "track", "wbr",
+]);
+// Elements whose content is text, not markup. An unclosed one would otherwise
+// swallow everything after it; we consume to the real closer instead.
+const RAW_TEXT_TAGS = new Set(["script", "style", "textarea", "title"]);
+// When the key element is open and one of its value elements opens, the key is
+// implicitly closed first (mirrors the HTML parsing spec, pragmatically).
+const IMPLICIT_CLOSE_RULES = {
+    p: new Set([
+        "p", "div", "section", "article", "main", "header", "footer", "nav",
+        "aside", "ul", "ol", "dl", "table", "form", "blockquote", "pre",
+        "h1", "h2", "h3", "h4", "h5", "h6", "figure", "hr",
+    ]),
+    li: new Set(["li"]),
+    dt: new Set(["dt", "dd"]),
+    dd: new Set(["dt", "dd"]),
+    tr: new Set(["tr", "tbody", "tfoot", "thead"]),
+    td: new Set(["td", "th", "tr", "tbody", "tfoot", "thead"]),
+    th: new Set(["td", "th", "tr", "tbody", "tfoot", "thead"]),
+    thead: new Set(["tbody", "tfoot"]),
+    tbody: new Set(["tbody", "tfoot"]),
+    option: new Set(["option", "optgroup"]),
+};
+class PredictiveHtmlParser {
+    committed = "";
+    pending = "";
+    stack = [];
+    insideRawText = null;
+    htmlClosed = false;
+    /** Feed a chunk; returns the current renderable projection. */
+    push(chunk) {
+        if (typeof chunk === "string" && chunk.length > 0) {
+            try {
+                this.process(this.pending + chunk);
+            }
+            catch {
+                // Fail open: keep whatever we had, treat the chunk as text.
+                this.pending = "";
+                this.committed += chunk;
+            }
+        }
+        return this.render();
+    }
+    /** The current renderable projection: committed + predicted closings. */
+    render() {
+        let html = this.committed;
+        // Only append the held tail if it's plain text (CSS/text), never a partial
+        // tag fragment like "<div cla" or "</sty".
+        if (this.pending && !this.pending.startsWith("<"))
+            html += this.pending;
+        for (let i = this.stack.length - 1; i >= 0; i--) {
+            html += `</${this.stack[i]}>`;
+        }
+        return html;
+    }
+    /** The immutable, never-predicted truth committed so far. */
+    get committedHtml() {
+        return this.committed;
+    }
+    /** True once a real `</html>` has balanced the document. */
+    get complete() {
+        return this.htmlClosed;
+    }
+    /** Is there visible body content worth rendering yet? */
+    isRenderable() {
+        const body = /<body\b[^>]*>([\s\S]*)$/i.exec(this.committed);
+        if (body)
+            return /\S/.test(body[1] ?? "");
+        return /<(?:div|section|main|header|footer|h[1-6]|p|ul|ol|li|table|article|nav|svg|img|button|form|span|a|figure|blockquote)\b/i.test(this.committed);
+    }
+    reset() {
+        this.committed = "";
+        this.pending = "";
+        this.stack = [];
+        this.insideRawText = null;
+        this.htmlClosed = false;
+    }
+    process(buf) {
+        this.pending = "";
+        const n = buf.length;
+        let i = 0;
+        while (i < n) {
+            // Inside a raw-text element: consume verbatim until its real closer.
+            if (this.insideRawText) {
+                const tag = this.insideRawText;
+                const re = new RegExp(`</${tag}\\s*>`, "i");
+                const m = re.exec(buf.slice(i));
+                if (m) {
+                    const end = i + m.index + m[0].length;
+                    this.committed += buf.slice(i, end);
+                    const idx = this.stack.lastIndexOf(tag);
+                    if (idx !== -1)
+                        this.stack.length = idx;
+                    this.insideRawText = null;
+                    i = end;
+                    continue;
+                }
+                // Closer not here yet: commit what we safely can, hold back enough to
+                // catch a closer split across the boundary (e.g. "</styl").
+                const holdback = `</${tag}>`.length - 1;
+                const safeEnd = Math.max(i, n - holdback);
+                if (safeEnd > i)
+                    this.committed += buf.slice(i, safeEnd);
+                this.pending = buf.slice(safeEnd);
+                return;
+            }
+            const lt = buf.indexOf("<", i);
+            if (lt === -1) {
+                this.committed += buf.slice(i);
+                return;
+            }
+            if (lt > i)
+                this.committed += buf.slice(i, lt);
+            // Comment.
+            if (buf.startsWith("<!--", lt)) {
+                const end = buf.indexOf("-->", lt + 4);
+                if (end === -1) {
+                    this.pending = buf.slice(lt);
+                    return;
+                }
+                this.committed += buf.slice(lt, end + 3);
+                i = end + 3;
+                continue;
+            }
+            // Doctype / declaration / processing instruction.
+            if (buf.startsWith("<!", lt) || buf.startsWith("<?", lt)) {
+                const end = buf.indexOf(">", lt + 2);
+                if (end === -1) {
+                    this.pending = buf.slice(lt);
+                    return;
+                }
+                this.committed += buf.slice(lt, end + 1);
+                i = end + 1;
+                continue;
+            }
+            const gt = findTagEnd(buf, lt);
+            if (gt === -1) {
+                // Incomplete tag at the frontier — hold it for the next chunk.
+                this.pending = buf.slice(lt);
+                return;
+            }
+            const raw = buf.slice(lt, gt + 1);
+            const name = tagName(raw);
+            if (!name) {
+                // Not a real tag ("<>" or "< x"); treat literally as text.
+                this.committed += raw;
+                i = gt + 1;
+                continue;
+            }
+            if (raw[1] === "/")
+                this.handleClose(name, raw);
+            else
+                this.handleOpen(name, raw);
+            i = gt + 1;
+        }
+    }
+    handleOpen(name, raw) {
+        this.autoCloseImplicit(name);
+        this.committed += raw;
+        const selfClosing = /\/\s*>$/.test(raw);
+        if (VOID_TAGS.has(name) || selfClosing)
+            return;
+        this.stack.push(name);
+        if (RAW_TEXT_TAGS.has(name))
+            this.insideRawText = name;
+    }
+    handleClose(name, raw) {
+        const idx = this.stack.lastIndexOf(name);
+        if (idx === -1)
+            return; // orphan close — ignore
+        // Close any unclosed descendants opened after the matched element.
+        while (this.stack.length > idx + 1) {
+            const node = this.stack.pop();
+            this.committed += `</${node}>`;
+        }
+        this.stack.pop();
+        this.committed += raw;
+        if (name === "html")
+            this.htmlClosed = true;
+    }
+    autoCloseImplicit(newTag) {
+        // A chain may close several elements (e.g. <td>…<tr> closes td then tr).
+        for (;;) {
+            const top = this.stack[this.stack.length - 1];
+            if (!top)
+                return;
+            const rule = IMPLICIT_CLOSE_RULES[top];
+            if (rule && rule.has(newTag)) {
+                this.stack.pop();
+                this.committed += `</${top}>`;
+            }
+            else {
+                return;
+            }
+        }
+    }
+}
+exports.PredictiveHtmlParser = PredictiveHtmlParser;
+/** Index of the `>` ending the tag opening at `lt`, skipping quoted attrs. */
+function findTagEnd(input, lt) {
+    let quote = null;
+    for (let i = lt + 1; i < input.length; i++) {
+        const c = input[i];
+        if (quote) {
+            if (c === quote)
+                quote = null;
+        }
+        else if (c === '"' || c === "'") {
+            quote = c;
+        }
+        else if (c === ">") {
+            return i;
+        }
+    }
+    return -1;
+}
+/** Lowercase element name from a tag string, or "" if not a real tag. */
+function tagName(tag) {
+    const m = /^<\/?\s*([a-zA-Z][a-zA-Z0-9:-]*)/.exec(tag);
+    return m ? m[1].toLowerCase() : "";
+}
+//# sourceMappingURL=predictiveHtmlParser.js.map

package/dist-cjs/stream/predictiveHtmlParser.js.map

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

package/dist-cjs/stream/sse.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readArtifactStream = readArtifactStream;
+const decoder_js_1 = require("./decoder.js");
+/**
+ * Consume a `fetch` Response body as a stream of protocol events. Yields each
+ * decoded {@link ArtifactStreamEvent} as it arrives.
+ */
+async function* readArtifactStream(response, signal) {
+    if (!response.body) {
+        throw new Error("Response has no readable body");
+    }
+    const reader = response.body.getReader();
+    const textDecoder = new TextDecoder();
+    const sseDecoder = new decoder_js_1.SseDecoder();
+    try {
+        while (true) {
+            if (signal?.aborted)
+                break;
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const text = textDecoder.decode(value, { stream: true });
+            for (const event of sseDecoder.push(text)) {
+                yield event;
+            }
+        }
+        for (const event of sseDecoder.flush()) {
+            yield event;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist-cjs/stream/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/stream/sse.ts"],"names":[],"mappings":";;AAOA,gDA4BC;AAnCD,6CAA0C;AAG1C;;;GAGG;AACI,KAAK,SAAS,CAAC,CAAC,kBAAkB,CACvC,QAAkB,EAClB,MAAoB;IAEpB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,uBAAU,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM;YAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist-cjs/types/artifact.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=artifact.js.map

package/dist-cjs/types/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/types/artifact.ts"],"names":[],"mappings":""}

package/dist-cjs/types/client.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=client.js.map

package/dist-cjs/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/types/client.ts"],"names":[],"mappings":""}

package/dist-cjs/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist-cjs/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist-cjs/types/errors.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=errors.js.map

package/dist-cjs/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":""}

package/dist-cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist-cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist-cjs/types/server.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=server.js.map

package/dist-cjs/types/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/types/server.ts"],"names":[],"mappings":""}

package/dist-cjs/types/stream.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * The wire protocol shared by the server stream producer and the client
+ * consumer. Every response begins with a `mode` event so the frontend knows
+ * whether to render a markdown bubble or an artifact card.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=stream.js.map

package/dist-cjs/types/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/types/stream.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist-cjs/utils/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./invariant.js"), exports);
+__exportStar(require("./safeJsonParse.js"), exports);
+__exportStar(require("./mergeConfig.js"), exports);
+__exportStar(require("./isBrowser.js"), exports);
+__exportStar(require("./noop.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,qDAAmC;AACnC,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B"}

package/dist-cjs/utils/invariant.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invariant = invariant;
+/**
+ * Throws when `condition` is falsy. Narrows types for the caller. Keep
+ * messages short — they may surface in server logs.
+ */
+function invariant(condition, message = "Invariant failed") {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=invariant.js.map

package/dist-cjs/utils/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../src/utils/invariant.ts"],"names":[],"mappings":";;AAIA,8BAOC;AAXD;;;GAGG;AACH,SAAgB,SAAS,CACvB,SAAkB,EAClB,OAAO,GAAG,kBAAkB;IAE5B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist-cjs/utils/isBrowser.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBrowser = void 0;
+/** True when running in an environment with a DOM. */
+exports.isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+//# sourceMappingURL=isBrowser.js.map

package/dist-cjs/utils/isBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isBrowser.js","sourceRoot":"","sources":["../../src/utils/isBrowser.ts"],"names":[],"mappings":";;;AAAA,sDAAsD;AACzC,QAAA,SAAS,GACpB,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC"}

package/dist-cjs/utils/mergeConfig.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeConfig = mergeConfig;
+/**
+ * Shallow-merge `overrides` onto `defaults`, ignoring `undefined` values so a
+ * caller passing `{ foo: undefined }` does not clobber a real default.
+ */
+function mergeConfig(defaults, overrides) {
+    if (!overrides)
+        return { ...defaults };
+    const result = { ...defaults };
+    for (const key of Object.keys(overrides)) {
+        const value = overrides[key];
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=mergeConfig.js.map

package/dist-cjs/utils/mergeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeConfig.js","sourceRoot":"","sources":["../../src/utils/mergeConfig.ts"],"names":[],"mappings":";;AAIA,kCAaC;AAjBD;;;GAGG;AACH,SAAgB,WAAW,CACzB,QAAW,EACX,SAAsB;IAEtB,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAgB,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAmB,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist-cjs/utils/noop.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noop = void 0;
+/** A function that does nothing — useful as a default callback. */
+const noop = () => { };
+exports.noop = noop;
+//# sourceMappingURL=noop.js.map

package/dist-cjs/utils/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/utils/noop.ts"],"names":[],"mappings":";;;AAAA,mEAAmE;AAC5D,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;AAAtB,QAAA,IAAI,QAAkB"}

package/dist-cjs/utils/safeJsonParse.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeJsonParse = safeJsonParse;
+/**
+ * Parse JSON without throwing. Returns `fallback` on any failure. Also tolerates
+ * models that wrap JSON in ```json fences or surround it with prose by
+ * extracting the first balanced `{...}` block.
+ */
+function safeJsonParse(input, fallback) {
+    if (typeof input !== "string")
+        return fallback;
+    const direct = tryParse(input);
+    if (direct.ok)
+        return direct.value;
+    const extracted = extractJsonObject(input);
+    if (extracted !== null) {
+        const parsed = tryParse(extracted);
+        if (parsed.ok)
+            return parsed.value;
+    }
+    return fallback;
+}
+function tryParse(text) {
+    try {
+        return { ok: true, value: JSON.parse(text) };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+/** Returns the first balanced top-level `{...}` substring, or null. */
+function extractJsonObject(input) {
+    const start = input.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < input.length; i++) {
+        const char = input[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === "{")
+            depth++;
+        else if (char === "}") {
+            depth--;
+            if (depth === 0)
+                return input.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=safeJsonParse.js.map

package/dist-cjs/utils/safeJsonParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeJsonParse.js","sourceRoot":"","sources":["../../src/utils/safeJsonParse.ts"],"names":[],"mappings":";;AAKA,sCAaC;AAlBD;;;;GAIG;AACH,SAAgB,aAAa,CAAI,KAAa,EAAE,QAAW;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE/C,MAAM,MAAM,GAAG,QAAQ,CAAI,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAEnC,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,QAAQ,CAAI,SAAS,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IACrC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CACf,IAAY;IAEZ,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,iBAAiB,CAAC,KAAa;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ;YAAE,SAAS;QAEvB,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACrB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}