Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

3.1 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import type { CellValueSentinel, CellValueSentinelType } from "./types";

const WHITESPACE_CHARS: Record<string, { marker: string; name: string }> = {
  " ": { marker: "\u2423", name: "space" },
  "\t": { marker: "\\t", name: "tab" },
  "\n": { marker: "\\n", name: "newline" },
  "\r": { marker: "\\r", name: "carriage return" },
};

function renderWhitespaceMarkers(str: string): React.ReactNode[] {
  return [...str].map((ch, i) => {
    const entry = WHITESPACE_CHARS[ch];
    const marker = entry
      ? entry.marker
      : `\\u${(ch.codePointAt(0) ?? 0).toString(16).padStart(4, "0")}`;
    return (
      <span key={i} className="mr-0.5 last:mr-0">
        {marker}
      </span>
    );
  });
}

function describeWhitespace(str: string): string {
  const counts: Record<string, number> = {};
  for (const ch of str) {
    const name = WHITESPACE_CHARS[ch]?.name ?? "unicode whitespace";
    counts[name] = (counts[name] ?? 0) + 1;
  }
  return Object.entries(counts)
    .map(([name, count]) => `${count} ${name}${count > 1 ? "s" : ""}`)
    .join(", ");
}

interface SentinelConfig {
  label: (value: CellValueSentinel["value"]) => string | React.ReactNode[];
  tooltip: (value: CellValueSentinel["value"]) => string;
  ariaLabel: (value: CellValueSentinel["value"]) => string;
}

const SENTINEL_CONFIG: Record<CellValueSentinelType, SentinelConfig> = {
  null: {
    label: () => "None",
    tooltip: () => "None",
    ariaLabel: () => "None",
  },
  "empty-string": {
    label: () => "<empty>",
    tooltip: () => "<empty>",
    ariaLabel: () => "empty string",
  },
  whitespace: {
    label: (value) => renderWhitespaceMarkers(String(value)),
    tooltip: (value) => describeWhitespace(String(value)),
    ariaLabel: (value) => describeWhitespace(String(value)),
  },
  nan: {
    label: () => "NaN",
    tooltip: () => "NaN",
    ariaLabel: () => "NaN",
  },
  "positive-infinity": {
    label: () => "inf",
    tooltip: () => "Infinity",
    ariaLabel: () => "infinity",
  },
  "negative-infinity": {
    label: () => "-inf",
    tooltip: () => "-Infinity",
    ariaLabel: () => "negative infinity",
  },
  nat: {
    label: () => "NaT",
    tooltip: () => "NaT (Not a Time)",
    ariaLabel: () => "Not a Time",
  },
};

export function WhitespaceMarkers({ value }: { value: string }) {
  if (!value) {
    return null;
  }

  const description = describeWhitespace(value);

  return (
    <span
      className="text-muted-foreground opacity-60"
      aria-label={description}
      title={description}
    >
      {renderWhitespaceMarkers(value)}
    </span>
  );
}

export function SentinelCell({
  sentinel,
}: {
  sentinel: CellValueSentinel;
}): React.ReactElement {
  const config = SENTINEL_CONFIG[sentinel.type];
  const label = config.label(sentinel.value);
  const tooltip = config.tooltip(sentinel.value);
  const ariaLabel = config.ariaLabel(sentinel.value);

  return (
    <span
      className="italic text-muted-foreground bg-muted rounded px-1"
      aria-label={ariaLabel}
      title={tooltip}
    >
      <span className="opacity-70">{label}</span>
    </span>
  );
}