@rindle/client 0.1.0-rc.5

package/dist/ssr.d.ts

@@ -0,0 +1,73 @@
+import type { Query } from "./query.ts";
+import type { ColsMap, Schema } from "./schema.ts";
+import { type AssembledNode, type DehydratedState, Store } from "./store.ts";
+import type { Backend, ChangeEvent, Mutation, QueryId, RemoteQuery } from "./types.ts";
+/** A `POST /query` response, as far as the server Store needs it (SSR-DESIGN.md §3.3): the
+ *  assembled rows plus the `cvMin` baseline they reflect. (Matches `@rindle/daemon-client`'s
+ *  `QueryOnceOutput`, but `@rindle/client` stays dependency-free — inject the call.) */
+export interface OneShotResult {
+    rows: AssembledNode[];
+    cvMin?: number;
+}
+/** The one-shot read the server Store calls to preload a query. Two topologies inject different
+ *  fns (SSR-DESIGN.md §6):
+ *
+ *   - **Direct to the daemon** (the trusted tier holds the daemon token): use `ast` —
+ *     `(i) => daemon.query(i)`.
+ *   - **Through the application's API tier** (the authority resolves names → ASTs, the loader never
+ *     sends a raw AST): use `name`/`args` — `(i) => fetch('/api/rindle/read', {name: i.name, args: i.args})`.
+ *
+ *  `ast` is always present (the Store seeds the local view by its `viewKey`); `name`/`args` are
+ *  present when the preloaded query came from `defineQuery`. The Store applies no policy/auth —
+ *  that lives upstream (the daemon, or the API tier's `authorizeQuery`). */
+export type OneShotQueryFn = (input: {
+    ast: unknown;
+    name?: string;
+    args?: unknown;
+    visibilityKey?: string;
+    ttlMs?: number;
+}) => Promise<OneShotResult>;
+/**
+ * A no-op live backend for SSR (SSR-DESIGN.md §6.1): it opens no transport and never streams.
+ * `registerQuery`/`mutate` are inert and no `ChangeEvent` is ever pushed, so every view stays
+ * PENDING — reading its SSR {@link Store.seedAssembled seed} — and, lacking `onResultType`,
+ * reports `complete` (a backend with no server lifecycle leaves every view authoritative).
+ */
+export declare class OneShotBackend implements Backend {
+    registerQuery(_qid: QueryId, _ast: unknown, _remote?: RemoteQuery): void;
+    unregisterQuery(_qid: QueryId): void;
+    mutate(_mutations: Mutation[]): Promise<void>;
+    onEvent(_handler: (queryId: QueryId, event: ChangeEvent) => void): void;
+}
+export interface ServerStoreOptions {
+    /** Performs the one-shot `POST /query` read (e.g. a `@rindle/daemon-client` instance's `query`). */
+    query: OneShotQueryFn;
+    /** Optional RLS/visibility dedup key forwarded to every preload (SSR-DESIGN.md §3.2). The daemon
+     *  scopes the materialization's dedup `QueryKey` by it, so the same AST under two visibility keys
+     *  never shares one pipeline; absent ⇒ the daemon's configured default. */
+    visibilityKey?: string;
+    /** Optional idle TTL (ms) the warm pipeline is left at, forwarded to every preload (SSR-DESIGN.md
+     *  §3.4). The TTL is NOT part of the dedup key, so a shared materialization keeps the LONGEST TTL
+     *  any caller requested (max-wins) — `ttlMs` can extend a query's warm-handoff window, never
+     *  shrink it; absent ⇒ the daemon's default idle TTL. */
+    ttlMs?: number;
+}
+/**
+ * The server-side Store wrapper (SSR-DESIGN.md §6.2). Wraps a {@link Store} over a
+ * {@link OneShotBackend} and adds the loader-phase `preload` plus `dehydrate`. Pass `.store` to
+ * the React `<Rindle>` provider for the synchronous render; return `.dehydrate()` from the loader.
+ */
+export declare class ServerStore<S extends ColsMap> {
+    readonly store: Store<S>;
+    private readonly opts;
+    constructor(schema: Schema<S>, opts: ServerStoreOptions);
+    /** Run the one-shot read for `query` and seed its first-paint snapshot (SSR-DESIGN.md §6.2).
+     *  Call once per query in the route loader, before the synchronous render. */
+    preload(query: Query<any, any, any>): Promise<void>;
+    /** The dehydrated first-paint cache for every preloaded query — embed in the HTML, then
+     *  `store.hydrate(...)` it in the browser. */
+    dehydrate(): DehydratedState;
+}
+/** Construct a {@link ServerStore} — the one-shot REST Store for server-side rendering. */
+export declare function createServerStore<S extends ColsMap>(schema: Schema<S>, opts: ServerStoreOptions): ServerStore<S>;
+//# sourceMappingURL=ssr.d.ts.map

package/dist/ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../src/ssr.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvF;;wFAEwF;AACxF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;4EAU4E;AAC5E,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3F,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IACxE,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IACpC,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAG7C,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;CACxE;AAED,MAAM,WAAW,kBAAkB;IACjC,oGAAoG;IACpG,KAAK,EAAE,cAAc,CAAC;IACtB;;+EAE2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;6DAGyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,OAAO;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;gBAE9B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB;IAKvD;kFAC8E;IACxE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzD;kDAC8C;IAC9C,SAAS,IAAI,eAAe;CAG7B;AAED,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EACjD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,IAAI,EAAE,kBAAkB,GACvB,WAAW,CAAC,CAAC,CAAC,CAEhB"}

package/dist/ssr.js

@@ -0,0 +1,66 @@
+// SSR client integration (SSR-DESIGN.md §6). Server-side render is synchronous, so the data
+// must already be in the cache when the render reads it. The seam is the BACKEND, not the hook:
+//
+//   - Browser: the normal ws-backed Store — retain → lease → subscribe → live.
+//   - Server : a Store over a one-shot REST backend ({@link OneShotBackend}) that never streams.
+//              The route loader `preload`s each query (`POST /query`), which seeds the view for an
+//              instant correct first paint; `dehydrate` serializes those seeds into the HTML; the
+//              browser `store.hydrate(...)`s them and its live `subscribe` reconciles (§5).
+//
+// `useQuery` is byte-for-byte identical in both — only the injected backend (and whether a live
+// subscribe ever happens) differs.
+import { Store } from "./store.js";
+/**
+ * A no-op live backend for SSR (SSR-DESIGN.md §6.1): it opens no transport and never streams.
+ * `registerQuery`/`mutate` are inert and no `ChangeEvent` is ever pushed, so every view stays
+ * PENDING — reading its SSR {@link Store.seedAssembled seed} — and, lacking `onResultType`,
+ * reports `complete` (a backend with no server lifecycle leaves every view authoritative).
+ */
+export class OneShotBackend {
+    registerQuery(_qid, _ast, _remote) { }
+    unregisterQuery(_qid) { }
+    mutate(_mutations) {
+        return Promise.reject(new Error("the SSR one-shot backend is read-only; mutate on the browser store"));
+    }
+    onEvent(_handler) { }
+}
+/**
+ * The server-side Store wrapper (SSR-DESIGN.md §6.2). Wraps a {@link Store} over a
+ * {@link OneShotBackend} and adds the loader-phase `preload` plus `dehydrate`. Pass `.store` to
+ * the React `<Rindle>` provider for the synchronous render; return `.dehydrate()` from the loader.
+ */
+export class ServerStore {
+    store;
+    opts;
+    constructor(schema, opts) {
+        this.store = new Store(schema, new OneShotBackend());
+        this.opts = opts;
+    }
+    /** Run the one-shot read for `query` and seed its first-paint snapshot (SSR-DESIGN.md §6.2).
+     *  Call once per query in the route loader, before the synchronous render. */
+    async preload(query) {
+        const ast = query.ast();
+        // Forward the AST (a direct-to-daemon backend reads it) plus the named identity when this came
+        // from `defineQuery` (an API-tier backend resolves `(name, args)` → AST itself, never trusting
+        // a client AST). The seed is keyed by the AST's `viewKey` either way, so the browser's
+        // `getServerSnapshot` finds it (SSR-DESIGN.md §6.2).
+        const named = typeof query.name === "string" ? { name: query.name, args: query.args } : undefined;
+        const result = await this.opts.query({
+            ast,
+            ...named,
+            visibilityKey: this.opts.visibilityKey,
+            ttlMs: this.opts.ttlMs,
+        });
+        this.store.seedAssembled(ast, result.rows, result.cvMin ?? 0);
+    }
+    /** The dehydrated first-paint cache for every preloaded query — embed in the HTML, then
+     *  `store.hydrate(...)` it in the browser. */
+    dehydrate() {
+        return this.store.dehydrate();
+    }
+}
+/** Construct a {@link ServerStore} — the one-shot REST Store for server-side rendering. */
+export function createServerStore(schema, opts) {
+    return new ServerStore(schema, opts);
+}
+//# sourceMappingURL=ssr.js.map

package/dist/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","sourceRoot":"","sources":["../src/ssr.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,gGAAgG;AAChG,EAAE;AACF,+EAA+E;AAC/E,iGAAiG;AACjG,mGAAmG;AACnG,kGAAkG;AAClG,4FAA4F;AAC5F,EAAE;AACF,gGAAgG;AAChG,mCAAmC;AAInC,OAAO,EAA4C,KAAK,EAAE,MAAM,YAAY,CAAC;AA0B7E;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACzB,aAAa,CAAC,IAAa,EAAE,IAAa,EAAE,OAAqB,IAAS,CAAC;IAC3E,eAAe,CAAC,IAAa,IAAS,CAAC;IACvC,MAAM,CAAC,UAAsB;QAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,CAAC,QAAwD,IAAS,CAAC;CAC3E;AAgBD;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACb,KAAK,CAAW;IACR,IAAI,CAAqB;IAE1C,YAAY,MAAiB,EAAE,IAAwB;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;kFAC8E;IAC9E,KAAK,CAAC,OAAO,CAAC,KAA2B;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,+FAA+F;QAC/F,+FAA+F;QAC/F,uFAAuF;QACvF,qDAAqD;QACrD,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACnC,GAAG;YACH,GAAG,KAAK;YACR,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACtC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC;IAED;kDAC8C;IAC9C,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;CACF;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,IAAwB;IAExB,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,90 @@
+import type { Ast } from "./ast.ts";
+import { type Query, type QueryRoot } from "./query.ts";
+import type { ColsMap, RowOf, Schema } from "./schema.ts";
+import type { Backend, WireValue } from "./types.ts";
+/** One query's SSR snapshot, keyed by its `viewKey` ({@link stableKey} of the AST): the
+ *  pre-projected first-paint `rows` plus the `cvMin` watermark they reflect (SSR-DESIGN.md §6.2).
+ *  Serializable as-is into the HTML — `rows` are already JSON values (json columns parsed). */
+export interface DehydratedQuery {
+    rows: unknown[];
+    cvMin: number;
+}
+/** The whole dehydrated cache: every preloaded query's snapshot, keyed by `viewKey`. The server
+ *  builds it with {@link Store.dehydrate}; the browser seeds it with {@link Store.hydrate}. */
+export type DehydratedState = Record<string, DehydratedQuery>;
+/** A single assembled (nested-by-name) row from `POST /query` (SSR-DESIGN.md §3.3): the cells
+ *  under `cols`, each in-view relationship inlined by its alias (a nested array / object, or a
+ *  scalar for a `countAs` aggregate). {@link Store.assembleSnapshot} converts these to the
+ *  view's projected result shape. */
+export interface AssembledNode {
+    cols: Record<string, WireValue>;
+    [rel: string]: unknown;
+}
+/** The write transaction handed to `store.write(tx => …)`. Rows are objects keyed by column;
+ *  the Store positionalizes them (and stringifies json columns) before the backend sees them. */
+export interface WriteTx<S extends ColsMap> {
+    add<N extends keyof S & string>(table: N, row: RowOf<S[N]>): void;
+    remove<N extends keyof S & string>(table: N, row: RowOf<S[N]>): void;
+    edit<N extends keyof S & string>(table: N, oldRow: RowOf<S[N]>, newRow: RowOf<S[N]>): void;
+}
+export interface CachedQueryView<Q extends Query<any, any, any>> {
+    readonly view: ReturnType<Q["materialize"]>;
+    /** Retain this query's named remote footprint and release it later. Ad-hoc local queries
+     *  return a no-op release function. */
+    retain(query: Q): () => void;
+    destroy(): void;
+}
+export declare class Store<S extends ColsMap> {
+    /** Type-safe query entry: `store.query.issue.where.closed(false).materialize()`. */
+    readonly query: QueryRoot<S>;
+    private readonly schema;
+    private readonly backend;
+    private nextId;
+    private readonly views;
+    private readonly asts;
+    private readonly seeds;
+    constructor(schema: Schema<S>, backend: Backend);
+    /** Materialize any fluent query object. Named queries subscribe remotely by `(name,args)`;
+     *  ad-hoc builder queries are local-only for local-first backends. */
+    materialize<Q extends Query<any, any, any>>(query: Q): ReturnType<Q["materialize"]>;
+    /** True when the backend can retain a remote named query independently from the local
+     *  materialized AST view. React uses this to keep one local view per AST while still sending
+     *  every mounted `(name,args)` lease through the backend. */
+    canRetainRemoteQueries(): boolean;
+    /** Build one local AST view, with remote syncing retained separately through the returned
+     *  handle. This is a lower-level API for UI bindings; ordinary app code should keep using
+     *  `materialize(query)`. */
+    createCachedQueryView<Q extends Query<any, any, any>>(query: Q): CachedQueryView<Q>;
+    /** Apply a batch of mutations (object rows → positional). Resolves when the backend has
+     *  accepted them (local: applied; remote: sent). The resulting view updates flow back via
+     *  the backend's event stream. */
+    write(fn: (tx: WriteTx<S>) => void): Promise<void>;
+    /** Seed a query's first-paint snapshot from a `POST /query` response (server side): convert the
+     *  assembled rows to the view's projected shape and stash them by `viewKey`. A view materialized
+     *  for this AST (during the synchronous render) reads the seed; {@link dehydrate} serializes it. */
+    seedAssembled(ast: Ast, rows: AssembledNode[], cvMin: number): void;
+    /** The dehydrated first-paint cache for every preloaded query — embed it in the HTML and pass it
+     *  to {@link hydrate} in the browser (SSR-DESIGN.md §6.2). */
+    dehydrate(): DehydratedState;
+    /** Seed the browser store from the server's {@link dehydrate} output (SSR-DESIGN.md §6.2): each
+     *  view materialized for a hydrated AST shows these rows until its first live `hello` reconciles. */
+    hydrate(state: DehydratedState): void;
+    /** A query's hydrated first-paint snapshot, by `viewKey` — what React's `getServerSnapshot`
+     *  reads so an SSR render (and the matching client hydration pass) sees the seeded rows without
+     *  opening a subscription. */
+    seedSnapshot(viewKey: string): DehydratedQuery | undefined;
+    /** Convert assembled (nested-by-name) rows (SSR-DESIGN.md §3.3) into the view's projected result
+     *  shape: spread `cols` (parsing json columns), recurse into each relationship by its alias
+     *  (plural → array, `.one()` → object/null, `countAs` → bare scalar). */
+    assembleSnapshot(ast: Ast, rows: AssembledNode[]): unknown[];
+    private assembleNode;
+    private registerMaterialized;
+    private retainRemote;
+    private onEvent;
+    private columns;
+    /** An object row → a positional cell array in the table's column order (json → string). */
+    private positionalize;
+    /** The per-level column types parallel to the WireSchema, so the view parses json columns. */
+    private viewTypes;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAoE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvH;;+FAE+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;+FAC+F;AAC/F,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE9D;;;qCAGqC;AACrC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;iGACiG;AACjG,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,OAAO;IACxC,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACrE,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC5F;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5C;2CACuC;IACvC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,KAAK,CAAC,CAAC,SAAS,OAAO;IAClC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAIhD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;gBAEhD,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO;IAU/C;0EACsE;IACtE,WAAW,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAKnF;;iEAE6D;IAC7D,sBAAsB,IAAI,OAAO;IAOjC;;gCAE4B;IAC5B,qBAAqB,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAcnF;;sCAEkC;IAClC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlD;;wGAEoG;IACpG,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAInE;kEAC8D;IAC9D,SAAS,IAAI,eAAe;IAI5B;yGACqG;IACrG,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIrC;;kCAE8B;IAC9B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;6EAEyE;IACzE,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE;IAI5D,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,OAAO;IAMf,2FAA2F;IAC3F,OAAO,CAAC,aAAa;IASrB,8FAA8F;IAC9F,OAAO,CAAC,SAAS;CAWlB"}

package/dist/store.js

@@ -0,0 +1,225 @@
+// The Store — backend-agnostic glue (WASM-CLIENT-DESIGN.md §2). Holds the typed schema +
+// a `Backend`, exposes `store.query.<table>…materialize()` and `store.write(tx => …)`, and
+// routes the backend's per-query `ChangeEvent` stream into per-query `ArrayView`s.
+//
+// It never knows whether the backend is the in-process WASM engine or a remote server —
+// both speak `registerQuery` / `mutate` / `onEvent`. The Store owns: query-id assignment,
+// building each `ArrayView` (typed from the schema, so json columns parse), dispatching
+// hello/snapshot/batch events, and turning object-shaped writes into positional mutations.
+import { stableKey } from "./key.js";
+import { queries } from "./query.js";
+import { FlatArrayView, SingularView } from "./view.js";
+export class Store {
+    /** Type-safe query entry: `store.query.issue.where.closed(false).materialize()`. */
+    query;
+    schema;
+    backend;
+    nextId = 1;
+    views = new Map();
+    asts = new Map();
+    // SSR seeds (SSR-DESIGN.md §6), keyed by `viewKey`: a view materialized for one of these is
+    // seeded for first paint; a seed is consumed (dropped) the moment its query's first live
+    // `hello` lands, so later mounts don't flash stale SSR data.
+    seeds = new Map();
+    constructor(schema, backend) {
+        this.schema = schema;
+        this.backend = backend;
+        this.backend.onEvent((qid, ev) => this.onEvent(qid, ev));
+        // Route the backend's per-query lifecycle onto its view (`view.resultType`). Backends without a
+        // lifecycle omit `onResultType`, leaving every view `complete`.
+        this.backend.onResultType?.((qid, rt) => this.views.get(qid)?.setResultType(rt));
+        this.query = queries(this.schema, (query) => this.materialize(query));
+    }
+    /** Materialize any fluent query object. Named queries subscribe remotely by `(name,args)`;
+     *  ad-hoc builder queries are local-only for local-first backends. */
+    materialize(query) {
+        const remote = typeof query.name === "string" ? { name: query.name, args: query.args } : undefined;
+        return this.registerMaterialized(query.ast(), remote).view;
+    }
+    /** True when the backend can retain a remote named query independently from the local
+     *  materialized AST view. React uses this to keep one local view per AST while still sending
+     *  every mounted `(name,args)` lease through the backend. */
+    canRetainRemoteQueries() {
+        return (typeof this.backend.retainRemoteQuery === "function" &&
+            typeof this.backend.releaseRemoteQuery === "function");
+    }
+    /** Build one local AST view, with remote syncing retained separately through the returned
+     *  handle. This is a lower-level API for UI bindings; ordinary app code should keep using
+     *  `materialize(query)`. */
+    createCachedQueryView(query) {
+        const { qid, view } = this.registerMaterialized(query.ast(), undefined);
+        let destroyed = false;
+        return {
+            view: view,
+            retain: (nextQuery) => this.retainRemote(nextQuery, qid),
+            destroy: () => {
+                if (destroyed)
+                    return;
+                destroyed = true;
+                view.destroy();
+            },
+        };
+    }
+    /** Apply a batch of mutations (object rows → positional). Resolves when the backend has
+     *  accepted them (local: applied; remote: sent). The resulting view updates flow back via
+     *  the backend's event stream. */
+    write(fn) {
+        const muts = [];
+        const tx = {
+            add: (t, row) => muts.push({ op: "add", table: t, row: this.positionalize(t, row) }),
+            remove: (t, row) => muts.push({ op: "remove", table: t, row: this.positionalize(t, row) }),
+            edit: (t, o, n) => muts.push({ op: "edit", table: t, old: this.positionalize(t, o), new: this.positionalize(t, n) }),
+        };
+        fn(tx);
+        return Promise.resolve(this.backend.mutate(muts));
+    }
+    // --- SSR (SSR-DESIGN.md §6) ---------------------------------------------------
+    /** Seed a query's first-paint snapshot from a `POST /query` response (server side): convert the
+     *  assembled rows to the view's projected shape and stash them by `viewKey`. A view materialized
+     *  for this AST (during the synchronous render) reads the seed; {@link dehydrate} serializes it. */
+    seedAssembled(ast, rows, cvMin) {
+        this.seeds.set(stableKey(ast), { rows: this.assembleSnapshot(ast, rows), cvMin });
+    }
+    /** The dehydrated first-paint cache for every preloaded query — embed it in the HTML and pass it
+     *  to {@link hydrate} in the browser (SSR-DESIGN.md §6.2). */
+    dehydrate() {
+        return Object.fromEntries(this.seeds);
+    }
+    /** Seed the browser store from the server's {@link dehydrate} output (SSR-DESIGN.md §6.2): each
+     *  view materialized for a hydrated AST shows these rows until its first live `hello` reconciles. */
+    hydrate(state) {
+        for (const [key, snap] of Object.entries(state))
+            this.seeds.set(key, snap);
+    }
+    /** A query's hydrated first-paint snapshot, by `viewKey` — what React's `getServerSnapshot`
+     *  reads so an SSR render (and the matching client hydration pass) sees the seeded rows without
+     *  opening a subscription. */
+    seedSnapshot(viewKey) {
+        return this.seeds.get(viewKey);
+    }
+    /** Convert assembled (nested-by-name) rows (SSR-DESIGN.md §3.3) into the view's projected result
+     *  shape: spread `cols` (parsing json columns), recurse into each relationship by its alias
+     *  (plural → array, `.one()` → object/null, `countAs` → bare scalar). */
+    assembleSnapshot(ast, rows) {
+        return rows.map((row) => this.assembleNode(ast, row));
+    }
+    assembleNode(ast, node) {
+        const cols = this.columns(ast.table);
+        const out = {};
+        for (const [name, v] of Object.entries(node.cols ?? {})) {
+            out[name] = cols[name]?.type === "json" && typeof v === "string" ? JSON.parse(v) : v;
+        }
+        for (const sub of ast.related ?? []) {
+            const alias = sub.subquery.alias;
+            if (alias === undefined || !(alias in node))
+                continue;
+            const child = node[alias];
+            if (Array.isArray(child)) {
+                out[alias] = child.map((c) => this.assembleNode(sub.subquery, c));
+            }
+            else if (child !== null && typeof child === "object") {
+                out[alias] = this.assembleNode(sub.subquery, child); // .one() singular
+            }
+            else {
+                out[alias] = child; // a `countAs` scalar aggregate, or a null singular relationship
+            }
+        }
+        return out;
+    }
+    // --- internals ---------------------------------------------------------------
+    registerMaterialized(ast, remote) {
+        const qid = this.nextId++;
+        this.asts.set(qid, ast);
+        // Pre-create the view (PENDING) so `materialize` is synchronous for ANY backend — a remote
+        // backend's `hello` arrives async (the view reads as `[]` until then). A synchronous backend
+        // (wasm/replica) resets it during `registerQuery` below, so it returns already-hydrated.
+        const view = this.views.get(qid) ?? this.views.set(qid, new FlatArrayView()).get(qid);
+        // Wire teardown: `destroy()` must unregister the query from the backend and drop our routing
+        // entry. Otherwise the engine keeps emitting events for the destroyed query and the Store
+        // routes them to the now-empty view — which throws on the next Child/remove ("parent not
+        // found") and, because dispatch is a single loop, aborts delivery to sibling queries too.
+        // This bites whenever a query is re-materialized (e.g. a changed limit/filter rebuilds it).
+        const baseDestroy = view.destroy.bind(view);
+        view.destroy = () => {
+            if (this.views.delete(qid)) {
+                this.asts.delete(qid);
+                this.backend.unregisterQuery(qid);
+            }
+            baseDestroy();
+        };
+        this.backend.registerQuery(qid, ast, remote);
+        // SSR first paint (SSR-DESIGN.md §6): if this AST was preloaded/hydrated, seed the view now.
+        // A synchronous backend (wasm) already reset the view above, so its live data wins and the
+        // seed is inert; an async backend (ws) leaves it PENDING, so the seed shows until `hello`.
+        const seed = this.seeds.get(stableKey(ast));
+        if (seed)
+            view.seed(seed.rows);
+        // A top-level `.one()` (engine-capped to limit 1) unwraps at the result boundary.
+        return { qid, view: ast.one ? new SingularView(view) : view };
+    }
+    retainRemote(query, localQueryId) {
+        const remote = typeof query.name === "string" ? { name: query.name, args: query.args } : undefined;
+        if (!remote || !this.canRetainRemoteQueries())
+            return () => { };
+        const qid = this.nextId++;
+        this.backend.retainRemoteQuery?.(qid, remote, localQueryId);
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            this.backend.releaseRemoteQuery?.(qid);
+        };
+    }
+    onEvent(qid, ev) {
+        if (ev.type === "hello") {
+            const ast = this.asts.get(qid);
+            // First live hello for this view ⇒ retire its SSR seed: the maintained tree now owns the
+            // result, so no future mount of the same query should flash the stale first-paint rows.
+            if (ast)
+                this.seeds.delete(stableKey(ast));
+            const types = ast ? this.viewTypes(ev.schema, ast) : undefined;
+            // Reset the (pre-created or existing) view IN PLACE — first hello OR a re-hydrate (new
+            // epoch) — so the materialized reference the caller holds survives a re-subscribe.
+            const view = this.views.get(qid) ?? this.views.set(qid, new FlatArrayView()).get(qid);
+            view.reset(ev.schema, types);
+        }
+        else if (ev.type === "snapshot") {
+            this.views.get(qid)?.applyChanges(ev.adds);
+        }
+        else {
+            this.views.get(qid)?.applyChanges(ev.events);
+        }
+    }
+    columns(table) {
+        const meta = this.schema.tables[table];
+        if (!meta)
+            throw new Error(`unknown table: ${table}`);
+        return meta.columns;
+    }
+    /** An object row → a positional cell array in the table's column order (json → string). */
+    positionalize(table, obj) {
+        const cols = this.columns(table);
+        return Object.keys(cols).map((name) => {
+            const v = obj[name];
+            if (cols[name].type === "json" && v != null && typeof v === "object")
+                return JSON.stringify(v);
+            return (v ?? null);
+        });
+    }
+    /** The per-level column types parallel to the WireSchema, so the view parses json columns. */
+    viewTypes(ws, ast) {
+        const cols = this.columns(ast.table);
+        const columnTypes = ws.columns.map((name) => cols[name]?.type ?? "string");
+        const rels = {};
+        for (const rel of ws.relationships) {
+            if (!rel.child)
+                continue;
+            const sub = (ast.related ?? []).find((r) => r.subquery.alias === rel.name);
+            if (sub)
+                rels[rel.slot] = this.viewTypes(rel.child, sub.subquery);
+        }
+        return { columnTypes, rels };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,2FAA2F;AAC3F,mFAAmF;AACnF,EAAE;AACF,wFAAwF;AACxF,0FAA0F;AAC1F,wFAAwF;AACxF,2FAA2F;AAG3F,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAkB,aAAa,EAA0B,YAAY,EAAkB,MAAM,WAAW,CAAC;AAuChH,MAAM,OAAO,KAAK;IAChB,oFAAoF;IAC3E,KAAK,CAAe;IAEZ,MAAM,CAAY;IAClB,OAAO,CAAU;IAC1B,MAAM,GAAG,CAAC,CAAC;IACF,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC1C,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChD,4FAA4F;IAC5F,yFAAyF;IACzF,6DAA6D;IAC5C,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE5D,YAAY,MAAiB,EAAE,OAAgB;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QACzD,gGAAgG;QAChG,gEAAgE;QAChE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAiB,CAAC;IACxF,CAAC;IAED;0EACsE;IACtE,WAAW,CAAiC,KAAQ;QAClD,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnG,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,IAAoC,CAAC;IAC7F,CAAC;IAED;;iEAE6D;IAC7D,sBAAsB;QACpB,OAAO,CACL,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,KAAK,UAAU;YACpD,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,KAAK,UAAU,CACtD,CAAC;IACJ,CAAC;IAED;;gCAE4B;IAC5B,qBAAqB,CAAiC,KAAQ;QAC5D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACxE,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,IAAoC;YAC1C,MAAM,EAAE,CAAC,SAAY,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC;YAC3D,OAAO,EAAE,GAAG,EAAE;gBACZ,IAAI,SAAS;oBAAE,OAAO;gBACtB,SAAS,GAAG,IAAI,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;sCAEkC;IAClC,KAAK,CAAC,EAA4B;QAChC,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG;YACT,GAAG,EAAE,CAAC,CAAS,EAAE,GAA4B,EAAE,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,EAAE,CAAC,CAAS,EAAE,GAA4B,EAAE,EAAE,CAClD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACxE,IAAI,EAAE,CAAC,CAAS,EAAE,CAA0B,EAAE,CAA0B,EAAE,EAAE,CAC1E,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC;QAC3B,EAAE,CAAC,EAAE,CAAC,CAAC;QACP,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,iFAAiF;IAEjF;;wGAEoG;IACpG,aAAa,CAAC,GAAQ,EAAE,IAAqB,EAAE,KAAa;QAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;kEAC8D;IAC9D,SAAS;QACP,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;yGACqG;IACrG,OAAO,CAAC,KAAsB;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED;;kCAE8B;IAC9B,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;6EAEyE;IACzE,gBAAgB,CAAC,GAAQ,EAAE,IAAqB;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAEO,YAAY,CAAC,GAAQ,EAAE,IAAmB;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;gBAAE,SAAS;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAkB,CAAC,CAAC,CAAC;YACrF,CAAC;iBAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvD,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAsB,CAAC,CAAC,CAAC,kBAAkB;YAC1F,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,gEAAgE;YACtF,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,gFAAgF;IAExE,oBAAoB,CAC1B,GAAQ,EACR,MAAoB;QAEpB,MAAM,GAAG,GAAY,IAAI,CAAC,MAAM,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,2FAA2F;QAC3F,6FAA6F;QAC7F,yFAAyF;QACzF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACvF,6FAA6F;QAC7F,0FAA0F;QAC1F,yFAAyF;QACzF,0FAA0F;QAC1F,4FAA4F;QAC5F,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,GAAG,EAAE;YAClB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,CAAC;YACD,WAAW,EAAE,CAAC;QAChB,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC7C,6FAA6F;QAC7F,2FAA2F;QAC3F,2FAA2F;QAC3F,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,kFAAkF;QAClF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAEO,YAAY,CAAiC,KAAQ,EAAE,YAAqB;QAClF,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,GAAY,EAAE,EAAe;QAC3C,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/B,yFAAyF;YACzF,wFAAwF;YACxF,IAAI,GAAG;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/D,uFAAuF;YACvF,mFAAmF;YACnF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACvF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,KAAa;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,OAAuD,CAAC;IACtE,CAAC;IAED,2FAA2F;IACnF,aAAa,CAAC,KAAa,EAAE,GAA4B;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/F,OAAO,CAAC,CAAC,IAAI,IAAI,CAAc,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8FAA8F;IACtF,SAAS,CAAC,EAAc,EAAE,GAAQ;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,QAAQ,CAAC,CAAC;QAC3E,MAAM,IAAI,GAA8B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,SAAS;YACzB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3E,IAAI,GAAG;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;CACF"}