nirs4all-ui 0.1.0

package/dist/score/scoreValues.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pure score-value helpers: parsing, direction-aware comparison, and display
+ * formatting. These depend only on metric-key normalization (no metric
+ * catalog), so they form a small, self-contained, easily testable slice.
+ */
+/** Coerce a value to a finite number, or null. Accepts numbers and numeric strings. */
+export declare function parseScoreNumber(value: unknown): number | null;
+export declare function parseJsonRecord(value: unknown): Record<string, unknown> | null;
+export declare function isLowerBetter(metric: string | null | undefined): boolean;
+/**
+ * Compare two scores, respecting the metric direction.
+ * Returns true if `a` is better than `b`.
+ */
+export declare function isBetterScore(a: number, b: number, metric: string | null | undefined): boolean;
+/**
+ * Format a score value to 4 decimal places (or 3 for error metrics).
+ */
+export declare function formatScore(value: number | string | undefined | null): string;
+/**
+ * Format a metric-specific value (3 decimals for error metrics, 4 for others).
+ */
+export declare function formatMetricValue(value: number | string | undefined | null, metric?: string): string;
+/**
+ * Format a metric name for display (uppercase).
+ */
+export declare function formatMetricName(metric: string | null | undefined): string;
+export declare function formatMetricDisplayName(metric: string | null | undefined): string;
+//# sourceMappingURL=scoreValues.d.ts.map

package/dist/score/scoreValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoreValues.d.ts","sourceRoot":"","sources":["../../src/score/scoreValues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAe9E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAExE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE9F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAK7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG1E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASjF"}

package/dist/score/scoreValues.js

@@ -0,0 +1,92 @@
+/**
+ * Pure score-value helpers: parsing, direction-aware comparison, and display
+ * formatting. These depend only on metric-key normalization (no metric
+ * catalog), so they form a small, self-contained, easily testable slice.
+ */
+import { canonicalMetricKey, normalizeMetricLookupKey } from "./metricKeys.js";
+/** Metrics where lower values are better (error-based). */
+const LOWER_IS_BETTER = new Set([
+    "rmse", "rmsecv", "rmsep", "mse", "mae", "mape", "bias", "sep", "nrmse",
+    "nmse", "nmae", "max_error", "median_ae", "hamming_loss", "log_loss",
+]);
+/** Coerce a value to a finite number, or null. Accepts numbers and numeric strings. */
+export function parseScoreNumber(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === "string") {
+        const parsed = Number.parseFloat(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+export function parseJsonRecord(value) {
+    if (!value)
+        return null;
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+                ? parsed
+                : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+export function isLowerBetter(metric) {
+    return LOWER_IS_BETTER.has(canonicalMetricKey(metric));
+}
+/**
+ * Compare two scores, respecting the metric direction.
+ * Returns true if `a` is better than `b`.
+ */
+export function isBetterScore(a, b, metric) {
+    return isLowerBetter(metric) ? a < b : a > b;
+}
+/**
+ * Format a score value to 4 decimal places (or 3 for error metrics).
+ */
+export function formatScore(value) {
+    if (value == null)
+        return "-";
+    const num = typeof value === "string" ? parseFloat(value) : value;
+    if (!Number.isFinite(num))
+        return "-";
+    return num.toFixed(4);
+}
+/**
+ * Format a metric-specific value (3 decimals for error metrics, 4 for others).
+ */
+export function formatMetricValue(value, metric) {
+    if (value == null)
+        return "-";
+    const num = typeof value === "string" ? parseFloat(value) : value;
+    if (!Number.isFinite(num))
+        return "-";
+    if (metric && isLowerBetter(metric))
+        return num.toFixed(3);
+    return num.toFixed(4);
+}
+/**
+ * Format a metric name for display (uppercase).
+ */
+export function formatMetricName(metric) {
+    if (!metric)
+        return "";
+    return (canonicalMetricKey(metric) || normalizeMetricLookupKey(metric)).toUpperCase();
+}
+export function formatMetricDisplayName(metric) {
+    const normalized = canonicalMetricKey(metric) || normalizeMetricLookupKey(metric);
+    if (!normalized)
+        return "";
+    return normalized
+        .split("_")
+        .filter(Boolean)
+        .map((part) => (part.length <= 4 ? part.toUpperCase() : part.charAt(0).toUpperCase() + part.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=scoreValues.js.map

package/dist/score/scoreValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoreValues.js","sourceRoot":"","sources":["../../src/score/scoreValues.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "nirs4all-ui",
+  "version": "0.1.0",
+  "description": "Shared React UI components and pure view-model helpers for nirs4all apps.",
+  "type": "module",
+  "license": "(CECILL-2.1 OR AGPL-3.0-or-later)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GBeurier/nirs4all-ui.git"
+  },
+  "private": false,
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./score": {
+      "types": "./dist/score/index.d.ts",
+      "import": "./dist/score/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "ci": "npm run prepublishOnly && npm run pack:smoke",
+    "pack:smoke": "npm pack --dry-run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}