covara 0.7.0 → 0.8.0

package/dist/htmx/client/runtime.js

@@ -0,0 +1,195 @@
+// The covara/htmx client runtime. Shipped (with vendored htmx core) by
+// serveHtmxBundle(). htmx core powers the mutation controls (hx-post/hx-patch/
+// hx-delete emitted by the c.* helpers); this runtime adds:
+//   - the live SSE channel (connect each <Live> container, apply named events),
+//   - optimistic create rendered from the server-shipped row <template> (no
+//     ghost) reconciled by the authoritative HTML response,
+//   - optimistic delete (row hidden immediately, restored on failure),
+//   - a basic offline queue (mutations replay + resync on reconnect).
+export const covaraRuntimeScript = String.raw `(function () {
+  var LIVE = "/__covara/live/";
+  var QUEUE_KEY = "cv-offline-queue";
+
+  function firstEl(html) {
+    var tpl = document.createElement("template");
+    tpl.innerHTML = (html || "").trim();
+    return tpl.content.firstElementChild;
+  }
+  function process(el) { if (window.htmx && el) window.htmx.process(el); }
+
+  function escapeHtml(v) {
+    if (v === null || v === undefined) return "";
+    return String(v)
+      .replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+  }
+  function applyTemplate(tmpl, values) {
+    return tmpl.replace(/\{\{(\w+)\}\}/g, function (_m, k) { return escapeHtml(values[k]); });
+  }
+
+  function upsert(container, html) {
+    var el = firstEl(html);
+    if (!el) return;
+    var existing = el.id ? document.getElementById(el.id) : null;
+    if (existing) existing.replaceWith(el); else container.appendChild(el);
+    process(el);
+  }
+  // For "changed": only patch a row this client is actually showing. A change
+  // for a row outside the loaded page (pagination) is ignored rather than
+  // appended out of order — the row arrives when this client loads that page.
+  function replaceExisting(html) {
+    var el = firstEl(html);
+    if (!el || !el.id) return;
+    var existing = document.getElementById(el.id);
+    if (existing) {
+      existing.replaceWith(el);
+      process(el);
+    }
+  }
+  function removeById(domId) {
+    var el = document.getElementById((domId || "").trim());
+    if (el) el.remove();
+  }
+  function refetch(container) {
+    var url = container.getAttribute("data-cv-list");
+    if (!url) return;
+    fetch(url, { credentials: "include", headers: { "HX-Request": "true" } })
+      .then(function (r) { return r.text(); })
+      .then(function (html) { container.innerHTML = html; process(container); });
+  }
+
+  function connect(container) {
+    var url = container.getAttribute("data-cv-sse");
+    if (!url || container.__cvES) return;
+    var es = new EventSource(url, { withCredentials: true });
+    es.addEventListener("added", function (e) { upsert(container, e.data); });
+    es.addEventListener("changed", function (e) { replaceExisting(e.data); });
+    es.addEventListener("removed", function (e) { removeById(e.data); });
+    es.addEventListener("aggregate", function (e) { container.innerHTML = e.data; process(container); });
+    es.addEventListener("invalidate", function () { refetch(container); });
+    container.__cvES = es;
+  }
+  function init(root) {
+    (root || document).querySelectorAll("[data-cv-sse]").forEach(connect);
+  }
+
+  // ---- region helpers ----------------------------------------------------
+  function regionOf(url) {
+    if (!url || url.indexOf(LIVE) !== 0) return null;
+    return url.slice(LIVE.length).split("/")[0];
+  }
+  function containerFor(region) {
+    return document.querySelector('[data-cv-region="' + region + '"]');
+  }
+  function templateFor(container) {
+    var id = container && container.getAttribute("data-cv-template");
+    var tpl = id && document.getElementById(id);
+    return tpl ? tpl.innerHTML : null;
+  }
+  function formValues(form) {
+    var out = {};
+    if (!form) return out;
+    new FormData(form).forEach(function (v, k) { out[k] = v; });
+    return out;
+  }
+
+  // ---- offline queue -----------------------------------------------------
+  function loadQueue() {
+    try { return JSON.parse(localStorage.getItem(QUEUE_KEY) || "[]"); } catch (e) { return []; }
+  }
+  function saveQueue(q) {
+    try { localStorage.setItem(QUEUE_KEY, JSON.stringify(q)); } catch (e) {}
+  }
+  function enqueue(entry) { var q = loadQueue(); q.push(entry); saveQueue(q); }
+  function flushQueue() {
+    var q = loadQueue();
+    if (!q.length) return;
+    saveQueue([]);
+    var regions = {};
+    q.reduce(function (p, e) {
+      return p.then(function () {
+        regions[e.region] = true;
+        return fetch(e.url, {
+          method: e.method,
+          credentials: "include",
+          headers: { "Content-Type": "application/x-www-form-urlencoded" },
+          body: e.body,
+        }).catch(function () { enqueue(e); });
+      });
+    }, Promise.resolve()).then(function () {
+      Object.keys(regions).forEach(function (r) {
+        var c = containerFor(r);
+        if (c) refetch(c);
+      });
+    });
+  }
+  window.addEventListener("online", flushQueue);
+
+  // ---- optimistic mutations (htmx integration) ---------------------------
+  // Per-request state, keyed by the xhr (the one object htmx shares across
+  // beforeRequest/afterRequest — event.detail is NOT shared between them).
+  var pending = new WeakMap();
+
+  function reqPath(detail) {
+    return (detail.pathInfo && detail.pathInfo.requestPath) ||
+      detail.path || (detail.requestConfig && detail.requestConfig.path) || "";
+  }
+  function reqVerb(detail) {
+    return (detail.requestConfig && detail.requestConfig.verb) || "";
+  }
+
+  document.addEventListener("htmx:beforeRequest", function (evt) {
+    var detail = evt.detail || {};
+    var region = regionOf(reqPath(detail));
+    if (!region || !detail.xhr) return;
+    var verb = reqVerb(detail);
+    var el = detail.elt;
+
+    // CREATE is NOT optimistically inserted here. The create response uses
+    // hx-swap="none"; the new row is inserted exactly once by the SSE "added"
+    // event (same path every tab uses), which avoids the duplicate + phantom
+    // row that an optimistic placeholder caused.
+    if (verb === "delete") {
+      var row = el && el.closest && el.closest("[data-covara-id]");
+      if (row) {
+        row.style.display = "none";
+        pending.set(detail.xhr, { hidden: row });
+      }
+    }
+  });
+
+  document.addEventListener("htmx:afterRequest", function (evt) {
+    var detail = evt.detail || {};
+    if (!detail.xhr) return;
+    var p = pending.get(detail.xhr);
+    if (!p) return;
+    pending.delete(detail.xhr);
+    // On failure, restore the optimistically-hidden row. On success the row is
+    // removed by the response swap / SSE "removed" event.
+    if (p.hidden && !detail.successful) p.hidden.style.display = "";
+  });
+
+  document.addEventListener("htmx:sendError", function (evt) {
+    var detail = evt.detail || {};
+    var cfg = detail.requestConfig || {};
+    var region = regionOf(cfg.path || "");
+    if (!region) return;
+    if (cfg.verb === "post") {
+      enqueue({ region: region, url: LIVE + region, method: "POST", body: serialize(cfg.parameters) });
+    }
+  });
+
+  function serialize(params) {
+    if (!params) return "";
+    var p = new URLSearchParams();
+    Object.keys(params).forEach(function (k) { p.append(k, params[k]); });
+    return p.toString();
+  }
+
+  if (document.readyState !== "loading") init();
+  else document.addEventListener("DOMContentLoaded", function () { init(); });
+  if (navigator.onLine) flushQueue();
+  window.Covara = { init: init, flushQueue: flushQueue };
+})();
+`;
+//# sourceMappingURL=runtime.js.map

package/dist/htmx/client/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/htmx/client/runtime.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAC/E,4DAA4D;AAC5D,gFAAgF;AAChF,4EAA4E;AAC5E,4DAA4D;AAC5D,uEAAuE;AACvE,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyL5C,CAAC"}

package/dist/htmx/context.d.ts

@@ -0,0 +1,16 @@
+export type Attrs = Record<string, string>;
+export type LiveMode = "live" | "page";
+export declare const attrsToHtml: (attrs: Attrs) => string;
+export declare const loadMoreButtonHtml: (region: string, cursor: string, label?: string) => string;
+export interface RegionContext {
+    readonly regionId: string;
+    container(extra?: Attrs): Attrs;
+    row(id: string | number, extra?: Attrs): Attrs;
+    create(extra?: Attrs): Attrs;
+    update(id: string | number, extra?: Attrs): Attrs;
+    delete(id: string | number, extra?: Attrs): Attrs;
+}
+export declare const createRegionContext: (region: string, opts?: {
+    mode?: LiveMode;
+}) => RegionContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/htmx/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/htmx/context.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAKvC,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,KAAG,MAG9B,CAAC;AAKd,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,cAAmB,KAClB,MASF,CAAC;AAKF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAEhC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAE/C,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAE7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAElD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACnD;AAKD,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,OAAM;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAO,KAC7B,aA6CD,CAAC"}

package/dist/htmx/context.js

@@ -0,0 +1,52 @@
+import { escapeAttr } from "../shared/escape.js";
+import { containerDomId, regionBaseUrl, regionItemUrl, regionSubscribeUrl, rowDomId, templateDomId, } from "./ids.js";
+// Render an attribute object to an HTML attribute string (leading space when
+// non-empty). Values are attribute-escaped; used when the framework builds a
+// default container/element rather than the developer's JSX.
+export const attrsToHtml = (attrs) => Object.entries(attrs)
+    .map(([k, v]) => ` ${k}="${escapeAttr(v)}"`)
+    .join("");
+// The cursor-driven "load more" control for a paginated ("page" mode) region.
+// It replaces itself (outerHTML) with the next page's rows + the following
+// control, so the list grows in order; it vanishes when there is no next page.
+export const loadMoreButtonHtml = (region, cursor, label = "Load more") => {
+    const attrs = {
+        type: "button",
+        "data-cv-more": "",
+        "hx-get": `${regionBaseUrl(region)}?cursor=${encodeURIComponent(cursor)}`,
+        "hx-target": "this",
+        "hx-swap": "outerHTML",
+    };
+    return `<button${attrsToHtml(attrs)}>${escapeAttr(label)}</button>`;
+};
+const merge = (base, extra) => extra ? { ...base, ...extra } : base;
+export const createRegionContext = (region, opts = {}) => ({
+    regionId: region,
+    container: (extra) => merge({
+        id: containerDomId(region),
+        "data-cv-region": region,
+        "data-cv-sse": regionSubscribeUrl(region),
+        "data-cv-list": regionBaseUrl(region),
+        "data-cv-template": templateDomId(region),
+        "data-cv-mode": opts.mode ?? "live",
+    }, extra),
+    row: (id, extra) => merge({ id: rowDomId(region, id), "data-covara-id": String(id) }, extra),
+    create: (extra) => merge({
+        "hx-post": regionBaseUrl(region),
+        // The new row is inserted once, by the region's live SSE "added" event
+        // (the same path every connected client uses) — so the create response
+        // itself is not swapped in. This avoids a duplicate/phantom row.
+        "hx-swap": "none",
+    }, extra),
+    update: (id, extra) => merge({
+        "hx-patch": regionItemUrl(region, id),
+        "hx-target": `#${rowDomId(region, id)}`,
+        "hx-swap": "outerHTML",
+    }, extra),
+    delete: (id, extra) => merge({
+        "hx-delete": regionItemUrl(region, id),
+        "hx-target": `#${rowDomId(region, id)}`,
+        "hx-swap": "outerHTML",
+    }, extra),
+});
+//# sourceMappingURL=context.js.map

package/dist/htmx/context.js.map

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

package/dist/htmx/forms.d.ts

@@ -0,0 +1,3 @@
+import { type Table } from "drizzle-orm";
+export declare const coerceFormBody: (body: Record<string, unknown>, table: Table) => Record<string, unknown>;
+//# sourceMappingURL=forms.d.ts.map

package/dist/htmx/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/htmx/forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAM1D,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,KAAK,KACX,MAAM,CAAC,MAAM,EAAE,OAAO,CA0BxB,CAAC"}

package/dist/htmx/forms.js

@@ -0,0 +1,32 @@
+import { getTableColumns } from "drizzle-orm";
+// Coerce an htmx form body (all string values) into the shapes the resource's
+// insert/update validation expects, using the table's column data types. Only
+// present keys are coerced (so PATCH keeps partial semantics); unchecked
+// checkboxes are simply absent. Unknown keys pass through unchanged.
+export const coerceFormBody = (body, table) => {
+    const columns = getTableColumns(table);
+    const out = {};
+    for (const [key, value] of Object.entries(body)) {
+        if (typeof File !== "undefined" && value instanceof File)
+            continue;
+        const column = columns[key];
+        if (!column) {
+            out[key] = value;
+            continue;
+        }
+        const str = typeof value === "string" ? value : String(value);
+        switch (column.dataType) {
+            case "number":
+            case "bigint":
+                out[key] = str === "" ? null : Number(str);
+                break;
+            case "boolean":
+                out[key] = str === "on" || str === "true" || str === "1";
+                break;
+            default:
+                out[key] = value;
+        }
+    }
+    return out;
+};
+//# sourceMappingURL=forms.js.map

package/dist/htmx/forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/htmx/forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAc,MAAM,aAAa,CAAC;AAE1D,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAA6B,EAC7B,KAAY,EACa,EAAE;IAC3B,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAA0C,CAAC;IAChF,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI;YAAE,SAAS;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,QAAQ,CAAC;YACd,KAAK,QAAQ;gBACX,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,SAAS;gBACZ,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC;gBACzD,MAAM;YACR;gBACE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/htmx/ids.d.ts

@@ -0,0 +1,11 @@
+export declare const LIVE_PREFIX = "/__covara/live";
+export declare const slugifyPath: (path: string) => string;
+export declare const regionId: (pagePath: string, index: number) => string;
+export declare const domSafeId: (id: string | number) => string;
+export declare const containerDomId: (region: string) => string;
+export declare const templateDomId: (region: string) => string;
+export declare const rowDomId: (region: string, id: string | number) => string;
+export declare const regionBaseUrl: (region: string) => string;
+export declare const regionItemUrl: (region: string, id: string | number) => string;
+export declare const regionSubscribeUrl: (region: string) => string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/htmx/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/htmx/ids.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAI5C,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAM1C,CAAC;AAIF,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,KAAG,MACtB,CAAC;AAItC,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,GAAG,MAAM,KAAG,MACsC,CAAC;AAEvF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAA6B,CAAC;AAE9E,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAA6B,CAAC;AAE7E,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,MAC9B,CAAC;AAGlC,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAAoC,CAAC;AAEpF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,MACN,CAAC;AAE/D,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,MACd,CAAC"}

package/dist/htmx/ids.js

@@ -0,0 +1,27 @@
+// Framework-internal namespace for the htmx endpoints Covara generates from a
+// page's <Live> regions. Mounted alongside the admin UI / OpenAPI under
+// `/__covara`, so it never collides with a user's own routes or a page path.
+export const LIVE_PREFIX = "/__covara/live";
+// Turn a page path into a stable, URL/DOM-safe slug used to build region ids.
+// "/" -> "root", "/todos" -> "todos", "/admin/users" -> "admin-users".
+export const slugifyPath = (path) => {
+    const slug = path
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug.length > 0 ? slug : "root";
+};
+// Deterministic region id: page slug + structural position. Stable across
+// requests/deploys as long as the page's regions keep their order.
+export const regionId = (pagePath, index) => `${slugifyPath(pagePath)}-${index}`;
+// Make an arbitrary resource id safe to embed in a DOM id / CSS selector while
+// staying collision-free (unsafe chars are hex-escaped, not flattened).
+export const domSafeId = (id) => String(id).replace(/[^A-Za-z0-9_-]/g, (ch) => `-x${ch.charCodeAt(0).toString(16)}-`);
+export const containerDomId = (region) => `cv-${region}-list`;
+export const templateDomId = (region) => `cv-${region}-tmpl`;
+export const rowDomId = (region, id) => `cv-${region}-${domSafeId(id)}`;
+// Generated endpoint URLs (what the c.* attribute helpers point at).
+export const regionBaseUrl = (region) => `${LIVE_PREFIX}/${region}`;
+export const regionItemUrl = (region, id) => `${LIVE_PREFIX}/${region}/${encodeURIComponent(String(id))}`;
+export const regionSubscribeUrl = (region) => `${LIVE_PREFIX}/${region}/subscribe`;
+//# sourceMappingURL=ids.js.map

package/dist/htmx/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/htmx/ids.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wEAAwE;AACxE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE5C,8EAA8E;AAC9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE;IAClD,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC,CAAC;AAEF,0EAA0E;AAC1E,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,KAAa,EAAU,EAAE,CAClE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;AAEtC,+EAA+E;AAC/E,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAmB,EAAU,EAAE,CACvD,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,MAAM,OAAO,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,MAAM,OAAO,CAAC;AAE7E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAmB,EAAU,EAAE,CACtE,MAAM,MAAM,IAAI,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AAElC,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC;AAEpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAc,EAAE,EAAmB,EAAU,EAAE,CAC3E,GAAG,WAAW,IAAI,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAU,EAAE,CAC3D,GAAG,WAAW,IAAI,MAAM,YAAY,CAAC"}

package/dist/htmx/index.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "hono";
+export { escapeHtml, escapeAttr } from "../shared/escape.js";
+export { LIVE_PREFIX, slugifyPath, regionId, domSafeId, containerDomId, rowDomId, regionBaseUrl, regionItemUrl, regionSubscribeUrl, } from "./ids.js";
+export { createRegionContext, attrsToHtml } from "./context.js";
+export type { RegionContext, Attrs } from "./context.js";
+export { Live, LiveAggregate } from "./live.js";
+export type { LiveProps, LiveAggregateProps, LiveQuery, Renderable, } from "./live.js";
+export type { PageComponent, PageContext } from "./server.js";
+export declare const htmxBundle: () => string;
+export declare const serveHtmxBundle: () => (c: Context) => Response & import("hono").TypedResponse<string, import("hono/utils/http-status").ContentfulStatusCode, "body">;
+//# sourceMappingURL=index.d.ts.map

package/dist/htmx/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/htmx/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC7C,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,GACX,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK3D,eAAO,MAAM,UAAU,QAAO,MAAiD,CAAC;AAEhF,eAAO,MAAM,eAAe,SAAU,GAAG,OAAO,mHAG/C,CAAC"}

package/dist/htmx/index.js

@@ -0,0 +1,15 @@
+import { htmxScript } from "../ui/html/client/htmx-vendor.js";
+import { covaraRuntimeScript } from "./client/runtime.js";
+export { escapeHtml, escapeAttr } from "../shared/escape.js";
+export { LIVE_PREFIX, slugifyPath, regionId, domSafeId, containerDomId, rowDomId, regionBaseUrl, regionItemUrl, regionSubscribeUrl, } from "./ids.js";
+export { createRegionContext, attrsToHtml } from "./context.js";
+export { Live, LiveAggregate } from "./live.js";
+// The full client bundle (vendored htmx core + the covara live runtime). Served
+// automatically at `/__covara/live/_runtime.js` once a page is registered; this
+// helper lets you serve/inline it yourself if needed.
+export const htmxBundle = () => `${htmxScript}\n${covaraRuntimeScript}`;
+export const serveHtmxBundle = () => (c) => {
+    c.header("Content-Type", "application/javascript; charset=utf-8");
+    return c.body(htmxBundle());
+};
+//# sourceMappingURL=index.js.map

package/dist/htmx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/htmx/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAS7C,gFAAgF;AAChF,gFAAgF;AAChF,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,GAAG,UAAU,KAAK,mBAAmB,EAAE,CAAC;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,CAAC,CAAU,EAAE,EAAE;IAClD,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,uCAAuC,CAAC,CAAC;IAClE,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC"}

package/dist/htmx/live.d.ts

@@ -0,0 +1,39 @@
+import type { HtmlEscapedString } from "hono/utils/html";
+import type { RegionContext } from "./context.js";
+export type Renderable = unknown;
+export interface LiveQuery {
+    filter?: string;
+    orderBy?: string;
+    limit?: number;
+}
+export interface LiveProps<Row extends Record<string, unknown> = Record<string, unknown>> {
+    resource: unknown;
+    query?: LiveQuery;
+    mode?: "live" | "page";
+    moreLabel?: string;
+    idField?: string;
+    create?: (c: RegionContext) => Renderable;
+    container?: (rows: Renderable, c: RegionContext) => Renderable;
+    render: (row: Row, c: RegionContext) => Renderable;
+    empty?: (c: RegionContext) => Renderable;
+}
+export interface LiveAggregateProps {
+    resource: unknown;
+    query?: LiveQuery;
+    groupBy?: string[];
+    render: (data: unknown, c: RegionContext) => Renderable;
+}
+export interface CollectedRegion {
+    index: number;
+    regionId: string;
+    kind: "live" | "aggregate";
+    token: string;
+    props: LiveProps | LiveAggregateProps;
+}
+export declare const collectRegions: (pagePath: string, renderSync: () => string) => {
+    html: string;
+    regions: CollectedRegion[];
+};
+export declare const Live: <Row extends Record<string, unknown> = Record<string, unknown>>(props: LiveProps<Row>) => HtmlEscapedString;
+export declare const LiveAggregate: (props: LiveAggregateProps) => HtmlEscapedString;
+//# sourceMappingURL=live.d.ts.map

package/dist/htmx/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/htmx/live.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/C,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGtF,QAAQ,EAAE,OAAO,CAAC;IAIlB,KAAK,CAAC,EAAE,SAAS,CAAC;IAMlB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,UAAU,CAAC;IAG1C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,KAAK,UAAU,CAAC;IAE/D,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,aAAa,KAAK,UAAU,CAAC;IAEnD,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,UAAU,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,KAAK,UAAU,CAAC;CACzD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,kBAAkB,CAAC;CACvC;AAaD,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,YAAY,MAAM,MAAM,KACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAU5C,CAAC;AAqBF,eAAO,MAAM,IAAI,GAAI,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChF,OAAO,SAAS,CAAC,GAAG,CAAC,KACpB,iBAA+D,CAAC;AAEnE,eAAO,MAAM,aAAa,GAAI,OAAO,kBAAkB,KAAG,iBACtB,CAAC"}

package/dist/htmx/live.js

@@ -0,0 +1,37 @@
+import { raw } from "hono/html";
+import { regionId } from "./ids.js";
+// Render-scoped collector. Safe as a module global because a page render is
+// SYNCHRONOUS: <Live> returns a token string immediately (data fetching happens
+// later, outside JSX), so toString() never yields and no two renders interleave
+// while the collector is set.
+let activeCollector = null;
+export const collectRegions = (pagePath, renderSync) => {
+    const collector = { pagePath, regions: [] };
+    const previous = activeCollector;
+    activeCollector = collector;
+    try {
+        const html = renderSync();
+        return { html, regions: collector.regions };
+    }
+    finally {
+        activeCollector = previous;
+    }
+};
+const registerRegion = (kind, props) => {
+    const collector = activeCollector;
+    if (!collector) {
+        // Rendered outside a page render (e.g. a stray <Live> in a fragment); emit
+        // nothing rather than throwing.
+        return raw("");
+    }
+    const index = collector.regions.length;
+    const rid = regionId(collector.pagePath, index);
+    const token = `<!--cv-region:${rid}-->`;
+    collector.regions.push({ index, regionId: rid, kind, token, props });
+    return raw(token);
+};
+// hono/jsx function components. Returned token is replaced with the region's
+// rendered HTML in the assemble phase (see renderPage).
+export const Live = (props) => registerRegion("live", props);
+export const LiveAggregate = (props) => registerRegion("aggregate", props);
+//# sourceMappingURL=live.js.map

package/dist/htmx/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/htmx/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA8DjC,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,8BAA8B;AAC9B,IAAI,eAAe,GAAqB,IAAI,CAAC;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,UAAwB,EACsB,EAAE;IAChD,MAAM,SAAS,GAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC;IACjC,eAAe,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,eAAe,GAAG,QAAQ,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,IAA6B,EAC7B,KAAqC,EAClB,EAAE;IACrB,MAAM,SAAS,GAAG,eAAe,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,2EAA2E;QAC3E,gCAAgC;QAChC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,iBAAiB,GAAG,KAAK,CAAC;IACxC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,wDAAwD;AACxD,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,KAAqB,EACF,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,KAAkB,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAqB,EAAE,CAC5E,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC"}

package/dist/htmx/page.d.ts

@@ -0,0 +1,14 @@
+import { type CollectedRegion, type Renderable } from "./live.js";
+export interface PageResult {
+    items: Record<string, unknown>[];
+    nextCursor?: string | null;
+    hasMore?: boolean;
+}
+export interface RenderPageOptions {
+    pagePath: string;
+    ctx: unknown;
+    fetchRows: (region: CollectedRegion) => Promise<PageResult>;
+    fetchAggregate?: (region: CollectedRegion) => Promise<unknown>;
+}
+export declare const renderPage: (component: (ctx: any) => Renderable, options: RenderPageOptions) => Promise<string>;
+//# sourceMappingURL=page.d.ts.map

package/dist/htmx/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/htmx/page.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,eAAe,EAGpB,KAAK,UAAU,EAChB,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IAGb,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAwDD,eAAO,MAAM,UAAU,GACrB,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,UAAU,EACnC,SAAS,iBAAiB,KACzB,OAAO,CAAC,MAAM,CAchB,CAAC"}

package/dist/htmx/page.js

@@ -0,0 +1,59 @@
+import { raw } from "hono/html";
+import { attrsToHtml, createRegionContext, loadMoreButtonHtml } from "./context.js";
+import { templateDomId } from "./ids.js";
+import { toHtmlString } from "./render-util.js";
+import { buildRowTemplate } from "./template-gen.js";
+import { collectRegions, } from "./live.js";
+const renderLiveRegion = async (region, options) => {
+    const props = region.props;
+    const mode = props.mode ?? "live";
+    const c = createRegionContext(region.regionId, { mode });
+    const { items, nextCursor, hasMore } = await options.fetchRows(region);
+    let body = items.length > 0
+        ? items.map((row) => toHtmlString(props.render(row, c))).join("")
+        : props.empty
+            ? toHtmlString(props.empty(c))
+            : "";
+    // In "page" mode, append the cursor-driven load-more control inside the
+    // container so it grows in order and the control advances itself.
+    if (mode === "page" && hasMore && nextCursor) {
+        body += loadMoreButtonHtml(region.regionId, nextCursor, props.moreLabel);
+    }
+    const container = props.container
+        ? toHtmlString(props.container(raw(body), c))
+        : `<div${attrsToHtml(c.container())}>${body}</div>`;
+    const create = props.create ? toHtmlString(props.create(c)) : "";
+    // Ship the server-derived row template so the client can render optimistic
+    // rows that match the server's markup (no ghost). Inert until the runtime
+    // uses it; <template> content is not executed by htmx.
+    const template = `<template id="${templateDomId(region.regionId)}">${buildRowTemplate({
+        regionId: region.regionId,
+        props,
+    })}</template>`;
+    return create + container + template;
+};
+const renderAggregateRegion = async (region, options) => {
+    const props = region.props;
+    const c = createRegionContext(region.regionId);
+    const data = options.fetchAggregate ? await options.fetchAggregate(region) : null;
+    // Wrap in a live container: the client connects its SSE and replaces the
+    // inner aggregate fragment whenever the resource changes.
+    return `<div${attrsToHtml(c.container())}>${toHtmlString(props.render(data, c))}</div>`;
+};
+// Render a registered page: a synchronous collect pass gathers the <Live>
+// regions (each leaves a placeholder token), then an async assemble pass fetches
+// each region's data, renders it via the page's own closures, and substitutes
+// the token. Live updates/optimism use the same closures via the generated
+// endpoints, so the markup has a single source of truth.
+export const renderPage = async (component, options) => {
+    const { html, regions } = collectRegions(options.pagePath, () => toHtmlString(component(options.ctx)));
+    let output = html;
+    for (const region of regions) {
+        const replacement = region.kind === "aggregate"
+            ? await renderAggregateRegion(region, options)
+            : await renderLiveRegion(region, options);
+        output = output.replace(region.token, () => replacement);
+    }
+    return output;
+};
+//# sourceMappingURL=page.js.map

package/dist/htmx/page.js.map

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

package/dist/htmx/render-util.d.ts

@@ -0,0 +1,2 @@
+export declare const toHtmlString: (value: unknown) => string;
+//# sourceMappingURL=render-util.d.ts.map

package/dist/htmx/render-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-util.d.ts","sourceRoot":"","sources":["../../src/htmx/render-util.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAU7C,CAAC"}

package/dist/htmx/render-util.js

@@ -0,0 +1,15 @@
+// Coerce a closure return value (string / hono-jsx node / anything with a sync
+// toString) into an HTML string. Throws on async shells — page shells must be
+// synchronous; async data fetching is handled per <Live> region.
+export const toHtmlString = (value) => {
+    if (value === null || value === undefined || value === false)
+        return "";
+    if (typeof value === "string")
+        return value;
+    const out = value.toString();
+    if (out instanceof Promise) {
+        throw new Error("covara/htmx: page components must render synchronously (no async components in the page shell); data fetching is handled per <Live> region");
+    }
+    return String(out);
+};
+//# sourceMappingURL=render-util.js.map

package/dist/htmx/render-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-util.js","sourceRoot":"","sources":["../../src/htmx/render-util.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,iEAAiE;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAU,EAAE;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAI,KAAiC,CAAC,QAAQ,EAAE,CAAC;IAC1D,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,4IAA4I,CAC7I,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC,CAAC"}