@trdrs/quickcharts 5.3.0 → 5.5.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 5.5.0
+
+The indicator picker's rail offers Favorites only while something is starred, and keeps it while it is open. The author and count columns stand only while a listed row fills them, so a list of starred built-ins reads as stars and names. Items a host answers for the `builtin` collection list in Technicals after the shipped definitions, under the host's own kinds. `IndicatorPickerCollection.empty` gives a collection an empty state: a title, text, a mark drawn 120px square from the 28-unit glyph grid, and one action that reaches `act` with a `collection` target. `IndicatorPickerEmpty` is exported. `chart.indicators.open` takes a `kind` beside `collection` and opens with that kind's filter pressed.
+
+## 5.4.0
+
+What is drawn over the canvas reads its ink from the canvas's lightness. Over a canvas of the other mode's lightness, such as a white canvas in dark mode, the legend, the scales' boxes and buttons, the pane and navigation buttons and the corner mark wear that mode's built-in colors, and the factory scale text and lines, grid and watermark are that mode's, so they read dark on a light canvas and light on a dark one. A color the host or the viewer named stays theirs.
+
+The rows of a settings page, in the chart settings, a host's pages and the drawing settings dialogs, are each as tall as what they hold while the page scrolls, so a row whose controls wrap onto a second line keeps that line clear of the next row in a short window.
+
+The price scale's auto-scale and logarithmic buttons write their letters at 14px on an 18px line, stand 15px apart, each centred in a 35x30 cell, and a held button steps lighter under the pointer.
+
+The `scaleUnitMenu` option makes the currency and unit box at the top of the price scale a button that opens the host's own menu: a press hands the handler a `ScaleUnitMenuRequest` with the chart, the box's place in viewport pixels and whether the keyboard pressed it. Without the option the box is a label that takes no pointer.
+
 ## 5.3.0
 
 The built-in palettes carry a deeper dark end of the grey ramp: the dark chrome and canvas are `#000000`, dialogs and menus `#131313`, the hover fill `#1a1a1a`, the pressed fill `#2b2b2b`, menu rules `#464646` and the quiet edges `#555555`, and the light inks that stood at `#0f0f0f` are `#000000`. The light secondary ink, the ink of search rows, lists and toolbar labels, is `#000000`, and the light tooltip is `#1a1a1a`.

package/README.md

@@ -1603,20 +1603,26 @@ part in each through `contributeCapture` (see Extensions).
 ### Indicator picker content
 
 The Indicators button and `commands.execute('chart.indicators.open')` open the same picker.
-Pass `{ collection: 'saved' }` as the command argument to open a declared host collection directly.
+Pass `{ collection: 'saved' }` as the command argument to open a declared host collection directly,
+and `kind` beside it (`{ collection: 'builtin', kind: 'template' }`) to open with that kind's filter
+pressed; a kind neither the chart's `indicator` nor one your source declares leaves every kind listed.
 An unknown collection falls back to the shipped catalog. Reopening an already open picker keeps its current selection and query.
 The picker opens on the same search field as the symbol search. Beside its list stands a rail of
-collections: Favorites under Personal, and the 23 shipped definitions as Technicals under Built-in.
-Pressing a definition's row adds a new instance to the currently active chart and keeps the picker
-open. Favorites use your `ChartStorage` port. The list reads as a table of each row's star, name,
-author, favorite count and actions; the shipped catalog shows the star, the name and the actions.
-Escape and a press outside the box close the picker.
+collections: Favorites under Personal while anything is starred, and the 23 shipped definitions as
+Technicals under Built-in. Favorites stays in the rail while it is open, so unstarring the last row
+there leaves the trader where they are. Pressing a definition's row adds a new instance to the
+currently active chart and keeps the picker open. Favorites use your `ChartStorage` port. The list
+reads as a table of each row's star, name, author, favorite count and actions; the author and count
+columns stand only while a listed row fills them, so the shipped catalog shows the star, the name
+and the actions. Escape and a press outside the box close the picker.
 
 Supply `ChartWidgetOptions.indicatorPicker` to include additional localized collections and rows
 in that picker. You supply data and opaque actions, not DOM, indicator definitions, or a renderer.
 Built-in annotations can add favorite state, counts and actions; they cannot replace a definition,
-its name, or Add, and their counts show wherever the list is a table (Favorites, and your table
-collections). Without a source, the picker has only shipped built-ins and Favorites.
+its name, or Add, and their counts show wherever the list is a table. Items you answer for the
+`builtin` collection list in Technicals after the shipped definitions, so a kind of your own (see
+`kinds` below) can stand beside the chart's indicators there. Without a source, the picker has only
+shipped built-ins and Favorites.
 
 ```ts
 import type { IndicatorPickerSource } from '@trdrs/quickcharts'
@@ -1679,6 +1685,23 @@ const withTemplates: IndicatorPickerSource = {
 }
 ```
 
+A collection can carry an `empty` state for the list to show while it lists nothing and no search
+is typed: a `title`, optional `text`, an optional `icon` drawn 120px square from the same 28-unit
+grid as every contributed glyph, and an optional `action`, a button whose press reaches `act` with
+the target `{ kind: 'collection', id }`. The kind filters step aside while it shows. Without one, an
+empty collection reads the chart's own no-matches line.
+
+```ts
+import type { IndicatorPickerCollection } from '@trdrs/quickcharts'
+
+const scripts: IndicatorPickerCollection = {
+  id: 'scripts',
+  label: 'My scripts',
+  layout: 'list',
+  empty: { title: 'No scripts yet', text: 'Write one and it lists here.', action: { id: 'create', label: 'Create script' } },
+}
+```
+
 A favorite action receives the requested next boolean. Successful actions refresh the current
 collection unless they return `close: true`. Refusals and exceptions keep the picker open with
 plain text, never rendered markup. Icons reuse `ChartExtensionIcon`; invalid icons draw no glyph.
@@ -2365,6 +2388,14 @@ watermark and the scale text and lines) follow the mode. A switch of mode hands
 of them back to the new mode's look, and keeps every other leaf. A saved chart states the mode they
 were chosen in (`settingsMode`), so a chart opened in the other mode takes that mode's look for them.
 
+What is drawn over the canvas reads its ink from the canvas's lightness. Where the canvas a chart's
+settings land on has the other mode's lightness, such as a white canvas in dark mode or a black one in
+light mode, everything over the plot (the legend, the price and time scales' boxes and buttons, the
+pane and navigation buttons and the corner mark) wears that mode's built-in colors, and the factory
+scale text and lines, grid and watermark are that mode's, so they read dark on a light canvas and
+light on a dark one. A color the host or the viewer named stays theirs. A gradient canvas is weighed
+by its top color, the one the legend stands on.
+
 ## Chart settings
 
 `chart.settings()` answers the effective tree; `chart.applySettings(partial)` layers a partial over
@@ -2427,7 +2458,12 @@ the same in both modes, in `CHART_FACTORY_COLORS`. The sections and what stands
   scale between framing itself and holding where it was dragged, and "L" between a regular and a
   logarithmic scale, each the chart's own verb. The currency and unit box (`currencyAndUnit`)
   names what the symbol's prices are in (its `currencyCode` and `unitId`) at the top of the main
-  scale on the same terms, and shows nothing for a symbol that states neither. The price-to-bar
+  scale on the same terms, and shows nothing for a symbol that states neither. With the widget's
+  `scaleUnitMenu` option the box is a button titled with the setting's name: a press hands your
+  handler a `ScaleUnitMenuRequest` (the chart, the box's place in viewport pixels, and whether the
+  keyboard pressed it) so your own currency and unit menu opens against it, and the box stays
+  while the pointer rests on it. Without the option the box is a label that takes no pointer, so
+  the scale under it still drags. The price-to-bar
   ratio lock (`lockPriceToBarRatio`) holds the price one bar's width spans: engaging it with no
   `priceToBarRatio` of its own takes the ratio on screen into that leaf, the scale stops framing
   itself, and every zoom of the time scale rescales the price axis by the same factor about its

package/dist/{chunk-FRZFOTMO.js → chunk-ETG46YGK.js}

@@ -10999,6 +10999,32 @@ function parseCssColor(input) {
   const clamp = (n, hi) => Math.min(hi, Math.max(0, n));
   return { r: clamp(Math.round(rgb[0]), 255), g: clamp(Math.round(rgb[1]), 255), b: clamp(Math.round(rgb[2]), 255), a: clamp(a, 1) };
 }
+function compositeOver(front, back) {
+  if (front.a >= 1) return { ...front, a: 1 };
+  const mix = (f, b) => Math.round(f * front.a + b * (1 - front.a));
+  return { r: mix(front.r, back.r), g: mix(front.g, back.g), b: mix(front.b, back.b), a: 1 };
+}
+function relativeLuminance(c) {
+  const linear = (v) => {
+    const s = v / 255;
+    return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+  };
+  return 0.2126 * linear(c.r) + 0.7152 * linear(c.g) + 0.0722 * linear(c.b);
+}
+var WHITE = { r: 255, g: 255, b: 255, a: 1 };
+function contrastRatio(foreground, background, beneath) {
+  const back = compositeOver(background, beneath ? compositeOver(beneath, WHITE) : WHITE);
+  const front = compositeOver(foreground, back);
+  const [hi, lo] = [relativeLuminance(front), relativeLuminance(back)].sort((a, b) => b - a);
+  return (hi + 0.05) / (lo + 0.05);
+}
+function contrastOf(foreground, background, beneath) {
+  const f = parseCssColor(foreground);
+  const b = parseCssColor(background);
+  const under = beneath === void 0 ? void 0 : parseCssColor(beneath);
+  if (!f || !b || under === null) return null;
+  return contrastRatio(f, b, under);
+}
 
 // src/ui/controls/color/palette.ts
 var to2 = (n) => Math.round(Math.max(0, Math.min(255, n))).toString(16).padStart(2, "0");
@@ -12018,6 +12044,7 @@ export {
   BRAND_UP,
   BRAND_DOWN,
   parseCssColor,
+  contrastOf,
   DEFAULT_VISIBILITY,
   visibilityPreset,
   parseTimeframeContext,
@@ -12157,4 +12184,4 @@ export {
   fitScale,
   fittedSize
 };
-//# sourceMappingURL=chunk-FRZFOTMO.js.map
+//# sourceMappingURL=chunk-ETG46YGK.js.map