@trdrs/quickcharts 3.0.0 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,106 @@
 # @trdrs/quickcharts
 
+## Unreleased
+
+## 4.0.0
+
+Settled settings dialogs and factory looks for every drawing tool, words typed on the chart, a rebuilt replay date picker, glyphs drawn as the chart's own artwork, recent picks narrowed by the selected class, and drawings the catalog cannot restore named as unreadable. 4.0 removes the content card and the catalog keys the settled dialogs do not read, and gives drawing props new names and meanings, so a host upgrades as the guide below says. A drawing saved by 3.x restores with the look it was saved with.
+
+The built-in palettes retune their dialog and status colors: the veil behind a light modal is `rgba(156, 156, 156, 0.5)`, a select's chevron and a flyout's arrow read in `chrome.caret` (`#707070` light, `#8c8c8c` dark), the muted ink is `#6a6a6a` light and `#9b9b9b` dark, the status inks are `#078671`, `#df323f` and `#ac6600` in light and `#089981`, `#f34452` and `#ff9800` in dark, `drawing.line` is `#2962ff` in both modes, and `drawing.selected`, the ring of a selected drawing's handles, is `#2962ff` light and `#1e53e5` dark. Every ink reads at the WCAG 2.2 AA ratio on each ground it is drawn over.
+
+The drawing settings dialog is a card at least 380px wide under a 68px header that carries the drawing's name at 20px, a pencil that renames it in place, and the close; a page strip of 16px tabs over a 4px track, the shown page carried by a bar that slides to the next; a two-column page whose labels share one column and whose rows stand 50px; list buttons that open their choices under them, several at once where a row takes several; and a footer with the Template list button, Cancel and Ok. `DrawingOptions.name` holds the name a viewer gives a drawing, saved with it, and a drawing without one is called by its tool's name.
+
+A color in the drawing settings dialog opens one popover directly under its button, past the dialog's edge where it needs to, and keeps its whole width and height wherever it opens, moving left or above its button to stay in view rather than narrowing or scrolling; the settings bar's color panels keep theirs the same way: the offered colors on a ten-wide grid (the greys and ten hues, then six ramps of them), the colors the viewer added after a rule with the plus that adds one, the opacity as a track and a percent field, and for a stroke the Thickness and Line style rows as joined segments. Every choice applies to the drawing at once and the popover stays up for the next one, while Cancel still puts back everything from before the dialog opened. The plus opens a custom color editor with a hex field that takes three or six digits, a saturation and brightness area and a hue strip; a color added there joins the viewer's own colors, kept with the drawing preferences in `ChartStorage`, and is chosen. The arrows move over the grid and the rows, Enter or Space chooses, Tab stays in the popover, and Escape returns to the button. The line-end list is as wide as its rows, and both line-end marks are the chart's own drawing.
+
+The line, shape and curve tools open with their factory looks: the line tools in `#2962ff` at 2px with 14px words (12px for a trend angle and the horizontal lines), and each shape and curve in its own hue at 2px with a background of that hue at a fifth, switched off on a curve. Their settings pages carry the rows their kinds offer: a line's ends, extensions, middle point, price labels and stats under Info, with `showPipsChange` counting the change in the symbol's smallest price move, `statsPosition` taking `auto`, and `alwaysShowStats` keeping them on screen when the line is not selected, since they otherwise show only while it is; a level's price label and a time line's time label; a rectangle's middle line in a stroke of its own; a shape's background switched by `fillBackground`; a curve's ends and its extensions along its end tangents; and a Text page whose words stand where `textVAlign` and `textHAlign` put them, with `textOrientation` turning a vertical line's words to run up it. `NO_COORDINATES_TAB` and `PRICE_ONLY_COORDS` join the settings capabilities, and the `bold` and `italic` icons draw the Text page's weight and slant toggles.
+
+A Fibonacci retracement, a trend-based extension and a fib channel open on twenty-four levels, the eleven classic ratios shown and thirteen more to switch on, each in its own color, drawn at 2px with 12px labels over bands at a fifth; a retracement and an extension draw their trend line dashed in grey. Their Style pages carry the trend line, the levels' thickness and style, the extensions, the level grid two to a line, one color for every level, the bands' switch and opacity, Reverse, Prices, the labels' reading and place, the levels' own words and their place, the labels' size, and log price levels: `trendLine`, `trendLineColor`, `trendLineWidth`, `trendLineStyle`, `fillBackground`, `backgroundOpacity`, `coeffsAsPercents`, `labelsHAlign`, `labelsVAlign`, `showText`, `textHAlign`, `textVAlign` and `levelsOnLogScale`, with `Viewport.logScale` saying whether the price scale is logarithmic. A fib saved with its earlier `background` switch keeps its setting as `fillBackground`. A number field's stepper keeps every digit the value carries.
+
+A fib time zone, a trend-based fib time, fib circles, speed resistance arcs, a fib wedge and a pitchfan open on their own levels, each in its own color and stroke, and their Style pages stand the levels one to a line, each level's switch, value and stroke (`FibLevel.width` and `FibLevel.style`), under the trend line or the median and over the one color, the bands' switch and opacity, and the rows of their own: a time zone's and a trend-based time's Labels and where they stand, a circle fib's Levels and Coeffs as percents, an arc fib's Levels and Full circles, and a wedge's Levels. A wedge has no Coordinates page. A speed resistance fan and a gann box divide their box on seven price and seven time divisions, `priceLevels` and `timeLevels`, each side under its section with its labels' switches; a fan adds its bands, a grid in a stroke of its own and Reverse, and a gann box its price and time bands on their own switches and opacities, its angles in a color of their own, and Reverse. A fan saved with one set of levels reads them as its price divisions and a gann box as both its price and its time divisions, and the settings bar's stroke color recolors every set of levels a tool holds.
+
+The four pitchforks open on nine line pairs, the half in `#089981` and the tines in `#2962ff` shown and seven more to switch on, each pair in its own color at 2px, with a red median and bands at a fifth. Their Style pages carry Extend lines, the median's stroke (`medianColor`, `medianWidth`, `medianStyle`), the pairs one to a line with each pair's switch, value and stroke, the one color, the bands' switch and opacity (`fillBackground`, `backgroundOpacity`) and the construction in a Style list that switches it in place. A fork saved with its earlier `background` switch keeps its setting as `fillBackground`.
+
+A fib spiral opens in `#00bcd4` at 2px, and its Style page carries its line and Counterclockwise, `counterclockwise` winding it the other way about its first point.
+
+A gann square and a gann square fixed open on six grid lines, eleven fan lines (2x1, 1x1 and 1x2 shown) and eleven arcs, each in its own color at 2px over bands at a fifth, and their Style pages set the Levels, Fans and Arcs two to a line, each its switch with its place or its ratio and its stroke, then the one color, the bands' switch and opacity, and Reverse: `levels`, `fans` and `arcs` hold the lines, with `fillBackground`, `backgroundOpacity` and `reverse`. A gann square holds its second corner at `scaleRatio` price per bar, taken from the pane when it is first drawn, which its Price/bar ratio field shows and sets, and reads its ranges and ratio under it while `showLabels` is on, in the size, weight and slant its Ranges and ratio row sets. A gann fan opens on nine rays, 1/8 to 8/1, each in its own color and stroke over bands at a fifth, its page a line for each ray named by its ratio, the one color, the bands and Labels. A square or a fan saved with its earlier `background` switch keeps its setting as `fillBackground`, a square saved with its earlier levels paints them as it was saved until its settings change and then takes its factory lines, and the settings bar's stroke color recolors a square's fans and arcs with its grid.
+
+A regression trend fits through any of nine sources (`BAR_PRICE_SOURCES`: open, high, low, close, volume, `hl2`, `hlc3`, `ohlc4`, `hlcc4`), opens with its line dashed red at 1px and its bands blue at 2px two deviations either side, and its pages carry Upper Deviation, Lower Deviation (counted down from the line, so a saved trend's lower deviation reads as its negative), their switches and the source on Inputs, and the line's and bands' switches and strokes, Extend lines and Pearson's R on Style: `baseLine`, `baseColor`, `baseWidth`, `baseStyle`, the same for `up` and `down`, `extendLines` and `showPearsons`. A parallel channel opens on seven levels, 0 and 1 shown at 2px and the half dashed at 1px, each in its own stroke, its page carrying them one to a line with the extensions and the background, and its Coordinates page its parallel's Price offset. A flat top/bottom and a disjoint channel open in `#ff9800` and `#089981` with no Coordinates page, their pages carrying the line and its ends, the extensions, the sides' prices in a text style of their own (`showPrices`, `pricesColor`, `pricesFontSize`, `pricesBold`, `pricesItalic`) and the background. Every channel opens with its body at a fifth and 14px words, and stands them above, inside or below it.
+
+The six chart patterns open in their factory looks: an XABCD and a cypher pattern in `#2962ff`, an ABCD and a head and shoulders in `#089981`, a three drives and a triangle pattern in `#673ab7`, each at 2px with white 12px letters, the shaded ones shading their legs in their hue at fifteen percent. Their Style pages carry a Label row (the letters' color, size, weight and slant), the border, and for the shaded ones the background, switched by `fillBackground`; a pattern carries no words of its own and has no Text page unless a save brings some, and a pill grows with its letters. A three drives pattern stands on seven points, the reversal after its third drive the last, and one saved on six completes with its reversal on its third drive, drawing as it was saved.
+
+The five Elliott wave counts open in their colors at 2px (an impulse and a correction in `#3d85c6`, a triangle in `#ff9800`, the combos in `#6aa84f`), and their Style pages carry the wave's color, the wave's switch and thickness (`showWave`) and the count's degree (`degree`, one of fifteen from supermillennium to minuscule), which writes each label ringed, in parentheses or bare, in roman numerals or figures, and in capitals or small letters. The labels take the wave's color, and `LABELED_PATTERNS` lists the six chart patterns alone.
+
+Cyclic lines open in `#80ccdb` and the sine line and time cycles in `#159980`, each at 2px, the cyclic lines' and the sine line's Style pages naming their stroke Lines; a time cycle shades its humps in `#6aa84f` at half, switched by `fillBackground` on its Background row.
+
+A forecast opens in `#2962ff` at 2px, its source a tenth see-through and its verdicts green and red, and its Style page sets the line and each of its ten colors on a row of its own. A sector shades the two halves of its slice in `color1` and `color2`, blue and purple at a fifth, inside a grey 2px border, with `fillBackground` switching them, and has no Coordinates page. A bars pattern paints its bars as their high-low or open-close ranges or as a line through one price of each (`mode`: `hl`, `oc`, `close`, `open`, `high`, `low`, `hl2`, `BARS_PATTERN_MODES`), a pattern saved painting candle sticks painting them (`candles`) until a mode is chosen, and has no Coordinates page. A ghost feed's page writes its candles' average span in the symbol's minimum ticks, its borders and wick on switches of their own, and its transparency on a track. `FILLABLE` leaves out the sector, whose backgrounds are its own.
+
+A long and a short position open with grey 1px lines, white 12px words and a leverage of 10000, so the risk sets their quantity, and have no Coordinates page: their Inputs page carries the account size, the lot size, the risk as a percent or an amount in the symbol's currency, the entry price, the leverage, the target and the stop each as ticks from the entry and as a price, and how the quantity is written (`qtyPrecision`); their Style page the lines, the stop and target colors, the words' color and size, Price labels, the stats the tags read (`stats`, thirteen to choose from, all but the two levels' P&L at first), Compact stats mode and Always show stats (`alwaysShowStats`): the tags read while the position is hovered or selected, and at rest only while their stats always show. A drawing layer's `setCurrency` tells its drawings the currency the symbol is quoted in, and the widget passes it from the symbol's `currencyCode`.
+
+An anchored VWAP weighs any of nine sources (`source`, the typical price at first) and stands up to three bands off its average in volume-weighted standard deviations or percents (`bandsMode`, `bandMultipliers`, `bandsOn`), each band's upper and lower line in a stroke of its own (`upperBands`, `lowerBands`), the first band's body in the drawing's fill (`fillBackground`) and its latest average on the price scale (`showPriceLabel`); its Inputs page carries the bands and the source, its Style page the average, each band line, the body and Price label, and it has no Coordinates page. A volume profile's pages carry Rows Layout, Row Size, Volume, Value Area Volume and, for a fixed range, Extend Right on Inputs, and on Style the histogram's switch (`showProfile`), its values (`showValues`, `valuesColor`), its width and edge, its four colors, VAH, VAL, POC, Developing POC and Developing VA each on a switch in a stroke of its own, the box's background (`boxColor`) and, for an anchored profile, its lines on the price scale (`showLabelsOnPriceScale`). A price range, a date range and a date and price range read the stats their Stats list chooses (`showPriceRange`, `showPercentChange`, `showPipsChange`, `showBarsRange`, `showDateTimeRange`, `showVolume`) in a label of their own (`labelColor`, `labelFontSize`, `fillLabelBackground`, `labelBackgroundColor`), switch their span's background, run a price range on to the left or right and a date range to the top or bottom, and border a date and price range on its switch (`drawBorder`, `borderColor`, `borderWidth`); a meter saved with its earlier stats keeps them.
+
+The text and annotation tools open in their factory looks and pages. A text opens blue at 14px with no Coordinates page, its Text page carrying its background and border each on a switch (`fillBackground`, `drawBorder`) and Text wrap (`wordWrap`, `wordWrapWidth`); a text saved with its words centered keeps them so. A comment opens white on blue at 16px, its words' row named Text without weight or slant; a callout white on teal at 14px with a 2px border, its border's width on its Border row and Text wrap after it; a price label white and bold on blue, its Style page carrying its Text, Background and Border. A note stands on two points, the point it notes and its label, a line between them: its Style page carries Label background and Label border on their switches (`fillBackground`, `drawBorder`, `borderColor`) and Line color, and a note saved on one point keeps that point and stands its label's corner on it as it was drawn, the line showing once the label is moved off. A price note's Style page carries its tag's Label text, Label background and Label border (`labelTextColor`, `labelFontSize`, `labelBold`, `labelItalic`, `labelBackgroundColor`, `labelBorderColor`) and Line color, and its Text page where its words stand. A pin's Style page carries its marker's color under Label and its Text page its box's background and border. A signpost's Style page carries Emoji pin (`showImage`, with an emoji picker for `emoji`) and its plate's color, and its Coordinates page its vertical position over its bar (`position`) and its bar. A table opens on three by three dark cells, its dialog its Style and Visibility pages alone, the Style page carrying Background, Border, Text and Text alignment (`textHAlign`), its header band off at first; its cells, rows and columns are set on the chart, and `INERT_PROPS` lists its `cells` and `headerRow`. The arrow marks, the arrow marker and the flag open in their own colors, each named on its Style page for what it paints. `NO_STYLE_TAB` lists the text, the comment and the callout, `NO_STROKE` leaves out the comment, the callout and the price label, whose borders take the stroke, `NO_LINE_DECOR` lists the price label and `NO_DASH` the callout.
+
+A brush opens teal at 2px with its background off (`fillBackground`) and its ends plain, and a path blue at 2px with an arrow at its last point, each stroke's ends set on its Line row (`leftEnd`, `rightEnd`); a brush saved with a fill shows it, its background switched on. A highlighter opens red at a fifth, 20px wide, its page carrying its color and its width in pixels. An emoji and a sticker open at 72px and an icon in blue at 40px, its page carrying its tint. The strokes, the glyphs and the image have no Coordinates page, and the emoji and the sticker open on their Visibility page. An image's page chooses its picture from a box that names the formats and the size the intake takes, and sets its transparency on a track.
+
+`THEME_ROLES` gains five roles, each in both built-in palettes: `control.outline` outlines a dialog's Cancel at rest (`#2e2e2e` light, `#ffffff` dark), `control.onInk` inks a mark cut from the emphasis fill, such as a chosen thickness, line style or line end (`#ffffff` light, `#000000` dark), `control.selectEdgeHover` is a list button's edge under the pointer (`#a8a8a8` light, `#808080` dark), and `motion.durationGlide` (`100ms`) and `motion.easingInOut` (`ease-in-out`) time the drawing settings dialog's tab bar sliding to the page shown, the opacity knob gliding on `motion.durationGlide` too.
+
+A drawing saves at `v: 3` (`SerializedDrawing.v`). A save at `v: 2` restores with the look it was saved with: each tool whose factory values, prop meanings or paint rules differ writes, as it restores, the values that paint the save as it was painted, and saves at `v: 3` with them, a pin's words on their dark plate, a price label's pill in its stroke color at 18% and a brush's fill among them. The looks a tool's pages do not set ride in props they do not offer, which `INERT_PROPS` lists: `bodyColor` on a regression trend, `textAtStart` on the channels, `bandsByPane`, `wordsInLabels` and `labelsAtStart` on a retracement, an extension and a fib channel, `roundPercents` on fib circles, `shadedBands` on the pitchforks, `tint` on a gann box, `pillRadius` on the patterns and the wave counts, `labelPills` on the wave counts, `candles` on a bars pattern, `outline` on the volume profiles, `borderWidth` on a callout, `labelTextStyle` on the range meters, and `extendLeft` and `extendRight` on a date and price range. They stay with the drawing: its tool's remembered default and the templates saved from it leave them out, and Apply defaults sets them to the tool's own. A gann square, a gann square fixed, a speed resistance fan, a pitchfan, a price note and a signpost saved at `v: 2` paint as they were saved, their settings held in `savedLook`, until their settings change, when they take their present design; Cancel puts the saved look back with the drawing's points. A trend angle draws the ends and words a save carries, and a pattern or a wave count draws the words a save carries above it, its Text page offered for them alone. A remembered default or a template written by an earlier format applies the setup it names as its tool reads a save's, a regression trend's lower deviation counted down from its line and a bars pattern's candles among them. A host that writes drawings itself writes `v: 3` for the tools' present looks.
+
+The image tool takes a WEBP as well as a JPG or a PNG (`IMAGE_TYPES`, `IMAGE_ACCEPT`), its box reading "JPG, PNG or WEBP" and its refusal naming the three. `DrawingAssetPort.intakeImage` stores a PNG or a JPEG whatever the picked file was, so a saved chart opens everywhere: a host whose intake stores the picked file's own data URL decodes a WEBP and re-encodes it on a canvas, as a PNG where it has transparency and a JPEG otherwise.
+
+The drawing settings dialog opens in place over an undimmed chart: it appears and leaves at once, and a press beside it still closes it. Its lists hang under the controls that open them, past the dialog's edge where they need to: a list of choices as wide as its longest choice and never narrower than its button, so no choice is cut short, a list of switches as wide as its button, each row ticking the checkbox the settings rows wear on the list's own ground rather than inverting, the keyboard ringing a row inside its own edge, and the Template menu sized to its words with the button ringed while it is open; a select's chevron turns on the standard timing. Apply defaults puts the tool's own look and setup on the drawing at once and keeps its words, and "Save as…" reads with an ellipsis. The Image tool's picker is a 380px card under the settings dialog's header, its drop box 8px under the header, its transparency a 180px track at the end of its own line, and its footer the settings dialog's, Cancel and Ok at its end in the same 34px buttons.
+
+The drawing settings pages settle their geometry: a number field keeps 63px for its words and a 22 by 28 slot for its steppers whether they show or not, and a field that cannot be used keeps no slot; a price in a field (a point's, a position's entry, target and stop, a channel's offset) is written with as many decimals as the symbol's tick, cents where the host states none; a color or emoji well beside a switch that is off stands dimmed on the field's fill; a text, a note and a callout take a 172px text box; a list of inputs (a regression trend's, an anchored VWAP's and a volume profile's) sets its switches at 34px, nests a profile's histogram rows 26px under its switch and stands each VWAP band on one line; a level grid stands 412px across; a position's and a range meter's groups end with the room a group keeps; and an image's drop box states its call at 16px and its limits at 14px on a 4px corner. Every control in the chart reads in the chart's own font rather than the browser's control font, and a field that cannot be used reads in `text.disabled`.
+
+The text, the comment, the note, the signpost, the callout and the pin type their words on the chart. The drawing paints the words as they are typed, with their caret, selection and placeholder, while a field nobody sees, laid exactly over them in their own type and line height, takes the keys: `TextEditSession.inline` (`TextInlineEdit`) says where the words stand (`TextEditFrame`), hears what the field holds (`TextDraft`), answers a double-click that opens the drawing's settings and Tab where the words take turns, and hears the viewer end the edit. Enter and Shift with Enter break the line; Escape, Ctrl or Cmd with Enter, and a press elsewhere commit the words exactly as typed, the drawing still selected after Escape. A click on the words of the selected drawing types again, and a double-click opens its settings. A text, a comment, a note or a signpost left without words stays while it is selected and goes once it is not, a callout left without words goes as its edit ends, and a pin keeps its place without words. `AttachDrawingsOptions.placeholder` names the words an empty drawing shows, read as it paints, and `AttachDrawingsOptions.inks` the chart's own inks (`DrawingInks`: a handle's ring and center, words and a quiet edge in the chart's ink, and its accent). A caret stands as tall as its type, and drawings paint their words in the chart's own font stack.
+
+The text and annotation tools paint as measured. A text stands its words two pixels in from its point, a 2px frame just outside them while it is selected; a comment's bubble has its corner on its point and its others rounded at 21; a note's box stands centred on its label point under a soft shadow, its noted point dotted and tied to it; a signpost's plate is outlined below or above its bar on a grey post, a square handle on its point moving it up and down, and a preview follows the pointer while its tool is armed; a callout's box stands left of its point with a tail let into its outline toward its tip; a price label's body stands up and to the right of its point with a tail and a dot to it; a price note dots its first point and stands its tag on its second; a pin's marker is a holed head over a tip on its point, its box of words over it while it is hovered, selected or typed into; a flag stands on a grey pole; the arrow marks hang their tips on their points; and an arrow marker runs from its tail at its first point to a broad head at its second. A drawing of these saved at `v: 2` keeps the look it was saved with until its settings change (`savedLook`), an arrow marker's points turning to the present order. A price note opens no text editor as it lands (its `hasText` is off): its words, like the marks', are typed in its settings, which a double-click on any of these opens.
+
+A table types into the cell a click on the selected table lands in, framed inside its grid lines, Tab moving on to the next cell and from the last to the first; each row stands as tall as its words, lines 1.3 times their size, and a table opens on three by three cells 120px wide. Its floating bar and the chart's menu over it add a column right of the cell last typed in and a row below it, or at the table's ends where no cell is, and the menu removes that cell's row and column: `chart.drawings.tableRemoveRow`, `chart.drawings.tableRemoveColumn`, `ChartMenuContext.table` and the `table-add-column`, `table-add-row`, `table-remove-row` and `table-remove-column` menu actions, with the `tableAddColumn` and `tableAddRow` icons. A hovered grid line wears a band and resizes its column or row, and the corners carry round handles that scale the table, no row shorter than its words.
+
+Selection handles paint as rings in the chart's handle inks, round at a radius of 5.5 with a 2px ring or a rounded square, and a price label, a pin, a flag and the arrow marks wear a small ring on their points; the handle under a mouse stands in a halo. A right-click selects the drawing it lands on, and a right-click while a drawing is half placed takes it back and puts the tool down. The floating bar carries the text tools', the notes', the marks' and the table's own controls in their order. `IDrawing` gains `pointer` and `setPointer`, `hovered` and `setHovered`, and the members a drawing typed on the chart answers through: `textDraft`, `setTextDraft`, `textFrame`, `setTextPlaceholder`, `grabbedAnchors`, `wordsAt` and `dragAnchorTo`.
+
+The content card drawing tool (`content_card`) leaves the catalog, which holds 89 tools, and its row in the Content section of the Text and notes group, its `tool.content_card` icon, the Link field of its settings dialog and its two catalog strings go with it. A saved chart or layout, a drawings document or a drawing list that carries a content card loads without it, quietly: the card is skipped, as a drawing of any type the catalog does not hold is; nothing throws, no notice is shown, and every other drawing loads as it was saved. The next save writes the chart without the card. A content card a viewer starred draws no arm on the favorites bar, and a bar with no other star stays hidden.
+
+`DrawingDocumentApi.apply` and `reload`, a chart's `drawingResources`, name every drawing the catalog does not restore among the drawings they do not attach, with the reason `unreadable`, and leave it out of `applied`: a drawing of a type the catalog does not hold, and one whose anchors are not a list or whose options are null. The chart does not paint it, and every write of the document carries it as it was written, so a build that reads it still finds it.
+
+A class chip in the symbol search narrows the recent picks the list leads with, as it narrows the feed's answer. With a class selected and nothing typed, the dialog lists only the recent picks whose `type` is that class or a narrower class offered beneath it. The All chip lists every recent pick, and the scope's own recents follow the same rule while its chip is on.
+
+The chart's own glyphs are drawn from lines, arcs, circles and walled outlines on their grids, each at the size, weight and place it stands at: the controls, the chart styles, the empty-state illustrations, the spread operators, the highlighter and fixed gann square miniatures, and the layout arrangements. `chartIconArtwork` answers these drawings. A layout arrangement's glyph is drawn from the arrangement's own panes, so each tile shows the split it opens (`12c4` shows four columns of three rows), and every arrangement stands on the one frame the 21 by 19 glyph holds. No icon id or public name changes.
+
+The replay bar's Select date dialog stands over the undimmed chart, a 302px card that appears and leaves at once and is carried by its title. Its date field opens with the keyboard in it, and on an intraday chart its time field's clock lists the day in quarter hours under the field. Its calendar shows one month of 34px days with no day of another month, the chosen day on the emphasis fill, today underlined and every day the loaded window does not cover disabled, and its heading turns the days into the months of the year and then into twenty years. Picking a day moves the choice and the dialog stays up, a chip moves the choice to the first available day and time, and Select starts replay at the first bar at or after them. The arrows walk the days, Page Up and Page Down turn the month (Shift for a year), Enter picks and Escape closes. Choosing Date… leaves replay asking where to start, so Cancel and Escape close the dialog and leave the question and the transport as they were; the starting-point menu marks the current starting point in the ink cut from its fill. The `calendar` and `clock` icons draw the dialog's field marks.
+
+`THEME_ROLES` gains the quiet fill in both built-in palettes: `control.neutral` (`#f2f2f2` light, `#2e2e2e` dark) under a dialog's shortcut chip, the band over a calendar's columns and a chosen month or year, `control.neutralHover` (`#ebebeb`, `#3d3d3d`) and `control.neutralPressed` (`#dbdbdb`, `#4a4a4a`) under the pointer and while pressed, and `control.neutralInk` (`#000000`, `#ffffff`) for the words on it and the words and mark a quiet control brightens to under the pointer.
+
+### Upgrading to 4.0
+
+A major version may remove public names, and this guide lists each one. 4.0 removes the content card and the names that exist only for it, so drop each from what your page lists, offers or creates:
+
+- The drawing tool type `content_card`: `drawingTools` does not hold it, `CARD_TYPES` holds `image` alone, and the feature manifest's `drawings` leave it out. A `drawingTools` list that names it is a setup error from `createChart`, and `armTool('content_card')` throws, as it does for any type the catalog does not hold.
+- The icon id `tool.content_card`: `ChartIconId`, `CHART_ICON_IDS` and the feature manifest's `icons` leave it out, and an `icons` entry for it is a setup error from `createChart`.
+- The catalog keys `tool.content_card` and `drawing.link`: `ChartMessageKey` leaves both out, and so does a dictionary of your own (`ChartCustomLocale`, `ChartDictionary`). The chart reads neither.
+
+Saved state needs nothing from you: a save that carries a content card loads without it, as above. A drawings document keeps its content cards as they were written, unread, and so do the drawing templates and tool defaults your store keeps for `content_card`.
+
+4.0 also settles the drawing settings dialogs, which narrows the catalog keys they read and gives drawing props new names and meanings. Change each where your code names it:
+
+- The catalog keys `drawing.addColumn`, `drawing.addColumnShort`, `drawing.addRow`, `drawing.addRowShort`, `drawing.alignment`, `drawing.avgHl`, `drawing.bars`, `drawing.body`, `drawing.chooseEllipsis`, `drawing.customColor`, `drawing.drawBorders`, `drawing.drawWicks`, `drawing.failure`, `drawing.glyph`, `drawing.headerRow`, `drawing.lower`, `drawing.pointOfControl`, `drawing.priceChange`, `drawing.replaceEllipsis`, `drawing.sectionDeviation`, `drawing.size`, `drawing.success`, `drawing.tabTable`, `drawing.tableCell`, `drawing.target`, `drawing.upDownVolume`, `drawing.upper`, `drawing.valueAreaHigh`, `drawing.valueAreaLow`, `drawing.valueAreaUpDown`, `drawing.weight` and `drawing.width`: `ChartMessageKey` leaves them out, and so does a dictionary of your own (`ChartCustomLocale`, `ChartDictionary`), so a dictionary that sets one stops type-checking until it drops the key. The chart reads none of them.
+- The drawing props that take new names. Code that reads or writes a drawing's props, through `updateProps`, the `chart.drawings.props` command, a template's or a tool default's props, or a `SerializedDrawing` it writes itself, uses the new names:
+  - `background` is `fillBackground` on a fib retracement, a trend-based fib extension, a fib channel, a fib time zone, a trend-based fib time, fib circles, speed resistance arcs, a fib wedge, a pitchfan, a speed resistance fan, the four pitchforks, a gann square, a gann square fixed and a gann fan.
+  - A gann box's `background` is `fillPriceBackground` and `fillTimeBackground`, its `levels` are `priceLevels` and `timeLevels`, and its `showLabels` is `showLeftLabels`, `showRightLabels`, `showTopLabels` and `showBottomLabels`. A speed resistance fan's `levels` are `priceLevels`, beside its `timeLevels`.
+  - A price range's, a date range's and a date and price range's `showPriceDelta`, `showPercent`, `showBars` and `showTimeSpan` are `showPriceRange`, `showPercentChange`, `showBarsRange` and `showDateTimeRange`, and their `extend` is `extendLeft` and `extendRight`, a date range's `extendTop` and `extendBottom`.
+  - A parallel channel's `showMiddle` is its half level's `visible`, in its `levels`.
+- The drawing props whose meaning changes:
+  - A regression trend's `lowerDeviation` counts from its line in signed deviations, so the band two deviations below the line is `-2`, where 3.x wrote `2`.
+  - A bars pattern's `mode` takes `hl`, `oc`, `close`, `open`, `high`, `low` or `hl2` (`BARS_PATTERN_MODES`), and `bars` goes: candle sticks are `candles`, beside the mode.
+  - A gann square's and a gann square fixed's `levels` hold their grid lines, each its switch, place and stroke, with their `fans` and `arcs` beside them, rather than one set of fib levels.
+  - A note stands on two points, the point it notes and its label, and a three drives pattern on seven, its reversal the last (`anchors` in `drawingTools`).
+- The drawing props that go: a comment's `align`, its words reading from its left; a flat top/bottom's and a disjoint channel's `showMiddle`; the `text` the chart patterns and the Elliott waves carried empty, since they carry words only where a save names some; a fib channel's `reverse`; the `extendLeft`, `extendRight`, `reverse` and `showPrices` of a fib time zone, a trend-based fib time, fib circles, speed resistance arcs, a fib wedge and a pitchfan, with a pitchfan's `showLevels`; a speed resistance fan's `extendLeft`, `extendRight`, `showLevels` and `showPrices`; and a gann square fixed's `showLabels`.
+- The capability sets that narrow: `LABELED_PATTERNS` holds the six chart patterns alone, the Elliott waves leaving it; `FILLABLE` leaves out the sector, whose halves carry their own colors (`color1`, `color2`); `NO_STROKE` leaves out the comment, the callout and the price label, whose borders take the stroke; `NO_LINE_DECOR` leaves out the callout; and `NO_STYLE_TAB` leaves out the note, which has a Style page.
+- `SerializedDrawing.v` is `2 | 3`, and a drawing saves at `v: 3` (`SERIAL_VERSION`). Code that reads `v` takes both, and code that writes a drawing itself writes `v: 3` with the present names and meanings.
+
+A drawing saved by 3.x needs nothing from you: a save at `v: 2` restores with the look it was saved with, reading its earlier names and meanings as it restores, and saves at `v: 3`. A template or a tool default saved by 3.x applies the setup it names as its tool reads a save.
+
 ## 3.0.0
 
 A search scope the viewer turns on and off, one box for the chart's dialog fields, and a drawing dialog that follows its drag. Each `SearchScope` carries the search within it, a required `search`, so a host that offers a scope upgrades as the guide below says. No public name changes.

package/README.md

@@ -1627,7 +1627,13 @@ chrome is painted from it and renders nothing without it.
   asks where to begin rather than choosing a starting bar. Its starting-point menu answers with a
   bar picked on the plot, a date, the first available date, or a random bar. The first available
   date runs `chart.replay.startFirst`: the chart pages the feed's history back to its oldest bar,
-  within the 20,000 bars one session holds, and starts there. Undo and
+  within the 20,000 bars one session holds, and starts there. A date opens Select date over the
+  undimmed chart, carried by its title: a date field, on an intraday chart a time field whose clock
+  lists the day in quarter hours, a calendar of the loaded window whose heading turns to the months
+  and the years, and a chip that moves the choice to the first available day. Picking moves the
+  choice and the dialog stays up; Select starts replay at the first bar at or after the date and
+  time, in UTC, and Cancel leaves replay asking where to start. The arrows walk the days, Page Up
+  and Page Down turn the month, Enter picks and Escape closes. Undo and
   redo step back and forward through the active chart's own content, and each names the change it
   would move. Layout setup offers the arrangements and sync switches the chart offers (by default
   the 55 arrangements and the five sync switches); the saved-layouts menu, shown with a layouts
@@ -2019,24 +2025,58 @@ inventory, and the built-in palettes and the generated stylesheet are built from
 property names are private, so a color, a size or a radius is always set through a role. The
 class names inside the stylesheet are private too, except the supported hooks below.
 
+### The built-in palettes
+
+The two built-in palettes paint every dialog, menu and popover the chart opens from these roles,
+among the others `THEME_ROLES` lists:
+
+| Role | Light | Dark | What it paints |
+|---|---|---|---|
+| `overlay.surface` | `#ffffff` | `#1f1f1f` | The ground of a dialog, menu or popover. |
+| `overlay.separator` | `#ebebeb` | `#4a4a4a` | The rule under a dialog header and over its footer, and between menu groups. |
+| `overlay.scrim` | `rgba(156, 156, 156, 0.5)` | `rgba(0, 0, 0, 0.5)` | The veil behind a modal dialog. |
+| `text.primary` | `#0f0f0f` | `#dbdbdb` | The ink of rows, labels and values. |
+| `text.muted` | `#6a6a6a` | `#9b9b9b` | A section title, a hint, a placeholder. |
+| `chrome.caret` | `#707070` | `#8c8c8c` | The chevron of a select and the arrow that opens a flyout. |
+| `text.link` | `#2962ff` | `#5b9cf6` | A text link. |
+| `state.hover` | `#f2f2f2` | `#2e2e2e` | The fill under the pointer. |
+| `state.pressed` | `#ebebeb` | `#3d3d3d` | The fill while the pointer is down. |
+| `control.outline` | `#2e2e2e` | `#ffffff` | The edge and the words of an outlined button at rest, such as a dialog's Cancel. |
+| `control.onInk` | `#ffffff` | `#000000` | A mark cut from the emphasis fill: a chosen thickness, line style or line end. |
+| `control.neutral` | `#f2f2f2` | `#2e2e2e` | The quiet fill: a dialog's shortcut chip, the band over a calendar's columns, a chosen month or year. |
+| `control.neutralHover` | `#ebebeb` | `#3d3d3d` | The quiet fill under the pointer. |
+| `control.neutralPressed` | `#dbdbdb` | `#4a4a4a` | The quiet fill while the pointer is down. |
+| `control.neutralInk` | `#000000` | `#ffffff` | The words on the quiet fill, and what a quiet control's words and mark brighten to under the pointer, such as a calendar's day. |
+| `status.positive` | `#078671` | `#089981` | A gain or a success. |
+| `status.negative` | `#df323f` | `#f34452` | A loss or a failure. |
+| `status.warning` | `#ac6600` | `#ff9800` | A condition to notice before acting. |
+
+Every ink is held to the WCAG 2.2 AA ratio on each ground it is drawn over, so the light status
+inks are the darkest steps of their hues that still read at 4.5 to 1 on white, the dark red reads at
+4.5 to 1 on the dialog ground, and the muted ink reads at 4.5 to 1 over the hover and selected fills
+of a menu row and over the quiet fill. `drawing.line` is `#2962ff` in both modes; `drawing.selected`,
+the ring of a selected drawing's handles, is `#2962ff` light and `#1e53e5` dark, around a center of
+`drawing.handle`, the chart's own ground.
+
 ### Fields
 
 Every text field, select, number field and color well the chart draws in its dialogs and settings
 is one box: 34px tall, a 1px edge with an 8px corner around a clear ground, and its words at 14 on
-18, 8px in from the edge. A select ends in an 18px chevron. Four roles in the `control` family
-paint the box, and the focus ring is `state.focusRing`:
+18, 8px in from the edge. A select ends in an 18px chevron in `chrome.caret`. Five roles in the
+`control` family paint the box, and the focus ring is `state.focusRing`:
 
 | Role | Light | Dark | What it paints |
 |---|---|---|---|
 | `control.fieldEdge` | `#dbdbdb` | `#575757` | The edge of a field at rest. |
 | `control.fieldEdgeHover` | `#a8a8a8` | `#707070` | The edge of a field under the pointer. |
+| `control.selectEdgeHover` | `#a8a8a8` | `#808080` | The edge of a list button under the pointer, such as a select on a drawing's settings page. |
 | `control.fieldInvalid` | `#f23645` | `#f23645` | The edge and the focus ring of a field holding a value it refuses. |
 | `control.fieldFill` | `#f2f2f2` | `#2e2e2e` | The ground of a field that is read-only or disabled. |
 
 Focus draws a 2px ring over the edge, the edge itself and the pixel inside it, so the ring follows
-the corner and a dialog that scrolls never clips it. A number past its bounds or off its step turns
-the edge `control.fieldInvalid` once the viewer leaves the field, so a number on its way to a valid
-one never turns red while it is typed. The symbol search field draws its own outline in
+the corner and a dialog that scrolls never clips it. Only a value the chart refuses turns the edge
+`control.fieldInvalid`; a number past its bounds or off its step is clamped or rounded, so its
+field never turns red. The symbol search field draws its own outline in
 `chrome.fieldBorder`.
 
 ### Motion
@@ -2052,21 +2092,25 @@ same values:
 | `motion.durationModerate` | `250ms` | A control moving to its new state, such as a switch knob sliding. |
 | `motion.durationSlow` | `350ms` | A small mark settling, such as a disclosure caret turning or a checkbox filling. |
 | `motion.durationSlower` | `500ms` | A larger mark turning, such as the drawing toolbar's chevron. |
+| `motion.durationGlide` | `100ms` | A mark gliding to a new place, such as a dialog's tab bar or an opacity knob. |
 | `motion.easingStandard` | `ease` | A modal dialog box, the replay row, a caret dip, a checkbox fill. |
 | `motion.easingOut` | `ease-out` | A modal backdrop fading, a switch knob sliding. |
 | `motion.easingLinear` | `linear` | A color or opacity change under the pointer. |
 | `motion.easingSpring` | `cubic-bezier(0.175, 0.885, 0.32, 1.275)` | A caret or chevron turning with a slight overshoot. |
+| `motion.easingInOut` | `ease-in-out` | A dialog's tab bar sliding to the page shown. |
 | `motion.scaleEnter` | `0.97` | The scale a modal dialog box grows from as it opens. |
 
 Every modal dialog the chart opens (the symbol search, chart settings, the indicator browser and
-indicator settings, the saved-layouts browser, the name and confirm prompts, go to date, and the
-drawing settings, image picker and template prompts) opens with its backdrop fading in over
+indicator settings, the saved-layouts browser, the name and confirm prompts, and the drawing image
+picker and template prompts) opens with its backdrop fading in over
 `motion.durationBase` on `motion.easingOut`, and its box fading in and growing from
 `motion.scaleEnter` to full size over `motion.durationBase` on `motion.easingStandard`. It closes
 with the same motion reversed. A closing dialog stops taking input and returns focus at once, and the
 chart removes it when the same `motion.durationBase` has elapsed, so a duration you set times both
 the transition and the removal. A dialog opened over another moves on its own and closes first, and
-a dialog the chart replaces or tears down goes at once.
+a dialog the chart replaces or tears down goes at once. The drawing settings dialog and the replay
+date picker work on the chart they stand over, so they open in place: they appear and leave at once,
+and their backdrop dims nothing while still taking the press that closes them.
 
 A duration takes a CSS duration such as `200ms` or `0.2s`; an easing takes any CSS timing function,
 such as `ease-in-out`, `steps(4)` or `cubic-bezier(0.2, 0, 0, 1)`; a scale takes a unitless factor
@@ -2772,7 +2816,7 @@ re-tile opens in the current one.
 
 ## Drawings
 
-The widget ships with a complete drawing product, on by default: every one of the 90 tools places
+The widget ships with a complete drawing product, on by default: every one of the 89 tools places
 from the toolbar, the selected drawing gets a floating settings bar and a settings dialog, tool
 defaults and named templates ride the adapter's template family, and a symbol's drawings persist
 through the adapter's drawings family. Turn the whole layer off with `features.drawings: false`,
@@ -2847,11 +2891,164 @@ line style, the settings gear, lock, delete, and a More menu with the stacking m
 per-timeframe visibility presets, clone, copy and hide. Every edit persists at once and becomes the
 tool's default for the next drawing of that type. The settings dialog opens from the gear with
 Inputs, Style, Text, Table, Coordinates and Visibility pages as the tool has them; its edits apply
-live, Cancel restores the drawing, and Ok commits the session as one edit.
-
-Text-bearing tools open an inline editor where the text sits, in the drawing's own type. A fresh
-placement committed empty is removed; an existing note committed empty is blanked. Ctrl or Cmd
-with Enter commits, Escape cancels, and a press on the chart commits.
+live, Cancel restores the drawing, and Ok commits the session as one edit. Its header carries the
+drawing's name, the tool's own until the viewer renames it with the pencil beside it; the name is
+`DrawingOptions.name`, saved with the drawing, and Cancel restores it with the rest. A page shown
+puts the keyboard in its first field, and the dialog keeps its top edge where it opened as pages of
+other sizes come and go. Its lists hang under the controls that open them, past the dialog's edge
+where they need to. The Template menu saves the current setup under a name, applies a saved one,
+or applies the tool's defaults: its own look and setup, put on the drawing at once, with its words
+kept.
+
+A color in the dialog opens its popover under the button that holds it: the offered colors, the
+colors the viewer added with the plus after them, and the opacity, and for a stroke its thickness
+and line style. Every choice applies at once and the popover stays up for the next one; Escape
+returns to the button. The plus opens a custom color editor that takes a hex of three or six digits
+or a pick on its saturation and brightness area and hue strip. A color added there joins the
+viewer's own, newest first, kept with the drawing preferences in `ChartStorage`, and the settings
+bar's palette offers them too.
+
+The line tools' Style page carries the stroke with its two ends, the extensions, the middle point,
+the price labels and, under Info, the stats a line reads (price range, percent change, the change
+counted in the symbol's smallest price move, bars, date and time range, angle), where they stand
+(left, center, right, or auto, which keeps them inside the pane), and whether they show always or
+only while the line is selected. A horizontal line offers its price label, a vertical line its time
+label, a cross line both. A rectangle offers its extensions, its border, a middle line with a stroke
+of its own and its background; every other shape its border and background; a curve its stroke and
+ends, its extensions along the tangents it ends on, and its background. A background switched off
+keeps its color and opacity for when it is switched back on. The Text page sets the words' color,
+size, weight and slant on one line over the words, and where the tool places them, where they stand:
+above, on or below a line, above, inside or below a box, along it from left to right, and for a
+vertical line whether they read across it or run up it. `NO_COORDINATES_TAB` names the tools whose
+points are drawn rather than typed, and `PRICE_ONLY_COORDS` the levels that span every bar.
+
+A retracement, a trend-based extension and a fib channel lay their levels out two to a line, each
+level its switch, its value and its color, under the thickness and style every level line is drawn
+in. The one color recolors every level at once, and shows the color the levels share or a split
+well while they differ. The bands between levels fill at `backgroundOpacity` while
+`fillBackground` holds them; `coeffsAsPercents` reads a level's ratio as a percent, and
+`labelsHAlign` and `labelsVAlign` stand the labels before, at the middle of or after the levels,
+above, on or below each line. A retracement and an extension draw their trend line through the
+swing points in a stroke of its own (`trendLine`, `trendLineColor`, `trendLineWidth`,
+`trendLineStyle`), stand each level's own words where `showText`, `textHAlign` and
+`textVAlign` put them, and with `levelsOnLogScale` divide the swing by log price while the price
+scale is logarithmic, which `Viewport.logScale` reports.
+
+A time zone, a trend-based time, fib circles, speed resistance arcs, a fib wedge and a pitchfan
+stand their levels one to a line, each level its switch, its value and its own stroke: a level's
+`width` and `style` draw it apart from the drawing's own. A time zone and a trend-based time label
+their lines where `labelsHAlign` and `labelsVAlign` put them along and across the pane; a circle
+fib reads its ratios as percents with `coeffsAsPercents`; an arc fib closes its arcs into circles
+with `fullCircles`; the trend-based time, the circles, the arcs and the wedge draw a trend line in a
+stroke of its own, and a pitchfan its median (`medianColor`, `medianWidth`, `medianStyle`). A
+speed resistance fan and a gann box divide their box on `priceLevels` across it and `timeLevels`
+down it, each side's labels switched on their own; a fan draws a grid at the divisions in a stroke
+of its own, and a gann box shades its price and time bands on their own switches and draws its
+angles corner to corner in `anglesColor`. `reverse` counts a box's divisions from the other
+corner.
+
+A pitchfork stands its line pairs one to a line the same way, each pair its switch, its value and
+its own stroke, under its median's stroke (`medianColor`, `medianWidth`, `medianStyle`) and over
+the bands between pairs, each in its outer pair's color at `backgroundOpacity` while
+`fillBackground` is on. `extendLines` runs every line back past the fork's start, and `variant`
+switches its construction in place: `original`, `schiff`, `modified_schiff` or `inside`.
+A fib spiral winds clockwise out from its first point, and `counterclockwise` winds it the other
+way.
+
+A gann square and a gann square fixed draw a grid of six lines at their fifths (`levels`), fan
+lines from the corner they count from out to their far sides (`fans`) and arcs about that corner
+(`arcs`), each line its switch, its color and its width, a fan line or an arc at its ratio of the
+square's unit, `x` along the time side for `y` along the price side. Their pages set each set
+under its section, two to a line; the bands between arcs follow `fillBackground` and
+`backgroundOpacity`, and `reverse` counts from the other corner. A gann square holds its second
+corner at `scaleRatio` price for every bar between its corners, a ratio it takes from the pane
+when it is first drawn so it opens square, and typing a Price/bar ratio moves the corner to it; with
+`showLabels` it reads its price and bar ranges and their ratio under it. A square fixed stays
+square on the pane whatever its scale. A gann fan draws its rays at their price-to-time ratios, 1/8
+to 8/1, each in its own stroke, with the bands between them and each ray's ratio at its end.
+
+A regression trend fits its line through the `source` of the bars between its points: a bar's
+open, high, low, close or volume, or one of the averages `hl2`, `hlc3`, `ohlc4` and `hlcc4`
+(`BAR_PRICE_SOURCES`). Its bands stand `upperDeviation` and `lowerDeviation` standard deviations
+from it, the lower counted down, each shown by `useUpper` and `useLower`; the line and each band
+switch and stroke on their own (`baseLine`, `upLine`, `downLine` with their colors, widths and
+styles), `extendLines` runs them to the pane's edges, and `showPearsons` reads the correlation
+under them.
+
+A parallel channel draws its levels at ratios of its width, 0 its baseline and 1 the parallel through
+its third point, each level its switch, its value and its own stroke, over its body between 0 and 1.
+A flat top/bottom and a disjoint channel end their sides as `leftEnd` and `rightEnd` set and read
+each side's prices at its ends with `showPrices`, in `pricesColor`, `pricesFontSize`,
+`pricesBold` and `pricesItalic`. A channel's `fillBackground` switches its body, and its words
+stand above it, inside it or below it with `textVAlign`, at its start, middle or end with
+`textHAlign`. A parallel channel's Coordinates page writes its third point as the price its
+parallel stands from the baseline.
+
+A sector shades the two halves of its slice, parted by the ray through its arc's middle, in `color1`
+and `color2` while `fillBackground` is on. A bars pattern paints its captured bars as `mode` says:
+`hl` their high-low ranges, `oc` their open-close ranges, or a line through each bar's close, open,
+high, low or `hl2`. A ghost feed's average candle span is held as a price and written on its page in
+the symbol's minimum ticks.
+
+An anchored VWAP weighs the `source` of every bar since its point by the bar's volume, and stands
+its bands off the average by `bandMultipliers` standard deviations or, with `bandsMode`
+`percent`, percents of it, each band calculated while its `bandsOn` switch is on. A volume profile
+reads its rows' volumes beside them with `showValues` and its point of control and shown value
+area bounds on the price scale with `showLabelsOnPriceScale`. A range meter reads the stats its
+switches choose in a label of its own color, size and background.
+
+A text's box switches its background (`fillBackground`) and its border (`drawBorder`, in the
+drawing's stroke color) on their own, and with `wordWrap` its words wrap at `wordWrapWidth` pixels;
+a callout's words wrap the same way inside a border at the drawing's width. A note ties a label to
+the point it notes: its first point is that point, its second the label's, with a line between them
+in the drawing's stroke color and the label's border in `borderColor`; a pin's words stand in a box
+of the same kind under its marker. A price note runs a line from its price to a tag that reads it,
+the tag in a text style and colors of its own (`labelTextColor`, `labelFontSize`, `labelBold`,
+`labelItalic`, `labelBackgroundColor`, `labelBorderColor`), its words along the line where
+`textVAlign` and `textHAlign` stand them. A signpost stands on its bar's high, or its low for a
+plate below the bar, its plate `position` percent of the pane's height away, so the plate keeps its
+height over the bar as the price scale moves; with `showImage` the plate leads with its `emoji`,
+and its words read in white or black, whichever reads on the plate. A table stands its cells' words
+at their left, middle or right with `textHAlign`, its border and grid in the drawing's stroke color.
+
+A brush fills the area its stroke closes back to its start while `fillBackground` is on, and a brush
+and a path head their ends with arrows as `leftEnd` and `rightEnd` say, a path with an arrow at its
+last point at first. A highlighter's width is in pixels, 8 to 96 on its page. The emoji and the
+sticker have no settings beyond their visibility: a glyph's size is set by its grips on the chart. An
+icon's page sets its tint, and an image's page chooses its picture from a
+box that names the formats and the size the intake takes, and sets how see-through it is drawn.
+
+The pattern tools are read by their letters and carry no words of their own: their Style page sets
+the letters' color, size, weight and slant on a Label row, then the border and, for the patterns
+that shade their legs, the background, which `fillBackground` switches off and on keeping its
+color. A three drives pattern stands on seven points, its reversal after the third drive the last.
+
+An Elliott wave count writes its labels in its wave's color, as its `degree` writes them: the
+fifteen degrees from `supermillennium` to `minuscule` (`ELLIOTT_DEGREES`) stand in five threes,
+each three ringed, in parentheses and bare, in roman numerals or figures and in capitals or small
+letters. `showWave` switches the wave through its pivots, and the labels stand without it.
+
+The text, the comment, the note, the signpost, the callout and the pin type their words on the
+chart. The drawing paints the words as they are typed, with their caret, selection and
+placeholder, while a field nobody sees, laid exactly over them in their own type and line height,
+takes the keys: the session's `inline` (`TextInlineEdit`) says where the words stand
+(`TextEditFrame`) and hears what the field holds (`TextDraft`). Enter and Shift with Enter break
+the line; Escape, Ctrl or Cmd with Enter, and a press elsewhere commit the words exactly as typed,
+the drawing still selected after Escape. A click on the words of the selected drawing types again,
+and a double-click opens its settings. A text, a comment, a note or a signpost left without words
+stays while it is selected and goes once it is not; a callout left without words goes as its edit
+ends; a pin keeps its place without words. `AttachDrawingsOptions.placeholder` names the words an
+empty drawing shows and `AttachDrawingsOptions.inks` the chart's own inks (`DrawingInks`).
+
+A table types into the cell a click on the selected table lands in, Tab moving on to the next cell
+and from the last to the first. Its floating bar and the chart's menu over it add a column right of
+the cell last typed in and a row below it, or at the table's ends where no cell is, and the menu
+removes that cell's row and column (`chart.drawings.tableRemoveRow`,
+`chart.drawings.tableRemoveColumn`). A hovered grid line resizes its column or row, and the corners
+scale the table. The price label, the price note, the arrow marks, the arrow marker and the flag
+open no editor: their words, where they have any, are set in their settings, which a double-click
+opens. Any other text-bearing tool types in a box of its own: Ctrl or Cmd with Enter commits,
+Escape cancels, and a press on the chart commits.
 
 Templates are named setups a viewer saves from either surface and applies on demand. They and
 the remembered defaults ride `ChartSaveLoadAdapter.templates('drawing')`, so a host that keeps
@@ -2866,7 +3063,9 @@ adapter they last the page.
 
 The image and glyph tools reach your host through `ChartWidgetOptions.assets`. `intakeImage`
 turns a picked file into a payload within the caps and answers a refusal as a code the chart
-resolves through its own catalog; `glyphSource` answers the artwork URL an emoji or sticker draws
+resolves through its own catalog. The payload's `dataUrl` is always a PNG or a JPEG, whatever the
+picked file was, so a saved chart opens everywhere: decode a WEBP and re-encode it on a canvas, as a
+PNG where it has transparency and a JPEG otherwise; `glyphSource` answers the artwork URL an emoji or sticker draws
 with, or null to draw the glyph as text. Emoji artwork from Twemoji is bundled and works without
 an asset port or external requests. Omit `glyphSource` to use it. It is a chunk of its own, which
 the chart imports the first time it draws an emoji, so a chart that never shows one never loads
@@ -2883,6 +3082,8 @@ layer.armTool('rectangle')
 layer.destroy()
 ```
 
+A layer you mount yourself is told the symbol's grid, formatter and currency through `setTick`,
+`setPriceFormatter` and `setCurrency`; a position offers its risk as an amount in that currency.
 A layer you mount yourself arms whatever you arm. Its `copies` option answers whether a new drawing
 may be made as a copy of a drawing of a type: return false for a tool you do not offer, and clone,
 paste and a Control- or Command-drag duplicate make nothing for its drawings, `canPaste` answers
@@ -2896,7 +3097,7 @@ never imports any of it.
 ```ts
 import { buildDrawingToolbarGroups, drawingTools, parseDrawingsStore, restoreDrawings, serializeDrawingsStore } from '@trdrs/quickcharts/drawings'
 
-// The catalog: 90 tools in 14 categories, read-only.
+// The catalog: 89 tools in 14 categories, read-only.
 const trendLine = drawingTools.get('trend_line')
 const fibs = drawingTools.byCategory('fibonacci')
 
@@ -2936,8 +3137,9 @@ const preset = await templates.defaultFor('trend_line')
 ```
 
 Image-backed and glyph tools reach the host through one explicit asset port. The library owns the
-rules (JPG or PNG, 2 MB, a 2000 px longest edge, downscaled rather than refused) and names each
-refusal with a code that resolves through the chart's own catalog; the host owns the bytes.
+rules (a JPG, a PNG or a WEBP, stored as a PNG or a JPEG, 2 MB, a 2000 px longest edge, downscaled
+rather than refused) and names each refusal with a code that resolves through the chart's own
+catalog; the host owns the bytes.
 
 ```ts
 import { checkImageFile, fittedSize, IMAGE_ACCEPT, type DrawingAssetPort } from '@trdrs/quickcharts/drawings'
@@ -2947,7 +3149,8 @@ const assets: DrawingAssetPort = {
     const bad = checkImageFile(file)
     if (bad) return { ok: false, ...bad }
     const { width, height } = fittedSize(1200, 900)
-    return { ok: true, asset: { dataUrl: await myBackend.read(file), width, height, downscaled: false } }
+    // A PNG or a JPEG whatever the picked file was: a WEBP is re-encoded before it is stored.
+    return { ok: true, asset: { dataUrl: await myBackend.pngOrJpeg(file), width, height, downscaled: false } }
   },
   // Optional: glyphSource replaces the bundled emoji artwork.
   // glyphSource: (glyph) => myBackend.emojiUrl(glyph),
@@ -2963,14 +3166,21 @@ What to know:
 - **Every tool places.** Fixed-anchor tools place by press-drag-release or click then click; an
   instant tool (the position tools) lands whole from one press; a multipoint tool adds a point per
   click until a double-click ends the run; a freehand tool captures the drag as a stroke; a
-  text-bearing tool opens the inline editor as it lands. `armTool` **throws** only for a name the
-  catalog does not know, and `placeableByWidget(type)` answers in advance.
+  text-bearing tool opens the inline editor as it lands; a right-click while a drawing is half
+  placed takes it back and puts the tool down. `armTool` **throws** only for a name the catalog does
+  not know, and `placeableByWidget(type)` answers in advance.
 - **Persistence speaks a shared codec.** The store document (`{ [symbol]: SerializedDrawing[] }`,
   via `parseDrawingsStore`/`serializeDrawingsStore`) is the SAME document every host of the codec
   reads and writes, so drawings survive moving between hosts. A drawing bound to one chart (sync
   off) lives in the adapter's chart-bound scope for the symbol; a shared drawing lives in the
   symbol's scope, and a refused write merges the stored document over the layer's own before it
   writes again.
+- **A save keeps its look.** A drawing saves at `v: 3`. A save at `v: 2` restores with the look it
+  was saved with: its tool writes the values that paint it so and saves at `v: 3` with them, the
+  looks the tool's pages do not set riding in the props `INERT_PROPS` lists. A gann square, a gann
+  square fixed, a speed resistance fan, a pitchfan, the text and annotation tools, the marks and a
+  table saved at `v: 2` paint as they were saved (`savedLook`) until their settings change. A host
+  that writes drawings itself writes `v: 3`.
 - **Keys run through the registry.** Delete and Backspace remove the selection, Escape cancels a
   placement, disarms, or closes the inline editor, and Ctrl (or Cmd) with C and V copy and paste a
   drawing. Each resolves to a `chart.drawings.*` command, so your access policy gates the keyboard
@@ -2982,7 +3192,8 @@ What to know:
   a placed or dragged anchor onto the bar's own open, high, low or close; a locked drawing
   selects, takes the Delete and Clone a viewer asks for by name, and refuses a move, a resize, a
   text edit, the eraser and a Ctrl-drag copy; lock all suspends every edit, Delete and Clone
-  included, until it is released.
+  included, until it is released. A right-click selects the drawing it lands on, so the menu that
+  follows acts on it, and the handle under a mouse stands out.
 
 ## Extensions
 

package/dist/adapters/rest.d.ts

@@ -1,4 +1,4 @@
-import { C as ChartSaveLoadAdapter } from '../resources-C0cYryO9.js';
+import { C as ChartSaveLoadAdapter } from '../resources-Le6flcEn.js';
 
 /** The three template collections. */
 type RestTemplateKind = 'indicator' | 'drawing' | 'palette';