@bicharts/chart-host 0.6.102 → 0.6.103

package/dist/{chunk-M7MBTLDP.mjs → chunk-7XRQUFVH.mjs}

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.17.0";
+var HOST_CONTRACT_VERSION = "1.20.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
@@ -9,6 +9,7 @@ var AXIS_FILTER_CLASS = "d3-axis-filter";
 var LIFT_SELECTED_CLASS = "d3-lift-selected";
 var CONTROL_CLASS = "lch-control";
 var ROW_IDX_ATTR = "data-row-idx";
+var NOTE_STYLE_ATTR = "data-bic-note-style";
 var SELECTION_RULE_ATTR = "data-lch-sel-rule";
 var SELECTION_RULE_CLICKED_MARKS = "clicked-marks";
 var MARK_KEY_ATTR = "data-mark-key";
@@ -80,6 +81,7 @@ export {
   LIFT_SELECTED_CLASS,
   CONTROL_CLASS,
   ROW_IDX_ATTR,
+  NOTE_STYLE_ATTR,
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   MARK_KEY_ATTR,

package/dist/{chunk-ASLRGGLV.mjs → chunk-CPLWAW3Z.mjs}

@@ -4,7 +4,7 @@ import {
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 
 // src/hitTargets.ts
 var SVG_NS = "http://www.w3.org/2000/svg";

package/dist/{chunk-B6BLSIID.mjs → chunk-IE426WU6.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-5OCL4EFM.mjs";
+} from "./chunk-P2DLK7WZ.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;

package/dist/{chunk-3JBJ2SIF.mjs → chunk-IE7TM6DX.mjs}

@@ -2,7 +2,7 @@
 import {
   CONTAINER_SLOT_SCROLL,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 
 // src/fit.ts
 var SCROLL_SLACK_PX = 8;

package/dist/{chunk-5OCL4EFM.mjs → chunk-P2DLK7WZ.mjs}

@@ -8,7 +8,7 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   XFILTER_REFRESH_EVENT
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 
 // src/selection.ts
 function rowIdxsFromMark(el) {

package/dist/{chunk-PMA56BKD.mjs → chunk-PA5V6J6K.mjs}

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
   SNAPSHOT_SVG_ATTR
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 
 // src/snapshot.ts
 var DEFAULT_TIMEOUT_MS = 2e3;

package/dist/{chunk-WSNDXS3Z.mjs → chunk-TLIBO5PT.mjs}

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
   LASSO_KNOB_KEY
-} from "./chunk-B6BLSIID.mjs";
+} from "./chunk-IE426WU6.mjs";
 
 // src/filterScope.ts
 function viewToken(view) {

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-PMA56BKD.mjs";
+} from "./chunk-PA5V6J6K.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -24,8 +24,10 @@ import {
   AUTO_RAMP_MIN_STEP_DELTA_E,
   BACKING_MAJORITY,
   CLIP_TOLERANCE_PX,
+  CSV_MIME,
   D3_PLUGIN_PACKAGES,
   DARK_TEXT,
+  EXPORT_FORMATS,
   GLYPH_SAMPLE_N,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
@@ -45,13 +47,17 @@ import {
   STRADDLE_TARGET_CONTRAST,
   VALUE_AXIS_MIN_FIT,
   WHITE_TEXT_BG_LUM,
+  XLSX_MIME,
   applyLabelContrast,
   assembleD3,
   autoRampCanvas,
   autoRampMinStep,
   backingHoldsGlyph,
   blankRenderFlag,
+  browserSaveFile,
+  buildExportFile,
   buildRenderPayload,
+  bytesToBase64,
   cellSuppressesNormalize,
   censusClippedText,
   censusColourSpread,
@@ -67,7 +73,12 @@ import {
   createChartHost,
   decideLabelColor,
   deltaEHex,
+  excelNumberFormat,
+  excelSerial,
   explainRenderFailure,
+  exportFileName,
+  exportFormatsFor,
+  exportTableService,
   geoAssetFor,
   geoFromCache,
   glyphSampleGrid,
@@ -89,15 +100,18 @@ import {
   resolveOptions,
   scopeChartIds,
   sessionViewStateProvider,
+  sheetName,
   straddleSampleGrid,
   straddles,
   stripEsmExports,
   stripJsComments,
   syncMemberSelection,
+  tableToCsv,
+  tableToXlsx,
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-ALX4D2I2.mjs";
+} from "./chunk-4BR6VJQX.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -124,13 +138,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-B6BLSIID.mjs";
+} from "./chunk-IE426WU6.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-ASLRGGLV.mjs";
+} from "./chunk-CPLWAW3Z.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -155,7 +169,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-5OCL4EFM.mjs";
+} from "./chunk-P2DLK7WZ.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -184,7 +198,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-3JBJ2SIF.mjs";
+} from "./chunk-IE7TM6DX.mjs";
 import {
   _3,
   l,
@@ -230,6 +244,7 @@ import {
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
   MAX_MAP_POINTS_DEFAULT,
+  NOTE_STYLE_ATTR,
   NO_ROW_MARKS_ATTR,
   ROW_IDX_ATTR,
   SEASONAL_MARKERS_DEFAULT,
@@ -243,9 +258,32 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 import "./chunk-GHODWOAL.mjs";
 
+// src/hostLinks.ts
+var LINK_SCHEME_RE = /^(https?:\/\/|mailto:)/i;
+function hostLinkServices(open, clipboard) {
+  const out = {};
+  if (clipboard) {
+    out.copyText = (text) => {
+      try {
+        if (typeof clipboard.writeText !== "function") return false;
+        return clipboard.writeText(String(text ?? "")).then(() => true, () => false);
+      } catch {
+        return false;
+      }
+    };
+  }
+  if (typeof open === "function") {
+    out.openUrl = (url) => {
+      const u2 = String(url ?? "").trim();
+      if (LINK_SCHEME_RE.test(u2)) open(u2);
+    };
+  }
+  return out;
+}
+
 // src/optionsVocabulary.ts
 var MAX_MAP_POINTS_MIN = 10;
 var MAX_MAP_POINTS_MAX = 1e5;
@@ -911,6 +949,133 @@ function safely(fn) {
   }
 }
 
+// src/shareRate.ts
+var TARGET_ID = /^[a-z0-9]{1,8}$/;
+function httpsUrl(raw) {
+  if (typeof raw !== "string" || !raw) return null;
+  try {
+    const u2 = new URL(raw);
+    return u2.protocol === "https:" ? u2.href : null;
+  } catch {
+    return null;
+  }
+}
+function shareRateLineModel(ask) {
+  if (!ask || typeof ask !== "object") return null;
+  const rateUrl = httpsUrl(ask.rateUrl ?? ask.RateUrl);
+  const share = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const t2 of ask.targets ?? ask.Targets ?? []) {
+    if (!t2 || typeof t2 !== "object") continue;
+    const id = String(t2.id ?? t2.Id ?? "");
+    const label = String(t2.label ?? t2.Label ?? "").trim();
+    const url = httpsUrl(t2.url ?? t2.Url);
+    if (!TARGET_ID.test(id) || !label || !url || seen.has(id)) continue;
+    seen.add(id);
+    share.push({ id, label, url });
+  }
+  if (!rateUrl && share.length === 0) return null;
+  return { share, rateUrl };
+}
+var DEFAULT_TEXT3 = {
+  lead: "Like it? Share it on",
+  separator: " \xB7 ",
+  or: ", or",
+  rate: "rate it on AppSource",
+  rateAlone: "Like it? Rate it on AppSource",
+  note: "Your ratings and feedback encourage us to do more.",
+  thanks: "Thanks for rating it.",
+  rateToo: "Rate it on AppSource too",
+  shareMenu: "Share it"
+};
+function mountShareRateLine(container, opts) {
+  const model = shareRateLineModel(opts.ask);
+  if (!model) return null;
+  const doc = container.ownerDocument ?? document;
+  const text = { ...DEFAULT_TEXT3, ...opts.text ?? {} };
+  const wrap = doc.createElement("div");
+  wrap.className = "bic-share-rate" + (opts.className ? " " + opts.className : "");
+  const span = (cls, s2) => {
+    const el = doc.createElement("span");
+    el.className = cls;
+    el.textContent = s2;
+    return el;
+  };
+  const link = (cls, label, url, onClick) => {
+    const a2 = doc.createElement("a");
+    a2.className = cls;
+    a2.href = url;
+    a2.textContent = label;
+    a2.rel = "noopener noreferrer";
+    a2.addEventListener("click", (e2) => {
+      e2.preventDefault();
+      safely2(() => opts.open(url));
+      safely2(onClick);
+    });
+    return a2;
+  };
+  const appendNetworks = (into) => model.share.forEach((t2, i2) => {
+    if (i2 > 0) into.append(span("bic-share-rate-sep", text.separator));
+    const a2 = link("bic-share-rate-share", t2.label, t2.url, () => opts.onShare?.(t2.id));
+    a2.setAttribute("data-target", t2.id);
+    into.append(a2);
+  });
+  if (opts.layout === "menu") {
+    wrap.setAttribute("data-layout", "menu");
+    wrap.append(span("bic-share-rate-lead", text.thanks + " "));
+    if (model.rateUrl) wrap.append(link("bic-share-rate-rate", text.rateToo, model.rateUrl, () => opts.onRate?.()));
+    if (model.share.length > 0) {
+      if (model.rateUrl) wrap.append(span("bic-share-rate-sep", text.separator));
+      const toggle = doc.createElement("button");
+      toggle.type = "button";
+      toggle.className = "bic-share-rate-toggle";
+      toggle.textContent = text.shareMenu;
+      toggle.setAttribute("aria-expanded", "false");
+      const menu = doc.createElement("span");
+      menu.className = "bic-share-rate-menu";
+      menu.hidden = true;
+      menu.append(span("bic-share-rate-menu-gap", " "));
+      appendNetworks(menu);
+      toggle.addEventListener("click", () => {
+        const open = menu.hidden;
+        menu.hidden = !open;
+        toggle.setAttribute("aria-expanded", String(open));
+        if (open) safely2(() => opts.onMenu?.());
+      });
+      wrap.append(toggle, menu);
+    }
+  } else if (model.share.length > 0) {
+    wrap.append(span("bic-share-rate-lead", text.lead + " "));
+    appendNetworks(wrap);
+    if (model.rateUrl) {
+      wrap.append(span("bic-share-rate-or", text.or + " "));
+      wrap.append(link("bic-share-rate-rate", text.rate, model.rateUrl, () => opts.onRate?.()));
+    }
+    wrap.append(span("bic-share-rate-end", "."));
+  } else {
+    wrap.append(link("bic-share-rate-rate", text.rateAlone, model.rateUrl, () => opts.onRate?.()));
+    wrap.append(span("bic-share-rate-end", "."));
+  }
+  if (text.note && opts.layout !== "menu") wrap.append(span("bic-share-rate-note", " " + text.note));
+  const stop = (e2) => e2.stopPropagation();
+  wrap.addEventListener("click", stop);
+  container.appendChild(wrap);
+  safely2(() => opts.onShown?.());
+  return {
+    element: wrap,
+    destroy() {
+      wrap.removeEventListener("click", stop);
+      wrap.remove();
+    }
+  };
+}
+function safely2(fn) {
+  try {
+    fn();
+  } catch {
+  }
+}
+
 // src/qualifyGroups.ts
 function newQualifyGroupState() {
   return { preview: false, previewClosed: false, projected: false, notRecommended: false, rankedSeen: false };
@@ -2164,6 +2329,7 @@ export {
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
+  CSV_MIME,
   D3_PLUGIN_PACKAGES,
   DARK_TEXT,
   DEFAULT_FILTER_MATCH_STYLE,
@@ -2173,6 +2339,7 @@ export {
   DIM_OPACITY_VAR,
   DRAG_NOT_CLICK_PX,
   DUPLICATE_GENERATE_WINDOW_MS,
+  EXPORT_FORMATS,
   FILTER_MIN_HEIGHT_PX,
   FILTER_MIN_TERM_CHARS,
   FILTER_MIN_WIDTH_PX,
@@ -2228,6 +2395,7 @@ export {
   MIN_DELTA_E,
   MIN_HIT_BAND_PX,
   MIN_RAMP_FILLS,
+  NOTE_STYLE_ATTR,
   NO_ROW_MARKS_ATTR,
   OPTIONS_VOCABULARY,
   PAGE_MATCH_TOLERANCE,
@@ -2270,6 +2438,7 @@ export {
   VIEW_ONLY_UI_STATE_KEYS,
   WHITE_TEXT_BG_LUM,
   XFILTER_REFRESH_EVENT,
+  XLSX_MIME,
   actionFor,
   applyLabelContrast,
   armGenerateGuard,
@@ -2281,11 +2450,14 @@ export {
   backingHoldsGlyph,
   bareBase64,
   blankRenderFlag,
+  browserSaveFile,
+  buildExportFile,
   buildPalette,
   buildPaletteFromSeed,
   buildProductFeedbackPayload,
   buildRenderPayload,
   buildReviewWire,
+  bytesToBase64,
   canConfirmLaunch,
   canShowLastChart,
   captureSvgSnapshot,
@@ -2328,7 +2500,13 @@ export {
   dispatchRowSet,
   encodePendingGenerate,
   ensureCrossfilterHitTargets,
+  excelNumberFormat,
+  excelSerial,
   explainRenderFailure,
+  exportFileName,
+  exportFormatsFor,
+  sheetName as exportSheetName,
+  exportTableService,
   filterFitsChooser,
   filterMatchStyleOf,
   filterQualifyRows,
@@ -2344,6 +2522,7 @@ export {
   glyphSampleGrid,
   hasRefusalsToShow,
   hitBandFlag,
+  hostLinkServices,
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
@@ -2379,6 +2558,7 @@ export {
   measureContainerBoxes,
   minContrastOver,
   mountProductFeedbackBox,
+  mountShareRateLine,
   needsScroll,
   newIdScope,
   newQualifyGroupState,
@@ -2451,6 +2631,7 @@ export {
   selectionRuleOf,
   servedCorrelationProves,
   sessionViewStateProvider,
+  shareRateLineModel,
   shouldCaptureThumbnail,
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
@@ -2466,6 +2647,8 @@ export {
   svgToDataUrl,
   syncMemberSelection,
   tableHostOf,
+  tableToCsv,
+  tableToXlsx,
   takeScroll,
   toRGBA,
   toSourceRows,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-PMA56BKD.mjs";
+} from "./chunk-PA5V6J6K.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-3JBJ2SIF.mjs";
-import "./chunk-M7MBTLDP.mjs";
+} from "./chunk-IE7TM6DX.mjs";
+import "./chunk-7XRQUFVH.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -14,10 +14,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-WSNDXS3Z.mjs";
-import "./chunk-B6BLSIID.mjs";
-import "./chunk-5OCL4EFM.mjs";
-import "./chunk-M7MBTLDP.mjs";
+} from "./chunk-TLIBO5PT.mjs";
+import "./chunk-IE426WU6.mjs";
+import "./chunk-P2DLK7WZ.mjs";
+import "./chunk-7XRQUFVH.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -13,7 +13,7 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-WSNDXS3Z.mjs";
+} from "./chunk-TLIBO5PT.mjs";
 import {
   assembleD3,
   createChartGroup,
@@ -22,14 +22,14 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-ALX4D2I2.mjs";
-import "./chunk-B6BLSIID.mjs";
-import "./chunk-ASLRGGLV.mjs";
-import "./chunk-5OCL4EFM.mjs";
-import "./chunk-3JBJ2SIF.mjs";
+} from "./chunk-4BR6VJQX.mjs";
+import "./chunk-IE426WU6.mjs";
+import "./chunk-CPLWAW3Z.mjs";
+import "./chunk-P2DLK7WZ.mjs";
+import "./chunk-IE7TM6DX.mjs";
 import "./chunk-CNT3QA3R.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-M7MBTLDP.mjs";
+import "./chunk-7XRQUFVH.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-M7MBTLDP.mjs";
+} from "./chunk-7XRQUFVH.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/contract.d.ts

@@ -1,4 +1,5 @@
-export declare const HOST_CONTRACT_VERSION = "1.17.0";
+import type { ExportFormat, ExportTableService, SaveFileService } from "./exportTable";
+export declare const HOST_CONTRACT_VERSION = "1.20.0";
 export type GeoPointPrecision = "latlon" | "city" | "zip3" | "state" | "country";
 /** Every valid tier, ordered most precise → coarsest. Runtime form of GeoPointPrecision. */
 export declare const GEO_POINT_PRECISIONS: readonly GeoPointPrecision[];
@@ -13,6 +14,7 @@ export declare const AXIS_FILTER_CLASS = "d3-axis-filter";
 export declare const LIFT_SELECTED_CLASS = "d3-lift-selected";
 export declare const CONTROL_CLASS = "lch-control";
 export declare const ROW_IDX_ATTR = "data-row-idx";
+export declare const NOTE_STYLE_ATTR = "data-bic-note-style";
 export declare const SELECTION_RULE_ATTR = "data-lch-sel-rule";
 export declare const SELECTION_RULE_CLICKED_MARKS = "clicked-marks";
 export declare const MARK_KEY_ATTR = "data-mark-key";
@@ -126,6 +128,11 @@ export interface RenderOptions {
     dataComplete?: boolean;
     rowsWithheld?: number;
     rowsFilteredOut?: number;
+    openUrl?: (url: string) => void;
+    copyText?: (text: string) => boolean | void | Promise<boolean | void>;
+    saveFile?: SaveFileService;
+    exportFormats?: readonly ExportFormat[];
+    exportTable?: ExportTableService;
     geoPointDest?: {
         precision: GeoPointPrecision | null;
         precisionCounts: Record<GeoPointPrecision, number>;

package/dist/types/exportTable.d.ts

@@ -0,0 +1,100 @@
+/** The kind of value one exported column holds. Anything that is not a number, a date or a yes/no is text. */
+export type ExportColumnType = "text" | "number" | "date" | "boolean";
+/** One exported column, in the order the reader sees it. */
+export interface ExportColumn {
+    /** The header, as the reader sees it. */
+    name: string;
+    type: ExportColumnType;
+    /** The d3-format specifier the chart prints this number with (a number column only). Wins over modelFormat. */
+    d3Format?: string | null;
+    /** The data model's own number format (an Excel / Power BI format string), used when there is no d3Format. */
+    modelFormat?: string | null;
+}
+/** One cell's value. A blank (null, undefined, "" or a value its column's type cannot read) is an empty cell. */
+export type ExportCell = string | number | boolean | Date | null | undefined;
+/** What a chart hands out: the visible columns in display order, and the rows in display order. */
+export interface ExportTable {
+    /** Names the file and the worksheet. Absent: "table". */
+    title?: string | null;
+    columns: ExportColumn[];
+    rows: ExportCell[][];
+}
+export type ExportFormat = "csv" | "xlsx";
+/** The formats a chart may offer, best first. */
+export declare const EXPORT_FORMATS: readonly ExportFormat[];
+/** A finished file, as a host's file service receives it. */
+export interface ExportFile {
+    /** A file name with its extension, safe on every file system. */
+    name: string;
+    format: ExportFormat;
+    mime: string;
+    bytes: Uint8Array;
+    /** The same content as text, for a text format (the CSV); absent for a binary one. */
+    text?: string;
+    /**
+     * The table the file was written from, for a host that keeps it its own way (a spreadsheet add-in that must give
+     * the new sheet a name the open workbook does not already use, and so writes the workbook again under that name).
+     */
+    table: ExportTable;
+}
+export declare const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+export declare const CSV_MIME = "text/csv";
+/**
+ * Excel's day number for a UTC time: days since 1899-12-30, the fraction being the time of day. Excel counts a
+ * 29 February 1900 that never was (day 60), so a day before 1 March 1900 is one lower to read back as itself.
+ */
+export declare function excelSerial(t: number): number;
+/**
+ * The Excel number format for an exported number column, or null for General. `values` are the column's numbers, so a
+ * format that shows "up to" some decimals shows as many as the data has.
+ */
+export declare function excelNumberFormat(col: Pick<ExportColumn, "d3Format" | "modelFormat">, values?: readonly number[]): string | null;
+/**
+ * The table as CSV text: a header row, then one line per row, CRLF between lines, RFC 4180 quoting. A number is its
+ * plain value (a point for the decimal, no grouping), a date its ISO day (and time, when the column has one), a yes/no
+ * TRUE or FALSE. The text starts with a byte-order mark so a spreadsheet reads it as UTF-8.
+ */
+export declare function tableToCsv(table: ExportTable): string;
+/** A1-style column letters for a 0-based column index. */
+export declare function columnLetters(ci: number): string;
+/** A worksheet name Excel accepts: at most 31 characters, none of []:*?/\, not blank, not starting or ending with '. */
+export declare function sheetName(title: string | null | undefined): string;
+/** A file name safe on every file system, from a title: no reserved characters, at most 80 characters. */
+export declare function exportFileName(title: string | null | undefined, format: ExportFormat): string;
+/**
+ * The table as an .xlsx workbook's bytes. One worksheet named after the title: a bold header row, frozen, with filter
+ * buttons; typed cells (numbers with their format where Excel can carry it, dates as dates, TRUE/FALSE); each column as
+ * wide as its widest value, within limits. Rows past Excel's limit are left out (a sheet holds 1,048,576 rows).
+ */
+export declare function tableToXlsx(table: ExportTable): Uint8Array;
+/**
+ * A ZIP archive of the given files, stored without compression (method 0) - every reader of a workbook accepts it. The
+ * entries carry a fixed timestamp, so the same table always gives the same bytes.
+ */
+export declare function zipStored(files: Array<[string, string | Uint8Array]>): Uint8Array;
+/** Builds the finished file for a table in one of the export formats. */
+export declare function buildExportFile(table: ExportTable, format: ExportFormat): ExportFile;
+/** Base64 of a file's bytes, for a host whose file service takes binary content as base64 text. */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/** A host's file service: saves a finished file the host's own way. False, a throw or a rejection means it did not. */
+export type SaveFileService = (file: ExportFile) => boolean | void | Promise<boolean | void>;
+/** The chart-facing export: what options.exportTable is. Resolves true when the host saved the file. */
+export type ExportTableService = (table: ExportTable, format: ExportFormat) => Promise<boolean>;
+/**
+ * The formats a host's file service takes, best first: the host's own list (when it names one) kept to the formats
+ * this module writes, in EXPORT_FORMATS order, without repeats. Absent or not a list: every format. An empty result
+ * means the host can save none of them, so it gets no export.
+ */
+export declare function exportFormatsFor(hostFormats?: readonly unknown[] | null): ExportFormat[];
+/**
+ * Builds the chart-facing exportTable from a host's file service. Never throws and never rejects: a table that cannot
+ * be written, a format the host does not take, or a host that refuses, resolves false, and the chart says the export
+ * did not happen.
+ */
+export declare function exportTableService(save: SaveFileService, formats?: readonly ExportFormat[]): ExportTableService;
+/**
+ * A file service for a page in a browser: the file downloads through a link the page never shows. For a React or
+ * Blazor page, a Fabric App, or any page whose browser allows downloads; a sandboxed frame without the
+ * "allow-downloads" permission silently drops it, so a host in one passes its own service (or none) instead.
+ */
+export declare function browserSaveFile(doc?: Document): SaveFileService;

package/dist/types/host.d.ts

@@ -257,8 +257,9 @@ export interface ChartHostConfig {
     /**
      * NOTES ON MARKS. Each annotation names a key - a value in a column of this chart's data, such as a
      * country code - and the host draws a badge on that key's mark after every render, wherever a filter,
-     * a re-query or a zoom has put it. Keyed by value, never by row position. Change them with
-     * setAnnotations; none (the default) draws nothing.
+     * a re-query, a zoom or a scroll has put it. A chart that declares NOTE_STYLE_ATTR="dot" gets a small
+     * dot at a fixed spot instead, the label in its tooltip. Keyed by value, never by row position. Change
+     * them with setAnnotations; none (the default) draws nothing.
      */
     annotations?: MarkAnnotation[];
     /** A badge was clicked. The mark beneath is not selected. */