@celljs/ta-web 0.0.0-stage → 4.6.0

package/lib/browser/util/diff.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiffUtil = void 0;
+var DiffUtil;
+(function (DiffUtil) {
+    /**
+     * The diff of pi's edit tool (`details.diff`): one line each, `+`, `-` or a space, the padded line
+     * number, a space and the text; `...` between hunks.
+     */
+    function parse(diff) {
+        return diff
+            .split('\n')
+            .filter(line => line.length > 0)
+            .map(line => {
+            const match = /^([+\- ])\s*(\d+) ?(.*)$/.exec(line);
+            if (!match) {
+                return { kind: 'gap', text: line.trim() };
+            }
+            const kind = match[1] === '+' ? 'add' : match[1] === '-' ? 'remove' : 'context';
+            return { kind, line: Number(match[2]), text: match[3] };
+        });
+    }
+    DiffUtil.parse = parse;
+    function stats(lines) {
+        return {
+            added: lines.filter(line => line.kind === 'add').length,
+            removed: lines.filter(line => line.kind === 'remove').length,
+        };
+    }
+    DiffUtil.stats = stats;
+})(DiffUtil || (exports.DiffUtil = DiffUtil = {}));
+//# sourceMappingURL=diff.js.map

package/lib/browser/util/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/browser/util/diff.ts"],"names":[],"mappings":";;;AAOA,IAAiB,QAAQ,CAyBxB;AAzBD,WAAiB,QAAQ;IACrB;;;OAGG;IACH,SAAgB,KAAK,CAAC,IAAY;QAC9B,OAAO,IAAI;aACN,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;aAC/B,GAAG,CAAC,IAAI,CAAC,EAAE;YACR,MAAM,KAAK,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAChF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;IACX,CAAC;IAZe,SAAA,KAAK,QAYpB,CAAA;IAED,SAAgB,KAAK,CAAC,KAAiB;QACnC,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,MAAM;YACvD,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM;SAC/D,CAAC;IACN,CAAC;IALe,SAAA,KAAK,QAKpB,CAAA;AACL,CAAC,EAzBgB,QAAQ,aAAR,QAAQ,GAAR,QAAQ,QAyBxB"}

package/lib/browser/util/diff.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diff.spec.d.ts.map

package/lib/browser/util/diff.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.spec.d.ts","sourceRoot":"","sources":["../../../src/browser/util/diff.spec.ts"],"names":[],"mappings":""}

package/lib/browser/util/diff.spec.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const diff_1 = require("./diff");
+(0, bun_test_1.describe)('DiffUtil', () => {
+    (0, bun_test_1.it)("reads the diff of pi's edit tool", () => {
+        const lines = diff_1.DiffUtil.parse([' 1 keep', '-2 old', '+2 new', '   ...', ' 9 end'].join('\n'));
+        (0, bun_test_1.expect)(lines).toEqual([
+            { kind: 'context', line: 1, text: 'keep' },
+            { kind: 'remove', line: 2, text: 'old' },
+            { kind: 'add', line: 2, text: 'new' },
+            { kind: 'gap', text: '...' },
+            { kind: 'context', line: 9, text: 'end' },
+        ]);
+        (0, bun_test_1.expect)(diff_1.DiffUtil.stats(lines)).toEqual({ added: 1, removed: 1 });
+    });
+    (0, bun_test_1.it)('keeps the indentation of a line', () => {
+        (0, bun_test_1.expect)(diff_1.DiffUtil.parse('+12     indented')[0]).toEqual({ kind: 'add', line: 12, text: '    indented' });
+    });
+});
+//# sourceMappingURL=diff.spec.js.map

package/lib/browser/util/diff.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.spec.js","sourceRoot":"","sources":["../../../src/browser/util/diff.spec.ts"],"names":[],"mappings":";;AAAA,uCAAgD;AAChD,iCAAkC;AAElC,IAAA,mBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;IACtB,IAAA,aAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,eAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7F,IAAA,iBAAM,EAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAClB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;YACxC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;YACrC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE;SAC5C,CAAC,CAAC;QACH,IAAA,iBAAM,EAAC,eAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAA,aAAE,EAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,IAAA,iBAAM,EAAC,eAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/browser/util/frame.d.ts

@@ -0,0 +1,33 @@
+/** What schedules a callback for the next frame, and cancels it: requestAnimationFrame in a page. */
+export interface FrameScheduler {
+    request(callback: () => void): number;
+    cancel(handle: number): void;
+}
+export declare namespace FrameUtil {
+    /**
+     * The listener, called at most once a frame however often the returned function is: a store that
+     * changes many times between two frames costs one render. `cancel` drops a call not made yet.
+     */
+    function coalesce(listener: () => void, scheduler?: FrameScheduler): {
+        call(): void;
+        cancel(): void;
+    };
+    /** Below this distance from the bottom, the view follows what comes in. */
+    const STICK_PX = 80;
+    function atBottom(element: {
+        scrollHeight: number;
+        scrollTop: number;
+        clientHeight: number;
+    }): boolean;
+    /** The room left above a message brought to the top of the view. */
+    const ANCHOR_GAP = 12;
+    /**
+     * Where the view scrolls to show a message at its top (`offset`: from the top of the thread), and how
+     * tall the thread must be at least for it to get there while what answers it is still short.
+     */
+    function anchor(offset: number, viewport: number, gap?: number): {
+        top: number;
+        minHeight: number;
+    };
+}
+//# sourceMappingURL=frame.d.ts.map

package/lib/browser/util/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../../src/browser/util/frame.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAQD,yBAAiB,SAAS,CAAC;IACvB;;;OAGG;IACH,SAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,GAAE,cAAgC,GAAG;QAAE,IAAI,IAAI,IAAI,CAAC;QAAC,MAAM,IAAI,IAAI,CAAA;KAAE,CAgB5H;IAED,2EAA2E;IACpE,MAAM,QAAQ,KAAK,CAAC;IAE3B,SAAgB,QAAQ,CAAC,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAE5G;IAED,oEAAoE;IAC7D,MAAM,UAAU,KAAK,CAAC;IAE7B;;;OAGG;IACH,SAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAG7G;CACJ"}

package/lib/browser/util/frame.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameUtil = void 0;
+/** requestAnimationFrame; a timer of one frame where there is none (tests, workers). */
+const ANIMATION_FRAME = typeof requestAnimationFrame === 'function'
+    ? { request: callback => requestAnimationFrame(callback), cancel: handle => cancelAnimationFrame(handle) }
+    : { request: callback => setTimeout(callback, 16), cancel: handle => clearTimeout(handle) };
+var FrameUtil;
+(function (FrameUtil) {
+    /**
+     * The listener, called at most once a frame however often the returned function is: a store that
+     * changes many times between two frames costs one render. `cancel` drops a call not made yet.
+     */
+    function coalesce(listener, scheduler = ANIMATION_FRAME) {
+        let handle;
+        return {
+            call: () => {
+                handle !== null && handle !== void 0 ? handle : (handle = scheduler.request(() => {
+                    handle = undefined;
+                    listener();
+                }));
+            },
+            cancel: () => {
+                if (handle !== undefined) {
+                    scheduler.cancel(handle);
+                    handle = undefined;
+                }
+            },
+        };
+    }
+    FrameUtil.coalesce = coalesce;
+    /** Below this distance from the bottom, the view follows what comes in. */
+    FrameUtil.STICK_PX = 80;
+    function atBottom(element) {
+        return element.scrollHeight - element.scrollTop - element.clientHeight < FrameUtil.STICK_PX;
+    }
+    FrameUtil.atBottom = atBottom;
+    /** The room left above a message brought to the top of the view. */
+    FrameUtil.ANCHOR_GAP = 12;
+    /**
+     * Where the view scrolls to show a message at its top (`offset`: from the top of the thread), and how
+     * tall the thread must be at least for it to get there while what answers it is still short.
+     */
+    function anchor(offset, viewport, gap = FrameUtil.ANCHOR_GAP) {
+        const top = Math.max(0, offset - gap);
+        return { top, minHeight: top + viewport };
+    }
+    FrameUtil.anchor = anchor;
+})(FrameUtil || (exports.FrameUtil = FrameUtil = {}));
+//# sourceMappingURL=frame.js.map

package/lib/browser/util/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../../src/browser/util/frame.ts"],"names":[],"mappings":";;;AAMA,wFAAwF;AACxF,MAAM,eAAe,GACjB,OAAO,qBAAqB,KAAK,UAAU;IACvC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE;IAC1G,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAsB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AAEzH,IAAiB,SAAS,CAyCzB;AAzCD,WAAiB,SAAS;IACtB;;;OAGG;IACH,SAAgB,QAAQ,CAAC,QAAoB,EAAE,SAAS,GAAmB,eAAe;QACtF,IAAI,MAA0B,CAAC;QAC/B,OAAO;YACH,IAAI,EAAE,GAAG,EAAE;gBACP,MAAM,aAAN,MAAM,cAAN,MAAM,IAAN,MAAM,GAAK,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC9B,MAAM,GAAG,SAAS,CAAC;oBACnB,QAAQ,EAAE,CAAC;gBACf,CAAC,CAAC,EAAC;YACP,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACT,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACzB,MAAM,GAAG,SAAS,CAAC;gBACvB,CAAC;YACL,CAAC;SACJ,CAAC;IACN,CAAC;IAhBe,UAAA,QAAQ,WAgBvB,CAAA;IAED,2EAA2E;IAC9D,kBAAQ,GAAG,EAAE,CAAC;IAE3B,SAAgB,QAAQ,CAAC,OAA0E;QAC/F,OAAO,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,kBAAQ,CAAC;IACtF,CAAC;IAFe,UAAA,QAAQ,WAEvB,CAAA;IAED,oEAAoE;IACvD,oBAAU,GAAG,EAAE,CAAC;IAE7B;;;OAGG;IACH,SAAgB,MAAM,CAAC,MAAc,EAAE,QAAgB,EAAE,GAAG,GAAG,oBAAU;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC;IAC9C,CAAC;IAHe,UAAA,MAAM,SAGrB,CAAA;AACL,CAAC,EAzCgB,SAAS,aAAT,SAAS,GAAT,SAAS,QAyCzB"}

package/lib/browser/util/frame.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frame.spec.d.ts.map

package/lib/browser/util/frame.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.spec.d.ts","sourceRoot":"","sources":["../../../src/browser/util/frame.spec.ts"],"names":[],"mappings":""}

package/lib/browser/util/frame.spec.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const frame_1 = require("./frame");
+function frames() {
+    const callbacks = new Map();
+    let next = 1;
+    return {
+        request: callback => {
+            callbacks.set(next, callback);
+            return next++;
+        },
+        cancel: handle => void callbacks.delete(handle),
+        run: () => {
+            const due = [...callbacks.values()];
+            callbacks.clear();
+            for (const callback of due) {
+                callback();
+            }
+        },
+        pending: () => callbacks.size,
+    };
+}
+(0, bun_test_1.describe)('FrameUtil', () => {
+    (0, bun_test_1.it)('calls the listener once a frame, however often it is asked to', () => {
+        const scheduler = frames();
+        let calls = 0;
+        const { call } = frame_1.FrameUtil.coalesce(() => calls++, scheduler);
+        call();
+        call();
+        call();
+        (0, bun_test_1.expect)(scheduler.pending()).toBe(1);
+        scheduler.run();
+        (0, bun_test_1.expect)(calls).toBe(1);
+        call();
+        scheduler.run();
+        (0, bun_test_1.expect)(calls).toBe(2);
+    });
+    (0, bun_test_1.it)('drops a call not made yet when cancelled', () => {
+        const scheduler = frames();
+        let calls = 0;
+        const { call, cancel } = frame_1.FrameUtil.coalesce(() => calls++, scheduler);
+        call();
+        cancel();
+        scheduler.run();
+        (0, bun_test_1.expect)(calls).toBe(0);
+        call();
+        scheduler.run();
+        (0, bun_test_1.expect)(calls).toBe(1);
+    });
+    (0, bun_test_1.it)('tells whether a view is at its bottom', () => {
+        (0, bun_test_1.expect)(frame_1.FrameUtil.atBottom({ scrollHeight: 1000, scrollTop: 600, clientHeight: 380 })).toBe(true);
+        (0, bun_test_1.expect)(frame_1.FrameUtil.atBottom({ scrollHeight: 1000, scrollTop: 400, clientHeight: 380 })).toBe(false);
+    });
+    (0, bun_test_1.it)('brings a message to the top of the view, with the room below it that its answer will fill', () => {
+        (0, bun_test_1.expect)(frame_1.FrameUtil.anchor(500, 800)).toEqual({ top: 488, minHeight: 1288 });
+        (0, bun_test_1.expect)(frame_1.FrameUtil.anchor(4, 800)).toEqual({ top: 0, minHeight: 800 });
+    });
+});
+//# sourceMappingURL=frame.spec.js.map

package/lib/browser/util/frame.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.spec.js","sourceRoot":"","sources":["../../../src/browser/util/frame.spec.ts"],"names":[],"mappings":";;AAAA,uCAAgD;AAChD,mCAAyD;AAEzD,SAAS,MAAM;IACX,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAChD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO;QACH,OAAO,EAAE,QAAQ,CAAC,EAAE;YAChB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO,IAAI,EAAE,CAAC;QAClB,CAAC;QACD,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/C,GAAG,EAAE,GAAG,EAAE;YACN,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YACpC,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;gBACzB,QAAQ,EAAE,CAAC;YACf,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI;KAChC,CAAC;AACN,CAAC;AAED,IAAA,mBAAQ,EAAC,WAAW,EAAE,GAAG,EAAE;IACvB,IAAA,aAAE,EAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,IAAA,iBAAM,EAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,SAAS,CAAC,GAAG,EAAE,CAAC;QAChB,IAAA,iBAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,EAAE,CAAC;QACP,SAAS,CAAC,GAAG,EAAE,CAAC;QAChB,IAAA,iBAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,IAAA,aAAE,EAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;QACtE,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,SAAS,CAAC,GAAG,EAAE,CAAC;QAChB,IAAA,iBAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,EAAE,CAAC;QACP,SAAS,CAAC,GAAG,EAAE,CAAC;QAChB,IAAA,iBAAM,EAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,IAAA,aAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,IAAA,iBAAM,EAAC,iBAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjG,IAAA,iBAAM,EAAC,iBAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;IAEH,IAAA,aAAE,EAAC,2FAA2F,EAAE,GAAG,EAAE;QACjG,IAAA,iBAAM,EAAC,iBAAS,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAA,iBAAM,EAAC,iBAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/browser/util/layout.d.ts

@@ -0,0 +1,27 @@
+import type { StateSpec } from '../state/state-protocol';
+/** A column of the page whose width the user drags. */
+export interface PaneSpec {
+    /** Its width is kept in this browser as `layout.<key>` (TaState, `device`). */
+    key: string;
+    initial: number;
+    min: number;
+    max: number;
+}
+export interface PaneState {
+    size: number;
+    collapsed: boolean;
+}
+/** `start`: the pane is before its sash, so dragging towards the end widens it. `end`: after it. */
+export type PaneSide = 'start' | 'end';
+export declare namespace LayoutUtil {
+    function clamp(size: number, spec: PaneSpec): number;
+    /** The pane after dragging its sash by `delta` pixels from where its width was `start`. */
+    function drag(start: number, delta: number, side: PaneSide, spec: PaneSpec): PaneState;
+    /** The width after a key on the focused sash; undefined for a key that does not move it. */
+    function key(size: number, key: string, shift: boolean, side: PaneSide, spec: PaneSpec): number | undefined;
+    /** What was kept, within the bounds; undefined for what is not a width (not ours, or from an older version). */
+    function parse(value: unknown, spec: PaneSpec): PaneState | undefined;
+    /** Where the width of the pane is kept: in this browser, which has its own screen. */
+    function state(spec: PaneSpec): StateSpec<PaneState>;
+}
+//# sourceMappingURL=layout.d.ts.map

package/lib/browser/util/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/browser/util/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,uDAAuD;AACvD,MAAM,WAAW,QAAQ;IACrB,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAOvC,yBAAiB,UAAU,CAAC;IACxB,SAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE1D;IAED,2FAA2F;IAC3F,SAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAM5F;IAED,4FAA4F;IAC5F,SAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAgBjH;IAED,gHAAgH;IAChH,SAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAM3E;IAED,sFAAsF;IACtF,SAAgB,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAE1D;CACJ"}

package/lib/browser/util/layout.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutUtil = void 0;
+/** Dragged narrower than this share of its minimum, a pane collapses. */
+const COLLAPSE_AT = 0.5;
+/** Pixels an arrow key moves a sash; with Shift, four times as many. */
+const STEP = 16;
+var LayoutUtil;
+(function (LayoutUtil) {
+    function clamp(size, spec) {
+        return Math.round(Math.min(spec.max, Math.max(spec.min, size)));
+    }
+    LayoutUtil.clamp = clamp;
+    /** The pane after dragging its sash by `delta` pixels from where its width was `start`. */
+    function drag(start, delta, side, spec) {
+        const size = start + (side === 'start' ? delta : -delta);
+        if (size < spec.min * COLLAPSE_AT) {
+            return { size: clamp(start, spec), collapsed: true };
+        }
+        return { size: clamp(size, spec), collapsed: false };
+    }
+    LayoutUtil.drag = drag;
+    /** The width after a key on the focused sash; undefined for a key that does not move it. */
+    function key(size, key, shift, side, spec) {
+        const step = shift ? STEP * 4 : STEP;
+        const grow = side === 'start' ? 'ArrowRight' : 'ArrowLeft';
+        const shrink = side === 'start' ? 'ArrowLeft' : 'ArrowRight';
+        switch (key) {
+            case grow:
+                return clamp(size + step, spec);
+            case shrink:
+                return clamp(size - step, spec);
+            case 'Home':
+                return spec.min;
+            case 'End':
+                return spec.max;
+            default:
+                return undefined;
+        }
+    }
+    LayoutUtil.key = key;
+    /** What was kept, within the bounds; undefined for what is not a width (not ours, or from an older version). */
+    function parse(value, spec) {
+        const stored = value;
+        if (stored && typeof stored === 'object' && typeof stored.size === 'number' && Number.isFinite(stored.size)) {
+            return { size: clamp(stored.size, spec), collapsed: stored.collapsed === true };
+        }
+        return undefined;
+    }
+    LayoutUtil.parse = parse;
+    /** Where the width of the pane is kept: in this browser, which has its own screen. */
+    function state(spec) {
+        return { key: `layout.${spec.key}`, tier: 'device', initial: { size: spec.initial, collapsed: false }, parse: value => parse(value, spec) };
+    }
+    LayoutUtil.state = state;
+})(LayoutUtil || (exports.LayoutUtil = LayoutUtil = {}));
+//# sourceMappingURL=layout.js.map

package/lib/browser/util/layout.js.map

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

package/lib/browser/util/layout.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layout.spec.d.ts.map

package/lib/browser/util/layout.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.spec.d.ts","sourceRoot":"","sources":["../../../src/browser/util/layout.spec.ts"],"names":[],"mappings":""}

package/lib/browser/util/layout.spec.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const bun_test_1 = require("bun:test");
+const layout_1 = require("./layout");
+const SIDE = { key: 'side', initial: 260, min: 200, max: 480 };
+(0, bun_test_1.describe)('LayoutUtil', () => {
+    (0, bun_test_1.it)('follows the drag within the bounds, on either side of the sash', () => {
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(260, 40, 'start', SIDE)).toEqual({ size: 300, collapsed: false });
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(260, 40, 'end', SIDE)).toEqual({ size: 220, collapsed: false });
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(260, 900, 'start', SIDE)).toEqual({ size: 480, collapsed: false });
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(260, -100, 'start', SIDE)).toEqual({ size: 200, collapsed: false });
+    });
+    (0, bun_test_1.it)('collapses a pane dragged far below its minimum, keeping its width for when it opens again', () => {
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(300, -250, 'start', SIDE)).toEqual({ size: 300, collapsed: true });
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.drag(300, 250, 'end', SIDE)).toEqual({ size: 300, collapsed: true });
+    });
+    (0, bun_test_1.it)('moves the sash with arrow keys, and to the bounds with Home and End', () => {
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'ArrowRight', false, 'start', SIDE)).toBe(276);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'ArrowRight', true, 'start', SIDE)).toBe(324);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'ArrowRight', false, 'end', SIDE)).toBe(244);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(210, 'ArrowLeft', true, 'start', SIDE)).toBe(200);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'Home', false, 'start', SIDE)).toBe(200);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'End', false, 'end', SIDE)).toBe(480);
+        (0, bun_test_1.expect)(layout_1.LayoutUtil.key(260, 'Enter', false, 'start', SIDE)).toBeUndefined();
+    });
+    (0, bun_test_1.it)('keeps the width in this browser, and reads back only a width within the bounds', () => {
+        const spec = layout_1.LayoutUtil.state(SIDE);
+        (0, bun_test_1.expect)(spec).toMatchObject({ key: 'layout.side', tier: 'device', initial: { size: 260, collapsed: false } });
+        (0, bun_test_1.expect)(spec.parse({ size: 333, collapsed: true })).toEqual({ size: 333, collapsed: true });
+        (0, bun_test_1.expect)(spec.parse({ size: 9999 })).toEqual({ size: 480, collapsed: false });
+        (0, bun_test_1.expect)(spec.parse('not json')).toBeUndefined();
+        (0, bun_test_1.expect)(spec.parse(null)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=layout.spec.js.map

package/lib/browser/util/layout.spec.js.map

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

package/lib/browser/util/link.d.ts

@@ -0,0 +1,54 @@
+import type { TextSelection } from '../extension/web-extension-api';
+/** What a link of a reply points to, as written: a page of the web, a mail, or a path on the machine of the conversation. */
+export type LinkTarget = {
+    type: 'url';
+    url: string;
+}
+/** `mailto:`, which the browser hands to the mail program. */
+ | {
+    type: 'mail';
+    url: string;
+}
+/** `path` decoded, without what names the selection; `directory` when it ends with `/`. */
+ | {
+    type: 'path';
+    path: string;
+    selection?: TextSelection;
+    directory?: boolean;
+};
+/**
+ * Links of replies, read as VS Code reads them in its chat: http(s) URLs, and paths of files and
+ * directories with the lines they point to. Every other scheme (`javascript:`, `data:`, `command:`…)
+ * is no link at all. Pure functions: what a click does is TaLinks's.
+ */
+export declare namespace LinkUtil {
+    /** The target of `[text](target)` or of a URL in the text; undefined for what is no link. */
+    function parse(target: string): LinkTarget | undefined;
+    /**
+     * A code span that names a file or a directory, as models write them: `src/app.ts:12`, `package.json`,
+     * `docs/`. Not `console.log`, `text/html` or `@celljs/core`: a name needs an extension, and alone one
+     * that files have, or a `/` at its end.
+     */
+    function codeReference(text: string): LinkTarget | undefined;
+    /** A URL at the start of `text` (text runs on after it), without the punctuation that ends a sentence. */
+    function bareUrl(text: string): string | undefined;
+    /** `path` against the directory `cwd`: the directory to read it in, and the path inside it ('' for the directory itself). */
+    function resolve(cwd: string, path: string): {
+        cwd: string;
+        path: string;
+    };
+    /** `a/./b/../c/` as `a/c`; an absolute path stays absolute. */
+    function normalize(path: string): string;
+    function join(dir: string, path: string): string;
+    function dirname(path: string): string;
+    function basename(path: string): string;
+    /** The path with its lines, as the user reads it: `src/a.ts:10:5`. */
+    function label(target: LinkTarget): string;
+    /**
+     * Whether a page of `url` opens without asking, as VS Code's trusted domains: this machine (and the
+     * host of ta serve, `ownHost`) always; else a domain the user trusted: `github.com`, `*.github.com`
+     * (the domain and those under it), `localhost:3000` (that port only), or `*` for all.
+     */
+    function trusted(url: string, domains: readonly string[], ownHost?: string): boolean;
+}
+//# sourceMappingURL=link.d.ts.map

package/lib/browser/util/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/browser/util/link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,6HAA6H;AAC7H,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAC9B,8DAA8D;GAC5D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAC/B,2FAA2F;GACzF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAuBrF;;;;GAIG;AACH,yBAAiB,QAAQ,CAAC;IACtB,6FAA6F;IAC7F,SAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CA0C5D;IAED;;;;OAIG;IACH,SAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAoBlE;IAED,0GAA0G;IAC1G,SAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxD;IAED,6HAA6H;IAC7H,SAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAgBhF;IAED,+DAA+D;IAC/D,SAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9C;IAED,SAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;IAED,SAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;IAED,SAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;IAED,sEAAsE;IACtE,SAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAWhD;IAED;;;;OAIG;IACH,SAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAyB1F;CAuBJ"}