@cfasim-ui/docs 0.7.3 → 0.7.5

package/charts/ChoroplethMap/ChoroplethTooltip.vue

@@ -8,20 +8,36 @@ export interface ChoroplethTooltipData {
   feature: unknown;
 }
 
-defineSlots<{
-  default?(props: ChoroplethTooltipData): unknown;
-}>();
+withDefaults(
+  defineProps<{
+    /**
+     * `"float"` (default) renders the classic pointer-anchored tooltip.
+     * `"sheet"` renders a bottom sheet that slides up inside the map
+     * wrapper instead — used in the expanded touch view, where it stays
+     * correctly positioned regardless of the page's pinch-zoom state
+     * (the wrapper is pinned to the visual viewport; floating fixed
+     * positioning is not).
+     */
+    mode?: "float" | "sheet";
+  }>(),
+  { mode: "float" },
+);
 
 // Local reactive state. Held inside the child so the parent's render scope
 // never subscribes to it — hover updates re-render only this small tree,
 // not the parent's 3,000+ paths.
 const data = ref<ChoroplethTooltipData | null>(null);
+const open = ref(false);
 const rootRef = useTemplateRef<HTMLDivElement>("root");
 
 defineExpose({
   setData(next: ChoroplethTooltipData | null) {
     data.value = next;
   },
+  /** Sheet-mode visibility (float mode is driven imperatively via getEl). */
+  setOpen(next: boolean) {
+    open.value = next;
+  },
   getEl(): HTMLDivElement | null {
     return rootRef.value;
   },
@@ -29,6 +45,10 @@ defineExpose({
 </script>
 
 <template>
+  <!-- Float: always mounted (the parent's ResizeObserver holds onto it);
+  its slot only renders in float mode. z-index sits one above the
+  fullscreen overlay so it stays visible while the map fills the window
+  (both live in body). -->
   <Teleport to="body">
     <div
       ref="root"
@@ -37,13 +57,47 @@ defineExpose({
         position: fixed;
         left: 0;
         top: 0;
+        z-index: calc(var(--cfasim-z-fullscreen, 1000) + 1);
         visibility: hidden;
         will-change: transform;
         pointer-events: none;
         transform: translateY(-50%);
       "
     >
-      <slot v-if="data" v-bind="data" />
+      <slot v-if="data && mode === 'float'" v-bind="data" />
     </div>
   </Teleport>
+  <!-- Sheet: rendered in place inside the map wrapper, so it anchors to
+  the (visual-viewport-pinned) expanded box. -->
+  <div
+    v-if="mode === 'sheet'"
+    class="chart-tooltip-sheet"
+    :class="{ 'is-open': open }"
+  >
+    <slot v-if="data" v-bind="data" />
+  </div>
 </template>
+
+<style scoped>
+.chart-tooltip-sheet {
+  position: absolute;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  z-index: 2;
+  background: var(--color-bg-0, #fff);
+  color: var(--color-text, inherit);
+  border-top: 1px solid var(--color-border, #e5e7eb);
+  box-shadow: 0 -4px 12px rgba(0, 0, 0, 0.12);
+  padding: 14px 16px calc(14px + env(safe-area-inset-bottom, 0px));
+  font-size: 14px;
+  line-height: 1.4;
+  pointer-events: none;
+  transform: translateY(100%);
+  transition: transform 0.25s ease;
+}
+
+.chart-tooltip-sheet.is-open {
+  transform: translateY(0);
+}
+</style>

package/charts/ChoroplethMap/canvasLayer.ts

@@ -0,0 +1,319 @@
+// Canvas rendering backend for ChoroplethMap (`renderer="canvas"`).
+//
+// Pure scene/draw/pick helpers, kept free of Vue and DOM lookups so they
+// can be unit-tested against a recording fake context. The component owns
+// all state; these functions just paint and answer point queries.
+
+/** Matches ChoroplethMap's FocusStyle without importing from the SFC. */
+export type CanvasDashStyle = "solid" | "dashed" | "dotted";
+
+export interface SceneItem {
+  id: string;
+  path: Path2D;
+  fill: string;
+}
+
+export interface CanvasScene {
+  items: SceneItem[];
+  indexById: Map<string, number>;
+  /**
+   * Every feature outline concatenated into one path — features share a
+   * stroke color, and one native stroke call beats thousands (WebKit's
+   * canvas2D especially).
+   */
+  outlines: Path2D | null;
+  /** State-borders mesh (counties / hsas mode). */
+  borders: Path2D | null;
+}
+
+export interface CanvasView {
+  dpr: number;
+  /** Uniform viewBox→CSS scale (xMidYMid meet). */
+  meetScale: number;
+  /** CSS-px letterbox offsets inside the canvas box. */
+  offsetX: number;
+  offsetY: number;
+  zoom: { k: number; x: number; y: number };
+}
+
+export interface CanvasOverlayItem {
+  path: Path2D;
+  stroke: string;
+  strokeWidth?: number;
+  style?: CanvasDashStyle;
+}
+
+export interface CanvasHighlightItem {
+  stroke?: string;
+  strokeWidth?: number;
+  style?: CanvasDashStyle;
+}
+
+export interface CanvasBaseState {
+  strokeColor: string;
+  /** Base feature stroke width in CSS px (effectiveStrokeWidth). */
+  strokeWidth: number;
+  /** Resolved highlight color (light-dark() can't paint on canvas). */
+  highlightStroke: string;
+  focused: Map<string, CanvasHighlightItem>;
+  overlays: CanvasOverlayItem[];
+}
+
+export interface CanvasDrawState extends CanvasBaseState {
+  hoveredId: string | null;
+}
+
+function applyViewTransform(
+  ctx: CanvasRenderingContext2D,
+  view: CanvasView,
+): void {
+  const s = view.dpr * view.meetScale * view.zoom.k;
+  ctx.setTransform(
+    s,
+    0,
+    0,
+    s,
+    view.dpr * (view.offsetX + view.meetScale * view.zoom.x),
+    view.dpr * (view.offsetY + view.meetScale * view.zoom.y),
+  );
+}
+
+/** Line width (map units) rendering as `css` CSS px on screen. */
+function lwFor(view: CanvasView): (css: number) => number {
+  return (css) => css / (view.meetScale * view.zoom.k || 1);
+}
+
+function applyLineDash(
+  ctx: CanvasRenderingContext2D,
+  lw: (css: number) => number,
+  style: CanvasDashStyle | undefined,
+): void {
+  if (style === "dashed") {
+    ctx.setLineDash([lw(8), lw(4)]);
+    ctx.lineCap = "butt";
+  } else if (style === "dotted") {
+    ctx.setLineDash([0, lw(5)]);
+    ctx.lineCap = "round";
+  } else {
+    ctx.setLineDash([]);
+    ctx.lineCap = "butt";
+  }
+}
+
+export function buildScene(
+  features: Array<{ id?: string | number | null }>,
+  pathFor: (feature: never) => string | null,
+  colorFor: (id: string) => string,
+  bordersD?: string | null,
+): CanvasScene {
+  const items: SceneItem[] = [];
+  const indexById = new Map<string, number>();
+  const outlines = new Path2D();
+  let outlineCount = 0;
+  for (const feat of features) {
+    const d = pathFor(feat as never);
+    if (!d) continue;
+    const id = String(feat.id);
+    const path = new Path2D(d);
+    indexById.set(id, items.length);
+    items.push({ id, path, fill: colorFor(id) });
+    if (typeof outlines.addPath === "function") {
+      outlines.addPath(path);
+      outlineCount++;
+    }
+  }
+  return {
+    items,
+    indexById,
+    outlines: outlineCount ? outlines : null,
+    borders: bordersD ? new Path2D(bordersD) : null,
+  };
+}
+
+function highlightOne(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  lw: (css: number) => number,
+  state: CanvasBaseState,
+  id: string,
+  item?: CanvasHighlightItem,
+): void {
+  const idx = scene.indexById.get(id);
+  if (idx == null) return;
+  const it = scene.items[idx];
+  // Re-filling first covers neighbors' strokes — the canvas equivalent of
+  // the SVG renderer's appendChild raise.
+  ctx.fillStyle = it.fill;
+  ctx.fill(it.path);
+  ctx.strokeStyle = item?.stroke ?? state.highlightStroke;
+  ctx.lineWidth = lw(item?.strokeWidth ?? state.strokeWidth + 1);
+  applyLineDash(ctx, lw, item?.style);
+  ctx.stroke(it.path);
+}
+
+/**
+ * Base pass internals composed by drawScene. The transform maps canonical
+ * viewBox coordinates to device pixels:
+ * `device = dpr · (letterboxOffset + meetScale · zoom(point))`. Stroke
+ * widths are compensated so a visual width `w` CSS px stays constant at
+ * any zoom, mirroring the SVG renderer's `strokeDivisor`.
+ */
+function beginBasePass(ctx: CanvasRenderingContext2D, view: CanvasView): void {
+  ctx.setTransform(1, 0, 0, 1, 0, 0);
+  ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
+  applyViewTransform(ctx, view);
+  ctx.lineJoin = "round";
+  ctx.setLineDash([]);
+}
+
+/** Fills items [from, to); returns the next index. The ctx keeps the
+ * transform beginBasePass applied, so slices can span multiple frames. */
+function drawFillSlice(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  from: number,
+  to: number,
+): number {
+  const end = Math.min(to, scene.items.length);
+  for (let i = from; i < end; i++) {
+    ctx.fillStyle = scene.items[i].fill;
+    ctx.fill(scene.items[i].path);
+  }
+  return end;
+}
+
+/** Outlines, borders, focus highlights, and overlays — everything but the
+ * transient hover, which the display frame draws live on top of blits. */
+function finishBasePass(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  view: CanvasView,
+  state: CanvasBaseState,
+): void {
+  const lw = lwFor(view);
+  ctx.setLineDash([]);
+  ctx.lineWidth = lw(state.strokeWidth);
+  ctx.strokeStyle = state.strokeColor;
+  if (scene.outlines) {
+    ctx.stroke(scene.outlines);
+  } else {
+    for (const item of scene.items) ctx.stroke(item.path);
+  }
+
+  if (scene.borders) {
+    ctx.lineWidth = lw(1);
+    ctx.stroke(scene.borders);
+  }
+
+  for (const [id, item] of state.focused) {
+    highlightOne(ctx, scene, lw, state, id, item);
+  }
+
+  // Overlays above the focus highlights, matching the SVG z-order.
+  for (const o of state.overlays) {
+    ctx.strokeStyle = o.stroke;
+    ctx.lineWidth = lw(o.strokeWidth ?? state.strokeWidth + 1.5);
+    applyLineDash(ctx, lw, o.style);
+    ctx.stroke(o.path);
+  }
+  ctx.setLineDash([]);
+}
+
+/** Live hover highlight, drawn by the display frame on top of the blitted
+ * base (focused features are already highlighted in the base itself). */
+export function drawHoverHighlight(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  view: CanvasView,
+  state: CanvasBaseState,
+  hoveredId: string | null,
+): void {
+  if (!hoveredId || state.focused.has(hoveredId)) return;
+  applyViewTransform(ctx, view);
+  ctx.lineJoin = "round";
+  highlightOne(ctx, scene, lwFor(view), state, hoveredId);
+  ctx.setLineDash([]);
+  ctx.setTransform(1, 0, 0, 1, 0, 0);
+}
+
+/** One-shot full repaint (composition of the passes above). */
+export function drawScene(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  view: CanvasView,
+  state: CanvasDrawState,
+): void {
+  beginBasePass(ctx, view);
+  drawFillSlice(ctx, scene, 0, scene.items.length);
+  finishBasePass(ctx, scene, view, state);
+  drawHoverHighlight(ctx, scene, view, state, state.hoveredId);
+}
+
+/** Unique fill color for feature index `i` on the picking canvas. */
+export function indexToColor(i: number): string {
+  const v = i + 1;
+  return `rgb(${(v >> 16) & 255},${(v >> 8) & 255},${v & 255})`;
+}
+
+/**
+ * Paints every feature in a unique index color onto `canvas` at canonical
+ * viewBox resolution. Rebuilt only when the geometry changes; hit-testing
+ * then reads one pixel per query regardless of feature count.
+ */
+export function buildPicking(
+  scene: CanvasScene,
+  width: number,
+  height: number,
+  canvas: HTMLCanvasElement,
+): CanvasRenderingContext2D | null {
+  canvas.width = Math.max(1, Math.round(width));
+  canvas.height = Math.max(1, Math.round(height));
+  const ctx = canvas.getContext("2d", { willReadFrequently: true });
+  if (!ctx) return null;
+  ctx.imageSmoothingEnabled = false;
+  ctx.setTransform(1, 0, 0, 1, 0, 0);
+  ctx.clearRect(0, 0, canvas.width, canvas.height);
+  scene.items.forEach((item, i) => {
+    ctx.fillStyle = indexToColor(i);
+    ctx.fill(item.path);
+  });
+  return ctx;
+}
+
+/**
+ * Feature index at canonical viewBox coordinates (the caller has already
+ * inverted the zoom transform), or null over the background. Fill edges
+ * antialias into blended colors, so a candidate whose decoded index is
+ * implausible — or that fails a point-in-path check — falls back to a
+ * linear `isPointInPath` scan (rare, borders only).
+ */
+export function pickIndexAt(
+  ctx: CanvasRenderingContext2D,
+  scene: CanvasScene,
+  x: number,
+  y: number,
+): number | null {
+  const px = Math.round(x);
+  const py = Math.round(y);
+  if (px < 0 || py < 0 || px >= ctx.canvas.width || py >= ctx.canvas.height) {
+    return null;
+  }
+  const d = ctx.getImageData(px, py, 1, 1).data;
+  if (d[3] === 0) return null;
+  const idx = ((d[0] << 16) | (d[1] << 8) | d[2]) - 1;
+  if (idx >= 0 && idx < scene.items.length) {
+    if (
+      typeof ctx.isPointInPath !== "function" ||
+      ctx.isPointInPath(scene.items[idx].path, x, y)
+    ) {
+      return idx;
+    }
+  }
+  // Antialiased edge pixel: verify the hard way.
+  if (typeof ctx.isPointInPath === "function") {
+    for (let i = 0; i < scene.items.length; i++) {
+      if (ctx.isPointInPath(scene.items[i].path, x, y)) return i;
+    }
+  }
+  return null;
+}

package/index.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.3",
+  "version": "0.7.5",
   "package": "@cfasim-ui/docs",
   "content": {
     "components": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfasim-ui/docs",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "LLM-friendly component and chart documentation for cfasim-ui",
   "license": "Apache-2.0",
   "repository": {