@sjvair/map-sdk 0.1.0-beta.5 → 0.1.0-beta.6

package/README.md

@@ -548,6 +548,16 @@ local sjvair.com stack at `http://localhost:8000`.
 
 ## Changes
 
+### 0.1.0-beta.6
+
+- **A category reading is shown once.** When a feature's value is its category level's code, the
+  list row, the tooltip, and the row's accessible name show only the level label. Smoke rows read
+  "Smoke, Light" (was "light Light"), burn status "Burning Discouraged", and heat score
+  "Moderate" (the 0–4 number is no longer shown). Number scales such as PM2.5 and fire power are
+  unchanged, and a category value that matches no level is still shown.
+- **New message key for hosts with their own catalog:** `mapsdk_list_row_level`
+  (`"{name}, {level}"`).
+
 ### 0.1.0-beta.5
 
 - **Shapes that cover the view are in view.** The feature list and the view summary count a shape

package/dist/data/messages/en.json

@@ -8,6 +8,7 @@
 	"mapsdk_list_row": "{name}, {value} {units}, {level}",
 	"mapsdk_list_row_no_units": "{name}, {value}, {level}",
 	"mapsdk_list_row_no_value": "{name}, no reading",
+	"mapsdk_list_row_level": "{name}, {level}",
 	"mapsdk_list_row_detail": "{name}, {detail}",
 	"mapsdk_list_empty": "Nothing on the map in this view",
 	"mapsdk_selected_count_one": "{count} selected",

package/dist/ui/FeatureList.svelte

@@ -11,11 +11,11 @@
 		rowLabel,
 		levelText,
 		shownLevel,
+		shownValue,
 		sortItems,
 		typeaheadIndex,
 		type SortBy
 	} from "./feature-list.js";
-	import { formatValue as formatNumber } from "./value-format.js";
 
 	interface Props {
 		map: MapContext;
@@ -267,13 +267,6 @@
 		pick(rows[index], e.shiftKey || e.metaKey || e.ctrlKey);
 	}
 
-	function formatValue(row: Row): string {
-		if (row.value === null) return "";
-		return typeof row.value === "number"
-			? formatNumber(row.value, row.precision, map.format, row.truncate)
-			: row.value;
-	}
-
 	onDestroy(() => {
 		clearTimeout(typeaheadTimer);
 		clearTimeout(menuSentTimer);
@@ -332,6 +325,7 @@
 				{@const index = range.start + i}
 				{@const level = shownLevel(row)}
 				{@const levelPlace = levelText(row, map.messages)}
+				{@const value = shownValue(row, map.format)}
 				{@const isOn = isSelected(row)}
 				<!-- Options aren't focused: the listbox holds focus and handles keys (aria-activedescendant). -->
 				<!-- svelte-ignore a11y_click_events_have_key_events, a11y_interactive_supports_focus -->
@@ -359,7 +353,7 @@
 					</span>
 					<span class="mapsdk-list-name">{row.name}</span>
 					<span class="mapsdk-list-value">
-						{formatValue(row)}{#if row.units && row.value !== null}&nbsp;{row.units}{/if}
+						{value ?? ""}{#if row.units && value !== null}&nbsp;{row.units}{/if}
 					</span>
 					<span class="mapsdk-list-level text-xs">
 						{#if levelPlace.kind !== "detail"}

package/dist/ui/TooltipItem.svelte

@@ -3,9 +3,8 @@
 	import type { MessageProvider } from "../data/messages.js";
 	import type { FeatureListItem } from "../core/plugin.js";
 	import { NO_LEVEL } from "../data/scale.js";
-	import { levelText } from "./feature-list.js";
+	import { levelText, shownValue } from "./feature-list.js";
 	import { levelChip } from "./level-chip.js";
-	import { formatValue } from "./value-format.js";
 
 	// The generic tooltip body under a feature's name: its value and a chip with its level. Shared
 	// by MapTooltip and by plugins that show it for features they don't list.
@@ -26,13 +25,8 @@
 		const chip = levelChip(level?.color);
 		return chip ? `background:${chip.background};color:${chip.text}` : "";
 	});
-	const valueText = $derived(
-		item.value == null
-			? null
-			: typeof item.value === "number"
-				? formatValue(item.value, item.precision, format, item.truncate)
-				: item.value
-	);
+	// A category reading shows only its level chip: its value is the level's code.
+	const valueText = $derived(shownValue(item, format));
 </script>
 
 <div class="mapsdk-tooltip-item">

package/dist/ui/feature-list.d.ts

@@ -26,6 +26,11 @@ export declare function inView(items: FeatureListItem[], bounds: Bounds): Featur
  * label on a neutral swatch.
  */
 export declare function shownLevel(item: FeatureListItem): Level | null;
+/**
+ * The value as shown, or `null` for none. A category reading, whose value is its level's code
+ * (smoke's "light", the heat score's 2), shows no value: its level label already says it.
+ */
+export declare function shownValue(item: FeatureListItem, format: FormatProvider): string | null;
 /** A sorted copy. `value`: highest first, null values and no level last; ties and `name` by name. */
 export declare function sortItems(items: FeatureListItem[], by: SortBy): FeatureListItem[];
 /** The first index at or after `from` (wrapping) whose name starts with `query`, any case; -1 if none. */

package/dist/ui/feature-list.js

@@ -29,6 +29,20 @@ export function inView(items, bounds) {
 export function shownLevel(item) {
     return item.level !== NO_LEVEL ? item.level : null;
 }
+/**
+ * The value as shown, or `null` for none. A category reading, whose value is its level's code
+ * (smoke's "light", the heat score's 2), shows no value: its level label already says it.
+ */
+export function shownValue(item, format) {
+    if (item.value === null)
+        return null;
+    const level = shownLevel(item);
+    if (level && level.value !== null && level.value === item.value)
+        return null;
+    return typeof item.value === "number"
+        ? formatValue(item.value, item.precision, format, item.truncate)
+        : item.value;
+}
 const collator = new Intl.Collator("en-US");
 /** A value's sort weight; `null` sorts last. Category values sort by their level's tier. */
 function weight(item) {
@@ -82,16 +96,18 @@ export function levelText(item, messages) {
 /** A row's accessible name: name, value, units, and level label (or detail). */
 export function rowLabel(item, messages, format) {
     const level = levelText(item, messages);
-    if (item.value === null) {
+    const value = shownValue(item, format);
+    if (value === null) {
+        // A category reading: its level is its value.
+        if (item.value !== null && level.kind === "level")
+            return messages("mapsdk_list_row_level", { name: item.name, level: level.text });
         return level.kind === "detail"
             ? messages("mapsdk_list_row_detail", { name: item.name, detail: level.text })
             : messages("mapsdk_list_row_no_value", { name: item.name });
     }
     const params = {
         name: item.name,
-        value: typeof item.value === "number"
-            ? formatValue(item.value, item.precision, format, item.truncate)
-            : item.value,
+        value,
         units: item.units,
         level: level.text
     };

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@sjvair/map-sdk",
 	"description": "Svelte 5 map components for SJVAir air-quality data",
-	"version": "0.1.0-beta.5",
+	"version": "0.1.0-beta.6",
 	"license": "MIT",
 	"repository": {
 		"type": "git",