@kgdiff/viewer 0.4.0 → 0.5.0

package/dist/context.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The Web Components community context protocol
+ * (https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md),
+ * without dependencies: how the viewer's regions find the root whose session they show
+ * (RFC 0001 §2).
+ *
+ * A consumer dispatches a `context-request` event (bubbling, composed: it crosses shadow roots
+ * on its way up); the nearest provider of that context answers through the callback and stops
+ * the event. Requests nobody answered reach `document`, where they wait; a provider that
+ * connects later announces itself with `context-provider` and the waiting requests are sent
+ * again, so definition and connection order do not matter. A consumer outside the provider's
+ * subtree sends its request through an element inside it (`via`: the root named by `for`).
+ */
+export interface Context<T> {
+    /**
+     * `Symbol.for(name)`: equal across copies of the library on one page (an IIFE report bundle
+     * next to an ESM build), so a component of one copy finds the root of another. The name is
+     * versioned when the provided value changes incompatibly.
+     */
+    readonly key: symbol;
+    /** Carries the value type only. */
+    readonly __value?: T;
+}
+export declare const createContext: <T>(name: string) => Context<T>;
+export declare class ContextRequestEvent<T> extends Event {
+    readonly context: Context<T>;
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    readonly consumer: Element;
+    readonly callback: (value: T) => void;
+    constructor(context: Context<T>, 
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    consumer: Element, callback: (value: T) => void);
+}
+export declare class ContextProviderEvent<T> extends Event {
+    readonly context: Context<T>;
+    constructor(context: Context<T>);
+}
+/** Ask for `context` for `consumer`, through `via` (an element of the provider's subtree). */
+export declare function requestContext<T>(consumer: Element, context: Context<T>, callback: (value: T) => void, via?: Element | null): void;
+/** Answer requests for `context` reaching `host`; returns the function that stops answering. */
+export declare function provideContext<T>(host: Element, context: Context<T>, value: () => T): () => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,CAAC,CAAgC,CAAC;AAE1F,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,KAAK;IAE7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,OAAO;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IAJvC,YACW,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,0FAA0F;IACjF,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAGtC;CACF;AAED,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,KAAK;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAAxC,YAAqB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAEvC;CACF;AAwCD,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC5B,GAAG,GAAE,OAAO,GAAG,IAAW,GACzB,IAAI,CAGN;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAWhG"}

package/dist/context.js

@@ -0,0 +1,87 @@
+/**
+ * The Web Components community context protocol
+ * (https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md),
+ * without dependencies: how the viewer's regions find the root whose session they show
+ * (RFC 0001 §2).
+ *
+ * A consumer dispatches a `context-request` event (bubbling, composed: it crosses shadow roots
+ * on its way up); the nearest provider of that context answers through the callback and stops
+ * the event. Requests nobody answered reach `document`, where they wait; a provider that
+ * connects later announces itself with `context-provider` and the waiting requests are sent
+ * again, so definition and connection order do not matter. A consumer outside the provider's
+ * subtree sends its request through an element inside it (`via`: the root named by `for`).
+ */
+export const createContext = (name) => ({ key: Symbol.for(name) });
+export class ContextRequestEvent extends Event {
+    context;
+    consumer;
+    callback;
+    constructor(context, 
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    consumer, callback) {
+        super('context-request', { bubbles: true, composed: true });
+        this.context = context;
+        this.consumer = consumer;
+        this.callback = callback;
+    }
+}
+export class ContextProviderEvent extends Event {
+    context;
+    constructor(context) {
+        super('context-provider', { bubbles: true, composed: true });
+        this.context = context;
+    }
+}
+const waiting = new Set();
+let collecting = false;
+/** Keep the requests nobody answered, and send them again when a provider connects. */
+function collect() {
+    if (collecting || typeof document === 'undefined')
+        return;
+    collecting = true;
+    document.addEventListener('context-request', (e) => {
+        // Consumers that left the document since they asked are forgotten, closures and all.
+        for (const w of waiting)
+            if (!w.consumer.isConnected)
+                waiting.delete(w);
+        const r = e;
+        waiting.add({
+            context: r.context,
+            consumer: r.consumer,
+            via: e.composedPath()[0] ?? r.consumer,
+            callback: r.callback,
+        });
+    });
+    document.addEventListener('context-provider', (e) => {
+        const key = e.context.key;
+        for (const w of [...waiting]) {
+            if (w.context.key !== key)
+                continue;
+            waiting.delete(w);
+            // Unanswered again: it waits again on its way through `document`.
+            if (w.consumer.isConnected) {
+                w.via.dispatchEvent(new ContextRequestEvent(w.context, w.consumer, w.callback));
+            }
+        }
+    });
+}
+/** Ask for `context` for `consumer`, through `via` (an element of the provider's subtree). */
+export function requestContext(consumer, context, callback, via = null) {
+    collect();
+    (via ?? consumer).dispatchEvent(new ContextRequestEvent(context, consumer, callback));
+}
+/** Answer requests for `context` reaching `host`; returns the function that stops answering. */
+export function provideContext(host, context, value) {
+    collect();
+    const answer = (e) => {
+        const r = e;
+        if (r.context?.key !== context.key)
+            return;
+        e.stopPropagation();
+        r.callback(value());
+    };
+    host.addEventListener('context-request', answer);
+    host.dispatchEvent(new ContextProviderEvent(context));
+    return () => host.removeEventListener('context-request', answer);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/controller.d.ts

@@ -1,54 +1,29 @@
 /**
- * Viewer state and orchestration, independent of the UI:
+ * The canvas side of the viewer: a `DiffSession` (state, commands, events; `session.ts`) plus
+ * the one view that draws it (RFC 0001 §1: renderer, camera, framing, minimap), behind the
+ * `SessionView` boundary. Phase 3 of the RFC moves this view out into a `StageView` of its own,
+ * so one session can drive several canvases.
  *
- * - load pipeline with progress steps (sources or a precomputed report);
- * - view (mode × scope), selection (with an animated spotlight `emphasis`), family filters,
- *   review progress;
- * - the `changes` scope's focus with expandable collapsed groups (`extendLayout` + scene rebuild);
- * - replay clock driven by one requestAnimationFrame loop that sleeps when idle, with a camera
- *   that follows the playing hunk / chapter unless the user moved it in the last 2 s;
- * - swipe position, hover, theme / palette / locale (rebuilding the scene when they change).
- *
- * The UI subscribes to topic notifications (batched per microtask) and reads public fields.
+ * - draws the session's view state into the renderer (and the minimap, throttled while
+ *   replaying);
+ * - frames what the session asks for in the free part of the canvas, clear of the chrome over
+ *   it (`framing.ts`); the replay camera follows the playing hunk / chapter unless the user
+ *   moved it in the last 2 s;
+ * - fits a new diff once the canvas is laid out, and again on resize with `autoFit`;
+ * - turns canvas hovers and clicks into session commands.
  */
-import type { DiffResult, DiffStats, Locale, Rect, UnionId } from '@kgdiff/core';
-import type { LayoutResult } from '@kgdiff/layout';
+import type { Rect } from '@kgdiff/core';
 import { type Camera } from '@kgdiff/renderer';
-import { type ChangeFamily, type FocusState, type PaletteName, type Scene, type Theme, type ThemeName, type VisualResolver } from '@kgdiff/scene';
 import { type ChromeLayout } from './framing.js';
-import type { LoadOptions, ReportPayload, ReviewState, ThemePreference, ViewerMode, ViewerScope } from './index.js';
-import { type ListModel } from './list-model.js';
-import { type LoadedDiff, type LoadStep } from './pipeline.js';
-import { LEGACY_CHANGES_MODE } from './prefs.js';
-import { ReplayClock } from './replay.js';
-import { type StorageLike } from './review-store.js';
-import { type SearchHit } from './search.js';
-export type Status = 'idle' | 'loading' | 'ready' | 'error';
-export type Topic = 'status' | 'data' | 'mode' | 'selection' | 'filters' | 'review' | 'replay' | 'hover' | 'theme' | 'locale' | 'focus' | 'swipe' | 'overview';
-export interface ControllerHost {
-    ready(stats: DiffStats): void;
-    select(hunk: string | null, node: string | null): void;
-    mode(mode: ViewerMode, scope: ViewerScope): void;
-    review(hunk: string, reviewed: boolean, progress: ReviewState): void;
-    error(error: Error): void;
-    announce(text: string): void;
-    /** Playback reached the end of the replay; `loop`: it starts again after the loop delay. */
-    replayEnd(loop: boolean): void;
-}
+import { DiffSession, type SessionDeps, type SessionHost, type SessionView } from './session.js';
+export type { Preference, Status, Topic } from './session.js';
+export type ControllerHost = SessionHost;
+export type ControllerDeps = SessionDeps;
 export interface FitOptions {
     readonly animate?: boolean;
     /** Room around the content, px (default `FRAME_PADDING`); kept for later automatic fits. */
     readonly padding?: number;
 }
-export interface ControllerDeps {
-    readonly now: () => number;
-    readonly requestFrame: (cb: (time: number) => void) => number;
-    readonly cancelFrame: (id: number) => void;
-    /** Resolves once the browser had a chance to paint (between loading steps). */
-    readonly yieldToPaint: () => Promise<void>;
-    readonly storage: StorageLike | null;
-}
-export type Preference = 'mode' | 'scope' | 'theme' | 'palette' | 'locale';
 /** Camera follow is suppressed this long after the user moved the camera (ms). */
 export declare const USER_CAMERA_GRACE = 2000;
 /** The camera follows when less than this share of the target bounds is in view. */
@@ -61,41 +36,8 @@ export declare const FIT_MAX_ZOOM = 2.5;
 export declare const OVERVIEW_COVERAGE = 0.98;
 /** Share of `bounds` inside `view`, in [0, 1]. */
 export declare function coverage(bounds: Rect, view: Rect): number;
-export declare class ViewerController {
+export declare class ViewerController extends DiffSession implements SessionView {
     #private;
-    status: Status;
-    /** Steps of the current load, in order; `step` is the running one. */
-    steps: LoadStep[];
-    step: LoadStep | null;
-    error: Error | null;
-    data: LoadedDiff | null;
-    layout: LayoutResult | null;
-    scene: Scene | null;
-    resolver: VisualResolver | null;
-    list: ListModel;
-    mode: ViewerMode;
-    scope: ViewerScope;
-    themePreference: ThemePreference;
-    palette: PaletteName;
-    locale: Locale;
-    systemDark: boolean;
-    reducedMotion: boolean;
-    /** Preferences set explicitly by the embedder (a report's `view` does not override them). */
-    readonly explicit: Set<Preference>;
-    selectedHunk: number;
-    selectedNode: number;
-    /** An edge emphasized from the detail panel (drawn as hovered). */
-    pinnedEdge: number;
-    hoverNode: number;
-    hoverEdge: number;
-    hoverGroup: number;
-    readonly families: Set<ChangeFamily>;
-    hops: number;
-    readonly expanded: Set<string>;
-    focus: FocusState | null;
-    clock: ReplayClock | null;
-    split: number;
-    emphasis: number;
     /**
      * Keep the view fitted (embeds without controls): fit again when the canvas is resized unless
      * the user moved the camera since, and at the start of every loop.
@@ -105,21 +47,7 @@ export declare class ViewerController {
     selectOnClick: boolean;
     /** The whole content is in view (the minimap has nothing to add). */
     overview: boolean;
-    constructor(host: ControllerHost, deps: ControllerDeps);
-    subscribe(listener: (topics: ReadonlySet<Topic>) => void): () => void;
-    /** Deliver pending notifications now (also used by tests). */
-    flush(): void;
-    get themeName(): ThemeName;
-    get theme(): Theme;
-    get diff(): DiffResult | null;
-    get hunkCount(): number;
-    isReviewed(hunkId: string): boolean;
-    reviewState(): ReviewState;
-    search(query: string, limit?: number): SearchHit[];
-    load(options: LoadOptions): Promise<void>;
-    loadPayload(payload: ReportPayload): Promise<void>;
-    /** Show an error state (bad payload, failed load). */
-    fail(error: Error): void;
+    constructor(host: SessionHost, deps: SessionDeps);
     attach(stage: HTMLElement, minimapHost: HTMLElement | null): void;
     detach(): void;
     destroy(): void;
@@ -141,108 +69,21 @@ export declare class ViewerController {
     layoutChanged(): void;
     /** The user panned / zoomed: suspend replay camera follow for `USER_CAMERA_GRACE`. */
     noteUserCamera(): void;
-    /** Redraw on the next animation frame. */
-    invalidate(): void;
     /** Resolve the current view and hand it to the renderer (and the minimap). */
     draw(now?: number): void;
-    /** Whether the scope is fixed to `changes` (the layout covers only the changes). */
-    get scopeLocked(): boolean;
-    /** Switch how the versions are compared. The legacy `changes` means overlay + `changes` scope. */
-    setMode(value: ViewerMode | typeof LEGACY_CHANGES_MODE): void;
-    /** Show the whole graph or only the changes, in any mode. */
-    setScope(value: ViewerScope): void;
-    /** Toggle the `changes` scope (key `4`); says why when the scope is locked. */
-    toggleScope(): void;
-    /** Set mode and scope together (one notification, one `kgdiff-mode` event). */
-    setView(mode: ViewerMode, scope: ViewerScope): void;
-    selectHunkById(id: string | null, options?: {
-        fly?: boolean;
-    }): void;
-    /**
-     * Select hunk `h` (scene index; -1 clears). `node` focuses one of its nodes in the detail
-     * panel. `fly` (default true) brings it into view. In replay, seeks to the end of its window.
-     */
-    selectHunk(h: number, options?: {
-        fly?: boolean;
-        node?: number;
-    }): void;
-    /** Select a node: its hunk when it has one, else the node itself. */
-    selectNode(i: number, options?: {
-        fly?: boolean;
-    }): void;
-    clearSelection(): void;
-    next(): void;
-    prev(): void;
-    first(): void;
-    last(): void;
-    /** Emphasize an edge (from the detail panel) and fly to it. */
-    pinEdge(j: number): void;
-    flyToHunk(h: number): void;
-    flyToNode(i: number): void;
-    flyToSelection(): void;
+    sceneChanged(): void;
+    installed(): void;
+    drawnChanged(): void;
+    show(bounds: Rect): void;
+    /** Follow `bounds` (replay): fly unless the user steered recently or it is mostly visible. */
+    follow(bounds: Rect): void;
+    looped(): void;
+    viewport(): Rect | null;
     /**
      * Fit everything visible (the focus in changes-only mode), labels included, into the free part
      * of the canvas. Before the canvas is laid out it falls back to the renderer's own fit.
      */
     fit(options?: FitOptions): Promise<void>;
     zoom(direction: 1 | -1): void;
-    /** Clear hover state (pointer left the canvas). */
-    clearHover(): void;
-    toggleFamily(family: ChangeFamily): void;
-    /** Replace the family filter (empty = all). Setting the current set again clears it. */
-    setFamilies(families: readonly ChangeFamily[]): void;
-    setHops(hops: number): void;
-    /**
-     * Expand collapsed group `index` of the current focus: its in-scene members become visible
-     * and, for a `changes`-scoped layout, the neighbours left out of the layout are placed with
-     * `extendLayout` (nothing already placed moves) and the scene is rebuilt.
-     */
-    expandGroup(index: number): void;
-    /**
-     * The collapsed group nearest the selection (else the view center), or -1. Groups that can
-     * be expanded at least partly come first.
-     */
-    nearestGroup(): number;
-    /** Expand the group nearest the selection (keyboard `e`); announces what happened. */
-    expandNearest(): void;
-    /**
-     * Whether collapsed group `index` can be expanded completely: always, unless some members lie
-     * outside a `changes`-scoped layout and the layout engine is known to be unavailable
-     * (standalone report without the compute add-on).
-     */
-    canExpand(index: number): boolean;
-    /** Bring a union node into the scene and the focus (search results), then select it. */
-    revealNode(id: UnionId): Promise<void>;
-    play(): void;
-    /** Pause; a looping replay stays paused (until `play`, a new diff or loop turned on again). */
-    pause(): void;
-    togglePlay(): void;
-    /**
-     * Play the replay over and over: `delay` ms after it ends it starts again; null plays it
-     * once. Turning the loop on starts a replay that is shown but not playing.
-     */
-    setLoop(delay: number | null): void;
-    get loopDelay(): number | null;
-    /**
-     * Hold playback while the pointer rests on the graph (`pause-on-hover`): a playing replay
-     * pauses and continues on release; a pending loop restart waits for the release, then the
-     * full loop delay.
-     */
-    hold(held: boolean): void;
-    seek(t: number): void;
-    stepReplay(direction: 1 | -1): void;
-    restart(): void;
-    cycleSpeed(): void;
-    setSpeed(speed: number): void;
-    setSplit(split: number): void;
-    setReviewed(hunkId: string, reviewed: boolean): void;
-    /** Another tab changed review progress (`storage` event): re-read it. */
-    syncReview(key: string | null): void;
-    toggleReviewed(hunkId?: string): void;
-    setThemePreference(pref: ThemePreference): void;
-    setPalette(palette: PaletteName): void;
-    setLocale(locale: Locale): void;
-    setSystemDark(dark: boolean): void;
-    setReducedMotion(reduced: boolean): void;
 }
 //# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EAEX,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AACzC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,oFAAoF;AACpF,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,sFAAsF;AACtF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAGhC,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAQtC,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAazD;AAED,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,WAAW;;IACtE;;;OAGG;IACH,OAAO,UAAS;IAChB,qFAAqF;IACrF,aAAa,UAAQ;IACrB,qEAAqE;IACrE,QAAQ,UAAQ;IAyBhB,YAAY,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAI/C;IAID,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAsBhE;IAED,MAAM,IAAI,IAAI,CASb;IAEQ,OAAO,IAAI,IAAI,CAGvB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,YAAY,CAAC,GAAG,IAAI,GAAG,IAAI,CAErD;IAED;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGrC;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI,CAmBpB;IAED,sFAAsF;IACtF,cAAc,IAAI,IAAI,CAGrB;IAID,8EAA8E;IAC9E,IAAI,CAAC,GAAG,SAAc,GAAG,IAAI,CA0B5B;IAED,YAAY,IAAI,IAAI,CAKnB;IAED,SAAS,IAAI,IAAI,CAMhB;IAED,YAAY,IAAI,IAAI,CAGnB;IAED,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAEvB;IAED,8FAA8F;IAC9F,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAKzB;IAED,MAAM,IAAI,IAAI,CAEb;IAED,QAAQ,IAAI,IAAI,GAAG,IAAI,CAEtB;IA8BD;;;OAGG;IACH,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3C;IAqED,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAG5B;CA4CF"}