@kgdiff/viewer 0.3.0 → 0.5.0

package/dist/prefs.js

@@ -1,5 +1,6 @@
 import { normalizeLocale } from './i18n.js';
-const MODES = ['overlay', 'swipe', 'replay', 'changes'];
+const MODES = ['overlay', 'swipe', 'replay'];
+const SCOPES = ['all', 'changes'];
 const THEMES = ['auto', 'light', 'dark'];
 const PALETTES = ['default', 'colorblind'];
 const CHROMES = ['full', 'none'];
@@ -10,6 +11,14 @@ export const THEME_PREFERENCES = THEMES;
 export function toMode(value) {
     return MODES.includes(value) ? value : null;
 }
+export function toScope(value) {
+    return SCOPES.includes(value) ? value : null;
+}
+/**
+ * Before scopes existed, “changes only” was a fourth mode. Attributes, properties, deep links
+ * and reports may still say `changes`: it means overlay + the `changes` scope.
+ */
+export const LEGACY_CHANGES_MODE = 'changes';
 export function toTheme(value) {
     return THEMES.includes(value) ? value : null;
 }
@@ -35,16 +44,19 @@ export function sanitizeView(view) {
     if (typeof view !== 'object' || view === null)
         return undefined;
     const v = view;
-    const mode = toMode(v.mode);
+    const legacy = v.mode === LEGACY_CHANGES_MODE;
+    const mode = legacy ? 'overlay' : toMode(v.mode);
+    const scope = toScope(v.scope) ?? (legacy && v.scope === undefined ? 'changes' : null);
     const theme = toTheme(v.theme);
     const palette = toPalette(v.palette);
     const locale = toLocale(v.locale);
-    const dropped = ['mode', 'theme', 'palette', 'locale'].filter((k) => v[k] !== undefined && { mode, theme, palette, locale }[k] === null);
+    const dropped = ['mode', 'scope', 'theme', 'palette', 'locale'].filter((k) => v[k] !== undefined && { mode, scope, theme, palette, locale }[k] === null);
     if (dropped.length > 0 && typeof console !== 'undefined') {
         console.warn(`[kgdiff] ignoring invalid report view preferences: ${dropped.join(', ')}`);
     }
     return {
         ...(mode ? { mode } : {}),
+        ...(scope ? { scope } : {}),
         ...(theme ? { theme } : {}),
         ...(palette ? { palette } : {}),
         ...(locale ? { locale } : {}),

package/dist/prefs.js.map

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

package/dist/root.d.ts

@@ -0,0 +1,54 @@
+import { ViewerController } from './controller.js';
+import type { Topic } from './session.js';
+import type { FocusTarget, UiActions, UiContext } from './ui/context.js';
+/** Something the root renders: a region, or the layout itself. */
+export interface Region {
+    update(topics: ReadonlySet<Topic>): void;
+}
+/** What a root provides to the regions that bind to it. */
+export interface ViewerContext {
+    readonly controller: ViewerController;
+    readonly actions: UiActions;
+    /** The element the root's events are dispatched on and its tokens are set on. */
+    readonly host: HTMLElement;
+    /** Render `region` on every notification (in binding order); returns the detach. */
+    attach(region: Region): () => void;
+    target(name: FocusTarget, focus: () => void): () => void;
+    focus(name: FocusTarget): boolean;
+    /** The keyboard map, for a key event that reached the root. */
+    handleKey(e: KeyboardEvent): void;
+}
+export declare const viewerContext: import("./context.js").Context<ViewerContext>;
+export declare class ViewerRoot implements ViewerContext {
+    #private;
+    readonly controller: ViewerController;
+    /** The single polite live region announcing navigation ("Change 3 of 12: …"). */
+    readonly live: HTMLDivElement;
+    readonly host: HTMLElement;
+    readonly actions: UiActions;
+    /**
+     * `host` dispatches the events and computes the tokens set on `shadow` (its shadow root);
+     * `emitted` runs after each event was dispatched.
+     */
+    constructor(host: HTMLElement, shadow: ShadowRoot, actions: UiActions, emitted?: (type: string) => void);
+    /**
+     * Provide the session to the regions and follow the system's color scheme and motion
+     * preference and other tabs' review progress; returns the function that stops it all.
+     */
+    connect(): () => void;
+    attach(region: Region): () => void;
+    target(name: FocusTarget, focus: () => void): () => void;
+    focus(name: FocusTarget): boolean;
+    announce(text: string): void;
+    /** Render every region, never throwing: a failure shows the error state with safe defaults. */
+    render(topics: ReadonlySet<Topic>): void;
+    handleKey(e: KeyboardEvent): void;
+}
+/** The UI context of a region placed in `root` (its shadow tree), bound to `ctx`. */
+export declare function uiContext(ctx: ViewerContext, root: ShadowRoot): UiContext;
+/**
+ * Bind a region to the root nearest `anchor` (an element where the region is placed): `make`
+ * builds it once the root answers, and the root renders it from then on.
+ */
+export declare function bindRegion<R extends Region>(anchor: Element, make: (ui: UiContext) => R): R;
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAYA,OAAO,EAAuB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzE,kEAAkE;AAClE,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,oFAAoF;IACpF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACzD,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IAClC,+DAA+D;IAC/D,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,aAAa,+CAAkD,CAAC;AAQ7E,qBAAa,UAAW,YAAW,aAAa;;IAC9C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,iBAAgF;IAC7F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAM5B;;;OAGG;IACH,YACE,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAiCjC;IAED;;;OAGG;IACH,OAAO,IAAI,MAAM,IAAI,CAsBpB;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAMjC;IAED,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAQvD;IAED,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAIhC;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO3B;IAED,+FAA+F;IAC/F,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAcvC;IAWD,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAuFhC;CACF;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS,CAQzE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAU3F"}

package/dist/root.js

@@ -0,0 +1,265 @@
+import { createContext, provideContext, requestContext } from './context.js';
+import { ViewerController } from './controller.js';
+import { h } from './dom.js';
+import { isTypingTarget, keyAction } from './keyboard.js';
+import { THEME_PREFERENCES } from './prefs.js';
+import { defaultStorage } from './review-store.js';
+import { cancelFrame, nextPaint, requestFrame } from './schedule.js';
+import { stylesheet } from './styles.js';
+import { themeFromStyle, tokenSheet } from './theme.js';
+export const viewerContext = createContext('kgdiff.viewer/1');
+function media(query) {
+    return typeof window !== 'undefined' && typeof window.matchMedia === 'function'
+        ? window.matchMedia(query)
+        : null;
+}
+export class ViewerRoot {
+    controller;
+    /** The single polite live region announcing navigation ("Change 3 of 12: …"). */
+    live = h('div', { class: 'sr-only', 'aria-live': 'polite', 'aria-atomic': 'true' });
+    host;
+    actions;
+    #shadow;
+    #regions = [];
+    #targets = new Map();
+    #renderFailed = false;
+    /**
+     * `host` dispatches the events and computes the tokens set on `shadow` (its shadow root);
+     * `emitted` runs after each event was dispatched.
+     */
+    constructor(host, shadow, actions, emitted) {
+        this.host = host;
+        this.#shadow = shadow;
+        this.actions = actions;
+        const emit = (type, detail) => {
+            host.dispatchEvent(new CustomEvent(type, { detail, bubbles: true, composed: true }));
+            emitted?.(type);
+        };
+        const events = {
+            ready: (stats) => emit('kgdiff-ready', { stats }),
+            select: (hunk, node) => emit('kgdiff-select', { hunk, node }),
+            mode: (mode, scope) => emit('kgdiff-mode', { mode, scope }),
+            review: (hunk, reviewed, progress) => emit('kgdiff-review', { hunk, reviewed, progress }),
+            error: (error) => emit('kgdiff-error', { error }),
+            announce: (text) => this.announce(text),
+            replayEnd: (loop) => emit('kgdiff-replay-end', { loop }),
+        };
+        this.controller = new ViewerController(events, {
+            now: () => (typeof performance !== 'undefined' ? performance.now() : Date.now()),
+            requestFrame,
+            cancelFrame,
+            yieldToPaint: nextPaint,
+            storage: defaultStorage(),
+            // The one place the token set is applied: the canvas then draws with the tokens as
+            // computed on the host (page styles win).
+            theme: (base) => {
+                this.#tokens(base);
+                const view = host.ownerDocument.defaultView;
+                return view ? themeFromStyle(base, view.getComputedStyle(host)) : base;
+            },
+        });
+        this.controller.subscribe((topics) => this.render(topics));
+    }
+    /**
+     * Provide the session to the regions and follow the system's color scheme and motion
+     * preference and other tabs' review progress; returns the function that stops it all.
+     */
+    connect() {
+        const c = this.controller;
+        const stop = [provideContext(this.host, viewerContext, () => this)];
+        const dark = media('(prefers-color-scheme: light)');
+        const motion = media('(prefers-reduced-motion: reduce)');
+        const apply = () => {
+            c.setSystemDark(!(dark?.matches ?? false));
+            c.setReducedMotion(motion?.matches ?? false);
+        };
+        for (const q of [dark, motion]) {
+            q?.addEventListener?.('change', apply);
+            stop.push(() => q?.removeEventListener?.('change', apply));
+        }
+        apply();
+        // Page styles may override tokens now that the host is in the document.
+        c.refreshTheme();
+        const onStorage = (e) => c.syncReview(e.key);
+        window.addEventListener('storage', onStorage);
+        stop.push(() => window.removeEventListener('storage', onStorage));
+        return () => {
+            for (const fn of stop)
+                fn();
+        };
+    }
+    attach(region) {
+        this.#regions.push(region);
+        return () => {
+            const i = this.#regions.indexOf(region);
+            if (i >= 0)
+                this.#regions.splice(i, 1);
+        };
+    }
+    target(name, focus) {
+        const list = this.#targets.get(name) ?? [];
+        this.#targets.set(name, list);
+        list.push(focus);
+        return () => {
+            const i = list.indexOf(focus);
+            if (i >= 0)
+                list.splice(i, 1);
+        };
+    }
+    focus(name) {
+        const focus = this.#targets.get(name)?.at(-1);
+        focus?.();
+        return focus !== undefined;
+    }
+    announce(text) {
+        const live = this.live;
+        live.textContent = '';
+        // A fresh text node in a later task makes screen readers announce repeats too.
+        setTimeout(() => {
+            live.textContent = text;
+        }, 30);
+    }
+    /** Render every region, never throwing: a failure shows the error state with safe defaults. */
+    render(topics) {
+        try {
+            for (const region of this.#regions)
+                region.update(topics);
+            this.#renderFailed = false;
+        }
+        catch (error) {
+            console.error('[kgdiff] render failed:', error);
+            if (this.#renderFailed)
+                return;
+            this.#renderFailed = true;
+            const c = this.controller;
+            c.explicit.clear();
+            c.setThemePreference('auto');
+            c.setPalette('default');
+            c.fail(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /** Apply the token set of `base` (a built-in theme) on the host, in the host's document. */
+    #tokens(base) {
+        const doc = this.host.ownerDocument;
+        const tokens = tokenSheet(base, doc);
+        if (this.#shadow.adoptedStyleSheets[1] !== tokens) {
+            this.#shadow.adoptedStyleSheets = [stylesheet(doc), tokens];
+        }
+    }
+    handleKey(e) {
+        const target = e.composedPath()[0] ?? null;
+        if (isTypingTarget(target))
+            return;
+        const c = this.controller;
+        const action = keyAction(e, c.mode, c.scope);
+        if (!action)
+            return;
+        // Enter / Space on a focused control activate that control.
+        const el = target;
+        if ((e.key === 'Enter' || e.key === ' ') &&
+            el?.closest?.('button, a, summary, [role="radio"], [role="menuitemradio"]')) {
+            return;
+        }
+        if (c.status !== 'ready' && !['help', 'theme', 'sidebar', 'escape'].includes(action.type))
+            return;
+        e.preventDefault();
+        const a = this.actions;
+        switch (action.type) {
+            case 'mode':
+                c.setMode(action.mode);
+                break;
+            case 'scope':
+                c.toggleScope();
+                break;
+            case 'next':
+                c.next();
+                break;
+            case 'prev':
+                c.prev();
+                break;
+            case 'first':
+                c.first();
+                break;
+            case 'last':
+                c.last();
+                break;
+            case 'fly':
+                c.flyToSelection();
+                break;
+            case 'escape':
+                // An active search is cleared first (focus goes back to it).
+                if (c.query) {
+                    c.setQuery('');
+                    this.focus('search');
+                }
+                else
+                    c.clearSelection();
+                break;
+            case 'play-pause':
+                c.togglePlay();
+                break;
+            case 'step':
+                c.stepReplay(action.direction);
+                break;
+            case 'divider':
+                c.setSplit(c.split + action.delta);
+                break;
+            case 'fit':
+                void c.fit();
+                break;
+            case 'zoom':
+                c.zoom(action.direction);
+                break;
+            case 'search':
+                a.focusSearch();
+                break;
+            case 'review':
+                c.toggleReviewed();
+                break;
+            case 'sidebar':
+                a.toggleSidebar();
+                break;
+            case 'theme': {
+                const i = THEME_PREFERENCES.indexOf(c.themePreference);
+                a.setThemePreference(THEME_PREFERENCES[(i + 1) % THEME_PREFERENCES.length]);
+                break;
+            }
+            case 'help':
+                a.openHelp();
+                break;
+            case 'expand':
+                c.expandNearest();
+                break;
+            default:
+                action;
+        }
+    }
+}
+/** The UI context of a region placed in `root` (its shadow tree), bound to `ctx`. */
+export function uiContext(ctx, root) {
+    return {
+        ...ctx.actions,
+        controller: ctx.controller,
+        root,
+        target: (name, focus) => ctx.target(name, focus),
+        focus: (name) => ctx.focus(name),
+    };
+}
+/**
+ * Bind a region to the root nearest `anchor` (an element where the region is placed): `make`
+ * builds it once the root answers, and the root renders it from then on.
+ */
+export function bindRegion(anchor, make) {
+    const bound = {};
+    requestContext(anchor, viewerContext, (ctx) => {
+        if (bound.region)
+            return;
+        bound.region = make(uiContext(ctx, anchor.getRootNode()));
+        ctx.attach(bound.region);
+    });
+    // Phase 1: regions are bound by the layout that owns the root, which answers at once.
+    if (!bound.region)
+        throw new Error('[kgdiff] a region found no root to bind to.');
+    return bound.region;
+}
+//# sourceMappingURL=root.js.map

package/dist/root.js.map

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

package/dist/schedule.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Frames (RFC 0001 §1, Scheduling).
+ *
+ * The session's frame loop runs on animation frames only (`requestFrame`). It pauses where the
+ * browser pauses them, so a looping replay in a background tab costs nothing, and under load it
+ * never draws a frame that is not presented.
+ *
+ * One-off work that must not wait forever races a frame against a timer (`frameOrTimeout`):
+ * the loading steps and the change list's window. A hidden embedding container (an inactive
+ * tab panel, a collapsed notebook output, a background pane) can pause animation frames without
+ * the page reporting itself hidden; with frames alone, loading stalled there.
+ */
+/** One-off work waits at most this long for a frame (ms). */
+export declare const FRAME_TIMEOUT = 32;
+/** The next animation frame (0, and no call, where there are none). */
+export declare function requestFrame(cb: (time: number) => void): number;
+export declare function cancelFrame(id: number): void;
+/** Call `cb` once: on the next animation frame, or after `FRAME_TIMEOUT` ms if none came. */
+export declare function frameOrTimeout(cb: () => void): void;
+/** Resolve once the browser had a chance to paint (between loading steps). */
+export declare function nextPaint(): Promise<void>;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAE/D;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAWnD;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC"}

package/dist/schedule.js

@@ -0,0 +1,41 @@
+/**
+ * Frames (RFC 0001 §1, Scheduling).
+ *
+ * The session's frame loop runs on animation frames only (`requestFrame`). It pauses where the
+ * browser pauses them, so a looping replay in a background tab costs nothing, and under load it
+ * never draws a frame that is not presented.
+ *
+ * One-off work that must not wait forever races a frame against a timer (`frameOrTimeout`):
+ * the loading steps and the change list's window. A hidden embedding container (an inactive
+ * tab panel, a collapsed notebook output, a background pane) can pause animation frames without
+ * the page reporting itself hidden; with frames alone, loading stalled there.
+ */
+/** One-off work waits at most this long for a frame (ms). */
+export const FRAME_TIMEOUT = 32;
+/** The next animation frame (0, and no call, where there are none). */
+export function requestFrame(cb) {
+    return typeof requestAnimationFrame === 'function' ? requestAnimationFrame(cb) : 0;
+}
+export function cancelFrame(id) {
+    if (typeof cancelAnimationFrame === 'function')
+        cancelAnimationFrame(id);
+}
+/** Call `cb` once: on the next animation frame, or after `FRAME_TIMEOUT` ms if none came. */
+export function frameOrTimeout(cb) {
+    let done = false;
+    const run = () => {
+        if (done)
+            return;
+        done = true;
+        cancelFrame(raf);
+        clearTimeout(timer);
+        cb();
+    };
+    const timer = setTimeout(run, FRAME_TIMEOUT);
+    const raf = requestFrame(run);
+}
+/** Resolve once the browser had a chance to paint (between loading steps). */
+export function nextPaint() {
+    return new Promise((resolve) => frameOrTimeout(() => setTimeout(resolve, 0)));
+}
+//# sourceMappingURL=schedule.js.map

package/dist/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,EAA0B;IACrD,OAAO,OAAO,qBAAqB,KAAK,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,IAAI,OAAO,oBAAoB,KAAK,UAAU;QAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,GAAG,GAAG,GAAS,EAAE;QACrB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,WAAW,CAAC,GAAG,CAAC,CAAC;QACjB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,EAAE,EAAE,CAAC;IACP,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC"}