@devicechain/widgets 0.22.0 → 0.23.0-rc.1

package/dist/chunks/{chunk-S2OMBJLI.js → chunk-WBKHYZU2.js}

@@ -1,3 +1,7 @@
+import {
+  ACCESS_STRINGS
+} from "./chunk-BRH66T5F.js";
+
 // src/fleet-model.ts
 import {
   bucketSecondsFor
@@ -140,7 +144,7 @@ var FLEET_STRINGS = {
     noData: "no data in range",
     failed: "could not be read",
     unbound: "Choose a device group for this widget",
-    forbidden: "You do not have access to this data",
+    forbidden: ACCESS_STRINGS.en.forbidden,
     unsupported: "This data source cannot list a fleet",
     noMembers: "No devices in this group",
     noMeasurement: "Choose the measurement to compare",
@@ -163,7 +167,7 @@ var FLEET_STRINGS = {
     noData: "sin datos en el rango",
     failed: "no se pudo leer",
     unbound: "Elija un grupo de dispositivos para este widget",
-    forbidden: "No tiene acceso a estos datos",
+    forbidden: ACCESS_STRINGS.es.forbidden,
     unsupported: "Esta fuente de datos no puede listar una flota",
     noMembers: "No hay dispositivos en este grupo",
     noMeasurement: "Elija la medici\xF3n que comparar",
@@ -197,4 +201,4 @@ export {
   deviceBars,
   fleetStrings
 };
-//# sourceMappingURL=chunk-S2OMBJLI.js.map
+//# sourceMappingURL=chunk-WBKHYZU2.js.map

package/dist/chunks/{chunk-S2OMBJLI.js.map → chunk-WBKHYZU2.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/fleet-model.ts", "../../src/fleet-strings.ts"],
-  "sourcesContent": ["// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// The fleet widgets' state, decided apart from the drawing and from the hub: which reading a cell\n// shows, why one is empty, how the rows are ordered and paged. Pure, so each rule is a test.\n//\n// Everything is keyed by DEVICE and measurement together. The measurement channel keys its latest\n// values by name alone, so two thermostats reporting \"temperature\" overwrite each other there;\n// nothing in this file ever looks a value up by name without the device beside it.\n\nimport {\n  bucketSecondsFor,\n  type FleetMember,\n  type FleetState,\n  type HistoryWindow,\n  type MeasurementSample,\n  type MemberRoster,\n  type MemberSeed,\n} from '@devicechain/dashboards';\n\nconst MINUTE_MS = 60_000;\n\n// The window a fleet's seed reads: whole minutes ending at the last minute boundary at or before\n// `at`, in buckets of bucketSecondsFor(span) (a multiple of 60, so the store answers from its\n// one-minute summaries). Whole minutes are what let widgets reading the same span on the same\n// board share one request per device (the hub keys in-flight reads by window), and what keep the\n// window from holding a reading from before the span. The end is the instant just before the\n// boundary, because the store's end is inclusive.\nexport function seedWindow(spanSeconds: number, at: number): HistoryWindow {\n  const end = Math.floor(at / MINUTE_MS) * MINUTE_MS;\n  const start = Math.ceil((end - spanSeconds * 1000) / MINUTE_MS) * MINUTE_MS;\n  return {\n    startTime: new Date(start).toISOString(),\n    endTime: new Date(end - 1).toISOString(),\n    intervalSeconds: bucketSecondsFor(Math.max(60, (end - start) / 1000)),\n  };\n}\n\n// ---- Building the state ------------------------------------------------------\n\n// What the feed has gathered. `seeds` holds a settled seed per device (`'failed'` for a read that\n// did not come back); a device absent from it is still loading. `live` is every device's newest\n// sample per measurement name since the board opened.\nexport interface FleetInputs {\n  roster: MemberRoster | null;\n  seeds: ReadonlyMap<string, MemberSeed | 'failed'>;\n  live: ReadonlyMap<string, ReadonlyMap<string, MeasurementSample>>;\n  // The start of the span (epoch ms): a reading older than this is not \"in range\".\n  since: number;\n  forbidden: boolean;\n}\n\nfunction timeOf(sample: MeasurementSample | undefined): number {\n  if (!sample?.occurredTime) return Number.NaN;\n  return Date.parse(sample.occurredTime);\n}\n\n// A sample with no readable time is taken as current: only a live sample can lack one, and it just\n// arrived.\nfunction inRange(sample: MeasurementSample, since: number): boolean {\n  const at = timeOf(sample);\n  return Number.isNaN(at) || at >= since;\n}\n\nfunction newer(a: MeasurementSample | undefined, b: MeasurementSample | undefined): MeasurementSample | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  const ta = timeOf(a);\n  const tb = timeOf(b);\n  if (Number.isNaN(ta)) return a;\n  if (Number.isNaN(tb)) return b;\n  return tb >= ta ? b : a;\n}\n\nexport function buildFleet(i: FleetInputs): FleetState {\n  if (i.forbidden) return { status: 'forbidden', members: [], total: 0, truncated: false };\n  if (!i.roster) return { status: 'loading', members: [], total: 0, truncated: false };\n  if (i.roster.unbound) return { status: 'unbound', members: [], total: 0, truncated: false };\n\n  // A seeded reading is stamped at the start of its minute (fleet-seed.ts, \"Ages\") and happened\n  // somewhere in that minute, so it is in range while its minute is. Held to the exact instant, a\n  // reading 59 minutes 45 seconds old on an hour's board was dropped as out of range.\n  const seedSince = Math.floor(i.since / MINUTE_MS) * MINUTE_MS;\n  const members = i.roster.members.map((ref): FleetMember => {\n    const seed = i.seeds.get(ref.token);\n    const seeded = seed && seed !== 'failed' ? seed : undefined;\n    const live = i.live.get(ref.token);\n    const latest: Record<string, MeasurementSample> = {};\n    const names = new Set<string>([...Object.keys(seeded?.latest ?? {}), ...(live?.keys() ?? [])]);\n    for (const name of names) {\n      const best = newer(seeded?.latest[name], live?.get(name));\n      if (best && inRange(best, best === seeded?.latest[name] ? seedSince : i.since)) latest[name] = best;\n    }\n    const observed = new Set<string>(seeded?.observed ?? []);\n    for (const name of Object.keys(latest)) observed.add(name);\n    return {\n      token: ref.token,\n      name: ref.name,\n      latest,\n      seed: seed === undefined ? 'pending' : seed === 'failed' ? 'failed' : 'ready',\n      observed: [...observed],\n      // A live reading of an unread name is its value: cellFor looks at `latest` first.\n      ...(seeded?.unread?.length ? { unread: seeded.unread } : {}),\n    };\n  });\n  return {\n    status: 'ready',\n    members,\n    total: i.roster.total,\n    truncated: i.roster.total > members.length,\n  };\n}\n\n// The newest reading anywhere in the fleet (epoch ms), or undefined when none carries a time.\nexport function newestMemberTime(fleet: FleetState): number | undefined {\n  let newest: number | undefined;\n  for (const m of fleet.members) {\n    for (const sample of Object.values(m.latest)) {\n      const at = timeOf(sample);\n      if (!Number.isNaN(at) && (newest === undefined || at > newest)) newest = at;\n    }\n  }\n  return newest;\n}\n\n// ---- Cells -------------------------------------------------------------------\n\n// What one (device, measurement) cell holds, and when it holds nothing, why.\nexport type Cell =\n  | { kind: 'value'; sample: MeasurementSample; value: number }\n  | { kind: 'loading' }\n  // The device's history read failed and no live reading has arrived since.\n  | { kind: 'failed' }\n  // The device reported other measurements in the span, but never this one.\n  | { kind: 'not-reported' }\n  // The device reported this in the span, but its newest reading was not loaded (MemberSeed.unread).\n  | { kind: 'unread' }\n  // The device reported nothing at all in the span.\n  | { kind: 'no-data' };\n\nexport function cellFor(member: FleetMember, measurement: string): Cell {\n  const sample = member.latest[measurement];\n  if (sample && typeof sample.value === 'number' && Number.isFinite(sample.value)) {\n    return { kind: 'value', sample, value: sample.value };\n  }\n  if (member.seed === 'pending') return { kind: 'loading' };\n  if (member.seed === 'failed') return { kind: 'failed' };\n  if (member.unread?.includes(measurement)) return { kind: 'unread' };\n  return member.observed.length > 0 && !member.observed.includes(measurement) ? { kind: 'not-reported' } : { kind: 'no-data' };\n}\n\n// The columns: the measurements the datasource names, in that order; with none named, every\n// measurement any member reported, alphabetically (stable across renders however samples arrive).\nexport function columnNames(named: readonly string[], members: readonly FleetMember[]): string[] {\n  if (named.length > 0) return [...new Set(named)];\n  const seen = new Set<string>();\n  for (const m of members) for (const name of m.observed) seen.add(name);\n  return [...seen].sort((a, b) => a.localeCompare(b));\n}\n\n// ---- Order and pages ------------------------------------------------------------\n\nexport interface SortKey {\n  // A measurement name, or null for the device-name column.\n  by: string | null;\n  descending: boolean;\n}\n\nexport function deviceLabel(member: Pick<FleetMember, 'name' | 'token'>): string {\n  return member.name && member.name !== '' ? member.name : member.token;\n}\n\nconst collator = new Intl.Collator(undefined, { numeric: true, sensitivity: 'base' });\n\n// Ordered by the key, ties broken by device name then token, so the order never depends on the\n// order samples arrived in. A device with no value for the sorted measurement goes LAST in either\n// direction: \"largest first\" must not open with the devices that reported nothing.\nexport function sortMembers(members: readonly FleetMember[], key: SortKey): FleetMember[] {\n  const byDevice = (a: FleetMember, b: FleetMember): number =>\n    collator.compare(deviceLabel(a), deviceLabel(b)) || (a.token < b.token ? -1 : a.token > b.token ? 1 : 0);\n  const sign = key.descending ? -1 : 1;\n  return [...members].sort((a, b) => {\n    if (key.by === null) return sign * byDevice(a, b);\n    const ca = cellFor(a, key.by);\n    const cb = cellFor(b, key.by);\n    if (ca.kind !== 'value' || cb.kind !== 'value') {\n      if (ca.kind === cb.kind) return byDevice(a, b);\n      return ca.kind === 'value' ? -1 : cb.kind === 'value' ? 1 : byDevice(a, b);\n    }\n    return sign * (ca.value - cb.value) || byDevice(a, b);\n  });\n}\n\nexport const DEFAULT_PAGE_SIZE = 20;\n\nexport function pageCount(rows: number, pageSize: number): number {\n  return Math.max(1, Math.ceil(rows / Math.max(1, pageSize)));\n}\n\n// The page asked for, held inside what exists (a fleet that shrinks must not leave the viewer on a\n// page past the end).\nexport function clampPage(page: number, rows: number, pageSize: number): number {\n  return Math.min(Math.max(0, page), pageCount(rows, pageSize) - 1);\n}\n\n// ---- Bars ---------------------------------------------------------------------------\n\n// One bar per member for one measurement, in the shape the bar chart already draws (category\n// items), ordered like the categorical charts order theirs. A device with no number keeps its\n// label with no bar and sorts after those that have one.\nexport interface DeviceBar {\n  label: string;\n  token: string;\n  value: number | null;\n}\n\nexport function deviceBars(members: readonly FleetMember[], measurement: string, sort: 'none' | 'ascending' | 'descending'): DeviceBar[] {\n  const bars = members.map((m): DeviceBar => {\n    const cell = cellFor(m, measurement);\n    return { label: deviceLabel(m), token: m.token, value: cell.kind === 'value' ? cell.value : null };\n  });\n  if (sort === 'none') return bars;\n  const sign = sort === 'ascending' ? 1 : -1;\n  return bars\n    .map((bar, i) => ({ bar, i }))\n    .sort((a, b) => {\n      if (a.bar.value === null || b.bar.value === null) {\n        return a.bar.value === b.bar.value ? a.i - b.i : a.bar.value === null ? 1 : -1;\n      }\n      return sign * (a.bar.value - b.bar.value) || a.i - b.i;\n    })\n    .map((x) => x.bar);\n}\n", "// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// The fixed words the fleet table and the per-device bar chart render themselves: the device\n// column, the reason a cell holds no number, the truncation and paging captions. The widget\n// packages carry no i18n runtime, so this is the one small per-language table (modelled on\n// aggregate-strings.ts); option labels are translated in the console's catalogs, not here.\n\nimport { viewerLocale } from '@devicechain/widget-sdk';\n\nexport interface FleetStrings {\n  device: string;\n  loading: string;\n  // The reason a cell holds no number (D-5): each is a different fact about the device.\n  notReported: string;\n  // It reported this, but its newest reading was not loaded: there IS data.\n  unread: string;\n  noData: string;\n  failed: string;\n  // Whole-widget states.\n  unbound: string;\n  forbidden: string;\n  unsupported: string;\n  noMembers: string;\n  noMeasurement: string;\n  // A widget that shows one device, bound to a group: refused, with where the group can be shown.\n  oneDevice: string;\n  useFleetTable: string;\n  usePerDevice: string;\n  stale: string;\n  // \"Showing 500 of 812 devices\": a fleet past what is read must say so.\n  truncated: (shown: number, total: number) => string;\n  range: (from: number, to: number, of: number) => string;\n  previous: string;\n  next: string;\n  sortBy: (column: string) => string;\n  drill: (device: string) => string;\n}\n\nexport const FLEET_STRINGS: Record<'en' | 'es', FleetStrings> = {\n  en: {\n    device: 'Device',\n    loading: 'Loading',\n    notReported: 'does not report this',\n    unread: 'not loaded',\n    noData: 'no data in range',\n    failed: 'could not be read',\n    unbound: 'Choose a device group for this widget',\n    forbidden: 'You do not have access to this data',\n    unsupported: 'This data source cannot list a fleet',\n    noMembers: 'No devices in this group',\n    noMeasurement: 'Choose the measurement to compare',\n    oneDevice: 'This widget shows one device, and it is bound to a group of devices whose readings it would mix together.',\n    useFleetTable: 'Bind it to one device, or show the group in a fleet table.',\n    usePerDevice: 'Set it to one bar per device to compare them, or bind it to one device.',\n    stale: 'stale',\n    truncated: (shown, total) => `Showing ${shown} of ${total} devices`,\n    range: (from, to, of) => `${from}\u2013${to} of ${of}`,\n    previous: 'Previous page',\n    next: 'Next page',\n    sortBy: (column) => `Sort by ${column}`,\n    drill: (device) => `Show ${device} in the linked widgets`,\n  },\n  es: {\n    device: 'Dispositivo',\n    loading: 'Cargando',\n    notReported: 'no informa esta medici\u00F3n',\n    unread: 'no cargado',\n    noData: 'sin datos en el rango',\n    failed: 'no se pudo leer',\n    unbound: 'Elija un grupo de dispositivos para este widget',\n    forbidden: 'No tiene acceso a estos datos',\n    unsupported: 'Esta fuente de datos no puede listar una flota',\n    noMembers: 'No hay dispositivos en este grupo',\n    noMeasurement: 'Elija la medici\u00F3n que comparar',\n    oneDevice: 'Este widget muestra un solo dispositivo y est\u00E1 vinculado a un grupo de dispositivos cuyas lecturas mezclar\u00EDa.',\n    useFleetTable: 'Vinc\u00FAlelo a un dispositivo o muestre el grupo en una tabla de flota.',\n    usePerDevice: 'Config\u00FArelo con una barra por dispositivo para compararlos, o vinc\u00FAlelo a un dispositivo.',\n    stale: 'obsoleto',\n    truncated: (shown, total) => `Mostrando ${shown} de ${total} dispositivos`,\n    range: (from, to, of) => `${from}\u2013${to} de ${of}`,\n    previous: 'P\u00E1gina anterior',\n    next: 'P\u00E1gina siguiente',\n    sortBy: (column) => `Ordenar por ${column}`,\n    drill: (device) => `Mostrar ${device} en los widgets enlazados`,\n  },\n};\n\nexport function fleetStrings(locale: string | undefined = viewerLocale()): FleetStrings {\n  return locale?.toLowerCase().split('-')[0] === 'es' ? FLEET_STRINGS.es : FLEET_STRINGS.en;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// The fleet widgets' state, decided apart from the drawing and from the hub: which reading a cell\n// shows, why one is empty, how the rows are ordered and paged. Pure, so each rule is a test.\n//\n// Everything is keyed by DEVICE and measurement together. The measurement channel keys its latest\n// values by name alone, so two thermostats reporting \"temperature\" overwrite each other there;\n// nothing in this file ever looks a value up by name without the device beside it.\n\nimport {\n  bucketSecondsFor,\n  type FleetMember,\n  type FleetState,\n  type HistoryWindow,\n  type MeasurementSample,\n  type MemberRoster,\n  type MemberSeed,\n} from '@devicechain/dashboards';\n\nconst MINUTE_MS = 60_000;\n\n// The window a fleet's seed reads: whole minutes ending at the last minute boundary at or before\n// `at`, in buckets of bucketSecondsFor(span) (a multiple of 60, so the store answers from its\n// one-minute summaries). Whole minutes are what let widgets reading the same span on the same\n// board share one request per device (the hub keys in-flight reads by window), and what keep the\n// window from holding a reading from before the span. The end is the instant just before the\n// boundary, because the store's end is inclusive.\nexport function seedWindow(spanSeconds: number, at: number): HistoryWindow {\n  const end = Math.floor(at / MINUTE_MS) * MINUTE_MS;\n  const start = Math.ceil((end - spanSeconds * 1000) / MINUTE_MS) * MINUTE_MS;\n  return {\n    startTime: new Date(start).toISOString(),\n    endTime: new Date(end - 1).toISOString(),\n    intervalSeconds: bucketSecondsFor(Math.max(60, (end - start) / 1000)),\n  };\n}\n\n// ---- Building the state ------------------------------------------------------\n\n// What the feed has gathered. `seeds` holds a settled seed per device (`'failed'` for a read that\n// did not come back); a device absent from it is still loading. `live` is every device's newest\n// sample per measurement name since the board opened.\nexport interface FleetInputs {\n  roster: MemberRoster | null;\n  seeds: ReadonlyMap<string, MemberSeed | 'failed'>;\n  live: ReadonlyMap<string, ReadonlyMap<string, MeasurementSample>>;\n  // The start of the span (epoch ms): a reading older than this is not \"in range\".\n  since: number;\n  forbidden: boolean;\n}\n\nfunction timeOf(sample: MeasurementSample | undefined): number {\n  if (!sample?.occurredTime) return Number.NaN;\n  return Date.parse(sample.occurredTime);\n}\n\n// A sample with no readable time is taken as current: only a live sample can lack one, and it just\n// arrived.\nfunction inRange(sample: MeasurementSample, since: number): boolean {\n  const at = timeOf(sample);\n  return Number.isNaN(at) || at >= since;\n}\n\nfunction newer(a: MeasurementSample | undefined, b: MeasurementSample | undefined): MeasurementSample | undefined {\n  if (!a) return b;\n  if (!b) return a;\n  const ta = timeOf(a);\n  const tb = timeOf(b);\n  if (Number.isNaN(ta)) return a;\n  if (Number.isNaN(tb)) return b;\n  return tb >= ta ? b : a;\n}\n\nexport function buildFleet(i: FleetInputs): FleetState {\n  if (i.forbidden) return { status: 'forbidden', members: [], total: 0, truncated: false };\n  if (!i.roster) return { status: 'loading', members: [], total: 0, truncated: false };\n  if (i.roster.unbound) return { status: 'unbound', members: [], total: 0, truncated: false };\n\n  // A seeded reading is stamped at the start of its minute (fleet-seed.ts, \"Ages\") and happened\n  // somewhere in that minute, so it is in range while its minute is. Held to the exact instant, a\n  // reading 59 minutes 45 seconds old on an hour's board was dropped as out of range.\n  const seedSince = Math.floor(i.since / MINUTE_MS) * MINUTE_MS;\n  const members = i.roster.members.map((ref): FleetMember => {\n    const seed = i.seeds.get(ref.token);\n    const seeded = seed && seed !== 'failed' ? seed : undefined;\n    const live = i.live.get(ref.token);\n    const latest: Record<string, MeasurementSample> = {};\n    const names = new Set<string>([...Object.keys(seeded?.latest ?? {}), ...(live?.keys() ?? [])]);\n    for (const name of names) {\n      const best = newer(seeded?.latest[name], live?.get(name));\n      if (best && inRange(best, best === seeded?.latest[name] ? seedSince : i.since)) latest[name] = best;\n    }\n    const observed = new Set<string>(seeded?.observed ?? []);\n    for (const name of Object.keys(latest)) observed.add(name);\n    return {\n      token: ref.token,\n      name: ref.name,\n      latest,\n      seed: seed === undefined ? 'pending' : seed === 'failed' ? 'failed' : 'ready',\n      observed: [...observed],\n      // A live reading of an unread name is its value: cellFor looks at `latest` first.\n      ...(seeded?.unread?.length ? { unread: seeded.unread } : {}),\n    };\n  });\n  return {\n    status: 'ready',\n    members,\n    total: i.roster.total,\n    truncated: i.roster.total > members.length,\n  };\n}\n\n// The newest reading anywhere in the fleet (epoch ms), or undefined when none carries a time.\nexport function newestMemberTime(fleet: FleetState): number | undefined {\n  let newest: number | undefined;\n  for (const m of fleet.members) {\n    for (const sample of Object.values(m.latest)) {\n      const at = timeOf(sample);\n      if (!Number.isNaN(at) && (newest === undefined || at > newest)) newest = at;\n    }\n  }\n  return newest;\n}\n\n// ---- Cells -------------------------------------------------------------------\n\n// What one (device, measurement) cell holds, and when it holds nothing, why.\nexport type Cell =\n  | { kind: 'value'; sample: MeasurementSample; value: number }\n  | { kind: 'loading' }\n  // The device's history read failed and no live reading has arrived since.\n  | { kind: 'failed' }\n  // The device reported other measurements in the span, but never this one.\n  | { kind: 'not-reported' }\n  // The device reported this in the span, but its newest reading was not loaded (MemberSeed.unread).\n  | { kind: 'unread' }\n  // The device reported nothing at all in the span.\n  | { kind: 'no-data' };\n\nexport function cellFor(member: FleetMember, measurement: string): Cell {\n  const sample = member.latest[measurement];\n  if (sample && typeof sample.value === 'number' && Number.isFinite(sample.value)) {\n    return { kind: 'value', sample, value: sample.value };\n  }\n  if (member.seed === 'pending') return { kind: 'loading' };\n  if (member.seed === 'failed') return { kind: 'failed' };\n  if (member.unread?.includes(measurement)) return { kind: 'unread' };\n  return member.observed.length > 0 && !member.observed.includes(measurement) ? { kind: 'not-reported' } : { kind: 'no-data' };\n}\n\n// The columns: the measurements the datasource names, in that order; with none named, every\n// measurement any member reported, alphabetically (stable across renders however samples arrive).\nexport function columnNames(named: readonly string[], members: readonly FleetMember[]): string[] {\n  if (named.length > 0) return [...new Set(named)];\n  const seen = new Set<string>();\n  for (const m of members) for (const name of m.observed) seen.add(name);\n  return [...seen].sort((a, b) => a.localeCompare(b));\n}\n\n// ---- Order and pages ------------------------------------------------------------\n\nexport interface SortKey {\n  // A measurement name, or null for the device-name column.\n  by: string | null;\n  descending: boolean;\n}\n\nexport function deviceLabel(member: Pick<FleetMember, 'name' | 'token'>): string {\n  return member.name && member.name !== '' ? member.name : member.token;\n}\n\nconst collator = new Intl.Collator(undefined, { numeric: true, sensitivity: 'base' });\n\n// Ordered by the key, ties broken by device name then token, so the order never depends on the\n// order samples arrived in. A device with no value for the sorted measurement goes LAST in either\n// direction: \"largest first\" must not open with the devices that reported nothing.\nexport function sortMembers(members: readonly FleetMember[], key: SortKey): FleetMember[] {\n  const byDevice = (a: FleetMember, b: FleetMember): number =>\n    collator.compare(deviceLabel(a), deviceLabel(b)) || (a.token < b.token ? -1 : a.token > b.token ? 1 : 0);\n  const sign = key.descending ? -1 : 1;\n  return [...members].sort((a, b) => {\n    if (key.by === null) return sign * byDevice(a, b);\n    const ca = cellFor(a, key.by);\n    const cb = cellFor(b, key.by);\n    if (ca.kind !== 'value' || cb.kind !== 'value') {\n      if (ca.kind === cb.kind) return byDevice(a, b);\n      return ca.kind === 'value' ? -1 : cb.kind === 'value' ? 1 : byDevice(a, b);\n    }\n    return sign * (ca.value - cb.value) || byDevice(a, b);\n  });\n}\n\nexport const DEFAULT_PAGE_SIZE = 20;\n\nexport function pageCount(rows: number, pageSize: number): number {\n  return Math.max(1, Math.ceil(rows / Math.max(1, pageSize)));\n}\n\n// The page asked for, held inside what exists (a fleet that shrinks must not leave the viewer on a\n// page past the end).\nexport function clampPage(page: number, rows: number, pageSize: number): number {\n  return Math.min(Math.max(0, page), pageCount(rows, pageSize) - 1);\n}\n\n// ---- Bars ---------------------------------------------------------------------------\n\n// One bar per member for one measurement, in the shape the bar chart already draws (category\n// items), ordered like the categorical charts order theirs. A device with no number keeps its\n// label with no bar and sorts after those that have one.\nexport interface DeviceBar {\n  label: string;\n  token: string;\n  value: number | null;\n}\n\nexport function deviceBars(members: readonly FleetMember[], measurement: string, sort: 'none' | 'ascending' | 'descending'): DeviceBar[] {\n  const bars = members.map((m): DeviceBar => {\n    const cell = cellFor(m, measurement);\n    return { label: deviceLabel(m), token: m.token, value: cell.kind === 'value' ? cell.value : null };\n  });\n  if (sort === 'none') return bars;\n  const sign = sort === 'ascending' ? 1 : -1;\n  return bars\n    .map((bar, i) => ({ bar, i }))\n    .sort((a, b) => {\n      if (a.bar.value === null || b.bar.value === null) {\n        return a.bar.value === b.bar.value ? a.i - b.i : a.bar.value === null ? 1 : -1;\n      }\n      return sign * (a.bar.value - b.bar.value) || a.i - b.i;\n    })\n    .map((x) => x.bar);\n}\n", "// Copyright The DeviceChain Authors\n// SPDX-License-Identifier: Apache-2.0\n\n// The fixed words the fleet table and the per-device bar chart render themselves: the device\n// column, the reason a cell holds no number, the truncation and paging captions. The widget\n// packages carry no i18n runtime, so this is the one small per-language table (modelled on\n// aggregate-strings.ts); option labels are translated in the console's catalogs, not here.\n\nimport { viewerLocale } from '@devicechain/widget-sdk';\nimport { ACCESS_STRINGS } from './access-strings';\n\nexport interface FleetStrings {\n  device: string;\n  loading: string;\n  // The reason a cell holds no number (D-5): each is a different fact about the device.\n  notReported: string;\n  // It reported this, but its newest reading was not loaded: there IS data.\n  unread: string;\n  noData: string;\n  failed: string;\n  // Whole-widget states.\n  unbound: string;\n  forbidden: string;\n  unsupported: string;\n  noMembers: string;\n  noMeasurement: string;\n  // A widget that shows one device, bound to a group: refused, with where the group can be shown.\n  oneDevice: string;\n  useFleetTable: string;\n  usePerDevice: string;\n  stale: string;\n  // \"Showing 500 of 812 devices\": a fleet past what is read must say so.\n  truncated: (shown: number, total: number) => string;\n  range: (from: number, to: number, of: number) => string;\n  previous: string;\n  next: string;\n  sortBy: (column: string) => string;\n  drill: (device: string) => string;\n}\n\nexport const FLEET_STRINGS: Record<'en' | 'es', FleetStrings> = {\n  en: {\n    device: 'Device',\n    loading: 'Loading',\n    notReported: 'does not report this',\n    unread: 'not loaded',\n    noData: 'no data in range',\n    failed: 'could not be read',\n    unbound: 'Choose a device group for this widget',\n    forbidden: ACCESS_STRINGS.en.forbidden,\n    unsupported: 'This data source cannot list a fleet',\n    noMembers: 'No devices in this group',\n    noMeasurement: 'Choose the measurement to compare',\n    oneDevice: 'This widget shows one device, and it is bound to a group of devices whose readings it would mix together.',\n    useFleetTable: 'Bind it to one device, or show the group in a fleet table.',\n    usePerDevice: 'Set it to one bar per device to compare them, or bind it to one device.',\n    stale: 'stale',\n    truncated: (shown, total) => `Showing ${shown} of ${total} devices`,\n    range: (from, to, of) => `${from}\u2013${to} of ${of}`,\n    previous: 'Previous page',\n    next: 'Next page',\n    sortBy: (column) => `Sort by ${column}`,\n    drill: (device) => `Show ${device} in the linked widgets`,\n  },\n  es: {\n    device: 'Dispositivo',\n    loading: 'Cargando',\n    notReported: 'no informa esta medici\u00F3n',\n    unread: 'no cargado',\n    noData: 'sin datos en el rango',\n    failed: 'no se pudo leer',\n    unbound: 'Elija un grupo de dispositivos para este widget',\n    forbidden: ACCESS_STRINGS.es.forbidden,\n    unsupported: 'Esta fuente de datos no puede listar una flota',\n    noMembers: 'No hay dispositivos en este grupo',\n    noMeasurement: 'Elija la medici\u00F3n que comparar',\n    oneDevice: 'Este widget muestra un solo dispositivo y est\u00E1 vinculado a un grupo de dispositivos cuyas lecturas mezclar\u00EDa.',\n    useFleetTable: 'Vinc\u00FAlelo a un dispositivo o muestre el grupo en una tabla de flota.',\n    usePerDevice: 'Config\u00FArelo con una barra por dispositivo para compararlos, o vinc\u00FAlelo a un dispositivo.',\n    stale: 'obsoleto',\n    truncated: (shown, total) => `Mostrando ${shown} de ${total} dispositivos`,\n    range: (from, to, of) => `${from}\u2013${to} de ${of}`,\n    previous: 'P\u00E1gina anterior',\n    next: 'P\u00E1gina siguiente',\n    sortBy: (column) => `Ordenar por ${column}`,\n    drill: (device) => `Mostrar ${device} en los widgets enlazados`,\n  },\n};\n\nexport function fleetStrings(locale: string | undefined = viewerLocale()): FleetStrings {\n  return locale?.toLowerCase().split('-')[0] === 'es' ? FLEET_STRINGS.es : FLEET_STRINGS.en;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/chunks/chunk-XSLFHCNI.js

@@ -0,0 +1,419 @@
+// src/widgets/command-status.ts
+import { isTerminalCommandStatus } from "@devicechain/dashboards";
+var STATUS_COLORS = {
+  SUCCESSFUL: "#16a34a",
+  // green-600 — acknowledged by the device
+  FAILED: "#dc2626",
+  // red-600
+  TIMEOUT: "#dc2626",
+  // red-600 — never acknowledged in time
+  EXPIRED: "#64748b",
+  // slate-500 — lapsed before it was ever sent
+  CANCELLED: "#7c3aed",
+  // violet-600 — deliberately called off; a decision, not a failure
+  QUEUED: "#0284c7",
+  // sky-600 — in flight
+  SENT: "#0284c7",
+  HELD: "#d97706",
+  // amber-600 — withheld: the device is absent, the command still stands
+  PARKED: "#f59e0b"
+  // amber-500 — published, nobody home; held for the device's return
+};
+var UNKNOWN_COLOR = "#64748b";
+function commandStatusColor(status) {
+  return STATUS_COLORS[status] ?? UNKNOWN_COLOR;
+}
+function isTerminalStatus(status) {
+  return isTerminalCommandStatus(status);
+}
+function commandStatusLabel(status) {
+  if (!status) return "";
+  return status.charAt(0).toUpperCase() + status.slice(1).toLowerCase();
+}
+
+// src/widgets/command-params.ts
+var DATA_TYPES = /* @__PURE__ */ new Set(["DOUBLE", "INT", "BOOLEAN", "STRING"]);
+function parseParameterSchema(schema) {
+  if (!schema) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(schema);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const out = [];
+  for (const raw of parsed) {
+    const norm = normalizeParam(raw);
+    if (norm) out.push(norm);
+  }
+  return out;
+}
+function normalizeParam(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const r = raw;
+  if (typeof r.name !== "string") return null;
+  const param = { name: r.name };
+  if (typeof r.description === "string") param.description = r.description;
+  if (r.kind === "OBJECT") param.kind = "OBJECT";
+  else if (r.kind === "SCALAR") param.kind = "SCALAR";
+  if (typeof r.dataType === "string" && DATA_TYPES.has(r.dataType)) {
+    param.dataType = r.dataType;
+  }
+  if (typeof r.unit === "string") param.unit = r.unit;
+  if (r.required === true) param.required = true;
+  if (typeof r.default === "string") param.default = r.default;
+  if (typeof r.minValue === "number" && Number.isFinite(r.minValue)) param.minValue = r.minValue;
+  if (typeof r.maxValue === "number" && Number.isFinite(r.maxValue)) param.maxValue = r.maxValue;
+  if (Array.isArray(r.enum)) {
+    const values = r.enum.filter((v) => typeof v === "string");
+    if (values.length > 0) param.enum = values;
+  }
+  return param;
+}
+function isScalar(param) {
+  return param.kind !== "OBJECT";
+}
+function parseBool(raw) {
+  const s = raw.trim().toLowerCase();
+  return s === "true" || s === "1" || s === "t" || s === "yes" || s === "on";
+}
+function defaultValues(params) {
+  const values = {};
+  for (const p of params) {
+    if (!isScalar(p)) continue;
+    if (p.dataType === "BOOLEAN") values[p.name] = parseBool(p.default ?? "") ? "true" : "false";
+    else if (p.default != null) values[p.name] = p.default;
+  }
+  return values;
+}
+function validateParams(params, values) {
+  const errors = {};
+  for (const p of params) {
+    if (!isScalar(p)) {
+      if (p.required) errors[p.name] = "Structured parameter \u2014 not supported here";
+      continue;
+    }
+    if (p.dataType === "BOOLEAN") continue;
+    const raw = (values[p.name] ?? "").trim();
+    if (raw === "") {
+      if (p.required) errors[p.name] = "Required";
+      continue;
+    }
+    if (p.dataType === "INT" || p.dataType === "DOUBLE") {
+      const n = Number(raw);
+      if (!Number.isFinite(n)) {
+        errors[p.name] = "Must be a number";
+      } else if (p.dataType === "INT" && !Number.isInteger(n)) {
+        errors[p.name] = "Must be a whole number";
+      } else if (p.minValue != null && n < p.minValue) {
+        errors[p.name] = `Must be \u2265 ${p.minValue}`;
+      } else if (p.maxValue != null && n > p.maxValue) {
+        errors[p.name] = `Must be \u2264 ${p.maxValue}`;
+      }
+    }
+  }
+  return errors;
+}
+function buildPayload(params, values) {
+  const payload = {};
+  for (const p of params) {
+    if (!isScalar(p)) continue;
+    const raw = (values[p.name] ?? "").trim();
+    if (p.dataType === "BOOLEAN") {
+      payload[p.name] = parseBool(raw);
+      continue;
+    }
+    if (raw === "") continue;
+    payload[p.name] = coerce(p, raw);
+  }
+  return Object.keys(payload).length === 0 ? void 0 : JSON.stringify(payload);
+}
+function coerce(param, raw) {
+  switch (param.dataType) {
+    case "INT":
+    case "DOUBLE": {
+      const n = Number(raw);
+      return Number.isFinite(n) ? n : raw;
+    }
+    case "BOOLEAN":
+      return parseBool(raw);
+    default:
+      return raw;
+  }
+}
+
+// src/widgets/command-button.tsx
+import { useEffect, useMemo, useRef, useState } from "react";
+import {
+  css,
+  fontVar,
+  formatDateTime,
+  optString,
+  useWidgetTimeZone,
+  WidgetFrame
+} from "@devicechain/widget-sdk";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function CommandButton({ widget, data, actions }) {
+  const commandName = optString(widget.options, "commandName");
+  const commandLabel = optString(widget.options, "commandLabel") ?? commandName;
+  const parameterSchema = optString(widget.options, "parameterSchema") ?? null;
+  const params = useMemo(() => parseParameterSchema(parameterSchema), [parameterSchema]);
+  const schemaKey = `${commandName ?? ""}::${parameterSchema ?? ""}`;
+  const [values, setValues] = useState(() => defaultValues(params));
+  const [errors, setErrors] = useState({});
+  const [pending, setPending] = useState(false);
+  const [sendError, setSendError] = useState(null);
+  const [sentToken, setSentToken] = useState(null);
+  const sendGen = useRef(0);
+  useEffect(() => {
+    sendGen.current += 1;
+    setValues(defaultValues(params));
+    setErrors({});
+    setSendError(null);
+    setSentToken(null);
+  }, [schemaKey]);
+  const canWrite = actions?.can("command:write") ?? false;
+  const hasSeam = typeof actions?.sendCommand === "function";
+  const deviceToken = data.deviceToken;
+  const formDisabled = !canWrite || !hasSeam || pending;
+  const canSend = !formDisabled && !!deviceToken && !!commandName;
+  const setField = (name, value) => {
+    setValues((prev) => ({ ...prev, [name]: value }));
+    setErrors((prev) => prev[name] ? { ...prev, [name]: "" } : prev);
+    setSendError(null);
+  };
+  const send = () => {
+    if (!deviceToken || !commandName || !actions?.sendCommand) return;
+    const found = validateParams(params, values);
+    const active = Object.fromEntries(Object.entries(found).filter(([, v]) => v));
+    if (Object.keys(active).length > 0) {
+      setErrors(active);
+      return;
+    }
+    const payload = buildPayload(params, values);
+    const gen = sendGen.current;
+    setPending(true);
+    setSendError(null);
+    let promise;
+    try {
+      promise = actions.sendCommand(deviceToken, commandName, payload);
+    } catch {
+      setSendError(SEND_FAILED);
+      setPending(false);
+      return;
+    }
+    promise.then((dispatch) => {
+      if (gen !== sendGen.current) return;
+      if (dispatch.status === "rejected") {
+        setSendError(dispatch.reason);
+        return;
+      }
+      setSentToken(dispatch.token);
+    }).catch(() => {
+      if (gen === sendGen.current) setSendError(SEND_FAILED);
+    }).finally(() => {
+      if (gen === sendGen.current) setPending(false);
+    });
+  };
+  return /* @__PURE__ */ jsx(WidgetFrame, { title: optString(widget.options, "title"), children: /* @__PURE__ */ jsx("div", { style: { display: "flex", flexDirection: "column", height: "100%", gap: 10, overflowY: "auto" }, children: !commandName ? /* @__PURE__ */ jsx("div", { style: { ...hint, margin: "auto" }, children: "No command configured." }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 8, flexShrink: 0 }, children: [
+      params.map(
+        (param) => isScalar(param) ? /* @__PURE__ */ jsx(
+          ParamField,
+          {
+            widgetId: widget.id,
+            param,
+            value: values[param.name] ?? "",
+            error: errors[param.name],
+            disabled: formDisabled,
+            onChange: (v) => setField(param.name, v)
+          },
+          param.name
+        ) : (
+          // A structured (OBJECT) parameter isn't form-editable. A REQUIRED one
+          // blocks sending (validateParams flags it); flag that in the note.
+          /* @__PURE__ */ jsxs("div", { style: { ...hint, color: param.required ? commandStatusColor("FAILED") : css("muted-foreground") }, children: [
+            param.name,
+            ": ",
+            param.required ? "required " : "",
+            "structured parameter \u2014 not supported here."
+          ] }, param.name)
+        )
+      ),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          style: { ...sendButton, opacity: canSend ? 1 : 0.55, cursor: canSend ? "pointer" : "not-allowed" },
+          disabled: !canSend,
+          "aria-busy": pending,
+          onClick: send,
+          children: pending ? "Sending\u2026" : `Send ${commandLabel}`
+        }
+      ),
+      !canWrite ? /* @__PURE__ */ jsx("div", { style: hint, children: "You don\u2019t have permission to issue commands." }) : !hasSeam ? /* @__PURE__ */ jsx("div", { style: hint, children: "Commands aren\u2019t available in this view." }) : !deviceToken ? /* @__PURE__ */ jsx("div", { style: hint, children: "No device is selected for this command." }) : null,
+      sendError ? /* @__PURE__ */ jsx("div", { role: "alert", style: { ...hint, color: commandStatusColor("FAILED") }, children: sendError }) : null
+    ] }),
+    /* @__PURE__ */ jsx(CommandHistory, { commands: data.commands, sentToken, loading: data.loading, error: data.error })
+  ] }) }) });
+}
+function ParamField({
+  widgetId,
+  param,
+  value,
+  error,
+  disabled,
+  onChange
+}) {
+  const labelId = `cmd-${widgetId}-${param.name}`;
+  const unit = param.unit ? ` (${param.unit})` : "";
+  return /* @__PURE__ */ jsxs("label", { htmlFor: labelId, style: { display: "flex", flexDirection: "column", gap: 3 }, children: [
+    /* @__PURE__ */ jsxs("span", { style: { fontSize: fontVar("sm"), color: css("muted-foreground") }, children: [
+      param.name,
+      unit,
+      param.required ? /* @__PURE__ */ jsx("span", { style: { color: commandStatusColor("FAILED") }, children: " *" }) : null
+    ] }),
+    /* @__PURE__ */ jsx(ParamInput, { id: labelId, param, value, disabled, onChange }),
+    error ? /* @__PURE__ */ jsx("span", { style: { fontSize: fontVar("xs"), color: commandStatusColor("FAILED") }, children: error }) : null
+  ] });
+}
+function ParamInput({
+  id,
+  param,
+  value,
+  disabled,
+  onChange
+}) {
+  if (param.enum && param.enum.length > 0) {
+    return /* @__PURE__ */ jsxs("select", { id, style: inputStyle, value, disabled, onChange: (e) => onChange(e.target.value), children: [
+      !param.required ? /* @__PURE__ */ jsx("option", { value: "", children: "\u2014" }) : null,
+      param.enum.map((opt) => /* @__PURE__ */ jsx("option", { value: opt, children: opt }, opt))
+    ] });
+  }
+  if (param.dataType === "BOOLEAN") {
+    return /* @__PURE__ */ jsx(
+      "input",
+      {
+        id,
+        type: "checkbox",
+        style: { width: 16, height: 16 },
+        checked: parseBool(value),
+        disabled,
+        onChange: (e) => onChange(e.target.checked ? "true" : "false")
+      }
+    );
+  }
+  const numeric = param.dataType === "INT" || param.dataType === "DOUBLE";
+  return /* @__PURE__ */ jsx(
+    "input",
+    {
+      id,
+      type: numeric ? "number" : "text",
+      style: inputStyle,
+      value,
+      disabled,
+      min: param.minValue ?? void 0,
+      max: param.maxValue ?? void 0,
+      step: param.dataType === "INT" ? 1 : "any",
+      placeholder: param.default ?? void 0,
+      onChange: (e) => onChange(e.target.value)
+    }
+  );
+}
+function CommandHistory({
+  commands,
+  sentToken,
+  loading,
+  error
+}) {
+  const empty = commands.length === 0;
+  const timeZone = useWidgetTimeZone();
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        flex: 1,
+        minHeight: 0,
+        overflow: "auto",
+        borderTop: `1px solid ${css("border")}`,
+        paddingTop: 6
+      },
+      children: empty ? /* @__PURE__ */ jsx("div", { style: { ...hint, textAlign: "center", color: error ? commandStatusColor("FAILED") : css("muted-foreground") }, children: error ? "Couldn\u2019t load command history." : loading ? "Loading\u2026" : "No commands issued yet." }) : /* @__PURE__ */ jsx("ul", { style: { listStyle: "none", margin: 0, padding: 0, display: "flex", flexDirection: "column", gap: 4 }, children: commands.map((command) => /* @__PURE__ */ jsxs(
+        "li",
+        {
+          style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 8,
+            fontSize: fontVar("sm"),
+            // Highlight the command just issued from this widget.
+            fontWeight: command.token === sentToken ? 600 : 400
+          },
+          children: [
+            /* @__PURE__ */ jsx(StatusBadge, { status: command.status }),
+            /* @__PURE__ */ jsx("span", { style: { color: css("foreground"), whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" }, children: command.name }),
+            /* @__PURE__ */ jsx("span", { style: { marginLeft: "auto", color: css("muted-foreground"), whiteSpace: "nowrap" }, children: formatDateTime(command.queuedTime, timeZone) })
+          ]
+        },
+        command.token
+      )) })
+    }
+  );
+}
+function StatusBadge({ status }) {
+  const color = commandStatusColor(status);
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      style: {
+        display: "inline-flex",
+        alignItems: "center",
+        gap: 4,
+        flexShrink: 0,
+        fontSize: fontVar("xs"),
+        fontWeight: 600,
+        color
+      },
+      children: [
+        /* @__PURE__ */ jsx("span", { "aria-hidden": "true", style: { width: 7, height: 7, borderRadius: "50%", background: color } }),
+        commandStatusLabel(status)
+      ]
+    }
+  );
+}
+var hint = { fontSize: fontVar("xs"), color: css("muted-foreground") };
+var SEND_FAILED = "Couldn\u2019t issue the command. Try again.";
+var inputStyle = {
+  width: "100%",
+  boxSizing: "border-box",
+  padding: "4px 8px",
+  fontSize: fontVar("md"),
+  borderRadius: 4,
+  border: `1px solid ${css("border")}`,
+  background: css("background"),
+  color: css("foreground")
+};
+var sendButton = {
+  padding: "6px 12px",
+  fontSize: fontVar("md"),
+  fontWeight: 600,
+  borderRadius: 4,
+  border: "none",
+  background: css("primary"),
+  color: css("background"),
+  marginTop: 2
+};
+
+export {
+  commandStatusColor,
+  isTerminalStatus,
+  commandStatusLabel,
+  parseParameterSchema,
+  isScalar,
+  defaultValues,
+  validateParams,
+  buildPayload,
+  CommandButton
+};
+//# sourceMappingURL=chunk-XSLFHCNI.js.map