@tradecanvas/chart 1.50.0 → 1.52.0

package/dist/widget/WidgetToolbar.d.ts

@@ -26,32 +26,80 @@ export declare class WidgetToolbar {
     private moreMenu;
     private tfCurrent;
     private resizeObserver;
+    /** Tells of a host's group of buttons resized: a count in a button that grew or shrank. */
+    private hostObserver;
     private moreBtn;
     private fitFrame;
+    /** Gone: a late font or a frame asked for before then fits nothing. */
+    private destroyed;
     private undoBtn;
     private redoBtn;
     private trade;
+    /** What the layouts button shows now, its state and name: the same again changes nothing. */
+    private layoutShown;
+    /** The symbol its button shows now: the same again builds nothing. */
+    private symbolShown;
     /**
      * `layer`: where the toolbar's menus open, over the page (the widget's
      * overlay layer), so no box around the widget clips them. Without one they
      * open inside their buttons.
      */
     constructor(host: HTMLElement, config: ToolbarConfig, callbacks: ToolbarCallbacks, t: Translator, layer?: (() => HTMLElement) | undefined);
-    /** Fit once before the next frame, however many changes came first. */
+    /** Fit once before the next frame, however many changes came first; never once the toolbar is gone. */
     private scheduleFit;
     /**
      * What a menu opened from `btn` hangs from: the button, or "more" while the
-     * button is folded under it.
+     * button is folded under it. A folded button has no box, so a menu placed
+     * from it would open at the widget's corner.
      */
-    private anchorOf;
+    menuAnchor(btn: HTMLElement): HTMLElement;
     /**
      * Fit the toolbar to its width. When everything doesn't fit, the buttons
      * on the right fold under "more" one at a time, from the right, until the
-     * rest does; when even that isn't enough, the menus show their icons only
+     * rest does; a host's buttons on the left come before them all, so they
+     * fold last. When even that isn't enough, the menus show their icons only
      * and the interval buttons give way to the interval menu, and as many
-     * buttons as then fit come back.
+     * buttons as then fit come back, from the left. Last of all, with nothing
+     * left to fold (a long symbol on a phone), the symbol gives way, in
+     * `SQUEEZE_STEPS`: its venue ("HYPERLIQUID:xyz:") is cut short to an
+     * ellipsis before anything else shrinks, its ticker kept whole while the
+     * buttons beside it can give. Each fit measures it whole, so it takes its
+     * room back as soon as there is room.
+     *
+     * A refit that changes what is folded closes the menus hanging from "more"
+     * or from a button that folded, whose place is gone, and the keyboard stays
+     * on the toolbar when the button it was on hides (see `keepFocus`).
      */
     fit(): void;
+    /** The folding, as `fit` says; the menus and the keyboard are `fit`'s. */
+    private refit;
+    /**
+     * Whether the toolbar's controls end inside its content box: the padding
+     * at its end clear (its left right to left), in its own layout px, as a
+     * container's transform or zoom leaves them. Widths are fractional ("more"
+     * ending at 1366.19 in a bar 1365 wide): the reach is rounded up to a
+     * whole px and the room down, so no share of a pixel hangs past the edge.
+     */
+    private fits;
+    /** What is folded, and whether "more" shows, as one word to tell a refit that changed them. */
+    private foldedState;
+    /** Close the menus that hang from "more", or from a button now folded: their entries or their place are stale. */
+    private closeStaleMenus;
+    /** The toolbar's button the keyboard is on: the one a menu hangs from while the keyboard is in the menu. */
+    private toolbarFocus;
+    /**
+     * Keep the keyboard on the toolbar after a refit: on `focused` while it
+     * shows; on "more" when it folded; when "more" itself went (everything is
+     * back), on the last button that came back, beside where "more" was. A
+     * menu still open that holds it keeps it.
+     */
+    private keepFocus;
+    /** The buttons that can fold, in their order: those that fold whole, and those inside what folds (the Trade menu). */
+    private overflowButtons;
+    /** Whether a toolbar button shows: not hidden, folded or switched off, and "more" only while the toolbar is collapsed or narrow. */
+    private shows;
+    /** Whether `el`, or what holds it on the toolbar, is part of a switch that is off. */
+    private isOff;
     private build;
     /** The buttons a narrow toolbar hides, as a menu under `anchor`: those switched off left out. */
     private toggleMore;
@@ -72,7 +120,12 @@ export declare class WidgetToolbar {
     setActive(role: string, on: boolean): void;
     /** Hide the button of `role` while the dock's rail has its own for it (and leave it out of "more"). */
     setRailed(role: string, railed: boolean): void;
-    /** The layout open now on its button (`null`: none saved yet), with a dot while it has unsaved changes. */
+    /**
+     * The layout open now on its button (`null`: none saved yet), with a dot
+     * while it has unsaved changes. A new name changes the button's width, not
+     * the toolbar's, so no resize tells of it: the toolbar refits, lest "more"
+     * be pushed past its end.
+     */
     setLayout(name: string | null, dirty: boolean): void;
     /** Swap the fullscreen button between enter and exit. */
     setFullscreen(on: boolean): void;
@@ -90,6 +143,12 @@ export declare class WidgetToolbar {
     private renderTimeframes;
     /** Whether the indicators dialog is open, on its button. */
     setIndicatorsOpen(open: boolean): void;
+    /**
+     * The symbol on its button, its venue ("BINANCE:") apart from its ticker,
+     * the button marked when it has one: a toolbar with no room left cuts the
+     * venue short first (`refit`).
+     */
+    private renderSymbol;
     update(state: WidgetState): void;
     private sep;
     private spacer;

package/dist/widget/WidgetToolbar.d.ts.map

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

package/dist/widget/WidgetTradeMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetTradeMenu.d.ts","sourceRoot":"","sources":["../../src/widget/WidgetTradeMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA8B5C;;;;GAIG;AACH,qBAAa,eAAe;IAkBxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,OAAO,CAAC,IAAI,CAAkC;IAC9C,+CAA+C;IAC/C,OAAO,CAAC,IAAI,CAAsB;IAElC,mFAAmF;IACnF,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,gBAAgB,EAC3B,CAAC,EAAE,UAAU,EACb,IAAI,EAAE,MAAM,WAAW,EACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,GAC1C,eAAe,GAAG,IAAI;IAKzB,OAAO;IAoBP,6DAA6D;IAC7D,IAAI,IAAI,IAAI;IAIZ,+FAA+F;IAC/F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;IAOxC,OAAO,IAAI,IAAI;IAKf,4DAA4D;IAC5D,OAAO,CAAC,KAAK;IAKb,mFAAmF;IACnF,OAAO,CAAC,MAAM;CAuBf"}
+{"version":3,"file":"WidgetTradeMenu.d.ts","sourceRoot":"","sources":["../../src/widget/WidgetTradeMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA2B5C;;;;GAIG;AACH,qBAAa,eAAe;IAkBxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAnBvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,OAAO,CAAC,IAAI,CAAkC;IAC9C,+CAA+C;IAC/C,OAAO,CAAC,IAAI,CAAsB;IAElC,mFAAmF;IACnF,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,gBAAgB,EAC3B,CAAC,EAAE,UAAU,EACb,IAAI,EAAE,MAAM,WAAW,EACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,GAC1C,eAAe,GAAG,IAAI;IAKzB,OAAO;IAoBP,6DAA6D;IAC7D,IAAI,IAAI,IAAI;IAIZ,+FAA+F;IAC/F,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;IAOxC,OAAO,IAAI,IAAI;IAKf,4DAA4D;IAC5D,OAAO,CAAC,KAAK;IAKb,mFAAmF;IACnF,OAAO,CAAC,MAAM;CAsBf"}

package/dist/widget/chartSettingsStore.d.ts

@@ -0,0 +1,76 @@
+import { ChartTypeOptions } from '@tradecanvas/commons';
+import { KeyValueStorage } from './DrawingTemplateStore.js';
+import { ChartSettingsState } from './types.js';
+type SettingsKey = keyof ChartSettingsState;
+/** Where `persistSettings` keeps the settings unless it names a key. */
+export declare const DEFAULT_SETTINGS_KEY = "tcw:chart-settings";
+/** The viewer's own: a layout or a link from someone else leaves them as they are. */
+export declare const VIEWER_KEYS: ReadonlySet<SettingsKey>;
+/**
+ * What `persistSettings` leaves out: besides the flags never kept, a chart
+ * type's own settings, which are the chart's state (a layout loaded puts
+ * its own in their place).
+ */
+export declare const PERSIST_LEAVES: ReadonlySet<SettingsKey>;
+/**
+ * What a layout's `settings` leaves out: the viewer's own, the scale and its
+ * flip (fields of their own there), and a chart type's own settings (in the
+ * chart's state).
+ */
+export declare const LAYOUT_LEAVES: ReadonlySet<SettingsKey>;
+/**
+ * What a shared link's `settings` leaves out: the viewer's own and the scale
+ * (a field of its own there). The link has no other place for the flip or a
+ * chart type's own settings, so they go in it.
+ */
+export declare const SHARE_LEAVES: ReadonlySet<SettingsKey>;
+/** Nothing left out: every setting of the right kind. */
+export declare const ALL_SETTINGS: ReadonlySet<SettingsKey>;
+/** The chart types with settings of their own (Renko's box, Kagi's reversal…), each a key of `chartTypeOptions`. */
+export declare const TYPES_WITH_SETTINGS: readonly (keyof ChartTypeOptions)[];
+/** Whether a chart type has settings of its own. */
+export declare function hasTypeSettings(type: unknown): type is keyof ChartTypeOptions;
+/**
+ * Only the chart types given settings: one at its defaults (`{}`) is as one
+ * never set, though the chart lists every type it was given.
+ */
+export declare function typesWithSettings(options: ChartTypeOptions): ChartTypeOptions;
+/** Every chart type with settings of its own at its defaults: given to the chart, it resets them all. */
+export declare function typesAtDefaults(): ChartTypeOptions;
+/**
+ * Chart Settings read from anywhere (storage, a layout, a link, a host's
+ * call): only the known keys, each of its kind, numbers in the settings'
+ * ranges, a time zone and a number format this browser knows. `leave` names
+ * the keys not to take.
+ */
+export declare function readChartSettings(raw: unknown, leave?: ReadonlySet<SettingsKey>): Partial<ChartSettingsState>;
+/** Every setting but those in `leave`. */
+export declare function pickSettings(settings: ChartSettingsState, leave: ReadonlySet<SettingsKey>): Partial<ChartSettingsState>;
+/** The settings that differ from `base`, but those in `leave`. */
+export declare function settingsDelta(settings: ChartSettingsState, base: ChartSettingsState, leave: ReadonlySet<SettingsKey>): Partial<ChartSettingsState>;
+/**
+ * What a shared link carries: the settings that differ from `base`, but
+ * those in `SHARE_LEAVES`, with a chart type's own settings only for the
+ * types that have some (a link should stay short).
+ */
+export declare function shareDelta(settings: ChartSettingsState, base: ChartSettingsState): Partial<ChartSettingsState>;
+/** The key `persistSettings` names; null when it is off. */
+export declare function settingsStoreKey(option: boolean | {
+    key?: string;
+} | undefined): string | null;
+/**
+ * The Chart Settings a user changed, kept in this browser's storage under one
+ * key (`persistSettings`). What is read back is checked; what can't be read
+ * is left out.
+ */
+export declare class ChartSettingsStore {
+    private readonly key;
+    private readonly storage;
+    constructor(key: string, storage?: KeyValueStorage | null);
+    /** What was kept; nothing when nothing readable was. */
+    load(): Partial<ChartSettingsState>;
+    /** Keep what differs from `defaults` (the host's), so a default the host changes later still reaches a user who never touched it. */
+    save(settings: ChartSettingsState, defaults: ChartSettingsState): void;
+}
+export {};
+//# sourceMappingURL=chartSettingsStore.d.ts.map

package/dist/widget/chartSettingsStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartSettingsStore.d.ts","sourceRoot":"","sources":["../../src/widget/chartSettingsStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,KAAK,WAAW,GAAG,MAAM,kBAAkB,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AASzD,sFAAsF;AACtF,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,WAAW,CAAsD,CAAC;AACxG;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,WAAW,CAA6D,CAAC;AAClH;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,WAAW,CAEjD,CAAC;AACH;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,WAAW,CAAsE,CAAC;AACzH,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,WAAW,CAA0B,CAAC;AAE7E,oHAAoH;AACpH,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,MAAM,gBAAgB,CAAC,EAAkE,CAAC;AAEtI,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,gBAAgB,CAE7E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAG7E;AAED,yGAAyG;AACzG,wBAAgB,eAAe,IAAI,gBAAgB,CAElD;AAyDD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,WAAW,CAAC,WAAW,CAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAS3H;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIvH;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIlJ;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE9G;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG9F;AAUD;;;;GAIG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,eAAe,GAAG,IAAuB;IAGrE,wDAAwD;IACxD,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAWnC,qIAAqI;IACrI,IAAI,CAAC,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI;CAOvE"}

package/dist/widget/chartTemplates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chartTemplates.d.ts","sourceRoot":"","sources":["../../src/widget/chartTemplates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIzE,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAoBD,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAY1E;AAiBD;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,SAAwB,EAC3B,OAAO,GAAE,eAAe,GAAG,IAAuB;IAGrE,+BAA+B;IAC/B,IAAI,IAAI,aAAa,EAAE;IAgBvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIvC,4FAA4F;IAC5F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAYpF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAO3B"}
+{"version":3,"file":"chartTemplates.d.ts","sourceRoot":"","sources":["../../src/widget/chartTemplates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIzE,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAaD,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1E;AAiBD;;;GAGG;AACH,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,GAAG,SAAwB,EAC3B,OAAO,GAAE,eAAe,GAAG,IAAuB;IAGrE,+BAA+B;IAC/B,IAAI,IAAI,aAAa,EAAE;IAgBvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAIvC,4FAA4F;IAC5F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAYpF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAO3B"}

package/dist/widget/compareLegend.d.ts

@@ -0,0 +1,20 @@
+import { CompareValue } from '@tradecanvas/core';
+import { IndicatorLegendRow } from './WidgetIndicatorLegend.js';
+/**
+ * A compared symbol's price, in decimals of its own by its size (65,432.10,
+ * 0.1002): the chart's decimals are the main symbol's, which would write a
+ * 0.1002 coin as 0.10.
+ */
+export declare function formatComparePrice(price: number, locale?: string): string;
+/** A change in percent with its sign (+8.45%, -7.69%), none when it reads as nothing. */
+export declare function formatChangePercent(change: number, locale?: string): string;
+/**
+ * The legend's rows for the symbols compared in percent (`chart.getCompareValues`):
+ * each one marked in its line's colour, its price and its change since its
+ * first bar on screen, as the percent scale reads it, in the legend's text
+ * colour: no one colour reads as text on both the dark and the light theme. Where the chart draws
+ * no compare lines (`drawn` false: Renko, Kagi and the like), each row is
+ * dimmed, without values, as an indicator off its intervals is.
+ */
+export declare function compareLegendRows(values: readonly CompareValue[], locale?: string, drawn?: boolean): IndicatorLegendRow[];
+//# sourceMappingURL=compareLegend.d.ts.map

package/dist/widget/compareLegend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareLegend.d.ts","sourceRoot":"","sources":["../../src/widget/compareLegend.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAQrE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAE1E;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAG5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,SAAU,EAAE,KAAK,UAAO,GAAG,kBAAkB,EAAE,CAUvH"}

package/dist/widget/hostButtons.d.ts

@@ -1,5 +1,8 @@
 /** Shows a host's button as on or off; a switch says so to assistive tech too. */
 export declare function setHostButtonActive(element: HTMLButtonElement, on: boolean, toggle: boolean): void;
-/** A host's toolbar button's text, its name following ("News: 3"). */
-export declare function setHostButtonText(element: HTMLButtonElement, label: string, text: string): void;
+/**
+ * A host's toolbar button's text, its name following ("News: 3"). False when
+ * it showed that text already: nothing is written again.
+ */
+export declare function setHostButtonText(element: HTMLButtonElement, label: string, value: string): boolean;
 //# sourceMappingURL=hostButtons.d.ts.map

package/dist/widget/hostButtons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostButtons.d.ts","sourceRoot":"","sources":["../../src/widget/hostButtons.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAGlG;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS/F"}
+{"version":3,"file":"hostButtons.d.ts","sourceRoot":"","sources":["../../src/widget/hostButtons.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAGlG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAcnG"}