@pyric/ui 0.1.0-alpha.10

package/dist/events/components/ProposedChangeDiff.d.ts

@@ -0,0 +1,46 @@
+import { type ReactNode } from 'react';
+/**
+ * One field-level change in a staged proposal. A UI-level diff row: the host
+ * adapts its backend diff (e.g. the sandbox's `Divergence[]`) into these so the
+ * component stays decoupled from any backend type.
+ */
+export interface FieldChange {
+    /** Full document path, e.g. `notes/abc123`. */
+    docPath: string;
+    /** The field that changed. */
+    field: string;
+    before: unknown;
+    after: unknown;
+    /** `added` = new field, `removed` = cleared, `changed` = value differs. */
+    kind: 'added' | 'changed' | 'removed';
+}
+/**
+ * An auth user a staged proposal creates (a sign-in account, distinct from
+ * Firestore documents). The host adapts its backend request (e.g. a
+ * `CreateUserRequest`) into this UI-level shape.
+ */
+export interface CreatedAuthUser {
+    uid: string;
+    email?: string;
+    displayName?: string;
+    provider?: string;
+    emailVerified?: boolean;
+}
+export interface ProposedChangeDiffProps {
+    changes: FieldChange[];
+    /** Auth users the proposal creates, shown as a leading "auth users" group. */
+    authUsers?: readonly CreatedAuthUser[];
+    className?: string;
+    /** Rendered when there are no changes. Defaults to nothing. */
+    emptyState?: ReactNode;
+    /** Format a value for display. Default: JSON-ish, empty for `undefined`. */
+    formatValue?: (value: unknown) => ReactNode;
+}
+/**
+ * Headless renderer for a staged change: the documents a proposal touches, with
+ * per-field before/after. Grouped by collection. Ships zero styling; the host
+ * styles the `data-pyric-*` contract (`proposed-change-diff` /
+ * `data-pyric-change-*`). The c-review diff grid is this, styled.
+ */
+export declare function ProposedChangeDiff({ changes, authUsers, className, emptyState, formatValue, }: ProposedChangeDiffProps): import("react").JSX.Element;
+//# sourceMappingURL=ProposedChangeDiff.d.ts.map

package/dist/events/components/ProposedChangeDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProposedChangeDiff.d.ts","sourceRoot":"","sources":["../../../src/events/components/ProposedChangeDiff.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC;CAC7C;AA0DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,SAAc,EACd,SAAS,EACT,UAAiB,EACjB,WAAgC,GACjC,EAAE,uBAAuB,+BA+DzB"}

package/dist/events/components/ProposedChangeDiff.js

@@ -0,0 +1,60 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { truncateVectorsForDisplay } from '../../firestore/index.js';
+function groupChanges(changes) {
+    const byCollection = new Map();
+    for (const change of changes) {
+        const slash = change.docPath.lastIndexOf('/');
+        const collection = slash > 0 ? change.docPath.slice(0, slash) : change.docPath;
+        let docs = byCollection.get(collection);
+        if (!docs) {
+            docs = new Map();
+            byCollection.set(collection, docs);
+        }
+        let fields = docs.get(change.docPath);
+        if (!fields) {
+            fields = [];
+            docs.set(change.docPath, fields);
+        }
+        fields.push(change);
+    }
+    return [...byCollection.entries()].map(([collection, docs]) => ({
+        collection,
+        docs: [...docs.entries()].map(([docPath, fields]) => ({
+            docPath,
+            docId: docPath.slice(docPath.lastIndexOf('/') + 1),
+            fields,
+        })),
+    }));
+}
+/** A one-line account summary: "alice@x.dev · Alice · verified". */
+function formatAuthUser(u) {
+    const parts = [u.email, u.displayName, u.provider, u.emailVerified ? 'verified' : null].filter(Boolean);
+    return parts.length ? parts.join(' · ') : 'new account';
+}
+function defaultFormatValue(value) {
+    if (value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    try {
+        // Truncate vectors so a real embedding never dumps its full array here.
+        return JSON.stringify(truncateVectorsForDisplay(value));
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Headless renderer for a staged change: the documents a proposal touches, with
+ * per-field before/after. Grouped by collection. Ships zero styling; the host
+ * styles the `data-pyric-*` contract (`proposed-change-diff` /
+ * `data-pyric-change-*`). The c-review diff grid is this, styled.
+ */
+export function ProposedChangeDiff({ changes, authUsers = [], className, emptyState = null, formatValue = defaultFormatValue, }) {
+    const groups = useMemo(() => groupChanges(changes), [changes]);
+    if (groups.length === 0 && authUsers.length === 0)
+        return _jsx(_Fragment, { children: emptyState });
+    return (_jsxs("div", { className: className, "data-pyric-ui": "proposed-change-diff", children: [authUsers.length > 0 ? (_jsxs("section", { "data-pyric-change-group": true, "data-pyric-change-authgroup": true, "data-pyric-change-collection": "auth users", children: [_jsxs("header", { "data-pyric-change-grouphead": true, children: [_jsx("span", { "data-pyric-change-collname": true, children: "auth users" }), _jsx("span", { "data-pyric-change-count": true, children: authUsers.length })] }), _jsx("ul", { "data-pyric-change-docs": true, children: authUsers.map((user) => (_jsxs("li", { "data-pyric-change-doc": true, "data-pyric-change-authuser": true, children: [_jsx("span", { "data-pyric-change-docid": true, children: user.uid }), _jsx("span", { "data-pyric-change-authmeta": true, children: formatAuthUser(user) })] }, user.uid))) })] })) : null, groups.map((group) => (_jsxs("section", { "data-pyric-change-group": true, "data-pyric-change-collection": group.collection, children: [_jsxs("header", { "data-pyric-change-grouphead": true, children: [_jsx("span", { "data-pyric-change-collname": true, children: group.collection }), _jsx("span", { "data-pyric-change-count": true, children: group.docs.length })] }), _jsx("ul", { "data-pyric-change-docs": true, children: group.docs.map((doc) => (_jsxs("li", { "data-pyric-change-doc": true, children: [_jsx("span", { "data-pyric-change-docid": true, children: doc.docId }), _jsx("ul", { "data-pyric-change-fields": true, children: doc.fields.map((field) => (_jsxs("li", { "data-pyric-change-field": true, "data-pyric-change-kind": field.kind, children: [_jsx("span", { "data-pyric-change-key": true, children: field.field }), field.kind !== 'added' ? (_jsx("span", { "data-pyric-change-before": true, children: formatValue(field.before) })) : null, _jsx("span", { "data-pyric-change-arrow": true, "aria-hidden": true, children: '→' }), field.kind !== 'removed' ? (_jsx("span", { "data-pyric-change-after": true, children: formatValue(field.after) })) : null] }, field.field))) })] }, doc.docPath))) })] }, group.collection)))] }));
+}
+//# sourceMappingURL=ProposedChangeDiff.js.map

package/dist/events/components/ProposedChangeDiff.js.map

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

package/dist/events/components/format.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default `when`-column formatter: a session-relative duration
+ * (`now` / `12s` / `3m` / `1h`), matching the mock's `c-when` strings.
+ * The grid is session-scoped (see design-ideation "FRAME CORRECTION")
+ * so anchors are relative, never absolute calendar dates.
+ *
+ * Override via `<ActivityGrid formatWhen={...} />` when the host has a
+ * better clock anchor (e.g. a ticking "session now").
+ */
+export declare function defaultFormatWhen(at: number, now?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/events/components/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/events/components/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAW9E"}

package/dist/events/components/format.js

@@ -0,0 +1,26 @@
+/**
+ * Default `when`-column formatter: a session-relative duration
+ * (`now` / `12s` / `3m` / `1h`), matching the mock's `c-when` strings.
+ * The grid is session-scoped (see design-ideation "FRAME CORRECTION")
+ * so anchors are relative, never absolute calendar dates.
+ *
+ * Override via `<ActivityGrid formatWhen={...} />` when the host has a
+ * better clock anchor (e.g. a ticking "session now").
+ */
+export function defaultFormatWhen(at, now = Date.now()) {
+    const deltaMs = Math.max(0, now - at);
+    const s = Math.floor(deltaMs / 1000);
+    if (s < 1)
+        return 'now';
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h`;
+    const d = Math.floor(h / 24);
+    return `${d}d`;
+}
+//# sourceMappingURL=format.js.map

package/dist/events/components/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/events/components/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,GAAG,CAAC;AACjB,CAAC"}

package/dist/events/components/index.d.ts

@@ -0,0 +1,6 @@
+export { ActivityGrid, type ActivityGridProps } from './ActivityGrid.js';
+export { ActivityGridRow, type ActivityGridRowProps, } from './ActivityGridRow.js';
+export { ActivityActionItems, type ActivityActionItemsProps, type ActivityActionItem, } from './ActivityActionItems.js';
+export { ProposedChangeDiff, type ProposedChangeDiffProps, type FieldChange, type CreatedAuthUser, } from './ProposedChangeDiff.js';
+export { defaultFormatWhen } from './format.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/events/components/index.js

@@ -0,0 +1,6 @@
+export { ActivityGrid } from './ActivityGrid.js';
+export { ActivityGridRow, } from './ActivityGridRow.js';
+export { ActivityActionItems, } from './ActivityActionItems.js';
+export { ProposedChangeDiff, } from './ProposedChangeDiff.js';
+export { defaultFormatWhen } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/events/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/events/digest.d.ts

@@ -0,0 +1,167 @@
+/**
+ * The pure activity-digest reducer — folds a `SandboxEvent[]` (the
+ * unified stream) into the banded digest the activity grid renders.
+ *
+ * Kept free of React so it's trivially testable and reusable by a
+ * non-React consumer (a CLI session summary, say). `useActivityDigest`
+ * is a thin `useMemo` wrapper over `computeActivityDigest`.
+ *
+ * The categorization is the product (see
+ * the design rationale): the can't-miss bands are
+ * **denied** (surfaced first, loudly), **added**, **updated**,
+ * **removed**, **signed-in / signed-out**, and the catch-alls. Every
+ * row + band carries provenance (actor / lens / on-behalf-of) so
+ * attribution rides every aggregate, and the band order LEADS with the
+ * highest-consequence category present.
+ */
+import type { ActivityActor, ActivityEvent, ActivityLens, AnyActivityEvent, ActivityService } from './types.js';
+/**
+ * The band a row falls into. `denied` leads; the write bands
+ * (added/updated/removed) and the auth bands (signed-in/signed-out)
+ * follow; `read`, `errored`, and `other` are the long-tail catch-alls.
+ *
+ * - `denied`     — a rules denial (firestore `request` with `result: 'deny'`).
+ * - `errored`    — an operational failure (`request` with `result: 'unsupported'`).
+ * - `added`      — a doc/object created, or a user created.
+ * - `updated`    — a doc/object/user/rtdb path mutated in place.
+ * - `removed`    — a doc/object/user deleted.
+ * - `signed-in`  — an auth sign-in.
+ * - `signed-out` — an auth sign-out.
+ * - `read`       — an allowed firestore read (`get`/`list`).
+ * - `other`      — anything modelled but uncategorized (e.g. an unknown service op).
+ */
+export type ActivityBandKey = 'denied' | 'errored' | 'added' | 'updated' | 'removed' | 'signed-in' | 'signed-out' | 'read' | 'other';
+/**
+ * A single grid row — the projection of one event onto the
+ * `target · change · for · lens · when` column contract from
+ * `c-result.html`. All display-ready strings plus the structured
+ * provenance the host may style on.
+ */
+export interface ActivityRow {
+    /** The originating event's id — stable React key. */
+    id: string;
+    /** `Date.now()` at the op. Drives the `when` column + recency sort. */
+    at: number;
+    /** Which band this row was sorted into. */
+    band: ActivityBandKey;
+    /** True for denials — first-class so hosts flag the row distinctly. */
+    denied: boolean;
+    /** Originating service. */
+    service: ActivityService;
+    /** `target` — what was mutated, in the service's addressing scheme
+     *  (a doc path `notes/3agHoZHZ`, a `uid`, a storage `fullPath`, an
+     *  rtdb path). Empty string when the event has no addressable target. */
+    target: string;
+    /** `change` — a short human description of the mutation
+     *  (`update, owner rule`, `done → true`, `created`, `signed in`). */
+    change: string;
+    /** `for` — the subject the op acted on behalf of: `request.auth.uid`
+     *  for firestore, the affected `uid` for auth, else the acting
+     *  identity. Empty when anonymous / not applicable. */
+    for: string;
+    /** `lens` — the privilege the op ran under, display-ready
+     *  (`app`, `as alice`, `admin`). */
+    lens: string;
+    /** `when` — left undterived here; the grid formats `at` itself, but a
+     *  pre-rendered relative string is offered for headless consumers. */
+    when: string;
+    actor: ActivityActor;
+    authLens: ActivityLens;
+    /** The on-behalf-of subject uid, structured (mirrors `for`). */
+    subjectUid: string | null;
+    /** Agent plan id, when the op was part of a plan. */
+    planId?: string;
+    /** The pivot key this row fell under — set only when the digest was
+     *  computed with `groupBy !== 'none'`. Mirrors the row's `subgroup`. */
+    groupKey?: string;
+    /** The original event, for drill-in. */
+    event: ActivityEvent;
+}
+/**
+ * One category band: a header (`label · count · attribution`) plus its
+ * rows. Mirrors the mock's `.band` + `.r.data` structure.
+ */
+export interface ActivityBand {
+    key: ActivityBandKey;
+    /** Display label — `Denied`, `Added`, `Updated`, … */
+    label: string;
+    /** Total rows in the band (== `rows.length`; explicit for the header). */
+    count: number;
+    /** A short attribution phrase when the band has a dominant actor /
+     *  subject (`all by alice`, `by the app`, `by agent atlas`). Absent
+     *  when attribution is mixed — the header then shows just the count. */
+    attribution?: string;
+    rows: ActivityRow[];
+}
+/**
+ * The banded digest — the activity grid's entire model. Bands are
+ * pre-sorted lead-with-consequence; `denials` is a flat projection of
+ * the consequential rows for the action-items tier.
+ */
+export interface ActivityDigest {
+    /** Bands in render order — highest-consequence first. Empty bands
+     *  omitted. Each band may carry `subgroups` when `groupBy !== 'none'`. */
+    bands: ActivityBandWithGroups[];
+    /** Total rows across all bands (events the digest categorized). */
+    total: number;
+    /** Of those, how many were denials. */
+    deniedCount: number;
+    /**
+     * The denial rows, flat + recency-sorted — the source for the
+     * action-items tier ("4 writes to /notes were denied"). A projection,
+     * not a separate aggregation: these rows also live in the `denied` band.
+     */
+    denials: ActivityRow[];
+}
+/** How rows within each band are pivoted/grouped. */
+export type ActivityGroupBy = 'none' | 'actor' | 'lens' | 'subject' | 'service';
+export interface ActivityDigestOptions {
+    /**
+     * Row order within a band. `recency` (default) is newest-first to
+     * match the mock's `when` column. `chronological` is oldest-first.
+     */
+    order?: 'recency' | 'chronological';
+    /**
+     * Pivot rows within each band by an attribution axis. `'none'`
+     * (default) leaves the band flat. Any other value splits each band's
+     * rows into sub-groups keyed by that axis — surfaced on the row via
+     * `groupKey` and exposed as `band.subgroups`. The flat `rows` are
+     * always present regardless.
+     */
+    groupBy?: ActivityGroupBy;
+    /**
+     * Cap rows kept per band (the mock shows ~3–4 then "N more"). The
+     * digest keeps ALL rows but records the overflow via `band.count` vs
+     * `rows.length`. Set to a number to actually trim `rows`; the header
+     * `count` still reflects the true total. Default: keep all.
+     */
+    rowsPerBand?: number;
+}
+export interface ActivitySubgroup {
+    key: string;
+    count: number;
+    rows: ActivityRow[];
+}
+/**
+ * A band that may carry pivot sub-groups. `subgroups` is populated only
+ * when the digest was computed with `groupBy !== 'none'`; otherwise the
+ * band is flat (`rows` only). `computeActivityDigest` always returns
+ * bands of this shape so consumers can branch on `subgroups` presence.
+ */
+export interface ActivityBandWithGroups extends ActivityBand {
+    /** Present only when `groupBy !== 'none'`. */
+    subgroups?: ActivitySubgroup[];
+}
+/**
+ * Fold a unified event stream into the banded activity digest. PURE —
+ * no React, no clock reads except the injected `now` (defaults to
+ * `Date.now()`, but pass a fixed value in tests for determinism).
+ *
+ * Events the digest doesn't model (listener lifecycle, snapshot
+ * delivery, session boundaries, unknown kinds) are skipped — a full
+ * `SandboxEvent[]` from `sandbox.history()` flows in unfiltered.
+ */
+export declare function computeActivityDigest(events: readonly AnyActivityEvent[], opts?: ActivityDigestOptions & {
+    now?: number;
+}): ActivityDigest;
+//# sourceMappingURL=digest.d.ts.map

package/dist/events/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/events/digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EAIZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,WAAW,GACX,YAAY,GACZ,MAAM,GACN,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,IAAI,EAAE,eAAe,CAAC;IACtB,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,eAAe,CAAC;IAGzB;;6EAEyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf;yEACqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf;;2DAEuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ;wCACoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;0EACsE;IACtE,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;4EACwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;;4EAEwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;8EAC0E;IAC1E,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC;IACpC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgXD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,8CAA8C;IAC9C,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,IAAI,GAAE,qBAAqB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,cAAc,CAiEhB"}