@celljs/ta-web 0.0.0-stage → 4.6.0

package/esm/browser/settings/agent-settings.js

@@ -0,0 +1,85 @@
+import { TA_SETTINGS } from '@celljs/ta-protocol';
+import { EN_MESSAGES } from '../i18n/messages.js';
+export const AGENT_SETTINGS_GROUPS = [
+    { id: 'model', title: 'ta.settings.group.model', keys: ['model', 'defaultThinkingLevel', 'transport'] },
+    { id: 'conversation', title: 'ta.settings.group.conversation', keys: ['steeringMode', 'followUpMode'] },
+    {
+        id: 'context',
+        title: 'ta.settings.group.context',
+        keys: ['compaction.enabled', 'compaction.reserveTokens', 'compaction.keepRecentTokens', 'retry.enabled', 'retry.maxRetries'],
+    },
+    {
+        id: 'tools',
+        title: 'ta.settings.group.tools',
+        keys: ['codemode.mode', 'enableSkillCommands', 'shellPath', 'shellCommandPrefix', 'images.autoResize', 'images.blockImages'],
+    },
+];
+export var AgentSettingsUtil;
+(function (AgentSettingsUtil) {
+    function spec(key) {
+        return TA_SETTINGS.find(candidate => candidate.key === key);
+    }
+    AgentSettingsUtil.spec = spec;
+    function effective(snapshot, scope, key) {
+        const own = snapshot[scope][key];
+        return own === undefined ? inherited(snapshot, scope, key) : { value: own, source: 'scope' };
+    }
+    AgentSettingsUtil.effective = effective;
+    /** What the setting is when the file of the scope does not set it. */
+    function inherited(snapshot, scope, key) {
+        var _a;
+        if (scope === 'project' && snapshot.user[key] !== undefined) {
+            return { value: snapshot.user[key], source: 'user' };
+        }
+        const fallback = (_a = spec(key)) === null || _a === void 0 ? void 0 : _a.default;
+        return fallback === undefined ? { value: undefined, source: 'none' } : { value: fallback, source: 'default' };
+    }
+    AgentSettingsUtil.inherited = inherited;
+    function label(key) {
+        return `ta.setting.${key}`;
+    }
+    AgentSettingsUtil.label = label;
+    /** Its description, when it has one. */
+    function hint(key) {
+        const id = `ta.setting.${key}.hint`;
+        return id in EN_MESSAGES ? id : undefined;
+    }
+    AgentSettingsUtil.hint = hint;
+    /** The words for a value of a choice, when there are some; else the value is shown as it is. */
+    function valueLabel(key, value) {
+        const id = `ta.setting.${key}.${value}`;
+        return id in EN_MESSAGES ? id : undefined;
+    }
+    AgentSettingsUtil.valueLabel = valueLabel;
+    /** Whether a query finds any of these words: every word of it, anywhere. */
+    function matches(query, ...texts) {
+        const words = query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+        const haystack = texts.filter(Boolean).join(' ').toLowerCase();
+        return words.every(word => haystack.includes(word));
+    }
+    AgentSettingsUtil.matches = matches;
+})(AgentSettingsUtil || (AgentSettingsUtil = {}));
+/** How a key is written on this machine: ⌘ on a Mac, Ctrl elsewhere. */
+export var ShortcutUtil;
+(function (ShortcutUtil) {
+    function isMac(platform = typeof navigator === 'undefined' ? '' : navigator.platform) {
+        return /mac|iphone|ipad/i.test(platform);
+    }
+    ShortcutUtil.isMac = isMac;
+    function keys(shortcut, mac = isMac()) {
+        return shortcut.split('+').map(key => {
+            switch (key) {
+                case 'Mod':
+                    return mac ? '⌘' : 'Ctrl';
+                case 'Alt':
+                    return mac ? '⌥' : 'Alt';
+                case 'Shift':
+                    return mac ? '⇧' : 'Shift';
+                default:
+                    return key;
+            }
+        });
+    }
+    ShortcutUtil.keys = keys;
+})(ShortcutUtil || (ShortcutUtil = {}));
+//# sourceMappingURL=agent-settings.js.map

package/esm/browser/settings/agent-settings.js.map

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

package/esm/browser/settings/settings-protocol.d.ts

@@ -0,0 +1,44 @@
+import type { StateSpec } from '../state/state-protocol.js';
+export declare const TaSettings: unique symbol;
+export type ThemeSetting = 'system' | 'light' | 'dark';
+export type Theme = 'light' | 'dark';
+export type LanguageSetting = 'system' | Language;
+export type Language = 'zh-CN' | 'en-US';
+/** What the user chose; kept for the user, in every browser (TaState, `user`). */
+export interface Settings {
+    theme: ThemeSetting;
+    language: LanguageSetting;
+    /** Read the replies of ta aloud. */
+    speak: boolean;
+    reduceMotion: boolean;
+    /** The names of the built-in web extensions turned off; the others are on. */
+    builtinsOff: string[];
+    /**
+     * Hosts whose pages open outside of Ta without asking, as the trusted domains of VS Code:
+     * `github.com`, `*.github.com`, `localhost:3000`, or `*` for all. This machine always is.
+     */
+    trustedDomains: string[];
+}
+export interface SettingsState {
+    settings: Settings;
+    /** What `system` stands for now. */
+    theme: Theme;
+    language: Language;
+    /** Also when the system asks for it. */
+    reduceMotion: boolean;
+}
+export declare const DEFAULT_SETTINGS: Settings;
+export declare namespace SettingsUtil {
+    /** What was kept, with the defaults for what is missing; undefined for what is not settings. */
+    function parse(value: unknown): Settings | undefined;
+    const STATE: StateSpec<Settings>;
+    function theme(setting: ThemeSetting, prefersDark: boolean): Theme;
+    /** Chinese for any Chinese, English for the rest. */
+    function language(setting: LanguageSetting, browserLanguage: string): Language;
+}
+/** The settings of the web client: theme, language, voice, motion. They apply as soon as they change. */
+export interface TaSettings {
+    readonly state: SettingsState;
+    update(change: Partial<Settings>): void;
+    subscribe(listener: (state: SettingsState) => void): () => void;
+}

package/esm/browser/settings/settings-protocol.js

@@ -0,0 +1,35 @@
+export const TaSettings = Symbol('TaSettings');
+export const DEFAULT_SETTINGS = { theme: 'system', language: 'system', speak: false, reduceMotion: false, builtinsOff: [], trustedDomains: [] };
+function strings(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
+export var SettingsUtil;
+(function (SettingsUtil) {
+    /** What was kept, with the defaults for what is missing; undefined for what is not settings. */
+    function parse(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return undefined;
+        }
+        const kept = value;
+        return {
+            theme: ['system', 'light', 'dark'].includes(kept.theme) ? kept.theme : DEFAULT_SETTINGS.theme,
+            language: ['system', 'zh-CN', 'en-US'].includes(kept.language) ? kept.language : DEFAULT_SETTINGS.language,
+            speak: kept.speak === true,
+            reduceMotion: kept.reduceMotion === true,
+            builtinsOff: strings(kept.builtinsOff),
+            trustedDomains: strings(kept.trustedDomains),
+        };
+    }
+    SettingsUtil.parse = parse;
+    SettingsUtil.STATE = { key: 'settings', tier: 'user', initial: DEFAULT_SETTINGS, parse };
+    function theme(setting, prefersDark) {
+        return setting === 'system' ? (prefersDark ? 'dark' : 'light') : setting;
+    }
+    SettingsUtil.theme = theme;
+    /** Chinese for any Chinese, English for the rest. */
+    function language(setting, browserLanguage) {
+        return setting === 'system' ? (browserLanguage.toLowerCase().startsWith('zh') ? 'zh-CN' : 'en-US') : setting;
+    }
+    SettingsUtil.language = language;
+})(SettingsUtil || (SettingsUtil = {}));
+//# sourceMappingURL=settings-protocol.js.map

package/esm/browser/settings/settings-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-protocol.js","sourceRoot":"","sources":["../../../src/browser/settings/settings-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAgC/C,MAAM,CAAC,MAAM,gBAAgB,GAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AAE1J,SAAS,OAAO,CAAC,KAAc;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAa,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjH,CAAC;AAED,MAAM,KAAW,YAAY,CA2B5B;AA3BD,WAAiB,YAAY;IACzB,gGAAgG;IAChG,SAAgB,KAAK,CAAC,KAAc;QAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,KAAgC,CAAC;QAC9C,OAAO;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAsB,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK;YACzH,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAkB,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,QAA4B,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ;YACzI,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY,KAAK,IAAI;YACxC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;SAC/C,CAAC;IACN,CAAC;IAbe,aAAA,KAAK,QAapB,CAAA;IAEY,kBAAK,GAAwB,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IAE9G,SAAgB,KAAK,CAAC,OAAqB,EAAE,WAAoB;QAC7D,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7E,CAAC;IAFe,aAAA,KAAK,QAEpB,CAAA;IAED,qDAAqD;IACrD,SAAgB,QAAQ,CAAC,OAAwB,EAAE,eAAuB;QACtE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACjH,CAAC;IAFe,aAAA,QAAQ,WAEvB,CAAA;AACL,CAAC,EA3BgB,YAAY,KAAZ,YAAY,QA2B5B"}

package/esm/browser/settings/settings.d.ts

@@ -0,0 +1,31 @@
+import { LocaleManager } from '@celljs/widget';
+import { TaState } from '../state/state-protocol.js';
+import { type Settings, type SettingsState, TaSettings } from './settings-protocol.js';
+/**
+ * The colours of the conversation (--ta-main) and of the side columns (--ta-side), for the bar of the
+ * browser and the title bar of the installed app.
+ */
+export declare const THEME_COLORS: {
+    dark: {
+        main: string;
+        side: string;
+    };
+    light: {
+        main: string;
+        side: string;
+    };
+};
+export declare class TaSettingsImpl implements TaSettings {
+    protected readonly localeManager: LocaleManager;
+    protected readonly persisted: TaState;
+    protected current: SettingsState;
+    protected readonly listeners: Set<(state: SettingsState) => void>;
+    protected readonly dark: MediaQueryList;
+    protected readonly calm: MediaQueryList;
+    get state(): SettingsState;
+    protected init(): void;
+    update(change: Partial<Settings>): void;
+    subscribe(listener: (state: SettingsState) => void): () => void;
+    protected resolve(settings: Settings): SettingsState;
+    protected apply(settings: Settings): void;
+}

package/esm/browser/settings/settings.js

@@ -0,0 +1,102 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Autowired, Component, PostConstruct } from '@celljs/core';
+import { LocaleManager } from '@celljs/widget';
+import { TaState } from '../state/state-protocol.js';
+import { SettingsUtil, TaSettings } from './settings-protocol.js';
+/**
+ * The colours of the conversation (--ta-main) and of the side columns (--ta-side), for the bar of the
+ * browser and the title bar of the installed app.
+ */
+export const THEME_COLORS = { dark: { main: '#141416', side: '#1c1c1e' }, light: { main: '#ffffff', side: '#f5f5f7' } };
+let TaSettingsImpl = class TaSettingsImpl {
+    constructor() {
+        this.listeners = new Set();
+        this.dark = matchMedia('(prefers-color-scheme: dark)');
+        this.calm = matchMedia('(prefers-reduced-motion: reduce)');
+    }
+    get state() {
+        return this.current;
+    }
+    init() {
+        this.current = this.resolve(this.persisted.get(SettingsUtil.STATE));
+        // Changed in another browser: the server has it once this page is signed in.
+        this.persisted.subscribe(() => {
+            const settings = this.persisted.get(SettingsUtil.STATE);
+            if (settings !== this.current.settings) {
+                this.apply(settings);
+            }
+        });
+        this.dark.addEventListener('change', () => this.apply(this.current.settings));
+        this.calm.addEventListener('change', () => this.apply(this.current.settings));
+        this.apply(this.current.settings);
+    }
+    update(change) {
+        const settings = { ...this.current.settings, ...change };
+        this.apply(settings);
+        this.persisted.set(SettingsUtil.STATE, settings);
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    resolve(settings) {
+        return {
+            settings,
+            theme: SettingsUtil.theme(settings.theme, this.dark.matches),
+            language: SettingsUtil.language(settings.language, navigator.language),
+            reduceMotion: settings.reduceMotion || this.calm.matches,
+        };
+    }
+    apply(settings) {
+        const state = this.resolve(settings);
+        this.current = state;
+        const root = document.documentElement;
+        root.dataset.theme = state.theme;
+        root.style.colorScheme = state.theme;
+        root.lang = state.language;
+        root.toggleAttribute('data-reduce-motion', state.reduceMotion);
+        let meta = document.querySelector('meta[name="theme-color"]');
+        if (!meta) {
+            meta = document.createElement('meta');
+            meta.name = 'theme-color';
+            document.head.appendChild(meta);
+        }
+        meta.content = THEME_COLORS[state.theme].main;
+        void this.localeManager.get().then(locales => {
+            const locale = locales.find(candidate => candidate.lang === state.language);
+            if (locale && this.localeManager.current !== locale) {
+                this.localeManager.setCurrent(locale);
+            }
+        });
+        for (const listener of this.listeners) {
+            listener(state);
+        }
+    }
+};
+__decorate([
+    Autowired(LocaleManager),
+    __metadata("design:type", Object)
+], TaSettingsImpl.prototype, "localeManager", void 0);
+__decorate([
+    Autowired(TaState),
+    __metadata("design:type", Object)
+], TaSettingsImpl.prototype, "persisted", void 0);
+__decorate([
+    PostConstruct(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], TaSettingsImpl.prototype, "init", null);
+TaSettingsImpl = __decorate([
+    Component(TaSettings)
+], TaSettingsImpl);
+export { TaSettingsImpl };
+//# sourceMappingURL=settings.js.map

package/esm/browser/settings/settings.js.map

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

package/esm/browser/state/state-protocol.d.ts

@@ -0,0 +1,48 @@
+export declare const TaState: unique symbol;
+/**
+ * Where a value of the page is kept, by who should find it again:
+ * - `tab`: this tab of the browser (sessionStorage), as the page it shows; two tabs show two things.
+ * - `device`: this browser (localStorage), as the widths of the columns, which follow its screen.
+ * - `user`: the user, on the server (the data of the package @celljs/ta-web), in every browser; this
+ *   browser keeps a copy, for the first frame and when the server cannot be reached.
+ *
+ * What belongs to one directory (the folders open in an explorer) is kept by the web extension that
+ * shows it, with `pi.storage.directory(cwd)`.
+ */
+export type StateTier = 'tab' | 'device' | 'user';
+/** One value of the page: where it is kept, and how it is read back. */
+export interface StateSpec<T> {
+    /** `chat.file`: `ta.chat.file` in the browser, the key of the data on the server. */
+    key: string;
+    tier: StateTier;
+    /** Until something is kept. */
+    initial: T;
+    /** The value read, or undefined when it is not one (kept by an older version, or by hand). */
+    parse(value: unknown): T | undefined;
+}
+/**
+ * The values of the page that outlive it, each at its tier. Values are JSON and replaced, never changed in
+ * place: the same value is the same object, for React. A value set here wins over one read from the
+ * server meanwhile; the last write wins between browsers.
+ */
+export interface TaState {
+    /** At once, what this browser has; for `user` it also asks the server, and tells the listeners if that differs. */
+    get<T>(spec: StateSpec<T>): T;
+    /** What the server has, when it can be asked; else what this browser has. */
+    load<T>(spec: StateSpec<T>): Promise<T>;
+    /** Kept here at once; on the server a moment later, or when it can be reached again. */
+    set<T>(spec: StateSpec<T>, value: T): void;
+    /** A value changed, here or from the server. */
+    subscribe(listener: () => void): () => void;
+    /** Writes to the server what waits, now: the page is going away. */
+    flush(): void;
+}
+export declare namespace StateUtil {
+    /** The name of ta's own data on the server (TaPackageServer.getExtensionData). */
+    const DATA_NAME = "@celljs/ta-web";
+    function string(value: unknown): string | undefined;
+    function boolean(value: unknown): boolean | undefined;
+    /** What the browser has under the key: JSON, or the bare text older versions kept. */
+    function decode(text: string | null): unknown;
+    function same(a: unknown, b: unknown): boolean;
+}

package/esm/browser/state/state-protocol.js

@@ -0,0 +1,32 @@
+export const TaState = Symbol('TaState');
+export var StateUtil;
+(function (StateUtil) {
+    /** The name of ta's own data on the server (TaPackageServer.getExtensionData). */
+    StateUtil.DATA_NAME = '@celljs/ta-web';
+    function string(value) {
+        return typeof value === 'string' ? value : undefined;
+    }
+    StateUtil.string = string;
+    function boolean(value) {
+        return typeof value === 'boolean' ? value : undefined;
+    }
+    StateUtil.boolean = boolean;
+    /** What the browser has under the key: JSON, or the bare text older versions kept. */
+    function decode(text) {
+        if (text === null) {
+            return undefined;
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (_a) {
+            return text;
+        }
+    }
+    StateUtil.decode = decode;
+    function same(a, b) {
+        return a === b || JSON.stringify(a) === JSON.stringify(b);
+    }
+    StateUtil.same = same;
+})(StateUtil || (StateUtil = {}));
+//# sourceMappingURL=state-protocol.js.map

package/esm/browser/state/state-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-protocol.js","sourceRoot":"","sources":["../../../src/browser/state/state-protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AA2CzC,MAAM,KAAW,SAAS,CA2BzB;AA3BD,WAAiB,SAAS;IACtB,kFAAkF;IACrE,mBAAS,GAAG,gBAAgB,CAAC;IAE1C,SAAgB,MAAM,CAAC,KAAc;QACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAFe,UAAA,MAAM,SAErB,CAAA;IAED,SAAgB,OAAO,CAAC,KAAc;QAClC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IAFe,UAAA,OAAO,UAEtB,CAAA;IAED,sFAAsF;IACtF,SAAgB,MAAM,CAAC,IAAmB;QACtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;mBAAO,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IATe,UAAA,MAAM,SASrB,CAAA;IAED,SAAgB,IAAI,CAAC,CAAU,EAAE,CAAU;QACvC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAFe,UAAA,IAAI,OAEnB,CAAA;AACL,CAAC,EA3BgB,SAAS,KAAT,SAAS,QA2BzB"}

package/esm/browser/state/state.d.ts

@@ -0,0 +1,39 @@
+import { TaWorkbench } from '../workbench-protocol.js';
+import { type StateSpec, TaState } from './state-protocol.js';
+interface Slot {
+    spec: StateSpec<unknown>;
+    value: unknown;
+    /** One more for each value set here: what the server answers for an older one is not taken. */
+    version: number;
+    /** The server has answered since the page last connected; always for what is not kept there. */
+    loaded: boolean;
+    loading?: Promise<void>;
+    /** Set here and not written to the server yet. */
+    dirty: boolean;
+}
+export declare class TaStateImpl implements TaState {
+    protected readonly workbench: TaWorkbench;
+    /** By key. */
+    protected readonly slots: Map<string, Slot>;
+    protected readonly listeners: Set<() => void>;
+    protected timer?: ReturnType<typeof setTimeout>;
+    protected watching: boolean;
+    protected online: boolean;
+    get<T>(spec: StateSpec<T>): T;
+    load<T>(spec: StateSpec<T>): Promise<T>;
+    set<T>(spec: StateSpec<T>, value: T): void;
+    subscribe(listener: () => void): () => void;
+    flush(): void;
+    protected slot<T>(spec: StateSpec<T>): Slot;
+    protected schedule(): void;
+    /** What the server has: taken unless set here meanwhile; what only this browser had goes there. */
+    protected fetch(slot: Slot): Promise<void>;
+    /** Follows the connection and the server: what changed elsewhere, and what was missed while offline. */
+    protected watch(): void;
+    protected isOnline(): boolean;
+    protected storage(spec: StateSpec<unknown>): Storage | undefined;
+    protected readLocal(spec: StateSpec<unknown>): unknown;
+    protected writeLocal(slot: Slot): void;
+    protected notify(): void;
+}
+export {};

package/esm/browser/state/state.js

@@ -0,0 +1,210 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Autowired, Component } from '@celljs/core';
+import { TaWorkbench } from '../workbench-protocol.js';
+import { StateUtil, TaState } from './state-protocol.js';
+/** Values set within this time go to the server together. */
+const WRITE_MS = 300;
+let TaStateImpl = class TaStateImpl {
+    constructor() {
+        /** By key. */
+        this.slots = new Map();
+        this.listeners = new Set();
+        this.watching = false;
+        this.online = false;
+    }
+    get(spec) {
+        const slot = this.slot(spec);
+        if (!slot.loaded && !slot.loading && this.isOnline()) {
+            void this.fetch(slot);
+        }
+        return slot.value;
+    }
+    async load(spec) {
+        var _a;
+        const slot = this.slot(spec);
+        if (!slot.loaded && this.isOnline()) {
+            await ((_a = slot.loading) !== null && _a !== void 0 ? _a : this.fetch(slot));
+        }
+        return slot.value;
+    }
+    set(spec, value) {
+        const slot = this.slot(spec);
+        if (StateUtil.same(slot.value, value)) {
+            return;
+        }
+        slot.value = value;
+        slot.version++;
+        this.writeLocal(slot);
+        if (spec.tier === 'user') {
+            slot.dirty = true;
+            this.schedule();
+        }
+        this.notify();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    flush() {
+        var _a;
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        if (!this.isOnline()) {
+            // Written when the connection is back.
+            return;
+        }
+        for (const slot of this.slots.values()) {
+            if (!slot.dirty) {
+                continue;
+            }
+            slot.dirty = false;
+            const { version } = slot;
+            this.workbench.packages.setExtensionData(StateUtil.DATA_NAME, slot.spec.key, (_a = slot.value) !== null && _a !== void 0 ? _a : null).catch(() => {
+                if (slot.version === version) {
+                    slot.dirty = true;
+                }
+            });
+        }
+    }
+    slot(spec) {
+        this.watch();
+        let slot = this.slots.get(spec.key);
+        if (!slot) {
+            const local = this.readLocal(spec);
+            slot = { spec: spec, value: local !== null && local !== void 0 ? local : spec.initial, version: 0, loaded: spec.tier !== 'user', dirty: false };
+            this.slots.set(spec.key, slot);
+        }
+        return slot;
+    }
+    schedule() {
+        var _a;
+        (_a = this.timer) !== null && _a !== void 0 ? _a : (this.timer = setTimeout(() => this.flush(), WRITE_MS));
+    }
+    /** What the server has: taken unless set here meanwhile; what only this browser had goes there. */
+    fetch(slot) {
+        const { version } = slot;
+        const loading = this.workbench.packages
+            .getExtensionData(StateUtil.DATA_NAME, slot.spec.key)
+            .then(remote => {
+            slot.loaded = true;
+            if (slot.version !== version) {
+                return;
+            }
+            const value = remote === undefined || remote === null ? undefined : slot.spec.parse(remote);
+            if (value === undefined) {
+                // Kept in this browser before the server kept it: the server keeps it from now on.
+                if (!StateUtil.same(slot.value, slot.spec.initial)) {
+                    slot.dirty = true;
+                    this.schedule();
+                }
+            }
+            else if (!StateUtil.same(value, slot.value)) {
+                slot.value = value;
+                this.writeLocal(slot);
+                this.notify();
+            }
+        }, () => undefined)
+            .finally(() => {
+            if (slot.loading === loading) {
+                slot.loading = undefined;
+            }
+        });
+        slot.loading = loading;
+        return loading;
+    }
+    /** Follows the connection and the server: what changed elsewhere, and what was missed while offline. */
+    watch() {
+        if (this.watching) {
+            return;
+        }
+        this.watching = true;
+        this.online = this.isOnline();
+        this.workbench.subscribe(state => {
+            const online = state.status === 'online';
+            if (online && !this.online) {
+                for (const slot of this.slots.values()) {
+                    if (slot.spec.tier === 'user') {
+                        slot.loaded = false;
+                        if (!slot.dirty) {
+                            void this.fetch(slot);
+                        }
+                    }
+                }
+                this.flush();
+            }
+            this.online = online;
+        });
+        this.workbench.onExtensionData((name, keys, cwd) => {
+            if (name !== StateUtil.DATA_NAME || cwd !== undefined) {
+                return;
+            }
+            for (const key of keys) {
+                const slot = this.slots.get(key);
+                if (slot && slot.spec.tier === 'user' && !slot.dirty) {
+                    void this.fetch(slot);
+                }
+            }
+        });
+        if (typeof document !== 'undefined') {
+            document.addEventListener('visibilitychange', () => document.visibilityState === 'hidden' && this.flush());
+            window.addEventListener('pagehide', () => this.flush());
+        }
+    }
+    isOnline() {
+        return this.workbench.state.status === 'online';
+    }
+    storage(spec) {
+        if (spec.tier === 'tab') {
+            return typeof sessionStorage === 'undefined' ? undefined : sessionStorage;
+        }
+        return typeof localStorage === 'undefined' ? undefined : localStorage;
+    }
+    readLocal(spec) {
+        var _a;
+        var _b;
+        try {
+            const value = StateUtil.decode((_b = (_a = this.storage(spec)) === null || _a === void 0 ? void 0 : _a.getItem(`ta.${spec.key}`)) !== null && _b !== void 0 ? _b : null);
+            return value === undefined ? undefined : spec.parse(value);
+        }
+        catch (_c) {
+            return undefined;
+        }
+    }
+    writeLocal(slot) {
+        const storage = this.storage(slot.spec);
+        const key = `ta.${slot.spec.key}`;
+        try {
+            if (slot.value === undefined || StateUtil.same(slot.value, slot.spec.initial)) {
+                storage === null || storage === void 0 ? void 0 : storage.removeItem(key);
+            }
+            else {
+                storage === null || storage === void 0 ? void 0 : storage.setItem(key, JSON.stringify(slot.value));
+            }
+        }
+        catch (_a) {
+            // Full, or not allowed: the value stays for this page, and on the server.
+        }
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+};
+__decorate([
+    Autowired(TaWorkbench),
+    __metadata("design:type", Object)
+], TaStateImpl.prototype, "workbench", void 0);
+TaStateImpl = __decorate([
+    Component(TaState)
+], TaStateImpl);
+export { TaStateImpl };
+//# sourceMappingURL=state.js.map