@bicharts/chart-host 0.6.102 → 0.6.105

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

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-D6A37G2G.mjs";
+} from "./chunk-MU4BWWO6.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -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,19 +47,22 @@ 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,
   censusMarks,
   censusValuePlacement,
-  clearGeoCache,
   clippedTextFlag,
   colourSpreadFlag,
   compileRenderFn,
@@ -67,37 +72,40 @@ import {
   createChartHost,
   decideLabelColor,
   deltaEHex,
+  excelNumberFormat,
+  excelSerial,
   explainRenderFailure,
-  geoAssetFor,
-  geoFromCache,
+  exportFileName,
+  exportFormatsFor,
+  exportTableService,
   glyphSampleGrid,
   invalidSentinelReason,
   isBlankRender,
   isInvalidSentinelError,
   isPillBackdropAlpha,
-  loadGeo,
   minContrastOver,
   newIdScope,
   noopViewStateProvider,
   pickColorOver,
   pillBacksGlyph,
-  registerGeo,
-  registerGeoAsset,
   relativeLuminance,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
   scopeChartIds,
   sessionViewStateProvider,
+  sheetName,
   straddleSampleGrid,
   straddles,
   stripEsmExports,
   stripJsComments,
   syncMemberSelection,
+  tableToCsv,
+  tableToXlsx,
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-ALX4D2I2.mjs";
+} from "./chunk-K6UXTDMR.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -124,13 +132,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 +163,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,12 +192,20 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-3JBJ2SIF.mjs";
+} from "./chunk-IE7TM6DX.mjs";
+import {
+  clearGeoCache,
+  geoAssetFor,
+  geoFromCache,
+  loadGeo,
+  registerGeo,
+  registerGeoAsset
+} from "./chunk-5WTQN5DL.mjs";
 import {
-  _3,
+  Kt,
   l,
   o
-} from "./chunk-CNT3QA3R.mjs";
+} from "./chunk-SYUJ4TPX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -230,6 +246,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 +260,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;
@@ -296,7 +336,12 @@ var OPTIONS_VOCABULARY = Object.freeze({
    * that made the chart asked for them. "on" / "off" is a reader's choice and wins either way.
    */
   hoverDropLines: entry({ timing: "live", default: "", values: ["", "on", "off"] }),
+  /** A province map draws the national borders over its provinces unless this is false (a reader's "Country borders"). */
+  geoBorders: entry({ timing: "live", default: true }),
   // ---- the next generated chart ----
+  /** A reader's "Derive provinces": false measures no city or coordinate rollup, so only a real province column offers
+   *  a province map. It changes what the profile measures, so it travels in the shape rather than as a field. */
+  deriveProvinces: entry({ timing: "next-generate", default: true }),
   levelOfDetail: entry({ timing: "next-generate", default: "", values: ["", "High", "Medium", "Low"], wire: "clientHints" }),
   favorLimitTo: entry({ timing: "next-generate", default: "", values: ["", "latest", "top / greatest", "bottom / smallest", "most common", "outliers"], wire: "clientHints" }),
   /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */
@@ -911,6 +956,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 };
@@ -2125,7 +2297,7 @@ function fingerprintComponentDigest(components) {
 
 // src/index.ts
 function registerCityTable(packed) {
-  _3(packed);
+  Kt(packed);
 }
 export {
   ACTIVE_TICK_CLASS,
@@ -2164,6 +2336,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 +2346,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 +2402,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 +2445,7 @@ export {
   VIEW_ONLY_UI_STATE_KEYS,
   WHITE_TEXT_BG_LUM,
   XFILTER_REFRESH_EVENT,
+  XLSX_MIME,
   actionFor,
   applyLabelContrast,
   armGenerateGuard,
@@ -2281,11 +2457,14 @@ export {
   backingHoldsGlyph,
   bareBase64,
   blankRenderFlag,
+  browserSaveFile,
+  buildExportFile,
   buildPalette,
   buildPaletteFromSeed,
   buildProductFeedbackPayload,
   buildRenderPayload,
   buildReviewWire,
+  bytesToBase64,
   canConfirmLaunch,
   canShowLastChart,
   captureSvgSnapshot,
@@ -2328,7 +2507,13 @@ export {
   dispatchRowSet,
   encodePendingGenerate,
   ensureCrossfilterHitTargets,
+  excelNumberFormat,
+  excelSerial,
   explainRenderFailure,
+  exportFileName,
+  exportFormatsFor,
+  sheetName as exportSheetName,
+  exportTableService,
   filterFitsChooser,
   filterMatchStyleOf,
   filterQualifyRows,
@@ -2344,6 +2529,7 @@ export {
   glyphSampleGrid,
   hasRefusalsToShow,
   hitBandFlag,
+  hostLinkServices,
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
@@ -2379,6 +2565,7 @@ export {
   measureContainerBoxes,
   minContrastOver,
   mountProductFeedbackBox,
+  mountShareRateLine,
   needsScroll,
   newIdScope,
   newQualifyGroupState,
@@ -2451,6 +2638,7 @@ export {
   selectionRuleOf,
   servedCorrelationProves,
   sessionViewStateProvider,
+  shareRateLineModel,
   shouldCaptureThumbnail,
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
@@ -2466,6 +2654,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/provinces.mjs

@@ -0,0 +1,229 @@
+/*! @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 {
+  geoFromCache,
+  registerGeo
+} from "./chunk-5WTQN5DL.mjs";
+import {
+  Si,
+  W,
+  bt
+} from "./chunk-SYUJ4TPX.mjs";
+import "./chunk-A2GMXZP7.mjs";
+import "./chunk-GHODWOAL.mjs";
+
+// src/provinceGeo.ts
+var PROVINCE_REGIONS = ["europe", "asia", "africa", "south-america", "north-america", "oceania"];
+function provinceGeoPath(region) {
+  return `/geo/admin1-${String(region).toLowerCase()}.v1.json`;
+}
+function provinceGeoKey(region) {
+  return `admin1:${String(region).toLowerCase()}`;
+}
+function geoKeyFor(res) {
+  if (res.geoGrain && res.geoGrain.toLowerCase() === "admin1" && res.geoRegion) return provinceGeoKey(res.geoRegion);
+  return res.geoKind ?? null;
+}
+var inflight = /* @__PURE__ */ new Map();
+async function loadProvinceGeo(region, opts = {}) {
+  const key = provinceGeoKey(region);
+  const cached = geoFromCache(key);
+  if (cached) return cached;
+  if (!PROVINCE_REGIONS.includes(String(region).toLowerCase())) return void 0;
+  const url = opts.url ?? (opts.origin ? opts.origin.replace(/\/+$/, "") : "") + provinceGeoPath(region);
+  let p = inflight.get(key);
+  if (!p) {
+    const started = Date.now();
+    p = (async () => {
+      try {
+        const doc = opts.fetchJson ? await opts.fetchJson(url) : await (await fetch(url, { credentials: "omit" })).json();
+        if (!doc || doc.type !== "FeatureCollection" || !Array.isArray(doc.features) || doc.features.length === 0)
+          throw new Error("not a FeatureCollection");
+        registerGeo(key, doc);
+        opts.log?.("province-geo-loaded", { region, ms: Date.now() - started, features: doc.features.length });
+        return doc;
+      } catch (e) {
+        opts.log?.("province-geo-failed", { region, url, error: String(e).slice(0, 200) });
+        return void 0;
+      } finally {
+        inflight.delete(key);
+      }
+    })();
+    inflight.set(key, p);
+  }
+  return p;
+}
+var PROVINCE_SNAP_DEG = 0.05;
+function shapesOf(geo) {
+  const out = [];
+  for (const f of geo?.features ?? []) {
+    const g = f?.geometry;
+    if (!g || f?.properties?.kind === "border" || f.id === null || f.id === void 0) continue;
+    const polys = g.type === "Polygon" ? [g.coordinates] : g.type === "MultiPolygon" ? g.coordinates : [];
+    if (!polys.length) continue;
+    let x0 = Infinity, y0 = Infinity, x1 = -Infinity, y1 = -Infinity;
+    for (const poly of polys) for (const [x, y] of poly[0] ?? []) {
+      if (x < x0) x0 = x;
+      if (x > x1) x1 = x;
+      if (y < y0) y0 = y;
+      if (y > y1) y1 = y;
+    }
+    out.push({ id: String(f.id), polys, box: [x0, y0, x1, y1] });
+  }
+  return out;
+}
+function inRing(x, y, ring) {
+  let inside = false;
+  for (let i = 0, j = ring.length - 1; i < ring.length; j = i++) {
+    const [xi, yi] = ring[i], [xj, yj] = ring[j];
+    if (yi > y !== yj > y && x < (xj - xi) * (y - yi) / (yj - yi) + xi) inside = !inside;
+  }
+  return inside;
+}
+function inShape(x, y, s) {
+  if (x < s.box[0] || x > s.box[2] || y < s.box[1] || y > s.box[3]) return false;
+  return s.polys.some((poly) => poly.length > 0 && inRing(x, y, poly[0]) && !poly.slice(1).some((h) => inRing(x, y, h)));
+}
+function segDist2(px, py, ax, ay, bx, by) {
+  const dx = bx - ax, dy = by - ay;
+  const t = dx === 0 && dy === 0 ? 0 : Math.max(0, Math.min(1, ((px - ax) * dx + (py - ay) * dy) / (dx * dx + dy * dy)));
+  const ex = ax + t * dx - px, ey = ay + t * dy - py;
+  return ex * ex + ey * ey;
+}
+var locators = /* @__PURE__ */ new WeakMap();
+function provinceLocator(geo, snapDeg = PROVINCE_SNAP_DEG) {
+  if (geo && typeof geo === "object" && snapDeg === PROVINCE_SNAP_DEG) {
+    const hit = locators.get(geo);
+    if (hit) return hit;
+  }
+  const shapes = shapesOf(geo);
+  const locate = (lat, lon) => {
+    if (!isFinite(lat) || !isFinite(lon)) return null;
+    for (const x of [lon, lon + 360, lon - 360]) {
+      for (const s of shapes) if (inShape(x, lat, s)) return s.id;
+    }
+    const k = Math.cos(lat * Math.PI / 180) || 1e-6;
+    let best = null, bestD = snapDeg * snapDeg;
+    for (const s of shapes) {
+      if (lon < s.box[0] - snapDeg / k || lon > s.box[2] + snapDeg / k || lat < s.box[1] - snapDeg || lat > s.box[3] + snapDeg) continue;
+      for (const poly of s.polys) for (const ring of poly) for (let i = 1; i < ring.length; i++) {
+        const d = segDist2(lon * k, lat, ring[i - 1][0] * k, ring[i - 1][1], ring[i][0] * k, ring[i][1]);
+        if (d <= bestD) {
+          bestD = d;
+          best = s.id;
+        }
+      }
+    }
+    return best;
+  };
+  if (geo && typeof geo === "object" && snapDeg === PROVINCE_SNAP_DEG) locators.set(geo, locate);
+  return locate;
+}
+
+// src/admin1LookupLoader.ts
+var ADMIN1_LOOKUP_PATH = "/geo/admin1-lookup.v1.json";
+var inflight2 = null;
+async function loadAdmin1Lookup(url, opts = {}) {
+  if (W()) return true;
+  const log = opts.log;
+  if (!inflight2) {
+    const started = Date.now();
+    inflight2 = (async () => {
+      try {
+        const doc = opts.fetchJson ? await opts.fetchJson(url) : await (await fetch(url, { credentials: "omit" })).json();
+        const counts = bt(doc);
+        log?.("admin1-lookup-loaded", { url, ms: Date.now() - started, ...counts });
+        return true;
+      } catch (e) {
+        log?.("admin1-lookup-failed", { url, ms: Date.now() - started, error: String(e).slice(0, 200) });
+        inflight2 = null;
+        return false;
+      }
+    })();
+  }
+  const timeoutMs = opts.timeoutMs ?? 3e3;
+  let timer;
+  const timeout = new Promise((resolve) => {
+    timer = setTimeout(() => {
+      log?.("admin1-lookup-timeout", { url, timeoutMs });
+      resolve(false);
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([inflight2, timeout]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+var PLACE_TOKENS = /(^|[^a-z])(city|cities|town|ville|stadt|ciudad|citta|cidade|state|province|provincia|provinz|county|department|departement|departamento|prefecture|oblast|canton|kanton|bundesland|municipality)([^a-z]|$)/i;
+function needsAdmin1Lookup(columns) {
+  if (!columns) return false;
+  const geographic = columns.some((c) => {
+    const kind = (c?.geoKind ?? "").toLowerCase();
+    return kind.startsWith("country") || kind.startsWith("city");
+  });
+  if (geographic) return true;
+  return columns.some((c) => !!c && !c.isMeasure && !!c.name && PLACE_TOKENS.test(c.name.replace(/[_-]+/g, " ")));
+}
+
+// src/provinceHost.ts
+async function prepareProvinceProfile(profile, opts) {
+  if (!profile || typeof profile.getColumnsWithStats !== "function") return;
+  let invalidate = false;
+  if (profile.deriveProvinces !== opts.deriveProvinces) {
+    profile.deriveProvinces = opts.deriveProvinces;
+    invalidate = true;
+  }
+  const origin = typeof opts.origin === "string" ? opts.origin.trim() : "";
+  if (!W() && origin) {
+    let cols = [];
+    try {
+      cols = profile.getColumnsWithStats(opts.privacyLevel, opts.locale);
+    } catch {
+    }
+    if (needsAdmin1Lookup(cols)) {
+      const ok = await loadAdmin1Lookup(
+        origin.replace(/\/+$/, "") + ADMIN1_LOOKUP_PATH,
+        { timeoutMs: opts.timeoutMs ?? 3e3, fetchJson: opts.fetchJson, log: opts.log }
+      );
+      invalidate = invalidate || ok;
+    }
+  }
+  if (invalidate) profile.invalidateStats?.();
+}
+function provinceBinding(res, cols, opts) {
+  if (!res.geoColumn || !res.geoKind) return null;
+  if (String(res.geoGrain ?? "").toLowerCase() !== "admin1") return { column: res.geoColumn, kind: res.geoKind };
+  const dims = cols.filter((c) => !c.isMeasure && c.name !== res.geoColumn);
+  const kindOf = (c) => String(c.geoKind ?? "");
+  const words = (n) => n.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/[^a-z]+/);
+  const named = (re) => cols.find((c) => words(c.name).some((w) => re.test(w)))?.name ?? null;
+  return {
+    column: res.geoColumn,
+    kind: res.geoKind,
+    grain: "admin1",
+    region: res.geoRegion || null,
+    fallback: {
+      city: dims.find((c) => kindOf(c).startsWith("city"))?.name ?? null,
+      country: dims.find((c) => kindOf(c).startsWith("country"))?.name ?? null,
+      lat: named(/^(lat|latitude)$/),
+      lon: named(/^(lon|lng|long|longitude)$/)
+    },
+    deriveProvinces: opts.deriveProvinces,
+    join: Si,
+    locate: opts.geo ? provinceLocator(opts.geo) : null
+  };
+}
+function geoKeyOfFields(res) {
+  return geoKeyFor({ geoKind: res.geoKind, geoRegion: res.geoRegion, geoGrain: res.geoGrain });
+}
+export {
+  ADMIN1_LOOKUP_PATH,
+  geoKeyFor,
+  geoKeyOfFields,
+  loadAdmin1Lookup,
+  loadProvinceGeo,
+  needsAdmin1Lookup,
+  prepareProvinceProfile,
+  provinceBinding,
+  provinceLocator
+};