trace-engine-cli 0.0.0-stage → 0.1.0

package/dist/src/utils/units.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Converts microseconds to milliseconds.
+ */
+export declare function microToMilli(microseconds: number): number;
+/**
+ * Converts milliseconds to microseconds.
+ */
+export declare function milliToMicro(milliseconds: number): number;
+/**
+ * Rounds a number to a specific number of decimal places.
+ */
+export declare function round(value: number, decimals?: number): number;
+/**
+ * Formats milliseconds as a formatted string with unit suffix.
+ */
+export declare function formatMs(milliseconds: number, decimals?: number): string;
+/**
+ * Formats a byte count into human-readable size (B, KB, MB, GB, TB).
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Formats a decimal score with fixed precision.
+ */
+export declare function formatScore(score: number, decimals?: number): string;

package/dist/src/utils/units.js

@@ -0,0 +1,57 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * Converts microseconds to milliseconds.
+ */
+export function microToMilli(microseconds) {
+    return microseconds / 1000;
+}
+/**
+ * Converts milliseconds to microseconds.
+ */
+export function milliToMicro(milliseconds) {
+    return milliseconds * 1000;
+}
+/**
+ * Rounds a number to a specific number of decimal places.
+ */
+export function round(value, decimals = 2) {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+/**
+ * Formats milliseconds as a formatted string with unit suffix.
+ */
+export function formatMs(milliseconds, decimals = 2) {
+    return `${round(milliseconds, decimals)}ms`;
+}
+/**
+ * Formats a byte count into human-readable size (B, KB, MB, GB, TB).
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const absBytes = Math.abs(bytes);
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.min(sizes.length - 1, Math.max(0, Math.floor(Math.log(absBytes) / Math.log(k))));
+    const sign = bytes < 0 ? '-' : '';
+    return `${sign}${round(absBytes / k ** i, 2)} ${sizes[i]}`;
+}
+/**
+ * Formats a decimal score with fixed precision.
+ */
+export function formatScore(score, decimals = 4) {
+    return round(score, decimals).toString();
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "trace-engine-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "CLI tool for inspecting Chromium performance traces on top of DevTools Trace Engine",
+  "type": "module",
+  "bin": {
+    "trace-cli": "./dist/bin/trace-cli.js"
+  },
+  "files": [
+    "dist/bin",
+    "dist/src"
+  ],
+  "scripts": {
+    "clean": "node --input-type=module --eval \"import fs from 'node:fs'; fs.rmSync('dist', {recursive: true, force: true});\"",
+    "build": "npm run clean && tsc",
+    "bundle:engine": "tsx scripts/bundle-engine.ts",
+    "test": "node --test --import tsx/esm 'test/**/*.test.ts' 'test/*.test.ts'",
+    "check": "biome check .",
+    "format": "biome format --write ."
+  },
+  "keywords": [
+    "trace",
+    "devtools",
+    "performance",
+    "cli",
+    "toon"
+  ],
+  "author": "Google LLC",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChromeDevTools/trace-engine-cli.git"
+  },
+  "dependencies": {
+    "@paulirish/trace_engine": "^0.0.65",
+    "@toon-format/toon": "^4.1.1",
+    "yargs": "^18.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.11",
+    "@types/node": "^26.4.0",
+    "@types/yargs": "^17.0.35",
+    "esbuild": "^0.28.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2"
+  }
+}