@kgdiff/g6 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,99 @@
+/**
+ * @kgdiff/g6: render kgdiff scenes with AntV G6 v5.
+ *
+ * For teams whose product already uses G6: the same visual language as the
+ * kgdiff viewer (docs/visual-language.md), driven by the same `VisualResolver`,
+ * expressed as G6 data, styles and animations.
+ *
+ *   map.ts         frame → GraphData (pure)
+ *   node.ts        `kgdiff-node`: circle + ring, glow / offset-ring halo, pulse, struck old name
+ *   options.ts     generated G6 options (no G6 theme, hover states, animations)
+ *   controller.ts  view state → frames → setData / draw; replay; LOD; interaction
+ *   replay.ts      replay sampling plan
+ */
+import { Graph } from '@antv/g6';
+import { DiffGraphControllerImpl } from './controller.js';
+import { mapFrame } from './map.js';
+import { registerKgdiffNode } from './node.js';
+/**
+ * Convert a resolved frame into G6 v5 `GraphData`: one node per scene node, one edge per
+ * scene edge (+ glyph edges for merge/move arcs), with positions and fully resolved styles.
+ * Pure; no G6 runtime needed.
+ *
+ * - Ids: `idPrefix + union id` for scene nodes and edges; glyphs
+ *   `idPrefix + 'kgdiff-glyph-' + kind + ':' + JSON([source key, target key])` (keys are union
+ *   ids, or anchor keys; stable across frames, so G6 animates them); anchors
+ *   `idPrefix + 'kgdiff-anchor-' + JSON(key)`; collapsed pills
+ *   `idPrefix + 'kgdiff-collapsed-' + group id`. A collision gets a `#2`, `#3`… suffix.
+ * - `datum.data` is a `KgdiffDatumData`: kind, scene index, hunk, family (flat primitives).
+ * - Edges are `line` or `quadratic` (`curveOffset` from the scene curvature) between the
+ *   frame's endpoint nodes. Glyph arcs become extra edges between the visible nodes whose discs
+ *   hold their endpoints; an end with no drawn node there (a split target before it emerges)
+ *   attaches to an anchor: an invisible, non-interactive point node (`data.kgdiff: 'anchor'`),
+ *   shared by the arcs of a frame. Arcs with both ends on one node are omitted. Pivot dots become
+ *   small non-interactive nodes on their node's outline.
+ * - Sizes the scene gives in px are world units here (exact at zoom 1). Level of detail is
+ *   evaluated at zoom 1: labels / badges / arrowheads whose `minZoom` is above 1 are switched
+ *   off (`createDiffGraph` re-evaluates it at the live zoom).
+ * - Ring, glow, pulse and the struck old name use extra style keys drawn by the `kgdiff-node`
+ *   type that `createDiffGraph` registers; on G6's plain `circle` they are ignored and the halo
+ *   falls back to G6's built-in band.
+ *
+ * Deterministic; O(N + E + glyphs). Does not mutate its inputs.
+ *
+ * @throws KgdiffError(`invalid-input`) when `frame` was not resolved for `scene`.
+ */
+export function toG6Data(scene, frame, options = {}) {
+    return mapFrame(scene, frame, {
+        idPrefix: options.idPrefix ?? '',
+        keepHidden: options.keepHidden ?? false,
+        zoom: 1,
+    }).data;
+}
+const wait = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, Math.max(0, ms));
+});
+/**
+ * Create a G6 graph in `container` that renders `scene`.
+ *
+ * The graph uses no G6 theme (`theme: false`): kgdiff's own encodings, a background plugin in
+ * `theme.canvas.background`, the `kgdiff-node` node type and a private hover state. Each view
+ * change resolves one frame and sends G6 only the difference to the previous one (`addData`,
+ * `updateData` with just the changed style keys, `removeData`) before `graph.draw()`; G6
+ * animates it over `theme.motion.base` (layers, selection, themes) or the timeline (replay).
+ * Calls made while a draw is still running are merged into one update (latest wins). Elements
+ * the caller adds to `graph` are left alone; do not `setData` / `clear` the graph yourself.
+ *
+ * - `options.g6` is merged over the generated options: `behaviors` / `plugins` / `transforms`
+ *   are appended, plain objects merge recursively, other values replace. `animation: false`
+ *   disables every animation (replay still keeps its pace).
+ * - Interaction (`interactive`, default true): zoom-canvas, drag-canvas, hover (stroke + label
+ *   like the native viewer), click a changed element → select its hunk, click an unchanged node
+ *   → select it, click the canvas → clear.
+ * - Level of detail follows the camera: crossing a label / badge / arrow threshold re-maps.
+ * - `selectHunk(i)` spotlights the hunk and pans to its nodes; in the replay layer it seeks to the
+ *   end of the hunk's window. `playReplay({ speed })` (default 1×) resolves every window (every
+ *   chapter in chapter mode) at the end of its spotlight, mid-transform, settle start and end,
+ *   and lets G6 animate between them; the camera pans to units less than 70% in view. It
+ *   resolves when finished or `stop()`ped; `setLayer` / `selectHunk` stop it.
+ *
+ * @throws KgdiffError(`invalid-input`) for invalid arguments (also from the controller's methods,
+ *   which reject at once after `destroy()`; calls still pending at `destroy()` resolve).
+ */
+export async function createDiffGraph(container, scene, options = {}) {
+    registerKgdiffNode();
+    const controller = new DiffGraphControllerImpl(scene, options, {
+        createGraph: (graphOptions) => new Graph(graphOptions),
+        wait,
+        deadline: wait,
+    });
+    try {
+        await controller.start(container);
+    }
+    catch (error) {
+        controller.destroy();
+        throw error;
+    }
+    return controller;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAkB,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAW/C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAY,EACZ,KAAmB,EACnB,OAAO,GAAoB,EAAE;IAE7B,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;QACvC,IAAI,EAAE,CAAC;KACR,CAAC,CAAC,IAAI,CAAC;AACV,CAAC;AAuBD,MAAM,IAAI,GAAG,CAAC,EAAU,EAAiB,EAAE,CACzC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAA+B,EAC/B,KAAY,EACZ,OAAO,GAA2B,EAAE;IAEpC,kBAAkB,EAAE,CAAC;IACrB,MAAM,UAAU,GAAG,IAAI,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE;QAC7D,WAAW,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC;QACtD,IAAI;QACJ,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/locator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Which node is at a point? Glyphs only carry endpoint coordinates, so glyph edges are attached
+ * to the node whose disc contains the endpoint. A uniform grid keeps each query O(1) on average
+ * (O(N) to build, done lazily once per frame and only when the frame has glyphs).
+ */
+import type { NodeVisual } from '@kgdiff/scene';
+export declare class NodeLocator {
+    private readonly nodes;
+    private readonly cells;
+    private readonly size;
+    private readonly reach;
+    /**
+     * @param nodes  frame nodes (positions and radii, world units)
+     * @param accept which node indices may be returned (e.g. visible, present in the output)
+     */
+    constructor(nodes: readonly NodeVisual[], accept: (index: number) => boolean);
+    private key;
+    /**
+     * Index of the accepted node nearest to (x, y) among those within `r + slack` of it, or -1.
+     * Ties go to the lower index, so results are deterministic.
+     */
+    nearest(x: number, y: number, slack: number): number;
+}
+//# sourceMappingURL=locator.d.ts.map

package/dist/locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.d.ts","sourceRoot":"","sources":["../src/locator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,qBAAa,WAAW;IAUpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IATxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B;;;OAGG;IACH,YACmB,KAAK,EAAE,SAAS,UAAU,EAAE,EAC7C,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EAmBnC;IAED,OAAO,CAAC,GAAG;IAIX;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBnD;CACF"}

package/dist/locator.js

@@ -0,0 +1,69 @@
+export class NodeLocator {
+    nodes;
+    cells = new Map();
+    size;
+    reach;
+    /**
+     * @param nodes  frame nodes (positions and radii, world units)
+     * @param accept which node indices may be returned (e.g. visible, present in the output)
+     */
+    constructor(nodes, accept) {
+        this.nodes = nodes;
+        let maxR = 0;
+        const members = [];
+        for (let i = 0; i < nodes.length; i++) {
+            const n = nodes[i];
+            if (!accept(i) || !Number.isFinite(n.x) || !Number.isFinite(n.y))
+                continue;
+            members.push(i);
+            if (n.r > maxR)
+                maxR = n.r;
+        }
+        this.reach = maxR;
+        this.size = Math.max(16, 2 * maxR);
+        for (const i of members) {
+            const n = nodes[i];
+            const key = this.key(Math.floor(n.x / this.size), Math.floor(n.y / this.size));
+            const cell = this.cells.get(key);
+            if (cell === undefined)
+                this.cells.set(key, [i]);
+            else
+                cell.push(i);
+        }
+    }
+    key(ix, iy) {
+        return `${ix}:${iy}`;
+    }
+    /**
+     * Index of the accepted node nearest to (x, y) among those within `r + slack` of it, or -1.
+     * Ties go to the lower index, so results are deterministic.
+     */
+    nearest(x, y, slack) {
+        if (!Number.isFinite(x) || !Number.isFinite(y))
+            return -1;
+        const ix = Math.floor(x / this.size);
+        const iy = Math.floor(y / this.size);
+        const rings = Math.max(1, Math.ceil((this.reach + Math.max(0, slack)) / this.size));
+        let best = -1;
+        let bestD = Number.POSITIVE_INFINITY;
+        for (let dx = -rings; dx <= rings; dx++) {
+            for (let dy = -rings; dy <= rings; dy++) {
+                const cell = this.cells.get(this.key(ix + dx, iy + dy));
+                if (cell === undefined)
+                    continue;
+                for (const i of cell) {
+                    const n = this.nodes[i];
+                    const d = Math.hypot(n.x - x, n.y - y);
+                    if (d > Math.max(0, n.r) + slack)
+                        continue;
+                    if (d < bestD || (d === bestD && i < best)) {
+                        best = i;
+                        bestD = d;
+                    }
+                }
+            }
+        }
+        return best;
+    }
+}
+//# sourceMappingURL=locator.js.map

package/dist/locator.js.map

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

package/dist/map-context.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared state and helpers of one `mapFrame` call (see map.ts): the element metadata type, LOD
+ * and id bookkeeping, and label text resolution.
+ */
+import type { EdgeData, NodeData } from '@antv/g6';
+import type { FrameVisuals, LabelVisual, Scene, Theme } from '@kgdiff/scene';
+import type { NodeLocator } from './locator.js';
+export type NodeStyle = NonNullable<NodeData['style']>;
+export type EdgeStyle = NonNullable<EdgeData['style']>;
+/** Kind of a generated element, stored in `datum.data.kgdiff`. */
+export type ElementKind = 'node' | 'edge' | 'glyph' | 'anchor' | 'collapsed';
+/**
+ * `datum.data` of every generated element. Flat primitives only (G6 compares `data` shallowly).
+ *  - `index`: scene node / edge index; for glyphs the index in `frame.glyphs`; for collapsed
+ *    pills the index in `frame.collapsed`; for anchors (invisible points glyph arcs attach to
+ *    where no node is drawn) the scene node at that point, or -1.
+ *  - `hunk`: index into `scene.hunks` (glyphs: the hunk of their source node, else target), or -1.
+ *  - `label`: the element's plain label (revealed on hover even when the frame hides it).
+ */
+export type KgdiffDatumData = {
+    readonly kgdiff: ElementKind;
+    readonly index: number;
+    readonly hunk: number;
+    readonly family: string;
+    readonly changed: boolean;
+    readonly label: string;
+    readonly glyph: string;
+};
+export interface Ctx {
+    readonly scene: Scene;
+    readonly frame: FrameVisuals;
+    readonly theme: Theme;
+    readonly bg: string;
+    readonly prefix: string;
+    readonly keepHidden: boolean;
+    readonly zoom: number;
+    /** 1 when the node is part of the output. */
+    readonly present: Uint8Array;
+    /** G6 id of every node index (also those left out). */
+    readonly nodeIds: string[];
+    readonly used: Set<string>;
+    readonly lod: Set<number>;
+    /** Drawn nodes, for attaching glyph ends (built lazily). */
+    locator: NodeLocator | null;
+    /** All scene nodes, for naming glyph anchors (built lazily). */
+    anyLocator: NodeLocator | null;
+    /** Anchor key → anchor node id, shared by the glyphs of one frame. */
+    readonly anchors: Map<string, string>;
+    /** Frozen default styles, built once per frame and spread into every element's style. */
+    nodeBase: Readonly<NodeStyle> | null;
+    edgeBase: Readonly<EdgeStyle> | null;
+}
+/** LOD: visible from `minZoom` on; a missing / NaN threshold shows it (native renderer rule). */
+export declare function shown(minZoom: number, zoom: number): boolean;
+export declare function noteLod(ctx: Ctx, minZoom: number): void;
+/** A unique id: `base`, else `base#2`, `base#3`… (deterministic in output order). */
+export declare function claim(ctx: Ctx, base: string): string;
+export interface Text {
+    readonly text: string;
+    readonly show: boolean;
+    readonly fill: string;
+    readonly size: number;
+    readonly weight: number;
+    /** Absolute (owner alpha × label alpha). */
+    readonly opacity: number;
+    readonly strike: boolean;
+    readonly offset: number;
+}
+export declare function text(l: LabelVisual | null, ownerAlpha: number, ctx: Ctx, fallbackSize: number, fallbackColor: string): Text;
+//# sourceMappingURL=map-context.d.ts.map

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

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

package/dist/map-context.js

@@ -0,0 +1,44 @@
+import { finite, unit } from './geometry.js';
+/** LOD: visible from `minZoom` on; a missing / NaN threshold shows it (native renderer rule). */
+export function shown(minZoom, zoom) {
+    return !(zoom < minZoom);
+}
+export function noteLod(ctx, minZoom) {
+    if (minZoom > 0 && Number.isFinite(minZoom))
+        ctx.lod.add(minZoom);
+}
+/** A unique id: `base`, else `base#2`, `base#3`… (deterministic in output order). */
+export function claim(ctx, base) {
+    let id = base;
+    for (let k = 2; ctx.used.has(id); k++)
+        id = `${base}#${k}`;
+    ctx.used.add(id);
+    return id;
+}
+export function text(l, ownerAlpha, ctx, fallbackSize, fallbackColor) {
+    if (l === null) {
+        return {
+            text: '',
+            show: false,
+            fill: fallbackColor,
+            size: fallbackSize,
+            weight: ctx.theme.font.weightRegular,
+            opacity: 0,
+            strike: false,
+            offset: 0,
+        };
+    }
+    noteLod(ctx, l.minZoom);
+    const opacity = unit(ownerAlpha * l.alpha);
+    return {
+        text: l.text,
+        show: l.text.length > 0 && opacity > 0 && shown(l.minZoom, ctx.zoom),
+        fill: l.color,
+        size: finite(l.size, fallbackSize),
+        weight: finite(l.weight, ctx.theme.font.weightRegular),
+        opacity,
+        strike: l.strike,
+        offset: finite(l.offset, 0),
+    };
+}
+//# sourceMappingURL=map-context.js.map

package/dist/map-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-context.js","sourceRoot":"","sources":["../src/map-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAoD7C,iGAAiG;AACjG,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,IAAY;IACjD,OAAO,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAQ,EAAE,OAAe;IAC/C,IAAI,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,KAAK,CAAC,GAAQ,EAAE,IAAY;IAC1C,IAAI,EAAE,GAAG,IAAI,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;IAC3D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,CAAC;AACZ,CAAC;AAcD,MAAM,UAAU,IAAI,CAClB,CAAqB,EACrB,UAAkB,EAClB,GAAQ,EACR,YAAoB,EACpB,aAAqB;IAErB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa;YACpC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC;QACpE,IAAI,EAAE,CAAC,CAAC,KAAK;QACb,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;QACtD,OAAO;QACP,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/map-edge.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Scene edges and glyphs → G6 edge data (glyph arcs) or small nodes (pivot dots); see map.ts
+ * for the conventions.
+ */
+import type { EdgeData, NodeData } from '@antv/g6';
+import type { EdgeVisual, GlyphVisual, SceneEdge } from '@kgdiff/scene';
+import { type Ctx } from './map-context.js';
+export declare function mapEdge(se: SceneEdge, ev: EdgeVisual, ctx: Ctx): EdgeData | null;
+export type GlyphDatum = {
+    readonly node: NodeData;
+} | {
+    readonly edge: EdgeData;
+};
+/**
+ * A glyph as G6 data: pivots become nodes, everything else an edge between the ends' nodes or
+ * anchors (anchor nodes are pushed to `nodes`). Null when the glyph is invisible or degenerate.
+ */
+export declare function mapGlyph(g: GlyphVisual, i: number, ctx: Ctx, nodes: NodeData[]): GlyphDatum | null;
+//# sourceMappingURL=map-edge.d.ts.map

package/dist/map-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-edge.d.ts","sourceRoot":"","sources":["../src/map-edge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAc,SAAS,EAAa,MAAM,eAAe,CAAC;AAiB/F,OAAO,EACL,KAAK,GAAG,EAST,MAAM,kBAAkB,CAAC;AAmN1B,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,QAAQ,GAAG,IAAI,CAkDhF;AAiHD,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEnF;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,WAAW,EACd,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,QAAQ,EAAE,GAChB,UAAU,GAAG,IAAI,CA+DnB"}