@trdrs/quickcharts 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @trdrs/quickcharts
 
+## 1.1.0
+
+The symbol search can name what it is limited to, with a host-painted mark, beside the asset-class filters (`search.scope`, `SearchScope`).
+
+## 1.0.1
+
+Emoji drawings and the picker use bundled Twemoji artwork without a host asset server.
+Hosts may supply an image intake port while keeping the bundled emoji artwork.
+
 ## 1.0.0
 
 - A complete browser chart over host-supplied market data and storage, with seven chart styles,

package/README.md

@@ -1280,18 +1280,25 @@ in `ui`; hiding one removes the control and leaves its commands.
 ```ts
 import { createChart, createUdfDatafeed } from '@trdrs/quickcharts'
 
+declare const portfolio: { name: string } | null
+
 const trimmed = createChart({
   container,
   datafeed: createUdfDatafeed({ baseUrl: 'https://feed.example.com/udf' }),
   ui: { navigation: false, topBar: { layouts: false, image: false } },
-  search: { classNames: { future: 'Futures', crypto: 'Crypto' } },
+  search: {
+    classNames: { future: 'Futures', crypto: 'Crypto' },
+    scope: () => (portfolio ? { label: portfolio.name } : null),
+  },
   preferences: { savedTimeframes: ['1m', '15m', '1h', '1d'], layoutAutosave: true },
 })
 trimmed.on('saveNeeded', () => note('the layout has unsaved changes'))
 ```
 
 The search dialog's class chips come from your datafeed's `config().classes`, named through
-`search.classNames`; a class you do not name wears its token. The range presets read your
+`search.classNames`; a class you do not name wears its token. `search.scope` names what your
+search is limited to at the far edge of that strip, with the mark its `mark` paints; your datafeed
+decides what is found. The range presets read your
 datafeed's optional `earliestBar(symbol)`: a preset deeper than the history you serve is disabled.
 
 ```ts
@@ -2062,8 +2069,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
-with, or null to draw the glyph as text. Without the port the image tool does not open and glyphs
-draw as text.
+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. Without the port the image tool
+does not open. Keep the Twemoji credit in `THIRD-PARTY-NOTICES.md` accessible in your product.
 
 The layer is also mountable on its own lightweight-charts pair, without the widget:
 
@@ -2136,7 +2144,8 @@ const assets: DrawingAssetPort = {
     const { width, height } = fittedSize(1200, 900)
     return { ok: true, asset: { dataUrl: await myBackend.read(file), width, height, downscaled: false } }
   },
-  glyphSource: (glyph) => myBackend.emojiUrl(glyph),
+  // Optional: glyphSource replaces the bundled emoji artwork.
+  // glyphSource: (glyph) => myBackend.emojiUrl(glyph),
 }
 note(IMAGE_ACCEPT)
 ```

package/THIRD-PARTY-NOTICES.md

@@ -4,6 +4,10 @@ This document lists every third-party package in the dependency closure of `@trd
 
 `@trdrs/quickcharts` bundles no third-party code. It declares one peer dependency that your application installs and bundles, and that peer installs one package of its own. Because your application bundle redistributes these packages, their license conditions attach to your product; this document tells you what each one asks for.
 
+### Bundled Twemoji artwork
+
+The emoji SVG graphics are from [Twemoji](https://github.com/jdecked/twemoji), copyright Twitter, Inc and other contributors, licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/). The graphics are combined into an internal artwork table; SVG identifiers are namespaced per glyph. Keep this credit and the license link accessible to users of your product. The graphics license is separate from the Apache-2.0 license of the library code.
+
 | Package | Version | License | Reached through |
 |---|---|---|---|
 | `fancy-canvas` | 2.1.0 | MIT | `lightweight-charts@5.2.0` |

package/dist/{assets-C1GQvm0w.d.ts → assets-ySndlUS3.d.ts}

@@ -1427,10 +1427,10 @@ interface DrawingAssetPort {
      *  used. The host owns the decode and the resample; `checkImageFile` and `fitScale` below are the
      *  library's rules it applies. */
     intakeImage(file: File): Promise<ImageIntakeResult>;
-    /** Artwork for one emoji or sticker glyph, as a URL the canvas can draw, or null to fall back to
+    /** Optional replacement for the bundled Twemoji artwork. Artwork for one emoji or sticker glyph, as a URL the canvas can draw, or null to fall back to
      *  drawing the glyph as text. Icon marks always stay text: their ink is tinted by the stroke
      *  color, which artwork cannot carry. */
-    glyphSource(glyph: string): string | null;
+    glyphSource?(glyph: string): string | null;
 }
 /** Type and size gate, pure so it needs no DOM and no real file. */
 declare function checkImageFile(file: {

package/dist/{chunk-PD3DEWMQ.js → chunk-RDAK5MUM.js}

@@ -6956,4 +6956,4 @@ export {
   NO_DASH,
   INPUT_PROPS
 };
-//# sourceMappingURL=chunk-PD3DEWMQ.js.map
+//# sourceMappingURL=chunk-RDAK5MUM.js.map