@zeluizr/lattice 1.0.0

package/dist/format.js

@@ -0,0 +1,56 @@
+/** Formatting helpers ported from the original Python dashboard. */
+const BLOCKS = " ▁▂▃▄▅▆▇█";
+export function fmtTok(n) {
+    const v = Number(n || 0);
+    if (v >= 1e6)
+        return `${(v / 1e6).toFixed(2)}M`;
+    if (v >= 1e3)
+        return `${(v / 1e3).toFixed(1)}k`;
+    return `${v.toFixed(0)}`;
+}
+export function humanBytes(n) {
+    if (n === null || n === undefined)
+        return "—";
+    let v = Number(n);
+    for (const unit of ["B", "KB", "MB", "GB", "TB"]) {
+        if (v < 1024 || unit === "TB") {
+            return unit === "B" ? `${v.toFixed(0)}${unit}` : `${v.toFixed(1)}${unit}`;
+        }
+        v /= 1024;
+    }
+    return `${v.toFixed(1)}TB`;
+}
+export function humanRate(bps) {
+    return `${humanBytes(bps)}/s`;
+}
+/** One block glyph (0–100%) for the per-core CPU strip. */
+export function coreCell(pct) {
+    const clamped = Math.max(0, Math.min(100, Number(pct || 0)));
+    const idx = Math.floor((clamped / 100) * (BLOCKS.length - 1));
+    return BLOCKS[idx];
+}
+/** Build a sparkline string from a numeric history. */
+export function sparkline(history, width = 0) {
+    const data = history.filter((x) => x !== null && x !== undefined && !Number.isNaN(x));
+    if (data.length === 0)
+        return "";
+    const slice = width > 0 ? data.slice(-width) : data;
+    const lo = Math.min(...slice);
+    const hi = Math.max(...slice);
+    const span = hi - lo || 1;
+    return slice
+        .map((v) => {
+        const idx = Math.round(((v - lo) / span) * (BLOCKS.length - 1));
+        return BLOCKS[Math.max(1, idx)];
+    })
+        .join("");
+}
+/** Pick a status level by thresholds (mirrors the Python status() helper). */
+export function statusLevel(value, warn, crit) {
+    const v = Number(value || 0);
+    if (v < warn)
+        return "ok";
+    if (v < crit)
+        return "warn";
+    return "crit";
+}

package/dist/i18n/en.js

@@ -0,0 +1,76 @@
+/** English (base locale). Every other locale must implement these exact keys. */
+export const en = {
+    "subtitle": "system · gpu · power",
+    "paused": "PAUSED",
+    "panel.cpu": "CPU",
+    "panel.mem": "MEMORY",
+    "panel.temp": "TEMPERATURE",
+    "panel.net": "NETWORK",
+    "panel.disks": "DISKS",
+    "panel.git": "GIT · REPOS",
+    "panel.gpu": "GPU",
+    "panel.tokens": "AI · TOKENS TODAY",
+    "panel.vtex": "VTEX",
+    "panel.procs": "PROCESSES",
+    "status.cpu.ok": "calm",
+    "status.cpu.warn": "busy",
+    "status.cpu.crit": "overload",
+    "status.mem.ok": "ok",
+    "status.mem.warn": "watch",
+    "status.mem.crit": "full",
+    "status.disk.ok": "ok",
+    "status.disk.warn": "filling",
+    "status.disk.crit": "full",
+    "status.gpu.ok": "calm",
+    "status.gpu.warn": "active",
+    "status.gpu.crit": "high",
+    "status.temp.ok": "normal",
+    "status.temp.warn": "warm",
+    "status.temp.crit": "hot",
+    "cpu.usage": "Usage",
+    "cpu.cores": "Cores",
+    "cpu.perCore": "per core",
+    "mem.ram": "RAM",
+    "mem.used": "{used} of {total} used · swap {swap}%",
+    "disks.mount": "MOUNT",
+    "disks.read": "READ",
+    "disks.write": "WRITE",
+    "disks.usage": "USAGE",
+    "git.repo": "REPO",
+    "git.branch": "BRANCH",
+    "git.state": "STATE",
+    "git.clean": "clean",
+    "git.dirty": "dirty",
+    "gpu.usage": "Usage",
+    "gpu.mem": "mem {used}/{alloc}",
+    "temp.unavailable": "sensors unavailable",
+    "temp.waitingSudo": "waiting for sudo",
+    "temp.needsSudo": "power: requires sudo",
+    "spark.collecting": "collecting…",
+    "spark.lastMin": "last min: {range}",
+    "tokens.spent": "Spent today: ${cost}  ·  {messages} messages",
+    "tokens.tokens": "Tokens: {total} · in {input} · out {output}",
+    "tokens.cache": "Cache: write {cw} · read {cr}",
+    "tokens.byModel": "By model: {models}",
+    "tokens.none": "—",
+    "vtex.status": "Status",
+    "vtex.notInstalled": "CLI not installed",
+    "vtex.install": "Install with: brew install vtex/cli/vtex",
+    "vtex.connected": "connected ✓",
+    "vtex.account": "Account",
+    "vtex.user": "User",
+    "vtex.workspace": "Workspace",
+    "vtex.notConnected": "not connected",
+    "vtex.signin": "Sign in with: vtex login <account>",
+    "proc.cpu": "CPU%",
+    "proc.mem": "MEM",
+    "proc.pid": "PID",
+    "proc.name": "Process",
+    "key.quit": "Quit",
+    "key.pause": "Pause",
+    "key.faster": "Faster",
+    "key.slower": "Slower",
+    "cli.sudoNeed": "lattice needs sudo to read power (powermetrics).",
+    "cli.sudoFail": "sudo unavailable — continuing without power data.",
+    "cli.sudoCancel": "cancelled.",
+};

package/dist/i18n/es.js

@@ -0,0 +1,75 @@
+export const es = {
+    "subtitle": "sistema · gpu · energía",
+    "paused": "PAUSADO",
+    "panel.cpu": "CPU",
+    "panel.mem": "MEMORIA",
+    "panel.temp": "TEMPERATURA",
+    "panel.net": "RED",
+    "panel.disks": "DISCOS",
+    "panel.git": "GIT · REPOS",
+    "panel.gpu": "GPU",
+    "panel.tokens": "IA · TOKENS HOY",
+    "panel.vtex": "VTEX",
+    "panel.procs": "PROCESOS",
+    "status.cpu.ok": "tranquilo",
+    "status.cpu.warn": "ocupado",
+    "status.cpu.crit": "sobrecarga",
+    "status.mem.ok": "ok",
+    "status.mem.warn": "atención",
+    "status.mem.crit": "llena",
+    "status.disk.ok": "ok",
+    "status.disk.warn": "llenándose",
+    "status.disk.crit": "lleno",
+    "status.gpu.ok": "tranquila",
+    "status.gpu.warn": "activa",
+    "status.gpu.crit": "alta",
+    "status.temp.ok": "normal",
+    "status.temp.warn": "tibia",
+    "status.temp.crit": "caliente",
+    "cpu.usage": "Uso",
+    "cpu.cores": "Núcleos",
+    "cpu.perCore": "por núcleo",
+    "mem.ram": "RAM",
+    "mem.used": "{used} de {total} usados · swap {swap}%",
+    "disks.mount": "MONTAJE",
+    "disks.read": "LECTURA",
+    "disks.write": "ESCRITURA",
+    "disks.usage": "USO",
+    "git.repo": "REPO",
+    "git.branch": "BRANCH",
+    "git.state": "ESTADO",
+    "git.clean": "limpio",
+    "git.dirty": "sucio",
+    "gpu.usage": "Uso",
+    "gpu.mem": "mem {used}/{alloc}",
+    "temp.unavailable": "sensores no disponibles",
+    "temp.waitingSudo": "esperando sudo",
+    "temp.needsSudo": "energía: requiere sudo",
+    "spark.collecting": "recolectando…",
+    "spark.lastMin": "último min: {range}",
+    "tokens.spent": "Gastado hoy: ${cost}  ·  {messages} mensajes",
+    "tokens.tokens": "Tokens: {total} · entrada {input} · salida {output}",
+    "tokens.cache": "Caché: escribe {cw} · lee {cr}",
+    "tokens.byModel": "Por modelo: {models}",
+    "tokens.none": "—",
+    "vtex.status": "Estado",
+    "vtex.notInstalled": "CLI no instalada",
+    "vtex.install": "Instala con: brew install vtex/cli/vtex",
+    "vtex.connected": "conectado ✓",
+    "vtex.account": "Cuenta",
+    "vtex.user": "Usuario",
+    "vtex.workspace": "Workspace",
+    "vtex.notConnected": "no conectado",
+    "vtex.signin": "Entra con: vtex login <cuenta>",
+    "proc.cpu": "CPU%",
+    "proc.mem": "MEM",
+    "proc.pid": "PID",
+    "proc.name": "Proceso",
+    "key.quit": "Salir",
+    "key.pause": "Pausar",
+    "key.faster": "Más rápido",
+    "key.slower": "Más lento",
+    "cli.sudoNeed": "lattice necesita sudo para leer la energía (powermetrics).",
+    "cli.sudoFail": "sudo no disponible — siguiendo sin datos de energía.",
+    "cli.sudoCancel": "cancelado.",
+};

package/dist/i18n/index.js

@@ -0,0 +1,38 @@
+import { en } from "./en.js";
+import { es } from "./es.js";
+import { ptBR } from "./pt-BR.js";
+export const LANGS = [
+    { code: "en", label: "English" },
+    { code: "es", label: "Español" },
+    { code: "pt-BR", label: "Português (Brasil)" },
+];
+const TABLES = {
+    "en": en,
+    "es": es,
+    "pt-BR": ptBR,
+};
+export function isLang(value) {
+    return value === "en" || value === "es" || value === "pt-BR";
+}
+/** Best-effort detection from the environment (LANG / LC_ALL). Falls back to en. */
+export function detectLang() {
+    const raw = (process.env.LANG || process.env.LC_ALL || process.env.LANGUAGE || "").toLowerCase();
+    if (raw.startsWith("pt"))
+        return "pt-BR";
+    if (raw.startsWith("es"))
+        return "es";
+    return "en";
+}
+/** Build a translator bound to a language, with {var} interpolation and en fallback. */
+export function makeT(lang) {
+    const table = TABLES[lang] ?? en;
+    return (key, vars) => {
+        let s = table[key] ?? en[key] ?? key;
+        if (vars) {
+            for (const [k, v] of Object.entries(vars)) {
+                s = s.replaceAll(`{${k}}`, String(v));
+            }
+        }
+        return s;
+    };
+}

package/dist/i18n/pt-BR.js

@@ -0,0 +1,75 @@
+export const ptBR = {
+    "subtitle": "sistema · gpu · energia",
+    "paused": "PAUSADO",
+    "panel.cpu": "CPU",
+    "panel.mem": "MEMÓRIA",
+    "panel.temp": "TEMPERATURA",
+    "panel.net": "REDE",
+    "panel.disks": "DISCOS",
+    "panel.git": "GIT · REPOS",
+    "panel.gpu": "GPU",
+    "panel.tokens": "IA · TOKENS HOJE",
+    "panel.vtex": "VTEX",
+    "panel.procs": "PROCESSOS",
+    "status.cpu.ok": "tranquilo",
+    "status.cpu.warn": "ocupado",
+    "status.cpu.crit": "sobrecarga",
+    "status.mem.ok": "ok",
+    "status.mem.warn": "atento",
+    "status.mem.crit": "cheia",
+    "status.disk.ok": "ok",
+    "status.disk.warn": "enchendo",
+    "status.disk.crit": "cheio",
+    "status.gpu.ok": "tranquila",
+    "status.gpu.warn": "ativa",
+    "status.gpu.crit": "alta",
+    "status.temp.ok": "normal",
+    "status.temp.warn": "morna",
+    "status.temp.crit": "quente",
+    "cpu.usage": "Uso",
+    "cpu.cores": "Núcleos",
+    "cpu.perCore": "por núcleo",
+    "mem.ram": "RAM",
+    "mem.used": "{used} de {total} usados · swap {swap}%",
+    "disks.mount": "MONTAGEM",
+    "disks.read": "LEITURA",
+    "disks.write": "ESCRITA",
+    "disks.usage": "USO",
+    "git.repo": "REPO",
+    "git.branch": "BRANCH",
+    "git.state": "ESTADO",
+    "git.clean": "limpo",
+    "git.dirty": "sujo",
+    "gpu.usage": "Uso",
+    "gpu.mem": "mem {used}/{alloc}",
+    "temp.unavailable": "sensores indisponíveis",
+    "temp.waitingSudo": "aguardando sudo",
+    "temp.needsSudo": "energia: requer sudo",
+    "spark.collecting": "coletando…",
+    "spark.lastMin": "último min: {range}",
+    "tokens.spent": "Gasto hoje: ${cost}  ·  {messages} mensagens",
+    "tokens.tokens": "Tokens: {total} · entrada {input} · saída {output}",
+    "tokens.cache": "Cache: grava {cw} · lê {cr}",
+    "tokens.byModel": "Por modelo: {models}",
+    "tokens.none": "—",
+    "vtex.status": "Status",
+    "vtex.notInstalled": "CLI não instalada",
+    "vtex.install": "Instale com: brew install vtex/cli/vtex",
+    "vtex.connected": "conectado ✓",
+    "vtex.account": "Conta",
+    "vtex.user": "Usuário",
+    "vtex.workspace": "Workspace",
+    "vtex.notConnected": "não conectado",
+    "vtex.signin": "Entre com: vtex login <conta>",
+    "proc.cpu": "CPU%",
+    "proc.mem": "MEM",
+    "proc.pid": "PID",
+    "proc.name": "Processo",
+    "key.quit": "Sair",
+    "key.pause": "Pausar",
+    "key.faster": "Mais rápido",
+    "key.slower": "Mais lento",
+    "cli.sudoNeed": "lattice precisa de sudo para ler energia (powermetrics).",
+    "cli.sudoFail": "sudo indisponível — seguindo sem dados de energia.",
+    "cli.sudoCancel": "cancelado.",
+};

package/dist/icons.js

@@ -0,0 +1,50 @@
+/**
+ * Panel/metric icons with three modes: nerd (Nerd Font glyphs), emoji, none.
+ *
+ * The Nerd Font glyphs are from the Font Awesome 4 subset (U+F000–U+F2E0),
+ * present in any Nerd Font patch (e.g. MesloLGS NF). Select a Nerd Font in your
+ * terminal, or pass --icons emoji / --icons none.
+ */
+const NERD = {
+    cpu: "", // microchip
+    gpu: "", // desktop
+    mem: "", // database
+    swap: "", // exchange
+    net: "", // globe
+    disk: "", // hdd
+    temp: "", // fire
+    fan: "", // rotate
+    battery: "", // battery-full
+    power: "", // bolt
+    tokens: "", // money
+    vtex: "", // shopping-cart
+    git: "\uF126", // code-fork
+    proc: "", // tasks
+    clock: "", // clock
+};
+const EMOJI = {
+    cpu: "🖥️",
+    gpu: "🎮",
+    mem: "🧠",
+    swap: "🔁",
+    net: "🌐",
+    disk: "💽",
+    temp: "🌡️",
+    fan: "🌀",
+    battery: "🔋",
+    power: "⚡",
+    tokens: "🪙",
+    vtex: "🛒",
+    git: "🌿",
+    proc: "📋",
+    clock: "🕐",
+};
+export function isIconMode(mode) {
+    return mode === "nerd" || mode === "emoji" || mode === "none";
+}
+export function makeIcons(mode) {
+    if (mode === "none")
+        return () => "";
+    const set = mode === "emoji" ? EMOJI : NERD;
+    return (name) => set[name] ?? "";
+}

package/dist/theme.js

@@ -0,0 +1,34 @@
+/**
+ * Dracula Pro theme (official palette) for lattice.
+ *
+ * The accents (foreground + 7 colors) are shared by every dark variant; only
+ * Background / Comment / Selection change per variant. Switch the active
+ * variant with --theme or the persisted config.
+ */
+// Dracula PRO accents (identical across every dark variant).
+const ACCENTS = {
+    foreground: "#F8F8F2",
+    cyan: "#80FFEA",
+    green: "#8AFF80",
+    orange: "#FFCA80",
+    pink: "#FF80BF",
+    purple: "#9580FF",
+    red: "#FF9580",
+    yellow: "#FFFF80",
+};
+// Background / Comment / Selection per variant.
+const VARIANTS = {
+    pro: { background: "#22212C", comment: "#7970A9", selection: "#454158" },
+    blade: { background: "#212C2A", comment: "#70A99F", selection: "#415854" },
+    buffy: { background: "#2A212C", comment: "#9F70A9", selection: "#544158" },
+    lincoln: { background: "#2C2A21", comment: "#A99F70", selection: "#585441" },
+    morbius: { background: "#2C2122", comment: "#A97079", selection: "#584145" },
+    "van-helsing": { background: "#0B0D0F", comment: "#708CA9", selection: "#414D58" },
+};
+export const VARIANT_NAMES = Object.keys(VARIANTS);
+export function isVariant(name) {
+    return name in VARIANTS;
+}
+export function palette(variant = "pro") {
+    return { ...ACCENTS, ...VARIANTS[variant] };
+}

package/native/build.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# Build the lattice-smc helper and place it in prebuilds/<platform>-<arch>/.
+# The prebuilt binary is shipped in the npm package so `npx @zeluizr/lattice`
+# works without a compiler on the user's machine.
+set -euo pipefail
+
+here="$(cd "$(dirname "$0")" && pwd)"
+root="$(cd "$here/.." && pwd)"
+
+arch="$(uname -m)"        # arm64
+plat="$(uname -s | tr '[:upper:]' '[:lower:]')"  # darwin
+outdir="$root/prebuilds/${plat}-${arch}"
+mkdir -p "$outdir"
+
+if [[ "$plat" != "darwin" ]]; then
+  echo "lattice-smc only builds on macOS (got $plat) — skipping." >&2
+  exit 0
+fi
+
+clang -O2 -Wall -framework IOKit -framework CoreFoundation \
+  -o "$outdir/lattice-smc" "$here/smc.c"
+chmod +x "$outdir/lattice-smc"
+echo "built: $outdir/lattice-smc"

package/native/smc.c

@@ -0,0 +1,151 @@
+/*
+ * lattice-smc — reads Apple Silicon CPU/GPU temperatures and fan speeds from the
+ * AppleSMC via IOKit (no sudo) and prints them as JSON. Ported from the original
+ * Python ctypes implementation.
+ *
+ * Build: clang -O2 -framework IOKit -framework CoreFoundation -o lattice-smc smc.c
+ * Output: {"ok":true,"cpu_temp":48.2,"gpu_temp":41.0,"fans":[{"rpm":0,"min":0,"max":0,"pct":0}]}
+ */
+
+#include <stdio.h>
+#include <string.h>
+#include <stdint.h>
+#include <stdbool.h>
+#include <mach/mach.h>
+#include <IOKit/IOKitLib.h>
+
+#define KERNEL_INDEX_SMC 2
+#define SMC_CMD_READ_BYTES 5
+#define SMC_CMD_READ_KEYINFO 9
+
+typedef struct { uint8_t major, minor, build, reserved; uint16_t release; } SMCVers;
+typedef struct { uint16_t version, length; uint32_t cpuPLimit, gpuPLimit, memPLimit; } SMCPLimit;
+typedef struct { uint32_t dataSize, dataType; uint8_t dataAttributes; } SMCKeyInfo;
+typedef struct {
+  uint32_t key;
+  SMCVers vers;
+  SMCPLimit pLimit;
+  SMCKeyInfo keyInfo;
+  uint8_t result, status, data8;
+  uint32_t data32;
+  uint8_t bytes[32];
+} SMCParam;
+
+static io_connect_t g_conn = 0;
+
+/* Candidate sensor keys; we keep the ones that return a plausible value. */
+static const char *CPU_KEYS[] = {
+  "Tp01","Tp02","Tp05","Tp09","Tp0D","Tp0H","Tp0L","Tp0P","Tp0T",
+  "Tp0X","Tp0b","Tp0f","Tp0j","Tp0n","Tp0r","Tp0v",
+  "Te05","Te0L","Te0P","Te0S", NULL
+};
+static const char *GPU_KEYS[] = { "Tg05","Tg09","Tg0D","Tg0L","Tg0T","Tg0X", NULL };
+
+static uint32_t k2i(const char *s) {
+  return ((uint32_t)(uint8_t)s[0] << 24) | ((uint32_t)(uint8_t)s[1] << 16) |
+         ((uint32_t)(uint8_t)s[2] << 8) | (uint32_t)(uint8_t)s[3];
+}
+
+static kern_return_t smc_call(SMCParam *in, SMCParam *out) {
+  size_t outSize = sizeof(SMCParam);
+  return IOConnectCallStructMethod(g_conn, KERNEL_INDEX_SMC, in, sizeof(SMCParam), out, &outSize);
+}
+
+static bool read_value(const char *key, double *out_val) {
+  SMCParam in, out;
+  memset(&in, 0, sizeof(in));
+  memset(&out, 0, sizeof(out));
+  in.key = k2i(key);
+  in.data8 = SMC_CMD_READ_KEYINFO;
+  if (smc_call(&in, &out) != kIOReturnSuccess) return false;
+  uint32_t size = out.keyInfo.dataSize;
+  uint32_t type = out.keyInfo.dataType;
+  if (size == 0 || size > 32) return false;
+
+  SMCParam in2, out2;
+  memset(&in2, 0, sizeof(in2));
+  memset(&out2, 0, sizeof(out2));
+  in2.key = k2i(key);
+  in2.keyInfo.dataSize = size;
+  in2.keyInfo.dataType = type;
+  in2.data8 = SMC_CMD_READ_BYTES;
+  if (smc_call(&in2, &out2) != kIOReturnSuccess) return false;
+
+  char t[5];
+  t[0] = (char)((type >> 24) & 0xff);
+  t[1] = (char)((type >> 16) & 0xff);
+  t[2] = (char)((type >> 8) & 0xff);
+  t[3] = (char)(type & 0xff);
+  t[4] = 0;
+  uint8_t *b = out2.bytes;
+
+  if (memcmp(t, "flt ", 4) == 0) { float f; memcpy(&f, b, 4); *out_val = (double)f; return true; }
+  if (strncmp(t, "ui8", 3) == 0) { *out_val = (double)b[0]; return true; }
+  if (memcmp(t, "ui16", 4) == 0) { *out_val = (double)((b[0] << 8) | b[1]); return true; }
+  if (memcmp(t, "fpe2", 4) == 0) { *out_val = (double)((b[0] << 8) | b[1]) / 4.0; return true; }
+  return false;
+}
+
+static bool read_temp(const char *key, double *out_val) {
+  double v;
+  if (read_value(key, &v) && v > 5.0 && v < 130.0) { *out_val = v; return true; }
+  return false;
+}
+
+static bool avg_temp(const char **keys, double *out_val) {
+  double sum = 0.0;
+  int n = 0;
+  for (int i = 0; keys[i]; i++) {
+    double v;
+    if (read_temp(keys[i], &v)) { sum += v; n++; }
+  }
+  if (n == 0) return false;
+  *out_val = sum / n;
+  return true;
+}
+
+int main(void) {
+  io_service_t svc = IOServiceGetMatchingService(0, IOServiceMatching("AppleSMC"));
+  if (!svc) { printf("{\"ok\":false,\"error\":\"AppleSMC not found\"}\n"); return 0; }
+  if (IOServiceOpen(svc, mach_task_self(), 0, &g_conn) != kIOReturnSuccess) {
+    IOObjectRelease(svc);
+    printf("{\"ok\":false,\"error\":\"IOServiceOpen failed\"}\n");
+    return 0;
+  }
+  IOObjectRelease(svc);
+
+  double cpu, gpu;
+  bool hasCpu = avg_temp(CPU_KEYS, &cpu);
+  bool hasGpu = avg_temp(GPU_KEYS, &gpu);
+
+  printf("{\"ok\":true,");
+  if (hasCpu) printf("\"cpu_temp\":%.2f,", cpu); else printf("\"cpu_temp\":null,");
+  if (hasGpu) printf("\"gpu_temp\":%.2f,", gpu); else printf("\"gpu_temp\":null,");
+
+  printf("\"fans\":[");
+  double fn;
+  int nfans = read_value("FNum", &fn) ? (int)fn : 0;
+  int printed = 0;
+  for (int i = 0; i < nfans; i++) {
+    char ka[8], kn[8], kx[8];
+    snprintf(ka, sizeof(ka), "F%dAc", i);
+    snprintf(kn, sizeof(kn), "F%dMn", i);
+    snprintf(kx, sizeof(kx), "F%dMx", i);
+    double rpm, mn = 0.0, mx = 0.0;
+    if (!read_value(ka, &rpm)) continue;
+    read_value(kn, &mn);
+    read_value(kx, &mx);
+    double pct = 0.0;
+    if (mx > mn) {
+      pct = (rpm - mn) / (mx - mn) * 100.0;
+      if (pct < 0) pct = 0;
+      if (pct > 100) pct = 100;
+    }
+    if (printed++) printf(",");
+    printf("{\"rpm\":%.0f,\"min\":%.0f,\"max\":%.0f,\"pct\":%.0f}", rpm, mn, mx, pct);
+  }
+  printf("]}\n");
+
+  IOServiceClose(g_conn);
+  return 0;
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@zeluizr/lattice",
+  "version": "1.0.0",
+  "description": "Real-time terminal dashboard for macOS Apple Silicon — GPU, power, temperatures/fans, per-disk I/O (incl. /Volumes), network, memory, processes, and AI token cost.",
+  "type": "module",
+  "bin": {
+    "lattice": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "prebuilds",
+    "native/smc.c",
+    "native/build.sh",
+    "scripts/setup-sudoers.sh",
+    "README.md",
+    "MANIFESTO.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "keywords": [
+    "macos",
+    "apple-silicon",
+    "system-monitor",
+    "tui",
+    "terminal",
+    "dashboard",
+    "gpu",
+    "powermetrics",
+    "htop",
+    "ink",
+    "cli"
+  ],
+  "license": "MIT",
+  "author": "Jose Luiz Rodrigues",
+  "homepage": "https://github.com/zeluizr/lattice#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeluizr/lattice.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zeluizr/lattice/issues"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/postbuild.mjs",
+    "build:native": "bash native/build.sh",
+    "dev": "npm run build && node dist/cli.js",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build:native && npm run build"
+  },
+  "dependencies": {
+    "bplist-parser": "^0.3.2",
+    "execa": "^9.6.1",
+    "ink": "^7.1.0",
+    "meow": "^14.1.0",
+    "plist": "^5.0.0",
+    "react": "^19.2.7",
+    "systeminformation": "^5.31.9"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.17",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^6.0.3"
+  }
+}